@digitaldefiance/ecies-lib 4.4.13 → 4.4.15

package/src/utils/encryption-type-utils.d.ts

@@ -0,0 +1,29 @@
+import { EciesEncryptionType, EciesEncryptionTypeEnum } from '../enumerations/ecies-encryption-type';
+/**
+ * Converts an encryption type (string or enum) to its string representation
+ * @param type The encryption type to convert
+ * @returns The string representation of the encryption type
+ * @throws ECIESError if the type is invalid
+ */
+export declare function encryptionTypeToString(type: EciesEncryptionType | EciesEncryptionTypeEnum): string;
+/**
+ * Converts an encryption type enum to its type representation
+ * @param type The encryption type enum to convert
+ * @returns The type representation of the encryption type
+ * @throws ECIESError if the type is invalid
+ */
+export declare function encryptionTypeEnumToType(type: EciesEncryptionTypeEnum): EciesEncryptionType;
+/**
+ * Validates that a value is a valid EciesEncryptionTypeEnum
+ * @param type The value to validate
+ * @returns true if the value is a valid EciesEncryptionTypeEnum, false otherwise
+ */
+export declare function validateEciesEncryptionTypeEnum(type: EciesEncryptionTypeEnum): boolean;
+/**
+ * Ensures that a value is a valid EciesEncryptionTypeEnum
+ * @param type The value to validate
+ * @returns The validated EciesEncryptionTypeEnum
+ * @throws ECIESError if the type is invalid
+ */
+export declare function ensureEciesEncryptionTypeEnum(type: EciesEncryptionTypeEnum): EciesEncryptionTypeEnum;
+//# sourceMappingURL=encryption-type-utils.d.ts.map

package/src/utils/encryption-type-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption-type-utils.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/utils/encryption-type-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EAGxB,MAAM,uCAAuC,CAAC;AAI/C;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,mBAAmB,GAAG,uBAAuB,GAClD,MAAM,CAgBR;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,uBAAuB,GAC5B,mBAAmB,CAMrB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,uBAAuB,GAC5B,uBAAuB,CAKzB"}

package/src/utils/encryption-type-utils.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encryptionTypeToString = encryptionTypeToString;
+exports.encryptionTypeEnumToType = encryptionTypeEnumToType;
+exports.validateEciesEncryptionTypeEnum = validateEciesEncryptionTypeEnum;
+exports.ensureEciesEncryptionTypeEnum = ensureEciesEncryptionTypeEnum;
+const ecies_encryption_type_1 = require("../enumerations/ecies-encryption-type");
+const ecies_error_type_1 = require("../enumerations/ecies-error-type");
+const ecies_1 = require("../errors/ecies");
+/**
+ * Converts an encryption type (string or enum) to its string representation
+ * @param type The encryption type to convert
+ * @returns The string representation of the encryption type
+ * @throws ECIESError if the type is invalid
+ */
+function encryptionTypeToString(type) {
+    // if enum
+    let resultType;
+    if (typeof type === 'number') {
+        resultType = ecies_encryption_type_1.EciesEncryptionTypeEnumTypeMap[type];
+        if (resultType === undefined) {
+            throw new ecies_1.ECIESError(ecies_error_type_1.ECIESErrorTypeEnum.InvalidEncryptionType);
+        }
+    }
+    else {
+        resultType = type;
+    }
+    const result = ecies_encryption_type_1.EciesEncryptionTypeStringMap[resultType];
+    if (result === undefined) {
+        throw new ecies_1.ECIESError(ecies_error_type_1.ECIESErrorTypeEnum.InvalidEncryptionType);
+    }
+    return result;
+}
+/**
+ * Converts an encryption type enum to its type representation
+ * @param type The encryption type enum to convert
+ * @returns The type representation of the encryption type
+ * @throws ECIESError if the type is invalid
+ */
+function encryptionTypeEnumToType(type) {
+    const result = ecies_encryption_type_1.EciesEncryptionTypeEnumTypeMap[type];
+    if (result === undefined) {
+        throw new ecies_1.ECIESError(ecies_error_type_1.ECIESErrorTypeEnum.InvalidEncryptionType);
+    }
+    return result;
+}
+/**
+ * Validates that a value is a valid EciesEncryptionTypeEnum
+ * @param type The value to validate
+ * @returns true if the value is a valid EciesEncryptionTypeEnum, false otherwise
+ */
+function validateEciesEncryptionTypeEnum(type) {
+    return Object.values(ecies_encryption_type_1.EciesEncryptionTypeEnum).includes(type);
+}
+/**
+ * Ensures that a value is a valid EciesEncryptionTypeEnum
+ * @param type The value to validate
+ * @returns The validated EciesEncryptionTypeEnum
+ * @throws ECIESError if the type is invalid
+ */
+function ensureEciesEncryptionTypeEnum(type) {
+    if (!validateEciesEncryptionTypeEnum(type)) {
+        throw new ecies_1.ECIESError(ecies_error_type_1.ECIESErrorTypeEnum.InvalidEncryptionType);
+    }
+    return type;
+}
+//# sourceMappingURL=encryption-type-utils.js.map

