@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
package/package.json ADDED
@@ -0,0 +1,71 @@
1
+ {
2
+ "dependencies": {
3
+ "luxon": "^3.7.2",
4
+ "socket.io-client": "^4.8.1",
5
+ "tinybase": "^8.5.0"
6
+ },
7
+ "description": "Local-first data layer for @terreno apps: TinyBase MergeableStore, durable outbox, websocket delta sync, encrypted web persistence",
8
+ "devDependencies": {
9
+ "@biomejs/biome": "^2.3.6",
10
+ "@testing-library/react-native": "^13.2.0",
11
+ "@types/bun": "^1.3.8",
12
+ "@types/luxon": "^3.7.1",
13
+ "@types/node": "^25.3.0",
14
+ "@types/react": "~19.2.14",
15
+ "expo-sqlite": "~56.0.5",
16
+ "fake-indexeddb": "^6.0.0",
17
+ "react": "19.2.3",
18
+ "react-test-renderer": "19.2.3",
19
+ "socket.io": "^4.8.1",
20
+ "typescript": "~6.0.3"
21
+ },
22
+ "exports": {
23
+ ".": {
24
+ "default": "./dist/index.js",
25
+ "types": "./dist/index.d.ts"
26
+ },
27
+ "./react": {
28
+ "default": "./dist/react/index.js",
29
+ "types": "./dist/react/index.d.ts"
30
+ },
31
+ "./testing": {
32
+ "default": "./dist/testing/index.js",
33
+ "types": "./dist/testing/index.d.ts"
34
+ }
35
+ },
36
+ "files": [
37
+ "dist/**/*",
38
+ "src/**/*"
39
+ ],
40
+ "license": "Apache-2.0",
41
+ "main": "dist/index.js",
42
+ "name": "@terreno/syncdb",
43
+ "peerDependencies": {
44
+ "expo-sqlite": "*",
45
+ "react": "19.2.3"
46
+ },
47
+ "peerDependenciesMeta": {
48
+ "expo-sqlite": {
49
+ "optional": true
50
+ },
51
+ "react": {
52
+ "optional": true
53
+ }
54
+ },
55
+ "publishConfig": {
56
+ "access": "public"
57
+ },
58
+ "scripts": {
59
+ "compile": "tsc",
60
+ "compile:watch": "tsc -w",
61
+ "dev": "tsc -w",
62
+ "lint": "biome check .",
63
+ "lint:fix": "biome check --write .",
64
+ "lint:unsafefix": "biome check --write --unsafe .",
65
+ "test": "bun test",
66
+ "test:ci": "bun test",
67
+ "test:coverage": "bun run ../scripts/check-coverage.ts"
68
+ },
69
+ "types": "dist/index.d.ts",
70
+ "version": "56.0.0-beta.0"
71
+ }
@@ -0,0 +1,455 @@
1
+ import {describe, expect, it} from "bun:test";
2
+
3
+ import {
4
+ type BetterAuthAdapterOptions,
5
+ betterAuthAdapter,
6
+ DEFAULT_AUTH_POLL_INTERVAL_MS,
7
+ } from "./betterAuthAdapter";
8
+ import type {BetterAuthClientLike, BetterAuthGetSessionResult} from "./types";
9
+
10
+ const flush = async (): Promise<void> => {
11
+ await new Promise((resolve) => setTimeout(resolve, 0));
12
+ };
13
+
14
+ const makeClient = (
15
+ result: () => Promise<BetterAuthGetSessionResult>,
16
+ useSession?: BetterAuthClientLike["useSession"]
17
+ ): BetterAuthClientLike => ({getSession: result, useSession});
18
+
19
+ describe("betterAuthAdapter", () => {
20
+ describe("getToken / getUserId", () => {
21
+ it("reads token and userId from the {data} envelope shape", async () => {
22
+ const adapter = betterAuthAdapter(
23
+ makeClient(async () => ({data: {session: {token: "tok-1"}, user: {id: "u1"}}}))
24
+ );
25
+ expect(await adapter.getToken()).toBe("tok-1");
26
+ expect(await adapter.getUserId()).toBe("u1");
27
+ });
28
+
29
+ it("reads token and userId from the direct (unwrapped) shape", async () => {
30
+ const adapter = betterAuthAdapter(
31
+ makeClient(async () => ({session: {token: "tok-2"}, user: {id: "u2"}}))
32
+ );
33
+ expect(await adapter.getToken()).toBe("tok-2");
34
+ expect(await adapter.getUserId()).toBe("u2");
35
+ });
36
+
37
+ it("returns null when signed out (null, undefined, or empty envelope)", async () => {
38
+ for (const result of [null, undefined, {data: null}, {data: {}}, {}]) {
39
+ const adapter = betterAuthAdapter(makeClient(async () => result));
40
+ expect(await adapter.getToken()).toBeNull();
41
+ expect(await adapter.getUserId()).toBeNull();
42
+ }
43
+ });
44
+
45
+ it("returns null when the session payload is missing token or user id", async () => {
46
+ const adapter = betterAuthAdapter(makeClient(async () => ({data: {session: {}, user: {}}})));
47
+ expect(await adapter.getToken()).toBeNull();
48
+ expect(await adapter.getUserId()).toBeNull();
49
+ });
50
+
51
+ it("returns null when getSession rejects", async () => {
52
+ const adapter = betterAuthAdapter(
53
+ makeClient(async () => {
54
+ throw new Error("network down");
55
+ })
56
+ );
57
+ expect(await adapter.getToken()).toBeNull();
58
+ expect(await adapter.getUserId()).toBeNull();
59
+ });
60
+
61
+ it("returns null when getSession resolves to a non-object", async () => {
62
+ const adapter = betterAuthAdapter(
63
+ makeClient(async () => "nonsense" as unknown as BetterAuthGetSessionResult)
64
+ );
65
+ expect(await adapter.getToken()).toBeNull();
66
+ });
67
+ });
68
+
69
+ describe("refresh (A4)", () => {
70
+ it("returns true when a re-fetched session carries a token", async () => {
71
+ const adapter = betterAuthAdapter(
72
+ makeClient(async () => ({data: {session: {token: "tok-1"}, user: {id: "u1"}}}))
73
+ );
74
+ expect(await adapter.refresh?.()).toBe(true);
75
+ });
76
+
77
+ it("returns false when the re-fetched session has no token (still signed out)", async () => {
78
+ const adapter = betterAuthAdapter(makeClient(async () => ({data: null})));
79
+ expect(await adapter.refresh?.()).toBe(false);
80
+ });
81
+
82
+ it("returns false rather than throwing when getSession rejects", async () => {
83
+ const adapter = betterAuthAdapter(
84
+ makeClient(async () => {
85
+ throw new Error("network down");
86
+ })
87
+ );
88
+ await expect(adapter.refresh?.()).resolves.toBe(false);
89
+ });
90
+ });
91
+
92
+ describe("onAuthChange via useSession subscription", () => {
93
+ interface FakeAtom {
94
+ listeners: Set<(value: unknown) => void>;
95
+ emit: (value: unknown) => void;
96
+ }
97
+
98
+ const makeAtom = (): FakeAtom => {
99
+ const listeners = new Set<(value: unknown) => void>();
100
+ return {
101
+ emit: (value: unknown): void => {
102
+ for (const listener of listeners) {
103
+ listener(value);
104
+ }
105
+ },
106
+ listeners,
107
+ };
108
+ };
109
+
110
+ it("fans out session changes to every subscribed callback", async () => {
111
+ const atom = makeAtom();
112
+ const adapter = betterAuthAdapter(
113
+ makeClient(async () => null, {
114
+ subscribe: (listener) => {
115
+ atom.listeners.add(listener);
116
+ return () => atom.listeners.delete(listener);
117
+ },
118
+ })
119
+ );
120
+ let aCount = 0;
121
+ let bCount = 0;
122
+ const unsubscribeA = adapter.onAuthChange(() => {
123
+ aCount += 1;
124
+ });
125
+ adapter.onAuthChange(() => {
126
+ bCount += 1;
127
+ });
128
+
129
+ atom.emit({user: {id: "u1"}});
130
+ expect(aCount).toBe(1);
131
+ expect(bCount).toBe(1);
132
+
133
+ unsubscribeA();
134
+ atom.emit({user: null});
135
+ expect(aCount).toBe(1);
136
+ expect(bCount).toBe(2);
137
+ });
138
+
139
+ it("dedupes emissions by session identity (re-fetches with the same session do not fire)", () => {
140
+ const atom = makeAtom();
141
+ const adapter = betterAuthAdapter(
142
+ makeClient(async () => null, {
143
+ subscribe: (listener) => {
144
+ atom.listeners.add(listener);
145
+ return () => atom.listeners.delete(listener);
146
+ },
147
+ })
148
+ );
149
+ let calls = 0;
150
+ adapter.onAuthChange(() => {
151
+ calls += 1;
152
+ });
153
+
154
+ // Initial session emission fires once...
155
+ atom.emit({data: {session: {token: "tok-a"}, user: {id: "u1"}}});
156
+ expect(calls).toBe(1);
157
+ // ...but re-emissions with the same identity (fresh objects per get-session
158
+ // fetch) are swallowed — this is what breaks the auth-change feedback loop.
159
+ atom.emit({data: {session: {token: "tok-a"}, user: {id: "u1"}}});
160
+ atom.emit({data: {session: {token: "tok-a"}, user: {id: "u1"}}});
161
+ expect(calls).toBe(1);
162
+
163
+ // Token rotation (same user) is a genuine identity change.
164
+ atom.emit({data: {session: {token: "tok-b"}, user: {id: "u1"}}});
165
+ expect(calls).toBe(2);
166
+
167
+ // Logout (null data) changes identity again.
168
+ atom.emit({data: null});
169
+ expect(calls).toBe(3);
170
+ atom.emit({data: null});
171
+ expect(calls).toBe(3);
172
+ });
173
+
174
+ it("ignores in-flight (isPending) emissions", () => {
175
+ const atom = makeAtom();
176
+ const adapter = betterAuthAdapter(
177
+ makeClient(async () => null, {
178
+ subscribe: (listener) => {
179
+ atom.listeners.add(listener);
180
+ return () => atom.listeners.delete(listener);
181
+ },
182
+ })
183
+ );
184
+ let calls = 0;
185
+ adapter.onAuthChange(() => {
186
+ calls += 1;
187
+ });
188
+
189
+ atom.emit({data: null, isPending: true});
190
+ expect(calls).toBe(0);
191
+ atom.emit({data: {session: {token: "tok"}, user: {id: "u1"}}, isPending: false});
192
+ expect(calls).toBe(1);
193
+ atom.emit({data: {session: {token: "tok"}, user: {id: "u1"}}, isPending: true});
194
+ expect(calls).toBe(1);
195
+ });
196
+
197
+ it("ignores failed-read emissions so a transient error is never a phantom logout", () => {
198
+ const atom = makeAtom();
199
+ const adapter = betterAuthAdapter(
200
+ makeClient(async () => null, {
201
+ subscribe: (listener) => {
202
+ atom.listeners.add(listener);
203
+ return () => atom.listeners.delete(listener);
204
+ },
205
+ })
206
+ );
207
+ let count = 0;
208
+ adapter.onAuthChange(() => {
209
+ count += 1;
210
+ });
211
+
212
+ atom.emit({data: {session: {token: "tok"}, user: {id: "u1"}}});
213
+ expect(count).toBe(1);
214
+
215
+ // A get-session network failure emits {data: null, error} — shaped exactly like a
216
+ // signed-out session. Treating it as a logout would clear the client's current
217
+ // user and break local-first writes, so it must not fire.
218
+ atom.emit({data: null, error: {message: "Failed to fetch"}});
219
+ atom.emit({data: null, error: new Error("network down")});
220
+ expect(count).toBe(1);
221
+
222
+ // The identity is unchanged, so recovering to the SAME session is not a change.
223
+ atom.emit({data: {session: {token: "tok"}, user: {id: "u1"}}});
224
+ expect(count).toBe(1);
225
+
226
+ // A genuine sign-out (successful read, no session) still fires.
227
+ atom.emit({data: null});
228
+ expect(count).toBe(2);
229
+ });
230
+
231
+ it("forwards opaque emissions it cannot parse (back-compat)", () => {
232
+ const atom = makeAtom();
233
+ const adapter = betterAuthAdapter(
234
+ makeClient(async () => null, {
235
+ subscribe: (listener) => {
236
+ atom.listeners.add(listener);
237
+ return () => atom.listeners.delete(listener);
238
+ },
239
+ })
240
+ );
241
+ let calls = 0;
242
+ adapter.onAuthChange(() => {
243
+ calls += 1;
244
+ });
245
+
246
+ atom.emit(true);
247
+ atom.emit(false);
248
+ expect(calls).toBe(2);
249
+ });
250
+
251
+ it("tolerates a subscribe implementation that returns no unsubscribe function", () => {
252
+ const adapter = betterAuthAdapter(
253
+ makeClient(async () => null, {
254
+ subscribe: (() => undefined) as unknown as (cb: (v: unknown) => void) => () => void,
255
+ })
256
+ );
257
+ const unsubscribe = adapter.onAuthChange(() => {});
258
+ expect(() => unsubscribe()).not.toThrow();
259
+ });
260
+ });
261
+
262
+ describe("onAuthChange polling fallback", () => {
263
+ interface FakeTimers {
264
+ handlers: Map<number, () => void>;
265
+ lastMs: number | undefined;
266
+ cleared: number[];
267
+ options: BetterAuthAdapterOptions;
268
+ tick: () => Promise<void>;
269
+ }
270
+
271
+ const makeTimers = (): FakeTimers => {
272
+ const handlers = new Map<number, () => void>();
273
+ let nextHandle = 1;
274
+ const timers: FakeTimers = {
275
+ cleared: [],
276
+ handlers,
277
+ lastMs: undefined,
278
+ options: {
279
+ clearIntervalFn: (handle) => {
280
+ timers.cleared.push(handle as number);
281
+ handlers.delete(handle as number);
282
+ },
283
+ setIntervalFn: (handler, ms) => {
284
+ timers.lastMs = ms;
285
+ const handle = nextHandle;
286
+ nextHandle += 1;
287
+ handlers.set(handle, handler);
288
+ return handle;
289
+ },
290
+ },
291
+ tick: async () => {
292
+ for (const handler of handlers.values()) {
293
+ handler();
294
+ }
295
+ await flush();
296
+ },
297
+ };
298
+ return timers;
299
+ };
300
+
301
+ it("polls with the default interval and fires only when the session identity changes", async () => {
302
+ let session: BetterAuthGetSessionResult = {
303
+ data: {session: {token: "tok-a"}, user: {id: "u1"}},
304
+ };
305
+ const timers = makeTimers();
306
+ const adapter = betterAuthAdapter(
307
+ makeClient(async () => session),
308
+ timers.options
309
+ );
310
+ let calls = 0;
311
+ const unsubscribe = adapter.onAuthChange(() => {
312
+ calls += 1;
313
+ });
314
+ expect(timers.lastMs).toBe(DEFAULT_AUTH_POLL_INTERVAL_MS);
315
+ // Let the baseline sample resolve, then poll with an unchanged session.
316
+ await flush();
317
+ await timers.tick();
318
+ expect(calls).toBe(0);
319
+
320
+ // Token refresh (same user): identity key changes → callback fires.
321
+ session = {data: {session: {token: "tok-b"}, user: {id: "u1"}}};
322
+ await timers.tick();
323
+ expect(calls).toBe(1);
324
+
325
+ // No further change → no further calls.
326
+ await timers.tick();
327
+ expect(calls).toBe(1);
328
+
329
+ // User switch fires again.
330
+ session = {data: {session: {token: "tok-c"}, user: {id: "u2"}}};
331
+ await timers.tick();
332
+ expect(calls).toBe(2);
333
+
334
+ unsubscribe();
335
+ expect(timers.cleared).toHaveLength(1);
336
+ session = null;
337
+ await timers.tick();
338
+ expect(calls).toBe(2);
339
+ });
340
+
341
+ it("skips polls whose session read failed instead of sampling a phantom logout", async () => {
342
+ let session: BetterAuthGetSessionResult = {
343
+ data: {session: {token: "tok-a"}, user: {id: "u1"}},
344
+ };
345
+ let shouldThrow = false;
346
+ const timers = makeTimers();
347
+ const adapter = betterAuthAdapter(
348
+ makeClient(async () => {
349
+ if (shouldThrow) {
350
+ throw new Error("network down");
351
+ }
352
+ return session;
353
+ }),
354
+ timers.options
355
+ );
356
+ let calls = 0;
357
+ adapter.onAuthChange(() => {
358
+ calls += 1;
359
+ });
360
+ await flush();
361
+ await timers.tick();
362
+ expect(calls).toBe(0);
363
+
364
+ // A failing read must not be sampled as a signed-out identity.
365
+ shouldThrow = true;
366
+ await timers.tick();
367
+ await timers.tick();
368
+ expect(calls).toBe(0);
369
+
370
+ // Recovering to the same session is still not a change.
371
+ shouldThrow = false;
372
+ await timers.tick();
373
+ expect(calls).toBe(0);
374
+
375
+ // A real sign-out (successful read, no session) still fires.
376
+ session = null;
377
+ await timers.tick();
378
+ expect(calls).toBe(1);
379
+ });
380
+
381
+ it("uses the first poll as baseline when it beats the subscribe-time sample", async () => {
382
+ let resolveBaseline: (() => void) | undefined;
383
+ let firstCall = true;
384
+ const timers = makeTimers();
385
+ const adapter = betterAuthAdapter(
386
+ makeClient(async () => {
387
+ if (firstCall) {
388
+ firstCall = false;
389
+ // Hold the subscribe-time baseline sample until released.
390
+ await new Promise<void>((resolve) => {
391
+ resolveBaseline = resolve;
392
+ });
393
+ }
394
+ return {data: {session: {token: "tok"}, user: {id: "u1"}}};
395
+ }),
396
+ {...timers.options, pollIntervalMs: 50}
397
+ );
398
+ let calls = 0;
399
+ adapter.onAuthChange(() => {
400
+ calls += 1;
401
+ });
402
+ expect(timers.lastMs).toBe(50);
403
+
404
+ // First tick establishes the baseline (no change event).
405
+ await timers.tick();
406
+ expect(calls).toBe(0);
407
+
408
+ // Late-resolving subscribe-time sample must not clobber the baseline.
409
+ resolveBaseline?.();
410
+ await flush();
411
+ await timers.tick();
412
+ expect(calls).toBe(0);
413
+ });
414
+
415
+ it("stops reacting after unsubscribe even with a poll in flight", async () => {
416
+ let session: BetterAuthGetSessionResult = {data: {session: {token: "a"}, user: {id: "u1"}}};
417
+ const timers = makeTimers();
418
+ const adapter = betterAuthAdapter(
419
+ makeClient(async () => session),
420
+ timers.options
421
+ );
422
+ let calls = 0;
423
+ const unsubscribe = adapter.onAuthChange(() => {
424
+ calls += 1;
425
+ });
426
+ await flush();
427
+
428
+ // Start a poll, then dispose before its async read lands.
429
+ session = {data: {session: {token: "b"}, user: {id: "u1"}}};
430
+ for (const handler of timers.handlers.values()) {
431
+ handler();
432
+ }
433
+ unsubscribe();
434
+ await flush();
435
+ expect(calls).toBe(0);
436
+ });
437
+
438
+ it("falls back to real timers when no interval functions are injected", async () => {
439
+ let session: BetterAuthGetSessionResult = {data: {session: {token: "a"}, user: {id: "u1"}}};
440
+ const adapter = betterAuthAdapter(
441
+ makeClient(async () => session),
442
+ {pollIntervalMs: 5}
443
+ );
444
+ let calls = 0;
445
+ const unsubscribe = adapter.onAuthChange(() => {
446
+ calls += 1;
447
+ });
448
+ await new Promise((resolve) => setTimeout(resolve, 15));
449
+ session = {data: {session: {token: "b"}, user: {id: "u1"}}};
450
+ await new Promise((resolve) => setTimeout(resolve, 25));
451
+ unsubscribe();
452
+ expect(calls).toBeGreaterThanOrEqual(1);
453
+ });
454
+ });
455
+ });