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

package/dist/bin/invd.js

@@ -1,5 +1,14 @@
 #!/usr/bin/env node
+import { CommanderError } from 'commander';
 import { createProgram } from '../src/cli.js';
-const program = createProgram();
-program.parse();
+import { exitCodeOfCommanderError } from '../src/shared/errors.js';
+try {
+    await createProgram().parseAsync();
+}
+catch (error) {
+    // `exitOverride` turns commander's own exits into errors: help / version keep their code, a usage error is 2.
+    if (error instanceof CommanderError)
+        process.exit(exitCodeOfCommanderError(error));
+    throw error;
+}
 //# sourceMappingURL=invd.js.map

package/dist/bin/invd.js.map

@@ -1 +1 @@
-{"version":3,"file":"invd.js","sourceRoot":"","sources":["../../bin/invd.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;AAChC,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"invd.js","sourceRoot":"","sources":["../../bin/invd.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,IAAI,CAAC;IACH,MAAM,aAAa,EAAE,CAAC,UAAU,EAAE,CAAC;AACrC,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,8GAA8G;IAC9G,IAAI,KAAK,YAAY,cAAc;QAAE,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;IACnF,MAAM,KAAK,CAAC;AACd,CAAC"}

package/dist/src/cli.d.ts

@@ -7,4 +7,6 @@ export declare function packageVersion(): string;
  * `dist/src/generated/` in the build (`scripts/copy-manifest.mjs` puts it there — `tsc` copies no JSON).
  */
 export declare function loadManifest(): Manifest;
+/** The eight commands `invd --help` lists first. */
+export declare const TOP_COMMANDS: ReadonlyArray<[string, string]>;
 export declare function createProgram(): Command;

package/dist/src/cli.js

@@ -1,16 +1,17 @@
 import { createRequire } from 'node:module';
 import { Command } from 'commander';
-import { setJsonMode } from './shared/spinner.js';
 import { formatCreditUsage, takeCreditUsage } from './client/api-client.js';
+import { registerAgentSetupCommand } from './commands/agent-setup.js';
+import { registerApiCommand } from './commands/api.js';
+import { registerAuthCommands } from './commands/auth.js';
+import { registerCompletionCommand } from './commands/completion.js';
 import { registerConfigCommands } from './commands/config.js';
-import { registerEarningsCommands } from './commands/earnings.js';
-import { registerLoginCommands } from './commands/login.js';
-import { registerNewsCommands } from './commands/news.js';
 import { registerPluginCommands } from './commands/plugin.js';
-import { registerSecCommands } from './commands/sec.js';
-import { registerWsCommands } from './commands/ws.js';
+import { DASHBOARD_URL } from './config/config-manager.js';
+import { applyColorEnv } from './output/render.js';
 import { registerSpecCommands } from './spec-commands.js';
 import { parseManifest } from './spec-manifest.js';
+import { runUpdateNotifier } from './update-notifier.js';
 const PACKAGE_NAME = '@invinite-org/invinite-data-cli';
 /** `package.json` sits one level up under tsx (`src/cli.ts`), two in the build (`dist/src/cli.js`). */
 export function packageVersion() {
@@ -36,39 +37,57 @@ export function loadManifest() {
     manifest ??= parseManifest(createRequire(import.meta.url)('./generated/cli-manifest.json'));
     return manifest;
 }
+/** The eight commands `invd --help` lists first. */
+export const TOP_COMMANDS = [
+    ['invd financials AAPL --period quarterly --limit 4', 'statements (standardized / as-reported; --view detailed)'],
+    ['invd companies get AAPL', 'company profile'],
+    ['invd filings AAPL --form 10-K', 'SEC filings'],
+    ['invd events AAPL', 'earnings calls (calendar and history)'],
+    ['invd events transcript AAPL 2026Q3', 'a call transcript by fiscal period'],
+    ['invd holdings AAPL', '13F holders (or --filer <cik>)'],
+    ['invd insider-trades AAPL', 'Form 4 trades'],
+    ['invd search filings "supply chain risk" --company AAPL', 'full-text search (also transcripts, news)'],
+];
+function topHelp() {
+    const width = Math.max(...TOP_COMMANDS.map(([command]) => command.length));
+    return [
+        'Most used:',
+        ...TOP_COMMANDS.map(([command, what]) => `  ${command.padEnd(width)}  ${what}`),
+        '',
+        'Output: table on a terminal, tab-separated when piped; --json [fields], --output json|jsonl|csv, --jq, --all.',
+        `Docs: ${DASHBOARD_URL}/docs/cli · keys and usage: ${DASHBOARD_URL}`,
+        '',
+    ].join('\n');
+}
+const EXIT_HELP = '\nExit codes: 0 ok · 1 failure · 2 usage · 3 partial · 4 auth required · 5 integrity · 6 credits / plan\n';
 export function createProgram() {
     const program = new Command();
+    applyColorEnv();
     program
         .name('invd')
-        .description('CLI for the Invinite financial data API')
-        .version(packageVersion())
-        .option('--json', 'Output raw JSON (pipe-friendly)')
-        .option('--all', 'Auto-paginate through all results')
-        .option('--show-cost', 'Print the credits a command cost to stderr (or set INVD_SHOW_COST=1)')
-        // Inherited by every group, so rostered and generated commands list alphabetically together.
+        .description('CLI for the Invinite financial data API (v2)')
+        .version(packageVersion(), '-V, --version')
+        // Root options only before the subcommand: an operation's own `--version` (a transcript version) is its own.
+        .enablePositionalOptions()
         .configureHelp({ sortSubcommands: true })
-        .hook('preAction', (thisCommand) => {
-        const opts = thisCommand.opts();
-        if (opts.json) {
-            setJsonMode(true);
-        }
-    })
-        .hook('postAction', (thisCommand) => {
+        .showSuggestionAfterError()
+        // Inherited by every command registered below: commander's usage errors become exit code 2 (bin/invd.ts).
+        .exitOverride()
+        .addHelpText('beforeAll', (context) => (context.command === program ? topHelp() : ''))
+        .addHelpText('after', EXIT_HELP)
+        .hook('postAction', async (_thisCommand, actionCommand) => {
         // Always drained, so a long-lived program never carries one command's cost into the next.
         const usage = takeCreditUsage();
-        if (!usage || !(thisCommand.opts().showCost || process.env.INVD_SHOW_COST === '1'))
-            return;
-        console.error(formatCreditUsage(usage));
+        if (usage && (actionCommand.opts().showCost || process.env.INVD_SHOW_COST === '1'))
+            console.error(formatCreditUsage(usage));
+        await runUpdateNotifier(packageVersion());
     });
-    // The hand-written roster (`src/hand-written-commands.ts`) first, then every manifest operation; a generated
-    // `earnings` / `news` / `sec` action attaches to the group its hand-written commands created.
-    registerLoginCommands(program);
+    registerAuthCommands(program);
     registerConfigCommands(program);
     registerPluginCommands(program);
-    registerWsCommands(program);
-    registerEarningsCommands(program);
-    registerNewsCommands(program);
-    registerSecCommands(program);
+    registerAgentSetupCommand(program);
+    registerApiCommand(program);
+    registerCompletionCommand(program, () => [...new Set(loadManifest().operations.map(operation => operation.path))].sort());
     registerSpecCommands(program, loadManifest());
     return program;
 }

package/dist/src/cli.js.map

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

package/dist/src/client/api-client.d.ts

@@ -1,37 +1,37 @@
+export type QueryValue = string | string[] | undefined;
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 export interface RequestOptions {
+    /** A path under the base URL (`/v2/filings`); a query string on it is kept. */
     path: string;
-    /** An array value is sent as a repeated parameter (`status=a&status=b`). */
-    params?: Record<string, string | string[] | undefined>;
+    method?: HttpMethod;
+    /** An array value is sent as a repeated parameter (`a=1&a=2`); `undefined` / `''` are dropped. */
+    query?: Record<string, QueryValue>;
+    headers?: Record<string, string>;
+    /** Sent as JSON. */
+    body?: unknown;
     silent?: boolean;
     /** `false` for a public operation: no API key is resolved or sent (default `true`). */
     auth?: boolean;
 }
+export interface ApiResponse<T = unknown> {
+    status: number;
+    headers: Headers;
+    /** The parsed JSON body; `undefined` on a 204 / empty body. */
+    body: T;
+}
+/** The request URL: base URL + path (+ its own query) + `query`. */
+export declare function buildUrl(path: string, query?: RequestOptions['query']): string;
 export interface CreditUsage {
     /** `X-Credits-Charged`, summed over every request of this invocation (`--all` pages included). */
     charged: number;
-    /**
-     * Included credits left AFTER the last metered request: the API's `X-Credits-Included-Remaining` is the allowance
-     * BEFORE that request's own charge, so its `X-Credits-Charged` is subtracted (floored at 0). `null` when no
-     * response carried the header (routes that skip the quota decision, e.g. `/v1/account/usage`).
-     */
-    includedRemaining: number | null;
+    /** The last `X-Credits-Remaining` (included credits left in the period); `null` when no response carried it. */
+    remaining: number | null;
+    requests: number;
 }
 /** What this invocation's requests cost so far, then reset; `null` when no response carried a credit header. */
 export declare function takeCreditUsage(): CreditUsage | null;
 export declare function formatCreditUsage(usage: CreditUsage): string;
-export declare function apiGet<T = unknown>(opts: RequestOptions): Promise<T>;
-/**
- * A key-authorized byte stream (`GET /v1/sec/exports/{export_id}/file`): the raw `Response` for the caller to stream
- * and verify, credits recorded, a refusal thrown as `ApiError` like every other request. `signal` aborts it.
- */
-export declare function apiDownload(opts: RequestOptions & {
-    accept: string;
-    signal?: AbortSignal;
-}): Promise<Response>;
-export interface ApiRequestOptions extends RequestOptions {
-    method: 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-    /** Sent as JSON. */
-    body?: unknown;
-}
-/** A write with a JSON body; same auth / `ApiError` handling as `apiGet`. A 204 / empty body → `undefined`. */
-export declare function apiRequest<T = unknown>(opts: ApiRequestOptions): Promise<T>;
+/** One request. A non-2xx answer throws `ApiError`; the body is parsed as JSON when there is one. */
+export declare function apiCall<T = unknown>(opts: RequestOptions): Promise<ApiResponse<T>>;
+/** A GET's body. */
+export declare function apiGet<T = unknown>(opts: Omit<RequestOptions, 'method' | 'body'>): Promise<T>;

package/dist/src/client/api-client.js

@@ -2,42 +2,46 @@ import { getApiKey } from '../config/auth.js';
 import { getBaseUrl } from '../config/config-manager.js';
 import { ApiError, parseRetryAfter } from '../shared/errors.js';
 import { createSpinner } from '../shared/spinner.js';
-function buildUrl(path, params) {
+/** The request URL: base URL + path (+ its own query) + `query`. */
+export function buildUrl(path, query) {
     const base = getBaseUrl().replace(/\/+$/, '');
-    const url = new URL(`${base}${path}`);
-    if (params) {
-        for (const [key, value] of Object.entries(params)) {
-            for (const item of Array.isArray(value) ? value : [value]) {
-                if (item !== undefined && item !== '') {
-                    url.searchParams.append(key, item);
-                }
-            }
+    const url = new URL(`${base}${path.startsWith('/') ? path : `/${path}`}`);
+    for (const [key, value] of Object.entries(query ?? {})) {
+        for (const item of Array.isArray(value) ? value : [value]) {
+            if (item !== undefined && item !== '')
+                url.searchParams.append(key, item);
         }
     }
     return url.toString();
 }
-const stringField = (body, key) => {
+const text = (body, key) => {
     if (typeof body !== 'object' || body === null)
         return undefined;
     const value = Reflect.get(body, key);
     return typeof value === 'string' && value !== '' ? value : undefined;
 };
+/** A refused answer → `ApiError`: problem+json (`title`, `detail`, `code`), else the 3.x `{error, message}`. */
 async function apiErrorFrom(response) {
-    const body = await response.json().catch(() => null);
-    return new ApiError(response.status, stringField(body, 'error') ?? (response.statusText || 'Unknown Error'), stringField(body, 'message') ?? `Request failed with status ${response.status}`, parseRetryAfter(response.headers?.get('Retry-After')), stringField(body, 'code'), body ?? undefined);
+    const raw = await response.text().catch(() => '');
+    let body = null;
+    try {
+        body = raw ? JSON.parse(raw) : null;
+    }
+    catch {
+        body = raw || null;
+    }
+    return new ApiError(response.status, text(body, 'title') ?? text(body, 'error') ?? (response.statusText || 'Unknown Error'), text(body, 'detail') ?? text(body, 'message') ?? `Request failed with status ${response.status}`, parseRetryAfter(response.headers?.get('Retry-After')), text(body, 'code'), body ?? undefined);
 }
 let creditUsage = null;
 function recordCredits(response) {
     const charged = response.headers?.get('X-Credits-Charged') ?? null;
-    const remaining = response.headers?.get('X-Credits-Included-Remaining') ?? null;
+    const remaining = response.headers?.get('X-Credits-Remaining') ?? null;
     if (charged === null && remaining === null)
         return;
-    const chargedCredits = Number(charged) || 0;
     creditUsage = {
-        charged: (creditUsage?.charged ?? 0) + chargedCredits,
-        includedRemaining: remaining === null
-            ? creditUsage?.includedRemaining ?? null
-            : Math.max(0, (Number(remaining) || 0) - chargedCredits),
+        charged: (creditUsage?.charged ?? 0) + (Number(charged) || 0),
+        remaining: remaining === null ? creditUsage?.remaining ?? null : Number(remaining) || 0,
+        requests: (creditUsage?.requests ?? 0) + 1,
     };
 }
 /** What this invocation's requests cost so far, then reset; `null` when no response carried a credit header. */
@@ -47,66 +51,44 @@ export function takeCreditUsage() {
     return usage;
 }
 export function formatCreditUsage(usage) {
-    return `credits: ${usage.charged} · included left: ${usage.includedRemaining ?? '—'}`;
-}
-async function request(opts, accept, init = {}) {
-    const url = buildUrl(opts.path, opts.params);
-    const headers = { 'Accept': accept };
-    if (opts.auth !== false)
-        headers['Authorization'] = `Bearer ${await getApiKey()}`;
-    if (init.body !== undefined)
-        headers['Content-Type'] = 'application/json';
-    const response = await fetch(url, {
-        headers,
-        ...(init.method ? { method: init.method } : {}),
-        ...(init.body !== undefined ? { body: JSON.stringify(init.body) } : {}),
-    });
-    recordCredits(response);
-    if (!response.ok) {
-        throw await apiErrorFrom(response);
-    }
-    return response;
+    return `credits: ${usage.charged} · remaining: ${usage.remaining ?? '—'}`;
 }
-export async function apiGet(opts) {
-    const spinner = opts.silent ? null : createSpinner('Fetching data...');
+/** One request. A non-2xx answer throws `ApiError`; the body is parsed as JSON when there is one. */
+export async function apiCall(opts) {
+    const spinner = opts.silent ? null : createSpinner(opts.method && opts.method !== 'GET' ? 'Sending request...' : 'Fetching data...');
     try {
-        const response = await request(opts, 'application/json');
-        const body = await response.json();
+        const url = buildUrl(opts.path, opts.query);
+        const headers = { Accept: 'application/json', ...opts.headers };
+        if (opts.auth !== false)
+            headers.Authorization = `Bearer ${await getApiKey()}`;
+        if (opts.body !== undefined)
+            headers['Content-Type'] = 'application/json';
+        const response = await fetch(url, {
+            method: opts.method ?? 'GET',
+            headers,
+            ...(opts.body !== undefined ? { body: JSON.stringify(opts.body) } : {}),
+        });
+        recordCredits(response);
+        if (!response.ok)
+            throw await apiErrorFrom(response);
+        const raw = response.status === 204 ? '' : await response.text();
+        let body;
+        try {
+            body = raw ? JSON.parse(raw) : undefined;
+        }
+        catch {
+            body = raw;
+        }
         spinner?.succeed('Done');
-        return body;
+        return { status: response.status, headers: response.headers ?? new Headers(), body: body };
     }
     catch (error) {
         spinner?.fail('Failed');
         throw error;
     }
 }
-/**
- * A key-authorized byte stream (`GET /v1/sec/exports/{export_id}/file`): the raw `Response` for the caller to stream
- * and verify, credits recorded, a refusal thrown as `ApiError` like every other request. `signal` aborts it.
- */
-export async function apiDownload(opts) {
-    const url = buildUrl(opts.path, opts.params);
-    const headers = { 'Accept': opts.accept };
-    if (opts.auth !== false)
-        headers['Authorization'] = `Bearer ${await getApiKey()}`;
-    const response = await fetch(url, { headers, ...(opts.signal ? { signal: opts.signal } : {}) });
-    recordCredits(response);
-    if (!response.ok)
-        throw await apiErrorFrom(response);
-    return response;
-}
-/** A write with a JSON body; same auth / `ApiError` handling as `apiGet`. A 204 / empty body → `undefined`. */
-export async function apiRequest(opts) {
-    const spinner = opts.silent ? null : createSpinner('Sending request...');
-    try {
-        const response = await request(opts, 'application/json', { method: opts.method, body: opts.body });
-        const text = response.status === 204 ? '' : await response.text();
-        spinner?.succeed('Done');
-        return (text ? JSON.parse(text) : undefined);
-    }
-    catch (error) {
-        spinner?.fail('Failed');
-        throw error;
-    }
+/** A GET's body. */
+export async function apiGet(opts) {
+    return (await apiCall({ ...opts, method: 'GET' })).body;
 }
 //# sourceMappingURL=api-client.js.map

package/dist/src/client/api-client.js.map

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

package/dist/src/client/pagination.d.ts

@@ -1,5 +1,5 @@
+import { type ApiResponse, type RequestOptions } from './api-client.js';
 import { ApiError } from '../shared/errors.js';
-type NextUrlExtractor<T> = (data: T) => string | undefined;
 /**
  * How `--all` waits out a refused page instead of dropping the pages it already holds: a 429 (the API's admission
  * limit) or 503 is retried up to `retries` times, each after the answer's `Retry-After`, else `baseDelayMs * 2^n`,
@@ -12,15 +12,16 @@ export declare const PAGE_RETRY: {
 };
 /** The wait before retry number `retry` (0-based) of a refused page. */
 export declare function pageRetryDelayMs(error: ApiError, retry: number): number;
-export declare function fetchAllPages<T>(initialData: T, extractNextUrl: NextUrlExtractor<T>, mergeResults: (accumulated: T, page: T) => T): Promise<T>;
+/** The `rel="next"` target of a `Link` header, if any. */
+export declare function linkNext(header: string | null | undefined): string | undefined;
+/** A v2 list page's `next_cursor` (only while `has_more` is not false). */
+export declare function nextCursorOf(body: unknown): string | undefined;
+/** The rows of a v2 list page (`data[]`). */
+export declare const rowsOf: (body: unknown) => unknown[];
+/** The request of the page after `page`: `next_cursor` on the same request, else the `Link rel="next"` URL. */
+export declare function nextRequest(request: RequestOptions, page: ApiResponse): RequestOptions | undefined;
 /**
- * `--all` over a response that pages with a top-level `next_url`: every `itemsPaths` array is concatenated across
- * pages (a path a page does not carry adds nothing); the other fields come from the last page.
+ * Every page from `first` on, following `next_cursor` (or `Link rel="next"`) until `has_more` is false. A failure
+ * after the first page is thrown as is; the caller knows what it already wrote (`PartialResultError`).
  */
-export declare function fetchAllTopPages(initialData: unknown, itemsPaths: readonly string[]): Promise<unknown>;
-/**
- * `--all` over a multi-company response (`companies[].next_url`): follows `companies[0].next_url` and concatenates
- * each company's `itemsPaths` arrays by index, carrying each company's own `next_url` forward.
- */
-export declare function fetchAllCompanyPages(initialData: unknown, itemsPaths: readonly string[]): Promise<unknown>;
-export {};
+export declare function walkPages(request: RequestOptions, first: ApiResponse): AsyncGenerator<ApiResponse>;

package/dist/src/client/pagination.js

@@ -1,7 +1,6 @@
-import { apiGet } from './api-client.js';
+import { apiCall } from './api-client.js';
 import { ApiError } from '../shared/errors.js';
 import { createSpinner } from '../shared/spinner.js';
-import { pick } from '../formatters/flatten.js';
 /**
  * How `--all` waits out a refused page instead of dropping the pages it already holds: a 429 (the API's admission
  * limit) or 503 is retried up to `retries` times, each after the answer's `Retry-After`, else `baseDelayMs * 2^n`,
@@ -14,15 +13,43 @@ export function pageRetryDelayMs(error, retry) {
     return Math.min(PAGE_RETRY.maxDelayMs, error.retryAfterMs ?? PAGE_RETRY.baseDelayMs * 2 ** retry);
 }
 const sleep = (ms) => new Promise(done => setTimeout(done, ms));
-async function fetchPage(nextUrl, onWait) {
-    // nextUrl is absolute: re-issue its path + query against the configured base URL. Repeated keys
-    // (`status=a&status=b`) stay repeated.
-    const url = new URL(nextUrl);
-    const params = {};
-    url.searchParams.forEach((v, k) => { (params[k] ??= []).push(v); });
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** The `rel="next"` target of a `Link` header, if any. */
+export function linkNext(header) {
+    if (!header)
+        return undefined;
+    for (const part of header.split(',')) {
+        const match = /<([^>]+)>\s*;(.*)$/.exec(part.trim());
+        if (match?.[1] && /\brel\s*=\s*"?next"?/i.test(match[2] ?? ''))
+            return match[1];
+    }
+    return undefined;
+}
+/** A v2 list page's `next_cursor` (only while `has_more` is not false). */
+export function nextCursorOf(body) {
+    if (!isRecord(body) || body.has_more === false)
+        return undefined;
+    return typeof body.next_cursor === 'string' && body.next_cursor !== '' ? body.next_cursor : undefined;
+}
+/** The rows of a v2 list page (`data[]`). */
+export const rowsOf = (body) => (isRecord(body) && Array.isArray(body.data) ? body.data : []);
+/** The request of the page after `page`: `next_cursor` on the same request, else the `Link rel="next"` URL. */
+export function nextRequest(request, page) {
+    const cursor = nextCursorOf(page.body);
+    if (cursor)
+        return { ...request, query: { ...request.query, cursor } };
+    const link = linkNext(page.headers.get('Link'));
+    if (!link || (isRecord(page.body) && page.body.has_more === false))
+        return undefined;
+    const url = new URL(link, 'http://placeholder');
+    const query = {};
+    url.searchParams.forEach((value, key) => { (query[key] ??= []).push(value); });
+    return { ...request, path: url.pathname, query };
+}
+async function fetchPage(request, onWait) {
     for (let retry = 0;; retry += 1) {
         try {
-            return await apiGet({ path: url.pathname, params, silent: true });
+            return await apiCall({ ...request, silent: true });
         }
         catch (error) {
             if (!isRetryable(error) || retry >= PAGE_RETRY.retries)
@@ -33,65 +60,29 @@ async function fetchPage(nextUrl, onWait) {
         }
     }
 }
-export async function fetchAllPages(initialData, extractNextUrl, mergeResults) {
-    let result = initialData;
-    let nextUrl = extractNextUrl(result);
+/**
+ * Every page from `first` on, following `next_cursor` (or `Link rel="next"`) until `has_more` is false. A failure
+ * after the first page is thrown as is; the caller knows what it already wrote (`PartialResultError`).
+ */
+export async function* walkPages(request, first) {
+    yield first;
+    let next = nextRequest(request, first);
     let page = 1;
-    while (nextUrl) {
+    while (next) {
         page += 1;
         const spinner = createSpinner(`Fetching page ${page}...`);
         try {
-            const pageData = await fetchPage(nextUrl, (seconds, retry) => {
+            const current = await fetchPage(next, (seconds, retry) => {
                 spinner.text = `Page ${page} refused (rate limit) — retry ${retry}/${PAGE_RETRY.retries} in ${seconds}s...`;
             });
-            result = mergeResults(result, pageData);
-            nextUrl = extractNextUrl(pageData);
             spinner.succeed(`Page ${page} fetched`);
+            yield current;
+            next = nextRequest(next, current);
         }
         catch (error) {
             spinner.fail(`Page ${page} failed`);
             throw error;
         }
     }
-    return result;
-}
-const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
-const arrayAt = (value, path) => {
-    const found = pick(value, path);
-    return Array.isArray(found) ? found : [];
-};
-/** A copy of `target` with `value` at the dotted `path` (missing objects on the way are created). */
-function withValueAt(target, path, value) {
-    const [head, ...rest] = path.split('.');
-    if (rest.length === 0)
-        return { ...target, [head]: value };
-    const child = target[head];
-    return { ...target, [head]: withValueAt(isRecord(child) ? child : {}, rest.join('.'), value) };
-}
-const nextUrlAt = (value, path) => {
-    const found = pick(value, path);
-    return typeof found === 'string' && found !== '' ? found : undefined;
-};
-/**
- * `--all` over a response that pages with a top-level `next_url`: every `itemsPaths` array is concatenated across
- * pages (a path a page does not carry adds nothing); the other fields come from the last page.
- */
-export async function fetchAllTopPages(initialData, itemsPaths) {
-    return fetchAllPages(initialData, data => nextUrlAt(data, 'next_url'), (accumulated, page) => itemsPaths.reduce((merged, path) => withValueAt(merged, path, [...arrayAt(accumulated, path), ...arrayAt(page, path)]), isRecord(page) ? page : {}));
-}
-/**
- * `--all` over a multi-company response (`companies[].next_url`): follows `companies[0].next_url` and concatenates
- * each company's `itemsPaths` arrays by index, carrying each company's own `next_url` forward.
- */
-export async function fetchAllCompanyPages(initialData, itemsPaths) {
-    return fetchAllPages(initialData, data => nextUrlAt(data, 'companies.0.next_url'), (accumulated, page) => {
-        const base = isRecord(accumulated) ? accumulated : {};
-        const companies = arrayAt(accumulated, 'companies').map((company, index) => {
-            const pageCompany = pick(page, `companies.${index}`);
-            const merged = itemsPaths.reduce((acc, path) => withValueAt(acc, path, [...arrayAt(company, path), ...arrayAt(pageCompany, path)]), isRecord(company) ? company : {});
-            return { ...merged, next_url: pick(pageCompany, 'next_url') };
-        });
-        return { ...base, companies };
-    });
 }
 //# sourceMappingURL=pagination.js.map

package/dist/src/client/pagination.js.map

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