expo-superwall 1.0.10 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 1.1.0
+
+### Minor Changes
+
+- 0c3396d: Bump native SDKs and expose new APIs.
+
+  **iOS — SuperwallKit 4.14.1 → 4.15.1**
+
+  - New `paywallPageView` event for multi-page paywall navigation tracking (with `PageViewData` payload).
+  - `PaywallInfo.presentationId` is now bridged so events within a single presentation can be correlated.
+  - Custom store products are fully bridged: `Product` now carries `store` (`APP_STORE` | `STRIPE` | `PADDLE` | `PLAY_STORE` | `SUPERWALL` | `CUSTOM` | `OTHER`) plus per-store identifier objects (`appStoreProduct`, `stripeProduct`, `paddleProduct`, `customProduct`). `onPurchase` also receives `store` so JS can route `CUSTOM` products to its own purchase logic instead of StoreKit.
+
+  **Android — Superwall-Android 2.7.11 → 2.7.12**
+
+  - Bridges the new `customerInfo` field on `PaywallInfo` (subscriptions, non-subscriptions, entitlements, userId).
+  - Picks up new intro-offer eligibility logic for Stripe/Paddle products and bottom-sheet dismiss fix on newer Samsung devices.
+
+## 1.0.11
+
+### Patch Changes
+
+- 975de31: Add android 'consume' method
+- 2204ee8: Bump Android version
+
 ## 1.0.10
 
 ### Patch Changes

package/android/build.gradle

@@ -43,7 +43,7 @@ android {
 }
 
 dependencies {
-  implementation "com.superwall.sdk:superwall-android:2.7.8"
+  implementation "com.superwall.sdk:superwall-android:2.7.12"
   implementation 'com.android.billingclient:billing:8.0.0'
   implementation 'org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.2'
 }

package/android/src/main/java/expo/modules/superwallexpo/SuperwallExpoModule.kt

@@ -410,6 +410,20 @@ class SuperwallExpoModule : Module() {
       promise.resolve(null)
     }
 
+    AsyncFunction("restorePurchases") { promise: Promise ->
+      ioScope.launch {
+        Superwall.instance.restorePurchases().fold({ result ->
+          scope.launch {
+            promise.resolve(restorationResultToJson(result))
+          }
+        }, { error ->
+          scope.launch {
+            promise.resolve(restorationResultToJson(RestorationResult.Failed(error)))
+          }
+        })
+      }
+    }
+
     AsyncFunction("dismiss") { promise: Promise ->
       ioScope.launch {
         Superwall.instance.dismiss()
@@ -482,5 +496,15 @@ class SuperwallExpoModule : Module() {
       val attributes = Superwall.instance.integrationAttributes
       promise.resolve(attributes)
     }
+
+    AsyncFunction("consume") { purchaseToken: String, promise: Promise ->
+      ioScope.launch {
+        Superwall.instance.consume(purchaseToken).fold({ token ->
+          scope.launch { promise.resolve(token) }
+        }, { error ->
+          scope.launch { promise.reject(CodedException(error)) }
+        })
+      }
+    }
   }
 }

package/android/src/main/java/expo/modules/superwallexpo/json/CustomerInfo.kt

@@ -0,0 +1,63 @@
+package expo.modules.superwallexpo.json
+
+import com.superwall.sdk.models.customer.CustomerInfo
+import com.superwall.sdk.models.customer.NonSubscriptionTransaction
+import com.superwall.sdk.models.customer.SubscriptionTransaction
+import com.superwall.sdk.store.abstractions.product.receipt.LatestPeriodType
+import java.time.ZoneId
+import java.time.format.DateTimeFormatter
+import java.util.Date
+
+// Mirrors the @SerialName values on `LatestPeriodType`. Exhaustive `when` so a new
+// SDK case is a compile error rather than a silently-incorrect string.
+private fun LatestPeriodType.toJsonString(): String =
+  when (this) {
+    LatestPeriodType.TRIAL -> "trial"
+    LatestPeriodType.CODE -> "code"
+    LatestPeriodType.SUBSCRIPTION -> "subscription"
+    LatestPeriodType.PROMOTIONAL -> "promotional"
+    LatestPeriodType.WINBACK -> "winback"
+    LatestPeriodType.REVOKED -> "revoked"
+  }
+
+private val dateFormatter: DateTimeFormatter = DateTimeFormatter.ISO_INSTANT
+
+private fun Date.toIsoString(): String =
+  this.toInstant().atZone(ZoneId.systemDefault()).format(dateFormatter)
+
+fun CustomerInfo.toJson(): Map<String, Any?> {
+  val map = mutableMapOf<String, Any?>()
+  map["userId"] = this.userId
+  map["subscriptions"] = this.subscriptions.map { it.toJson() }
+  map["nonSubscriptions"] = this.nonSubscriptions.map { it.toJson() }
+  map["entitlements"] = this.entitlements.map { it.toJson() }
+  return map
+}
+
+fun SubscriptionTransaction.toJson(): Map<String, Any?> {
+  val map = mutableMapOf<String, Any?>()
+  map["transactionId"] = this.transactionId
+  map["productId"] = this.productId
+  map["purchaseDate"] = this.purchaseDate.toIsoString()
+  map["willRenew"] = this.willRenew
+  map["isRevoked"] = this.isRevoked
+  map["isInGracePeriod"] = this.isInGracePeriod
+  map["isInBillingRetryPeriod"] = this.isInBillingRetryPeriod
+  map["isActive"] = this.isActive
+  map["expirationDate"] = this.expirationDate?.toIsoString()
+  map["store"] = this.store.name
+  this.offerType?.let { map["offerType"] = it.toJsonString() }
+  this.subscriptionGroupId?.let { map["subscriptionGroupId"] = it }
+  return map
+}
+
+fun NonSubscriptionTransaction.toJson(): Map<String, Any?> {
+  val map = mutableMapOf<String, Any?>()
+  map["transactionId"] = this.transactionId
+  map["productId"] = this.productId
+  map["purchaseDate"] = this.purchaseDate.toIsoString()
+  map["isConsumable"] = this.isConsumable
+  map["isRevoked"] = this.isRevoked
+  map["store"] = this.store.name
+  return map
+}

