@open-e2ee/signal-protocol-sdk 12.0.0 → 13.0.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.
Files changed (171) hide show
  1. package/ADAPTERS.md +3 -0
  2. package/ARCHITECTURE.md +4 -4
  3. package/CHANGELOG.md +165 -0
  4. package/README.md +1 -1
  5. package/SECURITY.md +2 -2
  6. package/TROUBLESHOOTING.md +7 -7
  7. package/client/README.md +40 -0
  8. package/device/README.md +29 -3
  9. package/dist/client/client.d.ts +8 -0
  10. package/dist/client/client.d.ts.map +1 -1
  11. package/dist/client/client.js +26 -3
  12. package/dist/client/client.js.map +1 -1
  13. package/dist/client/config.d.ts +19 -12
  14. package/dist/client/config.d.ts.map +1 -1
  15. package/dist/client/config.js.map +1 -1
  16. package/dist/client/event-hooks.d.ts +28 -0
  17. package/dist/client/event-hooks.d.ts.map +1 -1
  18. package/dist/client/event-hooks.js +1 -0
  19. package/dist/client/event-hooks.js.map +1 -1
  20. package/dist/client/group-init-status.d.ts +21 -0
  21. package/dist/client/group-init-status.d.ts.map +1 -0
  22. package/dist/client/group-init-status.js +156 -0
  23. package/dist/client/group-init-status.js.map +1 -0
  24. package/dist/client/hosted-device-link.d.ts +97 -0
  25. package/dist/client/hosted-device-link.d.ts.map +1 -0
  26. package/dist/client/hosted-device-link.js +149 -0
  27. package/dist/client/hosted-device-link.js.map +1 -0
  28. package/dist/client/hosted-http-error.d.ts +30 -0
  29. package/dist/client/hosted-http-error.d.ts.map +1 -0
  30. package/dist/client/hosted-http-error.js +34 -0
  31. package/dist/client/hosted-http-error.js.map +1 -0
  32. package/dist/client/hosted-presence.js +1 -1
  33. package/dist/client/hosted-presence.js.map +1 -1
  34. package/dist/client/hosted-profile-keys.js +1 -1
  35. package/dist/client/hosted-profile-keys.js.map +1 -1
  36. package/dist/client/hosted-sandbox-identity.d.ts +3 -3
  37. package/dist/client/hosted-sandbox-identity.js +3 -3
  38. package/dist/client/hosted-transport.d.ts +0 -11
  39. package/dist/client/hosted-transport.d.ts.map +1 -1
  40. package/dist/client/hosted-transport.js +1 -15
  41. package/dist/client/hosted-transport.js.map +1 -1
  42. package/dist/client/hosted.d.ts +53 -7
  43. package/dist/client/hosted.d.ts.map +1 -1
  44. package/dist/client/hosted.js +158 -17
  45. package/dist/client/hosted.js.map +1 -1
  46. package/dist/client/index.d.ts +2 -1
  47. package/dist/client/index.d.ts.map +1 -1
  48. package/dist/client/index.js +1 -1
  49. package/dist/client/index.js.map +1 -1
  50. package/dist/client/receive-queue.d.ts +4 -2
  51. package/dist/client/receive-queue.d.ts.map +1 -1
  52. package/dist/client/receive-queue.js +26 -22
  53. package/dist/client/receive-queue.js.map +1 -1
  54. package/dist/index.d.ts +2 -1
  55. package/dist/index.d.ts.map +1 -1
  56. package/dist/index.js +1 -1
  57. package/dist/index.js.map +1 -1
  58. package/dist/internal/manager/manager.d.ts +6 -1
  59. package/dist/internal/manager/manager.d.ts.map +1 -1
  60. package/dist/internal/manager/manager.js +8 -2
  61. package/dist/internal/manager/manager.js.map +1 -1
  62. package/dist/internal/session/cipher.d.ts +2 -2
  63. package/dist/internal/session/cipher.js +1 -1
  64. package/dist/internal/session/types.d.ts +1 -1
  65. package/dist/local/store/conformance/cases/ciphertext.d.ts +7 -0
  66. package/dist/local/store/conformance/cases/ciphertext.d.ts.map +1 -0
  67. package/dist/local/store/conformance/cases/ciphertext.js +55 -0
  68. package/dist/local/store/conformance/cases/ciphertext.js.map +1 -0
  69. package/dist/local/store/conformance/cases/durability.d.ts +6 -0
  70. package/dist/local/store/conformance/cases/durability.d.ts.map +1 -0
  71. package/dist/local/store/conformance/cases/durability.js +34 -0
  72. package/dist/local/store/conformance/cases/durability.js.map +1 -0
  73. package/dist/local/store/conformance/cases/identity.d.ts +7 -0
  74. package/dist/local/store/conformance/cases/identity.d.ts.map +1 -0
  75. package/dist/local/store/conformance/cases/identity.js +84 -0
  76. package/dist/local/store/conformance/cases/identity.js.map +1 -0
  77. package/dist/local/store/conformance/cases/metadata.d.ts +7 -0
  78. package/dist/local/store/conformance/cases/metadata.d.ts.map +1 -0
  79. package/dist/local/store/conformance/cases/metadata.js +48 -0
  80. package/dist/local/store/conformance/cases/metadata.js.map +1 -0
  81. package/dist/local/store/conformance/cases/protection.d.ts +7 -0
  82. package/dist/local/store/conformance/cases/protection.d.ts.map +1 -0
  83. package/dist/local/store/conformance/cases/protection.js +14 -0
  84. package/dist/local/store/conformance/cases/protection.js.map +1 -0
  85. package/dist/local/store/conformance/cases/receive-work.d.ts +8 -0
  86. package/dist/local/store/conformance/cases/receive-work.d.ts.map +1 -0
  87. package/dist/local/store/conformance/cases/receive-work.js +152 -0
  88. package/dist/local/store/conformance/cases/receive-work.js.map +1 -0
  89. package/dist/local/store/conformance/cases/sender-key.d.ts +7 -0
  90. package/dist/local/store/conformance/cases/sender-key.d.ts.map +1 -0
  91. package/dist/local/store/conformance/cases/sender-key.js +59 -0
  92. package/dist/local/store/conformance/cases/sender-key.js.map +1 -0
  93. package/dist/local/store/conformance/cases/session-trust.d.ts +7 -0
  94. package/dist/local/store/conformance/cases/session-trust.d.ts.map +1 -0
  95. package/dist/local/store/conformance/cases/session-trust.js +64 -0
  96. package/dist/local/store/conformance/cases/session-trust.js.map +1 -0
  97. package/dist/local/store/conformance/checks.d.ts +15 -0
  98. package/dist/local/store/conformance/checks.d.ts.map +1 -0
  99. package/dist/local/store/conformance/checks.js +67 -0
  100. package/dist/local/store/conformance/checks.js.map +1 -0
  101. package/dist/local/store/conformance/index.d.ts +30 -0
  102. package/dist/local/store/conformance/index.d.ts.map +1 -0
  103. package/dist/local/store/conformance/index.js +29 -0
  104. package/dist/local/store/conformance/index.js.map +1 -0
  105. package/dist/local/store/conformance/records.d.ts +36 -0
  106. package/dist/local/store/conformance/records.d.ts.map +1 -0
  107. package/dist/local/store/conformance/records.js +109 -0
  108. package/dist/local/store/conformance/records.js.map +1 -0
  109. package/dist/local/store/conformance/run.d.ts +24 -0
  110. package/dist/local/store/conformance/run.d.ts.map +1 -0
  111. package/dist/local/store/conformance/run.js +156 -0
  112. package/dist/local/store/conformance/run.js.map +1 -0
  113. package/dist/local/store/conformance/types.d.ts +55 -0
  114. package/dist/local/store/conformance/types.d.ts.map +1 -0
  115. package/dist/local/store/conformance/types.js +6 -0
  116. package/dist/local/store/conformance/types.js.map +1 -0
  117. package/dist/local/store/expo/adapter.d.ts +2 -1
  118. package/dist/local/store/expo/adapter.d.ts.map +1 -1
  119. package/dist/local/store/expo/adapter.js.map +1 -1
  120. package/dist/local/store/node/adapter.d.ts +2 -2
  121. package/dist/local/store/react-native/adapter.d.ts +2 -1
  122. package/dist/local/store/react-native/adapter.d.ts.map +1 -1
  123. package/dist/local/store/react-native/adapter.js.map +1 -1
  124. package/dist/local/store/sqlite/convert-plaintext.d.ts +62 -0
  125. package/dist/local/store/sqlite/convert-plaintext.d.ts.map +1 -0
  126. package/dist/local/store/sqlite/convert-plaintext.js +236 -0
  127. package/dist/local/store/sqlite/convert-plaintext.js.map +1 -0
  128. package/dist/local/store/sqlite/driver.d.ts +9 -0
  129. package/dist/local/store/sqlite/driver.d.ts.map +1 -1
  130. package/dist/local/store/sqlite/encryption.d.ts +21 -0
  131. package/dist/local/store/sqlite/encryption.d.ts.map +1 -1
  132. package/dist/local/store/sqlite/encryption.js.map +1 -1
  133. package/dist/local/store/sqlite/errors.d.ts.map +1 -1
  134. package/dist/local/store/sqlite/errors.js +2 -1
  135. package/dist/local/store/sqlite/errors.js.map +1 -1
  136. package/dist/local/store/sqlite/key-storage/identity-keys.d.ts +3 -1
  137. package/dist/local/store/sqlite/key-storage/identity-keys.d.ts.map +1 -1
  138. package/dist/local/store/sqlite/key-storage/identity-keys.js +3 -1
  139. package/dist/local/store/sqlite/key-storage/identity-keys.js.map +1 -1
  140. package/dist/local/store/sqlite/open-store.d.ts +36 -4
  141. package/dist/local/store/sqlite/open-store.d.ts.map +1 -1
  142. package/dist/local/store/sqlite/open-store.js +326 -21
  143. package/dist/local/store/sqlite/open-store.js.map +1 -1
  144. package/dist/local/store/sqlite/web/sqlite3mc/sqlite3.mjs +2 -1
  145. package/dist/local/store/sqlite/web/worker.d.ts +13 -0
  146. package/dist/local/store/sqlite/web/worker.d.ts.map +1 -1
  147. package/dist/local/store/sqlite/web/worker.js +163 -22
  148. package/dist/local/store/sqlite/web/worker.js.map +1 -1
  149. package/dist/local/store/web-sqlite/adapter.d.ts +3 -2
  150. package/dist/local/store/web-sqlite/adapter.d.ts.map +1 -1
  151. package/dist/local/store/web-sqlite/adapter.js +12 -2
  152. package/dist/local/store/web-sqlite/adapter.js.map +1 -1
  153. package/dist/remote/relay/types.d.ts +4 -2
  154. package/dist/remote/relay/types.d.ts.map +1 -1
  155. package/dist/types/api.d.ts +20 -4
  156. package/dist/types/api.d.ts.map +1 -1
  157. package/docs/ASSURANCE.md +25 -7
  158. package/docs/DEVIATIONS.md +35 -3
  159. package/docs/ERROR_HANDLING.md +8 -6
  160. package/docs/GETTING_STARTED.md +15 -8
  161. package/docs/INTERFACES.md +3 -1
  162. package/docs/PACKAGE_SURFACE.md +1 -0
  163. package/docs/SECURITY.md +23 -5
  164. package/keys/README.md +3 -1
  165. package/local/store/README.md +92 -12
  166. package/local/store/expo/README.md +63 -6
  167. package/local/store/key-value/README.md +3 -2
  168. package/local/store/node/README.md +68 -6
  169. package/local/store/react-native/README.md +62 -4
  170. package/local/store/web-sqlite/README.md +73 -4
  171. package/package.json +5 -1
