@brightchain/brightchain-api-lib 0.14.0 → 0.16.0

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

@@ -7,99 +7,6 @@ const base_1 = require("../base");
 class EnergyController extends base_1.BaseController {
     constructor(application) {
         super(application);
-        this.handleGetBalance = async (req) => {
-            const user = req.user;
-            if (!user) {
-                return {
-                    statusCode: 401,
-                    response: {
-                        message: 'Not authenticated',
-                        error: 'Not authenticated',
-                    },
-                };
-            }
-            try {
-                const energyStore = this.application.services.get('energyStore');
-                const memberChecksum = brightchain_lib_1.Checksum.fromHex(user.memberId);
-                const account = energyStore.get(memberChecksum);
-                if (!account) {
-                    return {
-                        statusCode: 404,
-                        response: {
-                            message: 'Energy account not found',
-                            error: 'Energy account not found',
-                        },
-                    };
-                }
-                return {
-                    statusCode: 200,
-                    response: {
-                        message: 'Balance retrieved',
-                        balance: account.balance,
-                        earned: account.earned,
-                        spent: account.spent,
-                        reserved: account.reserved,
-                        reputation: account.reputation,
-                    },
-                };
-            }
-            catch {
-                return {
-                    statusCode: 500,
-                    response: {
-                        message: 'Failed to retrieve balance',
-                        error: 'Failed to retrieve balance',
-                    },
-                };
-            }
-        };
-        this.handleGetTransactions = async (req) => {
-            const user = req.user;
-            if (!user) {
-                return {
-                    statusCode: 401,
-                    response: {
-                        message: 'Not authenticated',
-                        error: 'Not authenticated',
-                    },
-                };
-            }
-            try {
-                const energyLedger = this.application.services.get('energyLedger');
-                const memberChecksum = brightchain_lib_1.Checksum.fromHex(user.memberId);
-                const transactions = energyLedger.getByMember(memberChecksum);
-                // Map transactions to API response format
-                const transactionList = transactions.map((tx) => ({
-                    id: tx.id.toHex(),
-                    timestamp: tx.timestamp.toISOString(),
-                    source: tx.source.toHex(),
-                    destination: tx.destination.toHex(),
-                    amount: tx.amount,
-                    operationType: tx.operationType,
-                    blockId: tx.blockId?.toHex(),
-                    metadata: tx.metadata,
-                }));
-                // Sort by timestamp descending (most recent first)
-                transactionList.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
-                return {
-                    statusCode: 200,
-                    response: {
-                        message: 'Transactions retrieved',
-                        transactions: transactionList,
-                        count: transactionList.length,
-                    },
-                };
-            }
-            catch {
-                return {
-                    statusCode: 500,
-                    response: {
-                        message: 'Failed to retrieve transactions',
-                        error: 'Failed to retrieve transactions',
-                    },
-                };
-            }
-        };
     }
     initRouteDefinitions() {
         this.routeDefinitions = [
@@ -119,6 +26,99 @@ class EnergyController extends base_1.BaseController {
             getTransactions: this.handleGetTransactions.bind(this),
         };
     }
+    async handleGetBalance(req) {
+        const user = req.user;
+        if (!user) {
+            return {
+                statusCode: 401,
+                response: {
+                    message: 'Not authenticated',
+                    error: 'Not authenticated',
+                },
+            };
+        }
+        try {
+            const energyStore = this.application.services.get('energyStore');
+            const memberChecksum = brightchain_lib_1.Checksum.fromHex(user.memberId);
+            const account = energyStore.get(memberChecksum);
+            if (!account) {
+                return {
+                    statusCode: 404,
+                    response: {
+                        message: 'Energy account not found',
+                        error: 'Energy account not found',
+                    },
+                };
+            }
+            return {
+                statusCode: 200,
+                response: {
+                    message: 'Balance retrieved',
+                    balance: account.balance,
+                    earned: account.earned,
+                    spent: account.spent,
+                    reserved: account.reserved,
+                    reputation: account.reputation,
+                },
+            };
+        }
+        catch {
+            return {
+                statusCode: 500,
+                response: {
+                    message: 'Failed to retrieve balance',
+                    error: 'Failed to retrieve balance',
+                },
+            };
+        }
+    }
+    async handleGetTransactions(req) {
+        const user = req.user;
+        if (!user) {
+            return {
+                statusCode: 401,
+                response: {
+                    message: 'Not authenticated',
+                    error: 'Not authenticated',
+                },
+            };
+        }
+        try {
+            const energyLedger = this.application.services.get('energyLedger');
+            const memberChecksum = brightchain_lib_1.Checksum.fromHex(user.memberId);
+            const transactions = energyLedger.getByMember(memberChecksum);
+            // Map transactions to API response format
+            const transactionList = transactions.map((tx) => ({
+                id: tx.id.toHex(),
+                timestamp: tx.timestamp.toISOString(),
+                source: tx.source.toHex(),
+                destination: tx.destination.toHex(),
+                amount: tx.amount,
+                operationType: tx.operationType,
+                blockId: tx.blockId?.toHex(),
+                metadata: tx.metadata,
+            }));
+            // Sort by timestamp descending (most recent first)
+            transactionList.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+            return {
+                statusCode: 200,
+                response: {
+                    message: 'Transactions retrieved',
+                    transactions: transactionList,
+                    count: transactionList.length,
+                },
+            };
+        }
+        catch {
+            return {
+                statusCode: 500,
+                response: {
+                    message: 'Failed to retrieve transactions',
+                    error: 'Failed to retrieve transactions',
+                },
+            };
+        }
+    }
 }
 exports.EnergyController = EnergyController;
 //# sourceMappingURL=energy.js.map

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

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

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

@@ -0,0 +1,79 @@
+/**
+ * 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
+ */
+import { ICommunicationMessage } from '@brightchain/brightchain-lib/lib/interfaces/communication';
+import type { IExplodeMessageResponse, IGetExpirationInfoResponse, IGetExpiredResponse, IMarkReadResponse, ISetExpirationResponse } from '@brightchain/brightchain-lib/lib/interfaces/responses/explodingMessageResponses';
+import { PlatformID } from '@digitaldefiance/ecies-lib';
+import { CoreLanguageCode } from '@digitaldefiance/i18n-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 ExplodingMessageApiResponse = ISetExpirationResponse | IMarkReadResponse | IGetExpiredResponse | IExplodeMessageResponse | IGetExpirationInfoResponse | ApiErrorResponse;
+interface ExplodingMessageHandlers extends TypedHandlers {
+    setExpiration: ApiRequestHandler<ISetExpirationResponse | ApiErrorResponse>;
+    markRead: ApiRequestHandler<IMarkReadResponse | ApiErrorResponse>;
+    getExpired: ApiRequestHandler<IGetExpiredResponse | ApiErrorResponse>;
+    explodeMessage: ApiRequestHandler<IExplodeMessageResponse | ApiErrorResponse>;
+    getExpirationInfo: ApiRequestHandler<IGetExpirationInfoResponse | ApiErrorResponse>;
+}
+/**
+ * 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
+ */
+export declare class ExplodingMessagesController<TID extends PlatformID = DefaultBackendIdType> extends BaseController<TID, ExplodingMessageApiResponse, ExplodingMessageHandlers, CoreLanguageCode> {
+    private messageStore;
+    constructor(application: IBrightChainApplication<TID>);
+    /**
+     * Inject a message into the store (for integration with message passing).
+     */
+    registerMessage(message: ICommunicationMessage): void;
+    protected initRouteDefinitions(): void;
+    /**
+     * PUT /:id/set-expiration — Set expiration on a message.
+     *
+     * @requirements 8.1, 8.2, 8.5
+     */
+    private handleSetExpiration;
+    /**
+     * POST /:id/mark-read — Mark a message as read.
+     *
+     * @requirements 8.2, 8.3, 8.8
+     */
+    private handleMarkRead;
+    /**
+     * GET /expired — List all expired messages.
+     *
+     * @requirements 8.4, 8.8
+     */
+    private handleGetExpired;
+    /**
+     * POST /:id/explode — Force-explode a message.
+     *
+     * @requirements 8.4, 8.7
+     */
+    private handleExplodeMessage;
+    /**
+     * GET /:id/expiration-info — Get expiration status.
+     *
+     * @requirements 8.8
+     */
+    private handleGetExpirationInfo;
+    private mapExplodingError;
+}
+export {};
+//# sourceMappingURL=explodingMessages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explodingMessages.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/controllers/api/explodingMessages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,iFAAiF,CAAC;AAMzF,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EAEd,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAM1D,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAIzC,KAAK,2BAA2B,GAC5B,sBAAsB,GACtB,iBAAiB,GACjB,mBAAmB,GACnB,uBAAuB,GACvB,0BAA0B,GAC1B,gBAAgB,CAAC;AAIrB,UAAU,wBAAyB,SAAQ,aAAa;IACtD,aAAa,EAAE,iBAAiB,CAAC,sBAAsB,GAAG,gBAAgB,CAAC,CAAC;IAC5E,QAAQ,EAAE,iBAAiB,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,CAAC;IAClE,UAAU,EAAE,iBAAiB,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAAC;IACtE,cAAc,EAAE,iBAAiB,CAAC,uBAAuB,GAAG,gBAAgB,CAAC,CAAC;IAC9E,iBAAiB,EAAE,iBAAiB,CAClC,0BAA0B,GAAG,gBAAgB,CAC9C,CAAC;CACH;AAkDD;;;;;;;;GAQG;AACH,qBAAa,2BAA2B,CACtC,GAAG,SAAS,UAAU,GAAG,oBAAoB,CAC7C,SAAQ,cAAc,CACtB,GAAG,EACH,2BAA2B,EAC3B,wBAAwB,EACxB,gBAAgB,CACjB;IACC,OAAO,CAAC,YAAY,CAA+B;gBAEvC,WAAW,EAAE,uBAAuB,CAAC,GAAG,CAAC;IAIrD;;OAEG;IACI,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAM5D,SAAS,CAAC,oBAAoB,IAAI,IAAI;IAwHtC;;;;OAIG;YACW,mBAAmB;IAyCjC;;;;OAIG;YACW,cAAc;IA6C5B;;;;OAIG;YACW,gBAAgB;IA2B9B;;;;OAIG;YACW,oBAAoB;IAmClC;;;;OAIG;YACW,uBAAuB;IAwCrC,OAAO,CAAC,iBAAiB;CAwB1B"}

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