xypriss 9.10.19 → 9.10.21

package/dist/src/xhsc/api/env/env.d.ts

@@ -1,218 +0,0 @@
-export declare const XY_ENV_STORE_KEY: unique symbol;
-export declare const XY_XHSC_REGISTER_FS: unique symbol;
-/** Characters that are unconditionally rejected in environment variable values. */
-export declare const FORBIDDEN_VALUE_PATTERN: RegExp;
-/**
- * Represents the result of a bulk environment variable retrieval.
- *
- * The object is frozen at the moment of creation. Keys map to their
- * corresponding string values, or `undefined` if the key was requested via
- * `options.keys` but was not present in the store.
- */
-export type EnvSnapshot = Readonly<Record<string, string | undefined>>;
-/**
- * Options accepted by {@link EnvApi.getStrict} to control validation behaviour.
- */
-export interface EnvGetStrictOptions {
-    /**
-     * When `true`, an empty string is treated as a missing value and triggers
-     * the same {@link EnvAccessError} as a completely absent key.
-     *
-     * @default false
-     */
-    rejectEmpty?: boolean;
-}
-/**
- * Options accepted by {@link EnvApi.all}.
- */
-export interface EnvAllOptions {
-    /**
-     * Restricts the snapshot to the listed keys. Keys absent from the store
-     * are included with value `undefined`. When omitted, all stored keys are
-     * returned.
-     *
-     * Providing an explicit key list is strongly preferred in production code
-     * to avoid accidentally surfacing secrets in logs or serialised payloads.
-     *
-     * @example
-     * const subset = __sys__.__env__.all({
-     *   keys: ["DATABASE_URL", "REDIS_URL"],
-     * });
-     */
-    keys?: string[];
-}
-/**
- * Thrown by {@link EnvApi.getStrict} when a required environment variable is
- * absent or — when `rejectEmpty` is set — when it is present but empty.
- *
- * @example
- * try {
- *   const dbUrl = __sys__.__env__.getStrict("DATABASE_URL");
- * } catch (err) {
- *   if (err instanceof EnvAccessError) {
- *     process.exit(1); // Fail fast on missing critical configuration
- *   }
- * }
- */
-export declare class EnvAccessError extends Error {
-    /** The variable name that could not be resolved. */
-    readonly key: string;
-    constructor(key: string, reason: "missing" | "empty");
-}
-/**
- * Thrown by {@link EnvApi.set} when the key or value fails validation.
- *
- * @example
- * try {
- *   __sys__.__env__.set("", "value");        // empty key
- *   __sys__.__env__.set("FOO", "bar\nbaz");  // newline injection attempt
- * } catch (err) {
- *   if (err instanceof EnvKeyError) {
- *     logger.error("Invalid env write", { key: err.key, reason: err.message });
- *   }
- * }
- */
-export declare class EnvKeyError extends Error {
-    readonly key: string;
-    constructor(key: string, reason: string);
-}
-/**
- * Thrown when {@link EnvApi} methods are called before the internal store has
- * been initialised by the XyPriss bootstrap process.
- *
- * This error should never occur in correctly bootstrapped applications.
- * If it does, it indicates that framework initialisation was bypassed.
- */
-export declare class EnvStoreError extends Error {
-    constructor();
-}
-/**
- * Public contract for the XyPriss Environment Manager.
- *
- * All access to environment variables within XyPriss applications must go
- * through this interface. Direct use of `process.env` is blocked by the
- * Environment Security Shield and returns `undefined` at runtime.
- *
- * @see {@link EnvApi} for the concrete implementation.
- *
- * @example
- * // Reading with a fallback
- * const port = __sys__.__env__.get("PORT", "3000");
- *
- * // Reading a required variable — throws EnvAccessError if absent
- * const secret = __sys__.__env__.getStrict("JWT_SECRET");
- *
- * // Checking the execution mode
- * if (__sys__.__env__.isProduction()) {
- *   // Apply production hardening
- * }
- */
-export interface IEnvApi {
-    /**
-     * The current execution mode (`"development"`, `"production"`,
-     * `"staging"`, `"test"`, or a custom value). Set once at bootstrap;
-     * never mutated at runtime.
-     */
-    readonly mode: string;
-    /**
-     * Writes an environment variable to the secure internal store.
-     *
-     * @param key   - Non-empty variable name without surrounding whitespace.
-     * @param value - The value to assign. Must not contain CR, LF, or NUL.
-     * @throws {EnvKeyError} When the key or value fails validation.
-     * @throws {EnvStoreError} When called before store initialisation.
-     */
-    set(key: string, value: string): void;
-    /**
-     * Reads an environment variable from the secure internal store.
-     *
-     * @param key          - The variable name to look up.
-     * @param defaultValue - Returned when the key is not defined.
-     * @returns The stored value, or `defaultValue` / `undefined`.
-     * @throws {EnvStoreError} When called before store initialisation.
-     *
-     * @example
-     * const host = __sys__.__env__.get("HOST", "0.0.0.0");
-     */
-    get(key: string): string | undefined;
-    get(key: string, defaultValue: string): string;
-    get(key: string, defaultValue?: string): string | undefined;
-    /**
-     * Reads a required environment variable. Throws when absent.
-     *
-     * @param key     - The variable name to look up.
-     * @param options - Optional validation settings.
-     * @returns The stored value as a guaranteed non-undefined string.
-     * @throws {EnvAccessError} When the variable is missing or empty.
-     * @throws {EnvStoreError} When called before store initialisation.
-     *
-     * @example
-     * const dbUrl    = __sys__.__env__.getStrict("DATABASE_URL");
-     * const jwtKey   = __sys__.__env__.getStrict("JWT_SECRET", { rejectEmpty: true });
-     */
-    getStrict(key: string, options?: EnvGetStrictOptions): string;
-    /**
-     * Returns `true` when the variable is present in the store, regardless of
-     * its value (including empty strings).
-     *
-     * @throws {EnvStoreError} When called before store initialisation.
-     *
-     * @example
-     * if (__sys__.__env__.has("SENTRY_DSN")) {
-     *   Sentry.init({ dsn: __sys__.__env__.get("SENTRY_DSN") });
-     * }
-     */
-    has(key: string): boolean;
-    /**
-     * Removes a variable from the secure internal store and from `process.env`.
-     * Deleting a non-existent key is a no-op.
-     *
-     * @throws {EnvStoreError} When called before store initialisation.
-     *
-     * @example
-     * __sys__.__env__.delete("CI_DEPLOY_TOKEN");
-     */
-    delete(key: string): void;
-    /**
-     * Returns a frozen, point-in-time snapshot of stored variables.
-     *
-     * Providing `options.keys` is strongly recommended in production to avoid
-     * accidentally capturing secrets in logs or serialised payloads.
-     *
-     * @throws {EnvStoreError} When called before store initialisation.
-     *
-     * @example
-     * const dbConfig = __sys__.__env__.all({
-     *   keys: ["DATABASE_URL", "DATABASE_POOL_SIZE"],
-     * });
-     */
-    all(options?: EnvAllOptions): EnvSnapshot;
-    /** Returns `true` when the current execution mode is `"production"`. */
-    isProduction(): boolean;
-    /** Returns `true` when the current execution mode is `"development"`. */
-    isDevelopment(): boolean;
-    /** Returns `true` when the current execution mode is `"staging"`. */
-    isStaging(): boolean;
-    /** Returns `true` when the current execution mode is `"test"`. */
-    isTest(): boolean;
-    /**
-     * Returns `true` when the execution mode matches `envName` exactly
-     * (case-sensitive). Useful for custom environments beyond the four presets.
-     *
-     * @example
-     * if (__sys__.__env__.is("canary")) {
-     *   featureFlags.enableAll();
-     * }
-     */
-    is(envName: string): boolean;
-    /**
-     * Returns the OS-level username of the process owner, resolved via the
-     * XHSC native binary. Returns `""` on failure.
-     *
-     * @example
-     * const actor = __sys__.__env__.user() || "<unknown>";
-     * auditLog.write({ actor, action: "deploy" });
-     */
-    user(): string;
-}
-//# sourceMappingURL=env.d.ts.map

