usergrid-nodejs
Node.js SDK 2.0 for Usergrid
Currently a work in progress; documentation and implementation are subject to change.
Current release
Release Candidate 0, available here or on npm
Bugs
Please open an issue
Known Issues
- AuthFallback is incomplete; currently there is no ad-hoc implementation for authentication (e.g. you cannot pass a instance of UsergridAuth, nor can you force a call to be made unauthenticated if there is a stored token)
- Authentication header is missing from certain API calls that don't leverage the UsergridRequest class. Recommend refactoring UsergridRequest to support all types of API calls (including login, logout, reset password)
- Assets are not implemented yet
- Many missing tests around authentication and passing a UsergridClient as a separate instance
- Easy (clean) way to load the UsergridClient module without referencing the full path
- Any other functionality that is missing or expected, please open an issue
Installation
Install from npm, specifying the version >= 2.0.0-rc.0:
npm install usergrid >=2.0.0-rc.0
If you want to run the latest build, simply:
npm install r3mus/usergrid-nodejs
(though you will need to run npm install
to keep it up to date)
Usage
Note: This section is left intentionally light. In its current release candidate state, this SDK is only recommended for developers familiar with Usergrid, Node.js, and preferably Mocha tests. For full usage and implementation, have a look in /tests
.
There are two fundamental ways to use the new Node SDK:
-
Singleton pattern:
var Usergrid = require('usergrid')
Usergrid.init({
orgId: ...,
appId: ...
}
// or from a config file, see config.sample.json
var Usergrid = require('usergrid')
Usergrid.init() // defaults to use config.json
-
Instance pattern (primarily used when connecting to multiple Usergrid targets):
var UsergridClient = require('./node_modules/usergrid/lib/client')
var client = new UsergridClient(config)