xypriss 2.2.1 → 2.2.2

package/README.md

@@ -226,51 +226,106 @@ app.get(
 
 ## File Upload
 
-XyPriss provides seamless file upload support with full compatibility for multer and other multipart form-data parsers. No additional configuration needed - it works out of the box!
+XyPriss provides powerful file upload support with **automatic error handling** and both class-based and functional APIs. No manual error handling required!
 
-### Basic File Upload
+### Quick Start (Class-Based API - Recommended)
 
 ```typescript
 import { createServer } from "xypriss";
-import multer from "multer";
+import { FileUploadAPI } from "xypriss";
 
 const app = createServer({
-    server: { port: 3000 },
     fileUpload: {
+        enabled: true,
         maxFileSize: 5 * 1024 * 1024, // 5MB
-        allowedMimeTypes: ["image/jpeg", "image/png", "application/pdf"]
-    }
+        allowedMimeTypes: ["image/jpeg", "image/png"],
+    },
 });
 
-const upload = multer({ storage: multer.memoryStorage() });
-
-app.post("/upload", upload.single("file"), (req, res) => {
-    if (!req.file) {
-        return res.status(400).json({ error: "No file uploaded" });
-    }
+// Initialize file upload API
+const fileUpload = new FileUploadAPI();
+await fileUpload.initialize(app.options.fileUpload);
 
+app.post("/upload", fileUpload.single("file"), (req, res) => {
+    // Automatic error handling - only success code here!
     res.json({
+        success: true,
         message: "File uploaded successfully",
         file: {
             name: req.file.originalname,
             size: req.file.size,
-            type: req.file.mimetype
-        }
+            type: req.file.mimetype,
+        },
+    });
+});
+
+app.start();
+```
+
+### Functional API (Simple)
+
+```typescript
+import { createServer } from "xypriss";
+import { uploadSingle } from "xypriss";
+
+const app = createServer({
+    fileUpload: {
+        enabled: true,
+        maxFileSize: 5 * 1024 * 1024, // 5MB
+        storage: "memory",
+    },
+});
+
+app.post("/upload", uploadSingle("file"), (req, res) => {
+    // Automatic error handling - no try/catch needed!
+    res.json({
+        success: true,
+        file: req.file,
     });
 });
 
 app.start();
 ```
 
+### Automatic Error Responses
+
+**File Too Large:**
+
+```json
+{
+    "success": false,
+    "error": "File too large",
+    "message": "File size exceeds the maximum limit of 1.00MB",
+    "details": {
+        "maxSize": 1048576,
+        "maxSizeMB": "1.00",
+        "fileSize": "unknown"
+    }
+}
+```
+
+**File Type Not Allowed:**
+
+```json
+{
+    "success": false,
+    "error": "File type not allowed",
+    "message": "File type 'application/exe' not allowed. Allowed types: image/jpeg, image/png"
+}
+```
+
 ### Features
 
-- **Zero Configuration**: Works with existing multer code without changes
-- **Security**: Built-in file validation, virus scanning, and sanitization
-- **Flexible Storage**: Memory, disk, or cloud storage options
-- **Type Safety**: Full TypeScript support with proper type definitions
-- **Performance**: Optimized for large file uploads with streaming support
+-   ✅ **Automatic Error Handling**: Multer errors converted to user-friendly JSON responses
+-   ✅ **Class-Based API**: Modern `FileUploadAPI` class for better organization
+-   ✅ **Legacy Compatibility**: Functional API still available for simple use cases
+-   ✅ **Multipart Support**: Fixed multipart/form-data handling (no more "Unexpected end of form" errors)
+-   ✅ **Security**: Built-in file validation, type checking, and size limits
+-   ✅ **Flexible Storage**: Memory, disk, or custom storage backends
+-   ✅ **Type Safety**: Full TypeScript support with proper type definitions
+-   ✅ **Performance**: Optimized for large file uploads with streaming support
 
-For detailed configuration options, see the [File Upload Documentation](./docs/file-upload.md).
+For comprehensive documentation, configuration options, and advanced usage, see the [File Upload Guide](./docs/file-upload.md).
 
 ---
 
@@ -291,17 +346,17 @@ const app = createServer({
                 id: "api-server",
                 port: 3001,
                 routePrefix: "/api",
-                allowedRoutes: ["/api/*"]
+                allowedRoutes: ["/api/*"],
             },
             {
                 id: "admin-server",
                 port: 3002,
                 routePrefix: "/admin",
                 allowedRoutes: ["/admin/*"],
-                security: { level: "maximum" }
-            }
-        ]
-    }
+                security: { level: "maximum" },
+            },
+        ],
+    },
 });
 
 // Routes are automatically distributed to appropriate servers
