@digitaldefiance/ecies-lib 1.1.24 → 1.1.26

package/src/services/pbkdf2.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pbkdf2Service = void 0;
+const constants_1 = require("../constants");
+const pbkdf2_error_type_1 = require("../enumerations/pbkdf2-error-type");
+const pbkdf2_1 = require("../errors/pbkdf2");
+/**
+ * Service for handling PBKDF2 (Password-Based Key Derivation Function 2) operations.
+ * This service provides functionality for:
+ * - Generating secure key derivation configurations
+ * - Deriving cryptographic keys from passwords
+ * - Managing salt and iteration parameters
+ * - Both synchronous and asynchronous key derivation
+ */
+class Pbkdf2Service {
+    engine;
+    profiles;
+    eciesConsts;
+    pbkdf2Consts;
+    constructor(engine, profiles = constants_1.Constants.PBKDF2_PROFILES, eciesParams = constants_1.Constants.ECIES, pbkdf2Params = constants_1.Constants.PBKDF2) {
+        this.engine = engine;
+        this.profiles = profiles;
+        this.eciesConsts = eciesParams;
+        this.pbkdf2Consts = pbkdf2Params;
+    }
+    /**
+     * Get a predefined configuration profile for common use cases
+     * @param profile The name of the profile to use
+     * @returns Configuration object for the specified profile
+     */
+    getProfileConfig(profile) {
+        const profileConfig = this.profiles[profile];
+        if (!profileConfig) {
+            throw new pbkdf2_1.Pbkdf2Error(pbkdf2_error_type_1.Pbkdf2ErrorType.InvalidProfile, this.engine);
+        }
+        return {
+            hashBytes: profileConfig.hashBytes,
+            saltBytes: profileConfig.saltBytes,
+            iterations: profileConfig.iterations,
+            algorithm: profileConfig.algorithm,
+        };
+    }
+    /**
+     * Generate an options object for pbkdf2
+     * @param iterations Optional number of iterations (defaults to Pbkdf2IterationsPerSecond)
+     * @param saltBytes Optional salt size in bytes (defaults to PBKDF2.SALT_BYTES)
+     * @param hashBytes Optional hash size in bytes (defaults to ECIES.SYMMETRIC.KEY_SIZE)
+     * @param algorithm Optional hash algorithm (defaults to PBKDF2.ALGORITHM)
+     * @returns Configuration object for PBKDF2
+     */
+    getConfig(iterations, saltBytes, hashBytes, algorithm) {
+        // larger numbers mean better security, less
+        return {
+            // size of the generated hash
+            hashBytes: hashBytes ?? this.eciesConsts.SYMMETRIC.KEY_SIZE,
+            // larger salt means hashed passwords are more resistant to rainbow table, but
+            // you get diminishing returns pretty fast
+            saltBytes: saltBytes ?? this.pbkdf2Consts.SALT_BYTES,
+            // more iterations means an attacker has to take longer to brute force an
+            // individual password, so larger is better. however, larger also means longer
+            // to hash the password. tune so that hashing the password takes about a
+            // second
+            iterations: iterations ?? this.pbkdf2Consts.ITERATIONS_PER_SECOND,
+            // hash algorithm
+            algorithm: algorithm ?? this.pbkdf2Consts.ALGORITHM,
+        };
+    }
+    /**
+     * Given a password, use pbkdf2 to generate an appropriately sized key for AES encryption
+     * @param password The password to derive a key from
+     * @param salt Optional salt (will be randomly generated if not provided)
+     * @param iterations Optional number of iterations
+     * @param saltBytes Optional salt size in bytes
+     * @param keySize Optional key size in bytes
+     * @param algorithm Optional hash algorithm
+     * @returns Object containing the derived key, salt, and iteration count
+     */
+    async deriveKeyFromPasswordAsync(password, salt, iterations, saltBytes, keySize, algorithm) {
+        const config = this.getConfig(iterations, saltBytes, keySize, algorithm);
+        const saltBytes_ = salt ?? crypto.getRandomValues(new Uint8Array(config.saltBytes));
+        if (saltBytes_.length !== config.saltBytes) {
+            throw new pbkdf2_1.Pbkdf2Error(pbkdf2_error_type_1.Pbkdf2ErrorType.InvalidSaltLength, this.engine);
+        }
+        const keyMaterial = await crypto.subtle.importKey('raw', new Uint8Array(password), 'PBKDF2', false, ['deriveBits']);
+        const keyArray = await crypto.subtle.deriveBits({
+            name: 'PBKDF2',
+            salt: new Uint8Array(saltBytes_),
+            iterations: config.iterations,
+            hash: config.algorithm,
+        }, keyMaterial, config.hashBytes * 8);
+        const keyBytes = new Uint8Array(keyArray);
+        if (keyBytes.length !== config.hashBytes) {
+            throw new pbkdf2_1.Pbkdf2Error(pbkdf2_error_type_1.Pbkdf2ErrorType.InvalidHashLength, this.engine);
+        }
+        return {
+            salt: saltBytes_,
+            hash: keyBytes,
+            iterations: config.iterations,
+        };
+    }
+    /**
+     * Derive a key using a predefined configuration profile
+     * @param password The password to derive a key from
+     * @param profile The configuration profile to use
+     * @param salt Optional salt (will be randomly generated if not provided)
+     * @returns Object containing the derived key, salt, and iteration count
+     */
+    async deriveKeyFromPasswordWithProfileAsync(password, profile, salt) {
+        const config = this.getProfileConfig(profile);
+        return await this.deriveKeyFromPasswordAsync(password, salt, config.iterations, config.saltBytes, config.hashBytes, config.algorithm);
+    }
+}
+exports.Pbkdf2Service = Pbkdf2Service;
+//# sourceMappingURL=pbkdf2.js.map