package/android/src/main/java/expo/modules/superwallexpo/json/PaywallInfo.kt

@@ -92,5 +92,7 @@ fun PaywallInfo.toJson(): Map<String, Any?> {
 
   map["state"] = this.state
 
+  map["customerInfo"] = this.customerInfo.toJson()
+
   return map
 }

package/android/src/main/java/expo/modules/superwallexpo/json/RestorationResult.kt

@@ -13,3 +13,13 @@ fun restorationResultFromJson(json: Map<String, Any>): RestorationResult {
         else -> RestorationResult.Failed(Error("Unknown restoration result"))
       }
 }
+
+fun restorationResultToJson(result: RestorationResult): Map<String, Any?> {
+    return when (result) {
+        is RestorationResult.Restored -> mapOf("result" to "restored")
+        is RestorationResult.Failed -> mapOf(
+            "result" to "failed",
+            "errorMessage" to (result.error?.message ?: "Unknown error")
+        )
+    }
+}

package/build/package.json

@@ -1,6 +1,6 @@
 {
     "name": "expo-superwall",
-    "version": "1.0.10",
+    "version": "1.1.0",
     "description": "Offical Expo Integration for Superwall",
     "main": "build/src/index.js",
     "types": "build/src/index.d.ts",

package/build/src/SuperwallExpoModule.d.ts

@@ -1,6 +1,6 @@
 import { NativeModule } from "expo";
 import type { PresentationResult } from "./compat/lib/PresentationResult";
-import type { EntitlementsInfo, IntegrationAttributes, SuperwallExpoModuleEvents } from "./SuperwallExpoModule.types";
+import type { EntitlementsInfo, IntegrationAttributes, RestorationResultResponse, SuperwallExpoModuleEvents } from "./SuperwallExpoModule.types";
 export type SubscriptionStatus = any;
 declare class SuperwallExpoModule extends NativeModule<SuperwallExpoModuleEvents> {
     getApiKey(): string;
@@ -26,6 +26,7 @@ declare class SuperwallExpoModule extends NativeModule<SuperwallExpoModuleEvents
     didRestore(result: Record<string, any>): void;
     didHandleBackPressed(shouldConsume: boolean): void;
     didHandleCustomCallback(callbackId: string, status: string, data?: Record<string, any>): Promise<void>;
+    restorePurchases(): Promise<RestorationResultResponse>;
     dismiss(): Promise<void>;
     confirmAllAssignments(): Promise<any[]>;
     getPresentationResult(placement: string, params?: Map<string, any> | Record<string, any>): Promise<PresentationResult>;
@@ -35,6 +36,7 @@ declare class SuperwallExpoModule extends NativeModule<SuperwallExpoModuleEvents
     setLogLevel(level: string): void;
     setIntegrationAttributes(attributes: IntegrationAttributes): Promise<void>;
     getIntegrationAttributes(): Promise<Record<string, string>>;
+    consume(purchaseToken: string): Promise<string>;
 }
 declare const _default: SuperwallExpoModule;
 export default _default;

package/build/src/SuperwallExpoModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SuperwallExpoModule.d.ts","sourceRoot":"","sources":["../../src/SuperwallExpoModule.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SuperwallExpoModule.d.ts","sourceRoot":"","sources":["../../src/SuperwallExpoModule.ts"],"names":[],"mappings":"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"}

package/build/src/SuperwallExpoModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"SuperwallExpoModule.js","sourceRoot":"","sources":["../../src/SuperwallExpoModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAA;AA6ExD,eAAe,mBAAmB,CAAsB,eAAe,CAAC,CAAA","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\"\nimport type { PresentationResult } from \"./compat/lib/PresentationResult\"\nimport type {\n  EntitlementsInfo,\n  IntegrationAttributes,\n  SuperwallExpoModuleEvents,\n} from \"./SuperwallExpoModule.types\"\n\nexport type SubscriptionStatus = any\n\ndeclare class SuperwallExpoModule extends NativeModule<SuperwallExpoModuleEvents> {\n  getApiKey(): string\n  registerPlacement(\n    placement: string,\n    params?: Map<string, any> | Record<string, any>,\n    handlerId?: string | null,\n  ): Promise<void>\n\n  configure(\n    apiKey: string,\n    options?: Map<string, any> | Record<string, any>,\n    usingPurchaseController?: boolean,\n    sdkVersion?: string,\n  ): Promise<void>\n\n  getConfigurationStatus(): Promise<string>\n\n  identify(userId: string, options?: Map<string, any> | Record<string, any> | null): Promise<void>\n  reset(): Promise<void>\n\n  getAssignments(): Promise<any[]>\n  getEntitlements(): Promise<EntitlementsInfo>\n  getSubscriptionStatus(): Promise<SubscriptionStatus>\n  setSubscriptionStatus(status: Record<string, any>): Promise<void>\n\n  setInterfaceStyle(style?: string): void\n\n  getUserAttributes(): Promise<Record<string, any>>\n  setUserAttributes(userAttributes: Record<string, any | null>): Promise<void>\n\n  handleDeepLink(url: string): Promise<boolean>\n\n  didPurchase(\n    result:\n      | { type: \"cancelled\" | \"purchased\" | \"pending\" }\n      | {\n          type: \"failed\"\n          error?: string\n        },\n  ): void\n  didRestore(result: Record<string, any>): void\n  didHandleBackPressed(shouldConsume: boolean): void\n  didHandleCustomCallback(\n    callbackId: string,\n    status: string,\n    data?: Record<string, any>,\n  ): Promise<void>\n\n  dismiss(): Promise<void>\n  confirmAllAssignments(): Promise<any[]>\n\n  getPresentationResult(\n    placement: string,\n    params?: Map<string, any> | Record<string, any>,\n  ): Promise<PresentationResult>\n\n  getDeviceAttributes(): Promise<Record<string, any>>\n\n  preloadPaywalls(placementNames: string[]): void\n  preloadAllPaywalls(): void\n\n  setLogLevel(level: string): void\n\n  setIntegrationAttributes(attributes: IntegrationAttributes): Promise<void>\n  getIntegrationAttributes(): Promise<Record<string, string>>\n}\n\nexport default requireNativeModule<SuperwallExpoModule>(\"SuperwallExpo\")\n"]}
+{"version":3,"file":"SuperwallExpoModule.js","sourceRoot":"","sources":["../../src/SuperwallExpoModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAA;AAkFxD,eAAe,mBAAmB,CAAsB,eAAe,CAAC,CAAA","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\"\nimport type { PresentationResult } from \"./compat/lib/PresentationResult\"\nimport type {\n  EntitlementsInfo,\n  IntegrationAttributes,\n  RestorationResultResponse,\n  SuperwallExpoModuleEvents,\n} from \"./SuperwallExpoModule.types\"\n\nexport type SubscriptionStatus = any\n\ndeclare class SuperwallExpoModule extends NativeModule<SuperwallExpoModuleEvents> {\n  getApiKey(): string\n  registerPlacement(\n    placement: string,\n    params?: Map<string, any> | Record<string, any>,\n    handlerId?: string | null,\n  ): Promise<void>\n\n  configure(\n    apiKey: string,\n    options?: Map<string, any> | Record<string, any>,\n    usingPurchaseController?: boolean,\n    sdkVersion?: string,\n  ): Promise<void>\n\n  getConfigurationStatus(): Promise<string>\n\n  identify(userId: string, options?: Map<string, any> | Record<string, any> | null): Promise<void>\n  reset(): Promise<void>\n\n  getAssignments(): Promise<any[]>\n  getEntitlements(): Promise<EntitlementsInfo>\n  getSubscriptionStatus(): Promise<SubscriptionStatus>\n  setSubscriptionStatus(status: Record<string, any>): Promise<void>\n\n  setInterfaceStyle(style?: string): void\n\n  getUserAttributes(): Promise<Record<string, any>>\n  setUserAttributes(userAttributes: Record<string, any | null>): Promise<void>\n\n  handleDeepLink(url: string): Promise<boolean>\n\n  didPurchase(\n    result:\n      | { type: \"cancelled\" | \"purchased\" | \"pending\" }\n      | {\n          type: \"failed\"\n          error?: string\n        },\n  ): void\n  didRestore(result: Record<string, any>): void\n  didHandleBackPressed(shouldConsume: boolean): void\n  didHandleCustomCallback(\n    callbackId: string,\n    status: string,\n    data?: Record<string, any>,\n  ): Promise<void>\n\n  restorePurchases(): Promise<RestorationResultResponse>\n\n  dismiss(): Promise<void>\n  confirmAllAssignments(): Promise<any[]>\n\n  getPresentationResult(\n    placement: string,\n    params?: Map<string, any> | Record<string, any>,\n  ): Promise<PresentationResult>\n\n  getDeviceAttributes(): Promise<Record<string, any>>\n\n  preloadPaywalls(placementNames: string[]): void\n  preloadAllPaywalls(): void\n\n  setLogLevel(level: string): void\n\n  setIntegrationAttributes(attributes: IntegrationAttributes): Promise<void>\n  getIntegrationAttributes(): Promise<Record<string, string>>\n\n  consume(purchaseToken: string): Promise<string>\n}\n\nexport default requireNativeModule<SuperwallExpoModule>(\"SuperwallExpo\")\n"]}

