xypriss 9.10.19 → 9.10.21

package/dist/src/xhsc/utils/StringUtils.js

@@ -1,141 +0,0 @@
-/**
- * **StringUtils — XyPriss String Utilities**
- */
-export class StringUtils {
-    /**
-     * **Generate a Random String**
-     *
-     * Generates a pseudo-random character sequence of a specified length.
-     * Uses alphanumeric characters (A-Z, a-z, 0-9).
-     *
-     * @param length - The desired length of the string (default: `10`).
-     * @returns A random alphanumeric string.
-     *
-     * @example
-     * ```ts
-     * utils.randomString(8); // "a7B2k9Xz"
-     * ```
-     */
-    randomString(length = 10) {
-        const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-        let result = "";
-        for (let i = 0; i < length; i++) {
-            result += chars.charAt(Math.floor(Math.random() * chars.length));
-        }
-        return result;
-    }
-    /**
-     * **Slugify a String**
-     *
-     * Converts a string into a URL-friendly "slug" by lowering case,
-     * removing non-alphanumeric characters, and replacing spaces with hyphens.
-     *
-     * @param text - The string to slugify.
-     * @returns The URL-friendly slug.
-     *
-     * @example
-     * ```ts
-     * utils.slugify("Hello World!"); // "hello-world"
-     * ```
-     */
-    slugify(text) {
-        return text
-            .toLowerCase()
-            .trim()
-            .replace(/[^\w\s-]/g, "")
-            .replace(/[\s_-]+/g, "-")
-            .replace(/^-+|-+$/g, "");
-    }
-    /**
-     * **Truncate a String**
-     *
-     * Shortens a string to a specified length and appends a suffix (default: `...`)
-     * if the original string was longer than the limit.
-     *
-     * @param text      - The string to truncate.
-     * @param maxLength - Maximum length including the suffix.
-     * @param suffix    - The string to append (default: `"..."`).
-     * @returns The truncated string.
-     *
-     * @example
-     * ```ts
-     * utils.truncate("Very long sentence", 10); // "Very lo..."
-     * ```
-     */
-    truncate(text, maxLength, suffix = "...") {
-        if (text.length <= maxLength)
-            return text;
-        return text.substring(0, maxLength - suffix.length) + suffix;
-    }
-    /**
-     * **Capitalize a String**
-     *
-     * Uppercases the first character of the string.
-     *
-     * @param text - The string to capitalize.
-     * @returns The capitalized string.
-     */
-    capitalize(text) {
-        return text.charAt(0).toUpperCase() + text.slice(1);
-    }
-    /**
-     * **Convert to camelCase**
-     *
-     * Converts hyphen-separated, underscore-separated, or space-separated
-     * strings into camelCase.
-     *
-     * @param text - The string to convert.
-     * @returns The camelCase string.
-     */
-    toCamelCase(text) {
-        return text
-            .replace(/([-_ ][a-z])/gi, ($1) => $1.toUpperCase().replace(/[-_ ]/g, ""))
-            .replace(/^[A-Z]/, (first) => first.toLowerCase());
-    }
-    /**
-     * **Pad a String**
-     *
-     * Adds padding characters to the start or end of a string until it
-     * reaches the target length.
-     *
-     * @param text     - The source string.
-     * @param length   - Target length.
-     * @param char     - Padding character (default: `" "`).
-     * @param position - Whether to pad at `"start"` or `"end"`.
-     * @returns The padded string.
-     */
-    pad(text, length, char = " ", position = "start") {
-        return position === "start"
-            ? text.padStart(length, char)
-            : text.padEnd(length, char);
-    }
-    /**
-     * **Count Word/Substring Occurrences**
-     *
-     * Returns the number of times a specific word or substring appears.
-     *
-     * @param text          - The body of text to search.
-     * @param word          - The substring to look for.
-     * @param caseSensitive - Whether to respect case (default: `false`).
-     * @returns The number of occurrences.
-     */
-    countOccurrences(text, word, caseSensitive = false) {
-        const flags = caseSensitive ? "g" : "gi";
-        const escaped = word.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-        return (text.match(new RegExp(escaped, flags)) || []).length;
-    }
-    /**
-     * **toQueryString**
-     *
-     * Serializes a flat record into a URL-encoded query string format.
-     *
-     * @param params The object to serialize.
-     * @returns The query string.
-     */
-    toQueryString(params) {
-        return Object.entries(params)
-            .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)
-            .join("&");
-    }
-}
-//# sourceMappingURL=StringUtils.js.map

