@oobit/react-native-sdk 2.0.2 → 3.0.1

package/src/WidgetSDK.tsx

@@ -21,26 +21,17 @@ import {
 } from "react-native";
 import { WebView, WebViewMessageEvent } from "react-native-webview";
 import { getWidgetUrl, stripTokenPrefix } from "./config";
-import { CopyToClipboardMessage, WidgetMessage, WidgetSDKConfig } from "./types";
+import { 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>(
   (
-    {
-      accessToken,
-      userWalletAddress,
-      onError,
-      onClose,
-      onTransactionRequested,
-    },
+    { accessToken, userWalletAddress, onClose, onTransactionRequested },
     ref
   ) => {
     const webViewRef = useRef<WebView>(null);
@@ -48,37 +39,23 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
     const [isLoading, setIsLoading] = useState(true);
     const hasLoadedOnce = useRef(false);
 
-    // Check wallet availability on mount
     useEffect(() => {
-      checkWalletAvailability();
+      isWalletAvailable().then(setWalletAvailable);
     }, []);
 
-    // Handle Android hardware back button
     useEffect(() => {
       const backHandler = BackHandler.addEventListener(
         "hardwareBackPress",
         () => {
-          // Send back pressed message to widget
-          sendMessageToWidget({
-            type: "native:back-pressed",
-            timestamp: Date.now(),
-          });
-          // Return true to prevent default back behavior
+          sendMessageToWidget({ type: "native:back-pressed" });
           return true;
         }
       );
-
       return () => backHandler.remove();
     }, []);
 
-    // Expose methods via ref
     useImperativeHandle(ref, () => ({
-      navigateBack: () => {
-        sendMessageToWidget({
-          type: "native:navigate-back",
-          timestamp: Date.now(),
-        });
-      },
+      navigateBack: () => sendMessageToWidget({ type: "native:navigate-back" }),
       reload: () => {
         setIsLoading(true);
         hasLoadedOnce.current = false;
@@ -86,29 +63,25 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
       },
     }));
 
-    const checkWalletAvailability = async () => {
-      const available = await isWalletAvailable();
-      setWalletAvailable(available);
-    };
-
-    /**
-     * Handle messages from the web widget
-     */
     const handleMessage = (event: WebViewMessageEvent) => {
       try {
         const message: WidgetMessage = JSON.parse(event.nativeEvent.data);
 
         switch (message.type) {
           case "widget:ready":
-            handleReady();
+            sendMessageToWidget({
+              type: "native:platform-info",
+              payload: { platform: Platform.OS, walletAvailable },
+            });
             break;
 
           case "widget:open-wallet":
-            handleOpenWallet();
-            break;
-
-          case "widget:error":
-            handleError(message);
+            openNativeWallet().then((success) => {
+              sendMessageToWidget({
+                type: "native:wallet-opened",
+                payload: { success },
+              });
+            });
             break;
 
           case "widget:close":
@@ -116,111 +89,27 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
             break;
 
           case "widget:transaction-requested":
-            handleTransactionRequested(message);
-            break;
-
-          case "widget:token-expired":
-            onError?.("TOKEN_EXPIRED", "Access token has expired");
-            break;
-
-          case "widget:copy-to-clipboard":
-            handleCopyToClipboard(message as CopyToClipboardMessage);
+            onTransactionRequested(message.payload);
             break;
         }
       } catch {
-        onError?.("PARSE_ERROR", "Failed to parse widget message");
+        // Ignore parse errors
       }
     };
 
-    const handleReady = () => {
-      // Send platform info to widget
-      sendMessageToWidget({
-        type: "native:platform-info",
-        payload: {
-          platform: Platform.OS,
-          walletAvailable,
-        },
-      });
-    };
-
-    const handleOpenWallet = async () => {
-      const success = await openNativeWallet();
-
-      // Notify widget of result
-      sendMessageToWidget({
-        type: "native:wallet-opened",
-        payload: { success },
-      });
-    };
-
-    const handleError = (message: WidgetMessage) => {
-      if (message.type !== "widget:error") return;
-
-      const { code, message: errorMessage } = message.payload;
-      onError?.(code, errorMessage);
-    };
-
-    const handleTransactionRequested = (message: WidgetMessage) => {
-      if (message.type !== "widget:transaction-requested") return;
-
-      const { token, cryptoAmount, depositAddress, depositAddressTag } =
-        message.payload;
-
-      onTransactionRequested(
-        token,
-        cryptoAmount,
-        depositAddress,
-        depositAddressTag
-      );
-    };
-
-    /**
-     * Handle clipboard copy request from widget
-     */
-    const handleCopyToClipboard = async (message: CopyToClipboardMessage) => {
-      const { text, label } = message.payload;
-
-      try {
-        await Clipboard.setStringAsync(text);
-        sendMessageToWidget({
-          type: "native:clipboard-result",
-          payload: { success: true, label },
-        });
-      } catch {
-        sendMessageToWidget({
-          type: "native:clipboard-result",
-          payload: {
-            success: false,
-            label,
-            error: "Clipboard operation failed",
-          },
-        });
-      }
-    };
-
-    /**
-     * Send message to the web widget
-     */
     const sendMessageToWidget = (message: unknown) => {
-      const js = `
-      window.postMessage(${JSON.stringify(message)}, '*');
-      true;
-    `;
-
-      webViewRef.current?.injectJavaScript(js);
+      webViewRef.current?.injectJavaScript(
+        `window.postMessage(${JSON.stringify(message)}, '*'); true;`
+      );
     };
 
-    /**
-     * Build the widget URL with query parameters
-     */
     const finalWidgetUrl = useMemo(() => {
       const baseUrl = getWidgetUrl(accessToken);
       const params = new URLSearchParams({
         token: stripTokenPrefix(accessToken),
         platform: Platform.OS,
-        userWalletAddress: userWalletAddress,
+        userWalletAddress,
       });
-
       return `${baseUrl}?${params.toString()}`;
     }, [accessToken, userWalletAddress]);
 
@@ -237,36 +126,24 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
               setIsLoading(false);
             }
           }}
