@stigmer/react 3.35.0 → 3.36.0

package/src/licenses/__tests__/license-standing.test.ts

@@ -1,126 +0,0 @@
-// License standing: the time state in the contract's words, the
-// term-relative Expiring window, the renewal fact, the calendar's order
-// and the customer-counting summary. Pins that a 30-day trial is not
-// Expiring on its first day, that a renewed license needs no action, and
-// that a renewed customer counts once.
-
-import { describe, it, expect } from "vitest";
-import { LicenseState, LicenseTerm } from "@stigmer/protos/ai/stigmer/platform/v1/license_pb";
-import {
-  deriveLicenseStandings,
-  deriveTimeState,
-  sortForCalendar,
-  summarizeCalendar,
-} from "../license-standing";
-import { license } from "./fixtures";
-
-const THIRTY_DAY_TRIAL = license({
-  id: "lic_trial",
-  term: LicenseTerm.trial,
-  issuedAt: "2026-09-23T00:00:00Z",
-  expiresAt: "2026-10-23T00:00:00Z",
-});
-
-const trial = (now: string) => deriveTimeState(THIRTY_DAY_TRIAL, new Date(now));
-
-describe("deriveTimeState", () => {
-  it("keeps a 30-day trial active until its last quarter", () => {
-    expect(trial("2026-09-23T00:00:00Z")).toBe(LicenseState.valid);
-    // The window is a quarter of 30 days: 7.5 days before expiry.
-    expect(trial("2026-10-15T00:00:00Z")).toBe(LicenseState.valid);
-    expect(trial("2026-10-16T00:00:00Z")).toBe(LicenseState.expiring);
-  });
-
-  it("caps the window at 30 days for a yearly license", () => {
-    const paid = license({
-      id: "lic_paid",
-      issuedAt: "2026-01-01T00:00:00Z",
-      expiresAt: "2027-01-01T00:00:00Z",
-    });
-    expect(deriveTimeState(paid, new Date("2026-12-01T00:00:00Z"))).toBe(LicenseState.valid);
-    expect(deriveTimeState(paid, new Date("2026-12-02T00:00:00Z"))).toBe(LicenseState.expiring);
-  });
-
-  it("is in grace between expiry and the grace end, then expired", () => {
-    const paid = license({
-      id: "lic_paid",
-      issuedAt: "2026-01-01T00:00:00Z",
-      expiresAt: "2027-01-01T00:00:00Z",
-      graceUntil: "2027-01-31T00:00:00Z",
-    });
-    expect(deriveTimeState(paid, new Date("2027-01-01T00:00:00Z"))).toBe(LicenseState.grace);
-    expect(deriveTimeState(paid, new Date("2027-01-30T23:59:59Z"))).toBe(LicenseState.grace);
-    expect(deriveTimeState(paid, new Date("2027-01-31T00:00:00Z"))).toBe(LicenseState.expired);
-  });
-
-  it("goes straight from expiring to expired with no grace", () => {
-    expect(trial("2026-10-22T23:59:59Z")).toBe(LicenseState.expiring);
-    expect(trial("2026-10-23T00:00:00Z")).toBe(LicenseState.expired);
-  });
-});
-
-describe("deriveLicenseStandings", () => {
-  const first = license({
-    id: "lic_first",
-    term: LicenseTerm.trial,
-    issuedAt: "2026-09-01T00:00:00Z",
-    expiresAt: "2026-10-01T00:00:00Z",
-  });
-  const renewal = license({
-    id: "lic_renewal",
-    issuedAt: "2026-09-25T00:00:00Z",
-    expiresAt: "2027-10-01T00:00:00Z",
-  });
-  const other = license({
-    id: "lic_other",
-    customerId: "cus_globex",
-    customerName: "Globex",
-    issuedAt: "2025-10-01T00:00:00Z",
-    expiresAt: "2026-10-01T00:00:00Z",
-    graceUntil: "2026-10-31T00:00:00Z",
-  });
-  const now = new Date("2026-09-28T00:00:00Z");
-
-  it("marks the license a later one covers past as renewed, whatever its own time state", () => {
-    const standings = deriveLicenseStandings([first, renewal, other], now);
-    expect(standings.get("lic_first")).toMatchObject({
-      timeState: LicenseState.expiring,
-      renewedBy: "lic_renewal",
-      phase: "disabled",
-      label: "Renewed",
-    });
-    expect(standings.get("lic_renewal")).toMatchObject({ renewedBy: undefined, label: "Active", phase: "ready" });
-    expect(standings.get("lic_other")).toMatchObject({ label: "Expiring", phase: "degraded" });
-    expect(standings.get("lic_first")?.reason).toBe("Renewed by a license covering through 2027-09-30");
-  });
-
-  it("orders the calendar: action first, then active, then history", () => {
-    const inGrace = license({
-      id: "lic_grace",
-      customerId: "cus_initech",
-      issuedAt: "2025-09-01T00:00:00Z",
-      expiresAt: "2026-09-20T00:00:00Z",
-      graceUntil: "2026-10-20T00:00:00Z",
-    });
-    const expired = license({
-      id: "lic_expired",
-      customerId: "cus_umbrella",
-      issuedAt: "2025-01-01T00:00:00Z",
-      expiresAt: "2026-01-01T00:00:00Z",
-    });
-    const all = [expired, first, renewal, other, inGrace];
-    const standings = deriveLicenseStandings(all, now);
-    expect(sortForCalendar(all, standings).map((l) => l.metadata?.id)).toEqual([
-      "lic_grace",
-      "lic_other",
-      "lic_renewal",
-      "lic_expired",
-      "lic_first",
-    ]);
-  });
-
-  it("counts customers by their current license", () => {
-    const standings = deriveLicenseStandings([first, renewal, other], now);
-    expect(summarizeCalendar(standings)).toEqual({ active: 1, expiring: 1, grace: 0 });
-  });
-});

