@digitaldefiance/node-ecies-lib 4.7.0 → 4.7.2

package/src/lib/voting/event-logger.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Event Logger for Government-Grade Voting
+ * Node.js optimized with native Buffer
+ * Implements requirement 1.3: Comprehensive event logging with microsecond timestamps
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PollEventLogger = exports.EventType = void 0;
+var EventType;
+(function (EventType) {
+    EventType["PollCreated"] = "poll_created";
+    EventType["VoteCast"] = "vote_cast";
+    EventType["PollClosed"] = "poll_closed";
+    EventType["VoteVerified"] = "vote_verified";
+    EventType["TallyComputed"] = "tally_computed";
+    EventType["AuditRequested"] = "audit_requested";
+})(EventType || (exports.EventType = EventType = {}));
+/**
+ * Comprehensive event logger with sequence tracking
+ */
+class PollEventLogger {
+    events = [];
+    sequence = 0;
+    logPollCreated(pollId, creatorId, configuration) {
+        return this.appendEvent({
+            eventType: EventType.PollCreated,
+            pollId,
+            creatorId,
+            configuration,
+        });
+    }
+    logVoteCast(pollId, voterToken, metadata) {
+        return this.appendEvent({
+            eventType: EventType.VoteCast,
+            pollId,
+            voterToken,
+            metadata,
+        });
+    }
+    logPollClosed(pollId, tallyHash, metadata) {
+        return this.appendEvent({
+            eventType: EventType.PollClosed,
+            pollId,
+            tallyHash,
+            metadata,
+        });
+    }
+    logEvent(eventType, pollId, data) {
+        return this.appendEvent({
+            eventType,
+            pollId,
+            ...data,
+        });
+    }
+    getEvents() {
+        return Object.freeze([...this.events]);
+    }
+    getEventsForPoll(pollId) {
+        const pollIdStr = pollId.toString('hex');
+        return Object.freeze(this.events.filter((e) => e.pollId.toString('hex') === pollIdStr));
+    }
+    getEventsByType(eventType) {
+        return Object.freeze(this.events.filter((e) => e.eventType === eventType));
+    }
+    verifySequence() {
+        for (let i = 0; i < this.events.length; i++) {
+            if (this.events[i].sequence !== i) {
+                return false;
+            }
+        }
+        return true;
+    }
+    export() {
+        const parts = [];
+        parts.push(this.encodeNumber(this.events.length));
+        for (const event of this.events) {
+            parts.push(this.serializeEvent(event));
+        }
+        return Buffer.concat(parts);
+    }
+    appendEvent(partial) {
+        const entry = {
+            sequence: this.sequence++,
+            timestamp: this.getMicrosecondTimestamp(),
+            ...partial,
+        };
+        this.events.push(entry);
+        return entry;
+    }
+    serializeEvent(event) {
+        const parts = [
+            this.encodeNumber(event.sequence),
+            this.encodeNumber(event.timestamp),
+            Buffer.from(event.eventType, 'utf8'),
+            this.encodeNumber(event.pollId.length),
+            event.pollId,
+        ];
+        if (event.creatorId) {
+            parts.push(this.encodeNumber(1), this.encodeNumber(event.creatorId.length), event.creatorId);
+        }
+        else {
+            parts.push(this.encodeNumber(0));
+        }
+        if (event.voterToken) {
+            parts.push(this.encodeNumber(1), this.encodeNumber(event.voterToken.length), event.voterToken);
+        }
+        else {
+            parts.push(this.encodeNumber(0));
+        }
+        if (event.configuration) {
+            const configStr = JSON.stringify({
+                method: event.configuration.method,
+                choices: event.configuration.choices,
+                maxWeight: event.configuration.maxWeight?.toString(),
+                threshold: event.configuration.threshold,
+            });
+            const encoded = Buffer.from(configStr, 'utf8');
+            parts.push(this.encodeNumber(1), this.encodeNumber(encoded.length), encoded);
+        }
+        else {
+            parts.push(this.encodeNumber(0));
+        }
+        if (event.tallyHash) {
+            parts.push(this.encodeNumber(1), this.encodeNumber(event.tallyHash.length), event.tallyHash);
+        }
+        else {
+            parts.push(this.encodeNumber(0));
+        }
+        if (event.metadata) {
+            const metaStr = JSON.stringify(event.metadata);
+            const encoded = Buffer.from(metaStr, 'utf8');
+            parts.push(this.encodeNumber(1), this.encodeNumber(encoded.length), encoded);
+        }
+        else {
+            parts.push(this.encodeNumber(0));
+        }
+        return Buffer.concat(parts);
+    }
+    getMicrosecondTimestamp() {
+        // Get milliseconds since epoch and convert to microseconds
+        // performance.now() is relative to process start, not epoch, so we only use Date.now()
+        const now = Date.now();
+        return now * 1000;
+    }
+    encodeNumber(n) {
+        const buffer = Buffer.alloc(8);
+        buffer.writeBigUInt64BE(BigInt(n));
+        return buffer;
+    }
+}
+exports.PollEventLogger = PollEventLogger;
+//# sourceMappingURL=event-logger.js.map

