types.ts

// FMP API Response Types
export interface FmpProfile {
  symbol: string;
  price: number;
  companyName: string;
  sector: string;
  industry: string;
  description: string;
  exchangeShortName: string;
  marketCap: number;
  dividendYield: number;
}

export interface FmpQuote {
  price: number;
  changesPercentage: number;
  change: number;
  yearLow: number;
  yearHigh: number;
  marketCap: number;
  pe: number;
  eps: number;
  volume: number;
  avgVolume: number;
}

export interface FmpIncomeStatement {
  calendarYear: string;
  revenue: number;
  incomeBeforeTax: number;
  netIncome: number;
  weightedAverageShsOut: number;
  eps: number;
  epsDiluted?: number;
}

export interface FmpBalanceSheet {
  calendarYear: string;
  date: string;
  totalStockholdersEquity: number;
  totalDebt: number;
  longTermDebt: number;
  totalAssets: number;
  cashAndCashEquivalents: number;
  totalCurrentAssets: number;
  totalCurrentLiabilities: number;
}

export interface FmpRatio {
  calendarYear: string;
  returnOnEquity: number;
  payoutRatio: number;
  interestCoverage: number;
  currentRatio: number;
  priceEarningsRatio: number;
  dividendYield: number;
}

export interface FmpAnalystEstimate {
  estimatedEpsAvg: number;
  growthEstimationYear5: number; // Often used for LT growth
}

export interface FmpHistoricalPrice {
  date: string;
  close: number;
}

export interface FmpIntradayPrice {
  date: string;
  close: number;
}

export interface FmpScore {
  altmanZScore: number;
  piotroskiScore: number;
}

export interface FmpRevenueSegmentation {
  fiscalYear: string;
  data: {
    [key: string]: number;
  };
}

export interface FmpCashFlowStatement {
    fiscalYear: string;
    netIncome: number;
    netCashProvidedByOperatingActivities: number;
    netCashProvidedByInvestingActivities: number;
    netCashProvidedByFinancingActivities: number;
    capitalExpenditure: number;
    debtRepayment: number;
}

export interface FmpKeyMetricsTTM {
  peRatioTTM: number;
  dividendYieldTTM: number;
  payoutRatioTTM: number | null;
}

export interface FmpKeyMetrics {
  calendarYear: string;
  peRatio: number;
}

export interface FmpRawData {
  profile: FmpProfile[];
  quote: FmpQuote[];
  income: FmpIncomeStatement[];
  balance: FmpBalanceSheet[];
  balanceQuarterly: FmpBalanceSheet[];
  ratios: FmpRatio[];
  estimates: FmpAnalystEstimate[];
  score: FmpScore[];
  revenueSegmentation: FmpRevenueSegmentation[];
  cashFlow: FmpCashFlowStatement[];
  keyMetrics: FmpKeyMetrics[];
  keyMetricsTTM: FmpKeyMetricsTTM[];
}

export interface BalanceSheetDataPoint {
  period: string;
  totalAssets: number | null;
  totalLiabilities: number | null;
  totalEquity: number | null;
  totalDebt: number | null;
  longTermDebt: number | null;
  cash: number | null;
  currentRatio: number | null;
}

export interface ScoreCriterion {
  criterion: string;
  met: boolean;
  value: string;
  points: number;
}


export interface BuySellSignal {
  signal: 'Strong Buy' | 'Buy' | 'Hold' | 'Consider Selling' | 'Strong Sell';
  score: number;
  growthScore: number;
  healthScore: number;
  valuationScore: number;
  summary: string;
  breakdown: {
    growth: ScoreCriterion[];
    health: ScoreCriterion[];
    valuation: ScoreCriterion[];
  };
}

// Data structures for new Financial Flows card
export interface RevenueStream {
  year: string;
  [segment: string]: number | string;
}
export interface CashFlowSummary {
    year: string;
    operating: number;
    investing: number;
    financing: number;
}

// Data structures for Growth Trends card
export interface GrowthTrendDataPoint {
  year: string;
  revenue: number;
  eps: number;
}

export interface GrowthTrends {
  periodLabel: string;
  availableYears: number;
  years: string[];
  revenue: number[];
  eps: number[];
  sources: {
    provider: string;
    url: string;
    fetchedAt: string;
  }[];
  revenueCagr5y: number | null;
  revenueCagr10y: number | null;
  epsCagr5y: number | null;
  epsCagr10y: number | null;
  cagrNotes: string[];
}

export interface ReturnForecast {
  isDataSufficient: boolean;
  currentPrice: number | null;
  currentEps: number | null;
  epsGrowthForecast: number | null; // as percentage
  dividendYield: number | null; // as decimal
  payoutRatio: number | null; // as decimal
  historicalPeRatios: number[];
  sources: { provider: string; url: string; fetchedAt: string }[];
}


// Application Data Structure
export interface ReportData {
  ticker: string;
  asOf: string;
  snapshot: {
    name: string;
    sector: string;
    industry: string;
    exchange: string;
    summary: string;
    fullDescription: string;
    marketCap: number | null;
    dividendYieldPct: number | null;
  };
  growthQuality: {
    salesCagr5Pct: number | null;
    epsCagr5Pct: number | null;
    preTaxMargin5yAvgPct: number | null;
    roe5yAvgPct: number | null;
    debtToCapitalPct: number | null;
  };
  financialHealth: {
    piotroskiScore: number | null;
    altmanZScore: number | null;
  };
  financialFlows: {
    revenueStreams: RevenueStream[];
    cashFlows: CashFlowSummary[];
  };
  balanceSheetHistory: {
    annual: BalanceSheetDataPoint[];
    quarterly: BalanceSheetDataPoint[];
  };
  valuation: {
    price: number | null;
    range52w: { low: number | null; high: number | null };
    peCurrent: number | null;
    pe5yAvg: number | null;
    relativeValuePct: number | null;
  };
  flags: {
    name: string;
    ok: boolean;
    note: string;
  }[];
  growthTrends: GrowthTrends;
  returnForecast: ReturnForecast;
  buySellSignal: BuySellSignal;
  plainEnglish: string;
}