xypriss 3.3.1 → 4.0.1

package/dist/index.d.ts

@@ -30,6 +30,32 @@ interface ComponentLogConfig {
     suppressPatterns?: (string | RegExp)[];
 }
 
+/**
+ * Plugin System Types
+ */
+
+interface XyPrissServer$1 {
+    app: UltraFastApp;
+    [key: string]: any;
+}
+interface XyPrissPlugin {
+    name: string;
+    version: string;
+    description?: string;
+    dependencies?: string[];
+    onRegister?(server: XyPrissServer$1, config?: any): void | Promise<void>;
+    onServerStart?(server: XyPrissServer$1): void | Promise<void>;
+    onServerReady?(server: XyPrissServer$1): void | Promise<void>;
+    onServerStop?(server: XyPrissServer$1): void | Promise<void>;
+    onRequest?(req: XyPrisRequest, res: XyPrisResponse, next: NextFunction): void | Promise<void>;
+    onResponse?(req: XyPrisRequest, res: XyPrisResponse): void | Promise<void>;
+    onError?(error: Error, req: XyPrisRequest, res: XyPrisResponse, next?: NextFunction): void | Promise<void>;
+    registerRoutes?(app: UltraFastApp): void;
+    middleware?: any | any[];
+    middlewarePriority?: "first" | "normal" | "last";
+}
+type PluginCreator = (config?: any) => XyPrissPlugin;
+
 /**
  * XyPriss Request interface (Express-compatible)
  */
@@ -4433,7 +4459,7 @@ declare class ServerMaintenancePlugin extends EventEmitter {
  * Manages all server plugins including route optimization and maintenance
  */
 
-declare class PluginManager extends EventEmitter {
+declare class PluginManager$1 extends EventEmitter {
     private config;
     private routeOptimizationPlugin?;
     private serverMaintenancePlugin?;
@@ -4928,7 +4954,7 @@ declare class XyPrissServer {
     /**
      * Get the server plugin manager
      */
-    getServerPluginManager(): PluginManager | undefined;
+    getServerPluginManager(): PluginManager$1 | undefined;
     /**
      * Wait for full initialization (cache, console interceptor, and all components)
      */
@@ -5583,26 +5609,6 @@ interface XyPrissMiddlewareAPI {
     getConfig(): any;
 }
 
-/**
- * XyPrissJS Express Types - Main Export File
- *
- * This file serves as the main entry point for all Express integration types.
- * Types are now organized into MOD files for better maintainability.
- *
- * @fileoverview Main type export file for Express integration
- * @version 4.5.11
- * @author XyPrissJS Team
- * @since 2025-01-06
- *
- * @example
- * ```typescript
- * import { ServerOptions, UltraFastApp } from './types';
- * // or import specific modules
- * import { CacheConfig } from './types/cache';
- * import { SecurityConfig } from './types/security';
- * ```
- */
-
 type RequestHandler = (req: XyPrisRequest, res: XyPrisResponse, next?: NextFunction) => void | Promise<void>;
 
 /**
@@ -6246,12 +6252,8 @@ interface ServerOptions {
             /** Callback when maintenance is complete */
             onMaintenanceComplete?: (actions: string[]) => void;
         };
-        /** Custom plugins */
-        customPlugins?: Array<{
-            name: string;
-            plugin: any;
-            config?: any;
-        }>;
+        /** Register custom plugins (new plugin system) */
+        register?: Array<XyPrissPlugin | PluginCreator>;
     };
     logging?: {
         enabled?: boolean;
@@ -11589,7 +11591,7 @@ interface CompressionConfig {
     excludeContentTypes?: string[];
     streaming?: boolean;
 }
-type CompressionAlgorithm = "gzip" | "brotli" | "deflate";
+type CompressionAlgorithm = "gzip" | "br" | "deflate";
 /**
  * Rate limiting configuration
  */
@@ -11797,9 +11799,9 @@ declare abstract class NetworkPlugin implements NetworkPlugin$1 {
  * Connection management plugin for optimizing HTTP connections
  */
 declare class ConnectionPlugin extends NetworkPlugin {
-    readonly id = "xypriss.network.connection";
+    readonly id = "xypriss::nehonix.network.connection";
     readonly name = "Connection Management Plugin";
-    readonly version = "1.0.0";
+    readonly version = "1.0.1";
     readonly networkCategory = NetworkCategory.CONNECTION;
     private connectionPool;
     private activeConnections;
@@ -12060,9 +12062,9 @@ declare class CompressionPlugin extends NetworkPlugin {
  * Reverse proxy plugin with load balancing and health checks
  */
 declare class ProxyPlugin extends NetworkPlugin {
-    readonly id = "nehonix.xypriss.network.proxy";
+    readonly id = "xypriss::nehonix.network.proxy";
     readonly name = "Reverse Proxy Plugin";
-    readonly version = "1.0.0";
+    readonly version = "1.0.1";
     readonly networkCategory = NetworkCategory.PROXY;
     private upstreamServers;
     private proxyMiddleware;
@@ -12430,6 +12432,117 @@ declare class PluginDevelopmentHelpers {
     };
 }
 
+/**
+ * Plugin Manager
+ * Manages plugin registration, lifecycle, and execution
+ */
+
+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!')
+ *   });
+ */
+
+declare class PluginAPI {
+    private static manager;
+    /**
+     * Set the plugin manager (called internally by ServerFactory)
+     */
+    static setManager(manager: PluginManager): void;
+    /**
+     * Register a plugin imperatively
+     *
+     * @example
+     * Plugin.register({
+     *   name: 'my-plugin',
+     *   version: '1.0.0',
+     *   onServerStart: () => console.log('Started!')
+     * });
+     */
+    static register(plugin: XyPrissPlugin | PluginCreator, config?: any): void;
+    /**
+     * Get a registered plugin by name
+     */
+    static get(name: string): XyPrissPlugin | undefined;
+    /**
+     * 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: XyPrissPlugin): XyPrissPlugin;
+    /**
+     * 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: PluginCreator): PluginCreator;
+}
+
 /**
  * XyPrissJS Express Quick Start
  * Pre-configured server instances for rapid development (tests with limited configs)
@@ -12557,5 +12670,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, 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, 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, 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 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": "3.3.1",
+    "version": "4.0.1",
     "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",
@@ -267,8 +267,7 @@
         "tweetnacl": "^1.0.3",
         "ws": "^8.18.2",
         "xss": "^1.0.15",
-        "xypriss": "^3.2.2",
+        "xypriss-compression-pluging": "^1.0.3",
         "xypriss-security": "^1.1.10"
     }
 }
-