@brightchain/brightchain-api-lib 0.12.0 → 0.13.0

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

@@ -64,13 +64,41 @@ class EnergyController extends base_1.BaseController {
                     },
                 };
             }
-            return {
-                statusCode: 200,
-                response: {
-                    message: 'Transactions retrieved',
-                    transactions: [],
-                },
-            };
+            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() {

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":";;;AAAA,kEAA4E;AAG5E,4EAO6C;AAG7C,kCAAyC;AAOzC,MAAa,gBAEX,SAAQ,qBAKT;IACC,YAAY,WAAyC;QACnD,KAAK,CAAC,WAAW,CAAC,CAAC;QAuBb,qBAAgB,GAEpB,KAAK,EACP,GAAG,EACmE,EAAE;YACxE,MAAM,IAAI,GAAI,GAAuC,CAAC,IAAI,CAAC;YAE3D,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO;oBACL,UAAU,EAAE,GAAG;oBACf,QAAQ,EAAE;wBACR,OAAO,EAAE,mBAAmB;wBAC5B,KAAK,EAAE,mBAAmB;qBAC3B;iBACF,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,WAAW,GACf,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAqB,aAAa,CAAC,CAAC;gBACnE,MAAM,cAAc,GAAG,0BAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO;wBACL,UAAU,EAAE,GAAG;wBACf,QAAQ,EAAE;4BACR,OAAO,EAAE,0BAA0B;4BACnC,KAAK,EAAE,0BAA0B;yBAClC;qBACF,CAAC;gBACJ,CAAC;gBAED,OAAO;oBACL,UAAU,EAAE,GAAG;oBACf,QAAQ,EAAE;wBACR,OAAO,EAAE,mBAAmB;wBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;wBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;wBACtB,KAAK,EAAE,OAAO,CAAC,KAAK;wBACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;wBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;qBACR;iBACzB,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;oBACL,UAAU,EAAE,GAAG;oBACf,QAAQ,EAAE;wBACR,OAAO,EAAE,4BAA4B;wBACrC,KAAK,EAAE,4BAA4B;qBACpC;iBACF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC;QAEM,0BAAqB,GAEzB,KAAK,EACP,GAAG,EACmE,EAAE;YACxE,MAAM,IAAI,GAAI,GAAuC,CAAC,IAAI,CAAC;YAE3D,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO;oBACL,UAAU,EAAE,GAAG;oBACf,QAAQ,EAAE;wBACR,OAAO,EAAE,mBAAmB;wBAC5B,KAAK,EAAE,mBAAmB;qBAC3B;iBACF,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,UAAU,EAAE,GAAG;gBACf,QAAQ,EAAE;oBACR,OAAO,EAAE,wBAAwB;oBACjC,YAAY,EAAE,EAAE;iBACM;aACzB,CAAC;QACJ,CAAC,CAAC;IArGF,CAAC;IAES,oBAAoB;QAC5B,IAAI,CAAC,gBAAgB,GAAG;YACtB,IAAA,gCAAW,EAAC,KAAK,EAAE,UAAU,EAAE;gBAC7B,UAAU,EAAE,YAAY;gBACxB,iBAAiB,EAAE,IAAI;gBACvB,uBAAuB,EAAE,KAAK;aAC/B,CAAC;YACF,IAAA,gCAAW,EAAC,KAAK,EAAE,eAAe,EAAE;gBAClC,UAAU,EAAE,iBAAiB;gBAC7B,iBAAiB,EAAE,IAAI;gBACvB,uBAAuB,EAAE,KAAK;aAC/B,CAAC;SACH,CAAC;QAEF,IAAI,CAAC,QAAQ,GAAG;YACd,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5C,eAAe,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;SACvD,CAAC;IACJ,CAAC;CAkFF;AAhHD,4CAgHC"}
+{"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/health.d.ts

@@ -0,0 +1,95 @@
+import { IDetailedHealthResponse, IHealthResponse } 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 HealthApiResponse = IHealthResponse | IDetailedHealthResponse | ApiErrorResponse;
+interface IHealthHandlers extends TypedHandlers {
+    getHealth: ApiRequestHandler<IHealthResponse | ApiErrorResponse>;
+    getDetailedHealth: ApiRequestHandler<IDetailedHealthResponse | ApiErrorResponse>;
+}
+/**
+ * Controller for health check and status endpoints.
+ *
+ * Provides REST API endpoints for monitoring the API server health
+ * and checking the status of dependencies.
+ *
+ * ## Endpoints
+ *
+ * ### GET /api/health
+ * Basic health check returning server status, uptime, and version.
+ * Response time should be under 100ms.
+ *
+ * **Response:**
+ * - `status` (string): 'healthy' | 'degraded' | 'unhealthy' | 'starting'
+ * - `uptime` (number): Server uptime in seconds
+ * - `timestamp` (string): ISO timestamp of the response
+ * - `version` (string): API version
+ *
+ * ### GET /api/health/detailed
+ * Detailed health check with dependency status.
+ * Returns 503 when critical dependencies are unhealthy.
+ *
+ * **Response:**
+ * - All fields from basic health check
+ * - `dependencies` (object): Status of each dependency
+ *   - `blockStore`: Block storage service status
+ *   - `messageService`: Message passing service status
+ *   - `webSocketServer`: WebSocket server status
+ *
+ * @requirements 6.1, 6.2, 6.3, 6.4, 6.5
+ */
+export declare class HealthController<TID extends PlatformID = DefaultBackendIdType> extends BaseController<TID, HealthApiResponse, IHealthHandlers, CoreLanguageCode> {
+    private static readonly VERSION;
+    private static startTime;
+    private static isStarting;
+    constructor(application: IBrightChainApplication<TID>);
+    /**
+     * Mark the server as fully initialized (no longer starting)
+     */
+    static markReady(): void;
+    /**
+     * Mark the server as starting (for testing or restart scenarios)
+     */
+    static markStarting(): void;
+    /**
+     * Check if the server is in starting state
+     */
+    static isInStartingState(): boolean;
+    /**
+     * Reset the start time (for testing)
+     */
+    static resetStartTime(): void;
+    protected initRouteDefinitions(): void;
+    /**
+     * Calculate server uptime in seconds
+     */
+    private getUptime;
+    /**
+     * GET /api/health
+     * Basic health check returning server status, uptime, timestamp, and version.
+     *
+     * Returns 503 with "starting" status during initialization.
+     * Response time should be under 100ms.
+     *
+     * @requirements 6.1, 6.4, 6.5
+     */
+    private handleGetHealth;
+    /**
+     * Check the health of a dependency
+     */
+    private checkDependencyHealth;
+    /**
+     * GET /api/health/detailed
+     * Detailed health check with dependency status.
+     *
+     * Returns 503 when critical dependencies are unhealthy.
+     *
+     * @requirements 6.2, 6.3, 6.5
+     */
+    private handleGetDetailedHealth;
+}
+export {};
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/controllers/api/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,uBAAuB,EACvB,eAAe,EAChB,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,EAGjB,aAAa,EAEd,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,KAAK,iBAAiB,GAClB,eAAe,GACf,uBAAuB,GACvB,gBAAgB,CAAC;AAErB,UAAU,eAAgB,SAAQ,aAAa;IAC7C,SAAS,EAAE,iBAAiB,CAAC,eAAe,GAAG,gBAAgB,CAAC,CAAC;IACjE,iBAAiB,EAAE,iBAAiB,CAClC,uBAAuB,GAAG,gBAAgB,CAC3C,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,gBAAgB,CAC3B,GAAG,SAAS,UAAU,GAAG,oBAAoB,CAC7C,SAAQ,cAAc,CACtB,GAAG,EACH,iBAAiB,EACjB,eAAe,EACf,gBAAgB,CACjB;IACC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAY;IAC3C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAsB;IAC9C,OAAO,CAAC,MAAM,CAAC,UAAU,CAAiB;gBAE9B,WAAW,EAAE,uBAAuB,CAAC,GAAG,CAAC;IASrD;;OAEG;WACW,SAAS,IAAI,IAAI;IAI/B;;OAEG;WACW,YAAY,IAAI,IAAI;IAIlC;;OAEG;WACW,iBAAiB,IAAI,OAAO;IAI1C;;OAEG;WACW,cAAc,IAAI,IAAI;IAIpC,SAAS,CAAC,oBAAoB,IAAI,IAAI;IAkEtC;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;;;;;;;OAQG;YACW,eAAe;IA6B7B;;OAEG;YACW,qBAAqB;IAwBnC;;;;;;;OAOG;YACW,uBAAuB;CA0HtC"}

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

@@ -0,0 +1,319 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthController = void 0;
+const brightchain_lib_1 = require("@brightchain/brightchain-lib");
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+const base_1 = require("../base");
+/**
+ * Controller for health check and status endpoints.
+ *
+ * Provides REST API endpoints for monitoring the API server health
+ * and checking the status of dependencies.
+ *
+ * ## Endpoints
+ *
+ * ### GET /api/health
+ * Basic health check returning server status, uptime, and version.
+ * Response time should be under 100ms.
+ *
+ * **Response:**
+ * - `status` (string): 'healthy' | 'degraded' | 'unhealthy' | 'starting'
+ * - `uptime` (number): Server uptime in seconds
+ * - `timestamp` (string): ISO timestamp of the response
+ * - `version` (string): API version
+ *
+ * ### GET /api/health/detailed
+ * Detailed health check with dependency status.
+ * Returns 503 when critical dependencies are unhealthy.
+ *
+ * **Response:**
+ * - All fields from basic health check
+ * - `dependencies` (object): Status of each dependency
+ *   - `blockStore`: Block storage service status
+ *   - `messageService`: Message passing service status
+ *   - `webSocketServer`: WebSocket server status
+ *
+ * @requirements 6.1, 6.2, 6.3, 6.4, 6.5
+ */
+class HealthController extends base_1.BaseController {
+    constructor(application) {
+        super(application);
+        // Mark as no longer starting after a brief initialization period
+        // In production, this would be set when all services are ready
+        setTimeout(() => {
+            HealthController.isStarting = false;
+        }, 100);
+    }
+    /**
+     * Mark the server as fully initialized (no longer starting)
+     */
+    static markReady() {
+        HealthController.isStarting = false;
+    }
+    /**
+     * Mark the server as starting (for testing or restart scenarios)
+     */
+    static markStarting() {
+        HealthController.isStarting = true;
+    }
+    /**
+     * Check if the server is in starting state
+     */
+    static isInStartingState() {
+        return HealthController.isStarting;
+    }
+    /**
+     * Reset the start time (for testing)
+     */
+    static resetStartTime() {
+        HealthController.startTime = Date.now();
+    }
+    initRouteDefinitions() {
+        this.routeDefinitions = [
+            (0, node_express_suite_1.routeConfig)('get', '/', {
+                handlerKey: 'getHealth',
+                useAuthentication: false,
+                useCryptoAuthentication: false,
+                openapi: {
+                    summary: 'Basic health check',
+                    description: 'Returns server status, uptime, and version. Response time under 100ms.',
+                    tags: ['Health'],
+                    responses: {
+                        200: {
+                            schema: 'HealthResponse',
+                            description: 'Server is healthy',
+                            example: {
+                                message: 'OK',
+                                status: 'healthy',
+                                uptime: 3600,
+                                timestamp: '2025-01-16T10:00:00.000Z',
+                                version: '0.13.0',
+                            },
+                        },
+                        503: {
+                            schema: 'HealthResponse',
+                            description: 'Server is starting or unhealthy',
+                        },
+                    },
+                },
+            }),
+            (0, node_express_suite_1.routeConfig)('get', '/detailed', {
+                handlerKey: 'getDetailedHealth',
+                useAuthentication: false,
+                useCryptoAuthentication: false,
+                openapi: {
+                    summary: 'Detailed health check with dependencies',
+                    description: 'Returns status of all dependencies. Returns 503 when critical dependencies are unhealthy.',
+                    tags: ['Health'],
+                    responses: {
+                        200: {
+                            schema: 'DetailedHealthResponse',
+                            description: 'Health check completed',
+                        },
+                        503: {
+                            schema: 'DetailedHealthResponse',
+                            description: 'Critical dependency unhealthy',
+                        },
+                    },
+                },
+            }),
+        ];
+        // Register with OpenAPI registry
+        node_express_suite_1.ControllerRegistry.register('/health', 'HealthController', this.routeDefinitions);
+        this.handlers = {
+            getHealth: this.handleGetHealth.bind(this),
+            getDetailedHealth: this.handleGetDetailedHealth.bind(this),
+        };
+    }
+    /**
+     * Calculate server uptime in seconds
+     */
+    getUptime() {
+        return Math.floor((Date.now() - HealthController.startTime) / 1000);
+    }
+    /**
+     * GET /api/health
+     * Basic health check returning server status, uptime, timestamp, and version.
+     *
+     * Returns 503 with "starting" status during initialization.
+     * Response time should be under 100ms.
+     *
+     * @requirements 6.1, 6.4, 6.5
+     */
+    async handleGetHealth() {
+        // Check if server is still starting
+        if (HealthController.isStarting) {
+            return {
+                statusCode: 503,
+                response: {
+                    message: 'Server is starting',
+                    status: brightchain_lib_1.HealthStatus.STARTING,
+                    uptime: this.getUptime(),
+                    timestamp: new Date().toISOString(),
+                    version: HealthController.VERSION,
+                },
+            };
+        }
+        return {
+            statusCode: 200,
+            response: {
+                message: 'OK',
+                status: brightchain_lib_1.HealthStatus.HEALTHY,
+                uptime: this.getUptime(),
+                timestamp: new Date().toISOString(),
+                version: HealthController.VERSION,
+            },
+        };
+    }
+    /**
+     * Check the health of a dependency
+     */
+    async checkDependencyHealth(name, checkFn) {
+        const startTime = Date.now();
+        try {
+            const isHealthy = await checkFn();
+            const latencyMs = Date.now() - startTime;
+            return {
+                name,
+                status: isHealthy ? brightchain_lib_1.HealthStatus.HEALTHY : brightchain_lib_1.HealthStatus.UNHEALTHY,
+                latencyMs,
+            };
+        }
+        catch (error) {
+            const latencyMs = Date.now() - startTime;
+            return {
+                name,
+                status: brightchain_lib_1.HealthStatus.UNHEALTHY,
+                latencyMs,
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    /**
+     * GET /api/health/detailed
+     * Detailed health check with dependency status.
+     *
+     * Returns 503 when critical dependencies are unhealthy.
+     *
+     * @requirements 6.2, 6.3, 6.5
+     */
+    async handleGetDetailedHealth() {
+        // Check if server is still starting
+        if (HealthController.isStarting) {
+            return {
+                statusCode: 503,
+                response: {
+                    message: 'Server is starting',
+                    status: brightchain_lib_1.HealthStatus.STARTING,
+                    uptime: this.getUptime(),
+                    timestamp: new Date().toISOString(),
+                    version: HealthController.VERSION,
+                    dependencies: {
+                        blockStore: {
+                            name: 'blockStore',
+                            status: brightchain_lib_1.HealthStatus.STARTING,
+                            message: 'Server is starting',
+                        },
+                        messageService: {
+                            name: 'messageService',
+                            status: brightchain_lib_1.HealthStatus.STARTING,
+                            message: 'Server is starting',
+                        },
+                        webSocketServer: {
+                            name: 'webSocketServer',
+                            status: brightchain_lib_1.HealthStatus.STARTING,
+                            message: 'Server is starting',
+                        },
+                    },
+                },
+            };
+        }
+        // Check each dependency
+        const [blockStoreHealth, messageServiceHealth, webSocketServerHealth] = await Promise.all([
+            this.checkDependencyHealth('blockStore', async () => {
+                // Check if block store service is available
+                try {
+                    const blockStore = this.application.services.get('blockStore');
+                    return blockStore !== undefined;
+                }
+                catch {
+                    return false;
+                }
+            }),
+            this.checkDependencyHealth('messageService', async () => {
+                // Check if message service is available
+                try {
+                    const messageService = this.application.services.get('messageService');
+                    return messageService !== undefined;
+                }
+                catch {
+                    // Message service may not be registered yet, treat as degraded
+                    return false;
+                }
+            }),
+            this.checkDependencyHealth('webSocketServer', async () => {
+                // Check if WebSocket server is available
+                try {
+                    const wsServer = this.application.services.get('webSocketServer');
+                    return wsServer !== undefined;
+                }
+                catch {
+                    // WebSocket server may not be registered yet, treat as degraded
+                    return false;
+                }
+            }),
+        ]);
+        // Determine overall status based on dependencies
+        const allHealthy = blockStoreHealth.status === brightchain_lib_1.HealthStatus.HEALTHY &&
+            messageServiceHealth.status === brightchain_lib_1.HealthStatus.HEALTHY &&
+            webSocketServerHealth.status === brightchain_lib_1.HealthStatus.HEALTHY;
+        const anyUnhealthy = blockStoreHealth.status === brightchain_lib_1.HealthStatus.UNHEALTHY ||
+            messageServiceHealth.status === brightchain_lib_1.HealthStatus.UNHEALTHY ||
+            webSocketServerHealth.status === brightchain_lib_1.HealthStatus.UNHEALTHY;
+        // Block store is critical - if it's unhealthy, the whole system is unhealthy
+        const blockStoreUnhealthy = blockStoreHealth.status === brightchain_lib_1.HealthStatus.UNHEALTHY;
+        let overallStatus;
+        let statusCode;
+        let statusMessage;
+        if (blockStoreUnhealthy) {
+            overallStatus = brightchain_lib_1.HealthStatus.UNHEALTHY;
+            statusCode = 503;
+            statusMessage = 'Critical dependency unhealthy';
+        }
+        else if (anyUnhealthy) {
+            overallStatus = brightchain_lib_1.HealthStatus.DEGRADED;
+            statusCode = 200;
+            statusMessage = 'Some dependencies unhealthy';
+        }
+        else if (allHealthy) {
+            overallStatus = brightchain_lib_1.HealthStatus.HEALTHY;
+            statusCode = 200;
+            statusMessage = 'OK';
+        }
+        else {
+            overallStatus = brightchain_lib_1.HealthStatus.DEGRADED;
+            statusCode = 200;
+            statusMessage = 'Some dependencies unavailable';
+        }
+        return {
+            statusCode,
+            response: {
+                message: statusMessage,
+                status: overallStatus,
+                uptime: this.getUptime(),
+                timestamp: new Date().toISOString(),
+                version: HealthController.VERSION,
+                dependencies: {
+                    blockStore: blockStoreHealth,
+                    messageService: messageServiceHealth,
+                    webSocketServer: webSocketServerHealth,
+                },
+            },
+        };
+    }
+}
+exports.HealthController = HealthController;
+HealthController.VERSION = '0.13.0';
+HealthController.startTime = Date.now();
+HealthController.isStarting = true;
+//# sourceMappingURL=health.js.map

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

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

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

@@ -1,9 +1,15 @@
 export * from './blocks';
 export * from './cbl';
+export * from './docs';
 export * from './energy';
+export * from './health';
 export * from './i18n';
 export * from './members';
+export * from './messages';
+export * from './nodes';
 export * from './quorum';
+export * from './scbl';
 export * from './sessions';
+export * from './sync';
 export * from './user';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/controllers/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/controllers/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}

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

@@ -3,10 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./blocks"), exports);
 tslib_1.__exportStar(require("./cbl"), exports);
+tslib_1.__exportStar(require("./docs"), exports);
 tslib_1.__exportStar(require("./energy"), exports);
+tslib_1.__exportStar(require("./health"), exports);
 tslib_1.__exportStar(require("./i18n"), exports);
 tslib_1.__exportStar(require("./members"), exports);
+tslib_1.__exportStar(require("./messages"), exports);
+tslib_1.__exportStar(require("./nodes"), exports);
 tslib_1.__exportStar(require("./quorum"), exports);
+tslib_1.__exportStar(require("./scbl"), exports);
 tslib_1.__exportStar(require("./sessions"), exports);
+tslib_1.__exportStar(require("./sync"), exports);
 tslib_1.__exportStar(require("./user"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/controllers/api/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB;AACzB,gDAAsB;AACtB,mDAAyB;AACzB,iDAAuB;AACvB,oDAA0B;AAC1B,mDAAyB;AACzB,qDAA2B;AAC3B,iDAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/controllers/api/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB;AACzB,gDAAsB;AACtB,iDAAuB;AACvB,mDAAyB;AACzB,mDAAyB;AACzB,iDAAuB;AACvB,oDAA0B;AAC1B,qDAA2B;AAC3B,kDAAwB;AACxB,mDAAyB;AACzB,iDAAuB;AACvB,qDAA2B;AAC3B,iDAAuB;AACvB,iDAAuB"}

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

@@ -0,0 +1,119 @@
+import { IDeleteMessageResponse, IGetMessageResponse, IQueryMessagesResponse, ISendMessageResponse } 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 { MessagePassingService } from '../../services/messagePassingService';
+import { DefaultBackendIdType } from '../../shared-types';
+import { BaseController } from '../base';
+type MessageApiResponse = ISendMessageResponse | IGetMessageResponse | IQueryMessagesResponse | IDeleteMessageResponse | ApiErrorResponse;
+interface MessagesHandlers extends TypedHandlers {
+    sendMessage: ApiRequestHandler<ISendMessageResponse | ApiErrorResponse>;
+    getMessage: ApiRequestHandler<IGetMessageResponse | ApiErrorResponse>;
+    queryMessages: ApiRequestHandler<IQueryMessagesResponse | ApiErrorResponse>;
+    deleteMessage: ApiRequestHandler<IDeleteMessageResponse | ApiErrorResponse>;
+}
+/**
+ * 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
+ */
+export declare class MessagesController<TID extends PlatformID = DefaultBackendIdType> extends BaseController<TID, MessageApiResponse, MessagesHandlers, CoreLanguageCode> {
+    private messageService;
+    constructor(application: IBrightChainApplication<TID>);
+    /**
+     * Set the MessagePassingService instance.
+     * This allows for dependency injection and testing.
+     */
+    setMessageService(service: MessagePassingService): void;
+    /**
+     * Get the MessagePassingService instance.
+     * Throws if the service has not been set.
+     */
+    private getMessageService;
+    protected initRouteDefinitions(): void;
+    /**
+     * 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
+     */
+    private handleSendMessage;
+    /**
+     * 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
+     */
+    private handleGetMessage;
+    /**
+     * 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
+     */
+    private handleQueryMessages;
+    /**
+     * 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
+     */
+    private handleDeleteMessage;
+}
+export {};
+//# sourceMappingURL=messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/controllers/api/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EAGrB,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;AAEvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAM1D,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,KAAK,kBAAkB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,sBAAsB,GACtB,sBAAsB,GACtB,gBAAgB,CAAC;AAErB,UAAU,gBAAiB,SAAQ,aAAa;IAC9C,WAAW,EAAE,iBAAiB,CAAC,oBAAoB,GAAG,gBAAgB,CAAC,CAAC;IACxE,UAAU,EAAE,iBAAiB,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAAC;IACtE,aAAa,EAAE,iBAAiB,CAAC,sBAAsB,GAAG,gBAAgB,CAAC,CAAC;IAC5E,aAAa,EAAE,iBAAiB,CAAC,sBAAsB,GAAG,gBAAgB,CAAC,CAAC;CAC7E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,qBAAa,kBAAkB,CAC7B,GAAG,SAAS,UAAU,GAAG,oBAAoB,CAC7C,SAAQ,cAAc,CACtB,GAAG,EACH,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,CACjB;IACC,OAAO,CAAC,cAAc,CAAsC;gBAEhD,WAAW,EAAE,uBAAuB,CAAC,GAAG,CAAC;IAIrD;;;OAGG;IACI,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAI9D;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAOzB,SAAS,CAAC,oBAAoB,IAAI,IAAI;IAgCtC;;;;;;;OAOG;YACW,iBAAiB;IAqE/B;;;;;;;OAOG;YACW,gBAAgB;IA6B9B;;;;;;;OAOG;YACW,mBAAmB;IA4CjC;;;;;;;OAOG;YACW,mBAAmB;CAwBlC"}