package/dist/src/xhsc/api/env/env.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../../src/xhsc/api/env/env.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAC3D,eAAO,MAAM,mBAAmB,eAAoC,CAAC;AASrE,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,QAAa,CAAC;AAMlD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACrC,oDAAoD;IACpD,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAEhB,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO;CAYvD;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAClC,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAEhB,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM1C;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,KAAK;;CASvC;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,OAAO;IACpB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAE5D;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAC;IAE9D;;;;;;;;;;OAUG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1B;;;;;;;;OAQG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW,CAAC;IAE1C,wEAAwE;IACxE,YAAY,IAAI,OAAO,CAAC;IAExB,yEAAyE;IACzE,aAAa,IAAI,OAAO,CAAC;IAEzB,qEAAqE;IACrE,SAAS,IAAI,OAAO,CAAC;IAErB,kEAAkE;IAClE,MAAM,IAAI,OAAO,CAAC;IAElB;;;;;;;;OAQG;IACH,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B;;;;;;;OAOG;IACH,IAAI,IAAI,MAAM,CAAC;CAClB"}

package/dist/src/xhsc/api/env/env.js

@@ -1,84 +0,0 @@
-// ---------------------------------------------------------------------------
-// Internal store key — never exported.
-//
-// Using a module-scoped Symbol as the globalThis property key means that
-// external code cannot access the store without a reference to this exact
-// Symbol. There is no string key to guess or enumerate.
-//
-// SECURITY: Do not export or expose this Symbol through any public API.
-// ---------------------------------------------------------------------------
-export const XY_ENV_STORE_KEY = Symbol("__xy_env_store__");
-export const XY_XHSC_REGISTER_FS = Symbol("__xy_xhsc_register_fs__");
-// ---------------------------------------------------------------------------
-// Internal value sanitisation
-//
-// Detects byte sequences that can corrupt downstream parsers, log sinks, or
-// serialisers when stored as environment variable values.
-// ---------------------------------------------------------------------------
-/** Characters that are unconditionally rejected in environment variable values. */
-export const FORBIDDEN_VALUE_PATTERN = /[\r\n\0]/;
-// ---------------------------------------------------------------------------
-// Errors
-// ---------------------------------------------------------------------------
-/**
- * Thrown by {@link EnvApi.getStrict} when a required environment variable is
- * absent or — when `rejectEmpty` is set — when it is present but empty.
- *
- * @example
- * try {
- *   const dbUrl = __sys__.__env__.getStrict("DATABASE_URL");
- * } catch (err) {
- *   if (err instanceof EnvAccessError) {
- *     process.exit(1); // Fail fast on missing critical configuration
- *   }
- * }
- */
-export class EnvAccessError extends Error {
-    constructor(key, reason) {
-        super(reason === "empty"
-            ? `Environment variable "${key}" is set but contains an empty value. ` +
-                `Use __sys__.__env__.get("${key}") if an empty value is acceptable.`
-            : `Required environment variable "${key}" is not defined. ` +
-                `Ensure it is present in your .env file or execution environment.`);
-        this.name = "EnvAccessError";
-        this.key = key;
-        Object.setPrototypeOf(this, EnvAccessError.prototype);
-    }
-}
-/**
- * Thrown by {@link EnvApi.set} when the key or value fails validation.
- *
- * @example
- * try {
- *   __sys__.__env__.set("", "value");        // empty key
- *   __sys__.__env__.set("FOO", "bar\nbaz");  // newline injection attempt
- * } catch (err) {
- *   if (err instanceof EnvKeyError) {
- *     logger.error("Invalid env write", { key: err.key, reason: err.message });
- *   }
- * }
- */
-export class EnvKeyError extends Error {
-    constructor(key, reason) {
-        super(`Invalid environment variable "${key}": ${reason}`);
-        this.name = "EnvKeyError";
-        this.key = key;
-        Object.setPrototypeOf(this, EnvKeyError.prototype);
-    }
-}
-/**
- * Thrown when {@link EnvApi} methods are called before the internal store has
- * been initialised by the XyPriss bootstrap process.
- *
- * This error should never occur in correctly bootstrapped applications.
- * If it does, it indicates that framework initialisation was bypassed.
- */
-export class EnvStoreError extends Error {
-    constructor() {
-        super("The XyPriss environment store has not been initialised. " +
-            "Ensure that createServer() has completed before accessing __sys__.__env__.");
-        this.name = "EnvStoreError";
-        Object.setPrototypeOf(this, EnvStoreError.prototype);
-    }
-}
-//# sourceMappingURL=env.js.map

