gloomberb 0.11.0 → 0.11.2

package/src/{components/onboarding/account-step/model.ts → plugins/builtin/cloud/auth-model.ts}

@@ -1,9 +1,12 @@
 /**
- * Logic for the onboarding account step, kept out of the React hook so the
- * transitions that gate a network call (validation, retry classification,
- * username derivation) can be exercised without rendering the wizard.
+ * Shared email/password auth logic for every sign-in surface (onboarding,
+ * auth dialog), kept out of React so the transitions that gate a network call
+ * (validation, retry classification, username derivation) can be exercised
+ * without rendering.
  */
+import { apiClient, type AuthUser } from "../../../api-client";
 import { t } from "../../../i18n";
+import { chatController } from "../chat/controller";
 
 export type AccountSub = "choose" | "signup" | "login" | "qr" | "signed-in";
 
@@ -100,6 +103,37 @@ export function classifyAccountError(error: unknown, mode: AccountMode): Account
   };
 }
 
+/**
+ * Runs the sign-up or sign-in sequence every surface shares: sign-up derives a
+ * username the user never typed (retrying once when the derivation collides),
+ * unverified accounts get a verification email, and the captured session is
+ * handed to the chat controller so it reaches plugin persistence.
+ */
+export async function performEmailAuth(mode: AccountMode, email: string, password: string): Promise<AuthUser> {
+  let user: AuthUser;
+  if (mode === "signup") {
+    try {
+      const username = deriveUsernameFromEmail(email);
+      user = await apiClient.signUp(email, username, username, password);
+    } catch (error) {
+      if (!isUsernameConflictError(error)) throw error;
+      const retryUsername = deriveUsernameFromEmail(email, 1);
+      user = await apiClient.signUp(email, retryUsername, retryUsername, password);
+    }
+  } else {
+    user = await apiClient.signIn(email, password);
+  }
+  if (!user.emailVerified) {
+    await apiClient.sendVerification().catch(() => {});
+  }
+  const sessionToken = apiClient.getSessionToken();
+  if (sessionToken) {
+    chatController.adoptSession(sessionToken, user);
+  }
+  await chatController.refreshSession().catch(() => {});
+  return user;
+}
+
 export interface AccountFormState {
   mode: AccountMode;
   email: string;

package/src/plugins/builtin/cloud/browser.tsx

@@ -0,0 +1,9 @@
+import { ChatContent } from "../chat/content";
+import { createChatPane } from "../chat/pane";
+import { ChatStatusWidget } from "../chat/status-widget";
+import { createGloomberbCloudPlugin } from "./plugin";
+
+export const browserGloomberbCloudPlugin = createGloomberbCloudPlugin({
+  ChatPane: createChatPane(ChatContent),
+  ChatStatusWidget,
+});

package/src/plugins/builtin/cloud/buildout-module.tsx

@@ -0,0 +1,23 @@
+import { BuildoutPane } from "../buildout/pane";
+import type { PluginModule } from "../plugin-module";
+
+export const buildoutModule: PluginModule = {
+  panes: [{
+    id: "buildout",
+    name: "TheBuildout",
+    icon: "T",
+    component: BuildoutPane,
+    defaultPosition: "right",
+    defaultMode: "floating",
+    defaultFloatingSize: { width: 110, height: 34 },
+  }],
+  paneTemplates: [{
+    id: "buildout-pane",
+    paneId: "buildout",
+    label: "TheBuildout",
+    description: "Open TheBuildout infrastructure intelligence.",
+    keywords: ["tbo", "buildout", "thebuildout", "infrastructure", "sites", "intel"],
+    shortcut: { prefix: "TBO" },
+    createInstance: () => ({ placement: "floating" }),
+  }],
+};

package/src/plugins/builtin/cloud/device-signin.ts

@@ -4,7 +4,6 @@
  * adopted through the same persistence and API-client path boot restoration
  * uses, so the rest of the app sees a normal signed-in session.
  */
-import { hostname } from "os";
 import {
   apiClient,
   type AuthUser,
@@ -53,13 +52,8 @@ const START_RETRY_MAX_MS = 30_000;
 const POLL_BACKOFF_FACTOR = 2;
 
 function defaultClientName(): string {
-  try {
-    const name = hostname().trim();
-    if (name && name !== "localhost") return name;
-  } catch {
-    // Browser-bundled builds have no hostname; fall through to the generic name.
-  }
-  return "Gloomberb TUI";
+  const name = typeof process !== "undefined" ? process.env.HOSTNAME?.trim() : "";
+  return name && name !== "localhost" ? name : "Gloomberb";
 }
 
 function defaultClientPlatform(): string | undefined {

package/src/plugins/builtin/cloud/index.tsx

@@ -1,4 +1,5 @@
 import { ChatContent } from "../chat/content";
+import { buildoutModule } from "./buildout-module";
 import { createChatPane } from "../chat/pane";
 import { ChatStatusWidget } from "../chat/status-widget";
 import { createGloomberbCloudPlugin } from "./plugin";
@@ -8,4 +9,5 @@ const ChatPane = createChatPane(ChatContent);
 export const gloomberbCloudPlugin = createGloomberbCloudPlugin({
   ChatPane,
   ChatStatusWidget,
+  extraModules: [buildoutModule],
 });

package/src/plugins/builtin/cloud/plugin.tsx

@@ -3,7 +3,6 @@ import type { GloomPlugin, PaneProps } from "../../../types/plugin";
 import { apiClient } from "../../../api-client";
 import { createGloomberbCloudCapabilities, createGloomberbCloudProvider } from "../../../sources/gloomberb-cloud";
 import { AccountManagementPane } from "../account-management/pane";
-import { BuildoutPane } from "../buildout/pane";
 import { chatController } from "../chat/controller";
 import {
   buildDmCommandResults,
@@ -23,10 +22,12 @@ import { composeBuiltinPlugin, type PluginModule } from "../plugin-module";
 import { registerCloudAuthCommands } from "./auth-commands";
 import { registerCloudUpgradeCommand } from "./upgrade-command";
 import { CloudUpgradeStatusWidget } from "./upgrade-status-widget";
+import { createPublicPaneShare } from "../shared/public-pane";
 
 interface GloomberbCloudPluginComponents {
   ChatPane: (props: PaneProps) => ReactNode;
   ChatStatusWidget: ComponentType;
+  extraModules?: readonly PluginModule[];
 }
 
 function createCloudDataModule(): PluginModule {
@@ -59,6 +60,9 @@ function createChatModule(
       defaultPosition: "right",
       defaultMode: "floating",
       defaultFloatingSize: { width: 80, height: 30 },
+      portableShare: {
+        private: { title: true, params: true, settings: true, state: true },
+      },
     }],
     paneTemplates: [{
       id: "new-chat-pane",
@@ -96,7 +100,9 @@ function createChatModule(
     },
     setup(ctx) {
       chatController.attachPersistence(ctx.persistence, ctx.resume);
-      chatController.setNotifier(ctx.notify);
+      chatController.setNotifier(ctx.notify, (channelId, messageId) => {
+        ctx.createPaneFromTemplate("new-chat-pane", { arg: channelId, values: { messageId } });
+      });
       ctx.registerCommand({
         id: "direct-message",
         label: "DM",
@@ -135,6 +141,9 @@ const accountModule: PluginModule = {
     defaultPosition: "right",
     defaultMode: "floating",
     defaultFloatingSize: { width: 72, height: 36 },
+    portableShare: {
+      private: { title: true, params: true, settings: true, state: true },
+    },
   }],
   paneTemplates: [{
     id: "account-management-pane",
@@ -154,27 +163,6 @@ const accountModule: PluginModule = {
   },
 };
 
-const buildoutModule: PluginModule = {
-  panes: [{
-    id: "buildout",
-    name: "TheBuildout",
-    icon: "T",
-    component: BuildoutPane,
-    defaultPosition: "right",
-    defaultMode: "floating",
-    defaultFloatingSize: { width: 110, height: 34 },
-  }],
-  paneTemplates: [{
-    id: "buildout-pane",
-    paneId: "buildout",
-    label: "TheBuildout",
-    description: "Open TheBuildout infrastructure intelligence.",
-    keywords: ["tbo", "buildout", "thebuildout", "infrastructure", "sites", "intel"],
-    shortcut: { prefix: "TBO" },
-    createInstance: () => ({ placement: "floating" }),
-  }],
-};
-
 const congressTradesModule: PluginModule = {
   panes: [{
     id: CONGRESS_TRADES_PANE_ID,
@@ -193,6 +181,7 @@ const congressTradesModule: PluginModule = {
     keywords: ["congress", "house", "trades", "ptr", "stock", "disclosures"],
     shortcut: { prefix: "CG" },
     createInstance: () => ({ placement: "floating" }),
+    publicShare: createPublicPaneShare("Congress Trades"),
   }],
 };
 
@@ -203,6 +192,7 @@ const twitterModule: PluginModule = {
 export function createGloomberbCloudPlugin({
   ChatPane,
   ChatStatusWidget,
+  extraModules = [],
 }: GloomberbCloudPluginComponents): GloomPlugin {
   return composeBuiltinPlugin({
     id: "gloomberb-cloud",
@@ -215,7 +205,7 @@ export function createGloomberbCloudPlugin({
       createCloudDataModule(),
       createChatModule(ChatPane, ChatStatusWidget),
       accountModule,
-      buildoutModule,
+      ...extraModules,
       congressTradesModule,
       twitterModule,
     ],

package/src/plugins/builtin/cloud/upgrade-command.ts

@@ -3,6 +3,7 @@ import type { GloomPluginContext } from "../../../types/plugin";
 import { requestAccountManagementTab } from "../account-management/navigation";
 import { openCloudUpgradeUrl } from "../shared/cloud-upgrade";
 import { resolvePlanAccess } from "../shared/plan-access";
+import { requestAuthDialog } from "./auth-dialog";
 
 export function registerCloudUpgradeCommand(ctx: GloomPluginContext): void {
   ctx.registerCommand({
@@ -15,14 +16,20 @@ export function registerCloudUpgradeCommand(ctx: GloomPluginContext): void {
     // Paying subscribers have nothing to upgrade to; trial accounts still do.
     hidden: () => resolvePlanAccess(apiClient.getCurrentUser()).isPayingPro,
     execute: () => {
-      if (!apiClient.getSessionToken()) {
-        ctx.openCommandBar("Sign Up");
+      const openUpgrade = () => {
+        if (openCloudUpgradeUrl()) return;
+        // No renderer-backed opener yet: fall back to the in-app billing surface.
+        requestAccountManagementTab("pro");
+        ctx.showPane("account-management");
+      };
+      if (!apiClient.isSignedIn()) {
+        // Upgrading needs an account first; continue to checkout once signed in.
+        if (!requestAuthDialog({ mode: "signup", onSignedIn: openUpgrade })) {
+          ctx.openCommandBar("Sign Up");
+        }
         return;
       }
-      if (openCloudUpgradeUrl()) return;
-      // No renderer-backed opener yet: fall back to the in-app billing surface.
-      requestAccountManagementTab("pro");
-      ctx.showPane("account-management");
+      openUpgrade();
     },
   });
 }

package/src/plugins/builtin/cloud-tweets/pane-share.test.ts

@@ -0,0 +1,56 @@
+import { describe, expect, test } from "bun:test";
+import type {
+  GloomPluginContext,
+  PaneTemplateContext,
+  PaneTemplateDef,
+} from "../../../types/plugin";
+import { createFeed } from "./model";
+import { registerTwitterFeedFeature } from "./registration";
+
+const context: PaneTemplateContext = {
+  config: {} as PaneTemplateContext["config"],
+  layout: { dockRoot: null, instances: [], floating: [], detached: [] },
+  focusedPaneId: null,
+  activeTicker: null,
+  activeCollectionId: null,
+};
+
+function twitterTemplate(): PaneTemplateDef {
+  let template: PaneTemplateDef | null = null;
+  registerTwitterFeedFeature({
+    registerTickerResearchTab() {},
+    registerPane() {},
+    registerCommand() {},
+    registerPaneTemplate(value) { template = value; },
+  } as unknown as GloomPluginContext);
+  if (!template) throw new Error("X Feed template was not registered");
+  return template;
+}
+
+describe("X Feed pane sharing", () => {
+  test("restores the active advanced-search query", async () => {
+    const template = twitterTemplate();
+    const first = createFeed("$SPY", "Latest");
+    const active = createFeed("$NVDA OR $AMD", "Top");
+    const shared = template.publicShare?.serialize({
+      pane: {
+        instanceId: "twitter-feed:private-query-id",
+        paneId: "twitter-feed",
+        params: { query: "old", queryType: "Latest" },
+      },
+      paneState: {
+        pluginState: {
+          "gloomberb-cloud": {
+            feeds: { feeds: [first, active] },
+            activeFeedId: active.id,
+          },
+        },
+      },
+    });
+
+    expect(shared?.data).toEqual({ query: "$NVDA OR $AMD", queryType: "Top" });
+    const options = template.publicShare?.restore(shared!.data);
+    const instance = await template.createInstance?.(context, options ?? undefined);
+    expect(instance?.params).toEqual({ query: "$NVDA OR $AMD", queryType: "Top" });
+  });
+});

package/src/plugins/builtin/cloud-tweets/pane.tsx

@@ -60,11 +60,16 @@ export function TwitterTickerTab({ focused, width, height }: TickerResearchTabPr
 export function TwitterFeedPane({ focused, width, height }: PaneProps) {
   const paneId = usePaneInstanceId();
   const paneInstance = usePaneInstance();
-  const [persistedState, setPersistedState] = usePluginState<PersistedTwitterFeedState>(
+  const [legacyPersistedState, setLegacyPersistedState] = usePluginState<PersistedTwitterFeedState>(
     `twitter-feed:${paneId}`,
     EMPTY_FEED_STATE,
     { schemaVersion: TWEET_SEARCH_SCHEMA_VERSION },
   );
+  const [panePersistedState, setPanePersistedState] = usePluginPaneState<PersistedTwitterFeedState | null>(
+    "feeds",
+    null,
+  );
+  const persistedState = panePersistedState ?? legacyPersistedState;
   const [launchRequest, setLaunchRequest] = usePluginState<TwitterFeedLaunchRequest | null>(
     TWITTER_FEED_LAUNCH_STATE_KEY,
     null,
@@ -77,6 +82,14 @@ export function TwitterFeedPane({ focused, width, height }: PaneProps) {
   const initializedRef = useRef(false);
   const feeds = useMemo(() => normalizeFeeds(persistedState), [persistedState]);
 
+  useEffect(() => {
+    if (panePersistedState !== null) return;
+    const legacyFeeds = normalizeFeeds(legacyPersistedState);
+    if (legacyFeeds.length === 0) return;
+    setPanePersistedState({ feeds: legacyFeeds });
+    setLegacyPersistedState(EMPTY_FEED_STATE);
+  }, [legacyPersistedState, panePersistedState, setLegacyPersistedState, setPanePersistedState]);
+
   const focusSearch = useCallback(() => {
     setSearchFocused(true);
     setSearchFocusToken((current) => current + 1);
@@ -87,8 +100,10 @@ export function TwitterFeedPane({ focused, width, height }: PaneProps) {
   }, []);
 
   const updateFeeds = useCallback((updater: (feeds: TwitterFeed[]) => TwitterFeed[]) => {
-    setPersistedState((current) => ({ feeds: updater(normalizeFeeds(current)) }));
-  }, [setPersistedState]);
+    setPanePersistedState((current) => ({
+      feeds: updater(normalizeFeeds(current ?? persistedState)),
+    }));
+  }, [persistedState, setPanePersistedState]);
 
   const addFeed = useCallback((query = "", queryType: CloudTweetQueryType = "Latest") => {
     const feed = createFeed(query, queryType);
@@ -146,10 +161,10 @@ export function TwitterFeedPane({ focused, width, height }: PaneProps) {
     const seedQuery = typeof paneInstance?.params?.query === "string" ? paneInstance.params.query : "";
     const seedType = paneInstance?.params?.queryType === "Top" ? "Top" : "Latest";
     const feed = createFeed(seedQuery, seedType);
-    setPersistedState({ feeds: [feed] });
+    setPanePersistedState({ feeds: [feed] });
     setActiveFeedId(feed.id);
     if (!seedQuery.trim()) focusSearch();
-  }, [feeds.length, focusSearch, paneInstance?.params?.query, paneInstance?.params?.queryType, setActiveFeedId, setPersistedState]);
+  }, [feeds.length, focusSearch, paneInstance?.params?.query, paneInstance?.params?.queryType, setActiveFeedId, setPanePersistedState]);
 
   useEffect(() => {
     if (!launchRequest) return;

package/src/plugins/builtin/cloud-tweets/registration.ts

@@ -1,8 +1,10 @@
 import type { GloomPluginContext } from "../../../types/plugin";
+import { canonicalExchange } from "../../../utils/exchanges";
 import {
   TWITTER_FEED_LAUNCH_SCHEMA_VERSION,
   TWITTER_FEED_LAUNCH_STATE_KEY,
   TWITTER_FEED_PANE_ID,
+  normalizeFeeds,
   type TwitterFeedLaunchRequest,
 } from "./model";
 import {
@@ -10,13 +12,21 @@ import {
   TwitterTickerTab,
 } from "./pane";
 
+function record(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+
 export function registerTwitterFeedFeature(ctx: GloomPluginContext): void {
   ctx.registerTickerResearchTab({
     id: "ticker-tweets",
     name: "Tweets",
     order: 38,
     component: TwitterTickerTab,
-    isVisible: ({ ticker }) => !!ticker,
+    isVisible: ({ ticker }) => {
+      if (!ticker) return false;
+      const exchange = canonicalExchange(ticker.metadata.exchange);
+      return !exchange || ["NASDAQ", "NYSE", "AMEX", "ARCA", "BATS", "OTC", "PINK"].includes(exchange);
+    },
   });
 
   ctx.registerPane({
@@ -36,16 +46,50 @@ export function registerTwitterFeedFeature(ctx: GloomPluginContext): void {
     description: "Open an X advanced-search feed.",
     keywords: ["twitter", "x", "tweet", "tweets", "feed", "social"],
     createInstance: (_context, options) => {
-      const query = options?.values?.query?.trim() || options?.arg?.trim() || "";
+      const shared = record(options?.shareData) ? options.shareData : null;
+      const query = typeof shared?.query === "string"
+        ? shared.query.trim()
+        : options?.values?.query?.trim() || options?.arg?.trim() || "";
+      const queryType = shared?.queryType === "Top" || options?.values?.queryType === "Top"
+        ? "Top"
+        : "Latest";
       return {
         title: "X Feed",
         placement: "floating",
-        params: {
-          query,
-          queryType: options?.values?.queryType === "Top" ? "Top" : "Latest",
-        },
+        params: { query, queryType },
       };
     },
+    publicShare: {
+      serialize: ({ pane, paneState }) => {
+        const pluginState = record(paneState.pluginState)
+          ? paneState.pluginState["gloomberb-cloud"]
+          : null;
+        const feedsState = record(pluginState) ? pluginState.feeds : null;
+        const feeds = normalizeFeeds(feedsState);
+        const activeFeedId = record(pluginState) && typeof pluginState.activeFeedId === "string"
+          ? pluginState.activeFeedId
+          : null;
+        const active = feeds.find((feed) => feed.id === activeFeedId) ?? feeds[0];
+        const query = active?.query.trim()
+          || (typeof pane.params?.query === "string" ? pane.params.query.trim() : "");
+        if (!query) return null;
+        return {
+          title: pane.title?.trim() || "X Feed",
+          data: {
+            query,
+            queryType: active?.queryType === "Top" || pane.params?.queryType === "Top" ? "Top" : "Latest",
+          },
+        };
+      },
+      restore: (data) => (
+        Object.keys(data).every((key) => key === "query" || key === "queryType")
+        && typeof data.query === "string"
+        && data.query.trim().length > 0
+        && (data.queryType === "Latest" || data.queryType === "Top")
+          ? { shareData: { query: data.query.trim(), queryType: data.queryType } }
+          : null
+      ),
+    },
   });
 
   ctx.registerCommand({

package/src/plugins/builtin/composite-plugins.ts

@@ -7,6 +7,7 @@ import { brokerManagerModule } from "./broker-manager";
 import { changelogModule } from "./changelog";
 import { connectionsModule } from "./connections";
 import { correlationModule } from "./correlation";
+import { cdsModule } from "./cds";
 import { creditConditionsModule } from "./credit-conditions";
 import { economicCalendarModule } from "./econ";
 import { earningsModule } from "./earnings";
@@ -89,7 +90,7 @@ export const macroPlugin = composeBuiltinPlugin({
   id: "macro",
   name: "Macro",
   version: "1.0.0",
-  description: "Economic calendar, rates, volatility, credit spreads, Treasury auctions, earnings, IPOs, and live financial TV.",
+  description: "Economic calendar, rates, volatility, credit spreads, single-name CDS, Treasury auctions, earnings, IPOs, and live financial TV.",
   toggleable: true,
   modules: [
     macroSharedResourcesModule,
@@ -97,6 +98,7 @@ export const macroPlugin = composeBuiltinPlugin({
     yieldCurveModule,
     volatilityModule,
     creditConditionsModule,
+    cdsModule,
     treasuryAuctionsModule,
     earningsModule,
     ipoCalendarModule,

package/src/plugins/builtin/congress-trades/detail.tsx

@@ -1,8 +1,9 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { Box, ScrollBox, Text, TextAttributes, useRendererHost } from "../../../ui";
+import { Box, ScrollBox, Text, TextAttributes, useRendererHost, type ScrollBoxRenderable } from "../../../ui";
 import {
   DataTableView,
   usePaneFooter,
+  useTableLoadMore,
   type DataTableKeyEvent,
 } from "../../../components";
 import { useInlineTickerOpener } from "../../../state/hooks/inline-tickers";
@@ -19,6 +20,9 @@ import {
   CONGRESS_MEMBER_FILING_LIMIT,
   CONGRESS_MEMBER_TRADE_LIMIT,
   CONGRESS_TRADES_PANE_ID,
+  canLoadMoreCongress,
+  mergeCongressPages,
+  nextCongressPage,
   buildMemberTradeColumns,
   formatAmountRange,
   formatLag,
@@ -121,6 +125,8 @@ export function MemberTradesDetail({
     direction: "desc",
   });
   const fetchGenRef = useRef(0);
+  const [loadingMore, setLoadingMore] = useState(false);
+  const tradeScrollRef = useRef<ScrollBoxRenderable | null>(null);
 
   const load = useCallback((refresh = false) => {
     fetchGenRef.current += 1;
@@ -150,6 +156,40 @@ export function MemberTradesDetail({
       });
   }, [filingLimit, member.memberName, member.stateDistrict]);
 
+  const loadMore = useCallback(() => {
+    if (!detailPayload || loadingMore || status !== "loaded") return;
+    const nextRequest = nextCongressPage(detailPayload);
+    if (!nextRequest) return;
+    const gen = fetchGenRef.current;
+    setLoadingMore(true);
+    apiClient.getCloudCongressHouse({
+      ...nextRequest,
+      member: member.memberName,
+      limit: CONGRESS_MEMBER_TRADE_LIMIT,
+      filingLimit: Math.max(CONGRESS_MEMBER_FILING_LIMIT, filingLimit),
+    })
+      .then((payload) => {
+        if (fetchGenRef.current !== gen) return;
+        const merged = detailPayload ? mergeCongressPages(detailPayload, payload) : payload;
+        const exactMemberTrades = merged.trades.filter((trade) => (
+          trade.memberName === member.memberName
+          && trade.stateDistrict === member.stateDistrict
+        ));
+        setDetailPayload(merged);
+        setTrades(exactMemberTrades.length > 0 ? exactMemberTrades : merged.trades);
+      })
+      .finally(() => {
+        if (fetchGenRef.current !== gen) return;
+        setLoadingMore(false);
+      });
+  }, [detailPayload, filingLimit, loadingMore, member.memberName, member.stateDistrict, status]);
+
+  const onTradeScroll = useTableLoadMore(
+    tradeScrollRef,
+    !!detailPayload && status === "loaded" && !loadingMore && canLoadMoreCongress(detailPayload),
+    loadMore,
+  );
+
   useEffect(() => {
     fetchGenRef.current += 1;
     setTrades(initialTrades);
@@ -282,6 +322,8 @@ export function MemberTradesDetail({
         renderCell={renderCongressTradeCell}
         emptyStateTitle={emptyTitle}
         showHorizontalScrollbar={false}
+        scrollRef={tradeScrollRef}
+        onBodyScrollActivity={onTradeScroll}
       />
     </Box>
   );

package/src/plugins/builtin/congress-trades/model.test.ts

@@ -0,0 +1,85 @@
+import { describe, expect, test } from "bun:test";
+import type { CloudCongressHousePayload } from "../../../api-client";
+import { canLoadMoreCongress, congressPageAfterEmpty, mergeCongressPages, nextCongressPage } from "./model";
+
+function payload(overrides: Partial<CloudCongressHousePayload> = {}): CloudCongressHousePayload {
+  return {
+    asOf: "2026-01-01T00:00:00.000Z",
+    chamber: "house",
+    source: "house-clerk",
+    year: 2026,
+    indexUpdatedAt: null,
+    filingsScanned: 20,
+    filingCount: 80,
+    filingOffset: 0,
+    hasMore: false,
+    hasMoreFilings: true,
+    nextOffset: 20,
+    nextFilingOffset: 20,
+    trades: [],
+    members: [],
+    ...overrides,
+  };
+}
+
+describe("congress paging", () => {
+  test("walks remaining trades, then more filings, then the previous year", () => {
+    expect(nextCongressPage(payload({ hasMore: true, nextOffset: 40 }))).toEqual({
+      year: 2026,
+      offset: 40,
+      filingOffset: 0,
+    });
+    expect(nextCongressPage(payload({ hasMore: false, hasMoreFilings: true, nextFilingOffset: 20 }))).toEqual({
+      year: 2026,
+      offset: 0,
+      filingOffset: 20,
+    });
+    expect(nextCongressPage(payload({ hasMore: false, hasMoreFilings: false, year: 2026 }))).toEqual({
+      year: 2025,
+      offset: 0,
+      filingOffset: 0,
+    });
+    expect(nextCongressPage(payload({
+      hasMore: false,
+      hasMoreFilings: undefined,
+      filingOffset: 0,
+      filingsScanned: 20,
+      filingCount: 80,
+    }))).toEqual({
+      year: 2026,
+      offset: 0,
+      filingOffset: 20,
+    });
+    expect(canLoadMoreCongress(payload({ hasMore: false, hasMoreFilings: false, year: 2008 }))).toBe(false);
+    expect(nextCongressPage(congressPageAfterEmpty(payload({
+      hasMore: true,
+      year: 2026,
+      filingsScanned: 20,
+      filingCount: 80,
+    })))).toEqual({
+      year: 2025,
+      offset: 0,
+      filingOffset: 0,
+    });
+  });
+
+  test("appends unique trades and members from the next page", () => {
+    const merged = mergeCongressPages(
+      payload({
+        trades: [{ id: "t1" } as CloudCongressHousePayload["trades"][number]],
+        members: [{ id: "m1" } as CloudCongressHousePayload["members"][number]],
+      }),
+      payload({
+        year: 2025,
+        trades: [
+          { id: "t1" } as CloudCongressHousePayload["trades"][number],
+          { id: "t2" } as CloudCongressHousePayload["trades"][number],
+        ],
+        members: [{ id: "m2" } as CloudCongressHousePayload["members"][number]],
+      }),
+    );
+    expect(merged.year).toBe(2025);
+    expect(merged.trades.map((trade) => trade.id)).toEqual(["t1", "t2"]);
+    expect(merged.members.map((member) => member.id)).toEqual(["m1", "m2"]);
+  });
+});