@digitaldefiance/ecies-lib 1.1.24 → 1.1.25

package/README.md

@@ -600,6 +600,10 @@ MIT © Digital Defiance
 
 ## ChangeLog
 
+### v1.1.25
+
+- Re-export with js
+
 ### v1.1.24
 
 - Upgrade to es2022/nx monorepo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/ecies-lib",
-  "version": "1.1.24",
+  "version": "1.1.25",
   "description": "Digital Defiance ECIES Library",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -31,12 +31,13 @@
   "license": "MIT",
   "packageManager": "yarn@4.10.3",
   "dependencies": {
-    "@digitaldefiance/i18n-lib": "1.3.13",
+    "@digitaldefiance/i18n-lib": "1.3.14",
     "@ethereumjs/wallet": "^10.0.0",
     "@noble/curves": "^2.0.1",
     "@noble/hashes": "^2.0.1",
     "@scure/bip32": "^2.0.0",
     "bson": "^6.10.4",
     "ts-brand": "^0.2.0"
-  }
-}
+  },
+  "type": "commonjs"
+}

package/src/constants.d.ts

@@ -0,0 +1,46 @@
+import { IChecksumConsts } from './interfaces';
+import { IConstants } from './interfaces/constants';
+import { DeepPartial } from './types/deep-partial';
+import { IECIESConstants } from './interfaces/ecies-consts';
+import { IPBkdf2Consts } from './interfaces/pbkdf2-consts';
+import { Pbkdf2Profiles } from './pbkdf2-profiles';
+export declare const UINT8_SIZE: number;
+export declare const UINT16_SIZE: number;
+export declare const UINT16_MAX: number;
+export declare const UINT32_SIZE: number;
+export declare const UINT32_MAX: number;
+export declare const UINT64_SIZE: number;
+export declare const UINT64_MAX: bigint;
+export declare const GUID_SIZE: number;
+/**
+ * Constants for checksum operations
+ * These values are critical for data integrity and MUST NOT be changed
+ * in an already established system as it will break all existing checksums.
+ */
+export declare const CHECKSUM: IChecksumConsts;
+export declare const PBKDF2: IPBkdf2Consts;
+export declare const PBKDF2_PROFILES: Pbkdf2Profiles;
+export declare const ECIES: IECIESConstants;
+export declare const Constants: IConstants;
+export type ConfigurationKey = string | symbol;
+export declare function createRuntimeConfiguration(overrides?: DeepPartial<IConstants>, base?: IConstants): IConstants;
+export declare class ConstantsRegistry {
+    static readonly DEFAULT_KEY: ConfigurationKey;
+    static listKeys(): ConfigurationKey[];
+    static has(key: ConfigurationKey): boolean;
+    static get(key?: ConfigurationKey): IConstants;
+    static create(overrides?: DeepPartial<IConstants>, baseKey?: ConfigurationKey): IConstants;
+    static register(key: ConfigurationKey, configOrOverrides?: DeepPartial<IConstants> | IConstants, options?: {
+        baseKey?: ConfigurationKey;
+    }): IConstants;
+    static unregister(key: ConfigurationKey): boolean;
+    static clear(): void;
+}
+export declare function getRuntimeConfiguration(key?: ConfigurationKey): IConstants;
+export declare function registerRuntimeConfiguration(key: ConfigurationKey, configOrOverrides?: DeepPartial<IConstants> | IConstants, options?: {
+    baseKey?: ConfigurationKey;
+}): IConstants;
+export declare function unregisterRuntimeConfiguration(key: ConfigurationKey): boolean;
+export declare function clearRuntimeConfigurations(): void;
+export { PASSWORD_REGEX, MNEMONIC_REGEX } from './regexes';
+//# sourceMappingURL=constants.d.ts.map

