feat(apple): Debug session replay masking

[brustolin]

Explain how to debug masking for session replay.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
changelog	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Feb 28, 2025 1:56pm
develop-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Feb 28, 2025 1:56pm
sentry-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Feb 28, 2025 1:56pm

[brustolin]

I can't add reviewers. @philipphofmann @philprime

[philprime]

@brustolin thanks for the ping

[kahest]

thanks for adding 🙏

[philprime]

@kahest I went ahead and changed the wording of docs, as well as fixed the naming of the methods. Please review and let me know your feedback

[codecov]

Bundle Report

Changes will increase total bundle size by 69.22kB (0.35%) ⬆️. This is within the configured threshold ✅

Detailed changes

Bundle name	Size	Change
sentry-docs-server-cjs	10.27MB	69.23kB (0.68%) ⬆️
sentry-docs-client-array-push	9.39MB	-6 bytes (-0.0%) ⬇️

Affected Assets, Files, and Routes:

view changes for bundle: sentry-docs-server-cjs

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
1729.js	23.08kB	1.48MB	1.58%
../instrumentation.js	23.07kB	814.34kB	2.92%
9523.js	23.08kB	790.54kB	3.01%

view changes for bundle: sentry-docs-client-array-push

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
static/chunks/pages/_app-*.js	-3 bytes	868.04kB	-0.0%
static/chunks/4028-*.js	-3 bytes	393.29kB	-0.0%
static/x7Vcf9N2og4btP-*.js (New)	77 bytes	77 bytes	100.0% 🚀
static/x7Vcf9N2og4btP-*.js (New)	578 bytes	578 bytes	100.0% 🚀
static/dUp2O0QPA85Uqo5biglxW/_buildManifest.js (Deleted)	-578 bytes	0 bytes	-100.0% 🗑️
static/dUp2O0QPA85Uqo5biglxW/_ssgManifest.js (Deleted)	-77 bytes	0 bytes	-100.0% 🗑️

[kahest]

left a couple suggestions to hopefully make the language a bit simpler. also I think we need to be very explicit about what ppl need to do to ensure no preview is ever shown in prod/release app

[philprime]

I checked the source code and AFAIK the SentryMaskingPreviewView is not gated for debug/production builds, therefore the responsibility is delegated to the SDK user.

[kahest]

I checked the source code and AFAIK the SentryMaskingPreviewView is not gated for debug/production builds, therefore the responsibility is delegated to the SDK user.

👍 that's what I expected and meant with my comment - we should make it clear to the user that they need to guard it with some #if DEBUG

[philprime]

Seems I like I forgot to merge this after applying the fixes, will do that now.