package/dist/src/xhsc/api/env/env.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../../../src/xhsc/api/env/env.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uCAAuC;AACvC,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,wDAAwD;AACxD,EAAE;AACF,wEAAwE;AACxE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAErE,8EAA8E;AAC9E,8BAA8B;AAC9B,EAAE;AACF,4EAA4E;AAC5E,0DAA0D;AAC1D,8EAA8E;AAE9E,mFAAmF;AACnF,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAgDlD,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAIrC,YAAY,GAAW,EAAE,MAA2B;QAChD,KAAK,CACD,MAAM,KAAK,OAAO;YACd,CAAC,CAAC,yBAAyB,GAAG,wCAAwC;gBAChE,4BAA4B,GAAG,qCAAqC;YAC1E,CAAC,CAAC,kCAAkC,GAAG,oBAAoB;gBACrD,kEAAkE,CAC/E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACJ;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGlC,YAAY,GAAW,EAAE,MAAc;QACnC,KAAK,CAAC,iCAAiC,GAAG,MAAM,MAAM,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACJ;AAED;;;;;;GAMG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACpC;QACI,KAAK,CACD,0DAA0D;YACtD,4EAA4E,CACnF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACJ"}

package/dist/src/xhsc/cluster/XHSCWorker.d.ts

