@brightchain/brightchain-lib 0.14.0 → 0.16.0

package/src/lib/interfaces/identity/deviceKeyStorage.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Device key storage interface for the BrightChain identity system.
+ *
+ * Provides a platform-independent abstraction for storing and retrieving
+ * device keys. Implementations can target Node.js file system, browser
+ * IndexedDB, React Native secure storage, or any other platform-specific
+ * secure storage mechanism.
+ *
+ * This interface is generic over TId to support both string-based DTOs
+ * (frontend) and GuidV4Buffer (backend) usage patterns.
+ *
+ * Requirements: 3.4
+ */
+import { IDeviceMetadata } from './device';
+/**
+ * Platform-independent interface for secure device key storage.
+ *
+ * Implementations must ensure that private key material is stored
+ * securely (encrypted at rest) and that retrieval requires appropriate
+ * authentication or authorization.
+ *
+ * @example
+ * ```typescript
+ * // Node.js implementation
+ * class NodeDeviceKeyStorage implements IDeviceKeyStorage {
+ *   async store(deviceMetadata: IDeviceMetadata): Promise<void> {
+ *     // Write encrypted key data to disk
+ *   }
+ *   async retrieve(deviceId: string): Promise<IDeviceMetadata | undefined> {
+ *     // Read and decrypt key data from disk
+ *   }
+ *   async remove(deviceId: string): Promise<boolean> {
+ *     // Delete key data from disk
+ *   }
+ *   async list(memberId: string): Promise<ReadonlyArray<IDeviceMetadata>> {
+ *     // List all device metadata for a member
+ *   }
+ * }
+ * ```
+ */
+export interface IDeviceKeyStorage<TId = string> {
+    /**
+     * Store device metadata (including public key reference) in secure storage.
+     *
+     * @param deviceMetadata - The device metadata to persist
+     * @throws If storage fails (e.g. disk full, permission denied)
+     */
+    store(deviceMetadata: IDeviceMetadata<TId>): Promise<void>;
+    /**
+     * Retrieve device metadata by device ID.
+     *
+     * @param deviceId - The unique device identifier
+     * @returns The device metadata, or `undefined` if not found
+     */
+    retrieve(deviceId: TId): Promise<IDeviceMetadata<TId> | undefined>;
+    /**
+     * Remove device metadata from storage.
+     *
+     * @param deviceId - The unique device identifier to remove
+     * @returns `true` if the device was found and removed, `false` otherwise
+     */
+    remove(deviceId: TId): Promise<boolean>;
+    /**
+     * List all stored device metadata for a given member.
+     *
+     * @param memberId - The member whose devices to list
+     * @returns Array of device metadata records
+     */
+    list(memberId: TId): Promise<ReadonlyArray<IDeviceMetadata<TId>>>;
+}
+//# sourceMappingURL=deviceKeyStorage.d.ts.map

package/src/lib/interfaces/identity/deviceKeyStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceKeyStorage.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/identity/deviceKeyStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,iBAAiB,CAAC,GAAG,GAAG,MAAM;IAC7C;;;;;OAKG;IACH,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAEnE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACnE"}

package/src/lib/interfaces/identity/deviceKeyStorage.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Device key storage interface for the BrightChain identity system.
+ *
+ * Provides a platform-independent abstraction for storing and retrieving
+ * device keys. Implementations can target Node.js file system, browser
+ * IndexedDB, React Native secure storage, or any other platform-specific
+ * secure storage mechanism.
+ *
+ * This interface is generic over TId to support both string-based DTOs
+ * (frontend) and GuidV4Buffer (backend) usage patterns.
+ *
+ * Requirements: 3.4
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=deviceKeyStorage.js.map

package/src/lib/interfaces/identity/deviceKeyStorage.js.map

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

