@unifold/connect-react-native 0.1.19 → 0.1.21

package/dist/stripe.d.mts

@@ -0,0 +1,230 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import { Onramp } from '@stripe/stripe-react-native';
+
+export declare function setStripeOnrampPublishableKey(key: string): void;
+export declare function setStripeOnrampApiUrl(url: string): void;
+export declare function getStripePublishableKey(): Promise<string>;
+export type OnrampSessionTransactionDetails = {
+	destination_amount: string;
+	destination_currency: string;
+	destination_network: string;
+	source_amount: string;
+	source_currency: string;
+	fees: {
+		network_fee_amount: string;
+		transaction_fee_amount: string;
+	};
+	quote_expiration: number;
+	wallet_address: string;
+	last_error: string | null;
+};
+export type OnrampSession = {
+	id: string;
+	client_secret: string;
+	status: string;
+	transaction_details: OnrampSessionTransactionDetails;
+};
+export type CreateSessionParams = {
+	cryptoCustomerId: string;
+	paymentToken: string;
+	sourceAmount: number;
+	sourceCurrency: string;
+	destinationCurrency: string;
+	walletAddress: string;
+	destinationNetwork: string;
+};
+export type CustomerVerification = {
+	name: "kyc_verified" | "phone_verified" | "id_document_verified" | string;
+	status: "verified" | "unverified" | string;
+	errors: string[];
+};
+export type OnrampCustomer = {
+	id: string;
+	provided_fields: string[];
+	verifications: CustomerVerification[];
+};
+export type KYCData = {
+	firstName: string;
+	lastName: string;
+	idNumber: string;
+	dobMonth: string;
+	dobDay: string;
+	dobYear: string;
+	addressLine1: string;
+	addressLine2: string;
+	city: string;
+	state: string;
+	postalCode: string;
+	country: string;
+};
+export type KYCWizardScreenProps = {
+	initialData?: Partial<KYCData>;
+	loading?: boolean;
+	onComplete: (data: KYCData) => void;
+	onCancel: () => void;
+};
+export declare function KYCWizardScreen({ initialData, loading, onComplete, onCancel, }: KYCWizardScreenProps): import("react/jsx-runtime").JSX.Element;
+export type OnrampStep = "email" | "register" | "kyc" | "identity" | "amount" | "wallet" | "payment_method" | "session_params" | "quote" | "processing" | "success";
+export type OnrampErrorCode = "configuration_error" | "authorization_error" | "registration_error" | "kyc_error" | "identity_error" | "wallet_error" | "payment_error" | "session_error" | "validation_error" | "unknown_error";
+export type OnrampError = {
+	code: OnrampErrorCode;
+	message: string;
+	step: OnrampStep;
+	stripeErrorCode?: string;
+};
+export type OnrampTransaction = {
+	sessionId: string;
+	status: string;
+	sourceAmount: string;
+	sourceCurrency: string;
+	destinationAmount: string;
+	destinationCurrency: string;
+	destinationNetwork: string;
+	walletAddress: string;
+	fees: {
+		networkFee: string;
+		transactionFee: string;
+	};
+};
+export type OnrampConfig = {
+	merchantDisplayName?: string;
+	defaultWalletAddress?: string;
+	defaultNetwork?: Onramp.CryptoNetwork;
+	defaultSourceAmount?: string;
+	defaultSourceCurrency?: string;
+	defaultDestinationCurrency?: string;
+	onComplete?: (transaction: OnrampTransaction) => void;
+	onError?: (error: OnrampError) => void;
+	onStepChange?: (step: OnrampStep, previousStep: OnrampStep) => void;
+	/** Pre-fill email — skips the email screen and goes to register (phone) */
+	email?: string;
+	/** Pre-fill phone — combined with email, skips both screens and auto-triggers Link check + register */
+	phone?: string;
+	/** Same fields as DepositConfig / beginDeposit() — used to auto-resolve wallet */
+	publishableKey?: string;
+	externalUserId?: string;
+	recipientAddress?: string;
+	destinationChainType?: "ethereum" | "solana" | "bitcoin";
+	destinationChainId?: string;
+	destinationTokenAddress?: string;
+	/** Flow order: "verify_first" (default) starts with email, "amount_first" starts with amount entry */
+	flowOrder?: "verify_first" | "amount_first";
+};
+export declare function useStripeOnramp(config?: OnrampConfig): {
+	step: OnrampStep;
+	loading: boolean;
+	status: string;
+	error: OnrampError | null;
+	email: string;
+	phone: string;
+	fullName: string;
+	country: string;
+	customerId: string;
+	accessToken: string;
+	session: OnrampSession | null;
+	kycData: KYCData;
+	walletAddress: string;
+	resolvedRecipientAddress: string;
+	walletNetwork: Onramp.CryptoNetwork;
+	sourceAmount: string;
+	sourceCurrency: string;
+	destinationCurrency: string;
+	applePaySupported: boolean;
+	walletReady: boolean;
+	walletLoading: boolean;
+	setStep: import("react").Dispatch<import("react").SetStateAction<OnrampStep>>;
+	setStatus: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setEmail: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setPhone: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setFullName: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setCountry: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setWalletAddress: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setWalletNetwork: import("react").Dispatch<import("react").SetStateAction<Onramp.CryptoNetwork>>;
+	setSourceAmount: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setSourceCurrency: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setDestinationCurrency: import("react").Dispatch<import("react").SetStateAction<string>>;
+	checkEmail: () => Promise<void>;
+	register: () => Promise<void>;
+	attachKyc: (data: KYCData) => Promise<void>;
+	verifyIdentity: () => Promise<void>;
+	registerWallet: () => Promise<void>;
+	collectPaymentMethod: (useApplePay?: boolean) => Promise<void>;
+	refreshQuote: () => Promise<void>;
+	confirmCheckout: () => Promise<void>;
+	reset: () => void;
+	clearError: () => void;
+	amountFirst: boolean;
+};
+export type StripeOnrampHook = ReturnType<typeof useStripeOnramp>;
+export declare function OnrampScreen({ config, onComplete }: {
+	config?: OnrampConfig;
+	onComplete?: () => void;
+}): import("react/jsx-runtime").JSX.Element | null;
+export type AmountScreenProps = {
+	initialAmount?: string;
+	currency?: string;
+	onConfirm: (amount: string) => void;
+	onCancel: () => void;
+};
+export declare function AmountScreen({ initialAmount, currency, onConfirm, onCancel, }: AmountScreenProps): import("react/jsx-runtime").JSX.Element;
+export interface StripeOnrampProps {
+	/** Unifold publishable key — pass from useUnifold().publishableKey */
+	publishableKey?: string;
+	/** User's email — pre-fills the email step */
+	email?: string;
+	/** User's phone — combined with email, skips both screens */
+	phone?: string;
+	/** Your app's user ID — used to auto-resolve the deposit wallet */
+	externalUserId: string;
+	/** Flow order: "verify_first" (default) or "amount_first" */
+	flowOrder?: "verify_first" | "amount_first";
+	/** Override destination chain type (default: "ethereum") */
+	destinationChainType?: "ethereum" | "solana" | "bitcoin";
+	/** Override destination chain ID (default: "8453" for Base) */
+	destinationChainId?: string;
+	/** Override destination token address */
+	destinationTokenAddress?: string;
+	/** Recipient wallet address — where purchased crypto is sent */
+	recipientAddress: string;
+	/** Called when the transaction completes successfully */
+	onComplete?: (transaction: OnrampTransaction) => void;
+	/** Called when an error occurs */
+	onError?: (error: OnrampError) => void;
+	/** Called when the flow step changes */
+	onStepChange?: (step: OnrampStep, previousStep: OnrampStep) => void;
+	/** Called when the user closes the flow (via ✕ or Done) */
+	onClose?: () => void;
+	/** Apple Pay merchant identifier (default: "merchant.io.unifold") */
+	merchantIdentifier?: string;
+	/** URL scheme for Stripe redirects (default: "unifoldOnramp") */
+	urlScheme?: string;
+}
+/**
+ * High-level Stripe Onramp component.
+ *
+ * Handles all the plumbing automatically:
+ * - Reads the Unifold publishable key from UnifoldProvider context
+ * - Fetches the Stripe publishable key from the Unifold API
+ * - Wraps in StripeProvider
+ * - Eagerly configures the Stripe Onramp SDK
+ * - Renders OnrampScreen with the config
+ *
+ * Usage:
+ * ```tsx
+ * <StripeOnramp
+ *   email={user.email}
+ *   externalUserId={user.id}
+ *   onClose={() => navigation.goBack()}
+ * />
+ * ```
+ */
+export declare function StripeOnramp({ publishableKey, email, phone, externalUserId, flowOrder, destinationChainType, destinationChainId, destinationTokenAddress, recipientAddress, onComplete, onError, onStepChange, onClose, merchantIdentifier, urlScheme, }: StripeOnrampProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Render inside StripeOnramp after initStripe() has completed.
+ * Eagerly calls configure() so the Onramp SDK is ready by the time
+ * useStripeOnramp needs it. Renders nothing.
+ */
+export declare function StripeOnrampPreconfigure(): null;
+
+export {};

package/dist/stripe.d.ts

@@ -0,0 +1,230 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import { Onramp } from '@stripe/stripe-react-native';
+
+export declare function setStripeOnrampPublishableKey(key: string): void;
+export declare function setStripeOnrampApiUrl(url: string): void;
+export declare function getStripePublishableKey(): Promise<string>;
+export type OnrampSessionTransactionDetails = {
+	destination_amount: string;
+	destination_currency: string;
+	destination_network: string;
+	source_amount: string;
+	source_currency: string;
+	fees: {
+		network_fee_amount: string;
+		transaction_fee_amount: string;
+	};
+	quote_expiration: number;
+	wallet_address: string;
+	last_error: string | null;
+};
+export type OnrampSession = {
+	id: string;
+	client_secret: string;
+	status: string;
+	transaction_details: OnrampSessionTransactionDetails;
+};
+export type CreateSessionParams = {
+	cryptoCustomerId: string;
+	paymentToken: string;
+	sourceAmount: number;
+	sourceCurrency: string;
+	destinationCurrency: string;
+	walletAddress: string;
+	destinationNetwork: string;
+};
+export type CustomerVerification = {
+	name: "kyc_verified" | "phone_verified" | "id_document_verified" | string;
+	status: "verified" | "unverified" | string;
+	errors: string[];
+};
+export type OnrampCustomer = {
+	id: string;
+	provided_fields: string[];
+	verifications: CustomerVerification[];
+};
+export type KYCData = {
+	firstName: string;
+	lastName: string;
+	idNumber: string;
+	dobMonth: string;
+	dobDay: string;
+	dobYear: string;
+	addressLine1: string;
+	addressLine2: string;
+	city: string;
+	state: string;
+	postalCode: string;
+	country: string;
+};
+export type KYCWizardScreenProps = {
+	initialData?: Partial<KYCData>;
+	loading?: boolean;
+	onComplete: (data: KYCData) => void;
+	onCancel: () => void;
+};
+export declare function KYCWizardScreen({ initialData, loading, onComplete, onCancel, }: KYCWizardScreenProps): import("react/jsx-runtime").JSX.Element;
+export type OnrampStep = "email" | "register" | "kyc" | "identity" | "amount" | "wallet" | "payment_method" | "session_params" | "quote" | "processing" | "success";
+export type OnrampErrorCode = "configuration_error" | "authorization_error" | "registration_error" | "kyc_error" | "identity_error" | "wallet_error" | "payment_error" | "session_error" | "validation_error" | "unknown_error";
+export type OnrampError = {
+	code: OnrampErrorCode;
+	message: string;
+	step: OnrampStep;
+	stripeErrorCode?: string;
+};
+export type OnrampTransaction = {
+	sessionId: string;
+	status: string;
+	sourceAmount: string;
+	sourceCurrency: string;
+	destinationAmount: string;
+	destinationCurrency: string;
+	destinationNetwork: string;
+	walletAddress: string;
+	fees: {
+		networkFee: string;
+		transactionFee: string;
+	};
+};
+export type OnrampConfig = {
+	merchantDisplayName?: string;
+	defaultWalletAddress?: string;
+	defaultNetwork?: Onramp.CryptoNetwork;
+	defaultSourceAmount?: string;
+	defaultSourceCurrency?: string;
+	defaultDestinationCurrency?: string;
+	onComplete?: (transaction: OnrampTransaction) => void;
+	onError?: (error: OnrampError) => void;
+	onStepChange?: (step: OnrampStep, previousStep: OnrampStep) => void;
+	/** Pre-fill email — skips the email screen and goes to register (phone) */
+	email?: string;
+	/** Pre-fill phone — combined with email, skips both screens and auto-triggers Link check + register */
+	phone?: string;
+	/** Same fields as DepositConfig / beginDeposit() — used to auto-resolve wallet */
+	publishableKey?: string;
+	externalUserId?: string;
+	recipientAddress?: string;
+	destinationChainType?: "ethereum" | "solana" | "bitcoin";
+	destinationChainId?: string;
+	destinationTokenAddress?: string;
+	/** Flow order: "verify_first" (default) starts with email, "amount_first" starts with amount entry */
+	flowOrder?: "verify_first" | "amount_first";
+};
+export declare function useStripeOnramp(config?: OnrampConfig): {
+	step: OnrampStep;
+	loading: boolean;
+	status: string;
+	error: OnrampError | null;
+	email: string;
+	phone: string;
+	fullName: string;
+	country: string;
+	customerId: string;
+	accessToken: string;
+	session: OnrampSession | null;
+	kycData: KYCData;
+	walletAddress: string;
+	resolvedRecipientAddress: string;
+	walletNetwork: Onramp.CryptoNetwork;
+	sourceAmount: string;
+	sourceCurrency: string;
+	destinationCurrency: string;
+	applePaySupported: boolean;
+	walletReady: boolean;
+	walletLoading: boolean;
+	setStep: import("react").Dispatch<import("react").SetStateAction<OnrampStep>>;
+	setStatus: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setEmail: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setPhone: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setFullName: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setCountry: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setWalletAddress: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setWalletNetwork: import("react").Dispatch<import("react").SetStateAction<Onramp.CryptoNetwork>>;
+	setSourceAmount: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setSourceCurrency: import("react").Dispatch<import("react").SetStateAction<string>>;
+	setDestinationCurrency: import("react").Dispatch<import("react").SetStateAction<string>>;
+	checkEmail: () => Promise<void>;
+	register: () => Promise<void>;
+	attachKyc: (data: KYCData) => Promise<void>;
+	verifyIdentity: () => Promise<void>;
+	registerWallet: () => Promise<void>;
+	collectPaymentMethod: (useApplePay?: boolean) => Promise<void>;
+	refreshQuote: () => Promise<void>;
+	confirmCheckout: () => Promise<void>;
+	reset: () => void;
+	clearError: () => void;
+	amountFirst: boolean;
+};
+export type StripeOnrampHook = ReturnType<typeof useStripeOnramp>;
+export declare function OnrampScreen({ config, onComplete }: {
+	config?: OnrampConfig;
+	onComplete?: () => void;
+}): import("react/jsx-runtime").JSX.Element | null;
+export type AmountScreenProps = {
+	initialAmount?: string;
+	currency?: string;
+	onConfirm: (amount: string) => void;
+	onCancel: () => void;
+};
+export declare function AmountScreen({ initialAmount, currency, onConfirm, onCancel, }: AmountScreenProps): import("react/jsx-runtime").JSX.Element;
+export interface StripeOnrampProps {
+	/** Unifold publishable key — pass from useUnifold().publishableKey */
+	publishableKey?: string;
+	/** User's email — pre-fills the email step */
+	email?: string;
+	/** User's phone — combined with email, skips both screens */
+	phone?: string;
+	/** Your app's user ID — used to auto-resolve the deposit wallet */
+	externalUserId: string;
+	/** Flow order: "verify_first" (default) or "amount_first" */
+	flowOrder?: "verify_first" | "amount_first";
+	/** Override destination chain type (default: "ethereum") */
+	destinationChainType?: "ethereum" | "solana" | "bitcoin";
+	/** Override destination chain ID (default: "8453" for Base) */
+	destinationChainId?: string;
+	/** Override destination token address */
+	destinationTokenAddress?: string;
+	/** Recipient wallet address — where purchased crypto is sent */
+	recipientAddress: string;
+	/** Called when the transaction completes successfully */
+	onComplete?: (transaction: OnrampTransaction) => void;
+	/** Called when an error occurs */
+	onError?: (error: OnrampError) => void;
+	/** Called when the flow step changes */
+	onStepChange?: (step: OnrampStep, previousStep: OnrampStep) => void;
+	/** Called when the user closes the flow (via ✕ or Done) */
+	onClose?: () => void;
+	/** Apple Pay merchant identifier (default: "merchant.io.unifold") */
+	merchantIdentifier?: string;
+	/** URL scheme for Stripe redirects (default: "unifoldOnramp") */
+	urlScheme?: string;
+}
+/**
+ * High-level Stripe Onramp component.
+ *
+ * Handles all the plumbing automatically:
+ * - Reads the Unifold publishable key from UnifoldProvider context
+ * - Fetches the Stripe publishable key from the Unifold API
+ * - Wraps in StripeProvider
+ * - Eagerly configures the Stripe Onramp SDK
+ * - Renders OnrampScreen with the config
+ *
+ * Usage:
+ * ```tsx
+ * <StripeOnramp
+ *   email={user.email}
+ *   externalUserId={user.id}
+ *   onClose={() => navigation.goBack()}
+ * />
+ * ```
+ */
+export declare function StripeOnramp({ publishableKey, email, phone, externalUserId, flowOrder, destinationChainType, destinationChainId, destinationTokenAddress, recipientAddress, onComplete, onError, onStepChange, onClose, merchantIdentifier, urlScheme, }: StripeOnrampProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Render inside StripeOnramp after initStripe() has completed.
+ * Eagerly calls configure() so the Onramp SDK is ready by the time
+ * useStripeOnramp needs it. Renders nothing.
+ */
+export declare function StripeOnrampPreconfigure(): null;
+
+export {};