@inboxsdk/core 0.2.28-alpha.0 → 0.2.28-alpha.2

package/src/platform-implementation-js/lib/routeIDmatchesHash.js

@@ -0,0 +1,20 @@
+/* @flow */
+
+import memoize from 'lodash/memoize';
+import find from 'lodash/find';
+import escapeRegExp from 'lodash/escapeRegExp';
+
+const routeIDtoRegExp: (routeID: string) => RegExp = memoize(
+  (routeID) =>
+    new RegExp(
+      '^' + escapeRegExp(routeID).replace(/\/:[^/]+/g, '/([^/]+)') + '/?$'
+    )
+);
+
+export default function routeIDmatchesHash(
+  routeID: string | Array<string>,
+  hash: string
+): ?string {
+  const routeIDs = Array.isArray(routeID) ? routeID : [routeID];
+  return find(routeIDs, (routeID) => hash.match(routeIDtoRegExp(routeID)));
+}

package/src/platform-implementation-js/lib/routeIDmatchesHash.test.js

@@ -0,0 +1,23 @@
+/* @flow */
+
+import routeIDmatchesHash from './routeIDmatchesHash';
+
+test('single parameter-less route works', () => {
+  expect(routeIDmatchesHash('foo/bar/def', 'foo/bar/def')).toBe('foo/bar/def');
+  expect(routeIDmatchesHash('foo/bar/def', 'foo/bax/def')).toBe(undefined);
+});
+
+test('array works', () => {
+  expect(routeIDmatchesHash(['foo', 'bar'], 'foo')).toBe('foo');
+  expect(routeIDmatchesHash(['foo', 'bar'], 'bar')).toBe('bar');
+  expect(routeIDmatchesHash(['foo', 'bar'], 'blah')).toBe(undefined);
+});
+
+test('parameter works', () => {
+  expect(routeIDmatchesHash('foo/:bar/def/:blah', 'foo/123/def/x1')).toBe(
+    'foo/:bar/def/:blah'
+  );
+  expect(routeIDmatchesHash('foo/:bar/def/:blah', 'foo/123/xef/x1')).toBe(
+    undefined
+  );
+});

package/src/platform-implementation-js/lib/safe-event-emitter.d.ts

@@ -3,3 +3,4 @@ import EventEmitter from 'events';
 export default class SafeEventEmitter extends EventEmitter {
     emit(event: string, ...args: Array<any>): boolean;
 }
+//# sourceMappingURL=safe-event-emitter.d.ts.map

package/src/platform-implementation-js/lib/safe-event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-event-emitter.d.ts","sourceRoot":"","sources":["../../../../../src/platform-implementation-js/lib/safe-event-emitter.ts"],"names":[],"mappings":";AAAA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAQlC,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,YAAY;IACjD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO;CAQzD"}

package/src/platform-implementation-js/lib/shared-style.js

@@ -0,0 +1,22 @@
+/* @flow */
+
+import type Kefir from 'kefir';
+import udKefir from 'ud-kefir';
+import rewriteCssWithIdMap from './rewriteCssWithIdMap';
+var fs = require('fs');
+var cssContent: Kefir.Observable<string> = udKefir(
+  module,
+  fs.readFileSync(__dirname + '/../style/shared.css', 'utf8')
+);
+
+export default function sharedStyle(root: Document = document) {
+  if (!root.getElementById('inboxsdk__shared_style')) {
+    const style = root.createElement('style');
+    style.id = 'inboxsdk__shared_style';
+    cssContent.onValue((css) => {
+      style.textContent = rewriteCssWithIdMap(css);
+    });
+    if (!root.head) throw new Error('missing head');
+    root.head.appendChild(style);
+  }
+}

package/src/platform-implementation-js/lib/stopper-pool.d.ts

@@ -8,3 +8,4 @@ export default class StopperPool<V, E> {
     add(newStreams: Kefir.Observable<V, E> | Kefir.Observable<V, E>[]): void;
     getSize(): number;
 }
+//# sourceMappingURL=stopper-pool.d.ts.map

package/src/platform-implementation-js/lib/stopper-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopper-pool.d.ts","sourceRoot":"","sources":["../../../../../src/platform-implementation-js/lib/stopper-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,MAAM,CAAC,OAAO,OAAO,WAAW,CAAC,CAAC,EAAE,CAAC;IACnC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAsB;IAC5B,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAGpC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAuBrD,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAWjE,OAAO,IAAI,MAAM;CAGzB"}

