@futdevpro/nts-dynamo 1.15.203 → 1.15.215

package/build/_modules/operation-control/_enums/operation-executor-code.type-enum.d.ts

@@ -0,0 +1,14 @@
+/** Stable content-free lifecycle outcomes. Provider/work payloads are never diagnostic values. */
+export declare enum DyNTS_OperationExecutorCode_Type {
+    succeeded = "succeeded",
+    failed = "failed",
+    cancelled = "cancelled",
+    retired = "retired",
+    leaseLost = "lease-lost",
+    notAcquired = "not-acquired",
+    recoveryRequired = "recovery-required",
+    shutdown = "shutdown",
+    timedOut = "timed-out",
+    storeFailed = "store-failed"
+}
+//# sourceMappingURL=operation-executor-code.type-enum.d.ts.map

package/build/_modules/operation-control/_enums/operation-executor-code.type-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-executor-code.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/operation-control/_enums/operation-executor-code.type-enum.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,oBAAY,gCAAgC;IAC1C,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,SAAS,eAAe;IACxB,WAAW,iBAAiB;IAC5B,gBAAgB,sBAAsB;IACtC,QAAQ,aAAa;IACrB,QAAQ,cAAc;IACtB,WAAW,iBAAiB;CAC7B"}

package/build/_modules/operation-control/_enums/operation-executor-code.type-enum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_OperationExecutorCode_Type = void 0;
+/** Stable content-free lifecycle outcomes. Provider/work payloads are never diagnostic values. */
+var DyNTS_OperationExecutorCode_Type;
+(function (DyNTS_OperationExecutorCode_Type) {
+    DyNTS_OperationExecutorCode_Type["succeeded"] = "succeeded";
+    DyNTS_OperationExecutorCode_Type["failed"] = "failed";
+    DyNTS_OperationExecutorCode_Type["cancelled"] = "cancelled";
+    DyNTS_OperationExecutorCode_Type["retired"] = "retired";
+    DyNTS_OperationExecutorCode_Type["leaseLost"] = "lease-lost";
+    DyNTS_OperationExecutorCode_Type["notAcquired"] = "not-acquired";
+    DyNTS_OperationExecutorCode_Type["recoveryRequired"] = "recovery-required";
+    DyNTS_OperationExecutorCode_Type["shutdown"] = "shutdown";
+    DyNTS_OperationExecutorCode_Type["timedOut"] = "timed-out";
+    DyNTS_OperationExecutorCode_Type["storeFailed"] = "store-failed";
+})(DyNTS_OperationExecutorCode_Type || (exports.DyNTS_OperationExecutorCode_Type = DyNTS_OperationExecutorCode_Type = {}));
+//# sourceMappingURL=operation-executor-code.type-enum.js.map

package/build/_modules/operation-control/_enums/operation-executor-code.type-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-executor-code.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/operation-control/_enums/operation-executor-code.type-enum.ts"],"names":[],"mappings":";;;AAAA,kGAAkG;AAClG,IAAY,gCAWX;AAXD,WAAY,gCAAgC;IAC1C,2DAAuB,CAAA;IACvB,qDAAiB,CAAA;IACjB,2DAAuB,CAAA;IACvB,uDAAmB,CAAA;IACnB,4DAAwB,CAAA;IACxB,gEAA4B,CAAA;IAC5B,0EAAsC,CAAA;IACtC,yDAAqB,CAAA;IACrB,0DAAsB,CAAA;IACtB,gEAA4B,CAAA;AAC9B,CAAC,EAXW,gCAAgC,gDAAhC,gCAAgC,QAW3C"}

package/build/_modules/operation-control/_models/operation-executor.interface.d.ts

