xypriss 4.3.6 → 4.4.1

package/dist/cjs/src/sys.js

@@ -0,0 +1,600 @@
+'use strict';
+
+/**
+ * XyPriss System Variables Class
+ *
+ * Provides centralized access to system variables, configuration management,
+ * and environment utilities for XyPriss applications. This class serves as
+ * a type-safe wrapper around system configuration with built-in helpers
+ * for common operations.
+ *
+ * @class XyPrissSys
+ * @version 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // Initialize with default values
+ * const sys = new XyPrissSys({
+ *   __version__: "1.0.0",
+ *   __author__: "John Doe",
+ *   __port__: 8080,
+ *   __env__: "production"
+ * });
+ *
+ * // Check environment
+ * if (__sys__$isProduction()) {
+ *   console.log('Running in production mode');
+ * }
+ *
+ * // Access variables
+ * const port = __sys__$get('__port__', 3000);
+ * ```
+ */
+class XyPrissSys {
+    /**
+     * Creates a new XyPrissSys instance with optional initial data.
+     * All port-related properties are automatically synchronized.
+     *
+     * @constructor
+     * @param {Record<string, any>} [data={}] - Initial system variable data
+     *
+     * @example
+     * ```typescript
+     * // Create with defaults
+     * const sys = new XyPrissSys();
+     *
+     * // Create with custom data
+     * const sys = new XyPrissSys({
+     *   __version__: "2.0.0",
+     *   __author__: "Development Team",
+     *   __port__: 8080,
+     *   __env__: "production",
+     *   customVar: "custom value"
+     * });
+     * ```
+     */
+    constructor(data = {}) {
+        /**
+         * Application version string following semantic versioning.
+         *
+         * @type {string}
+         * @default "0.0.0"
+         *
+         * @example
+         * ```typescript
+         * __sys____version__ = "1.2.3";
+         * console.log(`App version: ${__sys____version__}`);
+         * ```
+         */
+        this.__version__ = "0.0.0";
+        /**
+         * Application author or maintainer name.
+         *
+         * @type {string}
+         * @default "unknown"
+         *
+         * @example
+         * ```typescript
+         * __sys____author__ = "Jane Smith";
+         * ```
+         */
+        this.__author__ = "unknown";
+        /**
+         * Collection of application URLs for various environments or services.
+         * Useful for storing API endpoints, frontend URLs, or external service links.
+         *
+         * @type {Record<string, string>}
+         * @default {}
+         *
+         * @example
+         * ```typescript
+         * __sys____app_urls__ = {
+         *   api: "https://api.example.com",
+         *   frontend: "https://app.example.com",
+         *   docs: "https://docs.example.com"
+         * };
+         *
+         * const apiUrl = __sys____app_urls__.api;
+         * ```
+         */
+        this.__app_urls__ = {};
+        /**
+         * Application name identifier.
+         *
+         * @type {string}
+         * @default "xypriss-app"
+         *
+         * @example
+         * ```typescript
+         * __sys____name__ = "my-awesome-app";
+         * ```
+         */
+        this.__name__ = "xypriss-app";
+        /**
+         * Application alias or short name.
+         * Used for abbreviated references or CLI commands.
+         *
+         * @type {string}
+         * @default "app"
+         *
+         * @example
+         * ```typescript
+         * __sys____alias__ = "myapp";
+         * ```
+         */
+        this.__alias__ = "app";
+        /**
+         * Server port number (lowercase variant).
+         * Synchronized automatically with __PORT__.
+         *
+         * @type {number}
+         * @default 3000
+         *
+         * @example
+         * ```typescript
+         * __sys____port__ = 8080;
+         * console.log(__sys____PORT__); // Also 8080 (auto-synced)
+         * ```
+         */
+        this.__port__ = 3000;
+        /**
+         * Server port number (uppercase variant).
+         * Synchronized automatically with __port__.
+         *
+         * @type {number}
+         * @default 3000
+         *
+         * @example
+         * ```typescript
+         * __sys____PORT__ = 5000;
+         * console.log(__sys____port__); // Also 5000 (auto-synced)
+         * ```
+         */
+        this.__PORT__ = 3000;
+        /**
+         * Current environment mode.
+         * Typically "development", "production", "staging", or "test".
+         *
+         * @type {string}
+         * @default "development"
+         *
+         * @example
+         * ```typescript
+         * __sys____env__ = "production";
+         * if (__sys__$isProduction()) {
+         *   // Production-specific logic
+         * }
+         * ```
+         */
+        this.__env__ = "development";
+        /**
+         * Environment variables manager providing access to process.env.
+         * Offers a clean API for getting, setting, and managing environment variables.
+         *
+         * @type {Object}
+         * @property {Function} set - Set an environment variable
+         * @property {Function} get - Get an environment variable with optional default
+         * @property {Function} has - Check if an environment variable exists
+         * @property {Function} delete - Remove an environment variable
+         * @property {Function} all - Get all environment variables
+         *
+         * @example
+         * ```typescript
+         * // Set environment variable
+         * __sys____ENV__.set('API_KEY', 'secret123');
+         *
+         * // Get with default
+         * const apiKey = __sys____ENV__.get('API_KEY', 'default-key');
+         *
+         * // Check existence
+         * if (__sys____ENV__.has('DATABASE_URL')) {
+         *   const dbUrl = __sys____ENV__.get('DATABASE_URL');
+         * }
+         *
+         * // Delete variable
+         * __sys____ENV__.delete('TEMP_VAR');
+         *
+         * // Get all variables
+         * const allEnv = __sys____ENV__.all();
+         * ```
+         */
+        this.__ENV__ = {
+            /**
+             * Set an environment variable.
+             *
+             * @param {string} key - The environment variable name
+             * @param {string} value - The value to set
+             * @returns {void}
+             */
+            set: (key, value) => {
+                process.env[key] = value;
+            },
+            /**
+             * Get an environment variable with an optional default value.
+             *
+             * @param {string} key - The environment variable name
+             * @param {string} [defaultValue] - Default value if variable is not set
+             * @returns {string | undefined} The environment variable value or default
+             */
+            get: (key, defaultValue) => {
+                return process.env[key] || defaultValue;
+            },
+            /**
+             * Check if an environment variable exists.
+             *
+             * @param {string} key - The environment variable name
+             * @returns {boolean} True if the variable exists
+             */
+            has: (key) => {
+                return process.env[key] !== undefined;
+            },
+            /**
+             * Delete an environment variable.
+             *
+             * @param {string} key - The environment variable name
+             * @returns {void}
+             */
+            delete: (key) => {
+                delete process.env[key];
+            },
+            /**
+             * Get all environment variables.
+             *
+             * @returns {NodeJS.ProcessEnv} All environment variables
+             */
+            all: () => {
+                return process.env;
+            },
+        };
+        this.$update(data);
+    }
+    /**
+     * Update system variables with new data.
+     * Automatically synchronizes __port__ and __PORT__ to maintain consistency.
+     * Supports backward compatibility for legacy single-underscore variants.
+     *
+     * @param {Record<string, any>} data - Partial data to merge into system variables
+     * @returns {void}
+     *
+     * @example
+     * ```typescript
+     * __sys__$update({
+     *   __version__: "1.5.0",
+     *   __port__: 9000,
+     *   newFeature: true
+     * });
+     *
+     * // Port is automatically synced
+     * console.log(__sys____port__);  // 9000
+     * console.log(__sys____PORT__);  // 9000
+     * ```
+     */
+    $update(data) {
+        Object.assign(this, data);
+        // Synchronize port variants
+        if (data.__port__ !== undefined)
+            this.__PORT__ = data.__port__;
+        if (data.__PORT__ !== undefined)
+            this.__port__ = data.__PORT__;
+        // Backward compatibility for single underscore
+        if (data.__port !== undefined) {
+            this.__port__ = data.__port;
+            this.__PORT__ = data.__port;
+        }
+        if (data.__PORT !== undefined) {
+            this.__port__ = data.__PORT;
+            this.__PORT__ = data.__PORT;
+        }
+        if (data.__env !== undefined)
+            this.__env__ = data.__env;
+    }
+    /**
+     * Add or update a single system variable.
+     * Provides a cleaner API for adding individual properties.
+     *
+     * @param {string} key - Variable name
+     * @param {any} value - Variable value (any type)
+     * @returns {void}
+     *
+     * @example
+     * ```typescript
+     * __sys__$add('databaseUrl', 'postgresql://localhost:5432/mydb');
+     * __sys__$add('maxConnections', 100);
+     * __sys__$add('features', { darkMode: true, beta: false });
+     *
+     * console.log(__sys__databaseUrl);    // 'postgresql://localhost:5432/mydb'
+     * console.log(__sys__maxConnections); // 100
+     * ```
+     */
+    $add(key, value) {
+        this[key] = value;
+    }
+    /**
+     * Remove a system variable.
+     *
+     * @param {string} key - Variable name to remove
+     * @returns {boolean} True if the variable existed and was removed
+     *
+     * @example
+     * ```typescript
+     * __sys__$add('tempVar', 'temporary');
+     * console.log(__sys__$has('tempVar')); // true
+     *
+     * __sys__$remove('tempVar');
+     * console.log(__sys__$has('tempVar')); // false
+     * ```
+     */
+    $remove(key) {
+        if (this.$has(key)) {
+            delete this[key];
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Export all system variables as a plain JavaScript object.
+     * Excludes internal methods (starting with $) and the __ENV__ manager.
+     * Useful for serialization, logging, or persistence.
+     *
+     * @returns {Record<string, any>} Plain object containing all system variables
+     *
+     * @example
+     * ```typescript
+     * const config = __sys__$toJSON();
+     * console.log(JSON.stringify(config, null, 2));
+     *
+     * // Save to file
+     * fs.writeFileSync('config.json', JSON.stringify(config, null, 2));
+     *
+     * // Send in API response
+     * res.json({ system: config });
+     * ```
+     */
+    $toJSON() {
+        const json = {};
+        for (const key in this) {
+            if (!key.startsWith("$") &&
+                typeof this[key] !== "function" &&
+                key !== "__ENV__") {
+                json[key] = this[key];
+            }
+        }
+        return json;
+    }
+    /**
+     * Check if the current environment is production.
+     * Compares __env__ against "production" (case-sensitive).
+     *
+     * @returns {boolean} True if environment is production
+     *
+     * @example
+     * ```typescript
+     * if (__sys__$isProduction()) {
+     *   console.log('Running in production mode');
+     *   // Enable production optimizations
+     *   enableCaching();
+     *   disableDebugMode();
+     * }
+     * ```
+     */
+    $isProduction() {
+        return this.__env__ === "production";
+    }
+    /**
+     * Check if the current environment is development.
+     * Compares __env__ against "development" (case-sensitive).
+     *
+     * @returns {boolean} True if environment is development
+     *
+     * @example
+     * ```typescript
+     * if (__sys__$isDevelopment()) {
+     *   console.log('Running in development mode');
+     *   // Enable development features
+     *   enableHotReload();
+     *   showDebugInfo();
+     * }
+     * ```
+     */
+    $isDevelopment() {
+        return this.__env__ === "development";
+    }
+    /**
+     * Check if the current environment is staging.
+     * Compares __env__ against "staging" (case-sensitive).
+     *
+     * @returns {boolean} True if environment is staging
+     *
+     * @example
+     * ```typescript
+     * if (__sys__$isStaging()) {
+     *   console.log('Running in staging mode');
+     *   // Use staging configurations
+     * }
+     * ```
+     */
+    $isStaging() {
+        return this.__env__ === "staging";
+    }
+    /**
+     * Check if the current environment is test.
+     * Compares __env__ against "test" (case-sensitive).
+     *
+     * @returns {boolean} True if environment is test
+     *
+     * @example
+     * ```typescript
+     * if (__sys__$isTest()) {
+     *   console.log('Running in test mode');
+     *   // Use test database
+     *   useTestDatabase();
+     * }
+     * ```
+     */
+    $isTest() {
+        return this.__env__ === "test";
+    }
+    /**
+     * Check if environment matches a custom environment name.
+     * Performs case-sensitive comparison.
+     *
+     * @param {string} envName - Environment name to check against
+     * @returns {boolean} True if current environment matches the provided name
+     *
+     * @example
+     * ```typescript
+     * if (__sys__$isEnvironment('qa')) {
+     *   console.log('Running in QA environment');
+     * }
+     *
+     * if (__sys__$isEnvironment('local')) {
+     *   // Local development specific code
+     * }
+     * ```
+     */
+    $isEnvironment(envName) {
+        return this.__env__ === envName;
+    }
+    /**
+     * Get a system variable with an optional default value.
+     * Type-safe retrieval with generic type parameter support.
+     *
+     * @template T - Expected type of the return value
+     * @param {string} key - Variable name to retrieve
+     * @param {T} [defaultValue] - Default value if variable doesn't exist
+     * @returns {T} The variable value or default value
+     *
+     * @example
+     * ```typescript
+     * // Get with type inference
+     * const port = __sys__$get<number>('__port__', 3000);
+     * const name = __sys__$get<string>('__name__', 'default-app');
+     *
+     * // Get complex types
+     * interface AppConfig {
+     *   theme: string;
+     *   features: string[];
+     * }
+     * const config = __sys__$get<AppConfig>('config', {
+     *   theme: 'light',
+     *   features: []
+     * });
+     *
+     * // Works with undefined variables
+     * const missing = __sys__$get('nonexistent', 'fallback'); // 'fallback'
+     * ```
+     */
+    $get(key, defaultValue) {
+        return (this[key] !== undefined ? this[key] : defaultValue);
+    }
+    /**
+     * Check if a system variable exists.
+     * Returns true even if the value is falsy (null, false, 0, empty string).
+     *
+     * @param {string} key - Variable name to check
+     * @returns {boolean} True if variable exists (even if falsy)
+     *
+     * @example
+     * ```typescript
+     * __sys__$add('enabled', false);
+     * __sys__$add('count', 0);
+     * __sys__$add('name', '');
+     *
+     * console.log(__sys__$has('enabled')); // true (even though value is false)
+     * console.log(__sys__$has('count'));   // true (even though value is 0)
+     * console.log(__sys__$has('name'));    // true (even though value is '')
+     * console.log(__sys__$has('missing')); // false
+     *
+     * // Conditional logic
+     * if (__sys__$has('apiKey')) {
+     *   const apiKey = __sys__$get('apiKey');
+     *   initializeAPI(apiKey);
+     * }
+     * ```
+     */
+    $has(key) {
+        return this[key] !== undefined;
+    }
+    /**
+     * Get all system variable keys.
+     * Excludes internal methods and the __ENV__ manager.
+     *
+     * @returns {string[]} Array of all variable names
+     *
+     * @example
+     * ```typescript
+     * const keys = __sys__$keys();
+     * console.log(keys); // ['__version__', '__author__', '__port__', ...]
+     *
+     * // Iterate over all variables
+     * keys.forEach(key => {
+     *   console.log(`${key}: ${__sys__$get(key)}`);
+     * });
+     * ```
+     */
+    $keys() {
+        return Object.keys(this).filter((key) => !key.startsWith("$") &&
+            typeof this[key] !== "function" &&
+            key !== "__ENV__");
+    }
+    /**
+     * Reset all system variables to default values.
+     * Preserves the __ENV__ manager instance.
+     *
+     * @returns {void}
+     *
+     * @example
+     * ```typescript
+     * __sys__$add('customVar', 'custom');
+     * __sys____version__ = "2.0.0";
+     *
+     * __sys__$reset();
+     *
+     * console.log(__sys____version__);     // "0.0.0" (default)
+     * console.log(__sys__$has('customVar')); // false
+     * ```
+     */
+    $reset() {
+        // Store __ENV__ reference
+        const envManager = this.__ENV__;
+        // Clear all properties
+        Object.keys(this).forEach((key) => {
+            if (key !== "__ENV__" && !key.startsWith("$")) {
+                delete this[key];
+            }
+        });
+        // Restore defaults
+        this.__version__ = "0.0.0";
+        this.__author__ = "unknown";
+        this.__app_urls__ = {};
+        this.__name__ = "xypriss-app";
+        this.__alias__ = "app";
+        this.__port__ = 3000;
+        this.__PORT__ = 3000;
+        this.__env__ = "development";
+        this.__ENV__ = envManager;
+    }
+    /**
+     * Clone the current system configuration.
+     * Creates a new instance with the same variable values.
+     *
+     * @returns {XyPrissSys} New instance with cloned values
+     *
+     * @example
+     * ```typescript
+     * const sys1 = new XyPrissSys({ __version__: "1.0.0" });
+     * const sys2 = sys1.$clone();
+     *
+     * sys2.__version__ = "2.0.0";
+     *
+     * console.log(sys1.__version__); // "1.0.0" (unchanged)
+     * console.log(sys2.__version__); // "2.0.0"
+     * ```
+     */
+    $clone() {
+        return new XyPrissSys(this.$toJSON());
+    }
+}
+
+exports.XyPrissSys = XyPrissSys;
+//# sourceMappingURL=sys.js.map

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

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

package/dist/esm/src/index.js

@@ -1,5 +1,6 @@
 export { FileUploadAPI as FLA, FileUploadAPI, Upload } from './file-upload.js';
 import { XyPrissRouter } from './server/routing/Router.js';
+import { XyPrissSys } from './sys.js';
 export { createCacheMiddleware, createServer, createServerInstance } from './server/ServerFactory.js';
 export { Route } from './server/components/fastapi/smart-routes.js';
 export { createOptimalCache } from './cache/CacheFactory.js';
@@ -58,6 +59,17 @@ export { NetworkPluginUtils } from './plugins/modules/network/utils/NetworkPlugi
  * 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
+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 router instance for quick start
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBiF;AA4CjF;;AAEG;SACa,MAAM,GAAA;IAClB,OAAO,IAAI,aAAa,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":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBiF;AAOjF;AACA,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE;AACnC,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,IAAI,UAAU,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,IAAI,aAAa,CAAC;AACrB,QAAA,aAAa,EAAE,KAAK;AACpB,QAAA,WAAW,EAAE,KAAK;AAClB,QAAA,MAAM,EAAE,KAAK;AAChB,KAAA,CAAC,CAAC;AACP;;;;"}

package/dist/esm/src/server/ServerFactory.js

@@ -41,6 +41,15 @@ export { expressStringify, fastStringify, safeStringify } from '../../mods/secur
 function createServer(options = {}) {
     if (options.env) {
         process.env["NODE_ENV"] = options.env;
+        if (typeof globalThis !== "undefined" && globalThis.__sys__) {
+            globalThis.__sys__.$update({ __env__: options.env });
+        }
+    }
+    // Update __sys__ with port if provided
+    if (options.server?.port &&
+        typeof globalThis !== "undefined" &&
+        globalThis.__sys__) {
+        globalThis.__sys__.$update({ __port__: options.server.port });
     }
     // Merge user options with default configs (Configs already has defaults)
     // This makes Configs the SINGLE SOURCE OF TRUTH