@evolu/common 6.0.1-preview.3 → 6.0.1-preview.31
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/dist/src/Array.d.ts +69 -5
- package/dist/src/Array.d.ts.map +1 -1
- package/dist/src/Array.js +64 -5
- package/dist/src/Assert.d.ts +6 -16
- package/dist/src/Assert.d.ts.map +1 -1
- package/dist/src/Assert.js +6 -18
- package/dist/src/Brand.d.ts +75 -0
- package/dist/src/Brand.d.ts.map +1 -0
- package/dist/src/Brand.js +1 -0
- package/dist/src/Buffer.d.ts +1 -1
- package/dist/src/Buffer.d.ts.map +1 -1
- package/dist/src/Buffer.js +8 -7
- package/dist/src/Cache.d.ts +44 -0
- package/dist/src/Cache.d.ts.map +1 -0
- package/dist/src/Cache.js +52 -0
- package/dist/src/Callbacks.d.ts +45 -12
- package/dist/src/Callbacks.d.ts.map +1 -1
- package/dist/src/Callbacks.js +14 -7
- package/dist/src/Console.d.ts +31 -6
- package/dist/src/Console.d.ts.map +1 -1
- package/dist/src/Console.js +72 -9
- package/dist/src/Crypto.d.ts +61 -34
- package/dist/src/Crypto.d.ts.map +1 -1
- package/dist/src/Crypto.js +32 -45
- package/dist/src/Evolu/Db.d.ts +161 -65
- package/dist/src/Evolu/Db.d.ts.map +1 -1
- package/dist/src/Evolu/Db.js +286 -694
- package/dist/src/Evolu/Diff.d.ts +3 -3
- package/dist/src/Evolu/Diff.d.ts.map +1 -1
- package/dist/src/Evolu/Diff.js +7 -5
- package/dist/src/Evolu/Evolu.d.ts +208 -133
- package/dist/src/Evolu/Evolu.d.ts.map +1 -1
- package/dist/src/Evolu/Evolu.js +188 -183
- package/dist/src/Evolu/Internal.d.ts +0 -2
- package/dist/src/Evolu/Internal.d.ts.map +1 -1
- package/dist/src/Evolu/Internal.js +0 -2
- package/dist/src/Evolu/LocalAuth.d.ts +150 -0
- package/dist/src/Evolu/LocalAuth.d.ts.map +1 -0
- package/dist/src/Evolu/LocalAuth.js +174 -0
- package/dist/src/Evolu/Owner.d.ts +273 -120
- package/dist/src/Evolu/Owner.d.ts.map +1 -1
- package/dist/src/Evolu/Owner.js +130 -104
- package/dist/src/Evolu/Platform.d.ts +9 -7
- package/dist/src/Evolu/Platform.d.ts.map +1 -1
- package/dist/src/Evolu/Protocol.d.ts +277 -232
- package/dist/src/Evolu/Protocol.d.ts.map +1 -1
- package/dist/src/Evolu/Protocol.js +603 -378
- package/dist/src/Evolu/Public.d.ts +6 -8
- package/dist/src/Evolu/Public.d.ts.map +1 -1
- package/dist/src/Evolu/Public.js +2 -3
- package/dist/src/Evolu/PublicKysely.js +3 -3
- package/dist/src/Evolu/Query.d.ts +2 -1
- package/dist/src/Evolu/Query.d.ts.map +1 -1
- package/dist/src/Evolu/Relay.d.ts +92 -7
- package/dist/src/Evolu/Relay.d.ts.map +1 -1
- package/dist/src/Evolu/Relay.js +238 -76
- package/dist/src/Evolu/Schema.d.ts +129 -73
- package/dist/src/Evolu/Schema.d.ts.map +1 -1
- package/dist/src/Evolu/Schema.js +169 -89
- package/dist/src/Evolu/Storage.d.ts +240 -26
- package/dist/src/Evolu/Storage.d.ts.map +1 -1
- package/dist/src/Evolu/Storage.js +189 -91
- package/dist/src/Evolu/Sync.d.ts +67 -13
- package/dist/src/Evolu/Sync.d.ts.map +1 -1
- package/dist/src/Evolu/Sync.js +441 -20
- package/dist/src/Evolu/Timestamp.d.ts +85 -27
- package/dist/src/Evolu/Timestamp.d.ts.map +1 -1
- package/dist/src/Evolu/Timestamp.js +77 -18
- package/dist/src/Identicon.d.ts +35 -0
- package/dist/src/Identicon.d.ts.map +1 -0
- package/dist/src/Identicon.js +143 -0
- package/dist/src/Instances.d.ts +34 -0
- package/dist/src/Instances.d.ts.map +1 -0
- package/dist/src/Instances.js +44 -0
- package/dist/src/ManyToManyMap.d.ts +71 -10
- package/dist/src/ManyToManyMap.d.ts.map +1 -1
- package/dist/src/ManyToManyMap.js +41 -6
- package/dist/src/Number.d.ts +4 -3
- package/dist/src/Number.d.ts.map +1 -1
- package/dist/src/Number.js +5 -4
- package/dist/src/Platform.d.ts +20 -0
- package/dist/src/Platform.d.ts.map +1 -0
- package/dist/src/Platform.js +22 -0
- package/dist/src/Random.d.ts +3 -2
- package/dist/src/Random.d.ts.map +1 -1
- package/dist/src/Resources.d.ts +118 -0
- package/dist/src/Resources.d.ts.map +1 -0
- package/dist/src/Resources.js +197 -0
- package/dist/src/Result.d.ts +184 -52
- package/dist/src/Result.d.ts.map +1 -1
- package/dist/src/Result.js +30 -241
- package/dist/src/Skiplist.js +2 -1
- package/dist/src/Sqlite.d.ts +63 -5
- package/dist/src/Sqlite.d.ts.map +1 -1
- package/dist/src/Sqlite.js +110 -9
- package/dist/src/Task.d.ts +586 -0
- package/dist/src/Task.d.ts.map +1 -0
- package/dist/src/Task.js +469 -0
- package/dist/src/Time.d.ts +66 -1
- package/dist/src/Time.d.ts.map +1 -1
- package/dist/src/Time.js +99 -5
- package/dist/src/Type.d.ts +622 -340
- package/dist/src/Type.d.ts.map +1 -1
- package/dist/src/Type.js +666 -464
- package/dist/src/Types.d.ts +1 -75
- package/dist/src/Types.d.ts.map +1 -1
- package/dist/src/WebSocket.d.ts +5 -2
- package/dist/src/WebSocket.d.ts.map +1 -1
- package/dist/src/WebSocket.js +12 -18
- package/dist/src/Worker.d.ts +39 -11
- package/dist/src/Worker.d.ts.map +1 -1
- package/dist/src/Worker.js +22 -4
- package/dist/src/index.d.ts +7 -2
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +7 -2
- package/package.json +14 -13
- package/src/Array.ts +90 -11
- package/src/Assert.ts +6 -24
- package/src/Brand.ts +75 -0
- package/src/Buffer.ts +7 -7
- package/src/Cache.ts +85 -0
- package/src/Callbacks.ts +62 -22
- package/src/Console.ts +91 -11
- package/src/Crypto.ts +97 -82
- package/src/Evolu/Db.ts +517 -1020
- package/src/Evolu/Diff.ts +7 -5
- package/src/Evolu/Evolu.ts +464 -355
- package/src/Evolu/Internal.ts +0 -2
- package/src/Evolu/LocalAuth.ts +463 -0
- package/src/Evolu/Owner.ts +355 -228
- package/src/Evolu/Platform.ts +9 -9
- package/src/Evolu/Protocol.ts +859 -676
- package/src/Evolu/Public.ts +7 -14
- package/src/Evolu/PublicKysely.ts +3 -3
- package/src/Evolu/Query.ts +2 -1
- package/src/Evolu/Relay.ts +437 -93
- package/src/Evolu/Schema.ts +391 -191
- package/src/Evolu/Storage.ts +532 -135
- package/src/Evolu/Sync.ts +766 -37
- package/src/Evolu/Timestamp.ts +88 -35
- package/src/Identicon.ts +197 -0
- package/src/Instances.ts +90 -0
- package/src/ManyToManyMap.ts +124 -24
- package/src/Number.ts +6 -10
- package/src/Platform.ts +26 -0
- package/src/Random.ts +3 -2
- package/src/Resources.ts +367 -0
- package/src/Result.ts +191 -54
- package/src/Skiplist.ts +1 -1
- package/src/Sqlite.ts +122 -17
- package/src/Task.ts +901 -0
- package/src/Time.ts +180 -5
- package/src/Type.ts +1084 -727
- package/src/Types.ts +1 -77
- package/src/WebSocket.ts +27 -25
- package/src/Worker.ts +72 -23
- package/src/index.ts +7 -2
- package/dist/src/Evolu/Config.d.ts +0 -69
- package/dist/src/Evolu/Config.d.ts.map +0 -1
- package/dist/src/Evolu/Config.js +0 -9
- package/dist/src/Evolu/Kysely.d.ts +0 -6
- package/dist/src/Evolu/Kysely.d.ts.map +0 -1
- package/dist/src/Evolu/Kysely.js +0 -21
- package/dist/src/NanoId.d.ts +0 -27
- package/dist/src/NanoId.d.ts.map +0 -1
- package/dist/src/NanoId.js +0 -6
- package/dist/src/Promise.d.ts +0 -180
- package/dist/src/Promise.d.ts.map +0 -1
- package/dist/src/Promise.js +0 -176
- package/src/Evolu/Config.ts +0 -83
- package/src/Evolu/Kysely.ts +0 -38
- package/src/NanoId.ts +0 -39
- package/src/Promise.ts +0 -295
package/src/Evolu/Db.ts
CHANGED
|
@@ -1,73 +1,44 @@
|
|
|
1
|
-
import {
|
|
2
|
-
isNonEmptyArray,
|
|
3
|
-
isNonEmptyReadonlyArray,
|
|
4
|
-
NonEmptyReadonlyArray,
|
|
5
|
-
} from "../Array.js";
|
|
6
|
-
import { assert, assertNonEmptyReadonlyArray } from "../Assert.js";
|
|
1
|
+
import { isNonEmptyArray, NonEmptyReadonlyArray } from "../Array.js";
|
|
7
2
|
import { CallbackId } from "../Callbacks.js";
|
|
8
|
-
import { ConsoleDep } from "../Console.js";
|
|
3
|
+
import { ConsoleConfig, ConsoleDep } from "../Console.js";
|
|
9
4
|
import {
|
|
10
|
-
CreateMnemonicDep,
|
|
11
|
-
CreateRandomBytesDep,
|
|
12
5
|
createSymmetricCrypto,
|
|
6
|
+
EncryptionKey,
|
|
7
|
+
RandomBytesDep,
|
|
13
8
|
SymmetricCryptoDecryptError,
|
|
14
|
-
SymmetricCryptoDep,
|
|
15
9
|
} from "../Crypto.js";
|
|
16
|
-
import { eqArrayNumber } from "../Eq.js";
|
|
17
10
|
import { TransferableError } from "../Error.js";
|
|
18
|
-
import { constFalse, exhaustiveCheck } from "../Function.js";
|
|
19
|
-
import { NanoIdLibDep } from "../NanoId.js";
|
|
20
|
-
import { objectToEntries } from "../Object.js";
|
|
21
11
|
import { RandomDep } from "../Random.js";
|
|
22
|
-
import {
|
|
23
|
-
import { err, ok, Result } from "../Result.js";
|
|
12
|
+
import { ok, Result } from "../Result.js";
|
|
24
13
|
import {
|
|
25
14
|
createSqlite,
|
|
26
15
|
CreateSqliteDriverDep,
|
|
27
16
|
explainSqliteQueryPlan,
|
|
28
|
-
SafeSql,
|
|
29
17
|
sql,
|
|
30
18
|
SqliteDep,
|
|
31
19
|
SqliteError,
|
|
32
|
-
SqliteQuery,
|
|
33
|
-
SqliteRow,
|
|
34
|
-
SqliteValue,
|
|
35
20
|
} from "../Sqlite.js";
|
|
36
21
|
import { TimeDep } from "../Time.js";
|
|
37
|
-
import { Id, Mnemonic,
|
|
22
|
+
import { Id, Mnemonic, SimpleName } from "../Type.js";
|
|
23
|
+
import { CreateWebSocketDep } from "../WebSocket.js";
|
|
38
24
|
import {
|
|
39
|
-
|
|
25
|
+
createInitializedWorkerWithHandlers,
|
|
26
|
+
MessageHandlers,
|
|
40
27
|
Worker,
|
|
41
|
-
WorkerPostMessageDep,
|
|
42
28
|
} from "../Worker.js";
|
|
43
|
-
import { Config } from "./Config.js";
|
|
44
29
|
import { makePatches, QueryPatches } from "./Diff.js";
|
|
45
30
|
import {
|
|
46
31
|
AppOwner,
|
|
47
32
|
createAppOwner,
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
33
|
+
createOwnerSecret,
|
|
34
|
+
createOwnerWebSocketTransport,
|
|
35
|
+
mnemonicToOwnerSecret,
|
|
36
|
+
OwnerEncryptionKey,
|
|
37
|
+
OwnerId,
|
|
38
|
+
OwnerTransport,
|
|
39
|
+
OwnerWriteKey,
|
|
51
40
|
} from "./Owner.js";
|
|
52
|
-
import {
|
|
53
|
-
applyProtocolMessageAsClient,
|
|
54
|
-
Base64Url256,
|
|
55
|
-
BinaryId,
|
|
56
|
-
binaryIdToId,
|
|
57
|
-
BinaryOwnerId,
|
|
58
|
-
CrdtMessage,
|
|
59
|
-
createProtocolMessageForSync,
|
|
60
|
-
createProtocolMessageFromCrdtMessages,
|
|
61
|
-
DbChange,
|
|
62
|
-
decryptAndDecodeDbChange,
|
|
63
|
-
encodeAndEncryptDbChange,
|
|
64
|
-
idToBinaryId,
|
|
65
|
-
ownerIdToBinaryOwnerId,
|
|
66
|
-
ProtocolError,
|
|
67
|
-
protocolVersion,
|
|
68
|
-
Storage,
|
|
69
|
-
StorageDep,
|
|
70
|
-
} from "./Protocol.js";
|
|
41
|
+
import { ProtocolError, protocolVersion } from "./Protocol.js";
|
|
71
42
|
import {
|
|
72
43
|
createQueryRowsCache,
|
|
73
44
|
deserializeQuery,
|
|
@@ -76,39 +47,171 @@ import {
|
|
|
76
47
|
QueryRowsCache,
|
|
77
48
|
} from "./Query.js";
|
|
78
49
|
import {
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
50
|
+
DbSchema,
|
|
51
|
+
ensureDbSchema,
|
|
52
|
+
getDbSchema,
|
|
53
|
+
MutationChange,
|
|
54
|
+
} from "./Schema.js";
|
|
55
|
+
import { createBaseSqliteStorageTables } from "./Storage.js";
|
|
56
|
+
import {
|
|
57
|
+
applyLocalOnlyChange,
|
|
58
|
+
Clock,
|
|
59
|
+
createClock,
|
|
60
|
+
createSync,
|
|
61
|
+
SyncDep,
|
|
62
|
+
SyncOwner,
|
|
63
|
+
} from "./Sync.js";
|
|
84
64
|
import {
|
|
85
|
-
Millis,
|
|
86
|
-
receiveTimestamp,
|
|
87
|
-
sendTimestamp,
|
|
88
65
|
Timestamp,
|
|
89
|
-
|
|
90
|
-
TimestampCounterOverflowError,
|
|
91
|
-
TimestampDriftError,
|
|
66
|
+
TimestampConfig,
|
|
92
67
|
TimestampError,
|
|
93
68
|
TimestampString,
|
|
94
69
|
timestampStringToTimestamp,
|
|
95
|
-
TimestampTimeOutOfRangeError,
|
|
96
|
-
timestampToBinaryTimestamp,
|
|
97
70
|
timestampToTimestampString,
|
|
98
71
|
} from "./Timestamp.js";
|
|
99
72
|
|
|
100
|
-
export interface
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
73
|
+
export interface DbConfig extends ConsoleConfig, TimestampConfig {
|
|
74
|
+
/**
|
|
75
|
+
* The name of the Evolu instance. Evolu is multitenant - it can run multiple
|
|
76
|
+
* instances concurrently. Each instance must have a unique name.
|
|
77
|
+
*
|
|
78
|
+
* The instance name is used as the SQLite database filename for persistent
|
|
79
|
+
* storage, ensuring that database files are separated and invisible to each
|
|
80
|
+
* other.
|
|
81
|
+
*
|
|
82
|
+
* The default value is: `Evolu`.
|
|
83
|
+
*
|
|
84
|
+
* ### Example
|
|
85
|
+
*
|
|
86
|
+
* ```ts
|
|
87
|
+
* // name: SimpleName.orThrow("MyApp")
|
|
88
|
+
* ```
|
|
89
|
+
*/
|
|
90
|
+
readonly name: SimpleName;
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* Transport configuration for data sync and backup. Supports single transport
|
|
94
|
+
* or multiple transports simultaneously for redundancy.
|
|
95
|
+
*
|
|
96
|
+
* **Redundancy:** The ideal setup uses at least two completely independent
|
|
97
|
+
* relays - for example, a home relay and a geographically separate relay.
|
|
98
|
+
* Data is sent to both relays simultaneously, providing true redundancy
|
|
99
|
+
* similar to using two independent clouds. This eliminates vendor lock-in and
|
|
100
|
+
* ensures your app continues working regardless of circumstances - whether
|
|
101
|
+
* home relay hardware is stolen or a remote relay provider shuts down.
|
|
102
|
+
*
|
|
103
|
+
* Currently supports:
|
|
104
|
+
*
|
|
105
|
+
* - WebSocket: Real-time bidirectional communication with relay servers
|
|
106
|
+
*
|
|
107
|
+
* Empty transports create local-only instances. Transports can be dynamically
|
|
108
|
+
* added and removed for any owner (including {@link AppOwner}) via
|
|
109
|
+
* {@link Evolu#useOwner}.
|
|
110
|
+
*
|
|
111
|
+
* Use {@link createOwnerWebSocketTransport} to create WebSocket transport
|
|
112
|
+
* configurations with proper URL formatting and {@link OwnerId} inclusion. The
|
|
113
|
+
* {@link OwnerId} in the URL enables relay authentication, allowing relay
|
|
114
|
+
* servers to control access (e.g., for paid tiers or private instances).
|
|
115
|
+
*
|
|
116
|
+
* The default value is:
|
|
117
|
+
*
|
|
118
|
+
* `{ type: "WebSocket", url: "wss://free.evoluhq.com" }`.
|
|
119
|
+
*
|
|
120
|
+
* ### Example
|
|
121
|
+
*
|
|
122
|
+
* ```ts
|
|
123
|
+
* // Single WebSocket relay
|
|
124
|
+
* transports: [{ type: "WebSocket", url: "wss://relay1.example.com" }];
|
|
125
|
+
*
|
|
126
|
+
* // Multiple WebSocket relays for redundancy
|
|
127
|
+
* transports: [
|
|
128
|
+
* { type: "WebSocket", url: "wss://relay1.example.com" },
|
|
129
|
+
* { type: "WebSocket", url: "wss://relay2.example.com" },
|
|
130
|
+
* { type: "WebSocket", url: "wss://relay3.example.com" },
|
|
131
|
+
* ];
|
|
132
|
+
*
|
|
133
|
+
* // Local-only instance (no sync) - useful for device settings or when relay
|
|
134
|
+
* // URL will be provided later (e.g., after authentication), allowing users
|
|
135
|
+
* // to work offline before the app connects
|
|
136
|
+
* transports: [];
|
|
137
|
+
*
|
|
138
|
+
* // Using createOwnerWebSocketTransport helper for relay authentication
|
|
139
|
+
* transports: [
|
|
140
|
+
* createOwnerWebSocketTransport({
|
|
141
|
+
* url: "ws://localhost:4000",
|
|
142
|
+
* ownerId,
|
|
143
|
+
* }),
|
|
144
|
+
* ];
|
|
145
|
+
* ```
|
|
146
|
+
*/
|
|
147
|
+
readonly transports: ReadonlyArray<OwnerTransport>;
|
|
148
|
+
|
|
149
|
+
/**
|
|
150
|
+
* External AppOwner to use when creating Evolu instance. Use this when you
|
|
151
|
+
* want to manage AppOwner creation and persistence externally (e.g., with
|
|
152
|
+
* your own authentication system). If omitted, Evolu will automatically
|
|
153
|
+
* create and persist an AppOwner locally.
|
|
154
|
+
*
|
|
155
|
+
* For device-specific settings and account management state, we can use a
|
|
156
|
+
* separate local-only Evolu instance via `transports: []`.
|
|
157
|
+
*
|
|
158
|
+
* ### Example
|
|
159
|
+
*
|
|
160
|
+
* ```ts
|
|
161
|
+
* const ConfigId = id("Config");
|
|
162
|
+
* type ConfigId = typeof ConfigId.Type;
|
|
163
|
+
*
|
|
164
|
+
* const DeviceSchema = {
|
|
165
|
+
* config: {
|
|
166
|
+
* id: ConfigId,
|
|
167
|
+
* key: NonEmptyString50,
|
|
168
|
+
* value: NonEmptyString50,
|
|
169
|
+
* },
|
|
170
|
+
* };
|
|
171
|
+
*
|
|
172
|
+
* // Local-only instance for device settings (no sync)
|
|
173
|
+
* const deviceEvolu = createEvolu(evoluReactWebDeps)(DeviceSchema, {
|
|
174
|
+
* name: SimpleName.orThrow("MyApp-Device"),
|
|
175
|
+
* transports: [], // No sync - stays local to device
|
|
176
|
+
* });
|
|
177
|
+
*
|
|
178
|
+
* // Main synced instance for user data
|
|
179
|
+
* const evolu = createEvolu(evoluReactWebDeps)(MainSchema, {
|
|
180
|
+
* name: SimpleName.orThrow("MyApp"),
|
|
181
|
+
* // Default transports for sync
|
|
182
|
+
* });
|
|
183
|
+
* ```
|
|
184
|
+
*/
|
|
185
|
+
readonly externalAppOwner?: AppOwner;
|
|
186
|
+
|
|
187
|
+
/**
|
|
188
|
+
* Use in-memory SQLite database instead of persistent storage. Useful for
|
|
189
|
+
* testing or temporary data that doesn't need persistence.
|
|
190
|
+
*
|
|
191
|
+
* In-memory databases exist only in RAM and are completely destroyed when the
|
|
192
|
+
* process ends, making them forensically safe for sensitive data.
|
|
193
|
+
*
|
|
194
|
+
* The default value is: `false`.
|
|
195
|
+
*/
|
|
196
|
+
readonly inMemory?: boolean;
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* Encryption key for the SQLite database.
|
|
200
|
+
*
|
|
201
|
+
* Note: If an unencrypted SQLite database already exists and you provide an
|
|
202
|
+
* encryptionKey, SQLite will throw an error.
|
|
203
|
+
*
|
|
204
|
+
* @experimental
|
|
205
|
+
*/
|
|
206
|
+
readonly encryptionKey?: EncryptionKey;
|
|
108
207
|
}
|
|
109
208
|
|
|
110
|
-
export const
|
|
111
|
-
|
|
209
|
+
export const defaultDbConfig: DbConfig = {
|
|
210
|
+
name: SimpleName.orThrow("Evolu"),
|
|
211
|
+
transports: [{ type: "WebSocket", url: "wss://free.evoluhq.com" }],
|
|
212
|
+
maxDrift: 5 * 60 * 1000,
|
|
213
|
+
enableLogging: false,
|
|
214
|
+
};
|
|
112
215
|
|
|
113
216
|
export type DbWorker = Worker<DbWorkerInput, DbWorkerOutput>;
|
|
114
217
|
|
|
@@ -121,14 +224,16 @@ export interface CreateDbWorkerDep {
|
|
|
121
224
|
export type DbWorkerInput =
|
|
122
225
|
| {
|
|
123
226
|
readonly type: "init";
|
|
124
|
-
readonly config:
|
|
227
|
+
readonly config: DbConfig;
|
|
125
228
|
readonly dbSchema: DbSchema;
|
|
126
|
-
|
|
229
|
+
}
|
|
230
|
+
| {
|
|
231
|
+
readonly type: "getAppOwner";
|
|
127
232
|
}
|
|
128
233
|
| {
|
|
129
234
|
readonly type: "mutate";
|
|
130
235
|
readonly tabId: Id;
|
|
131
|
-
readonly changes: NonEmptyReadonlyArray<
|
|
236
|
+
readonly changes: NonEmptyReadonlyArray<MutationChange>;
|
|
132
237
|
readonly onCompleteIds: ReadonlyArray<CallbackId>;
|
|
133
238
|
readonly subscribedQueries: ReadonlyArray<Query>;
|
|
134
239
|
}
|
|
@@ -153,30 +258,35 @@ export type DbWorkerInput =
|
|
|
153
258
|
| {
|
|
154
259
|
readonly type: "export";
|
|
155
260
|
readonly onCompleteId: CallbackId;
|
|
261
|
+
}
|
|
262
|
+
| {
|
|
263
|
+
readonly type: "useOwner";
|
|
264
|
+
readonly use: boolean;
|
|
265
|
+
readonly owner: SyncOwner;
|
|
156
266
|
};
|
|
157
267
|
|
|
158
268
|
export type DbWorkerOutput =
|
|
159
|
-
| {
|
|
160
|
-
readonly type: "onInit";
|
|
161
|
-
readonly owner: AppOwner;
|
|
162
|
-
}
|
|
163
269
|
| {
|
|
164
270
|
readonly type: "onError";
|
|
165
271
|
readonly error:
|
|
272
|
+
| ProtocolError
|
|
166
273
|
| SqliteError
|
|
167
|
-
|
|
|
274
|
+
| SymmetricCryptoDecryptError
|
|
168
275
|
| TimestampError
|
|
169
|
-
|
|
|
170
|
-
|
|
276
|
+
| TransferableError;
|
|
277
|
+
}
|
|
278
|
+
| {
|
|
279
|
+
readonly type: "onGetAppOwner";
|
|
280
|
+
readonly appOwner: AppOwner;
|
|
171
281
|
}
|
|
172
282
|
| {
|
|
173
|
-
readonly type: "
|
|
283
|
+
readonly type: "onQueryPatches";
|
|
174
284
|
readonly tabId: Id;
|
|
175
|
-
readonly
|
|
285
|
+
readonly queryPatches: ReadonlyArray<QueryPatches>;
|
|
176
286
|
readonly onCompleteIds: ReadonlyArray<CallbackId>;
|
|
177
287
|
}
|
|
178
288
|
| {
|
|
179
|
-
readonly type: "
|
|
289
|
+
readonly type: "refreshQueries";
|
|
180
290
|
readonly tabId?: Id;
|
|
181
291
|
}
|
|
182
292
|
| {
|
|
@@ -190,598 +300,239 @@ export type DbWorkerOutput =
|
|
|
190
300
|
readonly file: Uint8Array;
|
|
191
301
|
};
|
|
192
302
|
|
|
193
|
-
export type DbWorkerPlatformDeps =
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
303
|
+
export type DbWorkerPlatformDeps = ConsoleDep &
|
|
304
|
+
CreateSqliteDriverDep &
|
|
305
|
+
CreateWebSocketDep &
|
|
306
|
+
RandomBytesDep &
|
|
197
307
|
RandomDep &
|
|
198
|
-
|
|
199
|
-
CreateMnemonicDep &
|
|
200
|
-
CreateRandomBytesDep;
|
|
308
|
+
TimeDep;
|
|
201
309
|
|
|
202
310
|
type DbWorkerDeps = Omit<
|
|
203
311
|
DbWorkerPlatformDeps,
|
|
204
|
-
keyof CreateSqliteDriverDep | keyof
|
|
312
|
+
keyof CreateSqliteDriverDep | keyof CreateWebSocketDep
|
|
205
313
|
> &
|
|
314
|
+
GetQueryRowsCacheDep &
|
|
315
|
+
PostMessageDep &
|
|
206
316
|
SqliteDep &
|
|
207
317
|
SyncDep &
|
|
208
|
-
|
|
209
|
-
SymmetricCryptoDep &
|
|
210
|
-
PostMessageDep &
|
|
211
|
-
OwnerRowRefDep &
|
|
212
|
-
GetQueryRowsCacheDep &
|
|
213
|
-
ClientStorageDep;
|
|
318
|
+
AppOwnerDep;
|
|
214
319
|
|
|
215
|
-
|
|
320
|
+
interface GetQueryRowsCacheDep {
|
|
321
|
+
readonly getQueryRowsCache: (tabId: Id) => QueryRowsCache;
|
|
322
|
+
}
|
|
216
323
|
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
readonly ownerRowRef: Ref<OwnerRow>;
|
|
324
|
+
export interface PostMessageDep {
|
|
325
|
+
readonly postMessage: (message: DbWorkerOutput) => void;
|
|
220
326
|
}
|
|
221
327
|
|
|
222
|
-
interface
|
|
223
|
-
readonly
|
|
328
|
+
export interface AppOwnerDep {
|
|
329
|
+
readonly appOwner: AppOwner;
|
|
224
330
|
}
|
|
225
331
|
|
|
226
332
|
export const createDbWorkerForPlatform = (
|
|
227
333
|
platformDeps: DbWorkerPlatformDeps,
|
|
228
|
-
): DbWorker =>
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
334
|
+
): DbWorker =>
|
|
335
|
+
createInitializedWorkerWithHandlers<
|
|
336
|
+
DbWorkerInput,
|
|
337
|
+
DbWorkerOutput,
|
|
338
|
+
DbWorkerDeps
|
|
339
|
+
>({ init: createDbWorkerDeps(platformDeps), handlers });
|
|
340
|
+
|
|
341
|
+
const createDbWorkerDeps =
|
|
342
|
+
(platformDeps: DbWorkerPlatformDeps) =>
|
|
343
|
+
async (
|
|
344
|
+
initMessage: Extract<DbWorkerInput, { type: "init" }>,
|
|
345
|
+
postMessage: (msg: DbWorkerOutput) => void,
|
|
346
|
+
): Promise<DbWorkerDeps | null> => {
|
|
347
|
+
platformDeps.console.enabled = initMessage.config.enableLogging ?? false;
|
|
348
|
+
|
|
349
|
+
const sqliteResult = await createSqlite(platformDeps)(
|
|
350
|
+
initMessage.config.name,
|
|
351
|
+
{
|
|
352
|
+
memory: initMessage.config.inMemory ?? false,
|
|
353
|
+
encryptionKey: initMessage.config.encryptionKey ?? undefined,
|
|
354
|
+
},
|
|
355
|
+
);
|
|
356
|
+
if (!sqliteResult.ok) {
|
|
357
|
+
postMessage({ type: "onError", error: sqliteResult.error });
|
|
358
|
+
return null;
|
|
235
359
|
}
|
|
236
|
-
|
|
237
|
-
};
|
|
238
|
-
|
|
239
|
-
return createInitializedWorker<DbWorkerInput, DbWorkerOutput, DbWorkerDeps>({
|
|
240
|
-
init: async (initMessage, postMessage, safeHandler) => {
|
|
241
|
-
platformDeps.console.enabled = initMessage.config.enableLogging ?? false;
|
|
242
|
-
|
|
243
|
-
const sqliteResult = await createSqlite(platformDeps)(
|
|
244
|
-
initMessage.config.name,
|
|
245
|
-
);
|
|
246
|
-
|
|
247
|
-
if (!sqliteResult.ok) {
|
|
248
|
-
postMessage({ type: "onError", error: sqliteResult.error });
|
|
249
|
-
return null;
|
|
250
|
-
}
|
|
251
|
-
const sqlite = sqliteResult.value;
|
|
360
|
+
const sqlite = sqliteResult.value;
|
|
252
361
|
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
362
|
+
const deps = sqlite.transaction(() => {
|
|
363
|
+
const currentDbSchema = getDbSchema({ sqlite })();
|
|
364
|
+
if (!currentDbSchema.ok) return currentDbSchema;
|
|
256
365
|
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
currentDbSchema.value,
|
|
260
|
-
);
|
|
261
|
-
if (!ensureDbSchemaResult.ok) return ensureDbSchemaResult;
|
|
366
|
+
let appOwner: AppOwner;
|
|
367
|
+
let clock: Clock;
|
|
262
368
|
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
if (!maybeMigrateToVersion0Result.ok)
|
|
267
|
-
return maybeMigrateToVersion0Result;
|
|
268
|
-
|
|
269
|
-
const ownerExists = currentDbSchema.value.tables.some(
|
|
270
|
-
(table) => table.name === "evolu_owner",
|
|
271
|
-
);
|
|
369
|
+
const dbIsInitialized = currentDbSchema.value.tables.some(
|
|
370
|
+
(table) => table.name === "evolu_version",
|
|
371
|
+
);
|
|
272
372
|
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
:
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
373
|
+
if (dbIsInitialized) {
|
|
374
|
+
const currentVersion = sqlite.exec<{
|
|
375
|
+
protocolVersion: number;
|
|
376
|
+
}>(sql`select protocolVersion from evolu_version limit 1;`);
|
|
377
|
+
if (!currentVersion.ok) return currentVersion;
|
|
378
|
+
|
|
379
|
+
// TODO: Handle version migrations here if needed
|
|
380
|
+
// const [{ protocolVersion }] = protocolVersionResult.value.rows;
|
|
381
|
+
// if (protocolVersion < currentProtocolVersion) {
|
|
382
|
+
// const migrateResult = migrateDatabase({ sqlite })(
|
|
383
|
+
// protocolVersion,
|
|
384
|
+
// currentProtocolVersion
|
|
385
|
+
// );
|
|
386
|
+
// if (!migrateResult.ok) return migrateResult;
|
|
387
|
+
// }
|
|
388
|
+
|
|
389
|
+
const configResult = sqlite.exec<{
|
|
390
|
+
clock: TimestampString;
|
|
391
|
+
appOwnerId: OwnerId;
|
|
392
|
+
appOwnerEncryptionKey: OwnerEncryptionKey;
|
|
393
|
+
appOwnerWriteKey: OwnerWriteKey;
|
|
394
|
+
appOwnerMnemonic: Mnemonic | null;
|
|
395
|
+
}>(sql`
|
|
396
|
+
select
|
|
397
|
+
clock,
|
|
398
|
+
appOwnerId,
|
|
399
|
+
appOwnerEncryptionKey,
|
|
400
|
+
appOwnerWriteKey,
|
|
401
|
+
appOwnerMnemonic
|
|
402
|
+
from evolu_config
|
|
403
|
+
limit 1;
|
|
404
|
+
`);
|
|
405
|
+
if (!configResult.ok) return configResult;
|
|
292
406
|
|
|
293
|
-
const
|
|
294
|
-
onStorageError: (error) => {
|
|
295
|
-
postMessage({ type: "onError", error });
|
|
296
|
-
},
|
|
297
|
-
});
|
|
298
|
-
if (!storage.ok) return storage;
|
|
407
|
+
const [config] = configResult.value.rows;
|
|
299
408
|
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
409
|
+
appOwner = {
|
|
410
|
+
type: "AppOwner",
|
|
411
|
+
id: config.appOwnerId,
|
|
412
|
+
encryptionKey: config.appOwnerEncryptionKey,
|
|
413
|
+
writeKey: config.appOwnerWriteKey,
|
|
414
|
+
mnemonic: config.appOwnerMnemonic,
|
|
303
415
|
};
|
|
304
416
|
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
if (!ownerExists && isNonEmptyReadonlyArray(initMessage.initialData)) {
|
|
314
|
-
const result = applyChanges(depsWithoutSync)(initMessage.initialData);
|
|
315
|
-
if (!result.ok) return result;
|
|
316
|
-
}
|
|
317
|
-
|
|
318
|
-
postMessage({ type: "onInit", owner: appOwner });
|
|
319
|
-
|
|
320
|
-
const sync = platformDeps.createSync(platformDeps)({
|
|
321
|
-
...initMessage.config,
|
|
322
|
-
onOpen: safeHandler(handleSyncOpen(depsWithoutSync)),
|
|
323
|
-
onMessage: safeHandler(createHandleSyncMessage(depsWithoutSync)),
|
|
324
|
-
});
|
|
417
|
+
clock = createClock({ ...platformDeps, sqlite })(
|
|
418
|
+
timestampStringToTimestamp(config.clock),
|
|
419
|
+
);
|
|
420
|
+
} else {
|
|
421
|
+
appOwner =
|
|
422
|
+
initMessage.config.externalAppOwner ??
|
|
423
|
+
createAppOwner(createOwnerSecret(platformDeps));
|
|
325
424
|
|
|
326
|
-
|
|
327
|
-
});
|
|
425
|
+
clock = createClock({ ...platformDeps, sqlite })();
|
|
328
426
|
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
return null;
|
|
427
|
+
const result = initializeDb({ sqlite })(appOwner, clock.get());
|
|
428
|
+
if (!result.ok) return result;
|
|
332
429
|
}
|
|
333
430
|
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
case "mutate": {
|
|
340
|
-
const mutate = deps.sqlite.transaction(() => {
|
|
341
|
-
const toSyncChanges = [];
|
|
342
|
-
const localOnlyChanges = [];
|
|
343
|
-
|
|
344
|
-
for (const change of message.changes) {
|
|
345
|
-
// Table name starting with '_' is local-only (not synced).
|
|
346
|
-
if (change.table.startsWith("_")) localOnlyChanges.push(change);
|
|
347
|
-
else toSyncChanges.push(change);
|
|
348
|
-
}
|
|
349
|
-
|
|
350
|
-
for (const change of localOnlyChanges) {
|
|
351
|
-
if (
|
|
352
|
-
"isDeleted" in change.values &&
|
|
353
|
-
change.values.isDeleted === 1
|
|
354
|
-
) {
|
|
355
|
-
const result = deps.sqlite.exec(sql`
|
|
356
|
-
delete from ${sql.identifier(change.table)}
|
|
357
|
-
where id = ${change.id};
|
|
358
|
-
`);
|
|
359
|
-
if (!result.ok) return result;
|
|
360
|
-
} else {
|
|
361
|
-
const millis = Millis.from(deps.time.now());
|
|
362
|
-
if (!millis.ok) {
|
|
363
|
-
return err<TimestampTimeOutOfRangeError>({
|
|
364
|
-
type: "TimestampTimeOutOfRangeError",
|
|
365
|
-
});
|
|
366
|
-
}
|
|
367
|
-
const date = new Date(millis.value).toISOString();
|
|
368
|
-
for (const [column, value] of objectToEntries(change.values)) {
|
|
369
|
-
const result = deps.sqlite.exec(sql.prepared`
|
|
370
|
-
insert into ${sql.identifier(change.table)}
|
|
371
|
-
("id", ${sql.identifier(column)}, createdAt, updatedAt)
|
|
372
|
-
values (${change.id}, ${value}, ${date}, ${date})
|
|
373
|
-
on conflict ("id") do update
|
|
374
|
-
set
|
|
375
|
-
${sql.identifier(column)} = ${value},
|
|
376
|
-
updatedAt = ${date};
|
|
377
|
-
`);
|
|
378
|
-
if (!result.ok) return result;
|
|
379
|
-
}
|
|
380
|
-
}
|
|
381
|
-
}
|
|
382
|
-
|
|
383
|
-
/**
|
|
384
|
-
* We don't have to wait for the transaction to end because changes
|
|
385
|
-
* are idempotent, so there is no reason why they should fail. We
|
|
386
|
-
* want to call onChange ASAP.
|
|
387
|
-
*/
|
|
388
|
-
const onChange = () => {
|
|
389
|
-
deps.console.log("[db]", "onChange", {
|
|
390
|
-
subscribedQueries: message.subscribedQueries,
|
|
391
|
-
});
|
|
392
|
-
const patches = loadQueries(deps)(
|
|
393
|
-
message.tabId,
|
|
394
|
-
message.subscribedQueries,
|
|
395
|
-
);
|
|
396
|
-
if (!patches.ok) {
|
|
397
|
-
deps.postMessage({ type: "onError", error: patches.error });
|
|
398
|
-
return;
|
|
399
|
-
}
|
|
400
|
-
// Notify the tab that performed the mutation.
|
|
401
|
-
deps.postMessage({
|
|
402
|
-
type: "onChange",
|
|
403
|
-
tabId: message.tabId,
|
|
404
|
-
patches: patches.value,
|
|
405
|
-
onCompleteIds: message.onCompleteIds,
|
|
406
|
-
});
|
|
407
|
-
// Notify other tabs to refresh their queries.
|
|
408
|
-
deps.postMessage({ type: "onReceive", tabId: message.tabId });
|
|
409
|
-
};
|
|
410
|
-
|
|
411
|
-
if (!isNonEmptyArray(toSyncChanges)) {
|
|
412
|
-
onChange();
|
|
413
|
-
return ok();
|
|
414
|
-
}
|
|
415
|
-
|
|
416
|
-
const messages = applyChanges(deps)(toSyncChanges, onChange);
|
|
417
|
-
if (!messages.ok) return messages;
|
|
418
|
-
|
|
419
|
-
const owner = deps.ownerRowRef.get();
|
|
420
|
-
// TODO: Check owner whether it's allowed to write, return an
|
|
421
|
-
// error if not.
|
|
422
|
-
if (owner.writeKey == null) {
|
|
423
|
-
return ok();
|
|
424
|
-
}
|
|
425
|
-
|
|
426
|
-
const protocolMessage = createProtocolMessageFromCrdtMessages(deps)(
|
|
427
|
-
owner as OwnerWithWriteAccess,
|
|
428
|
-
messages.value,
|
|
429
|
-
);
|
|
430
|
-
|
|
431
|
-
deps.console.log(
|
|
432
|
-
"[db]",
|
|
433
|
-
"send data message",
|
|
434
|
-
messages.value,
|
|
435
|
-
protocolMessage,
|
|
436
|
-
);
|
|
437
|
-
deps.sync.send(protocolMessage);
|
|
438
|
-
|
|
439
|
-
return ok();
|
|
440
|
-
});
|
|
441
|
-
|
|
442
|
-
if (!mutate.ok) {
|
|
443
|
-
deps.postMessage({ type: "onError", error: mutate.error });
|
|
444
|
-
return;
|
|
445
|
-
}
|
|
446
|
-
|
|
447
|
-
break;
|
|
448
|
-
}
|
|
449
|
-
|
|
450
|
-
case "query": {
|
|
451
|
-
const patches = loadQueries(deps)(message.tabId, message.queries);
|
|
452
|
-
|
|
453
|
-
if (!patches.ok) {
|
|
454
|
-
deps.postMessage({ type: "onError", error: patches.error });
|
|
455
|
-
return;
|
|
456
|
-
}
|
|
457
|
-
|
|
458
|
-
deps.postMessage({
|
|
459
|
-
type: "onChange",
|
|
460
|
-
tabId: message.tabId,
|
|
461
|
-
patches: patches.value,
|
|
462
|
-
onCompleteIds: [],
|
|
463
|
-
});
|
|
464
|
-
break;
|
|
465
|
-
}
|
|
466
|
-
|
|
467
|
-
case "reset": {
|
|
468
|
-
const resetResult = deps.sqlite.transaction(() => {
|
|
469
|
-
const dropAllTablesResult = dropAllTables(deps);
|
|
470
|
-
if (!dropAllTablesResult.ok) return dropAllTablesResult;
|
|
471
|
-
|
|
472
|
-
if (message.restore) {
|
|
473
|
-
const dbSchema = getDbSchema(deps)();
|
|
474
|
-
if (!dbSchema.ok) return dbSchema;
|
|
475
|
-
|
|
476
|
-
const ensureDbSchemaResult = ensureDbSchema(deps)(
|
|
477
|
-
message.restore.dbSchema,
|
|
478
|
-
dbSchema.value,
|
|
479
|
-
);
|
|
480
|
-
if (!ensureDbSchemaResult.ok) return ensureDbSchemaResult;
|
|
481
|
-
|
|
482
|
-
const initializeDbResult = initializeDb(deps)(
|
|
483
|
-
message.restore.mnemonic,
|
|
484
|
-
);
|
|
485
|
-
if (!initializeDbResult.ok) return initializeDbResult;
|
|
486
|
-
}
|
|
487
|
-
return ok();
|
|
488
|
-
});
|
|
489
|
-
|
|
490
|
-
if (!resetResult.ok) {
|
|
491
|
-
deps.postMessage({ type: "onError", error: resetResult.error });
|
|
492
|
-
return;
|
|
493
|
-
}
|
|
494
|
-
|
|
495
|
-
deps.postMessage({
|
|
496
|
-
type: "onReset",
|
|
497
|
-
onCompleteId: message.onCompleteId,
|
|
498
|
-
reload: message.reload,
|
|
499
|
-
});
|
|
500
|
-
|
|
501
|
-
break;
|
|
502
|
-
}
|
|
503
|
-
|
|
504
|
-
case "ensureDbSchema": {
|
|
505
|
-
const ensureSchema = deps.sqlite.transaction(() => {
|
|
506
|
-
const dbSchema = getDbSchema(deps)();
|
|
507
|
-
if (!dbSchema.ok) return dbSchema;
|
|
508
|
-
|
|
509
|
-
const ensureDbSchemaResult = ensureDbSchema(deps)(
|
|
510
|
-
message.dbSchema,
|
|
511
|
-
dbSchema.value,
|
|
512
|
-
);
|
|
513
|
-
if (!ensureDbSchemaResult.ok) return ensureDbSchemaResult;
|
|
514
|
-
|
|
515
|
-
return ok();
|
|
516
|
-
});
|
|
517
|
-
|
|
518
|
-
if (!ensureSchema.ok) {
|
|
519
|
-
deps.postMessage({ type: "onError", error: ensureSchema.error });
|
|
520
|
-
return;
|
|
521
|
-
}
|
|
522
|
-
break;
|
|
523
|
-
}
|
|
431
|
+
const result = ensureDbSchema({ sqlite })(
|
|
432
|
+
initMessage.dbSchema,
|
|
433
|
+
currentDbSchema.value,
|
|
434
|
+
);
|
|
435
|
+
if (!result.ok) return result;
|
|
524
436
|
|
|
525
|
-
|
|
526
|
-
|
|
437
|
+
const sync = createSync({
|
|
438
|
+
...platformDeps,
|
|
439
|
+
clock,
|
|
440
|
+
sqlite,
|
|
441
|
+
symmetricCrypto: createSymmetricCrypto(platformDeps),
|
|
442
|
+
timestampConfig: initMessage.config,
|
|
443
|
+
postMessage,
|
|
444
|
+
})({
|
|
445
|
+
appOwner,
|
|
446
|
+
transports: initMessage.config.transports,
|
|
447
|
+
onError: (error) => {
|
|
448
|
+
postMessage({ type: "onError", error });
|
|
449
|
+
},
|
|
450
|
+
onReceive: () => {
|
|
451
|
+
postMessage({ type: "refreshQueries" });
|
|
452
|
+
},
|
|
453
|
+
});
|
|
454
|
+
if (!sync.ok) return sync;
|
|
527
455
|
|
|
528
|
-
|
|
529
|
-
deps.postMessage({ type: "onError", error: file.error });
|
|
530
|
-
return;
|
|
531
|
-
}
|
|
456
|
+
sync.value.useOwner(true, appOwner);
|
|
532
457
|
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
458
|
+
const tabQueryRowsCacheMap = new Map<Id, QueryRowsCache>();
|
|
459
|
+
const getQueryRowsCache = (tabId: Id) => {
|
|
460
|
+
let cache = tabQueryRowsCacheMap.get(tabId);
|
|
461
|
+
if (!cache) {
|
|
462
|
+
cache = createQueryRowsCache();
|
|
463
|
+
tabQueryRowsCacheMap.set(tabId, cache);
|
|
539
464
|
}
|
|
540
|
-
|
|
541
|
-
default:
|
|
542
|
-
exhaustiveCheck(message);
|
|
543
|
-
}
|
|
544
|
-
},
|
|
545
|
-
});
|
|
546
|
-
};
|
|
547
|
-
|
|
548
|
-
/**
|
|
549
|
-
* Get the current database schema by reading SQLite metadata.
|
|
550
|
-
*
|
|
551
|
-
* TODO: Refactor out Evolu stuff and move it to Sqlite.
|
|
552
|
-
*/
|
|
553
|
-
export const getDbSchema =
|
|
554
|
-
(deps: SqliteDep) =>
|
|
555
|
-
({ allIndexes = false }: { allIndexes?: boolean } = {}): Result<
|
|
556
|
-
DbSchema,
|
|
557
|
-
SqliteError
|
|
558
|
-
> => {
|
|
559
|
-
const map = new Map<Base64Url256, Array<Base64Url256>>();
|
|
560
|
-
|
|
561
|
-
const tableAndColumnInfoRows = deps.sqlite.exec(sql`
|
|
562
|
-
select
|
|
563
|
-
sqlite_master.name as tableName,
|
|
564
|
-
table_info.name as columnName
|
|
565
|
-
from
|
|
566
|
-
sqlite_master
|
|
567
|
-
join pragma_table_info(sqlite_master.name) as table_info;
|
|
568
|
-
`);
|
|
569
|
-
|
|
570
|
-
if (!tableAndColumnInfoRows.ok) return tableAndColumnInfoRows;
|
|
571
|
-
|
|
572
|
-
tableAndColumnInfoRows.value.rows.forEach((row) => {
|
|
573
|
-
const { tableName, columnName } = row as unknown as {
|
|
574
|
-
tableName: Base64Url256;
|
|
575
|
-
columnName: Base64Url256;
|
|
465
|
+
return cache;
|
|
576
466
|
};
|
|
577
|
-
if (!map.has(tableName)) map.set(tableName, []);
|
|
578
|
-
map.get(tableName)?.push(columnName);
|
|
579
|
-
});
|
|
580
467
|
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
`
|
|
590
|
-
: sql`
|
|
591
|
-
select name, sql
|
|
592
|
-
from sqlite_master
|
|
593
|
-
where
|
|
594
|
-
type = 'index'
|
|
595
|
-
and name not like 'sqlite_%'
|
|
596
|
-
and name not like 'evolu_%';
|
|
597
|
-
`,
|
|
598
|
-
);
|
|
468
|
+
const deps: DbWorkerDeps = {
|
|
469
|
+
...platformDeps,
|
|
470
|
+
getQueryRowsCache,
|
|
471
|
+
postMessage,
|
|
472
|
+
sqlite,
|
|
473
|
+
sync: sync.value,
|
|
474
|
+
appOwner,
|
|
475
|
+
};
|
|
599
476
|
|
|
600
|
-
|
|
477
|
+
return ok(deps);
|
|
478
|
+
});
|
|
601
479
|
|
|
602
|
-
|
|
603
|
-
(
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
* SQLite returns "CREATE INDEX" for "create index" for some reason.
|
|
607
|
-
* Other keywords remain unchanged. We have to normalize the casing for
|
|
608
|
-
* {@link indexesAreEqual} manually.
|
|
609
|
-
*/
|
|
610
|
-
sql: (row.sql as string)
|
|
611
|
-
.replace("CREATE INDEX", "create index")
|
|
612
|
-
.replace("CREATE UNIQUE INDEX", "create unique index"),
|
|
613
|
-
}),
|
|
614
|
-
);
|
|
480
|
+
if (!deps.ok) {
|
|
481
|
+
postMessage({ type: "onError", error: deps.error });
|
|
482
|
+
return null;
|
|
483
|
+
}
|
|
615
484
|
|
|
616
|
-
return
|
|
485
|
+
return deps.value;
|
|
617
486
|
};
|
|
618
487
|
|
|
619
|
-
const
|
|
620
|
-
self.name === that.name && self.sql === that.sql;
|
|
621
|
-
|
|
622
|
-
export interface DbSnapshot {
|
|
623
|
-
readonly schema: DbSchema;
|
|
624
|
-
readonly tables: Array<{
|
|
625
|
-
name: string;
|
|
626
|
-
rows: ReadonlyArray<SqliteRow>;
|
|
627
|
-
}>;
|
|
628
|
-
}
|
|
629
|
-
|
|
630
|
-
// TODO: Move to test helpers.
|
|
631
|
-
export const getDbSnapshot = (deps: SqliteDep): DbSnapshot => {
|
|
632
|
-
const schema = getDbSchema(deps)({ allIndexes: true });
|
|
633
|
-
assert(schema.ok, "bug");
|
|
634
|
-
|
|
635
|
-
const tables = [];
|
|
636
|
-
|
|
637
|
-
for (const table of schema.value.tables) {
|
|
638
|
-
const result = deps.sqlite.exec(sql`
|
|
639
|
-
select * from ${sql.identifier(table.name)};
|
|
640
|
-
`);
|
|
641
|
-
assert(result.ok, "bug");
|
|
642
|
-
|
|
643
|
-
tables.push({
|
|
644
|
-
name: table.name,
|
|
645
|
-
rows: result.value.rows,
|
|
646
|
-
});
|
|
647
|
-
}
|
|
648
|
-
|
|
649
|
-
return { schema: schema.value, tables };
|
|
650
|
-
};
|
|
651
|
-
|
|
652
|
-
const ensureDbSchema =
|
|
488
|
+
const initializeDb =
|
|
653
489
|
(deps: SqliteDep) =>
|
|
654
490
|
(
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
options?: { ignoreIndexes: boolean },
|
|
491
|
+
initialAppOwner: AppOwner,
|
|
492
|
+
initialClock: Timestamp,
|
|
658
493
|
): Result<void, SqliteError> => {
|
|
659
|
-
const
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
);
|
|
665
|
-
if (!currentTable) {
|
|
666
|
-
queries.push({
|
|
667
|
-
sql: createAppTable(newTable.name, newTable.columns),
|
|
668
|
-
parameters: [],
|
|
669
|
-
});
|
|
670
|
-
} else {
|
|
671
|
-
newTable.columns
|
|
672
|
-
.filter((newColumn) => !currentTable.columns.includes(newColumn))
|
|
673
|
-
.forEach((newColumn) => {
|
|
674
|
-
queries.push(sql`
|
|
675
|
-
alter table ${sql.identifier(newTable.name)}
|
|
676
|
-
add column ${sql.identifier(newColumn)} blob;
|
|
677
|
-
`);
|
|
678
|
-
});
|
|
679
|
-
}
|
|
680
|
-
});
|
|
681
|
-
|
|
682
|
-
if (options?.ignoreIndexes !== true) {
|
|
683
|
-
// Remove current indexes that are not in the newSchema.
|
|
684
|
-
currentSchema.indexes
|
|
685
|
-
.filter(
|
|
686
|
-
(currentIndex) =>
|
|
687
|
-
!newSchema.indexes.some((newIndex) =>
|
|
688
|
-
indexesAreEqual(newIndex, currentIndex),
|
|
689
|
-
),
|
|
690
|
-
)
|
|
691
|
-
.forEach((index) => {
|
|
692
|
-
queries.push(sql`drop index ${sql.identifier(index.name)};`);
|
|
693
|
-
});
|
|
694
|
-
|
|
695
|
-
// Add new indexes that are not in the currentSchema.
|
|
696
|
-
newSchema.indexes
|
|
697
|
-
.filter(
|
|
698
|
-
(newIndex) =>
|
|
699
|
-
!currentSchema.indexes.some((currentIndex) =>
|
|
700
|
-
indexesAreEqual(newIndex, currentIndex),
|
|
701
|
-
),
|
|
494
|
+
for (const query of [
|
|
495
|
+
// Never change structure to ensure all versions can read it.
|
|
496
|
+
sql`
|
|
497
|
+
create table evolu_version (
|
|
498
|
+
"protocolVersion" integer not null
|
|
702
499
|
)
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
});
|
|
706
|
-
}
|
|
707
|
-
|
|
708
|
-
for (const query of queries) {
|
|
709
|
-
const result = deps.sqlite.exec(query);
|
|
710
|
-
if (!result.ok) return result;
|
|
711
|
-
}
|
|
712
|
-
return ok();
|
|
713
|
-
};
|
|
714
|
-
|
|
715
|
-
export const createAppTable = (
|
|
716
|
-
tableName: string,
|
|
717
|
-
columns: ReadonlyArray<string>,
|
|
718
|
-
): SafeSql =>
|
|
719
|
-
`
|
|
720
|
-
create table ${sql.identifier(tableName).sql} (
|
|
721
|
-
"id" text primary key,
|
|
722
|
-
${columns
|
|
723
|
-
// Add default columns.
|
|
724
|
-
.concat(["createdAt", "updatedAt", "isDeleted"])
|
|
725
|
-
.filter((c) => c !== "id")
|
|
726
|
-
// "A column with affinity BLOB does not prefer one storage class over another
|
|
727
|
-
// and no attempt is made to coerce data from one storage class into another."
|
|
728
|
-
// https://www.sqlite.org/datatype3.html
|
|
729
|
-
.map((name) => `${sql.identifier(name).sql} blob`)
|
|
730
|
-
.join(", ")}
|
|
731
|
-
);
|
|
732
|
-
` as SafeSql;
|
|
733
|
-
|
|
734
|
-
const selectAppOwner = (
|
|
735
|
-
deps: SqliteDep,
|
|
736
|
-
): Result<[AppOwner, OwnerRow], SqliteError> => {
|
|
737
|
-
const result = deps.sqlite.exec<OwnerRow>(sql`
|
|
738
|
-
select mnemonic, id, createdAt, encryptionKey, writeKey, timestamp
|
|
739
|
-
from evolu_owner
|
|
740
|
-
order by createdAt asc
|
|
741
|
-
limit 1;
|
|
742
|
-
`);
|
|
743
|
-
|
|
744
|
-
if (!result.ok) return result;
|
|
745
|
-
|
|
746
|
-
const {
|
|
747
|
-
rows: [ownerRow],
|
|
748
|
-
} = result.value;
|
|
749
|
-
|
|
750
|
-
assert(ownerRow.writeKey != null, "The writeKey is null");
|
|
751
|
-
|
|
752
|
-
const appOwner: AppOwner = {
|
|
753
|
-
type: "AppOwner",
|
|
754
|
-
mnemonic: ownerRow.mnemonic,
|
|
755
|
-
createdAt: ownerRow.createdAt,
|
|
756
|
-
id: ownerRow.id,
|
|
757
|
-
encryptionKey: ownerRow.encryptionKey,
|
|
758
|
-
writeKey: ownerRow.writeKey,
|
|
759
|
-
};
|
|
500
|
+
strict;
|
|
501
|
+
`,
|
|
760
502
|
|
|
761
|
-
|
|
762
|
-
|
|
503
|
+
sql`
|
|
504
|
+
insert into evolu_version ("protocolVersion")
|
|
505
|
+
values (${protocolVersion});
|
|
506
|
+
`,
|
|
763
507
|
|
|
764
|
-
const initializeDb =
|
|
765
|
-
(
|
|
766
|
-
deps: SqliteDep &
|
|
767
|
-
NanoIdLibDep &
|
|
768
|
-
CreateMnemonicDep &
|
|
769
|
-
TimeDep &
|
|
770
|
-
CreateRandomBytesDep,
|
|
771
|
-
) =>
|
|
772
|
-
(mnemonic?: Mnemonic): Result<[AppOwner, OwnerRow], SqliteError> => {
|
|
773
|
-
for (const query of [
|
|
774
508
|
sql`
|
|
775
509
|
create table evolu_config (
|
|
776
|
-
"
|
|
777
|
-
"
|
|
510
|
+
"clock" text not null,
|
|
511
|
+
"appOwnerId" text not null,
|
|
512
|
+
"appOwnerEncryptionKey" blob not null,
|
|
513
|
+
"appOwnerWriteKey" blob not null,
|
|
514
|
+
"appOwnerMnemonic" text
|
|
778
515
|
)
|
|
779
516
|
strict;
|
|
780
517
|
`,
|
|
781
518
|
|
|
782
519
|
sql`
|
|
783
|
-
insert into evolu_config
|
|
784
|
-
|
|
520
|
+
insert into evolu_config
|
|
521
|
+
(
|
|
522
|
+
"clock",
|
|
523
|
+
"appOwnerId",
|
|
524
|
+
"appOwnerEncryptionKey",
|
|
525
|
+
"appOwnerWriteKey",
|
|
526
|
+
"appOwnerMnemonic"
|
|
527
|
+
)
|
|
528
|
+
values
|
|
529
|
+
(
|
|
530
|
+
${timestampToTimestampString(initialClock)},
|
|
531
|
+
${initialAppOwner.id},
|
|
532
|
+
${initialAppOwner.encryptionKey},
|
|
533
|
+
${initialAppOwner.writeKey},
|
|
534
|
+
${initialAppOwner.mnemonic ?? null}
|
|
535
|
+
);
|
|
785
536
|
`,
|
|
786
537
|
|
|
787
538
|
/**
|
|
@@ -803,6 +554,8 @@ const initializeDb =
|
|
|
803
554
|
strict;
|
|
804
555
|
`,
|
|
805
556
|
|
|
557
|
+
// Index for reading database changes by owner and timestamp.
|
|
558
|
+
// Timestamp always corresponds to a DbChange.
|
|
806
559
|
sql`
|
|
807
560
|
create index evolu_history_ownerId_timestamp on evolu_history (
|
|
808
561
|
"ownerId",
|
|
@@ -819,192 +572,177 @@ const initializeDb =
|
|
|
819
572
|
"timestamp" desc
|
|
820
573
|
);
|
|
821
574
|
`,
|
|
822
|
-
|
|
823
|
-
sql`
|
|
824
|
-
create table evolu_owner (
|
|
825
|
-
"mnemonic" text not null primary key,
|
|
826
|
-
"id" text not null,
|
|
827
|
-
"encryptionKey" blob not null,
|
|
828
|
-
"createdAt" text not null,
|
|
829
|
-
"writeKey" blob,
|
|
830
|
-
"timestamp" text not null
|
|
831
|
-
)
|
|
832
|
-
strict;
|
|
833
|
-
`,
|
|
834
575
|
]) {
|
|
835
576
|
const result = deps.sqlite.exec(query);
|
|
836
577
|
if (!result.ok) return result;
|
|
837
578
|
}
|
|
838
579
|
|
|
839
|
-
const
|
|
840
|
-
const ownerRow = createOwnerRow(deps)(appOwner);
|
|
841
|
-
|
|
842
|
-
const result = deps.sqlite.exec(sql`
|
|
843
|
-
insert into evolu_owner
|
|
844
|
-
(
|
|
845
|
-
"mnemonic",
|
|
846
|
-
"id",
|
|
847
|
-
"encryptionKey",
|
|
848
|
-
"createdAt",
|
|
849
|
-
"writeKey",
|
|
850
|
-
"timestamp"
|
|
851
|
-
)
|
|
852
|
-
values
|
|
853
|
-
(
|
|
854
|
-
${ownerRow.mnemonic},
|
|
855
|
-
${ownerRow.id},
|
|
856
|
-
${ownerRow.encryptionKey},
|
|
857
|
-
${ownerRow.createdAt},
|
|
858
|
-
${ownerRow.writeKey},
|
|
859
|
-
${ownerRow.timestamp}
|
|
860
|
-
);
|
|
861
|
-
`);
|
|
862
|
-
|
|
580
|
+
const result = createBaseSqliteStorageTables(deps);
|
|
863
581
|
if (!result.ok) return result;
|
|
864
582
|
|
|
865
|
-
return ok(
|
|
583
|
+
return ok();
|
|
866
584
|
};
|
|
867
585
|
|
|
868
|
-
const
|
|
869
|
-
(
|
|
870
|
-
deps
|
|
871
|
-
|
|
872
|
-
|
|
873
|
-
|
|
874
|
-
|
|
875
|
-
ClientStorageDep,
|
|
876
|
-
) =>
|
|
877
|
-
(
|
|
878
|
-
changes: NonEmptyReadonlyArray<DbChange>,
|
|
879
|
-
onChange?: () => void,
|
|
880
|
-
): Result<
|
|
881
|
-
NonEmptyReadonlyArray<CrdtMessage>,
|
|
882
|
-
| TimestampTimeOutOfRangeError
|
|
883
|
-
| TimestampDriftError
|
|
884
|
-
| TimestampCounterOverflowError
|
|
885
|
-
| SqliteError
|
|
886
|
-
> => {
|
|
887
|
-
let lastTimestamp = timestampStringToTimestamp(
|
|
888
|
-
deps.ownerRowRef.get().timestamp,
|
|
889
|
-
);
|
|
586
|
+
const handlers: Omit<MessageHandlers<DbWorkerInput, DbWorkerDeps>, "init"> = {
|
|
587
|
+
getAppOwner: (deps) => () => {
|
|
588
|
+
deps.postMessage({
|
|
589
|
+
type: "onGetAppOwner",
|
|
590
|
+
appOwner: deps.appOwner,
|
|
591
|
+
});
|
|
592
|
+
},
|
|
890
593
|
|
|
891
|
-
|
|
594
|
+
mutate: (deps) => (message) => {
|
|
595
|
+
const mutate = deps.sqlite.transaction(() => {
|
|
596
|
+
const syncChanges: Array<MutationChange> = [];
|
|
892
597
|
|
|
893
|
-
|
|
894
|
-
|
|
895
|
-
|
|
896
|
-
|
|
897
|
-
|
|
898
|
-
|
|
598
|
+
for (const change of message.changes) {
|
|
599
|
+
const isLocalOnlyChange = change.table.startsWith("_");
|
|
600
|
+
if (isLocalOnlyChange) {
|
|
601
|
+
const result = applyLocalOnlyChange(deps)(change);
|
|
602
|
+
if (!result.ok) return result;
|
|
603
|
+
} else {
|
|
604
|
+
syncChanges.push(change);
|
|
605
|
+
}
|
|
606
|
+
}
|
|
899
607
|
|
|
900
|
-
|
|
901
|
-
|
|
608
|
+
if (isNonEmptyArray(syncChanges)) {
|
|
609
|
+
const result = deps.sync.applyChanges(syncChanges);
|
|
610
|
+
if (!result.ok) return result;
|
|
611
|
+
}
|
|
902
612
|
|
|
903
|
-
|
|
613
|
+
// Read writes before commit to update UI ASAP
|
|
614
|
+
const queryPatches = loadQueries(deps)(
|
|
615
|
+
message.tabId,
|
|
616
|
+
message.subscribedQueries,
|
|
617
|
+
);
|
|
618
|
+
if (!queryPatches.ok) return queryPatches;
|
|
619
|
+
|
|
620
|
+
// Update the tab that performed the mutation.
|
|
621
|
+
deps.postMessage({
|
|
622
|
+
type: "onQueryPatches",
|
|
623
|
+
tabId: message.tabId,
|
|
624
|
+
queryPatches: queryPatches.value,
|
|
625
|
+
onCompleteIds: message.onCompleteIds,
|
|
626
|
+
});
|
|
904
627
|
|
|
905
|
-
|
|
906
|
-
|
|
907
|
-
};
|
|
628
|
+
// Notify other tabs to refresh their queries.
|
|
629
|
+
deps.postMessage({ type: "refreshQueries", tabId: message.tabId });
|
|
908
630
|
|
|
909
|
-
|
|
910
|
-
|
|
911
|
-
(
|
|
912
|
-
messages: ReadonlyArray<CrdtMessage>,
|
|
913
|
-
lastTimestamp: Timestamp,
|
|
914
|
-
): Result<void, SqliteError> => {
|
|
915
|
-
const ownerId = ownerIdToBinaryOwnerId(deps.ownerRowRef.get().id);
|
|
631
|
+
return ok();
|
|
632
|
+
});
|
|
916
633
|
|
|
917
|
-
|
|
918
|
-
|
|
919
|
-
|
|
634
|
+
if (!mutate.ok) {
|
|
635
|
+
deps.postMessage({ type: "onError", error: mutate.error });
|
|
636
|
+
return;
|
|
637
|
+
}
|
|
638
|
+
},
|
|
920
639
|
|
|
921
|
-
|
|
922
|
-
|
|
923
|
-
|
|
924
|
-
|
|
925
|
-
|
|
640
|
+
query: (deps) => (message) => {
|
|
641
|
+
const queryPatches = loadQueries(deps)(message.tabId, message.queries);
|
|
642
|
+
|
|
643
|
+
if (!queryPatches.ok) {
|
|
644
|
+
deps.postMessage({ type: "onError", error: queryPatches.error });
|
|
645
|
+
return;
|
|
926
646
|
}
|
|
927
647
|
|
|
928
|
-
|
|
929
|
-
|
|
930
|
-
|
|
931
|
-
|
|
932
|
-
|
|
933
|
-
|
|
648
|
+
deps.postMessage({
|
|
649
|
+
type: "onQueryPatches",
|
|
650
|
+
tabId: message.tabId,
|
|
651
|
+
queryPatches: queryPatches.value,
|
|
652
|
+
onCompleteIds: [],
|
|
653
|
+
});
|
|
654
|
+
},
|
|
934
655
|
|
|
935
|
-
|
|
936
|
-
|
|
656
|
+
reset: (deps) => (message) => {
|
|
657
|
+
const resetResult = deps.sqlite.transaction(() => {
|
|
658
|
+
const dbSchema = getDbSchema(deps)();
|
|
659
|
+
if (!dbSchema.ok) return dbSchema;
|
|
937
660
|
|
|
938
|
-
const
|
|
939
|
-
|
|
940
|
-
|
|
941
|
-
|
|
942
|
-
|
|
943
|
-
|
|
944
|
-
|
|
945
|
-
|
|
946
|
-
|
|
947
|
-
|
|
948
|
-
|
|
949
|
-
|
|
950
|
-
where
|
|
951
|
-
"ownerId" = ${ownerId}
|
|
952
|
-
and "table" = ${message.change.table}
|
|
953
|
-
and "id" = ${message.change.id}
|
|
954
|
-
and "column" = ${column}
|
|
955
|
-
order by "timestamp" desc
|
|
956
|
-
limit 1
|
|
957
|
-
)
|
|
958
|
-
insert into ${sql.identifier(message.change.table)}
|
|
959
|
-
("id", ${sql.identifier(column)}, createdAt, updatedAt)
|
|
960
|
-
select ${message.change.id}, ${value}, ${date}, ${date}
|
|
961
|
-
where
|
|
962
|
-
(select "timestamp" from lastTimestamp) is null
|
|
963
|
-
or (select "timestamp" from lastTimestamp) < ${timestamp}
|
|
964
|
-
on conflict ("id") do update
|
|
965
|
-
set
|
|
966
|
-
${sql.identifier(column)} = ${value},
|
|
967
|
-
updatedAt = ${date}
|
|
968
|
-
where
|
|
969
|
-
(select "timestamp" from lastTimestamp) is null
|
|
970
|
-
or (select "timestamp" from lastTimestamp) < ${timestamp};
|
|
971
|
-
`);
|
|
661
|
+
for (const table of dbSchema.value.tables) {
|
|
662
|
+
/**
|
|
663
|
+
* The dropped table is completely removed from the database schema and
|
|
664
|
+
* the disk file. The table can not be recovered. All indices and
|
|
665
|
+
* triggers associated with the table are also deleted.
|
|
666
|
+
* https://sqlite.org/lang_droptable.html
|
|
667
|
+
*/
|
|
668
|
+
const result = deps.sqlite.exec(sql`
|
|
669
|
+
drop table ${sql.identifier(table.name)};
|
|
670
|
+
`);
|
|
671
|
+
if (!result.ok) return result;
|
|
672
|
+
}
|
|
972
673
|
|
|
973
|
-
if (
|
|
674
|
+
if (message.restore) {
|
|
675
|
+
const dbSchema = getDbSchema(deps)();
|
|
676
|
+
if (!dbSchema.ok) return dbSchema;
|
|
677
|
+
|
|
678
|
+
const ensureDbSchemaResult = ensureDbSchema(deps)(
|
|
679
|
+
message.restore.dbSchema,
|
|
680
|
+
dbSchema.value,
|
|
681
|
+
);
|
|
682
|
+
if (!ensureDbSchemaResult.ok) return ensureDbSchemaResult;
|
|
683
|
+
|
|
684
|
+
const secret = mnemonicToOwnerSecret(message.restore.mnemonic);
|
|
685
|
+
const appOwner = createAppOwner(secret);
|
|
686
|
+
const clock = createClock(deps)();
|
|
687
|
+
|
|
688
|
+
const initializeDbResult = initializeDb(deps)(appOwner, clock.get());
|
|
689
|
+
if (!initializeDbResult.ok) return initializeDbResult;
|
|
690
|
+
}
|
|
691
|
+
|
|
692
|
+
return ok();
|
|
693
|
+
});
|
|
694
|
+
|
|
695
|
+
if (!resetResult.ok) {
|
|
696
|
+
deps.postMessage({ type: "onError", error: resetResult.error });
|
|
697
|
+
return;
|
|
974
698
|
}
|
|
975
699
|
|
|
976
|
-
|
|
977
|
-
|
|
700
|
+
deps.postMessage({
|
|
701
|
+
type: "onReset",
|
|
702
|
+
onCompleteId: message.onCompleteId,
|
|
703
|
+
reload: message.reload,
|
|
704
|
+
});
|
|
705
|
+
},
|
|
978
706
|
|
|
979
|
-
|
|
980
|
-
|
|
981
|
-
|
|
982
|
-
|
|
983
|
-
const id = idToBinaryId(message.change.id);
|
|
707
|
+
ensureDbSchema: (deps) => (message) => {
|
|
708
|
+
const ensureSchema = deps.sqlite.transaction(() => {
|
|
709
|
+
const dbSchema = getDbSchema(deps)();
|
|
710
|
+
if (!dbSchema.ok) return dbSchema;
|
|
984
711
|
|
|
985
|
-
|
|
986
|
-
|
|
712
|
+
const ensureDbSchemaResult = ensureDbSchema(deps)(
|
|
713
|
+
message.dbSchema,
|
|
714
|
+
dbSchema.value,
|
|
715
|
+
);
|
|
716
|
+
if (!ensureDbSchemaResult.ok) return ensureDbSchemaResult;
|
|
987
717
|
|
|
988
|
-
|
|
989
|
-
|
|
990
|
-
|
|
991
|
-
|
|
992
|
-
|
|
993
|
-
|
|
994
|
-
${ownerId},
|
|
995
|
-
${message.change.table},
|
|
996
|
-
${id},
|
|
997
|
-
${column},
|
|
998
|
-
${value},
|
|
999
|
-
${timestamp}
|
|
1000
|
-
)
|
|
1001
|
-
on conflict do nothing;
|
|
1002
|
-
`);
|
|
1003
|
-
if (!result.ok) return result;
|
|
718
|
+
return ok();
|
|
719
|
+
});
|
|
720
|
+
|
|
721
|
+
if (!ensureSchema.ok) {
|
|
722
|
+
deps.postMessage({ type: "onError", error: ensureSchema.error });
|
|
723
|
+
return;
|
|
1004
724
|
}
|
|
725
|
+
},
|
|
1005
726
|
|
|
1006
|
-
|
|
1007
|
-
|
|
727
|
+
export: (deps) => (message) => {
|
|
728
|
+
const file = deps.sqlite.export();
|
|
729
|
+
|
|
730
|
+
if (!file.ok) {
|
|
731
|
+
deps.postMessage({ type: "onError", error: file.error });
|
|
732
|
+
return;
|
|
733
|
+
}
|
|
734
|
+
|
|
735
|
+
deps.postMessage({
|
|
736
|
+
type: "onExport",
|
|
737
|
+
onCompleteId: message.onCompleteId,
|
|
738
|
+
file: file.value,
|
|
739
|
+
});
|
|
740
|
+
},
|
|
741
|
+
|
|
742
|
+
useOwner: (deps) => (message) => {
|
|
743
|
+
deps.sync.useOwner(message.use, message.owner);
|
|
744
|
+
},
|
|
745
|
+
};
|
|
1008
746
|
|
|
1009
747
|
const loadQueries =
|
|
1010
748
|
(deps: GetQueryRowsCacheDep & SqliteDep) =>
|
|
@@ -1043,244 +781,3 @@ const loadQueries =
|
|
|
1043
781
|
);
|
|
1044
782
|
return ok(queryPatchesArray);
|
|
1045
783
|
};
|
|
1046
|
-
|
|
1047
|
-
export const maybeMigrateToVersion0 =
|
|
1048
|
-
(deps: SqliteDep) =>
|
|
1049
|
-
(
|
|
1050
|
-
schema: DbSchema,
|
|
1051
|
-
): Result<
|
|
1052
|
-
{
|
|
1053
|
-
readonly messages: ReadonlyArray<CrdtMessage>;
|
|
1054
|
-
readonly mnemonic: Mnemonic;
|
|
1055
|
-
readonly lastTimestamp: Timestamp;
|
|
1056
|
-
} | null,
|
|
1057
|
-
SqliteError
|
|
1058
|
-
> => {
|
|
1059
|
-
// evolu_history is a new table
|
|
1060
|
-
const hasOwnerButNoHistory =
|
|
1061
|
-
schema.tables.some((t) => t.name === "evolu_owner") &&
|
|
1062
|
-
!schema.tables.some((t) => t.name === "evolu_history");
|
|
1063
|
-
if (!hasOwnerButNoHistory) {
|
|
1064
|
-
return ok(null);
|
|
1065
|
-
}
|
|
1066
|
-
|
|
1067
|
-
const mnemonicAndLastTimestamp = deps.sqlite.exec<{
|
|
1068
|
-
mnemonic: Mnemonic;
|
|
1069
|
-
timestamp: TimestampString;
|
|
1070
|
-
}>(sql` select mnemonic, timestamp from evolu_owner limit 1; `);
|
|
1071
|
-
if (!mnemonicAndLastTimestamp.ok) return mnemonicAndLastTimestamp;
|
|
1072
|
-
|
|
1073
|
-
const messagesRows = deps.sqlite.exec<{
|
|
1074
|
-
timestamp: TimestampString;
|
|
1075
|
-
table: Base64Url256;
|
|
1076
|
-
id: Id;
|
|
1077
|
-
column: Base64Url256;
|
|
1078
|
-
value: SqliteValue;
|
|
1079
|
-
}>(sql`
|
|
1080
|
-
select "timestamp", "table", "id", "column", "value" from evolu_message;
|
|
1081
|
-
`);
|
|
1082
|
-
|
|
1083
|
-
if (!messagesRows.ok) return messagesRows;
|
|
1084
|
-
|
|
1085
|
-
for (const query of [
|
|
1086
|
-
sql`drop table evolu_owner;`,
|
|
1087
|
-
sql`drop table evolu_message;`,
|
|
1088
|
-
]) {
|
|
1089
|
-
const result = deps.sqlite.exec(query);
|
|
1090
|
-
if (!result.ok) return result;
|
|
1091
|
-
}
|
|
1092
|
-
|
|
1093
|
-
const messages = messagesRows.value.rows.map((message) => ({
|
|
1094
|
-
timestamp: timestampStringToTimestamp(message.timestamp),
|
|
1095
|
-
change: {
|
|
1096
|
-
id: message.id,
|
|
1097
|
-
table: message.table,
|
|
1098
|
-
values: { [message.column]: message.value },
|
|
1099
|
-
},
|
|
1100
|
-
}));
|
|
1101
|
-
|
|
1102
|
-
const {
|
|
1103
|
-
rows: [{ mnemonic, timestamp }],
|
|
1104
|
-
} = mnemonicAndLastTimestamp.value;
|
|
1105
|
-
const lastTimestamp = timestampStringToTimestamp(timestamp);
|
|
1106
|
-
|
|
1107
|
-
return ok({ messages, mnemonic, lastTimestamp });
|
|
1108
|
-
};
|
|
1109
|
-
|
|
1110
|
-
const dropAllTables = (deps: SqliteDep): Result<void, SqliteError> => {
|
|
1111
|
-
const schema = getDbSchema(deps)();
|
|
1112
|
-
if (!schema.ok) return schema;
|
|
1113
|
-
for (const table of schema.value.tables) {
|
|
1114
|
-
/**
|
|
1115
|
-
* The dropped table is completely removed from the database schema and the
|
|
1116
|
-
* disk file. The table can not be recovered. All indices and triggers
|
|
1117
|
-
* associated with the table are also deleted.
|
|
1118
|
-
* https://sqlite.org/lang_droptable.html
|
|
1119
|
-
*/
|
|
1120
|
-
const result = deps.sqlite.exec(sql`
|
|
1121
|
-
drop table ${sql.identifier(table.name)};
|
|
1122
|
-
`);
|
|
1123
|
-
if (!result.ok) return result;
|
|
1124
|
-
}
|
|
1125
|
-
return ok();
|
|
1126
|
-
};
|
|
1127
|
-
|
|
1128
|
-
const handleSyncOpen =
|
|
1129
|
-
(deps: OwnerRowRefDep & StorageDep & ConsoleDep): SyncConfig["onOpen"] =>
|
|
1130
|
-
(send) => {
|
|
1131
|
-
const ownerId = deps.ownerRowRef.get().id;
|
|
1132
|
-
const message = createProtocolMessageForSync(deps)(ownerId);
|
|
1133
|
-
if (message) {
|
|
1134
|
-
deps.console.log("[db]", "send initial sync message", message);
|
|
1135
|
-
send(message);
|
|
1136
|
-
}
|
|
1137
|
-
};
|
|
1138
|
-
|
|
1139
|
-
const createHandleSyncMessage =
|
|
1140
|
-
(
|
|
1141
|
-
deps: PostMessageDep & StorageDep & SqliteDep & ConsoleDep & OwnerRowRefDep,
|
|
1142
|
-
): SyncConfig["onMessage"] =>
|
|
1143
|
-
(input, send) => {
|
|
1144
|
-
deps.console.log("[db]", "receive sync message", input);
|
|
1145
|
-
const { writeKey } = deps.ownerRowRef.get();
|
|
1146
|
-
|
|
1147
|
-
const output = deps.sqlite.transaction(() =>
|
|
1148
|
-
applyProtocolMessageAsClient(deps)(input, {
|
|
1149
|
-
getWriteKey: (_ownerId) => writeKey,
|
|
1150
|
-
}),
|
|
1151
|
-
);
|
|
1152
|
-
if (!output.ok) {
|
|
1153
|
-
deps.postMessage({ type: "onError", error: output.error });
|
|
1154
|
-
return;
|
|
1155
|
-
}
|
|
1156
|
-
|
|
1157
|
-
if (output.value) {
|
|
1158
|
-
deps.console.log("[db]", "respond sync message", output.value);
|
|
1159
|
-
send(output.value);
|
|
1160
|
-
}
|
|
1161
|
-
};
|
|
1162
|
-
|
|
1163
|
-
export interface ClientStorage extends SqliteStorageBase, Storage {}
|
|
1164
|
-
|
|
1165
|
-
export interface ClientStorageDep {
|
|
1166
|
-
readonly storage: ClientStorage;
|
|
1167
|
-
}
|
|
1168
|
-
|
|
1169
|
-
const createClientStorage =
|
|
1170
|
-
(
|
|
1171
|
-
deps: SqliteDep &
|
|
1172
|
-
PostMessageDep &
|
|
1173
|
-
SymmetricCryptoDep &
|
|
1174
|
-
OwnerRowRefDep &
|
|
1175
|
-
RandomDep &
|
|
1176
|
-
TimeDep &
|
|
1177
|
-
TimestampConfigDep,
|
|
1178
|
-
) =>
|
|
1179
|
-
(
|
|
1180
|
-
options: CreateSqliteStorageBaseOptions,
|
|
1181
|
-
): Result<ClientStorage, SqliteError> => {
|
|
1182
|
-
const sqliteStorageBase = createSqliteStorageBase(deps)(options);
|
|
1183
|
-
if (!sqliteStorageBase.ok) return sqliteStorageBase;
|
|
1184
|
-
|
|
1185
|
-
const storage: ClientStorage = {
|
|
1186
|
-
...sqliteStorageBase.value,
|
|
1187
|
-
|
|
1188
|
-
validateWriteKey: constFalse,
|
|
1189
|
-
|
|
1190
|
-
writeMessages: (_ownerId, messages) => {
|
|
1191
|
-
// TODO: Get owner by _ownerId when we support more.
|
|
1192
|
-
// Use ownerId!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
1193
|
-
const owner = deps.ownerRowRef.get();
|
|
1194
|
-
const decodedAndDecryptedMessages: Array<CrdtMessage> = [];
|
|
1195
|
-
|
|
1196
|
-
for (const message of messages) {
|
|
1197
|
-
const dbChange = decryptAndDecodeDbChange(deps)(
|
|
1198
|
-
message.change,
|
|
1199
|
-
owner.encryptionKey,
|
|
1200
|
-
);
|
|
1201
|
-
|
|
1202
|
-
if (!dbChange.ok) {
|
|
1203
|
-
deps.postMessage({
|
|
1204
|
-
type: "onError",
|
|
1205
|
-
error: dbChange.error,
|
|
1206
|
-
});
|
|
1207
|
-
return false;
|
|
1208
|
-
}
|
|
1209
|
-
|
|
1210
|
-
decodedAndDecryptedMessages.push({
|
|
1211
|
-
timestamp: message.timestamp,
|
|
1212
|
-
change: dbChange.value,
|
|
1213
|
-
});
|
|
1214
|
-
}
|
|
1215
|
-
|
|
1216
|
-
let timestamp = timestampStringToTimestamp(owner.timestamp);
|
|
1217
|
-
|
|
1218
|
-
for (const message of messages) {
|
|
1219
|
-
const receive = receiveTimestamp(deps)(timestamp, message.timestamp);
|
|
1220
|
-
if (!receive.ok) {
|
|
1221
|
-
deps.postMessage({ type: "onError", error: receive.error });
|
|
1222
|
-
return false;
|
|
1223
|
-
}
|
|
1224
|
-
timestamp = receive.value;
|
|
1225
|
-
}
|
|
1226
|
-
|
|
1227
|
-
const applyMessagesResult = applyMessages({ ...deps, storage })(
|
|
1228
|
-
decodedAndDecryptedMessages,
|
|
1229
|
-
timestamp,
|
|
1230
|
-
);
|
|
1231
|
-
|
|
1232
|
-
if (!applyMessagesResult.ok) {
|
|
1233
|
-
deps.postMessage({
|
|
1234
|
-
type: "onError",
|
|
1235
|
-
error: applyMessagesResult.error,
|
|
1236
|
-
});
|
|
1237
|
-
return false;
|
|
1238
|
-
}
|
|
1239
|
-
|
|
1240
|
-
deps.postMessage({ type: "onReceive" });
|
|
1241
|
-
|
|
1242
|
-
return true;
|
|
1243
|
-
},
|
|
1244
|
-
|
|
1245
|
-
readDbChange: (ownerId, timestamp) => {
|
|
1246
|
-
const result = deps.sqlite.exec<{
|
|
1247
|
-
table: Base64Url256;
|
|
1248
|
-
id: BinaryId;
|
|
1249
|
-
column: Base64Url256;
|
|
1250
|
-
value: SqliteValue;
|
|
1251
|
-
}>(sql`
|
|
1252
|
-
select "table", "id", "column", "value"
|
|
1253
|
-
from evolu_history
|
|
1254
|
-
where "ownerId" = ${ownerId} and "timestamp" = ${timestamp};
|
|
1255
|
-
`);
|
|
1256
|
-
if (!result.ok) {
|
|
1257
|
-
deps.postMessage({ type: "onError", error: result.error });
|
|
1258
|
-
return null;
|
|
1259
|
-
}
|
|
1260
|
-
|
|
1261
|
-
const { rows } = result.value;
|
|
1262
|
-
assert(rows.length > 0, "Rows must not be empty");
|
|
1263
|
-
|
|
1264
|
-
const { table, id } = rows[0];
|
|
1265
|
-
const values: Record<string, SqliteValue> = {};
|
|
1266
|
-
|
|
1267
|
-
for (const r of rows) {
|
|
1268
|
-
assert(r.table === table, "All rows must have the same table");
|
|
1269
|
-
assert(eqArrayNumber(r.id, id), "All rows must have the same Id");
|
|
1270
|
-
values[r.column] = r.value;
|
|
1271
|
-
}
|
|
1272
|
-
|
|
1273
|
-
const change: DbChange = {
|
|
1274
|
-
table: rows[0].table,
|
|
1275
|
-
id: binaryIdToId(rows[0].id),
|
|
1276
|
-
values,
|
|
1277
|
-
};
|
|
1278
|
-
|
|
1279
|
-
const { encryptionKey } = deps.ownerRowRef.get();
|
|
1280
|
-
|
|
1281
|
-
return encodeAndEncryptDbChange(deps)(change, encryptionKey);
|
|
1282
|
-
},
|
|
1283
|
-
};
|
|
1284
|
-
|
|
1285
|
-
return ok(storage);
|
|
1286
|
-
};
|