@@ -0,0 +1,43 @@
+import { DyNTS_OperationExecutorCode_Type } from '../_enums/operation-executor-code.type-enum';
+import { DyNTS_Operation_MongoStore } from '../operation.mongo-store';
+import { DyNTS_OperationIdentity_Interface, DyNTS_OperationPublication_Interface, DyNTS_OperationReceipt_Interface } from './operation-store.interface';
+/** Result publication is database-only and uses the store's owning connection/session. */
+export interface DyNTS_OperationWorkResult_Interface {
+    readonly outcome: 'succeeded' | 'failed';
+    readonly publication?: DyNTS_OperationPublication_Interface;
+}
+/** Runtime limits are explicit, with at least three renewal opportunities per lease. */
+export interface DyNTS_OperationExecutorSettings_Interface {
+    readonly store: DyNTS_Operation_MongoStore;
+    readonly ownerId: string;
+    readonly leaseDurationMs: number;
+    readonly heartbeatIntervalMs: number;
+    readonly maxRunTimeMs: number;
+    readonly shutdownGraceMs: number;
+}
+/** Authorization and durable external-effect reconciliation remain the caller's responsibility. */
+export interface DyNTS_OperationExecution_Interface extends DyNTS_OperationIdentity_Interface {
+    /** Default forbids redispatch on any previously acquired identity, including voluntary abandonment. */
+    readonly recovery?: 'forbid-redispatch' | 'allow-idempotent-replay';
+    readonly work: (context: {
+        readonly signal: AbortSignal;
+        readonly fencingToken: number;
+        readonly isRecovery: boolean;
+    }) => Promise<DyNTS_OperationWorkResult_Interface>;
+}
+/** A non-drained work callback is a visible fatal lifecycle condition, NOT successful termination. */
+export interface DyNTS_OperationExecutionResult_Interface {
+    readonly contractVersion: 'dynts-operation-execution/1';
+    readonly code: `${DyNTS_OperationExecutorCode_Type}`;
+    readonly isWorkDrained: boolean;
+    readonly receipt: DyNTS_OperationReceipt_Interface | null;
+}
+/** Content-free process-local status; durable authority is always checked through the store. */
+export interface DyNTS_OperationExecutorStatus_Interface {
+    readonly isRunning: boolean;
+    readonly isClosed: boolean;
+    readonly isWorkDrained: boolean;
+    readonly activeStoreCalls: number;
+    readonly activeTimers: number;
+}
+//# sourceMappingURL=operation-executor.interface.d.ts.map

package/build/_modules/operation-control/_models/operation-executor.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-executor.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/operation-control/_models/operation-executor.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAC;AAC/F,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EACL,iCAAiC,EACjC,oCAAoC,EACpC,gCAAgC,EACjC,MAAM,6BAA6B,CAAC;AAErC,0FAA0F;AAC1F,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,oCAAoC,CAAC;CAC7D;AAED,wFAAwF;AACxF,MAAM,WAAW,yCAAyC;IACxD,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,mGAAmG;AACnG,MAAM,WAAW,kCAAmC,SAAQ,iCAAiC;IAC3F,uGAAuG;IACvG,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,yBAAyB,CAAC;IACpE,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE;QACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;QAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;KAC9B,KAAK,OAAO,CAAC,mCAAmC,CAAC,CAAC;CACpD;AAED,sGAAsG;AACtG,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,eAAe,EAAE,6BAA6B,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE,GAAG,gCAAgC,EAAE,CAAC;IACrD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,gCAAgC,GAAG,IAAI,CAAC;CAC3D;AAED,gGAAgG;AAChG,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B"}

package/build/_modules/operation-control/_models/operation-executor.interface.js

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

package/build/_modules/operation-control/_models/operation-executor.interface.js.map

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

package/build/_modules/operation-control/_models/operation-host.interface.d.ts

