@futdevpro/nts-dynamo 1.15.156 → 1.15.157

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

@@ -1,40 +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>;
-}
+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.js

@@ -1,75 +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;
+"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/mongo-transaction.control-service.d.ts

@@ -1,19 +1,19 @@
-import { ClientSession } from 'mongoose';
-import { DyNTS_MongoTransaction_Settings } from '../../_models/interfaces/mongo-transaction-settings.interface';
-import { DyNTS_SingletonService } from '../base/singleton.service';
-/** Executes reusable Mongo transactions with majority durability and content-free failures. */
-export declare class DyNTS_MongoTransaction_ControlService extends DyNTS_SingletonService {
-    /** Returns the process-wide transaction service. */
-    static getInstance(): DyNTS_MongoTransaction_ControlService;
-    private readonly sessionFactory;
-    /** Creates the service; tests may inject a session factory without changing production behavior. */
-    constructor(sessionFactory?: () => Promise<ClientSession>);
-    /** Runs one task atomically and always closes its session. */
-    execute<T>(settings: DyNTS_MongoTransaction_Settings<T>): Promise<T>;
-    private validateSettings;
-    private buildOptions;
-    private closeSession;
-    private buildError;
-    private getErrorName;
-}
+import { ClientSession } from 'mongoose';
+import { DyNTS_MongoTransaction_Settings } from '../../_models/interfaces/mongo-transaction-settings.interface';
+import { DyNTS_SingletonService } from '../base/singleton.service';
+/** Executes reusable Mongo transactions with majority durability and content-free failures. */
+export declare class DyNTS_MongoTransaction_ControlService extends DyNTS_SingletonService {
+    /** Returns the process-wide transaction service. */
+    static getInstance(): DyNTS_MongoTransaction_ControlService;
+    private readonly sessionFactory;
+    /** Creates the service; tests may inject a session factory without changing production behavior. */
+    constructor(sessionFactory?: () => Promise<ClientSession>);
+    /** Runs one task atomically and always closes its session. */
+    execute<T>(settings: DyNTS_MongoTransaction_Settings<T>): Promise<T>;
+    private validateSettings;
+    private buildOptions;
+    private closeSession;
+    private buildError;
+    private getErrorName;
+}
 //# sourceMappingURL=mongo-transaction.control-service.d.ts.map

package/build/_services/core/mongo-transaction.control-service.js

