test(integrations): pin the Withings plan handling and the Oura scope gap; document the plan change

src/components/settings/integrations/__tests__/oauth-provider-card.test.tsx

@@ -232,3 +232,43 @@ describe("OAuthProviderCard — sync-now action", () => {
     ).not.toContain('data-testid="polar-sync"');
   });
 });
+
+describe("OAuthProviderCard — Oura scope note", () => {
+  const scopeGap = {
+    connected: true,
+    configured: true,
+    available: true,
+    state: "connected" as const,
+    lastSuccessAt: "2026-10-14T00:00:00.000Z",
+    lastError: null,
+    syncHealth: { verdict: "fresh" as const, since: null },
+    scopeReconnect: ["spo2" as const, "vo2max" as const],
+  };
+
+  function renderOura(viewModel: ViewModel) {
+    return renderToStaticMarkup(
+      <I18nProvider initialLocale="en">
+        <OAuthProviderCard
+          provider="oura"
+          statusQueryKey={["oura"]}
+          i18nPrefix="settings.oura"
+          icon={Watch}
+          dataHref="/insights/sleep"
+          viewModel={viewModel}
+          callbackUrl="https://app.example/api/oura/callback"
+        />
+      </I18nProvider>,
+    );
+  }
+
+  it("asks for one reconnect beside a healthy pill, not an error", () => {
+    const html = renderOura(scopeGap);
+    expect(html).toContain('data-testid="oura-scope-note"');
+    expect(html).toContain("Reconnect Oura once to allow SpO2 and VO2 max.");
+    expect(html).not.toContain('data-testid="oura-error"');
+  });
+
+  it("stays away from the other OAuth providers", () => {
+    expect(render({ viewModel: scopeGap })).not.toContain("scope-note");
+  });
+});

src/components/settings/integrations/__tests__/plan-and-scope-notes.test.tsx

@@ -0,0 +1,65 @@
+/**
+ * The two "withheld by contract" notes: the Withings card names what the
+ * account's API plan refuses, the Oura card asks for one reconnect when the
+ * grant lacks a scope. Both render nothing when nothing is withheld, and both
+ * render the server-resolved list rather than deriving one.
+ */
+import { describe, expect, it, vi } from "vitest";
+import { renderToStaticMarkup } from "react-dom/server";
+
+import { I18nProvider } from "@/lib/i18n/context";
+import { WithingsPlanNote } from "../withings-plan-note";
+import { OuraScopeNote } from "../oura-scope-note";
+
+function render(node: React.ReactNode, locale: "en" | "de" = "en") {
+  return renderToStaticMarkup(
+    <I18nProvider initialLocale={locale}>{node}</I18nProvider>,
+  );
+}
+
+describe("<WithingsPlanNote>", () => {
+  it("lists the withheld readings and links the Withings plans page", () => {
+    const html = render(
+      <WithingsPlanNote features={["spo2", "vascularAge", "ecg"]} />,
+    );
+    expect(html).toContain('data-testid="withings-plan-note"');
+    expect(html).toContain("SpO2, vascular age, and ECG and AFib");
+    expect(html).toContain("Weight, blood pressure, body composition");
+    expect(html).toContain(
+      "https://static.withings.com/content/api/plans/plans.html",
+    );
+  });
+
+  it("speaks the reader's language", () => {
+    const html = render(<WithingsPlanNote features={["vascularAge"]} />, "de");
+    expect(html).toContain("Gefäßalter");
+    expect(html).toContain("kostenpflichtigen API-Plan");
+  });
+
+  it("renders nothing when the plan withholds nothing", () => {
+    expect(render(<WithingsPlanNote features={[]} />)).toBe("");
+    expect(render(<WithingsPlanNote features={undefined} />)).toBe("");
+  });
+});
+
+describe("<OuraScopeNote>", () => {
+  it("asks for one reconnect naming the collections the grant lacks", () => {
+    const html = render(
+      <OuraScopeNote
+        collections={["spo2", "vo2max", "cardio_age", "resilience"]}
+        onReconnect={vi.fn()}
+      />,
+    );
+    expect(html).toContain('data-testid="oura-scope-note"');
+    expect(html).toContain(
+      "Reconnect Oura once to allow SpO2, VO2 max, cardiovascular age, and resilience.",
+    );
+    expect(html).toContain('data-testid="oura-scope-reconnect"');
+  });
+
+  it("renders nothing when the grant covers everything", () => {
+    expect(
+      render(<OuraScopeNote collections={[]} onReconnect={vi.fn()} />),
+    ).toBe("");
+  });
+});