package/src/platform-implementation-js/lib/stream-wait-for.d.ts

@@ -7,3 +7,4 @@ import * as Kefir from 'kefir';
  * get tripped.
  */
 export default function streamWaitFor<T>(condition: () => T | null | undefined, timeout?: number, steptime?: number): Kefir.Observable<T, Error>;
+//# sourceMappingURL=stream-wait-for.d.ts.map

package/src/platform-implementation-js/lib/stream-wait-for.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-wait-for.d.ts","sourceRoot":"","sources":["../../../../../src/platform-implementation-js/lib/stream-wait-for.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,CAAC,EACrC,SAAS,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EACrC,OAAO,GAAE,MAAkB,EAC3B,QAAQ,GAAE,MAAY,GACrB,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAwB5B"}

package/src/platform-implementation-js/lib/toItemWithLifetimeStream.d.ts

@@ -0,0 +1,7 @@
+import type LiveSet from 'live-set';
+import * as Kefir from 'kefir';
+import type { ItemWithLifetime } from './dom/make-element-child-stream';
+
+export default function toItemWithLifetimeStream<T>(
+  liveSet: LiveSet<T>
+): Kefir.Observable<ItemWithLifetime<T>, never>;

package/src/platform-implementation-js/lib/toItemWithLifetimeStream.js

@@ -0,0 +1,18 @@
+/* @flow */
+
+import type LiveSet from 'live-set';
+import toValueObservable from 'live-set/toValueObservable';
+import Kefir from 'kefir';
+import type { ItemWithLifetime } from './dom/make-element-child-stream';
+
+export default function toItemWithLifetimeStream<T>(
+  liveSet: LiveSet<T>
+): Kefir.Observable<ItemWithLifetime<T>> {
+  return Kefir.fromESObservable(
+    toValueObservable(liveSet).map((event) => {
+      const removal: Promise<void> = event.removal;
+      const removalStream = Kefir.fromPromise(removal);
+      return { el: event.value, removalStream };
+    })
+  );
+}

package/src/platform-implementation-js/lib/toLiveSet.js

@@ -0,0 +1,31 @@
+/* @flow */
+
+import LiveSet from 'live-set';
+import type Kefir from 'kefir';
+import type { ItemWithLifetime } from './dom/make-element-child-stream';
+
+export default function toLiveSet<T>(
+  itemWithLifetimeStream: Kefir.Observable<ItemWithLifetime<T>>
+): LiveSet<T> {
+  return new LiveSet({
+    read() {
+      throw new Error('should not happen; liveset was inactive');
+    },
+    listen(setValues, controller) {
+      setValues(new Set());
+
+      const sub = itemWithLifetimeStream.observe({
+        value({ el, removalStream }) {
+          controller.add(el);
+          removalStream.take(1).onValue(() => {
+            controller.remove(el);
+          });
+        },
+      });
+
+      return () => {
+        sub.unsubscribe();
+      };
+    },
+  });
+}

package/src/platform-implementation-js/lib/wait-for.d.ts

@@ -1 +1,2 @@
-export default function waitFor<T>(condition: () => T | null | undefined, timeout?: number, steptime?: number): Promise<T>;
+export default function waitFor<T>(condition: () => T | null | undefined, timeout?: number, steptime?: number): Promise<NonNullable<T>>;
+//# sourceMappingURL=wait-for.d.ts.map

package/src/platform-implementation-js/lib/wait-for.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for.d.ts","sourceRoot":"","sources":["../../../../../src/platform-implementation-js/lib/wait-for.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,CAAC,EAC/B,SAAS,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EACrC,OAAO,GAAE,MAAmB,EAC5B,QAAQ,GAAE,MAAY,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAyBzB"}

package/src/platform-implementation-js/lib/waitForAsync.d.ts

@@ -1 +1,2 @@
 export default function waitForAsync<T>(condition: () => Promise<T | null | undefined>, timeout?: number, steptime?: number): Promise<T>;
+//# sourceMappingURL=waitForAsync.d.ts.map

package/src/platform-implementation-js/lib/waitForAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForAsync.d.ts","sourceRoot":"","sources":["../../../../../src/platform-implementation-js/lib/waitForAsync.ts"],"names":[],"mappings":"AAEA,wBAA8B,YAAY,CAAC,CAAC,EAC1C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,EAC9C,OAAO,GAAE,MAAmB,EAC5B,QAAQ,GAAE,MAAY,GACrB,OAAO,CAAC,CAAC,CAAC,CAkBZ"}

