@antelopejs/dms-frontend 0.3.8 → 0.3.9

package/dist/commands/build.js

@@ -1,68 +1,60 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cmdBuild = cmdBuild;
-const node_path_1 = require("node:path");
-const chalk_1 = __importDefault(require("chalk"));
 const commander_1 = require("commander");
-const common_1 = require("../common");
-const cli_ui_1 = require("../utils/cli-ui");
+const config_1 = require("../config");
+const cli_1 = require("@antelopejs/core/cli");
+const BUILD_EXAMPLES = [
+    {
+        description: "With DMS_SESSION_SECRET set in the environment or ./.env",
+        command: "ajs dms build -b https://dms.example.com",
+    },
+    {
+        description: "Rebuild from the cache while the backend is down",
+        command: "ajs dms build -b https://dms.example.com --offline",
+    },
+];
 function cmdBuild() {
-    return new commander_1.Command("build")
-        .description("Build for production (downloads layers via ZIP from backend)")
-        .addOption(common_1.Options.backendUrl)
-        .addOption(common_1.Options.force)
-        .addOption(common_1.Options.offline)
-        .addOption(common_1.Options.bootstrapSecret)
-        .action(async (options) => {
-        if (!options.backendUrl) {
-            (0, cli_ui_1.error)("Backend URL is required. Use -b <url> or set DMS_API_BASE_URL.");
-            process.exit(1);
-        }
-        const sessionSecret = (0, common_1.resolveSessionSecret)("build");
-        const spinner = new cli_ui_1.Spinner("Setting up workspace...");
-        await spinner.start();
-        try {
-            const { workspaceDir, manifestFromCache, manifestFetchedAt } = await (0, common_1.setupWorkspace)({
-                backendUrl: options.backendUrl,
-                force: !!options.force,
-                mode: "build",
-                offline: options.offline,
-                bootstrapSecret: (0, common_1.normalizeBootstrapSecret)(options.bootstrapSecret),
-            });
-            await spinner.succeed("Workspace ready");
-            if (manifestFromCache) {
-                (0, cli_ui_1.warning)(`Building from cached manifest and layers archive${manifestFetchedAt ? ` (cached on ${manifestFetchedAt})` : ""} — output may not match the current backend`);
-            }
-            console.log("");
-            (0, cli_ui_1.info)("Building for production...");
-            console.log(chalk_1.default.dim(`  Workspace: ${workspaceDir}`));
-            console.log("");
-            const nodeModulesDir = (0, node_path_1.join)(workspaceDir, "node_modules");
-            const code = await (0, common_1.runCommand)("pnpm", ["run", "build"], {
-                cwd: workspaceDir,
-                env: {
-                    ...process.env,
-                    DMS_SESSION_SECRET: sessionSecret,
-                    NODE_OPTIONS: "--max-old-space-size=4096",
-                    NODE_PATH: nodeModulesDir,
-                },
-            });
-            if (code === 0) {
-                console.log("");
-                (0, cli_ui_1.success)("Build completed successfully!");
-                console.log(chalk_1.default.dim("  Run 'ajs dms start' to start the production server"));
-            }
-            else {
-                (0, cli_ui_1.error)("Build failed");
-            }
-            process.exit(code);
-        }
-        catch (err) {
-            await spinner.fail(`Setup failed: ${err.message}`);
-            process.exit(1);
-        }
-    });
+    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, into the workspace's dist directory. Needs a DMS_SESSION_SECRET of 32 characters or more.")
+        .addOption(config_1.Options.backendUrl("Backend URL to build for; required, as -b or the variable"))
+        .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())
+        .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.d.ts

@@ -0,0 +1,8 @@
+import { type WorkspaceRecord } from "./workspaces-action";
+export interface CleanOptions {
+    backendUrl?: string;
+    all?: boolean;
+    yes?: boolean;
+}
+export declare function describeWorkspaces(records: WorkspaceRecord[], isTerminal: boolean): string[];
+export declare function runClean(options: CleanOptions): Promise<void>;

