@futdevpro/nts-dynamo 1.15.264 → 1.15.266

package/README.md

@@ -1,5 +1,10 @@
 # Dynamo-NTS
 
+The additive `@futdevpro/nts-dynamo/application-alert-delivery` subpath provides an explicitly invoked, durable,
+content-free application-alert sender outbox with idempotency, bounded retry/backoff, leases, fencing and terminal
+delivery evidence. Its aggregate operations projection exposes only state/due/expired-lease counts and timestamps.
+It starts no timer, poller or background worker.
+
 ![Dynamo-NTS Logo](src/_assets/dynamo-nts-logo-256.png)
 
 **Dynamo-NTS** (NodeTS) is a comprehensive backend framework for building robust, secure, and scalable Node.js applications with TypeScript. Built on top of [Dynamo FSM](https://www.npmjs.com/package/@futdevpro/fsm-dynamo) (`@futdevpro/fsm-dynamo`), it provides a structured approach to server-side development with clear separation of concerns, extensive configuration options, and production-ready implementations for common backend tasks.
@@ -358,6 +363,23 @@ The cursor is an integrity and routing boundary, not encryption. Consumers must
 values such as canonical timestamps and opaque resource identifiers into the tuple. Tenant, account, email,
 authorization or business-content fields must remain server-derived and outside the cursor payload.
 
+### Explicit lifecycle cleanup
+
+The optional `@futdevpro/nts-dynamo/lifecycle-cleanup` entry point coordinates resumable product cleanup without
+learning product collection names or retention policy. Consumers supply opaque scope/root hashes, one immutable
+ordered stage plan and one database-only adapter per stage. Each explicit invocation runs at most one bounded
+batch; the module never starts a timer, polling loop, scheduler or network callback.
+
+Schedule the cleanup gate in the same caller-owned Mongo transaction as the product soft delete, and cancel it in
+the same transaction as an allowed restore. Due work uses Mongo server time, a bounded lease and a monotonic
+fencing token. Product mutations and progress commit share one `ClientSession`, so they commit or roll back
+together. An expired or replaced worker cannot commit, incomplete stages resume without advancing, and parents
+cannot run before every earlier product-defined stage is complete.
+
+The shared store retains only opaque hashes, plan identity, aggregate counts, timestamps and result checksums.
+Products remain responsible for exact tenant authorization, retention durations, stage meanings, deterministic
+selection/delete predicates, operational invocation, legal review and end-to-end deletion verification.
+
 ### Privacy lifecycle
 
 The optional `@futdevpro/nts-dynamo/privacy-lifecycle` entry point provides the shared machinery for standalone

package/build/_modules/application-alert-delivery/_enums/application-alert-delivery-state.type-enum.d.ts

@@ -0,0 +1,21 @@
+/** Durable sender states for one content-free application-alert delivery. */
+export declare enum DyNTS_ApplicationAlertDeliveryState_Type {
+    pending = "pending",
+    dispatching = "dispatching",
+    retryWaiting = "retry-waiting",
+    succeeded = "succeeded",
+    failed = "failed"
+}
+/** Closed transport outcomes returned by an application-alert delivery adapter. */
+export declare enum DyNTS_ApplicationAlertSubmissionOutcome_Type {
+    accepted = "accepted",
+    retryableFailure = "retryable-failure",
+    terminalFailure = "terminal-failure"
+}
+/** Result of one explicitly invoked sender cycle; no timer or polling is implied. */
+export declare enum DyNTS_ApplicationAlertInvocationCode_Type {
+    noReadyDelivery = "no-ready-delivery",
+    deliveryClaimed = "delivery-claimed",
+    terminalFailureRecorded = "terminal-failure-recorded"
+}
+//# sourceMappingURL=application-alert-delivery-state.type-enum.d.ts.map

package/build/_modules/application-alert-delivery/_enums/application-alert-delivery-state.type-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-alert-delivery-state.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/application-alert-delivery/_enums/application-alert-delivery-state.type-enum.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,oBAAY,wCAAwC;IAClD,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,YAAY,kBAAkB;IAC9B,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED,mFAAmF;AACnF,oBAAY,4CAA4C;IACtD,QAAQ,aAAa;IACrB,gBAAgB,sBAAsB;IACtC,eAAe,qBAAqB;CACrC;AAED,qFAAqF;AACrF,oBAAY,yCAAyC;IACnD,eAAe,sBAAsB;IACrC,eAAe,qBAAqB;IACpC,uBAAuB,8BAA8B;CACtD"}

package/build/_modules/application-alert-delivery/_enums/application-alert-delivery-state.type-enum.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ApplicationAlertInvocationCode_Type = exports.DyNTS_ApplicationAlertSubmissionOutcome_Type = exports.DyNTS_ApplicationAlertDeliveryState_Type = void 0;
+/** Durable sender states for one content-free application-alert delivery. */
+var DyNTS_ApplicationAlertDeliveryState_Type;
+(function (DyNTS_ApplicationAlertDeliveryState_Type) {
+    DyNTS_ApplicationAlertDeliveryState_Type["pending"] = "pending";
+    DyNTS_ApplicationAlertDeliveryState_Type["dispatching"] = "dispatching";
+    DyNTS_ApplicationAlertDeliveryState_Type["retryWaiting"] = "retry-waiting";
+    DyNTS_ApplicationAlertDeliveryState_Type["succeeded"] = "succeeded";
+    DyNTS_ApplicationAlertDeliveryState_Type["failed"] = "failed";
+})(DyNTS_ApplicationAlertDeliveryState_Type || (exports.DyNTS_ApplicationAlertDeliveryState_Type = DyNTS_ApplicationAlertDeliveryState_Type = {}));
+/** Closed transport outcomes returned by an application-alert delivery adapter. */
+var DyNTS_ApplicationAlertSubmissionOutcome_Type;
+(function (DyNTS_ApplicationAlertSubmissionOutcome_Type) {
+    DyNTS_ApplicationAlertSubmissionOutcome_Type["accepted"] = "accepted";
+    DyNTS_ApplicationAlertSubmissionOutcome_Type["retryableFailure"] = "retryable-failure";
+    DyNTS_ApplicationAlertSubmissionOutcome_Type["terminalFailure"] = "terminal-failure";
+})(DyNTS_ApplicationAlertSubmissionOutcome_Type || (exports.DyNTS_ApplicationAlertSubmissionOutcome_Type = DyNTS_ApplicationAlertSubmissionOutcome_Type = {}));
+/** Result of one explicitly invoked sender cycle; no timer or polling is implied. */
+var DyNTS_ApplicationAlertInvocationCode_Type;
+(function (DyNTS_ApplicationAlertInvocationCode_Type) {
+    DyNTS_ApplicationAlertInvocationCode_Type["noReadyDelivery"] = "no-ready-delivery";
+    DyNTS_ApplicationAlertInvocationCode_Type["deliveryClaimed"] = "delivery-claimed";
+    DyNTS_ApplicationAlertInvocationCode_Type["terminalFailureRecorded"] = "terminal-failure-recorded";
+})(DyNTS_ApplicationAlertInvocationCode_Type || (exports.DyNTS_ApplicationAlertInvocationCode_Type = DyNTS_ApplicationAlertInvocationCode_Type = {}));
+//# sourceMappingURL=application-alert-delivery-state.type-enum.js.map

package/build/_modules/application-alert-delivery/_enums/application-alert-delivery-state.type-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-alert-delivery-state.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/application-alert-delivery/_enums/application-alert-delivery-state.type-enum.ts"],"names":[],"mappings":";;;AAAA,6EAA6E;AAC7E,IAAY,wCAMX;AAND,WAAY,wCAAwC;IAClD,+DAAmB,CAAA;IACnB,uEAA2B,CAAA;IAC3B,0EAA8B,CAAA;IAC9B,mEAAuB,CAAA;IACvB,6DAAiB,CAAA;AACnB,CAAC,EANW,wCAAwC,wDAAxC,wCAAwC,QAMnD;AAED,mFAAmF;AACnF,IAAY,4CAIX;AAJD,WAAY,4CAA4C;IACtD,qEAAqB,CAAA;IACrB,sFAAsC,CAAA;IACtC,oFAAoC,CAAA;AACtC,CAAC,EAJW,4CAA4C,4DAA5C,4CAA4C,QAIvD;AAED,qFAAqF;AACrF,IAAY,yCAIX;AAJD,WAAY,yCAAyC;IACnD,kFAAqC,CAAA;IACrC,iFAAoC,CAAA;IACpC,kGAAqD,CAAA;AACvD,CAAC,EAJW,yCAAyC,yDAAzC,yCAAyC,QAIpD"}

package/build/_modules/application-alert-delivery/_models/application-alert-delivery.interface.d.ts

@@ -0,0 +1,104 @@
+import { Connection } from 'mongoose';
+import { DyFM_ApplicationAlertEnvelope_Interface } from '@futdevpro/fsm-dynamo/application-alert';
+import { DyNTS_ApplicationAlertDeliveryState_Type, DyNTS_ApplicationAlertInvocationCode_Type, DyNTS_ApplicationAlertSubmissionOutcome_Type } from '../_enums/application-alert-delivery-state.type-enum';
+/** Strict durable record. Raw claim tokens, transport errors and arbitrary provider data are forbidden. */
+export interface DyNTS_ApplicationAlertDeliveryRecord_Interface {
+    _id: string;
+    readonly contractVersion: 'dynts-application-alert-delivery/1';
+    readonly sourceSystem: string;
+    readonly idempotencyKey: string;
+    readonly payloadChecksum: string;
+    readonly envelope: DyFM_ApplicationAlertEnvelope_Interface;
+    readonly state: DyNTS_ApplicationAlertDeliveryState_Type;
+    readonly attemptCount: number;
+    readonly fencingToken: number;
+    readonly claimTokenHash: string;
+    readonly claimedAt: Date;
+    readonly leaseExpiresAt: Date;
+    readonly nextAttemptAt: Date;
+    readonly lastOutcome: '' | DyNTS_ApplicationAlertSubmissionOutcome_Type;
+    readonly lastResultCode: string;
+    readonly deliveryReference: string;
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+    readonly completedAt: Date;
+    readonly expiresAt: Date;
+}
+/** Content-free durable delivery projection. */
+export interface DyNTS_ApplicationAlertDeliveryView_Interface {
+    readonly contractVersion: 'dynts-application-alert-delivery-view/1';
+    readonly sourceSystem: string;
+    readonly idempotencyKey: string;
+    readonly payloadChecksum: string;
+    readonly state: DyNTS_ApplicationAlertDeliveryState_Type;
+    readonly attemptCount: number;
+    readonly fencingToken: number;
+    readonly lastOutcome: '' | DyNTS_ApplicationAlertSubmissionOutcome_Type;
+    readonly lastResultCode: string;
+    readonly deliveryReference: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly completedAt: string;
+    readonly changed: boolean;
+}
+/** Aggregate content-free sender health projection; it never exposes envelopes or receiver payloads. */
+export interface DyNTS_ApplicationAlertOperations_Interface {
+    readonly contractVersion: 'dynts-application-alert-operations/1';
+    readonly sourceSystem: string;
+    readonly pendingCount: number;
+    readonly dispatchingCount: number;
+    readonly retryWaitingCount: number;
+    readonly succeededCount: number;
+    readonly failedCount: number;
+    readonly dueCount: number;
+    readonly expiredLeaseCount: number;
+    readonly oldestOpenAt: string;
+    readonly observedAt: string;
+}
+/** Exclusive delivery claim; the raw token is returned only to the winning invocation. */
+export interface DyNTS_ApplicationAlertClaim_Interface {
+    readonly contractVersion: 'dynts-application-alert-claim/1';
+    readonly code: DyNTS_ApplicationAlertInvocationCode_Type;
+    readonly claimed: boolean;
+    readonly claimToken: string;
+    readonly fencingToken: number;
+    readonly envelope?: DyFM_ApplicationAlertEnvelope_Interface;
+    readonly delivery?: DyNTS_ApplicationAlertDeliveryView_Interface;
+}
+/** Closed, content-free receiver result. No message, details or provider payload is accepted. */
+export interface DyNTS_ApplicationAlertSubmission_Interface {
+    readonly contractVersion: 'dynts-application-alert-submission/1';
+    readonly outcome: DyNTS_ApplicationAlertSubmissionOutcome_Type;
+    readonly resultCode: string;
+    readonly deliveryReference: string;
+}
+/** Compare-and-set completion bound to one raw claim token and monotonic fencing token. */
+export interface DyNTS_ApplicationAlertCompletion_Interface {
+    readonly contractVersion: 'dynts-application-alert-completion/1';
+    readonly sourceSystem: string;
+    readonly idempotencyKey: string;
+    readonly fencingToken: number;
+    readonly claimToken: string;
+    readonly submission: DyNTS_ApplicationAlertSubmission_Interface;
+}
+/** Shared sender configuration. Retry and retention are finite and product-configured. */
+export interface DyNTS_ApplicationAlertDeliverySettings_Interface {
+    readonly connection: Connection;
+    readonly sourceSystem: string;
+    readonly maxOperationTimeMs: number;
+    readonly leaseDurationMs: number;
+    readonly maxAttempts: number;
+    readonly retryBackoffMs: readonly number[];
+    readonly retentionMs: number;
+}
+/** Receiver adapter for one validated claim; implementations must enforce their own finite transport timeout. */
+export interface DyNTS_ApplicationAlertSender_Interface {
+    send(envelope: DyFM_ApplicationAlertEnvelope_Interface): Promise<unknown>;
+}
+/** Outcome of one explicit event- or scheduler-triggered dispatch invocation. */
+export interface DyNTS_ApplicationAlertDispatchResult_Interface {
+    readonly contractVersion: 'dynts-application-alert-dispatch-result/1';
+    readonly code: DyNTS_ApplicationAlertInvocationCode_Type;
+    readonly delivery?: DyNTS_ApplicationAlertDeliveryView_Interface;
+}
+//# sourceMappingURL=application-alert-delivery.interface.d.ts.map

package/build/_modules/application-alert-delivery/_models/application-alert-delivery.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-alert-delivery.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/application-alert-delivery/_models/application-alert-delivery.interface.ts"],"names":[],"mappings":"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"}

package/build/_modules/application-alert-delivery/_models/application-alert-delivery.interface.js

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

package/build/_modules/application-alert-delivery/_models/application-alert-delivery.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-alert-delivery.interface.js","sourceRoot":"","sources":["../../../../src/_modules/application-alert-delivery/_models/application-alert-delivery.interface.ts"],"names":[],"mappings":""}

package/build/_modules/application-alert-delivery/application-alert-delivery.control-service.d.ts

@@ -0,0 +1,12 @@
+import { DyNTS_ApplicationAlertDispatchResult_Interface, DyNTS_ApplicationAlertSender_Interface } from './_models/application-alert-delivery.interface';
+import { DyNTS_ApplicationAlertDelivery_MongoStore } from './application-alert-delivery.mongo-store';
+/** Executes at most one explicitly triggered application-alert delivery attempt. */
+export declare class DyNTS_ApplicationAlertDelivery_ControlService {
+    private readonly store;
+    private readonly sender;
+    /** Injects the durable gate and the authenticated receiver adapter without starting background work. */
+    constructor(store: DyNTS_ApplicationAlertDelivery_MongoStore, sender: DyNTS_ApplicationAlertSender_Interface);
+    /** Claims and attempts at most one due envelope; thrown transport errors become bounded retry evidence. */
+    dispatchOne(): Promise<DyNTS_ApplicationAlertDispatchResult_Interface>;
+}
+//# sourceMappingURL=application-alert-delivery.control-service.d.ts.map

package/build/_modules/application-alert-delivery/application-alert-delivery.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-alert-delivery.control-service.d.ts","sourceRoot":"","sources":["../../../src/_modules/application-alert-delivery/application-alert-delivery.control-service.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,8CAA8C,EAC9C,sCAAsC,EACvC,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,yCAAyC,EAAE,MAAM,0CAA0C,CAAC;AAErG,oFAAoF;AACpF,qBAAa,6CAA6C;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4C;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAEhE,wGAAwG;gBAEtG,KAAK,EAAE,yCAAyC,EAChD,MAAM,EAAE,sCAAsC;IAMhD,2GAA2G;IAC9F,WAAW,IAAI,OAAO,CAAC,8CAA8C,CAAC;CAqCpF"}

package/build/_modules/application-alert-delivery/application-alert-delivery.control-service.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ApplicationAlertDelivery_ControlService = void 0;
+const application_alert_delivery_state_type_enum_1 = require("./_enums/application-alert-delivery-state.type-enum");
+/** Executes at most one explicitly triggered application-alert delivery attempt. */
+class DyNTS_ApplicationAlertDelivery_ControlService {
+    store;
+    sender;
+    /** Injects the durable gate and the authenticated receiver adapter without starting background work. */
+    constructor(store, sender) {
+        this.store = store;
+        this.sender = sender;
+    }
+    /** Claims and attempts at most one due envelope; thrown transport errors become bounded retry evidence. */
+    async dispatchOne() {
+        const claim = await this.store.claimNext();
+        if (!claim.claimed || !claim.envelope) {
+            return Object.freeze({
+                contractVersion: 'dynts-application-alert-dispatch-result/1',
+                code: claim.code,
+                delivery: claim.delivery,
+            });
+        }
+        let submission;
+        try {
+            submission = await this.sender.send(claim.envelope);
+        }
+        catch {
+            submission = Object.freeze({
+                contractVersion: 'dynts-application-alert-submission/1',
+                outcome: application_alert_delivery_state_type_enum_1.DyNTS_ApplicationAlertSubmissionOutcome_Type.retryableFailure,
+                resultCode: 'TRANSPORT_UNAVAILABLE',
+                deliveryReference: '',
+            });
+        }
+        const delivery = await this.store.complete({
+            contractVersion: 'dynts-application-alert-completion/1',
+            sourceSystem: claim.envelope.sourceSystem,
+            idempotencyKey: claim.envelope.idempotencyKey,
+            fencingToken: claim.fencingToken,
+            claimToken: claim.claimToken,
+            submission: submission,
+        });
+        return Object.freeze({
+            contractVersion: 'dynts-application-alert-dispatch-result/1',
+            code: application_alert_delivery_state_type_enum_1.DyNTS_ApplicationAlertInvocationCode_Type.deliveryClaimed,
+            delivery: delivery,
+        });
+    }
+}
+exports.DyNTS_ApplicationAlertDelivery_ControlService = DyNTS_ApplicationAlertDelivery_ControlService;
+//# sourceMappingURL=application-alert-delivery.control-service.js.map

package/build/_modules/application-alert-delivery/application-alert-delivery.control-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-alert-delivery.control-service.js","sourceRoot":"","sources":["../../../src/_modules/application-alert-delivery/application-alert-delivery.control-service.ts"],"names":[],"mappings":";;;AAAA,oHAG6D;AAS7D,oFAAoF;AACpF,MAAa,6CAA6C;IACvC,KAAK,CAA4C;IACjD,MAAM,CAAyC;IAEhE,wGAAwG;IACxG,YACE,KAAgD,EAChD,MAA8C;QAE9C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,2GAA2G;IACpG,KAAK,CAAC,WAAW;QACtB,MAAM,KAAK,GAA0C,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAElF,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,eAAe,EAAE,2CAA2C;gBAC5D,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,UAAmB,CAAC;QAExB,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;gBACzB,eAAe,EAAE,sCAAsC;gBACvD,OAAO,EAAE,yFAA4C,CAAC,gBAAgB;gBACtE,UAAU,EAAE,uBAAuB;gBACnC,iBAAiB,EAAE,EAAE;aACtB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,QAAQ,GAAiD,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACvF,eAAe,EAAE,sCAAsC;YACvD,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,YAAY;YACzC,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,cAAc;YAC7C,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU,EAAE,UAAU;SACvB,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,eAAe,EAAE,2CAA2C;YAC5D,IAAI,EAAE,sFAAyC,CAAC,eAAe;YAC/D,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;IACL,CAAC;CACF;AAnDD,sGAmDC"}

package/build/_modules/application-alert-delivery/application-alert-delivery.mongo-store.d.ts

@@ -0,0 +1,49 @@
+import { DyNTS_ApplicationAlertClaim_Interface, DyNTS_ApplicationAlertDeliverySettings_Interface, DyNTS_ApplicationAlertDeliveryView_Interface, DyNTS_ApplicationAlertOperations_Interface } from './_models/application-alert-delivery.interface';
+/** Mongo-backed, explicitly invoked application-alert sender outbox. */
+export declare class DyNTS_ApplicationAlertDelivery_MongoStore {
+    private readonly settings;
+    private readonly ownedErrors;
+    private isReady;
+    private readiness?;
+    /** Validates finite retry, lease and retention policy without starting any worker or timer. */
+    constructor(settings: DyNTS_ApplicationAlertDeliverySettings_Interface);
+    /** Creates and verifies the strict collection plus deterministic claim and TTL indexes. */
+    ensureReady(): Promise<void>;
+    /** Inserts one validated envelope or acknowledges an exact idempotent replay. */
+    schedule(value: unknown): Promise<DyNTS_ApplicationAlertDeliveryView_Interface>;
+    /** Claims at most one due item or retires one exhausted crashed claim; it never waits or polls. */
+    claimNext(): Promise<DyNTS_ApplicationAlertClaim_Interface>;
+    /** Commits accepted, retryable or terminal delivery evidence under the live DB-time fence. */
+    complete(value: unknown): Promise<DyNTS_ApplicationAlertDeliveryView_Interface>;
+    /** Reads only within the configured source-system boundary. */
+    read(idempotencyKey: string): Promise<DyNTS_ApplicationAlertDeliveryView_Interface | null>;
+    /** Returns bounded aggregate delivery health without returning any alert or receiver content. */
+    inspect(): Promise<DyNTS_ApplicationAlertOperations_Interface>;
+    private retireExhausted;
+    private completion;
+    private submission;
+    private submissionOutcome;
+    private isExactCompletionReplay;
+    private assertReplay;
+    private assertRecord;
+    private recordStateValid;
+    private copyEnvelope;
+    private view;
+    private deliveryState;
+    private lastOutcome;
+    private exactRecord;
+    private key;
+    private tokenHash;
+    private databaseTime;
+    private positiveInteger;
+    private aggregateCount;
+    private date;
+    private collection;
+    private options;
+    private assertReady;
+    private protect;
+    private error;
+    private isMongoCode;
+    private validator;
+}
+//# sourceMappingURL=application-alert-delivery.mongo-store.d.ts.map

package/build/_modules/application-alert-delivery/application-alert-delivery.mongo-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-alert-delivery.mongo-store.d.ts","sourceRoot":"","sources":["../../../src/_modules/application-alert-delivery/application-alert-delivery.mongo-store.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,qCAAqC,EAGrC,gDAAgD,EAChD,4CAA4C,EAC5C,0CAA0C,EAE3C,MAAM,gDAAgD,CAAC;AAUxD,wEAAwE;AACxE,qBAAa,yCAAyC;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmD;IAC5E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;IACpE,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,SAAS,CAAC,CAAgB;IAElC,+FAA+F;gBAC5E,QAAQ,EAAE,gDAAgD;IAmB7E,2FAA2F;IAC9E,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAgDzC,iFAAiF;IACpE,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,4CAA4C,CAAC;IAoE5F,mGAAmG;IACtF,SAAS,IAAI,OAAO,CAAC,qCAAqC,CAAC;IA+ExE,8FAA8F;IACjF,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,4CAA4C,CAAC;IA2E5F,+DAA+D;IAClD,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,4CAA4C,GAAG,IAAI,CAAC;IAoBvG,iGAAiG;IACpF,OAAO,IAAI,OAAO,CAAC,0CAA0C,CAAC;YA6E7D,eAAe;IA8B7B,OAAO,CAAC,UAAU;IA6BlB,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,YAAY;IA2CpB,OAAO,CAAC,gBAAgB;IAuDxB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,IAAI;IAwBZ,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,SAAS;YAIH,YAAY;IAa1B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,WAAW;YAML,OAAO;IAYrB,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,SAAS;CA2DlB"}