@@ -314,11 +369,11 @@ await app.startAllServers();
 
 ### Features
 
-- **Simple API**: `startAllServers()` and `stopAllServers()` hide complexity
-- **Automatic Route Distribution**: Routes are filtered and distributed automatically
-- **Server-Specific Overrides**: Each server can have different security, cache, and performance settings
-- **Microservices Ready**: Perfect for API versioning and service separation
-- **Load Balancing**: Built-in support for reverse proxy load balancing
+-   **Simple API**: `startAllServers()` and `stopAllServers()` hide complexity
+-   **Automatic Route Distribution**: Routes are filtered and distributed automatically
+-   **Server-Specific Overrides**: Each server can have different security, cache, and performance settings
+-   **Microservices Ready**: Perfect for API versioning and service separation
+-   **Load Balancing**: Built-in support for reverse proxy load balancing
 
 For comprehensive multi-server documentation, see the [Multi-Server Guide](./docs/multi-server.md).
 

package/dist/cjs/src/file-upload.js

@@ -0,0 +1,311 @@
+'use strict';
+
+var FileUploadManager = require('./server/components/fastapi/FileUploadManager.js');
+
+/**
+ * XyPriss File Upload API
+ *
+ * This module provides file upload middleware functions that can be used
+ * independently of the app instance initialization timing.
+ *
+ * Usage:
+ * ```typescript
+ * import { FileUploadAPI } from 'xypriss';
+ *
+ * const fileUpload = new FileUploadAPI();
+ * router.post('/upload', fileUpload.single('file'), (req, res) => {
+ *   console.log(req.file);
+ *   res.json({ success: true });
+ * });
+ * ```
+ */
+/**
+ * File Upload API Class
+ * Provides a clean, class-based interface for file upload middleware
+ */
+class FileUploadAPI {
+    constructor(logger) {
+        this.manager = null;
+        this.initialized = false;
+        // Use a default logger if none provided
+        this.logger =
+            logger ||
+                {
+                    debug: console.debug.bind(console),
+                    info: console.info.bind(console),
+                    warn: console.warn.bind(console),
+                    error: console.error.bind(console),
+                };
+    }
+    /**
+     * Initialize the file upload API with configuration
+     */
+    async initialize(options) {
+        if (this.initialized) {
+            return; // Already initialized
+        }
+        try {
+            this.logger.debug("server", "Initializing FileUploadAPI...");
+            this.manager = new FileUploadManager.FileUploadManager(options, this.logger);
+            await this.manager.initialize();
+            this.initialized = true;
+            this.logger.debug("server", `FileUploadAPI initialized, enabled: ${this.manager.isEnabled()}`);
+        }
+        catch (error) {
+            this.logger.error("server", "Failed to initialize FileUploadAPI:", error.message);
+            throw error;
+        }
+    }
+    /**
+     * Check if the file upload API is enabled
+     */
+    isEnabled() {
+        return this.manager?.isEnabled() === true;
+    }
+    /**
+     * Handle multer errors and convert them to proper HTTP responses
+     */
+    handleMulterError(err, req, res) {
+        if (err.code === "LIMIT_FILE_SIZE") {
+            const maxSize = this.manager?.getConfig()?.maxFileSize || 1024 * 1024;
+            const maxSizeMB = (maxSize / (1024 * 1024)).toFixed(2);
+            res.status(400).json({
+                success: false,
+                error: "File too large",
+                message: `File size exceeds the maximum limit of ${maxSizeMB}MB`,
+                details: {
+                    maxSize,
+                    maxSizeMB,
+                    fileSize: req.file ? req.file.size : "unknown",
+                },
+            });
+            return;
+        }
+        if (err.code === "LIMIT_UNEXPECTED_FILE") {
+            res.status(400).json({
+                success: false,
+                error: "Unexpected field",
+                message: "Unexpected file field name",
+            });
+            return;
+        }
+        if (err.code === "LIMIT_FILE_COUNT") {
+            res.status(400).json({
+                success: false,
+                error: "Too many files",
+                message: "Too many files uploaded",
+            });
+            return;
+        }
+        // Handle custom file filter errors
+        if (err.message) {
+            if (err.message.includes("File too large")) {
+                res.status(400).json({
+                    success: false,
+                    error: "File too large",
+                    message: err.message,
+                });
+                return;
+            }
+            if (err.message.includes("not allowed")) {
+                res.status(400).json({
+                    success: false,
+                    error: "File type not allowed",
+                    message: err.message,
+                });
+                return;
+            }
+        }
+        // Generic multer error
+        res.status(400).json({
+            success: false,
+            error: "Upload error",
+            message: err.message || "An error occurred during file upload",
+        });
+    }
+    /**
+     * Create a middleware for uploading a single file
+     *
+     * @param fieldname - The name of the form field containing the file
+     * @returns Express middleware function
+     */
+    single(fieldname) {
+        return (req, res, next) => {
+            if (!this.isEnabled()) {
+                return res.status(500).json({
+                    success: false,
+                    error: "Configuration Error",
+                    message: "File upload not enabled. Set fileUpload.enabled to true in server options.",
+                });
+            }
+            // Use multer middleware with built-in error handling
+            this.manager.single(fieldname)(req, res, (err) => {
+                if (err) {
+                    this.handleMulterError(err, req, res);
+                }
+                else {
+                    next();
+                }
+            });
+        };
+    }
+    /**
+     * Create a middleware for uploading multiple files with the same field name
+     *
+     * @param fieldname - The name of the form field containing the files
+     * @param maxCount - Maximum number of files to accept (optional)
+     * @returns Express middleware function
+     */
+    array(fieldname, maxCount) {
+        return (req, res, next) => {
+            if (!this.isEnabled()) {
+                return res.status(500).json({
+                    success: false,
+                    error: "Configuration Error",
+                    message: "File upload not enabled. Set fileUpload.enabled to true in server options.",
+                });
+            }
+            this.manager.array(fieldname, maxCount)(req, res, (err) => {
+                if (err) {
+                    this.handleMulterError(err, req, res);
+                }
+                else {
+                    next();
+                }
+            });
+        };
+    }
+    /**
+     * Create a middleware for uploading multiple files with different field names
+     *
+     * @param fields - Array of field configurations
+     * @returns Express middleware function
+     */
+    fields(fields) {
+        return (req, res, next) => {
+            if (!this.isEnabled()) {
+                return res.status(500).json({
+                    success: false,
+                    error: "Configuration Error",
+                    message: "File upload not enabled. Set fileUpload.enabled to true in server options.",
+                });
+            }
+            this.manager.fields(fields)(req, res, (err) => {
+                if (err) {
+                    this.handleMulterError(err, req, res);
+                }
+                else {
+                    next();
+                }
+            });
+        };
+    }
+    /**
+     * Create a middleware for uploading any files (accepts all files)
+     *
+     * @returns Express middleware function
+     */
+    any() {
+        return (req, res, next) => {
+            if (!this.isEnabled()) {
+                return res.status(500).json({
+                    success: false,
+                    error: "Configuration Error",
+                    message: "File upload not enabled. Set fileUpload.enabled to true in server options.",
+                });
+            }
+            this.manager.any()(req, res, (err) => {
+                if (err) {
+                    this.handleMulterError(err, req, res);
+                }
+                else {
+                    next();
+                }
+            });
+        };
+    }
+}
+// Legacy function exports for backward compatibility
+// These will be deprecated in favor of the class-based API
+// Global instance for backward compatibility
+let globalFileUploadAPI = null;
+/**
+ * Initialize the global file upload manager (legacy)
+ * This is called automatically when the server starts with file upload enabled
+ */
+function initializeFileUpload(options, logger) {
+    if (!globalFileUploadAPI) {
+        globalFileUploadAPI = new FileUploadAPI(logger);
+    }
+    globalFileUploadAPI.initialize(options);
+}
+/**
+ * Create a middleware for uploading a single file (legacy)
+ */
+function uploadSingle(fieldname) {
+    return (req, res, next) => {
+        if (!globalFileUploadAPI) {
+            return res.status(500).json({
+                success: false,
+                error: "Configuration Error",
+                message: "File upload not initialized. Make sure fileUpload.enabled is true in server options.",
+            });
+        }
+        return globalFileUploadAPI.single(fieldname)(req, res, next);
+    };
+}
+/**
+ * Create a middleware for uploading multiple files with the same field name (legacy)
+ */
+function uploadArray(fieldname, maxCount) {
+    return (req, res, next) => {
+        if (!globalFileUploadAPI) {
+            return res.status(500).json({
+                success: false,
+                error: "Configuration Error",
+                message: "File upload not initialized. Make sure fileUpload.enabled is true in server options.",
+            });
+        }
+        return globalFileUploadAPI.array(fieldname, maxCount)(req, res, next);
+    };
+}
+/**
+ * Create a middleware for uploading multiple files with different field names (legacy)
+ */
+function uploadFields(fields) {
+    return (req, res, next) => {
+        if (!globalFileUploadAPI) {
+            return res.status(500).json({
+                success: false,
+                error: "Configuration Error",
+                message: "File upload not initialized. Make sure fileUpload.enabled is true in server options.",
+            });
+        }
+        return globalFileUploadAPI.fields(fields)(req, res, next);
+    };
+}
+/**
+ * Create a middleware for uploading any files (legacy)
+ */
+function uploadAny() {
+    return (req, res, next) => {
+        if (!globalFileUploadAPI) {
+            return res.status(500).json({
+                success: false,
+                error: "Configuration Error",
+                message: "File upload not initialized. Make sure fileUpload.enabled is true in server options.",
+            });
+        }
+        return globalFileUploadAPI.any()(req, res, next);
+    };
+}
+// Export types for TypeScript users
+// Types are available through the main types export
+
+exports.FileUploadAPI = FileUploadAPI;
+exports.initializeFileUpload = initializeFileUpload;
+exports.uploadAny = uploadAny;
+exports.uploadArray = uploadArray;
+exports.uploadFields = uploadFields;
+exports.uploadSingle = uploadSingle;
+//# sourceMappingURL=file-upload.js.map

