@darajs/core 1.0.0-a.1

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

@@ -0,0 +1,186 @@
+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 { useCallback, useRef } from 'react';
+import { atom } from 'recoil';
+import { HTTP_METHOD, validateResponse } from '@darajs/ui-utils';
+import { fetchTaskResult } from '../../api';
+import { request } from '../../api/http';
+import { useSessionToken } from '../../auth/auth-context';
+import { combineFilters } from './filtering';
+import { atomRegistry } from './store';
+/**
+ * Format a DataVariable into a ResolvedDataVariable structure for the backend
+ *
+ * @param variable the variable to resolve for the backend
+ */
+export function resolveDataVariable(variable) {
+    return {
+        filters: variable.filters,
+        type: 'data',
+        uid: variable.uid,
+    };
+}
+/**
+ * Create necessary query parameters on a URL based on pagination settings
+ *
+ * @param path url path
+ * @param pagination pagination object
+ */
+function createDataUrl(path, pagination) {
+    const url = new URL(path, window.location.origin);
+    if (pagination === null || pagination === void 0 ? void 0 : pagination.limit) {
+        url.searchParams.set('limit', String(pagination.limit));
+    }
+    if (pagination === null || pagination === void 0 ? void 0 : pagination.offset) {
+        url.searchParams.set('offset', String(pagination.offset));
+    }
+    if (pagination === null || pagination === void 0 ? void 0 : pagination.sort) {
+        url.searchParams.set('order_by', (pagination.sort.desc ? '-' : '') + pagination.sort.id);
+    }
+    return url;
+}
+/**
+ * Retrieve the value of a data variable from the backend
+ *
+ * @param uid
+ * @param token
+ * @param filters
+ * @param pagination
+ */
+export function fetchDataVariable(uid, token, filters, pagination) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const url = createDataUrl(`/api/core/data-variable/${uid}`, pagination);
+        const response = yield request(url, { body: JSON.stringify({ filters }), method: HTTP_METHOD.POST }, token);
+        yield validateResponse(response, 'Failed to fetch data variable');
+        return response.json();
+    });
+}
+export function isDataResponse(response) {
+    return typeof response === 'object' && 'data' in response && 'totalCount' in response;
+}
+/**
+ * Retrieve the value of a derived data variable from the backend
+ *
+ * @param uid
+ * @param token
+ * @param filters
+ * @param pagination
+ * @param cacheKey - cache key of the underlying DV, required for DerivedDataVariables
+ * @param wsChannel - websocket channel, required for DerivedDataVariables
+ */
+export function fetchDerivedDataVariable(uid, token, cacheKey, wsChannel, filters, pagination) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const url = createDataUrl(`/api/core/data-variable/${uid}`, pagination);
+        const response = yield request(url, { body: JSON.stringify({ cache_key: cacheKey, filters, ws_channel: wsChannel }), method: HTTP_METHOD.POST }, token);
+        yield validateResponse(response, 'Failed to fetch data variable');
+        return response.json();
+    });
+}
+/**
+ * Get total count of data in a data variable
+ *
+ * @param uid uid of the variable
+ * @param token session token
+ * @param cacheKey cache key of the underlying DV in the case of derived data variables
+ */
+function fetchDataVariableCount(uid, token, filters, cacheKey) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield request(`/api/core/data-variable/${uid}/count`, { body: JSON.stringify({ cache_key: cacheKey, filters }), method: HTTP_METHOD.POST }, token);
+        yield validateResponse(response, 'Failed to fetch data variable total count');
+        return response.json();
+    });
+}
+/**
+ * Get a callback to fetch data variable from the backend
+ *
+ * @param variable variable instance
+ * @param token session token
+ * @param serverTriggerCounter a counter to force recreation of the callback
+ */
+export function useFetchDataVariable(variable, serverTriggerCounter) {
+    const token = useSessionToken();
+    const dataCallback = useCallback((filters, pagination) => __awaiter(this, void 0, void 0, function* () {
+        const mergedFilters = combineFilters('AND', [variable.filters, filters]);
+        const data = yield fetchDataVariable(variable.uid, token, mergedFilters, pagination);
+        const totalCount = yield fetchDataVariableCount(variable.uid, token, mergedFilters);
+        return {
+            data,
+            totalCount,
+        };
+    }), [variable, token, serverTriggerCounter]);
+    return dataCallback;
+}
+/**
+ * Get a callback to fetch derived data variable from the backend.
+ * Throws a TaskCancelledError when the backend task is cancelled.
+ *
+ * @param variable variable instance
+ * @param taskContext global task context
+ * @param wsClient websocket client instance
+ * @param dvValuePromise promise representing underlying derived variable state
+ * @param token session token
+ */
+export function useFetchDerivedDataVariable(variable, taskContext, wsClient, dvValuePromise) {
+    const token = useSessionToken();
+    const previousResult = useRef({ data: null, totalCount: 0 });
+    const dataCallback = useCallback((filters, pagination) => __awaiter(this, void 0, void 0, function* () {
+        const mergedFilters = combineFilters('AND', [variable.filters, filters]);
+        const dvValue = yield dvValuePromise;
+        const response = yield fetchDerivedDataVariable(variable.uid, token, dvValue.cache_key, yield wsClient.getChannel(), mergedFilters, pagination);
+        let data = null;
+        const variableTaskId = `${variable.uid}-filter`;
+        // cancel previously running filter tasks
+        taskContext.cleanupRunningTasks(variableTaskId);
+        // if task was returned, wait for it to complete and fetch task result
+        if (response && 'task_id' in response) {
+            const taskId = response.task_id;
+            // add task to currently running tasks
+            taskContext.startTask(taskId, variableTaskId);
+            try {
+                yield wsClient.waitForTask(taskId);
+            }
+            catch (_a) {
+                // If an error occurred (i.e. task was cancelled) return the previous result.
+                // This would also cause the callback's identity to change so if the consuming component is
+                // honouring the contract, it should execute the callback again
+                return previousResult.current;
+            }
+            finally {
+                taskContext.endTask(taskId);
+            }
+            data = yield fetchTaskResult(taskId, token);
+        }
+        else {
+            // otherwise use response directly
+            data = response;
+        }
+        // For derived data variables count can only be fetched when task is not running so we have to make the request here
+        // As the total count could have changed because of the underlying DV changing
+        const totalCount = yield fetchDataVariableCount(variable.uid, token, mergedFilters, dvValue.cache_key);
+        previousResult.current = { data, totalCount };
+        return {
+            data,
+            totalCount,
+        };
+    }), [variable, token, dvValuePromise]);
+    return dataCallback;
+}
+/**
+ * Register an empty atom for DataVariable.
+ * Used to check whether a variable is registered within the app.
+ *
+ * @param variable variable to register
+ */
+export function registerDataVariable(variable) {
+    if (!atomRegistry.has(variable.uid)) {
+        atomRegistry.set(variable.uid, atom({ default: true, key: variable.uid }));
+    }
+}
+//# sourceMappingURL=data-variable.js.map

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

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

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

