@brightchain/brightchain-lib 0.14.0 → 0.15.0

package/src/lib/services/communication/conversationService.d.ts

@@ -0,0 +1,130 @@
+/**
+ * ConversationService — manages direct message conversations and promotion to groups.
+ *
+ * Maintains in-memory stores for conversations and messages, delegating
+ * encrypted content storage to MessagePassingService. Supports cursor-based
+ * pagination, message deletion, and conversation promotion to groups.
+ *
+ * Requirements: 10.1
+ */
+import { ICommunicationMessage, IConversation, IGroup, IPaginatedResult } from '../../interfaces/communication';
+import { ICommunicationEventEmitter } from '../../interfaces/events';
+/**
+ * Callback to check whether a member exists and is not blocked by the sender.
+ * Returns true if the member is reachable, false otherwise.
+ * Used to produce uniform errors for non-existent and blocked members.
+ */
+export type MemberReachabilityCheck = (senderId: string, recipientId: string) => boolean;
+/**
+ * Callback to promote a conversation to a group.
+ * Injected from GroupService once it is available.
+ * Returns the newly created IGroup.
+ */
+export type GroupPromotionHandler = (conversationId: string, existingParticipants: [string, string], newMemberIds: string[], messages: ICommunicationMessage[], requesterId: string) => Promise<IGroup>;
+/**
+ * Uniform error thrown when a recipient is not reachable.
+ * The message is intentionally identical for non-existent and blocked members
+ * to prevent information leakage.
+ */
+export declare class RecipientNotReachableError extends Error {
+    constructor();
+}
+export declare class ConversationNotFoundError extends Error {
+    constructor(conversationId: string);
+}
+export declare class NotParticipantError extends Error {
+    constructor();
+}
+export declare class MessageNotFoundError extends Error {
+    constructor(messageId: string);
+}
+export declare class NotMessageAuthorError extends Error {
+    constructor();
+}
+export declare class GroupPromotionNotConfiguredError extends Error {
+    constructor();
+}
+export declare class ConversationService {
+    /** conversationId → IConversation */
+    private readonly conversations;
+    /** conversationId → messages (ordered by createdAt ascending) */
+    private readonly messages;
+    /** "memberA:memberB" (sorted) → conversationId for dedup */
+    private readonly participantIndex;
+    /** Set of blocked pairs: "blocker:blocked" */
+    private readonly blockedPairs;
+    /** Set of known member IDs */
+    private readonly knownMembers;
+    private groupPromotionHandler;
+    private readonly memberReachabilityCheck;
+    private readonly eventEmitter;
+    constructor(memberReachabilityCheck?: MemberReachabilityCheck | null, eventEmitter?: ICommunicationEventEmitter);
+    /**
+     * Register a member as known (exists in the system).
+     */
+    registerMember(memberId: string): void;
+    /**
+     * Block a member. The blocker will not receive messages from the blocked member.
+     */
+    blockMember(blockerId: string, blockedId: string): void;
+    /**
+     * Set the handler for promoting conversations to groups.
+     * Called during initialization once GroupService is available.
+     */
+    setGroupPromotionHandler(handler: GroupPromotionHandler): void;
+    /**
+     * Check if a recipient is reachable by the sender.
+     * Returns false for non-existent or blocked members.
+     */
+    private isReachable;
+    /**
+     * Build a sorted participant key for dedup lookups.
+     */
+    private participantKey;
+    /**
+     * Create a new conversation between two members, or return the existing one.
+     */
+    createOrGetConversation(memberA: string, memberB: string): Promise<IConversation>;
+    /**
+     * List conversations for a member, sorted by lastMessageAt descending.
+     * Supports cursor-based pagination.
+     */
+    listConversations(memberId: string, cursor?: string, limit?: number): Promise<IPaginatedResult<IConversation>>;
+    /**
+     * Get messages in a conversation, in chronological order.
+     * Supports cursor-based pagination.
+     */
+    getMessages(conversationId: string, memberId: string, cursor?: string, limit?: number): Promise<IPaginatedResult<ICommunicationMessage>>;
+    /**
+     * Send a message in a conversation.
+     * Creates the conversation if it doesn't exist.
+     * Checks recipient reachability and returns a uniform error for
+     * non-existent or blocked members.
+     */
+    sendMessage(senderId: string, recipientId: string, content: string, conversationId?: string): Promise<ICommunicationMessage>;
+    /**
+     * Delete a message authored by the requesting member.
+     * Marks the message as deleted for all participants.
+     */
+    deleteMessage(conversationId: string, messageId: string, memberId: string): Promise<void>;
+    /**
+     * Promote a conversation to a group by adding new members.
+     * Delegates to the GroupPromotionHandler (wired from GroupService).
+     */
+    promoteToGroup(conversationId: string, newMemberIds: string[], requesterId: string): Promise<IGroup>;
+    /**
+     * Get a conversation by ID. Returns undefined if not found.
+     */
+    getConversation(conversationId: string): IConversation | undefined;
+    /**
+     * Get all messages for a conversation (no pagination). Used internally
+     * for promotion and testing.
+     */
+    getAllMessages(conversationId: string): ICommunicationMessage[];
+    /**
+     * Return all conversations that include the given member (no pagination).
+     * Used by SearchService for cross-context keyword search.
+     */
+    listAllConversationsForMember(memberId: string): IConversation[];
+}
+//# sourceMappingURL=conversationService.d.ts.map