package/build/src/SuperwallExpoModule.types.d.ts

@@ -314,9 +314,125 @@ export interface ComputedPropertyRequest {
      */
     placementName: string;
 }
+/**
+ * The store that backs a {@link Product}.
+ * - `APP_STORE`: Apple App Store product (iOS).
+ * - `PLAY_STORE`: Google Play Store product (Android).
+ * - `STRIPE`: Stripe-managed product.
+ * - `PADDLE`: Paddle-managed product.
+ * - `SUPERWALL`: Manually granted entitlement from the Superwall dashboard.
+ * - `CUSTOM`: A custom product purchased through a `PurchaseController` outside of any
+ *   storefront. When you receive a custom product in `onPurchase`, you must implement the
+ *   purchase yourself (e.g., calling your backend) instead of going through StoreKit / Billing.
+ * - `OTHER`: An unknown or unsupported store.
+ */
+export type ProductStore = "APP_STORE" | "PLAY_STORE" | "STRIPE" | "PADDLE" | "SUPERWALL" | "CUSTOM" | "OTHER";
+/**
+ * The Apple App Store-specific data for a {@link Product}.
+ */
+export interface AppStoreProductIdentifier {
+    /** The App Store product identifier. */
+    id: string;
+}
+/**
+ * The Stripe-specific data for a {@link Product}.
+ */
+export interface StripeProductIdentifier {
+    /** The Stripe price/product identifier. */
+    id: string;
+    /** The number of trial days for this product, if any. */
+    trialDays?: number;
+}
+/**
+ * The Paddle-specific data for a {@link Product}.
+ */
+export interface PaddleProductIdentifier {
+    /** The Paddle product identifier. */
+    id: string;
+}
+/**
+ * The custom-product data for a {@link Product}.
+ * Custom products are purchased via your `PurchaseController` rather than through a storefront.
+ */
+export interface CustomStoreProductIdentifier {
+    /** The custom product identifier (as configured on the Superwall dashboard). */
+    id: string;
+}
+/**
+ * The offer type that applied to a {@link SubscriptionTransaction}.
+ *
+ * @platform Android
+ */
+export type SubscriptionOfferType = "trial" | "code" | "subscription" | "promotional" | "winback" | "revoked";
+/**
+ * A subscription transaction recorded in the customer's purchase history.
+ *
+ * @platform Android — currently only delivered by the Android SDK.
+ */
+export interface SubscriptionTransaction {
+    /** The unique identifier for the transaction. */
+    transactionId: string;
+    /** The product identifier of the subscription. */
+    productId: string;
+    /** ISO-8601 timestamp of when the user was charged. */
+    purchaseDate: string;
+    /** Whether the subscription is set to renew. */
+    willRenew: boolean;
+    /** Whether the transaction has been revoked. */
+    isRevoked: boolean;
+    /** Whether the subscription is in a billing grace period. */
+    isInGracePeriod: boolean;
+    /** Whether the subscription is in a billing retry period. */
+    isInBillingRetryPeriod: boolean;
+    /** Whether the subscription is currently active. */
+    isActive: boolean;
+    /** ISO-8601 expiration date, or `null` if non-renewing. */
+    expirationDate?: string | null;
+    /** Store the transaction came from (e.g. `"PLAY_STORE"`). */
+    store: string;
+    /** Offer type, if any was applied. */
+    offerType?: SubscriptionOfferType;
+    /** iOS-only — the subscription group identifier. */
+    subscriptionGroupId?: string;
+}
+/**
+ * A non-subscription (one-time / consumable) transaction in the customer's purchase history.
+ *
+ * @platform Android — currently only delivered by the Android SDK.
+ */
+export interface NonSubscriptionTransaction {
+    /** The unique identifier for the transaction. */
+    transactionId: string;
+    /** The product identifier of the in-app purchase. */
+    productId: string;
+    /** ISO-8601 timestamp of when the user was charged. */
+    purchaseDate: string;
+    /** Whether the in-app purchase is consumable. */
+    isConsumable: boolean;
+    /** Whether the transaction has been revoked. */
+    isRevoked: boolean;
+    /** Store the transaction came from (e.g. `"PLAY_STORE"`). */
+    store: string;
+}
+/**
+ * The latest subscription and entitlement state for the customer.
+ * Snapshots are immutable and don't auto-update.
+ *
+ * @platform Android — currently only delivered by the Android SDK.
+ */
+export interface CustomerInfo {
+    /** The user ID at the time the snapshot was taken. */
+    userId: string;
+    /** All subscription transactions, ordered by purchase date ascending. */
+    subscriptions: SubscriptionTransaction[];
+    /** All non-subscription transactions, ordered by purchase date ascending. */
+    nonSubscriptions: NonSubscriptionTransaction[];
+    /** All entitlements available to the user. */
+    entitlements: Entitlement[];
+}
 /**
  * Represents a product available for purchase on a paywall, as defined within {@link PaywallInfo}.
- * This provides a simplified view of a product, focusing on its ID, name, and granted entitlements.
+ * This provides a simplified view of a product, focusing on its ID, name, store, and granted entitlements.
  */
 export interface Product {
     /**
@@ -332,6 +448,34 @@ export interface Product {
      * See {@link Entitlement}.
      */
     entitlements: Entitlement[];
+    /**
+     * The store that backs this product. See {@link ProductStore}.
+     * Use this to detect `CUSTOM` products in `onPurchase` and route them to your own
+     * purchase logic instead of StoreKit / Google Play Billing.
+     *
+     * @platform iOS — present on iOS 4.15.0+. May be absent on older Android SDK versions.
+     */
+    store?: ProductStore;
+    /**
+     * App Store-specific product data, present when `store === "APP_STORE"`.
+     * @platform iOS
+     */
+    appStoreProduct?: AppStoreProductIdentifier;
+    /**
+     * Stripe-specific product data, present when `store === "STRIPE"`.
+     * @platform iOS
+     */
+    stripeProduct?: StripeProductIdentifier;
+    /**
+     * Paddle-specific product data, present when `store === "PADDLE"`.
+     * @platform iOS
+     */
+    paddleProduct?: PaddleProductIdentifier;
+    /**
+     * Custom-product data, present when `store === "CUSTOM"`.
+     * @platform iOS
+     */
+    customProduct?: CustomStoreProductIdentifier;
 }
 /**
  * Contains comprehensive information about a paywall, including its configuration, associated experiment,
@@ -344,6 +488,11 @@ export interface PaywallInfo {
     name: string;
     /** The URL where the paywall's web content is hosted. */
     url: string;
