@finteqhub/sdk-js 0.2.0 → 0.4.0

package/README.md

@@ -6,13 +6,46 @@ Use `new FinteqHubProcessing(apiUrl: string, fingerprintVisitorId: string, merch
 const processing = new FinteqHubProcessing('api-url', 'fingerprint-visitor-id', 'merchant-id', 'session-id');
 ```
 
-## processing.submitForm(data)
+## API
 
-Use `processing.submitForm` to submit transaction. When called, `processing.submitForm` will attempt to complete any required actions to process transaction. This method returns a Promise which resolves with a string (redirect url) or Error that describes the failure.
+### processing.getSession()
+
+Use `processing.getSession` to get session information.
+
+```
+processing
+  .getSession()
+  .then(result => console.log(result))
+  .catch(error => console.warn(error));
+```
+
+### processing.submitForm(data)
+
+Use `processing.submitForm` to submit transaction. When called, `processing.submitForm` will attempt to complete any required actions to process the transaction. This method returns promise which resolves with response (`{ "type": "redirect", "redirectUrl": string}`) or error that describes the failure.
 
 ```
 processing
   .submitForm(data)
-  .then(redirectUrl => window.location.replace(redirectUrl))
+  .then(result => console.log(result))
+  .catch(error => console.warn(error));
+```
+
+## Usage
+
+```
+import { FinteqHubProcessing } from "@finteqhub/sdk-js";
+import FingerprintJS from "@fingerprintjs/fingerprintjs";
+
+const fp = await FingerprintJS.load();
+const result = await fp.get();
+
+const processing = new FinteqHubProcessing(apiUrl, result.visitorId, merchantId, sessionId);
+const session = await processing.getSession();
+
+const data = {/** collect data from form and session **/}
+
+processing
+  .submitForm(data)
+  .then(result => console.log(result))
   .catch(error => console.warn(error));
 ```

package/dist/src/processing.d.ts

@@ -1,11 +1,13 @@
-import { SubmitData } from "./typings";
+import { ProcessOperationRedirectResponse, SessionResponse, SubmitData } from "./typings";
 export declare class FinteqHubProcessing {
     private apiUrl;
     private fingerprintVisitorId;
     private merchantId;
     private sessionId;
+    private projectId;
     constructor(apiUrl: string, fingerprintVisitorId: string, merchantId: string, sessionId: string);
-    submitForm(data: SubmitData): Promise<string>;
+    getSession(): Promise<SessionResponse>;
+    submitForm(data: SubmitData): Promise<ProcessOperationRedirectResponse>;
     private processOperation;
     private sendPost;
 }

package/dist/src/processing.js

