@bergx/bergx-sdk v1.0.1

Bergx SDK

The offical Bergx SDK for Javascript, works on browsers, mobile devices and node.js.

Bergx is a set of modules to get you moving quickly on your next project.

• User Authentication
• Authorization
• Feature Switches
• Advanced A/B Testing

Getting Started

Create an account here: https://www.bergx.io Just follow the quick start to create an organization and an application. You will need to create a client in order to interact with the API.

npm install @bergx/bergx-sdk
# or
yarn add @bergx/bergx-sdk

Usage

const bx = new BergxSDK({
  clientId: '{{clientId}}',
  clientSecret: '{{clientSecret}}',
});

// Feature Switch example
const createRes = await bx.createSwitch({
	name: "awesome-feature",
	type: "basic",
	value: "true"
});
const awesomeFeature = await bx.checkSwitch('awesome-feature', {username: 'cool guy'});
console.log(awesomeFeature); // true

API

Documentation of the raw api can be found here: https://documenter.getpostman.com/view/1097302/SWLmW44o?version=latest

There are four basic modules provided by the Bergx SDK, User Authentication, User Authorization, Feature Switches, and Advanced A/B testing. Each module has its own section below.

Initialization

Creating a new Bergx instance

The SDK is provided in a single class and is initialized using the BxConfig type. Everything is Javascript or Typescript compatible.

Types:

BxConfig Object:

Example:

interface BxConfig {
  clientId: string;
  clientSecret: string;
  host?: string;
  updateAccessTokenCallback?: (userSub: string, newAccessToken: string) => void;
}

const bx = new BergxSDK({
  clientId: '{{clientId}}',
  clientSecret: '{{clientSecret}}',
  host: 'https://p01.bergx.io',
  updateAccessTokenCallback: (userSub: string, newAccessToken: string) => {
    db.saveUser({userId: userSub, accessToken: newAccessToken});
  }
});

Once the SDK has been initialized with a clientId and secret most calls will automatically authenticate. But any calls to the user profile endpoints will require accessTokens that are scoped to the user rather than the client. For information on how to use the User Authentication module refer to the example project in ./examples/.

User Authentication/Profile

Types:

BxUser Object:

interface BxUser {
  accessToken: string;
  refreshToken: string;
}

User Object:

interface User {
  claims: BxUserClaims;
  organizations: string[];
}

BxUserClaims Object:

BxUserClaims is based on the OpenID Connect Standard user claims object. Please refer to the OpenID Connect Claims object documentation for more details https://openid.net/specs/openid-connect-core-1_0.html#StandardClaims.

All other standard claims are supported.

getProfile(user: BxUser): Promise<{status: string, user: User}>

Returns a status (string) and a User object.

Example response:

{
  "status": "success",
  "user": {
    "claims": {
      "email": "testUser@example.com",
      "updated_at": 1588647477,
      "preferred_username": "testUser",
      "sub": "{{uuid}}",
      "email_verified": true
    },
    "organizations": []
  }
}

Usage:

const user = await bx.getProfile({
  accessToken,
  refreshToken
});

updateProfile(user: BxUser, data: BxUserClaims)

Updates the user profile in Bergx. Requires a user's accessToken.

Example response:

{
  "status": "success",
  "user": {
    "claims": {
      "email": "testUser@example.com",
      "updated_at": 1588647477,
      "preferred_username": "testUser",
      "sub": "{{uuid}}",
      "email_verified": true
    },
    "organizations": []
  }
}

Usage:

const user = await bx.getProfile({
  accessToken,
  refreshToken
});