gloomberb 0.10.2 → 0.10.3

package/src/state/hooks/quote-streaming.test.tsx

@@ -2,10 +2,14 @@ import { afterEach, describe, expect, test } from "bun:test";
 import { act, useState } from "react";
 import { testRender } from "../../renderers/opentui/test-utils";
 import { MarketDataCoordinator, setSharedMarketDataCoordinator } from "../../market-data/coordinator";
-import { useQuoteStreaming } from "./quote-streaming";
+import { createTestDataProvider } from "../../test-support/data-provider";
+import { useLiveQuoteEntries, useQuoteStreaming } from "./quote-streaming";
 
 let testSetup: Awaited<ReturnType<typeof testRender>> | undefined;
 let bumpHarness: (() => void) | null = null;
+let updateLiveTargets: ((symbol: string) => void) | null = null;
+let updateFreshnessScope: ((scope: string) => void) | null = null;
+let observedSubscriptionStartedAt = 0;
 
 function QuoteStreamingHarness() {
   const [tick, setTick] = useState(0);
@@ -19,6 +23,18 @@ function QuoteStreamingHarness() {
   return <text>{String(tick)}</text>;
 }
 
+function LiveQuoteFreshnessHarness() {
+  const [symbol, setSymbol] = useState("AAPL");
+  const [freshnessScopeKey, setFreshnessScopeKey] = useState("expiration-1");
+  updateLiveTargets = setSymbol;
+  updateFreshnessScope = setFreshnessScopeKey;
+  observedSubscriptionStartedAt = useLiveQuoteEntries(
+    [{ symbol, exchange: "OPTIONS" }],
+    { freshnessScopeKey },
+  ).subscriptionStartedAt;
+  return <text>{symbol}</text>;
+}
+
 afterEach(async () => {
   if (testSetup) {
     await act(async () => {
@@ -27,6 +43,9 @@ afterEach(async () => {
     testSetup = undefined;
   }
   bumpHarness = null;
+  updateLiveTargets = null;
+  updateFreshnessScope = null;
+  observedSubscriptionStartedAt = 0;
   setSharedMarketDataCoordinator(null);
 });
 
@@ -67,4 +86,42 @@ describe("useQuoteStreaming", () => {
     expect(subscribeCalls).toBe(1);
     expect(unsubscribeCalls).toBe(0);
   });
+
+  test("keeps quote freshness stable while targets move within one surface", async () => {
+    const originalDateNow = Date.now;
+    let now = 100;
+    Date.now = () => now;
+    setSharedMarketDataCoordinator(new MarketDataCoordinator(createTestDataProvider({
+      subscribeQuotes: () => () => {},
+    })));
+
+    try {
+      testSetup = await testRender(<LiveQuoteFreshnessHarness />, {
+        width: 20,
+        height: 1,
+      });
+      await act(async () => {
+        await testSetup!.renderOnce();
+      });
+      expect(observedSubscriptionStartedAt).toBe(100);
+
+      now = 200;
+      await act(async () => {
+        updateLiveTargets?.("MSFT");
+        await Promise.resolve();
+        await testSetup!.renderOnce();
+      });
+      expect(observedSubscriptionStartedAt).toBe(100);
+
+      now = 300;
+      await act(async () => {
+        updateFreshnessScope?.("expiration-2");
+        await Promise.resolve();
+        await testSetup!.renderOnce();
+      });
+      expect(observedSubscriptionStartedAt).toBe(300);
+    } finally {
+      Date.now = originalDateNow;
+    }
+  });
 });

package/src/state/hooks/quote-streaming.ts

@@ -101,7 +101,10 @@ export function useQuoteStreaming(targets: QuoteSubscriptionTarget[]): void {
  * Subscribe to a bounded target set and observe the coordinator entries filled
  * by that stream. This intentionally avoids per-symbol HTTP quote loads.
  */
-export function useLiveQuoteEntries(targets: QuoteSubscriptionTarget[]): {
+export function useLiveQuoteEntries(
+  targets: QuoteSubscriptionTarget[],
+  options: { freshnessScopeKey?: string } = {},
+): {
   entries: Map<string, QueryEntry<Quote>>;
   freshnessNow: number;
   subscriptionStartedAt: number;
@@ -115,7 +118,7 @@ export function useLiveQuoteEntries(targets: QuoteSubscriptionTarget[]): {
     .map((target) => buildQuoteStreamSubscriptionKey(target))
     .sort()
     .join("\u001f");
-  const subscriptionKey = `${appActive ? "active" : "inactive"}\u001f${targetKey}`;
+  const subscriptionKey = `${appActive ? "active" : "inactive"}\u001f${options.freshnessScopeKey ?? targetKey}`;
   const subscriptionRef = useRef({
     key: subscriptionKey,
     startedAt: Date.now(),