@stripe/stripe-react-native 0.52.0-crypto-onramp-2-private-beta.2 → 0.53.0

package/patches/README.md

@@ -1,55 +0,0 @@
-# Old Architecture Codegen Fix
-
-This patch fixes the codegen issue that occurs when using `@stripe/stripe-react-native` with React Native 0.74+ in the old architecture.
-
-## The Problem
-
-When using React Native 0.74+ with the old architecture, you may encounter this error during pod install:
-
-```
-UnsupportedModulePropertyParserError: Module NativeStripeSdkModule: TypeScript interfaces extending TurboModule must only contain 'FunctionTypeAnnotation's. Property 'onConfirmHandlerCallback' refers to a 'TSTypeReference'.
-```
-
-This occurs because the React Native codegen in the old architecture doesn't support `EventEmitter` properties in TurboModule interfaces.
-
-## The Solution
-
-This patch converts all `EventEmitter` properties to callback function methods, making them compatible with the old architecture codegen.
-
-## How to Apply
-
-### Option 1: Manual patch command
-
-```bash
-cd node_modules/@stripe/stripe-react-native
-patch -p0 < patches/old-arch-codegen-fix.patch
-```
-
-### Option 2: Using patch-package (Recommended)
-
-1. Install patch-package as a dev dependency:
-   ```bash
-   npm install --save-dev patch-package
-   ```
-
-2. Apply the patch manually first:
-   ```bash
-   cd node_modules/@stripe/stripe-react-native
-   patch -p0 < ../../patches/old-arch-codegen-fix.patch
-   ```
-
-3. Generate a patch-package patch:
-   ```bash
-   npx patch-package @stripe/stripe-react-native
-   ```
-
-4. Add postinstall script to your `package.json`:
-   ```json
-   {
-     "scripts": {
-       "postinstall": "patch-package"
-     }
-   }
-   ```
-
-This ensures the patch is automatically applied whenever you run `npm install`.

package/patches/old-arch-codegen-fix.patch

