xypriss 1.0.1 → 1.1.0

package/dist/esm/mods/security/src/utils/CryptoAlgorithmUtils.js

@@ -0,0 +1,69 @@
+import { ALGORITHM_REGISTRY } from '../algorithms/registry.js';
+
+/**
+ * Utility class for algorithm validation and information
+ */
+class CryptoAlgorithmUtils {
+    /**
+     * Validates if an algorithm is supported
+     */
+    static isSupported(algorithm) {
+        return algorithm in ALGORITHM_REGISTRY;
+    }
+    /**
+     * Gets algorithm information
+     */
+    static getInfo(algorithm) {
+        return ALGORITHM_REGISTRY[algorithm];
+    }
+    /**
+     * Checks if an algorithm is deprecated
+     */
+    static isDeprecated(algorithm) {
+        return ALGORITHM_REGISTRY[algorithm].deprecated;
+    }
+    /**
+     * Gets all algorithms by security level
+     */
+    static getAlgorithmsBySecurityLevel(level) {
+        return Object.entries(ALGORITHM_REGISTRY)
+            .filter(([, info]) => info.securityLevel === level)
+            .map(([algorithm]) => algorithm);
+    }
+    /**
+     * Gets recommended algorithms (non-deprecated, strong or very-strong)
+     */
+    static getRecommendedAlgorithms() {
+        return Object.entries(ALGORITHM_REGISTRY)
+            .filter(([, info]) => !info.deprecated &&
+            (info.securityLevel === "strong" ||
+                info.securityLevel === "very-strong"))
+            .map(([algorithm]) => algorithm);
+    }
+    /**
+     * Validates algorithm and warns about deprecated ones
+     */
+    static validateAlgorithm(algorithm) {
+        if (!this.isSupported(algorithm)) {
+            throw new Error(`Unsupported algorithm: ${algorithm}. Supported: ${Object.keys(ALGORITHM_REGISTRY).join(", ")}`);
+        }
+        const info = this.getInfo(algorithm);
+        if (info.deprecated) {
+            console.warn(`Warning: ${algorithm} is deprecated. ${info.description}`);
+        }
+        // For now, only return hash algorithms for the hash method
+        const hashAlgorithms = [
+            "SHA-1",
+            "SHA-256",
+            "SHA-384",
+            "SHA-512",
+        ];
+        if (!hashAlgorithms.includes(algorithm)) {
+            throw new Error(`Algorithm ${algorithm} is not a hash algorithm`);
+        }
+        return algorithm;
+    }
+}
+
+export { CryptoAlgorithmUtils };
+//# sourceMappingURL=CryptoAlgorithmUtils.js.map

