react-native-hyperswitch-dev-sdk 0.4.1

package/src/specs/NativeHyperswitchModule.ts

@@ -0,0 +1,51 @@
+import type { TurboModule } from 'react-native';
+import { NativeModules, TurboModuleRegistry } from 'react-native';
+
+export type CustomEndpoints = Object;
+
+export interface SessionData {
+  hyperswitchConfig: Object;
+  paymentSessionConfig: { sdkAuthorization: string };
+  configuration: Object;
+}
+
+export interface SavedPaymentMethodsConfiguration {
+  hiddenPaymentMethods?: string[];
+}
+
+export interface Spec extends TurboModule {
+  initialise(
+    publishableKey: string,
+    platformPublishableKey: string,
+    profileId: string,
+    environment: string,
+    customEndpoints: CustomEndpoints
+  ): Promise<string>;
+
+  presentPaymentSheet(params: SessionData): Promise<string>;
+
+  getCustomerSavedPaymentMethods(params?: SessionData): Promise<string>;
+
+  getCustomerLastUsedPaymentMethodData(): Promise<string>;
+
+  getCustomerDefaultSavedPaymentMethodData(): Promise<string>;
+
+  getCustomerSavedPaymentMethodData(): Promise<string>;
+
+  confirmWithCustomerLastUsedPaymentMethod(reactTag: number): Promise<string>;
+
+  confirmWithCustomerDefaultPaymentMethod(reactTag: number): Promise<string>;
+
+  confirmWithCustomerPaymentToken(reactTag: number, token: string): Promise<string>;
+}
+
+/**
+ * Use `TurboModuleRegistry.get` first for new-arch TurboModules, and fall back
+ * to `NativeModules` for legacy/old-arch support.
+ */
+const NativeHyperswitchModule =
+  TurboModuleRegistry.get<Spec>('NativeHyperswitchModule') ??
+  NativeModules.NativeHyperswitchModule;
+console.log('NativeHyperswitchModule', NativeHyperswitchModule);
+export default NativeHyperswitchModule as Spec;
+export { NativeHyperswitchModule };

package/src/specs/NativeHyperswitchSdkNative.ts

@@ -0,0 +1,62 @@
+import type {TurboModule} from 'react-native';
+import {TurboModuleRegistry} from 'react-native';
+
+/**
+ * Codegen spec for the HyperModule TurboModule.
+ *
+ * Naming convention: Native<ModuleName>.ts  — required by the RN codegen.
+ * All number params map to Double on Android (Kotlin) and NSNumber on iOS.
+ * All Object params map to ReadableMap; Array<Object> maps to ReadableArray.
+ */
+export interface Spec extends TurboModule {
+  // --- EventEmitter (required for NativeEventEmitter support) ---
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
+
+  // --- Generic message passing ---
+  sendMessageToNative(message: string): void;
+
+  // --- Google Pay (Android) ---
+  launchGPay(requestObj: string, callback: (result: Object) => void): void;
+
+  // --- Apple Pay (iOS; stubs on Android) ---
+  launchApplePay(requestObj: string, callback: (result: Object) => void): void;
+  startApplePay(requestObj: string, callback: (result: Object) => void): void;
+  presentApplePay(requestObj: string, callback: (result: Object) => void): void;
+
+  // --- Payment sheet ---
+  exitPaymentsheet(rootTag: number, result: string, reset: boolean): void;
+  exitPaymentMethodManagement(rootTag: number, result: string, reset: boolean): void;
+
+  // --- Widget ---
+  exitWidget(result: string, widgetType: string): void;
+  exitCardForm(result: string): void;
+  launchWidgetPaymentSheet(
+    requestObj: string,
+    callback: (result: Object) => void,
+  ): void;
+  exitWidgetPaymentsheet(rootTag: number, result: string, reset: boolean): void;
+  updateWidgetHeight(height: number): void;
+  notifyWidgetPaymentResult(rootTag: number, result: string): void;
+
+  // --- Payment method management ---
+  onAddPaymentMethod(data: string): void;
+
+  // --- Payment events ---
+  emitPaymentEvent(rootTag: number, eventType: string, payload: Object): void;
+  onUpdateIntentEvent(rootTag: number, type: string, result: string): void;
+  onPaymentConfirmButtonClick(
+    rootTag: number,
+    payload: string,
+    callback: (shouldProceed: boolean) => void,
+  ): void;
+
+  // --- 3DS / DDC iframe bridge ---
+  openIframeBridge(
+    url: string,
+    timeoutMs: number,
+    callback: (result: string) => void,
+  ): void;
+}
+
+export default TurboModuleRegistry.get<Spec>('HyperModule');