package/src/licenses/__tests__/licenseHooks.test.tsx

@@ -1,99 +0,0 @@
-// The licenses hooks' contracts beyond what the console exercises: a
-// disabled or id-less read never calls the server, the ticket-bearing read
-// never lands in the cross-mount fetch cache (a credential must not outlive
-// its view), the list is unwrapped to its entries, a failed issue is both
-// surfaced and rethrown, and every return keeps its reference across
-// renders that change nothing.
-
-import { describe, it, expect, vi, afterEach } from "vitest";
-import { act, cleanup, renderHook, waitFor } from "@testing-library/react";
-import type { ReactNode } from "react";
-import { StigmerError, type LicenseInput } from "@stigmer/sdk";
-import { StigmerContext } from "../../context";
-import { FetchCache } from "../../internal/fetch-cache";
-import { FetchCacheContext } from "../../internal/FetchCacheProvider";
-import { useIssueLicense } from "../useIssueLicense";
-import { useLicense } from "../useLicense";
-import { useLicenses } from "../useLicenses";
-import { license } from "./fixtures";
-
-afterEach(cleanup);
-
-const LICENSE_1 = { id: "lic_1", issuedAt: "2026-09-01T00:00:00Z", expiresAt: "2027-09-01T00:00:00Z" } as const;
-const entry = license(LICENSE_1);
-
-function wrapperFor(client: unknown) {
-  return function Wrapper({ children }: { children: ReactNode }) {
-    return (
-      <FetchCacheContext.Provider value={null}>
-        <StigmerContext.Provider value={client as never}>{children}</StigmerContext.Provider>
-      </FetchCacheContext.Provider>
-    );
-  };
-}
-
-describe("useLicenses", () => {
-  it("unwraps the list to its entries", async () => {
-    const client = { license: { list: vi.fn().mockResolvedValue({ entries: [entry] }) } };
-    const { result } = renderHook(() => useLicenses(), { wrapper: wrapperFor(client) });
-    await waitFor(() => expect(result.current.licenses).toEqual([entry]));
-  });
-
-  it("never calls the server while disabled", () => {
-    const client = { license: { list: vi.fn() } };
-    const { result } = renderHook(() => useLicenses({ enabled: false }), { wrapper: wrapperFor(client) });
-    expect(client.license.list).not.toHaveBeenCalled();
-    expect(result.current.licenses).toBeNull();
-  });
-});
-
-describe("useLicense", () => {
-  it("never writes the ticket-bearing read to the cross-mount fetch cache", async () => {
-    const withTicket = license({ ...LICENSE_1, ticket: "secret.ticket.sig" });
-    const client = { license: { get: vi.fn().mockResolvedValue(withTicket) } };
-    const cache = new FetchCache();
-    const set = vi.spyOn(cache, "set");
-    function Wrapper({ children }: { children: ReactNode }) {
-      return (
-        <FetchCacheContext.Provider value={cache}>
-          <StigmerContext.Provider value={client as never}>{children}</StigmerContext.Provider>
-        </FetchCacheContext.Provider>
-      );
-    }
-
-    const { result } = renderHook(() => useLicense("lic_1"), { wrapper: Wrapper });
-    await waitFor(() => expect(result.current.license?.status?.ticket).toBe("secret.ticket.sig"));
-    expect(set).not.toHaveBeenCalled();
-  });
-
-  it("does not read without an id", () => {
-    const client = { license: { get: vi.fn() } };
-    renderHook(() => useLicense(""), { wrapper: wrapperFor(client) });
-    expect(client.license.get).not.toHaveBeenCalled();
-  });
-});
-
-describe("useIssueLicense", () => {
-  it("surfaces a failed issue and rethrows it to the caller", async () => {
-    const refusal = new StigmerError("already-exists", "license already exists", 6);
-    const client = { license: { create: vi.fn().mockRejectedValue(refusal) } };
-    const { result } = renderHook(() => useIssueLicense(), { wrapper: wrapperFor(client) });
-
-    await act(async () => {
-      await expect(result.current.issue({} as LicenseInput)).rejects.toBe(refusal);
-    });
-    expect(result.current.error).toBe(refusal);
-    expect(result.current.isSubmitting).toBe(false);
-
-    act(() => result.current.clearError());
-    expect(result.current.error).toBeNull();
-  });
-
-  it("keeps its return reference across renders that change nothing", () => {
-    const client = { license: { create: vi.fn() } };
-    const { result, rerender } = renderHook(() => useIssueLicense(), { wrapper: wrapperFor(client) });
-    const first = result.current;
-    rerender();
-    expect(result.current).toBe(first);
-  });
-});