-          onError={() => {
-            setIsLoading(false);
-            onError?.("WEBVIEW_ERROR", "Failed to load widget");
-          }}
-          // Allow external URLs to open in native apps
           onShouldStartLoadWithRequest={(request) => {
             const { url } = request;
-
-            // Allow wallet URLs to open in native apps
             if (
-              url.startsWith("shoebox://") || // Apple Wallet
-              url.includes("pay.google.com") || // Google Wallet
+              url.startsWith("shoebox://") ||
+              url.includes("pay.google.com") ||
               url.includes("wallet.google.com") ||
               url.includes("wallet.apple.com")
             ) {
               Linking.openURL(url).catch(() => {});
-              return false; // Don't load in WebView
+              return false;
             }
-
-            // Allow normal widget navigation
             return true;
           }}
-          // Security settings
           javaScriptEnabled={true}
           domStorageEnabled={true}
           allowsInlineMediaPlayback={true}
-          // iOS specific
           bounces={false}
           allowsBackForwardNavigationGestures={true}
-          // Android specific
           mixedContentMode="always"
         />
         {isLoading && (
@@ -280,12 +157,8 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
 );
 
 const styles = StyleSheet.create({
-  container: {
-    flex: 1,
-  },
-  webview: {
-    flex: 1,
-  },
+  container: { flex: 1 },
+  webview: { flex: 1 },
   loadingOverlay: {
     ...StyleSheet.absoluteFillObject,
     backgroundColor: "rgba(255, 255, 255, 0.9)",

package/src/index.ts

@@ -1,12 +1,10 @@
-/**
- * Widget SDK - Public API
- */
-
-export { WidgetSDK } from "./WidgetSDK";
-export type { WidgetSDKRef } from "./WidgetSDK";
-
 export type {
-  DepositToken,
-  SDKErrorCode,
+  EvmTransactionData,
+  EvmTransactionRequest,
+  SolanaTransactionRequest,
+  TransactionRequest,
+  TransactionTokenMetadata,
   WidgetSDKConfig,
 } from "./types";
+export { WidgetSDK } from "./WidgetSDK";
+export type { WidgetSDKRef } from "./WidgetSDK";

package/src/types.ts

@@ -1,210 +1,72 @@
 /**
- * Widget SDK Types
- * Messages that can be sent between the web widget and React Native
+ * Token metadata included with transaction requests
  */
-
-/**
- * Token information for transaction confirmation
- * Minimal fields needed to display a send transaction confirmation page
- */
-export interface DepositToken {
+export interface TransactionTokenMetadata {
   symbol: string;
-  name: string;
-  networkName: string;
-  chainId: number;
+  amount: string;
+  decimals: number;
 }
 
-export type WidgetMessageType =
-  | "widget:ready"
-  | "widget:open-wallet"
-  | "widget:error"
-  | "widget:close"
-  | "widget:transaction-requested"
-  | "widget:token-expired"
-  | "widget:request-card-details-session"
-  | "widget:copy-to-clipboard";
-
 /**
- * Native Message Types
- * Messages sent from the native app to the web widget
+ * EVM transaction data
  */
-export type NativeMessageType =
-  | "native:platform-info"
-  | "native:wallet-opened"
-  | "native:back-pressed"
-  | "native:navigate-back"
-  | "native:card-details-session"
-  | "native:biometric-failed"
-  | "native:clipboard-result";
-
-export interface NativeBackPressedMessage {
-  type: "native:back-pressed";
-  timestamp: number;
-}
-
-export interface NativeNavigateBackMessage {
-  type: "native:navigate-back";
-  timestamp: number;
-}
-
-export interface NativePlatformInfoMessage {
-  type: "native:platform-info";
-  payload: {
-    platform: "ios" | "android";
-    walletAvailable: boolean;
-  };
-}
-
-export interface NativeWalletOpenedMessage {
-  type: "native:wallet-opened";
-  payload: {
-    success: boolean;
-  };
-}
-
-export interface NativeCardDetailsSessionMessage {
-  type: "native:card-details-session";
-  payload: {
-    sessionId: string; // RSA-encrypted session ID (Base64)
-    secretKey: string; // Secret key in hex format (32 chars)
-  };
-}
-
-export interface NativeBiometricFailedMessage {
-  type: "native:biometric-failed";
-  payload: {
-    reason: "cancelled" | "failed" | "not_available" | "not_enrolled";
-    message?: string;
-  };
-}
-
-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
-  | NativeClipboardResultMessage;
-
-export interface BaseWidgetMessage {
-  type: WidgetMessageType;
-  timestamp: number;
-}
-
-export interface WidgetReadyMessage extends BaseWidgetMessage {
-  type: "widget:ready";
-}
-
-export interface OpenWalletMessage extends BaseWidgetMessage {
-  type: "widget:open-wallet";
-  payload: {
-    platform: "ios" | "android";
-  };
-}
-
-export interface WidgetErrorMessage extends BaseWidgetMessage {
-  type: "widget:error";
-  payload: {
-    code: string;
-    message: string;
-  };
-}
-
-export interface WidgetCloseMessage extends BaseWidgetMessage {
-  type: "widget:close";
-}
-
-export interface TransactionRequestedMessage extends BaseWidgetMessage {
-  type: "widget:transaction-requested";
-  payload: {
-    token: DepositToken;
-    cryptoAmount: string;
-    depositAddress: string;
-    depositAddressTag: string | null;
-  };
-}
-
-export interface TokenExpiredMessage extends BaseWidgetMessage {
-  type: "widget:token-expired";
-  payload?: {
-    reason?: string;
-  };
+export interface EvmTransactionData {
+  to: string;
+  data: string;
+  value: string;
 }
 
-export interface RequestCardDetailsSessionMessage extends BaseWidgetMessage {
-  type: "widget:request-card-details-session";
-  payload: {
-    publicKey: string; // RSA public key in PEM format
-  };
+/**
+ * EVM transaction request payload
+ */
+export interface EvmTransactionRequest {
+  type: "evm";
+  chainId: number;
+  transaction: EvmTransactionData;
+  tokenMetadata: TransactionTokenMetadata;
 }
 
-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")
-  };
+/**
+ * Solana transaction request payload
+ */
+export interface SolanaTransactionRequest {
+  type: "solana";
+  transaction: string;
+  tokenMetadata: TransactionTokenMetadata;
 }
 
-export type WidgetMessage =
-  | WidgetReadyMessage
-  | OpenWalletMessage
-  | WidgetErrorMessage
-  | WidgetCloseMessage
-  | TransactionRequestedMessage
-  | TokenExpiredMessage
-  | RequestCardDetailsSessionMessage
-  | CopyToClipboardMessage;
-
 /**
- * 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
+ * Transaction request payload
  */
-export type SDKErrorCode = "TOKEN_EXPIRED" | "PARSE_ERROR" | "WEBVIEW_ERROR";
+export type TransactionRequest =
+  | EvmTransactionRequest
+  | SolanaTransactionRequest;
 
 /**
  * SDK Configuration
  */
 export interface WidgetSDKConfig {
-  accessToken: string; // Required: Access token from backend (prefixed with sbx_ or prod_)
-  userWalletAddress: string; // Required: User's external wallet address for crypto deposits
-  /**
-   * Called when an error occurs
-   */
-  onError?: (code: SDKErrorCode | string, message: string) => void;
-  /**
-   * Called when the widget requests to close
-   */
+  accessToken: string;
+  userWalletAddress: string;
   onClose?: () => void;
-  /**
-   * Called when a crypto transaction is requested
-   */
-  onTransactionRequested: (
-    token: DepositToken,
-    cryptoAmount: string,
-    depositAddress: string,
-    depositAddressTag: string | null
-  ) => void;
+  onTransactionRequested: (transaction: TransactionRequest) => void;
 }
 
 /**
- * Platform-specific wallet URLs
+ * Internal: Messages from widget
+ */
+export type WidgetMessage =
+  | { type: "widget:ready" }
+  | { type: "widget:open-wallet" }
+  | { type: "widget:close" }
+  | { type: "widget:transaction-requested"; payload: TransactionRequest };
+
+/**
+ * Internal: Wallet URLs
  */
 export const WALLET_URLS = {
   ios: {
-    passkit: "shoebox://", // Apple Wallet deep link
+    passkit: "shoebox://",
     fallback: "https://wallet.apple.com",
   },
   android: {
@@ -212,30 +74,3 @@ export const WALLET_URLS = {
     fallback: "https://wallet.google.com",
   },
 } as const;
-
-/**
- * Message type constants that clients can use
- * @example
- * if (message.type === MessageTypes.READY) {
- *   // Handle ready
- * }
- */
-export const MessageTypes = {
-  // Widget → Native
-  READY: "widget:ready",
-  OPEN_WALLET: "widget:open-wallet",
-  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",
-  BACK_PRESSED: "native:back-pressed",
-  NAVIGATE_BACK: "native:navigate-back",
-  CARD_DETAILS_SESSION: "native:card-details-session",
-  BIOMETRIC_FAILED: "native:biometric-failed",
-  CLIPBOARD_RESULT: "native:clipboard-result",
-} as const;

package/src/walletUtils.ts

@@ -3,7 +3,6 @@
  * Handles opening Apple Wallet (iOS) and Google Wallet (Android)
  */
 
-import * as IntentLauncher from "expo-intent-launcher";
 import { Alert, Linking, Platform } from "react-native";
 import { WALLET_URLS } from "./types";
 
@@ -84,7 +83,7 @@ const openAppleWallet = async (): Promise<boolean> => {
 
 /**
  * Opens Google Wallet on Android
- * Matches the proven Android native implementation from LinksUtils.kt
+ * Uses Linking API to launch the app or fall back to Play Store
  */
 const openGoogleWallet = async (): Promise<boolean> => {
   const GOOGLE_WALLET_PACKAGE = "com.google.android.apps.walletnfcrel";
@@ -92,8 +91,7 @@ const openGoogleWallet = async (): Promise<boolean> => {
   try {
     console.log("Attempting to open Google Wallet...");
 
-    // First, try using the market:// scheme to just launch the app if it's installed
-    // This is the most reliable way to open an installed app without knowing the exact activity
+    // Try using the market:// scheme to launch the app if it's installed
     try {
       const canOpen = await Linking.canOpenURL(`market://launch?id=${GOOGLE_WALLET_PACKAGE}`);
       console.log("Can open market launch URL:", canOpen);
@@ -104,47 +102,34 @@ const openGoogleWallet = async (): Promise<boolean> => {
         return true;
       }
     } catch (marketLaunchError) {
-      console.log("Market launch failed, trying intent launcher:", marketLaunchError);
+      console.log("Market launch failed:", marketLaunchError);
     }
 
-    // Fallback: Try intent launcher with ACTION_VIEW (no explicit className)
-    // This should open the app if it handles the VIEW action
+    // App is not installed or market:// not available, open Play Store
+    console.log("Opening Play Store to install Google Wallet");
     try {
-      await IntentLauncher.startActivityAsync("android.intent.action.VIEW", {
-        packageName: GOOGLE_WALLET_PACKAGE,
-        flags: 268435456, // FLAG_ACTIVITY_NEW_TASK (0x10000000)
-      });
-      console.log("Successfully opened Google Wallet with VIEW intent");
-      return true;
-    } catch (intentError) {
-      console.log("Intent launcher failed:", intentError);
-
-      // App is not installed, open Play Store
-      console.log("App appears to not be installed, opening Play Store");
-      try {
-        // Try native Play Store app first
-        const playStoreUrl = `market://details?id=${GOOGLE_WALLET_PACKAGE}`;
-        await Linking.openURL(playStoreUrl);
-
-        Alert.alert(
-          "Google Wallet",
-          "Google Wallet is not installed. Opening Play Store to install the app."
-        );
-        return false;
-      } catch (marketError) {
-        console.log("Market URL failed, trying web Play Store:", marketError);
-
-        // Fallback to web Play Store
-        await Linking.openURL(
-          `https://play.google.com/store/apps/details?id=${GOOGLE_WALLET_PACKAGE}`
-        );
-
-        Alert.alert(
-          "Google Wallet",
-          "Google Wallet is not installed. Opening Play Store to install the app."
-        );
-        return false;
-      }
+      // Try native Play Store app first
+      const playStoreUrl = `market://details?id=${GOOGLE_WALLET_PACKAGE}`;
+      await Linking.openURL(playStoreUrl);
+
+      Alert.alert(
+        "Google Wallet",
+        "Google Wallet is not installed. Opening Play Store to install the app."
+      );
+      return false;
+    } catch (marketError) {
+      console.log("Market URL failed, trying web Play Store:", marketError);
+
+      // Fallback to web Play Store
+      await Linking.openURL(
+        `https://play.google.com/store/apps/details?id=${GOOGLE_WALLET_PACKAGE}`
+      );
+
+      Alert.alert(
+        "Google Wallet",
+        "Google Wallet is not installed. Opening Play Store to install the app."
+      );
+      return false;
     }
   } catch (error) {
     console.error("Failed to open Google Wallet:", error);