@brightchain/brightchain-api-lib 0.14.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":"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"}

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,6 +12,7 @@ export * from './fecUsageExample';
 export * from './messageEventsWebSocketHandler';
 export * from './messagePassingService';
 export * from './nativeRsFecService';
+export * from './presenceService';
 export * from './quorum';
 export * from './requestUser';
 export * from './role';
@@ -19,4 +20,5 @@ 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;AACzC,cAAc,yBAAyB,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,6 +17,7 @@ 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);
@@ -24,4 +25,5 @@ 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;AACzC,kEAAwC"}
+{"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/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

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

@@ -0,0 +1 @@
+{"version":3,"file":"paginationService.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/paginationService.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAI1D,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB;IAIrD,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EACzD,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,gBAAgB,CAAC,CAAC,CAAC;CA4BvB"}

package/src/lib/services/paginationService.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaginationService = void 0;
+class PaginationService {
+    static encodeCursor(timestamp, id) {
+        return Buffer.from(JSON.stringify({ timestamp, id })).toString('base64');
+    }
+    static decodeCursor(cursor) {
+        return JSON.parse(Buffer.from(cursor, 'base64').toString('utf-8'));
+    }
+    static paginate(items, limit, cursor) {
+        const sortedItems = [...items].sort((a, b) => b.timestamp - a.timestamp);
+        let startIndex = 0;
+        if (cursor) {
+            const { timestamp, id } = this.decodeCursor(cursor);
+            startIndex =
+                sortedItems.findIndex((item) => item.timestamp === timestamp && item.id === id) + 1;
+        }
+        const pageItems = sortedItems.slice(startIndex, startIndex + limit);
+        const hasMore = startIndex + limit < sortedItems.length;
+        const nextCursor = hasMore && pageItems.length > 0
+            ? this.encodeCursor(pageItems[pageItems.length - 1].timestamp, pageItems[pageItems.length - 1].id)
+            : undefined;
+        return {
+            items: pageItems,
+            nextCursor,
+            hasMore,
+        };
+    }
+}
+exports.PaginationService = PaginationService;
+//# sourceMappingURL=paginationService.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paginationService.js","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/paginationService.ts"],"names":[],"mappings":";;;AAWA,MAAa,iBAAiB;IAC5B,MAAM,CAAC,YAAY,CAAC,SAAiB,EAAE,EAAU;QAC/C,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,MAAc;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,CAAC,QAAQ,CACb,KAAU,EACV,KAAa,EACb,MAAe;QAEf,MAAM,WAAW,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAEzE,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACpD,UAAU;gBACR,WAAW,CAAC,SAAS,CACnB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,CACzD,GAAG,CAAC,CAAC;QACV,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;QACxD,MAAM,UAAU,GACd,OAAO,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAC7B,CAAC,CAAC,IAAI,CAAC,YAAY,CACf,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,EACzC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CACnC;YACH,CAAC,CAAC,SAAS,CAAC;QAEhB,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,UAAU;YACV,OAAO;SACR,CAAC;IACJ,CAAC;CACF;AAzCD,8CAyCC"}

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

@@ -0,0 +1,76 @@
+/**
+ * PresenceService — tracks member online status and broadcasts presence
+ * changes via WebSocket through EventNotificationSystem.
+ *
+ * Maintains an in-memory map of member statuses and WebSocket connections.
+ * When a member's status changes, the service broadcasts the change only
+ * to members who share at least one context (conversation, group, or channel)
+ * with them — determined by the shared-context resolver supplied at construction.
+ *
+ * Requirements: 7.3, 7.4
+ */
+import { CommunicationEventType, PresenceStatus } from '@brightchain/brightchain-lib';
+import { WebSocket } from 'ws';
+/**
+ * Callback that resolves the set of member IDs who share at least one
+ * conversation, group, or channel with the given member.
+ */
+export type SharedContextResolver = (memberId: string) => Set<string>;
+/**
+ * Presence change event payload sent over WebSocket.
+ */
+export interface IPresenceChangeEvent {
+    type: CommunicationEventType.PRESENCE_CHANGED;
+    timestamp: Date;
+    data: {
+        memberId: string;
+        status: PresenceStatus;
+    };
+}
+export declare class PresenceService {
+    private readonly sharedContextResolver;
+    /** memberId → current presence status */
+    private readonly statuses;
+    /** memberId → set of active WebSocket connections (supports multiple devices) */
+    private readonly connections;
+    constructor(sharedContextResolver: SharedContextResolver);
+    /**
+     * Set a member's presence status and broadcast the change to members
+     * who share a context with them.
+     *
+     * Requirement 7.3: broadcast status change to shared-context members.
+     */
+    setStatus(memberId: string, status: PresenceStatus): void;
+    /**
+     * Get a single member's current presence status.
+     * Defaults to OFFLINE if the member has never connected.
+     */
+    getStatus(memberId: string): PresenceStatus;
+    /**
+     * Get presence statuses for multiple members at once.
+     *
+     * Requirement 7.4: deliver current presence of shared-context members on connect.
+     */
+    getStatusBulk(memberIds: string[]): Map<string, PresenceStatus>;
+    /**
+     * Handle a member connecting via WebSocket.
+     * Sets status to ONLINE (if currently OFFLINE) and delivers the current
+     * presence of all shared-context members.
+     *
+     * Requirements: 7.3, 7.4
+     */
+    onConnect(memberId: string, ws: WebSocket): void;
+    /**
+     * Handle a member explicitly disconnecting.
+     * Removes all WebSocket connections and sets status to OFFLINE.
+     */
+    onDisconnect(memberId: string): void;
+    /**
+     * Broadcast a presence change event to all members who share a context
+     * with the given member.
+     *
+     * Requirement 7.3: presence change delivered only to shared-context members.
+     */
+    private broadcastPresenceChange;
+}
+//# sourceMappingURL=presenceService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presenceService.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/presenceService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,sBAAsB,EACtB,cAAc,EACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/B;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,sBAAsB,CAAC,gBAAgB,CAAC;IAC9C,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,cAAc,CAAC;KACxB,CAAC;CACH;AAED,qBAAa,eAAe;IAOd,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IANlD,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAE9D,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;gBAEpC,qBAAqB,EAAE,qBAAqB;IAEzE;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IASzD;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc;IAI3C;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAQ/D;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI;IAoChD;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAcpC;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;CA2BhC"}

package/src/lib/services/presenceService.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * PresenceService — tracks member online status and broadcasts presence
+ * changes via WebSocket through EventNotificationSystem.
+ *
+ * Maintains an in-memory map of member statuses and WebSocket connections.
+ * When a member's status changes, the service broadcasts the change only
+ * to members who share at least one context (conversation, group, or channel)
+ * with them — determined by the shared-context resolver supplied at construction.
+ *
+ * Requirements: 7.3, 7.4
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PresenceService = void 0;
+const brightchain_lib_1 = require("@brightchain/brightchain-lib");
+const ws_1 = require("ws");
+class PresenceService {
+    constructor(sharedContextResolver) {
+        this.sharedContextResolver = sharedContextResolver;
+        /** memberId → current presence status */
+        this.statuses = new Map();
+        /** memberId → set of active WebSocket connections (supports multiple devices) */
+        this.connections = new Map();
+    }
+    /**
+     * Set a member's presence status and broadcast the change to members
+     * who share a context with them.
+     *
+     * Requirement 7.3: broadcast status change to shared-context members.
+     */
+    setStatus(memberId, status) {
+        const previous = this.statuses.get(memberId) ?? brightchain_lib_1.PresenceStatus.OFFLINE;
+        this.statuses.set(memberId, status);
+        if (previous !== status) {
+            this.broadcastPresenceChange(memberId, status);
+        }
+    }
+    /**
+     * Get a single member's current presence status.
+     * Defaults to OFFLINE if the member has never connected.
+     */
+    getStatus(memberId) {
+        return this.statuses.get(memberId) ?? brightchain_lib_1.PresenceStatus.OFFLINE;
+    }
+    /**
+     * Get presence statuses for multiple members at once.
+     *
+     * Requirement 7.4: deliver current presence of shared-context members on connect.
+     */
+    getStatusBulk(memberIds) {
+        const result = new Map();
+        for (const id of memberIds) {
+            result.set(id, this.getStatus(id));
+        }
+        return result;
+    }
+    /**
+     * Handle a member connecting via WebSocket.
+     * Sets status to ONLINE (if currently OFFLINE) and delivers the current
+     * presence of all shared-context members.
+     *
+     * Requirements: 7.3, 7.4
+     */
+    onConnect(memberId, ws) {
+        // Track the connection
+        let memberConns = this.connections.get(memberId);
+        if (!memberConns) {
+            memberConns = new Set();
+            this.connections.set(memberId, memberConns);
+        }
+        memberConns.add(ws);
+        // Auto-clean on close
+        ws.on('close', () => {
+            memberConns.delete(ws);
+            if (memberConns.size === 0) {
+                this.connections.delete(memberId);
+                this.setStatus(memberId, brightchain_lib_1.PresenceStatus.OFFLINE);
+            }
+        });
+        // Set online if currently offline
+        if (this.getStatus(memberId) === brightchain_lib_1.PresenceStatus.OFFLINE) {
+            this.setStatus(memberId, brightchain_lib_1.PresenceStatus.ONLINE);
+        }
+        // Deliver current presence of shared-context members (Req 7.4)
+        const sharedMembers = this.sharedContextResolver(memberId);
+        const bulkStatus = this.getStatusBulk([...sharedMembers]);
+        const payload = {
+            type: 'presence:bulk_status',
+            timestamp: new Date(),
+            data: Object.fromEntries(bulkStatus),
+        };
+        if (ws.readyState === ws_1.WebSocket.OPEN) {
+            ws.send(JSON.stringify(payload));
+        }
+    }
+    /**
+     * Handle a member explicitly disconnecting.
+     * Removes all WebSocket connections and sets status to OFFLINE.
+     */
+    onDisconnect(memberId) {
+        const memberConns = this.connections.get(memberId);
+        if (memberConns) {
+            for (const ws of memberConns) {
+                if (ws.readyState === ws_1.WebSocket.OPEN) {
+                    ws.close();
+                }
+            }
+            memberConns.clear();
+            this.connections.delete(memberId);
+        }
+        this.setStatus(memberId, brightchain_lib_1.PresenceStatus.OFFLINE);
+    }
+    /**
+     * Broadcast a presence change event to all members who share a context
+     * with the given member.
+     *
+     * Requirement 7.3: presence change delivered only to shared-context members.
+     */
+    broadcastPresenceChange(memberId, status) {
+        const event = {
+            type: brightchain_lib_1.CommunicationEventType.PRESENCE_CHANGED,
+            timestamp: new Date(),
+            data: { memberId, status },
+        };
+        const sharedMembers = this.sharedContextResolver(memberId);
+        const serialized = JSON.stringify(event);
+        for (const targetMemberId of sharedMembers) {
+            // Don't send to the member whose status changed
+            if (targetMemberId === memberId)
+                continue;
+            const targetConns = this.connections.get(targetMemberId);
+            if (!targetConns)
+                continue;
+            for (const ws of targetConns) {
+                if (ws.readyState === ws_1.WebSocket.OPEN) {
+                    ws.send(serialized);
+                }
+            }
+        }
+    }
+}
+exports.PresenceService = PresenceService;
+//# sourceMappingURL=presenceService.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * Wires ConversationService.promoteToGroup to GroupService.createGroupFromConversation.
+ *
+ * This module provides the glue between the two services, enabling conversation
+ * promotion to group with message history migration and key re-encryption
+ * for all members (original + new).
+ *
+ * Requirements: 2.1, 2.2, 2.3
+ */
+import { ConversationService } from '@brightchain/brightchain-lib/lib/services/communication/conversationService';
+import { GroupService } from '@brightchain/brightchain-lib/lib/services/communication/groupService';
+/**
+ * Connects the ConversationService's group promotion handler to the
+ * GroupService's createGroupFromConversation method.
+ *
+ * Call this once during application initialization after both services
+ * are constructed.
+ *
+ * @param conversationService - The ConversationService instance
+ * @param groupService - The GroupService instance
+ */
+export declare function wireConversationPromotion(conversationService: ConversationService, groupService: GroupService): void;
+//# sourceMappingURL=wireConversationPromotion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wireConversationPromotion.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/wireConversationPromotion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,6EAA6E,CAAC;AAClH,OAAO,EAAE,YAAY,EAAE,MAAM,sEAAsE,CAAC;AAEpG;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,mBAAmB,EAAE,mBAAmB,EACxC,YAAY,EAAE,YAAY,GACzB,IAAI,CAiBN"}

package/src/lib/services/wireConversationPromotion.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Wires ConversationService.promoteToGroup to GroupService.createGroupFromConversation.
+ *
+ * This module provides the glue between the two services, enabling conversation
+ * promotion to group with message history migration and key re-encryption
+ * for all members (original + new).
+ *
+ * Requirements: 2.1, 2.2, 2.3
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wireConversationPromotion = wireConversationPromotion;
+/**
+ * Connects the ConversationService's group promotion handler to the
+ * GroupService's createGroupFromConversation method.
+ *
+ * Call this once during application initialization after both services
+ * are constructed.
+ *
+ * @param conversationService - The ConversationService instance
+ * @param groupService - The GroupService instance
+ */
+function wireConversationPromotion(conversationService, groupService) {
+    conversationService.setGroupPromotionHandler((conversationId, existingParticipants, newMemberIds, messages, requesterId) => groupService.createGroupFromConversation(conversationId, existingParticipants, newMemberIds, messages, requesterId));
+}
+//# sourceMappingURL=wireConversationPromotion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wireConversationPromotion.js","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/wireConversationPromotion.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAeH,8DAoBC;AA9BD;;;;;;;;;GASG;AACH,SAAgB,yBAAyB,CACvC,mBAAwC,EACxC,YAA0B;IAE1B,mBAAmB,CAAC,wBAAwB,CAC1C,CACE,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,EAAE,CACF,YAAY,CAAC,2BAA2B,CACtC,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,QAAQ,EACR,WAAW,CACZ,CACJ,CAAC;AACJ,CAAC"}