@getecho-ai/react-native-sdk 1.0.0

package/dist/types/index.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Echo React Native SDK - Type Definitions
+ */
+export type Product = {
+    id: string;
+    title: string;
+    description?: string;
+    priceAmount?: number;
+    currency?: string;
+    primaryImage?: string;
+    images?: string[];
+    url?: string;
+    category?: string;
+    brand?: string;
+    inStock?: boolean;
+};
+export type CartItem = {
+    productId: string;
+    quantity: number;
+    product?: Product;
+};
+export type Cart = {
+    items: CartItem[];
+    total?: number;
+    currency?: string;
+    itemCount: number;
+};
+export type AddToCartResult = {
+    success: boolean;
+    cartItemCount?: number;
+    error?: string;
+};
+export type GetCartResult = {
+    success: boolean;
+    cart?: Cart;
+    error?: string;
+};
+export type EchoCallbacks = {
+    /**
+     * Called when AI wants to add a product to cart
+     * Partner must implement their own add to cart logic
+     */
+    onAddToCart: (product: Product, quantity?: number) => Promise<AddToCartResult>;
+    /**
+     * Called when AI wants to know current cart contents
+     * Partner must return their current cart
+     */
+    onGetCart: () => Promise<GetCartResult>;
+    /**
+     * Optional: Called when user taps on a product
+     * Partner can navigate to their product detail screen
+     */
+    onNavigateToProduct?: (productId: string) => void;
+    /**
+     * Optional: Called when widget sends a generic URL navigation request
+     * Useful when productId is not available
+     */
+    onNavigateToUrl?: (url: string) => void;
+    /**
+     * Optional: Called when AI wants to redirect to checkout
+     * Partner can navigate to their checkout screen
+     */
+    onNavigateToCheckout?: () => void;
+    /**
+     * Optional: Called when auth is required for an action
+     * Partner can show login screen
+     */
+    onAuthRequired?: () => void;
+};
+/**
+ * UI customization settings for the chat interface
+ * Allows platform-specific or user-specific UI control
+ */
+export type UISettings = {
+    /**
+     * Control sidebar (conversation history) visibility
+     * - undefined: Default behavior (false in RN, expand button controlled in web)
+     * - true: Force sidebar visible (if conversationHistoryEnabled is also true)
+     * - false: Force sidebar hidden (default for React Native)
+     */
+    showSidebar?: boolean;
+    /**
+     * Control expand/collapse button visibility in header
+     * - undefined: Use partner setting (expandButtonEnabled)
+     * - true: Force show expand button
+     * - false: Force hide expand button
+     */
+    showExpandButton?: boolean;
+    /**
+     * Control cart button visibility in header
+     * - undefined: Use partner setting (cartEnabled)
+     * - true: Force show cart button (requires getCart callback)
+     * - false: Force hide cart button
+     */
+    showCartButton?: boolean;
+    /**
+     * Control chat history/new chat button visibility in header
+     * - undefined: Use partner setting (conversationHistoryEnabled)
+     * - true: Force show history/new chat button
+     * - false: Force hide history/new chat button
+     */
+    showHistoryButton?: boolean;
+    /**
+     * Control close/minimize button visibility in header
+     * - undefined: Always show (default)
+     * - true: Show close button
+     * - false: Hide close button
+     */
+    showCloseButton?: boolean;
+};
+export type EchoConfig = {
+    apiKey: string;
+    apiUrl?: string;
+    callbacks: EchoCallbacks;
+    userId?: string;
+    userEmail?: string;
+    userIdentifier?: string;
+    theme?: EchoTheme;
+    uiSettings?: UISettings;
+};
+export type EchoTheme = {
+    primaryColor?: string;
+    backgroundColor?: string;
+    textColor?: string;
+    fontFamily?: string;
+};
+export type ChatMessage = {
+    id: string;
+    role: "user" | "assistant";
+    content: string;
+    timestamp: Date;
+    products?: Product[];
+    actions?: MessageAction[];
+};
+export type MessageAction = {
+    type: "addToCart" | "viewProduct" | "checkout";
+    label: string;
+    productId?: string;
+};
+export type BridgeMessage = {
+    type: BridgeMessageType;
+    callbackId?: string;
+    payload?: any;
+};
+export type BridgeMessageType = "init" | "action" | "actionComplete" | "navigate" | "close" | "expand" | "collapse" | "requestWidgetState" | "chatId" | "userId" | "echo:agent-state" | "userMessage" | "setUser" | "chatReady" | "echo:request_actions" | "addToCart" | "getCart" | "redirectToCheckout";
+export type ActionType = "addToCart" | "getCart" | "redirectToCheckout" | "getOrders" | "trackOrderState";
+export type PendingCallback = {
+    resolve: (result: CallbackResult) => void;
+    createdAt: number;
+    timeoutId?: ReturnType<typeof setTimeout>;
+};
+export type CallbackResult = {
+    success: boolean;
+    data?: any;
+    error?: string;
+};

package/dist/types/index.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Echo React Native SDK - Type Definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/resolveApiUrl.d.ts

