@invinite-org/invinite-data-cli 0.3.4 → 0.5.0

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

@@ -0,0 +1,43 @@
+/**
+ * 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`.
+ */
+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: "logout";
+    readonly reason: "clears the local credential store";
+}, {
+    readonly command: "config";
+    readonly reason: "local settings (API key, API host)";
+}, {
+    readonly command: "plugin";
+    readonly reason: "copies the bundled Claude plugin into agent config dirs";
+}, {
+    readonly command: "ws";
+    readonly reason: "WebSocket stream (/v1/ws); --earnings is the live transcript (src/client/earnings-live.ts)";
+}, {
+    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 signed 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";
+}];

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

@@ -0,0 +1,21 @@
+/**
+ * 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`.
+ */
+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)' },
+    { 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 signed 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' },
+];
+//# sourceMappingURL=hand-written-commands.js.map

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

@@ -0,0 +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,4FAA4F,EAAE;IACvH,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,qDAAqD,EAAE;IAC5F,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;CACzG,CAAC"}

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

@@ -3,5 +3,10 @@ export declare class ApiError extends Error {
     errorType: string;
     constructor(statusCode: number, errorType: string, message: string);
 }
+/**
+ * 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 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>;

package/dist/src/shared/errors.js

@@ -9,6 +9,18 @@ export class ApiError extends Error {
         this.name = 'ApiError';
     }
 }
+/**
+ * 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)
+        return undefined;
+    const tier = /requires (?:the )?(\w+) plan/i.exec(error.message)?.[1];
+    return tier ? `This route needs the ${tier} plan` : undefined;
+}
 /** `hint` may add one dim line after an `ApiError` (e.g. which plan a route needs). */
 export function withErrorHandling(fn, hint) {
     return async (...args) => {

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

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,OAAO,QAAS,SAAQ,KAAK;IAExB;IACA;IAFT,YACS,UAAkB,EAClB,SAAiB,EACxB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,eAAU,GAAV,UAAU,CAAQ;QAClB,cAAS,GAAT,SAAS,CAAQ;QAIxB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAC/B,EAAqC,EACrC,IAA8C;IAE9C,OAAO,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;gBAC1E,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC7B,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;gBAC3B,IAAI,IAAI;oBAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3C,CAAC;iBAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,OAAO,QAAS,SAAQ,KAAK;IAExB;IACA;IAFT,YACS,UAAkB,EAClB,SAAiB,EACxB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,eAAU,GAAV,UAAU,CAAQ;QAClB,cAAS,GAAT,SAAS,CAAQ;QAIxB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAe;IAC1C,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG;QAAE,OAAO,iBAAiB,CAAC;IACvD,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,IAAI,GAAG,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,CAAC,CAAC,wBAAwB,IAAI,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAChE,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAC/B,EAAqC,EACrC,IAA8C;IAE9C,OAAO,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;gBAC1E,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC7B,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;gBAC3B,IAAI,IAAI;oBAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3C,CAAC;iBAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

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

@@ -1,15 +1,2 @@
-import { Option } from 'commander';
-export declare const identifierOption: Option;
-export declare const identifiersOption: Option;
-export declare const periodOption: Option;
-export declare const sortOption: Option;
-export declare const limitOption: Option;
-export declare const offsetOption: Option;
-export declare const startDateOption: Option;
-export declare const endDateOption: Option;
-export declare const queryOption: Option;
-export declare const cikOption: Option;
-export declare const jsonOption: Option;
-export declare const allOption: Option;
 /** A comma-separated option value → trimmed, de-duplicated, non-empty items. */
 export declare function splitList(value: string | undefined): string[];

package/dist/src/shared/options.js

@@ -1,16 +1,3 @@
-import { Option } from 'commander';
-export const identifierOption = new Option('-i, --identifier <ticker>', 'Ticker symbol or CIK').makeOptionMandatory();
-export const identifiersOption = new Option('-i, --identifiers <tickers>', 'Comma-separated ticker symbols or CIKs').makeOptionMandatory();
-export const periodOption = new Option('-p, --period <type>', 'Fiscal period type').choices(['quarterly', 'annual', 'ytd', 'ttm']).makeOptionMandatory();
-export const sortOption = new Option('-s, --sort <dir>', 'Sort direction').choices(['asc', 'desc']).default('desc');
-export const limitOption = new Option('-l, --limit <n>', 'Maximum results').default('10');
-export const offsetOption = new Option('--offset <n>', 'Pagination offset').default('0');
-export const startDateOption = new Option('--start-date <date>', 'Start date (YYYY-MM-DD)');
-export const endDateOption = new Option('--end-date <date>', 'End date (YYYY-MM-DD)');
-export const queryOption = new Option('-q, --query <text>', 'Search query').makeOptionMandatory();
-export const cikOption = new Option('--cik <cik>', 'Institution CIK').makeOptionMandatory();
-export const jsonOption = new Option('--json', 'Output raw JSON');
-export const allOption = new Option('--all', 'Auto-paginate through all results');
 /** A comma-separated option value → trimmed, de-duplicated, non-empty items. */
 export function splitList(value) {
     if (!value)

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

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/shared/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,MAAM,CAAC,2BAA2B,EAAE,sBAAsB,CAAC,CAAC,mBAAmB,EAAE,CAAC;AACtH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,MAAM,CAAC,6BAA6B,EAAE,wCAAwC,CAAC,CAAC,mBAAmB,EAAE,CAAC;AAC3I,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,qBAAqB,EAAE,oBAAoB,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC;AACzJ,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AACpH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACzF,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,MAAM,CAAC,qBAAqB,EAAE,yBAAyB,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC,mBAAmB,EAAE,CAAC;AAClG,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC,mBAAmB,EAAE,CAAC;AAC5F,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,mCAAmC,CAAC,CAAC;AAElF,gFAAgF;AAChF,MAAM,UAAU,SAAS,CAAC,KAAyB;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/shared/options.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,UAAU,SAAS,CAAC,KAAyB;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC"}

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

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+import type { Manifest } 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.
+ */
+export declare function registerSpecCommands(program: Command, manifest: Manifest): void;

package/dist/src/spec-commands.js

@@ -0,0 +1,207 @@
+import { readFile } from 'node:fs/promises';
+import { Option } from 'commander';
+import { z } from 'zod';
+import { apiGet, apiRequest } from './client/api-client.js';
+import { fetchAllCompanyPages, fetchAllTopPages } from './client/pagination.js';
+import { flattenRows, pick } from './formatters/flatten.js';
+import { formatJson } from './formatters/json-formatter.js';
+import { formatKeyValue, formatTable, printPaginationHint } from './formatters/table-formatter.js';
+import { apiErrorHint, withErrorHandling } from './shared/errors.js';
+import { splitList } from './shared/options.js';
+import { output } from './shared/output.js';
+import { setJsonMode } from './shared/spinner.js';
+import { flagName } from './spec-flags.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.
+ */
+export function registerSpecCommands(program, manifest) {
+    for (const group of manifest.groups) {
+        const operations = manifest.operations.filter(operation => operation.group === group.name);
+        const groupCommand = (program.commands.find(command => command.name() === group.name) ?? program.command(group.name))
+            .description(group.description);
+        for (const operation of operations) {
+            const command = operation.action === ''
+                ? groupCommand
+                : groupCommand.command(operation.action).description(operation.summary);
+            defineOperationCommand(command, operation);
+        }
+    }
+}
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+function paramOption(param) {
+    const long = `--${flagName(param.name)}`;
+    const value = param.type === 'boolean' ? '' : param.type === 'array' ? ' <list>' : ' <value>';
+    const notes = [];
+    if (param.type === 'array') {
+        notes.push(param.enum ? `comma-separated: ${param.enum.join(', ')}` : 'comma-separated');
+    }
+    if (param.default !== undefined)
+        notes.push(`default: ${JSON.stringify(param.default)}`);
+    const description = [param.description ?? '', notes.length ? `(${notes.join('; ')})` : '']
+        .filter(Boolean).join(' ');
+    const option = new Option(`${param.alias ? `-${param.alias}, ` : ''}${long}${value}`, description);
+    if (param.required)
+        option.makeOptionMandatory();
+    if (param.enum && param.type !== 'array')
+        option.choices(param.enum);
+    return option;
+}
+const itemSchema = (type, values) => {
+    if (values && values.length > 0)
+        return z.string().refine(value => values.includes(value));
+    if (type === 'integer')
+        return z.string().regex(/^-?\d+$/);
+    if (type === 'number')
+        return z.string().refine(value => value.trim() !== '' && Number.isFinite(Number(value)));
+    return z.string();
+};
+/** The zod check of one parameter's raw flag value, yielding what goes on the wire. */
+function paramSchema(param) {
+    if (param.type === 'boolean')
+        return z.boolean().transform(value => String(value));
+    if (param.type === 'array') {
+        return z.string().transform(value => splitList(value)).pipe(z.array(itemSchema(param.items, param.enum)).min(1));
+    }
+    if (param.type === 'integer' || param.type === 'number') {
+        return z.string().pipe(itemSchema(param.type, undefined)).transform(value => String(Number(value)));
+    }
+    return z.string();
+}
+function expectation(param) {
+    if (param.type === 'array') {
+        const item = param.enum ? `one of ${param.enum.join(', ')}` : param.items === 'string' ? 'a value' : `an ${param.items}`;
+        return `a comma-separated list, each item ${item}`;
+    }
+    if (param.type === 'integer')
+        return 'an integer';
+    if (param.type === 'number')
+        return 'a number';
+    if (param.type === 'boolean')
+        return 'no value';
+    return 'a value';
+}
+/** Every given flag validated and converted; refuses by flag name, before any request. */
+function wireValues(bindings, opts) {
+    const values = new Map();
+    for (const { param, option } of bindings) {
+        const raw = opts[option.attributeName()];
+        if (raw === undefined)
+            continue;
+        const parsed = paramSchema(param).safeParse(raw);
+        if (!parsed.success) {
+            throw new Error(`--${flagName(param.name)} expects ${expectation(param)} (got ${JSON.stringify(raw)})`);
+        }
+        values.set(param.name, parsed.data);
+    }
+    return values;
+}
+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');
+}
+/** `--body <json>` or `--body-file <path|->` → the parsed JSON body; `undefined` when neither was given. */
+async function requestBody(operation, opts) {
+    const inline = typeof opts.body === 'string' ? opts.body : undefined;
+    const file = typeof opts.bodyFile === 'string' ? opts.bodyFile : undefined;
+    if (inline !== undefined && file !== undefined)
+        throw new Error('Pass --body or --body-file, not both');
+    if (inline === undefined && file === undefined) {
+        if (operation.body?.required)
+            throw new Error('This command needs a JSON body: --body <json> or --body-file <path|->');
+        return undefined;
+    }
+    const [flag, text] = inline !== undefined
+        ? ['--body', inline]
+        : [`--body-file ${file}`, file === '-' ? await readStdin() : await readFile(file ?? '', 'utf8')];
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`${flag} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function nextUrlOf(operation, data) {
+    const path = operation.pagination === 'top' ? 'next_url'
+        : operation.pagination === 'perCompany' ? 'companies.0.next_url' : undefined;
+    const found = path ? pick(data, path) : undefined;
+    return typeof found === 'string' && found !== '' ? found : undefined;
+}
+function renderView(operation, data) {
+    if (operation.view === 'table') {
+        const found = operation.rowsPath ? pick(data, operation.rowsPath) : data;
+        const rows = Array.isArray(found) ? found : [];
+        formatTable(operation.columns ? flattenRows(rows, operation.columns) : rows.filter(isRecord), operation.columns);
+        printPaginationHint(nextUrlOf(operation, data));
+        return;
+    }
+    if (operation.view === 'keyValue') {
+        const target = operation.rowsPath ? pick(data, operation.rowsPath) : data;
+        if (!isRecord(target)) {
+            formatTable([]);
+            return;
+        }
+        formatKeyValue(operation.columns ? flattenRows([target], operation.columns)[0] : target);
+        return;
+    }
+    formatJson(data);
+}
+function defineOperationCommand(command, operation) {
+    const bindings = operation.params.map(param => ({ param, option: paramOption(param) }));
+    for (const { option } of bindings)
+        command.addOption(option);
+    if (operation.body) {
+        command.option('--body <json>', `JSON request body${operation.body.required ? ' (this or --body-file is required)' : ''}`);
+        command.option('--body-file <path>', 'Read the JSON request body from a file (- = stdin)');
+    }
+    command.action(withErrorHandling(async (_opts, invoked) => {
+        const globals = invoked.optsWithGlobals();
+        const json = globals.json === true;
+        if (json)
+            setJsonMode(true);
+        if (globals.all === true && operation.pagination === 'none') {
+            throw new Error(`invd ${[operation.group, operation.action].filter(Boolean).join(' ')} does not paginate; --all has nothing to fetch`);
+        }
+        const values = wireValues(bindings, invoked.opts());
+        const body = operation.body ? await requestBody(operation, invoked.opts()) : undefined;
+        const path = operation.path.replace(/\{([^}]+)\}/g, (_match, name) => {
+            const value = values.get(name);
+            return encodeURIComponent(typeof value === 'string' ? value : '');
+        });
+        const params = {};
+        for (const param of operation.params) {
+            if (param.in === 'query')
+                params[param.name] = values.get(param.name);
+        }
+        let data = operation.method === 'get'
+            ? await apiGet({ path, params, auth: operation.auth })
+            : await apiRequest({
+                auth: operation.auth,
+                method: operation.method === 'post' ? 'POST'
+                    : operation.method === 'put' ? 'PUT'
+                        : operation.method === 'patch' ? 'PATCH' : 'DELETE',
+                path,
+                params,
+                ...(body !== undefined ? { body } : {}),
+            });
+        if (globals.all === true) {
+            const itemsPaths = operation.allItemsPath ?? [];
+            data = operation.pagination === 'top'
+                ? await fetchAllTopPages(data, itemsPaths)
+                : await fetchAllCompanyPages(data, itemsPaths);
+        }
+        if (data === undefined) {
+            // A 204: nothing to show but that it worked.
+            if (!json)
+                console.log('Done.');
+            return;
+        }
+        output(data, { json }, () => renderView(operation, data));
+    }, apiErrorHint));
+}
+//# sourceMappingURL=spec-commands.js.map

package/dist/src/spec-commands.js.map

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

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

@@ -0,0 +1,6 @@
+/** A parameter's flag: `company_name` → `company-name` (shown as `--company-name`). */
+export declare function flagName(parameterName: string): string;
+/** Long flags `invd` owns itself: the program's globals, commander's own, and the body flags of a write. */
+export declare const RESERVED_FLAGS: readonly string[];
+/** Short flags commander owns (`-V`, `-h`). */
+export declare const RESERVED_ALIASES: readonly string[];

package/dist/src/spec-flags.js

@@ -0,0 +1,9 @@
+/** A parameter's flag: `company_name` → `company-name` (shown as `--company-name`). */
+export function flagName(parameterName) {
+    return parameterName.replace(/_/g, '-');
+}
+/** Long flags `invd` owns itself: the program's globals, commander's own, and the body flags of a write. */
+export const RESERVED_FLAGS = ['json', 'all', 'show-cost', 'version', 'help', 'body', 'body-file'];
+/** Short flags commander owns (`-V`, `-h`). */
+export const RESERVED_ALIASES = ['V', 'h'];
+//# sourceMappingURL=spec-flags.js.map

package/dist/src/spec-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-flags.js","sourceRoot":"","sources":["../../src/spec-flags.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,UAAU,QAAQ,CAAC,aAAqB;IAC5C,OAAO,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,4GAA4G;AAC5G,MAAM,CAAC,MAAM,cAAc,GAAsB,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AAEtH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC"}