@antelopejs/dms-frontend 0.3.8 → 0.3.10

package/dist/commands/prepare-action.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPrepare = runPrepare;
+const cli_1 = require("@antelopejs/core/cli");
+const common_1 = require("../common");
+const output_1 = require("../output");
+const workspace_task_1 = require("./workspace-task");
+const NOT_GENERATED = "The types and the module registry were not generated.";
+const STRICT_HINT = "prepare never fails an install; add --strict to make this an error.";
+function isSkip(error) {
+    return (error instanceof common_1.BackendUnreachableError ||
+        error instanceof common_1.NoCachedManifestError);
+}
+async function runPrepare(options) {
+    const startedAt = Date.now();
+    const offline = (0, common_1.flagOrEnv)(options.offline, "DMS_OFFLINE");
+    const strict = (0, common_1.flagOrEnv)(options.strict, "DMS_PREPARE_STRICT");
+    const ui = (0, cli_1.getProcessUi)();
+    const hint = ui.symbols.levels.hint;
+    if (!options.backendUrl) {
+        if (strict)
+            (0, common_1.requireBackendUrl)(options.backendUrl);
+        ui.message("warn", "Skipped prepare: no backend URL", {
+            details: [
+                `${hint} Pass -b <url> or set DMS_API_BASE_URL to generate the types`,
+                STRICT_HINT,
+            ],
+        });
+        return;
+    }
+    let result;
+    try {
+        const backendUrl = (0, common_1.parseBackendUrl)(options.backendUrl);
+        const bootstrapSecret = (0, common_1.resolveBootstrapSecret)(options.bootstrapSecret, options.backendUrl);
+        (0, output_1.writeHeader)("prepare", [backendUrl]);
+        result = await (0, workspace_task_1.setUpWorkspace)({
+            backendUrl,
+            force: !!options.force,
+            mode: "dev",
+            offline,
+            bootstrapSecret,
+        });
+    }
+    catch (err) {
+        if (err instanceof common_1.CancelledError || strict)
+            throw err;
+        const [title, ...details] = (0, output_1.failureDetails)(err, ui);
+        const outcome = isSkip(err) ? "Skipped prepare" : "Prepare failed";
+        ui.message("warn", `${outcome}: ${title}`, {
+            details: [...details, NOT_GENERATED, STRICT_HINT],
+        });
+        return;
+    }
+    const { workspaceDir, layers, manifestFromCache, manifestFetchedAt } = result;
+    if (manifestFromCache) {
+        const manifest = `the frontend-module manifest${(0, output_1.cachedAge)(manifestFetchedAt)}`;
+        if (offline) {
+            ui.message("info", `Offline: using ${manifest}`);
+        }
+        else {
+            ui.message("warn", `Backend unreachable: using ${manifest}`);
+        }
+    }
+    const summary = [
+        "Prepared the workspace",
+        (0, cli_1.pluralize)(layers.length, "module"),
+        "types and registry written",
+        (0, cli_1.formatDuration)(Date.now() - startedAt),
+    ];
+    ui.message("success", summary.join(ui.symbols.separator), {
+        detail: (0, output_1.showWorkspace)(workspaceDir),
+    });
+}

package/dist/commands/prepare.js