package/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/constants.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,eAAO,MAAM,UAAU,EAAE,MAAmB,CAAC;AAC7C,eAAO,MAAM,WAAW,EAAE,MAAmB,CAAC;AAC9C,eAAO,MAAM,UAAU,EAAE,MAAuB,CAAC;AACjD,eAAO,MAAM,WAAW,EAAE,MAAmB,CAAC;AAC9C,eAAO,MAAM,UAAU,EAAE,MAA4B,CAAC;AACtD,eAAO,MAAM,WAAW,EAAE,MAAmB,CAAC;AAC9C,eAAO,MAAM,UAAU,EAAE,MAAuC,CAAC;AACjE,eAAO,MAAM,SAAS,EAAE,MAAoB,CAAC;AAW7C;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,eAYZ,CAAC;AAEZ,eAAO,MAAM,MAAM,EAAE,aAQV,CAAC;AAEZ,eAAO,MAAM,eAAe,EAAE,cAmBnB,CAAC;AAyBZ,eAAO,MAAM,KAAK,EAAE,eAoElB,CAAC;AAEH,eAAO,MAAM,SAAS,EAAE,UAoCb,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAC;AAuK/C,wBAAgB,0BAA0B,CACxC,SAAS,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,EACnC,IAAI,GAAE,UAAsB,GAC3B,UAAU,CAKZ;AAED,qBAAa,iBAAiB;IAC5B,gBAAuB,WAAW,mBAA6B;WAEjD,QAAQ,IAAI,gBAAgB,EAAE;WAI9B,GAAG,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO;WAInC,GAAG,CAAC,GAAG,GAAE,gBAA4C,GAAG,UAAU;WAOlE,MAAM,CAClB,SAAS,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,EACnC,OAAO,GAAE,gBAA4C,GACpD,UAAU;WAKC,QAAQ,CACpB,GAAG,EAAE,gBAAgB,EACrB,iBAAiB,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,UAAU,EACxD,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,gBAAgB,CAAA;KAAE,GACvC,UAAU;WAiBC,UAAU,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO;WAO1C,KAAK,IAAI,IAAI;CAI5B;AAED,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,gBAA4C,GAChD,UAAU,CAEZ;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,gBAAgB,EACrB,iBAAiB,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,UAAU,EACxD,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE,GACvC,UAAU,CAEZ;AAED,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAET;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/src/constants.js

