@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,352 @@
1
+ import "fake-indexeddb/auto";
2
+ import { describe, expect, it, mock } from "bun:test";
3
+ import { createAesGcmCodec } from "../crypto/aesGcmCodec";
4
+ import { identityCodec } from "../crypto/identityCodec";
5
+ import { idbSet } from "../storage/idb";
6
+ import { SYNC_SCHEMA_VERSION } from "../storage/schema";
7
+ import { createSyncStore } from "../storage/store";
8
+ import { createEncryptedIndexedDbPersister } from "./encryptedIndexedDbPersister";
9
+ let dbCounter = 0;
10
+ const uniqueDbName = () => `encrypted-idb-test-${Date.now()}-${dbCounter++}`;
11
+ const makeStore = () => createSyncStore({ collections: ["todos"] });
12
+ const generateKey = () => crypto.subtle.generateKey({ length: 256, name: "AES-GCM" }, false, ["encrypt", "decrypt"]);
13
+ /** Read the raw persisted record via the plain IndexedDB API (no syncdb code). */
14
+ const readRawRecord = (databaseName) => new Promise((resolve, reject) => {
15
+ const open = indexedDB.open(databaseName);
16
+ open.onerror = () => reject(open.error);
17
+ open.onsuccess = () => {
18
+ const db = open.result;
19
+ const request = db.transaction("kv", "readonly").objectStore("kv").get("content");
20
+ request.onsuccess = () => {
21
+ db.close();
22
+ resolve(request.result);
23
+ };
24
+ request.onerror = () => {
25
+ db.close();
26
+ reject(request.error);
27
+ };
28
+ };
29
+ });
30
+ describe("createEncryptedIndexedDbPersister", () => {
31
+ it("round-trips a store through encrypted IndexedDB into a fresh store", async () => {
32
+ const databaseName = uniqueDbName();
33
+ const codec = createAesGcmCodec({ key: await generateKey() });
34
+ const source = makeStore();
35
+ source.upsertEntity({ collection: "todos", data: { title: "Buy milk" }, id: "t1", seq: 7 });
36
+ source.setLastUserId({ userId: "u1" });
37
+ await createEncryptedIndexedDbPersister({
38
+ codec,
39
+ databaseName,
40
+ saveDebounceMs: 0,
41
+ store: source.raw,
42
+ }).save();
43
+ const target = makeStore();
44
+ await createEncryptedIndexedDbPersister({
45
+ codec,
46
+ databaseName,
47
+ saveDebounceMs: 0,
48
+ store: target.raw,
49
+ }).load();
50
+ expect(target.getEntity({ collection: "todos", id: "t1" })?.data).toEqual({ title: "Buy milk" });
51
+ expect(target.getEntity({ collection: "todos", id: "t1" })?.seq).toBe(7);
52
+ expect(target.getLastUserId()).toBe("u1");
53
+ });
54
+ it("never writes plaintext to IndexedDB, and the marker round-trips (encrypted at rest)", async () => {
55
+ const databaseName = uniqueDbName();
56
+ const codec = createAesGcmCodec({ key: await generateKey() });
57
+ const source = makeStore();
58
+ source.upsertEntity({
59
+ collection: "todos",
60
+ data: { title: "SECRET_MARKER_XYZ" },
61
+ id: "SECRET_MARKER_XYZ-id",
62
+ });
63
+ await createEncryptedIndexedDbPersister({
64
+ codec,
65
+ databaseName,
66
+ saveDebounceMs: 0,
67
+ store: source.raw,
68
+ }).save();
69
+ // Raw at-rest inspection: the single stored record is a binary blob whose
70
+ // bytes never contain the marker in any byte-to-char reading.
71
+ const raw = await readRawRecord(databaseName);
72
+ expect(raw).toBeInstanceOf(Uint8Array);
73
+ const bytes = raw;
74
+ const asLatin1 = Array.from(bytes, (b) => String.fromCharCode(b)).join("");
75
+ expect(asLatin1).not.toContain("SECRET_MARKER_XYZ");
76
+ expect(new TextDecoder().decode(bytes)).not.toContain("SECRET_MARKER_XYZ");
77
+ expect(JSON.stringify(Array.from(bytes))).not.toContain("SECRET_MARKER_XYZ");
78
+ const target = makeStore();
79
+ await createEncryptedIndexedDbPersister({
80
+ codec,
81
+ databaseName,
82
+ saveDebounceMs: 0,
83
+ store: target.raw,
84
+ }).load();
85
+ expect(target.getEntity({ collection: "todos", id: "SECRET_MARKER_XYZ-id" })?.data).toEqual({
86
+ title: "SECRET_MARKER_XYZ",
87
+ });
88
+ });
89
+ it("supports the autoLoad lifecycle (no external change source to observe)", async () => {
90
+ const databaseName = uniqueDbName();
91
+ const codec = createAesGcmCodec({ key: await generateKey() });
92
+ const source = makeStore();
93
+ source.upsertEntity({ collection: "todos", data: { title: "autoload" }, id: "t1" });
94
+ await createEncryptedIndexedDbPersister({
95
+ codec,
96
+ databaseName,
97
+ saveDebounceMs: 0,
98
+ store: source.raw,
99
+ }).save();
100
+ const target = makeStore();
101
+ const persister = createEncryptedIndexedDbPersister({
102
+ codec,
103
+ databaseName,
104
+ saveDebounceMs: 0,
105
+ store: target.raw,
106
+ });
107
+ await persister.startAutoLoad();
108
+ expect(target.getEntity({ collection: "todos", id: "t1" })?.data).toEqual({ title: "autoload" });
109
+ await persister.stopAutoLoad();
110
+ await persister.destroy();
111
+ });
112
+ it("treats a missing record as an empty store without invoking onDecryptFailure", async () => {
113
+ const onDecryptFailure = mock(() => { });
114
+ const store = makeStore();
115
+ await createEncryptedIndexedDbPersister({
116
+ codec: createAesGcmCodec({ key: await generateKey() }),
117
+ databaseName: uniqueDbName(),
118
+ onDecryptFailure,
119
+ saveDebounceMs: 0,
120
+ store: store.raw,
121
+ }).load();
122
+ expect(store.listEntities({ collection: "todos" })).toEqual([]);
123
+ expect(onDecryptFailure).not.toHaveBeenCalled();
124
+ });
125
+ describe("load failure (E3a)", () => {
126
+ it("a rejecting idbGet at load leaves the stored blob intact and reports onLoadFailure, not onDecryptFailure", async () => {
127
+ const databaseName = uniqueDbName();
128
+ const codec = createAesGcmCodec({ key: await generateKey() });
129
+ const source = makeStore();
130
+ source.upsertEntity({ collection: "todos", data: { title: "still here" }, id: "t1", seq: 3 });
131
+ await createEncryptedIndexedDbPersister({
132
+ codec,
133
+ databaseName,
134
+ saveDebounceMs: 0,
135
+ store: source.raw,
136
+ }).save();
137
+ const onDecryptFailure = mock(() => { });
138
+ const onLoadFailure = mock(() => { });
139
+ const target = makeStore();
140
+ await createEncryptedIndexedDbPersister({
141
+ codec,
142
+ databaseName,
143
+ idbGetImpl: async () => {
144
+ throw new Error("simulated IndexedDB read failure");
145
+ },
146
+ onDecryptFailure,
147
+ onLoadFailure,
148
+ saveDebounceMs: 0,
149
+ store: target.raw,
150
+ }).load();
151
+ // The distinct load-failure hook fired, NOT the decrypt-failure one — a
152
+ // read error is not "corrupt/undecryptable data".
153
+ expect(onLoadFailure).toHaveBeenCalledTimes(1);
154
+ expect(onDecryptFailure).not.toHaveBeenCalled();
155
+ // The target store was never populated (load bailed out before
156
+ // touching it) — this is the state a caller must check before deciding
157
+ // to autosave (autosaving now would write this empty content over the
158
+ // still-good blob).
159
+ expect(target.listEntities({ collection: "todos" })).toEqual([]);
160
+ // The persisted blob itself is untouched: reading it back normally
161
+ // (real idbGet) with a fresh store still recovers the original data —
162
+ // proving nothing was overwritten during the failed load.
163
+ const recovered = makeStore();
164
+ await createEncryptedIndexedDbPersister({
165
+ codec,
166
+ databaseName,
167
+ saveDebounceMs: 0,
168
+ store: recovered.raw,
169
+ }).load();
170
+ expect(recovered.getEntity({ collection: "todos", id: "t1" })?.data).toEqual({
171
+ title: "still here",
172
+ });
173
+ expect(recovered.getEntity({ collection: "todos", id: "t1" })?.seq).toBe(3);
174
+ });
175
+ it("treats a genuinely missing record (no read error) as a fresh store, not a load failure", async () => {
176
+ const onLoadFailure = mock(() => { });
177
+ const onDecryptFailure = mock(() => { });
178
+ const store = makeStore();
179
+ await createEncryptedIndexedDbPersister({
180
+ codec: createAesGcmCodec({ key: await generateKey() }),
181
+ databaseName: uniqueDbName(),
182
+ onDecryptFailure,
183
+ onLoadFailure,
184
+ saveDebounceMs: 0,
185
+ store: store.raw,
186
+ }).load();
187
+ expect(onLoadFailure).not.toHaveBeenCalled();
188
+ expect(onDecryptFailure).not.toHaveBeenCalled();
189
+ expect(store.listEntities({ collection: "todos" })).toEqual([]);
190
+ });
191
+ });
192
+ it("invokes onDecryptFailure and yields an empty store on undecryptable data", async () => {
193
+ const databaseName = uniqueDbName();
194
+ await idbSet({
195
+ databaseName,
196
+ key: "content",
197
+ value: crypto.getRandomValues(new Uint8Array(64)),
198
+ });
199
+ const onDecryptFailure = mock(() => { });
200
+ const store = makeStore();
201
+ await createEncryptedIndexedDbPersister({
202
+ codec: createAesGcmCodec({ key: await generateKey() }),
203
+ databaseName,
204
+ onDecryptFailure,
205
+ saveDebounceMs: 0,
206
+ store: store.raw,
207
+ }).load();
208
+ expect(onDecryptFailure).toHaveBeenCalledTimes(1);
209
+ expect(store.listEntities({ collection: "todos" })).toEqual([]);
210
+ });
211
+ it("invokes onDecryptFailure when the record is not a binary payload", async () => {
212
+ const databaseName = uniqueDbName();
213
+ await idbSet({ databaseName, key: "content", value: "not-a-blob" });
214
+ const onDecryptFailure = mock(() => { });
215
+ const store = makeStore();
216
+ await createEncryptedIndexedDbPersister({
217
+ codec: createAesGcmCodec({ key: await generateKey() }),
218
+ databaseName,
219
+ onDecryptFailure,
220
+ saveDebounceMs: 0,
221
+ store: store.raw,
222
+ }).load();
223
+ expect(onDecryptFailure).toHaveBeenCalledTimes(1);
224
+ });
225
+ it("invokes onDecryptFailure when the decrypted payload is not valid JSON", async () => {
226
+ const databaseName = uniqueDbName();
227
+ const codec = createAesGcmCodec({ key: await generateKey() });
228
+ await idbSet({ databaseName, key: "content", value: await codec.encode("not json {{{") });
229
+ const onDecryptFailure = mock(() => { });
230
+ const store = makeStore();
231
+ await createEncryptedIndexedDbPersister({
232
+ codec,
233
+ databaseName,
234
+ onDecryptFailure,
235
+ saveDebounceMs: 0,
236
+ store: store.raw,
237
+ }).load();
238
+ expect(onDecryptFailure).toHaveBeenCalledTimes(1);
239
+ expect(store.listEntities({ collection: "todos" })).toEqual([]);
240
+ });
241
+ it("coalesces rapid saves into one trailing debounced write", async () => {
242
+ const databaseName = uniqueDbName();
243
+ let encodeCount = 0;
244
+ const countingCodec = {
245
+ decode: identityCodec.decode,
246
+ encode: (plaintext) => {
247
+ encodeCount += 1;
248
+ return identityCodec.encode(plaintext);
249
+ },
250
+ };
251
+ const source = makeStore();
252
+ const persister = createEncryptedIndexedDbPersister({
253
+ codec: countingCodec,
254
+ databaseName,
255
+ saveDebounceMs: 20,
256
+ store: source.raw,
257
+ });
258
+ await persister.startAutoSave();
259
+ expect(encodeCount).toBe(1);
260
+ source.upsertEntity({ collection: "todos", data: { title: "one" }, id: "t1" });
261
+ source.upsertEntity({ collection: "todos", data: { title: "two" }, id: "t1" });
262
+ source.upsertEntity({ collection: "todos", data: { title: "three" }, id: "t1" });
263
+ // Wait out the trailing debounce plus TinyBase's serialized autosave queue:
264
+ // the first queued save writes the final content once, the rest are
265
+ // skipped because their serialized content matches the written snapshot.
266
+ await new Promise((resolve) => setTimeout(resolve, 150));
267
+ expect(encodeCount).toBe(2);
268
+ await persister.destroy();
269
+ const target = makeStore();
270
+ await createEncryptedIndexedDbPersister({
271
+ codec: countingCodec,
272
+ databaseName,
273
+ saveDebounceMs: 0,
274
+ store: target.raw,
275
+ }).load();
276
+ expect(target.getEntity({ collection: "todos", id: "t1" })?.data).toEqual({ title: "three" });
277
+ });
278
+ it("destroy() cancels a pending debounced save and writes nothing after (E3e)", async () => {
279
+ const databaseName = uniqueDbName();
280
+ let encodeCount = 0;
281
+ const countingCodec = {
282
+ decode: identityCodec.decode,
283
+ encode: (plaintext) => {
284
+ encodeCount += 1;
285
+ return identityCodec.encode(plaintext);
286
+ },
287
+ };
288
+ const source = makeStore();
289
+ const persister = createEncryptedIndexedDbPersister({
290
+ codec: countingCodec,
291
+ databaseName,
292
+ saveDebounceMs: 50,
293
+ store: source.raw,
294
+ });
295
+ await persister.startAutoSave();
296
+ const encodeCountAfterInitialSave = encodeCount;
297
+ source.upsertEntity({ collection: "todos", data: { title: "pending" }, id: "t1" });
298
+ // The autosave listener's write is now debounced (50ms) and still
299
+ // pending — destroy immediately, before it can fire.
300
+ await persister.destroy();
301
+ // Wait well past the debounce window: if the timer were still armed
302
+ // (E3e regression), it would fire here and write "pending".
303
+ await new Promise((resolve) => setTimeout(resolve, 100));
304
+ expect(encodeCount).toBe(encodeCountAfterInitialSave);
305
+ const target = makeStore();
306
+ await createEncryptedIndexedDbPersister({
307
+ codec: countingCodec,
308
+ databaseName,
309
+ saveDebounceMs: 0,
310
+ store: target.raw,
311
+ }).load();
312
+ // Nothing was ever written after the initial (pre-mutation) autosave —
313
+ // the mutated content never landed.
314
+ expect(target.getEntity({ collection: "todos", id: "t1" })).toBeUndefined();
315
+ });
316
+ it("propagates encode failures to the caller of save()", async () => {
317
+ const failingCodec = {
318
+ decode: identityCodec.decode,
319
+ encode: async () => {
320
+ throw new Error("encode boom");
321
+ },
322
+ };
323
+ const store = makeStore();
324
+ const persister = createEncryptedIndexedDbPersister({
325
+ codec: failingCodec,
326
+ databaseName: uniqueDbName(),
327
+ saveDebounceMs: 5,
328
+ store: store.raw,
329
+ });
330
+ // TinyBase routes setPersisted failures through onIgnoredError rather than
331
+ // rejecting save(), so assert via a subsequent successful write instead.
332
+ await persister.save().catch(() => { });
333
+ const workingCodec = createAesGcmCodec({ key: await generateKey() });
334
+ const databaseName = uniqueDbName();
335
+ const okPersister = createEncryptedIndexedDbPersister({
336
+ codec: workingCodec,
337
+ databaseName,
338
+ saveDebounceMs: 0,
339
+ store: store.raw,
340
+ });
341
+ await okPersister.save();
342
+ const target = makeStore();
343
+ await createEncryptedIndexedDbPersister({
344
+ codec: workingCodec,
345
+ databaseName,
346
+ saveDebounceMs: 0,
347
+ store: target.raw,
348
+ }).load();
349
+ expect(target.getSchemaVersion()).toBe(SYNC_SCHEMA_VERSION);
350
+ });
351
+ });
352
+ //# sourceMappingURL=encryptedIndexedDbPersister.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"encryptedIndexedDbPersister.test.js","sourceRoot":"","sources":["../../src/persisters/encryptedIndexedDbPersister.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import type { MergeableStore } from "tinybase";
2
+ import { type Persister, Persists } from "tinybase/persisters";
3
+ import type { PersisterFactory } from "./types";
4
+ /**
5
+ * In-memory persister for tests and SSR/no-storage fallbacks. Persists the
6
+ * full mergeable (CRDT) content so reloading into a fresh store retains
7
+ * hybrid-logical-clock metadata, mirroring real persister behavior.
8
+ */
9
+ export declare const createMemoryPersister: ({ store, databaseName, }: {
10
+ store: MergeableStore;
11
+ databaseName: string;
12
+ }) => Persister<Persists.MergeableStoreOnly>;
13
+ /** PersisterFactory adapter for {@link createMemoryPersister}. */
14
+ export declare const memoryPersisterFactory: PersisterFactory;
15
+ /** Drop the in-memory persisted content for one databaseName (wipe/tests). */
16
+ export declare const clearMemoryPersisterData: ({ databaseName }: {
17
+ databaseName: string;
18
+ }) => void;
19
+ //# sourceMappingURL=memoryPersister.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memoryPersister.d.ts","sourceRoot":"","sources":["../../src/persisters/memoryPersister.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,cAAc,EAAC,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAwB,KAAK,SAAS,EAAE,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAEpF,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,SAAS,CAAC;AAW9C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,0BAGnC;IACD,KAAK,EAAE,cAAc,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB,KAAG,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAiBtC,CAAC;AAEJ,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,EAAE,gBACS,CAAC;AAE/C,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,GAAI,kBAAgB;IAAC,YAAY,EAAE,MAAM,CAAA;CAAC,KAAG,IAEjF,CAAC"}
@@ -0,0 +1,31 @@
1
+ import { createCustomPersister } from "tinybase/persisters";
2
+ /**
3
+ * Module-level backing keyed by databaseName. Two persisters created with the
4
+ * same databaseName (even against different stores) share persisted state,
5
+ * which is how tests and SSR emulate cross-session persistence. Content is
6
+ * stored as a JSON string so loads get a fresh deep copy, never a live
7
+ * reference into another store.
8
+ */
9
+ const memoryBacking = new Map();
10
+ /**
11
+ * In-memory persister for tests and SSR/no-storage fallbacks. Persists the
12
+ * full mergeable (CRDT) content so reloading into a fresh store retains
13
+ * hybrid-logical-clock metadata, mirroring real persister behavior.
14
+ */
15
+ export const createMemoryPersister = ({ store, databaseName, }) => createCustomPersister(store, async () => {
16
+ const json = memoryBacking.get(databaseName);
17
+ return json === undefined ? undefined : JSON.parse(json);
18
+ }, async (getContent) => {
19
+ memoryBacking.set(databaseName, JSON.stringify(getContent()));
20
+ },
21
+ // The backing map never changes underneath the persister, so there is no
22
+ // external change source to listen to; a token handle keeps the
23
+ // add/del listener lifecycle symmetric.
24
+ () => 1, (_listenerHandle) => { }, undefined, 2 /* Persists.MergeableStoreOnly */);
25
+ /** PersisterFactory adapter for {@link createMemoryPersister}. */
26
+ export const memoryPersisterFactory = ({ store, databaseName }) => createMemoryPersister({ databaseName, store });
27
+ /** Drop the in-memory persisted content for one databaseName (wipe/tests). */
28
+ export const clearMemoryPersisterData = ({ databaseName }) => {
29
+ memoryBacking.delete(databaseName);
30
+ };
31
+ //# sourceMappingURL=memoryPersister.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memoryPersister.js","sourceRoot":"","sources":["../../src/persisters/memoryPersister.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,qBAAqB,EAA2B,MAAM,qBAAqB,CAAC;AAIpF;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,EACpC,KAAK,EACL,YAAY,GAIb,EAA0C,EAAE,CAC3C,qBAAqB,CACnB,KAAK,EACL,KAAK,IAA2C,EAAE;IAChD,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7C,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsB,CAAC;AACjF,CAAC,EACD,KAAK,EAAE,UAAU,EAAiB,EAAE;IAClC,aAAa,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;AAChE,CAAC;AACD,yEAAyE;AACzE,gEAAgE;AAChE,wCAAwC;AACxC,GAAW,EAAE,CAAC,CAAC,EACf,CAAC,eAAuB,EAAQ,EAAE,GAAE,CAAC,EACrC,SAAS,sCAEV,CAAC;AAEJ,kEAAkE;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAqB,CAAC,EAAC,KAAK,EAAE,YAAY,EAAC,EAAE,EAAE,CAChF,qBAAqB,CAAC,EAAC,YAAY,EAAE,KAAK,EAAC,CAAC,CAAC;AAE/C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,EAAC,YAAY,EAAyB,EAAQ,EAAE;IACvF,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AACrC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=memoryPersister.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memoryPersister.test.d.ts","sourceRoot":"","sources":["../../src/persisters/memoryPersister.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,113 @@
1
+ import { describe, expect, it } from "bun:test";
2
+ import { createOutbox } from "../mutations/outbox";
3
+ import { createSyncStore } from "../storage/store";
4
+ import { OUTBOX_TABLE } from "../storage/types";
5
+ import { clearMemoryPersisterData, createMemoryPersister, memoryPersisterFactory, } from "./memoryPersister";
6
+ let dbCounter = 0;
7
+ const uniqueDbName = () => `memory-test-${dbCounter++}`;
8
+ const makeStore = () => createSyncStore({ collections: ["todos"] });
9
+ describe("createMemoryPersister", () => {
10
+ it("round-trips entities and outbox rows across separate store instances", async () => {
11
+ const databaseName = uniqueDbName();
12
+ const source = makeStore();
13
+ source.upsertEntity({ collection: "todos", data: { title: "Buy milk" }, id: "t1", seq: 3 });
14
+ source.setLastUserId({ userId: "u1" });
15
+ createOutbox({ store: source }).enqueue({
16
+ args: { title: "Buy milk" },
17
+ collection: "todos",
18
+ entityId: "t1",
19
+ mutationId: "m1",
20
+ operation: "create",
21
+ userId: "u1",
22
+ });
23
+ await createMemoryPersister({ databaseName, store: source.raw }).save();
24
+ const target = makeStore();
25
+ await createMemoryPersister({ databaseName, store: target.raw }).load();
26
+ expect(target.getEntity({ collection: "todos", id: "t1" })?.data).toEqual({ title: "Buy milk" });
27
+ expect(target.getEntity({ collection: "todos", id: "t1" })?.seq).toBe(3);
28
+ expect(target.getLastUserId()).toBe("u1");
29
+ const outboxRow = target.raw.getRow(OUTBOX_TABLE, "m1");
30
+ expect(outboxRow.collection).toBe("todos");
31
+ expect(outboxRow.status).toBe("queued");
32
+ });
33
+ it("loads nothing when the databaseName has never been saved", async () => {
34
+ const store = makeStore();
35
+ await createMemoryPersister({ databaseName: uniqueDbName(), store: store.raw }).load();
36
+ expect(store.listEntities({ collection: "todos" })).toEqual([]);
37
+ });
38
+ it("isolates content between databaseNames", async () => {
39
+ const dbA = uniqueDbName();
40
+ const dbB = uniqueDbName();
41
+ const storeA = makeStore();
42
+ storeA.upsertEntity({ collection: "todos", data: { title: "A" }, id: "a" });
43
+ await createMemoryPersister({ databaseName: dbA, store: storeA.raw }).save();
44
+ const storeB = makeStore();
45
+ storeB.upsertEntity({ collection: "todos", data: { title: "B" }, id: "b" });
46
+ await createMemoryPersister({ databaseName: dbB, store: storeB.raw }).save();
47
+ const reloaded = makeStore();
48
+ await createMemoryPersister({ databaseName: dbA, store: reloaded.raw }).load();
49
+ expect(reloaded.getEntity({ collection: "todos", id: "a" })).toBeDefined();
50
+ expect(reloaded.getEntity({ collection: "todos", id: "b" })).toBeUndefined();
51
+ });
52
+ it("persists store changes automatically under startAutoSave", async () => {
53
+ const databaseName = uniqueDbName();
54
+ const source = makeStore();
55
+ const persister = createMemoryPersister({ databaseName, store: source.raw });
56
+ await persister.startAutoSave();
57
+ source.upsertEntity({ collection: "todos", data: { title: "auto" }, id: "t1" });
58
+ await persister.destroy();
59
+ const target = makeStore();
60
+ await createMemoryPersister({ databaseName, store: target.raw }).load();
61
+ expect(target.getEntity({ collection: "todos", id: "t1" })?.data).toEqual({ title: "auto" });
62
+ });
63
+ it("supports the autoLoad lifecycle (no external change source to observe)", async () => {
64
+ const databaseName = uniqueDbName();
65
+ const source = makeStore();
66
+ source.upsertEntity({ collection: "todos", data: { title: "autoload" }, id: "t1" });
67
+ await createMemoryPersister({ databaseName, store: source.raw }).save();
68
+ const target = makeStore();
69
+ const persister = createMemoryPersister({ databaseName, store: target.raw });
70
+ await persister.startAutoLoad();
71
+ expect(target.getEntity({ collection: "todos", id: "t1" })?.data).toEqual({ title: "autoload" });
72
+ await persister.stopAutoLoad();
73
+ await persister.destroy();
74
+ });
75
+ it("hands loads a deep copy, not a live reference into another store", async () => {
76
+ const databaseName = uniqueDbName();
77
+ const source = makeStore();
78
+ source.upsertEntity({ collection: "todos", data: { title: "original" }, id: "t1" });
79
+ await createMemoryPersister({ databaseName, store: source.raw }).save();
80
+ const target = makeStore();
81
+ await createMemoryPersister({ databaseName, store: target.raw }).load();
82
+ target.upsertEntity({ collection: "todos", data: { title: "changed" }, id: "t1" });
83
+ const reloaded = makeStore();
84
+ await createMemoryPersister({ databaseName, store: reloaded.raw }).load();
85
+ expect(reloaded.getEntity({ collection: "todos", id: "t1" })?.data).toEqual({ title: "original" });
86
+ });
87
+ });
88
+ describe("memoryPersisterFactory", () => {
89
+ it("builds persisters bound to the given store and databaseName", async () => {
90
+ const databaseName = uniqueDbName();
91
+ const source = makeStore();
92
+ source.upsertEntity({ collection: "todos", data: { title: "via factory" }, id: "t1" });
93
+ await memoryPersisterFactory({ databaseName, store: source.raw }).save();
94
+ const target = makeStore();
95
+ await memoryPersisterFactory({ databaseName, store: target.raw }).load();
96
+ expect(target.getEntity({ collection: "todos", id: "t1" })?.data).toEqual({
97
+ title: "via factory",
98
+ });
99
+ });
100
+ });
101
+ describe("clearMemoryPersisterData", () => {
102
+ it("drops persisted content for one databaseName", async () => {
103
+ const databaseName = uniqueDbName();
104
+ const source = makeStore();
105
+ source.upsertEntity({ collection: "todos", data: { title: "gone" }, id: "t1" });
106
+ await createMemoryPersister({ databaseName, store: source.raw }).save();
107
+ clearMemoryPersisterData({ databaseName });
108
+ const target = makeStore();
109
+ await createMemoryPersister({ databaseName, store: target.raw }).load();
110
+ expect(target.listEntities({ collection: "todos" })).toEqual([]);
111
+ });
112
+ });
113
+ //# sourceMappingURL=memoryPersister.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memoryPersister.test.js","sourceRoot":"","sources":["../../src/persisters/memoryPersister.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,65 @@
1
+ import type { MergeableStore } from "tinybase";
2
+ import type { AnyPersister } from "tinybase/persisters";
3
+ import type { KeyProvider } from "../crypto/types";
4
+ import type { idbGet, idbSet } from "../storage/idb";
5
+ /**
6
+ * Binds a TinyBase persister to a specific store + logical database name. The
7
+ * returned persister must support MergeableStore content (TinyBase
8
+ * `Persists.MergeableStoreOnly` or `Persists.StoreOrMergeableStore`) so CRDT
9
+ * metadata survives the round trip.
10
+ *
11
+ * `hooks` carries the client's E3 failure-surfacing callbacks
12
+ * (`onDecryptFailure`/`onLoadFailure`/`onSaveFailure`) — always passed
13
+ * through regardless of whether the default or a custom factory is in use, so
14
+ * a host app supplying its own `persisterFactory` (e.g. a different storage
15
+ * backend) can still opt into the same SyncStatus surfacing by wiring these
16
+ * into its own persister. Optional to consume; a factory that ignores
17
+ * `hooks` simply forgoes that surfacing (matches pre-E3 behavior).
18
+ */
19
+ export type PersisterFactory = ({ store, databaseName, hooks, }: {
20
+ store: MergeableStore;
21
+ databaseName: string;
22
+ hooks?: {
23
+ onDecryptFailure?: () => void;
24
+ onLoadFailure?: () => void;
25
+ onSaveFailure?: (error: unknown) => void;
26
+ };
27
+ }) => AnyPersister;
28
+ /**
29
+ * Options accepted by `createDefaultPersisterFactory` on every platform. Each
30
+ * platform variant consumes the subset it needs and ignores the rest, keeping
31
+ * the call site platform-agnostic.
32
+ */
33
+ export interface DefaultPersisterFactoryConfig {
34
+ /**
35
+ * Encryption key provider (web only; encryption is default-on there).
36
+ * Defaults to a device-local random key when omitted.
37
+ */
38
+ keyProvider?: KeyProvider;
39
+ /** User id the encryption key is derived/scoped for (web only). */
40
+ userId?: string;
41
+ /** Invoked when persisted data cannot be decrypted (web only). */
42
+ onDecryptFailure?: () => void;
43
+ /**
44
+ * E3(a): invoked when the underlying storage READ itself fails (distinct
45
+ * from "no data" and from a decrypt/parse failure) — a signal that the
46
+ * persisted blob might still be intact and must not be autosaved over
47
+ * (web only).
48
+ */
49
+ onLoadFailure?: () => void;
50
+ /**
51
+ * E3(a): invoked when a WRITE to storage ultimately fails (e.g. a
52
+ * quota-exceeded error) — TinyBase's autosave scheduler otherwise swallows
53
+ * this silently (web only).
54
+ */
55
+ onSaveFailure?: (error: unknown) => void;
56
+ /** Trailing save debounce in ms; 0 disables debouncing (web only). */
57
+ saveDebounceMs?: number;
58
+ /** SQLite table name holding the JSON-serialized store (native only). */
59
+ storeTableName?: string;
60
+ /** Test-only override for the IndexedDB read (web only; default: the real `idbGet`). */
61
+ idbGetImpl?: typeof idbGet;
62
+ /** Test-only override for the IndexedDB write (web only; default: the real `idbSet`). */
63
+ idbSetImpl?: typeof idbSet;
64
+ }
65
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/persisters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAC,MAAM,EAAE,MAAM,EAAC,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,EAC9B,KAAK,EACL,YAAY,EACZ,KAAK,GACN,EAAE;IACD,KAAK,EAAE,cAAc,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE;QACN,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;QAC9B,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;QAC3B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;KAC1C,CAAC;CACH,KAAK,YAAY,CAAC;AAEnB;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,UAAU,CAAC,EAAE,OAAO,MAAM,CAAC;IAC3B,yFAAyF;IACzF,UAAU,CAAC,EAAE,OAAO,MAAM,CAAC;CAC5B"}