@tonder.io/rn-sdk 0.1.0-beta.DEV1355.1

package/src/shared/utils/styleUtils.ts

@@ -0,0 +1,11 @@
+import type { StylesBaseVariant } from '@types';
+
+const buildBaseStyleText = (style?: StylesBaseVariant) => {
+  return {
+    ...(style?.base?.fontSize ? { fontSize: style?.base?.fontSize } : {}),
+    ...(style?.base?.color ? { color: style?.base?.color } : {}),
+    ...(style?.base?.fontWeight ? { fontWeight: style?.base?.fontWeight } : {}),
+  };
+};
+
+export { buildBaseStyleText };

package/src/types/base.ts

@@ -0,0 +1,79 @@
+import type {
+  IEnrollment,
+  IEnrollmentOptions,
+  IEnrollmentState,
+  IInlineCheckoutOptions,
+  IInlineCheckoutState,
+  ILiteCheckoutOptions,
+  ILiteCheckoutState,
+  IPaymentInlineContainer,
+  IPaymentLiteContainer,
+} from '@types';
+import type TonderError from '@shared/utils/errors';
+import type PaymentInlineContainer from '@core/PaymentInlineContainer';
+import type PaymentLiteContainer from '@core/PaymentLiteContainer';
+import type { EnrollmentContainer } from '@core/EnrollmentContainer';
+
+export type Environment = 'production' | 'sandbox' | 'stage' | 'development';
+
+export enum SDKType {
+  INLINE = 'inline',
+  LITE = 'lite',
+  ENROLLMENT = 'enrollment',
+}
+
+export type IBaseResponse<T> =
+  | { response: T; error?: never }
+  | { response?: never; error: TonderError };
+
+export type SDKsContainer =
+  | PaymentInlineContainer
+  | PaymentLiteContainer
+  | EnrollmentContainer;
+export interface ISDKBaseConfig {
+  mode: Environment;
+  apiKey: string;
+  type: SDKType;
+  returnURL?: string;
+  sdkId?: string;
+}
+
+export interface IBaseState<T extends SDKType> {
+  secureToken: string;
+  isCreated: boolean;
+  isCreating: boolean;
+  isProcessing: boolean;
+  error: TonderError | Error | null;
+  config: ISDKBaseConfig;
+  options: SDKOptions<T>;
+  message: string;
+}
+
+export interface IBaseCreateOptions {
+  secureToken?: string;
+}
+export type SDKOptionsMap = {
+  [SDKType.INLINE]: IInlineCheckoutOptions;
+  [SDKType.LITE]: ILiteCheckoutOptions;
+  [SDKType.ENROLLMENT]: IEnrollmentOptions;
+};
+
+// Helper type to get options type based on SDK type
+export type SDKOptions<T extends SDKType> = SDKOptionsMap[T];
+
+// Helper type to get instance type based on SDK type
+export type SDKInstance<T extends SDKType> = T extends SDKType.INLINE
+  ? IPaymentInlineContainer
+  : T extends SDKType.LITE
+    ? IPaymentLiteContainer
+    : T extends SDKType.ENROLLMENT
+      ? IEnrollment
+      : never;
+
+export type SDKStateInstance<T extends SDKType> = T extends SDKType.INLINE
+  ? IInlineCheckoutState
+  : T extends SDKType.LITE
+    ? ILiteCheckoutState
+    : T extends SDKType.ENROLLMENT
+      ? IEnrollmentState
+      : never;

package/src/types/baseCheckout.ts

@@ -0,0 +1,42 @@
+import type {
+  Business,
+  IBaseProcessPaymentRequest,
+  IBaseState,
+  ICustomerResponse,
+  IInlineCallbacks,
+  IInlineCustomizationOptions,
+  IInternalProcessPaymentRequest,
+  ILiteCallbacks,
+  ILiteCustomizationOptions,
+  IProcessPaymentRequest,
+  ITransaction,
+} from '@types';
+import type { IConfig } from 'skyflow-react-native';
+import { SDKType } from '@types';
+import type TonderError from '@shared/utils/errors';
+
+export interface IBaseUIState {
+  card?: string;
+  payment_method?: string;
+  saveCard?: boolean;
+}
+export interface IBaseCheckoutState<T extends SDKType> extends IBaseState<T> {
+  paymentData: IBaseProcessPaymentRequest | IProcessPaymentRequest;
+  customerData?: ICustomerResponse;
+  merchantData?: Business;
+  skyflowConfig?: IConfig;
+  internalPaymentData?: IInternalProcessPaymentRequest;
+  customization?: IInlineCustomizationOptions | ILiteCustomizationOptions;
+  callbacks?: IInlineCallbacks | ILiteCallbacks;
+  deviceSessionIds?: {
+    openPay: string;
+    mercadoPago: string;
+  };
+  returnURL: string;
+  uiData: IBaseUIState;
+}
+
+export interface IBaseCallback {
+  beforePayment?: () => Promise<void>;
+  onFinishPayment?: (response: ITransaction | TonderError) => Promise<void>;
+}

