@antelopejs/dms-frontend 0.9.3 → 0.10.1

package/README.md

@@ -1,36 +1,30 @@
-<div align="center">
+<a href="https://github.com/AntelopeJS/dms"><img data-illustration src="./.github/readme/strip.svg" width="100%" alt="DMS FRONTEND: part of AntelopeJS DMS, the open-source back office. A glowing button reads Star AntelopeJS DMS."></a>
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/AntelopeJS/dms/main/packages/dms/frontend-vue/layers/dms-layout/public/images/antelope-logo/dark.svg">
-  <img alt="Antelope DMS" src="https://raw.githubusercontent.com/AntelopeJS/dms/main/packages/dms/frontend-vue/layers/dms-layout/public/images/antelope-logo/light.svg" height="72">
-</picture>
+<div align="center">
 
-# @antelopejs/dms-frontend
+# `@antelopejs/dms-frontend`
 
-<a href="https://www.npmjs.com/package/@antelopejs/dms-frontend"><img alt="npm" src="https://img.shields.io/npm/v/@antelopejs/dms-frontend?style=for-the-badge&labelColor=000000&color=000000"></a>
-<a href="./LICENSE"><img alt="License" src="https://img.shields.io/npm/l/@antelopejs/dms-frontend?style=for-the-badge&labelColor=000000&color=000000"></a>
-<a href="https://discord.gg/g4pFt6eXqu"><img alt="Discord" src="https://img.shields.io/badge/Discord-18181B?logo=discord&style=for-the-badge&color=000000"></a>
-<a href="https://dms.antelopejs.com/docs/frontend"><img alt="Documentation" src="https://img.shields.io/badge/Docs-18181B?style=for-the-badge&color=000000"></a>
+<a href="https://www.npmjs.com/package/@antelopejs/dms-frontend"><img alt="npm" src="https://img.shields.io/npm/v/@antelopejs/dms-frontend?style=for-the-badge&labelColor=000000&color=000000" data-illustration></a> <a href="./LICENSE"><img alt="License" src="https://img.shields.io/npm/l/@antelopejs/dms-frontend?style=for-the-badge&labelColor=000000&color=000000" data-illustration></a> <a href="https://discord.gg/g4pFt6eXqu"><img alt="Discord" src="https://img.shields.io/badge/Discord-18181B?logo=discord&style=for-the-badge&color=000000" data-illustration></a> <a href="https://dms.antelopejs.com/docs/frontend"><img alt="Documentation" src="https://img.shields.io/badge/Docs-18181B?style=for-the-badge&color=000000" data-illustration></a> <a href="https://github.com/AntelopeJS/dms"><img data-illustration alt="Star AntelopeJS DMS" src="https://img.shields.io/github/stars/AntelopeJS/dms?label=Star%20AntelopeJS%20DMS&style=for-the-badge&labelColor=000000&color=000000&logo=github"></a>
 
 **The frontend of the AntelopeJS DMS: the `ajs dms` CLI, the Vue renderer and the frontend-module SDK.**
 