package/src/licenses/__tests__/licenses-console.a11y.test.tsx

@@ -1,116 +0,0 @@
-// Accessibility audit — the licenses console.
-//
-// Covers the populated renewal calendar (the ARIA table, the stretched row
-// buttons, every standing badge), a license's detail with its ticket shown,
-// the issue form (radio groups, the features fieldset, labelled inputs), the
-// empty calendar and the access notice — each in light and dark against the
-// shipped stylesheet, at the settings canvas's width.
-
-import { describe, it, afterEach } from "vitest";
-import { screen } from "@testing-library/react";
-import type { Stigmer } from "@stigmer/sdk";
-import { StigmerError } from "@stigmer/sdk";
-import { Feature } from "@stigmer/protos/ai/stigmer/platform/v1/entitlement_pb";
-import { LicenseTerm } from "@stigmer/protos/ai/stigmer/platform/v1/license_pb";
-import type { License } from "@stigmer/protos/ai/stigmer/billing/license/v1/api_pb";
-import {
-  COLOR_MODES,
-  auditA11y,
-  renderAudited,
-  resetAudit,
-} from "../../__tests__/helpers/a11y-audit.js";
-import { LicensesConsole } from "../LicensesConsole.js";
-import { license } from "./fixtures.js";
-
-const NOW = new Date("2026-09-28T09:00:00Z");
-const CANVAS = { width: 720, height: 900 } as const;
-
-const entries: License[] = [
-  license({
-    id: "lic_trial",
-    term: LicenseTerm.trial,
-    issuedAt: "2026-09-01T00:00:00Z",
-    expiresAt: "2026-10-01T00:00:00Z",
-    maxUsers: 5,
-    maxOrganizations: 1,
-  }),
-  license({
-    id: "lic_paid",
-    issuedAt: "2026-09-25T00:00:00Z",
-    expiresAt: "2027-10-01T00:00:00Z",
-    graceUntil: "2027-10-31T00:00:00Z",
-    maxUsers: 50,
-    features: [Feature.sso_enforcement, Feature.platform_client],
-    notes: "PO 4411",
-    ticket: "eyJhbGciOiJFZERTQSIsImtpZCI6ImxpY2Vuc2Utc2lnbmluZzp2MSJ9.payload.signature",
-  }),
-  license({
-    id: "lic_globex",
-    customerId: "cus_globex",
-    customerName: "Globex",
-    contactEmail: "it@globex.test",
-    issuedAt: "2025-09-01T00:00:00Z",
-    expiresAt: "2026-09-20T00:00:00Z",
-    graceUntil: "2026-10-20T00:00:00Z",
-  }),
-];
-
-function clientWith(list: () => Promise<{ entries: License[] }>): Stigmer {
-  return {
-    license: {
-      list,
-      get: async (id: string) => entries.find((e) => e.metadata?.id === id),
-      create: async () => entries[1],
-    },
-  } as unknown as Stigmer;
-}
-
-const populated = () => clientWith(async () => ({ entries }));
-
-afterEach(resetAudit);
-
-describe("Licenses console a11y", () => {
-  it.each(COLOR_MODES)("renewal calendar (%s)", async (mode) => {
-    const container = renderAudited(<LicensesConsole now={NOW} />, mode, { ...CANVAS, client: populated() });
-    await screen.findByRole("table", { name: "Licenses" });
-    await auditA11y(container, `licenses calendar · ${mode}`);
-  });
-
-  it.each(COLOR_MODES)("license detail with the ticket shown (%s)", async (mode) => {
-    const container = renderAudited(<LicensesConsole now={NOW} />, mode, { ...CANVAS, client: populated() });
-    const rows = await screen.findAllByRole("button", { name: "Acme Corp" });
-    rows[0]!.click();
-    const show = await screen.findByRole("button", { name: /Show ticket/ });
-    await screen.findByRole("button", { name: /Copy ticket/ });
-    show.click();
-    await screen.findByText(/payload\.signature/);
-    await auditA11y(container, `license detail · ${mode}`);
-  });
-
-  it.each(COLOR_MODES)("issue form (%s)", async (mode) => {
-    const container = renderAudited(<LicensesConsole now={NOW} />, mode, { ...CANVAS, client: populated() });
-    (await screen.findByRole("button", { name: /Issue license/ })).click();
-    await screen.findByRole("heading", { name: "Issue license" });
-    await auditA11y(container, `issue form · ${mode}`);
-  });
-
-  it.each(COLOR_MODES)("empty calendar (%s)", async (mode) => {
-    const container = renderAudited(<LicensesConsole now={NOW} />, mode, {
-      ...CANVAS,
-      client: clientWith(async () => ({ entries: [] })),
-    });
-    await screen.findByText("No licenses issued yet");
-    await auditA11y(container, `licenses empty · ${mode}`);
-  });
-
-  it.each(COLOR_MODES)("access notice (%s)", async (mode) => {
-    const container = renderAudited(<LicensesConsole now={NOW} />, mode, {
-      ...CANVAS,
-      client: clientWith(async () => {
-        throw new StigmerError("permission-denied", "only platform operators can view licenses", 7);
-      }),
-    });
-    await screen.findByText("Platform operator access required");
-    await auditA11y(container, `licenses access notice · ${mode}`);
-  });
-});

