Release 4.0.0.

Author: IngenicoEPayments

.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

.eslintignore

@@ -0,0 +1,4 @@
+node_modules
+/docs
+/lib
+/schemas

.gitignore

@@ -1,4 +1,10 @@
 node_modules
+/lib
+/docs
 logfile.txt
 .vscode
 .idea
+
+# For testing
+__tests__/config.json
+junit*.xml

.prettierignore

@@ -0,0 +1,4 @@
+node_modules
+/docs
+/lib
+/schemas

README.md

@@ -14,9 +14,11 @@ See the [Ingenico ePayments Developer Hub](https://epayments.developer-ingenico.
 
 ## Structure of this repository
 
-This repository consists out of one main component:
+This repository consists out of three main components:
 
-1. The source code of the SDK itself: `/`
+1. The source code of the SDK itself: `/src`
+2. The JSON schemas used to validate requests: `/schemas`
+3. Unit and integration tests: `/__tests__`
 
 ## Requirements
 
@@ -30,6 +32,28 @@ From the folder where your `package.json` is located, run the following command
 
 ## Building the repository
 
-From the root of the project install all dependencies: 
+From the root of the project install all dependencies, then compile the code:
 
     npm install
+    npm run build
+
+## Testing
+
+There are two types of tests:
+
+1. Unit tests. These will work out-of-the-box.  
+   Run these tests as follows:
+
+    ```
+    npm run test:unit
+    ```
+2. Integration tests. Before you can run these, you first need to copy file `__tests__/config.json.dist` to `__tests__/config.json` and replace all values as needed.  
+   Run these tests as follows:
+
+    ```
+    npm run test:integration
+    ```
+
+You can also run both types of tests together as follows:
+
+    npm run test

__tests__/config.json.dist

@@ -0,0 +1,12 @@
+{
+  "merchantId": "MERCHANT_ID",
+  "apiKeyId": "API_KEY_ID",
+  "secretApiKey": "API_SECRET",
+  "apiEndpoint": {
+    "host": "API_ENDPOINT_HOST",
+    "scheme": "https",
+    "port": 443
+  },
+  "integrator": "INTEGRATOR",
+  "enableLogging": false
+}

__tests__/integration/convertAmount.test.ts

@@ -0,0 +1,30 @@
+/* eslint-disable @typescript-eslint/no-non-null-assertion */
+
+import { ConvertAmount } from "../../src/model/domain/services";
+import connectSdk, { config } from "./init";
+
+/**
+ * @group integration
+ */
+describe("convertAmount", () => {
+  test("called successfully", done => {
+    const query = {
+      source: "EUR",
+      target: "USD",
+      amount: 100
+    };
+
+    connectSdk.services.convertAmount(config.merchantId, query, (error, response) => {
+      expect(error).toBeNull();
+
+      expect(response).not.toBeNull();
+      expect(response!.status).toBe(200);
+      expect(response!.body).not.toBeNull();
+
+      const responseBody = response!.body as ConvertAmount;
+      expect(responseBody.convertedAmount).not.toBeNull();
+
+      done();
+    });
+  });
+});

__tests__/integration/idempotence.test.ts

@@ -0,0 +1,72 @@
+/* eslint-disable @typescript-eslint/no-non-null-assertion */
+
+import * as uuid from "uuid";
+import { CreatePaymentResponse } from "../../src/model/domain/payment";
+import connectSdk, { config } from "./init";
+
+/**
+ * @group integration
+ */
+describe("Idempotence", () => {
+  test("causes second request to be idempotent", done => {
+    const body = {
+      order: {
+        amountOfMoney: {
+          currencyCode: "EUR",
+          amount: 100
+        },
+        customer: {
+          locale: "en_GB",
+          billingAddress: {
+            countryCode: "NL"
+          }
+        }
+      },
+      redirectPaymentMethodSpecificInput: {
+        returnUrl: "http://example.com/",
+        paymentProductId: 809,
+        paymentProduct809SpecificInput: {
+          issuerId: "INGBNL2A"
+        }
+      }
+    };
+
+    const idemPotenceKey = uuid.v4();
+    const paymentContext = {
+      idemPotence: {
+        key: idemPotenceKey
+      }
+    };
+
+    connectSdk.payments.create(config.merchantId, body, paymentContext, (error, response) => {
+      expect(error).toBeNull();
+
+      expect(response).not.toBeNull();
+      expect(response!.status).toBe(201);
+      expect(response!.body).not.toBe(null);
+
+      const responseBody = response!.body as CreatePaymentResponse;
+      expect(responseBody.payment).not.toBe(null);
+      expect(responseBody.payment!.id).not.toBe(null);
+      expect(paymentContext.idemPotence.key).toBe(idemPotenceKey);
+      expect(connectSdk.context.getIdempotenceRequestTimestamp()).toBeUndefined();
+
+      connectSdk.payments.create(config.merchantId, body, paymentContext, (error2, response2) => {
+        expect(error2).toBeNull();
+
+        expect(response2).not.toBeNull();
+        expect(response2!.status).toBe(201);
+        expect(response2!.body).not.toBe(null);
+
+        const responseBody2 = response2!.body as CreatePaymentResponse;
+        expect(responseBody2.payment).not.toBe(null);
+        expect(responseBody2.payment!.id).toBe(responseBody.payment!.id);
+        expect(paymentContext.idemPotence.key).toBe(idemPotenceKey);
+        expect(connectSdk.context.getIdempotenceRequestTimestamp()).not.toBeUndefined();
+        expect(connectSdk.context.getIdempotenceRequestTimestamp()).not.toBeNull();
+
+        done();
+      });
+    });
+  });
+});

__tests__/integration/init.ts

@@ -0,0 +1,18 @@
+import * as connectSdk from "../../src";
+
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+export const config = require("../config.json");
+
+jest.setTimeout(60 * 1000);
+
+connectSdk.init({
+  host: config.apiEndpoint.host,
+  scheme: config.apiEndpoint.scheme,
+  port: config.apiEndpoint.port,
+  enableLogging: config.enableLogging, // defaults to false
+  apiKeyId: config.apiKeyId,
+  secretApiKey: config.secretApiKey,
+  integrator: "Integration tests"
+});
+
+export default connectSdk;

__tests__/integration/multipart.test.ts

@@ -0,0 +1,103 @@
+/* eslint-disable @typescript-eslint/no-non-null-assertion */
+
+import { Readable } from "stream";
+import * as connectSdk from "../../src";
+import * as communicator from "../../src/utils/communicator";
+
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const config = require("../config.json");
+
+connectSdk.init({
+  host: "httpbin.org",
+  scheme: "http",
+  port: 80,
+  enableLogging: config.enableLogging, // defaults to false
+  apiKeyId: config.apiKeyId,
+  secretApiKey: config.secretApiKey,
+  integrator: "Integration tests"
+});
+
+jest.setTimeout(60 * 1000);
+
+function toReadable(str: string): Readable {
+  const result = new Readable();
+  result.push(str);
+  result.push(null);
+  return result;
+}
+
+interface HttpBinResponse {
+  form: { [key: string]: string | undefined };
+  files: { [key: string]: string | undefined };
+}
+
+/**
+ * @group integration
+ */
+describe("multipart", () => {
+  test("POST", done => {
+    const body = {
+      value: "Hello World",
+      file: {
+        content: toReadable("This is the contents of a file"),
+        fileName: "file.txt",
+        contentType: "text/plain"
+      }
+    };
+
+    communicator.multipart({
+      method: "POST",
+      modulePath: "/post",
+      body: body,
+      paymentContext: null,
+      cb: (error, response) => {
+        expect(error).toBeNull();
+
+        expect(response).not.toBeNull();
+        expect(response!.status).toBe(200);
+        expect(response!.body).not.toBeNull();
+
+        const responseBody = response!.body as HttpBinResponse;
+        expect(responseBody.files).not.toBeNull();
+        expect(responseBody.files.file).toBe("This is the contents of a file");
+        expect(responseBody.form).not.toBeNull();
+        expect(responseBody.form.value).toBe("Hello World");
+
+        done();
+      }
+    });
+  });
+
+  test("PUT", done => {
+    const body = {
+      value: "Hello World",
+      file: {
+        content: toReadable("This is the contents of a file"),
+        fileName: "file.txt",
+        contentType: "text/plain"
+      }
+    };
+
+    communicator.multipart({
+      method: "PUT",
+      modulePath: "/put",
+      body: body,
+      paymentContext: null,
+      cb: (error, response) => {
+        expect(error).toBeNull();
+
+        expect(response).not.toBeNull();
+        expect(response!.status).toBe(200);
+        expect(response!.body).not.toBeNull();
+
+        const responseBody = response!.body as HttpBinResponse;
+        expect(responseBody.files).not.toBeNull();
+        expect(responseBody.files.file).toBe("This is the contents of a file");
+        expect(responseBody.form).not.toBeNull();
+        expect(responseBody.form.value).toBe("Hello World");
+
+        done();
+      }
+    });
+  });
+});