Improve web-app type safety.

remoting/webapp/me2mom/wcs.js

 /* Copyright (c) 2011 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
  * A class that provides an interface to a WCS connection.
  */
 
 'use strict';
 
 /** @suppress {duplicate} */
 var remoting = remoting || {};
 
-(function() {
+/** @type {remoting.Wcs} */
+remoting.wcs = null;
+
 /**
  * @constructor
  *
  * @param {remoting.WcsIqClient} wcsIqClient The WCS client.
  * @param {string} token An OAuth2 access token.
  * @param {function(): void} onReady A function called when the WCS client has
  *     received a full JID.
  * @param {function(function(string): void): void} refreshToken A function
  *     called when this object wants to see whether an updated access token is
  *     available. The passed function will be called asynchronously with a
@@ skipping 21 matching lines @@
    */
   this.onReady_ = onReady;
 
   /**
    * The full JID of the WCS client.
    * @type {string}
    * @private
    */
   this.clientFullJid_ = '';
 
+  /** @type {remoting.Wcs} */
   var that = this;
   /**
    * A timer that polls for an updated access token.
    * @type {number}
    * @private
    */
   this.pollForUpdatedToken_ = setInterval(
       function() { refreshToken(that.setToken_); },
       60 * 1000);
 
   /**
    * A function called when an IQ stanza is received.
-   * @type {function(string): void}
+   * @param {string} stanza The IQ stanza.
    * @private
    */
   this.onIq_ = function(stanza) {};
 
   // Handle messages from the WcsIqClient.
-  this.wcsIqClient_.setOnMessage(function(msg) { that.onMessage_(msg); });
+  /** @param {Array.<string>} msg An array of message strings. */
+  var onMessage = function(msg) { that.onMessage_(msg); };
+  this.wcsIqClient_.setOnMessage(onMessage);
 
   // Start the WcsIqClient.
   this.wcsIqClient_.connectChannel();
 };
 
 /**
  * Passes an access token to the WcsIqClient, if the token has been updated.
  *
  * @param {string} tokenNew A (possibly updated) access token.
  * @return {void} Nothing.
  * @private
  */
 remoting.Wcs.prototype.setToken_ = function(tokenNew) {
   if (tokenNew != this.token_) {
     this.token_ = tokenNew;
     this.wcsIqClient_.updateAccessToken(this.token_);
   }
 };
 
 /**
  * Handles a message coming from the WcsIqClient.
  *
- * @param {Array} msg The message.
+ * @param {Array.<string>} msg The message.
  * @return {void} Nothing.
  * @private
  */
 remoting.Wcs.prototype.onMessage_ = function(msg) {
   if (msg[0] == 'is') {
     this.onIq_(msg[1]);
   } else if (msg[0] == 'cfj') {
     this.clientFullJid_ = msg[1];
     remoting.debug.log('Received JID: ' + this.clientFullJid_);
     this.onReady_();
@@ skipping 23 matching lines @@
 /**
  * Sets the function called when an IQ stanza is received.
  *
  * @param {function(string): void} onIq The function called when an IQ stanza
  *     is received.
  * @return {void} Nothing.
  */
 remoting.Wcs.prototype.setOnIq = function(onIq) {
   this.onIq_ = onIq;
 };
-
-}());