globalpayments-api 3.5.1 → 3.6.0

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

@@ -0,0 +1,8 @@
+export * from "./Abstractions";
+export * from "./ConnectionConfig";
+export * from "./DeviceInterface";
+export * from "./DeviceResponse";
+export * from "./DeviceMessage";
+export * from "./SummaryResponse";
+export * from "./TerminalResponse";
+export * from "./UPA";

package/lib/src/Terminals/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Abstractions"), exports);
+__exportStar(require("./ConnectionConfig"), exports);
+__exportStar(require("./DeviceInterface"), exports);
+__exportStar(require("./DeviceResponse"), exports);
+__exportStar(require("./DeviceMessage"), exports);
+__exportStar(require("./SummaryResponse"), exports);
+__exportStar(require("./TerminalResponse"), exports);
+__exportStar(require("./UPA"), exports);
+//# sourceMappingURL=index.js.map

package/lib/src/Terminals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Terminals/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,qDAAmC;AACnC,oDAAkC;AAClC,mDAAiC;AACjC,kDAAgC;AAChC,oDAAkC;AAClC,qDAAmC;AACnC,wCAAsB"}

package/lib/src/Utils/CardUtils.d.ts

@@ -0,0 +1,13 @@
+import { Card } from "../../src/Entities/GpApi/DTO";
+import { AuthorizationBuilder, PaymentMethod } from "../../src";
+export declare class CardUtils {
+    private static trackOnePattern;
+    private static trackTwoPattern;
+    private static fleetBinMap;
+    private static cardTypes;
+    static generateCard(builder: AuthorizationBuilder, gatewayProvider: any, maskedValues: Record<string, string>): Card;
+    static getCvvIndicator(cvnPresenceIndicator: number): string;
+    static parseTrackData(paymentMethod: PaymentMethod): PaymentMethod;
+    static getCardType(number: string): string;
+    static isFleet(cardType: string, pan: string): boolean;
+}

