@getecho-ai/react-native-sdk 1.0.0

package/dist/components/EchoProvider.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * EchoProvider - Main context provider for Echo SDK
+ *
+ * Provides:
+ * - SDK configuration (apiKey, callbacks)
+ * - User session management
+ * - Bridge initialization
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EchoProvider = exports.useEcho = void 0;
+const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
+const react_1 = require("react");
+const resolveApiUrl_1 = require("../utils/resolveApiUrl");
+/**
+ * Generate a UUID v4 string
+ */
+function generateUUID() {
+    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);
+    });
+}
+/**
+ * Check if a string is a valid UUID v4
+ */
+function isValidUUID(str) {
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(str);
+}
+const EchoContext = (0, react_1.createContext)(null);
+const useEcho = () => {
+    const context = (0, react_1.useContext)(EchoContext);
+    if (!context) {
+        throw new Error("useEcho must be used within EchoProvider");
+    }
+    return context;
+};
+exports.useEcho = useEcho;
+const EchoProvider = ({ config, children, }) => {
+    const [userId, setUserId] = (0, react_1.useState)(config.userId || "");
+    const [chatId, setChatId] = (0, react_1.useState)("");
+    const [isReady, setIsReady] = (0, react_1.useState)(false);
+    // Initialize user ID from storage or generate new one
+    (0, react_1.useEffect)(() => {
+        const syncUserWithServer = async (id) => {
+            const baseUrl = (0, resolveApiUrl_1.resolveApiUrl)(config.apiUrl).replace(/\/+$/, "");
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 5000);
+            try {
+                const response = await fetch(`${baseUrl}/api/user`, {
+                    method: "POST",
+                    headers: {
+                        "X-API-Key": config.apiKey,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({ userId: id }),
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (response.ok) {
+                    const data = await response.json();
+                    if (data.userIdChanged && data.userId) {
+                        await async_storage_1.default.setItem("echo_user_id", data.userId);
+                        setUserId(data.userId);
+                    }
+                }
+            }
+            catch (err) {
+                clearTimeout(timeoutId);
+                if (err instanceof Error && err.name !== "AbortError") {
+                    console.warn("[EchoSDK] User sync failed:", err.message);
+                }
+            }
+        };
+        const initUser = async () => {
+            try {
+                let storedUserId = config.userId;
+                let storedChatId = null;
+                if (!storedUserId) {
+                    storedUserId =
+                        (await async_storage_1.default.getItem("echo_user_id")) || undefined;
+                }
+                const shouldUseStored = storedUserId && (config.userId || isValidUUID(storedUserId));
+                if (!shouldUseStored) {
+                    // Generate new UUID if no stored ID or old format (non-UUID)
+                    storedUserId = generateUUID();
+                    await async_storage_1.default.setItem("echo_user_id", storedUserId);
+                }
+                setUserId(storedUserId || "");
+                await syncUserWithServer(storedUserId || "");
+                try {
+                    storedChatId = await async_storage_1.default.getItem("echo_chat_id");
+                }
+                catch {
+                    storedChatId = null;
+                }
+                if (storedChatId && isValidUUID(storedChatId)) {
+                    setChatId(storedChatId);
+                }
+                setIsReady(true);
+            }
+            catch (error) {
+                console.error("[EchoSDK] Failed to initialize user:", error);
+                // Fallback to temp user ID (UUID format)
+                const tempId = generateUUID();
+                setUserId(tempId);
+                await syncUserWithServer(tempId);
+                setIsReady(true);
+            }
+        };
+        initUser();
+    }, [config.userId, config.apiKey, config.apiUrl]);
+    const updateUserId = (0, react_1.useCallback)(async (newUserId) => {
+        setUserId(newUserId);
+        try {
+            await async_storage_1.default.setItem("echo_user_id", newUserId);
+        }
+        catch (error) {
+            console.error("[EchoSDK] Failed to persist user ID:", error);
+        }
+    }, []);
+    const updateChatId = (0, react_1.useCallback)(async (newChatId) => {
+        setChatId(newChatId);
+        try {
+            await async_storage_1.default.setItem("echo_chat_id", newChatId);
+        }
+        catch (error) {
+            console.error("[EchoSDK] Failed to persist chat ID:", error);
+        }
+    }, []);
+    /**
+     * Identify user with backend (matches web embed behavior)
+     * Calls /api/user/identify if userEmail or userIdentifier is provided
+     * Updates userId in AsyncStorage if backend returns userIdChanged
+     */
+    const identifyUser = (0, react_1.useCallback)(async () => {
+        if (!config.userEmail && !config.userIdentifier) {
+            return; // Nothing to identify
+        }
+        try {
+            const baseUrl = (0, resolveApiUrl_1.resolveApiUrl)(config.apiUrl).replace(/\/+$/, "");
+            const response = await fetch(`${baseUrl}/api/user/identify`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "X-API-Key": config.apiKey,
+                },
+                body: JSON.stringify({
+                    userId,
+                    email: config.userEmail,
+                    userIdentifier: config.userIdentifier,
+                }),
+            });
+            const data = await response.json();
+            // Handle userIdChanged (same as web embed)
+            if (data.userIdChanged && data.userId) {
+                console.log("[EchoSDK] userId changed:", userId, "→", data.userId);
+                await updateUserId(data.userId);
+            }
+        }
+        catch (error) {
+            console.error("[EchoSDK] Identification failed:", error);
+            // Don't block - continue without identification
+        }
+    }, [
+        userId,
+        config.apiKey,
+        config.apiUrl,
+        config.userEmail,
+        config.userIdentifier,
+        updateUserId,
+    ]);
+    // Auto-identify user when ready and email/identifier is provided
+    (0, react_1.useEffect)(() => {
+        if (isReady && userId && (config.userEmail || config.userIdentifier)) {
+            identifyUser();
+        }
+    }, [isReady, userId, config.userEmail, config.userIdentifier, identifyUser]);
+    // Wrap callbacks with error handling
+    const handleAddToCart = (0, react_1.useCallback)(async (product, quantity) => {
+        try {
+            return await config.callbacks.onAddToCart(product, quantity);
+        }
+        catch (error) {
+            console.error("[EchoSDK] onAddToCart error:", error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "ADD_TO_CART_FAILED",
+            };
+        }
+    }, [config.callbacks]);
+    const handleGetCart = (0, react_1.useCallback)(async () => {
+        try {
+            return await config.callbacks.onGetCart();
+        }
+        catch (error) {
+            console.error("[EchoSDK] onGetCart error:", error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "GET_CART_FAILED",
+            };
+        }
+    }, [config.callbacks]);
+    const handleNavigateToProduct = (0, react_1.useCallback)((productId) => {
+        if (config.callbacks.onNavigateToProduct) {
+            config.callbacks.onNavigateToProduct(productId);
+        }
+    }, [config.callbacks.onNavigateToProduct]);
+    const handleNavigateToCheckout = (0, react_1.useCallback)(() => {
+        if (config.callbacks.onNavigateToCheckout) {
+            config.callbacks.onNavigateToCheckout();
+        }
+    }, [config.callbacks.onNavigateToCheckout]);
+    const handleAuthRequired = (0, react_1.useCallback)(() => {
+        if (config.callbacks.onAuthRequired) {
+            config.callbacks.onAuthRequired();
+        }
+    }, [config.callbacks.onAuthRequired]);
+    const value = {
+        config,
+        userId,
+        chatId,
+        isReady,
+        updateUserId,
+        updateChatId,
+        handleAddToCart,
+        handleGetCart,
+        handleNavigateToProduct,
+        handleNavigateToCheckout,
+        handleAuthRequired,
+    };
+    return <EchoContext.Provider value={value}>{children}</EchoContext.Provider>;
+};
+exports.EchoProvider = EchoProvider;
+exports.default = exports.EchoProvider;

