@houlak/plexo-sdk 0.1.0

package/README.md

@@ -0,0 +1,14 @@
+# Plexo SDK (Node)
+
+Works as Plexo Gateway client, exposing all important features (addInstrument, purchase, cancel, etc) and solves the problem of building the security layer required by Plexo.
+Such security is based on cryptographic keys for signing messages and verifying incoming responses.
+
+## Current version
+
+Current goal is to add test with jest
+
+## Running
+
+1. Clone this repo
+2. run `npm (or Yarn) install`
+3. Include this repo as a package on another project and call Plexo methods

package/lib/IPaymentGatewayClient.d.ts

@@ -0,0 +1,31 @@
+import { IssuerProcessor } from '.';
+import { Authorization, AuthorizationInfo, CancelRequest, ClientSignedResponse, CodeRequest, Commerce, CommerceIdRequest, CommerceIssuerIdRequest, CommerceModifyRequest, CommerceRequest, CreateBankInstrumentRequest, DeleteInstrumentRequest, ExpressCheckoutRequest, InstrumentCallback, IssuerData, IssuerInfo, PaymentRequest, PaymentInstrument, Reference, Reserve, ReserveRequest, BaseServerResponse, ServerResponse, ServerSignedCallback, Session, Transaction, TransactionCallback, TransactionCursor, TransactionQuery } from './models/IndexSDK';
+export interface IPaymentGatewayClient {
+    AddCommerceAsync(commerce: CommerceRequest): ServerResponse<Commerce>;
+    AddIssuerCommerceAsync(issuerData: IssuerData): ServerResponse<IssuerData>;
+    DeleteCommerceAsync(commerceIdRequest: CommerceIdRequest): BaseServerResponse;
+    DeleteInstrumentAsync(info: DeleteInstrumentRequest): BaseServerResponse;
+    DeleteIssuerCommerceAsync(commerceIssuerIdRequest: CommerceIssuerIdRequest): BaseServerResponse;
+    GetCommerceIssuersAsync(commerceIdRequest: CommerceIdRequest): ServerResponse<IssuerData[]>;
+    GetCommercesAsync(): ServerResponse<Commerce[]>;
+    GetSupportedIssuersAsync(): ServerResponse<IssuerInfo[]>;
+    GetSupportedPaymentProcessorsAsync(): ServerResponse<IssuerProcessor[]>;
+    ModifyCommerceAsync(commerceModifyRequest: CommerceModifyRequest): ServerResponse<Commerce>;
+    GetInstrumentsAsync(authorizationInfo: AuthorizationInfo): ServerResponse<PaymentInstrument[]>;
+    SetDefaultCommerceAsync(commerceIdRequest: CommerceIdRequest): BaseServerResponse;
+    AuthorizeAsync(authorization: Authorization): ServerResponse<Session>;
+    CancelAsync(cancel: CancelRequest): ServerResponse<Transaction>;
+    CodeActionAsync(request: CodeRequest): ServerResponse<Transaction>;
+    StartReserveAsync(payment: ReserveRequest): ServerResponse<Transaction>;
+    StatusAsync(payment: Reference): ServerResponse<Transaction>;
+    ExpressCheckoutAsync(expressCheckout: ExpressCheckoutRequest): ServerResponse<Session>;
+    ObtainCsvTransactionsAsync(query: TransactionQuery): ServerResponse<string>;
+    ObtainTransactionsAsync(query: TransactionQuery): ServerResponse<TransactionCursor>;
+    PurchaseAsync(payment: PaymentRequest): ServerResponse<Transaction>;
+    CreateBankInstrumentAsync(request: CreateBankInstrumentRequest): ServerResponse<PaymentInstrument>;
+    EndReserveAsync(reserve: Reserve): ServerResponse<Transaction>;
+    UnwrapInstrumentCallbackAsync(serverSignedInstrumentCallback: ServerSignedCallback<InstrumentCallback>): ServerResponse<InstrumentCallback>;
+    UnwrapTransactionCallbackAsync(serverSignedTransactionCallback: ServerSignedCallback<TransactionCallback>): ServerResponse<TransactionCallback>;
+    SignInstrumentCallback(serverResponse: ServerResponse<InstrumentCallback>): ClientSignedResponse;
+    SignTransactionCallback(serverResponse: ServerResponse<TransactionCallback>): ClientSignedResponse;
+}