@@ -18,6 +18,15 @@
18
18
  * `encryptionAtRest: false` has no key, and its open and reset do not touch
19
19
  * the vault.
20
20
  *
21
+ * With `convertPlaintext: true`, an encrypted open converts a plaintext file
22
+ * and keeps its data. The driver seam has no rename, so the conversion copies
23
+ * twice: the plaintext file to a temporary encrypted file, then that file back
24
+ * to the store name. A pending vault slot holds the new key until the copy
25
+ * back is complete. Removing the plaintext file is the commit point. Before
26
+ * it, a failed conversion leaves the plaintext file, and the next conversion
27
+ * starts again with a new key. After it, the next encrypted open finishes the
28
+ * conversion, with or without the option.
29
+ *
21
30
  * In one process, the open and the reset of a database run one at a time, and
22
31
  * a database has at most one open store. Two first opens therefore cannot write
23
32
  * two different keys, and a reset or the driver's `exists` never runs on a
@@ -28,6 +37,8 @@
28
37
  import { generateRandomBytes } from '../../../internal/crypto/random.js';
29
38
  import { EncryptionError, EncryptionErrorCode } from '../../../types/errors.js';
30
39
  import { secretVaultCustody } from '../../vault/custody.js';
40
+ import { SQLITE_CONVERT_SUFFIX, copySqliteDatabase, openSqliteConversionSource, readSqliteUserVersion, sqliteConvertTempName, } from './convert-plaintext.js';
41
+ import { openSqliteDatabase } from './database.js';
31
42
  import { isPlaintextSqliteDatabase, readSqliteAtRest } from './encryption.js';