@@ -1,91 +0,0 @@
---- src/specs/NativeStripeSdkModule.ts.orig	2025-07-09 10:31:12.373374861 -0600
-+++ src/specs/NativeStripeSdkModule.ts	2025-07-09 10:31:34.254519742 -0600
-@@ -1,7 +1,6 @@
- import { TurboModuleRegistry } from 'react-native';
- import type { TurboModule } from 'react-native/Libraries/TurboModule/RCTExport';
- import type {
--  EventEmitter,
-   Int32,
- } from 'react-native/Libraries/Types/CodegenTypes';
- import type {
-@@ -185,35 +184,47 @@
-   ): Promise<void>;
-   clearEmbeddedPaymentOption(viewTag: Int32): Promise<void>;
-
--  // Events
--  onConfirmHandlerCallback: EventEmitter<{
--    paymentMethod: UnsafeObject<PaymentMethod.Result>;
--    shouldSavePaymentMethod: boolean;
--  }>;
--  onFinancialConnectionsEvent: EventEmitter<
--    UnsafeObject<FinancialConnectionsEvent>
--  >;
--  onOrderTrackingCallback: EventEmitter<void>;
--  onCustomerAdapterFetchPaymentMethodsCallback: EventEmitter<void>;
--  onCustomerAdapterAttachPaymentMethodCallback: EventEmitter<{
--    paymentMethodId: string;
--  }>;
--  onCustomerAdapterDetachPaymentMethodCallback: EventEmitter<{
--    paymentMethodId: string;
--  }>;
--  onCustomerAdapterSetSelectedPaymentOptionCallback: EventEmitter<{
--    paymentOption: string;
--  }>;
--  onCustomerAdapterFetchSelectedPaymentOptionCallback: EventEmitter<void>;
--  onCustomerAdapterSetupIntentClientSecretForCustomerAttachCallback: EventEmitter<void>;
--  embeddedPaymentElementDidUpdateHeight: EventEmitter<UnsafeObject<any>>;
--  embeddedPaymentElementWillPresent: EventEmitter<void>;
--  embeddedPaymentElementDidUpdatePaymentOption: EventEmitter<UnsafeObject<any>>;
--  embeddedPaymentElementFormSheetConfirmComplete: EventEmitter<
--    UnsafeObject<any>
--  >;
--  embeddedPaymentElementRowSelectionImmediateAction: EventEmitter<void>;
--  embeddedPaymentElementLoadingFailed: EventEmitter<UnsafeObject<any>>;
--  onCustomPaymentMethodConfirmHandlerCallback: EventEmitter<UnsafeObject<any>>;
-+  // Events (callback form for old architecture)
-+  onConfirmHandlerCallback(
-+    callback: (event: {
-+      paymentMethod: UnsafeObject<PaymentMethod.Result>;
-+      shouldSavePaymentMethod: boolean;
-+    }) => void
-+  ): void;
-+  onFinancialConnectionsEvent(
-+    callback: (event: UnsafeObject<FinancialConnectionsEvent>) => void
-+  ): void;
-+  onOrderTrackingCallback(callback: () => void): void;
-+  onCustomerAdapterFetchPaymentMethodsCallback(callback: () => void): void;
-+  onCustomerAdapterAttachPaymentMethodCallback(
-+    callback: (event: { paymentMethodId: string }) => void
-+  ): void;
-+  onCustomerAdapterDetachPaymentMethodCallback(
-+    callback: (event: { paymentMethodId: string }) => void
-+  ): void;
-+  onCustomerAdapterSetSelectedPaymentOptionCallback(
-+    callback: (event: { paymentOption: string }) => void
-+  ): void;
-+  onCustomerAdapterFetchSelectedPaymentOptionCallback(
-+    callback: () => void
-+  ): void;
-+  onCustomerAdapterSetupIntentClientSecretForCustomerAttachCallback(
-+    callback: () => void
-+  ): void;
-+  embeddedPaymentElementDidUpdateHeight(
-+    callback: (event: UnsafeObject<any>) => void
-+  ): void;
-+  embeddedPaymentElementWillPresent(callback: () => void): void;
-+  embeddedPaymentElementDidUpdatePaymentOption(
-+    callback: (event: UnsafeObject<any>) => void
-+  ): void;
-+  embeddedPaymentElementFormSheetConfirmComplete(
-+    callback: (event: UnsafeObject<any>) => void
-+  ): void;
-+  embeddedPaymentElementRowSelectionImmediateAction(callback: () => void): void;
-+  embeddedPaymentElementLoadingFailed(
-+    callback: (event: UnsafeObject<any>) => void
-+  ): void;
-+  onCustomPaymentMethodConfirmHandlerCallback(
-+    callback: (event: UnsafeObject<any>) => void
-+  ): void;
- }
-
- export default TurboModuleRegistry.getEnforcing<Spec>('StripeSdk');

package/src/hooks/useOnramp.tsx