package/lib/IPaymentGatewayClient.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/PaymentGatewayClient.d.ts

@@ -0,0 +1,32 @@
+import { IssuerProcessor } from '.';
+import { IPaymentGatewayClient } from './IPaymentGatewayClient';
+import { Authorization, AuthorizationInfo, CancelRequest, ClientSignedResponse, CodeRequest, Commerce, CommerceIdRequest, CommerceIssuerIdRequest, CommerceModifyRequest, CommerceRequest, CreateBankInstrumentRequest, DeleteInstrumentRequest, ExpressCheckoutRequest, InstrumentCallback, IssuerData, IssuerInfo, PaymentRequest, PaymentInstrument, Reference, Reserve, ReserveRequest, BaseServerResponse, ServerResponse, ServerSignedCallback, Session, Transaction, TransactionCallback, TransactionCursor, TransactionQuery } from './models/IndexSDK';
+export declare class PaymentGatewayClient implements IPaymentGatewayClient {
+    AddCommerceAsync(commerce: CommerceRequest): ServerResponse<Commerce>;
+    AddIssuerCommerceAsync(issuerData: IssuerData): ServerResponse<IssuerData>;
+    DeleteCommerceAsync(commerceIdRequest: CommerceIdRequest): BaseServerResponse;
+    DeleteInstrumentAsync(info: DeleteInstrumentRequest): BaseServerResponse;
+    DeleteIssuerCommerceAsync(commerceIssuerIdRequest: CommerceIssuerIdRequest): BaseServerResponse;
+    GetCommerceIssuersAsync(commerceIdRequest: CommerceIdRequest): ServerResponse<IssuerData[]>;
+    GetCommercesAsync(): ServerResponse<Commerce[]>;
+    GetSupportedIssuersAsync(): ServerResponse<IssuerInfo[]>;
+    GetSupportedPaymentProcessorsAsync(): ServerResponse<IssuerProcessor[]>;
+    ModifyCommerceAsync(commerceModifyRequest: CommerceModifyRequest): ServerResponse<Commerce>;
+    GetInstrumentsAsync(authorizationInfo: AuthorizationInfo): ServerResponse<PaymentInstrument[]>;
+    SetDefaultCommerceAsync(commerceIdRequest: CommerceIdRequest): BaseServerResponse;
+    AuthorizeAsync(authorization: Authorization): ServerResponse<Session>;
+    CancelAsync(cancel: CancelRequest): ServerResponse<Transaction>;
+    CodeActionAsync(request: CodeRequest): ServerResponse<Transaction>;
+    StartReserveAsync(payment: ReserveRequest): ServerResponse<Transaction>;
+    StatusAsync(payment: Reference): ServerResponse<Transaction>;
+    ExpressCheckoutAsync(expressCheckout: ExpressCheckoutRequest): ServerResponse<Session>;
+    ObtainCsvTransactionsAsync(query: TransactionQuery): ServerResponse<string>;
+    ObtainTransactionsAsync(query: TransactionQuery): ServerResponse<TransactionCursor>;
+    PurchaseAsync(payment: PaymentRequest): ServerResponse<Transaction>;
+    CreateBankInstrumentAsync(request: CreateBankInstrumentRequest): ServerResponse<PaymentInstrument>;
+    EndReserveAsync(reserve: Reserve): ServerResponse<Transaction>;
+    UnwrapInstrumentCallbackAsync(serverSignedInstrumentCallback: ServerSignedCallback<InstrumentCallback>): ServerResponse<InstrumentCallback>;
+    UnwrapTransactionCallbackAsync(serverSignedTransactionCallback: ServerSignedCallback<TransactionCallback>): ServerResponse<TransactionCallback>;
+    SignInstrumentCallback(serverResponse: ServerResponse<InstrumentCallback>): ClientSignedResponse;
+    SignTransactionCallback(serverResponse: ServerResponse<TransactionCallback>): ClientSignedResponse;
+}

