@brightchain/brightchain-lib 0.1.5 → 0.1.6

package/src/lib/interfaces/network/networkTransport.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=networkTransport.js.map

package/src/lib/interfaces/network/networkTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkTransport.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/network/networkTransport.ts"],"names":[],"mappings":""}

package/src/lib/interfaces/network/node.d.ts

@@ -1,6 +1,7 @@
-import { ChecksumUint8Array, GuidV4 } from '@digitaldefiance/ecies-lib';
+import { GuidV4 } from '@digitaldefiance/ecies-lib';
 import { BlockMetadata } from '../../blockMetadata';
 import { DataTemperature } from '../../enumerations/dataTemperature';
+import { Checksum } from '../../types/checksum';
 /**
  * Node capabilities in the BrightChain network
  */
@@ -83,9 +84,9 @@ export interface INode {
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     updateStatus(status: NodeStatus): Promise<void>;
-    hasBlock(id: ChecksumUint8Array): Promise<boolean>;
-    getBlockMetadata(id: ChecksumUint8Array): Promise<BlockMetadata>;
-    updateBlockTemperature(id: ChecksumUint8Array, temperature: DataTemperature): Promise<void>;
+    hasBlock(id: Checksum): Promise<boolean>;
+    getBlockMetadata(id: Checksum): Promise<BlockMetadata>;
+    updateBlockTemperature(id: Checksum, temperature: DataTemperature): Promise<void>;
     findPeers(): Promise<INode[]>;
     getPeerInfo(peerId: GuidV4): Promise<INode | null>;
     getHealth(): Promise<{

package/src/lib/interfaces/network/node.d.ts.map

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

package/src/lib/interfaces/network/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/network/node.ts"],"names":[],"mappings":";;;AAIA;;GAEG;AACH,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;IACnB,mCAAiB,CAAA;IACjB,yCAAuB,CAAA;IACvB,uCAAqB,CAAA;IACrB,6CAA2B,CAAA;AAC7B,CAAC,EAPW,cAAc,8BAAd,cAAc,QAOzB;AAED;;GAEG;AACH,IAAY,UAMX;AAND,WAAY,UAAU;IACpB,+BAAiB,CAAA;IACjB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,yCAA2B,CAAA;IAC3B,uDAAyC,CAAA;AAC3C,CAAC,EANW,UAAU,0BAAV,UAAU,QAMrB;AAqHD;;GAEG;AACH,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,8CAA6B,CAAA;IAC7B,mDAAkC,CAAA;IAClC,yDAAwC,CAAA;IACxC,6DAA4C,CAAA;IAC5C,uDAAsC,CAAA;IACtC,+CAA8B,CAAA;IAC9B,qDAAoC,CAAA;AACtC,CAAC,EARW,aAAa,6BAAb,aAAa,QAQxB"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/network/node.ts"],"names":[],"mappings":";;;AAKA;;GAEG;AACH,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;IACnB,mCAAiB,CAAA;IACjB,yCAAuB,CAAA;IACvB,uCAAqB,CAAA;IACrB,6CAA2B,CAAA;AAC7B,CAAC,EAPW,cAAc,8BAAd,cAAc,QAOzB;AAED;;GAEG;AACH,IAAY,UAMX;AAND,WAAY,UAAU;IACpB,+BAAiB,CAAA;IACjB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,yCAA2B,CAAA;IAC3B,uDAAyC,CAAA;AAC3C,CAAC,EANW,UAAU,0BAAV,UAAU,QAMrB;AAqHD;;GAEG;AACH,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,8CAA6B,CAAA;IAC7B,mDAAkC,CAAA;IAClC,yDAAwC,CAAA;IACxC,6DAA4C,CAAA;IAC5C,uDAAsC,CAAA;IACtC,+CAA8B,CAAA;IAC9B,qDAAoC,CAAA;AACtC,CAAC,EARW,aAAa,6BAAb,aAAa,QAQxB"}

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

@@ -1,7 +1,29 @@
 import { HexString } from '@digitaldefiance/ecies-lib';
 import { IBasicObjectDTO } from './basicObjectDto';
