@sigmacomputing/plugin 0.7.45 → 0.7.48

package/dist/initialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../src/initialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,8BAA8B,CAAC;AAEvD,wBAAgB,UAAU,CAAC,CAAC,GAAG,EAAE,KAAK,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAiK7D"}
+{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../src/initialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,8BAA8B,CAAC;AAEvD,wBAAgB,UAAU,CAAC,CAAC,GAAG,EAAE,KAAK,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CA2L7D"}

package/dist/initialize.js

@@ -30,7 +30,7 @@ function initialize() {
         subscribedWorkbookVars = {};
         Object.assign(subscribedWorkbookVars, updatedVariables);
     });
-    on('wb:plugin:interaction:update', (updatedInteractions) => {
+    on('wb:plugin:selection:update', (updatedInteractions) => {
         subscribedInteractions = {};
         Object.assign(subscribedInteractions, updatedInteractions);
     });
@@ -94,6 +94,12 @@ function initialize() {
             setVariable(id, ...values) {
                 void execPromise('wb:plugin:variable:set', id, ...values);
             },
+            getInteraction(id) {
+                return subscribedInteractions[id];
+            },
+            setInteraction(id, elementId, selection) {
+                void execPromise('wb:plugin:selection:set', id, elementId, selection);
+            },
             configureEditorPanel(options) {
                 void execPromise('wb:plugin:config:inspector', options);
             },
@@ -109,6 +115,15 @@ function initialize() {
                     off('wb:plugin:variable:update', setValues);
                 };
             },
+            subscribeToWorkbookInteraction(id, callback) {
+                const setValues = (values) => {
+                    callback(values[id]);
+                };
+                on('wb:plugin:selection:update', setValues);
+                return () => {
+                    off('wb:plugin:selection:update', setValues);
+                };
+            },
         },
         elements: {
             getElementColumns(id) {

package/dist/react/index.d.ts

@@ -49,4 +49,10 @@ export declare function useConfig(key?: string): any;
  * @returns {[(plugin.WorkbookVariable | undefined), Function]} Constantly updating value of the variable and setter for the variable
  */
 export declare function useVariable(id: string): [plugin.WorkbookVariable | undefined, Function];
+/**
+ * React hook for accessing a workbook interaction selections state
+ * @param {string} id ID of variable within Plugin Config to use
+ * @returns {[(plugin.WorkbookSelection | undefined), Function]} Constantly updating selection state and setter thereof
+ */
+export declare function useInteraction(id: string, elementId: string): [unknown, Function];
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAON,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,MAAM,MAAM,8BAA8B,CAAC;AAOvD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAChC,eAIA;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAEtD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,CAAC,yBAAyB,EAAE,GAC9C,IAAI,CAUN;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,OAAO,GACpB,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC,CAczC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,CASrE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAO/D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAiB3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,GACT,CAAC,MAAM,CAAC,gBAAgB,GAAG,SAAS,EAAE,QAAQ,CAAC,CAcjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAON,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,MAAM,MAAM,8BAA8B,CAAC;AAOvD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAChC,eAIA;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAEtD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,CAAC,yBAAyB,EAAE,GAC9C,IAAI,CAUN;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,OAAO,GACpB,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC,CAczC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,CASrE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAO/D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAiB3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,GACT,CAAC,MAAM,CAAC,gBAAgB,GAAG,SAAS,EAAE,QAAQ,CAAC,CAcjD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAmBrB"}

package/dist/react/index.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useVariable = exports.useConfig = exports.useElementData = exports.useElementColumns = exports.useLoadingState = exports.useEditorPanelConfig = exports.usePlugin = exports.SigmaClientProvider = void 0;
+exports.useInteraction = exports.useVariable = exports.useConfig = exports.useElementData = exports.useElementColumns = exports.useLoadingState = exports.useEditorPanelConfig = exports.usePlugin = exports.SigmaClientProvider = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = __importStar(require("react"));
 const deepEqual_1 = require("../deepEqual");
@@ -152,3 +152,22 @@ function useVariable(id) {
     ];
 }
 exports.useVariable = useVariable;
+/**
+ * React hook for accessing a workbook interaction selections state
+ * @param {string} id ID of variable within Plugin Config to use
+ * @returns {[(plugin.WorkbookSelection | undefined), Function]} Constantly updating selection state and setter thereof
+ */
+function useInteraction(id, elementId) {
+    const client = usePlugin();
+    const [workbookInteraction, setWorkbookInteraction] = (0, react_1.useState)();
+    (0, react_1.useEffect)(() => {
+        return client.config.subscribeToWorkbookInteraction(id, setWorkbookInteraction);
+    }, [client, id]);
+    return [
+        workbookInteraction,
+        react_1.default.useCallback((value) => {
+            client.config.setInteraction(id, elementId, value);
+        }, [id]),
+    ];
+}
+exports.useInteraction = useInteraction;

package/package.json

@@ -1,14 +1,12 @@
 {
   "name": "@sigmacomputing/plugin",
-  "version": "0.7.45",
+  "version": "0.7.48",
   "description": "Plugin client api",
   "module": "./src/index.ts",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "/dist",
-    "/src",
-    "!/src/**/__tests__/**"
+    "/dist"
   ],
   "scripts": {
     "clean": "rimraf dist tsconfig*.tsbuildinfo",
@@ -18,16 +16,16 @@
     "lint": "eslint --cache src jest.config.js .eslintrc.js",
     "lint:clean": "rimraf .eslintcache",
     "lint:fix": "yarn lint --fix",
-    "prepublish": "yarn build",
+    "prepublish": "yarn clean && tsc --build tsconfig.publish.json",
     "test": "cd ../.. && jest --ci --selectProjects @sigmacomputing/plugin",
     "test:watch": "yarn test --watch",
     "tsc": "tsc --build tsconfig.build.json"
   },
   "dependencies": {
-    "@sigmacomputing/plugin-types": "^0.7.45"
+    "@sigmacomputing/plugin-types": "^0.7.48"
   },
   "peerDependencies": {
     "react": "^16.8.0 || ^17.0.0 | ^18.0.0"
   },
-  "gitHead": "c32a8950b88a2f0e106055b65157cc6b3b62a247"
+  "gitHead": "81a4a6c9f2334b2273bcb2a1f3b63046e442da09"
 }

package/src/client.ts

@@ -1,3 +0,0 @@
-import { initialize } from './initialize';
-
-export const client = initialize();

package/src/deepEqual.ts

@@ -1,42 +0,0 @@
-// Deep Equality comparison example
-//
-// This is an example of how to implement an object-comparison function in
-// JavaScript (ES5+). A few points of interest here:
-//
-// * You can get an array of all an object's properties in ES5+ by calling
-//   the class method Object.keys(obj).
-// * The function recursively calls itself in the for / in loop when it
-//   compares the contents of each property
-// * You can hide a "private" function inside a function of this kind by
-//   placing one function declaration inside of another. The inner function
-//   is not hoisted out into the global scope, so it is only visible inside
-//   of the parent function.
-// * The reason this nested helper function is necessary is that
-//   `typeof null` is still "object" in JS, a major "gotcha" to watch out for.
-//
-// https://gist.github.com/egardner/efd34f270cc33db67c0246e837689cb9
-
-export function deepEqual(obj1: any, obj2: any) {
-  if (obj1 === obj2) {
-    return true;
-  } else if (isObject(obj1) && isObject(obj2)) {
-    if (Object.keys(obj1).length !== Object.keys(obj2).length) {
-      return false;
-    }
-    for (const prop in obj1) {
-      if (!deepEqual(obj1[prop], obj2[prop])) {
-        return false;
-      }
-    }
-    return true;
-  }
-
-  // Private
-  function isObject(obj: any) {
-    if (typeof obj === 'object' && obj != null) {
-      return true;
-    } else {
-      return false;
-    }
-  }
-}

package/src/index.ts

@@ -1,8 +0,0 @@
-export { initialize } from './initialize';
-export { client } from './client';
-/* Ideally we want this to be tree-shakeable.
- * Node 12 added support for `exports` in package.json,
- * however typescript does not yet support this.
- * Tracked: https://github.com/microsoft/TypeScript/issues/33079
- */
-export * from './react';

package/src/initialize.test.ts

@@ -1,28 +0,0 @@
-import { initialize } from './initialize';
-
-describe('initialize', () => {
-  let originalAddEventListener: any;
-  let originalRemoveEventListener: any;
-  beforeAll(() => {
-    originalAddEventListener = window.addEventListener;
-    originalRemoveEventListener = window.removeEventListener;
-    window.addEventListener = jest.fn();
-    window.removeEventListener = jest.fn();
-  });
-
-  beforeEach(() => {
-    jest.resetAllMocks();
-  });
-  test('should initialize and be destroyable', () => {
-    const client = initialize();
-    expect(window.addEventListener).toHaveBeenCalled();
-
-    client.destroy();
-    expect(window.removeEventListener).toHaveBeenCalled();
-  });
-
-  afterAll(() => {
-    window.addEventListener = originalAddEventListener;
-    window.removeEventListener = originalRemoveEventListener;
-  });
-});

package/src/initialize.ts

@@ -1,164 +0,0 @@
-import * as plugin from '@sigmacomputing/plugin-types';
-
-export function initialize<T = {}>(): plugin.PluginInstance<T> {
-  const pluginConfig: Partial<plugin.PluginConfig<T>> = {
-    config: {} as T,
-  };
-  let subscribedInteractions: Record<string, unknown> = {};
-  let subscribedWorkbookVars: Record<string, plugin.WorkbookVariable> = {};
-
-  const listeners: {
-    [event: string]: Function[];
-  } = {};
-
-  for (const [key, value] of new URL(
-    document.location.toString(),
-  ).searchParams.entries())
-    pluginConfig[key] = JSON.parse(value);
-
-  const listener = (e: plugin.PluginMessageResponse) => {
-    emit(e.data.type, e.data.result, e.data.error);
-  };
-
-  window.addEventListener('message', listener, false);
-  window.addEventListener('click', () => execPromise('wb:plugin:focus'));
-
-  on('wb:plugin:config:update', (config: plugin.PluginConfig<T>) => {
-    Object.assign(pluginConfig, config);
-    emit('config', pluginConfig.config ?? {});
-  });
-
-  // send initialize event
-  void execPromise('wb:plugin:init', require('../package.json').version).then(
-    config => {
-      Object.assign(pluginConfig, config);
-      emit('init', pluginConfig);
-      emit('config', pluginConfig.config);
-    },
-  );
-
-  on(
-    'wb:plugin:variable:update',
-    (updatedVariables: Record<string, plugin.WorkbookVariable>) => {
-      subscribedWorkbookVars = {};
-      Object.assign(subscribedWorkbookVars, updatedVariables);
-    },
-  );
-
-  on('wb:plugin:interaction:update', (updatedInteractions: unknown) => {
-    subscribedInteractions = {};
-    Object.assign(subscribedInteractions, updatedInteractions);
-  });
-
-  function on(event: string, listener: Function) {
-    listeners[event] = listeners[event] || [];
-    listeners[event].push(listener);
-  }
-
-  function off(event: string, listener: Function) {
-    if (listeners[event] == null) return;
-    listeners[event] = listeners[event].filter(a => a !== listener);
-  }
-
-  function emit(event: string, ...args: any) {
-    Object.values(listeners[event] || []).forEach(fn => fn(...args));
-  }
-
-  function execPromise<R>(event: string, ...args: any): Promise<R> {
-    return new Promise((resolve, reject) => {
-      const callback = (data: R, error: any) => {
-        if (error) reject(error);
-        else resolve(data);
-        off(event, callback);
-      };
-      on(event, callback);
-      window.parent.postMessage(
-        { type: event, args, elementId: pluginConfig.id },
-        pluginConfig?.wbOrigin ?? '*',
-      );
-    });
-  }
-
-  return {
-    get sigmaEnv() {
-      return pluginConfig.sigmaEnv;
-    },
-    get isScreenshot() {
-      return pluginConfig.screenshot;
-    },
-    config: {
-      // @ts-ignore
-      getKey(key) {
-        return pluginConfig?.config?.[key]!;
-      },
-      get() {
-        return pluginConfig.config;
-      },
-      set(partialConfig) {
-        void execPromise('wb:plugin:config:update', partialConfig);
-      },
-      setKey(key, value) {
-        void execPromise('wb:plugin:config:update', {
-          [key]: value,
-        });
-      },
-      subscribe(listener) {
-        on('config', listener);
-        return () => off('config', listener);
-      },
-      getVariable(id: string): plugin.WorkbookVariable {
-        return subscribedWorkbookVars[id];
-      },
-      setVariable(id: string, ...values: unknown[]) {
-        void execPromise('wb:plugin:variable:set', id, ...values);
-      },
-      configureEditorPanel(options) {
-        void execPromise('wb:plugin:config:inspector', options);
-      },
-      setLoadingState(loadingState) {
-        void execPromise('wb:plugin:config:loading-state', loadingState);
-      },
-      subscribeToWorkbookVariable(
-        id: string,
-        callback: (input: plugin.WorkbookVariable) => void,
-      ): plugin.Unsubscriber {
-        const setValues = (values: Record<string, plugin.WorkbookVariable>) => {
-          callback(values[id]);
-        };
-        on('wb:plugin:variable:update', setValues);
-        return () => {
-          off('wb:plugin:variable:update', setValues);
-        };
-      },
-    },
-    elements: {
-      getElementColumns(id) {
-        return execPromise('wb:plugin:element:columns:get', id);
-      },
-      subscribeToElementColumns(id, callback) {
-        const eventName = `wb:plugin:element:${id}:columns`;
-        on(eventName, callback);
-        void execPromise('wb:plugin:element:subscribe:columns', id);
-
-        return () => {
-          off(eventName, callback);
-          void execPromise('wb:plugin:element:unsubscribe:columns', id);
-        };
-      },
-      subscribeToElementData(id, callback) {
-        const eventName = `wb:plugin:element:${id}:data`;
-        on(eventName, callback);
-        void execPromise('wb:plugin:element:subscribe:data', id);
-
-        return () => {
-          off(eventName, callback);
-          void execPromise('wb:plugin:element:unsubscribe:data', id);
-        };
-      },
-    },
-    destroy: function () {
-      Object.keys(listeners).forEach(event => delete listeners[event]);
-      window.removeEventListener('message', listener, false);
-    },
-  };
-}

package/src/react/index.tsx

@@ -1,154 +0,0 @@
-import React, {
-  Context,
-  createContext,
-  useContext,
-  useEffect,
-  useRef,
-  useState,
-} from 'react';
-import * as plugin from '@sigmacomputing/plugin-types';
-
-import { deepEqual } from '../deepEqual';
-import { client } from '../client';
-
-const Context = createContext<plugin.PluginInstance<any>>(client);
-
-/**
- * Wrapper for plugin client using a Provider
- * @param {{client: plugin.PluginInstance, children: React.ReachChildren}} props Plugin instance and any children elements
- * @returns {JSXElement} Context Provider for passed in props
- */
-export function SigmaClientProvider(props: {
-  client: plugin.PluginInstance<any>;
-  children?: React.ReactChildren;
-}) {
-  return (
-    <Context.Provider value={props.client}>{props.children}</Context.Provider>
-  );
-}
-
-/**
- * A constantly updating getter for the entire Plugin Instance
- * @returns {plugin.PluginInstance} Context for the current plugin instance
- */
-export function usePlugin(): plugin.PluginInstance<any> {
-  return useContext(Context);
-}
-
-/**
- * Provides a setter for the Plugin's Config Options
- * @param {plugin.CustomPluginConfigOptions[]} nextOptions Updated possible Config Options
- */
-export function useEditorPanelConfig(
-  nextOptions: plugin.CustomPluginConfigOptions[],
-): void {
-  const client = usePlugin();
-  const optionsRef = useRef({});
-  useEffect(() => {
-    if (nextOptions == null) return;
-    if (!deepEqual(nextOptions, optionsRef.current)) {
-      client.config.configureEditorPanel(nextOptions);
-      optionsRef.current = nextOptions;
-    }
-  }, [client, nextOptions]);
-}
-
-/**
- * React hook for Plugin Config loading state
- * @param {boolean} initialState Initial value to set loading state to
- * @returns {[boolean, Function]} Boolean value corresponding to loading state for plugin config and setter for loading state
- */
-export function useLoadingState(
-  initialState: boolean,
-): [boolean, (nextState: boolean) => void] {
-  const client = usePlugin();
-  const [loading, setLoading] = useState(() => {
-    client.config.setLoadingState(initialState);
-    return initialState;
-  });
-  return [
-    loading,
-    nextState => {
-      if (nextState === loading) return;
-      setLoading(nextState);
-      client.config.setLoadingState(nextState);
-    },
-  ];
-}
-
-/**
- * Provides constantly updating column values from corresponding sheet
- * @param {string} id Sheet ID to retrieve from workbook
- * @returns {plugin.WbElementColumns} Values of corresponding columns contained within the sheet
- */
-export function useElementColumns(id: string): plugin.WbElementColumns {
-  const client = usePlugin();
-  const [columns, setColumns] = useState<plugin.WbElementColumns>({});
-  useEffect(() => {
-    if (id) {
-      return client.elements.subscribeToElementColumns(id, setColumns);
-    }
-  }, [client, id]);
-  return columns;
-}
-
-/**
- * Provides constantly updating data values from corresponding sheet
- * @param {string} id Sheet ID to get element data from
- * @returns {plugin.WbElementData} Element Data for corresponding sheet, if any
- */
-export function useElementData(id: string): plugin.WbElementData {
-  const client = usePlugin();
-  const [data, setData] = useState<plugin.WbElementData>({});
-  useEffect(() => {
-    if (id) return client.elements.subscribeToElementData(id, setData);
-  }, [client, id]);
-  return data;
-}
-
-/**
- * Provides a constantly updating value for entire config or certain key within config
- * @param {string} key Key within Plugin Config, optional
- * @returns Entire config if no key passed in or value for key within plugin config
- */
-export function useConfig(key?: string): any {
-  const client = usePlugin();
-  const [config, setConfig] = useState<any>(
-    key != null ? client.config.getKey(key) : client.config.get(),
-  );
-  useEffect(
-    () =>
-      client.config.subscribe(newConfig => {
-        if (key != null && newConfig[key] !== config[key]) {
-          setConfig(newConfig[key]);
-        } else {
-          setConfig(newConfig);
-        }
-      }),
-    [client],
-  );
-  return config;
-}
-
-/**
- * React hook for accessing a workbook variable
- * @param {string} id ID of variable within Plugin Config to use
- * @returns {[(plugin.WorkbookVariable | undefined), Function]} Constantly updating value of the variable and setter for the variable
- */
-export function useVariable(
-  id: string,
-): [plugin.WorkbookVariable | undefined, Function] {
-  const client = usePlugin();
-  const [workbookVariable, setWorkbookVariable] =
-    useState<plugin.WorkbookVariable>();
-  useEffect(() => {
-    return client.config.subscribeToWorkbookVariable(id, setWorkbookVariable);
-  }, [client, id]);
-  return [
-    workbookVariable,
-    React.useCallback(
-      (...values: unknown[]) => client.config.setVariable(id, ...values),
-      [id],
-    ),
-  ];
-}