@@ -0,0 +1,358 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MNEMONIC_REGEX = exports.PASSWORD_REGEX = exports.ConstantsRegistry = exports.Constants = exports.ECIES = exports.PBKDF2_PROFILES = exports.PBKDF2 = exports.CHECKSUM = exports.GUID_SIZE = exports.UINT64_MAX = exports.UINT64_SIZE = exports.UINT32_MAX = exports.UINT32_SIZE = exports.UINT16_MAX = exports.UINT16_SIZE = exports.UINT8_SIZE = void 0;
+exports.createRuntimeConfiguration = createRuntimeConfiguration;
+exports.getRuntimeConfiguration = getRuntimeConfiguration;
+exports.registerRuntimeConfiguration = registerRuntimeConfiguration;
+exports.unregisterRuntimeConfiguration = unregisterRuntimeConfiguration;
+exports.clearRuntimeConfigurations = clearRuntimeConfigurations;
+const bson_1 = require("bson");
+const enumerations_1 = require("./enumerations");
+const pbkdf2_profile_1 = require("./enumerations/pbkdf2-profile");
+const ecies_1 = require("./errors/ecies");
+const i18n_setup_1 = require("./i18n-setup");
+const regexes_1 = require("./regexes");
+exports.UINT8_SIZE = 1;
+exports.UINT16_SIZE = 2;
+exports.UINT16_MAX = 65535;
+exports.UINT32_SIZE = 4;
+exports.UINT32_MAX = 4294967295;
+exports.UINT64_SIZE = 8;
+exports.UINT64_MAX = 18446744073709551615n;
+exports.GUID_SIZE = 16;
+const objectIdLength = new bson_1.ObjectId().toHexString().length / 2;
+if (objectIdLength !== 12) {
+    console.warn('ObjectID length may have changed, breaking encryption', objectIdLength);
+}
+/**
+ * Constants for checksum operations
+ * These values are critical for data integrity and MUST NOT be changed
+ * in an already established system as it will break all existing checksums.
+ */
+exports.CHECKSUM = Object.freeze({
+    /** Default hash bits for SHA3 */
+    SHA3_DEFAULT_HASH_BITS: 512,
+    /** Length of a SHA3 checksum buffer in bytes */
+    SHA3_BUFFER_LENGTH: 64,
+    /** algorithm to use for checksum */
+    ALGORITHM: 'sha3-512',
+    /** encoding to use for checksum */
+    ENCODING: 'hex',
+});
+exports.PBKDF2 = Object.freeze({
+    ALGORITHM: 'SHA-256',
+    SALT_BYTES: 32,
+    /**
+     * Number of pbkdf2 iterations per second when hashing a password.
+     * This is the high-security default for user login operations.
+     */
+    ITERATIONS_PER_SECOND: 1304000,
+});
+exports.PBKDF2_PROFILES = Object.freeze({
+    [pbkdf2_profile_1.Pbkdf2ProfileEnum.BROWSER_PASSWORD]: Object.freeze({
+        hashBytes: 32,
+        saltBytes: 64,
+        iterations: 2000000,
+        algorithm: 'SHA-512',
+    }),
+    [pbkdf2_profile_1.Pbkdf2ProfileEnum.HIGH_SECURITY]: Object.freeze({
+        hashBytes: 64,
+        saltBytes: 32,
+        iterations: 5000000,
+        algorithm: 'SHA-256',
+    }),
+    [pbkdf2_profile_1.Pbkdf2ProfileEnum.TEST_FAST]: Object.freeze({
+        hashBytes: 32,
+        saltBytes: 64,
+        iterations: 1000,
+        algorithm: 'SHA-512',
+    }),
+});
+const ECIES_SYMMETRIC_KEY_SIZE = 32;
+const ECIES_PUBLIC_KEY_LENGTH = 65;
+const ECIES_RAW_PUBLIC_KEY_LENGTH = 64;
+const ECIES_IV_SIZE = 16;
+const ECIES_AUTH_TAG_SIZE = 16;
+const ECIES_MULTIPLE_RECIPIENT_ID_SIZE = 16;
+// Define the expected value for SIMPLE.FIXED_OVERHEAD_SIZE
+const expectedSimpleOverhead = exports.UINT8_SIZE + ECIES_PUBLIC_KEY_LENGTH + ECIES_IV_SIZE + ECIES_AUTH_TAG_SIZE;
+// Define the expected value for MULTIPLE.FIXED_OVERHEAD_SIZE
+// Includes: type (1) + IV (16) + auth tag (16) = 33 (no CRC, AES-GCM provides authentication)
+const expectedMultipleOverhead = exports.UINT8_SIZE + ECIES_IV_SIZE + ECIES_AUTH_TAG_SIZE;
+// Update ENCRYPTED_KEY_SIZE to match Simple encryption (no CRC)
+const expectedMultipleEncryptedKeySize = ECIES_PUBLIC_KEY_LENGTH +
+    ECIES_IV_SIZE +
+    ECIES_AUTH_TAG_SIZE +
+    ECIES_SYMMETRIC_KEY_SIZE;
+exports.ECIES = Object.freeze({
+    /** The elliptic curve to use for all ECDSA operations */
+    CURVE_NAME: 'secp256k1',
+    /** The primary key derivation path for HD wallets */
+    PRIMARY_KEY_DERIVATION_PATH: "m/44'/60'/0'/0/0",
+    SYMMETRIC_ALGORITHM_CONFIGURATION: 'aes-256-gcm',
+    /** Length of ECDSA signatures in bytes */
+    SIGNATURE_SIZE: 64,
+    /** Length of raw public keys in bytes (without 0x04 prefix) */
+    RAW_PUBLIC_KEY_LENGTH: ECIES_RAW_PUBLIC_KEY_LENGTH,
+    /** Length of public keys in bytes (with 0x04 prefix) */
+    PUBLIC_KEY_LENGTH: ECIES_PUBLIC_KEY_LENGTH,
+    PUBLIC_KEY_MAGIC: 0x04,
+    /** Mnemonic strength in bits. This will produce a 32-bit key for ECDSA */
+    MNEMONIC_STRENGTH: 256,
+    /** Symmetric encryption algorithm configuration */
+    SYMMETRIC: Object.freeze({
+        ALGORITHM: 'aes',
+        MODE: 'gcm',
+        KEY_BITS: 256,
+        KEY_SIZE: ECIES_SYMMETRIC_KEY_SIZE, // KEY_BITS / 8
+    }),
+    IV_SIZE: ECIES_IV_SIZE,
+    AUTH_TAG_SIZE: ECIES_AUTH_TAG_SIZE,
+    MAX_RAW_DATA_SIZE: 9007199254740991, // 2^53 - 1 (max safe integer for JS)
+    /**
+     * Message encrypts without data length or crc
+     */
+    SIMPLE: Object.freeze({
+        FIXED_OVERHEAD_SIZE: expectedSimpleOverhead, // type (1) + public key (65) + IV (16) + auth tag (16)
+        DATA_LENGTH_SIZE: 0,
+    }),
+    /**
+     * Message encrypts with data length but no CRC (AES-GCM provides authentication)
+     */
+    SINGLE: Object.freeze({
+        FIXED_OVERHEAD_SIZE: 106, // type (1) + public key (65) + IV (16) + auth tag (16) + data length (8)
+        DATA_LENGTH_SIZE: 8,
+    }),
+    /**
+     * Message encrypts for multiple recipients
+     */
+    MULTIPLE: Object.freeze({
+        FIXED_OVERHEAD_SIZE: expectedMultipleOverhead, // type (1) + IV (16) + auth tag (16), no CRC
+        ENCRYPTED_KEY_SIZE: expectedMultipleEncryptedKeySize, // 129
+        MAX_RECIPIENTS: 65535,
+        RECIPIENT_ID_SIZE: ECIES_MULTIPLE_RECIPIENT_ID_SIZE,
+        RECIPIENT_COUNT_SIZE: 2,
+        DATA_LENGTH_SIZE: 8,
+    }),
+    ENCRYPTION_TYPE: Object.freeze({
+        SIMPLE: 33,
+        SINGLE: 66,
+        MULTIPLE: 99,
+    }),
+});
+exports.Constants = Object.freeze({
+    UINT8_SIZE: exports.UINT8_SIZE,
+    UINT16_SIZE: exports.UINT16_SIZE,
+    UINT16_MAX: exports.UINT16_MAX,
+    UINT32_SIZE: exports.UINT32_SIZE,
+    UINT32_MAX: exports.UINT32_MAX,
+    UINT64_SIZE: exports.UINT64_SIZE,
+    UINT64_MAX: exports.UINT64_MAX,
+    HEX_RADIX: 16,
+    GUID_SIZE: exports.GUID_SIZE,
+    OBJECT_ID_LENGTH: objectIdLength,
+    CHECKSUM: exports.CHECKSUM,
+    ECIES: exports.ECIES,
+    PBKDF2: exports.PBKDF2,
+    PBKDF2_PROFILES: exports.PBKDF2_PROFILES,
+    /**
+     * Number of rounds for bcrypt hashing. Higher values increase security but also consume more CPU resources.
+     */
+    BcryptRounds: 10,
+    /**
+     * Minimum password length
+     */
+    PasswordMinLength: 8,
+    /**
+     * The regular expression for valid passwords.
+     */
+    PasswordRegex: regexes_1.PASSWORD_REGEX,
+    /**
+     * The regular expression for valid mnemonic phrases.
+     * BIP39 - supports 12, 15, 18, 21, or 24 word mnemonics
+     */
+    MnemonicRegex: regexes_1.MNEMONIC_REGEX,
+    /**
+     * Matches a 64-character hexadecimal string (SHA-256).
+     */
+    HmacRegex: /^[a-f0-9]{64}$/,
+});
+const DEFAULT_CONFIGURATION_KEY = Symbol.for('digitaldefiance.ecies.constants.default');
+function isPlainObject(value) {
+    if (value === null) {
+        return false;
+    }
+    if (typeof value !== 'object') {
+        return false;
+    }
+    if (Array.isArray(value)) {
+        return false;
+    }
+    if (value instanceof RegExp || value instanceof Date) {
+        return false;
+    }
+    return Object.getPrototypeOf(value) === Object.prototype;
+}
+function deepClone(input) {
+    if (input === null) {
+        return input;
+    }
+    if (Array.isArray(input)) {
+        return input.map((item) => deepClone(item));
+    }
+    if (input instanceof RegExp) {
+        return new RegExp(input.source, input.flags);
+    }
+    if (input instanceof Date) {
+        return new Date(input.getTime());
+    }
+    if (isPlainObject(input)) {
+        const result = {};
+        for (const [key, value] of Object.entries(input)) {
+            result[key] = deepClone(value);
+        }
+        return result;
+    }
+    return input;
+}
+function applyOverrides(target, overrides) {
+    if (!overrides) {
+        return target;
+    }
+    for (const [key, overrideValue] of Object.entries(overrides)) {
+        const typedKey = key;
+        if (overrideValue === undefined) {
+            continue;
+        }
+        const currentValue = target[typedKey];
+        if (isPlainObject(currentValue) && isPlainObject(overrideValue)) {
+            target[typedKey] = applyOverrides(currentValue, overrideValue);
+        }
+        else {
+            target[typedKey] = deepClone(overrideValue);
+        }
+    }
+    return target;
+}
+function deepFreeze(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (Object.isFrozen(value)) {
+        return value;
+    }
+    Object.freeze(value);
+    for (const property of Object.getOwnPropertyNames(value)) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const nestedValue = value[property];
+        deepFreeze(nestedValue);
+    }
+    return value;
+}
+function computeMultipleEncryptedKeySize(ecies) {
+    return (ecies.PUBLIC_KEY_LENGTH +
+        ecies.IV_SIZE +
+        ecies.AUTH_TAG_SIZE +
+        ecies.SYMMETRIC.KEY_SIZE);
+}
+function validateConstants(config) {
+    const checksum = config.CHECKSUM;
+    const ecies = config.ECIES;
+    if (checksum.SHA3_BUFFER_LENGTH !== checksum.SHA3_DEFAULT_HASH_BITS / 8 ||
+        checksum.SHA3_BUFFER_LENGTH !== checksum.SHA3_DEFAULT_HASH_BITS / 8) {
+        const engine = (0, i18n_setup_1.getEciesI18nEngine)();
+        throw new Error(engine.translate(i18n_setup_1.EciesComponentId, enumerations_1.EciesStringKey.Error_ECIESError_InvalidChecksumConstants));
+    }
+    const expectedEncryptedKeySize = computeMultipleEncryptedKeySize(ecies);
+    if (ecies.MULTIPLE.ENCRYPTED_KEY_SIZE !== expectedEncryptedKeySize) {
+        throw new ecies_1.ECIESError(enumerations_1.ECIESErrorTypeEnum.InvalidECIESMultipleEncryptedKeySize, (0, i18n_setup_1.getEciesI18nEngine)());
+    }
+    if (ecies.PUBLIC_KEY_LENGTH !== ecies.RAW_PUBLIC_KEY_LENGTH + 1) {
+        throw new ecies_1.ECIESError(enumerations_1.ECIESErrorTypeEnum.InvalidECIESPublicKeyLength, (0, i18n_setup_1.getEciesI18nEngine)());
+    }
+    if (ecies.MULTIPLE.RECIPIENT_COUNT_SIZE !== exports.UINT16_SIZE) {
+        throw new ecies_1.ECIESError(enumerations_1.ECIESErrorTypeEnum.InvalidECIESMultipleRecipientCountSize, (0, i18n_setup_1.getEciesI18nEngine)());
+    }
+    if (ecies.MULTIPLE.DATA_LENGTH_SIZE !== exports.UINT64_SIZE) {
+        throw new ecies_1.ECIESError(enumerations_1.ECIESErrorTypeEnum.InvalidECIESMultipleDataLengthSize, (0, i18n_setup_1.getEciesI18nEngine)());
+    }
+    if (ecies.MULTIPLE.RECIPIENT_ID_SIZE !== exports.GUID_SIZE) {
+        throw new ecies_1.ECIESError(enumerations_1.ECIESErrorTypeEnum.InvalidECIESMultipleRecipientIdSize, (0, i18n_setup_1.getEciesI18nEngine)());
+    }
+}
+validateConstants(exports.Constants);
+const configurationRegistry = new Map();
+configurationRegistry.set(DEFAULT_CONFIGURATION_KEY, exports.Constants);
+function isFullConstantsConfig(value) {
+    if (!isPlainObject(value)) {
+        return false;
+    }
+    const candidate = value;
+    return (candidate.CHECKSUM !== undefined &&
+        candidate.ECIES !== undefined &&
+        candidate.PBKDF2 !== undefined &&
+        candidate.PBKDF2_PROFILES !== undefined);
+}
+function createRuntimeConfiguration(overrides, base = exports.Constants) {
+    const merged = deepClone(base);
+    applyOverrides(merged, overrides);
+    validateConstants(merged);
+    return deepFreeze(merged);
+}
+class ConstantsRegistry {
+    static DEFAULT_KEY = DEFAULT_CONFIGURATION_KEY;
+    static listKeys() {
+        return Array.from(configurationRegistry.keys());
+    }
+    static has(key) {
+        return configurationRegistry.has(key);
+    }
+    static get(key = DEFAULT_CONFIGURATION_KEY) {
+        return (configurationRegistry.get(key) ??
+            configurationRegistry.get(DEFAULT_CONFIGURATION_KEY));
+    }
+    static create(overrides, baseKey = DEFAULT_CONFIGURATION_KEY) {
+        const baseConfig = ConstantsRegistry.get(baseKey);
+        return createRuntimeConfiguration(overrides, baseConfig);
+    }
+    static register(key, configOrOverrides, options) {
+        if (key === DEFAULT_CONFIGURATION_KEY) {
+            const engine = (0, i18n_setup_1.getEciesI18nEngine)();
+            throw new Error(engine.translate(i18n_setup_1.EciesComponentId, enumerations_1.EciesStringKey.Error_ECIESError_CannotOverwriteDefaultConfiguration));
+        }
+        const baseKey = options?.baseKey ?? DEFAULT_CONFIGURATION_KEY;
+        const baseConfig = ConstantsRegistry.get(baseKey);
+        const configuration = isFullConstantsConfig(configOrOverrides)
+            ? createRuntimeConfiguration(undefined, configOrOverrides)
+            : createRuntimeConfiguration(configOrOverrides, baseConfig);
+        configurationRegistry.set(key, configuration);
+        return configuration;
+    }
+    static unregister(key) {
+        if (key === DEFAULT_CONFIGURATION_KEY) {
+            return false;
+        }
+        return configurationRegistry.delete(key);
+    }
+    static clear() {
+        configurationRegistry.clear();
+        configurationRegistry.set(DEFAULT_CONFIGURATION_KEY, exports.Constants);
+    }
+}
+exports.ConstantsRegistry = ConstantsRegistry;
+function getRuntimeConfiguration(key = DEFAULT_CONFIGURATION_KEY) {
+    return ConstantsRegistry.get(key);
+}
+function registerRuntimeConfiguration(key, configOrOverrides, options) {
+    return ConstantsRegistry.register(key, configOrOverrides, options);
+}
+function unregisterRuntimeConfiguration(key) {
+    return ConstantsRegistry.unregister(key);
+}
+function clearRuntimeConfigurations() {
+    ConstantsRegistry.clear();
+}
+var regexes_2 = require("./regexes");
+Object.defineProperty(exports, "PASSWORD_REGEX", { enumerable: true, get: function () { return regexes_2.PASSWORD_REGEX; } });
+Object.defineProperty(exports, "MNEMONIC_REGEX", { enumerable: true, get: function () { return regexes_2.MNEMONIC_REGEX; } });
+//# sourceMappingURL=constants.js.map