@@ -1,60 +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.cmdPrepare = cmdPrepare;
-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 PREPARE_EXAMPLES = [
+    {
+        description: "From a frontend module's postinstall hook",
+        command: "ajs dms prepare",
+    },
+    {
+        description: "Before a CI type check, which needs the types",
+        command: "ajs dms prepare -b http://localhost:5010 --strict",
+    },
+];
 function cmdPrepare() {
-    return new commander_1.Command("prepare")
-        .description("Prepare the generated Vite workspace and frontend-module registry")
-        .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.warning)("Backend URL not set; skipping prepare. Pass -b <url> or set DMS_API_BASE_URL to generate types.");
-            process.exit(0);
-        }
-        const spinner = new cli_ui_1.Spinner("Setting up workspace...");
-        await spinner.start();
-        let workspaceDir;
-        let manifestFromCache;
-        let manifestFetchedAt;
-        try {
-            const result = await (0, common_1.setupWorkspace)({
-                backendUrl: options.backendUrl,
-                force: !!options.force,
-                mode: "dev",
-                offline: options.offline,
-                bootstrapSecret: (0, common_1.resolveBootstrapSecret)(options.bootstrapSecret, options.backendUrl),
-            });
-            workspaceDir = result.workspaceDir;
-            manifestFromCache = result.manifestFromCache;
-            manifestFetchedAt = result.manifestFetchedAt;
-        }
-        catch (err) {
-            await spinner.warn(`Skipping prepare: ${err.message}`);
-            process.exit(0);
-        }
-        await spinner.succeed("Workspace ready");
-        if (manifestFromCache) {
-            const cachedOn = manifestFetchedAt
-                ? ` (cached on ${manifestFetchedAt})`
-                : "";
-            if (options.offline) {
-                (0, cli_ui_1.info)(`Offline mode — using cached frontend-module manifest${cachedOn}`);
-            }
-            else {
-                (0, cli_ui_1.warning)(`Backend unreachable — using cached frontend-module manifest${cachedOn}`);
-            }
-        }
-        console.log("");
-        (0, cli_ui_1.success)(`Vite workspace prepared ${chalk_1.default.dim(`(${workspaceDir})`)}`);
-        process.exit(0);
-    });
+    const command = new commander_1.Command("prepare")
+        .summary("Generate the workspace and module types (postinstall-safe)")
+        .description("Generate the workspace, the frontend-module registry and the module types. Without --strict, prepare never fails: when it cannot prepare the workspace it warns and exits 0, so a postinstall hook never breaks an install.")
+        .addOption(config_1.Options.backendUrl("Backend URL; without one, prepare is skipped with a warning"))
+        .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.strict)
+        .addOption(config_1.Options.bootstrapSecret("Discovered from .antelope/dms-dev.json for the enclosing project's backend"))
+        .action(async (options) => (await Promise.resolve().then(() => __importStar(require("./prepare-action")))).runPrepare(options));
+    return (0, cli_1.withExamples)(command, PREPARE_EXAMPLES);
 }

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

@@ -0,0 +1,5 @@
+export interface StartOptions {
+    backendUrl?: string;
+    port: string;
+}
+export declare function runStart(options: StartOptions): Promise<void>;

package/dist/commands/start-action.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStart = runStart;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const cli_1 = require("@antelopejs/core/cli");
+const common_1 = require("../common");
+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 BUILD_TIME_MANIFEST = "the build-time manifest";
+async function runStart(options) {
+    const startedAt = Date.now();
+    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 = (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}`,
+            reason: `${(0, output_1.showWorkspace)(workspaceDir)} has no built server or client.`,
+            fixes: [`Build it first: ajs dms build -b ${backendUrl}`],
+        });
+    }
+    (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",
+        `built ${(0, output_1.formatAge)(builtAt)}`,
+    ]);
+    const reserved = await (0, ports_1.reservePort)(requestedPort);
+    if (!reserved) {
+        throw new cli_1.CliError({
+            title: `Port ${requestedPort} is already in use`,
+            fixes: [
+                "Stop the process listening on it, or pass another port: -p <port>",
+            ],
+        });
+    }
+    const port = reserved.port;
+    const secrets = (0, common_1.resolveManifestSecrets)((0, common_1.collectManifestSecrets)((0, common_1.readCachedManifest)(workspaceDir)?.manifest.modules ?? []));
+    (0, common_1.reportManifestSecrets)(secrets, (count) => `Set ${count === 1 ? "it" : "them"}, or rebuild with DMS_BOOTSTRAP_SECRET so the manifest carries ${count === 1 ? "it" : "them"}`);
+    const secretSources = (0, common_1.describeSecretSources)(secrets.sources, BUILD_TIME_MANIFEST);
+    await reserved.release();
+    const code = await (0, server_process_1.runServer)({
+        name: "production server",
+        script: serverPath,
+        cwd: workspaceDir,
+        env: {
+            ...process.env,
+            PORT: String(port),
+            DMS_API_BASE_URL: backendUrl,
+            DMS_SESSION_SECRET: sessionSecret,
+            ...secrets.env,
+            DMS_COOKIE_SECURE: process.env.DMS_COOKIE_SECURE ?? "true",
+        },
+        onReady: (address) => {
+            (0, output_1.writeReadyBlock)({
+                title: `Production 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: "Ctrl+C to stop",
+            });
+            void (0, update_check_1.reportAvailableUpdate)({ isFollowed: true });
+        },
+    });
+    process.exitCode = code;
+}