@@ -0,0 +1,23 @@
+import { DyNTS_OperationExecutorSettings_Interface } from './operation-executor.interface';
+/** Process-local capacity is explicit caller policy, not a product subscription limit. */
+export interface DyNTS_OperationHostSettings_Interface extends DyNTS_OperationExecutorSettings_Interface {
+    readonly maxActiveOperations: number;
+}
+/** Counts only; contains no operation identity, work payload or provider error. */
+export interface DyNTS_OperationHostStatus_Interface {
+    readonly contractVersion: 'dynts-operation-host-status/1';
+    readonly isClosed: boolean;
+    readonly isDrained: boolean;
+    readonly activeOperationCount: number;
+    readonly undrainedWorkCount: number;
+    readonly activeStoreCalls: number;
+    readonly activeTimers: number;
+    readonly activeShutdownCalls: number;
+}
+/** Resource drainage and successful shutdown calls are distinct; both are required for completion. */
+export interface DyNTS_OperationHostShutdown_Interface extends Omit<DyNTS_OperationHostStatus_Interface, 'contractVersion'> {
+    readonly contractVersion: 'dynts-operation-host-shutdown/1';
+    readonly isShutdownComplete: boolean;
+    readonly failedShutdownCount: number;
+}
+//# sourceMappingURL=operation-host.interface.d.ts.map

package/build/_modules/operation-control/_models/operation-host.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-host.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/operation-control/_models/operation-host.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yCAAyC,EAAE,MAAM,gCAAgC,CAAC;AAE3F,0FAA0F;AAC1F,MAAM,WAAW,qCAAsC,SAAQ,yCAAyC;IACtG,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,mFAAmF;AACnF,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,eAAe,EAAE,+BAA+B,CAAC;IAC1D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,sGAAsG;AACtG,MAAM,WAAW,qCAAsC,SACrD,IAAI,CAAC,mCAAmC,EAAE,iBAAiB,CAAC;IAC5D,QAAQ,CAAC,eAAe,EAAE,iCAAiC,CAAC;IAC5D,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC"}

package/build/_modules/operation-control/_models/operation-host.interface.js

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

package/build/_modules/operation-control/_models/operation-host.interface.js.map

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

package/build/_modules/operation-control/_models/operation-store.interface.d.ts

@@ -0,0 +1,48 @@
+import { ClientSession, Connection } from 'mongoose';
+import { DyFM_OperationCommand_Type, DyFM_OperationDecision_Interface, DyFM_OperationRecord_Interface } from '@futdevpro/fsm-dynamo/operation-control';
+/** Authorize and derive the opaque scope first; register mints the operation ID in the product transaction. */
+export interface DyNTS_OperationIdentity_Interface {
+    readonly scopeHash: string;
+    readonly operationId: string;
+}
+/** Retirement ends replay/dispatch authority. Erasure must wait for every previously issued lease to expire. */
+export interface DyNTS_OperationRetirement_Interface extends DyNTS_OperationIdentity_Interface {
+    readonly contractVersion: 'dynts-operation-retirement/1';
+    readonly retiredAtMs: number;
+    readonly eraseNotBeforeMs: number;
+}
+/** A bounded erasure step. Only a completed step removes the identity; incomplete batches are safely resumable. */
+export interface DyNTS_OperationErasure_Interface {
+    readonly contractVersion: 'dynts-operation-erasure/1';
+    readonly isComplete: boolean;
+    readonly deletedReceiptCount: number;
+    readonly deletedIdentityCount: number;
+}
+/** Database-only callback. It may be replayed after an aborted transaction: NEVER perform external effects here. */
+export interface DyNTS_OperationPublication_Interface {
+    readonly checksum: string;
+    readonly write: (context: {
+        readonly session: ClientSession;
+        readonly connection: Connection;
+        readonly command: DyFM_OperationCommand_Type;
+        readonly fencingToken: number;
+    }) => Promise<void>;
+}
+/** Historical receipt, NOT proof of current ownership or permission to redispatch a provider request. */
+export interface DyNTS_OperationReceipt_Interface {
+    readonly contractVersion: 'dynts-operation-receipt/1';
+    readonly command: DyFM_OperationCommand_Type;
+    readonly publicationChecksum: string | null;
+    readonly previousRecord: DyFM_OperationRecord_Interface | null;
+    readonly decidedAtMs: number;
+    readonly decision: DyFM_OperationDecision_Interface;
+}
+/** Policy is explicit; no product limit or implicit global Mongo connection is chosen by the store. */
+export interface DyNTS_OperationStoreSettings_Interface {
+    readonly connection: Connection;
+    readonly issuer: string;
+    readonly maxLeaseDurationMs: number;
+    readonly maxTransactionAttempts: number;
+    readonly maxCommitTimeMs: number;
+}
+//# sourceMappingURL=operation-store.interface.d.ts.map