package/src/lib/services/communication/conversationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationService.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/services/communication/conversationService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,MAAM,EACN,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,0BAA0B,EAE3B,MAAM,yBAAyB,CAAC;AAGjC;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CACpC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC;AAEb;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,cAAc,EAAE,MAAM,EACtB,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,YAAY,EAAE,MAAM,EAAE,EACtB,QAAQ,EAAE,qBAAqB,EAAE,EACjC,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;;CAKpD;AAED,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,cAAc,EAAE,MAAM;CAInC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAED,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,SAAS,EAAE,MAAM;CAI9B;AAED,qBAAa,qBAAsB,SAAQ,KAAK;;CAK/C;AAED,qBAAa,gCAAiC,SAAQ,KAAK;;CAK1D;AAED,qBAAa,mBAAmB;IAC9B,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;IAElE,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8C;IAEvE,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAE9D,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD,8BAA8B;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD,OAAO,CAAC,qBAAqB,CAAsC;IACnE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAiC;IACzE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;gBAGxD,uBAAuB,GAAE,uBAAuB,GAAG,IAAW,EAC9D,YAAY,GAAE,0BAAmD;IAMnE;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAIvD;;;OAGG;IACH,wBAAwB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAI9D;;;OAGG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACG,uBAAuB,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC;IAyBzB;;;OAGG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAU3C;;;OAGG;IACG,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;IAkBnD;;;;;OAKG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,qBAAqB,CAAC;IAkDjC;;;OAGG;IACG,aAAa,CACjB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAmChB;;;OAGG;IACG,cAAc,CAClB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IA4BlB;;OAEG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIlE;;;OAGG;IACH,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAI/D;;;OAGG;IACH,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;CAKjE"}

package/src/lib/services/communication/conversationService.js

