@lyniaca/lynstock 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lyniaca
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,197 @@
+# @lyniaca/lynstock
+
+Normalized, multi-source market data for stocks and crypto. Ask for a quote or
+some history and get the same shape back no matter which upstream API
+actually answered — LynStock tries sources in priority order and falls
+through automatically on a rate limit, an outage, or a missing API key.
+
+```ts
+import { LynStock } from "@lyniaca/lynstock";
+
+const lynstock = new LynStock();
+
+const quote = await lynstock.getQuote("AAPL", "stock");
+// { symbol: "AAPL", assetClass: "stock", price: 227.4, currency: "USD", timestamp: 1735689600000, source: "yahoo" }
+
+const btc = await lynstock.getQuote("BTC", "crypto");
+// { symbol: "BTC", assetClass: "crypto", price: 98213, currency: "USD", timestamp: 1735689600000, source: "coingecko" }
+```
+
+## Install
+
+```
+npm install @lyniaca/lynstock
+```
+
+ESM only (`"type": "module"`). Node 18+ for global `fetch`.
+
+## Why
+
+Free/cheap market data APIs (Alpha Vantage, Yahoo, IEX, CoinGecko, etc.) each
+have their own rate limits, outages, and response shapes. LynStock is a thin
+layer that hides all of that: your code asks one interface for a quote or a
+history window, and LynStock handles trying sources in order, skipping ones
+that are rate-limited or missing a required API key, and normalizing whatever
+comes back into one schema.
+
+## Quotes
+
+```ts
+const quote = await lynstock.getQuote(symbol, assetClass);
+```
+
+Every source normalizes into:
+
+```ts
+interface Quote {
+  symbol: string;
+  assetClass: "stock" | "crypto";
+  price: number;
+  currency: string;
+  timestamp: number; // ms since epoch, when LynStock received it
+  source: string;     // which upstream actually answered, e.g. "yahoo"
+}
+```
+
+## Historical data
+
+```ts
+const history = await lynstock.getHistorical("AAPL", "stock", {
+  from: new Date("2024-01-01"),
+  to: new Date("2024-02-01"),
+});
+```
+
+Returns daily OHLCV candles:
+
+```ts
+interface HistoricalResult {
+  symbol: string;
+  assetClass: "stock" | "crypto";
+  source: string;
+  candles: Candle[];
+}
+
+interface Candle {
+  timestamp: number; // start of the day, ms since epoch
+  open: number;
+  high: number;
+  low: number;
+  close: number;
+  volume?: number; // not every free-tier source exposes volume (e.g. CoinGecko's OHLC endpoint)
+}
+```
+
+Only daily granularity is supported for now.
+
+### Caching
+
+A historical range that ends before today is fully elapsed — none of these
+providers revise a past day's close after the fact — so LynStock caches that
+result in memory and never re-fetches it. A range that reaches into today is
+never cached, since today's candle is still moving.
+
+```ts
+// First call hits the network.
+await lynstock.getHistorical("AAPL", "stock", { from: jan1, to: jan31 });
+// Second call for the exact same symbol/range/asset class returns instantly, no network call.
+await lynstock.getHistorical("AAPL", "stock", { from: jan1, to: jan31 });
+```
+
+The default cache is an unbounded in-memory `Map`, fine for a single process.
+Pass your own implementation of the `HistoricalCache` interface (e.g. backed
+by Redis) via the `historicalCache` option if you need it shared across
+processes or persisted across restarts.
+
+## Supported sources
+
+| Source | Asset class | API key | Historical | Notes |
+|---|---|---|---|---|
+| Yahoo Finance | stock | no | yes | Default first choice for stocks. |
+| Alpha Vantage | stock | yes (free signup) | yes | Free tier: 25 requests/day. |
+| Finnhub | stock | yes (free signup) | no | Free tier no longer includes historical candles. |
+| Twelve Data | stock | yes (free signup) | yes | |
+| CoinGecko | crypto | no | yes | Default first choice for crypto. Historical has no volume on the free tier. |
+| Binance | crypto | no | yes | Blocked (HTTP 451) from some regions, including the US, at the network level — not something this library can work around. |
+| Coinbase | crypto | no | yes | Uses the public Exchange candles endpoint for history, not the spot-price endpoint. |
+| Kraken | crypto | no | yes | |
+| Stooq | stock | no | yes | **Not in the default priority.** Its quote endpoint currently 404s and its historical endpoint serves a JS anti-bot challenge instead of CSV. The adapter is implemented and opt-in via `setPriority` in case that changes. |
+| CoinCap | crypto | no | no (price-only, no OHLC) | **Not in the default priority.** `api.coincap.io` no longer resolves — the free v2 API was shut down. |
+
+Default priority order:
+
+```ts
+DEFAULT_STOCK_PRIORITY  = ["yahoo", "alphavantage", "finnhub", "twelvedata"];
+DEFAULT_CRYPTO_PRIORITY = ["coingecko", "binance", "coinbase", "kraken"];
+```
+
+## Configuration
+
+```ts
+const lynstock = new LynStock({
+  apiKeys: {
+    alphavantage: process.env.ALPHA_VANTAGE_KEY,
+    finnhub: process.env.FINNHUB_KEY,
+    twelvedata: process.env.TWELVE_DATA_KEY,
+  },
+  priorities: {
+    stock: ["yahoo", "twelvedata", "alphavantage"],
+    crypto: ["kraken", "coingecko", "binance"],
+  },
+  disabledSources: ["binance"], // e.g. you know you're on a blocked region
+});
+```
+
+All of it can also change after construction:
+
+```ts
+lynstock.setApiKey("finnhub", "...");
+lynstock.setPriority("stock", ["yahoo"]);
+lynstock.disableSource("binance");
+lynstock.enableSource("binance");
+lynstock.getPriority("crypto"); // ["coingecko", "binance", "coinbase", "kraken"]
+```
+
+A source that requires a key you haven't set is skipped automatically (it
+throws internally and LynStock moves on to the next one in priority order) —
+you don't need to filter it out of the priority list yourself.
+
+## Error handling
+
+If every source in the priority list fails, `getQuote`/`getHistorical` throws
+`AllSourcesFailedError`, which carries the per-source failure reasons:
+
+```ts
+try {
+  await lynstock.getQuote("AAPL", "stock");
+} catch (error) {
+  if (error instanceof AllSourcesFailedError) {
+    for (const { source, error: cause } of error.causes) {
+      console.log(source, cause.message);
+    }
+  }
+}
+```
+
+Other exported error types, mainly useful if you're writing your own source
+adapter: `RateLimitError`, `SourceError`, `MissingApiKeyError`,
+`UnsupportedSymbolError` (thrown for a crypto symbol with no known mapping to
+a given provider's id format — see `CRYPTO_SYMBOLS`).
+
+## Development
+
+```
+npm install
+npm run build       # tsc -> dist/
+npm test            # vitest, all mocked — no network calls
+npm run live-check  # hits real upstream APIs, prints pass/fail per source
+```
+
+`live-check` is not part of the automated test suite on purpose — it depends
+on the real internet and on providers' current rate limits/regional blocks,
+so its output will vary run to run. Run it by hand before a release to catch
+response-shape drift the mocked unit tests can't see.
+
+## License
+
+MIT

package/dist/cryptoSymbols.d.ts

@@ -0,0 +1,9 @@
+export interface CryptoSymbolMap {
+    coingecko?: string;
+    binance?: string;
+    coinbase?: string;
+    coincap?: string;
+    kraken?: string;
+}
+export declare const CRYPTO_SYMBOLS: Record<string, CryptoSymbolMap>;
+//# sourceMappingURL=cryptoSymbols.d.ts.map

package/dist/cryptoSymbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cryptoSymbols.d.ts","sourceRoot":"","sources":["../src/cryptoSymbols.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAqB1D,CAAC"}

package/dist/cryptoSymbols.js

@@ -0,0 +1,23 @@
+export const CRYPTO_SYMBOLS = {
+    BTC: { coingecko: "bitcoin", binance: "BTCUSDT", coinbase: "BTC-USD", coincap: "bitcoin", kraken: "XBTUSD" },
+    ETH: { coingecko: "ethereum", binance: "ETHUSDT", coinbase: "ETH-USD", coincap: "ethereum", kraken: "ETHUSD" },
+    SOL: { coingecko: "solana", binance: "SOLUSDT", coinbase: "SOL-USD", coincap: "solana", kraken: "SOLUSD" },
+    ADA: { coingecko: "cardano", binance: "ADAUSDT", coinbase: "ADA-USD", coincap: "cardano", kraken: "ADAUSD" },
+    XRP: { coingecko: "ripple", binance: "XRPUSDT", coinbase: "XRP-USD", coincap: "xrp", kraken: "XRPUSD" },
+    DOGE: { coingecko: "dogecoin", binance: "DOGEUSDT", coinbase: "DOGE-USD", coincap: "dogecoin", kraken: "DOGEUSD" },
+    LTC: { coingecko: "litecoin", binance: "LTCUSDT", coinbase: "LTC-USD", coincap: "litecoin", kraken: "LTCUSD" },
+    BCH: { coingecko: "bitcoin-cash", binance: "BCHUSDT", coinbase: "BCH-USD", coincap: "bitcoin-cash", kraken: "BCHUSD" },
+    DOT: { coingecko: "polkadot", binance: "DOTUSDT", coinbase: "DOT-USD", coincap: "polkadot", kraken: "DOTUSD" },
+    MATIC: { coingecko: "matic-network", binance: "MATICUSDT", coinbase: "MATIC-USD", coincap: "polygon", kraken: "MATICUSD" },
+    AVAX: { coingecko: "avalanche-2", binance: "AVAXUSDT", coinbase: "AVAX-USD", coincap: "avalanche", kraken: "AVAXUSD" },
+    LINK: { coingecko: "chainlink", binance: "LINKUSDT", coinbase: "LINK-USD", coincap: "chainlink", kraken: "LINKUSD" },
+    UNI: { coingecko: "uniswap", binance: "UNIUSDT", coinbase: "UNI-USD", coincap: "uniswap", kraken: "UNIUSD" },
+    ATOM: { coingecko: "cosmos", binance: "ATOMUSDT", coinbase: "ATOM-USD", coincap: "cosmos", kraken: "ATOMUSD" },
+    XLM: { coingecko: "stellar", binance: "XLMUSDT", coinbase: "XLM-USD", coincap: "stellar", kraken: "XLMUSD" },
+    ETC: { coingecko: "ethereum-classic", binance: "ETCUSDT", coinbase: "ETC-USD", coincap: "ethereum-classic", kraken: "ETCUSD" },
+    FIL: { coingecko: "filecoin", binance: "FILUSDT", coinbase: "FIL-USD", coincap: "filecoin", kraken: "FILUSD" },
+    ARB: { coingecko: "arbitrum", binance: "ARBUSDT", coinbase: "ARB-USD", coincap: "arbitrum", kraken: "ARBUSD" },
+    OP: { coingecko: "optimism", binance: "OPUSDT", coinbase: "OP-USD", coincap: "optimism", kraken: "OPUSD" },
+    APT: { coingecko: "aptos", binance: "APTUSDT", coinbase: "APT-USD", coincap: "aptos", kraken: "APTUSD" },
+};
+//# sourceMappingURL=cryptoSymbols.js.map

package/dist/cryptoSymbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cryptoSymbols.js","sourceRoot":"","sources":["../src/cryptoSymbols.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,28 @@
+export declare class RateLimitError extends Error {
+    readonly source: string;
+    constructor(source: string, message?: string);
+}
+export declare class SourceError extends Error {
+    readonly source: string;
+    constructor(source: string, message: string);
+}
+export declare class UnsupportedSymbolError extends Error {
+    readonly source: string;
+    readonly symbol: string;
+    constructor(source: string, symbol: string);
+}
+export declare class MissingApiKeyError extends Error {
+    readonly source: string;
+    constructor(source: string);
+}
+export interface SourceFailure {
+    source: string;
+    error: Error;
+}
+export declare class AllSourcesFailedError extends Error {
+    readonly symbol: string;
+    readonly assetClass: string;
+    readonly causes: SourceFailure[];
+    constructor(symbol: string, assetClass: string, causes: SourceFailure[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;aACX,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAI7D;AAED,qBAAa,WAAY,SAAQ,KAAK;aACR,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI5D;AAED,qBAAa,sBAAuB,SAAQ,KAAK;aACnB,MAAM,EAAE,MAAM;aAAkB,MAAM,EAAE,MAAM;gBAA9C,MAAM,EAAE,MAAM,EAAkB,MAAM,EAAE,MAAM;CAI3E;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aACf,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAI3C;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;CACd;AAED,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,MAAM,EAAE,MAAM;aACd,UAAU,EAAE,MAAM;aAClB,MAAM,EAAE,aAAa,EAAE;gBAFvB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,EAAE;CAU1C"}

package/dist/errors.js

@@ -0,0 +1,50 @@
+export class RateLimitError extends Error {
+    source;
+    constructor(source, message) {
+        super(message ?? `${source} rate limit exceeded`);
+        this.source = source;
+        this.name = "RateLimitError";
+    }
+}
+export class SourceError extends Error {
+    source;
+    constructor(source, message) {
+        super(message);
+        this.source = source;
+        this.name = "SourceError";
+    }
+}
+export class UnsupportedSymbolError extends Error {
+    source;
+    symbol;
+    constructor(source, symbol) {
+        super(`${source} does not support symbol "${symbol}"`);
+        this.source = source;
+        this.symbol = symbol;
+        this.name = "UnsupportedSymbolError";
+    }
+}
+export class MissingApiKeyError extends Error {
+    source;
+    constructor(source) {
+        super(`${source} requires an API key`);
+        this.source = source;
+        this.name = "MissingApiKeyError";
+    }
+}
+export class AllSourcesFailedError extends Error {
+    symbol;
+    assetClass;
+    causes;
+    constructor(symbol, assetClass, causes) {
+        super(`All sources failed for ${symbol} (${assetClass}): ` +
+            (causes.length === 0
+                ? "no sources configured for this asset class"
+                : causes.map((c) => `${c.source}: ${c.error.message}`).join("; ")));
+        this.symbol = symbol;
+        this.assetClass = assetClass;
+        this.causes = causes;
+        this.name = "AllSourcesFailedError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IACX;IAA5B,YAA4B,MAAc,EAAE,OAAgB;QAC1D,KAAK,CAAC,OAAO,IAAI,GAAG,MAAM,sBAAsB,CAAC,CAAC;QADxB,WAAM,GAAN,MAAM,CAAQ;QAExC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IACR;IAA5B,YAA4B,MAAc,EAAE,OAAe;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QADW,WAAM,GAAN,MAAM,CAAQ;QAExC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACnB;IAAgC;IAA5D,YAA4B,MAAc,EAAkB,MAAc;QACxE,KAAK,CAAC,GAAG,MAAM,6BAA6B,MAAM,GAAG,CAAC,CAAC;QAD7B,WAAM,GAAN,MAAM,CAAQ;QAAkB,WAAM,GAAN,MAAM,CAAQ;QAExE,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACf;IAA5B,YAA4B,MAAc;QACxC,KAAK,CAAC,GAAG,MAAM,sBAAsB,CAAC,CAAC;QADb,WAAM,GAAN,MAAM,CAAQ;QAExC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAOD,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAE5B;IACA;IACA;IAHlB,YACkB,MAAc,EACd,UAAkB,EAClB,MAAuB;QAEvC,KAAK,CACH,0BAA0B,MAAM,KAAK,UAAU,KAAK;YAClD,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;gBAClB,CAAC,CAAC,4CAA4C;gBAC9C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CACvE,CAAC;QATc,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAQ;QAClB,WAAM,GAAN,MAAM,CAAiB;QAQvC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/historicalCache.d.ts

@@ -0,0 +1,23 @@
+import type { AssetClass, HistoricalQuery, HistoricalResult } from "./types.js";
+export interface HistoricalCache {
+    get(key: string): HistoricalResult | undefined;
+    set(key: string, value: HistoricalResult): void;
+}
+/** Simple unbounded in-memory cache. Fine for a single process; swap in a real
+ *  cache (Redis, etc.) via the LynStock `historicalCache` option for anything
+ *  longer-lived than one process. */
+export declare class MemoryHistoricalCache implements HistoricalCache {
+    private readonly store;
+    get(key: string): HistoricalResult | undefined;
+    set(key: string, value: HistoricalResult): void;
+    clear(): void;
+    get size(): number;
+}
+export declare function buildHistoricalCacheKey(symbol: string, assetClass: AssetClass, query: HistoricalQuery): string;
+/**
+ * A range ending before the start of today is fully elapsed: none of the
+ * providers revise past daily closes, so a result for that range is safe to
+ * cache indefinitely instead of re-fetching the same history on every call.
+ */
+export declare function isFullyElapsed(query: HistoricalQuery): boolean;
+//# sourceMappingURL=historicalCache.d.ts.map

package/dist/historicalCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historicalCache.d.ts","sourceRoot":"","sources":["../src/historicalCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhF,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAC/C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACjD;AAED;;qCAEqC;AACrC,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAE7D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI9C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAI/C,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,eAAe,GACrB,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAI9D"}

package/dist/historicalCache.js

@@ -0,0 +1,33 @@
+import { toMs } from "./time.js";
+/** Simple unbounded in-memory cache. Fine for a single process; swap in a real
+ *  cache (Redis, etc.) via the LynStock `historicalCache` option for anything
+ *  longer-lived than one process. */
+export class MemoryHistoricalCache {
+    store = new Map();
+    get(key) {
+        return this.store.get(key);
+    }
+    set(key, value) {
+        this.store.set(key, value);
+    }
+    clear() {
+        this.store.clear();
+    }
+    get size() {
+        return this.store.size;
+    }
+}
+export function buildHistoricalCacheKey(symbol, assetClass, query) {
+    return `${assetClass}:${symbol.toUpperCase()}:${toMs(query.from)}:${toMs(query.to)}`;
+}
+/**
+ * A range ending before the start of today is fully elapsed: none of the
+ * providers revise past daily closes, so a result for that range is safe to
+ * cache indefinitely instead of re-fetching the same history on every call.
+ */
+export function isFullyElapsed(query) {
+    const startOfToday = new Date();
+    startOfToday.setUTCHours(0, 0, 0, 0);
+    return toMs(query.to) < startOfToday.getTime();
+}
+//# sourceMappingURL=historicalCache.js.map

package/dist/historicalCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historicalCache.js","sourceRoot":"","sources":["../src/historicalCache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOjC;;qCAEqC;AACrC,MAAM,OAAO,qBAAqB;IACf,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE7D,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAuB;QACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CACrC,MAAc,EACd,UAAsB,EACtB,KAAsB;IAEtB,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AACvF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAsB;IACnD,MAAM,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;IAChC,YAAY,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC;AACjD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./errors.js";
+export * from "./lynstock.js";
+export { CRYPTO_SYMBOLS, type CryptoSymbolMap } from "./cryptoSymbols.js";
+export { MemoryHistoricalCache, buildHistoricalCacheKey, isFullyElapsed, type HistoricalCache, } from "./historicalCache.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./errors.js";
+export * from "./lynstock.js";
+export { CRYPTO_SYMBOLS } from "./cryptoSymbols.js";
+export { MemoryHistoricalCache, buildHistoricalCacheKey, isFullyElapsed, } from "./historicalCache.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAwB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,GAEf,MAAM,sBAAsB,CAAC"}

package/dist/lynstock.d.ts

@@ -0,0 +1,45 @@
+import type { AssetClass, FetchLike, HistoricalQuery, HistoricalResult, Quote } from "./types.js";
+import { type HistoricalCache } from "./historicalCache.js";
+export type SourceName = "yahoo" | "stooq" | "alphavantage" | "finnhub" | "twelvedata" | "coingecko" | "binance" | "coinbase" | "coincap" | "kraken";
+export declare const DEFAULT_STOCK_PRIORITY: SourceName[];
+export declare const DEFAULT_CRYPTO_PRIORITY: SourceName[];
+export interface LynStockOptions {
+    /** API keys for sources that require one (alphavantage, finnhub, twelvedata). */
+    apiKeys?: Partial<Record<SourceName, string>>;
+    /** Override the fallback order tried for a given asset class. */
+    priorities?: Partial<Record<AssetClass, SourceName[]>>;
+    /** Sources to skip entirely, regardless of priority. */
+    disabledSources?: SourceName[];
+    /** Inject a custom fetch implementation (used for testing). */
+    fetchImpl?: FetchLike;
+    /** Defaults to an in-memory cache; pass your own (e.g. Redis-backed) for multi-process reuse. */
+    historicalCache?: HistoricalCache;
+}
+export declare class LynStock {
+    private readonly sources;
+    private readonly apiKeys;
+    private readonly disabled;
+    private readonly priorities;
+    private readonly historicalCache;
+    constructor(options?: LynStockOptions);
+    /** Reorder (or restrict) which sources are tried, and in what order, for an asset class. */
+    setPriority(assetClass: AssetClass, order: SourceName[]): void;
+    getPriority(assetClass: AssetClass): SourceName[];
+    setApiKey(source: SourceName, apiKey: string): void;
+    disableSource(source: SourceName): void;
+    enableSource(source: SourceName): void;
+    /**
+     * Fetches a quote, walking the configured priority list for the asset class and
+     * falling through to the next source whenever the current one errors (including
+     * on rate limits) so a single degraded upstream never fails the whole call.
+     */
+    getQuote(symbol: string, assetClass: AssetClass): Promise<Quote>;
+    /**
+     * Fetches daily OHLCV history, same priority/fallback behavior as getQuote.
+     * Results for a range that's fully in the past are cached indefinitely, since
+     * none of the upstream providers revise a closed day's candle after the fact —
+     * repeatedly asking for the same historical window never has to hit the network twice.
+     */
+    getHistorical(symbol: string, assetClass: AssetClass, query: HistoricalQuery): Promise<HistoricalResult>;
+}
+//# sourceMappingURL=lynstock.d.ts.map

package/dist/lynstock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lynstock.d.ts","sourceRoot":"","sources":["../src/lynstock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,EAAe,MAAM,YAAY,CAAC;AAE/G,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAY9B,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,OAAO,GACP,cAAc,GACd,SAAS,GACT,YAAY,GACZ,WAAW,GACX,SAAS,GACT,UAAU,GACV,SAAS,GACT,QAAQ,CAAC;AAMb,eAAO,MAAM,sBAAsB,EAAE,UAAU,EAK9C,CAAC;AAIF,eAAO,MAAM,uBAAuB,EAAE,UAAU,EAAmD,CAAC;AAEpG,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IACvD,wDAAwD;IACxD,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC;IAC/B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,iGAAiG;IACjG,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAEtC,OAAO,GAAE,eAAoB;IAyBzC,4FAA4F;IAC5F,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI;IAI9D,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE;IAIjD,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAInD,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIvC,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAItC;;;;OAIG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;IAuBtE;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAgC/G"}

package/dist/lynstock.js

@@ -0,0 +1,131 @@
+import { AllSourcesFailedError } from "./errors.js";
+import { buildHistoricalCacheKey, isFullyElapsed, MemoryHistoricalCache, } from "./historicalCache.js";
+import { createYahooSource } from "./sources/yahoo.js";
+import { createStooqSource } from "./sources/stooq.js";
+import { createAlphaVantageSource } from "./sources/alphaVantage.js";
+import { createFinnhubSource } from "./sources/finnhub.js";
+import { createTwelveDataSource } from "./sources/twelveData.js";
+import { createCoinGeckoSource } from "./sources/coinGecko.js";
+import { createBinanceSource } from "./sources/binance.js";
+import { createCoinbaseSource } from "./sources/coinbase.js";
+import { createCoinCapSource } from "./sources/coinCap.js";
+import { createKrakenSource } from "./sources/kraken.js";
+// Stooq is excluded by default: its quote endpoint currently 404s and its
+// historical endpoint serves a JS proof-of-work challenge a plain fetch can't
+// pass. The adapter is still exported for anyone who wants to opt in manually
+// via setPriority, in case that changes.
+export const DEFAULT_STOCK_PRIORITY = [
+    "yahoo",
+    "alphavantage",
+    "finnhub",
+    "twelvedata",
+];
+// CoinCap is excluded by default: api.coincap.io no longer resolves (the free
+// v2 API was shut down). Same opt-in-if-it-comes-back reasoning as Stooq above.
+export const DEFAULT_CRYPTO_PRIORITY = ["coingecko", "binance", "coinbase", "kraken"];
+export class LynStock {
+    sources;
+    apiKeys;
+    disabled;
+    priorities;
+    historicalCache;
+    constructor(options = {}) {
+        const fetchImpl = options.fetchImpl ?? fetch;
+        this.sources = new Map([
+            ["yahoo", createYahooSource(fetchImpl)],
+            ["stooq", createStooqSource(fetchImpl)],
+            ["alphavantage", createAlphaVantageSource(fetchImpl)],
+            ["finnhub", createFinnhubSource(fetchImpl)],
+            ["twelvedata", createTwelveDataSource(fetchImpl)],
+            ["coingecko", createCoinGeckoSource(fetchImpl)],
+            ["binance", createBinanceSource(fetchImpl)],
+            ["coinbase", createCoinbaseSource(fetchImpl)],
+            ["coincap", createCoinCapSource(fetchImpl)],
+            ["kraken", createKrakenSource(fetchImpl)],
+        ]);
+        this.apiKeys = { ...options.apiKeys };
+        this.disabled = new Set(options.disabledSources ?? []);
+        this.priorities = {
+            stock: options.priorities?.stock ?? [...DEFAULT_STOCK_PRIORITY],
+            crypto: options.priorities?.crypto ?? [...DEFAULT_CRYPTO_PRIORITY],
+        };
+        this.historicalCache = options.historicalCache ?? new MemoryHistoricalCache();
+    }
+    /** Reorder (or restrict) which sources are tried, and in what order, for an asset class. */
+    setPriority(assetClass, order) {
+        this.priorities[assetClass] = [...order];
+    }
+    getPriority(assetClass) {
+        return [...this.priorities[assetClass]];
+    }
+    setApiKey(source, apiKey) {
+        this.apiKeys[source] = apiKey;
+    }
+    disableSource(source) {
+        this.disabled.add(source);
+    }
+    enableSource(source) {
+        this.disabled.delete(source);
+    }
+    /**
+     * Fetches a quote, walking the configured priority list for the asset class and
+     * falling through to the next source whenever the current one errors (including
+     * on rate limits) so a single degraded upstream never fails the whole call.
+     */
+    async getQuote(symbol, assetClass) {
+        const order = this.priorities[assetClass];
+        const causes = [];
+        for (const sourceName of order) {
+            if (this.disabled.has(sourceName)) {
+                continue;
+            }
+            const source = this.sources.get(sourceName);
+            if (!source || !source.assetClasses.includes(assetClass)) {
+                continue;
+            }
+            try {
+                return await source.getQuote(symbol, this.apiKeys[sourceName]);
+            }
+            catch (error) {
+                causes.push({ source: sourceName, error: error });
+            }
+        }
+        throw new AllSourcesFailedError(symbol, assetClass, causes);
+    }
+    /**
+     * Fetches daily OHLCV history, same priority/fallback behavior as getQuote.
+     * Results for a range that's fully in the past are cached indefinitely, since
+     * none of the upstream providers revise a closed day's candle after the fact —
+     * repeatedly asking for the same historical window never has to hit the network twice.
+     */
+    async getHistorical(symbol, assetClass, query) {
+        const cacheKey = buildHistoricalCacheKey(symbol, assetClass, query);
+        const cached = this.historicalCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const order = this.priorities[assetClass];
+        const causes = [];
+        for (const sourceName of order) {
+            if (this.disabled.has(sourceName)) {
+                continue;
+            }
+            const source = this.sources.get(sourceName);
+            if (!source || !source.assetClasses.includes(assetClass) || !source.getHistorical) {
+                continue;
+            }
+            try {
+                const result = await source.getHistorical(symbol, query, this.apiKeys[sourceName]);
+                if (isFullyElapsed(query)) {
+                    this.historicalCache.set(cacheKey, result);
+                }
+                return result;
+            }
+            catch (error) {
+                causes.push({ source: sourceName, error: error });
+            }
+        }
+        throw new AllSourcesFailedError(symbol, assetClass, causes);
+    }
+}
+//# sourceMappingURL=lynstock.js.map

package/dist/lynstock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lynstock.js","sourceRoot":"","sources":["../src/lynstock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAsB,MAAM,aAAa,CAAC;AACxE,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,qBAAqB,GAEtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAczD,0EAA0E;AAC1E,8EAA8E;AAC9E,8EAA8E;AAC9E,yCAAyC;AACzC,MAAM,CAAC,MAAM,sBAAsB,GAAiB;IAClD,OAAO;IACP,cAAc;IACd,SAAS;IACT,YAAY;CACb,CAAC;AAEF,8EAA8E;AAC9E,gFAAgF;AAChF,MAAM,CAAC,MAAM,uBAAuB,GAAiB,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAepG,MAAM,OAAO,QAAQ;IACF,OAAO,CAA+B;IACtC,OAAO,CAAsC;IAC7C,QAAQ,CAAkB;IAC1B,UAAU,CAAmC;IAC7C,eAAe,CAAkB;IAElD,YAAY,UAA2B,EAAE;QACvC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAE7C,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,CAA0B;YAC9C,CAAC,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC,cAAc,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;YACrD,CAAC,SAAS,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAC3C,CAAC,YAAY,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;YACjD,CAAC,WAAW,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;YAC/C,CAAC,SAAS,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAC3C,CAAC,UAAU,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;YAC7C,CAAC,SAAS,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAC3C,CAAC,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;SAC1C,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,GAAG;YAChB,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,KAAK,IAAI,CAAC,GAAG,sBAAsB,CAAC;YAC/D,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,GAAG,uBAAuB,CAAC;SACnE,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,qBAAqB,EAAE,CAAC;IAChF,CAAC;IAED,4FAA4F;IAC5F,WAAW,CAAC,UAAsB,EAAE,KAAmB;QACrD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,WAAW,CAAC,UAAsB;QAChC,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,SAAS,CAAC,MAAkB,EAAE,MAAc;QAC1C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAChC,CAAC;IAED,aAAa,CAAC,MAAkB;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,YAAY,CAAC,MAAkB;QAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,UAAsB;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,KAAK,MAAM,UAAU,IAAI,KAAK,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClC,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACzD,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,OAAO,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;YACjE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,MAAM,IAAI,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,UAAsB,EAAE,KAAsB;QAChF,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,KAAK,MAAM,UAAU,IAAI,KAAK,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClC,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;gBAClF,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;gBACnF,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC7C,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,MAAM,IAAI,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/sources/alphaVantage.d.ts

@@ -0,0 +1,3 @@
+import type { FetchLike, QuoteSource } from "../types.js";
+export declare function createAlphaVantageSource(fetchImpl?: FetchLike): QuoteSource;
+//# sourceMappingURL=alphaVantage.d.ts.map

package/dist/sources/alphaVantage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alphaVantage.d.ts","sourceRoot":"","sources":["../../src/sources/alphaVantage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAU,MAAM,aAAa,CAAC;AAIlE,wBAAgB,wBAAwB,CAAC,SAAS,GAAE,SAAiB,GAAG,WAAW,CA6ElF"}