@brightchain/brightchain-lib 0.12.0 → 0.14.0

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;AAyC/B,oDAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/interfaces/index.ts"],"names":[],"mappings":";;;AACA,yDAA+B;AA6C/B,oDAA0B"}

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"}

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

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMailbox = createMailbox;
+exports.createAddressGroup = createAddressGroup;
+exports.isMailbox = isMailbox;
+exports.isAddressGroup = isAddressGroup;
+exports.formatMailbox = formatMailbox;
+exports.formatAddressGroup = formatAddressGroup;
+exports.formatAddress = formatAddress;
+exports.formatAddressList = formatAddressList;
+// ─── Utility Functions ──────────────────────────────────────────────────────
+/**
+ * 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"
+ * ```
+ */
+function createMailbox(localPart, domain, displayName) {
+    return {
+        localPart,
+        domain,
+        displayName,
+        get address() {
+            return `${this.localPart}@${this.domain}`;
+        },
+    };
+}
+/**
+ * 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'),
+ * ]);
+ * ```
+ */
+function createAddressGroup(displayName, mailboxes = []) {
+    return {
+        displayName,
+        mailboxes,
+    };
+}
+/**
+ * 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"
+ * }
+ * ```
+ */
+function isMailbox(address) {
+    return ('localPart' in address &&
+        'domain' in address &&
+        typeof address.localPart === 'string' &&
+        typeof address.domain === 'string');
+}
+/**
+ * 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"
+ * }
+ * ```
+ */
+function isAddressGroup(address) {
+    return ('mailboxes' in address &&
+        Array.isArray(address.mailboxes) &&
+        !('localPart' in address));
+}
+/**
+ * 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'
+ * ```
+ */
+function formatMailbox(mailbox) {
+    if (mailbox.displayName) {
+        // Use quoted-string for display name to handle special characters
+        return `"${mailbox.displayName}" <${mailbox.address}>`;
+    }
+    return mailbox.address;
+}
+/**
+ * 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;'
+ * ```
+ */
+function formatAddressGroup(group) {
+    if (group.mailboxes.length === 0) {
+        return `${group.displayName}:;`;
+    }
+    const mailboxList = group.mailboxes.map(formatMailbox).join(', ');
+    return `${group.displayName}: ${mailboxList};`;
+}
+/**
+ * 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:;'
+ * ```
+ */
+function formatAddress(address) {
+    if (isMailbox(address)) {
+        return formatMailbox(address);
+    }
+    return formatAddressGroup(address);
+}
+/**
+ * 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'
+ * ```
+ */
+function formatAddressList(addresses) {
+    return addresses.map(formatAddress).join(', ');
+}
+//# sourceMappingURL=emailAddress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emailAddress.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/messaging/emailAddress.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AA4EH,sCAaC;AAiBD,gDAQC;AAmBD,8BAOC;AAmBD,wCAMC;AAuBD,sCAMC;AAuBD,gDAMC;AAiBD,sCAKC;AAiBD,8CAEC;AA7MD,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,SAAgB,aAAa,CAC3B,SAAiB,EACjB,MAAc,EACd,WAAoB;IAEpB,OAAO;QACL,SAAS;QACT,MAAM;QACN,WAAW;QACX,IAAI,OAAO;YACT,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,kBAAkB,CAChC,WAAmB,EACnB,YAAwB,EAAE;IAE1B,OAAO;QACL,WAAW;QACX,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,SAAS,CAAC,OAAiB;IACzC,OAAO,CACL,WAAW,IAAI,OAAO;QACtB,QAAQ,IAAI,OAAO;QACnB,OAAQ,OAAoB,CAAC,SAAS,KAAK,QAAQ;QACnD,OAAQ,OAAoB,CAAC,MAAM,KAAK,QAAQ,CACjD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,cAAc,CAAC,OAAiB;IAC9C,OAAO,CACL,WAAW,IAAI,OAAO;QACtB,KAAK,CAAC,OAAO,CAAE,OAAyB,CAAC,SAAS,CAAC;QACnD,CAAC,CAAC,WAAW,IAAI,OAAO,CAAC,CAC1B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,aAAa,CAAC,OAAiB;IAC7C,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,kEAAkE;QAClE,OAAO,IAAI,OAAO,CAAC,WAAW,MAAM,OAAO,CAAC,OAAO,GAAG,CAAC;IACzD,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,kBAAkB,CAAC,KAAoB;IACrD,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,GAAG,KAAK,CAAC,WAAW,IAAI,CAAC;IAClC,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,OAAO,GAAG,KAAK,CAAC,WAAW,KAAK,WAAW,GAAG,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,aAAa,CAAC,OAAiB;IAC7C,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,kBAAkB,CAAC,OAAwB,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,iBAAiB,CAAC,SAAqB;IACrD,OAAO,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,80 @@
+/**
+ * Email delivery status tracking types.
+ *
+ * Defines the IDeliveryReceipt interface for tracking email delivery lifecycle
+ * across BrightChain nodes. The IDeliveryReceipt now uses the unified
+ * DeliveryStatus enum instead of the deprecated EmailDeliveryStatus.
+ *
+ * @see Requirements 12.1, 12.2, 12.3, 2.4, 2.5
+ * @module emailDelivery
+ */
+import { DeliveryStatus } from '../../enumerations/messaging/deliveryStatus';
+/**
+ * Delivery status states for tracking email delivery lifecycle.
+ *
+ * @deprecated Use {@link DeliveryStatus} from `../../enumerations/messaging/deliveryStatus` instead.
+ * This enum is replaced by the unified DeliveryStatus enum as part of the
+ * unified gossip delivery migration (Requirement 2.4, 2.5).
+ *
+ * Migration mapping:
+ * - Pending → DeliveryStatus.Pending
+ * - Queued → DeliveryStatus.Pending (no separate Queued state)
+ * - InTransit → DeliveryStatus.Announced
+ * - Delivered → DeliveryStatus.Delivered
+ * - Failed → DeliveryStatus.Failed
+ * - Bounced → DeliveryStatus.Bounced
+ * - Read → DeliveryStatus.Read
+ *
+ * @see Requirement 12.1
+ * @see DeliveryStatus
+ */
+export declare enum EmailDeliveryStatus {
+    /** Initial state when email is created but not yet queued for delivery */
+    Pending = "pending",
+    /** Email has been queued for delivery processing */
+    Queued = "queued",
+    /** Email blocks are being replicated to the recipient's node */
+    InTransit = "in_transit",
+    /** Email blocks have been successfully replicated to the recipient's node */
+    Delivered = "delivered",
+    /** Delivery failed after exhausting retry attempts */
+    Failed = "failed",
+    /** Email was rejected/bounced by the recipient's node */
+    Bounced = "bounced",
+    /** Recipient has read the email (read receipt received) */
+    Read = "read"
+}
+/**
+ * Delivery receipt for tracking email delivery status per recipient.
+ *
+ * Each recipient of an email has their own delivery receipt that tracks
+ * the full delivery lifecycle including timestamps and failure information.
+ *
+ * @see Requirement 12.2 - Delivery receipts with timestamps
+ * @see Requirement 12.3 - Delivery timestamps per recipient
+ */
+export interface IDeliveryReceipt {
+    /** Recipient identifier (e.g., user ID or address) */
+    recipientId: string;
+    /** Recipient's home node identifier */
+    recipientNode: string;
+    /** Current delivery status */
+    status: DeliveryStatus;
+    /** Timestamp when the email was queued for delivery */
+    queuedAt?: Date;
+    /** Timestamp when the email blocks were sent/replication initiated */
+    sentAt?: Date;
+    /** Timestamp when delivery was confirmed at the recipient's node */
+    deliveredAt?: Date;
+    /** Timestamp when the recipient read the email */
+    readAt?: Date;
+    /** Timestamp when delivery failed */
+    failedAt?: Date;
+    /** Human-readable reason for delivery failure */
+    failureReason?: string;
+    /** Machine-readable error code for delivery failure */
+    failureCode?: string;
+    /** Number of delivery retry attempts made */
+    retryCount: number;
+}
+//# sourceMappingURL=emailDelivery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emailDelivery.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/messaging/emailDelivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAE7E;;;;;;;;;;;;;;;;;;GAkBG;AACH,oBAAY,mBAAmB;IAC7B,0EAA0E;IAC1E,OAAO,YAAY;IAEnB,oDAAoD;IACpD,MAAM,WAAW;IAEjB,gEAAgE;IAChE,SAAS,eAAe;IAExB,6EAA6E;IAC7E,SAAS,cAAc;IAEvB,sDAAsD;IACtD,MAAM,WAAW;IAEjB,yDAAyD;IACzD,OAAO,YAAY;IAEnB,2DAA2D;IAC3D,IAAI,SAAS;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IAEtB,8BAA8B;IAC9B,MAAM,EAAE,cAAc,CAAC;IAIvB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEhB,sEAAsE;IACtE,MAAM,CAAC,EAAE,IAAI,CAAC;IAEd,oEAAoE;IACpE,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,kDAAkD;IAClD,MAAM,CAAC,EAAE,IAAI,CAAC;IAEd,qCAAqC;IACrC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAIhB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB"}

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

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Email delivery status tracking types.
+ *
+ * Defines the IDeliveryReceipt interface for tracking email delivery lifecycle
+ * across BrightChain nodes. The IDeliveryReceipt now uses the unified
+ * DeliveryStatus enum instead of the deprecated EmailDeliveryStatus.
+ *
+ * @see Requirements 12.1, 12.2, 12.3, 2.4, 2.5
+ * @module emailDelivery
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailDeliveryStatus = void 0;
+/**
+ * Delivery status states for tracking email delivery lifecycle.
+ *
+ * @deprecated Use {@link DeliveryStatus} from `../../enumerations/messaging/deliveryStatus` instead.
+ * This enum is replaced by the unified DeliveryStatus enum as part of the
+ * unified gossip delivery migration (Requirement 2.4, 2.5).
+ *
+ * Migration mapping:
+ * - Pending → DeliveryStatus.Pending
+ * - Queued → DeliveryStatus.Pending (no separate Queued state)
+ * - InTransit → DeliveryStatus.Announced
+ * - Delivered → DeliveryStatus.Delivered
+ * - Failed → DeliveryStatus.Failed
+ * - Bounced → DeliveryStatus.Bounced
+ * - Read → DeliveryStatus.Read
+ *
+ * @see Requirement 12.1
+ * @see DeliveryStatus
+ */
+var EmailDeliveryStatus;
+(function (EmailDeliveryStatus) {
+    /** Initial state when email is created but not yet queued for delivery */
+    EmailDeliveryStatus["Pending"] = "pending";
+    /** Email has been queued for delivery processing */
+    EmailDeliveryStatus["Queued"] = "queued";
+    /** Email blocks are being replicated to the recipient's node */
+    EmailDeliveryStatus["InTransit"] = "in_transit";
+    /** Email blocks have been successfully replicated to the recipient's node */
+    EmailDeliveryStatus["Delivered"] = "delivered";
+    /** Delivery failed after exhausting retry attempts */
+    EmailDeliveryStatus["Failed"] = "failed";
+    /** Email was rejected/bounced by the recipient's node */
+    EmailDeliveryStatus["Bounced"] = "bounced";
+    /** Recipient has read the email (read receipt received) */
+    EmailDeliveryStatus["Read"] = "read";
+})(EmailDeliveryStatus || (exports.EmailDeliveryStatus = EmailDeliveryStatus = {}));
+//# sourceMappingURL=emailDelivery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emailDelivery.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/messaging/emailDelivery.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAIH;;;;;;;;;;;;;;;;;;GAkBG;AACH,IAAY,mBAqBX;AArBD,WAAY,mBAAmB;IAC7B,0EAA0E;IAC1E,0CAAmB,CAAA;IAEnB,oDAAoD;IACpD,wCAAiB,CAAA;IAEjB,gEAAgE;IAChE,+CAAwB,CAAA;IAExB,6EAA6E;IAC7E,8CAAuB,CAAA;IAEvB,sDAAsD;IACtD,wCAAiB,CAAA;IAEjB,yDAAyD;IACzD,0CAAmB,CAAA;IAEnB,2DAA2D;IAC3D,oCAAa,CAAA;AACf,CAAC,EArBW,mBAAmB,mCAAnB,mBAAmB,QAqB9B"}