xypriss 9.11.13 → 9.12.0

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

@@ -0,0 +1,196 @@
+/***************************************************************************
+ * XyPrissJS - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ ***************************************************************************** */
+/**
+ * Plugin Interceptor
+ * Handles middleware application, route registration, and error handling
+ */
+export class PluginInterceptor {
+    constructor(registry, permissionManager, logger) {
+        this.registry = registry;
+        this.permissionManager = permissionManager;
+        this.logger = logger;
+    }
+    /**
+     * Register routes from all plugins
+     */
+    registerRoutes(app) {
+        const order = this.registry.getOrder();
+        for (const uid of order) {
+            const plugin = this.registry.get(uid);
+            if (plugin) {
+                this.registerPluginRoutes(plugin, app);
+            }
+        }
+    }
+    /**
+     * Register routes for a specific plugin
+     */
+    registerPluginRoutes(plugin, app, isLate = false) {
+        if (plugin.registerRoutes) {
+            try {
+                if (this.permissionManager.checkPermission(plugin.name, "registerRoutes")) {
+                    plugin.registerRoutes(app);
+                    this.logger.debug("plugins", `Registered routes for ${isLate ? "late " : ""}plugin: ${plugin.name}`);
+                }
+            }
+            catch (error) {
+                this.logger.error("plugins", `Error registering routes for ${plugin.name}:`, error);
+            }
+        }
+    }
+    /**
+     * Apply middleware from all plugins
+     */
+    applyMiddleware(app) {
+        const order = this.registry.getOrder();
+        // console.log(
+        //     `[PluginInterceptor] applyMiddleware called with ${order.length} plugins: ${order.join(", ")}`,
+        // );
+        const priorities = { first: [], normal: [], last: [] };
+        for (const uid of order) {
+            const plugin = this.registry.get(uid);
+            if (plugin) {
+                this.collectPluginMiddleware(plugin, priorities);
+            }
+        }
+        // Apply in order: first, normal, last
+        [...priorities.first, ...priorities.normal, ...priorities.last].forEach((mw) => app.use(mw));
+    }
+    /**
+     * Apply middleware for a specific plugin (used for late registration)
+     */
+    applyPluginMiddleware(plugin, app) {
+        const priorities = { first: [], normal: [], last: [] };
+        this.collectPluginMiddleware(plugin, priorities);
+        const middleware = [
+            ...priorities.first,
+            ...priorities.normal,
+            ...priorities.last,
+        ];
+        middleware.forEach((mw) => app.use(mw));
+        if (middleware.length > 0) {
+            this.logger.debug("plugins", `Applied middleware for late plugin: ${plugin.name}`);
+        }
+    }
+    /**
+     * Collect middleware from a plugin into the priorities object
+     */
+    collectPluginMiddleware(plugin, priorities) {
+        // Standard middleware
+        if (plugin.middleware) {
+            try {
+                if (this.permissionManager.checkPermission(plugin.name, "middleware")) {
+                    const priority = plugin.middlewarePriority || "normal";
+                    const middleware = Array.isArray(plugin.middleware)
+                        ? plugin.middleware
+                        : [plugin.middleware];
+                    priorities[priority].push(...middleware);
+                }
+            }
+            catch (error) {
+                this.logger.error("plugins", `Error applying middleware for ${plugin.name}:`, error);
+            }
+        }
+        // onRequest hook
+        if (plugin.onRequest) {
+            try {
+                if (this.permissionManager.checkPermission(plugin.name, "onRequest")) {
+                    priorities.normal.push(async (req, res, next) => {
+                        if (this.permissionManager.isPluginDisabled(plugin.name, "onRequest")) {
+                            return next();
+                        }
+                        let nextCalled = false;
+                        const wrappedNext = (err) => {
+                            nextCalled = true;
+                            next(err);
+                        };
+                        try {
+                            const wasEndedBefore = res.writableEnded;
+                            await plugin.onRequest(this.permissionManager.maskRequest(req, plugin.name), res, wrappedNext);
+                            if (!wasEndedBefore &&
+                                res.writableEnded &&
+                                nextCalled) {
+                                this.logger.error("plugins", `Logic Error in ${plugin.name}.onRequest: Plugin sent a response but also called next(). ` +
+                                    `This is invalid and will cause subsequent route handlers to be skipped.`);
+                            }
+                        }
+                        catch (error) {
+                            this.logger.error("plugins", `Error in ${plugin.name}.onRequest:`, error);
+                            if (!res.writableEnded) {
+                                next(error);
+                            }
+                        }
+                    });
+                }
+            }
+            catch (error) {
+                this.logger.error("plugins", `Error applying onRequest for ${plugin.name}:`, error);
+            }
+        }
+        // onResponse hook
+        if (plugin.onResponse) {
+            try {
+                if (this.permissionManager.checkPermission(plugin.name, "onResponse")) {
+                    priorities.normal.push((req, res, next) => {
+                        const originalEnd = res.end;
+                        res.end = (async (...args) => {
+                            if (!this.permissionManager?.isPluginDisabled(plugin.name, "onResponse")) {
+                                try {
+                                    await plugin.onResponse(this.permissionManager.maskRequest(req, plugin.name), res);
+                                }
+                                catch (error) {
+                                    this.logger.error("plugins", `Error in ${plugin.name}.onResponse:`, error);
+                                }
+                            }
+                            return originalEnd.apply(res, args);
+                        });
+                        next();
+                    });
+                }
+            }
+            catch (error) {
+                this.logger.error("plugins", `Error applying onResponse for ${plugin.name}:`, error);
+            }
+        }
+    }
+    /**
+     * Apply error handlers from all plugins
+     */
+    applyErrorHandlers(app) {
+        const errorPlugins = this.registry
+            .getAll()
+            .filter((p) => typeof p.onError === "function");
+        if (errorPlugins.length === 0)
+            return;
+        // Add a global error handler to the app
+        app.use(async (err, req, res, next) => {
+            for (const plugin of errorPlugins) {
+                if (this.permissionManager.checkPermission(plugin.name, "onError")) {
+                    if (this.permissionManager.isPluginDisabled(plugin.name, "onError")) {
+                        continue;
+                    }
+                    try {
+                        await plugin.onError(err, this.permissionManager.maskRequest(req, plugin.name), res, next);
+                        // If the plugin sent a response, stop calling other handlers
+                        if (res.writableEnded)
+                            return;
+                    }
+                    catch (error) {
+                        this.logger.error("plugins", `Error in ${plugin.name}.onError:`, error);
+                    }
+                }
+            }
+            // If no plugin handled the error, call the next error handler
+            if (!res.writableEnded) {
+                next(err);
+            }
+        });
+    }
+}
+//# sourceMappingURL=PluginInterceptor.js.map

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

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

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

