rampkit-expo-dev 0.0.18 → 0.0.22

package/build/DeviceInfoCollector.js

@@ -0,0 +1,200 @@
+"use strict";
+/**
+ * RampKit Device Info Collector
+ * Collects device information using native modules for the /app-users endpoint
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSessionStartTime = getSessionStartTime;
+exports.getSessionDurationSeconds = getSessionDurationSeconds;
+exports.collectDeviceInfo = collectDeviceInfo;
+exports.resetSession = resetSession;
+const react_native_1 = require("react-native");
+const RampKitNative_1 = __importDefault(require("./RampKitNative"));
+const constants_1 = require("./constants");
+// Session-level data (regenerated each app launch)
+let sessionId = null;
+let sessionStartTime = null;
+/**
+ * Get session start time
+ */
+function getSessionStartTime() {
+    return sessionStartTime;
+}
+/**
+ * Get the current session duration in seconds
+ */
+function getSessionDurationSeconds() {
+    if (!sessionStartTime)
+        return 0;
+    return Math.floor((Date.now() - sessionStartTime.getTime()) / 1000);
+}
+/**
+ * Collect all device information using native module
+ */
+async function collectDeviceInfo() {
+    try {
+        // Get device info from native module
+        const nativeInfo = await RampKitNative_1.default.getDeviceInfo();
+        // Initialize session
+        sessionId = nativeInfo.appSessionId;
+        sessionStartTime = new Date();
+        // Map native info to DeviceInfo type
+        const deviceInfo = {
+            // User & Session Identifiers
+            appUserId: nativeInfo.appUserId,
+            vendorId: nativeInfo.vendorId,
+            appSessionId: nativeInfo.appSessionId,
+            // Launch Tracking
+            installDate: nativeInfo.installDate,
+            isFirstLaunch: nativeInfo.isFirstLaunch,
+            launchCount: nativeInfo.launchCount,
+            lastLaunchAt: nativeInfo.lastLaunchAt,
+            // App Info
+            bundleId: nativeInfo.bundleId,
+            appName: nativeInfo.appName,
+            appVersion: nativeInfo.appVersion,
+            buildNumber: nativeInfo.buildNumber,
+            sdkVersion: constants_1.SDK_VERSION,
+            // Platform Info
+            platform: mapPlatform(nativeInfo.platform),
+            platformVersion: nativeInfo.platformVersion,
+            platformWrapper: "Expo",
+            // Device Info
+            deviceModel: nativeInfo.deviceModel,
+            deviceName: nativeInfo.deviceName,
+            isSimulator: nativeInfo.isSimulator,
+            // Locale & Language
+            deviceLanguageCode: nativeInfo.deviceLanguageCode,
+            deviceLocale: nativeInfo.deviceLocale,
+            regionCode: nativeInfo.regionCode,
+            preferredLanguage: nativeInfo.preferredLanguage,
+            preferredLanguages: nativeInfo.preferredLanguages,
+            // Currency
+            deviceCurrencyCode: nativeInfo.deviceCurrencyCode,
+            deviceCurrencySymbol: nativeInfo.deviceCurrencySymbol,
+            // Timezone
+            timezoneIdentifier: nativeInfo.timezoneIdentifier,
+            timezoneOffsetSeconds: nativeInfo.timezoneOffsetSeconds,
+            // UI
+            interfaceStyle: mapInterfaceStyle(nativeInfo.interfaceStyle),
+            // Screen
+            screenWidth: nativeInfo.screenWidth,
+            screenHeight: nativeInfo.screenHeight,
+            screenScale: nativeInfo.screenScale,
+            // Device Status
+            isLowPowerMode: nativeInfo.isLowPowerMode,
+            // Storage (skip for performance)
+            freeStorageBytes: null,
+            totalStorageBytes: null,
+            // Memory
+            totalMemoryBytes: nativeInfo.totalMemoryBytes,
+            // Apple Search Ads (skip for performance)
+            isAppleSearchAdsAttribution: false,
+            appleSearchAdsToken: null,
+            // SDK Capabilities
+            capabilities: [...constants_1.CAPABILITIES],
+            // Network (could add later)
+            connectionType: null,
+            // Timestamp
+            collectedAt: nativeInfo.collectedAt,
+        };
+        console.log("[RampKit] DeviceInfo: Collected from native module");
+        return deviceInfo;
+    }
+    catch (error) {
+        console.warn("[RampKit] DeviceInfo: Failed to collect from native module", error);
+        // Return minimal fallback
+        return getFallbackDeviceInfo();
+    }
+}
+/**
+ * Map platform string to typed platform
+ */
+function mapPlatform(platform) {
+    if (platform === "iPadOS")
+        return "iPadOS";
+    if (platform === "iOS")
+        return "iOS";
+    return "Android";
+}
+/**
+ * Map interface style string to typed style
+ */
+function mapInterfaceStyle(style) {
+    if (style === "light")
+        return "light";
+    if (style === "dark")
+        return "dark";
+    return "unspecified";
+}
+/**
+ * Get fallback device info when native module fails
+ */
+function getFallbackDeviceInfo() {
+    const now = new Date().toISOString();
+    const fallbackUserId = generateFallbackUuid();
+    sessionId = generateFallbackUuid();
+    sessionStartTime = new Date();
+    return {
+        appUserId: fallbackUserId,
+        vendorId: null,
+        appSessionId: sessionId,
+        installDate: now,
+        isFirstLaunch: true,
+        launchCount: 1,
+        lastLaunchAt: null,
+        bundleId: null,
+        appName: null,
+        appVersion: null,
+        buildNumber: null,
+        sdkVersion: constants_1.SDK_VERSION,
+        platform: react_native_1.Platform.OS === "ios" ? "iOS" : "Android",
+        platformVersion: String(react_native_1.Platform.Version),
+        platformWrapper: "Expo",
+        deviceModel: "unknown",
+        deviceName: "unknown",
+        isSimulator: false,
+        deviceLanguageCode: null,
+        deviceLocale: "en_US",
+        regionCode: null,
+        preferredLanguage: null,
+        preferredLanguages: [],
+        deviceCurrencyCode: null,
+        deviceCurrencySymbol: null,
+        timezoneIdentifier: "UTC",
+        timezoneOffsetSeconds: new Date().getTimezoneOffset() * -60,
+        interfaceStyle: "unspecified",
+        screenWidth: 0,
+        screenHeight: 0,
+        screenScale: 1,
+        isLowPowerMode: false,
+        freeStorageBytes: null,
+        totalStorageBytes: null,
+        totalMemoryBytes: 0,
+        isAppleSearchAdsAttribution: false,
+        appleSearchAdsToken: null,
+        capabilities: [...constants_1.CAPABILITIES],
+        connectionType: null,
+        collectedAt: now,
+    };
+}
+/**
+ * Generate a fallback UUID
+ */
+function generateFallbackUuid() {
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Reset session (call when app is fully restarted)
+ */
+function resetSession() {
+    sessionId = null;
+    sessionStartTime = null;
+}

package/build/EventManager.d.ts

@@ -0,0 +1,155 @@
+/**
+ * RampKit Event Manager
+ * Handles event tracking for the /app-user-events endpoint
+ */
+import { DeviceInfo, EventContext, RampKitEventName } from "./types";
+declare class EventManager {
+    private static _instance;
+    private appId;
+    private appUserId;
+    private sessionId;
+    private device;
+    private baseContext;
+    private currentScreenName;
+    private currentFlowId;
+    private currentVariantId;
+    private currentPaywallId;
+    private currentPlacement;
+    private onboardingStartTime;
+    private currentOnboardingId;
+    private initialized;
+    static get instance(): EventManager;
+    /**
+     * Initialize the event manager with device info
+     */
+    initialize(appId: string, deviceInfo: DeviceInfo): void;
+    /**
+     * Check if the event manager is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Set current screen context
+     */
+    setCurrentScreen(screenName: string | null): void;
+    /**
+     * Set current flow context (e.g., onboarding flow ID)
+     */
+    setCurrentFlow(flowId: string | null, variantId?: string | null): void;
+    /**
+     * Set current paywall context
+     */
+    setCurrentPaywall(paywallId: string | null, placement?: string | null): void;
+    /**
+     * Start onboarding tracking
+     */
+    startOnboardingTracking(onboardingId: string): void;
+    /**
+     * Get onboarding duration in seconds
+     */
+    getOnboardingDurationSeconds(): number;
+    /**
+     * End onboarding tracking
+     */
+    endOnboardingTracking(): void;
+    /**
+     * Get current onboarding ID
+     */
+    getCurrentOnboardingId(): string | null;
+    /**
+     * Track an event
+     */
+    track(eventName: RampKitEventName | string, properties?: Record<string, any>, contextOverrides?: Partial<EventContext>): Promise<void>;
+    /**
+     * Send event to backend (fire and forget)
+     */
+    private sendEvent;
+    /**
+     * 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
+     */
+    trackOnboardingScreenViewed(screenName: string, screenIndex: number, totalScreens: number, onboardingId?: string): void;
+    /**
+     * Track onboarding question answered
+     */
+    trackOnboardingQuestionAnswered(questionId: string, answer: any, questionText?: string, onboardingId?: string): void;
+    /**
+     * Track onboarding completed
+     */
+    trackOnboardingCompleted(completedSteps: number, totalSteps: number, onboardingId?: string): void;
+    /**
+     * Track onboarding abandoned
+     */
+    trackOnboardingAbandoned(reason: string, lastScreenName?: string, onboardingId?: string): void;
+    /**
+     * Track notification prompt shown
+     */
+    trackNotificationsPromptShown(): void;
+    /**
+     * Track notification response
+     */
+    trackNotificationsResponse(status: "granted" | "denied" | "provisional"): void;
+    /**
+     * Track paywall shown
+     */
+    trackPaywallShown(paywallId: string, placement?: string, products?: Array<{
+        productId: string;
+        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
+     */
+    trackPurchaseStarted(productId: string, amount?: number, currency?: string): void;
+    /**
+     * Track purchase completed
+     */
+    trackPurchaseCompleted(properties: {
+        productId: string;
+        amount: number;
+        currency: string;
+        transactionId: string;
+        originalTransactionId?: string;
+        purchaseDate?: string;
+    }): void;
+    /**
+     * Track purchase failed
+     */
+    trackPurchaseFailed(productId: string, errorCode: string, errorMessage: string): void;
+    /**
+     * Reset the event manager (e.g., on logout)
+     */
+    reset(): void;
+}
+export declare const eventManager: EventManager;
+export { EventManager };