xypriss 4.5.0 → 4.6.0

package/README.md

@@ -109,6 +109,9 @@ server.start(() => {
 
 -   **[Routing](./docs/ROUTING.md)** - Routes, parameters, wildcards, and middleware
 -   **[XJson API](./docs/XJSON_API.md)** - Advanced JSON serialization for BigInt and large data
+-   **[Global APIs](./docs/GLOBAL_APIS.md)** - Runtime globals overview
+-   **[Configuration API (**cfg**)](./docs/CFG_API.md)** - Deep dive into the configuration manager
+-   **[Immutability API (**const**)](./docs/CONST_API.md)** - Deep dive into the immutability engine
 -   **[File Upload](./docs/FILE_UPLOAD_GUIDE.md)** - Complete file upload guide with runtime compatibility
 -   **[Security](./docs/SECURITY.md)** - CORS, CSRF, rate limiting, and security best practices
 -   **[Multi-Server](./docs/MULTI_SERVER.md)** - Running multiple server instances

package/dist/cjs/src/config.js

@@ -142,7 +142,14 @@ class ConfigurationManager {
      */
     static merge(config) {
         const instance = ConfigurationManager.getInstance();
+        // Check if the incoming config is marked as immutable
+        const shouldBeImmutable = config?.__isXyPrissImmutable;
         instance.config = ConfigurationManager.deepMerge(instance.config, config);
+        // If it should be immutable, wrap it using the global __const__.$make
+        if (shouldBeImmutable &&
+            typeof globalThis.__const__ !== "undefined") {
+            instance.config = globalThis.__const__.$make(instance.config, "Configs");
+        }
         instance.initialized = true;
     }
     /**
@@ -190,7 +197,18 @@ class ConfigurationManager {
         delete instance.config[key];
     }
 }
+// Self-register global __cfg__ if in a global environment
+if (typeof globalThis !== "undefined") {
+    globalThis.__cfg__ =
+        globalThis.__cfg__ || ConfigurationManager;
+}
+/**
+ * Default instance for easy access
+ */
+const __cfg__ = globalThis
+    .__cfg__;
 
 exports.CM = ConfigurationManager;
 exports.Configs = ConfigurationManager;
+exports.__cfg__ = __cfg__;
 //# sourceMappingURL=config.js.map

package/dist/cjs/src/config.js.map

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

package/dist/cjs/src/const.js

@@ -0,0 +1,310 @@
+'use strict';
+
+/**************************************************************************************************************************************************************
+ * This code contains proprietary source code from NEHONIX
+ *
+ * @author Nehonix
+ * @license NOSL
+ * @version v1.0
+ * @see {@link https://dll.nehonix.com/licenses/NOSL}
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ *
+ *
+ * This License governs the use, modification, and distribution of software provided by NEHONIX under its open source projects.
+ * NEHONIX is committed to fostering collaborative innovation while strictly protecting its intellectual property rights.
+ * Violation of any term of this License will result in immediate termination of all granted rights and may subject the violator to legal action.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+ * IN NO EVENT SHALL NEHONIX BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE
+ * OR INABILITY TO USE THE SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+ ************************************************************************************************************************************************************** */
+/**
+ * XyPriss Constant Variables Class
+ *
+ * Provides a mechanism to store immutable values that cannot be changed once set.
+ * This is useful for protecting critical application constants from being
+ * modified by plugins or other modules at runtime.
+ *
+ * @class XyPrissConst
+ * @version 2.0.0
+ */
+class XyPrissConst {
+    constructor() {
+        this.constants = new Map();
+        this.immutableCache = new WeakMap();
+    }
+    /**
+     * Make a value deeply immutable using Proxy protection.
+     * This ACTIVELY blocks any modification attempts with clear error messages.
+     * Works with objects, arrays, Maps, Sets, and nested structures.
+     *
+     * @template T - Type of the value to freeze
+     * @param {T} value - The value to make immutable
+     * @param {string} [path] - Internal path tracking for error messages
+     * @returns {T} The deeply protected immutable value
+     *
+     * @example
+     * ```typescript
+     * const config = __const__.$make({
+     *   server: { port: 8080, host: 'localhost' },
+     *   features: ['auth', 'logging']
+     * });
+     * config.server.port = 9000; // ❌ THROWS ERROR IMMEDIATELY
+     * ```
+     */
+    $make(value, path = "root") {
+        if (value === null || value === undefined) {
+            return value;
+        }
+        const type = typeof value;
+        // Primitives are immutable by nature
+        if (type !== "object" && type !== "function") {
+            return value;
+        }
+        // Check if it's already one of our immutable proxies
+        if (value?.__isXyPrissImmutable) {
+            return value;
+        }
+        // Check cache to avoid re-wrapping
+        if (this.immutableCache.has(value)) {
+            return this.immutableCache.get(value);
+        }
+        // Freeze the original object
+        Object.freeze(value);
+        let proxied;
+        // Handle arrays
+        if (Array.isArray(value)) {
+            const frozenArray = value.map((item, index) => this.$make(item, `${path}[${index}]`));
+            proxied = new Proxy(frozenArray, {
+                get: (target, prop) => {
+                    if (prop === "__isXyPrissImmutable")
+                        return true;
+                    return target[prop];
+                },
+                set: (target, prop, val) => {
+                    throw new Error(`[XyPrissConst] Cannot modify immutable array at "${path}.${String(prop)}". ` +
+                        `Attempted to set value: ${JSON.stringify(val)}`);
+                },
+                deleteProperty: (target, prop) => {
+                    throw new Error(`[XyPrissConst] Cannot delete property "${String(prop)}" from immutable array at "${path}"`);
+                },
+                defineProperty: (target, prop) => {
+                    throw new Error(`[XyPrissConst] Cannot define property "${String(prop)}" on immutable array at "${path}"`);
+                },
+            });
+            this.immutableCache.set(value, proxied);
+            return proxied;
+        }
+        // Handle Maps
+        if (value instanceof Map) {
+            const frozenMap = new Map();
+            value.forEach((v, k) => {
+                frozenMap.set(this.$make(k, `${path}<key>`), this.$make(v, `${path}.get("${k}")`));
+            });
+            proxied = new Proxy(frozenMap, {
+                get: (target, prop) => {
+                    if (prop === "__isXyPrissImmutable")
+                        return true;
+                    if (prop === "set" ||
+                        prop === "delete" ||
+                        prop === "clear") {
+                        return () => {
+                            throw new Error(`[XyPrissConst] Cannot call Map.${String(prop)}() on immutable Map at "${path}"`);
+                        };
+                    }
+                    return target[prop];
+                },
+            });
+            this.immutableCache.set(value, proxied);
+            return proxied;
+        }
+        // Handle Sets
+        if (value instanceof Set) {
+            const frozenSet = new Set();
+            value.forEach((item) => {
+                frozenSet.add(this.$make(item, `${path}<item>`));
+            });
+            proxied = new Proxy(frozenSet, {
+                get: (target, prop) => {
+                    if (prop === "__isXyPrissImmutable")
+                        return true;
+                    if (prop === "add" ||
+                        prop === "delete" ||
+                        prop === "clear") {
+                        return () => {
+                            throw new Error(`[XyPrissConst] Cannot call Set.${String(prop)}() on immutable Set at "${path}"`);
+                        };
+                    }
+                    return target[prop];
+                },
+            });
+            this.immutableCache.set(value, proxied);
+            return proxied;
+        }
+        // Handle Dates - return as is (already immutable)
+        if (value instanceof Date) {
+            return value;
+        }
+        // Handle regular objects and class instances
+        const frozenObj = {};
+        const proto = Object.getPrototypeOf(value);
+        // Copy all properties recursively
+        Object.getOwnPropertyNames(value).forEach((prop) => {
+            const descriptor = Object.getOwnPropertyDescriptor(value, prop);
+            if (descriptor && descriptor.value !== undefined) {
+                if (typeof descriptor.value === "function") {
+                    // Keep methods as-is
+                    frozenObj[prop] = descriptor.value;
+                }
+                else {
+                    // Recursively protect nested values
+                    frozenObj[prop] = this.$make(descriptor.value, `${path}.${prop}`);
+                }
+            }
+        });
+        // Copy symbol properties
+        Object.getOwnPropertySymbols(value).forEach((sym) => {
+            const descriptor = Object.getOwnPropertyDescriptor(value, sym);
+            if (descriptor && descriptor.value !== undefined) {
+                if (typeof descriptor.value !== "function") {
+                    frozenObj[sym] = this.$make(descriptor.value, `${path}[Symbol]`);
+                }
+                else {
+                    frozenObj[sym] = descriptor.value;
+                }
+            }
+        });
+        // Set the prototype
+        Object.setPrototypeOf(frozenObj, proto);
+        Object.freeze(frozenObj);
+        // Wrap in Proxy for active protection
+        proxied = new Proxy(frozenObj, {
+            get: (target, prop) => {
+                if (prop === "__isXyPrissImmutable")
+                    return true;
+                return target[prop];
+            },
+            set: (target, prop, val) => {
+                const errorMsg = `[XyPrissConst] Cannot modify immutable property "${path}.${String(prop)}". ` + `Attempted to set value: ${JSON.stringify(val)}`;
+                throw new Error(errorMsg);
+            },
+            deleteProperty: (target, prop) => {
+                throw new Error(`[XyPrissConst] Cannot delete immutable property "${path}.${String(prop)}"`);
+            },
+            defineProperty: (target, prop) => {
+                throw new Error(`[XyPrissConst] Cannot define property "${String(prop)}" on immutable object at "${path}"`);
+            },
+            setPrototypeOf: () => {
+                throw new Error(`[XyPrissConst] Cannot change prototype of immutable object at "${path}"`);
+            },
+        });
+        this.immutableCache.set(value, proxied);
+        return proxied;
+    }
+    /**
+     * Define a new constant.
+     * Throws an error if the constant is already defined.
+     * Automatically makes the value deeply immutable.
+     *
+     * @param {string} key - The unique identifier for the constant
+     * @param {any} value - The value to store (will be made immutable)
+     * @throws {Error} If the key already exists
+     *
+     * @example
+     * ```typescript
+     * __const__.$set('APP_CONFIG', {
+     *   database: { host: 'localhost', port: 5432 }
+     * });
+     * ```
+     */
+    $set(key, value) {
+        if (this.constants.has(key)) {
+            throw new Error(`[XyPrissConst] Cannot redefine constant "${key}". Constants are immutable.`);
+        }
+        // Make the value deeply immutable before storing
+        const immutableValue = this.$make(value, key);
+        this.constants.set(key, immutableValue);
+    }
+    /**
+     * Retrieve a constant value.
+     *
+     * @template T - Expected type of the constant
+     * @param {string} key - The identifier of the constant
+     * @param {T} [defaultValue] - Optional fallback value if not found
+     * @returns {T} The constant value or default
+     *
+     * @example
+     * ```typescript
+     * const appId = __const__.$get('APP_ID');
+     * ```
+     */
+    $get(key, defaultValue) {
+        return (this.constants.has(key) ? this.constants.get(key) : defaultValue);
+    }
+    /**
+     * Check if a constant is defined.
+     *
+     * @param {string} key - The identifier to check
+     * @returns {boolean} True if the constant exists
+     */
+    $has(key) {
+        return this.constants.has(key);
+    }
+    /**
+     * Export all constants as a plain object.
+     * Note: Returns a frozen snapshot, not the proxy-protected originals.
+     *
+     * @returns {Record<string, any>}
+     */
+    $toJSON() {
+        const obj = Object.fromEntries(this.constants);
+        return Object.freeze(obj);
+    }
+    /**
+     * Delete a constant (use with extreme caution).
+     * This is primarily for testing purposes.
+     *
+     * @param {string} key - The identifier to delete
+     * @returns {boolean} True if the constant was deleted
+     */
+    $delete(key) {
+        return this.constants.delete(key);
+    }
+    /**
+     * Clear all constants (use with extreme caution).
+     * This is primarily for testing purposes.
+     */
+    $clear() {
+        this.constants.clear();
+    }
+    /**
+     * Get the total number of constants stored.
+     *
+     * @returns {number} The count of constants
+     */
+    $size() {
+        return this.constants.size;
+    }
+    /**
+     * List all constant keys.
+     *
+     * @returns {string[]} Array of all constant keys
+     */
+    $keys() {
+        return Array.from(this.constants.keys());
+    }
+}
+// Self-register global __const__ if in a global environment
+if (typeof globalThis !== "undefined") {
+    globalThis.__const__ =
+        globalThis.__const__ || new XyPrissConst();
+}
+/**
+ * Default instance for easy access
+ */
+const __const__ = globalThis.__const__;
+
+exports.XyPrissConst = XyPrissConst;
+exports.__const__ = __const__;
+//# sourceMappingURL=const.js.map

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

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

package/dist/cjs/src/index.js

@@ -4,12 +4,13 @@ var fileUpload = require('./file-upload.js');
 var Router$1 = require('./server/routing/Router.js');
 var ConfigLoader = require('./server/utils/ConfigLoader.js');
 var sys = require('./sys.js');
+var config = require('./config.js');
+var _const = require('./const.js');
 var ServerFactory = require('./server/ServerFactory.js');
 var smartRoutes = require('./server/components/fastapi/smart-routes.js');
 var CacheFactory = require('./cache/CacheFactory.js');
 var securityMiddleware = require('./middleware/security-middleware.js');
 var performanceMonitor = require('./server/optimization/performance-monitor.js');
-var config = require('./config.js');
 var XJsonResponseHandler = require('./middleware/XJsonResponseHandler.js');
 var index = require('./plugins/modules/index.js');
 var PluginAPI = require('./plugins/api/PluginAPI.js');
@@ -62,18 +63,9 @@ var NetworkPluginUtils = require('./plugins/modules/network/utils/NetworkPluginU
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  ***************************************************************************** */
-// Initialize __sys__ global if it doesn't exist
+// Load and apply system configuration from xypriss.config.json
 if (typeof globalThis !== "undefined") {
-    // Load and apply system configuration from xypriss.config.json
     ConfigLoader.configLoader.loadAndApplySysConfig();
-    const defaultPort = parseInt(process.env["PORT"] || "3000");
-    globalThis.__sys__ =
-        globalThis.__sys__ ||
-            new sys.XyPrissSys({
-                __port__: defaultPort,
-                __PORT__: defaultPort,
-                __env__: process.env["NODE_ENV"] || "development",
-            });
 }
 /**
  * Default router instance for quick start
@@ -90,6 +82,11 @@ exports.FLA = fileUpload.FileUploadAPI;
 exports.FileUploadAPI = fileUpload.FileUploadAPI;
 exports.Upload = fileUpload.Upload;
 exports.XyPrissRouter = Router$1.XyPrissRouter;
+exports.__sys__ = sys.__sys__;
+exports.CM = config.Configs;
+exports.Configs = config.Configs;
+exports.__cfg__ = config.__cfg__;
+exports.__const__ = _const.__const__;
 exports.createCacheMiddleware = ServerFactory.createCacheMiddleware;
 exports.createServer = ServerFactory.createServer;
 exports.createServerInstance = ServerFactory.createServerInstance;
@@ -97,8 +94,6 @@ exports.Route = smartRoutes.Route;
 exports.createOptimalCache = CacheFactory.createOptimalCache;
 exports.SecurityMiddleware = securityMiddleware.SecurityMiddleware;
 exports.PerformanceMonitor = performanceMonitor.PerformanceMonitor;
-exports.CM = config.Configs;
-exports.Configs = config.Configs;
 exports.XJsonResponseHandler = XJsonResponseHandler.XJsonResponseHandler;
 exports.DEFAULT_PLUGIN_CONFIG = index.DEFAULT_PLUGIN_CONFIG;
 exports.PERFORMANCE_TARGETS = index.PERFORMANCE_TARGETS;

package/dist/cjs/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/index.ts"],"sourcesContent":[null],"names":["configLoader","XyPrissSys","XyPrissRouter"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBiF;AAQjF;AACA,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE;;IAEnCA,yBAAY,CAAC,qBAAqB,EAAE,CAAC;AACrC,IAAA,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC;AAC3D,IAAA,UAAkB,CAAC,OAAO;AACtB,QAAA,UAAkB,CAAC,OAAO;AAC3B,YAAA,IAAIC,cAAU,CAAC;AACX,gBAAA,QAAQ,EAAE,WAAW;AACrB,gBAAA,QAAQ,EAAE,WAAW;gBACrB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,aAAa;AACpD,aAAA,CAAC,CAAC;AACX,CAAC;AAyCD;;AAEG;SACa,MAAM,GAAA;IAClB,OAAO,IAAIC,sBAAa,CAAC;AACrB,QAAA,aAAa,EAAE,KAAK;AACpB,QAAA,WAAW,EAAE,KAAK;AAClB,QAAA,MAAM,EAAE,KAAK;AAChB,KAAA,CAAC,CAAC;AACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":["../../../src/index.ts"],"sourcesContent":[null],"names":["configLoader","XyPrissRouter"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBiF;AAWjF;AACA,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE;IACnCA,yBAAY,CAAC,qBAAqB,EAAE,CAAC;AACzC,CAAC;AA4CD;;AAEG;SACa,MAAM,GAAA;IAClB,OAAO,IAAIC,sBAAa,CAAC;AACrB,QAAA,aAAa,EAAE,KAAK;AACpB,QAAA,WAAW,EAAE,KAAK;AAClB,QAAA,MAAM,EAAE,KAAK;AAChB,KAAA,CAAC,CAAC;AACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/src/sys.js

@@ -608,6 +608,22 @@ class XyPrissSys {
         return new XyPrissSys(this.$toJSON());
     }
 }
+// Self-register global __sys__ if in a global environment
+if (typeof globalThis !== "undefined") {
+    const defaultPort = parseInt(process.env["PORT"] || "3000");
+    globalThis.__sys__ =
+        globalThis.__sys__ ||
+            new XyPrissSys({
+                __port__: defaultPort,
+                __PORT__: defaultPort,
+                __env__: process.env["NODE_ENV"] || "development",
+            });
+}
+/**
+ * Default instance for easy access
+ */
+const __sys__ = globalThis.__sys__;
 
 exports.XyPrissSys = XyPrissSys;
+exports.__sys__ = __sys__;
 //# sourceMappingURL=sys.js.map

package/dist/cjs/src/sys.js.map

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

package/dist/esm/src/config.js

@@ -140,7 +140,14 @@ class ConfigurationManager {
      */
     static merge(config) {
         const instance = ConfigurationManager.getInstance();
+        // Check if the incoming config is marked as immutable
+        const shouldBeImmutable = config?.__isXyPrissImmutable;
         instance.config = ConfigurationManager.deepMerge(instance.config, config);
+        // If it should be immutable, wrap it using the global __const__.$make
+        if (shouldBeImmutable &&
+            typeof globalThis.__const__ !== "undefined") {
+            instance.config = globalThis.__const__.$make(instance.config, "Configs");
+        }
         instance.initialized = true;
     }
     /**
@@ -188,6 +195,16 @@ class ConfigurationManager {
         delete instance.config[key];
     }
 }
+// Self-register global __cfg__ if in a global environment
+if (typeof globalThis !== "undefined") {
+    globalThis.__cfg__ =
+        globalThis.__cfg__ || ConfigurationManager;
+}
+/**
+ * Default instance for easy access
+ */
+const __cfg__ = globalThis
+    .__cfg__;
 
-export { ConfigurationManager as CM, ConfigurationManager as Configs };
+export { ConfigurationManager as CM, ConfigurationManager as Configs, __cfg__ };
 //# sourceMappingURL=config.js.map

package/dist/esm/src/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sources":["../../../src/config.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCG;AAKH;;;AAGG;AACH,MAAM,oBAAoB,CAAA;AAKtB;;;AAGG;AACH,IAAA,WAAA,GAAA;QANQ,IAAW,CAAA,WAAA,GAAY,KAAK,CAAC;;AAQjC,QAAA,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,eAAe,EAAE,CAAC;KACxC;AAED;;AAEG;AACK,IAAA,OAAO,WAAW,GAAA;AACtB,QAAA,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE;AAChC,YAAA,oBAAoB,CAAC,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAC;SAC9D;QACD,OAAO,oBAAoB,CAAC,QAAQ,CAAC;KACxC;AAED;;;AAGG;IACI,OAAO,GAAG,CAAC,MAAqB,EAAA;AACnC,QAAA,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC;AACpD,QAAA,QAAQ,CAAC,MAAM,GAAG,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;AACpD,QAAA,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC;KAC/B;AAED;;;;AAIG;IACI,OAAO,GAAG,CAAgC,GAAM,EAAA;AACnD,QAAA,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC;AACpD,QAAA,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;KAC/B;AAED;;;AAGG;AACI,IAAA,OAAO,MAAM,GAAA;AAChB,QAAA,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC;AACpD,QAAA,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;KACjC;AAED;;;;AAIG;AACI,IAAA,OAAO,MAAM,CAChB,GAAM,EACN,KAAgC,EAAA;AAEhC,QAAA,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;;QAG1C,IACI,OAAO,YAAY,KAAK,QAAQ;AAChC,YAAA,YAAY,KAAK,IAAI;AACrB,YAAA,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAC9B;AACE,YAAA,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG;AACnB,gBAAA,GAAG,YAAY;AACf,gBAAA,GAAG,KAAK;aACS,CAAC;SACzB;aAAM;;AAEH,YAAA,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAyB,CAAC;SACpD;KACJ;AAED;;;;;AAKG;AACK,IAAA,OAAO,SAAS,CACpB,MAAS,EACT,MAAkB,EAAA;AAElB,QAAA,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;AAE7B,QAAA,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;AACtB,YAAA,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;AAChC,YAAA,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;AAEhC,YAAA,IACI,WAAW;gBACX,OAAO,WAAW,KAAK,QAAQ;AAC/B,gBAAA,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;gBAC3B,WAAW;gBACX,OAAO,WAAW,KAAK,QAAQ;AAC/B,gBAAA,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC7B;;AAEE,gBAAA,MAAM,CAAC,GAAG,CAAC,GAAG,oBAAoB,CAAC,SAAS,CACxC,WAAW,EACX,WAAW,CACiB,CAAC;aACpC;AAAM,iBAAA,IAAI,WAAW,KAAK,SAAS,EAAE;;AAElC,gBAAA,MAAM,CAAC,GAAG,CAAC,GAAG,WAAkB,CAAC;aACpC;SACJ;AAED,QAAA,OAAO,MAAM,CAAC;KACjB;AAED;;;AAGG;IACI,OAAO,KAAK,CAAC,MAA8B,EAAA;AAC9C,QAAA,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC;AACpD,QAAA,QAAQ,CAAC,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAC5C,QAAQ,CAAC,MAAM,EACf,MAAM,CACT,CAAC;AACF,QAAA,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC;KAC/B;AAED;;;AAGG;AACI,IAAA,OAAO,aAAa,GAAA;AACvB,QAAA,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC;QACpD,OAAO,QAAQ,CAAC,WAAW,CAAC;KAC/B;AAED;;;AAGG;AACI,IAAA,OAAO,KAAK,GAAA;AACf,QAAA,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC;AACpD,QAAA,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC;AACrB,QAAA,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC;KAChC;AAED;;;;AAIG;IACI,OAAO,GAAG,CAAgC,GAAM,EAAA;AACnD,QAAA,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC;AACpD,QAAA,OAAO,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;KACvE;AAED;;;;;AAKG;AACI,IAAA,OAAO,YAAY,CACtB,GAAM,EACN,YAA8B,EAAA;AAE9B,QAAA,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC;QACpD,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC;KAC/C;AAED;;;AAGG;IACI,OAAO,MAAM,CAAgC,GAAM,EAAA;AACtD,QAAA,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC;AACpD,QAAA,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;KAC/B;AACJ;;;;"}
+{"version":3,"file":"config.js","sources":["../../../src/config.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}