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

package/dist/src/client/earnings-live.js

@@ -0,0 +1,156 @@
+import chalk from 'chalk';
+import { formatMs } from '../formatters/time.js';
+/**
+ * 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 const EARNINGS_LIVE_CHANNEL = 'earnings-calls.live';
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Ends the run with exit 1. */
+const FATAL_ERRORS = new Set(['forbidden_tier', 'not_live', 'not_found', 'subscription_limit', 'bad_message']);
+/** Retried through the reconnect backoff. */
+const RETRY_ERRORS = new Set(['attach_failed', 'unavailable']);
+/** `--earnings`: a UUID is an event_id, 1–10 digits a CIK. */
+export function parseTarget(value) {
+    const target = value.trim();
+    if (UUID_RE.test(target))
+        return { event_id: target.toLowerCase() };
+    if (/^\d{1,10}$/.test(target))
+        return { cik: target };
+    throw new Error('--earnings takes an event ID (UUID) or a CIK (digits)');
+}
+/** `--since-seq`: an integer ≥ -1; default -1 (the whole call from its first final). */
+export function parseSinceSeq(value) {
+    if (value === undefined)
+        return -1;
+    const seq = Number(value);
+    if (!Number.isInteger(seq) || seq < -1)
+        throw new Error('--since-seq takes an integer ≥ -1');
+    return seq;
+}
+export function subscribeFrame(target, sinceSeq, partials) {
+    return { type: 'subscribe', channel: EARNINGS_LIVE_CHANNEL, ...target, since_seq: sinceSeq, partials };
+}
+export function initialLiveState(sinceSeq) {
+    return { lastSeq: sinceSeq, eventId: null, names: null };
+}
+/** The assignment of `label` covering `seq` (the latest-starting one wins), else null. */
+export function nameFor(assignments, label, seq) {
+    let best = null;
+    for (const a of assignments) {
+        if (a.speaker_label !== label || a.from_seq > seq || (a.to_seq !== null && seq > a.to_seq))
+            continue;
+        if (!best || a.from_seq > best.from_seq)
+            best = a;
+    }
+    return best?.name ?? null;
+}
+/** `[m:ss] name: text`, the name from the snapshot, else `Speaker <label>`. */
+export function formatSegment(segment, assignments) {
+    const name = nameFor(assignments, segment.speaker_label, segment.seq)
+        ?? (segment.speaker_label === null ? 'Speaker' : `Speaker ${segment.speaker_label}`);
+    return `[${formatMs(segment.start_ms)}] ${name}: ${segment.text}`;
+}
+export function finalTranscriptHint(eventId) {
+    return `final transcript: invd earnings transcript --event ${eventId ?? '<event_id>'}`;
+}
+/** IDA `UNSUBSCRIBE_REASONS` → the closing line; the transcript hint only where a transcript follows. */
+function unsubscribedNote(reason, eventId) {
+    switch (reason) {
+        case 'transcript_ready':
+            return finalTranscriptHint(eventId);
+        case 'rescheduled':
+            return 'the call was rescheduled; listen again at the new time';
+        case 'no_transcript':
+            return `no final transcript yet; check later with: invd earnings transcript --event ${eventId ?? '<event_id>'}`;
+        default:
+            return 'this call produces no more live segments';
+    }
+}
+function namesLines(revision, assignments) {
+    return [
+        chalk.dim(`speaker names (revision ${revision})`),
+        ...assignments.map(a => {
+            const detail = [a.title, a.firm].filter(Boolean).join(', ');
+            const range = `seq ${a.from_seq}–${a.to_seq ?? '…'}`;
+            return chalk.dim(`  ${a.speaker_label} → ${a.name}${detail ? ` (${detail})` : ''}${a.role ? ` [${a.role}]` : ''} ${range}`);
+        }),
+    ];
+}
+/** One server frame → the new state and what to print / do. Unknown frames are ignored. */
+export function liveStep(state, frame, opts) {
+    switch (frame.type) {
+        case 'subscribed': {
+            const latest = frame.current_seq === null ? 'none yet' : `latest ${frame.current_seq}`;
+            return {
+                state: { ...state, eventId: frame.event_id },
+                lines: [chalk.bold(`${frame.symbol} ${frame.conference_date} · ${frame.state} · from seq ${state.lastSeq + 1} (${latest})`)],
+            };
+        }
+        case 'transcript_segment': {
+            const assignments = state.names?.assignments ?? [];
+            if (!frame.is_final) {
+                return opts.partials ? { state, lines: [], partial: chalk.dim(formatSegment(frame, assignments)) } : { state, lines: [] };
+            }
+            return {
+                state: { ...state, lastSeq: Math.max(state.lastSeq, frame.seq) },
+                lines: [formatSegment(frame, assignments)],
+            };
+        }
+        case 'speaker_names': {
+            if (state.names && frame.revision <= state.names.revision)
+                return { state, lines: [] };
+            const names = { revision: frame.revision, assignments: frame.assignments ?? [] };
+            return { state: { ...state, names }, lines: opts.names ? namesLines(names.revision, names.assignments) : [] };
+        }
+        // `gap` and `resume_unavailable` are notes only — never a re-subscribe. Verified against IDA
+        // (invinite-data-api, 2026-10-10): a final inside a reported gap is still delivered once on
+        // the SAME subscription (`deliverFinal`, src/lib/earningsLiveBridge.ts:462-476), and so are
+        // gaps of a `since_seq` replay (`recordReportedGaps`, src/routes/websocket/earningsSubscriptions.ts:273).
+        // `resume_unavailable` is sent after a successful `subscribed` (earningsSubscriptions.ts:286-293);
+        // live delivery continues, and once the call's Ably history becomes readable the bridge
+        // back-fills missed finals into the existing subscriptions (`repass`, earningsLiveBridge.ts:660-690).
+        // A second subscribe would replay from the same ring and add a duplicate subscription.
+        case 'gap':
+            return { state, lines: [chalk.dim(`gap after seq ${frame.after_seq} (next ${frame.next_seq}); late segments still arrive`)] };
+        case 'call_started':
+            return { state, lines: [chalk.bold(`call started ${frame.at}`)] };
+        case 'call_ended':
+            return { state, lines: [chalk.bold(`call ended ${frame.at}`)] };
+        case 'transcript_provisional':
+            return { state, lines: [chalk.bold(`provisional transcript v${frame.version} (${frame.word_count} words, speakers not named yet)`)] };
+        case 'rescheduled':
+            return { state, lines: [chalk.bold(`rescheduled to ${frame.new_conference_date}`)] };
+        case 'transcript_ready':
+            return {
+                state,
+                lines: [chalk.bold(`transcript ready ${frame.at}`)],
+                end: { code: 0, message: finalTranscriptHint(state.eventId) },
+            };
+        case 'unsubscribed':
+            return {
+                state,
+                lines: [chalk.bold(`subscription ended: ${frame.reason}`)],
+                end: { code: 0, message: unsubscribedNote(frame.reason, state.eventId) },
+            };
+        case 'error': {
+            if (frame.code === 'resume_unavailable') {
+                return { state, lines: [chalk.dim('missed segments cannot be replayed for this call; live delivery continues')] };
+            }
+            if (RETRY_ERRORS.has(frame.code)) {
+                return { state, lines: [chalk.dim(`${frame.code}: ${frame.message}; retrying`)], reconnect: true };
+            }
+            const message = frame.code === 'forbidden_tier'
+                ? `earnings-calls.live needs the PRO plan (${frame.message})`
+                : `${frame.code}: ${frame.message}`;
+            return { state, lines: [], end: { code: 1, message: FATAL_ERRORS.has(frame.code) ? message : `${message} (unknown error code)` } };
+        }
+        default:
+            return { state, lines: [] };
+    }
+}
+/** Frames of the earnings channel (the socket also carries `new_filing` broadcasts and pings). */
+export function isEarningsFrame(frame) {
+    return frame.type === 'error' || frame.type === 'unsubscribed' || typeof frame.subscription_id === 'string';
+}
+//# sourceMappingURL=earnings-live.js.map