@@ -0,0 +1,59 @@
+/***************************************************************************
+ * 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 { PluginHookRunner } from "./PluginHookRunner";
+import type { PluginInterceptor } from "./PluginInterceptor";
+import type { PluginManagement } from "./PluginManagement";
+import type { XyPrissPlugin, PluginCreator, XyPrissServer } from "../../types/PluginTypes";
+/**
+ * Plugin Loader
+ * Handles the heavy lifting of plugin registration and system initialization
+ */
+export declare class PluginLoader {
+    private registry;
+    private security;
+    private hooks;
+    private interceptor;
+    private management;
+    private server;
+    private logger;
+    private initializedRef;
+    private permissionManager;
+    constructor(registry: PluginRegistry, security: PluginSecurity, hooks: PluginHookRunner, interceptor: PluginInterceptor, management: PluginManagement, server: XyPrissServer, logger: Logger, initializedRef: {
+        value: boolean;
+    }, permissionManager: PermissionManager);
+    /**
+     * Register a plugin
+     */
+    register(plugin: XyPrissPlugin | PluginCreator, config?: any): Promise<void>;
+    /**
+     * Unregister a plugin
+     */
+    unregister(name: string): Promise<void>;
+    /**
+     * Initialize all plugins (resolve dependencies and set execution order)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Handle initialization for a late-registered plugin
+     */
+    private initializeLatePlugin;
+    /**
+     * Generate a fingerprint based on basic metadata
+     */
+    private generateFingerprint;
+    /**
+     * Generate a technical UID
+     */
+    private generateUid;
+}
+//# sourceMappingURL=PluginLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginLoader.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/core/manager/PluginLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;iFAOiF;AAEjF,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD,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,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EACR,aAAa,EACb,aAAa,EACb,aAAa,EAChB,MAAM,yBAAyB,CAAC;AAIjC;;;GAGG;AACH,qBAAa,YAAY;IACrB,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,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,iBAAiB,CAAoB;gBAGzC,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,iBAAiB,EAC9B,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,EAClC,iBAAiB,EAAE,iBAAiB;IAaxC;;OAEG;IACU,QAAQ,CACjB,MAAM,EAAE,aAAa,GAAG,aAAa,EACrC,MAAM,CAAC,EAAE,GAAG,GACb,OAAO,CAAC,IAAI,CAAC;IA+DhB;;OAEG;IACU,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiIxC;;OAEG;YACW,oBAAoB;IA0DlC;;OAEG;YACW,mBAAmB;IAcjC;;OAEG;IACH,OAAO,CAAC,WAAW;CAGtB"}

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