package/dist/commands/clean-action.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeWorkspaces = describeWorkspaces;
+exports.runClean = runClean;
+const node_fs_1 = require("node:fs");
+const cli_1 = require("@antelopejs/core/cli");
+const common_1 = require("../common");
+const output_1 = require("../output");
+const workspaces_action_1 = require("./workspaces-action");
+const CLEAN_ALL_COMMAND = "ajs dms clean --all";
+const YES_FLAG = "--yes";
+const COLUMN_GAP = "  ";
+const ROW_INDENT = "  ";
+function describeWorkspaces(records, isTerminal) {
+    const rows = records.map((record) => [
+        (0, output_1.workspaceId)(record.dir, isTerminal),
+        record.backendUrl,
+        (0, workspaces_action_1.describeKey)(record),
+    ]);
+    const widths = rows[0].map((_, column) => Math.max(...rows.map((row) => row[column].length)));
+    return rows.map((row) => row
+        .map((cell, column) => cell.padEnd(widths[column]))
+        .join(COLUMN_GAP)
+        .trimEnd());
+}
+async function confirmCleanAll(records, totalBytes, options) {
+    const prompter = (0, cli_1.createPrompter)({ command: CLEAN_ALL_COMMAND });
+    if (!options.yes && prompter.isInteractive) {
+        (0, output_1.writeFeedback)(`Remove ${(0, cli_1.pluralize)(records.length, "workspace")} (${(0, output_1.formatSize)(totalBytes)})?`);
+        for (const line of describeWorkspaces(records, true)) {
+            (0, output_1.writeFeedback)(`${ROW_INDENT}${line}`);
+        }
+    }
+    return prompter.confirm({
+        message: "Continue?",
+        flag: YES_FLAG,
+        answer: options.yes || undefined,
+        defaultAnswer: false,
+    });
+}
+async function cleanAll(options) {
+    const ui = (0, cli_1.getProcessUi)();
+    const { records, skipped } = (0, workspaces_action_1.readWorkspaceRecords)();
+    if (records.length === 0) {
+        ui.message("info", "No workspaces found");
+        (0, workspaces_action_1.reportSkipped)(ui, skipped);
+        return;
+    }
+    const totalBytes = records.reduce((sum, record) => sum + record.sizeBytes, 0);
+    if (!(await confirmCleanAll(records, totalBytes, options))) {
+        ui.message("skip", "Nothing removed");
+        return;
+    }
+    for (const record of records) {
+        (0, node_fs_1.rmSync)(record.dir, { recursive: true, force: true });
+    }
+    ui.message("success", [
+        `Removed ${(0, cli_1.pluralize)(records.length, "workspace")}`,
+        `freed ${(0, output_1.formatSize)(totalBytes)}`,
+    ].join(ui.symbols.separator), {
+        details: options.yes
+            ? describeWorkspaces(records, (0, output_1.isTerminalFeedback)())
+            : [],
+    });
+    (0, workspaces_action_1.reportSkipped)(ui, skipped);
+}
+async function runClean(options) {
+    const ui = (0, cli_1.getProcessUi)();
+    if (options.all) {
+        await cleanAll(options);
+        return;
+    }
+    if (!options.backendUrl) {
+        throw new common_1.UsageError({
+            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 every workspace, including those dev created without -b: ajs dms clean --all",
+                "List the workspaces: ajs dms workspaces",
+            ],
+        });
+    }
+    const backendUrl = (0, common_1.parseBackendUrl)(options.backendUrl);
+    const workspaceDir = (0, common_1.getWorkspaceDir)(backendUrl);
+    if (!(0, node_fs_1.existsSync)(workspaceDir)) {
+        ui.message("info", `No workspace for ${backendUrl}: nothing to clean`);
+        return;
+    }
+    const freedBytes = (0, common_1.directorySize)(workspaceDir);
+    (0, node_fs_1.rmSync)(workspaceDir, { recursive: true, force: true });
+    ui.message("success", [
+        `Removed workspace ${(0, output_1.showWorkspace)(workspaceDir)}`,
+        backendUrl,
+        `freed ${(0, output_1.formatSize)(freedBytes)}`,
+    ].join(ui.symbols.separator));
+}