package/dist/commands/start.js

@@ -1,54 +1,54 @@
 "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.cmdStart = cmdStart;
-const node_fs_1 = require("node:fs");
-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 START_EXAMPLES = [
+    {
+        description: "After ajs dms build -b https://dms.example.com",
+        command: "ajs dms start -b https://dms.example.com -p 3001",
+    },
+];
 function cmdStart() {
-    return new commander_1.Command("start")
-        .description("Start the production server from a built workspace")
-        .addOption(common_1.Options.backendUrl)
-        .addOption(common_1.Options.port)
-        .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)("start");
-        const workspaceDir = (0, common_1.getWorkspaceDir)(options.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)) {
-            console.log("");
-            (0, cli_ui_1.error)("Production build not found!");
-            console.log(chalk_1.default.dim("  Run 'ajs dms build -b " +
-                options.backendUrl +
-                "' first to create a production build"));
-            process.exit(1);
-        }
-        console.log("");
-        (0, cli_ui_1.info)(`Starting production server on port ${chalk_1.default.cyan(options.port)}...`);
-        console.log(chalk_1.default.dim(`  Workspace: ${workspaceDir}`));
-        const secrets = (0, common_1.resolveManifestSecrets)((0, common_1.collectManifestSecrets)((0, common_1.readCachedManifest)(workspaceDir)?.manifest.modules ?? []));
-        (0, common_1.reportManifestSecrets)(secrets, "build-time manifest");
-        console.log("");
-        const code = await (0, common_1.runCommand)("node", [serverPath], {
-            cwd: workspaceDir,
-            env: {
-                ...process.env,
-                PORT: options.port,
-                DMS_API_BASE_URL: options.backendUrl,
-                DMS_SESSION_SECRET: sessionSecret,
-                ...secrets.env,
-                DMS_COOKIE_SECURE: process.env.DMS_COOKIE_SECURE ?? "true",
-            },
-        });
-        process.exit(code);
-    });
+    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. Needs the DMS_SESSION_SECRET the build used.")
+        .addOption(config_1.Options.backendUrl("Backend URL the build was made for; required, as -b or the variable"))
+        .addOption(config_1.Options.port)
+        .action(async (options) => (await Promise.resolve().then(() => __importStar(require("./start-action")))).runStart(options));
+    return (0, cli_1.withExamples)(command, START_EXAMPLES);
 }

package/dist/commands/verify-source-action.d.ts

@@ -0,0 +1,10 @@
+import { type CliProblem, type Ui } from "@antelopejs/core/cli";
+export interface VerifySourceOptions {
+    layer?: string;
+    localPackage?: string[];
+    module?: string[];
+}
+export declare function parseLocalPackages(values: string[]): Record<string, string>;
+export declare function usageProblems(options: VerifySourceOptions): CliProblem[];
+export declare function assertValidUsage(problems: CliProblem[], ui?: Ui): void;
+export declare function runVerifySource(options: VerifySourceOptions): Promise<void>;