package/src/services/pbkdf2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbkdf2.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/services/pbkdf2.ts"],"names":[],"mappings":"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"}

package/src/services/xor.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A simple and fast XOR cipher for obfuscating data in memory for browser environments.
+ * This is not a substitute for strong cryptography but provides a lightweight way
+ * to prevent sensitive data from being stored in plaintext in memory.
+ */
+export declare class XorService {
+    /**
+     * Encrypts or decrypts data using a simple XOR cipher.
+     * The key is XORed with the data. The same function is used for
+     * both encryption and decryption.
+     *
+     * @param data The data to process.
+     * @param key The key to use for the XOR operation.
+     * @returns A new Uint8Array containing the result of the XOR operation.
+     */
+    static xor(data: Uint8Array, key: Uint8Array): Uint8Array;
+    /**
+     * Generates a random key of a specified length.
+     * @param length The length of the key in bytes.
+     * @returns A Uint8Array containing the random key.
+     * @throws Error if crypto API is not available.
+     */
+    static generateKey(length: number): Uint8Array;
+    /**
+     * Helper method to convert a string to a Uint8Array.
+     * @param str The string to convert.
+     * @returns A Uint8Array representation of the string.
+     */
+    static stringToBytes(str: string): Uint8Array;
+    /**
+     * Helper method to convert a Uint8Array to a string.
+     * @param bytes The Uint8Array to convert.
+     * @returns A string representation of the Uint8Array.
+     */
+    static bytesToString(bytes: Uint8Array): string;
+}
+//# sourceMappingURL=xor.d.ts.map

package/src/services/xor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/services/xor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,UAAU;IACrB;;;;;;;;OAQG;WACW,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,UAAU;IAQhE;;;;;OAKG;WACW,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAgBrD;;;;OAIG;WACW,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAKpD;;;;OAIG;WACW,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;CAIvD"}

