[Live Debugger] Add 10ms snapshot capture timeout circuit breaker

[watson]

Motivation

Snapshot capture in the Live Debugger serializes JavaScript values synchronously by walking object graphs recursively. For large or deeply nested objects, this can block the main thread for an unacceptable amount of time. We need a circuit breaker that aborts capture when it takes too long, preventing the debugger from degrading application performance.

Changes

Adds a 10ms cooperative timeout to the snapshot capture path in the Browser Debugger SDK.

capture.ts

• Introduces a CaptureContext interface (deadline + timedOut flag) threaded through capture(), captureFields(), and all internal recursive helpers.
• Both public functions now require a CaptureContext argument.
• isTimedOut() checks the flag first (fast path), then calls performance.now() against the deadline. Checks are placed at coarse logical boundaries: before each object property, array element, map entry, set item, and typed array element iteration.
• When timed out, captureValue returns { type: <real typeof>, notCapturedReason: 'timeout' }, consistent with how all other Datadog tracers handle notCapturedReason.

api.ts

• Each hook (onEntry, onReturn, onThrow) computes a single deadline before the probe loop and shares it across all probes. This means if one snapshot probe exhausts the budget, subsequent snapshot probes exit immediately, while non-snapshot probes are unaffected.
• When capture times out, the snapshot event is dropped entirely (not sent).

Test instructions

Run the debugger unit tests:

yarn test:unit packages/debugger

Key test scenarios:

• Entry/return/throw capture timeout drops the snapshot
• Non-snapshot probes still fire even after a timeout
• Shared deadline causes second snapshot probe to exit immediately
• No active entry leaks when entry capture times out
• capture() returns the real typeof value (including 'null' not 'object') on timeout

Checklist

• Tested locally
• Tested on staging
• Added unit tests for this change.
• Added e2e/integration tests for this change.
• Updated documentation and/or relevant AGENTS.md file

[watson]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• [Live Debugger] Add 10ms snapshot capture timeout circuit breaker #4512 👈 (View in Graphite)
• Add Live Debugger package #4449 : 5 other dependent PRs (#4480 , #4503 , #4508 and 2 others)
• Fix TanStack Router lint resolution in test app #4513
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[datadog-datadog-prod-us1]

🎉 All green!

❄️ No new flaky tests detected
🧪 All tests passed

🎯 Code Coverage (details)
• Patch Coverage: 67.39%
• Overall Coverage: 76.59% (-0.11%)

_{This comment will be updated automatically if new data arrives.
🔗 Commit SHA: 79c3335 | Docs | Datadog PR Page | Give us feedback!}

[cit-pr-commenter-54b7da]

Bundles Sizes Evolution

📦 Bundle Name	Base Size	Local Size	𝚫	𝚫%	Status
Rum	179.42 KiB	179.42 KiB	0 B	0.00%	✅
Rum Profiler	6.16 KiB	6.16 KiB	0 B	0.00%	✅
Rum Recorder	27.03 KiB	27.03 KiB	0 B	0.00%	✅
Logs	56.80 KiB	56.80 KiB	0 B	0.00%	✅
Rum Slim	135.26 KiB	135.26 KiB	0 B	0.00%	✅
Worker	23.63 KiB	23.63 KiB	0 B	0.00%	✅

🚀 CPU Performance

Action Name	Base CPU Time (ms)	Local CPU Time (ms)	𝚫%
RUM - add global context	0.00545	0.0068	+24.77%
RUM - add action	0.0161	0.0177	+9.94%
RUM - add error	0.013999999999999999	0.0196	+40.00%
RUM - add timing	0.00295	0.0044	+49.15%
RUM - start view	0.01405	0.0183	+30.25%
RUM - start/stop session replay recording	0.0009	0.001	+11.11%
Logs - log message	0.016900000000000002	0.019	+12.43%

🧠 Memory Performance

Action Name	Base Memory Consumption	Local Memory Consumption	𝚫
RUM - add global context	31.53 KiB	31.85 KiB	+323 B
RUM - add action	101.84 KiB	106.22 KiB	+4.38 KiB
RUM - add timing	32.46 KiB	32.72 KiB	+263 B
RUM - add error	104.34 KiB	93.88 KiB	-10.46 KiB
RUM - start/stop session replay recording	32.01 KiB	31.12 KiB	-907 B
RUM - start view	489.22 KiB	485.94 KiB	-3.28 KiB
Logs - log message	99.21 KiB	104.47 KiB	+5.26 KiB

🔗 RealWorld