xypriss 9.11.13 → 9.12.0

package/dist/src/plugins/core/XPluginManager.d.ts

@@ -0,0 +1,110 @@
+/***************************************************************************
+ * XyPrissJS - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ *
+ * This License governs the use, modification, and distribution of software
+ * provided by NEHONIX under its open source projects.
+ * NEHONIX is committed to fostering collaborative innovation while strictly
+ * protecting its intellectual property rights.
+ * Violation of any term of this License will result in immediate termination of all granted rights
+ * and may subject the violator to legal action.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
+ * AND NON-INFRINGEMENT.
+ * IN NO EVENT SHALL NEHONIX BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+ * OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OR INABILITY TO USE THE SOFTWARE,
+ * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+ *
+ ***************************************************************************** */
+import type { XyPrissApp } from "../../types/types";
+import type { XyPrissPlugin, XyPrissServer, PluginCreator } from "../types/PluginTypes";
+export declare class XyPluginManager {
+    private server;
+    private logger;
+    private initialized;
+    private permissionManager;
+    private registry;
+    private security;
+    private hooks;
+    private interceptor;
+    private management;
+    private loader;
+    constructor(server: XyPrissServer);
+    /**
+     * Register a plugin
+     */
+    register(plugin: XyPrissPlugin | PluginCreator, config?: any): Promise<void>;
+    /**
+     * Alias for register (Legacy compatibility)
+     */
+    registerPlugin(plugin: XyPrissPlugin | PluginCreator, config?: any): Promise<void>;
+    /**
+     * Unregister a plugin (Legacy compatibility)
+     */
+    unregisterPlugin(pluginId: string): Promise<void>;
+    /**
+     * Initialize all registered plugins
+     */
+    initialize(): Promise<void>;
+    /**
+     * Toggle plugin activation state
+     */
+    togglePlugin(pluginName: string, enabled: boolean, requestedBy?: string): void;
+    /**
+     * Execute a lifecycle hook on all plugins
+     */
+    executeHook(hookName: keyof XyPrissPlugin, ...args: any[]): Promise<void>;
+    /**
+     * Trigger various event hooks
+     */
+    triggerSecurityAttack(attackData: any, req: any, res: any): void;
+    triggerResponseTime(responseTime: number, req: any, res: any): void;
+    triggerRouteError(error: Error, req: any, res: any): void;
+    triggerRateLimit(limitData: any, req: any, res: any): void;
+    /**
+     * Apply plugin components to the server application
+     */
+    registerRoutes(app: XyPrissApp): void;
+    applyMiddleware(app: XyPrissApp): void;
+    applyErrorHandlers(app: XyPrissApp): void;
+    getPlugin(name: string): XyPrissPlugin | undefined;
+    /**
+     * Get all registered plugins (Legacy compatibility)
+     */
+    getAllPlugins(): XyPrissPlugin[];
+    /**
+     * Get plugins by type (Legacy compatibility)
+     */
+    getPluginsByType(type: any): XyPrissPlugin[];
+    /**
+     * Get plugin statistics (Legacy compatibility)
+     */
+    getPluginStats(pluginId?: string): any;
+    /**
+     * Get registry statistics (Legacy compatibility)
+     */
+    getPluginRegistryStats(): any;
+    /**
+     * Get engine statistics (Legacy compatibility)
+     */
+    getPluginEngineStats(): any;
+    setPluginPermission(pluginName: string, hookId: string, allowed: boolean, by?: string): void;
+    /**
+     * Get a legacy-compatible plugin engine bridge
+     */
+    getPluginEngine(): any;
+    /**
+     * Initialize built-in core plugins
+     */
+    initializeBuiltinPlugins(): Promise<void>;
+    /**
+     * Shut down all plugins
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=XPluginManager.d.ts.map

package/dist/src/plugins/core/XPluginManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XPluginManager.d.ts","sourceRoot":"","sources":["../../../../src/plugins/core/XPluginManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;iFAsBiF;AAQjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACR,aAAa,EACb,aAAa,EACb,aAAa,EAChB,MAAM,sBAAsB,CAAC;AAU9B,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,iBAAiB,CAAoB;IAG7C,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,aAAa;IAuCjC;;OAEG;IACG,QAAQ,CACV,MAAM,EAAE,aAAa,GAAG,aAAa,EACrC,MAAM,CAAC,EAAE,GAAG,GACb,OAAO,CAAC,IAAI,CAAC;IAIhB;;OAEG;IACG,cAAc,CAChB,MAAM,EAAE,aAAa,GAAG,aAAa,EACrC,MAAM,CAAC,EAAE,GAAG,GACb,OAAO,CAAC,IAAI,CAAC;IAIhB;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACI,YAAY,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,MAAM,GACrB,IAAI;IAIP;;OAEG;IACG,WAAW,CACb,QAAQ,EAAE,MAAM,aAAa,EAC7B,GAAG,IAAI,EAAE,GAAG,EAAE,GACf,OAAO,CAAC,IAAI,CAAC;IAIhB;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAIhE,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAInE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAIzD,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAI1D;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAIrC,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAItC,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAIzC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIlD;;OAEG;IACI,aAAa,IAAI,aAAa,EAAE;IAIvC;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,aAAa,EAAE;IAInD;;OAEG;IACH,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,GAAG;IAQtC;;OAEG;IACI,sBAAsB,IAAI,GAAG;IASpC;;OAEG;IACI,oBAAoB,IAAI,GAAG;IAIlC,mBAAmB,CACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,EAAE,GAAE,MAAiB,GACtB,IAAI;IAIP;;OAEG;IACI,eAAe,IAAI,GAAG;IA6C7B;;OAEG;IACU,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBtD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/src/plugins/core/XPluginManager.js

@@ -0,0 +1,213 @@
+/***************************************************************************
+ * XyPrissJS - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ *
+ * This License governs the use, modification, and distribution of software
+ * provided by NEHONIX under its open source projects.
+ * NEHONIX is committed to fostering collaborative innovation while strictly
+ * protecting its intellectual property rights.
+ * Violation of any term of this License will result in immediate termination of all granted rights
+ * and may subject the violator to legal action.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
+ * AND NON-INFRINGEMENT.
+ * IN NO EVENT SHALL NEHONIX BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+ * OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OR INABILITY TO USE THE SOFTWARE,
+ * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+ *
+ ***************************************************************************** */
+/**
+ * Plugin Manager
+ * Orchestrates plugin registration, lifecycle, and security via specialized modules
+ */
+import { Logger } from "../../shared/logger";
+import { PermissionManager } from "./PermissionManager";
+import { PluginRegistry } from "./manager/PluginRegistry";
+import { PluginSecurity } from "./manager/PluginSecurity";
+import { PluginHookRunner } from "./manager/PluginHookRunner";
+import { PluginInterceptor } from "./manager/PluginInterceptor";
+import { PluginManagement } from "./manager/PluginManagement";
+import { PluginLoader } from "./manager/PluginLoader";
+import { XemsBuiltinPlugin } from "../builtin/xems/XemsBuiltinPlugin";
+export class XyPluginManager {
+    constructor(server) {
+        this.initialized = { value: false };
+        this.server = server;
+        this.logger = server.getLogger?.() || new Logger();
+        this.permissionManager = new PermissionManager(server, this.logger);
+        // Initialize sub-modules
+        this.registry = new PluginRegistry(this.logger);
+        this.security = new PluginSecurity();
+        this.hooks = new PluginHookRunner(this.registry, this.permissionManager, this.security, this.server, this.logger);
+        this.interceptor = new PluginInterceptor(this.registry, this.permissionManager, this.logger);
+        this.management = new PluginManagement(this.registry, this.permissionManager, this.server, this.logger);
+        this.loader = new PluginLoader(this.registry, this.security, this.hooks, this.interceptor, this.management, this.server, this.logger, this.initialized, this.permissionManager);
+    }
+    /**
+     * Register a plugin
+     */
+    async register(plugin, config) {
+        return this.loader.register(plugin, config);
+    }
+    /**
+     * Alias for register (Legacy compatibility)
+     */
+    async registerPlugin(plugin, config) {
+        return this.register(plugin, config);
+    }
+    /**
+     * Unregister a plugin (Legacy compatibility)
+     */
+    async unregisterPlugin(pluginId) {
+        return this.loader.unregister(pluginId);
+    }
+    /**
+     * Initialize all registered plugins
+     */
+    async initialize() {
+        return this.loader.initialize();
+    }
+    /**
+     * Toggle plugin activation state
+     */
+    togglePlugin(pluginName, enabled, requestedBy) {
+        this.management.togglePlugin(pluginName, enabled, requestedBy);
+    }
+    /**
+     * Execute a lifecycle hook on all plugins
+     */
+    async executeHook(hookName, ...args) {
+        await this.hooks.executeHook(hookName, ...args);
+    }
+    /**
+     * Trigger various event hooks
+     */
+    triggerSecurityAttack(attackData, req, res) {
+        this.hooks.triggerSecurityAttack(attackData, req, res);
+    }
+    triggerResponseTime(responseTime, req, res) {
+        this.hooks.triggerResponseTime(responseTime, req, res);
+    }
+    triggerRouteError(error, req, res) {
+        this.hooks.triggerRouteError(error, req, res);
+    }
+    triggerRateLimit(limitData, req, res) {
+        this.hooks.triggerRateLimit(limitData, req, res);
+    }
+    /**
+     * Apply plugin components to the server application
+     */
+    registerRoutes(app) {
+        this.interceptor.registerRoutes(app);
+    }
+    applyMiddleware(app) {
+        this.interceptor.applyMiddleware(app);
+    }
+    applyErrorHandlers(app) {
+        this.interceptor.applyErrorHandlers(app);
+    }
+    getPlugin(name) {
+        return this.registry.get(name);
+    }
+    /**
+     * Get all registered plugins (Legacy compatibility)
+     */
+    getAllPlugins() {
+        return this.registry.getAll();
+    }
+    /**
+     * Get plugins by type (Legacy compatibility)
+     */
+    getPluginsByType(type) {
+        return this.registry.getByType(type);
+    }
+    /**
+     * Get plugin statistics (Legacy compatibility)
+     */
+    getPluginStats(pluginId) {
+        if (pluginId) {
+            const stats = this.management.getPluginStats();
+            return stats.find((s) => s.name === pluginId) || {};
+        }
+        return this.management.getPluginStats();
+    }
+    /**
+     * Get registry statistics (Legacy compatibility)
+     */
+    getPluginRegistryStats() {
+        const all = this.registry.getAll();
+        return {
+            totalPlugins: all.length,
+            activePlugins: all.length,
+            averageExecutionTime: 0,
+        };
+    }
+    /**
+     * Get engine statistics (Legacy compatibility)
+     */
+    getPluginEngineStats() {
+        return this.getPluginEngine().getEngineStats();
+    }
+    setPluginPermission(pluginName, hookId, allowed, by = "system") {
+        this.management.setPluginPermission(pluginName, hookId, allowed, by);
+    }
+    /**
+     * Get a legacy-compatible plugin engine bridge
+     */
+    getPluginEngine() {
+        return {
+            executePlugins: async (type, req, res, next) => {
+                // Bridge to new interceptor hooks
+                // Filter plugins by type and execute their onRequest or onResponse hooks
+                const plugins = this.registry.getByType(type);
+                for (const plugin of plugins) {
+                    if (!this.permissionManager.checkPermission(plugin.name, "onRequest")) {
+                        continue;
+                    }
+                    try {
+                        if (plugin.onRequest) {
+                            await plugin.onRequest(req, res, next);
+                        }
+                    }
+                    catch (error) {
+                        this.logger.error("plugins", `Error executing plugin ${plugin.name} during ${type} phase:`, error);
+                    }
+                }
+                return true;
+            },
+            triggerConsoleLogHook: (log) => {
+                this.hooks.executeHook("onConsoleIntercept", log);
+            },
+            getEngineStats: () => ({
+                activeExecutions: 0,
+                successRate: 100,
+            }),
+        };
+    }
+    /**
+     * Initialize built-in core plugins
+     */
+    async initializeBuiltinPlugins() {
+        this.logger.debug("plugins", "Initializing built-in plugins...");
+        try {
+            // 1. XEMS Core Plugin (Security & Sessions)
+            await this.register(new XemsBuiltinPlugin());
+            this.logger.debug("plugins", "Built-in plugins registered");
+        }
+        catch (error) {
+            this.logger.error("plugins", "Failed to initialize built-in plugins:", error);
+        }
+    }
+    /**
+     * Shut down all plugins
+     */
+    async shutdown() {
+        await this.hooks.executeHook("onServerStop");
+    }
+}
+//# sourceMappingURL=XPluginManager.js.map

package/dist/src/plugins/core/XPluginManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"XPluginManager.js","sourceRoot":"","sources":["../../../../src/plugins/core/XPluginManager.ts"],"names":[],"mappings":"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"}

