@oobit/react-native-sdk 1.0.6 → 1.1.0

package/src/WidgetSDK.tsx

@@ -20,19 +20,16 @@ import {
   View,
 } from "react-native";
 import { WebView, WebViewMessageEvent } from "react-native-webview";
-import { authenticateWithBiometrics } from "./biometricUtils";
 import { getWidgetUrl } from "./config";
-import { generateSessionCredentials } from "./cryptoUtils";
-import {
-  NativeBiometricFailedMessage,
-  NativeCardDetailsSessionMessage,
-  WidgetMessage,
-  WidgetSDKConfig,
-} from "./types";
+import { CopyToClipboardMessage, WidgetMessage, WidgetSDKConfig } from "./types";
 import { isWalletAvailable, openNativeWallet } from "./walletUtils";
+import * as Clipboard from "expo-clipboard";
 
 export interface WidgetSDKRef {
+  /** Navigate back within the widget */
   navigateBack: () => void;
+  /** Reload the widget */
+  reload: () => void;
 }
 
 export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
@@ -42,13 +39,25 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
       userWalletAddress,
       environment,
       onReady,
-      onCardCreated,
       onError,
       onClose,
       onTransactionRequested,
+      onLoadingChange,
+      debug = false,
+      loadingIndicatorColor = "#007AFF",
     },
     ref
   ) => {
+    // Debug logger - only logs when debug is enabled
+    const log = debug
+      ? (...args: unknown[]) => console.log("[WidgetSDK]", ...args)
+      : () => {};
+    const logError = debug
+      ? (...args: unknown[]) => console.error("[WidgetSDK]", ...args)
+      : () => {};
+    const logWarn = debug
+      ? (...args: unknown[]) => console.warn("[WidgetSDK]", ...args)
+      : () => {};
     const webViewRef = useRef<WebView>(null);
     const [walletAvailable, setWalletAvailable] = useState(false);
     const [isLoading, setIsLoading] = useState(true);
@@ -77,7 +86,7 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
       return () => backHandler.remove();
     }, []);
 
-    // Expose navigateBack method via ref
+    // Expose methods via ref
     useImperativeHandle(ref, () => ({
       navigateBack: () => {
         sendMessageToWidget({
@@ -85,8 +94,19 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
           timestamp: Date.now(),
         });
       },
+      reload: () => {
+        log("Reloading widget");
+        setIsLoading(true);
+        hasLoadedOnce.current = false;
+        webViewRef.current?.reload();
+      },
     }));
 
+    // Notify parent of loading state changes
+    useEffect(() => {
+      onLoadingChange?.(isLoading);
+    }, [isLoading, onLoadingChange]);
+
     const checkWalletAvailability = async () => {
       const available = await isWalletAvailable();
       setWalletAvailable(available);
@@ -99,7 +119,7 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
       try {
         const message: WidgetMessage = JSON.parse(event.nativeEvent.data);
 
-        console.log("[WidgetSDK] Received message:", message.type);
+        log("Received message:", message.type);
 
         switch (message.type) {
           case "widget:ready":
@@ -110,10 +130,6 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
             handleOpenWallet();
             break;
 
-          case "widget:card-created":
-            handleCardCreated(message);
-            break;
-
           case "widget:error":
             handleError(message);
             break;
@@ -127,25 +143,25 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
             break;
 
           case "widget:token-expired":
-            console.error("[WidgetSDK] Access token expired");
+            logError("Access token expired");
             onError?.("TOKEN_EXPIRED", "Access token has expired");
             break;
 
-          case "widget:request-card-details-session":
-            handleCardDetailsRequest(message);
+          case "widget:copy-to-clipboard":
+            handleCopyToClipboard(message as CopyToClipboardMessage);
             break;
 
           default:
-            console.warn("[WidgetSDK] Unknown message type:", message);
+            logWarn("Unknown message type:", message);
         }
       } catch (error) {
-        console.error("[WidgetSDK] Failed to parse message:", error);
+        logError("Failed to parse message:", error);
         onError?.("PARSE_ERROR", "Failed to parse widget message");
       }
     };
 
     const handleReady = () => {
-      console.log("[WidgetSDK] Widget ready");
+      log("Widget ready");
       onReady?.();
 
       // Send platform info to widget
@@ -159,7 +175,7 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
     };
 
     const handleOpenWallet = async () => {
-      console.log("[WidgetSDK] Opening native wallet...");
+      log("Opening native wallet...");
 
       const success = await openNativeWallet();
 
@@ -170,26 +186,17 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
       });
     };
 
