@terreno/syncdb 56.0.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (317) hide show
  1. package/README.md +419 -0
  2. package/dist/auth/betterAuthAdapter.d.ts +22 -0
  3. package/dist/auth/betterAuthAdapter.d.ts.map +1 -0
  4. package/dist/auth/betterAuthAdapter.js +181 -0
  5. package/dist/auth/betterAuthAdapter.js.map +1 -0
  6. package/dist/auth/betterAuthAdapter.test.d.ts +2 -0
  7. package/dist/auth/betterAuthAdapter.test.d.ts.map +1 -0
  8. package/dist/auth/betterAuthAdapter.test.js +350 -0
  9. package/dist/auth/betterAuthAdapter.test.js.map +1 -0
  10. package/dist/auth/types.d.ts +42 -0
  11. package/dist/auth/types.d.ts.map +1 -0
  12. package/dist/auth/types.js +9 -0
  13. package/dist/auth/types.js.map +1 -0
  14. package/dist/client.d.ts +246 -0
  15. package/dist/client.d.ts.map +1 -0
  16. package/dist/client.js +1415 -0
  17. package/dist/client.js.map +1 -0
  18. package/dist/client.test.d.ts +2 -0
  19. package/dist/client.test.d.ts.map +1 -0
  20. package/dist/client.test.js +2310 -0
  21. package/dist/client.test.js.map +1 -0
  22. package/dist/crypto/aesGcmCodec.d.ts +33 -0
  23. package/dist/crypto/aesGcmCodec.d.ts.map +1 -0
  24. package/dist/crypto/aesGcmCodec.js +80 -0
  25. package/dist/crypto/aesGcmCodec.js.map +1 -0
  26. package/dist/crypto/aesGcmCodec.test.d.ts +2 -0
  27. package/dist/crypto/aesGcmCodec.test.d.ts.map +1 -0
  28. package/dist/crypto/aesGcmCodec.test.js +83 -0
  29. package/dist/crypto/aesGcmCodec.test.js.map +1 -0
  30. package/dist/crypto/identityCodec.d.ts +7 -0
  31. package/dist/crypto/identityCodec.d.ts.map +1 -0
  32. package/dist/crypto/identityCodec.js +9 -0
  33. package/dist/crypto/identityCodec.js.map +1 -0
  34. package/dist/crypto/keyProviders.d.ts +34 -0
  35. package/dist/crypto/keyProviders.d.ts.map +1 -0
  36. package/dist/crypto/keyProviders.js +102 -0
  37. package/dist/crypto/keyProviders.js.map +1 -0
  38. package/dist/crypto/keyProviders.test.d.ts +2 -0
  39. package/dist/crypto/keyProviders.test.d.ts.map +1 -0
  40. package/dist/crypto/keyProviders.test.js +189 -0
  41. package/dist/crypto/keyProviders.test.js.map +1 -0
  42. package/dist/crypto/types.d.ts +24 -0
  43. package/dist/crypto/types.d.ts.map +1 -0
  44. package/dist/crypto/types.js +8 -0
  45. package/dist/crypto/types.js.map +1 -0
  46. package/dist/debug/debugChannel.d.ts +52 -0
  47. package/dist/debug/debugChannel.d.ts.map +1 -0
  48. package/dist/debug/debugChannel.js +73 -0
  49. package/dist/debug/debugChannel.js.map +1 -0
  50. package/dist/debug/debugChannel.test.d.ts +2 -0
  51. package/dist/debug/debugChannel.test.d.ts.map +1 -0
  52. package/dist/debug/debugChannel.test.js +105 -0
  53. package/dist/debug/debugChannel.test.js.map +1 -0
  54. package/dist/debug/debugLog.d.ts +111 -0
  55. package/dist/debug/debugLog.d.ts.map +1 -0
  56. package/dist/debug/debugLog.js +150 -0
  57. package/dist/debug/debugLog.js.map +1 -0
  58. package/dist/debug/debugLog.test.d.ts +2 -0
  59. package/dist/debug/debugLog.test.d.ts.map +1 -0
  60. package/dist/debug/debugLog.test.js +121 -0
  61. package/dist/debug/debugLog.test.js.map +1 -0
  62. package/dist/index.d.ts +46 -0
  63. package/dist/index.d.ts.map +1 -0
  64. package/dist/index.js +51 -0
  65. package/dist/index.js.map +1 -0
  66. package/dist/isolated/defaultPersisterFactoryNative.isolated.d.ts +2 -0
  67. package/dist/isolated/defaultPersisterFactoryNative.isolated.d.ts.map +1 -0
  68. package/dist/isolated/defaultPersisterFactoryNative.isolated.js +38 -0
  69. package/dist/isolated/defaultPersisterFactoryNative.isolated.js.map +1 -0
  70. package/dist/mutations/conflicts.d.ts +31 -0
  71. package/dist/mutations/conflicts.d.ts.map +1 -0
  72. package/dist/mutations/conflicts.js +73 -0
  73. package/dist/mutations/conflicts.js.map +1 -0
  74. package/dist/mutations/outbox.d.ts +174 -0
  75. package/dist/mutations/outbox.d.ts.map +1 -0
  76. package/dist/mutations/outbox.js +385 -0
  77. package/dist/mutations/outbox.js.map +1 -0
  78. package/dist/mutations/outbox.test.d.ts +2 -0
  79. package/dist/mutations/outbox.test.d.ts.map +1 -0
  80. package/dist/mutations/outbox.test.js +643 -0
  81. package/dist/mutations/outbox.test.js.map +1 -0
  82. package/dist/mutations/resolveConflict.d.ts +32 -0
  83. package/dist/mutations/resolveConflict.d.ts.map +1 -0
  84. package/dist/mutations/resolveConflict.js +101 -0
  85. package/dist/mutations/resolveConflict.js.map +1 -0
  86. package/dist/mutations/resolveConflict.test.d.ts +2 -0
  87. package/dist/mutations/resolveConflict.test.d.ts.map +1 -0
  88. package/dist/mutations/resolveConflict.test.js +282 -0
  89. package/dist/mutations/resolveConflict.test.js.map +1 -0
  90. package/dist/persisters/defaultPersisterFactory.d.ts +9 -0
  91. package/dist/persisters/defaultPersisterFactory.d.ts.map +1 -0
  92. package/dist/persisters/defaultPersisterFactory.js +9 -0
  93. package/dist/persisters/defaultPersisterFactory.js.map +1 -0
  94. package/dist/persisters/defaultPersisterFactory.native.d.ts +10 -0
  95. package/dist/persisters/defaultPersisterFactory.native.d.ts.map +1 -0
  96. package/dist/persisters/defaultPersisterFactory.native.js +44 -0
  97. package/dist/persisters/defaultPersisterFactory.native.js.map +1 -0
  98. package/dist/persisters/defaultPersisterFactory.test.d.ts +2 -0
  99. package/dist/persisters/defaultPersisterFactory.test.d.ts.map +1 -0
  100. package/dist/persisters/defaultPersisterFactory.test.js +177 -0
  101. package/dist/persisters/defaultPersisterFactory.test.js.map +1 -0
  102. package/dist/persisters/defaultPersisterFactory.web.d.ts +17 -0
  103. package/dist/persisters/defaultPersisterFactory.web.d.ts.map +1 -0
  104. package/dist/persisters/defaultPersisterFactory.web.js +65 -0
  105. package/dist/persisters/defaultPersisterFactory.web.js.map +1 -0
  106. package/dist/persisters/encryptedIndexedDbPersister.d.ts +46 -0
  107. package/dist/persisters/encryptedIndexedDbPersister.d.ts.map +1 -0
  108. package/dist/persisters/encryptedIndexedDbPersister.js +171 -0
  109. package/dist/persisters/encryptedIndexedDbPersister.js.map +1 -0
  110. package/dist/persisters/encryptedIndexedDbPersister.test.d.ts +2 -0
  111. package/dist/persisters/encryptedIndexedDbPersister.test.d.ts.map +1 -0
  112. package/dist/persisters/encryptedIndexedDbPersister.test.js +352 -0
  113. package/dist/persisters/encryptedIndexedDbPersister.test.js.map +1 -0
  114. package/dist/persisters/memoryPersister.d.ts +19 -0
  115. package/dist/persisters/memoryPersister.d.ts.map +1 -0
  116. package/dist/persisters/memoryPersister.js +31 -0
  117. package/dist/persisters/memoryPersister.js.map +1 -0
  118. package/dist/persisters/memoryPersister.test.d.ts +2 -0
  119. package/dist/persisters/memoryPersister.test.d.ts.map +1 -0
  120. package/dist/persisters/memoryPersister.test.js +113 -0
  121. package/dist/persisters/memoryPersister.test.js.map +1 -0
  122. package/dist/persisters/types.d.ts +65 -0
  123. package/dist/persisters/types.d.ts.map +1 -0
  124. package/dist/persisters/types.js +2 -0
  125. package/dist/persisters/types.js.map +1 -0
  126. package/dist/react/hooks.d.ts +132 -0
  127. package/dist/react/hooks.d.ts.map +1 -0
  128. package/dist/react/hooks.js +269 -0
  129. package/dist/react/hooks.js.map +1 -0
  130. package/dist/react/hooks.test.d.ts +2 -0
  131. package/dist/react/hooks.test.d.ts.map +1 -0
  132. package/dist/react/hooks.test.js +645 -0
  133. package/dist/react/hooks.test.js.map +1 -0
  134. package/dist/react/index.d.ts +11 -0
  135. package/dist/react/index.d.ts.map +1 -0
  136. package/dist/react/index.js +11 -0
  137. package/dist/react/index.js.map +1 -0
  138. package/dist/react/provider.d.ts +11 -0
  139. package/dist/react/provider.d.ts.map +1 -0
  140. package/dist/react/provider.js +17 -0
  141. package/dist/react/provider.js.map +1 -0
  142. package/dist/storage/idb.d.ts +27 -0
  143. package/dist/storage/idb.d.ts.map +1 -0
  144. package/dist/storage/idb.js +72 -0
  145. package/dist/storage/idb.js.map +1 -0
  146. package/dist/storage/idb.test.d.ts +2 -0
  147. package/dist/storage/idb.test.d.ts.map +1 -0
  148. package/dist/storage/idb.test.js +100 -0
  149. package/dist/storage/idb.test.js.map +1 -0
  150. package/dist/storage/purgeUnknownStream.test.d.ts +2 -0
  151. package/dist/storage/purgeUnknownStream.test.d.ts.map +1 -0
  152. package/dist/storage/purgeUnknownStream.test.js +64 -0
  153. package/dist/storage/purgeUnknownStream.test.js.map +1 -0
  154. package/dist/storage/schema.d.ts +33 -0
  155. package/dist/storage/schema.d.ts.map +1 -0
  156. package/dist/storage/schema.js +92 -0
  157. package/dist/storage/schema.js.map +1 -0
  158. package/dist/storage/store.d.ts +136 -0
  159. package/dist/storage/store.d.ts.map +1 -0
  160. package/dist/storage/store.js +275 -0
  161. package/dist/storage/store.js.map +1 -0
  162. package/dist/storage/store.test.d.ts +2 -0
  163. package/dist/storage/store.test.d.ts.map +1 -0
  164. package/dist/storage/store.test.js +357 -0
  165. package/dist/storage/store.test.js.map +1 -0
  166. package/dist/storage/types.d.ts +146 -0
  167. package/dist/storage/types.d.ts.map +1 -0
  168. package/dist/storage/types.js +32 -0
  169. package/dist/storage/types.js.map +1 -0
  170. package/dist/storage/wipe.d.ts +22 -0
  171. package/dist/storage/wipe.d.ts.map +1 -0
  172. package/dist/storage/wipe.js +43 -0
  173. package/dist/storage/wipe.js.map +1 -0
  174. package/dist/storage/wipe.test.d.ts +2 -0
  175. package/dist/storage/wipe.test.d.ts.map +1 -0
  176. package/dist/storage/wipe.test.js +95 -0
  177. package/dist/storage/wipe.test.js.map +1 -0
  178. package/dist/sync/bootstrap.d.ts +64 -0
  179. package/dist/sync/bootstrap.d.ts.map +1 -0
  180. package/dist/sync/bootstrap.js +160 -0
  181. package/dist/sync/bootstrap.js.map +1 -0
  182. package/dist/sync/bootstrap.test.d.ts +2 -0
  183. package/dist/sync/bootstrap.test.d.ts.map +1 -0
  184. package/dist/sync/bootstrap.test.js +447 -0
  185. package/dist/sync/bootstrap.test.js.map +1 -0
  186. package/dist/sync/cursor.d.ts +67 -0
  187. package/dist/sync/cursor.d.ts.map +1 -0
  188. package/dist/sync/cursor.js +74 -0
  189. package/dist/sync/cursor.js.map +1 -0
  190. package/dist/sync/cursor.test.d.ts +2 -0
  191. package/dist/sync/cursor.test.d.ts.map +1 -0
  192. package/dist/sync/cursor.test.js +73 -0
  193. package/dist/sync/cursor.test.js.map +1 -0
  194. package/dist/sync/deltaApplier.d.ts +30 -0
  195. package/dist/sync/deltaApplier.d.ts.map +1 -0
  196. package/dist/sync/deltaApplier.js +61 -0
  197. package/dist/sync/deltaApplier.js.map +1 -0
  198. package/dist/sync/deltaApplier.test.d.ts +2 -0
  199. package/dist/sync/deltaApplier.test.d.ts.map +1 -0
  200. package/dist/sync/deltaApplier.test.js +212 -0
  201. package/dist/sync/deltaApplier.test.js.map +1 -0
  202. package/dist/sync/entityRepair.d.ts +45 -0
  203. package/dist/sync/entityRepair.d.ts.map +1 -0
  204. package/dist/sync/entityRepair.js +91 -0
  205. package/dist/sync/entityRepair.js.map +1 -0
  206. package/dist/sync/entityRepair.test.d.ts +2 -0
  207. package/dist/sync/entityRepair.test.d.ts.map +1 -0
  208. package/dist/sync/entityRepair.test.js +146 -0
  209. package/dist/sync/entityRepair.test.js.map +1 -0
  210. package/dist/sync/httpChannel.d.ts +74 -0
  211. package/dist/sync/httpChannel.d.ts.map +1 -0
  212. package/dist/sync/httpChannel.js +123 -0
  213. package/dist/sync/httpChannel.js.map +1 -0
  214. package/dist/sync/httpChannel.test.d.ts +2 -0
  215. package/dist/sync/httpChannel.test.d.ts.map +1 -0
  216. package/dist/sync/httpChannel.test.js +215 -0
  217. package/dist/sync/httpChannel.test.js.map +1 -0
  218. package/dist/sync/replayCoordinator.d.ts +212 -0
  219. package/dist/sync/replayCoordinator.d.ts.map +1 -0
  220. package/dist/sync/replayCoordinator.js +1110 -0
  221. package/dist/sync/replayCoordinator.js.map +1 -0
  222. package/dist/sync/replayCoordinator.test.d.ts +2 -0
  223. package/dist/sync/replayCoordinator.test.d.ts.map +1 -0
  224. package/dist/sync/replayCoordinator.test.js +1496 -0
  225. package/dist/sync/replayCoordinator.test.js.map +1 -0
  226. package/dist/sync/socketTransport.d.ts +56 -0
  227. package/dist/sync/socketTransport.d.ts.map +1 -0
  228. package/dist/sync/socketTransport.js +292 -0
  229. package/dist/sync/socketTransport.js.map +1 -0
  230. package/dist/sync/socketTransport.test.d.ts +2 -0
  231. package/dist/sync/socketTransport.test.d.ts.map +1 -0
  232. package/dist/sync/socketTransport.test.js +346 -0
  233. package/dist/sync/socketTransport.test.js.map +1 -0
  234. package/dist/sync/transport.d.ts +80 -0
  235. package/dist/sync/transport.d.ts.map +1 -0
  236. package/dist/sync/transport.js +5 -0
  237. package/dist/sync/transport.js.map +1 -0
  238. package/dist/testing/fakeTransport.d.ts +55 -0
  239. package/dist/testing/fakeTransport.d.ts.map +1 -0
  240. package/dist/testing/fakeTransport.js +139 -0
  241. package/dist/testing/fakeTransport.js.map +1 -0
  242. package/dist/testing/fakeTransport.test.d.ts +2 -0
  243. package/dist/testing/fakeTransport.test.d.ts.map +1 -0
  244. package/dist/testing/fakeTransport.test.js +112 -0
  245. package/dist/testing/fakeTransport.test.js.map +1 -0
  246. package/dist/testing/index.d.ts +13 -0
  247. package/dist/testing/index.d.ts.map +1 -0
  248. package/dist/testing/index.js +13 -0
  249. package/dist/testing/index.js.map +1 -0
  250. package/dist/types.d.ts +271 -0
  251. package/dist/types.d.ts.map +1 -0
  252. package/dist/types.js +9 -0
  253. package/dist/types.js.map +1 -0
  254. package/package.json +71 -0
  255. package/src/auth/betterAuthAdapter.test.ts +455 -0
  256. package/src/auth/betterAuthAdapter.ts +214 -0
  257. package/src/auth/types.ts +49 -0
  258. package/src/client.test.ts +2670 -0
  259. package/src/client.ts +1748 -0
  260. package/src/crypto/aesGcmCodec.test.ts +103 -0
  261. package/src/crypto/aesGcmCodec.ts +98 -0
  262. package/src/crypto/identityCodec.ts +10 -0
  263. package/src/crypto/keyProviders.test.ts +228 -0
  264. package/src/crypto/keyProviders.ts +153 -0
  265. package/src/crypto/types.ts +23 -0
  266. package/src/debug/debugChannel.test.ts +121 -0
  267. package/src/debug/debugChannel.ts +112 -0
  268. package/src/debug/debugLog.test.ts +139 -0
  269. package/src/debug/debugLog.ts +272 -0
  270. package/src/index.ts +157 -0
  271. package/src/isolated/defaultPersisterFactoryNative.isolated.ts +45 -0
  272. package/src/mutations/conflicts.ts +108 -0
  273. package/src/mutations/outbox.test.ts +754 -0
  274. package/src/mutations/outbox.ts +585 -0
  275. package/src/mutations/resolveConflict.test.ts +338 -0
  276. package/src/mutations/resolveConflict.ts +115 -0
  277. package/src/persisters/defaultPersisterFactory.native.ts +53 -0
  278. package/src/persisters/defaultPersisterFactory.test.ts +207 -0
  279. package/src/persisters/defaultPersisterFactory.ts +12 -0
  280. package/src/persisters/defaultPersisterFactory.web.ts +78 -0
  281. package/src/persisters/encryptedIndexedDbPersister.test.ts +381 -0
  282. package/src/persisters/encryptedIndexedDbPersister.ts +218 -0
  283. package/src/persisters/memoryPersister.test.ts +136 -0
  284. package/src/persisters/memoryPersister.ts +52 -0
  285. package/src/persisters/types.ts +71 -0
  286. package/src/react/hooks.test.tsx +761 -0
  287. package/src/react/hooks.ts +409 -0
  288. package/src/react/index.ts +11 -0
  289. package/src/react/provider.tsx +27 -0
  290. package/src/storage/idb.test.ts +116 -0
  291. package/src/storage/idb.ts +112 -0
  292. package/src/storage/purgeUnknownStream.test.ts +74 -0
  293. package/src/storage/schema.ts +103 -0
  294. package/src/storage/store.test.ts +424 -0
  295. package/src/storage/store.ts +461 -0
  296. package/src/storage/types.ts +159 -0
  297. package/src/storage/wipe.test.ts +111 -0
  298. package/src/storage/wipe.ts +58 -0
  299. package/src/sync/bootstrap.test.ts +486 -0
  300. package/src/sync/bootstrap.ts +217 -0
  301. package/src/sync/cursor.test.ts +84 -0
  302. package/src/sync/cursor.ts +113 -0
  303. package/src/sync/deltaApplier.test.ts +237 -0
  304. package/src/sync/deltaApplier.ts +84 -0
  305. package/src/sync/entityRepair.test.ts +161 -0
  306. package/src/sync/entityRepair.ts +124 -0
  307. package/src/sync/httpChannel.test.ts +265 -0
  308. package/src/sync/httpChannel.ts +220 -0
  309. package/src/sync/replayCoordinator.test.ts +1709 -0
  310. package/src/sync/replayCoordinator.ts +1370 -0
  311. package/src/sync/socketTransport.test.ts +413 -0
  312. package/src/sync/socketTransport.ts +379 -0
  313. package/src/sync/transport.ts +76 -0
  314. package/src/testing/fakeTransport.test.ts +125 -0
  315. package/src/testing/fakeTransport.ts +206 -0
  316. package/src/testing/index.ts +18 -0
  317. package/src/types.ts +284 -0