package/src/constants.js.map

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

package/src/email-string.d.ts

@@ -0,0 +1,42 @@
+/**
+ * EmailString represents a validated email address.
+ * It ensures that the email is not empty, does not have leading or trailing spaces,
+ * and is a valid email format.
+ */
+export declare class EmailString {
+    readonly email: string;
+    /**
+     * Creates an instance of EmailString.
+     * @param email - The email address to validate and store.
+     * @throws Will throw an error if the email is invalid.
+     */
+    constructor(email: string);
+    /**
+     * Returns the email address as a string.
+     * @returns The email address.
+     */
+    toString(): string;
+    /**
+     * Checks if this email address is equal to another email address.
+     * @param other - The other email address to compare.
+     * @returns True if the email addresses are equal, false otherwise.
+     */
+    equals(other: EmailString): boolean;
+    /**
+     * Converts the email address to a JSON string.
+     * @returns The email address as a JSON string.
+     */
+    toJson(): string;
+    /**
+     * Creates an EmailString instance from a JSON string.
+     * @param email - The JSON string representing the email address.
+     * @returns The EmailString instance.
+     */
+    static fromJson(email: string): EmailString;
+    /**
+     * Gets the length of the email address.
+     * @returns The length of the email address.
+     */
+    get length(): number;
+}
+//# sourceMappingURL=email-string.d.ts.map

