@primer-io/react-native 0.16.2 → 2.1.0

package/lib/typescript/src/headless_checkout/types.d.ts

@@ -0,0 +1,22 @@
+import type { PrimerCheckoutData } from '../models/PrimerCheckoutData';
+import type { PrimerCheckoutPaymentMethodData } from '../models/PrimerCheckoutPaymentMethodData';
+import type { PrimerTokenizationHandler, PrimerResumeHandler, PrimerPaymentCreationHandler, PrimerErrorHandler } from '../models/PrimerInterfaces';
+import type { PrimerClientSession } from '../models/PrimerClientSession';
+import type { PrimerPaymentMethodTokenData } from '../models/PrimerPaymentMethodTokenData';
+import type { PrimerError } from '../models/PrimerError';
+export interface PrimerHeadlessUniversalCheckoutStartResponse {
+    paymentMethodTypes: string[];
+}
+export interface PrimerHeadlessUniversalCheckoutCallbacks {
+    onBeforeClientSessionUpdate?: () => void;
+    onClientSessionUpdate?: (clientSession: PrimerClientSession) => void;
+    onBeforePaymentCreate?: (checkoutPaymentMethodData: PrimerCheckoutPaymentMethodData, handler: PrimerPaymentCreationHandler) => void;
+    onCheckoutComplete?: (checkoutData: PrimerCheckoutData) => void;
+    onTokenizeSuccess?: (paymentMethodTokenData: PrimerPaymentMethodTokenData, handler: PrimerTokenizationHandler) => void;
+    onResumeSuccess?: (resumeToken: string, handler: PrimerResumeHandler) => void;
+    onError?: (error: PrimerError, checkoutData: PrimerCheckoutData | null, handler: PrimerErrorHandler | undefined) => void;
+    onPrepareStart?: (paymentMethodType: string) => void;
+    onTokenizeStart?: (paymentMethodType: string) => void;
+    onPaymentMethodShow?: (paymentMethodType: string) => void;
+    onAvailablePaymentMethodTypesLoad?: (paymentMethodTypes: string[]) => void;
+}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,10 @@
+export { Primer } from './Primer';
+export { PrimerSettings } from './models/PrimerSettings';
+export { PrimerSessionIntent } from './models/PrimerSessionIntent';
+export { PrimerPaymentCreationHandler, PrimerTokenizationHandler, PrimerResumeHandler, PrimerErrorHandler, } from './models/PrimerInterfaces';
+export { PrimerPaymentMethodTokenData } from './models/PrimerPaymentMethodTokenData';
+export { PrimerClientSession, PrimerOrder, PrimerLineItem, PrimerCustomer, PrimerAddress, } from './models/PrimerClientSession';
+export { PrimerCheckoutData, PrimerCheckoutDataPayment, } from './models/PrimerCheckoutData';
+export { PrimerCheckoutPaymentMethodData } from './models/PrimerCheckoutPaymentMethodData';
+export { PrimerError } from './models/PrimerError';
+export { PrimerHeadlessUniversalCheckout } from './headless_checkout/PrimerHeadlessUniversalCheckout';

package/lib/typescript/src/models/PrimerCheckoutData.d.ts

@@ -0,0 +1,15 @@
+export declare type PrimerCheckoutData = IPrimerCheckoutData;
+interface IPrimerCheckoutData {
+    payment: IPrimerCheckoutDataPayment;
+}
+export declare type PrimerCheckoutDataPayment = IPrimerCheckoutDataPayment;
+interface IPrimerCheckoutDataPayment {
+    id?: string;
+    orderId?: string;
+    paymentFailureReason?: PrimerPaymentErrorCode;
+}
+declare enum PrimerPaymentErrorCode {
+    FAILED = "payment-failed",
+    CANCELLED_BY_CUSTOMER = "cancelled-by-customer"
+}
+export {};

package/lib/typescript/src/models/PrimerCheckoutPaymentMethodData.d.ts

@@ -0,0 +1,5 @@
+export declare type PrimerCheckoutPaymentMethodData = IPrimerCheckoutPaymentMethodData;
+interface IPrimerCheckoutPaymentMethodData {
+    paymentMethodType: string;
+}
+export {};

package/lib/typescript/src/models/PrimerClientSession.d.ts