package/dist/cjs/src/file-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload.js","sources":["../../../src/file-upload.ts"],"sourcesContent":[null],"names":["FileUploadManager"],"mappings":"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"}

package/dist/cjs/src/index.js

@@ -1,5 +1,6 @@
 'use strict';
 
+var fileUpload = require('./file-upload.js');
 var Router$1 = require('./server/routing/Router.js');
 var ServerFactory = require('./server/ServerFactory.js');
 var smartRoutes = require('./server/components/fastapi/smart-routes.js');
@@ -65,6 +66,13 @@ function Router() {
     });
 }
 
+exports.FLA = fileUpload.FileUploadAPI;
+exports.FileUploadAPI = fileUpload.FileUploadAPI;
+exports.initializeFileUpload = fileUpload.initializeFileUpload;
+exports.uploadAny = fileUpload.uploadAny;
+exports.uploadArray = fileUpload.uploadArray;
+exports.uploadFields = fileUpload.uploadFields;
+exports.uploadSingle = fileUpload.uploadSingle;
 exports.XyPrissRouter = Router$1.XyPrissRouter;
 exports.createCacheMiddleware = ServerFactory.createCacheMiddleware;
 exports.createServer = ServerFactory.createServer;

package/dist/cjs/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/index.ts"],"sourcesContent":[null],"names":["XyPrissRouter"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBiF;AAgCjF;;AAEG;SACa,MAAM,GAAA;IAClB,OAAO,IAAIA,sBAAa,CAAC;AACrB,QAAA,aAAa,EAAE,KAAK;AACpB,QAAA,WAAW,EAAE,KAAK;AAClB,QAAA,MAAM,EAAE,KAAK;AAChB,KAAA,CAAC,CAAC;AACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":["../../../src/index.ts"],"sourcesContent":[null],"names":["XyPrissRouter"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBiF;AAoCjF;;AAEG;SACa,MAAM,GAAA;IAClB,OAAO,IAAIA,sBAAa,CAAC;AACrB,QAAA,aAAa,EAAE,KAAK;AACpB,QAAA,WAAW,EAAE,KAAK;AAClB,QAAA,MAAM,EAAE,KAAK;AAChB,KAAA,CAAC,CAAC;AACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/src/server/FastServer.js

@@ -119,36 +119,62 @@ class XyPrissServer {
         this.app.uploadSingle = (fieldname) => {
             // Return a middleware that will be replaced after initialization
             return async (req, res, next) => {
-                // If FileUploadManager is initialized, use it
-                if (this.fileUploadManager?.isEnabled()) {
+                // If FileUploadManager is initialized and enabled, use it
+                if (this.fileUploadManager && this.fileUploadManager.isEnabled()) {
                     return this.fileUploadManager.single(fieldname)(req, res, next);
                 }
-                // Otherwise, throw an error
-                next(new Error("File upload not initialized yet. Make sure fileUpload.enabled is true in server options."));
+                // If file upload is configured but not ready yet, wait for initialization
+                if (this.options.fileUpload?.enabled) {
+                    // Wait for initialization to complete
+                    await this.initPromise;
+                    if (this.fileUploadManager?.isEnabled()) {
+                        return this.fileUploadManager.single(fieldname)(req, res, next);
+                    }
+                }
+                // File upload not enabled or failed to initialize
+                next(new Error("File upload not enabled. Set fileUpload.enabled to true in server options."));
             };
         };
         this.app.uploadArray = (fieldname, maxCount) => {
             return async (req, res, next) => {
-                if (this.fileUploadManager?.isEnabled()) {
+                if (this.fileUploadManager && this.fileUploadManager.isEnabled()) {
                     return this.fileUploadManager.array(fieldname, maxCount)(req, res, next);
                 }
-                next(new Error("File upload not initialized yet. Make sure fileUpload.enabled is true in server options."));
+                if (this.options.fileUpload?.enabled) {
+                    await this.initPromise;
+                    if (this.fileUploadManager?.isEnabled()) {
+                        return this.fileUploadManager.array(fieldname, maxCount)(req, res, next);
+                    }
+                }
+                next(new Error("File upload not enabled. Set fileUpload.enabled to true in server options."));
             };
         };
         this.app.uploadFields = (fields) => {
             return async (req, res, next) => {
-                if (this.fileUploadManager?.isEnabled()) {
+                if (this.fileUploadManager && this.fileUploadManager.isEnabled()) {
                     return this.fileUploadManager.fields(fields)(req, res, next);
                 }
-                next(new Error("File upload not initialized yet. Make sure fileUpload.enabled is true in server options."));
+                if (this.options.fileUpload?.enabled) {
+                    await this.initPromise;
+                    if (this.fileUploadManager?.isEnabled()) {
+                        return this.fileUploadManager.fields(fields)(req, res, next);
+                    }
+                }
+                next(new Error("File upload not enabled. Set fileUpload.enabled to true in server options."));
             };
         };
         this.app.uploadAny = () => {
             return async (req, res, next) => {
-                if (this.fileUploadManager?.isEnabled()) {
+                if (this.fileUploadManager && this.fileUploadManager.isEnabled()) {
                     return this.fileUploadManager.any()(req, res, next);
                 }
-                next(new Error("File upload not initialized yet. Make sure fileUpload.enabled is true in server options."));
+                if (this.options.fileUpload?.enabled) {
+                    await this.initPromise;
+                    if (this.fileUploadManager?.isEnabled()) {
+                        return this.fileUploadManager.any()(req, res, next);
+                    }
+                }
+                next(new Error("File upload not enabled. Set fileUpload.enabled to true in server options."));
             };
         };
         this.app.upload = null; // Will be set after async initialization
@@ -270,10 +296,25 @@ class XyPrissServer {
     }
     async initializeDependentComponents() {
         // Initialize file upload manager
-        this.logger.debug("server", "Initializing FileUploadManager...");
+        this.logger.debug("server", "🔄 Initializing FileUploadManager...");
         this.fileUploadManager = new FileUploadManager.FileUploadManager(this.options.fileUpload || {}, this.logger);
-        await this.fileUploadManager.initialize();
-        this.logger.debug("server", `FileUploadManager initialized, enabled: ${this.fileUploadManager.isEnabled()}`);
+        try {
+            await this.fileUploadManager.initialize();
+            this.logger.debug("server", `✅ FileUploadManager initialized, enabled: ${this.fileUploadManager.isEnabled()}`);
+            // Initialize the global file upload API
+            if (this.fileUploadManager.isEnabled()) {
+                const { initializeFileUpload } = await Promise.resolve().then(function () { return require('../file-upload.js'); });
+                initializeFileUpload(this.options.fileUpload || {}, this.logger);
+                this.logger.debug("server", "✅ Global file upload API initialized");
+            }
+            else {
+                this.logger.debug("server", "ℹ️ File upload not enabled, skipping API initialization");
+            }
+        }
+        catch (error) {
+            this.logger.error("server", "❌ Failed to initialize FileUploadManager:", error.message);
+            throw error;
+        }
         // Add file upload methods to app if enabled
         if (this.fileUploadManager.isEnabled()) {
             this.logger.debug("server", "Adding file upload methods to app");