1. module homebridge-nest
   1. function homebridge-nest (homebridge)
   2. function homebridge-nest.nest_connection (token, log)
   3. object homebridge-nest.nest_connection.prototype
2. module homebridge-nest.nest_connection
   1. function homebridge-nest.nest_connection (token, log)
3. module homebridge-nest.nest_connection.prototype
   1. function homebridge-nest.nest_connection.prototype.auth (clientId, clientSecret, code)
   2. function homebridge-nest.nest_connection.prototype.isOpen ()
   3. function homebridge-nest.nest_connection.prototype.open ()
   4. function homebridge-nest.nest_connection.prototype.subscribe (handler)
   5. function homebridge-nest.nest_connection.prototype.update (path, data)

module homebridge-nest

function homebridge-nest (homebridge)

• description and source-code

  homebridge-nest = function (homebridge) {
  	Service = homebridge.hap.Service;
  	Characteristic = homebridge.hap.Characteristic;
  	Accessory = homebridge.hap.Accessory;
  	uuid = homebridge.hap.uuid;
  
  	/**
  	 * Characteristic "Away"
  	 */
  	Away = function () {
  		Characteristic.call(this, 'Away', 'D6D47D29-4639-4F44-B53C-D84015DAEBDB');
  		this.setProps({
  			format: Characteristic.Formats.BOOL,
  			perms: [Characteristic.Perms.READ, Characteristic.Perms.WRITE, Characteristic.Perms.NOTIFY]
  		});
  		this.value = this.getDefaultValue();
  	};
  	inherits(Away, Characteristic);
  	Away.HOME = 0;
  	Away.AWAY = 1;
  
  	var exportedTypes = {
  		Accessory: Accessory,
  		Service: Service,
  		Characteristic: Characteristic,
  		uuid: uuid,
  		Away: Away
  	};
  
  	DeviceAccessory = require('./lib/nest-device-accessory.js')(exportedTypes);
  	ThermostatAccessory = require('./lib/nest-thermostat-accessory.js')(exportedTypes);
  	ProtectAccessory = require('./lib/nest-protect-accessory.js')(exportedTypes);
  	CamAccessory = require('./lib/nest-cam-accessory.js')(exportedTypes);
  
  	var acc = NestThermostatAccessory.prototype;
  	inherits(NestThermostatAccessory, Accessory);
  	NestThermostatAccessory.prototype.parent = Accessory.prototype;
  	for (var mn in acc) {
  		NestThermostatAccessory.prototype[mn] = acc[mn];
  	}
  
  	homebridge.registerPlatform("homebridge-nest", "Nest", NestPlatform);
  }

• example usage

  n/a

function homebridge-nest.nest_connection (token, log)

• description and source-code

  function Connection(token, log) {
  	this.token = token;
  	this.log = function(info) {
  		log(logPrefix + info);
  	};
  	this.debug = function(info) {
  		log.debug(logPrefix + info);
  	};
  	this.error = function(info) {
  		log.error(logPrefix + info);
  	};
  }

• example usage

  n/a

module homebridge-nest.nest_connection

function homebridge-nest.nest_connection (token, log)

• description and source-code

  function Connection(token, log) {
  	this.token = token;
  	this.log = function(info) {
  		log(logPrefix + info);
  	};
  	this.debug = function(info) {
  		log.debug(logPrefix + info);
  	};
  	this.error = function(info) {
  		log.error(logPrefix + info);
  	};
  }

• example usage

  n/a

module homebridge-nest.nest_connection.prototype

function homebridge-nest.nest_connection.prototype.auth (clientId, clientSecret, code)

• description and source-code

  auth = function (clientId, clientSecret, code) {
  	return rp({
  		method: 'POST',
  		uri: 'https://api.home.nest.com/oauth2/access_token',
  		form: {
  			client_id: clientId,
  			client_secret: clientSecret,
  			code: code,
  			grant_type: "authorization_code"
  		}
  	})
  	.then(function (parsedBody) {
  		var body = JSON.parse(parsedBody);
  		this.token = body.access_token;
  		return this.token;
  	}.bind(this));
  }