package/build/_modules/operation-control/_models/operation-store.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-store.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/operation-control/_models/operation-store.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAErD,OAAO,EACL,0BAA0B,EAC1B,gCAAgC,EAChC,8BAA8B,EAC/B,MAAM,yCAAyC,CAAC;AAEjD,+GAA+G;AAC/G,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,gHAAgH;AAChH,MAAM,WAAW,mCAAoC,SAAQ,iCAAiC;IAC5F,QAAQ,CAAC,eAAe,EAAE,8BAA8B,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,mHAAmH;AACnH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,eAAe,EAAE,2BAA2B,CAAC;IACtD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,oHAAoH;AACpH,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE;QACxB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;QAChC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;QAChC,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;QAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;KAC/B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAED,yGAAyG;AACzG,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,eAAe,EAAE,2BAA2B,CAAC;IACtD,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,8BAA8B,GAAG,IAAI,CAAC;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,gCAAgC,CAAC;CACrD;AAED,uGAAuG;AACvG,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC"}

package/build/_modules/operation-control/_models/operation-store.interface.js

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

package/build/_modules/operation-control/_models/operation-store.interface.js.map

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

package/build/_modules/operation-control/index.d.ts

@@ -0,0 +1,8 @@
+export * from './_models/operation-store.interface';
+export * from './_models/operation-executor.interface';
+export * from './_models/operation-host.interface';
+export * from './_enums/operation-executor-code.type-enum';
+export * from './operation-executor.control-service';
+export * from './operation-host.control-service';
+export * from './operation.mongo-store';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/operation-control/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/operation-control/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,yBAAyB,CAAC"}

