@darajs/core 0.4.8

package/dist/shared/interactivity/persistence.d.ts

@@ -0,0 +1,43 @@
+import * as React from 'react';
+import { AtomEffect } from 'recoil';
+import { WebSocketClientInterface } from '../../api';
+import { RequestExtrasSerializable } from '../../api/http';
+import { GlobalTaskContext } from '../../shared/context/global-task-context';
+import { SingleVariable } from '../../types';
+import { PersistenceStore } from '../../types/core';
+/**
+ * Get the session key used to persist a variable value
+ *
+ * @param uid uid of the variable to persist
+ */
+export declare function getSessionKey(uid: string): string;
+interface StoreSync {
+    (props: {
+        children: React.ReactNode;
+    }): JSX.Element;
+}
+interface Effect<T = any> {
+    (variable: SingleVariable<T>, requestExtras: RequestExtrasSerializable, wsClient: WebSocketClientInterface, taskContext: GlobalTaskContext): AtomEffect<T>;
+}
+export declare const STORES: Record<string, {
+    effect: Effect;
+    sync: StoreSync;
+}>;
+/**
+ * Get the effect creator function for a given variable
+ *
+ * Looks up correct definition based on variable.store type
+ *
+ * @param variable variable to get effect for
+ */
+export declare function getEffect(variable: SingleVariable<any, PersistenceStore>): Effect | null;
+/**
+ * Wrapper for the store providers.
+ *
+ * Applies all STORES around the children.
+ */
+export declare function StoreProviders({ children }: {
+    children: React.ReactNode;
+}): JSX.Element;
+export {};
+//# sourceMappingURL=persistence.d.ts.map

package/dist/shared/interactivity/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../js/shared/interactivity/persistence.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAKpC,OAAO,EAAE,wBAAwB,EAAoB,MAAM,OAAO,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAW,MAAM,YAAY,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAqB,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAiC,gBAAgB,EAAE,MAAM,cAAc,CAAC;AA6G/E;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOjD;AAuGD,UAAU,SAAS;IACf,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,GAAG,GAAG,CAAC,OAAO,CAAC;CACvD;AAED,UAAU,MAAM,CAAC,CAAC,GAAG,GAAG;IACpB,CACI,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,yBAAyB,EACxC,QAAQ,EAAE,wBAAwB,EAClC,WAAW,EAAE,iBAAiB,GAC/B,UAAU,CAAC,CAAC,CAAC,CAAC;CACpB;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CACvB,MAAM,EACN;IACI,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;CACnB,CAUJ,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC,GAAG,EAAE,gBAAgB,CAAC,GAAG,MAAM,GAAG,IAAI,CAQxF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAOvF"}

package/dist/shared/interactivity/persistence.js