package/src/services/xor.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XorService = void 0;
+/**
+ * A simple and fast XOR cipher for obfuscating data in memory for browser environments.
+ * This is not a substitute for strong cryptography but provides a lightweight way
+ * to prevent sensitive data from being stored in plaintext in memory.
+ */
+class XorService {
+    /**
+     * Encrypts or decrypts data using a simple XOR cipher.
+     * The key is XORed with the data. The same function is used for
+     * both encryption and decryption.
+     *
+     * @param data The data to process.
+     * @param key The key to use for the XOR operation.
+     * @returns A new Uint8Array containing the result of the XOR operation.
+     */
+    static xor(data, key) {
+        const result = new Uint8Array(data.length);
+        for (let i = 0; i < data.length; i++) {
+            result[i] = data[i] ^ key[i % key.length];
+        }
+        return result;
+    }
+    /**
+     * Generates a random key of a specified length.
+     * @param length The length of the key in bytes.
+     * @returns A Uint8Array containing the random key.
+     * @throws Error if crypto API is not available.
+     */
+    static generateKey(length) {
+        const randomBytes = new Uint8Array(length);
+        // Check if running in a browser with crypto support
+        if (typeof window !== 'undefined' && window.crypto) {
+            window.crypto.getRandomValues(randomBytes);
+        }
+        else if (typeof crypto !== 'undefined') {
+            // For environments where crypto is global (some newer JS runtimes)
+            crypto.getRandomValues(randomBytes);
+        }
+        else {
+            throw new Error('Crypto API not available in this environment');
+        }
+        return randomBytes;
+    }
+    /**
+     * Helper method to convert a string to a Uint8Array.
+     * @param str The string to convert.
+     * @returns A Uint8Array representation of the string.
+     */
+    static stringToBytes(str) {
+        const encoder = new TextEncoder();
+        return encoder.encode(str);
+    }
+    /**
+     * Helper method to convert a Uint8Array to a string.
+     * @param bytes The Uint8Array to convert.
+     * @returns A string representation of the Uint8Array.
+     */
+    static bytesToString(bytes) {
+        const decoder = new TextDecoder();
+        return decoder.decode(bytes);
+    }
+}
+exports.XorService = XorService;
+//# sourceMappingURL=xor.js.map

package/src/services/xor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/services/xor.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,UAAU;IACrB;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAgB,EAAE,GAAe;QACjD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,WAAW,CAAC,MAAc;QACtC,MAAM,WAAW,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAE3C,oDAAoD;QACpD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YACzC,mEAAmE;YACnE,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,aAAa,CAAC,GAAW;QACrC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,aAAa,CAAC,KAAiB;QAC3C,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF;AA3DD,gCA2DC"}

package/src/types/deep-partial.d.ts

@@ -0,0 +1,4 @@
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends (...args: any[]) => any ? T[P] : T[P] extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T[P] extends Array<infer U> ? Array<DeepPartial<U>> : T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+//# sourceMappingURL=deep-partial.d.ts.map

package/src/types/deep-partial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-partial.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/types/deep-partial.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GACjD,CAAC,CAAC,CAAC,CAAC,GACJ,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GACnC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAC7B,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAC3B,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACrB,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACnB,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACjB,CAAC,CAAC,CAAC,CAAC;CACT,CAAC"}

package/src/types/deep-partial.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=deep-partial.js.map

package/src/types/deep-partial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-partial.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/types/deep-partial.ts"],"names":[],"mappings":""}

package/src/{types.ts → types.d.ts}

@@ -1,6 +1,5 @@
 import { Brand } from 'ts-brand';
 import { GuidBrandType } from './enumerations';
-
 /**
  * GUID stored as a BigInt
  */
@@ -20,18 +19,13 @@ export type Base64Guid = Brand<string, 'GuidV4', GuidBrandType.Base64Guid>;
 /**
  * GUID stored as a raw buffer
  */
-export type RawGuidUint8Array = Uint8Array &
-  Brand<Uint8Array, 'GuidV4', GuidBrandType.RawGuidUint8Array>;
-
-// Placeholder GUID types for cross-project compatibility
+export type RawGuidUint8Array = Uint8Array & Brand<Uint8Array, 'GuidV4', GuidBrandType.RawGuidUint8Array>;
 export type BinaryGuid = Uint8Array;
 export type HexGuid = string;
 export type ShortGuid = string;
