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

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

@@ -1,57 +1,134 @@
 import { getApiKey } from '../config/auth.js';
 import { getBaseUrl } from '../config/config-manager.js';
 import chalk from 'chalk';
-export async function connectWebSocket() {
+import { initialLiveState, isEarningsFrame, liveStep, subscribeFrame, } from './earnings-live.js';
+/** Close codes of `/v1/ws` that a reconnect cannot fix (bad key, plan, connection limit). */
+const PERMANENT_CLOSE_CODES = new Set([4001, 4003, 4029]);
+const CLEAR_LINE = '\r\x1b[2K';
+export async function connectWebSocket(opts = {}) {
     const apiKey = await getApiKey();
     const base = getBaseUrl().replace(/\/+$/, '').replace(/^http/, 'ws');
     const url = `${base}/v1/ws?api_key=${encodeURIComponent(apiKey)}`;
+    const earnings = opts.earnings;
+    const status = (line) => {
+        if (!earnings?.json)
+            console.log(line);
+    };
     let reconnectDelay = 1000;
     let shouldReconnect = true;
-    function connect() {
-        console.log(chalk.dim('Connecting to WebSocket...'));
-        const ws = new WebSocket(url);
-        ws.addEventListener('open', () => {
-            console.log(chalk.green('Connected to filing stream'));
-            reconnectDelay = 1000;
-        });
-        ws.addEventListener('message', (event) => {
-            try {
-                const data = JSON.parse(String(event.data));
-                if (data.type === 'ping')
-                    return;
-                if (data.type === 'new_filing') {
-                    const f = data.filing;
-                    console.log(chalk.bold(`[${f.form_type}]`) + ` ${f.cik} - Filed ${f.filing_date}`);
-                    if (f.html_url)
-                        console.log(chalk.dim(`  ${f.html_url}`));
+    let current = null;
+    let live = earnings ? initialLiveState(earnings.sinceSeq) : null;
+    let partialShown = false;
+    return new Promise((resolve, reject) => {
+        function clearPartial() {
+            if (partialShown) {
+                process.stdout.write(CLEAR_LINE);
+                partialShown = false;
+            }
+        }
+        function finish(error) {
+            shouldReconnect = false;
+            clearPartial();
+            current?.close();
+            if (error)
+                reject(error);
+            else
+                resolve();
+        }
+        function handleEarnings(ws, data) {
+            if (!earnings || !live || !isEarningsFrame(data))
+                return;
+            if (earnings.json)
+                console.log(JSON.stringify(data));
+            const step = liveStep(live, data, earnings);
+            live = step.state;
+            if (!earnings.json) {
+                if (step.lines.length)
+                    clearPartial();
+                for (const line of step.lines)
+                    console.log(line);
+                if (step.partial && process.stdout.isTTY) {
+                    const width = (process.stdout.columns ?? 80) - 1;
+                    process.stdout.write(CLEAR_LINE + step.partial.slice(0, width));
+                    partialShown = true;
+                }
+            }
+            if (step.end) {
+                if (step.end.code === 0) {
+                    status(chalk.dim(step.end.message));
+                    finish();
                 }
                 else {
-                    console.log(JSON.stringify(data, null, 2));
+                    finish(new Error(step.end.message));
                 }
             }
-            catch {
-                console.log(String(event.data));
+            else if (step.reconnect) {
+                ws.close();
             }
-        });
-        ws.addEventListener('close', () => {
-            if (shouldReconnect) {
-                console.log(chalk.yellow(`Disconnected. Reconnecting in ${reconnectDelay / 1000}s...`));
+        }
+        function connect() {
+            status(chalk.dim('Connecting to WebSocket...'));
+            const ws = new WebSocket(url);
+            current = ws;
+            ws.addEventListener('open', () => {
+                reconnectDelay = 1000;
+                if (earnings && live) {
+                    status(chalk.green(`Connected; subscribing to ${earnings.partials ? 'live transcript + partials' : 'live transcript'}`));
+                    // A reconnect resumes after the last printed final (the API replays the gap).
+                    ws.send(JSON.stringify(subscribeFrame(earnings.target, live.lastSeq, earnings.partials)));
+                }
+                else {
+                    console.log(chalk.green('Connected to filing stream'));
+                }
+            });
+            ws.addEventListener('message', (event) => {
+                try {
+                    const data = JSON.parse(String(event.data));
+                    if (data.type === 'ping')
+                        return;
+                    if (earnings) {
+                        handleEarnings(ws, data);
+                    }
+                    else if (data.type === 'new_filing') {
+                        const f = data.filing;
+                        console.log(chalk.bold(`[${f.form_type}]`) + ` ${f.cik} - Filed ${f.filing_date}`);
+                        if (f.html_url)
+                            console.log(chalk.dim(`  ${f.html_url}`));
+                    }
+                    else {
+                        console.log(JSON.stringify(data, null, 2));
+                    }
+                }
+                catch {
+                    if (!earnings)
+                        console.log(String(event.data));
+                }
+            });
+            ws.addEventListener('close', (event) => {
+                if (!shouldReconnect)
+                    return;
+                if (PERMANENT_CLOSE_CODES.has(event.code)) {
+                    finish(new Error(`WebSocket closed (${event.code}): ${event.reason || 'refused'}`));
+                    return;
+                }
+                clearPartial();
+                status(chalk.yellow(`Disconnected. Reconnecting in ${reconnectDelay / 1000}s...`));
                 setTimeout(connect, reconnectDelay);
                 reconnectDelay = Math.min(reconnectDelay * 2, 30000);
-            }
-        });
-        ws.addEventListener('error', (error) => {
-            console.error(chalk.red('WebSocket error:'), error);
-        });
-        process.on('SIGINT', () => {
+            });
+            ws.addEventListener('error', (error) => {
+                if (!earnings?.json)
+                    console.error(chalk.red('WebSocket error:'), error);
+            });
+        }
+        process.once('SIGINT', () => {
             shouldReconnect = false;
-            ws.close();
-            console.log(chalk.dim('\nDisconnected.'));
+            clearPartial();
+            current?.close();
+            status(chalk.dim('\nDisconnected.'));
             process.exit(0);
         });
-    }
-    connect();
-    // Keep process alive
-    await new Promise(() => { });
+        connect();
+    });
 }
 //# sourceMappingURL=websocket-client.js.map

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

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

package/dist/src/commands/earnings-selector.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+/** IDA's own wording (`eventSelectorSchema`) for an incomplete selector. */
+export declare const SELECTOR_MESSAGE = "Provide event_id, or identifier with year+quarter or date";
+export interface SelectorOptions {
+    event?: string;
+    identifier?: string;
+    year?: string;
+    quarter?: string;
+    date?: string;
+}
+/** Adds the event selector: `--event <uuid>`, or `-i` with `--year` + `--quarter` or `--date`. */
+export declare function selectorOptions(cmd: Command): Command;
+export declare function selectorParams(opts: SelectorOptions): Record<string, string | undefined>;
+/** Throws (→ `withErrorHandling` exits 1) unless one selector form is complete. */
+export declare function validateSelector(opts: SelectorOptions): void;

package/dist/src/commands/earnings-selector.js

@@ -0,0 +1,29 @@
+/** IDA's own wording (`eventSelectorSchema`) for an incomplete selector. */
+export const SELECTOR_MESSAGE = 'Provide event_id, or identifier with year+quarter or date';
+/** Adds the event selector: `--event <uuid>`, or `-i` with `--year` + `--quarter` or `--date`. */
+export function selectorOptions(cmd) {
+    return cmd
+        .option('--event <event_id>', 'Event ID (wins over the other selectors)')
+        .option('-i, --identifier <ticker>', 'Ticker or CIK (with --year + --quarter, or --date)')
+        .option('--year <n>', 'Fiscal year of the call (with --quarter)')
+        .option('--quarter <n>', 'Fiscal quarter of the call (with --year)')
+        .option('--date <date>', 'New York calendar day of the call (YYYY-MM-DD)');
+}
+export function selectorParams(opts) {
+    return {
+        event_id: opts.event,
+        identifier: opts.identifier,
+        year: opts.year,
+        quarter: opts.quarter,
+        date: opts.date,
+    };
+}
+/** Throws (→ `withErrorHandling` exits 1) unless one selector form is complete. */
+export function validateSelector(opts) {
+    if (opts.event)
+        return;
+    if (opts.identifier && ((opts.year && opts.quarter) || opts.date))
+        return;
+    throw new Error(SELECTOR_MESSAGE);
+}
+//# sourceMappingURL=earnings-selector.js.map

package/dist/src/commands/earnings-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"earnings-selector.js","sourceRoot":"","sources":["../../../src/commands/earnings-selector.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,2DAA2D,CAAC;AAU5F,kGAAkG;AAClG,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,GAAG;SACP,MAAM,CAAC,oBAAoB,EAAE,0CAA0C,CAAC;SACxE,MAAM,CAAC,2BAA2B,EAAE,oDAAoD,CAAC;SACzF,MAAM,CAAC,YAAY,EAAE,0CAA0C,CAAC;SAChE,MAAM,CAAC,eAAe,EAAE,0CAA0C,CAAC;SACnE,MAAM,CAAC,eAAe,EAAE,gDAAgD,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAqB;IAClD,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,KAAK;QACpB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAC,IAAqB;IACpD,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO;IACvB,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO;IAC1E,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;AACpC,CAAC"}

package/dist/src/commands/earnings.d.ts

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+import { ApiError } from '../shared/errors.js';
+type Row = Record<string, any>;
+/** One dim line after a 403 whose message names the plan the route needs. */
+export declare function planHint(error: ApiError): string | undefined;
+/** "Q&A starts at m:ss" for the transcript header; undefined without a Q&A boundary. */
+export declare function qaStartLine(qaStartMs: unknown): string | undefined;
+/** Plain-text rendering of a transcript `data` (console and `--output`); `words` stays JSON. */
+export declare function transcriptText(data: unknown, format: string): string;
+/** `documents --output`: the warning for a document without a signed URL. */
+export declare function skippedDocumentWarning(doc: Row): string;
+export declare function registerEarningsCommands(program: Command): void;
+export {};