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

package/dist/src/hand-written-commands.d.ts

@@ -2,54 +2,24 @@
  * The commands `invd` writes by hand, each with WHY it is not one REST call plus one view. Every other command is
  * generated from the manifest (`src/spec-commands.ts`); `tests/unit/command-roster.test.ts` fails on a hand-written
  * command missing here, on an entry that registers nothing, and on an entry that is also a manifest operation.
- * An entry is a top-level command (`group`, covering its subcommands) or one `group action`.
+ * An entry is a top-level command (covering its subcommands).
  */
 export declare const HAND_WRITTEN_COMMANDS: readonly [{
-    readonly command: "login";
-    readonly reason: "Clerk PKCE sign-in in the browser, then the local credential store";
+    readonly command: "api";
+    readonly reason: "raw access to any spec path (method, -F fields, --paginate, --jq): the escape hatch when the tree lags the spec";
 }, {
-    readonly command: "logout";
-    readonly reason: "clears the local credential store";
+    readonly command: "auth";
+    readonly reason: "browser sign-in (loopback or pasted redirect), the local key store, status / token / logout";
 }, {
     readonly command: "config";
-    readonly reason: "local settings (API key, API host)";
+    readonly reason: "local settings in config.toml / ./.invd.toml";
 }, {
     readonly command: "plugin";
-    readonly reason: "copies the bundled Claude plugin into agent config dirs";
+    readonly reason: "copies the bundled agent plugin (skill, agent, commands) into agent config dirs";
 }, {
-    readonly command: "ws";
-    readonly reason: "WebSocket stream (/v1/ws); --earnings is the live transcript (src/client/earnings-live.ts), --news the news.live channel (src/client/news-live.ts)";
+    readonly command: "agent-setup";
+    readonly reason: "writes the MCP connector config and installs the skill in one step";
 }, {
-    readonly command: "earnings transcript";
-    readonly reason: "renders the transcript as text and saves it with -o";
-}, {
-    readonly command: "earnings press-release";
-    readonly reason: "prints the release text with --body and saves it with -o";
-}, {
-    readonly command: "earnings audio";
-    readonly reason: "downloads the recording from its URL with -o";
-}, {
-    readonly command: "earnings slides";
-    readonly reason: "downloads the deck PDF with -o, prints page markdown with --markdown";
-}, {
-    readonly command: "earnings documents";
-    readonly reason: "downloads every document into a directory with -o";
-}, {
-    readonly command: "earnings company-documents";
-    readonly reason: "downloads every stored file into a directory with -o";
-}, {
-    readonly command: "earnings document";
-    readonly reason: "downloads the file, or fetches and renders its page text with --pages";
-}, {
-    readonly command: "news get";
-    readonly reason: "prints the item and saves its PDF with --pdf-out";
-}, {
-    readonly command: "sec save";
-    readonly reason: "saves a filing's originals from their permanent public URLs (manifest size + SHA-256 verified) and lists every document it cannot save";
-}, {
-    readonly command: "sec save-figure";
-    readonly reason: "saves a cited figure's image from its permanent public URL";
-}, {
-    readonly command: "sec export-file";
-    readonly reason: "streams the key-authorized .csv.gz of GET /v1/sec/exports/{export_id}/file to disk, SHA-256 verified (the spec excludes it: binary)";
+    readonly command: "completion";
+    readonly reason: "prints the bash / zsh / fish completion script generated from the command tree and spec paths";
 }];

package/dist/src/hand-written-commands.js

@@ -2,24 +2,14 @@
  * The commands `invd` writes by hand, each with WHY it is not one REST call plus one view. Every other command is
  * generated from the manifest (`src/spec-commands.ts`); `tests/unit/command-roster.test.ts` fails on a hand-written
  * command missing here, on an entry that registers nothing, and on an entry that is also a manifest operation.
