support createPaste

Summary:
Added support for `createPaste` in Sandy plugins

Nice minimalistic example of how to expose a Flipper api to Sandy.

Note that some indirection could be removed by having an interface that is shared directly between `BasePluginClient` and `FlipperLib` (e.g. `PublicFlipperLib`). In contrast to `addMenuEntries` from the previous diff, `createPaste` is basically exposed verbatim to Sandy without additional wrapping, so those cases could be made simpler. Maybe will do that later.

Reviewed By: passy

Differential Revision: D22815873

fbshipit-source-id: e6d0773a35341edfe5de0898317eaadf88de79d0

desktop/flipper-plugin/src/__tests__/test-utils.node.tsx

@@ -328,3 +328,21 @@ test('plugins can register menu entries', async () => {
     `"No menu entry found with action: Non Existing"`,
   );
 });
+
+test('plugins can create pastes', async () => {
+  const plugin = TestUtils.startPlugin({
+    plugin(client: PluginClient) {
+      return {
+        doIt() {
+          client.createPaste('test');
+        },
+      };
+    },
+    Component() {
+      return null;
+    },
+  });
+
+  plugin.instance.doIt();
+  expect(plugin.flipperLib.createPaste).toBeCalledWith('test');
+});

desktop/flipper-plugin/src/plugin/FlipperLib.tsx

@@ -14,4 +14,5 @@ import {NormalizedMenuEntry} from './MenuEntry';
  */
 export interface FlipperLib {
   enableMenuEntries(menuEntries: NormalizedMenuEntry[]): void;
+  createPaste(input: string): Promise<string | undefined>;
 }

desktop/flipper-plugin/src/plugin/PluginBase.tsx

@@ -38,6 +38,12 @@ export interface BasePluginClient {
    * Register menu entries in the Flipper toolbar
    */
   addMenuEntry(...entry: MenuEntry[]): void;
+
+  /**
+   * Creates a Paste (similar to a Github Gist).
+   * Facebook only function. Resolves to undefined if creating a paste failed.
+   */
+  createPaste(input: string): Promise<string | undefined>;
 }
 
 let currentPluginInstance: BasePluginInstance | undefined = undefined;
@@ -123,6 +129,7 @@ export abstract class BasePluginInstance {
           this.menuEntries.push(normalizeMenuEntry(entry));
         }
       },
+      createPaste: this.flipperLib.createPaste,
     };
   }
 

desktop/flipper-plugin/src/test-utils/test-utils.tsx

@@ -324,6 +324,7 @@ export function renderDevicePlugin<Module extends FlipperDevicePluginModule>(
 export function createMockFlipperLib(): FlipperLib {
   return {
     enableMenuEntries: jest.fn(),
+    createPaste: jest.fn(),
   };
 }