@basis-theory/basis-theory-js

BasisTheory JS SDK (aka BasisTheory.js)

Installation

Using Node Package Manager

npm install --save @basis-theory/basis-theory-js

Using Yarn

yarn add @basis-theory/basis-theory-js

Documentation

For a complete list of endpoints and examples, please refer to our API docs

Usage

Initialization

import { BasisTheory } from '@basis-theory/basis-theory-js';

const bt = await new BasisTheory().init('key_N88mVGsp3sCXkykyN2EFED'); // replace with your application key

Per-request configuration

All of the service methods accept an optional RequestOptions object. This is used if you want to set a correlation ID or if you want to set a per-request X-API-KEY

import { v4 as uuid } from 'uuid';

await bt.applications.list(
  {},
  {
    apiKey: 'key_N88mVGsp3sCXkykyN2EFED',
    correlationId: 'aa5d3379-6385-4ef4-9fdb-ca1341572153',
  }
);

Development

The provided scripts with the SDK will check for all dependencies, start docker, build the solution, and run all tests.

Dependencies

• Docker
• Docker Compose
• NodeJS > 10.12.0
• Yarn

Build the SDK and run Tests

Run the following command from the root of the project:

make verify