@tolinku/react-native-sdk 0.1.0 → 0.3.0

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { StyleSheet, AppState, Dimensions, Modal, Pressable, TouchableOpacity, Text, ScrollView, View, ImageBackground, Image, Linking } from 'react-native';
+import { StyleSheet, AppState, Dimensions, Platform, PixelRatio, Modal, Pressable, TouchableOpacity, Text, ScrollView, View, ImageBackground, Image, Linking } from 'react-native';
 import AsyncStorage from '@react-native-async-storage/async-storage';
 import { useState, useRef, useMemo, useEffect, useCallback } from 'react';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
@@ -347,6 +347,215 @@ var Analytics = class {
     }
   }
 };
+var BATCH_SIZE2 = 10;
+var FLUSH_INTERVAL_MS2 = 5e3;
+var MAX_QUEUE_SIZE2 = 500;
+var CART_ID_STORAGE_KEY = "tolinku_ecom_cart_id";
+var Ecommerce = class {
+  constructor(client, getUserId) {
+    this.queue = [];
+    this.flushTimer = null;
+    this.appStateSubscription = null;
+    this.isFlushing = false;
+    this.memoryCartId = null;
+    this.handleAppStateChange = (state) => {
+      if (state === "background" || state === "inactive") {
+        this.flush().catch(() => {
+        });
+      }
+    };
+    this.client = client;
+    this.getUserId = getUserId;
+    this.appStateSubscription = AppState.addEventListener(
+      "change",
+      this.handleAppStateChange
+    );
+  }
+  // ─── Public methods (13 event types) ────────────────────
+  async viewItem(params) {
+    await this.enqueue({ event_type: "view_item", items: params.items });
+  }
+  async addToCart(params) {
+    const cartId = params.cart_id || await this.getOrCreateCartId();
+    await this.enqueue({ event_type: "add_to_cart", items: params.items, cart_id: cartId });
+  }
+  async removeFromCart(params) {
+    const cartId = params.cart_id || await this.getCartId();
+    await this.enqueue({ event_type: "remove_from_cart", items: params.items, cart_id: cartId });
+  }
+  async addToWishlist(params) {
+    await this.enqueue({ event_type: "add_to_wishlist", items: params.items });
+  }
+  async viewCart() {
+    const cartId = await this.getCartId();
+    await this.enqueue({ event_type: "view_cart", cart_id: cartId });
+  }
+  async addPaymentInfo(params) {
+    const cartId = params?.cart_id || await this.getCartId();
+    await this.enqueue({ event_type: "add_payment_info", cart_id: cartId });
+  }
+  async beginCheckout(params) {
+    const cartId = params.cart_id || await this.getCartId();
+    await this.enqueue({
+      event_type: "begin_checkout",
+      revenue: params.revenue,
+      currency: params.currency,
+      cart_id: cartId,
+      items: params.items
+    });
+  }
+  async purchase(params) {
+    const cartId = params.cart_id || await this.getCartId();
+    await this.enqueue({
+      event_type: "purchase",
+      transaction_id: params.transaction_id,
+      revenue: params.revenue,
+      currency: params.currency,
+      cart_id: cartId,
+      coupon_code: params.coupon_code,
+      discount: params.discount,
+      shipping: params.shipping,
+      tax: params.tax,
+      items: params.items
+    });
+    await this.clearCartId();
+  }
+  async refund(params) {
+    await this.enqueue({
+      event_type: "refund",
+      transaction_id: params.transaction_id,
+      revenue: params.revenue,
+      currency: params.currency,
+      items: params.items
+    });
+  }
+  async search(params) {
+    await this.enqueue({ event_type: "search", properties: { search_term: params.search_term } });
+  }
+  async share(params) {
+    const props = {};
+    if (params.item_id) props.item_id = params.item_id;
+    if (params.url) props.url = params.url;
+    if (params.method) props.method = params.method;
+    await this.enqueue({ event_type: "share", properties: props });
+  }
+  async rate(params) {
+    await this.enqueue({
+      event_type: "rate",
+      properties: {
+        item_id: params.item_id,
+        rating: String(params.rating),
+        ...params.max_rating != null ? { max_rating: String(params.max_rating) } : {}
+      }
+    });
+  }
+  async spendCredits(params) {
+    await this.enqueue({ event_type: "spend_credits", revenue: params.revenue, currency: params.currency });
+  }
+  // ─── Flush ─────────────────────────────────────────────
+  async flush() {
+    if (this.queue.length === 0 || this.isFlushing) return;
+    this.isFlushing = true;
+    const events = this.queue.splice(0);
+    this.cancelFlushTimer();
+    try {
+      debugLog(`Flushing ${events.length} ecommerce event(s)`);
+      const result = await this.client.post(
+        "/v1/api/analytics/ecommerce/batch",
+        { events }
+      );
+      if (result.errors && result.errors.length > 0) {
+        debugWarn(`Ecommerce batch partial failure: ${result.errors.join(", ")}`);
+      }
+    } catch (err) {
+      debugWarn(`Failed to flush ecommerce events: ${err.message}`);
+      const spaceLeft = MAX_QUEUE_SIZE2 - this.queue.length;
+      if (spaceLeft > 0) {
+        this.queue.unshift(...events.slice(0, spaceLeft));
+      }
+    } finally {
+      this.isFlushing = false;
+    }
+  }
+  async destroy() {
+    this.cancelFlushTimer();
+    this.appStateSubscription?.remove();
+    this.appStateSubscription = null;
+    try {
+      await this.flush();
+    } catch {
+    }
+  }
+  // ─── Private ───────────────────────────────────────────
+  async enqueue(event) {
+    const userId = this.getUserId();
+    if (userId) event.user_id = userId;
+    if (this.queue.length >= MAX_QUEUE_SIZE2) {
+      debugWarn(`Ecommerce queue full (${MAX_QUEUE_SIZE2}). Dropping oldest event.`);
+      this.queue.shift();
+    }
+    this.queue.push(event);
+    if (this.queue.length >= BATCH_SIZE2) {
+      await this.flush();
+    } else if (this.queue.length === 1) {
+      this.startFlushTimer();
+    }
+  }
+  startFlushTimer() {
+    this.cancelFlushTimer();
+    this.flushTimer = setTimeout(() => {
+      this.flush().catch((err) => {
+        debugWarn(`Ecommerce timer flush failed: ${err.message}`);
+      });
+    }, FLUSH_INTERVAL_MS2);
+  }
+  cancelFlushTimer() {
+    if (this.flushTimer !== null) {
+      clearTimeout(this.flushTimer);
+      this.flushTimer = null;
+    }
+  }
+  // ─── Cart ID lifecycle (AsyncStorage + memory fallback) ─
+  async getOrCreateCartId() {
+    const existing = await this.getCartId();
+    if (existing) return existing;
+    const cartId = this.generateId();
+    await this.setCartId(cartId);
+    return cartId;
+  }
+  async getCartId() {
+    try {
+      const stored = await AsyncStorage.getItem(CART_ID_STORAGE_KEY);
+      if (stored) return stored;
+    } catch {
+    }
+    return this.memoryCartId || void 0;
+  }
+  async setCartId(cartId) {
+    this.memoryCartId = cartId;
+    try {
+      await AsyncStorage.setItem(CART_ID_STORAGE_KEY, cartId);
+    } catch {
+    }
+  }
+  async clearCartId() {
+    this.memoryCartId = null;
+    try {
+      await AsyncStorage.removeItem(CART_ID_STORAGE_KEY);
+    } catch {
+    }
+  }
+  generateId() {
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+      return crypto.randomUUID();
+    }
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+      const r = Math.random() * 16 | 0;
+      const v = c === "x" ? r : r & 3 | 8;
+      return v.toString(16);
+    });
+  }
+};
 
 // src/referrals.ts
 var Referrals = class {
@@ -439,15 +648,29 @@ var Deferred = class {
     try {
       const { width, height } = Dimensions.get("screen");
       const resolvedTimezone = options.timezone || Intl.DateTimeFormat().resolvedOptions().timeZone;
-      const resolvedLanguage = options.language || "en";
+      const resolvedLanguage = options.language || (typeof Intl !== "undefined" && typeof Intl.DateTimeFormat === "function" ? Intl.DateTimeFormat().resolvedOptions().locale : void 0) || "en";
       return await this.client.postPublic("/v1/api/deferred/claim-by-signals", {
         appspace_id: options.appspaceId,
         timezone: resolvedTimezone,
         language: resolvedLanguage,
         screen_width: options.screenWidth || width,
-        screen_height: options.screenHeight || height
+        screen_height: options.screenHeight || height,
+        // Separates devices reporting identical dp dimensions.
+        device_pixel_ratio: options.devicePixelRatio || PixelRatio.get(),
+        os_version: options.osVersion || String(Platform.Version)
       });
     } catch (err) {
+      const status = err?.statusCode ?? err?.status;
+      if (status === 404) {
+        debugWarn("Deferred claimBySignals: no match for this device.");
+        return null;
+      }
+      if (status === 403) {
+        console.warn(
+          `[Tolinku] claimBySignals failed with HTTP 403. Check that appspaceId is your Appspace ID (copy it from the dashboard under Settings), not your subdomain or slug. ${err.message}`
+        );
+        return null;
+      }
       debugWarn(`Deferred claimBySignals failed: ${err.message}`);
       return null;
     }
@@ -562,6 +785,7 @@ var _Tolinku = class _Tolinku {
     setStorageNamespace(config.apiKey);
     _Tolinku.client = new HttpClient(resolvedConfig);
     _Tolinku.analyticsInstance = new Analytics(_Tolinku.client);
+    _Tolinku.ecommerceInstance = new Ecommerce(_Tolinku.client, () => _Tolinku._userId);
     _Tolinku.referralsInstance = new Referrals(_Tolinku.client);
     _Tolinku.deferredInstance = new Deferred(_Tolinku.client);
     _Tolinku._initialized = true;
@@ -602,13 +826,23 @@ var _Tolinku = class _Tolinku {
     return _Tolinku.analyticsInstance.track(eventType, mergedProps);
   }
   /**
-   * Immediately flush all queued analytics events to the server.
+   * Immediately flush all queued analytics and ecommerce events to the server.
    */
   static async flush() {
     if (!_Tolinku.analyticsInstance) {
       throw new Error("Tolinku: SDK not initialized. Call Tolinku.init() first.");
     }
-    return _Tolinku.analyticsInstance.flush();
+    await Promise.all([
+      _Tolinku.analyticsInstance.flush(),
+      _Tolinku.ecommerceInstance?.flush()
+    ]);
+  }
+  /** Ecommerce: track purchases, carts, products, revenue */
+  static get ecommerce() {
+    if (!_Tolinku.ecommerceInstance) {
+      throw new Error("Tolinku: SDK not initialized. Call Tolinku.init() first.");
+    }
+    return _Tolinku.ecommerceInstance;
   }
   /** Referrals: create, complete, milestone, leaderboard, claimReward */
   static get referrals() {
@@ -635,12 +869,16 @@ var _Tolinku = class _Tolinku {
     if (_Tolinku.analyticsInstance) {
       await _Tolinku.analyticsInstance.destroy();
     }
+    if (_Tolinku.ecommerceInstance) {
+      await _Tolinku.ecommerceInstance.destroy();
+    }
     if (_Tolinku.client) {
       _Tolinku.client.abort();
     }
     resetStorageNamespace();
     _Tolinku.client = null;
     _Tolinku.analyticsInstance = null;
+    _Tolinku.ecommerceInstance = null;
     _Tolinku.referralsInstance = null;
     _Tolinku.deferredInstance = null;
     _Tolinku._initialized = false;
@@ -651,6 +889,7 @@ var _Tolinku = class _Tolinku {
 _Tolinku.VERSION = SDK_VERSION;
 _Tolinku.client = null;
 _Tolinku.analyticsInstance = null;
+_Tolinku.ecommerceInstance = null;
 _Tolinku.referralsInstance = null;
 _Tolinku.deferredInstance = null;
 _Tolinku._initialized = false;