package/dist/src/client/earnings-live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"earnings-live.js","sourceRoot":"","sources":["../../../src/client/earnings-live.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;GAGG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AAE3D,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAElF,gCAAgC;AAChC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE,aAAa,CAAC,CAAC,CAAC;AAE/G,6CAA6C;AAC7C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC;AA6C/D,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;IACpE,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IACtD,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;AAC3E,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC7F,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,QAAgB,EAAE,QAAiB;IACpF,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,OAAO,CAAC,WAAgC,EAAE,KAAoB,EAAE,GAAW;IACzF,IAAI,IAAI,GAA6B,IAAI,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,aAAa,KAAK,KAAK,IAAI,CAAC,CAAC,QAAQ,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;YAAE,SAAS;QACrG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ;YAAE,IAAI,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;AAC5B,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,OAAoB,EAAE,WAAgC;IAClF,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC;WAChE,CAAC,OAAO,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACvF,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,OAAO,sDAAsD,OAAO,IAAI,YAAY,EAAE,CAAC;AACzF,CAAC;AAED,yGAAyG;AACzG,SAAS,gBAAgB,CAAC,MAAc,EAAE,OAAsB;IAC9D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,kBAAkB;YACrB,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACtC,KAAK,aAAa;YAChB,OAAO,wDAAwD,CAAC;QAClE,KAAK,eAAe;YAClB,OAAO,+EAA+E,OAAO,IAAI,YAAY,EAAE,CAAC;QAClH;YACE,OAAO,0CAA0C,CAAC;IACtD,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB,EAAE,WAAgC;IACpE,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,2BAA2B,QAAQ,GAAG,CAAC;QACjD,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACrB,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,aAAa,MAAM,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC;QAC9H,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,QAAQ,CAAC,KAAgB,EAAE,KAA0B,EAAE,IAAiB;IACtF,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,WAAW,EAAE,CAAC;YACvF,OAAO;gBACL,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE;gBAC5C,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,eAAe,MAAM,KAAK,CAAC,KAAK,eAAe,KAAK,CAAC,OAAO,GAAG,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC;aAC7H,CAAC;QACJ,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,EAAE,WAAW,IAAI,EAAE,CAAC;YACnD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,KAAoB,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YAC3I,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE;gBAChE,KAAK,EAAE,CAAC,aAAa,CAAC,KAAoB,EAAE,WAAW,CAAC,CAAC;aAC1D,CAAC;QACJ,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ;gBAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACvF,MAAM,KAAK,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;YACjF,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAChH,CAAC;QACD,6FAA6F;QAC7F,4FAA4F;QAC5F,4FAA4F;QAC5F,0GAA0G;QAC1G,mGAAmG;QACnG,wFAAwF;QACxF,sGAAsG;QACtG,uFAAuF;QACvF,KAAK,KAAK;YACR,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,SAAS,UAAU,KAAK,CAAC,QAAQ,+BAA+B,CAAC,CAAC,EAAE,CAAC;QAChI,KAAK,cAAc;YACjB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QACpE,KAAK,YAAY;YACf,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QAClE,KAAK,wBAAwB;YAC3B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,UAAU,iCAAiC,CAAC,CAAC,EAAE,CAAC;QACxI,KAAK,aAAa;YAChB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,CAAC;QACvF,KAAK,kBAAkB;YACrB,OAAO;gBACL,KAAK;gBACL,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnD,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;aAC9D,CAAC;QACJ,KAAK,cAAc;YACjB,OAAO;gBACL,KAAK;gBACL,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC1D,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE;aACzE,CAAC;QACJ,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;gBACxC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC,EAAE,CAAC;YACpH,CAAC;YACD,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YACrG,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,gBAAgB;gBAC7C,CAAC,CAAC,2CAA2C,KAAK,CAAC,OAAO,GAAG;gBAC7D,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;YACtC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,uBAAuB,EAAE,EAAE,CAAC;QACrI,CAAC;QACD;YACE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAChC,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,eAAe,CAAC,KAA0B;IACxD,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,CAAC;AAC9G,CAAC"}

