@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,214 @@
1
+ import type {AuthProvider} from "../types";
2
+ import type {BetterAuthClientLike, BetterAuthSessionDataLike} from "./types";
3
+
4
+ /** Default polling cadence when the client exposes no session subscription. */
5
+ export const DEFAULT_AUTH_POLL_INTERVAL_MS = 5_000;
6
+
7
+ export interface BetterAuthAdapterOptions {
8
+ /** Polling cadence for the fallback watcher (default {@link DEFAULT_AUTH_POLL_INTERVAL_MS}). */
9
+ pollIntervalMs?: number;
10
+ /** Interval scheduler, injectable for deterministic tests (default global setInterval). */
11
+ setIntervalFn?: (handler: () => void, ms: number) => unknown;
12
+ /** Interval canceller matching `setIntervalFn` (default global clearInterval). */
13
+ clearIntervalFn?: (handle: unknown) => void;
14
+ }
15
+
16
+ /**
17
+ * Unwrap `getSession()` results: Better Auth returns a `{data}` envelope, some
18
+ * wrappers return the payload directly, and signed-out states are null-ish.
19
+ */
20
+ const unwrapSession = (result: unknown): BetterAuthSessionDataLike | null => {
21
+ if (!result || typeof result !== "object") {
22
+ return null;
23
+ }
24
+ if ("data" in result) {
25
+ const data = (result as {data?: BetterAuthSessionDataLike | null}).data;
26
+ return data && typeof data === "object" ? data : null;
27
+ }
28
+ return result as BetterAuthSessionDataLike;
29
+ };
30
+
31
+ /**
32
+ * Adapt a Better Auth client to syncdb's {@link AuthProvider} contract.
33
+ * Tokens/user ids are read per call via `getSession()` (never cached, so
34
+ * Better Auth session refresh is picked up transparently); auth changes are
35
+ * delivered through the client's nanostore session atom when available, with
36
+ * an injectable polling fallback otherwise. All read errors degrade to null —
37
+ * a broken auth client behaves like "signed out", never a crash.
38
+ */
39
+ export const betterAuthAdapter = (
40
+ authClient: BetterAuthClientLike,
41
+ options: BetterAuthAdapterOptions = {}
42
+ ): AuthProvider => {
43
+ const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_AUTH_POLL_INTERVAL_MS;
44
+ const setIntervalFn =
45
+ options.setIntervalFn ??
46
+ ((handler: () => void, ms: number): unknown => setInterval(handler, ms));
47
+ const clearIntervalFn =
48
+ options.clearIntervalFn ??
49
+ ((handle: unknown): void => clearInterval(handle as ReturnType<typeof setInterval>));
50
+
51
+ /**
52
+ * Read the session, distinguishing "read failed" from "signed out". Both surface as
53
+ * a null session, but only the latter is an identity change — see
54
+ * {@link classifyEmission}.
55
+ */
56
+ const readSessionResult = async (): Promise<{
57
+ ok: boolean;
58
+ session: BetterAuthSessionDataLike | null;
59
+ }> => {
60
+ try {
61
+ return {ok: true, session: unwrapSession(await authClient.getSession())};
62
+ } catch {
63
+ return {ok: false, session: null};
64
+ }
65
+ };
66
+
67
+ const readSession = async (): Promise<BetterAuthSessionDataLike | null> => {
68
+ return (await readSessionResult()).session;
69
+ };
70
+
71
+ /**
72
+ * One-shot silent refresh consumed by the client's A4 auth-pause pipeline:
73
+ * re-fetch the session (Better Auth clients transparently refresh/renew the
74
+ * underlying token on `getSession()` when the client library supports it)
75
+ * and report whether a usable token now exists. Never throws — a failed
76
+ * refresh just means the pause surfaces to the app as usual.
77
+ */
78
+ const refresh = async (): Promise<boolean> => {
79
+ const session = await readSession();
80
+ return Boolean(session?.session?.token);
81
+ };
82
+
83
+ const getToken = async (): Promise<string | null> => {
84
+ const session = await readSession();
85
+ return session?.session?.token ?? null;
86
+ };
87
+
88
+ const getUserId = async (): Promise<string | null> => {
89
+ const session = await readSession();
90
+ return session?.user?.id ?? null;
91
+ };
92
+
93
+ /**
94
+ * Identity snapshot used by the polling fallback to detect auth changes. Returns null
95
+ * when the read itself failed, so a transient network error is never sampled as a
96
+ * signed-out identity (the same phantom-logout hazard {@link classifyEmission} guards).
97
+ */
98
+ const readAuthKey = async (): Promise<string | null> => {
99
+ const {ok, session} = await readSessionResult();
100
+ if (!ok) {
101
+ return null;
102
+ }
103
+ return `${session?.user?.id ?? ""}|${session?.session?.token ?? ""}`;
104
+ };
105
+
106
+ /**
107
+ * Classify a session-atom emission for the subscribe path:
108
+ * - "pending": an in-flight fetch state (`isPending: true`) or a FAILED read
109
+ * (`error` set) — never a change;
110
+ * - `{key}`: a parseable session envelope reduced to its identity (userId|token);
111
+ * - null: an opaque value the adapter cannot interpret.
112
+ *
113
+ * A failed read is deliberately indistinguishable from "pending" here. Better Auth
114
+ * emits `{data: null, error}` when a get-session fetch fails, which is shaped exactly
115
+ * like a signed-out session — forwarding it would report a PHANTOM logout, and the
116
+ * client's logout path clears its current-user pointer, breaking local-first writes
117
+ * (`mutate()` throws) until the next real auth event. A transient network failure is a
118
+ * recoverable state, not a sign-out (INV-2), so the identity is left unchanged and the
119
+ * next successful emission decides.
120
+ */
121
+ const classifyEmission = (value: unknown): {key: string} | "pending" | null => {
122
+ if (!value || typeof value !== "object") {
123
+ return null;
124
+ }
125
+ const emission = value as {
126
+ isPending?: unknown;
127
+ data?: unknown;
128
+ user?: unknown;
129
+ error?: unknown;
130
+ };
131
+ if (emission.isPending === true) {
132
+ return "pending";
133
+ }
134
+ if (emission.error) {
135
+ return "pending";
136
+ }
137
+ let payload: BetterAuthSessionDataLike | null = null;
138
+ if ("data" in emission) {
139
+ payload =
140
+ emission.data && typeof emission.data === "object"
141
+ ? (emission.data as BetterAuthSessionDataLike)
142
+ : null;
143
+ } else if ("user" in emission || "session" in emission) {
144
+ payload = emission as BetterAuthSessionDataLike;
145
+ } else {
146
+ return null;
147
+ }
148
+ return {key: `${payload?.user?.id ?? ""}|${payload?.session?.token ?? ""}`};
149
+ };
150
+
151
+ const onAuthChange = (callback: () => void): (() => void) => {
152
+ const subscribe = authClient.useSession?.subscribe;
153
+ if (typeof subscribe === "function") {
154
+ // Dedupe by session identity: Better Auth's session atom re-emits on EVERY
155
+ // get-session fetch (each settles with a fresh object), including fetches this
156
+ // adapter's own getToken/getUserId trigger. Forwarding every emission creates a
157
+ // feedback loop (auth change → getUserId → getSession → atom emission → auth
158
+ // change → ...), so only a genuine identity change (login/logout/user switch/
159
+ // token rotation) may fire the callback. In-flight (`isPending`) states are
160
+ // skipped; opaque values the adapter cannot parse are forwarded as before.
161
+ let lastKey: string | undefined;
162
+ const unsubscribe = subscribe((value) => {
163
+ const parsed = classifyEmission(value);
164
+ if (parsed === "pending") {
165
+ return;
166
+ }
167
+ if (parsed === null) {
168
+ callback();
169
+ return;
170
+ }
171
+ if (parsed.key === lastKey) {
172
+ return;
173
+ }
174
+ lastKey = parsed.key;
175
+ callback();
176
+ });
177
+ return typeof unsubscribe === "function" ? unsubscribe : (): void => {};
178
+ }
179
+
180
+ // Polling fallback: sample the session identity and fire on change. The
181
+ // first sample only establishes the baseline so subscribing never emits a
182
+ // spurious change for the already-current session.
183
+ let disposed = false;
184
+ let lastKey: string | undefined;
185
+ void readAuthKey().then((key) => {
186
+ if (!disposed && lastKey === undefined && key !== null) {
187
+ lastKey = key;
188
+ }
189
+ });
190
+ const handle = setIntervalFn(() => {
191
+ void readAuthKey().then((key) => {
192
+ if (disposed || key === null) {
193
+ // Failed read: hold the last known identity rather than sampling it as
194
+ // signed out.
195
+ return;
196
+ }
197
+ if (lastKey === undefined) {
198
+ lastKey = key;
199
+ return;
200
+ }
201
+ if (key !== lastKey) {
202
+ lastKey = key;
203
+ callback();
204
+ }
205
+ });
206
+ }, pollIntervalMs);
207
+ return () => {
208
+ disposed = true;
209
+ clearIntervalFn(handle);
210
+ };
211
+ };
212
+
213
+ return {getToken, getUserId, onAuthChange, refresh};
214
+ };
@@ -0,0 +1,49 @@
1
+ /**
2
+ * Structural types for the Better Auth client surface consumed by
3
+ * {@link ../auth/betterAuthAdapter!betterAuthAdapter}. Better Auth is NOT a
4
+ * dependency of this package — these narrow interfaces describe just the
5
+ * pieces syncdb touches (the shape produced by `rtk/src/betterAuthClient.ts`
6
+ * and the admin-spa client), so any object matching them works.
7
+ */
8
+
9
+ /** The user portion of a Better Auth session. */
10
+ export interface BetterAuthUserLike {
11
+ id?: string | null;
12
+ }
13
+
14
+ /** The session portion of a Better Auth session (carries the bearer token). */
15
+ export interface BetterAuthSessionLike {
16
+ token?: string | null;
17
+ }
18
+
19
+ /** Combined session payload: `{session, user}`. */
20
+ export interface BetterAuthSessionDataLike {
21
+ session?: BetterAuthSessionLike | null;
22
+ user?: BetterAuthUserLike | null;
23
+ }
24
+
25
+ /**
26
+ * What `authClient.getSession()` resolves to. Better Auth wraps the payload in
27
+ * a `{data}` envelope; some wrappers unwrap it — the adapter tolerates both,
28
+ * plus null/undefined when signed out.
29
+ */
30
+ export type BetterAuthGetSessionResult =
31
+ | {data?: BetterAuthSessionDataLike | null}
32
+ | BetterAuthSessionDataLike
33
+ | null
34
+ | undefined;
35
+
36
+ /**
37
+ * Nanostore-style session atom exposed by Better Auth clients
38
+ * (`authClient.useSession.subscribe(listener)` returns an unsubscribe).
39
+ */
40
+ export interface BetterAuthSessionAtomLike {
41
+ subscribe?: (listener: (value: unknown) => void) => () => void;
42
+ }
43
+
44
+ /** Minimal Better Auth client surface required by the adapter. */
45
+ export interface BetterAuthClientLike {
46
+ getSession: () => Promise<BetterAuthGetSessionResult>;
47
+ /** Present on nanostore-backed clients; enables poll-free auth-change delivery. */
48
+ useSession?: BetterAuthSessionAtomLike;
49
+ }