xypriss 1.0.0 → 1.0.1

package/dist/esm/mods/toolkit/src/helpers/Uint8Array.js

@@ -0,0 +1,333 @@
+import { __processor__ } from 'nehonix-uri-processor';
+import { bufferToHex } from '../utils/encoding.js';
+import '../utils/memory/index.js';
+
+/**
+ * Enhanced Uint8Array with encoding support and improved security
+ */
+class EnhancedUint8Array extends Uint8Array {
+    constructor() {
+        super(...arguments);
+        this._isCleared = false;
+    }
+    /**
+     * Convert to string with specified encoding
+     * @param encoding - Encoding type (optional, defaults to hex for security)
+     * @returns Encoded string
+     */
+    toString(encoding) {
+        this._checkCleared();
+        // Default to hex encoding for security if no encoding specified
+        const safeEncoding = encoding || "hex";
+        switch (safeEncoding) {
+            case "hex":
+                return this._toHexSecure();
+            case "base64":
+                return this._toBase64Secure();
+            case "base64url":
+                const base64 = this._toBase64Secure();
+                return base64
+                    .replace(/\+/g, "-")
+                    .replace(/\//g, "_")
+                    .replace(/=/g, "");
+            case "base58":
+                return this._toBase58Secure();
+            case "binary":
+                // Security warning: binary encoding can be dangerous
+                console.warn("Binary encoding may expose sensitive data in logs");
+                return this._toBinarySecure();
+            case "utf8":
+                return this._toUtf8Secure();
+            default:
+                // Validate encoding parameter to prevent injection
+                if (typeof safeEncoding !== "string" ||
+                    !/^[a-zA-Z0-9_-]+$/.test(safeEncoding)) {
+                    throw new Error("Invalid encoding type");
+                }
+                return __processor__.encode(bufferToHex(this), safeEncoding);
+        }
+    }
+    /**
+     * Secure hex conversion
+     */
+    _toHexSecure() {
+        const result = new Array(this.length * 2);
+        for (let i = 0; i < this.length; i++) {
+            const hex = this[i].toString(16);
+            result[i * 2] = hex.length === 1 ? "0" : hex[0];
+            result[i * 2 + 1] = hex.length === 1 ? hex[0] : hex[1];
+        }
+        return result.join("");
+    }
+    /**
+     * Secure base64 conversion
+     */
+    _toBase64Secure() {
+        if (typeof Buffer !== "undefined") {
+            return Buffer.from(this).toString("base64");
+        }
+        else {
+            // More secure browser fallback with validation
+            try {
+                // Validate data length to prevent memory issues
+                if (this.length > 1024 * 1024) {
+                    // 1MB limit
+                    throw new Error("Data too large for base64 encoding");
+                }
+                let binary = "";
+                const chunkSize = 8192; // Process in chunks to avoid call stack limits
+                for (let i = 0; i < this.length; i += chunkSize) {
+                    const chunk = this.slice(i, Math.min(i + chunkSize, this.length));
+                    binary += String.fromCharCode(...chunk);
+                }
+                return btoa(binary);
+            }
+            catch (error) {
+                throw new Error("Base64 encoding failed: " + error.message);
+            }
+        }
+    }
+    /**
+     * Secure Base58 conversion with improved error handling
+     */
+    _toBase58Secure() {
+        const ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+        if (this.length === 0)
+            return "";
+        // Validate input size to prevent DoS
+        if (this.length > 1024) {
+            throw new Error("Input too large for Base58 encoding");
+        }
+        try {
+            // Count leading zeros
+            let leadingZeros = 0;
+            for (const byte of this) {
+                if (byte === 0)
+                    leadingZeros++;
+                else
+                    break;
+            }
+            // Convert to base58 with overflow protection
+            let num = BigInt(0);
+            for (const byte of this) {
+                const newNum = num * BigInt(256) + BigInt(byte);
+                // Check for reasonable bounds
+                if (newNum > BigInt(Number.MAX_SAFE_INTEGER) * BigInt(1000)) {
+                    throw new Error("Number too large for Base58 conversion");
+                }
+                num = newNum;
+            }
+            let result = "";
+            while (num > 0) {
+                const remainder = Number(num % BigInt(58));
+                result = ALPHABET[remainder] + result;
+                num = num / BigInt(58);
+            }
+            return "1".repeat(leadingZeros) + result;
+        }
+        catch (error) {
+            throw new Error("Base58 encoding failed: " + error.message);
+        }
+    }
+    /**
+     * Secure binary conversion
+     */
+    _toBinarySecure() {
+        try {
+            // Limit size to prevent memory issues
+            if (this.length > 65536) {
+                // 64KB limit
+                throw new Error("Data too large for binary string conversion");
+            }
+            let result = "";
+            const chunkSize = 8192;
+            for (let i = 0; i < this.length; i += chunkSize) {
+                const chunk = this.slice(i, Math.min(i + chunkSize, this.length));
+                result += String.fromCharCode(...chunk);
+            }
+            return result;
+        }
+        catch (error) {
+            throw new Error("Binary encoding failed: " + error.message);
+        }
+    }
+    /**
+     * Secure UTF-8 conversion
+     */
+    _toUtf8Secure() {
+        if (typeof TextDecoder !== "undefined") {
+            try {
+                const decoder = new TextDecoder("utf-8", { fatal: true });
+                return decoder.decode(this);
+            }
+            catch (error) {
+                throw new Error("Invalid UTF-8 sequence");
+            }
+        }
+        else {
+            // Fallback with validation
+            try {
+                return this._toBinarySecure();
+            }
+            catch (error) {
+                throw new Error("UTF-8 decoding failed: " + error.message);
+            }
+        }
+    }
+    /**
+     * Get entropy information with enhanced analysis
+     */
+    getEntropyInfo() {
+        this._checkCleared();
+        const entropy = this._calculateShannonEntropy();
+        return {
+            bytes: this.length,
+            bits: this.length * 8,
+            quality: this._getQualityRating(entropy),
+            entropy: Math.round(entropy * 100) / 100,
+        };
+    }
+    /**
+     * Calculate Shannon entropy for quality assessment
+     */
+    _calculateShannonEntropy() {
+        if (this.length === 0)
+            return 0;
+        const frequency = new Map();
+        // Count byte frequencies
+        for (const byte of this) {
+            frequency.set(byte, (frequency.get(byte) || 0) + 1);
+        }
+        // Calculate entropy
+        let entropy = 0;
+        for (const count of frequency.values()) {
+            const probability = count / this.length;
+            entropy -= probability * Math.log2(probability);
+        }
+        return entropy;
+    }
+    /**
+     * Get quality rating based on entropy and length
+     */
+    _getQualityRating(entropy) {
+        if (this.length < 8)
+            return "VERY_LOW";
+        if (this.length < 16)
+            return "LOW";
+        if (entropy < 6)
+            return "LOW";
+        if (entropy < 7)
+            return "MEDIUM";
+        if (entropy < 7.5)
+            return "HIGH";
+        return "VERY_HIGH";
+    }
+    /**
+     * Get as Buffer with proper typing and security
+     * @returns Buffer<ArrayBufferLike> containing the same data
+     */
+    getBuffer() {
+        this._checkCleared();
+        if (typeof Buffer !== "undefined") {
+            // Create a proper Buffer from the Uint8Array
+            const buffer = Buffer.from(this.buffer, this.byteOffset, this.byteLength);
+            return buffer;
+        }
+        else {
+            // Enhanced browser fallback with proper Buffer-like interface
+            const arrayBuffer = this.buffer.slice(this.byteOffset, this.byteOffset + this.byteLength);
+            const buffer = new Uint8Array(arrayBuffer);
+            // Add Buffer methods
+            buffer.toString = (encoding) => {
+                switch (encoding) {
+                    case "hex":
+                        return this._toHexSecure();
+                    case "base64":
+                        return this._toBase64Secure();
+                    case "utf8":
+                    case "utf-8":
+                        return this._toUtf8Secure();
+                    case "binary":
+                        return this._toBinarySecure();
+                    case "ascii":
+                        return this._toBinarySecure(); // ASCII is subset of binary
+                    default:
+                        return this._toHexSecure();
+                }
+            };
+            // Add other essential Buffer properties
+            Object.defineProperty(buffer, "length", {
+                value: this.length,
+                writable: false,
+            });
+            // Add buffer property pointing to the ArrayBuffer
+            Object.defineProperty(buffer, "buffer", {
+                value: arrayBuffer,
+                writable: false,
+            });
+            return buffer;
+        }
+    }
+    /**
+     * Securely clear the array contents
+     */
+    clear() {
+        if (!this._isCleared) {
+            // Overwrite with random data first, then zeros
+            if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+                crypto.getRandomValues(this);
+            }
+            this.fill(0);
+            this._isCleared = true;
+        }
+    }
+    /**
+     * Check if array has been cleared
+     */
+    _checkCleared() {
+        if (this._isCleared) {
+            throw new Error("Cannot access cleared EnhancedUint8Array");
+        }
+    }
+    /**
+     * Create a secure copy of the array
+     */
+    secureClone() {
+        this._checkCleared();
+        const clone = new EnhancedUint8Array(this.length);
+        clone.set(this);
+        return clone;
+    }
+    /**
+     * Compare with another array in constant time to prevent timing attacks
+     */
+    constantTimeEquals(other) {
+        this._checkCleared();
+        if (this.length !== other.length) {
+            return false;
+        }
+        let result = 0;
+        for (let i = 0; i < this.length; i++) {
+            result |= this[i] ^ other[i];
+        }
+        return result === 0;
+    }
+    /**
+     * Convert to regular Uint8Array for safe Buffer operations
+     */
+    toUint8Array() {
+        this._checkCleared();
+        return new Uint8Array(this);
+    }
+    /**
+     * Override valueOf to provide safe primitive conversion
+     * Returns this instance for Buffer.from() compatibility
+     */
+    valueOf() {
+        this._checkCleared();
+        return this;
+    }
+}
+
+export { EnhancedUint8Array };
+//# sourceMappingURL=Uint8Array.js.map

