opencandle 0.5.0 → 0.7.0

package/dist/providers/web-search.js

@@ -1,11 +1,11 @@
-import { search, searchNews, SafeSearchType, SearchTimeType } from "duck-duck-scrape";
-import { httpGet, HttpError } from "../infra/http-client.js";
-import { cache, TTL, STALE_LIMIT } from "../infra/cache.js";
-import { rateLimiter } from "../infra/rate-limiter.js";
+import { SafeSearchType, SearchTimeType, search, searchNews } from "duck-duck-scrape";
 import { getConfig } from "../config.js";
-import { withFallback } from "./with-fallback.js";
+import { cache, STALE_LIMIT, TTL } from "../infra/cache.js";
+import { HttpError, httpGet } from "../infra/http-client.js";
+import { rateLimiter } from "../infra/rate-limiter.js";
 import { exaSearch } from "./exa-search.js";
 import { ProviderCredentialError } from "./provider-credential-error.js";
+import { withFallback } from "./with-fallback.js";
 const BARE_TICKER = /^[A-Z]{1,5}$/;
 const CASHTAG = /^\$[A-Z]{1,5}$/;
 /**
@@ -107,10 +107,14 @@ export async function ddgSearch(query, opts) {
 const BRAVE_BASE = "https://api.search.brave.com/res/v1";
 function mapBraveFreshness(freshness) {
     switch (freshness) {
-        case "hours": return "ph";
-        case "day": return "pd";
-        case "week": return "pw";
-        case "month": return "pm";
+        case "hours":
+            return "ph";
+        case "day":
+            return "pd";
+        case "week":
+            return "pw";
+        case "month":
+            return "pm";
     }
 }
 function mapBraveNewsResult(r) {
@@ -203,9 +207,16 @@ export async function searchWeb(query, opts) {
                 break;
             case "brave":
                 if (!config.braveApiKey) {
-                    return { status: "unavailable", reason: "BRAVE_API_KEY not configured", provider: "brave_search" };
+                    return {
+                        status: "unavailable",
+                        reason: "BRAVE_API_KEY not configured",
+                        provider: "brave_search",
+                    };
                 }
-                entries.push({ provider: "brave_search", fn: () => braveSearch(normalized, resolved, config.braveApiKey) });
+                entries.push({
+                    provider: "brave_search",
+                    fn: () => braveSearch(normalized, resolved, config.braveApiKey),
+                });
                 break;
             case "ddg":
                 entries.push({ provider: "ddg", fn: () => ddgSearch(normalized, resolved) });
@@ -216,7 +227,10 @@ export async function searchWeb(query, opts) {
     // Default cascade: Exa → Brave → DDG
     entries.push({ provider: "exa", fn: () => exaSearch(normalized, resolved) });
     if (config.braveApiKey) {
-        entries.push({ provider: "brave_search", fn: () => braveSearch(normalized, resolved, config.braveApiKey) });
+        entries.push({
+            provider: "brave_search",
+            fn: () => braveSearch(normalized, resolved, config.braveApiKey),
+        });
     }
     entries.push({ provider: "ddg", fn: () => ddgSearch(normalized, resolved) });
     return withFallback(entries);

package/dist/providers/web-search.js.map

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

package/dist/providers/with-fallback.js

@@ -1,5 +1,5 @@
-import { wrapProvider } from "./wrap-provider.js";
 import { getProviderTracker } from "../runtime/run-context.js";
+import { wrapProvider } from "./wrap-provider.js";
 /**
  * Try providers in order, stopping at the first success.
  * Skips circuit-open providers. Each provider call goes through wrapProvider
@@ -12,6 +12,7 @@ import { getProviderTracker } from "../runtime/run-context.js";
 export async function withFallback(entries) {
     const tracker = getProviderTracker();
     const attempted = [];
+    const failures = [];
     for (const entry of entries) {
         if (tracker?.isCircuitOpen(entry.provider))
             continue;
@@ -19,12 +20,13 @@ export async function withFallback(entries) {
         const result = await wrapProvider(entry.provider, entry.fn);
         if (result.status === "ok")
             return result;
+        failures.push(`${entry.provider}: ${result.reason}`);
         // wrapProvider already called recordFailure on the tracker
     }
     return {
         status: "unavailable",
         reason: attempted.length > 0
-            ? `all providers failed: ${attempted.join(", ")}`
+            ? `all providers failed: ${failures.join("; ")}`
             : `all providers circuit-open: ${entries.map((e) => e.provider).join(", ")}`,
         provider: entries[0]?.provider ?? "unknown",
     };

package/dist/providers/with-fallback.js.map

@@ -1 +1 @@
-{"version":3,"file":"with-fallback.js","sourceRoot":"","sources":["../../src/providers/with-fallback.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAO/D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA2B;IAE3B,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,SAAS;QACrD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE/B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAC1C,2DAA2D;IAC7D,CAAC;IAED,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;YAC1B,CAAC,CAAC,yBAAyB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACjD,CAAC,CAAC,+BAA+B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC9E,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,SAAS;KAC5C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"with-fallback.js","sourceRoot":"","sources":["../../src/providers/with-fallback.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,OAA2B;IAC/D,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,SAAS;QACrD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE/B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACrD,2DAA2D;IAC7D,CAAC;IAED,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,MAAM,EACJ,SAAS,CAAC,MAAM,GAAG,CAAC;YAClB,CAAC,CAAC,yBAAyB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAChD,CAAC,CAAC,+BAA+B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAChF,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,SAAS;KAC5C,CAAC;AACJ,CAAC"}

package/dist/providers/wrap-provider.d.ts

@@ -13,8 +13,7 @@ import type { ProviderResult } from "../runtime/evidence.js";
  * When a run context is active, checks circuit breaker state before
  * calling and records failures after.
  *
- * After a successful provider call, checks if the cache's stale flag
- * was set (meaning the provider fell back to stale cached data internally)
- * and propagates that metadata on the result.
+ * After a successful provider call, propagates stale cache metadata recorded
+ * in the current provider call's async scope.
  */
 export declare function wrapProvider<T>(providerId: string, fn: () => Promise<T>): Promise<ProviderResult<T>>;