package/src/types/baseEnrollment.ts

@@ -0,0 +1,17 @@
+import type {
+  Business,
+  IBaseState,
+  ICustomer,
+  ICustomerResponse,
+  IEnrollmentCallbacks,
+} from '@types';
+import type { IConfig } from 'skyflow-react-native';
+import { SDKType } from '@types';
+
+export interface IBaseEnrollmentState extends IBaseState<SDKType.ENROLLMENT> {
+  customer?: ICustomer;
+  customerData?: ICustomerResponse;
+  merchantData?: Business;
+  skyflowConfig?: IConfig;
+  callbacks?: IEnrollmentCallbacks;
+}

package/src/types/baseSDK.ts

@@ -0,0 +1,10 @@
+import type { Business, IBaseState, ICustomerResponse } from '@types';
+import type { IConfig } from 'skyflow-react-native';
+import { SDKType } from '@types';
+
+export interface IBaseSDKState<T extends SDKType> extends IBaseState<T> {
+  customerData?: ICustomerResponse;
+  merchantData?: Business;
+  skyflowConfig?: IConfig;
+  skyflowContainer?: any;
+}

package/src/types/business.ts

@@ -0,0 +1,34 @@
+export interface Business {
+  business: {
+    pk: number;
+    name: string;
+    categories: {
+      pk: number;
+      name: string;
+    }[];
+    web: string;
+    logo: string;
+    full_logo_url: string;
+    background_color: string;
+    primary_color: string;
+    checkout_mode: boolean;
+    textCheckoutColor: string;
+    textDetailsColor: string;
+    checkout_logo: string;
+  };
+  openpay_keys: {
+    merchant_id: string;
+    public_key: string;
+  };
+  fintoc_keys: {
+    public_key: string;
+  };
+  mercado_pago: {
+    active: boolean;
+  };
+  vault_id: string;
+  vault_url: string;
+  reference: string;
+  is_installments_available: boolean;
+}
+export interface GetBusinessResponse extends Business {}

package/src/types/card.ts

@@ -0,0 +1,38 @@
+export interface ISaveCardsOptionsBase {
+  autoSave?: boolean;
+}
+
+export interface ISaveCardsOptions extends ISaveCardsOptionsBase {
+  showSaveCardOption?: boolean;
+  showSaved?: boolean;
+  autoSave?: boolean;
+  showDeleteOption?: boolean;
+}
+
+export interface ICard {
+  fields: ICardSkyflowFields;
+  icon?: string;
+}
+
+export interface ICardSkyflowFields {
+  card_number: string;
+  expiration_month: string;
+  expiration_year: string;
+  skyflow_id: string;
+  card_scheme: string;
+  cardholder_name: string;
+}
+
+export interface ICustomerCardsResponse {
+  user_id: number;
+  cards: ICard[];
+}
+
+export interface ISaveCardResponse {
+  skyflow_id: string;
+  user_id: number;
+}
+
+export interface ISaveCardSkyflowRequest {
+  skyflow_id: string;
+}

package/src/types/checkout.ts

