@digitaldefiance/node-ecies-lib 4.8.2 → 4.10.6

package/src/lib/voting/examples.js

@@ -0,0 +1,386 @@
+"use strict";
+/**
+ * Voting System Usage Examples (Node.js)
+ * Shows how to use with node-ecies-lib Member class
+ *
+ * Note: This is the Node.js implementation using Buffer instead of Uint8Array.
+ * For the browser implementation, see @digitaldefiance/ecies-lib.
+ *
+ * IMPORTANT: These examples are for documentation purposes and demonstrate the API.
+ * Due to type incompatibilities between ecies-lib Member (Uint8Array) and
+ * node-ecies-lib voting system (Buffer), these examples may require type assertions
+ * or conversion utilities in actual usage. See the test files for working examples.
+ *
+ * These examples show the intended API usage but may not compile due to type
+ * incompatibilities. For working examples, see the test files in the test directory.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.examplePlurality = examplePlurality;
+exports.exampleRankedChoice = exampleRankedChoice;
+exports.exampleWeighted = exampleWeighted;
+exports.exampleBorda = exampleBorda;
+exports.exampleApproval = exampleApproval;
+exports.exampleReceipts = exampleReceipts;
+exports.exampleFilePersistence = exampleFilePersistence;
+exports.exampleStreamProcessing = exampleStreamProcessing;
+exports.exampleBufferCrypto = exampleBufferCrypto;
+exports.exampleAuditLogExport = exampleAuditLogExport;
+// Note: These imports are for documentation purposes
+// import { Member, MemberType, EmailString, ECIESService } from '@digitaldefiance/ecies-lib';
+// import {
+//   PollFactory,
+//   VoteEncoder,
+//   PollTallier,
+//   VotingMethod as _VotingMethod,
+// } from './index';
+/**
+ * Example 1: Simple Plurality Vote
+ *
+ * This example shows the intended API usage. For working examples,
+ * see the test files which handle type conversions properly.
+ */
+async function examplePlurality() {
+    // Note: This is pseudocode for documentation purposes
+    // Actual implementation requires proper type conversions between
+    // ecies-lib Member (Uint8Array) and node-ecies-lib voting (Buffer)
+    console.log(`
+  // Create authority (poll creator)
+  const authority = createMemberWithVotingKeys();
+
+  // Create poll
+  const poll = PollFactory.createPlurality(
+    ['Alice', 'Bob', 'Charlie'],
+    authority.member, // Note: requires Buffer-compatible member
+  );
+
+  // Create voters and cast votes
+  const encoder = new VoteEncoder(authority.member.votingPublicKey!);
+  
+  poll.vote(voter1.member, encoder.encodePlurality(0, 3)); // Alice
+  poll.vote(voter2.member, encoder.encodePlurality(0, 3)); // Alice  
+  poll.vote(voter3.member, encoder.encodePlurality(1, 3)); // Bob
+
+  // Close and tally
+  poll.close();
+  const tallier = new PollTallier(
+    authority.member,
+    authority.member.votingPrivateKey!,
+    authority.member.votingPublicKey!,
+  );
+  const results = tallier.tally(poll);
+
+  console.log('Winner:', results.choices[results.winner!]); // Alice
+  console.log('Tallies:', results.tallies); // [2n, 1n, 0n]
+  `);
+}
+/**
+ * Example 2: Ranked Choice Voting (True IRV)
+ *
+ * This example shows the intended API usage. For working examples,
+ * see the test files which handle type conversions properly.
+ */
+async function exampleRankedChoice() {
+    console.log(`
+  const authority = createMemberWithVotingKeys();
+
+  const poll = PollFactory.createRankedChoice(
+    ['Alice', 'Bob', 'Charlie', 'Diana'],
+    authority.member,
+  );
+
+  const encoder = new VoteEncoder(authority.member.votingPublicKey!);
+
+  // Voter 1: Alice > Bob > Charlie
+  poll.vote(voter1.member, encoder.encodeRankedChoice([0, 1, 2], 4));
+
+  // Voter 2: Bob > Alice > Diana
+  poll.vote(voter2.member, encoder.encodeRankedChoice([1, 0, 3], 4));
+
+  // Voter 3: Charlie > Diana > Bob
+  poll.vote(voter3.member, encoder.encodeRankedChoice([2, 3, 1], 4));
+
+  // Voter 4: Alice > Charlie
+  poll.vote(voter4.member, encoder.encodeRankedChoice([0, 2], 4));
+
+  poll.close();
+  const results = tallier.tally(poll);
+
+  console.log('Winner:', results.choices[results.winner!]);
+  console.log('Rounds:', results.rounds);
+  console.log('Eliminated:', results.eliminated);
+  `);
+}
+/**
+ * Example 3: Weighted Voting (Stakeholder)
+ *
+ * This example shows the intended API usage. For working examples,
+ * see the test files which handle type conversions properly.
+ */
+async function exampleWeighted() {
+    console.log(`
+  const authority = createMemberWithVotingKeys();
+
+  const poll = PollFactory.createWeighted(
+    ['Proposal A', 'Proposal B'],
+    authority.member,
+    1000n, // Max weight
+  );
+
+  const encoder = new VoteEncoder(authority.member.votingPublicKey!);
+
+  // Large stakeholder
+  poll.vote(whale.member, encoder.encodeWeighted(0, 500n, 2));
+
+  // Medium stakeholder  
+  poll.vote(dolphin.member, encoder.encodeWeighted(1, 200n, 2));
+
+  // Small stakeholder
+  poll.vote(shrimp.member, encoder.encodeWeighted(1, 50n, 2));
+
+  poll.close();
+  const results = tallier.tally(poll);
+
+  console.log('Results:', results.tallies); // [500n, 250n]
+  `);
+}
+/**
+ * Example 4: Borda Count
+ *
+ * This example shows the intended API usage. For working examples,
+ * see the test files which handle type conversions properly.
+ */
+async function exampleBorda() {
+    console.log(`
+  const authority = createMemberWithVotingKeys();
+
+  const poll = PollFactory.createBorda(
+    ['Option A', 'Option B', 'Option C'],
+    authority.member,
+  );
+
+  const encoder = new VoteEncoder(authority.member.votingPublicKey!);
+
+  // Each voter ranks all options
+  poll.vote(voter1.member, encoder.encodeBorda([0, 1, 2], 3)); // A=3, B=2, C=1
+  poll.vote(voter2.member, encoder.encodeBorda([1, 0, 2], 3)); // B=3, A=2, C=1
+  poll.vote(voter3.member, encoder.encodeBorda([0, 2, 1], 3)); // A=3, C=2, B=1
+
+  poll.close();
+  const results = tallier.tally(poll);
+
+  console.log('Points:', results.tallies); // [8n, 6n, 4n]
+  console.log('Winner:', results.choices[results.winner!]); // Option A
+  `);
+}
+/**
+ * Example 5: Approval Voting
+ *
+ * This example shows the intended API usage. For working examples,
+ * see the test files which handle type conversions properly.
+ */
+async function exampleApproval() {
+    console.log(`
+  const authority = createMemberWithVotingKeys();
+
+  const poll = PollFactory.createApproval(
+    ['Red', 'Green', 'Blue', 'Yellow'],
+    authority.member,
+  );
+
+  const encoder = new VoteEncoder(authority.member.votingPublicKey!);
+
+  // Voter 1 approves Red and Blue
+  poll.vote(voter1.member, encoder.encodeApproval([0, 2], 4));
+
+  // Voter 2 approves Green and Blue
+  poll.vote(voter2.member, encoder.encodeApproval([1, 2], 4));
+
+  // Voter 3 approves only Blue
+  poll.vote(voter3.member, encoder.encodeApproval([2], 4));
+
+  poll.close();
+  const results = tallier.tally(poll);
+
+  console.log('Approvals:', results.tallies); // [1n, 1n, 3n, 0n]
+  console.log('Winner:', results.choices[results.winner!]); // Blue
+  `);
+}
+/**
+ * Example 6: Receipt Verification
+ *
+ * This example shows the intended API usage. For working examples,
+ * see the test files which handle type conversions properly.
+ */
+async function exampleReceipts() {
+    console.log(`
+  const authority = createMemberWithVotingKeys();
+  const poll = PollFactory.createPlurality(
+    ['Yes', 'No'],
+    authority.member,
+  );
+
+  const voter = createMemberWithVotingKeys();
+  const encoder = new VoteEncoder(authority.member.votingPublicKey!);
+
+  // Cast vote and get receipt
+  const receipt = poll.vote(voter.member, encoder.encodePlurality(0, 2));
+
+  // Verify receipt
+  const isValid = poll.verifyReceipt(voter.member, receipt);
+  console.log('Receipt valid:', isValid); // true
+
+  // Try to verify with wrong voter
+  const otherVoter = createMemberWithVotingKeys();
+  const isInvalid = poll.verifyReceipt(otherVoter.member, receipt);
+  console.log('Wrong voter:', isInvalid); // false
+  `);
+}
+/**
+ * Example 7: Node.js-Specific - File-Based Vote Persistence
+ *
+ * This example shows how to save encrypted votes to disk using Node.js fs module.
+ * For working examples, see the test files which handle type conversions properly.
+ */
+async function exampleFilePersistence() {
+    console.log(`
+  const authority = createMemberWithVotingKeys();
+  const poll = PollFactory.createPlurality(
+    ['Option A', 'Option B'],
+    authority.member,
+  );
+
+  const encoder = new VoteEncoder(authority.member.votingPublicKey!);
+
+  // Cast some votes
+  poll.vote(voter1.member, encoder.encodePlurality(0, 2));
+  poll.vote(voter2.member, encoder.encodePlurality(1, 2));
+
+  // Save encrypted votes to disk (Node.js-specific)
+  const votes = Array.from(poll.getEncryptedVotes().entries());
+  const votesData = votes.map(([voterId, encrypted]) => ({
+    voterId: voterId.toString('hex'), // Convert Buffer to hex string
+    encrypted: encrypted.map(n => n.toString()),
+  }));
+
+  await fs.writeFile(
+    'encrypted-votes.json',
+    JSON.stringify(votesData, null, 2)
+  );
+
+  console.log('Votes saved to encrypted-votes.json');
+
+  // Load votes from disk
+  const loadedData = JSON.parse(
+    await fs.readFile('encrypted-votes.json', 'utf-8')
+  );
+
+  console.log(\`Loaded \${loadedData.length} votes from disk\`);
+  `);
+}
+/**
+ * Example 8: Node.js-Specific - Streaming Large Voter Datasets
+ *
+ * This example shows how to process votes from a stream using Node.js.
+ * For working examples, see the test files which handle type conversions properly.
+ */
+async function exampleStreamProcessing() {
+    console.log(`
+  const authority = createMemberWithVotingKeys();
+  const poll = PollFactory.createPlurality(
+    ['Candidate A', 'Candidate B', 'Candidate C'],
+    authority.member,
+  );
+
+  const encoder = new VoteEncoder(authority.member.votingPublicKey!);
+
+  // Simulate processing votes from a stream
+  console.log('Processing votes from stream...');
+
+  // In a real scenario, this would read from a file stream or network stream
+  const voteStream = Array.from({ length: 100 }, (_, i) => ({
+    voterId: i,
+    choice: i % 3, // Distribute votes across 3 candidates
+  }));
+
+  for (const voteData of voteStream) {
+    const voter = createMemberWithVotingKeys(\`Voter \${voteData.voterId}\`);
+    poll.vote(voter.member, encoder.encodePlurality(voteData.choice, 3));
+  }
+
+  poll.close();
+  const results = tallier.tally(poll);
+
+  console.log('Stream processing complete');
+  console.log('Results:', results.tallies);
+  console.log('Winner:', results.choices[results.winner!]);
+  `);
+}
+/**
+ * Example 9: Node.js-Specific - Cryptographic Operations with Buffer
+ *
+ * This example shows Node.js-specific cryptographic operations using Buffer.
+ */
+async function exampleBufferCrypto() {
+    console.log(`
+  // Generate random voter ID using Node.js crypto (returns Buffer)
+  const voterId = crypto.randomBytes(32);
+  console.log('Voter ID (Buffer):', voterId.toString('hex'));
+
+  // Hash voter ID using Node.js crypto
+  const voterIdHash = crypto.createHash('sha256').update(voterId).digest();
+  console.log('Voter ID Hash (Buffer):', voterIdHash.toString('hex'));
+
+  // Create poll ID using Buffer
+  const pollId = crypto.randomBytes(16);
+  console.log('Poll ID (Buffer):', pollId.toString('hex'));
+
+  // Demonstrate Buffer operations
+  const data1 = Buffer.from('Hello');
+  const data2 = Buffer.from('World');
+  const combined = Buffer.concat([data1, Buffer.from(' '), data2]);
+  console.log('Combined Buffer:', combined.toString()); // "Hello World"
+  `);
+}
+/**
+ * Example 10: Node.js-Specific - Audit Log Export
+ *
+ * This example shows how to export audit logs to JSON files using Node.js.
+ * For working examples, see the test files which handle type conversions properly.
+ */
+async function exampleAuditLogExport() {
+    console.log(`
+  const authority = createMemberWithVotingKeys();
+  const poll = PollFactory.createPlurality(
+    ['Yes', 'No'],
+    authority.member,
+  );
+
+  const encoder = new VoteEncoder(authority.member.votingPublicKey!);
+
+  // Cast votes
+  poll.vote(voter1.member, encoder.encodePlurality(0, 2));
+  poll.vote(voter2.member, encoder.encodePlurality(1, 2));
+
+  poll.close();
+
+  // Export audit log to file (Node.js-specific)
+  const auditEntries = poll.auditLog.getEntries();
+  const auditData = auditEntries.map(entry => ({
+    timestamp: entry.timestamp,
+    eventType: entry.eventType,
+    pollId: entry.pollId.toString('hex'), // Convert Buffer to hex
+    signature: entry.signature.toString('hex'), // Convert Buffer to hex
+    previousHash: entry.previousHash?.toString('hex'), // Convert Buffer to hex
+  }));
+
+  await fs.writeFile(
+    'audit-log.json',
+    JSON.stringify(auditData, null, 2)
+  );
+
+  console.log('Audit log exported to audit-log.json');
+  console.log(\`Total entries: \${auditEntries.length}\`);
+  console.log('Chain valid:', poll.auditLog.verifyChain());
+  `);
+}
+//# sourceMappingURL=examples.js.map

