@adonis-agora/durable 0.7.0 → 0.8.1

package/dist/src/workflow-discovery.d.ts

@@ -1,20 +1,23 @@
 import type { WorkflowEngine } from './engine.js';
 import { type WorkflowClass, type WorkflowMeta } from './workflow-ref.js';
-/** A discovered, decorated workflow class plus the metadata its `@Workflow` decorator stamped. */
+/** A discovered workflow class plus its resolved {@link WorkflowMeta} — from a `BaseWorkflow`
+ *  subclass's `static workflow` config. */
 export interface DiscoveredWorkflow {
     meta: WorkflowMeta;
     cls: WorkflowClass;
 }
 /**
- * Register a single `@Workflow`-decorated class on the engine: instantiate it once and bind its
- * `run(ctx, input)` as the workflow body via `engine.register`. The low-level
- * `engine.register(name, version, fn)` stays the escape hatch — this is the convenience the
- * `app/workflows` convention builds on. No-op (returns `false`) for an undecorated class.
+ * Register a single workflow class on the engine — a `BaseWorkflow` subclass (its `static workflow`
+ * config), resolved via {@link workflowMeta}. Instantiates it once and binds its `run(ctx, input)`
+ * as the workflow body via `engine.register`. The low-level `engine.register(name, version, fn)`
+ * stays the escape hatch — this is the convenience the `app/workflows` convention builds on. No-op
+ * (returns `false`) for a non-workflow class (no `static workflow` config).
  */
 export declare function registerWorkflowClass(engine: WorkflowEngine, cls: unknown): boolean;
 /**
- * Scan a directory RECURSIVELY for modules and collect every exported `@Workflow`-decorated class
- * (the default export and any named export are considered) — so nested conventions like
+ * Scan a directory RECURSIVELY for modules and collect every exported workflow class — a
+ * `BaseWorkflow` subclass (the default export and any named export are considered) — so nested
+ * conventions like
  * `app/workflows/billing/charge_workflow.ts` are found, matching `make:workflow`'s nested-path
  * scaffolding. Only the environment-appropriate extension is imported (see {@link MODULE_EXT}), and
  * each module path is visited once, so a built `.js` and a dev `.ts` of the same module never both
@@ -23,23 +26,26 @@ export declare function registerWorkflowClass(engine: WorkflowEngine, cls: unkno
  */
 export declare function discoverWorkflows(dir: string): Promise<DiscoveredWorkflow[]>;
 /**
- * Discover every `@Workflow` class under `dir` and register each on the engine. Returns the
- * registered metadata so the caller can log what was wired. Best-effort over a missing directory.
+ * Discover every workflow class (`BaseWorkflow` subclass) under `dir` and register each on the
+ * engine. Returns the registered metadata so the caller can log what was wired.
+ * Best-effort over a missing directory.
  */
 export declare function registerWorkflowsFromDir(engine: WorkflowEngine, dir: string): Promise<WorkflowMeta[]>;
 /**
  * The shape of the build-time barrel generated by the Assembler `init` hook
  * (`@adonis-agora/durable/hooks/workflows`): a map of stable key → lazy module import, e.g.
  * `{ Charge: () => import('#workflows/charge_workflow') }`. The exact key is irrelevant here — we
- * register every `@Workflow`-decorated export of every module, identical to the runtime scan.
+ * register every workflow export of every module (`BaseWorkflow` subclass), identical to the runtime
+ * scan.
  */
 export type WorkflowsBarrel = Record<string, () => Promise<Record<string, unknown>>>;
 /**
- * Register every `@Workflow` class reachable from a generated {@link WorkflowsBarrel}, by awaiting
- * each lazy module import and registering each decorated export — the build-time equivalent of
- * {@link registerWorkflowsFromDir}, with no runtime `readdir`. Each module is imported once and each
- * decorated class registered once (deduped), so a class re-exported from several modules is safe.
- * Returns the registered metadata so the caller can log what was wired.
+ * Register every workflow class reachable from a generated {@link WorkflowsBarrel} (`BaseWorkflow`
+ * subclass), by awaiting each lazy module import and registering each
+ * workflow export — the build-time equivalent of {@link registerWorkflowsFromDir}, with no runtime
+ * `readdir`. Each module is imported once and each class registered once (deduped), so a class
+ * re-exported from several modules is safe. Returns the registered metadata so the caller can log
+ * what was wired.
  */
 export declare function registerWorkflowsFromBarrel(engine: WorkflowEngine, barrel: WorkflowsBarrel): Promise<WorkflowMeta[]>;
 //# sourceMappingURL=workflow-discovery.d.ts.map

