@brightchain/brightchain-lib 0.19.0 → 0.20.0

package/src/lib/interfaces/services/quorumDatabase.d.ts

@@ -0,0 +1,207 @@
+/**
+ * @fileoverview IQuorumDatabase interface.
+ *
+ * Abstraction over BrightChainDb with a dedicated "quorum-system" pool.
+ * Provides full CRUD for epochs, members, documents, proposals, votes,
+ * identity records, aliases, audit log, redistribution journal,
+ * statute config, operational state, transactions, and health check.
+ *
+ * @see Requirements 9, 10
+ */
+import { PlatformID, ShortHexGuid } from '@digitaldefiance/ecies-lib';
+import { QuorumDataRecord } from '../../quorumDataRecord';
+import { AliasRecord } from '../aliasRecord';
+import { QuorumAuditLogEntry } from '../auditLogEntry';
+import { ChainedAuditLogEntry } from '../chainedAuditLogEntry';
+import { IdentityRecoveryRecord } from '../identityRecoveryRecord';
+import { OperationalState } from '../operationalState';
+import { Proposal } from '../proposal';
+import { QuorumEpoch } from '../quorumEpoch';
+import { RedistributionJournalEntry } from '../redistributionJournalEntry';
+import { StatuteOfLimitationsConfig } from '../statuteConfig';
+import { Vote } from '../vote';
+import { IQuorumMember } from './quorumService';
+/**
+ * Abstraction over BrightChainDb with a dedicated "quorum-system" pool.
+ *
+ * Implementations live in brightchain-api-lib (QuorumDatabaseAdapter).
+ * All quorum data is routed through the PooledStoreAdapter for isolation.
+ *
+ * @template TID - Platform ID type for frontend/backend DTO compatibility
+ */
+export interface IQuorumDatabase<TID extends PlatformID = Uint8Array> {
+    /**
+     * Persist an epoch record.
+     * @param epoch - The epoch to save
+     */
+    saveEpoch(epoch: QuorumEpoch<TID>): Promise<void>;
+    /**
+     * Retrieve an epoch by its number.
+     * @param epochNumber - The epoch number
+     * @returns The epoch, or null if not found
+     */
+    getEpoch(epochNumber: number): Promise<QuorumEpoch<TID> | null>;
+    /**
+     * Get the current (latest) epoch.
+     * @returns The current epoch
+     */
+    getCurrentEpoch(): Promise<QuorumEpoch<TID>>;
+    /**
+     * Persist a quorum member record.
+     * @param member - The member to save
+     */
+    saveMember(member: IQuorumMember<TID>): Promise<void>;
+    /**
+     * Retrieve a member by their ID.
+     * @param memberId - The member ID
+     * @returns The member, or null if not found
+     */
+    getMember(memberId: ShortHexGuid): Promise<IQuorumMember<TID> | null>;
+    /**
+     * List all active members in the quorum.
+     * @returns Array of active quorum members
+     */
+    listActiveMembers(): Promise<IQuorumMember<TID>[]>;
+    /**
+     * Persist a sealed document.
+     * @param doc - The document to save
+     */
+    saveDocument(doc: QuorumDataRecord<TID>): Promise<void>;
+    /**
+     * Retrieve a sealed document by its ID.
+     * @param docId - The document ID
+     * @returns The document, or null if not found
+     */
+    getDocument(docId: ShortHexGuid): Promise<QuorumDataRecord<TID> | null>;
+    /**
+     * List documents sealed under a specific epoch with pagination.
+     * @param epochNumber - The epoch number to filter by
+     * @param page - Zero-based page number
+     * @param pageSize - Number of documents per page
+     * @returns Array of documents for the given epoch and page
+     */
+    listDocumentsByEpoch(epochNumber: number, page: number, pageSize: number): Promise<QuorumDataRecord<TID>[]>;
+    /**
+     * Persist a proposal.
+     * @param proposal - The proposal to save
+     */
+    saveProposal(proposal: Proposal<TID>): Promise<void>;
+    /**
+     * Retrieve a proposal by its ID.
+     * @param proposalId - The proposal ID
+     * @returns The proposal, or null if not found
+     */
+    getProposal(proposalId: ShortHexGuid): Promise<Proposal<TID> | null>;
+    /**
+     * Persist a vote.
+     * @param vote - The vote to save
+     */
+    saveVote(vote: Vote<TID>): Promise<void>;
+    /**
+     * Get all votes for a specific proposal.
+     * @param proposalId - The proposal ID
+     * @returns Array of votes for the proposal
+     */
+    getVotesForProposal(proposalId: ShortHexGuid): Promise<Vote<TID>[]>;
+    /**
+     * Persist an identity recovery record.
+     * @param record - The record to save
+     */
+    saveIdentityRecord(record: IdentityRecoveryRecord<TID>): Promise<void>;
+    /**
+     * Retrieve an identity recovery record by its ID.
+     * @param recordId - The record ID
+     * @returns The record, or null if not found
+     */
+    getIdentityRecord(recordId: ShortHexGuid): Promise<IdentityRecoveryRecord<TID> | null>;
+    /**
+     * Delete an identity recovery record (used by expiration scheduler).
+     * @param recordId - The record ID to delete
+     */
+    deleteIdentityRecord(recordId: ShortHexGuid): Promise<void>;
+    /**
+     * List expired identity recovery records with pagination.
+     * @param before - Records with expiresAt before this date are considered expired
+     * @param page - Zero-based page number
+     * @param pageSize - Number of records per page
+     * @returns Array of expired identity recovery records
+     */
+    listExpiredIdentityRecords(before: Date, page: number, pageSize: number): Promise<IdentityRecoveryRecord<TID>[]>;
+    /**
+     * Persist an alias record.
+     * @param alias - The alias record to save
+     */
+    saveAlias(alias: AliasRecord<TID>): Promise<void>;
+    /**
+     * Retrieve an alias record by name.
+     * @param aliasName - The alias name
+     * @returns The alias record, or null if not found
+     */
+    getAlias(aliasName: string): Promise<AliasRecord<TID> | null>;
+    /**
+     * Check if an alias name is available for registration.
+     * @param aliasName - The alias name to check
+     * @returns True if the alias is available
+     */
+    isAliasAvailable(aliasName: string): Promise<boolean>;
+    /**
+     * Append an audit log entry.
+     * @param entry - The audit log entry to append
+     */
+    appendAuditEntry(entry: QuorumAuditLogEntry): Promise<void>;
+    /**
+     * Get the latest chained audit log entry (needed for chain linking).
+     * @returns The latest chained entry, or null if the log is empty
+     */
+    getLatestAuditEntry(): Promise<ChainedAuditLogEntry | null>;
+    /**
+     * Save a redistribution journal entry for rollback support.
+     * @param entry - The journal entry to save
+     */
+    saveJournalEntry(entry: RedistributionJournalEntry): Promise<void>;
+    /**
+     * Get all journal entries for a specific epoch.
+     * @param epochNumber - The epoch number
+     * @returns Array of journal entries for the epoch
+     */
+    getJournalEntries(epochNumber: number): Promise<RedistributionJournalEntry[]>;
+    /**
+     * Delete all journal entries for a specific epoch.
+     * @param epochNumber - The epoch number
+     */
+    deleteJournalEntries(epochNumber: number): Promise<void>;
+    /**
+     * Persist statute of limitations configuration.
+     * @param config - The configuration to save
+     */
+    saveStatuteConfig(config: StatuteOfLimitationsConfig): Promise<void>;
+    /**
+     * Get the current statute of limitations configuration.
+     * @returns The configuration, or null if not configured
+     */
+    getStatuteConfig(): Promise<StatuteOfLimitationsConfig | null>;
+    /**
+     * Persist the operational state (mode and current epoch).
+     * @param state - The operational state to save
+     */
+    saveOperationalState(state: OperationalState): Promise<void>;
+    /**
+     * Get the persisted operational state.
+     * @returns The operational state, or null if not yet initialized
+     */
+    getOperationalState(): Promise<OperationalState | null>;
+    /**
+     * Execute a function within a database transaction.
+     * If the function throws, the transaction is rolled back.
+     * @param fn - The function to execute within the transaction
+     * @returns The result of the function
+     */
+    withTransaction<R>(fn: () => Promise<R>): Promise<R>;
+    /**
+     * Check if the quorum database pool is available.
+     * Detects pool deletion/corruption on startup.
+     * @returns True if the database is available and healthy
+     */
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=quorumDatabase.d.ts.map

package/src/lib/interfaces/services/quorumDatabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quorumDatabase.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/services/quorumDatabase.ts"],"names":[],"mappings":"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"}

package/src/lib/interfaces/services/quorumDatabase.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * @fileoverview IQuorumDatabase interface.
+ *
+ * Abstraction over BrightChainDb with a dedicated "quorum-system" pool.
+ * Provides full CRUD for epochs, members, documents, proposals, votes,
+ * identity records, aliases, audit log, redistribution journal,
+ * statute config, operational state, transactions, and health check.
+ *
+ * @see Requirements 9, 10
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=quorumDatabase.js.map

package/src/lib/interfaces/services/quorumDatabase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quorumDatabase.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/services/quorumDatabase.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/src/lib/interfaces/services/quorumService.d.ts

@@ -1,4 +1,5 @@
 import { GuidV4Uint8Array, Member, PlatformID, ShortHexGuid } from '@digitaldefiance/ecies-lib';
+import { MemberStatusType } from '../../enumerations/memberStatusType';
 /**
  * Metadata for a quorum member
  */
@@ -16,6 +17,8 @@ export interface IQuorumMember<TID extends PlatformID = GuidV4Uint8Array> {
     publicKey: Uint8Array;
     metadata: QuorumMemberMetadata;
     isActive: boolean;
+    /** Member status for access control (banned/suspended checks). Defaults to Active. */
+    status?: MemberStatusType;
     createdAt: Date;
     updatedAt: Date;
     _platformId?: TID;

package/src/lib/interfaces/services/quorumService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quorumService.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/services/quorumService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"quorumService.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/services/quorumService.ts"],"names":[],"mappings":"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"}

