@oobit/react-native-sdk 1.0.4 → 1.0.6

package/dist/types.d.ts

@@ -12,67 +12,81 @@ export interface DepositToken {
     iconUrl: string | null;
     networkName: string;
 }
-export type WidgetMessageType = 'widget:ready' | 'widget:open-wallet' | 'widget:card-created' | 'widget:error' | 'widget:close' | 'widget:transaction-requested' | 'widget:token-expired';
+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";
 /**
  * Native Message Types
  * Messages sent from the native app to the web widget
  */
-export type NativeMessageType = 'native:platform-info' | 'native:wallet-opened' | 'native:back-pressed' | 'native:navigate-back';
+export type NativeMessageType = "native:platform-info" | "native:wallet-opened" | "native:back-pressed" | "native:navigate-back" | "native:card-details-session" | "native:biometric-failed";
 export interface NativeBackPressedMessage {
-    type: 'native:back-pressed';
+    type: "native:back-pressed";
     timestamp: number;
 }
 export interface NativeNavigateBackMessage {
-    type: 'native:navigate-back';
+    type: "native:navigate-back";
     timestamp: number;
 }
 export interface NativePlatformInfoMessage {
-    type: 'native:platform-info';
+    type: "native:platform-info";
     payload: {
         platform: string;
         walletAvailable: boolean;
     };
 }
 export interface NativeWalletOpenedMessage {
-    type: 'native:wallet-opened';
+    type: "native:wallet-opened";
     payload: {
         success: boolean;
     };
 }
