@kano/api-client

Intercept calls between the server and the client try to minimise them

Stats

StarsIssuesVersionUpdatedCreatedSize
@kano/api-client
3.8.152 months ago3 years agoMinified + gzip package size for @kano/api-client in KB

Readme

Kano API client

Provides a js API for browsers to communicate with our set of microservices.

Usage

  • Import the client for the service you require
  • Instanciate with options
  • Call its methods ```js import { AccountClient } from '@kano/api-client/index.js';

const account = new AccountClient({ // Where to find the API url: 'https://my-api.stuff.me', // Default headers will be sent with all requests. Has default for json defaultHeaders: { 'X-Special': 'Value', }, });

account.login('me', 'my-password').then(session => console.log(session));


You can share options across clients by giving another client to the contructor:

```js
import { AccountClient, UserClient } from '@kano/api-client/index.js';

const account = new AccountClient({
    // Where to find the API
    url: 'https://my-api.stuff.me',
});

// Same options here
const user = new UserClient(account);

Clients

Implemented clients:

  • AccountClient:
    • login(username, password)
    • register({ username, password, email, marketing })
    • checkUsernameAvailability(username)
  • UserClient:
    • getById(id)
    • getByUsername(username)

More to come

Plugins

You can add plugin to a client. A plugin is a set of methods called during the lifecycle of a request.

Example:

account.addPlugin({
    // Will be called before fetch. The endpoint about to be called will be provided
    // You can change any of its values. Adding a response property will cancel the call
    // to fetch and return the response right away
    beforeFetch(endpoint) {
        // Hi-jack the login endpoint and return static content
        // You can use this to provide offline features
        if (endpoint.name === 'login') {
            endpoint.response = {
                data: {
                    user: {
                        id: 'Hello',
                    },
                },
            };
        }
        // Alwasy return a Promise
        return Promise.resolve(endpoint);
    },
    onError(endpoint, error) {
        if (error === 'fetch failed') {
            /* Silently spoof cached response */
            endpoint.response = ResponseCache.lookup(endponint),
            return Promise.resolve(endpoint);
        } else {
            /* Log and rethrow */
            console.log(error);
            throw error;
        }
    },
    // Will return raw data as received from the API before processing
    // Use this to cache raw responses
    afterDataReceived(endpoint, data) {
        if (name === 'login') {
            console.log(data);
        }
        return Promise.resolve(data);
    },
    // Will be called after the data was received but before it is resolved to the client user
    // Use this to reformat the data, or for logging
    afterDataProcessed(endpoint, data) {
        if (name === 'login') {
            console.log(data);
        }
        return Promise.resolve(data);
    },
});

Publishing

This is an npm package and published publicly on npm. To do this, change the version number in the package.json (eg: 2.0.3 => 2.0.4), run yarn, then push and merge to master then run the following command from the root of the repo: npm publish --access public

It will require you to have an account with npm and to be logged into npm in your terminal.

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.