package/dist/src/xhsc/utils/StringUtils.js.map

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

package/dist/src/xhsc/utils/ValidationUtils.d.ts

@@ -1,33 +0,0 @@
-/**
- * **ValidationUtils — XyPriss Validation Utilities**
- */
-export declare class ValidationUtils {
-    /**
-     * **email**
-     *
-     * Performs semantic validation on an email address string.
-     *
-     * @param email The email string to validate.
-     * @returns `true` if valid, `false` otherwise.
-     */
-    email(email: string): boolean;
-    /**
-     * **url**
-     *
-     * Validates a URL string using the `strulink` RFC-compliant URI parser.
-     *
-     * @param url The URL string to validate.
-     * @returns `true` if valid, `false` otherwise.
-     */
-    url(url: string | URL): boolean;
-    /**
-     * **nullish**
-     *
-     * A type guard that determines if a value is either `null` or `undefined`.
-     *
-     * @param value The value to check.
-     * @returns `true` if null or undefined.
-     */
-    nullish(value: unknown): value is null | undefined;
-}
-//# sourceMappingURL=ValidationUtils.d.ts.map

package/dist/src/xhsc/utils/ValidationUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ValidationUtils.d.ts","sourceRoot":"","sources":["../../../../src/xhsc/utils/ValidationUtils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,eAAe;IACxB;;;;;;;OAOG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;;;;OAOG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO;IAStC;;;;;;;OAOG;IACI,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,SAAS;CAG5D"}

package/dist/src/xhsc/utils/ValidationUtils.js