package/src/specs/NativePaymentElementModule.ts

@@ -0,0 +1,25 @@
+import type { TurboModule } from 'react-native';
+import { NativeModules, TurboModuleRegistry } from 'react-native';
+
+export interface Spec extends TurboModule {
+  confirmPayment(
+    reactTag: number,
+    callback: (result: Object) => void
+  ): void;
+  updateIntentInitForWidget(
+    reactTag: number,
+    callback: (result: Object) => void
+  ): void;
+  updateIntentCompleteForWidget(
+    reactTag: number,
+    sdkAuthorization: string,
+    callback: (result: Object) => void
+  ): void;
+}
+
+
+const NativePaymentElementModule =
+  TurboModuleRegistry.get<Spec>('NativePaymentElementModule') ??
+  NativeModules.NativePaymentElementModule;
+
+export default NativePaymentElementModule as Spec;

package/src/specs/PaymentElementNativeComponent.ts

@@ -0,0 +1,21 @@
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+import type { ViewProps } from 'react-native';
+import { DirectEventHandler } from 'react-native/Libraries/Types/CodegenTypes';
+import { UnsafeMixed, UnsafeObject } from './utils';
+import type { options } from '../types/PaymentSheetConfiguration';
+
+
+export interface NativeProps extends ViewProps {
+  widgetType?: string;
+  sdkAuthorization?: string;
+  options?: UnsafeMixed<options>;
+  onPaymentResult?: DirectEventHandler<{
+    result?: string;
+  }>;
+  onPaymentEvent?: DirectEventHandler<{
+    eventName: string;
+    payload?: UnsafeMixed<Record<string, any>>;
+  }>;
+}
+
+export default codegenNativeComponent<NativeProps>('RCTNativePaymentElement');

package/src/specs/utils.ts

@@ -0,0 +1,15 @@
+/**
+ * Allows using types that codegen doesn't support, which will be generated
+ * as mixed, but keeping the TS type for type-checking.
+ *
+ * Note that for some reason this only works for native components, not for turbo modules.
+ */
+export type UnsafeMixed<T> = T;
+
+/**
+ * Allows using types that codegen doesn't support, which will be generated
+ * as object, but keeping the TS type for type-checking.
+ *
+ * Note that for some reason this only works for turbo modules, not for native components.
+ */
+export type UnsafeObject<T> = T;

package/src/types/NativeModuleTypes.ts