package/dist/commands/clean.js

@@ -1,45 +1,58 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cmdClean = cmdClean;
-const node_fs_1 = require("node:fs");
 const commander_1 = require("commander");
-const common_1 = require("../common");
-const cli_ui_1 = require("../utils/cli-ui");
+const cli_1 = require("@antelopejs/core/cli");
+const CLEAN_EXAMPLES = [
+    {
+        description: "The workspace build, start and dev -b share for a backend",
+        command: "ajs dms clean -b https://dms.example.com",
+    },
+    {
+        description: "Every workspace, without asking (scripts, CI)",
+        command: "ajs dms clean --all --yes",
+    },
+];
 function cmdClean() {
-    return new commander_1.Command("clean")
-        .description("Remove workspace build artifacts")
-        .addOption(common_1.Options.backendUrl)
-        .option("-a, --all", "Clean all workspaces")
-        .action(async (options) => {
-        console.log("");
-        if (options.all) {
-            (0, cli_ui_1.info)("Cleaning all workspaces...");
-            const workspaces = (0, common_1.listWorkspaces)();
-            if (workspaces.length === 0) {
-                (0, cli_ui_1.info)("No workspaces found.");
-                return;
-            }
-            for (const ws of workspaces) {
-                (0, node_fs_1.rmSync)(ws.dir, { recursive: true, force: true });
-                (0, cli_ui_1.success)(`Removed ${ws.dir} (${(0, common_1.describeWorkspace)(ws)})`);
-            }
-            console.log("");
-            (0, cli_ui_1.success)(`Cleaned ${workspaces.length} workspace(s).`);
-            return;
-        }
-        if (!options.backendUrl) {
-            (0, cli_ui_1.warning)("Specify -b <url> to clean a specific workspace, or --all to clean everything.\n" +
-                "  -b only reaches the workspace 'build', 'start' and 'dev -b' share for that URL;\n" +
-                "  a workspace 'dev' created without -b is keyed on the project directory and is\n" +
-                "  only removable with --all.");
-            process.exit(1);
-        }
-        const workspaceDir = (0, common_1.getWorkspaceDir)(options.backendUrl);
-        if (!(0, node_fs_1.existsSync)(workspaceDir)) {
-            (0, cli_ui_1.info)("Workspace not found — nothing to clean.");
-            return;
-        }
-        (0, node_fs_1.rmSync)(workspaceDir, { recursive: true, force: true });
-        (0, cli_ui_1.success)(`Removed workspace: ${workspaceDir}`);
-    });
+    const command = new commander_1.Command("clean")
+        .summary("Remove generated workspaces")
+        .description("Remove generated workspaces: their node_modules, manifest cache, downloaded layers and build output.")
+        .option("-b, --backend-url <url>", "Backend URL whose workspace to remove; DMS_API_BASE_URL is never read")
+        .option("-a, --all", "Remove every workspace, after a confirmation")
+        .option("-y, --yes", "Skip the confirmation of --all")
+        .action(async (options) => (await Promise.resolve().then(() => __importStar(require("./clean-action")))).runClean(options));
+    return (0, cli_1.withExamples)(command, CLEAN_EXAMPLES);
 }

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

@@ -0,0 +1,8 @@
+export interface DevOptions {
+    backendUrl?: string;
+    port: string;
+    force?: boolean;
+    offline?: boolean;
+    bootstrapSecret?: string;
+}
+export declare function runDev(options: DevOptions): Promise<void>;

