@primer-io/react-native 2.26.3 → 2.27.0

package/lib/typescript/models/ach/AchCollectableData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AchCollectableData.d.ts","sourceRoot":"","sources":["../../../../src/models/ach/AchCollectableData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAEjF,oBAAY,kBAAkB,GAAG,6BAA6B,CAAA;AAE9D,oBAAY,6BAA6B,GAAG,YAAY,GAAG,WAAW,GAAG,eAAe,CAAA;AAExF;;GAEG;AACH,oBAAY,YAAY,GAAG;IACvB,mBAAmB,EAAE,WAAW,CAAC;IACjC,KAAK,EAAE,MAAM,CAAA;CAChB,GAAG,6BAA6B,CAAA;AAEjC;;GAEG;AACH,oBAAY,WAAW,GAAG;IACtB,mBAAmB,EAAE,UAAU,CAAC;IAChC,KAAK,EAAE,MAAM,CAAA;CAChB,GAAG,6BAA6B,CAAA;AAEjC;;GAEG;AACH,oBAAY,eAAe,GAAG;IAC1B,mBAAmB,EAAE,cAAc,CAAC;IACpC,KAAK,EAAE,MAAM,CAAA;CAChB,GAAG,6BAA6B,CAAA"}

package/lib/typescript/models/ach/AchSteps.d.ts

@@ -0,0 +1,28 @@
+import { NamedComponentStep } from "../NamedComponentStep";
+export declare type AchStep = AchUserDetailsStep;
+export declare type AchUserDetailsStep = UserDetailsRetrieved | UserDetailsCollected;
+/**
+ * A type representing the retrieved user details.
+ */
+export declare type UserDetailsRetrieved = {
+    stepName: "userDetailsRetrieved";
+    /**
+     * The first name previously sent on client session creation.
+     */
+    firstName: string;
+    /**
+     * The last name previously sent on client session creation.
+     */
+    lastName: string;
+    /**
+     * The email address previously sent on client session creation.
+     */
+    emailAddress: string;
+} & NamedComponentStep;
+/**
+ * A type representing the collected user details.
+ */
+export declare type UserDetailsCollected = {
+    stepName: "userDetailsCollected";
+} & NamedComponentStep;
+//# sourceMappingURL=AchSteps.d.ts.map

package/lib/typescript/models/ach/AchSteps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AchSteps.d.ts","sourceRoot":"","sources":["../../../../src/models/ach/AchSteps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,oBAAY,OAAO,GAAG,kBAAkB,CAAA;AAExC,oBAAY,kBAAkB,GAAG,oBAAoB,GAAG,oBAAoB,CAAA;AAE5E;;GAEG;AACH,oBAAY,oBAAoB,GAAG;IAC/B,QAAQ,EAAE,sBAAsB,CAAC;IACjC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAA;CACvB,GAAG,kBAAkB,CAAA;AAEtB;;GAEG;AACH,oBAAY,oBAAoB,GAAG;IAAE,QAAQ,EAAE,sBAAsB,CAAA;CAAE,GAAG,kBAAkB,CAAC"}

package/package.json

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

package/primer-io-react-native.podspec

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

package/src/HeadlessUniversalCheckout/Managers/PaymentMethodManagers/AchManager.ts