-
-export type SignatureUint8Array = Uint8Array &
-  Brand<Uint8Array, 'SignatureArray'>;
-export type ChecksumUint8Array = Uint8Array &
-  Brand<Uint8Array, 'Sha3Checksum', 'ChecksumArray'>;
+export type SignatureUint8Array = Uint8Array & Brand<Uint8Array, 'SignatureArray'>;
+export type ChecksumUint8Array = Uint8Array & Brand<Uint8Array, 'Sha3Checksum', 'ChecksumArray'>;
 export type SignatureString = string & Brand<string, 'SignatureString'>;
 export type HexString = Brand<string, 'HexString'>;
 export type ChecksumString = Brand<HexString, 'Sha3Checksum', 'ChecksumString'>;
+//# sourceMappingURL=types.d.ts.map

package/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;AAC3E;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;AAC7E;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;AAC/E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;AAC3E;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GACxC,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;AAG/D,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC;AACpC,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAC7B,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAC1C,KAAK,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;AACtC,MAAM,MAAM,kBAAkB,GAAG,UAAU,GACzC,KAAK,CAAC,UAAU,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AACxE,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC"}

package/src/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/types.ts"],"names":[],"mappings":""}

package/src/utils.d.ts

@@ -0,0 +1,68 @@
+import { LengthEncodingType } from './enumerations/length-encoding-type';
+/**
+ * Encodes the length of the data in the buffer
+ * @param buffer The buffer to encode
+ * @returns The encoded buffer
+ */
+export declare function lengthEncodeData(buffer: Uint8Array): Uint8Array;
+export declare function decodeLengthEncodedData(buffer: Uint8Array): {
+    data: Uint8Array;
+    totalLength: number;
+};
+export declare function uint8ArrayToBase64(uint8Array: Uint8Array): string;
+export declare function base64ToUint8Array(base64String: string): Uint8Array;
+export declare function uint8ArrayToHex(uint8Array: Uint8Array): string;
+export declare function hexToUint8Array(hexString: string): Uint8Array;
+/**
+ * Utility functions for browser ECIES implementation
+ */
+/**
+ * CRC16-CCITT implementation for data integrity checking
+ * Uses CRC16-CCITT-FALSE variant (init 0xFFFF)
+ */
+export declare function crc16(data: Uint8Array): Uint8Array;
+/**
+ * Convert string to Uint8Array (UTF-8 encoding)
+ */
+export declare function stringToUint8Array(str: string): Uint8Array;
+/**
+ * Convert Uint8Array to string (UTF-8 decoding)
+ */
+export declare function uint8ArrayToString(array: Uint8Array): string;
+/**
+ * Secure random bytes generation
+ */
+export declare function randomBytes(length: number): Uint8Array;
+/**
+ * Compare two Uint8Arrays for equality
+ */
+export declare function arraysEqual(a: Uint8Array, b: Uint8Array): boolean;
+/**
+ * Concatenate multiple Uint8Arrays
+ */
+export declare function concatUint8Arrays(...arrays: Uint8Array[]): Uint8Array;
+/**
+ * Get the length encoding type for a given length
+ * @param length The length to evaluate
+ * @returns The corresponding LengthEncodingType
+ */
+export declare function getLengthEncodingTypeForLength<TStringKey extends string, TLanguage extends string>(length: number | BigInt): LengthEncodingType;
+/**
+ * Get the length encoding type for a given value
+ * @param value The value to evaluate
+ * @returns The corresponding LengthEncodingType
+ */
+export declare function getLengthEncodingTypeFromValue<TStringKey extends string, TLanguage extends string>(value: number): LengthEncodingType;
+/**
+ * Safely converts BigInt to Number, throwing if value exceeds safe integer range
+ * @param value The BigInt value to convert
+ * @returns The number value
+ */
+export declare function safeBigIntToNumber(value: bigint): number;
+/**
+ * Get the length in bytes for a given LengthEncodingType
+ * @param type The LengthEncodingType to evaluate
+ * @returns The length in bytes
+ */
+export declare function getLengthForLengthType<TStringKey extends string, TLanguage extends string>(type: LengthEncodingType): number;
+//# sourceMappingURL=utils.d.ts.map

