0.1.6 • Published 4 months ago

authpi v0.1.6

Weekly downloads
-
License
BSD-3-Clause
Repository
github
Last release
4 months ago

AuthPI Core API client library in TypeScript

NPM Version

Official library for interacting with the AuthPI Core API in TypeScript in a server-side environments.

Installation

npm install authpi

Usage

(recommended) With a default issuer ID

import { AuthPI } from 'authpi';

const authpi = new AuthPI({
    accountId: 'your-account',
    issuerId: 'issuer-id',
    key: 'client-credentials',
});

const user = await authpi.users.create({
    username: 'john.doe@gmail.com'
});

Without a default issuer ID:

This mode is useful when you need to interact with multiple issuers, for example platform applications and agencies.

import { AuthPI } from 'authpi';

const authpi = new AuthPI({
    accountId: 'your-account',
    key: 'client-credentials'
});

const user = await authpi.issuers.as('issuer-id').users.create({
    username: 'john.doe@gmail.com'
});

Configuration

The AuthPI object can be configured with the following options:

const authpi = new AuthPI({
    accountId: 'your-account',
    issuerId: 'issuer-id',
    key: 'client-credentials',
    token: 'access-token',
    timeout: 15000,
    telemetry: true,
    _fetch: fetch,
});
OptionDefaultDescription
accountIdYour AuthPI account ID
issuerIdA default issuer ID to use when needed
keyA key that can be generated in your AuthPI dashboard. One of the key or token must be present.
tokenAn access token to use instead of the key. One of the key or token must be present.
timeout15000Request timeout in milliseconds
telemetrytrueWhether to send telemetry data to AuthPI
_fetchfetchA custom fetch implementation to use

Examining Responses

Some information about the response is available with the lastResponse property in the same namespace as the method that was called.

authpi.users.create({ username: 'john.doe@gmail.com' });

authpi.users.lastResponse.headers

License

This project is licensed under the BSD 3-Clause License. See the LICENSE file for details.

0.1.6

4 months ago

0.1.4

8 months ago

0.1.5

8 months ago

0.1.3

10 months ago

0.1.2

10 months ago

0.1.1

10 months ago

0.0.1

10 months ago