@@ -0,0 +1,73 @@
+import type { ViewStyle } from 'react-native';
+import type { PaymentSheetConfiguration } from './PaymentSheetConfiguration';
+import {
+  HyperswitchConfiguration,
+  PaymentSessionConfiguration,
+} from './definitions';
+
+export type paymentResult = {
+  status?: string;
+  errorMessage?: string;
+};
+
+export type paymentResultEvent = paymentResult;
+
+export type cardInfo = {
+  bin: string | undefined;
+  last4: string | undefined;
+  brand: string | undefined;
+  expiryMonth: string | undefined;
+  expiryYear: string | undefined;
+  formattedExpiry: string | undefined;
+  isCardNumberComplete: boolean;
+  isCvcComplete: boolean;
+  isExpiryComplete: boolean;
+  isCardNumberValid: boolean;
+  isExpiryValid: boolean;
+};
+
+export type paymentMethodStatusEvent = {
+  paymentMethod: string;
+  paymentMethodType: string;
+  isSavedPaymentMethod: boolean;
+  isOneClickWallet: boolean;
+};
+
+export type formStatusEvent = { status: string };
+
+export type paymentMethodInfoAddress = {
+  country: string;
+  state: string;
+  postalCode: string;
+};
+
+export type cvcStatusEvent = {
+  isCvcFocused: boolean;
+  isCvcBlur: boolean;
+  isCvcEmpty: boolean;
+};
+
+export type paymentEventResult = {
+  eventName: string;
+  payload: Record<string, unknown>;
+};
+
+export type paymentEventNative = { nativeEvent: paymentEventResult };
+
+export type paymentResultInternal = { result?: string };
+
+export type nativeEvent = { nativeEvent: paymentResultInternal };
+
+export type nativePaymentWidgetType = {
+  ref?: React.Ref<unknown>;
+  widgetType?: string;
+  sdkAuthorization?: string;
+  options?: {
+    hyperswitchConfig?: HyperswitchConfiguration;
+    paymentSessionConfig?: PaymentSessionConfiguration;
+    configuration?: PaymentSheetConfiguration;
+  };
+  onPaymentResult?: (event: nativeEvent) => void;
+  style?: ViewStyle;
+  onPaymentEvent?: (event: paymentEventNative) => void;
+};

package/src/types/PaymentSheetConfiguration.ts

