feat(observability): group /v1 API spans by domain and endpoint

[thostetler]

Sentry couldn't tell our API calls apart. Client http.client spans only carry the full URL in span.description, so everything grouped on raw descriptions with query strings. The
search.results.render / search.facets.render spans also opened from the shared result list, so they fired on non-search pages too.

1. Tag /v1/* spans in all three runtimes via a beforeSendSpan hook: api.domain (allowlisted backend tier, else other) and api.endpoint (path only, query/fragment stripped).
2. Redact every dynamic path segment
3. Measure the render spans at paint time
4. Gate those spans behind an opt-in measureRenderSpan prop so only the search page emits them, while still counting zero-result searches.

[codecov]

Codecov Report

❌ Patch coverage is 95.57522% with 5 lines in your changes missing coverage. Please review.
✅ Project coverage is 66.0%. Comparing base (e1e3cc5) to head (ad1f40d).
⚠️ Report is 5 commits behind head on master.

Files with missing lines	Patch %	Lines
src/lib/normalizeApiSpan.ts	95.5%	5 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff            @@
##           master    #888     +/-   ##
========================================
+ Coverage    64.2%   66.0%   +1.9%     
========================================
  Files         350     337     -13     
  Lines       41492   40010   -1482     
  Branches     2010    2025     +15     
========================================
- Hits        26602   26376    -226     
+ Misses      14847   13592   -1255     
+ Partials       43      42      -1     

Files with missing lines	Coverage Δ
src/lib/performance.ts	77.5% <100.0%> (-0.7%)	⬇️
src/lib/normalizeApiSpan.ts	95.5% <95.5%> (ø)

... and 41 files with indirect coverage changes

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Copilot]

Pull request overview

This PR improves observability by normalizing Sentry spans for /v1/* API calls (domain + redacted endpoint, no query/fragment) across client/server/edge, and by making search render spans opt-in and measured closer to paint time to avoid emitting search render spans from shared result lists on non-search pages.

Changes:

• Add beforeSendSpan hook (beforeSendApiSpan) to tag /v1/* http.client spans with low-cardinality api.domain + api.endpoint, including dynamic-segment redaction.
• Replace “open in Telemetry / close after paint” render-span flow with a hook-driven paint-timed approach gated behind measureRenderSpan.
• Add Vitest coverage for API span normalization behavior.

Risk summary

Medium risk overall: touches core telemetry and Sentry initialization across runtimes; one confirmed TypeScript compile-time blocker exists.

Findings (priority order)

blocker

• TypeScript compile error from import type { spanToJSON } used with typeof spanToJSON
  • Impact: build fails (new normalizeApiSpan.ts won’t typecheck).
  • Location: src/lib/normalizeApiSpan.ts:1-4
  • Minimal fix: import spanToJSON as a value (or use another exported JSON type).
  • Confidence: high

medium

• useLayoutEffect will trigger SSR warning for server-rendered SimpleResultList

  • Impact: noisy SSR warnings; can hide real SSR issues during debugging.
  • Location: src/lib/useRenderSpan.ts:19-23
  • Minimal fix: use an isomorphic layout effect (layout in browser, effect on server).
  • Confidence: high

• Spans can leak if enabled toggles from true → false while mounted

  • Impact: long-running/never-ended spans skew render timing data.
  • Location: src/lib/useRenderSpan.ts:39-42
  • Minimal fix: when disabled, cancel pending rAF and end/null any open spans.
  • Confidence: high

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/providers.tsx	Removes render-span opening from Telemetry to avoid shared-list emissions.
src/pages/search/index.tsx	Enables render-span measurement only on the search results page.
src/lib/useRenderSpan.ts	Implements paint-timed render spans with opt-in gating.
src/lib/performance.ts	Removes module-level slots for results/facets render spans.
src/lib/normalizeApiSpan.ts	Adds span normalization/tagging for /v1/* http.client spans.
src/lib/normalizeApiSpan.test.ts	Adds unit tests for domain/endpoint parsing and redaction.
src/components/ResultList/SimpleResultList.tsx	Adds measureRenderSpan prop to gate render-span emission.
sentry.server.config.ts	Registers beforeSendSpan normalization hook on server runtime.
sentry.edge.config.ts	Registers beforeSendSpan normalization hook on edge runtime.
sentry.client.config.ts	Registers beforeSendSpan normalization hook on client runtime.