package/src/lib/voting/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/examples.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAiZD,4CAAgB;AAChB,kDAAmB;AACnB,0CAAe;AACf,oCAAY;AACZ,0CAAe;AACf,0CAAe;AACf,wDAAsB;AACtB,0DAAuB;AACvB,kDAAmB;AACnB,sDAAqB;AAxZvB,qDAAqD;AACrD,8FAA8F;AAC9F,WAAW;AACX,iBAAiB;AACjB,iBAAiB;AACjB,iBAAiB;AACjB,mCAAmC;AACnC,oBAAoB;AAEpB;;;;;GAKG;AACH,KAAK,UAAU,gBAAgB;IAC7B,sDAAsD;IACtD,iEAAiE;IACjE,mEAAmE;IAEnE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BX,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,mBAAmB;IAChC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BX,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,eAAe;IAC5B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;GAwBX,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,YAAY;IACzB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;GAoBX,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,eAAe;IAC5B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;GAwBX,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,eAAe;IAC5B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;GAqBX,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,sBAAsB;IACnC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCX,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,uBAAuB;IACpC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BX,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,mBAAmB;IAChC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;GAkBX,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,qBAAqB;IAClC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCX,CAAC,CAAC;AACL,CAAC"}

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

@@ -1,15 +1,44 @@
+import { PollFactory as BasePollFactory, Member } from '@digitaldefiance/ecies-lib';
 import type { PlatformID } from '../../interfaces';