package/dist/esm/mods/security/src/utils/CryptoAlgorithmUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CryptoAlgorithmUtils.js","sources":["../../../../../../mods/security/src/utils/CryptoAlgorithmUtils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAOA;;AAEG;MACU,oBAAoB,CAAA;AAC7B;;AAEG;IACH,OAAO,WAAW,CAAC,SAAiB,EAAA;QAChC,OAAO,SAAS,IAAI,kBAAkB,CAAC;KAC1C;AAED;;AAEG;IACH,OAAO,OAAO,CAAC,SAA0B,EAAA;AACrC,QAAA,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;KACxC;AAED;;AAEG;IACH,OAAO,YAAY,CAAC,SAA0B,EAAA;AAC1C,QAAA,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC;KACnD;AAED;;AAEG;IACH,OAAO,4BAA4B,CAC/B,KAAqC,EAAA;AAErC,QAAA,OAAO,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC;AACpC,aAAA,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,aAAa,KAAK,KAAK,CAAC;aAClD,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,SAA4B,CAAC,CAAC;KAC3D;AAED;;AAEG;AACH,IAAA,OAAO,wBAAwB,GAAA;AAC3B,QAAA,OAAO,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC;AACpC,aAAA,MAAM,CACH,CAAC,GAAG,IAAI,CAAC,KACL,CAAC,IAAI,CAAC,UAAU;AAChB,aAAC,IAAI,CAAC,aAAa,KAAK,QAAQ;AAC5B,gBAAA,IAAI,CAAC,aAAa,KAAK,aAAa,CAAC,CAChD;aACA,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,SAA4B,CAAC,CAAC;KAC3D;AAED;;AAEG;IACH,OAAO,iBAAiB,CAAC,SAAiB,EAAA;QACtC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE;AAC9B,YAAA,MAAM,IAAI,KAAK,CACX,0BAA0B,SAAS,CAAA,aAAA,EAAgB,MAAM,CAAC,IAAI,CAC1D,kBAAkB,CACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CACjB,CAAC;SACL;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAA4B,CAAC,CAAC;AACxD,QAAA,IAAI,IAAI,CAAC,UAAU,EAAE;YACjB,OAAO,CAAC,IAAI,CACR,CAAY,SAAA,EAAA,SAAS,CAAmB,gBAAA,EAAA,IAAI,CAAC,WAAW,CAAE,CAAA,CAC7D,CAAC;SACL;;AAGD,QAAA,MAAM,cAAc,GAAoB;YACpC,OAAO;YACP,SAAS;YACT,SAAS;YACT,SAAS;SACZ,CAAC;QACF,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,SAA0B,CAAC,EAAE;AACtD,YAAA,MAAM,IAAI,KAAK,CAAC,aAAa,SAAS,CAAA,wBAAA,CAA0B,CAAC,CAAC;SACrE;AAED,QAAA,OAAO,SAA0B,CAAC;KACrC;AACJ;;;;"}

package/dist/esm/mods/security/src/utils/constants.js

@@ -0,0 +1,105 @@
+/**
+ * Constants used throughout the library
+ */
+/**
+ * Character sets for token generation
+ */
+const CHAR_SETS = {
+    /**
+     * Uppercase letters
+     */
+    UPPERCASE: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
+    /**
+     * Lowercase letters
+     */
+    LOWERCASE: "abcdefghijklmnopqrstuvwxyz",
+    /**
+     * Numeric characters
+     */
+    NUMBERS: "0123456789",
+    /**
+     * Special symbols
+     */
+    SYMBOLS: "!@#$%^&*()_+-=[]{}|;:,.<>?",
+    /**
+     * Similar characters that can be confused
+     */
+    SIMILAR_CHARS: "il1Lo0O",
+    /**
+     * Base58 alphabet (Bitcoin style, no similar characters)
+     */
+    BASE58: "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz",
+    /**
+     * Base32 alphabet (RFC 4648)
+     */
+    BASE32: "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567",
+};
+/**
+ * Default security parameters
+ */
+const SECURITY_DEFAULTS = {
+    /**
+     * Default token length
+     */
+    TOKEN_LENGTH: 32,
+    /**
+     * Default number of iterations for PBKDF2
+     */
+    PBKDF2_ITERATIONS: 100000,
+    /**
+     * Default key length in bytes
+     */
+    KEY_LENGTH: 32,
+    /**
+     * Default session token expiration (24 hours in seconds)
+     */
+    SESSION_EXPIRATION: 86400,
+    /**
+     * Minimum recommended password length
+     */
+    MIN_PASSWORD_LENGTH: 12,
+    /**
+     * Default API key random part length
+     */
+    API_KEY_RANDOM_LENGTH: 24,
+};
+/**
+ * Error messages
+ */
+const ERROR_MESSAGES = {
+    INVALID_LENGTH: "Invalid length specified",
+    INVALID_ALGORITHM: "Invalid algorithm specified",
+    INVALID_ITERATIONS: "Invalid number of iterations specified",
+    INVALID_SALT: "Invalid salt specified",
+    INVALID_FORMAT: "Invalid output format specified",
+    INVALID_ENTROPY: "Invalid entropy level specified",
+    CRYPTO_UNAVAILABLE: "Cryptographically secure random number generation is not available",
+    INVALID_TOKEN_TYPE: "Invalid token type specified",
+    INVALID_API_KEY: "Invalid API key format",
+    INVALID_SESSION_TOKEN: "Invalid session token format",
+    WEAK_PASSWORD: "Password does not meet minimum security requirements",
+};
+// Enhanced security constants
+const SECURITY_CONSTANTS = {
+    MIN_ENTROPY_BITS: 128,
+    RECOMMENDED_ENTROPY_BITS: 256,
+    MAX_ENTROPY_BITS: 512,
+    ENTROPY_POOL_SIZE: 4096,
+    RESEED_THRESHOLD: 1000000, // Reseed after 1M bytes
+    MIN_SECURE_LENGTH: 16,
+    TIMING_ATTACK_DELAY: 100, // milliseconds
+    QUANTUM_RESISTANCE_BITS: 384,
+};
+// Hash security constants
+const HASH_SECURITY_CONSTANTS = {
+    MIN_ITERATIONS: 10000,
+    RECOMMENDED_ITERATIONS: 50000,
+    HIGH_SECURITY_ITERATIONS: 100000,
+    MIN_SALT_LENGTH: 16,
+    RECOMMENDED_SALT_LENGTH: 32,
+    MAX_SALT_LENGTH: 64,
+    TIMING_ATTACK_DELAY: 100, // milliseconds
+};
+
+export { CHAR_SETS, ERROR_MESSAGES, HASH_SECURITY_CONSTANTS, SECURITY_CONSTANTS, SECURITY_DEFAULTS };
+//# sourceMappingURL=constants.js.map