package/lib/src/Utils/CardUtils.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardUtils = void 0;
+const DTO_1 = require("../../src/Entities/GpApi/DTO");
+const src_1 = require("../../src");
+class CardUtils {
+    static trackOnePattern = /%?[B0]?([\d]+)\\^[^\\^]+\\^([\\d]{4})([^?]+)?/;
+    static trackTwoPattern = /;?([\d]+)=([\d]{4})([^?]+)?/;
+    static fleetBinMap = {
+        Visa: [
+            ["448460", "448611"],
+            ["448613", "448615"],
+            ["448617", "448674"],
+            ["448676", "448686"],
+            ["448688", "448699"],
+            ["461400", "461421"],
+            ["461423", "461499"],
+            ["480700", "480899"],
+        ],
+        MC: [
+            ["553231", "553380"],
+            ["556083", "556099"],
+            ["556100", "556599"],
+            ["556700", "556999"],
+        ],
+        Wex: [
+            ["690046", "690046"],
+            ["707138", "707138"],
+        ],
+        Voyager: [["708885", "708889"]],
+    };
+    static cardTypes = {
+        Visa: /^4/,
+        MC: /^(?:5[1-6]|222[1-9]|22[3-9][0-9]|2[3-6][0-9]{2}|27[01][0-9]|2720)/,
+        Amex: /^3[47]/,
+        DinersClub: /^3(?:0[0-5]|[68][0-9])/,
+        EnRoute: /^2(014|149)/,
+        Discover: /^6(?:011|5[0-9]{2})/,
+        Jcb: /^(?:2131|1800|35\d{3})/,
+        Wex: /^(?:690046|707138)/,
+        Voyager: /^70888[5-9]/,
+    };
+    static generateCard(builder, gatewayProvider, maskedValues) {
+        const paymentMethod = builder.paymentMethod;
+        const transactionType = builder.transactionType;
+        const card = new DTO_1.Card();
+        if (paymentMethod instanceof src_1.CreditTrackData ||
+            paymentMethod instanceof src_1.DebitTrackData) {
+            card.track = paymentMethod.value;
+            if (transactionType === src_1.TransactionType.Sale) {
+                if (!card.track) {
+                    card.number = paymentMethod.pan;
+                    maskedValues = {
+                        ...maskedValues,
+                        ...src_1.ProtectSensitiveData.hideValue("payment_method.card.number", paymentMethod.pan, 4),
+                    };
+                    if (paymentMethod.expiry) {
+                        card.expiry_month = paymentMethod.expiry.substring(2, 4);
+                        card.expiry_year = paymentMethod.expiry.substring(0, 2);
+                        maskedValues = {
+                            ...maskedValues,
+                            ...src_1.ProtectSensitiveData.hideValues({
+                                "payment_method.card.expiry_month": card.expiry_month,
+                                "payment_method.card.expiry_year": card.expiry_year,
+                            }),
+                        };
+                    }
+                }
+                if ((builder.transactionType === src_1.TransactionType.Sale ||
+                    builder.transactionType === src_1.TransactionType.Refund) &&
+                    !builder.tagData) {
+                    card.chip_condition = src_1.EnumMapping.mapEmvLastChipRead(gatewayProvider, builder.emvChipCondition);
+                }
+                if (builder.transactionType === src_1.TransactionType.Sale) {
+                    card.funding =
+                        builder.paymentMethod.paymentMethodType === src_1.PaymentMethodType.Debit
+                            ? "DEBIT"
+                            : "CREDIT";
+                }
+            }
+        }
+        else if (builder.paymentMethod instanceof src_1.CreditCardData) {
+            card.number = paymentMethod.number;
+            maskedValues = {
+                ...maskedValues,
+                ...src_1.ProtectSensitiveData.hideValue("payment_method.card.number", paymentMethod.number, 4, 6),
+            };
+            if (paymentMethod.expMonth) {
+                card.expiry_month = paymentMethod.expMonth.toString().padStart(2, "0");
+                maskedValues = {
+                    ...maskedValues,
+                    ...src_1.ProtectSensitiveData.hideValue("payment_method.card.expiry_month", card.expiry_month),
+                };
+            }
+            if (paymentMethod.expYear) {
+                card.expiry_year = paymentMethod.expYear
+                    .toString()
+                    .padStart(4, "0")
+                    .substring(2, 4);
+                maskedValues = {
+                    ...maskedValues,
+                    ...src_1.ProtectSensitiveData.hideValue("payment_method.card.expiry_year", card.expiry_year),
+                };
+            }
+            if (paymentMethod.cvn) {
+                card.cvv = paymentMethod.cvn;
+                maskedValues = {
+                    ...maskedValues,
+                    ...src_1.ProtectSensitiveData.hideValue("payment_method.card.cvv", paymentMethod.cvn),
+                };
+                const cvnPresenceIndicator = paymentMethod.cvn
+                    ? src_1.CvnPresenceIndicator.Present
+                    : paymentMethod.cvnPresenceIndicator
+                        ? paymentMethod.cvnPresenceIndicator
+                        : "";
+                card.cvv_indicator = CardUtils.getCvvIndicator(cvnPresenceIndicator);
+            }
+            if (builder.emvChipCondition && !builder.tagData) {
+                card.chip_condition = src_1.EnumMapping.mapEmvLastChipRead(gatewayProvider, builder.emvChipCondition);
+            }
+        }
+        if (builder.paymentMethod.isPinProtected) {
+            card.pin_block = builder.paymentMethod.pinBlock;
+        }
+        const billingAddress = builder.billingAddress
+            ? builder.billingAddress.streetAddress1
+            : undefined;
+        const postalCode = builder.billingAddress
+            ? builder.billingAddress.postalCode
+            : undefined;
+        card.tag = builder.tagData;
+        card.avs_address = billingAddress;
+        card.avs_postal_code = postalCode;
+        card.authcode = builder.offlineAuthCode;
+        maskedValues;
+        return card;
+    }
+    static getCvvIndicator(cvnPresenceIndicator) {
+        let cvvIndicator;
+        switch (cvnPresenceIndicator) {
+            case 1:
+                cvvIndicator = "PRESENT";
+                break;
+            case 2:
+                cvvIndicator = "ILLEGIBLE";
+                break;
+            case 3:
+                cvvIndicator = "NOT_ON_CARD";
+                break;
+            default:
+                cvvIndicator = "NOT_PRESENT";
+                break;
+        }
+        return cvvIndicator;
+    }
+    static parseTrackData(paymentMethod) {
+        const trackData = paymentMethod.value;
+        const trackTwoPattern = new RegExp(CardUtils.trackTwoPattern);
+        const trackOnePattern = new RegExp(CardUtils.trackOnePattern);
+        let matches;
+        matches = trackTwoPattern.exec(trackData);
+        if (matches && matches[1] && matches[2]) {
+            const pan = matches[1];
+            const expiry = matches[2];
+            let discretionary = matches[3] || null;
+            if (discretionary) {
+                if ((pan + expiry + discretionary).length === 37 &&
+                    discretionary.toLowerCase().endsWith("f")) {
+                    discretionary = discretionary.substring(0, discretionary.length - 1);
+                }
+                paymentMethod.discretionaryData = discretionary;
+            }
+            paymentMethod.trackNumber = src_1.TrackNumber.TRACK_TWO;
+            paymentMethod.pan = pan;
+            paymentMethod.expiry = expiry;
+            paymentMethod.trackData = `${pan}=${expiry}${discretionary}?`;
+        }
+        else {
+            matches = trackOnePattern.exec(trackData);
+            if (matches && matches[1] && matches[2]) {
+                paymentMethod.trackNumber = src_1.TrackNumber.TRACK_ONE;
+                paymentMethod.pan = matches[1];
+                paymentMethod.expiry = matches[2];
+                paymentMethod.trackData = matches[0].replace("%", "");
+            }
+        }
+        return paymentMethod;
+    }
+    static getCardType(number) {
+        number = number.replace(/[ -]/g, "");
+        let rvalue = "Unknown";
+        for (const [type, regex] of Object.entries(CardUtils.cardTypes)) {
+            if (regex.test(number)) {
+                rvalue = type;
+            }
+        }
+        if (rvalue !== "Unknown") {
+            if (CardUtils.isFleet(rvalue, number)) {
+                rvalue += "Fleet";
+            }
+        }
+        return rvalue;
+    }
+    static isFleet(cardType, pan) {
+        if (pan !== "") {
+            const compareValue = pan.substring(0, 6);
+            const baseCardType = cardType.replace("Fleet", "");
+            if (CardUtils.fleetBinMap[baseCardType]) {
+                const binRanges = CardUtils.fleetBinMap[baseCardType];
+                for (const [lowerRange, upperRange] of binRanges) {
+                    if (compareValue >= lowerRange && compareValue <= upperRange) {
+                        return true;
+                    }
+                }
+            }
+        }
+        return false;
+    }
+}
+exports.CardUtils = CardUtils;
+//# sourceMappingURL=CardUtils.js.map