package/dist/src/workflow-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-discovery.d.ts","sourceRoot":"","sources":["../../src/workflow-discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAgB,MAAM,mBAAmB,CAAC;AAExF,kGAAkG;AAClG,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,aAAa,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAgBnF;AAUD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAuBlF;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAErF;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CAezB"}
+{"version":3,"file":"workflow-discovery.d.ts","sourceRoot":"","sources":["../../src/workflow-discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAgB,MAAM,mBAAmB,CAAC;AAExF;2CAC2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,aAAa,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAgBnF;AAUD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAuBlF;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAErF;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CAezB"}

package/dist/src/workflow-discovery.js

@@ -3,10 +3,11 @@ import { extname, join } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { workflowMeta } from './workflow-ref.js';
 /**
- * Register a single `@Workflow`-decorated class on the engine: instantiate it once and bind its
- * `run(ctx, input)` as the workflow body via `engine.register`. The low-level
- * `engine.register(name, version, fn)` stays the escape hatch — this is the convenience the
- * `app/workflows` convention builds on. No-op (returns `false`) for an undecorated class.
+ * Register a single workflow class on the engine — a `BaseWorkflow` subclass (its `static workflow`
+ * config), resolved via {@link workflowMeta}. Instantiates it once and binds its `run(ctx, input)`
+ * as the workflow body via `engine.register`. The low-level `engine.register(name, version, fn)`
+ * stays the escape hatch — this is the convenience the `app/workflows` convention builds on. No-op
+ * (returns `false`) for a non-workflow class (no `static workflow` config).
  */
 export function registerWorkflowClass(engine, cls) {
     const meta = workflowMeta(cls);
@@ -29,8 +30,9 @@ export function registerWorkflowClass(engine, cls) {
  */
 const MODULE_EXT = extname(import.meta.url || '') === '.ts' ? '.ts' : '.js';
 /**
- * Scan a directory RECURSIVELY for modules and collect every exported `@Workflow`-decorated class
- * (the default export and any named export are considered) — so nested conventions like
+ * Scan a directory RECURSIVELY for modules and collect every exported workflow class — a
+ * `BaseWorkflow` subclass (the default export and any named export are considered) — so nested
+ * conventions like
  * `app/workflows/billing/charge_workflow.ts` are found, matching `make:workflow`'s nested-path
  * scaffolding. Only the environment-appropriate extension is imported (see {@link MODULE_EXT}), and
  * each module path is visited once, so a built `.js` and a dev `.ts` of the same module never both
@@ -66,8 +68,9 @@ export async function discoverWorkflows(dir) {
     return found;
 }
 /**
- * Discover every `@Workflow` class under `dir` and register each on the engine. Returns the
- * registered metadata so the caller can log what was wired. Best-effort over a missing directory.
+ * Discover every workflow class (`BaseWorkflow` subclass) under `dir` and register each on the
+ * engine. Returns the registered metadata so the caller can log what was wired.
+ * Best-effort over a missing directory.
  */
 export async function registerWorkflowsFromDir(engine, dir) {
     const discovered = await discoverWorkflows(dir);
@@ -76,11 +79,12 @@ export async function registerWorkflowsFromDir(engine, dir) {
     return discovered.map((d) => d.meta);
 }
 /**
- * Register every `@Workflow` class reachable from a generated {@link WorkflowsBarrel}, by awaiting
- * each lazy module import and registering each decorated export — the build-time equivalent of
- * {@link registerWorkflowsFromDir}, with no runtime `readdir`. Each module is imported once and each
- * decorated class registered once (deduped), so a class re-exported from several modules is safe.
- * Returns the registered metadata so the caller can log what was wired.
+ * Register every workflow class reachable from a generated {@link WorkflowsBarrel} (`BaseWorkflow`
+ * subclass), by awaiting each lazy module import and registering each
+ * workflow export — the build-time equivalent of {@link registerWorkflowsFromDir}, with no runtime
+ * `readdir`. Each module is imported once and each class registered once (deduped), so a class
+ * re-exported from several modules is safe. Returns the registered metadata so the caller can log
+ * what was wired.
  */
 export async function registerWorkflowsFromBarrel(engine, barrel) {
     const registered = [];

package/dist/src/workflow-discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-discovery.js","sourceRoot":"","sources":["../../src/workflow-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAyC,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQxF;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAsB,EAAE,GAAY;IACxE,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,IAAI,GAAG,GAAkF,CAAC;IAChG,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;IAC5B,MAAM,CAAC,QAAQ,CACb,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,OAAO,EACZ,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,EACzD;QACE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnD,CACF,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAE5E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAChE,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,UAAU,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,UAAU,EAAE,CAAC;YAAE,SAAS;QACjF,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAA4B,CAAC;QAC5F,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACjC,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAyB,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAsB,EACtB,GAAW;IAEX,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAChD,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,UAAU;QAAE,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAUD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAsB,EACtB,MAAuB;IAEvB,MAAM,UAAU,GAAmB,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,IAAI,EAAE,CAAC;QACzB,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACjC,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACnB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACxC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}
+{"version":3,"file":"workflow-discovery.js","sourceRoot":"","sources":["../../src/workflow-discovery.ts"],"names":[],"mappings":"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"}

package/dist/src/workflow-ref.d.ts

@@ -5,14 +5,7 @@
  * `ctx.child(ShippingWorkflow, input)` type-checks the input and returns a typed result — while a
  * string stays available for the cross-runtime case.
  */
-/**
- * The symbol the `@Workflow` decorator stamps the full options onto (name + version + tags …), so
- * auto-discovery can register the class against the engine and a class ref can be resolved back to
- * its name via {@link workflowName}. A global-registry symbol (`Symbol.for`) so it survives duplicate
- * copies of this package in a dependency tree.
- */
-export declare const WORKFLOW_META_KEY: unique symbol;
-/** Options passed to `@Workflow({ name, version, … })`. */
+/** Options for a workflow's `static workflow = { name, version, … }` config (see {@link BaseWorkflow}). */
 export interface WorkflowOptions {
     /** The registered workflow name (the cross-runtime identity, e.g. `order`). */
     name: string;
@@ -25,29 +18,18 @@ export interface WorkflowOptions {
     /** Event names that start a run of this workflow when published (see `onEvent`). */
     onEvent?: string[];
 }
-/** The metadata the `@Workflow` decorator stamps onto a class for discovery + registration. */
+/** The metadata read off a workflow class's `static workflow` config for discovery + registration. */
 export interface WorkflowMeta extends WorkflowOptions {
     version: string;
 }
 /**
- * Class decorator marking a class as a durable workflow. Stamps the full options (name + version +
- * tags …) so a class ref resolves via {@link workflowName} and the provider's `app/workflows`
- * auto-discovery can register it on the engine — no manual `engine.register(...)`. The class must
- * expose `run(ctx, input)`; that method becomes the workflow body.
- *
- * ```ts
- * @Workflow({ name: 'order', version: '1' })
- * export default class OrderWorkflow {
- *   async run(ctx: WorkflowCtx, input: { id: string }) { ... }
- * }
- * ```
+ * Read a class's {@link WorkflowMeta} — its name/version/tags/… — from its `static workflow =
+ * { name, version, … }` config (the {@link BaseWorkflow} authoring form). Any absent `version` is
+ * normalized to `'1'`. Returns `undefined` for a class carrying no valid config (a class with no
+ * `static workflow`, or one whose `name` is not a string, is not a registrable workflow).
  */
-export declare function Workflow(options: WorkflowOptions): <T extends abstract new (...args: never[]) => {
-    run(ctx: never, input: never): unknown;
-}>(target: T) => T;
-/** Read the {@link WorkflowMeta} a `@Workflow` decorator stamped on a class, or `undefined`. */
 export declare function workflowMeta(target: unknown): WorkflowMeta | undefined;
-/** Structural shape of a `@Workflow` class — its `run(ctx, input)` carries the input/output types. */
+/** Structural shape of a workflow class — its `run(ctx, input)` carries the input/output types. */
 export type WorkflowClass<TInput = unknown, TOutput = unknown> = abstract new (...args: never[]) => {
     run(ctx: never, input: TInput): Promise<TOutput> | TOutput;
 };
@@ -63,8 +45,8 @@ export type WorkflowOutputOf<C> = C extends abstract new (...args: never[]) => {
 } ? Awaited<R> : unknown;
 /**
  * Resolve a {@link WorkflowRef} to its registered workflow name: a string is returned as-is; a
- * `@Workflow` class is resolved via the name the decorator stamped in its metadata. Throws if a
- * class was never decorated (so it carries no registered name).
+ * workflow class is resolved via the name on its `static workflow` config. Throws if a class carries
+ * no `static workflow` config (so it has no registered name).
  */
 export declare function workflowName(ref: WorkflowRef): string;
 //# sourceMappingURL=workflow-ref.d.ts.map

package/dist/src/workflow-ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-ref.d.ts","sourceRoot":"","sources":["../../src/workflow-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAAmD,CAAC;AAE3F,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,+FAA+F;AAC/F,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,IACvC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK;IAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAA;CAAE,EAC7F,QAAQ,CAAC,KACR,CAAC,CASL;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAGtE;AAED,sGAAsG;AACtG,MAAM,MAAM,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,MACvE,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC5D,CAAC;AAEF,yGAAyG;AACzG,MAAM,MAAM,WAAW,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IACvD,MAAM,GACN,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnC,uDAAuD;AACvD,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,MACjD,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;CAC1C,GACG,CAAC,GACD,OAAO,CAAC;AAEZ,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,MAClD,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC;CACxC,GACG,OAAO,CAAC,CAAC,CAAC,GACV,OAAO,CAAC;AAEZ;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CASrD"}
+{"version":3,"file":"workflow-ref.d.ts","sourceRoot":"","sources":["../../src/workflow-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2GAA2G;AAC3G,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,sGAAsG;AACtG,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAOtE;AAED,mGAAmG;AACnG,MAAM,MAAM,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,MACvE,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC5D,CAAC;AAEF,yGAAyG;AACzG,MAAM,MAAM,WAAW,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IACvD,MAAM,GACN,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnC,uDAAuD;AACvD,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,MACjD,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;CAC1C,GACG,CAAC,GACD,OAAO,CAAC;AAEZ,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,MAClD,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC;CACxC,GACG,OAAO,CAAC,CAAC,CAAC,GACV,OAAO,CAAC;AAEZ;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CASrD"}

package/dist/src/workflow-ref.js

@@ -6,53 +6,31 @@
  * string stays available for the cross-runtime case.
  */
 /**
- * The symbol the `@Workflow` decorator stamps the full options onto (name + version + tags …), so
- * auto-discovery can register the class against the engine and a class ref can be resolved back to
- * its name via {@link workflowName}. A global-registry symbol (`Symbol.for`) so it survives duplicate
- * copies of this package in a dependency tree.
+ * Read a class's {@link WorkflowMeta} — its name/version/tags/… — from its `static workflow =
+ * { name, version, … }` config (the {@link BaseWorkflow} authoring form). Any absent `version` is
+ * normalized to `'1'`. Returns `undefined` for a class carrying no valid config (a class with no
+ * `static workflow`, or one whose `name` is not a string, is not a registrable workflow).
  */
-export const WORKFLOW_META_KEY = Symbol.for('@agora/durable:workflow-meta');
-/**
- * Class decorator marking a class as a durable workflow. Stamps the full options (name + version +
- * tags …) so a class ref resolves via {@link workflowName} and the provider's `app/workflows`
- * auto-discovery can register it on the engine — no manual `engine.register(...)`. The class must
- * expose `run(ctx, input)`; that method becomes the workflow body.
- *
- * ```ts
- * @Workflow({ name: 'order', version: '1' })
- * export default class OrderWorkflow {
- *   async run(ctx: WorkflowCtx, input: { id: string }) { ... }
- * }
- * ```
- */
-export function Workflow(options) {
-    return (target) => {
-        const meta = { ...options, version: options.version ?? '1' };
-        Object.defineProperty(target, WORKFLOW_META_KEY, {
-            value: meta,
-            enumerable: false,
-            configurable: true,
-        });
-        return target;
-    };
-}
-/** Read the {@link WorkflowMeta} a `@Workflow` decorator stamped on a class, or `undefined`. */
 export function workflowMeta(target) {
     if (typeof target !== 'function')
         return undefined;
-    return target[WORKFLOW_META_KEY];
+    const config = target.workflow;
+    if (config && typeof config === 'object' && typeof config.name === 'string') {
+        return { ...config, version: config.version ?? '1' };
+    }
+    return undefined;
 }
 /**
  * Resolve a {@link WorkflowRef} to its registered workflow name: a string is returned as-is; a
- * `@Workflow` class is resolved via the name the decorator stamped in its metadata. Throws if a
- * class was never decorated (so it carries no registered name).
+ * workflow class is resolved via the name on its `static workflow` config. Throws if a class carries
+ * no `static workflow` config (so it has no registered name).
  */
 export function workflowName(ref) {
     if (typeof ref === 'string')
         return ref;
     const name = workflowMeta(ref)?.name;
     if (!name) {
-        throw new Error(`workflow class ${ref.name} has no registered name — is it decorated with @Workflow({ name })?`);
+        throw new Error(`workflow class ${ref.name} has no registered name — does it declare \`static workflow = { name }\`?`);
     }
     return name;
 }

package/dist/src/workflow-ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-ref.js","sourceRoot":"","sources":["../../src/workflow-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAkB,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AAqB3F;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAwB;IAC/C,OAAO,CACL,MAAS,EACN,EAAE;QACL,MAAM,IAAI,GAAiB,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;QAC3E,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE;YAC/C,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,IAAI,OAAO,MAAM,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IACnD,OAAQ,MAAiD,CAAC,iBAAiB,CAAC,CAAC;AAC/E,CAAC;AAgCD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAgB;IAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,kBAAkB,GAAG,CAAC,IAAI,qEAAqE,CAChG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"workflow-ref.js","sourceRoot":"","sources":["../../src/workflow-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,IAAI,OAAO,MAAM,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IACnD,MAAM,MAAM,GAAI,MAAyC,CAAC,QAAQ,CAAC;IACnE,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5E,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAgCD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAgB;IAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,kBAAkB,GAAG,CAAC,IAAI,2EAA2E,CACtG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/stubs/database/migrations/create_durable_tables.stub

@@ -5,7 +5,7 @@ import { BaseSchema } from '@adonisjs/lucid/schema'
 
 /**
  * Durable workflow tables for the @adonis-agora/durable `lucid` state store: runs, step checkpoints, the
- * search-attribute side-table, signal waiters and buffered signals. JSON payloads are stored as TEXT (the store
+ * search-attribute side-table, signal waiters, buffered signals and buffered events. JSON payloads are stored as TEXT (the store
  * (de)serializes them) and timestamps as epoch-ms integers, so the schema is portable across
  * SQLite / Postgres / MySQL.
  */
@@ -79,9 +79,21 @@ export default class extends BaseSchema {
       table.text('payload')
       table.index(['token'], 'durable_buffered_signals_token_idx')
     })
+
+    // Reliable (buffered) events: a publish matching no live waiter keeps ONE copy here, consumed by
+    // the first future matching `waitForEvent`. Keyed by `name` (many waiters share a name with
+    // different `match`); `id` is the caller-minted PK; `published_at` is epoch-ms.
+    this.schema.createTable('durable_buffered_events', (table) => {
+      table.string('id').primary()
+      table.string('name').notNullable()
+      table.text('payload')
+      table.bigInteger('published_at').notNullable()
+      table.index(['name', 'published_at'], 'durable_buffered_events_name_idx')
+    })
   }
 
   async down() {
+    this.schema.dropTableIfExists('durable_buffered_events')
     this.schema.dropTableIfExists('durable_buffered_signals')
     this.schema.dropTableIfExists('durable_signal_waiters')
     this.schema.dropTableIfExists('durable_run_attributes')

package/dist/stubs/make/workflow/main.stub

@@ -6,15 +6,16 @@
     to: app.makePath('app/workflows', entity.path, workflowFileName + '.ts')
   })
 }}}
-import { Workflow } from '@adonis-agora/durable'
+import { BaseWorkflow } from '@adonis-agora/durable'
 import type { WorkflowCtx } from '@adonis-agora/durable'
 
 interface {{ workflowName }}Input {
   // Define your workflow input here
 }
 
-@Workflow({ name: '{{ registeredName }}', version: '1' })
-export default class {{ workflowName }}Workflow {
+export default class {{ workflowName }}Workflow extends BaseWorkflow {
+  static workflow = { name: '{{ registeredName }}', version: '1' }
+
   async run(ctx: WorkflowCtx, input: {{ workflowName }}Input) {
     // Your workflow logic here — compose ctx.step / ctx.localStep / ctx.child / ctx.sleep …
     return input

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/durable",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Durable cross-app workflows for AdonisJS — deterministic replay engine, AdonisJS binding, ace commands, dashboard, OpenTelemetry, Telescope, testing harness and Redis admission, all in one package. Part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
@@ -18,6 +18,11 @@
       "import": "./dist/src/index.js",
       "default": "./dist/src/index.js"
     },
+    "./services/main": {
+      "types": "./dist/src/services/main.d.ts",
+      "import": "./dist/src/services/main.js",
+      "default": "./dist/src/services/main.js"
+    },
     "./durable_provider": {
       "types": "./dist/providers/durable_provider.d.ts",
       "import": "./dist/providers/durable_provider.js",