package/dist/esm/mods/security/src/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sources":["../../../../../../mods/security/src/utils/constants.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;AAEG;AAEH;;AAEG;AACU,MAAA,SAAS,GAAG;AACrB;;AAEG;AACH,IAAA,SAAS,EAAE,4BAA4B;AAEvC;;AAEG;AACH,IAAA,SAAS,EAAE,4BAA4B;AAEvC;;AAEG;AACH,IAAA,OAAO,EAAE,YAAY;AAErB;;AAEG;AACH,IAAA,OAAO,EAAE,4BAA4B;AAErC;;AAEG;AACH,IAAA,aAAa,EAAE,SAAS;AAExB;;AAEG;AACH,IAAA,MAAM,EAAE,4DAA4D;AAEpE;;AAEG;AACH,IAAA,MAAM,EAAE,kCAAkC;EAC5C;AAEF;;AAEG;AACU,MAAA,iBAAiB,GAAG;AAC7B;;AAEG;AACH,IAAA,YAAY,EAAE,EAAE;AAEhB;;AAEG;AACH,IAAA,iBAAiB,EAAE,MAAM;AAEzB;;AAEG;AACH,IAAA,UAAU,EAAE,EAAE;AAEd;;AAEG;AACH,IAAA,kBAAkB,EAAE,KAAK;AAEzB;;AAEG;AACH,IAAA,mBAAmB,EAAE,EAAE;AAEvB;;AAEG;AACH,IAAA,qBAAqB,EAAE,EAAE;EAC3B;AAoDF;;AAEG;AACU,MAAA,cAAc,GAAG;AAC1B,IAAA,cAAc,EAAE,0BAA0B;AAC1C,IAAA,iBAAiB,EAAE,6BAA6B;AAChD,IAAA,kBAAkB,EAAE,wCAAwC;AAC5D,IAAA,YAAY,EAAE,wBAAwB;AACtC,IAAA,cAAc,EAAE,iCAAiC;AACjD,IAAA,eAAe,EAAE,iCAAiC;AAClD,IAAA,kBAAkB,EACd,oEAAoE;AACxE,IAAA,kBAAkB,EAAE,8BAA8B;AAClD,IAAA,eAAe,EAAE,wBAAwB;AACzC,IAAA,qBAAqB,EAAE,8BAA8B;AACrD,IAAA,aAAa,EAAE,sDAAsD;EACvE;AAEF;AACa,MAAA,kBAAkB,GAAG;AAC9B,IAAA,gBAAgB,EAAE,GAAG;AACrB,IAAA,wBAAwB,EAAE,GAAG;AAC7B,IAAA,gBAAgB,EAAE,GAAG;AACrB,IAAA,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,OAAO;AACzB,IAAA,iBAAiB,EAAE,EAAE;IACrB,mBAAmB,EAAE,GAAG;AACxB,IAAA,uBAAuB,EAAE,GAAG;EACrB;AAEX;AACa,MAAA,uBAAuB,GAAG;AACnC,IAAA,cAAc,EAAE,KAAK;AACrB,IAAA,sBAAsB,EAAE,KAAK;AAC7B,IAAA,wBAAwB,EAAE,MAAM;AAChC,IAAA,eAAe,EAAE,EAAE;AACnB,IAAA,uBAAuB,EAAE,EAAE;AAC3B,IAAA,eAAe,EAAE,EAAE;IACnB,mBAAmB,EAAE,GAAG;;;;;"}