package/lib/src/Utils/CardUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CardUtils.js","sourceRoot":"","sources":["../../../src/Utils/CardUtils.ts"],"names":[],"mappings":";;;AAAA,sDAAoD;AACpD,mCAYmB;AAEnB,MAAa,SAAS;IACZ,MAAM,CAAC,eAAe,GAC5B,+CAA+C,CAAC;IAC1C,MAAM,CAAC,eAAe,GAAG,6BAA6B,CAAC;IAEvD,MAAM,CAAC,WAAW,GAA0C;QAClE,IAAI,EAAE;YACJ,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACpB,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACpB,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACpB,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACpB,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACpB,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACpB,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACpB,CAAC,QAAQ,EAAE,QAAQ,CAAC;SACrB;QACD,EAAE,EAAE;YACF,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACpB,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACpB,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACpB,CAAC,QAAQ,EAAE,QAAQ,CAAC;SACrB;QACD,GAAG,EAAE;YACH,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACpB,CAAC,QAAQ,EAAE,QAAQ,CAAC;SACrB;QACD,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;KAChC,CAAC;IAEM,MAAM,CAAC,SAAS,GAA8B;QACpD,IAAI,EAAE,IAAI;QACV,EAAE,EAAE,mEAAmE;QACvE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,wBAAwB;QACpC,OAAO,EAAE,aAAa;QACtB,QAAQ,EAAE,qBAAqB;QAC/B,GAAG,EAAE,wBAAwB;QAC7B,GAAG,EAAE,oBAAoB;QACzB,OAAO,EAAE,aAAa;KACvB,CAAC;IAEK,MAAM,CAAC,YAAY,CACxB,OAA6B,EAC7B,eAAoB,EACpB,YAAoC;QAEpC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC5C,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAEhD,MAAM,IAAI,GAAG,IAAI,UAAI,EAAE,CAAC;QAExB,IACE,aAAa,YAAY,qBAAe;YACxC,aAAa,YAAY,oBAAc,EACvC;YACA,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;YACjC,IAAI,eAAe,KAAK,qBAAe,CAAC,IAAI,EAAE;gBAC5C,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE;oBACf,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC;oBAChC,YAAY,GAAG;wBACb,GAAG,YAAY;wBACf,GAAG,0BAAoB,CAAC,SAAS,CAC/B,4BAA4B,EAC5B,aAAa,CAAC,GAAG,EACjB,CAAC,CACF;qBACF,CAAC;oBACF,IAAI,aAAa,CAAC,MAAM,EAAE;wBACxB,IAAI,CAAC,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;wBACzD,IAAI,CAAC,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;wBACxD,YAAY,GAAG;4BACb,GAAG,YAAY;4BACf,GAAG,0BAAoB,CAAC,UAAU,CAAC;gCACjC,kCAAkC,EAAE,IAAI,CAAC,YAAY;gCACrD,iCAAiC,EAAE,IAAI,CAAC,WAAW;6BACpD,CAAC;yBACH,CAAC;qBACH;iBACF;gBACD,IACE,CAAC,OAAO,CAAC,eAAe,KAAK,qBAAe,CAAC,IAAI;oBAC/C,OAAO,CAAC,eAAe,KAAK,qBAAe,CAAC,MAAM,CAAC;oBACrD,CAAC,OAAO,CAAC,OAAO,EAChB;oBACA,IAAI,CAAC,cAAc,GAAG,iBAAW,CAAC,kBAAkB,CAClD,eAAe,EACf,OAAO,CAAC,gBAAgB,CACzB,CAAC;iBACH;gBAED,IAAI,OAAO,CAAC,eAAe,KAAK,qBAAe,CAAC,IAAI,EAAE;oBACpD,IAAI,CAAC,OAAO;wBACV,OAAO,CAAC,aAAa,CAAC,iBAAiB,KAAK,uBAAiB,CAAC,KAAK;4BACjE,CAAC,CAAC,OAAO;4BACT,CAAC,CAAC,QAAQ,CAAC;iBAChB;aACF;SACF;aAAM,IAAI,OAAO,CAAC,aAAa,YAAY,oBAAc,EAAE;YAC1D,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;YACnC,YAAY,GAAG;gBACb,GAAG,YAAY;gBACf,GAAG,0BAAoB,CAAC,SAAS,CAC/B,4BAA4B,EAC5B,aAAa,CAAC,MAAM,EACpB,CAAC,EACD,CAAC,CACF;aACF,CAAC;YAEF,IAAI,aAAa,CAAC,QAAQ,EAAE;gBAC1B,IAAI,CAAC,YAAY,GAAG,aAAa,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBACvE,YAAY,GAAG;oBACb,GAAG,YAAY;oBACf,GAAG,0BAAoB,CAAC,SAAS,CAC/B,kCAAkC,EAClC,IAAI,CAAC,YAAY,CAClB;iBACF,CAAC;aACH;YACD,IAAI,aAAa,CAAC,OAAO,EAAE;gBACzB,IAAI,CAAC,WAAW,GAAG,aAAa,CAAC,OAAO;qBACrC,QAAQ,EAAE;qBACV,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;qBAChB,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACnB,YAAY,GAAG;oBACb,GAAG,YAAY;oBACf,GAAG,0BAAoB,CAAC,SAAS,CAC/B,iCAAiC,EACjC,IAAI,CAAC,WAAW,CACjB;iBACF,CAAC;aACH;YACD,IAAI,aAAa,CAAC,GAAG,EAAE;gBACrB,IAAI,CAAC,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC;gBAC7B,YAAY,GAAG;oBACb,GAAG,YAAY;oBACf,GAAG,0BAAoB,CAAC,SAAS,CAC/B,yBAAyB,EACzB,aAAa,CAAC,GAAG,CAClB;iBACF,CAAC;gBACF,MAAM,oBAAoB,GAAG,aAAa,CAAC,GAAG;oBAC5C,CAAC,CAAC,0BAAoB,CAAC,OAAO;oBAC9B,CAAC,CAAC,aAAa,CAAC,oBAAoB;wBACpC,CAAC,CAAC,aAAa,CAAC,oBAAoB;wBACpC,CAAC,CAAC,EAAE,CAAC;gBACP,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC;aACtE;YACD,IAAI,OAAO,CAAC,gBAAgB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;gBAChD,IAAI,CAAC,cAAc,GAAG,iBAAW,CAAC,kBAAkB,CAClD,eAAe,EACf,OAAO,CAAC,gBAAgB,CACzB,CAAC;aACH;SACF;QAED,IAAI,OAAO,CAAC,aAAa,CAAC,cAAc,EAAE;YACxC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC;SACjD;QAED,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc;YAC3C,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,cAAc;YACvC,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc;YACvC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,UAAU;YACnC,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,cAAc,CAAC;QAClC,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;QAExC,YAAY,CAAC;QAEb,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,oBAA4B;QACxD,IAAI,YAAoB,CAAC;QACzB,QAAQ,oBAAoB,EAAE;YAC5B,KAAK,CAAC;gBACJ,YAAY,GAAG,SAAS,CAAC;gBACzB,MAAM;YACR,KAAK,CAAC;gBACJ,YAAY,GAAG,WAAW,CAAC;gBAC3B,MAAM;YACR,KAAK,CAAC;gBACJ,YAAY,GAAG,aAAa,CAAC;gBAC7B,MAAM;YACR;gBACE,YAAY,GAAG,aAAa,CAAC;gBAC7B,MAAM;SACT;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,aAA4B;QAChD,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC;QACtC,MAAM,eAAe,GAAW,IAAI,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACtE,MAAM,eAAe,GAAW,IAAI,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACtE,IAAI,OAA+B,CAAC;QAEpC,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE;YACvC,MAAM,GAAG,GAAW,OAAO,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAW,OAAO,CAAC,CAAC,CAAC,CAAC;YAClC,IAAI,aAAa,GAAkB,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;YAEtD,IAAI,aAAa,EAAE;gBACjB,IACE,CAAC,GAAG,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC,MAAM,KAAK,EAAE;oBAC5C,aAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EACzC;oBACA,aAAa,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;iBACtE;gBAED,aAAa,CAAC,iBAAiB,GAAG,aAAa,CAAC;aACjD;YAED,aAAa,CAAC,WAAW,GAAG,iBAAW,CAAC,SAAS,CAAC;YAClD,aAAa,CAAC,GAAG,GAAG,GAAG,CAAC;YACxB,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC;YAC9B,aAAa,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,MAAM,GAAG,aAAa,GAAG,CAAC;SAC/D;aAAM;YACL,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC1C,IAAI,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE;gBACvC,aAAa,CAAC,WAAW,GAAG,iBAAW,CAAC,SAAS,CAAC;gBAClD,aAAa,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC/B,aAAa,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBAElC,aAAa,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;aACvD;SACF;QAED,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,MAAc;QAC/B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAErC,IAAI,MAAM,GAAW,SAAS,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE;YAC/D,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;gBACtB,MAAM,GAAG,IAAI,CAAC;aACf;SACF;QACD,IAAI,MAAM,KAAK,SAAS,EAAE;YACxB,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;gBACrC,MAAM,IAAI,OAAO,CAAC;aACnB;SACF;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,QAAgB,EAAE,GAAW;QAC1C,IAAI,GAAG,KAAK,EAAE,EAAE;YACd,MAAM,YAAY,GAAW,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACjD,MAAM,YAAY,GAAW,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAE3D,IAAI,SAAS,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE;gBACvC,MAAM,SAAS,GACb,SAAS,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;gBACtC,KAAK,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,SAAS,EAAE;oBAChD,IAAI,YAAY,IAAI,UAAU,IAAI,YAAY,IAAI,UAAU,EAAE;wBAC5D,OAAO,IAAI,CAAC;qBACb;iBACF;aACF;SACF;QACD,OAAO,KAAK,CAAC;IACf,CAAC;;AA/QH,8BAgRC"}