@@ -0,0 +1,158 @@
+import {
+    NativeEventEmitter,
+    NativeModules,
+    EmitterSubscription,
+} from 'react-native';
+import { PrimerComponentDataValidationError, PrimerInvalidComponentData, PrimerValidComponentData, PrimerValidatingComponentData } from 'src/models/PrimerComponentDataValidation';
+import { PrimerError } from 'src/models/PrimerError';
+import { EventType, eventTypes } from './Utils/EventType';
+import { AchStep, UserDetailsRetrieved } from 'src/models/ach/AchSteps';
+import { AchValidatableData } from 'src/models/ach/AchCollectableData';
+
+const { RNTPrimerHeadlessUniversalCheckoutStripeAchUserDetailsComponent } = NativeModules;
+
+const eventEmitter = new NativeEventEmitter(RNTPrimerHeadlessUniversalCheckoutStripeAchUserDetailsComponent);
+export interface AchManagerProps {
+    paymentMethodType: string;
+    onStep?: (data: AchStep) => void;
+    onError?: (error: PrimerError) => void;
+    onInvalid?: (data: PrimerInvalidComponentData<AchValidatableData>) => void;
+    onValid?: (data: PrimerValidComponentData<AchValidatableData>) => void;
+    onValidating?: (data: PrimerValidatingComponentData<AchValidatableData>) => void;
+    onValidationError?: (data: PrimerComponentDataValidationError<AchValidatableData>) => void;
+}
+
+export interface StripeAchUserDetailsComponent {
+    /**
+     * Starts the component, causing the {@link UserDetailsRetrieved} step
+     * to be emitted.
+     */
+    start(): Promise<void>;
+
+    /**
+     * Sets the customer's first name.
+     * @param value The customer's first name.
+     */
+    handleFirstNameChange(value: String): Promise<void>;
+
+    /**
+     * Sets the customer's last name.
+     * @param value The customer's last name.
+     */
+    handleLastNameChange(value: String): Promise<void>;
+
+    /**
+     * Sets the customer's email address.
+     * @param value The customer's email address.
+     */
+    handleEmailAddressChange(value: String): Promise<void>;
+
+    /**
+     * Submits the component, initiating the payment authorization process. 
+     * This function should only be called after setting the customer first name, 
+     * last name and email address.
+     */
+    submit(): Promise<void>;
+}
+
+export class PrimerHeadlessUniversalCheckoutAchManager {
+    ///////////////////////////////////////////
+    // Init
+    ///////////////////////////////////////////
+    constructor() { }
+
+    ///////////////////////////////////////////
+    // API
+    ///////////////////////////////////////////
+
+    async provide(props: AchManagerProps): Promise<StripeAchUserDetailsComponent | any> {
+        await this.configureListeners(props);
+
+        if (props.paymentMethodType == "STRIPE_ACH") {
+            const component: StripeAchUserDetailsComponent = {
+                start: async () => {
+                    RNTPrimerHeadlessUniversalCheckoutStripeAchUserDetailsComponent.start();
+                },
+                submit: async () => {
+                    RNTPrimerHeadlessUniversalCheckoutStripeAchUserDetailsComponent.submit();
+                },
+                handleFirstNameChange: async (value: String) => {
+                    RNTPrimerHeadlessUniversalCheckoutStripeAchUserDetailsComponent.onSetFirstName(value);
+                },
+                handleLastNameChange: async (value: String) => {
+                    RNTPrimerHeadlessUniversalCheckoutStripeAchUserDetailsComponent.onSetLastName(value);
+                },
+                handleEmailAddressChange: async (value: String) => {
+                    RNTPrimerHeadlessUniversalCheckoutStripeAchUserDetailsComponent.onSetEmailAddress(value);
+                }
+            }
+            await RNTPrimerHeadlessUniversalCheckoutStripeAchUserDetailsComponent.configure();
+            return component;
+        } else {
+            return null;
+        }
+    }
+
+    private async configureListeners(props: AchManagerProps): Promise<void> {
+        if (props?.onStep) {
+            this.addListener('onStep', (data) => {
+                props.onStep?.(data);
+            });
+        }
+
+        if (props?.onInvalid) {
+            this.addListener('onInvalid', (data) => {
+                props.onInvalid?.(data);
+            });
+        }
+
+        if (props?.onError) {
+            this.addListener('onError', (data) => {
+                props.onError?.(data);
+            });
+        }
+
+        if (props?.onValid) {
+            this.addListener('onValid', (data) => {
+                props.onValid?.(data);
+            });
+        }
+
+        if (props?.onValidating) {
+            this.addListener('onValidating', (data) => {
+                props.onValidating?.(data);
+            });
+        }
+
+        if (props?.onValidationError) {
+            this.addListener('onValidationError', (data) => {
+                props.onValidationError?.(data);
+            });
+        }
+    }
+
+    ///////////////////////////////////////////
+    // HELPERS
+    ///////////////////////////////////////////
+
+    async addListener(
+        eventType: EventType,
+        listener: (...args: any[]) => any
+    ): Promise<EmitterSubscription> {
+        return eventEmitter.addListener(eventType, listener);
+    }
+
+    removeListener(subscription: EmitterSubscription): void {
+        return subscription.remove();
+    }
+
+    removeAllListenersForEvent(eventType: EventType) {
+        eventEmitter.removeAllListeners(eventType);
+    }
+
+    removeAllListeners() {
+        eventTypes.forEach((eventType) =>
+            this.removeAllListenersForEvent(eventType)
+        );
+    }
+}

