@futdevpro/nts-dynamo 1.15.265 → 1.15.268

package/build/_modules/lifecycle-cleanup/lifecycle-cleanup.control-service.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_LifecycleCleanup_ControlService = void 0;
+const node_crypto_1 = require("node:crypto");
+const mongo_transaction_control_service_1 = require("../../_services/core/mongo-transaction.control-service");
+const lifecycle_cleanup_state_type_enum_1 = require("./_enums/lifecycle-cleanup-state.type-enum");
+const dynts_hashPattern = /^[a-f0-9]{64}$/u;
+const dynts_identifierPattern = /^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,127}$/u;
+const DYNTS_LIFECYCLE_CLEANUP_MAX_STAGE_COUNT = 128;
+const DYNTS_LIFECYCLE_CLEANUP_MAX_BATCH_SIZE = 1_000;
+/**
+ * Executes one explicitly requested database-only lifecycle batch.
+ * Product policy supplies the ordered stages and callbacks; this service supplies durable fencing and resume.
+ */
+class DyNTS_LifecycleCleanup_ControlService {
+    issuer;
+    store;
+    adapters;
+    transactions;
+    maxCommitTimeMs;
+    /** Binds one product adapter inventory to the reusable lifecycle coordinator. */
+    constructor(settings) {
+        if (!settings?.store?.connection
+            || !dynts_identifierPattern.test(settings.issuer)
+            || !Array.isArray(settings.adapters)
+            || settings.adapters.length < 1
+            || settings.adapters.length > DYNTS_LIFECYCLE_CLEANUP_MAX_STAGE_COUNT
+            || (settings.maxCommitTimeMs !== undefined
+                && (!Number.isSafeInteger(settings.maxCommitTimeMs) || settings.maxCommitTimeMs <= 0))) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP|INVALID_SETTINGS');
+        }
+        const entries = settings.adapters.map((adapter) => {
+            if (!dynts_identifierPattern.test(adapter?.stage) || typeof adapter.execute !== 'function') {
+                throw new Error('DyNTS|LIFECYCLE_CLEANUP|INVALID_ADAPTER');
+            }
+            return [adapter.stage, Object.freeze({ ...adapter })];
+        });
+        if (new Set(entries.map((entry) => (entry[0]))).size !== entries.length) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP|DUPLICATE_ADAPTER');
+        }
+        this.issuer = settings.issuer;
+        this.store = settings.store;
+        this.adapters = new Map(entries);
+        this.transactions = settings.transactionService ?? new mongo_transaction_control_service_1.DyNTS_MongoTransaction_ControlService(() => this.store.connection.startSession());
+        this.maxCommitTimeMs = settings.maxCommitTimeMs ?? 3_000;
+    }
+    /** Creates and validates the shared collections outside product transactions. */
+    ensureReady() {
+        return this.store.ensureReady();
+    }
+    /** Schedules one exact recovery deadline inside the product soft-delete transaction. */
+    schedule(value, session) {
+        const plan = this.plan(value?.plan);
+        this.identity(value);
+        this.transaction(session);
+        if (value?.contractVersion !== 'dynts-lifecycle-cleanup-schedule/1'
+            || !this.exactRecord(value, [
+                'contractVersion', 'scopeHash', 'cleanupId', 'plan', 'eligibleAtMs',
+            ])
+            || !Number.isSafeInteger(value.eligibleAtMs)
+            || value.eligibleAtMs < 0) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP|INVALID_SCHEDULE');
+        }
+        const request = {
+            scopeHash: value.scopeHash,
+            cleanupId: value.cleanupId,
+            planChecksum: plan.checksum,
+            stageCount: plan.stageCount,
+            eligibleAtMs: value.eligibleAtMs,
+        };
+        return this.store.schedule(Object.freeze(request), session);
+    }
+    /** Cancels only a not-yet-claimed cleanup gate inside the product restore transaction. */
+    cancel(value, session) {
+        const plan = this.plan(value?.plan);
+        this.identity(value);
+        this.transaction(session);
+        if (value?.contractVersion !== 'dynts-lifecycle-cleanup-cancellation/1'
+            || !this.exactRecord(value, ['contractVersion', 'scopeHash', 'cleanupId', 'plan'])) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP|INVALID_CANCELLATION');
+        }
+        return this.store.cancel(Object.freeze({
+            scopeHash: value.scopeHash,
+            cleanupId: value.cleanupId,
+            planChecksum: plan.checksum,
+            stageCount: plan.stageCount,
+        }), session);
+    }
+    /** Claims and commits at most one product-defined stage batch. It never loops, sleeps or schedules itself. */
+    async invoke(value) {
+        const plan = this.plan(value?.plan);
+        this.identity(value);
+        if (value?.contractVersion !== 'dynts-lifecycle-cleanup-invocation/1'
+            || !this.exactRecord(value, [
+                'contractVersion', 'scopeHash', 'cleanupId', 'plan', 'batchSize',
+            ])
+            || !Number.isSafeInteger(value.batchSize)
+            || value.batchSize < 1
+            || value.batchSize > DYNTS_LIFECYCLE_CLEANUP_MAX_BATCH_SIZE) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP|INVALID_INVOCATION');
+        }
+        await this.store.ensureReady();
+        const claimRequest = Object.freeze({
+            scopeHash: value.scopeHash,
+            cleanupId: value.cleanupId,
+            planChecksum: plan.checksum,
+            stageCount: plan.stageCount,
+        });
+        const claim = await this.store.claim(claimRequest);
+        if (claim.code !== lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupInvocationCode_Type.executed) {
+            return this.receipt(value.plan, claim);
+        }
+        const stage = value.plan.stages[claim.stageIndex];
+        const adapter = stage
+            ? this.adapters.get(stage)
+            : undefined;
+        if (!stage || !adapter) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP|ADAPTER_MISSING');
+        }
+        const committed = await this.transactions.execute({
+            transactionName: 'lifecycle-cleanup-stage',
+            issuer: this.issuer,
+            maxCommitTimeMs: this.maxCommitTimeMs,
+            task: async (session) => {
+                const result = await adapter.execute(Object.freeze({
+                    contractVersion: 'dynts-lifecycle-cleanup-stage-context/1',
+                    scopeHash: value.scopeHash,
+                    cleanupId: value.cleanupId,
+                    stage: stage,
+                    stageIndex: claim.stageIndex,
+                    batchSize: value.batchSize,
+                    evaluatedAtMs: claim.evaluatedAtMs,
+                    fencingToken: claim.fencingToken,
+                    session: session,
+                }));
+                this.stageResult(result, stage, value.batchSize);
+                const commit = {
+                    ...claimRequest,
+                    stageIndex: claim.stageIndex,
+                    fencingToken: claim.fencingToken,
+                    result: Object.freeze({ ...result }),
+                };
+                return this.store.commit(Object.freeze(commit), session);
+            },
+        });
+        return this.receipt(value.plan, committed);
+    }
+    plan(value) {
+        if (value?.contractVersion !== 'dynts-lifecycle-cleanup-plan/1'
+            || !this.exactRecord(value, ['contractVersion', 'planVersion', 'stages'])
+            || !dynts_identifierPattern.test(value.planVersion)
+            || !this.exactArray(value.stages)
+            || value.stages.length < 1
+            || value.stages.length > DYNTS_LIFECYCLE_CLEANUP_MAX_STAGE_COUNT
+            || value.stages.some((stage) => !dynts_identifierPattern.test(stage))
+            || new Set(value.stages).size !== value.stages.length
+            || value.stages.some((stage) => !this.adapters.has(stage))) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP|INVALID_PLAN');
+        }
+        return Object.freeze({
+            checksum: (0, node_crypto_1.createHash)('sha256').update(JSON.stringify([
+                value.contractVersion,
+                value.planVersion,
+                value.stages,
+            ])).digest('hex'),
+            stageCount: value.stages.length,
+        });
+    }
+    identity(value) {
+        if (!dynts_hashPattern.test(value?.scopeHash ?? '') || !dynts_hashPattern.test(value?.cleanupId ?? '')) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP|INVALID_IDENTITY');
+        }
+    }
+    transaction(session) {
+        if (!session?.inTransaction()) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP|TRANSACTION_REQUIRED');
+        }
+    }
+    stageResult(value, stage, batchSize) {
+        if (value?.contractVersion !== 'dynts-lifecycle-cleanup-stage-result/1'
+            || !this.exactRecord(value, [
+                'contractVersion', 'stage', 'isComplete', 'selectedRecordCount', 'deletedRecordCount', 'resultChecksum',
+            ])
+            || value.stage !== stage
+            || typeof value.isComplete !== 'boolean'
+            || !Number.isSafeInteger(value.selectedRecordCount)
+            || value.selectedRecordCount < 0
+            || value.selectedRecordCount > batchSize
+            || !Number.isSafeInteger(value.deletedRecordCount)
+            || value.deletedRecordCount < 0
+            || value.deletedRecordCount > value.selectedRecordCount
+            || !dynts_hashPattern.test(value.resultChecksum)) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP|INVALID_STAGE_RESULT');
+        }
+    }
+    exactRecord(value, expectedKeys) {
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            return false;
+        }
+        const prototype = Object.getPrototypeOf(value);
+        const keys = Reflect.ownKeys(value);
+        return (prototype === Object.prototype || prototype === null)
+            && keys.length === expectedKeys.length
+            && keys.every((key) => {
+                const descriptor = Object.getOwnPropertyDescriptor(value, key);
+                return typeof key === 'string'
+                    && expectedKeys.includes(key)
+                    && !!descriptor
+                    && 'value' in descriptor
+                    && descriptor.enumerable === true;
+            });
+    }
+    exactArray(value) {
+        if (!Array.isArray(value) || Object.getPrototypeOf(value) !== Array.prototype) {
+            return false;
+        }
+        if (Reflect.ownKeys(value).length !== value.length + 1) {
+            return false;
+        }
+        for (let index = 0; index < value.length; index++) {
+            const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+            if (!descriptor || !('value' in descriptor) || !descriptor.enumerable) {
+                return false;
+            }
+        }
+        return true;
+    }
+    receipt(plan, claim) {
+        const stage = claim.stageIndex < plan.stages.length ? plan.stages[claim.stageIndex] : '';
+        return Object.freeze({
+            contractVersion: 'dynts-lifecycle-cleanup-invocation-receipt/1',
+            scopeHash: claim.scopeHash,
+            cleanupId: claim.cleanupId,
+            code: claim.code,
+            planChecksum: claim.planChecksum,
+            stage: stage,
+            stageIndex: claim.stageIndex,
+            isComplete: claim.code === lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupInvocationCode_Type.complete,
+            selectedRecordCount: claim.selectedRecordCount,
+            deletedRecordCount: claim.deletedRecordCount,
+            lastResultChecksum: claim.lastResultChecksum,
+        });
+    }
+}
+exports.DyNTS_LifecycleCleanup_ControlService = DyNTS_LifecycleCleanup_ControlService;
+//# sourceMappingURL=lifecycle-cleanup.control-service.js.map