package/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAKzE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAyB/D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,UAAU,GAAG;IAC3D,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CA+DA;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAMjE;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAQnE;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAI9D;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAgB7D;AAED;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAoBlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAE1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAEtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAOjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CASrE;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,SAAS,MAAM,EACzB,SAAS,SAAS,MAAM,EACxB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,kBAAkB,CAqC7C;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,SAAS,MAAM,EACzB,SAAS,SAAS,MAAM,EACxB,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAUnC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,SAAS,MAAM,EACzB,SAAS,SAAS,MAAM,EACxB,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAgBlC"}

package/src/utils.js

@@ -0,0 +1,288 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lengthEncodeData = lengthEncodeData;
+exports.decodeLengthEncodedData = decodeLengthEncodedData;
+exports.uint8ArrayToBase64 = uint8ArrayToBase64;
+exports.base64ToUint8Array = base64ToUint8Array;
+exports.uint8ArrayToHex = uint8ArrayToHex;
+exports.hexToUint8Array = hexToUint8Array;
+exports.crc16 = crc16;
+exports.stringToUint8Array = stringToUint8Array;
+exports.uint8ArrayToString = uint8ArrayToString;
+exports.randomBytes = randomBytes;
+exports.arraysEqual = arraysEqual;
+exports.concatUint8Arrays = concatUint8Arrays;
+exports.getLengthEncodingTypeForLength = getLengthEncodingTypeForLength;
+exports.getLengthEncodingTypeFromValue = getLengthEncodingTypeFromValue;
+exports.safeBigIntToNumber = safeBigIntToNumber;
+exports.getLengthForLengthType = getLengthForLengthType;
+const length_encoding_type_1 = require("./enumerations/length-encoding-type");
+const length_error_type_1 = require("./enumerations/length-error-type");
+const errors_1 = require("./errors");
+const i18n_setup_1 = require("./i18n-setup");
+/**
+ * Encodes the length of the data in the buffer
+ * @param buffer The buffer to encode
+ * @returns The encoded buffer
+ */
+function lengthEncodeData(buffer) {
+    const lengthType = getLengthEncodingTypeForLength(buffer.length);
+    const lengthTypeSize = getLengthForLengthType(lengthType);
+    const result = new Uint8Array(1 + lengthTypeSize + buffer.length);
+    const view = new DataView(result.buffer);
+    view.setUint8(0, lengthType);
+    switch (lengthType) {
+        case length_encoding_type_1.LengthEncodingType.UInt8:
+            view.setUint8(1, buffer.length);
+            break;
+        case length_encoding_type_1.LengthEncodingType.UInt16:
+            view.setUint16(1, buffer.length, false); // big-endian
+            break;
+        case length_encoding_type_1.LengthEncodingType.UInt32:
+            view.setUint32(1, buffer.length, false); // big-endian
+            break;
+        case length_encoding_type_1.LengthEncodingType.UInt64:
+            view.setBigUint64(1, BigInt(buffer.length), false); // big-endian
+            break;
+    }
+    result.set(buffer, 1 + lengthTypeSize);
+    return result;
+}
+function decodeLengthEncodedData(buffer) {
+    if (buffer.length < 1) {
+        throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsTooShort, (0, i18n_setup_1.getEciesI18nEngine)());
+    }
+    const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+    const lengthType = getLengthEncodingTypeFromValue(view.getUint8(0));
+    const lengthTypeSize = getLengthForLengthType(lengthType);
+    if (buffer.length < 1 + lengthTypeSize) {
+        throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsTooShort, (0, i18n_setup_1.getEciesI18nEngine)());
+    }
+    let length;
+    switch (lengthType) {
+        case length_encoding_type_1.LengthEncodingType.UInt8:
+            length = view.getUint8(1);
+            break;
+        case length_encoding_type_1.LengthEncodingType.UInt16:
+            length = view.getUint16(1, false); // big-endian
+            break;
+        case length_encoding_type_1.LengthEncodingType.UInt32:
+            length = view.getUint32(1, false); // big-endian
+            break;
+        case length_encoding_type_1.LengthEncodingType.UInt64:
+            length = view.getBigUint64(1, false); // big-endian
+            if (length.valueOf() > BigInt(Number.MAX_SAFE_INTEGER)) {
+                throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsTooLong, (0, i18n_setup_1.getEciesI18nEngine)());
+            }
+            break;
+        default:
+            throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsInvalidType, (0, i18n_setup_1.getEciesI18nEngine)());
+    }
+    const totalLength = 1 + lengthTypeSize + Number(length);
+    if (totalLength > buffer.length) {
+        throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsTooShort, (0, i18n_setup_1.getEciesI18nEngine)());
+    }
+    return {
+        data: buffer.subarray(1 + lengthTypeSize, totalLength),
+        totalLength,
+    };
+}
+function uint8ArrayToBase64(uint8Array) {
+    let binaryString = '';
+    for (let i = 0; i < uint8Array.length; i++) {
+        binaryString += String.fromCharCode(uint8Array[i]);
+    }
+    return btoa(binaryString);
+}
+function base64ToUint8Array(base64String) {
+    const binaryString = atob(base64String);
+    const len = binaryString.length;
+    const bytes = new Uint8Array(len);
+    for (let i = 0; i < len; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+    }
+    return bytes;
+}
+function uint8ArrayToHex(uint8Array) {
+    return Array.from(uint8Array)
+        .map((byte) => byte.toString(16).padStart(2, '0'))
+        .join('');
+}
+function hexToUint8Array(hexString) {
+    if (!hexString || typeof hexString !== 'string') {
+        throw new Error('Invalid hex string');
+    }
+    if (hexString.length % 2 !== 0) {
+        throw new Error('Hex string must have even length');
+    }
+    if (!/^[0-9a-fA-F]*$/.test(hexString)) {
+        throw new Error('Hex string contains invalid characters');
+    }
+    const len = hexString.length;
+    const bytes = new Uint8Array(len / 2);
+    for (let i = 0; i < len; i += 2) {
+        bytes[i / 2] = parseInt(hexString.substring(i, i + 2), 16);
+    }
+    return bytes;
+}
+/**
+ * Utility functions for browser ECIES implementation
+ */
+/**
+ * CRC16-CCITT implementation for data integrity checking
+ * Uses CRC16-CCITT-FALSE variant (init 0xFFFF)
+ */
+function crc16(data) {
+    let crc = 0xffff; // Initial value for CRC16-CCITT-FALSE
+    const polynomial = 0x1021; // CRC16-CCITT polynomial
+    for (let i = 0; i < data.length; i++) {
+        crc ^= data[i] << 8;
+        for (let j = 0; j < 8; j++) {
+            if (crc & 0x8000) {
+                crc = (crc << 1) ^ polynomial;
+            }
+            else {
+                crc = crc << 1;
+            }
+            crc &= 0xffff; // Keep it 16-bit
+        }
+    }
+    const result = new Uint8Array(2);
+    result[0] = (crc >>> 8) & 0xff; // Big-endian
+    result[1] = crc & 0xff;
+    return result;
+}
+/**
+ * Convert string to Uint8Array (UTF-8 encoding)
+ */
+function stringToUint8Array(str) {
+    return new TextEncoder().encode(str);
+}
+/**
+ * Convert Uint8Array to string (UTF-8 decoding)
+ */
+function uint8ArrayToString(array) {
+    return new TextDecoder().decode(array);
+}
+/**
+ * Secure random bytes generation
+ */
+function randomBytes(length) {
+    return crypto.getRandomValues(new Uint8Array(length));
+}
+/**
+ * Compare two Uint8Arrays for equality
+ */
+function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let result = 0;
+    for (let i = 0; i < a.length; i++) {
+        result |= a[i] ^ b[i];
+    }
+    return result === 0;
+}
+/**
+ * Concatenate multiple Uint8Arrays
+ */
+function concatUint8Arrays(...arrays) {
+    const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const array of arrays) {
+        result.set(array, offset);
+        offset += array.length;
+    }
+    return result;
+}
+/**
+ * Get the length encoding type for a given length
+ * @param length The length to evaluate
+ * @returns The corresponding LengthEncodingType
+ */
+function getLengthEncodingTypeForLength(length) {
+    if (typeof length === 'number') {
+        if (length < 256) {
+            return length_encoding_type_1.LengthEncodingType.UInt8;
+        }
+        else if (length < 65536) {
+            return length_encoding_type_1.LengthEncodingType.UInt16;
+        }
+        else if (length < 4294967296) {
+            return length_encoding_type_1.LengthEncodingType.UInt32;
+        }
+        else if (length < Number.MAX_SAFE_INTEGER) {
+            return length_encoding_type_1.LengthEncodingType.UInt64;
+        }
+        else {
+            throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsTooLong, (0, i18n_setup_1.getEciesI18nEngine)());
+        }
+    }
+    else if (typeof length === 'bigint') {
+        if (length < 256n) {
+            return length_encoding_type_1.LengthEncodingType.UInt8;
+        }
+        else if (length < 65536n) {
+            return length_encoding_type_1.LengthEncodingType.UInt16;
+        }
+        else if (length < 4294967296n) {
+            return length_encoding_type_1.LengthEncodingType.UInt32;
+        }
+        else if (length < 18446744073709551616n) {
+            return length_encoding_type_1.LengthEncodingType.UInt64;
+        }
+        else {
+            throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsTooLong, (0, i18n_setup_1.getEciesI18nEngine)());
+        }
+    }
+    else {
+        throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsInvalidType, (0, i18n_setup_1.getEciesI18nEngine)());
+    }
+}
+/**
+ * Get the length encoding type for a given value
+ * @param value The value to evaluate
+ * @returns The corresponding LengthEncodingType
+ */
+function getLengthEncodingTypeFromValue(value) {
+    for (const length of Object.values(length_encoding_type_1.LengthEncodingType)) {
+        if (length === value) {
+            return length;
+        }
+    }
+    throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsInvalidType, (0, i18n_setup_1.getEciesI18nEngine)());
+}
+/**
+ * Safely converts BigInt to Number, throwing if value exceeds safe integer range
+ * @param value The BigInt value to convert
+ * @returns The number value
+ */
+function safeBigIntToNumber(value) {
+    if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
+        throw new Error('Value exceeds safe integer range');
+    }
+    if (value < BigInt(Number.MIN_SAFE_INTEGER)) {
+        throw new Error('Value below safe integer range');
+    }
+    return Number(value);
+}
+/**
+ * Get the length in bytes for a given LengthEncodingType
+ * @param type The LengthEncodingType to evaluate
+ * @returns The length in bytes
+ */
+function getLengthForLengthType(type) {
+    switch (type) {
+        case length_encoding_type_1.LengthEncodingType.UInt8:
+            return 1;
+        case length_encoding_type_1.LengthEncodingType.UInt16:
+            return 2;
+        case length_encoding_type_1.LengthEncodingType.UInt32:
+            return 4;
+        case length_encoding_type_1.LengthEncodingType.UInt64:
+            return 8;
+        default:
+            throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsInvalidType, (0, i18n_setup_1.getEciesI18nEngine)());
+    }
+}
+//# sourceMappingURL=utils.js.map