package/dist/hooks/useSimpleCart.d.ts

@@ -0,0 +1,76 @@
+/**
+ * useSimpleCart - Ready-to-use cart management hook
+ *
+ * Provides a minimal cart implementation for quick SDK integration.
+ * For production apps, you'll likely want to replace this with your own cart logic.
+ *
+ * @example
+ * ```tsx
+ * import { EchoProvider, EchoChat, useSimpleCart } from '@getecho-ai/react-native-sdk';
+ *
+ * function App() {
+ *   const { cart, callbacks } = useSimpleCart();
+ *
+ *   return (
+ *     <EchoProvider config={{ apiKey: 'your-key', callbacks }}>
+ *       <YourApp cart={cart} />
+ *       <EchoChat />
+ *     </EchoProvider>
+ *   );
+ * }
+ * ```
+ */
+import type { Cart, EchoCallbacks } from "../types";
+export type UseSimpleCartOptions = {
+    /**
+     * Initial cart state
+     */
+    initialCart?: Cart;
+    /**
+     * Called when cart changes (for persistence or sync)
+     */
+    onCartChange?: (cart: Cart) => void;
+    /**
+     * Called when navigating to a product
+     */
+    onNavigateToProduct?: (productId: string) => void;
+    /**
+     * Called when navigating to checkout
+     */
+    onNavigateToCheckout?: () => void;
+    /**
+     * Called when auth is required
+     */
+    onAuthRequired?: () => void;
+};
+export type UseSimpleCartReturn = {
+    /**
+     * Current cart state
+     */
+    cart: Cart;
+    /**
+     * Update cart directly (for external sync)
+     */
+    setCart: React.Dispatch<React.SetStateAction<Cart>>;
+    /**
+     * Clear all items from cart
+     */
+    clearCart: () => void;
+    /**
+     * Remove a specific item from cart
+     */
+    removeItem: (productId: string) => void;
+    /**
+     * Update quantity for a specific item
+     */
+    updateQuantity: (productId: string, quantity: number) => void;
+    /**
+     * Ready-to-use callbacks for EchoProvider
+     */
+    callbacks: EchoCallbacks;
+};
+/**
+ * Simple cart management hook for quick Echo SDK integration
+ */
+export declare function useSimpleCart(options?: UseSimpleCartOptions): UseSimpleCartReturn;
+export default useSimpleCart;

