@brightchain/brightchain-api-lib 0.13.0 → 0.15.0

package/src/lib/services/expirationScheduler.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * ExpirationScheduler — Background job for cleaning up expired messages.
+ *
+ * Periodically scans messages for time-based and read-count-based
+ * expiration, explodes expired messages, and emits events for
+ * downstream consumers (e.g., WebSocket notifications).
+ *
+ * This is a Node.js-specific service that lives in brightchain-api-lib.
+ *
+ * Requirements: 8.4, 8.6, 8.9
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpirationScheduler = exports.ExpirationSchedulerEvent = void 0;
+const explodingMessageService_1 = require("@brightchain/brightchain-lib/lib/services/communication/explodingMessageService");
+const events_1 = require("events");
+// ─── Events ─────────────────────────────────────────────────────────────────
+var ExpirationSchedulerEvent;
+(function (ExpirationSchedulerEvent) {
+    /** Emitted when a message is exploded by the scheduler */
+    ExpirationSchedulerEvent["MESSAGE_EXPLODED"] = "scheduler:message_exploded";
+    /** Emitted when a batch of expired messages is found */
+    ExpirationSchedulerEvent["BATCH_EXPIRED"] = "scheduler:batch_expired";
+    /** Emitted when the scheduler encounters an error */
+    ExpirationSchedulerEvent["ERROR"] = "scheduler:error";
+    /** Emitted when the scheduler starts */
+    ExpirationSchedulerEvent["STARTED"] = "scheduler:started";
+    /** Emitted when the scheduler stops */
+    ExpirationSchedulerEvent["STOPPED"] = "scheduler:stopped";
+})(ExpirationSchedulerEvent || (exports.ExpirationSchedulerEvent = ExpirationSchedulerEvent = {}));
+// ─── Scheduler ──────────────────────────────────────────────────────────────
+/**
+ * Background scheduler that periodically checks for and cleans up
+ * expired exploding messages.
+ *
+ * @example
+ * ```typescript
+ * const scheduler = new ExpirationScheduler(
+ *   () => messageStore.getAllExplodingMessages(),
+ *   { intervalMs: 5000 },
+ * );
+ *
+ * scheduler.on(ExpirationSchedulerEvent.MESSAGE_EXPLODED, (event) => {
+ *   console.log(`Message ${event.messageId} exploded`);
+ * });
+ *
+ * scheduler.start();
+ * // ... later
+ * scheduler.stop();
+ * ```
+ */
+class ExpirationScheduler extends events_1.EventEmitter {
+    constructor(messageProvider, config = {}) {
+        super();
+        this.timer = null;
+        this.running = false;
+        this.messageProvider = messageProvider;
+        this.intervalMs = config.intervalMs ?? 10000;
+        this.autoExplode = config.autoExplode ?? true;
+    }
+    /**
+     * Start the scheduler. Begins periodic cleanup runs.
+     *
+     * @throws {Error} If the scheduler is already running
+     */
+    start() {
+        if (this.running) {
+            throw new Error('ExpirationScheduler is already running');
+        }
+        this.running = true;
+        this.timer = setInterval(() => {
+            void this.tick();
+        }, this.intervalMs);
+        this.emit(ExpirationSchedulerEvent.STARTED);
+    }
+    /**
+     * Stop the scheduler. Cancels the periodic cleanup timer.
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.running = false;
+        this.emit(ExpirationSchedulerEvent.STOPPED);
+    }
+    /**
+     * Whether the scheduler is currently running.
+     */
+    get isRunning() {
+        return this.running;
+    }
+    /**
+     * Run a single cleanup tick manually.
+     * Useful for testing or on-demand cleanup.
+     *
+     * @returns The events generated during this tick
+     */
+    async tick() {
+        try {
+            const messages = await this.messageProvider();
+            const { expired, events } = explodingMessageService_1.ExplodingMessageService.deleteExpired(messages);
+            if (expired.length === 0) {
+                return [];
+            }
+            // Explode each expired message
+            const explodedEvents = [];
+            if (this.autoExplode) {
+                for (const message of expired) {
+                    if (!message.exploded) {
+                        const event = explodingMessageService_1.ExplodingMessageService.explode(message);
+                        explodedEvents.push(event);
+                        this.emit(ExpirationSchedulerEvent.MESSAGE_EXPLODED, event);
+                    }
+                }
+            }
+            // Emit batch event
+            this.emit(ExpirationSchedulerEvent.BATCH_EXPIRED, {
+                count: expired.length,
+                events: explodedEvents.length > 0 ? explodedEvents : events,
+            });
+            return explodedEvents.length > 0 ? explodedEvents : events;
+        }
+        catch (error) {
+            this.emit(ExpirationSchedulerEvent.ERROR, error);
+            return [];
+        }
+    }
+}
+exports.ExpirationScheduler = ExpirationScheduler;
+//# sourceMappingURL=expirationScheduler.js.map

