gloomberb 0.18.3 → 0.18.4

package/README.md

@@ -1,8 +1,8 @@
 <div align="center">
 
-<img src="src/assets/gloomberb-logo.svg" alt="Gloomberb logo" width="76" />
+<img src="src/assets/gloomberb-logo.svg" alt="Gloom logo" width="76" />
 
-# Gloomberb
+# Gloom
 
 **Open-source finance terminal. Fast, keyboard-driven, and extensible.**
 
@@ -21,7 +21,7 @@ Desktop app for macOS and Windows. Terminal UI for macOS, Linux, and Windows.
 <br />
 <br />
 
-<img src="https://gloom.sh/landing-terminal.png" alt="Gloomberb terminal showing portfolio, watchlists, market data, and chart panels." width="720" />
+<img src="https://gloom.sh/landing-terminal.png" alt="Gloom terminal showing portfolio, watchlists, market data, and chart panels." width="720" />
 
 <sub>Backed by <a href="https://adjacent.markets/?ref=gloomberb"><img src="docs/assets/adjacent.svg" alt="" width="12" height="12" /> Adjacent</a></sub>
 
@@ -45,7 +45,7 @@ For the terminal on **macOS or Linux**:
 curl -fsSL gloom.sh/install | bash
 ```
 
-The script downloads the prebuilt release from GitHub and checks its SHA-256 against the digest GitHub lists. Apple Silicon Macs get the desktop app and the `gloomberb` command; Linux and Intel Macs get the standalone binary. It asks for `sudo` only if the destination isn't writable. Prefer to download it yourself? See the [installation guide](docs/installation.md).
+The script downloads the prebuilt release from GitHub and checks its SHA-256 against the digest GitHub lists. Apple Silicon Macs get the desktop app and the `gloom` command; Linux and Intel Macs get the standalone binary. It asks for `sudo` only if the destination isn't writable. Prefer to download it yourself? See the [installation guide](docs/installation.md).
 
 With [Bun](https://bun.sh), on any supported OS:
 
@@ -53,13 +53,13 @@ With [Bun](https://bun.sh), on any supported OS:
 bun install -g gloomberb
 ```
 
-Then run `gloomberb`. For chart graphics, use a Kitty-compatible terminal such as Ghostty, Kitty, or WezTerm. Windows Terminal draws charts as text; the desktop app draws them in full.
+Then run `gloom`. The command was called `gloomberb` before 0.19, and that name still works. For chart graphics, use a Kitty-compatible terminal such as Ghostty, Kitty, or WezTerm. Windows Terminal draws charts as text; the desktop app draws them in full.
 
 ## Start
 
 Press `Ctrl+P` for the command bar, or `` ` `` to search for a ticker. Try `DES AAPL` for company details or `GP NVDA` for a price chart. `HELP` lists commands and shortcuts.
 
-The [user guide](docs/usage.md) covers charts, broker setup, shortcuts, and the CLI (`gloomberb quote AAPL`).
+The [user guide](docs/usage.md) covers charts, broker setup, shortcuts, and the CLI (`gloom quote AAPL`).
 
 ## Data and privacy
 
@@ -69,6 +69,6 @@ Crash reports and usage counts can be turned off. See [what is sent and how to o
 
 ## Plugins and contributing
 
-Plugins add panes, data providers, broker connections, and commands. Install one from GitHub with `gloomberb install gloom-sh/gloom-tv`. See the [plugin guide](PLUGINS.md) and the [contributing guide](CONTRIBUTING.md).
+Plugins add panes, data providers, broker connections, and commands. Install one from GitHub with `gloom install gloom-sh/gloom-tv`. See the [plugin guide](PLUGINS.md) and the [contributing guide](CONTRIBUTING.md).
 
-[MIT licensed](LICENSE). Built with [OpenTUI](https://opentui.com/). [Sponsor Gloomberb](https://gloom.sh/sponsor).
+[MIT licensed](LICENSE). Built with [OpenTUI](https://opentui.com/). [Sponsor Gloom](https://gloom.sh/sponsor).

package/README.zh-CN.md

@@ -1,8 +1,8 @@
 <div align="center">
 
-<img src="src/assets/gloomberb-logo.svg" alt="Gloomberb 标志" width="76" />
+<img src="src/assets/gloomberb-logo.svg" alt="Gloom 标志" width="76" />
 
-# Gloomberb
+# Gloom
 
 **开源金融终端。快速、键盘驱动、可扩展。**
 
@@ -21,7 +21,7 @@
 <br />
 <br />
 
-<img src="https://gloom.sh/landing-terminal.png" alt="Gloomberb 终端界面，显示投资组合、自选列表、市场数据和图表面板。" width="720" />
+<img src="https://gloom.sh/landing-terminal.png" alt="Gloom 终端界面，显示投资组合、自选列表、市场数据和图表面板。" width="720" />
 
 <sub>由 <a href="https://adjacent.markets/?ref=gloomberb"><img src="docs/assets/adjacent.svg" alt="" width="12" height="12" /> Adjacent</a> 赞助支持</sub>
 
@@ -47,7 +47,7 @@ brew install --cask gloomberb
 
 在 **Windows 11** 上，[下载安装程序](https://github.com/gloom-sh/gloomberb/releases/latest/download/stable-win-x64-GloomberbSetup.exe)。支持 x64，也可通过 x64 仿真在 ARM64 上运行。
 
-两个平台的桌面安装程序均包含 `gloomberb` 终端命令。
+两个平台的桌面安装程序均包含 `gloom` 终端命令。
 
 ### 终端版
 
@@ -65,7 +65,7 @@ curl -fsSL gloom.sh/install | bash
 bun install -g gloomberb
 ```
 