32
43
  import { SqliteKeyMismatchError } from './errors.js';
33
44
  import { openMigratedSqliteDatabase } from './migrations.js';
@@ -43,14 +54,26 @@ export function sqliteDatabaseKeySlot(identity) {
43
54
  return `signal_protocol_sqlite_key.${identity}`;
44
55
  }
45
56
  /**
46
- * Reject a name that is not safe as a file name on every platform, with the
47
- * error of {@link openSqliteStore}.
57
+ * The vault slot that holds the new key of the database `identity` while a
58
+ * conversion of it is incomplete. The prefix differs from the main slot.
59
+ */
60
+ function sqlitePendingKeySlot(identity) {
61
+ return `signal_protocol_sqlite_pending_key.${identity}`;
62
+ }
63
+ /**
64
+ * Reject a name that is not safe as a file name on every platform, or that
65
+ * names the temporary file of a conversion, with the error of
66
+ * {@link openSqliteStore}.
48
67
  */
49
68
  export function assertSqliteStoreName(name, operation) {
50
- if (STORE_NAME.test(name))
51
- return;
52
- throw new EncryptionError(`The SQLite store name ${JSON.stringify(name)} may contain only letters, digits, ` +
53
- '".", "_", and "-".', EncryptionErrorCode.INVALID_STATE, { operation });
69
+ if (!STORE_NAME.test(name)) {
70
+ throw new EncryptionError(`The SQLite store name ${JSON.stringify(name)} may contain only letters, digits, ` +
71
+ '".", "_", and "-".', EncryptionErrorCode.INVALID_STATE, { operation });
72
+ }
73
+ if (name.endsWith(SQLITE_CONVERT_SUFFIX)) {
74
+ throw new EncryptionError(`The SQLite store name ${JSON.stringify(name)} ends in ${SQLITE_CONVERT_SUFFIX}. ` +
75
+ 'The conversion to encryption uses that ending for its temporary file.', EncryptionErrorCode.INVALID_STATE, { operation });
76
+ }
54
77
  }
