@brightchain/brightchain-lib 0.13.0 → 0.15.0

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,6 +19,7 @@ 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 './jsonStore';
 export type * from './keyringConsts';
@@ -26,7 +27,7 @@ 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 +35,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 +53,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,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;AA4B/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/messaging/attachmentMetadata.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Attachment metadata with CBL storage reference.
+ *
+ * Represents the metadata for a file attached to an email message,
+ * including storage references to the BrightChain ExtendedCBL blocks
+ * and integrity verification fields.
+ *
+ * @remarks
+ * Attachments are stored as separate blocks using the ExtendedCBL structure.
+ * The `cblMagnetUrl` provides a magnet URL for retrieving the attachment,
+ * while `blockIds` lists the constituent block IDs that make up the attachment.
+ *
+ * Integrity is verified via SHA-3 checksum and optionally via MD5 per RFC 1864.
+ *
+ * @see Requirements 8.1, 8.3, 8.10
+ */
+export interface IAttachmentMetadata {
+    /** Original filename of the attachment */
+    filename: string;
+    /** MIME type of the attachment (e.g., 'application/pdf', 'image/png') */
+    mimeType: string;
+    /** Size of the attachment in bytes */
+    size: number;
+    /**
+     * Content-ID for inline attachments.
+     * Used to reference the attachment from within HTML email content
+     * (e.g., embedded images). Format: `<id>` per RFC 2045.
+     */
+    contentId?: string;
+    /**
+     * ExtendedCBL magnet URL for retrieving the attachment.
+     * Provides a URI-based reference to the attachment's CBL storage.
+     */
+    cblMagnetUrl: string;
+    /** Constituent block IDs that make up the attachment in the CBL */
+    blockIds: string[];
+    /** SHA-3 checksum for verifying attachment integrity */
+    checksum: string;
+    /**
+     * Optional MD5 checksum for Content-MD5 header per RFC 1864.
+     * Provides backward-compatible integrity verification.
+     *
+     * @see Requirement 8.10
+     */
+    contentMd5?: string;
+}
+//# sourceMappingURL=attachmentMetadata.d.ts.map

package/src/lib/interfaces/messaging/attachmentMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentMetadata.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/messaging/attachmentMetadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IAEjB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAInB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAInB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/src/lib/interfaces/messaging/attachmentMetadata.js

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

package/src/lib/interfaces/messaging/attachmentMetadata.js.map

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

package/src/lib/interfaces/messaging/emailAddress.d.ts