package/dist/commands/dev-action.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDev = runDev;
+const node_path_1 = require("node:path");
+const cli_1 = require("@antelopejs/core/cli");
+const common_1 = require("../common");
+const child_output_1 = require("../child-output");
+const discovery_1 = require("../discovery");
+const output_1 = require("../output");
+const ports_1 = require("../ports");
+const server_process_1 = require("../server-process");
+const update_check_1 = require("../update-check");
+const workspace_task_1 = require("./workspace-task");
+function clientHost() {
+    const host = process.env.HOST?.trim();
+    if (!host || host === "0.0.0.0" || host === "::" || host === "[::]") {
+        return "localhost";
+    }
+    return host.includes(":") && !host.startsWith("[") ? `[${host}]` : host;
+}
+function resolveBackend(options) {
+    if (options.backendUrl) {
+        return { backendUrl: (0, common_1.parseBackendUrl)(options.backendUrl) };
+    }
+    const result = (0, discovery_1.discoverBackend)(process.cwd());
+    if (result.status !== "found") {
+        throw new cli_1.CliError((0, discovery_1.describeDiscoveryFailure)(result));
+    }
+    return {
+        backendUrl: result.backend.backendUrl,
+        workspaceKey: (0, common_1.projectWorkspaceKey)(result.backend.projectDir),
+        projectDir: result.backend.projectDir,
+    };
+}
+async function runDev(options) {
+    const startedAt = Date.now();
+    const requestedPort = (0, common_1.parsePort)(options.port);
+    const offline = (0, common_1.flagOrEnv)(options.offline, "DMS_OFFLINE");
+    const sessionSecret = (0, common_1.resolveSessionSecret)("dev");
+    const { backendUrl, workspaceKey, projectDir } = resolveBackend(options);
+    const bootstrapSecret = (0, common_1.resolveBootstrapSecret)(options.bootstrapSecret, backendUrl);
+    const ui = (0, cli_1.getProcessUi)();
+    (0, output_1.writeHeader)("dev", [backendUrl, "development"]);
+    if (projectDir) {
+        ui.message("info", `Backend discovered from ${(0, output_1.showPath)(projectDir)}`);
+    }
+    const reserved = await (0, ports_1.reserveFreePort)(requestedPort);
+    const port = reserved.port;
+    const clientUrl = `http://${clientHost()}:${port}`;
+    const { workspaceDir, layers, manifestFromCache, manifestFetchedAt, manifestSecrets, } = await (0, workspace_task_1.setUpWorkspace)({
+        backendUrl,
+        force: !!options.force,
+        mode: "dev",
+        offline,
+        clientUrl,
+        workspaceKey,
+        bootstrapSecret,
+    });
+    if (port !== requestedPort) {
+        ui.message("warn", `Port ${requestedPort} is busy, using ${port}`);
+    }
+    if (manifestFromCache) {
+        const manifest = `the layers manifest${(0, output_1.cachedAge)(manifestFetchedAt)}`;
+        if (offline) {
+            ui.message("info", `Offline: using ${manifest}`);
+        }
+        else {
+            ui.message("warn", `Backend unreachable: using ${manifest}`, {
+                detail: "API calls fail until the backend is up.",
+            });
+        }
+    }
+    const secrets = (0, common_1.resolveManifestSecrets)(manifestSecrets);
+    (0, common_1.reportManifestSecrets)(secrets, (count) => `Set ${count === 1 ? "it" : "them"} in the environment or the project's .env`);
+    const stopWatchers = (0, common_1.startLayerWatchers)(workspaceDir, layers);
+    const handleShutdown = async () => {
+        await stopWatchers();
+    };
+    process.once("SIGINT", handleShutdown);
+    process.once("SIGTERM", handleShutdown);
+    const nodeModulesDir = (0, node_path_1.join)(workspaceDir, "node_modules");
+    await reserved.release();
+    const secretSources = (0, common_1.describeSecretSources)(secrets.sources);
+    const code = await (0, server_process_1.runServer)({
+        name: "dev server",
+        script: "server.mjs",
+        cwd: workspaceDir,
+        mapPath: (0, child_output_1.createPathMapper)(workspaceDir, layers),
+        env: {
+            ...process.env,
+            PORT: String(port),
+            DMS_DEV: "true",
+            DMS_COOKIE_SECURE: process.env.DMS_COOKIE_SECURE ?? "false",
+            DMS_API_BASE_URL: backendUrl,
+            DMS_BOOTSTRAP_SECRET: bootstrapSecret,
+            DMS_SESSION_SECRET: sessionSecret,
+            ...secrets.env,
+            NODE_OPTIONS: "--max-old-space-size=4096",
+            NODE_PATH: nodeModulesDir,
+        },
+        onReady: (address) => {
+            (0, output_1.writeReadyBlock)({
+                title: `Dev server ready in ${(0, cli_1.formatDuration)(Date.now() - startedAt)}`,
+                lines: (0, server_process_1.readyLines)(address, [
+                    { label: "Backend", value: backendUrl },
+                    { label: "Workspace", value: (0, output_1.showWorkspace)(workspaceDir) },
+                    ...(secretSources
+                        ? [{ label: "Secrets", value: secretSources }]
+                        : []),
+                ]),
+                footer: [
+                    `Watching ${(0, cli_1.pluralize)(layers.length, "layer source")}`,
+                    "Ctrl+C to stop",
+                ].join(ui.symbols.separator),
+            });
+            void (0, update_check_1.reportAvailableUpdate)({ isFollowed: true });
+        },
+    }).finally(stopWatchers);
+    process.exitCode = code;
+}