package/src/lib/interfaces/identity/identityProof.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Identity proof interfaces for the BrightChain identity system.
+ *
+ * Identity proofs cryptographically link a BrightChain member to an
+ * external platform account (e.g. Twitter, GitHub, a personal website,
+ * or a blockchain address). Each proof contains a signed statement
+ * that can be independently verified by anyone with the member's
+ * public key.
+ *
+ * All data interfaces are generic over TId so the same interface
+ * can serve as a DTO for React clients (string) and as the concrete
+ * type used inside Node services (GuidV4Buffer / Uint8Array).
+ *
+ * Requirements: 4.5
+ */
+import { ProofPlatform } from '../../enumerations/proofPlatform';
+import { VerificationStatus } from '../../enumerations/verificationStatus';
+/**
+ * Metadata and cryptographic data for a single identity proof.
+ *
+ * @remarks
+ * An identity proof is created when a member signs a statement claiming
+ * ownership of an external account. The signed statement is posted
+ * publicly on the target platform, and the proof URL points to that
+ * posting. The system periodically re-verifies proofs by fetching the
+ * URL and checking that the signed statement is still present
+ * (Requirement 4.10).
+ *
+ * @example
+ * ```typescript
+ * const proof: IIdentityProof = {
+ *   id: 'proof-abc-123',
+ *   memberId: 'member-xyz',
+ *   platform: ProofPlatform.GITHUB,
+ *   username: 'octocat',
+ *   proofUrl: 'https://gist.github.com/octocat/abc123',
+ *   signedStatement: 'I am octocat on github. My BrightChain ID is member-xyz. Timestamp: 2024-01-01T00:00:00.000Z',
+ *   signature: '304402...',
+ *   createdAt: new Date(),
+ *   verifiedAt: new Date(),
+ *   verificationStatus: VerificationStatus.VERIFIED,
+ * };
+ * ```
+ */
+export interface IIdentityProof<TId = string> {
+    /** Unique identifier for this identity proof record */
+    id: TId;
+    /** Identifier of the member who created this proof */
+    memberId: TId;
+    /** The external platform this proof targets */
+    platform: ProofPlatform;
+    /** The member's username on the external platform */
+    username: string;
+    /**
+     * URL where the signed statement has been posted publicly.
+     * @remarks Empty string until the member provides the URL after posting.
+     */
+    proofUrl: string;
+    /**
+     * The plaintext statement that was signed.
+     * @remarks Format: "I am {username} on {platform}. My BrightChain ID is {memberId}. Timestamp: {ISO8601}"
+     * per Requirement 4.8.
+     */
+    signedStatement: string;
+    /**
+     * ECDSA signature of the signed statement (hex-encoded).
+     * @remarks Produced using the member's SECP256k1 private key per Requirement 4.3.
+     */
+    signature: string;
+    /** Timestamp when the proof was created */
+    createdAt: Date;
+    /**
+     * Timestamp when the proof was last successfully verified.
+     * @remarks Set when the proof URL is fetched and the signed statement is found.
+     */
+    verifiedAt?: Date;
+    /**
+     * Timestamp when the proof was revoked by the member.
+     * @remarks Once revoked, the proof is no longer considered valid.
+     */
+    revokedAt?: Date;
+    /**
+     * Timestamp when the proof URL was last checked for validity.
+     * @remarks Updated by the periodic re-verification process (Requirement 4.10).
+     */
+    lastCheckedAt?: Date;
+    /** Current verification lifecycle state of this proof */
+    verificationStatus: VerificationStatus;
+}
+//# sourceMappingURL=identityProof.d.ts.map

package/src/lib/interfaces/identity/identityProof.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identityProof.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/identity/identityProof.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,cAAc,CAAC,GAAG,GAAG,MAAM;IAC1C,uDAAuD;IACvD,EAAE,EAAE,GAAG,CAAC;IAER,sDAAsD;IACtD,QAAQ,EAAE,GAAG,CAAC;IAEd,+CAA+C;IAC/C,QAAQ,EAAE,aAAa,CAAC;IAExB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,2CAA2C;IAC3C,SAAS,EAAE,IAAI,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,EAAE,IAAI,CAAC;IAErB,yDAAyD;IACzD,kBAAkB,EAAE,kBAAkB,CAAC;CACxC"}