package/src/email-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-string.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/email-string.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,qBAAa,WAAW;IACtB,SAAgB,KAAK,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;gBACS,KAAK,EAAE,MAAM;IAuBzB;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;;OAIG;IACI,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAI1C;;;OAGG;IACI,MAAM,IAAI,MAAM;IAIvB;;;;OAIG;WACW,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAIlD;;;OAGG;IACH,IAAW,MAAM,IAAI,MAAM,CAE1B;CACF"}

package/src/email-string.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailString = void 0;
+const tslib_1 = require("tslib");
+const validator_1 = tslib_1.__importDefault(require("validator"));
+const invalid_email_type_1 = require("./enumerations/invalid-email-type");
+const invalid_email_1 = require("./errors/invalid-email");
+const i18n_setup_1 = require("./i18n-setup");
+/**
+ * EmailString represents a validated email address.
+ * It ensures that the email is not empty, does not have leading or trailing spaces,
+ * and is a valid email format.
+ */
+class EmailString {
+    email;
+    /**
+     * Creates an instance of EmailString.
+     * @param email - The email address to validate and store.
+     * @throws Will throw an error if the email is invalid.
+     */
+    constructor(email) {
+        const trimmedEmail = email.trim();
+        if (trimmedEmail.length == 0) {
+            throw new invalid_email_1.InvalidEmailError(invalid_email_type_1.InvalidEmailErrorType.Missing, (0, i18n_setup_1.getEciesI18nEngine)());
+        }
+        if (trimmedEmail.length != email.length) {
+            throw new invalid_email_1.InvalidEmailError(invalid_email_type_1.InvalidEmailErrorType.Whitespace, (0, i18n_setup_1.getEciesI18nEngine)());
+        }
+        if (!validator_1.default.isEmail(trimmedEmail)) {
+            throw new invalid_email_1.InvalidEmailError(invalid_email_type_1.InvalidEmailErrorType.Invalid, (0, i18n_setup_1.getEciesI18nEngine)());
+        }
+        this.email = trimmedEmail;
+    }
+    /**
+     * Returns the email address as a string.
+     * @returns The email address.
+     */
+    toString() {
+        return this.email;
+    }
+    /**
+     * Checks if this email address is equal to another email address.
+     * @param other - The other email address to compare.
+     * @returns True if the email addresses are equal, false otherwise.
+     */
+    equals(other) {
+        return this.email === other.email;
+    }
+    /**
+     * Converts the email address to a JSON string.
+     * @returns The email address as a JSON string.
+     */
+    toJson() {
+        return JSON.stringify(this.email);
+    }
+    /**
+     * Creates an EmailString instance from a JSON string.
+     * @param email - The JSON string representing the email address.
+     * @returns The EmailString instance.
+     */
+    static fromJson(email) {
+        return new EmailString(JSON.parse(email));
+    }
+    /**
+     * Gets the length of the email address.
+     * @returns The length of the email address.
+     */
+    get length() {
+        return this.email.length;
+    }
+}
+exports.EmailString = EmailString;
+//# sourceMappingURL=email-string.js.map