package/src/utils/encryption-type-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption-type-utils.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/utils/encryption-type-utils.ts"],"names":[],"mappings":";;AAeA,wDAkBC;AAQD,4DAQC;AAOD,0EAIC;AAQD,sEAOC;AA3ED,iFAK+C;AAC/C,uEAAsE;AACtE,2CAA6C;AAE7C;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,IAAmD;IAEnD,UAAU;IACV,IAAI,UAA+B,CAAC;IACpC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,UAAU,GAAG,sDAA8B,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,kBAAU,CAAC,qCAAkB,CAAC,qBAAqB,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IACD,MAAM,MAAM,GAAG,oDAA4B,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,kBAAU,CAAC,qCAAkB,CAAC,qBAAqB,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,wBAAwB,CACtC,IAA6B;IAE7B,MAAM,MAAM,GAAG,sDAA8B,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,kBAAU,CAAC,qCAAkB,CAAC,qBAAqB,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAgB,+BAA+B,CAC7C,IAA6B;IAE7B,OAAO,MAAM,CAAC,MAAM,CAAC,+CAAuB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,6BAA6B,CAC3C,IAA6B;IAE7B,IAAI,CAAC,+BAA+B,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,kBAAU,CAAC,qCAAkB,CAAC,qBAAqB,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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":"AACA,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,CAgDA;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,CAgC7D;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,CA4B7C;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,SAAS,MAAM,EACzB,SAAS,SAAS,MAAM,EACxB,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAOnC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmBxD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,SAAS,MAAM,EACzB,SAAS,SAAS,MAAM,EACxB,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAalC"}

package/src/utils.js

