@livestore/livestore 0.0.12 → 0.0.13

package/dist/react/useLiveStoreComponent.js

@@ -0,0 +1,301 @@
+import { omit, shouldNeverHappen } from '@livestore/utils';
+import { Schema } from '@livestore/utils/effect';
+import * as otel from '@opentelemetry/api';
+import { SqliteDsl } from 'effect-db-schema';
+import { isEqual, mapValues } from 'lodash-es';
+import React from 'react';
+import { v4 as uuid } from 'uuid';
+import { labelForKey, tableNameForComponentKey } from '../componentKey.js';
+import { sql } from '../util.js';
+import { useStore } from './LiveStoreContext.js';
+import { useStateRefWithReactiveInput } from './utils/useStateRefWithReactiveInput.js';
+// type ComponentState = {
+//   /** Equivalent to `componentKey.key` */
+//   id: string
+//   [key: string]: string | number | boolean | null
+// }
+/**
+ * This is needed because the `React.useMemo` call below, can sometimes be called multiple times 🤷,
+ * so we need to "cache" the fact that we've already started a span for this component.
+ * The map entry is being removed again in the `React.useEffect` call below.
+ */
+const spanAlreadyStartedCache = new Map();
+/**
+ * Create reactive queries within a component.
+ * @param config.queries A function that returns a map of named reactive queries.
+ * @param config.componentKey A function that returns a unique key for this component.
+ * @param config.reactDeps A list of React-level dependencies that will refresh the queries.
+ */
+export const useLiveStoreComponent = ({ stateSchema: stateSchema_, queries = () => ({}), componentKey: componentKeyConfig, reactDeps = [], }) => {
+    // TODO validate schema to make sure each column has a default value
+    // TODO we should clean up the state schema handling to remove this special handling for the `id` column
+    const stateSchema = React.useMemo(() => (stateSchema_ ? { ...stateSchema_, columns: omit(stateSchema_.columns, 'id') } : undefined), [stateSchema_]);
+    // performance.mark('useLiveStoreComponent:start')
+    const componentKey = useComponentKey(componentKeyConfig, reactDeps);
+    const { store, globalQueries } = useStore();
+    const componentKeyLabel = React.useMemo(() => labelForKey(componentKey), [componentKey]);
+    // The following `React.useMemo` and `React.useEffect` calls are used to start and end a span for the lifetime of this component.
+    const { span, otelContext } = React.useMemo(() => {
+        const existingSpan = spanAlreadyStartedCache.get(componentKeyLabel);
+        if (existingSpan !== undefined)
+            return existingSpan;
+        const span = store.otel.tracer.startSpan(`LiveStore:useLiveStoreComponent:${componentKeyLabel}`, {}, store.otel.queriesSpanContext);
+        const otelContext = otel.trace.setSpan(otel.context.active(), span);
+        spanAlreadyStartedCache.set(componentKeyLabel, { span, otelContext });
+        return { span, otelContext };
+    }, [componentKeyLabel, store.otel.queriesSpanContext, store.otel.tracer]);
+    React.useEffect(() => () => {
+        spanAlreadyStartedCache.delete(componentKeyLabel);
+        span.end();
+    }, [componentKeyLabel, span]);
+    const generateQueries = React.useCallback(({ state$, otelContext, registerSubscription, isTemporaryQuery, }) => queries({
+        rxSQL: (genQuery, queriedTables, bindValues) => store.querySQL(genQuery, { queriedTables, bindValues, otelContext, componentKey }),
+        rxGraphQL: (query, genVariableValues, label) => store.queryGraphQL(query, genVariableValues, { componentKey, label, otelContext }),
+        globalQueries,
+        state$,
+        subscribe: registerSubscription,
+        isTemporaryQuery,
+    }), 
+    // NOTE: we don't include the queries function passed in by the user here;
+    // the reason is that we don't want to force them to memoize that function.
+    // Instead, we just assume that the function always has the same contents.
+    // This makes sense for LiveStore because the component config should be static.
+    // TODO: document this and consider whether it's the right API surface.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [store, componentKey, globalQueries]);
+    const defaultComponentState = React.useMemo(() => {
+        const defaultState = (stateSchema === undefined ? {} : mapValues(stateSchema.columns, (c) => c.default));
+        // @ts-expect-error TODO fix typing
+        defaultState.id = componentKeyConfig.id;
+        return defaultState;
+    }, [componentKeyConfig.id, stateSchema]);
+    const componentStateEffectSchema = React.useMemo(() => (stateSchema ? SqliteDsl.structSchemaForTable(stateSchema) : Schema.any), [stateSchema]);
+    // Step 1:
+    // Synchronously create state and queries for initial render pass.
+    // We do this in a temporary query context which cleans up after itself, making it idempotent
+    // TODO get rid of the temporary query workaround
+    const { initialComponentState, initialQueryResults } = React.useMemo(() => {
+        return store.otel.tracer.startActiveSpan('LiveStore:useLiveStoreComponent:initial', {}, otelContext, (span) => {
+            const otelContext = otel.trace.setSpan(otel.context.active(), span);
+            return store.inTempQueryContext(() => {
+                try {
+                    // create state query
+                    let state$;
+                    if (stateSchema === undefined) {
+                        // TODO don't set up a query if there's no state schema (keeps the graph more clean)
+                        state$ = store.queryJS(() => ({}), {
+                            componentKey,
+                            otelContext,
+                        });
+                    }
+                    else {
+                        const componentTableName = tableNameForComponentKey(componentKey);
+                        const whereClause = componentKey._tag === 'singleton' ? '' : `where id = '${componentKey.id}'`;
+                        state$ = store
+                            .querySQL(() => sql `select * from ${componentTableName} ${whereClause} limit 1`, {
+                            queriedTables: [componentTableName],
+                            componentKey,
+                            label: `localState:query:${componentKeyLabel}`,
+                            otelContext,
+                        })
+                            // TODO consider to instead of just returning the default value, to write the default component state to the DB
+                            .pipe((results) => results.length === 1
+                            ? Schema.parseSync(componentStateEffectSchema)(results[0])
+                            : defaultComponentState);
+                    }
+                    const initialComponentState = state$.results$.result;
+                    const queries = generateQueries({
+                        state$: state$,
+                        otelContext,
+                        registerSubscription: () => { },
+                        isTemporaryQuery: true,
+                    });
+                    for (const [name, query] of Object.entries(queries)) {
+                        query.label = name;
+                    }
+                    const initialQueryResults = mapValues(queries, (query) => query.results$.result);
+                    return { initialComponentState, initialQueryResults };
+                }
+                finally {
+                    span.end();
+                }
+            });
+        });
+    }, [
+        store,
+        otelContext,
+        stateSchema,
+        generateQueries,
+        componentKey,
+        componentKeyLabel,
+        componentStateEffectSchema,
+        defaultComponentState,
+    ]);
+    // Now that we've computed the initial state synchronously,
+    // we can set up our useState calls w/ a default value populated...
+    const [componentStateRef, setComponentState_] = useStateRefWithReactiveInput(initialComponentState);
+    const [queryResultsRef, setQueryResults_] = useStateRefWithReactiveInput(initialQueryResults);
+    const setState = (stateSchema === undefined
+        ? {}
+        : // TODO: do we have a better type for the values that can go in SQLite?
+            mapValues(stateSchema.columns, (column, columnName) => (value) => {
+                // Don't update the state if it's the same as the value already seen in the component
+                // @ts-expect-error TODO fix typing
+                if (componentStateRef.current[columnName] === value)
+                    return;
+                const encodedValue = Schema.encodeSync(column.type.codec)(value);
+                if (['componentKey', 'columnNames'].includes(columnName)) {
+                    shouldNeverHappen(`Can't use reserved column name ${columnName}`);
+                }
+                return store.applyEvent('updateComponentState', {
+                    componentKey,
+                    columnNames: [columnName],
+                    [columnName]: encodedValue,
+                });
+            }));
+    setState.setMany = (columnValues) => {
+        // TODO use hashing instead
+        // Don't update the state if it's the same as the value already seen in the component
+        // @ts-expect-error TODO fix typing
+        if (Object.entries(columnValues).every(([columnName, value]) => componentStateRef.current[columnName] === value)) {
+            return;
+        }
+        const columnNames = Object.keys(columnValues);
+        return store.applyEvent('updateComponentState', { componentKey, columnNames, ...columnValues });
+    };
+    // OK, now all the synchronous work is done;
+    // time to set up our long-running queries in an effect
+    React.useEffect(() => {
+        return store.otel.tracer.startActiveSpan('LiveStore:useLiveStoreComponent:long-running', { attributes: {} }, otelContext, (span) => {
+            const otelContext = otel.trace.setSpan(otel.context.active(), span);
+            const unsubs = [];
+            // create state query
+            let state$;
+            if (stateSchema === undefined) {
+                // TODO remove this query
+                state$ = store.queryJS(() => ({}), {
+                    componentKey,
+                    otelContext,
+                    label: 'empty-component-state',
+                });
+            }
+            else {
+                const componentTableName = tableNameForComponentKey(componentKey);
+                insertRowForComponentInstance({ store, componentKey, stateSchema });
+                const whereClause = componentKey._tag === 'singleton' ? '' : `where id = '${componentKey.id}'`;
+                state$ = store
+                    .querySQL(() => sql `select * from ${componentTableName} ${whereClause} limit 1`, {
+                    queriedTables: [componentTableName],
+                    componentKey,
+                    label: `localState:query:${componentKeyLabel}`,
+                    otelContext,
+                })
+                    // TODO consider to instead of just returning the default value, to write the default component state to the DB
+                    .pipe((results) => results.length === 1 ? Schema.parseSync(componentStateEffectSchema)(results[0]) : defaultComponentState);
+            }
+            unsubs.push(store.subscribe(state$, (results) => {
+                if (isEqual(results, componentStateRef.current) === false) {
+                    setComponentState_(results);
+                }
+            }, undefined, { label: `useLiveStoreComponent:localState:subscribe:${state$.label}` }));
+            const registerSubscription = (query, callback, onUnsubscribe) => {
+                unsubs.push(store.subscribe(query, (results) => {
+                    callback(results);
+                }, onUnsubscribe, { label: `useLiveStoreComponent:query:manual-subscribe:${query.label}` }));
+            };
+            const queries = generateQueries({ state$, otelContext, registerSubscription, isTemporaryQuery: false });
+            for (const [key, query] of Object.entries(queries)) {
+                // Use the field name given to this query in the useQueries hook as its label
+                query.label = key;
+                unsubs.push(store.subscribe(query, (results) => {
+                    const newQueryResults = { ...queryResultsRef.current, [key]: results };
+                    if (isEqual(newQueryResults, queryResultsRef.current) === false) {
+                        setQueryResults_(newQueryResults);
+                    }
+                }, undefined, { label: `useLiveStoreComponent:query:subscribe:${query.label}` }));
+            }
+            return () => {
+                for (const unsub of unsubs) {
+                    unsub();
+                }
+                span.end();
+            };
+        });
+        // NOTE excluding `setComponentState_` and `setQueryResults_` from the deps array as it seems to cause an infinite loop
+        // This should probably be improved
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        store,
+        componentKey,
+        stateSchema,
+        defaultComponentState,
+        generateQueries,
+        otelContext,
+        componentStateRef,
+        // setComponentState_,
+        // setQueryResults_,
+    ]);
+    // Very important: remove any queries / other resources associated w/ this component
+    React.useEffect(() => () => store.unmountComponent(componentKey), [store, componentKey]);
+    // performance.mark('useLiveStoreComponent:end')
+    // performance.measure(`useLiveStoreComponent:${componentKey.type}`, 'useLiveStoreComponent:start', 'useLiveStoreComponent:end')
+    const state = componentStateRef.current;
+    const useLiveStoreJsonState = (jsonStringKey, parse = (_) => _) => {
+        const value = React.useMemo(() => {
+            return parse(JSON.parse(state[jsonStringKey]));
+            // eslint-disable-next-line react-hooks/exhaustive-deps
+        }, [state[jsonStringKey], parse]);
+        const setValue = React.useCallback((newValOrFn) => {
+            const newVal = typeof newValOrFn === 'function'
+                ? // NOTE we're using the ref instead of the value because we want to be sure
+                    // we're using the latest value when the setter is called
+                    newValOrFn(parse(JSON.parse(componentStateRef.current[jsonStringKey])))
+                : newValOrFn;
+            setState[jsonStringKey](JSON.stringify(newVal));
+        }, [parse, jsonStringKey]);
+        return [value, setValue];
+    };
+    return {
+        queryResults: queryResultsRef.current,
+        state,
+        setState,
+        useLiveStoreJsonState,
+    };
+};
+export const useComponentKey = ({ name, id }, deps = []) => React.useMemo(() => {
+    switch (id) {
+        case 'singleton': {
+            return { _tag: 'singleton', componentName: name, id: 'singleton' };
+        }
+        case '__ephemeral__': {
+            return { _tag: 'ephemeral', componentName: name, id: uuid() };
+        }
+        default: {
+            return { _tag: 'custom', componentName: name, id };
+        }
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+}, [...deps, id, name]);
+/**
+ * Create a row storing the state for a component instance, if none exists yet.
+ * Initialized with default values, and keyed on the component key.
+ */
+const insertRowForComponentInstance = ({ store, componentKey, stateSchema, }) => {
+    const columnNames = ['id', ...Object.keys(stateSchema.columns)];
+    const columnValues = columnNames.map((name) => `$${name}`).join(', ');
+    const tableName = tableNameForComponentKey(componentKey);
+    const insertQuery = sql `insert into ${tableName} (${columnNames.join(', ')}) select ${columnValues} where not exists(select 1 from ${tableName} where id = '${componentKey.id}')`;
+    void store.execute(insertQuery, {
+        ...mapValues(stateSchema.columns, (column) => prepareValueForSql(column.default ?? null)),
+        id: componentKey.id,
+    }, [tableName]);
+};
+const prepareValueForSql = (value) => {
+    if (typeof value === 'string' || typeof value === 'number' || value === null) {
+        return value;
+    }
+    else {
+        return value ? 1 : 0;
+    }
+};
+//# sourceMappingURL=useLiveStoreComponent.js.map

package/dist/react/useLiveStoreComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveStoreComponent.js","sourceRoot":"","sources":["../../src/react/useLiveStoreComponent.ts"],"names":[],"mappings":"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"}

package/dist/react/utils/useStateRefWithReactiveInput.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+/**
+ * A variant of `React.useState` which allows the `inputState` to change over time as well.
+ * Important: This hook is synchronous / single-render-pass (i.e. doesn't use `useEffect` or `setState` directly).
+ *
+ * Notes:
+ * - The output state is always reset to the input state in case the input state changes (i.e. the previous "external" `setStateAndRerender` call is forgotten)
+ * - This hook might not work properly with React Suspense
+ * - Also see this Tweet for more potential problems: https://twitter.com/schickling/status/1677317711104278528
+ *
+ */
+export declare const useStateRefWithReactiveInput: <T>(inputState: T) => [React.MutableRefObject<T>, (newState: T | ((prev: T) => T)) => void];
+//# sourceMappingURL=useStateRefWithReactiveInput.d.ts.map

package/dist/react/utils/useStateRefWithReactiveInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStateRefWithReactiveInput.d.ts","sourceRoot":"","sources":["../../../src/react/utils/useStateRefWithReactiveInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,wFAE0B,IAAI,CAwBtE,CAAA"}

package/dist/react/utils/useStateRefWithReactiveInput.js

@@ -0,0 +1,38 @@
+import React from 'react';
+/**
+ * A variant of `React.useState` which allows the `inputState` to change over time as well.
+ * Important: This hook is synchronous / single-render-pass (i.e. doesn't use `useEffect` or `setState` directly).
+ *
+ * Notes:
+ * - The output state is always reset to the input state in case the input state changes (i.e. the previous "external" `setStateAndRerender` call is forgotten)
+ * - This hook might not work properly with React Suspense
+ * - Also see this Tweet for more potential problems: https://twitter.com/schickling/status/1677317711104278528
+ *
+ */
+export const useStateRefWithReactiveInput = (inputState) => {
+    const [_, rerender] = React.useState(0);
+    const lastKnownInputStateRef = React.useRef(inputState);
+    const stateRef = React.useRef(inputState);
+    if (lastKnownInputStateRef.current !== inputState) {
+        lastKnownInputStateRef.current = inputState;
+        // NOTE we don't need to re-render here, because the component is already re-rendering due to the `inputState` change
+        stateRef.current = inputState;
+    }
+    const setStateAndRerender = React.useCallback((newState) => {
+        // @ts-expect-error https://github.com/microsoft/TypeScript/issues/37663
+        const val = typeof newState === 'function' ? newState(stateRef.current) : newState;
+        stateRef.current = val;
+        rerender((c) => c + 1);
+    }, [rerender]);
+    return [stateRef, setStateAndRerender];
+};
+// Down-side of this implementation: Double render pass due to `setState` call (which forces a re-render)
+// Keeping around for now in case `useStateRefWithReactiveInput` doesn't work out
+// const _useStateWithReactiveInput = <T>(inputState: T): [T, (newState: T | ((prev: T) => T)) => void] => {
+//   const [externalState, setExternalState] = React.useState(inputState)
+//   if (externalState !== inputState) {
+//     setExternalState(inputState)
+//   }
+//   return [externalState, setExternalState]
+// }
+//# sourceMappingURL=useStateRefWithReactiveInput.js.map

package/dist/react/utils/useStateRefWithReactiveInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStateRefWithReactiveInput.js","sourceRoot":"","sources":["../../../src/react/utils/useStateRefWithReactiveInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,UAAa,EAC0D,EAAE;IACzE,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAEvC,MAAM,sBAAsB,GAAG,KAAK,CAAC,MAAM,CAAI,UAAU,CAAC,CAAA;IAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAI,UAAU,CAAC,CAAA;IAE5C,IAAI,sBAAsB,CAAC,OAAO,KAAK,UAAU,EAAE;QACjD,sBAAsB,CAAC,OAAO,GAAG,UAAU,CAAA;QAE3C,qHAAqH;QACrH,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAA;KAC9B;IAED,MAAM,mBAAmB,GAAG,KAAK,CAAC,WAAW,CAC3C,CAAC,QAA8B,EAAE,EAAE;QACjC,wEAAwE;QACxE,MAAM,GAAG,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;QAClF,QAAQ,CAAC,OAAO,GAAG,GAAG,CAAA;QACtB,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACxB,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAA;IAED,OAAO,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAA;AACxC,CAAC,CAAA;AAED,yGAAyG;AACzG,iFAAiF;AACjF,4GAA4G;AAC5G,yEAAyE;AAEzE,wCAAwC;AACxC,mCAAmC;AACnC,MAAM;AAEN,6CAA6C;AAC7C,IAAI"}

package/dist/reactive.d.ts

@@ -0,0 +1,140 @@
+import type { PrettifyFlat } from '@livestore/utils';
+import type * as otel from '@opentelemetry/api';
+import { BoundArray } from './bounded-collections.js';
+export type GetAtom = <T>(atom: Atom<T>) => T;
+export type Ref<T> = {
+    _tag: 'ref';
+    id: string;
+    result: T;
+    height: 0;
+    getResult: () => T;
+    sub: Set<Atom<any>>;
+    super: Set<Atom<any> | Effect>;
+    label?: string;
+    /** Container for meta information (e.g. the LiveStore Store) */
+    meta?: any;
+    equal: (a: T, b: T) => boolean;
+};
+type BaseThunk<T> = {
+    _tag: 'thunk';
+    id: string;
+    height: number;
+    getResult: (get: GetAtom, addDebugInfo: (debugInfo: any) => void) => T;
+    sub: Set<Atom<any>>;
+    super: Set<Atom<any> | Effect>;
+    label?: string;
+    /** Container for meta information (e.g. the LiveStore Store) */
+    meta?: any;
+    equal: (a: T, b: T) => boolean;
+};
+export type Thunk<T> = BaseThunk<T> & {
+    result: T;
+};
+export type Atom<T> = Ref<T> | Thunk<T>;
+export type Effect = {
+    _tag: 'effect';
+    id: string;
+    doEffect: (get: GetAtom) => void;
+    sub: Set<Atom<any>>;
+};
+export type Taggable<T extends string = string> = {
+    _tag: T;
+};
+export type ReactiveGraphOptions = {
+    effectsWrapper?: (runEffects: () => void) => void;
+    otelTracer: otel.Tracer;
+};
+export type AtomDebugInfo<TDebugThunkInfo extends Taggable> = {
+    atom: SerializedAtom;
+    resultChanged: boolean;
+    durationMs: number;
+    debugInfo: TDebugThunkInfo;
+};
+export type RefreshDebugInfo<TDebugRefreshReason extends Taggable, TDebugThunkInfo extends Taggable> = {
+    /** Currently only used for easier handling in React (e.g. as key) */
+    id: string;
+    reason: TDebugRefreshReason;
+    refreshedAtoms: AtomDebugInfo<TDebugThunkInfo>[];
+    skippedRefresh: boolean;
+    durationMs: number;
+    /** Note we're using a regular `Date.now()` timestamp here as it's faster to produce and we don't need the fine accuracy */
+    completedTimestamp: number;
+    graphSnapshot: ReactiveGraphSnapshot;
+};
+export type RefreshReasonWithGenericReasons<T extends Taggable> = T | {
+    _tag: 'makeThunk';
+    label?: string;
+} | {
+    _tag: 'makeEffect';
+    label?: string;
+} | {
+    _tag: 'unknown';
+};
+export declare const unknownRefreshReason: () => {
+    _tag: "unknown";
+};
+export type SerializedAtom = Readonly<PrettifyFlat<Pick<Atom<unknown>, '_tag' | 'height' | 'id' | 'label' | 'meta' | 'result'> & {
+    sub: string[];
+    super: string[];
+}>>;
+export type SerializedEffect = Readonly<PrettifyFlat<Pick<Effect, '_tag' | 'id'>>>;
+type ReactiveGraphSnapshot = {
+    readonly atoms: SerializedAtom[];
+    readonly effects: SerializedEffect[];
+    /** IDs of atoms and effects that are dirty */
+    readonly dirtyNodes: string[];
+};
+export declare class ReactiveGraph<TDebugRefreshReason extends Taggable, TDebugThunkInfo extends Taggable> {
+    private atoms;
+    private effects;
+    private otelTracer;
+    readonly dirtyNodes: Set<Atom<any> | Effect>;
+    effectsWrapper: (runEffects: () => void) => void;
+    debugRefreshInfos: BoundArray<RefreshDebugInfo<RefreshReasonWithGenericReasons<TDebugRefreshReason>, TDebugThunkInfo>>;
+    constructor(options: ReactiveGraphOptions);
+    makeRef<T>(val: T, options?: {
+        label?: string;
+        meta?: unknown;
+        equal?: (a: T, b: T) => boolean;
+    }): Ref<T>;
+    makeThunk<T>(getResult: (get: GetAtom, addDebugInfo: (debugInfo: TDebugThunkInfo) => void) => T, options: {
+        label?: string;
+        meta?: any;
+        equal?: (a: T, b: T) => boolean;
+        /** Debug info for initializing the thunk (i.e. running it the first time) */
+        debugRefreshReason?: RefreshReasonWithGenericReasons<TDebugRefreshReason>;
+    } | undefined, otelContext: otel.Context): Thunk<T>;
+    destroy(node: Atom<any> | Effect): void;
+    makeEffect(doEffect: (get: GetAtom) => void, options: {
+        label?: string;
+    } | undefined, otelContext: otel.Context): Effect;
+    setRef<T>(ref: Ref<T>, val: T, options: {
+        otelHint?: string;
+        skipRefresh?: boolean;
+        debugRefreshReason?: TDebugRefreshReason;
+    } | undefined, otelContext: otel.Context): void;
+    setRefs<T>(refs: [Ref<T>, T][], options: {
+        otelHint?: string;
+        skipRefresh?: boolean;
+        debugRefreshReason?: TDebugRefreshReason;
+    } | undefined, otelContext: otel.Context): void;
+    get<T>(atom: Atom<T>, context: Atom<any> | Effect): T;
+    /**
+     * Update the graph to be consistent with the current values of the root atoms.
+     * Generally we run this after a ref is updated.
+     * At the end of the refresh, we run any effects that were scheduled.
+     *
+     * @param roots Root atoms to start the refresh from
+     */
+    refresh(options: {
+        otelHint?: string;
+        debugRefreshReason?: RefreshReasonWithGenericReasons<TDebugRefreshReason>;
+    } | undefined, otelContext: otel.Context): void;
+    label(atom: Atom<any> | Effect): string;
+    addEdge(superComp: Atom<any> | Effect, subComp: Atom<any>): void;
+    removeEdge(superComp: Atom<any> | Effect, subComp: Atom<any>): void;
+    updateAtomHeight(atom: Atom<any> | Effect): void;
+    private getSnapshot;
+}
+export {};
+//# sourceMappingURL=reactive.d.ts.map

package/dist/reactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../src/reactive.ts"],"names":[],"mappings":"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"}