@dudousxd/nestjs-durable 0.49.0 → 0.50.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { WorkflowCtx, SearchAttributes, WorkflowClass, StandardSchemaV1, StepError, OnErrorInput, WorkflowRef, SingletonConfig, ConcurrencyConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetailOptions, RunDetail, FanPageQuery, FanPage, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, WorkflowRun, TenantEvent } from '@dudousxd/nestjs-durable-core';
+import { WorkflowCtx, SearchAttributes, WorkflowClass, StandardSchemaV1, StepError, OnErrorInput, WorkflowRef, SingletonConfig, ConcurrencyConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, StalledRunInfo, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetailOptions, RunDetail, FanPageQuery, FanPage, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, WorkflowRun, TenantEvent } from '@dudousxd/nestjs-durable-core';
 export { AttributeFilter, DynamicWorkflowCtx, EngineEvent, InferSearchAttributes, OnErrorInput, RunDetail, RunGateway, RunListItem, RunQuery, RunStatus, RunWaiting, SearchAttributes, SearchAttributesSchema, StepCheckpoint, StepEvent, StepLogger, WorkflowCtx, WorkflowEngine, WorkflowHandler, WorkflowRun, readSearchAttributes } from '@dudousxd/nestjs-durable-core';
 import { z } from 'zod';
 import { ConcurrencyOption, StartRunDeps, RunRedisWorkerOptions, RunningWorker, DurableWorkerRuntime } from '@dudousxd/durable-worker';
@@ -597,6 +597,19 @@ interface DurableModuleOptions {
      * See `WorkflowEngineDeps.reconcileMs`. Operator only.
      */
     reconcileMs?: number;
+    /**
+     * Idle time (ms) before a stranded in-flight run is reported to {@link onStalled} listeners.
+     * Defaults to 900000 (15 min), floored at 60000. See `WorkflowEngineDeps.stalledAfterMs`.
+     * Operator only.
+     */
+    stalledAfterMs?: number;
+    /**
+     * Pager hook for stranded runs, registered on the engine as `engine.onStalled(...)`: a run
+     * suspended with no wake timer, or parked on an old pending remote step nothing is leasing. The
+     * timer poller sweeps once a minute and reports each stranded episode once per instance.
+     * Equivalent to calling `engine.onStalled` from a provider; only a DRIVING operator sweeps.
+     */
+    onStalled?: (info: StalledRunInfo) => void;
     /**
      * The most due timers one timer-poll pass loads and drives, most overdue first, so a wave of
      * thousands of due runs is worked through in batches. Defaults to 500; a non-finite or sub-1 value

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { WorkflowCtx, SearchAttributes, WorkflowClass, StandardSchemaV1, StepError, OnErrorInput, WorkflowRef, SingletonConfig, ConcurrencyConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetailOptions, RunDetail, FanPageQuery, FanPage, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, WorkflowRun, TenantEvent } from '@dudousxd/nestjs-durable-core';
+import { WorkflowCtx, SearchAttributes, WorkflowClass, StandardSchemaV1, StepError, OnErrorInput, WorkflowRef, SingletonConfig, ConcurrencyConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, StalledRunInfo, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetailOptions, RunDetail, FanPageQuery, FanPage, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, WorkflowRun, TenantEvent } from '@dudousxd/nestjs-durable-core';
 export { AttributeFilter, DynamicWorkflowCtx, EngineEvent, InferSearchAttributes, OnErrorInput, RunDetail, RunGateway, RunListItem, RunQuery, RunStatus, RunWaiting, SearchAttributes, SearchAttributesSchema, StepCheckpoint, StepEvent, StepLogger, WorkflowCtx, WorkflowEngine, WorkflowHandler, WorkflowRun, readSearchAttributes } from '@dudousxd/nestjs-durable-core';
 import { z } from 'zod';
 import { ConcurrencyOption, StartRunDeps, RunRedisWorkerOptions, RunningWorker, DurableWorkerRuntime } from '@dudousxd/durable-worker';
@@ -597,6 +597,19 @@ interface DurableModuleOptions {
      * See `WorkflowEngineDeps.reconcileMs`. Operator only.
      */
     reconcileMs?: number;
+    /**
+     * Idle time (ms) before a stranded in-flight run is reported to {@link onStalled} listeners.
+     * Defaults to 900000 (15 min), floored at 60000. See `WorkflowEngineDeps.stalledAfterMs`.
+     * Operator only.
+     */
+    stalledAfterMs?: number;
+    /**
+     * Pager hook for stranded runs, registered on the engine as `engine.onStalled(...)`: a run
+     * suspended with no wake timer, or parked on an old pending remote step nothing is leasing. The
+     * timer poller sweeps once a minute and reports each stranded episode once per instance.
+     * Equivalent to calling `engine.onStalled` from a provider; only a DRIVING operator sweeps.
+     */
+    onStalled?: (info: StalledRunInfo) => void;
     /**
      * The most due timers one timer-poll pass loads and drives, most overdue first, so a wave of
      * thousands of due runs is worked through in batches. Defaults to 500; a non-finite or sub-1 value

package/dist/index.js

@@ -2186,6 +2186,7 @@ var TimerPoller = class {
       await this.sweep("recoverIncomplete", () => this.engine.recoverIncomplete());
       await this.sweep("resumeDueTimers", () => this.engine.resumeDueTimers());
       await this.sweep("sweepTimeouts", () => this.engine.sweepTimeouts());
+      await this.sweep("sweepStalled", async () => this.engine.sweepStalled?.());
       const schedules = this.options.schedules;
       if (schedules && schedules.length > 0) {
         await this.sweep("schedules", () => runSchedules(this.engine, schedules, Date.now()));
@@ -2884,6 +2885,7 @@ var DurableModule = class _DurableModule {
               remoteRedispatchMs: options.remoteRedispatchMs,
               remoteRedispatchMax: options.remoteRedispatchMax,
               reconcileMs: options.reconcileMs,
+              stalledAfterMs: options.stalledAfterMs,
               timerBatchSize: options.timerBatchSize,
               eventBufferTtlMs: options.eventBufferTtlMs,
               blockedPollMs: options.blockedPollMs,
@@ -2907,6 +2909,7 @@ var DurableModule = class _DurableModule {
               } : void 0
             });
             for (const queue of options.queues ?? []) engine.registerQueue(queue);
+            if (options.onStalled) engine.onStalled(options.onStalled);
             return engine;
           }, "useFactory"),
           inject: [