xypriss 9.9.5 → 9.9.7

package/dist/cjs/src/plugins/core/PermissionManager.js

@@ -130,14 +130,14 @@ class PermissionManager {
             logDenial("Privileged hook must be explicitly whitelisted by string declaration. Wildcard '*' does not grant privileged capabilities.", solutionPrivileged);
             return false;
         }
-        // 2. Lifecycle Hooks: Always allowed for engine stability (unless denied)
-        if (isLifecycleHook)
+        // 2. Lifecycle Hooks: Engines stability fallback
+        const allowLifecycle = this.server.options?.plugins?.allowLifecycleByDefault ?? false;
+        if (isLifecycleHook && allowLifecycle)
             return true;
         // 3. Standard Hook Logic
         if (policy === "deny") {
             // "deny" policy = Whitelist mode
-            if (isLifecycleHook)
-                return true; // Lifecycle is always whitelisted by default
+            // Whitelist mode: only allow if in allowedHooks (or explicitly enabled by server options above)
             if (allowedHooks === "*")
                 return true;
             if (Array.isArray(allowedHooks) && allowedHooks.includes(hookId)) {

package/dist/cjs/src/plugins/core/PermissionManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"PermissionManager.js","sources":["../../../../../src/plugins/core/PermissionManager.ts"],"sourcesContent":[null],"names":["Logger","HOOK_ID_MAP","HOOK_METADATA","OFFICIAL_PLUGINS","__sys__","PluginHookIds"],"mappings":"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"}
+{"version":3,"file":"PermissionManager.js","sources":["../../../../../src/plugins/core/PermissionManager.ts"],"sourcesContent":[null],"names":["Logger","HOOK_ID_MAP","HOOK_METADATA","OFFICIAL_PLUGINS","__sys__","PluginHookIds"],"mappings":";;;;;;;AAAA;;;;;;;AAOiF;AAajF;;;AAGG;MACU,iBAAiB,CAAA;IAI1B,WAAA,CACY,MAAqB,EAC7B,MAAe,EAAA;QADP,IAAA,CAAA,MAAM,GAAN,MAAM;AAHV,QAAA,IAAA,CAAA,eAAe,GAAgB,IAAI,GAAG,EAAE;QAM5C,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAIA,aAAM,EAAE;IACxC;AAEA;;;AAGG;AACI,IAAA,aAAa,CAAC,UAAkB,EAAA;AACnC,QAAA,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;IACxC;AAEA;;;AAGG;AACI,IAAA,YAAY,CAAC,UAAkB,EAAA;AAClC,QAAA,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC;IAC3C;AAEA;;AAEG;IACI,gBAAgB,CACnB,UAAkB,EAClB,gBAAwB,EAAA;QAExB,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE;YACtC,MAAM,MAAM,GAAGC,yBAAW,CAAC,gBAAgB,CAAC,IAAI,gBAAgB;AAChE,YAAA,MAAM,IAAI,GAAGC,2BAAa,CAAC,MAAM,CAAC;AAElC,YAAA,IAAI,OAAO,GAAG,CAAA,QAAA,EAAW,UAAU,CAAA,yCAAA,EAA4C,MAAM,IAAI;YACzF,IAAI,IAAI,EAAE;AACN,gBAAA,OAAO,GAAG,CAAA,QAAA,EAAW,UAAU,CAAA,yBAAA,EAA4B,IAAI,CAAC,MAAM,CAAA,QAAA,EAAW,MAAM,CAAA,GAAA,EAAM,IAAI,CAAC,IAAI,IAAI;YAC9G;YAEA,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,SAAS,EACT,CAAA,EAAG,OAAO,CAAA,kDAAA,CAAoD,CACjE;AACD,YAAA,OAAO,IAAI;QACf;AACA,QAAA,OAAO,KAAK;IAChB;AAEA;;;AAGG;IACI,eAAe,CAClB,UAAkB,EAClB,gBAAwB,EAAA;QAExB,IAAI,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,CAAC,EAAE;AACrD,YAAA,OAAO,KAAK;QAChB;;;AAIA,QAAA,IAAIC,iCAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE;AACvC,YAAA,OAAO,IAAI;QACf;QAEA,MAAM,MAAM,GAAGF,yBAAW,CAAC,gBAAgB,CAAC,IAAI,gBAAgB;AAChE,QAAA,MAAM,IAAI,GAAGC,2BAAa,CAAC,MAAM,CAAC;QAClC,MAAM,WAAW,GAAGE,YAAO,EAAE,IAAI,CAAC,GAAG,CACjC,mBAAmB,CACA;;AAGvB,QAAA,MAAM,gBAAgB,GAAG;AACrB,YAAAC,2BAAa,CAAC,cAAc;AAC5B,YAAAA,2BAAa,CAAC,oBAAoB;AAClC,YAAAA,2BAAa,CAAC,0BAA0B;AACxC,YAAAA,2BAAa,CAAC,gBAAgB;AAC9B,YAAAA,2BAAa,CAAC,mBAAmB;AACjC,YAAAA,2BAAa,CAAC,iBAAiB;AAC/B,YAAAA,2BAAa,CAAC,cAAc;AAC5B,YAAAA,2BAAa,CAAC,qBAAqB;AACnC,YAAAA,2BAAa,CAAC,UAAU;AACxB,YAAAA,2BAAa,CAAC,WAAW;AAC5B,SAAA,CAAC,QAAQ,CAAC,MAAa,CAAC;;AAGzB,QAAA,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,QAAiB,KAAI;AACpD,YAAA,IAAI,OAAO,GAAG,CAAA,QAAA,EAAW,UAAU,CAAA,4BAAA,EAA+B,MAAM,IAAI;YAE5E,IAAI,IAAI,EAAE;gBACN,MAAM,UAAU,GAAG;AACf,sBAAE;sBACA,8DAA8D;gBACpE,OAAO,GAAG,WAAW,UAAU,CAAA,mBAAA,EAAsB,IAAI,CAAC,MAAM,gBAAgB,MAAM,CAAA,GAAA,EAAM,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,WAAW,CAAA,EAAA,EAAK,UAAU,EAAE;YACjJ;YAEA,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,SAAS,EACT,CAAA,EAAG,OAAO,CAAA,EAAG,QAAQ,GAAG,CAAA,iBAAA,EAAoB,QAAQ,CAAA,CAAE,GAAG,EAAE,CAAA,CAAE,CAChE;AACL,QAAA,CAAC;AAED,QAAA,MAAM,kBAAkB,GAAG,CAAA,KAAA,EAAQ,MAAM,CAAA,4DAAA,EAA+D,UAAU,IAAI;QAEtH,MAAM,eAAe,GAAG,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC;;QAGhE,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;YAC1C,IAAI,gBAAgB,EAAE;AAClB,gBAAA,SAAS,CACL,oCAAoC,EACpC,kBAAkB,CACrB;AACD,gBAAA,OAAO,KAAK;YAChB;;AAEA,YAAA,OAAO,eAAe;QAC1B;AAEA,QAAA,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC;;QAGjE,IAAI,CAAC,UAAU,EAAE;YACb,IAAI,gBAAgB,EAAE;AAClB,gBAAA,SAAS,CACL,oCAAoC,EACpC,kBAAkB,CACrB;AACD,gBAAA,OAAO,KAAK;YAChB;;AAEA,YAAA,OAAO,eAAe;QAC1B;;QAGA,IAAI,UAAU,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE;YAC1C,SAAS,CACL,qCAAqC,EACrC,CAAA,QAAA,EAAW,MAAM,CAAA,iCAAA,EAAoC,UAAU,CAAA,EAAA,CAAI,CACtE;AACD,YAAA,OAAO,KAAK;QAChB;QAEA,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC;AAC3C,QAAA,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY;;QAG5C,IAAI,gBAAgB,EAAE;AAClB,YAAA,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;AAC9D,gBAAA,OAAO,IAAI;YACf;;AAGA,YAAA,SAAS,CACL,4HAA4H,EAC5H,kBAAkB,CACrB;AACD,YAAA,OAAO,KAAK;QAChB;;AAGA,QAAA,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,uBAAuB,IAAI,KAAK;QACrF,IAAI,eAAe,IAAI,cAAc;AAAE,YAAA,OAAO,IAAI;;AAGlD,QAAA,IAAI,MAAM,KAAK,MAAM,EAAE;;;YAGnB,IAAI,YAAY,KAAK,GAAG;AAAE,gBAAA,OAAO,IAAI;AACrC,YAAA,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;AAC9D,gBAAA,OAAO,IAAI;YACf;YACA,SAAS,CACL,2CAA2C,EAC3C,CAAA,KAAA,EAAQ,MAAM,CAAA,gCAAA,EAAmC,UAAU,CAAA,EAAA,CAAI,CAClE;AACD,YAAA,OAAO,KAAK;QAChB;;AAGA,QAAA,OAAO,IAAI;IACf;AAEA;;;;AAIG;IACI,WAAW,CAAC,GAAQ,EAAE,UAAmB,EAAA;AAC5C,QAAA,IAAI,CAAC,GAAG;AAAE,YAAA,OAAO,GAAG;QAEpB,IAAI,UAAU,EAAE;YACZ,MAAM,WAAW,GAAGD,YAAO,EAAE,IAAI,CAAC,GAAG,CACjC,mBAAmB,CACA;YACvB,IAAI,WAAW,EAAE;AACb,gBAAA,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAC/B,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,UAAU,CAC/B;gBACD,IAAI,UAAU,EAAE;AACZ,oBAAA,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,IAAI,EAAE;AAClD,oBAAA,MAAM,SAAS,GACX,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;AAC3B,wBAAA,YAAY,CAAC,QAAQ,CACjBC,2BAAa,CAAC,qBAAqB,CACtC;AACL,oBAAA,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,QAAQ,CAC7CA,2BAAa,CAAC,qBAAqB,CACtC;AAED,oBAAA,IAAI,SAAS,IAAI,CAAC,QAAQ,EAAE;wBACxB,OAAO,GAAG,CAAC;oBACf;gBACJ;YACJ;QACJ;AAEA,QAAA,MAAM,aAAa,GAAG,CAAA,EAAG,UAAU,8IAA8I;AACjL,QAAA,MAAM,eAAe,GAAG;YACpB,MAAM;YACN,OAAO;YACP,SAAS;YACT,QAAQ;YACR,SAAS;SACZ;AAED,QAAA,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE;YAClB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAA;gBACZ,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE;oBAChD,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;AAC1C,oBAAA,MAAM,WAAW,GAAG;wBAChB,YAAY;wBACZ,SAAS;wBACT,MAAM;wBACN,QAAQ;wBACR,cAAc;wBACd,gBAAgB;wBAChB,YAAY;wBACZ,iBAAiB;wBACjB,kBAAkB;qBACrB;oBAED,MAAM,aAAa,GAA2B,EAAE;AAChD,oBAAA,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CACrC,eAAe,CAClB,EAAE;AACC,wBAAA,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE;AAClC,wBAAA,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;AAChC,4BAAA,aAAa,CAAC,GAAG,CAAC,GAAG,KAAe;wBACxC;oBACJ;AACA,oBAAA,OAAO,aAAa;gBACxB;gBAEA,IACI,OAAO,IAAI,KAAK,QAAQ;AACxB,oBAAA,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAChC;AACE,oBAAA,OAAO,CAAA,CAAA,EAAI,UAAU,CAAA,oCAAA,EAAuC,IAAI,kFAAkF;gBACtJ;AACA,gBAAA,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;AAC1B,gBAAA,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE;AAC7B,oBAAA,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC7B;AACA,gBAAA,OAAO,KAAK;YAChB,CAAC;AACD,YAAA,OAAO,CAAC,MAAM,EAAA;AACV,gBAAA,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;YAClC,CAAC;YACD,wBAAwB,CAAC,MAAM,EAAE,IAAI,EAAA;gBACjC,IACI,OAAO,IAAI,KAAK,QAAQ;AACxB,oBAAA,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAChC;oBACE,OAAO;AACH,wBAAA,KAAK,EAAE,aAAa;AACpB,wBAAA,UAAU,EAAE,IAAI;AAChB,wBAAA,YAAY,EAAE,IAAI;AAClB,wBAAA,QAAQ,EAAE,KAAK;qBAClB;gBACL;gBACA,OAAO,OAAO,CAAC,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC;YACzD,CAAC;AACJ,SAAA,CAAC;IACN;AACH;;;;"}

package/dist/cjs/src/server/const/default.js

@@ -311,6 +311,7 @@ const DEFAULT_OPTIONS = {
         },
     },
     plugins: {
+        allowLifecycleByDefault: false, // Zero-Trust Security: Plugins must explicitly whitelist their hooks. This default prevents unknown plugins from accessing sensitive lifecycle events (start, ready, stop).
         routeOptimization: {
             enabled: false, // Disabled by default for performance
             analysisInterval: 300000, // 5 minutes

package/dist/cjs/src/server/const/default.js.map

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

package/dist/cjs/src/server/utils/ConfigLoader.js

@@ -7,6 +7,7 @@ var System = require('../../xhsc/System.js');
 var xhsc = require('../../xhsc.js');
 var env = require('../../xhsc/api/env/env.js');
 var ProjectDiscovery = require('../../utils/ProjectDiscovery.js');
+var ConfigSyntaxParser = require('../../utils/ConfigSyntaxParser.js');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
@@ -254,51 +255,9 @@ class ConfigLoader {
             }
         }
     }
