@futdevpro/nts-dynamo 1.15.118 → 1.15.119

package/.dynamo/logs/cicd-pipeline/status.json

@@ -1,7 +1,7 @@
 {
-  "pid": 3702,
-  "startedAt": "2026-07-26T19:12:39.969Z",
-  "startedAtMs": 1785093159969,
+  "pid": 15048,
+  "startedAt": "2026-07-26T21:11:37.191Z",
+  "startedAtMs": 1785100297191,
   "phase": "npm-publish",
   "pipelineComplete": false,
   "serverRunning": false,
@@ -10,77 +10,83 @@
   "steps": {
     "validate-secrets": {
       "status": "ok",
-      "startedAt": "2026-07-26T19:12:39.998Z",
+      "startedAt": "2026-07-26T21:11:37.214Z",
       "logLineStart": 2,
       "logLineEnd": 8,
       "durationSec": 0.3
     },
     "discord-start": {
       "status": "ok",
-      "startedAt": "2026-07-26T19:12:41.267Z",
+      "startedAt": "2026-07-26T21:11:38.480Z",
       "logLineStart": 9,
       "logLineEnd": 14,
-      "durationSec": 10
+      "durationSec": 3
     },
     "pre-flight": {
       "status": "ok",
-      "startedAt": "2026-07-26T19:12:52.294Z",
+      "startedAt": "2026-07-26T21:11:42.473Z",
       "logLineStart": 15,
       "logLineEnd": 17,
-      "durationSec": 0.4
+      "durationSec": 0.2
     },
     "install": {
       "status": "ok",
-      "startedAt": "2026-07-26T19:12:54.084Z",
+      "startedAt": "2026-07-26T21:11:43.675Z",
       "logLineStart": 18,
-      "logLineEnd": 101,
-      "durationSec": 22.6
+      "logLineEnd": 104,
+      "durationSec": 25.6
     },
     "check-dev-leftovers": {
       "status": "ok",
-      "startedAt": "2026-07-26T19:13:17.671Z",
-      "logLineStart": 102,
-      "logLineEnd": 109,
-      "durationSec": 6.9
+      "startedAt": "2026-07-26T21:12:10.230Z",
+      "logLineStart": 105,
+      "logLineEnd": 112,
+      "durationSec": 4.4
     },
     "build": {
       "status": "ok",
-      "startedAt": "2026-07-26T19:13:25.768Z",
-      "logLineStart": 110,
-      "logLineEnd": 111,
-      "durationSec": 31.1
+      "startedAt": "2026-07-26T21:12:15.627Z",
+      "logLineStart": 113,
+      "logLineEnd": 114,
+      "durationSec": 27.8
     },
     "test": {
       "status": "ok",
-      "startedAt": "2026-07-26T19:13:57.906Z",
-      "logLineStart": 112,
-      "logLineEnd": 2802,
-      "durationSec": 23.4,
+      "startedAt": "2026-07-26T21:12:44.425Z",
+      "logLineStart": 115,
+      "logLineEnd": 2839,
+      "durationSec": 20.3,
       "testSummary": {
-        "totalSpecs": 1588,
+        "totalSpecs": 1593,
         "failures": 0,
-        "passed": 1588,
-        "testDurationSec": 7.319
+        "passed": 1593,
+        "testDurationSec": 6.601
       },
       "errors": [
         {
-          "line": 1068,
+          "line": 386,
+          "text": "......................................(checkDbReadiness) diagnostics collection failed (non-fatal) Error: diag boom",
+          "details": ".Authentication Service missing!\n.Authentication Service missing!\n.Authentication Service missing!\nat Object.get host [as host] (/tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/build/_modules/server/server-status/server-status.control-service.spec.js:487:36)\nat TestServerStatusControlService.checkDbReadiness (/tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/build/_modules/server/server-status/server-status.control-service.js:177:29)\nat processTicksAndRejections (node:internal/process/task_queues:95:5)\nat async UserContext.<anonymous> (/tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/build/_modules/server/server-status/server-status.control-service.spec.js:490:28)",
+          "detailLineEnd": 390
+        },
+        {
+          "line": 399,
           "text": "(checkDbReadiness) diagnostics collection failed (non-fatal) Error: boom",
-          "details": "at runNext (/tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8355:16)\nat /tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8361:11\nat /tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8241:9\nat UserContext.<anonymous> (/tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/build/_modules/server/server-status/server-status.control-service.spec.js:507:68)\nat QueueRunner.attempt (/tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8414:40)\nat QueueRunner.run (/tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8452:27)\nat runNext (/tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8355:16)\nat /tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8361:11\nat /tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8241:9",
-          "detailLineEnd": 1074
+          "details": "at /tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8361:11\nat /tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8241:9\nat processTicksAndRejections (node:internal/process/task_queues:95:5)\nat UserContext.<anonymous> (/tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/build/_modules/server/server-status/server-status.control-service.spec.js:507:68)\nat QueueRunner.attempt (/tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8414:40)\nat QueueRunner.run (/tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8452:27)\nat runNext (/tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8355:16)\nat /tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8361:11\nat /tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8241:9\nat processTicksAndRejections (node:internal/process/task_queues:95:5)",
+          "detailLineEnd": 406
         },
         {
-          "line": 1084,
-          "text": ".....(checkDbReadiness) diagnostics collection failed (non-fatal) Error: diag boom",
-          "details": "at runNext (/tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8355:16)\nat /tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8361:11\nat /tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8241:9\nat Object.get host [as host] (/tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/build/_modules/server/server-status/server-status.control-service.spec.js:487:36)\nat TestServerStatusControlService.checkDbReadiness (/tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/build/_modules/server/server-status/server-status.control-service.js:177:29)\nat async UserContext.<anonymous> (/tmp/pipeline-runs/955768d5-beca-48b1-97ac-8dace53081bd/build/_modules/server/server-status/server-status.control-service.spec.js:490:28)",
-          "detailLineEnd": 1087
+          "line": 2056,
+          "text": "[dynts-migration] FAILED bad Error: boom",
+          "details": "at Object.run (/tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/build/_services/core/migration-runner.service.spec.js:67:50)\nat DyNTS_Migration_Runner.runPending (/tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/build/_services/core/migration-runner.service.js:52:49)\nat async UserContext.<anonymous> (/tmp/pipeline-runs/a686f4ed-5884-4898-92e6-77674803c205/build/_services/core/migration-runner.service.spec.js:70:25)",
+          "detailLineEnd": 2059
         }
       ]
     },
     "npm-publish": {
       "status": "running",
-      "startedAt": "2026-07-26T19:14:22.317Z",
-      "logLineStart": 2803,
+      "startedAt": "2026-07-26T21:13:05.802Z",
+      "logLineStart": 2840,
       "logLineEnd": null,
       "durationSec": null
     }

package/build/_models/data-models/schema-migration.data-model.d.ts

@@ -0,0 +1,29 @@
+import { DyFM_DataModel_Params, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
+/**
+ * **Migráció-nyilvántartó ("server info") LEDGER** — bedrock, újrahasználható az egész flottának.
+ * (A token-service app-lokál `SchemaMigration` mintájából emelve bedrock nts-be.)
+ *
+ * Egy-egy `migrationId` **PONTOSAN EGYSZER** fut le rendszerenként: a `DyNTS_Migration_Runner.runPending()`
+ * boot-on (az app `app.server.postProcess()`-éből) lekéri a már-alkalmazott ID-kat, a pending
+ * migrációkat lefuttatja, majd egy sort rögzít ide. A `migrationId` **unique index** → race-safe
+ * (két párhuzamos instance esetén az egyik `save`-je duplicate-key-re bukik → skip).
+ *
+ * A ledger a KÖTELEZŐ kanon-adatokat tartja: **mely migrációk futottak** (id + idő) + **mely app-verzió**
+ * alkalmazta (a `appliedVersion`-ökből a "mely verziók futottak" levezethető).
+ *
+ * Az app a saját DB-jében regisztrálja a `dyNTS_schemaMigration_dataParams`-t (`getGlobalServiceCollection
+ * ().dbModels`), így per-app saját `dynts_schema_migrations` collection-t kap.
+ */
+export declare class DyNTS_SchemaMigration extends DyFM_Metadata {
+    /** A migráció egyedi azonosítója (konvenció: `YYYY-MM-DD-NNN-descriptor`). */
+    migrationId?: string;
+    /** Alkalmazás időbélyege. */
+    appliedAt?: Date;
+    /** Az alkalmazó app-verzió (a `package.json` version-je — audit-trail + "mely verziók futottak"). */
+    appliedVersion?: string;
+    /** Diag — pl. `touched=<n>` vagy hiba-részletek. */
+    notes?: string;
+    constructor(set?: DyNTS_SchemaMigration);
+}
+export declare const dyNTS_schemaMigration_dataParams: DyFM_DataModel_Params<DyNTS_SchemaMigration>;
+//# sourceMappingURL=schema-migration.data-model.d.ts.map

package/build/_models/data-models/schema-migration.data-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-migration.data-model.d.ts","sourceRoot":"","sources":["../../../src/_models/data-models/schema-migration.data-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE7E;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IAEtD,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,qGAAqG;IACrG,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEH,GAAG,CAAC,EAAE,qBAAqB;CAMxC;AAED,eAAO,MAAM,gCAAgC,EAAE,qBAAqB,CAAC,qBAAqB,CAUtF,CAAC"}

package/build/_models/data-models/schema-migration.data-model.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dyNTS_schemaMigration_dataParams = exports.DyNTS_SchemaMigration = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * **Migráció-nyilvántartó ("server info") LEDGER** — bedrock, újrahasználható az egész flottának.
+ * (A token-service app-lokál `SchemaMigration` mintájából emelve bedrock nts-be.)
+ *
+ * Egy-egy `migrationId` **PONTOSAN EGYSZER** fut le rendszerenként: a `DyNTS_Migration_Runner.runPending()`
+ * boot-on (az app `app.server.postProcess()`-éből) lekéri a már-alkalmazott ID-kat, a pending
+ * migrációkat lefuttatja, majd egy sort rögzít ide. A `migrationId` **unique index** → race-safe
+ * (két párhuzamos instance esetén az egyik `save`-je duplicate-key-re bukik → skip).
+ *
+ * A ledger a KÖTELEZŐ kanon-adatokat tartja: **mely migrációk futottak** (id + idő) + **mely app-verzió**
+ * alkalmazta (a `appliedVersion`-ökből a "mely verziók futottak" levezethető).
+ *
+ * Az app a saját DB-jében regisztrálja a `dyNTS_schemaMigration_dataParams`-t (`getGlobalServiceCollection
+ * ().dbModels`), így per-app saját `dynts_schema_migrations` collection-t kap.
+ */
+class DyNTS_SchemaMigration extends fsm_dynamo_1.DyFM_Metadata {
+    /** A migráció egyedi azonosítója (konvenció: `YYYY-MM-DD-NNN-descriptor`). */
+    migrationId;
+    /** Alkalmazás időbélyege. */
+    appliedAt;
+    /** Az alkalmazó app-verzió (a `package.json` version-je — audit-trail + "mely verziók futottak"). */
+    appliedVersion;
+    /** Diag — pl. `touched=<n>` vagy hiba-részletek. */
+    notes;
+    constructor(set) {
+        super(set);
+        if (set) {
+            Object.assign(this, set);
+        }
+    }
+}
+exports.DyNTS_SchemaMigration = DyNTS_SchemaMigration;
+exports.dyNTS_schemaMigration_dataParams = new fsm_dynamo_1.DyFM_DataModel_Params({
+    dataName: 'dynts_schema_migrations',
+    addArchive: false,
+    properties: {
+        migrationId: { type: 'string', required: true, unique: true, index: true },
+        appliedAt: { type: 'date', required: true },
+        appliedVersion: { type: 'string' },
+        notes: { type: 'string' },
+    },
+});
+//# sourceMappingURL=schema-migration.data-model.js.map

package/build/_models/data-models/schema-migration.data-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-migration.data-model.js","sourceRoot":"","sources":["../../../src/_models/data-models/schema-migration.data-model.ts"],"names":[],"mappings":";;;AAAA,sDAA6E;AAE7E;;;;;;;;;;;;;;GAcG;AACH,MAAa,qBAAsB,SAAQ,0BAAa;IAEtD,8EAA8E;IAC9E,WAAW,CAAU;IAErB,6BAA6B;IAC7B,SAAS,CAAQ;IAEjB,qGAAqG;IACrG,cAAc,CAAU;IAExB,oDAAoD;IACpD,KAAK,CAAU;IAEf,YAAY,GAA2B;QACrC,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AApBD,sDAoBC;AAEY,QAAA,gCAAgC,GAC3C,IAAI,kCAAqB,CAAwB;IAC/C,QAAQ,EAAE,yBAAyB;IACnC,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE;QACV,WAAW,EAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;QAC7E,SAAS,EAAO,EAAE,IAAI,EAAE,MAAM,EAAI,QAAQ,EAAE,IAAI,EAAE;QAClD,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClC,KAAK,EAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;KACnC;CACF,CAAC,CAAC"}

package/build/_models/interfaces/migration-entry.interface.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Egy regisztrált deploy-integrált migráció leírója. Az app egy `DyNTS_MigrationEntry[]` registry-t
+ * ad át a `DyNTS_Migration_Runner.runPending(...)`-nek; a runner a pending (még nem alkalmazott)
+ * entry-ket **egyszer** futtatja le, sorrendben, majd a `DyNTS_SchemaMigration` ledgerbe rögzíti.
+ */
+export interface DyNTS_MigrationEntry {
+    /** Egyedi, monoton bővíthető ID (konvenció: `YYYY-MM-DD-NNN-descriptor`). A ledger ez alapján run-once-ol. */
+    id: string;
+    /** Rövid leíró (admin/debug/log). */
+    description: string;
+    /**
+     * A tényleges migráció-logika. Az app már-csatlakozott Mongo-kapcsolatát használja (a runner a
+     * `postProcess`-ből fut, ahol a DB már él). Hibára DOBHAT — a runner catch-eli, a `notes`-ba menti,
+     * és NEM állítja meg a boot-ot. Visszaad: `{ touched }` (a módosított dokumentumok száma — count/riport).
+     */
+    run: (issuer: string) => Promise<{
+        touched: number;
+    }>;
+}
+//# sourceMappingURL=migration-entry.interface.d.ts.map

package/build/_models/interfaces/migration-entry.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-entry.interface.d.ts","sourceRoot":"","sources":["../../../src/_models/interfaces/migration-entry.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,8GAA8G;IAC9G,EAAE,EAAE,MAAM,CAAC;IAEX,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD"}

package/build/_models/interfaces/migration-entry.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=migration-entry.interface.js.map

package/build/_models/interfaces/migration-entry.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-entry.interface.js","sourceRoot":"","sources":["../../../src/_models/interfaces/migration-entry.interface.ts"],"names":[],"mappings":""}

package/build/_services/core/migration-runner.service.d.ts

@@ -0,0 +1,40 @@
+import { DyNTS_SingletonService } from '../base/singleton.service';
+import { DyNTS_DataService } from '../base/data.service';
+import { DyNTS_SchemaMigration } from '../../_models/data-models/schema-migration.data-model';
+import { DyNTS_MigrationEntry } from '../../_models/interfaces/migration-entry.interface';
+/** A `runPending` összesítő eredménye. */
+export interface DyNTS_MigrationRunResult {
+    applied: number;
+    skipped: number;
+    failed: number;
+}
+/**
+ * **Deploy-integrált migráció-futtató** — bedrock, újrahasználható. Az app a `app.server.postProcess()`-
+ * ből hívja: `DyNTS_Migration_Runner.getInstance().runPending(ALL_MIGRATIONS, appVersion)`.
+ *
+ * Mechanizmus (kanon `deploy-integrated-migrations.md`):
+ *  - Boot-on lekéri a `DyNTS_SchemaMigration` ledgerből a MÁR-alkalmazott `migrationId`-kat.
+ *  - A **pending** (még nem alkalmazott) entry-ket **sorrendben, egyszer** lefuttatja.
+ *  - Mindegyik után egy ledger-sort rögzít (`migrationId` + `appliedAt` + `appliedVersion` + `notes`).
+ *  - **RUN-ONCE:** a `migrationId` unique-index → re-boot / párhuzamos instance esetén skip (duplicate-key).
+ *  - **Boot-safe:** egy hibás migráció NEM állítja meg a boot-ot (catch + notes; a runner tovább megy).
+ */
+export declare class DyNTS_Migration_Runner extends DyNTS_SingletonService {
+    static getInstance(): DyNTS_Migration_Runner;
+    /**
+     * TISZTA pending-szelekció (DB nélkül tesztelhető): azok az entry-k, amiknek az `id`-ja NINCS az
+     * `appliedIds`-ban. A regisztráció sorrendje megőrződik (a bővítés a tömb VÉGÉRE).
+     */
+    static selectPending(migrations: DyNTS_MigrationEntry[], appliedIds: Set<string>): DyNTS_MigrationEntry[];
+    /** A ledger-DataService előállítása. `protected` → a spec felül tudja írni (mock-hoz). */
+    protected createLedgerDataService(issuer: string): DyNTS_DataService<DyNTS_SchemaMigration>;
+    /**
+     * A pending migrációk lefuttatása + rögzítése.
+     *
+     * @param migrations - az app registry-je (`DyNTS_MigrationEntry[]`)
+     * @param appVersion - az app aktuális verziója (a ledger `appliedVersion`-jébe)
+     * @param issuer - opcionális issuer-cimke (default `DyNTS_Migration_Runner`)
+     */
+    runPending(migrations: DyNTS_MigrationEntry[], appVersion: string, issuer?: string): Promise<DyNTS_MigrationRunResult>;
+}
+//# sourceMappingURL=migration-runner.service.d.ts.map

package/build/_services/core/migration-runner.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-runner.service.d.ts","sourceRoot":"","sources":["../../../src/_services/core/migration-runner.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,qBAAqB,EACtB,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAE1F,0CAA0C;AAC1C,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,sBAAuB,SAAQ,sBAAsB;IAEhE,MAAM,CAAC,WAAW,IAAI,sBAAsB;IAI5C;;;OAGG;IACH,MAAM,CAAC,aAAa,CAClB,UAAU,EAAE,oBAAoB,EAAE,EAClC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,oBAAoB,EAAE;IAIzB,0FAA0F;IAC1F,SAAS,CAAC,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAC,qBAAqB,CAAC;IAQ3F;;;;;;OAMG;IACG,UAAU,CACd,UAAU,EAAE,oBAAoB,EAAE,EAClC,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAiC,GACxC,OAAO,CAAC,wBAAwB,CAAC;CAyCrC"}

package/build/_services/core/migration-runner.service.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Migration_Runner = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const singleton_service_1 = require("../base/singleton.service");
+const data_service_1 = require("../base/data.service");
+const schema_migration_data_model_1 = require("../../_models/data-models/schema-migration.data-model");
+/**
+ * **Deploy-integrált migráció-futtató** — bedrock, újrahasználható. Az app a `app.server.postProcess()`-
+ * ből hívja: `DyNTS_Migration_Runner.getInstance().runPending(ALL_MIGRATIONS, appVersion)`.
+ *
+ * Mechanizmus (kanon `deploy-integrated-migrations.md`):
+ *  - Boot-on lekéri a `DyNTS_SchemaMigration` ledgerből a MÁR-alkalmazott `migrationId`-kat.
+ *  - A **pending** (még nem alkalmazott) entry-ket **sorrendben, egyszer** lefuttatja.
+ *  - Mindegyik után egy ledger-sort rögzít (`migrationId` + `appliedAt` + `appliedVersion` + `notes`).
+ *  - **RUN-ONCE:** a `migrationId` unique-index → re-boot / párhuzamos instance esetén skip (duplicate-key).
+ *  - **Boot-safe:** egy hibás migráció NEM állítja meg a boot-ot (catch + notes; a runner tovább megy).
+ */
+class DyNTS_Migration_Runner extends singleton_service_1.DyNTS_SingletonService {
+    static getInstance() {
+        return DyNTS_Migration_Runner.getSingletonInstance();
+    }
+    /**
+     * TISZTA pending-szelekció (DB nélkül tesztelhető): azok az entry-k, amiknek az `id`-ja NINCS az
+     * `appliedIds`-ban. A regisztráció sorrendje megőrződik (a bővítés a tömb VÉGÉRE).
+     */
+    static selectPending(migrations, appliedIds) {
+        return (migrations ?? []).filter((migration) => !appliedIds.has(migration.id));
+    }
+    /** A ledger-DataService előállítása. `protected` → a spec felül tudja írni (mock-hoz). */
+    createLedgerDataService(issuer) {
+        return new data_service_1.DyNTS_DataService(new schema_migration_data_model_1.DyNTS_SchemaMigration(), schema_migration_data_model_1.dyNTS_schemaMigration_dataParams, issuer);
+    }
+    /**
+     * A pending migrációk lefuttatása + rögzítése.
+     *
+     * @param migrations - az app registry-je (`DyNTS_MigrationEntry[]`)
+     * @param appVersion - az app aktuális verziója (a ledger `appliedVersion`-jébe)
+     * @param issuer - opcionális issuer-cimke (default `DyNTS_Migration_Runner`)
+     */
+    async runPending(migrations, appVersion, issuer = 'DyNTS_Migration_Runner') {
+        const result = { applied: 0, skipped: 0, failed: 0 };
+        fsm_dynamo_1.DyFM_Log.info(`[dynts-migration] sweep start — ${migrations?.length ?? 0} migration(s) registered · appVersion=${appVersion}`);
+        const ledger_DS = this.createLedgerDataService(issuer);
+        const applied = await ledger_DS.dataDBService.find({});
+        const appliedIds = new Set(applied.map((record) => record.migrationId ?? ''));
+        const pending = DyNTS_Migration_Runner.selectPending(migrations, appliedIds);
+        result.skipped = (migrations?.length ?? 0) - pending.length;
+        for (const migration of pending) {
+            try {
+                fsm_dynamo_1.DyFM_Log.info(`[dynts-migration] applying ${migration.id} — ${migration.description}`);
+                const outcome = await migration.run(issuer);
+                // Atomikus claim — a unique-index dob duplicate-ra (race-safe, két párhuzamos instance).
+                ledger_DS.data = new schema_migration_data_model_1.DyNTS_SchemaMigration({
+                    migrationId: migration.id,
+                    appliedAt: new Date(),
+                    appliedVersion: appVersion,
+                    notes: `touched=${outcome?.touched ?? 0}`,
+                });
+                await ledger_DS.saveData();
+                fsm_dynamo_1.DyFM_Log.success(`[dynts-migration] applied ${migration.id} (touched=${outcome?.touched ?? 0})`);
+                result.applied++;
+            }
+            catch (error) {
+                // Egy hibás migráció NEM állíthatja meg a boot-ot (catch + log; a következő entry mehet).
+                fsm_dynamo_1.DyFM_Error.logSimple(`[dynts-migration] FAILED ${migration.id}`, error);
+                result.failed++;
+            }
+        }
+        fsm_dynamo_1.DyFM_Log.info(`[dynts-migration] sweep done — applied=${result.applied} skipped=${result.skipped} failed=${result.failed}`);
+        return result;
+    }
+}
+exports.DyNTS_Migration_Runner = DyNTS_Migration_Runner;
+//# sourceMappingURL=migration-runner.service.js.map

package/build/_services/core/migration-runner.service.js.map

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

package/build/index.d.ts

@@ -19,6 +19,7 @@ export * from './_models/interfaces/static-client-settings.interface';
 export * from './_models/interfaces/cors-settings.interface';
 export * from './_models/interfaces/security-headers-settings.interface';
 export * from './_models/interfaces/db-query-options.interface';
+export * from './_models/interfaces/migration-entry.interface';
 export * from './_collections/security-headers.util';
 export * from './_collections/client-safe-error.util';
 export * from './_collections/load-shed.util';
@@ -31,6 +32,7 @@ export * from './_models/control-models/endpoint-params.control-model';
 export * from './_models/control-models/http-settings.control-model';
 export * from './_models/control-models/system-control.control-model';
 export * from './_models/types/db-update.type';
+export * from './_models/data-models/schema-migration.data-model';
 export * from './_services/core/api.service';
 export * from './_services/core/auth.service';
 export * from './_services/core/email.service';
@@ -38,6 +40,7 @@ export * from './_services/core/collection-growth-monitor.service';
 export * from './_services/core/global.service';
 export * from './_services/core/memory-guard.service';
 export * from './_services/core/service-collection.service';
+export * from './_services/core/migration-runner.service';
 export * from './_services/base/api.service-base';
 export * from './_services/base/archive-data.service';
 export * from './_services/base/data.service';

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,0CAA0C,CAAC;AACzD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,sCAAsC,CAAC;AAIrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAK7C,mEAAmE;AACnE,cAAc,uDAAuD,CAAC;AACtE,cAAc,qDAAqD,CAAC;AACpE,cAAc,wDAAwD,CAAC;AACvE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,wDAAwD,CAAC;AACvE,cAAc,uDAAuD,CAAC;AACtE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,iDAAiD,CAAC;AAChE,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AAGzD,cAAc,wDAAwD,CAAC;AACvE,cAAc,gEAAgE,CAAA;AAC9E,cAAc,mDAAmD,CAAC;AAClE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,wDAAwD,CAAC;AACvE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AAGtE,cAAc,gCAAgC,CAAC;AAK/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oDAAoD,CAAC;AACnE,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6CAA6C,CAAC;AAG5D,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yCAAyC,CAAC;AACxD,cAAc,oCAAoC,CAAC;AAGnD,cAAc,+BAA+B,CAAC;AAG9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AAGzD,cAAc,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,0CAA0C,CAAC;AACzD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,sCAAsC,CAAC;AAIrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAK7C,mEAAmE;AACnE,cAAc,uDAAuD,CAAC;AACtE,cAAc,qDAAqD,CAAC;AACpE,cAAc,wDAAwD,CAAC;AACvE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,wDAAwD,CAAC;AACvE,cAAc,uDAAuD,CAAC;AACtE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,iDAAiD,CAAC;AAChE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AAGzD,cAAc,wDAAwD,CAAC;AACvE,cAAc,gEAAgE,CAAA;AAC9E,cAAc,mDAAmD,CAAC;AAClE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,wDAAwD,CAAC;AACvE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AAGtE,cAAc,gCAAgC,CAAC;AAG/C,cAAc,mDAAmD,CAAC;AAKlE,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oDAAoD,CAAC;AACnE,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,2CAA2C,CAAC;AAG1D,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yCAAyC,CAAC;AACxD,cAAc,oCAAoC,CAAC;AAGnD,cAAc,+BAA+B,CAAC;AAG9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AAGzD,cAAc,mCAAmC,CAAC"}

package/build/index.js

@@ -48,6 +48,7 @@ tslib_1.__exportStar(require("./_models/interfaces/static-client-settings.interf
 tslib_1.__exportStar(require("./_models/interfaces/cors-settings.interface"), exports);
 tslib_1.__exportStar(require("./_models/interfaces/security-headers-settings.interface"), exports);
 tslib_1.__exportStar(require("./_models/interfaces/db-query-options.interface"), exports);
+tslib_1.__exportStar(require("./_models/interfaces/migration-entry.interface"), exports);
 tslib_1.__exportStar(require("./_collections/security-headers.util"), exports);
 tslib_1.__exportStar(require("./_collections/client-safe-error.util"), exports);
 tslib_1.__exportStar(require("./_collections/load-shed.util"), exports);
@@ -62,6 +63,8 @@ tslib_1.__exportStar(require("./_models/control-models/http-settings.control-mod
 tslib_1.__exportStar(require("./_models/control-models/system-control.control-model"), exports);
 // models/TYPES
 tslib_1.__exportStar(require("./_models/types/db-update.type"), exports);
+// models/DATA-MODELS
+tslib_1.__exportStar(require("./_models/data-models/schema-migration.data-model"), exports);
 // SERVICES
 // services/CORE
 tslib_1.__exportStar(require("./_services/core/api.service"), exports);
@@ -71,6 +74,7 @@ tslib_1.__exportStar(require("./_services/core/collection-growth-monitor.service
 tslib_1.__exportStar(require("./_services/core/global.service"), exports);
 tslib_1.__exportStar(require("./_services/core/memory-guard.service"), exports);
 tslib_1.__exportStar(require("./_services/core/service-collection.service"), exports);
+tslib_1.__exportStar(require("./_services/core/migration-runner.service"), exports);
 // services/BASE
 tslib_1.__exportStar(require("./_services/base/api.service-base"), exports);
 tslib_1.__exportStar(require("./_services/base/archive-data.service"), exports);

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;IAsBI;;;AAEJ,cAAc;AACd,sEAA4C;AAC5C,wFAA8D;AAC9D,8FAAoE;AACpE,sFAA4D;AAC5D,mFAAyD;AACzD,uFAA6D;AAC7D,+EAAqD;AAGrD,QAAQ;AACR,wEAA8C;AAC9C,8EAAoD;AACpD,8EAAoD;AACpD,uEAA6C;AAG7C,6CAA6C;AAE7C,mEAAmE;AACnE,gGAAsE;AACtE,8FAAoE;AACpE,iGAAuE;AACvE,yFAA+D;AAC/D,iGAAuE;AACvE,gGAAsE;AACtE,uFAA6D;AAC7D,mGAAyE;AACzE,0FAAgE;AAChE,+EAAqD;AACrD,gFAAsD;AACtD,wEAA8C;AAC9C,mFAAyD;AAEzD,wBAAwB;AACxB,iGAAuE;AACvE,yGAA8E;AAC9E,4FAAkE;AAClE,qGAA2E;AAC3E,iGAAuE;AACvE,+FAAqE;AACrE,gGAAsE;AAEtE,eAAe;AACf,yEAA+C;AAG/C,WAAW;AACX,gBAAgB;AAChB,uEAA6C;AAC7C,wEAA8C;AAE9C,yEAA+C;AAC/C,6FAAmE;AACnE,0EAAgD;AAChD,gFAAsD;AAEtD,sFAA4D;AAE5D,gBAAgB;AAChB,4EAAkD;AAClD,gFAAsD;AACtD,wEAA8C;AAC9C,sEAA4C;AAC5C,kFAAwD;AACxD,6EAAmD;AAEnD,kBAAkB;AAClB,wEAA8C;AAE9C,iBAAiB;AACjB,+EAAqD;AACrD,mFAAyD;AAEzD,kBAAkB;AAClB,4EAAkD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;IAsBI;;;AAEJ,cAAc;AACd,sEAA4C;AAC5C,wFAA8D;AAC9D,8FAAoE;AACpE,sFAA4D;AAC5D,mFAAyD;AACzD,uFAA6D;AAC7D,+EAAqD;AAGrD,QAAQ;AACR,wEAA8C;AAC9C,8EAAoD;AACpD,8EAAoD;AACpD,uEAA6C;AAG7C,6CAA6C;AAE7C,mEAAmE;AACnE,gGAAsE;AACtE,8FAAoE;AACpE,iGAAuE;AACvE,yFAA+D;AAC/D,iGAAuE;AACvE,gGAAsE;AACtE,uFAA6D;AAC7D,mGAAyE;AACzE,0FAAgE;AAChE,yFAA+D;AAC/D,+EAAqD;AACrD,gFAAsD;AACtD,wEAA8C;AAC9C,mFAAyD;AAEzD,wBAAwB;AACxB,iGAAuE;AACvE,yGAA8E;AAC9E,4FAAkE;AAClE,qGAA2E;AAC3E,iGAAuE;AACvE,+FAAqE;AACrE,gGAAsE;AAEtE,eAAe;AACf,yEAA+C;AAE/C,qBAAqB;AACrB,4FAAkE;AAGlE,WAAW;AACX,gBAAgB;AAChB,uEAA6C;AAC7C,wEAA8C;AAE9C,yEAA+C;AAC/C,6FAAmE;AACnE,0EAAgD;AAChD,gFAAsD;AAEtD,sFAA4D;AAC5D,oFAA0D;AAE1D,gBAAgB;AAChB,4EAAkD;AAClD,gFAAsD;AACtD,wEAA8C;AAC9C,sEAA4C;AAC5C,kFAAwD;AACxD,6EAAmD;AAEnD,kBAAkB;AAClB,wEAA8C;AAE9C,iBAAiB;AACjB,+EAAqD;AACrD,mFAAyD;AAEzD,kBAAkB;AAClB,4EAAkD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.118",
+  "version": "01.15.119",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",

package/src/_models/data-models/schema-migration.data-model.ts

@@ -0,0 +1,50 @@
+import { DyFM_DataModel_Params, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
+
+/**
+ * **Migráció-nyilvántartó ("server info") LEDGER** — bedrock, újrahasználható az egész flottának.
+ * (A token-service app-lokál `SchemaMigration` mintájából emelve bedrock nts-be.)
+ *
+ * Egy-egy `migrationId` **PONTOSAN EGYSZER** fut le rendszerenként: a `DyNTS_Migration_Runner.runPending()`
+ * boot-on (az app `app.server.postProcess()`-éből) lekéri a már-alkalmazott ID-kat, a pending
+ * migrációkat lefuttatja, majd egy sort rögzít ide. A `migrationId` **unique index** → race-safe
+ * (két párhuzamos instance esetén az egyik `save`-je duplicate-key-re bukik → skip).
+ *
+ * A ledger a KÖTELEZŐ kanon-adatokat tartja: **mely migrációk futottak** (id + idő) + **mely app-verzió**
+ * alkalmazta (a `appliedVersion`-ökből a "mely verziók futottak" levezethető).
+ *
+ * Az app a saját DB-jében regisztrálja a `dyNTS_schemaMigration_dataParams`-t (`getGlobalServiceCollection
+ * ().dbModels`), így per-app saját `dynts_schema_migrations` collection-t kap.
+ */
+export class DyNTS_SchemaMigration extends DyFM_Metadata {
+
+  /** A migráció egyedi azonosítója (konvenció: `YYYY-MM-DD-NNN-descriptor`). */
+  migrationId?: string;
+
+  /** Alkalmazás időbélyege. */
+  appliedAt?: Date;
+
+  /** Az alkalmazó app-verzió (a `package.json` version-je — audit-trail + "mely verziók futottak"). */
+  appliedVersion?: string;
+
+  /** Diag — pl. `touched=<n>` vagy hiba-részletek. */
+  notes?: string;
+
+  constructor(set?: DyNTS_SchemaMigration) {
+    super(set);
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}
+
+export const dyNTS_schemaMigration_dataParams: DyFM_DataModel_Params<DyNTS_SchemaMigration> =
+  new DyFM_DataModel_Params<DyNTS_SchemaMigration>({
+    dataName: 'dynts_schema_migrations',
+    addArchive: false,
+    properties: {
+      migrationId:    { type: 'string', required: true, unique: true, index: true },
+      appliedAt:      { type: 'date',   required: true },
+      appliedVersion: { type: 'string' },
+      notes:          { type: 'string' },
+    },
+  });

package/src/_models/interfaces/migration-entry.interface.ts

@@ -0,0 +1,19 @@
+/**
+ * Egy regisztrált deploy-integrált migráció leírója. Az app egy `DyNTS_MigrationEntry[]` registry-t
+ * ad át a `DyNTS_Migration_Runner.runPending(...)`-nek; a runner a pending (még nem alkalmazott)
+ * entry-ket **egyszer** futtatja le, sorrendben, majd a `DyNTS_SchemaMigration` ledgerbe rögzíti.
+ */
+export interface DyNTS_MigrationEntry {
+  /** Egyedi, monoton bővíthető ID (konvenció: `YYYY-MM-DD-NNN-descriptor`). A ledger ez alapján run-once-ol. */
+  id: string;
+
+  /** Rövid leíró (admin/debug/log). */
+  description: string;
+
+  /**
+   * A tényleges migráció-logika. Az app már-csatlakozott Mongo-kapcsolatát használja (a runner a
+   * `postProcess`-ből fut, ahol a DB már él). Hibára DOBHAT — a runner catch-eli, a `notes`-ba menti,
+   * és NEM állítja meg a boot-ot. Visszaad: `{ touched }` (a módosított dokumentumok száma — count/riport).
+   */
+  run: (issuer: string) => Promise<{ touched: number }>;
+}

package/src/_services/core/migration-runner.service.spec.ts

@@ -0,0 +1,91 @@
+import { DyNTS_Migration_Runner } from './migration-runner.service';
+import { DyNTS_SchemaMigration } from '../../_models/data-models/schema-migration.data-model';
+import { DyNTS_MigrationEntry } from '../../_models/interfaces/migration-entry.interface';
+
+function entry(id: string, run: () => Promise<{ touched: number }>): DyNTS_MigrationEntry {
+  return { id: id, description: id, run: run };
+}
+
+describe('| DyNTS_Migration_Runner', () => {
+
+  describe('| selectPending (pure)', () => {
+    it('| kiszűri a már-alkalmazottakat, megőrzi a sorrendet', () => {
+      const migs: DyNTS_MigrationEntry[] = [
+        entry('a', async () => ({ touched: 0 })),
+        entry('b', async () => ({ touched: 0 })),
+        entry('c', async () => ({ touched: 0 })),
+      ];
+      const pending: DyNTS_MigrationEntry[] = DyNTS_Migration_Runner.selectPending(migs, new Set([ 'b' ]));
+      expect(pending.map((m) => m.id)).toEqual([ 'a', 'c' ]);
+    });
+
+    it('| mind alkalmazva → üres; üres registry → üres', () => {
+      const migs: DyNTS_MigrationEntry[] = [ entry('a', async () => ({ touched: 0 })) ];
+      expect(DyNTS_Migration_Runner.selectPending(migs, new Set([ 'a' ])).length).toBe(0);
+      expect(DyNTS_Migration_Runner.selectPending([], new Set()).length).toBe(0);
+    });
+  });
+
+  describe('| runPending (mock ledger)', () => {
+    let runner: DyNTS_Migration_Runner;
+    let saved: DyNTS_SchemaMigration[];
+    let appliedRecords: DyNTS_SchemaMigration[];
+
+    beforeEach(() => {
+      runner = DyNTS_Migration_Runner.getInstance();
+      saved = [];
+      appliedRecords = [];
+
+      const fakeLedger: any = { // ccap-review-disable-line no-any-type
+        dataDBService: { find: async (): Promise<DyNTS_SchemaMigration[]> => appliedRecords },
+        data: null,
+        saveData: async function (): Promise<void> { saved.push(this.data); appliedRecords.push(this.data); },
+      };
+
+      spyOn(runner as any, 'createLedgerDataService').and.returnValue(fakeLedger); // ccap-review-disable-line no-any-type
+    });
+
+    it('| a pending-et futtatja + rögzíti (id+version+touched), a már-alkalmazottat SKIP-eli', async () => {
+      appliedRecords.push(new DyNTS_SchemaMigration({ migrationId: 'm1' }));
+      const ran: string[] = [];
+
+      const migs: DyNTS_MigrationEntry[] = [
+        entry('m1', async () => { ran.push('m1'); return { touched: 1 }; }),
+        entry('m2', async () => { ran.push('m2'); return { touched: 5 }; }),
+      ];
+
+      const res = await runner.runPending(migs, '1.0.0');
+
+      expect(ran).toEqual([ 'm2' ]);          // m1 skip (már applied), m2 fut
+      expect(res.applied).toBe(1);
+      expect(res.skipped).toBe(1);
+      expect(saved[0].migrationId).toBe('m2');
+      expect(saved[0].appliedVersion).toBe('1.0.0');
+      expect(saved[0].notes).toBe('touched=5');
+    });
+
+    it('| RUN-ONCE: második sweep-en (m2 már a ledgerben) semmi nem fut', async () => {
+      appliedRecords.push(new DyNTS_SchemaMigration({ migrationId: 'm2' }));
+      const ran: string[] = [];
+      const migs: DyNTS_MigrationEntry[] = [ entry('m2', async () => { ran.push('m2'); return { touched: 0 }; }) ];
+
+      const res = await runner.runPending(migs, '1.0.0');
+      expect(ran.length).toBe(0);
+      expect(res.applied).toBe(0);
+      expect(res.skipped).toBe(1);
+    });
+
+    it('| BOOT-SAFE: egy hibás migráció NEM dob + NEM állítja meg a többit', async () => {
+      const ran: string[] = [];
+      const migs: DyNTS_MigrationEntry[] = [
+        entry('bad', async () => { throw new Error('boom'); }),
+        entry('good', async () => { ran.push('good'); return { touched: 2 }; }),
+      ];
+
+      const res = await runner.runPending(migs, '1.0.0');
+      expect(res.failed).toBe(1);
+      expect(res.applied).toBe(1);            // 'good' a hiba UTÁN is lefutott
+      expect(ran).toEqual([ 'good' ]);
+    });
+  });
+});