xypriss 9.12.57 → 9.12.59

package/dist/index.d.ts

@@ -6334,7 +6334,18 @@ declare class NumberUtils {
  * du.formatDuration(3_661_000);    // "1h 1m 1s"
  * du.startOf("month");             // 2026-04-01T00:00:00.000Z
  * ```
- */
+/** Supported unit abbreviations for date calculations */
+type DateUnit = "ms" | "milli" | "millis" | "millisecond" | "milliseconds" | "s" | "sec" | "second" | "seconds" | "m" | "min" | "minute" | "minutes" | "h" | "hr" | "hour" | "hours" | "d" | "day" | "days" | "w" | "wk" | "week" | "weeks" | "M" | "mo" | "month" | "months" | "y" | "yr" | "year" | "years";
+/** Shorthand duration unit for literal typing */
+type DurationUnitShorthand = "ms" | "s" | "m" | "h" | "d" | "w" | "M" | "mo" | "y";
+/** Predefined natural date keywords */
+type NaturalDateKeyword = "now" | "today" | "yesterday" | "tomorrow";
+/**
+ * Type representing natural relative date expressions or shorthand durations.
+ * Supports IntelliSense for common combinations like "7d", "3M", "2h", "1w", "30m", "tomorrow",
+ * while accepting any valid string.
+ */
+type DateExpression = NaturalDateKeyword | `${number}${DurationUnitShorthand}` | `+${number}${DurationUnitShorthand}` | `-${number}${DurationUnitShorthand}` | (string & {});
 declare class DateUtils {
     /**
      * Converts any supported input value to a `Date` object.
@@ -6342,7 +6353,7 @@ declare class DateUtils {
      * Supported inputs:
      * - `Date` — returned as-is (not cloned).
      * - `number` — auto-detected as Unix seconds (`< 1e11`) or milliseconds.
-     * - `string` — parsed via `new Date(string)` (ISO 8601 recommended).
+     * - `string` — natural expression (`"7d"`, `"3M"`, `"tomorrow"`) or standard date string (ISO 8601).
      *
      * @param date - The value to convert.
      * @returns The corresponding `Date` object.
@@ -6946,7 +6957,8 @@ declare class DateUtils {
      *
      * @param expression - The natural date or duration expression (e.g. `"7d"`, `"3M"`, `"+2w"`, `"-1d"`, `"tomorrow"`).
      * @param baseDate   - The reference starting point (default: current instant `new Date()`).
-     * @returns A `Date` object matching the target time, or `null` if the string cannot be parsed as a duration.
+     * @returns A JavaScript `Date` object matching the target time.
+     * @throws {RangeError} If the expression cannot be parsed or contains invalid units.
      *
      * @example
      * ```ts
@@ -6958,7 +6970,7 @@ declare class DateUtils {
      * du.from("7d", "2026-01-01"); // Date("2026-01-08")
      * ```
      */
-    from(expression: string, baseDate?: Date | number | string): Date | null;
+    from(expression: DateExpression, baseDate?: Date | number | string): Date;
     /**
      * Parses a duration shorthand string (e.g. `"7d"`, `"3M"`, `"2h"`, `"500ms"`)
      * into a total number of milliseconds.
@@ -6968,7 +6980,8 @@ declare class DateUtils {
      * arithmetic taking into account specific months and leap years, use {@link from} or {@link add}.
      *
      * @param duration - The duration shorthand string.
-     * @returns Total milliseconds, or `null` if the string cannot be parsed.
+     * @returns Total milliseconds as a number.
+     * @throws {RangeError} If the duration string is invalid or contains unknown units.
      *
      * @example
      * ```ts
@@ -6977,7 +6990,7 @@ declare class DateUtils {
      * du.parseDuration("10s");   // → 10000
      * ```
      */
-    parseDuration(duration: string): number | null;
+    parseDuration(duration: DateExpression): number;
     /**
      * Returns the UTC offset of the local environment in minutes.
      *
@@ -10533,76 +10546,49 @@ interface SendOptions {
 
 /**
  * Interface representing XEMS (XyPriss Encrypted Memory Store) configurations.
- * XEMS is a specialized temporary database with high-security features.
+ * XEMS is a high-security, hardware-bound encrypted persistent store (max 7 days retention).
  */
-interface XemsTypes {
+type XemsTypes = {
+    /** Whether XEMS is enabled for this server instance. */
+    enable: false;
+    path?: string;
+    secret?: string;
+    sandbox?: string;
+    ttl?: string;
+    cookieName?: string;
+    headerName?: string;
+    autoRotation?: boolean | "request" | "sec" | "minute" | "hour" | "day" | string;
+    attachTo?: string;
+    resources?: {
+        cacheSize?: number;
+    };
+    cookieOptions?: CookieOptions;
+    gracePeriod?: number;
+} | {
+    /** Whether XEMS is enabled for this server instance. */
+    enable?: true;
     /**
-     * Whether XEMS is enabled for this server instance.
+     * Path to the encrypted vault file (.xems).
+     * The vault is cryptographically bound to both the hardware ID (HWID) and this specific absolute path.
      */
-    enable?: boolean;
+    path: string;
     /**
-     * The default isolated storage namespace (Sandbox).
+     * Mandatory 32-byte (256-bit) encryption secret.
+     * Combined with HWID and absolute file path for AES-256-GCM vault encryption.
      */
+    secret: string;
     sandbox?: string;
-    /**
-     * Default Time-to-Live for stored records (e.g., "15m", "1h", "2d").
-     * @important XEMS enforces a HARD GLOBAL LIMIT of 5 days. Any value exceeding "5d" will be capped.
-     */
     ttl?: string;
-    /**
-     * Name of the HttpOnly cookie used for session tracking.
-     */
     cookieName?: string;
-    /**
-     * Name of the HTTP header used for session tracking (for API callers).
-     */
     headerName?: string;
-    /**
-     * Rotation strategy for XEMS session tokens.
-     * Can be a boolean or a duration string: "request" (or true), "sec", "minute", "hour", "day" (or e.g. "5m", "10s").
-     */
     autoRotation?: boolean | "request" | "sec" | "minute" | "hour" | "day" | string;
-    /**
-     * Property on the request object where session data will be attached (default: "session").
-     */
     attachTo?: string;
-    /**
-     * Persistent storage configuration.
-     */
-    persistence?: {
-        /**
-         * Whether to persist data to disk in an encrypted vault.
-         */
-        enabled: boolean;
-        /**
-         * Path to the encrypted vault file.
-         */
-        path?: string;
-        /**
-         * Mandatory 32-byte (256-bit) encryption secret.
-         * Used in combination with hardware ID for vault encryption.
-         */
-        secret: string;
-        /**
-         * Resource allocation for the XEMS sidecar.
-         */
-        resources?: {
-            /** Cache size in MB (reserved for indexing performance) */
-            cacheSize?: number;
-        };
+    resources?: {
+        cacheSize?: number;
     };
-    /**
-     * Security options for the HttpOnly cookie.
-     */
     cookieOptions?: CookieOptions;
-    /**
-     * Grace period for rotated sessions.
-     * Duration in milliseconds for which the old token remains valid for READ access after rotation.
-     * Prevents race conditions with simultaneous requests.
-     * @maximum 55000 (55 seconds)
-     */
     gracePeriod?: number;
-}
+};
 interface CookieOptions {
     httpOnly?: boolean;
     secure?: boolean;
@@ -14842,5 +14828,5 @@ declare class XStatic {
  */
 declare function Router(): XyPrissRouter;
 
-export { ConfigurationManager as CM, ConfigurationManager as Configs, FileUploadAPI as FLA, FileUploadAPI, Plugin, PluginHookIds, Router, SecurityMiddleware, Send, Upload, XJsonResponseHandler, XServer, XStatic, XyGuard, MultiServerApp as XyPMS, XyPrissRouter, XyPrissXHSC, __cfg__, __const__, __sys__, createOptimalCache, createServer, getCallerProjectRoot, getInstanceId, getIp, getMime, getMimes, identifyProjectRoot, initializeFileUpload, mergeWithDefaults, mergeWithDefaults as mwdef, normalizeXtrsRules, parseDurationMs, parseXtrsRule, quickServer, uploadAny, uploadArray, uploadFields, uploadSingle, xems };
-export type { ArchiveOptions, BatchRenameChange, CacheConfig, FileUploadConfig as FiUpConfig, FileUploadConfig, GetIpResult, GuardResolver, IFile, IpSource, MonitorSnapshot, MultiServerConfig, NetworkStats, NextFunction, PerformanceConfig, PluginCreator, PluginServer, ProcessInfo, ProcessMonitorSnapshot, XyPrisRequest as Request, RequestHandler, XyPrisResponse as Response, RoutRateLimit, RoutRateLimitInput, RouteConfig, RouteGuard, RouteMeta, RouteOptions, ParamType as RouteParamType, SecurityConfig, ServerOptions$1 as ServerOptions, TempFileOptions, TempFileResult, XyPrisRequest$1 as XRequest, XyPrisResponse$1 as XResponse, XemsTypes, XtrsOptions, XtrsRuleConfig, XtrsRuleInput, XyGuardContext, XyPrisRequest$1 as XyPrisRequest, XyPrisResponse$1 as XyPrisResponse, XyPrissApp, XyPrissPlugin };
+export { ConfigurationManager as CM, ConfigurationManager as Configs, DateUtils, FileUploadAPI as FLA, FileUploadAPI, Plugin, PluginHookIds, Router, SecurityMiddleware, Send, Upload, XJsonResponseHandler, XServer, XStatic, XyGuard, MultiServerApp as XyPMS, XyPrissRouter, XyPrissXHSC, __cfg__, __const__, __sys__, createOptimalCache, createServer, getCallerProjectRoot, getInstanceId, getIp, getMime, getMimes, identifyProjectRoot, initializeFileUpload, mergeWithDefaults, mergeWithDefaults as mwdef, normalizeXtrsRules, parseDurationMs, parseXtrsRule, quickServer, uploadAny, uploadArray, uploadFields, uploadSingle, xems };
+export type { ArchiveOptions, BatchRenameChange, CacheConfig, DateExpression, DateUnit, DurationUnitShorthand, FileUploadConfig as FiUpConfig, FileUploadConfig, GetIpResult, GuardResolver, IFile, IpSource, MonitorSnapshot, MultiServerConfig, NaturalDateKeyword, NetworkStats, NextFunction, PerformanceConfig, PluginCreator, PluginServer, ProcessInfo, ProcessMonitorSnapshot, XyPrisRequest as Request, RequestHandler, XyPrisResponse as Response, RoutRateLimit, RoutRateLimitInput, RouteConfig, RouteGuard, RouteMeta, RouteOptions, ParamType as RouteParamType, SecurityConfig, ServerOptions$1 as ServerOptions, TempFileOptions, TempFileResult, XyPrisRequest$1 as XRequest, XyPrisResponse$1 as XResponse, XemsTypes, XtrsOptions, XtrsRuleConfig, XtrsRuleInput, XyGuardContext, XyPrisRequest$1 as XyPrisRequest, XyPrisResponse$1 as XyPrisResponse, XyPrissApp, XyPrissPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xypriss",
-    "version": "9.12.57",
+    "version": "9.12.59",
     "description": "XyPriss is a high-performance, TypeScript-first hyper-system web framework powered by a native Go core (XHSC), featuring robust multi-tenant sandboxing, secure native file streaming, and zero Express dependencies.",
     "author": {
         "DEV.to": "https://dev.to/nehonix",

package/dist/cjs/index.js

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

package/dist/cjs/package.json

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

package/dist/cjs/src/ConfigurationManager.js

@@ -1,388 +0,0 @@
-'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

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