Hubs/Scopes Merge 1 - Introduce IScopes interface.

[adinauer]

#skip-changelog

📜 Description

Tests on this PR will likely fail, there's more PRs migrating IHub references to IScopes and fixing tests.

TODO: this should target a new branch for a new major release.

• Introduce IScopes
• IHub extends IScopes so any Hub can be passed in as IScopes. All methods on IHub have been moved to IScopes.
• IHub and methods tied to it like getCurrentHub, cloneMainHub and clone have been deprecated.
  • For API that still returns an IHub we're wrapping IScopes using HubScopesWrapper
• In a follow up PR we'll introduce Scopes as a replacement for Hub
• Added ScopesAdapter as a replacement for HubAdapter
• Sentry.getCurrentScopes() replaces Sentry.getCurrentHub()
• Sentry.cloneMainHub() will be replaced in a follow up PR by something like Sentry.forkRootScopes() or similar.
• There's plenty of TODO comments in this PR that have to be cleaned up in follow up PRs.

Follow up PRs for changing from IHub to IScopes:

• Hubs/Scopes Merge 2 - Replace IHub with IScopes in core #3298
• Hubs/Scopes Merge 3 - Replace IHub with IScopes in Android core #3299
• Hubs/Scopes Merge 4 - Replace IHub with IScopes in Android integrations #3300
• Hubs/Scopes Merge 5 - Replace IHub with IScopes in apollo integrations #3301
• Hubs/Scopes Merge 6 - Replace IHub with IScopes in OkHttp integration #3302
• Hubs/Scopes Merge 7 - Replace IHub with IScopes in GraphQL integration #3303
• Hubs/Scopes Merge 8 - Replace IHub with IScopes in logging integrations #3304
• Hubs/Scopes Merge 9 - Replace IHub with IScopes in more integrations #3305
• Hubs/Scopes Merge 10 - Replace IHub with IScopes in OTel integration #3306
• Hubs/Scopes Merge 11 - Replace IHub with IScopes in Spring 5 / Spring Boot 2 integrations #3308
• Hubs/Scopes Merge 12 - Replace IHub with IScopes in Spring 6 / Spring Boot 3 integrations #3309
• Hubs/Scopes Merge 13 - Replace IHub with IScopes in samples #3310

💡 Motivation and Context

This is the first PR of many to merge hubs and scopes which is a prerequisite for Performance powered by OpenTelemetry.

💚 How did you test it?

📝 Checklist

• I reviewed the submitted code.
• I added tests to verify the changes.
• No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled.
• I updated the docs if needed.
• Review from the native team if needed.
• No breaking change or entry added to the changelog.
• No breaking change for hybrid SDKs or communicated to hybrid SDKs.

🔮 Next steps

[github-actions]

	Messages
📖	Do not forget to update Sentry-docs with your feature once the pull request gets approved.

Generated by 🚫 dangerJS against 27f2398

[lbloder]

Commented on three instances where the HubScopesWrapper could be used to make it compile when -Werror is disabled.

Otherwise LGTM 👍

[lbloder]

Replace IHub with IScopes

[markushi]

Is there a specific reason we name it plural IScopes instead of IScope?

[adinauer]

IScope is already present (i.e. the scope) and IScopes is a set of multiple scopes (isolation scope and current scope) which (sometimes) fork together or separately. IScopes (and Scopes) is meant to be a drop-in replacement for hub.

[markushi]

Given that we'll do a major bump I guess it's worth considering removing deprecated methods.

[adinauer]

Created #3364 to track and added it to 8.0.0 milestone.