package/dist/esm/mods/security/src/utils/dataConverter.js

@@ -0,0 +1,72 @@
+import { __processor__ } from 'nehonix-uri-processor';
+import { bufferToBase64, bufferToString, bufferToBase64Url, bufferToBinary, bufferToBase58, bufferToHex } from './encoding.js';
+import './memory/index.js';
+
+function bufferDataConverter(input, outputFormat, options = {}) {
+    const { onError, onBuffer, onResult } = options;
+    try {
+        let result = null;
+        switch (outputFormat) {
+            case "hex":
+                result = bufferToHex(input);
+                onResult?.(result);
+                break;
+            case "base64":
+                result = bufferToBase64(input);
+                onResult?.(result);
+                break;
+            case "base58":
+                result = bufferToBase58(input);
+                onResult?.(result);
+                break;
+            case "binary":
+                result = bufferToBinary(input);
+                onResult?.(result);
+                break;
+            case "buffer":
+                result = null;
+                onBuffer?.(input);
+                break;
+            case "base64url":
+                result = bufferToBase64Url(input);
+                onResult?.(result);
+                break;
+            case "utf8":
+                result = bufferToString(input);
+                onResult?.(result);
+                break;
+            default:
+                try {
+                    // Convert Uint8Array to string for processor.encode()
+                    // Since processor.encode expects a string input, we need to convert binary data to string first
+                    let inputString;
+                    // Try UTF-8 decoding first (best for text data)
+                    try {
+                        inputString = new TextDecoder("utf-8", {
+                            fatal: true,
+                        }).decode(input);
+                    }
+                    catch {
+                        // If UTF-8 decoding fails (binary data), convert to Base64 first
+                        // This ensures the processor gets valid string input
+                        inputString = bufferToBase64(input);
+                    }
+                    result = __processor__.encode(inputString, outputFormat);
+                    onResult?.(result);
+                }
+                catch (error) {
+                    onError?.(error);
+                    throw error;
+                }
+                break;
+        }
+        return result;
+    }
+    catch (error) {
+        onError?.(error);
+        throw error;
+    }
+}
+
+export { bufferDataConverter };
+//# sourceMappingURL=dataConverter.js.map

