@digitaldefiance/ecies-lib 4.4.2 → 4.4.3

package/LICENSE

@@ -0,0 +1,21 @@
+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/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@digitaldefiance/ecies-lib",
-  "version": "4.4.2",
+  "version": "4.4.3",
   "description": "Digital Defiance ECIES Library",
+  "homepage": "https://github.com/Digital-Defiance/ecies-lib/blob/main/README.md",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Digital-Defiance/ecies-lib.git"
+  },
   "main": "src/index.js",
   "types": "src/index.d.ts",
   "exports": {
@@ -49,7 +54,7 @@
   "license": "MIT",
   "packageManager": "yarn@4.11.0",
   "dependencies": {
-    "@digitaldefiance/i18n-lib": "3.8.0",
+    "@digitaldefiance/i18n-lib": "3.8.1",
     "@ethereumjs/wallet": "^10.0.0",
     "@noble/curves": "^2.0.1",
     "@noble/hashes": "^2.0.1",
@@ -67,7 +72,5 @@
     "eslint-plugin-prettier": "^5.5.4",
     "fast-check": "^4.3.0",
     "madge": "^8.0.0"
-  },
-  "module": "./../../dist/packages/digitaldefiance-ecies-lib/packages/digitaldefiance-ecies-lib/src/index.js",
-  "type": "module"
-}
+  }
+}

package/src/builders/ecies-builder.ts

@@ -0,0 +1,39 @@
+/**
+ * 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);
+  }
+}

package/src/builders/{index.js → index.ts}

@@ -1,6 +1,6 @@
 /**
  * Builder exports for v2 architecture
  */
+
 export * from './ecies-builder';
 export * from './member-builder';
-//# sourceMappingURL=index.js.map

package/src/builders/member-builder.ts

@@ -0,0 +1,155 @@
+/**
+ * Fluent builder for Member
+ */
+
+import { EmailString } from '../email-string';
+import { EciesStringKey } from '../enumerations';
+import { MemberType } from '../enumerations/member-type';
+import { EciesComponentId, getEciesI18nEngine } from '../i18n-setup';
+import { IMemberWithMnemonic } from '../interfaces/member-with-mnemonic';
+import { Member } from '../member';
+import { SecureString } from '../secure-string';
+import { ECIESService } from '../services/ecies/service';
+
+export class MemberBuilder {
+  private eciesService?: ECIESService;
+  private type?: MemberType;
+  private name?: string;
+  private email?: EmailString;
+  private mnemonic?: SecureString;
+  private createdBy?: Uint8Array; // ID of the creator
+
+  static create(): MemberBuilder {
+    return new MemberBuilder();
+  }
+
+  withEciesService(service: ECIESService): this {
+    this.eciesService = service;
+    return this;
+  }
+
+  withType(type: MemberType): this {
+    this.type = type;
+    return this;
+  }
+
+  withName(name: string): this {
+    this.name = name;
+    return this;
+  }
+
+  withEmail(email: string | EmailString): this {
+    this.email = typeof email === 'string' ? new EmailString(email) : email;
+    return this;
+  }
+
+  withMnemonic(mnemonic: SecureString): this {
+    this.mnemonic = mnemonic;
+    return this;
+  }
+
+  withCreatedBy(creatorId: Uint8Array): this {
+    this.createdBy = creatorId;
+    return this;
+  }
+
+  generateMnemonic(): this {
+    if (!this.eciesService) {
+      const engine = getEciesI18nEngine();
+      throw new Error(
+        engine.translate(
+          EciesComponentId,
+          EciesStringKey.Error_Builder_ECIESServiceMustBeSetBeforeGeneratingMnemonic,
+        ),
+      );
+    }
+    this.mnemonic = this.eciesService.generateNewMnemonic();
+    return this;
+  }
+
+  build(): IMemberWithMnemonic {
+    const engine = getEciesI18nEngine();
+    if (!this.eciesService) {
+      throw new Error(
+        engine.translate(
+          EciesComponentId,
+          EciesStringKey.Error_Builder_ECIESServiceIsRequired,
+        ),
+      );
+    }
+    if (!this.type || !this.name || !this.email) {
+      throw new Error(
+        engine.translate(
+          EciesComponentId,
+          EciesStringKey.Error_Builder_TypeNameAndEmailAreRequired,
+        ),
+      );
+    }
+
+    return Member.newMember(
+      this.eciesService,
+      this.type,
+      this.name,
+      this.email,
+      this.mnemonic,
+      this.createdBy,
+    );
+  }
+
+  /**
+   * Convenience factory method to create a new member with default ECIESService
+   * @param type - The member type
+   * @param name - The member name
+   * @param email - The member email
+   * @param forceMnemonic - Optional mnemonic to use instead of generating a new one
+   * @param createdBy - Optional creator ID
+   * @returns Member with mnemonic
+   */
+  static newMember(
+    type: MemberType,
+    name: string,
+    email: EmailString | string,
+    forceMnemonic?: SecureString,
+    createdBy?: Uint8Array,
+  ): IMemberWithMnemonic {
+    const service = new ECIESService();
+    const emailObj = typeof email === 'string' ? new EmailString(email) : email;
+
+    return Member.newMember(
+      service,
+      type,
+      name,
+      emailObj,
+      forceMnemonic,
+      createdBy,
+    );
+  }
+
+  /**
+   * Convenience factory method to create a member from JSON with default ECIESService
+   * @param json - JSON string representation of member
+   * @returns Member instance
+   */
+  static fromJson(json: string): Member {
+    const service = new ECIESService();
+    return Member.fromJson(json, service);
+  }
+
+  /**
+   * Convenience factory method to create a member from mnemonic with default ECIESService
+   * @param mnemonic - The mnemonic to use
+   * @param name - Optional member name (defaults to 'Test User')
+   * @param email - Optional member email (defaults to 'test@example.com')
+   * @returns Member instance
+   */
+  static fromMnemonic(
+    mnemonic: SecureString,
+    name = 'Test User',
+    email: EmailString | string = 'test@example.com',
+  ): Member {
+    const service = new ECIESService();
+    const emailObj = typeof email === 'string' ? new EmailString(email) : email;
+
+    return Member.fromMnemonic(mnemonic, service, undefined, name, emailObj);
+  }
+}