market-feed 0.1.0

package/dist/index.cjs

@@ -0,0 +1,1141 @@
+'use strict';
+
+// market-feed — Unified financial market data client
+// https://github.com/piyushgupta344/market-feed
+
+// src/cache/memory.ts
+var MemoryCacheDriver = class {
+  store = /* @__PURE__ */ new Map();
+  maxSize;
+  constructor(maxSize = 500) {
+    this.maxSize = maxSize;
+  }
+  async get(key) {
+    const entry = this.store.get(key);
+    if (!entry) return void 0;
+    if (entry.expiresAt !== 0 && Date.now() > entry.expiresAt) {
+      this.store.delete(key);
+      return void 0;
+    }
+    this.store.delete(key);
+    this.store.set(key, entry);
+    return entry.value;
+  }
+  async set(key, value, ttlSeconds) {
+    if (this.store.size >= this.maxSize && !this.store.has(key)) {
+      const oldest = this.store.keys().next().value;
+      if (oldest !== void 0) {
+        this.store.delete(oldest);
+      }
+    }
+    const expiresAt = ttlSeconds !== void 0 && ttlSeconds > 0 ? Date.now() + ttlSeconds * 1e3 : 0;
+    this.store.set(key, { value, expiresAt });
+  }
+  async delete(key) {
+    this.store.delete(key);
+  }
+  async clear() {
+    this.store.clear();
+  }
+  /** Current number of cached entries (including potentially expired ones). */
+  get size() {
+    return this.store.size;
+  }
+};
+
+// src/errors.ts
+var MarketFeedError = class extends Error {
+  constructor(message, provider, cause) {
+    super(message);
+    this.provider = provider;
+    this.cause = cause;
+    this.name = "MarketFeedError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var ProviderError = class extends MarketFeedError {
+  constructor(message, provider, statusCode, cause) {
+    super(message, provider, cause);
+    this.statusCode = statusCode;
+    this.name = "ProviderError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var RateLimitError = class extends MarketFeedError {
+  constructor(provider, retryAfter) {
+    const when = retryAfter ? ` Retry after ${retryAfter.toISOString()}.` : "";
+    super(`Rate limit reached for provider "${provider}".${when}`, provider);
+    this.retryAfter = retryAfter;
+    this.name = "RateLimitError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var AllProvidersFailedError = class extends Error {
+  constructor(errors, operation) {
+    const summary = errors.map((e) => `[${e.provider}] ${e.message}`).join("; ");
+    super(`All providers failed for "${operation}": ${summary}`);
+    this.errors = errors;
+    this.name = "AllProvidersFailedError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var UnsupportedOperationError = class extends MarketFeedError {
+  constructor(provider, operation) {
+    super(`Provider "${provider}" does not support "${operation}".`, provider);
+    this.name = "UnsupportedOperationError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/http/client.ts
+var RETRYABLE_STATUSES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+function buildUrl(base, path, params) {
+  const url = new URL(path, base.endsWith("/") ? base : `${base}/`);
+  if (params) {
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== void 0) {
+        url.searchParams.set(key, String(value));
+      }
+    }
+  }
+  return url.toString();
+}
+async function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+var HttpClient = class {
+  constructor(providerName, options = {}) {
+    this.providerName = providerName;
+    this.baseUrl = options.baseUrl ?? "";
+    this.defaultHeaders = {
+      "Accept": "application/json",
+      "User-Agent": "market-feed/0.1.0 (+https://github.com/piyushgupta344/market-feed)",
+      ...options.headers
+    };
+    this.timeoutMs = options.timeoutMs ?? 1e4;
+    this.retries = options.retries ?? 2;
+    this.retryDelayMs = options.retryDelayMs ?? 300;
+  }
+  baseUrl;
+  defaultHeaders;
+  timeoutMs;
+  retries;
+  retryDelayMs;
+  async get(path, options = {}) {
+    const url = buildUrl(this.baseUrl, path, options.params);
+    const headers = { ...this.defaultHeaders, ...options.headers };
+    const timeoutMs = options.timeoutMs ?? this.timeoutMs;
+    let lastError;
+    for (let attempt = 0; attempt <= this.retries; attempt++) {
+      if (attempt > 0) {
+        await sleep(this.retryDelayMs * 2 ** (attempt - 1));
+      }
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), timeoutMs);
+      try {
+        const response = await fetch(url, {
+          method: "GET",
+          headers,
+          signal: controller.signal
+        });
+        clearTimeout(timer);
+        if (!response.ok) {
+          if (RETRYABLE_STATUSES.has(response.status) && attempt < this.retries) {
+            lastError = new ProviderError(
+              `HTTP ${response.status} from ${url}`,
+              this.providerName,
+              response.status
+            );
+            continue;
+          }
+          throw new ProviderError(
+            `HTTP ${response.status} ${response.statusText} from ${url}`,
+            this.providerName,
+            response.status
+          );
+        }
+        const contentType = response.headers.get("content-type") ?? "";
+        if (!contentType.includes("application/json") && !contentType.includes("text/plain")) {
+        }
+        return await response.json();
+      } catch (err) {
+        clearTimeout(timer);
+        if (err instanceof ProviderError) {
+          throw err;
+        }
+        if (err instanceof Error && err.name === "AbortError") {
+          throw new ProviderError(
+            `Request to ${url} timed out after ${timeoutMs}ms`,
+            this.providerName
+          );
+        }
+        if (attempt < this.retries) {
+          lastError = err;
+          continue;
+        }
+        throw new ProviderError(
+          `Network error fetching ${url}: ${err instanceof Error ? err.message : String(err)}`,
+          this.providerName,
+          void 0,
+          err
+        );
+      }
+    }
+    throw new ProviderError(
+      `Failed after ${this.retries + 1} attempts`,
+      this.providerName,
+      void 0,
+      lastError
+    );
+  }
+};
+
+// src/utils/symbol.ts
+function stripExchange(symbol) {
+  return symbol.split(".")[0] ?? symbol;
+}
+function normalise(symbol) {
+  return symbol.trim().toUpperCase();
+}
+function toYahooSymbol(symbol) {
+  const s = normalise(stripExchange(symbol));
+  if (s.includes("/")) return s.replace("/", "-");
+  return s;
+}
+function toAlphaVantageSymbol(symbol) {
+  return normalise(stripExchange(symbol)).replace(/[-/]/g, "");
+}
+function toPolygonSymbol(symbol) {
+  const s = normalise(stripExchange(symbol));
+  if (s.includes("-")) {
+    const [base, quote] = s.split("-");
+    if (base && quote && quote.length === 3) {
+      return `X:${base}${quote}`;
+    }
+  }
+  return s;
+}
+function dedupeSymbols(symbols) {
+  return [...new Set(symbols.map(normalise))];
+}
+
+// src/providers/yahoo/transform.ts
+var PROVIDER = "yahoo";
+function transformQuote(result, raw) {
+  const meta = result.meta;
+  return {
+    symbol: meta.symbol,
+    name: meta.symbol,
+    // Yahoo chart API doesn't return company name — enriched separately
+    price: meta.regularMarketPrice,
+    change: meta.regularMarketPrice - meta.regularMarketPreviousClose,
+    changePercent: (meta.regularMarketPrice - meta.regularMarketPreviousClose) / meta.regularMarketPreviousClose * 100,
+    open: meta.regularMarketDayHigh,
+    // chart meta has dayHigh/Low not open — see below
+    high: meta.regularMarketDayHigh,
+    low: meta.regularMarketDayLow,
+    close: meta.regularMarketPrice,
+    previousClose: meta.regularMarketPreviousClose,
+    volume: meta.regularMarketVolume,
+    ...meta.fiftyTwoWeekHigh !== void 0 ? { fiftyTwoWeekHigh: meta.fiftyTwoWeekHigh } : {},
+    ...meta.fiftyTwoWeekLow !== void 0 ? { fiftyTwoWeekLow: meta.fiftyTwoWeekLow } : {},
+    currency: meta.currency,
+    exchange: meta.fullExchangeName ?? meta.exchangeName,
+    timestamp: new Date(meta.regularMarketTime * 1e3),
+    provider: PROVIDER,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+function transformHistorical(result, raw) {
+  const timestamps = result.timestamp ?? [];
+  const quoteIndicators = result.indicators.quote[0];
+  const adjCloseIndicators = result.indicators.adjclose?.[0];
+  if (!quoteIndicators) return [];
+  return timestamps.map((ts, i) => {
+    const open = quoteIndicators.open[i];
+    const high = quoteIndicators.high[i];
+    const low = quoteIndicators.low[i];
+    const close = quoteIndicators.close[i];
+    const volume = quoteIndicators.volume[i];
+    const adjClose = adjCloseIndicators?.adjclose[i];
+    if (open == null || high == null || low == null || close == null || volume == null) {
+      return null;
+    }
+    const bar = {
+      date: new Date(ts * 1e3),
+      open,
+      high,
+      low,
+      close,
+      volume,
+      ...adjClose !== null && adjClose !== void 0 ? { adjClose } : {},
+      ...raw !== void 0 ? { raw } : {}
+    };
+    return bar;
+  }).filter((bar) => bar !== null);
+}
+function transformCompany(symbol, result, raw) {
+  const profile = result.assetProfile;
+  const summary = result.summaryDetail;
+  const price = result.price;
+  const officers = profile?.companyOfficers ?? [];
+  const ceo = officers.find(
+    (o) => (o.title ?? "").toLowerCase().includes("chief executive")
+  )?.name;
+  return {
+    symbol,
+    name: price?.longName ?? price?.shortName ?? symbol,
+    ...profile?.longBusinessSummary !== void 0 ? { description: profile.longBusinessSummary } : {},
+    ...profile?.sector !== void 0 ? { sector: profile.sector } : {},
+    ...profile?.industry !== void 0 ? { industry: profile.industry } : {},
+    ...profile?.country !== void 0 ? { country: profile.country } : {},
+    ...profile?.fullTimeEmployees !== void 0 ? { employees: profile.fullTimeEmployees } : {},
+    ...profile?.website !== void 0 ? { website: profile.website } : {},
+    ...ceo !== void 0 ? { ceo } : {},
+    ...summary?.marketCap?.raw !== void 0 ? { marketCap: summary.marketCap.raw } : {},
+    ...summary?.trailingPE?.raw !== void 0 ? { peRatio: summary.trailingPE.raw } : {},
+    ...summary?.forwardPE?.raw !== void 0 ? { forwardPE: summary.forwardPE.raw } : {},
+    ...summary?.priceToBook?.raw !== void 0 ? { priceToBook: summary.priceToBook.raw } : {},
+    ...summary?.dividendYield?.raw !== void 0 ? { dividendYield: summary.dividendYield.raw } : {},
+    ...summary?.beta?.raw !== void 0 ? { beta: summary.beta.raw } : {},
+    ...price?.exchangeName !== void 0 ? { exchange: price.exchangeName } : {},
+    ...price?.currency !== void 0 ? { currency: price.currency } : summary?.currency !== void 0 ? { currency: summary.currency } : {},
+    provider: PROVIDER,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+var YAHOO_TYPE_MAP = {
+  EQUITY: "stock",
+  ETF: "etf",
+  CRYPTOCURRENCY: "crypto",
+  CURRENCY: "forex",
+  INDEX: "index",
+  MUTUALFUND: "mutual-fund",
+  FUTURE: "future"
+};
+function transformSearch(quote, raw) {
+  const exchange = quote.exchDisp ?? quote.exchange;
+  return {
+    symbol: quote.symbol,
+    name: quote.longname ?? quote.shortname ?? quote.symbol,
+    type: YAHOO_TYPE_MAP[quote.quoteType?.toUpperCase() ?? ""] ?? "unknown",
+    ...exchange !== void 0 ? { exchange } : {},
+    provider: PROVIDER,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+
+// src/providers/yahoo/index.ts
+var YahooProvider = class {
+  name = "yahoo";
+  http1;
+  http2;
+  constructor(options = {}) {
+    const shared = {
+      ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
+      ...options.retries !== void 0 ? { retries: options.retries } : {},
+      headers: {
+        "Accept": "application/json",
+        "Accept-Language": "en-US,en;q=0.9"
+      }
+    };
+    this.http1 = new HttpClient("yahoo", {
+      ...shared,
+      baseUrl: "https://query1.finance.yahoo.com"
+    });
+    this.http2 = new HttpClient("yahoo", {
+      ...shared,
+      baseUrl: "https://query2.finance.yahoo.com"
+    });
+  }
+  // ---------------------------------------------------------------------------
+  // Quote
+  // ---------------------------------------------------------------------------
+  async quote(symbols, options) {
+    const results = await Promise.all(
+      symbols.map((symbol) => this.fetchSingleQuote(symbol, options))
+    );
+    return results;
+  }
+  async fetchSingleQuote(symbol, options) {
+    const s = toYahooSymbol(symbol);
+    const data = await this.http1.get(`/v8/finance/chart/${s}`, {
+      params: {
+        interval: "1d",
+        range: "1d",
+        includePrePost: false
+      }
+    });
+    const result = data.chart.result?.[0];
+    if (!result) {
+      const err = data.chart.error;
+      throw new ProviderError(
+        err?.description ?? `No data returned for symbol "${s}"`,
+        this.name
+      );
+    }
+    return transformQuote(result, options?.raw ? data : void 0);
+  }
+  // ---------------------------------------------------------------------------
+  // Historical
+  // ---------------------------------------------------------------------------
+  async historical(symbol, options) {
+    const s = toYahooSymbol(symbol);
+    const interval = options?.interval ?? "1d";
+    const period1 = toEpoch(options?.period1 ?? subtractOneYear());
+    const period2 = toEpoch(options?.period2 ?? /* @__PURE__ */ new Date());
+    const data = await this.http1.get(`/v8/finance/chart/${s}`, {
+      params: {
+        interval,
+        period1,
+        period2,
+        events: "div,splits",
+        includeAdjustedClose: true
+      }
+    });
+    const result = data.chart.result?.[0];
+    if (!result) {
+      const err = data.chart.error;
+      throw new ProviderError(
+        err?.description ?? `No historical data for symbol "${s}"`,
+        this.name
+      );
+    }
+    return transformHistorical(result, options?.raw ? data : void 0);
+  }
+  // ---------------------------------------------------------------------------
+  // Search
+  // ---------------------------------------------------------------------------
+  async search(query, options) {
+    const limit = options?.limit ?? 10;
+    const data = await this.http1.get("/v1/finance/search", {
+      params: {
+        q: query,
+        quotesCount: limit,
+        newsCount: 0,
+        enableFuzzyQuery: false,
+        enableEnhancedTrivialQuery: true
+      }
+    });
+    return (data.quotes ?? []).slice(0, limit).map((q) => transformSearch(q, options?.raw ? q : void 0));
+  }
+  // ---------------------------------------------------------------------------
+  // Company
+  // ---------------------------------------------------------------------------
+  async company(symbol, options) {
+    const s = toYahooSymbol(symbol);
+    const data = await this.http2.get(
+      `/v10/finance/quoteSummary/${s}`,
+      {
+        params: {
+          modules: "assetProfile,summaryDetail,price"
+        }
+      }
+    );
+    const result = data.quoteSummary.result?.[0];
+    if (!result) {
+      const err = data.quoteSummary.error;
+      throw new ProviderError(
+        err?.description ?? `No company data for symbol "${s}"`,
+        this.name
+      );
+    }
+    return transformCompany(symbol, result, options?.raw ? data : void 0);
+  }
+};
+function toEpoch(date) {
+  const d = date instanceof Date ? date : new Date(date);
+  return Math.floor(d.getTime() / 1e3);
+}
+function subtractOneYear() {
+  const d = /* @__PURE__ */ new Date();
+  d.setFullYear(d.getFullYear() - 1);
+  return d;
+}
+
+// src/client.ts
+var DEFAULT_TTLS = {
+  quote: 60,
+  historical: 3600,
+  company: 86400,
+  news: 300,
+  search: 600,
+  marketStatus: 60
+};
+var MarketFeed = class {
+  providers;
+  cache;
+  fallback;
+  ttls;
+  constructor(options = {}) {
+    this.providers = options.providers && options.providers.length > 0 ? options.providers : [new YahooProvider()];
+    this.fallback = options.fallback ?? true;
+    if (options.cache === false) {
+      this.cache = null;
+    } else {
+      const cfg = options.cache ?? {};
+      this.cache = cfg.driver ?? new MemoryCacheDriver(cfg.maxSize ?? 500);
+    }
+    const overrides = options.cache !== false ? options.cache?.ttlOverrides ?? {} : {};
+    this.ttls = { ...DEFAULT_TTLS, ...overrides };
+  }
+  async quote(symbolOrSymbols, options) {
+    const isSingle = typeof symbolOrSymbols === "string";
+    const symbols = isSingle ? [symbolOrSymbols] : symbolOrSymbols;
+    const cacheKey = `quote:${symbols.join(",")}`;
+    const cached = await this.getCache(cacheKey);
+    if (cached) return isSingle ? cached[0] : cached;
+    const result = await this.withFallback(
+      "quote",
+      (provider) => provider.quote(symbols, options)
+    );
+    await this.setCache(cacheKey, result, "quote");
+    return isSingle ? result[0] : result;
+  }
+  // ---------------------------------------------------------------------------
+  // historical
+  // ---------------------------------------------------------------------------
+  async historical(symbol, options) {
+    const interval = options?.interval ?? "1d";
+    const p1 = normaliseDate(options?.period1);
+    const p2 = normaliseDate(options?.period2 ?? /* @__PURE__ */ new Date());
+    const cacheKey = `historical:${symbol}:${interval}:${p1}:${p2}`;
+    const cached = await this.getCache(cacheKey);
+    if (cached) return cached;
+    const result = await this.withFallback(
+      "historical",
+      (provider) => provider.historical(symbol, options)
+    );
+    await this.setCache(cacheKey, result, "historical");
+    return result;
+  }
+  // ---------------------------------------------------------------------------
+  // search
+  // ---------------------------------------------------------------------------
+  async search(query, options) {
+    const cacheKey = `search:${query}:${options?.limit ?? 10}`;
+    const cached = await this.getCache(cacheKey);
+    if (cached) return cached;
+    const result = await this.withFallback(
+      "search",
+      (provider) => provider.search(query, options)
+    );
+    await this.setCache(cacheKey, result, "search");
+    return result;
+  }
+  // ---------------------------------------------------------------------------
+  // company
+  // ---------------------------------------------------------------------------
+  async company(symbol, options) {
+    const cacheKey = `company:${symbol}`;
+    const cached = await this.getCache(cacheKey);
+    if (cached) return cached;
+    const result = await this.withFallback("company", (provider) => {
+      if (!provider.company) throw new UnsupportedOperationError(provider.name, "company");
+      return provider.company(symbol, options);
+    });
+    await this.setCache(cacheKey, result, "company");
+    return result;
+  }
+  // ---------------------------------------------------------------------------
+  // news
+  // ---------------------------------------------------------------------------
+  async news(symbol, options) {
+    const cacheKey = `news:${symbol}:${options?.limit ?? 10}`;
+    const cached = await this.getCache(cacheKey);
+    if (cached) return cached;
+    const result = await this.withFallback("news", (provider) => {
+      if (!provider.news) throw new UnsupportedOperationError(provider.name, "news");
+      return provider.news(symbol, options);
+    });
+    await this.setCache(cacheKey, result, "news");
+    return result;
+  }
+  // ---------------------------------------------------------------------------
+  // marketStatus
+  // ---------------------------------------------------------------------------
+  async marketStatus(market, options) {
+    const cacheKey = `marketStatus:${market ?? "default"}`;
+    const cached = await this.getCache(cacheKey);
+    if (cached) return cached;
+    const result = await this.withFallback("marketStatus", (provider) => {
+      if (!provider.marketStatus) {
+        throw new UnsupportedOperationError(provider.name, "marketStatus");
+      }
+      return provider.marketStatus(market, options);
+    });
+    await this.setCache(cacheKey, result, "marketStatus");
+    return result;
+  }
+  // ---------------------------------------------------------------------------
+  // Cache management
+  // ---------------------------------------------------------------------------
+  /** Invalidate all cached entries. */
+  async clearCache() {
+    await this.cache?.clear();
+  }
+  /** Invalidate a specific cache key (exact match). */
+  async invalidate(key) {
+    await this.cache?.delete(key);
+  }
+  // ---------------------------------------------------------------------------
+  // Internal helpers
+  // ---------------------------------------------------------------------------
+  async withFallback(operation, fn) {
+    const errors = [];
+    for (const provider of this.providers) {
+      try {
+        return await fn(provider);
+      } catch (err) {
+        if (err instanceof UnsupportedOperationError) {
+          if (!this.fallback) throw err;
+          errors.push(err);
+          continue;
+        }
+        if (err instanceof MarketFeedError) {
+          if (!this.fallback) throw err;
+          errors.push(err);
+          continue;
+        }
+        throw err;
+      }
+    }
+    throw new AllProvidersFailedError(errors, operation);
+  }
+  async getCache(key) {
+    if (!this.cache) return void 0;
+    return this.cache.get(key);
+  }
+  async setCache(key, value, method) {
+    if (!this.cache) return;
+    await this.cache.set(key, value, this.ttls[method]);
+  }
+};
+function normaliseDate(d) {
+  if (!d) return "";
+  const date = d instanceof Date ? d : new Date(d);
+  return date.toISOString().slice(0, 10);
+}
+
+// src/utils/rate-limiter.ts
+var RateLimiter = class {
+  // epoch ms
+  /**
+   * @param providerName  Used in error messages
+   * @param capacity      Maximum tokens in the bucket (= burst limit)
+   * @param refillRate    Tokens added per second
+   */
+  constructor(providerName, capacity, refillRate) {
+    this.providerName = providerName;
+    this.capacity = capacity;
+    this.refillRate = refillRate;
+    this.tokens = capacity;
+    this.lastRefill = Date.now();
+  }
+  tokens;
+  lastRefill;
+  /**
+   * Attempt to consume `count` tokens.
+   * Throws `RateLimitError` if insufficient tokens are available.
+   */
+  consume(count = 1) {
+    this.refill();
+    if (this.tokens < count) {
+      const deficit = count - this.tokens;
+      const waitSeconds = deficit / this.refillRate;
+      const retryAfter = new Date(Date.now() + waitSeconds * 1e3);
+      throw new RateLimitError(this.providerName, retryAfter);
+    }
+    this.tokens -= count;
+  }
+  /**
+   * Returns true if at least `count` tokens are available without consuming them.
+   */
+  canConsume(count = 1) {
+    this.refill();
+    return this.tokens >= count;
+  }
+  /** Milliseconds until the bucket has at least `count` tokens. 0 if already available. */
+  waitTimeMs(count = 1) {
+    this.refill();
+    if (this.tokens >= count) return 0;
+    const deficit = count - this.tokens;
+    return Math.ceil(deficit / this.refillRate * 1e3);
+  }
+  refill() {
+    const now = Date.now();
+    const elapsed = (now - this.lastRefill) / 1e3;
+    const newTokens = elapsed * this.refillRate;
+    this.tokens = Math.min(this.capacity, this.tokens + newTokens);
+    this.lastRefill = now;
+  }
+};
+
+// src/providers/alpha-vantage/transform.ts
+var PROVIDER2 = "alpha-vantage";
+function transformQuote2(raw, includeRaw) {
+  const price = parseFloat(raw["05. price"]);
+  const open = parseFloat(raw["02. open"]);
+  const high = parseFloat(raw["03. high"]);
+  const low = parseFloat(raw["04. low"]);
+  const previousClose = parseFloat(raw["08. previous close"]);
+  const change = parseFloat(raw["09. change"]);
+  const changePercent = parseFloat(raw["10. change percent"].replace("%", ""));
+  const volume = parseInt(raw["06. volume"], 10);
+  const latestDay = raw["07. latest trading day"];
+  return {
+    symbol: raw["01. symbol"],
+    name: raw["01. symbol"],
+    price,
+    change,
+    changePercent,
+    open,
+    high,
+    low,
+    close: price,
+    previousClose,
+    volume,
+    currency: "USD",
+    // AV free tier is USD only
+    exchange: "",
+    timestamp: /* @__PURE__ */ new Date(`${latestDay}T16:00:00-05:00`),
+    provider: PROVIDER2,
+    raw: includeRaw
+  };
+}
+function transformHistoricalBars(timeSeries, period1, period2, raw) {
+  return Object.entries(timeSeries).filter(([dateStr]) => {
+    const d = new Date(dateStr);
+    if (period1 && d < period1) return false;
+    if (period2 && d > period2) return false;
+    return true;
+  }).map(([dateStr, bar]) => ({
+    date: new Date(dateStr),
+    open: parseFloat(bar["1. open"]),
+    high: parseFloat(bar["2. high"]),
+    low: parseFloat(bar["3. low"]),
+    close: parseFloat(bar["4. close"]),
+    adjClose: parseFloat(bar["5. adjusted close"]),
+    volume: parseInt(bar["6. volume"], 10),
+    ...raw !== void 0 ? { raw } : {}
+  })).sort((a, b) => a.date.getTime() - b.date.getTime());
+}
+var AV_TYPE_MAP = {
+  equity: "stock",
+  etf: "etf",
+  "mutual fund": "mutual-fund",
+  crypto: "crypto",
+  forex: "forex",
+  index: "index"
+};
+function transformSearch2(match, raw) {
+  const rawType = match["3. type"].toLowerCase();
+  return {
+    symbol: match["1. symbol"],
+    name: match["2. name"],
+    type: AV_TYPE_MAP[rawType] ?? "unknown",
+    exchange: match["4. region"],
+    currency: match["8. currency"],
+    provider: PROVIDER2,
+    raw
+  };
+}
+function transformCompany2(data, raw) {
+  return {
+    symbol: data.Symbol ?? "",
+    name: data.Name ?? data.Symbol ?? "",
+    ...data.Description ? { description: data.Description } : {},
+    ...data.Sector ? { sector: data.Sector } : {},
+    ...data.Industry ? { industry: data.Industry } : {},
+    ...data.Country ? { country: data.Country } : {},
+    ...data.FullTimeEmployees ? { employees: parseInt(data.FullTimeEmployees, 10) } : {},
+    ...data.OfficialSite ? { website: data.OfficialSite } : {},
+    ...data.MarketCapitalization ? { marketCap: parseFloat(data.MarketCapitalization) } : {},
+    ...data.TrailingPE ? { peRatio: parseFloat(data.TrailingPE) } : {},
+    ...data.ForwardPE ? { forwardPE: parseFloat(data.ForwardPE) } : {},
+    ...data.PriceToBookRatio ? { priceToBook: parseFloat(data.PriceToBookRatio) } : {},
+    ...data.DividendYield ? { dividendYield: parseFloat(data.DividendYield) } : {},
+    ...data.Beta ? { beta: parseFloat(data.Beta) } : {},
+    ...data.Exchange ? { exchange: data.Exchange } : {},
+    ...data.Currency ? { currency: data.Currency } : {},
+    ...data.IPODate ? { ipoDate: new Date(data.IPODate) } : {},
+    provider: PROVIDER2,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+
+// src/providers/alpha-vantage/index.ts
+var AlphaVantageProvider = class {
+  name = "alpha-vantage";
+  http;
+  apiKey;
+  limiter;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.http = new HttpClient("alpha-vantage", {
+      baseUrl: "https://www.alphavantage.co",
+      ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
+      ...options.retries !== void 0 ? { retries: options.retries } : {}
+    });
+    this.limiter = options.rateLimiter ?? new RateLimiter("alpha-vantage", 5, 5 / 60);
+  }
+  // ---------------------------------------------------------------------------
+  // Quote — uses GLOBAL_QUOTE function
+  // ---------------------------------------------------------------------------
+  async quote(symbols, options) {
+    const quotes = [];
+    for (const symbol of symbols) {
+      this.limiter.consume();
+      quotes.push(await this.fetchSingleQuote(symbol, options));
+    }
+    return quotes;
+  }
+  async fetchSingleQuote(symbol, options) {
+    const s = normalise(symbol);
+    const data = await this.http.get("/query", {
+      params: { function: "GLOBAL_QUOTE", symbol: s, apikey: this.apiKey }
+    });
+    this.checkRateLimit(data);
+    const gq = data["Global Quote"];
+    if (!gq || !gq["01. symbol"]) {
+      throw new ProviderError(`No quote data returned for "${s}"`, this.name);
+    }
+    return transformQuote2(gq, options?.raw ? data : void 0);
+  }
+  // ---------------------------------------------------------------------------
+  // Historical — uses TIME_SERIES_DAILY_ADJUSTED
+  // ---------------------------------------------------------------------------
+  async historical(symbol, options) {
+    this.limiter.consume();
+    const s = normalise(symbol);
+    const outputsize = "full";
+    const data = await this.http.get("/query", {
+      params: {
+        function: "TIME_SERIES_DAILY_ADJUSTED",
+        symbol: s,
+        outputsize,
+        apikey: this.apiKey
+      }
+    });
+    this.checkRateLimit(data);
+    const timeSeries = data["Time Series (Daily Adjusted)"] ?? data["Time Series (Daily)"];
+    if (!timeSeries) {
+      throw new ProviderError(`No historical data returned for "${s}"`, this.name);
+    }
+    const period1 = options?.period1 ? new Date(options.period1) : (() => {
+      const d = /* @__PURE__ */ new Date();
+      d.setFullYear(d.getFullYear() - 1);
+      return d;
+    })();
+    const period2 = options?.period2 ? new Date(options.period2) : /* @__PURE__ */ new Date();
+    return transformHistoricalBars(
+      timeSeries,
+      period1,
+      period2,
+      options?.raw ? data : void 0
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // Search — uses SYMBOL_SEARCH
+  // ---------------------------------------------------------------------------
+  async search(query, options) {
+    this.limiter.consume();
+    const data = await this.http.get("/query", {
+      params: { function: "SYMBOL_SEARCH", keywords: query, apikey: this.apiKey }
+    });
+    this.checkRateLimit(data);
+    const limit = options?.limit ?? 10;
+    return (data.bestMatches ?? []).slice(0, limit).map((m) => transformSearch2(m, options?.raw ? m : void 0));
+  }
+  // ---------------------------------------------------------------------------
+  // Company — uses OVERVIEW
+  // ---------------------------------------------------------------------------
+  async company(symbol, options) {
+    this.limiter.consume();
+    const s = normalise(symbol);
+    const data = await this.http.get("/query", {
+      params: { function: "OVERVIEW", symbol: s, apikey: this.apiKey }
+    });
+    this.checkRateLimit(data);
+    if (!data.Symbol) {
+      throw new ProviderError(`No company overview returned for "${s}"`, this.name);
+    }
+    return transformCompany2(data, options?.raw ? data : void 0);
+  }
+  // ---------------------------------------------------------------------------
+  // Internal
+  // ---------------------------------------------------------------------------
+  checkRateLimit(data) {
+    const info = data["Information"];
+    const note = data["Note"];
+    const msg = info ?? note ?? "";
+    if (msg.toLowerCase().includes("rate limit") || msg.toLowerCase().includes("api call")) {
+      throw new RateLimitError(this.name);
+    }
+  }
+};
+
+// src/providers/polygon/transform.ts
+var PROVIDER3 = "polygon";
+function transformQuote3(ticker, raw) {
+  const day = ticker.day;
+  const prev = ticker.prevDay;
+  const price = ticker.lastTrade?.p ?? day.c;
+  return {
+    symbol: ticker.ticker,
+    name: ticker.ticker,
+    price,
+    change: ticker.todaysChange,
+    changePercent: ticker.todaysChangePerc,
+    open: day.o,
+    high: day.h,
+    low: day.l,
+    close: day.c,
+    previousClose: prev.c,
+    volume: day.v,
+    currency: "USD",
+    exchange: "",
+    timestamp: new Date(ticker.updated / 1e6),
+    // nanoseconds → ms
+    provider: PROVIDER3,
+    raw
+  };
+}
+function transformHistoricalBar(bar, raw) {
+  return {
+    date: new Date(bar.t),
+    open: bar.o,
+    high: bar.h,
+    low: bar.l,
+    close: bar.c,
+    volume: bar.v,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+var POLYGON_TYPE_MAP = {
+  CS: "stock",
+  ETF: "etf",
+  ETN: "etf",
+  ETP: "etf",
+  CRYPTO: "crypto",
+  FX: "forex",
+  CURRENCY: "forex",
+  INDEX: "index",
+  MF: "mutual-fund",
+  FUND: "mutual-fund",
+  WARRANT: "unknown",
+  RIGHT: "unknown",
+  ADRC: "stock",
+  PFD: "stock"
+};
+function transformSearch3(ticker, raw) {
+  const type = ticker.type ? POLYGON_TYPE_MAP[ticker.type.toUpperCase()] ?? "unknown" : "unknown";
+  return {
+    symbol: ticker.ticker,
+    name: ticker.name,
+    type,
+    ...ticker.primary_exchange ? { exchange: ticker.primary_exchange } : {},
+    ...ticker.currency_name ? { currency: ticker.currency_name.toUpperCase() } : {},
+    provider: PROVIDER3,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+function transformCompany3(details, raw) {
+  return {
+    symbol: details.ticker,
+    name: details.name,
+    ...details.description ? { description: details.description } : {},
+    ...details.sic_description ? { sector: details.sic_description } : {},
+    ...details.address?.country ? { country: details.address.country } : {},
+    ...details.total_employees !== void 0 ? { employees: details.total_employees } : {},
+    ...details.homepage_url ? { website: details.homepage_url } : {},
+    ...details.market_cap !== void 0 ? { marketCap: details.market_cap } : {},
+    ...details.primary_exchange ? { exchange: details.primary_exchange } : {},
+    ...details.list_date ? { ipoDate: new Date(details.list_date) } : {},
+    provider: PROVIDER3,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+function transformNews(article, raw) {
+  return {
+    id: article.id,
+    title: article.title,
+    ...article.description ? { summary: article.description } : {},
+    url: article.article_url,
+    source: article.publisher?.name ?? "unknown",
+    publishedAt: new Date(article.published_utc),
+    symbols: article.tickers ?? [],
+    ...article.image_url ? { thumbnail: article.image_url } : {},
+    provider: PROVIDER3,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+
+// src/providers/polygon/index.ts
+var PolygonProvider = class {
+  constructor(options) {
+    this.options = options;
+    this.http = new HttpClient("polygon", {
+      baseUrl: "https://api.polygon.io",
+      ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
+      ...options.retries !== void 0 ? { retries: options.retries } : {},
+      headers: { Authorization: `Bearer ${options.apiKey}` }
+    });
+    this.limiter = options.rateLimiter ?? new RateLimiter("polygon", 5, 5 / 60);
+  }
+  name = "polygon";
+  http;
+  limiter;
+  // ---------------------------------------------------------------------------
+  // Quote — snapshot endpoint
+  // ---------------------------------------------------------------------------
+  async quote(symbols, options) {
+    this.limiter.consume();
+    const tickers = symbols.map(normalise).join(",");
+    const data = await this.http.get(
+      `/v2/snapshot/locale/us/markets/stocks/tickers`,
+      { params: { tickers, apiKey: this.options.apiKey } }
+    );
+    this.assertSuccess(data);
+    const tickerList = data.tickers ?? (data.ticker ? [data.ticker] : []);
+    if (tickerList.length === 0) {
+      throw new ProviderError(`No snapshot data for "${tickers}"`, this.name);
+    }
+    return tickerList.map((t) => transformQuote3(t, options?.raw ? t : void 0));
+  }
+  // ---------------------------------------------------------------------------
+  // Historical — aggregates endpoint
+  // ---------------------------------------------------------------------------
+  async historical(symbol, options) {
+    this.limiter.consume();
+    const s = normalise(symbol);
+    const interval = options?.interval ?? "1d";
+    const { multiplier, timespan } = parseInterval(interval);
+    const period1 = toDateString(options?.period1 ?? subtractOneYear2());
+    const period2 = toDateString(options?.period2 ?? /* @__PURE__ */ new Date());
+    const data = await this.http.get(
+      `/v2/aggs/ticker/${s}/range/${multiplier}/${timespan}/${period1}/${period2}`,
+      {
+        params: {
+          adjusted: true,
+          sort: "asc",
+          limit: 5e4,
+          apiKey: this.options.apiKey
+        }
+      }
+    );
+    this.assertSuccess(data);
+    return (data.results ?? []).map(
+      (bar) => transformHistoricalBar(bar, options?.raw ? bar : void 0)
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // Search — reference tickers endpoint
+  // ---------------------------------------------------------------------------
+  async search(query, options) {
+    this.limiter.consume();
+    const limit = options?.limit ?? 10;
+    const data = await this.http.get("/v3/reference/tickers", {
+      params: {
+        search: query,
+        active: true,
+        limit,
+        apiKey: this.options.apiKey
+      }
+    });
+    this.assertSuccess(data);
+    return (data.results ?? []).map((t) => transformSearch3(t, options?.raw ? t : void 0));
+  }
+  // ---------------------------------------------------------------------------
+  // Company — ticker details v3
+  // ---------------------------------------------------------------------------
+  async company(symbol, options) {
+    this.limiter.consume();
+    const s = normalise(symbol);
+    const data = await this.http.get(
+      `/v3/reference/tickers/${s}`,
+      { params: { apiKey: this.options.apiKey } }
+    );
+    this.assertSuccess(data);
+    if (!data.results) {
+      throw new ProviderError(`No company data for "${s}"`, this.name);
+    }
+    return transformCompany3(data.results, options?.raw ? data : void 0);
+  }
+  // ---------------------------------------------------------------------------
+  // News — ticker news endpoint
+  // ---------------------------------------------------------------------------
+  async news(symbol, options) {
+    this.limiter.consume();
+    const s = normalise(symbol);
+    const limit = options?.limit ?? 10;
+    const data = await this.http.get("/v2/reference/news", {
+      params: {
+        ticker: s,
+        limit,
+        order: "desc",
+        sort: "published_utc",
+        apiKey: this.options.apiKey
+      }
+    });
+    this.assertSuccess(data);
+    return (data.results ?? []).map((a) => transformNews(a, options?.raw ? a : void 0));
+  }
+  // ---------------------------------------------------------------------------
+  // Internal
+  // ---------------------------------------------------------------------------
+  assertSuccess(response) {
+    if (response.status === "ERROR" || response.error) {
+      throw new ProviderError(
+        response.error ?? `Polygon returned status "${response.status}"`,
+        this.name
+      );
+    }
+  }
+};
+function parseInterval(interval) {
+  const map = {
+    "1m": { multiplier: 1, timespan: "minute" },
+    "2m": { multiplier: 2, timespan: "minute" },
+    "5m": { multiplier: 5, timespan: "minute" },
+    "15m": { multiplier: 15, timespan: "minute" },
+    "30m": { multiplier: 30, timespan: "minute" },
+    "60m": { multiplier: 60, timespan: "minute" },
+    "1h": { multiplier: 1, timespan: "hour" },
+    "1d": { multiplier: 1, timespan: "day" },
+    "5d": { multiplier: 5, timespan: "day" },
+    "1wk": { multiplier: 1, timespan: "week" },
+    "1mo": { multiplier: 1, timespan: "month" },
+    "3mo": { multiplier: 3, timespan: "month" }
+  };
+  return map[interval] ?? { multiplier: 1, timespan: "day" };
+}
+function toDateString(date) {
+  const d = date instanceof Date ? date : new Date(date);
+  return d.toISOString().slice(0, 10);
+}
+function subtractOneYear2() {
+  const d = /* @__PURE__ */ new Date();
+  d.setFullYear(d.getFullYear() - 1);
+  return d;
+}
+
+exports.AllProvidersFailedError = AllProvidersFailedError;
+exports.AlphaVantageProvider = AlphaVantageProvider;
+exports.MarketFeed = MarketFeed;
+exports.MarketFeedError = MarketFeedError;
+exports.MemoryCacheDriver = MemoryCacheDriver;
+exports.PolygonProvider = PolygonProvider;
+exports.ProviderError = ProviderError;
+exports.RateLimitError = RateLimitError;
+exports.RateLimiter = RateLimiter;
+exports.UnsupportedOperationError = UnsupportedOperationError;
+exports.YahooProvider = YahooProvider;
+exports.dedupeSymbols = dedupeSymbols;
+exports.normalise = normalise;
+exports.stripExchange = stripExchange;
+exports.toAlphaVantageSymbol = toAlphaVantageSymbol;
+exports.toPolygonSymbol = toPolygonSymbol;
+exports.toYahooSymbol = toYahooSymbol;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map