xypriss 9.11.13 → 9.12.0

package/dist/src/plugins/api/PluginAPI.js

@@ -0,0 +1,344 @@
+/**
+ * Plugin API
+ * Public API for plugin management as documented in PLUGIN_SYSTEM_GUIDE.md
+ */
+import { HOOK_ID_MAP, HOOK_METADATA } from "../const/PluginHookIds";
+// ─── Internal State ──────────────────────────────────────────────────────────
+let globalPluginManager = null;
+const pendingPlugins = [];
+// ─── Blocked / Private members ───────────────────────────────────────────────
+/**
+ * Methods that must never be accessible from outside the module.
+ * The Proxy intercepts any access to these keys and throws immediately.
+ */
+const PRIVATE_MEMBERS = new Set(["register"]);
+// ─── Internal helpers ─────────────────────────────────────────────────────────
+function assertNonEmptyString(value, errorMessage) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(errorMessage);
+    }
+}
+function resolvePluginRoot(rootOrSys) {
+    const root = typeof rootOrSys === "string" ? rootOrSys : rootOrSys?.__root__;
+    if (!root || typeof root !== "string" || !root.trim()) {
+        throw new Error("XyPriss Security Error: The provided root or '__sys__' instance is invalid or lacks a captured project root.");
+    }
+    return root;
+}
+// ─── Internal exports ────────────────────────────────────────────────────────
+/**
+ * Set the global plugin manager.
+ * @internal — Used by the server factory only.
+ */
+export async function setGlobalPluginManager(manager) {
+    globalPluginManager = manager;
+    // Flush pending queue in parallel
+    const queue = pendingPlugins.splice(0);
+    await Promise.all(queue.map(({ plugin, config }) => manager.register(plugin, config)));
+}
+/**
+ * Get the global plugin manager.
+ * @internal
+ */
+export function getGlobalPluginManager() {
+    return globalPluginManager;
+}
+// ─── PluginAPI class ─────────────────────────────────────────────────────────
+class PluginAPI {
+    /**
+     * Reads and returns the project manifest (`package.json`) associated with the provided system core.
+     *
+     * This method is cryptographically and logically bound to the system instance to ensure
+     * that plugins only access the metadata of their authorized environment.
+     *
+     * @template T - The expected structure of the manifest file.
+     * @param sys - The XyPriss Hyper-System Core (`__sys__`) instance.
+     * @returns The parsed JSON content of the `package.json` file.
+     * @throws {Error} If the system instance is invalid, lacks a root path, or the manifest cannot be read.
+     *
+     * @example
+     * ```typescript
+     * const pkg = Plugin.manifest<MyPackageJson>(__sys__);
+     * console.log(`Running in ${pkg.name}@${pkg.version}`);
+     * ```
+     */
+    manifest(sys) {
+        if (!sys || !sys.__root__) {
+            throw new Error("XyPriss Security Error: The provided system core instance is invalid or lacks an authorized project root association.");
+        }
+        const manifestPath = sys.fs.join(sys.__root__, "package.json");
+        if (!sys.path.exists(manifestPath)) {
+            throw new Error(`XyPriss I/O Error: Unable to access project manifest at "${manifestPath}". Verify that the file exists and is readable.`);
+        }
+        try {
+            return sys.fs.readJsonSync(manifestPath);
+        }
+        catch (err) {
+            throw new Error(`XyPriss I/O Error: Unable to access project manifest at "${manifestPath}". Verify that the file exists and is readable.`);
+        }
+    }
+    /**
+     * @private — Internal registration. Never call this directly.
+     * Use `exec()` instead.
+     */
+    register(plugin, config) {
+        const manager = globalPluginManager;
+        if (manager) {
+            manager.register(plugin, config);
+        }
+        else {
+            pendingPlugins.push({ plugin, config });
+        }
+    }
+    /**
+     * Register a plugin — the sole public entry point for plugin registration.
+     *
+     * @example
+     * ```typescript
+     * Plugin.exec(Plugin.create({
+     *   name: "test",
+     *   version: "1.0.0",
+     *   onServerStart(server) {
+     *     console.log("Server started");
+     *   },
+     * }, __sys__.__root__));
+     * ```
+     */
+    exec(plugin, config) {
+        this.register(plugin, config);
+    }
+    /**
+     * Get a registered plugin by name.
+     *
+     * @example
+     * ```typescript
+     * const plugin = Plugin.get("my-plugin");
+     * if (plugin) {
+     *   console.log(`Found plugin: ${plugin.name}@${plugin.version}`);
+     * }
+     * ```
+     */
+    get(name) {
+        const manager = globalPluginManager;
+        if (!manager) {
+            throw new Error("Plugin system not initialized. Create a server instance first.");
+        }
+        const plugin = manager.getPlugin(name);
+        if (!plugin) {
+            return undefined;
+        }
+        return {
+            name: plugin.name,
+            version: plugin.version,
+            __root__: plugin.__root__ || "",
+        };
+    }
+    /**
+     * Create a type-safe plugin instance with a validated root.
+     *
+     * @example
+     * ```typescript
+     * const myPlugin = Plugin.create({
+     *   name: "my-plugin",
+     *   version: "1.0.0",
+     *   onServerStart: (server) => console.log("Plugin started!"),
+     * }, __sys__.__root__);
+     * ```
+     */
+    create(plugin, Sys) {
+        assertNonEmptyString(Sys, "XyPriss Initialization Error: To create a plugin, you MUST provide the plugin's root path or its '__sys__' instance as the second argument to Plugin.create().\n" +
+            "Example: return Plugin.create({ ... }, __sys__.__root__);");
+        plugin.__root__ = Sys;
+        const requiredFields = [
+            "name",
+            "description",
+            "version",
+        ];
+        if (!plugin.name || typeof plugin.name !== "string") {
+            throw new Error(`XyPriss Plugin Error: "name" is missing or invalid.`);
+        }
+        for (const field of ["description", "version"]) {
+            if (!plugin[field] || typeof plugin[field] !== "string") {
+                throw new Error(`XyPriss Plugin Error: "${field}" is missing or invalid on plugin "${plugin.name}".`);
+            }
+        }
+        return plugin;
+    }
+    /**
+     * Create a typed plugin factory with a pre-assigned root.
+     *
+     * @example
+     * ```typescript
+     * const myFactory = Plugin.factory(
+     *   (config: MyConfig) => ({ name: "my-plugin", version: "1.0.0" }),
+     *   __sys__.__root__
+     * );
+     * ```
+     */
+    factory(creator, rootOrSys) {
+        if (!rootOrSys) {
+            throw new Error("XyPriss Initialization Error: Plugin.factory() requires the plugin's root path or '__sys__' instance as the second argument.");
+        }
+        const pluginRoot = resolvePluginRoot(rootOrSys);
+        return ((config) => {
+            const plugin = creator(config);
+            plugin.__root__ = pluginRoot;
+            return plugin;
+        });
+    }
+    // /**
+    //  * Get statistics for all registered plugins
+    //  * Requires MANAGE_PLUGINS permission
+    //  */
+    // getStats(): import("../types/PluginTypes").PluginStats[] {
+    //     const manager = globalPluginManager;
+    //     if (!manager) return [];
+    //     return manager.getPluginStats();
+    // }
+    // /**
+    //  * Set permission for a plugin hook
+    //  * Requires MANAGE_PLUGINS permission
+    //  */
+    // setPermission(pluginName: string, hookId: string, allowed: boolean, by?: string): void {
+    //     globalPluginManager?.setPluginPermission(pluginName, hookId, allowed, by);
+    // }
+    // /**
+    //  * Toggle plugin enabled/disabled state
+    //  * Requires MANAGE_PLUGINS permission
+    //  */
+    // toggle(pluginName: string, enabled: boolean, by?: string): void {
+    //     globalPluginManager?.togglePlugin(pluginName, enabled, by);
+    // }
+    /**
+     * Create a no-op placeholder plugin.
+     * Useful for testing or conditional plugin slots.
+     */
+    void() {
+        return {
+            name: `void-plugin-${Math.random().toString(36).slice(2, 9)}`,
+            version: "1.0.0",
+            description: "A void plugin for testing purposes.",
+        };
+    }
+    /**
+     * Performs a deep inspection of a plugin instance to identify and list all required
+     * cryptographic permissions based on implemented hooks.
+     *
+     * This utility is designed for developers to use during the preparation of their
+     * `package.json` manifest (`xfpm.permissions` field).
+     *
+     * @param plugin - The XyPriss plugin instance to inspect.
+     *
+     * @example
+     * ```typescript
+     * const myPlugin = Plugin.create({ ... }, __sys__.__root__);
+     * Plugin.inspect(myPlugin);
+     * ```
+     */
+    inspect(plugin) {
+        const header = `[XyPriss Plugin Inspector] ${plugin.name} v${plugin.version}`;
+        const line = "═".repeat(header.length);
+        const c = {
+            reset: "\x1b[0m",
+            bold: "\x1b[1m",
+            dim: "\x1b[2m",
+            cyan: "\x1b[36m",
+            green: "\x1b[32m",
+            yellow: "\x1b[33m",
+            red: "\x1b[31m",
+            gray: "\x1b[90m",
+            magenta: "\x1b[35m",
+        };
+        console.log(`\n${c.cyan}${line}${c.reset}`);
+        console.log(`${c.bold}${c.cyan}${header}${c.reset}`);
+        console.log(`${c.cyan}${line}${c.reset}`);
+        console.log(`${c.bold}Project Root:${c.reset} ${c.gray}${plugin.__root__ || "Not Captured"}${c.reset}`);
+        console.log(`\n${c.magenta}${c.bold}Detected Hooks & Authorized Permission IDs:${c.reset}`);
+        const entries = Object.entries(plugin);
+        const hookKeys = Object.keys(HOOK_ID_MAP);
+        let foundCount = 0;
+        // List of privileged IDs that require explicit authorization
+        const privilegedIds = [
+            "PLG.MANAGEMENT.MANAGE_PLUGINS",
+            "XHS.PERM.LOGGING.CONSOLE_INTERCEPT",
+            "XHS.PERM.OPS.AUXILIARY_SERVER",
+            "XHS.PERM.ROUTING.BYPASS_NAMESPACE",
+            "XHS.PERM.ROUTING.OVERWRITE_PROTECTED",
+            "XHS.PERM.HTTP.GLOBAL_MIDDLEWARE",
+            "XHS.PERM.SECURITY.CONFIGS",
+            "XHS.PERM.SECURITY.SENSITIVE_DATA",
+            "XHS.HOOK.HTTP.REQUEST",
+            "XHS.HOOK.HTTP.RESPONSE",
+        ];
+        // DEEP SCAN: Check all known hook and permission keys
+        for (const key of hookKeys) {
+            const hookId = HOOK_ID_MAP[key];
+            const value = plugin[key];
+            // If the key exists on the plugin instance (function, boolean, array, etc.)
+            if (value !== undefined) {
+                foundCount++;
+                const meta = HOOK_METADATA[hookId];
+                const isPrivileged = privilegedIds.includes(hookId);
+                console.log(`\n  ${c.cyan}○${c.reset} ${c.bold}Hook/Capability:${c.reset} ${c.green}${key}${c.reset}`);
+                console.log(`    ${c.bold}ID:${c.reset}   ${c.yellow}${hookId}${c.reset} ${isPrivileged ? `${c.red}${c.bold}⚠️  [PRIVILEGED]${c.reset}` : ""}`);
+                if (meta) {
+                    console.log(`    ${c.gray}Role:${c.reset} ${meta.action}`);
+                    console.log(`    ${c.gray}Info:${c.reset} ${c.dim}${meta.description}${c.reset}`);
+                }
+            }
+        }
+        if (foundCount === 0) {
+            console.log(`\n  ${c.yellow}No hooks requiring special permissions were detected in this plugin.${c.reset}`);
+        }
+        else {
+            console.log(`\n${c.bold}${c.green}Summary: Found ${foundCount} required permissions.${c.reset}`);
+            console.log(`\n${c.bold}${c.cyan}TIP:${c.reset} Copy the IDs above into your package.json's ${c.bold}"xfpm.permissions"${c.reset} array.`);
+        }
+        console.log(`\n${c.cyan}${line}${c.reset}\n`);
+    }
+}
+// ─── Proxy Shield ─────────────────────────────────────────────────────────────
+/**
+ * Wraps the PluginAPI instance in a Proxy that:
+ *   1. Blocks direct access to private members (e.g. `register`).
+ *   2. Prevents any mutation of the instance from outside.
+ *   3. Prevents prototype inspection / tampering.
+ */
+function createSecurePluginAPI(instance) {
+    return new Proxy(instance, {
+        get(target, prop) {
+            // Block private members by name
+            if (typeof prop === "string" && PRIVATE_MEMBERS.has(prop)) {
+                throw new TypeError(`XyPriss Security Error: '${prop}' is a private method and cannot be accessed externally.`);
+            }
+            const value = Reflect.get(target, prop, target);
+            // Bind methods so `this` always refers to the real instance, not the proxy
+            if (typeof value === "function") {
+                return value.bind(target);
+            }
+            return value;
+        },
+        // Prevent property assignment from outside
+        set(_target, prop) {
+            throw new TypeError(`XyPriss Security Error: Cannot assign to '${String(prop)}' — the Plugin API is read-only.`);
+        },
+        // Prevent property deletion
+        deleteProperty(_target, prop) {
+            throw new TypeError(`XyPriss Security Error: Cannot delete '${String(prop)}' — the Plugin API is immutable.`);
+        },
+        // Prevent defineProperty overrides
+        defineProperty(_target, prop) {
+            throw new TypeError(`XyPriss Security Error: Cannot redefine '${String(prop)}' on the Plugin API.`);
+        },
+        // Prevent prototype chain inspection / hijacking
+        getPrototypeOf() {
+            return null;
+        },
+        // Prevent setPrototypeOf
+        setPrototypeOf() {
+            throw new TypeError("XyPriss Security Error: Cannot modify the prototype of the Plugin API.");
+        },
+    });
+}
+export const Plugin = createSecurePluginAPI(new PluginAPI());
+//# sourceMappingURL=PluginAPI.js.map

