BREAKING CHANGE(stocks): Unify stock provider API to discriminated IStockDataRequest and add company name/fullname enrichment

ts/stocks/providers/provider.yahoo.ts

@@ -1,6 +1,11 @@
 import * as plugins from '../../plugins.js';
 import type { IStockProvider, IProviderConfig } from '../interfaces/provider.js';
-import type { IStockPrice, IStockQuoteRequest, IStockBatchQuoteRequest } from '../interfaces/stockprice.js';
+import type {
+  IStockPrice,
+  IStockDataRequest,
+  IStockCurrentRequest,
+  IStockBatchCurrentRequest
+} from '../interfaces/stockprice.js';
 
 export class YahooFinanceProvider implements IStockProvider {
   public name = 'Yahoo Finance';
@@ -17,7 +22,28 @@ export class YahooFinanceProvider implements IStockProvider {
 
   constructor(private config?: IProviderConfig) {}
 
-  public async fetchPrice(request: IStockQuoteRequest): Promise<IStockPrice> {
+  /**
+   * Unified data fetching method
+   */
+  public async fetchData(request: IStockDataRequest): Promise<IStockPrice | IStockPrice[]> {
+    switch (request.type) {
+      case 'current':
+        return this.fetchCurrentPrice(request);
+      case 'batch':
+        return this.fetchBatchCurrentPrices(request);
+      case 'historical':
+        throw new Error('Yahoo Finance provider does not support historical data. Use Marketstack provider instead.');
+      case 'intraday':
+        throw new Error('Yahoo Finance provider does not support intraday data yet. Use Marketstack provider instead.');
+      default:
+        throw new Error(`Unsupported request type: ${(request as any).type}`);
+    }
+  }
+
+  /**
+   * Fetch current price for a single ticker
+   */
+  private async fetchCurrentPrice(request: IStockCurrentRequest): Promise<IStockPrice> {
     try {
       const url = `${this.baseUrl}/v8/finance/chart/${request.ticker}`;
       const response = await plugins.smartrequest.SmartRequest.create()
@@ -64,7 +90,10 @@ export class YahooFinanceProvider implements IStockProvider {
     }
   }
 
-  public async fetchPrices(request: IStockBatchQuoteRequest): Promise<IStockPrice[]> {
+  /**
+   * Fetch batch current prices
+   */
+  private async fetchBatchCurrentPrices(request: IStockBatchCurrentRequest): Promise<IStockPrice[]> {
     try {
       const symbols = request.tickers.join(',');
       const url = `${this.baseUrl}/v8/finance/spark?symbols=${symbols}&range=1d&interval=5m`;
@@ -123,7 +152,7 @@ export class YahooFinanceProvider implements IStockProvider {
   public async isAvailable(): Promise<boolean> {
     try {
       // Test with a well-known ticker
-      await this.fetchPrice({ ticker: 'AAPL' });
+      await this.fetchData({ type: 'current', ticker: 'AAPL' });
       return true;
     } catch (error) {
       console.warn('Yahoo Finance provider is not available:', error);