package/src/lib/services/expirationScheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expirationScheduler.js","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/expirationScheduler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAGH,6HAGyF;AACzF,mCAAsC;AAuBtC,+EAA+E;AAE/E,IAAY,wBAeX;AAfD,WAAY,wBAAwB;IAClC,0DAA0D;IAC1D,2EAA+C,CAAA;IAE/C,wDAAwD;IACxD,qEAAyC,CAAA;IAEzC,qDAAqD;IACrD,qDAAyB,CAAA;IAEzB,wCAAwC;IACxC,yDAA6B,CAAA;IAE7B,uCAAuC;IACvC,yDAA6B,CAAA;AAC/B,CAAC,EAfW,wBAAwB,wCAAxB,wBAAwB,QAenC;AAED,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,mBAAoB,SAAQ,qBAAY;IAOnD,YACE,eAAgC,EAChC,SAAqC,EAAE;QAEvC,KAAK,EAAE,CAAC;QAPF,UAAK,GAA0C,IAAI,CAAC;QACpD,YAAO,GAAG,KAAK,CAAC;QAOtB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,KAAM,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEpB,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAC9C,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GACvB,iDAAuB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAElD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,+BAA+B;YAC/B,MAAM,cAAc,GAA6B,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;oBAC9B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;wBACtB,MAAM,KAAK,GAAG,iDAAuB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;wBACvD,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBAC3B,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;oBAC9D,CAAC;gBACH,CAAC;YACH,CAAC;YAED,mBAAmB;YACnB,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,aAAa,EAAE;gBAChD,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,MAAM,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM;aAC5D,CAAC,CAAC;YAEH,OAAO,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACjD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AA9FD,kDA8FC"}

package/src/lib/services/fecUsageExample.d.ts

