@dudousxd/nestjs-durable 0.43.2 → 0.45.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { WorkflowCtx, SearchAttributes, WorkflowClass, StepError, WorkflowRef, SingletonConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetail, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, TenantEvent } from '@dudousxd/nestjs-durable-core';
-export { AttributeFilter, EngineEvent, InferSearchAttributes, RunDetail, RunGateway, RunListItem, RunQuery, RunStatus, RunWaiting, SearchAttributes, SearchAttributesSchema, StepCheckpoint, StepEvent, StepLogger, WorkflowCtx, WorkflowEngine, WorkflowHandler, WorkflowRun, readSearchAttributes } from '@dudousxd/nestjs-durable-core';
+import { WorkflowCtx, SearchAttributes, WorkflowClass, StepError, WorkflowRef, SingletonConfig, ConcurrencyConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetail, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, TenantEvent } from '@dudousxd/nestjs-durable-core';
+export { AttributeFilter, DynamicWorkflowCtx, EngineEvent, InferSearchAttributes, 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';
 import { DynamicModule, InjectionToken, OnModuleInit, OnApplicationBootstrap, OnApplicationShutdown, Provider } from '@nestjs/common';
@@ -112,6 +112,8 @@ interface WorkflowMeta {
     tags?: string[] | undefined;
     /** Per-key serialization (a durable mutex). See `WorkflowOptions`. */
     singleton?: SingletonConfig | undefined;
+    /** Start-time concurrency quota (rejecting). See `WorkflowOptions`. */
+    concurrency?: ConcurrencyConfig | undefined;
     /** Max wall-clock lifetime before a run is cancelled (e.g. `'2h'`). See `WorkflowOptions`. */
     executionTimeout?: string | number | undefined;
     /** class-validator DTO validated at start. See `WorkflowOptions`. */
@@ -156,6 +158,15 @@ interface WorkflowOptions {
      * 1) raises the concurrency.
      */
     singleton?: SingletonConfig;
+    /**
+     * A start-time concurrency QUOTA: at most `limit` runs sharing a key in flight, and a start over it
+     * is REJECTED (`ConcurrencyLimitError`, nothing created) rather than queued. e.g.
+     * `concurrency: { key: (input) => `tenant:${input.tenantId}`, limit: 8 }` caps what one tenant can
+     * have executing at once. The key is shared across workflows; `limit` may be a (async) function of
+     * the key for per-plan limits; `countStatuses` narrows what occupies a slot (default: every
+     * non-terminal status). Use `singleton` instead when excess runs should wait their turn.
+     */
+    concurrency?: ConcurrencyConfig;
     /**
      * Max wall-clock lifetime for a run of this workflow (e.g. `'2h'`, `'7 days'`, or ms). A run that
      * outlives it is moved to `cancelled` (`execution_timeout`) by the timer poller — a backstop for
@@ -363,7 +374,7 @@ declare function getOnEvents(meta: WorkflowMeta, target: object): string[];
 
 /**
  * Retention config for the {@link RetentionPoller}. One or more {@link RetentionPolicy policies}
- * (status sets must be disjoint — validated at boot), swept together on a shared interval.
+ * (status sets must be disjoint per scope — validated at boot), swept together on a shared interval.
  *
  * ```ts
  * retention: {
@@ -372,9 +383,14 @@ declare function getOnEvents(meta: WorkflowMeta, target: object): string[];
  *   policies: [
  *     { statuses: ['completed', 'cancelled'], maxAge: '14d', maxCount: 200 },
  *     { statuses: ['failed'], maxAge: '90d' }, // keep failures longer for debugging
+ *     // Scoped: chat turns age out after a day, whatever the defaults above say.
+ *     { statuses: ['completed', 'failed', 'cancelled'], maxAge: '1d', scope: { tags: ['chat'] } },
  *   ],
  * }
  * ```
+ *
+ * Policies are applied one after another, so a run matched by several scopes is pruned by the
+ * strictest of them.
  */
 interface DurableRetentionOptions {
     /** The retention rules, one per (disjoint) status group. */
@@ -464,6 +480,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
@@ -493,12 +529,21 @@ interface DurableModuleOptions {
      * optional `cron-parser` peer dependency. Operator only.
      */
     schedules?: ScheduledWorkflow[];
+    /**
+     * Fire the PERSISTED schedules managed at runtime through `engine.schedules` (create/upsert/pause/
+     * resume/delete/list) on every timer-poll tick of a driving instance — one indexed "due by now"
+     * query per tick. Off by default, so a deployment that never uses them doesn't need the
+     * `durable_schedules` table. Safe with any number of driving instances: each window's run id is
+     * deterministic and advancing a schedule is a compare-and-set. Operator only.
+     */
+    persistedSchedules?: boolean;
     /**
      * Hard-prune terminal run history on an interval so `durable_workflow_runs` (and its child tables)
      * stays bounded — without it, completed/failed/cancelled runs accumulate forever and the timer
      * poller's per-tick status scans get linearly slower. Driving instances only. Omit to keep all
-     * history (the default). Requires a store adapter that implements `pruneTerminalRuns` (the
-     * MikroORM adapter does); other adapters no-op with a warning. See {@link DurableRetentionOptions}.
+     * history (the default). Requires a store adapter that implements `pruneTerminalRuns` (every
+     * first-party adapter does); a custom store without it no-ops with a warning. See
+     * {@link DurableRetentionOptions}.
      * Operator only.
      */
     retention?: DurableRetentionOptions;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { WorkflowCtx, SearchAttributes, WorkflowClass, StepError, WorkflowRef, SingletonConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetail, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, TenantEvent } from '@dudousxd/nestjs-durable-core';
-export { AttributeFilter, EngineEvent, InferSearchAttributes, RunDetail, RunGateway, RunListItem, RunQuery, RunStatus, RunWaiting, SearchAttributes, SearchAttributesSchema, StepCheckpoint, StepEvent, StepLogger, WorkflowCtx, WorkflowEngine, WorkflowHandler, WorkflowRun, readSearchAttributes } from '@dudousxd/nestjs-durable-core';
+import { WorkflowCtx, SearchAttributes, WorkflowClass, StepError, WorkflowRef, SingletonConfig, ConcurrencyConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetail, RunQuery, RunListItem, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, TenantEvent } from '@dudousxd/nestjs-durable-core';
+export { AttributeFilter, DynamicWorkflowCtx, EngineEvent, InferSearchAttributes, 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';
 import { DynamicModule, InjectionToken, OnModuleInit, OnApplicationBootstrap, OnApplicationShutdown, Provider } from '@nestjs/common';
@@ -112,6 +112,8 @@ interface WorkflowMeta {
     tags?: string[] | undefined;
     /** Per-key serialization (a durable mutex). See `WorkflowOptions`. */
     singleton?: SingletonConfig | undefined;
+    /** Start-time concurrency quota (rejecting). See `WorkflowOptions`. */
+    concurrency?: ConcurrencyConfig | undefined;
     /** Max wall-clock lifetime before a run is cancelled (e.g. `'2h'`). See `WorkflowOptions`. */
     executionTimeout?: string | number | undefined;
     /** class-validator DTO validated at start. See `WorkflowOptions`. */
@@ -156,6 +158,15 @@ interface WorkflowOptions {
      * 1) raises the concurrency.
      */
     singleton?: SingletonConfig;
+    /**
+     * A start-time concurrency QUOTA: at most `limit` runs sharing a key in flight, and a start over it
+     * is REJECTED (`ConcurrencyLimitError`, nothing created) rather than queued. e.g.
+     * `concurrency: { key: (input) => `tenant:${input.tenantId}`, limit: 8 }` caps what one tenant can
+     * have executing at once. The key is shared across workflows; `limit` may be a (async) function of
+     * the key for per-plan limits; `countStatuses` narrows what occupies a slot (default: every
+     * non-terminal status). Use `singleton` instead when excess runs should wait their turn.
+     */
+    concurrency?: ConcurrencyConfig;
     /**
      * Max wall-clock lifetime for a run of this workflow (e.g. `'2h'`, `'7 days'`, or ms). A run that
      * outlives it is moved to `cancelled` (`execution_timeout`) by the timer poller — a backstop for
@@ -363,7 +374,7 @@ declare function getOnEvents(meta: WorkflowMeta, target: object): string[];
 
 /**
  * Retention config for the {@link RetentionPoller}. One or more {@link RetentionPolicy policies}
- * (status sets must be disjoint — validated at boot), swept together on a shared interval.
+ * (status sets must be disjoint per scope — validated at boot), swept together on a shared interval.
  *
  * ```ts
  * retention: {
@@ -372,9 +383,14 @@ declare function getOnEvents(meta: WorkflowMeta, target: object): string[];
  *   policies: [
  *     { statuses: ['completed', 'cancelled'], maxAge: '14d', maxCount: 200 },
  *     { statuses: ['failed'], maxAge: '90d' }, // keep failures longer for debugging
+ *     // Scoped: chat turns age out after a day, whatever the defaults above say.
+ *     { statuses: ['completed', 'failed', 'cancelled'], maxAge: '1d', scope: { tags: ['chat'] } },
  *   ],
  * }
  * ```
+ *
+ * Policies are applied one after another, so a run matched by several scopes is pruned by the
+ * strictest of them.
  */
 interface DurableRetentionOptions {
     /** The retention rules, one per (disjoint) status group. */
@@ -464,6 +480,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
@@ -493,12 +529,21 @@ interface DurableModuleOptions {
      * optional `cron-parser` peer dependency. Operator only.
      */
     schedules?: ScheduledWorkflow[];
+    /**
+     * Fire the PERSISTED schedules managed at runtime through `engine.schedules` (create/upsert/pause/
+     * resume/delete/list) on every timer-poll tick of a driving instance — one indexed "due by now"
+     * query per tick. Off by default, so a deployment that never uses them doesn't need the
+     * `durable_schedules` table. Safe with any number of driving instances: each window's run id is
+     * deterministic and advancing a schedule is a compare-and-set. Operator only.
+     */
+    persistedSchedules?: boolean;
     /**
      * Hard-prune terminal run history on an interval so `durable_workflow_runs` (and its child tables)
      * stays bounded — without it, completed/failed/cancelled runs accumulate forever and the timer
      * poller's per-tick status scans get linearly slower. Driving instances only. Omit to keep all
-     * history (the default). Requires a store adapter that implements `pruneTerminalRuns` (the
-     * MikroORM adapter does); other adapters no-op with a warning. See {@link DurableRetentionOptions}.
+     * history (the default). Requires a store adapter that implements `pruneTerminalRuns` (every
+     * first-party adapter does); a custom store without it no-ops with a warning. See
+     * {@link DurableRetentionOptions}.
      * Operator only.
      */
     retention?: DurableRetentionOptions;

package/dist/index.js

@@ -127,6 +127,7 @@ function Workflow(options) {
       deadLetterWorkflow: options.deadLetterWorkflow,
       tags: options.tags,
       singleton: options.singleton,
+      concurrency: options.concurrency,
       executionTimeout: options.executionTimeout,
       inputSchema: options.inputSchema,
       validateInput: options.validateInput,
@@ -263,13 +264,22 @@ __name(createWorkerRuntime, "createWorkerRuntime");
 // src/durable-start-client.ts
 function _ts_decorate(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate, "_ts_decorate");
-function _ts_metadata(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+function _ts_metadata(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
 }
 __name(_ts_metadata, "_ts_metadata");
 var DurableStartClient = class {
@@ -397,13 +407,22 @@ __name(scanSteps, "scanSteps");
 // src/durable-worker.module.ts
 function _ts_decorate2(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate2, "_ts_decorate");
-function _ts_metadata2(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+function _ts_metadata2(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
 }
 __name(_ts_metadata2, "_ts_metadata");
 function _ts_param(paramIndex, decorator) {
@@ -655,13 +674,22 @@ __name(isDrivingOperator, "isDrivingOperator");
 // src/durable-step.registrar.ts
 function _ts_decorate3(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate3, "_ts_decorate");
-function _ts_metadata3(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+function _ts_metadata3(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
 }
 __name(_ts_metadata3, "_ts_metadata");
 function _ts_param2(paramIndex, decorator) {
@@ -714,13 +742,22 @@ import { Injectable as Injectable4 } from "@nestjs/common";
 import "reflect-metadata";
 function _ts_decorate4(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate4, "_ts_decorate");
-function _ts_metadata4(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+function _ts_metadata4(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
 }
 __name(_ts_metadata4, "_ts_metadata");
 var ENTITY_METADATA = Symbol("nestjs-durable:entity");
@@ -793,13 +830,22 @@ import { Inject as Inject3, Injectable as Injectable5 } from "@nestjs/common";
 import { DiscoveryService as DiscoveryService3, MetadataScanner as MetadataScanner3 } from "@nestjs/core";
 function _ts_decorate5(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate5, "_ts_decorate");
-function _ts_metadata5(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+function _ts_metadata5(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
 }
 __name(_ts_metadata5, "_ts_metadata");
 function _ts_param3(paramIndex, decorator) {
@@ -952,13 +998,22 @@ __name(inAppWorkerProviders, "inAppWorkerProviders");
 import { Injectable as Injectable6 } from "@nestjs/common";
 function _ts_decorate6(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate6, "_ts_decorate");
-function _ts_metadata6(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+function _ts_metadata6(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
 }
 __name(_ts_metadata6, "_ts_metadata");
 var ProxyRunGateway = class {
@@ -1120,13 +1175,22 @@ import { DURABLE_OPTIONS_CANONICAL as DURABLE_OPTIONS_CANONICAL4, STATE_STORE_CA
 import { Inject as Inject4, Injectable as Injectable7 } from "@nestjs/common";
 function _ts_decorate7(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate7, "_ts_decorate");
-function _ts_metadata7(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+function _ts_metadata7(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
 }
 __name(_ts_metadata7, "_ts_metadata");
 function _ts_param4(paramIndex, decorator) {
@@ -1141,6 +1205,7 @@ var MAX_BATCHES_PER_POLICY = 100;
 function validateRetention(retention) {
   const seen = /* @__PURE__ */ new Set();
   for (const policy of retention.policies) {
+    const scopeKey = policy.scope ? stableKey(policy.scope) : "";
     if (policy.statuses.length === 0) {
       throw new Error("durable retention: each policy must list at least one status");
     }
@@ -1152,14 +1217,24 @@ function validateRetention(retention) {
       if (!TERMINAL_RUN_STATUSES.includes(status)) {
         throw new Error(`durable retention: status "${status}" is not terminal; only ${TERMINAL_RUN_STATUSES.join(", ")} can be pruned`);
       }
-      if (seen.has(status)) {
-        throw new Error(`durable retention: status "${status}" appears in more than one policy; status sets must be disjoint`);
+      const key = `${scopeKey}|${status}`;
+      if (seen.has(key)) {
+        throw new Error(`durable retention: status "${status}" appears in more than one policy with the same scope; status sets must be disjoint per scope`);
       }
-      seen.add(status);
+      seen.add(key);
     }
   }
 }
 __name(validateRetention, "validateRetention");
+function stableKey(value) {
+  if (Array.isArray(value)) return `[${value.map(stableKey).join(",")}]`;
+  if (value && typeof value === "object") {
+    const entries = Object.entries(value).filter(([, v]) => v !== void 0).sort(([a], [b]) => a.localeCompare(b));
+    return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableKey(v)}`).join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+__name(stableKey, "stableKey");
 var RetentionPoller = class {
   static {
     __name(this, "RetentionPoller");
@@ -1397,13 +1472,22 @@ import { STATE_STORE_CANONICAL as STATE_STORE_CANONICAL2, WorkflowEngine as Work
 import { Inject as Inject5, Injectable as Injectable8 } from "@nestjs/common";
 function _ts_decorate8(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate8, "_ts_decorate");
-function _ts_metadata8(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+function _ts_metadata8(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
 }
 __name(_ts_metadata8, "_ts_metadata");
 function _ts_param5(paramIndex, decorator) {
@@ -1589,13 +1673,22 @@ import { DURABLE_OPTIONS_CANONICAL as DURABLE_OPTIONS_CANONICAL5, WorkflowEngine
 import { Inject as Inject6, Injectable as Injectable9 } from "@nestjs/common";
 function _ts_decorate9(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate9, "_ts_decorate");
-function _ts_metadata9(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+function _ts_metadata9(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
 }
 __name(_ts_metadata9, "_ts_metadata");
 function _ts_param6(paramIndex, decorator) {
@@ -1662,6 +1755,9 @@ var TimerPoller = class {
       if (schedules && schedules.length > 0) {
         await this.sweep("schedules", () => runSchedules(this.engine, schedules, Date.now()));
       }
+      if (this.options.persistedSchedules) {
+        await this.sweep("persistedSchedules", () => this.engine.schedules.tick());
+      }
     } finally {
       this.polling = false;
     }
@@ -1737,13 +1833,22 @@ __name(isStepInterceptor, "isStepInterceptor");
 // src/workflow.registrar.ts
 function _ts_decorate10(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate10, "_ts_decorate");
-function _ts_metadata10(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+function _ts_metadata10(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
 }
 __name(_ts_metadata10, "_ts_metadata");
 function _ts_param7(paramIndex, decorator) {
@@ -1829,6 +1934,7 @@ var WorkflowRegistrar = class {
         origin,
         tags: meta.tags,
         singleton: meta.singleton,
+        concurrency: meta.concurrency,
         executionTimeout: meta.executionTimeout,
         requires: meta.requires,
         validateInput,
@@ -1942,13 +2048,22 @@ import { WorkflowEngine as WorkflowEngine5 } from "@dudousxd/nestjs-durable-core
 import { Injectable as Injectable11 } from "@nestjs/common";
 function _ts_decorate11(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate11, "_ts_decorate");
-function _ts_metadata11(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+function _ts_metadata11(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
 }
 __name(_ts_metadata11, "_ts_metadata");
 var WorkflowService = class {
@@ -2005,13 +2120,22 @@ WorkflowService = _ts_decorate11([
 // src/durable.module.ts
 function _ts_decorate12(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate12, "_ts_decorate");
-function _ts_metadata12(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+function _ts_metadata12(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
 }
 __name(_ts_metadata12, "_ts_metadata");
 function _ts_param8(paramIndex, decorator) {
@@ -2306,6 +2430,8 @@ var DurableModule = class _DurableModule {
               admission: options.admission,
               maxRecoveryAttempts: options.maxRecoveryAttempts,
               remoteAdvanceSilenceMs: options.remoteAdvanceSilenceMs,
+              remoteRedispatchMs: options.remoteRedispatchMs,
+              remoteRedispatchMax: options.remoteRedispatchMax,
               instanceId: options.instanceId,
               namespace: options.namespace,
               webhookUrl: options.webhookUrl,