package/src/lib/interfaces/services/quorumStateMachine.d.ts

@@ -0,0 +1,128 @@
+/**
+ * @fileoverview IQuorumStateMachine interface.
+ *
+ * Central coordinator for the quorum system. Manages operational mode,
+ * epoch lifecycle, proposal/vote orchestration, and delegates to
+ * SealingService for cryptographic operations.
+ *
+ * @see Requirements 1-7, 10-13
+ */
+import { Member, PlatformID, ShortHexGuid } from '@digitaldefiance/ecies-lib';
+import { QuorumOperationalMode } from '../../enumerations/quorumOperationalMode';
+import { Proposal, ProposalInput } from '../proposal';
+import { QuorumEpoch } from '../quorumEpoch';
+import { QuorumMetrics } from '../quorumMetrics';
+import { VoteInput } from '../vote';
+import { QuorumMemberMetadata, SealedDocumentResult } from './quorumService';
+import { RedistributionConfig } from './redistributionConfig';
+/**
+ * Central quorum state machine interface.
+ *
+ * Replaces the current QuorumService as the central coordinator.
+ * Manages operational mode, epoch lifecycle, proposal/vote orchestration,
+ * and delegates to SealingService for cryptographic operations.
+ *
+ * @template TID - Platform ID type for frontend/backend DTO compatibility
+ */
+export interface IQuorumStateMachine<TID extends PlatformID = Uint8Array> {
+    /**
+     * Get the current operational mode of the quorum system.
+     * @returns The current mode (Bootstrap, Quorum, or TransitionInProgress)
+     */
+    getMode(): Promise<QuorumOperationalMode>;
+    /**
+     * Initialize the quorum system with an initial set of members and threshold.
+     * Enters Bootstrap mode if members < threshold, Quorum mode otherwise.
+     * Detects TransitionInProgress on startup and triggers rollback recovery.
+     * @param members - Initial member set
+     * @param threshold - Configured quorum threshold
+     * @returns The initial QuorumEpoch
+     */
+    initialize(members: Member<TID>[], threshold: number): Promise<QuorumEpoch<TID>>;
+    /**
+     * Initiate a transition ceremony from Bootstrap to Quorum mode.
+     * Verifies member count >= threshold, blocks operations, and re-splits
+     * all bootstrap-sealed documents.
+     * @throws QuorumError with TransitionInProgress if already transitioning
+     * @throws QuorumError with InsufficientMembersForTransition if members < threshold
+     */
+    initiateTransition(): Promise<void>;
+    /**
+     * Add a new member to the quorum.
+     * Increments epoch, triggers share redistribution for all documents,
+     * and emits audit entries.
+     * @param member - The member to add
+     * @param metadata - Metadata for the member
+     * @param redistributionConfig - Optional redistribution configuration
+     * @returns The new QuorumEpoch after member addition
+     */
+    addMember(member: Member<TID>, metadata: QuorumMemberMetadata, redistributionConfig?: Partial<RedistributionConfig>): Promise<QuorumEpoch<TID>>;
+    /**
+     * Remove a member from the quorum.
+     * Validates remaining count >= threshold, increments epoch,
+     * triggers share redistribution with fresh polynomial coefficients,
+     * and emits audit entries.
+     * @param memberId - ID of the member to remove
+     * @param redistributionConfig - Optional redistribution configuration
+     * @returns The new QuorumEpoch after member removal
+     * @throws QuorumError with InsufficientRemainingMembers if removal would drop below threshold
+     */
+    removeMember(memberId: ShortHexGuid, redistributionConfig?: Partial<RedistributionConfig>): Promise<QuorumEpoch<TID>>;
+    /**
+     * Submit a proposal for quorum voting.
+     * Validates proposer, assigns ID, stores as pending, announces via gossip.
+     * @param proposal - The proposal input
+     * @returns The created Proposal with assigned ID and status
+     */
+    submitProposal(proposal: ProposalInput<TID>): Promise<Proposal<TID>>;
+    /**
+     * Submit a vote on a pending proposal.
+     * Validates voter is active member on proposal, checks for duplicates,
+     * stores vote, announces via gossip.
+     * @param vote - The vote input
+     */
+    submitVote(vote: VoteInput<TID>): Promise<void>;
+    /**
+     * Get a proposal by its ID.
+     * @param proposalId - The proposal ID
+     * @returns The proposal, or null if not found
+     */
+    getProposal(proposalId: ShortHexGuid): Promise<Proposal<TID> | null>;
+    /**
+     * Seal a document so it can only be accessed when enough quorum members agree.
+     * Delegates to SealingService with bootstrap or quorum parameters.
+     * Tags document with epoch and sealedUnderBootstrap flag.
+     * @param agent - The member performing the sealing operation
+     * @param document - The document to seal
+     * @param memberIds - IDs of members who will receive shares
+     * @param sharesRequired - Optional number of shares required to unseal
+     * @returns The sealed document result
+     */
+    sealDocument<T>(agent: Member<TID>, document: T, memberIds: ShortHexGuid[], sharesRequired?: number): Promise<SealedDocumentResult<TID>>;
+    /**
+     * Unseal a document using member shares.
+     * Verifies checksum (SHA-3) and creator signature using constant-time
+     * comparison before delegating to SealingService.
+     * @param documentId - The ID of the document to unseal
+     * @param membersWithPrivateKey - Members with loaded private keys for decryption
+     * @returns The unsealed document
+     */
+    unsealDocument<T>(documentId: ShortHexGuid, membersWithPrivateKey: Member<TID>[]): Promise<T>;
+    /**
+     * Get the current epoch.
+     * @returns The current QuorumEpoch
+     */
+    getCurrentEpoch(): Promise<QuorumEpoch<TID>>;
+    /**
+     * Get a specific epoch by number.
+     * @param epochNumber - The epoch number to retrieve
+     * @returns The QuorumEpoch, or null if not found
+     */
+    getEpoch(epochNumber: number): Promise<QuorumEpoch<TID> | null>;
+    /**
+     * Get quorum system metrics for monitoring.
+     * @returns QuorumMetrics with proposal, vote, redistribution, member, epoch, and expiration stats
+     */
+    getMetrics(): Promise<QuorumMetrics>;
+}
+//# sourceMappingURL=quorumStateMachine.d.ts.map

