@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,220 @@
|
|
|
1
|
+
import type {
|
|
2
|
+
AuthProvider,
|
|
3
|
+
SyncAck,
|
|
4
|
+
SyncEntitiesResponse,
|
|
5
|
+
SyncMutateBatchRequest,
|
|
6
|
+
SyncMutateRequest,
|
|
7
|
+
SyncNack,
|
|
8
|
+
SyncSnapshotResponse,
|
|
9
|
+
SyncStreamInfo,
|
|
10
|
+
} from "../types";
|
|
11
|
+
import type {SendMutationBatchResult, SendMutationResult} from "./transport";
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* Thrown when the server answers 401: the bearer token is missing or expired.
|
|
15
|
+
* Distinguishable from ordinary transport errors so callers can pause and wait
|
|
16
|
+
* for the next auth change instead of retrying with the same dead token.
|
|
17
|
+
*/
|
|
18
|
+
export class AuthRequiredError extends Error {
|
|
19
|
+
constructor(message = "Authentication required") {
|
|
20
|
+
super(message);
|
|
21
|
+
this.name = "AuthRequiredError";
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
export interface FetchSnapshotPageArgs {
|
|
26
|
+
/** C2: the stream key to page (e.g. "todos|owner:123"), not a collection. */
|
|
27
|
+
stream: string;
|
|
28
|
+
/** Resume cursor (highest seq already applied); 0 = from the beginning. */
|
|
29
|
+
cursor: number;
|
|
30
|
+
/** Page size; server default applies when omitted. */
|
|
31
|
+
limit?: number;
|
|
32
|
+
/** C3: opaque legacy-stratum token echoed back from a prior page. */
|
|
33
|
+
legacyCursor?: string;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* HTTP side of the sync protocol: snapshot paging for bootstrap/reconcile and
|
|
38
|
+
* the `POST /sync/mutate` fallback used when the socket is unavailable.
|
|
39
|
+
*/
|
|
40
|
+
export interface HttpChannel {
|
|
41
|
+
fetchSnapshotPage: (args: FetchSnapshotPageArgs) => Promise<SyncSnapshotResponse>;
|
|
42
|
+
/**
|
|
43
|
+
* Point lookup for entity repair: fetch canonical server state for specific ids
|
|
44
|
+
* (`GET /sync/entities`). Used when deltas were skipped while an entity was
|
|
45
|
+
* pending-protected and the cursor advanced past the missed seq.
|
|
46
|
+
*/
|
|
47
|
+
fetchEntities: (args: {collection: string; ids: string[]}) => Promise<SyncEntitiesResponse>;
|
|
48
|
+
/**
|
|
49
|
+
* C2: the authoritative set of streams the caller currently belongs to
|
|
50
|
+
* (`GET /sync/streams`). Drives join-backfill / leave-purge diffs; 401 rejects with
|
|
51
|
+
* {@link AuthRequiredError} so a transport/auth error is never mistaken for a
|
|
52
|
+
* membership change (INV-2).
|
|
53
|
+
*/
|
|
54
|
+
fetchStreams: () => Promise<SyncStreamInfo[]>;
|
|
55
|
+
/**
|
|
56
|
+
* POST the mutation; 200 resolves `{type: "ack"}`, nack statuses
|
|
57
|
+
* (409/403/422/500 with a `{nack}` body) resolve `{type: "nack"}`, 401
|
|
58
|
+
* rejects with {@link AuthRequiredError}, anything else rejects.
|
|
59
|
+
*/
|
|
60
|
+
sendMutation: (request: SyncMutateRequest) => Promise<SendMutationResult>;
|
|
61
|
+
/**
|
|
62
|
+
* POST the batch to `/sync/mutate/batch`; resolves `{type: "results", results}`
|
|
63
|
+
* on 200/422 (both carry a `results` array — see server contract), resolves
|
|
64
|
+
* `{type: "unsupported"}` on 404 (older server with no batch route), 401
|
|
65
|
+
* rejects with {@link AuthRequiredError}, anything else rejects.
|
|
66
|
+
*/
|
|
67
|
+
sendMutationBatch?: (request: SyncMutateBatchRequest) => Promise<SendMutationBatchResult>;
|
|
68
|
+
/**
|
|
69
|
+
* Fetch the caller's per-user key material from `GET /sync/key` — feeds the
|
|
70
|
+
* default server-derived encryption KeyProvider.
|
|
71
|
+
*/
|
|
72
|
+
fetchKeyMaterial: () => Promise<string>;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/** Minimal fetch signature (global fetch is assignable; tests inject stubs). */
|
|
76
|
+
export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
|
|
77
|
+
|
|
78
|
+
export interface HttpChannelConfig {
|
|
79
|
+
/** Server origin, e.g. "http://localhost:4000". */
|
|
80
|
+
baseUrl: string;
|
|
81
|
+
/** Token source; `getToken()` is called fresh on every request (never cached). */
|
|
82
|
+
authProvider: Pick<AuthProvider, "getToken">;
|
|
83
|
+
/** Fetch implementation override for tests/SSR (defaults to global fetch). */
|
|
84
|
+
fetchImpl?: FetchLike;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/** Create an {@link HttpChannel} speaking @terreno/api's `/sync/*` routes. */
|
|
88
|
+
export const createHttpChannel = ({
|
|
89
|
+
baseUrl,
|
|
90
|
+
authProvider,
|
|
91
|
+
fetchImpl,
|
|
92
|
+
}: HttpChannelConfig): HttpChannel => {
|
|
93
|
+
const fetcher: FetchLike = fetchImpl ?? ((input, init) => globalThis.fetch(input, init));
|
|
94
|
+
|
|
95
|
+
const request = async (path: string, init?: RequestInit): Promise<Response> => {
|
|
96
|
+
const token = await authProvider.getToken();
|
|
97
|
+
const headers: Record<string, string> = {
|
|
98
|
+
Accept: "application/json",
|
|
99
|
+
...(init?.body !== undefined ? {"Content-Type": "application/json"} : {}),
|
|
100
|
+
...(token ? {Authorization: `Bearer ${token}`} : {}),
|
|
101
|
+
};
|
|
102
|
+
const response = await fetcher(`${baseUrl}${path}`, {...init, headers});
|
|
103
|
+
if (response.status === 401) {
|
|
104
|
+
throw new AuthRequiredError(`401 from ${path}`);
|
|
105
|
+
}
|
|
106
|
+
return response;
|
|
107
|
+
};
|
|
108
|
+
|
|
109
|
+
const fetchSnapshotPage = async ({
|
|
110
|
+
stream,
|
|
111
|
+
cursor,
|
|
112
|
+
limit,
|
|
113
|
+
legacyCursor,
|
|
114
|
+
}: FetchSnapshotPageArgs): Promise<SyncSnapshotResponse> => {
|
|
115
|
+
const query = new URLSearchParams({cursor: String(cursor), stream});
|
|
116
|
+
if (limit !== undefined) {
|
|
117
|
+
query.set("limit", String(limit));
|
|
118
|
+
}
|
|
119
|
+
if (legacyCursor !== undefined) {
|
|
120
|
+
query.set("legacyCursor", legacyCursor);
|
|
121
|
+
}
|
|
122
|
+
const response = await request(`/sync/snapshot?${query.toString()}`);
|
|
123
|
+
if (!response.ok) {
|
|
124
|
+
throw new Error(`Snapshot request for ${stream} failed with status ${response.status}`);
|
|
125
|
+
}
|
|
126
|
+
return (await response.json()) as SyncSnapshotResponse;
|
|
127
|
+
};
|
|
128
|
+
|
|
129
|
+
const fetchEntities = async ({
|
|
130
|
+
collection,
|
|
131
|
+
ids,
|
|
132
|
+
}: {
|
|
133
|
+
collection: string;
|
|
134
|
+
ids: string[];
|
|
135
|
+
}): Promise<SyncEntitiesResponse> => {
|
|
136
|
+
const query = new URLSearchParams({
|
|
137
|
+
collection,
|
|
138
|
+
ids: ids.join(","),
|
|
139
|
+
});
|
|
140
|
+
const response = await request(`/sync/entities?${query.toString()}`);
|
|
141
|
+
if (!response.ok) {
|
|
142
|
+
throw new Error(`Entities request for ${collection} failed with status ${response.status}`);
|
|
143
|
+
}
|
|
144
|
+
return (await response.json()) as SyncEntitiesResponse;
|
|
145
|
+
};
|
|
146
|
+
|
|
147
|
+
const fetchStreams = async (): Promise<SyncStreamInfo[]> => {
|
|
148
|
+
const response = await request("/sync/streams");
|
|
149
|
+
if (!response.ok) {
|
|
150
|
+
throw new Error(`Sync streams request failed with status ${response.status}`);
|
|
151
|
+
}
|
|
152
|
+
const body = (await response.json()) as {streams?: SyncStreamInfo[]};
|
|
153
|
+
return Array.isArray(body.streams) ? body.streams : [];
|
|
154
|
+
};
|
|
155
|
+
|
|
156
|
+
const sendMutation = async (mutation: SyncMutateRequest): Promise<SendMutationResult> => {
|
|
157
|
+
const response = await request("/sync/mutate", {
|
|
158
|
+
body: JSON.stringify(mutation),
|
|
159
|
+
method: "POST",
|
|
160
|
+
});
|
|
161
|
+
let body: unknown;
|
|
162
|
+
try {
|
|
163
|
+
body = await response.json();
|
|
164
|
+
} catch {
|
|
165
|
+
throw new Error(`Sync mutate returned a non-JSON response (status ${response.status})`);
|
|
166
|
+
}
|
|
167
|
+
const parsed = body as {ack?: SyncAck; nack?: SyncNack};
|
|
168
|
+
if (response.ok && parsed.ack) {
|
|
169
|
+
return {ack: parsed.ack, type: "ack"};
|
|
170
|
+
}
|
|
171
|
+
if (parsed.nack) {
|
|
172
|
+
return {nack: parsed.nack, type: "nack"};
|
|
173
|
+
}
|
|
174
|
+
throw new Error(`Sync mutate failed with status ${response.status}`);
|
|
175
|
+
};
|
|
176
|
+
|
|
177
|
+
const sendMutationBatch = async (
|
|
178
|
+
batch: SyncMutateBatchRequest
|
|
179
|
+
): Promise<SendMutationBatchResult> => {
|
|
180
|
+
const response = await request("/sync/mutate/batch", {
|
|
181
|
+
body: JSON.stringify(batch),
|
|
182
|
+
method: "POST",
|
|
183
|
+
});
|
|
184
|
+
if (response.status === 404) {
|
|
185
|
+
return {type: "unsupported"};
|
|
186
|
+
}
|
|
187
|
+
let body: unknown;
|
|
188
|
+
try {
|
|
189
|
+
body = await response.json();
|
|
190
|
+
} catch {
|
|
191
|
+
throw new Error(`Sync mutate batch returned a non-JSON response (status ${response.status})`);
|
|
192
|
+
}
|
|
193
|
+
const parsed = body as {results?: SendMutationResult[]};
|
|
194
|
+
if (!Array.isArray(parsed.results)) {
|
|
195
|
+
throw new Error(`Sync mutate batch failed with status ${response.status}`);
|
|
196
|
+
}
|
|
197
|
+
return {results: parsed.results, type: "results"};
|
|
198
|
+
};
|
|
199
|
+
|
|
200
|
+
const fetchKeyMaterial = async (): Promise<string> => {
|
|
201
|
+
const response = await request("/sync/key");
|
|
202
|
+
if (!response.ok) {
|
|
203
|
+
throw new Error(`Sync key request failed with status ${response.status}`);
|
|
204
|
+
}
|
|
205
|
+
const body = (await response.json()) as {keyMaterial?: string};
|
|
206
|
+
if (!body.keyMaterial) {
|
|
207
|
+
throw new Error("Sync key response is missing keyMaterial");
|
|
208
|
+
}
|
|
209
|
+
return body.keyMaterial;
|
|
210
|
+
};
|
|
211
|
+
|
|
212
|
+
return {
|
|
213
|
+
fetchEntities,
|
|
214
|
+
fetchKeyMaterial,
|
|
215
|
+
fetchSnapshotPage,
|
|
216
|
+
fetchStreams,
|
|
217
|
+
sendMutation,
|
|
218
|
+
sendMutationBatch,
|
|
219
|
+
};
|
|
220
|
+
};
|