package/src/platform-implementation-js/main-INTEGRATED-PAGEWORLD.js

@@ -0,0 +1,8 @@
+/* eslint-disable flowtype/require-valid-file-annotation, no-undef */
+
+const { injectScriptEmbedded } = require('./lib/inject-script-EMBEDDED');
+require('./lib/inject-script').setInjectScriptImplementation(
+  injectScriptEmbedded
+);
+
+module.exports = require('./main');

package/src/platform-implementation-js/main.js

@@ -0,0 +1,83 @@
+/* eslint-disable flowtype/require-valid-file-annotation, no-undef */
+
+if (!global.__InboxSDKImpLoader) {
+  var piMainStarted = Date.now();
+  var wasAccountSwitcherReadyAtStart = !!document.querySelector(
+    '[role=banner] div[aria-label] div div a[href^="https://myaccount.google."], [role=banner]+div div[aria-label] div div a[href^="https://myaccount.google."]'
+  );
+
+  var oldDefine;
+  try {
+    if (typeof define !== 'undefined' && define && define.amd) {
+      // work around amd compatibility issue
+      // https://groups.google.com/forum/#!msg/inboxsdk/U_bq82Exmwc/I3iIinxxCAAJ
+      oldDefine = define;
+      define = null;
+    }
+    // TODO check error logs to see if we need to re-enable safari-fix-map.
+    // require('safari-fix-map');
+    var Kefir = require('kefir');
+
+    var onready = new Promise((resolve, reject) => {
+      if (
+        document.readyState === 'complete' ||
+        document.readyState === 'interactive'
+      ) {
+        resolve();
+      } else {
+        resolve(
+          Kefir.merge([
+            Kefir.fromEvents(document, 'DOMContentLoaded'),
+            Kefir.fromEvents(window, 'load'),
+          ])
+            .take(1)
+            .map(() => null)
+            .toPromise()
+        );
+      }
+    });
+
+    global.__InboxSDKImpLoader = {
+      load: function (version, appId, opts) {
+        if (version !== '0.1') {
+          throw new Error('Unsupported InboxSDK version');
+        }
+
+        // dropbox specially requested this, they have dropped support for their extensions
+        // some users are on old version
+        if (appId === 'dropbox') {
+          throw new Error('No longer supported');
+        }
+
+        var piLoadStarted = Date.now();
+        return onready.then(() => {
+          var oldDefine;
+          try {
+            if (typeof define !== 'undefined' && define && define.amd) {
+              // work around amd compatibility issue
+              // https://groups.google.com/forum/#!msg/inboxsdk/U_bq82Exmwc/I3iIinxxCAAJ
+              oldDefine = define;
+              define = null;
+            }
+            const {
+              makePlatformImplementation,
+            } = require('./platform-implementation');
+            return makePlatformImplementation(appId, opts, {
+              piMainStarted,
+              piLoadStarted,
+              wasAccountSwitcherReadyAtStart,
+            });
+          } finally {
+            if (oldDefine) {
+              define = oldDefine;
+            }
+          }
+        });
+      },
+    };
+  } finally {
+    if (oldDefine) {
+      define = oldDefine;
+    }
+  }
+}

package/src/platform-implementation-js/namespaces/app-menu.d.ts

@@ -0,0 +1,38 @@
+import GmailDriver from '../dom-driver/gmail/gmail-driver';
+import { AppMenuItemView } from '../views/app-menu-item-view';
+export type AppMenuItemDescriptor = {
+    name: string;
+    iconUrl?: {
+        darkTheme: string;
+        lightTheme: string;
+    };
+    className?: string;
+    iconClassName?: string;
+    insertIndex?: number;
+    onClick?: (e?: MouseEvent) => void | null;
+    onHover?: (e?: MouseEvent) => void | null;
+    routeID?: string;
+    routeParams?: {};
+    activeRouteID?: string;
+    activeRouteParams?: {};
+};
+export type AppMenuItemPanelDescriptor = {
+    className?: string;
+    primaryButton?: {
+        name: string;
+        onClick: (e: MouseEvent) => void;
+        iconUrl?: {
+            darkTheme: string;
+            lightTheme: string;
+        };
+        className?: string;
+    };
+};
+export default class AppMenu {
+    #private;
+    constructor(driver: GmailDriver);
+    addMenuItem(menuItemDescriptor: AppMenuItemDescriptor): AppMenuItemView;
+    isShown(): Promise<boolean>;
+    isCollapsiblePanelShown(_panelIndexOrIDorType: number): void;
+}
+//# sourceMappingURL=app-menu.d.ts.map

