@virex-tech/paywallo-sdk 2.4.0 → 2.5.0

package/PaywalloSdk.podspec

@@ -12,7 +12,7 @@ Pod::Spec.new do |s|
   s.platforms    = { :ios => "15.0" }
   s.source       = { :git => "https://github.com/paywallo/sdk-react-native.git", :tag => "v#{s.version}" }
   s.source_files = "ios/**/*.{h,m,mm,swift}"
-  s.frameworks   = "Security", "StoreKit", "WebKit", "CoreTelephony", "AVFoundation", "UserNotifications"
+  s.frameworks   = "Security", "StoreKit", "AVFoundation", "UserNotifications"
   s.swift_version = "5.5"
 
   s.dependency "React-Core"

package/README.md

@@ -195,6 +195,44 @@ Intro offers are synced automatically from App Store Connect and Google Play —
 
 ---
 
+## What you integrate (and what you don't)
+
+The SDK is designed so the app wires the minimum. Wrap once with `<PaywalloProvider>` and the SDK initializes itself (no `init()` call) and tracks lifecycle automatically.
+
+| Concern | Who handles it |
+|---|---|
+| **App lifecycle** (`session_start/end`, `app_opened`, `cold_start`, install) | **Automatic** — just mount the Provider |
+| **Paywall** (`paywall_viewed`/`closed`) | **Automatic** |
+| **Screen views** | Opt-in helper (one line, see below) |
+| **Onboarding steps** | **You declare** them (with explicit `order`) |
+| **User identity** (`identify`) | **Optional** — never required for attribution |
+| **Sales / subscriptions** | **Server webhooks** (Apple/Google/Superwall/RevenueCat) — the SDK does **not** send purchases |
+
+### Onboarding tracking
+
+Declare each step with an explicit `order` — the funnel respects it instead of guessing by timestamp. Use decimals for A/B variants of the same step (e.g. `2` and `2.1`).
+
+```tsx
+import { PaywalloClient } from '@virex-tech/paywallo-sdk';
+
+await PaywalloClient.onboardingStep(1, 'welcome');
+await PaywalloClient.onboardingStep(2, 'goals');
+await PaywalloClient.onboardingStep(2.1, 'goals_variant_b'); // A/B variant of step 2
+```
+
+### Screen tracking (opt-in, one line)
+
+Plug the helper into your `NavigationContainer` once — every screen change emits `screen_view` automatically, with no per-screen `track` calls:
+
+```tsx
+import { usePaywalloScreenTracking } from '@virex-tech/paywallo-sdk';
+
+const onStateChange = usePaywalloScreenTracking();
+<NavigationContainer onStateChange={onStateChange}>...</NavigationContainer>
+```
+
+Works with React Navigation v6/v7 (no extra peer dependency).
+
 ## Imperative API
 
 For use outside React components:
@@ -202,11 +240,12 @@ For use outside React components:
 ```tsx
 import { PaywalloClient } from '@virex-tech/paywallo-sdk';
 
-// Identify user
-await PaywalloClient.identify({ email: 'user@example.com' });
+// Identify the user (optional — attribution works without it).
+// Model fields: email, firstName, lastName, dateOfBirth, gender, phone, properties.
+await PaywalloClient.identify({ email: 'user@example.com', firstName: 'Ana' });
 
-// Track events
-await PaywalloClient.track('purchase_completed', { properties: { product: 'premium' } });
+// Custom events
+await PaywalloClient.track('my_event', { properties: { plan: 'premium' } });
 
 // Feature flags
 const variant = await PaywalloClient.getVariant('new_feature');
@@ -215,6 +254,8 @@ const variant = await PaywalloClient.getVariant('new_feature');
 const hasAccess = await PaywalloClient.requireSubscriptionWithCampaign('premium');
 ```
 
+> Purchases are **not** sent from the SDK. Validate the receipt to unlock access (`usePurchase`/`requireSubscriptionWithCampaign` do this), and the sale is recorded from the store webhook on the server.
+
 ## Config options
 
 ```tsx

package/android/build.gradle

@@ -57,5 +57,4 @@ dependencies {
     // 1.1.0+ required for MasterKey.Builder API used in PaywalloStorageModule.
     // 1.0.0 only ships the deprecated MasterKeys.getOrCreate(...) static helper.
     implementation "androidx.security:security-crypto:1.1.0"
-    implementation "com.android.installreferrer:installreferrer:2.2"
 }

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

@@ -70,6 +70,13 @@ class PaywalloFBBridgeModule(private val reactContext: ReactApplicationContext)
         }
     }
 
+    @ReactMethod
+    fun fetchDeferredAppLink(promise: Promise) {
+        // Android usa Play Install Referrer (determinístico) para o fbclid;
+        // o deferred app link do FB é redundante aqui. Stub resolve null.
+        promise.resolve(null)
+    }
+
     private fun toBundle(map: ReadableMap): Bundle {
         val bundle = Bundle()
         val iterator = map.keySetIterator()

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

@@ -11,8 +11,7 @@ class PaywalloSdkPackage : ReactPackage {
             PaywalloStoreKitModule(reactContext),
             PaywalloFBBridgeModule(reactContext),
             PaywalloStorageModule(reactContext),
-            PaywalloDeviceModule(reactContext),
-            PaywalloNotificationsModule(reactContext),
+PaywalloNotificationsModule(reactContext),
             PaywalloEnvModule(reactContext)
         )
     }