@antelopejs/dms-frontend 0.7.0 → 0.8.0

package/README.md

@@ -44,11 +44,11 @@ In a DMS project started with `ajs project run -w`, serve the dashboard with hot
 pnpm exec ajs dms dev
 ```
 
-For production, build against the backend, then start the frontend server, with `DMS_SESSION_SECRET` and `DMS_BOOTSTRAP_SECRET` 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 -b https://dms.example.com
-pnpm exec ajs dms start -b https://dms.example.com -p 3001
+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.
@@ -61,7 +61,7 @@ pnpm exec ajs dms start -b https://dms.example.com -p 3001
 | 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.12 or later and `@antelopejs/core` `>=1.13.2 <2`. The [compatibility table](https://dms.antelopejs.com/docs/frontend/introduction#compatibility) lists every release.
+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.
 
 ## Documentation
 

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

@@ -1,13 +1,16 @@
 import { CliError } from "@antelopejs/core/cli";
 import { type FramedCommandResult } from "../common";
 export interface BuildOptions {
-    backendUrl?: string;
-    force?: boolean;
-    offline?: boolean;
-    bootstrapSecret?: string;
-    from?: string;
+    project: string;
+    env: string;
     workspace?: string;
+    force?: boolean;
 }
+export declare const DEFAULT_WORKSPACE_DIR = ".dms-frontend";
+export declare function productionWorkspace(options: {
+    project: string;
+    workspace?: string;
+}): string;
 interface BuildStep {
     script: string;
     name: string;

package/dist/commands/build-action.js

@@ -1,34 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BUILD_STEPS = void 0;
+exports.BUILD_STEPS = exports.DEFAULT_WORKSPACE_DIR = void 0;
+exports.productionWorkspace = productionWorkspace;
 exports.buildStepFailure = buildStepFailure;
 exports.runBuild = runBuild;
 const node_path_1 = require("node:path");
 const cli_1 = require("@antelopejs/core/cli");
 const child_output_1 = require("../child-output");
 const common_1 = require("../common");
-const snapshot_1 = require("../snapshot");
 const output_1 = require("../output");
 const vite_output_1 = require("../vite-output");
 const workspace_task_1 = require("./workspace-task");
-function buildSource(options) {
-    if (!options.from) {
-        return { backendUrl: (0, common_1.requireBackendUrl)(options.backendUrl) };
-    }
-    if (options.offline) {
-        throw new cli_1.CliError({
-            title: "--from and --offline cannot be combined",
-            reason: "A snapshot build never asks the backend already.",
-            fixes: ["Drop --offline"],
-        });
-    }
-    const snapshot = (0, snapshot_1.readSnapshot)(options.from);
-    return {
-        backendUrl: options.backendUrl
-            ? (0, common_1.parseBackendUrl)(options.backendUrl)
-            : snapshot.backendUrl,
-        snapshot: { dir: options.from, snapshot },
-    };
+exports.DEFAULT_WORKSPACE_DIR = ".dms-frontend";
+function productionWorkspace(options) {
+    return options.workspace ?? (0, node_path_1.join)(options.project, exports.DEFAULT_WORKSPACE_DIR);
 }
 exports.BUILD_STEPS = [
     {
@@ -122,27 +107,15 @@ async function runBuild(options) {
     }
 }
 async function buildProduction(options, startedAt) {
-    const { backendUrl, snapshot } = buildSource(options);
-    const bootstrapSecret = snapshot
-        ? undefined
-        : (0, common_1.normalizeBootstrapSecret)(options.bootstrapSecret);
     const ui = (0, cli_1.getProcessUi)();
-    (0, output_1.writeHeader)("build", [backendUrl, "production"]);
-    const { workspaceDir, layers, manifestFromCache, manifestFetchedAt, buildOrigin, } = await (0, workspace_task_1.setUpWorkspace)({
-        backendUrl,
+    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",
-        offline: snapshot ? false : (0, common_1.flagOrEnv)(options.offline, "DMS_OFFLINE"),
-        bootstrapSecret,
-        workspaceDir: options.workspace,
-        snapshot,
+        workspaceDir: workspace,
+        project: { projectDir: options.project, environment: options.env },
     });
-    if (snapshot) {
-        ui.message("info", `Building from the snapshot of ${snapshot.snapshot.backendUrl}${(0, output_1.cachedAge)(snapshot.snapshot.takenAt)}`, { detail: `Modules digest ${snapshot.snapshot.digest}` });
-    }
-    else if (manifestFromCache) {
-        ui.message("warn", `Building from the manifest and layers archive${(0, output_1.cachedAge)(manifestFetchedAt)}`, { detail: "The output may not match the current backend." });
-    }
     ui.message("info", "Building for production", {
         detail: `Workspace  ${(0, output_1.showWorkspace)(workspaceDir)}`,
     });
@@ -162,7 +135,6 @@ async function buildProduction(options, startedAt) {
     };
     for (const step of exports.BUILD_STEPS)
         await runBuildStep(step, context);
-    (0, snapshot_1.writeBuildOrigin)(workspaceDir, buildOrigin);
     (0, vite_output_1.reportViteWarnings)(context.warnings, isVerbose, ui);
     (0, output_1.writeBlankLine)();
     ui.summary({
@@ -172,9 +144,9 @@ async function buildProduction(options, startedAt) {
         nextSteps: [
             {
                 command: options.workspace
-                    ? `ajs dms start -b ${backendUrl} --workspace ${options.workspace}`
-                    : `ajs dms start -b ${backendUrl}`,
-                description: "with DMS_SESSION_SECRET and the server's secrets in its environment",
+                    ? `ajs dms start -b <backend> --workspace ${options.workspace}`
+                    : "ajs dms start -b <backend>",
+                description: "from the project, with DMS_SESSION_SECRET, the server's secrets and the deployment's variables in its environment",
             },
         ],
     });

package/dist/commands/build.js

@@ -39,28 +39,22 @@ const config_1 = require("../config");
 const cli_1 = require("@antelopejs/core/cli");
 const BUILD_EXAMPLES = [
     {
-        description: "With DMS_BOOTSTRAP_SECRET set in the environment or ./.env",
-        command: "ajs dms build -b https://dms.example.com",
+        description: "From the project root, into .dms-frontend: no backend, no secret, no network",
+        command: "ajs dms build",
     },
     {
-        description: "From a snapshot, without the backend or any secret, into the project (a container image)",
-        command: "ajs dms build --from dms-snapshot --workspace .dms-frontend",
-    },
-    {
-        description: "Rebuild from the cache while the backend is down",
-        command: "ajs dms build -b https://dms.example.com --offline",
+        description: "With another environment's configuration, into a directory",
+        command: "ajs dms build -e staging --workspace /srv/dms-frontend",
     },
 ];
 function cmdBuild() {
     const command = new commander_1.Command("build")
         .summary("Build the production frontend")
-        .description("Build the production frontend from the manifest and layers archive the backend serves, or from a snapshot of them, into the workspace's dist directory. The build holds no secret: the server reads its own from its environment when it starts.")
-        .addOption(config_1.Options.backendUrl("Backend URL to build for; required, as -b or the variable, unless --from names a snapshot"))
-        .addOption(new commander_1.Option("--from <dir>", "Build from the snapshot in this directory (ajs dms snapshot), without the backend"))
-        .addOption(config_1.Options.workspace("Build into this directory instead of the workspace under ~/.antelopejs, to ship it with the project"))
-        .addOption(config_1.Options.force("Extract the layers archive from scratch and reinstall the workspace dependencies"))
-        .addOption(config_1.Options.offline("Build from the last cached manifest and layers archive, without the backend"))
-        .addOption(config_1.Options.bootstrapSecret())
+        .description("Build the production frontend from the AntelopeJS project itself: its antelope.config.ts, evaluated for the environment, and the frontend of each installed module that declares one (dmsFrontend in its package.json). No backend is asked. The build holds no secret, and start computes the modules' options again from the deployment's variables.")
+        .addOption(config_1.Options.project)
+        .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"))
         .action(async (options) => (await Promise.resolve().then(() => __importStar(require("./build-action")))).runBuild(options));
     return (0, cli_1.withExamples)(command, BUILD_EXAMPLES);
 }

package/dist/commands/dev-action.js

@@ -12,6 +12,7 @@ const server_process_1 = require("../server-process");
 const update_check_1 = require("../update-check");
 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");
 function clientHost() {
     const host = process.env.HOST?.trim();
@@ -109,7 +110,10 @@ function servedModules(setup) {
     return (0, manifest_1.readCachedManifest)(setup.workspaceDir)?.manifest.modules ?? [];
 }
 function reportServed(session, setup) {
-    return (0, module_set_1.reportFrontendReady)(session.backendUrl, servedModules(setup).map((module) => module.name), session.bootstrapSecret);
+    return (0, module_set_1.reportFrontendReady)(session.backendUrl, servedModules(setup).map((module) => ({
+        name: module.name,
+        version: module.path ? (0, project_modules_1.readShippingVersion)(module.path) : undefined,
+    })), session.bootstrapSecret);
 }
 async function serveWorkspace(session, setup) {
     const restart = new AbortController();

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

@@ -1,6 +1,8 @@
 export interface StartOptions {
     backendUrl?: string;
     port: string;
+    project: string;
+    env: string;
     workspace?: string;
 }
 export declare function runStart(options: StartOptions): Promise<void>;

package/dist/commands/start-action.js

@@ -10,11 +10,12 @@ const ports_1 = require("../ports");
 const server_process_1 = require("../server-process");
 const update_check_1 = require("../update-check");
 const module_set_1 = require("../module-set");
-const snapshot_1 = require("../snapshot");
+const project_modules_1 = require("../project-modules");
 const config_1 = require("../config");
 const manifest_secrets_1 = require("../manifest-secrets");
 const private_values_1 = require("../private-values");
-const BUILD_TIME_MANIFEST = "the build-time manifest";
+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"));
@@ -51,72 +52,54 @@ function serverNodeEnv() {
     }
     return nodeEnv;
 }
-async function reportDrift(backendUrl, origin) {
+function publicOptionsById(modules) {
+    return Object.fromEntries(modules.map(({ layer }) => {
+        const options = layer.options ?? {};
+        return [
+            (0, common_1.getLayerSafeName)(layer),
+            layer.configKey ? { [layer.configKey]: options } : options,
+        ];
+    }));
+}
+async function reportServedModules(backendUrl, modules) {
+    const isTaken = await (0, module_set_1.reportFrontendReadyOnceAnswered)(backendUrl, modules.map(({ layer, version }) => ({
+        name: layer.name ?? layer.path,
+        version,
+    })), process.env.DMS_BOOTSTRAP_SECRET);
     const ui = (0, cli_1.getProcessUi)();
-    const bootstrapSecret = process.env.DMS_BOOTSTRAP_SECRET?.trim();
-    if (!origin)
-        return;
-    if (origin.authenticated === false) {
-        ui.message("info", `Built from modules ${origin.digest}; not compared with the backend`, {
-            detail: "The build read the manifest without DMS_BOOTSTRAP_SECRET, which leaves out the backend proxies.",
-        });
+    if (isTaken) {
+        ui.message("info", `[DMS] Reported ${modules.length} modules to the backend (dms-frontend ${module_set_1.OWN_RELEASE.version})`);
         return;
     }
-    if (!bootstrapSecret) {
-        ui.message("info", `Built from modules ${origin.digest}; not compared with the backend`, { detail: "Set DMS_BOOTSTRAP_SECRET to have start compare them." });
-        return;
-    }
-    const drift = await (0, module_set_1.compareWithBackend)(backendUrl, origin.digest, snapshot_1.manifestDigest, bootstrapSecret);
-    if (drift.status === "matches") {
-        ui.message("info", `The backend serves the modules ${origin.digest} this build was made from`);
-        return;
-    }
-    if (drift.status === "unknown") {
-        ui.message("info", `Built from modules ${origin.digest}; not compared with the backend: ${drift.reason}`);
-        return;
-    }
-    const refresh = origin.source === "snapshot"
-        ? `Refresh the snapshot and rebuild: ajs dms snapshot -b ${backendUrl} -o <dir>, then ajs dms build --from <dir>`
-        : `Rebuild: ajs dms build -b ${backendUrl}`;
-    ui.message("warn", `The backend serves modules ${drift.served}; this build was made from ${origin.digest} (${origin.source}${(0, output_1.cachedAge)(origin.takenAt)})`, {
+    ui.message("warn", "[DMS] The backend refused the ready report: it cannot check this build's module versions", {
         details: [
-            "Pages of modules added or removed since, or whose routes changed, are missing or stale.",
-            `${ui.symbols.levels.hint} ${refresh}`,
+            `${ui.symbols.levels.hint} Set DMS_BOOTSTRAP_SECRET to the backend's frontend.bootstrapSecret`,
         ],
     });
 }
 async function runStart(options) {
     const startedAt = Date.now();
-    const explicitWorkspace = options.workspace
-        ? (0, node_path_1.resolve)(options.workspace)
-        : undefined;
-    const origin = explicitWorkspace
-        ? (0, snapshot_1.readBuildOrigin)(explicitWorkspace)
-        : undefined;
-    const backendUrl = (0, common_1.requireBackendUrl)(options.backendUrl ?? origin?.backendUrl);
+    const workspaceDir = (0, node_path_1.resolve)((0, build_action_1.productionWorkspace)(options));
+    const backendUrl = (0, common_1.requireBackendUrl)(options.backendUrl);
     const requestedPort = (0, common_1.parsePort)(options.port);
     const sessionSecret = (0, common_1.resolveSessionSecret)("start");
-    const workspaceDir = explicitWorkspace ?? (0, common_1.getWorkspaceDir)(backendUrl);
     const serverPath = (0, node_path_1.join)(workspaceDir, "server.mjs");
     const clientPath = (0, node_path_1.join)(workspaceDir, "dist", "client", "index.html");
     if (!(0, node_fs_1.existsSync)(serverPath) || !(0, node_fs_1.existsSync)(clientPath)) {
         throw new cli_1.CliError({
-            title: `No production build for ${backendUrl}`,
+            title: "No production build to serve",
             reason: `${(0, output_1.showWorkspace)(workspaceDir)} has no built server or client.`,
             fixes: [
-                explicitWorkspace
-                    ? `Build it first: ajs dms build --from <snapshot> --workspace ${options.workspace}`
-                    : `Build it first: ajs dms build -b ${backendUrl}`,
+                options.workspace
+                    ? `Build it first: ajs dms build --workspace ${options.workspace}`
+                    : "Build it first: ajs dms build",
             ],
         });
     }
-    if (!explicitWorkspace) {
-        (0, common_1.writeWorkspaceMeta)(workspaceDir, backendUrl, (0, common_1.canonicalizeBackendUrl)(backendUrl));
-    }
     const builtAt = (0, node_fs_1.statSync)(clientPath).mtime.toISOString();
     (0, output_1.writeHeader)("start", [
         backendUrl,
-        "production",
+        options.env,
         `built ${(0, output_1.formatAge)(builtAt)}`,
     ]);
     const reserved = await (0, ports_1.reservePort)(requestedPort);
@@ -129,10 +112,14 @@ async function runStart(options) {
         });
     }
     const port = reserved.port;