@@ -0,0 +1,153 @@
+import { GetRecoilValue, RecoilValue } from 'recoil';
+import { WebSocketClientInterface } from '../../api';
+import { GlobalTaskContext } from '../../shared/context/global-task-context';
+import { AnyVariable, DerivedDataVariable, DerivedVariable, ResolvedDataVariable, ResolvedDerivedDataVariable, ResolvedDerivedVariable } from '../../types';
+import { TriggerIndexValue } from './store';
+export interface DerivedVariableValueResponse<T> {
+    cache_key: string;
+    value: T;
+}
+type DerivedVariableResponse<T> = DerivedVariableTaskResponse | DerivedVariableValueResponse<T>;
+export declare function isTaskResponse(dvResponse: DerivedVariableResponse<any>): dvResponse is DerivedVariableTaskResponse;
+interface DerivedVariableTaskResponse {
+    cache_key: string;
+    task_id: string;
+}
+/**
+ * Format values into a shape expected by the backend.
+ *
+ * @param values list of values - plain values or ResolvedDerivedVariable constructs with plain values nested inside
+ */
+export declare function formatDerivedVariableRequest(values: Array<any | ResolvedDerivedVariable>): any[];
+interface FetchDerivedVariableArgs {
+    cache: DerivedVariable['cache'];
+    force: boolean;
+    is_data_variable?: boolean;
+    token: string;
+    uid: string;
+    values: Record<string | number, any>;
+    wsClient: WebSocketClientInterface;
+}
+/**
+ * Fetch the value of a derived variable from the backend
+ *
+ * @param input Function inputs
+ * - `cache`, the cache option for the derived variable.
+ * - `force`, send force=true in the request body
+ * - `sessionToken`, bearer token for the session
+ * - `uid`, the uid of the derived variable
+ * - `values`, values to pass in the request
+ * - `wsClient`, websocket client
+ */
+export declare function fetchDerivedVariable<T>({ cache, force, token, uid, values, wsClient, is_data_variable, }: FetchDerivedVariableArgs): Promise<DerivedVariableResponse<T>>;
+/**
+ * Resolve a value to a format understood by the backend, resolving atoms to values.
+ *
+ * @param value value to resolve
+ * @param getter recoil getter function
+ */
+export declare function resolveValue(value: ResolvedDerivedVariable | ResolvedDerivedDataVariable | ResolvedDataVariable | RecoilValue<any>, getter: GetRecoilValue): any;
+/**
+ * Recursively build a deps array from a list of values
+ * Values not in deps array are replaced with empty array
+ *
+ * @param values array of primitives and ResolvedDerivedVariable objects
+ * @param deps array of indexes of dependencies to get values from
+ */
+export declare function getDeps(values: Array<ResolvedDerivedVariable | any>, deps?: number[]): any[];
+/**
+ * A helper hook that turns a DerivedVariable into its trigger index value.
+ * Useful to subscribe a component to forced trigger updates.
+ *
+ * @param variable variable to use
+ */
+export declare function useTriggerIndex(variable: DerivedVariable): TriggerIndexValue;
+/**
+ * DerivedVariable resolution result meaning that the value did not change since last time
+ * and should be returned from the previous entry.
+ */
+interface PreviousResult {
+    /**
+     * Previous entry in the depsRegistry found to not have been changed
+     */
+    entry: {
+        args: any[];
+        cacheKey: string;
+        result: any;
+    };
+    type: 'previous';
+}
+/**
+ * DerivedVariable resolution result meaning that the value changed since last time
+ * and should be refetched.
+ */
+interface CurrentResult {
+    /**
+     * Whether the refetch should be forcing
+     */
+    force: boolean;
+    /**
+     * List of new 'relevant' values which should be used to update the depsRegistry entry if refetch was successful
+     */
+    relevantValues: any[];
+    type: 'current';
+    /**
+     * List of values to use in the refetch request
+     */
+    values: any[];
+}
+/**
+ * Represents the result of a derived variable resolution.
+ */
+type DerivedResult = PreviousResult | CurrentResult;
+/**
+ * Resolve a derived value from a list of dependant variables and their resolved values.
+ *
+ * Handles a dependency array, where in case 'relevant' (i.e. present in deps) values did not change,
+ * an earlier result from the `depsRegistry` is returned.
+ *
+ * This is the core of the derived variable resolution logic, extracted so that it can be used in both
+ * DerivedVariable and py_component logic.
+ *
+ * @param key unique key to look up `depsRegistry` entry from
+ * @param variables dependant variables
+ * @param deps list of relevant dependant variables, akin to useEffect dependency array
+ * @param resolvedVariables resolved values of dependant variables - turned into primitives and Resolved forms
+ * @param wsClient websocket client
+ * @param get getter function to resolve atoms to values
+ * @param selfTrigger additional trigger index value to register as a dependency
+ */
+export declare function resolveDerivedValue(key: string, variables: AnyVariable<any>[], deps: AnyVariable<any>[], resolvedVariables: any[], wsClient: WebSocketClientInterface, get: GetRecoilValue, selfTrigger?: TriggerIndexValue): Promise<DerivedResult>;
+/**
+ * Get a derived variable from the selector registry, registering it if not already registered
+ *
+ * @param variable variable to register
+ * @param wsClient WebSocket client from context
+ * @param tasks tasks list from context
+ * @param search search query from location
+ * @param sessionToken session token from context
+ */
+export declare function getOrRegisterDerivedVariable(variable: DerivedVariable | DerivedDataVariable, wsClient: WebSocketClientInterface, taskContext: GlobalTaskContext, search: string, token: string): RecoilValue<DerivedVariableValueResponse<any>>;
+/**
+ * Get a derived selector for a derived variable.
+ * Retrieves the value of the derived variable directly instead of returning an object with cache_key and value.
+ *
+ * @param variable variable to register
+ * @param wsClient WebSocket client from context
+ * @param taskContext global task context
+ * @param search search query from location
+ * @param sessionToken session token from context
+ */
+export declare function getOrRegisterDerivedVariableValue(variable: DerivedVariable, wsClient: WebSocketClientInterface, taskContext: GlobalTaskContext, search: string, token: string): RecoilValue<any>;
+/**
+ * Helper hook to get the (data) derived variable selector, while correctly registering triggers and setting up polling interval.
+ *
+ * @param variable derived variable to use
+ * @param WsClient websocket client instance
+ * @param taskContext global task context
+ * @param search search query
+ * @param token auth context
+ */
+export declare function useDerivedVariable(variable: DerivedVariable | DerivedDataVariable, WsClient: WebSocketClientInterface, taskContext: GlobalTaskContext, search: string, token: string): RecoilValue<DerivedVariableValueResponse<any>>;
+export {};
+//# sourceMappingURL=derived-variable.d.ts.map

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

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