@@ -1,28 +0,0 @@
-import { XyprissApp } from "../../server/core/XyprissApp";
-/**
- * XHSCWorker - A Node.js worker instance that connects to the Go (XHSC) IPC server.
- * This is used when XyPriss is running in Clustering mode managed by Go.
- */
-export declare class XHSCWorker {
-    private app;
-    private socket;
-    private logger;
-    private workerId;
-    private ipcPath;
-    constructor(app: XyprissApp);
-    /**
-     * Connect to the Go IPC Server and start handling requests.
-     */
-    connect(): Promise<void>;
-    private register;
-    private syncRoutes;
-    private handleData;
-    private dispatchToApp;
-    private sendMessage;
-    /**
-     * Delegate a static file response to the Go (XHSC) engine.
-     * This uses zero-copy streaming via sendfile() in Go.
-     */
-    delegateStatic(requestId: string, filePath: string): void;
-}
-//# sourceMappingURL=XHSCWorker.d.ts.map

package/dist/src/xhsc/cluster/XHSCWorker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"XHSCWorker.d.ts","sourceRoot":"","sources":["../../../../src/xhsc/cluster/XHSCWorker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI1D;;;GAGG;AACH,qBAAa,UAAU;IAMP,OAAO,CAAC,GAAG;IALvB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEJ,GAAG,EAAE,UAAU;IAOnC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgErC,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,UAAU;IAoClB,OAAO,CAAC,UAAU;YAkDJ,aAAa;IAuC3B,OAAO,CAAC,WAAW;IAWnB;;;OAGG;IACI,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAUnE"}

package/dist/src/xhsc/cluster/XHSCWorker.js

