@brightchain/brightchain-api-lib 0.14.0 → 0.15.0

package/src/lib/controllers/api/explodingMessages.js

@@ -0,0 +1,378 @@
+"use strict";
+/**
+ * ExplodingMessagesController — REST API for self-destructing message operations.
+ *
+ * Routes:
+ *   PUT  /:id/set-expiration   — Set expiration on a message
+ *   POST /:id/mark-read        — Mark a message as read by a member
+ *   GET  /expired               — List expired messages
+ *   POST /:id/explode          — Force-explode a message
+ *   GET  /:id/expiration-info  — Get expiration status of a message
+ *
+ * Requirements: 8.1-8.9
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExplodingMessagesController = void 0;
+const explodingMessageService_1 = require("@brightchain/brightchain-lib/lib/services/communication/explodingMessageService");
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+const errorResponse_1 = require("../../utils/errorResponse");
+const base_1 = require("../base");
+// ─── Message store (in-memory for now, replaced by persistence layer) ───────
+/**
+ * Simple in-memory message store for exploding message operations.
+ * In production, this would be replaced by the actual message persistence layer.
+ */
+class ExplodingMessageStore {
+    constructor() {
+        this.messages = new Map();
+    }
+    get(id) {
+        return this.messages.get(id);
+    }
+    set(message) {
+        this.messages.set(String(message.id), message);
+    }
+    getAll() {
+        return Array.from(this.messages.values());
+    }
+    remove(id) {
+        return this.messages.delete(id);
+    }
+}
+// ─── Controller ─────────────────────────────────────────────────────────────
+/**
+ * Controller for exploding (self-destructing) message operations.
+ *
+ * Delegates to {@link ExplodingMessageService} in brightchain-lib for
+ * core expiration logic including time-based and read-count-based
+ * message self-destruction.
+ *
+ * @requirements 8.1, 8.2, 8.3, 8.4, 8.5, 8.7, 8.8
+ */
+class ExplodingMessagesController extends base_1.BaseController {
+    constructor(application) {
+        super(application);
+        this.messageStore = new ExplodingMessageStore();
+    }
+    /**
+     * Inject a message into the store (for integration with message passing).
+     */
+    registerMessage(message) {
+        this.messageStore.set(message);
+    }
+    // ─── Route definitions ──────────────────────────────────────────────────
+    initRouteDefinitions() {
+        const noAuth = {
+            useAuthentication: false,
+            useCryptoAuthentication: false,
+        };
+        this.routeDefinitions = [
+            (0, node_express_suite_1.routeConfig)('put', '/:id/set-expiration', {
+                ...noAuth,
+                handlerKey: 'setExpiration',
+                openapi: {
+                    summary: 'Set message expiration',
+                    description: 'Configure time-based or read-count-based expiration on a message.',
+                    tags: ['Exploding Messages'],
+                    responses: {
+                        200: {
+                            schema: 'SetExpirationResponse',
+                            description: 'Expiration set successfully',
+                        },
+                        400: {
+                            schema: 'ApiErrorResponse',
+                            description: 'Invalid expiration settings',
+                        },
+                        404: {
+                            schema: 'ApiErrorResponse',
+                            description: 'Message not found',
+                        },
+                    },
+                },
+            }),
+            (0, node_express_suite_1.routeConfig)('post', '/:id/mark-read', {
+                ...noAuth,
+                handlerKey: 'markRead',
+                openapi: {
+                    summary: 'Mark message as read',
+                    description: 'Record that a member has read the message. Returns whether the message should explode.',
+                    tags: ['Exploding Messages'],
+                    responses: {
+                        200: {
+                            schema: 'MarkReadResponse',
+                            description: 'Read recorded',
+                        },
+                        404: {
+                            schema: 'ApiErrorResponse',
+                            description: 'Message not found',
+                        },
+                    },
+                },
+            }),
+            (0, node_express_suite_1.routeConfig)('get', '/expired', {
+                ...noAuth,
+                handlerKey: 'getExpired',
+                openapi: {
+                    summary: 'List expired messages',
+                    description: 'Returns all messages that have expired and should be deleted.',
+                    tags: ['Exploding Messages'],
+                    responses: {
+                        200: {
+                            schema: 'GetExpiredResponse',
+                            description: 'List of expired messages',
+                        },
+                    },
+                },
+            }),
+            (0, node_express_suite_1.routeConfig)('post', '/:id/explode', {
+                ...noAuth,
+                handlerKey: 'explodeMessage',
+                openapi: {
+                    summary: 'Force-explode a message',
+                    description: 'Immediately explode (permanently delete) a message regardless of expiration settings.',
+                    tags: ['Exploding Messages'],
+                    responses: {
+                        200: {
+                            schema: 'ExplodeMessageResponse',
+                            description: 'Message exploded',
+                        },
+                        404: {
+                            schema: 'ApiErrorResponse',
+                            description: 'Message not found',
+                        },
+                    },
+                },
+            }),
+            (0, node_express_suite_1.routeConfig)('get', '/:id/expiration-info', {
+                ...noAuth,
+                handlerKey: 'getExpirationInfo',
+                openapi: {
+                    summary: 'Get expiration info',
+                    description: 'Returns the expiration status and remaining time/reads for a message.',
+                    tags: ['Exploding Messages'],
+                    responses: {
+                        200: {
+                            schema: 'GetExpirationInfoResponse',
+                            description: 'Expiration info',
+                        },
+                        404: {
+                            schema: 'ApiErrorResponse',
+                            description: 'Message not found',
+                        },
+                    },
+                },
+            }),
+        ];
+        this.handlers = {
+            setExpiration: this.handleSetExpiration.bind(this),
+            markRead: this.handleMarkRead.bind(this),
+            getExpired: this.handleGetExpired.bind(this),
+            explodeMessage: this.handleExplodeMessage.bind(this),
+            getExpirationInfo: this.handleGetExpirationInfo.bind(this),
+        };
+    }
+    // ─── Handlers ─────────────────────────────────────────────────────────
+    /**
+     * PUT /:id/set-expiration — Set expiration on a message.
+     *
+     * @requirements 8.1, 8.2, 8.5
+     */
+    async handleSetExpiration(req) {
+        try {
+            const { id } = req.params;
+            const { expiresAt, expiresInMs, maxReads } = req
+                .body;
+            if (!id) {
+                return (0, errorResponse_1.validationError)('Missing required parameter: id');
+            }
+            const message = this.messageStore.get(id);
+            if (!message) {
+                return (0, errorResponse_1.notFoundError)('Message', id);
+            }
+            explodingMessageService_1.ExplodingMessageService.setExpiration(message, {
+                expiresAt: expiresAt ? new Date(expiresAt) : undefined,
+                expiresInMs,
+                maxReads,
+            });
+            return {
+                statusCode: 200,
+                response: {
+                    status: 'success',
+                    data: {
+                        messageId: id,
+                        expiresAt: message.expiresAt?.toISOString(),
+                        maxReads: message.maxReads,
+                    },
+                    message: 'Expiration set successfully',
+                },
+            };
+        }
+        catch (error) {
+            return this.mapExplodingError(error);
+        }
+    }
+    /**
+     * POST /:id/mark-read — Mark a message as read.
+     *
+     * @requirements 8.2, 8.3, 8.8
+     */
+    async handleMarkRead(req) {
+        try {
+            const { id } = req.params;
+            const { memberId } = req.body;
+            if (!id) {
+                return (0, errorResponse_1.validationError)('Missing required parameter: id');
+            }
+            if (!memberId || typeof memberId !== 'string') {
+                return (0, errorResponse_1.validationError)('Missing required field: memberId');
+            }
+            const message = this.messageStore.get(id);
+            if (!message) {
+                return (0, errorResponse_1.notFoundError)('Message', id);
+            }
+            const shouldExplode = explodingMessageService_1.ExplodingMessageService.markRead(message, memberId);
+            if (shouldExplode) {
+                explodingMessageService_1.ExplodingMessageService.explode(message);
+            }
+            return {
+                statusCode: 200,
+                response: {
+                    status: 'success',
+                    data: {
+                        messageId: id,
+                        readCount: message.readCount ?? 0,
+                        shouldExplode,
+                    },
+                    message: shouldExplode
+                        ? 'Message read count exceeded — message exploded'
+                        : 'Read recorded',
+                },
+            };
+        }
+        catch (error) {
+            return this.mapExplodingError(error);
+        }
+    }
+    /**
+     * GET /expired — List all expired messages.
+     *
+     * @requirements 8.4, 8.8
+     */
+    async handleGetExpired(_req) {
+        try {
+            const allMessages = this.messageStore.getAll();
+            const result = explodingMessageService_1.ExplodingMessageService.deleteExpired(allMessages);
+            return {
+                statusCode: 200,
+                response: {
+                    status: 'success',
+                    data: {
+                        expired: result.events.map((e) => ({
+                            messageId: e.messageId,
+                            reason: e.reason,
+                        })),
+                        totalCount: result.expired.length,
+                    },
+                    message: `Found ${result.expired.length} expired message(s)`,
+                },
+            };
+        }
+        catch (error) {
+            return (0, errorResponse_1.handleError)(error);
+        }
+    }
+    /**
+     * POST /:id/explode — Force-explode a message.
+     *
+     * @requirements 8.4, 8.7
+     */
+    async handleExplodeMessage(req) {
+        try {
+            const { id } = req.params;
+            if (!id) {
+                return (0, errorResponse_1.validationError)('Missing required parameter: id');
+            }
+            const message = this.messageStore.get(id);
+            if (!message) {
+                return (0, errorResponse_1.notFoundError)('Message', id);
+            }
+            const event = explodingMessageService_1.ExplodingMessageService.explode(message);
+            return {
+                statusCode: 200,
+                response: {
+                    status: 'success',
+                    data: {
+                        messageId: id,
+                        exploded: true,
+                        explodedAt: event.explodedAt.toISOString(),
+                    },
+                    message: 'Message exploded',
+                },
+            };
+        }
+        catch (error) {
+            return this.mapExplodingError(error);
+        }
+    }
+    /**
+     * GET /:id/expiration-info — Get expiration status.
+     *
+     * @requirements 8.8
+     */
+    async handleGetExpirationInfo(req) {
+        try {
+            const { id } = req.params;
+            if (!id) {
+                return (0, errorResponse_1.validationError)('Missing required parameter: id');
+            }
+            const message = this.messageStore.get(id);
+            if (!message) {
+                return (0, errorResponse_1.notFoundError)('Message', id);
+            }
+            return {
+                statusCode: 200,
+                response: {
+                    status: 'success',
+                    data: {
+                        messageId: id,
+                        isExploding: explodingMessageService_1.ExplodingMessageService.isExplodingMessage(message),
+                        expiresAt: message.expiresAt?.toISOString(),
+                        maxReads: message.maxReads,
+                        readCount: message.readCount,
+                        remainingTimeMs: explodingMessageService_1.ExplodingMessageService.getRemainingTime(message),
+                        remainingReads: explodingMessageService_1.ExplodingMessageService.getRemainingReads(message),
+                        exploded: message.exploded ?? false,
+                    },
+                    message: 'Expiration info retrieved',
+                },
+            };
+        }
+        catch (error) {
+            return (0, errorResponse_1.handleError)(error);
+        }
+    }
+    // ─── Error mapping ──────────────────────────────────────────────────
+    mapExplodingError(error) {
+        if (error instanceof explodingMessageService_1.MessageAlreadyExplodedError) {
+            return {
+                statusCode: 400,
+                response: {
+                    message: error.message,
+                    error: 'MESSAGE_ALREADY_EXPLODED',
+                },
+            };
+        }
+        if (error instanceof explodingMessageService_1.InvalidExpirationError) {
+            return {
+                statusCode: 400,
+                response: {
+                    message: error.message,
+                    error: 'INVALID_EXPIRATION',
+                },
+            };
+        }
+        return (0, errorResponse_1.handleError)(error);
+    }
+}
+exports.ExplodingMessagesController = ExplodingMessagesController;
+//# sourceMappingURL=explodingMessages.js.map