package/lib/src/Utils/CountryUtils.d.ts

@@ -0,0 +1,9 @@
+export declare class CountryUtils {
+    static SIGNIFICANT_COUNTRY_MATCH: number;
+    static SIGNIFICANT_CODE_MATCH: number;
+    static getCountryInfo(country: string): any | null;
+    static getCountryCodeByCountry(country: string): string | null;
+    static fuzzyMatch(dict: string[], query: string, significantMatch: number): number | null;
+    static fuzzyScore(term: string, query: string): number;
+    static getNumericCodeByCountry(country: string): string | null;
+}

package/lib/src/Utils/CountryUtils.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CountryUtils = void 0;
+const src_1 = require("../../src");
+class CountryUtils {
+    static SIGNIFICANT_COUNTRY_MATCH = 6;
+    static SIGNIFICANT_CODE_MATCH = 3;
+    static getCountryInfo(country) {
+        if (!country) {
+            return null;
+        }
+        const countryCodeMapByCountry = src_1.IsoCountries.allCountries.map((country) => country.name);
+        const countryMapByCode = src_1.IsoCountries.allCountries.map((country) => country.alpha2);
+        const countryMapByNumericCode = src_1.IsoCountries.allCountries.map((country) => country.numeric);
+        let index;
+        if ((index = countryCodeMapByCountry.indexOf(country)) !== -1) {
+            return src_1.IsoCountries.allCountries[index];
+        }
+        else {
+            if ((index = countryCodeMapByCountry.indexOf(country)) !== -1) {
+                return src_1.IsoCountries.allCountries[index];
+            }
+            else {
+                if ((index = countryMapByNumericCode.indexOf(country)) !== -1) {
+                    return src_1.IsoCountries.allCountries[index];
+                }
+                else {
+                    const fuzzyCountryMatch = CountryUtils.fuzzyMatch(countryCodeMapByCountry, country, CountryUtils.SIGNIFICANT_COUNTRY_MATCH);
+                    if (fuzzyCountryMatch !== null) {
+                        return src_1.IsoCountries.allCountries[fuzzyCountryMatch];
+                    }
+                    else {
+                        if (country.length > 3) {
+                            return null;
+                        }
+                        const fuzzyCodeMatch = CountryUtils.fuzzyMatch(countryMapByCode, country, CountryUtils.SIGNIFICANT_CODE_MATCH);
+                        if (fuzzyCodeMatch !== null) {
+                            return src_1.IsoCountries.allCountries[fuzzyCodeMatch];
+                        }
+                        return null;
+                    }
+                }
+            }
+        }
+    }
+    static getCountryCodeByCountry(country) {
+        if (!country) {
+            return null;
+        }
+        const countryCodeMapByCountry = src_1.IsoCountries.allCountries.map((country) => country.name);
+        const countryMapByCode = src_1.IsoCountries.allCountries.map((country) => country.alpha2);
+        const countryMapByNumericCode = src_1.IsoCountries.allCountries.map((country) => country.numeric);
+        const index = countryCodeMapByCountry.findIndex((name) => name === country);
+        if (index !== -1) {
+            return src_1.IsoCountries.allCountries[index].alpha2;
+        }
+        const index2 = countryCodeMapByCountry.findIndex((name) => name === country);
+        if (index2 !== -1) {
+            return country;
+        }
+        const index3 = countryMapByNumericCode.findIndex((code) => code === country);
+        if (index3 !== -1) {
+            return src_1.IsoCountries.allCountries[index3].alpha2;
+        }
+        const fuzzyCountryMatch = this.fuzzyMatch(countryCodeMapByCountry, country, this.SIGNIFICANT_COUNTRY_MATCH);
+        if (fuzzyCountryMatch !== null) {
+            return src_1.IsoCountries.allCountries[fuzzyCountryMatch].alpha2;
+        }
+        if (country.length > 3) {
+            return null;
+        }
+        const fuzzyCodeMatch = this.fuzzyMatch(countryMapByCode, country, this.SIGNIFICANT_CODE_MATCH);
+        if (fuzzyCodeMatch !== null) {
+            return src_1.IsoCountries.allCountries[fuzzyCodeMatch].alpha2;
+        }
+        return null;
+    }
+    static fuzzyMatch(dict, query, significantMatch) {
+        let rkey = null;
+        let matches = {};
+        let highScore = -1;
+        dict.forEach((value, key) => {
+            const score = this.fuzzyScore(value, query);
+            if (score > significantMatch && score > highScore) {
+                matches = {};
+                highScore = score;
+                rkey = key;
+                matches[rkey] = value;
+            }
+            else if (score === highScore) {
+                matches[key] = value;
+            }
+        });
+        if (Object.keys(matches).length > 1) {
+            return null;
+        }
+        return rkey;
+    }
+    static fuzzyScore(term, query) {
+        if (!term || !query) {
+            throw new Error("Strings must not be null");
+        }
+        const termLowerCase = term.toLowerCase();
+        const queryLowerCase = query.toLowerCase();
+        let score = 0;
+        let termIndex = 0;
+        let previousMatchingCharacterIndex = Number.MIN_SAFE_INTEGER;
+        for (let queryIndex = 0; queryIndex < queryLowerCase.length; queryIndex++) {
+            const queryChar = queryLowerCase[queryIndex];
+            let termCharacterMatchFound = false;
+            for (; termIndex < termLowerCase.length && !termCharacterMatchFound; termIndex++) {
+                const termChar = termLowerCase[termIndex];
+                if (queryChar === termChar) {
+                    score++;
+                    if (previousMatchingCharacterIndex + 1 === termIndex) {
+                        score += 2;
+                    }
+                    previousMatchingCharacterIndex = termIndex;
+                    termCharacterMatchFound = true;
+                }
+            }
+        }
+        return score;
+    }
+    static getNumericCodeByCountry(country) {
+        const countryInfo = CountryUtils.getCountryInfo(country);
+        return countryInfo && countryInfo.numeric ? countryInfo.numeric : null;
+    }
+}
+exports.CountryUtils = CountryUtils;
+//# sourceMappingURL=CountryUtils.js.map