package/src/lib/interfaces/services/quorumStateMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quorumStateMachine.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/services/quorumStateMachine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU;IACtE;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAE1C;;;;;;;OAOG;IACH,UAAU,CACR,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;;;;;OAQG;IACH,SAAS,CACP,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EACnB,QAAQ,EAAE,oBAAoB,EAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACnD,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7B;;;;;;;;;OASG;IACH,YAAY,CACV,QAAQ,EAAE,YAAY,EACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACnD,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7B;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAErE;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;OAIG;IACH,WAAW,CAAC,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAErE;;;;;;;;;OASG;IACH,YAAY,CAAC,CAAC,EACZ,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAClB,QAAQ,EAAE,CAAC,EACX,SAAS,EAAE,YAAY,EAAE,EACzB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC;IAEtC;;;;;;;OAOG;IACH,cAAc,CAAC,CAAC,EACd,UAAU,EAAE,YAAY,EACxB,qBAAqB,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,GACnC,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd;;;OAGG;IACH,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAEhE;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACtC"}

package/src/lib/interfaces/services/quorumStateMachine.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * @fileoverview IQuorumStateMachine interface.
+ *
+ * Central coordinator for the quorum system. Manages operational mode,
+ * epoch lifecycle, proposal/vote orchestration, and delegates to
+ * SealingService for cryptographic operations.
+ *
+ * @see Requirements 1-7, 10-13
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=quorumStateMachine.js.map

