@scalebun/cli 1.10.1 → 1.11.0

package/lib/utils/resolve.js

@@ -0,0 +1,139 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNonInteractive = isNonInteractive;
+exports.resolveAppId = resolveAppId;
+exports.describeRelease = describeRelease;
+exports.resolveRelease = resolveRelease;
+const chalk_1 = __importDefault(require("chalk"));
+const client_1 = require("../api/client");
+const credentials_1 = require("./credentials");
+const apps_1 = require("./apps");
+const context_1 = require("./context");
+const prompt_1 = require("./prompt");
+const output_1 = require("./output");
+const validate_1 = require("./validate");
+/**
+ * True when this process must not prompt: no TTY, or the caller forbade it.
+ *
+ * `isJson()` is the authority on machine mode rather than a per-command
+ * `opts.json`. Commander does not hand root options down to subcommand
+ * handlers — and because the root declares `--json` too, it consumes the flag
+ * before a subcommand ever sees it. So the flag is read once from raw argv at
+ * startup (`applyGlobalFlags`) and every consumer asks `output.ts`. The
+ * per-command `--json` declarations remain, purely so `--help` documents them.
+ */
+function isNonInteractive(opts = {}) {
+    return (!!opts.nonInteractive ||
+        (0, output_1.isJson)() ||
+        !process.stdin.isTTY ||
+        !process.stdout.isTTY ||
+        process.argv.includes('--non-interactive') ||
+        process.env.CI === 'true');
+}
+/**
+ * Resolve the app id for a command.
+ *
+ * Never returns an empty string — it either returns an id or exits with a
+ * message naming the exact flag to pass.
+ */
+async function resolveAppId(opts = {}) {
+    const flag = opts.flag ?? '--app-id';
+    // An explicit flag is checked before it is used. The two ways an id arrives
+    // broken both end in a confusing 404 rather than a usage error: an unset
+    // shell variable (`--app-id $APP`) leaves the flag to swallow whatever comes
+    // next, and a mis-quoted paste brings whitespace with it. Only the explicit
+    // value is checked — a stored scalebun.json or SCALEBUN_APP_ID is the user's
+    // own earlier input and failing here would strand a linked project.
+    if (opts.appId !== undefined)
+        (0, validate_1.checkedId)(flag, opts.appId);
+    // Layers 1 + 2 — explicit, then ambient. getContext does both, in order.
+    const ctx = (0, context_1.getContext)({ appId: opts.appId });
+    if (ctx.appId)
+        return ctx.appId;
+    const creds = (0, credentials_1.readCredentials)();
+    if (!creds) {
+        (0, output_1.fail)('Not signed in.', ['Run `scalebun login`, or set SCALEBUN_TOKEN in CI.'], output_1.ExitCode.Usage);
+    }
+    // Layers 3 + 4 need the network, so they are also the layers CI must not reach.
+    if (isNonInteractive(opts)) {
+        (0, output_1.fail)(`${flag} is required.`, [
+            `Pass ${flag}, set SCALEBUN_APP_ID, or run \`scalebun link\` in this project.`,
+            'This shell is not interactive, so the app cannot be chosen here.',
+        ], output_1.ExitCode.Usage);
+    }
+    let entries;
+    try {
+        entries = await (0, apps_1.fetchAllApps)(new client_1.ApiClient(creds));
+    }
+    catch (err) {
+        (0, output_1.fail)(`Could not list apps: ${err?.message ?? err}`, [], output_1.ExitCode.Network);
+    }
+    if (!entries.length) {
+        (0, output_1.fail)('This account has no apps yet.', ['Create one in the dashboard (Organization → Project → App), then re-run.'], output_1.ExitCode.Usage);
+    }
+    // Layer 3 — one app is not a choice, so do not present it as one.
+    if (entries.length === 1) {
+        const only = entries[0];
+        console.log(chalk_1.default.dim(`Using your only app: ${only.app.name} (${only.app.id})`));
+        rememberIfLinked(only);
+        return only.app.id;
+    }
+    // Layer 4 — a real choice, so ask.
+    const chosen = await (0, prompt_1.select)('Which app?', entries.map((e) => ({
+        label: `${e.app.name}  ${chalk_1.default.dim(`${e.orgName} / ${e.projectName}`)}`,
+        value: e,
+    })));
+    (0, prompt_1.closePrompts)();
+    rememberIfLinked(chosen);
+    return chosen.app.id;
+}
+/**
+ * Cache the choice into an EXISTING scalebun.json.
+ *
+ * Deliberately does not create one: `scalebun link` is the command that decides
+ * a directory is a ScaleBun project, and a picker answering one command should
+ * not silently write a config file into a directory the user never linked.
+ */
+function rememberIfLinked(entry) {
+    const root = (0, context_1.findProjectRoot)();
+    if (!root)
+        return;
+    try {
+        (0, context_1.writeProjectConfig)(root, { appId: entry.app.id, appName: entry.app.name });
+    }
+    catch {
+        /* cache only */
+    }
+}
+function describeRelease(r) {
+    const v = r.bundle?.version != null ? `v${r.bundle.version}` : r.id;
+    const p = r.bundle?.platform ? ` (${r.bundle.platform})` : '';
+    return `${v}${p} — ${r.status} @ ${r.rolloutPercent ?? 0}%`;
+}
+async function resolveRelease(releases, opts) {
+    if (opts.releaseId) {
+        const hit = releases.find((r) => r.id === opts.releaseId);
+        if (!hit)
+            (0, output_1.fail)(`No release ${opts.releaseId} on this app.`, [], output_1.ExitCode.Usage);
+        return hit;
+    }
+    const candidates = releases.filter((r) => opts.statuses.includes(r.status));
+    if (candidates.length === 0) {
+        (0, output_1.fail)(`Nothing to ${opts.verb} — no release is ${opts.statuses.join(' or ')}.`, ['Run `scalebun ota releases` to see the current state.'], output_1.ExitCode.Usage);
+    }
+    if (candidates.length === 1)
+        return candidates[0];
+    // More than one qualifies. Refusing to guess is right — but the old code
+    // then exited and made the operator copy an id out of a list during an
+    // incident. On a TTY, offer the list as a choice instead.
+    if (isNonInteractive(opts)) {
+        (0, output_1.fail)(`${candidates.length} releases are ${opts.statuses.join(' or ')} — pass --release-id.`, candidates.map((r) => `  ${r.id}  ${describeRelease(r)}`), output_1.ExitCode.Usage);
+    }
+    const chosen = await (0, prompt_1.select)(`Which release do you want to ${opts.verb}?`, candidates.map((r) => ({ label: describeRelease(r), value: r })));
+    (0, prompt_1.closePrompts)();
+    return chosen;
+}
+//# sourceMappingURL=resolve.js.map