55
78
  /** The tail of the queued opens and resets of each database identity. */
56
79
  const pending = new Map();
@@ -61,11 +84,19 @@ const held = new Set();
61
84
  * migrations. On an encrypted store, the key comes from the vault. The key,
62
85
  * then the file, are created only when the file does not exist.
63
86
  *
87
+ * With `convertPlaintext: true`, an encrypted open of a plaintext file
88
+ * converts it. The store keeps every row and its schema version. An
89
+ * encrypted open also finishes a conversion that stopped after its commit
90
+ * point, with or without the option.
91
+ *
64
92
  * `close()` on the result closes the database and releases the name.
65
93
  *
66
94
  * @throws EncryptionError with `INVALID_STATE` when the name is not valid or
67
95
  * its database already has an open store in this process, or when a newer
68
- * SDK wrote the file.
96
+ * SDK wrote the file. Also when `convertPlaintext` comes with
97
+ * `encryptionAtRest: false`, when an open with `encryptionAtRest: false`
98
+ * finds an incomplete conversion, or when a plaintext file cannot be
99
+ * converted.
69
100
  * @throws EncryptionError with `LOCAL_STORE_KEY_LOST` when the file exists
70
101
  * and the vault holds no key for it.
71
102
  * @throws EncryptionError with `KEY_STORAGE_ERROR` when the vault fails or
@@ -76,20 +107,14 @@ export function openSqliteStore(options) {
76
107
  return oneAtATime(options, 'open', async () => {
77
108
  const { driver, name, vault } = options;
78
109
  if (options.encryptionAtRest === false) {
110
+ await refuseIncompleteConversion(driver, name, 'open');
79
111
  return openMigratedSqliteDatabase(driver, name, null, options);
80
112
  }
81
113
  const slot = sqliteDatabaseKeySlot(driver.identify(name));
82
114
  const storedKey = await readDatabaseKey(vault, slot);
83
115
  if (storedKey)
84
116
  return openMigratedSqliteDatabase(driver, name, storedKey, options);
85
- if (await driver.exists(name)) {
86
- if (await isPlaintextSqliteDatabase(driver, name)) {
87
- throw new SqliteKeyMismatchError(driver.name);
88
- }
89
- throw new EncryptionError(`The ${driver.name} database ${name} exists, but the secret vault holds no key for it. ` +
90
- 'Restore the vault entry, or reset the store to delete the database.', EncryptionErrorCode.LOCAL_STORE_KEY_LOST, { operation: 'open' });
91
- }
92
- return openMigratedSqliteDatabase(driver, name, await replaceDatabaseKey(vault, slot), options);
117
+ return openWithoutMainKey(options, slot);
93
118
  });
94
119
  }
