@invinite-org/invinite-data-cli 3.0.0 → 4.1.0

package/dist/src/commands/auth.js

@@ -0,0 +1,336 @@
+import { randomBytes } from 'node:crypto';
+import { createServer } from 'node:http';
+import { hostname } from 'node:os';
+import { spawn } from 'node:child_process';
+import { createInterface } from 'node:readline/promises';
+import chalk from 'chalk';
+import { apiCall } from '../client/api-client.js';
+import { clearApiKey, keyHint, resolveApiKey, setApiKey } from '../config/auth.js';
+import { DASHBOARD_URL, getBaseUrl } from '../config/config-manager.js';
+import { AuthRequiredError, UsageError, withErrorHandling } from '../shared/errors.js';
+import { readStdin } from '../shared/prompt.js';
+const CALLBACK_TIMEOUT_MS = 5 * 60 * 1000;
+const KEY_LIFETIME_MS = 90 * 24 * 60 * 60 * 1000;
+const MAX_BIND_ATTEMPTS = 3;
+async function readLine(prompt, signal) {
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        return await rl.question(prompt, { signal });
+    }
+    finally {
+        rl.close();
+    }
+}
+const defaultDependencies = {
+    fetch: globalThis.fetch,
+    openBrowser,
+    timeoutMs: CALLBACK_TIMEOUT_MS,
+    readPasted: readLine,
+};
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function parseEnvelope(response) {
+    try {
+        return await response.json();
+    }
+    catch {
+        return undefined;
+    }
+}
+function browserCommand(url) {
+    if (process.platform === 'darwin')
+        return { command: 'open', args: [url] };
+    if (process.platform === 'win32')
+        return { command: 'cmd', args: ['/c', 'start', '', url] };
+    return { command: 'xdg-open', args: [url] };
+}
+async function openBrowser(url) {
+    const target = browserCommand(url);
+    await new Promise((resolve, reject) => {
+        const child = spawn(target.command, target.args, { detached: true, stdio: 'ignore' });
+        child.once('error', reject);
+        child.once('spawn', () => {
+            child.unref();
+            resolve();
+        });
+    });
+}
+function callbackHtml(title, message) {
+    return `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>${title}</title></head><body><main><h1>${title}</h1><p>${message}</p></main></body></html>`;
+}
+async function closeServer(server) {
+    if (!server.listening)
+        return;
+    await new Promise((resolve) => server.close(() => resolve()));
+}
+async function listenOnRandomPort(server) {
+    for (let attempt = 0; attempt < MAX_BIND_ATTEMPTS; attempt += 1) {
+        const port = 49_152 + randomBytes(2).readUInt16BE(0) % (65_535 - 49_152 + 1);
+        try {
+            await new Promise((resolve, reject) => {
+                const handleError = (error) => reject(error);
+                server.once('error', handleError);
+                server.listen(port, '127.0.0.1', () => {
+                    server.off('error', handleError);
+                    resolve();
+                });
+            });
+            return port;
+        }
+        catch (error) {
+            if (error.code !== 'EADDRINUSE' || attempt === MAX_BIND_ATTEMPTS - 1)
+                throw error;
+        }
+    }
+    throw new Error('Could not start the login callback server');
+}
+/** The exchange code and state of a pasted redirect URL (`http://127.0.0.1:…/callback?code=…&state=…`), or a bare code. */
+export function parsePastedCallback(text) {
+    const trimmed = text.trim();
+    try {
+        const url = new URL(trimmed);
+        return { code: url.searchParams.get('code') ?? undefined, state: url.searchParams.get('state') ?? undefined };
+    }
+    catch {
+        return trimmed ? { code: trimmed } : {};
+    }
+}
+async function exchange(dependencies, baseUrl, code) {
+    const exchangeResponse = await dependencies.fetch(`${baseUrl}/auth/exchange`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ code }),
+    });
+    const envelope = await parseEnvelope(exchangeResponse);
+    if (!exchangeResponse.ok || !envelope?.ok) {
+        if (exchangeResponse.status === 401)
+            throw new Error('Login expired, run `invd auth login` again');
+        throw new Error(envelope && !envelope.ok ? envelope.error : `Login exchange failed (${exchangeResponse.status})`);
+    }
+    await setApiKey(envelope.data.key);
+    return envelope.data;
+}
+/**
+ * Browser sign-in: a loopback callback server receives the exchange code. With `noBrowser` (SSH sessions) the URL
+ * is printed instead and the person pastes the address their browser was sent to (the page itself may not load —
+ * the code is in its URL); whichever arrives first wins.
+ */
+export async function login(dependencies = defaultDependencies, opts = {}) {
+    const state = randomBytes(16).toString('hex');
+    let resolveCallback = () => undefined;
+    let rejectCallback = () => undefined;
+    const callback = new Promise((resolve, reject) => {
+        resolveCallback = resolve;
+        rejectCallback = reject;
+    });
+    let settled = false;
+    const settleError = (error) => {
+        if (settled)
+            return;
+        settled = true;
+        rejectCallback(error);
+    };
+    const settleSuccess = (data) => {
+        if (settled)
+            return;
+        settled = true;
+        resolveCallback(data);
+    };
+    const baseUrl = getBaseUrl().replace(/\/$/u, '');
+    const server = createServer(async (request, response) => {
+        const callbackUrl = new URL(request.url ?? '/', 'http://127.0.0.1');
+        if (request.method !== 'GET' || callbackUrl.pathname !== '/callback') {
+            response.writeHead(404).end();
+            return;
+        }
+        if (callbackUrl.searchParams.get('state') !== state) {
+            response.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' });
+            response.end(callbackHtml('Login failed', 'State verification failed. Return to the terminal and try again.'));
+            settleError(new Error('Login state verification failed'));
+            return;
+        }
+        const code = callbackUrl.searchParams.get('code');
+        if (!code) {
+            response.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' });
+            response.end(callbackHtml('Login failed', 'The callback did not include an exchange code.'));
+            settleError(new Error('Login callback did not include an exchange code'));
+            return;
+        }
+        try {
+            const data = await exchange(dependencies, baseUrl, code);
+            response.writeHead(200, { 'Cache-Control': 'no-store', 'Content-Type': 'text/html; charset=utf-8' });
+            response.end(callbackHtml('Login complete', 'You can close this tab and return to the terminal.'));
+            settleSuccess(data);
+        }
+        catch (error) {
+            response.writeHead(502, { 'Cache-Control': 'no-store', 'Content-Type': 'text/html; charset=utf-8' });
+            response.end(callbackHtml('Login failed', 'The credential exchange failed. Return to the terminal and try again.'));
+            settleError(error instanceof Error ? error : new Error(String(error)));
+        }
+    });
+    const port = await listenOnRandomPort(server);
+    const loginUrl = new URL(`${baseUrl}/auth/login`);
+    loginUrl.searchParams.set('port', String(port));
+    loginUrl.searchParams.set('state', state);
+    loginUrl.searchParams.set('hostname', hostname().slice(0, 64));
+    const handleInterrupt = () => settleError(new Error('Login cancelled'));
+    process.once('SIGINT', handleInterrupt);
+    const timeout = setTimeout(() => settleError(new Error('Login timed out. Run `invd auth login` again.')), dependencies.timeoutMs);
+    const pasteAbort = new AbortController();
+    try {
+        const preflight = await dependencies.fetch(loginUrl, { redirect: 'manual' });
+        if (preflight.status === 503) {
+            throw new Error('OAuth login is not enabled on this deployment. Use `invd auth login --with-token` instead.');
+        }
+        if (preflight.status < 300 || preflight.status >= 400) {
+            const envelope = await parseEnvelope(preflight);
+            throw new Error(envelope && !envelope.ok ? envelope.error : `Could not start login (${preflight.status})`);
+        }
+        if (opts.noBrowser) {
+            console.error('Open this URL in a browser on any machine and sign in:');
+            console.error(loginUrl.toString());
+            const read = dependencies.readPasted ?? readLine;
+            void read('Then paste the address the browser was sent to (it starts with http://127.0.0.1): ', pasteAbort.signal).then(async (text) => {
+                const pasted = parsePastedCallback(text);
+                if (pasted.state !== undefined && pasted.state !== state)
+                    throw new Error('Login state verification failed');
+                if (!pasted.code)
+                    throw new Error('The pasted text has no exchange code');
+                settleSuccess(await exchange(dependencies, baseUrl, pasted.code));
+            }).catch((error) => settleError(error instanceof Error ? error : new Error(String(error))));
+        }
+        else {
+            try {
+                await dependencies.openBrowser(loginUrl.toString());
+                console.error(chalk.dim('Opening your browser to complete login...'));
+            }
+            catch {
+                console.error(chalk.yellow('Could not open a browser automatically. Open this URL:'));
+                console.error(loginUrl.toString());
+            }
+        }
+        const data = await callback;
+        const approximateExpiry = new Date(Date.now() + KEY_LIFETIME_MS).toLocaleDateString();
+        console.log(chalk.green('Logged in successfully.'));
+        console.log(`  Key hint:   ${data.keyHint}`);
+        console.log(`  Label:      ${data.label}`);
+        console.log(`  Expires:    approximately ${approximateExpiry} (90 days)`);
+        console.log(chalk.dim(`This sign-in is also listed on your keys page: ${DASHBOARD_URL}/keys`));
+        return data;
+    }
+    finally {
+        clearTimeout(timeout);
+        pasteAbort.abort();
+        process.off('SIGINT', handleInterrupt);
+        await closeServer(server);
+    }
+}
+export async function logout(dependencies = defaultDependencies) {
+    let resolved;
+    try {
+        resolved = await resolveApiKey();
+    }
+    catch (error) {
+        if (error instanceof AuthRequiredError) {
+            console.log('Not logged in.');
+            return;
+        }
+        throw error;
+    }
+    const baseUrl = getBaseUrl().replace(/\/$/u, '');
+    try {
+        const response = await dependencies.fetch(`${baseUrl}/auth/revoke`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${resolved.key}` },
+        });
+        if (!response.ok) {
+            const envelope = await parseEnvelope(response);
+            console.warn(chalk.yellow(`Warning: remote revocation failed: ${envelope && !envelope.ok ? envelope.error : response.status}`));
+        }
+    }
+    catch (error) {
+        console.warn(chalk.yellow(`Warning: remote revocation failed: ${errorMessage(error)}`));
+    }
+    if (resolved.source === 'environment') {
+        console.log(`The active key comes from ${resolved.origin}. Remove that environment variable to finish logging out.`);
+        return;
+    }
+    if (resolved.source === 'dotenv') {
+        console.log(`The active key comes from the current directory's ${resolved.origin}. Remove it from that file to finish logging out.`);
+        return;
+    }
+    await clearApiKey();
+    console.log(chalk.green('Logged out locally.'));
+}
+/** `invd auth status`: where the key comes from and, unless `offline`, what `GET /v2/me` says about it (free). */
+export async function status(opts = {}) {
+    const resolved = await resolveApiKey();
+    const summary = {
+        host: getBaseUrl(),
+        key: keyHint(resolved.key),
+        source: resolved.source,
+        origin: resolved.origin,
+    };
+    if (!opts.offline) {
+        const { body } = await apiCall({ path: '/v2/me', silent: true });
+        const account = body?.account;
+        const plan = body?.plan;
+        if (typeof account === 'object' && account !== null) {
+            const fields = account;
+            summary.account = fields.email ?? fields.name ?? fields.id ?? account;
+        }
+        else {
+            summary.account = account;
+        }
+        summary.plan = typeof plan === 'object' && plan !== null ? plan.name ?? plan : plan;
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(summary, null, 2));
+        return;
+    }
+    console.log(chalk.green('Logged in.'));
+    for (const [key, value] of Object.entries(summary)) {
+        console.log(`  ${key.padEnd(8)}  ${typeof value === 'object' ? JSON.stringify(value) : String(value)}`);
+    }
+}
+export function registerAuthCommands(program) {
+    const auth = program.command('auth').description('Sign in, inspect and remove the API key invd uses');
+    auth
+        .command('login')
+        .description('Sign in through your browser (the key belongs to your Invinite Data account)')
+        .option('--no-browser', 'Print the sign-in URL and paste the redirect address back (SSH sessions)')
+        .option('--with-token', 'Read an API key from stdin instead (e.g. invd auth login --with-token < key.txt)')
+        .addHelpText('before', 'Examples:\n  $ invd auth login\n  $ invd auth login --no-browser\n')
+        .action(withErrorHandling(async (opts) => {
+        if (opts.withToken) {
+            const key = (await readStdin()).trim();
+            if (!key)
+                throw new UsageError('--with-token: stdin held no key');
+            const where = await setApiKey(key);
+            console.log(chalk.green(`API key saved (${where === 'keychain' ? 'OS keychain' : 'config.toml'}): ${keyHint(key)}`));
+            return;
+        }
+        await login(defaultDependencies, { noBrowser: opts.browser === false });
+    }));
+    auth
+        .command('status')
+        .description('Show which key is active, where it comes from, and the account it belongs to (GET /v2/me, free)')
+        .option('--offline', 'Do not call the API')
+        .option('--json', 'Print JSON')
+        .addHelpText('before', 'Examples:\n  $ invd auth status\n  $ invd auth status --offline --json\n')
+        .action(withErrorHandling(async (opts) => status(opts)));
+    auth
+        .command('token')
+        .description('Print the active API key to stdout (for scripts: curl -H "Authorization: Bearer $(invd auth token)")')
+        .addHelpText('before', 'Examples:\n  $ invd auth token\n  $ export INVD_API_KEY="$(invd auth token)"\n')
+        .action(withErrorHandling(async () => {
+        process.stdout.write(`${(await resolveApiKey()).key}\n`);
+    }));
+    auth
+        .command('logout')
+        .description('Revoke the current login and clear the stored key')
+        .addHelpText('before', 'Examples:\n  $ invd auth logout\n  $ INVD_API_KEY= invd auth logout\n')
+        .action(withErrorHandling(async () => logout()));
+}
+//# sourceMappingURL=auth.js.map