package/lib/PaymentGatewayClient.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentGatewayClient = void 0;
+var PaymentGatewayClient = /** @class */ (function () {
+    function PaymentGatewayClient() {
+    }
+    PaymentGatewayClient.prototype.AddCommerceAsync = function (commerce) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.AddIssuerCommerceAsync = function (issuerData) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.DeleteCommerceAsync = function (commerceIdRequest) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.DeleteInstrumentAsync = function (info) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.DeleteIssuerCommerceAsync = function (commerceIssuerIdRequest) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.GetCommerceIssuersAsync = function (commerceIdRequest) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.GetCommercesAsync = function () {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.GetSupportedIssuersAsync = function () {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.GetSupportedPaymentProcessorsAsync = function () {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.ModifyCommerceAsync = function (commerceModifyRequest) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.GetInstrumentsAsync = function (authorizationInfo) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.SetDefaultCommerceAsync = function (commerceIdRequest) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.AuthorizeAsync = function (authorization) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.CancelAsync = function (cancel) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.CodeActionAsync = function (request) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.StartReserveAsync = function (payment) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.StatusAsync = function (payment) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.ExpressCheckoutAsync = function (expressCheckout) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.ObtainCsvTransactionsAsync = function (query) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.ObtainTransactionsAsync = function (query) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.PurchaseAsync = function (payment) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.CreateBankInstrumentAsync = function (request) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.EndReserveAsync = function (reserve) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.UnwrapInstrumentCallbackAsync = function (serverSignedInstrumentCallback) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.UnwrapTransactionCallbackAsync = function (serverSignedTransactionCallback) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.SignInstrumentCallback = function (serverResponse) {
+        throw new Error('Method not implemented.');
+    };
+    PaymentGatewayClient.prototype.SignTransactionCallback = function (serverResponse) {
+        throw new Error('Method not implemented.');
+    };
+    return PaymentGatewayClient;
+}());
+exports.PaymentGatewayClient = PaymentGatewayClient;

package/lib/config/config.d.ts

@@ -0,0 +1,12 @@
+export declare const config: {
+    logger: {
+        level: string;
+    };
+    env: string;
+    plexoClient: {
+        clientName: string;
+        certificatePath: string;
+        certificatePassword: string;
+    };
+    plexoUrl: string;
+};

package/lib/config/config.js

@@ -0,0 +1,16 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+exports.config = {
+    logger: {
+        level: process.env.LOG_LEVEL || 'trace', // Minimum logging level. trace = log everything
+    },
+    env: (_a = process.env.ENV) === null || _a === void 0 ? void 0 : _a.toUpperCase(),
+    plexoClient: {
+        clientName: process.env.PLEXO_CLIENT_NAME,
+        certificatePath: process.env.PLEXO_CLIENT_CERTIFICATE_PATH,
+        certificatePassword: process.env.PLEXO_CLIENT_CERTIFICATE_PASSWORD,
+    },
+    plexoUrl: process.env.PLEXO_URL,
+};

package/lib/handler/PlexoHandler.d.ts

@@ -0,0 +1,21 @@
+import { Authorization, BaseServerResponse, CancelRequest, ClientSignedResponse, Commerce, CommerceIdRequest, CommerceIssuerIdRequest, CommerceRequest, DeleteInstrumentRequest, ExpressCheckoutRequest, InstrumentCallback, IssuerData, IssuerInfo, IssuerProcessor, PaymentRequest, ServerResponse, ServerSignedCallback, Session, Transaction, TransactionCallback } from '../sdk/index';
+import { BaseResponse } from './types/BaseResponse';
+export declare const PlexoHandler: {
+    AddCommerce: (commerceRequest: CommerceRequest) => Promise<BaseResponse<Commerce>>;
+    AddIssuerCommerce: (issuerData: IssuerData) => Promise<BaseResponse<IssuerData>>;
+    GetCommerceIssuers: (commerceIdRequest: CommerceIdRequest) => Promise<BaseResponse<IssuerData[]>>;
+    GetCommerces: () => Promise<BaseResponse<Commerce[]>>;
+    DeleteCommerce: (commerceIdRequest: CommerceIdRequest) => Promise<BaseResponse<BaseServerResponse>>;
+    DeleteIssuerCommerce: (commerceIssuerIdRequest: CommerceIssuerIdRequest) => Promise<BaseResponse<BaseServerResponse>>;
+    DeleteInstrument: (instrument: DeleteInstrumentRequest) => Promise<BaseResponse<BaseServerResponse>>;
+    GetSupportedIssuers: () => Promise<BaseResponse<IssuerInfo[]>>;
+    GetSupportedPaymentProcessors: () => Promise<BaseResponse<IssuerProcessor[]>>;
+    Authorize: (authorization: Authorization) => Promise<BaseResponse<Session>>;
+    Cancel: (cancellation: CancelRequest) => Promise<BaseResponse<Transaction>>;
+    ExpressCheckout: (expressCheckout: ExpressCheckoutRequest) => Promise<BaseResponse<Session>>;
+    Purchase: (purchase: PaymentRequest) => Promise<BaseResponse<Transaction>>;
+    UnwrapInstrumentCallback: (instrumentCallback: ServerSignedCallback<InstrumentCallback>) => Promise<BaseResponse<InstrumentCallback>>;
+    UnwrapTransactionCallback: (transactionCallback: ServerSignedCallback<TransactionCallback>) => Promise<BaseResponse<TransactionCallback>>;
+    SignInstrumentCallback: (instrumentCallback: ServerResponse<InstrumentCallback>) => Promise<BaseResponse<ClientSignedResponse>>;
+    SignTransactionCallback: (transactionCallback: ServerResponse<TransactionCallback>) => Promise<BaseResponse<ClientSignedResponse>>;
+};

package/lib/handler/PlexoHandler.js

@@ -0,0 +1,266 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlexoHandler = void 0;
+var index_1 = require("../sdk/index");
+var evaluator_service_1 = require("./services/evaluator.service");
+var config_1 = require("../config/config");
+var PaymentGatewayMock_1 = require("../sdk/PaymentGatewayMock");
+var isTesting = config_1.config.env === 'TEST';
+var paymentGatewayClient = isTesting
+    ? new PaymentGatewayMock_1.PaymentGatewayMock()
+    : new index_1.PaymentGatewayClient();
+var AddCommerce = function (commerceRequest) { return __awaiter(void 0, void 0, void 0, function () {
+    var commerceResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.AddCommerceAsync(commerceRequest)];
+            case 1:
+                commerceResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(commerceRequest, commerceResponse)];
+        }
+    });
+}); };
+var AddIssuerCommerce = function (issuerData) { return __awaiter(void 0, void 0, void 0, function () {
+    var issuerResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.AddIssuerCommerceAsync(issuerData)];
+            case 1:
+                issuerResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(issuerData, issuerResponse)];
+        }
+    });
+}); };
+var DeleteCommerce = function (commerceIdRequest) { return __awaiter(void 0, void 0, void 0, function () {
+    var deleteResponse, wrappedDeleteResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.DeleteCommerceAsync(commerceIdRequest)];
+            case 1:
+                deleteResponse = _a.sent();
+                wrappedDeleteResponse = {
+                    response: deleteResponse,
+                    resultCode: deleteResponse.resultCode,
+                };
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(commerceIdRequest, wrappedDeleteResponse)];
+        }
+    });
+}); };
+var DeleteInstrument = function (instrument) { return __awaiter(void 0, void 0, void 0, function () {
+    var deleteInstrumentResponse, wrappedDeleteResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.DeleteInstrumentAsync(instrument)];
+            case 1:
+                deleteInstrumentResponse = _a.sent();
+                wrappedDeleteResponse = {
+                    response: deleteInstrumentResponse,
+                    resultCode: deleteInstrumentResponse.resultCode,
+                };
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(instrument, wrappedDeleteResponse)];
+        }
+    });
+}); };
+var DeleteIssuerCommerce = function (commerceIssuerIdRequest) { return __awaiter(void 0, void 0, void 0, function () {
+    var deleteIssuerResponse, wrappedDeleteResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.DeleteIssuerCommerceAsync(commerceIssuerIdRequest)];
+            case 1:
+                deleteIssuerResponse = _a.sent();
+                wrappedDeleteResponse = {
+                    response: deleteIssuerResponse,
+                    resultCode: deleteIssuerResponse.resultCode,
+                };
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(commerceIssuerIdRequest, wrappedDeleteResponse)];
+        }
+    });
+}); };
+var GetCommerceIssuers = function (commerceIdRequest) { return __awaiter(void 0, void 0, void 0, function () {
+    var commerceResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.GetCommerceIssuersAsync(commerceIdRequest)];
+            case 1:
+                commerceResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(commerceIdRequest, commerceResponse)];
+        }
+    });
+}); };
+var GetCommerces = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var commercesResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.GetCommercesAsync()];
+            case 1:
+                commercesResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(null, commercesResponse, true)];
+        }
+    });
+}); };
+var GetSupportedIssuers = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var issuersResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.GetSupportedIssuersAsync()];
+            case 1:
+                issuersResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(null, issuersResponse, true)];
+        }
+    });
+}); };
+var GetSupportedPaymentProcessors = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var paymentProcessorsResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.GetSupportedPaymentProcessorsAsync()];
+            case 1:
+                paymentProcessorsResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(null, paymentProcessorsResponse, true)];
+        }
+    });
+}); };
+var Authorize = function (authorization) { return __awaiter(void 0, void 0, void 0, function () {
+    var authorizationResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.AuthorizeAsync(authorization)];
+            case 1:
+                authorizationResponse = _a.sent();
+                return [4 /*yield*/, evaluator_service_1.Evaluator.genericEvaluator(authorization, authorizationResponse)];
+            case 2: return [2 /*return*/, _a.sent()];
+        }
+    });
+}); };
+var Cancel = function (cancellation) { return __awaiter(void 0, void 0, void 0, function () {
+    var transactionResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.CancelAsync(cancellation)];
+            case 1:
+                transactionResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.transactionEvaluator(cancellation, transactionResponse, 'Cancellation', index_1.TransactionType.Cancel)];
+        }
+    });
+}); };
+var ExpressCheckout = function (expressCheckout) { return __awaiter(void 0, void 0, void 0, function () {
+    var expressCheckoutResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.ExpressCheckoutAsync(expressCheckout)];
+            case 1:
+                expressCheckoutResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(expressCheckout, expressCheckoutResponse)];
+        }
+    });
+}); };
+var Purchase = function (purchase) { return __awaiter(void 0, void 0, void 0, function () {
+    var purchaseResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.PurchaseAsync(purchase)];
+            case 1:
+                purchaseResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.transactionEvaluator(purchase, purchaseResponse, 'Purchase', index_1.TransactionType.Purchase)];
+        }
+    });
+}); };
+var UnwrapInstrumentCallback = function (instrumentCallback) { return __awaiter(void 0, void 0, void 0, function () {
+    var instrumentCallbackResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.UnwrapInstrumentCallbackAsync(instrumentCallback)];
+            case 1:
+                instrumentCallbackResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(instrumentCallback, instrumentCallbackResponse)];
+        }
+    });
+}); };
+var UnwrapTransactionCallback = function (transactionCallback) { return __awaiter(void 0, void 0, void 0, function () {
+    var transactionCallbackResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.UnwrapTransactionCallbackAsync(transactionCallback)];
+            case 1:
+                transactionCallbackResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(transactionCallback, transactionCallbackResponse)];
+        }
+    });
+}); };
+var SignInstrumentCallback = function (instrumentCallback) { return __awaiter(void 0, void 0, void 0, function () {
+    var signInstrumentCallbackResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.SignInstrumentCallback(instrumentCallback)];
+            case 1:
+                signInstrumentCallbackResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(instrumentCallback, signInstrumentCallbackResponse)];
+        }
+    });
+}); };
+var SignTransactionCallback = function (transactionCallback) { return __awaiter(void 0, void 0, void 0, function () {
+    var signTransactionCallbackResponse;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, paymentGatewayClient.SignTransactionCallback(transactionCallback)];
+            case 1:
+                signTransactionCallbackResponse = _a.sent();
+                return [2 /*return*/, evaluator_service_1.Evaluator.genericEvaluator(transactionCallback, signTransactionCallbackResponse)];
+        }
+    });
+}); };
+exports.PlexoHandler = {
+    AddCommerce: AddCommerce,
+    AddIssuerCommerce: AddIssuerCommerce,
+    GetCommerceIssuers: GetCommerceIssuers,
+    GetCommerces: GetCommerces,
+    DeleteCommerce: DeleteCommerce,
+    DeleteIssuerCommerce: DeleteIssuerCommerce,
+    DeleteInstrument: DeleteInstrument,
+    GetSupportedIssuers: GetSupportedIssuers,
+    GetSupportedPaymentProcessors: GetSupportedPaymentProcessors,
+    Authorize: Authorize,
+    Cancel: Cancel,
+    ExpressCheckout: ExpressCheckout,
+    Purchase: Purchase,
+    UnwrapInstrumentCallback: UnwrapInstrumentCallback,
+    UnwrapTransactionCallback: UnwrapTransactionCallback,
+    SignInstrumentCallback: SignInstrumentCallback,
+    SignTransactionCallback: SignTransactionCallback,
+};

