1 files changed, 50 insertions, 0 deletions
diff --git a/sync/js/js_controller.h b/sync/js/js_controller.h
new file mode 100644
index 0000000..d0deb20
--- /dev/null
+++ b/sync/js/js_controller.h
@@ -0,0 +1,50 @@
+// 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.
+
+#ifndef SYNC_JS_JS_CONTROLLER_H_
+#define SYNC_JS_JS_CONTROLLER_H_
+#pragma once
+
+// See README.js for design comments.
+
+#include <string>
+
+namespace browser_sync {
+
+class JsArgList;
+class JsEventHandler;
+class JsReplyHandler;
+template <typename T> class WeakHandle;
+
+// An interface for objects that JsEventHandlers directly interact
+// with.  JsEventHandlers can add themselves to receive events and
+// also send messages which will eventually reach the backend.
+class JsController {
+ public:
+  // Adds an event handler which will start receiving JS events (not
+  // immediately, so this can be called in the handler's constructor).
+  // Multiple event handlers are supported, but each event handler
+  // must be added at most once.
+  //
+  // Ideally, we'd take WeakPtrs, but we need the raw pointer values
+  // to be able to look them up for removal.
+  virtual void AddJsEventHandler(JsEventHandler* event_handler) = 0;
+
+  // Removes the given event handler if it has been added.  It will
+  // immediately stop receiving any JS events.
+  virtual void RemoveJsEventHandler(JsEventHandler* event_handler) = 0;
+
+  // Processes a JS message.  The reply (if any) will be sent to
+  // |reply_handler| if it is initialized.
+  virtual void ProcessJsMessage(
+      const std::string& name, const JsArgList& args,
+      const WeakHandle<JsReplyHandler>& reply_handler) = 0;
+
+ protected:
+  virtual ~JsController() {}
+};
+
+}  // namespace browser_sync
+
+#endif  // SYNC_JS_JS_CONTROLLER_H_