@@ -0,0 +1,42 @@
+/**
+ * resolveApiUrl - Platform-aware URL resolution
+ *
+ * Handles the localhost -> 10.0.2.2 conversion for Android emulator.
+ * On iOS simulator, localhost works directly.
+ * On real devices, you must use your machine's local IP or production URL.
+ *
+ * @example
+ * ```ts
+ * // Development
+ * resolveApiUrl('http://localhost:3000')
+ * // Returns 'http://10.0.2.2:3000' on Android emulator
+ * // Returns 'http://localhost:3000' on iOS simulator
+ *
+ * // Production (no change)
+ * resolveApiUrl('https://api.get-echo.ai')
+ * // Returns 'https://api.get-echo.ai' on all platforms
+ * ```
+ */
+/**
+ * Resolve API URL based on platform
+ *
+ * @param configUrl - URL from config (optional)
+ * @returns Resolved URL appropriate for the current platform
+ */
+export declare function resolveApiUrl(configUrl?: string): string;
+/**
+ * Check if running on Android emulator
+ * Note: This is a simple heuristic, not 100% reliable
+ */
+export declare function isAndroidEmulator(): boolean;
+/**
+ * Check if running on iOS simulator
+ * Note: This is a simple heuristic, not 100% reliable
+ */
+export declare function isIOSSimulator(): boolean;
+/**
+ * Get appropriate localhost URL for current platform
+ * Useful for development setup instructions
+ */
+export declare function getLocalhostUrl(port?: number): string;
+export default resolveApiUrl;

package/dist/utils/resolveApiUrl.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * resolveApiUrl - Platform-aware URL resolution
+ *
+ * Handles the localhost -> 10.0.2.2 conversion for Android emulator.
+ * On iOS simulator, localhost works directly.
+ * On real devices, you must use your machine's local IP or production URL.
+ *
+ * @example
+ * ```ts
+ * // Development
+ * resolveApiUrl('http://localhost:3000')
+ * // Returns 'http://10.0.2.2:3000' on Android emulator
+ * // Returns 'http://localhost:3000' on iOS simulator
+ *
+ * // Production (no change)
+ * resolveApiUrl('https://api.get-echo.ai')
+ * // Returns 'https://api.get-echo.ai' on all platforms
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveApiUrl = resolveApiUrl;
+exports.isAndroidEmulator = isAndroidEmulator;
+exports.isIOSSimulator = isIOSSimulator;
+exports.getLocalhostUrl = getLocalhostUrl;
+const react_native_1 = require("react-native");
+const DEFAULT_API_URL = "https://get-echo.ai";
+/**
+ * Resolve API URL based on platform
+ *
+ * @param configUrl - URL from config (optional)
+ * @returns Resolved URL appropriate for the current platform
+ */
+function resolveApiUrl(configUrl) {
+    // If no URL provided, use production default
+    if (!configUrl) {
+        return DEFAULT_API_URL;
+    }
+    // On Android emulator, replace localhost with 10.0.2.2
+    if (react_native_1.Platform.OS === "android" && isLocalhost(configUrl)) {
+        return configUrl.replace(/localhost/gi, "10.0.2.2");
+    }
+    return configUrl;
+}
+/**
+ * Check if URL points to localhost
+ */
+function isLocalhost(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1";
+    }
+    catch {
+        // If URL parsing fails, do simple string check
+        return url.includes("localhost") || url.includes("127.0.0.1");
+    }
+}
+/**
+ * Check if running on Android emulator
+ * Note: This is a simple heuristic, not 100% reliable
+ */
+function isAndroidEmulator() {
+    return react_native_1.Platform.OS === "android";
+}
+/**
+ * Check if running on iOS simulator
+ * Note: This is a simple heuristic, not 100% reliable
+ */
+function isIOSSimulator() {
+    return react_native_1.Platform.OS === "ios";
+}
+/**
+ * Get appropriate localhost URL for current platform
+ * Useful for development setup instructions
+ */
+function getLocalhostUrl(port = 3000) {
+    if (react_native_1.Platform.OS === "android") {
+        return `http://10.0.2.2:${port}`;
+    }
+    return `http://localhost:${port}`;
+}
+exports.default = resolveApiUrl;

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@getecho-ai/react-native-sdk",
+  "version": "1.0.0",
+  "description": "Echo AI Chat SDK for React Native - AI-powered e-commerce assistant",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/untetheredlabs/echo.git",
+    "directory": "mobile/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/untetheredlabs/echo/issues"
+  },
+  "homepage": "https://github.com/untetheredlabs/echo/tree/main/mobile/sdk#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-native": ">=0.70.0",
+    "react-native-webview": ">=13.0.0",
+    "@react-native-async-storage/async-storage": ">=1.19.0"
+  },
+  "devDependencies": {
+    "@react-native-async-storage/async-storage": "^1.19.0",
+    "@types/react": "^18.2.0",
+    "@types/react-native": "^0.72.0",
+    "react-native-webview": "^13.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "echo",
+    "ai",
+    "chat",
+    "chatbot",
+    "e-commerce",
+    "react-native",
+    "expo",
+    "shopping",
+    "assistant"
+  ],
+  "author": "Echo AI <hello@get-echo.ai>",
+  "license": "MIT"
+}