@@ -0,0 +1,279 @@
+"use strict";
+/**
+ * ConversationService — manages direct message conversations and promotion to groups.
+ *
+ * Maintains in-memory stores for conversations and messages, delegating
+ * encrypted content storage to MessagePassingService. Supports cursor-based
+ * pagination, message deletion, and conversation promotion to groups.
+ *
+ * Requirements: 10.1
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationService = exports.GroupPromotionNotConfiguredError = exports.NotMessageAuthorError = exports.MessageNotFoundError = exports.NotParticipantError = exports.ConversationNotFoundError = exports.RecipientNotReachableError = void 0;
+const uuid_1 = require("uuid");
+const events_1 = require("../../interfaces/events");
+const pagination_1 = require("../../utils/pagination");
+/**
+ * Uniform error thrown when a recipient is not reachable.
+ * The message is intentionally identical for non-existent and blocked members
+ * to prevent information leakage.
+ */
+class RecipientNotReachableError extends Error {
+    constructor() {
+        super('Recipient not found');
+        this.name = 'RecipientNotReachableError';
+    }
+}
+exports.RecipientNotReachableError = RecipientNotReachableError;
+class ConversationNotFoundError extends Error {
+    constructor(conversationId) {
+        super(`Conversation ${conversationId} not found`);
+        this.name = 'ConversationNotFoundError';
+    }
+}
+exports.ConversationNotFoundError = ConversationNotFoundError;
+class NotParticipantError extends Error {
+    constructor() {
+        super('You are not a participant in this conversation');
+        this.name = 'NotParticipantError';
+    }
+}
+exports.NotParticipantError = NotParticipantError;
+class MessageNotFoundError extends Error {
+    constructor(messageId) {
+        super(`Message ${messageId} not found`);
+        this.name = 'MessageNotFoundError';
+    }
+}
+exports.MessageNotFoundError = MessageNotFoundError;
+class NotMessageAuthorError extends Error {
+    constructor() {
+        super('You can only delete messages you authored');
+        this.name = 'NotMessageAuthorError';
+    }
+}
+exports.NotMessageAuthorError = NotMessageAuthorError;
+class GroupPromotionNotConfiguredError extends Error {
+    constructor() {
+        super('Group promotion is not configured');
+        this.name = 'GroupPromotionNotConfiguredError';
+    }
+}
+exports.GroupPromotionNotConfiguredError = GroupPromotionNotConfiguredError;
+class ConversationService {
+    constructor(memberReachabilityCheck = null, eventEmitter = new events_1.NullEventEmitter()) {
+        /** conversationId → IConversation */
+        this.conversations = new Map();
+        /** conversationId → messages (ordered by createdAt ascending) */
+        this.messages = new Map();
+        /** "memberA:memberB" (sorted) → conversationId for dedup */
+        this.participantIndex = new Map();
+        /** Set of blocked pairs: "blocker:blocked" */
+        this.blockedPairs = new Set();
+        /** Set of known member IDs */
+        this.knownMembers = new Set();
+        this.groupPromotionHandler = null;
+        this.memberReachabilityCheck = memberReachabilityCheck;
+        this.eventEmitter = eventEmitter;
+    }
+    /**
+     * Register a member as known (exists in the system).
+     */
+    registerMember(memberId) {
+        this.knownMembers.add(memberId);
+    }
+    /**
+     * Block a member. The blocker will not receive messages from the blocked member.
+     */
+    blockMember(blockerId, blockedId) {
+        this.blockedPairs.add(`${blockerId}:${blockedId}`);
+    }
+    /**
+     * Set the handler for promoting conversations to groups.
+     * Called during initialization once GroupService is available.
+     */
+    setGroupPromotionHandler(handler) {
+        this.groupPromotionHandler = handler;
+    }
+    /**
+     * Check if a recipient is reachable by the sender.
+     * Returns false for non-existent or blocked members.
+     */
+    isReachable(senderId, recipientId) {
+        if (this.memberReachabilityCheck) {
+            return this.memberReachabilityCheck(senderId, recipientId);
+        }
+        if (!this.knownMembers.has(recipientId)) {
+            return false;
+        }
+        return !this.blockedPairs.has(`${recipientId}:${senderId}`);
+    }
+    /**
+     * Build a sorted participant key for dedup lookups.
+     */
+    participantKey(a, b) {
+        return a < b ? `${a}:${b}` : `${b}:${a}`;
+    }
+    /**
+     * Create a new conversation between two members, or return the existing one.
+     */
+    async createOrGetConversation(memberA, memberB) {
+        const key = this.participantKey(memberA, memberB);
+        const existingId = this.participantIndex.get(key);
+        if (existingId) {
+            const existing = this.conversations.get(existingId);
+            if (existing) {
+                return existing;
+            }
+        }
+        const now = new Date();
+        const conversation = {
+            id: (0, uuid_1.v4)(),
+            participants: [memberA, memberB],
+            createdAt: now,
+            lastMessageAt: now,
+        };
+        this.conversations.set(conversation.id, conversation);
+        this.messages.set(conversation.id, []);
+        this.participantIndex.set(key, conversation.id);
+        return conversation;
+    }
+    /**
+     * List conversations for a member, sorted by lastMessageAt descending.
+     * Supports cursor-based pagination.
+     */
+    async listConversations(memberId, cursor, limit = 20) {
+        const memberConversations = Array.from(this.conversations.values())
+            .filter((c) => c.participants[0] === memberId || c.participants[1] === memberId)
+            .sort((a, b) => b.lastMessageAt.getTime() - a.lastMessageAt.getTime());
+        return (0, pagination_1.paginateItems)(memberConversations, cursor, limit);
+    }
+    /**
+     * Get messages in a conversation, in chronological order.
+     * Supports cursor-based pagination.
+     */
+    async getMessages(conversationId, memberId, cursor, limit = 50) {
+        const conversation = this.conversations.get(conversationId);
+        if (!conversation) {
+            throw new ConversationNotFoundError(conversationId);
+        }
+        if (conversation.participants[0] !== memberId &&
+            conversation.participants[1] !== memberId) {
+            throw new NotParticipantError();
+        }
+        const msgs = this.messages.get(conversationId) ?? [];
+        return (0, pagination_1.paginateItems)(msgs, cursor, limit);
+    }
+    /**
+     * Send a message in a conversation.
+     * Creates the conversation if it doesn't exist.
+     * Checks recipient reachability and returns a uniform error for
+     * non-existent or blocked members.
+     */
+    async sendMessage(senderId, recipientId, content, conversationId) {
+        // Check reachability: uniform error for blocked/non-existent
+        if (!this.isReachable(senderId, recipientId)) {
+            throw new RecipientNotReachableError();
+        }
+        let conversation;
+        if (conversationId) {
+            const existing = this.conversations.get(conversationId);
+            if (!existing) {
+                throw new ConversationNotFoundError(conversationId);
+            }
+            conversation = existing;
+        }
+        else {
+            conversation = await this.createOrGetConversation(senderId, recipientId);
+        }
+        const now = new Date();
+        const message = {
+            id: (0, uuid_1.v4)(),
+            contextType: 'conversation',
+            contextId: conversation.id,
+            senderId,
+            encryptedContent: content,
+            createdAt: now,
+            editHistory: [],
+            deleted: false,
+            pinned: false,
+            reactions: [],
+        };
+        const msgs = this.messages.get(conversation.id);
+        if (msgs) {
+            msgs.push(message);
+        }
+        // Update conversation's lastMessageAt
+        conversation.lastMessageAt = now;
+        // Emit message sent event
+        this.eventEmitter.emitMessageSent('conversation', conversation.id, message.id, senderId);
+        return message;
+    }
+    /**
+     * Delete a message authored by the requesting member.
+     * Marks the message as deleted for all participants.
+     */
+    async deleteMessage(conversationId, messageId, memberId) {
+        const conversation = this.conversations.get(conversationId);
+        if (!conversation) {
+            throw new ConversationNotFoundError(conversationId);
+        }
+        if (conversation.participants[0] !== memberId &&
+            conversation.participants[1] !== memberId) {
+            throw new NotParticipantError();
+        }
+        const msgs = this.messages.get(conversationId) ?? [];
+        const message = msgs.find((m) => m.id === messageId);
+        if (!message) {
+            throw new MessageNotFoundError(messageId);
+        }
+        if (message.senderId !== memberId) {
+            throw new NotMessageAuthorError();
+        }
+        message.deleted = true;
+        message.deletedBy = memberId;
+        // Emit message deleted event
+        this.eventEmitter.emitMessageDeleted('conversation', conversationId, messageId, memberId);
+    }
+    /**
+     * Promote a conversation to a group by adding new members.
+     * Delegates to the GroupPromotionHandler (wired from GroupService).
+     */
+    async promoteToGroup(conversationId, newMemberIds, requesterId) {
+        if (!this.groupPromotionHandler) {
+            throw new GroupPromotionNotConfiguredError();
+        }
+        const conversation = this.conversations.get(conversationId);
+        if (!conversation) {
+            throw new ConversationNotFoundError(conversationId);
+        }
+        if (conversation.participants[0] !== requesterId &&
+            conversation.participants[1] !== requesterId) {
+            throw new NotParticipantError();
+        }
+        const msgs = this.messages.get(conversationId) ?? [];
+        return this.groupPromotionHandler(conversationId, conversation.participants, newMemberIds, msgs, requesterId);
+    }
+    /**
+     * Get a conversation by ID. Returns undefined if not found.
+     */
+    getConversation(conversationId) {
+        return this.conversations.get(conversationId);
+    }
+    /**
+     * Get all messages for a conversation (no pagination). Used internally
+     * for promotion and testing.
+     */
+    getAllMessages(conversationId) {
+        return this.messages.get(conversationId) ?? [];
+    }
+    /**
+     * Return all conversations that include the given member (no pagination).
+     * Used by SearchService for cross-context keyword search.
+     */
+    listAllConversationsForMember(memberId) {
+        return Array.from(this.conversations.values()).filter((c) => c.participants[0] === memberId || c.participants[1] === memberId);
+    }
+}
+exports.ConversationService = ConversationService;
+//# sourceMappingURL=conversationService.js.map