+    /**
+     * A unique identifier for this paywall presentation, used to correlate all events
+     * within a single presentation lifecycle.
+     */
+    presentationId?: string;
     /**
      * The experiment associated with this paywall presentation, if applicable.
      * See {@link Experiment}.
@@ -437,6 +586,14 @@ export interface PaywallInfo {
      * Contains key-value pairs representing the paywall's current state.
      */
     state: Record<string, any>;
+    /**
+     * A snapshot of the customer's subscription and entitlement state at the time
+     * the paywall was presented.
+     *
+     * @platform Android — currently only populated by the Android SDK (2.7.12+).
+     *   Will be `undefined` on iOS.
+     */
+    customerInfo?: CustomerInfo;
 }
 /**
  * Represents a custom callback invoked from a paywall.
@@ -1848,17 +2005,52 @@ export interface StripeCheckoutFailEvent {
     /** Information about the paywall associated with this checkout. */
     paywallInfo: PaywallInfo;
 }
+/**
+ * Page-specific details for a multi-page paywall page view.
+ */
+export interface PageViewData {
+    /** The unique identifier for the page node. */
+    pageNodeId: string;
+    /** The zero-based index of the page in the paywall flow. */
+    flowPosition: number;
+    /** The display name of the page. */
+    pageName: string;
+    /** The unique identifier for the navigation node. */
+    navigationNodeId: string;
+    /** The unique identifier for the previous page node, if any. */
+    previousPageNodeId?: string;
+    /** The flow position of the previous page, if any. */
+    previousFlowPosition?: number;
+    /**
+     * How the user navigated to the page.
+     * Possible values: `"entry"`, `"forward"`, `"back"`, `"auto_transition"`.
+     */
+    navigationType: string;
+    /** Time spent on the previous page in milliseconds, if any. */
+    timeOnPreviousPageMs?: number;
+}
+/**
+ * The user navigated to a page in a multi-page paywall.
+ */
+export interface PaywallPageViewEvent {
+    /** The user navigated to a page in a multi-page paywall. */
+    event: "paywallPageView";
+    /** Information about the paywall associated with this page view. */
+    paywallInfo: PaywallInfo;
+    /** Details about the page that was navigated to. */
+    data: PageViewData;
+}
 /**
  * A union of all possible string literal values for the `event` property from all specific Superwall event types.
  * This type can be used when you need to refer to an event type name itself.
  */