package/src/manifest/__tests__/ApplyManifestDialog.test.tsx

@@ -1,147 +0,0 @@
-// Tests for ApplyManifestDialog's onApplied contract — the refresh
-// signal every Library list page wires to appear-without-reload. It must
-// fire on full success AND when the operator dismisses the dialog after a
-// partial apply (some documents applied, a later one failed), and must
-// never fire when nothing applied. Historically onApplied's predecessor
-// had zero coverage and stayed unwired at every call site; this locks the
-// contract the list pages now depend on.
-
-import { describe, it, expect, vi, beforeAll, afterEach } from "vitest";
-import { render, screen, cleanup, fireEvent, waitFor } from "@testing-library/react";
-import { ApplyManifestDialog } from "../ApplyManifestDialog";
-import type {
-  ManifestPreviewEntry,
-  UseApplyManifestReturn,
-} from "../useApplyManifest";
-
-beforeAll(() => {
-  HTMLDialogElement.prototype.showModal = function showModal() {
-    this.open = true;
-  };
-  HTMLDialogElement.prototype.close = function close() {
-    this.open = false;
-  };
-});
-
-afterEach(() => {
-  cleanup();
-  vi.restoreAllMocks();
-});
-
-// A preview entry in a chosen terminal status; the document shape is only
-// what the dialog's preview row and apply flow read.
-function entry(
-  slug: string,
-  status: ManifestPreviewEntry["status"],
-): ManifestPreviewEntry {
-  return {
-    document: {
-      handler: { yamlKind: "mcpserver", displayName: "McpServer" },
-      name: slug,
-      slug,
-      org: "acme",
-    },
-    action: "create",
-    status,
-  } as ManifestPreviewEntry;
-}
-
-// The mock's mutable knobs: the entries the hook exposes and the terminal
-// entries applyAll resolves to. Set per test before rendering.
-let mockEntries: readonly ManifestPreviewEntry[] | null;
-let applyAllResult: readonly ManifestPreviewEntry[];
-const applyAllMock = vi.fn(async () => applyAllResult);
-
-vi.mock("../useApplyManifest", () => ({
-  useApplyManifest: (): UseApplyManifestReturn =>
-    ({
-      content: "kind: McpServer",
-      setContent: vi.fn(),
-      readFile: vi.fn(),
-      entries: mockEntries,
-      validationError: null,
-      isValidating: false,
-      hasRedactedSecrets: false,
-      applyAll: applyAllMock,
-      isApplying: false,
-      reset: vi.fn(),
-    }) as UseApplyManifestReturn,
-}));
-
-// CodeMirror stays out of the test environment.
-vi.mock("../YamlEditor", () => ({
-  YamlEditor: () => <div data-testid="yaml-editor" />,
-}));
-
-describe("ApplyManifestDialog — onApplied", () => {
-  it("fires with the applied entries on full success and closes", async () => {
-    mockEntries = [entry("a", "pending"), entry("b", "pending")];
-    applyAllResult = [entry("a", "applied"), entry("b", "applied")];
-    const onApplied = vi.fn();
-    const onOpenChange = vi.fn();
-
-    render(
-      <ApplyManifestDialog
-        open
-        onOpenChange={onOpenChange}
-        org="acme"
-        onApplied={onApplied}
-      />,
-    );
-
-    fireEvent.click(screen.getByRole("button", { name: /apply/i }));
-
-    await waitFor(() => expect(onApplied).toHaveBeenCalledTimes(1));
-    expect(
-      onApplied.mock.calls[0][0].map((e: ManifestPreviewEntry) => e.document.slug),
-    ).toEqual(["a", "b"]);
-    expect(onOpenChange).toHaveBeenCalledWith(false);
-  });
-
-  it("fires with only the applied subset when a partial apply is dismissed", async () => {
-    // Applied one, failed the next — the dialog stays open on failure.
-    mockEntries = [entry("a", "applied"), entry("b", "failed")];
-    applyAllResult = [entry("a", "applied"), entry("b", "failed")];
-    const onApplied = vi.fn();
-    const onOpenChange = vi.fn();
-
-    render(
-      <ApplyManifestDialog
-        open
-        onOpenChange={onOpenChange}
-        org="acme"
-        onApplied={onApplied}
-      />,
-    );
-
-    // Apply first: full success did not happen, so onApplied has not fired.
-    fireEvent.click(screen.getByRole("button", { name: /apply/i }));
-    await waitFor(() => expect(applyAllMock).toHaveBeenCalled());
-    expect(onApplied).not.toHaveBeenCalled();
-
-    // Dismiss with an applied entry present → refresh the list.
-    fireEvent.click(screen.getByRole("button", { name: "Cancel" }));
-    expect(onApplied).toHaveBeenCalledTimes(1);
-    expect(
-      onApplied.mock.calls[0][0].map((e: ManifestPreviewEntry) => e.document.slug),
-    ).toEqual(["a"]);
-    expect(onOpenChange).toHaveBeenCalledWith(false);
-  });
-
-  it("does not fire when the dialog is dismissed with nothing applied", () => {
-    mockEntries = [entry("a", "pending")];
-    const onApplied = vi.fn();
-
-    render(
-      <ApplyManifestDialog
-        open
-        onOpenChange={vi.fn()}
-        org="acme"
-        onApplied={onApplied}
-      />,
-    );
-
-    fireEvent.click(screen.getByRole("button", { name: "Cancel" }));
-    expect(onApplied).not.toHaveBeenCalled();
-  });
-});

