@fat-zebra/sdk 1.5.6 → 1.5.7-beta.0

package/dist/sandbox/fatzebra.js.LICENSE.txt

@@ -1 +1 @@
-/** @license URI.js v4.4.1 (c) 2011 Gary Court. License: http://github.com/garycourt/uri-js */
+/** @license URI.js v4.2.1 (c) 2011 Gary Court. License: http://github.com/garycourt/uri-js */

package/dist/sca/cardinal.d.ts

@@ -1,14 +1,4 @@
-interface CardinalSetupCompleteResponseData {
-    sessionId: string;
-    modules: {
-        module: string;
-        loaded: boolean;
-    }[];
-}
-interface PaymentValidatedDTO {
-    processorTransactionId: string;
-    jwt: string;
-}
+import { CardinalSetupCompleteResponseData, PaymentValidatedDTO } from "./types/cardinal_types";
 export declare const defaultConfig: {
     timeout: number;
     maxRequestRetries: number;
@@ -24,6 +14,7 @@ export default class CardinalManager {
     onPaymentValidated(handler: (data: PaymentValidatedDTO, error: string) => void): void;
     onPaymentSetupComplete(callback: (data: CardinalSetupCompleteResponseData) => void): void;
     processBin(bin: string): Promise<any>;
+    trigger(event: string, bin: string): Promise<void>;
     continue(acsUrl: string, pareq: string, transactionId: string): void;
 }
 export { CardinalManager, };

package/dist/sca/cardinal.js

@@ -7,16 +7,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var CardinalWorkflow;
-(function (CardinalWorkflow) {
-    CardinalWorkflow["CCA"] = "cca";
-    CardinalWorkflow["INIT"] = "init";
-})(CardinalWorkflow || (CardinalWorkflow = {}));
-var CardinalPaymentEvent;
-(function (CardinalPaymentEvent) {
-    CardinalPaymentEvent["SETUP_COMPLETE"] = "payments.setupComplete";
-    CardinalPaymentEvent["VALIDATED"] = "payments.validated";
-})(CardinalPaymentEvent || (CardinalPaymentEvent = {}));
+import { CardinalPaymentEvent, CardinalWorkflow } from "./types/cardinal_types";
 export const defaultConfig = {
     timeout: 8000,
     maxRequestRetries: 3,
@@ -77,6 +68,9 @@ export default class CardinalManager {
             yield window.Cardinal.trigger('bin.process', bin);
         });
     }