package/dist/src/commands/auth.js.map

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

package/dist/src/commands/completion.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/** Every command path of the tree (`''` = the root) with the words completed after it: subcommands and flags. */
+export declare function completionTable(program: Command): Map<string, string[]>;
+export declare const SHELLS: readonly ["bash", "zsh", "fish"];
+export declare function completionScript(shell: string, program: Command, apiPaths: readonly string[]): string;
+/** `invd completion bash|zsh|fish`: the script, generated from the live command tree and the spec's paths. */
+export declare function registerCompletionCommand(program: Command, apiPaths: () => readonly string[]): void;

package/dist/src/commands/completion.js

@@ -0,0 +1,115 @@
+import { UsageError } from '../shared/errors.js';
+/** Every command path of the tree (`''` = the root) with the words completed after it: subcommands and flags. */
+export function completionTable(program) {
+    const table = new Map();
+    const walk = (command, path) => {
+        const words = [
+            ...command.commands.map(child => child.name()),
+            ...command.options.flatMap(option => [option.long, option.short].filter((flag) => Boolean(flag))),
+            '--help',
+        ];
+        table.set(path.join(' '), [...new Set(words)]);
+        for (const child of command.commands)
+            walk(child, [...path, child.name()]);
+    };
+    walk(program, []);
+    return table;
+}
+const shellQuote = (text) => `'${text.replace(/'/g, "'\\''")}'`;
+function bashScript(table, apiPaths) {
+    const cases = [...table].map(([path, words]) => `    ${shellQuote(path)}) echo ${shellQuote(words.join(' '))} ;;`).join('\n');
+    return `# invd completion for bash (eval "$(invd completion bash)", or save it under bash-completion's completions dir)
+__invd_words() {
+  case "$1" in
+${cases}
+  esac
+}
+__invd_api_paths=${shellQuote(apiPaths.join(' '))}
+_invd() {
+  local cur="\${COMP_WORDS[COMP_CWORD]}" path="" w i words
+  for ((i = 1; i < COMP_CWORD; i++)); do
+    w="\${COMP_WORDS[i]}"
+    [[ $w == -* ]] && continue
+    words=" $(__invd_words "$path") "
+    [[ $words == *" $w "* ]] && path="\${path:+$path }$w"
+  done
+  if [[ $path == api && $cur != -* ]]; then
+    words="$__invd_api_paths GET POST PATCH DELETE"
+  else
+    words="$(__invd_words "$path")"
+  fi
+  COMPREPLY=($(compgen -W "$words" -- "$cur"))
+}
+complete -o default -F _invd invd
+`;
+}
+function zshScript(table, apiPaths) {
+    return `#compdef invd
+# invd completion for zsh (eval "$(invd completion zsh)" in ~/.zshrc)
+autoload -U +X bashcompinit && bashcompinit
+${bashScript(table, apiPaths).split('\n').slice(1).join('\n')}`;
+}
+function fishScript(table, apiPaths) {
+    const cases = [...table].map(([path, words]) => `    case ${shellQuote(path)}\n      printf '%s\\n' ${words.map(shellQuote).join(' ')}`).join('\n');
+    return `# invd completion for fish (invd completion fish > ~/.config/fish/completions/invd.fish)
+function __invd_words
+  switch $argv[1]
+${cases}
+  end
+end
+function __invd_path
+  set -l tokens (commandline -opc)
+  set -e tokens[1]
+  set -l path ''
+  for t in $tokens
+    string match -q -- '-*' $t; and continue
+    if contains -- $t (__invd_words "$path")
+      set path (string trim -- "$path $t")
+    end
+  end
+  echo $path
+end
+function __invd_complete
+  set -l path (__invd_path)
+  if test "$path" = api
+    printf '%s\\n' ${apiPaths.map(shellQuote).join(' ')}
+  end
+  __invd_words "$path"
+end
+complete -c invd -f -a '(__invd_complete)'
+`;
+}
+export const SHELLS = ['bash', 'zsh', 'fish'];
+export function completionScript(shell, program, apiPaths) {
+    const table = completionTable(program);
+    if (shell === 'bash')
+        return bashScript(table, apiPaths);
+    if (shell === 'zsh')
+        return zshScript(table, apiPaths);
+    if (shell === 'fish')
+        return fishScript(table, apiPaths);
+    throw new UsageError(`Unknown shell ${shell}: ${SHELLS.join(', ')}`);
+}
+/** `invd completion bash|zsh|fish`: the script, generated from the live command tree and the spec's paths. */
+export function registerCompletionCommand(program, apiPaths) {
+    program
+        .command('completion')
+        .description('Print the shell completion script (commands, flags, and the API paths after invd api)')
+        .argument('<shell>', SHELLS.join(' | '))
+        .addHelpText('before', [
+        'Examples:',
+        '  $ eval "$(invd completion zsh)"',
+        '  $ invd completion fish > ~/.config/fish/completions/invd.fish',
+        '',
+    ].join('\n'))
+        .action((shell) => {
+        try {
+            process.stdout.write(completionScript(shell, program, apiPaths()));
+        }
+        catch (error) {
+            console.error(error instanceof Error ? error.message : String(error));
+            process.exit(2);
+        }
+    });
+}
+//# sourceMappingURL=completion.js.map

