@adonis-agora/durable 0.31.0 → 0.31.2

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @adonis-agora/durable
 
+## 0.31.2
+
+### Patch Changes
+
+- [#100](https://github.com/DavideCarvalho/adonis-agora-durable/pull/100) [`b2297e2`](https://github.com/DavideCarvalho/adonis-agora-durable/commit/b2297e2d5f567ab5b0b3d707457c68d6c596a668) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - `node ace configure` now writes the `#workflows/*` and `#steps/*` subpath imports into the app's `package.json`.
+  
+  The barrels the assembler hooks generate import each module by alias (`#workflows/foo_workflow`), the way `@adonisjs/core`'s controllers barrel uses `#controllers/*`. The difference is that `#controllers/*` ships in the app skeleton and `#workflows/*` does not — so `configure` wired up barrels that named a specifier Node cannot resolve, and the app died at boot with `ERR_PACKAGE_IMPORT_NOT_DEFINED`, after a build that reported success.
+  
+  Existing apps: add these to `package.json` → `imports` (or re-run `configure`, which is now a no-op when they are already present and never overwrites an alias you point elsewhere):
+  
+  ```json
+  "#workflows/*": "./app/workflows/*.js",
+  "#steps/*": "./app/steps/*.js"
+  ```
+
+## 0.31.1
+
+### Patch Changes
+
+- [#98](https://github.com/DavideCarvalho/adonis-agora-durable/pull/98) [`4d61da2`](https://github.com/DavideCarvalho/adonis-agora-durable/commit/4d61da2cb0bf977706bdd62382cdd8f49bf7ee0f) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Fix the assembler codegen hooks, which broke the build of every app that ran `node ace configure @adonis-agora/durable`. The configure step writes both hooks into `adonisrc.ts` by itself, and the build then died with:
+  
+  ```
+  TypeError: handler.handle is not a function
+  ```
+  
+  `@poppinss/hooks` — the runner the assembler drives its `init` hooks with — invokes a handler as `typeof handler === 'function' ? handler(...data) : handler.handle(action, ...data)`, so a non-function handler must expose `handle`. Both hooks exported `{ run }`. The same shape also mismatched the assembler's own `DefineHook` type, so a consumer's typecheck failed too.
+  
+  `workflowsHook()` / `stepsHook()` and the default exports of `@adonis-agora/durable/hooks/workflows` and `/hooks/steps` are now plain functions. If you called `workflowsHook().run(...)` directly, call the returned value itself; the wiring in `adonisrc.ts` is unchanged, and it now works instead of throwing.
+
 ## 0.31.0
 
 ### Minor Changes

package/dist/configure.d.ts

@@ -10,8 +10,11 @@ import type Configure from '@adonisjs/core/commands/configure';
  *    and `app/steps` barrels at build/dev time (the provider imports them instead
  *    of scanning at runtime; each falls back to the runtime scan when its barrel
  *    is absent);
- * 5. publishes `config/durable.ts` + `config/durable_dashboard.ts`;
- * 6. publishes the Lucid migrations for the optional `lucid` store and `db`
+ * 5. adds the `#workflows/*` and `#steps/*` subpath imports to the app's `package.json`,
+ *    which the generated barrels import through (without them the app boots into
+ *    `ERR_PACKAGE_IMPORT_NOT_DEFINED`);
+ * 6. publishes `config/durable.ts` + `config/durable_dashboard.ts`;
+ * 7. publishes the Lucid migrations for the optional `lucid` store and `db`
  *    transport drivers (run `node ace migration:run`, and delete the transport
  *    migration if you don't use the `db` transport).
  */

package/dist/configure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAC;AAG/D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAqBjD"}
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAC;AAI/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAuBjD"}

package/dist/configure.js

@@ -1,3 +1,5 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { mergeSubpathImports } from './src/configure-imports.js';
 import { stubsRoot } from './stubs/main.js';
 /**
  * `node ace configure @adonis-agora/durable` — auto-wires the package:
@@ -10,8 +12,11 @@ import { stubsRoot } from './stubs/main.js';
  *    and `app/steps` barrels at build/dev time (the provider imports them instead
  *    of scanning at runtime; each falls back to the runtime scan when its barrel
  *    is absent);
- * 5. publishes `config/durable.ts` + `config/durable_dashboard.ts`;
- * 6. publishes the Lucid migrations for the optional `lucid` store and `db`
+ * 5. adds the `#workflows/*` and `#steps/*` subpath imports to the app's `package.json`,
+ *    which the generated barrels import through (without them the app boots into
+ *    `ERR_PACKAGE_IMPORT_NOT_DEFINED`);
+ * 6. publishes `config/durable.ts` + `config/durable_dashboard.ts`;
+ * 7. publishes the Lucid migrations for the optional `lucid` store and `db`
  *    transport drivers (run `node ace migration:run`, and delete the transport
  *    migration if you don't use the `db` transport).
  */
@@ -26,9 +31,35 @@ export async function configure(command) {
         rcFile.addAssemblerHook('init', '@adonis-agora/durable/hooks/workflows');
         rcFile.addAssemblerHook('init', '@adonis-agora/durable/hooks/steps');
     });
+    await addSubpathImports(command);
     await codemods.makeUsingStub(stubsRoot, 'config/durable.stub', {});
     await codemods.makeUsingStub(stubsRoot, 'config/durable_dashboard.stub', {});
     await codemods.makeUsingStub(stubsRoot, 'database/migrations/create_durable_tables.stub', {});
     await codemods.makeUsingStub(stubsRoot, 'database/migrations/create_durable_transport_tables.stub', {});
 }
+/**
+ * Add the subpath imports the generated barrels resolve through. There is no codemod for the
+ * `imports` map, so this edits `package.json` directly — and only when something is missing, so a
+ * second `configure` run neither rewrites the file nor logs a change it did not make.
+ */
+async function addSubpathImports(command) {
+    const path = command.app.makePath('package.json');
+    let raw;
+    try {
+        raw = await readFile(path, 'utf-8');
+    }
+    catch {
+        command.logger.warning('could not read package.json — add "#workflows/*": "./app/workflows/*.js" and "#steps/*": "./app/steps/*.js" to its "imports" by hand');
+        return;
+    }
+    const pkg = JSON.parse(raw);
+    const { imports, added } = mergeSubpathImports(pkg.imports);
+    if (added.length === 0)
+        return;
+    pkg.imports = imports;
+    // Two-space JSON with a trailing newline: what `create-adonisjs` writes, so the diff stays to
+    // the added lines instead of reformatting the whole file.
+    await writeFile(path, `${JSON.stringify(pkg, null, 2)}\n`);
+    command.logger.action(`update package.json (imports: ${added.join(', ')})`).succeeded();
+}
 //# sourceMappingURL=configure.js.map

package/dist/configure.js.map

@@ -1 +1 @@
-{"version":3,"file":"configure.js","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAkB;IAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAEhD,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,WAAW,CAAC,wCAAwC,CAAC,CAAC;QAC7D,MAAM,CAAC,WAAW,CAAC,0CAA0C,CAAC,CAAC;QAC/D,MAAM,CAAC,UAAU,CAAC,gCAAgC,CAAC,CAAC;QACpD,4FAA4F;QAC5F,sFAAsF;QACtF,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,uCAAuC,CAAC,CAAC;QACzE,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,+BAA+B,EAAE,EAAE,CAAC,CAAC;IAC7E,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,gDAAgD,EAAE,EAAE,CAAC,CAAC;IAC9F,MAAM,QAAQ,CAAC,aAAa,CAC1B,SAAS,EACT,0DAA0D,EAC1D,EAAE,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAkB;IAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAEhD,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,WAAW,CAAC,wCAAwC,CAAC,CAAC;QAC7D,MAAM,CAAC,WAAW,CAAC,0CAA0C,CAAC,CAAC;QAC/D,MAAM,CAAC,UAAU,CAAC,gCAAgC,CAAC,CAAC;QACpD,4FAA4F;QAC5F,sFAAsF;QACtF,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,uCAAuC,CAAC,CAAC;QACzE,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAEjC,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,+BAA+B,EAAE,EAAE,CAAC,CAAC;IAC7E,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,gDAAgD,EAAE,EAAE,CAAC,CAAC;IAC9F,MAAM,QAAQ,CAAC,aAAa,CAC1B,SAAS,EACT,0DAA0D,EAC1D,EAAE,CACH,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,iBAAiB,CAAC,OAAkB;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAElD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,OAAO,CACpB,sIAAsI,CACvI,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyC,CAAC;IACpE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE/B,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IACtB,8FAA8F;IAC9F,0DAA0D;IAC1D,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,iCAAiC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;AAC1F,CAAC"}

package/dist/src/configure-imports.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The Node subpath imports the generated barrels resolve through.
+ *
+ * The barrels the assembler hooks emit import each module by alias — `#workflows/foo_workflow` —
+ * exactly like `@adonisjs/core`'s controllers barrel uses `#controllers/*`. The difference is that
+ * `#controllers/*` ships in the app skeleton and `#workflows/*` does not, so without `configure`
+ * writing them the generated barrel names a specifier Node cannot resolve and the app dies at boot
+ * with `ERR_PACKAGE_IMPORT_NOT_DEFINED` — after a build that reported success.
+ *
+ * Keys and targets are kept in lockstep with the hooks' `importAlias` / `source` defaults; the spec
+ * asserts that pairing so changing one without the other fails loudly instead of at a consumer's
+ * boot.
+ */
+export declare const DURABLE_SUBPATH_IMPORTS: Readonly<Record<string, string>>;
+/**
+ * Merge {@link DURABLE_SUBPATH_IMPORTS} into an app's `package.json` `imports` map.
+ *
+ * Never overwrites an entry the app already defines — an app that points `#workflows/*` somewhere
+ * else made that choice deliberately, and `configure` is not the place to overrule it. Returns the
+ * merged map plus the keys actually added, so the caller can skip the write (and the log line) when
+ * there is nothing to do, making a re-run of `configure` a no-op.
+ */
+export declare function mergeSubpathImports(existing: Record<string, string> | undefined): {
+    imports: Record<string, string>;
+    added: string[];
+};
+//# sourceMappingURL=configure-imports.d.ts.map

package/dist/src/configure-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-imports.d.ts","sourceRoot":"","sources":["../../src/configure-imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGpE,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG;IACjF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAWA"}

package/dist/src/configure-imports.js

@@ -0,0 +1,37 @@
+/**
+ * The Node subpath imports the generated barrels resolve through.
+ *
+ * The barrels the assembler hooks emit import each module by alias — `#workflows/foo_workflow` —
+ * exactly like `@adonisjs/core`'s controllers barrel uses `#controllers/*`. The difference is that
+ * `#controllers/*` ships in the app skeleton and `#workflows/*` does not, so without `configure`
+ * writing them the generated barrel names a specifier Node cannot resolve and the app dies at boot
+ * with `ERR_PACKAGE_IMPORT_NOT_DEFINED` — after a build that reported success.
+ *
+ * Keys and targets are kept in lockstep with the hooks' `importAlias` / `source` defaults; the spec
+ * asserts that pairing so changing one without the other fails loudly instead of at a consumer's
+ * boot.
+ */
+export const DURABLE_SUBPATH_IMPORTS = {
+    '#workflows/*': './app/workflows/*.js',
+    '#steps/*': './app/steps/*.js',
+};
+/**
+ * Merge {@link DURABLE_SUBPATH_IMPORTS} into an app's `package.json` `imports` map.
+ *
+ * Never overwrites an entry the app already defines — an app that points `#workflows/*` somewhere
+ * else made that choice deliberately, and `configure` is not the place to overrule it. Returns the
+ * merged map plus the keys actually added, so the caller can skip the write (and the log line) when
+ * there is nothing to do, making a re-run of `configure` a no-op.
+ */
+export function mergeSubpathImports(existing) {
+    const imports = { ...(existing ?? {}) };
+    const added = [];
+    for (const [key, target] of Object.entries(DURABLE_SUBPATH_IMPORTS)) {
+        if (key in imports)
+            continue;
+        imports[key] = target;
+        added.push(key);
+    }
+    return { imports, added };
+}
+//# sourceMappingURL=configure-imports.js.map

package/dist/src/configure-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-imports.js","sourceRoot":"","sources":["../../src/configure-imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAqC;IACvE,cAAc,EAAE,sBAAsB;IACtC,UAAU,EAAE,kBAAkB;CAC/B,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAA4C;IAI9E,MAAM,OAAO,GAAG,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC;QACpE,IAAI,GAAG,IAAI,OAAO;YAAE,SAAS;QAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/dist/src/dashboard/index.d.ts

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.31.0";
+export declare const VERSION = "0.31.2";
 export type { AccessDeniedInfo, AccessDeniedPageOptions, AccessDeniedReason, } from './access_denied_page.js';
 export { CONSOLE as ACCESS_DENIED_CONSOLE, escapeHtml, renderAccessDeniedPage, resolveAccessDeniedPage, } from './access_denied_page.js';
 export type { AuthMode, DashboardAuthOptions, LoginHook, LoginOutcome, ResolvedDashboardAuth, SessionHook, SessionOutcome, } from './auth.js';

package/dist/src/dashboard/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.31.0';
+export const VERSION = '0.31.2';
 // The built-in "access denied" page (what a browser sees on a refused page navigation).
 export { CONSOLE as ACCESS_DENIED_CONSOLE, escapeHtml, renderAccessDeniedPage, resolveAccessDeniedPage, } from './access_denied_page.js';
 // Built-in `dashboardAuth` login screen (optional; opt-in via `config/durable_dashboard.ts`).

package/dist/src/hooks/steps.d.ts

@@ -31,13 +31,9 @@ export interface StepsHookOptions {
  * })
  * ```
  */
-export declare function stepsHook(options?: StepsHookOptions): {
-    run(_parent: unknown, _hooks: unknown, indexGenerator: IndexGenerator): void;
-};
-/** The default export is the hook object itself, so `() => import('@adonis-agora/durable/hooks/steps')`
- *  in `adonisrc.ts` resolves to a ready hook (the assembler calls its `run`). */
-declare const _default: {
-    run(_parent: unknown, _hooks: unknown, indexGenerator: IndexGenerator): void;
-};
+export declare function stepsHook(options?: StepsHookOptions): (_parent: unknown, _hooks: unknown, indexGenerator: IndexGenerator) => void;
+/** The default export is the hook function itself, so `() => import('@adonis-agora/durable/hooks/steps')`
+ *  in `adonisrc.ts` resolves to a handler the assembler can call directly. */
+declare const _default: (_parent: unknown, _hooks: unknown, indexGenerator: IndexGenerator) => void;
 export default _default;
 //# sourceMappingURL=steps.d.ts.map

package/dist/src/hooks/steps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../src/hooks/steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,+BAA+B,CAAC;AAEnE,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,qGAAqG;IACrG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB;IAMpD,GAAG,UAAU,OAAO,UAAU,OAAO,kBAAkB,cAAc,GAAG,IAAI;EAa/E;AAED;iFACiF;;iBAhBhE,OAAO,UAAU,OAAO,kBAAkB,cAAc,GAAG,IAAI"}
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../src/hooks/steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,+BAA+B,CAAC;AAEnE,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,qGAAqG;IACrG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,aAY3C,OAAO,UACR,OAAO,kBACC,cAAc,KAC7B,IAAI,CAYR;AAED;8EAC8E;kCAlBjE,OAAO,UACR,OAAO,kBACC,cAAc,KAC7B,IAAI"}

package/dist/src/hooks/steps.js

@@ -25,22 +25,26 @@ export function stepsHook(options = {}) {
     const source = options.source ?? 'app/steps';
     const importAlias = options.importAlias ?? '#steps';
     const output = options.output ?? GENERATED_STEPS_OUTPUT;
-    return {
-        run(_parent, _hooks, indexGenerator) {
-            indexGenerator.add('steps', {
-                source,
-                as: 'barrelFile',
-                exportName: 'steps',
-                importAlias,
-                removeSuffix: 'step',
-                skipSegments: ['steps'],
-                output,
-                comment: true,
-            });
-        },
+    // A FUNCTION, not an object with a `run` method. `@poppinss/hooks` — the runner the
+    // assembler drives its `init` hooks with — invokes a handler as
+    //   `typeof handler === 'function' ? handler(...data) : handler.handle(action, ...data)`
+    // so a non-function handler must expose `handle`. Exporting `{ run }` made every app that
+    // ran `node ace configure` fail its build with `handler.handle is not a function`, and it
+    // also mismatched the assembler's own `DefineHook` type, which is a plain function.
+    return function generateStepsBarrel(_parent, _hooks, indexGenerator) {
+        indexGenerator.add('steps', {
+            source,
+            as: 'barrelFile',
+            exportName: 'steps',
+            importAlias,
+            removeSuffix: 'step',
+            skipSegments: ['steps'],
+            output,
+            comment: true,
+        });
     };
 }
-/** The default export is the hook object itself, so `() => import('@adonis-agora/durable/hooks/steps')`
- *  in `adonisrc.ts` resolves to a ready hook (the assembler calls its `run`). */
+/** The default export is the hook function itself, so `() => import('@adonis-agora/durable/hooks/steps')`
+ *  in `adonisrc.ts` resolves to a handler the assembler can call directly. */
 export default stepsHook();
 //# sourceMappingURL=steps.js.map

package/dist/src/hooks/steps.js.map

@@ -1 +1 @@
-{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../../src/hooks/steps.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAYnE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,SAAS,CAAC,OAAO,GAAqB,EAAE;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,QAAQ,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,sBAAsB,CAAC;IAExD,OAAO;QACL,GAAG,CAAC,OAAgB,EAAE,MAAe,EAAE,cAA8B;YACnE,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE;gBAC1B,MAAM;gBACN,EAAE,EAAE,YAAY;gBAChB,UAAU,EAAE,OAAO;gBACnB,WAAW;gBACX,YAAY,EAAE,MAAM;gBACpB,YAAY,EAAE,CAAC,OAAO,CAAC;gBACvB,MAAM;gBACN,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED;iFACiF;AACjF,eAAe,SAAS,EAAE,CAAC"}
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../../src/hooks/steps.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAYnE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,SAAS,CAAC,OAAO,GAAqB,EAAE;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,QAAQ,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,sBAAsB,CAAC;IAExD,oFAAoF;IACpF,gEAAgE;IAChE,yFAAyF;IACzF,0FAA0F;IAC1F,0FAA0F;IAC1F,oFAAoF;IACpF,OAAO,SAAS,mBAAmB,CACjC,OAAgB,EAChB,MAAe,EACf,cAA8B;QAE9B,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE;YAC1B,MAAM;YACN,EAAE,EAAE,YAAY;YAChB,UAAU,EAAE,OAAO;YACnB,WAAW;YACX,YAAY,EAAE,MAAM;YACpB,YAAY,EAAE,CAAC,OAAO,CAAC;YACvB,MAAM;YACN,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED;8EAC8E;AAC9E,eAAe,SAAS,EAAE,CAAC"}

package/dist/src/hooks/workflows.d.ts

@@ -42,13 +42,9 @@ export interface WorkflowsHookOptions {
  *
  * The default export is the hook object the assembler expects (`{ run(parent, hooks, indexGenerator) }`).
  */
-export declare function workflowsHook(options?: WorkflowsHookOptions): {
-    run(_parent: unknown, _hooks: unknown, indexGenerator: IndexGenerator): void;
-};
-/** The default export is the hook object itself, so `() => import('@adonis-agora/durable/hooks/workflows')`
- *  in `adonisrc.ts` resolves to a ready hook (the assembler calls its `run`). */
-declare const _default: {
-    run(_parent: unknown, _hooks: unknown, indexGenerator: IndexGenerator): void;
-};
+export declare function workflowsHook(options?: WorkflowsHookOptions): (_parent: unknown, _hooks: unknown, indexGenerator: IndexGenerator) => void;
+/** The default export is the hook function itself, so `() => import('@adonis-agora/durable/hooks/workflows')`
+ *  in `adonisrc.ts` resolves to a handler the assembler can call directly. */
+declare const _default: (_parent: unknown, _hooks: unknown, indexGenerator: IndexGenerator) => void;
 export default _default;
 //# sourceMappingURL=workflows.d.ts.map

package/dist/src/hooks/workflows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../../src/hooks/workflows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,mCAAmC,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gHAAgH;IAChH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB;IAM5D,GAAG,UAAU,OAAO,UAAU,OAAO,kBAAkB,cAAc,GAAG,IAAI;EAe/E;AAED;iFACiF;;iBAlBhE,OAAO,UAAU,OAAO,kBAAkB,cAAc,GAAG,IAAI"}
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../../src/hooks/workflows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,mCAAmC,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gHAAgH;IAChH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,aAYnD,OAAO,UACR,OAAO,kBACC,cAAc,KAC7B,IAAI,CAcR;AAED;8EAC8E;kCApBjE,OAAO,UACR,OAAO,kBACC,cAAc,KAC7B,IAAI"}

package/dist/src/hooks/workflows.js

@@ -33,24 +33,28 @@ export function workflowsHook(options = {}) {
     const source = options.source ?? 'app/workflows';
     const importAlias = options.importAlias ?? '#workflows';
     const output = options.output ?? GENERATED_WORKFLOWS_OUTPUT;
-    return {
-        run(_parent, _hooks, indexGenerator) {
-            indexGenerator.add('workflows', {
-                source,
-                as: 'barrelFile',
-                exportName: 'workflows',
-                importAlias,
-                // `app/workflows/billing/charge_workflow.ts` → key `Billing/Charge`; the `Workflow` suffix is
-                // dropped so a barrel key reads as the class, mirroring controllers' `removeSuffix: 'controller'`.
-                removeSuffix: 'workflow',
-                skipSegments: ['workflows'],
-                output,
-                comment: true,
-            });
-        },
+    // A FUNCTION, not an object with a `run` method. `@poppinss/hooks` — the runner the
+    // assembler drives its `init` hooks with — invokes a handler as
+    //   `typeof handler === 'function' ? handler(...data) : handler.handle(action, ...data)`
+    // so a non-function handler must expose `handle`. Exporting `{ run }` made every app that
+    // ran `node ace configure` fail its build with `handler.handle is not a function`, and it
+    // also mismatched the assembler's own `DefineHook` type, which is a plain function.
+    return function generateWorkflowsBarrel(_parent, _hooks, indexGenerator) {
+        indexGenerator.add('workflows', {
+            source,
+            as: 'barrelFile',
+            exportName: 'workflows',
+            importAlias,
+            // `app/workflows/billing/charge_workflow.ts` → key `Billing/Charge`; the `Workflow` suffix is
+            // dropped so a barrel key reads as the class, mirroring controllers' `removeSuffix: 'controller'`.
+            removeSuffix: 'workflow',
+            skipSegments: ['workflows'],
+            output,
+            comment: true,
+        });
     };
 }
-/** The default export is the hook object itself, so `() => import('@adonis-agora/durable/hooks/workflows')`
- *  in `adonisrc.ts` resolves to a ready hook (the assembler calls its `run`). */
+/** The default export is the hook function itself, so `() => import('@adonis-agora/durable/hooks/workflows')`
+ *  in `adonisrc.ts` resolves to a handler the assembler can call directly. */
 export default workflowsHook();
 //# sourceMappingURL=workflows.js.map

package/dist/src/hooks/workflows.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../../src/hooks/workflows.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;AAe3E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,aAAa,CAAC,OAAO,GAAyB,EAAE;IAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC;IACjD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,0BAA0B,CAAC;IAE5D,OAAO;QACL,GAAG,CAAC,OAAgB,EAAE,MAAe,EAAE,cAA8B;YACnE,cAAc,CAAC,GAAG,CAAC,WAAW,EAAE;gBAC9B,MAAM;gBACN,EAAE,EAAE,YAAY;gBAChB,UAAU,EAAE,WAAW;gBACvB,WAAW;gBACX,8FAA8F;gBAC9F,mGAAmG;gBACnG,YAAY,EAAE,UAAU;gBACxB,YAAY,EAAE,CAAC,WAAW,CAAC;gBAC3B,MAAM;gBACN,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED;iFACiF;AACjF,eAAe,aAAa,EAAE,CAAC"}
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../../src/hooks/workflows.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;AAe3E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,aAAa,CAAC,OAAO,GAAyB,EAAE;IAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC;IACjD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,0BAA0B,CAAC;IAE5D,oFAAoF;IACpF,gEAAgE;IAChE,yFAAyF;IACzF,0FAA0F;IAC1F,0FAA0F;IAC1F,oFAAoF;IACpF,OAAO,SAAS,uBAAuB,CACrC,OAAgB,EAChB,MAAe,EACf,cAA8B;QAE9B,cAAc,CAAC,GAAG,CAAC,WAAW,EAAE;YAC9B,MAAM;YACN,EAAE,EAAE,YAAY;YAChB,UAAU,EAAE,WAAW;YACvB,WAAW;YACX,8FAA8F;YAC9F,mGAAmG;YACnG,YAAY,EAAE,UAAU;YACxB,YAAY,EAAE,CAAC,WAAW,CAAC;YAC3B,MAAM;YACN,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED;8EAC8E;AAC9E,eAAe,aAAa,EAAE,CAAC"}

package/dist/src/index.d.ts

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.31.0";
+export declare const VERSION = "0.31.2";
 export { configure } from '../configure.js';
 export * from './admission.js';
 export type { AdmissionContext, AdmissionFactory, RedisAdmissionConfig, } from './admissions/factory.js';

package/dist/src/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.31.0';
+export const VERSION = '0.31.2';
 // Re-export the configure hook from the package root so `node ace configure` finds it.
 // AdonisJS imports the package MAIN and reads `configure` off the module namespace —
 // the `./configure` subpath alone is never consulted.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/durable",
-  "version": "0.31.0",
+  "version": "0.31.2",
   "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": {
@@ -160,6 +160,7 @@
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/context-async-hooks": "2.10.0",
     "@opentelemetry/sdk-trace-base": "2.10.0",
+    "@poppinss/hooks": "7.3.1",
     "@tanstack/intent": "^0.3.7",
     "@types/better-sqlite3": "9.6.0",
     "@types/node": "26.4.0",