@@ -1,95 +1,95 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_MongoTransaction_ControlService = void 0;
-const tslib_1 = require("tslib");
-const mongoose_1 = tslib_1.__importDefault(require("mongoose"));
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const singleton_service_1 = require("../base/singleton.service");
-/** Executes reusable Mongo transactions with majority durability and content-free failures. */
-class DyNTS_MongoTransaction_ControlService extends singleton_service_1.DyNTS_SingletonService {
-    /** Returns the process-wide transaction service. */
-    static getInstance() {
-        return DyNTS_MongoTransaction_ControlService.getSingletonInstance();
-    }
-    sessionFactory;
-    /** Creates the service; tests may inject a session factory without changing production behavior. */
-    constructor(sessionFactory = () => mongoose_1.default.startSession()) {
-        super();
-        this.sessionFactory = sessionFactory;
-    }
-    /** Runs one task atomically and always closes its session. */
-    async execute(settings) {
-        this.validateSettings(settings);
-        let session;
-        try {
-            session = await this.sessionFactory();
-        }
-        catch (error) {
-            throw this.buildError('DyNTS|MONGO_TRANSACTION|SESSION_FAILED', 'Mongo transaction session creation failed.', { settings: settings, causeName: this.getErrorName(error) });
-        }
-        try {
-            const wrappedResult = await session.withTransaction(async () => ({ value: await settings.task(session) }), this.buildOptions(settings.maxCommitTimeMs));
-            if (!wrappedResult) {
-                throw this.buildError('DyNTS|MONGO_TRANSACTION|NO_COMMIT_RESULT', 'Mongo transaction finished without a committed result.', { settings: settings });
-            }
-            return wrappedResult.value;
-        }
-        catch (error) {
-            if (error instanceof fsm_dynamo_1.DyFM_Error && error._errorCode?.startsWith('DyNTS|MONGO_TRANSACTION|')) {
-                throw error;
-            }
-            throw this.buildError('DyNTS|MONGO_TRANSACTION|FAILED', 'Mongo transaction failed and was not committed.', { settings: settings, causeName: this.getErrorName(error) });
-        }
-        finally {
-            await this.closeSession(session, settings);
-        }
-    }
-    validateSettings(settings) {
-        if (!settings?.transactionName?.trim() || !settings.issuer?.trim() || typeof settings.task !== 'function') {
-            throw this.buildError('DyNTS|MONGO_TRANSACTION|SETTINGS_INVALID', 'Transaction name, issuer and task are required.', { settings: settings });
-        }
-        if (settings.maxCommitTimeMs !== undefined
-            && (!Number.isSafeInteger(settings.maxCommitTimeMs) || settings.maxCommitTimeMs <= 0)) {
-            throw this.buildError('DyNTS|MONGO_TRANSACTION|COMMIT_TIME_INVALID', 'Mongo transaction maxCommitTimeMs must be a positive safe integer.', { settings: settings });
-        }
-    }
-    buildOptions(maxCommitTimeMs) {
-        const options = {
-            readConcern: { level: 'snapshot' },
-            writeConcern: { w: 'majority' },
-            readPreference: 'primary',
-        };
-        if (maxCommitTimeMs !== undefined) {
-            options.maxCommitTimeMS = maxCommitTimeMs;
-        }
-        return options;
-    }
-    async closeSession(session, settings) {
-        try {
-            await session.endSession();
-        }
-        catch (error) {
-            fsm_dynamo_1.DyFM_Log.warn(`[dynts-mongo-transaction] session cleanup failed · transaction=${settings.transactionName}`, error instanceof Error ? error.name : 'unknown-error');
-        }
-    }
-    buildError(errorCode, message, context) {
-        return new fsm_dynamo_1.DyFM_Error({
-            status: 500,
-            errorCode: errorCode,
-            message: message,
-            userMessage: 'The operation could not be committed. No partial change was accepted.',
-            issuer: context.settings?.issuer,
-            issuerService: this.constructor.name,
-            additionalContent: {
-                transactionName: context.settings?.transactionName ?? 'unknown',
-                causeName: context.causeName ?? 'unknown',
-            },
-            error: context.causeName ? new Error(context.causeName) : undefined,
-        });
-    }
-    getErrorName(error) {
-        return error instanceof Error ? error.name : 'unknown-error';
-    }
-}
-exports.DyNTS_MongoTransaction_ControlService = DyNTS_MongoTransaction_ControlService;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_MongoTransaction_ControlService = void 0;
+const tslib_1 = require("tslib");
+const mongoose_1 = tslib_1.__importDefault(require("mongoose"));
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const singleton_service_1 = require("../base/singleton.service");
+/** Executes reusable Mongo transactions with majority durability and content-free failures. */
+class DyNTS_MongoTransaction_ControlService extends singleton_service_1.DyNTS_SingletonService {
+    /** Returns the process-wide transaction service. */
+    static getInstance() {
+        return DyNTS_MongoTransaction_ControlService.getSingletonInstance();
+    }
+    sessionFactory;
+    /** Creates the service; tests may inject a session factory without changing production behavior. */
+    constructor(sessionFactory = () => mongoose_1.default.startSession()) {
+        super();
+        this.sessionFactory = sessionFactory;
+    }
+    /** Runs one task atomically and always closes its session. */
+    async execute(settings) {
+        this.validateSettings(settings);
+        let session;
+        try {
+            session = await this.sessionFactory();
+        }
+        catch (error) {
+            throw this.buildError('DyNTS|MONGO_TRANSACTION|SESSION_FAILED', 'Mongo transaction session creation failed.', { settings: settings, causeName: this.getErrorName(error) });
+        }
+        try {
+            const wrappedResult = await session.withTransaction(async () => ({ value: await settings.task(session) }), this.buildOptions(settings.maxCommitTimeMs));
+            if (!wrappedResult) {
+                throw this.buildError('DyNTS|MONGO_TRANSACTION|NO_COMMIT_RESULT', 'Mongo transaction finished without a committed result.', { settings: settings });
+            }
+            return wrappedResult.value;
+        }
+        catch (error) {
+            if (error instanceof fsm_dynamo_1.DyFM_Error && error._errorCode?.startsWith('DyNTS|MONGO_TRANSACTION|')) {
+                throw error;
+            }
+            throw this.buildError('DyNTS|MONGO_TRANSACTION|FAILED', 'Mongo transaction failed and was not committed.', { settings: settings, causeName: this.getErrorName(error) });
+        }
+        finally {
+            await this.closeSession(session, settings);
+        }
+    }
+    validateSettings(settings) {
+        if (!settings?.transactionName?.trim() || !settings.issuer?.trim() || typeof settings.task !== 'function') {
+            throw this.buildError('DyNTS|MONGO_TRANSACTION|SETTINGS_INVALID', 'Transaction name, issuer and task are required.', { settings: settings });
+        }
+        if (settings.maxCommitTimeMs !== undefined
+            && (!Number.isSafeInteger(settings.maxCommitTimeMs) || settings.maxCommitTimeMs <= 0)) {
+            throw this.buildError('DyNTS|MONGO_TRANSACTION|COMMIT_TIME_INVALID', 'Mongo transaction maxCommitTimeMs must be a positive safe integer.', { settings: settings });
+        }
+    }
+    buildOptions(maxCommitTimeMs) {
+        const options = {
+            readConcern: { level: 'snapshot' },
+            writeConcern: { w: 'majority' },
+            readPreference: 'primary',
+        };
+        if (maxCommitTimeMs !== undefined) {
+            options.maxCommitTimeMS = maxCommitTimeMs;
+        }
+        return options;
+    }
+    async closeSession(session, settings) {
+        try {
+            await session.endSession();
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.warn(`[dynts-mongo-transaction] session cleanup failed · transaction=${settings.transactionName}`, error instanceof Error ? error.name : 'unknown-error');
+        }
+    }
+    buildError(errorCode, message, context) {
+        return new fsm_dynamo_1.DyFM_Error({
+            status: 500,
+            errorCode: errorCode,
+            message: message,
+            userMessage: 'The operation could not be committed. No partial change was accepted.',
+            issuer: context.settings?.issuer,
+            issuerService: this.constructor.name,
+            additionalContent: {
+                transactionName: context.settings?.transactionName ?? 'unknown',
+                causeName: context.causeName ?? 'unknown',
+            },
+            error: context.causeName ? new Error(context.causeName) : undefined,
+        });
+    }
+    getErrorName(error) {
+        return error instanceof Error ? error.name : 'unknown-error';
+    }
+}
+exports.DyNTS_MongoTransaction_ControlService = DyNTS_MongoTransaction_ControlService;
 //# sourceMappingURL=mongo-transaction.control-service.js.map