package/build/_modules/lifecycle-cleanup/lifecycle-cleanup.control-service.js.map

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

package/build/_modules/lifecycle-cleanup/lifecycle-cleanup.mongo-store.d.ts

@@ -0,0 +1,36 @@
+import { ClientSession, Connection } from 'mongoose';
+import { DyNTS_LifecycleCleanupCancellationReceipt_Interface, DyNTS_LifecycleCleanupClaim_Interface, DyNTS_LifecycleCleanupScheduleReceipt_Interface, DyNTS_LifecycleCleanupStoreClaim_Interface, DyNTS_LifecycleCleanupStoreCommit_Interface, DyNTS_LifecycleCleanupStore_Interface, DyNTS_LifecycleCleanupStoreSchedule_Interface } from './_models/lifecycle-cleanup.interface';
+import { DyNTS_LifecycleCleanupMongoStoreSettings_Interface } from './_models/lifecycle-cleanup-mongo-store-settings.interface';
+/** Durable Mongo gate, lease and progress store for explicitly invoked lifecycle cleanup. */
+export declare class DyNTS_LifecycleCleanup_MongoStore implements DyNTS_LifecycleCleanupStore_Interface {
+    readonly connection: Connection;
+    private readonly maxOperationTimeMs;
+    private readonly leaseDurationMs;
+    private readiness?;
+    /** Uses one product connection so gate transitions and product mutations can share a transaction. */
+    constructor(settings: DyNTS_LifecycleCleanupMongoStoreSettings_Interface);
+    /** Creates and verifies the strict content-free progress collection before product transactions begin. */
+    ensureReady(): Promise<void>;
+    /** Inserts the immutable plan/deadline gate or acknowledges its exact replay. */
+    schedule(value: DyNTS_LifecycleCleanupStoreSchedule_Interface, session: ClientSession): Promise<DyNTS_LifecycleCleanupScheduleReceipt_Interface>;
+    /** Deletes only a scheduled gate; an acquired or completed cleanup makes restore fail closed. */
+    cancel(value: DyNTS_LifecycleCleanupStoreClaim_Interface, session: ClientSession): Promise<DyNTS_LifecycleCleanupCancellationReceipt_Interface>;
+    /** Acquires one DB-time lease or reports not-due, busy or terminal state without waiting. */
+    claim(value: DyNTS_LifecycleCleanupStoreClaim_Interface): Promise<DyNTS_LifecycleCleanupClaim_Interface>;
+    /** Commits callback mutations and progress together, guarded by stage and fencing token. */
+    commit(value: DyNTS_LifecycleCleanupStoreCommit_Interface, session: ClientSession): Promise<DyNTS_LifecycleCleanupClaim_Interface>;
+    private collection;
+    private key;
+    private request;
+    private commitRequest;
+    private exactRecord;
+    private transaction;
+    private assertExact;
+    private document;
+    private time;
+    private scheduleReceipt;
+    private claimReceipt;
+    private validator;
+    private isMongoCode;
+}
+//# sourceMappingURL=lifecycle-cleanup.mongo-store.d.ts.map