package/src/lib/voting/event-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-logger.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/event-logger.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,yCAA4B,CAAA;IAC5B,mCAAsB,CAAA;IACtB,uCAA0B,CAAA;IAC1B,2CAA8B,CAAA;IAC9B,6CAAgC,CAAA;IAChC,+CAAkC,CAAA;AACpC,CAAC,EAPW,SAAS,yBAAT,SAAS,QAOpB;AA6ED;;GAEG;AACH,MAAa,eAAe;IACT,MAAM,GAAoB,EAAE,CAAC;IACtC,QAAQ,GAAG,CAAC,CAAC;IAErB,cAAc,CACZ,MAAc,EACd,SAAiB,EACjB,aAAgC;QAEhC,OAAO,IAAI,CAAC,WAAW,CAAC;YACtB,SAAS,EAAE,SAAS,CAAC,WAAW;YAChC,MAAM;YACN,SAAS;YACT,aAAa;SACd,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CACT,MAAc,EACd,UAAkB,EAClB,QAAkC;QAElC,OAAO,IAAI,CAAC,WAAW,CAAC;YACtB,SAAS,EAAE,SAAS,CAAC,QAAQ;YAC7B,MAAM;YACN,UAAU;YACV,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CACX,MAAc,EACd,SAAiB,EACjB,QAAkC;QAElC,OAAO,IAAI,CAAC,WAAW,CAAC;YACtB,SAAS,EAAE,SAAS,CAAC,UAAU;YAC/B,MAAM;YACN,SAAS;YACT,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CACN,SAAoB,EACpB,MAAc,EACd,IAEC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC;YACtB,SAAS;YACT,MAAM;YACN,GAAG,IAAI;SACR,CAAC,CAAC;IACL,CAAC;IAED,SAAS;QACP,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,gBAAgB,CAAC,MAAc;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,MAAM,CAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAClE,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,SAAoB;QAClC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,cAAc;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAClC,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAElD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEO,WAAW,CACjB,OAAsD;QAEtD,MAAM,KAAK,GAAkB;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;YACzB,SAAS,EAAE,IAAI,CAAC,uBAAuB,EAAE;YACzC,GAAG,OAAO;SACX,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,cAAc,CAAC,KAAoB;QACzC,MAAM,KAAK,GAAa;YACtB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC;YACjC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC;YACpC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YACtC,KAAK,CAAC,MAAM;SACb,CAAC;QAEF,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EACzC,KAAK,CAAC,SAAS,CAChB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAC1C,KAAK,CAAC,UAAU,CACjB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC/B,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM;gBAClC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,OAAO;gBACpC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE;gBACpD,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,SAAS;aACzC,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC/C,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,EACjC,OAAO,CACR,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EACzC,KAAK,CAAC,SAAS,CAChB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7C,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,EACjC,OAAO,CACR,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEO,uBAAuB;QAC7B,2DAA2D;QAC3D,uFAAuF;QACvF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,OAAO,GAAG,GAAG,IAAI,CAAC;IACpB,CAAC;IAEO,YAAY,CAAC,CAAS;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA7LD,0CA6LC"}

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

@@ -2,10 +2,13 @@
  * Secure Voting System - Node.js Optimized
  */
 export { Poll } from './poll-core';
+export { VotingPoll, type ECKeyPairBuffer, type VotingPollResults, } from './poll';
 export { VoteEncoder } from './encoder';
 export { PollTallier } from './tallier';
 export { PollFactory } from './factory';
 export { VotingSecurityValidator, VOTING_SECURITY, SecurityLevel, } from './security';
 export { ImmutableAuditLog, AuditEventType, type AuditEntry, type AuditLog, } from './audit';