package/src/lib/interfaces/services/quorumStateMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quorumStateMachine.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/services/quorumStateMachine.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/src/lib/interfaces/services/redistributionConfig.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview RedistributionConfig interface.
+ *
+ * Configuration for batched share redistribution operations.
+ *
+ * @see Requirements 3, 4, 12.3
+ */
+import { ShortHexGuid } from '@digitaldefiance/ecies-lib';
+/**
+ * Configuration for batched share redistribution.
+ */
+export interface RedistributionConfig {
+    /** Number of documents to process per batch. Default: 100 */
+    batchSize: number;
+    /** Callback for progress reporting */
+    onProgress?: (processed: number, total: number, failed: ShortHexGuid[]) => void;
+    /** Whether to continue on individual document failure. Default: true */
+    continueOnFailure: boolean;
+}
+//# sourceMappingURL=redistributionConfig.d.ts.map

package/src/lib/interfaces/services/redistributionConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redistributionConfig.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/services/redistributionConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,UAAU,CAAC,EAAE,CACX,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,EAAE,KACnB,IAAI,CAAC;IACV,wEAAwE;IACxE,iBAAiB,EAAE,OAAO,CAAC;CAC5B"}

package/src/lib/interfaces/services/redistributionConfig.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * @fileoverview RedistributionConfig interface.
+ *
+ * Configuration for batched share redistribution operations.
+ *
+ * @see Requirements 3, 4, 12.3
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=redistributionConfig.js.map