@@ -1,192 +0,0 @@
-import * as net from "node:net";
-import { initializeLogger } from "../../shared/logger/Logger";
-import { Configs } from "../../ConfigurationManager";
-import { XHSCRequest, XHSCResponse } from "../../server/core/XHSCProtocol";
-import { SUPPORTED_HTTP_METHODS } from "../../server/const/http";
-/**
- * XHSCWorker - A Node.js worker instance that connects to the Go (XHSC) IPC server.
- * This is used when XyPriss is running in Clustering mode managed by Go.
- */
-export class XHSCWorker {
-    constructor(app) {
-        this.app = app;
-        this.socket = null;
-        this.logger =
-            app.logger || initializeLogger(Configs.get("logging"));
-        this.workerId = process.env.XYPRISS_WORKER_ID || "unknown";
-        this.ipcPath = process.env.XYPRISS_IPC_PATH || "";
-    }
-    /**
-     * Connect to the Go IPC Server and start handling requests.
-     */
-    async connect() {
-        if (!this.ipcPath) {
-            throw new Error("XYPRISS_IPC_PATH environment variable is not set");
-        }
-        this.logger.info("cluster", `Worker ${this.workerId} connecting to XHSC IPC.`);
-        this.logger.debug("cluster", `Worker ${this.workerId} connecting to XHSC IPC at ${this.ipcPath}...`);
-        return new Promise((resolve, reject) => {
-            let retries = 0;
-            const maxRetries = 10;
-            const retryDelay = 200;
-            const tryConnect = () => {
-                this.socket = net.connect(this.ipcPath, () => {
-                    this.logger.info("cluster", `Worker ${this.workerId} connected to XHSC`);
-                    // Expose this worker to the app for delegation
-                    this.app._xhscWorker = this;
-                    this.register();
-                    resolve();
-                });
-                this.socket.on("error", (err) => {
-                    if (err.code === "ENOENT" && retries < maxRetries) {
-                        retries++;
-                        this.logger.debug("cluster", `Worker ${this.workerId} IPC socket not ready, retrying in ${retryDelay}ms... (${retries}/${maxRetries})`);
-                        setTimeout(tryConnect, retryDelay);
-                        return;
-                    }
-                    this.logger.error("cluster", `Worker ${this.workerId} IPC error: ${err.message}`);
-                    reject(err);
-                });
-                this.socket.on("close", () => {
-                    this.logger.warn("cluster", `Worker ${this.workerId} IPC connection closed`);
-                    process.exit(1); // Exit so Go can respawn us
-                });
-                this.handleData();
-            };
-            tryConnect();
-        });
-    }
-    register() {
-        const message = {
-            type: "RegisterWorker",
-            payload: { id: this.workerId },
-        };
-        this.sendMessage(message);
-        this.syncRoutes();
-    }
-    syncRoutes() {
-        const httpServer = this.app.httpServer;
-        if (!httpServer)
-            return;
-        const routes = httpServer.getRoutes();
-        const payload = routes.map((r) => ({
-            method: r.method,
-            path: typeof r.path === "string" ? r.path : r.path.source,
-            target: r.target || "worker",
-            file_path: r.filePath,
-        }));
-        // Add catch-all routes for any unhandled paths to be sent to Node.js 404 handler
-        // This ensures NotFoundHandler.ts can handle unknown routes even with XHSC engine
-        const notFoundCfg = Configs.get("notFound");
-        if (notFoundCfg?.enabled !== false) {
-            for (const method of SUPPORTED_HTTP_METHODS) {
-                payload.push({
-                    method: method,
-                    path: "/(.*)", // Catch-all regex pattern
-                    target: "worker",
-                    file_path: "",
-                });
-            }
-            this.logger.debug("cluster", `Worker ${this.workerId}: Synced 404 catch-all routes for handled methods`);
-        }
-        this.sendMessage({
-            type: "SyncRoutes",
-            payload: payload,
-        });
-    }
-    handleData() {
-        let buffer = Buffer.alloc(0);
-        this.socket.on("data", async (data) => {
-            buffer = Buffer.concat([buffer, data]);
-            while (buffer.length >= 4) {
-                const size = buffer.readUInt32BE(0);
-                if (buffer.length >= 4 + size) {
-                    const payload = buffer.slice(4, 4 + size);
-                    buffer = buffer.slice(4 + size);
-                    try {
-                        const message = JSON.parse(payload.toString());
-                        if (message.type === "Request") {
-                            await this.dispatchToApp(message.payload);
-                        }
-                        else if (message.type === "Ping") {
-                            this.sendMessage({ type: "Pong", payload: {} });
-                        }
-                        else if (message.type === "ForceGC") {
-                            this.logger.info("cluster", `Worker ${this.workerId} received ForceGC signal`);
-                            if (global.gc) {
-                                global.gc();
-                                this.logger.info("cluster", `Worker ${this.workerId} executed GC`);
-                            }
-                            else {
-                                this.logger.warn("cluster", `Worker ${this.workerId} ignores ForceGC (GC not exposed)`);
-                            }
-                        }
-                    }
-                    catch (e) {
-                        this.logger.error("cluster", "Worker payload parse error", e);
-                    }
-                }
-                else {
-                    break;
-                }
-            }
-        });
-    }
-    async dispatchToApp(payload) {
-        const { id, method, url } = payload;
-        this.logger.debug("cluster", `Worker ${this.workerId}: Handling ${method} ${url} (ID: ${id})`);
-        // Create Real Request Implementation
-        const req = new XHSCRequest(payload, this.socket);
-        req.app = this.app;
-        // Create Real Response Implementation
-        const res = new XHSCResponse(req, (bodyData, statusCode, headers) => {
-            const response = {
-                type: "Response",
-                payload: {
-                    id,
-                    status: statusCode,
-                    headers: headers,
-                    body: bodyData ? bodyData.toString("base64") : null,
-                },
-            };
-            this.sendMessage(response);
-        });
-        try {
-            const httpServer = this.app.httpServer;
-            if (httpServer) {
-                await httpServer.handleRequest(req, res);
-            }
-            else {
-                res.statusCode = 500;
-                res.end("Worker Error: App not initialized");
-            }
-        }
-        catch (err) {
-            this.logger.error("cluster", `Worker handling error: ${err}`);
-        }
-    }
-    sendMessage(message) {
-        const payload = Buffer.from(JSON.stringify(message));
-        const size = Buffer.alloc(4);
-        size.writeUInt32BE(payload.length, 0);
-        if (this.socket && !this.socket.destroyed) {
-            this.socket.write(size);
-            this.socket.write(payload);
-        }
-    }
-    /**
-     * Delegate a static file response to the Go (XHSC) engine.
-     * This uses zero-copy streaming via sendfile() in Go.
-     */
-    delegateStatic(requestId, filePath) {
-        const message = {
-            type: "XStatic",
-            payload: {
-                id: requestId,
-                path: filePath,
-            },
-        };
-        this.sendMessage(message);
-    }
-}
-//# sourceMappingURL=XHSCWorker.js.map