- * An entry is a top-level command (`group`, covering its subcommands) or one `group action`.
+ * An entry is a top-level command (covering its subcommands).
  */
 export const HAND_WRITTEN_COMMANDS = [
-    { command: 'login', reason: 'Clerk PKCE sign-in in the browser, then the local credential store' },
-    { command: 'logout', reason: 'clears the local credential store' },
-    { command: 'config', reason: 'local settings (API key, API host)' },
-    { command: 'plugin', reason: 'copies the bundled Claude plugin into agent config dirs' },
-    { command: 'ws', reason: 'WebSocket stream (/v1/ws); --earnings is the live transcript (src/client/earnings-live.ts), --news the news.live channel (src/client/news-live.ts)' },
-    { command: 'earnings transcript', reason: 'renders the transcript as text and saves it with -o' },
-    { command: 'earnings press-release', reason: 'prints the release text with --body and saves it with -o' },
-    { command: 'earnings audio', reason: 'downloads the recording from its URL with -o' },
-    { command: 'earnings slides', reason: 'downloads the deck PDF with -o, prints page markdown with --markdown' },
-    { command: 'earnings documents', reason: 'downloads every document into a directory with -o' },
-    { command: 'earnings company-documents', reason: 'downloads every stored file into a directory with -o' },
-    { command: 'earnings document', reason: 'downloads the file, or fetches and renders its page text with --pages' },
-    { command: 'news get', reason: 'prints the item and saves its PDF with --pdf-out' },
-    { command: 'sec save', reason: "saves a filing's originals from their permanent public URLs (manifest size + SHA-256 verified) and lists every document it cannot save" },
-    { command: 'sec save-figure', reason: "saves a cited figure's image from its permanent public URL" },
-    { command: 'sec export-file', reason: 'streams the key-authorized .csv.gz of GET /v1/sec/exports/{export_id}/file to disk, SHA-256 verified (the spec excludes it: binary)' },
+    { command: 'api', reason: 'raw access to any spec path (method, -F fields, --paginate, --jq): the escape hatch when the tree lags the spec' },
+    { command: 'auth', reason: 'browser sign-in (loopback or pasted redirect), the local key store, status / token / logout' },
+    { command: 'config', reason: 'local settings in config.toml / ./.invd.toml' },
+    { command: 'plugin', reason: 'copies the bundled agent plugin (skill, agent, commands) into agent config dirs' },
+    { command: 'agent-setup', reason: 'writes the MCP connector config and installs the skill in one step' },
+    { command: 'completion', reason: 'prints the bash / zsh / fish completion script generated from the command tree and spec paths' },
 ];
 //# sourceMappingURL=hand-written-commands.js.map