package/dist/commands/dev.js

@@ -1,121 +1,61 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cmdDev = cmdDev;
-const node_path_1 = require("node:path");
-const chalk_1 = __importDefault(require("chalk"));
 const commander_1 = require("commander");
-const common_1 = require("../common");
-const discovery_1 = require("../discovery");
-const ports_1 = require("../ports");
-const cli_ui_1 = require("../utils/cli-ui");
-function clientHost() {
-    const host = process.env.HOST?.trim();
-    if (!host || host === "0.0.0.0" || host === "::" || host === "[::]") {
-        return "localhost";
-    }
-    return host.includes(":") && !host.startsWith("[") ? `[${host}]` : host;
-}
-function resolveBackend(options) {
-    if (options.backendUrl) {
-        return { backendUrl: options.backendUrl };
-    }
-    const result = (0, discovery_1.discoverBackend)(process.cwd());
-    if (result.status !== "found") {
-        (0, cli_ui_1.error)((0, discovery_1.describeDiscoveryFailure)(result));
-        process.exit(1);
-    }
-    (0, cli_ui_1.info)(`Backend discovered from ${chalk_1.default.cyan(result.backend.projectDir)}: ${chalk_1.default.cyan(result.backend.backendUrl)}`);
-    return {
-        backendUrl: result.backend.backendUrl,
-        workspaceKey: (0, common_1.projectWorkspaceKey)(result.backend.projectDir),
-    };
-}
+const config_1 = require("../config");
+const cli_1 = require("@antelopejs/core/cli");
+const DEV_EXAMPLES = [
+    {
+        description: "Inside a project started with ajs project dev",
+        command: "ajs dms dev",
+    },
+    {
+        description: "Share one workspace with build and start",
+        command: "ajs dms dev -b http://localhost:5010 -p 3001",
+    },
+];
 function cmdDev() {
-    return new commander_1.Command("dev")
-        .description("Start development server with hot reload (direct paths, same machine)")
-        .addOption(common_1.Options.backendUrl)
-        .addOption(common_1.Options.port)
-        .addOption(common_1.Options.force)
-        .addOption(common_1.Options.offline)
-        .addOption(common_1.Options.bootstrapSecret)
-        .action(async (options) => {
-        const { backendUrl, workspaceKey } = resolveBackend(options);
-        const bootstrapSecret = (0, common_1.resolveBootstrapSecret)(options.bootstrapSecret, backendUrl);
-        const sessionSecret = (0, common_1.resolveSessionSecret)("dev");
-        const requestedPort = Number.parseInt(options.port, 10);
-        if (Number.isNaN(requestedPort)) {
-            (0, cli_ui_1.error)(`Invalid port: ${options.port}`);
-            process.exit(1);
-        }
-        let reserved;
-        try {
-            reserved = await (0, ports_1.reserveFreePort)(requestedPort);
-        }
-        catch (err) {
-            (0, cli_ui_1.error)(err.message);
-            process.exit(1);
-        }
-        const port = reserved.port;
-        if (port !== requestedPort) {
-            (0, cli_ui_1.warning)(`Port ${requestedPort} in use, using ${port} instead`);
-        }
-        const clientUrl = `http://${clientHost()}:${port}`;
-        const spinner = new cli_ui_1.Spinner("Setting up workspace...");
-        await spinner.start();
-        try {
-            const { workspaceDir, layers, manifestFromCache, manifestFetchedAt, manifestSecrets, } = await (0, common_1.setupWorkspace)({
-                backendUrl,
-                force: !!options.force,
-                mode: "dev",
-                offline: options.offline,
-                clientUrl,
-                workspaceKey,
-                bootstrapSecret,
-            });
-            await spinner.succeed("Workspace ready");
-            if (manifestFromCache) {
-                (0, cli_ui_1.warning)(`Using cached layers manifest${manifestFetchedAt ? ` (cached on ${manifestFetchedAt})` : ""} — API calls will fail until the backend is up`);
-            }
-            const stopWatchers = (0, common_1.startLayerWatchers)(workspaceDir, layers);
-            const handleShutdown = async () => {
-                await stopWatchers();
-            };
-            process.once("SIGINT", handleShutdown);
-            process.once("SIGTERM", handleShutdown);
-            console.log("");
-            (0, cli_ui_1.info)(`Starting dev server on port ${chalk_1.default.cyan(String(port))}...`);
-            console.log(chalk_1.default.dim(`  Workspace: ${workspaceDir}`));
-            console.log(chalk_1.default.dim(`  Backend:   ${backendUrl}`));
-            console.log(chalk_1.default.dim(`  Watching:  ${layers.length} layer source tree(s)`));
-            const secrets = (0, common_1.resolveManifestSecrets)(manifestSecrets);
-            (0, common_1.reportManifestSecrets)(secrets);
-            console.log("");
-            const nodeModulesDir = (0, node_path_1.join)(workspaceDir, "node_modules");
-            await reserved.release();
-            const code = await (0, common_1.runCommand)("node", ["server.mjs"], {
-                cwd: workspaceDir,
-                env: {
-                    ...process.env,
-                    PORT: String(port),
-                    DMS_DEV: "true",
-                    DMS_COOKIE_SECURE: process.env.DMS_COOKIE_SECURE ?? "false",
-                    DMS_API_BASE_URL: backendUrl,
-                    DMS_BOOTSTRAP_SECRET: bootstrapSecret,
-                    DMS_SESSION_SECRET: sessionSecret,
-                    ...secrets.env,
-                    NODE_OPTIONS: "--max-old-space-size=4096",
-                    NODE_PATH: nodeModulesDir,
-                },
-            });
-            await stopWatchers();
-            process.exit(code);
-        }
-        catch (err) {
-            await spinner.fail(`Setup failed: ${err.message}`);
-            process.exit(1);
-        }
-    });
+    const command = new commander_1.Command("dev")
+        .summary("Run the dev server against a local backend, with hot reload")
+        .description("Run the dev server with hot reload. It reads the frontend modules in place, from the backend's own directories, so the backend runs on this machine.")
+        .addOption(config_1.Options.backendUrl("Backend URL; when omitted, discovered from the enclosing antelope project's .antelope/dev.json"))
+        .addOption(config_1.Options.port)
+        .addOption(config_1.Options.force("Reinstall the workspace dependencies"))
+        .addOption(config_1.Options.offline("Reuse the last cached manifest instead of fetching it"))
+        .addOption(config_1.Options.bootstrapSecret("Discovered from .antelope/dms-dev.json for the project's own backend"))
+        .action(async (options) => (await Promise.resolve().then(() => __importStar(require("./dev-action")))).runDev(options));
+    return (0, cli_1.withExamples)(command, DEV_EXAMPLES);
 }

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

@@ -0,0 +1,8 @@
+export interface PrepareOptions {
+    backendUrl?: string;
+    force?: boolean;
+    offline?: boolean;
+    strict?: boolean;
+    bootstrapSecret?: string;
+}
+export declare function runPrepare(options: PrepareOptions): Promise<void>;