rampkit-expo-dev 0.0.61 → 0.0.63

package/build/EventManager.d.ts

@@ -2,7 +2,7 @@
  * RampKit Event Manager
  * Handles event tracking for the /app-user-events endpoint
  */
-import { DeviceInfo, EventContext, RampKitEventName } from "./types";
+import { DeviceInfo, EventContext, RampKitEventName, PurchaseCompletedProperties, PurchaseStartedProperties, PurchaseRestoredProperties } from "./types";
 declare class EventManager {
     private static _instance;
     private appId;
@@ -67,50 +67,47 @@ declare class EventManager {
      * Track app session started
      */
     trackAppSessionStarted(isFirstLaunch: boolean, launchCount: number): void;
-    /**
-     * Track app backgrounded
-     */
-    trackAppBackgrounded(sessionDurationSeconds: number): void;
-    /**
-     * Track app foregrounded
-     */
-    trackAppForegrounded(): void;
-    /**
-     * Track screen view
-     */
-    trackScreenView(screenName: string, referrer?: string): void;
-    /**
-     * Track CTA tap
-     */
-    trackCtaTap(buttonId: string, buttonText?: string): void;
     /**
      * Track onboarding started
      */
     trackOnboardingStarted(onboardingId: string, totalSteps?: number): void;
     /**
-     * Track onboarding screen viewed
+     * Track onboarding abandoned
      */
-    trackOnboardingScreenViewed(screenName: string, screenIndex: number, totalScreens: number, onboardingId?: string): void;
+    trackOnboardingAbandoned(reason: string, lastScreenName?: string, onboardingId?: string): void;
     /**
-     * Track onboarding question answered
+     * Check if onboarding has already been marked as completed
      */
-    trackOnboardingQuestionAnswered(questionId: string, answer: any, questionText?: string, onboardingId?: string): void;
+    hasOnboardingBeenCompleted(): Promise<boolean>;
     /**
-     * Track onboarding completed
+     * Mark onboarding as completed in persistent storage
      */
-    trackOnboardingCompleted(completedSteps: number, totalSteps: number, onboardingId?: string): void;
+    private markOnboardingAsCompleted;
     /**
-     * Track onboarding abandoned
+     * Reset onboarding completion status (useful for testing or user reset)
      */
-    trackOnboardingAbandoned(reason: string, lastScreenName?: string, onboardingId?: string): void;
+    resetOnboardingCompletionStatus(): Promise<void>;
     /**
-     * Track notification prompt shown
+     * Track onboarding completed event - fires ONCE per user
+     * Called when:
+     * 1. User completes the onboarding flow (onboarding-finished action)
+     * 2. User closes the onboarding (close action)
+     * 3. A paywall is shown (show-paywall action)
+     *
+     * @param trigger - The reason for completion ("finished", "closed", "paywall_shown")
+     * @param completedSteps - Number of steps the user completed
+     * @param totalSteps - Total number of steps in the onboarding
+     * @param onboardingId - The onboarding ID
      */
-    trackNotificationsPromptShown(): void;
+    trackOnboardingCompletedOnce(trigger: string, completedSteps?: number, totalSteps?: number, onboardingId?: string): Promise<void>;
     /**
      * Track notification response
      */
     trackNotificationsResponse(status: "granted" | "denied" | "provisional"): void;
+    /**
+     * Track option selected (interaction event)
+     */
+    trackOptionSelected(optionId: string, optionValue: any, questionId?: string): void;
     /**
      * Track paywall shown
      */
@@ -119,33 +116,25 @@ declare class EventManager {
         price?: number;
         currency?: string;
     }>): void;
-    /**
-     * Track paywall primary action tap
-     */
-    trackPaywallPrimaryActionTap(paywallId: string, productId?: string): void;
-    /**
-     * Track paywall closed
-     */
-    trackPaywallClosed(paywallId: string, reason: "dismissed" | "purchased" | "backgrounded"): void;
     /**
      * Track purchase started
+     * Call this when user initiates a purchase from a paywall
      */
-    trackPurchaseStarted(productId: string, amount?: number, currency?: string): void;
+    trackPurchaseStarted(properties: PurchaseStartedProperties): void;
     /**
      * Track purchase completed
+     * CRITICAL: originalTransactionId is required for attribution
+     * Context (paywallId, screenName, flowId) is automatically included
      */
-    trackPurchaseCompleted(properties: {
-        productId: string;
-        amount: number;
-        currency: string;
-        transactionId: string;
-        originalTransactionId?: string;
-        purchaseDate?: string;
-    }): void;
+    trackPurchaseCompleted(properties: PurchaseCompletedProperties): void;
     /**
      * Track purchase failed
      */
     trackPurchaseFailed(productId: string, errorCode: string, errorMessage: string): void;
+    /**
+     * Track purchase restored
+     */
+    trackPurchaseRestored(properties: PurchaseRestoredProperties): void;
     /**
      * Reset the event manager (e.g., on logout)
      */

package/build/EventManager.js

@@ -6,6 +6,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventManager = exports.eventManager = void 0;
 const constants_1 = require("./constants");
+const RampKitNative_1 = require("./RampKitNative");
 /**
  * Generate a UUID v4 using Math.random
  * This is sufficient for event IDs - no crypto dependency needed
@@ -202,31 +203,6 @@ class EventManager {
     trackAppSessionStarted(isFirstLaunch, launchCount) {
         this.track("app_session_started", { isFirstLaunch, launchCount });
     }
-    /**
-     * Track app backgrounded
-     */
-    trackAppBackgrounded(sessionDurationSeconds) {
-        this.track("app_backgrounded", { sessionDurationSeconds });
-    }
-    /**
-     * Track app foregrounded
-     */
-    trackAppForegrounded() {
-        this.track("app_foregrounded", {});
-    }
-    /**
-     * Track screen view
-     */
-    trackScreenView(screenName, referrer) {
-        this.setCurrentScreen(screenName);
-        this.track("screen_view", { screenName, referrer });
-    }
-    /**
-     * Track CTA tap
-     */
-    trackCtaTap(buttonId, buttonText) {
-        this.track("cta_tap", { buttonId, buttonText });
-    }
     /**
      * Track onboarding started
      */
@@ -235,59 +211,88 @@ class EventManager {
         this.track("onboarding_started", { onboardingId, totalSteps });
     }
     /**
-     * Track onboarding screen viewed
+     * Track onboarding abandoned
      */
-    trackOnboardingScreenViewed(screenName, screenIndex, totalScreens, onboardingId) {
-        this.setCurrentScreen(screenName);
-        this.track("onboarding_screen_viewed", {
+    trackOnboardingAbandoned(reason, lastScreenName, onboardingId) {
+        const timeSpentSeconds = this.getOnboardingDurationSeconds();
+        this.track("onboarding_abandoned", {
             onboardingId: onboardingId || this.currentOnboardingId,
-            screenName,
-            screenIndex,
-            totalScreens,
+            reason,
+            lastScreenName,
+            timeSpentSeconds,
         });
+        this.endOnboardingTracking();
     }
+    // ============================================================================
+    // Onboarding Completion (Once Per User)
+    // ============================================================================
     /**
-     * Track onboarding question answered
+     * Check if onboarding has already been marked as completed
      */
-    trackOnboardingQuestionAnswered(questionId, answer, questionText, onboardingId) {
-        this.track("onboarding_question_answered", {
-            onboardingId: onboardingId || this.currentOnboardingId,
-            questionId,
-            answer,
-            questionText,
-        });
+    async hasOnboardingBeenCompleted() {
+        try {
+            const value = await (0, RampKitNative_1.getStoredValue)(constants_1.STORAGE_KEYS.ONBOARDING_COMPLETED);
+            return value === "true";
+        }
+        catch (_a) {
+            return false;
+        }
     }
     /**
-     * Track onboarding completed
+     * Mark onboarding as completed in persistent storage
      */
-    trackOnboardingCompleted(completedSteps, totalSteps, onboardingId) {
+    async markOnboardingAsCompleted() {
+        try {
+            await (0, RampKitNative_1.setStoredValue)(constants_1.STORAGE_KEYS.ONBOARDING_COMPLETED, "true");
+            console.log("[RampKit] EventManager: onboarding marked as completed (persisted)");
+        }
+        catch (error) {
+            console.warn("[RampKit] EventManager: failed to persist onboarding completion:", error);
+        }
+    }
+    /**
+     * Reset onboarding completion status (useful for testing or user reset)
+     */
+    async resetOnboardingCompletionStatus() {
+        try {
+            await (0, RampKitNative_1.setStoredValue)(constants_1.STORAGE_KEYS.ONBOARDING_COMPLETED, "");
+            console.log("[RampKit] EventManager: onboarding completion status reset");
+        }
+        catch (error) {
+            console.warn("[RampKit] EventManager: failed to reset onboarding completion:", error);
+        }
+    }
+    /**
+     * Track onboarding completed event - fires ONCE per user
+     * Called when:
+     * 1. User completes the onboarding flow (onboarding-finished action)
+     * 2. User closes the onboarding (close action)
+     * 3. A paywall is shown (show-paywall action)
+     *
+     * @param trigger - The reason for completion ("finished", "closed", "paywall_shown")
+     * @param completedSteps - Number of steps the user completed
+     * @param totalSteps - Total number of steps in the onboarding
+     * @param onboardingId - The onboarding ID
+     */
+    async trackOnboardingCompletedOnce(trigger, completedSteps, totalSteps, onboardingId) {
+        // Check if already completed - skip if so
+        const alreadyCompleted = await this.hasOnboardingBeenCompleted();
+        if (alreadyCompleted) {
+            console.log(`[RampKit] EventManager: onboarding_completed already sent, skipping (trigger: ${trigger})`);
+            return;
+        }
+        // Mark as completed BEFORE sending to prevent race conditions
+        await this.markOnboardingAsCompleted();
         const timeToCompleteSeconds = this.getOnboardingDurationSeconds();
         this.track("onboarding_completed", {
             onboardingId: onboardingId || this.currentOnboardingId,
             timeToCompleteSeconds,
             completedSteps,
             totalSteps,
+            trigger,
         });
         this.endOnboardingTracking();
-    }
-    /**
-     * Track onboarding abandoned
-     */
-    trackOnboardingAbandoned(reason, lastScreenName, onboardingId) {
-        const timeSpentSeconds = this.getOnboardingDurationSeconds();
-        this.track("onboarding_abandoned", {
-            onboardingId: onboardingId || this.currentOnboardingId,
-            reason,
-            lastScreenName,
-            timeSpentSeconds,
-        });
-        this.endOnboardingTracking();
-    }
-    /**
-     * Track notification prompt shown
-     */
-    trackNotificationsPromptShown() {
-        this.track("notifications_prompt_shown", {});
+        console.log(`[RampKit] EventManager: 📊 onboarding_completed sent (trigger: ${trigger})`);
     }
     /**
      * Track notification response
@@ -295,6 +300,12 @@ class EventManager {
     trackNotificationsResponse(status) {
         this.track("notifications_response", { status });
     }
+    /**
+     * Track option selected (interaction event)
+     */
+    trackOptionSelected(optionId, optionValue, questionId) {
+        this.track("option_selected", { optionId, optionValue, questionId });
+    }
     /**
      * Track paywall shown
      */
@@ -302,37 +313,40 @@ class EventManager {
         this.setCurrentPaywall(paywallId, placement);
         this.track("paywall_shown", { paywallId, placement, products }, { paywallId, placement });
     }
-    /**
-     * Track paywall primary action tap
-     */
-    trackPaywallPrimaryActionTap(paywallId, productId) {
-        this.track("paywall_primary_action_tap", { paywallId, productId }, { paywallId });
-    }
-    /**
-     * Track paywall closed
-     */
-    trackPaywallClosed(paywallId, reason) {
-        this.track("paywall_closed", { paywallId, reason }, { paywallId });
-        this.setCurrentPaywall(null);
-    }
     /**
      * Track purchase started
+     * Call this when user initiates a purchase from a paywall
      */
-    trackPurchaseStarted(productId, amount, currency) {
-        this.track("purchase_started", { productId, amount, currency });
+    trackPurchaseStarted(properties) {
+        // Context (paywallId, placement) is automatically included from current state
+        // which was set when trackPaywallShown was called
+        console.log(`[RampKit] EventManager: 🛒 purchase_started`, `\n  productId: ${properties.productId}`, properties.amount ? `\n  amount: ${properties.amount} ${properties.currency || ""}` : "");
+        this.track("purchase_started", properties);
     }
     /**
      * Track purchase completed
+     * CRITICAL: originalTransactionId is required for attribution
+     * Context (paywallId, screenName, flowId) is automatically included
      */
     trackPurchaseCompleted(properties) {
+        // Context is automatically included from current state (paywallId, placement, etc.)
+        console.log(`[RampKit] EventManager: ✅ purchase_completed`, `\n  productId: ${properties.productId}`, `\n  transactionId: ${properties.transactionId}`, `\n  originalTransactionId: ${properties.originalTransactionId}`, properties.isTrial ? `\n  isTrial: true` : "", properties.environment ? `\n  environment: ${properties.environment}` : "");
         this.track("purchase_completed", properties);
     }
     /**
      * Track purchase failed
      */
     trackPurchaseFailed(productId, errorCode, errorMessage) {
+        console.log(`[RampKit] EventManager: ❌ purchase_failed`, `\n  productId: ${productId}`, `\n  errorCode: ${errorCode}`, `\n  errorMessage: ${errorMessage}`);
         this.track("purchase_failed", { productId, errorCode, errorMessage });
     }
+    /**
+     * Track purchase restored
+     */
+    trackPurchaseRestored(properties) {
+        console.log(`[RampKit] EventManager: 🔄 purchase_restored`, `\n  productId: ${properties.productId}`, properties.transactionId ? `\n  transactionId: ${properties.transactionId}` : "", properties.originalTransactionId ? `\n  originalTransactionId: ${properties.originalTransactionId}` : "");
+        this.track("purchase_restored", properties);
+    }
     /**
      * Reset the event manager (e.g., on logout)
      */
@@ -350,6 +364,8 @@ class EventManager {
         this.onboardingStartTime = null;
         this.currentOnboardingId = null;
         this.initialized = false;
+        // Reset onboarding completion status so it can fire again for new user
+        this.resetOnboardingCompletionStatus();
     }
 }
 exports.EventManager = EventManager;

package/build/RampKit.d.ts

@@ -12,8 +12,6 @@ export declare class RampKitCore {
     private deviceInfo;
     private onOnboardingFinished?;
     private onShowPaywall?;
-    private appStateSubscription;
-    private lastAppState;
     private initialized;
     /** Custom App User ID provided by the developer (alias for their user system) */
     private appUserID;
@@ -47,10 +45,6 @@ export declare class RampKitCore {
      * Send user/device data to the /app-users endpoint
      */
     private sendUserDataToBackend;
-    /**
-     * Setup app state listener for background/foreground tracking
-     */
-    private setupAppStateListener;
     /**
      * Get the onboarding data
      */
@@ -87,14 +81,6 @@ export declare class RampKitCore {
      * Track a custom event
      */
     trackEvent(eventName: string, properties?: Record<string, any>, context?: Partial<EventContext>): void;
-    /**
-     * Track a screen view
-     */
-    trackScreenView(screenName: string, referrer?: string): void;
-    /**
-     * Track a CTA tap
-     */
-    trackCtaTap(buttonId: string, buttonText?: string): void;
     /**
      * Reset the SDK state and re-initialize
      * Call this when a user logs out or when you need to clear all cached state

package/build/RampKit.js

@@ -5,7 +5,6 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RampKitCore = void 0;
-const react_native_1 = require("react-native");
 const RampkitOverlay_1 = require("./RampkitOverlay");
 const userId_1 = require("./userId");
 const DeviceInfoCollector_1 = require("./DeviceInfoCollector");
@@ -20,8 +19,6 @@ class RampKitCore {
         this.userId = null;
         this.appId = null;
         this.deviceInfo = null;
-        this.appStateSubscription = null;
-        this.lastAppState = "active";
         this.initialized = false;
         /** Custom App User ID provided by the developer (alias for their user system) */
         this.appUserID = null;
@@ -64,9 +61,7 @@ class RampKitCore {
             EventManager_1.eventManager.initialize(config.appId, this.deviceInfo);
             // Step 4: Track app session started
             EventManager_1.eventManager.trackAppSessionStarted(this.deviceInfo.isFirstLaunch, this.deviceInfo.launchCount);
-            // Step 5: Setup app state listener for background/foreground tracking
-            this.setupAppStateListener();
-            // Step 6: Start transaction observer for automatic purchase tracking
+            // Step 5: Start transaction observer for automatic purchase tracking
             console.log("[RampKit] Configure: Starting transaction observer...");
             await RampKitNative_1.TransactionObserver.start(config.appId);
             this.initialized = true;
@@ -195,26 +190,6 @@ class RampKitCore {
             console.warn(`[RampKit] Configure: Network error sending user data`, `\n  Error: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
-    /**
-     * Setup app state listener for background/foreground tracking
-     */
-    setupAppStateListener() {
-        this.appStateSubscription = react_native_1.AppState.addEventListener("change", (nextAppState) => {
-            if (this.lastAppState === "active" &&
-                (nextAppState === "background" || nextAppState === "inactive")) {
-                // App went to background
-                const sessionDuration = (0, DeviceInfoCollector_1.getSessionDurationSeconds)();
-                EventManager_1.eventManager.trackAppBackgrounded(sessionDuration);
-            }
-            else if ((this.lastAppState === "background" ||
-                this.lastAppState === "inactive") &&
-                nextAppState === "active") {
-                // App came to foreground
-                EventManager_1.eventManager.trackAppForegrounded();
-            }
-            this.lastAppState = nextAppState;
-        });
-    }
     /**
      * Get the onboarding data
      */
@@ -314,28 +289,35 @@ class RampKitCore {
                 navigation,
                 onOnboardingFinished: (payload) => {
                     var _a;
-                    // Track onboarding completed
-                    EventManager_1.eventManager.trackOnboardingCompleted(screens.length, screens.length, onboardingId);
+                    // Track onboarding completed (once per user) - trigger: finished
+                    EventManager_1.eventManager.trackOnboardingCompletedOnce("finished", screens.length, screens.length, onboardingId);
                     try {
                         (_a = this.onOnboardingFinished) === null || _a === void 0 ? void 0 : _a.call(this, payload);
                     }
                     catch (_) { }
                 },
-                onShowPaywall: (opts === null || opts === void 0 ? void 0 : opts.onShowPaywall) || (opts === null || opts === void 0 ? void 0 : opts.showPaywall) || this.onShowPaywall,
-                onScreenChange: (screenIndex, screenId) => {
-                    // Track screen view within onboarding
-                    EventManager_1.eventManager.trackOnboardingScreenViewed(screenId, screenIndex, screens.length, onboardingId);
+                onShowPaywall: (payload) => {
+                    // Track onboarding completed (once per user) - trigger: paywall_shown
+                    EventManager_1.eventManager.trackOnboardingCompletedOnce("paywall_shown", screens.length, // We don't know exact step, use total
+                    screens.length, onboardingId);
+                    // Call the original callback
+                    const paywallCallback = (opts === null || opts === void 0 ? void 0 : opts.onShowPaywall) || (opts === null || opts === void 0 ? void 0 : opts.showPaywall) || this.onShowPaywall;
+                    try {
+                        paywallCallback === null || paywallCallback === void 0 ? void 0 : paywallCallback(payload);
+                    }
+                    catch (_) { }
                 },
                 onOnboardingAbandoned: (reason, lastScreenIndex, lastScreenId) => {
                     // Track onboarding abandoned
                     EventManager_1.eventManager.trackOnboardingAbandoned(reason, lastScreenId, onboardingId);
                 },
-                onNotificationPermissionRequested: () => {
-                    EventManager_1.eventManager.trackNotificationsPromptShown();
-                },
                 onNotificationPermissionResult: (granted) => {
                     EventManager_1.eventManager.trackNotificationsResponse(granted ? "granted" : "denied");
                 },
+                onCloseAction: (screenIndex, _screenId) => {
+                    // Track onboarding completed (once per user) - trigger: closed
+                    EventManager_1.eventManager.trackOnboardingCompletedOnce("closed", screenIndex + 1, screens.length, onboardingId);
+                },
             });
         }
         catch (e) {
@@ -357,18 +339,6 @@ class RampKitCore {
     trackEvent(eventName, properties = {}, context) {
         EventManager_1.eventManager.track(eventName, properties, context);
     }
-    /**
-     * Track a screen view
-     */
-    trackScreenView(screenName, referrer) {
-        EventManager_1.eventManager.trackScreenView(screenName, referrer);
-    }
-    /**
-     * Track a CTA tap
-     */
-    trackCtaTap(buttonId, buttonText) {
-        EventManager_1.eventManager.trackCtaTap(buttonId, buttonText);
-    }
     // Note: Purchase and paywall events are automatically tracked by the native
     // StoreKit 2 (iOS) and Google Play Billing (Android) transaction observers.
     // No manual tracking is needed.
@@ -384,11 +354,6 @@ class RampKitCore {
         console.log("[RampKit] Reset: Clearing SDK state...");
         // Stop transaction observer
         await RampKitNative_1.TransactionObserver.stop();
-        // Remove app state listener
-        if (this.appStateSubscription) {
-            this.appStateSubscription.remove();
-            this.appStateSubscription = null;
-        }
         // Reset event manager state
         EventManager_1.eventManager.reset();
         // Reset session

package/build/RampkitOverlay.d.ts

@@ -24,6 +24,7 @@ export declare function showRampkitOverlay(opts: {
     onOnboardingAbandoned?: (reason: string, lastScreenIndex: number, lastScreenId: string) => void;
     onNotificationPermissionRequested?: () => void;
     onNotificationPermissionResult?: (granted: boolean) => void;
+    onCloseAction?: (screenIndex: number, screenId: string) => void;
 }): void;
 export declare function hideRampkitOverlay(): void;
 export declare function closeRampkitOverlay(): void;
@@ -50,5 +51,6 @@ declare function Overlay(props: {
     onOnboardingAbandoned?: (reason: string, lastScreenIndex: number, lastScreenId: string) => void;
     onNotificationPermissionRequested?: () => void;
     onNotificationPermissionResult?: (granted: boolean) => void;
+    onCloseAction?: (screenIndex: number, screenId: string) => void;
 }): any;
 export default Overlay;

package/build/RampkitOverlay.js

@@ -580,7 +580,7 @@ function showRampkitOverlay(opts) {
             (_a = opts.onClose) === null || _a === void 0 ? void 0 : _a.call(opts);
         }, onOnboardingFinished: opts.onOnboardingFinished, onShowPaywall: opts.onShowPaywall, onRegisterClose: (handler) => {
             activeCloseHandler = handler;
-        }, onScreenChange: opts.onScreenChange, onOnboardingAbandoned: opts.onOnboardingAbandoned, onNotificationPermissionRequested: opts.onNotificationPermissionRequested, onNotificationPermissionResult: opts.onNotificationPermissionResult })));
+        }, onScreenChange: opts.onScreenChange, onOnboardingAbandoned: opts.onOnboardingAbandoned, onNotificationPermissionRequested: opts.onNotificationPermissionRequested, onNotificationPermissionResult: opts.onNotificationPermissionResult, onCloseAction: opts.onCloseAction })));
     // Once shown, we can safely discard the preloader sibling if present
     if (preloadSibling) {
         preloadSibling.destroy();
@@ -1653,7 +1653,7 @@ function Overlay(props) {
                                     sendOnboardingStateToWebView(i);
                                 }
                             }, onMessage: (ev) => {
-                                var _a, _b, _c, _d, _e, _f;
+                                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
                                 const raw = ev.nativeEvent.data;
                                 console.log("raw", raw);
                                 // Accept either raw strings or JSON payloads from your editor
@@ -1819,7 +1819,12 @@ function Overlay(props) {
                                         return;
                                     }
                                     if ((data === null || data === void 0 ? void 0 : data.type) === "rampkit:close") {
-                                        handleRequestClose();
+                                        // Track close action for onboarding completion
+                                        try {
+                                            (_e = props.onCloseAction) === null || _e === void 0 ? void 0 : _e.call(props, i, ((_f = props.screens[i]) === null || _f === void 0 ? void 0 : _f.id) || "");
+                                        }
+                                        catch (_) { }
+                                        handleRequestClose({ completed: true }); // Mark as completed so abandonment isn't tracked
                                         return;
                                     }
                                     if ((data === null || data === void 0 ? void 0 : data.type) === "rampkit:haptic") {
@@ -1827,7 +1832,7 @@ function Overlay(props) {
                                         return;
                                     }
                                 }
-                                catch (_g) {
+                                catch (_l) {
                                     // String path
                                     if (raw === "rampkit:tap" ||
                                         raw === "next" ||
@@ -1854,7 +1859,7 @@ function Overlay(props) {
                                     if (raw === "rampkit:onboarding-finished") {
                                         setOnboardingCompleted(true);
                                         try {
-                                            (_e = props.onOnboardingFinished) === null || _e === void 0 ? void 0 : _e.call(props, undefined);
+                                            (_g = props.onOnboardingFinished) === null || _g === void 0 ? void 0 : _g.call(props, undefined);
                                         }
                                         catch (_) { }
                                         handleRequestClose({ completed: true });
@@ -1862,7 +1867,7 @@ function Overlay(props) {
                                     }
                                     if (raw === "rampkit:show-paywall") {
                                         try {
-                                            (_f = props.onShowPaywall) === null || _f === void 0 ? void 0 : _f.call(props);
+                                            (_h = props.onShowPaywall) === null || _h === void 0 ? void 0 : _h.call(props);
                                         }
                                         catch (_) { }
                                         return;
@@ -1891,7 +1896,12 @@ function Overlay(props) {
                                         return;
                                     }
                                     if (raw === "rampkit:close") {
-                                        handleRequestClose();
+                                        // Track close action for onboarding completion
+                                        try {
+                                            (_j = props.onCloseAction) === null || _j === void 0 ? void 0 : _j.call(props, i, ((_k = props.screens[i]) === null || _k === void 0 ? void 0 : _k.id) || "");
+                                        }
+                                        catch (_) { }
+                                        handleRequestClose({ completed: true }); // Mark as completed so abandonment isn't tracked
                                         return;
                                     }
                                     if (raw.startsWith("haptic:")) {

package/build/constants.d.ts

@@ -14,6 +14,7 @@ export declare const STORAGE_KEYS: {
     readonly LAUNCH_COUNT: "rk_launch_count";
     readonly LAST_LAUNCH: "rk_last_launch";
     readonly ONBOARDING_RESPONSES: "rk_onboarding_responses";
+    readonly ONBOARDING_COMPLETED: "rk_onboarding_completed";
 };
 export declare const CAPABILITIES: readonly ["onboarding", "paywall_event_receiver", "haptic_feedback", "push_notifications"];
 export declare const SUPABASE_ANON_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InV1c3RsenV2am1vY2h4a3hhdGZ4Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NjIxMDM2NTUsImV4cCI6MjA3NzY3OTY1NX0.d5XsIMGnia4n9Pou0IidipyyEfSlwpXFoeDBufMOEwE";

package/build/constants.js

@@ -20,6 +20,8 @@ exports.STORAGE_KEYS = {
     LAST_LAUNCH: "rk_last_launch",
     // Onboarding responses (persisted)
     ONBOARDING_RESPONSES: "rk_onboarding_responses",
+    // Onboarding completion status (persisted) - fires once per user
+    ONBOARDING_COMPLETED: "rk_onboarding_completed",
 };
 exports.CAPABILITIES = [
     "onboarding",

package/build/index.d.ts

@@ -11,5 +11,5 @@ export { default as RampKitNative } from "./RampKitNative";
 export type { NativeDeviceInfo, NativeLaunchData } from "./RampKitNative";
 export { Haptics, StoreReview, Notifications, TransactionObserver } from "./RampKitNative";
 export type { ImpactStyle, NotificationType, NotificationOptions, NotificationPermissionResult } from "./RampKitNative";
-export type { DeviceInfo, RampKitEvent, EventDevice, EventContext, RampKitConfig, RampKitEventName, RampKitContext, RampKitDeviceContext, RampKitUserContext, NavigationData, ScreenPosition, OnboardingResponse, AppSessionStartedProperties, AppSessionEndedProperties, AppBackgroundedProperties, AppForegroundedProperties, OnboardingStartedProperties, OnboardingScreenViewedProperties, OnboardingQuestionAnsweredProperties, OnboardingCompletedProperties, OnboardingAbandonedProperties, ScreenViewProperties, CtaTapProperties, NotificationsPromptShownProperties, NotificationsResponseProperties, PaywallShownProperties, PaywallPrimaryActionTapProperties, PaywallClosedProperties, PurchaseStartedProperties, PurchaseCompletedProperties, PurchaseFailedProperties, } from "./types";
+export type { DeviceInfo, RampKitEvent, EventDevice, EventContext, RampKitConfig, RampKitEventName, RampKitContext, RampKitDeviceContext, RampKitUserContext, NavigationData, ScreenPosition, OnboardingResponse, AppSessionStartedProperties, OnboardingStartedProperties, OnboardingCompletedProperties, OnboardingAbandonedProperties, OptionSelectedProperties, NotificationsResponseProperties, PaywallShownProperties, PurchaseStartedProperties, PurchaseCompletedProperties, PurchaseFailedProperties, PurchaseRestoredProperties, } from "./types";
 export { SDK_VERSION, CAPABILITIES } from "./constants";

package/build/types.d.ts

@@ -81,36 +81,16 @@ export interface AppSessionStartedProperties {
     isFirstLaunch: boolean;
     launchCount: number;
 }
-export interface AppSessionEndedProperties {
-    reason: string;
-    sessionDurationSeconds: number;
-}
-export interface AppBackgroundedProperties {
-    sessionDurationSeconds: number;
-}
-export interface AppForegroundedProperties {
-}
 export interface OnboardingStartedProperties {
     onboardingId?: string;
     totalSteps?: number;
 }
-export interface OnboardingScreenViewedProperties {
-    onboardingId?: string;
-    screenName: string;
-    screenIndex: number;
-    totalScreens: number;
-}
-export interface OnboardingQuestionAnsweredProperties {
-    onboardingId?: string;
-    questionId: string;
-    answer: any;
-    questionText?: string;
-}
 export interface OnboardingCompletedProperties {
     onboardingId?: string;
     timeToCompleteSeconds: number;
     completedSteps: number;
     totalSteps: number;
+    trigger: string;
 }
 export interface OnboardingAbandonedProperties {
     onboardingId?: string;
@@ -118,15 +98,10 @@ export interface OnboardingAbandonedProperties {
     lastScreenName?: string;
     timeSpentSeconds: number;
 }
-export interface ScreenViewProperties {
-    screenName: string;
-    referrer?: string;
-}
-export interface CtaTapProperties {
-    buttonId: string;
-    buttonText?: string;
-}
-export interface NotificationsPromptShownProperties {
+export interface OptionSelectedProperties {
+    optionId: string;
+    optionValue: any;
+    questionId?: string;
 }
 export interface NotificationsResponseProperties {
     status: "granted" | "denied" | "provisional";
@@ -140,39 +115,69 @@ export interface PaywallShownProperties {
         currency?: string;
     }>;
 }
-export interface PaywallPrimaryActionTapProperties {
-    paywallId: string;
-    productId?: string;
-}
-export interface PaywallClosedProperties {
-    paywallId: string;
-    reason: "dismissed" | "purchased" | "backgrounded";
-}
 export interface PurchaseStartedProperties {
     productId: string;
     amount?: number;
     currency?: string;
+    priceFormatted?: string;
 }
+/**
+ * Properties for purchase_completed event
+ * Critical for attribution: originalTransactionId links renewals to original purchase
+ */
 export interface PurchaseCompletedProperties {
+    /** Product identifier (e.g., "com.app.yearly") */
     productId: string;
-    amount: number;
-    currency: string;
+    /** Price as number (e.g., 39.99) */
+    amount?: number;
+    /** Currency code (e.g., "USD") */
+    currency?: string;
+    /** Formatted price string (e.g., "$39.99") */
+    priceFormatted?: string;
+    /** Unique transaction ID from App Store/Play Store */
     transactionId: string;
-    originalTransactionId?: string;
-    purchaseDate?: string;
+    /** CRITICAL: Original transaction ID - links renewals to original purchase */
+    originalTransactionId: string;
+    /** ISO 8601 purchase timestamp */
+    purchaseDate: string;
+    /** ISO 8601 expiration date for subscriptions */
+    expirationDate?: string;
+    /** Whether this is a free trial */
+    isTrial?: boolean;
+    /** Whether this is an introductory offer */
+    isIntroOffer?: boolean;
+    /** Offer type: "introductory", "promotional", "code", or null */
+    offerType?: string | null;
+    /** Offer ID if applicable */
+    offerId?: string;
+    /** ISO 8601 duration (e.g., "P1M" for monthly, "P1Y" for yearly) */
+    subscriptionPeriod?: string;
+    /** Subscription group ID */
+    subscriptionGroupId?: string;
+    /** App Store storefront country code */
+    storefront?: string;
+    /** Environment: "Production" or "Sandbox" */
+    environment?: string;
+    /** Quantity purchased */
+    quantity?: number;
 }
 export interface PurchaseFailedProperties {
     productId: string;
     errorCode: string;
     errorMessage: string;
 }
-export type AppLifecycleEventName = "app_session_started" | "app_session_ended" | "app_backgrounded" | "app_foregrounded";
-export type OnboardingEventName = "onboarding_started" | "onboarding_screen_viewed" | "onboarding_question_answered" | "onboarding_completed" | "onboarding_abandoned";
-export type NavigationEventName = "screen_view" | "cta_tap";
-export type PermissionEventName = "notifications_prompt_shown" | "notifications_response";
-export type PaywallEventName = "paywall_shown" | "paywall_primary_action_tap" | "paywall_closed";
-export type PurchaseEventName = "purchase_started" | "purchase_completed" | "purchase_failed";
-export type RampKitEventName = AppLifecycleEventName | OnboardingEventName | NavigationEventName | PermissionEventName | PaywallEventName | PurchaseEventName;
+export interface PurchaseRestoredProperties {
+    productId: string;
+    transactionId?: string;
+    originalTransactionId?: string;
+}
+export type AppLifecycleEventName = "app_session_started";
+export type OnboardingEventName = "onboarding_started" | "onboarding_completed" | "onboarding_abandoned";
+export type InteractionEventName = "option_selected";
+export type PermissionEventName = "notifications_response" | "tracking_response";
+export type PaywallEventName = "paywall_shown";
+export type PurchaseEventName = "purchase_started" | "purchase_completed" | "purchase_failed" | "purchase_restored";
+export type RampKitEventName = AppLifecycleEventName | OnboardingEventName | InteractionEventName | PermissionEventName | PaywallEventName | PurchaseEventName;
 export interface RampKitConfig {
     appId: string;
     apiKey?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rampkit-expo-dev",
-  "version": "0.0.61",
+  "version": "0.0.63",
   "description": "The Expo SDK for RampKit. Build, test, and personalize app onboardings with instant updates.",
   "main": "build/index.js",
   "types": "build/index.d.ts",