+export { PublicBulletinBoard, type BulletinBoard, type BulletinBoardEntry, type TallyProof, } from './bulletin-board';
+export { PollEventLogger, EventType, type EventLogger, type EventLogEntry, type PollConfiguration, } from './event-logger';
 export { VotingMethod, type VoteReceipt, type PollResults, type RoundResult, type EncryptedVote, type SupermajorityConfig, type PlaintextVote, } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,SAAS,CAAC"}

package/src/lib/voting/index.js

@@ -3,9 +3,11 @@
  * Secure Voting System - Node.js Optimized
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VotingMethod = exports.AuditEventType = exports.ImmutableAuditLog = exports.SecurityLevel = exports.VOTING_SECURITY = exports.VotingSecurityValidator = exports.PollFactory = exports.PollTallier = exports.VoteEncoder = exports.Poll = void 0;
+exports.VotingMethod = exports.EventType = exports.PollEventLogger = exports.PublicBulletinBoard = exports.AuditEventType = exports.ImmutableAuditLog = exports.SecurityLevel = exports.VOTING_SECURITY = exports.VotingSecurityValidator = exports.PollFactory = exports.PollTallier = exports.VoteEncoder = exports.VotingPoll = exports.Poll = void 0;
 var poll_core_1 = require("./poll-core");
 Object.defineProperty(exports, "Poll", { enumerable: true, get: function () { return poll_core_1.Poll; } });
+var poll_1 = require("./poll");
+Object.defineProperty(exports, "VotingPoll", { enumerable: true, get: function () { return poll_1.VotingPoll; } });
 var encoder_1 = require("./encoder");
 Object.defineProperty(exports, "VoteEncoder", { enumerable: true, get: function () { return encoder_1.VoteEncoder; } });
 var tallier_1 = require("./tallier");
