feat: update image optimization endpoint and enhance database functionality

Author: pphatdev

docs/collections/collection.postman_collection.json

@@ -413,7 +413,7 @@
 				"method": "GET",
 				"header": [],
 				"url": {
-					"raw": "{{url}}/source/v1/files/image/:filename?fm=webp&q=80&w=500&h=500&fit=cover",
+					"raw": "{{url}}/assets/image/:filename?fm=webp&q=80&w=500&h=500&fit=cover",
 					"host": [
 						"{{url}}"
 					],
@@ -454,7 +454,7 @@
 						}
 					]
 				},
-				"description": "## Image optimization endpoint\n\n**Endpoint:**  \n`GET /source/v1/files/image/:filename`\n\n**Description:**  \nThis endpoint allows you to retrieve and optimize an image file stored on the server by specifying the filename as a URL parameter. You can apply various optimization options through query parameters.\n\n### URL Parameters\n\n| Key | Type | Description |\n| --- | --- | --- |\n| filename | String | The name of the image file to retrieve and optimize |\n\n### Query Parameters\n\n| Key | Type | Description |\n| --- | --- | --- |\n| fm | String | (Optional) Format (e.g., jpg, png, webp) |\n| q | Number | (Optional) Quality (e.g., 80) |\n| w | Number | (Optional) Width (e.g., 300) |\n| h | Number | (Optional) Height (e.g., 300) |\n| fit | String | (Optional) Fit mode (e.g., cover, contain) |\n\n### Example Request in Postman\n\n1. Set the request method to **GET**.\n    \n2. Set the URL to: `{{url}}/source/v1/files/image/sample.png?fm=webp&q=80&w=300&h=300&fit=cover`\n    \n3. (Optional) Add any required headers.\n    \n4. Click **Send** to retrieve and optimize the image.\n    \n\n### Example cURL\n\n``` sh\ncurl -X GET \"{{url}}/source/v1/files/image/sample.png?fm=webp&q=80&w=300&h=300&fit=cover\"\n\n ```\n\n### Example Response\n\nThe response will be the optimized image file. The content type will depend on the requested format (e.g., `image/webp` for WebP format).\n\n``` http\nHTTP/1.1 200 OK\nContent-Type: image/webp\nContent-Length: 12345\n(binary image data)\n\n ```"
+				"description": "## Image optimization endpoint\n\n**Endpoint:**  \n`GET /assets/image/:filename`\n\n**Description:**  \nThis endpoint allows you to retrieve and optimize an image file stored on the server by specifying the filename as a URL parameter. You can apply various optimization options through query parameters.\n\n### URL Parameters\n\n| Key | Type | Description |\n| --- | --- | --- |\n| filename | String | The name of the image file to retrieve and optimize |\n\n### Query Parameters\n\n| Key | Type | Description |\n| --- | --- | --- |\n| fm | String | (Optional) Format (e.g., jpg, png, webp) |\n| q | Number | (Optional) Quality (e.g., 80) |\n| w | Number | (Optional) Width (e.g., 300) |\n| h | Number | (Optional) Height (e.g., 300) |\n| fit | String | (Optional) Fit mode (e.g., cover, contain) |\n\n### Example Request in Postman\n\n1. Set the request method to **GET**.\n    \n2. Set the URL to: `{{url}}/assets/image/sample.png?fm=webp&q=80&w=300&h=300&fit=cover`\n    \n3. (Optional) Add any required headers.\n    \n4. Click **Send** to retrieve and optimize the image.\n    \n\n### Example cURL\n\n``` sh\ncurl -X GET \"{{url}}/assets/image/sample.png?fm=webp&q=80&w=300&h=300&fit=cover\"\n\n ```\n\n### Example Response\n\nThe response will be the optimized image file. The content type will depend on the requested format (e.g., `image/webp` for WebP format).\n\n``` http\nHTTP/1.1 200 OK\nContent-Type: image/webp\nContent-Length: 12345\n(binary image data)\n\n ```"
 			},
 			"response": []
 		},

docs/how-to-use/get-image-endpoint.md

@@ -1,6 +1,6 @@
 ## Image optimization endpoint
 **Endpoint:**
-`GET /source/v1/files/image/:filename`
+`GET /assets/image/:filename`
 
 **Description:**
 This endpoint allows you to retrieve and optimize an image file stored on the server by specifying the filename as a URL parameter. You can apply various optimization options through query parameters.