@@ -0,0 +1,215 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import { mixed } from '@recoiljs/refine';
+import * as React from 'react';
+import { RecoilSync, syncEffect } from 'recoil-sync';
+import { validateResponse } from '@darajs/ui-utils';
+import { handleAuthErrors } from '../../api';
+import { request } from '../../api/http';
+import { getSessionToken } from '../../auth/use-session-token';
+import { isEmbedded } from '../../shared/utils/embed';
+import { isDerivedVariable } from '../../types';
+import { WebSocketCtx } from '../context';
+// eslint-disable-next-line import/no-cycle
+import { getOrRegisterDerivedVariableValue } from './internal';
+/**
+ * Global map to store the extras for each store uid
+ */
+const STORE_EXTRAS_MAP = new Map();
+/**
+ * RecoilSync implementation for BackendStore
+ *
+ * - read: GET from /api/core/store/:store_uid
+ * - write: POST to /api/core/store
+ * - listen: subscribed to `backendStoreMessages$` on WsClient
+ */
+function BackendStoreSync({ children }) {
+    const { client } = React.useContext(WebSocketCtx);
+    const getStoreValue = React.useCallback((itemKey) => __awaiter(this, void 0, void 0, function* () {
+        const serializableExtras = STORE_EXTRAS_MAP.get(itemKey);
+        const response = yield request(`/api/core/store/${itemKey}`, {}, serializableExtras.extras);
+        yield handleAuthErrors(response, true);
+        yield validateResponse(response, `Failed to fetch the store value for key: ${itemKey}`);
+        const val = yield response.json();
+        return val;
+    }), []);
+    const syncStoreValues = React.useCallback((_a) => __awaiter(this, [_a], void 0, function* ({ diff }) {
+        // keep track of extras -> diff to send each set of extras as a separate request
+        const extrasMap = new Map();
+        for (const [itemKey, value] of diff.entries()) {
+            const extras = STORE_EXTRAS_MAP.get(itemKey);
+            if (!extrasMap.has(extras)) {
+                extrasMap.set(extras, {});
+            }
+            // store the value in the extras map
+            extrasMap.get(extras)[itemKey] = value;
+        }
+        function sendRequest(serializableExtras, storeDiff) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const response = yield request(`/api/core/store`, { body: JSON.stringify(storeDiff), method: 'POST' }, serializableExtras.extras);
+                yield handleAuthErrors(response, true);
+                yield validateResponse(response, `Failed to sync the store values`);
+            });
+        }
+        // Send a request with each different set of extras
+        yield Promise.allSettled(Array.from(extrasMap.entries()).map(([serializableExtras, storeDiff]) => sendRequest(serializableExtras, storeDiff)));
+    }), []);
+    const listenToStoreChanges = React.useCallback(({ updateItem }) => {
+        if (!client) {
+            return;
+        }
+        const sub = client.backendStoreMessages$().subscribe((message) => {
+            updateItem(message.store_uid, message.value);
+        });
+        return () => sub.unsubscribe();
+    }, [client]);
+    return (_jsx(RecoilSync, { listen: listenToStoreChanges, read: getStoreValue, storeKey: "BackendStore", write: syncStoreValues, children: children }));
+}
+/**
+ * Create a syncEffect for BackendStore
+ *
+ * @param variable variable to create the atom effect for
+ * @param requestExtras extras object to create the effect for; used to pass through correct extras to write requests
+ */
+function backendStoreEffect(variable, requestExtras) {
+    // Assumption: the set of extras is unique to the store, i.e. the variable will not be used under different sets of extras
+    STORE_EXTRAS_MAP.set(variable.store.uid, requestExtras);
+    return syncEffect({
+        /** Use store uid as the unique identifier */
+        itemKey: variable.store.uid,
+        refine: mixed(),
+        storeKey: 'BackendStore',
+    });
+}
+/**
+ * Get the session key used to persist a variable value
+ *
+ * @param uid uid of the variable to persist
+ */
+export function getSessionKey(uid) {
+    // If we're within an IFrame (Jupyter)
+    if (isEmbedded()) {
+        return `dara-session-${window.frameElement.dataset.daraPageId}-var-${uid}`;
+    }
+    return `dara-session-${getSessionToken()}-var-${uid}`;
+}
+/**
+ * RecoilSync implementation for BrowserStore
+ *
+ * localStorage keys are generated via @see getSessionKey
+ *
+ * - read: read from localStorage
+ * - write: write to localStorage
+ * - listen: subscribe to 'storage' event for cross-tab or cross-window syncing
+ */
+function BrowserStoreSync({ children }) {
+    const getStoreValue = React.useCallback((itemKey) => {
+        var _a;
+        const key = getSessionKey(itemKey);
+        return JSON.parse((_a = localStorage.getItem(key)) !== null && _a !== void 0 ? _a : 'null');
+    }, []);
+    const syncStoreValues = React.useCallback(({ diff }) => {
+        for (const [itemKey, value] of diff.entries()) {
+            const key = getSessionKey(itemKey);
+            localStorage.setItem(key, JSON.stringify(value));
+        }
+    }, []);
+    /**
+     * Listen to storage events and update the store when a change is detected.
+     *
+     * This is useful to keep the store in sync across tabs.
+     */
+    const listenToStoreChanges = React.useCallback(({ updateItem }) => {
+        const listener = (e) => {
+            var _a;
+            if (e.storageArea === localStorage) {
+                if (e.key) {
+                    // check if the key matches our dara-session key
+                    const match = e.key.match(/^dara-session-(.*)-var-(.*)$/);
+                    if (match) {
+                        const [, sessionToken, uid] = match;
+                        if (sessionToken === getSessionToken()) {
+                            updateItem(uid, JSON.parse((_a = e.newValue) !== null && _a !== void 0 ? _a : 'null'));
+                        }
+                    }
+                }
+            }
+        };
+        window.addEventListener('storage', listener);
+        return () => {
+            window.removeEventListener('storage', listener);
+        };
+    }, []);
+    return (_jsx(RecoilSync, { listen: listenToStoreChanges, read: getStoreValue, storeKey: "BrowserStore", write: syncStoreValues, children: children }));
+}
+/**
+ * Create a syncEffect for BrowserStore
+ *
+ * @param variable variable to create effect for
+ */
+function localStorageEffect(variable, extrasSerializable, wsClient, taskContext) {
+    let firstRun = false;
+    return syncEffect({
+        itemKey: variable.uid,
+        read: ({ read }) => {
+            const readValue = read(variable.uid);
+            if (!firstRun) {
+                firstRun = true;
+                // during first run fall back to the default value if the read value is null
+                // as local storage might not have been initialized yet
+                if (!readValue) {
+                    const isDefaultDerived = isDerivedVariable(variable.default);
+                    return isDefaultDerived ?
+                        getOrRegisterDerivedVariableValue(variable.default, wsClient, taskContext, extrasSerializable.extras)
+                        : variable.default;
+                }
+            }
+            return readValue;
+        },
+        refine: mixed(),
+        storeKey: 'BrowserStore',
+    });
+}
+export const STORES = {
+    BackendStore: {
+        effect: backendStoreEffect,
+        sync: BackendStoreSync,
+    },
+    BrowserStore: {
+        effect: localStorageEffect,
+        sync: BrowserStoreSync,
+    },
+};
+/**
+ * Get the effect creator function for a given variable
+ *
+ * Looks up correct definition based on variable.store type
+ *
+ * @param variable variable to get effect for
+ */
+export function getEffect(variable) {
+    var _a, _b;
+    const storeName = (_a = variable.store) === null || _a === void 0 ? void 0 : _a.__typename;
+    if (!storeName) {
+        return null;
+    }
+    return (_b = STORES[storeName].effect) !== null && _b !== void 0 ? _b : null;
+}
+/**
+ * Wrapper for the store providers.
+ *
+ * Applies all STORES around the children.
+ */
+export function StoreProviders({ children }) {
+    // this could be a loop if STORES is dynamically extensible but static for now
+    return (_jsx(BackendStoreSync, { children: _jsx(BrowserStoreSync, { children: children }) }));
+}
+//# sourceMappingURL=persistence.js.map