95
120
  /**
@@ -101,19 +126,284 @@ export function openSqliteStore(options) {
101
126
  * {@link openSqliteStore} opens that state as a new store. The other order
102
127
  * would leave the old file under a key that no longer exists.
103
128
  *
129
+ * An encrypted reset also ends an incomplete conversion. It deletes the
130
+ * pending key first, then the temporary file, then the database. A process
131
+ * that stops after the key deletion cannot finish the conversion of the old
132
+ * data.
133
+ *
104
134
  * @throws EncryptionError with `INVALID_STATE` when the name is not valid or
105
- * its database already has an open store in this process.
135
+ * its database already has an open store in this process. Also when
136
+ * `convertPlaintext` comes with `encryptionAtRest: false`, or when a reset
137
+ * with `encryptionAtRest: false` finds an incomplete conversion.
106
138
  */
107
139
  export function resetSqliteStore(options) {
108
140
  return oneAtATime(options, 'reset', async () => {
109
141
  const { driver, name, vault } = options;
142
+ if (options.encryptionAtRest === false) {
143
+ await refuseIncompleteConversion(driver, name, 'reset');
144
+ await driver.remove(name);
145
+ return openMigratedSqliteDatabase(driver, name, null, options);
146
+ }
147
+ const identity = driver.identify(name);
148
+ await deleteDatabaseKey(vault, sqlitePendingKeySlot(identity));
149
+ const temp = sqliteConvertTempName(name);
150
+ if (await tempExists(driver, temp))
151
+ await driver.remove(temp);
110
152
  await driver.remove(name);
111
- const key = options.encryptionAtRest === false
112
- ? null
113
- : await replaceDatabaseKey(vault, sqliteDatabaseKeySlot(driver.identify(name)));
153
+ const key = await replaceDatabaseKey(vault, sqliteDatabaseKeySlot(identity));
114
154
  return openMigratedSqliteDatabase(driver, name, key, options);
115
155
  });
116
156
  }
