@adonis-agora/durable 0.19.2 → 0.21.0

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

@@ -6,7 +6,7 @@
  * string stays available for the cross-runtime case.
  */
 import type { SingletonConfig } from './engine.js';
-import type { ScheduledWorkflow } from './scheduler.js';
+import type { ScheduledWorkflow, WorkflowScheduleConfig } from './scheduler.js';
 /** 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`). */
@@ -54,6 +54,30 @@ export declare function workflowMeta(target: unknown): WorkflowMeta | undefined;
  * (not a registrable workflow) or no `static schedule`.
  */
 export declare function workflowSchedules(target: unknown): ScheduledWorkflow[];
+/**
+ * Class-decorator form of the colocated schedule — the same declaration `static schedule = {...}`
+ * makes, for codebases that prefer decorators:
+ *
+ * ```ts
+ * @Scheduled({ cron: '0 4 * * *', timezone: 'America/Sao_Paulo' })
+ * export default class CrawlWorkflow extends BaseWorkflow {
+ *   static workflow = { name: 'crawl' }
+ *   async run(ctx: WorkflowCtx) { … }
+ * }
+ * ```
+ *
+ * It only stamps `static schedule` on the class — normalization (key defaults, `workflow` fill-in)
+ * stays in {@link workflowSchedules}, so both authoring forms behave identically, including the
+ * requirement of a `static workflow` config (a decorated class without one is not registrable and
+ * its schedules are ignored, same as a bare `static schedule`).
+ *
+ * Composes: repeated `@Scheduled(...)` applications and an existing `static schedule` accumulate.
+ * Decorators apply bottom-up, so each application PREPENDS — the final array reads in **source
+ * order** (top decorator first, then lower ones, then the `static schedule` literal). With several
+ * schedules on one class, prefer explicit `key`s over the positional `${name}:${i}` defaults: the
+ * key is part of the deterministic run id, and reordering declarations would silently re-key them.
+ */
+export declare function Scheduled(config: WorkflowScheduleConfig | WorkflowScheduleConfig[]): ClassDecorator;
 /** 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;

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,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAA0B,MAAM,gBAAgB,CAAC;AAEhF,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;IACnB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;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;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,EAAE,CAWtE;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"}
+{"version":3,"file":"workflow-ref.d.ts","sourceRoot":"","sources":["../../src/workflow-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEhF,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;IACnB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;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;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,EAAE,CAWtE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,EAAE,GACxD,cAAc,CAUhB;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

@@ -46,6 +46,37 @@ export function workflowSchedules(target) {
         key: s.key ?? (arr.length > 1 ? `${meta.name}:${i}` : meta.name),
     }));
 }
+/**
+ * Class-decorator form of the colocated schedule — the same declaration `static schedule = {...}`
+ * makes, for codebases that prefer decorators:
+ *
+ * ```ts
+ * @Scheduled({ cron: '0 4 * * *', timezone: 'America/Sao_Paulo' })
+ * export default class CrawlWorkflow extends BaseWorkflow {
+ *   static workflow = { name: 'crawl' }
+ *   async run(ctx: WorkflowCtx) { … }
+ * }
+ * ```
+ *
+ * It only stamps `static schedule` on the class — normalization (key defaults, `workflow` fill-in)
+ * stays in {@link workflowSchedules}, so both authoring forms behave identically, including the
+ * requirement of a `static workflow` config (a decorated class without one is not registrable and
+ * its schedules are ignored, same as a bare `static schedule`).
+ *
+ * Composes: repeated `@Scheduled(...)` applications and an existing `static schedule` accumulate.
+ * Decorators apply bottom-up, so each application PREPENDS — the final array reads in **source
+ * order** (top decorator first, then lower ones, then the `static schedule` literal). With several
+ * schedules on one class, prefer explicit `key`s over the positional `${name}:${i}` defaults: the
+ * key is part of the deterministic run id, and reordering declarations would silently re-key them.
+ */
+export function Scheduled(config) {
+    return (target) => {
+        const cls = target;
+        const existing = cls.schedule === undefined ? [] : Array.isArray(cls.schedule) ? cls.schedule : [cls.schedule];
+        const added = Array.isArray(config) ? config : [config];
+        cls.schedule = [...added, ...existing];
+    };
+}
 /**
  * Resolve a {@link WorkflowRef} to its registered workflow name: a string is returned as-is; a
  * workflow class is resolved via the name on its `static workflow` config. Throws if a class carries

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;AAkCH;;;;;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;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,GAAG,GAAI,MAA2E,CAAC,QAAQ,CAAC;IAClG,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACxB,GAAG,CAAC;QACJ,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KACjE,CAAC,CAAC,CAAC;AACN,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"}
+{"version":3,"file":"workflow-ref.js","sourceRoot":"","sources":["../../src/workflow-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkCH;;;;;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;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,GAAG,GAAI,MAA2E,CAAC,QAAQ,CAAC;IAClG,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACxB,GAAG,CAAC;QACJ,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KACjE,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,SAAS,CACvB,MAAyD;IAEzD,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,MAAM,GAAG,GAAG,MAEX,CAAC;QACF,MAAM,QAAQ,GACZ,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChG,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACxD,GAAG,CAAC,QAAQ,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC;AACJ,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

@@ -2,102 +2,46 @@
   exports({ to: app.migrationsPath(`${new Date().getTime()}_create_durable_tables.ts`) })
 }}}
 import { BaseSchema } from '@adonisjs/lucid/schema'
+import db from '@adonisjs/lucid/services/db'
+import { createDurableTables, dropDurableTables } from '@adonis-agora/durable'
 
 /**
- * Durable workflow tables for the @adonis-agora/durable `lucid` state store: runs, step checkpoints, the
- * 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.
+ * Durable workflow tables for the @adonis-agora/durable `lucid` state store: runs, step checkpoints,
+ * the search-attribute side-table, signal waiters, buffered signals and buffered events.
+ *
+ * This migration DELEGATES to the library instead of reproducing its DDL. The schema belongs to the
+ * library — `LucidStateStore` decides what columns it reads and writes — so a hand-copied snapshot
+ * here can only ever be right until the next release. It was wrong before: the stub shipped without
+ * `last_heartbeat_at` / `heartbeat_progress`, which the store writes on every step beat, and nothing
+ * failed only because the provider's boot-time `ensureSchema()` silently `ALTER`ed them in. Calling
+ * `createDurableTables` makes that drift impossible rather than merely tested for.
+ *
+ * `createDurableTables` is idempotent (`hasTable` / `hasColumn` guarded) and additive-only, so it is
+ * safe to run against a database that already has some or all of the tables.
+ *
+ * `db` (the `Database` manager from `@adonisjs/lucid/services/db`) rather than `this.db`:
+ * `createDurableTables` needs `db.connection(name).schema`, and the `this.db` a migration gets is a
+ * `QueryClientContract` — one already-resolved client, with no `.connection()`. `this.db` still
+ * supplies the connection NAME, so `node ace migration:run --connection=x` provisions the tables on
+ * connection `x` and not on the default.
  */
 export default class extends BaseSchema {
-  async up() {
-    this.schema.createTable('durable_workflow_runs', (table) => {
-      table.string('id').primary()
-      table.string('workflow').notNullable()
-      table.string('workflow_version').notNullable()
-      table.string('status').notNullable()
-      table.string('namespace').notNullable().defaultTo('default')
-      table.text('input')
-      table.text('output')
-      table.text('error')
-      table.bigInteger('wake_at')
-      table.string('locked_by')
-      table.bigInteger('locked_until')
-      table.integer('recovery_attempts')
-      table.text('tags')
-      table.text('search_attributes')
-      table.integer('priority')
-      table.bigInteger('created_at').notNullable()
-      table.bigInteger('updated_at').notNullable()
-      table.index(['status'], 'durable_runs_status_idx')
-      table.index(['status', 'wake_at'], 'durable_runs_due_idx')
-      table.index(['namespace', 'status', 'created_at'], 'durable_runs_namespace_idx')
-    })
-
-    this.schema.createTable('durable_step_checkpoints', (table) => {
-      table.string('run_id').notNullable()
-      table.integer('seq').notNullable()
-      table.string('name').notNullable()
-      table.string('kind').notNullable()
-      table.string('step_id').notNullable()
-      table.string('status').notNullable()
-      table.text('input')
-      table.text('output')
-      table.text('error')
-      table.text('events')
-      table.integer('attempts').notNullable()
-      table.string('worker_group')
-      table.bigInteger('wake_at')
-      table.string('parallel_group')
-      table.bigInteger('enqueued_at')
-      table.bigInteger('started_at').notNullable()
-      table.bigInteger('finished_at').notNullable()
-      table.primary(['run_id', 'seq'])
-      table.index(['run_id', 'name'], 'durable_checkpoints_name_idx')
-    })
-
-    this.schema.createTable('durable_run_attributes', (table) => {
-      table.string('run_id').notNullable()
-      table.string('key').notNullable()
-      table.string('str_value')
-      table.double('num_value')
-      table.primary(['run_id', 'key'])
-      table.index(['key', 'num_value'], 'durable_run_attributes_num_idx')
-      table.index(['key', 'str_value'], 'durable_run_attributes_str_idx')
-    })
+  /**
+   * REQUIRED, not a preference. The DDL below runs through the `Database` manager, which checks out
+   * its OWN connection from the pool — it is not part of the transaction the migrator would otherwise
+   * open for this migration. With `pool: { max: 1 }` (Adonis's own SQLite guidance) that transaction
+   * would hold the only connection while `createDurableTables` waited for a free one, and the
+   * migration would hang until the acquire timeout. Nothing is lost by opting out: the statements were
+   * never inside that transaction anyway, and re-running an interrupted `createDurableTables` is a
+   * no-op.
+   */
+  static disableTransactions = true
 
-    this.schema.createTable('durable_signal_waiters', (table) => {
-      table.string('token').primary()
-      table.string('run_id').notNullable()
-      table.integer('seq').notNullable()
-      table.string('parallel_group')
-    })
-
-    this.schema.createTable('durable_buffered_signals', (table) => {
-      table.increments('id').primary()
-      table.string('token').notNullable()
-      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 up() {
+    await createDurableTables(db, this.db.connectionName)
   }
 
   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')
-    this.schema.dropTableIfExists('durable_step_checkpoints')
-    this.schema.dropTableIfExists('durable_workflow_runs')
+    await dropDurableTables(db, this.db.connectionName)
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/durable",
-  "version": "0.19.2",
+  "version": "0.21.0",
   "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": {
@@ -158,6 +158,7 @@
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/context-async-hooks": "^1.30.0",
     "@opentelemetry/sdk-trace-base": "^1.30.0",
+    "@types/better-sqlite3": "^7.6.0",
     "@types/node": "^20.0.0",
     "better-sqlite3": "^11.0.0",
     "bullmq": "^5.0.0",
@@ -168,7 +169,7 @@
     "zod": "^3.25.0"
   },
   "engines": {
-    "node": ">=20.6.0"
+    "node": ">=20.6.0 <23"
   },
   "keywords": [
     "adonisjs",
@@ -184,10 +185,12 @@
     "agora"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json && pnpm run copy:stubs",
+    "build": "pnpm run clean && tsc -p tsconfig.build.json && pnpm run copy:stubs && pnpm run check:dist",
+    "check:dist": "node ../../scripts/assert-build-output.mjs dist src/index.js",
+    "clean": "rm -rf dist",
     "copy:stubs": "mkdir -p dist/stubs/config dist/stubs/database/migrations dist/stubs/make/workflow dist/assets && cp stubs/config/durable.stub dist/stubs/config/durable.stub && cp stubs/config/durable_dashboard.stub dist/stubs/config/durable_dashboard.stub && cp -r stubs/database/migrations/. dist/stubs/database/migrations/ && cp stubs/make/workflow/main.stub dist/stubs/make/workflow/main.stub && cp assets/dashboard.html dist/assets/dashboard.html",
     "test": "vitest run --passWithNoTests",
     "test:watch": "vitest",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.tests.json"
   }
 }