@adonis-agora/durable 0.54.2 → 0.55.0

package/skills/durable-transports-stores/SKILL.md

@@ -296,15 +296,17 @@ export default defineConfig({
 })
 ```
 
-A custom store should implement `countCheckpoints(runId, fromSeq, toSeq,
-statuses)` as a `COUNT` (the step-fan join barrier asks it once per fan per
-batch, skipped while more of the same fan's results are queued behind the batch;
-without it the engine loads the run's checkpoints to count), implement
+A custom store should implement `hasCheckpoints(runId, fromSeq, toSeq,
+statuses)` as one `SELECT seq ... ORDER BY seq DESC LIMIT 1` (the step-fan join
+barrier asks it once per fan per batch, skipped while more of the same fan's
+results are queued behind the batch; without it the engine asks
+`countCheckpoints`), `countCheckpoints` as a `COUNT` (without either the engine
+loads the run's checkpoints), implement
 `saveCheckpointIfPending` as one conditional `UPDATE ... WHERE status = 'pending'`
 (without it a blind save can put a settled step back to `pending`), and return
 `listDueTimers` most overdue first, with or without a `limit`. Run
 `runStateStoreContract` from `@adonis-agora/durable/testing/conformance`, which
-covers all three and fails a store missing either method. The contract also
+covers each of them and fails a store missing one of these methods. The contract also
 requires `saveCheckpointsIfPending` (batched result settling), `deleteRuns`
 (batched retention/purge deletes), `runFacets`, `pruneBufferedEvents`
 (`eventBufferTtl`) and the `checkpointStats` + `queryCheckpoints` pair (the run

package/skills/durable-workflows/SKILL.md

@@ -41,9 +41,11 @@ A modular app (one folder per bounded context) lists several directories:
 `workflowsPath` and `stepsPath` in `config/durable.ts` take an array, and so
 does the `source` option of the `workflowsHook` / `stepsHook` codegen hooks.
 Names must be unique across those directories. To register one more directory
-from a preload, call `registerWorkflowsFromDir(engine, dir)` and
-`registerStepsFromDir(engine, dir)`. The engine serves steps through its
-transport (`engine.handle`).
+from a preload, call `registerWorkflowsFromDir(engine, dir, factory?)` and
+`registerStepsFromDir(engine, dir, factory?)`. The engine serves steps through its
+transport (`engine.handle`). Pass `(Ctor) => app.container.make(Ctor)` as the
+factory for constructor DI (for steps it runs on every execution); without it
+classes are built once with `new Ctor()`.
 
 ## Setup
 
@@ -78,8 +80,11 @@ fire-and-forget child instead of a top-level run.
 
 ### Pattern 1 — typed steps with `@Step`, `defineStep`, and DI
 
-Steps are discovered from `app/steps` and served by name automatically. A
-`@Step` method ref passed to `ctx.step` gives full input/output typing:
+Steps are discovered from `app/steps` and served by name automatically. Each
+`@Step` class is resolved through the container on every execution (like an
+`@adonisjs/queue` job), so it can take `@inject()` constructor dependencies and
+a `container.swap(...)` after boot reaches the next execution. A `@Step` method ref passed to `ctx.step`
+gives full input/output typing:
 
 ```ts title="app/steps/payment_steps.ts"
 import { Step } from '@adonis-agora/durable'
@@ -123,7 +128,7 @@ export default class OrderWorkflow extends BaseWorkflow {
 }
 ```
 
-The instance is built once at registration and reused for every run — treat the
+The workflow instance is built once at registration and reused for every run — treat the
 constructor as wiring; keep per-run state in input and step outputs, never on
 `this`. Injected services are for **composing**, not doing work: reach them
 through step refs so the work is checkpointed.