package/src/lib/controllers/api/explodingMessages.js.map

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

package/src/lib/controllers/api/groups.d.ts

@@ -0,0 +1,94 @@
+/**
+ * GroupController — REST API for group chat management.
+ *
+ * Routes:
+ *   POST   /                                        — Create a group
+ *   GET    /:groupId                                — Get group metadata
+ *   POST   /:groupId/messages                       — Send a message
+ *   GET    /:groupId/messages                       — Get message history
+ *   POST   /:groupId/members                        — Add member(s)
+ *   DELETE /:groupId/members/:memberId              — Remove member
+ *   POST   /:groupId/leave                          — Leave group
+ *   PUT    /:groupId/roles/:memberId                — Assign role
+ *   POST   /:groupId/messages/:messageId/reactions   — Add reaction
+ *   DELETE /:groupId/messages/:messageId/reactions/:reactionId — Remove reaction
+ *   PUT    /:groupId/messages/:messageId             — Edit message
+ *   POST   /:groupId/messages/:messageId/pin         — Pin message
+ *   DELETE /:groupId/messages/:messageId/pin         — Unpin message
+ *
+ * Requirements: 3.1, 3.2, 3.3, 3.4, 3.5, 3.6
+ */
+import { IAddGroupMembersResponse, IAddReactionResponse, IAssignRoleResponse, ICreateGroupResponse, IEditMessageResponse, IGetGroupMessagesResponse, IGetGroupResponse, ILeaveGroupResponse, IPinMessageResponse, IRemoveGroupMemberResponse, IRemoveReactionResponse, ISendGroupMessageResponse, IUnpinMessageResponse } from '@brightchain/brightchain-lib';
+import { GroupService } from '@brightchain/brightchain-lib/lib/services/communication/groupService';
+import { PermissionService } from '@brightchain/brightchain-lib/lib/services/communication/permissionService';
+import { CoreLanguageCode } from '@digitaldefiance/i18n-lib';
+import { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import { ApiErrorResponse, ApiRequestHandler, TypedHandlers } from '@digitaldefiance/node-express-suite';
+import { IBrightChainApplication } from '../../interfaces/application';
+import { DefaultBackendIdType } from '../../shared-types';
+import { BaseController } from '../base';
+type GroupApiResponse = ICreateGroupResponse | IGetGroupResponse | ISendGroupMessageResponse | IGetGroupMessagesResponse | IAddGroupMembersResponse | IRemoveGroupMemberResponse | ILeaveGroupResponse | IAssignRoleResponse | IAddReactionResponse | IRemoveReactionResponse | IEditMessageResponse | IPinMessageResponse | IUnpinMessageResponse | ApiErrorResponse;
+interface GroupHandlers extends TypedHandlers {
+    createGroup: ApiRequestHandler<ICreateGroupResponse | ApiErrorResponse>;
+    getGroup: ApiRequestHandler<IGetGroupResponse | ApiErrorResponse>;
+    sendMessage: ApiRequestHandler<ISendGroupMessageResponse | ApiErrorResponse>;
+    getMessages: ApiRequestHandler<IGetGroupMessagesResponse | ApiErrorResponse>;
+    addMembers: ApiRequestHandler<IAddGroupMembersResponse | ApiErrorResponse>;
+    removeMember: ApiRequestHandler<IRemoveGroupMemberResponse | ApiErrorResponse>;
+    leaveGroup: ApiRequestHandler<ILeaveGroupResponse | ApiErrorResponse>;
+    assignRole: ApiRequestHandler<IAssignRoleResponse | ApiErrorResponse>;
+    addReaction: ApiRequestHandler<IAddReactionResponse | ApiErrorResponse>;
+    removeReaction: ApiRequestHandler<IRemoveReactionResponse | ApiErrorResponse>;
+    editMessage: ApiRequestHandler<IEditMessageResponse | ApiErrorResponse>;
+    pinMessage: ApiRequestHandler<IPinMessageResponse | ApiErrorResponse>;
+    unpinMessage: ApiRequestHandler<IUnpinMessageResponse | ApiErrorResponse>;
+}
+/**
+ * Controller for group chat operations.
+ *
+ * @requirements 3.1, 3.2, 3.3, 3.4, 3.5, 3.6
+ */
+export declare class GroupController<TID extends PlatformID = DefaultBackendIdType> extends BaseController<TID, GroupApiResponse, GroupHandlers, CoreLanguageCode> {
+    private groupService;
+    private permissionService;
+    constructor(application: IBrightChainApplication<TID>);
+    setGroupService(service: GroupService): void;
+    setPermissionService(service: PermissionService): void;
+    private getGroupService;
+    private getPermissionService;
+    /**
+     * Extract the authenticated member ID from the request.
+     * Falls back to body/query memberId for testing.
+     */
+    private getMemberId;
+    protected initRouteDefinitions(): void;
+    /** POST / — Create a group. @requirements 3.1 */
+    private handleCreateGroup;
+    /** GET /:groupId — Get group metadata. @requirements 3.6 */
+    private handleGetGroup;
+    /** POST /:groupId/messages — Send a message. @requirements 3.2 */
+    private handleSendMessage;
+    /** GET /:groupId/messages — Get message history. */
+    private handleGetMessages;
+    /** POST /:groupId/members — Add member(s). @requirements 3.3 */
+    private handleAddMembers;
+    /** DELETE /:groupId/members/:memberId — Remove member. @requirements 3.4 */
+    private handleRemoveMember;
+    /** POST /:groupId/leave — Leave group. @requirements 3.5 */
+    private handleLeaveGroup;
+    /** PUT /:groupId/roles/:memberId — Assign role. @requirements 6.2 */
+    private handleAssignRole;
+    /** POST /:groupId/messages/:messageId/reactions — Add reaction. @requirements 9.5 */
+    private handleAddReaction;
+    /** DELETE /:groupId/messages/:messageId/reactions/:reactionId — Remove reaction. */
+    private handleRemoveReaction;
+    /** PUT /:groupId/messages/:messageId — Edit message. @requirements 9.1 */
+    private handleEditMessage;
+    /** POST /:groupId/messages/:messageId/pin — Pin message. @requirements 9.4 */
+    private handlePinMessage;
+    /** DELETE /:groupId/messages/:messageId/pin — Unpin message. @requirements 9.4 */
+    private handleUnpinMessage;
+    private mapServiceError;
+}
+export {};
+//# sourceMappingURL=groups.d.ts.map

package/src/lib/controllers/api/groups.d.ts.map

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