xypriss 9.9.6 → 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":"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"}

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/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;;;;"}