@futdevpro/nts-dynamo 1.15.46 → 1.15.48

package/src/_modules/server/server-status/server-status.control-service.ts

@@ -10,6 +10,7 @@ import {
   DyFM_Array
 } from '@futdevpro/fsm-dynamo';
 import { Subscription, timer } from 'rxjs';
+import * as mongoose from 'mongoose';
 
 import { version as _serverVersion } from '../../../../package.json';
 import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
@@ -26,6 +27,23 @@ export interface DyNTS_ServerConnection {
   lastCheck?: Date,
 }
 
+/**
+ * A readiness-probe ({@link DyNTS_ServerStatus_ControlService.checkDbReadiness}) eredménye.
+ * `ready=true` CSAK ha a DB-connection él (readyState=1) ÉS a valós ping round-trip sikerült.
+ */
+export interface DyNTS_DbReadiness {
+  /** ready: a DB elérhető (readyState=1 + sikeres ping). Erre adjon az endpoint 200-at, különben 503-at. */
+  ready: boolean;
+  /** mongoose connection.readyState: 0=disconnected, 1=connected, 2=connecting, 3=disconnecting. */
+  dbReadyState: number;
+  /** Sikerült-e a valós DB ping round-trip (csak readyState=1-nél próbáljuk). */
+  dbPingOk: boolean;
+  /** A szerver uptime ms-ban. */
+  uptime: number;
+  /** A szerver verziója. */
+  serverVersion: string;
+}
+
 export abstract class DyNTS_ServerStatus_ControlService<
   T_ServerStatus extends DyFM_ServerStatus,
   T_Error extends DyFM_Error,
@@ -157,6 +175,48 @@ export abstract class DyNTS_ServerStatus_ControlService<
     }
   }
 
+  /**
+   * A mongoose default-connection. Külön metódus = teszt-seam (spy-jal felülírható, hogy a
+   * {@link checkDbReadiness} DB nélkül is tesztelhető legyen).
+   */
+  protected getMongooseConnection(): mongoose.Connection {
+    return mongoose.connection;
+  }
+
+  /**
+   * Readiness-probe: a `/health` (liveness — "a process fut + kiszolgál") MELLETT a DB-elérhetőséget
+   * ellenőrzi. A readyState (mongoose driver-állapot) + egy valós `ping` round-trip → így a "connected
+   * de a DB nem válaszol" eset is kibukik. **Sosem dob** (a probe-nak determinisztikusan kell válaszolnia);
+   * hiba esetén `ready=false`. Az endpoint 503-at adjon, ha nem ready → az orchestrátor (k8s/docker/LB)
+   * ne irányítson forgalmat a DB-vesztett instance-ra.
+   */
+  async checkDbReadiness(): Promise<DyNTS_DbReadiness> {
+    let dbReadyState: number = 0;
+    let dbPingOk: boolean = false;
+
+    try {
+      const connection: mongoose.Connection = this.getMongooseConnection();
+      // readyState: 0=disconnected, 1=connected, 2=connecting, 3=disconnecting
+      dbReadyState = connection?.readyState ?? 0;
+
+      if (dbReadyState === 1) {
+        await connection.db?.admin().ping();
+        dbPingOk = true;
+      }
+    } catch (error) {
+      DyFM_Log.warn('(checkDbReadiness) DB readiness check failed', error);
+      dbPingOk = false;
+    }
+
+    return {
+      ready: dbReadyState === 1 && dbPingOk,
+      dbReadyState: dbReadyState,
+      dbPingOk: dbPingOk,
+      uptime: +new Date() - +this.up,
+      serverVersion: this.serverVersion,
+    };
+  }
+
   async getErrorStatistics(
     range: DyFM_RelativeDate,
     issuer: string

package/src/_modules/server/server-status/server-status.controller.ts

@@ -6,7 +6,7 @@ import { DyNTS_Errors_ControlService } from '../errors/errors.control-service';
 import { DyNTS_Controller } from '../../../_services/route/controller.service';
 import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
 import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
-import { DyNTS_ServerStatus_ControlService } from './server-status.control-service';
+import { DyNTS_DbReadiness, DyNTS_ServerStatus_ControlService } from './server-status.control-service';
 import { DyNTS_ServerStatusSnapshot_ControlService } from './server-status-snapshot.control-service';
 
 
@@ -93,6 +93,21 @@ export abstract class DyNTS_ServerStatus_Controller<
         ],
       }),
 
+      // Readiness-probe: a /health-tel (liveness) szemben a DB-elérhetőséget is ellenőrzi.
+      // Public (mint a /health) — orchestrátor/LB hívja; 503 ha a DB nem ready → no traffic.
+      new DyNTS_Endpoint_Params({
+        name: 'getServerReadiness',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/readiness',
+        tasks: [
+          async (req: Request, res: Response, issuer: string): Promise<void> => {
+            const readiness: DyNTS_DbReadiness = await this.server_CS.checkDbReadiness();
+
+            res.status(readiness.ready ? 200 : 503).send(readiness);
+          },
+        ],
+      }),
+
       new DyNTS_Endpoint_Params({
         name: 'getServerStatusForClient',
         type: DyFM_HttpCallType.get,