package/dist/commands/verify-source-action.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseLocalPackages = parseLocalPackages;
+exports.usageProblems = usageProblems;
+exports.assertValidUsage = assertValidUsage;
+exports.runVerifySource = runVerifySource;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const cli_1 = require("@antelopejs/core/cli");
+const common_1 = require("../common");
+const verify_source_result_1 = require("../verify-source-result");
+const COMMAND_PATH = "ajs dms verify-source";
+const LAYER_OPTION = "-l, --layer <path>";
+function localPackageSeparator(value) {
+    const separator = value.indexOf("=");
+    return separator <= 0 || separator === value.length - 1 ? -1 : separator;
+}
+function localPackageProblem(value) {
+    if (localPackageSeparator(value) >= 0)
+        return undefined;
+    return {
+        title: `Invalid local package '${value}'`,
+        fixes: ["Pass it as name=path: --local-package @scope/package=../package"],
+    };
+}
+function parseLocalPackages(values) {
+    return Object.fromEntries(values.map((value) => {
+        const problem = localPackageProblem(value);
+        if (problem)
+            throw new common_1.UsageError(problem);
+        const separator = localPackageSeparator(value);
+        return [value.slice(0, separator), (0, node_path_1.resolve)(value.slice(separator + 1))];
+    }));
+}
+function directoryProblem(path, label) {
+    if ((0, node_fs_1.statSync)(path, { throwIfNoEntry: false })?.isDirectory())
+        return undefined;
+    return { title: `${label} not found: ${path}`, fixes: [verify_source_result_1.LAYER_PATH_FIX] };
+}
+const MISSING_LAYER = {
+    title: `Required option '${LAYER_OPTION}' not specified`,
+    reason: `Usage: ${COMMAND_PATH} [options]`,
+    fixes: [`Run ${COMMAND_PATH} --help for usage`],
+};
+function usageProblems(options) {
+    const problems = [
+        options.layer === undefined
+            ? MISSING_LAYER
+            : directoryProblem(options.layer, "Layer path"),
+        ...(options.module ?? []).map((path) => directoryProblem(path, "Module path")),
+        ...(options.localPackage ?? []).map(localPackageProblem),
+    ];
+    return problems.filter((problem) => problem !== undefined);
+}
+function assertValidUsage(problems, ui = (0, cli_1.getProcessUi)()) {
+    if (problems.length === 0)
+        return;
+    const last = problems[problems.length - 1];
+    for (const problem of problems.slice(0, -1))
+        ui.problem(problem);
+    throw new common_1.UsageError(last);
+}
+const FORWARDED_FLAGS = ["--no-color", "--verbose"];
+const RESULT_TIMEOUT_MS = 2000;
+function channelClosed(child) {
+    return new Promise((settle) => {
+        child.once("disconnect", settle);
+        child.once("exit", () => setTimeout(settle, RESULT_TIMEOUT_MS).unref());
+    });
+}
+async function runVerifySource(options) {
+    const startedAt = Date.now();
+    assertValidUsage(usageProblems(options));
+    const layer = options.layer ?? "";
+    const modules = options.module ?? [];
+    const localPackages = parseLocalPackages(options.localPackage ?? []);
+    const runner = (0, node_path_1.join)(__dirname, "..", `verify-source-runner${(0, node_path_1.extname)(__filename)}`);
+    const flags = FORWARDED_FLAGS.filter((flag) => process.argv.includes(flag));
+    let result;
+    let closed = Promise.resolve();
+    const code = await (0, common_1.runCommand)(process.execPath, [...process.execArgv, runner, ...flags], {
+        shell: false,
+        stdio: ["inherit", "inherit", "inherit", "ipc"],
+        env: {
+            ...process.env,
+            DMS_LAYER_SOURCE: (0, node_path_1.resolve)(layer),
+            DMS_MODULE_SOURCES: JSON.stringify(modules.map((path) => (0, node_path_1.resolve)(path))),
+            DMS_LOCAL_PACKAGES: JSON.stringify(localPackages),
+        },
+    }, (child) => {
+        child.on("message", (message) => {
+            result = message;
+        });
+        closed = channelClosed(child);
+    });
+    await closed;
+    (0, verify_source_result_1.reportVerification)(result ?? {
+        ok: false,
+        problem: {
+            title: "Source verification failed",
+            reason: `The verification exited with code ${code} before reporting a result; its output is above.`,
+        },
+    }, Date.now() - startedAt);
+}

package/dist/commands/verify-source.d.ts

@@ -1,3 +1,2 @@
 import { Command } from "commander";
-export declare function parseLocalPackages(values: string[]): Record<string, string>;
 export declare function cmdVerifySource(): Command;

package/dist/commands/verify-source.js

@@ -1,39 +1,61 @@
 "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.parseLocalPackages = parseLocalPackages;
 exports.cmdVerifySource = cmdVerifySource;
-const node_path_1 = require("node:path");
 const commander_1 = require("commander");
