@dudousxd/nestjs-durable 0.35.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
@@ -623,18 +643,6 @@ interface DurableModuleOptions {
     topology?: {
         role: 'control-plane';
         tenant?: string;
-        /**
-         * `'bridge'` — this operator's tenant workers follow the OPERATOR convention (bare
-         * transport prefix + `@<tenant>`-suffixed groups: the Python SDK, the TS `role: 'tenant'`
-         * worker). When `tenant` is set, the preset pairs the configured `transport` with a
-         * bare-prefix sibling (`transport.withNamespace('default')`) in a pool, so those workers
-         * are discoverable and dispatchable from this otherwise-namespaced keyspace. INERT when
-         * `tenant` is unset (a global operator is already on the bare prefix) — safe to leave on a
-         * static config that reads `tenant` from an env var. CAUTION: the bare sibling consumes
-         * the shared bare control queues — only sound when this stack owns its broker (a private
-         * Redis); on a shared broker, point the tenant workers at a scoped prefix instead.
-         */
-        tenantWorkers?: 'bridge';
     } | {
         role: 'tenant';
         tenant: string;

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
@@ -623,18 +643,6 @@ interface DurableModuleOptions {
     topology?: {
         role: 'control-plane';
         tenant?: string;
-        /**
-         * `'bridge'` — this operator's tenant workers follow the OPERATOR convention (bare
-         * transport prefix + `@<tenant>`-suffixed groups: the Python SDK, the TS `role: 'tenant'`
-         * worker). When `tenant` is set, the preset pairs the configured `transport` with a
-         * bare-prefix sibling (`transport.withNamespace('default')`) in a pool, so those workers
-         * are discoverable and dispatchable from this otherwise-namespaced keyspace. INERT when
-         * `tenant` is unset (a global operator is already on the bare prefix) — safe to leave on a
-         * static config that reads `tenant` from an env var. CAUTION: the bare sibling consumes
-         * the shared bare control queues — only sound when this stack owns its broker (a private
-         * Redis); on a shared broker, point the tenant workers at a scoped prefix instead.
-         */
-        tenantWorkers?: 'bridge';
     } | {
         role: 'tenant';
         tenant: string;

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),
@@ -1828,10 +1831,10 @@ function resolveTopology(options) {
   if (topology === void 0) return options;
   if (topology.role === "control-plane") {
     if (topology.tenant === void 0 || options.namespace !== void 0) return options;
-    return resolveTenantWorkersBridge({
+    return {
       ...options,
       namespace: topology.tenant
-    });
+    };
   }
   if (options.partition !== void 0) return options;
   return {
@@ -1840,30 +1843,6 @@ function resolveTopology(options) {
   };
 }
 __name(resolveTopology, "resolveTopology");
-function resolveTenantWorkersBridge(options) {
-  const topology = options.topology;
-  if (topology?.role !== "control-plane" || topology.tenantWorkers !== "bridge") return options;
-  if (options.transports !== void 0) return options;
-  const primary = options.transport;
-  if (primary === void 0) return options;
-  if (primary.withNamespace === void 0) {
-    throw new Error("topology: { tenantWorkers: 'bridge' } needs a transport implementing `withNamespace` (e.g. BullMQTransport) \u2014 the bridge derives a bare-prefix sibling from the configured transport to reach operator-convention tenant workers.");
-  }
-  return {
-    ...options,
-    transports: [
-      {
-        id: "default",
-        transport: primary
-      },
-      {
-        id: "tenant-workers",
-        transport: primary.withNamespace("default")
-      }
-    ]
-  };
-}
-__name(resolveTenantWorkersBridge, "resolveTenantWorkersBridge");
 var RunGatewayBootstrap = class RunGatewayBootstrap2 {
   static {
     __name(this, "RunGatewayBootstrap");