swatchjs-batch

    0.1.3 • Public • Published

    swatchjs-batch

    An extension for swatchjs to provide a method to invoke multiple API methods at once.

    Quick start

    All you have to do is add a few lines of code to your existing swatchjs code. The sample below shows how to use the swatchjs-batch with the simple API from the swatchjs's README file:

    const swatch = require('swatchjs');
    const batch = require('swatchjs-batch'); // add this line
     
    const api = {
        "numbers.add": (a, b) => Number(a) + Number(b),
        "numbers.sub": (a, b) => Number(a) - Number(b),
    };
     
    const model = swatch(api);
    const batchModel = swatch({'batch': batch(model)}); // add this line
    const extendedModel = model.concat(batchModel); // optionally add this line

    Example

    const swatch = require('swatchjs');
    const batch = require('swatchjs-batch');
     
    const api = {
        "getDistance": (velocity, time) => velocity * time,
    };
     
    const model = swatch(api);
    const batchFunction = batch(model);
     
    const results = batchFunction([
       {
           method: 'getDistance',
           args: {
               velocity: 60,
               time: 2
           },
       },
       {
           method: 'getDistance',
           args: {
               velocity: 50,
               time: 1.5
           },
       },
    ]);
     
    // results is:
    // [
    //     {
    //         ok: true,
    //         result: 120
    //     },
    //     {
    //         ok: true,
    //         result: 75
    //     }
    // ]

    API reference

    The batch function

    const batch = require('swatchjs-batch');
     
    const augmentedModel = batch(model, name);

    Loading this library will result in a function (batch in the example above) which when called will return a handler that can be used with the swatch function to produce a model for the API method that allows all other methods to be invoked in a single network call.

    The function exposed by the library takes the following parameters:

    Parameter Required Description
    model Yes A model produced by by the swatch function (see swatchjs)
    name No The name of the API method. Defaults to batch.

    Return value

    The batch method returns a handler that takes the following parameters:

    Parameter Required Description
    ops Yes An array of operations to batch.
    ops[idx].method Yes The method name.
    ops[idx].args Yes An object with the arguments to pass to the method.

    The methods are not guaranteed to be executed in any particular order, and they succeed or fail independently.

    The response will be an array of responses, where each response has the following properties:

    Property Present Description
    ok Always true if the method succeed, false otherwise.
    result Sometimes Value returned by method handler if it succeeded and returned anything other than undefined.
    error Sometimes Exception thrown by method handler when it failed.

    Runtime errors

    The following errors will be generated during runtime (when invoking the handler):

    Error Error scope Description
    invalid_request Handler ops parameter was not valid.
    invalid_method Operation Specified method was not declared in the API.

    Developers

    Coding Style

    This project follows the AirBnB Javascript Coding Guidelines using ESLint settings.

    Install

    npm i swatchjs-batch

    DownloadsWeekly Downloads

    1

    Version

    0.1.3

    License

    MIT

    Unpacked Size

    14.2 kB

    Total Files

    15

    Last publish

    Collaborators

    • jaredreisinger
    • fredly
    • furchin
    • bwtimm