fin-ratios 0.1.0

package/dist/fetchers/edgar/index.cjs

@@ -0,0 +1,100 @@
+'use strict';
+
+// src/fetchers/edgar/index.ts
+var COMPANY_TICKERS_URL = "https://data.sec.gov/files/company_tickers.json";
+var EDGAR_BASE = "https://data.sec.gov/api/xbrl/companyfacts";
+var HEADERS = {
+  "User-Agent": "fin-ratios/0.1.0 contact@fin-ratios.dev",
+  "Accept-Encoding": "gzip, deflate"
+};
+async function fetchEdgar(ticker, options = {}) {
+  const { numYears = 3 } = options;
+  const tickerMap = await _get(COMPANY_TICKERS_URL);
+  const entry = Object.values(tickerMap).find((v) => v.ticker.toUpperCase() === ticker.toUpperCase());
+  if (!entry) throw new Error(`EDGAR: ticker ${ticker} not found`);
+  const cik = String(entry.cik_str).padStart(10, "0");
+  const facts = await _get(`${EDGAR_BASE}/CIK${cik}.json`);
+  const gaap = facts.facts["us-gaap"] ?? {};
+  function _annual(concept) {
+    const entries = gaap[concept]?.units?.USD ?? [];
+    return entries.filter((e) => e.form === "10-K").sort((a, b) => b.end.localeCompare(a.end));
+  }
+  function _latestForYear(concept, year) {
+    const annual = _annual(concept);
+    const match = annual.find((e) => e.end.startsWith(year));
+    return match?.val ?? 0;
+  }
+  const revenueEntries = _annual("Revenues").concat(_annual("RevenueFromContractWithCustomerExcludingAssessedTax"));
+  const years = [...new Set(revenueEntries.map((e) => e.end.slice(0, 4)))].slice(0, numYears);
+  const results = [];
+  for (const year of years) {
+    const rev = _latestForYear("Revenues", year) || _latestForYear("RevenueFromContractWithCustomerExcludingAssessedTax", year);
+    const ni = _latestForYear("NetIncomeLoss", year);
+    const ebit = _latestForYear("OperatingIncomeLoss", year);
+    const ta = _latestForYear("Assets", year);
+    const ca = _latestForYear("AssetsCurrent", year);
+    const cash = _latestForYear("CashAndCashEquivalentsAtCarryingValue", year);
+    const ar = _latestForYear("AccountsReceivableNetCurrent", year);
+    const inv = _latestForYear("InventoryNet", year);
+    const cl = _latestForYear("LiabilitiesCurrent", year);
+    const tl = _latestForYear("Liabilities", year);
+    const ltd = _latestForYear("LongTermDebt", year);
+    const re = _latestForYear("RetainedEarningsAccumulatedDeficit", year);
+    const te = _latestForYear("StockholdersEquity", year);
+    const ocf = _latestForYear("NetCashProvidedByUsedInOperatingActivities", year);
+    const capex = _latestForYear("PaymentsToAcquirePropertyPlantAndEquipment", year);
+    const gp = _latestForYear("GrossProfit", year);
+    const int = _latestForYear("InterestExpense", year);
+    const tax = _latestForYear("IncomeTaxExpense", year) || _latestForYear("IncomeTaxesPaidNet", year);
+    results.push({
+      fiscalYear: year,
+      income: {
+        revenue: rev,
+        grossProfit: gp,
+        cogs: rev - gp,
+        ebit,
+        ebitda: 0,
+        netIncome: ni,
+        interestExpense: Math.abs(int),
+        incomeTaxExpense: tax,
+        ebt: ni + tax,
+        depreciationAndAmortization: 0,
+        sharesOutstanding: 0,
+        eps: 0
+      },
+      balance: {
+        totalAssets: ta,
+        currentAssets: ca,
+        cash,
+        accountsReceivable: ar,
+        inventory: inv,
+        netPPE: 0,
+        goodwill: 0,
+        retainedEarnings: re,
+        totalLiabilities: tl,
+        currentLiabilities: cl,
+        accountsPayable: 0,
+        longTermDebt: ltd,
+        totalDebt: ltd,
+        totalEquity: te,
+        sharesOutstanding: 0
+      },
+      cashFlow: {
+        operatingCashFlow: ocf,
+        capex: Math.abs(capex),
+        investingCashFlow: 0,
+        financingCashFlow: 0
+      }
+    });
+  }
+  return results;
+}
+async function _get(url) {
+  const resp = await fetch(url, { headers: HEADERS });
+  if (!resp.ok) throw new Error(`EDGAR request failed: ${resp.status} ${url}`);
+  return resp.json();
+}
+
+exports.fetchEdgar = fetchEdgar;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/fetchers/edgar/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/fetchers/edgar/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * SEC EDGAR fetcher for fin-ratios (TypeScript).\n *\n * Fetches financial data from the free SEC EDGAR XBRL API.\n * No API key required. US companies only.\n *\n * Rate limit: ~10 requests/second (SEC guidelines). Add delays for bulk use.\n *\n * @example\n * import { fetchEdgar } from 'fin-ratios/fetchers/edgar'\n * const filings = await fetchEdgar('AAPL', { numYears: 3 })\n * for (const f of filings) {\n *   console.log(`${f.fiscalYear}: Revenue $${(f.income.revenue/1e9).toFixed(1)}B`)\n * }\n */\n\nimport type { IncomeStatement, BalanceSheet, CashFlowStatement } from '../../types/index.js'\n\nconst COMPANY_TICKERS_URL = 'https://data.sec.gov/files/company_tickers.json'\nconst EDGAR_BASE = 'https://data.sec.gov/api/xbrl/companyfacts'\n\nconst HEADERS = {\n  'User-Agent': 'fin-ratios/0.1.0 contact@fin-ratios.dev',\n  'Accept-Encoding': 'gzip, deflate',\n}\n\nexport interface EdgarOptions {\n  numYears?: number\n}\n\nexport interface EdgarFilingData {\n  fiscalYear: string\n  income: IncomeStatement\n  balance: BalanceSheet\n  cashFlow: CashFlowStatement\n}\n\n/**\n * Fetch multi-year annual filings from SEC EDGAR for a US stock ticker.\n */\nexport async function fetchEdgar(\n  ticker: string,\n  options: EdgarOptions = {}\n): Promise<EdgarFilingData[]> {\n  const { numYears = 3 } = options\n\n  // Step 1: Resolve ticker → CIK\n  const tickerMap = (await _get(COMPANY_TICKERS_URL)) as Record<string, { cik_str: number; ticker: string; title: string }>\n  const entry = Object.values(tickerMap).find(v => v.ticker.toUpperCase() === ticker.toUpperCase())\n  if (!entry) throw new Error(`EDGAR: ticker ${ticker} not found`)\n\n  const cik = String(entry.cik_str).padStart(10, '0')\n\n  // Step 2: Fetch company facts (XBRL)\n  const facts = (await _get(`${EDGAR_BASE}/CIK${cik}.json`)) as {\n    facts: {\n      'us-gaap'?: Record<string, { units: { USD?: { val: number; end: string; form: string; fp: string }[] } }>\n    }\n  }\n\n  const gaap = facts.facts['us-gaap'] ?? {}\n\n  function _annual(concept: string): { end: string; val: number }[] {\n    const entries = gaap[concept]?.units?.USD ?? []\n    return entries\n      .filter(e => e.form === '10-K')\n      .sort((a, b) => b.end.localeCompare(a.end))\n  }\n\n  function _latestForYear(concept: string, year: string): number {\n    const annual = _annual(concept)\n    const match = annual.find(e => e.end.startsWith(year))\n    return match?.val ?? 0\n  }\n\n  // Collect available fiscal years from revenue\n  const revenueEntries = _annual('Revenues').concat(_annual('RevenueFromContractWithCustomerExcludingAssessedTax'))\n  const years = [...new Set(revenueEntries.map(e => e.end.slice(0, 4)))].slice(0, numYears)\n\n  const results: EdgarFilingData[] = []\n\n  for (const year of years) {\n    const rev   = _latestForYear('Revenues', year) || _latestForYear('RevenueFromContractWithCustomerExcludingAssessedTax', year)\n    const ni    = _latestForYear('NetIncomeLoss', year)\n    const ebit  = _latestForYear('OperatingIncomeLoss', year)\n    const ta    = _latestForYear('Assets', year)\n    const ca    = _latestForYear('AssetsCurrent', year)\n    const cash  = _latestForYear('CashAndCashEquivalentsAtCarryingValue', year)\n    const ar    = _latestForYear('AccountsReceivableNetCurrent', year)\n    const inv   = _latestForYear('InventoryNet', year)\n    const cl    = _latestForYear('LiabilitiesCurrent', year)\n    const tl    = _latestForYear('Liabilities', year)\n    const ltd   = _latestForYear('LongTermDebt', year)\n    const re    = _latestForYear('RetainedEarningsAccumulatedDeficit', year)\n    const te    = _latestForYear('StockholdersEquity', year)\n    const ocf   = _latestForYear('NetCashProvidedByUsedInOperatingActivities', year)\n    const capex = _latestForYear('PaymentsToAcquirePropertyPlantAndEquipment', year)\n    const gp    = _latestForYear('GrossProfit', year)\n    const int   = _latestForYear('InterestExpense', year)\n    const tax   = _latestForYear('IncomeTaxExpense', year) || _latestForYear('IncomeTaxesPaidNet', year)\n\n    results.push({\n      fiscalYear: year,\n      income: {\n        revenue: rev, grossProfit: gp, cogs: rev - gp,\n        ebit, ebitda: 0, netIncome: ni,\n        interestExpense: Math.abs(int), incomeTaxExpense: tax, ebt: ni + tax,\n        depreciationAndAmortization: 0, sharesOutstanding: 0, eps: 0,\n      },\n      balance: {\n        totalAssets: ta, currentAssets: ca, cash, accountsReceivable: ar,\n        inventory: inv, netPPE: 0, goodwill: 0,\n        retainedEarnings: re, totalLiabilities: tl, currentLiabilities: cl,\n        accountsPayable: 0, longTermDebt: ltd, totalDebt: ltd,\n        totalEquity: te, sharesOutstanding: 0,\n      },\n      cashFlow: {\n        operatingCashFlow: ocf, capex: Math.abs(capex),\n        investingCashFlow: 0, financingCashFlow: 0,\n      },\n    })\n  }\n\n  return results\n}\n\nasync function _get(url: string): Promise<unknown> {\n  const resp = await fetch(url, { headers: HEADERS })\n  if (!resp.ok) throw new Error(`EDGAR request failed: ${resp.status} ${url}`)\n  return resp.json()\n}\n"]}

package/dist/fetchers/edgar/index.d.cts

@@ -0,0 +1,33 @@
+import { I as IncomeStatement, B as BalanceSheet, C as CashFlowStatement } from '../../financials-DUHxWDPS.cjs';
+
+/**
+ * SEC EDGAR fetcher for fin-ratios (TypeScript).
+ *
+ * Fetches financial data from the free SEC EDGAR XBRL API.
+ * No API key required. US companies only.
+ *
+ * Rate limit: ~10 requests/second (SEC guidelines). Add delays for bulk use.
+ *
+ * @example
+ * import { fetchEdgar } from 'fin-ratios/fetchers/edgar'
+ * const filings = await fetchEdgar('AAPL', { numYears: 3 })
+ * for (const f of filings) {
+ *   console.log(`${f.fiscalYear}: Revenue $${(f.income.revenue/1e9).toFixed(1)}B`)
+ * }
+ */
+
+interface EdgarOptions {
+    numYears?: number;
+}
+interface EdgarFilingData {
+    fiscalYear: string;
+    income: IncomeStatement;
+    balance: BalanceSheet;
+    cashFlow: CashFlowStatement;
+}
+/**
+ * Fetch multi-year annual filings from SEC EDGAR for a US stock ticker.
+ */
+declare function fetchEdgar(ticker: string, options?: EdgarOptions): Promise<EdgarFilingData[]>;
+
+export { type EdgarFilingData, type EdgarOptions, fetchEdgar };

package/dist/fetchers/edgar/index.d.ts

@@ -0,0 +1,33 @@
+import { I as IncomeStatement, B as BalanceSheet, C as CashFlowStatement } from '../../financials-DUHxWDPS.js';
+
+/**
+ * SEC EDGAR fetcher for fin-ratios (TypeScript).
+ *
+ * Fetches financial data from the free SEC EDGAR XBRL API.
+ * No API key required. US companies only.
+ *
+ * Rate limit: ~10 requests/second (SEC guidelines). Add delays for bulk use.
+ *
+ * @example
+ * import { fetchEdgar } from 'fin-ratios/fetchers/edgar'
+ * const filings = await fetchEdgar('AAPL', { numYears: 3 })
+ * for (const f of filings) {
+ *   console.log(`${f.fiscalYear}: Revenue $${(f.income.revenue/1e9).toFixed(1)}B`)
+ * }
+ */
+
+interface EdgarOptions {
+    numYears?: number;
+}
+interface EdgarFilingData {
+    fiscalYear: string;
+    income: IncomeStatement;
+    balance: BalanceSheet;
+    cashFlow: CashFlowStatement;
+}
+/**
+ * Fetch multi-year annual filings from SEC EDGAR for a US stock ticker.
+ */
+declare function fetchEdgar(ticker: string, options?: EdgarOptions): Promise<EdgarFilingData[]>;
+
+export { type EdgarFilingData, type EdgarOptions, fetchEdgar };

package/dist/fetchers/edgar/index.js

@@ -0,0 +1,98 @@
+// src/fetchers/edgar/index.ts
+var COMPANY_TICKERS_URL = "https://data.sec.gov/files/company_tickers.json";
+var EDGAR_BASE = "https://data.sec.gov/api/xbrl/companyfacts";
+var HEADERS = {
+  "User-Agent": "fin-ratios/0.1.0 contact@fin-ratios.dev",
+  "Accept-Encoding": "gzip, deflate"
+};
+async function fetchEdgar(ticker, options = {}) {
+  const { numYears = 3 } = options;
+  const tickerMap = await _get(COMPANY_TICKERS_URL);
+  const entry = Object.values(tickerMap).find((v) => v.ticker.toUpperCase() === ticker.toUpperCase());
+  if (!entry) throw new Error(`EDGAR: ticker ${ticker} not found`);
+  const cik = String(entry.cik_str).padStart(10, "0");
+  const facts = await _get(`${EDGAR_BASE}/CIK${cik}.json`);
+  const gaap = facts.facts["us-gaap"] ?? {};
+  function _annual(concept) {
+    const entries = gaap[concept]?.units?.USD ?? [];
+    return entries.filter((e) => e.form === "10-K").sort((a, b) => b.end.localeCompare(a.end));
+  }
+  function _latestForYear(concept, year) {
+    const annual = _annual(concept);
+    const match = annual.find((e) => e.end.startsWith(year));
+    return match?.val ?? 0;
+  }
+  const revenueEntries = _annual("Revenues").concat(_annual("RevenueFromContractWithCustomerExcludingAssessedTax"));
+  const years = [...new Set(revenueEntries.map((e) => e.end.slice(0, 4)))].slice(0, numYears);
+  const results = [];
+  for (const year of years) {
+    const rev = _latestForYear("Revenues", year) || _latestForYear("RevenueFromContractWithCustomerExcludingAssessedTax", year);
+    const ni = _latestForYear("NetIncomeLoss", year);
+    const ebit = _latestForYear("OperatingIncomeLoss", year);
+    const ta = _latestForYear("Assets", year);
+    const ca = _latestForYear("AssetsCurrent", year);
+    const cash = _latestForYear("CashAndCashEquivalentsAtCarryingValue", year);
+    const ar = _latestForYear("AccountsReceivableNetCurrent", year);
+    const inv = _latestForYear("InventoryNet", year);
+    const cl = _latestForYear("LiabilitiesCurrent", year);
+    const tl = _latestForYear("Liabilities", year);
+    const ltd = _latestForYear("LongTermDebt", year);
+    const re = _latestForYear("RetainedEarningsAccumulatedDeficit", year);
+    const te = _latestForYear("StockholdersEquity", year);
+    const ocf = _latestForYear("NetCashProvidedByUsedInOperatingActivities", year);
+    const capex = _latestForYear("PaymentsToAcquirePropertyPlantAndEquipment", year);
+    const gp = _latestForYear("GrossProfit", year);
+    const int = _latestForYear("InterestExpense", year);
+    const tax = _latestForYear("IncomeTaxExpense", year) || _latestForYear("IncomeTaxesPaidNet", year);
+    results.push({
+      fiscalYear: year,
+      income: {
+        revenue: rev,
+        grossProfit: gp,
+        cogs: rev - gp,
+        ebit,
+        ebitda: 0,
+        netIncome: ni,
+        interestExpense: Math.abs(int),
+        incomeTaxExpense: tax,
+        ebt: ni + tax,
+        depreciationAndAmortization: 0,
+        sharesOutstanding: 0,
+        eps: 0
+      },
+      balance: {
+        totalAssets: ta,
+        currentAssets: ca,
+        cash,
+        accountsReceivable: ar,
+        inventory: inv,
+        netPPE: 0,
+        goodwill: 0,
+        retainedEarnings: re,
+        totalLiabilities: tl,
+        currentLiabilities: cl,
+        accountsPayable: 0,
+        longTermDebt: ltd,
+        totalDebt: ltd,
+        totalEquity: te,
+        sharesOutstanding: 0
+      },
+      cashFlow: {
+        operatingCashFlow: ocf,
+        capex: Math.abs(capex),
+        investingCashFlow: 0,
+        financingCashFlow: 0
+      }
+    });
+  }
+  return results;
+}
+async function _get(url) {
+  const resp = await fetch(url, { headers: HEADERS });
+  if (!resp.ok) throw new Error(`EDGAR request failed: ${resp.status} ${url}`);
+  return resp.json();
+}
+
+export { fetchEdgar };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/fetchers/edgar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/fetchers/edgar/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * SEC EDGAR fetcher for fin-ratios (TypeScript).\n *\n * Fetches financial data from the free SEC EDGAR XBRL API.\n * No API key required. US companies only.\n *\n * Rate limit: ~10 requests/second (SEC guidelines). Add delays for bulk use.\n *\n * @example\n * import { fetchEdgar } from 'fin-ratios/fetchers/edgar'\n * const filings = await fetchEdgar('AAPL', { numYears: 3 })\n * for (const f of filings) {\n *   console.log(`${f.fiscalYear}: Revenue $${(f.income.revenue/1e9).toFixed(1)}B`)\n * }\n */\n\nimport type { IncomeStatement, BalanceSheet, CashFlowStatement } from '../../types/index.js'\n\nconst COMPANY_TICKERS_URL = 'https://data.sec.gov/files/company_tickers.json'\nconst EDGAR_BASE = 'https://data.sec.gov/api/xbrl/companyfacts'\n\nconst HEADERS = {\n  'User-Agent': 'fin-ratios/0.1.0 contact@fin-ratios.dev',\n  'Accept-Encoding': 'gzip, deflate',\n}\n\nexport interface EdgarOptions {\n  numYears?: number\n}\n\nexport interface EdgarFilingData {\n  fiscalYear: string\n  income: IncomeStatement\n  balance: BalanceSheet\n  cashFlow: CashFlowStatement\n}\n\n/**\n * Fetch multi-year annual filings from SEC EDGAR for a US stock ticker.\n */\nexport async function fetchEdgar(\n  ticker: string,\n  options: EdgarOptions = {}\n): Promise<EdgarFilingData[]> {\n  const { numYears = 3 } = options\n\n  // Step 1: Resolve ticker → CIK\n  const tickerMap = (await _get(COMPANY_TICKERS_URL)) as Record<string, { cik_str: number; ticker: string; title: string }>\n  const entry = Object.values(tickerMap).find(v => v.ticker.toUpperCase() === ticker.toUpperCase())\n  if (!entry) throw new Error(`EDGAR: ticker ${ticker} not found`)\n\n  const cik = String(entry.cik_str).padStart(10, '0')\n\n  // Step 2: Fetch company facts (XBRL)\n  const facts = (await _get(`${EDGAR_BASE}/CIK${cik}.json`)) as {\n    facts: {\n      'us-gaap'?: Record<string, { units: { USD?: { val: number; end: string; form: string; fp: string }[] } }>\n    }\n  }\n\n  const gaap = facts.facts['us-gaap'] ?? {}\n\n  function _annual(concept: string): { end: string; val: number }[] {\n    const entries = gaap[concept]?.units?.USD ?? []\n    return entries\n      .filter(e => e.form === '10-K')\n      .sort((a, b) => b.end.localeCompare(a.end))\n  }\n\n  function _latestForYear(concept: string, year: string): number {\n    const annual = _annual(concept)\n    const match = annual.find(e => e.end.startsWith(year))\n    return match?.val ?? 0\n  }\n\n  // Collect available fiscal years from revenue\n  const revenueEntries = _annual('Revenues').concat(_annual('RevenueFromContractWithCustomerExcludingAssessedTax'))\n  const years = [...new Set(revenueEntries.map(e => e.end.slice(0, 4)))].slice(0, numYears)\n\n  const results: EdgarFilingData[] = []\n\n  for (const year of years) {\n    const rev   = _latestForYear('Revenues', year) || _latestForYear('RevenueFromContractWithCustomerExcludingAssessedTax', year)\n    const ni    = _latestForYear('NetIncomeLoss', year)\n    const ebit  = _latestForYear('OperatingIncomeLoss', year)\n    const ta    = _latestForYear('Assets', year)\n    const ca    = _latestForYear('AssetsCurrent', year)\n    const cash  = _latestForYear('CashAndCashEquivalentsAtCarryingValue', year)\n    const ar    = _latestForYear('AccountsReceivableNetCurrent', year)\n    const inv   = _latestForYear('InventoryNet', year)\n    const cl    = _latestForYear('LiabilitiesCurrent', year)\n    const tl    = _latestForYear('Liabilities', year)\n    const ltd   = _latestForYear('LongTermDebt', year)\n    const re    = _latestForYear('RetainedEarningsAccumulatedDeficit', year)\n    const te    = _latestForYear('StockholdersEquity', year)\n    const ocf   = _latestForYear('NetCashProvidedByUsedInOperatingActivities', year)\n    const capex = _latestForYear('PaymentsToAcquirePropertyPlantAndEquipment', year)\n    const gp    = _latestForYear('GrossProfit', year)\n    const int   = _latestForYear('InterestExpense', year)\n    const tax   = _latestForYear('IncomeTaxExpense', year) || _latestForYear('IncomeTaxesPaidNet', year)\n\n    results.push({\n      fiscalYear: year,\n      income: {\n        revenue: rev, grossProfit: gp, cogs: rev - gp,\n        ebit, ebitda: 0, netIncome: ni,\n        interestExpense: Math.abs(int), incomeTaxExpense: tax, ebt: ni + tax,\n        depreciationAndAmortization: 0, sharesOutstanding: 0, eps: 0,\n      },\n      balance: {\n        totalAssets: ta, currentAssets: ca, cash, accountsReceivable: ar,\n        inventory: inv, netPPE: 0, goodwill: 0,\n        retainedEarnings: re, totalLiabilities: tl, currentLiabilities: cl,\n        accountsPayable: 0, longTermDebt: ltd, totalDebt: ltd,\n        totalEquity: te, sharesOutstanding: 0,\n      },\n      cashFlow: {\n        operatingCashFlow: ocf, capex: Math.abs(capex),\n        investingCashFlow: 0, financingCashFlow: 0,\n      },\n    })\n  }\n\n  return results\n}\n\nasync function _get(url: string): Promise<unknown> {\n  const resp = await fetch(url, { headers: HEADERS })\n  if (!resp.ok) throw new Error(`EDGAR request failed: ${resp.status} ${url}`)\n  return resp.json()\n}\n"]}

package/dist/fetchers/fmp/index.cjs

@@ -0,0 +1,110 @@
+'use strict';
+
+// src/fetchers/fmp/index.ts
+var FMP_BASE = "https://financialmodelingprep.com/api/v3";
+async function fetchFmp(ticker, options) {
+  const { apiKey, periods = 4, quarterly = false } = options;
+  const period = quarterly ? "quarter" : "annual";
+  const limit = periods;
+  const [incData, balData, cfData, ratioData, profileData] = await Promise.all([
+    _get(`${FMP_BASE}/income-statement/${ticker}`, apiKey, { period, limit }),
+    _get(`${FMP_BASE}/balance-sheet-statement/${ticker}`, apiKey, { period, limit }),
+    _get(`${FMP_BASE}/cash-flow-statement/${ticker}`, apiKey, { period, limit }),
+    _get(`${FMP_BASE}/ratios/${ticker}`, apiKey, { period, limit }),
+    _get(`${FMP_BASE}/profile/${ticker}`, apiKey, {})
+  ]);
+  const profile = profileData[0] ?? {};
+  const results = [];
+  for (let i = 0; i < Math.min(limit, incData.length); i++) {
+    const inc = incData[i] ?? {};
+    const bal = balData[i] ?? {};
+    const cf = cfData[i] ?? {};
+    const rat = ratioData[i] ?? {};
+    results.push({
+      period: inc.date ?? "",
+      income: {
+        revenue: _n(inc.revenue),
+        grossProfit: _n(inc.grossProfit),
+        cogs: _n(inc.costOfRevenue),
+        ebit: _n(inc.operatingIncome),
+        ebitda: _n(inc.ebitda),
+        netIncome: _n(inc.netIncome),
+        interestExpense: Math.abs(_n(inc.interestExpense)),
+        incomeTaxExpense: _n(inc.incomeTaxExpense),
+        ebt: _n(inc.incomeBeforeTax),
+        depreciationAndAmortization: _n(inc.depreciationAndAmortization),
+        sharesOutstanding: _n(inc.weightedAverageShsOut),
+        eps: _n(inc.eps),
+        epsDiluted: _n(inc.epsdiluted)
+      },
+      balance: {
+        totalAssets: _n(bal.totalAssets),
+        currentAssets: _n(bal.totalCurrentAssets),
+        cash: _n(bal.cashAndCashEquivalents),
+        accountsReceivable: _n(bal.netReceivables),
+        inventory: _n(bal.inventory),
+        netPPE: _n(bal.propertyPlantEquipmentNet),
+        goodwill: _n(bal.goodwill),
+        intangibleAssets: _n(bal.intangibleAssets),
+        retainedEarnings: _n(bal.retainedEarnings),
+        totalLiabilities: _n(bal.totalLiabilities),
+        currentLiabilities: _n(bal.totalCurrentLiabilities),
+        accountsPayable: _n(bal.accountPayables),
+        longTermDebt: _n(bal.longTermDebt),
+        totalDebt: _n(bal.totalDebt),
+        totalEquity: _n(bal.totalStockholdersEquity),
+        sharesOutstanding: _n(inc.weightedAverageShsOut)
+      },
+      cashFlow: {
+        operatingCashFlow: _n(cf.operatingCashFlow),
+        capex: Math.abs(_n(cf.capitalExpenditure)),
+        investingCashFlow: _n(cf.investingActivitiesCashFlow),
+        financingCashFlow: _n(cf.financingActivitiesCashFlow),
+        dividendsPaid: _n(cf.commonDividendsPaid),
+        stockBasedCompensation: _n(cf.stockBasedCompensation),
+        debtRepayments: _n(cf.debtRepayment)
+      },
+      marketData: {
+        price: _n(profile.price),
+        marketCap: _n(profile.mktCap),
+        sharesOutstanding: _n(inc.weightedAverageShsOut),
+        ticker
+      },
+      ratios: {
+        peRatio: _n(rat.priceEarningsRatio),
+        pbRatio: _n(rat.priceToBookRatio),
+        psRatio: _n(rat.priceToSalesRatio),
+        evToEbitda: _n(rat.enterpriseValueMultiple),
+        roic: _n(rat.returnOnCapitalEmployed),
+        roe: _n(rat.returnOnEquity),
+        roa: _n(rat.returnOnAssets),
+        currentRatio: _n(rat.currentRatio),
+        debtToEquity: _n(rat.debtEquityRatio),
+        grossMargin: _n(rat.grossProfitMargin),
+        operatingMargin: _n(rat.operatingProfitMargin),
+        netMargin: _n(rat.netProfitMargin)
+      }
+    });
+  }
+  return results;
+}
+async function fetchFmpSp500(apiKey) {
+  const data = await _get(`${FMP_BASE}/sp500_constituent`, apiKey, {});
+  return data.map((d) => d.symbol).filter(Boolean);
+}
+async function _get(url, apiKey, params) {
+  const query = new URLSearchParams({ ...Object.fromEntries(Object.entries(params).map(([k, v]) => [k, String(v)])), apikey: apiKey });
+  const resp = await fetch(`${url}?${query}`);
+  if (!resp.ok) throw new Error(`FMP request failed: ${resp.status} ${url}`);
+  return resp.json();
+}
+function _n(v) {
+  if (v == null) return 0;
+  const n = Number(v);
+  return isNaN(n) ? 0 : n;
+}
+
+exports.fetchFmp = fetchFmp;
+exports.fetchFmpSp500 = fetchFmpSp500;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/fetchers/fmp/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/fetchers/fmp/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Financial Modeling Prep (FMP) fetcher.\n * Free tier: 250 requests/day.\n * Get API key: https://financialmodelingprep.com/developer/docs\n */\n\nimport type {\n  IncomeStatement,\n  BalanceSheet,\n  CashFlowStatement,\n  MarketData,\n} from '../../types/index.js'\n\nconst FMP_BASE = 'https://financialmodelingprep.com/api/v3'\n\nexport interface FmpOptions {\n  apiKey: string\n  periods?: number\n  quarterly?: boolean\n}\n\nexport interface FmpPeriodData {\n  period: string\n  income: IncomeStatement\n  balance: BalanceSheet\n  cashFlow: CashFlowStatement\n  marketData: MarketData\n  ratios?: Record<string, number | null>\n}\n\n/**\n * Fetch financial statements from Financial Modeling Prep.\n *\n * @example\n * const data = await fetchFmp('AAPL', { apiKey: 'your_key', periods: 4 })\n * for (const period of data) {\n *   const roicVal = roic({ nopat: ..., investedCapital: ... })\n * }\n */\nexport async function fetchFmp(\n  ticker: string,\n  options: FmpOptions\n): Promise<FmpPeriodData[]> {\n  const { apiKey, periods = 4, quarterly = false } = options\n  const period = quarterly ? 'quarter' : 'annual'\n  const limit = periods\n\n  const [incData, balData, cfData, ratioData, profileData] = await Promise.all([\n    _get(`${FMP_BASE}/income-statement/${ticker}`, apiKey, { period, limit }),\n    _get(`${FMP_BASE}/balance-sheet-statement/${ticker}`, apiKey, { period, limit }),\n    _get(`${FMP_BASE}/cash-flow-statement/${ticker}`, apiKey, { period, limit }),\n    _get(`${FMP_BASE}/ratios/${ticker}`, apiKey, { period, limit }),\n    _get(`${FMP_BASE}/profile/${ticker}`, apiKey, {}),\n  ])\n\n  const profile = (profileData as any[])[0] ?? {}\n  const results: FmpPeriodData[] = []\n\n  for (let i = 0; i < Math.min(limit, (incData as any[]).length); i++) {\n    const inc = (incData as any[])[i] ?? {}\n    const bal = (balData as any[])[i] ?? {}\n    const cf = (cfData as any[])[i] ?? {}\n    const rat = (ratioData as any[])[i] ?? {}\n\n    results.push({\n      period: inc.date ?? '',\n      income: {\n        revenue: _n(inc.revenue),\n        grossProfit: _n(inc.grossProfit),\n        cogs: _n(inc.costOfRevenue),\n        ebit: _n(inc.operatingIncome),\n        ebitda: _n(inc.ebitda),\n        netIncome: _n(inc.netIncome),\n        interestExpense: Math.abs(_n(inc.interestExpense)),\n        incomeTaxExpense: _n(inc.incomeTaxExpense),\n        ebt: _n(inc.incomeBeforeTax),\n        depreciationAndAmortization: _n(inc.depreciationAndAmortization),\n        sharesOutstanding: _n(inc.weightedAverageShsOut),\n        eps: _n(inc.eps),\n        epsDiluted: _n(inc.epsdiluted),\n      },\n      balance: {\n        totalAssets: _n(bal.totalAssets),\n        currentAssets: _n(bal.totalCurrentAssets),\n        cash: _n(bal.cashAndCashEquivalents),\n        accountsReceivable: _n(bal.netReceivables),\n        inventory: _n(bal.inventory),\n        netPPE: _n(bal.propertyPlantEquipmentNet),\n        goodwill: _n(bal.goodwill),\n        intangibleAssets: _n(bal.intangibleAssets),\n        retainedEarnings: _n(bal.retainedEarnings),\n        totalLiabilities: _n(bal.totalLiabilities),\n        currentLiabilities: _n(bal.totalCurrentLiabilities),\n        accountsPayable: _n(bal.accountPayables),\n        longTermDebt: _n(bal.longTermDebt),\n        totalDebt: _n(bal.totalDebt),\n        totalEquity: _n(bal.totalStockholdersEquity),\n        sharesOutstanding: _n(inc.weightedAverageShsOut),\n      },\n      cashFlow: {\n        operatingCashFlow: _n(cf.operatingCashFlow),\n        capex: Math.abs(_n(cf.capitalExpenditure)),\n        investingCashFlow: _n(cf.investingActivitiesCashFlow),\n        financingCashFlow: _n(cf.financingActivitiesCashFlow),\n        dividendsPaid: _n(cf.commonDividendsPaid),\n        stockBasedCompensation: _n(cf.stockBasedCompensation),\n        debtRepayments: _n(cf.debtRepayment),\n      },\n      marketData: {\n        price: _n(profile.price),\n        marketCap: _n(profile.mktCap),\n        sharesOutstanding: _n(inc.weightedAverageShsOut),\n        ticker,\n      },\n      ratios: {\n        peRatio: _n(rat.priceEarningsRatio),\n        pbRatio: _n(rat.priceToBookRatio),\n        psRatio: _n(rat.priceToSalesRatio),\n        evToEbitda: _n(rat.enterpriseValueMultiple),\n        roic: _n(rat.returnOnCapitalEmployed),\n        roe: _n(rat.returnOnEquity),\n        roa: _n(rat.returnOnAssets),\n        currentRatio: _n(rat.currentRatio),\n        debtToEquity: _n(rat.debtEquityRatio),\n        grossMargin: _n(rat.grossProfitMargin),\n        operatingMargin: _n(rat.operatingProfitMargin),\n        netMargin: _n(rat.netProfitMargin),\n      },\n    })\n  }\n\n  return results\n}\n\n/** Fetch the current S&P 500 constituent list. */\nexport async function fetchFmpSp500(apiKey: string): Promise<string[]> {\n  const data = (await _get(`${FMP_BASE}/sp500_constituent`, apiKey, {})) as any[]\n  return data.map(d => d.symbol).filter(Boolean)\n}\n\nasync function _get(url: string, apiKey: string, params: Record<string, unknown>): Promise<unknown> {\n  const query = new URLSearchParams({ ...Object.fromEntries(Object.entries(params).map(([k, v]) => [k, String(v)])), apikey: apiKey })\n  const resp = await fetch(`${url}?${query}`)\n  if (!resp.ok) throw new Error(`FMP request failed: ${resp.status} ${url}`)\n  return resp.json()\n}\n\nfunction _n(v: unknown): number {\n  if (v == null) return 0\n  const n = Number(v)\n  return isNaN(n) ? 0 : n\n}\n"]}

package/dist/fetchers/fmp/index.d.cts

@@ -0,0 +1,36 @@
+import { I as IncomeStatement, B as BalanceSheet, C as CashFlowStatement } from '../../financials-DUHxWDPS.cjs';
+import { M as MarketData } from '../../market-DlMw3vK1.cjs';
+
+/**
+ * Financial Modeling Prep (FMP) fetcher.
+ * Free tier: 250 requests/day.
+ * Get API key: https://financialmodelingprep.com/developer/docs
+ */
+
+interface FmpOptions {
+    apiKey: string;
+    periods?: number;
+    quarterly?: boolean;
+}
+interface FmpPeriodData {
+    period: string;
+    income: IncomeStatement;
+    balance: BalanceSheet;
+    cashFlow: CashFlowStatement;
+    marketData: MarketData;
+    ratios?: Record<string, number | null>;
+}
+/**
+ * Fetch financial statements from Financial Modeling Prep.
+ *
+ * @example
+ * const data = await fetchFmp('AAPL', { apiKey: 'your_key', periods: 4 })
+ * for (const period of data) {
+ *   const roicVal = roic({ nopat: ..., investedCapital: ... })
+ * }
+ */
+declare function fetchFmp(ticker: string, options: FmpOptions): Promise<FmpPeriodData[]>;
+/** Fetch the current S&P 500 constituent list. */
+declare function fetchFmpSp500(apiKey: string): Promise<string[]>;
+
+export { type FmpOptions, type FmpPeriodData, fetchFmp, fetchFmpSp500 };

package/dist/fetchers/fmp/index.d.ts

@@ -0,0 +1,36 @@
+import { I as IncomeStatement, B as BalanceSheet, C as CashFlowStatement } from '../../financials-DUHxWDPS.js';
+import { M as MarketData } from '../../market-DlMw3vK1.js';
+
+/**
+ * Financial Modeling Prep (FMP) fetcher.
+ * Free tier: 250 requests/day.
+ * Get API key: https://financialmodelingprep.com/developer/docs
+ */
+
+interface FmpOptions {
+    apiKey: string;
+    periods?: number;
+    quarterly?: boolean;
+}
+interface FmpPeriodData {
+    period: string;
+    income: IncomeStatement;
+    balance: BalanceSheet;
+    cashFlow: CashFlowStatement;
+    marketData: MarketData;
+    ratios?: Record<string, number | null>;
+}
+/**
+ * Fetch financial statements from Financial Modeling Prep.
+ *
+ * @example
+ * const data = await fetchFmp('AAPL', { apiKey: 'your_key', periods: 4 })
+ * for (const period of data) {
+ *   const roicVal = roic({ nopat: ..., investedCapital: ... })
+ * }
+ */
+declare function fetchFmp(ticker: string, options: FmpOptions): Promise<FmpPeriodData[]>;
+/** Fetch the current S&P 500 constituent list. */
+declare function fetchFmpSp500(apiKey: string): Promise<string[]>;
+
+export { type FmpOptions, type FmpPeriodData, fetchFmp, fetchFmpSp500 };

package/dist/fetchers/fmp/index.js

@@ -0,0 +1,107 @@
+// src/fetchers/fmp/index.ts
+var FMP_BASE = "https://financialmodelingprep.com/api/v3";
+async function fetchFmp(ticker, options) {
+  const { apiKey, periods = 4, quarterly = false } = options;
+  const period = quarterly ? "quarter" : "annual";
+  const limit = periods;
+  const [incData, balData, cfData, ratioData, profileData] = await Promise.all([
+    _get(`${FMP_BASE}/income-statement/${ticker}`, apiKey, { period, limit }),
+    _get(`${FMP_BASE}/balance-sheet-statement/${ticker}`, apiKey, { period, limit }),
+    _get(`${FMP_BASE}/cash-flow-statement/${ticker}`, apiKey, { period, limit }),
+    _get(`${FMP_BASE}/ratios/${ticker}`, apiKey, { period, limit }),
+    _get(`${FMP_BASE}/profile/${ticker}`, apiKey, {})
+  ]);
+  const profile = profileData[0] ?? {};
+  const results = [];
+  for (let i = 0; i < Math.min(limit, incData.length); i++) {
+    const inc = incData[i] ?? {};
+    const bal = balData[i] ?? {};
+    const cf = cfData[i] ?? {};
+    const rat = ratioData[i] ?? {};
+    results.push({
+      period: inc.date ?? "",
+      income: {
+        revenue: _n(inc.revenue),
+        grossProfit: _n(inc.grossProfit),
+        cogs: _n(inc.costOfRevenue),
+        ebit: _n(inc.operatingIncome),
+        ebitda: _n(inc.ebitda),
+        netIncome: _n(inc.netIncome),
+        interestExpense: Math.abs(_n(inc.interestExpense)),
+        incomeTaxExpense: _n(inc.incomeTaxExpense),
+        ebt: _n(inc.incomeBeforeTax),
+        depreciationAndAmortization: _n(inc.depreciationAndAmortization),
+        sharesOutstanding: _n(inc.weightedAverageShsOut),
+        eps: _n(inc.eps),
+        epsDiluted: _n(inc.epsdiluted)
+      },
+      balance: {
+        totalAssets: _n(bal.totalAssets),
+        currentAssets: _n(bal.totalCurrentAssets),
+        cash: _n(bal.cashAndCashEquivalents),
+        accountsReceivable: _n(bal.netReceivables),
+        inventory: _n(bal.inventory),
+        netPPE: _n(bal.propertyPlantEquipmentNet),
+        goodwill: _n(bal.goodwill),
+        intangibleAssets: _n(bal.intangibleAssets),
+        retainedEarnings: _n(bal.retainedEarnings),
+        totalLiabilities: _n(bal.totalLiabilities),
+        currentLiabilities: _n(bal.totalCurrentLiabilities),
+        accountsPayable: _n(bal.accountPayables),
+        longTermDebt: _n(bal.longTermDebt),
+        totalDebt: _n(bal.totalDebt),
+        totalEquity: _n(bal.totalStockholdersEquity),
+        sharesOutstanding: _n(inc.weightedAverageShsOut)
+      },
+      cashFlow: {
+        operatingCashFlow: _n(cf.operatingCashFlow),
+        capex: Math.abs(_n(cf.capitalExpenditure)),
+        investingCashFlow: _n(cf.investingActivitiesCashFlow),
+        financingCashFlow: _n(cf.financingActivitiesCashFlow),
+        dividendsPaid: _n(cf.commonDividendsPaid),
+        stockBasedCompensation: _n(cf.stockBasedCompensation),
+        debtRepayments: _n(cf.debtRepayment)
+      },
+      marketData: {
+        price: _n(profile.price),
+        marketCap: _n(profile.mktCap),
+        sharesOutstanding: _n(inc.weightedAverageShsOut),
+        ticker
+      },
+      ratios: {
+        peRatio: _n(rat.priceEarningsRatio),
+        pbRatio: _n(rat.priceToBookRatio),
+        psRatio: _n(rat.priceToSalesRatio),
+        evToEbitda: _n(rat.enterpriseValueMultiple),
+        roic: _n(rat.returnOnCapitalEmployed),
+        roe: _n(rat.returnOnEquity),
+        roa: _n(rat.returnOnAssets),
+        currentRatio: _n(rat.currentRatio),
+        debtToEquity: _n(rat.debtEquityRatio),
+        grossMargin: _n(rat.grossProfitMargin),
+        operatingMargin: _n(rat.operatingProfitMargin),
+        netMargin: _n(rat.netProfitMargin)
+      }
+    });
+  }
+  return results;
+}
+async function fetchFmpSp500(apiKey) {
+  const data = await _get(`${FMP_BASE}/sp500_constituent`, apiKey, {});
+  return data.map((d) => d.symbol).filter(Boolean);
+}
+async function _get(url, apiKey, params) {
+  const query = new URLSearchParams({ ...Object.fromEntries(Object.entries(params).map(([k, v]) => [k, String(v)])), apikey: apiKey });
+  const resp = await fetch(`${url}?${query}`);
+  if (!resp.ok) throw new Error(`FMP request failed: ${resp.status} ${url}`);
+  return resp.json();
+}
+function _n(v) {
+  if (v == null) return 0;
+  const n = Number(v);
+  return isNaN(n) ? 0 : n;
+}
+
+export { fetchFmp, fetchFmpSp500 };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/fetchers/fmp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/fetchers/fmp/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Financial Modeling Prep (FMP) fetcher.\n * Free tier: 250 requests/day.\n * Get API key: https://financialmodelingprep.com/developer/docs\n */\n\nimport type {\n  IncomeStatement,\n  BalanceSheet,\n  CashFlowStatement,\n  MarketData,\n} from '../../types/index.js'\n\nconst FMP_BASE = 'https://financialmodelingprep.com/api/v3'\n\nexport interface FmpOptions {\n  apiKey: string\n  periods?: number\n  quarterly?: boolean\n}\n\nexport interface FmpPeriodData {\n  period: string\n  income: IncomeStatement\n  balance: BalanceSheet\n  cashFlow: CashFlowStatement\n  marketData: MarketData\n  ratios?: Record<string, number | null>\n}\n\n/**\n * Fetch financial statements from Financial Modeling Prep.\n *\n * @example\n * const data = await fetchFmp('AAPL', { apiKey: 'your_key', periods: 4 })\n * for (const period of data) {\n *   const roicVal = roic({ nopat: ..., investedCapital: ... })\n * }\n */\nexport async function fetchFmp(\n  ticker: string,\n  options: FmpOptions\n): Promise<FmpPeriodData[]> {\n  const { apiKey, periods = 4, quarterly = false } = options\n  const period = quarterly ? 'quarter' : 'annual'\n  const limit = periods\n\n  const [incData, balData, cfData, ratioData, profileData] = await Promise.all([\n    _get(`${FMP_BASE}/income-statement/${ticker}`, apiKey, { period, limit }),\n    _get(`${FMP_BASE}/balance-sheet-statement/${ticker}`, apiKey, { period, limit }),\n    _get(`${FMP_BASE}/cash-flow-statement/${ticker}`, apiKey, { period, limit }),\n    _get(`${FMP_BASE}/ratios/${ticker}`, apiKey, { period, limit }),\n    _get(`${FMP_BASE}/profile/${ticker}`, apiKey, {}),\n  ])\n\n  const profile = (profileData as any[])[0] ?? {}\n  const results: FmpPeriodData[] = []\n\n  for (let i = 0; i < Math.min(limit, (incData as any[]).length); i++) {\n    const inc = (incData as any[])[i] ?? {}\n    const bal = (balData as any[])[i] ?? {}\n    const cf = (cfData as any[])[i] ?? {}\n    const rat = (ratioData as any[])[i] ?? {}\n\n    results.push({\n      period: inc.date ?? '',\n      income: {\n        revenue: _n(inc.revenue),\n        grossProfit: _n(inc.grossProfit),\n        cogs: _n(inc.costOfRevenue),\n        ebit: _n(inc.operatingIncome),\n        ebitda: _n(inc.ebitda),\n        netIncome: _n(inc.netIncome),\n        interestExpense: Math.abs(_n(inc.interestExpense)),\n        incomeTaxExpense: _n(inc.incomeTaxExpense),\n        ebt: _n(inc.incomeBeforeTax),\n        depreciationAndAmortization: _n(inc.depreciationAndAmortization),\n        sharesOutstanding: _n(inc.weightedAverageShsOut),\n        eps: _n(inc.eps),\n        epsDiluted: _n(inc.epsdiluted),\n      },\n      balance: {\n        totalAssets: _n(bal.totalAssets),\n        currentAssets: _n(bal.totalCurrentAssets),\n        cash: _n(bal.cashAndCashEquivalents),\n        accountsReceivable: _n(bal.netReceivables),\n        inventory: _n(bal.inventory),\n        netPPE: _n(bal.propertyPlantEquipmentNet),\n        goodwill: _n(bal.goodwill),\n        intangibleAssets: _n(bal.intangibleAssets),\n        retainedEarnings: _n(bal.retainedEarnings),\n        totalLiabilities: _n(bal.totalLiabilities),\n        currentLiabilities: _n(bal.totalCurrentLiabilities),\n        accountsPayable: _n(bal.accountPayables),\n        longTermDebt: _n(bal.longTermDebt),\n        totalDebt: _n(bal.totalDebt),\n        totalEquity: _n(bal.totalStockholdersEquity),\n        sharesOutstanding: _n(inc.weightedAverageShsOut),\n      },\n      cashFlow: {\n        operatingCashFlow: _n(cf.operatingCashFlow),\n        capex: Math.abs(_n(cf.capitalExpenditure)),\n        investingCashFlow: _n(cf.investingActivitiesCashFlow),\n        financingCashFlow: _n(cf.financingActivitiesCashFlow),\n        dividendsPaid: _n(cf.commonDividendsPaid),\n        stockBasedCompensation: _n(cf.stockBasedCompensation),\n        debtRepayments: _n(cf.debtRepayment),\n      },\n      marketData: {\n        price: _n(profile.price),\n        marketCap: _n(profile.mktCap),\n        sharesOutstanding: _n(inc.weightedAverageShsOut),\n        ticker,\n      },\n      ratios: {\n        peRatio: _n(rat.priceEarningsRatio),\n        pbRatio: _n(rat.priceToBookRatio),\n        psRatio: _n(rat.priceToSalesRatio),\n        evToEbitda: _n(rat.enterpriseValueMultiple),\n        roic: _n(rat.returnOnCapitalEmployed),\n        roe: _n(rat.returnOnEquity),\n        roa: _n(rat.returnOnAssets),\n        currentRatio: _n(rat.currentRatio),\n        debtToEquity: _n(rat.debtEquityRatio),\n        grossMargin: _n(rat.grossProfitMargin),\n        operatingMargin: _n(rat.operatingProfitMargin),\n        netMargin: _n(rat.netProfitMargin),\n      },\n    })\n  }\n\n  return results\n}\n\n/** Fetch the current S&P 500 constituent list. */\nexport async function fetchFmpSp500(apiKey: string): Promise<string[]> {\n  const data = (await _get(`${FMP_BASE}/sp500_constituent`, apiKey, {})) as any[]\n  return data.map(d => d.symbol).filter(Boolean)\n}\n\nasync function _get(url: string, apiKey: string, params: Record<string, unknown>): Promise<unknown> {\n  const query = new URLSearchParams({ ...Object.fromEntries(Object.entries(params).map(([k, v]) => [k, String(v)])), apikey: apiKey })\n  const resp = await fetch(`${url}?${query}`)\n  if (!resp.ok) throw new Error(`FMP request failed: ${resp.status} ${url}`)\n  return resp.json()\n}\n\nfunction _n(v: unknown): number {\n  if (v == null) return 0\n  const n = Number(v)\n  return isNaN(n) ? 0 : n\n}\n"]}