xypriss 3.2.3 → 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)
@@ -7436,63 +7436,119 @@ interface FileUploadConfig {
 }
 
 /**
- * File Upload Manager for XyPriss Server
- * Handles multer configuration and file upload middleware setup
+ * 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 });
+ * ```
  */
 
-declare class FileUploadManager {
-    private logger;
+/**
+ * Configuration Manager Class
+ * Singleton pattern for managing XyPriss configurations
+ */
+declare class ConfigurationManager {
+    private static instance;
     private config;
-    private multer;
-    private upload;
-    constructor(config: FileUploadConfig, logger: Logger);
+    private initialized;
     /**
-     * Initialize the file upload manager
+     * Private constructor to enforce singleton pattern
      */
-    initialize(): Promise<void>;
+    private constructor();
     /**
-     * Create default file filter based on configuration
+     * Get the singleton instance
      */
-    private createDefaultFileFilter;
+    private static getInstance;
     /**
-     * Get the multer upload instance
+     * Set the entire configuration
+     * @param config - Server configuration options
      */
-    getUpload(): any;
+    static set(config: ServerOptions): void;
     /**
-     * Get single file upload middleware
+     * Get a specific configuration section
+     * @param key - Configuration key (e.g., 'fileUpload', 'security', 'cache')
+     * @returns The configuration value for the specified key
      */
-    single(fieldname: string): any;
+    static get<K extends keyof ServerOptions>(key: K): ServerOptions[K] | undefined;
     /**
-     * Get array file upload middleware
+     * Get the entire configuration object
+     * @returns Complete server configuration
      */
-    array(fieldname: string, maxCount?: number): any;
+    static getAll(): ServerOptions;
     /**
-     * Get fields file upload middleware
+     * Update a specific configuration section
+     * @param key - Configuration key to update
+     * @param value - New value for the configuration section
      */
-    fields(fields: any[]): any;
+    static update<K extends keyof ServerOptions>(key: K, value: ServerOptions[K]): void;
     /**
-     * Get any file upload middleware
+     * Merge configuration with existing config
+     * @param config - Partial configuration to merge
      */
-    any(): any;
+    static merge(config: Partial<ServerOptions>): void;
     /**
-     * Get none file upload middleware (for form data without files)
+     * Check if configuration has been initialized
+     * @returns true if configuration has been set, false otherwise
      */
-    none(): any;
+    static isInitialized(): boolean;
     /**
-     * Check if file upload is enabled
+     * Reset configuration to empty state
+     * Useful for testing or reinitializing
      */
-    isEnabled(): boolean;
+    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];
     /**
-     * Get current configuration
+     * Delete a specific configuration section
+     * @param key - Configuration key to delete
      */
-    getConfig(): FileUploadConfig;
+    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(options: any, logger: Logger): void;
+declare function initializeFileUpload(configManager: typeof ConfigurationManager, logger: Logger): void;
 /**
  * Create a middleware for uploading a single file (legacy)
  */
@@ -7541,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
      */
@@ -7585,6 +7654,8 @@ declare class FileUploadAPI {
     any(): (req: any, res: any, next: any) => any;
 }
 
+declare const Uploader: FileUploadAPI;
+
 interface RouteDefinition {
     method: string;
     path: string;
@@ -12486,5 +12557,5 @@ declare class TrustProxy {
  */
 declare function Router(): XyPrissRouter;
 
-export { CachePlugin as CachePluginBase, CompressionPlugin, ConnectionPlugin, DEFAULT_PLUGIN_CONFIG, FileUploadAPI as FLA, FileUploadManager as FiUp, 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, FileUploadConfig as FiUpConfig, 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.3",
+    "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",
@@ -25,7 +25,8 @@
         "test": "jest",
         "test:watch": "jest --watch",
         "test:coverage": "jest --coverage",
-        "benchmark": "node benchmarks/index.js"
+        "benchmark": "node benchmarks/index.js",
+        "prepublishOnly": "npm run build"
     },
     "exports": {
         ".": {