@nextage/era-lib 1.0.164 → 1.0.165

package/README.md

@@ -0,0 +1,83 @@
+# @nextage/era-lib
+
+Libreria backend condivisa del progetto **ERA**. Fornisce eventi, modelli, servizi,
+utility e l'orchestratore di bootstrap dei servizi, costruita sopra
+[`@nextage/nx-frame-be`](https://www.npmjs.com/package/@nextage/nx-frame-be).
+
+È consumata dai microservizi Node del backend (`auth-srv`, `app-srv`, ...) tramite il
+registry npm privato Nextage: `"@nextage/era-lib": "^1.0.x"`.
+
+## Contenuto
+
+| Area | Cosa | Path |
+| -- | -- | -- |
+| **utils** | `initConfig`, `readEnv`, `startService`, `createHealthRouter`, helper express | `src/utils` |
+| **events** | `BaseEventCtrl`, publisher/listener NATS + in-memory, entità di dominio | `src/events` |
+| **services** | `Password` (hash/verify), ... | `src/services` |
+| **routes** | validator/formatErrors REST | `src/routes` |
+| **constants / enums / interfaces / types** | costanti e tipi condivisi | `src/*` |
+
+## Bootstrap dei servizi — `startService()`
+
+Orchestratore di avvio deterministico (ADR-0001). Esegue le fasi in ordine, con
+**fail-fast** e **readiness gate**, al posto del vecchio avvio su `setTimeout`.
+
+```ts
+import { startService, createHealthRouter } from '@nextage/era-lib';
+import { APP } from './core/config/app.config';
+
+await startService({
+  app   : APP,
+  phases: [
+    { label: 'database',   run: () => initDB() },
+    { label: 'messaging',  run: () => initMessages() },
+    { label: 'http wiring', run: () => initHttp() },      // express/routes, NO listen
+    { label: 'modules',    run: () => loadModules() },    // registra listener/schema
+    { label: 'listen',     run: () => startServer() }     // createServer + apollo + listen
+  ],
+  shutdown: [
+    () => apollo.stop(),
+    () => natsWrapper.close(),
+    () => APP.mongoose?.disconnect()
+  ]
+});
+```
+
+- `APP.status` passa a `OK` **solo dopo** che tutte le fasi si sono concluse.
+- `createHealthRouter(APP)` espone `GET /healthz` (liveness) e `GET /readyz`
+  (readiness = `APP.status === OK`). Montare **prima** del middleware JWT.
+
+## Sviluppo
+
+```bash
+npm install
+npm run build      # clean + tsc → build/
+npm test           # vitest run
+npm run test:watch # vitest (watch)
+```
+
+Test framework: **Vitest** (standard di progetto). Gli spec vivono accanto al codice come
+`*.spec.ts` / `*.test.ts` e sono esclusi dalla build (`tsconfig.json`).
+
+## Pubblicare / aggiornare la libreria
+
+La procedura completa (con la distinzione **chi fa cosa**) è documentata in
+[docs/architecture/era-lib.md](../../docs/architecture/era-lib.md).
+
+In sintesi:
+
+1. Aggiorna il codice e **aggiorna `CHANGELOG.md`**.
+2. Commit del codice (l'albero git deve essere pulito: `npm version` lo richiede).
+3. Bump di versione + tag: `npm run release:patch` (o `release:minor` / `release:major`).
+4. Pubblica: `npm run pub` (esegue build e `npm publish`; `prepublishOnly` garantisce
+   comunque la build).
+5. Aggiorna la dipendenza nei servizi consumatori e reinstalla.
+
+> ⚠️ Il `npm publish` è un'azione condivisa e non annullabile (richiede autenticazione al
+> registry). Vedi il documento sopra per la regola operativa concordata.
+
+## Convenzioni di codice
+
+Vedi le convenzioni backend TypeScript del progetto: formattazione a colonne allineate,
+naming `kebab.concern`, layering interfaces → model → controller → graphql, comunicazione
+via eventi.

package/build/events/__mocks__/msg-wrapper.d.ts

@@ -1,6 +1,6 @@
 export declare const msgWrapper: {
     client: {
-        publish: jest.Mock<any, any, any>;
+        publish: import("vitest").Mock<(...args: any[]) => any>;
     };
 };
 //# sourceMappingURL=msg-wrapper.d.ts.map

package/build/events/__mocks__/msg-wrapper.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.msgWrapper = void 0;
+const vitest_1 = require("vitest");
 exports.msgWrapper = {
     client: {
-        publish: jest.fn().mockImplementation((subject, data, options) => {
+        publish: vitest_1.vi.fn().mockImplementation((subject, data, options) => {
         })
         // publish: (subject: string, data: string, callback: () => void) => {
         //   callback();

package/build/events/__mocks__/msg-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"msg-wrapper.js","sourceRoot":"","sources":["../../../src/events/__mocks__/msg-wrapper.ts"],"names":[],"mappings":";;;AAGa,QAAA,UAAU,GAAG;IAExB,MAAM,EAAE;QAEN,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CACnC,CAAC,OAAe,EAAE,IAAY,EAAE,OAAkB,EAAE,EAAE;QAEtD,CAAC,CACF;QACD,sEAAsE;QACtE,gBAAgB;QAChB,KAAK;KAEN;CACF,CAAC"}
+{"version":3,"file":"msg-wrapper.js","sourceRoot":"","sources":["../../../src/events/__mocks__/msg-wrapper.ts"],"names":[],"mappings":";;;AAAA,mCAAiC;AAGpB,QAAA,UAAU,GAAG;IAExB,MAAM,EAAE;QAEN,OAAO,EAAE,WAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CACjC,CAAC,OAAe,EAAE,IAAY,EAAE,OAAkB,EAAE,EAAE;QAEtD,CAAC,CACF;QACD,sEAAsE;QACtE,gBAAgB;QAChB,KAAK;KAEN;CACF,CAAC"}

package/build/events/__mocks__/nats-wrapper.d.ts

@@ -1,6 +1,6 @@
 export declare const natsWrapper: {
     client: {
-        publish: jest.Mock<any, any, any>;
+        publish: import("vitest").Mock<(...args: any[]) => any>;
     };
 };
 //# sourceMappingURL=nats-wrapper.d.ts.map

package/build/events/__mocks__/nats-wrapper.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.natsWrapper = void 0;
+const vitest_1 = require("vitest");
 exports.natsWrapper = {
     client: {
-        publish: jest.fn().mockImplementation((subject, payload, options) => {
+        publish: vitest_1.vi.fn().mockImplementation((subject, payload, options) => {
         })
         // publish: (subject: string, data: string, callback: () => void) => {
         //   callback();

package/build/events/__mocks__/nats-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"nats-wrapper.js","sourceRoot":"","sources":["../../../src/events/__mocks__/nats-wrapper.ts"],"names":[],"mappings":";;;AAGa,QAAA,WAAW,GAAG;IAEzB,MAAM,EAAE;QAEN,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CACnC,CAAC,OAAe,EAAE,OAAe,EAAE,OAAkB,EAAE,EAAE;QAEzD,CAAC,CACF;QACD,sEAAsE;QACtE,gBAAgB;QAChB,KAAK;KAEN;CACF,CAAC"}
+{"version":3,"file":"nats-wrapper.js","sourceRoot":"","sources":["../../../src/events/__mocks__/nats-wrapper.ts"],"names":[],"mappings":";;;AAAA,mCAAiC;AAGpB,QAAA,WAAW,GAAG;IAEzB,MAAM,EAAE;QAEN,OAAO,EAAE,WAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CACjC,CAAC,OAAe,EAAE,OAAe,EAAE,OAAkB,EAAE,EAAE;QAEzD,CAAC,CACF;QACD,sEAAsE;QACtE,gBAAgB;QAChB,KAAK;KAEN;CACF,CAAC"}

package/build/utils/index.d.ts

@@ -1,3 +1,4 @@
 export * from './express';
 export * from './functs';
+export * from './start-service';
 //# sourceMappingURL=index.d.ts.map

package/build/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/build/utils/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./express"), exports);
 __exportStar(require("./functs"), exports);
+__exportStar(require("./start-service"), exports);
 //# sourceMappingURL=index.js.map

package/build/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,2CAAyB;AACzB,kDAAgC"}

package/build/utils/start-service.d.ts

@@ -0,0 +1,55 @@
+import { Router } from 'express';
+import { AppData } from '@nextage/nx-frame-be';
+/**
+ * A single ordered startup phase.
+ */
+export interface BootstrapPhase {
+    label: string;
+    run: () => Promise<void> | void;
+}
+/**
+ * A graceful-shutdown handler (invoked on SIGTERM/SIGINT/... in reverse order).
+ */
+export type ShutdownHandler = () => Promise<void> | void;
+/**
+ * Parameters for {@link startService}.
+ */
+export interface StartServiceParams {
+    /** Shared application singleton (APP). */
+    app: AppData;
+    /** Ordered phases; executed sequentially, each awaited before the next. */
+    phases: BootstrapPhase[];
+    /** Optional graceful-shutdown handlers (registered on the ShutdownManager). */
+    shutdown?: ShutdownHandler[];
+    /** Abort the process on the first failing phase. Default: `true`. */
+    failFast?: boolean;
+    /**
+     * Called on a fail-fast abort to terminate the process. Injectable for tests;
+     * defaults to `process.exit`.
+     */
+    onFatal?: (code: number) => never;
+}
+/**
+ * Orchestrates a service startup as an ordered, fail-fast phase sequence.
+ *
+ * The server should perform its `listen()` inside the LAST phase; `startService`
+ * flips `APP.status` to `AppStatus.OK` only after ALL phases have resolved, so
+ * `/readyz` (see {@link createHealthRouter}) reports "ready" only once the whole
+ * bootstrap has completed.
+ *
+ * @param params - see {@link StartServiceParams}
+ */
+export declare function startService(params: StartServiceParams): Promise<void>;
+/**
+ * Builds an Express router exposing liveness/readiness probes.
+ *
+ *   - `GET /healthz` → 200 as long as the process is up (liveness)
+ *   - `GET /readyz`  → 200 only when `APP.status === OK`, else 503 (readiness)
+ *
+ * Mount BEFORE the JWT/auth middleware so probes stay unauthenticated.
+ *
+ * @param app    - shared application singleton (APP)
+ * @param extra  - optional async readiness check (e.g. db/nats connectivity)
+ */
+export declare function createHealthRouter(app: AppData, extra?: () => Promise<boolean> | boolean): Router;
+//# sourceMappingURL=start-service.d.ts.map

package/build/utils/start-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-service.d.ts","sourceRoot":"","sources":["../../src/utils/start-service.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,MAAM,EAAE,MAAyB,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAa,MAAa,sBAAsB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAG,MAAM,CAAC;IACf,GAAG,EAAK,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,GAAG,EAAS,OAAO,CAAC;IACpB,2EAA2E;IAC3E,MAAM,EAAM,cAAc,EAAE,CAAC;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,EAAG,eAAe,EAAE,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,EAAG,OAAO,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAI,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CACrC;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,MAAM,CAsBjG"}

package/build/utils/start-service.js

@@ -0,0 +1,148 @@
+"use strict";
+/*───────────────────────────────────────────────────────────────────────────*\
+  start-service — service bootstrap orchestrator (ADR-0001)
+
+  Runs the service startup as an ORDERED, AWAITED sequence of phases instead of
+  the previous timer-based (`setTimeout`) approach. Guarantees:
+
+    - deterministic ordering (no race between module loading and server listen)
+    - fail-fast: a throwing phase aborts startup with a non-zero exit code
+    - readiness gate: APP.status flips to OK only after every phase completed
+    - graceful shutdown handlers registered on the shared ShutdownManager
+
+  Transport-agnostic: each service composes its own phases (db, messaging, http
+  wiring, module loading, listen). See docs/architecture/adr/0001-*.
+\*───────────────────────────────────────────────────────────────────────────*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startService = startService;
+exports.createHealthRouter = createHealthRouter;
+const express_1 = require("express");
+const nx_frame_be_1 = require("@nextage/nx-frame-be");
+/**
+ * Orchestrates a service startup as an ordered, fail-fast phase sequence.
+ *
+ * The server should perform its `listen()` inside the LAST phase; `startService`
+ * flips `APP.status` to `AppStatus.OK` only after ALL phases have resolved, so
+ * `/readyz` (see {@link createHealthRouter}) reports "ready" only once the whole
+ * bootstrap has completed.
+ *
+ * @param params - see {@link StartServiceParams}
+ */
+async function startService(params) {
+    const { app, phases } = params;
+    const failFast = params.failFast ?? true;
+    const logger = app.logger ?? console;
+    const onFatal = params.onFatal ?? ((code) => process.exit(code));
+    app.status = nx_frame_be_1.AppStatus.INIT;
+    logger.info(`⏳ [${app.appName}] starting service (${phases.length} phases)`);
+    for (let i = 0; i < phases.length; i++) {
+        const phase = phases[i];
+        const step = `${i + 1}/${phases.length}`;
+        try {
+            logger.info(`▶  [${app.appName}] (${step}) ${phase.label}`);
+            await phase.run();
+        }
+        catch (err) {
+            logger.error(`✖  [${app.appName}] (${step}) ${phase.label} failed: ${errMessage(err)}`);
+            if (failFast) {
+                await runShutdown(params.shutdown, logger);
+                // Non-zero exit → the orchestrator (ECS/compose) restarts the service.
+                onFatal(1);
+                return;
+            }
+            throw err;
+        }
+    }
+    // Register graceful-shutdown handlers AFTER a successful startup.
+    registerShutdown(app, params.shutdown, logger);
+    app.status = nx_frame_be_1.AppStatus.OK;
+    logger.info(`✅ [${app.appName}] service ready`);
+}
+/**
+ * Builds an Express router exposing liveness/readiness probes.
+ *
+ *   - `GET /healthz` → 200 as long as the process is up (liveness)
+ *   - `GET /readyz`  → 200 only when `APP.status === OK`, else 503 (readiness)
+ *
+ * Mount BEFORE the JWT/auth middleware so probes stay unauthenticated.
+ *
+ * @param app    - shared application singleton (APP)
+ * @param extra  - optional async readiness check (e.g. db/nats connectivity)
+ */
+function createHealthRouter(app, extra) {
+    const router = (0, express_1.Router)();
+    router.get('/healthz', (_req, res) => {
+        res.status(200).json({ status: 'up', service: app.appName });
+    });
+    router.get('/readyz', async (_req, res) => {
+        const statusReady = app.status === nx_frame_be_1.AppStatus.OK;
+        const extraReady = extra ? await safeCheck(extra) : true;
+        const ready = statusReady && extraReady;
+        res.status(ready ? 200 : 503).json({
+            status: ready ? 'ready' : 'not-ready',
+            service: app.appName
+        });
+    });
+    return router;
+}
+/*── internals ───────────────────────────────────────────────────────────────*/
+/**
+ * Registers shutdown handlers on the shared ShutdownManager (reverse order so
+ * resources are torn down opposite to how they were created).
+ */
+function registerShutdown(app, handlers, logger) {
+    if (!handlers?.length || !app.shutdownMng)
+        return;
+    for (const handler of [...handlers].reverse()) {
+        app.shutdownMng.addShutdownHandler(async () => {
+            try {
+                await handler();
+            }
+            catch (err) {
+                logger.error(`✖  [${app.appName}] shutdown handler failed: ${errMessage(err)}`);
+            }
+        });
+    }
+}
+/**
+ * Runs shutdown handlers inline (used on fail-fast, before the manager exists).
+ */
+async function runShutdown(handlers, logger) {
+    if (!handlers?.length)
+        return;
+    for (const handler of [...handlers].reverse()) {
+        try {
+            await handler();
+        }
+        catch (err) {
+            logger.error(`✖  shutdown handler failed during fail-fast: ${errMessage(err)}`);
+        }
+    }
+}
+/**
+ * Runs a readiness check, swallowing errors as "not ready".
+ */
+async function safeCheck(check) {
+    try {
+        return await check();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Normalises an unknown thrown value into a readable message.
+ */
+function errMessage(err) {
+    if (err instanceof Error)
+        return err.stack ?? err.message;
+    if (typeof err === 'string')
+        return err;
+    try {
+        return JSON.stringify(err);
+    }
+    catch {
+        return 'unknown error';
+    }
+}
+//# sourceMappingURL=start-service.js.map

package/build/utils/start-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-service.js","sourceRoot":"","sources":["../../src/utils/start-service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextage/era-lib",
-  "version": "1.0.164",
+  "version": "1.0.165",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
   "files": [
@@ -9,12 +9,18 @@
   "scripts": {
     "clean": "del ./build/*",
     "build": "npm run clean && tsc",
-    "pub": "git add . && git commit -m \"App Library updates\" && npm version patch && npm run build && npm publish"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build",
+    "release:patch": "npm version patch -m \"era-lib v%s\"",
+    "release:minor": "npm version minor -m \"era-lib v%s\"",
+    "release:major": "npm version major -m \"era-lib v%s\"",
+    "pub": "npm run build && npm publish"
   },
   "keywords": [],
-  "author": "",
+  "author": "Nextage",
   "license": "ISC",
-  "description": "",
+  "description": "ERA shared backend library (@nextage/era-lib): events, models, services, bootstrap orchestrator and utils on top of @nextage/nx-frame-be. See README.md and CHANGELOG.md.",
   "dependencies": {
     "@nextage/nx-frame-be": "^1.0.37",
     "@types/express-jwt": "^7.4.2",
@@ -47,9 +53,8 @@
     "ws": "^8.18.0"
   },
   "devDependencies": {
-    "@types/jest": "^30.0.0",
     "del-cli": "^6.0.0",
-    "jest": "^30.0.5",
-    "mongodb-memory-server": "^10.1.4"
+    "mongodb-memory-server": "^10.1.4",
+    "vitest": "^2.1.9"
   }
 }