@dudousxd/nestjs-durable 0.36.0 → 0.37.0

package/dist/index.d.cts

@@ -129,6 +129,9 @@ interface WorkflowMeta {
         maxSize: number;
         within: string | number;
     } | undefined;
+    /** Capabilities a live worker must advertise to run this workflow's turns (handshake §7.5). See
+     *  `WorkflowOptions`. */
+    requires?: string[] | undefined;
 }
 interface WorkflowOptions {
     name: string;
@@ -159,6 +162,14 @@ interface WorkflowOptions {
      * runs that get stuck or loop forever. Omit for no limit.
      */
     executionTimeout?: string | number;
+    /**
+     * Capabilities a live worker MUST advertise to run this workflow's turns (handshake design §7.5).
+     * Only meaningful for a group-served / remote workflow (an in-app worker or a cross-runtime body):
+     * the control-plane dispatches a turn only to a capability-capable + protocol-compatible worker, and
+     * if descriptors are published on its group but none qualifies the run parks `blocked` until the
+     * recovery poll finds one. Absent/empty = "runs anywhere" (a legacy fleet skips the guard, §7.7).
+     */
+    requires?: string[];
     /**
      * Validate the workflow input at `start` against a **class-validator DTO** (the same
      * `plainToInstance` + `validate` NestJS runs in controllers) — invalid input is rejected before any
@@ -266,6 +277,15 @@ interface StepOptions {
      * `retries`). Omit to wait indefinitely.
      */
     timeoutMs?: number;
+    /**
+     * Capabilities a live worker MUST advertise to run this step (handshake design §7.5). The
+     * control-plane routes the step only to workers whose descriptor advertises every name here; if
+     * descriptors are published on the step's group but none is capability-capable + protocol-compatible,
+     * the run parks `blocked` (never a silent hang) until the recovery poll finds one. Absent/empty =
+     * "runs anywhere" (the default — a legacy fleet publishing no descriptors skips the guard, §7.7). A
+     * per-call `ctx.step(ref, input, { requires })` overrides this.
+     */
+    requires?: string[];
 }
 /**
  * Marks a provider method as a durable step handler. An in-process transport (e.g. the

package/dist/index.d.ts

@@ -129,6 +129,9 @@ interface WorkflowMeta {
         maxSize: number;
         within: string | number;
     } | undefined;
+    /** Capabilities a live worker must advertise to run this workflow's turns (handshake §7.5). See
+     *  `WorkflowOptions`. */
+    requires?: string[] | undefined;
 }
 interface WorkflowOptions {
     name: string;
@@ -159,6 +162,14 @@ interface WorkflowOptions {
      * runs that get stuck or loop forever. Omit for no limit.
      */
     executionTimeout?: string | number;
+    /**
+     * Capabilities a live worker MUST advertise to run this workflow's turns (handshake design §7.5).
+     * Only meaningful for a group-served / remote workflow (an in-app worker or a cross-runtime body):
+     * the control-plane dispatches a turn only to a capability-capable + protocol-compatible worker, and
+     * if descriptors are published on its group but none qualifies the run parks `blocked` until the
+     * recovery poll finds one. Absent/empty = "runs anywhere" (a legacy fleet skips the guard, §7.7).
+     */
+    requires?: string[];
     /**
      * Validate the workflow input at `start` against a **class-validator DTO** (the same
      * `plainToInstance` + `validate` NestJS runs in controllers) — invalid input is rejected before any
@@ -266,6 +277,15 @@ interface StepOptions {
      * `retries`). Omit to wait indefinitely.
      */
     timeoutMs?: number;
+    /**
+     * Capabilities a live worker MUST advertise to run this step (handshake design §7.5). The
+     * control-plane routes the step only to workers whose descriptor advertises every name here; if
+     * descriptors are published on the step's group but none is capability-capable + protocol-compatible,
+     * the run parks `blocked` (never a silent hang) until the recovery poll finds one. Absent/empty =
+     * "runs anywhere" (the default — a legacy fleet publishing no descriptors skips the guard, §7.7). A
+     * per-call `ctx.step(ref, input, { requires })` overrides this.
+     */
+    requires?: string[];
 }
 /**
  * Marks a provider method as a durable step handler. An in-process transport (e.g. the

package/dist/index.js

@@ -28,7 +28,8 @@ function Workflow(options) {
       searchAttributes: options.searchAttributes,
       onEvent: options.onEvent,
       debounce: options.debounce,
-      batch: options.batch
+      batch: options.batch,
+      requires: options.requires
     };
     Reflect.defineMetadata(WORKFLOW_METADATA, meta, target);
     Object.defineProperty(target, WORKFLOW_NAME_KEY, {
@@ -50,7 +51,8 @@ function stepConfigFrom(options) {
     backoffMs: options.backoffMs,
     backoffMaxMs: options.backoffMaxMs,
     jitter: options.jitter,
-    timeoutMs: options.timeoutMs
+    timeoutMs: options.timeoutMs,
+    requires: options.requires
   };
   const hasAnyField = Object.values(config).some((value) => value !== void 0);
   return hasAnyField ? config : void 0;
@@ -1553,6 +1555,7 @@ var WorkflowRegistrar = class {
         tags: meta.tags,
         singleton: meta.singleton,
         executionTimeout: meta.executionTimeout,
+        requires: meta.requires,
         validateInput,
         searchAttributesSchema: meta.searchAttributes,
         onEvent: getOnEvents(meta, workflowCtor),