@digitaldefiance/ecies-lib 4.17.6 → 4.18.0

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

@@ -46,4 +46,15 @@ export { ThresholdKeyGenerator, InvalidThresholdConfigError, KeyGenerationFailed
 export { PartialDecryptionService, InvalidPartialProofError, DeserializationError, } from './partial-decryption-service';
 export { DecryptionCombiner, InsufficientPartialsError, InvalidPartialInCombineError, CombineFailedError, } from './decryption-combiner';
 export { GuardianRegistry, GuardianAlreadyRegisteredError, GuardianNotFoundError, InvalidShareIndexError, RegistryFullError, } from './guardian-registry';
+export { IntervalScheduler, PollNotConfiguredError, InvalidIntervalConfigError, PollSchedulingStateError, } from './interval-scheduler';
+export { CeremonyCoordinator, CeremonyNotFoundError, CeremonyAlreadyCompleteError, DuplicatePartialSubmissionError, InvalidCeremonyPartialProofError, } from './ceremony-coordinator';
+export { PublicTallyFeed } from './public-tally-feed';
+export { TallyVerifier } from './tally-verifier';
+export { ThresholdPoll } from './threshold-poll';
+export { ThresholdPollFactory, InsufficientGuardiansError, InvalidThresholdPollConfigError, } from './threshold-poll-factory';
+export { ThresholdPrecinctAggregator } from './threshold-precinct-aggregator';
+export { ThresholdCountyAggregator } from './threshold-county-aggregator';
+export { ThresholdStateAggregator } from './threshold-state-aggregator';
+export { ThresholdNationalAggregator } from './threshold-national-aggregator';
+export { ThresholdAuditLog } from './threshold-audit-log';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/threshold/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,mBAAmB,cAAc,CAAC;AAGlC,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/threshold/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,mBAAmB,cAAc,CAAC;AAGlC,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,+BAA+B,EAC/B,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAE9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAExE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAE9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

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

@@ -42,7 +42,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RegistryFullError = exports.InvalidShareIndexError = exports.GuardianNotFoundError = exports.GuardianAlreadyRegisteredError = exports.GuardianRegistry = exports.CombineFailedError = exports.InvalidPartialInCombineError = exports.InsufficientPartialsError = exports.DecryptionCombiner = exports.DeserializationError = exports.InvalidPartialProofError = exports.PartialDecryptionService = exports.KeyGenerationFailedError = exports.InvalidThresholdConfigError = exports.ThresholdKeyGenerator = void 0;
+exports.ThresholdAuditLog = exports.ThresholdNationalAggregator = exports.ThresholdStateAggregator = exports.ThresholdCountyAggregator = exports.ThresholdPrecinctAggregator = exports.InvalidThresholdPollConfigError = exports.InsufficientGuardiansError = exports.ThresholdPollFactory = exports.ThresholdPoll = exports.TallyVerifier = exports.PublicTallyFeed = exports.InvalidCeremonyPartialProofError = exports.DuplicatePartialSubmissionError = exports.CeremonyAlreadyCompleteError = exports.CeremonyNotFoundError = exports.CeremonyCoordinator = exports.PollSchedulingStateError = exports.InvalidIntervalConfigError = exports.PollNotConfiguredError = exports.IntervalScheduler = exports.RegistryFullError = exports.InvalidShareIndexError = exports.GuardianNotFoundError = exports.GuardianAlreadyRegisteredError = exports.GuardianRegistry = exports.CombineFailedError = exports.InvalidPartialInCombineError = exports.InsufficientPartialsError = exports.DecryptionCombiner = exports.DeserializationError = exports.InvalidPartialProofError = exports.PartialDecryptionService = exports.KeyGenerationFailedError = exports.InvalidThresholdConfigError = exports.ThresholdKeyGenerator = void 0;
 const tslib_1 = require("tslib");
 // Re-export enumerations
 tslib_1.__exportStar(require("./enumerations"), exports);
@@ -66,4 +66,35 @@ Object.defineProperty(exports, "GuardianAlreadyRegisteredError", { enumerable: t
 Object.defineProperty(exports, "GuardianNotFoundError", { enumerable: true, get: function () { return guardian_registry_1.GuardianNotFoundError; } });
 Object.defineProperty(exports, "InvalidShareIndexError", { enumerable: true, get: function () { return guardian_registry_1.InvalidShareIndexError; } });
 Object.defineProperty(exports, "RegistryFullError", { enumerable: true, get: function () { return guardian_registry_1.RegistryFullError; } });
+var interval_scheduler_1 = require("./interval-scheduler");
+Object.defineProperty(exports, "IntervalScheduler", { enumerable: true, get: function () { return interval_scheduler_1.IntervalScheduler; } });
+Object.defineProperty(exports, "PollNotConfiguredError", { enumerable: true, get: function () { return interval_scheduler_1.PollNotConfiguredError; } });
+Object.defineProperty(exports, "InvalidIntervalConfigError", { enumerable: true, get: function () { return interval_scheduler_1.InvalidIntervalConfigError; } });
+Object.defineProperty(exports, "PollSchedulingStateError", { enumerable: true, get: function () { return interval_scheduler_1.PollSchedulingStateError; } });
+var ceremony_coordinator_1 = require("./ceremony-coordinator");
+Object.defineProperty(exports, "CeremonyCoordinator", { enumerable: true, get: function () { return ceremony_coordinator_1.CeremonyCoordinator; } });
+Object.defineProperty(exports, "CeremonyNotFoundError", { enumerable: true, get: function () { return ceremony_coordinator_1.CeremonyNotFoundError; } });
+Object.defineProperty(exports, "CeremonyAlreadyCompleteError", { enumerable: true, get: function () { return ceremony_coordinator_1.CeremonyAlreadyCompleteError; } });
+Object.defineProperty(exports, "DuplicatePartialSubmissionError", { enumerable: true, get: function () { return ceremony_coordinator_1.DuplicatePartialSubmissionError; } });
+Object.defineProperty(exports, "InvalidCeremonyPartialProofError", { enumerable: true, get: function () { return ceremony_coordinator_1.InvalidCeremonyPartialProofError; } });
+var public_tally_feed_1 = require("./public-tally-feed");
+Object.defineProperty(exports, "PublicTallyFeed", { enumerable: true, get: function () { return public_tally_feed_1.PublicTallyFeed; } });
+var tally_verifier_1 = require("./tally-verifier");
+Object.defineProperty(exports, "TallyVerifier", { enumerable: true, get: function () { return tally_verifier_1.TallyVerifier; } });
+var threshold_poll_1 = require("./threshold-poll");
+Object.defineProperty(exports, "ThresholdPoll", { enumerable: true, get: function () { return threshold_poll_1.ThresholdPoll; } });
+var threshold_poll_factory_1 = require("./threshold-poll-factory");
+Object.defineProperty(exports, "ThresholdPollFactory", { enumerable: true, get: function () { return threshold_poll_factory_1.ThresholdPollFactory; } });
+Object.defineProperty(exports, "InsufficientGuardiansError", { enumerable: true, get: function () { return threshold_poll_factory_1.InsufficientGuardiansError; } });
+Object.defineProperty(exports, "InvalidThresholdPollConfigError", { enumerable: true, get: function () { return threshold_poll_factory_1.InvalidThresholdPollConfigError; } });
+var threshold_precinct_aggregator_1 = require("./threshold-precinct-aggregator");
+Object.defineProperty(exports, "ThresholdPrecinctAggregator", { enumerable: true, get: function () { return threshold_precinct_aggregator_1.ThresholdPrecinctAggregator; } });
+var threshold_county_aggregator_1 = require("./threshold-county-aggregator");
+Object.defineProperty(exports, "ThresholdCountyAggregator", { enumerable: true, get: function () { return threshold_county_aggregator_1.ThresholdCountyAggregator; } });
+var threshold_state_aggregator_1 = require("./threshold-state-aggregator");
+Object.defineProperty(exports, "ThresholdStateAggregator", { enumerable: true, get: function () { return threshold_state_aggregator_1.ThresholdStateAggregator; } });
+var threshold_national_aggregator_1 = require("./threshold-national-aggregator");
+Object.defineProperty(exports, "ThresholdNationalAggregator", { enumerable: true, get: function () { return threshold_national_aggregator_1.ThresholdNationalAggregator; } });
+var threshold_audit_log_1 = require("./threshold-audit-log");
+Object.defineProperty(exports, "ThresholdAuditLog", { enumerable: true, get: function () { return threshold_audit_log_1.ThresholdAuditLog; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/threshold/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;;;;AAEH,yBAAyB;AACzB,yDAA+B;AAK/B,oBAAoB;AACpB,qEAImC;AAHjC,gIAAA,qBAAqB,OAAA;AACrB,sIAAA,2BAA2B,OAAA;AAC3B,mIAAA,wBAAwB,OAAA;AAG1B,2EAIsC;AAHpC,sIAAA,wBAAwB,OAAA;AACxB,sIAAA,wBAAwB,OAAA;AACxB,kIAAA,oBAAoB,OAAA;AAGtB,6DAK+B;AAJ7B,yHAAA,kBAAkB,OAAA;AAClB,gIAAA,yBAAyB,OAAA;AACzB,mIAAA,4BAA4B,OAAA;AAC5B,yHAAA,kBAAkB,OAAA;AAGpB,yDAM6B;AAL3B,qHAAA,gBAAgB,OAAA;AAChB,mIAAA,8BAA8B,OAAA;AAC9B,0HAAA,qBAAqB,OAAA;AACrB,2HAAA,sBAAsB,OAAA;AACtB,sHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/threshold/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;;;;AAEH,yBAAyB;AACzB,yDAA+B;AAK/B,oBAAoB;AACpB,qEAImC;AAHjC,gIAAA,qBAAqB,OAAA;AACrB,sIAAA,2BAA2B,OAAA;AAC3B,mIAAA,wBAAwB,OAAA;AAG1B,2EAIsC;AAHpC,sIAAA,wBAAwB,OAAA;AACxB,sIAAA,wBAAwB,OAAA;AACxB,kIAAA,oBAAoB,OAAA;AAGtB,6DAK+B;AAJ7B,yHAAA,kBAAkB,OAAA;AAClB,gIAAA,yBAAyB,OAAA;AACzB,mIAAA,4BAA4B,OAAA;AAC5B,yHAAA,kBAAkB,OAAA;AAGpB,yDAM6B;AAL3B,qHAAA,gBAAgB,OAAA;AAChB,mIAAA,8BAA8B,OAAA;AAC9B,0HAAA,qBAAqB,OAAA;AACrB,2HAAA,sBAAsB,OAAA;AACtB,sHAAA,iBAAiB,OAAA;AAGnB,2DAK8B;AAJ5B,uHAAA,iBAAiB,OAAA;AACjB,4HAAA,sBAAsB,OAAA;AACtB,gIAAA,0BAA0B,OAAA;AAC1B,8HAAA,wBAAwB,OAAA;AAG1B,+DAMgC;AAL9B,2HAAA,mBAAmB,OAAA;AACnB,6HAAA,qBAAqB,OAAA;AACrB,oIAAA,4BAA4B,OAAA;AAC5B,uIAAA,+BAA+B,OAAA;AAC/B,wIAAA,gCAAgC,OAAA;AAGlC,yDAAsD;AAA7C,oHAAA,eAAe,OAAA;AAExB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAEtB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAEtB,mEAIkC;AAHhC,8HAAA,oBAAoB,OAAA;AACpB,oIAAA,0BAA0B,OAAA;AAC1B,yIAAA,+BAA+B,OAAA;AAGjC,iFAA8E;AAArE,4IAAA,2BAA2B,OAAA;AAEpC,6EAA0E;AAAjE,wIAAA,yBAAyB,OAAA;AAElC,2EAAwE;AAA/D,sIAAA,wBAAwB,OAAA;AAEjC,iFAA8E;AAArE,4IAAA,2BAA2B,OAAA;AAEpC,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA"}

package/src/lib/voting/threshold/interfaces/partial-decryption.d.ts

@@ -8,8 +8,8 @@ import type { ZKProof } from './zk-proof';
 export interface PartialDecryption {
     /** Guardian's share index */
     readonly guardianIndex: number;
-    /** The partial decryption value */
-    readonly value: bigint;
+    /** The partial decryption values — one per ciphertext in the encrypted tally */
+    readonly values: readonly bigint[];
     /** Zero-knowledge proof of correct computation */
     readonly proof: ZKProof;
     /** Ceremony-specific nonce (replay protection) */

package/src/lib/voting/threshold/interfaces/partial-decryption.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"partial-decryption.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/threshold/interfaces/partial-decryption.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"partial-decryption.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/threshold/interfaces/partial-decryption.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/src/lib/voting/threshold/interval-scheduler.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Interval Scheduler
+ *
+ * Manages decryption interval triggers for threshold voting polls.
+ * Supports time-based, vote-count-based, and hybrid interval triggers
+ * with minimum interval enforcement to prevent excessive ceremonies.
+ *
+ * @module voting/threshold
+ */
+import type { PlatformID } from '../../../interfaces/platform-id';
+import type { IntervalConfig } from './interfaces/interval-config';
+import type { IIntervalScheduler } from './interfaces/interval-scheduler';
+import type { IntervalTriggerEvent } from './interfaces/interval-trigger-event';
+/**
+ * Error thrown when a poll is not configured for interval scheduling.
+ */
+export declare class PollNotConfiguredError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when an interval configuration is invalid.
+ */
+export declare class InvalidIntervalConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when a poll is already started or already stopped.
+ */
+export declare class PollSchedulingStateError extends Error {
+    constructor(message: string);
+}
+/**
+ * Scheduler for interval decryption triggers in threshold voting.
+ *
+ * Supports three trigger modes:
+ * - **TimeBased**: Fires at fixed time intervals (e.g., every 30 minutes)
+ * - **VoteCountBased**: Fires after a certain number of new votes
+ * - **Hybrid**: Fires on whichever condition is met first (time or vote count)
+ *
+ * Enforces a minimum interval between triggers to prevent excessive
+ * decryption ceremonies.
+ *
+ * @example
+ * ```typescript
+ * const scheduler = new IntervalScheduler<string>();
+ * scheduler.configure('poll-1', {
+ *   triggerType: IntervalTriggerType.TimeBased,
+ *   timeIntervalMs: 60_000,
+ *   minimumIntervalMs: 30_000,
+ *   ceremonyTimeoutMs: 120_000,
+ * });
+ * scheduler.onTrigger((event) => {
+ *   console.log(`Interval ${event.intervalNumber} triggered`);
+ * });
+ * scheduler.start('poll-1');
+ * ```
+ */
+export declare class IntervalScheduler<TID extends PlatformID = Uint8Array> implements IIntervalScheduler<TID> {
+    private readonly _polls;
+    private readonly _triggerListeners;
+    /**
+     * Configure interval scheduling for a poll.
+     *
+     * @throws InvalidIntervalConfigError if the configuration is invalid
+     * @throws PollSchedulingStateError if the poll is already running
+     */
+    configure(pollId: TID, config: IntervalConfig): void;
+    /**
+     * Start scheduling for a poll.
+     *
+     * For time-based and hybrid triggers, starts a repeating timer.
+     * For vote-count-based triggers, the scheduler waits for notifyVote() calls.
+     *
+     * @throws PollNotConfiguredError if the poll has not been configured
+     * @throws PollSchedulingStateError if the poll is already running
+     */
+    start(pollId: TID): void;
+    /**
+     * Stop scheduling for a poll.
+     *
+     * Clears any active timer and marks the poll as not running.
+     *
+     * @throws PollNotConfiguredError if the poll has not been configured
+     */
+    stop(pollId: TID): void;
+    /**
+     * Notify the scheduler that a new vote has been cast.
+     *
+     * For vote-count-based and hybrid triggers, this may fire a trigger
+     * if the vote count threshold is reached.
+     *
+     * @throws PollNotConfiguredError if the poll has not been configured
+     */
+    notifyVote(pollId: TID): void;
+    /**
+     * Trigger a final decryption ceremony when a poll closes.
+     *
+     * This always fires regardless of minimum interval enforcement,
+     * as the final tally must be computed.
+     *
+     * @throws PollNotConfiguredError if the poll has not been configured
+     */
+    triggerFinal(pollId: TID): void;
+    /**
+     * Subscribe to interval trigger events.
+     */
+    onTrigger(callback: (event: IntervalTriggerEvent<TID>) => void): void;
+    /**
+     * Get the current interval number for a poll.
+     *
+     * @throws PollNotConfiguredError if the poll has not been configured
+     */
+    getCurrentInterval(pollId: TID): number;
+    /**
+     * Emit a trigger event, enforcing minimum interval between triggers.
+     */
+    private emitTrigger;
+    /**
+     * Get the internal state for a poll, throwing if not configured.
+     */
+    private getState;
+}
+//# sourceMappingURL=interval-scheduler.d.ts.map

package/src/lib/voting/threshold/interval-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interval-scheduler.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/threshold/interval-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAEhF;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAI5B;AA0ED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,iBAAiB,CAC5B,GAAG,SAAS,UAAU,GAAG,UAAU,CACnC,YAAW,kBAAkB,CAAC,GAAG,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAE3B;IAEP;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAuBpD;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;IAsBxB;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;IAavB;;;;;;;OAOG;IACH,UAAU,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;IAoB7B;;;;;;;OAOG;IACH,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;IAwB/B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,IAAI;IAIrE;;;;OAIG;IACH,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM;IAIvC;;OAEG;IACH,OAAO,CAAC,WAAW;IA6BnB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAUjB"}

package/src/lib/voting/threshold/interval-scheduler.js

@@ -0,0 +1,281 @@
+"use strict";
+/**
+ * Interval Scheduler
+ *
+ * Manages decryption interval triggers for threshold voting polls.
+ * Supports time-based, vote-count-based, and hybrid interval triggers
+ * with minimum interval enforcement to prevent excessive ceremonies.
+ *
+ * @module voting/threshold
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntervalScheduler = exports.PollSchedulingStateError = exports.InvalidIntervalConfigError = exports.PollNotConfiguredError = void 0;
+const interval_trigger_type_1 = require("./enumerations/interval-trigger-type");
+/**
+ * Error thrown when a poll is not configured for interval scheduling.
+ */
+class PollNotConfiguredError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PollNotConfiguredError';
+    }
+}
+exports.PollNotConfiguredError = PollNotConfiguredError;
+/**
+ * Error thrown when an interval configuration is invalid.
+ */
+class InvalidIntervalConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidIntervalConfigError';
+    }
+}
+exports.InvalidIntervalConfigError = InvalidIntervalConfigError;
+/**
+ * Error thrown when a poll is already started or already stopped.
+ */
+class PollSchedulingStateError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PollSchedulingStateError';
+    }
+}
+exports.PollSchedulingStateError = PollSchedulingStateError;
+/**
+ * Converts a PlatformID to a string key for Map lookups.
+ */
+function toKey(id) {
+    if (id instanceof Uint8Array) {
+        return Array.from(id)
+            .map((b) => b.toString(16).padStart(2, '0'))
+            .join('');
+    }
+    return String(id);
+}
+/**
+ * Validates an IntervalConfig, throwing InvalidIntervalConfigError on problems.
+ */
+function validateConfig(config) {
+    if (config.minimumIntervalMs < 0) {
+        throw new InvalidIntervalConfigError(`minimumIntervalMs must be >= 0, got ${config.minimumIntervalMs}`);
+    }
+    if (config.ceremonyTimeoutMs <= 0) {
+        throw new InvalidIntervalConfigError(`ceremonyTimeoutMs must be > 0, got ${config.ceremonyTimeoutMs}`);
+    }
+    const needsTime = config.triggerType === interval_trigger_type_1.IntervalTriggerType.TimeBased ||
+        config.triggerType === interval_trigger_type_1.IntervalTriggerType.Hybrid;
+    const needsVoteCount = config.triggerType === interval_trigger_type_1.IntervalTriggerType.VoteCountBased ||
+        config.triggerType === interval_trigger_type_1.IntervalTriggerType.Hybrid;
+    if (needsTime) {
+        if (config.timeIntervalMs === undefined || config.timeIntervalMs <= 0) {
+            throw new InvalidIntervalConfigError(`timeIntervalMs must be > 0 for ${config.triggerType} triggers, got ${config.timeIntervalMs}`);
+        }
+        if (config.timeIntervalMs < config.minimumIntervalMs) {
+            throw new InvalidIntervalConfigError(`timeIntervalMs (${config.timeIntervalMs}) must be >= minimumIntervalMs (${config.minimumIntervalMs})`);
+        }
+    }
+    if (needsVoteCount) {
+        if (config.voteCountInterval === undefined ||
+            config.voteCountInterval <= 0 ||
+            !Number.isInteger(config.voteCountInterval)) {
+            throw new InvalidIntervalConfigError(`voteCountInterval must be a positive integer for ${config.triggerType} triggers, got ${config.voteCountInterval}`);
+        }
+    }
+}
+/**
+ * Scheduler for interval decryption triggers in threshold voting.
+ *
+ * Supports three trigger modes:
+ * - **TimeBased**: Fires at fixed time intervals (e.g., every 30 minutes)
+ * - **VoteCountBased**: Fires after a certain number of new votes
+ * - **Hybrid**: Fires on whichever condition is met first (time or vote count)
+ *
+ * Enforces a minimum interval between triggers to prevent excessive
+ * decryption ceremonies.
+ *
+ * @example
+ * ```typescript
+ * const scheduler = new IntervalScheduler<string>();
+ * scheduler.configure('poll-1', {
+ *   triggerType: IntervalTriggerType.TimeBased,
+ *   timeIntervalMs: 60_000,
+ *   minimumIntervalMs: 30_000,
+ *   ceremonyTimeoutMs: 120_000,
+ * });
+ * scheduler.onTrigger((event) => {
+ *   console.log(`Interval ${event.intervalNumber} triggered`);
+ * });
+ * scheduler.start('poll-1');
+ * ```
+ */
+class IntervalScheduler {
+    _polls = new Map();
+    _triggerListeners = [];
+    /**
+     * Configure interval scheduling for a poll.
+     *
+     * @throws InvalidIntervalConfigError if the configuration is invalid
+     * @throws PollSchedulingStateError if the poll is already running
+     */
+    configure(pollId, config) {
+        validateConfig(config);
+        const key = toKey(pollId);
+        const existing = this._polls.get(key);
+        if (existing?.running) {
+            throw new PollSchedulingStateError(`Cannot reconfigure poll '${key}' while it is running. Stop it first.`);
+        }
+        this._polls.set(key, {
+            pollId,
+            config,
+            intervalNumber: 0,
+            voteCount: 0,
+            votesSinceLastTrigger: 0,
+            running: false,
+            timerId: null,
+            lastTriggerTime: 0,
+        });
+    }
+    /**
+     * Start scheduling for a poll.
+     *
+     * For time-based and hybrid triggers, starts a repeating timer.
+     * For vote-count-based triggers, the scheduler waits for notifyVote() calls.
+     *
+     * @throws PollNotConfiguredError if the poll has not been configured
+     * @throws PollSchedulingStateError if the poll is already running
+     */
+    start(pollId) {
+        const state = this.getState(pollId);
+        if (state.running) {
+            throw new PollSchedulingStateError(`Poll '${toKey(pollId)}' is already running`);
+        }
+        state.running = true;
+        state.lastTriggerTime = Date.now();
+        const needsTimer = state.config.triggerType === interval_trigger_type_1.IntervalTriggerType.TimeBased ||
+            state.config.triggerType === interval_trigger_type_1.IntervalTriggerType.Hybrid;
+        if (needsTimer && state.config.timeIntervalMs) {
+            state.timerId = setInterval(() => {
+                this.emitTrigger(state, 'time');
+            }, state.config.timeIntervalMs);
+        }
+    }
+    /**
+     * Stop scheduling for a poll.
+     *
+     * Clears any active timer and marks the poll as not running.
+     *
+     * @throws PollNotConfiguredError if the poll has not been configured
+     */
+    stop(pollId) {
+        const state = this.getState(pollId);
+        if (!state.running) {
+            return; // idempotent
+        }
+        if (state.timerId !== null) {
+            clearInterval(state.timerId);
+            state.timerId = null;
+        }
+        state.running = false;
+    }
+    /**
+     * Notify the scheduler that a new vote has been cast.
+     *
+     * For vote-count-based and hybrid triggers, this may fire a trigger
+     * if the vote count threshold is reached.
+     *
+     * @throws PollNotConfiguredError if the poll has not been configured
+     */
+    notifyVote(pollId) {
+        const state = this.getState(pollId);
+        if (!state.running)
+            return;
+        state.voteCount++;
+        state.votesSinceLastTrigger++;
+        const needsVoteCount = state.config.triggerType === interval_trigger_type_1.IntervalTriggerType.VoteCountBased ||
+            state.config.triggerType === interval_trigger_type_1.IntervalTriggerType.Hybrid;
+        if (needsVoteCount &&
+            state.config.voteCountInterval !== undefined &&
+            state.votesSinceLastTrigger >= state.config.voteCountInterval) {
+            this.emitTrigger(state, 'vote-count');
+        }
+    }
+    /**
+     * Trigger a final decryption ceremony when a poll closes.
+     *
+     * This always fires regardless of minimum interval enforcement,
+     * as the final tally must be computed.
+     *
+     * @throws PollNotConfiguredError if the poll has not been configured
+     */
+    triggerFinal(pollId) {
+        const state = this.getState(pollId);
+        // Stop the scheduler if running
+        if (state.running) {
+            this.stop(pollId);
+        }
+        // Final trigger always fires, bypassing minimum interval
+        state.intervalNumber++;
+        const event = {
+            pollId: state.pollId,
+            intervalNumber: state.intervalNumber,
+            triggerType: state.config.triggerType,
+            triggerReason: 'poll-close',
+            currentVoteCount: state.voteCount,
+            timestamp: Date.now(),
+        };
+        for (const listener of this._triggerListeners) {
+            listener(event);
+        }
+    }
+    /**
+     * Subscribe to interval trigger events.
+     */
+    onTrigger(callback) {
+        this._triggerListeners.push(callback);
+    }
+    /**
+     * Get the current interval number for a poll.
+     *
+     * @throws PollNotConfiguredError if the poll has not been configured
+     */
+    getCurrentInterval(pollId) {
+        return this.getState(pollId).intervalNumber;
+    }
+    /**
+     * Emit a trigger event, enforcing minimum interval between triggers.
+     */
+    emitTrigger(state, reason) {
+        const now = Date.now();
+        const elapsed = now - state.lastTriggerTime;
+        if (elapsed < state.config.minimumIntervalMs) {
+            return; // Rate-limited
+        }
+        state.intervalNumber++;
+        state.lastTriggerTime = now;
+        state.votesSinceLastTrigger = 0;
+        const event = {
+            pollId: state.pollId,
+            intervalNumber: state.intervalNumber,
+            triggerType: state.config.triggerType,
+            triggerReason: reason,
+            currentVoteCount: state.voteCount,
+            timestamp: now,
+        };
+        for (const listener of this._triggerListeners) {
+            listener(event);
+        }
+    }
+    /**
+     * Get the internal state for a poll, throwing if not configured.
+     */
+    getState(pollId) {
+        const key = toKey(pollId);
+        const state = this._polls.get(key);
+        if (!state) {
+            throw new PollNotConfiguredError(`Poll '${key}' has not been configured for interval scheduling`);
+        }
+        return state;
+    }
+}
+exports.IntervalScheduler = IntervalScheduler;
+//# sourceMappingURL=interval-scheduler.js.map

package/src/lib/voting/threshold/interval-scheduler.js.map

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

package/src/lib/voting/threshold/partial-decryption-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"partial-decryption-service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/threshold/partial-decryption-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EACV,yBAAyB,EACzB,QAAQ,EACR,iBAAiB,EAElB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,wBAAyB,YAAW,yBAAyB;IACxE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;gBAEhB,SAAS,EAAE,SAAS;IAKhC;;;;;;;OAOG;IACH,cAAc,CACZ,cAAc,EAAE,MAAM,EAAE,EACxB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,UAAU,GACxB,iBAAiB;IA8BpB;;;;;;;;;;;OAWG;IACH,aAAa,CACX,OAAO,EAAE,iBAAiB,EAC1B,cAAc,EAAE,MAAM,EAAE,EACxB,eAAe,EAAE,UAAU,EAC3B,SAAS,EAAE,SAAS,GACnB,OAAO;IA0CV;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU;IAgBjD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB;IAiChD;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAiCrB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IA0CxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,GAAG;IAKX;;OAEG;IACH,OAAO,CAAC,MAAM;IAcd;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAO3B"}
+{"version":3,"file":"partial-decryption-service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/threshold/partial-decryption-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EACV,yBAAyB,EACzB,QAAQ,EACR,iBAAiB,EAElB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,wBAAyB,YAAW,yBAAyB;IACxE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;gBAEhB,SAAS,EAAE,SAAS;IAKhC;;;;;;;OAOG;IACH,cAAc,CACZ,cAAc,EAAE,MAAM,EAAE,EACxB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,UAAU,GACxB,iBAAiB;IA+BpB;;;;;;;;;;;OAWG;IACH,aAAa,CACX,OAAO,EAAE,iBAAiB,EAC1B,cAAc,EAAE,MAAM,EAAE,EACxB,eAAe,EAAE,UAAU,EAC3B,SAAS,EAAE,SAAS,GACnB,OAAO;IAyCV;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU;IAgBjD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB;IAiChD;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAiCrB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IA8CxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,GAAG;IAKX;;OAEG;IACH,OAAO,CAAC,MAAM;IAcd;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAO3B"}

