rampkit-expo-dev 0.0.57 → 0.0.60

package/README.md

@@ -38,10 +38,11 @@ npx expo install rampkit-expo-dev
 ```ts
 import { RampKit } from "rampkit-expo-dev";
 
-await RampKit.init({
-  apiKey: "YOUR_API_KEY",
+await RampKit.configure({
+  appId: "YOUR_APP_ID",
   environment: "production", // optional
   autoShowOnboarding: false, // optional
+  appUserID: "your-user-123", // optional - your own user ID for analytics linking
   onOnboardingFinished: (payload) => {
     // optional callback fired when the flow finishes
   },
@@ -59,23 +60,82 @@ RampKit.showOnboarding();
 ## Configuration Options
 
 ```ts
-await RampKit.init({
-  apiKey: "abc123",
+await RampKit.configure({
+  appId: "YOUR_APP_ID",
   environment: "staging", // optional
-  autoShowOnboarding: true, // optional (auto-present after init if data is available)
+  autoShowOnboarding: true, // optional (auto-present after configure if data is available)
+  appUserID: "user-123", // optional - link with your own user database
   onOnboardingFinished: (payload) => {
     // optional
   },
 });
 
 // Access the generated stable user id (stored securely)
-const idFromInit = RampKit.getUserId(); // string | null (available after init)
+const idFromInit = RampKit.getUserId(); // string | null (available after configure)
 
 // Or fetch/generate it directly (always returns a string)
 import { getRampKitUserId } from "rampkit-expo-dev";
 const userId = await getRampKitUserId();
+
+// Get stored onboarding responses
+const responses = await RampKit.getOnboardingResponses();
+```
+
+---
+
+## Custom App User ID
+
+You can associate your own user identifier with RampKit analytics. This is useful for linking RampKit data with your own user database.
+
+**Important:** This is an alias only - RampKit still generates and uses its own internal user ID (`appUserId`) for tracking. Your custom `appUserID` is stored alongside it for your reference.
+
+### Set at Configuration
+
+```ts
+await RampKit.configure({
+  appId: "YOUR_APP_ID",
+  appUserID: "your-user-123", // Set during configuration
+});
+```
+
+### Set After Configuration
+
+```ts
+// Set or update the app user ID at any time
+await RampKit.setAppUserID("your-user-123");
+
+// Get the current app user ID
+const customId = RampKit.getAppUserID(); // string | null
+```
+
+---
+
+## Accessing Onboarding Responses
+
+RampKit automatically stores user responses when questions are answered during onboarding. You can retrieve these responses at any time:
+
+```ts
+const responses = await RampKit.getOnboardingResponses();
+
+for (const response of responses) {
+  console.log("Question:", response.questionId);
+  console.log("Answer:", response.answer);
+  console.log("Answered at:", response.answeredAt);
+}
 ```
 
+Each `OnboardingResponse` contains:
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `questionId` | `string` | Unique identifier for the question |
+| `answer` | `any` | The user's answer (any JSON-serializable value) |
+| `questionText` | `string?` | Optional question text shown to user |
+| `screenName` | `string?` | Screen where question was answered |
+| `answeredAt` | `string` | ISO 8601 timestamp |
+
+Responses are automatically cleared when `reset()` is called.
+
 More examples are in the docs:  
 https://rampkit.com/docs
 
@@ -90,8 +150,8 @@ import { Button } from "react-native";
 
 export default function App() {
   useEffect(() => {
-    // Initialize once in your app
-    RampKit.init({ apiKey: "YOUR_API_KEY" });
+    // Configure once in your app
+    RampKit.configure({ appId: "YOUR_APP_ID" });
   }, []);
 
   return (

package/build/DeviceInfoCollector.js

@@ -46,6 +46,7 @@ async function collectDeviceInfo() {
         const deviceInfo = {
             // User & Session Identifiers
             appUserId: nativeInfo.appUserId,
+            appUserID: null, // Custom app user ID is set separately via config or setAppUserID()
             vendorId: nativeInfo.vendorId,
             appSessionId: nativeInfo.appSessionId,
             // Launch Tracking
@@ -141,6 +142,7 @@ function getFallbackDeviceInfo() {
     sessionStartTime = new Date();
     return {
         appUserId: fallbackUserId,
+        appUserID: null, // Custom app user ID is set separately via config or setAppUserID()
         vendorId: null,
         appSessionId: sessionId,
         installDate: now,

package/build/EventManager.js

@@ -174,14 +174,23 @@ class EventManager {
                 body: JSON.stringify(event),
             });
             if (!response.ok) {
-                console.warn("[RampKit] EventManager: Failed to send event:", event.eventName, response.status);
+                // Try to get error details from response body
+                let errorDetails = "";
+                try {
+                    const errorBody = await response.text();
+                    errorDetails = errorBody ? ` - ${errorBody}` : "";
+                }
+                catch (_a) {
+                    // Ignore if we can't read the body
+                }
+                console.warn(`[RampKit] EventManager: Failed to send event: ${event.eventName}`, `\n  Status: ${response.status} ${response.statusText}`, `\n  URL: ${url}`, `\n  AppId: ${event.appId}`, `\n  UserId: ${event.appUserId}`, errorDetails ? `\n  Error: ${errorDetails}` : "");
             }
             else {
                 console.log("[RampKit] EventManager: Event sent:", event.eventName);
             }
         }
         catch (error) {
-            console.warn("[RampKit] EventManager: Error sending event:", event.eventName, error);
+            console.warn(`[RampKit] EventManager: Network error sending event: ${event.eventName}`, `\n  Error: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
     // ============================================================================

package/build/OnboardingResponseStorage.d.ts

@@ -0,0 +1,24 @@
+/**
+ * OnboardingResponseStorage
+ * Manages persistent storage of onboarding responses
+ */
+import { OnboardingResponse } from "./types";
+/**
+ * Manages persistent storage of onboarding responses
+ */
+export declare const OnboardingResponseStorage: {
+    /**
+     * Save a new response, merging with existing responses
+     * If a response with the same questionId exists, it will be updated
+     */
+    saveResponse(response: OnboardingResponse): Promise<void>;
+    /**
+     * Retrieve all stored responses
+     * @returns Array of OnboardingResponse objects, empty array if none found
+     */
+    retrieveResponses(): Promise<OnboardingResponse[]>;
+    /**
+     * Clear all stored responses
+     */
+    clearResponses(): Promise<void>;
+};

package/build/OnboardingResponseStorage.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * OnboardingResponseStorage
+ * Manages persistent storage of onboarding responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnboardingResponseStorage = void 0;
+const RampKitNative_1 = require("./RampKitNative");
+const constants_1 = require("./constants");
+/**
+ * Manages persistent storage of onboarding responses
+ */
+exports.OnboardingResponseStorage = {
+    /**
+     * Save a new response, merging with existing responses
+     * If a response with the same questionId exists, it will be updated
+     */
+    async saveResponse(response) {
+        try {
+            const responses = await this.retrieveResponses();
+            // Update existing response for same questionId or append new
+            const existingIndex = responses.findIndex((r) => r.questionId === response.questionId);
+            if (existingIndex >= 0) {
+                responses[existingIndex] = response;
+            }
+            else {
+                responses.push(response);
+            }
+            // Serialize and save
+            await (0, RampKitNative_1.setStoredValue)(constants_1.STORAGE_KEYS.ONBOARDING_RESPONSES, JSON.stringify(responses));
+            if (__DEV__) {
+                console.log(`[RampKit] Saved response for question: ${response.questionId}`);
+            }
+        }
+        catch (error) {
+            console.warn("[RampKit] Failed to save onboarding response:", error);
+        }
+    },
+    /**
+     * Retrieve all stored responses
+     * @returns Array of OnboardingResponse objects, empty array if none found
+     */
+    async retrieveResponses() {
+        try {
+            const jsonString = await (0, RampKitNative_1.getStoredValue)(constants_1.STORAGE_KEYS.ONBOARDING_RESPONSES);
+            if (!jsonString) {
+                return [];
+            }
+            return JSON.parse(jsonString);
+        }
+        catch (error) {
+            console.warn("[RampKit] Failed to retrieve onboarding responses:", error);
+            return [];
+        }
+    },
+    /**
+     * Clear all stored responses
+     */
+    async clearResponses() {
+        try {
+            await (0, RampKitNative_1.setStoredValue)(constants_1.STORAGE_KEYS.ONBOARDING_RESPONSES, "");
+            if (__DEV__) {
+                console.log("[RampKit] Cleared all onboarding responses");
+            }
+        }
+        catch (error) {
+            console.warn("[RampKit] Failed to clear onboarding responses:", error);
+        }
+    },
+};

package/build/RampKit.d.ts

@@ -2,7 +2,7 @@
  * RampKit Core SDK
  * Main SDK class for RampKit Expo integration
  */
-import { DeviceInfo, RampKitConfig, EventContext } from "./types";
+import { DeviceInfo, RampKitConfig, EventContext, OnboardingResponse } from "./types";
 export declare class RampKitCore {
     private static _instance;
     private config;
@@ -15,11 +15,34 @@ export declare class RampKitCore {
     private appStateSubscription;
     private lastAppState;
     private initialized;
+    /** Custom App User ID provided by the developer (alias for their user system) */
+    private appUserID;
     static get instance(): RampKitCore;
     /**
-     * Initialize the RampKit SDK
+     * Configure the RampKit SDK
+     * @param config Configuration options including appId, callbacks, and optional appUserID
+     */
+    configure(config: RampKitConfig): Promise<void>;
+    /**
+     * @deprecated Use `configure()` instead. This method will be removed in a future version.
      */
     init(config: RampKitConfig): Promise<void>;
+    /**
+     * Set a custom App User ID to associate with this user.
+     * This is an alias for your own user identification system.
+     *
+     * Note: This does NOT replace the RampKit-generated user ID (appUserId).
+     * RampKit will continue to use its own stable UUID for internal tracking.
+     * This custom ID is sent to the backend for you to correlate with your own user database.
+     *
+     * @param appUserID Your custom user identifier
+     */
+    setAppUserID(appUserID: string): Promise<void>;
+    /**
+     * Get the custom App User ID if one has been set.
+     * @returns The custom App User ID or null if not set
+     */
+    getAppUserID(): string | null;
     /**
      * Send user/device data to the /app-users endpoint
      */
@@ -44,6 +67,11 @@ export declare class RampKitCore {
      * Check if SDK is initialized
      */
     isInitialized(): boolean;
+    /**
+     * Get all stored onboarding responses
+     * @returns Promise resolving to array of OnboardingResponse objects
+     */
+    getOnboardingResponses(): Promise<OnboardingResponse[]>;
     /**
      * Show the onboarding overlay
      */

package/build/RampKit.js

@@ -12,6 +12,7 @@ const DeviceInfoCollector_1 = require("./DeviceInfoCollector");
 const EventManager_1 = require("./EventManager");
 const RampKitNative_1 = require("./RampKitNative");
 const constants_1 = require("./constants");
+const OnboardingResponseStorage_1 = require("./OnboardingResponseStorage");
 class RampKitCore {
     constructor() {
         this.config = null;
@@ -22,6 +23,8 @@ class RampKitCore {
         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;
     }
     static get instance() {
         if (!this._instance)
@@ -29,49 +32,60 @@ class RampKitCore {
         return this._instance;
     }
     /**
-     * Initialize the RampKit SDK
+     * Configure the RampKit SDK
+     * @param config Configuration options including appId, callbacks, and optional appUserID
      */
-    async init(config) {
+    async configure(config) {
         this.config = config;
         this.appId = config.appId;
         this.onOnboardingFinished = config.onOnboardingFinished;
         this.onShowPaywall = config.onShowPaywall || config.showPaywall;
+        // Store custom App User ID if provided (this is an alias, not the RampKit user ID)
+        if (config.appUserID) {
+            this.appUserID = config.appUserID;
+            console.log("[RampKit] Configure: appUserID set to", this.appUserID);
+        }
         try {
             // Step 1: Collect device info (includes user ID generation)
-            console.log("[RampKit] Init: Collecting device info...");
-            this.deviceInfo = await (0, DeviceInfoCollector_1.collectDeviceInfo)();
+            console.log("[RampKit] Configure: Collecting device info...");
+            const baseDeviceInfo = await (0, DeviceInfoCollector_1.collectDeviceInfo)();
+            // Add the custom appUserID to device info
+            this.deviceInfo = {
+                ...baseDeviceInfo,
+                appUserID: this.appUserID,
+            };
             this.userId = this.deviceInfo.appUserId;
-            console.log("[RampKit] Init: userId", this.userId);
+            console.log("[RampKit] Configure: userId", this.userId);
             // Step 2: Send device info to /app-users endpoint
-            console.log("[RampKit] Init: Sending user data to backend...");
+            console.log("[RampKit] Configure: Sending user data to backend...");
             await this.sendUserDataToBackend(this.deviceInfo);
             // Step 3: Initialize event manager
-            console.log("[RampKit] Init: Initializing event manager...");
+            console.log("[RampKit] Configure: Initializing event manager...");
             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
-            console.log("[RampKit] Init: Starting transaction observer...");
+            console.log("[RampKit] Configure: Starting transaction observer...");
             await RampKitNative_1.TransactionObserver.start(config.appId);
             this.initialized = true;
         }
         catch (e) {
-            console.log("[RampKit] Init: Failed to initialize device info", e);
+            console.log("[RampKit] Configure: Failed to initialize device info", e);
             // Fallback to just getting user ID
             try {
                 this.userId = await (0, userId_1.getRampKitUserId)();
             }
             catch (e2) {
-                console.log("[RampKit] Init: Failed to resolve user id", e2);
+                console.log("[RampKit] Configure: Failed to resolve user id", e2);
             }
         }
         // Load onboarding data
-        console.log("[RampKit] Init: Starting onboarding load...");
+        console.log("[RampKit] Configure: Starting onboarding load...");
         try {
             const manifestUrl = `${constants_1.MANIFEST_BASE_URL}/${config.appId}/manifest.json`;
-            console.log("[RampKit] Init: Fetching manifest from", manifestUrl);
+            console.log("[RampKit] Configure: Fetching manifest from", manifestUrl);
             const manifestResponse = await globalThis.fetch(manifestUrl);
             const manifest = await manifestResponse.json();
             if (!manifest.onboardings || manifest.onboardings.length === 0) {
@@ -79,28 +93,73 @@ class RampKitCore {
             }
             // Use the first onboarding
             const firstOnboarding = manifest.onboardings[0];
-            console.log("[RampKit] Init: Using onboarding", firstOnboarding.name, firstOnboarding.id);
+            console.log("[RampKit] Configure: Using onboarding", firstOnboarding.name, firstOnboarding.id);
             // Fetch the actual onboarding data
             const onboardingResponse = await globalThis.fetch(firstOnboarding.url);
             const json = await onboardingResponse.json();
             this.onboardingData = json;
-            console.log("[RampKit] Init: onboardingId", json && json.onboardingId);
-            console.log("[RampKit] Init: Onboarding loaded");
+            console.log("[RampKit] Configure: onboardingId", json && json.onboardingId);
+            console.log("[RampKit] Configure: Onboarding loaded");
         }
         catch (error) {
-            console.log("[RampKit] Init: Onboarding load failed", error);
+            console.log("[RampKit] Configure: Onboarding load failed", error);
             this.onboardingData = null;
         }
-        console.log("[RampKit] Init: Finished", config);
+        console.log("[RampKit] Configure: Finished", config);
         // Optionally auto-show onboarding overlay
         try {
             if (this.onboardingData && config.autoShowOnboarding) {
-                console.log("[RampKit] Init: Auto-show onboarding");
+                console.log("[RampKit] Configure: Auto-show onboarding");
                 this.showOnboarding();
             }
         }
         catch (_) { }
     }
+    /**
+     * @deprecated Use `configure()` instead. This method will be removed in a future version.
+     */
+    async init(config) {
+        console.warn("[RampKit] init() is deprecated. Use configure() instead.");
+        return this.configure(config);
+    }
+    /**
+     * Set a custom App User ID to associate with this user.
+     * This is an alias for your own user identification system.
+     *
+     * Note: This does NOT replace the RampKit-generated user ID (appUserId).
+     * RampKit will continue to use its own stable UUID for internal tracking.
+     * This custom ID is sent to the backend for you to correlate with your own user database.
+     *
+     * @param appUserID Your custom user identifier
+     */
+    async setAppUserID(appUserID) {
+        this.appUserID = appUserID;
+        console.log("[RampKit] setAppUserID:", appUserID);
+        // Update device info with the new appUserID
+        if (this.deviceInfo) {
+            this.deviceInfo = {
+                ...this.deviceInfo,
+                appUserID: appUserID,
+            };
+            // Sync updated info to backend
+            if (this.initialized) {
+                try {
+                    await this.sendUserDataToBackend(this.deviceInfo);
+                    console.log("[RampKit] setAppUserID: Synced to backend");
+                }
+                catch (e) {
+                    console.warn("[RampKit] setAppUserID: Failed to sync to backend", e);
+                }
+            }
+        }
+    }
+    /**
+     * Get the custom App User ID if one has been set.
+     * @returns The custom App User ID or null if not set
+     */
+    getAppUserID() {
+        return this.appUserID;
+    }
     /**
      * Send user/device data to the /app-users endpoint
      */
@@ -117,14 +176,23 @@ class RampKitCore {
                 body: JSON.stringify(deviceInfo),
             });
             if (!response.ok) {
-                console.warn("[RampKit] Init: Failed to send user data:", response.status);
+                // Try to get error details from response body
+                let errorDetails = "";
+                try {
+                    const errorBody = await response.text();
+                    errorDetails = errorBody ? ` - ${errorBody}` : "";
+                }
+                catch (_a) {
+                    // Ignore if we can't read the body
+                }
+                console.warn(`[RampKit] Configure: Failed to send user data`, `\n  Status: ${response.status} ${response.statusText}`, `\n  URL: ${url}`, `\n  AppId: ${this.appId}`, `\n  UserId: ${deviceInfo.appUserId}`, errorDetails ? `\n  Error: ${errorDetails}` : "");
             }
             else {
-                console.log("[RampKit] Init: User data sent successfully");
+                console.log("[RampKit] Configure: User data sent successfully");
             }
         }
         catch (error) {
-            console.warn("[RampKit] Init: Error sending user data:", error);
+            console.warn(`[RampKit] Configure: Network error sending user data`, `\n  Error: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
     /**
@@ -171,6 +239,13 @@ class RampKitCore {
     isInitialized() {
         return this.initialized;
     }
+    /**
+     * Get all stored onboarding responses
+     * @returns Promise resolving to array of OnboardingResponse objects
+     */
+    async getOnboardingResponses() {
+        return OnboardingResponseStorage_1.OnboardingResponseStorage.retrieveResponses();
+    }
     /**
      * Show the onboarding overlay
      */
@@ -323,9 +398,12 @@ class RampKitCore {
         this.deviceInfo = null;
         this.onboardingData = null;
         this.initialized = false;
+        this.appUserID = null;
+        // Clear stored onboarding responses
+        await OnboardingResponseStorage_1.OnboardingResponseStorage.clearResponses();
         console.log("[RampKit] Reset: Re-initializing SDK...");
         // Re-initialize with stored config
-        await this.init(this.config);
+        await this.configure(this.config);
     }
 }
 exports.RampKitCore = RampKitCore;

package/build/RampkitOverlay.js

@@ -48,6 +48,7 @@ const react_native_root_siblings_1 = __importDefault(require("react-native-root-
 const react_native_pager_view_1 = __importDefault(require("react-native-pager-view"));
 const react_native_webview_1 = require("react-native-webview");
 const RampKitNative_1 = require("./RampKitNative");
+const OnboardingResponseStorage_1 = require("./OnboardingResponseStorage");
 // Reuse your injected script from App
 exports.injectedHardening = `
 (function(){
@@ -1652,7 +1653,7 @@ function Overlay(props) {
                                     sendOnboardingStateToWebView(i);
                                 }
                             }, onMessage: (ev) => {
-                                var _a, _b, _c, _d;
+                                var _a, _b, _c, _d, _e, _f;
                                 const raw = ev.nativeEvent.data;
                                 console.log("raw", raw);
                                 // Accept either raw strings or JSON payloads from your editor
@@ -1774,6 +1775,21 @@ function Overlay(props) {
                                         catch (_) { }
                                         return;
                                     }
+                                    // 7) Question answered - persist response locally
+                                    if ((data === null || data === void 0 ? void 0 : data.type) === "rampkit:question-answered") {
+                                        const questionId = data === null || data === void 0 ? void 0 : data.questionId;
+                                        if (questionId) {
+                                            const response = {
+                                                questionId,
+                                                answer: (_c = data === null || data === void 0 ? void 0 : data.answer) !== null && _c !== void 0 ? _c : "",
+                                                questionText: data === null || data === void 0 ? void 0 : data.questionText,
+                                                screenName: (_d = props.screens[i]) === null || _d === void 0 ? void 0 : _d.id,
+                                                answeredAt: new Date().toISOString(),
+                                            };
+                                            OnboardingResponseStorage_1.OnboardingResponseStorage.saveResponse(response);
+                                        }
+                                        return;
+                                    }
                                     if ((data === null || data === void 0 ? void 0 : data.type) === "rampkit:continue" ||
                                         (data === null || data === void 0 ? void 0 : data.type) === "continue") {
                                         handleAdvance(i, (data === null || data === void 0 ? void 0 : data.animation) || "fade");
@@ -1811,7 +1827,7 @@ function Overlay(props) {
                                         return;
                                     }
                                 }
-                                catch (_e) {
+                                catch (_g) {
                                     // String path
                                     if (raw === "rampkit:tap" ||
                                         raw === "next" ||
@@ -1838,7 +1854,7 @@ function Overlay(props) {
                                     if (raw === "rampkit:onboarding-finished") {
                                         setOnboardingCompleted(true);
                                         try {
-                                            (_c = props.onOnboardingFinished) === null || _c === void 0 ? void 0 : _c.call(props, undefined);
+                                            (_e = props.onOnboardingFinished) === null || _e === void 0 ? void 0 : _e.call(props, undefined);
                                         }
                                         catch (_) { }
                                         handleRequestClose({ completed: true });
@@ -1846,7 +1862,7 @@ function Overlay(props) {
                                     }
                                     if (raw === "rampkit:show-paywall") {
                                         try {
-                                            (_d = props.onShowPaywall) === null || _d === void 0 ? void 0 : _d.call(props);
+                                            (_f = props.onShowPaywall) === null || _f === void 0 ? void 0 : _f.call(props);
                                         }
                                         catch (_) { }
                                         return;

package/build/constants.d.ts

@@ -13,6 +13,7 @@ export declare const STORAGE_KEYS: {
     readonly INSTALL_DATE: "rk_install_date";
     readonly LAUNCH_COUNT: "rk_launch_count";
     readonly LAST_LAUNCH: "rk_last_launch";
+    readonly ONBOARDING_RESPONSES: "rk_onboarding_responses";
 };
 export declare const CAPABILITIES: readonly ["onboarding", "paywall_event_receiver", "haptic_feedback", "push_notifications"];
 export declare const SUPABASE_ANON_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InV1c3RsenV2am1vY2h4a3hhdGZ4Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3MzU1NjQ0NjYsImV4cCI6MjA1MTE0MDQ2Nn0.5cNrph5LHmssNo39UKpULkC9n4OD5n6gsnTEQV-gwQk";

package/build/constants.js

@@ -18,6 +18,8 @@ exports.STORAGE_KEYS = {
     INSTALL_DATE: "rk_install_date",
     LAUNCH_COUNT: "rk_launch_count",
     LAST_LAUNCH: "rk_last_launch",
+    // Onboarding responses (persisted)
+    ONBOARDING_RESPONSES: "rk_onboarding_responses",
 };
 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, 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, AppSessionEndedProperties, AppBackgroundedProperties, AppForegroundedProperties, OnboardingStartedProperties, OnboardingScreenViewedProperties, OnboardingQuestionAnsweredProperties, OnboardingCompletedProperties, OnboardingAbandonedProperties, ScreenViewProperties, CtaTapProperties, NotificationsPromptShownProperties, NotificationsResponseProperties, PaywallShownProperties, PaywallPrimaryActionTapProperties, PaywallClosedProperties, PurchaseStartedProperties, PurchaseCompletedProperties, PurchaseFailedProperties, } from "./types";
 export { SDK_VERSION, CAPABILITIES } from "./constants";

package/build/types.d.ts

@@ -3,6 +3,12 @@
  */
 export interface DeviceInfo {
     appUserId: string;
+    /**
+     * Custom App User ID provided by the developer.
+     * This is an alias for their own user identification system.
+     * Does NOT replace appUserId - RampKit still uses its own generated ID.
+     */
+    appUserID: string | null;
     vendorId: string | null;
     appSessionId: string;
     installDate: string;
@@ -175,6 +181,16 @@ export interface RampKitConfig {
     onOnboardingFinished?: (payload?: any) => void;
     onShowPaywall?: (payload?: any) => void;
     showPaywall?: (payload?: any) => void;
+    /**
+     * Optional custom App User ID to associate with this user.
+     * This is an alias for your own user identification system - it does NOT replace
+     * the RampKit-generated user ID (appUserId). RampKit will continue to generate
+     * and use its own stable UUID for internal tracking.
+     *
+     * Use this to link RampKit analytics with your own user database.
+     * Can also be set later via RampKit.setAppUserID().
+     */
+    appUserID?: string;
 }
 /**
  * Device context variables available in templates as ${device.xxx}
@@ -250,3 +266,18 @@ export interface ScreenPosition {
     /** Row classification: "main" for main row screens, "variant" for screens below */
     row: "main" | "variant";
 }
+/**
+ * Represents a single onboarding question response stored locally
+ */
+export interface OnboardingResponse {
+    /** Unique identifier for the question */
+    questionId: string;
+    /** The user's answer (can be any JSON-serializable value) */
+    answer: any;
+    /** Optional text of the question shown to user */
+    questionText?: string;
+    /** Screen where the question was answered */
+    screenName?: string;
+    /** ISO 8601 timestamp when the answer was recorded */
+    answeredAt: string;
+}

package/package.json

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