@invinite-org/invinite-data-cli 0.1.22 → 0.2.1

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

@@ -1,6 +1,18 @@
 export interface RequestOptions {
     path: string;
-    params?: Record<string, string | undefined>;
+    /** An array value is sent as a repeated parameter (`status=a&status=b`). */
+    params?: Record<string, string | string[] | undefined>;
     silent?: boolean;
 }
+/** Same auth / URL building as `apiGet`, without the JSON parse; a non-2xx throws `ApiError`. */
+export declare function apiGetRaw(opts: RequestOptions & {
+    accept?: string;
+}): Promise<Response>;
 export declare function apiGet<T = unknown>(opts: RequestOptions): Promise<T>;
+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>;

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

@@ -7,28 +7,47 @@ function buildUrl(path, params) {
     const url = new URL(`${base}${path}`);
     if (params) {
         for (const [key, value] of Object.entries(params)) {
-            if (value !== undefined && value !== '') {
-                url.searchParams.set(key, value);
+            for (const item of Array.isArray(value) ? value : [value]) {
+                if (item !== undefined && item !== '') {
+                    url.searchParams.append(key, item);
+                }
             }
         }
     }
     return url.toString();
 }
+async function apiErrorFrom(response) {
+    const body = await response.json().catch(() => null);
+    return new ApiError(response.status, body?.error || response.statusText || 'Unknown Error', body?.message || `Request failed with status ${response.status}`);
+}
+async function request(opts, accept, init = {}) {
+    const apiKey = await getApiKey();
+    const url = buildUrl(opts.path, opts.params);
+    const headers = {
+        'Authorization': `Bearer ${apiKey}`,
+        'Accept': accept,
+    };
+    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) } : {}),
+    });
+    if (!response.ok) {
+        throw await apiErrorFrom(response);
+    }
+    return response;
+}
+/** Same auth / URL building as `apiGet`, without the JSON parse; a non-2xx throws `ApiError`. */
+export async function apiGetRaw(opts) {
+    return request(opts, opts.accept ?? '*/*');
+}
 export async function apiGet(opts) {
     const spinner = opts.silent ? null : createSpinner('Fetching data...');
     try {
-        const apiKey = await getApiKey();
-        const url = buildUrl(opts.path, opts.params);
-        const response = await fetch(url, {
-            headers: {
-                'Authorization': `Bearer ${apiKey}`,
-                'Accept': 'application/json',
-            },
-        });
+        const response = await request(opts, 'application/json');
         const body = await response.json();
-        if (!response.ok) {
-            throw new ApiError(response.status, body?.error || 'Unknown Error', body?.message || `Request failed with status ${response.status}`);
-        }
         spinner?.succeed('Done');
         return body;
     }
@@ -37,4 +56,18 @@ export async function apiGet(opts) {
         throw error;
     }
 }
+/** 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;
+    }
+}
 //# 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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAQrD,SAAS,QAAQ,CAAC,IAAY,EAAE,MAA2C;IACzE,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;IACtC,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBACxC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAc,IAAoB;IAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACvE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,MAAM,EAAE;gBACnC,QAAQ,EAAE,kBAAkB;aAC7B;SACF,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAS,CAAC;QAE1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,QAAQ,CAChB,QAAQ,CAAC,MAAM,EACf,IAAI,EAAE,KAAK,IAAI,eAAe,EAC9B,IAAI,EAAE,OAAO,IAAI,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CACjE,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACzB,OAAO,IAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../../src/client/api-client.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,23 @@
+export interface SaveOptions {
+    /** Replace an existing file. */
+    force?: boolean;
+}
+/**
+ * Streams a presigned URL to disk. Plain fetch: NO Authorization header — the URL is a
+ * bearer URL and R2 would reject the extra header. Written through `writeViaPart`.
+ */
+export declare function downloadToFile(url: string, file: string, opts?: SaveOptions & {
+    spinnerText?: string;
+}): Promise<{
+    path: string;
+    bytes: number;
+}>;
+/** Writes text (transcript, press release) to `file`; refuses an existing target unless `force`. */
+export declare function writeTextFile(file: string, text: string, opts?: SaveOptions): Promise<{
+    path: string;
+    bytes: number;
+}>;
+/** `mkdir -p` of a directory target (`documents --output dir/`); returns its absolute path. */
+export declare function ensureDir(dir: string): Promise<string>;
+/** File extension for a `content_type` (parameters ignored); `bin` when unknown. */
+export declare function extensionFor(contentType: string | null | undefined): string;

