gloomberb 0.7.3 → 0.7.4

package/src/sources/gloomberb-cloud.ts

@@ -27,12 +27,13 @@ import {
   type CloudMarketResponse,
   type CloudNewsPayload,
   type CloudNewsStoryItemPayload,
+  type CloudOptionsChainPayload,
   type CloudPricePointPayload,
   type CloudQuotePayload,
 } from "../utils/api-client";
 import type { NewsArticle, NewsQuery, NewsStoryItem } from "../types/news-source";
 import { normalizePriceValueByDivisor, resolveCurrencyUnit } from "../utils/currency-units";
-import { canonicalTickerKey, publicExchange } from "../utils/exchanges";
+import { canonicalTickerKey, publicExchange, resolveExchangeTimeZone } from "../utils/exchanges";
 import { collectNewsDisplayTickers } from "../news/ticker-symbols";
 import { createProviderMiss } from "./provider-errors";
 
@@ -42,7 +43,6 @@ const CLOUD_RESOLUTION_SUPPORT = normalizeChartResolutionSupport([
   { resolution: "5m", maxRange: "1M" },
   { resolution: "15m", maxRange: "3M" },
   { resolution: "30m", maxRange: "6M" },
-  { resolution: "45m", maxRange: "6M" },
   { resolution: "1h", maxRange: "1Y" },
   { resolution: "1d", maxRange: "ALL" },
   { resolution: "1wk", maxRange: "ALL" },
@@ -54,6 +54,7 @@ const CLOUD_PROVIDER_MISS_PATTERNS = [
   /figi.*missing or invalid/i,
   /error in the query/i,
 ];
+type CloudProviderMeta = NonNullable<CloudMarketResponse<unknown>["providerMeta"]>;
 
 function isCloudProviderMiss(error: unknown): boolean {
   const message = error instanceof Error ? error.message : String(error);
@@ -71,10 +72,20 @@ async function withCloudFallback<T>(load: () => Promise<T>, message: string): Pr
   }
 }
 
-function mapQuote(quote: CloudQuotePayload): Quote {
+function cloudInternalProviderId(providerMeta?: CloudProviderMeta): string | null {
+  const upstream = providerMeta?.provider ?? providerMeta?.upstream;
+  return upstream ? `${providerId}:${upstream}` : null;
+}
+
+function isStaleCloudResponse(response: CloudMarketResponse<unknown>): boolean {
+  return response.stale === true || response.providerMeta?.stale === true;
+}
+
+function mapQuote(quote: CloudQuotePayload, providerMeta?: CloudProviderMeta): Quote {
   const { currency, divisor } = resolveCurrencyUnit(quote.currency);
   const listingExchangeName = quote.listingExchangeName ?? quote.exchangeName;
   const listingExchangeFullName = quote.listingExchangeFullName ?? quote.fullExchangeName ?? listingExchangeName;
+  const internalProviderId = cloudInternalProviderId(providerMeta);
   return {
     ...quote,
     currency: currency || quote.currency,
@@ -98,12 +109,100 @@ function mapQuote(quote: CloudQuotePayload): Quote {
     exchangeName: listingExchangeName,
     fullExchangeName: listingExchangeFullName,
     providerId,
+    provenance: internalProviderId
+      ? {
+        ...quote.provenance,
+        price: {
+          providerId: internalProviderId,
+          dataSource: quote.dataSource,
+        },
+        session: {
+          providerId: internalProviderId,
+          dataSource: quote.dataSource,
+        },
+        routing: {
+          providerId,
+          dataSource: quote.dataSource,
+        },
+        fields: {
+          ...quote.provenance?.fields,
+          cloudProvider: { providerId: internalProviderId, dataSource: quote.dataSource },
+          ...(providerMeta?.fallbackReason
+            ? { fallbackReason: { providerId: providerMeta.fallbackReason } }
+            : {}),
+        },
+      }
+      : quote.provenance,
   };
 }
 
-function mapPricePoint(point: CloudPricePointPayload, divisor = 1): PricePoint {
+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): Date {
+  if (value instanceof Date || typeof value === "number") return new Date(value);
+  if (EXPLICIT_TIME_ZONE_PATTERN.test(value)) return new Date(value);
+
+  const match = value.match(LOCAL_DATE_TIME_PATTERN);
+  if (!match) return new Date(value);
+
+  const hasTime = match[4] !== undefined;
+  if (!hasTime) {
+    return new Date(`${match[1]}-${match[2]}-${match[3]}T00:00:00Z`);
+  }
+
+  const timeZone = resolveExchangeTimeZone(exchange);
+  return timeZone ? exchangeLocalDateTimeToUtc(match, timeZone) : new Date(value);
+}
+
+function mapPricePoint(point: CloudPricePointPayload, divisor = 1, exchange = ""): PricePoint {
   return {
-    date: new Date(point.date),
+    date: parseCloudPricePointDate(point.date, exchange),
     open: normalizePriceValueByDivisor(point.open, divisor),
     high: normalizePriceValueByDivisor(point.high, divisor),
     low: normalizePriceValueByDivisor(point.low, divisor),
@@ -112,8 +211,8 @@ function mapPricePoint(point: CloudPricePointPayload, divisor = 1): PricePoint {
   };
 }
 
-function mapCloudFinancials(financials: TickerFinancials): TickerFinancials {
-  const quote = financials.quote ? mapQuote(financials.quote as CloudQuotePayload) : undefined;
+function mapCloudFinancials(financials: TickerFinancials, providerMeta?: CloudProviderMeta): TickerFinancials {
+  const quote = financials.quote ? mapQuote(financials.quote as CloudQuotePayload, providerMeta) : undefined;
   const divisor = quote ? resolveCurrencyUnit(quote.currency).divisor : 1;
   return {
     quote,
@@ -130,6 +229,15 @@ function mapCloudFinancials(financials: TickerFinancials): TickerFinancials {
   };
 }
 
+function mapOptionsChain(chain: CloudOptionsChainPayload): OptionsChain {
+  return {
+    underlyingSymbol: chain.underlyingSymbol,
+    expirationDates: chain.expirationDates ?? [],
+    calls: chain.calls ?? [],
+    puts: chain.puts ?? [],
+  };
+}
+
 function mapBatchError<T>(
   item: CloudMarketBatchItem<T>,
   fallbackMessage: string,
@@ -273,10 +381,18 @@ function padTimePart(value: number): string {
   return String(value).padStart(2, "0");
 }
 
-function formatCloudDateTime(date: Date, includeTime: boolean): string {
-  const year = date.getFullYear();
-  const month = padTimePart(date.getMonth() + 1);
-  const day = padTimePart(date.getDate());
+function formatCloudDateTime(date: Date, includeTime: boolean, exchange = ""): string {
+  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 = includeTime ? date.getFullYear() : date.getUTCFullYear();
+  const month = padTimePart((includeTime ? date.getMonth() : date.getUTCMonth()) + 1);
+  const day = padTimePart(includeTime ? date.getDate() : date.getUTCDate());
   if (!includeTime) {
     return `${year}-${month}-${day}`;
   }
@@ -396,7 +512,13 @@ export class GloomberbCloudProvider implements AssetDataProvider {
     await requireVerifiedSession();
     return withCloudFallback(async () => {
       const response = await apiClient.getCloudFinancials(ticker, exchange);
-      return mapCloudFinancials(unwrapRequiredCloudResponse(response, `Cloud financials are unavailable for ${ticker}`));
+      if (isStaleCloudResponse(response)) {
+        throw createProviderMiss(`Cloud financials are stale for ${ticker}`);
+      }
+      return mapCloudFinancials(
+        unwrapRequiredCloudResponse(response, `Cloud financials are unavailable for ${ticker}`),
+        response.providerMeta,
+      );
     }, `Cloud financials are unavailable for ${ticker}`);
   }
 
@@ -437,10 +559,16 @@ export class GloomberbCloudProvider implements AssetDataProvider {
   async getQuote(ticker: string, exchange = "", _context?: MarketDataRequestContext): Promise<Quote> {
     await requireVerifiedSession();
     return withCloudFallback(
-      async () => mapQuote(unwrapRequiredCloudResponse(
-        await apiClient.getCloudQuote(ticker, exchange),
-        `Cloud quotes are unavailable for ${ticker}`,
-      )),
+      async () => {
+        const response = await apiClient.getCloudQuote(ticker, exchange);
+        if (isStaleCloudResponse(response)) {
+          throw createProviderMiss(`Cloud quotes are stale for ${ticker}`);
+        }
+        return mapQuote(
+          unwrapRequiredCloudResponse(response, `Cloud quotes are unavailable for ${ticker}`),
+          response.providerMeta,
+        );
+      },
       `Cloud quotes are unavailable for ${ticker}`,
     );
   }
@@ -550,9 +678,12 @@ export class GloomberbCloudProvider implements AssetDataProvider {
       () => apiClient.getCloudHistory(ticker, exchange, request),
       `Cloud chart data is unavailable for ${ticker}`,
     );
-    const { divisor } = resolveCurrencyUnit(response.providerMeta?.currency);
+    if (isStaleCloudResponse(response)) {
+      throw createProviderMiss(`Cloud chart data is stale for ${ticker}`);
+    }
+    const { divisor } = resolveCurrencyUnit(response.currency ?? response.providerMeta?.currency);
     return unwrapRequiredCloudResponse(response, `Cloud chart data is unavailable for ${ticker}`)
-      .map((point) => mapPricePoint(point, divisor));
+      .map((point) => mapPricePoint(point, divisor, exchange));
   }
 
   async getPriceHistoryForResolution(
@@ -570,14 +701,17 @@ export class GloomberbCloudProvider implements AssetDataProvider {
     const response = await withCloudFallback(
       () => apiClient.getCloudHistory(ticker, exchange, {
         interval,
-        startDate: formatCloudDateTime(startDate, includeTime),
-        endDate: formatCloudDateTime(endDate, includeTime),
+        startDate: formatCloudDateTime(startDate, includeTime, exchange),
+        endDate: formatCloudDateTime(endDate, includeTime, exchange),
       }),
       `Cloud chart data is unavailable for ${ticker}`,
     );
-    const { divisor } = resolveCurrencyUnit(response.providerMeta?.currency);
+    if (isStaleCloudResponse(response)) {
+      throw createProviderMiss(`Cloud chart data is stale for ${ticker}`);
+    }
+    const { divisor } = resolveCurrencyUnit(response.currency ?? response.providerMeta?.currency);
     return unwrapRequiredCloudResponse(response, `Cloud chart data is unavailable for ${ticker}`)
-      .map((point) => mapPricePoint(point, divisor));
+      .map((point) => mapPricePoint(point, divisor, exchange));
   }
 
   async getDetailedPriceHistory(
@@ -594,25 +728,38 @@ export class GloomberbCloudProvider implements AssetDataProvider {
     const response = await withCloudFallback(
       () => apiClient.getCloudHistory(ticker, exchange, {
         interval,
-        startDate: formatCloudDateTime(startDate, includeTime),
-        endDate: formatCloudDateTime(endDate, includeTime),
+        startDate: formatCloudDateTime(startDate, includeTime, exchange),
+        endDate: formatCloudDateTime(endDate, includeTime, exchange),
       }),
       `Cloud detailed chart history is unavailable for ${ticker}`,
     );
-    const { divisor } = resolveCurrencyUnit(response.providerMeta?.currency);
+    if (isStaleCloudResponse(response)) {
+      throw createProviderMiss(`Cloud detailed chart history is stale for ${ticker}`);
+    }
+    const { divisor } = resolveCurrencyUnit(response.currency ?? response.providerMeta?.currency);
     return unwrapRequiredCloudResponse(response, `Cloud detailed chart history is unavailable for ${ticker}`)
-      .map((point) => mapPricePoint(point, divisor));
+      .map((point) => mapPricePoint(point, divisor, exchange));
   }
 
-  async getOptionsChain(_ticker: string, _exchange?: string, _expirationDate?: number, _context?: MarketDataRequestContext): Promise<OptionsChain> {
-    throw createProviderMiss("Cloud options chains are not available");
+  async getOptionsChain(ticker: string, exchange?: string, expirationDate?: number, _context?: MarketDataRequestContext): Promise<OptionsChain> {
+    await requireVerifiedSession();
+    return withCloudFallback(async () => {
+      const response = await apiClient.getCloudOptionsChain(ticker, exchange, expirationDate);
+      const chain = unwrapRequiredCloudResponse(
+        response,
+        `Cloud options chains are unavailable for ${ticker}`,
+      );
+      return mapOptionsChain(chain);
+    }, `Cloud options chains are unavailable for ${ticker}`);
   }
 
   subscribeQuotes(
     targets: QuoteSubscriptionTarget[],
     onQuote: (target: QuoteSubscriptionTarget, quote: Quote) => void,
   ): () => void {
-    void apiClient.ensureVerifiedSession().catch(() => {});
+    if (apiClient.getSessionToken()) {
+      void apiClient.ensureVerifiedSession().catch(() => {});
+    }
     const targetMap = new Map<string, QuoteSubscriptionTarget[]>();
     for (const target of targets) {
       const key = quoteTargetKey(target.symbol, target.exchange);
@@ -625,6 +772,10 @@ export class GloomberbCloudProvider implements AssetDataProvider {
       targets.map((target) => ({
         symbol: target.symbol,
         exchange: target.exchange,
+        surface: target.surface,
+        visible: target.visible,
+        selected: target.selected,
+        weight: target.weight,
       })),
       (target, quote) => {
         const key = quoteTargetKey(target.symbol, target.exchange);