xypriss 3.2.2 → 3.3.0

package/dist/index.d.ts

@@ -5176,7 +5176,7 @@ declare function createCacheMiddleware(cache: SecureCacheAdapter, options?: Rout
  * Multi-Server App interface for managing multiple server instances
  * Extends UltraFastApp to maintain API compatibility
  */
-interface MultiServerApp extends Omit<UltraFastApp, 'start'> {
+interface MultiServerApp extends Omit<UltraFastApp, "start"> {
     /**
      * Start all server instances (simple API - hides complexity)
      * @param port - Port parameter (ignored in multi-server mode)
@@ -5583,79 +5583,6 @@ interface XyPrissMiddlewareAPI {
     getConfig(): any;
 }
 
-/**
- * File Upload Manager for XyPriss Server
- * Handles multer configuration and file upload middleware setup
- */
-
-interface FileUploadConfig {
-    /** Enable file upload handling */
-    enabled?: boolean;
-    /** Maximum file size in bytes */
-    maxFileSize?: number;
-    /** Maximum number of files per request */
-    maxFiles?: number;
-    /** Allowed MIME types */
-    allowedMimeTypes?: string[];
-    /** Allowed file extensions */
-    allowedExtensions?: string[];
-    /** Upload destination directory */
-    destination?: string;
-    /** Custom filename function */
-    filename?: (req: any, file: any, callback: (error: Error | null, filename: string) => void) => void;
-    /** Detailed limits configuration */
-    limits?: {
-        /** Max field name size in bytes */
-        fieldNameSize?: number;
-        /** Max field value size in bytes */
-        fieldSize?: number;
-        /** Max number of non-file fields */
-        fields?: number;
-        /** Max file size in bytes */
-        fileSize?: number;
-        /** Max number of file fields */
-        files?: number;
-        /** Max number of header key=>value pairs */
-        headerPairs?: number;
-    };
-    /** Preserve full paths instead of just filenames */
-    preservePath?: boolean;
-    /** Custom file filter function */
-    fileFilter?: (req: any, file: any, callback: (error: Error | null, acceptFile: boolean) => void) => void;
-    /** Storage type */
-    storage?: 'disk' | 'memory' | 'custom';
-    /** Create parent directories if they don't exist */
-    createParentPath?: boolean;
-    /** Abort request on limit reached */
-    abortOnLimit?: boolean;
-    /** Response message when limit is reached */
-    responseOnLimit?: string;
-    /** Use temporary files for large uploads */
-    useTempFiles?: boolean;
-    /** Temporary file directory */
-    tempFileDir?: string;
-    /** Parse nested objects in multipart data */
-    parseNested?: boolean;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Custom multer options */
-    multerOptions?: {
-        dest?: string;
-        storage?: any;
-        limits?: {
-            fieldNameSize?: number;
-            fieldSize?: number;
-            fields?: number;
-            fileSize?: number;
-            files?: number;
-            headerPairs?: number;
-        };
-        preservePath?: boolean;
-        fileFilter?: (req: any, file: any, callback: (error: Error | null, acceptFile: boolean) => void) => void;
-        [key: string]: any;
-    };
-}
-
 /**
  * XyPrissJS Express Types - Main Export File
  *
@@ -6798,6 +6725,12 @@ interface UltraFastApp {
      * encryption, compression, and intelligent strategies.
      */
     cache?: SecureCacheAdapter;
+    /**
+     * Server configuration options.
+     *
+     * Provides access to the configuration options passed to createServer.
+     */
+    configs?: ServerOptions;
     /**
      * Invalidate cache entries by pattern.
      *
@@ -7434,6 +7367,208 @@ declare class Logger {
     child(component: LogComponent, config?: Partial<ServerOptions["logging"]>): Logger;
 }
 
+interface FileUploadConfig {
+    /** Enable file upload handling */
+    enabled?: boolean;
+    /** Maximum file size in bytes */
+    maxFileSize?: number;
+    /** Maximum number of files per request */
+    maxFiles?: number;
+    /** Allowed MIME types */
+    allowedMimeTypes?: string[];
+    /** Allowed file extensions */
+    allowedExtensions?: string[];
+    /** Upload destination directory */
+    destination?: string;
+    /** Custom filename function */
+    filename?: (req: any, file: any, callback: (error: Error | null, filename: string) => void) => void;
+    /** Detailed limits configuration */
+    limits?: {
+        /** Max field name size in bytes */
+        fieldNameSize?: number;
+        /** Max field value size in bytes */
+        fieldSize?: number;
+        /** Max number of non-file fields */
+        fields?: number;
+        /** Max file size in bytes */
+        fileSize?: number;
+        /** Max number of file fields */
+        files?: number;
+        /** Max number of header key=>value pairs */
+        headerPairs?: number;
+    };
+    /** Preserve full paths instead of just filenames */
+    preservePath?: boolean;
+    /** Custom file filter function */
+    fileFilter?: (req: any, file: any, callback: (error: Error | null, acceptFile: boolean) => void) => void;
+    /** Storage type */
+    storage?: 'disk' | 'memory' | 'custom';
+    /** Create parent directories if they don't exist */
+    createParentPath?: boolean;
+    /** Abort request on limit reached */
+    abortOnLimit?: boolean;
+    /** Response message when limit is reached */
+    responseOnLimit?: string;
+    /** Use temporary files for large uploads */
+    useTempFiles?: boolean;
+    /** Temporary file directory */
+    tempFileDir?: string;
+    /** Parse nested objects in multipart data */
+    parseNested?: boolean;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Custom multer options */
+    multerOptions?: {
+        dest?: string;
+        storage?: any;
+        limits?: {
+            fieldNameSize?: number;
+            fieldSize?: number;
+            fields?: number;
+            fileSize?: number;
+            files?: number;
+            headerPairs?: number;
+        };
+        preservePath?: boolean;
+        fileFilter?: (req: any, file: any, callback: (error: Error | null, acceptFile: boolean) => void) => void;
+        [key: string]: any;
+    };
+}
+
+/**
+ * XyPriss Configuration Manager
+ *
+ * Provides a safe way to access and update XyPriss configurations
+ * without encountering "cannot access before initialization" errors.
+ *
+ * This class acts as a singleton configuration store that can be used
+ * in modular structures where accessing `app.configs` directly might
+ * cause initialization timing issues.
+ *
+ * @example
+ * ```typescript
+ * import { Configs } from 'xypriss';
+ *
+ * // Set configuration
+ * Configs.set({
+ *   fileUpload: {
+ *     enabled: true,
+ *     maxFileSize: 5 * 1024 * 1024
+ *   }
+ * });
+ *
+ * // Get configuration
+ * const fileUploadConfig = Configs.get('fileUpload');
+ *
+ * // Get entire config
+ * const allConfigs = Configs.getAll();
+ *
+ * // Update specific config
+ * Configs.update('fileUpload', { maxFileSize: 10 * 1024 * 1024 });
+ * ```
+ */
+
+/**
+ * Configuration Manager Class
+ * Singleton pattern for managing XyPriss configurations
+ */
+declare class ConfigurationManager {
+    private static instance;
+    private config;
+    private initialized;
+    /**
+     * Private constructor to enforce singleton pattern
+     */
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    private static getInstance;
+    /**
+     * Set the entire configuration
+     * @param config - Server configuration options
+     */
+    static set(config: ServerOptions): void;
+    /**
+     * Get a specific configuration section
+     * @param key - Configuration key (e.g., 'fileUpload', 'security', 'cache')
+     * @returns The configuration value for the specified key
+     */
+    static get<K extends keyof ServerOptions>(key: K): ServerOptions[K] | undefined;
+    /**
+     * Get the entire configuration object
+     * @returns Complete server configuration
+     */
+    static getAll(): ServerOptions;
+    /**
+     * Update a specific configuration section
+     * @param key - Configuration key to update
+     * @param value - New value for the configuration section
+     */
+    static update<K extends keyof ServerOptions>(key: K, value: ServerOptions[K]): void;
+    /**
+     * Merge configuration with existing config
+     * @param config - Partial configuration to merge
+     */
+    static merge(config: Partial<ServerOptions>): void;
+    /**
+     * Check if configuration has been initialized
+     * @returns true if configuration has been set, false otherwise
+     */
+    static isInitialized(): boolean;
+    /**
+     * Reset configuration to empty state
+     * Useful for testing or reinitializing
+     */
+    static reset(): void;
+    /**
+     * Check if a specific configuration section exists
+     * @param key - Configuration key to check
+     * @returns true if the configuration section exists
+     */
+    static has<K extends keyof ServerOptions>(key: K): boolean;
+    /**
+     * Get configuration with a default value if not set
+     * @param key - Configuration key
+     * @param defaultValue - Default value to return if key doesn't exist
+     * @returns Configuration value or default value
+     */
+    static getOrDefault<K extends keyof ServerOptions>(key: K, defaultValue: ServerOptions[K]): ServerOptions[K];
+    /**
+     * Delete a specific configuration section
+     * @param key - Configuration key to delete
+     */
+    static delete<K extends keyof ServerOptions>(key: K): void;
+}
+
+/**
+ * Initialize the global file upload manager (legacy)
+ * This is called automatically when the server starts with file upload enabled
+ *
+ * @param configManager - The Configs class for accessing configuration
+ * @param logger - Logger instance
+ */
+declare function initializeFileUpload(configManager: typeof ConfigurationManager, logger: Logger): void;
+/**
+ * Create a middleware for uploading a single file (legacy)
+ */
+declare function uploadSingle(fieldname: string): (req: any, res: any, next: any) => any;
+/**
+ * Create a middleware for uploading multiple files with the same field name (legacy)
+ */
+declare function uploadArray(fieldname: string, maxCount?: number): (req: any, res: any, next: any) => any;
+/**
+ * Create a middleware for uploading multiple files with different field names (legacy)
+ */
+declare function uploadFields(fields: Array<{
+    name: string;
+    maxCount?: number;
+}>): (req: any, res: any, next: any) => any;
+/**
+ * Create a middleware for uploading any files (legacy)
+ */
+declare function uploadAny(): (req: any, res: any, next: any) => any;
+
 /**
  * XyPriss File Upload API
  *
@@ -7462,9 +7597,22 @@ declare class FileUploadAPI {
     private initialized;
     constructor(logger?: Logger);
     /**
-     * Initialize the file upload API with configuration
+     * Initialize the file upload API with configuration from Configs
+     *
+     * This method requires the Configs class to enforce a single source of truth.
+     * Configuration is accessed internally from Configs.get('fileUpload').
+     *
+     * @param configManager - The Configs class (not an instance, the class itself)
+     *
+     * @example
+     * ```typescript
+     * import { Configs } from 'xypriss';
+     *
+     * const upload = new FileUploadAPI();
+     * await upload.initialize(Configs);
+     * ```
      */
-    initialize(options: any): Promise<void>;
+    initialize(configManager: typeof ConfigurationManager): Promise<void>;
     /**
      * Check if the file upload API is enabled
      */
@@ -7505,30 +7653,8 @@ declare class FileUploadAPI {
      */
     any(): (req: any, res: any, next: any) => any;
 }
-/**
- * Initialize the global file upload manager (legacy)
- * This is called automatically when the server starts with file upload enabled
- */
-declare function initializeFileUpload(options: any, logger: Logger): void;
-/**
- * Create a middleware for uploading a single file (legacy)
- */
-declare function uploadSingle(fieldname: string): (req: any, res: any, next: any) => any;
-/**
- * Create a middleware for uploading multiple files with the same field name (legacy)
- */
-declare function uploadArray(fieldname: string, maxCount?: number): (req: any, res: any, next: any) => any;
-/**
- * Create a middleware for uploading multiple files with different field names (legacy)
- */
-declare function uploadFields(fields: Array<{
-    name: string;
-    maxCount?: number;
-}>): (req: any, res: any, next: any) => any;
-/**
- * Create a middleware for uploading any files (legacy)
- */
-declare function uploadAny(): (req: any, res: any, next: any) => any;
+
+declare const Uploader: FileUploadAPI;
 
 interface RouteDefinition {
     method: string;
@@ -12431,5 +12557,5 @@ declare class TrustProxy {
  */
 declare function Router(): XyPrissRouter;
 
-export { CachePlugin as CachePluginBase, CompressionPlugin, ConnectionPlugin, DEFAULT_PLUGIN_CONFIG, FileUploadAPI as FLA, FileUploadAPI, JWTAuthPlugin, NetworkCategory, NetworkPlugin, NetworkPluginFactory, NetworkPluginUtils, PERFORMANCE_TARGETS, PLUGIN_SYSTEM_NAME, PLUGIN_SYSTEM_VERSION, PerformanceMonitor, PerformancePlugin as PerformancePluginBase, PluginDevelopmentHelpers, PluginEngine, PluginEventType, PluginPriority, PluginRegistry, PluginSystemFactory, PluginSystemUtils, PluginType, ProxyPlugin, RateLimitPlugin, ResponseTimePlugin, Route, Router, SecurityMiddleware, SecurityPlugin as SecurityPluginBase, SmartCachePlugin, TrustProxy, XyPrissRouter, createCacheMiddleware, createCircularRefDebugger, createOptimalCache, createSafeJsonMiddleware, createServer, createServerInstance, expressStringify, fastStringify, initializeFileUpload, quickServer, safeJsonStringify, safeStringify, sendSafeJson, setupSafeJson, uploadAny, uploadArray, uploadFields, uploadSingle };
-export type { BasePlugin, CacheConfig, CachePlugin$1 as CachePlugin, CompressionAlgorithm, CompressionConfig, ConnectionConfig, FailoverConfig, HTTPCacheConfig, HealthCheckConfig, CachePlugin$1 as ICachePlugin, PerformancePlugin$1 as IPerformancePlugin, SecurityPlugin$1 as ISecurityPlugin, LoadBalancingStrategy, MultiServerApp, MultiServerConfig, NativePlugin, NetworkExecutionContext, NetworkExecutionResult, NetworkHealthStatus, NetworkPluginConfig, NetworkSecurityConfig, NextFunction, PerformanceConfig, PerformanceMetrics, PerformancePlugin$1 as PerformancePlugin, PluginConfiguration, PluginEvent, PluginExecutionContext, PluginExecutionResult, PluginExecutionStats, PluginInitializationContext, PluginRegistryConfig, ProxyConfig, RateLimitConfig, RateLimitRule, RateLimitStrategy, RedisConfig, XyPrisRequest as Request, RequestHandler, XyPrisResponse as Response, RouteConfig, RouteOptions, SecurityConfig, SecurityPlugin$1 as SecurityPlugin, ServerOptions, SmartRouteConfig, TrustProxyValue$1 as TrustProxyValue, UltraFastApp, UpstreamServer, WebSocketConfig, MultiServerApp as XyPMS, XyPrisRequest as XyPrissRequest, XyPrisResponse as XyPrissResponse };
+export { CachePlugin as CachePluginBase, CompressionPlugin, ConfigurationManager as Configs, ConnectionPlugin, DEFAULT_PLUGIN_CONFIG, FileUploadAPI as FLA, FileUploadAPI, JWTAuthPlugin, NetworkCategory, NetworkPlugin, NetworkPluginFactory, NetworkPluginUtils, PERFORMANCE_TARGETS, PLUGIN_SYSTEM_NAME, PLUGIN_SYSTEM_VERSION, PerformanceMonitor, PerformancePlugin as PerformancePluginBase, PluginDevelopmentHelpers, PluginEngine, PluginEventType, PluginPriority, PluginRegistry, PluginSystemFactory, PluginSystemUtils, PluginType, ProxyPlugin, RateLimitPlugin, ResponseTimePlugin, Route, Router, SecurityMiddleware, SecurityPlugin as SecurityPluginBase, SmartCachePlugin, TrustProxy, Uploader, XyPrissRouter, createCacheMiddleware, createCircularRefDebugger, createOptimalCache, createSafeJsonMiddleware, createServer, createServerInstance, expressStringify, fastStringify, initializeFileUpload, quickServer, safeJsonStringify, safeStringify, sendSafeJson, setupSafeJson, uploadAny, uploadArray, uploadFields, uploadSingle };
+export type { BasePlugin, CacheConfig, CachePlugin$1 as CachePlugin, CompressionAlgorithm, CompressionConfig, ConnectionConfig, FailoverConfig, FileUploadConfig as FiUpConfig, FileUploadConfig, HTTPCacheConfig, HealthCheckConfig, CachePlugin$1 as ICachePlugin, PerformancePlugin$1 as IPerformancePlugin, SecurityPlugin$1 as ISecurityPlugin, LoadBalancingStrategy, MultiServerApp, MultiServerConfig, NativePlugin, NetworkExecutionContext, NetworkExecutionResult, NetworkHealthStatus, NetworkPluginConfig, NetworkSecurityConfig, NextFunction, PerformanceConfig, PerformanceMetrics, PerformancePlugin$1 as PerformancePlugin, PluginConfiguration, PluginEvent, PluginExecutionContext, PluginExecutionResult, PluginExecutionStats, PluginInitializationContext, PluginRegistryConfig, ProxyConfig, RateLimitConfig, RateLimitRule, RateLimitStrategy, RedisConfig, XyPrisRequest as Request, RequestHandler, XyPrisResponse as Response, RouteConfig, RouteOptions, SecurityConfig, SecurityPlugin$1 as SecurityPlugin, ServerOptions, SmartRouteConfig, TrustProxyValue$1 as TrustProxyValue, UltraFastApp, UpstreamServer, WebSocketConfig, MultiServerApp as XyPMS, XyPrisRequest as XyPrissRequest, XyPrisResponse as XyPrissResponse };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xypriss",
-    "version": "3.2.2",
+    "version": "3.3.0",
     "description": "XyPriss is a lightweight, TypeScript-first, open-source Node.js web framework crafted for developers seeking a familiar Express-like API without Express dependencies. It features built-in security middleware, a robust routing system, and performance optimizations to build scalable, secure web applications effortlessly. Join our community and contribute on GitHub!",
     "main": "dist/cjs/index.js",
     "module": "dist/esm/index.js",
@@ -16,6 +16,7 @@
         "scripts/**/*",
         "scripts/postinstall.js"
     ],
+    "homepage": "https://xypriss.nehonix.com",
     "scripts": {
         "postinstall": "node scripts/postinstall.js",
         "install-memory-cli": "node scripts/install-memory-cli.js",
@@ -266,7 +267,7 @@
         "tweetnacl": "^1.0.3",
         "ws": "^8.18.2",
         "xss": "^1.0.15",
-        "xypriss": "^2.3.3",
+        "xypriss": "^3.2.2",
         "xypriss-security": "^1.1.10"
     }
 }