Add public API for checking unhandled exceptions

[jamescrosswell]

Summary

Adds two new public extension methods to SentryEvent:

• IsFromUnhandledException(): Checks if the event is from any unhandled exception
• IsFromTerminalException(): Checks if the event is from a terminal (crash-causing) exception

Motivation

Fixes #2877

Users need to filter events in callbacks like BeforeSend based on whether exceptions are unhandled/terminal. This is particularly useful in MAUI apps where you might want to filter out common exceptions (like network timeouts) but always capture them if they're terminal.

Implementation

Following @bruno-garcia's feedback, this uses extension methods rather than making internal methods public. The methods check both Exception.Data flags and SentryExceptions mechanism properties.

Key differences:

• IsFromUnhandledException: Returns true for any unhandled exception (terminal or non-terminal)
• IsFromTerminalException: Returns true only for unhandled exceptions that are terminal (caused app crash)

Both are well-documented with XML docs and usage examples.

Test Plan

• ✅ Added 14 unit tests covering all scenarios
• ✅ All tests passing on net8.0, net9.0, net10.0
• ✅ Build succeeds on macOS

🤖 Generated with Claude Code

[codecov]

Codecov Report

❌ Patch coverage is 72.72727% with 3 lines in your changes missing coverage. Please review.
✅ Project coverage is 74.07%. Comparing base (32a55e3) to head (220411f).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/Sentry/SentryEventExtensions.cs	72.72%	0 Missing and 3 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #5177      +/-   ##
==========================================
+ Coverage   74.06%   74.07%   +0.01%     
==========================================
  Files         501      502       +1     
  Lines       18113    18124      +11     
  Branches     3521     3527       +6     
==========================================
+ Hits        13415    13425      +10     
+ Misses       3838     3837       -1     
- Partials      860      862       +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 220411f. Configure here.}

[cursor]

Duplicated logic with existing internal methods risks divergence

Low Severity

IsFromUnhandledException() is an exact copy of the private HasUnhandledException() in SentryEvent.cs, and IsFromTerminalException() duplicates the complement of HasUnhandledNonTerminalException(). Both access only public properties (Exception, SentryExceptions), so the private methods could delegate to these new extension methods, eliminating the duplication and the risk of inconsistent future bug fixes.

Additional Locations (1)

• src/Sentry/SentryEventExtensions.cs#L88-L109

 

^{Reviewed by Cursor Bugbot for commit 220411f. Configure here.}