package/src/manifest/__tests__/EditResourceYamlDialog.test.tsx

@@ -1,118 +0,0 @@
-// Tests for the shared Edit-YAML dialog's apply-error affordance
-// (DD-008 SD-6): the server's refusal renders verbatim with
-// Try-again/Dismiss — shared by every kind (McpServer, Agent, Skill),
-// so any apply-time guard gets the same acknowledge-and-retry
-// treatment.
-
-import { describe, it, expect, vi, beforeAll, afterEach } from "vitest";
-import { render, screen, cleanup, fireEvent } from "@testing-library/react";
-import { create } from "@bufbuild/protobuf";
-import { McpServerSchema } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
-import { EditResourceYamlDialog } from "../EditResourceYamlDialog";
-import type { useEditResourceYaml } from "../useEditResourceYaml";
-
-beforeAll(() => {
-  HTMLDialogElement.prototype.showModal = function showModal() {
-    this.open = true;
-  };
-  HTMLDialogElement.prototype.close = function close() {
-    this.open = false;
-  };
-});
-
-afterEach(() => {
-  cleanup();
-  vi.restoreAllMocks();
-});
-
-type EditState = ReturnType<typeof useEditResourceYaml>;
-
-const applyMock = vi.fn();
-const clearErrorMock = vi.fn();
-
-let editState: Partial<EditState>;
-
-vi.mock("../useEditResourceYaml", () => ({
-  useEditResourceYaml: () => ({
-    yaml: "kind: McpServer",
-    setYaml: vi.fn(),
-    validation: { status: "valid" as const },
-    target: { action: "update" as const, slug: "clinic" },
-    isDirty: true,
-    isApplying: false,
-    error: null,
-    clearError: clearErrorMock,
-    apply: applyMock,
-    reset: vi.fn(),
-    hasRedactedSecrets: false,
-    ...editState,
-  }),
-}));
-
-// CodeMirror stays out of the test environment.
-vi.mock("../YamlEditor", () => ({
-  YamlEditor: () => <div data-testid="yaml-editor" />,
-}));
-
-const RESOURCE = create(McpServerSchema, {
-  metadata: { id: "mcp_1", slug: "clinic", org: "acme", name: "Clinic" },
-});
-
-function renderDialog() {
-  return render(
-    <EditResourceYamlDialog
-      open
-      onOpenChange={vi.fn()}
-      resource={RESOURCE}
-      onApplied={vi.fn()}
-    />,
-  );
-}
-
-describe("EditResourceYamlDialog — apply-error affordance", () => {
-  it("renders the server's refusal verbatim with Try again and Dismiss", () => {
-    editState = {
-      error: new Error(
-        'spec change refused by an apply-time guard; re-apply with the change acknowledged',
-      ),
-    };
-    renderDialog();
-
-    const alert = screen.getByRole("alert");
-    expect(alert.textContent).toContain(
-      "spec change refused by an apply-time guard",
-    );
-    expect(screen.getByRole("button", { name: "Try again" })).toBeTruthy();
-    expect(screen.getByRole("button", { name: "Dismiss error" })).toBeTruthy();
-  });
-
-  it("Try again re-invokes apply without reopening the dialog", () => {
-    editState = { error: new Error("guard refused") };
-    renderDialog();
-
-    fireEvent.click(screen.getByRole("button", { name: "Try again" }));
-    expect(applyMock).toHaveBeenCalled();
-  });
-
-  it("Dismiss clears the error state", () => {
-    editState = { error: new Error("guard refused") };
-    renderDialog();
-
-    fireEvent.click(screen.getByRole("button", { name: "Dismiss error" }));
-    expect(clearErrorMock).toHaveBeenCalled();
-  });
-
-  it("Try again is disabled while a retry is already in flight", () => {
-    editState = { error: new Error("guard refused"), isApplying: true };
-    renderDialog();
-
-    const retry = screen.getByRole("button", { name: "Try again" }) as HTMLButtonElement;
-    expect(retry.disabled).toBe(true);
-  });
-
-  it("renders no error affordances when healthy", () => {
-    editState = {};
-    renderDialog();
-    expect(screen.queryByRole("button", { name: "Try again" })).toBeNull();
-  });
-});