xypriss 9.12.59 → 9.12.62

package/dist/cjs/index.js

@@ -0,0 +1,2 @@
+// CommonJS re-export from src directory
+module.exports = require('./src/index.js');

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/src/ConfigurationManager.js

@@ -0,0 +1,388 @@
+'use strict';
+
+var _default = require('./server/const/default.js');
+var crypto = require('crypto');
+var mergeWithDefaults = require('./utils/mergeWithDefaults.js');
+var WEAK_SECRETS = require('./configs/WEAK_SECRETS.js');
+var xemsKeyPlaceholder = require('./server/const/xemsKeyPlaceholder.js');
+
+/**
+ * XyPriss Configuration Manager
+ *
+ * Provides a safe way to access and update XyPriss configurations
+ * without encountering "cannot access before initialization" errors.
+ *
+ * This class acts as a singleton configuration store that can be used
+ * in modular structures where accessing `app.configs` directly might
+ * cause initialization timing issues.
+ *
+ * **IMPORTANT**: This is the SINGLE SOURCE OF TRUTH for all XyPriss configurations.
+ * All components should use `Configs.get()` to access configuration values
+ * instead of copying values during initialization.
+ *
+ * @example
+ * ```typescript
+ * import { Configs } from 'xypriss';
+ *
+ * // Set configuration
+ * Configs.set({
+ *   fileUpload: {
+ *     enabled: true,
+ *     maxFileSize: 5 * 1024 * 1024
+ *   }
+ * });
+ *
+ * // Get configuration
+ * const fileUploadConfig = Configs.get('fileUpload');
+ *
+ * // Get entire config
+ * const allConfigs = Configs.getAll();
+ *
+ * // Update specific config (updates the source of truth)
+ * Configs.update('fileUpload', { maxFileSize: 10 * 1024 * 1024 });
+ * ```
+ */
+/**
+ * Configuration Manager Class
+ * Singleton pattern for managing XyPriss configurations
+ */
+class ConfigurationManager {
+    /**
+     * Private constructor to enforce singleton pattern
+     * Initializes with default configuration
+     */
+    constructor() {
+        this.initialized = false;
+        // Initialize with default configuration
+        this.config = { ..._default.DEFAULT_OPTIONS };
+    }
+    /**
+     * Get the singleton instance
+     */
+    static getInstance() {
+        if (!ConfigurationManager.instance) {
+            ConfigurationManager.instance = new ConfigurationManager();
+        }
+        return ConfigurationManager.instance;
+    }
+    /**
+     * Set the entire configuration
+     * @param config - XP Server configuration options
+     */
+    static set(config) {
+        const instance = ConfigurationManager.getInstance();
+        instance.config = ConfigurationManager.deepMerge({ ..._default.DEFAULT_OPTIONS }, config);
+        // Strict validation for XEMS if persistence is enabled
+        ConfigurationManager.validateXemsConfig(instance.config);
+        ConfigurationManager.validateGeneralConfig(instance.config);
+        instance.initialized = true;
+    }
+    /**
+     * Get a specific configuration section
+     * @param key - Configuration key (e.g., 'fileUpload', 'security', 'cache')
+     * @returns The configuration value for the specified key
+     */
+    static get(key) {
+        const instance = ConfigurationManager.getInstance();
+        return instance.config[key];
+    }
+    /**
+     * Get the entire configuration object
+     * @returns Complete XyPriss Server Configuration (XPSC)
+     */
+    static getAll() {
+        const instance = ConfigurationManager.getInstance();
+        return { ...instance.config };
+    }
+    /**
+     * Update a specific XyPriss configuration section (deep merge)
+     * @param key - Configuration key to update
+     * @param value - Partial value to merge with existing configuration
+     */
+    static update(key, value) {
+        const instance = ConfigurationManager.getInstance();
+        const currentValue = instance.config[key];
+        // Deep merge the new value with the existing value
+        if (typeof currentValue === "object" &&
+            currentValue !== null &&
+            !Array.isArray(currentValue)) {
+            instance.config[key] = {
+                ...currentValue,
+                ...value,
+            };
+        }
+        else {
+            // For non-object values, just replace
+            instance.config[key] = value;
+        }
+        // Validate XEMS if it was part of the update
+        if (key === "server") {
+            ConfigurationManager.validateXemsConfig(instance.config);
+        }
+    }
+    /**
+     * Deep merge helper function
+     * @param target - Target object
+     * @param source - Source object to merge
+     * @returns Merged object
+     */
+    /**
+     * Deeply merge two configuration objects
+     * @param target - Target object to merge into
+     * @param source - Source object to merge from
+     * @returns Merged object
+     */
+    static deepMerge(target, source) {
+        // Create a plain copy of target. If target is a Proxy, this spreads its properties.
+        (Array.isArray(target) ? [...target] : { ...target });
+        // for (const key in source) {
+        //     const sourceValue = source[key];
+        //     const targetValue = result[key];
+        //     const isSourceObj =
+        //         sourceValue &&
+        //         typeof sourceValue === "object" &&
+        //         !Array.isArray(sourceValue);
+        //     const isTargetObj =
+        //         targetValue &&
+        //         typeof targetValue === "object" &&
+        //         !Array.isArray(targetValue);
+        //     if (isSourceObj && isTargetObj) {
+        //         // Both are objects, merge them recursively
+        //         if (targetValue === sourceValue) {
+        //             continue;
+        //         }
+        //         if ((targetValue as any).__isXyPrissImmutable) {
+        //             // Target is immutable. We must merge recursively into it to trigger traps
+        //             // and ensure compatibility.
+        //             ConfigurationManager.deepMerge(targetValue, sourceValue);
+        //             result[key] = targetValue;
+        //         } else {
+        //             // Target is plain, merge recursively
+        //             result[key] = ConfigurationManager.deepMerge(
+        //                 targetValue,
+        //                 sourceValue,
+        //             ) as any;
+        //         }
+        //     } else if (
+        //         Array.isArray(sourceValue) &&
+        //         Array.isArray(targetValue)
+        //     ) {
+        //         // For arrays, concatenate them to allow additive configuration (e.g., plugins)
+        //         result[key] = [...targetValue, ...sourceValue] as any;
+        //     } else if (sourceValue !== undefined) {
+        //         // Primitive, non-matching types, or target is not an object.
+        //         // If the parent (target) is immutable, try to set it there to trigger trap
+        //         // This will throw if the value is different from the current one.
+        //         if ((target as any).__isXyPrissImmutable) {
+        //             (target as any)[key] = sourceValue;
+        //         }
+        //         result[key] = sourceValue as any;
+        //     }
+        // }
+        return mergeWithDefaults.mergeWithDefaults(target, source);
+    }
+    /**
+     * Merge configuration with existing config (deep merge)
+     * @param config - Partial configuration to merge
+     */
+    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);
+        // Strict validation for XEMS
+        ConfigurationManager.validateXemsConfig(instance.config);
+        ConfigurationManager.validateGeneralConfig(instance.config);
+        // If it should be immutable, wrap it using the global __const__.vars.make
+        if (shouldBeImmutable &&
+            typeof globalThis.__const__ !== "undefined") {
+            instance.config = globalThis.__const__.vars.make(instance.config, "Configs");
+        }
+        instance.initialized = true;
+    }
+    /**
+     * Check if configuration has been initialized
+     * @returns true if configuration has been set, false otherwise
+     */
+    static isInitialized() {
+        const instance = ConfigurationManager.getInstance();
+        return instance.initialized;
+    }
+    /**
+     * Reset configuration to empty state
+     * Useful for testing or reinitializing
+     */
+    static reset() {
+        const instance = ConfigurationManager.getInstance();
+        instance.config = { ..._default.DEFAULT_OPTIONS };
+        instance.initialized = false;
+    }
+    /**
+     * Check if a specific configuration section exists
+     * @param key - Configuration key to check
+     * @returns true if the configuration section exists
+     */
+    static has(key) {
+        const instance = ConfigurationManager.getInstance();
+        return key in instance.config && instance.config[key] !== undefined;
+    }
+    /**
+     * Get configuration with a default value if not set
+     * @param key - Configuration key
+     * @param defaultValue - Default value to return if key doesn't exist
+     * @returns Configuration value or default value
+     */
+    static getOrDefault(key, defaultValue) {
+        const instance = ConfigurationManager.getInstance();
+        return instance.config[key] ?? defaultValue;
+    }
+    /**
+     * Delete a specific configuration section
+     * @param key - Configuration key to delete
+     */
+    static delete(key) {
+        const instance = ConfigurationManager.getInstance();
+        delete instance.config[key];
+    }
+    /**
+     * Validates XEMS configuration strictly
+     * @param config - Current server configuration
+     * @throws Error if XEMS persistence is enabled but secret is invalid
+     */
+    /**
+     * General configuration validation
+     * @param config - Current server configuration
+     */
+    static validateGeneralConfig(config) {
+        // XHSC is mandatory and enabled by default.
+        // It cannot be explicitly set to false.
+        if (config.server && config.server.xhsc === false) {
+            throw new Error("[XSec] XHSC is enabled by default and cannot be disabled.");
+        }
+    }
+    static validateXemsConfig(config) {
+        const xems = config.server?.xems;
+        if (typeof xems !== "object" || !xems.persistence?.enabled)
+            return;
+        const secret = xems.persistence.secret;
+        if (!secret || typeof secret !== "string") {
+            throw new Error("[XyPriss] XEMS Persistence enabled but no secret provided. " +
+                "Generate one with: node -e \"console.log(require('crypto').randomBytes(32).toString('hex').slice(0,32))\"");
+        }
+        // 0. Vérification de l'extension du fichier
+        if (xems?.persistence?.enabled
+        // !xems?.persistence?.path?.endsWith(".xems")
+        ) {
+            if (!xems?.persistence?.path) {
+                throw new Error(`[XyPriss] XEMS Persistence path is required when persistence is enabled.`);
+            }
+            // if (xems.persistence.path.length > 20) {
+            //     throw new Error(
+            //         `[XyPriss] XEMS Persistence path too long. Maximum 20 characters allowed.`,
+            //     );
+            // }
+            if (!xems?.persistence?.path?.endsWith(".xems")) {
+                throw new Error(`[XyPriss] XEMS Persistence path must end with ".xems". Got ${xems?.persistence?.path}`);
+            }
+        }
+        // 1. Longueur exacte en bytes
+        // const byteLength = Buffer.byteLength(secret, "utf8");
+        // if (byteLength !== 32) {
+        //     throw new Error(
+        //         `[XyPriss] Secret must be exactly 32 bytes. Got ${byteLength} bytes (${secret.length} chars).`,
+        //     );
+        // }
+        if (xemsKeyPlaceholder.xemsKeyPlaceholder.toLowerCase().trim() ===
+            secret.toLowerCase().trim()) {
+            throw new Error("[XyPriss] Secret matches the default placeholder. Generate a real secret key using:\n\n" +
+                "  node -e \"console.log(require('crypto').randomBytes(32).toString('hex').slice(0,32))\"\n\n" +
+                "or using the XyPriss Cipher class (https://xypriss.nehonix.com/docs/security/xsec-m?h=cipher#the-unified-cipher-api)");
+        }
+        // 2. Timing-safe check contre placeholders connus
+        const secretBuf = Buffer.from(secret);
+        for (const weak of WEAK_SECRETS.WEAK_SECRETS) {
+            const weakBuf = Buffer.from(weak);
+            if (secretBuf.length === weakBuf.length &&
+                crypto.timingSafeEqual(secretBuf, weakBuf)) {
+                throw new Error("[XyPriss] Secret matches a known weak secret or placeholder. Generate a real secret key using:\n\n" +
+                    "  node -e \"console.log(require('crypto').randomBytes(32).toString('hex').slice(0,32))\"\n\n" +
+                    "or using the XyPriss Cipher class (https://xypriss.nehonix.com/docs/security/xsec-m?h=cipher#the-unified-cipher-api)");
+            }
+        }
+        // 3. Entropie de Shannon (bits par caractère)
+        const entropy = ConfigurationManager.shannonEntropy(secret);
+        if (entropy < 3.5) {
+            throw new Error(`[XyPriss] Secret entropy too low (${entropy.toFixed(2)} bits/char, minimum 3.5). ` +
+                "Avoid dictionary words, repeated patterns, or predictable sequences.");
+        }
+        // 4. Détection de patterns répétitifs (ex: "abcabc...", "aaa...")
+        if (ConfigurationManager.hasRepetitivePattern(secret)) {
+            throw new Error("[XyPriss] Secret contains repetitive patterns. Use a randomly generated key.");
+        }
+        // 5. Détection de mots du dictionnaire évidents
+        const COMMON_WORDS = [
+            "secret",
+            "password",
+            "key",
+            "admin",
+            "xems",
+            "change",
+            "secure",
+        ];
+        const lowerSecret = secret.toLowerCase();
+        for (const word of COMMON_WORDS) {
+            if (lowerSecret.includes(word)) {
+                throw new Error(`[XyPriss] Secret contains a common word ("${word}"). ` +
+                    "Use a randomly generated key with no dictionary words.");
+            }
+        }
+    }
+    /**
+     * Calcule l'entropie de Shannon en bits par caractère
+     * Une clé aléatoire de 32 chars ASCII aura ~4.5-5 bits/char
+     * "a_very_secret_32_chars_key_12345" aura ~3.2 bits/char → rejeté
+     */
+    static shannonEntropy(str) {
+        const freq = new Map();
+        for (const char of str) {
+            freq.set(char, (freq.get(char) ?? 0) + 1);
+        }
+        let entropy = 0;
+        for (const count of freq.values()) {
+            const p = count / str.length;
+            entropy -= p * Math.log2(p);
+        }
+        return entropy;
+    }
+    /**
+     * Détecte si une string contient un pattern qui se répète
+     * ex: "abcdabcdabcdabcdabcdabcdabcdabcd" → true
+     */
+    static hasRepetitivePattern(str) {
+        const len = str.length;
+        // Teste les périodes de 2 à len/2
+        for (let period = 2; period <= len / 2; period++) {
+            if (len % period !== 0)
+                continue;
+            const pattern = str.slice(0, period);
+            if (pattern.repeat(len / period) === str)
+                return true;
+        }
+        return false;
+    }
+}
+// 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=ConfigurationManager.js.map

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

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