package/lib/handler/services/evaluator.service.d.ts

@@ -0,0 +1,6 @@
+import { ServerResponse, Transaction, TransactionType } from '../../sdk/index';
+import { BaseResponse } from '../types/BaseResponse';
+export declare const Evaluator: {
+    genericEvaluator: <T extends object | null, R extends object>(request: T, response: ServerResponse<R>, withoutParams?: boolean) => Promise<BaseResponse<R>>;
+    transactionEvaluator: <T_1 extends object>(request: T_1, response: ServerResponse<Transaction>, transactionName: string, transactionType: TransactionType) => BaseResponse<Transaction>;
+};

package/lib/handler/services/evaluator.service.js

@@ -0,0 +1,118 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Evaluator = void 0;
+var logger_lib_1 = require("../../lib/logger.lib");
+var index_1 = require("../../sdk/index");
+var plexo_error_enum_1 = require("../../sdk/enums/plexo-error-enum");
+var BaseResponse_1 = require("../types/BaseResponse");
+var getTransactionStatus = function (transaction, transactionType) {
+    if (transactionType === index_1.TransactionType.Cancel) {
+        return {
+            status: index_1.TransactionResult[+transaction.transactions.cancel.status],
+            transactionResultText: transaction.transactions.cancel.transactionResultText,
+        };
+    }
+    if (transactionType === index_1.TransactionType.Reserve) {
+        return {
+            status: index_1.TransactionResult[+transaction.transactions.reserve.status],
+            transactionResultText: transaction.transactions.reserve.transactionResultText,
+        };
+    }
+    if (transactionType === index_1.TransactionType.Purchase) {
+        return {
+            status: index_1.TransactionResult[+transaction.transactions.purchase.status],
+            transactionResultText: transaction.transactions.purchase.transactionResultText,
+        };
+    }
+};
+var genericEvaluator = function (request, response, withoutParams) {
+    if (withoutParams === void 0) { withoutParams = false; }
+    return __awaiter(void 0, void 0, void 0, function () {
+        var errorCode, errorMessage, resultCode;
+        return __generator(this, function (_a) {
+            errorCode = plexo_error_enum_1.PlexoErrorEnum.Generic;
+            errorMessage = '';
+            resultCode = response.resultCode;
+            if (resultCode !== index_1.ResultCodes.Ok) {
+                errorCode = resultCode;
+                errorMessage = response.i18ErrorMessages;
+                return [2 /*return*/, new BaseResponse_1.BaseResponse(errorCode, false, errorMessage, response.response)];
+            }
+            if (request === null && !withoutParams) {
+                return [2 /*return*/, new BaseResponse_1.BaseResponse(errorCode, false, errorMessage, response.response)];
+            }
+            return [2 /*return*/, new BaseResponse_1.BaseResponse(undefined, true, 'Success', response.response)];
+        });
+    });
+};
+var transactionEvaluator = function (request, response, transactionName, transactionType) {
+    var errorCode = plexo_error_enum_1.PlexoErrorEnum.Generic;
+    var errorMessage = '';
+    var plexoOrTransactionError = '';
+    var resultCode = response.resultCode;
+    var transactionStatus = getTransactionStatus(response === null || response === void 0 ? void 0 : response.response, transactionType);
+    if (resultCode !== index_1.ResultCodes.Ok) {
+        errorCode = response.resultCode;
+        errorMessage = response.errorMessage;
+        plexoOrTransactionError = 'PLEXO ERROR';
+    }
+    if (transactionStatus.status !== index_1.TransactionResult[index_1.TransactionResult.Ok] &&
+        transactionStatus.status !== index_1.TransactionResult[index_1.TransactionResult.Pending] &&
+        transactionStatus.status !== null) {
+        errorCode = transactionStatus.status;
+        errorMessage = transactionStatus.transactionResultText;
+        plexoOrTransactionError = 'TRANSACTION ERROR';
+    }
+    if (transactionStatus.status === index_1.TransactionResult[index_1.TransactionResult.Ok] ||
+        transactionStatus.status === index_1.TransactionResult[index_1.TransactionResult.Pending]) {
+        // Maybe we should add some project configuration to define
+        // wether or not we want to log successful transactions 🤔
+        return new BaseResponse_1.BaseResponse(undefined, true, 'Success', response.response);
+    }
+    logger_lib_1.default.info({
+        transactionName: transactionName,
+        plexoOrTransactionError: plexoOrTransactionError,
+        errorCode: errorCode,
+        errorMessage: errorMessage,
+    });
+    logger_lib_1.default.info({ request: request }, 'Request --> ');
+    logger_lib_1.default.info({ response: response }, 'Response --> ');
+    return new BaseResponse_1.BaseResponse(errorCode, false, errorMessage, response.response);
+};
+exports.Evaluator = { genericEvaluator: genericEvaluator, transactionEvaluator: transactionEvaluator };

package/lib/handler/types/BaseResponse.d.ts

@@ -0,0 +1,8 @@
+import { PlexoErrorEnum } from '../../sdk/enums/plexo-error-enum';
+export declare class BaseResponse<T> {
+    response: T;
+    plexoErrorEnum?: PlexoErrorEnum;
+    isSuccess?: boolean;
+    message?: string;
+    constructor(plexoErrorCode: number | undefined, isSuccess: boolean | undefined, message: string | undefined, response: T);
+}

package/lib/handler/types/BaseResponse.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseResponse = void 0;
+var BaseResponse = /** @class */ (function () {
+    function BaseResponse(plexoErrorCode, isSuccess, message, response) {
+        if (plexoErrorCode === void 0) { plexoErrorCode = 999; }
+        if (isSuccess === void 0) { isSuccess = true; }
+        if (message === void 0) { message = ''; }
+        this.plexoErrorEnum = plexoErrorCode;
+        this.isSuccess = isSuccess;
+        this.message = message;
+        this.response = response;
+    }
+    return BaseResponse;
+}());
+exports.BaseResponse = BaseResponse;

package/lib/helpers/signature/signatureHelper.d.ts

@@ -0,0 +1 @@
+export declare const canonizeJson: (object: any) => Promise<string>;