package/src/lib/interfaces/identity/identityProof.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Identity proof interfaces for the BrightChain identity system.
+ *
+ * Identity proofs cryptographically link a BrightChain member to an
+ * external platform account (e.g. Twitter, GitHub, a personal website,
+ * or a blockchain address). Each proof contains a signed statement
+ * that can be independently verified by anyone with the member's
+ * public key.
+ *
+ * All data interfaces are generic over TId so the same interface
+ * can serve as a DTO for React clients (string) and as the concrete
+ * type used inside Node services (GuidV4Buffer / Uint8Array).
+ *
+ * Requirements: 4.5
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=identityProof.js.map

package/src/lib/interfaces/identity/identityProof.js.map

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

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

@@ -0,0 +1,7 @@
+export type * from './device';
+export type * from './deviceKeyStorage';
+export type * from './identityProof';
+export type * from './paperKey';
+export type * from './publicProfile';
+export type * from './splitPaperKey';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/identity/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,UAAU,CAAC;AAC9B,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,iBAAiB,CAAC"}

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

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

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

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

package/src/lib/interfaces/identity/paperKey.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Paper key interfaces for the BrightChain identity system.
+ *
+ * Paper keys are 24-word BIP39 mnemonics used for account backup,
+ * device provisioning, and recovery. These interfaces define the
+ * metadata tracked for each paper key and the printable template
+ * generated for secure offline storage.
+ *
+ * All data interfaces are generic over TId so the same interface
+ * can serve as a DTO for React clients (string) and as the concrete
+ * type used inside Node services (GuidV4Buffer / Uint8Array).
+ *
+ * Requirements: 1.4, 1.5
+ */
+import { PaperKeyPurpose } from '../../enumerations/paperKeyPurpose';
+/**
+ * Metadata tracked for each paper key throughout its lifecycle.
+ *
+ * @remarks
+ * Every generated paper key has an associated metadata record that
+ * tracks creation, usage, revocation, and purpose. This enables
+ * audit logging and lifecycle management per Requirements 1.5, 1.6, 1.7.
+ *
+ * @example
+ * ```typescript
+ * const metadata: IPaperKeyMetadata = {
+ *   id: 'pk-abc-123',
+ *   createdAt: new Date(),
+ *   purpose: PaperKeyPurpose.BACKUP,
+ * };
+ * ```
+ */
+export interface IPaperKeyMetadata<TId = string> {
+    /** Unique identifier for this paper key record */
+    id: TId;
+    /** Timestamp when the paper key was generated */
+    createdAt: Date;
+    /**
+     * Timestamp when the paper key was used (e.g. for device provisioning)
+     * @remarks Set by markPaperKeyUsed() after successful use
+     */
+    usedAt?: Date;
+    /**
+     * Timestamp when the paper key was revoked
+     * @remarks Once revoked, the paper key can no longer be used for recovery
+     */
+    revokedAt?: Date;
+    /** The intended purpose of this paper key */
+    purpose: PaperKeyPurpose;
+    /**
+     * Identifier of the device provisioned with this paper key
+     * @remarks Only set when purpose is DEVICE_PROVISIONING
+     */
+    deviceId?: TId;
+}
+/**
+ * Printable paper key template for secure offline storage.
+ *
+ * @remarks
+ * Generated by the Paper Key Service, this template contains everything
+ * needed to produce a physical backup: the mnemonic words, a QR code
+ * for mobile scanning, and security warnings per Requirements 1.4, 1.8, 1.10.
+ *
+ * The template is intended to be rendered once and printed—never stored
+ * digitally after generation.
+ *
+ * @example
+ * ```typescript
+ * const template: IPaperKeyTemplate = {
+ *   words: ['abandon', 'ability', ...], // 24 words
+ *   qrCode: 'data:image/png;base64,...',
+ *   createdAt: new Date(),
+ *   memberId: 'member-xyz',
+ *   instructions: 'Store this paper key in a secure location.',
+ *   warnings: [
+ *     'Anyone with this paper key can access your account',
+ *     'Do not store digitally or photograph',
+ *     'Consider splitting among trusted parties',
+ *   ],
+ * };
+ * ```
+ */
+export interface IPaperKeyTemplate<TId = string> {
+    /** The 24 BIP39 mnemonic words comprising the paper key */
+    words: string[];
+    /** QR code encoding the mnemonic, as a data URL for printing/scanning */
+    qrCode: string;
+    /** Timestamp when this template was generated */
+    createdAt: Date;
+    /** Identifier of the member this paper key belongs to */
+    memberId: TId;
+    /** Human-readable instructions for storing the paper key */
+    instructions: string;
+    /** Security warnings to display on the printed template */
+    warnings: string[];
+}
+//# sourceMappingURL=paperKey.d.ts.map

