xypriss 9.11.13 → 9.12.0

package/dist/src/plugins/builtin/xems/XemsPlugin.js

@@ -0,0 +1,402 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+import * as readline from "node:readline";
+import { Logger } from "../../../shared/logger";
+import { getRandomBytes } from "xypriss-security";
+export class XemsError extends Error {
+    constructor(action, details) {
+        super(`[XEMS Error] ${action}: ${details}`);
+        this.action = action;
+        this.details = details;
+        this.name = "XemsError";
+    }
+}
+/**
+ * XEMS Runner (Long-running process manager)
+ * Manages the persistent Rust process for in-memory storage.
+ */
+export class XemsRunner {
+    constructor(options = {}) {
+        this.process = null;
+        this.queue = [];
+        this.isReady = false;
+        this.options = {};
+        this.options = options;
+        this.binaryPath = this.discoverBinary();
+        this.logger = new Logger();
+        // Lazy load: init() is now called either when persistence is enabled
+        // or during the first command if needed.
+    }
+    /**
+     * Internal factory for getting or creating a runner for a specific path.
+     * This ensures only one process exists for a given file in the entire process.
+     */
+    static getInstance(pathStr, options = {}) {
+        const absPath = path.resolve(process.cwd(), pathStr);
+        const existing = XemsRunner.runnersByPath.get(absPath);
+        if (existing) {
+            // Merge options if provided
+            if (options.secret)
+                existing.options.secret = options.secret;
+            return existing;
+        }
+        const runner = new XemsRunner({ ...options, persistPath: pathStr });
+        XemsRunner.runnersByPath.set(absPath, runner);
+        return runner;
+    }
+    enablePersistence(pathStr, secret, resources) {
+        if (!pathStr) {
+            throw new XemsError("EPNOTDEF", "Path is required when persistence is enabled");
+        }
+        const dir = path.dirname(pathStr);
+        if (dir && dir !== "." && !fs.existsSync(dir)) {
+            try {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            catch (err) {
+                this.logger.error("xems", `Failed to create persistence directory: ${dir}`);
+            }
+        }
+        // Register this runner in the global registry for this path
+        const absPath = path.resolve(process.cwd(), pathStr);
+        const existing = XemsRunner.runnersByPath.get(absPath);
+        if (existing && existing !== this) {
+            this.logger.warn("xems", `Path ${pathStr} is already being managed by another runner. Switching to shared mode.`);
+            // Transitions this instance to delegate to the existing one if needed?
+            // Actually, for simplicity, we just ensure WE don't spawn if another one is already there.
+        }
+        XemsRunner.runnersByPath.set(absPath, this);
+        // Avoid redundant restarts if path is the same
+        if (this.options.persistPath === pathStr && this.process) {
+            return;
+        }
+        this.options.persistPath = pathStr;
+        this.options.secret = secret;
+        if (resources?.cacheSize) {
+            this.options.cacheSize = resources.cacheSize;
+        }
+        this.logger.warn("plugins", `Persistence enabled: ${path.resolve(pathStr)}. Restarting process...`);
+        if (this.process) {
+            // Remove the close listener before killing to prevent auto-respawn in a loop
+            this.process.removeAllListeners("close");
+            this.process.kill();
+        }
+        // Re-init immediately
+        this.init();
+    }
+    /**
+     * Finds the XEMS binary location.
+     * Starts with development paths, falls back to production locations.
+     */
+    /**
+     * Strategic discovery of the xems binary across different environments.
+     * Robust logic handling dev, prod, and installed contexts.
+     */
+    discoverBinary() {
+        const binName = process.platform === "win32" ? "xems.exe" : "xems";
+        // 1. Precise discovery relative to the script location
+        try {
+            const currentFile = fileURLToPath(import.meta.url);
+            const currentDir = path.dirname(currentFile);
+            // We search up from the current file to find the package root
+            let walkDir = currentDir;
+            // Limit walk to 10 levels to prevent infinite loops or excessive searching
+            for (let i = 0; i < 10; i++) {
+                const potentialBin = path.join(walkDir, "bin", binName);
+                if (fs.existsSync(potentialBin))
+                    return potentialBin;
+                const parent = path.dirname(walkDir);
+                if (parent === walkDir || parent === path.parse(walkDir).root)
+                    break;
+                walkDir = parent;
+            }
+        }
+        catch (e) {
+            // Silently continue
+        }
+        // 2. Try project root bin (Standard Local Production)
+        const projectBin = path.resolve(process.cwd(), "bin", binName);
+        if (fs.existsSync(projectBin))
+            return projectBin;
+        // 3. Deep discovery: Search up from CWD
+        // This handles monorepos, symlinked packages, and subfolder execution.
+        let walkDir = process.cwd();
+        while (walkDir !== path.parse(walkDir).root) {
+            // Check node_modules/.bin (Standard for installed packages)
+            const nodeModulesBin = path.join(walkDir, "node_modules", ".bin");
+            const potentialBin = path.join(nodeModulesBin, binName);
+            if (fs.existsSync(potentialBin))
+                return potentialBin;
+            // Also check a local "bin" folder at each level
+            const localBin = path.join(walkDir, "bin");
+            const localRust = path.join(localBin, binName);
+            if (fs.existsSync(localRust))
+                return localRust;
+            walkDir = path.dirname(walkDir);
+        }
+        // 4. Try development target paths (Rust Cargo specific)
+        const devTargets = [
+            path.resolve(process.cwd(), "tools/XEMS/bin", binName),
+            path.resolve(process.cwd(), "tools/XEMS/target/release", binName),
+            path.resolve(process.cwd(), "tools/XEMS/target/debug", binName),
+        ];
+        for (const target of devTargets) {
+            if (fs.existsSync(target))
+                return target;
+        }
+        // 5. Global fallback to PATH (Binary must be globally available)
+        return binName;
+    }
+    init() {
+        if (!fs.existsSync(this.binaryPath) &&
+            !this.binaryPath.endsWith("xems")) {
+            this.logger.error("xems", `Critical: Binary not found at ${this.binaryPath}`);
+            return; // Cannot spawn
+        }
+        try {
+            const args = [];
+            if (this.options.persistPath) {
+                args.push("--persist", this.options.persistPath);
+            }
+            if (this.options.secret) {
+                args.push("--secret", this.options.secret);
+            }
+            if (this.options.cacheSize) {
+                args.push("--cache-size", this.options.cacheSize.toString());
+            }
+            this.process = spawn(this.binaryPath, args);
+            const rl = readline.createInterface({
+                input: this.process.stdout,
+                terminal: false,
+            });
+            rl.on("line", (line) => {
+                if (line.trim()) {
+                    this.handleResponse(line);
+                }
+            });
+            this.process.stderr?.on("data", (data) => {
+                this.logger.error("xems", `[XEMS Log] ${data}`);
+            });
+            this.process.on("close", (code) => {
+                this.isReady = false;
+                if (code !== 0 && code !== null) {
+                    this.logger.warn("xems", `Process exited unexpectedly with code ${code}. Restarting in 2s...`);
+                    setTimeout(() => this.init(), 2000);
+                }
+            });
+            this.isReady = true;
+        }
+        catch (e) {
+            this.logger.error("xems", `Failed to spawn process ${e}`);
+        }
+    }
+    handleResponse(jsonString) {
+        if (this.queue.length > 0) {
+            const resolver = this.queue.shift();
+            try {
+                const response = JSON.parse(jsonString);
+                if (response.status === "error") {
+                    // We resolve even on error to let the caller handle it via the response object,
+                    // or we could reject. For XyPriss style, let's just return the response object.
+                    resolver && resolver(response, null);
+                }
+                else {
+                    resolver && resolver(response, null);
+                }
+            }
+            catch (e) {
+                this.logger.error("xems", `Failed to parse response ${e}`);
+            }
+        }
+    }
+    async execute(cmd) {
+        // Auto-initialize if process not started
+        if (!this.process) {
+            this.init();
+        }
+        // Wait a bit if not ready (startup grace period)
+        if (!this.isReady) {
+            for (let i = 0; i < 10; i++) {
+                if (this.isReady)
+                    break;
+                await new Promise((r) => setTimeout(r, 100));
+            }
+        }
+        return new Promise((resolve, reject) => {
+            if (!this.isReady || !this.process || !this.process.stdin) {
+                reject(new XemsError(cmd.action, "XEMS not ready (process dead or initializing)"));
+                return;
+            }
+            this.queue.push((res, _err) => resolve(res));
+            const payload = JSON.stringify(cmd) + "\n";
+            this.process.stdin.write(payload);
+        });
+    }
+    // --- Public API Sugar ---
+    async ping() {
+        const res = await this.execute({ action: "ping" });
+        return res.data || "no-data";
+    }
+    /**
+     * Set a value in a sandbox with optional TTL.
+     */
+    async set(sandbox, key, value, ttl) {
+        const res = await this.execute({
+            action: "set",
+            sandbox,
+            key,
+            value,
+            ttl,
+        });
+        return res.status === "ok";
+    }
+    /**
+     * Get a value from a sandbox.
+     */
+    async get(sandbox, key) {
+        const res = await this.execute({ action: "get", sandbox, key });
+        return res.status === "ok" ? res.data || null : null;
+    }
+    /**
+     * Delete/Invalidate a key in a sandbox.
+     */
+    async del(sandbox, key) {
+        const res = await this.execute({ action: "del", sandbox, key });
+        return res.status === "ok";
+    }
+    /**
+     * [SESSION LAYER] Creates a new session entry.
+     * Generates a random opaque token, stores `data` under it, and returns the token.
+     * Use this when you don't care about the key — you just want a session handle.
+     *
+     * @param sandbox - The isolated namespace to store the session in
+     * @param data    - Any serializable data to associate with the session
+     * @param options - Optional TTL and rotation settings
+     * @returns The generated session token (opaque handle)
+     */
+    async createSession(sandbox, data, options = {}) {
+        const token = getRandomBytes(24).toString("hex");
+        const value = typeof data === "string" ? data : JSON.stringify(data);
+        await this.set(sandbox, token, value, options.ttl);
+        return token;
+    }
+    /**
+     * [SESSION LAYER] Resolves a session token back to its data.
+     * Optionally rotates the token (invalidates old one, issues a new one) to
+     * prevent replay attacks.
+     *
+     * USES ATOMIC ROTATION with Grace Period to prevent race conditions on
+     * simultaneous requests.
+     *
+     * @param token   - The opaque session token previously returned by createSession
+     * @param options - sandbox, optional rotation, optional new TTL, optional custom grace period
+     * @returns `{ data, newToken? }` or `null` if the token is expired/unknown
+     */
+    async resolveSession(token, options) {
+        // Use atomic 'rotate' logic from Rust if rotate is requested
+        const res = await this.execute({
+            action: "get",
+            sandbox: options.sandbox,
+            key: token,
+            rotate: options.rotate,
+            ttl: options.ttl,
+            grace_period: options.gracePeriod || this.options.gracePeriod || 1000,
+        });
+        if (res.status !== "ok" || !res.data)
+            return null;
+        let data;
+        try {
+            data = JSON.parse(res.data);
+        }
+        catch {
+            data = res.data;
+        }
+        return {
+            data,
+            newToken: res.new_token,
+        };
+    }
+    /**
+     * Fluent API entry point. Returns a context for a specific sandbox.
+     * @example xems.from("auth").set("user:1", data)
+     */
+    from(sandbox) {
+        return new XemsSandboxContext(this, sandbox);
+    }
+    /**
+     * Alias for from()
+     * Fluent API entry point. Returns a context for a specific sandbox.
+     * @example xems.select("auth").set("user:1", data)
+     */
+    select(sandbox) {
+        return new XemsSandboxContext(this, sandbox);
+    }
+    /**
+     * Contextual retrieval for multi-server environments.
+     * Returns the XEMS instance attached to the provided app object if available,
+     * otherwise returns this instance.
+     */
+    forApp(app) {
+        return app?.xems || this;
+    }
+    /**
+     * Forcefully stops the XEMS process and cleans up resources.
+     */
+    destroy() {
+        if (this.process) {
+            this.process.removeAllListeners("close");
+            this.process.kill();
+            this.process = null;
+            this.isReady = false;
+        }
+    }
+}
+/**
+ * Enables hardware-bound persistent storage for XEMS.
+ */
+XemsRunner.runnersByPath = new Map();
+/**
+ * Contextual wrapper for XEMS operations within a specific sandbox.
+ * Provides a cleaner, fluent API for advanced operations.
+ */
+class XemsSandboxContext {
+    constructor(runner, sandbox) {
+        this.runner = runner;
+        this.sandbox = sandbox;
+    }
+    /** Set a value in this sandbox */
+    async set(key, value, ttl) {
+        return this.runner.set(this.sandbox, key, value, ttl);
+    }
+    /** Get a value from this sandbox */
+    async get(key) {
+        return this.runner.get(this.sandbox, key);
+    }
+    /** Remove a key from this sandbox */
+    async del(key) {
+        return this.runner.del(this.sandbox, key);
+    }
+    /**
+     * Perform an atomic rotation of a token in this sandbox.
+     * Returns the original data and the new rotated token.
+     */
+    async rotate(token, options = {}) {
+        return this.runner.resolveSession(token, {
+            sandbox: this.sandbox,
+            rotate: true,
+            ttl: options.ttl,
+            gracePeriod: options.gracePeriod,
+        });
+    }
+    /**
+     * Create a new session in this sandbox.
+     */
+    async createSession(data, options = {}) {
+        return this.runner.createSession(this.sandbox, data, options);
+    }
+}
+// Export singleton instance as the plugin interface
+export const xems = new XemsRunner();
+//# sourceMappingURL=XemsPlugin.js.map

package/dist/src/plugins/builtin/xems/XemsPlugin.js.map

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

package/dist/src/plugins/builtin/xems/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./XemsPlugin";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/plugins/builtin/xems/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/builtin/xems/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/src/plugins/builtin/xems/index.js

@@ -0,0 +1,2 @@
+export * from "./XemsPlugin";
+//# sourceMappingURL=index.js.map

package/dist/src/plugins/builtin/xems/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/plugins/builtin/xems/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/src/plugins/const/OFFICIAL_PLUGINS.d.ts

@@ -0,0 +1,2 @@
+export declare const OFFICIAL_PLUGINS: string[];
+//# sourceMappingURL=OFFICIAL_PLUGINS.d.ts.map

package/dist/src/plugins/const/OFFICIAL_PLUGINS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OFFICIAL_PLUGINS.d.ts","sourceRoot":"","sources":["../../../../src/plugins/const/OFFICIAL_PLUGINS.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,UAI5B,CAAC"}

package/dist/src/plugins/const/OFFICIAL_PLUGINS.js

@@ -0,0 +1,6 @@
+export const OFFICIAL_PLUGINS = [
+    "xypriss::xems.core",
+    "Connection Management Plugin",
+    "Proxy Routing Plugin",
+];
+//# sourceMappingURL=OFFICIAL_PLUGINS.js.map

package/dist/src/plugins/const/OFFICIAL_PLUGINS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OFFICIAL_PLUGINS.js","sourceRoot":"","sources":["../../../../src/plugins/const/OFFICIAL_PLUGINS.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,oBAAoB;IACpB,8BAA8B;IAC9B,sBAAsB;CACzB,CAAC"}

package/dist/src/plugins/const/PluginHookIds.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Plugin Hook Identifiers
+ *
+ * Defines the unique identifiers for all plugin hooks used in the permission system.
+ * These IDs are used in the server configuration to allow/deny specific hooks.
+ */
+export declare const PluginHookIds: {
+    readonly ON_REGISTER: "XHS.HOOK.LIFECYCLE.REGISTER";
+    readonly ON_SERVER_START: "XHS.HOOK.LIFECYCLE.SERVER_START";
+    readonly ON_SERVER_READY: "XHS.HOOK.LIFECYCLE.SERVER_READY";
+    readonly ON_SERVER_STOP: "XHS.HOOK.LIFECYCLE.SERVER_STOP";
+    readonly ON_REQUEST: "XHS.HOOK.HTTP.REQUEST";
+    readonly ON_RESPONSE: "XHS.HOOK.HTTP.RESPONSE";
+    readonly ON_ERROR: "XHS.HOOK.HTTP.ERROR";
+    readonly ON_SECURITY_ATTACK: "XHS.HOOK.SECURITY.ATTACK";
+    readonly ON_RATE_LIMIT: "XHS.HOOK.SECURITY.RATE_LIMIT";
+    readonly ACCESS_CONFIGS: "XHS.PERM.SECURITY.CONFIGS";
+    readonly ACCESS_SENSITIVE_DATA: "XHS.PERM.SECURITY.SENSITIVE_DATA";
+    readonly ON_RESPONSE_TIME: "XHS.HOOK.METRICS.RESPONSE_TIME";
+    readonly ON_ROUTE_ERROR: "XHS.HOOK.METRICS.ROUTE_ERROR";
+    readonly REGISTER_ROUTES: "XHS.PERM.ROUTING.REGISTER_ROUTES";
+    readonly MIDDLEWARE: "XHS.PERM.HTTP.MIDDLEWARE";
+    readonly BYPASS_NAMESPACE: "XHS.PERM.ROUTING.BYPASS_NAMESPACE";
+    readonly OVERWRITE_PROTECTED: "XHS.PERM.ROUTING.OVERWRITE_PROTECTED";
+    readonly GLOBAL_MIDDLEWARE: "XHS.PERM.HTTP.GLOBAL_MIDDLEWARE";
+    readonly MANAGE_PLUGINS: "PLG.MANAGEMENT.MANAGE_PLUGINS";
+    readonly ON_AUXILIARY_SERVER_DEPLOY: "XHS.PERM.OPS.AUXILIARY_SERVER";
+    readonly ON_CONSOLE_INTERCEPT: "XHS.PERM.LOGGING.CONSOLE_INTERCEPT";
+};
+/**
+ * Mapping from internal hook method names to public PluginHookIds
+ */
+export declare const HOOK_ID_MAP: Record<string, string>;
+/**
+ * Detailed metadata for each plugin hook.
+ * Used for descriptive error messages and documentation.
+ */
+export declare const HOOK_METADATA: Record<string, {
+    name: string;
+    action: string;
+    description: string;
+}>;
+export type PluginHookId = (typeof PluginHookIds)[keyof typeof PluginHookIds];
+//# sourceMappingURL=PluginHookIds.d.ts.map

package/dist/src/plugins/const/PluginHookIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHookIds.d.ts","sourceRoot":"","sources":["../../../../src/plugins/const/PluginHookIds.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;CAqChB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyC9C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAC9B,MAAM,EACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAoHxD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}