+/**
+ * Read-only basic data transfer object
+ *
+ * @remarks
+ * This interface extends IBasicObjectDTO with readonly modifiers to prevent
+ * modification of the ID and creation date. It uses HexString for the ID
+ * and Date for the timestamp.
+ *
+ * @example
+ * ```typescript
+ * const readOnlyDto: IReadOnlyBasicObjectDTO = {
+ *   id: '0x123abc',
+ *   dateCreated: new Date()
+ * };
+ *
+ * // These would cause TypeScript errors:
+ * // readOnlyDto.id = '0x456def';
+ * // readOnlyDto.dateCreated = new Date();
+ * ```
+ */
 export interface IReadOnlyBasicObjectDTO extends IBasicObjectDTO<HexString> {
+    /** Unique identifier as a hex string (read-only) */
     readonly id: HexString;
+    /** Creation timestamp (read-only) */
     readonly dateCreated: Date;
 }
 //# sourceMappingURL=readOnlyBasicObjectDto.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"readOnlyBasicObjectDto.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/readOnlyBasicObjectDto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,uBAAwB,SAAQ,eAAe,CAAC,SAAS,CAAC;IACzE,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;CAC5B"}
+{"version":3,"file":"readOnlyBasicObjectDto.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/readOnlyBasicObjectDto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,uBAAwB,SAAQ,eAAe,CAAC,SAAS,CAAC;IACzE,oDAAoD;IACpD,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IAEvB,qCAAqC;IACrC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;CAC5B"}

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

@@ -1,13 +1,46 @@
 import { LanguageCode } from '@digitaldefiance/i18n-lib';
 import { IRole } from './role';
+/**
+ * User information from an authenticated request
+ *
+ * @remarks
+ * This interface represents the user data extracted from an authenticated
+ * request, typically from a JWT token or session. It includes user identity,
+ * preferences, and authorization information.
+ *
+ * @example
+ * ```typescript
+ * const user: IRequestUser = {
+ *   id: 'user-123',
+ *   email: 'user@example.com',
+ *   emailVerified: true,
+ *   roles: [adminRole, memberRole],
+ *   username: 'johndoe',
+ *   siteLanguage: LanguageCode.EN_US,
+ *   timezone: 'America/New_York',
+ *   lastLogin: new Date()
+ * };
+ * ```
+ */
 export interface IRequestUser {
+    /** Unique identifier for the user */
     id: string;
+    /** User's email address */
     email: string;
+    /** Whether the user's email has been verified */
     emailVerified: boolean;
+    /** Array of roles assigned to the user */
     roles: Array<IRole>;
+    /** User's chosen username */
     username: string;
+    /** User's preferred language for the site */
     siteLanguage: LanguageCode;
+    /** User's timezone (e.g., 'America/New_York') */
     timezone: string;
+    /**
+     * Timestamp of the user's last login (optional)
+     * @remarks May be undefined for first-time logins
+     */
     lastLogin?: Date;
 }
 //# sourceMappingURL=requestUser.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"requestUser.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/requestUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB"}
+{"version":3,"file":"requestUser.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/requestUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IAEX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IAEd,iDAAiD;IACjD,aAAa,EAAE,OAAO,CAAC;IAEvB,0CAA0C;IAC1C,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,6CAA6C;IAC7C,YAAY,EAAE,YAAY,CAAC;IAE3B,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB"}

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

@@ -1,4 +1,30 @@
 import { DefaultIdType } from '../sharedTypes';
