gloomberb 0.15.2 → 0.15.4

package/src/sources/gloomberb-cloud/normalizers.ts

@@ -1,8 +1,9 @@
+import { futuresGenericListing, futuresGenericPriceBasis } from "../../utils/futures-generic";
 import type { TimeRange } from "../../time-series/range";
-import { subtractTimeRange } from "../../time-series/date-window";
-import { verifiedPriceHistorySource } from "../history-coverage";
 import type {
+  FinancialStatement,
   Fundamentals,
+  NextEarnings,
   OptionsChain,
   PricePoint,
   Quote,
@@ -18,12 +19,11 @@ import {
 } from "../../api-client";
 import { normalizePriceValueByDivisor, resolveCurrencyUnit } from "../../utils/currency-units";
 import { resolveExchangeTimeZone } from "../../utils/exchanges";
+import { zonedDateTimeParts, zonedWallClockToUtcMs } from "../../utils/zoned-date-time";
 import { createProviderMiss } from "../provider-errors";
 import { reconcileQuoteDayRange } from "../../market-data/quotes/day-range";
 import { redactUnavailableFundamentals } from "../../utils/fundamentals";
-import { retractKnownCloudValuation } from "./valuation-observations";
-import { withdrawKnownProviderStatements } from "../../utils/statement-observations";
-import { hasShopOperatingIdentity, normalizeFinancialOperatingResults } from "../../utils/operating-result";
+import { readWithdrawnObservations } from "../../utils/statement-gaps";
 
 export const GLOOMBERB_CLOUD_PROVIDER_ID = "gloomberb-cloud" as const;
 
@@ -53,8 +53,12 @@ export function mapQuote(
   const changePercent = typeof quote.changePercent === "number" && Number.isFinite(quote.changePercent)
     ? quote.changePercent
     : Number.NaN;
+  // A generic future (VX1, TY1) reads in points or 32nds, not dollars.
+  const generic = futuresGenericListing(quote.symbol, quote.listingExchangeName ?? quote.exchangeName);
+  const priceBasis = generic ? futuresGenericPriceBasis(generic) : null;
   return withoutUndefinedFields(reconcileQuoteDayRange({
     ...quote,
+    ...priceBasis ? { priceBasis } : {},
     currency: currency || quote.currency,
     price: normalizePriceValueByDivisor(quote.price, divisor) ?? quote.price,
     change,
@@ -137,54 +141,6 @@ const LOCAL_DATE_TIME_PATTERN =
   /^(\d{4})-(\d{2})-(\d{2})(?:[ T](\d{2}):(\d{2})(?::(\d{2})(?:\.\d{1,3})?)?)?$/;
 const EXPLICIT_TIME_ZONE_PATTERN = /(?:Z|[+-]\d{2}:?\d{2})$/i;
 
-function getZonedDateParts(date: Date, timeZone: string): Map<string, string> {
-  const formatter = new Intl.DateTimeFormat("en-US", {
-    timeZone,
-    hourCycle: "h23",
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    second: "2-digit",
-  });
-  const parts = new Map<string, string>();
-  for (const part of formatter.formatToParts(date)) {
-    if (part.type !== "literal") parts.set(part.type, part.value);
-  }
-  return parts;
-}
-
-function getTimeZoneOffsetMs(utcMs: number, timeZone: string): number {
-  const parts = getZonedDateParts(new Date(utcMs), timeZone);
-  const zonedAsUtcMs = Date.UTC(
-    Number(parts.get("year")),
-    Number(parts.get("month")) - 1,
-    Number(parts.get("day")),
-    Number(parts.get("hour")),
-    Number(parts.get("minute")),
-    Number(parts.get("second")),
-  );
-  return zonedAsUtcMs - utcMs;
-}
-
-function exchangeLocalDateTimeToUtc(
-  match: RegExpMatchArray,
-  timeZone: string,
-): Date {
-  const year = Number(match[1]);
-  const month = Number(match[2]);
-  const day = Number(match[3]);
-  const hour = Number(match[4] ?? "0");
-  const minute = Number(match[5] ?? "0");
-  const second = Number(match[6] ?? "0");
-  const localAsUtcMs = Date.UTC(year, month - 1, day, hour, minute, second);
-  const firstOffset = getTimeZoneOffsetMs(localAsUtcMs, timeZone);
-  const firstUtcMs = localAsUtcMs - firstOffset;
-  const verifiedOffset = getTimeZoneOffsetMs(firstUtcMs, timeZone);
-  return new Date(localAsUtcMs - verifiedOffset);
-}
-
 function parseCloudPricePointDate(
   value: Date | string | number,
   exchange: string,
@@ -201,7 +157,17 @@ function parseCloudPricePointDate(
   }
 
   const timeZone = resolveExchangeTimeZone(exchange);
-  return timeZone ? exchangeLocalDateTimeToUtc(match, timeZone) : new Date(value);
+  return timeZone
+    ? new Date(zonedWallClockToUtcMs(
+      timeZone,
+      Number(match[1]),
+      Number(match[2]),
+      Number(match[3]),
+      Number(match[4]),
+      Number(match[5]),
+      Number(match[6] ?? "0"),
+    ))
+    : new Date(value);
 }
 
 export function mapPricePoint(
@@ -211,7 +177,6 @@ export function mapPricePoint(
 ): PricePoint {
   return {
     date: parseCloudPricePointDate(point.date, exchange),
-    ...(verifiedPriceHistorySource(point.historySource) ? { historySource: verifiedPriceHistorySource(point.historySource) } : {}),
     open: normalizePriceValueByDivisor(point.open, divisor),
     high: normalizePriceValueByDivisor(point.high, divisor),
     low: normalizePriceValueByDivisor(point.low, divisor),
@@ -242,37 +207,54 @@ export function mapCloudFundamentals(fundamentals: Fundamentals | undefined): Fu
   return result;
 }
 
+const EARNINGS_TIMINGS: ReadonlySet<unknown> = new Set(["bmo", "dmh", "amc"]);
+const EARNINGS_TIMING_SOURCES: ReadonlySet<unknown> = new Set(["filing", "calendar", "history"]);
+
+/** The served next report; one without a calendar date is left out. */
+function mapCloudNextEarnings(value: NextEarnings | undefined): NextEarnings | undefined {
+  if (!value || typeof value.date !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(value.date)) return undefined;
+  return {
+    date: value.date,
+    timing: EARNINGS_TIMINGS.has(value.timing) ? value.timing : null,
+    timingSource: EARNINGS_TIMING_SOURCES.has(value.timingSource) ? value.timingSource : null,
+  };
+}
+
+/**
+ * A served statement row with withdrawn values read as declared gaps, without
+ * the per-issuer provenance the service can still attach.
+ */
+function mapCloudStatement(row: FinancialStatement): FinancialStatement {
+  const { earningsResult: _earnings, operatingResult: _operating, operatingResultAggregation: _aggregation, ...statement } = row;
+  return readWithdrawnObservations(statement);
+}
+
 export function mapCloudFinancials(
   financials: CloudFinancialsPayload,
   providerMeta?: CloudProviderMeta,
-  target?: { symbol: string; exchange?: string },
 ): TickerFinancials {
   const rawQuote = financials.quote;
   const quote = rawQuote ? mapQuote(rawQuote, providerMeta) : undefined;
   const divisor = rawQuote ? resolveCurrencyUnit(rawQuote.currency).divisor : 1;
   const exchange = rawQuote?.listingExchangeName ?? rawQuote?.exchangeName ?? "";
-  return normalizeFinancialOperatingResults(withdrawKnownProviderStatements(retractKnownCloudValuation({
+  return {
     quote,
     quoteMetadata: financials.quoteMetadata,
     quoteContributions: financials.quoteContributions,
     profile: financials.profile,
+    ...(financials.nextEarnings ? { nextEarnings: mapCloudNextEarnings(financials.nextEarnings) } : {}),
     fundamentals: mapCloudFundamentals(financials.fundamentals),
     financialCurrency: financials.financialCurrency,
     statementHistory: financials.statementHistory,
-    operatingHistoryRetryAt: typeof financials.operatingHistoryRetryAt === "number" && Number.isFinite(financials.operatingHistoryRetryAt)
-      && financials.operatingHistoryRetryAt > 0 && hasShopOperatingIdentity({
-        quote, quoteMetadata: financials.quoteMetadata, financialCurrency: financials.financialCurrency,
-      }, target) ? financials.operatingHistoryRetryAt : undefined,
-    earningsHistoryRetryAt: financials.earningsHistoryRetryAt,
-    annualStatements: financials.annualStatements ?? [],
-    quarterlyStatements: financials.quarterlyStatements ?? [],
+    annualStatements: (financials.annualStatements ?? []).map(mapCloudStatement),
+    quarterlyStatements: (financials.quarterlyStatements ?? []).map(mapCloudStatement),
     priceHistory: (financials.priceHistory ?? []).map((point) =>
       point.date instanceof Date
         ? point
         : mapPricePoint(point as unknown as CloudPricePointPayload, divisor, exchange),
     ),
     ...(financials.epsEstimates ? { epsEstimates: financials.epsEstimates } : {}),
-  }, target), target ?? { symbol: quote?.symbol ?? financials.quoteMetadata?.symbol ?? "", exchange }, "provider:gloomberb-cloud"), target);
+  };
 }
 
 export function mapOptionsChain(
@@ -343,10 +325,8 @@ export function formatCloudDateTime(
   if (includeTime) {
     const timeZone = resolveExchangeTimeZone(exchange);
     if (timeZone) {
-      const parts = getZonedDateParts(date, timeZone);
-      return `${parts.get("year")}-${parts.get("month")}-${parts.get(
-        "day",
-      )} ${parts.get("hour")}:${parts.get("minute")}:${parts.get("second")}`;
+      const { year, month, day, hour, minute, second } = zonedDateTimeParts(date.getTime(), timeZone);
+      return `${year}-${padTimePart(month)}-${padTimePart(day)} ${padTimePart(hour)}:${padTimePart(minute)}:${padTimePart(second)}`;
     }
     // Without a venue timezone, an explicit offset keeps host and server clocks
     // from interpreting the same intraday boundary as different instants.
@@ -359,13 +339,6 @@ export function formatCloudDateTime(
   return `${year}-${month}-${day}`;
 }
 
-export function getRangeStartDate(
-  range: TimeRange,
-  endDate = new Date(),
-): Date {
-  return subtractTimeRange(endDate, range);
-}
-
 export function toHistoryRequest(range: TimeRange): {
   interval: string;
   outputsize: number;

package/src/sources/history-coverage.ts

@@ -1,97 +1,38 @@
-import type { PriceHistorySource, PricePoint, TickerFinancials } from "../types/financials";
-import { canonicalExchange, parsePublicTickerKey } from "../utils/exchanges";
-import { getPricePointTimestamp } from "../utils/price-history";
 import { ProviderMissError } from "./provider-errors";
 
-export const SHELL_VERIFIED_LINEAGE_START = "2005-07-21";
-const coverageMessage = (providers: PriceHistorySource["provider"][]) => `${providers.map((provider) => provider === "yahoo" ? "Yahoo" : "Twelve Data").join(" and ")} London Shell coverage begins 2005-07-21; earlier share lineage is unverified.`;
+const COVERAGE_DATE = /^\d{4}-\d{2}-\d{2}$/;
 
-export class HistoryCoverageError extends ProviderMissError {
-  constructor(reason: PriceHistorySource["provider"] | { message: string } = "yahoo") {
-    super(typeof reason === "string" ? coverageMessage([reason]) : reason.message);
-    this.name = "HistoryCoverageError";
-  }
+/** A calendar date (YYYY-MM-DD) that can bound a price history. */
+export function isHistoryCoverageDate(value: unknown): value is string {
+  return typeof value === "string" && COVERAGE_DATE.test(value) && Number.isFinite(Date.parse(value));
 }
 
-export function hasShellCoverageRestriction(value: unknown): value is { source: PriceHistorySource["provider"]; reasonCode: "UNVERIFIED_PREDECESSOR_LINEAGE"; verifiedLineageStart: "2005-07-21" } {
-  const coverage = value as { source?: unknown; reasonCode?: unknown; verifiedLineageStart?: unknown } | null;
-  return (coverage?.source === "yahoo" || coverage?.source === "twelvedata") && coverage.reasonCode === "UNVERIFIED_PREDECESSOR_LINEAGE"
-    && coverage.verifiedLineageStart === SHELL_VERIFIED_LINEAGE_START;
+/**
+ * The first date a source vouches for, whatever its reason (an unverified
+ * predecessor lineage, a fund's inception). No symbol is checked: any declared
+ * boundary applies to the history it came with. The later boundary wins.
+ */
+export function parseHistoryCoverageStart(coverage: unknown): string | undefined {
+  if (!coverage || typeof coverage !== "object") return undefined;
+  const { verifiedLineageStart, firstAllowedBarDate } = coverage as Record<string, unknown>;
+  const dates = [verifiedLineageStart, firstAllowedBarDate].filter(isHistoryCoverageDate);
+  return dates.length ? dates.reduce((latest, date) => date > latest ? date : latest) : undefined;
 }
 
-export function isShellLondonTarget(symbol: string, exchange?: string): boolean {
-  const parsed = parsePublicTickerKey(symbol);
-  const venue = canonicalExchange(parsed.exchange || exchange);
-  return (parsed.symbol === "SHEL" && venue === "LSE")
-    || (parsed.symbol === "SHEL.L" && (!venue || venue === "LSE"));
+function historyCoverageMessage(coverageStart: string): string {
+  return `Verified price history starts ${coverageStart}; earlier prices are excluded.`;
 }
 
-export function verifiedPriceHistorySource(value: unknown): PriceHistorySource | undefined {
-  const source = value as Partial<PriceHistorySource> | null;
-  if (!source || source.symbol !== "SHEL" || source.exchange !== "LSE" || source.currency !== "GBP"
-    || !["yahoo", "twelvedata"].includes(source.provider ?? "")
-    || source.verifiedLineageStart !== SHELL_VERIFIED_LINEAGE_START) return undefined;
-  return { provider: source.provider!, symbol: "SHEL", exchange: "LSE", currency: "GBP",
-    ...(source.verifiedLineageStart ? { verifiedLineageStart: source.verifiedLineageStart } : {}) };
+/** Shown while the visible window starts before the source's coverage. */
+export function historyCoverageNotice(coverageStart: string | undefined, visibleStart: number | null): string | null {
+  if (!coverageStart || (visibleStart !== null && visibleStart >= Date.parse(coverageStart))) return null;
+  return historyCoverageMessage(coverageStart);
 }
 
-/** Old cloud arrays lack upstream provenance. Retire only affected London
- * source records; ordinary modern histories and independent providers survive.
- * Both exact Yahoo and Twelve London histories share the unreconciled basis. */
-export function hasUnverifiedShellHistory(
-  points: readonly PricePoint[], target: { symbol: string; exchange?: string }, sourceKey: string,
-  requestedStart?: number,
-): boolean {
-  if (!isShellLondonTarget(target.symbol, target.exchange)
-    || !["provider:yahoo", "provider:gloomberb-cloud"].includes(sourceKey)) return false;
-  const cutoff = Date.parse(SHELL_VERIFIED_LINEAGE_START);
-  return points.some((point) => getPricePointTimestamp(point) < cutoff)
-    // Older clients dropped even corrected source provenance. Refetch those
-    // cached long windows to recover the explanation, without invalidating 1Y.
-    || (requestedStart !== undefined && requestedStart < cutoff && points.length > 0
-      && !points.some((point) => verifiedPriceHistorySource(point.historySource)));
-}
-
-export function historyCoverageNotice(points: readonly PricePoint[], requestedStart: number | null): string | null {
-  if (requestedStart !== null && requestedStart >= Date.parse(SHELL_VERIFIED_LINEAGE_START)) return null;
-  const providers = [...new Set(points.flatMap((point) => {
-    const source = verifiedPriceHistorySource(point.historySource);
-    return source ? [source.provider] : [];
-  }))];
-  return providers.length ? coverageMessage(providers) : null;
-}
-
-export function sanitizeShellFinancialHistory(
-  value: TickerFinancials, target: { symbol: string; exchange?: string }, sourceKey: string,
-): TickerFinancials {
-  return hasUnverifiedShellHistory(value.priceHistory, target, sourceKey)
-    ? { ...value, priceHistory: [] } : value;
-}
-
-/** The issuer's London A-share dataset starts here. Yahoo's preceding current-
- * ticker history contains an unreconciled 1997 discontinuity. Corroborated
- * post-unification samples establish A-share lineage, not every daily price.
- * Do not reconstruct predecessor prices using an assumed split or FX ratio. */
-export function applyYahooHistoryCoverage(
-  symbol: string,
-  metadata: { symbol?: unknown; exchangeName?: unknown; currency?: unknown },
-  interval: string,
-  points: PricePoint[],
-): PricePoint[] {
-  if (symbol.toUpperCase() !== "SHEL.L" || /^\d+(m|h)$/i.test(interval)) return points;
-  if (metadata.symbol !== "SHEL.L" || typeof metadata.exchangeName !== "string"
-    || canonicalExchange(metadata.exchangeName) !== "LSE" || !["GBp", "GBP"].includes(String(metadata.currency))) {
-    throw new Error("Shell London history source identity could not be verified");
+/** The whole requested window lies before the source's declared coverage. */
+export class HistoryCoverageError extends ProviderMissError {
+  constructor(readonly coverageStart: string) {
+    super(historyCoverageMessage(coverageStart));
+    this.name = "HistoryCoverageError";
   }
-  const historySource: PriceHistorySource = {
-    provider: "yahoo", symbol: "SHEL", exchange: "LSE", currency: "GBP",
-    verifiedLineageStart: SHELL_VERIFIED_LINEAGE_START,
-  };
-  // Yahoo timestamps identify the start of a bar. Drop a whole spanning weekly
-  // or monthly bar; retaining its close would leave unreconciled OHLC values.
-  const cutoff = Date.parse(SHELL_VERIFIED_LINEAGE_START);
-  const retained = points.filter((point) => point.date.getTime() >= cutoff)
-    .map((point) => ({ ...point, historySource }));
-  if (points.length > 0 && retained.length === 0) throw new HistoryCoverageError();
-  return retained;
 }

package/src/sources/history-result.ts

@@ -4,6 +4,7 @@ import type { DataProvider, MarketDataRequestContext } from "../types/data-provi
 import type { PriceHistoryResult } from "../types/price-history";
 import { parseHistorySession } from "../market-data/history-session";
 import { canonicalHistoryInterval } from "./history-retention";
+import { isHistoryCoverageDate } from "./history-coverage";
 
 export type HistoryResultRequest =
   | { kind: "range"; range: TimeRange }
@@ -38,6 +39,7 @@ export function normalizeHistoryResult(
   return { points: result.points, resolution: result.resolution,
     ...(session ? { session } : {}),
     ...(typeof result.sourceKey === "string" && /^(provider|broker):[^\r\n\0]+$/.test(result.sourceKey) ? { sourceKey: result.sourceKey } : {}),
+    ...(isHistoryCoverageDate(result.coverageStart) ? { coverageStart: result.coverageStart } : {}),
   };
 }
 

package/src/sources/history-retention.ts

@@ -1,4 +1,6 @@
 import { canonicalExchange, parsePublicTickerKey } from "../utils/exchanges";
+import { isRecord } from "../utils/guards";
+import { parseBarInterval } from "../time-series/resolution";
 
 export const HISTORY_RETENTION_MAX_AGE_MS = 5 * 60_000;
 // The record carries the server's clock; the server revalidates it on retry.
@@ -44,21 +46,17 @@ export interface HistorySourceOutcome {
 
 const outcomes = new Set<HistorySourceOutcomeKind>(["success", "retention", "auth", "rate-limit", "transient", "failure", "empty",
   "missing-method", "stale", "malformed", "reported-gaps", "timeout", "coverage"]);
-const object = (value: unknown): value is Record<string, unknown> => !!value && typeof value === "object" && !Array.isArray(value);
 const text = (value: unknown, max = 256): value is string => typeof value === "string" && value.length > 0 && value.length <= max && !/[\r\n\0]/.test(value);
 const instant = (value: unknown): value is number => Number.isSafeInteger(value) && Number(value) > 0 && Number(value) <= 8_640_000_000_000_000;
 const yahooRetentionIntervals = new Set(["1min", "5min", "15min", "30min", "1h"]);
 
 export function canonicalHistoryInterval(value: unknown): string | null {
-  if (typeof value !== "string") return null;
-  const match = /^(\d+)\s*(m|min|mins|minute|minutes|h|hr|hour|hours|d|day|days|w|wk|week|weeks|mo|month|months)$/i.exec(value.trim());
-  if (!match || !Number.isSafeInteger(Number(match[1])) || Number(match[1]) <= 0) return null;
-  const unit = match[2]!.toLowerCase();
-  return `${Number(match[1])}${/^(mo|month)/.test(unit) ? "month" : /^(w|wk|week)/.test(unit) ? "week" : /^(d|day)/.test(unit) ? "day" : /^(h|hr|hour)/.test(unit) ? "h" : "min"}`;
+  const interval = parseBarInterval(value);
+  return interval ? `${interval.count}${interval.unit}` : null;
 }
 
 export function parseHistoryRetention(value: unknown, now = Date.now()): HistoryRetention | null {
-  if (!object(value) || value.version !== 1 || value.source !== "yahoo"
+  if (!isRecord(value) || value.version !== 1 || value.source !== "yahoo"
     || !text(value.symbol) || typeof value.exchange !== "string" || value.exchange.length > 256
     || !instant(value.requestedStart) || !instant(value.requestedEnd)
     || !instant(value.observedAt) || !instant(value.availableStart)) return null;
@@ -78,8 +76,8 @@ export function parseHistoryRetention(value: unknown, now = Date.now()): History
 }
 
 export function parseHistoryRecoveryCandidate(value: unknown, now = Date.now()): HistoryRecoveryCandidate | null {
-  if (!object(value) || !text(value.sourceKey) || !value.sourceKey.startsWith("provider:")
-    || value.sourceKey.length <= "provider:".length || !object(value.request)) return null;
+  if (!isRecord(value) || !text(value.sourceKey) || !value.sourceKey.startsWith("provider:")
+    || value.sourceKey.length <= "provider:".length || !isRecord(value.request)) return null;
   const retention = parseHistoryRetention(value.retention, now), request = value.request;
   if (!retention || retention.availableStart >= retention.requestedEnd || !text(request.entityKey, 8192)
     || request.symbol !== retention.symbol || request.exchange !== retention.exchange
@@ -95,7 +93,7 @@ export function parseHistoryRecoveryCandidate(value: unknown, now = Date.now()):
 }
 
 function parseOutcome(value: unknown): HistorySourceOutcome | null {
-  if (!object(value) || !text(value.sourceKey) || !/^(provider|broker):.+/.test(value.sourceKey)
+  if (!isRecord(value) || !text(value.sourceKey) || !/^(provider|broker):.+/.test(value.sourceKey)
     || !outcomes.has(value.outcome as HistorySourceOutcomeKind)
     || (value.status !== undefined && (!Number.isInteger(value.status) || Number(value.status) < 100 || Number(value.status) > 599))) return null;
   return Object.freeze({ sourceKey: value.sourceKey, outcome: value.outcome as HistorySourceOutcomeKind,
@@ -140,7 +138,7 @@ export function isHistoryRetentionError(value: unknown): value is HistoryRetenti
 
 /** Validate again after crossing the desktop JSON boundary. */
 export function parseHistoryRetentionError(value: unknown): HistoryRetentionError | null {
-  if (!object(value) || !Array.isArray(value.candidates) || value.candidates.length > 100
+  if (!isRecord(value) || !Array.isArray(value.candidates) || value.candidates.length > 100
     || !Array.isArray(value.outcomes) || value.outcomes.length > 200) return null;
   const retention = parseHistoryRetention(value.retention);
   if (!retention) return null;

package/src/sources/provider-router/batches.ts

@@ -1,5 +1,3 @@
-import { sanitizeListingFinancialHistory } from "../listing-history";
-import { withdrawKnownProviderStatements } from "../../utils/statement-observations";
 import type {
   CachedFinancialsTarget,
   MarketDataRequestContext,
@@ -167,8 +165,6 @@ export class ProviderRouterBatchRoutes {
         if (value) value = dropUnusableProviderQuote(value, item.target.exchange);
         if (!value) continue;
         const sourceKey = this.deps.providerSourceKey(batchProvider);
-        value = sanitizeListingFinancialHistory(value, item.target, sourceKey);
-        value = withdrawKnownProviderStatements(value, item.target, sourceKey);
         for (const entry of providerIndexes.get(key) ?? []) {
           const entityKey = this.deps.getEntityKey(entry.target.symbol, entry.target.instrument ?? undefined);
           const variantKey = this.deps.getTickerVariantCandidates(entry.target.exchange)[0] ?? "";

package/src/sources/provider-router/brokers.ts

@@ -2,6 +2,7 @@ import type { PluginRegistry } from "../../plugins/registry";
 import type { BrokerAdapter } from "../../types/broker";
 import type { AppConfig } from "../../types/config";
 import type { CachedFinancialsTarget, MarketDataRequestContext } from "../../types/data-provider";
+import { settleWithin } from "../../utils/async-deadline";
 
 const BROKER_ATTEMPT_TIMEOUT = 10_000;
 
@@ -14,19 +15,7 @@ export interface BrokerCandidate {
 }
 
 export function withBrokerTimeout<T>(promise: Promise<T>): Promise<T | null> {
-  return new Promise<T | null>((resolve) => {
-    const timer = setTimeout(() => resolve(null), BROKER_ATTEMPT_TIMEOUT);
-    promise.then(
-      (value) => {
-        clearTimeout(timer);
-        resolve(value);
-      },
-      () => {
-        clearTimeout(timer);
-        resolve(null);
-      },
-    );
-  });
+  return settleWithin(promise, BROKER_ATTEMPT_TIMEOUT);
 }
 
 export function getBrokerCandidates(