@wrcb/cb-common 1.0.512 → 1.0.515

package/build/routes/health.d.ts

@@ -17,4 +17,12 @@ export interface HealthCheckConfig {
         };
     }>;
 }
+/**
+ * Política:
+ * - /live  → liveness: SEM dependências externas, sempre 200 se o processo está up.
+ * - /health → readiness/startup: pode retornar 503 se dependências essenciais falharem.
+ *
+ * Dica: alinhe o STARTUP_GRACE_PERIOD com sua startupProbe.
+ * Por padrão, 300_000 ms (5min). Configurável via HEALTH_STARTUP_GRACE_MS.
+ */
 export declare function createHealthRouter(config: HealthCheckConfig): import("express-serve-static-core").Router;

package/build/routes/health.js

@@ -16,48 +16,56 @@ exports.createHealthRouter = createHealthRouter;
 // @wrcb/cb-common/server/src/routes/health.ts
 const express_1 = __importDefault(require("express"));
 const mongoose_1 = __importDefault(require("mongoose"));
+/**
+ * Política:
+ * - /live  → liveness: SEM dependências externas, sempre 200 se o processo está up.
+ * - /health → readiness/startup: pode retornar 503 se dependências essenciais falharem.
+ *
+ * Dica: alinhe o STARTUP_GRACE_PERIOD com sua startupProbe.
+ * Por padrão, 300_000 ms (5min). Configurável via HEALTH_STARTUP_GRACE_MS.
+ */
 function createHealthRouter(config) {
+    var _a;
     const router = express_1.default.Router();
     const startupTime = Date.now();
-    const STARTUP_GRACE_PERIOD = 60000;
-    // Health Check Principal
-    router.get('/health', (req, res) => {
+    const STARTUP_GRACE_PERIOD = Number((_a = process.env.HEALTH_STARTUP_GRACE_MS) !== null && _a !== void 0 ? _a : 300000); // 5 min por padrão
+    // Liveness: NÃO consultar NATS/Redis/Mongo. Apenas indica que o processo está de pé.
+    router.get('/live', (_req, res) => {
+        res.status(200).send('OK');
+    });
+    // Readiness/Startup (com tolerância durante bootstrap)
+    router.get('/health', (_req, res) => {
         const now = Date.now();
         const isStartup = now - startupTime < STARTUP_GRACE_PERIOD;
-        const health = {
-            status: 'checking',
+        const checks = {
+            mongodb: checkMongoDB()
+        };
+        if (config.natsWrapper) {
+            checks.nats = checkNATS(config.natsWrapper);
+        }
+        if (config.workers) {
+            checks.workers = checkWorkers(config.workers, isStartup);
+        }
+        if (config.customChecks) {
+            checks.custom = checkCustom(config.customChecks);
+        }
+        const allHealthy = isStartup
+            ? checks.mongodb.status === 'healthy' // durante startup, só exigimos Mongo OK
+            : Object.values(checks).every(check => check && typeof check === 'object' && 'status' in check
+                ? check.status === 'healthy'
+                : true);
+        const payload = {
+            status: allHealthy ? 'healthy' : 'unhealthy',
             timestamp: new Date().toISOString(),
             service: config.serviceName,
             uptime: process.uptime(),
             isStartup,
-            checks: Object.assign(Object.assign(Object.assign({ mongodb: checkMongoDB() }, (config.natsWrapper && { nats: checkNATS(config.natsWrapper) })), (config.workers && {
-                workers: checkWorkers(config.workers, isStartup)
-            })), (config.customChecks && {
-                custom: checkCustom(config.customChecks)
-            }))
+            checks
         };
-        // Durante startup, ser mais tolerante
-        const allHealthy = isStartup
-            ? health.checks.mongodb.status === 'healthy'
-            : Object.values(health.checks).every(check => typeof check === 'object' && 'status' in check
-                ? check.status === 'healthy'
-                : true);
-        health.status = allHealthy ? 'healthy' : 'unhealthy';
-        const statusCode = allHealthy ? 200 : 503;
-        res.status(statusCode).json(health);
+        res.status(allHealthy ? 200 : 503).json(payload);
     });
-    // Endpoint simplificado para Kubernetes
-    router.get('/health', (req, res) => {
-        const mongoHealthy = mongoose_1.default.connection.readyState === 1;
-        if (mongoHealthy) {
-            res.status(200).send('OK');
-        }
-        else {
-            res.status(503).send('NOT READY');
-        }
-    });
-    // Endpoint de métricas
-    router.get('/metrics', (req, res) => __awaiter(this, void 0, void 0, function* () {
+    // Métricas opcionais
+    router.get('/metrics', (_req, res) => __awaiter(this, void 0, void 0, function* () {
         try {
             const metrics = {
                 timestamp: new Date().toISOString(),
@@ -81,8 +89,9 @@ function createHealthRouter(config) {
     }));
     return router;
 }
-// Funções auxiliares
+// Auxiliares
 function checkMongoDB() {
+    var _a;
     const state = mongoose_1.default.connection.readyState;
     const states = {
         0: { status: 'unhealthy', message: 'disconnected' },
@@ -90,14 +99,13 @@ function checkMongoDB() {
         2: { status: 'unhealthy', message: 'connecting' },
         3: { status: 'unhealthy', message: 'disconnecting' }
     };
-    return (states[state] || {
+    return ((_a = states[state]) !== null && _a !== void 0 ? _a : {
         status: 'unhealthy',
         message: 'unknown'
     });
 }
 function checkNATS(natsWrapper) {
     try {
-        // Verificar se client existe sem tentar acessá-lo se não estiver pronto
         if (!natsWrapper || typeof natsWrapper.client === 'undefined') {
             return { status: 'unhealthy', message: 'not_initialized' };
         }
@@ -105,7 +113,7 @@ function checkNATS(natsWrapper) {
             ? { status: 'unhealthy', message: 'connection_closed' }
             : { status: 'healthy', message: 'connected' };
     }
-    catch (error) {
+    catch (_a) {
         return { status: 'unhealthy', message: 'not_connected' };
     }
 }
@@ -114,14 +122,13 @@ function checkWorkers(workers, isStartup = false) {
     let allRunning = true;
     try {
         workers.forEach(({ name, instance, isRunningProperty = 'isRunning' }) => {
-            const isRunning = instance[isRunningProperty] === true;
+            const isRunning = (instance === null || instance === void 0 ? void 0 : instance[isRunningProperty]) === true;
             workerStatus[name] = isRunning ? 'running' : 'stopped';
             if (!isRunning && !isStartup)
                 allRunning = false;
         });
     }
-    catch (error) {
-        console.error('Error checking workers:', error);
+    catch (_a) {
         if (!isStartup)
             allRunning = false;
     }
@@ -141,7 +148,7 @@ function checkCustom(customChecks) {
             if (result.status !== 'healthy')
                 allHealthy = false;
         }
-        catch (error) {
+        catch (_a) {
             results[name] = { status: 'unhealthy', message: 'check_failed' };
             allHealthy = false;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrcb/cb-common",
-  "version": "1.0.512",
+  "version": "1.0.515",
   "description": "Common resources between services",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",