@dudousxd/nestjs-durable 0.48.0 → 0.48.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudousxd/nestjs-durable",
-  "version": "0.48.0",
+  "version": "0.48.1",
   "description": "Durable workflows for NestJS — module, decorators, discovery and boot recovery",
   "license": "MIT",
   "author": "Davide Carvalho",
@@ -67,12 +67,12 @@
     "tsup": "8.3.5",
     "@dudousxd/nestjs-diagnostics": "0.5.0",
     "@tanstack/intent": "0.4.0",
-    "@dudousxd/durable-worker": "0.11.0",
-    "@dudousxd/nestjs-durable-core": "^0.79.0",
+    "@dudousxd/durable-worker": "0.11.2",
+    "@dudousxd/nestjs-durable-core": "^0.80.0",
     "@dudousxd/nestjs-durable-dashboard": "0.51.0",
-    "@dudousxd/nestjs-durable-testing": "^0.18.0",
-    "@dudousxd/nestjs-durable-transport-bullmq": "0.22.1",
-    "@dudousxd/nestjs-durable-transport-event-emitter": "^0.5.1"
+    "@dudousxd/nestjs-durable-testing": "^0.19.0",
+    "@dudousxd/nestjs-durable-transport-bullmq": "0.22.3",
+    "@dudousxd/nestjs-durable-transport-event-emitter": "^0.5.2"
   },
   "module": "./dist/index.js",
   "exports": {

package/skills/durable-setup/SKILL.md

@@ -76,6 +76,10 @@ await app.listen(3000);
 
 `start` **enqueues** the run and returns immediately with `{ runId, status: 'pending' }` — a worker
 runs the body, so the HTTP handler never blocks. Pass the workflow **class** for a typed input.
+Pass `opts.startAt` (epoch ms or a `Date`) to delay the start: the run is created `suspended` with
+its `wakeAt` set (the same durable timer `ctx.sleep` parks on, resumed by the timer poller once
+due), and `start` returns `{ runId, status: 'suspended' }` instead. A time that is not in the
+future starts the run at once.
 
 ```ts
 import { WorkflowService } from '@dudousxd/nestjs-durable';
@@ -158,7 +162,7 @@ name automatically; there's no `groups`/`remoteByConvention` flag to opt into.
 ### 1. Expecting `start` to return the workflow's result
 
 ```ts
-// ✗ Wrong — `start` enqueues; `result` is { runId, status: 'pending' }, never the run output
+// ✗ Wrong — `start` enqueues; `result` is { runId, status: 'pending' } (or 'suspended' with startAt), never the run output
 const result = await this.workflows.start(CheckoutWorkflow, order);
 return result.output; // undefined
 
@@ -167,7 +171,8 @@ const { runId } = await this.workflows.start(CheckoutWorkflow, order);
 return this.workflows.waitForRun(runId); // resolves once the run settles
 ```
 
-`start` creates the run as `'pending'` and a worker runs the body asynchronously; only `waitForRun`
+`start` creates the run as `'pending'` (or `'suspended'` when `opts.startAt` is in the future)
+and a worker runs the body asynchronously; only `waitForRun`
 resolves with the settled outcome. Source: packages/nestjs/src/workflow.service.ts.
 
 ### 2. Leaving `autoSchema` on in production

package/skills/durable-workflows/SKILL.md

@@ -302,7 +302,7 @@ class InvalidLine extends FatalError {
 
 @OnError(InvalidLine) // or @OnError('invalid_line'); @OnError() catches anything else
 async invalid(ctx: WorkflowCtx, failure: OnErrorInput<Line>): Promise<LineResult> {
-  await ctx.step(this.steps.recordDeadLetter, { line: failure.input, error: failure.error.message });
+  await ctx.step(this.steps.recordRejectedLine, { line: failure.input, error: failure.error.message });
   return { ok: 0, failed: 1 };
 }
 ```