-const common_1 = require("../common");
-function collectOption(value, values) {
+const cli_1 = require("@antelopejs/core/cli");
+function collectOption(value, values = []) {
     return [...values, value];
 }
-function parseLocalPackages(values) {
-    return Object.fromEntries(values.map((value) => {
-        const separator = value.indexOf("=");
-        if (separator <= 0 || separator === value.length - 1)
-            throw new Error(`Invalid local package "${value}"; expected name=path`);
-        return [value.slice(0, separator), (0, node_path_1.resolve)(value.slice(separator + 1))];
-    }));
-}
-async function verifySource(options) {
-    const runner = (0, node_path_1.join)((0, common_1.getPackageRoot)(), "dist", "verify-source-runner.js");
-    const code = await (0, common_1.runCommand)(process.execPath, [runner], {
-        env: {
-            ...process.env,
-            DMS_LAYER_SOURCE: (0, node_path_1.resolve)(options.layer),
-            DMS_MODULE_SOURCES: JSON.stringify(options.module.map((path) => (0, node_path_1.resolve)(path))),
-            DMS_LOCAL_PACKAGES: JSON.stringify(parseLocalPackages(options.localPackage)),
-        },
-    });
-    if (code !== 0)
-        throw new Error("Source verification failed");
-}
+const VERIFY_SOURCE_EXAMPLES = [
+    {
+        description: "A frontend package and a module that uses it",
+        command: "ajs dms verify-source -l ../dms/frontend-vue -m ./frontend-vue",
+    },
+    {
+        description: "With a local build of a package it depends on",
+        command: "ajs dms verify-source -l . --local-package @antelopejs/dms=../dms",
+    },
+];
 function cmdVerifySource() {
-    return new commander_1.Command("verify-source")
-        .description("Build and typecheck unpublished DMS frontend sources")
-        .requiredOption("-l, --layer <path>", "DMS frontend package root")
-        .option("-m, --module <path>", "Additional frontend package root (repeatable)", collectOption, [])
-        .option("--local-package <name=path>", "Bind a local package into the generated workspace (repeatable)", collectOption, [])
-        .action(verifySource);
+    const command = new commander_1.Command("verify-source")
+        .summary("Build and type-check unpublished frontend sources")
+        .description("Build and type-check unpublished DMS frontend sources against this loader version, in a temporary workspace removed when the run ends. Starts no backend.")
+        .option("-l, --layer <path>", "Root of the DMS frontend package to verify (required)")
+        .option("-m, --module <path>", "Root of another frontend package to verify with it (repeatable)", collectOption)
+        .option("--local-package <name=path>", "Bind a local package into the generated workspace (repeatable)", collectOption)
+        .action(async (options) => (await Promise.resolve().then(() => __importStar(require("./verify-source-action")))).runVerifySource(options));
+    return (0, cli_1.withExamples)(command, VERIFY_SOURCE_EXAMPLES);
 }

package/dist/commands/workspace-task.d.ts

@@ -0,0 +1,2 @@
+import { type SetupWorkspaceOptions, type SetupWorkspaceResult } from "../common";
+export declare function setUpWorkspace(options: Omit<SetupWorkspaceOptions, "beforeInstall">): Promise<SetupWorkspaceResult>;

package/dist/commands/workspace-task.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setUpWorkspace = setUpWorkspace;
+const cli_1 = require("@antelopejs/core/cli");
+const common_1 = require("../common");
+const output_1 = require("../output");
+async function setUpWorkspace(options) {
+    const task = (0, cli_1.getProcessTasks)().start("Setting up the workspace");
+    let isInstalling = false;
+    try {
+        const result = await (0, common_1.setupWorkspace)({
+            ...options,
+            beforeInstall: async () => {
+                task.succeed("Workspace generated");
+                isInstalling = true;
+            },
+        });
+        if (!isInstalling)
+            task.succeed("Workspace ready");
+        return result;
+    }
+    catch (error) {
+        (0, output_1.endInterruptedTask)(task, error, "Workspace setup stopped");
+        throw error;
+    }
+}

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

@@ -0,0 +1,25 @@
+import { type Ui } from "@antelopejs/core/cli";
+export interface WorkspacesOptions {
+    json?: boolean;
+}
+export interface WorkspaceRecord {
+    id: string;
+    dir: string;
+    backendUrl: string;
+    key: {
+        type: "url";
+    } | {
+        type: "project";
+        path: string;
+    };
+    sizeBytes: number;
+    lastUsedAt: string;
+}
+export declare function readWorkspaceRecords(): {
+    records: WorkspaceRecord[];
+    skipped: string[];
+};
+export declare function describeKey(record: WorkspaceRecord): string;
+export declare function renderWorkspaces(ui: Ui, records: WorkspaceRecord[], isTerminal: boolean): void;
+export declare function reportSkipped(ui: Ui, skipped: string[]): void;
+export declare function runWorkspaces(options: WorkspacesOptions): void;