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

package/CLAUDE.md

@@ -1,148 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Development Commands
-
-### Building and Linting
-- `yarn typescript` - Type-check TypeScript files
-- `yarn lint` - Lint code with ESLint
-- `yarn lint --fix` - Fix linting issues automatically
-- `yarn test` - Run Jest unit tests
-- `yarn prepare` - Build the library (runs `bob build && husky`)
-
-### Development Setup
-- `yarn bootstrap` - Setup project by installing dependencies and CocoaPods
-- `yarn bootstrap-no-pods` - Setup without installing CocoaPods
-- `yarn pods` - Install CocoaPods for iOS (example app)
-- `yarn update-pods` - Update specific Stripe pod dependencies
-
-### Example App Development Workflow
-1. **Setup**: `yarn bootstrap`
-2. **Run Example App** (requires 2 terminals):
-   - Terminal 1: `yarn example start`
-   - Terminal 2: `yarn example ios` OR `yarn example android`
-
-The example app uses a pre-configured demo backend, so no server setup is required.
-
-### Example App Commands
-- `yarn example start` - Start Metro server
-- `yarn run-example-ios` - Run iOS example app on iPhone 16 simulator
-- `yarn run-example-android` - Run Android example app
-- `yarn run-example-ios:release` - Build and run iOS app in release mode
-- `yarn run-example-android:release` - Build and run Android app in release mode
-
-### Testing
-- `yarn test:e2e:ios` - Run all iOS E2E tests using Maestro
-- `yarn test:e2e:android` - Run all Android E2E tests using Maestro
-- `yarn test-ios ./path/to/test.yml` - Run single iOS E2E test
-- `yarn test-android ./path/to/test.yml` - Run single Android E2E test
-- `yarn test:unit:ios` - Run iOS native unit tests via Xcode
-- `yarn test:unit:android` - Run Android unit tests
-
-### Documentation
-- `yarn docs` - Generate API documentation using TypeDoc
-
-### Commit Convention
-Follow [conventional commits](https://www.conventionalcommits.org/en):
-- `fix:` - Bug fixes
-- `feat:` - New features
-- `refactor:` - Code refactoring
-- `docs:` - Documentation changes
-- `test:` - Test additions/updates
-- `chore:` - Tooling changes
-
-## Architecture Overview
-
-This is the official Stripe React Native SDK, providing payment processing capabilities for mobile apps.
-
-### Key Directories
-
-- **`src/`** - Main TypeScript source code
-  - `components/` - React Native components (CardField, PaymentSheet, etc.)
-  - `hooks/` - React hooks for payment functionality
-  - `types/` - TypeScript type definitions
-  - `specs/` - Native module specifications for code generation
-  - `functions.ts` - Core payment functions
-  - `index.tsx` - Main exports
-
-- **`ios/`** - Native iOS implementation in Swift/Objective-C
-  - Uses Stripe iOS SDK (~24.16.1)
-  - Supports both Old and New Architecture (Fabric)
-  - Test files in `ios/Tests/`
-
-- **`android/`** - Native Android implementation in Kotlin/Java
-  - Uses Stripe Android SDK
-  - Gradle build configuration
-
-- **`example/`** - Example React Native app demonstrating SDK usage
-  - Contains test server in `server/` directory
-  - Configured for both iOS and Android development
-
-- **`e2e-tests/`** - End-to-end tests using Maestro framework
-  - Platform-specific tests in `ios-only/` and `android-only/`
-  - Tests payment flows, UI components, and integrations
-
-### Code Generation
-
-The SDK uses React Native's TurboModules/Fabric for native communication:
-- Specs defined in `src/specs/` generate native interfaces
-- Both Old and New Architecture supported
-- Special patch for Old Architecture compatibility in `patches/old-arch-codegen-fix.patch`
-
-### Build System
-
-- **React Native Builder Bob** - Builds CommonJS, ES modules, and TypeScript declarations
-- **CocoaPods** - iOS dependency management
-- **Gradle** - Android build system
-- **Expo Plugin** - `src/plugin/withStripe.ts` for Expo integration
-
-### Key Components
-
-- **StripeProvider** - Context provider for SDK initialization
-- **PaymentSheet** - Pre-built payment UI
-- **CardField/CardForm** - Card input components
-- **PlatformPayButton** - Apple Pay/Google Pay integration
-- **CustomerSheet** - Customer payment method management
-- **AddressSheet** - Address collection component
-
-### Testing Strategy
-
-- **Jest** - Unit tests for TypeScript code
-- **Maestro** - E2E testing framework for mobile flows
-- **Native Tests** - iOS XCTest and Android instrumentation tests
-- Mock implementation provided in `jest/mock.js`
-
-### Platform-Specific Notes
-
-- **iOS**: Requires Xcode 14.1+, iOS 13+ deployment target
-- **Android**: Requires API 21+, compileSdkVersion 34, Kotlin 2.x
-- **React Native**: Compatible with 0.78+, TypeScript 5.7+
-- **Expo**: Supported via plugin configuration
-
-### Development File Locations
-
-- **iOS Native**: Open `example/ios/StripeSdkExample.xcworkspace` in Xcode
-  - Source files: `Pods > Development Pods > stripe-react-native`
-- **Android Native**: Open `example/android` in Android Studio
-  - Source files: `reactnativestripesdk` under `Android`
-- **TypeScript**: Edit files in `src/` and `example/`
-
-### GitHub Issue Management
-- `GH_HOST=github.com gh issue list --repo stripe/stripe-react-native --limit 20` - List recent issues
-- `GH_HOST=github.com gh issue view <issue_number> --repo stripe/stripe-react-native` - View specific issue
-- `GH_HOST=github.com gh issue view <issue_number> --repo stripe/stripe-react-native --comments` - View issue with comments
-- `GH_HOST=github.com gh issue list --repo stripe/stripe-react-native --state all --search "keyword" --limit 30` - Search ALL issues (open/closed) by keyword
-- `GH_HOST=github.com gh issue create --repo stripe/stripe-react-native` - Create new issue
-- `GH_HOST=github.com gh issue edit <issue_number> --repo stripe/stripe-react-native` - Edit issue
-- `GH_HOST=github.com gh pr create --repo stripe/stripe-react-native` - Create pull request
-- Always use `--state all` when searching to include closed/resolved issues
-- Always check GitHub issues for similar problems before investigating user reports
-- Use GitHub CLI to distinguish between SDK bugs vs integration issues
-
-### Filing PRs
-When using the GitHub `gh` command, ALWAYS set `GH_HOST=github.com`. For example: `GH_HOST=github.com gh pr create --title [...]`
-
-### Old Architecture Compatibility
-
-The SDK maintains compatibility with React Native's Old Architecture via `patches/old-arch-codegen-fix.patch`. This patch converts EventEmitter properties to callback functions for code generation compatibility with RN ≥ 0.74.

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -1,2 +0,0 @@
-#Thu Aug 28 20:58:28 EDT 2025
-gradle.version=8.11.1

package/android/.idea/AndroidProjectSystem.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AndroidProjectSystem">
-    <option name="providerId" value="com.android.tools.idea.GradleProjectSystem" />
-  </component>
-</project>

package/android/.idea/GitLink.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="uk.co.ben_gibson.git.link.SettingsState">
-    <option name="host" value="72037fcc-cb9c-4c22-960a-ffe73fd5e229" />
-  </component>
-</project>

package/android/.idea/appInsightsSettings.xml

@@ -1,23 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AppInsightsSettings">
-    <option name="tabSettings">
-      <map>
-        <entry key="Android Vitals">
-          <value>
-            <InsightsFilterSettings>
-              <option name="connection">
-                <ConnectionSetting>
-                  <option name="appId" value="com.sessions24.aurora" />
-                </ConnectionSetting>
-              </option>
-              <option name="signal" value="SIGNAL_UNSPECIFIED" />
-              <option name="timeIntervalDays" value="SEVEN_DAYS" />
-              <option name="visibilityType" value="ALL" />
-            </InsightsFilterSettings>
-          </value>
-        </entry>
-      </map>
-    </option>
-  </component>
-</project>

package/android/src/main/java/com/reactnativestripesdk/FakeOnrampSdkModule.kt

@@ -1,138 +0,0 @@
-package com.reactnativestripesdk
-
-import com.facebook.react.bridge.Promise
-import com.facebook.react.bridge.ReactApplicationContext
-import com.facebook.react.bridge.ReactMethod
-import com.facebook.react.bridge.ReadableMap
-import com.facebook.react.module.annotations.ReactModule
-import com.reactnativestripesdk.utils.createFailedError
-
-@ReactModule(name = NativeOnrampSdkModuleSpec.NAME)
-class FakeOnrampSdkModule(
-  reactContext: ReactApplicationContext,
-) : NativeOnrampSdkModuleSpec(reactContext) {
-  @ReactMethod
-  override fun initialise(
-    params: ReadableMap?,
-    promise: Promise?,
-  ) {
-    promise?.resolve(null)
-  }
-
-  @ReactMethod
-  override fun configureOnramp(
-    config: ReadableMap?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun hasLinkAccount(
-    email: String?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun registerLinkUser(
-    info: ReadableMap?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun registerWalletAddress(
-    walletAddress: String?,
-    network: String?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun attachKycInfo(
-    kycInfo: ReadableMap?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun updatePhoneNumber(
-    phone: String?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun authenticateUser(promise: Promise?) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun verifyIdentity(promise: Promise?) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun collectPaymentMethod(
-    paymentMethod: String?,
-    platformPayParams: ReadableMap?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun provideCheckoutClientSecret(clientSecret: String?) {
-    // No-op
-  }
-
-  @ReactMethod
-  override fun createCryptoPaymentToken(promise: Promise?) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun performCheckout(
-    onrampSessionId: String?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun onrampAuthorize(
-    linkAuthIntentId: String?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun logout(promise: Promise?) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun getCryptoTokenDisplayData(
-    token: ReadableMap,
-    promise: Promise,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  private fun Promise.resolveNotImplemented() {
-    this.resolve(
-      createFailedError(
-        NotImplementedError(
-          "To enable Onramp, add 'StripeSdk_includeOnramp=true' to gradle.properties.",
-        ),
-      ),
-    )
-  }
-}

package/android/src/oldarch/java/com/reactnativestripesdk/NativeOnrampSdkModuleSpec.java

@@ -1,110 +0,0 @@
-
-/**
- * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
- *
- * Do not edit this file as changes may cause incorrect behavior and will be lost
- * once the code is regenerated.
- *
- * @generated by codegen project: GenerateModuleJavaSpec.js
- *
- * @nolint
- */
-
-package com.reactnativestripesdk;
-
-import com.facebook.proguard.annotations.DoNotStrip;
-import com.facebook.react.bridge.Promise;
-import com.facebook.react.bridge.ReactApplicationContext;
-import com.facebook.react.bridge.ReactContextBaseJavaModule;
-import com.facebook.react.bridge.ReactMethod;
-import com.facebook.react.bridge.ReadableMap;
-import com.facebook.react.modules.core.DeviceEventManagerModule;
-import com.facebook.react.turbomodule.core.interfaces.TurboModule;
-import javax.annotation.Nonnull;
-
-public abstract class NativeOnrampSdkModuleSpec extends ReactContextBaseJavaModule implements TurboModule {
-  public static final String NAME = "OnrampSdk";
-
-  public NativeOnrampSdkModuleSpec(ReactApplicationContext reactContext) {
-    super(reactContext);
-  }
-
-  @Override
-  public @Nonnull String getName() {
-    return NAME;
-  }
-
-  private void invoke(String eventName, Object params) {
-    getReactApplicationContext()
-      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
-      .emit(eventName, params);
-  }
-
-  protected final void emitOnCheckoutClientSecretRequested(ReadableMap value) {
-    invoke("onCheckoutClientSecretRequested", value);
-  }
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void initialise(ReadableMap params, Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void configureOnramp(ReadableMap config, Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void hasLinkAccount(String email, Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void registerLinkUser(ReadableMap info, Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void registerWalletAddress(String walletAddress, String network, Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void attachKycInfo(ReadableMap kycInfo, Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void updatePhoneNumber(String phone, Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void authenticateUser(Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void verifyIdentity(Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void collectPaymentMethod(String paymentMethod, ReadableMap platformPayParams, Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void provideCheckoutClientSecret(String clientSecret);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void createCryptoPaymentToken(Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void performCheckout(String onrampSessionId, Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void onrampAuthorize(String linkAuthIntentId, Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void getCryptoTokenDisplayData(ReadableMap token, Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void logout(Promise promise);
-}