@digitaldefiance/ecies-lib 4.12.8 → 4.13.0

package/README.md

@@ -8,7 +8,7 @@ Production-ready, browser-compatible ECIES (Elliptic Curve Integrated Encryption
 
 Part of [Express Suite](https://github.com/Digital-Defiance/express-suite)
 
-**Current Version: v4.10.7**
+**Current Version: v4.13.0**
 
 This library implements a modern, enterprise-grade ECIES protocol (v4.0) featuring HKDF key derivation, AAD binding, and optimized multi-recipient encryption. It includes a pluggable ID provider system with PlatformID support, memory-efficient streaming encryption, comprehensive internationalization, and a complete cryptographic voting system with 15+ voting methods.
 
@@ -26,8 +26,8 @@ This library implements a modern, enterprise-grade ECIES protocol (v4.0) featuri
   - **Symmetric**: `AES-256-GCM` for authenticated symmetric encryption.
   - **Hashing**: `SHA-256` and `SHA-512`.
 - **Modes**:
-  - **Simple**: Minimal overhead (no length prefix).
-  - **Single**: Includes data length prefix.
+  - **Basic**: Minimal overhead (no length prefix).
+  - **WithLength**: Includes data length prefix.
   - **Multiple**: Efficient encryption for up to 65,535 recipients.
 
 ### 🗳️ Cryptographic Voting System
@@ -226,8 +226,8 @@ const { privateKey, publicKey } = ecies.mnemonicToSimpleKeyPair(mnemonic);
 
 // 5. Encrypt & Decrypt
 const message = new TextEncoder().encode('Hello, Secure World!');
-const encrypted = await ecies.encryptSimpleOrSingle(false, publicKey, message);
-const decrypted = await ecies.decryptSimpleOrSingleWithHeader(false, privateKey, encrypted);
+const encrypted = await ecies.encryptWithLength(publicKey, message);
+const decrypted = await ecies.decryptWithLengthAndHeader(privateKey, encrypted);
 
 console.log(new TextDecoder().decode(decrypted)); // "Hello, Secure World!"
 
@@ -1277,6 +1277,55 @@ The library maintains **100% test coverage** with over 1,200 tests, including:
 
 ## ChangeLog
 
+### v4.13.0 - API Naming Improvements & Configuration Enhancements
+
+**Breaking Changes:**
+
+- **Encryption Mode Renaming**: 
+  - `SIMPLE` → `BASIC` (constant)
+  - `SINGLE` → `WITH_LENGTH` (constant)
+  - `encryptSimpleOrSingle(isSimple, ...)` → `encryptBasic(...)` / `encryptWithLength(...)`
+  - `decryptSimpleOrSingleWithHeader(isSimple, ...)` → `decryptBasicWithHeader(...)` / `decryptWithLengthAndHeader(...)`
+  
+- **Removed Constants**:
+  - `OBJECT_ID_LENGTH` removed - use `idProvider.byteLength` instead
+  
+- **Guid Class Renamed**:
+  - `Guid` → `GuidUint8Array` (browser implementation)
+  - Added `VersionedGuidUint8Array<V>` type for compile-time version tracking
+  - Methods like `generate()`, `parse()`, `hydrate()` now return `VersionedGuidUint8Array`
+
+**New Features:**
+
+- **ECIES_CONFIG**: New configuration interface and constant for ECIES parameters
+  - `curveName`, `primaryKeyDerivationPath`, `mnemonicStrength`, `symmetricAlgorithm`, etc.
+  
+- **TranslatableEciesError**: New error class with automatic i18n translation
+  ```typescript
+  throw new TranslatableEciesError('INVALID_KEY', { keyLength: 32 });
+  ```
+
+- **Enhanced Type System for GUIDs**:
+  - `VersionedGuidUint8Array<4>` for v4 UUIDs with compile-time version info
+  - `__version` property attached to parsed/generated GUIDs
+
+**Migration Guide:**
+```typescript
+// BEFORE (v4.12.x)
+const encrypted = await ecies.encryptSimpleOrSingle(false, publicKey, data);  // "single" mode
+const decrypted = await ecies.decryptSimpleOrSingleWithHeader(false, privateKey, encrypted);
+
+const encrypted2 = await ecies.encryptSimpleOrSingle(true, publicKey, data);  // "simple" mode
+const decrypted2 = await ecies.decryptSimpleOrSingleWithHeader(true, privateKey, encrypted2);
+
+// AFTER (v4.13.0+)
+const encrypted = await ecies.encryptWithLength(publicKey, data);  // WithLength mode (formerly "single")
+const decrypted = await ecies.decryptWithLengthAndHeader(privateKey, encrypted);
+
+const encrypted2 = await ecies.encryptBasic(publicKey, data);  // Basic mode (formerly "simple")
+const decrypted2 = await ecies.decryptBasicWithHeader(privateKey, encrypted2);
+```
+
 ### v4.12.0 - AESGCMService Refactoring & JSON Encryption
 
 **Breaking Changes:**
@@ -1972,8 +2021,8 @@ describe('ECIES Encryption', () => {
     const { privateKey, publicKey } = ecies.mnemonicToSimpleKeyPair(mnemonic);
     
     const message = new TextEncoder().encode('Secret Message');
-    const encrypted = await ecies.encryptSimpleOrSingle(false, publicKey, message);
-    const decrypted = await ecies.decryptSimpleOrSingleWithHeader(false, privateKey, encrypted);
+    const encrypted = await ecies.encryptWithLength(publicKey, message);
+    const decrypted = await ecies.decryptWithLengthAndHeader(privateKey, encrypted);
     
     expect(new TextDecoder().decode(decrypted)).toBe('Secret Message');
   });
@@ -2122,8 +2171,8 @@ describe('Cryptographic Properties', () => {
       fc.asyncProperty(
         fc.uint8Array({ minLength: 1, maxLength: 1000 }),
         async (message) => {
-          const encrypted = await ecies.encryptSimpleOrSingle(false, publicKey, message);
-          const decrypted = await ecies.decryptSimpleOrSingleWithHeader(false, privateKey, encrypted);
+          const encrypted = await ecies.encryptWithLength(publicKey, message);
+          const decrypted = await ecies.decryptWithLengthAndHeader(privateKey, encrypted);
           
           expect(decrypted).toEqual(message);
         }
@@ -2137,7 +2186,7 @@ describe('Cryptographic Properties', () => {
 ### Testing Best Practices
 
 1. **Initialize i18n** before running tests with `getEciesI18nEngine()`
-2. **Test all encryption modes** (Simple, Single, Multiple)
+2. **Test all encryption modes** (Basic, WithLength, Multiple)
 3. **Test with different ID providers** to ensure compatibility
 4. **Use property-based tests** for cryptographic invariants
 5. **Test error conditions** like invalid keys, corrupted data, and wrong recipients
@@ -2162,8 +2211,7 @@ describe('Cross-Platform Compatibility', () => {
     const nodeEncrypted = Buffer.from('...'); // From node-ecies-lib
     
     const browserEcies = new BrowserECIES();
-    const decrypted = await browserEcies.decryptSimpleOrSingleWithHeader(
-      false,
+    const decrypted = await browserEcies.decryptWithLengthAndHeader(
       privateKey,
       new Uint8Array(nodeEncrypted)
     );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/ecies-lib",
-  "version": "4.12.8",
+  "version": "4.13.0",
   "description": "Digital Defiance ECIES Library",
   "homepage": "https://github.com/Digital-Defiance/ecies-lib",
   "repository": {
@@ -80,8 +80,8 @@
     "@digitaldefiance/express-suite-test-utils": "1.0.12",
     "@swc/core": "^1.15.3",
     "@swc/jest": "^0.2.39",
-    "@typescript-eslint/eslint-plugin": "^8.52.0",
-    "@typescript-eslint/parser": "^8.52.0",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-prettier": "^5.5.4",
     "fast-check": "^4.3.0",

package/src/builders/ecies-builder.d.ts

@@ -1,5 +1,5 @@
 /**
- * Fluent builder for ECIESService
+ * Fluent builder for ECIESService.
  */
 import { PluginI18nEngine } from '@digitaldefiance/i18n-lib';
 import { IECIESConfig } from '../interfaces/ecies-config';
@@ -9,10 +9,33 @@ export declare class ECIESBuilder {
     private serviceConfig;
     private eciesConsts;
     private _i18n?;
+    /**
+     * Creates a new ECIESBuilder instance.
+     * @returns A new builder instance
+     */
     static create(): ECIESBuilder;
+    /**
+     * Sets the service configuration.
+     * @param config Partial service configuration
+     * @returns This builder for chaining
+     */
     withServiceConfig(config: Partial<IECIESConfig>): this;
+    /**
+     * Sets the ECIES constants.
+     * @param constants Partial ECIES constants
+     * @returns This builder for chaining
+     */
     withConstants(constants: Partial<IECIESConstants>): this;
+    /**
+     * Sets the i18n engine.
+     * @param engine The i18n engine instance
+     * @returns This builder for chaining
+     */
     withI18n(engine: PluginI18nEngine<string>): this;
+    /**
+     * Builds and returns the configured ECIESService instance.
+     * @returns A new ECIESService instance
+     */
     build(): ECIESService;
 }
 //# sourceMappingURL=ecies-builder.d.ts.map

package/src/builders/ecies-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ecies-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/builders/ecies-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,KAAK,CAAC,CAA2B;IAEzC,MAAM,CAAC,MAAM,IAAI,YAAY;IAI7B,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAKtD,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAKxD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,IAAI;IAKhD,KAAK,IAAI,YAAY;CAItB"}
+{"version":3,"file":"ecies-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/builders/ecies-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,KAAK,CAAC,CAA2B;IAEzC;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,YAAY;IAI7B;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAKtD;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAKxD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,IAAI;IAKhD;;;OAGG;IACH,KAAK,IAAI,YAAY;CAItB"}

package/src/builders/ecies-builder.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Fluent builder for ECIESService
+ * Fluent builder for ECIESService.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ECIESBuilder = void 0;
@@ -10,21 +10,44 @@ class ECIESBuilder {
     serviceConfig = {};
     eciesConsts = {};
     _i18n;
+    /**
+     * Creates a new ECIESBuilder instance.
+     * @returns A new builder instance
+     */
     static create() {
         return new ECIESBuilder();
     }
+    /**
+     * Sets the service configuration.
+     * @param config Partial service configuration
+     * @returns This builder for chaining
+     */
     withServiceConfig(config) {
         this.serviceConfig = { ...this.serviceConfig, ...config };
         return this;
     }
+    /**
+     * Sets the ECIES constants.
+     * @param constants Partial ECIES constants
+     * @returns This builder for chaining
+     */
     withConstants(constants) {
         this.eciesConsts = { ...this.eciesConsts, ...constants };
         return this;
     }
+    /**
+     * Sets the i18n engine.
+     * @param engine The i18n engine instance
+     * @returns This builder for chaining
+     */
     withI18n(engine) {
         this._i18n = engine;
         return this;
     }
+    /**
+     * Builds and returns the configured ECIESService instance.
+     * @returns A new ECIESService instance
+     */
     build() {
         const finalConstants = { ...constants_1.Constants.ECIES, ...this.eciesConsts };
         return new service_1.ECIESService(this.serviceConfig, finalConstants);

package/src/builders/ecies-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"ecies-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/builders/ecies-builder.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,4CAAyC;AAGzC,uDAAyD;AAEzD,MAAa,YAAY;IACf,aAAa,GAA0B,EAAE,CAAC;IAC1C,WAAW,GAA6B,EAAE,CAAC;IAC3C,KAAK,CAA4B;IAEzC,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,YAAY,EAAE,CAAC;IAC5B,CAAC;IAED,iBAAiB,CAAC,MAA6B;QAC7C,IAAI,CAAC,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,GAAG,MAAM,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,SAAmC;QAC/C,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,SAAS,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,MAAgC;QACvC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,MAAM,cAAc,GAAG,EAAE,GAAG,qBAAS,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACnE,OAAO,IAAI,sBAAY,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAC9D,CAAC;CACF;AA5BD,oCA4BC"}
+{"version":3,"file":"ecies-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/builders/ecies-builder.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,4CAAyC;AAGzC,uDAAyD;AAEzD,MAAa,YAAY;IACf,aAAa,GAA0B,EAAE,CAAC;IAC1C,WAAW,GAA6B,EAAE,CAAC;IAC3C,KAAK,CAA4B;IAEzC;;;OAGG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,YAAY,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,MAA6B;QAC7C,IAAI,CAAC,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,GAAG,MAAM,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,SAAmC;QAC/C,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,SAAS,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,MAAgC;QACvC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,MAAM,cAAc,GAAG,EAAE,GAAG,qBAAS,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACnE,OAAO,IAAI,sBAAY,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAC9D,CAAC;CACF;AAnDD,oCAmDC"}

package/src/builders/member-builder.d.ts

@@ -1,5 +1,17 @@
 /**
- * Fluent builder for Member
+ * Fluent builder for Member instances.
+ * Provides a convenient way to configure and create Member instances with all required properties.
+ *
+ * @example
+ * ```typescript
+ * const { member, mnemonic } = MemberBuilder.create()
+ *   .withEciesService(service)
+ *   .withType(MemberType.User)
+ *   .withName('Alice')
+ *   .withEmail('alice@example.com')
+ *   .generateMnemonic()
+ *   .build();
+ * ```
  */
 import { EmailString } from '../email-string';
 import { MemberType } from '../enumerations/member-type';
@@ -14,14 +26,58 @@ export declare class MemberBuilder {
     private email?;
     private mnemonic?;
     private createdBy?;
+    /**
+     * Creates a new MemberBuilder instance.
+     * @returns A new builder instance
+     */
     static create(): MemberBuilder;
+    /**
+     * Sets the ECIES service to use.
+     * @param service The ECIES service instance
+     * @returns This builder for chaining
+     */
     withEciesService(service: ECIESService): this;
+    /**
+     * Sets the member type.
+     * @param type The member type (Admin, System, User, Anonymous)
+     * @returns This builder for chaining
+     */
     withType(type: MemberType): this;
+    /**
+     * Sets the member name.
+     * @param name The member's display name
+     * @returns This builder for chaining
+     */
     withName(name: string): this;
+    /**
+     * Sets the member email.
+     * @param email The member's email address (string or EmailString)
+     * @returns This builder for chaining
+     */
     withEmail(email: string | EmailString): this;
+    /**
+     * Sets a specific mnemonic to use.
+     * @param mnemonic The BIP39 mnemonic phrase
+     * @returns This builder for chaining
+     */
     withMnemonic(mnemonic: SecureString): this;
+    /**
+     * Sets the creator ID.
+     * @param creatorId The ID of the member who created this member
+     * @returns This builder for chaining
+     */
     withCreatedBy(creatorId: Uint8Array): this;
+    /**
+     * Generates a new random mnemonic.
+     * @returns This builder for chaining
+     * @throws {Error} If ECIES service is not set
+     */
     generateMnemonic(): this;
+    /**
+     * Builds and returns the configured Member instance with its mnemonic.
+     * @returns Object containing the member and mnemonic
+     * @throws {Error} If required fields are missing
+     */
     build(): IMemberWithMnemonic;
     /**
      * Convenience factory method to create a new member with default ECIESService

package/src/builders/member-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"member-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/builders/member-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,IAAI,CAAC,CAAa;IAC1B,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAe;IAChC,OAAO,CAAC,SAAS,CAAC,CAAa;IAE/B,MAAM,CAAC,MAAM,IAAI,aAAa;IAI9B,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAK7C,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAKhC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK5B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAK5C,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAK1C,aAAa,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;IAK1C,gBAAgB,IAAI,IAAI;IAcxB,KAAK,IAAI,mBAAmB;IA6B5B;;;;;;;;OAQG;IACH,MAAM,CAAC,SAAS,CACd,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,GAAG,MAAM,EAC3B,aAAa,CAAC,EAAE,YAAY,EAC5B,SAAS,CAAC,EAAE,UAAU,GACrB,mBAAmB;IActB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU,EACjD,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,GAAG,CAAC;IAKd;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU,EACrD,QAAQ,EAAE,YAAY,EACtB,IAAI,SAAc,EAClB,KAAK,GAAE,WAAW,GAAG,MAA2B,GAC/C,MAAM,CAAC,GAAG,CAAC;CAYf"}
+{"version":3,"file":"member-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/builders/member-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,IAAI,CAAC,CAAa;IAC1B,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAe;IAChC,OAAO,CAAC,SAAS,CAAC,CAAa;IAE/B;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,aAAa;IAI9B;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAK7C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAKhC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK5B;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAK5C;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAK1C;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;IAK1C;;;;OAIG;IACH,gBAAgB,IAAI,IAAI;IAcxB;;;;OAIG;IACH,KAAK,IAAI,mBAAmB;IA6B5B;;;;;;;;OAQG;IACH,MAAM,CAAC,SAAS,CACd,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,GAAG,MAAM,EAC3B,aAAa,CAAC,EAAE,YAAY,EAC5B,SAAS,CAAC,EAAE,UAAU,GACrB,mBAAmB;IActB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU,EACjD,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,GAAG,CAAC;IAKd;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU,EACrD,QAAQ,EAAE,YAAY,EACtB,IAAI,SAAc,EAClB,KAAK,GAAE,WAAW,GAAG,MAA2B,GAC/C,MAAM,CAAC,GAAG,CAAC;CAYf"}

package/src/builders/member-builder.js

@@ -1,6 +1,18 @@
 "use strict";
 /**
- * Fluent builder for Member
+ * Fluent builder for Member instances.
+ * Provides a convenient way to configure and create Member instances with all required properties.
+ *
+ * @example
+ * ```typescript
+ * const { member, mnemonic } = MemberBuilder.create()
+ *   .withEciesService(service)
+ *   .withType(MemberType.User)
+ *   .withName('Alice')
+ *   .withEmail('alice@example.com')
+ *   .generateMnemonic()
+ *   .build();
+ * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemberBuilder = void 0;
@@ -16,33 +28,72 @@ class MemberBuilder {
     email;
     mnemonic;
     createdBy; // ID of the creator
+    /**
+     * Creates a new MemberBuilder instance.
+     * @returns A new builder instance
+     */
     static create() {
         return new MemberBuilder();
     }
+    /**
+     * Sets the ECIES service to use.
+     * @param service The ECIES service instance
+     * @returns This builder for chaining
+     */
     withEciesService(service) {
         this.eciesService = service;
         return this;
     }
+    /**
+     * Sets the member type.
+     * @param type The member type (Admin, System, User, Anonymous)
+     * @returns This builder for chaining
+     */
     withType(type) {
         this.type = type;
         return this;
     }
+    /**
+     * Sets the member name.
+     * @param name The member's display name
+     * @returns This builder for chaining
+     */
     withName(name) {
         this.name = name;
         return this;
     }
+    /**
+     * Sets the member email.
+     * @param email The member's email address (string or EmailString)
+     * @returns This builder for chaining
+     */
     withEmail(email) {
         this.email = typeof email === 'string' ? new email_string_1.EmailString(email) : email;
         return this;
     }
+    /**
+     * Sets a specific mnemonic to use.
+     * @param mnemonic The BIP39 mnemonic phrase
+     * @returns This builder for chaining
+     */
     withMnemonic(mnemonic) {
         this.mnemonic = mnemonic;
         return this;
     }
+    /**
+     * Sets the creator ID.
+     * @param creatorId The ID of the member who created this member
+     * @returns This builder for chaining
+     */
     withCreatedBy(creatorId) {
         this.createdBy = creatorId;
         return this;
     }
+    /**
+     * Generates a new random mnemonic.
+     * @returns This builder for chaining
+     * @throws {Error} If ECIES service is not set
+     */
     generateMnemonic() {
         if (!this.eciesService) {
             const engine = (0, i18n_setup_1.getEciesI18nEngine)();
@@ -51,6 +102,11 @@ class MemberBuilder {
         this.mnemonic = this.eciesService.generateNewMnemonic();
         return this;
     }
+    /**
+     * Builds and returns the configured Member instance with its mnemonic.
+     * @returns Object containing the member and mnemonic
+     * @throws {Error} If required fields are missing
+     */
     build() {
         const engine = (0, i18n_setup_1.getEciesI18nEngine)();
         if (!this.eciesService) {

package/src/builders/member-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"member-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/builders/member-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"member-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/builders/member-builder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,kDAA8C;AAC9C,kDAAiD;AAEjD,8CAAqE;AAErE,sCAAwD;AAExD,uDAAyD;AAEzD,MAAa,aAAa;IAChB,YAAY,CAAgB;IAC5B,IAAI,CAAc;IAClB,IAAI,CAAU;IACd,KAAK,CAAe;IACpB,QAAQ,CAAgB;IACxB,SAAS,CAAc,CAAC,oBAAoB;IAEpD;;;OAGG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,OAAqB;QACpC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAAgB;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAAY;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,KAA2B;QACnC,IAAI,CAAC,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,0BAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,QAAsB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,SAAqB;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,gBAAgB;QACd,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,IAAA,+BAAkB,GAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,MAAM,CAAC,SAAS,CACd,6BAAgB,EAChB,6BAAc,CAAC,2DAA2D,CAC3E,CACF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,mBAAmB,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,MAAM,MAAM,GAAG,IAAA,+BAAkB,GAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,MAAM,CAAC,SAAS,CACd,6BAAgB,EAChB,6BAAc,CAAC,oCAAoC,CACpD,CACF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,MAAM,CAAC,SAAS,CACd,6BAAgB,EAChB,6BAAc,CAAC,yCAAyC,CACzD,CACF,CAAC;QACJ,CAAC;QAED,OAAO,eAAM,CAAC,SAAS,CACrB,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,CACf,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,SAAS,CACd,IAAgB,EAChB,IAAY,EACZ,KAA2B,EAC3B,aAA4B,EAC5B,SAAsB;QAEtB,MAAM,OAAO,GAAG,IAAI,sBAAY,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,0BAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAE5E,OAAO,eAAM,CAAC,SAAS,CACrB,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,aAAa,EACb,SAAS,CACV,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CACb,IAAY;QAEZ,MAAM,OAAO,GAAG,IAAI,sBAAY,EAAE,CAAC;QACnC,OAAO,eAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAgB,CAAC;IACvD,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CACjB,QAAsB,EACtB,IAAI,GAAG,WAAW,EAClB,QAA8B,kBAAkB;QAEhD,MAAM,OAAO,GAAG,IAAI,sBAAY,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,0BAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAE5E,OAAO,eAAM,CAAC,YAAY,CACxB,QAAQ,EACR,OAAO,EACP,SAAS,EACT,IAAI,EACJ,QAAQ,CACM,CAAC;IACnB,CAAC;CACF;AAjMD,sCAiMC"}

package/src/constants.d.ts

@@ -1,28 +1,39 @@
 import type { IChecksumConsts } from './interfaces/checksum-consts';
 import type { IConfigurationProvenance } from './interfaces/configuration-provenance';
 import type { IConstants } from './interfaces/constants';
+import type { IECIESConfig } from './interfaces/ecies-config';
 import type { IECIESConstants } from './interfaces/ecies-consts';
 import type { IPBkdf2Consts } from './interfaces/pbkdf2-consts';
 import type { IVotingConsts } from './lib/voting/interfaces/voting-consts';
 import type { Pbkdf2Profiles } from './pbkdf2-profiles';
 import type { DeepPartial } from './types/deep-partial';
 /**
- * Calculates a checksum for a configuration object.
- * Uses SHA-256 of JSON representation.
+ * Calculates a SHA-256 checksum for a configuration object.
+ * Creates a stable JSON representation with BigInt support.
+ * @param config The configuration object to checksum
+ * @returns Hexadecimal string representation of the SHA-256 hash
  */
 declare function calculateConfigChecksum(config: IConstants): string;
 /**
- * Captures a stack trace for provenance tracking
+ * Captures a stack trace for provenance tracking.
+ * Used to track where configuration objects are created.
+ * @returns Stack trace string or 'stack unavailable' if not supported
  */
 declare function captureCreationStack(): string;
+/** Size of an 8-bit unsigned integer in bytes */
 export declare const UINT8_SIZE: number;
+/** Size of a 16-bit unsigned integer in bytes */
 export declare const UINT16_SIZE: number;
+/** Maximum value for a 16-bit unsigned integer */
 export declare const UINT16_MAX: number;
+/** Size of a 32-bit unsigned integer in bytes */
 export declare const UINT32_SIZE: number;
+/** Maximum value for a 32-bit unsigned integer */
 export declare const UINT32_MAX: number;
+/** Size of a 64-bit unsigned integer in bytes */
 export declare const UINT64_SIZE: number;
+/** Maximum value for a 64-bit unsigned integer */
 export declare const UINT64_MAX: bigint;
-export declare const OBJECT_ID_LENGTH: number;
 /**
  * Constants for checksum operations
  * These values are critical for data integrity and MUST NOT be changed
@@ -32,6 +43,7 @@ export declare const CHECKSUM: IChecksumConsts;
 export declare const PBKDF2: IPBkdf2Consts;
 export declare const PBKDF2_PROFILES: Pbkdf2Profiles;
 export declare const ECIES: IECIESConstants;
+export declare const ECIES_CONFIG: IECIESConfig;
 /**
  * Constants for voting operations using Paillier homomorphic encryption.
  * These values are critical for cryptographic operations and MUST match
@@ -40,37 +52,114 @@ export declare const ECIES: IECIESConstants;
 export declare const VOTING: IVotingConsts;
 export declare const Constants: IConstants;
 export type ConfigurationKey = string | symbol;
+/**
+ * Creates a runtime configuration by merging overrides with a base configuration.
+ * Validates the result and freezes it to prevent modification.
+ * @param overrides Partial configuration overrides
+ * @param base Base configuration to extend (defaults to Constants)
+ * @returns Frozen, validated configuration object
+ */
 export declare function createRuntimeConfiguration(overrides?: DeepPartial<IConstants>, base?: IConstants): IConstants;
+/**
+ * Registry for managing multiple named configuration instances.
+ * Provides methods to register, retrieve, and manage configurations with provenance tracking.
+ */
 export declare class ConstantsRegistry {
+    /**
+     * Default configuration key symbol.
+     */
     static readonly DEFAULT_KEY: ConfigurationKey;
+    /**
+     * Lists all registered configuration keys.
+     * @returns Array of configuration keys
+     */
     static listKeys(): ConfigurationKey[];
+    /**
+     * Checks if a configuration key exists in the registry.
+     * @param key The configuration key to check
+     * @returns True if the key exists
+     */
     static has(key: ConfigurationKey): boolean;
+    /**
+     * Retrieves a configuration by key.
+     * @param key The configuration key (defaults to DEFAULT_KEY)
+     * @returns The configuration object
+     */
     static get(key?: ConfigurationKey): IConstants;
     /**
-     * Get provenance information for a configuration
+     * Gets provenance information for a configuration.
+     * @param key The configuration key (defaults to DEFAULT_KEY)
+     * @returns Provenance information or undefined if not found
      */
     static getProvenance(key?: ConfigurationKey): IConfigurationProvenance | undefined;
     /**
-     * List all configurations with their provenance
+     * Lists all configurations with their provenance information.
+     * @returns Array of configuration entries with keys, configs, and provenance
      */
     static listWithProvenance(): Array<{
         key: ConfigurationKey;
         config: IConstants;
         provenance?: IConfigurationProvenance;
     }>;
+    /**
+     * Creates a new configuration from overrides without registering it.
+     * @param overrides Partial configuration overrides
+     * @param baseKey Key of the base configuration to extend
+     * @returns New configuration object
+     */
     static create(overrides?: DeepPartial<IConstants>, baseKey?: ConfigurationKey): IConstants;
-    static register(key: ConfigurationKey, configOrOverrides?: DeepPartial<IConstants> | IConstants, options?: {
+    /**
+     * Registers a new configuration in the registry.
+     * @param key Unique key for the configuration
+     * @param configOrOverrides Full configuration or partial overrides
+     * @param options Registration options (baseKey, description)
+     * @returns The registered configuration
+     * @throws {Error} If attempting to overwrite the default configuration
+     */
+    static register<T extends IConstants = IConstants>(key: ConfigurationKey, configOrOverrides?: DeepPartial<T> | T, options?: {
         baseKey?: ConfigurationKey;
         description?: string;
-    }): IConstants;
+    }): T;
+    /**
+     * Unregisters a configuration from the registry.
+     * @param key The configuration key to remove
+     * @returns True if the configuration was removed, false if it didn't exist or is the default
+     */
     static unregister(key: ConfigurationKey): boolean;
+    /**
+     * Clears all configurations except the default.
+     */
     static clear(): void;
 }
+/**
+ * Retrieves a runtime configuration by key.
+ * Convenience function that delegates to ConstantsRegistry.get.
+ * @param key The configuration key (defaults to DEFAULT_KEY)
+ * @returns The configuration object
+ */
 export declare function getRuntimeConfiguration(key?: ConfigurationKey): IConstants;
-export declare function registerRuntimeConfiguration(key: ConfigurationKey, configOrOverrides?: DeepPartial<IConstants> | IConstants, options?: {
+/**
+ * Registers a runtime configuration.
+ * Convenience function that delegates to ConstantsRegistry.register.
+ * @param key Unique key for the configuration
+ * @param configOrOverrides Full configuration or partial overrides
+ * @param options Registration options
+ * @returns The registered configuration
+ */
+export declare function registerRuntimeConfiguration<T extends IConstants = IConstants>(key: ConfigurationKey, configOrOverrides?: DeepPartial<T> | T, options?: {
     baseKey?: ConfigurationKey;
-}): IConstants;
+}): T;
+/**
+ * Unregisters a runtime configuration.
+ * Convenience function that delegates to ConstantsRegistry.unregister.
+ * @param key The configuration key to remove
+ * @returns True if the configuration was removed
+ */
 export declare function unregisterRuntimeConfiguration(key: ConfigurationKey): boolean;
+/**
+ * Clears all runtime configurations except the default.
+ * Convenience function that delegates to ConstantsRegistry.clear.
+ */
 export declare function clearRuntimeConfigurations(): void;
 export { MNEMONIC_REGEX, PASSWORD_REGEX } from './regexes';
 export { calculateConfigChecksum, captureCreationStack };

package/src/constants.d.ts.map

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