package/build/_modules/lifecycle-cleanup/lifecycle-cleanup.mongo-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-cleanup.mongo-store.d.ts","sourceRoot":"","sources":["../../../src/_modules/lifecycle-cleanup/lifecycle-cleanup.mongo-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAS,MAAM,UAAU,CAAC;AAM5D,OAAO,EACL,mDAAmD,EACnD,qCAAqC,EACrC,+CAA+C,EAC/C,0CAA0C,EAC1C,2CAA2C,EAC3C,qCAAqC,EACrC,6CAA6C,EAC9C,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,kDAAkD,EACnD,MAAM,4DAA4D,CAAC;AA4BpE,6FAA6F;AAC7F,qBAAa,iCAAkC,YAAW,qCAAqC;IAC7F,SAAgB,UAAU,EAAE,UAAU,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,SAAS,CAAC,CAAgB;IAElC,qGAAqG;gBAClF,QAAQ,EAAE,kDAAkD;IAkB/E,0GAA0G;IAC7F,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCzC,iFAAiF;IACpE,QAAQ,CACnB,KAAK,EAAE,6CAA6C,EACpD,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,+CAA+C,CAAC;IA2D3D,iGAAiG;IACpF,MAAM,CACjB,KAAK,EAAE,0CAA0C,EACjD,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,mDAAmD,CAAC;IAyC/D,6FAA6F;IAChF,KAAK,CAChB,KAAK,EAAE,0CAA0C,GAChD,OAAO,CAAC,qCAAqC,CAAC;IAgEjD,4FAA4F;IAC/E,MAAM,CACjB,KAAK,EAAE,2CAA2C,EAClD,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,qCAAqC,CAAC;IAiDjD,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,OAAO;IAiBf,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,QAAQ;IA0ChB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,SAAS;IAkCjB,OAAO,CAAC,WAAW;CAOpB"}