@antelopejs/dms-frontend 0.3.9 → 0.3.10

package/README.md

@@ -72,7 +72,7 @@ pnpm add -g @antelopejs/core @antelopejs/dms-frontend
 ```
 
 The plugin prints through the output module of `@antelopejs/core`
-(`@antelopejs/core/cli`), so it needs `@antelopejs/core` 1.13.0 or later.
+(`@antelopejs/core/cli`), so it needs `@antelopejs/core` 1.13.1 or later.
 `npm install -g` works too; this repository and every generated workspace use
 pnpm. Inside a package script, `ajs` resolves from `node_modules/.bin`, and the
 `dms` command it delegates to resolves the project-local plugin, so a script
@@ -134,9 +134,14 @@ missing configuration value) and 130 when stopped with Ctrl+C. `--no-color` or
 `NO_COLOR=1` turns colors off, and terminals that cannot draw Unicode, such as
 `TERM=dumb`, get ASCII symbols. `--verbose` or `ANTELOPEJS_VERBOSE` streams
 the full `pnpm` and Vite output, each line behind the name of the step, and adds
-the stack trace of the underlying error to a failure. `ajs --no-color dms …`,
-`ajs --verbose dms …` and `ajs --verbose=<channels> dms …` set those variables
-for the plugin.
+the stack trace of the underlying error to a failure; `--verbose=<channels>`
+turns all of it on too, whatever the channels. `-q`, `--quiet` or
+`ANTELOPEJS_QUIET=1` prints only results, warnings and errors: no command
+header, progress, summary or update notice, and of the block a ready `dev` or
+`start` server prints, only its Local URL. `ajs --no-color dms …`,
+`ajs --verbose dms …`, `ajs --verbose=<channels> dms …` and `ajs -q dms …` set
+those variables for the plugin; the same flags are also accepted after the
+command, as in `ajs dms build -q`.
 
 The CLI checks npm for a newer release at most once a day and prints a one-line
 notice on stderr, only to a terminal: as the last line of a command that

package/dist/help.js

@@ -40,6 +40,7 @@ exports.ENVIRONMENT_VARIABLES = [
     ["DMS_CLIENT_BASE_URL", "Public frontend URL used in links and e-mails"],
     ["NO_COLOR", "Same as --no-color"],
     ["ANTELOPEJS_VERBOSE", "Same as --verbose"],
+    ["ANTELOPEJS_QUIET", "Same as -q, unless 0 or false"],
     ["NO_UPDATE_NOTIFIER, CI", "Either one turns the update check off"],
 ];
 const ENVIRONMENT_NOTES = [

package/dist/index.js

@@ -16,7 +16,12 @@ const help_1 = require("./help");
 const output_1 = require("./output");
 const update_check_1 = require("./update-check");
 const { version } = require("../package.json");
-const GLOBAL_FLAGS = ["--no-color", "--verbose"];
+const QUIET_FLAGS = ["-q", "--quiet"];
+const GLOBAL_FLAGS = ["--no-color", ...QUIET_FLAGS];
+const VERBOSE_FLAG = "--verbose";
+const VERBOSE_ASSIGNMENT = `${VERBOSE_FLAG}=`;
+const ALL_CHANNELS = "*";
+const END_OF_OPTIONS = "--";
 const ROOT_EXAMPLES = [
     {
         description: "Inside a project started with ajs project dev",
@@ -51,8 +56,32 @@ function describeHelpFooter(width) {
         ...(0, cli_1.wrapText)(pointer, width),
     ].join("\n");
 }
+function isGlobalFlag(arg) {
+    return GLOBAL_FLAGS.includes(arg) || arg.startsWith(VERBOSE_ASSIGNMENT);
+}
 function ownArguments(args) {
-    return args.filter((arg) => !GLOBAL_FLAGS.includes(arg));
+    return args.filter((arg) => !isGlobalFlag(arg));
+}
+function optionArguments(args) {
+    const end = args.indexOf(END_OF_OPTIONS);
+    return end === -1 ? args : args.slice(0, end);
+}
+function normalizeVerboseArguments(args) {
+    const optionCount = optionArguments(args).length;
+    return args.map((arg, index) => index < optionCount && arg === VERBOSE_FLAG
+        ? `${VERBOSE_ASSIGNMENT}${ALL_CHANNELS}`
+        : arg);
+}
+function exportOutputFlags(args) {
+    const options = optionArguments(args);
+    if (options.some((arg) => QUIET_FLAGS.includes(arg))) {
+        process.env.ANTELOPEJS_QUIET = "1";
+    }
+    const verbose = options.filter((arg) => arg.startsWith(VERBOSE_ASSIGNMENT));
+    if (verbose.length > 0) {
+        const channels = verbose[verbose.length - 1].slice(VERBOSE_ASSIGNMENT.length);
+        process.env.ANTELOPEJS_VERBOSE = channels || ALL_CHANNELS;
+    }
 }
 function isInvocation(args, rest) {
     const own = ownArguments(args);
@@ -79,7 +108,8 @@ const runCLI = async () => {
         .name("ajs dms")
         .version(version, "-v, --version", "Print the version")
         .option("--no-color", "Disable colors (also NO_COLOR=1)")
-        .option("--verbose", "Show full output and stack traces (also ANTELOPEJS_VERBOSE)")
+        .option(`${VERBOSE_FLAG} [=channels]`, "Show full output and stack traces (also ANTELOPEJS_VERBOSE); any channels turn all of it on")
+        .option("-q, --quiet", "Print only results, warnings and errors (also ANTELOPEJS_QUIET=1)")
         .option("--no-update-check", "Skip the daily update check (also NO_UPDATE_NOTIFIER=1)")
         .addHelpText("before", (context) => describeVersion(version, (0, cli_1.helpTextWidth)(context)))
         .addHelpText("after", (context) => describeHelpFooter((0, cli_1.helpTextWidth)(context)));
@@ -92,7 +122,8 @@ const runCLI = async () => {
     program.addCommand((0, verify_source_1.cmdVerifySource)());
     (0, help_1.applyDmsHelp)(program);
     (0, cli_1.formatUsageErrors)(program);
-    const args = (0, update_check_1.stripUpdateCheckFlag)(argv);
+    const args = normalizeVerboseArguments((0, update_check_1.stripUpdateCheckFlag)(argv));
+    exportOutputFlags(args);
     if (isInvocation(args, [])) {
         program.outputHelp();
         return;

package/dist/layers.d.ts

@@ -1,6 +1,12 @@
 import { ServedWithPath } from "./manifest";
 import { ManifestModule, ResolvedLayer } from "./workspace";
-export declare function assertLayerPathsServed(modules: ManifestModule[], backendUrl: string, bootstrapSecret?: string): asserts modules is ServedWithPath[];
+interface PathlessManifestSource {
+    bootstrapSecret?: string;
+    cache?: {
+        fetchedAt?: string;
+    };
+}
+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;
@@ -12,3 +18,4 @@ export declare function downloadAndExtractLayers(backendUrl: string, packUrl: st
 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 {};

package/dist/layers.js

@@ -51,11 +51,25 @@ const manifest_1 = require("./manifest");
 const fs_sync_1 = require("./fs-sync");
 const config_1 = require("./config");
 const output_1 = require("./output");
-function assertLayerPathsServed(modules, backendUrl, bootstrapSecret) {
+const BUILD_FIX = "A remote or production backend never sends them: use `ajs dms build` against it";
+function assertLayerPathsServed(modules, backendUrl, { bootstrapSecret, cache } = {}) {
     const pathless = modules.filter((mod) => !mod.path);
     if (pathless.length === 0)
         return;
     const count = `${pathless.length} of ${modules.length} module${modules.length === 1 ? "" : "s"}`;
+    if (cache) {
+        const fetched = cache.fetchedAt
+            ? ` (fetched ${(0, output_1.formatAge)(cache.fetchedAt)})`
+            : "";
+        throw new cli_1.CliError({
+            title: `The cached manifest of ${(0, manifest_1.displayUrl)(backendUrl)}${fetched} has no layer source paths (${count})`,
+            reason: "This run did not fetch it. The backend sends the paths only to callers presenting its development credential, and did not send them to the run that cached this manifest.",
+            fixes: [
+                "Run once without --offline, with the backend reachable, from the project started with `ajs project dev` or with DMS_BOOTSTRAP_SECRET set",
+                BUILD_FIX,
+            ],
+        });
+    }
     const { reason, fix } = bootstrapSecret
         ? {
             reason: "It sends them only to callers presenting its development credential, and did not accept the one this run sent.",
@@ -70,10 +84,7 @@ function assertLayerPathsServed(modules, backendUrl, bootstrapSecret) {
     throw new cli_1.CliError({
         title: `The backend at ${(0, manifest_1.displayUrl)(backendUrl)} did not send layer source paths (${count})`,
         reason,
-        fixes: [
-            fix,
-            "A remote or production backend never sends them: use `ajs dms build` against it",
-        ],
+        fixes: [fix, BUILD_FIX],
     });
 }
 function assertCachedArchivesExist(modules, cacheDir, fetchedAt) {

package/dist/output.d.ts

@@ -4,6 +4,7 @@ export declare function exitOnBrokenPipe(stream?: NodeJS.WriteStream): void;
 export declare function isTerminalFeedback(): boolean;
 export declare function isTerminalResult(): boolean;
 export declare function writeFeedback(line: string): void;
+export declare function writeInfo(line: string): void;
 export declare function writeHeader(command: string, context: string[], ui?: Ui): void;
 export declare function writeBlankLine(): void;
 export declare function showPath(target: string, home?: string): string;
@@ -19,13 +20,14 @@ export interface ReadyLine {
     label: string;
     value: string;
     isLink?: boolean;
+    isEssential?: boolean;
 }
 export interface ReadyBlock {
     title: string;
     lines: ReadyLine[];
     footer: string;
 }
-export declare function formatReadyBlock(block: ReadyBlock, ui?: Ui): string[];
+export declare function formatReadyBlock(block: ReadyBlock, ui?: Ui, isQuiet?: boolean): string[];
 export declare function writeReadyBlock(block: ReadyBlock, ui?: Ui): void;
 declare const TIMED_LEVEL_COLORS: {
     readonly success: "green";

package/dist/output.js

@@ -4,6 +4,7 @@ exports.exitOnBrokenPipe = exitOnBrokenPipe;
 exports.isTerminalFeedback = isTerminalFeedback;
 exports.isTerminalResult = isTerminalResult;
 exports.writeFeedback = writeFeedback;
+exports.writeInfo = writeInfo;
 exports.writeHeader = writeHeader;
 exports.writeBlankLine = writeBlankLine;
 exports.showPath = showPath;
@@ -58,12 +59,16 @@ function isTerminalResult() {
 function writeFeedback(line) {
     (0, cli_1.getProcessTasks)().write(process.stderr, `${line}\n`);
 }
+function writeInfo(line) {
+    if (!(0, cli_1.isQuietRun)())
+        writeFeedback(line);
+}
 function writeHeader(command, context, ui = (0, cli_1.getProcessUi)()) {
     const title = ui.palette().bold(`ajs dms ${command}`);
-    writeFeedback(`${title}  ${context.join(ui.symbols.separator)}`);
+    writeInfo(`${title}  ${context.join(ui.symbols.separator)}`);
 }
 function writeBlankLine() {
-    writeFeedback("");
+    writeInfo("");
 }
 function showPath(target, home = (0, node_os_1.homedir)()) {
     if ((0, node_path_1.resolve)(target) === process.cwd())
@@ -148,22 +153,33 @@ function endInterruptedTask(task, error, stopped) {
     task.skip(stopped);
 }
 function reportStopped(stop, ui = (0, cli_1.getProcessUi)()) {
+    const lineStart = lineStartAfter(stop.signal);
+    if ((0, cli_1.isQuietRun)()) {
+        if (lineStart)
+            writeFeedback("");
+        return;
+    }
     const symbol = isUnicode(ui)
         ? STOPPED_SYMBOLS.unicode
         : STOPPED_SYMBOLS.ascii;
     const text = [stop.stopped, ...stop.context].join(ui.symbols.separator);
-    writeFeedback(`${lineStartAfter(stop.signal)}${ui.palette().red(symbol)} ${text}`);
+    writeFeedback(`${lineStart}${ui.palette().red(symbol)} ${text}`);
 }
-function formatReadyBlock(block, ui = (0, cli_1.getProcessUi)()) {
+function formatReadyBlock(block, ui = (0, cli_1.getProcessUi)(), isQuiet = (0, cli_1.isQuietRun)()) {
     const palette = ui.palette();
     const arrow = isUnicode(ui) ? LINK_SYMBOLS.unicode : LINK_SYMBOLS.ascii;
-    const width = Math.max(...block.lines.map(({ label }) => label.length + LABEL_SUFFIX.length));
+    const shown = isQuiet
+        ? block.lines.filter(({ isEssential }) => isEssential)
+        : block.lines;
+    const width = Math.max(...shown.map(({ label }) => label.length + LABEL_SUFFIX.length));
     const lead = (isLink) => `${BLOCK_INDENT}${isLink ? palette.cyan(arrow) : " ".repeat(arrow.length)}${LINK_GAP}`;
-    const lines = block.lines.map(({ label, value, isLink }) => {
+    const lines = shown.map(({ label, value, isLink }) => {
         const shownLabel = `${label}${LABEL_SUFFIX}`.padEnd(width);
         const shownValue = isLink ? palette.cyan(value) : value;
         return `${lead(isLink)}${palette.dim(shownLabel)} ${shownValue}`;
     });
+    if (isQuiet)
+        return lines;
     return [
         `${palette.green(ui.symbols.levels.success)} ${block.title}`,
         "",
@@ -172,8 +188,9 @@ function formatReadyBlock(block, ui = (0, cli_1.getProcessUi)()) {
     ];
 }
 function writeReadyBlock(block, ui = (0, cli_1.getProcessUi)()) {
-    for (const line of [...formatReadyBlock(block, ui), ""])
+    for (const line of formatReadyBlock(block, ui))
         writeFeedback(line);
+    writeInfo("");
 }
 const TIMED_LEVEL_COLORS = {
     success: "green",

package/dist/server-process.js

@@ -165,7 +165,12 @@ function readyLines(address, settings, interfaces, isGuestInterface) {
     const network = networkUrls(address, interfaces, isGuestInterface);
     const hidden = network.length - MAX_NETWORK_URLS;
     return [
-        { label: "Local", value: localUrl(address), isLink: true },
+        {
+            label: "Local",
+            value: localUrl(address),
+            isLink: true,
+            isEssential: true,
+        },
         ...network.slice(0, MAX_NETWORK_URLS).map((value) => ({
             label: "Network",
             value,

package/dist/update-check.js

@@ -89,6 +89,8 @@ function stripUpdateCheckFlag(argv) {
 function isUpdateCheckEnabled(argv, env) {
     if (env.CI)
         return false;
+    if ((0, cli_1.isQuietRun)({ argv: [...argv], env }))
+        return false;
     if (env.NO_UPDATE_NOTIFIER)
         return false;
     if (env.TERM === DUMB_TERMINAL)

package/dist/workspace-setup.js

@@ -228,7 +228,10 @@ async function setupWorkspace(opts) {
     const { manifest, fromCache, fetchedAt } = resolved;
     let layers;
     if (mode === "dev") {
-        (0, layers_1.assertLayerPathsServed)(manifest.modules, backendUrl, bootstrapSecret);
+        (0, layers_1.assertLayerPathsServed)(manifest.modules, backendUrl, {
+            bootstrapSecret,
+            cache: fromCache ? { fetchedAt } : undefined,
+        });
         if (fromCache) {
             (0, manifest_1.assertCachedLayerPathsExist)(manifest.modules, fetchedAt);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/dms-frontend",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "description": "Frontend-agnostic loader for AntelopeJS DMS, shipping the Vue 3 renderer (Vite, Inertia, SSR)",
   "keywords": [
     "antelope",
@@ -73,7 +73,7 @@
     "unzipper": "^0.12.3"
   },
   "devDependencies": {
-    "@antelopejs/core": "^1.13.0",
+    "@antelopejs/core": "^1.13.1",
     "@antelopejs/tooling-configs": ">=0.0.7 <1.0.0",
     "@iconify/utils": "^3.1.0",
     "@iconify/vue": "^5.0.1",
@@ -101,7 +101,7 @@
     "vue-i18n": "^11.2.7"
   },
   "peerDependencies": {
-    "@antelopejs/core": ">=1.13.0 <2"
+    "@antelopejs/core": ">=1.13.1 <2"
   },
   "optionalDependencies": {
     "@oxc-parser/binding-darwin-arm64": "^0.95.0",