[Webapp Refactor] Implements remoting.Activity.

remoting/webapp/crd/js/client_session.js

 // 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
  * Class handling creation and teardown of a remoting client session.
  *
  * The ClientSession class controls lifetime of the client plugin
  * object and provides the plugin with the functionality it needs to
@@ skipping 74 matching lines @@
 
   /** @private {remoting.ClientPlugin} */
   this.plugin_ = plugin;
   plugin.setConnectionEventHandler(this);
 
   this.defineEvents(Object.keys(remoting.ClientSession.Events));
 };
 
 /** @enum {string} */
 remoting.ClientSession.Events = {
-  stateChanged: 'stateChanged',
+  stateChanged: 'stateChanged', // deprecated.
   videoChannelStateChanged: 'videoChannelStateChanged',
 };
 
+/**
+ * @interface
+ * [START]-------> [onConnected] ------> [onDisconnected]
+ *    |                              |
+ *    |-----> [OnConnectionFailed]   |----> [onError]
+ *
+ * TODO(kelvinp): Route session state changes through this interface.
+ */
+remoting.ClientSession.EventHandler = function() {};
+
+/**
+ * Called when the connection failed before it is connected.
+ *
+ * @param {!remoting.Error} error
+ */
+remoting.ClientSession.EventHandler.prototype.onConnectionFailed =
+    function(error) {};
+
+/**
+ * Called when a new session has been connected.  The |connectionInfo| will be
+ * valid until onDisconnected() or onError() is called.
+ *
+ * @param {!remoting.ConnectionInfo} connectionInfo
+ */
+remoting.ClientSession.EventHandler.prototype.onConnected =
+    function(connectionInfo) {};
+
+/**
+ * Called when the current session has been disconnected.
+ */
+remoting.ClientSession.EventHandler.prototype.onDisconnected = function() {};
+
+/**
+ * Called when an error needs to be displayed to the user.
+ * @param {!remoting.Error} error
+ */
+remoting.ClientSession.EventHandler.prototype.onError = function(error) {};
+
 // Note that the positive values in both of these enums are copied directly
 // from connection_to_host.h and must be kept in sync. Code in
 // chromoting_instance.cc converts the C++ enums into strings that must match
 // the names given here.
 // The negative values represent state transitions that occur within the
 // web-app that have no corresponding plugin state transition.
 /** @enum {number} */
 remoting.ClientSession.State = {
   CONNECTION_CANCELED: -3,  // Connection closed (gracefully) before connecting.
   CONNECTION_DROPPED: -2,  // Succeeded, but subsequently closed with an error.
@@ skipping 428 matching lines @@
  * errors should not be logged because the JID will be refreshed and the
  * connection retried.
  *
  * @param {boolean} enable True to log host-offline errors; false to suppress.
  */
 remoting.ClientSession.prototype.logHostOfflineErrors = function(enable) {
   this.logHostOfflineErrors_ = enable;
 };
 
 /**
- * Request pairing with the host for PIN-less authentication.
- *
- * @param {string} clientName The human-readable name of the client.
- * @param {function(string, string):void} onDone Callback to receive the
- *     client id and shared secret when they are available.
- */
-remoting.ClientSession.prototype.requestPairing = function(clientName, onDone) {
-  if (this.plugin_) {
-    this.plugin_.requestPairing(clientName, onDone);
-  }
-};
-
-/**
  * Sends a clipboard item to the host.
  *
  * @param {string} mimeType The MIME type of the clipboard item.
  * @param {string} item The clipboard item.
  */
 remoting.ClientSession.prototype.sendClipboardItem = function(mimeType, item) {
   if (!this.plugin_)
     return;
   this.plugin_.sendClipboardItem(mimeType, item);
 };
@@ skipping 33 matching lines @@
     'https://docs.google.com/feeds/',
     'https://www.googleapis.com/auth/drive'
   ];
   remoting.identity.getNewToken(googleDriveScopes).
       then(sendToken).
       catch(remoting.Error.handler(sendError));
   window.setTimeout(this.sendGoogleDriveAccessToken_.bind(this),
                     remoting.ACCESS_TOKEN_RESEND_INTERVAL_MS);
 };