framepayments-react-native 1.0.1 → 2.0.1

package/src/native.ts

@@ -3,7 +3,14 @@
  */
 
 import { NativeModules } from 'react-native';
-import type { ChargeIntent, FrameCartItem } from './types';
+import type {
+  ChargeIntent,
+  FrameCartItem,
+  OnboardingCapability,
+  OnboardingResult,
+  PresentApplePayOptions,
+  PresentGooglePayOptions,
+} from './types';
 import { ErrorCodes } from './errors';
 
 const LINKING_ERROR =
@@ -22,12 +29,23 @@ const FrameSDK = NativeModules.FrameSDK
 
 let isInitialized = false;
 
-export function initialize(options: { apiKey: string; debugMode?: boolean }): Promise<void> {
-  if (!options?.apiKey) {
-    throw new Error('Frame.initialize requires apiKey');
+export function initialize(options: {
+  secretKey: string;
+  publishableKey: string;
+  debugMode?: boolean;
+}): Promise<void> {
+  if (!options?.secretKey) {
+    throw new Error('Frame.initialize requires secretKey');
+  }
+  if (!options?.publishableKey) {
+    throw new Error('Frame.initialize requires publishableKey');
   }
   return wrapPromise(
-    FrameSDK.initialize(options.apiKey, options.debugMode ?? false)
+    FrameSDK.initialize(
+      options.secretKey,
+      options.publishableKey,
+      options.debugMode ?? false
+    )
   ).then(() => {
     isInitialized = true;
   });
@@ -36,7 +54,7 @@ export function initialize(options: { apiKey: string; debugMode?: boolean }): Pr
 function guardInitialized(): void {
   if (!isInitialized) {
     const message =
-      'Frame SDK must be initialized before calling presentCheckout or presentCart. Call Frame.initialize({ apiKey }) first.';
+      'Frame SDK must be initialized before calling presentCheckout, presentCart, or presentOnboarding. Call Frame.initialize({ apiKey }) first.';
     const err = new Error(message) as Error & { code: string };
     err.code = ErrorCodes.NOT_INITIALIZED;
     throw err;
@@ -79,3 +97,50 @@ export function presentCart(options: {
     )
   );
 }
+
+export function presentOnboarding(options: {
+  accountId?: string | null;
+  capabilities?: OnboardingCapability[];
+}): Promise<OnboardingResult> {
+  guardInitialized();
+  return wrapPromise(
+    FrameSDK.presentOnboarding(
+      options.accountId ?? null,
+      options.capabilities ?? []
+    )
+  );
+}
+
+export function presentApplePay(options: PresentApplePayOptions): Promise<ChargeIntent> {
+  guardInitialized();
+  if (!options?.owner || (options.owner.type !== 'customer' && options.owner.type !== 'account')) {
+    throw new Error('Frame.presentApplePay requires owner: { type: "customer" | "account", id: string }');
+  }
+  if (!options.owner.id) {
+    throw new Error('Frame.presentApplePay requires owner.id');
+  }
+  if (!options.merchantId) {
+    throw new Error('Frame.presentApplePay requires merchantId');
+  }
+  return wrapPromise(
+    FrameSDK.presentApplePay(
+      options.owner.type,
+      options.owner.id,
+      options.amount,
+      options.currency ?? 'usd',
+      options.merchantId
+    )
+  );
+}
+
+export function presentGooglePay(options: PresentGooglePayOptions): Promise<ChargeIntent> {
+  guardInitialized();
+  return wrapPromise(
+    FrameSDK.presentGooglePay(
+      options.amountCents,
+      options.customerId ?? null,
+      options.currencyCode ?? 'USD',
+      options.googlePayMerchantId ?? null
+    )
+  );
+}

package/src/types.ts

@@ -11,23 +11,95 @@ export interface FrameCartItem {
   imageUrl: string;
 }
 
+export type ChargeIntentStatus =
+  | 'canceled'
+  | 'disputed'
+  | 'failed'
+  | 'incomplete'
+  | 'pending'
+  | 'refunded'
+  | 'reversed'
+  | 'succeeded';
+
+export type AuthorizationMode = 'automatic' | 'manual';
+
+export interface BillingAddress {
+  city?: string;
+  country?: string;
+  state?: string;
+  postalCode: string;
+  addressLine1?: string;
+  addressLine2?: string;
+}
+
+export interface PaymentCard {
+  brand: string;
+  expirationMonth: string;
+  expirationYear: string;
+  lastFourDigits: string;
+  issuer?: string;
+  currency?: string;
+  type?: string;
+}
+
+export interface BankAccount {
+  bankName?: string;
+  lastFour?: string;
+  accountType?: string;
+}
+
+export interface PaymentMethod {
+  id: string;
+  type: 'card' | 'ach';
+  status: string;
+  created: number;
+  updated: number;
+  livemode: boolean;
+  object: string;
+  customerId?: string;
+  card?: PaymentCard;
+  ach?: BankAccount;
+  billing?: BillingAddress;
+}
+
+export interface Customer {
+  id: string;
+  object: string;
+  created: number;
+  updated: number;
+  livemode: boolean;
+  name?: string;
+  email?: string;
+  phone?: string;
+}
+
+export interface Charge {
+  id: string;
+  object: string;
+  amount: number;
+  currency: string;
+  status: string;
+  created: number;
+  livemode: boolean;
+}
+
 /** Charge intent returned from presentCheckout / presentCart */
 export interface ChargeIntent {
   id: string;
   currency: string;
   amount: number;
-  status: string;
+  status: ChargeIntentStatus;
   created: number;
   updated: number;
   livemode: boolean;
   object: string;
   description?: string;
-  customer?: Record<string, unknown>;
-  payment_method?: Record<string, unknown>;
-  latest_charge?: Record<string, unknown>;
-  authorization_mode?: string;
-  failure_description?: string;
-  shipping?: Record<string, unknown>;
+  authorizationMode?: AuthorizationMode;
+  failureDescription?: string;
+  customer?: Customer;
+  paymentMethod?: PaymentMethod;
+  latestCharge?: Charge;
+  shipping?: BillingAddress;
 }
 
 /** Error shape when native module rejects (same as FrameErrorShape from errors.ts) */
@@ -36,3 +108,57 @@ export interface FrameError {
   message: string;
   nativeError?: string;
 }
+
+/** Capabilities that drive which onboarding steps are shown */
+export type OnboardingCapability =
+  | 'kyc'
+  | 'kyc_prefill'
+  | 'phone_verification'
+  | 'creator_shield'
+  | 'card_verification'
+  | 'card_send'
+  | 'card_receive'
+  | 'address_verification'
+  | 'bank_account_verification'
+  | 'bank_account_send'
+  | 'bank_account_receive'
+  | 'geo_compliance'
+  | 'age_verification';
+
+export type OnboardingResultStatus = 'completed' | 'cancelled';
+
+/** Result returned from presentOnboarding */
+export interface OnboardingResult {
+  status: OnboardingResultStatus;
+  /** Present when status === 'completed' and a payment method was created/verified */
+  paymentMethodId?: string;
+}
+
+/** Identifies who the Apple Pay payment method belongs to. */
+export type ApplePayOwner =
+  | { type: 'customer'; id: string }
+  | { type: 'account'; id: string };
+
+/** Options for Frame.presentApplePay. */
+export interface PresentApplePayOptions {
+  /** Payment amount in cents. */
+  amount: number;
+  /** ISO 4217 currency code. Defaults to 'usd'. */
+  currency?: string;
+  /** Customer or account that owns the resulting payment method. */
+  owner: ApplePayOwner;
+  /** Apple Pay merchant ID configured in your Apple Developer account. */
+  merchantId: string;
+}
+
+/** Options for Frame.presentGooglePay. */
+export interface PresentGooglePayOptions {
+  /** Payment amount in cents. */
+  amountCents: number;
+  /** Optional Frame customer ID to associate the resulting payment method with. */
+  customerId?: string | null;
+  /** ISO 4217 currency code. Defaults to 'USD'. */
+  currencyCode?: string;
+  /** Optional override for the Google Pay merchant ID. */
+  googlePayMerchantId?: string;
+}

package/android/build/.transforms/3db830673120be833016e77c88c53305/results.bin

@@ -1 +0,0 @@
-o/debug

package/android/build/.transforms/e32bd1e24a69eac3ebaf0c3a5e659207/results.bin

@@ -1 +0,0 @@
-i/

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/aapt/AndroidManifest.xml

@@ -1,18 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="com.framepayments.reactnativeframe" >
-
-    <uses-sdk android:minSdkVersion="26" />
-
-    <application>
-        <activity
-            android:name="com.framepayments.reactnativeframe.FrameCheckoutActivity"
-            android:exported="false"
-            android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
-        <activity
-            android:name="com.framepayments.reactnativeframe.FrameFlowActivity"
-            android:exported="false"
-            android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
-    </application>
-
-</manifest>

package/android/build/intermediates/incremental/mergeDebugShaders/merger.xml

@@ -1,2 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erictownsend/Documents/GitHub/frame-react-native/example/node_modules/framepayments-react-native/android/src/main/shaders"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/erictownsend/Documents/GitHub/frame-react-native/example/node_modules/framepayments-react-native/android/src/debug/shaders"/></dataSet></merger>

package/android/build/intermediates/local_only_symbol_list/debug/R-def.txt

@@ -1,2 +0,0 @@
-R_DEF: Internal format may change without notice
-local

package/android/build/intermediates/manifest_merge_blame_file/debug/manifest-merger-blame-debug-report.txt

@@ -1,27 +0,0 @@
-1<?xml version="1.0" encoding="utf-8"?>
-2<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-3    package="com.framepayments.reactnativeframe" >
-4
-5    <uses-sdk android:minSdkVersion="26" />
-6
-7    <application>
-7-->/Users/erictownsend/Documents/GitHub/frame-react-native/example/node_modules/framepayments-react-native/android/src/main/AndroidManifest.xml:3:3-12:17
-8        <activity
-8-->/Users/erictownsend/Documents/GitHub/frame-react-native/example/node_modules/framepayments-react-native/android/src/main/AndroidManifest.xml:4:5-7:34
-9            android:name="com.framepayments.reactnativeframe.FrameCheckoutActivity"
-9-->/Users/erictownsend/Documents/GitHub/frame-react-native/example/node_modules/framepayments-react-native/android/src/main/AndroidManifest.xml:5:7-78
-10            android:exported="false"
-10-->/Users/erictownsend/Documents/GitHub/frame-react-native/example/node_modules/framepayments-react-native/android/src/main/AndroidManifest.xml:7:7-31
-11            android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
-11-->/Users/erictownsend/Documents/GitHub/frame-react-native/example/node_modules/framepayments-react-native/android/src/main/AndroidManifest.xml:6:7-63
-12        <activity
-12-->/Users/erictownsend/Documents/GitHub/frame-react-native/example/node_modules/framepayments-react-native/android/src/main/AndroidManifest.xml:8:5-11:34
-13            android:name="com.framepayments.reactnativeframe.FrameFlowActivity"
-13-->/Users/erictownsend/Documents/GitHub/frame-react-native/example/node_modules/framepayments-react-native/android/src/main/AndroidManifest.xml:9:7-74
-14            android:exported="false"
-14-->/Users/erictownsend/Documents/GitHub/frame-react-native/example/node_modules/framepayments-react-native/android/src/main/AndroidManifest.xml:11:7-31
-15            android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
-15-->/Users/erictownsend/Documents/GitHub/frame-react-native/example/node_modules/framepayments-react-native/android/src/main/AndroidManifest.xml:10:7-63
-16    </application>
-17
-18</manifest>

package/android/build/intermediates/merged_manifest/debug/AndroidManifest.xml

@@ -1,18 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="com.framepayments.reactnativeframe" >
-
-    <uses-sdk android:minSdkVersion="26" />
-
-    <application>
-        <activity
-            android:name="com.framepayments.reactnativeframe.FrameCheckoutActivity"
-            android:exported="false"
-            android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
-        <activity
-            android:name="com.framepayments.reactnativeframe.FrameFlowActivity"
-            android:exported="false"
-            android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
-    </application>
-
-</manifest>

package/android/build/intermediates/symbol_list_with_package_name/debug/package-aware-r.txt

@@ -1 +0,0 @@
-com.framepayments.reactnativeframe