package/dist/esm/mods/security/src/utils/dataConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataConverter.js","sources":["../../../../../../mods/security/src/utils/dataConverter.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAiBM,SAAU,mBAAmB,CAC/B,KAAkC,EAClC,YAA8B,EAC9B,UAA0B,EAAE,EAAA;IAE5B,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;AAEhD,IAAA,IAAI;QACA,IAAI,MAAM,GAAkB,IAAI,CAAC;QAEjC,QAAQ,YAAY;AAChB,YAAA,KAAK,KAAK;AACN,gBAAA,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,gBAAA,QAAQ,GAAG,MAAM,CAAC,CAAC;gBACnB,MAAM;AACV,YAAA,KAAK,QAAQ;AACT,gBAAA,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,gBAAA,QAAQ,GAAG,MAAM,CAAC,CAAC;gBACnB,MAAM;AACV,YAAA,KAAK,QAAQ;AACT,gBAAA,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,gBAAA,QAAQ,GAAG,MAAM,CAAC,CAAC;gBACnB,MAAM;AACV,YAAA,KAAK,QAAQ;AACT,gBAAA,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,gBAAA,QAAQ,GAAG,MAAM,CAAC,CAAC;gBACnB,MAAM;AACV,YAAA,KAAK,QAAQ;gBACT,MAAM,GAAG,IAAI,CAAC;AACd,gBAAA,QAAQ,GAAG,KAAK,CAAC,CAAC;gBAClB,MAAM;AACV,YAAA,KAAK,WAAW;AACZ,gBAAA,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAClC,gBAAA,QAAQ,GAAG,MAAM,CAAC,CAAC;gBACnB,MAAM;AACV,YAAA,KAAK,MAAM;AACP,gBAAA,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,gBAAA,QAAQ,GAAG,MAAM,CAAC,CAAC;gBACnB,MAAM;AACV,YAAA;AACI,gBAAA,IAAI;;;AAGA,oBAAA,IAAI,WAAmB,CAAC;;AAGxB,oBAAA,IAAI;AACA,wBAAA,WAAW,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE;AACnC,4BAAA,KAAK,EAAE,IAAI;AACd,yBAAA,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;qBACpB;AAAC,oBAAA,MAAM;;;AAGJ,wBAAA,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;qBACvC;oBAED,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AACzD,oBAAA,QAAQ,GAAG,MAAM,CAAC,CAAC;iBACtB;gBAAC,OAAO,KAAK,EAAE;AACZ,oBAAA,OAAO,GAAG,KAAK,CAAC,CAAC;AACjB,oBAAA,MAAM,KAAK,CAAC;iBACf;gBACD,MAAM;SACb;AAED,QAAA,OAAO,MAAM,CAAC;KACjB;IAAC,OAAO,KAAK,EAAE;AACZ,QAAA,OAAO,GAAG,KAAK,CAAC,CAAC;AACjB,QAAA,MAAM,KAAK,CAAC;KACf;AACL;;;;"}

package/dist/esm/mods/security/src/utils/encoding.js