@@ -21,13 +21,13 @@ This endpoint allows you to retrieve and optimize an image file stored on the se
 
 ### Example Request in Postman
 1. Set the request method to **GET**.
-2. Set the URL to: `{{url}}/source/v1/files/image/sample.png?fm=webp&q=80&w=300&h=300&fit=cover`
+2. Set the URL to: `{{url}}/assets/image/sample.png?fm=webp&q=80&w=300&h=300&fit=cover`
 3. (Optional) Add any required headers.
 4. Click **Send** to retrieve and optimize the image.
 
 ### Example cURL
 ```sh
-curl -X GET "{{url}}/source/v1/files/image/sample.png?fm=webp&q=80&w=300&h=300&fit=cover"
+curl -X GET "{{url}}/assets/image/sample.png?fm=webp&q=80&w=300&h=300&fit=cover"
 ```
 
 ### Example Response

src/controllers/files.controller.ts

@@ -4,6 +4,7 @@ import { configured } from '../utils/config.js';
 import { UploadController } from './upload.controller.js';
 import { sendBadRequest, sendNotFound, sendSuccess } from '../utils/response.js';
 import { FileUtils } from '../utils/files.js';
+import { Database } from '../utils/database.js';
 import fs from 'fs';
 
 interface FileValidateCallback {
@@ -217,6 +218,9 @@ export class FilesController {
 
             // reduce value of key "path" to be relative to storage directory
             for (const file of sanitizedFiles) {
+                // Preserve the original file system path before modification
+                const originalFilePath = file.path;
+                
                 const sanitizedFile: any = {
                     ...file,
                     // path: file.path.replace(/\\/g, '/'),
@@ -229,8 +233,8 @@ export class FilesController {
                 };
                 Object.assign(file, sanitizedFile);
 
-                // Sync file after upload
-                await FilesController.syncFile(file.path);
+                // Sync file after upload with original filename - use the original filesystem path
+                await FilesController.syncFile(originalFilePath, file.originalname);
             }
 
             sendSuccess(response, sanitizedFiles, 'Files uploaded successfully', 200);
@@ -240,8 +244,9 @@ export class FilesController {
     /**
      * Sync a file after upload
      * @param filePath Path to the file to sync
+     * @param originalFilename Original filename from upload (optional)
      */
-    static async syncFile(filePath: string): Promise<void> {
+    static async syncFile(filePath: string, originalFilename?: string): Promise<void> {
         try {
             // Get the actual file path on disk
             const actualFilePath = filePath.startsWith(configured.baseDirectory) ? filePath : `${configured.baseDirectory}${filePath}`;
@@ -262,23 +267,73 @@ export class FilesController {
             // Ensure proper permissions are set
             await FileUtils.setProperPermissions(actualFilePath, false);
 
-            // Log sync information
-            console.log(`File synced successfully:`, {
-                path: actualFilePath,
-                folder: folderPath,
+            // Extract filename
+            const filename = actualFilePath.replace(/\\/g, '/').split('/').pop() || 'unknown';
+            const ext = filename.split('.').pop()?.toLowerCase();
+
+            // Check if file is an image
+            const imageExtensions = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'svg', 'bmp'];
+            const isImage = ext ? imageExtensions.includes(ext) : false;
+
+            // Create file metadata
+            const metadata = {
+                filename: filename,
+                originalFilename: originalFilename || filename,
+                path: actualFilePath.replace(/\\/g, '/'),
+                relativePath: relativePath,
+                folderPath: folderPath,
                 size: stats.size,
-                syncedAt: new Date().toISOString()
-            });
+                extension: ext || '',
+                mimeType: this.getMimeType(ext || ''),
+                previewUrl: isImage ? `/assets/image/${filename}` : `/file/preview/${filename}`,
+                createdAt: stats.birthtime.toISOString(),
+                modifiedAt: stats.mtime.toISOString(),
+                uploadedAt: new Date().toISOString()
+            };
 
-            // Optional: Create a sync record or backup based on folder
-            // This could be extended to copy files to a backup location
-            // based on the folder structure
+            // Save to database
+            await Database.addFile(metadata);
 
         } catch (error: any) {
             console.error(`Error syncing file ${filePath}:`, error.message);
         }
     }
 
+
+
+    /**
+     * Get MIME type based on file extension
+     * @param ext File extension
+     */
+    static getMimeType(ext: string): string {
+        const mimeTypes: { [key: string]: string } = {
+            // Images
+            'jpg': 'image/jpeg',
+            'jpeg': 'image/jpeg',
+            'png': 'image/png',
+            'gif': 'image/gif',
+            'webp': 'image/webp',
+            'svg': 'image/svg+xml',
+            // Documents
+            'pdf': 'application/pdf',
+            'doc': 'application/msword',
+            'docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+            'txt': 'text/plain',
+            // Spreadsheets
+            'xls': 'application/vnd.ms-excel',
+            'xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+            'csv': 'text/csv',
+            // Presentations
+            'ppt': 'application/vnd.ms-powerpoint',
+            'pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+            // Archives
+            'zip': 'application/zip',
+            'rar': 'application/x-rar-compressed',
+            '7z': 'application/x-7z-compressed'
+        };
+        return mimeTypes[ext] || 'application/octet-stream';
+    }
+
     /**
      * Validate uploaded file type
      * @param request Request
@@ -337,7 +392,7 @@ export class FilesController {
                         createdAt: stats.birthtime,
                         modifiedAt: stats.mtime,
                         relativePath: filePath,
-                        previewUrl: type === 'image' ? `/source/v1/files/image/${file}` : null
+                        previewUrl: type === 'image' ? `/assets/image/${file}` : null
                     });
                 });
             }
@@ -370,12 +425,59 @@ export class FilesController {
         sendNotFound(response, 'File not found.');
     };
 
+    /**
+     * Delete a file by filename
+     * @param request Request
+     * @param response Response
+    */
+    static deleteFile = async (request: Request, response: Response): Promise<void> => {
+        const { filename } = request.params;
+
+        if (!filename) {
+            sendBadRequest(response, 'filename is required.');
+            return;
+        }
+
+        // Find the file in configured directories
+        const storage = configured.directories;
+        let foundFilePath = null;
+
+        for (const dir of storage) {
+            const filePath = `${dir}/${filename}`.replace(/\\/g, '/');
+            if (fs.existsSync(filePath)) {
+                foundFilePath = filePath;
+                break;
+            }
+        }
+
+        if (!foundFilePath) {
+            sendNotFound(response, 'File not found.');
+            return;
+        }
+
+        try {
+            // Delete the file
+            fs.unlinkSync(foundFilePath);
+
+            // Delete from database
+            await Database.deleteFile(filename);
+
+            sendSuccess(response, {
+                filename: filename,
+                deletedPath: foundFilePath
+            }, 'File deleted successfully', 200);
+        } catch (err: any) {
+            sendBadRequest(response, err.message || 'Failed to delete file.');
+        }
+    };
+
 }
 
 export const {
     uploadFiles,
     searchFileByName,
     moveFileToDir,
     uploadFileBase64,
-    uploadMultipleFilesBase64
+    uploadMultipleFilesBase64,
+    deleteFile
 } = FilesController;

src/controllers/folder.controller.ts

@@ -11,7 +11,8 @@ export class FolderController {
      */
     static getFolderStructure = async (request: Request, response: Response): Promise<void> => {
         const basePath = 'storage';
-        const dynamicPath = String(request.params.path || '');
+        // Get the path from params[0] for regex routes, or params.path for named routes
+        const dynamicPath = request.params[0] || request.params.path || '';
         const currentDirectory = path.join(basePath, dynamicPath).replace(/\\/g, '/').replace(/,+/g, '/');
 
         try {

src/controllers/images.controller.ts

@@ -173,19 +173,22 @@ export class ImagesController {
 
             // reduce value of key "path" to be relative to storage directory
             for (const file of sanitizedFiles) {
+                // Preserve the original file system path before modification
+                const originalFilePath = file.path;
+
                 const sanitizedFile: any = {
                     ...file,
                     fileName: file.originalname,
-                    path: `/source/v1/files/image/${file.filename}`,
-                    pathFile: `/source/v1/files/image/${file.filename}`,
+                    path: `/assets/image/${file.filename}`,
+                    pathFile: `/assets/image/${file.filename}`,
                     type: file.mimetype,
                     name: file.filename,
                     extension: file.originalname.split('.').pop()
                 };
                 Object.assign(file, sanitizedFile);
 
-                // Sync file after upload
-                await FilesController.syncFile(file.path);
+                // Sync file after upload - use the original file system path and original filename
+                await FilesController.syncFile(originalFilePath, file.originalname);
             }
 
             sendSuccess(response, sanitizedFiles, 'Files uploaded successfully', 200);