@invinite-org/invinite-data-cli 0.1.19

package/claude-plugin/agents/invinite-data.md

@@ -0,0 +1,46 @@
+---
+name: invinite-data
+description: Fetches financial data from the Invinite Data API for analysis. Use this agent whenever you need company financials, SEC filings, institutional ownership, insider trades, financial ratios, growth metrics, or any stock/company data. Delegate to this agent when the user asks for financial data retrieval, company research, or comparative financial analysis — even if they don't mention "Invinite" explicitly. This agent knows how to efficiently query the right endpoints, combine data from multiple sources, and return structured results ready for analysis.
+tools: Bash(invd *), Read, Glob, Grep
+skills:
+  - invinite-data-cli
+model: sonnet
+---
+
+# Invinite Data Agent
+
+You are a financial data retrieval specialist. Your job is to fetch the requested data from the Invinite Data API using the `invd` CLI and return it in a clean, structured format ready for analysis.
+
+## How you work
+
+1. **Parse the request** — understand what data the user needs (which companies, what type of data, what time period)
+2. **Plan the queries** — determine which `invd` CLI commands to run. Prefer fewer, broader queries over many narrow ones. Use the snapshot endpoint when comparing multiple companies.
+3. **Fetch the data** — run the CLI commands with `--json` flag. Always use `--json` for machine-readable output.
+4. **Return structured results** — present the data clearly. If multiple queries were needed, combine the results into a coherent response.
+
+## Important rules
+
+- Always use `--json` on every data command
+- **Before querying metrics (ratios, CAGR, or growth) or financial statements, first run `invd metadata metrics --json`** to discover the available metric identifiers. The responses from these endpoints use `metric_id` keys — you need the metadata to know what metrics exist and to correctly interpret the results. Run this as a first step alongside or before your main data queries.
+- **Before querying filing sections, first run `invd metadata section-ids --json`** to discover valid section IDs.
+- If a command fails with an authentication error, report it clearly and tell the caller that `INVINITE_DATA_API_KEY` must be set or `invd config set-key` must be run
+- If a company identifier is ambiguous, use `invd company search -q "<name>" --json` first to resolve it
+- For comparing companies, prefer `invd financials snapshot -i AAPL,MSFT,GOOGL -p annual --json` over individual queries
+- When fetching financial statements, default to `annual` period unless the request specifies otherwise
+- Use `--limit` appropriately — don't fetch more data than needed, but don't under-fetch either
+- For large datasets, use `--all` only when specifically needed
+
+## Query planning
+
+When the request involves multiple data types (e.g., "get me Apple's financials and who owns it"), run the commands in parallel where possible rather than sequentially.
+
+Common multi-step patterns:
+- **Company research**: metadata metrics (first) + company details + financials snapshot + metrics ratios
+- **Metrics analysis**: metadata metrics (first) → then ratios/CAGR/growth queries
+- **Ownership analysis**: holdings-by-company + ownership transactions
+- **Filing deep-dive**: metadata section-ids (first) + filings list → then filings sections for full text
+- **Comparative analysis**: metadata metrics (first) + financials snapshot with multiple tickers + metrics ratios for each
+
+## Output format
+
+Return the raw JSON data. Do not summarize or interpret — the caller (or the user's main conversation) will handle analysis. If the data is very large, note the total count and return the most relevant subset.

package/claude-plugin/commands/financial-research.md

@@ -0,0 +1,69 @@
+---
+name: financial-research
+description: Perform AI-powered financial research and analysis. Use when the user asks to research companies, compare financials, analyze ownership patterns, review SEC filings, evaluate growth trends, or any multi-faceted financial question. This command orchestrates parallel data fetching and then synthesizes the results into a coherent analysis.
+argument-hint: [question or research topic]
+---
+
+# Financial Research
+
+You are a financial research orchestrator. The user has asked you to research or analyze financial data. Your job is to break the question into parallel data retrieval tasks, spawn `invinite-data` subagents to fetch the data concurrently, and then synthesize the results into a clear, insightful analysis.
+
+## Step 1: Decompose the question
+
+Break the user's request into independent data retrieval tasks. Think about what data sources you need:
+
+- **Company fundamentals**: company details, financial snapshots
+- **Metrics & ratios**: profitability, valuation, liquidity, solvency ratios, CAGR, growth rates
+- **Statements**: income statements, balance sheets, cash flows (for trend analysis)
+- **Ownership**: institutional holders, ownership transactions, insider trades
+- **Filings**: SEC filing sections (risk factors, MD&A, business descriptions)
+- **Context**: dividends, stock splits, fiscal periods, segments
+
+Each independent data need becomes a separate subagent task.
+
+## Step 2: Spawn invinite-data subagents in parallel
+
+Launch all data retrieval tasks at the same time using the `invinite-data` agent. Each subagent gets a focused prompt describing exactly what data to fetch.
+
+**Example**: if the user asks "Compare Apple and Microsoft's financial health", spawn subagents in parallel like:
+
+1. `invinite-data`: "Fetch the latest annual financial snapshot for AAPL and MSFT"
+2. `invinite-data`: "Fetch profitability and liquidity ratios for AAPL, annual period"
+3. `invinite-data`: "Fetch profitability and liquidity ratios for MSFT, annual period"
+4. `invinite-data`: "Fetch 5-year CAGR metrics for AAPL and MSFT"
+
+**Key rules for spawning:**
+- Always spawn as many subagents in parallel as possible — do not fetch sequentially
+- Give each subagent a specific, focused task — one clear data request per agent
+- If the user mentions companies by name (not ticker), include "resolve the ticker first" in the subagent prompt
+- For comparative analysis, consider fetching data for all companies in a single snapshot call rather than one per company
+
+## Step 3: Analyze and synthesize
+
+Once all subagents return their data, combine the results into a structured analysis:
+
+1. **Present key findings first** — lead with the most important insights
+2. **Use tables for comparisons** — side-by-side metrics are easier to read than prose
+3. **Highlight notable patterns** — trends, outliers, divergences between companies
+4. **Provide context** — explain what the numbers mean, not just what they are
+5. **Flag data gaps** — if any subagent couldn't fetch data, note what's missing and why
+
+## Output format
+
+Structure your analysis with clear sections. Adapt the structure to the question, but a typical research output might look like:
+
+```
+## Summary
+[2-3 sentence executive summary]
+
+## Key Metrics
+[Table comparing the most relevant data points]
+
+## Analysis
+[Deeper discussion of trends, comparisons, and insights]
+
+## Considerations
+[Risks, caveats, or areas for further research]
+```
+
+Keep the analysis focused on what the user asked. Don't pad with irrelevant data just because it was fetched.

package/claude-plugin/skills/invinite-data-cli/SKILL.md

@@ -0,0 +1,251 @@
+---
+name: invinite-data-cli
+description: Fetch financial data using the Invinite Data API CLI. Use this skill whenever the user wants to look up company information, financial statements, SEC filings, institutional ownership, insider trades, IPO data, market holidays, financial metrics, or any stock/company-related data. Also use when the user mentions tickers, CIKs, balance sheets, income statements, cash flows, 10-K, 10-Q, ratios, CAGR, growth rates, dividends, stock splits, or institutional holdings — even if they don't mention "Invinite" by name.
+allowed-tools: Bash(invd *)
+---
+
+# Invinite Data API CLI
+
+The `invd` CLI provides access to comprehensive financial data from the Invinite Data API. Always use `--json` when fetching data for analysis — it returns structured JSON you can pipe to `jq` or parse programmatically.
+
+## Prerequisites
+
+The CLI must be installed (`npm install -g @invinite-org/invinite-data-cli`) and authenticated. Authentication is resolved in this order:
+1. `INVINITE_DATA_API_KEY` environment variable
+2. OS keychain (via optional `keytar`)
+3. Stored config (set via `invd config set-key`)
+
+If a command fails with an auth error, tell the user to run `invd config set-key` or set `INVINITE_DATA_API_KEY`.
+
+## Global Options
+
+| Flag | Description |
+|------|-------------|
+| `--json` | Output raw JSON (always use this for programmatic access) |
+| `--all` | Auto-paginate through all results |
+
+## Commands Reference
+
+### Company Data
+
+```bash
+# List all companies
+invd company list --json
+
+# Search by ticker or name
+invd company search -q "Apple" --json
+invd company search -q MSFT --limit 5 --json
+
+# Company details (ticker or CIK)
+invd company details -i AAPL --json
+
+# Dividends (with optional date range)
+invd company dividends -i AAPL --json
+invd company dividends -i AAPL --start-date 2023-01-01 --end-date 2024-01-01 --json
+
+# Fiscal periods
+invd company fiscal-periods -i MSFT --json
+
+# Stock splits
+invd company splits -i AAPL --json
+```
+
+### Financial Statements
+
+Period is required: `quarterly`, `annual`, `ytd`, or `ttm`.
+
+Financial statement responses use standardized `metric_id` keys (from `metadata metrics`) as field names. If you need to understand what a specific metric_id means, check `invd metadata metrics --json` first.
+
+```bash
+# Income statement
+invd financials income-statement -i AAPL -p annual --json
+invd financials income-statement -i AAPL -p quarterly --limit 4 --json
+
+# Balance sheet
+invd financials balance-sheet -i MSFT -p quarterly --limit 4 --json
+
+# Cash flow statement
+invd financials cash-flow -i GOOGL -p annual --json
+
+# Financial snapshot (multiple companies, comma-separated)
+invd financials snapshot -i AAPL,MSFT,GOOGL -p annual --json
+invd financials snapshot -i AAPL -p quarterly --calendar-year 2024 --calendar-quarter 3 --json
+```
+
+Statement options:
+- `--detailed` — includes formula, accession number, HTML tag info
+- `--presentation` — returns nested tree structure (hierarchical)
+- `--as-reported` — uses as-reported data instead of standardized
+- `--with-formula` — includes formula info (requires `--detailed`)
+- `--detailed` and `--presentation` are mutually exclusive
+
+### Financial Metrics
+
+**Before querying any metrics endpoint (ratios, CAGR, or growth), first fetch the available metric identifiers using `metadata metrics`.** The response from ratios/CAGR/growth uses `metric_id` keys (e.g., `PR_TO_EARNINGS`, `CURRENT_RATIO`) — without knowing the available IDs, you won't know what data exists or how to interpret the results. This also helps you confirm that the metric the user is asking about actually exists.
+
+```bash
+# STEP 1: Always fetch available metrics first
+invd metadata metrics --json
+# Returns: { metrics: [{ metric_id: "...", name: "..." }, ...] }
+# Use this to understand what metric_id keys appear in ratios/CAGR/growth responses
+
+# STEP 2: Then query the specific metrics endpoint
+# Ratios (categories: valuation, profitability, liquidity, solvency)
+invd metrics ratios -i AAPL -p annual --json
+invd metrics ratios -i AAPL -p annual --category profitability --json
+
+# CAGR (periods: 3, 5, or 10 years)
+invd metrics cagr -i AAPL --json
+invd metrics cagr -i AAPL --period-years 5 --json
+
+# Growth metrics (year_over_year or quarter_over_quarter)
+invd metrics growth -i MSFT -p quarterly --growth-type year_over_year --json
+```
+
+The metrics response structures differ by endpoint:
+- **Ratios**: `period.facts[category][metric_id]` — organized by category (valuation, profitability, etc.)
+- **CAGR**: `period.facts[years][metric_id]` — organized by time period (3-year, 5-year, 10-year)
+- **Growth**: `period.facts[growthType][metric_id]` — organized by growth type (year_over_year, quarter_over_quarter)
+
+All share the same `metric_id` identifiers from `metadata metrics`.
+
+### Segments
+
+```bash
+# Segmented financials
+invd segments list -i AAPL -p annual --json
+invd segments list -i AAPL -p annual --detailed --json
+```
+
+### SEC Filings
+
+```bash
+# List filings (filter by form type: 10-K, 10-Q, 8-K, etc.)
+invd filings list -i AAPL --json
+invd filings list -i AAPL --form-type 10-K --json
+
+# Natural language search through filings
+invd filings search -r "revenue recognition policy changes" -i AAPL --json
+
+# Fetch filing sections (full text content)
+invd filings sections -i AAPL --form-type 10-K --section-id risk_factors --json
+invd filings sections -i AAPL --form-type 10-K --accession-number 0000320193-23-000106 --json
+
+# Available form types
+invd filings form-types --json
+invd filings form-types -i AAPL --json
+
+# Available section IDs
+invd metadata section-ids --json
+```
+
+### Institutional Ownership
+
+```bash
+# Holdings by investor (requires CIK)
+invd ownership holdings-by-investor --cik 0001067983 --json
+
+# Holdings by company
+invd ownership holdings-by-company -i AAPL --json
+invd ownership holdings-by-company -i AAPL --min-value 1000000 --json
+
+# Ownership transactions
+invd ownership transactions -i AAPL --type new_buy --json
+invd ownership transactions --cik 0001067983 --calendar-year 2024 --json
+
+# List institutional investors
+invd ownership institutions --json
+invd ownership institutions --ciks 0001067983,0001364742 --json
+```
+
+Transaction types: `new_buy`, `added`, `reduced`, `sold_out`
+
+### Insider Trades
+
+```bash
+# Insider transactions
+invd insider-trades list -i AAPL --json
+invd insider-trades list -i TSLA --acquired-disposed D --limit 20 --json
+invd insider-trades list -i AAPL --start-date 2024-01-01 --json
+```
+
+`--acquired-disposed`: `A` (acquisition) or `D` (disposition)
+
+### IPOs
+
+```bash
+invd ipos list --json
+invd ipos list --start-date 2024-01-01 --end-date 2024-12-31 --json
+```
+
+### Market Data
+
+```bash
+invd market holidays --json
+```
+
+### Metadata (query before using metrics or filing sections)
+
+These are discovery endpoints — use them before querying data that depends on specific identifiers.
+
+```bash
+# List all available metric IDs — run this BEFORE querying ratios, CAGR, or growth
+invd metadata metrics --json
+# Returns: { metrics: [{ metric_id: "PR_TO_EARNINGS", name: "Price-to-Earnings Ratio" }, ...] }
+
+# List available section IDs — run this BEFORE querying filing sections
+invd metadata section-ids --json
+```
+
+### Health Check
+
+```bash
+invd health --json
+```
+
+## Pagination
+
+All list endpoints support:
+- `-l, --limit <n>` — max results per page
+- `--offset <n>` — pagination offset
+- `--all` — auto-paginate all results
+- `-s, --sort <dir>` — `asc` or `desc`
+
+## Common Patterns
+
+### Comparing companies
+Fetch snapshots for multiple tickers at once:
+```bash
+invd financials snapshot -i AAPL,MSFT,GOOGL -p annual --json
+```
+
+### Getting the latest quarterly data
+```bash
+invd financials income-statement -i AAPL -p quarterly --limit 1 --json
+```
+
+### Finding who owns a stock
+```bash
+invd ownership holdings-by-company -i AAPL --min-value 10000000 --json
+```
+
+### Searching SEC filings by topic
+```bash
+invd filings search -r "artificial intelligence strategy" -i MSFT --json
+```
+
+### Reading specific filing sections
+First find section IDs, then fetch the section:
+```bash
+invd metadata section-ids --json
+invd filings sections -i AAPL --form-type 10-K --section-id risk_factors --json
+```
+
+## Tips
+
+- Always use `--json` for data you'll analyze or transform
+- Use `--all` cautiously — some endpoints return thousands of results
+- Company identifiers accept both ticker symbols (AAPL) and CIK numbers
+- For financial statements, `annual` gives the full year, `quarterly` gives each quarter, `ttm` gives trailing twelve months, `ytd` gives year-to-date
+- The `snapshot` command is the most efficient way to get complete financials for one or more companies at once
+- Filing sections return full text — great for detailed analysis of risk factors, MD&A, business descriptions, etc.

package/dist/bin/invd.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/invd.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { createProgram } from '../src/cli.js';
+const program = createProgram();
+program.parse();
+//# sourceMappingURL=invd.js.map

package/dist/bin/invd.js.map

@@ -0,0 +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"}

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function createProgram(): Command;

package/dist/src/cli.js

@@ -0,0 +1,47 @@
+import { Command } from 'commander';
+import { setJsonMode } from './shared/spinner.js';
+import { registerConfigCommands } from './commands/config.js';
+import { registerHealthCommand } from './commands/health.js';
+import { registerCompanyCommands } from './commands/company.js';
+import { registerFinancialsCommands } from './commands/financials.js';
+import { registerMetricsCommands } from './commands/metrics.js';
+import { registerSegmentsCommands } from './commands/segments.js';
+import { registerIposCommands } from './commands/ipos.js';
+import { registerOwnershipCommands } from './commands/ownership.js';
+import { registerInsiderTradesCommands } from './commands/insider-trades.js';
+import { registerFilingsCommands } from './commands/filings.js';
+import { registerMarketCommands } from './commands/market.js';
+import { registerMetadataCommands } from './commands/metadata.js';
+import { registerWsCommands } from './commands/ws.js';
+import { registerPluginCommands } from './commands/plugin.js';
+export function createProgram() {
+    const program = new Command();
+    program
+        .name('invd')
+        .description('CLI for the Invinite financial data API')
+        .version('0.1.0')
+        .option('--json', 'Output raw JSON (pipe-friendly)')
+        .option('--all', 'Auto-paginate through all results')
+        .hook('preAction', (thisCommand) => {
+        const opts = thisCommand.opts();
+        if (opts.json) {
+            setJsonMode(true);
+        }
+    });
+    registerConfigCommands(program);
+    registerHealthCommand(program);
+    registerCompanyCommands(program);
+    registerFinancialsCommands(program);
+    registerMetricsCommands(program);
+    registerSegmentsCommands(program);
+    registerIposCommands(program);
+    registerOwnershipCommands(program);
+    registerInsiderTradesCommands(program);
+    registerFilingsCommands(program);
+    registerMarketCommands(program);
+    registerMetadataCommands(program);
+    registerWsCommands(program);
+    registerPluginCommands(program);
+    return program;
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,yCAAyC,CAAC;SACtD,OAAO,CAAC,OAAO,CAAC;SAChB,MAAM,CAAC,QAAQ,EAAE,iCAAiC,CAAC;SACnD,MAAM,CAAC,OAAO,EAAE,mCAAmC,CAAC;SACpD,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACpC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,6BAA6B,CAAC,OAAO,CAAC,CAAC;IACvC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAEhC,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,6 @@
+export interface RequestOptions {
+    path: string;
+    params?: Record<string, string | undefined>;
+    silent?: boolean;
+}
+export declare function apiGet<T = unknown>(opts: RequestOptions): Promise<T>;

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

@@ -0,0 +1,40 @@
+import { getApiKey } from '../config/auth.js';
+import { getBaseUrl } from '../config/config-manager.js';
+import { ApiError } from '../shared/errors.js';
+import { createSpinner } from '../shared/spinner.js';
+function buildUrl(path, params) {
+    const base = getBaseUrl().replace(/\/+$/, '');
+    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);
+            }
+        }
+    }
+    return url.toString();
+}
+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 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;
+    }
+    catch (error) {
+        spinner?.fail('Failed');
+        throw error;
+    }
+}
+//# sourceMappingURL=api-client.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,3 @@
+type NextUrlExtractor<T> = (data: T) => string | undefined;
+export declare function fetchAllPages<T>(initialData: T, extractNextUrl: NextUrlExtractor<T>, mergeResults: (accumulated: T, page: T) => T): Promise<T>;
+export {};

