| // 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; |
| }; |