@getecho-ai/react-native-sdk 1.0.0 → 1.1.0

package/README.md

@@ -202,6 +202,8 @@ const {
   userId,     // Current user ID
   chatId,     // Current chat ID
   isReady,    // SDK initialized
+  identify,   // Identify user (login)
+  logout,     // Reset to anonymous user
 } = useEcho();
 ```
 
@@ -252,6 +254,87 @@ Control visibility of UI elements:
 >
 ```
 
+## User Authentication
+
+Echo SDK supports three user states:
+
+1. **Anonymous** - Default state. A random UUID is generated and persisted automatically.
+2. **Identified** - User is linked to an email or identifier. Chat history migrates from anonymous to identified user.
+3. **Logged out** - User is reset to a new anonymous state with a fresh UUID.
+
+### Identifying Users
+
+**Option 1: Via config (automatic)**
+
+Pass `userEmail` or `userIdentifier` in the provider config. The SDK auto-identifies on mount:
+
+```tsx
+<EchoProvider
+  config={{
+    apiKey: 'your-key',
+    callbacks,
+    userEmail: user.email,
+    userIdentifier: user.id,
+  }}
+>
+```
+
+**Option 2: Via hook (imperative)**
+
+Call `identify()` after login for full control:
+
+```tsx
+const { identify } = useEcho();
+
+const result = await identify({
+  email: 'user@example.com',
+  userIdentifier: 'user-123',
+  firstName: 'John',
+  lastName: 'Doe',
+  phone: '+905551234567',
+  traits: { plan: 'premium' },
+});
+// result: { success: true, userId: '...', userIdChanged: true }
+```
+
+### Logging Out
+
+Call `logout()` to reset to anonymous state. This generates a new anonymous UUID and clears chat history:
+
+```tsx
+const { logout } = useEcho();
+
+await logout();
+```
+
+### Login / Logout Flow Example
+
+```tsx
+import { useEcho } from '@getecho-ai/react-native-sdk';
+
+function ProfileScreen() {
+  const { identify, logout, userId } = useEcho();
+
+  const handleLogin = async (email: string) => {
+    // Your auth logic...
+    await identify({ email });
+  };
+
+  const handleLogout = async () => {
+    // Your auth logic...
+    await logout();
+  };
+
+  return (
+    <View>
+      <Text>User: {userId}</Text>
+      <Button title="Login" onPress={() => handleLogin('user@example.com')} />
+      <Button title="Logout" onPress={handleLogout} />
+    </View>
+  );
+}
+```
+
 ## Troubleshooting
 
 ### "Network request failed" on Android emulator

package/dist/components/EchoProvider.d.ts

@@ -7,7 +7,7 @@
  * - Bridge initialization
  */
 import type React from "react";