package/src/lib/voting/threshold/partial-decryption-service.js

@@ -63,21 +63,19 @@ class PartialDecryptionService {
         if (encryptedTally.length === 0) {
             throw new Error('Encrypted tally must not be empty');
         }
+        // Compute the partial decryption exponent: 2 * share
+        // (We omit Δ scaling here for simplicity; the combiner accounts for it)
+        const exponent = 2n * keyShare.share;
+        // Compute partial decryption for each ciphertext: c_j^(2·sᵢ) mod n²
+        const values = encryptedTally.map((c) => this.modPow(c, exponent, this.n2));
         // For the ZK proof, we use the first ciphertext as representative.
         // In a real multi-ciphertext scenario, the proof would cover all,
         // but for simplicity we prove over the first element and the
         // verifier checks the relationship holds.
-        const c = encryptedTally[0];
-        // Compute the partial decryption exponent: 2 * share
-        // (We omit Δ scaling here for simplicity; the combiner accounts for it)
-        const exponent = 2n * keyShare.share;
-        // partial_value = c^(2·sᵢ) mod n²
-        const value = this.modPow(c, exponent, this.n2);
-        // Generate ZK proof
-        const proof = this.generateProof(c, keyShare, ceremonyNonce);
+        const proof = this.generateProof(encryptedTally[0], keyShare, ceremonyNonce);
         return {
             guardianIndex: keyShare.index,
-            value,
+            values,
             proof,
             ceremonyNonce: new Uint8Array(ceremonyNonce),
             timestamp: Date.now(),
@@ -102,12 +100,11 @@ class PartialDecryptionService {
         const n2 = publicKey.n * publicKey.n;
         const c = encryptedTally[0];
         const vk = this.uint8ArrayToBigint(verificationKey);
-        const g = publicKey.g;
         const { commitment, challenge, response } = partial.proof;
         // Check 1: c^(2·z) ≡ commitment_c · value^e mod n²
         // commitment stores the ciphertext commitment (a = c^(2r))
         const lhsCipher = this.modPow(c, 2n * response, n2);
-        const rhsCipher = this.mod(commitment * this.modPow(partial.value, challenge, n2), n2);
+        const rhsCipher = this.mod(commitment * this.modPow(partial.values[0], challenge, n2), n2);
         if (lhsCipher !== rhsCipher) {
             return false;
         }
@@ -117,7 +114,7 @@ class PartialDecryptionService {
         // But we can also just recompute the challenge and check it matches.
         // The challenge includes vk, so a wrong vk produces a different challenge.
         // Recompute challenge with the provided verification key
-        const recomputedChallenge = this.computeChallenge(c, partial.value, commitment, partial.ceremonyNonce, n2, vk);
+        const recomputedChallenge = this.computeChallenge(c, partial.values[0], commitment, partial.ceremonyNonce, n2, vk);
         return challenge === recomputedChallenge;
     }
     /**
@@ -126,7 +123,7 @@ class PartialDecryptionService {
     serialize(partial) {
         const json = JSON.stringify({
             guardianIndex: partial.guardianIndex,
-            value: partial.value.toString(16),
+            values: partial.values.map((v) => v.toString(16)),
             proof: {
                 commitment: partial.proof.commitment.toString(16),
                 challenge: partial.proof.challenge.toString(16),
@@ -146,7 +143,7 @@ class PartialDecryptionService {
             const parsed = JSON.parse(json);
             return {
                 guardianIndex: parsed.guardianIndex,
-                value: BigInt('0x' + parsed.value),
+                values: parsed.values.map((v) => BigInt('0x' + v)),
                 proof: {
                     commitment: BigInt('0x' + parsed.proof.commitment),
                     challenge: BigInt('0x' + parsed.proof.challenge),
@@ -198,7 +195,11 @@ class PartialDecryptionService {
         const pvBytes = this.bigintToUint8Array(partialValue);
         const cmBytes = this.bigintToUint8Array(commitment);
         const vkBytes = this.bigintToUint8Array(verificationKey);
-        const totalLength = cBytes.length + pvBytes.length + cmBytes.length + nonce.length + vkBytes.length;
+        const totalLength = cBytes.length +
+            pvBytes.length +
+            cmBytes.length +
+            nonce.length +
+            vkBytes.length;
         const combined = new Uint8Array(totalLength);
         let offset = 0;
         combined.set(cBytes, offset);