Changelog

1.0.0

Major Changes

197c0c8: Add missing SDK configuration options from native iOS and Android SDKs:
- shouldObservePurchases (iOS & Android): Observe purchases made outside of Superwall
- shouldBypassAppTransactionCheck (iOS only): Disables app transaction check on SDK launch
- maxConfigRetryCount (iOS only): Number of retry attempts for config fetch (default: 6)
- useMockReviews (Android only): Enable mock review functionality
Also fixes enableExperimentalDeviceVariables not being passed to the Android native SDK.

Breaking change: Removed deprecated collectAdServicesAttribution option (AdServices attribution is now collected automatically by the native iOS SDK).

0.8.1

Patch Changes

ec326e8: bump ios to 4.10.6

0.8.0

Minor Changes

0fcbf57: hotfix web2app redemption by disabling shouldShowWebPurchaseConfirmationAlert per default

Patch Changes

5768d51: expose shouldShowWebPurchaseConfirmationAlert option

0.7.2

Patch Changes

5e2491a: improve event listens to always subscribe no matter what

0.7.1

Patch Changes

bab902d: fix compat android serialziaiton

0.7.0

Minor Changes

183a7d2: feat: comprehensive error handling for SDK configuration failures

Added robust error handling to prevent apps from hanging indefinitely when SDK configuration fails (e.g., during offline scenarios). This introduces three new ways for developers to handle configuration errors:

New Features:
- Added configurationError state to store for programmatic error access
- Added onConfigurationError callback prop to SuperwallProvider for error tracking/analytics
- Added SuperwallError component for declarative error UI rendering
- Listen to native configFail events to capture configuration failures
- Improved SuperwallLoading and SuperwallLoaded to respect error states
Breaking Changes: None - all changes are backward compatible

Fixes:
- Fixed app hanging in loading state when offline or configuration fails
- Fixed unhandled promise rejections in deep link initialization
- Fixed loading state not resetting on configuration failure
Developers can now gracefully handle offline scenarios and provide better UX when SDK initialization fails.

Patch Changes

4e246c9: fix: resolve Android handleDeepLink promise consistently with iOS

Fixed Android crash on app launch caused by "Not a superwall link" error. The Android implementation now resolves the handleDeepLink promise with a boolean value (matching iOS behavior) instead of rejecting it for non-Superwall links. This prevents unhandled promise rejections that were causing production app crashes.

Additionally added error handling in TypeScript as a safety net for any future edge cases.
4e246c9: fix: filter our expo specific deeplinks

0.6.11

Patch Changes

ed77ab7: fix: filter our expo specific deeplinks

0.6.10

Patch Changes

2e2fc96: fix: compat products when empty crashing

0.6.9

Patch Changes

7f28aa0: bump kotlin to 2.6.4
ec246be: Added integration attributes support for third-party platforms

0.6.8

Patch Changes

f70ebe4: Fix undefined being returned for PaywallResult

0.6.7

Patch Changes

02a9d2d: add missing productIdentifier to RedmeptionPaywallInfo

0.6.6

Patch Changes

9c5a9a5: bump ios to 4.10.1

0.6.5

Patch Changes

e4c6aec: add getEntitlements to useUser hook

0.6.4

Patch Changes

fedde41: fix: compat superwall options on android

0.6.3

Patch Changes

0278ad4: bump ios to 4.10.0. This fixes missing localization for app2web restore flow

0.6.2

Patch Changes

72519cd: remove unused expo plugin

0.6.1

Patch Changes

7920773: fix(android): handle nullable properties in RedemptionResult JSON serialization

Fixed a Kotlin compilation error where nullable properties (variantId, experimentId, productIdentifier) were being assigned directly to a Map<String, Any>. Now using the null-safe let operator to conditionally add these properties only when they have values.

0.6.0

Minor Changes

b816292: # Custom Purchase Controller API Improvement

Changed CustomPurchaseControllerContext return types from Promise<PurchaseResult | undefined> to Promise<PurchaseResult | void> for cleaner success handling.

Now you can simply not return anything for success instead of return undefined:

import Purchases, { PURCHASES_ERROR_CODE } from "react-native-purchases";

<CustomPurchaseControllerProvider
  controller={{
    onPurchase: async (params) => {
      try {
        const products = await Purchases.getProducts([params.productId]);
        const product = products[0];

        if (!product) {
          return { type: "failed", error: "Product not found" };
        }

        await Purchases.purchaseStoreProduct(product);
        // Success - no return needed ✨
      } catch (error: any) {
        if (error.code === PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR) {
          return { type: "cancelled" };
        }
        return { type: "failed", error: error.message };
      }
    },

    onPurchaseRestore: async () => {
      try {
        await Purchases.restorePurchases();
        // Success - no return needed ✨
      } catch (error: any) {
        return { type: "failed", error: error.message };
      }
    },
  }}
>
  {/* Your app */}
</CustomPurchaseControllerProvider>;

Patch Changes