@@ -19,6 +21,11 @@ Object.defineProperty(exports, "SecurityLevel", { enumerable: true, get: functio
 var audit_1 = require("./audit");
 Object.defineProperty(exports, "ImmutableAuditLog", { enumerable: true, get: function () { return audit_1.ImmutableAuditLog; } });
 Object.defineProperty(exports, "AuditEventType", { enumerable: true, get: function () { return audit_1.AuditEventType; } });
+var bulletin_board_1 = require("./bulletin-board");
+Object.defineProperty(exports, "PublicBulletinBoard", { enumerable: true, get: function () { return bulletin_board_1.PublicBulletinBoard; } });
+var event_logger_1 = require("./event-logger");
+Object.defineProperty(exports, "PollEventLogger", { enumerable: true, get: function () { return event_logger_1.PollEventLogger; } });
+Object.defineProperty(exports, "EventType", { enumerable: true, get: function () { return event_logger_1.EventType; } });
 var types_1 = require("./types");
 Object.defineProperty(exports, "VotingMethod", { enumerable: true, get: function () { return types_1.VotingMethod; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yCAAmC;AAA1B,iGAAA,IAAI,OAAA;AACb,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,uCAIoB;AAHlB,mHAAA,uBAAuB,OAAA;AACvB,2GAAA,eAAe,OAAA;AACf,yGAAA,aAAa,OAAA;AAEf,iCAKiB;AAJf,0GAAA,iBAAiB,OAAA;AACjB,uGAAA,cAAc,OAAA;AAIhB,iCAQiB;AAPf,qGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/voting/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yCAAmC;AAA1B,iGAAA,IAAI,OAAA;AACb,+BAIgB;AAHd,kGAAA,UAAU,OAAA;AAIZ,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,uCAIoB;AAHlB,mHAAA,uBAAuB,OAAA;AACvB,2GAAA,eAAe,OAAA;AACf,yGAAA,aAAa,OAAA;AAEf,iCAKiB;AAJf,0GAAA,iBAAiB,OAAA;AACjB,uGAAA,cAAc,OAAA;AAIhB,mDAK0B;AAJxB,qHAAA,mBAAmB,OAAA;AAKrB,+CAMwB;AALtB,+GAAA,eAAe,OAAA;AACf,yGAAA,SAAS,OAAA;AAKX,iCAQiB;AAPf,qGAAA,YAAY,OAAA"}

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

@@ -0,0 +1,124 @@
+import { KeyPair as PaillierKeyPair } from 'paillier-bigint';
+import { Member } from '../../member';
+import { ECIESService } from '../../services/ecies/service';
+import { VotingService } from '../../services/voting.service';
+export interface ECKeyPairBuffer {
+    privateKey: Buffer;
+    publicKey: Buffer;
+}
+/**
+ * Result of a voting poll with decrypted tallies
+ */
+export interface VotingPollResults {
+    /** Total number of votes cast */
+    totalVotes: bigint;
+    /** Tallies for each choice */
+    tallies: bigint[];
+    /** Choice names */
+    choices: string[];
+    /** Percentage for each choice (0-100) */
+    percentages: number[];
+    /** Index of the winning choice */
+    winnerIndex: number;
+    /** Name of the winning choice */
+    winnerName: string;
+    /** Number of unique voters */
+    voterCount: number;
+}
+/**
+ * VotingPoll provides a high-level interface for conducting secure, verifiable polls
+ * using Paillier homomorphic encryption.
+ *
+ * Features:
+ * - Privacy-preserving vote aggregation (votes remain encrypted until tally)
+ * - Verifiable receipts for each voter
+ * - Multiple tallying and analysis methods
+ * - Ranked choice voting support
+ * - Weighted voting support
+ */
+export declare class VotingPoll {
+    readonly choices: string[];
+    readonly votes: bigint[];
+    private readonly paillierKeyPair;
+    private readonly ecKeyPair;
+    private readonly eciesService;
+    readonly receipts: Map<string, Buffer>;
+    private readonly createdAt;
+    private closedAt?;
+    constructor(eciesService: ECIESService, choices: string[], paillierKeyPair: PaillierKeyPair, ecKeyPair: ECKeyPairBuffer, votes: bigint[]);
+    generateEncryptedReceipt(member: Member): Promise<Buffer>;
+    memberVoted(member: Member): boolean;
+    verifyReceipt(member: Member, encryptedReceipt: Buffer): boolean;
+    vote(choiceIndex: number, member: Member): Promise<Buffer>;
+    voteWeighted(choiceIndex: number, weight: bigint, member: Member): Promise<Buffer>;
+    voteRanked(rankedChoices: number[], member: Member): Promise<Buffer>;
+    voteApproval(approvedChoices: number[], member: Member): Promise<Buffer>;
+    get tallies(): bigint[];
+    getTally(choiceIndex: number): bigint;
+    get leadingChoice(): string;
+    /**
+     * Get the index of the leading choice
+     */
+    get leadingChoiceIndex(): number;
+    /**
+     * Get complete poll results with percentages and winner
+     */
+    getResults(): VotingPollResults;
+    /**
+     * Get sorted results (descending by vote count)
+     */
+    getSortedResults(): Array<{
+        choice: string;
+        index: number;
+        tally: bigint;
+        percentage: number;
+    }>;
+    /**
+     * Check if there is a tie for first place
+     */
+    get hasTie(): boolean;
+    /**
+     * Get all choices tied for first place
+     */
+    get tiedChoices(): string[];
+    /**
+     * Get total number of unique voters
+     */
+    get voterCount(): number;
+    /**
+     * Get total encrypted votes (sum of all choice tallies)
+     * Note: This returns encrypted sum - decrypt with getTotalVotes()
+     */
+    get encryptedTotalVotes(): bigint;
+    /**
+     * Get total decrypted vote count
+     */
+    getTotalVotes(): bigint;
+    /**
+     * Close the poll (no more votes can be cast)
+     */
+    close(): void;
+    /**
+     * Check if poll is closed
+     */
+    get isClosed(): boolean;
+    /**
+     * Get poll creation timestamp
+     */
+    get createdAtTimestamp(): Date;
+    /**
+     * Get poll closed timestamp (undefined if not closed)
+     */
+    get closedAtTimestamp(): Date | undefined;
+    /**
+     * Get poll duration in milliseconds (undefined if not closed)
+     */
+    get durationMs(): number | undefined;
+    static newPoll(eciesService: ECIESService, choices: string[], paillierKeyPair: PaillierKeyPair, ecKeyPair: ECKeyPairBuffer): VotingPoll;
+    static newPollWithKeys(eciesService: ECIESService, votingService: VotingService, choices: string[]): Promise<{
+        poll: VotingPoll;
+        paillierKeyPair: PaillierKeyPair;
+        ecKeyPair: ECKeyPairBuffer;
+    }>;
+}
+//# sourceMappingURL=poll.d.ts.map

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

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

package/src/lib/voting/poll.js

@@ -0,0 +1,323 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VotingPoll = void 0;
+/**
+ * VotingPoll - High-level interface for secure, verifiable polls
+ * Node.js optimized with native crypto and Buffer
+ */
+const crypto_1 = require("crypto");
+const constants_1 = require("../../constants");
+/**
+ * VotingPoll provides a high-level interface for conducting secure, verifiable polls
+ * using Paillier homomorphic encryption.
+ *
+ * Features:
+ * - Privacy-preserving vote aggregation (votes remain encrypted until tally)
+ * - Verifiable receipts for each voter
+ * - Multiple tallying and analysis methods
+ * - Ranked choice voting support
+ * - Weighted voting support
+ */
+class VotingPoll {
+    choices;
+    votes;
+    paillierKeyPair;
+    ecKeyPair;
+    eciesService;
+    receipts = new Map();
+    createdAt;
+    closedAt;
+    constructor(eciesService, choices, paillierKeyPair, ecKeyPair, votes) {
+        this.eciesService = eciesService;
+        if (choices.length === 0) {
+            throw new Error('Poll must have at least one choice');
+        }
+        if (choices.length !== votes.length) {
+            throw new Error('Number of choices must match number of vote tallies');
+        }
+        this.choices = choices;
+        this.paillierKeyPair = paillierKeyPair;
+        this.ecKeyPair = ecKeyPair;
+        this.votes = votes;
+        this.createdAt = new Date();
+    }
+    async generateEncryptedReceipt(member) {
+        const randomNonce = (0, crypto_1.randomBytes)(16).toString(constants_1.Constants.VOTING.KEY_FORMAT);
+        const memberId = constants_1.Constants.idProvider.serialize(member.id);
+        const hashInput = `${Date.now()}-${randomNonce}-${memberId}`;
+        const hash = (0, crypto_1.createHash)('sha256').update(hashInput).digest();
+        const signature = this.eciesService.signMessage(this.ecKeyPair.privateKey, hash);
+        const receipt = Buffer.concat([hash, signature]);
+        // Encrypt to the poll's public key so the poll can decrypt and verify later
+        const encryptedReceipt = this.eciesService.encryptSimpleOrSingle(false, this.ecKeyPair.publicKey, receipt);
+        this.receipts.set(memberId, encryptedReceipt);
+        return encryptedReceipt;
+    }
+    memberVoted(member) {
+        const memberId = constants_1.Constants.idProvider.serialize(member.id);
+        return this.receipts.has(memberId);
+    }
+    verifyReceipt(member, encryptedReceipt) {
+        const memberId = constants_1.Constants.idProvider.serialize(member.id);
+        const foundReceipt = this.receipts.get(memberId);
+        if (!foundReceipt) {
+            return false;
+        }
+        if (!foundReceipt.equals(encryptedReceipt)) {
+            return false;
+        }
+        const decryptedReceipt = this.eciesService.decryptSimpleOrSingleWithHeader(false, this.ecKeyPair.privateKey, encryptedReceipt);
+        const hash = decryptedReceipt.subarray(0, 32);
+        const signature = decryptedReceipt.subarray(32);
+        return this.eciesService.verifyMessage(this.ecKeyPair.publicKey, hash, signature);
+    }
+    async vote(choiceIndex, member) {
+        if (this.isClosed) {
+            throw new Error('Poll is closed');
+        }
+        if (this.memberVoted(member)) {
+            throw new Error('Member has already voted');
+        }
+        if (choiceIndex < 0 || choiceIndex >= this.choices.length) {
+            throw new Error(`Invalid option index ${choiceIndex}`);
+        }
+        // vote a 1 for the selected candidate and a 0 for all others
+        for (let i = 0; i < this.choices.length; i++) {
+            if (i == choiceIndex) {
+                this.votes[i] = this.paillierKeyPair.publicKey.addition(this.votes[i], this.paillierKeyPair.publicKey.encrypt(1n));
+            }
+            else {
+                this.votes[i] = this.paillierKeyPair.publicKey.addition(this.votes[i], this.paillierKeyPair.publicKey.encrypt(0n));
+            }
+        }
+        return await this.generateEncryptedReceipt(member);
+    }
+    async voteWeighted(choiceIndex, weight, member) {
+        if (this.isClosed) {
+            throw new Error('Poll is closed');
+        }
+        if (this.memberVoted(member)) {
+            throw new Error('Member has already voted');
+        }
+        if (choiceIndex < 0 || choiceIndex >= this.choices.length) {
+            throw new Error(`Invalid option index ${choiceIndex}`);
+        }
+        if (weight <= 0n) {
+            throw new Error('Vote weight must be positive');
+        }
+        // Add weighted vote to selected choice
+        this.votes[choiceIndex] = this.paillierKeyPair.publicKey.addition(this.votes[choiceIndex], this.paillierKeyPair.publicKey.encrypt(weight));
+        return await this.generateEncryptedReceipt(member);
+    }
+    async voteRanked(rankedChoices, member) {
+        if (this.isClosed) {
+            throw new Error('Poll is closed');
+        }
+        if (this.memberVoted(member)) {
+            throw new Error('Member has already voted');
+        }
+        if (rankedChoices.length === 0) {
+            throw new Error('Must provide at least one ranked choice');
+        }
+        // Validate all choices are valid and unique
+        const seen = new Set();
+        for (const choiceIndex of rankedChoices) {
+            if (choiceIndex < 0 || choiceIndex >= this.choices.length) {
+                throw new Error(`Invalid choice index ${choiceIndex}`);
+            }
+            if (seen.has(choiceIndex)) {
+                throw new Error(`Duplicate choice index ${choiceIndex}`);
+            }
+            seen.add(choiceIndex);
+        }
+        // Award points based on ranking (first choice gets highest points)
+        const maxPoints = BigInt(rankedChoices.length);
+        for (let i = 0; i < rankedChoices.length; i++) {
+            const choiceIndex = rankedChoices[i];
+            const points = maxPoints - BigInt(i); // First choice gets n points, second gets n-1, etc.
+            this.votes[choiceIndex] = this.paillierKeyPair.publicKey.addition(this.votes[choiceIndex], this.paillierKeyPair.publicKey.encrypt(points));
+        }
+        return await this.generateEncryptedReceipt(member);
+    }
+    async voteApproval(approvedChoices, member) {
+        if (this.isClosed) {
+            throw new Error('Poll is closed');
+        }
+        if (this.memberVoted(member)) {
+            throw new Error('Member has already voted');
+        }
+        if (approvedChoices.length === 0) {
+            throw new Error('Must approve at least one choice');
+        }
+        // Validate all choices and check for duplicates
+        const seen = new Set();
+        for (const choiceIndex of approvedChoices) {
+            if (choiceIndex < 0 || choiceIndex >= this.choices.length) {
+                throw new Error(`Invalid choice index ${choiceIndex}`);
+            }
+            if (seen.has(choiceIndex)) {
+                throw new Error(`Duplicate choice index ${choiceIndex}`);
+            }
+            seen.add(choiceIndex);
+        }
+        // Add 1 vote to each approved choice
+        for (const choiceIndex of approvedChoices) {
+            this.votes[choiceIndex] = this.paillierKeyPair.publicKey.addition(this.votes[choiceIndex], this.paillierKeyPair.publicKey.encrypt(1n));
+        }
+        return await this.generateEncryptedReceipt(member);
+    }
+    get tallies() {
+        return this.votes.map((encryptedVote) => this.paillierKeyPair.privateKey.decrypt(encryptedVote));
+    }
+    getTally(choiceIndex) {
+        return this.paillierKeyPair.privateKey.decrypt(this.votes[choiceIndex]);
+    }
+    get leadingChoice() {
+        const tallies = this.tallies;
+        let leadingOptionIndex = 0;
+        for (let i = 1; i < tallies.length; i++) {
+            if (tallies[i] > tallies[leadingOptionIndex]) {
+                leadingOptionIndex = i;
+            }
+        }
+        return this.choices[leadingOptionIndex];
+    }
+    /**
+     * Get the index of the leading choice
+     */
+    get leadingChoiceIndex() {
+        const tallies = this.tallies;
+        let leadingOptionIndex = 0;
+        for (let i = 1; i < tallies.length; i++) {
+            if (tallies[i] > tallies[leadingOptionIndex]) {
+                leadingOptionIndex = i;
+            }
+        }
+        return leadingOptionIndex;
+    }
+    /**
+     * Get complete poll results with percentages and winner
+     */
+    getResults() {
+        const tallies = this.tallies;
+        const totalVotes = tallies.reduce((sum, tally) => sum + tally, 0n);
+        const percentages = tallies.map((tally) => totalVotes > 0n ? Number((tally * 10000n) / totalVotes) / 100 : 0);
+        return {
+            totalVotes,
+            tallies,
+            choices: [...this.choices],
+            percentages,
+            winnerIndex: this.leadingChoiceIndex,
+            winnerName: this.leadingChoice,
+            voterCount: this.receipts.size,
+        };
+    }
+    /**
+     * Get sorted results (descending by vote count)
+     */
+    getSortedResults() {
+        const results = this.getResults();
+        return this.choices
+            .map((choice, index) => ({
+            choice,
+            index,
+            tally: results.tallies[index],
+            percentage: results.percentages[index],
+        }))
+            .sort((a, b) => (b.tally > a.tally ? 1 : b.tally < a.tally ? -1 : 0));
+    }
+    /**
+     * Check if there is a tie for first place
+     */
+    get hasTie() {
+        const tallies = this.tallies;
+        const maxTally = tallies.reduce((max, tally) => (tally > max ? tally : max), 0n);
+        return tallies.filter((tally) => tally === maxTally).length > 1;
+    }
+    /**
+     * Get all choices tied for first place
+     */
+    get tiedChoices() {
+        if (!this.hasTie) {
+            return [];
+        }
+        const tallies = this.tallies;
+        const maxTally = tallies.reduce((max, tally) => (tally > max ? tally : max), 0n);
+        return this.choices.filter((_, index) => tallies[index] === maxTally);
+    }
+    /**
+     * Get total number of unique voters
+     */
+    get voterCount() {
+        return this.receipts.size;
+    }
+    /**
+     * Get total encrypted votes (sum of all choice tallies)
+     * Note: This returns encrypted sum - decrypt with getTotalVotes()
+     */
+    get encryptedTotalVotes() {
+        return this.votes.reduce((sum, vote) => this.paillierKeyPair.publicKey.addition(sum, vote), this.paillierKeyPair.publicKey.encrypt(0n));
+    }
+    /**
+     * Get total decrypted vote count
+     */
+    getTotalVotes() {
+        return this.paillierKeyPair.privateKey.decrypt(this.encryptedTotalVotes);
+    }
+    /**
+     * Close the poll (no more votes can be cast)
+     */
+    close() {
+        if (this.isClosed) {
+            throw new Error('Poll is already closed');
+        }
+        this.closedAt = new Date();
+    }
+    /**
+     * Check if poll is closed
+     */
+    get isClosed() {
+        return this.closedAt !== undefined;
+    }
+    /**
+     * Get poll creation timestamp
+     */
+    get createdAtTimestamp() {
+        return new Date(this.createdAt);
+    }
+    /**
+     * Get poll closed timestamp (undefined if not closed)
+     */
+    get closedAtTimestamp() {
+        return this.closedAt ? new Date(this.closedAt) : undefined;
+    }
+    /**
+     * Get poll duration in milliseconds (undefined if not closed)
+     */
+    get durationMs() {
+        if (!this.closedAt) {
+            return undefined;
+        }
+        return this.closedAt.getTime() - this.createdAt.getTime();
+    }
+    static newPoll(eciesService, choices, paillierKeyPair, ecKeyPair) {
+        const votes = new Array(choices.length);
+        for (let i = 0; i < choices.length; i++) {
+            votes[i] = paillierKeyPair.publicKey.encrypt(0n);
+        }
+        return new VotingPoll(eciesService, choices, paillierKeyPair, ecKeyPair, votes);
+    }
+    static async newPollWithKeys(eciesService, votingService, choices) {
+        const mnemonic = eciesService.generateNewMnemonic();
+        const keyPair = eciesService.mnemonicToSimpleKeyPair(mnemonic);
+        const ecKeyPair = {
+            privateKey: keyPair.privateKey,
+            publicKey: keyPair.publicKey,
+        };
+        const paillierKeyPair = await votingService.deriveVotingKeysFromECDH(ecKeyPair.privateKey, ecKeyPair.publicKey);
+        const poll = VotingPoll.newPoll(eciesService, choices, paillierKeyPair, ecKeyPair);
+        return { poll, paillierKeyPair, ecKeyPair };
+    }
+}
+exports.VotingPoll = VotingPoll;
+//# sourceMappingURL=poll.js.map