@@ -0,0 +1,360 @@
+import { HyperswitchConfiguration } from "./definitions";
+
+export interface Colors {
+  primary?: string;
+  background?: string;
+  componentBackground?: string;
+  componentBorder?: string;
+  componentDivider?: string;
+  componentText?: string;
+  primaryText?: string;
+  secondaryText?: string;
+  placeholderText?: string;
+  icon?: string;
+  error?: string;
+  loaderBackground?: string;
+  loaderForeground?: string;
+  overlay?: string;
+  selectedComponentBackground?: string;
+  selectedComponentBorder?: string;
+  selectedComponentBorderWidth?: number;
+  selectedComponentDivider?: string;
+  selectedComponentText?: string;
+}
+
+export interface ColorType {
+  light?: Colors;
+  dark?: Colors;
+}
+
+export interface OffsetType {
+  x?: number;
+  y?: number;
+}
+
+export interface ShadowConfig {
+  color?: string;
+  opacity?: number;
+  blurRadius?: number;
+  offset?: OffsetType;
+  intensity?: number;
+}
+
+export interface Shapes {
+  borderRadius?: number;
+  borderWidth?: number;
+  shadow?: ShadowConfig;
+  inputHeight?: number;
+  gap?: number;
+}
+
+export interface Font {
+  family?: string;
+  scale?: number;
+  headingTextSizeAdjust?: number;
+  subHeadingTextSizeAdjust?: number;
+  placeholderTextSizeAdjust?: number;
+  buttonTextSizeAdjust?: number;
+  errorTextSizeAdjust?: number;
+  linkTextSizeAdjust?: number;
+  modalTextSizeAdjust?: number;
+  cardTextSizeAdjust?: number;
+}
+
+
+export type SubscriptionEvent =
+  | 'PAYMENT_METHOD_INFO_CARD'
+  | 'PAYMENT_METHOD_STATUS'
+  | 'FORM_STATUS'
+  | 'PAYMENT_METHOD_INFO_BILLING_ADDRESS'
+  | 'CVC_STATUS';
+
+export type Theme =
+  | 'Default'
+  | 'Light'
+  | 'Dark'
+  | 'Minimal'
+  | 'FlatMinimal'
+  | 'Brutal'
+  | 'Glass'
+  | 'Skeu'
+  | 'Clay'
+  | 'Charcoal'
+  | 'Soft';
+
+export type LayoutType = 'tabs' | 'accordion' | 'spacedAccordion';
+export type PaymentMethodsArrangement = 'default' | 'grid';
+export type RedirectionInfo = 'hidden' | 'shown';
+export type CvcIconDisplay = 'shown' | 'hidden';
+
+export interface GroupingBehavior {
+  displayInSeparateScreen?: boolean;
+  displayInSeparateSection?: boolean;
+  groupByPaymentMethods?: boolean;
+}
+
+export interface SavedPaymentMethodsConfiguration {
+  hiddenPaymentMethods?: string[];
+}
+
+export interface SavedMethodCustomization {
+  defaultCollapsed?: boolean;
+  hideCardExpiry?: boolean;
+  hideCVCError?: boolean;
+  cvcIcon?: CvcIconDisplay;
+  groupingBehavior?: GroupingBehavior;
+  hiddenPaymentMethods?: string[];
+}
+
+export type CardBrandIconDisplay = 'hidden' | 'animated' | 'standard' | 'hideGeneric';
+
+export interface PaymentMethodLayout {
+  type?: LayoutType;
+  showOneClickWalletsOnTop?: boolean;
+  paymentMethodsArrangementForTabs?: PaymentMethodsArrangement;
+  defaultCollapsed?: boolean;
+  radios?: boolean;
+  spacedAccordionItems?: boolean;
+  maxAccordionItems?: number;
+  cvcIcon?: CvcIconDisplay;
+  cardBrandIcon?: CardBrandIconDisplay;
+  showCheckedIconForSelection?: boolean;
+  savedMethodCustomization?: SavedMethodCustomization;
+}
+
+export interface PrimaryButtonColors {
+  background?: string;
+  text?: string;
+  border?: string;
+}
+
+export interface PrimaryButtonColorType {
+  light?: PrimaryButtonColors;
+  dark?: PrimaryButtonColors;
+}
+
+export interface PrimaryButton {
+  shapes?: Shapes;
+  colors?: PrimaryButtonColorType;
+  height?: number;
+}
+
+export type GooglePayButtonType =
+  | 'BUY'
+  | 'BOOK'
+  | 'CHECKOUT'
+  | 'DONATE'
+  | 'ORDER'
+  | 'PAY'
+  | 'SUBSCRIBE'
+  | 'PLAIN';
+
+export type GooglePayButtonStyle = 'light' | 'dark';
+
+export interface GooglePayThemeBaseStyle {
+  light?: GooglePayButtonStyle;
+  dark?: GooglePayButtonStyle;
+}
+
+export interface GooglePayConfiguration {
+  visibility?: 'hidden' | 'shown';
+  buttonType?: GooglePayButtonType;
+  buttonStyle?: GooglePayThemeBaseStyle;
+}
+
+export type ApplePayButtonType =
+  | 'buy'
+  | 'setUp'
+  | 'inStore'
+  | 'donate'
+  | 'checkout'
+  | 'book'
+  | 'subscribe'
+  | 'plain';
+
+export type ApplePayButtonStyle = 'white' | 'whiteOutline' | 'black';
+
+export interface ApplePayThemeBaseStyle {
+  light?: ApplePayButtonStyle;
+  dark?: ApplePayButtonStyle;
+}
+
+export interface ApplePayConfiguration {
+  visibility?: 'hidden' | 'shown';
+  buttonType?: ApplePayButtonType;
+  buttonStyle?: ApplePayThemeBaseStyle;
+}
+
+export type PayPalButtonType = 'paypal' | 'checkout' | 'buynow' | 'pay';
+export type PayPalButtonStyle = 'gold' | 'blue' | 'white' | 'black' | 'silver';
+export type PayPalButtonSize = 'small' | 'medium' | 'large';
+
+export interface PayPalThemeBaseStyle {
+  light?: PayPalButtonStyle;
+  dark?: PayPalButtonStyle;
+}
+
+export interface PayPalConfiguration {
+  visibility?: 'hidden' | 'shown';
+  buttonType?: PayPalButtonType;
+  buttonSize?: PayPalButtonSize;
+  buttonStyle?: PayPalThemeBaseStyle;
+}
+
+export interface WalletButtonsConfiguration {
+  googlePay?: GooglePayConfiguration;
+  applePay?: ApplePayConfiguration;
+  payPal?: PayPalConfiguration;
+}
+
+export interface LogoColors {
+  backgroundColor?: string;
+  selected?: string;
+  unselected?: string;
+}
+
+export interface LogoColorType {
+  light?: LogoColors;
+  dark?: LogoColors;
+}
+
+export interface CheckedIconColors {
+  color?: string;
+  stroke?: string;
+}
+
+export interface CheckedIconColorType {
+  light?: CheckedIconColors;
+  dark?: CheckedIconColors;
+}
+
+export interface CheckedIconForSelection {
+  colors?: CheckedIconColorType;
+  size?: number;
+  bottom?: number;
+  right?: number;
+}
+
+export interface LogoCustomization {
+  borderRadius?: number;
+  colors?: LogoColorType;
+  checkedIconForSelection?: CheckedIconForSelection;
+}
+
+export interface Appearance {
+  theme?: Theme;
+  colors?: ColorType;
+  shapes?: Shapes;
+  font?: Font;
+  primaryButton?: PrimaryButton;
+  logo?: LogoCustomization;
+}
+
+export interface Placeholder {
+  cardNumber?: string;
+  expiryDate?: string;
+  cvv?: string;
+}
+
+export interface Address {
+  first_name?: string;
+  last_name?: string;
+  city?: string;
+  country?: string;
+  line1?: string;
+  line2?: string;
+  line3?: string;
+  postalCode?: string;
+  state?: string;
+}
+
+export interface Phone {
+  number?: string;
+  code?: string;
+}
+
+export interface AddressDetails {
+  address?: Address;
+  email?: string;
+  phone?: Phone;
+}
+
+export interface CustomerConfiguration {
+  id?: string;
+  ephemeralKeySecret?: string;
+}
+
+export interface PaymentMethodConfig {
+  paymentMethod: string;
+  message?: string;
+}
+
+export type Locale =
+  | 'en'
+  | 'he'
+  | 'fr'
+  | 'en-GB'
+  | 'ar'
+  | 'ja'
+  | 'de'
+  | 'fr-BE'
+  | 'es'
+  | 'ca'
+  | 'pt'
+  | 'it'
+  | 'pl'
+  | 'nl'
+  | 'nI-BE'
+  | 'sv'
+  | 'ru'
+  | 'lt'
+  | 'cs'
+  | 'sk'
+  | 'ls'
+  | 'cy'
+  | 'el'
+  | 'et'
+  | 'fi'
+  | 'nb'
+  | 'bs'
+  | 'da'
+  | 'ms'
+  | 'tr-CY';
+
+export interface PaymentSheetConfiguration {
+  appearance?: Appearance;
+  merchantDisplayName: string;
+  allowsDelayedPaymentMethods?: boolean;
+  allowsPaymentMethodsRequiringShippingAddress?: boolean;
+  displaySavedPaymentMethodsCheckbox?: boolean;
+  displaySavedPaymentMethods?: boolean;
+  displayDefaultSavedPaymentIcon?: boolean;
+  displayPayButton?: boolean;
+  stickyPayButton?: boolean;
+  disableBranding?: boolean;
+  preloadCardElement?: boolean;
+  primaryButtonLabel?: string;
+  paymentSheetHeaderLabel?: string;
+  savedPaymentSheetHeaderLabel?: string;
+  netceteraSDKApiKey?: string;
+  locale?: Locale;
+  subscribedEvents?: SubscriptionEvent[];
+  customer?: CustomerConfiguration;
+  placeholder?: Placeholder;
+  billingDetails?: AddressDetails;
+  shippingDetails?: AddressDetails;
+  walletButtonsConfiguration?: WalletButtonsConfiguration;
+  redirectionInfo?: RedirectionInfo;
+  alwaysSendCustomerAcceptance?: boolean;
+  paymentMethodsConfig?: PaymentMethodConfig[];
+  opensCardScannerAutomatically?: boolean;
+  paymentMethodOrder?: string[];
+  paymentMethodLayout?: PaymentMethodLayout;
+  splitCardFields?: boolean;
+}
+
+export interface options {
+  hyperswitchConfig?: HyperswitchConfiguration;
+  paymentSessionConfig?: { sdkAuthorization: string };
+  configuration?: PaymentSheetConfiguration;
+}