@brightchain/brightchain-lib 0.13.0 → 0.15.0

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

@@ -0,0 +1,287 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExplodingMessageService = exports.InvalidExpirationError = exports.MessageAlreadyExplodedError = exports.ExplodingMessageError = void 0;
+const communication_1 = require("../../enumerations/communication");
+// ─── Error classes ──────────────────────────────────────────────────────────
+class ExplodingMessageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ExplodingMessageError';
+    }
+}
+exports.ExplodingMessageError = ExplodingMessageError;
+class MessageAlreadyExplodedError extends ExplodingMessageError {
+    constructor(messageId) {
+        super(`Message ${messageId} has already been exploded`);
+        this.name = 'MessageAlreadyExplodedError';
+    }
+}
+exports.MessageAlreadyExplodedError = MessageAlreadyExplodedError;
+class InvalidExpirationError extends ExplodingMessageError {
+    constructor(reason) {
+        super(`Invalid expiration configuration: ${reason}`);
+        this.name = 'InvalidExpirationError';
+    }
+}
+exports.InvalidExpirationError = InvalidExpirationError;
+// ─── Service ────────────────────────────────────────────────────────────────
+/**
+ * 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);
+ * ```
+ */
+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, options) {
+        if (message.exploded) {
+            throw new MessageAlreadyExplodedError(String(message.id));
+        }
+        const hasTimeExpiration = options.expiresAt !== undefined || options.expiresInMs !== undefined;
+        const hasReadExpiration = options.maxReads !== undefined;
+        if (!hasTimeExpiration && !hasReadExpiration) {
+            throw new InvalidExpirationError('At least one of expiresAt, expiresInMs, or maxReads must be provided');
+        }
+        if (options.expiresAt !== undefined) {
+            if (options.expiresAt <= new Date()) {
+                throw new InvalidExpirationError('expiresAt must be in the future');
+            }
+            message.expiresAt = options.expiresAt;
+        }
+        if (options.expiresInMs !== undefined) {
+            if (options.expiresInMs <= 0) {
+                throw new InvalidExpirationError('expiresInMs must be a positive number');
+            }
+            message.expiresAt = new Date(Date.now() + options.expiresInMs);
+        }
+        if (options.maxReads !== undefined) {
+            if (options.maxReads < 1 || !Number.isInteger(options.maxReads)) {
+                throw new InvalidExpirationError('maxReads must be a positive integer');
+            }
+            message.maxReads = options.maxReads;
+            if (message.readCount === undefined) {
+                message.readCount = 0;
+            }
+            if (message.readBy === undefined) {
+                message.readBy = new Map();
+            }
+        }
+    }
+    /**
+     * 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, memberId) {
+        if (message.exploded) {
+            throw new MessageAlreadyExplodedError(String(message.id));
+        }
+        if (!message.readBy) {
+            message.readBy = new Map();
+        }
+        const isFirstRead = !message.readBy.has(memberId);
+        message.readBy.set(memberId, new Date());
+        if (isFirstRead && message.readCount !== undefined) {
+            message.readCount++;
+        }
+        // Check if read count exceeded
+        if (message.maxReads !== undefined &&
+            message.readCount !== undefined &&
+            message.readCount >= message.maxReads) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 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, now) {
+        if (message.exploded) {
+            return null; // Already handled
+        }
+        const currentTime = now ?? new Date();
+        // Check time-based expiration
+        if (message.expiresAt && currentTime >= message.expiresAt) {
+            return 'time_expired';
+        }
+        // Check read-count expiration
+        if (message.maxReads !== undefined &&
+            message.readCount !== undefined &&
+            message.readCount >= message.maxReads) {
+            return 'read_count_exceeded';
+        }
+        return 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) {
+        if (message.exploded) {
+            throw new MessageAlreadyExplodedError(String(message.id));
+        }
+        const reason = ExplodingMessageService.checkExpiration(message);
+        // Clear sensitive content
+        message.encryptedContent = '';
+        message.editHistory = [];
+        message.exploded = true;
+        message.explodedAt = new Date();
+        return {
+            type: communication_1.CommunicationEventType.MESSAGE_EXPLODED,
+            messageId: String(message.id),
+            contextId: String(message.contextId),
+            contextType: message.contextType,
+            reason: reason ?? 'time_expired',
+            explodedAt: message.explodedAt,
+        };
+    }
+    /**
+     * 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, now) {
+        const expired = [];
+        const events = [];
+        const currentTime = now ?? new Date();
+        for (const message of messages) {
+            if (message.exploded)
+                continue;
+            const reason = ExplodingMessageService.checkExpiration(message, currentTime);
+            if (reason) {
+                expired.push(message);
+                events.push({
+                    type: reason === 'time_expired'
+                        ? communication_1.CommunicationEventType.MESSAGE_EXPIRED
+                        : communication_1.CommunicationEventType.MESSAGE_READ_COUNT_EXCEEDED,
+                    messageId: String(message.id),
+                    contextId: String(message.contextId),
+                    contextType: message.contextType,
+                    reason,
+                    explodedAt: currentTime,
+                });
+            }
+        }
+        return { expired, events };
+    }
+    /**
+     * 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) {
+        return message.expiresAt !== undefined || message.maxReads !== undefined;
+    }
+    /**
+     * 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, now) {
+        if (!message.expiresAt)
+            return null;
+        if (message.exploded)
+            return 0;
+        const currentTime = now ?? new Date();
+        const remaining = message.expiresAt.getTime() - currentTime.getTime();
+        return Math.max(0, remaining);
+    }
+    /**
+     * 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) {
+        if (message.maxReads === undefined)
+            return null;
+        if (message.exploded)
+            return 0;
+        const readCount = message.readCount ?? 0;
+        return Math.max(0, message.maxReads - readCount);
+    }
+}
+exports.ExplodingMessageService = ExplodingMessageService;
+//# sourceMappingURL=explodingMessageService.js.map

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

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

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

@@ -0,0 +1,165 @@
+/**
+ * GroupService — manages group lifecycle, key management, and messaging.
+ *
+ * Maintains in-memory stores for groups and messages, with symmetric key
+ * generation per group and ECIES-style per-member key encryption.
+ * Supports member management with key rotation on departure,
+ * message edit/delete/pin/reaction operations.
+ *
+ * Requirements: 10.2
+ */
+import { Permission } from '../../enumerations/communication';
+import { ICommunicationMessage, IGroup, IPaginatedResult } from '../../interfaces/communication';
+import { ICommunicationEventEmitter } from '../../interfaces/events';
+import { MessageOperationsService } from './messageOperationsService';
+import { PermissionService } from './permissionService';
+export declare class GroupNotFoundError extends Error {
+    constructor(groupId: string);
+}
+export declare class NotGroupMemberError extends Error {
+    constructor();
+}
+export declare class GroupMessageNotFoundError extends Error {
+    constructor(messageId: string);
+}
+export declare class GroupPermissionError extends Error {
+    readonly missingPermission: Permission;
+    constructor(permission: Permission);
+}
+export declare class MemberMutedError extends Error {
+    constructor();
+}
+export declare class NotMessageAuthorError extends Error {
+    constructor();
+}
+export declare class ReactionNotFoundError extends Error {
+    constructor(reactionId: string);
+}
+export declare class MemberAlreadyInGroupError extends Error {
+    constructor(memberId: string);
+}
+/**
+ * Callback for encrypting a symmetric key for a specific member.
+ * In production this would use ECIES with the member's public key.
+ * Returns the encrypted key as a string (e.g. base64).
+ */
+export type KeyEncryptionHandler = (memberId: string, symmetricKey: Uint8Array) => string;
+/**
+ * Extract the symmetric key from a default-encrypted key string.
+ * Only works with the default placeholder encryption.
+ */
+export declare function extractKeyFromDefault(encrypted: string): Uint8Array;
+export declare class GroupService {
+    /** groupId → IGroup */
+    private readonly groups;
+    /** groupId → messages (ordered by createdAt ascending) */
+    private readonly messages;
+    /** groupId → raw symmetric key (Uint8Array) */
+    private readonly symmetricKeys;
+    private readonly permissionService;
+    private readonly encryptKey;
+    private readonly messageOps;
+    private readonly eventEmitter;
+    private readonly randomBytesProvider;
+    constructor(permissionService: PermissionService, encryptKey?: KeyEncryptionHandler, messageOps?: MessageOperationsService, eventEmitter?: ICommunicationEventEmitter, randomBytesProvider?: (length: number) => Uint8Array);
+    private assertGroupExists;
+    private assertIsMember;
+    private assertPermission;
+    private assertNotMuted;
+    private generateSymmetricKey;
+    private encryptKeyForMembers;
+    /**
+     * Rotate the group's symmetric key and re-encrypt for remaining members.
+     * Requirement 10.2: key rotation on member departure.
+     */
+    private rotateKey;
+    /**
+     * Create a new group with the given members.
+     * Generates a shared symmetric key and encrypts it for each member.
+     * The creator is assigned the OWNER role; others get MEMBER.
+     *
+     * Requirement 10.2: group creation with symmetric key management.
+     */
+    createGroup(name: string, creatorId: string, memberIds: string[]): Promise<IGroup>;
+    /**
+     * Create a group from a promoted conversation, preserving message history.
+     * Used by ConversationService.promoteToGroup.
+     */
+    createGroupFromConversation(conversationId: string, existingParticipants: [string, string], newMemberIds: string[], existingMessages: ICommunicationMessage[], requesterId: string): Promise<IGroup>;
+    /**
+     * Get group metadata.
+     */
+    getGroup(groupId: string, requesterId: string): Promise<IGroup>;
+    /**
+     * Send a message to a group.
+     * Requirement 10.2: group messaging with permission and mute checks.
+     */
+    sendMessage(groupId: string, senderId: string, content: string): Promise<ICommunicationMessage>;
+    /**
+     * Get messages in a group with cursor-based pagination.
+     */
+    getMessages(groupId: string, memberId: string, cursor?: string, limit?: number): Promise<IPaginatedResult<ICommunicationMessage>>;
+    /**
+     * Add members to a group. Re-encrypts the shared key for new members.
+     * Requirement 10.2: membership management.
+     */
+    addMembers(groupId: string, requesterId: string, memberIds: string[]): Promise<void>;
+    /**
+     * Remove a member from a group. Rotates the shared key.
+     * Requirement 10.2: key rotation on member removal.
+     */
+    removeMember(groupId: string, requesterId: string, targetId: string): Promise<void>;
+    /**
+     * Leave a group voluntarily. Rotates the shared key.
+     * Requirement 10.2: key rotation on member departure.
+     */
+    leaveGroup(groupId: string, memberId: string): Promise<void>;
+    /**
+     * Edit a message authored by the requesting member.
+     * Delegates to MessageOperationsService.
+     */
+    editMessage(groupId: string, messageId: string, memberId: string, newContent: string): Promise<ICommunicationMessage>;
+    /**
+     * Delete a message. Authors can delete their own; moderators/admins can delete any.
+     * Delegates to MessageOperationsService.
+     */
+    deleteMessage(groupId: string, messageId: string, memberId: string): Promise<void>;
+    /**
+     * Pin a message in a group.
+     * Delegates to MessageOperationsService.
+     */
+    pinMessage(groupId: string, messageId: string, memberId: string): Promise<void>;
+    /**
+     * Unpin a message in a group.
+     * Delegates to MessageOperationsService.
+     */
+    unpinMessage(groupId: string, messageId: string, memberId: string): Promise<void>;
+    /**
+     * Add a reaction to a message.
+     * Delegates to MessageOperationsService.
+     */
+    addReaction(groupId: string, messageId: string, memberId: string, emoji: string): Promise<string>;
+    /**
+     * Remove a reaction from a message.
+     * Delegates to MessageOperationsService.
+     */
+    removeReaction(groupId: string, messageId: string, memberId: string, reactionId: string): Promise<void>;
+    /**
+     * Get a group by ID without membership check. Returns undefined if not found.
+     */
+    getGroupById(groupId: string): IGroup | undefined;
+    /**
+     * Get the raw symmetric key for a group (testing only).
+     */
+    getSymmetricKey(groupId: string): Uint8Array | undefined;
+    /**
+     * Get all messages for a group without pagination (testing/internal).
+     */
+    getAllMessages(groupId: string): ICommunicationMessage[];
+    /**
+     * Return all groups the given member belongs to (no pagination).
+     * Used by SearchService for cross-context keyword search.
+     */
+    listGroupsForMember(memberId: string): IGroup[];
+}
+//# sourceMappingURL=groupService.d.ts.map

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

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