package/dist/providers/wrap-provider.js

@@ -1,5 +1,7 @@
+import { runWithStaleMetadata } from "../infra/cache.js";
 import { getProviderTracker } from "../runtime/run-context.js";
-import { cache } from "../infra/cache.js";
+import { InvalidSymbolError } from "./errors.js";
+import { ExternalToolError, ExternalToolNotInstalled } from "./external-tool-error.js";
 import { ProviderCredentialError } from "./provider-credential-error.js";
 /**
  * Wrap a provider function call so that thrown exceptions are caught
@@ -15,9 +17,8 @@ import { ProviderCredentialError } from "./provider-credential-error.js";
  * When a run context is active, checks circuit breaker state before
  * calling and records failures after.
  *
- * After a successful provider call, checks if the cache's stale flag
- * was set (meaning the provider fell back to stale cached data internally)
- * and propagates that metadata on the result.
+ * After a successful provider call, propagates stale cache metadata recorded
+ * in the current provider call's async scope.
  */
 export async function wrapProvider(providerId, fn) {
     const tracker = getProviderTracker();
@@ -29,13 +30,12 @@ export async function wrapProvider(providerId, fn) {
         };
     }
     try {
-        const data = await fn();
-        const { stale, cachedAt } = cache.consumeStaleFlag();
+        const { value: data, stale } = await runWithStaleMetadata(fn);
         return {
             status: "ok",
             data,
-            timestamp: stale ? new Date(cachedAt).toISOString() : new Date().toISOString(),
-            stale: stale || undefined,
+            timestamp: stale ? new Date(stale.cachedAt).toISOString() : new Date().toISOString(),
+            stale: stale ? true : undefined,
         };
     }
     catch (error) {
@@ -46,6 +46,20 @@ export async function wrapProvider(providerId, fn) {
         if (error instanceof ProviderCredentialError) {
             throw error;
         }
+        if (isExternalToolSetupError(error)) {
+            return {
+                status: "unavailable",
+                reason: error.message,
+                provider: providerId,
+            };
+        }
+        if (error instanceof InvalidSymbolError) {
+            return {
+                status: "unavailable",
+                reason: error.message,
+                provider: providerId,
+            };
+        }
         tracker?.recordFailure(providerId);
         const reason = error instanceof Error ? error.message : "unknown_error";
         return {
@@ -55,4 +69,26 @@ export async function wrapProvider(providerId, fn) {
         };
     }
 }
+function isExternalToolSetupError(error) {
+    if (error instanceof ExternalToolNotInstalled)
+        return true;
+    if (!(error instanceof ExternalToolError))
+        return false;
+    const code = error.code?.toLowerCase() ?? "";
+    const message = error.message.toLowerCase();
+    return (code.includes("auth") ||
+        code.includes("session") ||
+        code.includes("unauthorized") ||
+        code.includes("expired") ||
+        message.includes("no twitter cookies") ||
+        message.includes("no twitter session") ||
+        message.includes("no reddit cookies") ||
+        message.includes("session missing") ||
+        message.includes("not authenticated") ||
+        message.includes("no cookies") ||
+        message.includes("rdt login") ||
+        message.includes("401") ||
+        message.includes("unauthorized") ||
+        message.includes("expired"));
+}
 //# sourceMappingURL=wrap-provider.js.map

package/dist/providers/wrap-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-provider.js","sourceRoot":"","sources":["../../src/providers/wrap-provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAkB,EAClB,EAAoB;IAEpB,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IAErC,IAAI,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,uBAAuB;YAC/B,QAAQ,EAAE,UAAU;SACrB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,EAAE,CAAC;QACxB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACrD,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,IAAI;YACJ,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC9E,KAAK,EAAE,KAAK,IAAI,SAAS;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0EAA0E;QAC1E,yEAAyE;QACzE,oEAAoE;QACpE,gCAAgC;QAChC,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;YAC7C,MAAM,KAAK,CAAC;QACd,CAAC;QACD,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,MAAM,GACV,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QAC3D,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,QAAQ,EAAE,UAAU;SACrB,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"wrap-provider.js","sourceRoot":"","sources":["../../src/providers/wrap-provider.ts"],"names":[],"mappings":"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"}

