SparkJS: A Javascript library for Spark devices

SparkJS is a library for interacting with your cores and the Spark Cloud. It uses node.js and can run on Windows, Mac OS X, and Linux fairly easily. It can also run in the browser without node.js. It's also open source so you can edit, change or even send in pull requests if you want to share!

Documentation

Complete documentation can be found in Spark Docs

Installation

First, make sure you have node.js installed!

Next, open a command prompt or terminal, and install by typing:

$ npm install -g spark

Usage

var Spark = require('spark');

Spark.login({ username: 'email@example.com', password: 'password' }, function(err, body) {
  console.log('API call login completed on callback:', body);
});

For further examples visit /examples directory: https://github.com/spark/sparkjs/tree/master/examples

Complete documentation can be found in Spark Docs

Getting Started

It's important that you login before executing any command.

Every function returns a promise for you to handle the async result, or you can pass a callback function. (Please note that if a callback function is passed, the function will return null instead of a promise)

More examples on how to use promises/callbacks visit: https://github.com/spark/sparkjs/tree/master/examples

Supported commands

compileCode
createUser
callFunction
claimCore
downloadBinary
flashCore
getAttributes
getAttributesForAll
getEventStream
getVariable
listDevices
login
onEvent
publishEvent
removeCore
removeToken
renameCore
signalCore

Device object

You can get a list of devices by calling: Spark.devices

Each device has the following parameters:

name
connected
variables
functions
version
requiresUpgrade

And you can call the following commands on it:

callFunction
claim
flash
subscribe
getVariable
onEvent
remove
rename
sendPublicKey
signal
stopSignal
getAttributes

Complete documentation can be found in Spark Docs

Setup your dev environment

Install your local dependencies:

$ npm install

Install globally mocha, istanbul uglify-js and jshint

$ npm install -g mocha
$ npm install -g istanbul
$ npm install -g uglify-js
$ npm install -g jshint

How to test

make test

Lint your code

make lint

Coverage report

make cover

Release History

Version 0.1.0 Initial release Version 0.2.1 Publishing, test release Version 0.2.2 Pulling in getDevice Version 0.2.4 adding some basic parsing to the getEventStream function, now returns an object Version 0.2.5 fixing a callback param bug in getEventStream Version 0.2.6 fixing minified js

p3tuh/sparkjs