hue.js/lib/Hue.js

Library for interacting with a Phillips Hue base station

var util         = require('util');
var Crypto       = require('crypto');
var request      = require('request');
var EventEmitter = require('events').EventEmitter;
var Helpers      = require('./helpers.js');
var path         = require('path');

module.exports = Hue;
util.inherits(Hue,EventEmitter);

function Hue(config) {
  EventEmitter.call(this);

  if (!config.stationIp)
    throw new Error('Base station IP is required');

  if (!config.appName)
    throw new Error('Application name is required');

  this._station = config.stationIp;
  this._app = config.appName;
  this._key = Crypto.createHash('md5').update(config.appName).digest("hex");
  this._authenticated = false;
};

Hue.prototype.lights = function(cb) {

  var opts = {
    url:'http://'+this._station+'/api/'+this._key+'/lights',
    json:true,
    timeout:30000
  };

  request(opts,function(e,r,b) {

    if (e) cb(e)
    else if (typeof cb === "function") cb.apply(this,Helpers.parseHueResponse(b));
  });
  return this;
};

Hue.prototype.light = function(light,cb) {

  var opts = {
    method:'GET',
    url:'http://'+this._station+'/api/'+this._key+'/lights/'+light,
    json:{on:true},
    timeout:30000
  };

  request(opts,function(e,r,b) {

    if (e) cb(e)
    else if (typeof cb === "function") cb.apply(this,Helpers.parseHueResponse(b));
  });
  return this;
};

Hue.prototype.rename = function(light,name,cb) {

  var opts = {
    method:'PUT',
    url:'http://'+this._station+'/api/'+this._key+'/lights/'+light,
    json:{'name':name},
    timeout:30000
  };

  request(opts,function(e,r,b) {

    if (e) cb(e)
    else if (typeof cb === "function") cb.apply(this,Helpers.parseHueResponse(b));
  });
  return this;
};

Hue.prototype.state = function(light,state,cb) {

  var opts = {
    method:'PUT',
    url:'http://'+this._station+'/api/'+this._key+'/lights/'+light+'/state',
    json:state,
    timeout:30000
  };

  request(opts,function(e,r,b) {

    if (e) cb(e)
    else if (typeof cb === "function") cb.apply(this,Helpers.parseHueResponse(b));
  });
  return this;
};

Hue.prototype.on = function(light,cb) {

  var opts = {
    method:'PUT',
    url:'http://'+this._station+'/api/'+this._key+'/lights/'+light+'/state',
    json:{on:true},
    timeout:30000
  };

  request(opts,function(e,r,b) {

    if (e) cb(e)
    else if (typeof cb === "function") cb.apply(this,Helpers.parseHueResponse(b));
  });
  return this;
};

Hue.prototype.off = function(light,cb) {
  var opts = {
    method:'PUT',
    url:'http://'+this._station+'/api/'+this._key+'/lights/'+light+'/state',
    json:{on:false},
    timeout:30000
  };

  request(opts,function(e,r,b) {
    if (e) cb(e)
    else if (typeof cb === "function") cb.apply(this,Helpers.parseHueResponse(b));
  });
  return this;
};

Hue.prototype.rgb = function(light,r,g,b,cb) {

  var hsv = Helpers.rgb2hsv(r,g,b);
  var params = {
    hue:182*hsv[0],
    sat:Math.ceil(254*hsv[1]),
    bri:Math.ceil(254*hsv[2])
  }

  var opts = {
    method:'PUT',
    url:'http://'+this._station+'/api/'+this._key+'/lights/'+light+'/state',
    json:params,
    timeout:30000
  };

  request(opts,function(e,r,b) {
    if (e) cb(e)
    else if (typeof cb === "function") cb.apply(this,Helpers.parseHueResponse(b));
  });
  return this;
};

Hue.prototype.register = function(_opts,cb) {

  if (typeof _opts === "function") {
    cb = _opts;
    _opts = {};
  }

  var a = 0;  // Attempt counter
  var _defaults = {
    interval:3000,
    attempts:0,
    devicetype: this._app,
    username: this._key
  };

  for (var i in _opts) _defaults[i] = _opts[i];
  var opts = _defaults;

  var params = {
    url:'http://'+this._station+'/api',
    method:'POST',
    json: {
      devicetype:opts.devicetype,
      username:opts.username
    }
  };

  var makeRequest = function() {

    request(params,function(e,r,b) {
      if (e) {
        setTimeout(makeRequest,opts.interval);
        return;
      }
      var resp = b[0];
      if (resp.error && resp.error.type === 101) {
        if (opts.attempts === 0 || a<=opts.attempts) {
          a++;
          setTimeout(makeRequest,opts.interval);
          return;
        }
      }

      cb.apply(this,Helpers.parseHueResponse(b));
    });
  }

  makeRequest();
  return this;
};

Hue.prototype.unregister = function(_key, cb) {
  if (typeof _key === "function") {
    cb = _key;
    _key = this._key;
  }

  var opts = {
    url:'http://'+this._station+'/api/'+this._key+'/config/whitelist/'+_key,
    method:'DELETE',
    timeout:30000
  };

  request(opts,function(e,r,b) {

    if (e) cb(e)
    else if (typeof cb === "function") cb.apply(this,Helpers.parseHueResponse(b));
  });
  return this;
};


Hue.prototype.config = function(config,cb) {

  if (typeof config === "function") {
    method = 'GET';
    json = true;
    cb = config;
  } else {
    method = 'PUT';
    json = config;
  }

  var opts = {
    method:method,
    url:'http://'+this._station+'/api/'+this._key+'/config',
    json:json,
    timeout:30000
  };

  request(opts,function(e,r,b) {

    if (e) cb(e)
    else if (typeof cb === "function") cb.apply(this,Helpers.parseHueResponse(b));
  });
  return this;
};

Hue.prototype.station = function(config,cb) {

  if (typeof config === "function") {
    method = 'GET';
    json = true;
    cb = config;
  } else {
    method = 'PUT';
    json = config;
  }

  var opts = {
    method:method,
    url:'http://'+this._station+'/api/'+this._key,
    json:json,
    timeout:30000
  };

  request(opts,function(e,r,b) {

    if (e) cb(e)
    else if (typeof cb === "function") cb.apply(this,Helpers.parseHueResponse(b));
  });
  return this;
};