package/dist/src/xhsc/cluster/XHSCWorker.js.map

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

package/dist/src/xhsc/cmdr.d.ts

@@ -1,9 +0,0 @@
-/**
- * Interface representing the result of a system command response from xhsc.
- */
-export interface CommandResult<T = any> {
-    status: "ok" | "error";
-    data?: T;
-    message?: string;
-}
-//# sourceMappingURL=cmdr.d.ts.map

package/dist/src/xhsc/cmdr.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cmdr.d.ts","sourceRoot":"","sources":["../../../src/xhsc/cmdr.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG;IAClC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/src/xhsc/cmdr.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=cmdr.js.map

package/dist/src/xhsc/cmdr.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cmdr.js","sourceRoot":"","sources":["../../../src/xhsc/cmdr.ts"],"names":[],"mappings":""}

package/dist/src/xhsc/fs/FSArchive.d.ts

@@ -1,55 +0,0 @@
-import { FSSearch } from "./FSSearch";
-/**
- * **Filesystem Archive & Compression**
- */
-export declare class FSArchive extends FSSearch {
-    /**
-     * **File Compression (Gzip)**
-     *
-     * Performs lossless compression on a file using the Gzip algorithm.
-     *
-     * @param {string} src - Source file path.
-     * @param {string} dest - Destination path for the compressed file (e.g., 'data.gz').
-     *
-     * @example
-     * __sys__.fs.compress("backup.sql", "backup.sql.gz");
-     */
-    compress: (src: string, dest: string) => void;
-    /**
-     * **File Decompression**
-     *
-     * Extracts a compressed file back to its original state.
-     *
-     * @param {string} src - Path to the compressed file.
-     * @param {string} dest - Destination path for the extracted file.
-     *
-     * @example
-     * __sys__.fs.decompress("data.gz", "data.json");
-     */
-    decompress: (src: string, dest: string) => void;
-    /**
-     * **Tarball Creation**
-     *
-     * Bundles a directory or file into a single TAR archive.
-     *
-     * @param {string} dir - Directory to archive.
-     * @param {string} output - Destination path for the .tar file.
-     *
-     * @example
-     * __sys__.fs.tar("./src", "project_source.tar");
-     */
-    tar: (dir: string, output: string) => void;
-    /**
-     * **Tarball Extraction**
-     *
-     * Extracts the contents of a TAR archive into a specified directory.
-     *
-     * @param {string} archive - Path to the .tar file.
-     * @param {string} dest - Destination directory for extraction.
-     *
-     * @example
-     * __sys__.fs.untar("dist.tar", "./production");
-     */
-    untar: (archive: string, dest: string) => void;
-}
-//# sourceMappingURL=FSArchive.d.ts.map

package/dist/src/xhsc/fs/FSArchive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FSArchive.d.ts","sourceRoot":"","sources":["../../../../src/xhsc/fs/FSArchive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;GAEG;AACH,qBAAa,SAAU,SAAQ,QAAQ;IACnC;;;;;;;;;;OAUG;IACI,QAAQ,QAAS,MAAM,QAAQ,MAAM,KAAG,IAAI,CAEjD;IAEF;;;;;;;;;;OAUG;IACI,UAAU,QAAS,MAAM,QAAQ,MAAM,KAAG,IAAI,CAEnD;IAEF;;;;;;;;;;OAUG;IACI,GAAG,QAAS,MAAM,UAAU,MAAM,KAAG,IAAI,CAE9C;IAEF;;;;;;;;;;OAUG;IACI,KAAK,YAAa,MAAM,QAAQ,MAAM,KAAG,IAAI,CAElD;CACL"}