Emil Customer SDK for Nodejs

This TypeScript/JavaScript client utilizes axios. The generated Node module can be used with Nodejs based applications.

Language level

• ES5 - you must have a Promises/A+ library installed
• ES6

Module system

• CommonJS
• ES6 module system

Although this package can be used in both TypeScript and JavaScript, it is intended to be used with TypeScript. The definition should be automatically resolved via package.json. (Reference)

Consuming

Navigate to the folder of your consuming project and run one of the following commands:

npm install @emilgroup/[email protected] --save

or

yarn add @emilgroup/[email protected]

And then you can import CustomersApi.

import { CustomersApi } from '@emilgroup/customer-sdk-node'

const customersApi = new CustomersApi();

Credentials

To use authentication protected endpoints, you have to first authorize. To do so, the easiest way is to provide a configuration file under ~/.emil/credentials with the following content:

[email protected]
emil_password=XXXXXXXXXXXXXX

It is also possible to provide environment variables instead:

export [email protected]
export EMIL_PASSWORD=XXXXXXXXXXXXXX

Base path

To select the basic path for using the API, we can use two approaches. The first is to use one of the predefined environments, and the second is to specify the domain as a string.

import { CustomersApi, Environment } from '@emilgroup/customer-sdk-node'

const customersApi = new CustomersApi();

// Allows you to simply choose environment. It will usually be Environment.Production.
customersApi.selectEnvironment(Environment.Production);

// For advanced users, use the custom baseUrl of the website you need to connect to.
customersApi.selectBasePath('https://my-custom-domain.com');

Example

Here is a basic functionning example:

async function listCustomers(): Promise<Void> {
    try {
        const customersApi = new CustomersApi();

        await customersApi.initialize(); // should be called only once per Api.

        const { data: { items } } = await customersApi.listCustomers();

        console.log(items);
    } catch(error) {
      // process error
  }
}

Migration notes

Migration 1.10.x > 1.11.x

• Some components of CustomersApi have been extracted to:
  • AuthenticationApi includes : initiate, respond, refresh-token, and rest/verify/forget password of a customer functionality
  • InvitesApi includes: invite by customer/tenant, verify and register a customer functionality.
  • InvoicesApi includes: list invoices functionality.
  • DocumentsApi includes: list documents, upload documents and Get a presigned download url for document.
  • PaymentsApi includes: initiate/complete payment setup

import { InvoicesApi } from '@emilgroup/customer-sdk'

// First, call initiateAuthorization to get challenge information
try {
  const response = await apiAuthCustomer.initiateAuthorization("username", "password", "tenantSlug");
} catch(error) {
  // process error
}

// after receiving the SMS, call the respondToAuthorizationChallenge method
try {
  const response = await apiAuthCustomer.respondToAuthorizationChallenge({
          challengeResponses: {
              "USERNAME": username,
              "SMS_MFA_CODE": smsCode,
          },
          challengeName,
          tenantSlug,
          session,
      });

  // Customer is now logged in with customersApi and refresh-token will automatically be called.
} catch(error) {
  // process error
}

List invoices

//After login

const invoiceApi = new InvoicesApi();
try {
  const listInvoices = await invoiceApi.listInvoices({customerCode: "me"});
  if ( isMounted ) {
      const { data: { items } } = listInvoices;
  }
} catch ( error ) {
  // process error
}