@@ -1,3 +1,12 @@
+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());
+    });
+};
 import { uuid } from "./utils";
 export class FinteqHubProcessing {
     constructor(apiUrl, fingerprintVisitorId, merchantId, sessionId) {
@@ -6,38 +15,56 @@ export class FinteqHubProcessing {
         this.merchantId = merchantId;
         this.sessionId = sessionId;
     }
+    getSession() {
+        return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            try {
+                const response = yield fetch(`${this.apiUrl}/v1/sessions/${this.sessionId}`, {
+                    method: "GET",
+                    headers: {
+                        "Content-Type": "application/json;charset=UTF-8",
+                        "x-merchant-id": this.merchantId,
+                    },
+                });
+                const result = yield response.json();
+                if (result.error || response.status !== 200) {
+                    reject(new Error(result.error));
+                }
+                else {
+                    this.projectId = (_a = result.operation) === null || _a === void 0 ? void 0 : _a.projectId;
+                    resolve(result);
+                }
+            }
+            catch (e) {
+                reject(e);
+            }
+        }));
+    }
     submitForm(data) {
-        const promise = new Promise((resolve, reject) => {
-            this.sendPost(`${this.apiUrl}/v2/transactions/submit-form`, data)
-                .then((response) => {
-                if (response.status === 200) {
-                    response.json().then((result) => {
-                        if (result.error) {
-                            reject(new Error(result.error));
-                        }
-                        else {
-                            this.processOperation(`${this.apiUrl}/v1/operations/${result.operationId}`, resolve, reject);
-                        }
-                    });
+        return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.sendPost(`${this.apiUrl}/v2/transactions/submit-form`, data);
+                const result = yield response.json();
+                if (result.error || response.status !== 200) {
+                    reject(new Error(result.error));
                 }
                 else {
-                    response
-                        .json()
-                        .then((result) => reject(new Error(result.error)))
-                        .catch((error) => reject(error));
+                    this.processOperation(`${this.apiUrl}/v1/operations/${result.operationId}`, resolve, reject);
                 }
-            })
-                .catch((error) => reject(error));
-        });
-        return promise;
+            }
+            catch (e) {
+                reject(e);
+            }
+        }));
     }
     processOperation(url, resolve, reject) {
-        this.sendPost(url, {})
-            .then((response) => {
-            if (response.status === 200) {
-                response.json().then((result) => {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.sendPost(url, {});
+                const result = yield response.json();
+                if (response.status === 200) {
                     if (result.type === "redirect") {
-                        resolve(result.redirectUrl);
+                        resolve(result);
                     }
                     else if (result.type === "submitForm") {
                         let iframe = document.createElement("iframe");
@@ -55,16 +82,15 @@ export class FinteqHubProcessing {
                     else {
                         reject(new Error("unknown process operation type"));
                     }
-                });
+                }
+                else {
+                    reject(new Error(result.error));
+                }
             }
-            else if (response.status === 400) {
-                response
-                    .json()
-                    .then((result) => reject(new Error(result.error)))
-                    .catch((error) => reject(error));
+            catch (e) {
+                reject(e);
             }
-        })
-            .catch((error) => reject(error));
+        });
     }
     sendPost(url, data) {
         return fetch(url, {
@@ -75,7 +101,7 @@ export class FinteqHubProcessing {
                 "x-request-id": uuid(),
                 "x-fingerprint": this.fingerprintVisitorId,
                 "x-session-id": this.sessionId,
-                "x-project-id": "017cdbcb-ca22-68f1-95a9-edb698dd063c", // todo: fix it
+                "x-project-id": this.projectId,
             },
             body: JSON.stringify(data),
         });

package/dist/src/typings.d.ts

@@ -1,9 +1,10 @@
 export declare type Card = {
     number: string;
-    holderName: string;
+    holder: string;
     expiryMonth: number;
     expiryYear: number;
     CVV: string;
+    tokenize: boolean;
 };
 export declare type Payer = {
     firstName: string;
@@ -12,18 +13,93 @@ export declare type Payer = {
     country: string;
     birthDate: string;
     phoneNumber: string;
-    phoneCode: string;
+    phoneCountryCode: string;
 };
-export declare type BillingAddress = {
+export declare type Address = {
     address: string;
     city: string;
     state: string;
     country: string;
-    zipCode: string;
+    postalCode: string;
+};
+export declare type SessionResponse = {
+    customer?: Customer;
+    initCredentials: {
+        billingAddress?: Address;
+        card?: Card;
+        payer?: Payer;
+        shippingAddress: Address;
+    };
+    operation: OperationSession;
+    paymentMethods: PaymentMethods;
+    session: Session;
+};
+export interface Customer {
+    accounts?: CustomerAccount[];
+    country?: string;
+    id: string;
+    merchantCustomerId: string;
+    name?: string;
+    projectId: string;
+}
+export declare type CustomerAccount = {
+    id?: string;
+    integrationAccountId?: string;
+    paymentMethod?: string;
+    status?: string;
+    metadata?: any;
+};
+export declare type OperationSession = {
+    amount: string;
+    currencyCode: string;
+    failUrl: string;
+    operationId: string;
+    projectId: string;
+    successUrl: string;
+    transactionId: string;
+    transactionType: string;
+};
+export declare type PaymentMethods = {
+    credentials: {
+        [key: string]: {
+            fields?: {
+                [key: string]: FieldDetails;
+            };
+            required?: Array<string>;
+        };
+    };
+    paymentMethods: {
+        [key: string]: {
+            friendlyName?: string;
+            logo?: string;
+            credentials?: string;
+        };
+    };
+};
+export declare type Session = {
+    ttl: number;
+    createdAt: string;
+};
+export declare type FieldDetails = {
+    type?: string;
+    friendlyName?: string;
+    description?: string;
+    format?: string;
+    example?: string;
 };
 export declare type SubmitData = {
     type: string;
     card: Card;
-    billingAddress: BillingAddress;
+    billingAddress: Address;
     payer: Payer;
 };
+export declare type ProcessOperationRedirectResponse = {
+    type: "redirect";
+    redirectUrl: string;
+    metadata: unknown;
+};
+export declare type ProcessOperationResponse = {
+    type: "submitForm";
+    formUrl: string;
+    metadata: unknown;
+} | ProcessOperationRedirectResponse;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finteqhub/sdk-js",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "SDK for interacting with FinteqHub processing API",
   "main": "./dist/index.js",
   "typings": "./dist/index.d.ts",
@@ -9,10 +9,16 @@
   ],
   "author": "FinteqHub",
   "devDependencies": {
-    "typescript": "^4.8.3"
+    "@types/jest": "^29.1.1",
+    "jest": "^29.1.2",
+    "jest-environment-jsdom": "^29.1.2",
+    "ts-jest": "^29.0.3",
+    "typescript": "^4.8.3",
+    "whatwg-fetch": "^3.6.2"
   },
   "scripts": {
-    "build": "tsc"
+    "build": "tsc",
+    "test": "jest"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org"