package/dist/src/plugins/core/manager/PluginHookRunner.d.ts

@@ -0,0 +1,50 @@
+/***************************************************************************
+ * XyPrissJS - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ ***************************************************************************** */
+import { Logger } from "../../../shared/logger";
+import type { PermissionManager } from "../PermissionManager";
+import type { PluginRegistry } from "./PluginRegistry";
+import type { PluginSecurity } from "./PluginSecurity";
+import type { XyPrissPlugin } from "../../types/PluginTypes";
+/**
+ * Plugin Hook Runner
+ * Handles the execution of lifecycle hooks and event triggers
+ */
+export declare class PluginHookRunner {
+    private registry;
+    private permissionManager;
+    private security;
+    private server;
+    private logger;
+    constructor(registry: PluginRegistry, permissionManager: PermissionManager, security: PluginSecurity, server: any, logger: Logger);
+    /**
+     * Execute a lifecycle hook on all plugins in order
+     */
+    executeHook(hookName: keyof XyPrissPlugin, ...args: any[]): Promise<void>;
+    /**
+     * Trigger a security attack hook on all plugins
+     */
+    triggerSecurityAttack(attackData: any, req: any, res: any): void;
+    /**
+     * Trigger a response time hook on all plugins
+     */
+    triggerResponseTime(responseTime: number, req: any, res: any): void;
+    /**
+     * Trigger a route error hook on all plugins
+     */
+    triggerRouteError(error: Error, req: any, res: any): void;
+    /**
+     * Trigger a rate limit hook on all plugins
+     */
+    triggerRateLimit(limitData: any, req: any, res: any): void;
+    /**
+     * Internal helper to execute event hooks with masked requests
+     */
+    private executeEventHook;
+}
+//# sourceMappingURL=PluginHookRunner.d.ts.map