package/dist/src/client/pagination.js

@@ -0,0 +1,27 @@
+import { apiGet } from './api-client.js';
+import { createSpinner } from '../shared/spinner.js';
+export async function fetchAllPages(initialData, extractNextUrl, mergeResults) {
+    let result = initialData;
+    let nextUrl = extractNextUrl(result);
+    let page = 1;
+    while (nextUrl) {
+        page++;
+        const spinner = createSpinner(`Fetching page ${page}...`);
+        try {
+            // nextUrl is absolute, extract path+query
+            const url = new URL(nextUrl);
+            const params = {};
+            url.searchParams.forEach((v, k) => { params[k] = v; });
+            const pageData = await apiGet({ path: url.pathname, params, silent: true });
+            result = mergeResults(result, pageData);
+            nextUrl = extractNextUrl(pageData);
+            spinner.succeed(`Page ${page} fetched`);
+        }
+        catch (error) {
+            spinner.fail(`Page ${page} failed`);
+            throw error;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=pagination.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1 @@
+export declare function connectWebSocket(): Promise<void>;

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

@@ -0,0 +1,57 @@
+import { getApiKey } from '../config/auth.js';
+import { getBaseUrl } from '../config/config-manager.js';
+import chalk from 'chalk';
+export async function connectWebSocket() {
+    const apiKey = await getApiKey();
+    const base = getBaseUrl().replace(/\/+$/, '').replace(/^http/, 'ws');
+    const url = `${base}/v1/ws?api_key=${encodeURIComponent(apiKey)}`;
+    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}`));
+                }
+                else {
+                    console.log(JSON.stringify(data, null, 2));
+                }
+            }
+            catch {
+                console.log(String(event.data));
+            }
+        });
+        ws.addEventListener('close', () => {
+            if (shouldReconnect) {
+                console.log(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', () => {
+            shouldReconnect = false;
+            ws.close();
+            console.log(chalk.dim('\nDisconnected.'));
+            process.exit(0);
+        });
+    }
+    connect();
+    // Keep process alive
+    await new Promise(() => { });
+}
+//# sourceMappingURL=websocket-client.js.map

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

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

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

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerCompanyCommands(program: Command): void;