@@ -0,0 +1,207 @@
1
+ import "fake-indexeddb/auto";
2
+
3
+ import {describe, expect, it, mock} from "bun:test";
4
+
5
+ import {createLocalKeyProvider} from "../crypto/keyProviders";
6
+ import {idbSet} from "../storage/idb";
7
+ import {createSyncStore, type SyncStore} from "../storage/store";
8
+ import {createDefaultPersisterFactory as createBaseFactory} from "./defaultPersisterFactory";
9
+ import {createDefaultPersisterFactory as createWebFactory} from "./defaultPersisterFactory.web";
10
+
11
+ let dbCounter = 0;
12
+ const uniqueDbName = (): string => `default-factory-test-${Date.now()}-${dbCounter++}`;
13
+
14
+ const makeStore = (): SyncStore => createSyncStore({collections: ["todos"]});
15
+
16
+ /** Read the raw persisted record via the plain IndexedDB API. */
17
+ const readRawRecord = (databaseName: string): Promise<unknown> =>
18
+ new Promise((resolve, reject) => {
19
+ const open = indexedDB.open(databaseName);
20
+ open.onerror = (): void => reject(open.error);
21
+ open.onsuccess = (): void => {
22
+ const db = open.result;
23
+ const request = db.transaction("kv", "readonly").objectStore("kv").get("content");
24
+ request.onsuccess = (): void => {
25
+ db.close();
26
+ resolve(request.result);
27
+ };
28
+ request.onerror = (): void => {
29
+ db.close();
30
+ reject(request.error);
31
+ };
32
+ };
33
+ });
34
+
35
+ describe("createDefaultPersisterFactory (native)", () => {
36
+ // expo-sqlite is only a peer of @terreno/syncdb, so an app that depends on it indirectly gets
37
+ // the JS package without the autolinked native module. That used to surface as
38
+ // "Cannot read property 'openDatabaseSync' of undefined", which named neither the package to
39
+ // install nor the rebuild it needs.
40
+ it("explains what to install when the expo-sqlite native module is absent", async () => {
41
+ mock.module("expo-sqlite", () => ({}));
42
+ const {createDefaultPersisterFactory: createNativeFactory} = await import(
43
+ "./defaultPersisterFactory.native"
44
+ );
45
+
46
+ expect(() =>
47
+ createNativeFactory()({databaseName: uniqueDbName(), store: makeStore().raw})
48
+ ).toThrow(/expo install expo-sqlite/);
49
+ });
50
+
51
+ it("builds a persister when expo-sqlite is available", async () => {
52
+ const opened: string[] = [];
53
+ mock.module("expo-sqlite", () => ({
54
+ openDatabaseSync: (name: string) => {
55
+ opened.push(name);
56
+ return {databaseName: name};
57
+ },
58
+ }));
59
+ mock.module("tinybase/persisters/persister-expo-sqlite", () => ({
60
+ createExpoSqlitePersister: (_store: unknown, _db: unknown, tableName: string) => ({
61
+ tableName,
62
+ }),
63
+ }));
64
+ const {createDefaultPersisterFactory: createNativeFactory} = await import(
65
+ "./defaultPersisterFactory.native"
66
+ );
67
+
68
+ const databaseName = uniqueDbName();
69
+ const persister = createNativeFactory()({databaseName, store: makeStore().raw});
70
+
71
+ expect(opened).toEqual([databaseName]);
72
+ expect((persister as unknown as {tableName: string}).tableName).toBe("terreno_syncdb");
73
+ });
74
+ });
75
+
76
+ describe("createDefaultPersisterFactory (base)", () => {
77
+ it("falls back to the in-memory persister and round-trips across stores", async () => {
78
+ const factory = createBaseFactory();
79
+ const databaseName = uniqueDbName();
80
+ const source = makeStore();
81
+ source.upsertEntity({collection: "todos", data: {title: "ssr"}, id: "t1"});
82
+ await factory({databaseName, store: source.raw}).save();
83
+
84
+ const target = makeStore();
85
+ await factory({databaseName, store: target.raw}).load();
86
+ expect(target.getEntity({collection: "todos", id: "t1"})?.data).toEqual({title: "ssr"});
87
+ });
88
+ });
89
+
90
+ describe("createDefaultPersisterFactory (web)", () => {
91
+ it("encrypts at rest by default (no config)", async () => {
92
+ const databaseName = uniqueDbName();
93
+ const factory = createWebFactory({saveDebounceMs: 0});
94
+ const source = makeStore();
95
+ source.upsertEntity({collection: "todos", data: {title: "SECRET_MARKER_XYZ"}, id: "t1"});
96
+ await factory({databaseName, store: source.raw}).save();
97
+
98
+ const raw = await readRawRecord(databaseName);
99
+ expect(raw).toBeInstanceOf(Uint8Array);
100
+ const asLatin1 = Array.from(raw as Uint8Array, (b) => String.fromCharCode(b)).join("");
101
+ expect(asLatin1).not.toContain("SECRET_MARKER_XYZ");
102
+
103
+ // Same factory (same key provider instance) loads it back into a new store.
104
+ const target = makeStore();
105
+ await factory({databaseName, store: target.raw}).load();
106
+ expect(target.getEntity({collection: "todos", id: "t1"})?.data).toEqual({
107
+ title: "SECRET_MARKER_XYZ",
108
+ });
109
+ });
110
+
111
+ it("round-trips across factory instances sharing a keyProvider and userId", async () => {
112
+ const keyProvider = createLocalKeyProvider({cacheDbName: uniqueDbName()});
113
+ const databaseName = uniqueDbName();
114
+ const source = makeStore();
115
+ source.upsertEntity({collection: "todos", data: {title: "shared"}, id: "t1"});
116
+ await createWebFactory({keyProvider, saveDebounceMs: 0, userId: "u1"})({
117
+ databaseName,
118
+ store: source.raw,
119
+ }).save();
120
+
121
+ const target = makeStore();
122
+ await createWebFactory({keyProvider, saveDebounceMs: 0, userId: "u1"})({
123
+ databaseName,
124
+ store: target.raw,
125
+ }).load();
126
+ expect(target.getEntity({collection: "todos", id: "t1"})?.data).toEqual({title: "shared"});
127
+ });
128
+
129
+ it("wires onDecryptFailure through to the encrypted persister", async () => {
130
+ const databaseName = uniqueDbName();
131
+ await idbSet({
132
+ databaseName,
133
+ key: "content",
134
+ value: crypto.getRandomValues(new Uint8Array(48)),
135
+ });
136
+ const onDecryptFailure = mock(() => {});
137
+ const store = makeStore();
138
+ await createWebFactory({onDecryptFailure, saveDebounceMs: 0})({
139
+ databaseName,
140
+ store: store.raw,
141
+ }).load();
142
+ expect(onDecryptFailure).toHaveBeenCalledTimes(1);
143
+ expect(store.listEntities({collection: "todos"})).toEqual([]);
144
+ });
145
+
146
+ it("cannot decrypt another user's persisted data (key scoping)", async () => {
147
+ const keyProvider = createLocalKeyProvider({cacheDbName: uniqueDbName()});
148
+ const databaseName = uniqueDbName();
149
+ const source = makeStore();
150
+ source.upsertEntity({collection: "todos", data: {title: "mine"}, id: "t1"});
151
+ await createWebFactory({keyProvider, saveDebounceMs: 0, userId: "u1"})({
152
+ databaseName,
153
+ store: source.raw,
154
+ }).save();
155
+
156
+ const onDecryptFailure = mock(() => {});
157
+ const target = makeStore();
158
+ await createWebFactory({keyProvider, onDecryptFailure, saveDebounceMs: 0, userId: "u2"})({
159
+ databaseName,
160
+ store: target.raw,
161
+ }).load();
162
+ expect(onDecryptFailure).toHaveBeenCalledTimes(1);
163
+ expect(target.listEntities({collection: "todos"})).toEqual([]);
164
+ });
165
+
166
+ it("tags the returned persister with persistenceMode: 'durable' when IndexedDB is available", () => {
167
+ const persister = createWebFactory({saveDebounceMs: 0})({
168
+ databaseName: uniqueDbName(),
169
+ store: makeStore().raw,
170
+ });
171
+ expect((persister as unknown as {persistenceMode?: string}).persistenceMode).toBe("durable");
172
+ });
173
+
174
+ it("falls back to the in-memory persister and tags persistenceMode: 'memory' when indexedDB is unavailable (E3c)", async () => {
175
+ const originalIndexedDb = globalThis.indexedDB;
176
+ // Simulating an environment with no IndexedDB at all.
177
+ delete (globalThis as {indexedDB?: unknown}).indexedDB;
178
+ try {
179
+ const databaseName = uniqueDbName();
180
+ const source = makeStore();
181
+ source.upsertEntity({collection: "todos", data: {title: "memory only"}, id: "t1"});
182
+ const persister = createWebFactory({saveDebounceMs: 0})({
183
+ databaseName,
184
+ store: source.raw,
185
+ });
186
+ expect((persister as unknown as {persistenceMode?: string}).persistenceMode).toBe("memory");
187
+ await persister.save();
188
+
189
+ // The same databaseName round-trips through the in-memory backing —
190
+ // proving the fallback is a real, working persister, not a stub.
191
+ const target = makeStore();
192
+ const targetPersister = createWebFactory({saveDebounceMs: 0})({
193
+ databaseName,
194
+ store: target.raw,
195
+ });
196
+ expect((targetPersister as unknown as {persistenceMode?: string}).persistenceMode).toBe(
197
+ "memory"
198
+ );
199
+ await targetPersister.load();
200
+ expect(target.getEntity({collection: "todos", id: "t1"})?.data).toEqual({
201
+ title: "memory only",
202
+ });
203
+ } finally {
204
+ globalThis.indexedDB = originalIndexedDb;
205
+ }
206
+ });
207
+ });
@@ -0,0 +1,12 @@
1
+ import {memoryPersisterFactory} from "./memoryPersister";
2
+ import type {DefaultPersisterFactoryConfig, PersisterFactory} from "./types";
3
+
4
+ /**
5
+ * Neutral fallback used under Node/Bun/SSR where neither expo-sqlite nor
6
+ * IndexedDB exists. Metro/webpack resolve the platform-specific
7
+ * `.native.ts`/`.web.ts` variants for real apps; this in-memory factory keeps
8
+ * the client constructible (non-persistent) everywhere else.
9
+ */
10
+ export const createDefaultPersisterFactory = (
11
+ _config: DefaultPersisterFactoryConfig = {}
12
+ ): PersisterFactory => memoryPersisterFactory;
@@ -0,0 +1,78 @@
1
+ import type {AnyPersister} from "tinybase/persisters";
2
+
3
+ import {createKeyProviderCodec, createLocalKeyProvider} from "../crypto/keyProviders";
4
+ import {createEncryptedIndexedDbPersister} from "./encryptedIndexedDbPersister";
5
+ import {memoryPersisterFactory} from "./memoryPersister";
6
+ import type {DefaultPersisterFactoryConfig, PersisterFactory} from "./types";
7
+
8
+ /** Key scope used when the caller has not (yet) supplied a user id. */
9
+ const DEFAULT_KEY_SCOPE_USER_ID = "local";
10
+
11
+ /**
12
+ * E3(c): true once the one-time "no IndexedDB, falling back to memory
13
+ * persistence" warning has fired for this session — module-level so the
14
+ * warning is emitted at most once per page load even across multiple
15
+ * `createSyncDb` instances (e.g. tests, or an app with more than one store).
16
+ */
17
+ let hasWarnedNoIndexedDb = false;
18
+
19
+ /**
20
+ * Web default persister: the encrypted IndexedDB persister with encryption
21
+ * default-on. Without explicit config the key is a device-local random
22
+ * non-extractable key; production apps pass a `createServerKeyProvider`-backed
23
+ * `keyProvider` + `userId` so the key derives from server key material.
24
+ *
25
+ * E3(c): when `globalThis.indexedDB` is unavailable (private-browsing modes
26
+ * that disable it, a locked-down embedded webview), falls back to the
27
+ * in-memory persister rather than throwing — local-first apps should still
28
+ * start, just without durable persistence for this session — and warns once.
29
+ * The returned persister carries a `persistenceMode` marker
30
+ * (`"durable" | "memory"`) so callers (see `client.ts`) can surface the
31
+ * degraded mode on `SyncStatus` instead of it being silently invisible.
32
+ */
33
+ export const createDefaultPersisterFactory = (
34
+ config: DefaultPersisterFactoryConfig = {}
35
+ ): PersisterFactory => {
36
+ const keyProvider = config.keyProvider ?? createLocalKeyProvider();
37
+ const userId = config.userId ?? DEFAULT_KEY_SCOPE_USER_ID;
38
+ return ({store, databaseName, hooks}) => {
39
+ // Call-time `hooks` (see `PersisterFactory`) and config-time callbacks
40
+ // are the same closures in the real client.ts flow; call-time wins when
41
+ // both are present so a caller building this factory directly (tests, or
42
+ // a host app not going through createSyncDb's config-time wiring) can
43
+ // rely on `hooks` alone.
44
+ const onDecryptFailure = hooks?.onDecryptFailure ?? config.onDecryptFailure;
45
+ const onLoadFailure = hooks?.onLoadFailure ?? config.onLoadFailure;
46
+ const onSaveFailure = hooks?.onSaveFailure ?? config.onSaveFailure;
47
+ if (typeof globalThis.indexedDB === "undefined") {
48
+ if (!hasWarnedNoIndexedDb) {
49
+ hasWarnedNoIndexedDb = true;
50
+ console.warn(
51
+ "[syncdb] IndexedDB is unavailable in this environment; falling back to in-memory persistence (data will not survive a reload)"
52
+ );
53
+ }
54
+ const memoryPersister = memoryPersisterFactory({databaseName, store});
55
+ // Spreading a frozen Persister into a plain object is safe (copies
56
+ // enumerable own properties) and lets callers detect the fallback via
57
+ // `persistenceMode` without needing an isSynchronizer-style branch at
58
+ // every call site.
59
+ return {...memoryPersister, persistenceMode: "memory"} as AnyPersister & {
60
+ persistenceMode: "memory";
61
+ };
62
+ }
63
+ const persister = createEncryptedIndexedDbPersister({
64
+ codec: createKeyProviderCodec({keyProvider, userId}),
65
+ databaseName,
66
+ idbGetImpl: config.idbGetImpl,
67
+ idbSetImpl: config.idbSetImpl,
68
+ onDecryptFailure,
69
+ onLoadFailure,
70
+ onSaveFailure,
71
+ saveDebounceMs: config.saveDebounceMs,
72
+ store,
73
+ });
74
+ return {...persister, persistenceMode: "durable"} as AnyPersister & {
75
+ persistenceMode: "durable";
76
+ };
77
+ };
78
+ };
@@ -0,0 +1,381 @@
1
+ import "fake-indexeddb/auto";
2
+
3
+ import {describe, expect, it, mock} from "bun:test";
4
+
5
+ import {createAesGcmCodec} from "../crypto/aesGcmCodec";
6
+ import {identityCodec} from "../crypto/identityCodec";
7
+ import type {PayloadCodec} from "../crypto/types";
8
+ import {idbSet} from "../storage/idb";
9
+ import {SYNC_SCHEMA_VERSION} from "../storage/schema";
10
+ import {createSyncStore, type SyncStore} from "../storage/store";
11
+ import {createEncryptedIndexedDbPersister} from "./encryptedIndexedDbPersister";
12
+
13
+ let dbCounter = 0;
14
+ const uniqueDbName = (): string => `encrypted-idb-test-${Date.now()}-${dbCounter++}`;
15
+
16
+ const makeStore = (): SyncStore => createSyncStore({collections: ["todos"]});
17
+
18
+ const generateKey = (): Promise<CryptoKey> =>
19
+ crypto.subtle.generateKey({length: 256, name: "AES-GCM"}, false, ["encrypt", "decrypt"]);
20
+
21
+ /** Read the raw persisted record via the plain IndexedDB API (no syncdb code). */
22
+ const readRawRecord = (databaseName: string): Promise<unknown> =>
23
+ new Promise((resolve, reject) => {
24
+ const open = indexedDB.open(databaseName);
25
+ open.onerror = (): void => reject(open.error);
26
+ open.onsuccess = (): void => {
27
+ const db = open.result;
28
+ const request = db.transaction("kv", "readonly").objectStore("kv").get("content");
29
+ request.onsuccess = (): void => {
30
+ db.close();
31
+ resolve(request.result);
32
+ };
33
+ request.onerror = (): void => {
34
+ db.close();
35
+ reject(request.error);
36
+ };
37
+ };
38
+ });
39
+
40
+ describe("createEncryptedIndexedDbPersister", () => {
41
+ it("round-trips a store through encrypted IndexedDB into a fresh store", async () => {
42
+ const databaseName = uniqueDbName();
43
+ const codec = createAesGcmCodec({key: await generateKey()});
44
+ const source = makeStore();
45
+ source.upsertEntity({collection: "todos", data: {title: "Buy milk"}, id: "t1", seq: 7});
46
+ source.setLastUserId({userId: "u1"});
47
+ await createEncryptedIndexedDbPersister({
48
+ codec,
49
+ databaseName,
50
+ saveDebounceMs: 0,
51
+ store: source.raw,
52
+ }).save();
53
+
54
+ const target = makeStore();
55
+ await createEncryptedIndexedDbPersister({
56
+ codec,
57
+ databaseName,
58
+ saveDebounceMs: 0,
59
+ store: target.raw,
60
+ }).load();
61
+ expect(target.getEntity({collection: "todos", id: "t1"})?.data).toEqual({title: "Buy milk"});
62
+ expect(target.getEntity({collection: "todos", id: "t1"})?.seq).toBe(7);
63
+ expect(target.getLastUserId()).toBe("u1");
64
+ });
65
+
66
+ it("never writes plaintext to IndexedDB, and the marker round-trips (encrypted at rest)", async () => {
67
+ const databaseName = uniqueDbName();
68
+ const codec = createAesGcmCodec({key: await generateKey()});
69
+ const source = makeStore();
70
+ source.upsertEntity({
71
+ collection: "todos",
72
+ data: {title: "SECRET_MARKER_XYZ"},
73
+ id: "SECRET_MARKER_XYZ-id",
74
+ });
75
+ await createEncryptedIndexedDbPersister({
76
+ codec,
77
+ databaseName,
78
+ saveDebounceMs: 0,
79
+ store: source.raw,
80
+ }).save();
81
+
82
+ // Raw at-rest inspection: the single stored record is a binary blob whose
83
+ // bytes never contain the marker in any byte-to-char reading.
84
+ const raw = await readRawRecord(databaseName);
85
+ expect(raw).toBeInstanceOf(Uint8Array);
86
+ const bytes = raw as Uint8Array;
87
+ const asLatin1 = Array.from(bytes, (b) => String.fromCharCode(b)).join("");
88
+ expect(asLatin1).not.toContain("SECRET_MARKER_XYZ");
89
+ expect(new TextDecoder().decode(bytes)).not.toContain("SECRET_MARKER_XYZ");
90
+ expect(JSON.stringify(Array.from(bytes))).not.toContain("SECRET_MARKER_XYZ");
91
+
92
+ const target = makeStore();
93
+ await createEncryptedIndexedDbPersister({
94
+ codec,
95
+ databaseName,
96
+ saveDebounceMs: 0,
97
+ store: target.raw,
98
+ }).load();
99
+ expect(target.getEntity({collection: "todos", id: "SECRET_MARKER_XYZ-id"})?.data).toEqual({
100
+ title: "SECRET_MARKER_XYZ",
101
+ });
102
+ });
103
+
104
+ it("supports the autoLoad lifecycle (no external change source to observe)", async () => {
105
+ const databaseName = uniqueDbName();
106
+ const codec = createAesGcmCodec({key: await generateKey()});
107
+ const source = makeStore();
108
+ source.upsertEntity({collection: "todos", data: {title: "autoload"}, id: "t1"});
109
+ await createEncryptedIndexedDbPersister({
110
+ codec,
111
+ databaseName,
112
+ saveDebounceMs: 0,
113
+ store: source.raw,
114
+ }).save();
115
+
116
+ const target = makeStore();
117
+ const persister = createEncryptedIndexedDbPersister({
118
+ codec,
119
+ databaseName,
120
+ saveDebounceMs: 0,
121
+ store: target.raw,
122
+ });
123
+ await persister.startAutoLoad();
124
+ expect(target.getEntity({collection: "todos", id: "t1"})?.data).toEqual({title: "autoload"});
125
+ await persister.stopAutoLoad();
126
+ await persister.destroy();
127
+ });
128
+
129
+ it("treats a missing record as an empty store without invoking onDecryptFailure", async () => {
130
+ const onDecryptFailure = mock(() => {});
131
+ const store = makeStore();
132
+ await createEncryptedIndexedDbPersister({
133
+ codec: createAesGcmCodec({key: await generateKey()}),
134
+ databaseName: uniqueDbName(),
135
+ onDecryptFailure,
136
+ saveDebounceMs: 0,
137
+ store: store.raw,
138
+ }).load();
139
+ expect(store.listEntities({collection: "todos"})).toEqual([]);
140
+ expect(onDecryptFailure).not.toHaveBeenCalled();
141
+ });
142
+
143
+ describe("load failure (E3a)", () => {
144
+ it("a rejecting idbGet at load leaves the stored blob intact and reports onLoadFailure, not onDecryptFailure", async () => {
145
+ const databaseName = uniqueDbName();
146
+ const codec = createAesGcmCodec({key: await generateKey()});
147
+ const source = makeStore();
148
+ source.upsertEntity({collection: "todos", data: {title: "still here"}, id: "t1", seq: 3});
149
+ await createEncryptedIndexedDbPersister({
150
+ codec,
151
+ databaseName,
152
+ saveDebounceMs: 0,
153
+ store: source.raw,
154
+ }).save();
155
+
156
+ const onDecryptFailure = mock(() => {});
157
+ const onLoadFailure = mock(() => {});
158
+ const target = makeStore();
159
+ await createEncryptedIndexedDbPersister({
160
+ codec,
161
+ databaseName,
162
+ idbGetImpl: async () => {
163
+ throw new Error("simulated IndexedDB read failure");
164
+ },
165
+ onDecryptFailure,
166
+ onLoadFailure,
167
+ saveDebounceMs: 0,
168
+ store: target.raw,
169
+ }).load();
170
+
171
+ // The distinct load-failure hook fired, NOT the decrypt-failure one — a
172
+ // read error is not "corrupt/undecryptable data".
173
+ expect(onLoadFailure).toHaveBeenCalledTimes(1);
174
+ expect(onDecryptFailure).not.toHaveBeenCalled();
175
+ // The target store was never populated (load bailed out before
176
+ // touching it) — this is the state a caller must check before deciding
177
+ // to autosave (autosaving now would write this empty content over the
178
+ // still-good blob).
179
+ expect(target.listEntities({collection: "todos"})).toEqual([]);
180
+
181
+ // The persisted blob itself is untouched: reading it back normally
182
+ // (real idbGet) with a fresh store still recovers the original data —
183
+ // proving nothing was overwritten during the failed load.
184
+ const recovered = makeStore();
185
+ await createEncryptedIndexedDbPersister({
186
+ codec,
187
+ databaseName,
188
+ saveDebounceMs: 0,
189
+ store: recovered.raw,
190
+ }).load();
191
+ expect(recovered.getEntity({collection: "todos", id: "t1"})?.data).toEqual({
192
+ title: "still here",
193
+ });
194
+ expect(recovered.getEntity({collection: "todos", id: "t1"})?.seq).toBe(3);
195
+ });
196
+
197
+ it("treats a genuinely missing record (no read error) as a fresh store, not a load failure", async () => {
198
+ const onLoadFailure = mock(() => {});
199
+ const onDecryptFailure = mock(() => {});
200
+ const store = makeStore();
201
+ await createEncryptedIndexedDbPersister({
202
+ codec: createAesGcmCodec({key: await generateKey()}),
203
+ databaseName: uniqueDbName(),
204
+ onDecryptFailure,
205
+ onLoadFailure,
206
+ saveDebounceMs: 0,
207
+ store: store.raw,
208
+ }).load();
209
+ expect(onLoadFailure).not.toHaveBeenCalled();
210
+ expect(onDecryptFailure).not.toHaveBeenCalled();
211
+ expect(store.listEntities({collection: "todos"})).toEqual([]);
212
+ });
213
+ });
214
+
215
+ it("invokes onDecryptFailure and yields an empty store on undecryptable data", async () => {
216
+ const databaseName = uniqueDbName();
217
+ await idbSet({
218
+ databaseName,
219
+ key: "content",
220
+ value: crypto.getRandomValues(new Uint8Array(64)),
221
+ });
222
+ const onDecryptFailure = mock(() => {});
223
+ const store = makeStore();
224
+ await createEncryptedIndexedDbPersister({
225
+ codec: createAesGcmCodec({key: await generateKey()}),
226
+ databaseName,
227
+ onDecryptFailure,
228
+ saveDebounceMs: 0,
229
+ store: store.raw,
230
+ }).load();
231
+ expect(onDecryptFailure).toHaveBeenCalledTimes(1);
232
+ expect(store.listEntities({collection: "todos"})).toEqual([]);
233
+ });
234
+
235
+ it("invokes onDecryptFailure when the record is not a binary payload", async () => {
236
+ const databaseName = uniqueDbName();
237
+ await idbSet({databaseName, key: "content", value: "not-a-blob"});
238
+ const onDecryptFailure = mock(() => {});
239
+ const store = makeStore();
240
+ await createEncryptedIndexedDbPersister({
241
+ codec: createAesGcmCodec({key: await generateKey()}),
242
+ databaseName,
243
+ onDecryptFailure,
244
+ saveDebounceMs: 0,
245
+ store: store.raw,
246
+ }).load();
247
+ expect(onDecryptFailure).toHaveBeenCalledTimes(1);
248
+ });
249
+
250
+ it("invokes onDecryptFailure when the decrypted payload is not valid JSON", async () => {
251
+ const databaseName = uniqueDbName();
252
+ const codec = createAesGcmCodec({key: await generateKey()});
253
+ await idbSet({databaseName, key: "content", value: await codec.encode("not json {{{")});
254
+ const onDecryptFailure = mock(() => {});
255
+ const store = makeStore();
256
+ await createEncryptedIndexedDbPersister({
257
+ codec,
258
+ databaseName,
259
+ onDecryptFailure,
260
+ saveDebounceMs: 0,
261
+ store: store.raw,
262
+ }).load();
263
+ expect(onDecryptFailure).toHaveBeenCalledTimes(1);
264
+ expect(store.listEntities({collection: "todos"})).toEqual([]);
265
+ });
266
+
267
+ it("coalesces rapid saves into one trailing debounced write", async () => {
268
+ const databaseName = uniqueDbName();
269
+ let encodeCount = 0;
270
+ const countingCodec: PayloadCodec = {
271
+ decode: identityCodec.decode,
272
+ encode: (plaintext) => {
273
+ encodeCount += 1;
274
+ return identityCodec.encode(plaintext);
275
+ },
276
+ };
277
+ const source = makeStore();
278
+ const persister = createEncryptedIndexedDbPersister({
279
+ codec: countingCodec,
280
+ databaseName,
281
+ saveDebounceMs: 20,
282
+ store: source.raw,
283
+ });
284
+ await persister.startAutoSave();
285
+ expect(encodeCount).toBe(1);
286
+ source.upsertEntity({collection: "todos", data: {title: "one"}, id: "t1"});
287
+ source.upsertEntity({collection: "todos", data: {title: "two"}, id: "t1"});
288
+ source.upsertEntity({collection: "todos", data: {title: "three"}, id: "t1"});
289
+ // Wait out the trailing debounce plus TinyBase's serialized autosave queue:
290
+ // the first queued save writes the final content once, the rest are
291
+ // skipped because their serialized content matches the written snapshot.
292
+ await new Promise((resolve) => setTimeout(resolve, 150));
293
+ expect(encodeCount).toBe(2);
294
+ await persister.destroy();
295
+
296
+ const target = makeStore();
297
+ await createEncryptedIndexedDbPersister({
298
+ codec: countingCodec,
299
+ databaseName,
300
+ saveDebounceMs: 0,
301
+ store: target.raw,
302
+ }).load();
303
+ expect(target.getEntity({collection: "todos", id: "t1"})?.data).toEqual({title: "three"});
304
+ });
305
+
306
+ it("destroy() cancels a pending debounced save and writes nothing after (E3e)", async () => {
307
+ const databaseName = uniqueDbName();
308
+ let encodeCount = 0;
309
+ const countingCodec: PayloadCodec = {
310
+ decode: identityCodec.decode,
311
+ encode: (plaintext) => {
312
+ encodeCount += 1;
313
+ return identityCodec.encode(plaintext);
314
+ },
315
+ };
316
+ const source = makeStore();
317
+ const persister = createEncryptedIndexedDbPersister({
318
+ codec: countingCodec,
319
+ databaseName,
320
+ saveDebounceMs: 50,
321
+ store: source.raw,
322
+ });
323
+ await persister.startAutoSave();
324
+ const encodeCountAfterInitialSave = encodeCount;
325
+ source.upsertEntity({collection: "todos", data: {title: "pending"}, id: "t1"});
326
+ // The autosave listener's write is now debounced (50ms) and still
327
+ // pending — destroy immediately, before it can fire.
328
+ await persister.destroy();
329
+ // Wait well past the debounce window: if the timer were still armed
330
+ // (E3e regression), it would fire here and write "pending".
331
+ await new Promise((resolve) => setTimeout(resolve, 100));
332
+ expect(encodeCount).toBe(encodeCountAfterInitialSave);
333
+
334
+ const target = makeStore();
335
+ await createEncryptedIndexedDbPersister({
336
+ codec: countingCodec,
337
+ databaseName,
338
+ saveDebounceMs: 0,
339
+ store: target.raw,
340
+ }).load();
341
+ // Nothing was ever written after the initial (pre-mutation) autosave —
342
+ // the mutated content never landed.
343
+ expect(target.getEntity({collection: "todos", id: "t1"})).toBeUndefined();
344
+ });
345
+
346
+ it("propagates encode failures to the caller of save()", async () => {
347
+ const failingCodec: PayloadCodec = {
348
+ decode: identityCodec.decode,
349
+ encode: async () => {
350
+ throw new Error("encode boom");
351
+ },
352
+ };
353
+ const store = makeStore();
354
+ const persister = createEncryptedIndexedDbPersister({
355
+ codec: failingCodec,
356
+ databaseName: uniqueDbName(),
357
+ saveDebounceMs: 5,
358
+ store: store.raw,
359
+ });
360
+ // TinyBase routes setPersisted failures through onIgnoredError rather than
361
+ // rejecting save(), so assert via a subsequent successful write instead.
362
+ await persister.save().catch(() => {});
363
+ const workingCodec = createAesGcmCodec({key: await generateKey()});
364
+ const databaseName = uniqueDbName();
365
+ const okPersister = createEncryptedIndexedDbPersister({
366
+ codec: workingCodec,
367
+ databaseName,
368
+ saveDebounceMs: 0,
369
+ store: store.raw,
370
+ });
371
+ await okPersister.save();
372
+ const target = makeStore();
373
+ await createEncryptedIndexedDbPersister({
374
+ codec: workingCodec,
375
+ databaseName,
376
+ saveDebounceMs: 0,
377
+ store: target.raw,
378
+ }).load();
379
+ expect(target.getSchemaVersion()).toBe(SYNC_SCHEMA_VERSION);
380
+ });
381
+ });