@dudousxd/nestjs-durable 0.31.0 → 0.33.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { StepError, WorkflowRef, SingletonConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowClass, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetail, RunQuery, RunListItem, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, TenantEvent } from '@dudousxd/nestjs-durable-core';
-export { AttributeFilter, EngineEvent, RunDetail, RunGateway, RunListItem, RunQuery, RunStatus, RunWaiting, SearchAttributes, StepCheckpoint, StepLogger, WorkflowCtx, WorkflowEngine, WorkflowRun } 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 { z } from 'zod';
 import { ConcurrencyOption, StartRunDeps, RunRedisWorkerOptions, RunningWorker, DurableWorkerRuntime } from '@dudousxd/durable-worker';
 import { DynamicModule, InjectionToken, OnModuleInit, OnApplicationBootstrap, OnApplicationShutdown, Provider } from '@nestjs/common';
@@ -527,10 +527,18 @@ interface DurableModuleOptions {
      *   dispatch routes a run's `namespace` to. `{ role: 'tenant' }` sets this FOR you from `tenant` —
      *   you never set `partition` directly under `topology`.
      *
+     * **One `tenant` word, two axes — the preset maps it to the right one per role:** on a
+     * `control-plane` an optional `tenant` scopes the OPERATOR to its own runs (maps to `namespace` —
+     * a self-contained local stack sharing a broker with a deployed cluster names itself so neither
+     * drives the other's runs; leave it unset on a deployed operator to drive every tenant). On a
+     * `tenant` role it is required and maps to `partition` (the worker's queue suffix).
+     *
      * ```ts
-     * // Control plane: owns the store, dispatches over the transport, prunes old runs.
+     * // Control plane: owns the store, dispatches over the transport, prunes old runs. The optional
+     * // `tenant` (e.g. from an env var) scopes this operator to its own runs — undefined on a
+     * // deployed operator (drives everything), set on a local stack sharing the broker.
      * DurableModule.forRoot({
-     *   topology: { role: 'control-plane' },
+     *   topology: { role: 'control-plane', tenant: process.env.DURABLE_TENANT },
      *   store,
      *   transport,
      *   retention: { policies: [{ statuses: ['completed', 'cancelled'], maxAge: '14d' }] },
@@ -548,6 +556,7 @@ interface DurableModuleOptions {
      */
     topology?: {
         role: 'control-plane';
+        tenant?: string;
     } | {
         role: 'tenant';
         tenant: string;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { StepError, WorkflowRef, SingletonConfig, SearchAttributesSchema, StateStore, Transport, NamedTransport, ControlPlane, ScheduledWorkflow, RetentionPolicy, QueueConfig, AdmissionBackend, WorkflowClass, WorkflowInputOf, StartOptions, RunResult, RunGateway, WorkflowEngine, EntityHandler, DurableTopology, RunDetail, RunQuery, RunListItem, GroupHealth, RunWaiting, EngineEvent, RunRequest, RunReply, StepInvocation, TenantEvent } from '@dudousxd/nestjs-durable-core';
-export { AttributeFilter, EngineEvent, RunDetail, RunGateway, RunListItem, RunQuery, RunStatus, RunWaiting, SearchAttributes, StepCheckpoint, StepLogger, WorkflowCtx, WorkflowEngine, WorkflowRun } 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 { z } from 'zod';
 import { ConcurrencyOption, StartRunDeps, RunRedisWorkerOptions, RunningWorker, DurableWorkerRuntime } from '@dudousxd/durable-worker';
 import { DynamicModule, InjectionToken, OnModuleInit, OnApplicationBootstrap, OnApplicationShutdown, Provider } from '@nestjs/common';
@@ -527,10 +527,18 @@ interface DurableModuleOptions {
      *   dispatch routes a run's `namespace` to. `{ role: 'tenant' }` sets this FOR you from `tenant` —
      *   you never set `partition` directly under `topology`.
      *
+     * **One `tenant` word, two axes — the preset maps it to the right one per role:** on a
+     * `control-plane` an optional `tenant` scopes the OPERATOR to its own runs (maps to `namespace` —
+     * a self-contained local stack sharing a broker with a deployed cluster names itself so neither
+     * drives the other's runs; leave it unset on a deployed operator to drive every tenant). On a
+     * `tenant` role it is required and maps to `partition` (the worker's queue suffix).
+     *
      * ```ts
-     * // Control plane: owns the store, dispatches over the transport, prunes old runs.
+     * // Control plane: owns the store, dispatches over the transport, prunes old runs. The optional
+     * // `tenant` (e.g. from an env var) scopes this operator to its own runs — undefined on a
+     * // deployed operator (drives everything), set on a local stack sharing the broker.
      * DurableModule.forRoot({
-     *   topology: { role: 'control-plane' },
+     *   topology: { role: 'control-plane', tenant: process.env.DURABLE_TENANT },
      *   store,
      *   transport,
      *   retention: { policies: [{ statuses: ['completed', 'cancelled'], maxAge: '14d' }] },
@@ -548,6 +556,7 @@ interface DurableModuleOptions {
      */
     topology?: {
         role: 'control-plane';
+        tenant?: string;
     } | {
         role: 'tenant';
         tenant: string;

package/dist/index.js

@@ -1781,8 +1781,9 @@ function assertValidTopology(options) {
     if (options.partition !== void 0) {
       throw new Error("topology: { role: 'control-plane' } forbids `partition`.\npartition is the WORKER queue-routing suffix \u2014 on a control-plane node, runs are dispatched to tenant partitions via each run's namespace, not via this option. Set `partition` (or `topology: { role: 'tenant', tenant }`) on the WORKER node instead.");
     }
-    if ("tenant" in topology) {
-      throw new Error("topology: { role: 'control-plane' } forbids a `tenant` field.\ntenant names a WORKER's isolation partition \u2014 a control-plane node serves every tenant's runs (via their namespace), it isn't scoped to one itself.");
+    if (topology.tenant !== void 0 && options.namespace !== void 0 && options.namespace !== topology.tenant) {
+      throw new Error(`topology: { role: 'control-plane', tenant: '${topology.tenant}' } conflicts with \`namespace: '${options.namespace}'\`.
+tenant maps 1:1 onto namespace (the operator's poll-scoping axis) \u2014 set only \`tenant\`, or set \`namespace\` to the same value.`);
     }
     return;
   }
@@ -1804,7 +1805,14 @@ tenant maps 1:1 onto partition (the worker queue-routing suffix) \u2014 set only
 __name(assertValidTopology, "assertValidTopology");
 function resolveTopology(options) {
   const topology = options.topology;
-  if (topology === void 0 || topology.role !== "tenant") return options;
+  if (topology === void 0) return options;
+  if (topology.role === "control-plane") {
+    if (topology.tenant === void 0 || options.namespace !== void 0) return options;
+    return {
+      ...options,
+      namespace: topology.tenant
+    };
+  }
   if (options.partition !== void 0) return options;
   return {
     ...options,
@@ -2046,7 +2054,7 @@ DurableModule = _ts_decorate12([
 ], DurableModule);
 
 // src/index.ts
-import { WorkflowEngine as WorkflowEngine7 } from "@dudousxd/nestjs-durable-core";
+import { readSearchAttributes, WorkflowEngine as WorkflowEngine7 } from "@dudousxd/nestjs-durable-core";
 export {
   CONTEXT_ACCESSOR,
   DEAD_LETTER_METADATA,
@@ -2095,6 +2103,7 @@ export {
   isDrivingOperator,
   isOperatorRole,
   isStepInterceptor,
+  readSearchAttributes,
   thinWorkerProviders,
   unavailableRunGateway
 };