@@ -1,297 +0,0 @@
-import { EventSubscription } from 'react-native';
-import NativeOnrampSdk from '../specs/NativeOnrampSdkModule';
-import { Onramp, OnrampError, StripeError } from '../types';
-import type { PlatformPay } from '../types';
-import { useCallback } from 'react';
-import { addOnrampListener } from '../events';
-import { CryptoPaymentToken } from '../types/Onramp';
-
-let onCheckoutClientSecretRequestedSubscription: EventSubscription | null =
-  null;
-
-/**
- * useOnramp hook
- */
-export function useOnramp() {
-  const _configure = useCallback(
-    async (
-      config: Onramp.Configuration
-    ): Promise<{ error?: StripeError<OnrampError> }> => {
-      return NativeOnrampSdk.configureOnramp(config);
-    },
-    []
-  );
-
-  const _hasLinkAccount = useCallback(
-    async (email: string): Promise<Onramp.HasLinkAccountResult> => {
-      return NativeOnrampSdk.hasLinkAccount(email);
-    },
-    []
-  );
-
-  const _registerLinkUser = useCallback(
-    async (
-      info: Onramp.LinkUserInfo
-    ): Promise<Onramp.RegisterLinkUserResult> => {
-      return NativeOnrampSdk.registerLinkUser(info);
-    },
-    []
-  );
-
-  const _registerWalletAddress = useCallback(
-    async (
-      walletAddress: string,
-      network: Onramp.CryptoNetwork
-    ): Promise<{ error?: StripeError<OnrampError> }> => {
-      return NativeOnrampSdk.registerWalletAddress(walletAddress, network);
-    },
-    []
-  );
-
-  const _attachKycInfo = useCallback(
-    async (
-      kycInfo: Onramp.KycInfo
-    ): Promise<{ error?: StripeError<OnrampError> }> => {
-      return NativeOnrampSdk.attachKycInfo(kycInfo);
-    },
-    []
-  );
-
-  const _updatePhoneNumber = useCallback(
-    async (phone: string): Promise<{ error?: StripeError<OnrampError> }> => {
-      return NativeOnrampSdk.updatePhoneNumber(phone);
-    },
-    []
-  );
-
-  const _authenticateUser =
-    useCallback(async (): Promise<Onramp.AuthenticateUserResult> => {
-      return NativeOnrampSdk.authenticateUser();
-    }, []);
-
-  const _verifyIdentity = useCallback(async (): Promise<{
-    error?: StripeError<OnrampError>;
-  }> => {
-    return NativeOnrampSdk.verifyIdentity();
-  }, []);
-
-  /**
-   * The set of payment methods supported by crypto onramp collection.
-   * - 'Card' and 'BankAccount' present Link for collection.
-   * - 'PlatformPay' presents Apple Pay / Google Pay using provided params.
-   */
-  type OnrampPaymentMethod = 'Card' | 'BankAccount' | 'PlatformPay';
-
-  // Overloads for stronger type-safety at call-sites
-  const _collectPaymentMethod: {
-    (
-      paymentMethod: 'Card' | 'BankAccount',
-      platformPayParams?: undefined
-    ): Promise<Onramp.CollectPaymentMethodResult>;
-    (
-      paymentMethod: 'PlatformPay',
-      platformPayParams: PlatformPay.PaymentMethodParams
-    ): Promise<Onramp.CollectPaymentMethodResult>;
-  } = useCallback(
-    async (
-      paymentMethod: OnrampPaymentMethod,
-      platformPayParams?:
-        | PlatformPay.PaymentMethodParams
-        | Record<string, never>
-    ): Promise<Onramp.CollectPaymentMethodResult> => {
-      return NativeOnrampSdk.collectPaymentMethod(
-        paymentMethod,
-        (platformPayParams ?? {}) as any
-      );
-    },
-    []
-  );
-
-  const _createCryptoPaymentToken =
-    useCallback(async (): Promise<Onramp.CreateCryptoPaymentTokenResult> => {
-      return NativeOnrampSdk.createCryptoPaymentToken();
-    }, []);
-
-  const _performCheckout = useCallback(
-    async (
-      onrampSessionId: string,
-      provideCheckoutClientSecret: () => Promise<string | null>
-    ): Promise<{ error?: StripeError<OnrampError> }> => {
-      onCheckoutClientSecretRequestedSubscription?.remove();
-      onCheckoutClientSecretRequestedSubscription = addOnrampListener(
-        'onCheckoutClientSecretRequested',
-        async () => {
-          try {
-            const clientSecret = await provideCheckoutClientSecret();
-            NativeOnrampSdk.provideCheckoutClientSecret(clientSecret);
-          } catch (error: any) {
-            NativeOnrampSdk.provideCheckoutClientSecret(null);
-          }
-        }
-      );
-      return NativeOnrampSdk.performCheckout(onrampSessionId);
-    },
-    []
-  );
-
-  const _authorize = useCallback(
-    async (linkAuthIntentId: string): Promise<Onramp.AuthorizeResult> => {
-      return NativeOnrampSdk.onrampAuthorize(linkAuthIntentId);
-    },
-    []
-  );
-
-  const _getCryptoTokenDisplayData = useCallback(
-    async (
-      token: CryptoPaymentToken
-    ): Promise<Onramp.PaymentDisplayDataResult> => {
-      return NativeOnrampSdk.getCryptoTokenDisplayData(token);
-    },
-    []
-  );
-
-  const _logOut = useCallback(async (): Promise<{
-    error?: StripeError<OnrampError>;
-  }> => {
-    return NativeOnrampSdk.logout();
-  }, []);
-
-  const _isAuthError = (error: any): boolean => {
-    const stripeErrorCode = error?.stripeErrorCode;
-    const authErrorCodes = [
-      'consumer_session_credentials_invalid',
-      'consumer_session_expired',
-    ];
-    return authErrorCodes.includes(stripeErrorCode);
-  };
-
-  return {
-    /**
-     * Creates a `CryptoOnrampCoordinator` to facilitate authentication, identity verification, payment collection, and checkouts.
-     *
-     * @param config Configuration object containing merchant display name and appearance settings
-     * @returns Promise that resolves to an object with an optional error property
-     */
-    configure: _configure,
-
-    /**
-     * Whether or not the provided email is associated with an existing Link consumer.
-     *
-     * @param email The email address to look up
-     * @returns Promise that resolves to an object with hasLinkAccount boolean or error
-     */
-    hasLinkAccount: _hasLinkAccount,
-
-    /**
-     * Registers a new Link user with the provided details.
-     *
-     * @param info User information including email, phone, country, and optional full name
-     * @returns Promise that resolves to an object with customerId or error
-     */
-    registerLinkUser: _registerLinkUser,
-
-    /**
-     * Registers the given crypto wallet address to the current Link account.
-     * Requires an authenticated Link user.
-     *
-     * @param walletAddress The crypto wallet address to register
-     * @param network The crypto network for the wallet address
-     * @returns Promise that resolves to an object with an optional error property
-     */
-    registerWalletAddress: _registerWalletAddress,
-
-    /**
-     * Attaches the specific KYC info to the current Link user. Requires an authenticated Link user.
-     *
-     * @param kycInfo The KYC info to attach to the Link user
-     * @returns Promise that resolves to an object with an optional error property
-     */
-    attachKycInfo: _attachKycInfo,
-
-    /**
-     * Updates the user's phone number in their Link account.
-     *
-     * @param phone The new phone number to set for the user in E.164 format (e.g., +12125551234)
-     * @returns Promise that resolves to an object with an optional error property
-     */
-    updatePhoneNumber: _updatePhoneNumber,
-
-    /**
-     * Presents Link UI to authenticate an existing Link user.
-     * `hasLinkAccount` must be called before this.
-     *
-     * @returns Promise that resolves to an object with customerId or error
-     */
-    authenticateUser: _authenticateUser,
-
-    /**
-     * Creates an identity verification session and launches the document verification flow.
-     * Requires an authenticated Link user.
-     *
-     * @returns Promise that resolves to an object with an optional error property
-     */
-    verifyIdentity: _verifyIdentity,
-
-    /**
-     * Presents UI to collect/select a payment method of the given type.
-     *
-     * @param paymentMethod The payment method type to collect.
-     *  - 'Card' and 'BankAccount' present Link for collection.
-     *  - 'PlatformPay' presents Apple Pay / Google Pay using the provided parameters.
-     * @param platformPayParams Platform-specific parameters (required when `paymentMethod` is 'PlatformPay').
-     *  - iOS: provide `applePay` params
-     *  - Android: provide `googlePay` params
-     * @returns Promise that resolves to an object with displayData or error
-     */
-    collectPaymentMethod: _collectPaymentMethod,
-
-    /**
-     * Creates a crypto payment token for the payment method currently selected on the coordinator.
-     * Call after a successful `collectPaymentMethod(...)`.
-     *
-     * @returns Promise that resolves to an object with cryptoPaymentToken or error
-     */
-    createCryptoPaymentToken: _createCryptoPaymentToken,
-
-    /**
-     * Performs the checkout flow for a crypto onramp session, handling any required authentication steps.
-     *
-     * @param onrampSessionId The onramp session identifier
-     * @returns Promise that resolves to an object with an optional error property
-     */
-    performCheckout: _performCheckout,
-
-    /**
-     * Authorizes a Link auth intent and authenticates the user if necessary.
-     *
-     * @param linkAuthIntentId The Link auth intent ID to authorize
-     * @returns Promise that resolves to an object with status and customerId or error
-     */
-    authorize: _authorize,
-
-    /**
-     * Retrieves display data (icon, label, sublabel) for the given payment method details.
-     * Suitable for rendering in the UI to summarize the selected payment method.
-     *
-     * @param token The token containing payment method details (card or bank account) to get display data for
-     * @returns Promise that resolves to an object with displayData or error
-     */
-    getCryptoTokenDisplayData: _getCryptoTokenDisplayData,
-
-    /**
-     * Logs out the current user from their Link account.
-     *
-     * @returns Promise that resolves to an object with an optional error property
-     */
-    logOut: _logOut,
-
-    /**
-     * Determines whether an error is an authentication-related error that requires re-authentication.
-     * Useful for implementing automatic re-authentication flows when sessions expire or become invalid.
-     *
-     * @param error The error object to check, typically from onramp method calls
-     * @returns True if the error indicates an authentication issue, false otherwise
-     */
-    isAuthError: _isAuthError,
-  };
-}

