@livestore/livestore 0.0.10 → 0.0.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +7 -7
- package/src/__tests__/reactive.test.ts +39 -0
- package/src/react/useLiveStoreComponent.ts +4 -2
- package/src/reactive.ts +2 -1
- package/dist/.tsbuildinfo +0 -1
- package/dist/QueryCache.d.ts +0 -20
- package/dist/QueryCache.d.ts.map +0 -1
- package/dist/QueryCache.js +0 -71
- package/dist/QueryCache.js.map +0 -1
- package/dist/__tests__/react/fixture.d.ts +0 -141
- package/dist/__tests__/react/fixture.d.ts.map +0 -1
- package/dist/__tests__/react/fixture.js +0 -68
- package/dist/__tests__/react/fixture.js.map +0 -1
- package/dist/__tests__/react/useLiveStoreComponent.test.d.ts +0 -2
- package/dist/__tests__/react/useLiveStoreComponent.test.d.ts.map +0 -1
- package/dist/__tests__/react/useLiveStoreComponent.test.js +0 -78
- package/dist/__tests__/react/useLiveStoreComponent.test.js.map +0 -1
- package/dist/__tests__/reactive.test.d.ts +0 -2
- package/dist/__tests__/reactive.test.d.ts.map +0 -1
- package/dist/__tests__/reactive.test.js +0 -167
- package/dist/__tests__/reactive.test.js.map +0 -1
- package/dist/backends/base.d.ts +0 -13
- package/dist/backends/base.d.ts.map +0 -1
- package/dist/backends/base.js +0 -53
- package/dist/backends/base.js.map +0 -1
- package/dist/backends/index.d.ts +0 -45
- package/dist/backends/index.d.ts.map +0 -1
- package/dist/backends/index.js +0 -38
- package/dist/backends/index.js.map +0 -1
- package/dist/backends/noop.d.ts +0 -18
- package/dist/backends/noop.d.ts.map +0 -1
- package/dist/backends/noop.js +0 -21
- package/dist/backends/noop.js.map +0 -1
- package/dist/backends/tauri.d.ts +0 -22
- package/dist/backends/tauri.d.ts.map +0 -1
- package/dist/backends/tauri.js +0 -48
- package/dist/backends/tauri.js.map +0 -1
- package/dist/backends/utils/idb.d.ts +0 -10
- package/dist/backends/utils/idb.d.ts.map +0 -1
- package/dist/backends/utils/idb.js +0 -58
- package/dist/backends/utils/idb.js.map +0 -1
- package/dist/backends/web-in-memory.d.ts +0 -22
- package/dist/backends/web-in-memory.d.ts.map +0 -1
- package/dist/backends/web-in-memory.js +0 -45
- package/dist/backends/web-in-memory.js.map +0 -1
- package/dist/backends/web-worker.d.ts +0 -17
- package/dist/backends/web-worker.d.ts.map +0 -1
- package/dist/backends/web-worker.js +0 -139
- package/dist/backends/web-worker.js.map +0 -1
- package/dist/backends/web.d.ts +0 -27
- package/dist/backends/web.d.ts.map +0 -1
- package/dist/backends/web.js +0 -63
- package/dist/backends/web.js.map +0 -1
- package/dist/bounded-collections.d.ts +0 -34
- package/dist/bounded-collections.d.ts.map +0 -1
- package/dist/bounded-collections.js +0 -103
- package/dist/bounded-collections.js.map +0 -1
- package/dist/componentKey.d.ts +0 -20
- package/dist/componentKey.d.ts.map +0 -1
- package/dist/componentKey.js +0 -3
- package/dist/componentKey.js.map +0 -1
- package/dist/effect/LiveStore.d.ts +0 -42
- package/dist/effect/LiveStore.d.ts.map +0 -1
- package/dist/effect/LiveStore.js +0 -40
- package/dist/effect/LiveStore.js.map +0 -1
- package/dist/effect/index.d.ts +0 -2
- package/dist/effect/index.d.ts.map +0 -1
- package/dist/effect/index.js +0 -2
- package/dist/effect/index.js.map +0 -1
- package/dist/events.d.ts +0 -7
- package/dist/events.d.ts.map +0 -1
- package/dist/events.js +0 -2
- package/dist/events.js.map +0 -1
- package/dist/inMemoryDatabase.d.ts +0 -65
- package/dist/inMemoryDatabase.d.ts.map +0 -1
- package/dist/inMemoryDatabase.js +0 -241
- package/dist/inMemoryDatabase.js.map +0 -1
- package/dist/index.d.ts +0 -20
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js +0 -10
- package/dist/index.js.map +0 -1
- package/dist/otel.d.ts +0 -5
- package/dist/otel.d.ts.map +0 -1
- package/dist/otel.js +0 -17
- package/dist/otel.js.map +0 -1
- package/dist/react/LiveStoreContext.d.ts +0 -11
- package/dist/react/LiveStoreContext.d.ts.map +0 -1
- package/dist/react/LiveStoreContext.js +0 -10
- package/dist/react/LiveStoreContext.js.map +0 -1
- package/dist/react/LiveStoreProvider.d.ts +0 -21
- package/dist/react/LiveStoreProvider.d.ts.map +0 -1
- package/dist/react/LiveStoreProvider.js +0 -48
- package/dist/react/LiveStoreProvider.js.map +0 -1
- package/dist/react/index.d.ts +0 -7
- package/dist/react/index.d.ts.map +0 -1
- package/dist/react/index.js +0 -6
- package/dist/react/index.js.map +0 -1
- package/dist/react/useGlobalQuery.d.ts +0 -3
- package/dist/react/useGlobalQuery.d.ts.map +0 -1
- package/dist/react/useGlobalQuery.js +0 -25
- package/dist/react/useGlobalQuery.js.map +0 -1
- package/dist/react/useGraphQL.d.ts +0 -11
- package/dist/react/useGraphQL.d.ts.map +0 -1
- package/dist/react/useGraphQL.js +0 -67
- package/dist/react/useGraphQL.js.map +0 -1
- package/dist/react/useLiveStoreComponent.d.ts +0 -70
- package/dist/react/useLiveStoreComponent.d.ts.map +0 -1
- package/dist/react/useLiveStoreComponent.js +0 -272
- package/dist/react/useLiveStoreComponent.js.map +0 -1
- package/dist/react/utils/useStateRefWithReactiveInput.d.ts +0 -13
- package/dist/react/utils/useStateRefWithReactiveInput.d.ts.map +0 -1
- package/dist/react/utils/useStateRefWithReactiveInput.js +0 -38
- package/dist/react/utils/useStateRefWithReactiveInput.js.map +0 -1
- package/dist/reactive.d.ts +0 -140
- package/dist/reactive.d.ts.map +0 -1
- package/dist/reactive.js +0 -301
- package/dist/reactive.js.map +0 -1
- package/dist/reactiveQueries/base-class.d.ts +0 -24
- package/dist/reactiveQueries/base-class.d.ts.map +0 -1
- package/dist/reactiveQueries/base-class.js +0 -22
- package/dist/reactiveQueries/base-class.js.map +0 -1
- package/dist/reactiveQueries/graphql.d.ts +0 -25
- package/dist/reactiveQueries/graphql.d.ts.map +0 -1
- package/dist/reactiveQueries/graphql.js +0 -18
- package/dist/reactiveQueries/graphql.js.map +0 -1
- package/dist/reactiveQueries/js.d.ts +0 -19
- package/dist/reactiveQueries/js.d.ts.map +0 -1
- package/dist/reactiveQueries/js.js +0 -13
- package/dist/reactiveQueries/js.js.map +0 -1
- package/dist/reactiveQueries/sql.d.ts +0 -31
- package/dist/reactiveQueries/sql.d.ts.map +0 -1
- package/dist/reactiveQueries/sql.js +0 -32
- package/dist/reactiveQueries/sql.js.map +0 -1
- package/dist/schema.d.ts +0 -163
- package/dist/schema.d.ts.map +0 -1
- package/dist/schema.js +0 -92
- package/dist/schema.js.map +0 -1
- package/dist/store.d.ts +0 -192
- package/dist/store.d.ts.map +0 -1
- package/dist/store.js +0 -539
- package/dist/store.js.map +0 -1
- package/dist/util.d.ts +0 -24
- package/dist/util.d.ts.map +0 -1
- package/dist/util.js +0 -51
- package/dist/util.js.map +0 -1
|
@@ -1,70 +0,0 @@
|
|
|
1
|
-
import type { TypedDocumentNode as DocumentNode } from '@graphql-typed-document-node/core';
|
|
2
|
-
import { type LiteralUnion } from '@livestore/utils';
|
|
3
|
-
import type { DependencyList } from 'react';
|
|
4
|
-
import React from 'react';
|
|
5
|
-
import type { ComponentKey } from '../componentKey.js';
|
|
6
|
-
import type { GetAtom } from '../reactive.js';
|
|
7
|
-
import type { LiveStoreGraphQLQuery } from '../reactiveQueries/graphql.js';
|
|
8
|
-
import type { LiveStoreJSQuery } from '../reactiveQueries/js.js';
|
|
9
|
-
import type { LiveStoreSQLQuery } from '../reactiveQueries/sql.js';
|
|
10
|
-
import type { ComponentStateSchema } from '../schema.js';
|
|
11
|
-
import type { BaseGraphQLContext, LiveStoreQuery, QueryResult } from '../store.js';
|
|
12
|
-
export interface QueryDefinitions {
|
|
13
|
-
[queryName: string]: LiveStoreQuery;
|
|
14
|
-
}
|
|
15
|
-
export type QueryResults<TQuery> = {
|
|
16
|
-
[queryName in keyof TQuery]: QueryResult<TQuery[queryName]>;
|
|
17
|
-
};
|
|
18
|
-
export type ReactiveSQL = <TResult>(genQuery: (get: GetAtom) => string, queriedTables: string[]) => LiveStoreSQLQuery<TResult>;
|
|
19
|
-
export type ReactiveGraphQL = <TResult extends Record<string, any>, TVariables extends Record<string, any>, TContext extends BaseGraphQLContext>(query: DocumentNode<TResult, TVariables>, genVariableValues: (get: GetAtom) => TVariables, label?: string) => LiveStoreGraphQLQuery<TResult, TVariables, TContext>;
|
|
20
|
-
type RegisterSubscription = <TQuery extends LiveStoreQuery>(query: TQuery, onNewValue: (value: QueryResult<TQuery>) => void, onUnsubscribe?: () => void) => void;
|
|
21
|
-
type GenQueries<TQueries, TStateResult> = (args: {
|
|
22
|
-
rxSQL: ReactiveSQL;
|
|
23
|
-
rxGraphQL: ReactiveGraphQL;
|
|
24
|
-
globalQueries: QueryDefinitions;
|
|
25
|
-
state$: LiveStoreJSQuery<TStateResult>;
|
|
26
|
-
/** Registers a subscription */
|
|
27
|
-
subscribe: RegisterSubscription;
|
|
28
|
-
isTemporaryQuery: boolean;
|
|
29
|
-
}) => TQueries;
|
|
30
|
-
export type UseLiveStoreComponentProps<TQueries, TComponentState> = {
|
|
31
|
-
stateSchema?: ComponentStateSchema<TComponentState>;
|
|
32
|
-
queries?: GenQueries<TQueries, TComponentState>;
|
|
33
|
-
reactDeps?: React.DependencyList;
|
|
34
|
-
componentKey: ComponentKeyConfig;
|
|
35
|
-
};
|
|
36
|
-
export type ComponentKeyConfig = {
|
|
37
|
-
/**
|
|
38
|
-
* Name of the Component
|
|
39
|
-
*
|
|
40
|
-
* TODO we should eventually derive this info automatically from the component (TBD how though...)
|
|
41
|
-
*/
|
|
42
|
-
name: string;
|
|
43
|
-
id: LiteralUnion<'singleton' | '__ephemeral__', string>;
|
|
44
|
-
};
|
|
45
|
-
type ComponentState = {
|
|
46
|
-
/** Equivalent to `componentKey.key` */
|
|
47
|
-
id: string;
|
|
48
|
-
[key: string]: string | number | boolean | null;
|
|
49
|
-
};
|
|
50
|
-
type UseLiveStoreJsonState<TState> = <TResult>(jsonStringKey: keyof TState, parse?: (_: unknown) => TResult) => [value: TResult, setValue: (newVal: TResult | ((prevVal: TResult) => TResult)) => void];
|
|
51
|
-
/**
|
|
52
|
-
* Create reactive queries within a component.
|
|
53
|
-
* @param config.queries A function that returns a map of named reactive queries.
|
|
54
|
-
* @param config.componentKey A function that returns a unique key for this component.
|
|
55
|
-
* @param config.reactDeps A list of React-level dependencies that will refresh the queries.
|
|
56
|
-
*/
|
|
57
|
-
export declare const useLiveStoreComponent: <TComponentState extends ComponentState, TQueries extends QueryDefinitions>({ stateSchema: stateSchema_, queries, componentKey: componentKeyConfig, reactDeps, }: UseLiveStoreComponentProps<TQueries, TComponentState>) => {
|
|
58
|
-
queryResults: QueryResults<TQueries>;
|
|
59
|
-
state: TComponentState;
|
|
60
|
-
setState: Setters<TComponentState>;
|
|
61
|
-
useLiveStoreJsonState: UseLiveStoreJsonState<TComponentState>;
|
|
62
|
-
};
|
|
63
|
-
export type Setters<TComponentState> = {
|
|
64
|
-
[k in keyof TComponentState]: (newValue: TComponentState[k]) => void;
|
|
65
|
-
} & {
|
|
66
|
-
setMany: (newValues: Partial<TComponentState>) => void;
|
|
67
|
-
};
|
|
68
|
-
export declare const useComponentKey: ({ name, id }: ComponentKeyConfig, deps?: DependencyList) => ComponentKey;
|
|
69
|
-
export {};
|
|
70
|
-
//# sourceMappingURL=useLiveStoreComponent.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"useLiveStoreComponent.d.ts","sourceRoot":"","sources":["../../src/react/useLiveStoreComponent.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,272 +0,0 @@
|
|
|
1
|
-
import { omit, shouldNeverHappen } from '@livestore/utils';
|
|
2
|
-
import * as otel from '@opentelemetry/api';
|
|
3
|
-
import { isEqual, mapValues } from 'lodash-es';
|
|
4
|
-
import React from 'react';
|
|
5
|
-
import { v4 as uuid } from 'uuid';
|
|
6
|
-
import { labelForKey, tableNameForComponentKey } from '../componentKey.js';
|
|
7
|
-
import { sql } from '../util.js';
|
|
8
|
-
import { useStore } from './LiveStoreContext.js';
|
|
9
|
-
import { useStateRefWithReactiveInput } from './utils/useStateRefWithReactiveInput.js';
|
|
10
|
-
/**
|
|
11
|
-
* This is needed because the `React.useMemo` call below, can sometimes be called multiple times 🤷,
|
|
12
|
-
* so we need to "cache" the fact that we've already started a span for this component.
|
|
13
|
-
* The map entry is being removed again in the `React.useEffect` call below.
|
|
14
|
-
*/
|
|
15
|
-
const spanAlreadyStartedCache = new Map();
|
|
16
|
-
/**
|
|
17
|
-
* Create reactive queries within a component.
|
|
18
|
-
* @param config.queries A function that returns a map of named reactive queries.
|
|
19
|
-
* @param config.componentKey A function that returns a unique key for this component.
|
|
20
|
-
* @param config.reactDeps A list of React-level dependencies that will refresh the queries.
|
|
21
|
-
*/
|
|
22
|
-
export const useLiveStoreComponent = ({ stateSchema: stateSchema_, queries = () => ({}), componentKey: componentKeyConfig, reactDeps = [], }) => {
|
|
23
|
-
// TODO we should clean up the state schema handling to remove this special handling for the `id` column
|
|
24
|
-
const stateSchema = React.useMemo(() => (stateSchema_ ? { ...stateSchema_, columns: omit(stateSchema_.columns, 'id') } : undefined), [stateSchema_]);
|
|
25
|
-
// performance.mark('useLiveStoreComponent:start')
|
|
26
|
-
const componentKey = useComponentKey(componentKeyConfig, reactDeps);
|
|
27
|
-
const { store, globalQueries } = useStore();
|
|
28
|
-
const componentKeyLabel = React.useMemo(() => labelForKey(componentKey), [componentKey]);
|
|
29
|
-
// The following `React.useMemo` and `React.useEffect` calls are used to start and end a span for the lifetime of this component.
|
|
30
|
-
const { span, otelContext } = React.useMemo(() => {
|
|
31
|
-
const existingSpan = spanAlreadyStartedCache.get(componentKeyLabel);
|
|
32
|
-
if (existingSpan !== undefined)
|
|
33
|
-
return existingSpan;
|
|
34
|
-
const span = store.otel.tracer.startSpan(`LiveStore:useLiveStoreComponent:${componentKeyLabel}`, {}, store.otel.queriesSpanContext);
|
|
35
|
-
const otelContext = otel.trace.setSpan(otel.context.active(), span);
|
|
36
|
-
spanAlreadyStartedCache.set(componentKeyLabel, { span, otelContext });
|
|
37
|
-
return { span, otelContext };
|
|
38
|
-
}, [componentKeyLabel, store.otel.queriesSpanContext, store.otel.tracer]);
|
|
39
|
-
React.useEffect(() => () => {
|
|
40
|
-
spanAlreadyStartedCache.delete(componentKeyLabel);
|
|
41
|
-
span.end();
|
|
42
|
-
}, [componentKeyLabel, span]);
|
|
43
|
-
const generateQueries = React.useCallback(({ state$, otelContext, registerSubscription, isTemporaryQuery, }) => queries({
|
|
44
|
-
rxSQL: (genQuery, queriedTables) => store.querySQL(genQuery, { queriedTables, otelContext }),
|
|
45
|
-
rxGraphQL: (query, genVariableValues, label) => store.queryGraphQL(query, genVariableValues, { componentKey, label, otelContext }),
|
|
46
|
-
globalQueries,
|
|
47
|
-
state$,
|
|
48
|
-
subscribe: registerSubscription,
|
|
49
|
-
isTemporaryQuery,
|
|
50
|
-
}),
|
|
51
|
-
// NOTE: we don't include the queries function passed in by the user here;
|
|
52
|
-
// the reason is that we don't want to force them to memoize that function.
|
|
53
|
-
// Instead, we just assume that the function always has the same contents.
|
|
54
|
-
// This makes sense for LiveStore because the component config should be static.
|
|
55
|
-
// TODO: document this and consider whether it's the right API surface.
|
|
56
|
-
// eslint-disable-next-line react-hooks/exhaustive-deps
|
|
57
|
-
[store, componentKey, globalQueries]);
|
|
58
|
-
const defaultComponentState = React.useMemo(() => {
|
|
59
|
-
const defaultState = (stateSchema === undefined ? {} : mapValues(stateSchema.columns, (c) => c.default));
|
|
60
|
-
defaultState.id = componentKeyConfig.id;
|
|
61
|
-
return defaultState;
|
|
62
|
-
}, [componentKeyConfig.id, stateSchema]);
|
|
63
|
-
// Step 1:
|
|
64
|
-
// Synchronously create state and queries for initial render pass.
|
|
65
|
-
// We do this in a temporary query context which cleans up after itself, making it idempotent
|
|
66
|
-
// TODO get rid of the temporary query workaround
|
|
67
|
-
const { initialComponentState, initialQueryResults } = React.useMemo(() => {
|
|
68
|
-
return store.otel.tracer.startActiveSpan('LiveStore:useLiveStoreComponent:initial', {}, otelContext, (span) => {
|
|
69
|
-
const otelContext = otel.trace.setSpan(otel.context.active(), span);
|
|
70
|
-
return store.inTempQueryContext(() => {
|
|
71
|
-
try {
|
|
72
|
-
// create state query
|
|
73
|
-
let stateQuery;
|
|
74
|
-
if (stateSchema === undefined) {
|
|
75
|
-
// TODO don't set up a query if there's no state schema (keeps the graph more clean)
|
|
76
|
-
stateQuery = store.queryJS(() => ({}), {
|
|
77
|
-
componentKey,
|
|
78
|
-
otelContext,
|
|
79
|
-
});
|
|
80
|
-
}
|
|
81
|
-
else {
|
|
82
|
-
const componentTableName = tableNameForComponentKey(componentKey);
|
|
83
|
-
const whereClause = componentKey._tag === 'singleton' ? '' : `where id = '${componentKey.id}'`;
|
|
84
|
-
stateQuery = store
|
|
85
|
-
.querySQL(() => sql `select * from ${componentTableName} ${whereClause} limit 1`, {
|
|
86
|
-
queriedTables: [componentTableName],
|
|
87
|
-
componentKey,
|
|
88
|
-
label: `localState:query:${componentKeyLabel}`,
|
|
89
|
-
otelContext,
|
|
90
|
-
})
|
|
91
|
-
.getFirstRow({ defaultValue: defaultComponentState });
|
|
92
|
-
}
|
|
93
|
-
const initialComponentState = stateQuery.results$.result;
|
|
94
|
-
const queries = generateQueries({
|
|
95
|
-
state$: stateQuery,
|
|
96
|
-
otelContext,
|
|
97
|
-
registerSubscription: () => { },
|
|
98
|
-
isTemporaryQuery: true,
|
|
99
|
-
});
|
|
100
|
-
for (const [name, query] of Object.entries(queries)) {
|
|
101
|
-
query.label = name;
|
|
102
|
-
}
|
|
103
|
-
const initialQueryResults = mapValues(queries, (query) => query.results$.result);
|
|
104
|
-
return { initialComponentState, initialQueryResults };
|
|
105
|
-
}
|
|
106
|
-
finally {
|
|
107
|
-
span.end();
|
|
108
|
-
}
|
|
109
|
-
});
|
|
110
|
-
});
|
|
111
|
-
}, [store, otelContext, stateSchema, generateQueries, componentKey, componentKeyLabel, defaultComponentState]);
|
|
112
|
-
// Now that we've computed the initial state synchronously,
|
|
113
|
-
// we can set up our useState calls w/ a default value populated...
|
|
114
|
-
const [componentStateRef, setComponentState_] = useStateRefWithReactiveInput(initialComponentState);
|
|
115
|
-
const [queryResultsRef, setQueryResults_] = useStateRefWithReactiveInput(initialQueryResults);
|
|
116
|
-
const setState = (stateSchema === undefined
|
|
117
|
-
? {}
|
|
118
|
-
: // TODO: do we have a better type for the values that can go in SQLite?
|
|
119
|
-
mapValues(stateSchema.columns, (_, columnName) => (value) => {
|
|
120
|
-
// Don't update the state if it's the same as the value already seen in the component
|
|
121
|
-
if (componentStateRef.current[columnName] === value)
|
|
122
|
-
return;
|
|
123
|
-
if (['componentKey', 'columnNames'].includes(columnName)) {
|
|
124
|
-
shouldNeverHappen(`Can't use reserved column name ${columnName}`);
|
|
125
|
-
}
|
|
126
|
-
return store.applyEvent('updateComponentState', {
|
|
127
|
-
componentKey,
|
|
128
|
-
columnNames: [columnName],
|
|
129
|
-
[columnName]: value,
|
|
130
|
-
});
|
|
131
|
-
}));
|
|
132
|
-
setState.setMany = (columnValues) => {
|
|
133
|
-
// TODO use hashing instead
|
|
134
|
-
// Don't update the state if it's the same as the value already seen in the component
|
|
135
|
-
if (Object.entries(columnValues).every(([columnName, value]) => componentStateRef.current[columnName] === value)) {
|
|
136
|
-
return;
|
|
137
|
-
}
|
|
138
|
-
const columnNames = Object.keys(columnValues);
|
|
139
|
-
return store.applyEvent('updateComponentState', { componentKey, columnNames, ...columnValues });
|
|
140
|
-
};
|
|
141
|
-
// OK, now all the synchronous work is done;
|
|
142
|
-
// time to set up our long-running queries in an effect
|
|
143
|
-
React.useEffect(() => {
|
|
144
|
-
return store.otel.tracer.startActiveSpan('LiveStore:useLiveStoreComponent:long-running', { attributes: {} }, otelContext, (span) => {
|
|
145
|
-
const otelContext = otel.trace.setSpan(otel.context.active(), span);
|
|
146
|
-
const unsubs = [];
|
|
147
|
-
// create state query
|
|
148
|
-
let state$;
|
|
149
|
-
if (stateSchema === undefined) {
|
|
150
|
-
state$ = store.queryJS(() => ({}), { componentKey, otelContext });
|
|
151
|
-
}
|
|
152
|
-
else {
|
|
153
|
-
const componentTableName = tableNameForComponentKey(componentKey);
|
|
154
|
-
insertRowForComponentInstance({ store, componentKey, stateSchema });
|
|
155
|
-
const whereClause = componentKey._tag === 'singleton' ? '' : `where id = '${componentKey.id}'`;
|
|
156
|
-
state$ = store
|
|
157
|
-
.querySQL(() => sql `select * from ${componentTableName} ${whereClause} limit 1`, {
|
|
158
|
-
queriedTables: [componentTableName],
|
|
159
|
-
componentKey,
|
|
160
|
-
label: `localState:query:${componentKeyLabel}`,
|
|
161
|
-
otelContext,
|
|
162
|
-
})
|
|
163
|
-
.getFirstRow({ defaultValue: defaultComponentState });
|
|
164
|
-
}
|
|
165
|
-
unsubs.push(store.subscribe(state$, (results) => {
|
|
166
|
-
if (isEqual(results, componentStateRef.current) === false) {
|
|
167
|
-
setComponentState_(results);
|
|
168
|
-
}
|
|
169
|
-
}, undefined, { label: `useLiveStoreComponent:localState:subscribe:${state$.label}` }));
|
|
170
|
-
const registerSubscription = (query, callback, onUnsubscribe) => {
|
|
171
|
-
unsubs.push(store.subscribe(query, (results) => {
|
|
172
|
-
callback(results);
|
|
173
|
-
}, onUnsubscribe, { label: `useLiveStoreComponent:query:manual-subscribe:${query.label}` }));
|
|
174
|
-
};
|
|
175
|
-
const queries = generateQueries({ state$, otelContext, registerSubscription, isTemporaryQuery: false });
|
|
176
|
-
// Use the name given to this query in the useQueries hook as its label
|
|
177
|
-
for (const [name, query] of Object.entries(queries)) {
|
|
178
|
-
query.label = name;
|
|
179
|
-
}
|
|
180
|
-
for (const [key, query] of Object.entries(queries)) {
|
|
181
|
-
unsubs.push(store.subscribe(query, (results) => {
|
|
182
|
-
const newQueryResults = { ...queryResultsRef.current, [key]: results };
|
|
183
|
-
if (isEqual(newQueryResults, queryResultsRef.current) === false) {
|
|
184
|
-
setQueryResults_(newQueryResults);
|
|
185
|
-
}
|
|
186
|
-
}, undefined, { label: `useLiveStoreComponent:query:subscribe:${query.label}` }));
|
|
187
|
-
}
|
|
188
|
-
return () => {
|
|
189
|
-
for (const unsub of unsubs) {
|
|
190
|
-
unsub();
|
|
191
|
-
}
|
|
192
|
-
span.end();
|
|
193
|
-
};
|
|
194
|
-
});
|
|
195
|
-
// NOTE excluding `setComponentState_` and `setQueryResults_` from the deps array as it seems to cause an infinite loop
|
|
196
|
-
// This should probably be improved
|
|
197
|
-
// eslint-disable-next-line react-hooks/exhaustive-deps
|
|
198
|
-
}, [
|
|
199
|
-
store,
|
|
200
|
-
componentKey,
|
|
201
|
-
stateSchema,
|
|
202
|
-
defaultComponentState,
|
|
203
|
-
generateQueries,
|
|
204
|
-
otelContext,
|
|
205
|
-
componentStateRef,
|
|
206
|
-
// setComponentState_,
|
|
207
|
-
// setQueryResults_,
|
|
208
|
-
]);
|
|
209
|
-
// Very important: remove any queries / other resources associated w/ this component
|
|
210
|
-
React.useEffect(() => () => store.unmountComponent(componentKey), [store, componentKey]);
|
|
211
|
-
// performance.mark('useLiveStoreComponent:end')
|
|
212
|
-
// performance.measure(`useLiveStoreComponent:${componentKey.type}`, 'useLiveStoreComponent:start', 'useLiveStoreComponent:end')
|
|
213
|
-
const state = componentStateRef.current;
|
|
214
|
-
const useLiveStoreJsonState = (jsonStringKey, parse = (_) => _) => {
|
|
215
|
-
const value = React.useMemo(() => {
|
|
216
|
-
return parse(JSON.parse(state[jsonStringKey]));
|
|
217
|
-
// eslint-disable-next-line react-hooks/exhaustive-deps
|
|
218
|
-
}, [state[jsonStringKey], parse]);
|
|
219
|
-
const setValue = React.useCallback((newValOrFn) => {
|
|
220
|
-
const newVal = typeof newValOrFn === 'function'
|
|
221
|
-
? // NOTE we're using the ref instead of the value because we want to be sure
|
|
222
|
-
// we're using the latest value when the setter is called
|
|
223
|
-
newValOrFn(parse(JSON.parse(componentStateRef.current[jsonStringKey])))
|
|
224
|
-
: newValOrFn;
|
|
225
|
-
setState[jsonStringKey](JSON.stringify(newVal));
|
|
226
|
-
}, [parse, jsonStringKey]);
|
|
227
|
-
return [value, setValue];
|
|
228
|
-
};
|
|
229
|
-
return {
|
|
230
|
-
queryResults: queryResultsRef.current,
|
|
231
|
-
state,
|
|
232
|
-
setState,
|
|
233
|
-
useLiveStoreJsonState,
|
|
234
|
-
};
|
|
235
|
-
};
|
|
236
|
-
export const useComponentKey = ({ name, id }, deps = []) => React.useMemo(() => {
|
|
237
|
-
switch (id) {
|
|
238
|
-
case 'singleton': {
|
|
239
|
-
return { _tag: 'singleton', componentName: name, id: 'singleton' };
|
|
240
|
-
}
|
|
241
|
-
case '__ephemeral__': {
|
|
242
|
-
return { _tag: 'ephemeral', componentName: name, id: uuid() };
|
|
243
|
-
}
|
|
244
|
-
default: {
|
|
245
|
-
return { _tag: 'custom', componentName: name, id };
|
|
246
|
-
}
|
|
247
|
-
}
|
|
248
|
-
// eslint-disable-next-line react-hooks/exhaustive-deps
|
|
249
|
-
}, [...deps, id, name]);
|
|
250
|
-
/**
|
|
251
|
-
* Create a row storing the state for a component instance, if none exists yet.
|
|
252
|
-
* Initialized with default values, and keyed on the component key.
|
|
253
|
-
*/
|
|
254
|
-
const insertRowForComponentInstance = ({ store, componentKey, stateSchema, }) => {
|
|
255
|
-
const columnNames = ['id', ...Object.keys(stateSchema.columns)];
|
|
256
|
-
const columnValues = columnNames.map((name) => `$${name}`).join(', ');
|
|
257
|
-
const tableName = tableNameForComponentKey(componentKey);
|
|
258
|
-
const insertQuery = sql `insert into ${tableName} (${columnNames.join(', ')}) select ${columnValues} where not exists(select 1 from ${tableName} where id = '${componentKey.id}')`;
|
|
259
|
-
void store.execute(insertQuery, {
|
|
260
|
-
id: componentKey.id,
|
|
261
|
-
...mapValues(stateSchema.columns, (column) => prepareValueForSql(column.default ?? null)),
|
|
262
|
-
}, [tableName]);
|
|
263
|
-
};
|
|
264
|
-
const prepareValueForSql = (value) => {
|
|
265
|
-
if (typeof value === 'string' || typeof value === 'number' || value === null) {
|
|
266
|
-
return value;
|
|
267
|
-
}
|
|
268
|
-
else {
|
|
269
|
-
return value ? 1 : 0;
|
|
270
|
-
}
|
|
271
|
-
};
|
|
272
|
-
//# sourceMappingURL=useLiveStoreComponent.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"useLiveStoreComponent.js","sourceRoot":"","sources":["../../src/react/useLiveStoreComponent.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
import React from 'react';
|
|
2
|
-
/**
|
|
3
|
-
* A variant of `React.useState` which allows the `inputState` to change over time as well.
|
|
4
|
-
* Important: This hook is synchronous / single-render-pass (i.e. doesn't use `useEffect` or `setState` directly).
|
|
5
|
-
*
|
|
6
|
-
* Notes:
|
|
7
|
-
* - 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)
|
|
8
|
-
* - This hook might not work properly with React Suspense
|
|
9
|
-
* - Also see this Tweet for more potential problems: https://twitter.com/schickling/status/1677317711104278528
|
|
10
|
-
*
|
|
11
|
-
*/
|
|
12
|
-
export declare const useStateRefWithReactiveInput: <T>(inputState: T) => [React.MutableRefObject<T>, (newState: T | ((prev: T) => T)) => void];
|
|
13
|
-
//# sourceMappingURL=useStateRefWithReactiveInput.d.ts.map
|
|
@@ -1 +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"}
|
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
import React from 'react';
|
|
2
|
-
/**
|
|
3
|
-
* A variant of `React.useState` which allows the `inputState` to change over time as well.
|
|
4
|
-
* Important: This hook is synchronous / single-render-pass (i.e. doesn't use `useEffect` or `setState` directly).
|
|
5
|
-
*
|
|
6
|
-
* Notes:
|
|
7
|
-
* - 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)
|
|
8
|
-
* - This hook might not work properly with React Suspense
|
|
9
|
-
* - Also see this Tweet for more potential problems: https://twitter.com/schickling/status/1677317711104278528
|
|
10
|
-
*
|
|
11
|
-
*/
|
|
12
|
-
export const useStateRefWithReactiveInput = (inputState) => {
|
|
13
|
-
const [_, rerender] = React.useState(0);
|
|
14
|
-
const lastKnownInputStateRef = React.useRef(inputState);
|
|
15
|
-
const stateRef = React.useRef(inputState);
|
|
16
|
-
if (lastKnownInputStateRef.current !== inputState) {
|
|
17
|
-
lastKnownInputStateRef.current = inputState;
|
|
18
|
-
// NOTE we don't need to re-render here, because the component is already re-rendering due to the `inputState` change
|
|
19
|
-
stateRef.current = inputState;
|
|
20
|
-
}
|
|
21
|
-
const setStateAndRerender = React.useCallback((newState) => {
|
|
22
|
-
// @ts-expect-error https://github.com/microsoft/TypeScript/issues/37663
|
|
23
|
-
const val = typeof newState === 'function' ? newState(stateRef.current) : newState;
|
|
24
|
-
stateRef.current = val;
|
|
25
|
-
rerender((c) => c + 1);
|
|
26
|
-
}, [rerender]);
|
|
27
|
-
return [stateRef, setStateAndRerender];
|
|
28
|
-
};
|
|
29
|
-
// Down-side of this implementation: Double render pass due to `setState` call (which forces a re-render)
|
|
30
|
-
// Keeping around for now in case `useStateRefWithReactiveInput` doesn't work out
|
|
31
|
-
// const _useStateWithReactiveInput = <T>(inputState: T): [T, (newState: T | ((prev: T) => T)) => void] => {
|
|
32
|
-
// const [externalState, setExternalState] = React.useState(inputState)
|
|
33
|
-
// if (externalState !== inputState) {
|
|
34
|
-
// setExternalState(inputState)
|
|
35
|
-
// }
|
|
36
|
-
// return [externalState, setExternalState]
|
|
37
|
-
// }
|
|
38
|
-
//# sourceMappingURL=useStateRefWithReactiveInput.js.map
|
|
@@ -1 +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
DELETED
|
@@ -1,140 +0,0 @@
|
|
|
1
|
-
import type { PrettifyFlat } from '@livestore/utils';
|
|
2
|
-
import type * as otel from '@opentelemetry/api';
|
|
3
|
-
import { BoundArray } from './bounded-collections.js';
|
|
4
|
-
export type GetAtom = <T>(atom: Atom<T>) => T;
|
|
5
|
-
export type Ref<T> = {
|
|
6
|
-
_tag: 'ref';
|
|
7
|
-
id: string;
|
|
8
|
-
result: T;
|
|
9
|
-
height: 0;
|
|
10
|
-
getResult: () => T;
|
|
11
|
-
sub: Set<Atom<any>>;
|
|
12
|
-
super: Set<Atom<any> | Effect>;
|
|
13
|
-
label?: string;
|
|
14
|
-
/** Container for meta information (e.g. the LiveStore Store) */
|
|
15
|
-
meta?: any;
|
|
16
|
-
equal: (a: T, b: T) => boolean;
|
|
17
|
-
};
|
|
18
|
-
type BaseThunk<T> = {
|
|
19
|
-
_tag: 'thunk';
|
|
20
|
-
id: string;
|
|
21
|
-
height: number;
|
|
22
|
-
getResult: (get: GetAtom, addDebugInfo: (debugInfo: any) => void) => T;
|
|
23
|
-
sub: Set<Atom<any>>;
|
|
24
|
-
super: Set<Atom<any> | Effect>;
|
|
25
|
-
label?: string;
|
|
26
|
-
/** Container for meta information (e.g. the LiveStore Store) */
|
|
27
|
-
meta?: any;
|
|
28
|
-
equal: (a: T, b: T) => boolean;
|
|
29
|
-
};
|
|
30
|
-
export type Thunk<T> = BaseThunk<T> & {
|
|
31
|
-
result: T;
|
|
32
|
-
};
|
|
33
|
-
export type Atom<T> = Ref<T> | Thunk<T>;
|
|
34
|
-
export type Effect = {
|
|
35
|
-
_tag: 'effect';
|
|
36
|
-
id: string;
|
|
37
|
-
doEffect: (get: GetAtom) => void;
|
|
38
|
-
sub: Set<Atom<any>>;
|
|
39
|
-
};
|
|
40
|
-
export type Taggable<T extends string = string> = {
|
|
41
|
-
_tag: T;
|
|
42
|
-
};
|
|
43
|
-
export type ReactiveGraphOptions = {
|
|
44
|
-
effectsWrapper?: (runEffects: () => void) => void;
|
|
45
|
-
otelTracer: otel.Tracer;
|
|
46
|
-
};
|
|
47
|
-
export type AtomDebugInfo<TDebugThunkInfo extends Taggable> = {
|
|
48
|
-
atom: SerializedAtom;
|
|
49
|
-
resultChanged: boolean;
|
|
50
|
-
durationMs: number;
|
|
51
|
-
debugInfo: TDebugThunkInfo;
|
|
52
|
-
};
|
|
53
|
-
export type RefreshDebugInfo<TDebugRefreshReason extends Taggable, TDebugThunkInfo extends Taggable> = {
|
|
54
|
-
/** Currently only used for easier handling in React (e.g. as key) */
|
|
55
|
-
id: string;
|
|
56
|
-
reason: TDebugRefreshReason;
|
|
57
|
-
refreshedAtoms: AtomDebugInfo<TDebugThunkInfo>[];
|
|
58
|
-
skippedRefresh: boolean;
|
|
59
|
-
durationMs: number;
|
|
60
|
-
/** Note we're using a regular `Date.now()` timestamp here as it's faster to produce and we don't need the fine accuracy */
|
|
61
|
-
completedTimestamp: number;
|
|
62
|
-
graphSnapshot: ReactiveGraphSnapshot;
|
|
63
|
-
};
|
|
64
|
-
export type RefreshReasonWithGenericReasons<T extends Taggable> = T | {
|
|
65
|
-
_tag: 'makeThunk';
|
|
66
|
-
label?: string;
|
|
67
|
-
} | {
|
|
68
|
-
_tag: 'makeEffect';
|
|
69
|
-
label?: string;
|
|
70
|
-
} | {
|
|
71
|
-
_tag: 'unknown';
|
|
72
|
-
};
|
|
73
|
-
export declare const unknownRefreshReason: () => {
|
|
74
|
-
_tag: "unknown";
|
|
75
|
-
};
|
|
76
|
-
export type SerializedAtom = Readonly<PrettifyFlat<Pick<Atom<unknown>, '_tag' | 'height' | 'id' | 'label' | 'meta' | 'result'> & {
|
|
77
|
-
sub: string[];
|
|
78
|
-
super: string[];
|
|
79
|
-
}>>;
|
|
80
|
-
export type SerializedEffect = Readonly<PrettifyFlat<Pick<Effect, '_tag' | 'id'>>>;
|
|
81
|
-
type ReactiveGraphSnapshot = {
|
|
82
|
-
readonly atoms: SerializedAtom[];
|
|
83
|
-
readonly effects: SerializedEffect[];
|
|
84
|
-
/** IDs of atoms and effects that are dirty */
|
|
85
|
-
readonly dirtyNodes: string[];
|
|
86
|
-
};
|
|
87
|
-
export declare class ReactiveGraph<TDebugRefreshReason extends Taggable, TDebugThunkInfo extends Taggable> {
|
|
88
|
-
private atoms;
|
|
89
|
-
private effects;
|
|
90
|
-
private otelTracer;
|
|
91
|
-
readonly dirtyNodes: Set<Atom<any> | Effect>;
|
|
92
|
-
effectsWrapper: (runEffects: () => void) => void;
|
|
93
|
-
debugRefreshInfos: BoundArray<RefreshDebugInfo<RefreshReasonWithGenericReasons<TDebugRefreshReason>, TDebugThunkInfo>>;
|
|
94
|
-
constructor(options: ReactiveGraphOptions);
|
|
95
|
-
makeRef<T>(val: T, options?: {
|
|
96
|
-
label?: string;
|
|
97
|
-
meta?: unknown;
|
|
98
|
-
equal?: (a: T, b: T) => boolean;
|
|
99
|
-
}): Ref<T>;
|
|
100
|
-
makeThunk<T>(getResult: (get: GetAtom, addDebugInfo: (debugInfo: TDebugThunkInfo) => void) => T, options: {
|
|
101
|
-
label?: string;
|
|
102
|
-
meta?: any;
|
|
103
|
-
equal?: (a: T, b: T) => boolean;
|
|
104
|
-
/** Debug info for initializing the thunk (i.e. running it the first time) */
|
|
105
|
-
debugRefreshReason?: RefreshReasonWithGenericReasons<TDebugRefreshReason>;
|
|
106
|
-
} | undefined, otelContext: otel.Context): Thunk<T>;
|
|
107
|
-
destroy(node: Atom<any> | Effect): void;
|
|
108
|
-
makeEffect(doEffect: (get: GetAtom) => void, options: {
|
|
109
|
-
label?: string;
|
|
110
|
-
} | undefined, otelContext: otel.Context): Effect;
|
|
111
|
-
setRef<T>(ref: Ref<T>, val: T, options: {
|
|
112
|
-
otelHint?: string;
|
|
113
|
-
skipRefresh?: boolean;
|
|
114
|
-
debugRefreshReason?: TDebugRefreshReason;
|
|
115
|
-
} | undefined, otelContext: otel.Context): void;
|
|
116
|
-
setRefs<T>(refs: [Ref<T>, T][], options: {
|
|
117
|
-
otelHint?: string;
|
|
118
|
-
skipRefresh?: boolean;
|
|
119
|
-
debugRefreshReason?: TDebugRefreshReason;
|
|
120
|
-
} | undefined, otelContext: otel.Context): void;
|
|
121
|
-
get<T>(atom: Atom<T>, context: Atom<any> | Effect): T;
|
|
122
|
-
/**
|
|
123
|
-
* Update the graph to be consistent with the current values of the root atoms.
|
|
124
|
-
* Generally we run this after a ref is updated.
|
|
125
|
-
* At the end of the refresh, we run any effects that were scheduled.
|
|
126
|
-
*
|
|
127
|
-
* @param roots Root atoms to start the refresh from
|
|
128
|
-
*/
|
|
129
|
-
refresh(options: {
|
|
130
|
-
otelHint?: string;
|
|
131
|
-
debugRefreshReason?: RefreshReasonWithGenericReasons<TDebugRefreshReason>;
|
|
132
|
-
} | undefined, otelContext: otel.Context): void;
|
|
133
|
-
label(atom: Atom<any> | Effect): string;
|
|
134
|
-
addEdge(superComp: Atom<any> | Effect, subComp: Atom<any>): void;
|
|
135
|
-
removeEdge(superComp: Atom<any> | Effect, subComp: Atom<any>): void;
|
|
136
|
-
updateAtomHeight(atom: Atom<any> | Effect): void;
|
|
137
|
-
private getSnapshot;
|
|
138
|
-
}
|
|
139
|
-
export {};
|
|
140
|
-
//# sourceMappingURL=reactive.d.ts.map
|
package/dist/reactive.d.ts.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../src/reactive.ts"],"names":[],"mappings":"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"}
|