package/src/lib/interfaces/identity/paperKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paperKey.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/identity/paperKey.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,iBAAiB,CAAC,GAAG,GAAG,MAAM;IAC7C,kDAAkD;IAClD,EAAE,EAAE,GAAG,CAAC;IAER,iDAAiD;IACjD,SAAS,EAAE,IAAI,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IAEd;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,6CAA6C;IAC7C,OAAO,EAAE,eAAe,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,iBAAiB,CAAC,GAAG,GAAG,MAAM;IAC7C,2DAA2D;IAC3D,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,SAAS,EAAE,IAAI,CAAC;IAEhB,yDAAyD;IACzD,QAAQ,EAAE,GAAG,CAAC;IAEd,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IAErB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/src/lib/interfaces/identity/paperKey.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Paper key interfaces for the BrightChain identity system.
+ *
+ * Paper keys are 24-word BIP39 mnemonics used for account backup,
+ * device provisioning, and recovery. These interfaces define the
+ * metadata tracked for each paper key and the printable template
+ * generated for secure offline storage.
+ *
+ * All data interfaces are generic over TId so the same interface
+ * can serve as a DTO for React clients (string) and as the concrete
+ * type used inside Node services (GuidV4Buffer / Uint8Array).
+ *
+ * Requirements: 1.4, 1.5
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=paperKey.js.map

package/src/lib/interfaces/identity/paperKey.js.map

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