@@ -0,0 +1,157 @@
+import type { IBrowserInfo } from './common';
+import type { IItem } from './payment';
+
+export interface IStartCheckoutBase {
+  name: string;
+  last_name: string;
+  email_client: string;
+  phone_number?: string;
+  return_url?: string;
+  id_product: string;
+  quantity_product: number;
+  id_ship: string;
+  instance_id_ship: string;
+  amount: number;
+  title_ship: string;
+  description: string;
+  device_session_id: string | null;
+  token_id: string;
+  order_id: string | number;
+  business_id: string | number;
+  payment_id: string | number;
+  source: string;
+  browser_info?: IBrowserInfo;
+  metadata: any;
+  currency: string;
+}
+
+export type IStartCheckoutRequest = IStartCheckoutBase &
+  (
+    | { card: any; payment_method?: any }
+    | { card?: any; payment_method: string }
+  );
+
+export interface IStartCheckoutIdRequest {
+  checkout_id: string;
+}
+
+export interface INextAction {
+  redirect_to_url?: {
+    url: string;
+    return_url: string;
+    verify_transaction_status_url: string;
+  };
+  iframe_resources?: {
+    iframe: string;
+    verify_transaction_status_url: string;
+  };
+  three_ds_challenge?: string;
+}
+
+export interface ICheckoutResponse {
+  status: string;
+  message: string;
+  psp_response: Record<string, any>;
+  checkout_id: string;
+  is_route_finished: boolean;
+  transaction_status: string;
+  transaction_id: number;
+  payment_id: number;
+  provider: string;
+  next_action?: INextAction;
+  actions: ICheckoutAction[];
+}
+
+export interface ICheckoutAction {
+  name: string;
+  url: string;
+  method: string;
+}
+
+export interface ICreateOrderResponse {
+  id: number | string;
+  created: string;
+  amount: string;
+  status: string;
+  payment_method?: string;
+  reference?: string;
+  is_oneclick: boolean;
+  items: IItem[];
+  billing_address?: string;
+  shipping_address?: string;
+  client: {
+    email: string;
+    name: string;
+    first_name: string;
+    last_name: string;
+    client_profile: {
+      gender: string;
+      date_birth?: string;
+      terms: boolean;
+      phone: string;
+    };
+  };
+}
+
+export interface ICreatePaymentResponse {
+  pk: number | string;
+  order?: string;
+  amount: string;
+  status: string;
+  date: string;
+  paid_date?: string;
+  shipping_address: {
+    street: string;
+    number: string;
+    suburb: string;
+    city: {
+      name: string;
+    };
+    state: {
+      name: string;
+      country: {
+        name: string;
+      };
+    };
+    zip_code: string;
+  };
+  shipping_address_id?: string;
+  billing_address: {
+    street: string;
+    number: string;
+    suburb: string;
+    city: {
+      name: string;
+    };
+    state: {
+      name: string;
+      country: {
+        name: string;
+      };
+    };
+    zip_code: string;
+  };
+  billing_address_id?: string;
+  client?: string;
+  customer_order_reference?: string;
+}
+
+export type ICreatePaymentRequest = {
+  business_pk: string | number;
+  amount: number;
+  date: string;
+  order_id: string | number;
+  client_id: string | number;
+};
+
+export interface ICreateOrderRequest {
+  business: string;
+  client: string;
+  billing_address_id?: number | null;
+  shipping_address_id?: number | null;
+  amount: number;
+  status?: string;
+  reference: string | number;
+  is_oneclick: boolean;
+  items: IItem[];
+}

package/src/types/common.ts

@@ -0,0 +1,68 @@
+import type { IUIWrapper } from '@ui/providers/TonderProvider/uiWrapper';
+import type { Environment, SDKInstance } from './base';
+import type { IElementStyle } from './input';
+import { SDKType } from './base';
+
+export interface StylesBaseVariant {
+  base?: Record<string, any>;
+}
+
+export interface StylesSelectVariant {
+  base?: Record<string, any>;
+  radioBase?: Record<string, any>;
+  radioInner?: Record<string, any>;
+  radioSelected?: Record<string, any>;
+  cardIcon?: Record<string, any>;
+}
+
+export interface StylesSavedCardsVariant extends StylesSelectVariant {
+  deleteButton?: Record<string, any>;
+  deleteIcon?: Record<string, any>;
+}
+
+export interface IApiConfig {
+  apiKey: string;
+  mode: Environment;
+}
+
+export interface IBrowserInfo {
+  language: string;
+  time_zone: number;
+  user_agent: string;
+  color_depth: number | null;
+  screen_width: number | null;
+  screen_height: number | null;
+  javascript_enabled: boolean;
+}
+
+export interface IFormLabels {
+  name?: string;
+  cardNumber?: string;
+  cvv?: string;
+  expiryDate?: string;
+}
+
+export interface IFormPlaceholder {
+  name?: string;
+  cardNumber?: string;
+  cvv?: string;
+  expiryMonth?: string;
+  expiryYear?: string;
+}
+
+export interface IStyles {
+  sdkCard?: StylesBaseVariant;
+  cardForm?: StylesBaseVariant & IElementStyle;
+  paymentMethods?: StylesSelectVariant;
+  savedCards?: StylesSavedCardsVariant;
+  paymentRadio?: StylesSelectVariant;
+  paymentButton?: StylesBaseVariant;
+  errorMessage?: StylesBaseVariant;
+  successMessage?: StylesBaseVariant;
+}
+
+export interface ITonderContext<T extends SDKType> {
+  uiWrapper: IUIWrapper;
+  sdk: SDKInstance<T>;
+  state: any;
+}