+    trigger(event, bin) {
+        return window.Cardinal.trigger('bin.process', bin);
+    }
     continue(acsUrl, pareq, transactionId) {
         window.Cardinal.continue(CardinalWorkflow.CCA, {
             AcsUrl: acsUrl,

package/dist/sca/index.d.ts

@@ -1,5 +1,5 @@
 import * as t from './types';
-import { EventCallback, Customer, CustomerSnakeCase, PaymentIntent } from '../shared/types';
+import { EventCallback, Customer, PaymentIntent } from '../shared/types';
 import { CardinalManager } from './cardinal';
 import GatewayClient from '../shared/api-gateway-client';
 import { Environment } from "../shared/env";
@@ -10,6 +10,16 @@ export interface ScaRunProps {
     bin: string;
     challengeWindowSize?: t.ChallengeWindowSize;
 }
+interface CustomerSnakeCase {
+    first_name?: string;
+    last_name?: string;
+    email?: string;
+    address?: string;
+    city?: string;
+    state?: string;
+    postcode?: string;
+    country?: string;
+}
 export interface ScaConfig {
     gatewayClient: GatewayClient;
     successCallback?: EventCallback | null;

package/dist/sca/index.js

@@ -8,14 +8,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as t from './types';
-import { enrollmentScenarios, validationScenarios, } from './scenarios';
 import { PublicEvent, } from '../shared/types';
 import { CardinalManager, } from './cardinal';
 import { emit, } from '../shared/event-manager';
-import { toFzSli } from './eci-mappings';
 import env, { Environment } from "../shared/env";
-import { failedEnrollmentRequestScenario } from './scenarios/enrollment';
-import { failedValidationRequestScenario } from './scenarios/validation';
+import { getEnrollmentResult, getValidationResult, threedsResponseData } from "./utility";
 class Sca {
     constructor({ gatewayClient, successCallback, failureCallback }) {
         this.gatewayClient = gatewayClient;
@@ -93,8 +90,8 @@ class Sca {
             this._cardinal.setup(cardinalJwt);
         });
     }
-    perform3DS(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ sessionID }) {
+    perform3DS({ sessionID }) {
+        return __awaiter(this, void 0, void 0, function* () {
             this.sessionId = sessionID;
             // Register handler. Called after OTP is entered on challenge prompt.
             this._cardinal.onPaymentValidated((data, error) => __awaiter(this, void 0, void 0, function* () {
@@ -223,38 +220,4 @@ class Sca {
         }
     }
 }
-const threedsResponseData = (response) => {
-    return {
-        // CAVV: Visa & Amex only
-        // AAV: Mastercard only, known as UCAF
-        cavv: response.cavv || response.aav,
-        par: response.pares,
-        sli: toFzSli(response.eci),
-        xid: response.xid,
-        ver: response.enrolled,
-        directoryServerTxnId: response.directory_server_txn_id,
-        threedsVersion: response.version,
-    };
-};
-const getEnrollmentResult = (enrollment) => {
-    const result = enrollmentScenarios.find((item) => {
-        return item.reasonCode === enrollment.reason_code &&
-            item.veresEnrolled === enrollment.enrolled &&
-            item.pares === enrollment.pares &&
-            item.threedsVersion === getMajor3dsVersion(enrollment.version);
-    });
-    return result || failedEnrollmentRequestScenario;
-};
-const getValidationResult = (validation) => {
-    const result = validationScenarios.find((item) => {
-        return item.reasonCode === validation.reason_code &&
-            item.pares === validation.pares &&
-            item.threedsVersion === getMajor3dsVersion(validation.version);
-    });
-    return result || failedValidationRequestScenario;
-};
-// 3DS versioning follows SEMVER format. The first charactor is the major version number.
-const getMajor3dsVersion = (original) => {
-    return original === null || original === void 0 ? void 0 : original[0];
-};
 export default Sca;

package/dist/sca/scenarios/enrollment.js

@@ -21,7 +21,7 @@ const enrollmentScenarios = [
         veresEnrolled: VEResEnrolled.BYPASSED,
         pares: null,
         outcome: {
-            success: false, // no liability shift
+            success: false,
             authenticationType: 'bypass',
             errorCode: ScaErrorCode.BYPASSED_AUTHENTICATION
         },
@@ -34,7 +34,7 @@ const enrollmentScenarios = [
         veresEnrolled: VEResEnrolled.UNABLE,
         pares: null,
         outcome: {
-            success: false, // no liability shift
+            success: false,
             errorCode: ScaErrorCode.AUTHENTICATION_NOT_AVAILABLE_ON_LOOKUP
         }
     },
@@ -87,6 +87,18 @@ const enrollmentScenarios = [
             success: true
         }
     },
+    {
+        // Challenge. Continue with OTP prompt
+        description: 'Challenge. Continue with OTP prompt',
+        threedsVersion: '2',
+        reasonCode: '475',
+        veresEnrolled: VEResEnrolled.ENROLLED,
+        pares: PARes.CHALLENGED,
+        outcome: {
+            authenticationType: 'challenge',
+            success: true
+        }
+    },
     {
         // Unsuccessful Frictionless Authentication
         description: 'Unsuccessful Frictionless Authentication',

package/dist/sca/scenarios/validation.js

@@ -34,7 +34,7 @@ const validationScenarios = [
         pares: PARes.CANCELED,
         outcome: {
             authenticationType: 'challenge',
-            success: false, // no liability shift
+            success: false,
             errorCode: ScaErrorCode.UNSUCCESSFUL_STEPUP_AUTHENTICATION
         }
     },
@@ -47,7 +47,7 @@ const validationScenarios = [
         pares: PARes.NOT_COMPLETED,
         outcome: {
             authenticationType: 'challenge',
-            success: false, // no liability shift
+            success: false,
             errorCode: ScaErrorCode.UNAVAILABLE_STEPUP_AUTHENTICATION
         }
     },
@@ -126,7 +126,7 @@ const validationScenarios = [
         pares: null,
         outcome: {
             authenticationType: 'challenge',
-            success: false, // no liability shift
+            success: false,
             errorCode: ScaErrorCode.UNSUCCESSFUL_STEPUP_AUTHENTICATION
         }
     },

package/dist/sca/types/cardinal_types.d.ts

@@ -0,0 +1,61 @@
+interface CardinalConfig {
+    timeout?: number;
+    maxRequestRetries?: number;
+    logging?: {
+        level: 'on' | 'off' | 'verbose';
+    };
+}
+interface CardinalContinueObject {
+    AcsUrl: string;
+    Payload: string;
+}
+interface CardinalOrderObject {
+    OrderDetails: {
+        TransactionId: string;
+    };
+}
+interface CardinalSetupCompleteResponseData {
+    sessionId: string;
+    modules: {
+        module: string;
+        loaded: boolean;
+    }[];
+}
+interface PaymentValidatedResponseData {
+    Validated: boolean;
+    ErrorNumber: number;
+    ErrorDescription: string;
+    ActionCode: 'SUCCESS' | 'NOACTION' | 'FAILURE' | 'ERROR';
+    Payment: {
+        OrderId: string;
+        OrderNumber: string;
+        ProcessorTransactionId: string;
+        ReasonDescription: string;
+    };
+}
+interface PaymentValidatedDTO {
+    processorTransactionId: string;
+    jwt: string;
+}
+interface Cardinal {
+    configure(config: CardinalConfig): void;
+    continue(workflow: CardinalWorkflow, data: CardinalContinueObject, order: CardinalOrderObject): void;
+    on(event: string, callback: (...data: any[]) => void): void;
+    setup(workflow: CardinalWorkflow, data: any): void;
+    trigger(event: string, cardBin: string): Promise<any>;
+}
+interface ScaResult {
+    success: boolean;
+    type: 'frictionless' | 'challenge' | 'none';
+    error: string;
+}
+declare enum CardinalWorkflow {
+    CCA = "cca",
+    INIT = "init"
+}
+declare enum CardinalPaymentEvent {
+    SETUP_COMPLETE = "payments.setupComplete",
+    VALIDATED = "payments.validated"
+}
+export { CardinalWorkflow, CardinalPaymentEvent };
+export type { CardinalConfig, CardinalContinueObject, CardinalOrderObject, CardinalSetupCompleteResponseData, PaymentValidatedResponseData, PaymentValidatedDTO, Cardinal, ScaResult, };

package/dist/sca/types/cardinal_types.js

@@ -0,0 +1,11 @@
+var CardinalWorkflow;
+(function (CardinalWorkflow) {
+    CardinalWorkflow["CCA"] = "cca";
+    CardinalWorkflow["INIT"] = "init";
+})(CardinalWorkflow || (CardinalWorkflow = {}));
+var CardinalPaymentEvent;
+(function (CardinalPaymentEvent) {
+    CardinalPaymentEvent["SETUP_COMPLETE"] = "payments.setupComplete";
+    CardinalPaymentEvent["VALIDATED"] = "payments.validated";
+})(CardinalPaymentEvent || (CardinalPaymentEvent = {}));
+export { CardinalWorkflow, CardinalPaymentEvent };

package/dist/sca/types.d.ts

@@ -105,7 +105,8 @@ declare enum PARes {
     CANCELED = "N",
     REJECTED = "R",
     NOT_COMPLETED = "U",
-    SUCCESS = "Y"
+    SUCCESS = "Y",
+    CHALLENGED = "C"
 }
 interface ValidateSCARequest {
     amount: number;

package/dist/sca/types.js

@@ -50,5 +50,6 @@ var PARes;
     PARes["REJECTED"] = "R";
     PARes["NOT_COMPLETED"] = "U";
     PARes["SUCCESS"] = "Y";
+    PARes["CHALLENGED"] = "C";
 })(PARes || (PARes = {}));
 export { ScaErrorCode, ChallengeWindowSize, CommerceIndicator, VEResEnrolled, PARes, };

package/dist/sca/utility/index.d.ts

@@ -0,0 +1,7 @@
+import * as t from "../types";
+import { ThreedsData } from "../types";
+import { EnrollmentScenario, ValidationScenario } from "../scenarios";
+declare const threedsResponseData: (response: t.EnrollSCAResponse | t.ValidateSCAResponse) => ThreedsData;
+declare const getEnrollmentResult: (enrollment: t.EnrollSCAResponse) => EnrollmentScenario;
+declare const getValidationResult: (validation: t.ValidateSCAResponse) => ValidationScenario;
+export { threedsResponseData, getValidationResult, getEnrollmentResult };

package/dist/sca/utility/index.js

@@ -0,0 +1,39 @@
+import { toFzSli } from "../eci-mappings";
+import { enrollmentScenarios, validationScenarios } from "../scenarios";
+import { failedEnrollmentRequestScenario } from "../scenarios/enrollment";
+import { failedValidationRequestScenario } from "../scenarios/validation";
+const threedsResponseData = (response) => {
+    return {
+        // CAVV: Visa & Amex only
+        // AAV: Mastercard only, known as UCAF
+        cavv: response.cavv || response.aav,
+        par: response.pares,
+        sli: toFzSli(response.eci),
+        xid: response.xid,
+        ver: response.enrolled,
+        directoryServerTxnId: response.directory_server_txn_id,
+        threedsVersion: response.version,
+    };
+};
+const getEnrollmentResult = (enrollment) => {
+    const result = enrollmentScenarios.find((item) => {
+        return item.reasonCode === enrollment.reason_code &&
+            item.veresEnrolled === enrollment.enrolled &&
+            item.pares === enrollment.pares &&
+            item.threedsVersion === getMajor3dsVersion(enrollment.version);
+    });
+    return result || failedEnrollmentRequestScenario;
+};
+const getValidationResult = (validation) => {
+    const result = validationScenarios.find((item) => {
+        return item.reasonCode === validation.reason_code &&
+            item.pares === validation.pares &&
+            item.threedsVersion === getMajor3dsVersion(validation.version);
+    });
+    return result || failedValidationRequestScenario;
+};
+// 3DS versioning follows SEMVER format. The first charactor is the major version number.
+const getMajor3dsVersion = (original) => {
+    return original === null || original === void 0 ? void 0 : original[0];
+};
+export { threedsResponseData, getValidationResult, getEnrollmentResult };

package/dist/shared/bridge-client.d.ts

@@ -1,2 +1,6 @@
 declare const load: (url: string) => HTMLIFrameElement;
-export { load };
+declare const load2: (url: string) => {
+    el: HTMLIFrameElement;
+    isExisting: boolean;
+};
+export { load, load2 };

package/dist/shared/bridge-client.js

@@ -17,4 +17,22 @@ const load = (url) => {
     document.body.appendChild(headless);
     return headless;
 };
-export { load };
+const load2 = (url) => {
+    const existing = document.getElementById(headlessIframeId);
+    if (existing) {
+        return { el: existing, isExisting: true };
+    }
+    const headless = document.createElement('iframe');
+    headless.style.visibility = 'hidden';
+    headless.style.position = 'absolute';
+    headless.style.left = '0px';
+    headless.style.top = '0px';
+    headless.style.height = '0px';
+    headless.style.width = '0px';
+    headless.style.border = 'none';
+    headless.setAttribute('src', url);
+    headless.setAttribute('id', headlessIframeId);
+    document.body.appendChild(headless);
+    return { el: headless, isExisting: false };
+};
+export { load, load2 };

package/dist/shared/envs/local.d.ts

@@ -1,5 +1,5 @@
 declare const bridgeUrl = "https://paynow.test";
-declare const apiUrl = "https://api.test:3002/sdk";
+declare const apiUrl = "https://api.test/sdk";
 declare const payNowUrl = "https://paynow.test";
 declare const songbirdUrl = "https://songbirdstag.cardinalcommerce.com/edge/v1/songbird.js";
 export { bridgeUrl, apiUrl, payNowUrl, songbirdUrl };

package/dist/shared/envs/local.js

@@ -1,5 +1,5 @@
 const bridgeUrl = "https://paynow.test";
-const apiUrl = "https://api.test:3002/sdk";
+const apiUrl = "https://api.test/sdk";
 const payNowUrl = "https://paynow.test";
 const songbirdUrl = "https://songbirdstag.cardinalcommerce.com/edge/v1/songbird.js";
 export { bridgeUrl, apiUrl, payNowUrl, songbirdUrl };

package/dist/shared/types.d.ts

@@ -19,7 +19,9 @@ declare enum PublicEvent {
     CLICK_TO_PAY_TOKENIZATION_ERROR = "fz.click_to_pay.tokenization.error",
     CLICK_TO_PAY_RESIZE = "fz.click_to_pay.resize",
     CLICK_TO_PAY_DCF_LOADED = "fz.click_to_pay.dcf",
-    CLICK_TO_PAY_MRT = "fz.click_to_pay.mrt"
+    CLICK_TO_PAY_MRT = "fz.click_to_pay.mrt",
+    CLICK_TO_PAY_INITIAL_MRT_REQUEST = "fz.click_to_pay.initial_mrt_req",
+    CLICK_TO_PAY_INITIAL_MRT_RESPONSE = "fz.click_to_pay.initial_mrt_res"
 }
 declare enum BridgeEvent {
     TOKENIZE_CARD_REQUEST = "fzi.tc_req",
@@ -30,9 +32,7 @@ declare enum BridgeEvent {
     FORM_VALIDATION_ERROR = "fzi.form_validation_error",
     FORM_VALIDATION_SUCCESS = "fzi.form_validation_success",
     BIN_LOOKUP = "fzi.bin_lookup",
-    CLICK_TO_PAY_TOKENIZATION = "fzi.c2p.tc_res",
-    CLICK_TO_PAY_REQUEST_MRT = "fzi.c2p.mrt_req",
-    CLICK_TO_PAY_RETURN_MRT = "fzi.c2p.mrt_ret"
+    CLICK_TO_PAY_TOKENIZATION = "fzi.c2p.tc_res"
 }
 declare enum PaymentMethodType {
     CARD = "card",
@@ -58,16 +58,6 @@ interface Customer {
     state?: string;
     country?: string;
 }
-interface CustomerSnakeCase {
-    first_name?: string;
-    last_name?: string;
-    email?: string;
-    address?: string;
-    city?: string;
-    state?: string;
-    postcode?: string;
-    country?: string;
-}
 interface Payment {
     amount: number;
     currency: string;
@@ -163,4 +153,4 @@ type ApplePayPaymentResponse = {
     data?: string;
 };
 export { Channel, BridgeEvent, PublicEvent, PaymentMethodType, };
-export type { PaymentMethod, PaymentIntent, Payment, Card, CardOnFile, CustomerSnakeCase, Customer, Handlers, ValidationResult, TokenizeCardResponse, ApplePayPaymentResponse };
+export type { PaymentMethod, PaymentIntent, Payment, Card, CardOnFile, Customer, Handlers, ValidationResult, TokenizeCardResponse, ApplePayPaymentResponse };

package/dist/shared/types.js

@@ -20,6 +20,8 @@ var PublicEvent;
     PublicEvent["CLICK_TO_PAY_RESIZE"] = "fz.click_to_pay.resize";
     PublicEvent["CLICK_TO_PAY_DCF_LOADED"] = "fz.click_to_pay.dcf";
     PublicEvent["CLICK_TO_PAY_MRT"] = "fz.click_to_pay.mrt";
+    PublicEvent["CLICK_TO_PAY_INITIAL_MRT_REQUEST"] = "fz.click_to_pay.initial_mrt_req";
+    PublicEvent["CLICK_TO_PAY_INITIAL_MRT_RESPONSE"] = "fz.click_to_pay.initial_mrt_res";
 })(PublicEvent || (PublicEvent = {}));
 var BridgeEvent;
 (function (BridgeEvent) {
@@ -32,8 +34,6 @@ var BridgeEvent;
     BridgeEvent["FORM_VALIDATION_SUCCESS"] = "fzi.form_validation_success";
     BridgeEvent["BIN_LOOKUP"] = "fzi.bin_lookup";
     BridgeEvent["CLICK_TO_PAY_TOKENIZATION"] = "fzi.c2p.tc_res";
-    BridgeEvent["CLICK_TO_PAY_REQUEST_MRT"] = "fzi.c2p.mrt_req";
-    BridgeEvent["CLICK_TO_PAY_RETURN_MRT"] = "fzi.c2p.mrt_ret";
 })(BridgeEvent || (BridgeEvent = {}));
 var PaymentMethodType;
 (function (PaymentMethodType) {