-[Documentation](https://dms.antelopejs.com/docs/frontend) · [DMS](https://github.com/AntelopeJS/dms) · [Modules](https://dms.antelopejs.com/docs/modules)
+[Documentation](https://dms.antelopejs.com/docs/frontend) · [All modules](https://github.com/AntelopeJS/dms#modules)
 
 </div>
 
-![The browser talks to the frontend server, which renders pages, answers module routes and proxies declared backend prefixes to the DMS backend; at build time ajs dms fetches the manifest and writes a workspace](./docs/images/architecture.svg)
+![The browser talks to the frontend server, which renders pages, answers module routes and proxies declared backend prefixes to the DMS backend, while the development and prepare commands fetch the manifest and write a workspace](./docs/images/architecture.svg "illustration")
 
 ## What it does
 
-- Asks a DMS backend which frontend modules it loads, materializes them into a generated workspace, builds it, and runs the frontend server.
-- Renders the dashboard with Vue 3, Vite, Inertia and server-side rendering.
-- Keeps the backend token on the server: the browser only holds a sealed, `HttpOnly` session cookie, and declared backend prefixes are proxied with the session's token.
+- Reads the frontend modules of an AntelopeJS project, materializes them into a generated workspace, builds it, and runs the frontend server.
+- Renders the dashboard with Vue, Vite, Inertia and server-side rendering.
+- Keeps the backend token on the server. The browser only holds a sealed, `HttpOnly` session cookie, and the server adds the session's token to each request it proxies to a declared backend prefix.
 - Lets a module extend the dashboard with pages, components and plugins (`dms.frontend.ts`), server routes (`dms.server.ts`) and build-time declarations (`dms.frontend.build.ts`).
 - Serves development with hot reload, and production with pre-compressed assets.
 
 ## Install
 
-Add the package next to `@antelopejs/core`; the core `ajs` command runs it as `ajs dms`:
+Add the package next to `@antelopejs/core`. The core `ajs` command runs it as `ajs dms`.
 
 ```bash
 pnpm add -D @antelopejs/core @antelopejs/dms-frontend
@@ -38,20 +32,20 @@ pnpm add -D @antelopejs/core @antelopejs/dms-frontend
 
 ## Quick start
 
-In a DMS project started with `ajs project run -w`, serve the dashboard with hot reload:
+In a DMS project started with `ajs project dev -w`, serve the dashboard with hot reload:
 
 ```bash
 pnpm exec ajs dms dev
 ```
 
-For production, build from the project root, without the backend, then start the frontend server with `DMS_SESSION_SECRET` and the backend's secrets set:
+For production, build from the project root, without the backend. Then start the frontend server with `DMS_SESSION_SECRET` and the backend's secrets set:
 
 ```bash
 pnpm exec ajs dms build
 pnpm exec ajs dms start -b https://api.example.com -p 3001
 ```
 
-`ajs dms --help` lists every command, and `ajs dms help environment` every environment variable.
+`ajs dms --help` lists every command, and `ajs dms help environment` lists every environment variable.
 
 ## Compatibility
 
@@ -59,17 +53,11 @@ pnpm exec ajs dms start -b https://api.example.com -p 3001
 
 | Package            | Supported     | Tested with |
 | ------------------ | ------------- | ----------- |
-| `@antelopejs/core` | `>=1.16.0 <2` | `1.16.0`    |
+| `@antelopejs/core` | `>=1.16.0 <2` | `1.21.0`    |
 
 <!-- antelopejs-docs-compat:end -->
 
-| `@antelopejs/dms` | `@antelopejs/dms-frontend` |
-| --- | --- |
-| 0.9.1 and later | `>=0.6.1 <0.7.0` |
-| 0.9.0 | `>=0.6.0 <0.7.0` |
-| 0.6.0 – 0.8.3 | 0.5 (exact floor per release in the full table) |
-
-The 0.6 line needs Node.js 20.19 or later and `@antelopejs/core` `>=1.13.2 <2`. The [compatibility table](https://dms.antelopejs.com/docs/frontend/introduction#compatibility) lists every release.
+Each DMS release declares the renderer releases it runs on in `engines["@antelopejs/dms-frontend"]` of its frontend module's `package.json`. The `ajs dms` CLI refuses to build a module whose range excludes the installed renderer. To find the renderer releases that match a DMS release, read that `engines` range in the installed DMS frontend module, as the [Compatibility](https://dms.antelopejs.com/docs/frontend/introduction#compatibility) section of the introduction explains. The renderer needs the `@antelopejs/core` range in the table above, and the `engines` field of its `package.json` sets the Node.js versions it runs on.
 
 ## Documentation
 
@@ -90,13 +78,42 @@ Read [CONTRIBUTING.md](./CONTRIBUTING.md) before opening a pull request.
 ```bash
 pnpm install
 pnpm build
-pnpm lint          # oxlint, oxfmt, interface ranges and the docs reference check
+pnpm lint          # oxlint, interface ranges, the docs reference check and the source checks
 pnpm typecheck
 pnpm test
 ```
 
-`pnpm docs:reference` regenerates the environment-variable table of `docs/4.configuration.md` from the list `ajs dms help environment` prints; `pnpm lint` fails when the table is stale.
+`pnpm docs:reference` regenerates the environment-variable table of `docs/4.configuration.md` from the list `ajs dms help environment` prints. `pnpm lint` fails when the table is stale.
+
+## Part of AntelopeJS DMS
+
+This package is the frontend of [AntelopeJS DMS](https://github.com/AntelopeJS/dms), the open-source back office. It renders the dashboard that every module adds its pages to, behind the same sign-in and roles.
+
+<!-- antelopejs-dms-modules:start -->
+
+| Module                                                           | What it adds                                                                             |
+| ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| [`dms-builder`](https://github.com/AntelopeJS/dms-builder)       | Edit pages, tables and data sources by clicking, as TypeScript that compiles             |
+| [`dms-ai`](https://github.com/AntelopeJS/dms-ai)                 | An assistant chat in the dashboard, on your own Claude Code or Codex                     |
+| [`dms-database`](https://github.com/AntelopeJS/dms-database)     | Schemas, relation diagrams, a data browser and a query console                           |
+| [`dms-api`](https://github.com/AntelopeJS/dms-api)               | API health, request logs, per-route statistics and a request tester                      |
+| [`dms-automation`](https://github.com/AntelopeJS/dms-automation) | Node-graph automations on schedules, webhooks and DMS events, with a trace for every run |
+| [`dms-mailing`](https://github.com/AntelopeJS/dms-mailing)       | E-mail templates in a block editor, versions, a send log and delivery metrics            |
+| [`dms-lang`](https://github.com/AntelopeJS/dms-lang)             | Translation coverage, a translation matrix and a translation queue                       |
+| [`dms-media`](https://github.com/AntelopeJS/dms-media)           | A media library with folders, per-folder permissions, image sizes and light editing      |
+| [`dms-saas`](https://github.com/AntelopeJS/dms-saas)             | Self-service sign-up, plans that gate features, and Stripe billing                       |
+| [`dms-marketing`](https://github.com/AntelopeJS/dms-marketing)   | Traffic, conversion funnels with A/B splits and click heatmaps, without cookies          |
+| [`dms-frontend`](https://github.com/AntelopeJS/dms-frontend)     | The `ajs dms` CLI, the Vue renderer and the SDK every frontend module builds on          |
+
+<!-- antelopejs-dms-modules:end -->
 
 ## License
 
 [Apache-2.0](./LICENSE)
+
+## Requirements
+
+<!-- antelopejs-docs-node:start -->
+
+This package requires Node.js `>=20.19.0`.
+<!-- antelopejs-docs-node:end -->

package/dist/commands/build-action.d.ts

@@ -5,6 +5,9 @@ export interface BuildOptions {
     env: string;
     workspace?: string;
     force?: boolean;
+    setupOnly?: boolean;
+    install?: boolean;
+    prepared?: boolean;
 }
 export declare const DEFAULT_WORKSPACE_DIR = ".dms-frontend";
 export declare function productionWorkspace(options: {

package/dist/commands/build-action.js

@@ -6,12 +6,77 @@ exports.buildStepFailure = buildStepFailure;
 exports.runBuild = runBuild;
 const node_path_1 = require("node:path");
 const cli_1 = require("@antelopejs/core/cli");
+const config_1 = require("../config");
+const prepared_workspace_1 = require("../internal/prepared-workspace");
 const child_output_1 = require("../child-output");
 const common_1 = require("../common");
 const output_1 = require("../output");
 const vite_output_1 = require("../vite-output");
 const entry_weight_1 = require("../entry-weight");
 const workspace_task_1 = require("./workspace-task");
+const node_options_1 = require("../node-options");
+const NOT_PREPARED_EXIT_CODE = 3;
+function buildPlan(options) {
+    const install = options.install !== false;
+    if (options.setupOnly)
+        return { kind: "setup", install };
+    if (!install)
+        throw new config_1.UsageError({
+            title: "--no-install needs --setup-only",
+            fixes: ["Run ajs dms build --setup-only --no-install"],
+        });
+    return options.prepared ? { kind: "prepared" } : { kind: "full" };
+}
+function workspaceFlag(options) {
+    return options.workspace ? ` --workspace ${options.workspace}` : "";
+}
+async function setUpProductionWorkspace(options, workspace, install) {
+    (0, prepared_workspace_1.forgetPreparedLayers)(workspace);
+    const { workspaceDir, layers } = await (0, workspace_task_1.setUpWorkspace)({
+        force: !!options.force,
+        mode: "build",
+        workspaceDir: workspace,
+        project: { projectDir: options.project, environment: options.env },
+        install,
+    });
+    (0, prepared_workspace_1.recordPreparedLayers)(workspaceDir, layers);
+    return { workspaceDir, layers };
+}
+function setupSummary(options, install, workspaceDir, startedAt) {
+    const flag = workspaceFlag(options);
+    return {
+        headline: install
+            ? "Set up the production workspace"
+            : "Wrote the production workspace without installing it",
+        artifact: (0, output_1.showWorkspace)(workspaceDir),
+        durationMs: Date.now() - startedAt,
+        nextSteps: [
+            install
+                ? {
+                    command: `ajs dms build --prepared${flag}`,
+                    description: "builds this workspace as it is",
+                }
+                : {
+                    command: `ajs dms build --setup-only${flag}`,
+                    description: "installs its dependencies",
+                },
+        ],
+    };
+}
+function preparedProductionWorkspace(options, workspace) {
+    const workspaceDir = (0, node_path_1.resolve)(workspace);
+    const found = (0, prepared_workspace_1.readPreparedWorkspace)(workspaceDir);
+    if (found.prepared)
+        return { workspaceDir, layers: found.layers };
+    throw new cli_1.CliError({
+        title: `${(0, output_1.showWorkspace)(workspaceDir)} is not prepared`,
+        reason: found.reason,
+        fixes: [
+            `Run ajs dms build --setup-only${workspaceFlag(options)} first, or build without --prepared`,
+        ],
+        exitCode: NOT_PREPARED_EXIT_CODE,
+    });
+}
 exports.DEFAULT_WORKSPACE_DIR = ".dms-frontend";
 function productionWorkspace(options) {
     return options.workspace ?? (0, node_path_1.join)(options.project, exports.DEFAULT_WORKSPACE_DIR);
@@ -87,7 +152,7 @@ async function runBuildStep(step, context) {
         });
     }
     catch (error) {
-        (0, output_1.endInterruptedTask)(task, error, step.stopped);
+        (0, output_1.endInterruptedTask)(task, error instanceof common_1.CancelledError ? error : undefined, step.stopped);
         throw error;
     }
     if (result.code !== 0) {
@@ -108,16 +173,20 @@ async function runBuild(options) {
     }
 }
 async function buildProduction(options, startedAt) {
+    const plan = buildPlan(options);
     (0, entry_weight_1.entryWeightThreshold)(process.env);
     const ui = (0, cli_1.getProcessUi)();
     const workspace = productionWorkspace(options);
     (0, output_1.writeHeader)("build", [options.project, options.env]);
-    const { workspaceDir, layers } = await (0, workspace_task_1.setUpWorkspace)({
-        force: !!options.force,
-        mode: "build",
-        workspaceDir: workspace,
-        project: { projectDir: options.project, environment: options.env },
-    });
+    if (plan.kind === "setup") {
+        const { workspaceDir } = await setUpProductionWorkspace(options, workspace, plan.install);
+        (0, output_1.writeBlankLine)();
+        ui.summary(setupSummary(options, plan.install, workspaceDir, startedAt));
+        return;
+    }
+    const { workspaceDir, layers } = plan.kind === "prepared"
+        ? preparedProductionWorkspace(options, workspace)
+        : await setUpProductionWorkspace(options, workspace, true);
     ui.message("info", "Building for production", {
         detail: `Workspace  ${(0, output_1.showWorkspace)(workspaceDir)}`,
     });
@@ -130,7 +199,7 @@ async function buildProduction(options, startedAt) {
         nameFile: (0, child_output_1.createFileNamer)(layers),
         env: {
             ...process.env,
-            NODE_OPTIONS: "--max-old-space-size=4096",
+            NODE_OPTIONS: (0, node_options_1.serverNodeOptions)(process.env.NODE_OPTIONS),
             NODE_PATH: (0, node_path_1.join)(workspaceDir, "node_modules"),
             [vite_output_1.VITE_LOG_LEVEL_VARIABLE]: (0, vite_output_1.viteLogLevel)(isVerbose),
         },

package/dist/commands/build.js

@@ -46,6 +46,10 @@ const BUILD_EXAMPLES = [
         description: "With another environment's configuration, into a directory",
         command: "ajs dms build -e staging --workspace /srv/dms-frontend",
     },
+    {
+        description: "Set the workspace up and install it, then build it later as it is",
+        command: "ajs dms build --setup-only && ajs dms build --prepared",
+    },
 ];
 function cmdBuild() {
     const command = new commander_1.Command("build")
@@ -55,6 +59,9 @@ function cmdBuild() {
         .addOption(config_1.Options.env)
         .addOption(config_1.Options.workspace("Build into this directory instead of <project>/.dms-frontend"))
         .addOption(config_1.Options.force("Reinstall the workspace dependencies"))
+        .addOption(new commander_1.Option("--setup-only", "Set the workspace up and install its dependencies, then stop before the bundles"))
+        .addOption(new commander_1.Option("--no-install", "With --setup-only, write the workspace without installing its dependencies"))
+        .addOption(new commander_1.Option("--prepared", "Build the workspace --setup-only set up, as it is, without setting it up again; exit 3 when it is not prepared").conflicts(["setupOnly", "force"]))
         .action(async (options) => (await Promise.resolve().then(() => __importStar(require("./build-action")))).runBuild(options));
     return (0, cli_1.withExamples)(command, BUILD_EXAMPLES);
 }

package/dist/commands/clean-action.js

@@ -79,7 +79,7 @@ async function runClean(options) {
             title: "Nothing to clean: pass -b <url> or --all",
             reason: "clean never uses DMS_API_BASE_URL from the environment or ./.env.",
             fixes: [
-                "Remove the workspace build, start and dev -b share for a URL: ajs dms clean -b <url>",
+                "Remove the workspace dev -b and prepare use for a URL: ajs dms clean -b <url>",
                 "Remove every workspace, including those dev created without -b: ajs dms clean --all",
                 "List the workspaces: ajs dms workspaces",
             ],

package/dist/commands/clean.js

@@ -38,7 +38,7 @@ const commander_1 = require("commander");
 const cli_1 = require("@antelopejs/core/cli");
 const CLEAN_EXAMPLES = [
     {
-        description: "The workspace build, start and dev -b share for a backend",
+        description: "The workspace dev -b and prepare use for a backend",
         command: "ajs dms clean -b https://dms.example.com",
     },
     {

package/dist/commands/dev-action.js

@@ -14,6 +14,7 @@ const manifest_1 = require("../manifest");
 const module_set_1 = require("../module-set");
 const project_modules_1 = require("../project-modules");
 const workspace_task_1 = require("./workspace-task");
+const node_options_1 = require("../node-options");
 const BASE_ENVIRONMENT = "default";
 function clientHost() {
     const host = process.env.HOST?.trim();
@@ -65,7 +66,7 @@ async function runDev(options) {
         bootstrapSecret,
         project,
     });
-    if (port !== requestedPort) {
+    if (reserved.isFallback) {
         ui.message("warn", `Port ${requestedPort} is busy, using ${port}`);
     }
     if (manifestFromCache) {
@@ -119,7 +120,7 @@ function backendModuleSet(setup) {
 function reportServed(session, setup) {
     return (0, module_set_1.reportFrontendReady)(session.backendUrl, setup.layers.map((layer) => ({
         name: layer.name ?? layer.path,
-        version: (0, project_modules_1.readShippingVersion)(layer.path),
+        version: (0, project_modules_1.readShippingPackage)(layer.path).version,
     })), session.bootstrapSecret);
 }
 async function serveWorkspace(session, setup) {
@@ -175,7 +176,7 @@ function runDevServer(session, setup, stopSignal) {
             DMS_BOOTSTRAP_SECRET: session.bootstrapSecret,
             DMS_SESSION_SECRET: session.sessionSecret,
             ...secrets.env,
-            NODE_OPTIONS: "--max-old-space-size=4096",
+            NODE_OPTIONS: (0, node_options_1.serverNodeOptions)(process.env.NODE_OPTIONS),
             NODE_PATH: nodeModulesDir,
         },
         onReady: (address) => {

package/dist/commands/dev.js

@@ -43,7 +43,7 @@ const DEV_EXAMPLES = [
         command: "ajs dms dev",
     },
     {
-        description: "Share one workspace with build and start",
+        description: "Run in the workspace prepare uses for that backend",
         command: "ajs dms dev -b http://localhost:5010 -p 3001",
     },
 ];

package/dist/commands/prepare-action.js

@@ -44,7 +44,7 @@ async function runPrepare(options) {
     catch (err) {
         if (err instanceof common_1.CancelledError || strict)
             throw err;
-        const [title, ...details] = (0, output_1.failureDetails)(err, ui);
+        const [title, ...details] = (0, output_1.failureDetails)((0, output_1.classifyFailure)(err), ui);
         const outcome = isSkip(err) ? "Skipped prepare" : "Prepare failed";
         ui.message("warn", `${outcome}: ${title}`, {
             details: [...details, NOT_GENERATED, STRICT_HINT],

package/dist/commands/start-action.js

@@ -11,22 +11,13 @@ const server_process_1 = require("../server-process");
 const update_check_1 = require("../update-check");
 const module_set_1 = require("../module-set");
 const project_modules_1 = require("../project-modules");
-const config_1 = require("../config");
+const built_workspace_1 = require("../internal/built-workspace");
 const manifest_secrets_1 = require("../manifest-secrets");
 const private_values_1 = require("../private-values");
 const build_action_1 = require("./build-action");
 const PUBLIC_OPTIONS_VARIABLE = "DMS_PUBLIC_OPTIONS";
-function builtPrivateOptions(workspaceDir) {
-    try {
-        const { modules } = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(workspaceDir, config_1.SERVER_OPTIONS_FILE), "utf8"));
-        return modules ?? {};
-    }
-    catch {
-        return {};
-    }
-}
 function reportUnfilledPrivateValues(workspaceDir) {
-    const unfilled = (0, private_values_1.unfilledPrivateValues)(builtPrivateOptions(workspaceDir), (0, private_values_1.parsePrivateOptions)(process.env[private_values_1.PRIVATE_OPTIONS_VARIABLE]), Object.values(manifest_secrets_1.MANIFEST_SECRET_ENV));
+    const unfilled = (0, private_values_1.unfilledPrivateValues)((0, built_workspace_1.readBuiltPrivateOptions)(workspaceDir), (0, private_values_1.parsePrivateOptions)(process.env[private_values_1.PRIVATE_OPTIONS_VARIABLE]), Object.values(manifest_secrets_1.MANIFEST_SECRET_ENV));
     const ui = (0, cli_1.getProcessUi)();
     unfilled.forEach(({ module, path }, index) => {
         const isLast = index === unfilled.length - 1;
@@ -61,18 +52,6 @@ function publicOptionsById(modules) {
         ];
     }));
 }
-function builtModules(workspaceDir) {
-    try {
-        const { modules } = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(workspaceDir, "generated-frontend-modules.json"), "utf8"));
-        return (modules ?? []).map((module) => ({
-            name: module.name ?? module.id,
-            version: module.version,
-        }));
-    }
-    catch {
-        return [];
-    }
-}
 function reportModuleSetDrift(built, modules) {
     const builtNames = new Set(built.map(({ name }) => name));
     const currentNames = new Set(modules.map(({ layer }) => layer.name ?? layer.path));
@@ -145,7 +124,7 @@ async function runStart(options) {
         projectDir: options.project,
         environment: options.env,
     });
-    const built = builtModules(workspaceDir);
+    const built = (0, built_workspace_1.readBuiltModules)(workspaceDir);
     reportModuleSetDrift(built, modules);
     const secrets = (0, common_1.resolveManifestSecrets)({ published: {}, conflicts: [] });
     (0, common_1.reportManifestSecrets)(secrets, (count) => `Set ${count === 1 ? "it" : "them"} in the server's environment, with the value${count === 1 ? "" : "s"} the backend uses`);

package/dist/commands/workspace-task.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setUpWorkspace = setUpWorkspace;
 const cli_1 = require("@antelopejs/core/cli");
+const cancellation_1 = require("../cancellation");
 const common_1 = require("../common");
 const output_1 = require("../output");
 async function setUpWorkspace(options) {
@@ -20,7 +21,7 @@ async function setUpWorkspace(options) {
         return result;
     }
     catch (error) {
-        (0, output_1.endInterruptedTask)(task, error, "Workspace setup stopped");
+        (0, output_1.endInterruptedTask)(task, error instanceof cancellation_1.CancelledError ? error : undefined, "Workspace setup stopped");
         throw error;
     }
 }

package/dist/config.js

@@ -67,6 +67,7 @@ exports.TEMPLATE_FILES = [
     ["head-order.mjs", "head-order.mjs"],
     ["client-chunking.mjs", "client-chunking.mjs"],
     ["entry-weight.mjs", "entry-weight.mjs"],
+    ["backend-boundary.mjs", "backend-boundary.mjs"],
     ["client-server-guard.mjs", "client-server-guard.mjs"],
     ["ui-inertia-page.mjs", "ui-inertia-page.mjs"],
     ["ui-request-state.mjs", "ui-request-state.mjs"],

package/dist/derived-outputs.d.ts

@@ -4,6 +4,7 @@ export interface FrontendModuleRegistryEntry {
     name?: string;
     packageName?: string;
     version?: string;
+    backendPackage?: string;
     root: string;
     priority: number;
     entry?: string;

package/dist/derived-outputs.js

@@ -41,11 +41,13 @@ function createFrontendModuleRegistry(workspaceDir, layers) {
         const buildEntry = (0, node_path_1.join)(layer.path, config_1.FRONTEND_BUILD_ENTRY);
         const serverEntry = (0, node_path_1.join)(layer.path, config_1.SERVER_MODULE_ENTRY);
         const options = layer.options ?? {};
+        const shipping = (0, project_modules_1.readShippingPackage)(layer.sourcePath ?? layer.path);
         return {
             id: (0, layers_1.getLayerSafeName)(layer),
             name: layer.name ?? layer.packageName,
             packageName: layer.packageName,
-            version: (0, project_modules_1.readShippingVersion)(layer.sourcePath ?? layer.path),
+            version: shipping.version,
+            backendPackage: shipping.name,
             root: (0, layers_1.getLayerWorkspacePath)(workspaceDir, layer),
             priority: layer.priority ?? 0,
             entry: (0, node_fs_1.existsSync)(sourceEntry) ? config_1.FRONTEND_MODULE_ENTRY : undefined,
@@ -140,16 +142,16 @@ function discoverAssets(registry, directory, extensions) {
 const LOCALE_DIRECTORY = "i18n/locales";
 function readLocaleMessages(assets, registry) {
     const roots = new Map(registry.modules.map((module) => [module.id, module.root]));
-    const messages = {};
+    const messages = new Map();
     for (const asset of assets) {
         const locale = asset.relativePath.match(/(?:^|[/-])([a-z]{2})-[A-Z]{2}\.json$/)?.[1];
         const root = roots.get(asset.moduleId);
         if (!locale || !root)
             continue;
         const value = (0, locale_files_1.readLocaleFile)((0, node_path_1.join)(root, asset.relativePath));
-        messages[locale] = (0, locale_catalogs_1.mergeLocaleMessages)(value, messages[locale] ?? {});
+        messages.set(locale, (0, locale_catalogs_1.mergeLocaleMessages)(value, messages.get(locale) ?? {}));
     }
-    return messages;
+    return Object.fromEntries(messages);
 }
 function affectsLocaleMessages(relativePath) {
     return (0, asset_roots_1.affectsAssetDirectory)(LOCALE_DIRECTORY, relativePath);

package/dist/discovery.js

@@ -10,6 +10,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const output_1 = require("./output");
 const guards_1 = require("./internal/guards");
+const plain_object_1 = require("./internal/plain-object");
 exports.DEV_REGISTRY_RELATIVE_PATH = (0, node_path_1.join)(".antelope", "dev.json");
 function isPidAlive(pid) {
     if (!Number.isInteger(pid) || pid <= 0)
@@ -22,13 +23,23 @@ function isPidAlive(pid) {
         return err?.code === "EPERM";
     }
 }
+function isEndpoint(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        (0, guards_1.isText)(value.protocol) &&
+        (0, guards_1.isText)(value.host) &&
+        (0, guards_1.isNumber)(value.port));
+}
+function isServer(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        Array.isArray(value.endpoints) &&
+        value.endpoints.every(isEndpoint));
+}
 function isDevRegistry(value) {
-    return ((0, guards_1.isObjectLike)(value) &&
-        "pid" in value &&
-        typeof value.pid === "number" &&
-        "servers" in value &&
-        typeof value.servers === "object" &&
-        value.servers !== null);
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        (0, guards_1.isNumber)(value.pid) &&
+        (value.startedAt === undefined || (0, guards_1.isText)(value.startedAt)) &&
+        (0, plain_object_1.isPlainObject)(value.servers) &&
+        Object.values(value.servers).every(isServer));
 }
 function parseRegistry(file) {
     try {

package/dist/entry-weight.js

@@ -10,6 +10,8 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_zlib_1 = require("node:zlib");
 const cli_1 = require("@antelopejs/core/cli");
+const guards_1 = require("./internal/guards");
+const plain_object_1 = require("./internal/plain-object");
 const output_1 = require("./output");
 exports.ENTRY_WEIGHT_VARIABLE = "DMS_ENTRY_WEIGHT_WARNING";
 exports.DEFAULT_ENTRY_WEIGHT_WARNING_KB = 50;
@@ -18,6 +20,14 @@ const SHARED_OWNER = "shared";
 const TRANSLATIONS_OWNER = "translations";
 const NON_MODULE_OWNERS = new Set([SHARED_OWNER, TRANSLATIONS_OWNER]);
 const BYTES_PER_KB = 1024;
+function isRecordedEntryWeight(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        Array.isArray(value.files) &&
+        value.files.every(guards_1.isText) &&
+        (0, guards_1.isNumber)(value.bytes) &&
+        (0, plain_object_1.isPlainObject)(value.owners) &&
+        Object.values(value.owners).every(guards_1.isNumber));
+}
 function brotliSize(file) {
     const compressed = `${file}.br`;
     if ((0, node_fs_1.existsSync)(compressed))
@@ -31,6 +41,11 @@ function readEntryWeight(workspaceDir) {
     if (!(0, node_fs_1.existsSync)(path))
         return undefined;
     const recorded = JSON.parse((0, node_fs_1.readFileSync)(path, "utf8"));
+    if (!isRecordedEntryWeight(recorded))
+        throw new cli_1.CliError({
+            title: "The client build recorded an entry weight this CLI cannot read",
+            fixes: ["Build again"],
+        });
     const brotli = recorded.files.reduce((sum, file) => sum + brotliSize((0, node_path_1.join)(workspaceDir, "dist", "client", file)), 0);
     const ratio = recorded.bytes ? brotli / recorded.bytes : 0;
     const shares = Object.entries(recorded.owners)

package/dist/fs-sync.js

@@ -18,6 +18,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const ignore_1 = __importDefault(require("ignore"));
 const config_1 = require("./config");
+const plain_object_1 = require("./internal/plain-object");
 function stripExtendedLengthPrefix(p) {
     return p.replace(/^\\\\\?\\/, "");
 }
@@ -32,10 +33,12 @@ function isBlocklistedCopyPath(src, srcPath) {
 }
 function sanitizedPackageContent(raw) {
     const pkg = JSON.parse(raw);
-    delete pkg.devDependencies;
-    if (pkg.scripts) {
-        for (const name of config_1.PNPM_LIFECYCLE_SCRIPTS) {
-            delete pkg.scripts[name];
+    if ((0, plain_object_1.isPlainObject)(pkg)) {
+        delete pkg.devDependencies;
+        if ((0, plain_object_1.isPlainObject)(pkg.scripts)) {
+            for (const name of config_1.PNPM_LIFECYCLE_SCRIPTS) {
+                delete pkg.scripts[name];
+            }
         }
     }
     return `${JSON.stringify(pkg, null, 2)}\n`;

package/dist/help.js

@@ -81,7 +81,7 @@ exports.ENVIRONMENT_VARIABLES = [
 ];
 const ENVIRONMENT_NOTES = [
     "A variable set in the shell wins over both files, and .env.local wins over .env. Only the current directory is read: the generated workspace never loads a .env of its own.",
-    "Workspaces live in ~/.antelopejs/dms-frontend, one per backend URL. dev without -b keys its own on the project directory instead; pass -b to share one with build and start. ajs dms workspaces lists them.",
+    "dev and prepare keep their workspaces in ~/.antelopejs/dms-frontend, one per backend URL, and ajs dms workspaces lists them. dev without -b keys its own on the project directory instead. build and start use <project>/.dms-frontend, or --workspace.",
 ];
 function subcommandTerm(command) {
     const args = command.registeredArguments.map((argument) => argument.required ? `<${argument.name()}>` : `[${argument.name()}]`);

package/dist/index.js

@@ -12,10 +12,11 @@ const start_1 = require("./commands/start");
 const verify_source_1 = require("./commands/verify-source");
 const workspaces_1 = require("./commands/workspaces");
 const env_file_1 = require("./env-file");
+const own_release_1 = require("./internal/own-release");
 const help_1 = require("./help");
 const output_1 = require("./output");
 const update_check_1 = require("./update-check");
-const { version } = require("../package.json");
+const { version } = own_release_1.ownRelease;
 const QUIET_FLAGS = ["-q", "--quiet"];
 const GLOBAL_FLAGS = ["--no-color", ...QUIET_FLAGS];
 const VERBOSE_FLAG = "--verbose";

package/dist/internal/built-workspace.d.ts

@@ -0,0 +1,4 @@
+import type { ServedModule } from "../module-set";
+import type { FrontendModuleOptions } from "../workspace";
+export declare function readBuiltPrivateOptions(workspaceDir: string): Record<string, FrontendModuleOptions>;
+export declare function readBuiltModules(workspaceDir: string): ServedModule[];