@@ -0,0 +1,210 @@
+/**
+ * RFC 5322 Email Address Interfaces and Utilities
+ *
+ * Provides interfaces for representing email addresses per RFC 5322 Section 3.4,
+ * including individual mailboxes (addr-spec and name-addr formats) and group
+ * addresses. Also provides utility functions for creating, formatting, and
+ * type-guarding address objects.
+ *
+ * @see RFC 5322 Section 3.4 - Address Specification
+ * @see RFC 5321 - Address length limits
+ * @see RFC 6532 - Internationalized Email Headers (UTF-8)
+ *
+ * @remarks
+ * Requirements: 2.1, 2.2, 2.3, 2.4
+ */
+/**
+ * RFC 5322 mailbox representation.
+ * Supports both simple addr-spec and name-addr formats.
+ *
+ * A mailbox represents a single email address, optionally with a display name.
+ * The addr-spec is composed of localPart@domain.
+ *
+ * Examples:
+ * - Simple: `user@example.com` (no display name)
+ * - Name-addr: `John Doe <john@example.com>`
+ * - Quoted local-part: `"john.doe"@example.com`
+ *
+ * @see RFC 5322 Section 3.4
+ * @see Requirement 2.1 - Parse mailbox addresses
+ * @see Requirement 2.2 - Parse addr-spec as local-part@domain
+ */
+export interface IMailbox {
+    /** Optional display name (e.g., "John Doe") */
+    displayName?: string;
+    /** Local part before @ (e.g., "john.doe" or quoted "john doe") */
+    localPart: string;
+    /** Domain after @ (e.g., "example.com") */
+    domain: string;
+    /** Full addr-spec: localPart@domain (computed/readonly) */
+    readonly address: string;
+}
+/**
+ * RFC 5322 group address representation.
+ *
+ * A group address has a display name followed by a colon, an optional
+ * list of mailboxes, and a semicolon:
+ *   display-name ":" [mailbox-list] ";"
+ *
+ * Example: `Team: alice@example.com, bob@example.com;`
+ *
+ * @see RFC 5322 Section 3.4
+ * @see Requirement 2.4 - Support group addresses
+ */
+export interface IAddressGroup {
+    /** Group display name (required for groups) */
+    displayName: string;
+    /** Group members (can be empty for undisclosed recipients) */
+    mailboxes: IMailbox[];
+}
+/**
+ * Union type representing either a single mailbox or a group address.
+ *
+ * @see RFC 5322 Section 3.4
+ */
+export type IAddress = IMailbox | IAddressGroup;
+/**
+ * Creates an IMailbox object with a computed `address` property.
+ *
+ * @param localPart - The local part of the email address (before @)
+ * @param domain - The domain of the email address (after @)
+ * @param displayName - Optional display name
+ * @returns A fully constructed IMailbox with computed address getter
+ *
+ * @example
+ * ```typescript
+ * const mailbox = createMailbox('john', 'example.com', 'John Doe');
+ * console.log(mailbox.address); // "john@example.com"
+ * console.log(mailbox.displayName); // "John Doe"
+ * ```
+ */
+export declare function createMailbox(localPart: string, domain: string, displayName?: string): IMailbox;
+/**
+ * Creates an IAddressGroup object.
+ *
+ * @param displayName - The group display name
+ * @param mailboxes - Array of mailboxes in the group (defaults to empty)
+ * @returns A fully constructed IAddressGroup
+ *
+ * @example
+ * ```typescript
+ * const group = createAddressGroup('Team', [
+ *   createMailbox('alice', 'example.com'),
+ *   createMailbox('bob', 'example.com'),
+ * ]);
+ * ```
+ */
+export declare function createAddressGroup(displayName: string, mailboxes?: IMailbox[]): IAddressGroup;
+/**
+ * Type guard to check if an IAddress is an IMailbox.
+ *
+ * Distinguishes mailboxes from groups by checking for the presence of
+ * `localPart` and `domain` properties (which are unique to IMailbox).
+ *
+ * @param address - The address to check
+ * @returns true if the address is an IMailbox
+ *
+ * @example
+ * ```typescript
+ * const addr: IAddress = createMailbox('user', 'example.com');
+ * if (isMailbox(addr)) {
+ *   console.log(addr.address); // "user@example.com"
+ * }
+ * ```
+ */
+export declare function isMailbox(address: IAddress): address is IMailbox;
+/**
+ * Type guard to check if an IAddress is an IAddressGroup.
+ *
+ * Distinguishes groups from mailboxes by checking for the presence of
+ * the `mailboxes` array property (which is unique to IAddressGroup).
+ *
+ * @param address - The address to check
+ * @returns true if the address is an IAddressGroup
+ *
+ * @example
+ * ```typescript
+ * const addr: IAddress = createAddressGroup('Team', []);
+ * if (isAddressGroup(addr)) {
+ *   console.log(addr.displayName); // "Team"
+ * }
+ * ```
+ */
+export declare function isAddressGroup(address: IAddress): address is IAddressGroup;
+/**
+ * Formats an IMailbox as an RFC 5322 compliant string.
+ *
+ * If a display name is present, formats as name-addr: `"Display Name" <local@domain>`
+ * Otherwise, formats as addr-spec: `local@domain`
+ *
+ * @param mailbox - The mailbox to format
+ * @returns RFC 5322 formatted mailbox string
+ *
+ * @see RFC 5322 Section 3.4
+ * @see Requirement 2.1
+ *
+ * @example
+ * ```typescript
+ * formatMailbox(createMailbox('john', 'example.com', 'John Doe'));
+ * // => '"John Doe" <john@example.com>'
+ *
+ * formatMailbox(createMailbox('john', 'example.com'));
+ * // => 'john@example.com'
+ * ```
+ */
+export declare function formatMailbox(mailbox: IMailbox): string;
+/**
+ * Formats an IAddressGroup as an RFC 5322 compliant string.
+ *
+ * Formats as: `display-name: mailbox-list;`
+ * For empty groups: `display-name:;`
+ *
+ * @param group - The address group to format
+ * @returns RFC 5322 formatted group address string
+ *
+ * @see RFC 5322 Section 3.4
+ * @see Requirement 2.4
+ *
+ * @example
+ * ```typescript
+ * formatAddressGroup(createAddressGroup('Team', [
+ *   createMailbox('alice', 'example.com'),
+ *   createMailbox('bob', 'example.com'),
+ * ]));
+ * // => 'Team: alice@example.com, bob@example.com;'
+ * ```
+ */
+export declare function formatAddressGroup(group: IAddressGroup): string;
+/**
+ * Formats an IAddress (either mailbox or group) as an RFC 5322 compliant string.
+ *
+ * @param address - The address to format
+ * @returns RFC 5322 formatted address string
+ *
+ * @example
+ * ```typescript
+ * formatAddress(createMailbox('user', 'example.com'));
+ * // => 'user@example.com'
+ *
+ * formatAddress(createAddressGroup('Team', []));
+ * // => 'Team:;'
+ * ```
+ */
+export declare function formatAddress(address: IAddress): string;
+/**
+ * Formats an array of IAddress objects as a comma-separated RFC 5322 address list.
+ *
+ * @param addresses - Array of addresses to format
+ * @returns Comma-separated RFC 5322 formatted address list string
+ *
+ * @example
+ * ```typescript
+ * formatAddressList([
+ *   createMailbox('alice', 'example.com', 'Alice'),
+ *   createMailbox('bob', 'example.com'),
+ * ]);
+ * // => '"Alice" <alice@example.com>, bob@example.com'
+ * ```
+ */
+export declare function formatAddressList(addresses: IAddress[]): string;
+//# sourceMappingURL=emailAddress.d.ts.map

package/src/lib/interfaces/messaging/emailAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailAddress.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/messaging/emailAddress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAElB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IAEf,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IAEpB,8DAA8D;IAC9D,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAIhD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,QAAQ,CASV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,QAAQ,EAAO,GACzB,aAAa,CAKf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,IAAI,QAAQ,CAOhE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,IAAI,aAAa,CAM1E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAMvD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAM/D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAKvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAE/D"}