@@ -0,0 +1,45 @@
+export declare type PrimerClientSession = IPrimerClientSession;
+interface IPrimerClientSession {
+    customerId?: string;
+    orderId?: string;
+    currencyCode?: string;
+    totalAmount?: number;
+    lineItems?: IPrimerLineItem[];
+    orderDetails?: IPrimerOrder;
+    customer?: IPrimerCustomer;
+}
+export declare type PrimerLineItem = IPrimerLineItem;
+interface IPrimerLineItem {
+    itemId?: string;
+    itemDescription?: string;
+    amount?: number;
+    discountAmount?: number;
+    quantity?: number;
+    taxCode?: string;
+    taxAmount?: number;
+}
+export declare type PrimerOrder = IPrimerOrder;
+interface IPrimerOrder {
+    countryCode?: string;
+}
+export declare type PrimerCustomer = IPrimerCustomer;
+interface IPrimerCustomer {
+    emailAddress?: string;
+    mobileNumber?: string;
+    firstName?: string;
+    lastName?: string;
+    billingAddress?: IPrimerAddress;
+    shippingAddress?: IPrimerAddress;
+}
+export declare type PrimerAddress = IPrimerAddress;
+interface IPrimerAddress {
+    firstName?: string;
+    lastName?: string;
+    addressLine1?: string;
+    addressLine2?: string;
+    postalCode?: string;
+    city?: string;
+    state?: string;
+    countryCode?: string;
+}
+export {};

package/lib/typescript/{models/utils/countryCode.d.ts → src/models/PrimerCountryCode.d.ts}

@@ -1,3 +1,3 @@
 declare var countries: readonly ["AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "AN", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SK", "SI", "SB", "SO", "ZA", "GS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW"];
-export declare type CountryCode = typeof countries[number];
+export declare type PrimerCountryCode = typeof countries[number];
 export {};

package/lib/typescript/{models/utils/currencyCode.d.ts → src/models/PrimerCurrencyCode.d.ts}

@@ -1,3 +1,3 @@
 declare const currencies: readonly ["AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BOV", "BRL", "BSD", "BTN", "BWP", "BYR", "BZD", "CAD", "CDF", "CHE", "CHF", "CHW", "CLF", "CLP", "CNY", "COP", "COU", "CRC", "CUC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LTL", "LVL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRO", "MUR", "MVR", "MWK", "MXN", "MXV", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SGD", "SHP", "SLL", "SOS", "SRD", "SSP", "STD", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USD", "USN", "USS", "UYI", "UYU", "UZS", "VEF", "VND", "VUV", "WST", "XAF", "XAG", "XAU", "XBA", "XBB", "XBC", "XBD", "XCD", "XDR", "XFU", "XOF", "XPD", "XPF", "XPT", "XTS", "XXX", "YER", "ZAR", "ZMW"];
-export declare type CurrencyCode = typeof currencies[number];
+export declare type PrimerCurrencyCode = typeof currencies[number];
 export {};

package/lib/typescript/src/models/PrimerError.d.ts

@@ -0,0 +1,11 @@
+export interface IPrimerError {
+    errorId: string;
+    description?: string;
+    recoverySuggestion?: string;
+}
+export declare class PrimerError extends Error {
+    errorId: string;
+    description: string;
+    recoverySuggestion?: string;
+    constructor(errorId: string, description: string, recoverySuggestion: string | undefined);
+}

package/lib/typescript/src/models/PrimerInterfaces.d.ts

@@ -0,0 +1,27 @@
+import type { PrimerSessionIntent } from "./PrimerSessionIntent";
+import type { PrimerSettings } from "./PrimerSettings";
+export interface IPrimer {
+    configure(settings: PrimerSettings): Promise<void>;
+    showUniversalCheckout(clientToken: string): Promise<void>;
+    showVaultManager(clientToken: string): Promise<void>;
+    showPaymentMethod(paymentMethodType: string, intent: PrimerSessionIntent, clientToken: string): Promise<void>;
+    dismiss(): void;
+    dispose(): void;
+}
+export interface PrimerPaymentCreationHandler {
+    abortPaymentCreation(errorMessage: string | null): void;
+    continuePaymentCreation(): void;
+}
+export interface PrimerTokenizationHandler {
+    handleSuccess(): void;
+    handleFailure(errorMessage: string | null): void;
+    continueWithNewClientToken(newClientToken: string): void;
+}
+export interface PrimerResumeHandler {
+    handleSuccess(): void;
+    handleFailure(errorMessage: string | null): void;
+    continueWithNewClientToken(newClientToken: string): void;
+}
+export interface PrimerErrorHandler {
+    showErrorMessage(errorMessage: string | null): void;
+}

package/lib/typescript/src/models/PrimerPaymentMethodTokenData.d.ts

