@invinite-org/invinite-data-cli 2.0.0 → 4.0.0

package/dist/src/output/render.js

@@ -0,0 +1,160 @@
+import { spawnSync } from 'node:child_process';
+import chalk from 'chalk';
+import { getSetting } from '../config/config-manager.js';
+import { pick } from '../formatters/flatten.js';
+import { UsageError } from '../shared/errors.js';
+import { runJq } from './jq.js';
+/**
+ * Every generated command prints through here: data to stdout (`table` on a terminal, `plain` tab-separated when
+ * piped, or `json` / `jsonl` / `csv` on request), progress / cost / coverage notes to stderr (callers), long human
+ * output through `INVD_PAGER` / `PAGER` on a terminal.
+ */
+export const OUTPUT_FORMATS = ['table', 'plain', 'json', 'jsonl', 'csv'];
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** `NO_COLOR` turns colour off unless `FORCE_COLOR` asks for it (chalk reads `FORCE_COLOR` itself). */
+export function applyColorEnv(env = process.env) {
+    if (env.NO_COLOR && !env.FORCE_COLOR)
+        chalk.level = 0;
+}
+/** A row reduced to `fields` (dotted paths kept as their dotted key). */
+export function selectFields(row, fields) {
+    return Object.fromEntries(fields.map(field => [field, pick(row, field) ?? null]));
+}
+/** Fails on a `--json` field the operation's rows do not have, listing the ones they do. */
+export function checkFields(fields, known, flag = '--json') {
+    if (known.length === 0)
+        return;
+    const unknown = fields.filter(field => !known.includes(field.split('.')[0] ?? field));
+    if (unknown.length > 0) {
+        throw new UsageError(`${flag}: unknown field ${unknown.join(', ')}. Fields: ${known.join(', ')}`);
+    }
+}
+/** The body with `select` / `prune` applied to its rows (a list keeps its envelope) or to the object. */
+export function shapeBody(body, shape, settings) {
+    const fields = settings.select ?? settings.prune;
+    if (!fields || !isRecord(body))
+        return body;
+    if (shape.list && Array.isArray(body.data))
+        return { ...body, data: body.data.map(row => selectFields(row, fields)) };
+    return selectFields(body, fields);
+}
+function cell(value, column) {
+    if (value === null || value === undefined)
+        return '—';
+    if (typeof value === 'number') {
+        if (column && /(^|_)(year|quarter)$/.test(column))
+            return String(value);
+        if (Number.isInteger(value) && Math.abs(value) >= 1000)
+            return value.toLocaleString('en-US');
+        if (!Number.isInteger(value))
+            return value.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 4 });
+        return String(value);
+    }
+    if (typeof value === 'boolean')
+        return value ? 'Yes' : 'No';
+    if (Array.isArray(value))
+        return value.map(item => (isRecord(item) ? JSON.stringify(item) : String(item))).join(', ');
+    if (isRecord(value))
+        return JSON.stringify(value);
+    return String(value);
+}
+const plainCell = (value) => {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return String(value).replace(/[\t\n]/g, ' ');
+};
+export function tableText(rows, columns) {
+    if (rows.length === 0)
+        return chalk.yellow('No results.');
+    const cols = columns && columns.length > 0 ? [...columns] : Object.keys(rows[0] ?? {});
+    const widths = cols.map(col => Math.max(col.length, ...rows.map(row => cell(row[col], col).length)));
+    const lines = [
+        cols.map((col, i) => chalk.bold(col.padEnd(widths[i] ?? 0))).join('  '),
+        cols.map((_col, i) => '─'.repeat(widths[i] ?? 0)).join('  '),
+        ...rows.map(row => cols.map((col, i) => cell(row[col], col).padEnd(widths[i] ?? 0)).join('  ').trimEnd()),
+    ];
+    return lines.join('\n');
+}
+export function plainText(rows, columns) {
+    const cols = columns && columns.length > 0 ? [...columns] : Object.keys(rows[0] ?? {});
+    return [cols.join('\t'), ...rows.map(row => cols.map(col => plainCell(row[col])).join('\t'))].join('\n');
+}
+export function keyValueText(row) {
+    const width = Math.max(0, ...Object.keys(row).map(key => key.length));
+    return Object.entries(row).map(([key, value]) => `  ${chalk.bold(key.padEnd(width))}  ${cell(value, key)}`).join('\n');
+}
+const csvCell = (value) => {
+    const text = plainCell(value);
+    return /[",\n\r]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
+};
+/** The CSV columns of some rows: every key, first-seen order. */
+export const csvColumns = (rows) => [...new Set(rows.flatMap(row => (isRecord(row) ? Object.keys(row) : [])))];
+export const csvHeader = (columns) => columns.map(csvCell).join(',');
+export const csvRow = (row, columns) => columns.map(column => csvCell(isRecord(row) ? row[column] : undefined)).join(',');
+/** The rows a body contributes to JSONL / CSV: a list's `data[]`, else the object itself. */
+export const bodyRows = (body, shape) => shape.list && isRecord(body) && Array.isArray(body.data) ? body.data : body === undefined ? [] : [body];
+const tableRows = (rows, columns) => rows.map(row => (columns ? selectFields(row, columns) : isRecord(row) ? row : { value: row }));
+/** The human view of one body: the operation's columns as a table / key-value list, else indented JSON. */
+export function humanText(body, shape, settings) {
+    const fields = settings.select ?? settings.prune;
+    const columns = fields ?? settings.order ?? shape.columns;
+    const plain = settings.format === 'plain';
+    if (shape.list) {
+        const rows = tableRows(bodyRows(body, shape), columns);
+        return plain ? plainText(rows, columns) : tableText(rows, columns);
+    }
+    if (isRecord(body) && (shape.view === 'keyValue' || fields)) {
+        const row = columns ? selectFields(body, columns) : body;
+        return plain ? plainText([row], Object.keys(row)) : keyValueText(row);
+    }
+    return JSON.stringify(body, null, 2);
+}
+/** The whole text of one (non-streamed) body in the chosen format. */
+export function renderBody(body, shape, settings) {
+    if (settings.jq)
+        return runJq(settings.jq, body).join('\n');
+    const shaped = shapeBody(body, shape, settings);
+    switch (settings.format) {
+        case 'json':
+            return JSON.stringify(shaped, null, 2);
+        case 'jsonl':
+            return bodyRows(shaped, shape).map(row => JSON.stringify(row)).join('\n');
+        case 'csv': {
+            const rows = bodyRows(shaped, shape);
+            const columns = settings.select ?? settings.prune ?? settings.order ?? csvColumns(rows);
+            return [csvHeader(columns), ...rows.map(row => csvRow(row, columns))].join('\n');
+        }
+        default:
+            return humanText(body, shape, settings);
+    }
+}
+/** The pager command for human output: `INVD_PAGER` / config `pager`, else `PAGER`; `''` / `cat` = none. */
+export function pagerCommand(env = process.env) {
+    const configured = getSetting('pager').value || env.PAGER || '';
+    return configured && configured !== 'cat' ? configured : undefined;
+}
+/**
+ * Writes `text` to stdout; human output longer than the terminal goes through the pager when stdout is a
+ * terminal and a pager is set.
+ */
+export function emit(text, opts = {}) {
+    if (text === '')
+        return;
+    const pager = opts.human && process.stdout.isTTY ? pagerCommand() : undefined;
+    if (pager && text.split('\n').length > (process.stdout.rows || 24)) {
+        const result = spawnSync(pager, { shell: true, input: `${text}\n`, stdio: ['pipe', 'inherit', 'inherit'] });
+        if (!result.error)
+            return;
+    }
+    console.log(text);
+}
+/** The format when none was asked for: the `output` setting, else `table` on a terminal and `plain` in a pipe. */
+export function defaultFormat() {
+    const configured = getSetting('output').value;
+    if (OUTPUT_FORMATS.includes(configured))
+        return configured;
+    return process.stdout.isTTY ? 'table' : 'plain';
+}
+//# sourceMappingURL=render.js.map

package/dist/src/output/render.js.map

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

package/dist/src/shared/errors.d.ts

@@ -1,41 +1,85 @@
+/**
+ * Exit codes (`invd --help` and the README list them): 0 ok, 1 failure, 2 usage, 3 partial (an unsaved download or
+ * an interrupted `--all`), 4 authentication required, 5 integrity, 6 credits exhausted / plan required.
+ */
+export declare const EXIT: {
+    readonly ok: 0;
+    readonly failure: 1;
+    readonly usage: 2;
+    readonly partial: 3;
+    readonly auth: 4;
+    readonly integrity: 5;
+    readonly credits: 6;
+};
+/** A v2 error answer (RFC 9457 problem+json): `code` is stable, `detail` says what happened. */
 export declare class ApiError extends Error {
     statusCode: number;
+    /** The problem's `title` (or the status text). */
     errorType: string;
     /** The answer's `Retry-After`, in milliseconds (absent when the header was missing or unreadable). */
     retryAfterMs?: number | undefined;
-    /** The body's stable `code` (e.g. `/v1/sec/*`: `search_provider_not_registered`), when it carried one. */
+    /** The problem's stable `code` (`invalid_parameter`, `not_covered`, `plan_required` …). */
     code?: string | undefined;
-    /** The parsed JSON error body, kept whole (`readiness`, the subject's fields) for `--json`. */
+    /** The parsed error body, kept whole (`request_id`, `param`, `errors[]`, `docs_url`) for `--json`. */
     body?: unknown | undefined;
-    constructor(statusCode: number, errorType: string, message: string, 
+    constructor(statusCode: number, 
+    /** The problem's `title` (or the status text). */
+    errorType: string, message: string, 
     /** The answer's `Retry-After`, in milliseconds (absent when the header was missing or unreadable). */
     retryAfterMs?: number | undefined, 
-    /** The body's stable `code` (e.g. `/v1/sec/*`: `search_provider_not_registered`), when it carried one. */
+    /** The problem's stable `code` (`invalid_parameter`, `not_covered`, `plan_required` …). */
     code?: string | undefined, 
-    /** The parsed JSON error body, kept whole (`readiness`, the subject's fields) for `--json`. */
+    /** The parsed error body, kept whole (`request_id`, `param`, `errors[]`, `docs_url`) for `--json`. */
     body?: unknown | undefined);
 }
+/** A command line `invd` refuses before any request (wrong value, missing argument, a needed `--yes`). Exit 2. */
+export declare class UsageError extends Error {
+    readonly exitCode: 2;
+    constructor(message: string);
+}
+/** No API key anywhere (`INVD_API_KEY`, `.env`, keychain, config). Exit 4. */
+export declare class AuthRequiredError extends Error {
+    readonly exitCode: 4;
+    constructor(message?: string);
+}
+/**
+ * Part of the answer was written, the rest failed: `--all` stopped on a page after earlier pages were printed
+ * (`cursor` resumes it). Exit 3, so a script can resume exactly these.
+ */
+export declare class PartialResultError extends Error {
+    cause: unknown;
+    written: number;
+    cursor?: string | undefined;
+    readonly exitCode: 3;
+    constructor(cause: unknown, written: number, cursor?: string | undefined);
+}
 /**
  * A download whose bytes stopped short of the length the server announced: nothing was saved (the `.part` file is
- * removed). Exit code 4, apart from an ordinary failure (1), so a script can retry exactly these.
+ * removed). Exit 3 (partial), so a script can retry exactly these.
  */
 export declare class PartialDownloadError extends Error {
     received: number;
     expected?: number | undefined;
-    readonly exitCode = 4;
+    readonly exitCode: 3;
     constructor(received: number, expected?: number | undefined);
 }
-/** Saved bytes that do not match the size / SHA-256 / media type the API stated: nothing was saved. Exit code 5. */
+/** Saved bytes that do not match the size / SHA-256 / media type the API stated: nothing was saved. Exit 5. */
 export declare class IntegrityError extends Error {
-    readonly exitCode = 5;
+    readonly exitCode: 5;
     constructor(message: string);
 }
+/** The process exit code of an error (`ApiError` by its problem `code`, else its status). */
+export declare function exitCodeFor(error: unknown): number;
+/** Commander's own exits: help and version keep their code (0, or 1 for help shown on a bare group); anything else is usage (2). */
+export declare function exitCodeOfCommanderError(error: {
+    code: string;
+    exitCode: number;
+}): number;
 /** `Retry-After` as delay-seconds or an HTTP date → milliseconds from `now`; `undefined` when unreadable. */
 export declare function parseRetryAfter(value: string | null | undefined, now?: number): number | undefined;
-/**
- * One dim line after an `ApiError` a person can act on: a 401 points at `invd login`, a 403 whose message names the
- * plan a route needs ("requires the PRO plan") names that plan.
- */
+/** One dim line after an `ApiError` a person can act on. */
 export declare function apiErrorHint(error: ApiError): string | undefined;
-/** `hint` may add one dim line after an `ApiError` (e.g. which plan a route needs). */
-export declare function withErrorHandling(fn: (...args: any[]) => Promise<void>, hint?: (error: ApiError) => string | undefined): (...args: any[]) => Promise<void>;
+/** Prints an error the way every command does (red line, detail, hint, the problem as JSON under `--json`). */
+export declare function printError(error: unknown): void;
+/** Wraps a command action: a thrown error is printed and becomes the process's exit code. */
+export declare function withErrorHandling<A extends unknown[]>(fn: (...args: A) => Promise<void>): (...args: A) => Promise<void>;

package/dist/src/shared/errors.js

@@ -1,17 +1,25 @@
 import chalk from 'chalk';
 import { isJsonMode } from './json-mode.js';
+/**
+ * Exit codes (`invd --help` and the README list them): 0 ok, 1 failure, 2 usage, 3 partial (an unsaved download or
+ * an interrupted `--all`), 4 authentication required, 5 integrity, 6 credits exhausted / plan required.
+ */
+export const EXIT = { ok: 0, failure: 1, usage: 2, partial: 3, auth: 4, integrity: 5, credits: 6 };
+/** A v2 error answer (RFC 9457 problem+json): `code` is stable, `detail` says what happened. */
 export class ApiError extends Error {
     statusCode;
     errorType;
     retryAfterMs;
     code;
     body;
-    constructor(statusCode, errorType, message, 
+    constructor(statusCode, 
+    /** The problem's `title` (or the status text). */
+    errorType, message, 
     /** The answer's `Retry-After`, in milliseconds (absent when the header was missing or unreadable). */
     retryAfterMs, 
-    /** The body's stable `code` (e.g. `/v1/sec/*`: `search_provider_not_registered`), when it carried one. */
+    /** The problem's stable `code` (`invalid_parameter`, `not_covered`, `plan_required` …). */
     code, 
-    /** The parsed JSON error body, kept whole (`readiness`, the subject's fields) for `--json`. */
+    /** The parsed error body, kept whole (`request_id`, `param`, `errors[]`, `docs_url`) for `--json`. */
     body) {
         super(message);
         this.statusCode = statusCode;
@@ -22,14 +30,48 @@ export class ApiError extends Error {
         this.name = 'ApiError';
     }
 }
+/** A command line `invd` refuses before any request (wrong value, missing argument, a needed `--yes`). Exit 2. */
+export class UsageError extends Error {
+    exitCode = EXIT.usage;
+    constructor(message) {
+        super(message);
+        this.name = 'UsageError';
+    }
+}
+/** No API key anywhere (`INVD_API_KEY`, `.env`, keychain, config). Exit 4. */
+export class AuthRequiredError extends Error {
+    exitCode = EXIT.auth;
+    constructor(message = 'No API key configured. Run: invd auth login') {
+        super(message);
+        this.name = 'AuthRequiredError';
+    }
+}
+/**
+ * Part of the answer was written, the rest failed: `--all` stopped on a page after earlier pages were printed
+ * (`cursor` resumes it). Exit 3, so a script can resume exactly these.
+ */
+export class PartialResultError extends Error {
+    cause;
+    written;
+    cursor;
+    exitCode = EXIT.partial;
+    constructor(cause, written, cursor) {
+        const reason = cause instanceof Error ? cause.message : String(cause);
+        super(`Stopped after ${written} row(s): ${reason}${cursor ? ` — resume with --cursor ${cursor}` : ''}`);
+        this.cause = cause;
+        this.written = written;
+        this.cursor = cursor;
+        this.name = 'PartialResultError';
+    }
+}
 /**
  * A download whose bytes stopped short of the length the server announced: nothing was saved (the `.part` file is
- * removed). Exit code 4, apart from an ordinary failure (1), so a script can retry exactly these.
+ * removed). Exit 3 (partial), so a script can retry exactly these.
  */
 export class PartialDownloadError extends Error {
     received;
     expected;
-    exitCode = 4;
+    exitCode = EXIT.partial;
     constructor(received, expected) {
         const of = expected === undefined ? 'of an unknown length' : `of ${expected}`;
         super(`Partial download: received ${received} bytes ${of}; nothing was saved (run the command again)`);
@@ -38,14 +80,47 @@ export class PartialDownloadError extends Error {
         this.name = 'PartialDownloadError';
     }
 }
-/** Saved bytes that do not match the size / SHA-256 / media type the API stated: nothing was saved. Exit code 5. */
+/** Saved bytes that do not match the size / SHA-256 / media type the API stated: nothing was saved. Exit 5. */
 export class IntegrityError extends Error {
-    exitCode = 5;
+    exitCode = EXIT.integrity;
     constructor(message) {
         super(message);
         this.name = 'IntegrityError';
     }
 }
+/** Problem `code`s with their own exit code; any other API error exits 1. */
+const CODE_EXIT = {
+    invalid_parameter: EXIT.usage,
+    unknown_parameter: EXIT.usage,
+    cursor_mismatch: EXIT.usage,
+    unauthorized: EXIT.auth,
+    forbidden: EXIT.auth,
+    plan_required: EXIT.credits,
+    insufficient_credits: EXIT.credits,
+};
+/** The process exit code of an error (`ApiError` by its problem `code`, else its status). */
+export function exitCodeFor(error) {
+    if (error instanceof ApiError) {
+        const byCode = error.code ? CODE_EXIT[error.code] : undefined;
+        if (byCode !== undefined)
+            return byCode;
+        if (error.statusCode === 401)
+            return EXIT.auth;
+        if (error.statusCode === 402)
+            return EXIT.credits;
+        return EXIT.failure;
+    }
+    if (error instanceof Error && 'exitCode' in error && typeof error.exitCode === 'number')
+        return error.exitCode;
+    return EXIT.failure;
+}
+/** Commander's own exits: help and version keep their code (0, or 1 for help shown on a bare group); anything else is usage (2). */
+export function exitCodeOfCommanderError(error) {
+    if (['commander.helpDisplayed', 'commander.version', 'commander.help', 'commander.executeSubCommandAsync'].includes(error.code)) {
+        return error.exitCode;
+    }
+    return EXIT.usage;
+}
 /** `Retry-After` as delay-seconds or an HTTP date → milliseconds from `now`; `undefined` when unreadable. */
 export function parseRetryAfter(value, now = Date.now()) {
     if (!value?.trim())
@@ -56,44 +131,57 @@ export function parseRetryAfter(value, now = Date.now()) {
     const date = Date.parse(value);
     return Number.isNaN(date) ? undefined : Math.max(0, date - now);
 }
-/**
- * One dim line after an `ApiError` a person can act on: a 401 points at `invd login`, a 403 whose message names the
- * plan a route needs ("requires the PRO plan") names that plan.
- */
-export function apiErrorHint(error) {
-    if (error.statusCode === 401)
-        return 'Run: invd login';
-    if (error.statusCode !== 403)
+const field = (body, key) => {
+    if (typeof body !== 'object' || body === null)
         return undefined;
-    const tier = /requires (?:the )?(\w+) plan/i.exec(error.message)?.[1];
-    return tier ? `This route needs the ${tier} plan` : undefined;
+    const value = Reflect.get(body, key);
+    return typeof value === 'string' && value !== '' ? value : undefined;
+};
+/** One dim line after an `ApiError` a person can act on. */
+export function apiErrorHint(error) {
+    if (error.code === 'unauthorized' || error.statusCode === 401)
+        return 'Run: invd auth login';
+    if (error.code === 'plan_required')
+        return `This operation needs a higher plan: ${field(error.body, 'docs_url') ?? 'invd me show'}`;
+    if (error.code === 'insufficient_credits')
+        return 'Credits exhausted for this period: invd me show';
+    if (error.code === 'not_covered')
+        return 'Find the company: invd companies list --q <name>';
+    return field(error.body, 'docs_url');
+}
+/** Prints an error the way every command does (red line, detail, hint, the problem as JSON under `--json`). */
+export function printError(error) {
+    if (error instanceof ApiError) {
+        const code = error.code && error.code !== error.errorType ? ` (${error.code})` : '';
+        console.error(chalk.red(`Error ${error.statusCode}: ${error.errorType}${code}`));
+        console.error(error.message);
+        const requestId = field(error.body, 'request_id');
+        if (requestId)
+            console.error(chalk.dim(`request id: ${requestId}`));
+        const line = apiErrorHint(error);
+        if (line)
+            console.error(chalk.dim(line));
+        if (isJsonMode() && error.body !== undefined && error.body !== null) {
+            // The problem body (code, param, errors[], request_id) as one JSON line, for scripts.
+            console.error(JSON.stringify(typeof error.body === 'object' ? error.body : { status: error.statusCode, body: error.body }));
+        }
+    }
+    else if (error instanceof Error) {
+        console.error(chalk.red('Error:'), error.message);
+    }
+    else {
+        console.error(chalk.red('An unexpected error occurred'));
+    }
 }
-/** `hint` may add one dim line after an `ApiError` (e.g. which plan a route needs). */
-export function withErrorHandling(fn, hint) {
+/** Wraps a command action: a thrown error is printed and becomes the process's exit code. */
+export function withErrorHandling(fn) {
     return async (...args) => {
         try {
             await fn(...args);
         }
         catch (error) {
-            if (error instanceof ApiError) {
-                const code = error.code && error.code !== error.errorType ? ` (${error.code})` : '';
-                console.error(chalk.red(`Error ${error.statusCode}: ${error.errorType}${code}`));
-                console.error(error.message);
-                const line = hint?.(error);
-                if (line)
-                    console.error(chalk.dim(line));
-                if (isJsonMode() && error.body !== undefined && error.body !== null) {
-                    // The structured answer (state, code, readiness, the subject's fields) as one JSON line, for scripts.
-                    console.error(JSON.stringify({ status: error.statusCode, ...(typeof error.body === 'object' ? error.body : { body: error.body }) }));
-                }
-            }
-            else if (error instanceof Error) {
-                console.error(chalk.red('Error:'), error.message);
-            }
-            else {
-                console.error(chalk.red('An unexpected error occurred'));
-            }
-            process.exit(error instanceof PartialDownloadError || error instanceof IntegrityError ? error.exitCode : 1);
+            printError(error);
+            process.exit(exitCodeFor(error));
         }
     };
 }

package/dist/src/shared/errors.js.map

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

package/dist/src/shared/prompt.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Asks before something costly or destructive. `--yes` answers for the person; `--no-input` (or no terminal on
+ * stdin, e.g. CI) refuses with exit 2 instead of waiting for an answer nobody can give.
+ */
+export declare function confirmOrRefuse(question: string, flags: {
+    yes?: boolean;
+    input?: boolean;
+}): Promise<void>;
+/** Reads all of stdin as text (`--body-file -`, `auth login --with-token`). */
+export declare function readStdin(): Promise<string>;

package/dist/src/shared/prompt.js

@@ -0,0 +1,24 @@
+import { UsageError } from './errors.js';
+/**
+ * Asks before something costly or destructive. `--yes` answers for the person; `--no-input` (or no terminal on
+ * stdin, e.g. CI) refuses with exit 2 instead of waiting for an answer nobody can give.
+ */
+export async function confirmOrRefuse(question, flags) {
+    if (flags.yes)
+        return;
+    if (flags.input === false || !process.stdin.isTTY) {
+        throw new UsageError(`${question} Pass --yes to go ahead without a prompt.`);
+    }
+    const { default: Enquirer } = await import('enquirer');
+    const answer = await new Enquirer().prompt({ type: 'confirm', name: 'ok', message: question, initial: false });
+    if (!answer.ok)
+        throw new UsageError('Cancelled.');
+}
+/** Reads all of stdin as text (`--body-file -`, `auth login --with-token`). */
+export async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
+    return Buffer.concat(chunks).toString('utf8');
+}
+//# sourceMappingURL=prompt.js.map

package/dist/src/shared/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/shared/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,KAAyC;IAC/F,IAAI,KAAK,CAAC,GAAG;QAAE,OAAO;IACtB,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAClD,MAAM,IAAI,UAAU,CAAC,GAAG,QAAQ,2CAA2C,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAoB,CAAC;IAClI,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;AACrD,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClH,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC"}

package/dist/src/shared/spinner.js

@@ -6,7 +6,8 @@ export function setJsonMode(enabled) {
     setJsonOutput(enabled);
 }
 export function createSpinner(text) {
-    if (jsonMode) {
+    // Progress is for a person watching a terminal: silent under --json and when stderr is not a terminal.
+    if (jsonMode || !process.stderr.isTTY) {
         return ora({ text, isSilent: true });
     }
     return ora(text).start();

package/dist/src/shared/spinner.js.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../../src/shared/spinner.ts"],"names":[],"mappings":"AAAA,OAAO,GAAiB,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,QAAQ,GAAG,OAAO,CAAC;IACnB,aAAa,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../../src/shared/spinner.ts"],"names":[],"mappings":"AAAA,OAAO,GAAiB,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,QAAQ,GAAG,OAAO,CAAC;IACnB,aAAa,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,uGAAuG;IACvG,IAAI,QAAQ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACtC,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/src/spec-commands.d.ts

@@ -1,10 +1,18 @@
 import { Command } from 'commander';
-import { type Manifest } from './spec-manifest.js';
+import { type QueryValue } from './client/api-client.js';
+import { type Manifest, type ManifestParam } from './spec-manifest.js';
 /**
- * Registers every manifest operation as `invd <group> <action>` (`action: ""` → `invd <group>`): one flag per
- * parameter (path parameters included, never positional), values validated before any request, the request through
- * `apiGet` / `apiRequest` (keyless where the spec says so), `--all` by the operation's pagination, and the operation's
- * view as the human output. A group a hand-written command already registered (`earnings`, whose download commands
- * are rostered in `src/hand-written-commands.ts`) gets the generated actions attached; commander refuses a duplicate.
+ * Registers the manifest's operations: `invd <group> <action>` (a group's `list` is its default, so
+ * `invd filings AAPL` lists), one positional for the natural key, one flag per parameter, the output / paging /
+ * metering flags, and `invd financials` as ONE command over its six operations (`--basis` × `--view`).
  */
 export declare function registerSpecCommands(program: Command, manifest: Manifest): void;
+/** One flag value validated and converted to what goes on the wire; refuses by flag name (exit 2). */
+export declare function wireValue(param: ManifestParam, raw: unknown): QueryValue;
+/** `2026Q3`, `2026 Q3`, `FY2026Q3` → fiscal year and quarter. */
+export declare function parseFiscalPeriod(text: string): {
+    fiscalYear: string;
+    fiscalQuarter: string;
+} | undefined;
+/** The yellow stderr line of a `meta.coverage` that is not complete (v2 readiness: a 200 with `state`). */
+export declare function coverageNote(body: unknown): string | undefined;