package/src/lib/services/communication/conversationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationService.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/services/communication/conversationService.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,+BAAoC;AAOpC,oDAGiC;AACjC,uDAAuD;AAyBvD;;;;GAIG;AACH,MAAa,0BAA2B,SAAQ,KAAK;IACnD;QACE,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AALD,gEAKC;AAED,MAAa,yBAA0B,SAAQ,KAAK;IAClD,YAAY,cAAsB;QAChC,KAAK,CAAC,gBAAgB,cAAc,YAAY,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AALD,8DAKC;AAED,MAAa,mBAAoB,SAAQ,KAAK;IAC5C;QACE,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,SAAiB;QAC3B,KAAK,CAAC,WAAW,SAAS,YAAY,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC;AAED,MAAa,qBAAsB,SAAQ,KAAK;IAC9C;QACE,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC;AAED,MAAa,gCAAiC,SAAQ,KAAK;IACzD;QACE,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACjD,CAAC;CACF;AALD,4EAKC;AAED,MAAa,mBAAmB;IAoB9B,YACE,0BAA0D,IAAI,EAC9D,eAA2C,IAAI,yBAAgB,EAAE;QArBnE,qCAAqC;QACpB,kBAAa,GAAG,IAAI,GAAG,EAAyB,CAAC;QAElE,iEAAiE;QAChD,aAAQ,GAAG,IAAI,GAAG,EAAmC,CAAC;QAEvE,4DAA4D;QAC3C,qBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE9D,8CAA8C;QAC7B,iBAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QAElD,8BAA8B;QACb,iBAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QAE1C,0BAAqB,GAAiC,IAAI,CAAC;QAQjE,IAAI,CAAC,uBAAuB,GAAG,uBAAuB,CAAC;QACvD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAgB;QAC7B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,SAAiB,EAAE,SAAiB;QAC9C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,wBAAwB,CAAC,OAA8B;QACrD,IAAI,CAAC,qBAAqB,GAAG,OAAO,CAAC;IACvC,CAAC;IAED;;;OAGG;IACK,WAAW,CAAC,QAAgB,EAAE,WAAmB;QACvD,IAAI,IAAI,CAAC,uBAAuB,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,uBAAuB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,WAAW,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,CAAS,EAAE,CAAS;QACzC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,uBAAuB,CAC3B,OAAe,EACf,OAAe;QAEf,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACpD,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,YAAY,GAAkB;YAClC,EAAE,EAAE,IAAA,SAAM,GAAE;YACZ,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;YAChC,SAAS,EAAE,GAAG;YACd,aAAa,EAAE,GAAG;SACnB,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;QAEhD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CACrB,QAAgB,EAChB,MAAe,EACf,QAAgB,EAAE;QAElB,MAAM,mBAAmB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;aAChE,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,QAAQ,CACxE;aACA,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAEzE,OAAO,IAAA,0BAAa,EAAC,mBAAmB,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,cAAsB,EACtB,QAAgB,EAChB,MAAe,EACf,QAAgB,EAAE;QAElB,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5D,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,yBAAyB,CAAC,cAAc,CAAC,CAAC;QACtD,CAAC;QAED,IACE,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,QAAQ;YACzC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,QAAQ,EACzC,CAAC;YACD,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAErD,OAAO,IAAA,0BAAa,EAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CACf,QAAgB,EAChB,WAAmB,EACnB,OAAe,EACf,cAAuB;QAEvB,6DAA6D;QAC7D,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,0BAA0B,EAAE,CAAC;QACzC,CAAC;QAED,IAAI,YAA2B,CAAC;QAChC,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,yBAAyB,CAAC,cAAc,CAAC,CAAC;YACtD,CAAC;YACD,YAAY,GAAG,QAAQ,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAA0B;YACrC,EAAE,EAAE,IAAA,SAAM,GAAE;YACZ,WAAW,EAAE,cAAc;YAC3B,SAAS,EAAE,YAAY,CAAC,EAAE;YAC1B,QAAQ;YACR,gBAAgB,EAAE,OAAO;YACzB,SAAS,EAAE,GAAG;YACd,WAAW,EAAE,EAAE;YACf,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,EAAE;SACd,CAAC;QAEF,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAChD,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QAED,sCAAsC;QACtC,YAAY,CAAC,aAAa,GAAG,GAAG,CAAC;QAEjC,0BAA0B;QAC1B,IAAI,CAAC,YAAY,CAAC,eAAe,CAC/B,cAAc,EACd,YAAY,CAAC,EAAE,EACf,OAAO,CAAC,EAAE,EACV,QAAQ,CACT,CAAC;QAEF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CACjB,cAAsB,EACtB,SAAiB,EACjB,QAAgB;QAEhB,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5D,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,yBAAyB,CAAC,cAAc,CAAC,CAAC;QACtD,CAAC;QAED,IACE,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,QAAQ;YACzC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,QAAQ,EACzC,CAAC;YACD,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,qBAAqB,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC;QAE7B,6BAA6B;QAC7B,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAClC,cAAc,EACd,cAAc,EACd,SAAS,EACT,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAClB,cAAsB,EACtB,YAAsB,EACtB,WAAmB;QAEnB,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,MAAM,IAAI,gCAAgC,EAAE,CAAC;QAC/C,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5D,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,yBAAyB,CAAC,cAAc,CAAC,CAAC;QACtD,CAAC;QAED,IACE,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,WAAW;YAC5C,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,WAAW,EAC5C,CAAC;YACD,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAErD,OAAO,IAAI,CAAC,qBAAqB,CAC/B,cAAc,EACd,YAAY,CAAC,YAAY,EACzB,YAAY,EACZ,IAAI,EACJ,WAAW,CACZ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,cAAsB;QACpC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,cAAsB;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,6BAA6B,CAAC,QAAgB;QAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACnD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,QAAQ,CACxE,CAAC;IACJ,CAAC;CACF;AAvTD,kDAuTC"}