+/**
+ * Role definition for authorization and access control
+ *
+ * @remarks
+ * Roles define sets of permissions and can be assigned to users. A role
+ * can be either a global admin role or a member role, but not both.
+ *
+ * @typeParam I - The type used for user IDs (defaults to DefaultIdType)
+ *
+ * @example
+ * ```typescript
+ * const adminRole: IRole = {
+ *   name: 'Administrator',
+ *   users: ['user-1', 'user-2'],
+ *   globalAdmin: true,
+ *   member: false
+ * };
+ *
+ * const memberRole: IRole = {
+ *   name: 'Member',
+ *   users: ['user-3', 'user-4'],
+ *   globalAdmin: false,
+ *   member: true
+ * };
+ * ```
+ */
 export interface IRole<I = DefaultIdType> {
     /**
      * The name of the role

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

@@ -1 +1 @@
-{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/role.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,KAAK,CAAC,CAAC,GAAG,aAAa;IACtC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,EAAE,CAAC,EAAE,CAAC;IACX;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB"}
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/role.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,GAAG,aAAa;IACtC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,EAAE,CAAC,EAAE,CAAC;IACX;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB"}

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

@@ -0,0 +1,116 @@
+/**
+ * @file IFecService interface for Forward Error Correction operations
+ * @description Defines the contract for FEC services that provide Reed-Solomon
+ * encoding/decoding for block durability and recovery.
+ *
+ * This interface is implemented by:
+ * - WasmFecService (brightchain-api-lib) - Cross-platform WASM implementation
+ * - NativeRsFecService (brightchain-api-lib) - Apple Silicon hardware acceleration
+ *
+ * @requirements 1.8, 4.5, 4.6, 4.8
+ */
+/**
+ * Represents parity data generated by FEC encoding
+ */
+export interface ParityData {
+    /** The parity data bytes */
+    data: Buffer | Uint8Array;
+    /** The index of this parity shard (0-based) */
+    index: number;
+}
+/**
+ * Result of an FEC recovery operation
+ */
+export interface FecRecoveryResult {
+    /** The recovered data */
+    data: Buffer | Uint8Array;
+    /** Whether recovery was successful */
+    recovered: boolean;
+}
+/**
+ * Interface for Forward Error Correction (FEC) services.
+ *
+ * FEC services provide Reed-Solomon erasure coding functionality for:
+ * 1. Creating parity data for block recovery
+ * 2. Recovering corrupted or missing blocks using parity data
+ * 3. Verifying block integrity against parity data
+ *
+ * Multiple implementations may exist for different environments:
+ * - Native implementations for hardware acceleration
+ * - WASM implementations for cross-platform support
+ * - Browser implementations for lightweight usage
+ */
+export interface IFecService {
+    /**
+     * Check if this FEC service is available in the current environment.
+     *
+     * This method should check for:
+     * - Required native libraries or WASM modules
+     * - Hardware support (e.g., Apple Silicon for native implementations)
+     * - Any other environment-specific requirements
+     *
+     * @returns Promise resolving to true if the service is available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Create parity data for a block using Reed-Solomon encoding.
+     *
+     * This method generates parity shards that can be used to recover
+     * the original data if it becomes corrupted or lost.
+     *
+     * @param blockData - The original block data to create parity for
+     * @param parityCount - Number of parity shards to generate
+     * @returns Promise resolving to array of parity data objects
+     * @throws FecError if encoding fails or parameters are invalid
+     *
+     * @example
+     * ```typescript
+     * const parity = await fecService.createParityData(blockData, 2);
+     * // parity[0] and parity[1] can be stored separately for recovery
+     * ```
+     */
+    createParityData(blockData: Buffer | Uint8Array, parityCount: number): Promise<ParityData[]>;
+    /**
+     * Recover block data using parity data.
+     *
+     * This method reconstructs the original block data using the
+     * available parity shards. Pass null for corruptedData if the
+     * original data is completely missing.
+     *
+     * @param corruptedData - The corrupted block data, or null if completely missing
+     * @param parityData - Array of available parity data objects
+     * @param originalSize - The original size of the block data in bytes
+     * @returns Promise resolving to recovery result with recovered data
+     * @throws FecError if recovery fails or insufficient parity data
+     *
+     * @example
+     * ```typescript
+     * // Recover completely missing data
+     * const result = await fecService.recoverFileData(null, parityData, originalSize);
+     * if (result.recovered) {
+     *   // Use result.data
+     * }
+     * ```
+     */
+    recoverFileData(corruptedData: Buffer | Uint8Array | null, parityData: ParityData[], originalSize: number): Promise<FecRecoveryResult>;
+    /**
+     * Verify block integrity against its parity data.
+     *
+     * This method regenerates parity data from the block and compares
+     * it with the stored parity data to detect corruption.
+     *
+     * @param blockData - The block data to verify
+     * @param parityData - The stored parity data to verify against
+     * @returns Promise resolving to true if the block is intact
+     *
+     * @example
+     * ```typescript
+     * const isValid = await fecService.verifyFileIntegrity(blockData, parityData);
+     * if (!isValid) {
+     *   // Block is corrupted, attempt recovery
+     * }
+     * ```
+     */
+    verifyFileIntegrity(blockData: Buffer | Uint8Array, parityData: ParityData[]): Promise<boolean>;
+}
+//# sourceMappingURL=fecService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fecService.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/services/fecService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;OASG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;;;;;;;;;;;;;;;OAgBG;IACH,gBAAgB,CACd,SAAS,EAAE,MAAM,GAAG,UAAU,EAC9B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEzB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CACb,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,EACzC,UAAU,EAAE,UAAU,EAAE,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9B;;;;;;;;;;;;;;;;;OAiBG;IACH,mBAAmB,CACjB,SAAS,EAAE,MAAM,GAAG,UAAU,EAC9B,UAAU,EAAE,UAAU,EAAE,GACvB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB"}

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

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * @file IFecService interface for Forward Error Correction operations
+ * @description Defines the contract for FEC services that provide Reed-Solomon
+ * encoding/decoding for block durability and recovery.
+ *
+ * This interface is implemented by:
+ * - WasmFecService (brightchain-api-lib) - Cross-platform WASM implementation
+ * - NativeRsFecService (brightchain-api-lib) - Apple Silicon hardware acceleration
+ *
+ * @requirements 1.8, 4.5, 4.6, 4.8
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=fecService.js.map

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

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

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

@@ -0,0 +1,3 @@
+export type * from './fecService';
+export type * from './quorumService';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/services/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,iBAAiB,CAAC"}

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,133 @@
+import { Member, PlatformID, ShortHexGuid } from '@digitaldefiance/ecies-lib';
+/**
+ * Metadata for a quorum member
+ */
+export interface QuorumMemberMetadata {
+    name: string;
+    email?: string;
+    role?: string;
+}
+/**
+ * A quorum member with their public key and metadata
+ * @template TID - Platform ID type (currently unused but reserved for future use)
+ */
+export interface IQuorumMember<TID extends PlatformID = Uint8Array> {
+    id: ShortHexGuid;
+    publicKey: Uint8Array;
+    metadata: QuorumMemberMetadata;
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+    _platformId?: TID;
+}
+/**
+ * A share provided by a member for unsealing
+ */
+export interface MemberShare {
+    memberId: ShortHexGuid;
+    decryptedShare: string;
+}
+/**
+ * Result of a document sealing operation
+ * @template TID - Platform ID type (currently unused but reserved for future use)
+ */
+export interface SealedDocumentResult<TID extends PlatformID = Uint8Array> {
+    documentId: ShortHexGuid;
+    encryptedData: Uint8Array;
+    memberIds: ShortHexGuid[];
+    sharesRequired: number;
+    createdAt: Date;
+    _platformId?: TID;
+}
+/**
+ * Information about a sealed quorum document
+ */
+export interface QuorumDocumentInfo {
+    id: ShortHexGuid;
+    memberIds: ShortHexGuid[];
+    sharesRequired: number;
+    createdAt: Date;
+    creatorId: ShortHexGuid;
+}
+/**
+ * Result of checking if a document can be unlocked
+ */
+export interface CanUnlockResult {
+    canUnlock: boolean;
+    sharesProvided: number;
+    sharesRequired: number;
+    missingMembers: ShortHexGuid[];
+}
+/**
+ * Interface for quorum service operations.
+ * Provides member management and document sealing/unsealing functionality
+ * using Shamir's Secret Sharing for secure multi-party access control.
+ */
+export interface IQuorumService<TID extends PlatformID = Uint8Array> {
+    /**
+     * Add a new member to the quorum
+     * @param member - The member to add (must have public key)
+     * @param metadata - Metadata for the member
+     * @returns The created quorum member record
+     */
+    addMember(member: Member<TID>, metadata: QuorumMemberMetadata): Promise<IQuorumMember<TID>>;
+    /**
+     * Remove a member from the quorum.
+     * Note: This does not affect their ability to participate in unsealing
+     * existing documents they are part of.
+     * @param memberId - The ID of the member to remove
+     */
+    removeMember(memberId: ShortHexGuid): Promise<void>;
+    /**
+     * Get a member by their ID
+     * @param memberId - The ID of the member to retrieve
+     * @returns The member record, or null if not found
+     */
+    getMember(memberId: ShortHexGuid): Promise<IQuorumMember<TID> | null>;
+    /**
+     * List all active members in the quorum
+     * @returns Array of all active quorum members
+     */
+    listMembers(): Promise<IQuorumMember<TID>[]>;
+    /**
+     * Seal a document so it can only be accessed when enough quorum members agree.
+     * @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 - Number of shares required to unseal (defaults to all members)
+     * @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.
+     * @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 information about a sealed document
+     * @param documentId - The ID of the document
+     * @returns Document information, or null if not found
+     */
+    getDocument(documentId: ShortHexGuid): Promise<QuorumDocumentInfo | null>;
+    /**
+     * List all documents, optionally filtered by member
+     * @param memberId - Optional member ID to filter by
+     * @returns Array of document information
+     */
+    listDocuments(memberId?: ShortHexGuid): Promise<QuorumDocumentInfo[]>;
+    /**
+     * Delete a sealed document
+     * @param documentId - The ID of the document to delete
+     */
+    deleteDocument(documentId: ShortHexGuid): Promise<void>;
+    /**
+     * Check if a set of members can unlock a document
+     * @param documentId - The ID of the document
+     * @param memberIds - IDs of members who would provide shares
+     * @returns Result indicating if unlock is possible
+     */
+    canUnlock(documentId: ShortHexGuid, memberIds: ShortHexGuid[]): Promise<CanUnlockResult>;
+}
+//# sourceMappingURL=quorumService.d.ts.map

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

@@ -0,0 +1 @@
+{"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/quorumService.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=quorumService.js.map

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

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

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

@@ -0,0 +1,124 @@
+import { RawDataBlock } from '../../blocks/rawData';
+import { DurabilityLevel } from '../../enumerations/durabilityLevel';
+import { ReplicationStatus } from '../../enumerations/replicationStatus';
+/**
+ * Block metadata including durability, parity, and replication information.
+ * This metadata is stored alongside block data to track lifecycle, access patterns,
+ * and redundancy status.
+ */
+export interface IBlockMetadata {
+    /**
+     * Unique identifier for the block (typically the checksum as hex string)
+     */
+    blockId: string;
+    /**
+     * Timestamp when the block was created/stored
+     */
+    createdAt: Date;
+    /**
+     * Timestamp when the block expires and becomes eligible for cleanup.
+     * Null indicates the block never expires.
+     */
+    expiresAt: Date | null;
+    /**
+     * The durability level determining parity block generation
+     */
+    durabilityLevel: DurabilityLevel;
+    /**
+     * IDs of parity blocks generated for this data block using Reed-Solomon encoding
+     */
+    parityBlockIds: string[];
+    /**
+     * Number of times this block has been accessed
+     */
+    accessCount: number;
+    /**
+     * Timestamp of the most recent access to this block
+     */
+    lastAccessedAt: Date;
+    /**
+     * Current replication status of the block
+     */
+    replicationStatus: ReplicationStatus;
+    /**
+     * Target number of replicas for this block
+     */
+    targetReplicationFactor: number;
+    /**
+     * IDs of nodes that hold replicas of this block
+     */
+    replicaNodeIds: string[];
+    /**
+     * Size of the block data in bytes
+     */
+    size: number;
+    /**
+     * Checksum of the block data (hex encoded)
+     */
+    checksum: string;
+}
+/**
+ * Options for storing a block with durability and replication settings
+ */
+export interface BlockStoreOptions {
+    /**
+     * When the block should expire and become eligible for cleanup.
+     * Undefined or null means the block never expires.
+     */
+    expiresAt?: Date;
+    /**
+     * The durability level for the block, determining parity block generation.
+     * Defaults to Standard if not specified.
+     */
+    durabilityLevel?: DurabilityLevel;
+    /**
+     * Target number of replicas for the block.
+     * Defaults to 0 (no replication) if not specified.
+     */
+    targetReplicationFactor?: number;
+}
+/**
+ * Result of a block recovery attempt using FEC parity data
+ */
+export interface RecoveryResult {
+    /**
+     * Whether the recovery was successful
+     */
+    success: boolean;
+    /**
+     * The recovered block data if successful
+     */
+    recoveredBlock?: RawDataBlock;
+    /**
+     * Error message if recovery failed
+     */
+    error?: string;
+}
+/**
+ * Result of a block brightening operation using XOR with random blocks.
+ * Brightening is used to implement Owner-Free storage patterns.
+ */
+export interface BrightenResult {
+    /**
+     * The checksum/ID of the resulting brightened block
+     */
+    brightenedBlockId: string;
+    /**
+     * The checksums/IDs of the random blocks used in the XOR operation
+     */
+    randomBlockIds: string[];
+    /**
+     * The checksum/ID of the original source block
+     */
+    originalBlockId: string;
+}
+/**
+ * Create default block metadata for a new block
+ * @param blockId - The block's unique identifier
+ * @param size - The size of the block data in bytes
+ * @param checksum - The checksum of the block data
+ * @param options - Optional storage options
+ * @returns Default metadata for the block
+ */
+export declare function createDefaultBlockMetadata(blockId: string, size: number, checksum: string, options?: BlockStoreOptions): IBlockMetadata;
+//# sourceMappingURL=blockMetadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blockMetadata.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/storage/blockMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;;OAGG;IACH,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,eAAe,EAAE,eAAe,CAAC;IAEjC;;OAEG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,EAAE,IAAI,CAAC;IAErB;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,CAAC;IAErC;;OAEG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,cAAc,CAAC,EAAE,YAAY,CAAC;IAE9B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,cAAc,CAgBhB"}

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultBlockMetadata = createDefaultBlockMetadata;
+const durabilityLevel_1 = require("../../enumerations/durabilityLevel");
+const replicationStatus_1 = require("../../enumerations/replicationStatus");
+/**
+ * Create default block metadata for a new block
+ * @param blockId - The block's unique identifier
+ * @param size - The size of the block data in bytes
+ * @param checksum - The checksum of the block data
+ * @param options - Optional storage options
+ * @returns Default metadata for the block
+ */
+function createDefaultBlockMetadata(blockId, size, checksum, options) {
+    const now = new Date();
+    return {
+        blockId,
+        createdAt: now,
+        expiresAt: options?.expiresAt ?? null,
+        durabilityLevel: options?.durabilityLevel ?? durabilityLevel_1.DurabilityLevel.Standard,
+        parityBlockIds: [],
+        accessCount: 0,
+        lastAccessedAt: now,
+        replicationStatus: replicationStatus_1.ReplicationStatus.Pending,
+        targetReplicationFactor: options?.targetReplicationFactor ?? 0,
+        replicaNodeIds: [],
+        size,
+        checksum,
+    };
+}
+//# sourceMappingURL=blockMetadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blockMetadata.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/storage/blockMetadata.ts"],"names":[],"mappings":";;AAgJA,gEAqBC;AApKD,wEAAqE;AACrE,4EAAyE;AAsIzE;;;;;;;GAOG;AACH,SAAgB,0BAA0B,CACxC,OAAe,EACf,IAAY,EACZ,QAAgB,EAChB,OAA2B;IAE3B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,OAAO;QACP,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI;QACrC,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,iCAAe,CAAC,QAAQ;QACrE,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,CAAC;QACd,cAAc,EAAE,GAAG;QACnB,iBAAiB,EAAE,qCAAiB,CAAC,OAAO;QAC5C,uBAAuB,EAAE,OAAO,EAAE,uBAAuB,IAAI,CAAC;QAC9D,cAAc,EAAE,EAAE;QAClB,IAAI;QACJ,QAAQ;KACT,CAAC;AACJ,CAAC"}