-运行 `gloomberb` 即可启动。要显示图形，请使用兼容 Kitty 图形协议的终端，例如 Ghostty、Kitty 或 WezTerm。直接下载、安装位置与更新方式详见[安装指南（英文）](docs/installation.md)。
+运行 `gloom` 即可启动。0.19 之前命令名为 `gloomberb`，该名称仍可使用。要显示图形，请使用兼容 Kitty 图形协议的终端，例如 Ghostty、Kitty 或 WezTerm。直接下载、安装位置与更新方式详见[安装指南（英文）](docs/installation.md)。
 
 ## 开始使用
 
@@ -86,9 +86,9 @@ bun install -g gloomberb
 直接在 shell 中运行命令：
 
 ```bash
-gloomberb quote AAPL
-gloomberb quote AAPL --json
-gloomberb help
+gloom quote AAPL
+gloom quote AAPL --json
+gloom help
 ```
 
 默认输出便于阅读；脚本可使用 `--json`、`--csv` 或 `--ndjson` 获取结构化输出。命令与参数详见 [CLI 参考（英文）](docs/usage.md#cli)。
@@ -98,7 +98,7 @@ gloomberb help
 插件可添加面板、数据源、券商连接与命令。从 GitHub 安装插件：
 
 ```bash
-gloomberb install gloom-sh/gloom-tv
+gloom install gloom-sh/gloom-tv
 ```
 
 详见[插件开发指南（英文）](PLUGINS.md)、[直播电视配置（英文）](docs/usage.md#live-tv)或[贡献指南（英文）](CONTRIBUTING.md)。
@@ -111,6 +111,6 @@ gloomberb install gloom-sh/gloom-tv
 
 <a href="https://adjacent.markets/?ref=gloomberb"><img src="docs/assets/adjacent.svg" alt="Adjacent" width="56" /></a>
 
-[Adjacent](https://adjacent.markets/?ref=gloomberb) 提供预测市场指数、参考利率与数据。感谢其对 Gloomberb 开源开发的支持。
+[Adjacent](https://adjacent.markets/?ref=gloomberb) 提供预测市场指数、参考利率与数据。感谢其对 Gloom 开源开发的支持。
 
-如需赞助 Gloomberb，请发送邮件至 [hello@gloom.sh](mailto:hello@gloom.sh)。
+如需赞助 Gloom，请发送邮件至 [hello@gloom.sh](mailto:hello@gloom.sh)。

package/bin/{gloomberb → gloom}

@@ -1,7 +1,9 @@
 #!/usr/bin/env bun
 
+// The package installs this as both `gloom` and `gloomberb`.
+//
 // Bun applies patchedDependencies only to the root project, so a global
-// `bun install -g gloomberb` runs react-reconciler without
+// `bun install -g` runs react-reconciler without
 // patches/react-reconciler@0.33.0.patch. Its dev build then records a
 // performance.measure for every component render, which Bun keeps forever.
 // The reconciler reads console.timeStamp once at load to decide, so hide it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gloomberb",
-  "version": "0.18.3",
+  "version": "0.18.4",
   "packageManager": "bun@1.3.11",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/public/index.ts",
@@ -35,7 +35,8 @@
     "./broker": "./src/public/broker.ts"
   },
   "bin": {
-    "gloomberb": "bin/gloomberb"
+    "gloom": "bin/gloom",
+    "gloomberb": "bin/gloom"
   },
   "files": [
     "bin",
@@ -82,6 +83,7 @@
     "benchmark:tui:navigation": "bun run scripts/benchmark-tui-navigation.ts",
     "benchmark:tui:compare": "bun run scripts/benchmark-tui-compare.ts",
     "benchmark:tui:memory": "bun run scripts/benchmark-tui-memory.ts",
+    "benchmark:startup": "bun run scripts/benchmark-startup.ts",
     "check:pane-chrome": "bun run scripts/pane-chrome/checks.ts",
     "check:chat-mentions": "bun scripts/pane-chrome/chat-mentions.ts",
     "check:pane-screenshot": "bun run scripts/pane-chrome/screenshot.ts",
@@ -91,6 +93,8 @@
     "ui:benchmark": "bun run scripts/pane-chrome/ui-benchmark.ts",
     "audit:ui": "bun run scripts/pane-chrome/ui-audit.ts",
     "check:call-player": "bun run scripts/pane-chrome/call-player.ts",
+    "check:chart-axis-zoom": "bun run scripts/pane-chrome/chart-axis-zoom.ts",
+    "check:chart-panel-layout": "bun run scripts/pane-chrome/chart-panel-layout.ts",
     "kit:page": "bun run scripts/pane-chrome/kit-page.ts",
     "audit:ui:compare": "bun run scripts/pane-chrome/ui-audit-compare.ts",
     "benchmark:pane-drag:compare": "bun run scripts/pane-chrome/frame-budget.ts",

package/src/account/checkout-handoff.tsx

@@ -0,0 +1,225 @@
+/**
+ * What follows "Start free trial": checkout opens in the browser, and this
+ * dialog says so, keeps the way back to it and waits for Pro to arrive. The
+ * browser button reopens the same checkout instead of starting another, and
+ * a terminal that cannot open a browser (over SSH, say) gets the short link
+ * and its QR code to finish on any device.
+ */
+import { useCallback, useEffect, useState } from "react";
+import { apiClient } from "../api-client";
+import { ApiRequestError } from "../api-client/errors";
+import { hasProAccess, usePlanAccess, type PlanAccessUser } from "../api-client/plan-access";
+import { Button } from "../components/ui/button";
+import { DialogActions } from "../components/ui/dialog-actions";
+import { FORM_DIALOG_WIDTH, DialogFrame } from "../components/ui/frame";
+import { SignInCodePanel } from "../components/sign-in-code-panel";
+import { t } from "../i18n";
+import { useAppLanguage } from "../i18n/react";
+import { useViewport } from "../react/input";
+import { colors } from "../theme/colors";
+import { Box, Text, TextAttributes, useUiCapabilities } from "../ui";
+import { type DialogApi, type PromptContext, useDialogKeyboard } from "../ui/dialog";
+import { logFailure } from "../utils/log-failure";
+import { accountSession } from "./session";
+
+/** The checkout once it exists; the browser may still be opening it. */
+export interface CheckoutHandoffTarget {
+  /** The checkout page itself, which the browser button opens again. */
+  url: string;
+  /** A short link to the same checkout, to read or scan; null when the server sent none. */
+  link: string | null;
+  /** Settles false when no browser could be opened from here. */
+  opened: Promise<boolean>;
+}
+
+/** Where the account stands while checkout is open in the browser. */
+type CheckoutHandoffPlan = "waiting" | "pro" | "verify";
+
+/**
+ * Pro once the account has it; "verify" when checkout went through but Pro
+ * waits for the email to be confirmed, which an unverified account can reach.
+ */
+function checkoutHandoffPlan(user: PlanAccessUser | null | undefined): CheckoutHandoffPlan {
+  if (hasProAccess(user)) return "pro";
+  if (user?.plan === "pro" && user.emailVerified !== true) return "verify";
+  return "waiting";
+}
+
+/** How often the account is asked again while checkout is open. */
+const POLL_MS = 5_000;
+let pollMs = POLL_MS;
+
+/** A shorter poll, so a test sees Pro arrive without waiting seconds; no argument restores it. */
+export function setCheckoutHandoffPollForTests(ms: number = POLL_MS): void {
+  pollMs = ms;
+}
+
+/** Signed out, or a session the server no longer takes: asking again cannot help. */
+function isAuthFailure(error: unknown): boolean {
+  return error instanceof ApiRequestError && (error.status === 401 || error.status === 403);
+}
+/** Polling stops after this; coming back to the app still refreshes the account. */
+const POLL_FOR_MS = 15 * 60_000;
+/** How long "Pro is on" stays before the dialog closes itself. */
+const PRO_HOLD_MS = 1_500;
+
+/** Rows around the panel, as in the sign-in dialog: margins, frame, title block and key line. */
+const TERMINAL_DIALOG_ROWS = 12;
+const DESKTOP_DIALOG_ROWS = 10;
+
+function handoffStatus(target: { url: string } | null, plan: CheckoutHandoffPlan): { text: string; color: string } {
+  if (plan === "pro") return { text: t("Pro is on."), color: colors.positive };
+  if (plan === "verify") return { text: t("Checkout done. Confirm your email to turn Pro on."), color: colors.warning };
+  if (!target) return { text: t("Opening checkout..."), color: colors.textDim };
+  return { text: t("Waiting for checkout..."), color: colors.textDim };
+}
+
+function CheckoutHandoffDialog({
+  resolve,
+  dismiss,
+  target: pending,
+}: PromptContext<true> & { target: Promise<CheckoutHandoffTarget> }) {
+  useAppLanguage();
+  const { nativePaneChrome } = useUiCapabilities();
+  const { height: termHeight } = useViewport();
+  const [target, setTarget] = useState<CheckoutHandoffTarget | null>(null);
+  // Null while the browser is still opening it; the button, link and QR show already.
+  const [opened, setOpened] = useState<boolean | null>(null);
+  // Re-renders when the account changes; the plan is read from the account itself.
+  usePlanAccess();
+  const plan = checkoutHandoffPlan(apiClient.getCurrentUser());
+
+  useEffect(() => {
+    let live = true;
+    // A checkout that could not be created closes this; the caller opens the Cloud page.
+    void pending.then(
+      (value) => {
+        if (!live) return;
+        setTarget(value);
+        void value.opened.then((result) => { if (live) setOpened(result); });
+      },
+      () => { if (live) dismiss(); },
+    );
+    return () => {
+      live = false;
+    };
+  }, [dismiss, pending]);
+
+  useEffect(() => {
+    if (!target || plan !== "waiting") return;
+    let live = true;
+    let inFlight = false;
+    const stopAt = Date.now() + POLL_FOR_MS;
+    const timer = setInterval(() => {
+      if (!live || inFlight) return;
+      if (Date.now() > stopAt || !apiClient.isSignedIn()) {
+        clearInterval(timer);
+        return;
+      }
+      inFlight = true;
+      // A plain read; the session (and with it every footer and tab) is
+      // refreshed only once the account has changed.
+      void apiClient.getAccountProfile()
+        .then((profile) => {
+          if (live && checkoutHandoffPlan(profile) !== "waiting") return accountSession.refreshSession();
+        })
+        .catch((error: unknown) => {
+          if (isAuthFailure(error)) clearInterval(timer);
+          else logFailure("account-upgrade", "Checking for Pro after checkout failed")(error);
+        })
+        .finally(() => {
+          inFlight = false;
+        });
+    }, pollMs);
+    return () => {
+      live = false;
+      clearInterval(timer);
+    };
+  }, [plan, target]);
+
+  const finish = useCallback(() => resolve(true), [resolve]);
+  useEffect(() => {
+    if (plan !== "pro") return;
+    const timer = setTimeout(finish, PRO_HOLD_MS);
+    return () => clearTimeout(timer);
+  }, [finish, plan]);
+
+  useDialogKeyboard((event) => {
+    if (event.name === "escape") {
+      event.stopPropagation?.();
+      dismiss();
+    } else if ((event.name === "enter" || event.name === "return") && plan === "pro") {
+      event.stopPropagation?.();
+      finish();
+    }
+  });
+
+  const title = t("Finish checkout in your browser");
+  // Where nothing opened, the terminal host left Stripe's own link on the clipboard.
+  const subtitle = !target || opened !== false
+    ? t("Pro turns on here as soon as it's done.")
+    : target.link
+      ? t("No browser opens from here. Open the link on any device.")
+      : t("No browser opens from here. Paste the copied link in a browser.");
+  const panel = (rows: number) => (
+    <SignInCodePanel
+      url={target?.url ?? null}
+      link={target?.link ?? null}
+      code={null}
+      status={handoffStatus(target, plan)}
+      height={Math.max(4, rows)}
+      shortcutScope="checkout-handoff:browser"
+    />
+  );
+
+  if (nativePaneChrome) {
+    return (
+      <Box width={FORM_DIALOG_WIDTH} maxWidth="calc(100vw - 72px)" flexDirection="column">
+        <DialogFrame title={title} subtitle={subtitle} onClose={dismiss} desktopFooter={null}>
+          {panel(termHeight - DESKTOP_DIALOG_ROWS)}
+          <Box style={{ marginTop: "var(--gloom-space-md)" }}>
+            <DialogActions alignEnd>
+              <Button label="Close" variant="secondary" desktopShortcut="Esc" onPress={dismiss} />
+            </DialogActions>
+          </Box>
+        </DialogFrame>
+      </Box>
+    );
+  }
+
+  return (
+    <Box flexDirection="column" alignItems="center">
+      <Box height={1}>
+        <Text fg={colors.textBright} attributes={TextAttributes.BOLD}>{title}</Text>
+      </Box>
+      <Box height={1}>
+        <Text fg={colors.textDim}>{subtitle}</Text>
+      </Box>
+      <Box height={1} />
+      {panel(termHeight - TERMINAL_DIALOG_ROWS)}
+      <Box height={1} />
+      <Box height={1}>
+        <Text fg={colors.textMuted}>{t("esc to close")}</Text>
+      </Box>
+    </Box>
+  );
+}
+
+/**
+ * Shows the hand-off while `target` creates the checkout, with the way back
+ * to it as soon as it exists, and keeps it up until Pro arrives or the person
+ * closes it. Resolves true once the
+ * account has Pro, otherwise when it is closed.
+ */
+export async function promptCheckoutHandoff(
+  dialog: DialogApi,
+  target: Promise<CheckoutHandoffTarget>,
+): Promise<boolean> {
+  const result = await dialog
+    .prompt<true>({
+      size: "full",
+      content: (context) => <CheckoutHandoffDialog {...context} target={target} />,
+    })
+    .catch(logFailure("account-upgrade", "Checkout hand-off failed", undefined));
+  return result === true;
+}

package/src/account/device-signin-dialog.tsx

@@ -69,13 +69,13 @@ function deviceSignInStatus(snapshot: DeviceSignInSnapshot): { text: string; col
     case "denied":
       return { text: t("Denied. Press enter to request a new code."), color: colors.negative };
     case "error":
-      return { text: t("Can't reach Gloomberb Cloud. Retrying..."), color: colors.warning };
+      return { text: t("Can't reach Gloom Cloud. Retrying..."), color: colors.warning };
     case "waiting":
       return snapshot.error
         ? { text: t("Connection problem, retrying..."), color: colors.warning }
         : { text: t("Waiting for approval..."), color: colors.textDim };
     default:
-      return { text: t("Contacting Gloomberb Cloud..."), color: colors.textDim };
+      return { text: t("Contacting Gloom Cloud..."), color: colors.textDim };
   }
 }
 

package/src/account/device-signin.ts

@@ -54,7 +54,7 @@ const POLL_BACKOFF_FACTOR = 2;
 
 function defaultClientName(): string {
   const name = typeof process !== "undefined" ? process.env.HOSTNAME?.trim() : "";
-  return name && name !== "localhost" ? name : "Gloomberb";
+  return name && name !== "localhost" ? name : "Gloom";
 }
 
 function defaultClientPlatform(): string | undefined {
@@ -63,7 +63,7 @@ function defaultClientPlatform(): string | undefined {
 
 function errorMessage(error: unknown): string {
   if (error instanceof Error && error.message.trim()) return error.message.trim();
-  return "Could not reach Gloomberb Cloud.";
+  return "Could not reach Gloom Cloud.";
 }
 
 export function parseDeviceCodeExpiryMs(expiresAt: unknown, now: number): number {

package/src/account/upgrade-dialog.tsx

@@ -74,7 +74,7 @@ export function upgradeDialogCopy(
     const firstCharge = formatTrialEnd(new Date(now.getTime() + days * MS_PER_DAY));
     return {
       title: tf("Try Pro free for {days} days", { days }),
-      subtitle: tf("$0 today, then {price} from {date}. Cancel before and you pay nothing.", {
+      subtitle: tf("$0 today, then {price} from {date}. Card required. Cancel before and you pay nothing.", {
         price,
         date: firstCharge ?? "",
       }),

package/src/api-client/askg.ts

@@ -375,7 +375,7 @@ export function classifyASKGRequestError(error: unknown): ASKGTransportError {
     if (error.status === 426) {
       return new ASKGTransportError(
         "protocol",
-        `Ask Gloom no longer speaks protocol v${ASKG_PROTOCOL_VERSION}. Update Gloomberb.`,
+        `Ask Gloom no longer speaks protocol v${ASKG_PROTOCOL_VERSION}. Update Gloom.`,
         { status: error.status },
       );
     }
@@ -465,7 +465,7 @@ export class CloudASKGApi implements ASKGTransport {
       if (response?.protocolVersion !== ASKG_PROTOCOL_VERSION) {
         throw new ASKGTransportError(
           "protocol",
-          `Ask Gloom speaks protocol v${response?.protocolVersion ?? "?"}, this build speaks v${ASKG_PROTOCOL_VERSION}. Update Gloomberb.`,
+          `Ask Gloom speaks protocol v${response?.protocolVersion ?? "?"}, this build speaks v${ASKG_PROTOCOL_VERSION}. Update Gloom.`,
         );
       }
       return response;

package/src/api-client/auth.ts

@@ -83,7 +83,7 @@ export class CloudAuthApi {
       },
     );
     this.options.requireCapturedSession(
-      "Account created, but Gloomberb could not save the login session. Please try logging in again.",
+      "Account created, but Gloom could not save the login session. Please try logging in again.",
     );
     this.options.setCurrentUser(result.user);
     return result.user;
@@ -98,7 +98,7 @@ export class CloudAuthApi {
       },
     );
     this.options.requireCapturedSession(
-      "Logged in, but Gloomberb could not save the login session. Please try again.",
+      "Logged in, but Gloom could not save the login session. Please try again.",
     );
     this.options.setCurrentUser(result.user);
     return result.user;

package/src/api-client/central-bank-rates.ts

@@ -31,6 +31,12 @@ export interface CentralBankRow {
   confirmationSourceUrl?: string | null
   /** The bank's next decision from its own published calendar, or China's next 1-year LPR fixing (`kind`). */
   nextMeeting: { date: string; sourceUrl: string; verifiedAt: string; kind?: "decision" | "fixing" } | null
+  /**
+   * The bank's latest kept decision (China's LPR fixing) on or before `lastChangeDate`, already announced: when the
+   * move was decided, which the observed change date can trail by days. Null when the kept calendar does not reach back
+   * that far or no change is observed; older servers leave it out.
+   */
+  lastDecision?: { date: string; sourceUrl: string; verifiedAt: string; kind?: "decision" | "fixing" } | null
   /** Why `nextMeeting` is null; older servers leave it out, and a null meeting then reads as not published. */
   nextMeetingStatus?: "scheduled" | "not-published" | "not-verified" | "no-policy-rate"
   /** The BIS series definition and breaks, also in `notes`: history a citation of the latest rate leaves out. */

package/src/api-client/collections.ts

@@ -23,7 +23,11 @@ export class CloudCollectionsApi {
   async putTeamCollectionItem(
     teamId: string,
     collectionId: string,
-    item: { symbol: string; exchange?: string | null; quantity?: number | null; note?: string | null },
+    item: {
+      symbol: string; exchange?: string | null; quantity?: number | null; note?: string | null;
+      /** Left out, the server keeps what it has; a null date clears its date. */
+      dateAcquired?: string | null; currency?: string; costFxRate?: number | null; costFxCurrency?: string | null;
+    },
   ): Promise<TeamCollectionItem> {
     return this.request(`/teams/${encodeURIComponent(teamId)}/collections/${encodeURIComponent(collectionId)}/items`, {
       method: "PUT",

package/src/api-client/cot.ts

@@ -29,6 +29,8 @@ interface CotMarket {
   marketName: string
   exchangeCode: string
   commodityCode: string
+  /** What one contract is, in the CFTC's words: "CONTRACTS OF 100 TROY OUNCES". Null where the report states none. */
+  contractUnits?: string | null
 }
 export interface CotPayloadBase {
   source: "CFTC"

package/src/api-client/crypto-etf-flows.ts

@@ -0,0 +1,37 @@
+/** A spot crypto ETF asset whose daily flows Gloom Cloud serves. */
+export type CryptoEtfFlowAsset = "BTC" | "ETH";
+
+interface CryptoEtfFlowFund {
+  ticker: string;
+  /** The fund's name and issuer where Gloom lists the fund; null for a ticker it does not. */
+  name: string | null;
+  issuer: string | null;
+}
+
+export interface CryptoEtfFlowDay {
+  /** The US trading day, YYYY-MM-DD. */
+  date: string;
+  /** Each fund's net flow that day in US$ millions; null where the publisher shows none. */
+  flows: Record<string, number | null>;
+  /** The day's total as published. */
+  total: number | null;
+  /** Funds that reported the day before but show no figure yet. */
+  pending: string[];
+}
+
+/** `GET /cloud/crypto/etf-flows?asset=btc|eth`: daily net flows of the US spot funds. */
+export interface CryptoEtfFlowsPayload {
+  asset: CryptoEtfFlowAsset;
+  unit: "USD millions";
+  /** The funds in the publisher's order. */
+  funds: CryptoEtfFlowFund[];
+  /** Newest day first. */
+  days: CryptoEtfFlowDay[];
+  /** The newest day listed. */
+  asOf: string;
+  source: { publisher: string; url: string };
+  /** When the publisher's table was last read. */
+  fetchedAt: string;
+  /** No read has succeeded for two days. */
+  stale: boolean;
+}

package/src/api-client/crypto-markets.ts

@@ -143,3 +143,63 @@ export interface StablecoinSupplyHistoryPayload {
   history: { start: string; values: Array<number | null> } | null;
   warnings: string[];
 }
+
+/** DeFi TVL's total, in USD, on the board's as-of day, with its 7D and 30D change. */
+interface DefiTvlTotal {
+  tvl: number;
+  change7d: number | null;
+  change7dPercent: number | null;
+  change30d: number | null;
+  change30dPercent: number | null;
+}
+
+/** A protocol, its versions counted together as the source ranks them (Aave: V3, V2, V4...). */
+export interface DefiTvlProtocol {
+  name: string;
+  /** The category of its largest version: Lending, Liquid Staking, Dexs. */
+  category: string | null;
+  /** How many chains it is deployed on. */
+  chains: number;
+  /** USD, read at the payload's `protocolsAsOf`. */
+  tvl: number;
+  change1dPercent: number | null;
+  change7d: number | null;
+  change7dPercent: number | null;
+  change30d: number | null;
+  change30dPercent: number | null;
+}
+
+export interface DefiTvlChain {
+  name: string;
+  tokenSymbol: string | null;
+  /** USD on the as-of day, from the chain's daily chart. */
+  tvl: number;
+  change7d: number | null;
+  change7dPercent: number | null;
+  change30d: number | null;
+  change30dPercent: number | null;
+  /** Percent of the total DeFi TVL the same day. */
+  share: number | null;
+}
+
+export interface DefiTvlPayload {
+  version: 1;
+  generatedAt: string;
+  /** When the source was last read. */
+  fetchedAt: string | null;
+  /** UTC date of the newest daily total. */
+  asOf: string | null;
+  status: "available" | "stale" | "unavailable";
+  /** Who measures the TVL: its definition of locked value is theirs. */
+  source: { name: string; url: string };
+  total: DefiTvlTotal | null;
+  /** The largest protocols by TVL, largest first. */
+  protocols: DefiTvlProtocol[];
+  /** When the protocols' figures were read: the source's latest, not a daily close. */
+  protocolsAsOf: string | null;
+  /** The largest chains by TVL, largest first. */
+  chains: DefiTvlChain[];
+  /** Total DeFi TVL in USD per UTC day since `start`, its first day with value locked. */
+  history: { start: string; total: Array<number | null> } | null;
+  warnings: string[];
+}