-    const handleCardCreated = (message: WidgetMessage) => {
-      if (message.type !== "widget:card-created") return;
-
-      const { cardId, cardType, last4 } = message.payload;
-      console.log("[WidgetSDK] Card created:", cardId);
-
-      onCardCreated?.(cardId, cardType, last4);
-    };
-
     const handleError = (message: WidgetMessage) => {
       if (message.type !== "widget:error") return;
 
       const { code, message: errorMessage } = message.payload;
-      console.error("[WidgetSDK] Widget error:", code, errorMessage);
+      logError("Widget error:", code, errorMessage);
 
       onError?.(code, errorMessage);
     };
 
     const handleClose = () => {
-      console.log("[WidgetSDK] Widget closed");
+      log("Widget closed");
       onClose?.();
     };
 
@@ -198,11 +205,10 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
 
       const { token, cryptoAmount, depositAddress, depositAddressTag } =
         message.payload;
-      console.log("[WidgetSDK] Transaction requested:", {
-        token,
+      log("Transaction requested:", {
+        token: token.symbol,
         cryptoAmount,
         depositAddress,
-        depositAddressTag,
       });
 
       onTransactionRequested?.(
@@ -214,79 +220,30 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
     };
 
     /**
-     * Handle card details session request from widget
-     * 1. Show biometric prompt for user authentication
-     * 2. Generate cryptographically linked sessionId + secretKey pair
-     * 3. Send credentials back to widget for API call and decryption
+     * Handle clipboard copy request from widget
+     * Copies text to device clipboard and sends result back to widget
      */
-    const handleCardDetailsRequest = async (message: WidgetMessage) => {
-      if (message.type !== "widget:request-card-details-session") return;
-
-      const { publicKey } = message.payload;
-      console.log(
-        "[WidgetSDK] Card details requested, initiating biometric auth..."
-      );
+    const handleCopyToClipboard = async (message: CopyToClipboardMessage) => {
+      const { text, label } = message.payload;
+      // Log only the label, never the actual text content (security)
+      log("Copy to clipboard requested:", label || "unlabeled");
 
-      // Step 1: Authenticate with biometrics
-      const biometricResult = await authenticateWithBiometrics(
-        "Authenticate to view card details"
-      );
-
-      if (!biometricResult.success) {
-        console.log(
-          "[WidgetSDK] Biometric auth failed:",
-          biometricResult.error
-        );
-
-        const failedMessage: NativeBiometricFailedMessage = {
-          type: "native:biometric-failed",
-          payload: {
-            reason: biometricResult.error?.reason || "failed",
-            message: biometricResult.error?.message,
-          },
-        };
-
-        sendMessageToWidget(failedMessage);
-        return;
-      }
-
-      // Step 2: Generate session credentials
       try {
-        console.log(
-          "[WidgetSDK] Biometric auth successful, generating session credentials..."
-        );
-
-        const { secretKeyHex, sessionId } = await generateSessionCredentials(
-          publicKey
-        );
-
-        console.log("[WidgetSDK] Session credentials generated successfully");
-
-        // Step 3: Send credentials to widget
-        const sessionMessage: NativeCardDetailsSessionMessage = {
-          type: "native:card-details-session",
-          payload: {
-            sessionId,
-            secretKey: secretKeyHex,
-          },
-        };
-
-        sendMessageToWidget(sessionMessage);
+        await Clipboard.setStringAsync(text);
+        sendMessageToWidget({
+          type: "native:clipboard-result",
+          payload: { success: true, label },
+        });
       } catch (error) {
-        console.error(
-          "[WidgetSDK] Failed to generate session credentials:",
-          error
-        );
-
-        const failedMessage: NativeBiometricFailedMessage = {
-          type: "native:biometric-failed",
+        logError("Clipboard copy failed:", error);
+        sendMessageToWidget({
+          type: "native:clipboard-result",
           payload: {
-            reason: "failed",
-            message: "Failed to generate secure session",
+            success: false,
+            label,
+            error: "Clipboard operation failed",
           },
-        };
-
-        sendMessageToWidget(failedMessage);
+        });
       }
     };
 
@@ -314,7 +271,7 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
       });
 
       const url = `${baseUrl}?${params.toString()}`;
-      console.log("[WidgetSDK] Widget URL:", url.substring(0, 100) + "...");
+      log("Widget URL:", url.substring(0, 100) + "...");
       return url;
     }, [accessToken, userWalletAddress, environment]);
 