package/lib/src/Utils/CountryUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CountryUtils.js","sourceRoot":"","sources":["../../../src/Utils/CountryUtils.ts"],"names":[],"mappings":"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"}

package/lib/src/Utils/GenerationUtils.d.ts

@@ -0,0 +1,6 @@
+export declare class GenerationUtils {
+    static generateHash(toHash: string, secret?: string): string;
+    static generateTimestamp(): string;
+    static generateOrderId(): string;
+    static getGuuid(): string;
+}

package/lib/src/Utils/GenerationUtils.js

@@ -0,0 +1,79 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerationUtils = void 0;
+const Sha1_1 = require("./Sha1");
+const crypto = __importStar(require("crypto"));
+const __1 = require("../");
+class GenerationUtils {
+    static generateHash(toHash, secret) {
+        const toHashFirstPass = (0, Sha1_1.hex_sha1)(toHash);
+        if (!secret) {
+            return toHashFirstPass;
+        }
+        const toHashSecondPass = `${toHashFirstPass}.${secret}`;
+        return (0, Sha1_1.hex_sha1)(toHashSecondPass);
+    }
+    static generateTimestamp() {
+        const date = new Date();
+        return (date.getUTCFullYear().toString() +
+            __1.StringUtils.leftPad((date.getUTCMonth() + 1).toString(), 2, "0") +
+            __1.StringUtils.leftPad(date.getUTCDate().toString(), 2, "0") +
+            __1.StringUtils.leftPad(date.getUTCHours().toString(), 2, "0") +
+            __1.StringUtils.leftPad(date.getUTCMinutes().toString(), 2, "0") +
+            __1.StringUtils.leftPad(date.getUTCSeconds().toString(), 2, "0"));
+    }
+    static generateOrderId() {
+        const id = __1.StringUtils.uuid();
+        return Buffer.from(id, "ascii")
+            .toString("base64")
+            .replace("=", "")
+            .replace("+", "-")
+            .replace("/", "_");
+    }
+    static getGuuid() {
+        function bin2hex(buffer) {
+            return Array.prototype.map
+                .call(buffer, (byte) => {
+                return ("0" + (byte & 0xff).toString(16)).slice(-2);
+            })
+                .join("");
+        }
+        const data = crypto.getRandomValues(new Uint8Array(16));
+        data[6] = (data[6] & 0x0f) | 0x40; // set version to 0100
+        data[8] = (data[8] & 0x3f) | 0x80; // set bits 6-7 to 10
+        const hexString = bin2hex(data);
+        const formattedUUID = [
+            hexString.slice(0, 8),
+            hexString.slice(8, 12),
+            hexString.slice(12, 16),
+            hexString.slice(16, 20),
+            hexString.slice(20),
+        ].join("-");
+        return formattedUUID;
+    }
+}
+exports.GenerationUtils = GenerationUtils;
+//# sourceMappingURL=GenerationUtils.js.map