package/src/lib/interfaces/identity/publicProfile.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Public profile interfaces for the BrightChain identity system.
+ *
+ * A public profile represents a member's presence in the Public Key
+ * Directory. It aggregates the member's display name, public key,
+ * verified identity proofs, and optional Ethereum address into a
+ * single searchable record. Members may opt out of directory listing
+ * via the privacy mode flag.
+ *
+ * All data interfaces are generic over TId so the same interface
+ * can serve as a DTO for React clients (string) and as the concrete
+ * type used inside Node services (GuidV4Buffer / Uint8Array).
+ *
+ * Requirements: 5.1
+ */
+import { IIdentityProof } from './identityProof';
+/**
+ * A member's public-facing profile in the Public Key Directory.
+ *
+ * @remarks
+ * The Public Key Directory stores public profiles that can be searched
+ * by display name, social username, or member ID (Requirement 5.2).
+ * Each profile includes the member's SECP256k1 public key and any
+ * verified identity proofs, enabling encrypted communication and
+ * cross-platform identity verification.
+ *
+ * When {@link privacyMode} is `true` the profile is excluded from
+ * search results (Requirement 5.9), though it may still be accessed
+ * directly by member ID for existing contacts.
+ *
+ * @example
+ * ```typescript
+ * const profile: IPublicProfile = {
+ *   memberId: 'member-xyz',
+ *   displayName: 'Alice',
+ *   publicKey: '04abcdef...',
+ *   identityProofs: [],
+ *   createdAt: new Date(),
+ *   updatedAt: new Date(),
+ *   privacyMode: false,
+ * };
+ * ```
+ */
+export interface IPublicProfile<TId = string> {
+    /** Unique identifier of the member this profile belongs to */
+    memberId: TId;
+    /** Human-readable display name shown in directory listings and search results */
+    displayName: string;
+    /** SECP256k1 public key in hex-encoded format, used for encrypted communication */
+    publicKey: string;
+    /**
+     * Identity proofs linked to this profile.
+     * @remarks Only verified proofs are included in search results (Requirement 5.4).
+     */
+    identityProofs: IIdentityProof<TId>[];
+    /**
+     * Checksummed Ethereum address (EIP-55) linked to this member's identity.
+     * @remarks Populated when the member derives an Ethereum wallet (Requirement 6.6).
+     */
+    ethereumAddress?: string;
+    /** Timestamp when the profile was first created in the directory */
+    createdAt: Date;
+    /**
+     * Timestamp when the profile was last updated.
+     * @remarks Updated whenever identity proofs are added or revoked (Requirement 5.8).
+     */
+    updatedAt: Date;
+    /**
+     * When `true`, this profile is excluded from directory search results.
+     * @remarks Members may toggle this to opt out of public listing (Requirement 5.6).
+     */
+    privacyMode: boolean;
+}
+//# sourceMappingURL=publicProfile.d.ts.map

package/src/lib/interfaces/identity/publicProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicProfile.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/identity/publicProfile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,cAAc,CAAC,GAAG,GAAG,MAAM;IAC1C,8DAA8D;IAC9D,QAAQ,EAAE,GAAG,CAAC;IAEd,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IAEpB,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,cAAc,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;IAEtC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,oEAAoE;IACpE,SAAS,EAAE,IAAI,CAAC;IAEhB;;;OAGG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/src/lib/interfaces/identity/publicProfile.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Public profile interfaces for the BrightChain identity system.
+ *
+ * A public profile represents a member's presence in the Public Key
+ * Directory. It aggregates the member's display name, public key,
+ * verified identity proofs, and optional Ethereum address into a
+ * single searchable record. Members may opt out of directory listing
+ * via the privacy mode flag.
+ *
+ * All data interfaces are generic over TId so the same interface
+ * can serve as a DTO for React clients (string) and as the concrete
+ * type used inside Node services (GuidV4Buffer / Uint8Array).
+ *
+ * Requirements: 5.1
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=publicProfile.js.map

package/src/lib/interfaces/identity/publicProfile.js.map

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