package/src/email-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-string.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/email-string.ts"],"names":[],"mappings":";;;;AAAA,kEAAkC;AAClC,0EAA0E;AAC1E,0DAA2D;AAC3D,6CAAkD;AAElD;;;;GAIG;AACH,MAAa,WAAW;IACN,KAAK,CAAS;IAE9B;;;;OAIG;IACH,YAAY,KAAa;QACvB,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,iCAAiB,CACzB,0CAAqB,CAAC,OAAO,EAC7B,IAAA,+BAAkB,GAAS,CAC5B,CAAC;QACJ,CAAC;QACD,IAAI,YAAY,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACxC,MAAM,IAAI,iCAAiB,CACzB,0CAAqB,CAAC,UAAU,EAChC,IAAA,+BAAkB,GAAS,CAC5B,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,mBAAS,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,iCAAiB,CACzB,0CAAqB,CAAC,OAAO,EAC7B,IAAA,+BAAkB,GAAS,CAC5B,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACI,QAAQ;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,KAAkB;QAC9B,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC;IACpC,CAAC;IAED;;;OAGG;IACI,MAAM;QACX,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,QAAQ,CAAC,KAAa;QAClC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;CACF;AAxED,kCAwEC"}

package/src/enumerations/ecies-encryption-type.d.ts