• example usage

  ...
  			return;
  		}
  
  		var conn = new NestConnection(token, log);
  		if (token) {
  			resolve(conn)
  		} else {
  			conn.auth(clientId, clientSecret, code)
  				.then(function(token) {
  					if (log) log.warn("CODE IS ONLY VALID ONCE! Update config to use {'token':'" + token + "'
  ;} instead.");
  					resolve(conn);
  				})
  				.catch(function(err){
  					reject(err);
  					if (log) log.warn("Auth failed which likely means the code is no longer valid. Should be able to generate a new one at
   " + authURL);
  ...

function homebridge-nest.nest_connection.prototype.isOpen ()

• description and source-code

  isOpen = function () {
  	return this.conn ? true : false;
  }

• example usage

  n/a

function homebridge-nest.nest_connection.prototype.open ()

• description and source-code

  open = function () {
  	if (!this.token) {
  		return Promise.reject(new Error("You must provide a token or auth before you can open a connection."));
  	}
  
  	this.conn = new Firebase('wss://developer-api.nest.com', new Firebase.Context());
  	return authAsync.call(this)
  		.then(function() {
  			// Register the callback to be fired every time auth state changes
  			this.conn.onAuth(authDataCallback.bind(this));
  			return this;
  		}.bind(this));
  }

• example usage

  ...
  
  		var handleUpdates = function(data){
  			updateAccessories(data, that.accessoryLookup);
  		};
  		setupConnection(this.config, this.log)
  			.then(function(conn){
  				that.conn = conn;
  				return that.conn.open();
  			})
  			.then(function(){
  				return that.conn.subscribe(handleUpdates);
  			})
  			.then(function(data) {
  				that.accessoryLookup = generateAccessories(data);
  				if (callback) {
  ...

function homebridge-nest.nest_connection.prototype.subscribe (handler)

• description and source-code

  subscribe = function (handler) {
  	var self = this;
  	return new Promise(function (resolve, reject) {
  		if (!handler){
  			reject(new Error("You must specify a handler"))
  		} else {
  			var notify = resolve || handler;
  			this.conn.on('value', function (snapshot) {
  				var data = snapshot.val();
  				if (data) {
  					notify(data);
  					notify = handler;
  				} else {
  					self.log("Disconnect Detected");
  				}
  			});
  		}
  	}.bind(this));
  }

• example usage

  ...
  		};
  		setupConnection(this.config, this.log)
  			.then(function(conn){
  				that.conn = conn;
  				return that.conn.open();
  			})
  			.then(function(){
  				return that.conn.subscribe(handleUpdates);
  			})
  			.then(function(data) {
  				that.accessoryLookup = generateAccessories(data);
  				if (callback) {
  					var copy = that.accessoryLookup.map(function (a) { return a; });
  					callback(copy);
  				}
  ...

function homebridge-nest.nest_connection.prototype.update (path, data)

• description and source-code

  update = function (path, data) {
  	var child = this.conn.child(path);
  	return Promise.fromCallback(child.set.bind(child, data));
  }

• example usage

  ...
      return 'devices/' + this.deviceGroup + '/' + this.deviceId + '/' + property;
  };
  
  NestDeviceAccessory.prototype.updateDevicePropertyAsync = function(property, value, propertyDescription, valueDescription) {
      propertyDescription = propertyDescription || property;
      valueDescription = valueDescription || value;
      this.log("Setting " + propertyDescription + " for " + this.name + " to: " + valueDescription);
      return this.conn.update(this.getDevicePropertyPath(property), value)
          .return(value);
  };
  
  NestDeviceAccessory.prototype.getStructurePropertyPath = function(property) {
      return 'structures/' + this.structureId + '/' + property;
  };
  ...