package/lib/src/Utils/GenerationUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenerationUtils.js","sourceRoot":"","sources":["../../../src/Utils/GenerationUtils.ts"],"names":[],"mappings":"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"}

package/lib/src/Utils/IRawRequestBuilder.d.ts

@@ -0,0 +1,3 @@
+export interface IRawRequestBuilder {
+    getValue<T>(names: string[]): T;
+}

package/lib/src/Utils/IRawRequestBuilder.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IRawRequestBuilder.js.map

package/lib/src/Utils/IRawRequestBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRawRequestBuilder.js","sourceRoot":"","sources":["../../../src/Utils/IRawRequestBuilder.ts"],"names":[],"mappings":""}

package/lib/src/Utils/InputValidation.d.ts

@@ -0,0 +1,12 @@
+export interface IInputTypeLengths {
+    city: number;
+    email: number;
+    firstName: number;
+    lastName: number;
+    phoneNumber: number;
+    postalCode: number;
+    province: number;
+}
+export type GatewayType = "portico" | "realex";
+export declare function validateAmount(_gateway: GatewayType, amount: string | number): string;
+export declare function validateInput(gateway: GatewayType, inputType: keyof IInputTypeLengths, input: string | undefined): string;

package/lib/src/Utils/InputValidation.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateInput = exports.validateAmount = void 0;
+const inputFieldMaxLength = {
+    portico: {
+        city: 20,
+        email: 100,
+        firstName: 26,
+        lastName: 26,
+        phoneNumber: 20,
+        postalCode: 9,
+        province: 20,
+    },
+    // todo: Use actual values
+    realex: {
+        city: 0,
+        email: 0,
+        firstName: 0,
+        lastName: 0,
+        phoneNumber: 0,
+        postalCode: 0,
+        province: 0,
+    },
+};
+const inputLabels = {
+    city: "City",
+    email: "Email address",
+    firstName: "First name",
+    lastName: "Last name",
+    phoneNumber: "Phone number",
+    postalCode: "Zip/postal code",
+    province: "State/province",
+};
+const inputLengthErrorMessage = (label) => `${label} length greater than the configured gateway's maximum length`;
+function validateAmount(_gateway, amount) {
+    if ((!amount && amount !== 0) || Number(amount) < 0) {
+        throw new Error("Amount must be greater than or equal to 0");
+    }
+    return parseFloat((Math.round(amount * 100) / 100).toString()).toFixed(2);
+}
+exports.validateAmount = validateAmount;
+function validateInput(gateway, inputType, input) {
+    if (!input) {
+        return "";
+    }
+    input = input.trim();
+    let label = inputLabels[inputType];
+    switch (inputType) {
+        case "email":
+            if (!/^[^\s@]+@[^\s@]+$/.test(input)) {
+                throw new Error(`${label} is in wrong format`);
+            }
+            break;
+        case "phoneNumber":
+            input = input.replace(/\D+/g, "");
+            break;
+        case "postalCode":
+            input = input.replace(/[^0-9A-Za-z]/g, "");
+            break;
+        default:
+    }
+    if (!label) {
+        label = "Input";
+    }
+    if (input.length > inputFieldMaxLength[gateway][inputType]) {
+        throw new Error(inputLengthErrorMessage(label));
+    }
+    return input;
+}
+exports.validateInput = validateInput;
+//# sourceMappingURL=InputValidation.js.map