package/src/platform-implementation-js/namespaces/app-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-menu.d.ts","sourceRoot":"","sources":["../../../../../src/platform-implementation-js/namespaces/app-menu.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,kCAAkC,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,EAAE,CAAC;CACxB,CAAC;AAYF,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;QACjC,OAAO,CAAC,EAAE;YACR,SAAS,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CAIH,CAAC;AAaF,MAAM,CAAC,OAAO,OAAO,OAAO;;gBAGd,MAAM,EAAE,WAAW;IAI/B,WAAW,CAAC,kBAAkB,EAAE,qBAAqB,GAAG,eAAe;IASjE,OAAO;IAKb,uBAAuB,CAAC,qBAAqB,EAAE,MAAM;CAGtD"}

package/src/platform-implementation-js/namespaces/butter-bar.d.ts

@@ -8,3 +8,4 @@ export default class ButterBar {
     hideMessage(messageKey: any | string): void;
     hideGmailMessage(): void;
 }
+//# sourceMappingURL=butter-bar.d.ts.map

package/src/platform-implementation-js/namespaces/butter-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"butter-bar.d.ts","sourceRoot":"","sources":["../../../../../src/platform-implementation-js/namespaces/butter-bar.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAmBvE,MAAM,CAAC,OAAO,OAAO,SAAS;gBACT,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IASzC,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB;IA8F3C,WAAW,CAAC,OAAO,GAAE,GAAQ,GAAG,gBAAgB;IAchD,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB;IAQzC,UAAU,CAAC,OAAO,GAAE,GAAQ,GAAG,GAAG;IAmClC,WAAW,CAAC,UAAU,EAAE,GAAG,GAAG,MAAM;IAUpC,gBAAgB;CAMxB"}

package/src/platform-implementation-js/namespaces/compose.js

@@ -0,0 +1,88 @@
+/* @flow */
+
+import * as ud from 'ud';
+import Kefir from 'kefir';
+import get from '../../common/get-or-fail';
+import ComposeView from '../views/compose-view';
+import HandlerRegistry from '../lib/handler-registry';
+
+import type Membrane from '../lib/Membrane';
+import type { PiOpts } from '../platform-implementation';
+import type { Handler } from '../lib/handler-registry';
+import type { Driver } from '../driver-interfaces/driver';
+
+const memberMap = ud.defonce(module, () => new WeakMap());
+
+const SAMPLE_RATE = 0.01;
+// documented in src/docs/
+class Compose {
+  constructor(driver: Driver, membrane: Membrane) {
+    const members = {
+      driver,
+      membrane,
+      handlerRegistry: new HandlerRegistry(),
+      composeViewStream: driver
+        .getComposeViewDriverStream()
+        .map((viewDriver) => (membrane.get(viewDriver): ComposeView)),
+    };
+    memberMap.set(this, members);
+
+    driver.getStopper().onValue(() => {
+      members.handlerRegistry.dumpHandlers();
+    });
+
+    members.composeViewStream.onValue((view) => {
+      driver.getLogger().trackFunctionPerformance(
+        () => {
+          members.handlerRegistry.addTarget(view);
+        },
+        SAMPLE_RATE,
+        {
+          type: 'composeViewHandler',
+          isInlineReplyForm: view.isInlineReplyForm(),
+        }
+      );
+    });
+  }
+
+  registerComposeViewHandler(handler: Handler<ComposeView>) {
+    return get(memberMap, this).handlerRegistry.registerHandler(handler);
+  }
+
+  async openNewComposeView(): Promise<ComposeView> {
+    const members = get(memberMap, this);
+    const composeViewDriver = await members.driver.openNewComposeViewDriver();
+    return members.membrane.get(composeViewDriver);
+  }
+
+  async openDraftByMessageID(messageID: string): Promise<ComposeView> {
+    const members = get(memberMap, this);
+    const newComposePromise = members.composeViewStream.take(1).toPromise();
+    await members.driver.openDraftByMessageID(messageID);
+    return Kefir.fromPromise(newComposePromise)
+      .merge(
+        Kefir.later(15 * 1000, null).flatMap(() =>
+          Kefir.constantError(new Error('draft did not open in time'))
+        )
+      )
+      .take(1)
+      .takeErrors(1)
+      .toPromise();
+  }
+
+  getComposeView(): Promise<ComposeView> {
+    const { driver } = get(memberMap, this);
+    driver
+      .getLogger()
+      .deprecationWarning(
+        'Compose.getComposeView',
+        'Compose.openNewComposeView'
+      );
+    if (driver.getOpts().REQUESTED_API_VERSION !== 1) {
+      throw new Error('This method was discontinued after API version 1');
+    }
+    return this.openNewComposeView();
+  }
+}
+
+export default ud.defn(module, Compose);