package/dist/src/client/pagination.js

@@ -10,8 +10,9 @@ export async function fetchAllPages(initialData, extractNextUrl, mergeResults) {
         try {
             // nextUrl is absolute, extract path+query
             const url = new URL(nextUrl);
+            // Repeated keys (`status=a&status=b`) stay repeated.
             const params = {};
-            url.searchParams.forEach((v, k) => { params[k] = v; });
+            url.searchParams.forEach((v, k) => { (params[k] ??= []).push(v); });
             const pageData = await apiGet({ path: url.pathname, params, silent: true });
             result = mergeResults(result, pageData);
             nextUrl = extractNextUrl(pageData);

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

@@ -1 +1 @@
-{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/client/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAc,EACd,cAAmC,EACnC,YAA4C;IAE5C,IAAI,MAAM,GAAG,WAAW,CAAC;IACzB,IAAI,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,OAAO,OAAO,EAAE,CAAC;QACf,IAAI,EAAE,CAAC;QACP,MAAM,OAAO,GAAG,aAAa,CAAC,iBAAiB,IAAI,KAAK,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,0CAA0C;YAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;YAC7B,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAI,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/E,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACxC,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;YACnC,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,CAAC;YACpC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/client/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAc,EACd,cAAmC,EACnC,YAA4C;IAE5C,IAAI,MAAM,GAAG,WAAW,CAAC;IACzB,IAAI,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,OAAO,OAAO,EAAE,CAAC;QACf,IAAI,EAAE,CAAC;QACP,MAAM,OAAO,GAAG,aAAa,CAAC,iBAAiB,IAAI,KAAK,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,0CAA0C;YAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;YAC7B,qDAAqD;YACrD,MAAM,MAAM,GAA6B,EAAE,CAAC;YAC5C,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAI,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/E,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACxC,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;YACnC,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,CAAC;YACpC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -1 +1,12 @@
-export declare function connectWebSocket(): Promise<void>;
+import { type LiveTarget } from './earnings-live.js';
+export interface EarningsListenOptions {
+    target: LiveTarget;
+    sinceSeq: number;
+    partials: boolean;
+    names: boolean;
+    /** NDJSON: every earnings frame as one line, nothing else on stdout. */
+    json: boolean;
+}
+export declare function connectWebSocket(opts?: {
+    earnings?: EarningsListenOptions;
+}): Promise<void>;

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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,GAAG,IAAI,kBAAkB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;IAElE,IAAI,cAAc,GAAG,IAAI,CAAC;IAC1B,IAAI,eAAe,GAAG,IAAI,CAAC;IAE3B,SAAS,OAAO;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAC;QACrD,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QAE9B,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;YAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;YACvD,cAAc,GAAG,IAAI,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YACvC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC5C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;oBAAE,OAAO;gBACjC,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;oBACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;oBACnF,IAAI,CAAC,CAAC,QAAQ;wBAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;gBAC5D,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAChC,IAAI,eAAe,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,iCAAiC,cAAc,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC;gBACxF,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;gBACpC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YACvD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACrC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACxB,eAAe,GAAG,KAAK,CAAC;YACxB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,CAAC;IAEV,qBAAqB;IACrB,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAC9B,CAAC"}
+{"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 {};