// Copyright (c) 2012 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. /** * @fileoverview * The deserialized form of the chromoting host as returned by Apiary. */ 'use strict'; /** @suppress {duplicate} */ var remoting = remoting || {}; /** * Note that the object has more fields than are detailed below--these * are just the ones that we refer to directly. * @constructor */ remoting.Host = function() { /** @type {string} */ this.hostName = ''; /** @type {string} */ this.hostId = ''; /** @type {string} */ this.status = ''; /** @type {string} */ this.jabberId = ''; /** @type {string} */ this.publicKey = ''; /** @type {string} */ this.hostVersion = ''; /** @type {Array.<string>} */ this.tokenUrlPatterns = []; /** @type {string} */ this.updatedTime = ''; }; /** * Determine whether a host needs to be manually updated. This is the case if * the host's major version number is more than 1 lower than that of the web- * app (a difference of 1 is tolerated due to the different update mechanisms) * and if the host is on-line (off-line hosts are not expected to auto-update). * * @param {remoting.Host} host The host information from the directory. * @param {string|number} webappVersion The version number of the web-app, in * either dotted-decimal notation notation, or directly represented by the * major version. * @return {boolean} True if the host is on-line but out-of-date. */ remoting.Host.needsUpdate = function(host, webappVersion) { if (host.status != 'ONLINE') { return false; } var hostMajorVersion = parseInt(host.hostVersion, 10); if (isNaN(hostMajorVersion)) { // Host versions 26 and higher include the version number in heartbeats, // so if it's missing then the host is at most version 25. hostMajorVersion = 25; } return (parseInt(webappVersion, 10) - hostMajorVersion) > 1; };