package/src/specs/NativeOnrampSdkModule.ts

@@ -1,41 +0,0 @@
-import { TurboModuleRegistry } from 'react-native';
-import type { TurboModule } from 'react-native/Libraries/TurboModule/RCTExport';
-import type { EventEmitter } from 'react-native/Libraries/Types/CodegenTypes';
-import type { InitialiseParams, Onramp } from '../types';
-import type { UnsafeObject } from './utils';
-
-export interface Spec extends TurboModule {
-  initialise(params: UnsafeObject<InitialiseParams>): Promise<void>;
-  configureOnramp(
-    config: UnsafeObject<Onramp.Configuration>
-  ): Promise<Onramp.VoidResult>;
-  hasLinkAccount(email: string): Promise<Onramp.HasLinkAccountResult>;
-  registerLinkUser(
-    info: UnsafeObject<Onramp.LinkUserInfo>
-  ): Promise<Onramp.RegisterLinkUserResult>;
-  registerWalletAddress(
-    walletAddress: string,
-    network: string
-  ): Promise<Onramp.VoidResult>;
-  attachKycInfo(
-    kycInfo: UnsafeObject<Onramp.KycInfo>
-  ): Promise<Onramp.VoidResult>;
-  updatePhoneNumber(phone: string): Promise<Onramp.VoidResult>;
-  authenticateUser(): Promise<Onramp.AuthenticateUserResult>;
-  verifyIdentity(): Promise<Onramp.VoidResult>;
-  collectPaymentMethod(
-    paymentMethod: string,
-    platformPayParams: UnsafeObject<any>
-  ): Promise<Onramp.CollectPaymentMethodResult>;
-  provideCheckoutClientSecret(clientSecret: string | null): void;
-  onCheckoutClientSecretRequested: EventEmitter<UnsafeObject<any>>;
-  createCryptoPaymentToken(): Promise<Onramp.CreateCryptoPaymentTokenResult>;
-  performCheckout(onrampSessionId: string): Promise<Onramp.VoidResult>;
-  onrampAuthorize(linkAuthIntentId: string): Promise<Onramp.AuthorizeResult>;
-  getCryptoTokenDisplayData(
-    token: UnsafeObject<Onramp.CryptoPaymentToken>
-  ): Promise<Onramp.PaymentDisplayDataResult>;
-  logout(): Promise<Onramp.VoidResult>;
-}
-
-export default TurboModuleRegistry.getEnforcing<Spec>('OnrampSdk');