@terreno/syncdb 56.0.0-beta.0
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/README.md +419 -0
- package/dist/auth/betterAuthAdapter.d.ts +22 -0
- package/dist/auth/betterAuthAdapter.d.ts.map +1 -0
- package/dist/auth/betterAuthAdapter.js +181 -0
- package/dist/auth/betterAuthAdapter.js.map +1 -0
- package/dist/auth/betterAuthAdapter.test.d.ts +2 -0
- package/dist/auth/betterAuthAdapter.test.d.ts.map +1 -0
- package/dist/auth/betterAuthAdapter.test.js +350 -0
- package/dist/auth/betterAuthAdapter.test.js.map +1 -0
- package/dist/auth/types.d.ts +42 -0
- package/dist/auth/types.d.ts.map +1 -0
- package/dist/auth/types.js +9 -0
- package/dist/auth/types.js.map +1 -0
- package/dist/client.d.ts +246 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +1415 -0
- package/dist/client.js.map +1 -0
- package/dist/client.test.d.ts +2 -0
- package/dist/client.test.d.ts.map +1 -0
- package/dist/client.test.js +2310 -0
- package/dist/client.test.js.map +1 -0
- package/dist/crypto/aesGcmCodec.d.ts +33 -0
- package/dist/crypto/aesGcmCodec.d.ts.map +1 -0
- package/dist/crypto/aesGcmCodec.js +80 -0
- package/dist/crypto/aesGcmCodec.js.map +1 -0
- package/dist/crypto/aesGcmCodec.test.d.ts +2 -0
- package/dist/crypto/aesGcmCodec.test.d.ts.map +1 -0
- package/dist/crypto/aesGcmCodec.test.js +83 -0
- package/dist/crypto/aesGcmCodec.test.js.map +1 -0
- package/dist/crypto/identityCodec.d.ts +7 -0
- package/dist/crypto/identityCodec.d.ts.map +1 -0
- package/dist/crypto/identityCodec.js +9 -0
- package/dist/crypto/identityCodec.js.map +1 -0
- package/dist/crypto/keyProviders.d.ts +34 -0
- package/dist/crypto/keyProviders.d.ts.map +1 -0
- package/dist/crypto/keyProviders.js +102 -0
- package/dist/crypto/keyProviders.js.map +1 -0
- package/dist/crypto/keyProviders.test.d.ts +2 -0
- package/dist/crypto/keyProviders.test.d.ts.map +1 -0
- package/dist/crypto/keyProviders.test.js +189 -0
- package/dist/crypto/keyProviders.test.js.map +1 -0
- package/dist/crypto/types.d.ts +24 -0
- package/dist/crypto/types.d.ts.map +1 -0
- package/dist/crypto/types.js +8 -0
- package/dist/crypto/types.js.map +1 -0
- package/dist/debug/debugChannel.d.ts +52 -0
- package/dist/debug/debugChannel.d.ts.map +1 -0
- package/dist/debug/debugChannel.js +73 -0
- package/dist/debug/debugChannel.js.map +1 -0
- package/dist/debug/debugChannel.test.d.ts +2 -0
- package/dist/debug/debugChannel.test.d.ts.map +1 -0
- package/dist/debug/debugChannel.test.js +105 -0
- package/dist/debug/debugChannel.test.js.map +1 -0
- package/dist/debug/debugLog.d.ts +111 -0
- package/dist/debug/debugLog.d.ts.map +1 -0
- package/dist/debug/debugLog.js +150 -0
- package/dist/debug/debugLog.js.map +1 -0
- package/dist/debug/debugLog.test.d.ts +2 -0
- package/dist/debug/debugLog.test.d.ts.map +1 -0
- package/dist/debug/debugLog.test.js +121 -0
- package/dist/debug/debugLog.test.js.map +1 -0
- package/dist/index.d.ts +46 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +51 -0
- package/dist/index.js.map +1 -0
- package/dist/isolated/defaultPersisterFactoryNative.isolated.d.ts +2 -0
- package/dist/isolated/defaultPersisterFactoryNative.isolated.d.ts.map +1 -0
- package/dist/isolated/defaultPersisterFactoryNative.isolated.js +38 -0
- package/dist/isolated/defaultPersisterFactoryNative.isolated.js.map +1 -0
- package/dist/mutations/conflicts.d.ts +31 -0
- package/dist/mutations/conflicts.d.ts.map +1 -0
- package/dist/mutations/conflicts.js +73 -0
- package/dist/mutations/conflicts.js.map +1 -0
- package/dist/mutations/outbox.d.ts +174 -0
- package/dist/mutations/outbox.d.ts.map +1 -0
- package/dist/mutations/outbox.js +385 -0
- package/dist/mutations/outbox.js.map +1 -0
- package/dist/mutations/outbox.test.d.ts +2 -0
- package/dist/mutations/outbox.test.d.ts.map +1 -0
- package/dist/mutations/outbox.test.js +643 -0
- package/dist/mutations/outbox.test.js.map +1 -0
- package/dist/mutations/resolveConflict.d.ts +32 -0
- package/dist/mutations/resolveConflict.d.ts.map +1 -0
- package/dist/mutations/resolveConflict.js +101 -0
- package/dist/mutations/resolveConflict.js.map +1 -0
- package/dist/mutations/resolveConflict.test.d.ts +2 -0
- package/dist/mutations/resolveConflict.test.d.ts.map +1 -0
- package/dist/mutations/resolveConflict.test.js +282 -0
- package/dist/mutations/resolveConflict.test.js.map +1 -0
- package/dist/persisters/defaultPersisterFactory.d.ts +9 -0
- package/dist/persisters/defaultPersisterFactory.d.ts.map +1 -0
- package/dist/persisters/defaultPersisterFactory.js +9 -0
- package/dist/persisters/defaultPersisterFactory.js.map +1 -0
- package/dist/persisters/defaultPersisterFactory.native.d.ts +10 -0
- package/dist/persisters/defaultPersisterFactory.native.d.ts.map +1 -0
- package/dist/persisters/defaultPersisterFactory.native.js +44 -0
- package/dist/persisters/defaultPersisterFactory.native.js.map +1 -0
- package/dist/persisters/defaultPersisterFactory.test.d.ts +2 -0
- package/dist/persisters/defaultPersisterFactory.test.d.ts.map +1 -0
- package/dist/persisters/defaultPersisterFactory.test.js +177 -0
- package/dist/persisters/defaultPersisterFactory.test.js.map +1 -0
- package/dist/persisters/defaultPersisterFactory.web.d.ts +17 -0
- package/dist/persisters/defaultPersisterFactory.web.d.ts.map +1 -0
- package/dist/persisters/defaultPersisterFactory.web.js +65 -0
- package/dist/persisters/defaultPersisterFactory.web.js.map +1 -0
- package/dist/persisters/encryptedIndexedDbPersister.d.ts +46 -0
- package/dist/persisters/encryptedIndexedDbPersister.d.ts.map +1 -0
- package/dist/persisters/encryptedIndexedDbPersister.js +171 -0
- package/dist/persisters/encryptedIndexedDbPersister.js.map +1 -0
- package/dist/persisters/encryptedIndexedDbPersister.test.d.ts +2 -0
- package/dist/persisters/encryptedIndexedDbPersister.test.d.ts.map +1 -0
- package/dist/persisters/encryptedIndexedDbPersister.test.js +352 -0
- package/dist/persisters/encryptedIndexedDbPersister.test.js.map +1 -0
- package/dist/persisters/memoryPersister.d.ts +19 -0
- package/dist/persisters/memoryPersister.d.ts.map +1 -0
- package/dist/persisters/memoryPersister.js +31 -0
- package/dist/persisters/memoryPersister.js.map +1 -0
- package/dist/persisters/memoryPersister.test.d.ts +2 -0
- package/dist/persisters/memoryPersister.test.d.ts.map +1 -0
- package/dist/persisters/memoryPersister.test.js +113 -0
- package/dist/persisters/memoryPersister.test.js.map +1 -0
- package/dist/persisters/types.d.ts +65 -0
- package/dist/persisters/types.d.ts.map +1 -0
- package/dist/persisters/types.js +2 -0
- package/dist/persisters/types.js.map +1 -0
- package/dist/react/hooks.d.ts +132 -0
- package/dist/react/hooks.d.ts.map +1 -0
- package/dist/react/hooks.js +269 -0
- package/dist/react/hooks.js.map +1 -0
- package/dist/react/hooks.test.d.ts +2 -0
- package/dist/react/hooks.test.d.ts.map +1 -0
- package/dist/react/hooks.test.js +645 -0
- package/dist/react/hooks.test.js.map +1 -0
- package/dist/react/index.d.ts +11 -0
- package/dist/react/index.d.ts.map +1 -0
- package/dist/react/index.js +11 -0
- package/dist/react/index.js.map +1 -0
- package/dist/react/provider.d.ts +11 -0
- package/dist/react/provider.d.ts.map +1 -0
- package/dist/react/provider.js +17 -0
- package/dist/react/provider.js.map +1 -0
- package/dist/storage/idb.d.ts +27 -0
- package/dist/storage/idb.d.ts.map +1 -0
- package/dist/storage/idb.js +72 -0
- package/dist/storage/idb.js.map +1 -0
- package/dist/storage/idb.test.d.ts +2 -0
- package/dist/storage/idb.test.d.ts.map +1 -0
- package/dist/storage/idb.test.js +100 -0
- package/dist/storage/idb.test.js.map +1 -0
- package/dist/storage/purgeUnknownStream.test.d.ts +2 -0
- package/dist/storage/purgeUnknownStream.test.d.ts.map +1 -0
- package/dist/storage/purgeUnknownStream.test.js +64 -0
- package/dist/storage/purgeUnknownStream.test.js.map +1 -0
- package/dist/storage/schema.d.ts +33 -0
- package/dist/storage/schema.d.ts.map +1 -0
- package/dist/storage/schema.js +92 -0
- package/dist/storage/schema.js.map +1 -0
- package/dist/storage/store.d.ts +136 -0
- package/dist/storage/store.d.ts.map +1 -0
- package/dist/storage/store.js +275 -0
- package/dist/storage/store.js.map +1 -0
- package/dist/storage/store.test.d.ts +2 -0
- package/dist/storage/store.test.d.ts.map +1 -0
- package/dist/storage/store.test.js +357 -0
- package/dist/storage/store.test.js.map +1 -0
- package/dist/storage/types.d.ts +146 -0
- package/dist/storage/types.d.ts.map +1 -0
- package/dist/storage/types.js +32 -0
- package/dist/storage/types.js.map +1 -0
- package/dist/storage/wipe.d.ts +22 -0
- package/dist/storage/wipe.d.ts.map +1 -0
- package/dist/storage/wipe.js +43 -0
- package/dist/storage/wipe.js.map +1 -0
- package/dist/storage/wipe.test.d.ts +2 -0
- package/dist/storage/wipe.test.d.ts.map +1 -0
- package/dist/storage/wipe.test.js +95 -0
- package/dist/storage/wipe.test.js.map +1 -0
- package/dist/sync/bootstrap.d.ts +64 -0
- package/dist/sync/bootstrap.d.ts.map +1 -0
- package/dist/sync/bootstrap.js +160 -0
- package/dist/sync/bootstrap.js.map +1 -0
- package/dist/sync/bootstrap.test.d.ts +2 -0
- package/dist/sync/bootstrap.test.d.ts.map +1 -0
- package/dist/sync/bootstrap.test.js +447 -0
- package/dist/sync/bootstrap.test.js.map +1 -0
- package/dist/sync/cursor.d.ts +67 -0
- package/dist/sync/cursor.d.ts.map +1 -0
- package/dist/sync/cursor.js +74 -0
- package/dist/sync/cursor.js.map +1 -0
- package/dist/sync/cursor.test.d.ts +2 -0
- package/dist/sync/cursor.test.d.ts.map +1 -0
- package/dist/sync/cursor.test.js +73 -0
- package/dist/sync/cursor.test.js.map +1 -0
- package/dist/sync/deltaApplier.d.ts +30 -0
- package/dist/sync/deltaApplier.d.ts.map +1 -0
- package/dist/sync/deltaApplier.js +61 -0
- package/dist/sync/deltaApplier.js.map +1 -0
- package/dist/sync/deltaApplier.test.d.ts +2 -0
- package/dist/sync/deltaApplier.test.d.ts.map +1 -0
- package/dist/sync/deltaApplier.test.js +212 -0
- package/dist/sync/deltaApplier.test.js.map +1 -0
- package/dist/sync/entityRepair.d.ts +45 -0
- package/dist/sync/entityRepair.d.ts.map +1 -0
- package/dist/sync/entityRepair.js +91 -0
- package/dist/sync/entityRepair.js.map +1 -0
- package/dist/sync/entityRepair.test.d.ts +2 -0
- package/dist/sync/entityRepair.test.d.ts.map +1 -0
- package/dist/sync/entityRepair.test.js +146 -0
- package/dist/sync/entityRepair.test.js.map +1 -0
- package/dist/sync/httpChannel.d.ts +74 -0
- package/dist/sync/httpChannel.d.ts.map +1 -0
- package/dist/sync/httpChannel.js +123 -0
- package/dist/sync/httpChannel.js.map +1 -0
- package/dist/sync/httpChannel.test.d.ts +2 -0
- package/dist/sync/httpChannel.test.d.ts.map +1 -0
- package/dist/sync/httpChannel.test.js +215 -0
- package/dist/sync/httpChannel.test.js.map +1 -0
- package/dist/sync/replayCoordinator.d.ts +212 -0
- package/dist/sync/replayCoordinator.d.ts.map +1 -0
- package/dist/sync/replayCoordinator.js +1110 -0
- package/dist/sync/replayCoordinator.js.map +1 -0
- package/dist/sync/replayCoordinator.test.d.ts +2 -0
- package/dist/sync/replayCoordinator.test.d.ts.map +1 -0
- package/dist/sync/replayCoordinator.test.js +1496 -0
- package/dist/sync/replayCoordinator.test.js.map +1 -0
- package/dist/sync/socketTransport.d.ts +56 -0
- package/dist/sync/socketTransport.d.ts.map +1 -0
- package/dist/sync/socketTransport.js +292 -0
- package/dist/sync/socketTransport.js.map +1 -0
- package/dist/sync/socketTransport.test.d.ts +2 -0
- package/dist/sync/socketTransport.test.d.ts.map +1 -0
- package/dist/sync/socketTransport.test.js +346 -0
- package/dist/sync/socketTransport.test.js.map +1 -0
- package/dist/sync/transport.d.ts +80 -0
- package/dist/sync/transport.d.ts.map +1 -0
- package/dist/sync/transport.js +5 -0
- package/dist/sync/transport.js.map +1 -0
- package/dist/testing/fakeTransport.d.ts +55 -0
- package/dist/testing/fakeTransport.d.ts.map +1 -0
- package/dist/testing/fakeTransport.js +139 -0
- package/dist/testing/fakeTransport.js.map +1 -0
- package/dist/testing/fakeTransport.test.d.ts +2 -0
- package/dist/testing/fakeTransport.test.d.ts.map +1 -0
- package/dist/testing/fakeTransport.test.js +112 -0
- package/dist/testing/fakeTransport.test.js.map +1 -0
- package/dist/testing/index.d.ts +13 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing/index.js +13 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/types.d.ts +271 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +9 -0
- package/dist/types.js.map +1 -0
- package/package.json +71 -0
- package/src/auth/betterAuthAdapter.test.ts +455 -0
- package/src/auth/betterAuthAdapter.ts +214 -0
- package/src/auth/types.ts +49 -0
- package/src/client.test.ts +2670 -0
- package/src/client.ts +1748 -0
- package/src/crypto/aesGcmCodec.test.ts +103 -0
- package/src/crypto/aesGcmCodec.ts +98 -0
- package/src/crypto/identityCodec.ts +10 -0
- package/src/crypto/keyProviders.test.ts +228 -0
- package/src/crypto/keyProviders.ts +153 -0
- package/src/crypto/types.ts +23 -0
- package/src/debug/debugChannel.test.ts +121 -0
- package/src/debug/debugChannel.ts +112 -0
- package/src/debug/debugLog.test.ts +139 -0
- package/src/debug/debugLog.ts +272 -0
- package/src/index.ts +157 -0
- package/src/isolated/defaultPersisterFactoryNative.isolated.ts +45 -0
- package/src/mutations/conflicts.ts +108 -0
- package/src/mutations/outbox.test.ts +754 -0
- package/src/mutations/outbox.ts +585 -0
- package/src/mutations/resolveConflict.test.ts +338 -0
- package/src/mutations/resolveConflict.ts +115 -0
- package/src/persisters/defaultPersisterFactory.native.ts +53 -0
- package/src/persisters/defaultPersisterFactory.test.ts +207 -0
- package/src/persisters/defaultPersisterFactory.ts +12 -0
- package/src/persisters/defaultPersisterFactory.web.ts +78 -0
- package/src/persisters/encryptedIndexedDbPersister.test.ts +381 -0
- package/src/persisters/encryptedIndexedDbPersister.ts +218 -0
- package/src/persisters/memoryPersister.test.ts +136 -0
- package/src/persisters/memoryPersister.ts +52 -0
- package/src/persisters/types.ts +71 -0
- package/src/react/hooks.test.tsx +761 -0
- package/src/react/hooks.ts +409 -0
- package/src/react/index.ts +11 -0
- package/src/react/provider.tsx +27 -0
- package/src/storage/idb.test.ts +116 -0
- package/src/storage/idb.ts +112 -0
- package/src/storage/purgeUnknownStream.test.ts +74 -0
- package/src/storage/schema.ts +103 -0
- package/src/storage/store.test.ts +424 -0
- package/src/storage/store.ts +461 -0
- package/src/storage/types.ts +159 -0
- package/src/storage/wipe.test.ts +111 -0
- package/src/storage/wipe.ts +58 -0
- package/src/sync/bootstrap.test.ts +486 -0
- package/src/sync/bootstrap.ts +217 -0
- package/src/sync/cursor.test.ts +84 -0
- package/src/sync/cursor.ts +113 -0
- package/src/sync/deltaApplier.test.ts +237 -0
- package/src/sync/deltaApplier.ts +84 -0
- package/src/sync/entityRepair.test.ts +161 -0
- package/src/sync/entityRepair.ts +124 -0
- package/src/sync/httpChannel.test.ts +265 -0
- package/src/sync/httpChannel.ts +220 -0
- package/src/sync/replayCoordinator.test.ts +1709 -0
- package/src/sync/replayCoordinator.ts +1370 -0
- package/src/sync/socketTransport.test.ts +413 -0
- package/src/sync/socketTransport.ts +379 -0
- package/src/sync/transport.ts +76 -0
- package/src/testing/fakeTransport.test.ts +125 -0
- package/src/testing/fakeTransport.ts +206 -0
- package/src/testing/index.ts +18 -0
- package/src/types.ts +284 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/persisters/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* React hooks over the SyncDb client.
|
|
3
|
+
*
|
|
4
|
+
* Reactivity is wired directly onto the raw TinyBase MergeableStore via
|
|
5
|
+
* `addRowListener`/`addTableListener` + `useSyncExternalStore` rather than
|
|
6
|
+
* `tinybase/ui-react`: ui-react hooks return raw rows/tables while these hooks
|
|
7
|
+
* return the decoded entity shapes (the `data` cell is JSON-encoded), and
|
|
8
|
+
* binding listeners ourselves keeps the React surface down to a single `react`
|
|
9
|
+
* peer dependency. No DOM APIs are used, so everything here is React Native
|
|
10
|
+
* (and RNW) compatible.
|
|
11
|
+
*/
|
|
12
|
+
import type { SyncDebugEvent, SyncDebugLog, SyncDebugStats } from "../debug/debugLog";
|
|
13
|
+
import type { ConflictResolutionStrategy, SyncConflict, SyncStatus } from "../types";
|
|
14
|
+
export interface UseEntityResult<TData> {
|
|
15
|
+
/** Decoded entity payload, or undefined when the entity does not exist locally. */
|
|
16
|
+
data: TData | undefined;
|
|
17
|
+
/** Soft-delete tombstone flag. */
|
|
18
|
+
deleted: boolean;
|
|
19
|
+
/** Highest server seq applied to the entity (0 = local-only). */
|
|
20
|
+
seq: number;
|
|
21
|
+
/** True while an outbox mutation is protecting this entity's optimistic state. */
|
|
22
|
+
isPending: boolean;
|
|
23
|
+
}
|
|
24
|
+
/** Subscribe to a single entity; re-renders when that row changes. */
|
|
25
|
+
export declare const useEntity: <TData = Record<string, unknown>>(collection: string, id: string) => UseEntityResult<TData>;
|
|
26
|
+
export interface UseQueryOptions<TData> {
|
|
27
|
+
/** Keep only entities whose decoded data passes the predicate (runs in JS). */
|
|
28
|
+
filter?: (data: TData) => boolean;
|
|
29
|
+
/** Sort comparator over decoded data (runs in JS on a copy). */
|
|
30
|
+
sort?: (a: TData, b: TData) => number;
|
|
31
|
+
/** Include soft-deleted (tombstoned) entities; excluded by default. */
|
|
32
|
+
includeDeleted?: boolean;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Subscribe to a collection; returns the entities' decoded data and re-renders
|
|
36
|
+
* on any table change. Tombstones are excluded unless `includeDeleted` is set;
|
|
37
|
+
* filter and sort run in JS.
|
|
38
|
+
*
|
|
39
|
+
* `filter`/`sort`/`includeDeleted` are part of the selection identity (compared
|
|
40
|
+
* by reference), so a state-driven filter change is reflected on the very next
|
|
41
|
+
* render without waiting for a store write. The flip side is that a filter/sort
|
|
42
|
+
* passed as a fresh inline closure every render invalidates the snapshot cache
|
|
43
|
+
* every render — wrap them in `useCallback` (or hoist them) when the collection
|
|
44
|
+
* is large enough for the decode/filter/sort pass to matter.
|
|
45
|
+
*/
|
|
46
|
+
export declare const useQuery: <TData = Record<string, unknown>>(collection: string, options?: UseQueryOptions<TData>) => TData[];
|
|
47
|
+
/**
|
|
48
|
+
* Subscribe to a collection but return only the (ordered) entity ids, with a
|
|
49
|
+
* referentially STABLE array that changes identity only when the id membership
|
|
50
|
+
* or order actually changes — not when a field of an existing row changes.
|
|
51
|
+
*
|
|
52
|
+
* Pair this with per-row `useEntity(collection, id)` to build large lists that
|
|
53
|
+
* stay fast without virtualization: rendering `ids.map(id => <Row id={id} />)`
|
|
54
|
+
* means a field update (e.g. toggling one row) re-renders ONLY that row's
|
|
55
|
+
* `useEntity` subscriber, and the list container re-renders only when rows are
|
|
56
|
+
* added/removed/reordered. `filter`/`sort` run in JS over the decoded data and,
|
|
57
|
+
* as in `useQuery`, are part of the selection identity — a changed filter is
|
|
58
|
+
* reflected on the next render, and memoizing inline callbacks keeps the
|
|
59
|
+
* recomputation to store changes only. Either way the returned array keeps its
|
|
60
|
+
* identity whenever the resulting ids are unchanged.
|
|
61
|
+
*/
|
|
62
|
+
export declare const useEntityIds: <TData = Record<string, unknown>>(collection: string, options?: UseQueryOptions<TData>) => string[];
|
|
63
|
+
export interface UseMutateResult {
|
|
64
|
+
/** Optimistically create an entity; returns the generated ids. */
|
|
65
|
+
create: (args: {
|
|
66
|
+
data: Record<string, unknown>;
|
|
67
|
+
}) => {
|
|
68
|
+
mutationId: string;
|
|
69
|
+
id: string;
|
|
70
|
+
};
|
|
71
|
+
/** Optimistically merge fields into an existing entity. */
|
|
72
|
+
update: (args: {
|
|
73
|
+
id: string;
|
|
74
|
+
data: Record<string, unknown>;
|
|
75
|
+
}) => {
|
|
76
|
+
mutationId: string;
|
|
77
|
+
id: string;
|
|
78
|
+
};
|
|
79
|
+
/** Optimistically soft-delete an entity. */
|
|
80
|
+
remove: (args: {
|
|
81
|
+
id: string;
|
|
82
|
+
}) => {
|
|
83
|
+
mutationId: string;
|
|
84
|
+
id: string;
|
|
85
|
+
};
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Collection-scoped mutation helpers wrapping `client.mutate`: each applies
|
|
89
|
+
* locally, enqueues a durable outbox mutation, and kicks off replay.
|
|
90
|
+
*/
|
|
91
|
+
export declare const useMutate: (collection: string) => UseMutateResult;
|
|
92
|
+
/**
|
|
93
|
+
* Aggregate sync status; re-renders when any status input changes. Store-backed
|
|
94
|
+
* inputs (queued outbox rows, conflicts, stream cursors) are observed through
|
|
95
|
+
* table listeners; connectivity and syncing activity arrive through the
|
|
96
|
+
* client's `onStatusChange` passthrough.
|
|
97
|
+
*/
|
|
98
|
+
export declare const useSyncStatus: () => SyncStatus;
|
|
99
|
+
export interface UseConflictsResult {
|
|
100
|
+
/** Unresolved conflicts (dismissed rows excluded). */
|
|
101
|
+
conflicts: SyncConflict[];
|
|
102
|
+
/** Resolve a conflict with `useServer` or `keepMine`. */
|
|
103
|
+
resolve: (args: {
|
|
104
|
+
mutationId: string;
|
|
105
|
+
strategy: ConflictResolutionStrategy;
|
|
106
|
+
}) => void;
|
|
107
|
+
}
|
|
108
|
+
/** Subscribe to unresolved conflicts and expose the client's resolver. */
|
|
109
|
+
export declare const useConflicts: () => UseConflictsResult;
|
|
110
|
+
export interface UseSyncDebugLogResult {
|
|
111
|
+
/** True when the client was created with `debug` enabled. */
|
|
112
|
+
enabled: boolean;
|
|
113
|
+
/** Recorded events, oldest → newest (empty when disabled). */
|
|
114
|
+
events: SyncDebugEvent[];
|
|
115
|
+
/** Aggregate counters (undefined when disabled). */
|
|
116
|
+
stats: SyncDebugStats | undefined;
|
|
117
|
+
/** The underlying log, for `snapshot()`/`clear()` (undefined when disabled). */
|
|
118
|
+
log: SyncDebugLog | undefined;
|
|
119
|
+
/** Drop all retained events and reset `stats` to describe the now-empty log (a no-op when disabled). */
|
|
120
|
+
clear: () => void;
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* Subscribe to the client's debug event log (see `createSyncDb({debug: true})`).
|
|
124
|
+
*
|
|
125
|
+
* Reactivity is driven by the log's monotonic revision through
|
|
126
|
+
* `useSyncExternalStore`, so a burst of events triggers at most one render per
|
|
127
|
+
* commit. `events` is read fresh from the ring buffer on each render (O(capacity),
|
|
128
|
+
* capacity defaults to 500) — cheap enough for a live debugger and stable when
|
|
129
|
+
* nothing changed because the revision is unchanged.
|
|
130
|
+
*/
|
|
131
|
+
export declare const useSyncDebugLog: () => UseSyncDebugLogResult;
|
|
132
|
+
//# sourceMappingURL=hooks.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/react/hooks.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,269 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* React hooks over the SyncDb client.
|
|
3
|
+
*
|
|
4
|
+
* Reactivity is wired directly onto the raw TinyBase MergeableStore via
|
|
5
|
+
* `addRowListener`/`addTableListener` + `useSyncExternalStore` rather than
|
|
6
|
+
* `tinybase/ui-react`: ui-react hooks return raw rows/tables while these hooks
|
|
7
|
+
* return the decoded entity shapes (the `data` cell is JSON-encoded), and
|
|
8
|
+
* binding listeners ourselves keeps the React surface down to a single `react`
|
|
9
|
+
* peer dependency. No DOM APIs are used, so everything here is React Native
|
|
10
|
+
* (and RNW) compatible.
|
|
11
|
+
*/
|
|
12
|
+
import { useCallback, useRef, useSyncExternalStore } from "react";
|
|
13
|
+
import { listConflicts } from "../mutations/conflicts";
|
|
14
|
+
import { CONFLICTS_TABLE, CURSORS_TABLE, OUTBOX_TABLE } from "../storage/types";
|
|
15
|
+
import { useSyncDbClient } from "./provider";
|
|
16
|
+
/**
|
|
17
|
+
* `useSyncExternalStore` wrapper that recomputes the selected value only when the
|
|
18
|
+
* underlying store actually changes, giving selectors returning fresh
|
|
19
|
+
* objects/arrays a stable identity across unrelated renders without ever causing
|
|
20
|
+
* render loops.
|
|
21
|
+
*
|
|
22
|
+
* React calls `getSnapshot` on EVERY render (not only when the store changes) to
|
|
23
|
+
* check for tearing. The previous implementation re-ran `select()` and then
|
|
24
|
+
* `JSON.stringify`'d the entire result on every one of those calls — O(n) work
|
|
25
|
+
* (decode + filter + sort + serialize the whole collection) on every keystroke
|
|
26
|
+
* or unrelated parent re-render, which dominates once a collection grows to
|
|
27
|
+
* thousands of rows. Instead we bump a monotonic revision only when a change is
|
|
28
|
+
* routed through our subscribe wrapper, and cache the computed value against
|
|
29
|
+
* that revision (and the selector identity, so a changed collection/id
|
|
30
|
+
* recomputes immediately rather than returning a stale snapshot). Unrelated
|
|
31
|
+
* re-renders then return the cached value in O(1) and never serialize.
|
|
32
|
+
*/
|
|
33
|
+
const useCachedExternalStore = (subscribe, select,
|
|
34
|
+
/**
|
|
35
|
+
* Optional structural equality over consecutive selections. When provided and
|
|
36
|
+
* a real store change produces an equal value, the PREVIOUS reference is kept
|
|
37
|
+
* so downstream consumers do not re-render. This is what lets `useEntityIds`
|
|
38
|
+
* stay referentially stable across field-only updates (which change a row's
|
|
39
|
+
* data but not the id membership/order), so toggling one entity re-renders
|
|
40
|
+
* only that entity's own subscribers, never the list container.
|
|
41
|
+
*/
|
|
42
|
+
areEqual) => {
|
|
43
|
+
const revisionRef = useRef(0);
|
|
44
|
+
const cacheRef = useRef(null);
|
|
45
|
+
const wrappedSubscribe = useCallback((onChange) => subscribe(() => {
|
|
46
|
+
revisionRef.current += 1;
|
|
47
|
+
onChange();
|
|
48
|
+
}), [subscribe]);
|
|
49
|
+
const getSnapshot = useCallback(() => {
|
|
50
|
+
const revision = revisionRef.current;
|
|
51
|
+
const cached = cacheRef.current;
|
|
52
|
+
if (cached && cached.select === select && cached.revision === revision) {
|
|
53
|
+
// Neither the store nor the selector changed since the last computation →
|
|
54
|
+
// reuse in O(1) (the common case: unrelated re-renders such as a keystroke
|
|
55
|
+
// in a sibling input).
|
|
56
|
+
return cached.value;
|
|
57
|
+
}
|
|
58
|
+
// Either the store changed or the selector did (a new collection/id, or
|
|
59
|
+
// changed query options — see useQuery). Recompute, but keep the previous
|
|
60
|
+
// reference when an equality check says the result is unchanged (e.g. a
|
|
61
|
+
// field update that did not alter id membership/order), which is also what
|
|
62
|
+
// keeps `useSyncExternalStore` from re-rendering on every recomputation.
|
|
63
|
+
const next = select();
|
|
64
|
+
if (cached && areEqual?.(cached.value, next)) {
|
|
65
|
+
cacheRef.current = { revision, select, value: cached.value };
|
|
66
|
+
return cached.value;
|
|
67
|
+
}
|
|
68
|
+
cacheRef.current = { revision, select, value: next };
|
|
69
|
+
return next;
|
|
70
|
+
}, [select, areEqual]);
|
|
71
|
+
return useSyncExternalStore(wrappedSubscribe, getSnapshot, getSnapshot);
|
|
72
|
+
};
|
|
73
|
+
/** Referential-stability helper: true when two id lists are element-wise equal. */
|
|
74
|
+
const idsEqual = (previous, next) => {
|
|
75
|
+
if (previous === next) {
|
|
76
|
+
return true;
|
|
77
|
+
}
|
|
78
|
+
if (previous.length !== next.length) {
|
|
79
|
+
return false;
|
|
80
|
+
}
|
|
81
|
+
for (let index = 0; index < previous.length; index += 1) {
|
|
82
|
+
if (previous[index] !== next[index]) {
|
|
83
|
+
return false;
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
return true;
|
|
87
|
+
};
|
|
88
|
+
/** Subscribe to a single entity; re-renders when that row changes. */
|
|
89
|
+
export const useEntity = (collection, id) => {
|
|
90
|
+
const client = useSyncDbClient();
|
|
91
|
+
const subscribe = useCallback((onChange) => {
|
|
92
|
+
const listenerId = client.store.raw.addRowListener(collection, id, onChange);
|
|
93
|
+
return () => {
|
|
94
|
+
client.store.raw.delListener(listenerId);
|
|
95
|
+
};
|
|
96
|
+
}, [client, collection, id]);
|
|
97
|
+
const select = useCallback(() => {
|
|
98
|
+
const entity = client.store.getEntity({ collection, id });
|
|
99
|
+
if (!entity) {
|
|
100
|
+
return { data: undefined, deleted: false, isPending: false, seq: 0 };
|
|
101
|
+
}
|
|
102
|
+
return {
|
|
103
|
+
data: entity.data ?? undefined,
|
|
104
|
+
deleted: entity.deleted,
|
|
105
|
+
isPending: entity.pendingMutationId !== undefined,
|
|
106
|
+
seq: entity.seq,
|
|
107
|
+
};
|
|
108
|
+
}, [client, collection, id]);
|
|
109
|
+
return useCachedExternalStore(subscribe, select);
|
|
110
|
+
};
|
|
111
|
+
/**
|
|
112
|
+
* Subscribe to a collection; returns the entities' decoded data and re-renders
|
|
113
|
+
* on any table change. Tombstones are excluded unless `includeDeleted` is set;
|
|
114
|
+
* filter and sort run in JS.
|
|
115
|
+
*
|
|
116
|
+
* `filter`/`sort`/`includeDeleted` are part of the selection identity (compared
|
|
117
|
+
* by reference), so a state-driven filter change is reflected on the very next
|
|
118
|
+
* render without waiting for a store write. The flip side is that a filter/sort
|
|
119
|
+
* passed as a fresh inline closure every render invalidates the snapshot cache
|
|
120
|
+
* every render — wrap them in `useCallback` (or hoist them) when the collection
|
|
121
|
+
* is large enough for the decode/filter/sort pass to matter.
|
|
122
|
+
*/
|
|
123
|
+
export const useQuery = (collection, options) => {
|
|
124
|
+
const client = useSyncDbClient();
|
|
125
|
+
const { filter, includeDeleted, sort } = options ?? {};
|
|
126
|
+
const subscribe = useCallback((onChange) => {
|
|
127
|
+
const listenerId = client.store.raw.addTableListener(collection, onChange);
|
|
128
|
+
return () => {
|
|
129
|
+
client.store.raw.delListener(listenerId);
|
|
130
|
+
};
|
|
131
|
+
}, [client, collection]);
|
|
132
|
+
const select = useCallback(() => {
|
|
133
|
+
const entities = client.store.listEntities({ collection, includeDeleted });
|
|
134
|
+
// E4: a corrupt/legacy row decodes to `data: null` (store.ts's decodeData
|
|
135
|
+
// swallows JSON.parse failures and returns null rather than throwing) —
|
|
136
|
+
// skip it here rather than letting it crash list consumers that assume
|
|
137
|
+
// every row's data matches TData (e.g. destructuring a field off it).
|
|
138
|
+
let results = entities.filter((entity) => entity.data !== null).map((entity) => entity.data);
|
|
139
|
+
if (filter) {
|
|
140
|
+
results = results.filter(filter);
|
|
141
|
+
}
|
|
142
|
+
if (sort) {
|
|
143
|
+
results = [...results].sort(sort);
|
|
144
|
+
}
|
|
145
|
+
return results;
|
|
146
|
+
}, [client, collection, filter, includeDeleted, sort]);
|
|
147
|
+
return useCachedExternalStore(subscribe, select);
|
|
148
|
+
};
|
|
149
|
+
/**
|
|
150
|
+
* Subscribe to a collection but return only the (ordered) entity ids, with a
|
|
151
|
+
* referentially STABLE array that changes identity only when the id membership
|
|
152
|
+
* or order actually changes — not when a field of an existing row changes.
|
|
153
|
+
*
|
|
154
|
+
* Pair this with per-row `useEntity(collection, id)` to build large lists that
|
|
155
|
+
* stay fast without virtualization: rendering `ids.map(id => <Row id={id} />)`
|
|
156
|
+
* means a field update (e.g. toggling one row) re-renders ONLY that row's
|
|
157
|
+
* `useEntity` subscriber, and the list container re-renders only when rows are
|
|
158
|
+
* added/removed/reordered. `filter`/`sort` run in JS over the decoded data and,
|
|
159
|
+
* as in `useQuery`, are part of the selection identity — a changed filter is
|
|
160
|
+
* reflected on the next render, and memoizing inline callbacks keeps the
|
|
161
|
+
* recomputation to store changes only. Either way the returned array keeps its
|
|
162
|
+
* identity whenever the resulting ids are unchanged.
|
|
163
|
+
*/
|
|
164
|
+
export const useEntityIds = (collection, options) => {
|
|
165
|
+
const client = useSyncDbClient();
|
|
166
|
+
const { filter, includeDeleted, sort } = options ?? {};
|
|
167
|
+
const subscribe = useCallback((onChange) => {
|
|
168
|
+
const listenerId = client.store.raw.addTableListener(collection, onChange);
|
|
169
|
+
return () => {
|
|
170
|
+
client.store.raw.delListener(listenerId);
|
|
171
|
+
};
|
|
172
|
+
}, [client, collection]);
|
|
173
|
+
const select = useCallback(() => {
|
|
174
|
+
const entities = client.store.listEntities({ collection, includeDeleted });
|
|
175
|
+
let results = entities.filter((entity) => entity.data !== null);
|
|
176
|
+
if (filter) {
|
|
177
|
+
results = results.filter((entity) => filter(entity.data));
|
|
178
|
+
}
|
|
179
|
+
if (sort) {
|
|
180
|
+
results = [...results].sort((a, b) => sort(a.data, b.data));
|
|
181
|
+
}
|
|
182
|
+
return results.map((entity) => entity.id);
|
|
183
|
+
}, [client, collection, filter, includeDeleted, sort]);
|
|
184
|
+
return useCachedExternalStore(subscribe, select, idsEqual);
|
|
185
|
+
};
|
|
186
|
+
/**
|
|
187
|
+
* Collection-scoped mutation helpers wrapping `client.mutate`: each applies
|
|
188
|
+
* locally, enqueues a durable outbox mutation, and kicks off replay.
|
|
189
|
+
*/
|
|
190
|
+
export const useMutate = (collection) => {
|
|
191
|
+
const client = useSyncDbClient();
|
|
192
|
+
const create = useCallback((args) => client.mutate({ collection, data: args.data, operation: "create" }), [client, collection]);
|
|
193
|
+
const update = useCallback((args) => client.mutate({ collection, data: args.data, id: args.id, operation: "update" }), [client, collection]);
|
|
194
|
+
const remove = useCallback((args) => client.mutate({ collection, id: args.id, operation: "delete" }), [client, collection]);
|
|
195
|
+
return { create, remove, update };
|
|
196
|
+
};
|
|
197
|
+
/**
|
|
198
|
+
* Aggregate sync status; re-renders when any status input changes. Store-backed
|
|
199
|
+
* inputs (queued outbox rows, conflicts, stream cursors) are observed through
|
|
200
|
+
* table listeners; connectivity and syncing activity arrive through the
|
|
201
|
+
* client's `onStatusChange` passthrough.
|
|
202
|
+
*/
|
|
203
|
+
export const useSyncStatus = () => {
|
|
204
|
+
const client = useSyncDbClient();
|
|
205
|
+
const subscribe = useCallback((onChange) => {
|
|
206
|
+
const unsubStatus = client.onStatusChange(onChange);
|
|
207
|
+
const outboxListener = client.store.raw.addTableListener(OUTBOX_TABLE, onChange);
|
|
208
|
+
const conflictsListener = client.store.raw.addTableListener(CONFLICTS_TABLE, onChange);
|
|
209
|
+
const cursorsListener = client.store.raw.addTableListener(CURSORS_TABLE, onChange);
|
|
210
|
+
return () => {
|
|
211
|
+
unsubStatus();
|
|
212
|
+
client.store.raw.delListener(outboxListener);
|
|
213
|
+
client.store.raw.delListener(conflictsListener);
|
|
214
|
+
client.store.raw.delListener(cursorsListener);
|
|
215
|
+
};
|
|
216
|
+
}, [client]);
|
|
217
|
+
const select = useCallback(() => client.getSyncStatus(), [client]);
|
|
218
|
+
return useCachedExternalStore(subscribe, select);
|
|
219
|
+
};
|
|
220
|
+
/** Subscribe to unresolved conflicts and expose the client's resolver. */
|
|
221
|
+
export const useConflicts = () => {
|
|
222
|
+
const client = useSyncDbClient();
|
|
223
|
+
const subscribe = useCallback((onChange) => {
|
|
224
|
+
const listenerId = client.store.raw.addTableListener(CONFLICTS_TABLE, onChange);
|
|
225
|
+
return () => {
|
|
226
|
+
client.store.raw.delListener(listenerId);
|
|
227
|
+
};
|
|
228
|
+
}, [client]);
|
|
229
|
+
const select = useCallback(() => listConflicts({ store: client.store }), [client]);
|
|
230
|
+
const conflicts = useCachedExternalStore(subscribe, select);
|
|
231
|
+
const resolve = useCallback((args) => {
|
|
232
|
+
client.resolveConflict(args);
|
|
233
|
+
}, [client]);
|
|
234
|
+
return { conflicts, resolve };
|
|
235
|
+
};
|
|
236
|
+
const EMPTY_EVENTS = [];
|
|
237
|
+
/**
|
|
238
|
+
* Subscribe to the client's debug event log (see `createSyncDb({debug: true})`).
|
|
239
|
+
*
|
|
240
|
+
* Reactivity is driven by the log's monotonic revision through
|
|
241
|
+
* `useSyncExternalStore`, so a burst of events triggers at most one render per
|
|
242
|
+
* commit. `events` is read fresh from the ring buffer on each render (O(capacity),
|
|
243
|
+
* capacity defaults to 500) — cheap enough for a live debugger and stable when
|
|
244
|
+
* nothing changed because the revision is unchanged.
|
|
245
|
+
*/
|
|
246
|
+
export const useSyncDebugLog = () => {
|
|
247
|
+
const client = useSyncDbClient();
|
|
248
|
+
const log = client.debug;
|
|
249
|
+
const subscribe = useCallback((onChange) => {
|
|
250
|
+
if (!log) {
|
|
251
|
+
return () => { };
|
|
252
|
+
}
|
|
253
|
+
return log.subscribe(onChange);
|
|
254
|
+
}, [log]);
|
|
255
|
+
const getRevision = useCallback(() => log?.getRevision() ?? 0, [log]);
|
|
256
|
+
// The revision changes on every record/clear; reading it re-renders the hook.
|
|
257
|
+
useSyncExternalStore(subscribe, getRevision, getRevision);
|
|
258
|
+
const clear = useCallback(() => {
|
|
259
|
+
log?.clear();
|
|
260
|
+
}, [log]);
|
|
261
|
+
return {
|
|
262
|
+
clear,
|
|
263
|
+
enabled: Boolean(log),
|
|
264
|
+
events: log ? log.getEvents() : EMPTY_EVENTS,
|
|
265
|
+
log,
|
|
266
|
+
stats: log?.getStats(),
|
|
267
|
+
};
|
|
268
|
+
};
|
|
269
|
+
//# sourceMappingURL=hooks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/react/hooks.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hooks.test.d.ts","sourceRoot":"","sources":["../../src/react/hooks.test.tsx"],"names":[],"mappings":""}
|