-export type NativeMessage = NativeBackPressedMessage | NativeNavigateBackMessage | NativePlatformInfoMessage | NativeWalletOpenedMessage;
+export interface NativeCardDetailsSessionMessage {
+    type: "native:card-details-session";
+    payload: {
+        sessionId: string;
+        secretKey: string;
+    };
+}
+export interface NativeBiometricFailedMessage {
+    type: "native:biometric-failed";
+    payload: {
+        reason: "cancelled" | "failed" | "not_available" | "not_enrolled";
+        message?: string;
+    };
+}
+export type NativeMessage = NativeBackPressedMessage | NativeNavigateBackMessage | NativePlatformInfoMessage | NativeWalletOpenedMessage | NativeCardDetailsSessionMessage | NativeBiometricFailedMessage;
 export interface BaseWidgetMessage {
     type: WidgetMessageType;
     timestamp: number;
 }
 export interface WidgetReadyMessage extends BaseWidgetMessage {
-    type: 'widget:ready';
+    type: "widget:ready";
 }
 export interface OpenWalletMessage extends BaseWidgetMessage {
-    type: 'widget:open-wallet';
+    type: "widget:open-wallet";
     payload: {
-        platform: 'ios' | 'android';
+        platform: "ios" | "android";
     };
 }
 export interface CardCreatedMessage extends BaseWidgetMessage {
-    type: 'widget:card-created';
+    type: "widget:card-created";
     payload: {
         cardId: string;
-        cardType: 'virtual' | 'physical';
+        cardType: "virtual" | "physical";
         last4: string;
     };
 }
 export interface WidgetErrorMessage extends BaseWidgetMessage {
-    type: 'widget:error';
+    type: "widget:error";
     payload: {
         code: string;
         message: string;
     };
 }
 export interface WidgetCloseMessage extends BaseWidgetMessage {
-    type: 'widget:close';
+    type: "widget:close";
 }
 export interface TransactionRequestedMessage extends BaseWidgetMessage {
-    type: 'widget:transaction-requested';
+    type: "widget:transaction-requested";
     payload: {
         token: DepositToken;
         cryptoAmount: string;
@@ -81,18 +95,24 @@ export interface TransactionRequestedMessage extends BaseWidgetMessage {
     };
 }
 export interface TokenExpiredMessage extends BaseWidgetMessage {
-    type: 'widget:token-expired';
+    type: "widget:token-expired";
     payload?: {
         reason?: string;
     };
 }
-export type WidgetMessage = WidgetReadyMessage | OpenWalletMessage | CardCreatedMessage | WidgetErrorMessage | WidgetCloseMessage | TransactionRequestedMessage | TokenExpiredMessage;
+export interface RequestCardDetailsSessionMessage extends BaseWidgetMessage {
+    type: "widget:request-card-details-session";
+    payload: {
+        publicKey: string;
+    };
+}
+export type WidgetMessage = WidgetReadyMessage | OpenWalletMessage | CardCreatedMessage | WidgetErrorMessage | WidgetCloseMessage | TransactionRequestedMessage | TokenExpiredMessage | RequestCardDetailsSessionMessage;
 /**
  * Widget environment configuration
  * - 'development': Uses development/staging widget URL
  * - 'production': Uses production widget URL
  */
-export type WidgetEnvironment = 'development' | 'production';
+export type WidgetEnvironment = "development" | "production";
 /**
  * SDK Configuration
  */
@@ -140,9 +160,12 @@ export declare const MessageTypes: {
     readonly CLOSE: "widget:close";
     readonly TRANSACTION_REQUESTED: "widget:transaction-requested";
     readonly TOKEN_EXPIRED: "widget:token-expired";
+    readonly REQUEST_CARD_DETAILS_SESSION: "widget:request-card-details-session";
     readonly PLATFORM_INFO: "native:platform-info";
     readonly WALLET_OPENED: "native:wallet-opened";
     readonly BACK_PRESSED: "native:back-pressed";
     readonly NAVIGATE_BACK: "native:navigate-back";
+    readonly CARD_DETAILS_SESSION: "native:card-details-session";
+    readonly BIOMETRIC_FAILED: "native:biometric-failed";
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -10,12 +10,12 @@ exports.MessageTypes = exports.WALLET_URLS = void 0;
  */
 exports.WALLET_URLS = {
     ios: {
-        passkit: 'shoebox://', // Apple Wallet deep link
-        fallback: 'https://wallet.apple.com',
+        passkit: "shoebox://", // Apple Wallet deep link
+        fallback: "https://wallet.apple.com",
     },
     android: {
-        googlePay: 'https://pay.google.com/gp/w/home/wallet',
-        fallback: 'https://wallet.google.com',
+        googlePay: "https://pay.google.com/gp/w/home/wallet",
+        fallback: "https://wallet.google.com",
     },
 };
 /**
@@ -27,17 +27,20 @@ exports.WALLET_URLS = {
  */
 exports.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',
+    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",
     // Native → Widget
-    PLATFORM_INFO: 'native:platform-info',
-    WALLET_OPENED: 'native:wallet-opened',
-    BACK_PRESSED: 'native:back-pressed',
-    NAVIGATE_BACK: 'native:navigate-back',
+    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",
 };
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAyJH;;GAEG;AACU,QAAA,WAAW,GAAG;IACzB,GAAG,EAAE;QACH,OAAO,EAAE,YAAY,EAAE,yBAAyB;QAChD,QAAQ,EAAE,0BAA0B;KACrC;IACD,OAAO,EAAE;QACP,SAAS,EAAE,yCAAyC;QACpD,QAAQ,EAAE,2BAA2B;KACtC;CACO,CAAC;AAEX;;;;;;GAMG;AACU,QAAA,YAAY,GAAG;IAC1B,kBAAkB;IAClB,KAAK,EAAE,cAAc;IACrB,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,qBAAqB;IACnC,KAAK,EAAE,cAAc;IACrB,KAAK,EAAE,cAAc;IACrB,qBAAqB,EAAE,8BAA8B;IACrD,aAAa,EAAE,sBAAsB;IACrC,kBAAkB;IAClB,aAAa,EAAE,sBAAsB;IACrC,aAAa,EAAE,sBAAsB;IACrC,YAAY,EAAE,qBAAqB;IACnC,aAAa,EAAE,sBAAsB;CAC7B,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA2LH;;GAEG;AACU,QAAA,WAAW,GAAG;IACzB,GAAG,EAAE;QACH,OAAO,EAAE,YAAY,EAAE,yBAAyB;QAChD,QAAQ,EAAE,0BAA0B;KACrC;IACD,OAAO,EAAE;QACP,SAAS,EAAE,yCAAyC;QACpD,QAAQ,EAAE,2BAA2B;KACtC;CACO,CAAC;AAEX;;;;;;GAMG;AACU,QAAA,YAAY,GAAG;IAC1B,kBAAkB;IAClB,KAAK,EAAE,cAAc;IACrB,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,qBAAqB;IACnC,KAAK,EAAE,cAAc;IACrB,KAAK,EAAE,cAAc;IACrB,qBAAqB,EAAE,8BAA8B;IACrD,aAAa,EAAE,sBAAsB;IACrC,4BAA4B,EAAE,qCAAqC;IACnE,kBAAkB;IAClB,aAAa,EAAE,sBAAsB;IACrC,aAAa,EAAE,sBAAsB;IACrC,YAAY,EAAE,qBAAqB;IACnC,aAAa,EAAE,sBAAsB;IACrC,oBAAoB,EAAE,6BAA6B;IACnD,gBAAgB,EAAE,yBAAyB;CACnC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oobit/react-native-sdk",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "React Native SDK for integrating Oobit crypto payments into wallet apps",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -39,23 +39,25 @@
     "url": "git+https://github.com/oobit-tech/react-native-SDK.git"
   },
   "peerDependencies": {
+    "expo-intent-launcher": ">=6.0.0",
     "expo-linking": ">=6.0.0",
+    "expo-local-authentication": ">=14.0.0",
     "react": ">=18.0.0",
     "react-native": ">=0.70.0",
     "react-native-webview": ">=13.0.0"
   },