-import type { IMember } from '../../interfaces/member';
+import { VotingMethod } from './enumerations';
 import { Poll } from './poll-core';
-import { VotingMethod } from './types';
-export declare class PollFactory {
-    static create<TID extends PlatformID = Buffer>(choices: string[], method: VotingMethod, authority: IMember<TID>, options?: {
+/**
+ * Node.js PollFactory that extends ecies-lib PollFactory
+ * Overrides factory methods to return node-ecies-lib Poll instances
+ * which use Buffer instead of Uint8Array
+ */
+export declare class PollFactory extends BasePollFactory {
+    /**
+     * Create a new poll with specified method
+     * Overrides base implementation to return node-ecies-lib Poll
+     */
+    static create<TID extends PlatformID = Buffer>(choices: string[], method: VotingMethod, authority: Member<TID>, options?: {
         maxWeight?: bigint;
     }): Poll<TID>;
-    static createPlurality<TID extends PlatformID = Buffer>(choices: string[], authority: IMember<TID>): Poll<TID>;
-    static createApproval<TID extends PlatformID = Buffer>(choices: string[], authority: IMember<TID>): Poll<TID>;
-    static createWeighted<TID extends PlatformID = Buffer>(choices: string[], authority: IMember<TID>, maxWeight: bigint): Poll<TID>;
-    static createBorda<TID extends PlatformID = Buffer>(choices: string[], authority: IMember<TID>): Poll<TID>;
-    static createRankedChoice<TID extends PlatformID = Buffer>(choices: string[], authority: IMember<TID>): Poll<TID>;
+    /**
+     * Create a plurality poll (simple majority)
+     * Returns node-ecies-lib Poll instance
+     */
+    static createPlurality<TID extends PlatformID = Buffer>(choices: string[], authority: Member<TID>): Poll<TID>;
+    /**
+     * Create an approval voting poll
+     * Returns node-ecies-lib Poll instance
+     */
+    static createApproval<TID extends PlatformID = Buffer>(choices: string[], authority: Member<TID>): Poll<TID>;
+    /**
+     * Create a weighted voting poll
+     * Returns node-ecies-lib Poll instance
+     */
+    static createWeighted<TID extends PlatformID = Buffer>(choices: string[], authority: Member<TID>, maxWeight: bigint): Poll<TID>;
+    /**
+     * Create a Borda count poll
+     * Returns node-ecies-lib Poll instance
+     */
+    static createBorda<TID extends PlatformID = Buffer>(choices: string[], authority: Member<TID>): Poll<TID>;
+    /**
+     * Create a ranked choice (IRV) poll
+     * Returns node-ecies-lib Poll instance
+     */
+    static createRankedChoice<TID extends PlatformID = Buffer>(choices: string[], authority: Member<TID>): Poll<TID>;
 }
 //# sourceMappingURL=factory.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,qBAAa,WAAW;IACtB,MAAM,CAAC,MAAM,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EAC3C,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,EACvB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/B,IAAI,CAAC,GAAG,CAAC;IAcZ,MAAM,CAAC,eAAe,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EACpD,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,GACtB,IAAI,CAAC,GAAG,CAAC;IAIZ,MAAM,CAAC,cAAc,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EACnD,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,GACtB,IAAI,CAAC,GAAG,CAAC;IAIZ,MAAM,CAAC,cAAc,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EACnD,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,EACvB,SAAS,EAAE,MAAM,GAChB,IAAI,CAAC,GAAG,CAAC;IAMZ,MAAM,CAAC,WAAW,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EAChD,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,GACtB,IAAI,CAAC,GAAG,CAAC;IAIZ,MAAM,CAAC,kBAAkB,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EACvD,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,GACtB,IAAI,CAAC,GAAG,CAAC;CAGb"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/factory.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,WAAW,IAAI,eAAe,EAC9B,MAAM,EACP,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,eAAe;IAC9C;;;OAGG;WACa,MAAM,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EACpD,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/B,IAAI,CAAC,GAAG,CAAC;IAkBZ;;;OAGG;WACa,eAAe,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EAC7D,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,GACrB,IAAI,CAAC,GAAG,CAAC;IAIZ;;;OAGG;WACa,cAAc,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EAC5D,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,GACrB,IAAI,CAAC,GAAG,CAAC;IAIZ;;;OAGG;WACa,cAAc,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EAC5D,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EACtB,SAAS,EAAE,MAAM,GAChB,IAAI,CAAC,GAAG,CAAC;IAMZ;;;OAGG;WACa,WAAW,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EACzD,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,GACrB,IAAI,CAAC,GAAG,CAAC;IAIZ;;;OAGG;WACa,kBAAkB,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EAChE,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,GACrB,IAAI,CAAC,GAAG,CAAC;CAGb"}

package/src/lib/voting/factory.js

@@ -3,33 +3,67 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PollFactory = void 0;
 /**
  * Poll Factory - Node.js optimized
+ * Extends ecies-lib PollFactory to return node-ecies-lib Poll instances
  */
 const crypto_1 = require("crypto");
+const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
+const enumerations_1 = require("./enumerations");
 const poll_core_1 = require("./poll-core");
-const types_1 = require("./types");
-class PollFactory {
+/**
+ * Node.js PollFactory that extends ecies-lib PollFactory
+ * Overrides factory methods to return node-ecies-lib Poll instances
+ * which use Buffer instead of Uint8Array
+ */
+class PollFactory extends ecies_lib_1.PollFactory {
+    /**
+     * Create a new poll with specified method
+     * Overrides base implementation to return node-ecies-lib Poll
+     */
     static create(choices, method, authority, options) {
         if (!authority.votingPublicKey)
             throw new Error('Authority must have voting public key');
+        // Use Node.js crypto for ID generation
         const id = (0, crypto_1.randomBytes)(16);
-        return new poll_core_1.Poll(id, choices, method, authority, authority.votingPublicKey, options?.maxWeight);
+        // Return node-ecies-lib Poll instance
+        return new poll_core_1.Poll(id, choices, method, authority, // Type assertion needed for compatibility between Member and IMember
+        authority.votingPublicKey, options?.maxWeight);
     }
+    /**
+     * Create a plurality poll (simple majority)
+     * Returns node-ecies-lib Poll instance
+     */
     static createPlurality(choices, authority) {
-        return this.create(choices, types_1.VotingMethod.Plurality, authority);
+        return this.create(choices, enumerations_1.VotingMethod.Plurality, authority);
     }
+    /**
+     * Create an approval voting poll
+     * Returns node-ecies-lib Poll instance
+     */
     static createApproval(choices, authority) {
-        return this.create(choices, types_1.VotingMethod.Approval, authority);
+        return this.create(choices, enumerations_1.VotingMethod.Approval, authority);
     }
+    /**
+     * Create a weighted voting poll
+     * Returns node-ecies-lib Poll instance
+     */
     static createWeighted(choices, authority, maxWeight) {
-        return this.create(choices, types_1.VotingMethod.Weighted, authority, {
+        return this.create(choices, enumerations_1.VotingMethod.Weighted, authority, {
             maxWeight,
         });
     }
+    /**
+     * Create a Borda count poll
+     * Returns node-ecies-lib Poll instance
+     */
     static createBorda(choices, authority) {
-        return this.create(choices, types_1.VotingMethod.Borda, authority);
+        return this.create(choices, enumerations_1.VotingMethod.Borda, authority);
     }
+    /**
+     * Create a ranked choice (IRV) poll
+     * Returns node-ecies-lib Poll instance
+     */
     static createRankedChoice(choices, authority) {
-        return this.create(choices, types_1.VotingMethod.RankedChoice, authority);
+        return this.create(choices, enumerations_1.VotingMethod.RankedChoice, authority);
     }
 }
 exports.PollFactory = PollFactory;

package/src/lib/voting/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/factory.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,mCAAqC;AAKrC,2CAAmC;AACnC,mCAAuC;AAEvC,MAAa,WAAW;IACtB,MAAM,CAAC,MAAM,CACX,OAAiB,EACjB,MAAoB,EACpB,SAAuB,EACvB,OAAgC;QAEhC,IAAI,CAAC,SAAS,CAAC,eAAe;YAC5B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,MAAM,EAAE,GAAG,IAAA,oBAAW,EAAC,EAAE,CAAQ,CAAC;QAClC,OAAO,IAAI,gBAAI,CACb,EAAE,EACF,OAAO,EACP,MAAM,EACN,SAAS,EACT,SAAS,CAAC,eAAe,EACzB,OAAO,EAAE,SAAS,CACnB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,eAAe,CACpB,OAAiB,EACjB,SAAuB;QAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,oBAAY,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,CAAC,cAAc,CACnB,OAAiB,EACjB,SAAuB;QAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,oBAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,cAAc,CACnB,OAAiB,EACjB,SAAuB,EACvB,SAAiB;QAEjB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,oBAAY,CAAC,QAAQ,EAAE,SAAS,EAAE;YAC5D,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW,CAChB,OAAiB,EACjB,SAAuB;QAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,oBAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,CAAC,kBAAkB,CACvB,OAAiB,EACjB,SAAuB;QAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,oBAAY,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACpE,CAAC;CACF;AAzDD,kCAyDC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/factory.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,mCAAqC;AAErC,0DAGoC;AAMpC,iDAA8C;AAC9C,2CAAmC;AAEnC;;;;GAIG;AACH,MAAa,WAAY,SAAQ,uBAAe;IAC9C;;;OAGG;IACH,MAAM,CAAU,MAAM,CACpB,OAAiB,EACjB,MAAoB,EACpB,SAAsB,EACtB,OAAgC;QAEhC,IAAI,CAAC,SAAS,CAAC,eAAe;YAC5B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAE3D,uCAAuC;QACvC,MAAM,EAAE,GAAG,IAAA,oBAAW,EAAC,EAAE,CAAQ,CAAC;QAElC,sCAAsC;QACtC,OAAO,IAAI,gBAAI,CACb,EAAE,EACF,OAAO,EACP,MAAM,EACN,SAAqD,EAAE,qEAAqE;QAC5H,SAAS,CAAC,eAAe,EACzB,OAAO,EAAE,SAAS,CACnB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAU,eAAe,CAC7B,OAAiB,EACjB,SAAsB;QAEtB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,2BAAY,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAU,cAAc,CAC5B,OAAiB,EACjB,SAAsB;QAEtB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,2BAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAU,cAAc,CAC5B,OAAiB,EACjB,SAAsB,EACtB,SAAiB;QAEjB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,2BAAY,CAAC,QAAQ,EAAE,SAAS,EAAE;YAC5D,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,MAAM,CAAU,WAAW,CACzB,OAAiB,EACjB,SAAsB;QAEtB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,2BAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAU,kBAAkB,CAChC,OAAiB,EACjB,SAAsB;QAEtB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,2BAAY,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACpE,CAAC;CACF;AArFD,kCAqFC"}

package/src/lib/voting/hierarchical-aggregator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Node.js Hierarchical Vote Aggregator
+ * Extends ecies-lib aggregators with Buffer support
+ */
+import { PrecinctAggregator as BasePrecinctAggregator, CountyAggregator as BaseCountyAggregator, StateAggregator as BaseStateAggregator, NationalAggregator as BaseNationalAggregator } from '@digitaldefiance/ecies-lib';
+import type { PublicKey } from 'paillier-bigint';
+import type { PlatformID } from '../../interfaces';
+import type { JurisdictionConfig, IVoteLogger, ICheckpointManager } from './interfaces';
+import { Poll } from './poll-core';
+/**
+ * Node.js Precinct-level aggregator
+ * Extends ecies-lib PrecinctAggregator with Buffer support
+ * Handles ~900 votes in memory with optional persistence
+ */
+export declare class PrecinctAggregator<TID extends PlatformID = Buffer> extends BasePrecinctAggregator<TID> {
+    constructor(poll: Poll<TID>, config: JurisdictionConfig<TID>, logger?: IVoteLogger<TID>, checkpointMgr?: ICheckpointManager<TID>);
+}
+/**
+ * Node.js County-level aggregator
+ * Extends ecies-lib CountyAggregator with Buffer support
+ * Combines precinct tallies
+ */
+export declare class CountyAggregator<TID extends PlatformID = Buffer> extends BaseCountyAggregator<TID> {
+    constructor(config: JurisdictionConfig<TID>, votingPublicKey: PublicKey);
+}
+/**
+ * Node.js State-level aggregator
+ * Extends ecies-lib StateAggregator with Buffer support
+ * Combines county tallies
+ */
+export declare class StateAggregator<TID extends PlatformID = Buffer> extends BaseStateAggregator<TID> {
+    constructor(config: JurisdictionConfig<TID>, votingPublicKey: PublicKey);
+}
+/**
+ * Node.js National-level aggregator
+ * Extends ecies-lib NationalAggregator with Buffer support
+ * Combines state tallies and decrypts final result
+ */
+export declare class NationalAggregator<TID extends PlatformID = Buffer> extends BaseNationalAggregator<TID> {
+    constructor(config: JurisdictionConfig<TID>, votingPublicKey: PublicKey);
+}
+export { JurisdictionLevel } from './enumerations';
+export type { JurisdictionConfig, AggregatedTally } from './interfaces';
+//# sourceMappingURL=hierarchical-aggregator.d.ts.map

package/src/lib/voting/hierarchical-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchical-aggregator.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/hierarchical-aggregator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,kBAAkB,IAAI,sBAAsB,EAC5C,gBAAgB,IAAI,oBAAoB,EACxC,eAAe,IAAI,mBAAmB,EACtC,kBAAkB,IAAI,sBAAsB,EAC7C,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC;;;;GAIG;AACH,qBAAa,kBAAkB,CAC7B,GAAG,SAAS,UAAU,GAAG,MAAM,CAC/B,SAAQ,sBAAsB,CAAC,GAAG,CAAC;gBAEjC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EACf,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAC/B,MAAM,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,EACzB,aAAa,CAAC,EAAE,kBAAkB,CAAC,GAAG,CAAC;CAO1C;AAED;;;;GAIG;AACH,qBAAa,gBAAgB,CAC3B,GAAG,SAAS,UAAU,GAAG,MAAM,CAC/B,SAAQ,oBAAoB,CAAC,GAAG,CAAC;gBACrB,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,eAAe,EAAE,SAAS;CAMxE;AAED;;;;GAIG;AACH,qBAAa,eAAe,CAC1B,GAAG,SAAS,UAAU,GAAG,MAAM,CAC/B,SAAQ,mBAAmB,CAAC,GAAG,CAAC;gBACpB,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,eAAe,EAAE,SAAS;CAMxE;AAED;;;;GAIG;AACH,qBAAa,kBAAkB,CAC7B,GAAG,SAAS,UAAU,GAAG,MAAM,CAC/B,SAAQ,sBAAsB,CAAC,GAAG,CAAC;gBACvB,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,eAAe,EAAE,SAAS;CAMxE;AAGD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/src/lib/voting/hierarchical-aggregator.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JurisdictionLevel = exports.NationalAggregator = exports.StateAggregator = exports.CountyAggregator = exports.PrecinctAggregator = void 0;
+/**
+ * Node.js Hierarchical Vote Aggregator
+ * Extends ecies-lib aggregators with Buffer support
+ */
+const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
+/**
+ * Node.js Precinct-level aggregator
+ * Extends ecies-lib PrecinctAggregator with Buffer support
+ * Handles ~900 votes in memory with optional persistence
+ */
+class PrecinctAggregator extends ecies_lib_1.PrecinctAggregator {
+    constructor(poll, config, logger, checkpointMgr) {
+        super(poll, config, logger, checkpointMgr);
+    }
+}
+exports.PrecinctAggregator = PrecinctAggregator;
+/**
+ * Node.js County-level aggregator
+ * Extends ecies-lib CountyAggregator with Buffer support
+ * Combines precinct tallies
+ */
+class CountyAggregator extends ecies_lib_1.CountyAggregator {
+    constructor(config, votingPublicKey) {
+        super(config, votingPublicKey);
+    }
+}
+exports.CountyAggregator = CountyAggregator;
+/**
+ * Node.js State-level aggregator
+ * Extends ecies-lib StateAggregator with Buffer support
+ * Combines county tallies
+ */
+class StateAggregator extends ecies_lib_1.StateAggregator {
+    constructor(config, votingPublicKey) {
+        super(config, votingPublicKey);
+    }
+}
+exports.StateAggregator = StateAggregator;
+/**
+ * Node.js National-level aggregator
+ * Extends ecies-lib NationalAggregator with Buffer support
+ * Combines state tallies and decrypts final result
+ */
+class NationalAggregator extends ecies_lib_1.NationalAggregator {
+    constructor(config, votingPublicKey) {
+        super(config, votingPublicKey);
+    }
+}
+exports.NationalAggregator = NationalAggregator;
+// Re-export types and enums for convenience
+var enumerations_1 = require("./enumerations");
+Object.defineProperty(exports, "JurisdictionLevel", { enumerable: true, get: function () { return enumerations_1.JurisdictionLevel; } });
+//# sourceMappingURL=hierarchical-aggregator.js.map

package/src/lib/voting/hierarchical-aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchical-aggregator.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/hierarchical-aggregator.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,0DAKoC;AAYpC;;;;GAIG;AACH,MAAa,kBAEX,SAAQ,8BAA2B;IACnC,YACE,IAAe,EACf,MAA+B,EAC/B,MAAyB,EACzB,aAAuC;QAEvC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IAC7C,CAAC;CAIF;AAdD,gDAcC;AAED;;;;GAIG;AACH,MAAa,gBAEX,SAAQ,4BAAyB;IACjC,YAAY,MAA+B,EAAE,eAA0B;QACrE,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACjC,CAAC;CAIF;AATD,4CASC;AAED;;;;GAIG;AACH,MAAa,eAEX,SAAQ,2BAAwB;IAChC,YAAY,MAA+B,EAAE,eAA0B;QACrE,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACjC,CAAC;CAIF;AATD,0CASC;AAED;;;;GAIG;AACH,MAAa,kBAEX,SAAQ,8BAA2B;IACnC,YAAY,MAA+B,EAAE,eAA0B;QACrE,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACjC,CAAC;CAIF;AATD,gDASC;AAED,4CAA4C;AAC5C,+CAAmD;AAA1C,iHAAA,iBAAiB,OAAA"}