package/src/types/customer.ts

@@ -0,0 +1,29 @@
+export interface ICustomer {
+  email: string;
+  firstName?: string;
+  lastName?: string;
+  country?: string;
+  street?: string;
+  city?: string;
+  state?: string;
+  postCode?: string;
+  phone?: string;
+  address?: string;
+}
+
+export interface ICustomerProfile {
+  gender?: string;
+  date_birth?: string;
+  terms: boolean;
+  phone: string;
+}
+
+export interface ICustomerResponse {
+  id: number | string;
+  email: string;
+  auth_token?: string;
+  name?: string;
+  first_name?: string;
+  last_name?: string;
+  client_profile?: ICustomerProfile;
+}

package/src/types/enrollment.ts

@@ -0,0 +1,70 @@
+import type { IBaseCreateOptions, IBaseResponse, SDKOptions } from './base';
+import type { IBaseEnrollmentState } from './baseEnrollment';
+import { SDKType } from './base';
+import type { ISaveCardResponse } from './card';
+import type { IFormLabels, IFormPlaceholder, IStyles } from './common';
+import type { ICustomer } from './customer';
+import TonderError from '@shared/utils/errors';
+
+export interface IEnrollmentOptions extends IBaseCreateOptions {
+  customer?: ICustomer;
+  customization?: IEnrollmentCustomizationOptions;
+  callbacks?: IEnrollmentCallbacks;
+}
+
+export interface IEnrollmentCallbacks {
+  beforeSave?: () => Promise<void>;
+  onFinishSave?: (response: IBaseResponse<ISaveCardResponse>) => Promise<void>;
+}
+
+export interface IEnrollmentCustomizationOptions {
+  saveButton?: {
+    show?: boolean;
+    text?: string;
+  };
+  showMessages?: boolean;
+  labels?: IFormLabels;
+  placeholders?: IFormPlaceholder;
+  styles?: IStyles;
+}
+export interface IEnrollmentState extends IBaseEnrollmentState {
+  customization?: IEnrollmentCustomizationOptions;
+  callbacks?: IEnrollmentCallbacks;
+  message: string;
+}
+export interface IEnrollment {
+  /**
+   * Creates an SDK instance and initializes necessary configurations.
+   * @param {SDKOptions<SDKType.ENROLLMENT>} data - Configuration and initialization data for the SDK.
+   * @returns {Promise<{ error?: TonderError }>} A promise that resolves to an object containing
+   * an error if one occurred during initialization.
+   *
+   * @public
+   */
+  create(
+    data: SDKOptions<SDKType.ENROLLMENT>
+  ): Promise<{ error?: TonderError }>;
+
+  /**
+   * Saves a card to a customer's account. This method can be used to add a new card
+   * or update an existing one.
+   * @returns {Promise<IBaseResponse<ISaveCardResponse>>} A promise that resolves with the saved card data.
+   *
+   * @public
+   */
+  saveCustomerCard(): Promise<IBaseResponse<ISaveCardResponse>>;
+
+  /**
+   * Resets the SDK state, clearing all subscribers and event listeners.
+   * This method is used to reinitialize the SDK with the current configuration.
+   *
+   * @remarks
+   * This method should be called when you need to completely reset the SDK state.
+   * For example, if a user logs out or the configuration needs to be refreshed.
+   *
+   * @returns {void} Does not return a value.
+   *
+   * @public
+   */
+  reset(): void;
+}

package/src/types/index.ts