package/lib/src/Utils/InputValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputValidation.js","sourceRoot":"","sources":["../../../src/Utils/InputValidation.ts"],"names":[],"mappings":";;;AAqBA,MAAM,mBAAmB,GAA4B;IACnD,OAAO,EAAE;QACP,IAAI,EAAE,EAAE;QACR,KAAK,EAAE,GAAG;QACV,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,EAAE;QACf,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,EAAE;KACb;IACD,0BAA0B;IAC1B,MAAM,EAAE;QACN,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,CAAC;QACX,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,CAAC;KACZ;CACF,CAAC;AAEF,MAAM,WAAW,GAAiB;IAChC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,eAAe;IACtB,SAAS,EAAE,YAAY;IACvB,QAAQ,EAAE,WAAW;IACrB,WAAW,EAAE,cAAc;IAC3B,UAAU,EAAE,iBAAiB;IAC7B,QAAQ,EAAE,gBAAgB;CAC3B,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,KAAa,EAAE,EAAE,CAChD,GAAG,KAAK,8DAA8D,CAAC;AAEzE,SAAgB,cAAc,CAC5B,QAAqB,EACrB,MAAuB;IAEvB,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;QACnD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;KAC9D;IAED,OAAO,UAAU,CACf,CAAC,IAAI,CAAC,KAAK,CAAE,MAAiB,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CACxD,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACf,CAAC;AAXD,wCAWC;AAED,SAAgB,aAAa,CAC3B,OAAoB,EACpB,SAAkC,EAClC,KAAyB;IAEzB,IAAI,CAAC,KAAK,EAAE;QACV,OAAO,EAAE,CAAC;KACX;IAED,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAErB,IAAI,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACnC,QAAQ,SAAS,EAAE;QACjB,KAAK,OAAO;YACV,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;gBACpC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qBAAqB,CAAC,CAAC;aAChD;YACD,MAAM;QACR,KAAK,aAAa;YAChB,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAClC,MAAM;QACR,KAAK,YAAY;YACf,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;YAC3C,MAAM;QACR,QAAQ;KACT;IAED,IAAI,CAAC,KAAK,EAAE;QACV,KAAK,GAAG,OAAO,CAAC;KACjB;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,EAAE;QAC1D,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;KACjD;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AApCD,sCAoCC"}