@certen.io/cli 0.4.0 → 0.7.0

package/dist/chains.js

@@ -0,0 +1,242 @@
+/**
+ * Chain vocabulary.
+ *
+ * Every command that takes a chain validates it HERE, before the network call. A typo used to
+ * travel all the way to the gateway and come back as a rejection with no visible connection to
+ * the flag that caused it — and in `fund`'s case it came back only after a real payment intent
+ * had already been opened against the wrong chain.
+ *
+ * The suggestion matters as much as the rejection. `--chain base` is not a typo of nothing: `base`
+ * is a real mainnet, and silently mapping it to `base-sepolia` would be the CLI guessing about
+ * where money goes. So aliases SUGGEST and never substitute.
+ *
+ * This list is a constant today. Phase 2 replaces it with a cached read of `GET /v1/chains` and
+ * keeps this as the offline fallback — which is why the export is a function, not the array.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { UsageError } from './errors.js';
+/** The chains this product targets. Deliberately testnet-only. */
+export const SUPPORTED_CHAINS = [
+    'ethereum-sepolia',
+    'base-sepolia',
+    'arbitrum-sepolia',
+];
+/**
+ * Escape hatch for a chain the gateway serves but this build does not list.
+ *
+ * The gateway is deployed on more chains than these three. Someone deliberately working outside
+ * the supported set should not have to patch the CLI to do it — but they should have to say so,
+ * so it can never happen by typo.
+ */
+const OVERRIDE_ENV_VAR = 'CERTEN_ALLOW_ANY_CHAIN';
+/** Near-misses worth naming explicitly. A mainnet name is the dangerous case, not the harmless one. */
+const ALIASES = {
+    eth: 'ethereum-sepolia',
+    ethereum: 'ethereum-sepolia',
+    sepolia: 'ethereum-sepolia',
+    'eth-sepolia': 'ethereum-sepolia',
+    mainnet: 'ethereum-sepolia',
+    base: 'base-sepolia',
+    basesepolia: 'base-sepolia',
+    arb: 'arbitrum-sepolia',
+    arbitrum: 'arbitrum-sepolia',
+    'arb-sepolia': 'arbitrum-sepolia',
+    arbsepolia: 'arbitrum-sepolia',
+};
+export function supportedChains() {
+    return SUPPORTED_CHAINS;
+}
+/**
+ * Numeric EVM chain id → registry slug, for the chains this CLI targets.
+ *
+ * **This is not a convenience.** `GET /v1/portfolio` used to return `chain_id` as a slug for some
+ * chain accounts and as a numeric EVM id for others — both spellings in the same response, on the
+ * same organization. Anything comparing `chain_id` to a slug therefore silently missed every
+ * numeric entry, which is exactly how the unfunded-account guard came to skip the chain it was
+ * written to protect.
+ *
+ * The gateway now canonicalizes on write and has backfilled the old rows, so a current gateway
+ * sends slugs only. Kept regardless: the CLI ships on its own cadence and is frequently newer than
+ * the gateway it talks to, and the failure this prevents is silent.
+ *
+ * The cache below extends this at runtime; the constant is what makes it work offline and on a
+ * first run.
+ */
+const NUMERIC_TO_SLUG = {
+    11155111: 'ethereum-sepolia',
+    84532: 'base-sepolia',
+    421614: 'arbitrum-sepolia',
+};
+/**
+ * Registry slug → numeric EVM chain id.
+ *
+ * `execute.contractCall` passes `chainId` straight through to the intent leg. Leaving it undefined
+ * makes the caller supply a number they already told us by naming the chain, so it is derived —
+ * from the cached registry when there is one, and from this table otherwise.
+ */
+export function chainIdFor(chain) {
+    const slug = normalizeChain(chain);
+    for (const [numeric, mapped] of Object.entries(NUMERIC_TO_SLUG)) {
+        if (mapped === slug)
+            return Number(numeric);
+    }
+    const cached = readChainCache()?.numeric;
+    if (cached) {
+        for (const [numeric, mapped] of Object.entries(cached)) {
+            if (mapped === slug)
+                return Number(numeric);
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve whatever the gateway called a chain into one canonical name.
+ *
+ * Anything unrecognised is returned unchanged: a value we cannot map is still the best label we
+ * have for it, and inventing one would be worse than showing what arrived.
+ */
+export function normalizeChain(value) {
+    if (value === null || value === undefined)
+        return '';
+    const raw = String(value).trim();
+    if (isSupportedChain(raw))
+        return raw;
+    if (NUMERIC_TO_SLUG[raw])
+        return NUMERIC_TO_SLUG[raw];
+    const fromCache = readChainCache()?.numeric?.[raw];
+    return fromCache ?? raw;
+}
+// ── the registry cache ──────────────────────────────────────────────────────────────────────────
+/**
+ * `GET /v1/chains` is public and its answer is static for hours at a time, so it is cached rather
+ * than fetched on every validation. The cache does NOT widen the supported set — that is a product
+ * decision, not a gateway fact — it exists so a refusal can tell the truth about WHY a real chain
+ * is being refused: "the gateway serves optimism-sepolia, but this CLI targets these three" reads
+ * very differently from "optimism-sepolia is not a chain", and only one of them is accurate.
+ */
+const CACHE_FILE = join(homedir(), '.certen', 'chains.json');
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+export function readChainCache() {
+    try {
+        if (!existsSync(CACHE_FILE))
+            return null;
+        const parsed = JSON.parse(readFileSync(CACHE_FILE, 'utf-8'));
+        if (!Array.isArray(parsed.ids))
+            return null;
+        return parsed;
+    }
+    catch {
+        // A corrupt cache is not an error worth surfacing — it just means we fall back to the
+        // constant, which is what would have happened had the file never existed.
+        return null;
+    }
+}
+export function chainCacheIsFresh(cache) {
+    if (!cache)
+        return false;
+    const age = Date.now() - new Date(cache.fetched_at).getTime();
+    return Number.isFinite(age) && age >= 0 && age < CACHE_TTL_MS;
+}
+export function writeChainCache(entries) {
+    try {
+        const numeric = {};
+        for (const entry of entries) {
+            if (entry.chainId !== null && entry.chainId !== undefined)
+                numeric[String(entry.chainId)] = entry.id;
+        }
+        mkdirSync(join(homedir(), '.certen'), { recursive: true });
+        writeFileSync(CACHE_FILE, JSON.stringify({
+            fetched_at: new Date().toISOString(),
+            ids: entries.map((e) => e.id),
+            numeric,
+        }, null, 2));
+    }
+    catch {
+        // Best effort. Failing to cache must never fail the command that triggered it.
+    }
+}
+export const CHAIN_CACHE_FILE = CACHE_FILE;
+/** Does the gateway serve this chain, as far as the cache knows? Absent cache means "no idea". */
+function gatewayKnows(chain) {
+    const cache = readChainCache();
+    return cache ? cache.ids.includes(chain) : false;
+}
+export function isSupportedChain(value) {
+    return SUPPORTED_CHAINS.includes(value);
+}
+function levenshtein(a, b) {
+    // Single-row DP: the strings here are chain names, so allocation matters less than clarity,
+    // but there is no reason to hold a full matrix for it either.
+    let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i += 1) {
+        const row = [i];
+        for (let j = 1; j <= b.length; j += 1) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            row[j] = Math.min(row[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+        }
+        prev = row;
+    }
+    return prev[b.length];
+}
+/** The closest supported chain to `value`, or undefined if nothing is close enough to suggest. */
+export function nearestChain(value) {
+    const needle = value.trim().toLowerCase();
+    if (ALIASES[needle])
+        return ALIASES[needle];
+    let best;
+    let bestDistance = Infinity;
+    for (const chain of SUPPORTED_CHAINS) {
+        const d = levenshtein(needle, chain);
+        if (d < bestDistance) {
+            bestDistance = d;
+            best = chain;
+        }
+    }
+    // 3 is wide enough to catch "base-sepolai" and narrow enough not to propose a chain for "solana".
+    return bestDistance <= 3 ? best : undefined;
+}
+/**
+ * Validate one chain name, throwing a UsageError that names the alternatives.
+ *
+ * `flag` is the option the value arrived on, so the message points at what the caller typed rather
+ * than at an abstract notion of "chain".
+ */
+export function assertChain(value, flag = '--chain') {
+    const chain = value.trim();
+    if (isSupportedChain(chain))
+        return chain;
+    if (process.env[OVERRIDE_ENV_VAR] === '1')
+        return chain;
+    // A chain the gateway really serves gets a different sentence from one that does not exist.
+    // Telling someone `optimism-sepolia` "is not a chain" would be false, and would send them
+    // looking for a typo they did not make.
+    if (gatewayKnows(chain)) {
+        throw new UsageError(`The gateway serves "${chain}", but this CLI targets ${SUPPORTED_CHAINS.join(', ')}. `
+            + `Set ${OVERRIDE_ENV_VAR}=1 to use it anyway.`, 'UNSUPPORTED_CHAIN');
+    }
+    const suggestion = nearestChain(chain);
+    const lines = [
+        `"${chain}" is not a supported chain.`,
+        suggestion ? ` Did you mean ${suggestion}?` : '',
+        ` Supported: ${SUPPORTED_CHAINS.join(', ')}.`,
+        ` (Set ${OVERRIDE_ENV_VAR}=1 to use a chain outside this set.)`,
+    ];
+    throw new UsageError(lines.join(''), 'UNSUPPORTED_CHAIN');
+}
+/**
+ * Validate a comma-separated list, as `--chains` takes.
+ *
+ * Empty entries are dropped rather than rejected — a trailing comma is a slip, not an instruction,
+ * and failing on it would be pedantry. An empty list after that is an error, because the caller
+ * clearly meant to name at least one.
+ */
+export function assertChains(value, flag = '--chains') {
+    const parts = value.split(',').map((c) => c.trim()).filter((c) => c.length > 0);
+    if (parts.length === 0) {
+        throw new UsageError(`${flag} was given no chains. Supported: ${SUPPORTED_CHAINS.join(', ')}.`, 'UNSUPPORTED_CHAIN');
+    }
+    return parts.map((c) => assertChain(c, flag));
+}
+//# sourceMappingURL=chains.js.map

package/dist/chains.js.map

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

package/dist/commands/admin.js

@@ -1,6 +1,7 @@
 import { CertenClient } from '@certen.io/sdk';
-import { getApiKey, getApiUrl } from '../config.js';
-import { printOutput } from '../output.js';
+import { getApiKey, getApiUrl, getOutputFormat } from '../config.js';
+import { CliError, EXIT } from '../errors.js';
+import { printOutput, human, hint, isJsonMode } from '../output.js';
 async function getClient() {
     return new CertenClient({ apiKey: await getApiKey(), baseUrl: getApiUrl() });
 }
@@ -16,20 +17,64 @@ export function registerAdminCommands(program) {
         const result = await client.admin.listApiKeys();
         printOutput(result);
     });
+    program
+        .command('scopes')
+        .description('Every permission a key can be granted, and what each covers')
+        .option('--all', 'Include operator scopes, which customer keys should not use')
+        .action(async (opts) => {
+        // `--permissions` below takes a comma-separated list of a vocabulary published nowhere, so
+        // the choice was made by guessing. Guessing wrong is asymmetric: under-grant and you get
+        // 403s, which are visible; over-grant - and the obvious answer to uncertainty is `*` - and a
+        // key that only needed to read a balance can retire identities and publish price books.
+        const client = await getClient();
+        const { scopes } = await client.admin.scopes();
+        const shown = opts.all ? scopes : scopes.filter((s) => s.audience === 'customer');
+        if (isJsonMode() || getOutputFormat() === 'json') {
+            printOutput({ scopes: shown });
+            return;
+        }
+        const w = Math.max(...shown.map((s) => s.name.length), 4);
+        human('');
+        for (const s of shown) {
+            human(`  ${s.name.padEnd(w)}  ${s.description}`);
+            if (s.operations.length > 0) {
+                human(`  ${' '.repeat(w)}  ${s.operations.length} operation(s)`);
+            }
+        }
+        human('');
+        if (!opts.all) {
+            human('  Operator scopes are hidden. See them all: certen scopes --all');
+        }
+        hint('certen admin api-keys create --name <n> --org-id <id> --permissions billing:read,proof:read');
+    });
     apiKeys
         .command('create')
         .description('Create a new API key')
         .requiredOption('--name <name>', 'Key name')
         .requiredOption('--org-id <id>', 'Organization ID')
-        .option('--permissions <perms>', 'Comma-separated permissions')
+        .option('--permissions <perms>', 'Comma-separated scopes. List them: certen scopes')
         .option('--rate-limit <rpm>', 'Rate limit RPM', parseInt)
         .option('--expires-at <date>', 'Expiration date (ISO)')
         .action(async (opts) => {
         const client = await getClient();
+        // Checked against the live catalogue BEFORE the key is minted. A typo used to produce a key
+        // that authenticates fine and then 403s on the one call it exists to make - discovered in
+        // production, and fixable only by issuing a new key, since permissions are set at creation.
+        const requested = opts.permissions
+            ? opts.permissions.split(',').map((p) => p.trim()).filter(Boolean)
+            : undefined;
+        if (requested?.length) {
+            const { scopes } = await client.admin.scopes();
+            const known = new Set(scopes.map((s) => s.name));
+            const unknown = requested.filter((p) => !known.has(p));
+            if (unknown.length > 0) {
+                throw new CliError(`Not a permission: ${unknown.join(', ')}. See them all: certen scopes`, 'UNKNOWN_SCOPE', EXIT.USAGE);
+            }
+        }
         const result = await client.admin.createApiKey({
             name: opts.name,
             orgId: opts.orgId,
-            permissions: opts.permissions ? opts.permissions.split(',') : undefined,
+            permissions: requested,
             rateLimitRpm: opts.rateLimit,
             expiresAt: opts.expiresAt,
         });

package/dist/commands/admin.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../src/commands/admin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,KAAK,UAAU,SAAS;IACtB,OAAO,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,SAAS,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAErE,sBAAsB;IACtB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAE5E,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,eAAe,CAAC;SAC5B,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAChD,WAAW,CAAC,MAA4C,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,sBAAsB,CAAC;SACnC,cAAc,CAAC,eAAe,EAAE,UAAU,CAAC;SAC3C,cAAc,CAAC,eAAe,EAAE,iBAAiB,CAAC;SAClD,MAAM,CAAC,uBAAuB,EAAE,6BAA6B,CAAC;SAC9D,MAAM,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,QAAQ,CAAC;SACxD,MAAM,CAAC,qBAAqB,EAAE,uBAAuB,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC;YAC7C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;YACvE,YAAY,EAAE,IAAI,CAAC,SAAS;YAC5B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QACH,WAAW,CAAC,MAA4C,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,2DAA2D,CAAC;SACxE,cAAc,CAAC,aAAa,EAAE,6BAA6B,CAAC;SAC5D,MAAM,CAAC,KAAK,EAAE,IAAoB,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxD,WAAW,CAAC,MAA4C,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,4BAA4B,CAAC;SACzC,cAAc,CAAC,aAAa,EAAE,6BAA6B,CAAC;SAC5D,MAAM,CAAC,KAAK,EAAE,IAAoB,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxD,WAAW,CAAC,MAA4C,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEL,YAAY;IACZ,KAAK;SACF,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,gBAAgB,CAAC;SAC7B,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;SAC/C,MAAM,CAAC,wBAAwB,EAAE,yBAAyB,CAAC;SAC3D,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC;SAC1C,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC;SACtC,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,QAAQ,CAAC;SAC9C,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC;YAC5C,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,WAAW,CAAC,MAA4C,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEL,QAAQ;IACR,KAAK;SACF,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,oBAAoB,CAAC;SACjC,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC;SAC1C,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;YACzC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC,CAAC;QACH,WAAW,CAAC,MAA4C,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../src/commands/admin.ts"],"names":[],"mappings":"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"}

package/dist/commands/auth.js

@@ -1,29 +1,158 @@
-import { readConfig, writeConfig, setApiKey, clearApiKey, DEFAULT_API_URL } from '../config.js';
-import { printOutput, human } from '../output.js';
+import { CertenClient, CertenError, revokeOAuthToken } from '@certen.io/sdk';
+import { readConfig, writeConfig, setApiKey, clearApiKey, DEFAULT_API_URL, getPortalUrl, getApiUrl, } from '../config.js';
+import { printOutput, human, hint, isJsonMode } from '../output.js';
+import { CliError, UsageError, EXIT } from '../errors.js';
+import { isInteractive, promptSecret, readSecretFromStdin } from '../passphrase.js';
+async function resolveKeyInput(flagValue) {
+    // `-` is the conventional "read it from stdin" spelling, and it is the one that keeps the secret
+    // out of shell history and out of `ps` output.
+    if (flagValue === '-') {
+        const key = await readSecretFromStdin();
+        if (!key)
+            throw new UsageError('No API key on stdin.', 'NO_API_KEY');
+        return { key, source: 'stdin' };
+    }
+    if (flagValue)
+        return { key: flagValue.trim(), source: 'flag' };
+    if (!isInteractive()) {
+        throw new UsageError('No API key given and no TTY to prompt on. Pass --api-key <key>, pipe it with '
+            + '`--api-key -`, or set CERTEN_API_KEY.', 'NO_API_KEY');
+    }
+    const key = await promptSecret('API key (input hidden): ');
+    if (!key)
+        throw new UsageError('No API key entered.', 'NO_API_KEY');
+    return { key, source: 'prompt' };
+}
+/**
+ * Prove the key is accepted by the gateway before it is written anywhere.
+ *
+ * `billing.balance` is the probe because it is cheap, read-only, and mutates nothing. The status
+ * codes are read carefully rather than treated as pass/fail:
+ *
+ * - **401** is the only conclusive rejection — the gateway does not recognise this credential.
+ * - **403** means the key is REAL and simply lacks `billing:read`. Refusing it here would reject
+ *   a perfectly good scoped key, so it is accepted with a note.
+ * - **Anything else** (a 5xx, a route missing on an older gateway) is inconclusive. Saying so is
+ *   honest; claiming verification we did not achieve is not.
+ * - **A transport failure** is rethrown untouched, so it exits 3 and the caller knows nothing was
+ *   written rather than assuming the key was bad.
+ */
+async function verifyKey(apiKey, baseUrl) {
+    const client = new CertenClient({ apiKey, baseUrl });
+    try {
+        await client.billing.balance();
+        return { ok: true };
+    }
+    catch (err) {
+        if (err instanceof CertenError) {
+            if (err.status === 401)
+                return { ok: false };
+            if (err.status === 403) {
+                return { ok: true, note: 'Key accepted, but it has no billing:read scope — `certen balance` will not work with it.' };
+            }
+            // status 0 is the SDK's "never reached the gateway". That is an unreachable-gateway
+            // condition, not a bad key, and it must exit 3 rather than be reported as a rejection.
+            if (err.status === 0)
+                throw err;
+            return { ok: true, note: `Could not fully verify the key (gateway answered ${err.status}). Saved anyway.` };
+        }
+        throw err;
+    }
+}
 export function registerAuthCommands(program) {
     const auth = program.command('auth').description('Authentication management');
     auth
         .command('login')
-        .description('Save API key (OS keyring by default; --no-keyring stores in ~/.certen/config.json with 0600 perms)')
-        .requiredOption('--api-key <key>', 'API key to save')
+        .description('Verify an API key and save it (OS keyring by default; --no-keyring writes ~/.certen/config.json at 0600)')
+        // No longer required: omitting it prompts on a TTY, which keeps the secret out of shell
+        // history. `--api-key -` reads it from stdin for scripts that want the same guarantee.
+        .option('--api-key <key>', 'API key to save. Use "-" to read it from stdin; omit to be prompted')
         .option('--api-url <url>', 'API base URL')
         .option('--no-keyring', 'Store in ~/.certen/config.json instead of the OS keyring')
+        .option('--no-verify', 'Skip the check that the gateway accepts this key (offline setup)')
         .action(async (opts) => {
         const useKeyring = opts.keyring !== false;
+        const { key, source } = await resolveKeyInput(opts.apiKey);
+        // The URL the key will be checked against has to be the one it will be USED against, so a
+        // --api-url passed in the same invocation applies to the verification too.
+        const cfg = readConfig();
+        const baseUrl = opts.apiUrl ?? process.env.CERTEN_API_URL ?? cfg.api_url ?? DEFAULT_API_URL;
+        let note;
+        if (opts.verify !== false) {
+            const result = await verifyKey(key, baseUrl);
+            if (!result.ok) {
+                // Nothing is written. The old behaviour saved first and discovered this later, which
+                // left a broken credential on disk that every subsequent command tripped over.
+                throw new UsageError(`That API key was rejected by ${baseUrl}. Nothing was saved. `
+                    + `Check it, or mint a new one at ${getPortalUrl()}`, 'INVALID_API_KEY');
+            }
+            note = result.note;
+        }
         try {
-            await setApiKey(opts.apiKey, useKeyring);
+            await setApiKey(key, useKeyring);
         }
         catch (err) {
+            // Was `process.exit(1)`, which skipped the envelope entirely in --json mode.
             const msg = err instanceof Error ? err.message : String(err);
-            console.error(`Failed to save API key: ${msg}`);
-            process.exit(1);
+            throw new CliError(`Failed to save API key: ${msg}`, 'KEY_STORAGE_FAILED', EXIT.FAILED);
         }
         if (opts.apiUrl) {
-            const cfg = readConfig();
-            cfg.api_url = opts.apiUrl;
-            writeConfig(cfg);
+            const updated = readConfig();
+            updated.api_url = opts.apiUrl;
+            writeConfig(updated);
+        }
+        printOutput({
+            storage: useKeyring ? 'keyring' : 'file',
+            key_prefix: `${key.substring(0, 12)}...`,
+            api_url: baseUrl,
+            verified: opts.verify !== false,
+        });
+        human(useKeyring
+            ? 'API key saved to the OS keyring.'
+            : 'API key saved to ~/.certen/config.json (mode 0600).');
+        if (note)
+            hint(note);
+        if (source === 'flag') {
+            hint('Tip: `--api-key -` reads the key from stdin, which keeps it out of your shell history.');
+        }
+        hint('');
+        hint('Next: certen keys generate --name dev');
+    });
+    auth
+        .command('revoke-token [token]')
+        .description('Revoke an OAuth2 access or refresh token (no API key needed)')
+        .option('--refresh', 'The token is a refresh token — revoking it kills its whole chain')
+        .action(async (token, opts) => {
+        // Reachable without a configured API key on purpose. This is the command someone runs when a
+        // token has leaked, and requiring the credential they are trying to contain would be exactly
+        // backwards. The gateway authenticates the request with the token itself.
+        let value = token;
+        if (!value) {
+            // Read from stdin or a prompt rather than argv: a token pasted as an argument lands in
+            // shell history and process listings, which is a poor place for a live credential.
+            value = isInteractive()
+                ? await promptSecret('Token to revoke: ')
+                : await readSecretFromStdin();
+        }
+        if (!value) {
+            throw new UsageError('No token given. Pass it as an argument, or pipe it on stdin.', 'MISSING_TOKEN');
+        }
+        await revokeOAuthToken(value.trim(), {
+            baseUrl: getApiUrl(),
+            tokenTypeHint: opts.refresh ? 'refresh_token' : 'access_token',
+        });
+        printOutput({ revoked: true });
+        if (!isJsonMode()) {
+            human('');
+            human('  That token is no longer valid.');
+            // Said explicitly because RFC 7009 makes success ambiguous by design, and someone
+            // containing an incident deserves to know what they have and have not learned.
+            human('  Revocation never reveals whether a token existed, so this succeeds either way —');
+            human('  it confirms the token is not valid now, not that it was valid before.');
+            if (opts.refresh) {
+                human('  Its descendant access tokens were revoked with it.');
+            }
         }
-        human(useKeyring ? 'API key saved to OS keyring' : 'API key saved to ~/.certen/config.json (mode 0600)');
     });
     auth
         .command('logout')
@@ -34,7 +163,7 @@ export function registerAuthCommands(program) {
     });
     auth
         .command('status')
-        .description('Show current authentication config (prefix-only — never reveals the full key)')
+        .description('Show LOCAL authentication config (offline — never contacts the gateway, never reveals the full key)')
         .action(() => {
         const cfg = readConfig();
         // Round-2 #43: when storage=keyring the prefix is persisted at login
@@ -63,6 +192,10 @@ export function registerAuthCommands(program) {
             api_url: cfg.api_url ?? `${DEFAULT_API_URL} (default)`,
             output: cfg.output ?? 'table (default)',
         });
+        // This command answers "what is configured here", not "does it work". Those are different
+        // questions and conflating them is how a user concludes their setup is fine while every
+        // request 401s. `certen doctor` (Phase 2) answers the second one.
+        hint('This is local config only. It does not check that the key still works.');
     });
 }
 //# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

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

package/dist/commands/billing.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerBillingCommands(program: Command): void;