157
+ /**
158
+ * The open of an encrypted store whose main slot holds no key. It creates a
159
+ * new store, converts a plaintext file, or finishes a conversion. Each state
160
+ * that a conversion can leave has one action.
161
+ *
162
+ * - The file is plaintext: convert it with the option, else report the
163
+ * setting mismatch.
164
+ * - The file is encrypted and the pending key opens it: the copy back ran.
165
+ * Copy back again when it did not commit, then finish.
166
+ * - Any other existing file: the key is lost.
167
+ * - No file, a pending key, and a complete temporary file: the plaintext
168
+ * file was removed. Copy back, then finish.
169
+ * - No file and no pending key, with a temporary file: refuse. Its key is
170
+ * not in this vault.
171
+ * - No file and no pending key: a new store.
172
+ * - No file, a pending key, and no complete temporary file: no data exists,
173
+ * so discard both and create a new store.
174
+ *
175
+ * The first read of the state takes no lock. Before the first write of a
176
+ * conversion or its recovery, the open takes the conversion lock and reads
177
+ * the state again.
178
+ */
179
+ async function openWithoutMainKey(options, slot, locked = false) {
180
+ const { driver, name, vault } = options;
181
+ const pendingSlot = sqlitePendingKeySlot(driver.identify(name));
182
+ const temp = sqliteConvertTempName(name);
183
+ const relock = () => withConversionLock(options, async () => {
184
+ const storedKey = await readDatabaseKey(vault, slot);
185
+ if (storedKey)
186
+ return openMigratedSqliteDatabase(driver, name, storedKey, options);
187
+ return openWithoutMainKey(options, slot, true);
188
+ });
189
+ if (await driver.exists(name)) {
190
+ if (await isPlaintextSqliteDatabase(driver, name)) {
191
+ await refuseCompleteCopy(options, pendingSlot);
192
+ if (!options.convertPlaintext)
193
+ throw new SqliteKeyMismatchError(driver.name);
194
+ if (!locked)
195
+ return relock();
196
+ const key = await convertPlaintextFile(options, pendingSlot);
197
+ return finish(options, slot, pendingSlot, key);
198
+ }
199
+ const pendingKey = await readDatabaseKey(vault, pendingSlot);
200
+ const version = pendingKey && (await readSqliteUserVersion(driver, name, pendingKey));
201
+ if (!pendingKey || version === null) {
202
+ throw new EncryptionError(`The ${driver.name} database ${name} exists, but the secret vault holds no key for it. ` +
203
+ 'Restore the vault entry, or reset the store to delete the database.', EncryptionErrorCode.LOCAL_STORE_KEY_LOST, { operation: 'open' });
204
+ }
205
+ if (!locked)
206
+ return relock();
207
+ if (version > 0)
208
+ return finish(options, slot, pendingSlot, pendingKey);
209
+ // The copy back did not commit, so the file holds no rows. The
210
+ // temporary file still holds them.
211
+ await driver.remove(name);
212
+ }
213
+ const pendingKey = await readDatabaseKey(vault, pendingSlot);
214
+ const tempPresent = await tempExists(driver, temp);
215
+ if (!pendingKey) {
216
+ if (tempPresent) {
217
+ throw new EncryptionError(`The temporary file ${temp} of a conversion to encryption exists without its database ` +
218
+ `${name}, and the secret vault holds no key for it. The store did not change it. ` +
219
+ 'Restore the vault entry, or reset the store to delete all data.', EncryptionErrorCode.INVALID_STATE, { operation: 'open' });
220
+ }
221
+ return openMigratedSqliteDatabase(driver, name, await replaceDatabaseKey(vault, slot), options);
222
+ }
223
+ if (!locked)
224
+ return relock();
225
+ if (tempPresent && ((await readSqliteUserVersion(driver, temp, pendingKey)) ?? 0) > 0) {
226
+ return finish(options, slot, pendingSlot, pendingKey);
227
+ }
228
+ // No step of a conversion leaves a pending key without the database and
229
+ // without a complete temporary file. Nothing holds data, so start anew.
230
+ await deleteDatabaseKey(vault, pendingSlot);
231
+ if (tempPresent)
232
+ await driver.remove(temp);
233
+ const key = await replaceDatabaseKey(vault, slot);
234
+ return openMigratedSqliteDatabase(driver, name, key, options);
235
+ }
236
+ /**
237
+ * Refuse to convert a plaintext file when a complete encrypted copy of a
238
+ * conversion exists beside it. This SDK removes the plaintext file right
239
+ * after the copy commits. An older SDK can create a new, empty plaintext
240
+ * file after that removal. The open does not choose between the two files.
241
+ */
242
+ async function refuseCompleteCopy({ driver, name, vault }, pendingSlot) {
243
+ const pendingKey = await readDatabaseKey(vault, pendingSlot);
244
+ if (!pendingKey)
245
+ return;
246
+ const temp = sqliteConvertTempName(name);
247
+ if (!(await tempExists(driver, temp)))
248
+ return;
249
+ if (((await readSqliteUserVersion(driver, temp, pendingKey)) ?? 0) === 0)
250
+ return;
251
+ throw new EncryptionError(`The plaintext database ${name} and the complete encrypted copy ${temp} of a conversion ` +
252
+ `both exist, so the store did not open. Remove ${name} to finish the conversion from ` +
253
+ 'the copy, or reset the store to delete all data.', EncryptionErrorCode.INVALID_STATE, { operation: 'open' });
254
+ }
255
+ /**
256
+ * Convert the plaintext file of the store to an encrypted temporary file, and
257
+ * remove the plaintext file. Return the pending key, which encrypts the
258
+ * temporary file. The removal is the commit point. The caller holds the
259
+ * conversion lock.
260
+ */
261
+ async function convertPlaintextFile(options, pendingSlot) {
262
+ const { driver, name, vault } = options;
263
+ const temp = sqliteConvertTempName(name);
264
+ let source = await openSqliteConversionSource(driver, name);
265
+ let committed = false;
266
+ try {
267
+ const tempPresent = await tempExistsForConversion(driver, temp);
268
+ // A conversion that stopped before its commit point leaves its key and
269
+ // its temporary file. Discard both, and start again with a new key.
270
+ await deleteDatabaseKey(vault, pendingSlot);
271
+ const pendingKey = await replaceDatabaseKey(vault, pendingSlot);
272
+ if (tempPresent)
273
+ await driver.remove(temp);
274
+ const target = await openSqliteDatabase(driver, temp, pendingKey, options);
275
+ try {
276
+ await copySqliteDatabase(source, target);
277
+ }
278
+ finally {
279
+ await target.close();
280
+ }
281
+ const closing = source;
282
+ source = null;
283
+ await closing.close();
284
+ await driver.remove(name);
285
+ committed = true;
286
+ return pendingKey;
287
+ }
288
+ catch (error) {
289
+ // The conversion error is the one to report. A failed close adds nothing.
290
+ await source?.close().catch(() => undefined);
291
+ if (!committed)
292
+ await discardConversion(options, pendingSlot);
293
+ throw error;
294
+ }
295
+ }
296
+ /**
297
+ * Copy the complete temporary file back to the store name, under the
298
+ * pending key that encrypts both.
299
+ */
300
+ async function copyBack(options, pendingKey) {
301
+ const { driver, name } = options;
302
+ const source = await openSqliteDatabase(driver, sqliteConvertTempName(name), pendingKey, options);
303
+ try {
304
+ const target = await openSqliteDatabase(driver, name, pendingKey, options);
305
+ try {
306
+ await copySqliteDatabase(source, target);
307
+ }
308
+ finally {
309
+ await target.close();
310
+ }
311
+ }
312
+ finally {
313
+ await source.close();
314
+ }
315
+ }
316
+ /**
317
+ * Finish a conversion whose copy back committed: remove the temporary file,
318
+ * move the pending key to the main slot, and open the store.
319
+ */
320
+ async function finish(options, slot, pendingSlot, key) {
321
+ const { driver, name, vault } = options;
322
+ if (!(await driver.exists(name)))
323
+ await copyBack(options, key);
324
+ const temp = sqliteConvertTempName(name);
325
+ if (await tempExists(driver, temp))
326
+ await driver.remove(temp);
327
+ // The vault has no atomic move. A stop between the two writes leaves the
328
+ // same key in both slots. The open ignores the pending slot then, and a
329
+ // reset deletes it.
330
+ await writeDatabaseKey(vault, slot, key);
331
+ await deleteDatabaseKey(vault, pendingSlot);
332
+ return openMigratedSqliteDatabase(driver, name, key, options);
333
+ }
334
+ /**
335
+ * Undo a conversion that failed before its commit point: remove the
336
+ * temporary file, then delete the pending key. A failure here leaves a state
337
+ * that the next conversion discards.
338
+ */
339
+ async function discardConversion({ driver, name, vault }, pendingSlot) {
340
+ try {
341
+ const temp = sqliteConvertTempName(name);
342
+ if (await tempExists(driver, temp))
343
+ await driver.remove(temp);
344
+ await vault.deleteSecret(pendingSlot);
345
+ }
346
+ catch {
347
+ // The conversion error is the one to report.
348
+ }
349
+ }
350
+ /** Run `task` while the entry holds the lock that a conversion needs. */
351
+ async function withConversionLock(options, task) {
352
+ const release = options.lockConversion ? await options.lockConversion() : undefined;
353
+ try {
354
+ return await task();
355
+ }
356
+ finally {
357
+ release?.();
358
+ }
359
+ }
360
+ /**
361
+ * Refuse an open or a reset with `encryptionAtRest: false` while a
362
+ * conversion to encryption is incomplete. Such an open would create a new
363
+ * plaintext file, and such a reset would leave the encrypted copy.
364
+ */
365
+ async function refuseIncompleteConversion(driver, name, operation) {
366
+ const temp = sqliteConvertTempName(name);
367
+ if (!(await tempExists(driver, temp)))
368
+ return;
369
+ throw new EncryptionError(`The SQLite store ${name} has an incomplete conversion to encryption: its temporary file ` +
370
+ `${temp} exists. Open the store with encryption to finish the conversion, or reset it ` +
371
+ 'with encryption to delete all data.', EncryptionErrorCode.INVALID_STATE, { operation });
372
+ }
373
+ /**
374
+ * Report whether the temporary file of a conversion exists. A driver that
375
+ * refuses the name, such as the web driver for a name that is too long, has
376
+ * no such file.
377
+ */
378
+ async function tempExists(driver, temp) {
379
+ try {
380
+ return await driver.exists(temp);
381
+ }
382
+ catch (error) {
383
+ if (isInvalidState(error))
384
+ return false;
385
+ throw error;
386
+ }
387
+ }
388
+ /**
389
+ * Report whether the temporary file of a conversion exists, and refuse a
390
+ * conversion on a driver that does not accept its name. The check runs
391
+ * before the first write.
392
+ */
393
+ async function tempExistsForConversion(driver, temp) {
394
+ try {
395
+ return await driver.exists(temp);
396
+ }
397
+ catch (error) {
398
+ if (!isInvalidState(error))
399
+ throw error;
400
+ throw new EncryptionError(`The ${driver.name} driver does not accept the name ${temp} of the temporary file of a ` +
401
+ 'conversion. Use a shorter store name.', EncryptionErrorCode.INVALID_STATE, { operation: 'open', originalError: error });
402
+ }
403
+ }
404
+ function isInvalidState(error) {
405
+ return error instanceof EncryptionError && error.code === EncryptionErrorCode.INVALID_STATE;
406
+ }
117
407
  /**
118
408
  * Read the protection of a database that {@link openSqliteStore} or
119
409
  * {@link resetSqliteStore} opened: the encryption that the database records,
@@ -137,9 +427,13 @@ export async function readSqliteStoreProtection(db, vault) {
137
427
  * it while the database has an open store. The database stays held until the
138
428
  * returned executor closes.
139
429
  */