@@ -0,0 +1,15 @@
+export type EciesEncryptionType = 'simple' | 'single' | 'multiple';
+export declare enum EciesEncryptionTypeEnum {
+    Simple = 33,
+    Single = 66,
+    Multiple = 99
+}
+export declare const EciesEncryptionTypeMap: Record<EciesEncryptionType, EciesEncryptionTypeEnum>;
+export declare const EciesEncryptionTypeStringMap: Record<EciesEncryptionType, string>;
+export declare const EciesEncryptionTypeEnumTypeMap: Record<EciesEncryptionTypeEnum, EciesEncryptionType>;
+export declare const EciesEncryptionTypeEnumStringMap: Record<EciesEncryptionTypeEnum, string>;
+export declare function encryptionTypeToString(type: EciesEncryptionType | EciesEncryptionTypeEnum): string;
+export declare function encryptionTypeEnumToType(type: EciesEncryptionTypeEnum): EciesEncryptionType;
+export declare function validateEciesEncryptionTypeEnum(type: EciesEncryptionTypeEnum): boolean;
+export declare function ensureEciesEncryptionTypeEnum(type: EciesEncryptionTypeEnum): EciesEncryptionTypeEnum;
+//# sourceMappingURL=ecies-encryption-type.d.ts.map

package/src/enumerations/ecies-encryption-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecies-encryption-type.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/enumerations/ecies-encryption-type.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnE,oBAAY,uBAAuB;IACjC,MAAM,KAAK;IACX,MAAM,KAAK;IACX,QAAQ,KAAK;CACd;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,mBAAmB,EACnB,uBAAuB,CAKxB,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAK1E,CAAC;AAEJ,eAAO,MAAM,8BAA8B,EAAE,MAAM,CACjD,uBAAuB,EACvB,mBAAmB,CAKpB,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,MAAM,CACnD,uBAAuB,EACvB,MAAM,CAKP,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,mBAAmB,GAAG,uBAAuB,GAClD,MAAM,CAsBR;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,uBAAuB,GAC5B,mBAAmB,CASrB;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAET;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,uBAAuB,GAC5B,uBAAuB,CAQzB"}