package/src/platform-implementation-js/namespaces/conversations.js

@@ -0,0 +1,156 @@
+/* @flow */
+
+import Kefir from 'kefir';
+import get from '../../common/get-or-fail';
+import ThreadView from '../views/conversations/thread-view';
+import MessageView from '../views/conversations/message-view';
+import AttachmentCardView from '../views/conversations/attachment-card-view';
+
+import HandlerRegistry from '../lib/handler-registry';
+import type Membrane from '../lib/Membrane';
+
+import type { Driver } from '../driver-interfaces/driver';
+
+const memberMap = new WeakMap();
+
+export const MessageViewViewStates = Object.freeze({
+  HIDDEN: 'HIDDEN',
+  COLLAPSED: 'COLLAPSED',
+  EXPANDED: 'EXPANDED',
+});
+
+export const MessageViewToolbarSectionNames = Object.freeze({
+  MORE: 'MORE',
+});
+
+// documented in src/docs/
+class Conversations {
+  MessageViewViewStates: typeof MessageViewViewStates = MessageViewViewStates;
+  MessageViewToolbarSectionNames: typeof MessageViewToolbarSectionNames =
+    MessageViewToolbarSectionNames;
+
+  constructor(appId: string, driver: Driver, membrane: Membrane) {
+    const members = {
+      appId,
+      driver,
+      threadViewHandlerRegistry: new HandlerRegistry(),
+      messageViewHandlerRegistries: {
+        all: new HandlerRegistry(),
+        loaded: new HandlerRegistry(),
+      },
+      attachmentCardViewHandlerRegistry: new HandlerRegistry(),
+    };
+    memberMap.set(this, members);
+
+    driver.getStopper().onValue(() => {
+      members.threadViewHandlerRegistry.dumpHandlers();
+      members.messageViewHandlerRegistries.all.dumpHandlers();
+      members.messageViewHandlerRegistries.loaded.dumpHandlers();
+    });
+
+    driver
+      .getAttachmentCardViewDriverStream()
+      .filter((cardDriver) => cardDriver.getAttachmentType() === 'FILE')
+      .onValue((attachmentCardViewDriver) => {
+        const attachmentCardView = membrane.get(attachmentCardViewDriver);
+        members.attachmentCardViewHandlerRegistry.addTarget(attachmentCardView);
+      });
+
+    _setupViewDriverWatcher(
+      appId,
+      driver.getThreadViewDriverStream().filter((t) => !t.isLoadingStub()),
+      ThreadView,
+      members.threadViewHandlerRegistry,
+      this,
+      membrane,
+      driver
+    );
+    _setupViewDriverWatcher(
+      appId,
+      driver.getMessageViewDriverStream(),
+      MessageView,
+      members.messageViewHandlerRegistries.all,
+      this,
+      membrane,
+      driver
+    );
+
+    _setupViewDriverWatcher(
+      appId,
+      driver.getMessageViewDriverStream().flatMap((messageViewDriver) =>
+        messageViewDriver.isLoaded()
+          ? Kefir.constant(messageViewDriver)
+          : messageViewDriver
+              .getEventStream()
+              .filter((event) => event.eventName === 'messageLoad')
+              .map(() => messageViewDriver)
+              .take(1)
+      ),
+      MessageView,
+      members.messageViewHandlerRegistries.loaded,
+      this,
+      membrane,
+      driver
+    );
+  }
+
+  registerThreadViewHandler(handler: (v: ThreadView) => void): () => void {
+    return get(memberMap, this).threadViewHandlerRegistry.registerHandler(
+      handler
+    );
+  }
+
+  registerMessageViewHandler(handler: (v: MessageView) => void): () => void {
+    return get(
+      memberMap,
+      this
+    ).messageViewHandlerRegistries.loaded.registerHandler(handler);
+  }
+
+  registerMessageViewHandlerAll(handler: (v: MessageView) => void): () => void {
+    return get(
+      memberMap,
+      this
+    ).messageViewHandlerRegistries.all.registerHandler(handler);
+  }
+
+  registerFileAttachmentCardViewHandler(
+    handler: (v: AttachmentCardView) => void
+  ): () => void {
+    return get(
+      memberMap,
+      this
+    ).attachmentCardViewHandlerRegistry.registerHandler(handler);
+  }
+}
+
+function _setupViewDriverWatcher(
+  appId,
+  stream: Kefir.Observable<Object>,
+  ViewClass,
+  handlerRegistry,
+  ConversationsInstance,
+  membrane,
+  driver
+) {
+  var combinedStream: Kefir.Observable<Object> = stream.map(function (
+    viewDriver
+  ) {
+    const view = membrane.get(viewDriver);
+    return { viewDriver, view };
+  });
+
+  // A delay is currently necessary so that ThreadView can wait for its MessageViews.
+  combinedStream
+    .flatMap((event) =>
+      event.viewDriver
+        .getReadyStream()
+        .map(() => event)
+        .takeUntilBy(Kefir.fromEvents(event.view, 'destroy'))
+    )
+    .onValue(function (event) {
+      handlerRegistry.addTarget(event.view);
+    });
+}
+
+export default Conversations;