package/dist/src/commands/completion.js.map

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

package/dist/src/commands/config.d.ts

@@ -1,2 +1,6 @@
 import { Command } from 'commander';
+/**
+ * `invd config`: the settings in `$XDG_CONFIG_HOME/invd/config.toml` (`INVD_CONFIG_DIR` replaces the directory)
+ * and the project file `./.invd.toml` (`--local`). Precedence: flags > env > `./.invd.toml` > `config.toml`.
+ */
 export declare function registerConfigCommands(program: Command): void;

package/dist/src/commands/config.js

@@ -1,56 +1,93 @@
 import chalk from 'chalk';
-import { setApiKey } from '../config/auth.js';
-import { setBaseUrl, showConfig, resetConfig } from '../config/config-manager.js';
+import { SETTINGS, getSetting, globalConfigPath, isSettingKey, localConfigPath, setSetting, unsetSetting, } from '../config/config-manager.js';
+import { OUTPUT_FORMATS } from '../output/render.js';
+import { UsageError, withErrorHandling } from '../shared/errors.js';
+function settingKey(key) {
+    if (!isSettingKey(key))
+        throw new UsageError(`Unknown setting ${key}. Settings: ${Object.keys(SETTINGS).join(', ')}`);
+    return key;
+}
+function checkValue(key, value) {
+    if (key === 'output' && value !== '' && !OUTPUT_FORMATS.includes(value)) {
+        throw new UsageError(`output must be one of ${OUTPUT_FORMATS.join(', ')}`);
+    }
+    if (key === 'confirm_credits' && !/^\d+$/.test(value))
+        throw new UsageError('confirm_credits must be a whole number');
+    if (key === 'base_url') {
+        try {
+            new URL(value);
+        }
+        catch {
+            throw new UsageError(`base_url must be a URL (got ${value})`);
+        }
+    }
+}
+const shown = (key, value) => (key === 'api_key' && value ? `${value.slice(0, 4)}…` : value);
+/**
+ * `invd config`: the settings in `$XDG_CONFIG_HOME/invd/config.toml` (`INVD_CONFIG_DIR` replaces the directory)
+ * and the project file `./.invd.toml` (`--local`). Precedence: flags > env > `./.invd.toml` > `config.toml`.
+ */
 export function registerConfigCommands(program) {
-    const configCmd = program
+    const config = program
         .command('config')
-        .description('Manage CLI configuration');
-    configCmd
-        .command('set-key')
-        .description('Set API key (interactive, masked input)')
-        .action(async () => {
-        const { default: Enquirer } = await import('enquirer');
-        const enquirer = new Enquirer();
-        const response = await enquirer.prompt({
-            type: 'password',
-            name: 'key',
-            message: 'Enter your Invinite API key:',
+        .description('Local settings: config.toml (XDG) and ./.invd.toml; flags > env > local > global');
+    config
+        .command('list')
+        .description('Every setting with its value and where it comes from')
+        .option('--json', 'Print JSON')
+        .addHelpText('before', 'Examples:\n  $ invd config list\n  $ invd config list --json\n')
+        .action(withErrorHandling(async (opts) => {
+        const rows = Object.keys(SETTINGS).map(key => {
+            const { value, source } = getSetting(key);
+            return { key, value: shown(key, value), source, env: SETTINGS[key].env };
         });
-        await setApiKey(response.key);
-        console.log(chalk.green('API key saved successfully.'));
-    });
-    configCmd
-        .command('set-url')
-        .description('Set API base URL')
-        .argument('<url>', 'Base URL for the API')
-        .action((url) => {
-        setBaseUrl(url);
-        console.log(chalk.green(`Base URL set to ${url}`));
-    });
-    configCmd
-        .command('show')
-        .description('Display current configuration')
-        .action(() => {
-        const cfg = showConfig();
-        console.log(chalk.bold('Current Configuration:'));
-        console.log(`  Base URL:    ${cfg.baseUrl}`);
-        console.log(`  API Key:     ${cfg.apiKeySet ? chalk.green('configured') : chalk.yellow('not set')}`);
-    });
-    configCmd
-        .command('reset')
-        .description('Reset all configuration')
-        .action(async () => {
-        const { default: Enquirer } = await import('enquirer');
-        const enquirer = new Enquirer();
-        const response = await enquirer.prompt({
-            type: 'confirm',
-            name: 'confirm',
-            message: 'Are you sure you want to reset all configuration?',
-        });
-        if (response.confirm) {
-            resetConfig();
-            console.log(chalk.green('Configuration reset.'));
+        if (opts.json) {
+            console.log(JSON.stringify({ global: globalConfigPath(), local: localConfigPath(), settings: rows }, null, 2));
+            return;
         }
+        for (const row of rows) {
+            console.log(`  ${chalk.bold(row.key.padEnd(16))} ${row.value === '' ? chalk.dim('(unset)') : row.value}  ${chalk.dim(`${row.source} · $${row.env}`)}`);
+        }
+        console.log(chalk.dim(`\nglobal: ${globalConfigPath()}\nlocal:  ${localConfigPath()}`));
+    }));
+    config
+        .command('get')
+        .description('Print one setting\'s effective value')
+        .argument('<key>', `One of ${Object.keys(SETTINGS).join(', ')}`)
+        .addHelpText('before', 'Examples:\n  $ invd config get base_url\n  $ invd config get output\n')
+        .action(withErrorHandling(async (key) => {
+        const name = settingKey(key);
+        console.log(shown(name, getSetting(name).value));
+    }));
+    config
+        .command('set')
+        .description('Write a setting to config.toml (or ./.invd.toml with --local)')
+        .argument('<key>', `One of ${Object.keys(SETTINGS).join(', ')}`)
+        .argument('<value>', 'The value')
+        .option('--local', 'Write ./.invd.toml (this project) instead of the global file')
+        .addHelpText('before', 'Examples:\n  $ invd config set output json\n  $ invd config set base_url http://localhost:4000 --local\n')
+        .action(withErrorHandling(async (key, value, opts) => {
+        const name = settingKey(key);
+        checkValue(name, value);
+        const path = setSetting(name, value, opts.local ? 'local' : 'global');
+        console.log(chalk.green(`${name} = ${shown(name, value)}`) + chalk.dim(` (${path})`));
+    }));
+    config
+        .command('unset')
+        .description('Remove a setting from config.toml (or ./.invd.toml with --local)')
+        .argument('<key>', `One of ${Object.keys(SETTINGS).join(', ')}`)
+        .option('--local', 'Edit ./.invd.toml instead of the global file')
+        .addHelpText('before', 'Examples:\n  $ invd config unset output\n  $ invd config unset base_url --local\n')
+        .action(withErrorHandling(async (key, opts) => {
+        const path = unsetSetting(settingKey(key), opts.local ? 'local' : 'global');
+        console.log(chalk.green(`${key} unset`) + chalk.dim(` (${path})`));
+    }));
+    config
+        .command('path')
+        .description('Print the global config file path')
+        .addHelpText('before', 'Examples:\n  $ invd config path\n  $ cat "$(invd config path)"\n')
+        .action(() => {
+        console.log(globalConfigPath());
     });
 }
 //# sourceMappingURL=config.js.map