@@ -15,7 +15,7 @@ export declare class FecUsageExample {
     /**
      * Example: Recover a corrupted file using parity data
      */
-    recoverCorruptedFile(parityData: ParityData[], originalSize: number): Promise<Uint8Array<ArrayBufferLike> | Buffer<ArrayBufferLike>>;
+    recoverCorruptedFile(parityData: ParityData[], originalSize: number): Promise<Uint8Array<ArrayBufferLike>>;
     /**
      * Example: Verify file integrity using parity data
      */
@@ -25,7 +25,7 @@ export declare class FecUsageExample {
      */
     demonstrateWorkflow(): Promise<{
         originalFile: Buffer<ArrayBuffer>;
-        recoveredFile: Uint8Array<ArrayBufferLike> | Buffer<ArrayBufferLike>;
+        recoveredFile: Uint8Array<ArrayBufferLike>;
         parityData: ParityData[];
         recoverySuccessful: boolean;
     }>;

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

@@ -12,10 +12,13 @@ export * from './fecUsageExample';
 export * from './messageEventsWebSocketHandler';
 export * from './messagePassingService';
 export * from './nativeRsFecService';
+export * from './presenceService';
 export * from './quorum';
 export * from './requestUser';
 export * from './role';
 export * from './secureKeyStorage';
 export * from './websocketHandler';
 export * from './webSocketMessageServer';
+export * from './webSocketPeerProvider';
+export * from './wireConversationPromotion';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC"}

package/src/lib/services/index.js

@@ -17,10 +17,13 @@ tslib_1.__exportStar(require("./fecUsageExample"), exports);
 tslib_1.__exportStar(require("./messageEventsWebSocketHandler"), exports);
 tslib_1.__exportStar(require("./messagePassingService"), exports);
 tslib_1.__exportStar(require("./nativeRsFecService"), exports);
+tslib_1.__exportStar(require("./presenceService"), exports);
 tslib_1.__exportStar(require("./quorum"), exports);
 tslib_1.__exportStar(require("./requestUser"), exports);
 tslib_1.__exportStar(require("./role"), exports);
 tslib_1.__exportStar(require("./secureKeyStorage"), exports);
 tslib_1.__exportStar(require("./websocketHandler"), exports);
 tslib_1.__exportStar(require("./webSocketMessageServer"), exports);
+tslib_1.__exportStar(require("./webSocketPeerProvider"), exports);
+tslib_1.__exportStar(require("./wireConversationPromotion"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/index.ts"],"names":[],"mappings":";;;;AAAA,iDAAuB;AACvB,iDAAuB;AACvB,mDAAyB;AACzB,gEAAsC;AACtC,uDAA6B;AAC7B,8DAAoC;AACpC,kDAAwB;AACxB,oEAA0C;AAC1C,6BAAuC;AAA9B,qGAAA,cAAc,OAAA;AACvB,8DAAoC;AACpC,4DAAkC;AAClC,0EAAgD;AAChD,kEAAwC;AACxC,+DAAqC;AACrC,mDAAyB;AACzB,wDAA8B;AAC9B,iDAAuB;AACvB,6DAAmC;AACnC,6DAAmC;AACnC,mEAAyC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/index.ts"],"names":[],"mappings":";;;;AAAA,iDAAuB;AACvB,iDAAuB;AACvB,mDAAyB;AACzB,gEAAsC;AACtC,uDAA6B;AAC7B,8DAAoC;AACpC,kDAAwB;AACxB,oEAA0C;AAC1C,6BAAuC;AAA9B,qGAAA,cAAc,OAAA;AACvB,8DAAoC;AACpC,4DAAkC;AAClC,0EAAgD;AAChD,kEAAwC;AACxC,+DAAqC;AACrC,4DAAkC;AAClC,mDAAyB;AACzB,wDAA8B;AAC9B,iDAAuB;AACvB,6DAAmC;AACnC,6DAAmC;AACnC,mEAAyC;AACzC,kEAAwC;AACxC,sEAA4C"}

package/src/lib/services/messagePassingService.d.ts

@@ -1,17 +1,92 @@
-import { IMessageCBLOptions as ICreateMessageOptions, IMessageMetadata, IMessageMetadataStore, MessageCBLService } from '@brightchain/brightchain-lib';
+import { IMessageCBLOptions as ICreateMessageOptions, IGossipService, IMessageMetadata, IMessageMetadataStore, MessageCBLService, type IDeliveryReceipt, type IEmailContent, type IEmailInput, type IEmailMetadata, type IEmailMetadataStore, type IEmailServiceConfig, type IInboxQuery, type IInboxResult, type IMailbox, type IReplyInput, type ISendEmailResult } from '@brightchain/brightchain-lib';
 import { EventNotificationSystem } from './eventNotificationSystem';
-import { WebSocketMessageServer } from './webSocketMessageServer';
 /**
- * High-level message passing service coordinating storage, routing, and events
+ * High-level message passing service coordinating storage, routing, and events.
+ *
+ * Uses IGossipService for message delivery instead of WebSocketMessageServer.
+ * Messages are announced via gossip protocol and delivery acknowledgments
+ * are received through gossip ack events.
+ *
+ * @see Requirements 7.1, 7.2, 7.3, 7.4, 7.5
  */
 export declare class MessagePassingService {
     private messageCBL;
     private metadataStore;
     private eventSystem;
-    private wsServer;
-    constructor(messageCBL: MessageCBLService, metadataStore: IMessageMetadataStore, eventSystem: EventNotificationSystem, wsServer: WebSocketMessageServer);
+    private gossipService;
+    private emailService?;
+    constructor(messageCBL: MessageCBLService, metadataStore: IMessageMetadataStore, eventSystem: EventNotificationSystem, gossipService: IGossipService);
+    /**
+     * Wire up the EmailMessageService for email-specific operations.
+     *
+     * Call this after construction to enable email methods (sendEmail,
+     * getEmail, queryInbox, etc.). Without this, email methods will throw.
+     */
+    configureEmail(emailMetadataStore: IEmailMetadataStore, config?: Partial<IEmailServiceConfig>): void;
+    /**
+     * Returns the underlying EmailMessageService.
+     * @throws Error if email has not been configured via configureEmail()
+     */
+    private getEmailService;
+    /**
+     * Send an email message via the BrightChain email protocol.
+     *
+     * @see Requirements 15.1, 15.4
+     */
+    sendEmail(email: IEmailInput): Promise<ISendEmailResult>;
+    /**
+     * Retrieve email metadata by message ID.
+     */
+    getEmail(messageId: string): Promise<IEmailMetadata | null>;
+    /**
+     * Retrieve full email content including MIME parts and attachments.
+     */
+    getEmailContent(messageId: string): Promise<IEmailContent>;
+    /**
+     * Delete an email by message ID.
+     */
+    deleteEmail(messageId: string): Promise<void>;
+    /**
+     * Query a user's inbox with filtering, sorting, and pagination.
+     *
+     * @see Requirements 13.1, 13.2, 13.3, 13.6, 13.7
+     */
+    queryInbox(userId: string, query: IInboxQuery): Promise<IInboxResult>;
+    /**
+     * Mark an email as read for a specific user.
+     */
+    markEmailAsRead(messageId: string, userId: string): Promise<void>;
+    /**
+     * Get unread email count for a user.
+     */
+    getUnreadEmailCount(userId: string): Promise<number>;
+    /**
+     * Get all emails in a thread.
+     */
+    getEmailThread(messageId: string): Promise<IEmailMetadata[]>;
+    /**
+     * Create a reply to an existing email.
+     *
+     * @see Requirements 10.1, 10.2, 10.3
+     */
+    createEmailReply(originalId: string, replyContent: IReplyInput): Promise<ISendEmailResult>;
+    /**
+     * Forward an email to new recipients.
+     *
+     * @see Requirements 17.1, 17.2, 17.3
+     */
+    forwardEmail(originalId: string, forwardTo: IMailbox[]): Promise<ISendEmailResult>;
+    /**
+     * Get delivery status for all recipients of an email.
+     */
+    getEmailDeliveryStatus(messageId: string): Promise<Map<string, IDeliveryReceipt>>;
     /**
      * Send a message
+     *
+     * Stores the message via MessageCBLService, emits MESSAGE_STORED event,
+     * then announces the message via gossip protocol for delivery.
+     *
+     * @see Requirements 7.1, 7.3, 7.5
      */
     sendMessage(content: Buffer, senderId: string, options: ICreateMessageOptions): Promise<{
         messageId: string;
@@ -19,16 +94,31 @@ export declare class MessagePassingService {
     }>;
     /**
      * Get message content
+     *
+     * @see Requirements 7.5
      */
     getMessage(messageId: string): Promise<Buffer | null>;
     /**
      * Query messages
+     *
+     * @see Requirements 7.5
      */
     queryMessages(query: Record<string, unknown>): Promise<IMessageMetadata[]>;
     /**
      * Delete message
+     *
+     * @see Requirements 7.5
      */
     deleteMessage(messageId: string): Promise<void>;
+    /**
+     * Set up handlers for gossip delivery events.
+     *
+     * Listens for:
+     * - Message delivery announcements (incoming messages)
+     * - Delivery acknowledgments (confirmation of sent messages)
+     *
+     * @see Requirements 7.4
+     */
     private setupHandlers;
 }
 //# sourceMappingURL=messagePassingService.d.ts.map

package/src/lib/services/messagePassingService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messagePassingService.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/messagePassingService.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,IAAI,qBAAqB,EAC3C,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EAElB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EAExB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;GAEG;AACH,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,QAAQ;gBAHR,UAAU,EAAE,iBAAiB,EAC7B,aAAa,EAAE,qBAAqB,EACpC,WAAW,EAAE,uBAAuB,EACpC,QAAQ,EAAE,sBAAsB;IAK1C;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IA8BpD;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK3D;;OAEG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI9B;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASrD,OAAO,CAAC,aAAa;CAoCtB"}
+{"version":3,"file":"messagePassingService.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/messagePassingService.ts"],"names":[],"mappings":"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"}

package/src/lib/services/messagePassingService.js

@@ -4,40 +4,155 @@ exports.MessagePassingService = void 0;
 const brightchain_lib_1 = require("@brightchain/brightchain-lib");
 const eventNotificationSystem_1 = require("./eventNotificationSystem");
 /**
- * High-level message passing service coordinating storage, routing, and events
+ * High-level message passing service coordinating storage, routing, and events.
+ *
+ * Uses IGossipService for message delivery instead of WebSocketMessageServer.
+ * Messages are announced via gossip protocol and delivery acknowledgments
+ * are received through gossip ack events.
+ *
+ * @see Requirements 7.1, 7.2, 7.3, 7.4, 7.5
  */
 class MessagePassingService {
-    constructor(messageCBL, metadataStore, eventSystem, wsServer) {
+    constructor(messageCBL, metadataStore, eventSystem, gossipService) {
         this.messageCBL = messageCBL;
         this.metadataStore = metadataStore;
         this.eventSystem = eventSystem;
-        this.wsServer = wsServer;
+        this.gossipService = gossipService;
         this.setupHandlers();
     }
+    /**
+     * Wire up the EmailMessageService for email-specific operations.
+     *
+     * Call this after construction to enable email methods (sendEmail,
+     * getEmail, queryInbox, etc.). Without this, email methods will throw.
+     */
+    configureEmail(emailMetadataStore, config) {
+        this.emailService = new brightchain_lib_1.EmailMessageService(this.messageCBL, emailMetadataStore, this.gossipService, config);
+    }
+    /**
+     * Returns the underlying EmailMessageService.
+     * @throws Error if email has not been configured via configureEmail()
+     */
+    getEmailService() {
+        if (!this.emailService) {
+            throw new Error('Email not configured. Call configureEmail() before using email methods.');
+        }
+        return this.emailService;
+    }
+    // ─── Email Operations ─────────────────────────────────────────────
+    /**
+     * Send an email message via the BrightChain email protocol.
+     *
+     * @see Requirements 15.1, 15.4
+     */
+    async sendEmail(email) {
+        return this.getEmailService().sendEmail(email);
+    }
+    /**
+     * Retrieve email metadata by message ID.
+     */
+    async getEmail(messageId) {
+        return this.getEmailService().getEmail(messageId);
+    }
+    /**
+     * Retrieve full email content including MIME parts and attachments.
+     */
+    async getEmailContent(messageId) {
+        return this.getEmailService().getEmailContent(messageId);
+    }
+    /**
+     * Delete an email by message ID.
+     */
+    async deleteEmail(messageId) {
+        return this.getEmailService().deleteEmail(messageId);
+    }
+    /**
+     * Query a user's inbox with filtering, sorting, and pagination.
+     *
+     * @see Requirements 13.1, 13.2, 13.3, 13.6, 13.7
+     */
+    async queryInbox(userId, query) {
+        return this.getEmailService().queryInbox(userId, query);
+    }
+    /**
+     * Mark an email as read for a specific user.
+     */
+    async markEmailAsRead(messageId, userId) {
+        return this.getEmailService().markAsRead(messageId, userId);
+    }
+    /**
+     * Get unread email count for a user.
+     */
+    async getUnreadEmailCount(userId) {
+        return this.getEmailService().getUnreadCount(userId);
+    }
+    /**
+     * Get all emails in a thread.
+     */
+    async getEmailThread(messageId) {
+        return this.getEmailService().getThread(messageId);
+    }
+    /**
+     * Create a reply to an existing email.
+     *
+     * @see Requirements 10.1, 10.2, 10.3
+     */
+    async createEmailReply(originalId, replyContent) {
+        return this.getEmailService().createReply(originalId, replyContent);
+    }
+    /**
+     * Forward an email to new recipients.
+     *
+     * @see Requirements 17.1, 17.2, 17.3
+     */
+    async forwardEmail(originalId, forwardTo) {
+        return this.getEmailService().forwardEmail(originalId, forwardTo);
+    }
+    /**
+     * Get delivery status for all recipients of an email.
+     */
+    async getEmailDeliveryStatus(messageId) {
+        return this.getEmailService().getDeliveryStatus(messageId);
+    }
     /**
      * Send a message
+     *
+     * Stores the message via MessageCBLService, emits MESSAGE_STORED event,
+     * then announces the message via gossip protocol for delivery.
+     *
+     * @see Requirements 7.1, 7.3, 7.5
      */
     async sendMessage(content, senderId, options) {
         const { messageId, magnetUrl } = await this.messageCBL.createMessage(new Uint8Array(content), senderId, options);
         const metadata = await this.messageCBL.getMessageMetadata(messageId);
         if (metadata) {
+            // Emit MESSAGE_STORED event after successful storage (Requirement 7.3)
             this.eventSystem.emit(eventNotificationSystem_1.MessageEventType.MESSAGE_STORED, metadata);
-            // Route to recipients
-            if (options.recipients && options.recipients.length > 0) {
-                for (const recipientId of options.recipients) {
-                    await this.wsServer.sendToNode(recipientId, messageId);
-                    await this.metadataStore.updateDeliveryStatus(messageId, recipientId, brightchain_lib_1.MessageDeliveryStatus.IN_TRANSIT);
-                }
-            }
-            else {
-                // Broadcast
-                this.wsServer.broadcast(messageId);
+            // Build message delivery metadata for gossip announcement
+            const recipientIds = options.recipients && options.recipients.length > 0
+                ? [...options.recipients]
+                : [];
+            const deliveryMetadata = {
+                messageId,
+                recipientIds,
+                priority: 'normal',
+                blockIds: metadata.cblBlockIds ?? [],
+                cblBlockId: metadata.blockId,
+                ackRequired: true,
+            };
+            // Announce message via gossip protocol (Requirement 7.1)
+            await this.gossipService.announceMessage(metadata.cblBlockIds ?? [], deliveryMetadata);
+            // Update delivery status for each recipient to Announced
+            for (const recipientId of recipientIds) {
+                await this.metadataStore.updateDeliveryStatus(messageId, recipientId, brightchain_lib_1.DeliveryStatus.Announced);
             }
         }
         return { messageId, magnetUrl };
     }
     /**
      * Get message content
+     *
+     * @see Requirements 7.5
      */
     async getMessage(messageId) {
         const content = await this.messageCBL.getMessageContent(messageId);
@@ -45,12 +160,16 @@ class MessagePassingService {
     }
     /**
      * Query messages
+     *
+     * @see Requirements 7.5
      */
     async queryMessages(query) {
         return this.metadataStore.queryMessages(query);
     }
     /**
      * Delete message
+     *
+     * @see Requirements 7.5
      */
     async deleteMessage(messageId) {
         const metadata = await this.messageCBL.getMessageMetadata(messageId);
@@ -60,25 +179,65 @@ class MessagePassingService {
             }
         }
     }
+    /**
+     * Set up handlers for gossip delivery events.
+     *
+     * Listens for:
+     * - Message delivery announcements (incoming messages)
+     * - Delivery acknowledgments (confirmation of sent messages)
+     *
+     * @see Requirements 7.4
+     */
     setupHandlers() {
-        this.wsServer.onMessage(async (nodeId, messageId) => {
-            const metadata = await this.messageCBL.getMessageMetadata(messageId);
-            if (metadata) {
-                this.eventSystem.emit(eventNotificationSystem_1.MessageEventType.MESSAGE_RECEIVED, metadata);
-                await this.wsServer.sendToNode(nodeId, messageId);
+        // Handle incoming message delivery announcements
+        this.gossipService.onMessageDelivery(async (announcement) => {
+            if (announcement.messageDelivery) {
+                const metadata = await this.messageCBL.getMessageMetadata(announcement.messageDelivery.messageId);
+                if (metadata) {
+                    this.eventSystem.emit(eventNotificationSystem_1.MessageEventType.MESSAGE_RECEIVED, metadata);
+                }
             }
         });
-        this.wsServer.onAck(async (nodeId, messageId, status) => {
-            await this.metadataStore.recordAcknowledgment(messageId, nodeId, new Date());
-            await this.metadataStore.updateDeliveryStatus(messageId, nodeId, status);
-            const metadata = await this.messageCBL.getMessageMetadata(messageId);
-            if (metadata) {
-                const allDelivered = metadata.recipients?.every((r) => metadata.deliveryStatus?.get(r) === brightchain_lib_1.MessageDeliveryStatus.DELIVERED);
-                if (allDelivered) {
-                    this.eventSystem.emit(eventNotificationSystem_1.MessageEventType.MESSAGE_DELIVERED, metadata);
+        // Handle delivery acknowledgments (Requirement 7.4)
+        this.gossipService.onDeliveryAck(async (announcement) => {
+            if (announcement.deliveryAck) {
+                const { messageId, recipientId, status } = announcement.deliveryAck;
+                // Map ack status to DeliveryStatus
+                const deliveryStatus = status === 'delivered' || status === 'read'
+                    ? brightchain_lib_1.DeliveryStatus.Delivered
+                    : brightchain_lib_1.DeliveryStatus.Failed;
+                // Record the acknowledgment and update delivery status.
+                // The message may be managed by the email subsystem (InMemoryEmailMetadataStore)
+                // rather than the generic MemoryMessageMetadataStore, so KeyNotFound is expected
+                // for email messages and should be silently ignored.
+                try {
+                    await this.metadataStore.recordAcknowledgment(messageId, recipientId, new Date());
+                }
+                catch (err) {
+                    if (!(err instanceof brightchain_lib_1.StoreError) ||
+                        err.type !== brightchain_lib_1.StoreErrorType.KeyNotFound) {
+                        throw err;
+                    }
+                }
+                try {
+                    await this.metadataStore.updateDeliveryStatus(messageId, recipientId, deliveryStatus);
+                }
+                catch (err) {
+                    if (!(err instanceof brightchain_lib_1.StoreError) ||
+                        err.type !== brightchain_lib_1.StoreErrorType.KeyNotFound) {
+                        throw err;
+                    }
                 }
-                else if (status === brightchain_lib_1.MessageDeliveryStatus.FAILED) {
-                    this.eventSystem.emit(eventNotificationSystem_1.MessageEventType.MESSAGE_FAILED, metadata);
+                // Check if all recipients have been delivered and emit appropriate events
+                const metadata = await this.messageCBL.getMessageMetadata(messageId);
+                if (metadata) {
+                    const allDelivered = metadata.recipients?.every((r) => metadata.deliveryStatus?.get(r) === brightchain_lib_1.DeliveryStatus.Delivered);
+                    if (allDelivered) {
+                        this.eventSystem.emit(eventNotificationSystem_1.MessageEventType.MESSAGE_DELIVERED, metadata);
+                    }
+                    else if (deliveryStatus === brightchain_lib_1.DeliveryStatus.Failed) {
+                        this.eventSystem.emit(eventNotificationSystem_1.MessageEventType.MESSAGE_FAILED, metadata);
+                    }
                 }
             }
         });

package/src/lib/services/messagePassingService.js.map

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

package/src/lib/services/paginationService.d.ts

@@ -0,0 +1,18 @@
+export interface IPaginatedResult<T> {
+    items: T[];
+    nextCursor?: string;
+    hasMore: boolean;
+}
+export interface PaginationCursor {
+    timestamp: number;
+    id: string;
+}
+export declare class PaginationService {
+    static encodeCursor(timestamp: number, id: string): string;
+    static decodeCursor(cursor: string): PaginationCursor;
+    static paginate<T extends {
+        timestamp: number;
+        id: string;
+    }>(items: T[], limit: number, cursor?: string): IPaginatedResult<T>;
+}
+//# sourceMappingURL=paginationService.d.ts.map