@lyniaca/lynstock 0.1.0

package/dist/sources/stooq.js

@@ -0,0 +1,83 @@
+import { RateLimitError, SourceError } from "../errors.js";
+import { toDateString } from "../time.js";
+function toStooqSymbol(symbol) {
+    return symbol.includes(".") ? symbol.toLowerCase() : `${symbol.toLowerCase()}.us`;
+}
+export function createStooqSource(fetchImpl = fetch) {
+    return {
+        name: "stooq",
+        assetClasses: ["stock"],
+        requiresApiKey: false,
+        async getQuote(symbol) {
+            const stooqSymbol = toStooqSymbol(symbol);
+            const url = `https://stooq.com/q/l/?s=${encodeURIComponent(stooqSymbol)}&f=sd2t2ohlcv&h&e=csv`;
+            const response = await fetchImpl(url);
+            if (response.status === 429) {
+                throw new RateLimitError("stooq");
+            }
+            if (!response.ok) {
+                throw new SourceError("stooq", `HTTP ${response.status}`);
+            }
+            const csv = (await response.text()).trim();
+            const lines = csv.split("\n");
+            if (lines.length < 2) {
+                throw new SourceError("stooq", "Malformed CSV response");
+            }
+            const columns = lines[1].split(",");
+            const close = Number(columns[6]);
+            if (!Number.isFinite(close)) {
+                throw new SourceError("stooq", `No data for symbol "${symbol}"`);
+            }
+            return {
+                symbol: symbol.toUpperCase(),
+                assetClass: "stock",
+                price: close,
+                currency: "USD",
+                timestamp: Date.now(),
+                source: "stooq",
+            };
+        },
+        async getHistorical(symbol, query) {
+            const stooqSymbol = toStooqSymbol(symbol);
+            const d1 = toDateString(query.from).replace(/-/g, "");
+            const d2 = toDateString(query.to).replace(/-/g, "");
+            const url = `https://stooq.com/q/d/l/?s=${encodeURIComponent(stooqSymbol)}&d1=${d1}&d2=${d2}&i=d`;
+            const response = await fetchImpl(url);
+            if (response.status === 429) {
+                throw new RateLimitError("stooq");
+            }
+            if (!response.ok) {
+                throw new SourceError("stooq", `HTTP ${response.status}`);
+            }
+            const csv = (await response.text()).trim();
+            const lines = csv.split("\n");
+            // Stooq sometimes serves an HTML anti-bot challenge page with HTTP 200
+            // instead of real CSV; the real header is a fixed, known string, so anything
+            // else means the response isn't the data it looks like at a glance.
+            if (lines.length < 2 ||
+                !lines[0].toLowerCase().startsWith("date,open,high,low,close,volume") ||
+                lines[0].toLowerCase().includes("no data")) {
+                throw new SourceError("stooq", `No historical data for symbol "${symbol}"`);
+            }
+            const candles = lines
+                .slice(1)
+                .map((line) => {
+                const [date, open, high, low, close, volume] = line.split(",");
+                return {
+                    timestamp: Date.parse(`${date}T00:00:00Z`),
+                    open: Number(open),
+                    high: Number(high),
+                    low: Number(low),
+                    close: Number(close),
+                    volume: Number(volume),
+                };
+            })
+                .filter((candle) => Number.isFinite(candle.close) && Number.isFinite(candle.timestamp));
+            if (candles.length === 0) {
+                throw new SourceError("stooq", `No historical data for symbol "${symbol}"`);
+            }
+            return { symbol: symbol.toUpperCase(), assetClass: "stock", source: "stooq", candles };
+        },
+    };
+}
+//# sourceMappingURL=stooq.js.map

package/dist/sources/stooq.js.map

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

package/dist/sources/twelveData.d.ts

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

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

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

package/dist/sources/twelveData.js

