xypriss 4.0.0 → 4.1.0

package/dist/index.d.ts

@@ -3941,7 +3941,7 @@ declare enum PluginType {
     CACHE = "cache",// <0.5ms - Cache operations, hit/miss handling
     PERFORMANCE = "performance",// <0.3ms - Metrics collection, monitoring
     POST_RESPONSE = "post-response",// <0.2ms - Cleanup, logging, analytics
-    MIDDLEWARE = "middleware",// <1ms - Custom Express middleware integration
+    MIDDLEWARE = "middleware",// <1ms - Custom XyPriss middleware integration
     NATIVE = "native"
 }
 /**
@@ -4459,7 +4459,7 @@ declare class ServerMaintenancePlugin extends EventEmitter {
  * Manages all server plugins including route optimization and maintenance
  */
 
-declare class PluginManager$1 extends EventEmitter {
+declare class PluginManager extends EventEmitter {
     private config;
     private routeOptimizationPlugin?;
     private serverMaintenancePlugin?;
@@ -4570,24 +4570,35 @@ interface ConsoleInterceptionStats {
 }
 
 /***************************************************************************
- * XyPrissJS - Secure Array Types
+ * ConsoleInterceptor.ts - Console Interception System for FastXyPrissServer
+ * This file contains the ConsoleInterceptor class, which intercepts and manages all console output through the unified logging system
+ * @author Nehonix
+ * @license NehoPSLA - PROPRIETARY SOFTWARE
+ * @version 1.0
+ * @copyright Copyright (c) 2025 Nehonix. All rights reserved.
  *
- * This file contains type definitions for the SecureArray architecture
+ * PROPRIETARY AND CONFIDENTIAL
  *
- * @author Nehonix
- * @license MIT
+ * This software is the proprietary information of NEHONIX and is protected
+ * by copyright law and international treaties. Unauthorized reproduction,
+ * distribution, modification, or use of this software is strictly prohibited
+ * and may result in severe civil and criminal penalties.
  *
- * Copyright (c) 2025 Nehonix. All rights reserved.
+ * Licensed under the NEHO Proprietary Software License Agreement (NehoPSLA).
+ * See LICENSE.md for full terms and conditions.
+ * Official License: http://dll.nehonix.com/NehoPSLA/license
  *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
+ * ACCESS RESTRICTIONS:
+ * - This software is exclusively for use by Authorized Personnel of NEHONIX
+ * - Intended for Internal Use only within NEHONIX operations
+ * - No rights granted to unauthorized individuals or entities
+ * - All modifications are works made for hire assigned to NEHONIX
  *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
+ * PROHIBITED ACTIVITIES:
+ * - Copying, distributing, or sublicensing without written permission
+ * - Reverse engineering, decompiling, or disassembling
+ * - Creating derivative works without explicit authorization
+ * - External use or commercial distribution outside NEHONIX
  *
  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
@@ -4596,12 +4607,17 @@ interface ConsoleInterceptionStats {
  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
+ *
+ * For questions or permissions, contact:
+ * NEHONIX Legal Department
+ * Email: legal@nehonix.com
+ * Website: www.nehonix.com
  ***************************************************************************** */
+
 /**
  * Console Interception System for FastXyPrissServer
  * Intercepts and manages all console output through the unified logging system
  */
-
 declare class ConsoleInterceptor {
     private logger;
     private config;
@@ -4681,6 +4697,10 @@ declare class ConsoleInterceptor {
      * Add source information to intercepted call
      */
     private addSourceInformation;
+    /**
+     * Check if a message matches exclude patterns (supports regex and strings)
+     */
+    private matchesExcludePattern;
     /**
      * Check if call should be intercepted based on filters
      */
@@ -4925,7 +4945,7 @@ declare class XyPrissServer {
     private serverPluginManager;
     private securityMiddleware?;
     private lifecycleManager;
-    constructor(userOptions?: ServerOptions);
+    constructor();
     /**
      * Initialize file upload methods synchronously for immediate availability
      */
@@ -4954,9 +4974,10 @@ declare class XyPrissServer {
     /**
      * Get the server plugin manager
      */
-    getServerPluginManager(): PluginManager$1 | undefined;
+    getServerPluginManager(): PluginManager | undefined;
     /**
      * Wait for full initialization (cache, console interceptor, and all components)
+     * This method is called automatically by the lifecycle manager
      */
     waitForReady(): Promise<void>;
     /**
@@ -7447,6 +7468,10 @@ interface FileUploadConfig {
  * in modular structures where accessing `app.configs` directly might
  * cause initialization timing issues.
  *
+ * **IMPORTANT**: This is the SINGLE SOURCE OF TRUTH for all XyPriss configurations.
+ * All components should use `Configs.get()` to access configuration values
+ * instead of copying values during initialization.
+ *
  * @example
  * ```typescript
  * import { Configs } from 'xypriss';
@@ -7465,7 +7490,7 @@ interface FileUploadConfig {
  * // Get entire config
  * const allConfigs = Configs.getAll();
  *
- * // Update specific config
+ * // Update specific config (updates the source of truth)
  * Configs.update('fileUpload', { maxFileSize: 10 * 1024 * 1024 });
  * ```
  */
@@ -7480,6 +7505,7 @@ declare class ConfigurationManager {
     private initialized;
     /**
      * Private constructor to enforce singleton pattern
+     * Initializes with default configuration
      */
     private constructor();
     /**
@@ -7488,7 +7514,7 @@ declare class ConfigurationManager {
     private static getInstance;
     /**
      * Set the entire configuration
-     * @param config - Server configuration options
+     * @param config - XP Server configuration options
      */
     static set(config: ServerOptions): void;
     /**
@@ -7496,20 +7522,27 @@ declare class ConfigurationManager {
      * @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;
+    static get<K extends keyof ServerOptions>(key: K): ServerOptions[K];
     /**
      * Get the entire configuration object
-     * @returns Complete server configuration
+     * @returns Complete XyPriss Server Configuration (XPSC)
      */
     static getAll(): ServerOptions;
     /**
-     * Update a specific configuration section
+     * Update a specific XyPriss configuration section (deep merge)
      * @param key - Configuration key to update
-     * @param value - New value for the configuration section
+     * @param value - Partial value to merge with existing configuration
+     */
+    static update<K extends keyof ServerOptions>(key: K, value: Partial<ServerOptions[K]>): void;
+    /**
+     * Deep merge helper function
+     * @param target - Target object
+     * @param source - Source object to merge
+     * @returns Merged object
      */
-    static update<K extends keyof ServerOptions>(key: K, value: ServerOptions[K]): void;
+    private static deepMerge;
     /**
-     * Merge configuration with existing config
+     * Merge configuration with existing config (deep merge)
      * @param config - Partial configuration to merge
      */
     static merge(config: Partial<ServerOptions>): void;
@@ -12433,115 +12466,85 @@ declare class PluginDevelopmentHelpers {
 }
 
 /**
- * Plugin Manager
- * Manages plugin registration, lifecycle, and execution
+ * Plugin API
+ * Public API for plugin management as documented in PLUGIN_SYSTEM_GUIDE.md
  */
 
-declare class PluginManager {
-    private plugins;
-    private pluginOrder;
-    private server;
-    private logger;
-    constructor(server: XyPrissServer$1);
-    /**
-     * Register a plugin
-     */
-    register(plugin: XyPrissPlugin | PluginCreator, config?: any): void;
-    /**
-     * Initialize all plugins (resolve dependencies and set execution order)
-     */
-    initialize(): Promise<void>;
-    /**
-     * Execute a lifecycle hook on all plugins
-     */
-    executeHook(hookName: keyof XyPrissPlugin, ...args: any[]): Promise<void>;
-    /**
-     * Register routes from all plugins
-     */
-    registerRoutes(app: UltraFastApp): void;
-    /**
-     * Apply middleware from all plugins
-     */
-    applyMiddleware(app: UltraFastApp): void;
-    /**
-     * Apply error handlers from all plugins
-     * Wraps route methods to catch errors and call plugin error handlers
-     */
-    applyErrorHandlers(app: UltraFastApp): void;
-    /**
-     * Get a plugin by name
-     */
-    getPlugin(name: string): XyPrissPlugin | undefined;
-    /**
-     * Resolve dependencies and determine execution order
-     */
-    private resolveDependencies;
-    /**
-     * Shutdown all plugins
-     */
-    shutdown(): Promise<void>;
-}
-
 /**
- * Plugin API - Imperative plugin registration
- *
- * Usage:
- *   import { Plugin } from 'xypriss';
- *
- *   Plugin.register({
- *     name: 'my-plugin',
- *     version: '1.0.0',
- *     onServerStart: () => console.log('Started!')
- *   });
+ * Plugin API
+ * Provides imperative methods for plugin management
  */
-
-declare class PluginAPI {
-    private static manager;
-    /**
-     * Set the plugin manager (called internally by ServerFactory)
-     */
-    static setManager(manager: PluginManager): void;
+declare const Plugin: {
     /**
      * Register a plugin imperatively
+     * @param plugin - Plugin instance or creator function
+     * @param config - Optional configuration
      *
      * @example
+     * ```typescript
      * Plugin.register({
-     *   name: 'my-plugin',
-     *   version: '1.0.0',
-     *   onServerStart: () => console.log('Started!')
+     *   name: "my-plugin",
+     *   version: "1.0.0",
+     *   onServerStart: () => console.log("Started!")
      * });
+     * ```
      */
-    static register(plugin: XyPrissPlugin | PluginCreator, config?: any): void;
+    register(plugin: XyPrissPlugin | PluginCreator, config?: any): void;
     /**
      * Get a registered plugin by name
+     * @param name - Plugin name
+     * @returns Plugin instance or undefined if not found
+     *
+     * @example
+     * ```typescript
+     * const plugin = Plugin.get("my-plugin");
+     * if (plugin) {
+     *   console.log(`Found plugin: ${plugin.name}@${plugin.version}`);
+     * }
+     * ```
      */
-    static get(name: string): XyPrissPlugin | undefined;
+    get(name: string): XyPrissPlugin | undefined;
     /**
-     * Create a plugin (helper for creating plugin objects)
+     * Create a plugin (helper method)
+     * This is just a type-safe identity function that helps with TypeScript inference
+     * @param plugin - Plugin definition
+     * @returns The same plugin instance
      *
      * @example
+     * ```typescript
      * const myPlugin = Plugin.create({
-     *   name: 'my-plugin',
-     *   version: '1.0.0',
-     *   onServerStart: () => console.log('Started!')
+     *   name: "my-plugin",
+     *   version: "1.0.0",
+     *   onServerStart: (server) => {
+     *     console.log("Plugin started!");
+     *   }
      * });
+     * ```
      */
-    static create(plugin: XyPrissPlugin): XyPrissPlugin;
+    create(plugin: XyPrissPlugin): XyPrissPlugin;
     /**
      * Create a plugin factory function
+     * Useful for creating reusable plugins with configuration
+     * @param creator - Function that creates a plugin from config
+     * @returns Plugin creator function
      *
      * @example
-     * const createAuthPlugin = Plugin.factory((config) => ({
-     *   name: 'auth',
-     *   version: '1.0.0',
-     *   onRequest: (req, res, next) => {
-     *     // Use config here
-     *     next();
+     * ```typescript
+     * const createMyPlugin = Plugin.factory((config: { apiKey: string }) => ({
+     *   name: "my-plugin",
+     *   version: "1.0.0",
+     *   onServerStart: (server) => {
+     *     server.apiKey = config.apiKey;
      *   }
      * }));
+     *
+     * // Use it
+     * const plugin = createMyPlugin({ apiKey: "secret" });
+     * Plugin.register(plugin);
+     * ```
      */
-    static factory(creator: PluginCreator): PluginCreator;
-}
+    factory<TConfig = any>(creator: (config: TConfig) => XyPrissPlugin): PluginCreator;
+};
 
 /**
  * XyPrissJS Express Quick Start
@@ -12670,5 +12673,5 @@ declare class TrustProxy {
  */
 declare function Router(): XyPrissRouter;
 
-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, PluginAPI as Plugin, PluginDevelopmentHelpers, PluginEngine, PluginEventType, PluginPriority, PluginRegistry, PluginSystemFactory, PluginSystemUtils, PluginType, ProxyPlugin, RateLimitPlugin, ResponseTimePlugin, Route, Router, SecurityMiddleware, SecurityPlugin as SecurityPluginBase, SmartCachePlugin, TrustProxy, Upload, XyPrissRouter, createCacheMiddleware, createCircularRefDebugger, createOptimalCache, createSafeJsonMiddleware, createServer, createServerInstance, expressStringify, fastStringify, initializeFileUpload, quickServer, safeJsonStringify, safeStringify, sendSafeJson, setupSafeJson, uploadAny, uploadArray, uploadFields, uploadSingle };
+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, Plugin, PluginDevelopmentHelpers, PluginEngine, PluginEventType, PluginPriority, PluginRegistry, PluginSystemFactory, PluginSystemUtils, PluginType, ProxyPlugin, RateLimitPlugin, ResponseTimePlugin, Route, Router, SecurityMiddleware, SecurityPlugin as SecurityPluginBase, SmartCachePlugin, TrustProxy, Upload, 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, PluginCreator, 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, XyPrissPlugin, XyPrisRequest as XyPrissRequest, XyPrisResponse as XyPrissResponse };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xypriss",
-    "version": "4.0.0",
+    "version": "4.1.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",
@@ -271,3 +271,4 @@
         "xypriss-security": "^1.1.10"
     }
 }
+

package/dist/cjs/src/plugins/core/PluginAPI.js

@@ -1,80 +0,0 @@
-'use strict';
-
-/**
- * Plugin API - Imperative plugin registration
- *
- * Usage:
- *   import { Plugin } from 'xypriss';
- *
- *   Plugin.register({
- *     name: 'my-plugin',
- *     version: '1.0.0',
- *     onServerStart: () => console.log('Started!')
- *   });
- */
-class PluginAPI {
-    /**
-     * Set the plugin manager (called internally by ServerFactory)
-     */
-    static setManager(manager) {
-        this.manager = manager;
-    }
-    /**
-     * Register a plugin imperatively
-     *
-     * @example
-     * Plugin.register({
-     *   name: 'my-plugin',
-     *   version: '1.0.0',
-     *   onServerStart: () => console.log('Started!')
-     * });
-     */
-    static register(plugin, config) {
-        if (!this.manager) {
-            throw new Error("Plugin system not initialized. Create a server first.");
-        }
-        this.manager.register(plugin, config);
-    }
-    /**
-     * Get a registered plugin by name
-     */
-    static get(name) {
-        if (!this.manager) {
-            throw new Error("Plugin system not initialized. Create a server first.");
-        }
-        return this.manager.getPlugin(name);
-    }
-    /**
-     * Create a plugin (helper for creating plugin objects)
-     *
-     * @example
-     * const myPlugin = Plugin.create({
-     *   name: 'my-plugin',
-     *   version: '1.0.0',
-     *   onServerStart: () => console.log('Started!')
-     * });
-     */
-    static create(plugin) {
-        return plugin;
-    }
-    /**
-     * Create a plugin factory function
-     *
-     * @example
-     * const createAuthPlugin = Plugin.factory((config) => ({
-     *   name: 'auth',
-     *   version: '1.0.0',
-     *   onRequest: (req, res, next) => {
-     *     // Use config here
-     *     next();
-     *   }
-     * }));
-     */
-    static factory(creator) {
-        return creator;
-    }
-}
-PluginAPI.manager = null;
-
-exports.Plugin = PluginAPI;
-//# sourceMappingURL=PluginAPI.js.map

package/dist/cjs/src/plugins/core/PluginAPI.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PluginAPI.js","sources":["../../../../../src/plugins/core/PluginAPI.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;;AAWG;AAKH,MAAM,SAAS,CAAA;AAGX;;AAEG;IACH,OAAO,UAAU,CAAC,OAAsB,EAAA;AACpC,QAAA,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;KAC1B;AAED;;;;;;;;;AASG;AACH,IAAA,OAAO,QAAQ,CAAC,MAAqC,EAAE,MAAY,EAAA;AAC/D,QAAA,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;AACf,YAAA,MAAM,IAAI,KAAK,CACX,uDAAuD,CAC1D,CAAC;SACL;QACD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACzC;AAED;;AAEG;IACH,OAAO,GAAG,CAAC,IAAY,EAAA;AACnB,QAAA,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;AACf,YAAA,MAAM,IAAI,KAAK,CACX,uDAAuD,CAC1D,CAAC;SACL;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;KACvC;AAED;;;;;;;;;AASG;IACH,OAAO,MAAM,CAAC,MAAqB,EAAA;AAC/B,QAAA,OAAO,MAAM,CAAC;KACjB;AAED;;;;;;;;;;;;AAYG;IACH,OAAO,OAAO,CAAC,OAAsB,EAAA;AACjC,QAAA,OAAO,OAAO,CAAC;KAClB;;AArEc,SAAO,CAAA,OAAA,GAAyB,IAAI;;;;"}