@dudousxd/nestjs-durable 0.43.1 → 0.44.0

package/dist/index.d.cts

@@ -464,6 +464,26 @@ interface DurableModuleOptions {
      * Operator only.
      */
     remoteAdvanceSilenceMs?: number;
+    /**
+     * Opt-in self-heal window (ms) for a dispatched remote step whose job was LOST — the worker was
+     * killed mid-step (an OOM kill leaves no result, and a non-TS consumer has no way to bridge the
+     * job's terminal failure back into one), or the broker dropped the job. The `pending` checkpoint
+     * then has nothing left to settle it, so the run waits forever. When set, the pending checkpoint
+     * carries a LEASE: a result — or a step-scoped heartbeat, which renews it, so a worker still
+     * holding the step is never double-dispatched — must land within the window, else the engine
+     * re-dispatches the same step (bumping `attempts`, bounded by {@link remoteRedispatchMax}).
+     * Covers both `ctx.step` and a polyglot workflow's `call` fan-out (`ctx.gather_calls`).
+     *
+     * Off by default: a re-dispatch double-runs a step whose original job was merely SLOW, so the
+     * window MUST exceed your longest remote step and the step MUST be idempotent. Operator only.
+     */
+    remoteRedispatchMs?: number;
+    /**
+     * Max times {@link remoteRedispatchMs} re-dispatches one lost step before failing it
+     * (`remote_step_lost`, surfaced on the run) instead of re-dispatching forever. Defaults to 10.
+     * Ignored when `remoteRedispatchMs` is unset. Operator only.
+     */
+    remoteRedispatchMax?: number;
     /**
      * The **default** workflow to route dead-lettered runs to, for workflows that don't declare their
      * own. When a run is moved to `dead` (exceeded `maxRecoveryAttempts`), the started handler gets a
@@ -708,6 +728,12 @@ declare class DurableStartClient {
  * fake so no real Redis is needed.
  */
 declare const RUN_REDIS_WORKER: unique symbol;
+/**
+ * The store-less {@link DurableWorkerRuntime} a pure thin worker registers its bodies on — `null` in
+ * every other role. A Symbol rather than the class itself: the class lives in an optional peer, and
+ * using it as a DI token would drag that peer into the package's static import graph.
+ */
+declare const DURABLE_WORKER_RUNTIME: unique symbol;
 /** The list of started {@link RunningWorker} handles (the single handle {@link ThinWorkerBootstrap}
  *  starts), closed on shutdown. */
 declare const DURABLE_WORKER_RUNNERS: unique symbol;
@@ -724,7 +750,7 @@ declare class ThinWorkflowRegistrar implements OnModuleInit {
     private readonly discovery;
     private readonly runtime;
     private readonly options;
-    constructor(discovery: DiscoveryService, runtime: DurableWorkerRuntime, options: DurableModuleOptions);
+    constructor(discovery: DiscoveryService, runtime: DurableWorkerRuntime | null, options: DurableModuleOptions);
     onModuleInit(): void;
 }
 /**
@@ -738,7 +764,7 @@ declare class ThinStepRegistrar implements OnModuleInit {
     private readonly metadataScanner;
     private readonly runtime;
     private readonly options;
-    constructor(discovery: DiscoveryService, metadataScanner: MetadataScanner, runtime: DurableWorkerRuntime, options: DurableModuleOptions);
+    constructor(discovery: DiscoveryService, metadataScanner: MetadataScanner, runtime: DurableWorkerRuntime | null, options: DurableModuleOptions);
     onModuleInit(): void;
 }
 /**
@@ -757,7 +783,7 @@ declare class ThinWorkerBootstrap implements OnApplicationBootstrap, OnApplicati
     private readonly runRedisWorker;
     private readonly runnersSink;
     private readonly runners;
-    constructor(runtime: DurableWorkerRuntime, options: DurableModuleOptions, runRedisWorker: RunRedisWorkerFn, runnersSink: RunningWorker[]);
+    constructor(runtime: DurableWorkerRuntime | null, options: DurableModuleOptions, runRedisWorker: RunRedisWorkerFn, runnersSink: RunningWorker[]);
     onApplicationBootstrap(): Promise<void>;
     onApplicationShutdown(): Promise<void>;
 }
@@ -864,7 +890,7 @@ declare class InAppWorkerBootstrap implements OnModuleInit, OnApplicationBootstr
     private readonly runRedisWorker;
     private readonly runnersSink;
     private readonly runners;
-    constructor(discovery: DiscoveryService, metadataScanner: MetadataScanner, options: DurableModuleOptions, runtime: DurableWorkerRuntime, runRedisWorker: RunRedisWorkerFn, runnersSink: RunningWorker[]);
+    constructor(discovery: DiscoveryService, metadataScanner: MetadataScanner, options: DurableModuleOptions, runtime: DurableWorkerRuntime | null, runRedisWorker: RunRedisWorkerFn, runnersSink: RunningWorker[]);
     onModuleInit(): void;
     onApplicationBootstrap(): Promise<void>;
     onApplicationShutdown(): Promise<void>;
@@ -1150,4 +1176,4 @@ declare class WorkflowService {
     }): Promise<number>;
 }
 
-export { CONTEXT_ACCESSOR, type ContextAccessor, type ContextStore, DEAD_LETTER_METADATA, DURABLE_STEP_METADATA, DURABLE_WORKER_RUNNERS, DeadLetter, DurableModule, type DurableModuleAsyncOptions, type DurableModuleOptions, type DurableRetentionOptions, DurableStartClient, DurableStep, type DurableStepInterceptor, type DurableStepMeta, ENTITY_METADATA, ENTITY_ON_METADATA, Entity, EntityService, IN_APP_RUN_REDIS_WORKER, IN_APP_WORKER_BINDING, IN_APP_WORKER_RUNNERS, IN_APP_WORKER_RUNTIME, type InAppWorkerBinding, InAppWorkerBootstrap, ON_EVENT_METADATA, On, OnDurableEvent, OnEvent, ProxyRunGateway, RUN_GATEWAY, RUN_REDIS_WORKER, type RunLookupStore, type RunRedisWorkerFn, RunRequestResponder, type RunRequestTransport, STEP_INTERCEPTOR_METADATA, Step, StepInterceptor, type StepOptions, StoreRunGateway, TenantEventRepublisher, ThinStepRegistrar, ThinWorkerBootstrap, ThinWorkflowRegistrar, type UserRef, WORKFLOW_METADATA, Workflow, type WorkflowAttributesOf, type WorkflowMeta, type WorkflowOptions, WorkflowService, attributesOf, entityConfigFor, getDurableStepMeta, getEntityMeta, getOnEvents, getWorkflowMeta, inAppWorkerProviders, isDeadLetterHandler, isDrivingOperator, isOperatorRole, isStepInterceptor, thinWorkerProviders, unavailableRunGateway };
+export { CONTEXT_ACCESSOR, type ContextAccessor, type ContextStore, DEAD_LETTER_METADATA, DURABLE_STEP_METADATA, DURABLE_WORKER_RUNNERS, DURABLE_WORKER_RUNTIME, DeadLetter, DurableModule, type DurableModuleAsyncOptions, type DurableModuleOptions, type DurableRetentionOptions, DurableStartClient, DurableStep, type DurableStepInterceptor, type DurableStepMeta, ENTITY_METADATA, ENTITY_ON_METADATA, Entity, EntityService, IN_APP_RUN_REDIS_WORKER, IN_APP_WORKER_BINDING, IN_APP_WORKER_RUNNERS, IN_APP_WORKER_RUNTIME, type InAppWorkerBinding, InAppWorkerBootstrap, ON_EVENT_METADATA, On, OnDurableEvent, OnEvent, ProxyRunGateway, RUN_GATEWAY, RUN_REDIS_WORKER, type RunLookupStore, type RunRedisWorkerFn, RunRequestResponder, type RunRequestTransport, STEP_INTERCEPTOR_METADATA, Step, StepInterceptor, type StepOptions, StoreRunGateway, TenantEventRepublisher, ThinStepRegistrar, ThinWorkerBootstrap, ThinWorkflowRegistrar, type UserRef, WORKFLOW_METADATA, Workflow, type WorkflowAttributesOf, type WorkflowMeta, type WorkflowOptions, WorkflowService, attributesOf, entityConfigFor, getDurableStepMeta, getEntityMeta, getOnEvents, getWorkflowMeta, inAppWorkerProviders, isDeadLetterHandler, isDrivingOperator, isOperatorRole, isStepInterceptor, thinWorkerProviders, unavailableRunGateway };

package/dist/index.d.ts

@@ -464,6 +464,26 @@ interface DurableModuleOptions {
      * Operator only.
      */
     remoteAdvanceSilenceMs?: number;
+    /**
+     * Opt-in self-heal window (ms) for a dispatched remote step whose job was LOST — the worker was
+     * killed mid-step (an OOM kill leaves no result, and a non-TS consumer has no way to bridge the
+     * job's terminal failure back into one), or the broker dropped the job. The `pending` checkpoint
+     * then has nothing left to settle it, so the run waits forever. When set, the pending checkpoint
+     * carries a LEASE: a result — or a step-scoped heartbeat, which renews it, so a worker still
+     * holding the step is never double-dispatched — must land within the window, else the engine
+     * re-dispatches the same step (bumping `attempts`, bounded by {@link remoteRedispatchMax}).
+     * Covers both `ctx.step` and a polyglot workflow's `call` fan-out (`ctx.gather_calls`).
+     *
+     * Off by default: a re-dispatch double-runs a step whose original job was merely SLOW, so the
+     * window MUST exceed your longest remote step and the step MUST be idempotent. Operator only.
+     */
+    remoteRedispatchMs?: number;
+    /**
+     * Max times {@link remoteRedispatchMs} re-dispatches one lost step before failing it
+     * (`remote_step_lost`, surfaced on the run) instead of re-dispatching forever. Defaults to 10.
+     * Ignored when `remoteRedispatchMs` is unset. Operator only.
+     */
+    remoteRedispatchMax?: number;
     /**
      * The **default** workflow to route dead-lettered runs to, for workflows that don't declare their
      * own. When a run is moved to `dead` (exceeded `maxRecoveryAttempts`), the started handler gets a
@@ -708,6 +728,12 @@ declare class DurableStartClient {
  * fake so no real Redis is needed.
  */
 declare const RUN_REDIS_WORKER: unique symbol;
+/**
+ * The store-less {@link DurableWorkerRuntime} a pure thin worker registers its bodies on — `null` in
+ * every other role. A Symbol rather than the class itself: the class lives in an optional peer, and
+ * using it as a DI token would drag that peer into the package's static import graph.
+ */
+declare const DURABLE_WORKER_RUNTIME: unique symbol;
 /** The list of started {@link RunningWorker} handles (the single handle {@link ThinWorkerBootstrap}
  *  starts), closed on shutdown. */
 declare const DURABLE_WORKER_RUNNERS: unique symbol;
@@ -724,7 +750,7 @@ declare class ThinWorkflowRegistrar implements OnModuleInit {
     private readonly discovery;
     private readonly runtime;
     private readonly options;
-    constructor(discovery: DiscoveryService, runtime: DurableWorkerRuntime, options: DurableModuleOptions);
+    constructor(discovery: DiscoveryService, runtime: DurableWorkerRuntime | null, options: DurableModuleOptions);
     onModuleInit(): void;
 }
 /**
@@ -738,7 +764,7 @@ declare class ThinStepRegistrar implements OnModuleInit {
     private readonly metadataScanner;
     private readonly runtime;
     private readonly options;
-    constructor(discovery: DiscoveryService, metadataScanner: MetadataScanner, runtime: DurableWorkerRuntime, options: DurableModuleOptions);
+    constructor(discovery: DiscoveryService, metadataScanner: MetadataScanner, runtime: DurableWorkerRuntime | null, options: DurableModuleOptions);
     onModuleInit(): void;
 }
 /**
@@ -757,7 +783,7 @@ declare class ThinWorkerBootstrap implements OnApplicationBootstrap, OnApplicati
     private readonly runRedisWorker;
     private readonly runnersSink;
     private readonly runners;
-    constructor(runtime: DurableWorkerRuntime, options: DurableModuleOptions, runRedisWorker: RunRedisWorkerFn, runnersSink: RunningWorker[]);
+    constructor(runtime: DurableWorkerRuntime | null, options: DurableModuleOptions, runRedisWorker: RunRedisWorkerFn, runnersSink: RunningWorker[]);
     onApplicationBootstrap(): Promise<void>;
     onApplicationShutdown(): Promise<void>;
 }
@@ -864,7 +890,7 @@ declare class InAppWorkerBootstrap implements OnModuleInit, OnApplicationBootstr
     private readonly runRedisWorker;
     private readonly runnersSink;
     private readonly runners;
-    constructor(discovery: DiscoveryService, metadataScanner: MetadataScanner, options: DurableModuleOptions, runtime: DurableWorkerRuntime, runRedisWorker: RunRedisWorkerFn, runnersSink: RunningWorker[]);
+    constructor(discovery: DiscoveryService, metadataScanner: MetadataScanner, options: DurableModuleOptions, runtime: DurableWorkerRuntime | null, runRedisWorker: RunRedisWorkerFn, runnersSink: RunningWorker[]);
     onModuleInit(): void;
     onApplicationBootstrap(): Promise<void>;
     onApplicationShutdown(): Promise<void>;
@@ -1150,4 +1176,4 @@ declare class WorkflowService {
     }): Promise<number>;
 }
 
-export { CONTEXT_ACCESSOR, type ContextAccessor, type ContextStore, DEAD_LETTER_METADATA, DURABLE_STEP_METADATA, DURABLE_WORKER_RUNNERS, DeadLetter, DurableModule, type DurableModuleAsyncOptions, type DurableModuleOptions, type DurableRetentionOptions, DurableStartClient, DurableStep, type DurableStepInterceptor, type DurableStepMeta, ENTITY_METADATA, ENTITY_ON_METADATA, Entity, EntityService, IN_APP_RUN_REDIS_WORKER, IN_APP_WORKER_BINDING, IN_APP_WORKER_RUNNERS, IN_APP_WORKER_RUNTIME, type InAppWorkerBinding, InAppWorkerBootstrap, ON_EVENT_METADATA, On, OnDurableEvent, OnEvent, ProxyRunGateway, RUN_GATEWAY, RUN_REDIS_WORKER, type RunLookupStore, type RunRedisWorkerFn, RunRequestResponder, type RunRequestTransport, STEP_INTERCEPTOR_METADATA, Step, StepInterceptor, type StepOptions, StoreRunGateway, TenantEventRepublisher, ThinStepRegistrar, ThinWorkerBootstrap, ThinWorkflowRegistrar, type UserRef, WORKFLOW_METADATA, Workflow, type WorkflowAttributesOf, type WorkflowMeta, type WorkflowOptions, WorkflowService, attributesOf, entityConfigFor, getDurableStepMeta, getEntityMeta, getOnEvents, getWorkflowMeta, inAppWorkerProviders, isDeadLetterHandler, isDrivingOperator, isOperatorRole, isStepInterceptor, thinWorkerProviders, unavailableRunGateway };
+export { CONTEXT_ACCESSOR, type ContextAccessor, type ContextStore, DEAD_LETTER_METADATA, DURABLE_STEP_METADATA, DURABLE_WORKER_RUNNERS, DURABLE_WORKER_RUNTIME, DeadLetter, DurableModule, type DurableModuleAsyncOptions, type DurableModuleOptions, type DurableRetentionOptions, DurableStartClient, DurableStep, type DurableStepInterceptor, type DurableStepMeta, ENTITY_METADATA, ENTITY_ON_METADATA, Entity, EntityService, IN_APP_RUN_REDIS_WORKER, IN_APP_WORKER_BINDING, IN_APP_WORKER_RUNNERS, IN_APP_WORKER_RUNTIME, type InAppWorkerBinding, InAppWorkerBootstrap, ON_EVENT_METADATA, On, OnDurableEvent, OnEvent, ProxyRunGateway, RUN_GATEWAY, RUN_REDIS_WORKER, type RunLookupStore, type RunRedisWorkerFn, RunRequestResponder, type RunRequestTransport, STEP_INTERCEPTOR_METADATA, Step, StepInterceptor, type StepOptions, StoreRunGateway, TenantEventRepublisher, ThinStepRegistrar, ThinWorkerBootstrap, ThinWorkflowRegistrar, type UserRef, WORKFLOW_METADATA, Workflow, type WorkflowAttributesOf, type WorkflowMeta, type WorkflowOptions, WorkflowService, attributesOf, entityConfigFor, getDurableStepMeta, getEntityMeta, getOnEvents, getWorkflowMeta, inAppWorkerProviders, isDeadLetterHandler, isDrivingOperator, isOperatorRole, isStepInterceptor, thinWorkerProviders, unavailableRunGateway };