-export type SuperwallEventType = FirstSeenEvent["event"] | AppOpenEvent["event"] | AppLaunchEvent["event"] | IdentityAliasEvent["event"] | AppInstallEvent["event"] | SessionStartEvent["event"] | ResetEvent["event"] | ConfigRefreshEvent["event"] | ConfigFailEvent["event"] | ConfigAttributesEvent["event"] | ConfirmAllAssignmentsEvent["event"] | TouchesBeganEvent["event"] | SurveyCloseEvent["event"] | RestoreStartEvent["event"] | RestoreCompleteEvent["event"] | RestoreFailEvent["event"] | AdServicesTokenRequestStartEvent["event"] | AdServicesTokenRequestFailEvent["event"] | AdServicesTokenRequestCompleteEvent["event"] | ShimmerViewStartEvent["event"] | ShimmerViewCompleteEvent["event"] | RedemptionStartEvent["event"] | RedemptionCompleteEvent["event"] | RedemptionFailEvent["event"] | EnrichmentStartEvent["event"] | EnrichmentCompleteEvent["event"] | EnrichmentFailEvent["event"] | UnknownEvent["event"] | DeviceAttributesEvent["event"] | SubscriptionStatusDidChangeEvent["event"] | AppCloseEvent["event"] | DeepLinkEvent["event"] | TriggerFireEvent["event"] | PaywallOpenEvent["event"] | PaywallCloseEvent["event"] | PaywallDeclineEvent["event"] | TransactionStartEvent["event"] | TransactionFailEvent["event"] | TransactionAbandonEvent["event"] | TransactionCompleteEvent["event"] | SubscriptionStartEvent["event"] | FreeTrialStartEvent["event"] | TransactionRestoreEvent["event"] | TransactionTimeoutEvent["event"] | UserAttributesEvent["event"] | NonRecurringProductPurchaseEvent["event"] | PaywallResponseLoadStartEvent["event"] | PaywallResponseLoadNotFoundEvent["event"] | PaywallResponseLoadFailEvent["event"] | PaywallResponseLoadCompleteEvent["event"] | PaywallWebviewLoadStartEvent["event"] | PaywallWebviewLoadFailEvent["event"] | PaywallWebviewLoadCompleteEvent["event"] | PaywallWebviewLoadTimeoutEvent["event"] | PaywallWebviewLoadFallbackEvent["event"] | PaywallProductsLoadStartEvent["event"] | PaywallProductsLoadFailEvent["event"] | PaywallProductsLoadCompleteEvent["event"] | PaywallProductsLoadRetryEvent["event"] | SurveyResponseEvent["event"] | PaywallPresentationRequestEvent["event"] | CustomPlacementEvent["event"] | PaywallWebviewProcessTerminatedEvent["event"] | PaywallProductsLoadMissingProductsEvent["event"] | NetworkDecodingFailEvent["event"] | CustomerInfoDidChangeEvent["event"] | IntegrationAttributesEvent["event"] | ReviewRequestedEvent["event"] | PermissionRequestedEvent["event"] | PermissionGrantedEvent["event"] | PermissionDeniedEvent["event"] | PaywallPreloadStartEvent["event"] | PaywallPreloadCompleteEvent["event"] | TestModeModalOpenEvent["event"] | TestModeModalCloseEvent["event"] | StripeCheckoutStartEvent["event"] | StripeCheckoutSubmitEvent["event"] | StripeCheckoutCompleteEvent["event"] | StripeCheckoutFailEvent["event"];
+export type SuperwallEventType = FirstSeenEvent["event"] | AppOpenEvent["event"] | AppLaunchEvent["event"] | IdentityAliasEvent["event"] | AppInstallEvent["event"] | SessionStartEvent["event"] | ResetEvent["event"] | ConfigRefreshEvent["event"] | ConfigFailEvent["event"] | ConfigAttributesEvent["event"] | ConfirmAllAssignmentsEvent["event"] | TouchesBeganEvent["event"] | SurveyCloseEvent["event"] | RestoreStartEvent["event"] | RestoreCompleteEvent["event"] | RestoreFailEvent["event"] | AdServicesTokenRequestStartEvent["event"] | AdServicesTokenRequestFailEvent["event"] | AdServicesTokenRequestCompleteEvent["event"] | ShimmerViewStartEvent["event"] | ShimmerViewCompleteEvent["event"] | RedemptionStartEvent["event"] | RedemptionCompleteEvent["event"] | RedemptionFailEvent["event"] | EnrichmentStartEvent["event"] | EnrichmentCompleteEvent["event"] | EnrichmentFailEvent["event"] | UnknownEvent["event"] | DeviceAttributesEvent["event"] | SubscriptionStatusDidChangeEvent["event"] | AppCloseEvent["event"] | DeepLinkEvent["event"] | TriggerFireEvent["event"] | PaywallOpenEvent["event"] | PaywallCloseEvent["event"] | PaywallDeclineEvent["event"] | TransactionStartEvent["event"] | TransactionFailEvent["event"] | TransactionAbandonEvent["event"] | TransactionCompleteEvent["event"] | SubscriptionStartEvent["event"] | FreeTrialStartEvent["event"] | TransactionRestoreEvent["event"] | TransactionTimeoutEvent["event"] | UserAttributesEvent["event"] | NonRecurringProductPurchaseEvent["event"] | PaywallResponseLoadStartEvent["event"] | PaywallResponseLoadNotFoundEvent["event"] | PaywallResponseLoadFailEvent["event"] | PaywallResponseLoadCompleteEvent["event"] | PaywallWebviewLoadStartEvent["event"] | PaywallWebviewLoadFailEvent["event"] | PaywallWebviewLoadCompleteEvent["event"] | PaywallWebviewLoadTimeoutEvent["event"] | PaywallWebviewLoadFallbackEvent["event"] | PaywallProductsLoadStartEvent["event"] | PaywallProductsLoadFailEvent["event"] | PaywallProductsLoadCompleteEvent["event"] | PaywallProductsLoadRetryEvent["event"] | SurveyResponseEvent["event"] | PaywallPresentationRequestEvent["event"] | CustomPlacementEvent["event"] | PaywallWebviewProcessTerminatedEvent["event"] | PaywallProductsLoadMissingProductsEvent["event"] | NetworkDecodingFailEvent["event"] | CustomerInfoDidChangeEvent["event"] | IntegrationAttributesEvent["event"] | ReviewRequestedEvent["event"] | PermissionRequestedEvent["event"] | PermissionGrantedEvent["event"] | PermissionDeniedEvent["event"] | PaywallPreloadStartEvent["event"] | PaywallPreloadCompleteEvent["event"] | TestModeModalOpenEvent["event"] | TestModeModalCloseEvent["event"] | StripeCheckoutStartEvent["event"] | StripeCheckoutSubmitEvent["event"] | StripeCheckoutCompleteEvent["event"] | StripeCheckoutFailEvent["event"] | PaywallPageViewEvent["event"];
 /**
  * Represents a Superwall event that can be tracked by the SDK.
  * This is a discriminated union type where the `event` property determines the specific event and its associated payload.
  * These events provide insights into user behavior, SDK operations, and paywall interactions.
  */