@@ -0,0 +1,279 @@
+import { CHAR_SETS } from './constants.js';
+
+/**
+ * Enhanced encoding utilities for various formats
+ */
+// =============================================================================
+// HEX UTILITIES
+// =============================================================================
+/**
+ * Convert a buffer to a hexadecimal string
+ * @param buffer - The buffer to convert
+ * @param uppercase - Whether to use uppercase letters (default: false)
+ * @param separator - Optional separator between bytes (e.g., ':', ' ', '-')
+ * @returns Hexadecimal string representation
+ */
+function bufferToHex(buffer, uppercase = false, separator) {
+    const hex = Array.from(buffer)
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join(separator || "");
+    return uppercase ? hex.toUpperCase() : hex;
+}
+/**
+ * Convert a hexadecimal string to a buffer
+ * @param hex - The hexadecimal string to convert
+ * @returns Uint8Array representation
+ */
+function hexToBuffer(hex) {
+    // Remove common separators and whitespace
+    const cleanHex = hex.replace(/[:\s-]/g, "");
+    if (cleanHex.length % 2 !== 0) {
+        throw new Error("Hex string must have an even number of characters");
+    }
+    const bytes = new Uint8Array(cleanHex.length / 2);
+    for (let i = 0; i < cleanHex.length; i += 2) {
+        bytes[i / 2] = parseInt(cleanHex.substring(i, i + 2), 16);
+    }
+    return bytes;
+}
+// =============================================================================
+// BINARY UTILITIES
+// =============================================================================
+/**
+ * Convert a buffer to a binary string
+ * @param buffer - The buffer to convert
+ * @param separator - Optional separator between bytes (e.g., ' ', '-')
+ * @returns Binary string representation
+ */
+function bufferToBinary(buffer, separator) {
+    const binary = Array.from(buffer)
+        .map((b) => b.toString(2).padStart(8, "0"))
+        .join(separator || "");
+    return binary;
+}
+// =============================================================================
+// BASE64 UTILITIES (Enhanced)
+// =============================================================================
+/**
+ * Convert a buffer to a Base64 string
+ * @param buffer - The buffer to convert
+ * @param urlSafe - Whether to use URL-safe Base64 (default: false)
+ * @returns Base64 string representation
+ */
+function bufferToBase64(buffer, urlSafe = false) {
+    let result;
+    if (typeof Buffer !== "undefined") {
+        // Node.js environment
+        result = Buffer.from(buffer).toString("base64");
+    }
+    else if (typeof btoa === "function") {
+        // Browser environment
+        const binary = Array.from(buffer)
+            .map((b) => String.fromCharCode(b))
+            .join("");
+        result = btoa(binary);
+    }
+    else {
+        // Fallback implementation
+        const CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+        result = "";
+        const bytes = new Uint8Array(buffer);
+        const len = bytes.length;
+        let i = 0;
+        while (i < len) {
+            const b1 = bytes[i++];
+            const b2 = i < len ? bytes[i++] : 0;
+            const b3 = i < len ? bytes[i++] : 0;
+            const triplet = (b1 << 16) | (b2 << 8) | b3;
+            result += CHARS[(triplet >> 18) & 0x3f];
+            result += CHARS[(triplet >> 12) & 0x3f];
+            result += i > len - 2 ? "=" : CHARS[(triplet >> 6) & 0x3f];
+            result += i > len - 1 ? "=" : CHARS[triplet & 0x3f];
+        }
+    }
+    if (urlSafe) {
+        result = result
+            .replace(/\+/g, "-")
+            .replace(/\//g, "_")
+            .replace(/=/g, "");
+    }
+    return result;
+}
+/**
+ * Convert a Base64 string to a buffer
+ * @param base64 - The Base64 string to convert
+ * @param urlSafe - Whether the input is URL-safe Base64 (default: false)
+ * @returns Uint8Array representation
+ */
+function base64ToBuffer(base64, urlSafe = false) {
+    let str = base64;
+    if (urlSafe) {
+        str = str.replace(/-/g, "+").replace(/_/g, "/");
+        // Add padding if needed
+        while (str.length % 4) {
+            str += "=";
+        }
+    }
+    if (typeof Buffer !== "undefined") {
+        // Node.js environment
+        return new Uint8Array(Buffer.from(str, "base64"));
+    }
+    else if (typeof atob === "function") {
+        // Browser environment
+        const binary = atob(str);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+        return bytes;
+    }
+    else {
+        // Fallback implementation
+        const CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+        // Remove padding if present
+        const cleanStr = str.replace(/=+$/, "");
+        const bytesLength = Math.floor((cleanStr.length * 3) / 4);
+        const bytes = new Uint8Array(bytesLength);
+        let p = 0;
+        for (let i = 0; i < cleanStr.length; i += 4) {
+            const c1 = CHARS.indexOf(cleanStr[i]);
+            const c2 = CHARS.indexOf(cleanStr[i + 1]);
+            const c3 = i + 2 < cleanStr.length ? CHARS.indexOf(cleanStr[i + 2]) : 64;
+            const c4 = i + 3 < cleanStr.length ? CHARS.indexOf(cleanStr[i + 3]) : 64;
+            bytes[p++] = (c1 << 2) | (c2 >> 4);
+            if (c3 < 64)
+                bytes[p++] = ((c2 & 15) << 4) | (c3 >> 2);
+            if (c4 < 64)
+                bytes[p++] = ((c3 & 3) << 6) | c4;
+        }
+        return bytes;
+    }
+}
+// =============================================================================
+// BASE58 UTILITIES (Enhanced)
+// =============================================================================
+/**
+ * Convert a buffer to a Base58 string (Bitcoin style)
+ * @param buffer - The buffer to convert
+ * @returns Base58 string representation
+ */
+function bufferToBase58(buffer) {
+    const ALPHABET = CHAR_SETS.BASE58;
+    // Count leading zeros
+    let zeros = 0;
+    for (let i = 0; i < buffer.length; i++) {
+        if (buffer[i] === 0) {
+            zeros++;
+        }
+        else {
+            break;
+        }
+    }
+    // Convert to base58
+    const input = Array.from(buffer);
+    let output = "";
+    for (let i = zeros; i < input.length; i++) {
+        let carry = input[i];
+        // Apply "b58 = b58 * 256 + ch"
+        for (let k = output.length - 1; k >= 0 || carry > 0; k--) {
+            if (k < 0) {
+                output = ALPHABET[0] + output;
+                k = 0;
+            }
+            let x = ALPHABET.indexOf(output[k]) * 256 + carry;
+            output =
+                output.substring(0, k) +
+                    ALPHABET[x % 58] +
+                    output.substring(k + 1);
+            carry = Math.floor(x / 58);
+        }
+    }
+    // Add leading '1's for each leading zero byte
+    for (let i = 0; i < zeros; i++) {
+        output = ALPHABET[0] + output;
+    }
+    return output;
+}
+// =============================================================================
+// BASE32 UTILITIES (Enhanced)
+// =============================================================================
+/**
+ * Convert a buffer to a Base32 string (RFC 4648)
+ * @param buffer - The buffer to convert
+ * @param padding - Whether to include padding (default: true)
+ * @returns Base32 string representation
+ */
+function bufferToBase32(buffer, padding = true) {
+    const ALPHABET = CHAR_SETS.BASE32;
+    let result = "";
+    let bits = 0;
+    let value = 0;
+    for (let i = 0; i < buffer.length; i++) {
+        value = (value << 8) | buffer[i];
+        bits += 8;
+        while (bits >= 5) {
+            result += ALPHABET[(value >>> (bits - 5)) & 31];
+            bits -= 5;
+        }
+    }
+    if (bits > 0) {
+        result += ALPHABET[(value << (5 - bits)) & 31];
+    }
+    // Add padding
+    if (padding) {
+        while (result.length % 8 !== 0) {
+            result += "=";
+        }
+    }
+    return result;
+}
+// =============================================================================
+// STRING ENCODING UTILITIES
+// =============================================================================
+/**
+ * Convert a string to a buffer using UTF-8 encoding
+ * @param str - The string to convert
+ * @returns Uint8Array representation
+ */
+function stringToBuffer(str) {
+    if (typeof TextEncoder !== "undefined") {
+        return new TextEncoder().encode(str);
+    }
+    else {
+        // Fallback for environments without TextEncoder
+        const utf8 = unescape(encodeURIComponent(str));
+        const bytes = new Uint8Array(utf8.length);
+        for (let i = 0; i < utf8.length; i++) {
+            bytes[i] = utf8.charCodeAt(i);
+        }
+        return bytes;
+    }
+}
+/**
+ * Convert a buffer to a string using UTF-8 decoding
+ * @param buffer - The buffer to convert
+ * @returns String representation
+ */
+function bufferToString(buffer) {
+    if (typeof TextDecoder !== "undefined") {
+        return new TextDecoder().decode(buffer);
+    }
+    else {
+        // Fallback for environments without TextDecoder
+        const binary = Array.from(buffer)
+            .map((b) => String.fromCharCode(b))
+            .join("");
+        return decodeURIComponent(escape(binary));
+    }
+}
+/**
+ * Convert a buffer to Base64URL encoding
+ * @param buffer - The buffer to convert
+ * @returns Base64URL encoded string
+ */
+function bufferToBase64Url(buffer) {
+    return bufferToBase64(buffer, true);
+}
+
+export { base64ToBuffer, bufferToBase32, bufferToBase58, bufferToBase64, bufferToBase64Url, bufferToBinary, bufferToHex, bufferToString, hexToBuffer, stringToBuffer };
+//# sourceMappingURL=encoding.js.map

package/dist/esm/mods/security/src/utils/encoding.js.map

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