user-api-client v0.5.2

user-api-client

Docs

This is a library that makes it easier for servers that are talking to the Tidepool User API.

Setup

require('user-api-client')(config, hostGetter, request);

• config -- an object containing configuration parameters
• hostGetter -- an object with a get() method. The get() method should return an array of objects that can be passed into url.format() to produce a valid url to talk to.
• httpClient -- (optional) -- the result of require('./httpClient.js')(config). This is primarily exposed to allow for mocking in tests. If not supplied a new "correct" one will be created.
• members -- client and middleware.

Client

login

• login (username, password, cb) Frontend to the API call to log in a user username -- string password -- password cb (err, response) err -- null if no error, else an error object * response -- result from the /user/login api call

getAnonymousPair

• getAnonymousPair (userid, cb) Frontend to the API call to retrieve a pair from the user object without storing it userid -- Tidepool-assigned userid cb (err, response) err -- null if no error, else an error object response -- result from the /user/private api call

checkToken

• checkToken (token, cb) Frontend to the API call to check the validity of a server or user token token -- the server token to be checked cb (err, response) err -- null if no error, else an object response -- result from the /user/token api call

createUser

• createUser (userObj, cb) Frontend to the API call to create a user userObj -- object containing username, emails and password fields at minimum cb (err, response) err -- null if no error, else an error object response -- result from the /user/user api call

withServerToken

• withServerToken (cb) Calls CB with a valid server token, iff one can be retrieved cb (err, token) err -- always null if callback is called at all * token -- a valid server token

Middleware

expressify

• expressify (middlewareFn) Converts restify middleware into express middleware. * middlewareFn -- the restify middleware Returns: middleware that works with express

checkToken

• checkToken (client) Middleware to process the session token -- expects a token in a request header, processes it, and returns information about the token in the _tokendata variable on the request. * client -- client to use when talking to the user-api