@@ -0,0 +1,116 @@
+export declare type PrimerPaymentMethodTokenData = IPrimerPaymentMethodTokenData;
+export interface IPrimerPaymentMethodTokenData {
+    analyticsId?: string;
+    id?: string;
+    isVaulted?: boolean;
+    paymentInstrumentData: IPrimerPaymentInstrumentData;
+    paymentInstrumentType: string;
+    token: string;
+    tokenType?: PrimerTokenType;
+    threeDSecureAuthentication?: IPrimerThreeDSAuthenticationData;
+    vaultData?: IPrimerVaultData;
+}
+export declare enum PrimerTokenType {
+    SINGLE_USE = "SINGLE_USE",
+    MULTI_USE = "MULTI_USE"
+}
+export interface IPrimerThreeDSAuthenticationData {
+    challengeIssued?: boolean;
+    protocolVersion?: string;
+    reasonCode?: string;
+    reasonText?: string;
+    responseCode?: string;
+}
+export interface IPrimerVaultData {
+    customerId?: string;
+}
+export interface IPrimerPaymentInstrumentData {
+    paypalBillingAgreementId?: string;
+    first6Digits?: string;
+    last4Digits?: string;
+    expirationMonth?: string;
+    expirationYear?: string;
+    cardholderName?: string;
+    network?: string;
+    isNetworkTokenized?: boolean;
+    klarnaCustomerToken?: string;
+    sessionData?: IKlarnaSessionData;
+    externalPayerInfo?: IExternalPayerInfo;
+    shippingAddress?: IShippingAddress;
+    binData?: IBinData;
+    gocardlessMandateId?: string;
+    authorizationToken?: string;
+    hashedIdentifier?: string;
+    mcc?: string;
+    mnc?: string;
+    mx?: string;
+    currencyCode?: string;
+    productId?: string;
+}
+export interface IKlarnaSessionData {
+    recurringDescription?: string;
+    purchaseCountry?: string;
+    purchaseCurrency?: string;
+    locale?: string;
+    orderAmount?: string;
+    orderLines?: IKlarnaSessionOrderLines[];
+    billingAddress?: IKlarnaBillingAddress;
+    tokenDetails?: IKlarnaSessionDataTokenDetails;
+}
+export interface IKlarnaSessionOrderLines {
+    type?: string;
+    name?: string;
+    quantity?: number;
+    unitPrice?: number;
+    totalAmount?: number;
+    totalDiscountAmount?: number;
+}
+export interface IKlarnaBillingAddress {
+    addressLine1?: string;
+    addressLine2?: string;
+    addressLine3?: string;
+    city?: string;
+    countryCode?: string;
+    email?: string;
+    firstName?: string;
+    lastName?: string;
+    phoneNumber?: string;
+    postalCode?: string;
+    state?: string;
+    title?: string;
+}
+export interface IKlarnaSessionDataTokenDetails {
+    brand?: string;
+    maskedNumber?: string;
+    type: string;
+    expiryDate?: string;
+}
+export interface IExternalPayerInfo {
+    externalPayerId?: string;
+    email?: string;
+    firstName?: string;
+    lastName?: string;
+}
+export interface IShippingAddress {
+    firstName?: string;
+    lastName?: string;
+    addressLine1?: string;
+    addressLine2?: string;
+    city?: string;
+    state?: string;
+    countryCode?: string;
+    postalCode?: string;
+}
+export interface IBinData {
+    network?: string;
+    issuerCountryCode?: string;
+    issuerName?: string;
+    issuerCurrencyCode?: string;
+    regionalRestriction?: string;
+    accountNumberType?: string;
+    accountFundingType?: string;
+    prepaidReloadableIndicator?: string;
+    productUsageType?: string;
+    productCode?: string;
+    productName?: string;
+}

package/lib/typescript/src/models/PrimerSessionIntent.d.ts

@@ -0,0 +1,4 @@
+export declare enum PrimerSessionIntent {
+    CHECKOUT = "CHECKOUT",
+    VAULT = "VAULT"
+}

package/lib/typescript/src/models/PrimerSettings.d.ts