package/dist/shared/interactivity/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../../js/shared/interactivity/persistence.tsx"],"names":[],"mappings":";;;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAA2B,UAAU,EAAc,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAA4B,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACnE,OAAO,EAA6B,OAAO,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAkB,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,2CAA2C;AAC3C,OAAO,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAC;AAE/D;;GAEG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAqC,CAAC;AAEtE;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,EAAE,QAAQ,EAAiC;IACjE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAElD,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,CAAW,CAAO,OAAO,EAAE,EAAE;QAChE,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,mBAAmB,OAAO,EAAE,EAAE,EAAE,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC5F,MAAM,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvC,MAAM,gBAAgB,CAAC,QAAQ,EAAE,4CAA4C,OAAO,EAAE,CAAC,CAAC;QACxF,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAElC,OAAO,GAAG,CAAC;IACf,CAAC,CAAA,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,CAAa,KAAiB,EAAE,0CAAZ,EAAE,IAAI,EAAE;QACjE,gFAAgF;QAChF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkD,CAAC;QAE5E,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAE7C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC9B,CAAC;YAED,oCAAoC;YACpC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;QAC3C,CAAC;QAED,SAAe,WAAW,CACtB,kBAA6C,EAC7C,SAA8B;;gBAE9B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC1B,iBAAiB,EACjB,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EACnD,kBAAkB,CAAC,MAAM,CAC5B,CAAC;gBACF,MAAM,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBACvC,MAAM,gBAAgB,CAAC,QAAQ,EAAE,iCAAiC,CAAC,CAAC;YACxE,CAAC;SAAA;QAED,mDAAmD;QACnD,MAAM,OAAO,CAAC,UAAU,CACpB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,kBAAkB,EAAE,SAAS,CAAC,EAAE,EAAE,CACpE,WAAW,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAC7C,CACJ,CAAC;IACN,CAAC,CAAA,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,oBAAoB,GAAG,KAAK,CAAC,WAAW,CAC1C,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;QACf,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO;QACX,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,CAAC,qBAAqB,EAAE,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7D,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC,EACD,CAAC,MAAM,CAAC,CACX,CAAC;IAEF,OAAO,CACH,KAAC,UAAU,IAAC,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAC,cAAc,EAAC,KAAK,EAAE,eAAe,YACxG,QAAQ,GACA,CAChB,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CACvB,QAAyC,EACzC,aAAwC;IAExC,0HAA0H;IAC1H,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACxD,OAAO,UAAU,CAAC;QACd,6CAA6C;QAC7C,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG;QAC3B,MAAM,EAAE,KAAK,EAAE;QACf,QAAQ,EAAE,cAAc;KAC3B,CAAC,CAAC;AACP,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACrC,sCAAsC;IACtC,IAAI,UAAU,EAAE,EAAE,CAAC;QACf,OAAO,gBAAiB,MAAM,CAAC,YAAkC,CAAC,OAAO,CAAC,UAAU,QAAQ,GAAG,EAAE,CAAC;IACtG,CAAC;IAED,OAAO,gBAAgB,eAAe,EAAE,QAAQ,GAAG,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,gBAAgB,CAAC,EAAE,QAAQ,EAAiC;IACjE,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,CAAW,CAAC,OAAO,EAAE,EAAE;;QAC1D,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAA,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,mCAAI,MAAM,CAAC,CAAC;IAC3D,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,CAAa,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;QAC/D,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5C,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YACnC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP;;;;OAIG;IACH,MAAM,oBAAoB,GAAG,KAAK,CAAC,WAAW,CAAgB,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;QAC7E,MAAM,QAAQ,GAAG,CAAC,CAAe,EAAQ,EAAE;;YACvC,IAAI,CAAC,CAAC,WAAW,KAAK,YAAY,EAAE,CAAC;gBACjC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;oBACR,gDAAgD;oBAChD,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;oBAC1D,IAAI,KAAK,EAAE,CAAC;wBACR,MAAM,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;wBACpC,IAAI,YAAY,KAAK,eAAe,EAAE,EAAE,CAAC;4BACrC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,MAAA,CAAC,CAAC,QAAQ,mCAAI,MAAM,CAAC,CAAC,CAAC;wBACtD,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE7C,OAAO,GAAG,EAAE;YACR,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC,CAAC;IACN,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CACH,KAAC,UAAU,IAAC,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAC,cAAc,EAAC,KAAK,EAAE,eAAe,YACxG,QAAQ,GACA,CAChB,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CACvB,QAA6C,EAC7C,kBAA6C,EAC7C,QAAkC,EAClC,WAA8B;IAE9B,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO,UAAU,CAAC;QACd,OAAO,EAAE,QAAQ,CAAC,GAAG;QACrB,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;YACf,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAErC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,QAAQ,GAAG,IAAI,CAAC;gBAEhB,4EAA4E;gBAC5E,uDAAuD;gBACvD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACb,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;oBAE7D,OAAO,gBAAgB,CAAC,CAAC;wBACjB,iCAAiC,CAC7B,QAAQ,CAAC,OAA0B,EACnC,QAAQ,EACR,WAAW,EACX,kBAAkB,CAAC,MAAM,CAC5B;wBACL,CAAC,CAAG,QAAQ,CAAC,OAAO,CAAC;gBAC7B,CAAC;YACL,CAAC;YAED,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,MAAM,EAAE,KAAK,EAAE;QACf,QAAQ,EAAE,cAAc;KAC3B,CAAC,CAAC;AACP,CAAC;AAeD,MAAM,CAAC,MAAM,MAAM,GAMf;IACA,YAAY,EAAE;QACV,MAAM,EAAE,kBAAkB;QAC1B,IAAI,EAAE,gBAAgB;KACzB;IACD,YAAY,EAAE;QACV,MAAM,EAAE,kBAAkB;QAC1B,IAAI,EAAE,gBAAgB;KACzB;CACJ,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,QAA+C;;IACrE,MAAM,SAAS,GAAG,MAAA,QAAQ,CAAC,KAAK,0CAAE,UAAU,CAAC;IAE7C,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,MAAA,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,mCAAI,IAAI,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,QAAQ,EAAiC;IACtE,8EAA8E;IAC9E,OAAO,CACH,KAAC,gBAAgB,cACb,KAAC,gBAAgB,cAAE,QAAQ,GAAoB,GAChC,CACtB,CAAC;AACN,CAAC"}