@@ -0,0 +1,80 @@
+import { MissingApiKeyError, RateLimitError, SourceError } from "../errors.js";
+import { toDateString } from "../time.js";
+export function createTwelveDataSource(fetchImpl = fetch) {
+    return {
+        name: "twelvedata",
+        assetClasses: ["stock"],
+        requiresApiKey: true,
+        async getQuote(symbol, apiKey) {
+            if (!apiKey) {
+                throw new MissingApiKeyError("twelvedata");
+            }
+            const url = `https://api.twelvedata.com/price?symbol=${encodeURIComponent(symbol)}&apikey=${apiKey}`;
+            const response = await fetchImpl(url);
+            if (response.status === 429) {
+                throw new RateLimitError("twelvedata");
+            }
+            if (!response.ok) {
+                throw new SourceError("twelvedata", `HTTP ${response.status}`);
+            }
+            const data = await response.json();
+            if (data.status === "error") {
+                if (data.code === 429) {
+                    throw new RateLimitError("twelvedata", data.message);
+                }
+                throw new SourceError("twelvedata", data.message ?? "Unknown error");
+            }
+            const price = Number(data.price);
+            if (!Number.isFinite(price)) {
+                throw new SourceError("twelvedata", `No data for symbol "${symbol}"`);
+            }
+            return {
+                symbol: symbol.toUpperCase(),
+                assetClass: "stock",
+                price,
+                currency: "USD",
+                timestamp: Date.now(),
+                source: "twelvedata",
+            };
+        },
+        async getHistorical(symbol, query, apiKey) {
+            if (!apiKey) {
+                throw new MissingApiKeyError("twelvedata");
+            }
+            const startDate = toDateString(query.from);
+            const endDate = toDateString(query.to);
+            const url = `https://api.twelvedata.com/time_series?symbol=${encodeURIComponent(symbol)}&interval=1day&start_date=${startDate}&end_date=${endDate}&apikey=${apiKey}`;
+            const response = await fetchImpl(url);
+            if (response.status === 429) {
+                throw new RateLimitError("twelvedata");
+            }
+            if (!response.ok) {
+                throw new SourceError("twelvedata", `HTTP ${response.status}`);
+            }
+            const data = await response.json();
+            if (data.status === "error") {
+                if (data.code === 429) {
+                    throw new RateLimitError("twelvedata", data.message);
+                }
+                throw new SourceError("twelvedata", data.message ?? "Unknown error");
+            }
+            const values = data.values ?? [];
+            if (values.length === 0) {
+                throw new SourceError("twelvedata", `No historical data for symbol "${symbol}"`);
+            }
+            const candles = values
+                .map((value) => ({
+                timestamp: Date.parse(`${value.datetime}T00:00:00Z`),
+                open: Number(value.open),
+                high: Number(value.high),
+                low: Number(value.low),
+                close: Number(value.close),
+                volume: Number(value.volume),
+            }))
+                .filter((candle) => Number.isFinite(candle.close))
+                .sort((a, b) => a.timestamp - b.timestamp);
+            return { symbol: symbol.toUpperCase(), assetClass: "stock", source: "twelvedata", candles };
+        },
+    };
+}
+//# sourceMappingURL=twelveData.js.map

package/dist/sources/twelveData.js.map

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

package/dist/sources/yahoo.d.ts

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

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

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

package/dist/sources/yahoo.js

@@ -0,0 +1,65 @@
+import { RateLimitError, SourceError } from "../errors.js";
+import { toSeconds } from "../time.js";
+export function createYahooSource(fetchImpl = fetch) {
+    return {
+        name: "yahoo",
+        assetClasses: ["stock"],
+        requiresApiKey: false,
+        async getQuote(symbol) {
+            const url = `https://query1.finance.yahoo.com/v8/finance/chart/${encodeURIComponent(symbol)}`;
+            const response = await fetchImpl(url);
+            if (response.status === 429) {
+                throw new RateLimitError("yahoo");
+            }
+            if (!response.ok) {
+                throw new SourceError("yahoo", `HTTP ${response.status}`);
+            }
+            const data = await response.json();
+            const result = data?.chart?.result?.[0];
+            const price = result?.meta?.regularMarketPrice;
+            const currency = result?.meta?.currency;
+            if (typeof price !== "number") {
+                throw new SourceError("yahoo", `No data for symbol "${symbol}"`);
+            }
+            return {
+                symbol: symbol.toUpperCase(),
+                assetClass: "stock",
+                price,
+                currency: currency ?? "USD",
+                timestamp: Date.now(),
+                source: "yahoo",
+            };
+        },
+        async getHistorical(symbol, query) {
+            const period1 = toSeconds(query.from);
+            const period2 = toSeconds(query.to);
+            const url = `https://query1.finance.yahoo.com/v8/finance/chart/${encodeURIComponent(symbol)}?period1=${period1}&period2=${period2}&interval=1d`;
+            const response = await fetchImpl(url);
+            if (response.status === 429) {
+                throw new RateLimitError("yahoo");
+            }
+            if (!response.ok) {
+                throw new SourceError("yahoo", `HTTP ${response.status}`);
+            }
+            const data = await response.json();
+            const result = data?.chart?.result?.[0];
+            const timestamps = result?.timestamp ?? [];
+            const quote = result?.indicators?.quote?.[0];
+            if (!result || timestamps.length === 0 || !quote) {
+                throw new SourceError("yahoo", `No historical data for symbol "${symbol}"`);
+            }
+            const candles = timestamps
+                .map((timestampSeconds, i) => ({
+                timestamp: timestampSeconds * 1000,
+                open: quote.open?.[i],
+                high: quote.high?.[i],
+                low: quote.low?.[i],
+                close: quote.close?.[i],
+                volume: quote.volume?.[i],
+            }))
+                .filter((candle) => Number.isFinite(candle.close));
+            return { symbol: symbol.toUpperCase(), assetClass: "stock", source: "yahoo", candles };
+        },
+    };
+}
+//# sourceMappingURL=yahoo.js.map