package/src/lib/services/communication/explodingMessageService.d.ts

@@ -0,0 +1,168 @@
+/**
+ * ExplodingMessageService — self-destructing message logic for BrightChain.
+ *
+ * Provides time-based and read-count-based message expiration with
+ * secure deletion. Messages can be configured to auto-destruct after
+ * a specified time or after being read a certain number of times.
+ *
+ * All methods are stateless and operate on message objects directly.
+ * Persistence and scheduling are handled by the caller.
+ *
+ * Requirements: 8.1, 8.2, 8.3, 8.4, 8.7
+ */
+import { CommunicationEventType } from '../../enumerations/communication';
+import { ICommunicationMessage } from '../../interfaces/communication';
+export declare class ExplodingMessageError extends Error {
+    constructor(message: string);
+}
+export declare class MessageAlreadyExplodedError extends ExplodingMessageError {
+    constructor(messageId: string);
+}
+export declare class InvalidExpirationError extends ExplodingMessageError {
+    constructor(reason: string);
+}
+/**
+ * Event emitted when a message explodes (is permanently deleted).
+ */
+export interface IExplodingMessageEvent {
+    type: CommunicationEventType;
+    messageId: string;
+    contextId: string;
+    contextType: 'conversation' | 'group' | 'channel';
+    reason: 'time_expired' | 'read_count_exceeded';
+    explodedAt: Date;
+}
+/**
+ * Result of checking expired messages.
+ */
+export interface IExpiredMessagesResult {
+    /** Messages that have expired and should be deleted */
+    expired: ICommunicationMessage[];
+    /** Events to emit for each expired message */
+    events: IExplodingMessageEvent[];
+}
+/**
+ * Service for managing self-destructing (exploding) messages.
+ *
+ * Supports two expiration modes:
+ * - Time-based: message expires after a specified duration
+ * - Read-count: message expires after being read N times
+ *
+ * Both modes can be combined on a single message.
+ *
+ * @example
+ * ```typescript
+ * // Set a 5-minute expiration
+ * ExplodingMessageService.setExpiration(message, {
+ *   expiresInMs: 5 * 60 * 1000,
+ * });
+ *
+ * // Set a read-count limit
+ * ExplodingMessageService.setExpiration(message, {
+ *   maxReads: 3,
+ * });
+ *
+ * // Mark as read by a member
+ * ExplodingMessageService.markRead(message, 'member-123');
+ *
+ * // Check if expired
+ * const shouldExplode = ExplodingMessageService.checkExpiration(message);
+ * ```
+ */
+export declare class ExplodingMessageService {
+    /**
+     * Configure expiration settings on a message.
+     *
+     * @param message     - The message to configure
+     * @param options     - Expiration options
+     * @param options.expiresAt   - Absolute expiration time
+     * @param options.expiresInMs - Relative expiration (milliseconds from now)
+     * @param options.maxReads    - Maximum read count before expiration
+     * @throws {MessageAlreadyExplodedError} If the message has already exploded
+     * @throws {InvalidExpirationError} If no expiration option is provided
+     *
+     * Requirements: 8.1, 8.2
+     */
+    static setExpiration(message: ICommunicationMessage, options: {
+        expiresAt?: Date;
+        expiresInMs?: number;
+        maxReads?: number;
+    }): void;
+    /**
+     * Record that a member has read a message.
+     *
+     * Increments the read count and records the member's read timestamp.
+     * If the member has already read the message, this is a no-op for
+     * the read count but updates the timestamp.
+     *
+     * @param message  - The message to mark as read
+     * @param memberId - The ID of the member who read the message
+     * @returns `true` if the message should now be exploded (read count exceeded)
+     * @throws {MessageAlreadyExplodedError} If the message has already exploded
+     *
+     * Requirements: 8.2, 8.3
+     */
+    static markRead(message: ICommunicationMessage, memberId: string): boolean;
+    /**
+     * Check whether a message has expired based on its expiration settings.
+     *
+     * Checks both time-based and read-count-based expiration.
+     *
+     * @param message - The message to check
+     * @param now     - Optional current time (defaults to Date.now())
+     * @returns The reason for expiration, or `null` if not expired
+     *
+     * Requirements: 8.1, 8.2, 8.4
+     */
+    static checkExpiration(message: ICommunicationMessage, now?: Date): 'time_expired' | 'read_count_exceeded' | null;
+    /**
+     * Explode (permanently delete) a message.
+     *
+     * Clears the encrypted content and marks the message as exploded.
+     * The message metadata is preserved for audit purposes.
+     *
+     * @param message - The message to explode
+     * @returns The explosion event
+     * @throws {MessageAlreadyExplodedError} If the message has already exploded
+     *
+     * Requirements: 8.4, 8.7
+     */
+    static explode(message: ICommunicationMessage): IExplodingMessageEvent;
+    /**
+     * Scan a collection of messages and find all that have expired.
+     *
+     * Returns the expired messages and the events to emit for each.
+     * Does NOT modify the messages — call {@link explode} on each
+     * returned message to actually delete them.
+     *
+     * @param messages - The messages to scan
+     * @param now      - Optional current time (defaults to Date.now())
+     * @returns The expired messages and their events
+     *
+     * Requirements: 8.4
+     */
+    static deleteExpired(messages: ReadonlyArray<ICommunicationMessage>, now?: Date): IExpiredMessagesResult;
+    /**
+     * Check if a message is an exploding message (has any expiration configured).
+     *
+     * @param message - The message to check
+     * @returns `true` if the message has expiration settings
+     */
+    static isExplodingMessage(message: ICommunicationMessage): boolean;
+    /**
+     * Get the remaining time until a message expires (in milliseconds).
+     *
+     * @param message - The message to check
+     * @param now     - Optional current time
+     * @returns Remaining time in ms, or `null` if no time-based expiration
+     */
+    static getRemainingTime(message: ICommunicationMessage, now?: Date): number | null;
+    /**
+     * Get the remaining reads before a message expires.
+     *
+     * @param message - The message to check
+     * @returns Remaining reads, or `null` if no read-count expiration
+     */
+    static getRemainingReads(message: ICommunicationMessage): number | null;
+}
+//# sourceMappingURL=explodingMessageService.d.ts.map