package/dist/hooks/useSimpleCart.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * useSimpleCart - Ready-to-use cart management hook
+ *
+ * Provides a minimal cart implementation for quick SDK integration.
+ * For production apps, you'll likely want to replace this with your own cart logic.
+ *
+ * @example
+ * ```tsx
+ * import { EchoProvider, EchoChat, useSimpleCart } from '@getecho-ai/react-native-sdk';
+ *
+ * function App() {
+ *   const { cart, callbacks } = useSimpleCart();
+ *
+ *   return (
+ *     <EchoProvider config={{ apiKey: 'your-key', callbacks }}>
+ *       <YourApp cart={cart} />
+ *       <EchoChat />
+ *     </EchoProvider>
+ *   );
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSimpleCart = useSimpleCart;
+const react_1 = require("react");
+const DEFAULT_CART = {
+    items: [],
+    itemCount: 0,
+    total: 0,
+    currency: "TRY",
+};
+/**
+ * Simple cart management hook for quick Echo SDK integration
+ */
+function useSimpleCart(options = {}) {
+    const { initialCart = DEFAULT_CART, onCartChange, onNavigateToProduct, onNavigateToCheckout, onAuthRequired, } = options;
+    const [cart, setCart] = (0, react_1.useState)(initialCart);
+    const updateCart = (0, react_1.useCallback)((newCart) => {
+        setCart(newCart);
+        onCartChange?.(newCart);
+    }, [onCartChange]);
+    const clearCart = (0, react_1.useCallback)(() => {
+        updateCart(DEFAULT_CART);
+    }, [updateCart]);
+    const removeItem = (0, react_1.useCallback)((productId) => {
+        setCart((prev) => {
+            const newItems = prev.items.filter((item) => item.productId !== productId);
+            const newCart = calculateCartTotals(newItems, prev.currency);
+            onCartChange?.(newCart);
+            return newCart;
+        });
+    }, [onCartChange]);
+    const updateQuantity = (0, react_1.useCallback)((productId, quantity) => {
+        if (quantity <= 0) {
+            removeItem(productId);
+            return;
+        }
+        setCart((prev) => {
+            const newItems = prev.items.map((item) => item.productId === productId ? { ...item, quantity } : item);
+            const newCart = calculateCartTotals(newItems, prev.currency);
+            onCartChange?.(newCart);
+            return newCart;
+        });
+    }, [onCartChange, removeItem]);
+    // Echo SDK callbacks
+    const onAddToCart = (0, react_1.useCallback)(async (product, quantity = 1) => {
+        setCart((prev) => {
+            const existingIndex = prev.items.findIndex((item) => item.productId === product.id);
+            let newItems;
+            if (existingIndex >= 0) {
+                // Update existing item quantity
+                newItems = prev.items.map((item, index) => index === existingIndex
+                    ? { ...item, quantity: item.quantity + quantity }
+                    : item);
+            }
+            else {
+                // Add new item
+                const newItem = {
+                    productId: product.id,
+                    quantity,
+                    product,
+                };
+                newItems = [...prev.items, newItem];
+            }
+            const newCart = calculateCartTotals(newItems, product.currency || prev.currency);
+            onCartChange?.(newCart);
+            return newCart;
+        });
+        // Return success with updated count (we calculate it here for immediate response)
+        return {
+            success: true,
+            cartItemCount: cart.itemCount + quantity,
+        };
+    }, [cart.itemCount, onCartChange]);
+    const onGetCart = (0, react_1.useCallback)(async () => {
+        return {
+            success: true,
+            cart,
+        };
+    }, [cart]);
+    const callbacks = {
+        onAddToCart,
+        onGetCart,
+        onNavigateToProduct,
+        onNavigateToCheckout,
+        onAuthRequired,
+    };
+    return {
+        cart,
+        setCart,
+        clearCart,
+        removeItem,
+        updateQuantity,
+        callbacks,
+    };
+}
+/**
+ * Calculate cart totals from items
+ */
+function calculateCartTotals(items, currency) {
+    const itemCount = items.reduce((sum, item) => sum + item.quantity, 0);
+    const total = items.reduce((sum, item) => {
+        const price = item.product?.priceAmount || 0;
+        return sum + price * item.quantity;
+    }, 0);
+    return {
+        items,
+        itemCount,
+        total,
+        currency: currency || "TRY",
+    };
+}
+exports.default = useSimpleCart;

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Echo React Native SDK
+ *
+ * AI-powered chat and e-commerce SDK for React Native apps.
+ *
+ * @example Quick Start (with built-in cart)
+ * ```tsx
+ * import { EchoProvider, EchoChat, useSimpleCart } from '@getecho-ai/react-native-sdk';
+ *
+ * function App() {
+ *   const { callbacks } = useSimpleCart();
+ *
+ *   return (
+ *     <EchoProvider config={{ apiKey: 'your-key', callbacks }}>
+ *       <YourApp />
+ *       <EchoChat />
+ *     </EchoProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example Production Setup (custom cart)
+ * ```tsx
+ * import { EchoProvider, EchoChat } from '@getecho-ai/react-native-sdk';
+ *
+ * function App() {
+ *   return (
+ *     <EchoProvider
+ *       config={{
+ *         apiKey: 'your-api-key',
+ *         callbacks: {
+ *           onAddToCart: async (product, quantity) => {
+ *             // Your add to cart logic
+ *             return { success: true, cartItemCount: 5 };
+ *           },
+ *           onGetCart: async () => {
+ *             // Return your cart
+ *             return { success: true, cart: yourCart };
+ *           },
+ *         }
+ *       }}
+ *     >
+ *       <YourApp />
+ *       <EchoChat />
+ *     </EchoProvider>
+ *   );
+ * }
+ * ```
+ */
+export { default as callbackManager } from "./bridge/CallbackManager";
+export { default as webViewBridge } from "./bridge/WebViewBridge";
+export { EchoChat } from "./components/EchoChat";
+export { EchoChatButton } from "./components/EchoChatButton";
+export { EchoChatModal } from "./components/EchoChatModal";
+export { EchoProvider, useEcho } from "./components/EchoProvider";
+export type { UseSimpleCartOptions, UseSimpleCartReturn, } from "./hooks/useSimpleCart";
+export { useSimpleCart } from "./hooks/useSimpleCart";
+export type { ActionType, AddToCartResult, BridgeMessage, BridgeMessageType, CallbackResult, Cart, CartItem, ChatMessage, EchoCallbacks, EchoConfig, EchoTheme, GetCartResult, MessageAction, Product, UISettings, } from "./types";
+export { getLocalhostUrl, resolveApiUrl } from "./utils/resolveApiUrl";

package/dist/index.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Echo React Native SDK
+ *
+ * AI-powered chat and e-commerce SDK for React Native apps.
+ *
+ * @example Quick Start (with built-in cart)
+ * ```tsx
+ * import { EchoProvider, EchoChat, useSimpleCart } from '@getecho-ai/react-native-sdk';
+ *
+ * function App() {
+ *   const { callbacks } = useSimpleCart();
+ *
+ *   return (
+ *     <EchoProvider config={{ apiKey: 'your-key', callbacks }}>
+ *       <YourApp />
+ *       <EchoChat />
+ *     </EchoProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example Production Setup (custom cart)
+ * ```tsx
+ * import { EchoProvider, EchoChat } from '@getecho-ai/react-native-sdk';
+ *
+ * function App() {
+ *   return (
+ *     <EchoProvider
+ *       config={{
+ *         apiKey: 'your-api-key',
+ *         callbacks: {
+ *           onAddToCart: async (product, quantity) => {
+ *             // Your add to cart logic
+ *             return { success: true, cartItemCount: 5 };
+ *           },
+ *           onGetCart: async () => {
+ *             // Return your cart
+ *             return { success: true, cart: yourCart };
+ *           },
+ *         }
+ *       }}
+ *     >
+ *       <YourApp />
+ *       <EchoChat />
+ *     </EchoProvider>
+ *   );
+ * }
+ * ```
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveApiUrl = exports.getLocalhostUrl = exports.useSimpleCart = exports.useEcho = exports.EchoProvider = exports.EchoChatModal = exports.EchoChatButton = exports.EchoChat = exports.webViewBridge = exports.callbackManager = void 0;
+var CallbackManager_1 = require("./bridge/CallbackManager");
+Object.defineProperty(exports, "callbackManager", { enumerable: true, get: function () { return __importDefault(CallbackManager_1).default; } });
+// Bridge utilities (advanced usage)
+var WebViewBridge_1 = require("./bridge/WebViewBridge");
+Object.defineProperty(exports, "webViewBridge", { enumerable: true, get: function () { return __importDefault(WebViewBridge_1).default; } });
+var EchoChat_1 = require("./components/EchoChat");
+Object.defineProperty(exports, "EchoChat", { enumerable: true, get: function () { return EchoChat_1.EchoChat; } });
+var EchoChatButton_1 = require("./components/EchoChatButton");
+Object.defineProperty(exports, "EchoChatButton", { enumerable: true, get: function () { return EchoChatButton_1.EchoChatButton; } });
+var EchoChatModal_1 = require("./components/EchoChatModal");
+Object.defineProperty(exports, "EchoChatModal", { enumerable: true, get: function () { return EchoChatModal_1.EchoChatModal; } });
+// Components
+var EchoProvider_1 = require("./components/EchoProvider");
+Object.defineProperty(exports, "EchoProvider", { enumerable: true, get: function () { return EchoProvider_1.EchoProvider; } });
+Object.defineProperty(exports, "useEcho", { enumerable: true, get: function () { return EchoProvider_1.useEcho; } });
+// Hooks
+var useSimpleCart_1 = require("./hooks/useSimpleCart");
+Object.defineProperty(exports, "useSimpleCart", { enumerable: true, get: function () { return useSimpleCart_1.useSimpleCart; } });
+// Utilities
+var resolveApiUrl_1 = require("./utils/resolveApiUrl");
+Object.defineProperty(exports, "getLocalhostUrl", { enumerable: true, get: function () { return resolveApiUrl_1.getLocalhostUrl; } });
+Object.defineProperty(exports, "resolveApiUrl", { enumerable: true, get: function () { return resolveApiUrl_1.resolveApiUrl; } });