package/build/_services/core/request-hunter.service.d.ts

@@ -1,74 +1,74 @@
-/** Egy eppen futo keres a hunter nyilvantartasaban. */
-export interface DyNTS_InFlightRequest {
-    /** Az endpoint neve (`DyNTS_Endpoint_Params.name`). */
-    label: string;
-    /** Mennyi ideje fut (ms). */
-    ageMs: number;
-}
-/** Egy mar befejezodott LASSU keres (gorgo history). */
-export interface DyNTS_SlowRequestSample {
-    at: number;
-    label: string;
-    durationMs: number;
-}
-/**
- * ISSUE-HUNTER: **melyik keres blokkolta az event-loopot?**
- *
- * ⚠️ MIERT KELLETT (mert incidens, overseer 2026-08-05): az event-loop 10-15 masodpercre
- * megallt (`DyNTS_EventLoopDiag`: elLag max 10058-14839 ms), a `MemoryGuard` es a healthcheck
- * ONMAGABAN egyiket sem tudta MIHEZ kotni. A diagnozis igy a nyers log 4893 sorabol tortent,
- * orak alatt — holott a dontő jel MINDOSSZE 4 sor volt benne. A hianyzo kepesseg nem a MERES
- * volt (az megvolt), hanem az ATTRIBUCIO: *mi futott, amikor megallt?*
- *
- * Ez a service ezt potolja, KET fuggetlen jellel:
- *
- *  1. **Lassu-keres onjelentes (a fo jel).** Amikor egy keres BEFEJEZODIK, ha tovabb tartott a
- *     kuszobnel, azonnal WARN-t ir a nevevel es az idejevel. A mai incidenst EZ egyetlen sorban
- *     megadta volna: `[REQ-HUNTER] SLOW getCdpReportDetails 10240ms`.
- *     ⚠️ Miert EZ a fo jel: a fagyas ALATT a diag-poll NEM fut (a loop all), tehat mire lefutna,
- *     a bunos keres mar befejezodott — az "in-flight pillanatkep" onmagaban ELKESNE.
- *
- *  2. **In-flight pillanatkep (a masodik jel).** Azokra az esetekre, amikor a keres MEG MINDIG
- *     fut (beragadt / vegtelen varakozas): a stall-detektor le tudja kerdezni, mi van eppen
- *     folyamatban es mennyi ideje.
- *
- * KOLTSEG: egy `Map`-beszuras + `Date.now()` keresenkent. Elhanyagolhato; ezert
- * alapertelmezetten BE van kapcsolva (a mai incidens tanulsaga: ami nincs bekapcsolva, az pont
- * az incidens alatt nem all rendelkezesre).
- *
- * Settings (`DyNTS_global_settings.requestHunter`):
- *   - `enabled?: boolean`        default true
- *   - `slowRequestMs?: number`   default 1000 — e felett WARN a keres vegen
- *   - `maxHistoryCount?: number` default 50 — a lassu-keres history merete
- */
-export declare class DyNTS_RequestHunter {
-    private static instance;
-    static getInstance(): DyNTS_RequestHunter;
-    private nextId;
-    private readonly inFlight;
-    private slowHistory;
-    /** A settings-ertekek feloldasa (minden hivasnal, hogy a runtime-valtoztatas is hasson). */
-    private getSettings;
-    /**
-     * Keres kezdete. A visszaadott id-t az `end()`-nek kell atadni.
-     *
-     * @returns a keres id-ja, vagy 0 ha a hunter ki van kapcsolva (az `end(0)` no-op)
-     */
-    begin(label: string): number;
-    /**
-     * Keres vege. Ha a kuszobnel tovabb tartott, WARN + bekerul a history-ba.
-     * Hibatur: ismeretlen / 0 id eseten no-op.
-     */
-    end(id: number): void;
-    /** Az EPPEN futo keresek — a stall-detektor ebbol tudja, mi ragadt be. */
-    getInFlight(now?: number): DyNTS_InFlightRequest[];
-    /** A kozelmult lassu keresei (gorgo history) — `/server/diag`-ba is kitehető. */
-    getSlowHistory(): DyNTS_SlowRequestSample[];
-    /**
-     * Ember-olvashato in-flight osszefoglalo a stall-loghoz.
-     * Ures listanal expliciten ezt mondja — mert az IS informacio: a blokkolo mar befejezodott,
-     * tehat a lassu-keres onjelentest (1. jel) kell nezni.
-     */
-    describeInFlight(now?: number): string;
-}
+/** Egy eppen futo keres a hunter nyilvantartasaban. */
+export interface DyNTS_InFlightRequest {
+    /** Az endpoint neve (`DyNTS_Endpoint_Params.name`). */
+    label: string;
+    /** Mennyi ideje fut (ms). */
+    ageMs: number;
+}
+/** Egy mar befejezodott LASSU keres (gorgo history). */
+export interface DyNTS_SlowRequestSample {
+    at: number;
+    label: string;
+    durationMs: number;
+}
+/**
+ * ISSUE-HUNTER: **melyik keres blokkolta az event-loopot?**
+ *
+ * ⚠️ MIERT KELLETT (mert incidens, overseer 2026-08-05): az event-loop 10-15 masodpercre
+ * megallt (`DyNTS_EventLoopDiag`: elLag max 10058-14839 ms), a `MemoryGuard` es a healthcheck
+ * ONMAGABAN egyiket sem tudta MIHEZ kotni. A diagnozis igy a nyers log 4893 sorabol tortent,
+ * orak alatt — holott a dontő jel MINDOSSZE 4 sor volt benne. A hianyzo kepesseg nem a MERES
+ * volt (az megvolt), hanem az ATTRIBUCIO: *mi futott, amikor megallt?*
+ *
+ * Ez a service ezt potolja, KET fuggetlen jellel:
+ *
+ *  1. **Lassu-keres onjelentes (a fo jel).** Amikor egy keres BEFEJEZODIK, ha tovabb tartott a
+ *     kuszobnel, azonnal WARN-t ir a nevevel es az idejevel. A mai incidenst EZ egyetlen sorban
+ *     megadta volna: `[REQ-HUNTER] SLOW getCdpReportDetails 10240ms`.
+ *     ⚠️ Miert EZ a fo jel: a fagyas ALATT a diag-poll NEM fut (a loop all), tehat mire lefutna,
+ *     a bunos keres mar befejezodott — az "in-flight pillanatkep" onmagaban ELKESNE.
+ *
+ *  2. **In-flight pillanatkep (a masodik jel).** Azokra az esetekre, amikor a keres MEG MINDIG
+ *     fut (beragadt / vegtelen varakozas): a stall-detektor le tudja kerdezni, mi van eppen
+ *     folyamatban es mennyi ideje.
+ *
+ * KOLTSEG: egy `Map`-beszuras + `Date.now()` keresenkent. Elhanyagolhato; ezert
+ * alapertelmezetten BE van kapcsolva (a mai incidens tanulsaga: ami nincs bekapcsolva, az pont
+ * az incidens alatt nem all rendelkezesre).
+ *
+ * Settings (`DyNTS_global_settings.requestHunter`):
+ *   - `enabled?: boolean`        default true
+ *   - `slowRequestMs?: number`   default 1000 — e felett WARN a keres vegen
+ *   - `maxHistoryCount?: number` default 50 — a lassu-keres history merete
+ */
+export declare class DyNTS_RequestHunter {
+    private static instance;
+    static getInstance(): DyNTS_RequestHunter;
+    private nextId;
+    private readonly inFlight;
+    private slowHistory;
+    /** A settings-ertekek feloldasa (minden hivasnal, hogy a runtime-valtoztatas is hasson). */
+    private getSettings;
+    /**
+     * Keres kezdete. A visszaadott id-t az `end()`-nek kell atadni.
+     *
+     * @returns a keres id-ja, vagy 0 ha a hunter ki van kapcsolva (az `end(0)` no-op)
+     */
+    begin(label: string): number;
+    /**
+     * Keres vege. Ha a kuszobnel tovabb tartott, WARN + bekerul a history-ba.
+     * Hibatur: ismeretlen / 0 id eseten no-op.
+     */
+    end(id: number): void;
+    /** Az EPPEN futo keresek — a stall-detektor ebbol tudja, mi ragadt be. */
+    getInFlight(now?: number): DyNTS_InFlightRequest[];
+    /** A kozelmult lassu keresei (gorgo history) — `/server/diag`-ba is kitehető. */
+    getSlowHistory(): DyNTS_SlowRequestSample[];
+    /**
+     * Ember-olvashato in-flight osszefoglalo a stall-loghoz.
+     * Ures listanal expliciten ezt mondja — mert az IS informacio: a blokkolo mar befejezodott,
+     * tehat a lassu-keres onjelentest (1. jel) kell nezni.
+     */
+    describeInFlight(now?: number): string;
+}
 //# sourceMappingURL=request-hunter.service.d.ts.map