140
- function oneAtATime({ driver, name }, operation, task) {
430
+ function oneAtATime({ driver, name, encryptionAtRest, convertPlaintext }, operation, task) {
141
431
  try {
142
432
  assertSqliteStoreName(name, operation);
433
+ if (convertPlaintext === true && encryptionAtRest === false) {
434
+ throw new EncryptionError('convertPlaintext converts a plaintext SQLite store to an encrypted one, so it does ' +
435
+ 'not apply with encryptionAtRest: false.', EncryptionErrorCode.INVALID_STATE, { operation });
436
+ }
143
437
  }
144
438
  catch (error) {
145
439
  return Promise.reject(error);
@@ -185,12 +479,23 @@ async function readDatabaseKey(vault, slot) {
185
479
  /** Create a new database key and write it to the vault, over any old key. */
186
480
  async function replaceDatabaseKey(vault, slot) {
187
481
  const key = await generateRandomBytes(DATABASE_KEY_SIZE);
482
+ await writeDatabaseKey(vault, slot, key);
483
+ return key;
484
+ }
485
+ async function writeDatabaseKey(vault, slot, key) {
188
486
  try {
189
487
  await vault.setSecret(slot, key);
190
488
  }
191
489
  catch (error) {
192
490
  throw new EncryptionError('Failed to write the database key to the secret vault', EncryptionErrorCode.KEY_STORAGE_ERROR, { operation: 'open', originalError: error });
193
491
  }
194
- return key;
492
+ }
493
+ async function deleteDatabaseKey(vault, slot) {
494
+ try {
495
+ await vault.deleteSecret(slot);
496
+ }
497
+ catch (error) {
498
+ throw new EncryptionError('Failed to delete a database key from the secret vault', EncryptionErrorCode.KEY_STORAGE_ERROR, { operation: 'open', originalError: error });
499
+ }
195
500
  }
196
501
  //# sourceMappingURL=open-store.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"open-store.js","sourceRoot":"","sources":["../../../../local/store/sqlite/open-store.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"open-store.js","sourceRoot":"","sources":["../../../../local/store/sqlite/open-store.ts"],"names":[],"mappings":"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"}
@@ -13499,7 +13499,8 @@ globalThis.sqlite3ApiBootstrap.initializers.push(function(sqlite3){
13499
13499
  const pool = getPoolForPFile(pFile);
13500
13500
  pool.log('xCheckReservedLock');
13501
13501
  pool.storeErr();
13502
- wasm.poke32(pOut, 1);
13502
+ // open-e2ee: the pool allows one connection, so nothing holds the lock.
13503
+ wasm.poke32(pOut, 0);
13503
13504
  return 0;
13504
13505
  },
13505
13506
  xClose: function(pFile){
@@ -32,8 +32,21 @@
32
32
  * `STORAGE_QUOTA_EXCEEDED`, and the next attach adds slot files up to the
33
33
  * two that an open needs.
34
34
  *
35
+ * An existence check and a removal attach the pool as every request does,
36
+ * so a full quota fails them before the core writes a key. After the check
37
+ * or the removal, a pool that holds no file goes, with its directory. So a
38
+ * check for a file that does not exist leaves nothing in OPFS.
39
+ *
35
40
  * The logical connection that the driver returns stays pinned to its file
36
41
  * across these physical reopens.
42
+ *
43
+ * The core keeps the default rollback journal. An open plays a hot journal
44
+ * back before its first read, so a tab killed inside a commit leaves a store
45
+ * that the next open restores to the last commit. The patched engine reports
46
+ * no reserved lock, so that the playback runs; see `./sqlite3mc/README.md`.
47
+ * A playback through the wrong key state would leave the file corrupt, so an
48
+ * open reads the state of the file first, through an immutable read-only
49
+ * connection with no key, and rejects a key state that does not match.
37
50
  */
38
51
  export {};
39
52
  //# sourceMappingURL=worker.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../../../local/store/sqlite/web/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG"}
1
+ {"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../../../local/store/sqlite/web/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG"}