Nasal Piercings Manipulator

    keen-event-client

    1.0.2 • Public • Published

    keen-event-client

    A lightweight wrapper for dealing with the Keen.io event API.

    Although Keen.io has an extensive JS SDK, I experienced problems using it on the Tessel 1 board.

    Install with:

    npm install keen-event-client
    

    Usage

    var keen = require('keen-event-client');
     
    var client = keen.createClient({
      projectId: 'YOUR_PROJECT_ID',
      writeKey:  'YOUR_WRITE_KEY',
      masterKey: 'YOUR_MASTER_KEY'
    });
    var event = {
      temp: 74.89,
      rh: 52.17
    };
     
    keen.addEvent('climate', data, function(err, data, res) {
      if (err) {
        // there was an error!
      } else {
        // success: return value, if any, is in the data argument.
      }
    });

    API

    All callbacks are called with arguments err, data, res.

    • err is the error object, if any, otherwise null.
    • data is the object deserialized from JSON that was returned by the keen.io API. This may be null if the request did not return data.
    • res is the response object itself.

    keen.createClient(options)

    Returns an object initialized with the supplied options object. All operations performed by the instance of the client are against the keen.io project specified by options.projectId and will use the keys specified by options.writeKey or options.readKey.

    Required:

    • projectId keen.io project ID
    • writeKey keen.io write key
    • masterKey keen.io master key

    Optional:

    • urlBase defaults to https://api.keen.io
    • version defaults to 3.0

    keen.addEvent(collection, event, callback)

    Inserts a single event into the specified collection.

    Example event:

    {
      temp: 72.34,
      rh: 58.83
    }

    keen.addEvents(events, callback)

    Inserts multiple events into one or more collections. events should be an object with properties, which are the names of collections. The values of these properties should be arrays of objects, which are the events.

    events example:

    {
      climate: [{
        temp: 72.34,
        rh: 58.83
      }, {
        temp: 71.59,
        rh: 57.96
      }],
      ambient: [{
        soundLevel: 0.43,
        lightLevel: 0.39
      }]
    }

    keen.getEvent(collection, callback)

    Returns the schema information for the collection.

    data example:

    {
      properties: {
        temp: 'num',
        rh: 'num'
      }
    }

    keen.getEvents(callback)

    Returns the schema information for all collections in the project specified by options.projectId.

    data example:

    [
      {
        name: 'climate',
        url: '/3.0/projects/YOUR_PROJECT_ID/events/climate',
        properties: {
          'client.id': 'string',
          'client.created_at': 'datetime',
          temp: 'num',
          rh: 'num'
        }
      }, {
        name: 'ambient',
        url: '/3.0/projects/YOUR_PROJECT_ID/events/ambient',
        properties: {
          'client.id': 'string',
          'client.created_at': 'datetime',
          soundLevel: 'num',
          lightLevel: 'num'
        } 
      }
    ]

    License

    MIT

    Install

    npm i keen-event-client

    DownloadsWeekly Downloads

    4

    Version

    1.0.2

    License

    MIT

    Last publish

    Collaborators

    • brandondoran