package/src/lib/services/communication/explodingMessageService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explodingMessageService.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/services/communication/explodingMessageService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAIvE,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,2BAA4B,SAAQ,qBAAqB;gBACxD,SAAS,EAAE,MAAM;CAI9B;AAED,qBAAa,sBAAuB,SAAQ,qBAAqB;gBACnD,MAAM,EAAE,MAAM;CAI3B;AAID;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;IAClD,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAAC;IAC/C,UAAU,EAAE,IAAI,CAAC;CAClB;AAID;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,8CAA8C;IAC9C,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,uBAAuB;IAClC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,aAAa,CAClB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE;QACP,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,IAAI;IA6CP;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IA6B1E;;;;;;;;;;OAUG;IACH,MAAM,CAAC,eAAe,CACpB,OAAO,EAAE,qBAAqB,EAC9B,GAAG,CAAC,EAAE,IAAI,GACT,cAAc,GAAG,qBAAqB,GAAG,IAAI;IAwBhD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,sBAAsB;IAuBtE;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,aAAa,CAClB,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,EAC9C,GAAG,CAAC,EAAE,IAAI,GACT,sBAAsB;IA+BzB;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO;IAIlE;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CACrB,OAAO,EAAE,qBAAqB,EAC9B,GAAG,CAAC,EAAE,IAAI,GACT,MAAM,GAAG,IAAI;IAShB;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI;CAOxE"}