package/src/lib/interfaces/identity/splitPaperKey.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Split paper key interfaces for the BrightChain identity system.
+ *
+ * Split paper keys use Shamir's Secret Sharing to divide a 24-word
+ * BIP39 mnemonic into N shares with a configurable threshold T.
+ * Any T shares can reconstruct the original paper key, but fewer
+ * than T shares reveal no information about it.
+ *
+ * Each share is itself encoded as BIP39 words for human readability
+ * and includes a QR code for convenient mobile scanning.
+ *
+ * All data interfaces are generic over TId so the same interface
+ * can serve as a DTO for React clients (string) and as the concrete
+ * type used inside Node services (GuidV4Buffer / Uint8Array).
+ *
+ * Requirements: 2.7
+ */
+/**
+ * Printable template for a single Shamir's Secret Sharing share
+ * of a split paper key.
+ *
+ * @remarks
+ * Generated by the Split Paper Key Service, each share template
+ * contains the BIP39-encoded share words, a QR code for scanning,
+ * and human-readable instructions that include the share number,
+ * total share count, and reconstruction threshold.
+ *
+ * Share templates are intended to be printed and distributed to
+ * trusted parties—never stored digitally after generation.
+ *
+ * @example
+ * ```typescript
+ * const share: ISplitPaperKeyShare = {
+ *   shareNumber: 1,
+ *   totalShares: 3,
+ *   threshold: 2,
+ *   words: ['abandon', 'ability', ...], // BIP39-encoded share
+ *   qrCode: 'data:image/png;base64,...',
+ *   createdAt: new Date(),
+ *   instructions: 'This is share 1 of 3. You need 2 shares to recover your account.',
+ * };
+ * ```
+ */
+export interface ISplitPaperKeyShare {
+    /** Sequential number of this share (1-based, e.g. 1 of 3) */
+    shareNumber: number;
+    /** Total number of shares the paper key was split into */
+    totalShares: number;
+    /**
+     * Minimum number of shares required to reconstruct the paper key.
+     *
+     * @remarks
+     * Must satisfy 2 ≤ threshold ≤ totalShares. Fewer than threshold
+     * shares reveal no information about the original paper key.
+     */
+    threshold: number;
+    /** BIP39-encoded words representing this share's secret data */
+    words: string[];
+    /** QR code encoding the share words, as a data URL for printing/scanning */
+    qrCode: string;
+    /** Timestamp when this share template was generated */
+    createdAt: Date;
+    /**
+     * Human-readable instructions for the share holder.
+     *
+     * @remarks
+     * Typically includes the share number, total shares, and threshold
+     * so the holder understands how many collaborators are needed for
+     * reconstruction.
+     */
+    instructions: string;
+}
+//# sourceMappingURL=splitPaperKey.d.ts.map

package/src/lib/interfaces/identity/splitPaperKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitPaperKey.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/identity/splitPaperKey.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IAEpB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,gEAAgE;IAChE,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,SAAS,EAAE,IAAI,CAAC;IAEhB;;;;;;;OAOG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/src/lib/interfaces/identity/splitPaperKey.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Split paper key interfaces for the BrightChain identity system.
+ *
+ * Split paper keys use Shamir's Secret Sharing to divide a 24-word
+ * BIP39 mnemonic into N shares with a configurable threshold T.
+ * Any T shares can reconstruct the original paper key, but fewer
+ * than T shares reveal no information about it.
+ *
+ * Each share is itself encoded as BIP39 words for human readability
+ * and includes a QR code for convenient mobile scanning.
+ *
+ * All data interfaces are generic over TId so the same interface
+ * can serve as a DTO for React clients (string) and as the concrete
+ * type used inside Node services (GuidV4Buffer / Uint8Array).
+ *
+ * Requirements: 2.7
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=splitPaperKey.js.map

package/src/lib/interfaces/identity/splitPaperKey.js.map

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

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

@@ -19,14 +19,16 @@ export type * from './dto';
 export type * from './encryptionConsts';
 export type * from './encryptionLength';
 export type * from './energyTransaction';
+export type { IFailableResult } from './failableResult';
 export type * from './handleableErrorOptions';
+export type * from './i18nConstants';
 export type * from './jsonStore';
 export type * from './keyringConsts';
 export type * from './keyringEntry';
 export type * from './languageContext';
 export type * from './member';
 export type * from './membersHandlers';
-export type * from './network';
+export * from './network';
 export type * from './nodeInfo';
 export type * from './position';
 export type * from './privateVotingDerivation';
@@ -34,6 +36,7 @@ export type * from './quoromDataRecordActionLog';
 export type * from './readOnlyBasicObjectDto';
 export type * from './readOnlyDataObjectDto';
 export type * from './replicationNodeResult';
+export type * from './requests';
 export type * from './requestUser';
 export type * from './responses';
 export type * from './role';
@@ -51,5 +54,12 @@ export type * from './tokenUser';
 export type * from './tuple';
 export type * from './tupleConfig';
 export type * from './walletSeed';