package/dist/esm/mods/toolkit/src/helpers/Uint8Array.js.map

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

package/dist/esm/mods/toolkit/src/helpers/createEnu.js

@@ -0,0 +1,25 @@
+function createEnum(values) {
+    return Object.fromEntries(values.map((value) => [
+        value.toUpperCase().replace(/[^A-Z0-9]/g, ""),
+        value,
+    ]));
+}
+// How the function works:
+// 1. T extends readonly string[] - Generic constraint
+//    T must be a readonly array of strings like ["a", "b", "c"] as const
+// 2. T[number] - Gets union type of array elements
+//    If T = ["pbkdf2", "scrypt"] as const
+//    Then T[number] = "pbkdf2" | "scrypt"
+// 3. [K in T[number] as Uppercase<K>]: K - Mapped type
+//    K iterates over each string in the union
+//    as Uppercase<K> transforms the key: "pbkdf2" becomes "PBKDF2"
+//    : K sets the value to the original string
+//    Result: { PBKDF2: "pbkdf2", SCRYPT: "scrypt" }
+// 4. Object.fromEntries + map creates the runtime object
+//    ["pbkdf2", "scrypt"] becomes [["PBKDF2", "pbkdf2"], ["SCRYPT", "scrypt"]]
+//    Then becomes { PBKDF2: "pbkdf2", SCRYPT: "scrypt" }
+// 5. as {...} assertion tells TypeScript the exact type
+//    Without it, TypeScript would infer Record<string, string>
+
+export { createEnum };
+//# sourceMappingURL=createEnu.js.map

package/dist/esm/mods/toolkit/src/helpers/createEnu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEnu.js","sources":["../../../../../../mods/toolkit/src/helpers/createEnu.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAM,SAAU,UAAU,CAA8B,MAAS,EAAA;AAC7D,IAAA,OAAO,MAAM,CAAC,WAAW,CACrB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK;QAClB,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;QAC7C,KAAK;AACR,KAAA,CAAC,CACsC,CAAC;AACjD,CAAC;AAED;AAEA;AACA;AAEA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AAEA;AACA;;;;"}