feat(android): update for 2.7.4

content/docs/android/changelog.mdx

@@ -3,6 +3,20 @@ title: "Changelog"
 description: "Release notes for the Superwall Android SDK"
 ---
 
+## 2.7.4
+
+### Enhancements
+
+- Adds support for "Test Mode", which allows you to simulate in-app purchases without involving Google Play. Test Mode can be enabled through the Superwall dashboard by marking specific users as test store users, or activates automatically when a an application ID mismatch is detected or behavior is set to `ALWAYS`. When active, a configuration modal lets you select starting entitlements and override free trial availability. Purchases are simulated with a UI that lets users complete, abandon, or fail transactions, with all purchase events firing normally for end-to-end paywall testing.
+- Improved logging in web entitlement and entitlement redeeming for easier debugging
+- Adds active entitlements to subscription status change event
+- Ensures purchases are always queried with connected clients and retried in background
+- Adds `expirationDate`, `subscriptionGroupId` and `offerId` to `StoreTransactionType`
+
+### Fixes
+
+- Improve rounding to match editor's pricing consistently
+
 ## 2.7.3
 
 ### Enhancements

content/docs/android/index.mdx

@@ -42,4 +42,4 @@ If you have feedback on any of our docs, please leave a rating and message at th
 
 If you have any issues with the SDK, please [open an issue on GitHub](https://github.com/superwall/superwall-android/issues).
 
-<SdkLatestVersion version="2.7.3" repoUrl="https://github.com/superwall/Superwall-Android" />
+<SdkLatestVersion version="2.7.4" repoUrl="https://github.com/superwall/Superwall-Android" />

content/docs/android/quickstart/install.mdx

@@ -20,16 +20,16 @@ can find the [latest release here](https://github.com/superwall/Superwall-Androi
 <CodeGroup>
 
 ```gradle build.gradle
-implementation "com.superwall.sdk:superwall-android:2.7.3"
+implementation "com.superwall.sdk:superwall-android:2.7.4"
 ```
 
 ```kotlin build.gradle.kts
-implementation("com.superwall.sdk:superwall-android:2.7.3")
+implementation("com.superwall.sdk:superwall-android:2.7.4")
 ```
 
 ```toml libs.version.toml
 [libraries]
-superwall-android = { group = "com.superwall.sdk", name = "superwall-android", version = "2.7.3" }
+superwall-android = { group = "com.superwall.sdk", name = "superwall-android", version = "2.7.4" }
 
 // And in your build.gradle.kts
 dependencies {

content/docs/android/sdk-reference/SuperwallEvent.mdx

@@ -86,8 +86,45 @@ sealed class SuperwallEvent {
 
     object SubscriptionStatusDidChange : SuperwallEvent()
 
+    // Restore events
+    sealed class Restore : SuperwallEvent() {
+        object Start : Restore()
+        data class Fail(val error: String) : Restore()
+        object Complete : Restore()
+    }
+
+    // Customer and permission events
+    data class CustomerInfoDidChange(
+        val from: CustomerInfo,
+        val to: CustomerInfo
+    ) : SuperwallEvent()
+    data class PermissionRequested(
+        val permissionName: String,
+        val paywallIdentifier: String
+    ) : SuperwallEvent()
+    data class PermissionGranted(
+        val permissionName: String,
+        val paywallIdentifier: String
+    ) : SuperwallEvent()
+    data class PermissionDenied(
+        val permissionName: String,
+        val paywallIdentifier: String
+    ) : SuperwallEvent()
+
+    // Preloading events
+    data class PaywallPreloadStart(val paywallIdentifier: String) : SuperwallEvent()
+    data class PaywallPreloadComplete(val paywallCount: Int) : SuperwallEvent()
+
+    // Test mode events
+    class TestModeModalOpen : SuperwallEvent()
+    class TestModeModalClose : SuperwallEvent()
+
     // System events
     data class DeviceAttributes(val attributes: Map<String, Any>) : SuperwallEvent()
+    data class SurveyResponse(val survey: Survey, val selectedOption: SurveyOption, val customResponse: String?, val paywallInfo: PaywallInfo) : SuperwallEvent()
+    class SurveyClose : SuperwallEvent()
+    data class CustomPlacement(val name: String, val params: Map<String, Any>, val paywallInfo: PaywallInfo) : SuperwallEvent()
+    object Reset : SuperwallEvent()
 
     // And more...
 }
@@ -115,43 +152,3 @@ This is a sealed class that represents different event types. Events are receive
 
 These events are received via [`SuperwallDelegate.handleSuperwallEvent(eventInfo)`](/android/sdk-reference/SuperwallDelegate) for forwarding to your analytics platform.
 
-## Deprecations in 2.7.0
-
-- `PaywallWebviewLoadTimeout` is deprecated. This event was causing confusion due to its naming and has been removed from internal tracking. It will no longer fire.
-
-## New events in 2.6.6+
-
-- `CustomerInfoDidChange` fires whenever the SDK merges device, web, and external purchase controller data into a new [`CustomerInfo`](/android/quickstart/tracking-subscription-state#reading-detailed-purchase-history-2-6-6) snapshot. The event includes the previous and next objects so you can diff entitlements or transactions.
-- `PermissionRequested`, `PermissionGranted`, and `PermissionDenied` correspond to the new **Request permission** action in the paywall editor. Each event carries the `permissionName` and `paywallIdentifier`.
-- `PaywallPreloadStart` and `PaywallPreloadComplete` track when preloading kicks off and how many paywalls finished warming the cache.
-
-Example handler:
-
-```kotlin
-override fun handleSuperwallEvent(eventInfo: SuperwallEventInfo) {
-    when (val event = eventInfo.event) {
-        is SuperwallEvent.CustomerInfoDidChange -> {
-            analytics.track("customer_info_updated", mapOf(
-                "old_products" to event.from.activeSubscriptionProductIds.joinToString(),
-                "new_products" to event.to.activeSubscriptionProductIds.joinToString()
-            ))
-        }
-        is SuperwallEvent.PermissionRequested -> {
-            analytics.track("permission_requested", mapOf(
-                "permission" to event.permissionName,
-                "paywall_id" to event.paywallIdentifier
-            ))
-        }
-        is SuperwallEvent.PermissionGranted -> {
-            featureFlags.unlock(event.permissionName)
-        }
-        is SuperwallEvent.PermissionDenied -> {
-            showPermissionHelpSheet(event.permissionName)
-        }
-        is SuperwallEvent.PaywallPreloadComplete -> {
-            Logger.i("Superwall", "Preloaded ${event.paywallCount} paywalls")
-        }
-        else -> Unit
-    }
-}
-```

content/docs/android/sdk-reference/SuperwallOptions.mdx

@@ -31,6 +31,7 @@ class SuperwallOptions {
     var enableExperimentalDeviceVariables: Boolean = false
     var logging: Logging = Logging()
     var useMockReviews: Boolean = false
+    var testModeBehavior: TestModeBehavior = TestModeBehavior.AUTOMATIC
 }
 ```
 
@@ -47,6 +48,7 @@ public class SuperwallOptions {
     public boolean enableExperimentalDeviceVariables = false;
     public Logging logging = new Logging();
     public boolean useMockReviews = false;
+    public TestModeBehavior testModeBehavior = TestModeBehavior.AUTOMATIC;
 }
 ```
 
@@ -106,6 +108,11 @@ public class SuperwallOptions {
       description: "Shows mock Google Play review dialogs for testing.",
       required: true,
     },
+    testModeBehavior: {
+      type: "TestModeBehavior",
+      description: "Controls when test mode activates. `AUTOMATIC` enables test mode when an application ID mismatch is detected. `WHEN_ENABLED_FOR_USER` only activates when the user is marked as a test store user in the dashboard. `ALWAYS` forces test mode on. `NEVER` disables it entirely.",
+      default: "AUTOMATIC",
+    },
   }}
 />
 

content/docs/android/sdk-reference/index.mdx

@@ -15,4 +15,4 @@ If you have feedback on any of our docs, please leave a rating and message at th
 
 If you have any issues with the SDK, please [open an issue on GitHub](https://github.com/superwall/superwall-android/issues).
 
-<SdkLatestVersion version="2.7.3" repoUrl="https://github.com/superwall/Superwall-Android" />
+<SdkLatestVersion version="2.7.4" repoUrl="https://github.com/superwall/Superwall-Android" />