-export type SuperwallEvent = FirstSeenEvent | AppOpenEvent | AppLaunchEvent | IdentityAliasEvent | AppInstallEvent | SessionStartEvent | ResetEvent | ConfigRefreshEvent | ConfigFailEvent | ConfigAttributesEvent | ConfirmAllAssignmentsEvent | TouchesBeganEvent | SurveyCloseEvent | RestoreStartEvent | RestoreCompleteEvent | RestoreFailEvent | AdServicesTokenRequestStartEvent | AdServicesTokenRequestFailEvent | AdServicesTokenRequestCompleteEvent | ShimmerViewStartEvent | ShimmerViewCompleteEvent | RedemptionStartEvent | RedemptionCompleteEvent | RedemptionFailEvent | EnrichmentStartEvent | EnrichmentCompleteEvent | EnrichmentFailEvent | UnknownEvent | DeviceAttributesEvent | SubscriptionStatusDidChangeEvent | AppCloseEvent | DeepLinkEvent | TriggerFireEvent | PaywallOpenEvent | PaywallCloseEvent | PaywallDeclineEvent | TransactionStartEvent | TransactionFailEvent | TransactionAbandonEvent | TransactionCompleteEvent | SubscriptionStartEvent | FreeTrialStartEvent | TransactionRestoreEvent | TransactionTimeoutEvent | UserAttributesEvent | NonRecurringProductPurchaseEvent | PaywallResponseLoadStartEvent | PaywallResponseLoadNotFoundEvent | PaywallResponseLoadFailEvent | PaywallResponseLoadCompleteEvent | PaywallWebviewLoadStartEvent | PaywallWebviewLoadFailEvent | PaywallWebviewLoadCompleteEvent | PaywallWebviewLoadTimeoutEvent | PaywallWebviewLoadFallbackEvent | PaywallProductsLoadStartEvent | PaywallProductsLoadFailEvent | PaywallProductsLoadCompleteEvent | PaywallProductsLoadRetryEvent | SurveyResponseEvent | PaywallPresentationRequestEvent | CustomPlacementEvent | PaywallWebviewProcessTerminatedEvent | PaywallProductsLoadMissingProductsEvent | NetworkDecodingFailEvent | CustomerInfoDidChangeEvent | IntegrationAttributesEvent | ReviewRequestedEvent | PermissionRequestedEvent | PermissionGrantedEvent | PermissionDeniedEvent | PaywallPreloadStartEvent | PaywallPreloadCompleteEvent | TestModeModalOpenEvent | TestModeModalCloseEvent | StripeCheckoutStartEvent | StripeCheckoutSubmitEvent | StripeCheckoutCompleteEvent | StripeCheckoutFailEvent;
+export type SuperwallEvent = FirstSeenEvent | AppOpenEvent | AppLaunchEvent | IdentityAliasEvent | AppInstallEvent | SessionStartEvent | ResetEvent | ConfigRefreshEvent | ConfigFailEvent | ConfigAttributesEvent | ConfirmAllAssignmentsEvent | TouchesBeganEvent | SurveyCloseEvent | RestoreStartEvent | RestoreCompleteEvent | RestoreFailEvent | AdServicesTokenRequestStartEvent | AdServicesTokenRequestFailEvent | AdServicesTokenRequestCompleteEvent | ShimmerViewStartEvent | ShimmerViewCompleteEvent | RedemptionStartEvent | RedemptionCompleteEvent | RedemptionFailEvent | EnrichmentStartEvent | EnrichmentCompleteEvent | EnrichmentFailEvent | UnknownEvent | DeviceAttributesEvent | SubscriptionStatusDidChangeEvent | AppCloseEvent | DeepLinkEvent | TriggerFireEvent | PaywallOpenEvent | PaywallCloseEvent | PaywallDeclineEvent | TransactionStartEvent | TransactionFailEvent | TransactionAbandonEvent | TransactionCompleteEvent | SubscriptionStartEvent | FreeTrialStartEvent | TransactionRestoreEvent | TransactionTimeoutEvent | UserAttributesEvent | NonRecurringProductPurchaseEvent | PaywallResponseLoadStartEvent | PaywallResponseLoadNotFoundEvent | PaywallResponseLoadFailEvent | PaywallResponseLoadCompleteEvent | PaywallWebviewLoadStartEvent | PaywallWebviewLoadFailEvent | PaywallWebviewLoadCompleteEvent | PaywallWebviewLoadTimeoutEvent | PaywallWebviewLoadFallbackEvent | PaywallProductsLoadStartEvent | PaywallProductsLoadFailEvent | PaywallProductsLoadCompleteEvent | PaywallProductsLoadRetryEvent | SurveyResponseEvent | PaywallPresentationRequestEvent | CustomPlacementEvent | PaywallWebviewProcessTerminatedEvent | PaywallProductsLoadMissingProductsEvent | NetworkDecodingFailEvent | CustomerInfoDidChangeEvent | IntegrationAttributesEvent | ReviewRequestedEvent | PermissionRequestedEvent | PermissionGrantedEvent | PermissionDeniedEvent | PaywallPreloadStartEvent | PaywallPreloadCompleteEvent | TestModeModalOpenEvent | TestModeModalCloseEvent | StripeCheckoutStartEvent | StripeCheckoutSubmitEvent | StripeCheckoutCompleteEvent | StripeCheckoutFailEvent | PaywallPageViewEvent;
 /**
  * Contains information about a Superwall event, including the specific {@link SuperwallEvent}
  * that occurred and any associated parameters. This structure is used by the `onSuperwallEvent` callback
@@ -1915,6 +2107,14 @@ export type LogScope = "localizationManager" | "bounceButton" | "coreData" | "co
 export type OnPurchaseParamsIOS = {
     productId: string;
     platform: "ios";
+    /**
+     * The store that backs the product being purchased. See {@link ProductStore}.
+     * When the value is `"CUSTOM"`, the product is not backed by StoreKit and your
+     * purchase handler must implement the purchase itself (e.g., calling your backend).
+     * May be `undefined` if the product cannot be matched against the most recently
+     * presented paywall (e.g., during background flows).
+     */
+    store?: ProductStore;
 };
 export type OnPurchaseParamsAndroid = {
     productId: string;
@@ -1923,6 +2123,17 @@ export type OnPurchaseParamsAndroid = {
     offerId?: string;
 };
 export type OnPurchaseParams = OnPurchaseParamsIOS | OnPurchaseParamsAndroid;
+/**
+ * Represents the result of a purchase restoration attempt.
+ * - `restored`: The restoration completed successfully.
+ * - `failed`: The restoration failed, with an accompanying error message.
+ */
+export type RestorationResultResponse = {
+    result: "restored";
+} | {
+    result: "failed";
+    errorMessage: string | null;
+};
 /**
  * Defines the events emitted by the native Superwall Expo module that can be listened to.
  * These events provide a way to react to various SDK activities and user interactions.