@@ -1,45 +0,0 @@
-/**
- * **ValidationUtils — XyPriss Validation Utilities**
- */
-export class ValidationUtils {
-    /**
-     * **email**
-     *
-     * Performs semantic validation on an email address string.
-     *
-     * @param email The email string to validate.
-     * @returns `true` if valid, `false` otherwise.
-     */
-    email(email) {
-        return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
-    }
-    /**
-     * **url**
-     *
-     * Validates a URL string using the `strulink` RFC-compliant URI parser.
-     *
-     * @param url The URL string to validate.
-     * @returns `true` if valid, `false` otherwise.
-     */
-    url(url) {
-        try {
-            new URL(String(url));
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * **nullish**
-     *
-     * A type guard that determines if a value is either `null` or `undefined`.
-     *
-     * @param value The value to check.
-     * @returns `true` if null or undefined.
-     */
-    nullish(value) {
-        return value === null || value === undefined;
-    }
-}
-//# sourceMappingURL=ValidationUtils.js.map

package/dist/src/xhsc/utils/ValidationUtils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ValidationUtils.js","sourceRoot":"","sources":["../../../../src/xhsc/utils/ValidationUtils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,eAAe;IACxB;;;;;;;OAOG;IACI,KAAK,CAAC,KAAa;QACtB,OAAO,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;;OAOG;IACI,GAAG,CAAC,GAAiB;QACxB,IAAI,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACI,OAAO,CAAC,KAAc;QACzB,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;IACjD,CAAC;CACJ"}

package/dist/src/xhsc/utils/deepReadonlyProxy.d.ts

@@ -1,48 +0,0 @@
-/**
- * **Deep Immutability Proxy for `__sys__`**
- *
- * Wraps the `XyPrissXHSC` singleton (and all its nested sub-APIs) in a
- * recursive `Proxy` that intercepts and denies every mutation attempt at
- * runtime.
- *
- * ### Intercepted traps
- * - `set`            — blocks `obj.prop = value`
- * - `deleteProperty` — blocks `delete obj.prop`
- * - `defineProperty` — blocks `Object.defineProperty(obj, ...)`
- *
- * ### Why a "deep" proxy?
- * A shallow proxy on `__sys__` alone would still allow:
- * ```ts
- * __sys__.fs.ls = () => ["/etc/passwd"];   // mutates a nested object
- * __sys__.__env__.set = () => {};          // replaces an API method
- * ```
- * By lazily wrapping every object/function returned via `get`, mutations
- * are intercepted at every depth without allocating all proxies upfront.
- *
- * ### Exempted values
- * Primitive values (`string`, `number`, `boolean`, `symbol`, `bigint`,
- * `null`, `undefined`) are returned as-is — they are inherently immutable.
- * Already-proxied objects (tracked by `proxyCache`) are returned from cache
- * to preserve strict equality (`===`) across multiple reads.
- *
- * ### Error strategy
- * A `TypeError` is thrown on every blocked operation. This matches the
- * behaviour of native `Object.freeze()` in strict mode, making the constraint
- * visible and debuggable during development.
- *
- * @module
- */
-/**
- * Recursively wraps `target` in an immutability proxy.
- *
- * @template T - The concrete type of the object being wrapped.
- * @param target - The object to protect.
- * @returns A deeply-proxied, mutation-proof view of `target`.
- *
- * @example
- * const safeSys = createDeepReadonlyProxy(sysInstance);
- * safeSys.fs = null; // throws TypeError
- * safeSys.__env__.set("KEY", "val"); // set() itself still callable — it is a method
- */
-export declare function createDeepReadonlyProxy<T extends object>(target: T): T;
-//# sourceMappingURL=deepReadonlyProxy.d.ts.map

package/dist/src/xhsc/utils/deepReadonlyProxy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"deepReadonlyProxy.d.ts","sourceRoot":"","sources":["../../../../src/xhsc/utils/deepReadonlyProxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAcH;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAmEtE"}

package/dist/src/xhsc/utils/deepReadonlyProxy.js

@@ -1,108 +0,0 @@
-/**
- * **Deep Immutability Proxy for `__sys__`**
- *
- * Wraps the `XyPrissXHSC` singleton (and all its nested sub-APIs) in a
- * recursive `Proxy` that intercepts and denies every mutation attempt at
- * runtime.
- *
- * ### Intercepted traps
- * - `set`            — blocks `obj.prop = value`
- * - `deleteProperty` — blocks `delete obj.prop`
- * - `defineProperty` — blocks `Object.defineProperty(obj, ...)`
- *
- * ### Why a "deep" proxy?
- * A shallow proxy on `__sys__` alone would still allow:
- * ```ts
- * __sys__.fs.ls = () => ["/etc/passwd"];   // mutates a nested object
- * __sys__.__env__.set = () => {};          // replaces an API method
- * ```
- * By lazily wrapping every object/function returned via `get`, mutations
- * are intercepted at every depth without allocating all proxies upfront.
- *
- * ### Exempted values
- * Primitive values (`string`, `number`, `boolean`, `symbol`, `bigint`,
- * `null`, `undefined`) are returned as-is — they are inherently immutable.
- * Already-proxied objects (tracked by `proxyCache`) are returned from cache
- * to preserve strict equality (`===`) across multiple reads.
- *
- * ### Error strategy
- * A `TypeError` is thrown on every blocked operation. This matches the
- * behaviour of native `Object.freeze()` in strict mode, making the constraint
- * visible and debuggable during development.
- *
- * @module
- */
-/** Internal registry that maps original objects to their proxied counterparts. */
-const proxyCache = new WeakMap();
-/**
- * List of property names that are explicitly allowed to be written internally
- * by the XyPriss bootstrap (before the proxy is applied). Any attempt to set
- * these from user code will still be blocked.
- */
-const BLOCKED_WRITE_MSG = "[XyPriss Security] The __sys__ API is read-only. " +
-    "Mutations to the system interface are not permitted.";
-/**
- * Recursively wraps `target` in an immutability proxy.
- *
- * @template T - The concrete type of the object being wrapped.
- * @param target - The object to protect.
- * @returns A deeply-proxied, mutation-proof view of `target`.
- *
- * @example
- * const safeSys = createDeepReadonlyProxy(sysInstance);
- * safeSys.fs = null; // throws TypeError
- * safeSys.__env__.set("KEY", "val"); // set() itself still callable — it is a method
- */
-export function createDeepReadonlyProxy(target) {
-    // Return primitives directly — they cannot be mutated
-    if (target === null || typeof target !== "object" && typeof target !== "function") {
-        return target;
-    }
-    // Return from cache to preserve referential equality
-    if (proxyCache.has(target)) {
-        return proxyCache.get(target);
-    }
-    const proxy = new Proxy(target, {
-        /**
-         * Intercepts property reads and lazily wraps nested objects.
-         */
-        get(obj, prop, receiver) {
-            let value = Reflect.get(obj, prop, receiver);
-            // Bind functions to the original object to preserve 'this' context
-            // and handle internal slots (Map, Set, etc.)
-            if (typeof value === "function") {
-                return value.bind(obj);
-            }
-            // Do not proxy primitives or null
-            if (value === null || (typeof value !== "object")) {
-                return value;
-            }
-            // Skip well-known Symbol properties
-            if (typeof prop === "symbol") {
-                return value;
-            }
-            return createDeepReadonlyProxy(value);
-        },
-        /**
-         * Blocks all assignment operations: `obj.prop = value`.
-         */
-        set(_obj, prop, _value) {
-            throw new TypeError(`${BLOCKED_WRITE_MSG}\n  -> Blocked: set '__sys__.${String(prop)}'`);
-        },
-        /**
-         * Blocks `delete obj.prop`.
-         */
-        deleteProperty(_obj, prop) {
-            throw new TypeError(`${BLOCKED_WRITE_MSG}\n  -> Blocked: delete '__sys__.${String(prop)}'`);
-        },
-        /**
-         * Blocks `Object.defineProperty(obj, prop, descriptor)`.
-         */
-        defineProperty(_obj, prop, _descriptor) {
-            throw new TypeError(`${BLOCKED_WRITE_MSG}\n  -> Blocked: defineProperty '__sys__.${String(prop)}'`);
-        },
-    });
-    proxyCache.set(target, proxy);
-    return proxy;
-}
-//# sourceMappingURL=deepReadonlyProxy.js.map

package/dist/src/xhsc/utils/deepReadonlyProxy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"deepReadonlyProxy.js","sourceRoot":"","sources":["../../../../src/xhsc/utils/deepReadonlyProxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,kFAAkF;AAClF,MAAM,UAAU,GAAG,IAAI,OAAO,EAAkB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,iBAAiB,GACnB,mDAAmD;IACnD,sDAAsD,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAAmB,MAAS;IAC/D,sDAAsD;IACtD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QAChF,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,qDAAqD;IACrD,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,UAAU,CAAC,GAAG,CAAC,MAAM,CAAM,CAAC;IACvC,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE;QAC5B;;WAEG;QACH,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ;YACnB,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAE7C,mEAAmE;YACnE,6CAA6C;YAC7C,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;YAED,kCAAkC;YAClC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAChD,OAAO,KAAK,CAAC;YACjB,CAAC;YAED,oCAAoC;YACpC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3B,OAAO,KAAK,CAAC;YACjB,CAAC;YAED,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QAED;;WAEG;QACH,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM;YAClB,MAAM,IAAI,SAAS,CACf,GAAG,iBAAiB,gCAAgC,MAAM,CAAC,IAAI,CAAC,GAAG,CACtE,CAAC;QACN,CAAC;QAED;;WAEG;QACH,cAAc,CAAC,IAAI,EAAE,IAAI;YACrB,MAAM,IAAI,SAAS,CACf,GAAG,iBAAiB,mCAAmC,MAAM,CAAC,IAAI,CAAC,GAAG,CACzE,CAAC;QACN,CAAC;QAED;;WAEG;QACH,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW;YAClC,MAAM,IAAI,SAAS,CACf,GAAG,iBAAiB,2CAA2C,MAAM,CAAC,IAAI,CAAC,GAAG,CACjF,CAAC;QACN,CAAC;KACJ,CAAC,CAAC;IAEH,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/src/xhsc.d.ts

@@ -1,41 +0,0 @@
-import { XyPrissFS } from "./xhsc/System";
-import { XY_XHSC_REGISTER_FS } from "./xhsc/api/env/env";
-/**
- * **XyPriss System Variables (`__sys__`)**
- *
- * The **Central Nervous System** of a XyPriss application.
- * This class serves as the singleton entry point for all system operations.
- *
- * - `fs`: Filesystem operations
- * - `os`: Operating system & hardware telemetry
- * - `path`: Path utilities
- * - `vars`: Dynamic configuration & metadata
- * - `__env__`: Environment variables & security manager (EnvApi)
- */
-export declare class XyPrissXHSC extends XyPrissFS {
-    private readonly _pluginMap;
-    private readonly _primaryRoot;
-    /** Authorized specialized workspace filesystems for plugins. */
-    readonly plugins: {
-        get(pluginId: string): XyPrissFS | undefined;
-    };
-    [XY_XHSC_REGISTER_FS](pluginId: string, instance: XyPrissFS): void;
-    get __root__(): string;
-    constructor(data?: Record<string, any>);
-    /**
-     * **Sleep (Utility)**
-     *
-     * Asynchronously pauses execution for the specified number of milliseconds.
-     *
-     * @param {number} ms - Milliseconds to sleep.
-     * @returns {Promise<void>}
-     */
-    sleep(ms: number): Promise<void>;
-    toJSON(): Record<string, any>;
-    private _loadConfig;
-    private _resolvePath;
-}
-/** Global singleton instance of the system. */
-export declare const __sys__: XyPrissXHSC;
-export { __sys__ as localSysApi };
-//# sourceMappingURL=xhsc.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"xhsc.d.ts","sourceRoot":"","sources":["../../src/xhsc.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAoB,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAc3E;;;;;;;;;;;GAWG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,gEAAgE;IAChE,SAAgB,OAAO,EAAE;QAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;KAAE,CAAC;IAEnE,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI;IAIzE,IAAoB,QAAQ,IAAI,MAAM,CAErC;gBACW,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IA2G1C;;;;;;;OAOG;IACU,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAIpC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;CAqBvB;AAiGD,+CAA+C;AAC/C,eAAO,MAAM,OAAO,aAA6C,CAAC;AAElE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,CAAC"}

package/dist/src/xhsc.js

@@ -1,231 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { XyPrissFS } from "./xhsc/System";
-import { DotEnvLoader } from "./utils/DotEnvLoader";
-import { XY_ENV_STORE_KEY, XY_XHSC_REGISTER_FS } from "./xhsc/api/env/env";
-import { isProjectRoot, getCallerProjectRoot, loadXyConfig, } from "./utils/ProjectDiscovery";
-import { logger } from "./shared/logger/Logger";
-import { generateXUserTmpDir, } from "./plugins/const/XyprissTempDir";
-// import { XyprissTempDir } from "./plugins/const/XyprissTempDir";
-/**
- * **XyPriss System Variables (`__sys__`)**
- *
- * The **Central Nervous System** of a XyPriss application.
- * This class serves as the singleton entry point for all system operations.
- *
- * - `fs`: Filesystem operations
- * - `os`: Operating system & hardware telemetry
- * - `path`: Path utilities
- * - `vars`: Dynamic configuration & metadata
- * - `__env__`: Environment variables & security manager (EnvApi)
- */
-export class XyPrissXHSC extends XyPrissFS {
-    [XY_XHSC_REGISTER_FS](pluginId, instance) {
-        this._pluginMap.set(pluginId, instance);
-    }
-    get __root__() {
-        return getCallerProjectRoot() || this._internalRoot;
-    }
-    constructor(data = {}) {
-        const root = data.__root__ || process.cwd();
-        if (!isProjectRoot(root)) {
-            throw new Error(`[XyPriss] Validation Error: '${root}' is not a valid project root. 
-                A valid XyPriss project must contain fundamental modules (package.json, node_modules, etc.).`);
-        }
-        // Resolve environment mode before super() as it's now readonly
-        const envUpdate = data.__env__ || data.__env || data.__mode__ || data.__mode;
-        const mode = typeof envUpdate === "string"
-            ? envUpdate
-            : envUpdate?.mode || "development";
-        super({ __root__: root, __mode__: mode, isDynamicEnv: true });
-        this._pluginMap = new Map();
-        this._primaryRoot = root;
-        // Initialize default vars
-        this.vars.update({
-            __version__: "0.0.0",
-            __author__: "unknown",
-            __description__: "A XyPriss application",
-            __app_urls__: {},
-            __name__: "xypriss-app",
-            __alias__: "app",
-            __port__: 7682,
-            __PORT__: 7682,
-            ...data,
-        });
-        // Specialized Workspace Discovery (Security Restricted)
-        const pluginsAccess = {
-            get: (pluginId) => {
-                const callerRoot = getCallerProjectRoot() || this.__root__;
-                const cacheKey = `${pluginId}:${callerRoot}`;
-                let instance = this._pluginMap.get(cacheKey);
-                if (!instance) {
-                    // 🛡️ Security Policy: Config-driven authorization
-                    const config = this._loadConfig();
-                    const internal = config?.$internal || config?.internal;
-                    const pluginConfig = internal?.[pluginId];
-                    const xfsPath = pluginConfig?.__xfs__?.path;
-                    let resolvedRoot = null;
-                    if (xfsPath) {
-                        resolvedRoot = this._resolvePath(xfsPath, callerRoot);
-                    }
-                    if (resolvedRoot && fs.existsSync(resolvedRoot)) {
-                        instance = new XyPrissFS({
-                            __root__: resolvedRoot,
-                            __mode__: mode,
-                        });
-                        // 🛡️ Security: Lock the workspace root to the authorized path
-                        Object.defineProperty(instance, "__root__", {
-                            value: resolvedRoot,
-                            writable: false,
-                            enumerable: true,
-                            configurable: false,
-                        });
-                        logger.debug("security", `Plugin ${pluginId} authorized. Workspace root: ${resolvedRoot} (Context: ${callerRoot})`);
-                        this._pluginMap.set(cacheKey, instance);
-                        return instance;
-                    }
-                    else {
-                        // Void Sandbox — plugin non autorisé dans la config
-                        const voidPath = path.join(generateXUserTmpDir(), "void", "sandbox", pluginId.replace(/[^a-zA-Z0-9-]/g, "_"));
-                        this.fs.mkdir(voidPath, { parents: true });
-                        logger.warn("security", `Plugin ${pluginId} requested workspace but was not explicitly authorized in config. Assigned implicit Void Sandbox (${voidPath}).`);
-                        return undefined;
-                    }
-                }
-                return instance;
-            },
-        };
-        // Inject the restricted accessor
-        this.plugins = pluginsAccess;
-        // Lock plugins map reference so it cannot be replaced
-        Object.defineProperty(this, "plugins", {
-            value: this.plugins,
-            enumerable: true,
-            writable: false,
-            configurable: false,
-        });
-    }
-    /**
-     * **Sleep (Utility)**
-     *
-     * Asynchronously pauses execution for the specified number of milliseconds.
-     *
-     * @param {number} ms - Milliseconds to sleep.
-     * @returns {Promise<void>}
-     */
-    async sleep(ms) {
-        return new Promise((resolve) => setTimeout(resolve, ms));
-    }
-    toJSON() {
-        return this.vars.all();
-    }
-    _loadConfig() {
-        return loadXyConfig(this._primaryRoot);
-    }
-    _resolvePath(raw, projectRoot) {
-        try {
-            let p = raw.replace(/\s*\/\s*/g, "/").trim();
-            if (p.startsWith("ROOT://")) {
-                return path.resolve(projectRoot, p.substring(7).replace(/^\//, ""));
-            }
-            if (p.startsWith("CWD://")) {
-                return path.resolve(process.cwd(), p.substring(6).replace(/^\//, ""));
-            }
-            if (path.isAbsolute(p))
-                return p;
-            return path.resolve(projectRoot, p);
-        }
-        catch {
-            return null;
-        }
-    }
-}
-// Global Registration & Environment Setup
-if (typeof globalThis !== "undefined") {
-    const originalEnv = { ...process.env };
-    const envPaths = [];
-    // Improved root detection: start from the main script's directory if possible,
-    // otherwise fallback to process.cwd().
-    let currentDir = process.cwd();
-    if (process.argv[1]) {
-        try {
-            const resolvedPath = fs.realpathSync(process.argv[1]);
-            if (fs.existsSync(resolvedPath)) {
-                currentDir = path.dirname(resolvedPath);
-            }
-        }
-        catch (e) {
-            // Fallback to process.cwd()
-        }
-    }
-    const rootDir = path.parse(currentDir).root;
-    let foundRoot = process.cwd();
-    // Identify all projects in the hierarchy
-    const projects = [];
-    let tempDir = currentDir;
-    while (tempDir !== rootDir) {
-        if (isProjectRoot(tempDir)) {
-            projects.push(tempDir);
-        }
-        tempDir = path.dirname(tempDir);
-    }
-    // The closest project to the script is our primary root
-    if (projects.length > 0) {
-        foundRoot = projects[0];
-    }
-    else {
-        // Fallback to searching for ANY package.json if no 'real' project found
-        tempDir = currentDir;
-        while (tempDir !== rootDir) {
-            if (fs.existsSync(path.join(tempDir, "package.json"))) {
-                foundRoot = tempDir;
-                break;
-            }
-            tempDir = path.dirname(tempDir);
-        }
-    }
-    // Load environment variables for each project hierarchy independently
-    const projectEnvs = new Map();
-    // Process each project found in the hierarchy
-    for (const projectPath of projects) {
-        const envPath = path.resolve(projectPath, ".env");
-        const envData = {};
-        if (fs.existsSync(envPath)) {
-            const loaded = DotEnvLoader.load({
-                path: [envPath],
-                override: true,
-            });
-            for (const key in loaded) {
-                envData[key] = loaded[key];
-            }
-        }
-        projectEnvs.set(projectPath, envData);
-    }
-    // Initialize the Symbol-keyed secure store as a Map of project environments
-    globalThis[XY_ENV_STORE_KEY] = projectEnvs;
-    // Use the primary project root's environment for system defaults
-    const primaryEnv = projectEnvs.get(foundRoot) || {};
-    const defaultPort = parseInt(primaryEnv["PORT"] || "3000");
-    if (!globalThis.__sys__) {
-        const sysInstance = new XyPrissXHSC({
-            __root__: foundRoot,
-            __port__: defaultPort,
-            __PORT__: defaultPort,
-            __mode__: primaryEnv["NODE_ENV"] || "development",
-        });
-        // ==========================================
-        // ENTERPRISE IMMUTABILITY SHIELD
-        // ==========================================
-        // Lock the global __sys__ object so it cannot be overwritten
-        Object.defineProperty(globalThis, "__sys__", {
-            value: sysInstance,
-            writable: false,
-            enumerable: true,
-            configurable: false,
-        });
-    }
-}
-/** Global singleton instance of the system. */
-export const __sys__ = globalThis.__sys__;
-export { __sys__ as localSysApi };
-//# sourceMappingURL=xhsc.js.map