package/src/HeadlessUniversalCheckout/Managers/PaymentMethodManagers/AchMandateManager.ts

@@ -0,0 +1,32 @@
+import {
+    NativeModules
+} from 'react-native';
+
+const { RNTAchMandateManager } = NativeModules;
+
+export class PrimerHeadlessUniversalCheckoutAchMandateManager {
+    ///////////////////////////////////////////
+    // Init
+    ///////////////////////////////////////////
+    constructor() { }
+
+    ///////////////////////////////////////////
+    // API
+    ///////////////////////////////////////////
+
+    /**
+     * Accepts the ACH mandate, completing the payment.
+     */
+    async acceptMandate(): Promise<void> {
+        console.log("Accepting mandate");
+        await RNTAchMandateManager.acceptMandate();
+    }
+
+    /**
+     * Declines the ACH mandate, cancelling the payment.
+     */
+    async declineMandate(): Promise<void> {
+        console.log("Declining mandate");
+        await RNTAchMandateManager.declineMandate();
+    }
+}

package/src/index.tsx

@@ -76,6 +76,14 @@ import { PaymentSessionCreated, PaymentSessionAuthorized, PaymentSessionFinalize
 export { PaymentSessionCreated, PaymentSessionAuthorized, PaymentSessionFinalized, PaymentViewLoaded, KlarnaPaymentStep };
 import { PrimerKlarnaPaymentView } from './HeadlessUniversalCheckout/Components/PrimerKlarnaPaymentView'
 export { PrimerKlarnaPaymentView }
+import { UserDetailsRetrieved, UserDetailsCollected, AchStep } from './models/ach/AchSteps';
+export { UserDetailsRetrieved as CollectUserDetails, UserDetailsCollected, AchStep }
+import { AchFirstName, AchLastName, AchEmailAddress, AchValidatableData } from './models/ach/AchCollectableData';
+export { AchFirstName, AchLastName, AchEmailAddress, AchValidatableData };
+import { PrimerHeadlessUniversalCheckoutAchManager, StripeAchUserDetailsComponent, AchManagerProps } from './HeadlessUniversalCheckout/Managers/PaymentMethodManagers/AchManager';
+export { PrimerHeadlessUniversalCheckoutAchManager as AchManager, StripeAchUserDetailsComponent, AchManagerProps };
+import { PrimerHeadlessUniversalCheckoutAchMandateManager } from './HeadlessUniversalCheckout/Managers/PaymentMethodManagers/AchMandateManager';
+export { PrimerHeadlessUniversalCheckoutAchMandateManager as AchMandateManager };
 
 import { PrimerHeadlessUniversalCheckoutComponentWithRedirectManager, BanksComponent, ComponentWithRedirectManagerProps } from './HeadlessUniversalCheckout/Managers/PaymentMethodManagers/ComponentWithRedirectManager';
 export { PrimerHeadlessUniversalCheckoutComponentWithRedirectManager as ComponentWithRedirectManager, BanksComponent, ComponentWithRedirectManagerProps };

package/src/models/PrimerCheckoutAdditionalInfo.ts

@@ -1,35 +1,49 @@
 export type PrimerCheckoutAdditionalInfo = IPrimerCheckoutAdditionalInfo;
 
-interface IPrimerCheckoutAdditionalInfo {}
+interface IPrimerCheckoutAdditionalInfo {
+    /**
+     * The name of this additional info.
+     */
+    additionalInfoName: string
+}
 
-export type MultibancoCheckoutAdditionalInfo = IMultibancoCheckoutAdditionalInfo;
 
+export type MultibancoCheckoutAdditionalInfo = IMultibancoCheckoutAdditionalInfo;
 interface IMultibancoCheckoutAdditionalInfo extends IPrimerCheckoutAdditionalInfo {
     expiresAt?: string;
     entity?: string;
     reference?: string;
+    additionalInfoName: "MultibancoCheckoutAdditionalInfo";
 }
 
+
 export type PrimerCheckoutQRCodeInfo = IPrimerCheckoutQRCodeInfo;
 
 interface IPrimerCheckoutQRCodeInfo extends IPrimerCheckoutAdditionalInfo {}
 
 export type PromptPayCheckoutAdditionalInfo = IPromptPayCheckoutAdditionalInfo;
-
 interface IPromptPayCheckoutAdditionalInfo extends IPrimerCheckoutQRCodeInfo {
     expiresAt: string;
     qrCodeUrl?: string;
     qrCodeBase64?: string;
+    additionalInfoName: "PromptPayCheckoutAdditionalInfo";
 }
 
+
 export type PrimerCheckoutVoucherAdditionalInfo = IPrimerCheckoutVoucherAdditionalInfo;
 
 interface IPrimerCheckoutVoucherAdditionalInfo extends IPrimerCheckoutAdditionalInfo {}
 
-export type XenditCheckoutVoucherAdditionalInfo = IXenditCheckoutVoucherAdditionalInfo;
 
+export type XenditCheckoutVoucherAdditionalInfo = IXenditCheckoutVoucherAdditionalInfo;
 interface IXenditCheckoutVoucherAdditionalInfo extends IPrimerCheckoutVoucherAdditionalInfo {
     expiresAt: string;
     couponCode: string;
     retailerName: string;
-}
+    additionalInfoName: "XenditCheckoutVoucherAdditionalInfo";
+}
+
+
+export type DisplayStripeAchMandateAdditionalInfo = {
+    additionalInfoName: "DisplayStripeAchMandateAdditionalInfo";
+} & IPrimerCheckoutAdditionalInfo;

