[0.17] ref!: sentry_value-based attachments

[jpnurmi]

Caution

BREAKING CHANGE

Attachment APIs now use sentry_value_t and sentry_uuid_t instead of sentry_attachment_t *.

Scope data is moving to fine-grained read/write locking (#1877) to allow concurrent readers. A read-locked getter cannot safely return a borrowed sentry_attachment_t pointer because a writer may remove and free the attachment as soon as the read lock is released, crashing a potential concurrent reader.

Represent attachments and attachment collections as refcounted sentry_value_t objects. A getter can retain the value under the read lock and return an owned reference that remains valid after unlocking.

Configure attachments before insertion and freeze them once added. Use UUIDs for removal, and retain byte values while envelopes borrow their payload to avoid copying attachment data.

See also:

• [WIP] ref(native): port attachments to value-based API sentry-godot#873
• [WIP] ref(native): port attachments to value-based API sentry-unreal#1540
• https://github.com/getsentry/sentry-playstation/pull/160

Resolves: #1945

[codecov]

Codecov Report

❌ Patch coverage is 72.17806% with 175 lines in your changes missing coverage. Please review.
✅ Project coverage is 74.60%. Comparing base (dec0e5e) to head (20c5112).

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1974      +/-   ##
==========================================
+ Coverage   74.24%   74.60%   +0.36%     
==========================================
  Files         104      104              
  Lines       26584    26786     +202     
  Branches     4838     4860      +22     
==========================================
+ Hits        19736    19985     +249     
+ Misses       5499     5455      -44     
+ Partials     1349     1346       -3     

🚀 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 08e8f8c. Configure here.}