@digitaldefiance/node-ecies-lib 4.8.1 → 4.10.6

package/src/interfaces/voting-poll.d.ts

@@ -5,6 +5,7 @@
  * These interfaces ensure type safety and API consistency with the browser version.
  */
 import type { PublicKey, PrivateKey, KeyPair } from 'paillier-bigint';
+import type { PlatformID } from './platform-id';
 /**
  * Voting methods supported by the poll system
  */
@@ -29,11 +30,11 @@ export declare enum VotingMethod {
  * Vote receipt proving participation.
  * Cryptographically signed proof that a vote was cast.
  */
-export interface IVoteReceipt {
+export interface IVoteReceipt<TID extends PlatformID = Buffer> {
     /** Unique identifier of the voter */
-    voterId: Buffer;
+    voterId: TID;
     /** Unique identifier of the poll */
-    pollId: Buffer;
+    pollId: TID;
     /** Unix timestamp when vote was cast */
     timestamp: number;
     /** Cryptographic signature from poll authority */
@@ -45,7 +46,7 @@ export interface IVoteReceipt {
  * Encrypted vote data using Paillier homomorphic encryption.
  * Structure varies by voting method.
  */
-export interface IEncryptedVote {
+export interface IEncryptedVote<TID extends PlatformID = Buffer> {
     /** Single choice index (for Plurality, Weighted, etc.) */
     choiceIndex?: number;
     /** Multiple choice indices (for Approval voting) */
@@ -59,15 +60,15 @@ export interface IEncryptedVote {
     /** Array of encrypted vote values (one per choice) */
     encrypted: bigint[];
     /** Plaintext vote data (only for insecure methods) */
-    plaintext?: IPlaintextVote;
+    plaintext?: IPlaintextVote<TID>;
 }
 /**
  * Plaintext vote data for insecure voting methods.
  * WARNING: Only use for Quadratic, Consensus, or ConsentBased methods.
  */
-export interface IPlaintextVote {
+export interface IPlaintextVote<TID extends PlatformID = Buffer> {
     /** Unique identifier of the voter */
-    voterId: Buffer;
+    voterId: TID;
     /** Single choice index */
     choiceIndex?: number;
     /** Multiple choice indices */
@@ -127,9 +128,9 @@ export interface ISupermajorityConfig {
  * Member interface for voting operations.
  * Extends base member with voting-specific capabilities.
  */
-export interface IVotingMember {
+export interface IVotingMember<TID extends PlatformID = Buffer> {
     /** Unique identifier of the member */
-    readonly id: Buffer;
+    readonly id: TID;
     /** ECDSA public key for signing */
     readonly publicKey: Buffer;
     /** Paillier public key for vote encryption (optional) */
@@ -154,9 +155,9 @@ export interface IVotingMember {
  * Poll interface for vote aggregation and management.
  * Holds encrypted votes and issues receipts, but cannot decrypt votes.
  */
-export interface IPoll {
+export interface IPoll<TID extends PlatformID = Buffer> {
     /** Unique identifier of the poll */
-    readonly id: Buffer;
+    readonly id: TID;
     /** Array of choice names */
     readonly choices: ReadonlyArray<string>;
     /** Voting method used */
@@ -176,14 +177,14 @@ export interface IPoll {
      * @returns Vote receipt
      * @throws Error if poll is closed or voter already voted
      */
-    vote(voter: IVotingMember, vote: IEncryptedVote): IVoteReceipt;
+    vote(voter: IVotingMember<TID>, vote: IEncryptedVote<TID>): IVoteReceipt<TID>;
     /**
      * Verify a vote receipt is valid.
      * @param voter - Member who cast the vote
      * @param receipt - Receipt to verify
      * @returns True if receipt is valid
      */
-    verifyReceipt(voter: IVotingMember, receipt: IVoteReceipt): boolean;
+    verifyReceipt(voter: IVotingMember<TID>, receipt: IVoteReceipt<TID>): boolean;
     /**
      * Close the poll to new votes.
      * @throws Error if poll is already closed
@@ -199,21 +200,21 @@ export interface IPoll {
  * Vote encoder interface for encrypting votes.
  * Converts vote choices into encrypted Paillier ciphertexts.
  */
-export interface IVoteEncoder {
+export interface IVoteEncoder<TID extends PlatformID = Buffer> {
     /**
      * Encode a plurality vote (single choice).
      * @param choiceIndex - Index of chosen option
      * @param choiceCount - Total number of choices
      * @returns Encrypted vote
      */
-    encodePlurality(choiceIndex: number, choiceCount: number): IEncryptedVote;
+    encodePlurality(choiceIndex: number, choiceCount: number): IEncryptedVote<TID>;
     /**
      * Encode an approval vote (multiple choices).
      * @param choices - Indices of approved options
      * @param choiceCount - Total number of choices
      * @returns Encrypted vote
      */
-    encodeApproval(choices: number[], choiceCount: number): IEncryptedVote;
+    encodeApproval(choices: number[], choiceCount: number): IEncryptedVote<TID>;
     /**
      * Encode a weighted vote.
      * @param choiceIndex - Index of chosen option
@@ -221,21 +222,21 @@ export interface IVoteEncoder {
      * @param choiceCount - Total number of choices
      * @returns Encrypted vote
      */
-    encodeWeighted(choiceIndex: number, weight: bigint, choiceCount: number): IEncryptedVote;
+    encodeWeighted(choiceIndex: number, weight: bigint, choiceCount: number): IEncryptedVote<TID>;
     /**
      * Encode a Borda count vote (ranked with points).
      * @param rankings - Indices in preference order
      * @param choiceCount - Total number of choices
      * @returns Encrypted vote
      */
-    encodeBorda(rankings: number[], choiceCount: number): IEncryptedVote;
+    encodeBorda(rankings: number[], choiceCount: number): IEncryptedVote<TID>;
     /**
      * Encode a ranked choice vote (for IRV).
      * @param rankings - Indices in preference order
      * @param choiceCount - Total number of choices
      * @returns Encrypted vote
      */
-    encodeRankedChoice(rankings: number[], choiceCount: number): IEncryptedVote;
+    encodeRankedChoice(rankings: number[], choiceCount: number): IEncryptedVote<TID>;
     /**
      * Encode vote based on method.
      * @param method - Voting method
@@ -248,31 +249,31 @@ export interface IVoteEncoder {
         choices?: number[];
         rankings?: number[];
         weight?: bigint;
-    }, choiceCount: number): IEncryptedVote;
+    }, choiceCount: number): IEncryptedVote<TID>;
 }
 /**
  * Poll tallier interface for decrypting and tallying votes.
  * Holds private key and can decrypt results after poll closes.
  */
-export interface IPollTallier {
+export interface IPollTallier<TID extends PlatformID = Buffer> {
     /**
      * Tally votes and determine winner(s).
      * @param poll - Poll to tally
      * @returns Poll results
      * @throws Error if poll is not closed
      */
-    tally(poll: IPoll): IPollResults;
+    tally(poll: IPoll<TID>): IPollResults;
     /**
      * Tally ranked choice votes using IRV algorithm.
      * @param poll - Poll to tally
      * @returns Poll results with elimination rounds
      */
-    tallyRankedChoice(poll: IPoll): IPollResults;
+    tallyRankedChoice(poll: IPoll<TID>): IPollResults;
 }
 /**
  * Poll factory interface for creating polls.
  */
-export interface IPollFactory {
+export interface IPollFactory<TID extends PlatformID = Buffer> {
     /**
      * Create a poll with specified method.
      * @param choices - Array of choice names
@@ -281,23 +282,23 @@ export interface IPollFactory {
      * @param options - Optional configuration
      * @returns New poll
      */
-    create(choices: string[], method: VotingMethod, authority: IVotingMember, options?: {
+    create(choices: string[], method: VotingMethod, authority: IVotingMember<TID>, options?: {
         maxWeight?: bigint;
-    }): IPoll;
+    }): IPoll<TID>;
     /**
      * Create a plurality poll.
      * @param choices - Array of choice names
      * @param authority - Poll authority
      * @returns New poll
      */
-    createPlurality(choices: string[], authority: IVotingMember): IPoll;
+    createPlurality(choices: string[], authority: IVotingMember<TID>): IPoll<TID>;
     /**
      * Create an approval voting poll.
      * @param choices - Array of choice names
      * @param authority - Poll authority
      * @returns New poll
      */
-    createApproval(choices: string[], authority: IVotingMember): IPoll;
+    createApproval(choices: string[], authority: IVotingMember<TID>): IPoll<TID>;
     /**
      * Create a weighted voting poll.
      * @param choices - Array of choice names
@@ -305,21 +306,21 @@ export interface IPollFactory {
      * @param maxWeight - Maximum vote weight
      * @returns New poll
      */
-    createWeighted(choices: string[], authority: IVotingMember, maxWeight: bigint): IPoll;
+    createWeighted(choices: string[], authority: IVotingMember<TID>, maxWeight: bigint): IPoll<TID>;
     /**
      * Create a Borda count poll.
      * @param choices - Array of choice names
      * @param authority - Poll authority
      * @returns New poll
      */
-    createBorda(choices: string[], authority: IVotingMember): IPoll;
+    createBorda(choices: string[], authority: IVotingMember<TID>): IPoll<TID>;
     /**
      * Create a ranked choice poll.
      * @param choices - Array of choice names
      * @param authority - Poll authority
      * @returns New poll
      */
-    createRankedChoice(choices: string[], authority: IVotingMember): IPoll;
+    createRankedChoice(choices: string[], authority: IVotingMember<TID>): IPoll<TID>;
 }
 /**
  * Options for deriving Paillier voting keys from ECDH keys.

package/src/interfaces/voting-poll.d.ts.map

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

package/src/interfaces/voting-poll.js.map

@@ -1 +1 @@
-{"version":3,"file":"voting-poll.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/interfaces/voting-poll.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH;;GAEG;AACH,IAAY,YAqBX;AArBD,WAAY,YAAY;IACtB,uDAAuD;IACvD,uCAAuB,CAAA;IACvB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;IACrB,+BAAe,CAAA;IACf,+BAAe,CAAA;IACf,gCAAgB,CAAA;IAChB,+CAA+B,CAAA;IAC/B,+CAA+B,CAAA;IAE/B,mDAAmD;IACnD,8CAA8B,CAAA;IAC9B,sCAAsB,CAAA;IACtB,6BAAa,CAAA;IACb,2BAAW,CAAA;IAEX,8CAA8C;IAC9C,uCAAuB,CAAA;IACvB,uCAAuB,CAAA;IACvB,8CAA8B,CAAA;AAChC,CAAC,EArBW,YAAY,4BAAZ,YAAY,QAqBvB;AAkWD;;;GAGG;AACH,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,8DAA8D;IAC9D,uDAAsC,CAAA;IACtC,oEAAoE;IACpE,2CAA0B,CAAA;IAC1B,gEAAgE;IAChE,sCAAqB,CAAA;AACvB,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB"}
+{"version":3,"file":"voting-poll.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/interfaces/voting-poll.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAMH;;GAEG;AACH,IAAY,YAqBX;AArBD,WAAY,YAAY;IACtB,uDAAuD;IACvD,uCAAuB,CAAA;IACvB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;IACrB,+BAAe,CAAA;IACf,+BAAe,CAAA;IACf,gCAAgB,CAAA;IAChB,+CAA+B,CAAA;IAC/B,+CAA+B,CAAA;IAE/B,mDAAmD;IACnD,8CAA8B,CAAA;IAC9B,sCAAsB,CAAA;IACtB,6BAAa,CAAA;IACb,2BAAW,CAAA;IAEX,8CAA8C;IAC9C,uCAAuB,CAAA;IACvB,uCAAuB,CAAA;IACvB,8CAA8B,CAAA;AAChC,CAAC,EArBW,YAAY,4BAAZ,YAAY,QAqBvB;AA2WD;;;GAGG;AACH,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,8DAA8D;IAC9D,uDAAsC,CAAA;IACtC,oEAAoE;IACpE,2CAA0B,CAAA;IAC1B,gEAAgE;IAChE,sCAAqB,CAAA;AACvB,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB"}

package/src/lib/id-providers/buffer-provider.d.ts

@@ -0,0 +1,54 @@
+import { BaseIdProvider } from '@digitaldefiance/ecies-lib';
+/**
+ * Buffer ID provider that accepts any fixed byte length.
+ *
+ * Use this when you need a non-standard ID size or custom validation logic with Node.js Buffers.
+ * For standard formats, prefer ObjectIdProvider, GuidV4Provider, or UuidProvider.
+ *
+ * Example:
+ * ```typescript
+ * // 20-byte SHA-1 hash as recipient ID
+ * const provider = new BufferIdProvider(20, 'SHA1Hash');
+ * ```
+ */
+export declare class BufferIdProvider extends BaseIdProvider<Buffer> {
+    readonly byteLength: number;
+    readonly name: string;
+    constructor(byteLength: number, name?: string);
+    /**
+     * Generate a new random ID of the specified byte length.
+     */
+    generate(): Buffer;
+    /**
+     * Validate an ID buffer.
+     * Only checks length - override this method for custom validation.
+     */
+    validate(id: Buffer): boolean;
+    /**
+     * Serialize to hexadecimal string.
+     */
+    serialize(id: Buffer): string;
+    /**
+     * Deserialize a hexadecimal string to buffer.
+     */
+    deserialize(str: string): Buffer;
+    /**
+     * Create a defensive copy of an ID.
+     */
+    clone(id: Buffer): Buffer;
+    /**
+     * Convert Buffer to the provider's native representation.
+     * For BufferIdProvider, the native type is Buffer, so this is a pass-through.
+     */
+    fromBytes(bytes: Buffer): Buffer;
+    /**
+     * Convert the provider's native representation to Buffer.
+     * For BufferIdProvider, the native type is Buffer, so this is a pass-through.
+     */
+    toBytes(id: Buffer): Buffer;
+    /**
+     * Compare two IDs for equality.
+     */
+    equals(a: Buffer, b: Buffer): boolean;
+}
+//# sourceMappingURL=buffer-provider.d.ts.map

package/src/lib/id-providers/buffer-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer-provider.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/id-providers/buffer-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,cAAc,EACf,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,UAAU,EAAE,MAAM,EAAE,IAAI,SAAW;IAgB/C;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI7B;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAK7B;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAsBhC;;OAEG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAIzB;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhC;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAI3B;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;CAGtC"}

package/src/lib/id-providers/buffer-provider.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BufferIdProvider = void 0;
+const crypto_1 = require("crypto");
+const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
+/**
+ * Buffer ID provider that accepts any fixed byte length.
+ *
+ * Use this when you need a non-standard ID size or custom validation logic with Node.js Buffers.
+ * For standard formats, prefer ObjectIdProvider, GuidV4Provider, or UuidProvider.
+ *
+ * Example:
+ * ```typescript
+ * // 20-byte SHA-1 hash as recipient ID
+ * const provider = new BufferIdProvider(20, 'SHA1Hash');
+ * ```
+ */
+class BufferIdProvider extends ecies_lib_1.BaseIdProvider {
+    byteLength;
+    name;
+    constructor(byteLength, name = 'Buffer') {
+        super();
+        if (!Number.isInteger(byteLength) || byteLength < 1 || byteLength > 255) {
+            throw new ecies_lib_1.IdProviderError(ecies_lib_1.IdProviderErrorType.InvalidByteLengthParameter, undefined, undefined, { value: byteLength });
+        }
+        this.byteLength = byteLength;
+        this.name = name;
+    }
+    /**
+     * Generate a new random ID of the specified byte length.
+     */
+    generate() {
+        return (0, crypto_1.randomBytes)(this.byteLength);
+    }
+    /**
+     * Validate an ID buffer.
+     * Only checks length - override this method for custom validation.
+     */
+    validate(id) {
+        return id.length === this.byteLength;
+    }
+    /**
+     * Serialize to hexadecimal string.
+     */
+    serialize(id) {
+        this.validateLength(id, `${this.name}.serialize`);
+        return id.toString('hex');
+    }
+    /**
+     * Deserialize a hexadecimal string to buffer.
+     */
+    deserialize(str) {
+        if (typeof str !== 'string') {
+            throw new ecies_lib_1.IdProviderError(ecies_lib_1.IdProviderErrorType.InputMustBeString);
+        }
+        const expectedLength = this.byteLength * 2;
+        if (str.length !== expectedLength) {
+            throw new ecies_lib_1.IdProviderError(ecies_lib_1.IdProviderErrorType.InvalidStringLength, undefined, undefined, { expected: expectedLength, actual: str.length });
+        }
+        if (!/^[0-9a-fA-F]+$/.test(str)) {
+            throw new ecies_lib_1.IdProviderError(ecies_lib_1.IdProviderErrorType.InvalidCharacters);
+        }
+        return Buffer.from(str, 'hex');
+    }
+    /**
+     * Create a defensive copy of an ID.
+     */
+    clone(id) {
+        return Buffer.from(id);
+    }
+    /**
+     * Convert Buffer to the provider's native representation.
+     * For BufferIdProvider, the native type is Buffer, so this is a pass-through.
+     */
+    fromBytes(bytes) {
+        return bytes;
+    }
+    /**
+     * Convert the provider's native representation to Buffer.
+     * For BufferIdProvider, the native type is Buffer, so this is a pass-through.
+     */
+    toBytes(id) {
+        return id;
+    }
+    /**
+     * Compare two IDs for equality.
+     */
+    equals(a, b) {
+        return a.equals(b);
+    }
+}
+exports.BufferIdProvider = BufferIdProvider;
+//# sourceMappingURL=buffer-provider.js.map

package/src/lib/id-providers/buffer-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer-provider.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/id-providers/buffer-provider.ts"],"names":[],"mappings":";;;AAAA,mCAAqC;AAErC,0DAIoC;AAEpC;;;;;;;;;;;GAWG;AACH,MAAa,gBAAiB,SAAQ,0BAAsB;IACjD,UAAU,CAAS;IACnB,IAAI,CAAS;IAEtB,YAAY,UAAkB,EAAE,IAAI,GAAG,QAAQ;QAC7C,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;YACxE,MAAM,IAAI,2BAAe,CACvB,+BAAmB,CAAC,0BAA0B,EAC9C,SAAS,EACT,SAAS,EACT,EAAE,KAAK,EAAE,UAAU,EAAE,CACtB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAA,oBAAW,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,EAAU;QACjB,OAAO,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,UAAU,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,EAAU;QAClB,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC;QAClD,OAAO,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,GAAW;QACrB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,2BAAe,CAAC,+BAAmB,CAAC,iBAAiB,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QAC3C,IAAI,GAAG,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;YAClC,MAAM,IAAI,2BAAe,CACvB,+BAAmB,CAAC,mBAAmB,EACvC,SAAS,EACT,SAAS,EACT,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CACjD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,2BAAe,CAAC,+BAAmB,CAAC,iBAAiB,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,EAAU;QACd,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAAa;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,EAAU;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,CAAS,EAAE,CAAS;QACzB,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;CACF;AAjGD,4CAiGC"}

package/src/lib/index.d.ts

@@ -1,4 +1,5 @@
 export * from './crypto-container';
+export * from './id-providers/buffer-provider';
 export * from './invariant-validator';
 export * from './invariants';
 export * from './voting';

package/src/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}

package/src/lib/index.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./crypto-container"), exports);
+tslib_1.__exportStar(require("./id-providers/buffer-provider"), exports);
 tslib_1.__exportStar(require("./invariant-validator"), exports);
 tslib_1.__exportStar(require("./invariants"), exports);
 tslib_1.__exportStar(require("./voting"), exports);

package/src/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC;AACnC,gEAAsC;AACtC,uDAA6B;AAC7B,mDAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC;AACnC,yEAA+C;AAC/C,gEAAsC;AACtC,uDAA6B;AAC7B,mDAAyB"}

package/src/lib/voting/audit.d.ts

@@ -1,55 +1,46 @@
+/**
+ * Immutable Audit Log for Government-Grade Voting
+ * Node.js optimized - extends ecies-lib ImmutableAuditLog with Buffer support
+ */
+import { ImmutableAuditLog as BaseImmutableAuditLog } from '@digitaldefiance/ecies-lib';
 import type { PlatformID } from '../../interfaces';
 import type { IMember } from '../../interfaces/member';
-export declare enum AuditEventType {
-    PollCreated = "poll_created",
-    VoteCast = "vote_cast",
-    PollClosed = "poll_closed"
-}
-export interface AuditEntry<TID extends PlatformID = Buffer> {
-    /** Sequence number (monotonically increasing) */
-    readonly sequence: number;
-    /** Event type */
-    readonly eventType: AuditEventType;
-    /** Microsecond-precision timestamp */
-    readonly timestamp: number;
-    /** Poll identifier */
-    readonly pollId: TID;
-    /** Hash of voter ID (for vote events) */
-    readonly voterIdHash?: Buffer;
-    /** Authority/creator ID (for creation/closure events) */
-    readonly authorityId?: TID;
-    /** Hash of previous entry (chain integrity) */
-    readonly previousHash: Buffer;
-    /** Hash of this entry's data */
-    readonly entryHash: Buffer;
-    /** Digital signature from authority */
-    readonly signature: Buffer;
-    /** Additional event metadata */
-    readonly metadata?: Record<string, unknown>;
-}
-export interface AuditLog<TID extends PlatformID = Buffer> {
-    getEntries(): readonly AuditEntry<TID>[];
-    getEntriesForPoll(pollId: TID): readonly AuditEntry<TID>[];
-    verifyChain(): boolean;
-    verifyEntry(entry: AuditEntry<TID>): boolean;
-}
-export declare class ImmutableAuditLog<TID extends PlatformID = Buffer> implements AuditLog<TID> {
-    private readonly entries;
-    private readonly authority;
-    private sequence;
+import type { AuditEntry } from './interfaces';
+export type { AuditEntry, AuditLog } from './interfaces';
+/**
+ * Node.js ImmutableAuditLog that extends ecies-lib ImmutableAuditLog
+ * Keeps the generic TID parameter for flexibility, defaulting to Buffer
+ *
+ * The base class handles all the logic, we override methods to convert
+ * Uint8Array to Buffer for Node.js compatibility.
+ */
+export declare class ImmutableAuditLog<TID extends PlatformID = Buffer> extends BaseImmutableAuditLog<TID> {
     constructor(authority: IMember<TID>);
+    /**
+     * Record poll creation event
+     * Overrides base method to convert Uint8Array to Buffer
+     */
     recordPollCreated(pollId: TID, metadata?: Record<string, unknown>): AuditEntry<TID>;
-    recordVoteCast(pollId: TID, voterIdHash: Buffer, metadata?: Record<string, unknown>): AuditEntry<TID>;
+    /**
+     * Record vote cast event
+     * Overrides base method to convert Uint8Array to Buffer
+     * Note: voterIdHash is Uint8Array for compatibility with base class
+     */
+    recordVoteCast(pollId: TID, voterIdHash: Uint8Array, metadata?: Record<string, unknown>): AuditEntry<TID>;
+    /**
+     * Record poll closed event
+     * Overrides base method to convert Uint8Array to Buffer
+     */
     recordPollClosed(pollId: TID, metadata?: Record<string, unknown>): AuditEntry<TID>;
-    getEntries(): readonly AuditEntry<TID>[];
-    getEntriesForPoll(pollId: TID): readonly AuditEntry<TID>[];
-    verifyChain(): boolean;
-    verifyEntry(entry: AuditEntry<TID>): boolean;
-    private appendEntry;
-    private computeEntryHash;
-    private serializeEntryForHashing;
-    private serializeEntryForSigning;
-    private getMicrosecondTimestamp;
-    private encodeNumber;
+    /**
+     * Get all audit entries
+     * Overrides base method to convert Uint8Array to Buffer
+     */
+    getEntries(): ReadonlyArray<AuditEntry<TID>>;
+    /**
+     * Get entries for a specific poll
+     * Overrides base method to convert Uint8Array to Buffer
+     */
+    getEntriesForPoll(pollId: TID): ReadonlyArray<AuditEntry<TID>>;
 }
 //# sourceMappingURL=audit.d.ts.map

package/src/lib/voting/audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/audit.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD,oBAAY,cAAc;IACxB,WAAW,iBAAiB;IAC5B,QAAQ,cAAc;IACtB,UAAU,gBAAgB;CAC3B;AAED,MAAM,WAAW,UAAU,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM;IACzD,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iBAAiB;IACjB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,QAAQ,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM;IACvD,UAAU,IAAI,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;IACzC,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;IAC3D,WAAW,IAAI,OAAO,CAAC;IACvB,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;CAC9C;AAED,qBAAa,iBAAiB,CAC5B,GAAG,SAAS,UAAU,GAAG,MAAM,CAC/B,YAAW,QAAQ,CAAC,GAAG,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAK;gBAET,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC;IAInC,iBAAiB,CACf,MAAM,EAAE,GAAG,EACX,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,UAAU,CAAC,GAAG,CAAC;IASlB,cAAc,CACZ,MAAM,EAAE,GAAG,EACX,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,UAAU,CAAC,GAAG,CAAC;IASlB,gBAAgB,CACd,MAAM,EAAE,GAAG,EACX,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,UAAU,CAAC,GAAG,CAAC;IASlB,UAAU,IAAI,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE;IAIxC,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE;IAS1D,WAAW,IAAI,OAAO;IAetB,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,OAAO;IAQ5C,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,wBAAwB;IAiBhC,OAAO,CAAC,wBAAwB;IAShC,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,YAAY;CAKrB"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/audit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,iBAAiB,IAAI,qBAAqB,EAE3C,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAiCzD;;;;;;GAMG;AACH,qBAAa,iBAAiB,CAC5B,GAAG,SAAS,UAAU,GAAG,MAAM,CAC/B,SAAQ,qBAAqB,CAAC,GAAG,CAAC;gBACtB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC;IA0DnC;;;OAGG;IACH,iBAAiB,CACf,MAAM,EAAE,GAAG,EACX,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,UAAU,CAAC,GAAG,CAAC;IAKlB;;;;OAIG;IACH,cAAc,CACZ,MAAM,EAAE,GAAG,EACX,WAAW,EAAE,UAAU,EACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,UAAU,CAAC,GAAG,CAAC;IAKlB;;;OAGG;IACH,gBAAgB,CACd,MAAM,EAAE,GAAG,EACX,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,UAAU,CAAC,GAAG,CAAC;IAKlB;;;OAGG;IACH,UAAU,IAAI,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAK5C;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;CAI/D"}