package/src/lib/interfaces/services/redistributionConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redistributionConfig.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/services/redistributionConfig.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/src/lib/interfaces/statuteConfig.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview StatuteOfLimitationsConfig interface.
+ *
+ * Configuration for the digital statute of limitations that controls
+ * when identity recovery shards are permanently deleted.
+ *
+ * @see Requirements 17
+ */
+/**
+ * Default fallback duration for statute of limitations: 7 years in milliseconds.
+ */
+export declare const DEFAULT_STATUTE_FALLBACK_DURATION_MS: number;
+/**
+ * Configuration for the digital statute of limitations.
+ */
+export interface StatuteOfLimitationsConfig {
+    /** Default expiration duration per content type (e.g., 'post', 'message', 'financial_record'), in milliseconds */
+    defaultDurations: Map<string, number>;
+    /** Fallback duration if content type is not configured. Default: 7 years (~220,898,800,000 ms) */
+    fallbackDurationMs: number;
+}
+//# sourceMappingURL=statuteConfig.d.ts.map

package/src/lib/interfaces/statuteConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statuteConfig.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/statuteConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;GAEG;AACH,eAAO,MAAM,oCAAoC,QAAiB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,kHAAkH;IAClH,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,kGAAkG;IAClG,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/src/lib/interfaces/statuteConfig.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * @fileoverview StatuteOfLimitationsConfig interface.
+ *
+ * Configuration for the digital statute of limitations that controls
+ * when identity recovery shards are permanently deleted.
+ *
+ * @see Requirements 17
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_STATUTE_FALLBACK_DURATION_MS = void 0;
+/** Seven years in milliseconds (default fallback duration) */
+const SEVEN_YEARS_MS = 7 * 365.25 * 24 * 60 * 60 * 1000;
+/**
+ * Default fallback duration for statute of limitations: 7 years in milliseconds.
+ */
+exports.DEFAULT_STATUTE_FALLBACK_DURATION_MS = SEVEN_YEARS_MS;
+//# sourceMappingURL=statuteConfig.js.map

package/src/lib/interfaces/statuteConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statuteConfig.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/statuteConfig.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,8DAA8D;AAC9D,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAExD;;GAEG;AACU,QAAA,oCAAoC,GAAG,cAAc,CAAC"}

package/src/lib/interfaces/storage/documentStore.d.ts

@@ -1,37 +1,59 @@
 /**
- * Minimal document store abstraction that BrightChainDb can satisfy
- * without brightchain-lib depending on brightchain-db.
+ * Minimal typed-collection abstraction that the Model system in
+ * brightchain-db naturally satisfies.
  *
  * This keeps the dependency direction clean:
  *   brightchain-db depends on brightchain-lib (not the reverse).
+ *
+ * EnergyAccountStore (in brightchain-lib) depends only on this interface,
+ * so it can work with any backend that provides typed find/replaceOne/deleteOne
+ * with automatic hydration/dehydration.
  */
 /**
- * A cursor-like result from a find operation.
+ * A cursor-like result from a find operation that yields typed documents.
  */
