refactor: O11Y-957 - Refactor error handling and state management in replay exporter

[agrognetti]

Summary

Replaces try/catch-based error handling in SessionReplayApiService with a throwOnErrors helper that throws a custom exception on GraphQL errors. Refactors SessionReplayEventGenerator to support state snapshot/restore for reliable retries, and updates SessionReplayExporter to snapshot and restore state on failure, ensuring event and payload ID consistency. Also improves naming and documentation for clarity.

---

Note

Improves reliability and observability of replay and sampling flows by adding structured logging, centralized GraphQL error handling, and resilient state management with rollback on failures.

• GraphQLClient: accepts LDLogger; logs GraphQL errors via logErrors; all call sites (e.g., InstrumentationManager, SessionReplayExporter) pass the logger
• Sampling: SamplingApiService minor cleanup (const path, remove local error printing)
• Replay API: replace try/catch logging with throwOnErrors(...) and a SessionReplayApiException; all operations now surface GraphQL errors
• Event generation: SessionReplayEventGenerator adds sid/canvas state snapshot/restore (getState/restoreState), renames fields for clarity
• Exporter: SessionReplayExporter now takes a logger, snapshots and restores internal state on exceptions (including payload IDs and generator state) for consistent retries; logs identify failures; minor naming tidy-ups
• Replay instrumentation: wires logger into SessionReplayExporter
• Tests: updated to accommodate logger in GraphQLClient/SessionReplayExporter and new behaviors

^{Written by Cursor Bugbot for commit 8c79eda. This will update automatically on new commits. Configure here.}

[abelonogov-ld]

Nice it also fixes offline