-export type * from './messaging';
+export * from './messaging';
+export type * from './identity';
+export type * from './communication';
+export type * from './communicationEvents';
+export * from './brightpass';
+export * from './events';
+export * from './blockFetch';
+export * from './auth';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,kBAAkB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,UAAU,CAAC;AAC9B,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,OAAO,CAAC;AAC3B,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,0BAA0B,CAAC;AAC9C,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,UAAU,CAAC;AAC9B,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,6BAA6B,CAAC;AACjD,mBAAmB,0BAA0B,CAAC;AAC9C,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,QAAQ,CAAC;AAC5B,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,6BAA6B,CAAC;AACjD,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,+BAA+B,CAAC;AACnD,cAAc,WAAW,CAAC;AAC1B,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,8BAA8B,CAAC;AAClD,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,SAAS,CAAC;AAC7B,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,cAAc,CAAC;AAGlC,mBAAmB,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,kBAAkB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,UAAU,CAAC;AAC9B,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,OAAO,CAAC;AAC3B,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,mBAAmB,0BAA0B,CAAC;AAC9C,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,UAAU,CAAC;AAC9B,mBAAmB,mBAAmB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,6BAA6B,CAAC;AACjD,mBAAmB,0BAA0B,CAAC;AAC9C,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,QAAQ,CAAC;AAC5B,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,6BAA6B,CAAC;AACjD,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,+BAA+B,CAAC;AACnD,cAAc,WAAW,CAAC;AAC1B,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,8BAA8B,CAAC;AAClD,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,SAAS,CAAC;AAC7B,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,cAAc,CAAC;AAGlC,cAAc,aAAa,CAAC;AAG5B,mBAAmB,YAAY,CAAC;AAGhC,mBAAmB,iBAAiB,CAAC;AAGrC,mBAAmB,uBAAuB,CAAC;AAG3C,cAAc,cAAc,CAAC;AAG7B,cAAc,UAAU,CAAC;AAGzB,cAAc,cAAc,CAAC;AAI7B,cAAc,QAAQ,CAAC"}

package/src/lib/interfaces/index.js

@@ -2,5 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./availability"), exports);
+tslib_1.__exportStar(require("./network"), exports);
 tslib_1.__exportStar(require("./storage"), exports);
+// Message passing interfaces (uses `export *` because messaging contains runtime functions like createMailbox)
+tslib_1.__exportStar(require("./messaging"), exports);
+// BrightPass password manager interfaces
+tslib_1.__exportStar(require("./brightpass"), exports);
+// Communication event emitter abstraction (real-time event system)
+tslib_1.__exportStar(require("./events"), exports);
+// Block fetch interfaces (remote block retrieval)
+tslib_1.__exportStar(require("./blockFetch"), exports);
+// Auth interfaces (node authentication, pool ACL)
+// Uses `export *` because auth contains runtime values (PoolPermission enum, hasPermission, hasQuorum)
+tslib_1.__exportStar(require("./auth"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/index.ts"],"names":[],"mappings":";;;AACA,yDAA+B;AA6C/B,oDAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/index.ts"],"names":[],"mappings":";;;AACA,yDAA+B;AA6B/B,oDAA0B;AAmB1B,oDAA0B;AAQ1B,+GAA+G;AAC/G,sDAA4B;AAW5B,yCAAyC;AACzC,uDAA6B;AAE7B,mEAAmE;AACnE,mDAAyB;AAEzB,kDAAkD;AAClD,uDAA6B;AAE7B,kDAAkD;AAClD,uGAAuG;AACvG,iDAAuB"}

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

@@ -8,11 +8,13 @@ import { NodeConfig } from './nodeConfig';
 import { NodeLocation } from './nodeLocation';
 import { NodeResources } from './nodeResources';
 /**
- * Core node interface
+ * Core node interface.
+ *
+ * Uses Uint8Array for browser compatibility (Requirement 18.6).
  */
 export interface INode {
     id: GuidV4Uint8Array;
-    publicKey: Buffer;
+    publicKey: Uint8Array;
     version: string;
     status: NodeStatus;
     capabilities: Set<NodeCapability>;