-export interface IDocumentCursor<T> {
-    toArray(): Promise<T[]>;
+export interface ITypedCursor<TTyped> {
+    toArray(): Promise<TTyped[]>;
 }
 /**
- * Minimal collection interface for document CRUD operations.
- * Intentionally simpler than the full ICollection from node-express-suite
- * to avoid coupling EnergyAccountStore to MongoDB-specific contracts.
+ * A typed collection that automatically hydrates reads and dehydrates writes.
+ *
+ * This is the interface that Model<TStored, TTyped> in brightchain-db
+ * satisfies. EnergyAccountStore depends on this rather than on the
+ * concrete Model class, keeping brightchain-lib free of brightchain-db imports.
+ *
+ * TStored is the shape of documents in the database (flat DTO).
+ * TTyped is the shape your application code works with (rich objects).
  */
-export interface IDocumentCollection<T> {
-    find(filter: Partial<T>): Promise<IDocumentCursor<T>>;
-    replaceOne(filter: Partial<T>, doc: T, options?: {
+export interface ITypedCollection<TStored, TTyped> {
+    /**
+     * Find documents matching a filter on stored field names/values.
+     * Returns a cursor that yields hydrated (TTyped) documents.
+     */
+    find(filter?: Partial<TStored>): ITypedCursor<TTyped>;
+    /**
+     * Find a single document matching a filter.
+     * Returns the hydrated document or null.
+     */
+    findOne(filter?: Partial<TStored>): Promise<TTyped | null>;
+    /**
+     * Replace a single document matching the filter with a typed replacement.
+     * The implementation dehydrates the replacement before writing.
+     */
+    replaceOne(filter: Partial<TStored>, replacement: TTyped, options?: {
         upsert?: boolean;
-    }): Promise<void>;
-    deleteOne(filter: Partial<T>): Promise<boolean>;
-}
-/**
- * Minimal document store interface for connection lifecycle and
- * collection access. BrightChainDb implements this so that
- * EnergyAccountStore (in brightchain-lib) can persist without
- * importing brightchain-db directly.
- */
-export interface IDocumentStore {
-    collection<T>(name: string): IDocumentCollection<T>;
-    connect(uri?: string): Promise<void>;
-    isConnected(): boolean;
+    }): Promise<unknown>;
+    /**
+     * Delete a single document matching the filter.
+     */
+    deleteOne(filter: Partial<TStored>): Promise<unknown>;
+    /**
+     * Convert a typed document to its stored form (for manual operations).
+     */
+    dehydrate(typed: TTyped): TStored;
+    /**
+     * Convert a stored document to its typed form (for manual operations).
+     */
+    hydrate(stored: TStored): TTyped;
 }
 //# sourceMappingURL=documentStore.d.ts.map

package/src/lib/interfaces/storage/documentStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documentStore.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/storage/documentStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,UAAU,CACR,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAClB,GAAG,EAAE,CAAC,EACN,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjD;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,WAAW,IAAI,OAAO,CAAC;CACxB"}
+{"version":3,"file":"documentStore.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/storage/documentStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM;IAClC,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB,CAAC,OAAO,EAAE,MAAM;IAC/C;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEtD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE3D;;;OAGG;IACH,UAAU,CACR,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtD;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAElC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAClC"}

package/src/lib/interfaces/storage/documentStore.js

@@ -1,10 +1,14 @@
 "use strict";
 /**
- * Minimal document store abstraction that BrightChainDb can satisfy
- * without brightchain-lib depending on brightchain-db.
+ * Minimal typed-collection abstraction that the Model system in
+ * brightchain-db naturally satisfies.
  *
  * This keeps the dependency direction clean:
  *   brightchain-db depends on brightchain-lib (not the reverse).
+ *
+ * EnergyAccountStore (in brightchain-lib) depends only on this interface,
+ * so it can work with any backend that provides typed find/replaceOne/deleteOne
+ * with automatic hydration/dehydration.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=documentStore.js.map

package/src/lib/interfaces/storage/documentStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"documentStore.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/storage/documentStore.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}
+{"version":3,"file":"documentStore.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/storage/documentStore.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG"}