@adonis-agora/durable 0.31.1 → 0.31.2

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @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

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.1";
+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.1';
+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/index.d.ts

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.31.1";
+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.1';
+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.1",
+  "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": {