package/dist/src/plugins/api/PluginAPI.js.map

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

package/dist/src/plugins/builtin/RouteOptimizationPlugin.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Route Optimization Plugin
+ *
+ * Automatically detects popular routes and optimizes them in the background
+ * Features:
+ * - Route popularity tracking
+ * - Automatic caching for hot routes
+ * - Response time optimization
+ * - Predictive preloading
+ * - Route pattern analysis
+ */
+import { EventEmitter } from "events";
+import { RouteOptimizationConfig, RouteStats } from "../types/index";
+import { XyPrissPlugin, PluginServer } from "../types/PluginTypes";
+export declare class RouteOptimizationPlugin extends EventEmitter implements XyPrissPlugin {
+    name: string;
+    version: string;
+    private config;
+    private routeStats;
+    private optimizedRoutes;
+    private analysisTimer?;
+    private app;
+    private logger;
+    constructor(config?: RouteOptimizationConfig);
+    /**
+     * Hook for modern XyPriss Plugin System
+     */
+    onServerStart(server: PluginServer): void;
+    /**
+     * Initialize the plugin with XyPriss app
+     */
+    initialize(app: any, logger: any): void;
+    /**
+     * Install middleware to track route usage
+     */
+    private installTrackingMiddleware;
+    /**
+     * Track route request start
+     */
+    private trackRouteStart;
+    /**
+     * Track route request completion
+     */
+    private trackRouteEnd;
+    /**
+     * Calculate route popularity score
+     */
+    private calculatePopularity;
+    /**
+     * Check if route should be optimized
+     */
+    private shouldOptimizeRoute;
+    /**
+     * Optimize a specific route
+     */
+    private optimizeRoute;
+    /**
+     * Apply caching optimization
+     */
+    private applyCachingOptimization;
+    /**
+     * Apply compression optimization
+     */
+    private applyCompressionOptimization;
+    /**
+     * Apply preloading optimization
+     */
+    private applyPreloadingOptimization;
+    /**
+     * Preload route data
+     */
+    private preloadRouteData;
+    /**
+     * Schedule predictive preloading
+     */
+    private schedulePreload;
+    /**
+     * Check if path matches pattern
+     */
+    private matchesPattern;
+    /**
+     * Start background analysis
+     */
+    private startBackgroundAnalysis;
+    /**
+     * Perform route analysis
+     */
+    private performAnalysis;
+    /**
+     * Cleanup old unused routes
+     */
+    private cleanupOldRoutes;
+    /**
+     * Get route statistics
+     */
+    getRouteStats(): RouteStats[];
+    /**
+     * Get optimized routes
+     */
+    getOptimizedRoutes(): string[];
+    /**
+     * Manually optimize a route
+     */
+    manualOptimize(routeKey: string): void;
+    /**
+     * Destroy the plugin
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=RouteOptimizationPlugin.d.ts.map

package/dist/src/plugins/builtin/RouteOptimizationPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteOptimizationPlugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/builtin/RouteOptimizationPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEnE,qBAAa,uBACT,SAAQ,YACR,YAAW,aAAa;IAEjB,IAAI,SAAwB;IAC5B,OAAO,SAAW;IACzB,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,aAAa,CAAC,CAAiB;IACvC,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,MAAM,CAAM;gBAER,MAAM,GAAE,uBAA4B;IAiBhD;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIhD;;OAEG;IACI,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI;IAe9C;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAsBjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAkCrB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwEhC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAsCpC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA4CnC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAM/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;IACI,aAAa,IAAI,UAAU,EAAE;IAMpC;;OAEG;IACI,kBAAkB,IAAI,MAAM,EAAE;IAIrC;;OAEG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO7C;;OAEG;IACI,OAAO,IAAI,IAAI;CAQzB"}