refactor(auth): address review — accurate toast copy, document state asymmetry, tighten test

- Soften the OAuth-callback-rejected toast: the shape guard is
  defense-in-depth, not full CSRF prevention (PKCE remains primary), so the
  message no longer overstates ("rejecting to prevent a cross-site request" ->
  "did not originate from this session").
- Document the intentional asymmetry between a present-but-malformed `state`
  (rejected) and a wholly absent `state` (accepted, matched via
  OAUTH_PENDING_SERVER_KEY) — rejecting the null case would mask real provider
  error redirects that omit `state`.
- Make the "valid state is not rejected" test assert the specific downstream
  "could not be matched" toast (seeding OAUTH_PENDING_SERVER_KEY) instead of an
  indirect "some toast fired" check.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01S3fTN8H3R8YV4yUGvZjYnX
This commit is contained in:
cliffhall 2026-07-01 19:13:17 -04:00
commit d21da16983

View file

@ -404,6 +404,7 @@ vi.mock("./components/views/InspectorView/InspectorView", () => ({
}));
import App from "./App";
import { OAUTH_PENDING_SERVER_KEY } from "./utils/oauthFlow";
import * as McpIndex from "@inspector/core/mcp/index.js";
import * as FetchLogModule from "@inspector/core/mcp/state/fetchRequestLogState.js";
import { useManagedRequestorTasks } from "@inspector/core/react/useManagedRequestorTasks.js";
@ -1625,9 +1626,16 @@ describe("App OAuth callback state validation", () => {
});
it("does not reject when the state param parses to a valid authId", async () => {
// A well-formed 64-char-hex state is accepted; the handler proceeds past
// the rejection guard (it fails later for other reasons in this harness,
// but never shows the 'OAuth callback rejected' toast).
// A well-formed 64-char-hex state passes the shape guard, so the handler
// proceeds to the server-matching step. With no server registered under the
// seeded pending id, that step surfaces the "could not be matched" toast —
// asserting on that specific downstream toast proves the state was accepted
// (never the "OAuth callback rejected" toast) rather than relying on an
// indirect "some toast fired" check.
window.sessionStorage.setItem(
OAUTH_PENDING_SERVER_KEY,
"server-that-does-not-exist",
);
window.history.replaceState(
{},
"",
@ -1636,7 +1644,13 @@ describe("App OAuth callback state validation", () => {
renderWithMantine(<App />);
await waitFor(() => expect(notificationsMock.show).toHaveBeenCalled());
await waitFor(() =>
expect(notificationsMock.show).toHaveBeenCalledWith(
expect.objectContaining({
title: "OAuth callback could not be matched",
}),
),
);
expect(notificationsMock.show).not.toHaveBeenCalledWith(
expect.objectContaining({ title: "OAuth callback rejected" }),
);