Change removal to deprecation

src/client/initialize.ts

@@ -12,6 +12,7 @@ export function initialize<T = {}>(): PluginInstance<T> {
     config: {} as T,
   };
 
+  let subscribedInteractions: Record<string, WorkbookSelection[]> = {};
   let subscribedWorkbookVars: Record<string, WorkbookVariable> = {};
   const registeredEffects: Record<string, () => void> = {};
 
@@ -170,6 +171,18 @@ export function initialize<T = {}>(): PluginInstance<T> {
           off('wb:plugin:variable:update', setValues);
         };
       },
+      subscribeToWorkbookInteraction(
+        id: string,
+        callback: (input: WorkbookSelection[]) => void,
+      ): Unsubscriber {
+        const setValues = (values: Record<string, WorkbookSelection[]>) => {
+          callback(values[id]);
+        };
+        on('wb:plugin:selection:update', setValues);
+        return () => {
+          off('wb:plugin:selection:update', setValues);
+        };
+      },
     },
     elements: {
       getElementColumns(id) {
@@ -197,7 +210,7 @@ export function initialize<T = {}>(): PluginInstance<T> {
       },
       fetchMoreElementData(id) {
         void execPromise('wb:plugin:element:fetch-more', id);
-      }
+      },
     },
     destroy() {
       Object.keys(listeners).forEach(event => delete listeners[event]);

src/react/hooks.ts

@@ -180,7 +180,9 @@ export function useVariable(
 
   return [workbookVariable, setVariable];
 }
+
 /**
+ * @deprecated Use Action API instead
  * React hook for accessing a workbook interaction selections state
  * @param {string} id ID of variable within Plugin Config to use
  * @returns {[(WorkbookSelection | undefined), Function]} Constantly updating selection state and setter thereof

src/types.ts

@@ -248,12 +248,14 @@ export interface PluginInstance<T = any> {
     setVariable(id: string, ...values: unknown[]): void;
 
     /**
+     * @deprecated Use Action API instead
      * Getter for interaction selection state
      * @param {string} id ID from interaction type in Plugin Config
      */
     getInteraction(id: string): WorkbookSelection[];
 
     /**
+     * @deprecated Use Action API instead
      * Setter for interaction selection state
      * @param {string} id ID from interaction type in Plugin Config
      * @param {string} elementId Source element ID from element type in Plugin Config
@@ -295,6 +297,18 @@ export interface PluginInstance<T = any> {
       id: string,
       callback: (input: WorkbookVariable) => void,
     ): Unsubscriber;
+
+    /**
+     * @deprecated Use Action API instead
+     * Allows users to subscribe to changes in the passed in interaction ID
+     * @param {string} id ID of the interaction variable within Plugin Config
+     * @callback callback Function to be called upon receiving an updated interaction selection state
+     * @returns {Unsubscriber} A callable unsubscriber
+     */
+    subscribeToWorkbookInteraction(
+      id: string,
+      callback: (input: WorkbookSelection[]) => void,
+    ): Unsubscriber;
   };
 
   elements: {