package/dist/src/plugins/core/manager/PluginHookRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHookRunner.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/core/manager/PluginHookRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;iFAOiF;AAEjF,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;GAGG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,MAAM,CAAS;gBAGnB,QAAQ,EAAE,cAAc,EACxB,iBAAiB,EAAE,iBAAiB,EACpC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,MAAM;IASlB;;OAEG;IACU,WAAW,CACpB,QAAQ,EAAE,MAAM,aAAa,EAC7B,GAAG,IAAI,EAAE,GAAG,EAAE,GACf,OAAO,CAAC,IAAI,CAAC;IA8EhB;;OAEG;IACI,qBAAqB,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAIvE;;OAEG;IACI,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAI1E;;OAEG;IACI,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAIhE;;OAEG;IACI,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAIjE;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAQ3B"}

package/dist/src/plugins/core/manager/PluginHookRunner.js

@@ -0,0 +1,104 @@
+/***************************************************************************
+ * XyPrissJS - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ ***************************************************************************** */
+/**
+ * Plugin Hook Runner
+ * Handles the execution of lifecycle hooks and event triggers
+ */
+export class PluginHookRunner {
+    constructor(registry, permissionManager, security, server, logger) {
+        this.registry = registry;
+        this.permissionManager = permissionManager;
+        this.security = security;
+        this.server = server;
+        this.logger = logger;
+    }
+    /**
+     * Execute a lifecycle hook on all plugins in order
+     */
+    async executeHook(hookName, ...args) {
+        const order = this.registry.getOrder();
+        for (const uid of order) {
+            const plugin = this.registry.get(uid);
+            if (plugin && typeof plugin[hookName] === "function") {
+                const pluginName = plugin.name;
+                const restrictedServer = this.security.createRestrictedServer(this.server, pluginName, this.permissionManager);
+                try {
+                    // Check permission (logs error if denied)
+                    if (this.permissionManager.checkPermission(pluginName, hookName)) {
+                        // LAZY SECURITY DISCOVERY: If root is missing, find it now pendant l'exécution
+                        if (!plugin.__root__) {
+                            const stack = new Error().stack || "";
+                            this.security.verifyContract(plugin, stack, true);
+                        }
+                        // For server lifecycle hooks, pass the server instance
+                        if ([
+                            "onServerStart",
+                            "onServerReady",
+                            "onServerStop",
+                        ].includes(hookName)) {
+                            await plugin[hookName](restrictedServer, ...args);
+                        }
+                        else {
+                            // Mask HTTP requests passed as arguments for the current plugin
+                            const maskedArgs = args.map((arg) => {
+                                // Simple heuristic for XyPrissRequest: has headers and socket/url
+                                if (arg &&
+                                    typeof arg === "object" &&
+                                    arg.headers &&
+                                    (arg.socket || arg.url)) {
+                                    return this.permissionManager.maskRequest(arg, pluginName);
+                                }
+                                return arg;
+                            });
+                            await plugin[hookName](...maskedArgs);
+                        }
+                    }
+                }
+                catch (error) {
+                    this.logger.error("plugins", `Error in ${pluginName}.${hookName}:`, error);
+                    // If it's a critical lifecycle hook, rethrow to stop server startup
+                    if (hookName === "onServerStart") {
+                        throw error;
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Trigger a security attack hook on all plugins
+     */
+    triggerSecurityAttack(attackData, req, res) {
+        this.executeEventHook("onSecurityAttack", attackData, req, res);
+    }
+    /**
+     * Trigger a response time hook on all plugins
+     */
+    triggerResponseTime(responseTime, req, res) {
+        this.executeEventHook("onResponseTime", responseTime, req, res);
+    }
+    /**
+     * Trigger a route error hook on all plugins
+     */
+    triggerRouteError(error, req, res) {
+        this.executeEventHook("onRouteError", error, req, res);
+    }
+    /**
+     * Trigger a rate limit hook on all plugins
+     */
+    triggerRateLimit(limitData, req, res) {
+        this.executeEventHook("onRateLimit", limitData, req, res);
+    }
+    /**
+     * Internal helper to execute event hooks with masked requests
+     */
+    executeEventHook(hookName, data, req, res) {
+        this.executeHook(hookName, data, req, res).catch(() => { });
+    }
+}
+//# sourceMappingURL=PluginHookRunner.js.map

package/dist/src/plugins/core/manager/PluginHookRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHookRunner.js","sourceRoot":"","sources":["../../../../../src/plugins/core/manager/PluginHookRunner.ts"],"names":[],"mappings":"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"}

package/dist/src/plugins/core/manager/PluginInterceptor.d.ts

@@ -0,0 +1,48 @@
+/***************************************************************************
+ * XyPrissJS - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ ***************************************************************************** */
+import { Logger } from "../../../shared/logger";
+import type { PermissionManager } from "../PermissionManager";
+import type { PluginRegistry } from "./PluginRegistry";
+import type { XyPrissPlugin } from "../../types/PluginTypes";
+import { XyPrissApp } from "../../..";
+/**
+ * Plugin Interceptor
+ * Handles middleware application, route registration, and error handling
+ */
+export declare class PluginInterceptor {
+    private registry;
+    private permissionManager;
+    private logger;
+    constructor(registry: PluginRegistry, permissionManager: PermissionManager, logger: Logger);
+    /**
+     * Register routes from all plugins
+     */
+    registerRoutes(app: XyPrissApp): void;
+    /**
+     * Register routes for a specific plugin
+     */
+    registerPluginRoutes(plugin: XyPrissPlugin, app: XyPrissApp, isLate?: boolean): void;
+    /**
+     * Apply middleware from all plugins
+     */
+    applyMiddleware(app: XyPrissApp): void;
+    /**
+     * Apply middleware for a specific plugin (used for late registration)
+     */
+    applyPluginMiddleware(plugin: XyPrissPlugin, app: XyPrissApp): void;
+    /**
+     * Collect middleware from a plugin into the priorities object
+     */
+    private collectPluginMiddleware;
+    /**
+     * Apply error handlers from all plugins
+     */
+    applyErrorHandlers(app: XyPrissApp): void;
+}
+//# sourceMappingURL=PluginInterceptor.d.ts.map

package/dist/src/plugins/core/manager/PluginInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginInterceptor.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/core/manager/PluginInterceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;iFAOiF;AAEjF,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;;GAGG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAS;gBAGnB,QAAQ,EAAE,cAAc,EACxB,iBAAiB,EAAE,iBAAiB,EACpC,MAAM,EAAE,MAAM;IAOlB;;OAEG;IACI,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAU5C;;OAEG;IACI,oBAAoB,CACvB,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,UAAU,EACf,MAAM,GAAE,OAAe,GACxB,IAAI;IAyBP;;OAEG;IACI,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAoB7C;;OAEG;IACI,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI;IAmB1E;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAkJ/B;;OAEG;IACI,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;CAqDnD"}