package/dist/shared/interactivity/plain-variable.d.ts

@@ -0,0 +1,17 @@
+import { RecoilState } from 'recoil';
+import { WebSocketClientInterface } from '../../api';
+import { RequestExtras } from '../../api/http';
+import { GlobalTaskContext } from '../../shared/context/global-task-context';
+import { SingleVariable } from '../../types';
+/**
+ * Get a plain variable from the atom or selector registry (based on nested property),
+ * registering it if not already registered
+ *
+ * @param variable variable to register
+ * @param wsClient websocket client
+ * @param taskContext task context
+ * @param search search query
+ * @param extras request extras to be merged into the options
+ */
+export declare function getOrRegisterPlainVariable<T>(variable: SingleVariable<T>, wsClient: WebSocketClientInterface, taskContext: GlobalTaskContext, extras: RequestExtras): RecoilState<T>;
+//# sourceMappingURL=plain-variable.d.ts.map

package/dist/shared/interactivity/plain-variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-variable.d.ts","sourceRoot":"","sources":["../../../js/shared/interactivity/plain-variable.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,WAAW,EAA8B,MAAM,QAAQ,CAAC;AAG7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,aAAa,EAA6B,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE,OAAO,EAAmB,cAAc,EAAqB,MAAM,SAAS,CAAC;AAqG7E;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EACxC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAC3B,QAAQ,EAAE,wBAAwB,EAClC,WAAW,EAAE,iBAAiB,EAC9B,MAAM,EAAE,aAAa,GACtB,WAAW,CAAC,CAAC,CAAC,CAuJhB"}

