replica-failover-mongodb-ts 2.2.4 → 3.0.3

package/Readme.md

@@ -5,14 +5,52 @@
 [![Node.js](https://img.shields.io/badge/Node.js-20.x-green)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org/)
 
-## 🚀 Quick Start (Dashboard CLI)
+## 🚀 QuickStart (Plug & Play)
 
-Se você quer apenas rodar o painel de controle visualmente para testar qualquer API:
+Escolha como você quer usar o projeto:
 
-```bash
-npm install -g replica-failover-mongodb-ts
-node-balancer-dashboard
-```
+### Opção A: Via NPM (Apenas Dashboard)
+Ideal se você já tem um cluster MongoDB e quer apenas visualizar/controlar.
+
+1.  **Instale a ferramenta globalmente:**
+    ```bash
+    npm install -g replica-failover-mongodb-ts
+    ```
+
+2.  **Rode o dashboard:**
+    ```bash
+    node-balancer-dashboard
+    ```
+
+3.  **Responda às perguntas de configuração:**
+    O sistema pedirá os dados do seu ambiente. Exemplo de preenchimento:
+
+    -   **API URL**: `http://localhost:3000/api/users`
+    -   **MongoDB Nodes**: `mongodb://localhost:27017,mongodb://localhost:27018`
+    -   **Enable Docker Control?**: `Yes` (Se quiser parar/iniciar containers pelo painel)
+    -   **Docker Container Names**: `mongo1,mongo2,mongo3`
+
+### Opção B: Via Git (Ambiente Completo)
+Ideal para ver a mágica acontecer do zero (cria API + Banco + Réplicas).
+
+1.  **Clone e Instale:**
+    ```bash
+    git clone https://github.com/JoaoIto/node-balancer.git
+    cd node-balancer
+    npm install
+    ```
+
+2.  **Suba o Ambiente (Docker):**
+    ```bash
+    docker-compose up -d --build
+    ```
+    *Aguarde ~30s para o cluster configurar.*
+
+3.  **Rode o Dashboard:**
+    ```bash
+    npm run dashboard
+    ```
+    *Pronto! Selecione "RUN CHAOS DEMO" e divirta-se.*
 
 ---
 
@@ -32,8 +70,9 @@ O Node Balancer é uma API escalável construída utilizando Node.js, MongoDB co
 4.  [Visual Dashboard (Painel de Controle)](#visual-dashboard-painel-de-controle)
 5.  [Uso Avançado do Dashboard (CLI)](#uso-avançado-do-dashboard-cli)
 6.  [Testes e Automação (Chaos Testing)](#testes-e-automação-chaos-testing)
-7.  [Documentação Detalhada](#documentação-detalhada)
-8.  [Configuração Manual (Referência)](#configuração-manual-referência)
+7.  [Observabilidade (v3.0)](#observabilidade-v30)
+8.  [Documentação Detalhada](#documentação-detalhada)
+9.  [Configuração Manual (Referência)](#configuração-manual-referência)
 
 ---
 
@@ -201,6 +240,29 @@ npm run ops:demo
 
 ---
 
+## Observabilidade (v3.0)
+
+A versão 3.0 introduz recursos avançados de monitoramento para produção:
+
+### 🔔 Webhooks (Rápido)
+Receba alertas no seu Slack ou Discord. Basta passar a URL ao iniciar:
+
+```typescript
+const db = new ConnectionManager({
+    nodes: [...],
+    webhookUrl: 'https://discord.com/api/webhooks/...' // Sua URL aqui
+});
+```
+*O sistema fará um POST automático com JSON sempre que houver um failover.*
+
+### 📊 Métricas e Real-time
+-   **Prometheus**: Acesse `http://localhost:3000/metrics` para ver dados de latência e conexão.
+-   **WebSocket**: Conecte via Socket.io para receber logs em tempo real.
+
+👉 **[Leia o guia completo de Observabilidade (Português)](docs/observability.md)**
+
+---
+
 ## Documentação Detalhada
 
 Para mais detalhes, consulte os guias na pasta `docs/`:
@@ -208,6 +270,7 @@ Para mais detalhes, consulte os guias na pasta `docs/`:
 -   🖥️ **[Guia do Dashboard (Visual Runner)](docs/dashboard-runner.md)**: Manual completo do painel interativo.
 -   📄 **[Guia de Testes e Execução (Demo Runner)](docs/demo-runner.md)**: Passo a passo detalhado de como rodar os testes manuais e automatizados.
 -   🛠️ **[Documentação dos Scripts](docs/scripts.md)**: Explicação técnica de como os scripts de automação funcionam.
+-   📡 **[Observabilidade e Alertas](docs/observability.md)**: Guia de configuração de Webhooks, Métricas e WebSocket.
 
 ---
 

package/dist/config/connectionManager.js

@@ -8,10 +8,16 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConnectionManager = void 0;
 const mongodb_1 = require("mongodb");
+const axios_1 = __importDefault(require("axios"));
 const logger_1 = require("../middlewares/logger");
+const websocket_1 = require("./websocket");
+const metrics_1 = require("./metrics");
 class ConnectionManager {
     constructor(opts) {
         var _a;
@@ -22,6 +28,7 @@ class ConnectionManager {
         this.nodes = (opts.nodes || []).map((u, i) => ({ uri: u, name: `node${i + 1}` }));
         this.dbName = opts.dbName || 'node-balancer';
         this.healthCheckIntervalMs = (_a = opts.healthCheckIntervalMs) !== null && _a !== void 0 ? _a : 5000;
+        this.webhookUrl = opts.webhookUrl;
     }
     init() {
         return __awaiter(this, void 0, void 0, function* () {
@@ -77,12 +84,16 @@ class ConnectionManager {
         this.primaryDb = client.db(this.dbName);
         // register monitoring events on the client
         client.on('topologyDescriptionChanged', (td) => {
+            var _a;
             logger_1.logger.info(`topologyDescriptionChanged: ${JSON.stringify(this.summarizeTopology(td))}`);
-            this.recordEvent('topologyDescriptionChanged', { td: this.summarizeTopology(td) }).catch(() => { });
+            const summary = this.summarizeTopology(td);
+            this.recordEvent('topologyDescriptionChanged', { td: summary }).catch(() => { });
+            (_a = (0, websocket_1.getIO)()) === null || _a === void 0 ? void 0 : _a.emit('topology-change', summary);
         });
         client.on('serverHeartbeatFailed', (event) => {
             logger_1.logger.warn(`serverHeartbeatFailed: ${JSON.stringify(event)}`);
             this.recordEvent('serverHeartbeatFailed', { event }).catch(() => { });
+            this.sendAlert('serverHeartbeatFailed', event).catch(() => { });
         });
         client.on('serverHeartbeatSucceeded', (event) => {
             logger_1.logger.debug(`serverHeartbeatSucceeded: ${JSON.stringify(event)}`);
@@ -92,6 +103,7 @@ class ConnectionManager {
             this.recordEvent('clientClose', {}).catch(() => { });
         });
         logger_1.logger.info('Primary client attached.');
+        metrics_1.connectionStatus.set(1);
     }
     summarizeTopology(td) {
         // gentle summary - driver topologyDescription shape may vary
@@ -130,21 +142,38 @@ class ConnectionManager {
     }
     recordEvent(type, payload) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
             try {
-                if (!this.primaryDb)
-                    return;
-                yield this.primaryDb.collection('logs').insertOne({
+                const event = {
                     ts: new Date(),
                     level: 'event',
                     type,
                     payload,
-                });
+                };
+                (_a = (0, websocket_1.getIO)()) === null || _a === void 0 ? void 0 : _a.emit('log', event);
+                if (!this.primaryDb)
+                    return;
+                yield this.primaryDb.collection('logs').insertOne(event);
             }
             catch (err) {
                 logger_1.logger.warn('recordEvent failed: ' + err.message);
             }
         });
     }
+    sendAlert(event, details) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.webhookUrl)
+                return;
+            try {
+                yield axios_1.default.post(this.webhookUrl, {
+                    text: `⚠️ **NodeBalancer Alert**\n**Event**: ${event}\n**Details**: \`\`\`${JSON.stringify(details, null, 2)}\`\`\``
+                });
+            }
+            catch (err) {
+                logger_1.logger.warn(`Failed to send webhook alert: ${err.message}`);
+            }
+        });
+    }
     startHealthChecks() {
         if (this.healthInterval)
             clearInterval(this.healthInterval);
@@ -165,6 +194,7 @@ class ConnectionManager {
                 catch (_a) { }
                 this.primaryClient = null;
                 this.primaryDb = null;
+                metrics_1.connectionStatus.set(0);
             }
             // attempt to find a writable node among nodes (directConnection)
             for (const n of this.nodes) {
@@ -176,6 +206,8 @@ class ConnectionManager {
                         logger_1.logger.info(`Health-check: promoted ${n.uri} to primary connection`);
                         this.attachClient(c);
                         yield this.recordEvent('promote', { node: n.uri });
+                        yield this.sendAlert('promote', { node: n.uri, message: 'Promoted new primary connection' });
+                        metrics_1.failoverCount.inc();
                         return;
                     }
                     else {
@@ -189,6 +221,7 @@ class ConnectionManager {
             // no writable found
             logger_1.logger.error('Health-check: no writable nodes found.');
             yield this.recordEvent('no-writable', {});
+            yield this.sendAlert('no-writable', { message: 'CRITICAL: No writable nodes found in cluster!' });
         });
     }
     getDb() {
@@ -212,6 +245,7 @@ class ConnectionManager {
                     meta,
                     durationMs: took,
                 });
+                metrics_1.operationDuration.observe({ operation: 'read', collection: collectionName, success: 'true' }, took / 1000);
                 return res;
             }
             catch (err) {
@@ -225,6 +259,7 @@ class ConnectionManager {
                     meta,
                     durationMs: took,
                 });
+                metrics_1.operationDuration.observe({ operation: 'read', collection: collectionName, success: 'false' }, took / 1000);
                 throw err;
             }
         });
@@ -246,6 +281,7 @@ class ConnectionManager {
                     meta,
                     durationMs: took,
                 });
+                metrics_1.operationDuration.observe({ operation: 'write', collection: collectionName, success: 'true' }, took / 1000);
                 return res;
             }
             catch (err) {
@@ -259,13 +295,16 @@ class ConnectionManager {
                     meta,
                     durationMs: took,
                 });
+                metrics_1.operationDuration.observe({ operation: 'write', collection: collectionName, success: 'false' }, took / 1000);
                 throw err;
             }
         });
     }
     safeLog(doc) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
             try {
+                (_a = (0, websocket_1.getIO)()) === null || _a === void 0 ? void 0 : _a.emit('log', doc);
                 if (!this.primaryDb) {
                     logger_1.logger.warn('safeLog: no primaryDb, skipping db log. Logging to console instead.');
                     logger_1.logger.info(JSON.stringify(doc));

package/dist/config/metrics.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.operationDuration = exports.failoverCount = exports.connectionStatus = exports.register = void 0;
+const prom_client_1 = __importDefault(require("prom-client"));
+// Create a Registry
+exports.register = new prom_client_1.default.Registry();
+// Add default metrics (cpu, memory, etc.)
+prom_client_1.default.collectDefaultMetrics({ register: exports.register });
+// Define custom metrics
+exports.connectionStatus = new prom_client_1.default.Gauge({
+    name: 'node_balancer_connection_status',
+    help: 'Status of the MongoDB connection (1 = connected, 0 = disconnected)',
+    registers: [exports.register]
+});
+exports.failoverCount = new prom_client_1.default.Counter({
+    name: 'node_balancer_failover_count',
+    help: 'Total number of failover events triggered',
+    registers: [exports.register]
+});
+exports.operationDuration = new prom_client_1.default.Histogram({
+    name: 'node_balancer_operation_duration_seconds',
+    help: 'Duration of database operations in seconds',
+    labelNames: ['operation', 'collection', 'success'],
+    buckets: [0.01, 0.05, 0.1, 0.5, 1, 2, 5],
+    registers: [exports.register]
+});

package/dist/config/websocket.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIO = exports.initWebSocket = void 0;
+const socket_io_1 = require("socket.io");
+const logger_1 = require("../middlewares/logger");
+let io = null;
+const initWebSocket = (httpServer) => {
+    io = new socket_io_1.Server(httpServer, {
+        cors: {
+            origin: "*",
+            methods: ["GET", "POST"]
+        }
+    });
+    io.on('connection', (socket) => {
+        logger_1.logger.info(`New WebSocket connection: ${socket.id}`);
+        socket.on('disconnect', () => {
+            logger_1.logger.info(`WebSocket disconnected: ${socket.id}`);
+        });
+    });
+    logger_1.logger.info('WebSocket Server initialized');
+    return io;
+};
+exports.initWebSocket = initWebSocket;
+const getIO = () => {
+    if (!io) {
+        logger_1.logger.warn('getIO called before initialization');
+    }
+    return io;
+};
+exports.getIO = getIO;

package/dist/scripts/dashboard.js

@@ -18,70 +18,26 @@ const blessed_contrib_1 = __importDefault(require("blessed-contrib"));
 const mongodb_1 = require("mongodb");
 const http_1 = __importDefault(require("http"));
 const child_process_1 = require("child_process");
+const inquirer_1 = __importDefault(require("inquirer"));
+const socket_io_client_1 = require("socket.io-client");
 // Parse Args
 const args = process.argv.slice(2);
-function getArg(flag, def) {
+function getArg(flag, def = null) {
     const idx = args.indexOf(flag);
     return idx !== -1 && args[idx + 1] ? args[idx + 1] : def;
 }
-const API_URL = getArg('--api-url', 'http://localhost:3000/api/users');
-const NODES_ARG = getArg('--nodes', 'mongodb://localhost:27017/node-balancer,mongodb://localhost:27018/node-balancer,mongodb://localhost:27019/node-balancer');
-const DOCKER_CONTAINERS_ARG = getArg('--docker-containers', 'mongo1,mongo2,mongo3');
-const NO_DOCKER = args.includes('--no-docker');
-const NODES = NODES_ARG.split(',').map((uri, i) => ({
-    name: `node${i + 1}`,
-    uri: uri.trim()
-}));
-const DOCKER_NODES = DOCKER_CONTAINERS_ARG.split(',').map(n => n.trim());
-// Screen Setup
-const screen = blessed_1.default.screen({
-    smartCSR: true,
-    title: 'NodeBalancer Control Center'
-});
-const grid = new blessed_contrib_1.default.grid({ rows: 12, cols: 12, screen: screen });
-// Components
-const topologyTable = grid.set(0, 0, 6, 4, blessed_contrib_1.default.table, {
-    keys: true,
-    fg: 'white',
-    selectedFg: 'white',
-    selectedBg: 'blue',
-    interactive: false,
-    label: 'Cluster Topology',
-    border: { type: "line", fg: "cyan" },
-    columnSpacing: 3,
-    columnWidth: [10, 15, 10]
-});
-const latencyLine = grid.set(0, 4, 6, 8, blessed_contrib_1.default.line, {
-    style: { line: "yellow", text: "green", baseline: "black" },
-    xLabelPadding: 3,
-    xPadding: 5,
-    showLegend: true,
-    legend: { width: 20 },
-    label: 'API Response Time (ms)'
-});
-const logBox = grid.set(6, 0, 6, 8, blessed_contrib_1.default.log, {
-    fg: "green",
-    selectedFg: "green",
-    label: 'Execution Logs'
-});
-const controls = grid.set(6, 8, 6, 4, blessed_1.default.list, {
-    label: 'Actions (Enter to Execute)',
-    keys: true,
-    vi: true,
-    mouse: true,
-    style: { selected: { bg: 'blue' }, item: { fg: 'white' } },
-    items: [
-        'RUN CHAOS DEMO (Auto)',
-        'SEND BATCH (2 POST + 1 GET)',
-        ...(NO_DOCKER ? [] : [
-            'STOP PRIMARY',
-            ...DOCKER_NODES.map(n => `START ${n.toUpperCase()}`),
-            'START STACK'
-        ]),
-        'EXIT'
-    ]
-});
-// State
+// Global Config (Mutable)
+let API_URL = '';
+let NODES = [];
+let DOCKER_NODES = [];
+let NO_DOCKER = false;
+// TUI State (Lazy Init)
+let screen;
+let grid;
+let topologyTable;
+let latencyLine;
+let logBox;
+let controls;
 let latencyData = {
     title: 'Latency',
     x: Array(20).fill('.'),
@@ -89,6 +45,10 @@ let latencyData = {
 };
 // Utils
 function log(msg) {
+    if (!logBox) {
+        console.log(msg);
+        return;
+    }
     const time = new Date().toISOString().split('T')[1].split('.')[0];
     logBox.log(`[${time}] ${msg}`);
     screen.render();
@@ -133,6 +93,8 @@ function request(method) {
     });
 }
 function updateLatencyGraph(ms) {
+    if (!latencyLine)
+        return;
     latencyData.y.shift();
     latencyData.y.push(ms);
     latencyLine.setData([latencyData]);
@@ -157,6 +119,8 @@ function getPrimary() {
 }
 function updateTopology() {
     return __awaiter(this, void 0, void 0, function* () {
+        if (!topologyTable)
+            return;
         const rows = [];
         for (const node of NODES) {
             let status = 'DOWN';
@@ -164,7 +128,7 @@ function updateTopology() {
             try {
                 const client = new mongodb_1.MongoClient(node.uri, { serverSelectionTimeoutMS: 500, directConnection: true });
                 yield client.connect();
-                const db = client.db('node-balancer'); // Assuming DB name is consistent or part of URI, but here hardcoded for now or could be arg
+                const db = client.db('node-balancer');
                 const hello = yield db.command({ hello: 1 });
                 count = (yield db.collection('users').countDocuments()).toString();
                 yield client.close();
@@ -200,9 +164,7 @@ function runChaosDemo() {
         }
         else {
             // Chaos
-            const primaryName = yield getPrimary(); // returns node1, node2...
-            // We need to map node name to container name if they differ, but here we assume index matching or we need smarter logic
-            // For simplicity in this generic version, let's try to find the container name based on index
+            const primaryName = yield getPrimary();
             const primaryIndex = NODES.findIndex(n => n.name === primaryName);
             const containerName = primaryIndex !== -1 ? DOCKER_NODES[primaryIndex] : null;
             if (containerName) {
@@ -241,75 +203,199 @@ function runChaosDemo() {
         log('✅ DEMO COMPLETED');
     });
 }
-// Controls Event Handler
-controls.on('select', (item, index) => __awaiter(void 0, void 0, void 0, function* () {
-    const cmd = item.getText();
-    if (cmd.includes('RUN CHAOS DEMO')) {
-        runChaosDemo();
-    }
-    else if (cmd.includes('SEND BATCH')) {
-        runBatch();
-    }
-    else if (cmd.includes('STOP PRIMARY')) {
-        if (NO_DOCKER)
-            return log('Docker disabled.');
-        const pName = yield getPrimary();
-        const pIdx = NODES.findIndex(n => n.name === pName);
-        const container = pIdx !== -1 ? DOCKER_NODES[pIdx] : null;
-        if (container) {
-            log(`Stopping ${container}...`);
+function initTui() {
+    screen = blessed_1.default.screen({
+        smartCSR: true,
+        title: 'NodeBalancer Control Center'
+    });
+    grid = new blessed_contrib_1.default.grid({ rows: 12, cols: 12, screen: screen });
+    topologyTable = grid.set(0, 0, 6, 4, blessed_contrib_1.default.table, {
+        keys: true,
+        fg: 'white',
+        selectedFg: 'white',
+        selectedBg: 'blue',
+        interactive: false,
+        label: 'Cluster Topology',
+        border: { type: "line", fg: "cyan" },
+        columnSpacing: 3,
+        columnWidth: [10, 15, 10]
+    });
+    latencyLine = grid.set(0, 4, 6, 8, blessed_contrib_1.default.line, {
+        style: { line: "yellow", text: "green", baseline: "black" },
+        xLabelPadding: 3,
+        xPadding: 5,
+        showLegend: true,
+        legend: { width: 20 },
+        label: 'API Response Time (ms)'
+    });
+    logBox = grid.set(6, 0, 6, 8, blessed_contrib_1.default.log, {
+        fg: "green",
+        selectedFg: "green",
+        label: 'Execution Logs'
+    });
+    controls = grid.set(6, 8, 6, 4, blessed_1.default.list, {
+        label: 'Actions (Enter to Execute)',
+        keys: true,
+        vi: true,
+        mouse: true,
+        style: { selected: { bg: 'blue' }, item: { fg: 'white' } },
+        items: [
+            'RUN CHAOS DEMO (Auto)',
+            'SEND BATCH (2 POST + 1 GET)',
+            ...(NO_DOCKER ? [] : [
+                'STOP PRIMARY',
+                ...DOCKER_NODES.map(n => `START ${n.toUpperCase()}`),
+                'START STACK'
+            ]),
+            'EXIT'
+        ]
+    });
+    controls.on('select', (item, index) => __awaiter(this, void 0, void 0, function* () {
+        const cmd = item.getText();
+        if (cmd.includes('RUN CHAOS DEMO')) {
+            runChaosDemo();
+        }
+        else if (cmd.includes('SEND BATCH')) {
+            runBatch();
+        }
+        else if (cmd.includes('STOP PRIMARY')) {
+            if (NO_DOCKER)
+                return log('Docker disabled.');
+            const pName = yield getPrimary();
+            const pIdx = NODES.findIndex(n => n.name === pName);
+            const container = pIdx !== -1 ? DOCKER_NODES[pIdx] : null;
+            if (container) {
+                log(`Stopping ${container}...`);
+                try {
+                    (0, child_process_1.execSync)(`docker stop ${container}`);
+                    log('Stopped.');
+                }
+                catch (e) {
+                    log('Error.');
+                }
+            }
+            else {
+                log('No Primary found.');
+            }
+        }
+        else if (cmd.includes('START MONGO') || cmd.includes('START NODE')) {
+            if (NO_DOCKER)
+                return log('Docker disabled.');
+            const parts = cmd.split(' ');
+            const container = parts[1].toLowerCase();
+            log(`Starting ${container}...`);
             try {
-                (0, child_process_1.execSync)(`docker stop ${container}`);
-                log('Stopped.');
+                (0, child_process_1.execSync)(`docker start ${container}`);
+                log('Started.');
             }
             catch (e) {
                 log('Error.');
             }
         }
-        else {
-            log('No Primary found.');
-        }
-    }
-    else if (cmd.includes('START MONGO') || cmd.includes('START NODE')) { // Generic match
-        if (NO_DOCKER)
-            return log('Docker disabled.');
-        // Extract container name from string "START MONGO1"
-        const parts = cmd.split(' ');
-        const container = parts[1].toLowerCase(); // mongo1
-        log(`Starting ${container}...`);
-        try {
-            (0, child_process_1.execSync)(`docker start ${container}`);
-            log('Started.');
+        else if (cmd.includes('START STACK')) {
+            if (NO_DOCKER)
+                return log('Docker disabled.');
+            log('Starting stack...');
+            try {
+                (0, child_process_1.execSync)('docker-compose up -d');
+                log('Stack up.');
+            }
+            catch (e) {
+                log(`Error: ${e.message.split('\n')[0]}`);
+            }
         }
-        catch (e) {
-            log('Error.');
+        else if (cmd.includes('EXIT')) {
+            process.exit(0);
         }
-    }
-    else if (cmd.includes('START STACK')) {
-        if (NO_DOCKER)
-            return log('Docker disabled.');
-        log('Starting stack...');
-        try {
-            (0, child_process_1.execSync)('docker-compose up -d');
-            log('Stack up.');
+    }));
+    screen.key(['escape', 'q', 'C-c'], () => process.exit(0));
+    controls.focus();
+    screen.render();
+}
+// Main Execution
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Check if flags are provided, otherwise prompt
+        const argApiUrl = getArg('--api-url');
+        const argNodes = getArg('--nodes');
+        const argDocker = getArg('--docker-containers');
+        const argNoDocker = args.includes('--no-docker');
+        if (argApiUrl && argNodes) {
+            // Non-interactive mode (Flags provided)
+            API_URL = argApiUrl;
+            NODES = argNodes.split(',').map((uri, i) => ({ name: `node${i + 1}`, uri: uri.trim() }));
+            DOCKER_NODES = (argDocker || 'mongo1,mongo2,mongo3').split(',').map(n => n.trim());
+            NO_DOCKER = argNoDocker;
         }
-        catch (e) {
-            log(`Error: ${e.message.split('\n')[0]}`);
+        else {
+            // Interactive mode
+            console.clear();
+            console.log('🤖 NodeBalancer Dashboard Setup\n');
+            const answers = yield inquirer_1.default.prompt([
+                {
+                    type: 'input',
+                    name: 'apiUrl',
+                    message: 'API URL:',
+                    default: 'http://localhost:3000/api/users'
+                },
+                {
+                    type: 'input',
+                    name: 'nodes',
+                    message: 'MongoDB Nodes (comma separated):',
+                    default: 'mongodb://localhost:27017/node-balancer,mongodb://localhost:27018/node-balancer,mongodb://localhost:27019/node-balancer'
+                },
+                {
+                    type: 'confirm',
+                    name: 'enableDocker',
+                    message: 'Enable Docker Control (Stop/Start containers)?',
+                    default: true
+                },
+                {
+                    type: 'input',
+                    name: 'dockerContainers',
+                    message: 'Docker Container Names (comma separated):',
+                    default: 'mongo1,mongo2,mongo3',
+                    when: (answers) => answers.enableDocker
+                }
+            ]);
+            API_URL = answers.apiUrl;
+            NODES = answers.nodes.split(',').map((uri, i) => ({ name: `node${i + 1}`, uri: uri.trim() }));
+            NO_DOCKER = !answers.enableDocker;
+            DOCKER_NODES = (answers.dockerContainers || '').split(',').map((n) => n.trim());
         }
-    }
-    else if (cmd.includes('EXIT')) {
-        process.exit(0);
-    }
-}));
-// Loops
-setInterval(updateTopology, 2000);
-// Init
-controls.focus();
-log('Control Center Ready.');
-if (NO_DOCKER)
-    log('Docker Control: DISABLED');
-log(`API: ${API_URL}`);
-updateTopology();
-screen.render();
-// Exit
-screen.key(['escape', 'q', 'C-c'], () => process.exit(0));
+        // Init TUI AFTER prompts
+        initTui();
+        log('Control Center Ready.');
+        if (NO_DOCKER)
+            log('Docker Control: DISABLED');
+        log(`API: ${API_URL}`);
+        // Init WebSocket
+        const socket = (0, socket_io_client_1.io)(API_URL.replace('/api/users', '').replace('/api', ''));
+        socket.on('connect', () => log('✅ WebSocket Connected'));
+        socket.on('disconnect', () => log('❌ WebSocket Disconnected'));
+        socket.on('log', (data) => {
+            let msg = '';
+            if (data.type === 'promote')
+                msg = `👑 NEW PRIMARY: ${data.payload.node}`;
+            else if (data.type === 'no-writable')
+                msg = `🚨 CRITICAL: NO WRITABLE NODES`;
+            else if (data.op)
+                msg = `${data.op.toUpperCase()} ${data.collection} (${data.durationMs}ms) ${data.success ? '✅' : '❌'}`;
+            else
+                msg = JSON.stringify(data);
+            log(`[WS] ${msg}`);
+        });
+        socket.on('topology-change', () => {
+            log(`[WS] Topology Change`);
+            updateTopology();
+        });
+        // Loops
+        setInterval(updateTopology, 2000);
+        updateTopology();
+    });
+}
+// Start
+main().catch(err => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/server.js

@@ -1,11 +1,32 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const app_1 = __importDefault(require("./app"));
 const logger_1 = require("./middlewares/logger");
+const websocket_1 = require("./config/websocket");
+const metrics_1 = require("./config/metrics");
 const PORT = process.env.PORT || 3000;
-app_1.default.listen(PORT, () => {
+app_1.default.get('/metrics', (req, res) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        res.set('Content-Type', metrics_1.register.contentType);
+        res.end(yield metrics_1.register.metrics());
+    }
+    catch (ex) {
+        res.status(500).end(ex);
+    }
+}));
+const server = app_1.default.listen(PORT, () => {
     logger_1.logger.info(`Servidor rodando na porta ${PORT}`);
 });
+(0, websocket_1.initWebSocket)(server);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replica-failover-mongodb-ts",
-  "version": "2.2.4",
+  "version": "3.0.3",
   "description": "O sistema replica um dos conceitos básicos da arquitetura de sistemas distribuído, na qual ele tem uma API em express.js com TypeScript, e usando o mongoDB com replicaSET e failover, consegue automáticamente garantir disponibilidade e redundância de dados das requisições.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -31,12 +31,18 @@
   "license": "ISC",
   "dependencies": {
     "@types/blessed": "^0.1.26",
+    "@types/inquirer": "^9.0.9",
+    "axios": "^1.13.2",
     "blessed": "^0.1.81",
     "blessed-contrib": "^4.11.0",
     "dotenv": "^17.2.3",
     "express": "^5.1.0",
+    "inquirer": "^8.0.0",
     "mongoose": "^8.19.1",
     "morgan": "^1.10.1",
+    "prom-client": "^15.1.3",
+    "socket.io": "^4.8.1",
+    "socket.io-client": "^4.8.1",
     "winston": "^3.18.3"
   },
   "devDependencies": {