package/src/models/PrimerSettings.ts

@@ -85,6 +85,7 @@ interface IPrimerPaymentMethodOptions {
   googlePayOptions?: IPrimerGooglePayOptions;
   klarnaOptions?: IPrimerKlarnaOptions;
   threeDsOptions?: IPrimerThreeDsOptions;
+  stripeOptions?: IPrimerStripeOptions;
 }
 
 interface IPrimerApayaOptions {
@@ -145,3 +146,21 @@ interface IPrimerThreeDsOptions {
     threeDsAppRequestorUrl?: string;
   };
 }
+
+//----------------------------------------
+
+interface IPrimerStripeOptions {
+  publishableKey?: string;
+  mandateData?: IPrimerStripeTemplateMandateData | IPrimerFullMandateData;
+}
+
+interface IPrimerStripeMandateData {}
+
+interface IPrimerStripeTemplateMandateData extends IPrimerStripeMandateData {
+  merchantName: string;
+}
+
+interface IPrimerFullMandateData extends IPrimerStripeMandateData {
+  fullMandateText: string;
+  fullMandateStringResourceName?: string;
+}

package/src/models/ach/AchCollectableData.ts

@@ -0,0 +1,29 @@
+import { NamedComponentValidatableData } from "../NamedComponentValidatableData";
+
+export type AchValidatableData = AchUserDetailsValidatableData
+
+export type AchUserDetailsValidatableData = AchFirstName | AchLastName | AchEmailAddress
+
+/**
+ * A type representing representing the customer's first name.
+ */
+export type AchFirstName = {
+    validatableDataName: "firstName",
+    value: string
+} & NamedComponentValidatableData
+
+/**
+ * A type representing representing the customer's last name.
+ */
+export type AchLastName = {
+    validatableDataName: "lastName",
+    value: string
+} & NamedComponentValidatableData
+
+/**
+ * A type representing representing the customer's email address.
+ */
+export type AchEmailAddress = {
+    validatableDataName: "emailAddress",
+    value: string
+} & NamedComponentValidatableData

package/src/models/ach/AchSteps.ts

@@ -0,0 +1,29 @@
+import { NamedComponentStep } from "../NamedComponentStep";
+
+export type AchStep = AchUserDetailsStep
+
+export type AchUserDetailsStep = UserDetailsRetrieved | UserDetailsCollected
+
+/**
+ * A type representing the retrieved user details.
+ */
+export type UserDetailsRetrieved = {
+    stepName: "userDetailsRetrieved",
+    /**
+     * The first name previously sent on client session creation.
+     */
+    firstName: string,
+    /**
+     * The last name previously sent on client session creation.
+     */
+    lastName: string,
+    /**
+     * The email address previously sent on client session creation.
+     */
+    emailAddress: string
+} & NamedComponentStep
+
+/**
+ * A type representing the collected user details.
+ */
+export type UserDetailsCollected = { stepName: "userDetailsCollected" } & NamedComponentStep;