package/dist/cjs/src/FiUp.js

@@ -0,0 +1,88 @@
+'use strict';
+
+var fileUpload = require('./server/components/fastapi/upload/file-upload.js');
+
+// Legacy function exports for backward compatibility
+// These will be deprecated in favor of the class-based API
+// Global instance for backward compatibility
+let globalFileUploadAPI = null;
+/**
+ * Initialize the global file upload manager (legacy)
+ * This is called automatically when the server starts with file upload enabled
+ *
+ * @param configManager - The Configs class for accessing configuration
+ * @param logger - Logger instance
+ */
+function initializeFileUpload(configManager, logger) {
+    if (!globalFileUploadAPI) {
+        globalFileUploadAPI = new fileUpload.FileUploadAPI();
+    }
+    globalFileUploadAPI.initialize(configManager);
+}
+/**
+ * Create a middleware for uploading a single file (legacy)
+ */
+function uploadSingle(fieldname) {
+    return (req, res, next) => {
+        if (!globalFileUploadAPI) {
+            return res.status(500).json({
+                success: false,
+                error: "Configuration Error",
+                message: "File upload not initialized. Make sure fileUpload.enabled is true in server options.",
+            });
+        }
+        return globalFileUploadAPI.single(fieldname)(req, res, next);
+    };
+}
+/**
+ * Create a middleware for uploading multiple files with the same field name (legacy)
+ */
+function uploadArray(fieldname, maxCount) {
+    return (req, res, next) => {
+        if (!globalFileUploadAPI) {
+            return res.status(500).json({
+                success: false,
+                error: "Configuration Error",
+                message: "File upload not initialized. Make sure fileUpload.enabled is true in server options.",
+            });
+        }
+        return globalFileUploadAPI.array(fieldname, maxCount)(req, res, next);
+    };
+}
+/**
+ * Create a middleware for uploading multiple files with different field names (legacy)
+ */
+function uploadFields(fields) {
+    return (req, res, next) => {
+        if (!globalFileUploadAPI) {
+            return res.status(500).json({
+                success: false,
+                error: "Configuration Error",
+                message: "File upload not initialized. Make sure fileUpload.enabled is true in server options.",
+            });
+        }
+        return globalFileUploadAPI.fields(fields)(req, res, next);
+    };
+}
+/**
+ * Create a middleware for uploading any files (legacy)
+ */
+function uploadAny() {
+    return (req, res, next) => {
+        if (!globalFileUploadAPI) {
+            return res.status(500).json({
+                success: false,
+                error: "Configuration Error",
+                message: "File upload not initialized. Make sure fileUpload.enabled is true in server options.",
+            });
+        }
+        return globalFileUploadAPI.any()(req, res, next);
+    };
+}
+
+exports.initializeFileUpload = initializeFileUpload;
+exports.uploadAny = uploadAny;
+exports.uploadArray = uploadArray;
+exports.uploadFields = uploadFields;
+exports.uploadSingle = uploadSingle;
+//# sourceMappingURL=FiUp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FiUp.js","sources":["../../../src/FiUp.ts"],"sourcesContent":[null],"names":["FileUploadAPI"],"mappings":";;;;AAAA;AACA;AAMA;AACA,IAAI,mBAAmB,GAAyB,IAAI;AAEpD;;;;;;AAMG;AACG,SAAU,oBAAoB,CAChC,aAA6B,EAC7B,MAAc,EAAA;IAEd,IAAI,CAAC,mBAAmB,EAAE;AACtB,QAAA,mBAAmB,GAAG,IAAIA,wBAAa,EAAE;IAC7C;AACA,IAAA,mBAAmB,CAAC,UAAU,CAAC,aAAa,CAAC;AACjD;AAEA;;AAEG;AACG,SAAU,YAAY,CAAC,SAAiB,EAAA;AAC1C,IAAA,OAAO,CAAC,GAAQ,EAAE,GAAQ,EAAE,IAAS,KAAI;QACrC,IAAI,CAAC,mBAAmB,EAAE;YACtB,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;AACxB,gBAAA,OAAO,EAAE,KAAK;AACd,gBAAA,KAAK,EAAE,qBAAqB;AAC5B,gBAAA,OAAO,EACH,sFAAsF;AAC7F,aAAA,CAAC;QACN;AACA,QAAA,OAAO,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC;AAChE,IAAA,CAAC;AACL;AAEA;;AAEG;AACG,SAAU,WAAW,CAAC,SAAiB,EAAE,QAAiB,EAAA;AAC5D,IAAA,OAAO,CAAC,GAAQ,EAAE,GAAQ,EAAE,IAAS,KAAI;QACrC,IAAI,CAAC,mBAAmB,EAAE;YACtB,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;AACxB,gBAAA,OAAO,EAAE,KAAK;AACd,gBAAA,KAAK,EAAE,qBAAqB;AAC5B,gBAAA,OAAO,EACH,sFAAsF;AAC7F,aAAA,CAAC;QACN;AACA,QAAA,OAAO,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC;AACzE,IAAA,CAAC;AACL;AAEA;;AAEG;AACG,SAAU,YAAY,CACxB,MAAkD,EAAA;AAElD,IAAA,OAAO,CAAC,GAAQ,EAAE,GAAQ,EAAE,IAAS,KAAI;QACrC,IAAI,CAAC,mBAAmB,EAAE;YACtB,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;AACxB,gBAAA,OAAO,EAAE,KAAK;AACd,gBAAA,KAAK,EAAE,qBAAqB;AAC5B,gBAAA,OAAO,EACH,sFAAsF;AAC7F,aAAA,CAAC;QACN;AACA,QAAA,OAAO,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC;AAC7D,IAAA,CAAC;AACL;AAEA;;AAEG;SACa,SAAS,GAAA;AACrB,IAAA,OAAO,CAAC,GAAQ,EAAE,GAAQ,EAAE,IAAS,KAAI;QACrC,IAAI,CAAC,mBAAmB,EAAE;YACtB,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;AACxB,gBAAA,OAAO,EAAE,KAAK;AACd,gBAAA,KAAK,EAAE,qBAAqB;AAC5B,gBAAA,OAAO,EACH,sFAAsF;AAC7F,aAAA,CAAC;QACN;QACA,OAAO,mBAAmB,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC;AACpD,IAAA,CAAC;AACL;;;;;;;;"}