Add testModeBehavior option to SuperwallOptions

[jakemor]

Summary

• Adds TestModeBehavior enum and testModeBehavior property to SuperwallOptions, giving developers explicit control over when test mode activates (.automatic, .whenEnabledForUser, .never, .always)
• Refactors TestModeManager.evaluateTestMode to respect the new option, extracting checkConfigMatch and checkBundleIdMismatch helpers
• Forces shouldBypassAppTransactionCheck = true in test environments so StoreKit checks don't block test runners
• Renames DebugModeBehavior → TestModeBehavior, debugModeBehavior → testModeBehavior, SWKDebugModeBehavior → SWKTestModeBehavior for consistency
• Renames debugOption → testModeOption and isUITestEnvironment → isTestEnvironment
• isTestEnvironment detects all test runners via NSClassFromString("XCTestCase") but bypasses detection when SUPERWALL_UNIT_TESTS launch argument is present, allowing internal unit tests to exercise the .automatic path
• Adds dark branded header with Superwall logo to TestModePurchaseDrawer and replaces hardcoded colors with semantic UIKit colors for dark mode support
• Fixes all SwiftLint violations in TestMode files
• Adds test coverage for all four TestModeBehavior cases

Test plan

• Verify .automatic (default) behavior matches existing behavior for dashboard-enabled users and bundle ID mismatches
• Verify .automatic skips test mode activation when running in external test environments (no SUPERWALL_UNIT_TESTS arg)
• Verify .whenEnabledForUser only activates on dashboard user match, ignoring bundle ID mismatch
• Verify .never prevents test mode from activating even with matching config
• Verify .always enables test mode regardless of config
• Verify shouldBypassAppTransactionCheck is forced true in test environments
• Verify dark mode appearance of TestModePurchaseDrawer in both light and dark modes
• Run existing test suite to confirm no regressions

🤖 Generated with Claude Code

[greptile-apps]

_{6 files reviewed, 3 comments}

_{Edit Code Review Agent Settings | Greptile}