package/build/_modules/operation-control/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./_models/operation-store.interface"), exports);
+tslib_1.__exportStar(require("./_models/operation-executor.interface"), exports);
+tslib_1.__exportStar(require("./_models/operation-host.interface"), exports);
+tslib_1.__exportStar(require("./_enums/operation-executor-code.type-enum"), exports);
+tslib_1.__exportStar(require("./operation-executor.control-service"), exports);
+tslib_1.__exportStar(require("./operation-host.control-service"), exports);
+tslib_1.__exportStar(require("./operation.mongo-store"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/operation-control/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/operation-control/index.ts"],"names":[],"mappings":";;;AAAA,8EAAoD;AACpD,iFAAuD;AACvD,6EAAmD;AACnD,qFAA2D;AAC3D,+EAAqD;AACrD,2EAAiD;AACjD,kEAAwC"}

package/build/_modules/operation-control/operation-executor.control-service.d.ts

@@ -0,0 +1,49 @@
+import { DyNTS_OperationExecution_Interface, DyNTS_OperationExecutionResult_Interface, DyNTS_OperationExecutorSettings_Interface, DyNTS_OperationExecutorStatus_Interface } from './_models/operation-executor.interface';
+/**
+ * One visible, single-use execution lifecycle. It owns renewal/cancellation observation, timers and provider abort.
+ * Work MUST cooperate with AbortSignal. Non-drained work remains visible; a host must retire that worker process.
+ * Mongo operations also require bounded connection/driver timeouts; shutdown never pretends a hung call drained.
+ */
+export declare class DyNTS_OperationExecutor_ControlService {
+    private readonly settings;
+    private readonly workAbort;
+    private readonly heartbeatAbort;
+    private readonly timers;
+    private readonly graceTimers;
+    private isStarted;
+    private isRunning;
+    private isClosed;
+    private isWorkDrained;
+    private activeStoreCalls;
+    private stopCode?;
+    private identity?;
+    private fencingToken?;
+    private lastReceipt;
+    private leaseTimer?;
+    private completion?;
+    private workCompletion?;
+    /** Requires direct Bedrock storage, explicit finite budgets and a server-owned opaque instance identity. */
+    constructor(settings: DyNTS_OperationExecutorSettings_Interface);
+    /** Shared host composition validates the exact same executor budgets before admitting any work. */
+    static assertSettings(settings: DyNTS_OperationExecutorSettings_Interface): void;
+    /** Starts exactly once; every acquire/renew request has a fresh identity, never an old acquire replay. */
+    run(execution: DyNTS_OperationExecution_Interface): Promise<DyNTS_OperationExecutionResult_Interface>;
+    /** Abort local work, then wait only the configured grace. False means the host MUST NOT declare shutdown complete. */
+    shutdown(): Promise<boolean>;
+    /** Exposes unsettled work and database operations without raw reasons, payloads, errors or environment details. */
+    getStatus(): DyNTS_OperationExecutorStatus_Interface;
+    private execute;
+    private acquireAndWork;
+    private renew;
+    private heartbeat;
+    private waitInterval;
+    private waitWork;
+    private waitGrace;
+    private stopForStoreError;
+    private stop;
+    private schedule;
+    private command;
+    private call;
+    private result;
+}
+//# sourceMappingURL=operation-executor.control-service.d.ts.map

package/build/_modules/operation-control/operation-executor.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-executor.control-service.d.ts","sourceRoot":"","sources":["../../../src/_modules/operation-control/operation-executor.control-service.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,kCAAkC,EAClC,wCAAwC,EACxC,yCAAyC,EACzC,uCAAuC,EAExC,MAAM,wCAAwC,CAAC;AAGhD;;;;GAIG;AACH,qBAAa,sCAAsC;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IACpE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0C;IACzE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;IACxE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAC7E,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,CAAwC;IACzD,OAAO,CAAC,QAAQ,CAAC,CAAqC;IACtD,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAiD;IACpE,OAAO,CAAC,UAAU,CAAC,CAAgC;IACnD,OAAO,CAAC,UAAU,CAAC,CAAoD;IACvE,OAAO,CAAC,cAAc,CAAC,CAA+C;IAEtE,4GAA4G;gBAChG,QAAQ,EAAE,yCAAyC;IAK/D,mGAAmG;WACrF,cAAc,CAAC,QAAQ,EAAE,yCAAyC,GAAG,IAAI;IAUvF,0GAA0G;IACnG,GAAG,CAAC,SAAS,EAAE,kCAAkC,GAAG,OAAO,CAAC,wCAAwC,CAAC;IAmB5G,sHAAsH;IACzG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBzC,mHAAmH;IAC5G,SAAS,IAAI,uCAAuC;YAO7C,OAAO;YAkDP,cAAc;YA2Dd,KAAK;YA4BL,SAAS;YAcT,YAAY;YAqBZ,QAAQ;YAkBR,SAAS;IAevB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,OAAO;YAiBD,IAAI;IAgBlB,OAAO,CAAC,MAAM;CAMf"}

package/build/_modules/operation-control/operation-executor.control-service.js

@@ -0,0 +1,311 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_OperationExecutor_ControlService = void 0;
+const node_crypto_1 = require("node:crypto");
+const node_perf_hooks_1 = require("node:perf_hooks");
+/**
+ * One visible, single-use execution lifecycle. It owns renewal/cancellation observation, timers and provider abort.
+ * Work MUST cooperate with AbortSignal. Non-drained work remains visible; a host must retire that worker process.
+ * Mongo operations also require bounded connection/driver timeouts; shutdown never pretends a hung call drained.
+ */
+class DyNTS_OperationExecutor_ControlService {
+    settings;
+    workAbort = new AbortController();
+    heartbeatAbort = new AbortController();
+    timers = new Set();
+    graceTimers = new Set();
+    isStarted = false;
+    isRunning = false;
+    isClosed = false;
+    isWorkDrained = true;
+    activeStoreCalls = 0;
+    stopCode;
+    identity;
+    fencingToken;
+    lastReceipt = null;
+    leaseTimer;
+    completion;
+    workCompletion;
+    /** Requires direct Bedrock storage, explicit finite budgets and a server-owned opaque instance identity. */
+    constructor(settings) {
+        DyNTS_OperationExecutor_ControlService.assertSettings(settings);
+        this.settings = Object.freeze({ ...settings });
+    }
+    /** Shared host composition validates the exact same executor budgets before admitting any work. */
+    static assertSettings(settings) {
+        if (!settings?.store || !/^[0-9a-f]{64}$/u.test(settings.ownerId)
+            || ![settings.leaseDurationMs, settings.heartbeatIntervalMs, settings.maxRunTimeMs,
+                settings.shutdownGraceMs].every((value) => Number.isSafeInteger(value) && value > 0 && value <= 2_147_483_647)
+            || settings.heartbeatIntervalMs * 3 > settings.leaseDurationMs) {
+            throw new Error('DyNTS|OPERATION_EXECUTOR|INVALID_SETTINGS');
+        }
+    }
+    /** Starts exactly once; every acquire/renew request has a fresh identity, never an old acquire replay. */
+    run(execution) {
+        if (this.isStarted || this.isClosed) {
+            throw new Error('DyNTS|OPERATION_EXECUTOR|CLOSED');
+        }
+        if (!execution || !/^[0-9a-f]{64}$/u.test(execution.scopeHash)
+            || !/^[0-9a-f]{64}$/u.test(execution.operationId) || typeof execution.work !== 'function'
+            || (execution.recovery !== undefined && execution.recovery !== 'forbid-redispatch'
+                && execution.recovery !== 'allow-idempotent-replay')) {
+            throw new Error('DyNTS|OPERATION_EXECUTOR|INVALID_EXECUTION');
+        }
+        this.isStarted = true;
+        this.isRunning = true;
+        this.identity = Object.freeze({ ...execution });
+        this.completion = this.execute();
+        return this.completion;
+    }
+    /** Abort local work, then wait only the configured grace. False means the host MUST NOT declare shutdown complete. */
+    async shutdown() {
+        this.isClosed = true;
+        this.stop('shutdown');
+        const tasks = [];
+        if (this.completion) {
+            tasks.push(this.completion);
+        }
+        if (this.workCompletion) {
+            tasks.push(this.workCompletion);
+        }
+        await this.waitGrace(Promise.all(tasks));
+        return !this.isRunning && this.isWorkDrained && this.activeStoreCalls === 0;
+    }
+    /** Exposes unsettled work and database operations without raw reasons, payloads, errors or environment details. */
+    getStatus() {
+        return Object.freeze({
+            isRunning: this.isRunning, isClosed: this.isClosed, isWorkDrained: this.isWorkDrained,
+            activeStoreCalls: this.activeStoreCalls, activeTimers: this.timers.size + this.graceTimers.size,
+        });
+    }
+    async execute() {
+        this.schedule(() => this.stop('timed-out'), this.settings.maxRunTimeMs);
+        let code = 'store-failed';
+        let isTerminalCommitted = false;
+        try {
+            code = await this.acquireAndWork();
+            isTerminalCommitted = this.lastReceipt?.decision.accepted && this.lastReceipt.decision.code === 'completed';
+        }
+        catch (error) {
+            this.stopForStoreError(error);
+            code = this.stopCode ?? 'store-failed';
+        }
+        finally {
+            this.heartbeatAbort.abort();
+            if (!isTerminalCommitted) {
+                this.stop(code);
+                if (this.workCompletion && !this.isWorkDrained) {
+                    await this.waitGrace(this.workCompletion);
+                }
+                // Uncooperative work keeps its lease until expiry; no optimistic release or automatic redispatch.
+                if (this.fencingToken !== undefined && this.isWorkDrained) {
+                    try {
+                        await this.call(this.command('abandon'));
+                    }
+                    catch (error) {
+                        if (!(error instanceof Error && ['DyNTS|OPERATION_STORE|RETIRED',
+                            'DyNTS|OPERATION_STORE|NOT_REGISTERED'].includes(error.message))) {
+                            code = 'store-failed';
+                        }
+                    }
+                }
+            }
+            for (const timer of this.timers) {
+                clearTimeout(timer);
+            }
+            this.timers.clear();
+            this.isRunning = false;
+            this.isClosed = true;
+            this.identity = undefined;
+            if (this.isWorkDrained) {
+                this.workCompletion = undefined;
+            }
+        }
+        return this.result(code);
+    }
+    async acquireAndWork() {
+        const acquired = await this.call(this.command('acquire'));
+        if (!acquired.decision.accepted || acquired.decision.code !== 'acquired') {
+            return acquired.decision.record?.state === 'cancelled' ? 'cancelled' : 'not-acquired';
+        }
+        this.fencingToken = acquired.decision.record.fencingToken;
+        const isRecovery = acquired.previousRecord !== null;
+        if (isRecovery && this.identity.recovery !== 'allow-idempotent-replay') {
+            return 'recovery-required';
+        }
+        if (this.workAbort.signal.aborted || !await this.renew()) {
+            return this.stopCode ?? 'lease-lost';
+        }
+        this.isWorkDrained = false;
+        this.workCompletion = Promise.resolve().then(async () => {
+            if (this.workAbort.signal.aborted) {
+                return { outcome: 'failed' };
+            }
+            try {
+                const value = await this.identity.work(Object.freeze({
+                    signal: this.workAbort.signal, fencingToken: this.fencingToken, isRecovery: isRecovery,
+                }));
+                return value?.outcome === 'succeeded' || value?.outcome === 'failed' ? value : { outcome: 'failed' };
+            }
+            catch {
+                return { outcome: 'failed' };
+            }
+        }).finally(() => {
+            this.isWorkDrained = true;
+            if (this.isClosed) {
+                this.workCompletion = undefined;
+            }
+        });
+        const heartbeat = this.heartbeat();
+        try {
+            const work = await this.waitWork();
+            this.heartbeatAbort.abort();
+            await heartbeat;
+            if (this.workAbort.signal.aborted || work === null) {
+                return this.stopCode ?? 'lease-lost';
+            }
+            // Cancellation versus completion is decided by the durable transaction, never by the local signal alone.
+            const completed = await this.call(this.command('complete', work.outcome), work);
+            return completed.decision.accepted && completed.decision.code === 'completed' ? work.outcome
+                : completed.decision.record?.state === 'cancelled' ? 'cancelled' : 'lease-lost';
+        }
+        finally {
+            this.heartbeatAbort.abort();
+            await heartbeat;
+        }
+    }
+    async renew() {
+        const startedAt = node_perf_hooks_1.performance.now();
+        const receipt = await this.call(this.command('renew'));
+        if (!receipt.decision.accepted || receipt.decision.code !== 'renewed') {
+            this.stop(receipt.decision.record?.state === 'cancelled' ? 'cancelled' : 'lease-lost');
+            return false;
+        }
+        // Request START, not response arrival: transport latency must never extend local permission to run work.
+        const remainingMs = receipt.decision.record.leaseExpiresAtMs - receipt.decidedAtMs
+            - (node_perf_hooks_1.performance.now() - startedAt);
+        if (this.leaseTimer) {
+            clearTimeout(this.leaseTimer);
+            this.timers.delete(this.leaseTimer);
+        }
+        if (remainingMs <= 0) {
+            this.stop('lease-lost');
+            return false;
+        }
+        this.leaseTimer = this.schedule(() => this.stop('lease-lost'), remainingMs);
+        return !this.workAbort.signal.aborted;
+    }
+    async heartbeat() {
+        try {
+            while (!this.heartbeatAbort.signal.aborted && !this.workAbort.signal.aborted) {
+                await this.waitInterval();
+                if (this.heartbeatAbort.signal.aborted || this.workAbort.signal.aborted || !await this.renew()) {
+                    return;
+                }
+            }
+        }
+        catch (error) {
+            this.stopForStoreError(error);
+        }
+    }
+    async waitInterval() {
+        await new Promise((resolve) => {
+            /** Releases both cancellation listeners on either abort or elapsed interval. */
+            const finish = () => {
+                clearTimeout(timer);
+                this.timers.delete(timer);
+                this.heartbeatAbort.signal.removeEventListener('abort', finish);
+                this.workAbort.signal.removeEventListener('abort', finish);
+                resolve();
+            };
+            const timer = this.schedule(finish, this.settings.heartbeatIntervalMs);
+            this.heartbeatAbort.signal.addEventListener('abort', finish, { once: true });
+            this.workAbort.signal.addEventListener('abort', finish, { once: true });
+            if (this.heartbeatAbort.signal.aborted || this.workAbort.signal.aborted) {
+                finish();
+            }
+        });
+    }
+    async waitWork() {
+        let onAbort;
+        const aborted = new Promise((resolve) => {
+            onAbort = () => resolve(null);
+            this.workAbort.signal.addEventListener('abort', onAbort, { once: true });
+            if (this.workAbort.signal.aborted) {
+                onAbort();
+            }
+        });
+        try {
+            return await Promise.race([this.workCompletion, aborted]);
+        }
+        finally {
+            this.workAbort.signal.removeEventListener('abort', onAbort);
+        }
+    }
+    async waitGrace(task) {
+        let timer;
+        const elapsed = new Promise((resolve) => {
+            timer = setTimeout(resolve, this.settings.shutdownGraceMs);
+            this.graceTimers.add(timer);
+        });
+        try {
+            await Promise.race([task, elapsed]);
+        }
+        finally {
+            clearTimeout(timer);
+            this.graceTimers.delete(timer);
+        }
+    }
+    stopForStoreError(error) {
+        this.stop(error instanceof Error && error.message === 'DyNTS|OPERATION_STORE|RETIRED' ? 'retired'
+            : error instanceof Error && error.message === 'DyNTS|OPERATION_STORE|NOT_REGISTERED'
+                ? 'lease-lost' : 'store-failed');
+    }
+    stop(code) {
+        if (!this.stopCode) {
+            this.stopCode = code;
+            this.workAbort.abort();
+        }
+    }
+    schedule(callback, durationMs) {
+        const timer = setTimeout(() => {
+            this.timers.delete(timer);
+            callback();
+        }, Math.max(1, Math.floor(durationMs)));
+        this.timers.add(timer);
+        return timer;
+    }
+    command(kind, outcome) {
+        const base = {
+            contractVersion: 'dyfm-operation-command/1', scopeHash: this.identity.scopeHash,
+            operationId: this.identity.operationId,
+            requestId: (0, node_crypto_1.createHash)('sha256').update((0, node_crypto_1.randomUUID)()).digest('hex'), ownerId: this.settings.ownerId,
+        };
+        switch (kind) {
+            case 'acquire': return { ...base, kind: kind, leaseDurationMs: this.settings.leaseDurationMs };
+            case 'renew': return { ...base, kind: kind, fencingToken: this.fencingToken,
+                leaseDurationMs: this.settings.leaseDurationMs };
+            case 'complete': return { ...base, kind: kind, fencingToken: this.fencingToken, outcome: outcome };
+            case 'abandon': return { ...base, kind: kind, fencingToken: this.fencingToken };
+        }
+    }
+    async call(command, work) {
+        this.activeStoreCalls += 1;
+        try {
+            const receipt = await this.settings.store.execute(command, work?.publication);
+            this.lastReceipt = receipt;
+            return receipt;
+        }
+        finally {
+            this.activeStoreCalls -= 1;
+        }
+    }
+    result(code) {
+        return Object.freeze({
+            contractVersion: 'dynts-operation-execution/1', code: code,
+            isWorkDrained: this.isWorkDrained, receipt: this.lastReceipt,
+        });
+    }
+}
+exports.DyNTS_OperationExecutor_ControlService = DyNTS_OperationExecutor_ControlService;
+//# sourceMappingURL=operation-executor.control-service.js.map

package/build/_modules/operation-control/operation-executor.control-service.js.map

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