fin-ratios 0.1.0

package/dist/fetchers/yahoo/index.cjs

@@ -0,0 +1,134 @@
+'use strict';
+
+// src/fetchers/yahoo/index.ts
+var BASE = "https://query1.finance.yahoo.com/v10/finance/quoteSummary";
+var HEADERS = {
+  "User-Agent": "Mozilla/5.0 (compatible; fin-ratios/0.1)",
+  "Accept": "application/json"
+};
+async function fetchYahoo(ticker, options = {}) {
+  const modules = [
+    "financialData",
+    "defaultKeyStatistics",
+    "summaryDetail",
+    "assetProfile",
+    "incomeStatementHistory",
+    "balanceSheetHistory",
+    "cashflowStatementHistory",
+    ...options.modules ?? []
+  ].join(",");
+  const url = `${BASE}/${encodeURIComponent(ticker)}?modules=${modules}`;
+  const resp = await fetch(url, { headers: HEADERS });
+  if (!resp.ok) {
+    throw new Error(`Yahoo Finance request failed: ${resp.status} for ${ticker}`);
+  }
+  const json = await resp.json();
+  const result = json?.quoteSummary?.result?.[0];
+  if (!result) {
+    throw new Error(`No data returned for ${ticker}`);
+  }
+  const fd = result.financialData ?? {};
+  const ks = result.defaultKeyStatistics ?? {};
+  const sd = result.summaryDetail ?? {};
+  const ap = result.assetProfile ?? {};
+  const inc = result.incomeStatementHistory?.incomeStatementHistory?.[0] ?? {};
+  const bal = result.balanceSheetHistory?.balanceSheetHistory?.[0] ?? {};
+  const cf = result.cashflowStatementHistory?.cashflowStatementHistory?.[0] ?? {};
+  const price = _n(fd.currentPrice) ?? _n(fd.regularMarketPrice) ?? 0;
+  const marketCap = _n(ks.marketCap) ?? 0;
+  const shares = _n(ks.sharesOutstanding) ?? 0;
+  const base = {
+    marketData: {
+      price,
+      marketCap,
+      sharesOutstanding: shares,
+      enterpriseValue: _n(ks.enterpriseValue),
+      forwardEps: _n(ks.forwardEps),
+      trailingEps: _n(ks.trailingEps),
+      dividendPerShare: _n(sd.dividendRate),
+      ticker
+    },
+    income: {
+      revenue: _n(inc.totalRevenue) ?? _n(fd.totalRevenue) ?? 0,
+      grossProfit: _n(inc.grossProfit) ?? 0,
+      cogs: (_n(inc.totalRevenue) ?? 0) - (_n(inc.grossProfit) ?? 0),
+      ebit: _n(inc.ebit) ?? _n(fd.operatingCashflow) ?? 0,
+      ebitda: _n(fd.ebitda) ?? 0,
+      netIncome: _n(inc.netIncome) ?? _n(fd.netIncomeToCommon) ?? 0,
+      interestExpense: Math.abs(_n(inc.interestExpense) ?? 0),
+      incomeTaxExpense: _n(inc.incomeTaxExpense) ?? 0,
+      ebt: _n(inc.pretaxIncome) ?? 0,
+      depreciationAndAmortization: 0,
+      // Not available in this module
+      sharesOutstanding: shares,
+      eps: _n(ks.trailingEps)
+    },
+    balance: {
+      totalAssets: _n(bal.totalAssets) ?? 0,
+      currentAssets: _n(bal.totalCurrentAssets) ?? 0,
+      cash: _n(bal.cash) ?? _n(fd.totalCash) ?? 0,
+      shortTermInvestments: _n(bal.shortTermInvestments),
+      accountsReceivable: _n(bal.netReceivables) ?? 0,
+      inventory: _n(bal.inventory) ?? 0,
+      netPPE: _n(bal.propertyPlantEquipment) ?? 0,
+      goodwill: _n(bal.goodWill),
+      intangibleAssets: _n(bal.intangibleAssets),
+      retainedEarnings: _n(bal.retainedEarnings) ?? 0,
+      totalLiabilities: _n(bal.totalLiab) ?? 0,
+      currentLiabilities: _n(bal.totalCurrentLiabilities) ?? 0,
+      accountsPayable: _n(bal.accountsPayable) ?? 0,
+      shortTermDebt: _n(bal.shortLongTermDebt),
+      longTermDebt: _n(bal.longTermDebt) ?? _n(fd.totalDebt) ?? 0,
+      totalDebt: _n(fd.totalDebt) ?? 0,
+      totalEquity: _n(bal.totalStockholderEquity) ?? 0,
+      sharesOutstanding: shares
+    },
+    cashFlow: {
+      operatingCashFlow: _n(cf.totalCashFromOperatingActivities) ?? _n(fd.operatingCashflow) ?? 0,
+      capex: Math.abs(_n(cf.capitalExpenditures) ?? 0),
+      investingCashFlow: _n(cf.totalCashflowsFromInvestingActivities),
+      financingCashFlow: _n(cf.totalCashFromFinancingActivities),
+      dividendsPaid: _n(cf.dividendsPaid),
+      stockBasedCompensation: _n(cf.stockBasedCompensation)
+    },
+    sector: ap.sector,
+    industry: ap.industry
+  };
+  const empCount = _n(ap.fullTimeEmployees);
+  if (empCount != null) base.employeeCount = empCount;
+  const betaVal = _n(ks.beta);
+  if (betaVal != null) base.beta = betaVal;
+  const divYield = _n(sd.dividendYield);
+  if (divYield != null) base.dividendYield = divYield;
+  return base;
+}
+async function fetchPriceHistory(ticker, period = "1y") {
+  const url = `https://query1.finance.yahoo.com/v8/finance/chart/${encodeURIComponent(ticker)}?range=${period}&interval=1d`;
+  const resp = await fetch(url, { headers: HEADERS });
+  if (!resp.ok) throw new Error(`Price history request failed for ${ticker}`);
+  const json = await resp.json();
+  const chart = json?.chart?.result?.[0];
+  if (!chart) throw new Error(`No price data for ${ticker}`);
+  const timestamps = chart.timestamp ?? [];
+  const closes = chart.indicators?.quote?.[0]?.close ?? [];
+  const dates = [];
+  const prices = [];
+  for (let i = 0; i < timestamps.length; i++) {
+    if (closes[i] != null) {
+      dates.push(new Date((timestamps[i] ?? 0) * 1e3).toISOString().split("T")[0]);
+      prices.push(closes[i]);
+    }
+  }
+  return { dates, prices };
+}
+function _n(v) {
+  if (v == null) return null;
+  const raw = typeof v === "object" ? v.raw ?? v : v;
+  const n = Number(raw);
+  return isNaN(n) ? null : n;
+}
+
+exports.fetchPriceHistory = fetchPriceHistory;
+exports.fetchYahoo = fetchYahoo;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/fetchers/yahoo/index.ts"],"names":[],"mappings":";;;AAiBA,IAAM,IAAA,GAAO,2DAAA;AACb,IAAM,OAAA,GAAU;AAAA,EACd,YAAA,EAAc,0CAAA;AAAA,EACd,QAAA,EAAU;AACZ,CAAA;AA0BA,eAAsB,UAAA,CACpB,MAAA,EACA,OAAA,GAA6B,EAAC,EACV;AACpB,EAAA,MAAM,OAAA,GAAU;AAAA,IACd,eAAA;AAAA,IACA,sBAAA;AAAA,IACA,eAAA;AAAA,IACA,cAAA;AAAA,IACA,wBAAA;AAAA,IACA,qBAAA;AAAA,IACA,0BAAA;AAAA,IACA,GAAI,OAAA,CAAQ,OAAA,IAAW;AAAC,GAC1B,CAAE,KAAK,GAAG,CAAA;AAEV,EAAA,MAAM,GAAA,GAAM,GAAG,IAAI,CAAA,CAAA,EAAI,mBAAmB,MAAM,CAAC,YAAY,OAAO,CAAA,CAAA;AAEpE,EAAA,MAAM,OAAO,MAAM,KAAA,CAAM,KAAK,EAAE,OAAA,EAAS,SAAS,CAAA;AAClD,EAAA,IAAI,CAAC,KAAK,EAAA,EAAI;AACZ,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,8BAAA,EAAiC,KAAK,MAAM,CAAA,KAAA,EAAQ,MAAM,CAAA,CAAE,CAAA;AAAA,EAC9E;AAEA,EAAA,MAAM,IAAA,GAAQ,MAAM,IAAA,CAAK,IAAA,EAAK;AAC9B,EAAA,MAAM,MAAA,GAAU,IAAA,EAAM,YAAA,EAAsB,MAAA,GAAS,CAAC,CAAA;AACtD,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,qBAAA,EAAwB,MAAM,CAAA,CAAE,CAAA;AAAA,EAClD;AAEA,EAAA,MAAM,EAAA,GAAK,MAAA,CAAO,aAAA,IAAiB,EAAC;AACpC,EAAA,MAAM,EAAA,GAAK,MAAA,CAAO,oBAAA,IAAwB,EAAC;AAC3C,EAAA,MAAM,EAAA,GAAK,MAAA,CAAO,aAAA,IAAiB,EAAC;AACpC,EAAA,MAAM,EAAA,GAAK,MAAA,CAAO,YAAA,IAAgB,EAAC;AAGnC,EAAA,MAAM,MAAM,MAAA,CAAO,sBAAA,EAAwB,sBAAA,GAAyB,CAAC,KAAK,EAAC;AAE3E,EAAA,MAAM,MAAM,MAAA,CAAO,mBAAA,EAAqB,mBAAA,GAAsB,CAAC,KAAK,EAAC;AAErE,EAAA,MAAM,KAAK,MAAA,CAAO,wBAAA,EAA0B,wBAAA,GAA2B,CAAC,KAAK,EAAC;AAE9E,EAAA,MAAM,KAAA,GAAQ,GAAG,EAAA,CAAG,YAAY,KAAK,EAAA,CAAG,EAAA,CAAG,kBAAkB,CAAA,IAAK,CAAA;AAClE,EAAA,MAAM,SAAA,GAAY,EAAA,CAAG,EAAA,CAAG,SAAS,CAAA,IAAK,CAAA;AACtC,EAAA,MAAM,MAAA,GAAS,EAAA,CAAG,EAAA,CAAG,iBAAiB,CAAA,IAAK,CAAA;AAE3C,EAAA,MAAM,IAAA,GAAkB;AAAA,IACtB,UAAA,EAAY;AAAA,MACV,KAAA;AAAA,MACA,SAAA;AAAA,MACA,iBAAA,EAAmB,MAAA;AAAA,MACnB,eAAA,EAAiB,EAAA,CAAG,EAAA,CAAG,eAAe,CAAA;AAAA,MACtC,UAAA,EAAY,EAAA,CAAG,EAAA,CAAG,UAAU,CAAA;AAAA,MAC5B,WAAA,EAAa,EAAA,CAAG,EAAA,CAAG,WAAW,CAAA;AAAA,MAC9B,gBAAA,EAAkB,EAAA,CAAG,EAAA,CAAG,YAAY,CAAA;AAAA,MACpC;AAAA,KACF;AAAA,IACA,MAAA,EAAQ;AAAA,MACN,OAAA,EAAS,GAAG,GAAA,CAAI,YAAY,KAAK,EAAA,CAAG,EAAA,CAAG,YAAY,CAAA,IAAK,CAAA;AAAA,MACxD,WAAA,EAAa,EAAA,CAAG,GAAA,CAAI,WAAW,CAAA,IAAK,CAAA;AAAA,MACpC,IAAA,EAAA,CAAO,GAAG,GAAA,CAAI,YAAY,KAAK,CAAA,KAAM,EAAA,CAAG,GAAA,CAAI,WAAW,CAAA,IAAK,CAAA,CAAA;AAAA,MAC5D,IAAA,EAAM,GAAG,GAAA,CAAI,IAAI,KAAK,EAAA,CAAG,EAAA,CAAG,iBAAiB,CAAA,IAAK,CAAA;AAAA,MAClD,MAAA,EAAQ,EAAA,CAAG,EAAA,CAAG,MAAM,CAAA,IAAK,CAAA;AAAA,MACzB,SAAA,EAAW,GAAG,GAAA,CAAI,SAAS,KAAK,EAAA,CAAG,EAAA,CAAG,iBAAiB,CAAA,IAAK,CAAA;AAAA,MAC5D,iBAAiB,IAAA,CAAK,GAAA,CAAI,GAAG,GAAA,CAAI,eAAe,KAAK,CAAC,CAAA;AAAA,MACtD,gBAAA,EAAkB,EAAA,CAAG,GAAA,CAAI,gBAAgB,CAAA,IAAK,CAAA;AAAA,MAC9C,GAAA,EAAK,EAAA,CAAG,GAAA,CAAI,YAAY,CAAA,IAAK,CAAA;AAAA,MAC7B,2BAAA,EAA6B,CAAA;AAAA;AAAA,MAC7B,iBAAA,EAAmB,MAAA;AAAA,MACnB,GAAA,EAAK,EAAA,CAAG,EAAA,CAAG,WAAW;AAAA,KACxB;AAAA,IACA,OAAA,EAAS;AAAA,MACP,WAAA,EAAa,EAAA,CAAG,GAAA,CAAI,WAAW,CAAA,IAAK,CAAA;AAAA,MACpC,aAAA,EAAe,EAAA,CAAG,GAAA,CAAI,kBAAkB,CAAA,IAAK,CAAA;AAAA,MAC7C,IAAA,EAAM,GAAG,GAAA,CAAI,IAAI,KAAK,EAAA,CAAG,EAAA,CAAG,SAAS,CAAA,IAAK,CAAA;AAAA,MAC1C,oBAAA,EAAsB,EAAA,CAAG,GAAA,CAAI,oBAAoB,CAAA;AAAA,MACjD,kBAAA,EAAoB,EAAA,CAAG,GAAA,CAAI,cAAc,CAAA,IAAK,CAAA;AAAA,MAC9C,SAAA,EAAW,EAAA,CAAG,GAAA,CAAI,SAAS,CAAA,IAAK,CAAA;AAAA,MAChC,MAAA,EAAQ,EAAA,CAAG,GAAA,CAAI,sBAAsB,CAAA,IAAK,CAAA;AAAA,MAC1C,QAAA,EAAU,EAAA,CAAG,GAAA,CAAI,QAAQ,CAAA;AAAA,MACzB,gBAAA,EAAkB,EAAA,CAAG,GAAA,CAAI,gBAAgB,CAAA;AAAA,MACzC,gBAAA,EAAkB,EAAA,CAAG,GAAA,CAAI,gBAAgB,CAAA,IAAK,CAAA;AAAA,MAC9C,gBAAA,EAAkB,EAAA,CAAG,GAAA,CAAI,SAAS,CAAA,IAAK,CAAA;AAAA,MACvC,kBAAA,EAAoB,EAAA,CAAG,GAAA,CAAI,uBAAuB,CAAA,IAAK,CAAA;AAAA,MACvD,eAAA,EAAiB,EAAA,CAAG,GAAA,CAAI,eAAe,CAAA,IAAK,CAAA;AAAA,MAC5C,aAAA,EAAe,EAAA,CAAG,GAAA,CAAI,iBAAiB,CAAA;AAAA,MACvC,YAAA,EAAc,GAAG,GAAA,CAAI,YAAY,KAAK,EAAA,CAAG,EAAA,CAAG,SAAS,CAAA,IAAK,CAAA;AAAA,MAC1D,SAAA,EAAW,EAAA,CAAG,EAAA,CAAG,SAAS,CAAA,IAAK,CAAA;AAAA,MAC/B,WAAA,EAAa,EAAA,CAAG,GAAA,CAAI,sBAAsB,CAAA,IAAK,CAAA;AAAA,MAC/C,iBAAA,EAAmB;AAAA,KACrB;AAAA,IACA,QAAA,EAAU;AAAA,MACR,iBAAA,EAAmB,GAAG,EAAA,CAAG,gCAAgC,KAAK,EAAA,CAAG,EAAA,CAAG,iBAAiB,CAAA,IAAK,CAAA;AAAA,MAC1F,OAAO,IAAA,CAAK,GAAA,CAAI,GAAG,EAAA,CAAG,mBAAmB,KAAK,CAAC,CAAA;AAAA,MAC/C,iBAAA,EAAmB,EAAA,CAAG,EAAA,CAAG,qCAAqC,CAAA;AAAA,MAC9D,iBAAA,EAAmB,EAAA,CAAG,EAAA,CAAG,gCAAgC,CAAA;AAAA,MACzD,aAAA,EAAe,EAAA,CAAG,EAAA,CAAG,aAAa,CAAA;AAAA,MAClC,sBAAA,EAAwB,EAAA,CAAG,EAAA,CAAG,sBAAsB;AAAA,KACtD;AAAA,IACA,QAAQ,EAAA,CAAG,MAAA;AAAA,IACX,UAAU,EAAA,CAAG;AAAA,GACf;AACA,EAAA,MAAM,QAAA,GAAW,EAAA,CAAG,EAAA,CAAG,iBAAiB,CAAA;AAAG,EAAA,IAAI,QAAA,IAAY,IAAA,EAAM,IAAA,CAAK,aAAA,GAAgB,QAAA;AACtF,EAAA,MAAM,OAAA,GAAW,EAAA,CAAG,EAAA,CAAG,IAAI,CAAA;AAAe,EAAA,IAAI,OAAA,IAAY,IAAA,EAAM,IAAA,CAAK,IAAA,GAAgB,OAAA;AACrF,EAAA,MAAM,QAAA,GAAW,EAAA,CAAG,EAAA,CAAG,aAAa,CAAA;AAAM,EAAA,IAAI,QAAA,IAAY,IAAA,EAAM,IAAA,CAAK,aAAA,GAAiB,QAAA;AACtF,EAAA,OAAO,IAAA;AACT;AAUA,eAAsB,iBAAA,CACpB,MAAA,EACA,MAAA,GAA6D,IAAA,EACb;AAChD,EAAA,MAAM,MAAM,CAAA,kDAAA,EAAqD,kBAAA,CAAmB,MAAM,CAAC,UAAU,MAAM,CAAA,YAAA,CAAA;AAC3G,EAAA,MAAM,OAAO,MAAM,KAAA,CAAM,KAAK,EAAE,OAAA,EAAS,SAAS,CAAA;AAClD,EAAA,IAAI,CAAC,KAAK,EAAA,EAAI,MAAM,IAAI,KAAA,CAAM,CAAA,iCAAA,EAAoC,MAAM,CAAA,CAAE,CAAA;AAE1E,EAAA,MAAM,IAAA,GAAQ,MAAM,IAAA,CAAK,IAAA,EAAK;AAC9B,EAAA,MAAM,KAAA,GAAQ,IAAA,EAAM,KAAA,EAAO,MAAA,GAAS,CAAC,CAAA;AACrC,EAAA,IAAI,CAAC,KAAA,EAAO,MAAM,IAAI,KAAA,CAAM,CAAA,kBAAA,EAAqB,MAAM,CAAA,CAAE,CAAA;AAEzD,EAAA,MAAM,UAAA,GAAuB,KAAA,CAAM,SAAA,IAAa,EAAC;AACjD,EAAA,MAAM,SAAmB,KAAA,CAAM,UAAA,EAAY,QAAQ,CAAC,CAAA,EAAG,SAAS,EAAC;AAEjE,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,MAAM,SAAmB,EAAC;AAE1B,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,UAAA,CAAW,QAAQ,CAAA,EAAA,EAAK;AAC1C,IAAA,IAAI,MAAA,CAAO,CAAC,CAAA,IAAK,IAAA,EAAM;AACrB,MAAA,KAAA,CAAM,IAAA,CAAK,IAAI,IAAA,CAAA,CAAM,UAAA,CAAW,CAAC,CAAA,IAAK,CAAA,IAAK,GAAI,CAAA,CAAE,aAAY,CAAE,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAE,CAAA;AAC7E,MAAA,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,CAAC,CAAW,CAAA;AAAA,IACjC;AAAA,EACF;AAEA,EAAA,OAAO,EAAE,OAAO,MAAA,EAAO;AACzB;AAEA,SAAS,GAAG,CAAA,EAA2B;AACrC,EAAA,IAAI,CAAA,IAAK,MAAM,OAAO,IAAA;AACtB,EAAA,MAAM,MAAM,OAAO,CAAA,KAAM,QAAA,GAAY,CAAA,CAAU,OAAO,CAAA,GAAI,CAAA;AAC1D,EAAA,MAAM,CAAA,GAAI,OAAO,GAAG,CAAA;AACpB,EAAA,OAAO,KAAA,CAAM,CAAC,CAAA,GAAI,IAAA,GAAO,CAAA;AAC3B","file":"index.cjs","sourcesContent":["/**\n * Yahoo Finance fetcher — free, no API key required.\n * Uses Yahoo Finance's public JSON endpoints.\n *\n * For production use, consider using the `yahoo-finance2` npm package instead:\n *   npm install yahoo-finance2\n *\n * Rate limit: ~2,000 requests/hour (unofficial). Add delays for bulk requests.\n */\n\nimport type {\n  IncomeStatement,\n  BalanceSheet,\n  CashFlowStatement,\n  MarketData,\n} from '../../types/index.js'\n\nconst BASE = 'https://query1.finance.yahoo.com/v10/finance/quoteSummary'\nconst HEADERS = {\n  'User-Agent': 'Mozilla/5.0 (compatible; fin-ratios/0.1)',\n  'Accept': 'application/json',\n}\n\nexport interface YahooFetchOptions {\n  /** Additional modules to include (default covers all financial statements) */\n  modules?: string[]\n}\n\nexport interface YahooData {\n  marketData: MarketData\n  income: IncomeStatement\n  balance: BalanceSheet\n  cashFlow: CashFlowStatement\n  sector?: string\n  industry?: string\n  employeeCount?: number\n  beta?: number\n  dividendYield?: number\n}\n\n/**\n * Fetch comprehensive financial data for a stock ticker from Yahoo Finance.\n *\n * @example\n * const data = await fetchYahoo('AAPL')\n * const ratio = pe({ marketCap: data.marketData.marketCap, netIncome: data.income.netIncome })\n */\nexport async function fetchYahoo(\n  ticker: string,\n  options: YahooFetchOptions = {}\n): Promise<YahooData> {\n  const modules = [\n    'financialData',\n    'defaultKeyStatistics',\n    'summaryDetail',\n    'assetProfile',\n    'incomeStatementHistory',\n    'balanceSheetHistory',\n    'cashflowStatementHistory',\n    ...(options.modules ?? []),\n  ].join(',')\n\n  const url = `${BASE}/${encodeURIComponent(ticker)}?modules=${modules}`\n\n  const resp = await fetch(url, { headers: HEADERS })\n  if (!resp.ok) {\n    throw new Error(`Yahoo Finance request failed: ${resp.status} for ${ticker}`)\n  }\n\n  const json = (await resp.json()) as Record<string, unknown>\n  const result = (json?.quoteSummary as any)?.result?.[0]\n  if (!result) {\n    throw new Error(`No data returned for ${ticker}`)\n  }\n\n  const fd = result.financialData ?? {}\n  const ks = result.defaultKeyStatistics ?? {}\n  const sd = result.summaryDetail ?? {}\n  const ap = result.assetProfile ?? {}\n\n  // Income statement (TTM)\n  const inc = result.incomeStatementHistory?.incomeStatementHistory?.[0] ?? {}\n  // Balance sheet (most recent quarter/year)\n  const bal = result.balanceSheetHistory?.balanceSheetHistory?.[0] ?? {}\n  // Cash flow (most recent)\n  const cf = result.cashflowStatementHistory?.cashflowStatementHistory?.[0] ?? {}\n\n  const price = _n(fd.currentPrice) ?? _n(fd.regularMarketPrice) ?? 0\n  const marketCap = _n(ks.marketCap) ?? 0\n  const shares = _n(ks.sharesOutstanding) ?? 0\n\n  const base: YahooData = {\n    marketData: {\n      price,\n      marketCap,\n      sharesOutstanding: shares,\n      enterpriseValue: _n(ks.enterpriseValue),\n      forwardEps: _n(ks.forwardEps),\n      trailingEps: _n(ks.trailingEps),\n      dividendPerShare: _n(sd.dividendRate),\n      ticker,\n    },\n    income: {\n      revenue: _n(inc.totalRevenue) ?? _n(fd.totalRevenue) ?? 0,\n      grossProfit: _n(inc.grossProfit) ?? 0,\n      cogs: (_n(inc.totalRevenue) ?? 0) - (_n(inc.grossProfit) ?? 0),\n      ebit: _n(inc.ebit) ?? _n(fd.operatingCashflow) ?? 0,\n      ebitda: _n(fd.ebitda) ?? 0,\n      netIncome: _n(inc.netIncome) ?? _n(fd.netIncomeToCommon) ?? 0,\n      interestExpense: Math.abs(_n(inc.interestExpense) ?? 0),\n      incomeTaxExpense: _n(inc.incomeTaxExpense) ?? 0,\n      ebt: _n(inc.pretaxIncome) ?? 0,\n      depreciationAndAmortization: 0, // Not available in this module\n      sharesOutstanding: shares,\n      eps: _n(ks.trailingEps),\n    },\n    balance: {\n      totalAssets: _n(bal.totalAssets) ?? 0,\n      currentAssets: _n(bal.totalCurrentAssets) ?? 0,\n      cash: _n(bal.cash) ?? _n(fd.totalCash) ?? 0,\n      shortTermInvestments: _n(bal.shortTermInvestments),\n      accountsReceivable: _n(bal.netReceivables) ?? 0,\n      inventory: _n(bal.inventory) ?? 0,\n      netPPE: _n(bal.propertyPlantEquipment) ?? 0,\n      goodwill: _n(bal.goodWill),\n      intangibleAssets: _n(bal.intangibleAssets),\n      retainedEarnings: _n(bal.retainedEarnings) ?? 0,\n      totalLiabilities: _n(bal.totalLiab) ?? 0,\n      currentLiabilities: _n(bal.totalCurrentLiabilities) ?? 0,\n      accountsPayable: _n(bal.accountsPayable) ?? 0,\n      shortTermDebt: _n(bal.shortLongTermDebt),\n      longTermDebt: _n(bal.longTermDebt) ?? _n(fd.totalDebt) ?? 0,\n      totalDebt: _n(fd.totalDebt) ?? 0,\n      totalEquity: _n(bal.totalStockholderEquity) ?? 0,\n      sharesOutstanding: shares,\n    },\n    cashFlow: {\n      operatingCashFlow: _n(cf.totalCashFromOperatingActivities) ?? _n(fd.operatingCashflow) ?? 0,\n      capex: Math.abs(_n(cf.capitalExpenditures) ?? 0),\n      investingCashFlow: _n(cf.totalCashflowsFromInvestingActivities),\n      financingCashFlow: _n(cf.totalCashFromFinancingActivities),\n      dividendsPaid: _n(cf.dividendsPaid),\n      stockBasedCompensation: _n(cf.stockBasedCompensation),\n    },\n    sector: ap.sector,\n    industry: ap.industry,\n  }\n  const empCount = _n(ap.fullTimeEmployees); if (empCount != null) base.employeeCount = empCount\n  const betaVal  = _n(ks.beta);             if (betaVal  != null) base.beta          = betaVal\n  const divYield = _n(sd.dividendYield);    if (divYield != null) base.dividendYield  = divYield\n  return base\n}\n\n/**\n * Fetch price history (daily close prices) for risk calculations.\n *\n * @example\n * const prices = await fetchPriceHistory('AAPL', '1y')\n * const returns = pricesToReturns(prices)\n * const sharpe = sharpeRatio({ returns, riskFreeRate: 0.05 })\n */\nexport async function fetchPriceHistory(\n  ticker: string,\n  period: '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | 'max' = '1y'\n): Promise<{ dates: string[]; prices: number[] }> {\n  const url = `https://query1.finance.yahoo.com/v8/finance/chart/${encodeURIComponent(ticker)}?range=${period}&interval=1d`\n  const resp = await fetch(url, { headers: HEADERS })\n  if (!resp.ok) throw new Error(`Price history request failed for ${ticker}`)\n\n  const json = (await resp.json()) as any\n  const chart = json?.chart?.result?.[0]\n  if (!chart) throw new Error(`No price data for ${ticker}`)\n\n  const timestamps: number[] = chart.timestamp ?? []\n  const closes: number[] = chart.indicators?.quote?.[0]?.close ?? []\n\n  const dates: string[] = []\n  const prices: number[] = []\n\n  for (let i = 0; i < timestamps.length; i++) {\n    if (closes[i] != null) {\n      dates.push(new Date((timestamps[i] ?? 0) * 1000).toISOString().split('T')[0]!)\n      prices.push(closes[i] as number)\n    }\n  }\n\n  return { dates, prices }\n}\n\nfunction _n(v: unknown): number | null {\n  if (v == null) return null\n  const raw = typeof v === 'object' ? (v as any).raw ?? v : v\n  const n = Number(raw)\n  return isNaN(n) ? null : n\n}\n"]}

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

@@ -0,0 +1,50 @@
+import { I as IncomeStatement, B as BalanceSheet, C as CashFlowStatement } from '../../financials-DUHxWDPS.cjs';
+import { M as MarketData } from '../../market-DlMw3vK1.cjs';
+
+/**
+ * Yahoo Finance fetcher — free, no API key required.
+ * Uses Yahoo Finance's public JSON endpoints.
+ *
+ * For production use, consider using the `yahoo-finance2` npm package instead:
+ *   npm install yahoo-finance2
+ *
+ * Rate limit: ~2,000 requests/hour (unofficial). Add delays for bulk requests.
+ */
+
+interface YahooFetchOptions {
+    /** Additional modules to include (default covers all financial statements) */
+    modules?: string[];
+}
+interface YahooData {
+    marketData: MarketData;
+    income: IncomeStatement;
+    balance: BalanceSheet;
+    cashFlow: CashFlowStatement;
+    sector?: string;
+    industry?: string;
+    employeeCount?: number;
+    beta?: number;
+    dividendYield?: number;
+}
+/**
+ * Fetch comprehensive financial data for a stock ticker from Yahoo Finance.
+ *
+ * @example
+ * const data = await fetchYahoo('AAPL')
+ * const ratio = pe({ marketCap: data.marketData.marketCap, netIncome: data.income.netIncome })
+ */
+declare function fetchYahoo(ticker: string, options?: YahooFetchOptions): Promise<YahooData>;
+/**
+ * Fetch price history (daily close prices) for risk calculations.
+ *
+ * @example
+ * const prices = await fetchPriceHistory('AAPL', '1y')
+ * const returns = pricesToReturns(prices)
+ * const sharpe = sharpeRatio({ returns, riskFreeRate: 0.05 })
+ */
+declare function fetchPriceHistory(ticker: string, period?: '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | 'max'): Promise<{
+    dates: string[];
+    prices: number[];
+}>;
+
+export { type YahooData, type YahooFetchOptions, fetchPriceHistory, fetchYahoo };

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

@@ -0,0 +1,50 @@
+import { I as IncomeStatement, B as BalanceSheet, C as CashFlowStatement } from '../../financials-DUHxWDPS.js';
+import { M as MarketData } from '../../market-DlMw3vK1.js';
+
+/**
+ * Yahoo Finance fetcher — free, no API key required.
+ * Uses Yahoo Finance's public JSON endpoints.
+ *
+ * For production use, consider using the `yahoo-finance2` npm package instead:
+ *   npm install yahoo-finance2
+ *
+ * Rate limit: ~2,000 requests/hour (unofficial). Add delays for bulk requests.
+ */
+
+interface YahooFetchOptions {
+    /** Additional modules to include (default covers all financial statements) */
+    modules?: string[];
+}
+interface YahooData {
+    marketData: MarketData;
+    income: IncomeStatement;
+    balance: BalanceSheet;
+    cashFlow: CashFlowStatement;
+    sector?: string;
+    industry?: string;
+    employeeCount?: number;
+    beta?: number;
+    dividendYield?: number;
+}
+/**
+ * Fetch comprehensive financial data for a stock ticker from Yahoo Finance.
+ *
+ * @example
+ * const data = await fetchYahoo('AAPL')
+ * const ratio = pe({ marketCap: data.marketData.marketCap, netIncome: data.income.netIncome })
+ */
+declare function fetchYahoo(ticker: string, options?: YahooFetchOptions): Promise<YahooData>;
+/**
+ * Fetch price history (daily close prices) for risk calculations.
+ *
+ * @example
+ * const prices = await fetchPriceHistory('AAPL', '1y')
+ * const returns = pricesToReturns(prices)
+ * const sharpe = sharpeRatio({ returns, riskFreeRate: 0.05 })
+ */
+declare function fetchPriceHistory(ticker: string, period?: '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | 'max'): Promise<{
+    dates: string[];
+    prices: number[];
+}>;
+
+export { type YahooData, type YahooFetchOptions, fetchPriceHistory, fetchYahoo };

package/dist/fetchers/yahoo/index.js

@@ -0,0 +1,131 @@
+// src/fetchers/yahoo/index.ts
+var BASE = "https://query1.finance.yahoo.com/v10/finance/quoteSummary";
+var HEADERS = {
+  "User-Agent": "Mozilla/5.0 (compatible; fin-ratios/0.1)",
+  "Accept": "application/json"
+};
+async function fetchYahoo(ticker, options = {}) {
+  const modules = [
+    "financialData",
+    "defaultKeyStatistics",
+    "summaryDetail",
+    "assetProfile",
+    "incomeStatementHistory",
+    "balanceSheetHistory",
+    "cashflowStatementHistory",
+    ...options.modules ?? []
+  ].join(",");
+  const url = `${BASE}/${encodeURIComponent(ticker)}?modules=${modules}`;
+  const resp = await fetch(url, { headers: HEADERS });
+  if (!resp.ok) {
+    throw new Error(`Yahoo Finance request failed: ${resp.status} for ${ticker}`);
+  }
+  const json = await resp.json();
+  const result = json?.quoteSummary?.result?.[0];
+  if (!result) {
+    throw new Error(`No data returned for ${ticker}`);
+  }
+  const fd = result.financialData ?? {};
+  const ks = result.defaultKeyStatistics ?? {};
+  const sd = result.summaryDetail ?? {};
+  const ap = result.assetProfile ?? {};
+  const inc = result.incomeStatementHistory?.incomeStatementHistory?.[0] ?? {};
+  const bal = result.balanceSheetHistory?.balanceSheetHistory?.[0] ?? {};
+  const cf = result.cashflowStatementHistory?.cashflowStatementHistory?.[0] ?? {};
+  const price = _n(fd.currentPrice) ?? _n(fd.regularMarketPrice) ?? 0;
+  const marketCap = _n(ks.marketCap) ?? 0;
+  const shares = _n(ks.sharesOutstanding) ?? 0;
+  const base = {
+    marketData: {
+      price,
+      marketCap,
+      sharesOutstanding: shares,
+      enterpriseValue: _n(ks.enterpriseValue),
+      forwardEps: _n(ks.forwardEps),
+      trailingEps: _n(ks.trailingEps),
+      dividendPerShare: _n(sd.dividendRate),
+      ticker
+    },
+    income: {
+      revenue: _n(inc.totalRevenue) ?? _n(fd.totalRevenue) ?? 0,
+      grossProfit: _n(inc.grossProfit) ?? 0,
+      cogs: (_n(inc.totalRevenue) ?? 0) - (_n(inc.grossProfit) ?? 0),
+      ebit: _n(inc.ebit) ?? _n(fd.operatingCashflow) ?? 0,
+      ebitda: _n(fd.ebitda) ?? 0,
+      netIncome: _n(inc.netIncome) ?? _n(fd.netIncomeToCommon) ?? 0,
+      interestExpense: Math.abs(_n(inc.interestExpense) ?? 0),
+      incomeTaxExpense: _n(inc.incomeTaxExpense) ?? 0,
+      ebt: _n(inc.pretaxIncome) ?? 0,
+      depreciationAndAmortization: 0,
+      // Not available in this module
+      sharesOutstanding: shares,
+      eps: _n(ks.trailingEps)
+    },
+    balance: {
+      totalAssets: _n(bal.totalAssets) ?? 0,
+      currentAssets: _n(bal.totalCurrentAssets) ?? 0,
+      cash: _n(bal.cash) ?? _n(fd.totalCash) ?? 0,
+      shortTermInvestments: _n(bal.shortTermInvestments),
+      accountsReceivable: _n(bal.netReceivables) ?? 0,
+      inventory: _n(bal.inventory) ?? 0,
+      netPPE: _n(bal.propertyPlantEquipment) ?? 0,
+      goodwill: _n(bal.goodWill),
+      intangibleAssets: _n(bal.intangibleAssets),
+      retainedEarnings: _n(bal.retainedEarnings) ?? 0,
+      totalLiabilities: _n(bal.totalLiab) ?? 0,
+      currentLiabilities: _n(bal.totalCurrentLiabilities) ?? 0,
+      accountsPayable: _n(bal.accountsPayable) ?? 0,
+      shortTermDebt: _n(bal.shortLongTermDebt),
+      longTermDebt: _n(bal.longTermDebt) ?? _n(fd.totalDebt) ?? 0,
+      totalDebt: _n(fd.totalDebt) ?? 0,
+      totalEquity: _n(bal.totalStockholderEquity) ?? 0,
+      sharesOutstanding: shares
+    },
+    cashFlow: {
+      operatingCashFlow: _n(cf.totalCashFromOperatingActivities) ?? _n(fd.operatingCashflow) ?? 0,
+      capex: Math.abs(_n(cf.capitalExpenditures) ?? 0),
+      investingCashFlow: _n(cf.totalCashflowsFromInvestingActivities),
+      financingCashFlow: _n(cf.totalCashFromFinancingActivities),
+      dividendsPaid: _n(cf.dividendsPaid),
+      stockBasedCompensation: _n(cf.stockBasedCompensation)
+    },
+    sector: ap.sector,
+    industry: ap.industry
+  };
+  const empCount = _n(ap.fullTimeEmployees);
+  if (empCount != null) base.employeeCount = empCount;
+  const betaVal = _n(ks.beta);
+  if (betaVal != null) base.beta = betaVal;
+  const divYield = _n(sd.dividendYield);
+  if (divYield != null) base.dividendYield = divYield;
+  return base;
+}
+async function fetchPriceHistory(ticker, period = "1y") {
+  const url = `https://query1.finance.yahoo.com/v8/finance/chart/${encodeURIComponent(ticker)}?range=${period}&interval=1d`;
+  const resp = await fetch(url, { headers: HEADERS });
+  if (!resp.ok) throw new Error(`Price history request failed for ${ticker}`);
+  const json = await resp.json();
+  const chart = json?.chart?.result?.[0];
+  if (!chart) throw new Error(`No price data for ${ticker}`);
+  const timestamps = chart.timestamp ?? [];
+  const closes = chart.indicators?.quote?.[0]?.close ?? [];
+  const dates = [];
+  const prices = [];
+  for (let i = 0; i < timestamps.length; i++) {
+    if (closes[i] != null) {
+      dates.push(new Date((timestamps[i] ?? 0) * 1e3).toISOString().split("T")[0]);
+      prices.push(closes[i]);
+    }
+  }
+  return { dates, prices };
+}
+function _n(v) {
+  if (v == null) return null;
+  const raw = typeof v === "object" ? v.raw ?? v : v;
+  const n = Number(raw);
+  return isNaN(n) ? null : n;
+}
+
+export { fetchPriceHistory, fetchYahoo };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/fetchers/yahoo/index.ts"],"names":[],"mappings":";AAiBA,IAAM,IAAA,GAAO,2DAAA;AACb,IAAM,OAAA,GAAU;AAAA,EACd,YAAA,EAAc,0CAAA;AAAA,EACd,QAAA,EAAU;AACZ,CAAA;AA0BA,eAAsB,UAAA,CACpB,MAAA,EACA,OAAA,GAA6B,EAAC,EACV;AACpB,EAAA,MAAM,OAAA,GAAU;AAAA,IACd,eAAA;AAAA,IACA,sBAAA;AAAA,IACA,eAAA;AAAA,IACA,cAAA;AAAA,IACA,wBAAA;AAAA,IACA,qBAAA;AAAA,IACA,0BAAA;AAAA,IACA,GAAI,OAAA,CAAQ,OAAA,IAAW;AAAC,GAC1B,CAAE,KAAK,GAAG,CAAA;AAEV,EAAA,MAAM,GAAA,GAAM,GAAG,IAAI,CAAA,CAAA,EAAI,mBAAmB,MAAM,CAAC,YAAY,OAAO,CAAA,CAAA;AAEpE,EAAA,MAAM,OAAO,MAAM,KAAA,CAAM,KAAK,EAAE,OAAA,EAAS,SAAS,CAAA;AAClD,EAAA,IAAI,CAAC,KAAK,EAAA,EAAI;AACZ,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,8BAAA,EAAiC,KAAK,MAAM,CAAA,KAAA,EAAQ,MAAM,CAAA,CAAE,CAAA;AAAA,EAC9E;AAEA,EAAA,MAAM,IAAA,GAAQ,MAAM,IAAA,CAAK,IAAA,EAAK;AAC9B,EAAA,MAAM,MAAA,GAAU,IAAA,EAAM,YAAA,EAAsB,MAAA,GAAS,CAAC,CAAA;AACtD,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,qBAAA,EAAwB,MAAM,CAAA,CAAE,CAAA;AAAA,EAClD;AAEA,EAAA,MAAM,EAAA,GAAK,MAAA,CAAO,aAAA,IAAiB,EAAC;AACpC,EAAA,MAAM,EAAA,GAAK,MAAA,CAAO,oBAAA,IAAwB,EAAC;AAC3C,EAAA,MAAM,EAAA,GAAK,MAAA,CAAO,aAAA,IAAiB,EAAC;AACpC,EAAA,MAAM,EAAA,GAAK,MAAA,CAAO,YAAA,IAAgB,EAAC;AAGnC,EAAA,MAAM,MAAM,MAAA,CAAO,sBAAA,EAAwB,sBAAA,GAAyB,CAAC,KAAK,EAAC;AAE3E,EAAA,MAAM,MAAM,MAAA,CAAO,mBAAA,EAAqB,mBAAA,GAAsB,CAAC,KAAK,EAAC;AAErE,EAAA,MAAM,KAAK,MAAA,CAAO,wBAAA,EAA0B,wBAAA,GAA2B,CAAC,KAAK,EAAC;AAE9E,EAAA,MAAM,KAAA,GAAQ,GAAG,EAAA,CAAG,YAAY,KAAK,EAAA,CAAG,EAAA,CAAG,kBAAkB,CAAA,IAAK,CAAA;AAClE,EAAA,MAAM,SAAA,GAAY,EAAA,CAAG,EAAA,CAAG,SAAS,CAAA,IAAK,CAAA;AACtC,EAAA,MAAM,MAAA,GAAS,EAAA,CAAG,EAAA,CAAG,iBAAiB,CAAA,IAAK,CAAA;AAE3C,EAAA,MAAM,IAAA,GAAkB;AAAA,IACtB,UAAA,EAAY;AAAA,MACV,KAAA;AAAA,MACA,SAAA;AAAA,MACA,iBAAA,EAAmB,MAAA;AAAA,MACnB,eAAA,EAAiB,EAAA,CAAG,EAAA,CAAG,eAAe,CAAA;AAAA,MACtC,UAAA,EAAY,EAAA,CAAG,EAAA,CAAG,UAAU,CAAA;AAAA,MAC5B,WAAA,EAAa,EAAA,CAAG,EAAA,CAAG,WAAW,CAAA;AAAA,MAC9B,gBAAA,EAAkB,EAAA,CAAG,EAAA,CAAG,YAAY,CAAA;AAAA,MACpC;AAAA,KACF;AAAA,IACA,MAAA,EAAQ;AAAA,MACN,OAAA,EAAS,GAAG,GAAA,CAAI,YAAY,KAAK,EAAA,CAAG,EAAA,CAAG,YAAY,CAAA,IAAK,CAAA;AAAA,MACxD,WAAA,EAAa,EAAA,CAAG,GAAA,CAAI,WAAW,CAAA,IAAK,CAAA;AAAA,MACpC,IAAA,EAAA,CAAO,GAAG,GAAA,CAAI,YAAY,KAAK,CAAA,KAAM,EAAA,CAAG,GAAA,CAAI,WAAW,CAAA,IAAK,CAAA,CAAA;AAAA,MAC5D,IAAA,EAAM,GAAG,GAAA,CAAI,IAAI,KAAK,EAAA,CAAG,EAAA,CAAG,iBAAiB,CAAA,IAAK,CAAA;AAAA,MAClD,MAAA,EAAQ,EAAA,CAAG,EAAA,CAAG,MAAM,CAAA,IAAK,CAAA;AAAA,MACzB,SAAA,EAAW,GAAG,GAAA,CAAI,SAAS,KAAK,EAAA,CAAG,EAAA,CAAG,iBAAiB,CAAA,IAAK,CAAA;AAAA,MAC5D,iBAAiB,IAAA,CAAK,GAAA,CAAI,GAAG,GAAA,CAAI,eAAe,KAAK,CAAC,CAAA;AAAA,MACtD,gBAAA,EAAkB,EAAA,CAAG,GAAA,CAAI,gBAAgB,CAAA,IAAK,CAAA;AAAA,MAC9C,GAAA,EAAK,EAAA,CAAG,GAAA,CAAI,YAAY,CAAA,IAAK,CAAA;AAAA,MAC7B,2BAAA,EAA6B,CAAA;AAAA;AAAA,MAC7B,iBAAA,EAAmB,MAAA;AAAA,MACnB,GAAA,EAAK,EAAA,CAAG,EAAA,CAAG,WAAW;AAAA,KACxB;AAAA,IACA,OAAA,EAAS;AAAA,MACP,WAAA,EAAa,EAAA,CAAG,GAAA,CAAI,WAAW,CAAA,IAAK,CAAA;AAAA,MACpC,aAAA,EAAe,EAAA,CAAG,GAAA,CAAI,kBAAkB,CAAA,IAAK,CAAA;AAAA,MAC7C,IAAA,EAAM,GAAG,GAAA,CAAI,IAAI,KAAK,EAAA,CAAG,EAAA,CAAG,SAAS,CAAA,IAAK,CAAA;AAAA,MAC1C,oBAAA,EAAsB,EAAA,CAAG,GAAA,CAAI,oBAAoB,CAAA;AAAA,MACjD,kBAAA,EAAoB,EAAA,CAAG,GAAA,CAAI,cAAc,CAAA,IAAK,CAAA;AAAA,MAC9C,SAAA,EAAW,EAAA,CAAG,GAAA,CAAI,SAAS,CAAA,IAAK,CAAA;AAAA,MAChC,MAAA,EAAQ,EAAA,CAAG,GAAA,CAAI,sBAAsB,CAAA,IAAK,CAAA;AAAA,MAC1C,QAAA,EAAU,EAAA,CAAG,GAAA,CAAI,QAAQ,CAAA;AAAA,MACzB,gBAAA,EAAkB,EAAA,CAAG,GAAA,CAAI,gBAAgB,CAAA;AAAA,MACzC,gBAAA,EAAkB,EAAA,CAAG,GAAA,CAAI,gBAAgB,CAAA,IAAK,CAAA;AAAA,MAC9C,gBAAA,EAAkB,EAAA,CAAG,GAAA,CAAI,SAAS,CAAA,IAAK,CAAA;AAAA,MACvC,kBAAA,EAAoB,EAAA,CAAG,GAAA,CAAI,uBAAuB,CAAA,IAAK,CAAA;AAAA,MACvD,eAAA,EAAiB,EAAA,CAAG,GAAA,CAAI,eAAe,CAAA,IAAK,CAAA;AAAA,MAC5C,aAAA,EAAe,EAAA,CAAG,GAAA,CAAI,iBAAiB,CAAA;AAAA,MACvC,YAAA,EAAc,GAAG,GAAA,CAAI,YAAY,KAAK,EAAA,CAAG,EAAA,CAAG,SAAS,CAAA,IAAK,CAAA;AAAA,MAC1D,SAAA,EAAW,EAAA,CAAG,EAAA,CAAG,SAAS,CAAA,IAAK,CAAA;AAAA,MAC/B,WAAA,EAAa,EAAA,CAAG,GAAA,CAAI,sBAAsB,CAAA,IAAK,CAAA;AAAA,MAC/C,iBAAA,EAAmB;AAAA,KACrB;AAAA,IACA,QAAA,EAAU;AAAA,MACR,iBAAA,EAAmB,GAAG,EAAA,CAAG,gCAAgC,KAAK,EAAA,CAAG,EAAA,CAAG,iBAAiB,CAAA,IAAK,CAAA;AAAA,MAC1F,OAAO,IAAA,CAAK,GAAA,CAAI,GAAG,EAAA,CAAG,mBAAmB,KAAK,CAAC,CAAA;AAAA,MAC/C,iBAAA,EAAmB,EAAA,CAAG,EAAA,CAAG,qCAAqC,CAAA;AAAA,MAC9D,iBAAA,EAAmB,EAAA,CAAG,EAAA,CAAG,gCAAgC,CAAA;AAAA,MACzD,aAAA,EAAe,EAAA,CAAG,EAAA,CAAG,aAAa,CAAA;AAAA,MAClC,sBAAA,EAAwB,EAAA,CAAG,EAAA,CAAG,sBAAsB;AAAA,KACtD;AAAA,IACA,QAAQ,EAAA,CAAG,MAAA;AAAA,IACX,UAAU,EAAA,CAAG;AAAA,GACf;AACA,EAAA,MAAM,QAAA,GAAW,EAAA,CAAG,EAAA,CAAG,iBAAiB,CAAA;AAAG,EAAA,IAAI,QAAA,IAAY,IAAA,EAAM,IAAA,CAAK,aAAA,GAAgB,QAAA;AACtF,EAAA,MAAM,OAAA,GAAW,EAAA,CAAG,EAAA,CAAG,IAAI,CAAA;AAAe,EAAA,IAAI,OAAA,IAAY,IAAA,EAAM,IAAA,CAAK,IAAA,GAAgB,OAAA;AACrF,EAAA,MAAM,QAAA,GAAW,EAAA,CAAG,EAAA,CAAG,aAAa,CAAA;AAAM,EAAA,IAAI,QAAA,IAAY,IAAA,EAAM,IAAA,CAAK,aAAA,GAAiB,QAAA;AACtF,EAAA,OAAO,IAAA;AACT;AAUA,eAAsB,iBAAA,CACpB,MAAA,EACA,MAAA,GAA6D,IAAA,EACb;AAChD,EAAA,MAAM,MAAM,CAAA,kDAAA,EAAqD,kBAAA,CAAmB,MAAM,CAAC,UAAU,MAAM,CAAA,YAAA,CAAA;AAC3G,EAAA,MAAM,OAAO,MAAM,KAAA,CAAM,KAAK,EAAE,OAAA,EAAS,SAAS,CAAA;AAClD,EAAA,IAAI,CAAC,KAAK,EAAA,EAAI,MAAM,IAAI,KAAA,CAAM,CAAA,iCAAA,EAAoC,MAAM,CAAA,CAAE,CAAA;AAE1E,EAAA,MAAM,IAAA,GAAQ,MAAM,IAAA,CAAK,IAAA,EAAK;AAC9B,EAAA,MAAM,KAAA,GAAQ,IAAA,EAAM,KAAA,EAAO,MAAA,GAAS,CAAC,CAAA;AACrC,EAAA,IAAI,CAAC,KAAA,EAAO,MAAM,IAAI,KAAA,CAAM,CAAA,kBAAA,EAAqB,MAAM,CAAA,CAAE,CAAA;AAEzD,EAAA,MAAM,UAAA,GAAuB,KAAA,CAAM,SAAA,IAAa,EAAC;AACjD,EAAA,MAAM,SAAmB,KAAA,CAAM,UAAA,EAAY,QAAQ,CAAC,CAAA,EAAG,SAAS,EAAC;AAEjE,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,MAAM,SAAmB,EAAC;AAE1B,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,UAAA,CAAW,QAAQ,CAAA,EAAA,EAAK;AAC1C,IAAA,IAAI,MAAA,CAAO,CAAC,CAAA,IAAK,IAAA,EAAM;AACrB,MAAA,KAAA,CAAM,IAAA,CAAK,IAAI,IAAA,CAAA,CAAM,UAAA,CAAW,CAAC,CAAA,IAAK,CAAA,IAAK,GAAI,CAAA,CAAE,aAAY,CAAE,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAE,CAAA;AAC7E,MAAA,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,CAAC,CAAW,CAAA;AAAA,IACjC;AAAA,EACF;AAEA,EAAA,OAAO,EAAE,OAAO,MAAA,EAAO;AACzB;AAEA,SAAS,GAAG,CAAA,EAA2B;AACrC,EAAA,IAAI,CAAA,IAAK,MAAM,OAAO,IAAA;AACtB,EAAA,MAAM,MAAM,OAAO,CAAA,KAAM,QAAA,GAAY,CAAA,CAAU,OAAO,CAAA,GAAI,CAAA;AAC1D,EAAA,MAAM,CAAA,GAAI,OAAO,GAAG,CAAA;AACpB,EAAA,OAAO,KAAA,CAAM,CAAC,CAAA,GAAI,IAAA,GAAO,CAAA;AAC3B","file":"index.js","sourcesContent":["/**\n * Yahoo Finance fetcher — free, no API key required.\n * Uses Yahoo Finance's public JSON endpoints.\n *\n * For production use, consider using the `yahoo-finance2` npm package instead:\n *   npm install yahoo-finance2\n *\n * Rate limit: ~2,000 requests/hour (unofficial). Add delays for bulk requests.\n */\n\nimport type {\n  IncomeStatement,\n  BalanceSheet,\n  CashFlowStatement,\n  MarketData,\n} from '../../types/index.js'\n\nconst BASE = 'https://query1.finance.yahoo.com/v10/finance/quoteSummary'\nconst HEADERS = {\n  'User-Agent': 'Mozilla/5.0 (compatible; fin-ratios/0.1)',\n  'Accept': 'application/json',\n}\n\nexport interface YahooFetchOptions {\n  /** Additional modules to include (default covers all financial statements) */\n  modules?: string[]\n}\n\nexport interface YahooData {\n  marketData: MarketData\n  income: IncomeStatement\n  balance: BalanceSheet\n  cashFlow: CashFlowStatement\n  sector?: string\n  industry?: string\n  employeeCount?: number\n  beta?: number\n  dividendYield?: number\n}\n\n/**\n * Fetch comprehensive financial data for a stock ticker from Yahoo Finance.\n *\n * @example\n * const data = await fetchYahoo('AAPL')\n * const ratio = pe({ marketCap: data.marketData.marketCap, netIncome: data.income.netIncome })\n */\nexport async function fetchYahoo(\n  ticker: string,\n  options: YahooFetchOptions = {}\n): Promise<YahooData> {\n  const modules = [\n    'financialData',\n    'defaultKeyStatistics',\n    'summaryDetail',\n    'assetProfile',\n    'incomeStatementHistory',\n    'balanceSheetHistory',\n    'cashflowStatementHistory',\n    ...(options.modules ?? []),\n  ].join(',')\n\n  const url = `${BASE}/${encodeURIComponent(ticker)}?modules=${modules}`\n\n  const resp = await fetch(url, { headers: HEADERS })\n  if (!resp.ok) {\n    throw new Error(`Yahoo Finance request failed: ${resp.status} for ${ticker}`)\n  }\n\n  const json = (await resp.json()) as Record<string, unknown>\n  const result = (json?.quoteSummary as any)?.result?.[0]\n  if (!result) {\n    throw new Error(`No data returned for ${ticker}`)\n  }\n\n  const fd = result.financialData ?? {}\n  const ks = result.defaultKeyStatistics ?? {}\n  const sd = result.summaryDetail ?? {}\n  const ap = result.assetProfile ?? {}\n\n  // Income statement (TTM)\n  const inc = result.incomeStatementHistory?.incomeStatementHistory?.[0] ?? {}\n  // Balance sheet (most recent quarter/year)\n  const bal = result.balanceSheetHistory?.balanceSheetHistory?.[0] ?? {}\n  // Cash flow (most recent)\n  const cf = result.cashflowStatementHistory?.cashflowStatementHistory?.[0] ?? {}\n\n  const price = _n(fd.currentPrice) ?? _n(fd.regularMarketPrice) ?? 0\n  const marketCap = _n(ks.marketCap) ?? 0\n  const shares = _n(ks.sharesOutstanding) ?? 0\n\n  const base: YahooData = {\n    marketData: {\n      price,\n      marketCap,\n      sharesOutstanding: shares,\n      enterpriseValue: _n(ks.enterpriseValue),\n      forwardEps: _n(ks.forwardEps),\n      trailingEps: _n(ks.trailingEps),\n      dividendPerShare: _n(sd.dividendRate),\n      ticker,\n    },\n    income: {\n      revenue: _n(inc.totalRevenue) ?? _n(fd.totalRevenue) ?? 0,\n      grossProfit: _n(inc.grossProfit) ?? 0,\n      cogs: (_n(inc.totalRevenue) ?? 0) - (_n(inc.grossProfit) ?? 0),\n      ebit: _n(inc.ebit) ?? _n(fd.operatingCashflow) ?? 0,\n      ebitda: _n(fd.ebitda) ?? 0,\n      netIncome: _n(inc.netIncome) ?? _n(fd.netIncomeToCommon) ?? 0,\n      interestExpense: Math.abs(_n(inc.interestExpense) ?? 0),\n      incomeTaxExpense: _n(inc.incomeTaxExpense) ?? 0,\n      ebt: _n(inc.pretaxIncome) ?? 0,\n      depreciationAndAmortization: 0, // Not available in this module\n      sharesOutstanding: shares,\n      eps: _n(ks.trailingEps),\n    },\n    balance: {\n      totalAssets: _n(bal.totalAssets) ?? 0,\n      currentAssets: _n(bal.totalCurrentAssets) ?? 0,\n      cash: _n(bal.cash) ?? _n(fd.totalCash) ?? 0,\n      shortTermInvestments: _n(bal.shortTermInvestments),\n      accountsReceivable: _n(bal.netReceivables) ?? 0,\n      inventory: _n(bal.inventory) ?? 0,\n      netPPE: _n(bal.propertyPlantEquipment) ?? 0,\n      goodwill: _n(bal.goodWill),\n      intangibleAssets: _n(bal.intangibleAssets),\n      retainedEarnings: _n(bal.retainedEarnings) ?? 0,\n      totalLiabilities: _n(bal.totalLiab) ?? 0,\n      currentLiabilities: _n(bal.totalCurrentLiabilities) ?? 0,\n      accountsPayable: _n(bal.accountsPayable) ?? 0,\n      shortTermDebt: _n(bal.shortLongTermDebt),\n      longTermDebt: _n(bal.longTermDebt) ?? _n(fd.totalDebt) ?? 0,\n      totalDebt: _n(fd.totalDebt) ?? 0,\n      totalEquity: _n(bal.totalStockholderEquity) ?? 0,\n      sharesOutstanding: shares,\n    },\n    cashFlow: {\n      operatingCashFlow: _n(cf.totalCashFromOperatingActivities) ?? _n(fd.operatingCashflow) ?? 0,\n      capex: Math.abs(_n(cf.capitalExpenditures) ?? 0),\n      investingCashFlow: _n(cf.totalCashflowsFromInvestingActivities),\n      financingCashFlow: _n(cf.totalCashFromFinancingActivities),\n      dividendsPaid: _n(cf.dividendsPaid),\n      stockBasedCompensation: _n(cf.stockBasedCompensation),\n    },\n    sector: ap.sector,\n    industry: ap.industry,\n  }\n  const empCount = _n(ap.fullTimeEmployees); if (empCount != null) base.employeeCount = empCount\n  const betaVal  = _n(ks.beta);             if (betaVal  != null) base.beta          = betaVal\n  const divYield = _n(sd.dividendYield);    if (divYield != null) base.dividendYield  = divYield\n  return base\n}\n\n/**\n * Fetch price history (daily close prices) for risk calculations.\n *\n * @example\n * const prices = await fetchPriceHistory('AAPL', '1y')\n * const returns = pricesToReturns(prices)\n * const sharpe = sharpeRatio({ returns, riskFreeRate: 0.05 })\n */\nexport async function fetchPriceHistory(\n  ticker: string,\n  period: '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | 'max' = '1y'\n): Promise<{ dates: string[]; prices: number[] }> {\n  const url = `https://query1.finance.yahoo.com/v8/finance/chart/${encodeURIComponent(ticker)}?range=${period}&interval=1d`\n  const resp = await fetch(url, { headers: HEADERS })\n  if (!resp.ok) throw new Error(`Price history request failed for ${ticker}`)\n\n  const json = (await resp.json()) as any\n  const chart = json?.chart?.result?.[0]\n  if (!chart) throw new Error(`No price data for ${ticker}`)\n\n  const timestamps: number[] = chart.timestamp ?? []\n  const closes: number[] = chart.indicators?.quote?.[0]?.close ?? []\n\n  const dates: string[] = []\n  const prices: number[] = []\n\n  for (let i = 0; i < timestamps.length; i++) {\n    if (closes[i] != null) {\n      dates.push(new Date((timestamps[i] ?? 0) * 1000).toISOString().split('T')[0]!)\n      prices.push(closes[i] as number)\n    }\n  }\n\n  return { dates, prices }\n}\n\nfunction _n(v: unknown): number | null {\n  if (v == null) return null\n  const raw = typeof v === 'object' ? (v as any).raw ?? v : v\n  const n = Number(raw)\n  return isNaN(n) ? null : n\n}\n"]}

package/dist/financials-DUHxWDPS.d.cts

@@ -0,0 +1,113 @@
+/**
+ * Core financial statement types.
+ * All monetary values should be in the same currency unit (e.g., USD thousands).
+ * Use null for unavailable/inapplicable fields.
+ */
+interface IncomeStatement {
+    /** Total revenue / net sales */
+    revenue: number;
+    /** Revenue minus cost of goods sold */
+    grossProfit: number;
+    /** Cost of goods sold */
+    cogs: number;
+    /** Earnings before interest and taxes */
+    ebit: number;
+    /** EBIT + Depreciation + Amortization */
+    ebitda: number;
+    /** Net income after all expenses and taxes */
+    netIncome: number;
+    /** Interest expense (positive = expense) */
+    interestExpense: number;
+    /** Income tax expense */
+    incomeTaxExpense: number;
+    /** Earnings before taxes */
+    ebt: number;
+    /** Depreciation and amortization */
+    depreciationAndAmortization: number;
+    /** Research and development expense */
+    researchAndDevelopment?: number | null;
+    /** Selling, general and administrative expense */
+    sgaExpense?: number | null;
+    /** Basic shares outstanding */
+    sharesOutstanding: number;
+    /** Diluted shares outstanding */
+    sharesOutstandingDiluted?: number | null;
+    /** Earnings per share (basic) */
+    eps?: number | null;
+    /** Earnings per share (diluted) */
+    epsDiluted?: number | null;
+    /** Fiscal period label, e.g. "2024-Q1" or "FY2023" */
+    period?: string;
+}
+interface BalanceSheet {
+    /** Total assets */
+    totalAssets: number;
+    /** Current assets */
+    currentAssets: number;
+    /** Cash and cash equivalents */
+    cash: number;
+    /** Short-term investments */
+    shortTermInvestments?: number | null;
+    /** Accounts receivable */
+    accountsReceivable: number;
+    /** Inventory */
+    inventory: number;
+    /** Net PP&E (property, plant, equipment) */
+    netPPE: number;
+    /** Goodwill */
+    goodwill?: number | null;
+    /** Intangible assets (excluding goodwill) */
+    intangibleAssets?: number | null;
+    /** Retained earnings */
+    retainedEarnings: number;
+    /** Total liabilities */
+    totalLiabilities: number;
+    /** Current liabilities */
+    currentLiabilities: number;
+    /** Accounts payable */
+    accountsPayable: number;
+    /** Short-term debt */
+    shortTermDebt?: number | null;
+    /** Long-term debt */
+    longTermDebt: number;
+    /** Total debt (short-term + long-term) */
+    totalDebt: number;
+    /** Total shareholders' equity */
+    totalEquity: number;
+    /** Number of shares outstanding */
+    sharesOutstanding?: number | null;
+    period?: string;
+}
+interface CashFlowStatement {
+    /** Cash from operating activities */
+    operatingCashFlow: number;
+    /** Capital expenditures (positive = spending, negative also common) */
+    capex: number;
+    /** Cash from investing activities */
+    investingCashFlow?: number | null;
+    /** Cash from financing activities */
+    financingCashFlow?: number | null;
+    /** Net change in cash */
+    netChangeInCash?: number | null;
+    /** Stock-based compensation */
+    stockBasedCompensation?: number | null;
+    /** Dividends paid */
+    dividendsPaid?: number | null;
+    /** Debt repayments */
+    debtRepayments?: number | null;
+    /** Debt issuance */
+    debtIssuance?: number | null;
+    /** Depreciation and amortization (from cash flow statement) */
+    depreciationAndAmortization?: number | null;
+    period?: string;
+}
+/**
+ * Convenience bundle of all three statements for a single period.
+ */
+interface FinancialStatements {
+    income: IncomeStatement;
+    balance: BalanceSheet;
+    cashFlow: CashFlowStatement;
+}
+
+export type { BalanceSheet as B, CashFlowStatement as C, FinancialStatements as F, IncomeStatement as I };

package/dist/financials-DUHxWDPS.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Core financial statement types.
+ * All monetary values should be in the same currency unit (e.g., USD thousands).
+ * Use null for unavailable/inapplicable fields.
+ */
+interface IncomeStatement {
+    /** Total revenue / net sales */
+    revenue: number;
+    /** Revenue minus cost of goods sold */
+    grossProfit: number;
+    /** Cost of goods sold */
+    cogs: number;
+    /** Earnings before interest and taxes */
+    ebit: number;
+    /** EBIT + Depreciation + Amortization */
+    ebitda: number;
+    /** Net income after all expenses and taxes */
+    netIncome: number;
+    /** Interest expense (positive = expense) */
+    interestExpense: number;
+    /** Income tax expense */
+    incomeTaxExpense: number;
+    /** Earnings before taxes */
+    ebt: number;
+    /** Depreciation and amortization */
+    depreciationAndAmortization: number;
+    /** Research and development expense */
+    researchAndDevelopment?: number | null;
+    /** Selling, general and administrative expense */
+    sgaExpense?: number | null;
+    /** Basic shares outstanding */
+    sharesOutstanding: number;
+    /** Diluted shares outstanding */
+    sharesOutstandingDiluted?: number | null;
+    /** Earnings per share (basic) */
+    eps?: number | null;
+    /** Earnings per share (diluted) */
+    epsDiluted?: number | null;
+    /** Fiscal period label, e.g. "2024-Q1" or "FY2023" */
+    period?: string;
+}
+interface BalanceSheet {
+    /** Total assets */
+    totalAssets: number;
+    /** Current assets */
+    currentAssets: number;
+    /** Cash and cash equivalents */
+    cash: number;
+    /** Short-term investments */
+    shortTermInvestments?: number | null;
+    /** Accounts receivable */
+    accountsReceivable: number;
+    /** Inventory */
+    inventory: number;
+    /** Net PP&E (property, plant, equipment) */
+    netPPE: number;
+    /** Goodwill */
+    goodwill?: number | null;
+    /** Intangible assets (excluding goodwill) */
+    intangibleAssets?: number | null;
+    /** Retained earnings */
+    retainedEarnings: number;
+    /** Total liabilities */
+    totalLiabilities: number;
+    /** Current liabilities */
+    currentLiabilities: number;
+    /** Accounts payable */
+    accountsPayable: number;
+    /** Short-term debt */
+    shortTermDebt?: number | null;
+    /** Long-term debt */
+    longTermDebt: number;
+    /** Total debt (short-term + long-term) */
+    totalDebt: number;
+    /** Total shareholders' equity */
+    totalEquity: number;
+    /** Number of shares outstanding */
+    sharesOutstanding?: number | null;
+    period?: string;
+}
+interface CashFlowStatement {
+    /** Cash from operating activities */
+    operatingCashFlow: number;
+    /** Capital expenditures (positive = spending, negative also common) */
+    capex: number;
+    /** Cash from investing activities */
+    investingCashFlow?: number | null;
+    /** Cash from financing activities */
+    financingCashFlow?: number | null;
+    /** Net change in cash */
+    netChangeInCash?: number | null;
+    /** Stock-based compensation */
+    stockBasedCompensation?: number | null;
+    /** Dividends paid */
+    dividendsPaid?: number | null;
+    /** Debt repayments */
+    debtRepayments?: number | null;
+    /** Debt issuance */
+    debtIssuance?: number | null;
+    /** Depreciation and amortization (from cash flow statement) */
+    depreciationAndAmortization?: number | null;
+    period?: string;
+}
+/**
+ * Convenience bundle of all three statements for a single period.
+ */
+interface FinancialStatements {
+    income: IncomeStatement;
+    balance: BalanceSheet;
+    cashFlow: CashFlowStatement;
+}
+
+export type { BalanceSheet as B, CashFlowStatement as C, FinancialStatements as F, IncomeStatement as I };