package/dist/shared/interactivity/plain-variable.js

@@ -0,0 +1,222 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _a, _StateSynchronizer_instance, _StateSynchronizer_observers;
+import { atomFamily, selectorFamily } from 'recoil';
+import { BehaviorSubject } from 'rxjs';
+import { RequestExtrasSerializable } from '../../api/http';
+import { isEmbedded } from '../../shared/utils/embed';
+import { isDerivedVariable } from '../../types';
+// eslint-disable-next-line import/no-cycle
+import { STORES, getEffect, getOrRegisterDerivedVariableValue, resolveNested, setNested } from './internal';
+import { atomFamilyMembersRegistry, atomFamilyRegistry, getRegistryKey, selectorFamilyRegistry } from './store';
+/**
+ * State synchronizer singleton
+ *
+ * Used to synchronize changes across atoms of the same family
+ */
+class StateSynchronizer {
+    // eslint-disable-next-line no-useless-constructor, no-empty-function
+    constructor() {
+        _StateSynchronizer_observers.set(this, new Map());
+    }
+    static getInstance() {
+        if (!__classPrivateFieldGet(_a, _a, "f", _StateSynchronizer_instance)) {
+            __classPrivateFieldSet(_a, _a, new _a(), "f", _StateSynchronizer_instance);
+        }
+        return __classPrivateFieldGet(_a, _a, "f", _StateSynchronizer_instance);
+    }
+    /**
+     * Register a key in the state synchronizer
+     *
+     * @param key key to register
+     * @param defaultValue value to register
+     */
+    register(key, defaultValue) {
+        if (!__classPrivateFieldGet(this, _StateSynchronizer_observers, "f").has(key)) {
+            __classPrivateFieldGet(this, _StateSynchronizer_observers, "f").set(key, new BehaviorSubject({ type: 'initial', value: defaultValue }));
+        }
+    }
+    /**
+     * Check if a given key is registered in the state synchronizer
+     *
+     * @param key key to check if registered
+     */
+    isRegistered(key) {
+        return __classPrivateFieldGet(this, _StateSynchronizer_observers, "f").has(key);
+    }
+    /**
+     * Get the current state for a given key
+     *
+     * @param key key to get the current value for
+     */
+    getCurrentState(key) {
+        if (!this.isRegistered(key)) {
+            return null;
+        }
+        return __classPrivateFieldGet(this, _StateSynchronizer_observers, "f").get(key).getValue();
+    }
+    /**
+     * Subscribe to changes on a given key
+     *
+     * @param key key to subscribe to
+     */
+    subscribe(key, subscription) {
+        // If somehow the ended up with no listener here, register it with null value
+        if (!this.isRegistered(key)) {
+            this.register(key, null);
+        }
+        const sub = __classPrivateFieldGet(this, _StateSynchronizer_observers, "f").get(key).subscribe(subscription);
+        return () => {
+            sub.unsubscribe();
+            // if no more observers, remove the listener
+            if (__classPrivateFieldGet(this, _StateSynchronizer_observers, "f").get(key).observers.length === 0) {
+                __classPrivateFieldGet(this, _StateSynchronizer_observers, "f").delete(key);
+            }
+        };
+    }
+    /**
+     * Notify listeners for a given key
+     *
+     * @param key key to notify listeners for
+     * @param update update to notify about
+     */
+    notify(key, update) {
+        // If somehow the ended up with no listener here, register it with null value
+        if (!this.isRegistered(key)) {
+            this.register(key, null);
+        }
+        __classPrivateFieldGet(this, _StateSynchronizer_observers, "f").get(key).next(update);
+    }
+}
+_a = StateSynchronizer, _StateSynchronizer_observers = new WeakMap();
+_StateSynchronizer_instance = { value: void 0 };
+/**
+ * Get a plain variable from the atom or selector registry (based on nested property),
+ * registering it if not already registered
+ *
+ * @param variable variable to register
+ * @param wsClient websocket client
+ * @param taskContext task context
+ * @param search search query
+ * @param extras request extras to be merged into the options
+ */
+export function getOrRegisterPlainVariable(variable, wsClient, taskContext, extras) {
+    const isNested = variable.nested && variable.nested.length > 0;
+    const isDefaultDerived = isDerivedVariable(variable.default);
+    if (!atomFamilyRegistry.has(variable.uid)) {
+        atomFamilyRegistry.set(variable.uid, atomFamily({
+            /*
+            If created from a DerivedVariable, link the default state to that DV's selector
+            From Recoil docs:
+            "If a selector is used as the default the atom will dynamically update as the default selector updates.
+            Once the atom is set, then it will retain that value unless the atom is reset."
+
+            Otherwise just use variable.default directly.
+            */
+            default: isDefaultDerived ?
+                (extrasSerializable) => getOrRegisterDerivedVariableValue(variable.default, wsClient, taskContext, extrasSerializable.extras)
+                : variable.default,
+            effects: (extrasSerializable) => {
+                const familySync = ({ onSet, setSelf, resetSelf, node }) => {
+                    // Register the atom in the state synchronizer if not already registered
+                    if (!StateSynchronizer.getInstance().isRegistered(variable.uid)) {
+                        StateSynchronizer.getInstance().register(variable.uid, variable.default);
+                    }
+                    else {
+                        const currentState = StateSynchronizer.getInstance().getCurrentState(variable.uid);
+                        if (!isDefaultDerived || (currentState === null || currentState === void 0 ? void 0 : currentState.type) !== 'initial') {
+                            // Otherwise synchronize the initial value,
+                            // unless the default is a DerivedVariable and the current state is initial
+                            // because in that case the default will be linked to the selector which needs to be resolved
+                            setSelf(currentState === null || currentState === void 0 ? void 0 : currentState.value);
+                        }
+                    }
+                    // Synchronize changes across atoms of the same family
+                    const unsub = StateSynchronizer.getInstance().subscribe(variable.uid, (update) => {
+                        if (update.type === 'initial') {
+                            return;
+                        }
+                        // skip updates from the same atom
+                        if (update.nodeKey === node.key) {
+                            return;
+                        }
+                        if (update.isReset) {
+                            resetSelf();
+                        }
+                        else {
+                            setSelf(update.value);
+                        }
+                    });
+                    onSet((newValue, oldValue, isReset) => {
+                        StateSynchronizer.getInstance().notify(variable.uid, {
+                            isReset,
+                            nodeKey: node.key,
+                            oldValue,
+                            type: 'update',
+                            value: newValue,
+                        });
+                    });
+                    return unsub;
+                };
+                const effects = [familySync];
+                // add an effect to handle backend store updates
+                const storeEffect = getEffect(variable);
+                if (storeEffect) {
+                    effects.push(storeEffect(variable, extrasSerializable, wsClient, taskContext));
+                }
+                else {
+                    // TODO: This is in an else block to ensure store effect are mutually exclusive, can be unified once backend API is unified
+                    // If persist_value flag is set, register an effect which updates the selected value in local storage
+                    // TODO: once BrowserStore is implemented instead of persist_value, this block can only check for isEmbedded
+                    // eslint-disable-next-line no-lonely-if
+                    if (variable.persist_value || isEmbedded()) {
+                        effects.push(STORES.BrowserStore.effect(variable, extrasSerializable, wsClient, taskContext));
+                    }
+                }
+                return effects;
+            },
+            key: variable.uid,
+        }));
+    }
+    const family = atomFamilyRegistry.get(variable.uid);
+    const extrasSerializable = new RequestExtrasSerializable(extras);
+    const atomInstance = family(extrasSerializable);
+    // Register the atom instance in the atomFamilyMembersRegistry so we can retrieve it later
+    if (!atomFamilyMembersRegistry.has(family)) {
+        atomFamilyMembersRegistry.set(family, new Map());
+    }
+    atomFamilyMembersRegistry.get(family).set(extrasSerializable.toJSON(), atomInstance);
+    // In case of a nested variable, register and return a selector to resolve the nested values
+    if (isNested) {
+        const key = getRegistryKey(variable, 'selector');
+        if (!selectorFamilyRegistry.has(key)) {
+            // Below we make sure nested is a list of strings
+            // this is validated on the Python side but when using @template we can't validate it and is replaced at runtime
+            // so we coerce it to a list of strings here
+            selectorFamilyRegistry.set(key, selectorFamily({
+                get: (currentExtras) => ({ get }) => {
+                    const variableValue = get(family(currentExtras));
+                    return resolveNested(variableValue, variable.nested.map((n) => String(n)));
+                },
+                key,
+                set: (currentExtras) => ({ set }, newValue) => {
+                    set(family(currentExtras), (v) => setNested(v, variable.nested.map((n) => String(n)), newValue));
+                },
+            }));
+        }
+        const selectorFamilyInstance = selectorFamilyRegistry.get(key);
+        // We cast it since it's a writeable selector
+        return selectorFamilyInstance(extrasSerializable);
+    }
+    return atomInstance;
+}
+//# sourceMappingURL=plain-variable.js.map