-    getDeepValue(obj, path) {
-        if (!obj)
-            return undefined;
-        const parts = path.split(".");
-        let current = obj;
-        for (const part of parts) {
-            if (current === null || typeof current !== "object")
-                return undefined;
-            current = current[part];
-        }
-        return current;
-    }
     resolveRefs(obj) {
-        if (typeof obj === "string") {
-            // 1. Resolve $(env).KEY or &(env).KEY
-            let resolved = obj.replace(/([\$\&])\(env\)\.([\w\d_.-]+)/g, (match, prefix, key) => {
-                if (!xhsc.__sys__.__env__.has(key)) {
-                    throw new Error(`Dynamic configuration error: Environment variable "${key}" not found`);
-                }
-                return xhsc.__sys__.__env__.get(key);
-            });
-            // 2. Resolve $(pkg).path or &(pkg).path
-            resolved = resolved.replace(/([\$\&])\(pkg\)\.([\w\d_.-]+)/g, (match, prefix, propPath) => {
-                if (!this.packageJson)
-                    return match;
-                const val = this.getDeepValue(this.packageJson, propPath);
-                if (val === undefined) {
-                    throw new Error(`Dynamic configuration error: Property "${propPath}" not found in package.json`);
-                }
-                return String(val);
-            });
-            return resolved;
-        }
-        else if (Array.isArray(obj)) {
-            return obj.map((item) => this.resolveRefs(item));
-        }
-        else if (typeof obj === "object" && obj !== null) {
-            const resolved = {};
-            for (const key in obj) {
-                const resolvedKey = this.resolveRefs(key);
-                resolved[resolvedKey] = this.resolveRefs(obj[key]);
-            }
-            return resolved;
-        }
-        return obj;
+        const parser = new ConfigSyntaxParser.ConfigSyntaxParser(this.packageJson, xhsc.__sys__?.__env__);
+        return parser.resolve(obj);
     }
     resolveEnvRefs(obj) {
         return this.resolveRefs(obj);

package/dist/cjs/src/server/utils/ConfigLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigLoader.js","sources":["../../../../../src/server/utils/ConfigLoader.ts"],"sourcesContent":[null],"names":["path","fs","getCallerProjectRoot","__sys__","logger","XyPrissFS","XY_XHSC_REGISTER_FS"],"mappings":"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"}
+{"version":3,"file":"ConfigLoader.js","sources":["../../../../../src/server/utils/ConfigLoader.ts"],"sourcesContent":[null],"names":["path","fs","getCallerProjectRoot","__sys__","logger","XyPrissFS","XY_XHSC_REGISTER_FS","ConfigSyntaxParser"],"mappings":"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"}

package/dist/cjs/src/utils/ConfigSyntaxParser.js

@@ -0,0 +1,80 @@
+'use strict';
+
+/**
+ * **Config Syntax Parser**
+ *
+ * Handles resolution of dynamic references in configuration files:
+ * - `$(env).KEY` / `&(env).KEY` : Environment variables
+ * - `$(pkg).path` / `&(pkg).path` : package.json properties
+ */
+class ConfigSyntaxParser {
+    constructor(packageJson = null, envProvider = null) {
+        this.packageJson = packageJson;
+        this.envProvider = envProvider;
+    }
+    /**
+     * Resolves all dynamic references in a configuration object or string.
+     */
+    resolve(obj) {
+        if (typeof obj === "string") {
+            return this.resolveString(obj);
+        }
+        else if (Array.isArray(obj)) {
+            return obj.map((item) => this.resolve(item));
+        }
+        else if (typeof obj === "object" && obj !== null) {
+            const resolved = {};
+            for (const key in obj) {
+                const resolvedKey = this.resolve(key);
+                resolved[resolvedKey] = this.resolve(obj[key]);
+            }
+            return resolved;
+        }
+        return obj;
+    }
+    /**
+     * Resolves dynamic references in a string.
+     */
+    resolveString(value) {
+        let resolved = value;
+        // 1. Resolve $(env).KEY or &(env).KEY
+        resolved = resolved.replace(/([\$\&])\(env\)\.([\w\d_.-]+)/g, (match, _prefix, key) => {
+            const env = this.envProvider;
+            if (!env)
+                return match; // Fallback to original if no env provider
+            if (!env.has(key)) {
+                throw new Error(`Dynamic configuration error: Environment variable "${key}" not found`);
+            }
+            return env.get(key);
+        });
+        // 2. Resolve $(pkg).path or &(pkg).path
+        resolved = resolved.replace(/([\$\&])\(pkg\)\.([\w\d_.-]+)/g, (_match, _prefix, propPath) => {
+            if (!this.packageJson)
+                return _match;
+            const val = this.getDeepValue(this.packageJson, propPath);
+            if (val === undefined) {
+                throw new Error(`Dynamic configuration error: Property "${propPath}" not found in package.json`);
+            }
+            return String(val);
+        });
+        return resolved;
+    }
+    /**
+     * Retrieves a value from a nested object using dot notation.
+     */
+    getDeepValue(obj, path) {
+        if (!obj)
+            return undefined;
+        const parts = path.split(".");
+        let current = obj;
+        for (const part of parts) {
+            if (current === null || typeof current !== "object")
+                return undefined;
+            current = current[part];
+        }
+        return current;
+    }
+}
+
+exports.ConfigSyntaxParser = ConfigSyntaxParser;
+//# sourceMappingURL=ConfigSyntaxParser.js.map

package/dist/cjs/src/utils/ConfigSyntaxParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigSyntaxParser.js","sources":["../../../../src/utils/ConfigSyntaxParser.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;AAMG;MACU,kBAAkB,CAAA;AAC3B,IAAA,WAAA,CACqB,WAAA,GAAmB,IAAI,EACvB,WAAA,GAA0F,IAAI,EAAA;QAD9F,IAAA,CAAA,WAAW,GAAX,WAAW;QACX,IAAA,CAAA,WAAW,GAAX,WAAW;IAC7B;AAEH;;AAEG;AACI,IAAA,OAAO,CAAC,GAAQ,EAAA;AACnB,QAAA,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AACzB,YAAA,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;QAClC;AAAO,aAAA,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;AAC3B,YAAA,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChD;aAAO,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE;YAChD,MAAM,QAAQ,GAAQ,EAAE;AACxB,YAAA,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE;gBACnB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;AACrC,gBAAA,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClD;AACA,YAAA,OAAO,QAAQ;QACnB;AACA,QAAA,OAAO,GAAG;IACd;AAEA;;AAEG;AACK,IAAA,aAAa,CAAC,KAAa,EAAA;QAC/B,IAAI,QAAQ,GAAG,KAAK;;AAGpB,QAAA,QAAQ,GAAG,QAAQ,CAAC,OAAO,CACvB,gCAAgC,EAChC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,KAAI;AACpB,YAAA,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW;AAC5B,YAAA,IAAI,CAAC,GAAG;gBAAE,OAAO,KAAK,CAAC;YAEvB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;AACf,gBAAA,MAAM,IAAI,KAAK,CACX,sDAAsD,GAAG,CAAA,WAAA,CAAa,CACzE;YACL;AACA,YAAA,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE;AACxB,QAAA,CAAC,CACJ;;AAGD,QAAA,QAAQ,GAAG,QAAQ,CAAC,OAAO,CACvB,gCAAgC,EAChC,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,KAAI;YAC1B,IAAI,CAAC,IAAI,CAAC,WAAW;AAAE,gBAAA,OAAO,MAAM;AACpC,YAAA,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC;AACzD,YAAA,IAAI,GAAG,KAAK,SAAS,EAAE;AACnB,gBAAA,MAAM,IAAI,KAAK,CACX,0CAA0C,QAAQ,CAAA,2BAAA,CAA6B,CAClF;YACL;AACA,YAAA,OAAO,MAAM,CAAC,GAAG,CAAC;AACtB,QAAA,CAAC,CACJ;AAED,QAAA,OAAO,QAAQ;IACnB;AAEA;;AAEG;IACK,YAAY,CAAC,GAAQ,EAAE,IAAY,EAAA;AACvC,QAAA,IAAI,CAAC,GAAG;AAAE,YAAA,OAAO,SAAS;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAC7B,IAAI,OAAO,GAAG,GAAG;AACjB,QAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;AACtB,YAAA,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;AAAE,gBAAA,OAAO,SAAS;AACrE,YAAA,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;QAC3B;AACA,QAAA,OAAO,OAAO;IAClB;AACH;;;;"}

package/dist/cjs/src/utils/ProjectDiscovery.js

@@ -2,6 +2,7 @@
 
 var fs = require('fs');
 var path = require('path');
+var ConfigSyntaxParser = require('./ConfigSyntaxParser.js');
 
 /**
  * Checks if a directory is a "Real Project" root based on hierarchical criteria.
@@ -158,7 +159,20 @@ function loadXyConfig(projectRoot) {
                 const clean = raw
                     .replace(/("(?:[^"\\]|\\.)*")|\/\/.*|\/\*[\s\S]*?\*\//g, (m, g) => (g ? g : ""))
                     .replace(/("(?:[^"\\]|\\.)*")|,\s*([}\]])/g, (m, g1, g2) => g1 ? g1 : g2);
-                return JSON.parse(clean);
+                const rawJson = JSON.parse(clean);
+                // Load package.json from the same directory for resolution
+                let pkgJson = null;
+                const pkgPath = path.join(projectRoot, "package.json");
+                if (fs.existsSync(pkgPath)) {
+                    try {
+                        pkgJson = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+                    }
+                    catch { /* ignore */ }
+                }
+                // Resolve references $(pkg), $(env), etc.
+                const sys = globalThis.__sys__;
+                const parser = new ConfigSyntaxParser.ConfigSyntaxParser(pkgJson, sys?.__env__);
+                return parser.resolve(rawJson);
             }
             catch (e) {
                 return null;

package/dist/cjs/src/utils/ProjectDiscovery.js.map

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

package/dist/cjs/src/xhsc/OSApi.js

@@ -9,19 +9,52 @@ class OSApi extends PathApi.BaseApi {
     constructor() {
         super(...arguments);
         /**
-         * **Get Memory Usage**
+         * **Memory & Swap Utilization**
+         *
+         * Returns a snapshot of the system's memory state, including RAM (total, used, free)
+         * and Swap space utilization.
+         *
+         * @param {boolean} [watch=false] - If true, triggers the underlying engine to start
+         * tracking memory trends for subsequent calls.
+         * @returns {MemoryInfo} Current memory and swap statistics.
+         *
+         * @example
+         * const mem = __sys__.os.memory();
+         * console.log(`RAM Used: ${mem.used / 1024 / 1024} MB`);
          */
         this.memory = (watch = false) => this.runner.runSync("sys", "memory", [], { watch });
         /**
-         * **Get General System Info**
+         * **General System Metadata**
+         *
+         * Retrieves fundamental operating system information such as kernel version,
+         * hostname, uptime, and distribution details.
+         *
+         * @returns {SystemInfo} Basic system metadata.
          */
         this.info = () => this.runner.runSync("sys", "info", []);
         /**
-         * **Get Network Interfaces**
+         * **Network Interface Statistics**
+         *
+         * Retrieves status and statistics for network interfaces, including
+         * IP addresses, MAC addresses, and traffic metrics (bytes sent/received).
+         *
+         * @param {string} [interfaceName] - Optional name of the interface (e.g., 'eth0', 'wlan0').
+         * @returns {NetworkStats | NetworkInterface} Global stats or specific interface details.
          */
         this.network = (interfaceName) => this.runner.runSync("sys", "network", [], { interface: interfaceName });
         /**
-         * **List & Query Processes**
+         * **Process Listing & Querying**
+         *
+         * Retrieves the current process tree with options to filter by PID or
+         * sort by resource consumption (CPU/Memory).
+         *
+         * @param {Object} [options] - Query options.
+         * @param {number} [options.pid] - Filter by specific Process ID.
+         * @param {number} [options.topCpu] - Number of top CPU-consuming processes to return.
+         * @param {number} [options.topMem] - Number of top Memory-consuming processes to return.
+         * @returns {ProcessInfo[] | ProcessInfo | ProcessStats} Process list or individual process data.
+         *
+         * @security Sensitive internal processes (signature/root flags) are automatically filtered.
          */
         this.processes = (options = {}) => {
             const prs = this.runner.runSync("sys", "processes", [], options);
@@ -42,11 +75,22 @@ class OSApi extends PathApi.BaseApi {
             return nprs;
         };
         /**
-         * **System Health Check**
+         * **System Health Assessment**
+         *
+         * Performs a high-level check of system stability, identifying potential issues
+         * with resource exhaustion, high temperatures, or service failures.
+         *
+         * @returns {any} A health status object with warnings and critical flags.
          */
         this.health = () => this.runner.runSync("sys", "health");
         /**
-         * **Monitor System Performance**
+         * **Real-time System Monitoring**
+         *
+         * Starts a monitoring session to capture system performance snapshots over time.
+         *
+         * @param {number} [duration=60] - How long to monitor in seconds.
+         * @param {number} [interval=1] - Frequency of snapshots in seconds.
+         * @returns {MonitorSnapshot[] | void} Captured snapshots (if not running in interactive mode).
          */
         this.monitor = (duration = 60, interval = 1) => this.runner.runSync("monitor", "system", [], {
             duration,
@@ -54,7 +98,13 @@ class OSApi extends PathApi.BaseApi {
             interactive: true,
         });
         /**
-         * **Monitor Specific Process**
+         * **Individual Process Monitoring**
+         *
+         * Tracks resource usage (CPU, Memory, Threads) for a specific process over time.
+         *
+         * @param {number} pid - The ID of the process to monitor.
+         * @param {number} [duration=60] - Monitoring duration in seconds.
+         * @returns {ProcessMonitorSnapshot[] | void} Captured snapshots.
          */
         this.monitorProcess = (pid, duration = 60) => {
             return this.runner.runSync("monitor", "process", [], {
@@ -64,7 +114,11 @@ class OSApi extends PathApi.BaseApi {
             });
         };
         /**
-         * **Kill Process**
+         * **Terminate Process**
+         *
+         * Forcefully stops a process by its ID or Name.
+         *
+         * @param {number | string} target - PID (number) or Process Name (string).
          */
         this.kill = (target) => {
             if (typeof target === "number") {
@@ -75,27 +129,53 @@ class OSApi extends PathApi.BaseApi {
             }
         };
         /**
-         * **Get Active Ports**
+         * **Network Port Discovery**
+         *
+         * Scans and lists all active TCP/UDP ports on the system, including
+         * local/remote addresses and associated process names.
+         *
+         * @returns {PortInfo[]} List of active network ports.
          */
         this.ports = () => this.runner.runSync("sys", "ports");
         /**
-         * **Get System Temperatures**
+         * **Thermal Sensors Data**
+         *
+         * Retrieves temperature readings from various hardware sensors (CPU, GPU, Motherboard).
+         *
+         * @returns {any[]} List of sensor names and their current temperature in Celsius.
          */
         this.temp = () => this.runner.runSync("sys", "temp");
         /**
-         * **Get Battery Status**
+         * **Battery & Power Management**
+         *
+         * Retrieves battery status, charge level, and power source information.
+         * Useful for managing background tasks on mobile/laptop hardware.
+         *
+         * @returns {BatteryInfo} Battery status metadata.
          */
         this.battery = () => this.runner.runSync("sys", "battery");
         /**
-         * **Get Operating System Platform**
+         * **Current OS Platform**
+         *
+         * Returns the operating system platform (e.g., 'linux', 'darwin', 'win32').
+         *
+         * @returns {string} Platform identifier.
          */
         this.platform = () => process.platform;
         /**
-         * **Get User Home Directory**
+         * **User Home Path**
+         *
+         * Returns the absolute path to the current user's home directory.
+         *
+         * @returns {string} Absolute home directory path.
          */
         this.homeDir = () => this.runner.runSync("sys", "home-dir");
         /**
-         * **Get Operating System Architecture**
+         * **System CPU Architecture**
+         *
+         * Returns the processor architecture (e.g., 'x64', 'arm64').
+         *
+         * @returns {string} Architecture identifier.
          */
         this.arch = () => process.arch;
     }
@@ -115,7 +195,12 @@ class OSApi extends PathApi.BaseApi {
         };
     }
     /**
-     * **Get Hardware Telemetry**
+     * **Unified Hardware Telemetry**
+     *
+     * Combines memory, CPU, and low-level system metadata into a single
+     * comprehensive hardware profile. Useful for system monitoring dashboards.
+     *
+     * @returns {SystemHardware} Complete hardware and OS profile.
      */
     get hardware() {
         const mem = this.memory();

package/dist/cjs/src/xhsc/OSApi.js.map

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

package/dist/cjs/src/xhsc/fs/FSArchive.js

@@ -9,46 +9,57 @@ class FSArchive extends FSSearch.FSSearch {
     constructor() {
         super(...arguments);
         /**
-         * **Compress File**
-         * Performs lossless compression on a file.
+         * **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
-         * ```typescript
-         * __sys__.fs.compress("data.json", "data.json.gz");
-         * ```
+         * __sys__.fs.compress("backup.sql", "backup.sql.gz");
          */
         this.compress = (src, dest) => {
             this.runner.runSync("archive", "compress", [], { src, dest });
         };
         /**
-         * **Decompress File**
+         * **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
-         * ```typescript
-         * __sys__.fs.decompress("data.json.gz", "data.json");
-         * ```
+         * __sys__.fs.decompress("data.gz", "data.json");
          */
         this.decompress = (src, dest) => {
             this.runner.runSync("archive", "decompress", [], { src, dest });
         };
         /**
-         * **Create Tar Archive**
+         * **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
-         * ```typescript
-         * __sys__.fs.tar("./src", "src_backup.tar");
-         * ```
+         * __sys__.fs.tar("./src", "project_source.tar");
          */
         this.tar = (dir, output) => {
             this.runner.runSync("archive", "tar", [], { dir, output });
         };
         /**
-         * **Extract Tar Archive**
+         * **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
-         * ```typescript
-         * __sys__.fs.untar("archive.tar", "./output");
-         * ```
+         * __sys__.fs.untar("dist.tar", "./production");
          */
         this.untar = (archive, dest) => {
             this.runner.runSync("archive", "untar", [], { archive, dest });

package/dist/cjs/src/xhsc/fs/FSArchive.js.map

@@ -1 +1 @@
-{"version":3,"file":"FSArchive.js","sources":["../../../../../src/xhsc/fs/FSArchive.ts"],"sourcesContent":[null],"names":["FSSearch"],"mappings":";;;;AAEA;;AAEG;AACG,MAAO,SAAU,SAAQA,iBAAQ,CAAA;AAAvC,IAAA,WAAA,GAAA;;AACI;;;;;;;;AAQG;AACI,QAAA,IAAA,CAAA,QAAQ,GAAG,CAAC,GAAW,EAAE,IAAY,KAAU;AAClD,YAAA,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACjE,QAAA,CAAC;AAED;;;;;;;AAOG;AACI,QAAA,IAAA,CAAA,UAAU,GAAG,CAAC,GAAW,EAAE,IAAY,KAAU;AACpD,YAAA,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACnE,QAAA,CAAC;AAED;;;;;;;AAOG;AACI,QAAA,IAAA,CAAA,GAAG,GAAG,CAAC,GAAW,EAAE,MAAc,KAAU;AAC/C,YAAA,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AAC9D,QAAA,CAAC;AAED;;;;;;;AAOG;AACI,QAAA,IAAA,CAAA,KAAK,GAAG,CAAC,OAAe,EAAE,IAAY,KAAU;AACnD,YAAA,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAClE,QAAA,CAAC;IACL;AAAC;;;;"}
+{"version":3,"file":"FSArchive.js","sources":["../../../../../src/xhsc/fs/FSArchive.ts"],"sourcesContent":[null],"names":["FSSearch"],"mappings":";;;;AAEA;;AAEG;AACG,MAAO,SAAU,SAAQA,iBAAQ,CAAA;AAAvC,IAAA,WAAA,GAAA;;AACI;;;;;;;;;;AAUG;AACI,QAAA,IAAA,CAAA,QAAQ,GAAG,CAAC,GAAW,EAAE,IAAY,KAAU;AAClD,YAAA,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACjE,QAAA,CAAC;AAED;;;;;;;;;;AAUG;AACI,QAAA,IAAA,CAAA,UAAU,GAAG,CAAC,GAAW,EAAE,IAAY,KAAU;AACpD,YAAA,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACnE,QAAA,CAAC;AAED;;;;;;;;;;AAUG;AACI,QAAA,IAAA,CAAA,GAAG,GAAG,CAAC,GAAW,EAAE,MAAc,KAAU;AAC/C,YAAA,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AAC9D,QAAA,CAAC;AAED;;;;;;;;;;AAUG;AACI,QAAA,IAAA,CAAA,KAAK,GAAG,CAAC,OAAe,EAAE,IAAY,KAAU;AACnD,YAAA,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAClE,QAAA,CAAC;IACL;AAAC;;;;"}