-import type { AddToCartResult, EchoConfig, GetCartResult, Product } from "../types";
+import type { AddToCartResult, EchoConfig, GetCartResult, IdentifyParams, IdentifyResult, Product } from "../types";
 type EchoContextType = {
     config: EchoConfig;
     userId: string;
@@ -15,6 +15,8 @@ type EchoContextType = {
     isReady: boolean;
     updateUserId: (newUserId: string) => Promise<void>;
     updateChatId: (newChatId: string) => Promise<void>;
+    identify: (params: IdentifyParams) => Promise<IdentifyResult>;
+    logout: () => Promise<void>;
     handleAddToCart: (product: Product, quantity?: number) => Promise<AddToCartResult>;
     handleGetCart: () => Promise<GetCartResult>;
     handleNavigateToProduct: (productId: string) => void;

package/dist/components/EchoProvider.js

@@ -14,6 +14,7 @@ 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 WebViewBridge_1 = __importDefault(require("../bridge/WebViewBridge"));
 const resolveApiUrl_1 = require("../utils/resolveApiUrl");
 /**
  * Generate a UUID v4 string
@@ -45,6 +46,7 @@ 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);
+    const suppressAutoIdentifyRef = (0, react_1.useRef)(false);
     // Initialize user ID from storage or generate new one
     (0, react_1.useEffect)(() => {
         const syncUserWithServer = async (id) => {
@@ -175,9 +177,89 @@ const EchoProvider = ({ config, children, }) => {
         config.userIdentifier,
         updateUserId,
     ]);
+    const identify = (0, react_1.useCallback)(async (params) => {
+        const baseUrl = (0, resolveApiUrl_1.resolveApiUrl)(config.apiUrl).replace(/\/+$/, "");
+        try {
+            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: params.email,
+                    userIdentifier: params.userIdentifier,
+                    firstName: params.firstName,
+                    lastName: params.lastName,
+                    phone: params.phone,
+                    traits: params.traits,
+                }),
+            });
+            const data = await response.json();
+            if (data.userIdChanged && data.userId) {
+                await updateUserId(data.userId);
+            }
+            suppressAutoIdentifyRef.current = false;
+            WebViewBridge_1.default.sendRawToWebView({
+                type: "echo:runtime:update_identity",
+                userId: data.userId || userId,
+                email: params.email,
+                userIdentifier: params.userIdentifier,
+            });
+            return {
+                success: true,
+                userId: data.userId || userId,
+                email: params.email,
+                userIdentifier: params.userIdentifier,
+                userIdChanged: !!data.userIdChanged,
+            };
+        }
+        catch (error) {
+            console.error("[EchoSDK] identify() failed:", error);
+            return {
+                success: false,
+                userId,
+                userIdChanged: false,
+            };
+        }
+    }, [userId, config.apiKey, config.apiUrl, updateUserId]);
+    const logout = (0, react_1.useCallback)(async () => {
+        const newAnonymousId = generateUUID();
+        setUserId(newAnonymousId);
+        setChatId("");
+        try {
+            await async_storage_1.default.removeItem("echo_chat_id");
+            await async_storage_1.default.setItem("echo_user_id", newAnonymousId);
+        }
+        catch (error) {
+            console.error("[EchoSDK] logout() storage cleanup failed:", error);
+        }
+        suppressAutoIdentifyRef.current = true;
+        // Fire-and-forget user sync
+        const baseUrl = (0, resolveApiUrl_1.resolveApiUrl)(config.apiUrl).replace(/\/+$/, "");
+        fetch(`${baseUrl}/api/user`, {
+            method: "POST",
+            headers: {
+                "X-API-Key": config.apiKey,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ userId: newAnonymousId }),
+        }).catch((err) => {
+            console.warn("[EchoSDK] logout user sync failed:", err.message);
+        });
+        WebViewBridge_1.default.sendRawToWebView({
+            type: "echo:runtime:reset_user",
+            userId: newAnonymousId,
+        });
+    }, [config.apiKey, config.apiUrl]);
     // Auto-identify user when ready and email/identifier is provided
     (0, react_1.useEffect)(() => {
         if (isReady && userId && (config.userEmail || config.userIdentifier)) {
+            if (suppressAutoIdentifyRef.current) {
+                suppressAutoIdentifyRef.current = false;
+                return;
+            }
             identifyUser();
         }
     }, [isReady, userId, config.userEmail, config.userIdentifier, identifyUser]);
@@ -228,6 +310,8 @@ const EchoProvider = ({ config, children, }) => {
         isReady,
         updateUserId,
         updateChatId,
+        identify,
+        logout,
         handleAddToCart,
         handleGetCart,
         handleNavigateToProduct,

package/dist/index.d.ts

@@ -55,5 +55,5 @@ 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 type { ActionType, AddToCartResult, BridgeMessage, BridgeMessageType, CallbackResult, Cart, CartItem, ChatMessage, EchoCallbacks, EchoConfig, EchoTheme, GetCartResult, IdentifyParams, IdentifyResult, MessageAction, Product, UISettings, } from "./types";
 export { getLocalhostUrl, resolveApiUrl } from "./utils/resolveApiUrl";

package/dist/types/index.d.ts

@@ -154,3 +154,18 @@ export type CallbackResult = {
     data?: any;
     error?: string;
 };
+export type IdentifyParams = {
+    email?: string;
+    userIdentifier?: string;
+    firstName?: string;
+    lastName?: string;
+    phone?: string;
+    traits?: Record<string, unknown>;
+};
+export type IdentifyResult = {
+    success: boolean;
+    userId: string;
+    email?: string;
+    userIdentifier?: string;
+    userIdChanged: boolean;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getecho-ai/react-native-sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Echo AI Chat SDK for React Native - AI-powered e-commerce assistant",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",