Allow auto termination of spans

[fractalwrench]

Goal

Implements auto-termination of spans. This is achieved by checking whether a span has AutoTerminationMode.ON_BACKGROUND just before the session payload is constructed, and terminating it and its descendants if this is true.

Testing

Added integration tests.

[codecov]

Codecov Report

Attention: Patch coverage is 92.59259% with 2 lines in your changes missing coverage. Please review.

Project coverage is 85.42%. Comparing base (56eb868) to head (e880753).
Report is 2 commits behind head on main.

Files with missing lines	Patch %	Lines
...ndroid/embracesdk/internal/spans/SpanRepository.kt	90.47%	0 Missing and 2 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1748      +/-   ##
==========================================
+ Coverage   85.29%   85.42%   +0.12%     
==========================================
  Files         464      464              
  Lines       10791    10818      +27     
  Branches     1595     1601       +6     
==========================================
+ Hits         9204     9241      +37     
+ Misses        870      860      -10     
  Partials      717      717              

Files with missing lines	Coverage Δ
...ernal/envelope/session/SessionPayloadSourceImpl.kt	100.00% <100.00%> (ø)
...esdk/internal/injection/PayloadSourceModuleImpl.kt	97.46% <100.00%> (+0.06%)	⬆️
...ndroid/embracesdk/internal/spans/SpanRepository.kt	90.19% <90.47%> (+0.19%)	⬆️

... and 6 files with indirect coverage changes

[bidetofevil]

Will you be adding unit tests that verify this works with different edge-case combinations of descendants which might change the traversal logic? Like if a child is no longer active, but the grand child is active?

[bidetofevil]

LGTM. Question about adding more test cases for different combinations of span states. We need to make sure that after backgrounding, all active spans belonging to traces whose root as auto terminate configured will be terminated, irrespective of the state of its ancestors.

[github-actions]

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

OpenSSF Scorecard

Package	Version	Score	Details

Scanned Files

[fractalwrench]

@bidetofevil I added some extra test cases to the integration test & made some slight tweaks to the implementation, so putting this out for review again.

[bidetofevil]

LGTM