package/dist/src/hand-written-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"hand-written-commands.js","sourceRoot":"","sources":["../../src/hand-written-commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,oEAAoE,EAAE;IAClG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,mCAAmC,EAAE;IAClE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,oCAAoC,EAAE;IACnE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,yDAAyD,EAAE;IACxF,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,oJAAoJ,EAAE;IAC/K,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,qDAAqD,EAAE;IACjG,EAAE,OAAO,EAAE,wBAAwB,EAAE,MAAM,EAAE,0DAA0D,EAAE;IACzG,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,8CAA8C,EAAE;IACrF,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,sEAAsE,EAAE;IAC9G,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,mDAAmD,EAAE;IAC9F,EAAE,OAAO,EAAE,4BAA4B,EAAE,MAAM,EAAE,sDAAsD,EAAE;IACzG,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,uEAAuE,EAAE;IACjH,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,kDAAkD,EAAE;IACnF,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,wIAAwI,EAAE;IACzK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,4DAA4D,EAAE;IACpG,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,qIAAqI,EAAE;CACrK,CAAC"}
+{"version":3,"file":"hand-written-commands.js","sourceRoot":"","sources":["../../src/hand-written-commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iHAAiH,EAAE;IAC7I,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,6FAA6F,EAAE;IAC1H,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,8CAA8C,EAAE;IAC7E,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,iFAAiF,EAAE;IAChH,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,oEAAoE,EAAE;IACxG,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,+FAA+F,EAAE;CAC1H,CAAC"}

package/dist/src/output/jq.d.ts

@@ -0,0 +1,15 @@
+import { UsageError } from '../shared/errors.js';
+/**
+ * `--jq <expr>` without a jq dependency: a built-in subset — paths (`.a.b`, `."a-b"`, `.[0]`, `.[]`, `.a?`), pipes,
+ * `,`, `length`, `keys`, `select(<path> == <literal>)` (also `!= < <= > >=`, or a bare path for truthiness) and
+ * literals. An expression outside it goes to a `jq` binary on PATH when there is one, else it is a usage error.
+ * Results print like `jq -r`: strings raw, everything else as compact JSON.
+ */
+export declare class UnsupportedJqError extends UsageError {
+}
+/** The built-in evaluation; throws `UnsupportedJqError` outside the subset. */
+export declare function evaluateJq(expr: string, input: unknown): unknown[];
+/** One result as `jq -r` prints it. */
+export declare const jqLine: (value: unknown) => string;
+/** The output lines of `expr` over `input`: built-in, else a `jq` on PATH, else a usage error. */
+export declare function runJq(expr: string, input: unknown): string[];

package/dist/src/output/jq.js

@@ -0,0 +1,234 @@
+import { spawnSync } from 'node:child_process';
+import { UsageError } from '../shared/errors.js';
+/**
+ * `--jq <expr>` without a jq dependency: a built-in subset — paths (`.a.b`, `."a-b"`, `.[0]`, `.[]`, `.a?`), pipes,
+ * `,`, `length`, `keys`, `select(<path> == <literal>)` (also `!= < <= > >=`, or a bare path for truthiness) and
+ * literals. An expression outside it goes to a `jq` binary on PATH when there is one, else it is a usage error.
+ * Results print like `jq -r`: strings raw, everything else as compact JSON.
+ */
+export class UnsupportedJqError extends UsageError {
+}
+function tokenize(expr) {
+    const tokens = [];
+    let index = 0;
+    while (index < expr.length) {
+        const char = expr[index] ?? '';
+        if (/\s/.test(char)) {
+            index += 1;
+            continue;
+        }
+        const two = expr.slice(index, index + 2);
+        if (['==', '!=', '<=', '>='].includes(two)) {
+            tokens.push({ kind: 'op', value: two });
+            index += 2;
+            continue;
+        }
+        if ('.[]|,()?<>'.includes(char)) {
+            tokens.push({ kind: 'op', value: char });
+            index += 1;
+            continue;
+        }
+        if (char === '"') {
+            let end = index + 1;
+            let value = '';
+            while (end < expr.length && expr[end] !== '"') {
+                if (expr[end] === '\\')
+                    end += 1;
+                value += expr[end] ?? '';
+                end += 1;
+            }
+            if (end >= expr.length)
+                throw new UnsupportedJqError('unterminated string');
+            tokens.push({ kind: 'string', value });
+            index = end + 1;
+            continue;
+        }
+        const number = /^-?\d+(\.\d+)?/.exec(expr.slice(index));
+        if (number) {
+            tokens.push({ kind: 'number', value: number[0] });
+            index += number[0].length;
+            continue;
+        }
+        const ident = /^[A-Za-z_][A-Za-z0-9_]*/.exec(expr.slice(index));
+        if (ident) {
+            tokens.push({ kind: 'ident', value: ident[0] });
+            index += ident[0].length;
+            continue;
+        }
+        throw new UnsupportedJqError(`unexpected ${char}`);
+    }
+    return tokens;
+}
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+class Parser {
+    tokens;
+    index = 0;
+    constructor(tokens) {
+        this.tokens = tokens;
+    }
+    parse() {
+        const filter = this.pipe();
+        if (this.index < this.tokens.length)
+            throw new UnsupportedJqError(`unexpected ${this.tokens[this.index]?.value}`);
+        return filter;
+    }
+    peek(value) {
+        const token = this.tokens[this.index];
+        return token !== undefined && (value === undefined || (token.kind === 'op' && token.value === value));
+    }
+    take(value) {
+        if (!this.peek(value))
+            throw new UnsupportedJqError(`expected ${value}`);
+        this.index += 1;
+    }
+    pipe() {
+        let left = this.comma();
+        while (this.peek('|')) {
+            this.index += 1;
+            const first = left;
+            const right = this.comma();
+            left = input => first(input).flatMap(value => right(value));
+        }
+        return left;
+    }
+    comma() {
+        const parts = [this.term()];
+        while (this.peek(',')) {
+            this.index += 1;
+            parts.push(this.term());
+        }
+        return parts.length === 1 && parts[0] ? parts[0] : input => parts.flatMap(part => part(input));
+    }
+    literal() {
+        const token = this.tokens[this.index];
+        if (!token)
+            return NO_LITERAL;
+        if (token.kind === 'string') {
+            this.index += 1;
+            return token.value;
+        }
+        if (token.kind === 'number') {
+            this.index += 1;
+            return Number(token.value);
+        }
+        if (token.kind === 'ident' && ['true', 'false', 'null'].includes(token.value)) {
+            this.index += 1;
+            return token.value === 'null' ? null : token.value === 'true';
+        }
+        return NO_LITERAL;
+    }
+    term() {
+        const token = this.tokens[this.index];
+        if (!token)
+            throw new UnsupportedJqError('empty expression');
+        if (token.kind === 'op' && token.value === '.')
+            return this.path();
+        if (token.kind === 'ident' && token.value === 'length') {
+            this.index += 1;
+            return input => [Array.isArray(input) || typeof input === 'string' ? input.length : isRecord(input) ? Object.keys(input).length : 0];
+        }
+        if (token.kind === 'ident' && token.value === 'keys') {
+            this.index += 1;
+            return input => [isRecord(input) ? Object.keys(input).sort() : Array.isArray(input) ? input.map((_v, i) => i) : []];
+        }
+        if (token.kind === 'ident' && token.value === 'select') {
+            this.index += 1;
+            this.take('(');
+            const subject = this.path();
+            let compare;
+            const op = this.tokens[this.index];
+            if (op?.kind === 'op' && ['==', '!=', '<', '<=', '>', '>='].includes(op.value)) {
+                this.index += 1;
+                const expected = this.literal();
+                if (expected === NO_LITERAL)
+                    throw new UnsupportedJqError('select compares a path with a literal only');
+                compare = value => COMPARE[op.value]?.(value, expected) ?? false;
+            }
+            this.take(')');
+            return input => (subject(input).some(value => (compare ? compare(value) : value !== null && value !== false && value !== undefined)) ? [input] : []);
+        }
+        const literal = this.literal();
+        if (literal !== NO_LITERAL)
+            return () => [literal];
+        throw new UnsupportedJqError(`unsupported ${token.value}`);
+    }
+    /** `.`, then any of `name`, `"name"`, `[]`, `[n]`, `["name"]`, each optionally `?`. */
+    path() {
+        this.take('.');
+        const steps = [];
+        const key = (name) => (value) => {
+            if (typeof name === 'number')
+                return Array.isArray(value) ? [value.at(name) ?? null] : [null];
+            return [isRecord(value) ? value[name] ?? null : null];
+        };
+        const first = this.tokens[this.index];
+        if (first?.kind === 'ident' || first?.kind === 'string') {
+            this.index += 1;
+            steps.push(key(first.value));
+        }
+        for (;;) {
+            if (this.peek('?')) {
+                this.index += 1;
+                continue;
+            }
+            if (this.peek('.')) {
+                const next = this.tokens[this.index + 1];
+                if (next?.kind !== 'ident' && next?.kind !== 'string')
+                    break;
+                this.index += 2;
+                steps.push(key(next.value));
+                continue;
+            }
+            if (this.peek('[')) {
+                this.index += 1;
+                if (this.peek(']')) {
+                    this.index += 1;
+                    steps.push(value => (Array.isArray(value) ? value : isRecord(value) ? Object.values(value) : []));
+                    continue;
+                }
+                const inner = this.tokens[this.index];
+                if (inner?.kind !== 'number' && inner?.kind !== 'string')
+                    throw new UnsupportedJqError('unsupported index');
+                this.index += 1;
+                this.take(']');
+                steps.push(key(inner.kind === 'number' ? Number(inner.value) : inner.value));
+                continue;
+            }
+            break;
+        }
+        return input => steps.reduce((values, step) => values.flatMap(value => step(value)), [input]);
+    }
+}
+const NO_LITERAL = Symbol('no literal');
+const COMPARE = {
+    '==': (a, b) => JSON.stringify(a) === JSON.stringify(b),
+    '!=': (a, b) => JSON.stringify(a) !== JSON.stringify(b),
+    '<': (a, b) => a < b,
+    '<=': (a, b) => a <= b,
+    '>': (a, b) => a > b,
+    '>=': (a, b) => a >= b,
+};
+/** The built-in evaluation; throws `UnsupportedJqError` outside the subset. */
+export function evaluateJq(expr, input) {
+    return new Parser(tokenize(expr)).parse()(input);
+}
+/** One result as `jq -r` prints it. */
+export const jqLine = (value) => (typeof value === 'string' ? value : JSON.stringify(value));
+/** The output lines of `expr` over `input`: built-in, else a `jq` on PATH, else a usage error. */
+export function runJq(expr, input) {
+    try {
+        return evaluateJq(expr, input).map(jqLine);
+    }
+    catch (error) {
+        if (!(error instanceof UnsupportedJqError))
+            throw error;
+        const result = spawnSync('jq', ['-r', expr], { input: JSON.stringify(input), encoding: 'utf8' });
+        if (result.error) {
+            throw new UnsupportedJqError(`--jq ${expr}: ${error.message}; the built-in subset covers paths, [], |, ",", length, keys and select(); install jq for the full language`);
+        }
+        if (result.status !== 0)
+            throw new UsageError(`--jq: ${result.stderr.trim()}`);
+        return result.stdout.split('\n').filter((line, index, all) => line !== '' || index < all.length - 1);
+    }
+}
+//# sourceMappingURL=jq.js.map

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

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

package/dist/src/output/options.d.ts

@@ -0,0 +1,29 @@
+import { Command } from 'commander';
+import { type OutputSettings } from './render.js';
+/**
+ * The output / paging / metering flags every data command carries (the program uses positional options, so they are
+ * the command's own, never the root's): `--json [fields]`, `--output`, `--jq`, `--plain`, `--fields`, `--show-cost`,
+ * `--dry-run`, `--yes`, `--no-input`, and on a list `--all`.
+ */
+export declare function addOutputOptions(command: Command, opts: {
+    list: boolean;
+    fieldsParam?: boolean;
+}): Command;
+export interface OutputFlags {
+    json?: boolean | string;
+    output?: string;
+    jq?: string;
+    plain?: boolean;
+    fields?: string;
+    all?: boolean;
+    dryRun?: boolean;
+    yes?: boolean;
+    input?: boolean;
+    showCost?: boolean;
+}
+/** The output settings a command's flags ask for; `knownFields` checks `--json a,b`. */
+export declare function resolveOutput(flags: OutputFlags, opts?: {
+    knownFields?: readonly string[];
+    fieldsParam?: boolean;
+    list?: boolean;
+}): OutputSettings;

package/dist/src/output/options.js

@@ -0,0 +1,72 @@
+import { Option } from 'commander';
+import { splitList } from '../shared/options.js';
+import { UsageError } from '../shared/errors.js';
+import { setJsonMode } from '../shared/spinner.js';
+import { checkFields, defaultFormat, OUTPUT_FORMATS } from './render.js';
+/**
+ * The output / paging / metering flags every data command carries (the program uses positional options, so they are
+ * the command's own, never the root's): `--json [fields]`, `--output`, `--jq`, `--plain`, `--fields`, `--show-cost`,
+ * `--dry-run`, `--yes`, `--no-input`, and on a list `--all`.
+ */
+export function addOutputOptions(command, opts) {
+    command
+        .option('--json [fields]', 'Print JSON; with a comma list, only those fields of each row (see Fields below)')
+        .addOption(new Option('--output <format>', 'Output format').choices([...OUTPUT_FORMATS]))
+        .option('--jq <expr>', 'Filter the JSON with a jq expression (strings print raw)')
+        .option('--plain', 'Tab-separated rows without colour or decoration (the default when piped)')
+        .option('--fields <list>', opts.fieldsParam
+        ? 'Only these root fields (sent as fields=, pruned by the API)'
+        : 'Only these fields of each row (pruned locally)');
+    if (opts.list)
+        command.option('--all', 'Fetch every page (streams JSONL, or CSV with --output csv)');
+    command
+        .option('--dry-run', 'Print the request plan and its credit estimate; send nothing')
+        .option('--yes', 'Do not ask before a costly --all walk or a delete')
+        .option('--no-input', 'Never prompt (a confirmation that is needed fails instead)')
+        .option('--show-cost', 'Print the credits this command cost to stderr (or set INVD_SHOW_COST=1)');
+    return command;
+}
+/** The output settings a command's flags ask for; `knownFields` checks `--json a,b`. */
+export function resolveOutput(flags, opts = {}) {
+    const settings = { format: defaultFormat() };
+    if (flags.plain)
+        settings.format = 'plain';
+    if (flags.output)
+        settings.format = flags.output;
+    if (flags.json !== undefined && flags.json !== false) {
+        if (flags.output && flags.output !== 'json' && flags.output !== 'jsonl') {
+            throw new UsageError(`--json and --output ${flags.output} contradict each other`);
+        }
+        if (!flags.output)
+            settings.format = 'json';
+        if (typeof flags.json === 'string') {
+            const fields = splitList(flags.json);
+            if (fields.length === 0)
+                throw new UsageError('--json takes a comma list of fields, or nothing');
+            checkFields(fields, opts.knownFields ?? []);
+            settings.select = fields;
+        }
+    }
+    if (flags.jq !== undefined) {
+        if (settings.format !== 'json' && settings.format !== 'jsonl' && (flags.output || flags.plain)) {
+            throw new UsageError('--jq prints JSON; it cannot be combined with --output table|plain|csv');
+        }
+        settings.jq = flags.jq;
+    }
+    if (flags.fields !== undefined && opts.fieldsParam)
+        settings.order = splitList(flags.fields);
+    if (flags.fields !== undefined && !opts.fieldsParam) {
+        const fields = splitList(flags.fields);
+        checkFields(fields, opts.knownFields ?? [], '--fields');
+        settings.prune = fields;
+    }
+    // --all streams: JSON becomes one row per line.
+    if (flags.all && settings.format === 'json')
+        settings.format = 'jsonl';
+    if (flags.all && !flags.output && !flags.plain && flags.json === undefined && !flags.jq)
+        settings.format = 'jsonl';
+    if (settings.format === 'json' || settings.format === 'jsonl' || settings.format === 'csv' || settings.jq)
+        setJsonMode(true);
+    return settings;
+}
+//# sourceMappingURL=options.js.map

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

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

package/dist/src/output/render.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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 declare const OUTPUT_FORMATS: readonly ["table", "plain", "json", "jsonl", "csv"];
+export type OutputFormat = (typeof OUTPUT_FORMATS)[number];
+export interface OutputSettings {
+    format: OutputFormat;
+    /** `--json a,b`: the fields each row (or the object) keeps. */
+    select?: string[];
+    /** `--fields a,b` on an operation without a `fields` parameter: pruned client-side like `select`. */
+    prune?: string[];
+    /** `--fields a,b` the API prunes (`fields=`): only the column order of table / plain / CSV output. */
+    order?: string[];
+    jq?: string;
+}
+export interface ShapeInfo {
+    list: boolean;
+    view: 'table' | 'keyValue' | 'json';
+    columns?: string[];
+}
+/** `NO_COLOR` turns colour off unless `FORCE_COLOR` asks for it (chalk reads `FORCE_COLOR` itself). */
+export declare function applyColorEnv(env?: NodeJS.ProcessEnv): void;
+/** A row reduced to `fields` (dotted paths kept as their dotted key). */
+export declare function selectFields(row: unknown, fields: readonly string[]): Record<string, unknown>;
+/** Fails on a `--json` field the operation's rows do not have, listing the ones they do. */
+export declare function checkFields(fields: readonly string[], known: readonly string[], flag?: string): void;
+/** The body with `select` / `prune` applied to its rows (a list keeps its envelope) or to the object. */
+export declare function shapeBody(body: unknown, shape: ShapeInfo, settings: OutputSettings): unknown;
+export declare function tableText(rows: Record<string, unknown>[], columns?: readonly string[]): string;
+export declare function plainText(rows: Record<string, unknown>[], columns?: readonly string[]): string;
+export declare function keyValueText(row: Record<string, unknown>): string;
+/** The CSV columns of some rows: every key, first-seen order. */
+export declare const csvColumns: (rows: unknown[]) => string[];
+export declare const csvHeader: (columns: readonly string[]) => string;
+export declare const csvRow: (row: unknown, columns: readonly string[]) => string;
+/** The rows a body contributes to JSONL / CSV: a list's `data[]`, else the object itself. */
+export declare const bodyRows: (body: unknown, shape: ShapeInfo) => unknown[];
+/** The human view of one body: the operation's columns as a table / key-value list, else indented JSON. */
+export declare function humanText(body: unknown, shape: ShapeInfo, settings: OutputSettings): string;
+/** The whole text of one (non-streamed) body in the chosen format. */
+export declare function renderBody(body: unknown, shape: ShapeInfo, settings: OutputSettings): string;
+/** The pager command for human output: `INVD_PAGER` / config `pager`, else `PAGER`; `''` / `cat` = none. */
+export declare function pagerCommand(env?: NodeJS.ProcessEnv): string | 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 declare function emit(text: string, opts?: {
+    human?: boolean;
+}): void;
+/** The format when none was asked for: the `output` setting, else `table` on a terminal and `plain` in a pipe. */
+export declare function defaultFormat(): OutputFormat;