acb9956: feature: add StoreProduct Type to exports

0.5.1

Patch Changes

889aaf7: fix: improve custom purchase type handling
56a72c9: Bump Android version to 2.6.3
465a215: Exposes Product identifier in Redemption Info

0.5.0

Minor Changes

8c2c14f: User identification and attribute operations are now non-blocking async calls, preventing UI freezes while ensuring proper state synchronization

Thanks to @gursheyss for the PR #90

0.4.1

Patch Changes

86a3b28: Update Android version to 2.6.1 adding app2web support
6df6cc4: Adds paddle store identifiers

0.4.0

Minor Changes

6d3e625: bump ios to fix critical webview bug

0.3.2

Patch Changes

5555e8e: make error handling more defensive

0.3.1

Patch Changes

4a3f540: fix: compat typeissues

0.3.0

Minor Changes

9ed73eb: feat: improve error handling of Custom Purchase Controller

0.2.9

Patch Changes

bd460a7: Expose signature in android StoreTransaction
e9eeff8: Expose appAcounttoken and purchaseToken on Android StoreTransaction

0.2.8

Patch Changes

e0b57bc: fix(compat): none nullable access
314be3c: bump deps

0.2.7

Patch Changes

adccfe4: Update Android SDK to 2.5.4 and iOS to 4.8.2

0.2.6

Patch Changes

10bb039: force release?

0.2.5

Patch Changes

95636a6: Bump internal android sdk to 2.5.1

0.2.4

Patch Changes

c274e6a: Add typed SuperwallOptions and fix mispelled option name

0.2.3

Patch Changes

f9372f1: Exposes StoreTransaction in /compat

0.2.2

Patch Changes

3f832c7: Updates Android SDK to 2.3.2

0.2.1

Patch Changes

4327c59: expose internal types

0.2.0

Minor Changes

3b58ea4: Updates Android SDK to 2.3.1 (with Google Play Billing library 7)

0.1.3

Patch Changes

d273d2a: bump expo module

0.1.2

Patch Changes

f243226: fix: type issues

0.1.1

Patch Changes

707e513: temp fix swift types

0.1.0

Minor Changes

b39e98e: feat: Remove the export of the internal SuperwallExpoModule Class, this class should have not been used since it's an internal class and could break the state of the internal SuperwallStore. If you have used in prior for a usecase that the current SDK doesn't support, please open an issue.

Patch Changes

32112a6: feat: handle deeplink automatically, no need for manual handling

0.0.18

Patch Changes

3a93b2b: feat: fix inital loading state

0.0.17

Patch Changes

db980b6: fix missing types on native

0.0.16

Patch Changes

e19e626: require Expo 53+

0.0.15

Patch Changes

020c22a: fix: old exports

0.0.14

Patch Changes

6153163: mark things as internal
6fbaa94: add types to TransactionProductIdentifier

0.0.13

Patch Changes

2ead245: feat: add getDeviceAttributes
efbd9d5: feat: add getDeviceAttributes to ios

0.0.12

Patch Changes

4751b75: Fixes issues with identify on Android, updates Android SDK to 2.2.3

0.0.11

Patch Changes

9c053b3: feat: add experimentalDeviceVariables for ios

0.0.10

Patch Changes

d5beb70: fix(compat): subscription event emitter not firing

0.0.9

Patch Changes

67edd16: feat: export internal SuperwallExpoModule for advance usage

0.0.8

Patch Changes

0175478: feat: set subscription status to UNKNOWN on startup
d8390ab: feat: bump ios SDK version

0.0.7

Patch Changes

f5a1d9a: fix: signout state changes
4df7557: fix: ios getSubscriptionStatus

0.0.6

Patch Changes

fc22062: fix: android getSubscriptionStatus returning undefined

0.0.5

Patch Changes

8f4d758: fix compat subscriptionStatus access failing
9d98a30: fix: android sdk version not being passed correctly

0.0.4

Patch Changes

eb98aeb: feat: add ability to use CustomPurchaseController

Just wrap your app with CustomPurchaseControllerProvider and pass your own handler functions to it. It will await the result of these handler functions to continue the purchase/restore flow.

<CustomPurchaseControllerProvider
  controller={{
    onPurchase: async (params) => {
      // Set stuff in ur system here
      if (params.platform === "ios") {
        console.log("onPurchase", params);
      } else {
        console.log("onPurchase", params.productId);
      }
      return;
    },
    onPurchaseRestore: async () => {
      console.log("onPurchaseRestore");
      // Set stuff in ur system here
      return;
    },
  }}
>
  <SuperwallProvider apiKeys={{ ios: API_KEY }}>
    <SuperwallLoading>
      <ActivityIndicator style={{ flex: 1 }} />
    </SuperwallLoading>
    <SuperwallLoaded>
      <ScreenContent />
    </SuperwallLoaded>
  </SuperwallProvider>
</CustomPurchaseControllerProvider>

Changelog

On this page