@brightchain/brightchain-api-lib 0.12.0 → 0.13.0

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

@@ -0,0 +1,269 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagesController = void 0;
+const brightchain_lib_1 = require("@brightchain/brightchain-lib");
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+const errorResponse_1 = require("../../utils/errorResponse");
+const base_1 = require("../base");
+/**
+ * Controller for message passing operations.
+ *
+ * Provides REST API endpoints for sending, retrieving, querying, and deleting
+ * messages in the BrightChain distributed messaging system.
+ *
+ * ## Endpoints
+ *
+ * ### POST /api/messages
+ * Send a new message with optional recipients.
+ *
+ * **Request Body:**
+ * - `content` (string, required): Base64-encoded message content
+ * - `senderId` (string, required): Sender member ID
+ * - `recipients` (string[], optional): Recipient IDs (broadcast if empty)
+ * - `messageType` (string, required): Message type identifier
+ * - `priority` (number, optional): Message priority level
+ * - `encryptionScheme` (number, optional): Encryption scheme identifier
+ *
+ * **Response:** Message ID and magnet URL
+ *
+ * ### GET /api/messages/:id
+ * Retrieve a message by its ID.
+ *
+ * **Parameters:**
+ * - `id` (string, required): Message ID
+ *
+ * **Response:** Base64-encoded message content
+ *
+ * ### GET /api/messages
+ * Query messages with optional filters.
+ *
+ * **Query Parameters:**
+ * - `recipientId` (string, optional): Filter by recipient ID
+ * - `senderId` (string, optional): Filter by sender ID
+ * - `messageType` (string, optional): Filter by message type
+ * - `page` (number, optional): Page number (default: 1)
+ * - `pageSize` (number, optional): Page size (default: 50)
+ *
+ * **Response:** Array of message metadata
+ *
+ * ### DELETE /api/messages/:id
+ * Delete a message by its ID.
+ *
+ * **Parameters:**
+ * - `id` (string, required): Message ID
+ *
+ * **Response:** 204 No Content on success
+ *
+ * @requirements 1.1, 1.2, 1.3, 1.4, 1.5, 1.6
+ */
+class MessagesController extends base_1.BaseController {
+    constructor(application) {
+        super(application);
+        this.messageService = null;
+    }
+    /**
+     * Set the MessagePassingService instance.
+     * This allows for dependency injection and testing.
+     */
+    setMessageService(service) {
+        this.messageService = service;
+    }
+    /**
+     * Get the MessagePassingService instance.
+     * Throws if the service has not been set.
+     */
+    getMessageService() {
+        if (!this.messageService) {
+            throw new Error('MessagePassingService not initialized');
+        }
+        return this.messageService;
+    }
+    initRouteDefinitions() {
+        this.routeDefinitions = [
+            (0, node_express_suite_1.routeConfig)('post', '/', {
+                useAuthentication: false,
+                useCryptoAuthentication: false,
+                handlerKey: 'sendMessage',
+            }),
+            (0, node_express_suite_1.routeConfig)('get', '/:id', {
+                handlerKey: 'getMessage',
+                useAuthentication: false,
+                useCryptoAuthentication: false,
+            }),
+            (0, node_express_suite_1.routeConfig)('get', '/', {
+                handlerKey: 'queryMessages',
+                useAuthentication: false,
+                useCryptoAuthentication: false,
+            }),
+            (0, node_express_suite_1.routeConfig)('delete', '/:id', {
+                handlerKey: 'deleteMessage',
+                useAuthentication: false,
+                useCryptoAuthentication: false,
+            }),
+        ];
+        this.handlers = {
+            sendMessage: this.handleSendMessage.bind(this),
+            getMessage: this.handleGetMessage.bind(this),
+            queryMessages: this.handleQueryMessages.bind(this),
+            deleteMessage: this.handleDeleteMessage.bind(this),
+        };
+    }
+    /**
+     * POST /api/messages
+     * Send a new message.
+     *
+     * @param req - Request containing message content and metadata
+     * @returns Message ID and magnet URL on success, or error response
+     * @requirements 1.1
+     */
+    async handleSendMessage(req) {
+        try {
+            const { content, senderId, recipients, messageType, priority, encryptionScheme, } = req.body;
+            // Validate required fields
+            if (!content) {
+                return (0, errorResponse_1.validationError)('Missing required field: content');
+            }
+            if (!senderId) {
+                return (0, errorResponse_1.validationError)('Missing required field: senderId');
+            }
+            if (!messageType) {
+                return (0, errorResponse_1.validationError)('Missing required field: messageType');
+            }
+            // Validate field types
+            if (typeof content !== 'string') {
+                return (0, errorResponse_1.validationError)('Invalid field type: content must be a string');
+            }
+            if (typeof senderId !== 'string') {
+                return (0, errorResponse_1.validationError)('Invalid field type: senderId must be a string');
+            }
+            if (typeof messageType !== 'string') {
+                return (0, errorResponse_1.validationError)('Invalid field type: messageType must be a string');
+            }
+            const contentBuffer = Buffer.from(content, 'base64');
+            const service = this.getMessageService();
+            // Map numeric encryption scheme to enum value
+            const encryptionSchemeValue = encryptionScheme === 1
+                ? brightchain_lib_1.MessageEncryptionScheme.SHARED_KEY
+                : encryptionScheme === 2
+                    ? brightchain_lib_1.MessageEncryptionScheme.RECIPIENT_KEYS
+                    : brightchain_lib_1.MessageEncryptionScheme.NONE;
+            const result = await service.sendMessage(contentBuffer, senderId, {
+                recipients: recipients || [],
+                messageType,
+                priority: priority ?? brightchain_lib_1.MessagePriority.NORMAL,
+                senderId,
+                encryptionScheme: encryptionSchemeValue,
+            });
+            return {
+                statusCode: 201,
+                response: {
+                    messageId: result.messageId,
+                    magnetUrl: result.magnetUrl,
+                },
+            };
+        }
+        catch (_error) {
+            return (0, errorResponse_1.handleError)(_error);
+        }
+    }
+    /**
+     * GET /api/messages/:id
+     * Retrieve a message by its ID.
+     *
+     * @param req - Request containing the message ID parameter
+     * @returns Base64-encoded message content on success, or 404 if not found
+     * @requirements 1.2, 1.5
+     */
+    async handleGetMessage(req) {
+        try {
+            const { id } = req.params;
+            if (!id) {
+                return (0, errorResponse_1.validationError)('Missing required parameter: id');
+            }
+            const service = this.getMessageService();
+            const content = await service.getMessage(id);
+            if (!content) {
+                return (0, errorResponse_1.notFoundError)('Message', id);
+            }
+            return {
+                statusCode: 200,
+                response: {
+                    content: content.toString('base64'),
+                },
+            };
+        }
+        catch (_error) {
+            return (0, errorResponse_1.handleError)(_error);
+        }
+    }
+    /**
+     * GET /api/messages
+     * Query messages with optional filters.
+     *
+     * @param req - Request containing query parameters
+     * @returns Array of message metadata matching the query
+     * @requirements 1.3
+     */
+    async handleQueryMessages(req) {
+        try {
+            const { recipientId, senderId, messageType, page, pageSize } = req.query;
+            const query = {};
+            if (recipientId) {
+                query['recipientId'] = recipientId;
+            }
+            if (senderId) {
+                query['senderId'] = senderId;
+            }
+            if (messageType) {
+                query['messageType'] = messageType;
+            }
+            const pageNum = parseInt(page || '1', 10);
+            const pageSizeNum = parseInt(pageSize || '50', 10);
+            query['page'] = pageNum;
+            query['pageSize'] = pageSizeNum;
+            const service = this.getMessageService();
+            const results = await service.queryMessages(query);
+            return {
+                statusCode: 200,
+                response: {
+                    messages: results,
+                    total: results.length,
+                    page: pageNum,
+                    pageSize: pageSizeNum,
+                },
+            };
+        }
+        catch (_error) {
+            return (0, errorResponse_1.handleError)(_error);
+        }
+    }
+    /**
+     * DELETE /api/messages/:id
+     * Delete a message by its ID.
+     *
+     * @param req - Request containing the message ID parameter
+     * @returns 204 No Content on success, or 404 if not found
+     * @requirements 1.4
+     */
+    async handleDeleteMessage(req) {
+        try {
+            const { id } = req.params;
+            if (!id) {
+                return (0, errorResponse_1.validationError)('Missing required parameter: id');
+            }
+            const service = this.getMessageService();
+            await service.deleteMessage(id);
+            return {
+                statusCode: 204,
+                response: {
+                    success: true,
+                },
+            };
+        }
+        catch (_error) {
+            return (0, errorResponse_1.handleError)(_error);
+        }
+    }
+}
+exports.MessagesController = MessagesController;
+//# sourceMappingURL=messages.js.map

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

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

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