package/dist/sources/yahoo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yahoo.js","sourceRoot":"","sources":["../../src/sources/yahoo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,UAAU,iBAAiB,CAAC,YAAuB,KAAK;IAC5D,OAAO;QACL,IAAI,EAAE,OAAO;QACb,YAAY,EAAE,CAAC,OAAO,CAAC;QACvB,cAAc,EAAE,KAAK;QACrB,KAAK,CAAC,QAAQ,CAAC,MAAM;YACnB,MAAM,GAAG,GAAG,qDAAqD,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9F,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC;YAC/C,MAAM,QAAQ,GAAG,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC;YACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,uBAAuB,MAAM,GAAG,CAAC,CAAC;YACnE,CAAC;YACD,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;gBAC5B,UAAU,EAAE,OAAO;gBACnB,KAAK;gBACL,QAAQ,EAAE,QAAQ,IAAI,KAAK;gBAC3B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,MAAM,EAAE,OAAO;aAChB,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK;YAC/B,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,qDAAqD,kBAAkB,CACjF,MAAM,CACP,YAAY,OAAO,YAAY,OAAO,cAAc,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,UAAU,GAAa,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACjD,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,kCAAkC,MAAM,GAAG,CAAC,CAAC;YAC9E,CAAC;YACD,MAAM,OAAO,GAAa,UAAU;iBACjC,GAAG,CACF,CAAC,gBAAgB,EAAE,CAAC,EAAU,EAAE,CAAC,CAAC;gBAChC,SAAS,EAAE,gBAAgB,GAAG,IAAI;gBAClC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACrB,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACrB,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACnB,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACvB,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;aAC1B,CAAC,CACH;iBACA,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QACzF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/time.d.ts

@@ -0,0 +1,4 @@
+export declare function toMs(value: Date | number): number;
+export declare function toSeconds(value: Date | number): number;
+export declare function toDateString(value: Date | number): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAEzD"}

package/dist/time.js

@@ -0,0 +1,10 @@
+export function toMs(value) {
+    return value instanceof Date ? value.getTime() : value;
+}
+export function toSeconds(value) {
+    return Math.floor(toMs(value) / 1000);
+}
+export function toDateString(value) {
+    return new Date(toMs(value)).toISOString().slice(0, 10);
+}
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,IAAI,CAAC,KAAoB;IACvC,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAoB;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAoB;IAC/C,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,47 @@
+export type AssetClass = "stock" | "crypto";
+export interface Quote {
+    symbol: string;
+    assetClass: AssetClass;
+    price: number;
+    currency: string;
+    timestamp: number;
+    source: string;
+}
+export interface FetchResponse {
+    readonly ok: boolean;
+    readonly status: number;
+    json(): Promise<any>;
+    text(): Promise<string>;
+}
+export type FetchLike = (url: string, init?: RequestInit) => Promise<FetchResponse>;
+export interface Candle {
+    /** Start of the period, ms since epoch. */
+    timestamp: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    /** Not every free-tier source exposes volume (e.g. CoinGecko's OHLC endpoint). */
+    volume?: number;
+}
+export interface HistoricalQuery {
+    /** Inclusive start of the range. */
+    from: Date | number;
+    /** Inclusive end of the range. */
+    to: Date | number;
+}
+export interface HistoricalResult {
+    symbol: string;
+    assetClass: AssetClass;
+    source: string;
+    candles: Candle[];
+}
+export interface QuoteSource {
+    name: string;
+    assetClasses: AssetClass[];
+    requiresApiKey: boolean;
+    getQuote(symbol: string, apiKey?: string): Promise<Quote>;
+    /** Not every source implements this — daily OHLCV history only, for now. */
+    getHistorical?(symbol: string, query: HistoricalQuery, apiKey?: string): Promise<HistoricalResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5C,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAEpF,MAAM,WAAW,MAAM;IACrB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IACpB,kCAAkC;IAClC,EAAE,EAAE,IAAI,GAAG,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1D,4EAA4E;IAC5E,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACpG"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@lyniaca/lynstock",
+  "version": "0.1.0",
+  "description": "Normalized, multi-source market data aggregator for stocks and crypto with automatic fallback across upstream providers.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "live-check": "npm run build && node scripts/live-check.mjs"
+  },
+  "keywords": [
+    "stocks",
+    "crypto",
+    "market-data",
+    "finance",
+    "quotes",
+    "historical",
+    "ohlcv"
+  ],
+  "author": "Lyniaca",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.16.11",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4"
+  }
+}