-  "peerDependenciesMeta": {
-    "expo-intent-launcher": {
-      "optional": true
-    }
+  "dependencies": {
+    "node-forge": "^1.3.1"
   },
   "devDependencies": {
+    "@types/node-forge": "^1.3.11",
     "@types/react": "~19.1.0",
     "@typescript-eslint/eslint-plugin": "^8.47.0",
     "@typescript-eslint/parser": "^8.47.0",
     "eslint": "^9.39.1",
     "expo-intent-launcher": "~13.0.7",
     "expo-linking": "~8.0.8",
+    "expo-local-authentication": "~15.0.2",
     "react": "19.1.0",
     "react-native": "0.81.5",
     "react-native-webview": "13.15.0",

package/src/WidgetSDK.tsx

@@ -11,10 +11,24 @@ import React, {
   useRef,
   useState,
 } from "react";
-import { ActivityIndicator, BackHandler, Linking, Platform, StyleSheet, View } from "react-native";
+import {
+  ActivityIndicator,
+  BackHandler,
+  Linking,
+  Platform,
+  StyleSheet,
+  View,
+} from "react-native";
 import { WebView, WebViewMessageEvent } from "react-native-webview";
+import { authenticateWithBiometrics } from "./biometricUtils";
 import { getWidgetUrl } from "./config";
-import { WidgetMessage, WidgetSDKConfig } from "./types";
+import { generateSessionCredentials } from "./cryptoUtils";
+import {
+  NativeBiometricFailedMessage,
+  NativeCardDetailsSessionMessage,
+  WidgetMessage,
+  WidgetSDKConfig,
+} from "./types";
 import { isWalletAvailable, openNativeWallet } from "./walletUtils";
 
 export interface WidgetSDKRef {
@@ -117,6 +131,10 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
             onError?.("TOKEN_EXPIRED", "Access token has expired");
             break;
 
+          case "widget:request-card-details-session":
+            handleCardDetailsRequest(message);
+            break;
+
           default:
             console.warn("[WidgetSDK] Unknown message type:", message);
         }
@@ -178,7 +196,8 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
     const handleTransactionRequested = (message: WidgetMessage) => {
       if (message.type !== "widget:transaction-requested") return;
 
-      const { token, cryptoAmount, depositAddress, depositAddressTag } = message.payload;
+      const { token, cryptoAmount, depositAddress, depositAddressTag } =
+        message.payload;
       console.log("[WidgetSDK] Transaction requested:", {
         token,
         cryptoAmount,
@@ -186,7 +205,89 @@ export const WidgetSDK = forwardRef<WidgetSDKRef, WidgetSDKConfig>(
         depositAddressTag,
       });
 
-      onTransactionRequested?.(token, cryptoAmount, depositAddress, depositAddressTag);
+      onTransactionRequested?.(
+        token,
+        cryptoAmount,
+        depositAddress,
+        depositAddressTag
+      );
+    };
+
+    /**
+     * 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
+     */
+    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..."
+      );
+
+      // 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);
+      } catch (error) {
+        console.error(
+          "[WidgetSDK] Failed to generate session credentials:",
+          error
+        );
+
+        const failedMessage: NativeBiometricFailedMessage = {
+          type: "native:biometric-failed",
+          payload: {
+            reason: "failed",
+            message: "Failed to generate secure session",
+          },
+        };
+
+        sendMessageToWidget(failedMessage);
+      }
     };
 
     /**
@@ -286,8 +387,8 @@ const styles = StyleSheet.create({
   },
   loadingOverlay: {
     ...StyleSheet.absoluteFillObject,
-    backgroundColor: 'rgba(255, 255, 255, 0.9)',
-    justifyContent: 'center',
-    alignItems: 'center',
+    backgroundColor: "rgba(255, 255, 255, 0.9)",
+    justifyContent: "center",
+    alignItems: "center",
   },
 });

package/src/biometricUtils.ts

@@ -0,0 +1,183 @@
+/**
+ * Biometric Authentication Utilities
+ *
+ * Provides cross-platform biometric authentication for card details access.
+ * Uses expo-local-authentication which works in Expo Go without native modules.
+ *
+ * @requires expo-local-authentication - included in Expo SDK
+ */
+
+import * as LocalAuthentication from 'expo-local-authentication';
+
+/**
+ * Result of a biometric authentication attempt
+ */
+export interface BiometricResult {
+  /** Whether authentication was successful */
+  success: boolean;
+  /** Error details if authentication failed */
+  error?: {
+    reason: 'cancelled' | 'failed' | 'not_available' | 'not_enrolled';
+    message?: string;
+  };
+}
+
+/**
+ * Information about biometric capabilities on the device
+ */
+export interface BiometricAvailability {
+  /** Whether any biometric authentication is available */
+  available: boolean;
+  /** The types of biometry available */
+  biometryTypes: LocalAuthentication.AuthenticationType[];
+}
+
+/**
+ * Checks if biometric authentication is available on the device
+ *
+ * @returns Object containing availability status and biometry types
+ */
+export async function isBiometricAvailable(): Promise<BiometricAvailability> {
+  try {
+    const hasHardware = await LocalAuthentication.hasHardwareAsync();
+    const isEnrolled = await LocalAuthentication.isEnrolledAsync();
+    const supportedTypes = await LocalAuthentication.supportedAuthenticationTypesAsync();
+
+    return {
+      available: hasHardware && isEnrolled,
+      biometryTypes: supportedTypes,
+    };
+  } catch (error) {
+    console.error('[BiometricUtils] Error checking biometric availability:', error);
+    return {
+      available: false,
+      biometryTypes: [],
+    };
+  }
+}
+
+/**
+ * Prompts the user for biometric authentication
+ *
+ * This function should be called before generating session credentials
+ * for viewing card details. It ensures proper user verification before
+ * accessing sensitive payment card information.
+ *
+ * @param promptMessage - Message to display in the biometric prompt
+ * @returns Result indicating success or failure with reason
+ *
+ * @example
+ * ```typescript
+ * const result = await authenticateWithBiometrics('Authenticate to view card details');
+ * if (result.success) {
+ *   // Proceed with generating session credentials
+ * } else {
+ *   // Handle failure based on result.error.reason
+ * }
+ * ```
+ */
+export async function authenticateWithBiometrics(
+  promptMessage: string = 'Authenticate to view card details'
+): Promise<BiometricResult> {
+  try {
+    // First check if biometrics are available
+    const hasHardware = await LocalAuthentication.hasHardwareAsync();
+
+    if (!hasHardware) {
+      console.log('[BiometricUtils] Biometrics not available on device');
+      return {
+        success: false,
+        error: {
+          reason: 'not_available',
+          message: 'Biometric authentication is not available on this device',
+        },
+      };
+    }
+
+    // Check if biometrics are enrolled
+    const isEnrolled = await LocalAuthentication.isEnrolledAsync();
+
+    if (!isEnrolled) {
+      console.log('[BiometricUtils] No biometrics enrolled');
+      return {
+        success: false,
+        error: {
+          reason: 'not_enrolled',
+          message: 'No biometric authentication is set up on this device',
+        },
+      };
+    }
+
+    console.log('[BiometricUtils] Attempting biometric authentication...');
+
+    // Perform the biometric authentication
+    const result = await LocalAuthentication.authenticateAsync({
+      promptMessage,
+      cancelLabel: 'Cancel',
+      disableDeviceFallback: false, // Allow PIN/password fallback
+      fallbackLabel: 'Use Passcode',
+    });
+
+    if (result.success) {
+      console.log('[BiometricUtils] Biometric authentication successful');
+      return { success: true };
+    }
+
+    // Handle various failure reasons
+    console.log('[BiometricUtils] Biometric authentication failed:', result.error);
+
+    let reason: 'cancelled' | 'failed' | 'not_available' | 'not_enrolled' = 'failed';
+
+    if (result.error === 'user_cancel' || result.error === 'system_cancel') {
+      reason = 'cancelled';
+    } else if (result.error === 'not_enrolled') {
+      reason = 'not_enrolled';
+    } else if (result.error === 'not_available') {
+      reason = 'not_available';
+    }
+
+    return {
+      success: false,
+      error: {
+        reason,
+        message: result.warning || 'Authentication failed',
+      },
+    };
+  } catch (error) {
+    console.error('[BiometricUtils] Biometric authentication error:', error);
+
+    const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+
+    return {
+      success: false,
+      error: {
+        reason: 'failed',
+        message: errorMessage,
+      },
+    };
+  }
+}
+
+/**
+ * Gets a user-friendly description of the biometric type
+ *
+ * @param biometryType - The biometry type from the device
+ * @returns Human-readable string for the biometry type
+ */
+export function getBiometryTypeLabel(
+  biometryType: LocalAuthentication.AuthenticationType
+): string {
+  switch (biometryType) {
+    case LocalAuthentication.AuthenticationType.FACIAL_RECOGNITION:
+      return 'Face ID';
+    case LocalAuthentication.AuthenticationType.FINGERPRINT:
+      return 'Touch ID';
+    case LocalAuthentication.AuthenticationType.IRIS:
+      return 'Iris';
+    default:
+      return 'Biometric Authentication';
+  }
+}
+
+// Re-export AuthenticationType for convenience
+export { AuthenticationType } from 'expo-local-authentication';