@@ -0,0 +1,77 @@
+import type { PrimerErrorHandler, PrimerPaymentCreationHandler, PrimerResumeHandler, PrimerTokenizationHandler } from "./PrimerInterfaces";
+import type { PrimerCheckoutData } from "./PrimerCheckoutData";
+import type { PrimerCheckoutPaymentMethodData } from "./PrimerCheckoutPaymentMethodData";
+import type { PrimerClientSession } from "./PrimerClientSession";
+import type { PrimerPaymentMethodTokenData } from "./PrimerPaymentMethodTokenData";
+import type { PrimerError } from "./PrimerError";
+import type { IPrimerTheme } from "./PrimerTheme";
+export declare type PrimerSettings = IPrimerSettings;
+interface IPrimerSettings {
+    paymentHandling?: 'AUTO' | 'MANUAL';
+    localeData?: IPrimerLocaleData;
+    paymentMethodOptions?: IPrimerPaymentMethodOptions;
+    uiOptions?: IPrimerUIOptions;
+    debugOptions?: IPrimerDebugOptions;
+    onBeforeClientSessionUpdate?: () => void;
+    onClientSessionUpdate?: (clientSession: PrimerClientSession) => void;
+    onBeforePaymentCreate?: (checkoutPaymentMethodData: PrimerCheckoutPaymentMethodData, handler: PrimerPaymentCreationHandler) => void;
+    onCheckoutComplete?: (checkoutData: PrimerCheckoutData) => void;
+    onTokenizeSuccess?: (paymentMethodTokenData: PrimerPaymentMethodTokenData, handler: PrimerTokenizationHandler) => void;
+    onResumeSuccess?: (resumeToken: string, handler: PrimerResumeHandler) => void;
+    onError?: (error: PrimerError, checkoutData: PrimerCheckoutData | null, handler: PrimerErrorHandler | undefined) => void;
+    onDismiss?: () => void;
+    onPrepareStart?: (paymentMethod: string) => void;
+    onTokenizeStart?: (paymentMethod: string) => void;
+    onPaymentMethodShow?: (paymentMethod: string) => void;
+    onAvailablePaymentMethodsLoad?: (paymentMethods: string[]) => void;
+}
+interface IPrimerLocaleData {
+    languageCode?: string;
+    localeCode?: string;
+}
+interface IPrimerPaymentMethodOptions {
+    iOS?: {
+        urlScheme?: string;
+    };
+    android?: {
+        redirectScheme?: string;
+    };
+    apayaOptions?: IPrimerApayaOptions;
+    applePayOptions?: IPrimerApplePayOptions;
+    cardPaymentOptions?: IPrimerCardPaymentOptions;
+    goCardlessOptions?: IPrimerGoCardlessOptions;
+    googlePayOptions?: IPrimerGooglePayOptions;
+    klarnaOptions?: IPrimerKlarnaOptions;
+}
+interface IPrimerApayaOptions {
+    webViewTitle: string;
+}
+interface IPrimerApplePayOptions {
+    merchantIdentifier: string;
+    merchantName: string;
+}
+interface IPrimerCardPaymentOptions {
+    is3DSOnVaultingEnabled: boolean;
+}
+interface IPrimerGoCardlessOptions {
+    businessName?: string;
+    businessAddress?: string;
+}
+interface IPrimerGooglePayOptions {
+    merchantName?: string;
+    allowedCardNetworks?: string[];
+}
+interface IPrimerKlarnaOptions {
+    recurringPaymentDescription?: string;
+    webViewTitle?: string;
+}
+interface IPrimerUIOptions {
+    isInitScreenEnabled?: boolean;
+    isSuccessScreenEnabled?: boolean;
+    isErrorScreenEnabled?: boolean;
+    theme?: IPrimerTheme;
+}
+interface IPrimerDebugOptions {
+    is3DSSanityCheckEnabled?: boolean;
+}
+export {};

package/lib/typescript/{models/primer-theme.d.ts → src/models/PrimerTheme.d.ts}

@@ -1,5 +1,5 @@
 export declare type PrimerTheme = IPrimerTheme;
-interface IPrimerTheme {
+export interface IPrimerTheme {
     colors?: ColorTheme;
     darkModeColors?: ColorTheme;
 }

package/lib/typescript/{utils → src/utils}/index.d.ts

@@ -1,3 +1,3 @@
-import type { RgbaColor } from 'src/models/primer-theme';
+import type { RgbaColor } from "../models/PrimerTheme";
 export declare function toRgbColor(hex: string): RgbaColor | null;
 export declare function parseCallback<T>(data: any, callback: (val: T) => void): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primer-io/react-native",
-  "version": "0.16.2",
+  "version": "2.1.0",
   "description": "Primer SDK for RN",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/primer-io-react-native.podspec

@@ -17,5 +17,5 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm,swift}"
 
   s.dependency "React-Core"
-  s.dependency "PrimerSDK", "1.36.1"
+  s.dependency "PrimerSDK", "2.1.0"
 end