package/src/platform-implementation-js/namespaces/global.js

@@ -0,0 +1,51 @@
+/* @flow */
+
+import Kefir from 'kefir';
+import kefirCast from 'kefir-cast';
+
+import ContentPanelView from '../views/content-panel-view';
+import get from '../../common/get-or-fail';
+
+import type { PiOpts } from '../platform-implementation';
+import type Membrane from '../lib/Membrane';
+import type { Driver } from '../driver-interfaces/driver';
+import GmailSupportItemView from '../dom-driver/gmail/views/gmail-support-item-view';
+import type SupportItemDescriptor from '../dom-driver/gmail/views/gmail-support-item-view';
+
+const memberMap = new WeakMap();
+
+export default class Global {
+  constructor(appId: string, driver: Driver, piOpts: PiOpts) {
+    const members = { appId, driver, piOpts };
+    memberMap.set(this, members);
+  }
+
+  async addSidebarContentPanel(descriptor: Object): Promise<?ContentPanelView> {
+    const descriptorPropertyStream = kefirCast(
+      (Kefir: any),
+      descriptor
+    ).toProperty();
+    const members = get(memberMap, this);
+
+    members.driver.getLogger().eventSdkPassive('global.addSidebarContentPanel');
+
+    const contentPanelImplementation =
+      await members.driver.addGlobalSidebarContentPanel(
+        descriptorPropertyStream
+      );
+    if (contentPanelImplementation) {
+      return new ContentPanelView(contentPanelImplementation);
+    }
+
+    return null;
+  }
+
+  addSupportItem(
+    supportItemDescriptor: SupportItemDescriptor
+  ): GmailSupportItemView {
+    const members = get(memberMap, this);
+    members.driver.getLogger().eventSdkPassive('global.addSupportItem');
+
+    return members.driver.addSupportItem(supportItemDescriptor);
+  }
+}

package/src/platform-implementation-js/namespaces/keyboard.js

@@ -0,0 +1,48 @@
+/* @flow */
+/* eslint-disable no-console */
+
+import * as ud from 'ud';
+import get from '../../common/get-or-fail';
+import KeyboardShortcutHandle from '../views/keyboard-shortcut-handle';
+import type { Driver } from '../driver-interfaces/driver';
+
+const memberMap = ud.defonce(module, () => new WeakMap());
+
+// documented in src/docs/
+class Keyboard {
+  constructor(
+    appId: string,
+    appName: ?string,
+    appIconUrl: ?string,
+    driver: Driver
+  ) {
+    const members = { appId, appName, appIconUrl, driver };
+    memberMap.set(this, members);
+  }
+
+  createShortcutHandle(shortcutDescriptor: {
+    chord: string,
+    description: string,
+  }) {
+    const members = get(memberMap, this);
+
+    let { chord, description } = shortcutDescriptor;
+    if (!chord) throw new Error('Keyboard.createShortcutHandle chord missing');
+    if (description == null) {
+      console.error('Keyboard.createShortcutHandle chord missing');
+      description = '';
+    }
+    const keyboardShortcutHandle = new KeyboardShortcutHandle(
+      chord,
+      description
+    );
+    members.driver.activateShortcut(
+      keyboardShortcutHandle,
+      members.appName,
+      members.appIconUrl
+    );
+    return keyboardShortcutHandle;
+  }
+}
+
+export default ud.defn(module, Keyboard);