xypriss 9.7.6 → 9.7.8

package/dist/esm/src/xhsc/fs/FSExtended.js.map

@@ -1 +1 @@
-{"version":3,"file":"FSExtended.js","sources":["../../../../../src/xhsc/fs/FSExtended.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"FSExtended.js","sources":["../../../../../src/xhsc/fs/FSExtended.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3497,6 +3497,10 @@ declare class OSApi extends BaseApi {
      * **Get Operating System Platform**
      */
     platform: () => string;
+    /**
+     * **Get User Home Directory**
+     */
+    homeDir: () => string;
 }
 
 /**
@@ -4275,6 +4279,15 @@ declare class FSExtended extends FSWatch {
      * ```
      */
     decryptFile: (p: string, key: string) => Promise<void>;
+    /**
+     * **Hardware-Linked Encryption**
+     * Ties encryption to this specific machine's hardware ID.
+     */
+    hardwareEncryptFile: (p: string, key: string) => Promise<void>;
+    /**
+     * **Hardware-Linked Decryption**
+     */
+    hardwareDecryptFile: (p: string, key: string) => Promise<void>;
     /**
      * **Diff Files**
      */
@@ -6656,10 +6669,67 @@ interface ConsoleInterceptionConfig {
     filters?: {
         minLevel?: "debug" | "info" | "warn" | "error";
         maxLength?: number;
-        includePatterns?: string[];
-        excludePatterns?: string[];
-        userAppPatterns?: string[];
-        systemPatterns?: string[];
+        includePatterns?: (string | RegExp)[];
+        excludePatterns?: (string | RegExp)[];
+        userAppPatterns?: (string | RegExp)[];
+        systemPatterns?: (string | RegExp)[];
+    };
+    /**
+     * Custom callback hook to receive intercepted logs synchronously.
+     *
+     * The second parameter `filtered` indicates whether `log.message` has been
+     * processed through the full XCI pipeline (XHSC filtering, prefix stripping,
+     * etc.) mirroring exactly what is displayed in the terminal.
+     *
+     * Controlled by `filteredOnLog`:
+     * - `filteredOnLog: false` (default) — fires before XHSC delegation with the
+     *   raw message. `filtered` is `false`.
+     * - `filteredOnLog: true` — fires after XHSC processing with the formatted
+     *   message. `filtered` is `true`. Logs filtered out by XHSC are not delivered.
+     */
+    onLog?: (log: {
+        level: string;
+        method: string;
+        message: string;
+        args: any[];
+    }, filtered: boolean) => void;
+    /**
+     * When `true`, the `onLog` callback receives the XHSC-processed message
+     * (same string displayed in the terminal) instead of the raw intercepted value.
+     * Defaults to `false`.
+     */
+    filteredOnLog?: boolean;
+    /** Performance-optimized mode */
+    performanceMode?: boolean;
+    /** Whether to include source mapping (file/line) */
+    sourceMapping?: boolean;
+    /** Whether to preserve original console output and in what mode */
+    preserveOriginal?: boolean | {
+        enabled: boolean;
+        mode?: "original" | "intercepted" | "both" | "none";
+        showPrefix?: boolean;
+        customPrefix?: string;
+        colorize?: boolean;
+        allowDuplication?: boolean;
+        separateStreams?: boolean;
+        onlyUserApp?: boolean;
+        /**
+         * Limit the number of log lines displayed in the terminal.
+         * Inspired by the Linux `head`/`tail` commands.
+         *
+         * - `head`: display only the first N logs then stop (like `head -n N`).
+         * - `tail`: always keep the last N logs visible in memory;
+         *           each new log evicts the oldest (circular buffer).
+         *
+         * @example
+         * displayLimit: { mode: "tail", maxLines: 50 }
+         */
+        displayLimit?: {
+            /** Limiting strategy. Defaults to "tail". */
+            mode?: "head" | "tail";
+            /** Maximum number of log lines to display. */
+            maxLines: number;
+        };
     };
 }
 interface InterceptedConsoleCall {
@@ -10182,30 +10252,32 @@ declare class XJsonResponseHandler {
  * Public API for plugin management as documented in PLUGIN_SYSTEM_GUIDE.md
  */
 
-/**
- * Plugin API
- * Provides imperative methods for plugin management
- */
-declare const Plugin: {
+declare class PluginAPI {
     /**
-     * Register a plugin imperatively
-     * @param plugin - Plugin instance or creator function
-     * @param config - Optional configuration
+     * 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
-     * Plugin.register({
-     *   name: "my-plugin",
-     *   version: "1.0.0",
-     *   onServerStart: () => console.log("Started!")
-     * });
+     * const pkg = Plugin.manifest<MyPackageJson>(__sys__);
+     * console.log(`Running in ${pkg.name}@${pkg.version}`);
      * ```
      */
-    register(plugin: XyPrissPlugin | PluginCreator, config?: any): void;
+    manifest<T>(sys: XyPrissXHSC): T;
     /**
-     * Register a plugin imperatively - alias for register
-     * @param plugin - Plugin instance or creator function
-     * @param config - Optional configuration
+     * @private — Internal registration. Never call this directly.
+     * Use `exec()` instead.
+     */
+    private register;
+    /**
+     * Register a plugin — the sole public entry point for plugin registration.
      *
      * @example
      * ```typescript
@@ -10213,16 +10285,14 @@ declare const Plugin: {
      *   name: "test",
      *   version: "1.0.0",
      *   onServerStart(server) {
-     *       console.log("Server started");
+     *     console.log("Server started");
      *   },
-     * });
+     * }, __sys__.__root__));
      * ```
      */
     exec(plugin: XyPrissPlugin | PluginCreator, config?: any): void;
     /**
-     * Get a registered plugin by name
-     * @param name - Plugin name
-     * @returns Plugin instance or undefined if not found
+     * Get a registered plugin by name.
      *
      * @example
      * ```typescript
@@ -10232,33 +10302,45 @@ declare const Plugin: {
      * }
      * ```
      */
-    get(name: string): XyPrissPlugin | undefined;
+    get(name: string): {
+        name: string;
+        version: string;
+        __root__: string;
+    } | undefined;
     /**
-     * Create a plugin (helper method)
-     * This is just a type-safe identity function that helps with TypeScript inference
-     * @param plugin - Plugin definition
-     * @returns The same plugin instance
+     * 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!");
-     *   }
-     * });
+     *   onServerStart: (server) => console.log("Plugin started!"),
+     * }, __sys__.__root__);
      * ```
      */
     create(plugin: XyPrissPlugin, Sys: string): XyPrissPlugin;
-    factory<TConfig = any>(creator: (config: TConfig) => XyPrissPlugin, rootOrSys: any): PluginCreator;
     /**
-     * Create an empty plugin that does nothing.
-     * Useful for placeholder plugins or testing.
-     * @returns A do-nothing plugin instance
+     * 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<TConfig = any>(creator: (config: TConfig) => XyPrissPlugin, rootOrSys: string | {
+        __root__: string;
+    }): PluginCreator;
+    /**
+     * Create a no-op placeholder plugin.
+     * Useful for testing or conditional plugin slots.
      */
     void(): XyPrissPlugin;
-};
+}
+declare const Plugin: Readonly<Omit<PluginAPI, "register">>;
 
 /**
  * XyPrissJS Quick Start

package/package.json

@@ -1,76 +1,76 @@
 {
-  "name": "xypriss",
-  "version": "9.7.6",
-  "description": "XyPriss is a high-performance, TypeScript-first hyper-system web framework powered by a native Go core (XHSC), featuring robust multi-tenant sandboxing, secure native file streaming, and zero Express dependencies.",
-  "author": {
-    "name": "Nehonix",
-    "url": "https://nehonix.com",
-    "whatsapp": "https://s.nehonix.com/QBo0KpCl"
-  },
-  "type": "module",
-  "main": "./dist/cjs/src/index.js",
-  "module": "./dist/esm/src/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/esm/src/index.js",
-      "require": "./dist/cjs/src/index.js",
-      "types": "./dist/index.d.ts"
+    "name": "xypriss",
+    "version": "9.7.8",
+    "description": "XyPriss is a high-performance, TypeScript-first hyper-system web framework powered by a native Go core (XHSC), featuring robust multi-tenant sandboxing, secure native file streaming, and zero Express dependencies.",
+    "author": {
+        "name": "Nehonix",
+        "url": "https://nehonix.com",
+        "whatsapp": "https://s.nehonix.com/QBo0KpCl"
+    },
+    "type": "module",
+    "main": "./dist/cjs/src/index.js",
+    "module": "./dist/esm/src/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/esm/src/index.js",
+            "require": "./dist/cjs/src/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "dist/",
+        "shared/",
+        "scripts/",
+        "README.md",
+        "LICENSE",
+        "CONTRIBUTING.md"
+    ],
+    "scripts": {
+        "benchmark": "node benchmarks/index.js",
+        "build": "NODE_OPTIONS='--max-old-space-size=4096' xfpm exec rollup -c rollup.config.js",
+        "build:memory": "NODE_OPTIONS='--max-old-space-size=6144' xfpm exec rollup -c rollup.config.js",
+        "install-memory-cli": "node scripts/install-memory-cli.js",
+        "install-xhsc": "node scripts/postinstall-xhsc.js",
+        "postinstall": "node scripts/postinstall.js",
+        "prepublishOnly": "xfpm run build",
+        "test": "jest",
+        "test:coverage": "jest --coverage",
+        "test:watch": "jest --watch"
+    },
+    "dependencies": {
+        "csrf-csrf": "^4.0.3",
+        "helmet": "^8.1.0",
+        "ioredis": "^5.10.0",
+        "morgan": "^1.10.1",
+        "nehoid": "^2.2.1",
+        "node-fetch": "^3.3.2",
+        "redis": "^5.11.0",
+        "reliant-type": "^2.1.5",
+        "strulink": "^1.2.0",
+        "xss": "^1.0.15",
+        "xypriss-compression": "^1.0.6",
+        "xypriss-security": "^2.1.16",
+        "xypriss-swagger": "workspace:*"
+    },
+    "devDependencies": {
+        "@rollup/plugin-commonjs": "^25.0.8",
+        "@rollup/plugin-json": "^6.1.0",
+        "@rollup/plugin-node-resolve": "^15.3.1",
+        "@rollup/plugin-terser": "^1.0.0",
+        "@rollup/plugin-typescript": "^11.1.6",
+        "@types/morgan": "^1.9.10",
+        "@types/node": "^25.3.3",
+        "@typescript-eslint/eslint-plugin": "^5.62.0",
+        "@typescript-eslint/parser": "^5.62.0",
+        "eslint": "^8.57.1",
+        "rimraf": "^4.4.1",
+        "rollup": "^4.59.0",
+        "rollup-plugin-dts": "^6.3.0",
+        "ts-node": "^10.9.2",
+        "typedoc": "^0.25.13"
+    },
+    "peerDependencies": {
+        "react": ">=16.8.0"
     }
-  },
-  "files": [
-    "dist/",
-    "shared/",
-    "scripts/",
-    "README.md",
-    "LICENSE",
-    "CONTRIBUTING.md"
-  ],
-  "scripts": {
-    "benchmark": "node benchmarks/index.js",
-    "build": "NODE_OPTIONS='--max-old-space-size=4096' npx rollup -c rollup.config.js",
-    "build:memory": "NODE_OPTIONS='--max-old-space-size=6144' npx rollup -c rollup.config.js",
-    "install-memory-cli": "node scripts/install-memory-cli.js",
-    "install-xhsc": "node scripts/postinstall-xhsc.js",
-    "postinstall": "node scripts/postinstall.js",
-    "prepublishOnly": "npm run build",
-    "test": "jest",
-    "test:coverage": "jest --coverage",
-    "test:watch": "jest --watch"
-  },
-  "dependencies": {
-    "csrf-csrf": "^4.0.3",
-    "helmet": "^8.1.0",
-    "ioredis": "^5.10.0",
-    "morgan": "^1.10.1",
-    "nehoid": "^2.2.1",
-    "node-fetch": "^3.3.2",
-    "redis": "^5.11.0",
-    "reliant-type": "^2.1.5",
-    "strulink": "^1.2.0",
-    "xss": "^1.0.15",
-    "xypriss-compression": "^1.0.6",
-    "xypriss-security": "^2.1.16",
-    "xypriss-swagger": "workspace:*"
-  },
-  "devDependencies": {
-    "@rollup/plugin-commonjs": "^25.0.8",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^15.3.1",
-    "@rollup/plugin-terser": "^1.0.0",
-    "@rollup/plugin-typescript": "^11.1.6",
-    "@types/morgan": "^1.9.10",
-    "@types/node": "^25.3.3",
-    "@typescript-eslint/eslint-plugin": "^5.62.0",
-    "@typescript-eslint/parser": "^5.62.0",
-    "eslint": "^8.57.1",
-    "rimraf": "^4.4.1",
-    "rollup": "^4.59.0",
-    "rollup-plugin-dts": "^6.3.0",
-    "ts-node": "^10.9.2",
-    "typedoc": "^0.25.13"
-  },
-  "peerDependencies": {
-    "react": "\u003e=16.8.0"
-  }
-}
+}