package/dist/providers/yahoo-finance.d.ts

@@ -1,4 +1,4 @@
-import type { StockQuote, OHLCV } from "../types/market.js";
+import type { OHLCV, StockQuote } from "../types/market.js";
 import type { OptionsChain } from "../types/options.js";
 import type { FundHoldings } from "../types/portfolio.js";
 export declare function getQuote(symbol: string): Promise<StockQuote>;

package/dist/providers/yahoo-finance.js

@@ -1,10 +1,19 @@
-import { httpGet } from "../infra/http-client.js";
-import { cache, TTL, STALE_LIMIT } from "../infra/cache.js";
+import YahooFinance from "yahoo-finance2";
+import { cache, STALE_LIMIT, TTL } from "../infra/cache.js";
+import { HttpError, httpGet } from "../infra/http-client.js";
 import { rateLimiter } from "../infra/rate-limiter.js";
-import { StealthBrowser } from "../infra/browser.js";
 import { computeGreeks } from "../tools/options/greeks.js";
+import { InvalidSymbolError } from "./errors.js";
 const BASE_URL = "https://query1.finance.yahoo.com/v8/finance/chart";
 const QUOTE_SUMMARY_URL = "https://query1.finance.yahoo.com/v10/finance/quoteSummary";
+const STALE_QUOTE_MAX_RETRY_AFTER_MS = 1_000;
+let yahooFinance2Client;
+function getYahooFinance2Client() {
+    yahooFinance2Client ??= new YahooFinance({
+        suppressNotices: ["yahooSurvey", "ripHistorical"],
+    });
+    return yahooFinance2Client;
+}
 export async function getQuote(symbol) {
     const cacheKey = `yahoo:quote:${symbol}`;
     const cached = cache.get(cacheKey);
@@ -15,6 +24,7 @@ export async function getQuote(symbol) {
         const url = `${BASE_URL}/${encodeURIComponent(symbol)}?interval=1d&range=1d`;
         const data = await httpGet(url, {
             headers: { "User-Agent": "OpenCandle/1.0" },
+            maxRetryAfterMs: STALE_QUOTE_MAX_RETRY_AFTER_MS,
         });
         if (data.chart.error) {
             throw new Error(`Yahoo Finance: ${data.chart.error.description}`);
@@ -43,7 +53,13 @@ export async function getQuote(symbol) {
             week52High: meta.fiftyTwoWeekHigh ?? 0,
             week52Low: meta.fiftyTwoWeekLow ?? 0,
             timestamp: Date.now(),
+            currency: typeof meta.currency === "string" && meta.currency.trim() !== ""
+                ? meta.currency.trim().toUpperCase()
+                : null,
         };
+        if (isZeroResultQuote(quote)) {
+            throw new InvalidSymbolError(symbol.toUpperCase(), "yahoo");
+        }
         cache.set(cacheKey, quote, TTL.QUOTE);
         return quote;
     }
@@ -54,6 +70,13 @@ export async function getQuote(symbol) {
         throw error;
     }
 }
+function isZeroResultQuote(quote) {
+    return (quote.price === 0 &&
+        quote.volume === 0 &&
+        quote.week52High === 0 &&
+        quote.week52Low === 0 &&
+        quote.marketCap === 0);
+}
 export async function getHistory(symbol, range = "6mo", interval = "1d") {
     const cacheKey = `yahoo:history:${symbol}:${range}:${interval}`;
     const cached = cache.get(cacheKey);
@@ -99,11 +122,7 @@ export async function getFundHoldings(symbol) {
         return cached;
     try {
         await rateLimiter.acquire("yahoo");
-        const modules = encodeURIComponent("price,topHoldings");
-        const url = `${QUOTE_SUMMARY_URL}/${encodeURIComponent(normalizedSymbol)}?modules=${modules}`;
-        const data = await httpGet(url, {
-            headers: { "User-Agent": "OpenCandle/1.0" },
-        });
+        const data = await getFundHoldingsSummary(normalizedSymbol);
         const result = data.quoteSummary.result?.[0];
         if (data.quoteSummary.error) {
             throw new Error(`Yahoo Finance: ${data.quoteSummary.error.description ?? data.quoteSummary.error.code ?? "quoteSummary error"}`);
@@ -120,11 +139,13 @@ export async function getFundHoldings(symbol) {
                 const weight = normalizeHoldingWeight(holding.holdingPercent);
                 if (!holdingSymbol || weight === undefined)
                     return [];
-                return [{
+                return [
+                    {
                         symbol: holdingSymbol,
                         name: holding.holdingName?.trim() || holdingSymbol,
                         weight,
-                    }];
+                    },
+                ];
             }),
             sectorWeights: normalizeSectorWeights(result.topHoldings.equityHoldings?.sectorWeightings),
         };
@@ -141,10 +162,51 @@ export async function getFundHoldings(symbol) {
         throw error;
     }
 }
+async function getFundHoldingsSummary(symbol) {
+    try {
+        return await fetchFundHoldingsSummary(symbol);
+    }
+    catch (error) {
+        if (!isYahooAuthError(error))
+            throw error;
+        return fetchFundHoldingsSummaryWithCrumb(symbol);
+    }
+}
+async function fetchFundHoldingsSummary(symbol) {
+    const modules = encodeURIComponent("price,topHoldings");
+    const url = `${QUOTE_SUMMARY_URL}/${encodeURIComponent(symbol)}?modules=${modules}`;
+    return httpGet(url, {
+        headers: { "User-Agent": "OpenCandle/1.0" },
+    });
+}
+async function fetchFundHoldingsSummaryWithCrumb(symbol) {
+    const modules = encodeURIComponent("price,topHoldings");
+    const { crumb, cookie } = await getYahooCrumb();
+    const url = `${QUOTE_SUMMARY_URL}/${encodeURIComponent(symbol)}?modules=${modules}&crumb=${encodeURIComponent(crumb)}`;
+    try {
+        return await httpGet(url, {
+            headers: { "User-Agent": BROWSER_UA, Cookie: cookie },
+        });
+    }
+    catch (error) {
+        if (!isYahooAuthError(error))
+            throw error;
+        clearCrumbCache();
+        const fresh = await getYahooCrumb();
+        const retryUrl = `${QUOTE_SUMMARY_URL}/${encodeURIComponent(symbol)}?modules=${modules}&crumb=${encodeURIComponent(fresh.crumb)}`;
+        return httpGet(retryUrl, {
+            headers: { "User-Agent": BROWSER_UA, Cookie: fresh.cookie },
+        });
+    }
+}
+function isYahooAuthError(error) {
+    return error instanceof HttpError && (error.status === 401 || error.status === 429);
+}
 function normalizeHoldingWeight(value) {
-    if (value === undefined || !Number.isFinite(value) || value <= 0)
+    const numeric = typeof value === "number" ? value : value?.raw;
+    if (numeric === undefined || !Number.isFinite(numeric) || numeric <= 0)
         return undefined;
-    return value > 1 ? roundWeight(value / 100) : roundWeight(value);
+    return numeric > 1 ? roundWeight(numeric / 100) : roundWeight(numeric);
 }
 function normalizeSectorWeights(sectors) {
     if (!sectors?.length)
@@ -164,6 +226,7 @@ function roundWeight(value) {
 }
 // --- Options Chain (v7 API with crumb+cookie auth) ---
 const BROWSER_UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";
+const YAHOO_RAW_FETCH_TIMEOUT_MS = 10_000;
 let cachedCrumb = null;
 export function clearCrumbCache() {
     cachedCrumb = null;
@@ -175,14 +238,25 @@ export async function getYahooCrumb() {
     // Step 1: Hit fc.yahoo.com to get a session cookie
     const cookieRes = await fetch("https://fc.yahoo.com/t", {
         headers: { "User-Agent": BROWSER_UA },
+        signal: yahooRawFetchSignal(),
     });
     const setCookie = cookieRes.headers.get("set-cookie") ?? "";
     const cookie = setCookie.split(";")[0]; // Extract just the cookie value
+    if (!cookie) {
+        if (!cookieRes.ok) {
+            throw new Error(`Yahoo crumb cookie request failed: HTTP ${cookieRes.status} ${cookieRes.statusText}`.trim());
+        }
+        throw new Error("Yahoo crumb cookie request did not return a session cookie");
+    }
     // Step 2: Use the cookie to get a crumb
     const crumbRes = await fetch("https://query2.finance.yahoo.com/v1/test/getcrumb", {
         headers: { "User-Agent": BROWSER_UA, Cookie: cookie },
+        signal: yahooRawFetchSignal(),
     });
-    const crumb = await crumbRes.text();
+    if (!crumbRes.ok) {
+        throw new Error(`Yahoo crumb request failed: HTTP ${crumbRes.status} ${crumbRes.statusText}`.trim());
+    }
+    const crumb = (await crumbRes.text()).trim();
     if (!crumb || crumb.includes("Unauthorized")) {
         throw new Error("Failed to acquire Yahoo Finance crumb");
     }
@@ -195,14 +269,15 @@ export async function getOptionsChain(symbol, expiration) {
     if (cached)
         return cached;
     await rateLimiter.acquire("yahoo");
-    const { crumb, cookie } = await getYahooCrumb();
     const dateParam = expiration ? `&date=${expiration}` : "";
-    const url = `https://query1.finance.yahoo.com/v7/finance/options/${encodeURIComponent(symbol)}?crumb=${encodeURIComponent(crumb)}${dateParam}`;
     let res = null;
     let fetchError;
     try {
+        const { crumb, cookie } = await getYahooCrumb();
+        const url = `https://query1.finance.yahoo.com/v7/finance/options/${encodeURIComponent(symbol)}?crumb=${encodeURIComponent(crumb)}${dateParam}`;
         res = await fetch(url, {
             headers: { "User-Agent": BROWSER_UA, Cookie: cookie },
+            signal: yahooRawFetchSignal(),
         });
     }
     catch (error) {
@@ -216,6 +291,7 @@ export async function getOptionsChain(symbol, expiration) {
             const retryUrl = `https://query1.finance.yahoo.com/v7/finance/options/${encodeURIComponent(symbol)}?crumb=${encodeURIComponent(fresh.crumb)}${dateParam}`;
             res = await fetch(retryUrl, {
                 headers: { "User-Agent": BROWSER_UA, Cookie: fresh.cookie },
+                signal: yahooRawFetchSignal(),
             });
         }
         catch (error) {
@@ -227,9 +303,9 @@ export async function getOptionsChain(symbol, expiration) {
     if (!res?.ok) {
         let browserError;
         try {
-            const browserData = await fetchOptionsViaBrowser(symbol, expiration);
-            if (browserData) {
-                const chain = parseOptionsResponse(browserData);
+            const fallbackData = await fetchOptionsViaYahooFinance2(symbol, expiration);
+            if (fallbackData) {
+                const chain = parseOptionsResponse(fallbackData);
                 cache.set(cacheKey, chain, TTL.OPTIONS_CHAIN);
                 return chain;
             }
@@ -244,21 +320,26 @@ export async function getOptionsChain(symbol, expiration) {
         if (res) {
             const message = `Yahoo Finance options: HTTP ${res.status}`;
             if (browserError instanceof Error) {
-                throw new Error(`${message}; browser fallback failed: ${browserError.message}`);
+                throw new Error(`${message}; yahoo-finance2 fallback failed: ${browserError.message}`);
             }
             throw new Error(message);
         }
         if (browserError instanceof Error) {
             const message = fetchError instanceof Error ? fetchError.message : "Yahoo Finance options: fetch failed";
-            throw new Error(`${message}; browser fallback failed: ${browserError.message}`);
+            throw new Error(`${message}; yahoo-finance2 fallback failed: ${browserError.message}`);
         }
-        throw fetchError instanceof Error ? fetchError : new Error("Yahoo Finance options: fetch failed");
+        throw fetchError instanceof Error
+            ? fetchError
+            : new Error("Yahoo Finance options: fetch failed");
     }
     const data = await res.json();
     const chain = parseOptionsResponse(data);
     cache.set(cacheKey, chain, TTL.OPTIONS_CHAIN);
     return chain;
 }
+function yahooRawFetchSignal() {
+    return AbortSignal.timeout(YAHOO_RAW_FETCH_TIMEOUT_MS);
+}
 /**
  * Compute time to expiry in years from a Yahoo expiration timestamp (midnight UTC).
  * US equity options expire at 4:00 PM ET. During EDT that is 20:00 UTC.
@@ -340,6 +421,9 @@ function parseOptionsResponse(data) {
     const quote = result.quote;
     const underlyingPrice = quote.regularMarketPrice ?? 0;
     const opts = result.options[0];
+    if (!opts && underlyingPrice === 0) {
+        throw new InvalidSymbolError(result.underlyingSymbol, "yahoo");
+    }
     const riskFreeRate = 0.05;
     const expirationTs = opts.expirationDate;
     const expirationDate = new Date(expirationTs * 1000).toISOString().split("T")[0];
@@ -347,7 +431,14 @@ function parseOptionsResponse(data) {
     const mapContract = (c, type) => {
         const strike = c.strike ?? c.strike?.raw ?? 0;
         const iv = c.impliedVolatility ?? c.impliedVolatility?.raw ?? 0;
-        const greeks = computeGreeks({ type, spot: underlyingPrice, strike, timeYears, iv, riskFreeRate });
+        const greeks = computeGreeks({
+            type,
+            spot: underlyingPrice,
+            strike,
+            timeYears,
+            iv,
+            riskFreeRate,
+        });
         return {
             contractSymbol: c.contractSymbol ?? "",
             type,
@@ -383,37 +474,51 @@ function parseOptionsResponse(data) {
     };
 }
 /**
- * Fallback: fetch options data via Camoufox stealth browser.
- * Bypasses Yahoo's TLS fingerprinting and rate limiting.
+ * Fallback: fetch options data via yahoo-finance2 when the raw Yahoo path is blocked.
  */
-async function fetchOptionsViaBrowser(symbol, expiration) {
+async function fetchOptionsViaYahooFinance2(symbol, expiration) {
     try {
-        // Avoid loading the script-heavy Yahoo Finance homepage: Playwright 1.60
-        // can crash on some pageerror payloads emitted by finance.yahoo.com.
-        // Navigating directly to Yahoo's JSON endpoints still uses the browser's
-        // cookies/TLS fingerprint without requiring cross-origin fetch from page JS.
-        const dateParam = expiration ? `&date=${expiration}` : "";
-        return await StealthBrowser.run(async (page) => {
-            await page.goto("https://query2.finance.yahoo.com/v1/test/getcrumb", {
-                waitUntil: "domcontentloaded",
-                timeout: 15000,
-            });
-            const crumb = (await page.locator("body").innerText()).trim();
-            if (!crumb)
-                return null;
-            const url = `https://query1.finance.yahoo.com/v7/finance/options/${encodeURIComponent(symbol)}?crumb=${encodeURIComponent(crumb)}${dateParam}`;
-            const response = await page.goto(url, {
-                waitUntil: "domcontentloaded",
-                timeout: 15000,
-            });
-            if (!response?.ok())
-                return null;
-            const text = (await page.locator("body").innerText()).trim();
-            return JSON.parse(text);
-        });
+        const result = await getYahooFinance2Client().options(symbol, expiration ? { date: new Date(expiration * 1000) } : undefined);
+        return normalizeYahooFinance2OptionsResponse(result);
     }
     catch (error) {
         throw error instanceof Error ? error : new Error(String(error));
     }
 }
+function normalizeYahooFinance2OptionsResponse(data) {
+    if ("optionChain" in data)
+        return data;
+    const options = data.options.map((option) => ({
+        expirationDate: toYahooUnixSeconds(option.expirationDate),
+        calls: option.calls,
+        puts: option.puts,
+    }));
+    const strikes = [
+        ...new Set(options
+            .flatMap((option) => [...option.calls, ...option.puts])
+            .map((contract) => Number(contract.strike))
+            .filter((strike) => Number.isFinite(strike))),
+    ].sort((a, b) => a - b);
+    return {
+        optionChain: {
+            result: [
+                {
+                    underlyingSymbol: data.underlyingSymbol,
+                    expirationDates: data.expirationDates.map(toYahooUnixSeconds),
+                    strikes,
+                    quote: data.quote,
+                    options,
+                },
+            ],
+        },
+    };
+}
+function toYahooUnixSeconds(value) {
+    if (value instanceof Date)
+        return Math.floor(value.getTime() / 1000);
+    if (typeof value === "number") {
+        return value > 1_000_000_000_000 ? Math.floor(value / 1000) : value;
+    }
+    return Math.floor(new Date(value).getTime() / 1000);
+}
 //# sourceMappingURL=yahoo-finance.js.map