@@ -0,0 +1,18 @@
+export * from './base';
+export * from './card';
+export * from './checkout';
+export * from './customer';
+export * from './payment';
+export * from './transaction';
+export * from './business';
+export * from './secure';
+export * from './openpay';
+export * from './common';
+export * from './liteCheckout';
+export * from './inlineCheckout';
+export * from './enrollment';
+export * from './input';
+export * from './baseCheckout';
+export * from './baseEnrollment';
+export * from './threeDSHandler';
+export * from './baseSDK';

package/src/types/inlineCheckout.ts

@@ -0,0 +1,96 @@
+import type {
+  IBaseCheckoutState,
+  IBaseCreateOptions,
+  ICustomerCardsResponse,
+  IPaymentMethod,
+  ISaveCardsOptions,
+  IFormLabels,
+  IFormPlaceholder,
+  IStyles,
+  ITransaction,
+  IBaseProcessPaymentRequest,
+  IBaseCallback,
+  IBaseResponse,
+} from '@tonder.io/rn-sdk';
+import { SDKType } from '@tonder.io/rn-sdk';
+import TonderError from '@shared/utils/errors';
+
+export interface IInlineCheckoutOptions extends IBaseCreateOptions {
+  tdsIframeId?: string;
+  paymentData: IBaseProcessPaymentRequest;
+  customization?: IInlineCustomizationOptions;
+  callbacks?: IInlineCallbacks;
+  returnURL?: string;
+}
+
+export interface IInlineCheckoutState
+  extends IBaseCheckoutState<SDKType.INLINE> {
+  deviceSessionIds?: {
+    openPay: string;
+    mercadoPago: string;
+  };
+  customization?: IInlineCustomizationOptions;
+  callbacks?: IInlineCallbacks;
+  message: string;
+  customerCards: ICustomerCardsResponse;
+  payment_methods: IPaymentMethod[];
+}
+
+export interface IInlineCustomizationOptions {
+  saveCards?: ISaveCardsOptions;
+  paymentButton?: {
+    show?: boolean;
+    text?: string;
+    showAmount?: boolean;
+  };
+  paymentMethods?: {
+    show?: boolean;
+  };
+  cardForm?: {
+    show?: boolean;
+  };
+  showMessages?: boolean;
+  labels?: IFormLabels;
+  placeholders?: IFormPlaceholder;
+  styles?: IStyles;
+}
+export interface IInlineCallbacks extends IBaseCallback {
+  beforeDeleteCard?: () => Promise<void>;
+  onFinishDeleteCard?: (id: string) => Promise<void>;
+}
+export interface IPaymentInlineContainer {
+  /**
+   * Creates an SDK instance and initializes necessary configurations.
+   * @param {IInlineCheckoutOptions} data - Configuration and initialization data for the SDK.
+   * @returns {Promise<{ error?: TonderError }>} A promise that resolves to an object containing
+   * an error if one occurred during initialization.
+   *
+   * @public
+   */
+  create(data: IInlineCheckoutOptions): Promise<{ error?: TonderError }>;
+
+  /**
+   * Processes a payment.
+   * @param {IBaseProcessPaymentRequest} data - (Optional) Payment data including customer, cart, and other relevant information (Useful in case you need to update payment information).
+   * @returns {Promise<IBaseResponse<ITransaction>>} A promise that resolves with the payment response or 3DS redirect or is rejected with an error.
+   *
+   * @public
+   */
+  payment(
+    data?: IBaseProcessPaymentRequest
+  ): Promise<IBaseResponse<ITransaction>>;
+
+  /**
+   * Resets the SDK state, clearing all subscribers and event listeners.
+   * This method is used to reinitialize the SDK with the current configuration.
+   *
+   * @remarks
+   * This method should be called when you need to completely reset the SDK state.
+   * For example, if a user logs out or the configuration needs to be refreshed.
+   *
+   * @returns {void} Does not return a value.
+   *
+   * @public
+   */
+  reset(): void;
+}

package/src/types/input.ts

@@ -0,0 +1,17 @@
+import type {
+  CollectInputStylesVariant,
+  CollectLabelStylesVariant,
+} from 'skyflow-react-native';
+import type { StylesBaseVariant } from './common';
+
+export interface InputProps {
+  label?: string;
+  placeholder?: string;
+  style?: IElementStyle;
+}
+
+export interface IElementStyle {
+  inputStyles?: CollectInputStylesVariant;
+  labelStyles?: CollectLabelStylesVariant;
+  errorStyles?: StylesBaseVariant;
+}