@@ -333,7 +290,7 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
           }}
           onError={(syntheticEvent) => {
             const { nativeEvent } = syntheticEvent;
-            console.error("[WidgetSDK] WebView error:", nativeEvent);
+            logError("WebView error:", nativeEvent);
             setIsLoading(false);
             onError?.("WEBVIEW_ERROR", "Failed to load widget");
           }}
@@ -348,9 +305,9 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
               url.includes("wallet.google.com") ||
               url.includes("wallet.apple.com")
             ) {
-              console.log("[WidgetSDK] Opening external URL:", url);
+              log("Opening external URL:", url);
               Linking.openURL(url).catch((err) => {
-                console.error("[WidgetSDK] Failed to open URL:", err);
+                logError("Failed to open URL:", err);
               });
               return false; // Don't load in WebView
             }
@@ -370,7 +327,7 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
         />
         {isLoading && (
           <View style={styles.loadingOverlay}>
-            <ActivityIndicator size="large" color="#007AFF" />
+            <ActivityIndicator size="large" color={loadingIndicatorColor} />
           </View>
         )}
       </View>

package/src/index.ts

@@ -3,59 +3,51 @@
  * Export all public components, types, and utilities
  */
 
-export { WidgetSDK } from './WidgetSDK';
-export type { WidgetSDKRef } from './WidgetSDK';
+export { WidgetSDK } from "./WidgetSDK";
+export type { WidgetSDKRef } from "./WidgetSDK";
 
 // Export all message types for clients to use
 export type {
-  // Configuration
-  WidgetSDKConfig,
-  WidgetEnvironment,
-  DepositToken,
-
-  // Widget → Native message types
-  WidgetMessageType,
   BaseWidgetMessage,
-  WidgetMessage,
-  WidgetReadyMessage,
-  OpenWalletMessage,
-  CardCreatedMessage,
-  WidgetErrorMessage,
-  WidgetCloseMessage,
-  TransactionRequestedMessage,
-  RequestCardDetailsSessionMessage,
-
+  CopyToClipboardMessage,
+  DepositToken,
+  NativeBackPressedMessage,
+  NativeBiometricFailedMessage,
+  NativeCardDetailsSessionMessage,
+  NativeMessage,
   // Native → Widget message types
   NativeMessageType,
-  NativeMessage,
-  NativeBackPressedMessage,
   NativeNavigateBackMessage,
   NativePlatformInfoMessage,
   NativeWalletOpenedMessage,
-  NativeCardDetailsSessionMessage,
-  NativeBiometricFailedMessage,
-} from './types';
+  OpenWalletMessage,
+  RequestCardDetailsSessionMessage,
+  TokenExpiredMessage,
+  TransactionRequestedMessage,
+  WidgetCloseMessage,
+  WidgetEnvironment,
+  WidgetErrorMessage,
+  WidgetMessage,
+  // Widget → Native message types
+  WidgetMessageType,
+  WidgetReadyMessage,
+  // Configuration
+  WidgetSDKConfig,
+  // Error codes
+  SDKErrorCode,
+} from "./types";
 
 // Export constants