package/lib/utils/resolve.js.map

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

package/lib/utils/sdkBin.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Locating and running @scalebun/react-native's bin from this CLI.
+ *
+ * `init android` / `init ios` live in the SDK package (they need its native
+ * codemods), but both this CLI and the SDK declare the same `scalebun` bin
+ * name — so whichever binary the user ends up with must be able to reach the
+ * other's commands. The SDK bin already forwards `ota …` here; these helpers
+ * are the return path, shared by the unknown-command forwarder (index.ts) and
+ * quickstart's native-wiring step.
+ */
+/** Resolve @scalebun/react-native's bin script, or null when absent. */
+export declare function resolveSdkBin(): string | null;
+/**
+ * Run the SDK bin with the given argv, inheriting stdio.
+ * Returns the child's exit code (1 when the child died on a signal).
+ */
+export declare function runSdkBin(sdkBin: string, args: string[]): number;
+//# sourceMappingURL=sdkBin.d.ts.map

package/lib/utils/sdkBin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkBin.d.ts","sourceRoot":"","sources":["../../src/utils/sdkBin.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,wEAAwE;AACxE,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAc7C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAGhE"}

package/lib/utils/sdkBin.js

@@ -0,0 +1,76 @@
+"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.resolveSdkBin = resolveSdkBin;
+exports.runSdkBin = runSdkBin;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+/**
+ * Locating and running @scalebun/react-native's bin from this CLI.
+ *
+ * `init android` / `init ios` live in the SDK package (they need its native
+ * codemods), but both this CLI and the SDK declare the same `scalebun` bin
+ * name — so whichever binary the user ends up with must be able to reach the
+ * other's commands. The SDK bin already forwards `ota …` here; these helpers
+ * are the return path, shared by the unknown-command forwarder (index.ts) and
+ * quickstart's native-wiring step.
+ */
+/** Resolve @scalebun/react-native's bin script, or null when absent. */
+function resolveSdkBin() {
+    try {
+        // The SDK's `exports` map has no "./bin/*" entry, so resolving the bin
+        // subpath directly throws ERR_PACKAGE_PATH_NOT_EXPORTED. "./package.json"
+        // IS exported — resolve that and join. cwd first: the SDK is installed in
+        // the app being worked on, not necessarily next to this CLI.
+        const pkg = require.resolve('@scalebun/react-native/package.json', {
+            paths: [process.cwd(), __dirname],
+        });
+        const bin = path.join(path.dirname(pkg), 'bin', 'scalebun.js');
+        return fs.existsSync(bin) ? bin : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Run the SDK bin with the given argv, inheriting stdio.
+ * Returns the child's exit code (1 when the child died on a signal).
+ */
+function runSdkBin(sdkBin, args) {
+    const res = (0, child_process_1.spawnSync)(process.execPath, [sdkBin, ...args], { stdio: 'inherit' });
+    return res.status ?? 1;
+}
+//# sourceMappingURL=sdkBin.js.map

package/lib/utils/sdkBin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkBin.js","sourceRoot":"","sources":["../../src/utils/sdkBin.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,sCAcC;AAMD,8BAGC;AAvCD,uCAAyB;AACzB,2CAA6B;AAC7B,iDAA0C;AAE1C;;;;;;;;;GASG;AAEH,wEAAwE;AACxE,SAAgB,aAAa;IAC3B,IAAI,CAAC;QACH,uEAAuE;QACvE,0EAA0E;QAC1E,0EAA0E;QAC1E,6DAA6D;QAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,qCAAqC,EAAE;YACjE,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC;SAClC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;QAC/D,OAAO,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,MAAc,EAAE,IAAc;IACtD,MAAM,GAAG,GAAG,IAAA,yBAAS,EAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACjF,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/lib/utils/ui.d.ts

@@ -1,3 +1,12 @@
+/**
+ * The status box as a string.
+ *
+ * The interactive session redraws the whole screen on every keypress, and it
+ * does that with ONE write — a sequence of console.log calls would tear
+ * visibly as the terminal painted each line. Returning text lets the session
+ * compose a frame; `renderStatus` below keeps the print-and-exit path
+ * unchanged, so the two can never drift.
+ */
+export declare function statusText(): string;
 export declare function renderStatus(): void;
-export declare function renderCommands(): void;
 //# sourceMappingURL=ui.d.ts.map

package/lib/utils/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":"AAYA,wBAAgB,YAAY,IAAI,IAAI,CA4BnC;AAED,wBAAgB,cAAc,IAAI,IAAI,CA0DrC"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AACH,wBAAgB,UAAU,IAAI,MAAM,CA8BnC;AAED,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/lib/utils/ui.js

@@ -3,8 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusText = statusText;
 exports.renderStatus = renderStatus;
-exports.renderCommands = renderCommands;
 const chalk_1 = __importDefault(require("chalk"));
 const credentials_1 = require("./credentials");
 // NOTE: the splash art (mark + wordmark) now lives in ../ui/banner.ts. This file
@@ -14,14 +14,24 @@ const credentials_1 = require("./credentials");
 // or the right border lands on a different column on every row.
 const STRIP_ANSI = /\x1b\[[0-9;]*m/g;
 const visibleLen = (s) => s.replace(STRIP_ANSI, '').length;
-function renderStatus() {
+/**
+ * The status box as a string.
+ *
+ * The interactive session redraws the whole screen on every keypress, and it
+ * does that with ONE write — a sequence of console.log calls would tear
+ * visibly as the terminal painted each line. Returning text lets the session
+ * compose a frame; `renderStatus` below keeps the print-and-exit path
+ * unchanged, so the two can never drift.
+ */
+function statusText() {
+    const out = [];
     const creds = (0, credentials_1.readCredentials)();
     const verbose = process.argv.slice(2).includes('--verbose');
     const inner = 58;
-    const border = (l, r) => console.log(chalk_1.default.gray(l + '─'.repeat(inner + 2) + r));
+    const border = (l, r) => out.push(chalk_1.default.gray(l + '─'.repeat(inner + 2) + r));
     const row = (content) => {
         const pad = ' '.repeat(Math.max(0, inner - visibleLen(content)));
-        console.log(`${chalk_1.default.gray('│')} ${content}${pad} ${chalk_1.default.gray('│')}`);
+        out.push(`${chalk_1.default.gray('│')} ${content}${pad} ${chalk_1.default.gray('│')}`);
     };
     border('┌', '┐');
     if (creds) {
@@ -41,59 +51,10 @@ function renderStatus() {
         row(`${chalk_1.default.bold.yellow('○ NOT LOGGED IN')} ${chalk_1.default.dim('· run')} ${chalk_1.default.cyan('scalebun login')}`);
     }
     border('└', '┘');
-    console.log('');
+    out.push('');
+    return out.join('\n') + '\n';
 }
-function renderCommands() {
-    // 7-space indent aligns these command names under the numbered steps'
-    // commands above ('    1. ' is 7 chars wide, so `scalebun login` sits at col 7).
-    const cmd = (name, desc) => console.log(`       ${chalk_1.default.cyan(name.padEnd(34))} ${chalk_1.default.dim(desc)}`);
-    // ── Get started: publish your first OTA update ──────────────────────────────
-    console.log(chalk_1.default.bold.white(' PUBLISH YOUR FIRST OTA UPDATE'));
-    console.log(`  ${chalk_1.default.green('scalebun quickstart')}   ${chalk_1.default.dim('one guided flow: login → app → keys → health check → first release')}`);
-    console.log(chalk_1.default.dim('  …or do it step by step:'));
-    console.log(`    ${chalk_1.default.dim('1.')} ${chalk_1.default.cyan('scalebun login')}                                  ${chalk_1.default.dim('authenticate (paste an access token)')}`);
-    console.log(`    ${chalk_1.default.dim('2.')} ${chalk_1.default.cyan('scalebun apps')}                                   ${chalk_1.default.dim('find your --app-id')}`);
-    console.log(`    ${chalk_1.default.dim('3.')} ${chalk_1.default.cyan('scalebun init android')} ${chalk_1.default.dim('/')} ${chalk_1.default.cyan('init ios')}                ${chalk_1.default.dim('wire the native app for OTA, then rebuild')}`);
-    console.log(`    ${chalk_1.default.dim('4.')} ${chalk_1.default.cyan('scalebun ota generate-key-pair --app-id <id>')}   ${chalk_1.default.dim('(optional) code-signing key')}`);
-    console.log(`    ${chalk_1.default.dim('5.')} ${chalk_1.default.cyan('scalebun ota publish --app-id <id> --hermes')}    ${chalk_1.default.dim('bundle, upload & ship it')}`);
-    console.log('');
-    // ── Project setup (from @scalebun/react-native) ─────────────────────────────
-    console.log(chalk_1.default.bold.white(' PROJECT SETUP'));
-    cmd('scalebun doctor', 'check the project is correctly set up for OTA updates');
-    cmd('scalebun init ios', 'wire the iOS AppDelegate for OTA + Direct APNs (--check / --dry-run)');
-    cmd('scalebun init android', 'wire the Android MainApplication for OTA (--check / --dry-run)');
-    console.log('');
-    // ── OTA (every subcommand, so it is discoverable) ───────────────────────────
-    console.log(chalk_1.default.bold.white(' OTA UPDATES'));
-    cmd('scalebun ota publish', 'bundle, upload & publish a release (--app-id, --platform, --hermes)');
-    cmd('scalebun ota bundle', 'build a standalone bundle file for manual dashboard upload');
-    cmd('scalebun ota channels', 'list OTA channels (default, staging, production)');
-    cmd('scalebun ota releases', 'list releases and their current rollout state');
-    cmd('scalebun ota rollout', 'set rollout %  (also: ota pause / resume / rollback)');
-    cmd('scalebun ota generate-key-pair', 'create an ed25519 signing key and register the public half');
-    cmd('scalebun ota register-key', 'register an existing public key with an app');
-    cmd('scalebun ota keys', 'list signing keys registered for an app');
-    cmd('scalebun ota delete-bundle', 'delete an OTA bundle permanently');
-    console.log('');
-    // ── Account & tooling ───────────────────────────────────────────────────────
-    console.log(chalk_1.default.bold.white(' ACCOUNT & TOOLING'));
-    cmd('scalebun login / logout', 'authenticate (paste a token) / clear stored credentials');
-    cmd('scalebun apps', 'list your apps + IDs (--keys for client keys)');
-    cmd('scalebun quickstart', 'guided first-release walkthrough');
-    cmd('scalebun migrate codepush', 'migrate a project from Microsoft CodePush to Scalebun OTA');
-    cmd('scalebun ci init', 'generate a CI/CD pipeline for OTA publishing');
-    cmd('scalebun launch', 'open the CLI in a standalone terminal window');
-    console.log('');
-    console.log(chalk_1.default.dim(`  Run 'scalebun <command> --help' for every flag (e.g. scalebun ota publish --help).`));
-    console.log('');
-    // ── Examples ────────────────────────────────────────────────────────────────
-    console.log(chalk_1.default.bold.white(' EXAMPLES'));
-    console.log(chalk_1.default.gray('  # Silent update — applies on next launch (the default):'));
-    console.log(`  ${chalk_1.default.dim('$')} ${chalk_1.default.green('scalebun ota publish')} --app-id <id> --platform android --hermes --release-note "UI refresh"\n`);
-    console.log(chalk_1.default.gray('  # Immediate hotfix — reloads the app right away:'));
-    console.log(`  ${chalk_1.default.dim('$')} ${chalk_1.default.green('scalebun ota publish')} --app-id <id> --platform android --hermes --install-mode IMMEDIATE --release-note "Critical fix"\n`);
-    console.log(chalk_1.default.gray('  # Cautious staged rollout — start at 10%, then ramp:'));
-    console.log(`  ${chalk_1.default.dim('$')} ${chalk_1.default.green('scalebun ota publish')} --app-id <id> --platform android --hermes --rollout 10`);
-    console.log(`  ${chalk_1.default.dim('$')} ${chalk_1.default.green('scalebun ota rollout')} --app-id <id> --percent 100\n`);
+function renderStatus() {
+    process.stdout.write(statusText());
 }
 //# sourceMappingURL=ui.js.map

package/lib/utils/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":";;;;;AAqBA,gCA8BC;AAED,oCAEC;AAvDD,kDAA0B;AAC1B,+CAAiE;AAEjE,iFAAiF;AACjF,gFAAgF;AAEhF,6EAA6E;AAC7E,kFAAkF;AAClF,gEAAgE;AAChE,MAAM,UAAU,GAAG,iBAAiB,CAAC;AACrC,MAAM,UAAU,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC;AAE3E;;;;;;;;GAQG;AACH,SAAgB,UAAU;IACxB,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,IAAA,6BAAe,GAAE,CAAC;IAChC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,EAAE,CAAC;IAEjB,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,eAAK,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7F,MAAM,GAAG,GAAG,CAAC,OAAe,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjE,GAAG,CAAC,IAAI,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,GAAG,GAAG,IAAI,eAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC;IAEF,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjB,IAAI,KAAK,EAAE,CAAC;QACV,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACzC,4EAA4E;QAC5E,mCAAmC;QACnC,IAAI,KAAK,CAAC,KAAK;YAAE,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,yEAAyE;QACzE,2EAA2E;QAC3E,yEAAyE;QACzE,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,6BAAe,EAAE,CAAC;YAChD,GAAG,CAAC,GAAG,eAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,eAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,eAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC/B,CAAC;AAED,SAAgB,YAAY;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/lib/utils/validate.d.ts

@@ -0,0 +1,62 @@
+/** The allowed value closest to `raw`, when one is close enough to mean it. */
+export declare function nearest(raw: string, allowed: readonly string[]): string | null;
+export interface EnumOpts {
+    /** Accept any letter case, normalising to the allowed spelling. */
+    caseInsensitive?: boolean;
+    /** Extra guidance printed under the error. */
+    details?: string[];
+}
+/**
+ * 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.
+ */
+export declare function checkedEnum<T extends string>(flag: string, raw: string, allowed: readonly T[], opts?: EnumOpts): T;
+export interface IntOpts {
+    min?: number;
+    max?: number;
+    /** Used when the flag was omitted entirely. Never used to paper over junk. */
+    fallback?: number;
+    details?: string[];
+}
+/**
+ * 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.
+ */
+export declare function checkedInt(flag: string, raw: unknown, opts?: IntOpts): number;
+/**
+ * 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.
+ */
+export declare function checkedPercent(flag: string, raw: unknown, fallback?: number): number;
+/**
+ * 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.
+ */
+export declare function checkedId(flag: string, raw: unknown): string;
+/**
+ * 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.
+ */
+export declare function checkedVersionRange(flag: string, raw: unknown): string;
+/** Non-empty free text, or exit. Trims, so a whitespace-only value is empty. */
+export declare function checkedText(flag: string, raw: unknown, opts?: {
+    max?: number;
+}): string;
+//# sourceMappingURL=validate.d.ts.map

package/lib/utils/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/utils/validate.ts"],"names":[],"mappings":"AAoDA,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAc9E;AAED,MAAM,WAAW,QAAQ;IACvB,mEAAmE;IACnE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAC1C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,IAAI,GAAE,QAAa,GAClB,CAAC,CAcH;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,OAAY,GAAG,MAAM,CAgCjF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAQpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAgB5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAiBtE;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAO3F"}