@dudousxd/nestjs-durable 0.33.0 → 0.34.1

package/dist/index.cjs

@@ -56,8 +56,9 @@ __export(index_exports, {
   ThinWorkflowRegistrar: () => ThinWorkflowRegistrar,
   WORKFLOW_METADATA: () => WORKFLOW_METADATA,
   Workflow: () => Workflow,
-  WorkflowEngine: () => import_nestjs_durable_core13.WorkflowEngine,
+  WorkflowEngine: () => import_nestjs_durable_core14.WorkflowEngine,
   WorkflowService: () => WorkflowService,
+  attributesOf: () => attributesOf,
   entityConfigFor: () => entityConfigFor,
   getDurableStepMeta: () => getDurableStepMeta,
   getEntityMeta: () => getEntityMeta,
@@ -68,12 +69,15 @@ __export(index_exports, {
   isDrivingOperator: () => isDrivingOperator,
   isOperatorRole: () => isOperatorRole,
   isStepInterceptor: () => isStepInterceptor,
-  readSearchAttributes: () => import_nestjs_durable_core13.readSearchAttributes,
+  readSearchAttributes: () => import_nestjs_durable_core14.readSearchAttributes,
   thinWorkerProviders: () => thinWorkerProviders,
   unavailableRunGateway: () => unavailableRunGateway
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/attributes-of.ts
+var import_nestjs_durable_core2 = require("@dudousxd/nestjs-durable-core");
+
 // src/decorators.ts
 var import_nestjs_durable_core = require("@dudousxd/nestjs-durable-core");
 var import_reflect_metadata = require("reflect-metadata");
@@ -181,9 +185,22 @@ function getOnEvents(meta, target) {
 }
 __name(getOnEvents, "getOnEvents");
 
+// src/attributes-of.ts
+function attributesOf(workflow, run) {
+  const meta = getWorkflowMeta(workflow);
+  if (!meta) {
+    throw new Error(`attributesOf: ${workflow.name} is not a @Workflow class \u2014 is it decorated with @Workflow({ name, searchAttributes })?`);
+  }
+  if (!meta.searchAttributes) {
+    throw new Error(`attributesOf: workflow '${meta.name}' declares no searchAttributes schema \u2014 reading attributes by class requires the workflow to declare its schema: @Workflow({ name: '${meta.name}', searchAttributes: mySchema }).`);
+  }
+  return (0, import_nestjs_durable_core2.readSearchAttributes)(meta.searchAttributes, run);
+}
+__name(attributesOf, "attributesOf");
+
 // src/durable-start-client.ts
 var import_durable_worker = require("@dudousxd/durable-worker");
-var import_nestjs_durable_core2 = require("@dudousxd/nestjs-durable-core");
+var import_nestjs_durable_core3 = require("@dudousxd/nestjs-durable-core");
 var import_common = require("@nestjs/common");
 function _ts_decorate(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -209,7 +226,7 @@ var DurableStartClient = class {
     this.tenant = options.partition ?? "default";
   }
   async start(workflow, input, runId = globalThis.crypto.randomUUID(), opts) {
-    const name = (0, import_nestjs_durable_core2.workflowName)(workflow);
+    const name = (0, import_nestjs_durable_core3.workflowName)(workflow);
     await (0, import_durable_worker.startRun)(this.options.connection, {
       tenant: this.tenant,
       workflow: name,
@@ -278,7 +295,7 @@ __name(tenantUnsupported, "tenantUnsupported");
 
 // src/durable-worker.module.ts
 var import_durable_worker2 = require("@dudousxd/durable-worker");
-var import_nestjs_durable_core3 = require("@dudousxd/nestjs-durable-core");
+var import_nestjs_durable_core4 = require("@dudousxd/nestjs-durable-core");
 var import_common2 = require("@nestjs/common");
 var import_core = require("@nestjs/core");
 
@@ -362,7 +379,7 @@ var ThinWorkflowRegistrar = class {
 };
 ThinWorkflowRegistrar = _ts_decorate2([
   (0, import_common2.Injectable)(),
-  _ts_param(2, (0, import_common2.Inject)(import_nestjs_durable_core3.DURABLE_OPTIONS_CANONICAL)),
+  _ts_param(2, (0, import_common2.Inject)(import_nestjs_durable_core4.DURABLE_OPTIONS_CANONICAL)),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
     typeof import_core.DiscoveryService === "undefined" ? Object : import_core.DiscoveryService,
@@ -391,7 +408,7 @@ var ThinStepRegistrar = class {
 };
 ThinStepRegistrar = _ts_decorate2([
   (0, import_common2.Injectable)(),
-  _ts_param(3, (0, import_common2.Inject)(import_nestjs_durable_core3.DURABLE_OPTIONS_CANONICAL)),
+  _ts_param(3, (0, import_common2.Inject)(import_nestjs_durable_core4.DURABLE_OPTIONS_CANONICAL)),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
     typeof import_core.DiscoveryService === "undefined" ? Object : import_core.DiscoveryService,
@@ -443,7 +460,7 @@ var ThinWorkerBootstrap = class {
 };
 ThinWorkerBootstrap = _ts_decorate2([
   (0, import_common2.Injectable)(),
-  _ts_param(1, (0, import_common2.Inject)(import_nestjs_durable_core3.DURABLE_OPTIONS_CANONICAL)),
+  _ts_param(1, (0, import_common2.Inject)(import_nestjs_durable_core4.DURABLE_OPTIONS_CANONICAL)),
   _ts_param(2, (0, import_common2.Inject)(RUN_REDIS_WORKER)),
   _ts_param(3, (0, import_common2.Inject)(DURABLE_WORKER_RUNNERS)),
   _ts_metadata2("design:type", Function),
@@ -469,7 +486,7 @@ function thinWorkerProviders() {
         workflowGroup: options.partition ?? ""
       }), "useFactory"),
       inject: [
-        import_nestjs_durable_core3.DURABLE_OPTIONS_CANONICAL
+        import_nestjs_durable_core4.DURABLE_OPTIONS_CANONICAL
       ]
     },
     {
@@ -533,12 +550,12 @@ function unavailableRunGateway() {
 __name(unavailableRunGateway, "unavailableRunGateway");
 
 // src/durable.module.ts
-var import_nestjs_durable_core12 = require("@dudousxd/nestjs-durable-core");
+var import_nestjs_durable_core13 = require("@dudousxd/nestjs-durable-core");
 var import_common12 = require("@nestjs/common");
 var import_core5 = require("@nestjs/core");
 
 // src/durable-step.registrar.ts
-var import_nestjs_durable_core4 = require("@dudousxd/nestjs-durable-core");
+var import_nestjs_durable_core5 = require("@dudousxd/nestjs-durable-core");
 var import_common3 = require("@nestjs/common");
 var import_core2 = require("@nestjs/core");
 
@@ -597,8 +614,8 @@ var DurableStepRegistrar = class {
 };
 DurableStepRegistrar = _ts_decorate3([
   (0, import_common3.Injectable)(),
-  _ts_param2(2, (0, import_common3.Inject)(import_nestjs_durable_core4.TRANSPORT_CANONICAL)),
-  _ts_param2(3, (0, import_common3.Inject)(import_nestjs_durable_core4.DURABLE_OPTIONS_CANONICAL)),
+  _ts_param2(2, (0, import_common3.Inject)(import_nestjs_durable_core5.TRANSPORT_CANONICAL)),
+  _ts_param2(3, (0, import_common3.Inject)(import_nestjs_durable_core5.DURABLE_OPTIONS_CANONICAL)),
   _ts_metadata3("design:type", Function),
   _ts_metadata3("design:paramtypes", [
     typeof import_core2.DiscoveryService === "undefined" ? Object : import_core2.DiscoveryService,
@@ -609,7 +626,7 @@ DurableStepRegistrar = _ts_decorate3([
 ], DurableStepRegistrar);
 
 // src/entity.ts
-var import_nestjs_durable_core5 = require("@dudousxd/nestjs-durable-core");
+var import_nestjs_durable_core6 = require("@dudousxd/nestjs-durable-core");
 var import_common4 = require("@nestjs/common");
 var import_reflect_metadata2 = require("reflect-metadata");
 function _ts_decorate4(decorators, target, key, desc) {
@@ -683,13 +700,13 @@ EntityService = _ts_decorate4([
   (0, import_common4.Injectable)(),
   _ts_metadata4("design:type", Function),
   _ts_metadata4("design:paramtypes", [
-    typeof import_nestjs_durable_core5.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core5.WorkflowEngine
+    typeof import_nestjs_durable_core6.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core6.WorkflowEngine
   ])
 ], EntityService);
 
 // src/in-app-worker.ts
 var import_durable_worker3 = require("@dudousxd/durable-worker");
-var import_nestjs_durable_core6 = require("@dudousxd/nestjs-durable-core");
+var import_nestjs_durable_core7 = require("@dudousxd/nestjs-durable-core");
 var import_common5 = require("@nestjs/common");
 var import_core3 = require("@nestjs/core");
 function _ts_decorate5(decorators, target, key, desc) {
@@ -782,7 +799,7 @@ var InAppWorkerBootstrap = class {
 };
 InAppWorkerBootstrap = _ts_decorate5([
   (0, import_common5.Injectable)(),
-  _ts_param3(2, (0, import_common5.Inject)(import_nestjs_durable_core6.DURABLE_OPTIONS_CANONICAL)),
+  _ts_param3(2, (0, import_common5.Inject)(import_nestjs_durable_core7.DURABLE_OPTIONS_CANONICAL)),
   _ts_param3(3, (0, import_common5.Inject)(IN_APP_WORKER_RUNTIME)),
   _ts_param3(4, (0, import_common5.Inject)(IN_APP_RUN_REDIS_WORKER)),
   _ts_param3(5, (0, import_common5.Inject)(IN_APP_WORKER_RUNNERS)),
@@ -802,8 +819,8 @@ function inAppWorkerProviders() {
       provide: IN_APP_WORKER_BINDING,
       useFactory: /* @__PURE__ */ __name((transport, options) => inAppWorkerBinding(transport, options), "useFactory"),
       inject: [
-        import_nestjs_durable_core6.TRANSPORT_CANONICAL,
-        import_nestjs_durable_core6.DURABLE_OPTIONS_CANONICAL
+        import_nestjs_durable_core7.TRANSPORT_CANONICAL,
+        import_nestjs_durable_core7.DURABLE_OPTIONS_CANONICAL
       ]
     },
     {
@@ -819,7 +836,7 @@ function inAppWorkerProviders() {
         workflowGroup: options.partition ?? ""
       }), "useFactory"),
       inject: [
-        import_nestjs_durable_core6.DURABLE_OPTIONS_CANONICAL
+        import_nestjs_durable_core7.DURABLE_OPTIONS_CANONICAL
       ]
     },
     {
@@ -986,7 +1003,7 @@ ProxyRunGateway = _ts_decorate6([
 ], ProxyRunGateway);
 
 // src/retention-poller.ts
-var import_nestjs_durable_core7 = require("@dudousxd/nestjs-durable-core");
+var import_nestjs_durable_core8 = require("@dudousxd/nestjs-durable-core");
 var import_common7 = require("@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;
@@ -1017,10 +1034,10 @@ function validateRetention(retention) {
     if (policy.maxAge == null && policy.maxCount == null) {
       throw new Error("durable retention: each policy must set maxAge and/or maxCount");
     }
-    if (policy.maxAge != null) (0, import_nestjs_durable_core7.parseDuration)(policy.maxAge);
+    if (policy.maxAge != null) (0, import_nestjs_durable_core8.parseDuration)(policy.maxAge);
     for (const status of policy.statuses) {
-      if (!import_nestjs_durable_core7.TERMINAL_RUN_STATUSES.includes(status)) {
-        throw new Error(`durable retention: status "${status}" is not terminal; only ${import_nestjs_durable_core7.TERMINAL_RUN_STATUSES.join(", ")} can be pruned`);
+      if (!import_nestjs_durable_core8.TERMINAL_RUN_STATUSES.includes(status)) {
+        throw new Error(`durable retention: status "${status}" is not terminal; only ${import_nestjs_durable_core8.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`);
@@ -1059,7 +1076,7 @@ var RetentionPoller = class {
       return;
     }
     await this.sweep();
-    const intervalMs = retention.sweepInterval != null ? (0, import_nestjs_durable_core7.parseDuration)(retention.sweepInterval) : DEFAULT_SWEEP_INTERVAL_MS;
+    const intervalMs = retention.sweepInterval != null ? (0, import_nestjs_durable_core8.parseDuration)(retention.sweepInterval) : DEFAULT_SWEEP_INTERVAL_MS;
     if (intervalMs > 0) {
       this.timer = setInterval(() => void this.sweep(), intervalMs);
       this.timer.unref?.();
@@ -1091,8 +1108,8 @@ var RetentionPoller = class {
 };
 RetentionPoller = _ts_decorate7([
   (0, import_common7.Injectable)(),
-  _ts_param4(0, (0, import_common7.Inject)(import_nestjs_durable_core7.STATE_STORE_CANONICAL)),
-  _ts_param4(1, (0, import_common7.Inject)(import_nestjs_durable_core7.DURABLE_OPTIONS_CANONICAL)),
+  _ts_param4(0, (0, import_common7.Inject)(import_nestjs_durable_core8.STATE_STORE_CANONICAL)),
+  _ts_param4(1, (0, import_common7.Inject)(import_nestjs_durable_core8.DURABLE_OPTIONS_CANONICAL)),
   _ts_metadata7("design:type", Function),
   _ts_metadata7("design:paramtypes", [
     Object,
@@ -1226,7 +1243,7 @@ var RunRequestResponder = class {
 };
 
 // src/store-run-gateway.ts
-var import_nestjs_durable_core8 = require("@dudousxd/nestjs-durable-core");
+var import_nestjs_durable_core9 = require("@dudousxd/nestjs-durable-core");
 var import_common8 = require("@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;
@@ -1275,9 +1292,9 @@ var StoreRunGateway = class {
   }
   async listRuns(query) {
     const runs = await this.store.listRuns(query);
-    const waiterByRun = (0, import_nestjs_durable_core8.indexWaitersByRun)(await this.store.listSignalWaiters(""));
+    const waiterByRun = (0, import_nestjs_durable_core9.indexWaitersByRun)(await this.store.listSignalWaiters(""));
     return runs.map((run) => {
-      const waiting = (0, import_nestjs_durable_core8.resolveRunWaiting)(run, waiterByRun);
+      const waiting = (0, import_nestjs_durable_core9.resolveRunWaiting)(run, waiterByRun);
       return waiting ? {
         ...run,
         waiting
@@ -1305,11 +1322,11 @@ var StoreRunGateway = class {
       }),
       this.store.listSignalWaiters("")
     ]);
-    const waiterByRun = (0, import_nestjs_durable_core8.indexWaitersByRun)(waiters);
+    const waiterByRun = (0, import_nestjs_durable_core9.indexWaitersByRun)(waiters);
     const result = {};
     for (const run of suspended) {
       if (!idSet.has(run.id)) continue;
-      const waiting = (0, import_nestjs_durable_core8.resolveRunWaiting)(run, waiterByRun);
+      const waiting = (0, import_nestjs_durable_core9.resolveRunWaiting)(run, waiterByRun);
       if (waiting) result[run.id] = waiting;
     }
     return result;
@@ -1343,11 +1360,11 @@ var StoreRunGateway = class {
 };
 StoreRunGateway = _ts_decorate8([
   (0, import_common8.Injectable)(),
-  _ts_param5(0, (0, import_common8.Inject)(import_nestjs_durable_core8.STATE_STORE_CANONICAL)),
+  _ts_param5(0, (0, import_common8.Inject)(import_nestjs_durable_core9.STATE_STORE_CANONICAL)),
   _ts_metadata8("design:type", Function),
   _ts_metadata8("design:paramtypes", [
     typeof StateStore === "undefined" ? Object : StateStore,
-    typeof import_nestjs_durable_core8.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core8.WorkflowEngine
+    typeof import_nestjs_durable_core9.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core9.WorkflowEngine
   ])
 ], StoreRunGateway);
 
@@ -1393,7 +1410,7 @@ var TenantEventRepublisher = class {
 };
 
 // src/timer-poller.ts
-var import_nestjs_durable_core9 = require("@dudousxd/nestjs-durable-core");
+var import_nestjs_durable_core10 = require("@dudousxd/nestjs-durable-core");
 var import_common9 = require("@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;
@@ -1449,7 +1466,7 @@ var TimerPoller = class {
       await this.engine.sweepTimeouts();
       const schedules = this.options.schedules;
       if (schedules && schedules.length > 0) {
-        await (0, import_nestjs_durable_core9.runSchedules)(this.engine, schedules, Date.now());
+        await (0, import_nestjs_durable_core10.runSchedules)(this.engine, schedules, Date.now());
       }
     } finally {
       this.polling = false;
@@ -1458,10 +1475,10 @@ var TimerPoller = class {
 };
 TimerPoller = _ts_decorate9([
   (0, import_common9.Injectable)(),
-  _ts_param6(1, (0, import_common9.Inject)(import_nestjs_durable_core9.DURABLE_OPTIONS_CANONICAL)),
+  _ts_param6(1, (0, import_common9.Inject)(import_nestjs_durable_core10.DURABLE_OPTIONS_CANONICAL)),
   _ts_metadata9("design:type", Function),
   _ts_metadata9("design:paramtypes", [
-    typeof import_nestjs_durable_core9.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core9.WorkflowEngine,
+    typeof import_nestjs_durable_core10.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core10.WorkflowEngine,
     typeof DurableModuleOptions === "undefined" ? Object : DurableModuleOptions
   ])
 ], TimerPoller);
@@ -1471,7 +1488,7 @@ var CONTEXT_ACCESSOR = Symbol.for("@dudousxd/nestjs-context:accessor");
 var RUN_GATEWAY = Symbol.for("nestjs-durable:run-gateway");
 
 // src/workflow.registrar.ts
-var import_nestjs_durable_core10 = require("@dudousxd/nestjs-durable-core");
+var import_nestjs_durable_core11 = require("@dudousxd/nestjs-durable-core");
 var import_common10 = require("@nestjs/common");
 var import_core4 = require("@nestjs/core");
 
@@ -1593,11 +1610,11 @@ var WorkflowRegistrar = class {
       const validateInput = meta.validateInput ?? (meta.inputSchema ? classValidatorInput(meta.inputSchema) : void 0);
       const eventBatch = meta.debounce ? {
         mode: "debounce",
-        windowMs: (0, import_nestjs_durable_core10.parseDuration)(meta.debounce)
+        windowMs: (0, import_nestjs_durable_core11.parseDuration)(meta.debounce)
       } : meta.batch ? {
         mode: "batch",
         maxSize: meta.batch.maxSize,
-        windowMs: (0, import_nestjs_durable_core10.parseDuration)(meta.batch.within)
+        windowMs: (0, import_nestjs_durable_core11.parseDuration)(meta.batch.within)
       } : void 0;
       const workflowCtor = workflow.constructor;
       this.engine.register(meta.name, meta.version, (ctx, input) => workflow.run(ctx, input), {
@@ -1618,11 +1635,11 @@ var WorkflowRegistrar = class {
         // so a turn dispatched under the wrong token would never be consumed. Absent → the inline fast
         // path (unchanged).
         ...this.inAppWorker ? {
-          group: (0, import_nestjs_durable_core10.tenantGroup)((0, import_nestjs_durable_core10.sanitizeQueueToken)(meta.name), this.inAppWorker.partition),
-          executor: new import_nestjs_durable_core10.RemoteWorkflowExecutor(this.inAppWorker.transport, meta.name, this.inAppWorker.partition)
+          group: (0, import_nestjs_durable_core11.tenantGroup)((0, import_nestjs_durable_core11.sanitizeQueueToken)(meta.name), this.inAppWorker.partition),
+          executor: new import_nestjs_durable_core11.RemoteWorkflowExecutor(this.inAppWorker.transport, meta.name, this.inAppWorker.partition)
         } : {}
       });
-      (0, import_nestjs_durable_core10.bindWorkflowClass)(workflowCtor, {
+      (0, import_nestjs_durable_core11.bindWorkflowClass)(workflowCtor, {
         start: /* @__PURE__ */ __name((name, input, runId, opts) => this.engine.start(name, input, runId, opts), "start"),
         waitForRun: /* @__PURE__ */ __name((runId, opts) => this.engine.waitForRun(runId, opts), "waitForRun")
       });
@@ -1635,7 +1652,7 @@ var WorkflowRegistrar = class {
         this.engine.register(dlqName, meta.version, inline);
         deadLetterByWorkflow.set(meta.name, dlqName);
       } else if (meta.deadLetterWorkflow) {
-        deadLetterByWorkflow.set(meta.name, (0, import_nestjs_durable_core10.workflowName)(meta.deadLetterWorkflow));
+        deadLetterByWorkflow.set(meta.name, (0, import_nestjs_durable_core11.workflowName)(meta.deadLetterWorkflow));
       }
     });
     this.installDeadLetterRouting(deadLetterByWorkflow);
@@ -1657,7 +1674,7 @@ var WorkflowRegistrar = class {
   * a `dlq:<runId>` id, so re-recovery never double-dispatches.
   */
   installDeadLetterRouting(byWorkflow) {
-    const fallback = this.options.deadLetterWorkflow ? (0, import_nestjs_durable_core10.workflowName)(this.options.deadLetterWorkflow) : void 0;
+    const fallback = this.options.deadLetterWorkflow ? (0, import_nestjs_durable_core11.workflowName)(this.options.deadLetterWorkflow) : void 0;
     if (byWorkflow.size === 0 && !fallback) return;
     this.engine.onDead((run) => {
       const target = byWorkflow.get(run.workflow) ?? fallback;
@@ -1682,14 +1699,14 @@ var WorkflowRegistrar = class {
 };
 WorkflowRegistrar = _ts_decorate10([
   (0, import_common10.Injectable)(),
-  _ts_param7(3, (0, import_common10.Inject)(import_nestjs_durable_core10.STATE_STORE_CANONICAL)),
-  _ts_param7(4, (0, import_common10.Inject)(import_nestjs_durable_core10.DURABLE_OPTIONS_CANONICAL)),
+  _ts_param7(3, (0, import_common10.Inject)(import_nestjs_durable_core11.STATE_STORE_CANONICAL)),
+  _ts_param7(4, (0, import_common10.Inject)(import_nestjs_durable_core11.DURABLE_OPTIONS_CANONICAL)),
   _ts_param7(5, (0, import_common10.Inject)(IN_APP_WORKER_BINDING)),
   _ts_metadata10("design:type", Function),
   _ts_metadata10("design:paramtypes", [
     typeof import_core4.DiscoveryService === "undefined" ? Object : import_core4.DiscoveryService,
     typeof import_core4.MetadataScanner === "undefined" ? Object : import_core4.MetadataScanner,
-    typeof import_nestjs_durable_core10.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core10.WorkflowEngine,
+    typeof import_nestjs_durable_core11.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core11.WorkflowEngine,
     Object,
     typeof DurableModuleOptions === "undefined" ? Object : DurableModuleOptions,
     Object
@@ -1698,7 +1715,7 @@ WorkflowRegistrar = _ts_decorate10([
 
 // src/workflow.service.ts
 var import_node_crypto = require("crypto");
-var import_nestjs_durable_core11 = require("@dudousxd/nestjs-durable-core");
+var import_nestjs_durable_core12 = require("@dudousxd/nestjs-durable-core");
 var import_common11 = require("@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;
@@ -1745,6 +1762,10 @@ var WorkflowService = class {
   * starts a fresh run of every workflow subscribed via `@Workflow({ onEvent })` / `@OnDurableEvent` (the
   * payload becomes its input). Pass `opts.id` to dedupe redeliveries. Returns how many runs it
   * touched (resumed + started).
+  *
+  * Reliable by default: a publish that touches NOBODY (no live waiter, no subscriber) buffers ONE
+  * copy so a LATER `waitForEvent(name, { match })` still consumes it instead of it being dropped —
+  * see {@link WorkflowEngine.publishEvent}'s full semantics doc. Pass `opts.buffer: false` to opt out.
   */
   publishEvent(name, payload, opts) {
     return this.engine.publishEvent(name, payload, opts);
@@ -1754,7 +1775,7 @@ WorkflowService = _ts_decorate11([
   (0, import_common11.Injectable)(),
   _ts_metadata11("design:type", Function),
   _ts_metadata11("design:paramtypes", [
-    typeof import_nestjs_durable_core11.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core11.WorkflowEngine
+    typeof import_nestjs_durable_core12.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core12.WorkflowEngine
   ])
 ], WorkflowService);
 
@@ -1929,13 +1950,13 @@ var RunGatewayBootstrap = class RunGatewayBootstrap2 {
 };
 RunGatewayBootstrap = _ts_decorate12([
   (0, import_common12.Injectable)(),
-  _ts_param8(1, (0, import_common12.Inject)(import_nestjs_durable_core12.TRANSPORT_CANONICAL)),
+  _ts_param8(1, (0, import_common12.Inject)(import_nestjs_durable_core13.TRANSPORT_CANONICAL)),
   _ts_param8(2, (0, import_common12.Inject)(RUN_GATEWAY)),
-  _ts_param8(3, (0, import_common12.Inject)(import_nestjs_durable_core12.STATE_STORE_CANONICAL)),
-  _ts_param8(4, (0, import_common12.Inject)(import_nestjs_durable_core12.DURABLE_OPTIONS_CANONICAL)),
+  _ts_param8(3, (0, import_common12.Inject)(import_nestjs_durable_core13.STATE_STORE_CANONICAL)),
+  _ts_param8(4, (0, import_common12.Inject)(import_nestjs_durable_core13.DURABLE_OPTIONS_CANONICAL)),
   _ts_metadata12("design:type", Function),
   _ts_metadata12("design:paramtypes", [
-    typeof import_nestjs_durable_core12.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core12.WorkflowEngine,
+    typeof import_nestjs_durable_core13.WorkflowEngine === "undefined" ? Object : import_nestjs_durable_core13.WorkflowEngine,
     Object,
     typeof RunGateway === "undefined" ? Object : RunGateway,
     Object,
@@ -1949,13 +1970,13 @@ var DurableModule = class _DurableModule {
   static forRoot(options) {
     _DurableModule.assertValid(options);
     return _DurableModule.build({
-      provide: import_nestjs_durable_core12.DURABLE_OPTIONS_CANONICAL,
+      provide: import_nestjs_durable_core13.DURABLE_OPTIONS_CANONICAL,
       useValue: resolveTopology(options)
     });
   }
   static forRootAsync(options) {
     return _DurableModule.build({
-      provide: import_nestjs_durable_core12.DURABLE_OPTIONS_CANONICAL,
+      provide: import_nestjs_durable_core13.DURABLE_OPTIONS_CANONICAL,
       useFactory: /* @__PURE__ */ __name(async (...args) => {
         const resolved = await options.useFactory(...args);
         _DurableModule.assertValid(resolved);
@@ -1988,37 +2009,37 @@ var DurableModule = class _DurableModule {
       providers: [
         optionsProvider,
         {
-          provide: import_nestjs_durable_core12.STATE_STORE_CANONICAL,
+          provide: import_nestjs_durable_core13.STATE_STORE_CANONICAL,
           useFactory: /* @__PURE__ */ __name((options) => options.store !== void 0 ? scopedStore(options.store, options) : null, "useFactory"),
           inject: [
-            import_nestjs_durable_core12.DURABLE_OPTIONS_CANONICAL
+            import_nestjs_durable_core13.DURABLE_OPTIONS_CANONICAL
           ]
         },
         {
-          provide: import_nestjs_durable_core12.TRANSPORT_CANONICAL,
+          provide: import_nestjs_durable_core13.TRANSPORT_CANONICAL,
           useFactory: /* @__PURE__ */ __name((options) => options.transport ?? null, "useFactory"),
           inject: [
-            import_nestjs_durable_core12.DURABLE_OPTIONS_CANONICAL
+            import_nestjs_durable_core13.DURABLE_OPTIONS_CANONICAL
           ]
         },
         // Legacy back-compat aliases (deprecated tokens still resolve to the same instances):
         {
-          provide: import_nestjs_durable_core12.STATE_STORE,
-          useExisting: import_nestjs_durable_core12.STATE_STORE_CANONICAL
+          provide: import_nestjs_durable_core13.STATE_STORE,
+          useExisting: import_nestjs_durable_core13.STATE_STORE_CANONICAL
         },
         {
-          provide: import_nestjs_durable_core12.TRANSPORT,
-          useExisting: import_nestjs_durable_core12.TRANSPORT_CANONICAL
+          provide: import_nestjs_durable_core13.TRANSPORT,
+          useExisting: import_nestjs_durable_core13.TRANSPORT_CANONICAL
         },
         {
-          provide: import_nestjs_durable_core12.DURABLE_OPTIONS,
-          useExisting: import_nestjs_durable_core12.DURABLE_OPTIONS_CANONICAL
+          provide: import_nestjs_durable_core13.DURABLE_OPTIONS,
+          useExisting: import_nestjs_durable_core13.DURABLE_OPTIONS_CANONICAL
         },
         {
           // Shared token, bound EXACTLY once: a real engine for the operator role, or a store-less
           // `DurableStartClient` facade for a thin worker (no `store`) — either way, `WorkflowService`
           // and app code call `engine.start(...)` unchanged.
-          provide: import_nestjs_durable_core12.WorkflowEngine,
+          provide: import_nestjs_durable_core13.WorkflowEngine,
           useFactory: /* @__PURE__ */ __name(async (options, store, transport, moduleRef) => {
             if (options.store === void 0) {
               return new DurableStartClient(options);
@@ -2031,7 +2052,7 @@ var DurableModule = class _DurableModule {
             const context = options.context ?? (accessor ? () => carrierFromAccessor(accessor) : void 0);
             const runtime = accessor ? await resolveContextRuntime() : void 0;
             const rehydrate = runtime && ((carrier, fn) => carrier && Object.keys(carrier).length > 0 ? runtime.deserialize(carrier, fn) : fn());
-            const engine = new import_nestjs_durable_core12.WorkflowEngine({
+            const engine = new import_nestjs_durable_core13.WorkflowEngine({
               store,
               transport: transport ?? void 0,
               transports: options.transports,
@@ -2062,9 +2083,9 @@ var DurableModule = class _DurableModule {
             return engine;
           }, "useFactory"),
           inject: [
-            import_nestjs_durable_core12.DURABLE_OPTIONS_CANONICAL,
-            import_nestjs_durable_core12.STATE_STORE_CANONICAL,
-            import_nestjs_durable_core12.TRANSPORT_CANONICAL,
+            import_nestjs_durable_core13.DURABLE_OPTIONS_CANONICAL,
+            import_nestjs_durable_core13.STATE_STORE_CANONICAL,
+            import_nestjs_durable_core13.TRANSPORT_CANONICAL,
             import_core5.ModuleRef
           ]
         },
@@ -2089,9 +2110,9 @@ var DurableModule = class _DurableModule {
             return options.transport ? new ProxyRunGateway(options.transport, options.partition ?? "default", options.runGatewayTimeoutMs) : unavailableRunGateway();
           }, "useFactory"),
           inject: [
-            import_nestjs_durable_core12.DURABLE_OPTIONS_CANONICAL,
-            import_nestjs_durable_core12.STATE_STORE_CANONICAL,
-            import_nestjs_durable_core12.WorkflowEngine
+            import_nestjs_durable_core13.DURABLE_OPTIONS_CANONICAL,
+            import_nestjs_durable_core13.STATE_STORE_CANONICAL,
+            import_nestjs_durable_core13.WorkflowEngine
           ]
         },
         RunGatewayBootstrap,
@@ -2105,12 +2126,12 @@ var DurableModule = class _DurableModule {
       exports: [
         WorkflowService,
         EntityService,
-        import_nestjs_durable_core12.WorkflowEngine,
-        import_nestjs_durable_core12.STATE_STORE,
-        import_nestjs_durable_core12.STATE_STORE_CANONICAL,
-        import_nestjs_durable_core12.TRANSPORT,
-        import_nestjs_durable_core12.TRANSPORT_CANONICAL,
-        import_nestjs_durable_core12.DURABLE_OPTIONS_CANONICAL,
+        import_nestjs_durable_core13.WorkflowEngine,
+        import_nestjs_durable_core13.STATE_STORE,
+        import_nestjs_durable_core13.STATE_STORE_CANONICAL,
+        import_nestjs_durable_core13.TRANSPORT,
+        import_nestjs_durable_core13.TRANSPORT_CANONICAL,
+        import_nestjs_durable_core13.DURABLE_OPTIONS_CANONICAL,
         RUN_GATEWAY
       ]
     };
@@ -2121,7 +2142,7 @@ DurableModule = _ts_decorate12([
 ], DurableModule);
 
 // src/index.ts
-var import_nestjs_durable_core13 = require("@dudousxd/nestjs-durable-core");
+var import_nestjs_durable_core14 = require("@dudousxd/nestjs-durable-core");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CONTEXT_ACCESSOR,
@@ -2161,6 +2182,7 @@ var import_nestjs_durable_core13 = require("@dudousxd/nestjs-durable-core");
   Workflow,
   WorkflowEngine,
   WorkflowService,
+  attributesOf,
   entityConfigFor,
   getDurableStepMeta,
   getEntityMeta,