@@ -0,0 +1,152 @@
+import { IAvailabilityService, IDiscoverBlockResponse, IDiscoveryProtocol, IGetNodeResponse, IListNodesResponse, IRegisterNodeResponse } from '@brightchain/brightchain-lib';
+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 NodesApiResponse = IListNodesResponse | IGetNodeResponse | IDiscoverBlockResponse | IRegisterNodeResponse | ApiErrorResponse;
+interface NodesHandlers extends TypedHandlers {
+    listNodes: ApiRequestHandler<IListNodesResponse | ApiErrorResponse>;
+    getNode: ApiRequestHandler<IGetNodeResponse | ApiErrorResponse>;
+    discoverBlock: ApiRequestHandler<IDiscoverBlockResponse | ApiErrorResponse>;
+    registerNode: ApiRequestHandler<IRegisterNodeResponse | ApiErrorResponse>;
+}
+/**
+ * Controller for node discovery and network management operations.
+ *
+ * Provides REST API endpoints for listing connected nodes, getting node details,
+ * discovering blocks across the network, and registering nodes for WebSocket authentication.
+ *
+ * ## Endpoints
+ *
+ * ### GET /api/nodes
+ * List all connected peer nodes with their status and capabilities.
+ *
+ * **Response:**
+ * - `nodes` (array): Array of node information objects
+ * - `total` (number): Total number of connected nodes
+ *
+ * ### GET /api/nodes/:nodeId
+ * Get detailed information about a specific node.
+ *
+ * **Parameters:**
+ * - `nodeId` (string, required): Node ID to retrieve
+ *
+ * **Response:**
+ * - `node` (object): Node information including latency and last seen timestamp
+ *
+ * ### POST /api/nodes/discover
+ * Discover nodes that have a specific block.
+ *
+ * **Request Body:**
+ * - `blockId` (string, required): Block ID to discover
+ *
+ * **Response:**
+ * - `blockId` (string): The block ID that was searched for
+ * - `found` (boolean): Whether the block was found
+ * - `locations` (array): Nodes where the block was found
+ * - `queriedPeers` (number): Number of peers queried
+ * - `duration` (number): Discovery duration in milliseconds
+ *
+ * ### POST /api/nodes/register
+ * Register a node's public key for WebSocket authentication.
+ *
+ * **Request Body:**
+ * - `nodeId` (string, required): Node ID to register
+ * - `publicKey` (string, required): Public key for authentication
+ *
+ * **Response:**
+ * - `success` (boolean): Whether registration succeeded
+ * - `nodeId` (string): The registered node ID
+ * - `message` (string): Status message
+ *
+ * @requirements 3.1, 3.2, 3.3, 3.4, 3.5
+ */
+export declare class NodesController<TID extends PlatformID = DefaultBackendIdType> extends BaseController<TID, NodesApiResponse, NodesHandlers, CoreLanguageCode> {
+    private discoveryProtocol;
+    private availabilityService;
+    /**
+     * Store for registered node public keys (nodeId -> publicKey)
+     */
+    private registeredNodes;
+    constructor(application: IBrightChainApplication<TID>);
+    /**
+     * Set the DiscoveryProtocol instance.
+     * This allows for dependency injection and testing.
+     */
+    setDiscoveryProtocol(protocol: IDiscoveryProtocol): void;
+    /**
+     * Set the AvailabilityService instance.
+     * This allows for dependency injection and testing.
+     */
+    setAvailabilityService(service: IAvailabilityService): void;
+    /**
+     * Get the DiscoveryProtocol instance.
+     * Throws if the protocol has not been set.
+     */
+    private getDiscoveryProtocol;
+    /**
+     * Get the AvailabilityService instance.
+     * Throws if the service has not been set.
+     */
+    private getAvailabilityService;
+    /**
+     * Check if a node is registered.
+     * @param nodeId - The node ID to check
+     * @returns True if the node is registered
+     */
+    isNodeRegistered(nodeId: string): boolean;
+    /**
+     * Get the public key for a registered node.
+     * @param nodeId - The node ID to get the public key for
+     * @returns The public key or undefined if not registered
+     */
+    getNodePublicKey(nodeId: string): string | undefined;
+    /**
+     * Clear all registered nodes (for testing).
+     */
+    clearRegisteredNodes(): void;
+    protected initRouteDefinitions(): void;
+    /**
+     * Convert ILocationRecord to node info format
+     */
+    private locationToNodeInfo;
+    /**
+     * GET /api/nodes
+     * List all connected peer nodes with their status and capabilities.
+     *
+     * @returns List of connected nodes
+     * @requirements 3.1
+     */
+    private handleListNodes;
+    /**
+     * GET /api/nodes/:nodeId
+     * Get detailed information about a specific node.
+     *
+     * @param req - Request containing the node ID parameter
+     * @returns Node information on success, or 404 if not found
+     * @requirements 3.2, 3.5
+     */
+    private handleGetNode;
+    /**
+     * POST /api/nodes/discover
+     * Discover nodes that have a specific block.
+     *
+     * @param req - Request containing the block ID to discover
+     * @returns Discovery result with locations
+     * @requirements 3.3
+     */
+    private handleDiscoverBlock;
+    /**
+     * POST /api/nodes/register
+     * Register a node's public key for WebSocket authentication.
+     *
+     * @param req - Request containing node ID and public key
+     * @returns Registration result
+     * @requirements 3.4, 3.5
+     */
+    private handleRegisterNode;
+}
+export {};
+//# sourceMappingURL=nodes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/controllers/api/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAGlB,qBAAqB,EAEtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EAEd,MAAM,qCAAqC,CAAC;AAM7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAM1D,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,KAAK,gBAAgB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,sBAAsB,GACtB,qBAAqB,GACrB,gBAAgB,CAAC;AAErB,UAAU,aAAc,SAAQ,aAAa;IAC3C,SAAS,EAAE,iBAAiB,CAAC,kBAAkB,GAAG,gBAAgB,CAAC,CAAC;IACpE,OAAO,EAAE,iBAAiB,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,CAAC;IAChE,aAAa,EAAE,iBAAiB,CAAC,sBAAsB,GAAG,gBAAgB,CAAC,CAAC;IAC5E,YAAY,EAAE,iBAAiB,CAAC,qBAAqB,GAAG,gBAAgB,CAAC,CAAC;CAC3E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,qBAAa,eAAe,CAC1B,GAAG,SAAS,UAAU,GAAG,oBAAoB,CAC7C,SAAQ,cAAc,CACtB,GAAG,EACH,gBAAgB,EAChB,aAAa,EACb,gBAAgB,CACjB;IACC,OAAO,CAAC,iBAAiB,CAAmC;IAC5D,OAAO,CAAC,mBAAmB,CAAqC;IAEhE;;OAEG;IACH,OAAO,CAAC,eAAe,CAAkC;gBAE7C,WAAW,EAAE,uBAAuB,CAAC,GAAG,CAAC;IAIrD;;;OAGG;IACI,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAI/D;;;OAGG;IACI,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAIlE;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;;;OAIG;IACI,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIhD;;;;OAIG;IACI,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3D;;OAEG;IACI,oBAAoB,IAAI,IAAI;IAInC,SAAS,CAAC,oBAAoB,IAAI,IAAI;IAgCtC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;;;;;OAMG;YACW,eAAe;IA+D7B;;;;;;;OAOG;YACW,aAAa;IAsE3B;;;;;;;OAOG;YACW,mBAAmB;IA0CjC;;;;;;;OAOG;YACW,kBAAkB;CAyCjC"}