-    const secrets = (0, common_1.resolveManifestSecrets)((0, common_1.collectManifestSecrets)((0, common_1.readCachedManifest)(workspaceDir)?.manifest.modules ?? []));
+    const modules = await (0, project_modules_1.readProjectFrontendModules)({
+        projectDir: options.project,
+        environment: options.env,
+    });
+    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`);
     reportUnfilledPrivateValues(workspaceDir);
-    const secretSources = (0, common_1.describeSecretSources)(secrets.sources, BUILD_TIME_MANIFEST);
+    const secretSources = (0, common_1.describeSecretSources)(secrets.sources);
     const nodeEnv = serverNodeEnv();
     await reserved.release();
     const code = await (0, server_process_1.runServer)({
@@ -145,6 +132,7 @@ async function runStart(options) {
             PORT: String(port),
             DMS_API_BASE_URL: backendUrl,
             DMS_SESSION_SECRET: sessionSecret,
+            [PUBLIC_OPTIONS_VARIABLE]: JSON.stringify(publicOptionsById(modules)),
             ...secrets.env,
             DMS_COOKIE_SECURE: process.env.DMS_COOKIE_SECURE ?? "true",
         },
@@ -160,9 +148,8 @@ async function runStart(options) {
                 ]),
                 footer: "Ctrl+C to stop",
             });
-            void (0, module_set_1.reportFrontendReady)(backendUrl, ((0, common_1.readCachedManifest)(workspaceDir)?.manifest.modules ?? []).map((module) => module.name), process.env.DMS_BOOTSTRAP_SECRET);
+            void reportServedModules(backendUrl, modules);
             void (0, update_check_1.reportAvailableUpdate)({ isFollowed: true });
-            void reportDrift(backendUrl, origin ?? (0, snapshot_1.readBuildOrigin)(workspaceDir));
         },
     });
     process.exitCode = code;

package/dist/commands/start.js

@@ -39,21 +39,23 @@ const config_1 = require("../config");
 const cli_1 = require("@antelopejs/core/cli");
 const START_EXAMPLES = [
     {
-        description: "After ajs dms build -b https://dms.example.com",
-        command: "ajs dms start -b https://dms.example.com -p 3001",
+        description: "From the project root, after ajs dms build",
+        command: "ajs dms start -b https://api.example.com -p 3001",
     },
     {
-        description: "From a build shipped with the project, in a read-only container",
+        description: "In a read-only container holding the project and its build",
         command: "ajs dms start --workspace .dms-frontend -p 3000",
     },
 ];
 function cmdStart() {
     const command = new commander_1.Command("start")
         .summary("Serve the production build")
-        .description("Serve the production frontend ajs dms build made for the same backend URL, or the one in --workspace. Reads DMS_SESSION_SECRET and the server's secrets (DMS_HTML_RENDER_SECRET, DMS_OAUTH_RELAY_SECRET) from its environment, and says once ready whether the backend still serves the modules the build was made from.")
-        .addOption(config_1.Options.backendUrl("Backend URL to serve; required, as -b or the variable, unless --workspace holds a build that records it"))
+        .description("Serve the production frontend ajs dms build made from the project. The modules' public options are computed again from the project's configuration and the current environment variables, so a deployment's variables need no rebuild. Reads DMS_SESSION_SECRET and the server's secrets (DMS_HTML_RENDER_SECRET, DMS_OAUTH_RELAY_SECRET) from its environment, and tells the backend once ready which module versions it serves.")
+        .addOption(config_1.Options.backendUrl("Backend URL to serve; required"))
         .addOption(config_1.Options.port)
-        .addOption(config_1.Options.workspace("Serve the build in this directory (ajs dms build --workspace); start writes nothing into it"))
+        .addOption(config_1.Options.project)
+        .addOption(config_1.Options.env)
+        .addOption(config_1.Options.workspace("Serve the build in this directory instead of <project>/.dms-frontend; start writes nothing into it"))
         .action(async (options) => (await Promise.resolve().then(() => __importStar(require("./start-action")))).runStart(options));
     return (0, cli_1.withExamples)(command, START_EXAMPLES);
 }

package/dist/config.d.ts

@@ -33,6 +33,8 @@ export declare const Options: {
     offline(description: string): Option;
     strict: Option;
     workspace(description: string): Option;
+    project: Option;
+    env: Option;
     bootstrapSecret(discovery?: string): Option;
 };
 export interface BootstrapDiscoveryOptions extends DiscoveryOptions {

package/dist/config.js

@@ -62,6 +62,7 @@ exports.TEMPLATE_FILES = [
     ["globals.d.ts", "globals.d.ts"],
     ["compress-assets.mjs", "compress-assets.mjs"],
     ["head-order.mjs", "head-order.mjs"],
+    ["client-chunking.mjs", "client-chunking.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"],
@@ -71,6 +72,7 @@ exports.TEMPLATE_FILES = [
     ["email-runtime.ts", "email-runtime.ts"],
     ["email-locales.ts", "email-locales.ts"],
     ["email-markup.ts", "email-markup.ts"],
+    ["public-options.ts", "public-options.ts"],
     ["tsconfig.json", "tsconfig.json"],
     ["typecheck-loader.mjs", "typecheck-loader.mjs"],
     ["prepare-types.mjs", "prepare-types.mjs"],
@@ -185,6 +187,10 @@ exports.Options = {
     workspace(description) {
         return new commander_1.Option("--workspace <dir>", description).env("DMS_WORKSPACE_DIR");
     },
+    project: new commander_1.Option("--project <dir>", "The AntelopeJS project whose antelope.config.ts and installed modules make the frontend").default("."),
+    env: new commander_1.Option("-e, --env <environment>", "The AntelopeJS environment whose configuration applies, as ajs project start -e")
+        .default("production")
+        .env("ANTELOPEJS_LAUNCH_ENV"),
     bootstrapSecret(discovery) {
         return new commander_1.Option("--bootstrap-secret <secret>", discovery
             ? `${BOOTSTRAP_SECRET_DESCRIPTION}. ${discovery}`

package/dist/derived-outputs.js

@@ -72,7 +72,7 @@ function writeFrontendModuleLoader(workspaceDir, registry) {
         .map((module, index) => `import module${index} from "@frontend/${module.id}/${module.entry}";`)
         .join("\n");
     const registrations = modules
-        .map((module, index) => `{ name: ${JSON.stringify(module.name)}, module: module${index}, options: { public: ${JSON.stringify(module.options)} } }`)
+        .map((module, index) => `{ id: ${JSON.stringify(module.id)}, name: ${JSON.stringify(module.name)}, module: module${index}, options: { public: ${JSON.stringify(module.options)} } }`)
         .join(", ");
     const content = `${imports}\n\nimport type { DmsFrontendModuleRegistration } from "./frontend-module";\n\nexport const frontendModules: DmsFrontendModuleRegistration[] = [${registrations}];\n`;
     return (0, fs_sync_1.applyContent)(content, (0, node_path_1.join)(workspaceDir, "frontend-modules.generated.ts"));
@@ -85,7 +85,7 @@ function writeFrontendBuildLoader(workspaceDir, registry) {
     const declarations = modules
         .map((module, index) => `{ id: ${JSON.stringify(module.id)}, setup: build${index} }`)
         .join(", ");
-    const content = `${imports}\n\nimport type { FrontendBuildDeclaration } from "./frontend-build-loader";\n\nexport const frontendBuilds: FrontendBuildDeclaration[] = [${declarations}];\n`;
+    const content = `${imports}\n\nimport type { FrontendBuildDeclaration } from "./frontend-build-loader.ts";\n\nexport const frontendBuilds: FrontendBuildDeclaration[] = [${declarations}];\n`;
     return (0, fs_sync_1.applyContent)(content, (0, node_path_1.join)(workspaceDir, "frontend-builds.generated.ts"));
 }
 function writeServerModuleLoader(workspaceDir, registry) {

package/dist/fs-sync.d.ts

@@ -2,6 +2,7 @@ export declare function stripExtendedLengthPrefix(p: string): string;
 export declare function toPosixPath(path: string, separator?: string): string;
 export declare function isBlocklistedCopyPath(src: string, srcPath: string): boolean;
 export declare function sanitizedPackageContent(raw: string): string;
+export declare function sanitizedBuildDeclaration(raw: string): string;
 export declare function filesIdentical(srcPath: string, destPath: string): boolean;
 export declare function applyContent(content: string, destPath: string): boolean;
 export declare function applyFile(srcPath: string, destPath: string): boolean;

package/dist/fs-sync.js

@@ -7,6 +7,7 @@ exports.stripExtendedLengthPrefix = stripExtendedLengthPrefix;
 exports.toPosixPath = toPosixPath;
 exports.isBlocklistedCopyPath = isBlocklistedCopyPath;
 exports.sanitizedPackageContent = sanitizedPackageContent;
+exports.sanitizedBuildDeclaration = sanitizedBuildDeclaration;
 exports.filesIdentical = filesIdentical;
 exports.applyContent = applyContent;
 exports.applyFile = applyFile;
@@ -39,6 +40,11 @@ function sanitizedPackageContent(raw) {
     }
     return `${JSON.stringify(pkg, null, 2)}\n`;
 }
+const BUILD_HELPER_IMPORT = /(["'])#dms\/frontend-build\1/g;
+const BUILD_HELPER_FROM_MODULE_ROOT = "../../frontend-build.ts";
+function sanitizedBuildDeclaration(raw) {
+    return raw.replace(BUILD_HELPER_IMPORT, (_, quote) => `${quote}${BUILD_HELPER_FROM_MODULE_ROOT}${quote}`);
+}
 function filesIdentical(srcPath, destPath) {
     if (!(0, node_fs_1.existsSync)(destPath))
         return false;

package/dist/help.js

@@ -15,6 +15,10 @@ exports.ENVIRONMENT_VARIABLES = [
     ],
     ["DMS_OFFLINE", "Same as --offline, unless 0, false, no or off"],
     ["DMS_WORKSPACE_DIR", "Same as build and start --workspace"],
+    [
+        "ANTELOPEJS_LAUNCH_ENV",
+        "AntelopeJS environment build and start evaluate the project in, same as -e",
+    ],
     ["DMS_PREPARE_STRICT", "Same as prepare --strict, read like DMS_OFFLINE"],
     ["PORT", "Same as -p"],
     [
@@ -29,6 +33,10 @@ exports.ENVIRONMENT_VARIABLES = [
         "NODE_ENV",
         "Build of Vue and its libraries the server loads (default: development in dev, production in start)",
     ],
+    [
+        "DMS_CLIENT_IP_HEADER",
+        "Header the hosting platform overwrites with the client's address, e.g. X-Client-IP (default: none)",
+    ],
     [
         "DMS_TRUSTED_PROXY_HOPS",
         "Trusted reverse-proxy hops, counted from the right (default: 0)",
@@ -61,10 +69,6 @@ exports.ENVIRONMENT_VARIABLES = [
         "DMS_BACKEND_PROXIES",
         "More backend prefixes the server proxies, as a JSON array of { path, auth? }",
     ],
-    [
-        "DMS_BACKEND_WAKE_BUDGET_MS",
-        "How long a GET or HEAD waits out a backend's cold-start 503, in ms (default: 30000; 0: never)",
-    ],
     ["DMS_CLIENT_BASE_URL", "Public frontend URL used in links and e-mails"],
     ["NO_COLOR", "Same as --no-color"],
     ["ANTELOPEJS_VERBOSE", "Same as --verbose"],

package/dist/index.js

@@ -8,7 +8,6 @@ const build_1 = require("./commands/build");
 const clean_1 = require("./commands/clean");
 const dev_1 = require("./commands/dev");
 const prepare_1 = require("./commands/prepare");
-const snapshot_1 = require("./commands/snapshot");
 const start_1 = require("./commands/start");
 const verify_source_1 = require("./commands/verify-source");
 const workspaces_1 = require("./commands/workspaces");
@@ -29,12 +28,12 @@ const ROOT_EXAMPLES = [
         command: "ajs dms dev",
     },
     {
-        description: "Build for production, then serve the build",
-        command: "ajs dms build -b https://dms.example.com",
+        description: "Build for production from the project root, without a backend",
+        command: "ajs dms build",
     },
     {
-        description: "Serve it on another port",
-        command: "ajs dms start -b https://dms.example.com -p 3001",
+        description: "Serve the build against its backend, on another port",
+        command: "ajs dms start -b https://api.example.com -p 3001",
     },
 ];
 function describeVersion(version, width) {
@@ -117,7 +116,6 @@ const runCLI = async () => {
     program.addCommand((0, dev_1.cmdDev)());
     program.addCommand((0, build_1.cmdBuild)());
     program.addCommand((0, start_1.cmdStart)());
-    program.addCommand((0, snapshot_1.cmdSnapshot)());
     program.addCommand((0, prepare_1.cmdPrepare)());
     program.addCommand((0, workspaces_1.cmdWorkspaces)());
     program.addCommand((0, clean_1.cmdClean)());

package/dist/layer-watch.js

@@ -9,6 +9,7 @@ const node_path_1 = require("node:path");
 const cli_1 = require("@antelopejs/core/cli");
 const chokidar_1 = __importDefault(require("chokidar"));
 const child_output_1 = require("./child-output");
+const config_1 = require("./config");
 const layers_1 = require("./layers");
 const derived_outputs_1 = require("./derived-outputs");
 const output_1 = require("./output");
@@ -62,6 +63,9 @@ function createLayerSync(src, dest, reporter, onStaged) {
             if (rel === "package.json") {
                 (0, fs_sync_1.applyContent)((0, fs_sync_1.sanitizedPackageContent)((0, node_fs_1.readFileSync)(srcPath, "utf-8")), destPath);
             }
+            else if (rel === config_1.FRONTEND_BUILD_ENTRY) {
+                (0, fs_sync_1.applyContent)((0, fs_sync_1.sanitizedBuildDeclaration)((0, node_fs_1.readFileSync)(srcPath, "utf-8")), destPath);
+            }
             else {
                 (0, fs_sync_1.applyFile)(srcPath, destPath);
             }

package/dist/layers.d.ts

@@ -7,15 +7,13 @@ interface PathlessManifestSource {
     };
 }
 export declare function assertLayerPathsServed(modules: ManifestModule[], backendUrl: string, { bootstrapSecret, cache }?: PathlessManifestSource): asserts modules is ServedWithPath[];
-export declare function assertCachedArchivesExist(modules: ManifestModule[], cacheDir: string, fetchedAt?: string): void;
 export interface LayerPackage {
     name?: unknown;
     engines?: Record<string, unknown>;
+    dmsFrontend?: unknown;
 }
 export declare function readLayerPackage(layerPath: string): LayerPackage | undefined;
 export declare function buildLayersFromPaths(modules: ServedWithPath[]): ResolvedLayer[];
-export declare function downloadAndExtractLayers(backendUrl: string, packUrl: string, cacheDir: string, force: boolean, bootstrapSecret?: string): Promise<void>;
-export declare function buildLayersFromCache(modules: ManifestModule[], cacheDir: string): Promise<ResolvedLayer[]>;
 export declare function getLayerSafeName(layer: ResolvedLayer): string;
 export declare function getLayerWorkspacePath(workspaceDir: string, layer: ResolvedLayer): string;
 export {};