@@ -0,0 +1,291 @@
+"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 ecies_string_key_1 = require("./enumerations/ecies-string-key");
+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);
+    }
+    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);
+    }
+    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);
+            }
+            break;
+        default:
+            throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsInvalidType);
+    }
+    const totalLength = 1 + lengthTypeSize + Number(length);
+    if (totalLength > buffer.length) {
+        throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsTooShort);
+    }
+    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) {
+    const engine = (0, i18n_setup_1.getEciesI18nEngine)();
+    if (!hexString || typeof hexString !== 'string') {
+        throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Utils_InvalidHexString));
+    }
+    if (hexString.length % 2 !== 0) {
+        throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Utils_HexStringMustHaveEvenLength));
+    }
+    if (!/^[0-9a-fA-F]*$/.test(hexString)) {
+        throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Utils_HexStringContainsInvalidCharacters));
+    }
+    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);
+        }
+    }
+    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);
+        }
+    }
+    else {
+        throw new errors_1.LengthError(length_error_type_1.LengthErrorType.LengthIsInvalidType);
+    }
+}
+/**
+ * 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);
+}
+/**
+ * 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) {
+    const engine = (0, i18n_setup_1.getEciesI18nEngine)();
+    if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
+        throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Utils_ValueExceedsSafeIntegerRange));
+    }
+    if (value < BigInt(Number.MIN_SAFE_INTEGER)) {
+        throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Utils_ValueBelowSafeIntegerRange));
+    }
+    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);
+    }
+}
+//# sourceMappingURL=utils.js.map

package/src/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/utils.ts"],"names":[],"mappings":";;AAWA,4CAyBC;AAED,0DAmDC;AAED,gDAMC;AAED,gDAQC;AAED,0CAIC;AAED,0CAgCC;AAUD,sBAoBC;AAKD,gDAEC;AAKD,gDAEC;AAKD,kCAEC;AAKD,kCAOC;AAKD,8CASC;AAOD,wEA+BC;AAOD,wEAUC;AAOD,gDAmBC;AAOD,wDAgBC;AAxUD,sEAAiE;AACjE,8EAAyE;AACzE,wEAAmE;AACnE,qCAAuC;AACvC,6CAAoE;AAEpE;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,MAAkB;IACjD,MAAM,UAAU,GAAuB,8BAA8B,CACnE,MAAM,CAAC,MAAM,CACd,CAAC;IACF,MAAM,cAAc,GAAW,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEzC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC7B,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,yCAAkB,CAAC,KAAK;YAC3B,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,MAAM;QACR,KAAK,yCAAkB,CAAC,MAAM;YAC5B,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa;YACtD,MAAM;QACR,KAAK,yCAAkB,CAAC,MAAM;YAC5B,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa;YACtD,MAAM;QACR,KAAK,yCAAkB,CAAC,MAAM;YAC5B,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa;YACjE,MAAM;IACV,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,uBAAuB,CAAC,MAAkB;IAIxD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,oBAAW,CAAC,mCAAe,CAAC,gBAAgB,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,QAAQ,CACvB,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,UAAU,CAClB,CAAC;IACF,MAAM,UAAU,GAAuB,8BAA8B,CACnE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CACjB,CAAC;IACF,MAAM,cAAc,GAAW,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAElE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,cAAc,EAAE,CAAC;QACvC,MAAM,IAAI,oBAAW,CAAC,mCAAe,CAAC,gBAAgB,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,MAAuB,CAAC;IAC5B,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,yCAAkB,CAAC,KAAK;YAC3B,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM;QACR,KAAK,yCAAkB,CAAC,MAAM;YAC5B,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa;YAChD,MAAM;QACR,KAAK,yCAAkB,CAAC,MAAM;YAC5B,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa;YAChD,MAAM;QACR,KAAK,yCAAkB,CAAC,MAAM;YAC5B,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa;YACnD,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACvD,MAAM,IAAI,oBAAW,CAAC,mCAAe,CAAC,eAAe,CAAC,CAAC;YACzD,CAAC;YACD,MAAM;QACR;YACE,MAAM,IAAI,oBAAW,CAAC,mCAAe,CAAC,mBAAmB,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,GAAG,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,IAAI,oBAAW,CAAC,mCAAe,CAAC,gBAAgB,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,cAAc,EAAE,WAAW,CAAC;QACtD,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAC,UAAsB;IACvD,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC;AAC5B,CAAC;AAED,SAAgB,kBAAkB,CAAC,YAAoB;IACrD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,KAAK,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,eAAe,CAAC,UAAsB;IACpD,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;SAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SACjD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,SAAgB,eAAe,CAAC,SAAiB;IAC/C,MAAM,MAAM,GAAG,IAAA,+BAAkB,GAAE,CAAC;IACpC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,MAAM,CAAC,SAAS,CACd,6BAAgB,EAChB,iCAAc,CAAC,4BAA4B,CAC5C,CACF,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,MAAM,CAAC,SAAS,CACd,6BAAgB,EAChB,iCAAc,CAAC,uCAAuC,CACvD,CACF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,MAAM,CAAC,SAAS,CACd,6BAAgB,EAChB,iCAAc,CAAC,8CAA8C,CAC9D,CACF,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AAEH;;;GAGG;AACH,SAAgB,KAAK,CAAC,IAAgB;IACpC,IAAI,GAAG,GAAG,MAAM,CAAC,CAAC,sCAAsC;IACxD,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,yBAAyB;IAEpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,IAAI,GAAG,GAAG,MAAM,EAAE,CAAC;gBACjB,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;YACjB,CAAC;YACD,GAAG,IAAI,MAAM,CAAC,CAAC,iBAAiB;QAClC,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,aAAa;IAC7C,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,GAAW;IAC5C,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAAiB;IAClD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,MAAc;IACxC,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,CAAa,EAAE,CAAa;IACtD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,KAAK,CAAC,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,GAAG,MAAoB;IACvD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAgB,8BAA8B,CAG5C,MAAuB;IACvB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;YACjB,OAAO,yCAAkB,CAAC,KAAK,CAAC;QAClC,CAAC;aAAM,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC;YAC1B,OAAO,yCAAkB,CAAC,MAAM,CAAC;QACnC,CAAC;aAAM,IAAI,MAAM,GAAG,UAAU,EAAE,CAAC;YAC/B,OAAO,yCAAkB,CAAC,MAAM,CAAC;QACnC,CAAC;aAAM,IAAI,MAAM,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5C,OAAO,yCAAkB,CAAC,MAAM,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,oBAAW,CAAC,mCAAe,CAAC,eAAe,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtC,IAAI,MAAM,GAAG,IAAI,EAAE,CAAC;YAClB,OAAO,yCAAkB,CAAC,KAAK,CAAC;QAClC,CAAC;aAAM,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC;YAC3B,OAAO,yCAAkB,CAAC,MAAM,CAAC;QACnC,CAAC;aAAM,IAAI,MAAM,GAAG,WAAW,EAAE,CAAC;YAChC,OAAO,yCAAkB,CAAC,MAAM,CAAC;QACnC,CAAC;aAAM,IAAI,MAAM,GAAG,qBAAqB,EAAE,CAAC;YAC1C,OAAO,yCAAkB,CAAC,MAAM,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,oBAAW,CAAC,mCAAe,CAAC,eAAe,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,oBAAW,CAAC,mCAAe,CAAC,mBAAmB,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,8BAA8B,CAG5C,KAAa;IACb,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,yCAAkB,CAAC,EAAE,CAAC;QACvD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,oBAAW,CAAC,mCAAe,CAAC,mBAAmB,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,KAAa;IAC9C,MAAM,MAAM,GAAG,IAAA,+BAAkB,GAAE,CAAC;IACpC,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,MAAM,CAAC,SAAS,CACd,6BAAgB,EAChB,iCAAc,CAAC,wCAAwC,CACxD,CACF,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,MAAM,CAAC,SAAS,CACd,6BAAgB,EAChB,iCAAc,CAAC,sCAAsC,CACtD,CACF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CAGpC,IAAwB;IACxB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,yCAAkB,CAAC,KAAK;YAC3B,OAAO,CAAC,CAAC;QACX,KAAK,yCAAkB,CAAC,MAAM;YAC5B,OAAO,CAAC,CAAC;QACX,KAAK,yCAAkB,CAAC,MAAM;YAC5B,OAAO,CAAC,CAAC;QACX,KAAK,yCAAkB,CAAC,MAAM;YAC5B,OAAO,CAAC,CAAC;QACX;YACE,MAAM,IAAI,oBAAW,CAAC,mCAAe,CAAC,mBAAmB,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Digital Defiance
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/src/builders/ecies-builder.ts

@@ -1,39 +0,0 @@
-/**
- * Fluent builder for ECIESService
- */
-
-import { PluginI18nEngine } from '@digitaldefiance/i18n-lib';
-import { IECIESConstants } from '../interfaces/ecies-consts';
-import { IECIESConfig } from '../interfaces/ecies-config';
-import { Constants } from '../constants';
-import { ECIESService } from '../services/ecies/service';
-
-export class ECIESBuilder {
-  private serviceConfig: Partial<IECIESConfig> = {};
-  private eciesConsts: Partial<IECIESConstants> = {};
-  private i18n?: PluginI18nEngine<string>;
-
-  static create(): ECIESBuilder {
-    return new ECIESBuilder();
-  }
-
-  withServiceConfig(config: Partial<IECIESConfig>): this {
-    this.serviceConfig = { ...this.serviceConfig, ...config };
-    return this;
-  }
-
-  withConstants(constants: Partial<IECIESConstants>): this {
-    this.eciesConsts = { ...this.eciesConsts, ...constants };
-    return this;
-  }
-
-  withI18n(engine: PluginI18nEngine<string>): this {
-    this.i18n = engine;
-    return this;
-  }
-
-  build(): ECIESService {
-    const finalConstants = { ...Constants.ECIES, ...this.eciesConsts };
-    return new ECIESService(this.serviceConfig, finalConstants);
-  }
-}