package/dist/shared/interactivity/plain-variable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-variable.js","sourceRoot":"","sources":["../../../js/shared/interactivity/plain-variable.tsx"],"names":[],"mappings":"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"}

package/dist/shared/interactivity/resolve-value.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Resolve a value to a format understood by the backend, calling any callback found.
+ *
+ * Resolves:
+ * - simple values to themselves,
+ * - callbacks to their return values,
+ * - for a ResolvedDerivedVariable, recursively resolve its dependencies, remove deps values (to maintain a consistent request payload shape)
+ *
+ * @param value a value to resolve
+ * @param force whether to force a derived variable recalculation
+ */
+export declare function resolveValue(value: unknown, force: boolean): any;
+//# sourceMappingURL=resolve-value.d.ts.map

package/dist/shared/interactivity/resolve-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-value.d.ts","sourceRoot":"","sources":["../../../js/shared/interactivity/resolve-value.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,CAkBhE"}

package/dist/shared/interactivity/resolve-value.js

@@ -0,0 +1,36 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { isResolvedDerivedDataVariable, isResolvedDerivedVariable } from '../../types';
+/**
+ * Resolve a value to a format understood by the backend, calling any callback found.
+ *
+ * Resolves:
+ * - simple values to themselves,
+ * - callbacks to their return values,
+ * - for a ResolvedDerivedVariable, recursively resolve its dependencies, remove deps values (to maintain a consistent request payload shape)
+ *
+ * @param value a value to resolve
+ * @param force whether to force a derived variable recalculation
+ */
+export function resolveValue(value, force) {
+    if (isResolvedDerivedVariable(value) || isResolvedDerivedDataVariable(value)) {
+        const { deps } = value, rest = __rest(value, ["deps"]);
+        const resolvedValues = value.values.map((v) => resolveValue(v, force));
+        return Object.assign(Object.assign({}, rest), { force, values: resolvedValues });
+    }
+    if (typeof value === 'function') {
+        // Make sure the value returned by the callback is also resolved
+        return resolveValue(value(), force);
+    }
+    return value;
+}
+//# sourceMappingURL=resolve-value.js.map

