@scalebun/cli 1.10.2 → 1.12.0

package/lib/utils/validate.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nearest = nearest;
+exports.checkedEnum = checkedEnum;
+exports.checkedInt = checkedInt;
+exports.checkedPercent = checkedPercent;
+exports.checkedId = checkedId;
+exports.checkedVersionRange = checkedVersionRange;
+exports.checkedText = checkedText;
+const output_1 = require("./output");
+/**
+ * Checked parsers for everything the user can type.
+ *
+ * ── Why this exists ─────────────────────────────────────────────────────────
+ *
+ * Bad input was being handled three different ways, and two of them were
+ * silent:
+ *
+ *   1. Cast and hope.      `opts.platform as 'android' | 'ios'` — `--platform
+ *                          windows` sails through to the bundler.
+ *   2. Coerce to a default. `Math.max(1, Number(opts.limit) || 20)` — a typo'd
+ *                          `--limit abc` quietly means 20, and `--limit -5`
+ *                          quietly means 1.
+ *   3. Compare and shrug.  `if (opts.failOn === 'act')` — `--fail-on acts`
+ *                          matches nothing, so the CI gate the user asked for
+ *                          silently does not exist and the pipeline goes green.
+ *
+ * The third is the dangerous one and the pattern is general: an unrecognised
+ * value that falls through a comparison disables the behaviour it was meant to
+ * request, and disabled checks look exactly like passing checks. Every parser
+ * here refuses instead, names the flag, shows what was received, and — for
+ * enums — suggests the intended value when it is one edit away.
+ *
+ * All of them exit with ExitCode.Usage, because "you typed the command wrong"
+ * and "your project is not ready" (Gate/3) want opposite responses in CI.
+ */
+/**
+ * Edit distance, capped — only used to decide whether to offer a suggestion,
+ * so the exact number past 3 never matters.
+ */
+function distance(a, b) {
+    const m = a.length;
+    const n = b.length;
+    if (Math.abs(m - n) > 3)
+        return 99;
+    let prev = Array.from({ length: n + 1 }, (_, i) => i);
+    for (let i = 1; i <= m; i++) {
+        const curr = [i];
+        for (let j = 1; j <= n; j++) {
+            curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+        }
+        prev = curr;
+    }
+    return prev[n];
+}
+/** The allowed value closest to `raw`, when one is close enough to mean it. */
+function nearest(raw, allowed) {
+    let best = null;
+    let bestScore = 99;
+    const lower = raw.toLowerCase();
+    for (const option of allowed) {
+        const d = distance(lower, option.toLowerCase());
+        if (d < bestScore) {
+            bestScore = d;
+            best = option;
+        }
+    }
+    // Two edits on a short word is already a different word; scale the tolerance
+    // so `acts`→`act` is offered but `x`→`act` is not.
+    return best !== null && bestScore <= Math.max(1, Math.floor(best.length / 3)) ? best : null;
+}
+/**
+ * One of `allowed`, or exit.
+ *
+ * Replaces `if (opts.x === 'known')` chains, where an unrecognised value is
+ * indistinguishable from the flag not being passed at all.
+ */
+function checkedEnum(flag, raw, allowed, opts = {}) {
+    if (opts.caseInsensitive) {
+        const hit = allowed.find((a) => a.toLowerCase() === raw.toLowerCase());
+        if (hit)
+            return hit;
+    }
+    else if (allowed.includes(raw)) {
+        return raw;
+    }
+    const guess = nearest(raw, allowed);
+    (0, output_1.fail)(`${flag} must be one of ${allowed.join(', ')} — got "${raw}".`, [...(guess ? [`Did you mean ${flag} ${guess}?`] : []), ...(opts.details ?? [])], output_1.ExitCode.Usage);
+}
+/**
+ * A whole number in range, or exit.
+ *
+ * `Number('12abc')` is NaN and `Number('')` is 0 — both of which a `|| default`
+ * turns into a plausible-looking value the user never asked for. Everything
+ * that is not cleanly an integer is refused here instead.
+ */
+function checkedInt(flag, raw, opts = {}) {
+    if (raw === undefined || raw === null || raw === '') {
+        if (opts.fallback !== undefined)
+            return opts.fallback;
+        (0, output_1.fail)(`${flag} is required.`, opts.details ?? [], output_1.ExitCode.Usage);
+    }
+    const text = String(raw).trim();
+    const range = opts.min !== undefined && opts.max !== undefined
+        ? ` from ${opts.min} to ${opts.max}`
+        : opts.min !== undefined
+            ? ` of at least ${opts.min}`
+            : '';
+    // Deliberately strict: Number() accepts '0x10', '1e3', ' 12 ' and Infinity,
+    // none of which anyone means to type into a CLI flag.
+    if (!/^[+-]?\d+$/.test(text)) {
+        (0, output_1.fail)(`${flag} must be a whole number${range} — got "${text}".`, [
+            ...(/^[+-]?\d*\.\d+$/.test(text) ? ['Fractions are not accepted here.'] : []),
+            ...(opts.details ?? []),
+        ], output_1.ExitCode.Usage);
+    }
+    const n = Number(text);
+    if ((opts.min !== undefined && n < opts.min) || (opts.max !== undefined && n > opts.max)) {
+        (0, output_1.fail)(`${flag} must be a whole number${range} — got ${n}.`, opts.details ?? [], output_1.ExitCode.Usage);
+    }
+    return n;
+}
+/**
+ * A rollout percentage, 0-100.
+ *
+ * A trailing `%` is accepted because it is the obvious thing to type for a
+ * value the help text calls a percentage, and refusing it teaches nothing.
+ */
+function checkedPercent(flag, raw, fallback) {
+    const text = raw === undefined || raw === null ? '' : String(raw).trim().replace(/%$/, '');
+    return checkedInt(flag, text, {
+        min: 0,
+        max: 100,
+        fallback,
+        details: ['0 stages the release without serving it to anyone; 100 serves everyone.'],
+    });
+}
+/**
+ * An identifier, or exit.
+ *
+ * Catches the two ways ids arrive broken: an empty value from an unquoted
+ * shell variable that did not expand (`--app-id $APP` with APP unset becomes
+ * `--app-id` swallowing the NEXT flag), and a value with whitespace or a
+ * leading dash from a mis-quoted paste. Both otherwise reach the API and come
+ * back as a confusing 404.
+ */
+function checkedId(flag, raw) {
+    const text = String(raw ?? '').trim();
+    if (!text) {
+        (0, output_1.fail)(`${flag} was given an empty value.`, ['Check the variable it came from is set.'], output_1.ExitCode.Usage);
+    }
+    if (text.startsWith('-')) {
+        (0, output_1.fail)(`${flag} looks like it swallowed the next flag — got "${text}".`, ['An id never starts with "-". Check for a missing value earlier in the command.'], output_1.ExitCode.Usage);
+    }
+    if (/\s/.test(text)) {
+        (0, output_1.fail)(`${flag} must not contain spaces — got "${text}".`, ['Quote the value if it came from a variable.'], output_1.ExitCode.Usage);
+    }
+    return text;
+}
+/**
+ * A semver range the server will accept, or exit.
+ *
+ * Deliberately loose. Ranges legitimately look like `1.0.0`, `^1.0.0`,
+ * `>=1.0.0`, `1.x`, `>=1.0.0 <2.0.0` and `*`, and a strict grammar here would
+ * reject valid input the API would have taken. The check is only for the
+ * shapes that are certainly wrong — empty, or containing no version at all —
+ * because those come back as a 400 describing a field the user never typed.
+ */
+function checkedVersionRange(flag, raw) {
+    const text = String(raw ?? '').trim();
+    if (!text) {
+        (0, output_1.fail)(`${flag} was given an empty value.`, ['Use a range like ">=1.0.0", "^1.2.0" or "1.x".'], output_1.ExitCode.Usage);
+    }
+    if (text !== '*' && !/\d/.test(text)) {
+        (0, output_1.fail)(`${flag} does not look like a version range — got "${text}".`, ['Use a range like ">=1.0.0", "^1.2.0", "1.x", or "*" for any version.'], output_1.ExitCode.Usage);
+    }
+    return text;
+}
+/** Non-empty free text, or exit. Trims, so a whitespace-only value is empty. */
+function checkedText(flag, raw, opts = {}) {
+    const text = String(raw ?? '').trim();
+    if (!text)
+        (0, output_1.fail)(`${flag} was given an empty value.`, [], output_1.ExitCode.Usage);
+    if (opts.max && text.length > opts.max) {
+        (0, output_1.fail)(`${flag} must be ${opts.max} characters or fewer — got ${text.length}.`, [], output_1.ExitCode.Usage);
+    }
+    return text;
+}
+//# sourceMappingURL=validate.js.map

package/lib/utils/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/utils/validate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalebun/cli",
-  "version": "1.10.2",
+  "version": "1.12.0",
   "description": "Scalebun CLI — OTA bundle publishing and management",
   "license": "MIT",
   "bin": {
@@ -30,6 +30,7 @@
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf lib",
     "gen:mark": "node tools/gen-mark.mjs assets/scalebun-mark.svg 13 9",
-    "gen:sixel": "node tools/gen-sixel.mjs assets/scalebun-mark.svg"
+    "gen:sixel": "node tools/gen-sixel.mjs assets/scalebun-mark.svg",
+    "test": "node --test"
   }
 }