package/dist/src/client/download.js

@@ -0,0 +1,116 @@
+import { createWriteStream, rmSync } from 'node:fs';
+import { access, mkdir, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { createSpinner } from '../shared/spinner.js';
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Resolves `file` against cwd and refuses an existing target unless `force`. */
+async function prepareTarget(file, opts) {
+    const path = resolve(file);
+    if (!opts.force && await exists(path)) {
+        throw new Error(`${path} already exists (use --force to overwrite)`);
+    }
+    await mkdir(dirname(path), { recursive: true });
+    return path;
+}
+/** Exit codes of the signals that abort a write (128 + signal number, as a shell reports them). */
+const ABORT_SIGNALS = { SIGINT: 130, SIGTERM: 143 };
+/**
+ * Runs `write(part, signal)` against `<path>.part` and renames it onto `path` on success, so a
+ * failed write never leaves a partial file or clobbers an existing one. While it runs, SIGINT /
+ * SIGTERM (Ctrl-C) abort `signal`, remove the `.part` file synchronously and exit with 130 / 143 —
+ * a listener replaces Node's default exit, which would skip the cleanup.
+ */
+async function writeViaPart(path, write) {
+    const part = `${path}.part`;
+    const controller = new AbortController();
+    const onSignal = (signal) => {
+        controller.abort();
+        rmSync(part, { force: true });
+        process.exit(ABORT_SIGNALS[signal]);
+    };
+    for (const signal of Object.keys(ABORT_SIGNALS))
+        process.once(signal, onSignal);
+    try {
+        await write(part, controller.signal);
+        await rename(part, path);
+    }
+    catch (error) {
+        await rm(part, { force: true });
+        throw error;
+    }
+    finally {
+        for (const signal of Object.keys(ABORT_SIGNALS))
+            process.off(signal, onSignal);
+    }
+}
+/**
+ * Streams a presigned URL to disk. Plain fetch: NO Authorization header — the URL is a
+ * bearer URL and R2 would reject the extra header. Written through `writeViaPart`.
+ */
+export async function downloadToFile(url, file, opts = {}) {
+    const path = await prepareTarget(file, opts);
+    const spinner = createSpinner(opts.spinnerText ?? 'Downloading...');
+    try {
+        await writeViaPart(path, async (part, signal) => {
+            const response = await fetch(url, { signal });
+            if (!response.ok || !response.body) {
+                throw new Error(`Download failed with status ${response.status}`);
+            }
+            await pipeline(Readable.fromWeb(response.body), createWriteStream(part), { signal });
+        });
+        const { size } = await stat(path);
+        spinner.succeed('Downloaded');
+        return { path, bytes: size };
+    }
+    catch (error) {
+        spinner.fail('Download failed');
+        throw error;
+    }
+}
+/** Writes text (transcript, press release) to `file`; refuses an existing target unless `force`. */
+export async function writeTextFile(file, text, opts = {}) {
+    const path = await prepareTarget(file, opts);
+    await writeViaPart(path, (part, signal) => writeFile(part, text, { encoding: 'utf8', signal }));
+    return { path, bytes: Buffer.byteLength(text, 'utf8') };
+}
+/** `mkdir -p` of a directory target (`documents --output dir/`); returns its absolute path. */
+export async function ensureDir(dir) {
+    const path = resolve(dir);
+    await mkdir(path, { recursive: true });
+    return path;
+}
+const EXTENSIONS = {
+    'application/pdf': 'pdf',
+    'text/html': 'html',
+    'text/plain': 'txt',
+    'text/csv': 'csv',
+    'application/json': 'json',
+    'application/xml': 'xml',
+    'text/xml': 'xml',
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document': 'docx',
+    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': 'xlsx',
+    'application/vnd.openxmlformats-officedocument.presentationml.presentation': 'pptx',
+    'application/msword': 'doc',
+    'application/vnd.ms-excel': 'xls',
+    'application/vnd.ms-powerpoint': 'ppt',
+    'image/png': 'png',
+    'image/jpeg': 'jpg',
+    'image/gif': 'gif',
+    'audio/mpeg': 'mp3',
+};
+/** File extension for a `content_type` (parameters ignored); `bin` when unknown. */
+export function extensionFor(contentType) {
+    const type = (contentType ?? '').split(';')[0].trim().toLowerCase();
+    return EXTENSIONS[type] ?? 'bin';
+}
+//# sourceMappingURL=download.js.map

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

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

package/dist/src/client/earnings-live.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Pure pieces of `invd ws listen --earnings`: the subscribe frame and one step per server
+ * frame of IDA's `earnings-calls.live` channel (`src/routes/websocket/types/earningsMessages.ts`).
+ */
+export declare const EARNINGS_LIVE_CHANNEL = "earnings-calls.live";
+/** One call (event ID / CIK), or every live call at once (`scope: "all_live"`, keywords required). */
+export type LiveTarget = {
+    event_id: string;
+} | {
+    cik: string;
+} | {
+    scope: 'all_live';
+};
+export declare const KEYWORD_MATCH_MODES: readonly ["exact", "stem"];
+export type KeywordMatch = (typeof KEYWORD_MATCH_MODES)[number];
+export declare const SPEAKER_ROLES: readonly ["executive", "ir_host", "analyst", "operator"];
+export type SpeakerRole = (typeof SPEAKER_ROLES)[number];
+/** Keyword alerts of the subscribe frame (`keywords` required for the global scope). */
+export interface KeywordOptions {
+    keywords: string[];
+    keywordMatch?: KeywordMatch;
+    speakerRoles?: SpeakerRole[];
+    /** Global scope only: companies ranked ≤ N by market cap. */
+    minRank?: number;
+}
+export interface KeywordHit {
+    cik: string;
+    symbol: string;
+    conference_date: string;
+    keyword: string;
+    seq: number;
+    start_ms: number;
+    end_ms: number;
+    text: string;
+    context_before: string;
+    speaker_label: string | null;
+    speaker_name: string | null;
+    speaker_role: string | null;
+    layer: 'live' | 'final';
+    latency_ms: number;
+}
+export interface GuidanceFlash {
+    symbol: string;
+    conference_date: string;
+    seq: number;
+    revision: number;
+    metric: string;
+    metric_normalized: string | null;
+    period_label: string | null;
+    low: number | null;
+    high: number | null;
+    point: number | null;
+    unit: string | null;
+    currency: string | null;
+    source_sentence: string;
+    start_ms: number;
+}
+export interface SpeakerAssignment {
+    speaker_label: string;
+    from_seq: number;
+    to_seq: number | null;
+    name: string;
+    role?: string;
+    title?: string | null;
+    firm?: string | null;
+}
+export interface LiveSegment {
+    seq: number;
+    start_ms: number;
+    speaker_label: string | null;
+    text: string;
+    is_final: boolean;
+}
+export interface LiveState {
+    /** Highest final seq printed (or the `since_seq` asked for): a reconnect resumes after it. */
+    lastSeq: number;
+    eventId: string | null;
+    names: {
+        revision: number;
+        assignments: SpeakerAssignment[];
+    } | null;
+}
+export interface LiveOptions {
+    partials: boolean;
+    names: boolean;
+    /** Global scope: every hit line names its company. */
+    allLive?: boolean;
+}
+export interface LiveStep {
+    state: LiveState;
+    lines: string[];
+    /** A partial to show in place of the previous one (TTY only). */
+    partial?: string;
+    /** Stop: exit code + a closing line. */
+    end?: {
+        code: 0 | 1;
+        message: string;
+    };
+    /** Close the socket and resubscribe through the backoff. */
+    reconnect?: boolean;
+}
+/** `--earnings`: a UUID is an event_id, 1–10 digits a CIK. */
+export declare function parseTarget(value: string): LiveTarget;
+/** `--since-seq`: an integer ≥ -1; default -1 (the whole call from its first final). */
+export declare function parseSinceSeq(value: string | undefined): number;
+/** `--keywords`: 1–20 keywords of 2–64 characters (the API's limits), trimmed and de-duplicated. */
+export declare function parseKeywords(value: string | undefined): string[];
+/** `--keyword-match`: `exact` (default) or `stem`. */
+export declare function parseKeywordMatch(value: string | undefined): KeywordMatch | undefined;
+/** `--speaker-roles`: a comma-separated subset of executive, ir_host, analyst, operator. */
+export declare function parseSpeakerRoles(value: string | undefined): SpeakerRole[] | undefined;
+/** `--min-rank`: a positive integer (market-cap rank). */
+export declare function parseMinRank(value: string | undefined): number | undefined;
+export declare function isAllLive(target: LiveTarget): target is {
+    scope: 'all_live';
+};
+/** What a global subscription receives (the API defaults to keyword hits only; `ws listen` wants the flashes too). */
+export declare const ALL_LIVE_EVENTS: readonly ["keyword_hit", "guidance_flash"];
+/**
+ * The subscribe frame. One call: target + `since_seq` + `partials`. Global scope: `scope: "all_live"`
+ * carries no call target, no replay and no partials — only the keyword fields (the API refuses it
+ * without keywords, and so does `ws listen`) and `events` = keyword hits + guidance flashes.
+ */
+export declare function subscribeFrame(target: LiveTarget, sinceSeq: number, partials: boolean, keywords?: KeywordOptions): {
+    min_rank?: number | undefined;
+    events: ("keyword_hit" | "guidance_flash")[];
+    type: string;
+    channel: string;
+    scope: string;
+} | {
+    since_seq: number;
+    partials: boolean;
+    event_id: string;
+    type: string;
+    channel: string;
+} | {
+    since_seq: number;
+    partials: boolean;
+    cik: string;
+    type: string;
+    channel: string;
+};
+export declare function initialLiveState(sinceSeq: number): LiveState;
+/** The assignment of `label` covering `seq` (the latest-starting one wins), else null. */
+export declare function nameFor(assignments: SpeakerAssignment[], label: string | null, seq: number): string | null;
+/** `[m:ss] name: text`, the name from the snapshot, else `Speaker <label>`. */
+export declare function formatSegment(segment: LiveSegment, assignments: SpeakerAssignment[]): string;
+/** One highlighted line per keyword hit: `[m:ss] keyword "x" · speaker: text` (+ the company in the global scope). */
+export declare function formatKeywordHit(hit: KeywordHit, allLive?: boolean): string;
+/** One line per guidance flash: `[m:ss] guidance flash · metric period: value — "sentence"`. */
+export declare function formatGuidanceFlash(flash: GuidanceFlash, allLive?: boolean): string;
+export declare function finalTranscriptHint(eventId: string | null): string;
+/** One server frame → the new state and what to print / do. Unknown frames are ignored. */
+export declare function liveStep(state: LiveState, frame: Record<string, any>, opts: LiveOptions): LiveStep;
+/** Frames of the earnings channel (the socket also carries `new_filing` broadcasts and pings). */
+export declare function isEarningsFrame(frame: Record<string, any>): boolean;