@virex-tech/paywallo-sdk 1.4.1 → 1.5.2

package/android/src/main/java/com/paywallo/sdk/PaywalloWebView.kt

@@ -13,6 +13,7 @@ import android.webkit.WebView
 import android.webkit.WebViewClient
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.ReactContext
+import com.facebook.react.uimanager.UIManagerHelper
 import com.facebook.react.uimanager.events.RCTEventEmitter
 import org.json.JSONObject
 
@@ -30,11 +31,36 @@ class PaywalloWebView(context: ReactContext) : WebView(context) {
             javaScriptEnabled = true
             domStorageEnabled = true
             mediaPlaybackRequiresUserGesture = false
-            mixedContentMode = WebSettings.MIXED_CONTENT_ALWAYS_ALLOW
+            mixedContentMode = WebSettings.MIXED_CONTENT_NEVER_ALLOW
             cacheMode = WebSettings.LOAD_DEFAULT
         }
 
         webViewClient = object : WebViewClient() {
+            // Allow HTTPS and about: (initial blank) to load inside the WebView.
+            // Redirect mailto:, intent:, and market: to the OS. Block everything else
+            // (plain HTTP, javascript:, data:, blob:) to prevent mixed-content and injection.
+            override fun shouldOverrideUrlLoading(view: WebView?, request: WebResourceRequest?): Boolean {
+                val uri = request?.url ?: return true
+                val scheme = uri.scheme?.lowercase()
+
+                val osSchemes = setOf("mailto", "intent", "market")
+                if (scheme != null && scheme in osSchemes) {
+                    try {
+                        val intent = android.content.Intent(android.content.Intent.ACTION_VIEW, uri)
+                        intent.addFlags(android.content.Intent.FLAG_ACTIVITY_NEW_TASK)
+                        context.startActivity(intent)
+                    } catch (_: Exception) {
+                        // No app installed to handle this scheme — silently ignore.
+                    }
+                    return true // prevent WebView from loading it
+                }
+
+                if (scheme != null && scheme != "https" && scheme != "about") {
+                    return true // block the navigation
+                }
+                return false
+            }
+
             override fun onPageFinished(view: WebView?, url: String?) {
                 super.onPageFinished(view, url)
                 dispatchEvent("onLoadEnd", null)
@@ -88,6 +114,7 @@ class PaywalloWebView(context: ReactContext) : WebView(context) {
     private var pendingHtml: String? = null
 
     fun setSourceUrl(url: String?) {
+        // Only load URL if no inline HTML has been set — HTML takes precedence over URL
         if (pendingHtml.isNullOrEmpty()) {
             url?.let { loadUrl(it) }
         }
@@ -106,8 +133,17 @@ class PaywalloWebView(context: ReactContext) : WebView(context) {
         val event = Arguments.createMap().apply {
             data?.let { putString("data", it) }
         }
-        reactContext.getJSModule(RCTEventEmitter::class.java)
-            .receiveEvent(id, eventName, event)
+        // UIManagerHelper is the New Architecture path; fall back to legacy RCTEventEmitter
+        // for compatibility with React Native < 0.71 (Old Architecture)
+        val dispatcher = UIManagerHelper.getEventDispatcherForReactTag(reactContext, id)
+        if (dispatcher != null) {
+            val surfaceId = UIManagerHelper.getSurfaceId(reactContext)
+            dispatcher.dispatchEvent(PaywalloWebViewEvent(surfaceId, id, eventName, event))
+        } else {
+            @Suppress("DEPRECATION")
+            reactContext.getJSModule(RCTEventEmitter::class.java)
+                ?.receiveEvent(id, eventName, event)
+        }
     }
 
     inner class WebAppInterface {

package/android/src/main/java/com/paywallo/sdk/PaywalloWebViewEvent.kt

@@ -0,0 +1,20 @@
+package com.paywallo.sdk
+
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+/**
+ * Custom event that works with both Old Architecture (RCTEventEmitter) and
+ * New Architecture (EventDispatcher via UIManagerHelper).
+ */
+class PaywalloWebViewEvent(
+    surfaceId: Int,
+    viewId: Int,
+    private val eventName: String,
+    private val payload: WritableMap
+) : Event<PaywalloWebViewEvent>(surfaceId, viewId) {
+
+    override fun getEventName(): String = eventName
+
+    override fun getEventData(): WritableMap = payload
+}

package/dist/index.d.mts

@@ -51,7 +51,7 @@ interface TapBehavior {
     targetStepId?: string;
     placementName?: string;
 }
-type BlockType = "page" | "stack" | "text" | "button" | "image" | "icon" | "video" | "divider" | "spacer" | "lottie" | "carousel" | "navigation" | "tabs" | "fixed-footer" | "feature-card" | "bullet-item" | "timeline-item" | "simple-link" | "comparison-table" | "countdown" | "review" | "badge" | "popup" | "progress" | "social-proof" | "testimonial" | "accolades" | "sticker" | "product-card" | "toggle-option" | "delayed-close" | "close-button" | "back-button" | "trial-toggle" | "period-picker" | "product-list" | "exit-offer" | "spin-wheel";
+type BlockType = "page" | "stack" | "container" | "text" | "button" | "purchase-button" | "restore-button" | "image" | "icon" | "video" | "divider" | "spacer" | "lottie" | "carousel" | "navigation" | "tabs" | "fixed-footer" | "feature-card" | "bullet-item" | "timeline-item" | "simple-link" | "comparison-table" | "countdown" | "review" | "badge" | "popup" | "progress" | "social-proof" | "testimonial" | "accolades" | "sticker" | "product-card" | "product-cards" | "toggle-option" | "delayed-close" | "close-button" | "back-button" | "trial-toggle" | "period-picker" | "product-list" | "exit-offer" | "spin-wheel" | "form-input" | "rating-input" | "chart" | "gif" | "scroll-list" | "shared-block-ref";
 
 /**
  * Layout block props — page, stack, fixed-footer, popup.
@@ -116,7 +116,7 @@ interface ServerProductInfo {
 }
 interface CampaignResponse {
     campaignId: string;
-    placement?: string;
+    placement: string;
     variantKey: string;
     paywall: {
         id: string;
@@ -264,6 +264,7 @@ interface Subscription {
 interface SubscriptionStatusResponse$1 {
     hasActiveSubscription: boolean;
     subscription: Subscription | null;
+    entitlements: string[];
 }
 interface RestoreResult {
     success: boolean;
@@ -316,31 +317,6 @@ interface ConditionalFlagContext {
     country?: string;
     distinctId?: string;
 }
-interface AffiliateCoupon {
-    code: string;
-    status: string;
-    createdAt: Date;
-}
-interface AffiliateCommission {
-    id: string;
-    referredDistinctId: string;
-    purchaseAmount: number;
-    commissionAmount: number;
-    status: "pending" | "eligible" | "ineligible" | "withdrawn";
-    createdAt: Date;
-}
-interface AffiliateBalance {
-    total: number;
-    pending: number;
-    available: number;
-    withdrawn: number;
-}
-interface WithdrawalRequest {
-    id: string;
-    amount: number;
-    status: "pending" | "approved" | "rejected" | "paid";
-    createdAt: Date;
-}
 
 interface PaywallModalProps {
     placement: string;
@@ -472,7 +448,10 @@ declare class HttpClient {
     private shouldRetry;
     private isNetworkError;
     private calculateDelay;
+    private calculateDelayForResponse;
     private sleep;
+    /** Strips path segments that look like app keys (alphanumeric, 20–64 chars) from URLs before logging. */
+    private redactUrl;
     private log;
     setDebug(debug: boolean): void;
     getConfig(): Readonly<HttpClientConfig>;
@@ -487,10 +466,12 @@ declare class ApiClient {
     private offlineQueueEnabled;
     private httpClient;
     private readonly cache;
+    private readonly batcher;
     constructor(appKey: string, apiUrl: string, debug?: boolean, environment?: Environment, offlineQueueEnabled?: boolean, timeout?: number);
     getHttpClient(): HttpClient;
     getBaseUrl(): string;
     getWebUrl(): string;
+    getAppKey(): string;
     getEnvironment(): Environment;
     getQueueSize(): number;
     setofflineQueueEnabled(enabled: boolean): void;
@@ -502,8 +483,10 @@ declare class ApiClient {
     post<T>(path: string, body: unknown, skipRetry?: boolean): Promise<HttpResponse<T>>;
     reportError(errorType: string, message: string, context?: Record<string, unknown>): Promise<void>;
     trackEvent(eventName: string, distinctId: string, properties?: UserProperties, timestamp?: number): Promise<void>;
+    flushEventBatch(): Promise<void>;
+    dispose(): void;
     identify(distinctId: string, properties?: UserProperties, email?: string, deviceId?: string): Promise<void>;
-    startSession(distinctId: string, sessionId: string, platform?: string): Promise<{
+    startSession(distinctId: string, sessionId: string, platform?: string, appVersion?: string, deviceModel?: string, osVersion?: string): Promise<{
         success: boolean;
     }>;
     endSession(sessionId: string, durationSeconds: number): Promise<{
@@ -519,94 +502,14 @@ declare class ApiClient {
     evaluateFlags(keys: string[], distinctId: string): Promise<Record<string, string | null>>;
     getConditionalFlag(flagKey: string, context: ConditionalFlagContext): Promise<ConditionalFlagResult>;
     getVariantFromCache(flagKey: string, distinctId: string): Promise<FlagVariant | null>;
-    private static readonly FLAG_MAX_AGE_MS;
-    private readFlagFromStorage;
-    private writeFlagToStorage;
     private postWithQueue;
     private log;
 }
 
-declare class AffiliateManager {
-    private apiClient;
-    private debug;
-    initialize(apiClient: ApiClient, debug?: boolean): void;
-    registerCoupon(code: string): Promise<{
-        success: boolean;
-        coupon?: AffiliateCoupon;
-        error?: string;
-    }>;
-    applyCoupon(code: string): Promise<{
-        success: boolean;
-        applied?: boolean;
-        error?: string;
-    }>;
-    getMyCoupon(): Promise<{
-        coupon: AffiliateCoupon | null;
-    }>;
-    getAppliedCoupon(): Promise<{
-        coupon: {
-            code: string;
-        } | null;
-    }>;
-    getBalance(): Promise<AffiliateBalance>;
-    getCommissions(): Promise<AffiliateCommission[]>;
-    requestWithdrawal(amount: number): Promise<{
-        success: boolean;
-        withdrawal?: WithdrawalRequest;
-        error?: string;
-    }>;
-    getWithdrawals(): Promise<WithdrawalRequest[]>;
-    private get;
-    private post;
-    private ensureInitialized;
-    private log;
-}
-declare const affiliateManager: AffiliateManager;
-
-declare const PaywalloAffiliate: {
-    registerCoupon: (code: string) => Promise<{
-        success: boolean;
-        coupon?: AffiliateCoupon;
-        error?: string;
-    }>;
-    applyCoupon: (code: string) => Promise<{
-        success: boolean;
-        applied?: boolean;
-        error?: string;
-    }>;
-    getMyCoupon: () => Promise<{
-        coupon: AffiliateCoupon | null;
-    }>;
-    getAppliedCoupon: () => Promise<{
-        coupon: {
-            code: string;
-        } | null;
-    }>;
-    getBalance: () => Promise<AffiliateBalance>;
-    getCommissions: () => Promise<AffiliateCommission[]>;
-    requestWithdrawal: (amount: number) => Promise<{
-        success: boolean;
-        withdrawal?: WithdrawalRequest;
-        error?: string;
-    }>;
-    getWithdrawals: () => Promise<WithdrawalRequest[]>;
-};
-
-declare class AffiliateError extends PaywalloError {
-    constructor(code: string, message: string);
-}
-declare const AFFILIATE_ERROR_CODES: {
-    readonly NOT_INITIALIZED: "AFFILIATE_NOT_INITIALIZED";
-    readonly COUPON_REGISTER_FAILED: "AFFILIATE_COUPON_REGISTER_FAILED";
-    readonly COUPON_APPLY_FAILED: "AFFILIATE_COUPON_APPLY_FAILED";
-    readonly BALANCE_FETCH_FAILED: "AFFILIATE_BALANCE_FETCH_FAILED";
-    readonly WITHDRAWAL_FAILED: "AFFILIATE_WITHDRAWAL_FAILED";
-    readonly NETWORK_ERROR: "AFFILIATE_NETWORK_ERROR";
-};
-
 declare class IAPService {
     private productsCache;
     private apiClient;
+    private purchaseInFlight;
     constructor(apiClient?: ApiClient);
     private get debug();
     private getDeviceCountry;
@@ -690,7 +593,9 @@ declare class IdentityManager {
     private secureStorage;
     private debug;
     private initialized;
+    private initPromise;
     initialize(apiClient: ApiClient, debug?: boolean): Promise<string>;
+    private _doInitialize;
     identify(options?: IdentifyOptions | UserProperties): Promise<void>;
     getDistinctId(): string;
     getDeviceId(): string | null;
@@ -791,7 +696,7 @@ declare class SessionManager {
     isSessionActive(): boolean;
     getState(): SessionState;
     destroy(): void;
-    registerEmergencyPaywallHandler(handler: EmergencyPaywallHandler): void;
+    registerEmergencyPaywallHandler(handler: EmergencyPaywallHandler | null): void;
     private restoreSession;
     private setupAppStateListener;
     private handleAppStateChange;
@@ -875,12 +780,13 @@ interface IPaywalloClient {
     getSessionId(): string | null;
     startSession(): Promise<string>;
     endSession(): Promise<void>;
-    registerPaywallPresenter(presenter: (placement: string) => Promise<PaywallResult>): void;
-    registerCampaignPresenter(presenter: (campaign: CampaignResponse) => Promise<CampaignResult>): void;
-    registerSubscriptionGetter(getter: () => Promise<Subscription | null>): void;
-    registerActiveChecker(checker: () => Promise<boolean>): void;
-    registerRestoreHandler(handler: () => Promise<RestoreResult>): void;
-    registerEmergencyPaywallHandler(handler: EmergencyPaywallHandler): void;
+    registerPaywallPresenter(presenter: ((placement: string) => Promise<PaywallResult>) | null): void;
+    registerCampaignPresenter(presenter: ((campaign: CampaignResponse) => Promise<CampaignResult>) | null): void;
+    registerSubscriptionGetter(getter: (() => Promise<Subscription | null>) | null): void;
+    registerActiveChecker(checker: (() => Promise<boolean>) | null): void;
+    registerRestoreHandler(handler: (() => Promise<RestoreResult>) | null): void;
+    registerEmergencyPaywallHandler(handler: EmergencyPaywallHandler | null): void;
+    getEmergencyPaywall(): Promise<EmergencyPaywallResponse>;
     getSessionFlag(key: string): string | null;
     isOnline(): boolean;
     getOfflineQueueSize(): number;
@@ -983,6 +889,7 @@ declare class QueueProcessorClass {
         processed: number;
         failed: number;
     }>;
+    private processEventBatches;
     private processItem;
     enqueueIfOffline(method: "POST" | "PUT", url: string, body: unknown, headers?: Record<string, string>): Promise<{
         queued: boolean;
@@ -1114,6 +1021,8 @@ declare class SubscriptionCache {
     private cleanupLegacyCache;
     get(distinctId: string): Promise<CachedSubscription | null>;
     set(distinctId: string, data: SubscriptionStatusResponse): Promise<void>;
+    private addToIndex;
+    private readIndex;
     invalidate(distinctId: string): Promise<void>;
     invalidateAll(): Promise<void>;
     private isExpired;
@@ -1180,4 +1089,4 @@ declare function hasVariables(text: string): boolean;
 
 declare const Paywallo: IPaywalloClient;
 
-export { AFFILIATE_ERROR_CODES, ANALYTICS_ERROR_CODES, type AffiliateBalance, type AffiliateCommission, type AffiliateCoupon, AffiliateError, AffiliateManager, AnalyticsError, ApiClient, type ApiClientConfig, type BlockType, type BoxSpacing, CAMPAIGN_ERROR_CODES, type CachedSubscription, CampaignError, type CampaignPresentOptions, type CampaignResponse, type CampaignResult, type ConditionalFlagContext, type ConditionalFlagResult, PURCHASE_ERROR_CODES as ERROR_CODES, type Environment, type FlagVariant, HttpClient, type HttpClientConfig, type HttpResponse, type IAPProduct, type IAPPurchase, IAPService, IDENTITY_ERROR_CODES, type IPaywalloClient, type IdentifyOptions, IdentityError, IdentityManager, type IdentityState, type LocalizedText, MetaBridge, type NetworkListener, type NetworkMonitorConfig, type NetworkState, type OfflineQueueConfig, PAYWALL_ERROR_CODES, PURCHASE_ERROR_CODES, type PaywallBlockConfig, type PaywallConfig, PaywallContext, PaywallError, type PaywallErrorStrings$1 as PaywallErrorStrings, PaywallModal, type PaywallNode, type PaywallPresentOptions, type PaywallResult, type PaywallState, Paywallo, PaywalloAffiliate, PaywalloClient, type PaywalloConfig, PaywalloContext, PaywalloError, type PaywalloInitConfig, PaywalloProvider, type PaywalloProviderProps, type PreloadCampaignResult, type PreloadResult, type Product, type ProductPriceInfo, type Purchase, type PurchaseControllerConfig, PurchaseError, type PurchaseResult, type PurchaseState, type QueueEvent, type QueueItem, type QueueListener, type QueueProcessorConfig, type RequestOptions, type RestoreResult, type RetryConfig, SESSION_ERROR_CODES, type SessionConfig, SessionError, SessionManager, type SessionState, type Subscription, SubscriptionCache, type SubscriptionInfo, type SubscriptionManagerConfig, type SubscriptionPlatform, type SubscriptionStatus$1 as SubscriptionStatus, type SubscriptionStatusResponse$1 as SubscriptionStatusResponse, type TapBehavior, type TrackEventOptions, type UserProperties, type ValidatePurchaseResponse, type VariableContext, type WithdrawalRequest, affiliateManager, createPurchaseError, Paywallo as default, detectDeviceLanguage, getCurrentLanguage, getDefaultLanguage, getIAPService, getLocalizedString, hasVariables, identityManager, initLocalization, metaBridge, nativeStoreKit, networkMonitor, offlineQueue, parseVariables, queueProcessor, resolveText, sessionManager, setCurrentLanguage, setDefaultLanguage, subscriptionManager, usePaywallContext, usePaywallo, useProducts, usePurchase, useSubscription };
+export { ANALYTICS_ERROR_CODES, AnalyticsError, ApiClient, type ApiClientConfig, type BlockType, type BoxSpacing, CAMPAIGN_ERROR_CODES, type CachedSubscription, CampaignError, type CampaignPresentOptions, type CampaignResponse, type CampaignResult, type ConditionalFlagContext, type ConditionalFlagResult, PURCHASE_ERROR_CODES as ERROR_CODES, type EmergencyPaywallResponse, type Environment, type FlagVariant, HttpClient, type HttpClientConfig, type HttpResponse, type IAPProduct, type IAPPurchase, IAPService, IDENTITY_ERROR_CODES, type IPaywalloClient, type IdentifyOptions, IdentityError, IdentityManager, type IdentityState, type LocalizedText, MetaBridge, type NetworkListener, type NetworkMonitorConfig, type NetworkState, type OfflineQueueConfig, PAYWALL_ERROR_CODES, PURCHASE_ERROR_CODES, type PaywallBlockConfig, type PaywallConfig, PaywallContext, PaywallError, type PaywallErrorStrings$1 as PaywallErrorStrings, PaywallModal, type PaywallNode, type PaywallPresentOptions, type PaywallResult, type PaywallState, Paywallo, PaywalloClient, type PaywalloConfig, PaywalloContext, PaywalloError, type PaywalloInitConfig, PaywalloProvider, type PaywalloProviderProps, type PreloadCampaignResult, type PreloadResult, type Product, type ProductPriceInfo, type Purchase, type PurchaseControllerConfig, PurchaseError, type PurchaseResult, type PurchaseState, type QueueEvent, type QueueItem, type QueueListener, type QueueProcessorConfig, type RequestOptions, type RestoreResult, type RetryConfig, SESSION_ERROR_CODES, type SessionConfig, SessionError, SessionManager, type SessionState, type Subscription, SubscriptionCache, type SubscriptionInfo, type SubscriptionManagerConfig, type SubscriptionPlatform, type SubscriptionStatus$1 as SubscriptionStatus, type SubscriptionStatusResponse$1 as SubscriptionStatusResponse, type TapBehavior, type TrackEventOptions, type UserProperties, type ValidatePurchaseResponse, type VariableContext, createPurchaseError, Paywallo as default, detectDeviceLanguage, getCurrentLanguage, getDefaultLanguage, getIAPService, getLocalizedString, hasVariables, identityManager, initLocalization, metaBridge, nativeStoreKit, networkMonitor, offlineQueue, parseVariables, queueProcessor, resolveText, sessionManager, setCurrentLanguage, setDefaultLanguage, subscriptionManager, usePaywallContext, usePaywallo, useProducts, usePurchase, useSubscription };

package/dist/index.d.ts

@@ -51,7 +51,7 @@ interface TapBehavior {
     targetStepId?: string;
     placementName?: string;
 }
-type BlockType = "page" | "stack" | "text" | "button" | "image" | "icon" | "video" | "divider" | "spacer" | "lottie" | "carousel" | "navigation" | "tabs" | "fixed-footer" | "feature-card" | "bullet-item" | "timeline-item" | "simple-link" | "comparison-table" | "countdown" | "review" | "badge" | "popup" | "progress" | "social-proof" | "testimonial" | "accolades" | "sticker" | "product-card" | "toggle-option" | "delayed-close" | "close-button" | "back-button" | "trial-toggle" | "period-picker" | "product-list" | "exit-offer" | "spin-wheel";
+type BlockType = "page" | "stack" | "container" | "text" | "button" | "purchase-button" | "restore-button" | "image" | "icon" | "video" | "divider" | "spacer" | "lottie" | "carousel" | "navigation" | "tabs" | "fixed-footer" | "feature-card" | "bullet-item" | "timeline-item" | "simple-link" | "comparison-table" | "countdown" | "review" | "badge" | "popup" | "progress" | "social-proof" | "testimonial" | "accolades" | "sticker" | "product-card" | "product-cards" | "toggle-option" | "delayed-close" | "close-button" | "back-button" | "trial-toggle" | "period-picker" | "product-list" | "exit-offer" | "spin-wheel" | "form-input" | "rating-input" | "chart" | "gif" | "scroll-list" | "shared-block-ref";
 
 /**
  * Layout block props — page, stack, fixed-footer, popup.
@@ -116,7 +116,7 @@ interface ServerProductInfo {
 }
 interface CampaignResponse {
     campaignId: string;
-    placement?: string;
+    placement: string;
     variantKey: string;
     paywall: {
         id: string;
@@ -264,6 +264,7 @@ interface Subscription {
 interface SubscriptionStatusResponse$1 {
     hasActiveSubscription: boolean;
     subscription: Subscription | null;
+    entitlements: string[];
 }
 interface RestoreResult {
     success: boolean;
@@ -316,31 +317,6 @@ interface ConditionalFlagContext {
     country?: string;
     distinctId?: string;
 }
-interface AffiliateCoupon {
-    code: string;
-    status: string;
-    createdAt: Date;
-}
-interface AffiliateCommission {
-    id: string;
-    referredDistinctId: string;
-    purchaseAmount: number;
-    commissionAmount: number;
-    status: "pending" | "eligible" | "ineligible" | "withdrawn";
-    createdAt: Date;
-}
-interface AffiliateBalance {
-    total: number;
-    pending: number;
-    available: number;
-    withdrawn: number;
-}
-interface WithdrawalRequest {
-    id: string;
-    amount: number;
-    status: "pending" | "approved" | "rejected" | "paid";
-    createdAt: Date;
-}
 
 interface PaywallModalProps {
     placement: string;
@@ -472,7 +448,10 @@ declare class HttpClient {
     private shouldRetry;
     private isNetworkError;
     private calculateDelay;
+    private calculateDelayForResponse;
     private sleep;
+    /** Strips path segments that look like app keys (alphanumeric, 20–64 chars) from URLs before logging. */
+    private redactUrl;
     private log;
     setDebug(debug: boolean): void;
     getConfig(): Readonly<HttpClientConfig>;
@@ -487,10 +466,12 @@ declare class ApiClient {
     private offlineQueueEnabled;
     private httpClient;
     private readonly cache;
+    private readonly batcher;
     constructor(appKey: string, apiUrl: string, debug?: boolean, environment?: Environment, offlineQueueEnabled?: boolean, timeout?: number);
     getHttpClient(): HttpClient;
     getBaseUrl(): string;
     getWebUrl(): string;
+    getAppKey(): string;
     getEnvironment(): Environment;
     getQueueSize(): number;
     setofflineQueueEnabled(enabled: boolean): void;
@@ -502,8 +483,10 @@ declare class ApiClient {
     post<T>(path: string, body: unknown, skipRetry?: boolean): Promise<HttpResponse<T>>;
     reportError(errorType: string, message: string, context?: Record<string, unknown>): Promise<void>;
     trackEvent(eventName: string, distinctId: string, properties?: UserProperties, timestamp?: number): Promise<void>;
+    flushEventBatch(): Promise<void>;
+    dispose(): void;
     identify(distinctId: string, properties?: UserProperties, email?: string, deviceId?: string): Promise<void>;
-    startSession(distinctId: string, sessionId: string, platform?: string): Promise<{
+    startSession(distinctId: string, sessionId: string, platform?: string, appVersion?: string, deviceModel?: string, osVersion?: string): Promise<{
         success: boolean;
     }>;
     endSession(sessionId: string, durationSeconds: number): Promise<{
@@ -519,94 +502,14 @@ declare class ApiClient {
     evaluateFlags(keys: string[], distinctId: string): Promise<Record<string, string | null>>;
     getConditionalFlag(flagKey: string, context: ConditionalFlagContext): Promise<ConditionalFlagResult>;
     getVariantFromCache(flagKey: string, distinctId: string): Promise<FlagVariant | null>;
-    private static readonly FLAG_MAX_AGE_MS;
-    private readFlagFromStorage;
-    private writeFlagToStorage;
     private postWithQueue;
     private log;
 }
 
-declare class AffiliateManager {
-    private apiClient;
-    private debug;
-    initialize(apiClient: ApiClient, debug?: boolean): void;
-    registerCoupon(code: string): Promise<{
-        success: boolean;
-        coupon?: AffiliateCoupon;
-        error?: string;
-    }>;
-    applyCoupon(code: string): Promise<{
-        success: boolean;
-        applied?: boolean;
-        error?: string;
-    }>;
-    getMyCoupon(): Promise<{
-        coupon: AffiliateCoupon | null;
-    }>;
-    getAppliedCoupon(): Promise<{
-        coupon: {
-            code: string;
-        } | null;
-    }>;
-    getBalance(): Promise<AffiliateBalance>;
-    getCommissions(): Promise<AffiliateCommission[]>;
-    requestWithdrawal(amount: number): Promise<{
-        success: boolean;
-        withdrawal?: WithdrawalRequest;
-        error?: string;
-    }>;
-    getWithdrawals(): Promise<WithdrawalRequest[]>;
-    private get;
-    private post;
-    private ensureInitialized;
-    private log;
-}
-declare const affiliateManager: AffiliateManager;
-
-declare const PaywalloAffiliate: {
-    registerCoupon: (code: string) => Promise<{
-        success: boolean;
-        coupon?: AffiliateCoupon;
-        error?: string;
-    }>;
-    applyCoupon: (code: string) => Promise<{
-        success: boolean;
-        applied?: boolean;
-        error?: string;
-    }>;
-    getMyCoupon: () => Promise<{
-        coupon: AffiliateCoupon | null;
-    }>;
-    getAppliedCoupon: () => Promise<{
-        coupon: {
-            code: string;
-        } | null;
-    }>;
-    getBalance: () => Promise<AffiliateBalance>;
-    getCommissions: () => Promise<AffiliateCommission[]>;
-    requestWithdrawal: (amount: number) => Promise<{
-        success: boolean;
-        withdrawal?: WithdrawalRequest;
-        error?: string;
-    }>;
-    getWithdrawals: () => Promise<WithdrawalRequest[]>;
-};
-
-declare class AffiliateError extends PaywalloError {
-    constructor(code: string, message: string);
-}
-declare const AFFILIATE_ERROR_CODES: {
-    readonly NOT_INITIALIZED: "AFFILIATE_NOT_INITIALIZED";
-    readonly COUPON_REGISTER_FAILED: "AFFILIATE_COUPON_REGISTER_FAILED";
-    readonly COUPON_APPLY_FAILED: "AFFILIATE_COUPON_APPLY_FAILED";
-    readonly BALANCE_FETCH_FAILED: "AFFILIATE_BALANCE_FETCH_FAILED";
-    readonly WITHDRAWAL_FAILED: "AFFILIATE_WITHDRAWAL_FAILED";
-    readonly NETWORK_ERROR: "AFFILIATE_NETWORK_ERROR";
-};
-
 declare class IAPService {
     private productsCache;
     private apiClient;
+    private purchaseInFlight;
     constructor(apiClient?: ApiClient);
     private get debug();
     private getDeviceCountry;
@@ -690,7 +593,9 @@ declare class IdentityManager {
     private secureStorage;
     private debug;
     private initialized;
+    private initPromise;
     initialize(apiClient: ApiClient, debug?: boolean): Promise<string>;
+    private _doInitialize;
     identify(options?: IdentifyOptions | UserProperties): Promise<void>;
     getDistinctId(): string;
     getDeviceId(): string | null;
@@ -791,7 +696,7 @@ declare class SessionManager {
     isSessionActive(): boolean;
     getState(): SessionState;
     destroy(): void;
-    registerEmergencyPaywallHandler(handler: EmergencyPaywallHandler): void;
+    registerEmergencyPaywallHandler(handler: EmergencyPaywallHandler | null): void;
     private restoreSession;
     private setupAppStateListener;
     private handleAppStateChange;
@@ -875,12 +780,13 @@ interface IPaywalloClient {
     getSessionId(): string | null;
     startSession(): Promise<string>;
     endSession(): Promise<void>;
-    registerPaywallPresenter(presenter: (placement: string) => Promise<PaywallResult>): void;
-    registerCampaignPresenter(presenter: (campaign: CampaignResponse) => Promise<CampaignResult>): void;
-    registerSubscriptionGetter(getter: () => Promise<Subscription | null>): void;
-    registerActiveChecker(checker: () => Promise<boolean>): void;
-    registerRestoreHandler(handler: () => Promise<RestoreResult>): void;
-    registerEmergencyPaywallHandler(handler: EmergencyPaywallHandler): void;
+    registerPaywallPresenter(presenter: ((placement: string) => Promise<PaywallResult>) | null): void;
+    registerCampaignPresenter(presenter: ((campaign: CampaignResponse) => Promise<CampaignResult>) | null): void;
+    registerSubscriptionGetter(getter: (() => Promise<Subscription | null>) | null): void;
+    registerActiveChecker(checker: (() => Promise<boolean>) | null): void;
+    registerRestoreHandler(handler: (() => Promise<RestoreResult>) | null): void;
+    registerEmergencyPaywallHandler(handler: EmergencyPaywallHandler | null): void;
+    getEmergencyPaywall(): Promise<EmergencyPaywallResponse>;
     getSessionFlag(key: string): string | null;
     isOnline(): boolean;
     getOfflineQueueSize(): number;
@@ -983,6 +889,7 @@ declare class QueueProcessorClass {
         processed: number;
         failed: number;
     }>;
+    private processEventBatches;
     private processItem;
     enqueueIfOffline(method: "POST" | "PUT", url: string, body: unknown, headers?: Record<string, string>): Promise<{
         queued: boolean;
@@ -1114,6 +1021,8 @@ declare class SubscriptionCache {
     private cleanupLegacyCache;
     get(distinctId: string): Promise<CachedSubscription | null>;
     set(distinctId: string, data: SubscriptionStatusResponse): Promise<void>;
+    private addToIndex;
+    private readIndex;
     invalidate(distinctId: string): Promise<void>;
     invalidateAll(): Promise<void>;
     private isExpired;
@@ -1180,4 +1089,4 @@ declare function hasVariables(text: string): boolean;
 
 declare const Paywallo: IPaywalloClient;
 
-export { AFFILIATE_ERROR_CODES, ANALYTICS_ERROR_CODES, type AffiliateBalance, type AffiliateCommission, type AffiliateCoupon, AffiliateError, AffiliateManager, AnalyticsError, ApiClient, type ApiClientConfig, type BlockType, type BoxSpacing, CAMPAIGN_ERROR_CODES, type CachedSubscription, CampaignError, type CampaignPresentOptions, type CampaignResponse, type CampaignResult, type ConditionalFlagContext, type ConditionalFlagResult, PURCHASE_ERROR_CODES as ERROR_CODES, type Environment, type FlagVariant, HttpClient, type HttpClientConfig, type HttpResponse, type IAPProduct, type IAPPurchase, IAPService, IDENTITY_ERROR_CODES, type IPaywalloClient, type IdentifyOptions, IdentityError, IdentityManager, type IdentityState, type LocalizedText, MetaBridge, type NetworkListener, type NetworkMonitorConfig, type NetworkState, type OfflineQueueConfig, PAYWALL_ERROR_CODES, PURCHASE_ERROR_CODES, type PaywallBlockConfig, type PaywallConfig, PaywallContext, PaywallError, type PaywallErrorStrings$1 as PaywallErrorStrings, PaywallModal, type PaywallNode, type PaywallPresentOptions, type PaywallResult, type PaywallState, Paywallo, PaywalloAffiliate, PaywalloClient, type PaywalloConfig, PaywalloContext, PaywalloError, type PaywalloInitConfig, PaywalloProvider, type PaywalloProviderProps, type PreloadCampaignResult, type PreloadResult, type Product, type ProductPriceInfo, type Purchase, type PurchaseControllerConfig, PurchaseError, type PurchaseResult, type PurchaseState, type QueueEvent, type QueueItem, type QueueListener, type QueueProcessorConfig, type RequestOptions, type RestoreResult, type RetryConfig, SESSION_ERROR_CODES, type SessionConfig, SessionError, SessionManager, type SessionState, type Subscription, SubscriptionCache, type SubscriptionInfo, type SubscriptionManagerConfig, type SubscriptionPlatform, type SubscriptionStatus$1 as SubscriptionStatus, type SubscriptionStatusResponse$1 as SubscriptionStatusResponse, type TapBehavior, type TrackEventOptions, type UserProperties, type ValidatePurchaseResponse, type VariableContext, type WithdrawalRequest, affiliateManager, createPurchaseError, Paywallo as default, detectDeviceLanguage, getCurrentLanguage, getDefaultLanguage, getIAPService, getLocalizedString, hasVariables, identityManager, initLocalization, metaBridge, nativeStoreKit, networkMonitor, offlineQueue, parseVariables, queueProcessor, resolveText, sessionManager, setCurrentLanguage, setDefaultLanguage, subscriptionManager, usePaywallContext, usePaywallo, useProducts, usePurchase, useSubscription };
+export { ANALYTICS_ERROR_CODES, AnalyticsError, ApiClient, type ApiClientConfig, type BlockType, type BoxSpacing, CAMPAIGN_ERROR_CODES, type CachedSubscription, CampaignError, type CampaignPresentOptions, type CampaignResponse, type CampaignResult, type ConditionalFlagContext, type ConditionalFlagResult, PURCHASE_ERROR_CODES as ERROR_CODES, type EmergencyPaywallResponse, type Environment, type FlagVariant, HttpClient, type HttpClientConfig, type HttpResponse, type IAPProduct, type IAPPurchase, IAPService, IDENTITY_ERROR_CODES, type IPaywalloClient, type IdentifyOptions, IdentityError, IdentityManager, type IdentityState, type LocalizedText, MetaBridge, type NetworkListener, type NetworkMonitorConfig, type NetworkState, type OfflineQueueConfig, PAYWALL_ERROR_CODES, PURCHASE_ERROR_CODES, type PaywallBlockConfig, type PaywallConfig, PaywallContext, PaywallError, type PaywallErrorStrings$1 as PaywallErrorStrings, PaywallModal, type PaywallNode, type PaywallPresentOptions, type PaywallResult, type PaywallState, Paywallo, PaywalloClient, type PaywalloConfig, PaywalloContext, PaywalloError, type PaywalloInitConfig, PaywalloProvider, type PaywalloProviderProps, type PreloadCampaignResult, type PreloadResult, type Product, type ProductPriceInfo, type Purchase, type PurchaseControllerConfig, PurchaseError, type PurchaseResult, type PurchaseState, type QueueEvent, type QueueItem, type QueueListener, type QueueProcessorConfig, type RequestOptions, type RestoreResult, type RetryConfig, SESSION_ERROR_CODES, type SessionConfig, SessionError, SessionManager, type SessionState, type Subscription, SubscriptionCache, type SubscriptionInfo, type SubscriptionManagerConfig, type SubscriptionPlatform, type SubscriptionStatus$1 as SubscriptionStatus, type SubscriptionStatusResponse$1 as SubscriptionStatusResponse, type TapBehavior, type TrackEventOptions, type UserProperties, type ValidatePurchaseResponse, type VariableContext, createPurchaseError, Paywallo as default, detectDeviceLanguage, getCurrentLanguage, getDefaultLanguage, getIAPService, getLocalizedString, hasVariables, identityManager, initLocalization, metaBridge, nativeStoreKit, networkMonitor, offlineQueue, parseVariables, queueProcessor, resolveText, sessionManager, setCurrentLanguage, setDefaultLanguage, subscriptionManager, usePaywallContext, usePaywallo, useProducts, usePurchase, useSubscription };