@@ -0,0 +1,203 @@
+/***************************************************************************
+ * XyPrissJS - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ ***************************************************************************** */
+import { createServer } from "../../../server/ServerFactory";
+import { withInternalFlag } from "../../../server/utils/internalFlagsFunctions";
+import { Hash } from "xypriss-security";
+/**
+ * Plugin Loader
+ * Handles the heavy lifting of plugin registration and system initialization
+ */
+export class PluginLoader {
+    constructor(registry, security, hooks, interceptor, management, server, logger, initializedRef, permissionManager) {
+        this.registry = registry;
+        this.security = security;
+        this.hooks = hooks;
+        this.interceptor = interceptor;
+        this.management = management;
+        this.server = server;
+        this.logger = logger;
+        this.initializedRef = initializedRef;
+        this.permissionManager = permissionManager;
+    }
+    /**
+     * Register a plugin
+     */
+    async register(plugin, config) {
+        // If it's a function, call it to get the plugin
+        const pluginInstance = typeof plugin === "function" ? plugin(config) : plugin;
+        // --- SECURITY & VALIDATION ---
+        const callerStack = new Error().stack || "";
+        this.security.verifyContract(pluginInstance, callerStack);
+        this.security.validateMetadata(pluginInstance);
+        if (pluginInstance.__root__) {
+            this.security.verifyContentIntegrity(pluginInstance.__root__, pluginInstance.name);
+        }
+        // Generate fingerprint and UID
+        pluginInstance.fingerprint =
+            await this.generateFingerprint(pluginInstance);
+        pluginInstance.uid = this.generateUid(pluginInstance);
+        // Check for exact technical duplicates (same UID)
+        if (this.registry.has(pluginInstance.uid)) {
+            if (!this.server.options?.isAuxiliary) {
+                this.logger.error("plugins", `Plugin "${pluginInstance.name}" (${pluginInstance.uid}) is already registered. Duplicate ignored.`);
+            }
+            return;
+        }
+        // Check permission for onRegister if it exists
+        if (pluginInstance.onRegister) {
+            if (!this.permissionManager.checkPermission(pluginInstance.name, "onRegister")) {
+                return;
+            }
+        }
+        // Store plugin
+        this.registry.register(pluginInstance);
+        if (!this.server.options?.isAuxiliary) {
+            const serverName = this.server.options?.logging?.instanceName || "main";
+            this.logger.info("plugins", `Registered plugin for '${serverName}': xypriss::ext/${pluginInstance.name}@${pluginInstance.version} [hash:${pluginInstance.uid}]`);
+        }
+        // If already initialized, fully initialize this plugin immediately
+        if (this.initializedRef.value) {
+            await this.initializeLatePlugin(pluginInstance);
+        }
+    }
+    /**
+     * Unregister a plugin
+     */
+    async unregister(name) {
+        this.logger.info("plugins", `Unregistering plugin: ${name}`);
+        if (this.registry.has(name)) {
+            this.registry.unregister(name);
+            this.logger.info("plugins", `Unregistered plugin: ${name}`);
+        }
+    }
+    /**
+     * Initialize all plugins (resolve dependencies and set execution order)
+     */
+    async initialize() {
+        this.registry.resolveDependencies();
+        const order = this.registry.getOrder();
+        // --- STEP 1: Call onRegister for all plugins ---
+        // This is the first hook, called only after all plugins are successfully registered in the registry
+        for (const pluginName of order) {
+            const plugin = this.registry.get(pluginName);
+            if (plugin &&
+                plugin.onRegister &&
+                this.permissionManager.checkPermission(plugin.name, "onRegister")) {
+                try {
+                    const result = plugin.onRegister(null);
+                    if (result instanceof Promise) {
+                        await result;
+                    }
+                }
+                catch (error) {
+                    this.logger.error("plugins", `Error in ${pluginName}.onRegister:`, error);
+                }
+            }
+        }
+        this.initializedRef.value = true; // Set before calling hooks so late-registered plugins are detected
+        await this.hooks.executeHook("onServerStart");
+        // Execute management hook for plugins with permission
+        for (const pluginName of order) {
+            const plugin = this.registry.get(pluginName);
+            if (plugin &&
+                typeof plugin.managePlugins === "function" &&
+                this.permissionManager.checkPermission(plugin.name, "managePlugins")) {
+                try {
+                    await plugin.managePlugins({
+                        getStats: () => this.management.getPluginStats(),
+                        setPermission: (p, h, a, by) => this.management.setPluginPermission(p, h, a, by || pluginName),
+                        toggle: (p, e, by) => this.management.togglePlugin(p, e, by || pluginName),
+                    });
+                }
+                catch (error) {
+                    this.logger.error("plugins", `Error in ${pluginName}.managePlugins:`, error);
+                }
+            }
+        }
+        // Execute Ops hook for plugins with permission to deploy auxiliary servers
+        for (const pluginName of order) {
+            const plugin = this.registry.get(pluginName);
+            if (plugin &&
+                typeof plugin.onAuxiliaryServerDeploy === "function" &&
+                this.permissionManager.checkPermission(plugin.name, "onAuxiliaryServerDeploy")) {
+                try {
+                    const restrictedServer = this.security.createRestrictedServer(this.server, pluginName, this.permissionManager);
+                    await plugin.onAuxiliaryServerDeploy({
+                        createAuxiliaryServer: (options) => createServer(withInternalFlag({
+                            ...options,
+                            performance: { enabled: false },
+                            plugins: { register: [] },
+                            logging: {
+                                enabled: true,
+                                level: "info",
+                            },
+                        }, "isAuxiliary")),
+                        getRouteRegistry: () => this.server.app.getRouteRegistry(),
+                    }, restrictedServer);
+                }
+                catch (error) {
+                    this.logger.error("plugins", `Error in ${pluginName}.onAuxiliaryServerDeploy:`, error);
+                }
+            }
+        }
+    }
+    /**
+     * Handle initialization for a late-registered plugin
+     */
+    async initializeLatePlugin(plugin) {
+        // Resolve dependencies for this plugin
+        this.registry.resolveDependencies();
+        // Register routes for this late plugin
+        this.interceptor.registerPluginRoutes(plugin, this.server.app, true);
+        // Apply middleware for this late plugin
+        if (plugin.middleware || plugin.onRequest) {
+            this.interceptor.applyPluginMiddleware(plugin, this.server.app);
+        }
+        // Call lifecycle hooks for late plugin
+        const restrictedServer = this.security.createRestrictedServer(this.server, plugin.name, this.permissionManager);
+        if (plugin.onServerStart) {
+            if (this.permissionManager.checkPermission(plugin.name, "onServerStart")) {
+                Promise.resolve(plugin.onServerStart(restrictedServer)).catch((error) => {
+                    this.logger.error("plugins", `Error in ${plugin.name}.onServerStart:`, error);
+                });
+            }
+        }
+        if (plugin.onServerReady) {
+            if (this.permissionManager.checkPermission(plugin.name, "onServerReady")) {
+                Promise.resolve(plugin.onServerReady(restrictedServer)).catch((error) => {
+                    this.logger.error("plugins", `Error in ${plugin.name}.onServerReady:`, error);
+                });
+            }
+        }
+    }
+    /**
+     * Generate a fingerprint based on basic metadata
+     */
+    async generateFingerprint(plugin) {
+        // description + name
+        const base = `${plugin.description || ""}:${plugin.name}`;
+        // Use Hash.create from xypriss-security
+        try {
+            const hash = Hash.create(base, { algorithm: "sha256" })
+                .toString("hex")
+                .substring(0, 10);
+            return hash;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    /**
+     * Generate a technical UID
+     */
+    generateUid(plugin) {
+        return `${plugin.name}.${plugin.fingerprint}`;
+    }
+}
+//# sourceMappingURL=PluginLoader.js.map

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

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

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

@@ -0,0 +1,36 @@
+/***************************************************************************
+ * 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 { PluginStats } from "../../types/PluginTypes";
+/**
+ * Plugin Management
+ * Handles plugin statistics, permissions, and state toggling
+ */
+export declare class PluginManagement {
+    private registry;
+    private permissionManager;
+    private server;
+    private logger;
+    constructor(registry: PluginRegistry, permissionManager: PermissionManager, server: any, logger: Logger);
+    /**
+     * Get statistics for all registered plugins
+     */
+    getPluginStats(): PluginStats[];
+    /**
+     * Set permission for a plugin hook
+     */
+    setPluginPermission(pluginName: string, hookId: string, allowed: boolean, by?: string): void;
+    /**
+     * Disable a plugin globally
+     */
+    togglePlugin(pluginName: string, enabled: boolean, requestedBy?: string): void;
+}
+//# sourceMappingURL=PluginManagement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginManagement.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/core/manager/PluginManagement.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,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D;;;GAGG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,MAAM,CAAS;gBAGnB,QAAQ,EAAE,cAAc,EACxB,iBAAiB,EAAE,iBAAiB,EACpC,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,MAAM;IAQlB;;OAEG;IACI,cAAc,IAAI,WAAW,EAAE;IAuDtC;;OAEG;IACI,mBAAmB,CACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,EAAE,GAAE,MAAiB,GACtB,IAAI;IAyDP;;OAEG;IACI,YAAY,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,MAAM,GACrB,IAAI;CAgBV"}

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

@@ -0,0 +1,132 @@
+/***************************************************************************
+ * XyPrissJS - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ ***************************************************************************** */
+import { HOOK_ID_MAP } from "../../const/PluginHookIds";
+/**
+ * Plugin Management
+ * Handles plugin statistics, permissions, and state toggling
+ */
+export class PluginManagement {
+    constructor(registry, permissionManager, server, logger) {
+        this.registry = registry;
+        this.permissionManager = permissionManager;
+        this.server = server;
+        this.logger = logger;
+    }
+    /**
+     * Get statistics for all registered plugins
+     */
+    getPluginStats() {
+        const stats = [];
+        const permissions = this.server.app.configs?.pluginPermissions || [];
+        const plugins = this.registry.getAll();
+        for (const plugin of plugins) {
+            const name = plugin.name;
+            const pluginPerm = permissions.find((p) => p.name === name);
+            // Determine allowed hooks
+            let allowedHooks = pluginPerm?.allowedHooks || "*";
+            // If allowedHooks is '*', it means all hooks EXCEPT management hooks by default
+            if (allowedHooks === "*") {
+                const actualHooks = [];
+                const denied = pluginPerm?.deniedHooks || [];
+                for (const internalName in HOOK_ID_MAP) {
+                    if (typeof plugin[internalName] === "function") {
+                        const id = HOOK_ID_MAP[internalName];
+                        if (id !== HOOK_ID_MAP.managePlugins &&
+                            !denied.includes(id)) {
+                            actualHooks.push(id);
+                        }
+                    }
+                }
+                allowedHooks = actualHooks.length > 0 ? actualHooks : "*";
+            }
+            else if (Array.isArray(allowedHooks)) {
+                const denied = pluginPerm?.deniedHooks || [];
+                allowedHooks = allowedHooks.filter((h) => !denied.includes(h));
+            }
+            stats.push({
+                name: plugin.name,
+                version: plugin.version,
+                description: plugin.description || "",
+                enabled: !this.permissionManager.isPluginDisabled(name, "any"),
+                permissions: {
+                    allowedHooks,
+                    deniedHooks: pluginPerm?.deniedHooks || [],
+                    policy: pluginPerm?.policy || "allow",
+                },
+                uid: plugin.uid,
+                dependencies: plugin.dependencies || [],
+            });
+        }
+        return stats;
+    }
+    /**
+     * Set permission for a plugin hook
+     */
+    setPluginPermission(pluginName, hookId, allowed, by = "system") {
+        this.logger.warn("plugins", `Permission '${hookId}' for plugin '${pluginName}' ${allowed ? "granted" : "revoked"} by ${by}`);
+        if (!this.server.app.configs) {
+            this.server.app.configs = {};
+        }
+        if (!this.server.app.configs.pluginPermissions) {
+            this.server.app.configs.pluginPermissions = [];
+        }
+        let pluginPerm = this.server.app.configs.pluginPermissions.find((p) => p.name === pluginName);
+        if (!pluginPerm) {
+            pluginPerm = {
+                name: pluginName,
+                allowedHooks: allowed ? [hookId] : [],
+                deniedHooks: allowed ? [] : [hookId],
+                policy: "allow",
+            };
+            this.server.app.configs.pluginPermissions.push(pluginPerm);
+            return;
+        }
+        if (allowed) {
+            if (pluginPerm.deniedHooks) {
+                pluginPerm.deniedHooks = pluginPerm.deniedHooks.filter((h) => h !== hookId);
+            }
+            if (Array.isArray(pluginPerm.allowedHooks)) {
+                if (!pluginPerm.allowedHooks.includes(hookId)) {
+                    pluginPerm.allowedHooks.push(hookId);
+                }
+            }
+            else if (pluginPerm.allowedHooks === "*") {
+                // Already allowed
+            }
+            else {
+                pluginPerm.allowedHooks = [hookId];
+            }
+        }
+        else {
+            if (!pluginPerm.deniedHooks)
+                pluginPerm.deniedHooks = [];
+            if (!pluginPerm.deniedHooks.includes(hookId)) {
+                pluginPerm.deniedHooks.push(hookId);
+            }
+            if (Array.isArray(pluginPerm.allowedHooks)) {
+                pluginPerm.allowedHooks = pluginPerm.allowedHooks.filter((h) => h !== hookId);
+            }
+        }
+    }
+    /**
+     * Disable a plugin globally
+     */
+    togglePlugin(pluginName, enabled, requestedBy) {
+        const caller = requestedBy || "system";
+        if (enabled) {
+            this.permissionManager.enablePlugin(pluginName);
+            this.logger.info("plugins", `Plugin '${pluginName}' enabled by '${caller}'`);
+        }
+        else {
+            this.permissionManager.disablePlugin(pluginName);
+            this.logger.info("plugins", `Plugin '${pluginName}' disabled by '${caller}'`);
+        }
+    }
+}
+//# sourceMappingURL=PluginManagement.js.map