package/dist/shared/interactivity/resolve-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-value.js","sourceRoot":"","sources":["../../../js/shared/interactivity/resolve-value.tsx"],"names":[],"mappings":";;;;;;;;;;;AAAA,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEnF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,KAAc;IACvD,IAAI,yBAAyB,CAAC,KAAK,CAAC,IAAI,6BAA6B,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,MAAM,EAAE,IAAI,KAAc,KAAK,EAAd,IAAI,UAAK,KAAK,EAAzB,QAAiB,CAAQ,CAAC;QAChC,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAEvE,uCACO,IAAI,KACP,KAAK,EACL,MAAM,EAAE,cAAc,IACxB;IACN,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAC9B,gEAAgE;QAChE,OAAO,YAAY,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/shared/interactivity/resolve-variable.d.ts

@@ -0,0 +1,18 @@
+import { RecoilState } from 'recoil';
+import { WebSocketClientInterface } from '../../api';
+import { RequestExtras } from '../../api/http';
+import { GlobalTaskContext } from '../../shared/context/global-task-context';
+import { AnyVariable, ResolvedDataVariable, ResolvedDerivedDataVariable, ResolvedDerivedVariable } from '../../types';
+/**
+ * Resolve a variable to a value (for non-derived variables using provided resolver)
+ * or a ResolvedDerivedVariable (if it's a derived variable).
+ * Registers all encountered variables which aren't yet in registry.
+ *
+ * @param variable variable to resolve
+ * @param client websocket client from context
+ * @param taskContext global task context
+ * @param extras request extras to be merged into the options
+ * @param resolver function to run the value through (for non-derived variables)
+ */
+export declare function resolveVariable<VariableType>(variable: AnyVariable<VariableType>, client: WebSocketClientInterface, taskContext: GlobalTaskContext, extras: RequestExtras, resolver?: (val: RecoilState<VariableType>) => RecoilState<VariableType> | ResolvedDerivedVariable | VariableType): RecoilState<VariableType> | ResolvedDerivedVariable | ResolvedDerivedDataVariable | ResolvedDataVariable | VariableType;
+//# sourceMappingURL=resolve-variable.d.ts.map

package/dist/shared/interactivity/resolve-variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-variable.d.ts","sourceRoot":"","sources":["../../../js/shared/interactivity/resolve-variable.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EACH,WAAW,EACX,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,EAK1B,MAAM,SAAS,CAAC;AAUjB;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,YAAY,EACxC,QAAQ,EAAE,WAAW,CAAC,YAAY,CAAC,EACnC,MAAM,EAAE,wBAAwB,EAChC,WAAW,EAAE,iBAAiB,EAC9B,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,CAAC,GAAG,EAAE,WAAW,CAAC,YAAY,CAAC,KAAK,WAAW,CAAC,YAAY,CAAC,GAAG,uBAAuB,GAAG,YAE5F,GAEN,WAAW,CAAC,YAAY,CAAC,GACzB,uBAAuB,GACvB,2BAA2B,GAC3B,oBAAoB,GACpB,YAAY,CAqCjB"}