-export { WALLET_URLS, MessageTypes } from './types';
-export { WIDGET_URLS, getWidgetUrl } from './config';
+export { getWidgetUrl, WIDGET_URLS } from "./config";
+export { MessageTypes, WALLET_URLS } from "./types";
 
 // Export wallet utilities
-export { openNativeWallet, isWalletAvailable } from './walletUtils';
-
-// Export biometric utilities
-export {
-  authenticateWithBiometrics,
-  isBiometricAvailable,
-  getBiometryTypeLabel,
-  AuthenticationType,
-} from './biometricUtils';
-export type { BiometricResult, BiometricAvailability } from './biometricUtils';
+export { isWalletAvailable, openNativeWallet } from "./walletUtils";
 
 // Export crypto utilities (for advanced usage)
 export {
-  generateSessionCredentials,
   generateRandomHexKey,
+  generateSessionCredentials,
   hexToBase64,
-} from './cryptoUtils';
-export type { SessionCredentials } from './cryptoUtils';
+} from "./cryptoUtils";
+export type { SessionCredentials } from "./cryptoUtils";

package/src/types.ts

@@ -17,12 +17,12 @@ export interface DepositToken {
 export type WidgetMessageType =
   | "widget:ready"
   | "widget:open-wallet"
-  | "widget:card-created"
   | "widget:error"
   | "widget:close"
   | "widget:transaction-requested"
   | "widget:token-expired"
-  | "widget:request-card-details-session";
+  | "widget:request-card-details-session"
+  | "widget:copy-to-clipboard";
 
 /**
  * Native Message Types
@@ -34,7 +34,8 @@ export type NativeMessageType =
   | "native:back-pressed"
   | "native:navigate-back"
   | "native:card-details-session"
-  | "native:biometric-failed";
+  | "native:biometric-failed"
+  | "native:clipboard-result";
 
 export interface NativeBackPressedMessage {
   type: "native:back-pressed";
@@ -49,7 +50,7 @@ export interface NativeNavigateBackMessage {
 export interface NativePlatformInfoMessage {
   type: "native:platform-info";
   payload: {
-    platform: string;
+    platform: "ios" | "android";
     walletAvailable: boolean;
   };
 }
@@ -77,13 +78,23 @@ export interface NativeBiometricFailedMessage {
   };
 }
 
+export interface NativeClipboardResultMessage {
+  type: "native:clipboard-result";
+  payload: {
+    success: boolean;
+    label?: string; // Echo back the label for correlation
+    error?: string;
+  };
+}
+
 export type NativeMessage =
   | NativeBackPressedMessage
   | NativeNavigateBackMessage
   | NativePlatformInfoMessage
   | NativeWalletOpenedMessage
   | NativeCardDetailsSessionMessage
-  | NativeBiometricFailedMessage;
+  | NativeBiometricFailedMessage
+  | NativeClipboardResultMessage;
 
 export interface BaseWidgetMessage {
   type: WidgetMessageType;
@@ -101,15 +112,6 @@ export interface OpenWalletMessage extends BaseWidgetMessage {
   };
 }
 
-export interface CardCreatedMessage extends BaseWidgetMessage {
-  type: "widget:card-created";
-  payload: {
-    cardId: string;
-    cardType: "virtual" | "physical";
-    last4: string;
-  };
-}
-
 export interface WidgetErrorMessage extends BaseWidgetMessage {
   type: "widget:error";
   payload: {
@@ -146,15 +148,23 @@ export interface RequestCardDetailsSessionMessage extends BaseWidgetMessage {
   };
 }
 
+export interface CopyToClipboardMessage extends BaseWidgetMessage {
+  type: "widget:copy-to-clipboard";
+  payload: {
+    text: string;
+    label?: string; // Optional: human-readable label for analytics/logging (e.g., "Card Number", "Deposit Address")
+  };
+}
+
 export type WidgetMessage =
   | WidgetReadyMessage
   | OpenWalletMessage
-  | CardCreatedMessage
   | WidgetErrorMessage
   | WidgetCloseMessage
   | TransactionRequestedMessage
   | TokenExpiredMessage
-  | RequestCardDetailsSessionMessage;
+  | RequestCardDetailsSessionMessage
+  | CopyToClipboardMessage;
 
 /**
  * Widget environment configuration
@@ -163,6 +173,14 @@ export type WidgetMessage =
  */
 export type WidgetEnvironment = "development" | "production";
 
+/**
+ * Known SDK error codes
+ * - TOKEN_EXPIRED: The access token has expired
+ * - PARSE_ERROR: Failed to parse a message from the widget
+ * - WEBVIEW_ERROR: The WebView failed to load
+ */
+export type SDKErrorCode = "TOKEN_EXPIRED" | "PARSE_ERROR" | "WEBVIEW_ERROR";
+
 /**
  * SDK Configuration
  */
@@ -176,16 +194,44 @@ export interface WidgetSDKConfig {
    * @default 'production'
    */
   environment?: WidgetEnvironment;
+  /**
+   * Called when the widget is ready and loaded
+   */
   onReady?: () => void;
-  onCardCreated?: (cardId: string, cardType: string, last4: string) => void;
-  onError?: (code: string, message: string) => void;
+  /**
+   * Called when an error occurs
+   * @param code - Error code (SDKErrorCode or custom widget error code)
+   * @param message - Human-readable error message
+   */
+  onError?: (code: SDKErrorCode | string, message: string) => void;
+  /**
+   * Called when the widget requests to close
+   */
   onClose?: () => void;
+  /**
+   * Called when a crypto transaction is requested
+   */
   onTransactionRequested?: (
     token: DepositToken,
     cryptoAmount: string,
     depositAddress: string,
     depositAddressTag: string | null
   ) => void;
+  /**
+   * Called when the loading state changes
+   * @param isLoading - Whether the widget is currently loading
+   */
+  onLoadingChange?: (isLoading: boolean) => void;
+  /**
+   * Enable debug logging to console
+   * @default false
+   */
+  debug?: boolean;
+  /**
+   * Custom color for the loading indicator
+   * @default "#007AFF"
+   */
+  loadingIndicatorColor?: string;
 }
 
 /**
@@ -213,12 +259,12 @@ export const MessageTypes = {
   // Widget → Native
   READY: "widget:ready",
   OPEN_WALLET: "widget:open-wallet",
-  CARD_CREATED: "widget:card-created",
   ERROR: "widget:error",
   CLOSE: "widget:close",
   TRANSACTION_REQUESTED: "widget:transaction-requested",
   TOKEN_EXPIRED: "widget:token-expired",
   REQUEST_CARD_DETAILS_SESSION: "widget:request-card-details-session",
+  COPY_TO_CLIPBOARD: "widget:copy-to-clipboard",
   // Native → Widget
   PLATFORM_INFO: "native:platform-info",
   WALLET_OPENED: "native:wallet-opened",
@@ -226,4 +272,5 @@ export const MessageTypes = {
   NAVIGATE_BACK: "native:navigate-back",
   CARD_DETAILS_SESSION: "native:card-details-session",
   BIOMETRIC_FAILED: "native:biometric-failed",
+  CLIPBOARD_RESULT: "native:clipboard-result",
 } as const;