@dudousxd/nestjs-durable 0.43.0 → 0.43.2

package/dist/index.d.cts

@@ -708,6 +708,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 +730,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 +744,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 +763,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 +870,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 +1156,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

@@ -708,6 +708,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 +730,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 +744,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 +763,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 +870,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 +1156,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.js

@@ -1,11 +1,5 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
 
 // src/attributes-of.ts
 import { readSearchAttributes } from "@dudousxd/nestjs-durable-core";
@@ -244,9 +238,29 @@ function attributesOf(workflow, run) {
 __name(attributesOf, "attributesOf");
 
 // src/durable-start-client.ts
-import { startRun } from "@dudousxd/durable-worker";
 import { workflowName } from "@dudousxd/nestjs-durable-core";
 import { Injectable } from "@nestjs/common";
+
+// src/worker-sdk.ts
+async function workerSdk() {
+  try {
+    return await import("@dudousxd/durable-worker");
+  } catch (cause) {
+    throw new Error("@dudousxd/durable-worker is not installed. It is an optional peer needed only by the roles that run workflow bodies (`connection` set on DurableModule.forRoot) \u2014 install it, or drop `connection`.", {
+      cause
+    });
+  }
+}
+__name(workerSdk, "workerSdk");
+var startRun = /* @__PURE__ */ __name(async (connection, options) => (await workerSdk()).startRun(connection, options), "startRun");
+var runRedisWorker = /* @__PURE__ */ __name(async (options) => (await workerSdk()).runRedisWorker(options), "runRedisWorker");
+async function createWorkerRuntime(options) {
+  const { DurableWorkerRuntime: Runtime } = await workerSdk();
+  return new Runtime(options);
+}
+__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);
@@ -339,7 +353,6 @@ function tenantUnsupported(method) {
 __name(tenantUnsupported, "tenantUnsupported");
 
 // src/durable-worker.module.ts
-import { DurableWorkerRuntime, runRedisWorker as defaultRunRedisWorker } from "@dudousxd/durable-worker";
 import { DURABLE_OPTIONS_CANONICAL } from "@dudousxd/nestjs-durable-core";
 import { Inject, Injectable as Injectable2 } from "@nestjs/common";
 import { DiscoveryService, MetadataScanner } from "@nestjs/core";
@@ -400,6 +413,7 @@ function _ts_param(paramIndex, decorator) {
 }
 __name(_ts_param, "_ts_param");
 var RUN_REDIS_WORKER = Symbol("nestjs-durable:run-redis-worker");
+var DURABLE_WORKER_RUNTIME = Symbol("nestjs-durable:worker-runtime");
 var DURABLE_WORKER_RUNNERS = Symbol("nestjs-durable:worker-runners");
 function isPureThinWorker(options) {
   return options.store === void 0 && options.connection !== void 0;
@@ -418,8 +432,9 @@ var ThinWorkflowRegistrar = class {
     this.options = options;
   }
   onModuleInit() {
-    if (!isPureThinWorker(this.options)) return;
-    scanWorkflows(this.discovery, (meta, instance, origin) => this.runtime.registerWorkflow(meta.name, (ctx, input) => instance.run(ctx, input), {
+    const runtime = this.runtime;
+    if (runtime === null || !isPureThinWorker(this.options)) return;
+    scanWorkflows(this.discovery, (meta, instance, origin) => runtime.registerWorkflow(meta.name, (ctx, input) => instance.run(ctx, input), {
       version: meta.version,
       ...meta.requires !== void 0 ? {
         requires: meta.requires
@@ -432,11 +447,12 @@ var ThinWorkflowRegistrar = class {
 };
 ThinWorkflowRegistrar = _ts_decorate2([
   Injectable2(),
+  _ts_param(1, Inject(DURABLE_WORKER_RUNTIME)),
   _ts_param(2, Inject(DURABLE_OPTIONS_CANONICAL)),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
     typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-    typeof DurableWorkerRuntime === "undefined" ? Object : DurableWorkerRuntime,
+    Object,
     typeof DurableModuleOptions === "undefined" ? Object : DurableModuleOptions
   ])
 ], ThinWorkflowRegistrar);
@@ -455,18 +471,20 @@ var ThinStepRegistrar = class {
     this.options = options;
   }
   onModuleInit() {
-    if (!isPureThinWorker(this.options)) return;
-    scanSteps(this.discovery, this.metadataScanner, (meta, handler) => this.runtime.registerStep(meta.name, handler));
+    const runtime = this.runtime;
+    if (runtime === null || !isPureThinWorker(this.options)) return;
+    scanSteps(this.discovery, this.metadataScanner, (meta, handler) => runtime.registerStep(meta.name, handler));
   }
 };
 ThinStepRegistrar = _ts_decorate2([
   Injectable2(),
+  _ts_param(2, Inject(DURABLE_WORKER_RUNTIME)),
   _ts_param(3, Inject(DURABLE_OPTIONS_CANONICAL)),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
     typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
     typeof MetadataScanner === "undefined" ? Object : MetadataScanner,
-    typeof DurableWorkerRuntime === "undefined" ? Object : DurableWorkerRuntime,
+    Object,
     typeof DurableModuleOptions === "undefined" ? Object : DurableModuleOptions
   ])
 ], ThinStepRegistrar);
@@ -479,17 +497,18 @@ var ThinWorkerBootstrap = class {
   runRedisWorker;
   runnersSink;
   runners = [];
-  constructor(runtime, options, runRedisWorker, runnersSink) {
+  constructor(runtime, options, runRedisWorker2, runnersSink) {
     this.runtime = runtime;
     this.options = options;
-    this.runRedisWorker = runRedisWorker;
+    this.runRedisWorker = runRedisWorker2;
     this.runnersSink = runnersSink;
   }
   async onApplicationBootstrap() {
     const options = this.options;
-    if (!isPureThinWorker(options) || options.connection === void 0) return;
+    const runtime = this.runtime;
+    if (runtime === null || !isPureThinWorker(options) || options.connection === void 0) return;
     const handle = await this.runRedisWorker({
-      runtime: this.runtime,
+      runtime,
       connection: options.connection,
       ...options.partition !== void 0 ? {
         partition: options.partition
@@ -513,12 +532,13 @@ var ThinWorkerBootstrap = class {
 };
 ThinWorkerBootstrap = _ts_decorate2([
   Injectable2(),
+  _ts_param(0, Inject(DURABLE_WORKER_RUNTIME)),
   _ts_param(1, Inject(DURABLE_OPTIONS_CANONICAL)),
   _ts_param(2, Inject(RUN_REDIS_WORKER)),
   _ts_param(3, Inject(DURABLE_WORKER_RUNNERS)),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
-    typeof DurableWorkerRuntime === "undefined" ? Object : DurableWorkerRuntime,
+    Object,
     typeof DurableModuleOptions === "undefined" ? Object : DurableModuleOptions,
     typeof RunRedisWorkerFn === "undefined" ? Object : RunRedisWorkerFn,
     Array
@@ -527,7 +547,7 @@ ThinWorkerBootstrap = _ts_decorate2([
 function thinWorkerProviders() {
   return [
     {
-      provide: DurableWorkerRuntime,
+      provide: DURABLE_WORKER_RUNTIME,
       // The runtime's `WorkflowWorker` falls back to its own `group` ctor param as the WORKFLOW's
       // `workflowPartition` for any `ctx.step` call (see `workflow-context.ts`'s `resolveCallGroup`)
       // — that fallback MUST equal this module's own `partition`, or a dispatched step's decision
@@ -535,16 +555,20 @@ function thinWorkerProviders() {
       // to. Explicit `''` (never
       // `undefined`) so it does NOT fall through to `WorkflowWorker`'s unrelated `'workflows'`
       // default parameter.
-      useFactory: /* @__PURE__ */ __name((options) => new DurableWorkerRuntime({
+      //
+      // The role gate lives HERE, not just in the consumers: constructing the runtime resolves the
+      // optional `@dudousxd/durable-worker` peer, so an operator that never runs a worker must not
+      // reach this branch at all.
+      useFactory: /* @__PURE__ */ __name((options) => isPureThinWorker(options) ? createWorkerRuntime({
         workflowGroup: options.partition ?? ""
-      }), "useFactory"),
+      }) : null, "useFactory"),
       inject: [
         DURABLE_OPTIONS_CANONICAL
       ]
     },
     {
       provide: RUN_REDIS_WORKER,
-      useValue: defaultRunRedisWorker
+      useValue: runRedisWorker
     },
     {
       provide: DURABLE_WORKER_RUNNERS,
@@ -764,7 +788,6 @@ EntityService = _ts_decorate4([
 ], EntityService);
 
 // src/in-app-worker.ts
-import { DurableWorkerRuntime as DurableWorkerRuntime2, runRedisWorker as defaultRunRedisWorker2 } from "@dudousxd/durable-worker";
 import { DURABLE_OPTIONS_CANONICAL as DURABLE_OPTIONS_CANONICAL3, TRANSPORT_CANONICAL as TRANSPORT_CANONICAL2 } from "@dudousxd/nestjs-durable-core";
 import { Inject as Inject3, Injectable as Injectable5 } from "@nestjs/common";
 import { DiscoveryService as DiscoveryService3, MetadataScanner as MetadataScanner3 } from "@nestjs/core";
@@ -817,17 +840,18 @@ var InAppWorkerBootstrap = class {
   runRedisWorker;
   runnersSink;
   runners = [];
-  constructor(discovery, metadataScanner, options, runtime, runRedisWorker, runnersSink) {
+  constructor(discovery, metadataScanner, options, runtime, runRedisWorker2, runnersSink) {
     this.discovery = discovery;
     this.metadataScanner = metadataScanner;
     this.options = options;
     this.runtime = runtime;
-    this.runRedisWorker = runRedisWorker;
+    this.runRedisWorker = runRedisWorker2;
     this.runnersSink = runnersSink;
   }
   onModuleInit() {
-    if (!isCoLocatedWorker(this.options)) return;
-    scanWorkflows(this.discovery, (meta, instance, origin) => this.runtime.registerWorkflow(meta.name, (ctx, input) => instance.run(ctx, input), {
+    const runtime = this.runtime;
+    if (runtime === null || !isCoLocatedWorker(this.options)) return;
+    scanWorkflows(this.discovery, (meta, instance, origin) => runtime.registerWorkflow(meta.name, (ctx, input) => instance.run(ctx, input), {
       version: meta.version,
       ...meta.requires !== void 0 ? {
         requires: meta.requires
@@ -836,13 +860,14 @@ var InAppWorkerBootstrap = class {
         origin
       } : {}
     }));
-    scanSteps(this.discovery, this.metadataScanner, (meta, handler) => this.runtime.registerStep(meta.name, handler));
+    scanSteps(this.discovery, this.metadataScanner, (meta, handler) => runtime.registerStep(meta.name, handler));
   }
   async onApplicationBootstrap() {
     const options = this.options;
-    if (!isCoLocatedWorker(options) || options.connection === void 0) return;
+    const runtime = this.runtime;
+    if (runtime === null || !isCoLocatedWorker(options) || options.connection === void 0) return;
     const handle = await this.runRedisWorker({
-      runtime: this.runtime,
+      runtime,
       connection: options.connection,
       ...options.partition !== void 0 ? {
         partition: options.partition
@@ -875,7 +900,7 @@ InAppWorkerBootstrap = _ts_decorate5([
     typeof DiscoveryService3 === "undefined" ? Object : DiscoveryService3,
     typeof MetadataScanner3 === "undefined" ? Object : MetadataScanner3,
     typeof DurableModuleOptions === "undefined" ? Object : DurableModuleOptions,
-    typeof DurableWorkerRuntime2 === "undefined" ? Object : DurableWorkerRuntime2,
+    Object,
     typeof RunRedisWorkerFn === "undefined" ? Object : RunRedisWorkerFn,
     Array
   ])
@@ -899,16 +924,20 @@ function inAppWorkerProviders() {
       // to. Explicit `''` (never
       // `undefined`) so it does NOT fall through to `WorkflowWorker`'s unrelated `'workflows'`
       // default parameter.
-      useFactory: /* @__PURE__ */ __name((options) => new DurableWorkerRuntime2({
+      //
+      // The role gate lives HERE, not just in the consumer: constructing the runtime resolves the
+      // optional `@dudousxd/durable-worker` peer, so an operator that never runs a worker must not
+      // reach this branch at all.
+      useFactory: /* @__PURE__ */ __name((options) => isCoLocatedWorker(options) ? createWorkerRuntime({
         workflowGroup: options.partition ?? ""
-      }), "useFactory"),
+      }) : null, "useFactory"),
       inject: [
         DURABLE_OPTIONS_CANONICAL3
       ]
     },
     {
       provide: IN_APP_RUN_REDIS_WORKER,
-      useValue: defaultRunRedisWorker2
+      useValue: runRedisWorker
     },
     {
       provide: IN_APP_WORKER_RUNNERS,
@@ -1169,6 +1198,15 @@ var RetentionPoller = class {
   onModuleDestroy() {
     if (this.timer) clearInterval(this.timer);
   }
+  /**
+  * Prune one round.
+  *
+  * Never rejects, for the same reason {@link TimerPoller.poll} does not: it is awaited inside
+  * `onApplicationBootstrap` (so a rejection propagates into the host's `bootstrap()` and kills the
+  * process) and fired as `void` on the interval (so a rejection is an unhandled one, also fatal).
+  * Pruning history is the least urgent thing this package does — a `pruneTerminalRuns` that fails
+  * on a locked table must cost this sweep and nothing more.
+  */
   async sweep() {
     if (this.sweeping) return;
     const retention = this.options.retention;
@@ -1185,6 +1223,8 @@ var RetentionPoller = class {
           if (deleted < batchSize) break;
         }
       }
+    } catch (error) {
+      console.error("[nestjs-durable] retention sweep failed; retrying next interval:", error);
     } finally {
       this.sweeping = false;
     }
@@ -1579,7 +1619,11 @@ var TimerPoller = class {
   }
   async onApplicationBootstrap() {
     if (!isDrivingOperator(this.options)) return;
-    this.unsubscribeEnqueued = this.engine.onEnqueued((runId) => void this.engine.runOne(runId));
+    this.unsubscribeEnqueued = this.engine.onEnqueued((runId) => {
+      void this.engine.runOne(runId).catch((error) => {
+        console.error(`[nestjs-durable] could not run enqueued run ${runId}:`, error);
+      });
+    });
     await this.poll();
     const intervalMs = this.options.timerPollMs ?? 1e3;
     if (intervalMs > 0) {
@@ -1591,22 +1635,45 @@ var TimerPoller = class {
     if (this.timer) clearInterval(this.timer);
     this.unsubscribeEnqueued?.();
   }
+  /**
+  * One sweep of the engine's recovery work.
+  *
+  * **This method never rejects, and that is a hard requirement rather than defensiveness.** It has
+  * exactly two callers and a rejection out of either one kills the process: on boot it is awaited
+  * inside `onApplicationBootstrap`, so the rejection propagates through `NestApplication.init()`
+  * into the host's `bootstrap()`; on the interval it is a fire-and-forget `void`, so it surfaces as
+  * an unhandled rejection. Both are fatal, and both re-occur on the next boot with the same state,
+  * so a single unrecoverable run crash-loops every worker in the deployment — taking down every
+  * other workflow with it. A poll that goes wrong must cost this tick, not the pod.
+  *
+  * Each sweep is isolated separately because they are independent: a store that fails
+  * `recoverIncomplete` says nothing about whether durable timers should still fire, and skipping
+  * the rest of the tick would silently widen one subsystem's outage into all of them.
+  */
   async poll() {
     if (this.polling) return;
     this.polling = true;
     try {
-      await this.engine.runPending();
-      await this.engine.recoverIncomplete();
-      await this.engine.resumeDueTimers();
-      await this.engine.sweepTimeouts();
+      await this.sweep("runPending", () => this.engine.runPending());
+      await this.sweep("recoverIncomplete", () => this.engine.recoverIncomplete());
+      await this.sweep("resumeDueTimers", () => this.engine.resumeDueTimers());
+      await this.sweep("sweepTimeouts", () => this.engine.sweepTimeouts());
       const schedules = this.options.schedules;
       if (schedules && schedules.length > 0) {
-        await runSchedules(this.engine, schedules, Date.now());
+        await this.sweep("schedules", () => runSchedules(this.engine, schedules, Date.now()));
       }
     } finally {
       this.polling = false;
     }
   }
+  /** Run one sweep, absorbing and reporting its failure — see {@link poll}. */
+  async sweep(name, run) {
+    try {
+      await run();
+    } catch (error) {
+      console.error(`[nestjs-durable] timer poll: ${name} failed; continuing:`, error);
+    }
+  }
 };
 TimerPoller = _ts_decorate9([
   Injectable9(),
@@ -1630,15 +1697,15 @@ import { DiscoveryService as DiscoveryService4, MetadataScanner as MetadataScann
 
 // src/input-validation.ts
 function classValidatorInput(cls) {
-  let cv;
-  let ct;
-  try {
-    cv = __require("class-validator");
-    ct = __require("class-transformer");
-  } catch {
-    throw new Error('@Workflow({ inputSchema }) needs the optional peers "class-validator" and "class-transformer" \u2014 install them, or pass a `validateInput` function instead.');
-  }
   return async (input) => {
+    let cv;
+    let ct;
+    try {
+      cv = await import("class-validator");
+      ct = await import("class-transformer");
+    } catch {
+      throw new Error('@Workflow({ inputSchema }) needs the optional peers "class-validator" and "class-transformer" \u2014 install them, or pass a `validateInput` function instead.');
+    }
     const instance = ct.plainToInstance(cls, input);
     const errors = await cv.validate(instance, {
       whitelist: true
@@ -2326,6 +2393,7 @@ export {
   DEAD_LETTER_METADATA,
   DURABLE_STEP_METADATA,
   DURABLE_WORKER_RUNNERS,
+  DURABLE_WORKER_RUNTIME,
   DeadLetter,
   DurableModule,
   DurableStartClient,