@terreno/syncdb 57.21.0 → 58.0.0-beta.1

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 (476) hide show
  1. package/CHANGELOG.md +43 -0
  2. package/README.md +7 -7
  3. package/dist/api/apiError.d.ts +43 -0
  4. package/dist/api/apiError.d.ts.map +1 -0
  5. package/dist/api/apiError.js +28 -0
  6. package/dist/api/apiError.js.map +1 -0
  7. package/dist/api/apiFetch.d.ts +44 -0
  8. package/dist/api/apiFetch.d.ts.map +1 -0
  9. package/dist/api/apiFetch.js +203 -0
  10. package/dist/api/apiFetch.js.map +1 -0
  11. package/dist/api/client.d.ts +70 -0
  12. package/dist/api/client.d.ts.map +1 -0
  13. package/dist/api/client.js +240 -0
  14. package/dist/api/client.js.map +1 -0
  15. package/dist/api/client.test.d.ts +2 -0
  16. package/dist/api/client.test.d.ts.map +1 -0
  17. package/dist/api/client.test.js +588 -0
  18. package/dist/api/client.test.js.map +1 -0
  19. package/dist/app/app.d.ts +13 -0
  20. package/dist/app/app.d.ts.map +1 -0
  21. package/dist/app/app.js +13 -0
  22. package/dist/app/app.js.map +1 -0
  23. package/dist/app/devConsoleLogger.d.ts +18 -0
  24. package/dist/app/devConsoleLogger.d.ts.map +1 -0
  25. package/dist/app/devConsoleLogger.js +147 -0
  26. package/dist/app/devConsoleLogger.js.map +1 -0
  27. package/dist/app/devConsoleLogger.test.d.ts +2 -0
  28. package/dist/app/devConsoleLogger.test.d.ts.map +1 -0
  29. package/dist/app/devConsoleLogger.test.js +202 -0
  30. package/dist/app/devConsoleLogger.test.js.map +1 -0
  31. package/dist/app/mcpTools.d.ts +32 -0
  32. package/dist/app/mcpTools.d.ts.map +1 -0
  33. package/dist/app/mcpTools.js +61 -0
  34. package/dist/app/mcpTools.js.map +1 -0
  35. package/dist/app/permissions.d.ts +26 -0
  36. package/dist/app/permissions.d.ts.map +1 -0
  37. package/dist/app/permissions.js +37 -0
  38. package/dist/app/permissions.js.map +1 -0
  39. package/dist/app/permissions.test.d.ts +2 -0
  40. package/dist/app/permissions.test.d.ts.map +1 -0
  41. package/dist/app/permissions.test.js +36 -0
  42. package/dist/app/permissions.test.js.map +1 -0
  43. package/dist/app/upgradeCheck.d.ts +46 -0
  44. package/dist/app/upgradeCheck.d.ts.map +1 -0
  45. package/dist/app/upgradeCheck.js +121 -0
  46. package/dist/app/upgradeCheck.js.map +1 -0
  47. package/dist/auth/SessionProvider.d.ts +40 -0
  48. package/dist/auth/SessionProvider.d.ts.map +1 -0
  49. package/dist/auth/SessionProvider.js +44 -0
  50. package/dist/auth/SessionProvider.js.map +1 -0
  51. package/dist/auth/SessionProvider.test.d.ts +2 -0
  52. package/dist/auth/SessionProvider.test.d.ts.map +1 -0
  53. package/dist/auth/SessionProvider.test.js +240 -0
  54. package/dist/auth/SessionProvider.test.js.map +1 -0
  55. package/dist/auth/TerrenoAccountSecurityScreen.d.ts +25 -0
  56. package/dist/auth/TerrenoAccountSecurityScreen.d.ts.map +1 -0
  57. package/dist/auth/TerrenoAccountSecurityScreen.js +21 -0
  58. package/dist/auth/TerrenoAccountSecurityScreen.js.map +1 -0
  59. package/dist/auth/TerrenoLoginScreen.d.ts +62 -0
  60. package/dist/auth/TerrenoLoginScreen.d.ts.map +1 -0
  61. package/dist/auth/TerrenoLoginScreen.js +45 -0
  62. package/dist/auth/TerrenoLoginScreen.js.map +1 -0
  63. package/dist/auth/auth.d.ts +36 -0
  64. package/dist/auth/auth.d.ts.map +1 -0
  65. package/dist/auth/auth.js +35 -0
  66. package/dist/auth/auth.js.map +1 -0
  67. package/dist/auth/betterAuthAdapter.d.ts +1 -1
  68. package/dist/auth/betterAuthClient.d.ts +276 -0
  69. package/dist/auth/betterAuthClient.d.ts.map +1 -0
  70. package/dist/auth/betterAuthClient.js +744 -0
  71. package/dist/auth/betterAuthClient.js.map +1 -0
  72. package/dist/auth/betterAuthClient.types.test.d.ts +2 -0
  73. package/dist/auth/betterAuthClient.types.test.d.ts.map +1 -0
  74. package/dist/auth/betterAuthClient.types.test.js +151 -0
  75. package/dist/auth/betterAuthClient.types.test.js.map +1 -0
  76. package/dist/auth/betterAuthClientRegistry.d.ts +51 -0
  77. package/dist/auth/betterAuthClientRegistry.d.ts.map +1 -0
  78. package/dist/auth/betterAuthClientRegistry.js +69 -0
  79. package/dist/auth/betterAuthClientRegistry.js.map +1 -0
  80. package/dist/auth/betterAuthClientRegistry.test.d.ts +2 -0
  81. package/dist/auth/betterAuthClientRegistry.test.d.ts.map +1 -0
  82. package/dist/auth/betterAuthClientRegistry.test.js +91 -0
  83. package/dist/auth/betterAuthClientRegistry.test.js.map +1 -0
  84. package/dist/auth/betterAuthTypes.d.ts +172 -0
  85. package/dist/auth/betterAuthTypes.d.ts.map +1 -0
  86. package/dist/auth/betterAuthTypes.js +7 -0
  87. package/dist/auth/betterAuthTypes.js.map +1 -0
  88. package/dist/auth/jwtAuthAdapter.d.ts +102 -0
  89. package/dist/auth/jwtAuthAdapter.d.ts.map +1 -0
  90. package/dist/auth/jwtAuthAdapter.js +282 -0
  91. package/dist/auth/jwtAuthAdapter.js.map +1 -0
  92. package/dist/auth/jwtAuthAdapter.test.d.ts +2 -0
  93. package/dist/auth/jwtAuthAdapter.test.d.ts.map +1 -0
  94. package/dist/auth/jwtAuthAdapter.test.js +614 -0
  95. package/dist/auth/jwtAuthAdapter.test.js.map +1 -0
  96. package/dist/auth/loginErrors.d.ts +75 -0
  97. package/dist/auth/loginErrors.d.ts.map +1 -0
  98. package/dist/auth/loginErrors.js +154 -0
  99. package/dist/auth/loginErrors.js.map +1 -0
  100. package/dist/auth/loginErrors.test.d.ts +2 -0
  101. package/dist/auth/loginErrors.test.d.ts.map +1 -0
  102. package/dist/auth/loginErrors.test.js +70 -0
  103. package/dist/auth/loginErrors.test.js.map +1 -0
  104. package/dist/auth/ownEntry.d.ts +8 -0
  105. package/dist/auth/ownEntry.d.ts.map +1 -0
  106. package/dist/auth/ownEntry.js +13 -0
  107. package/dist/auth/ownEntry.js.map +1 -0
  108. package/dist/auth/ownEntry.test.d.ts +2 -0
  109. package/dist/auth/ownEntry.test.d.ts.map +1 -0
  110. package/dist/auth/ownEntry.test.js +18 -0
  111. package/dist/auth/ownEntry.test.js.map +1 -0
  112. package/dist/auth/platform.d.ts +3 -0
  113. package/dist/auth/platform.d.ts.map +1 -0
  114. package/dist/auth/platform.js +4 -0
  115. package/dist/auth/platform.js.map +1 -0
  116. package/dist/auth/rememberedAccounts.d.ts +126 -0
  117. package/dist/auth/rememberedAccounts.d.ts.map +1 -0
  118. package/dist/auth/rememberedAccounts.js +399 -0
  119. package/dist/auth/rememberedAccounts.js.map +1 -0
  120. package/dist/auth/rememberedAccounts.test.d.ts +2 -0
  121. package/dist/auth/rememberedAccounts.test.d.ts.map +1 -0
  122. package/dist/auth/rememberedAccounts.test.js +676 -0
  123. package/dist/auth/rememberedAccounts.test.js.map +1 -0
  124. package/dist/auth/session.d.ts +118 -0
  125. package/dist/auth/session.d.ts.map +1 -0
  126. package/dist/auth/session.js +370 -0
  127. package/dist/auth/session.js.map +1 -0
  128. package/dist/auth/session.test.d.ts +2 -0
  129. package/dist/auth/session.test.d.ts.map +1 -0
  130. package/dist/auth/session.test.js +825 -0
  131. package/dist/auth/session.test.js.map +1 -0
  132. package/dist/auth/tokenExpiry.d.ts +70 -0
  133. package/dist/auth/tokenExpiry.d.ts.map +1 -0
  134. package/dist/auth/tokenExpiry.js +123 -0
  135. package/dist/auth/tokenExpiry.js.map +1 -0
  136. package/dist/auth/types.d.ts +1 -1
  137. package/dist/auth/types.js +1 -1
  138. package/dist/auth/useAccountSecurity.d.ts +183 -0
  139. package/dist/auth/useAccountSecurity.d.ts.map +1 -0
  140. package/dist/auth/useAccountSecurity.js +399 -0
  141. package/dist/auth/useAccountSecurity.js.map +1 -0
  142. package/dist/auth/useAccountSecurity.types.test.d.ts +2 -0
  143. package/dist/auth/useAccountSecurity.types.test.d.ts.map +1 -0
  144. package/dist/auth/useAccountSecurity.types.test.js +21 -0
  145. package/dist/auth/useAccountSecurity.types.test.js.map +1 -0
  146. package/dist/auth/useAuthMethods.d.ts +67 -0
  147. package/dist/auth/useAuthMethods.d.ts.map +1 -0
  148. package/dist/auth/useAuthMethods.js +77 -0
  149. package/dist/auth/useAuthMethods.js.map +1 -0
  150. package/dist/auth/useAuthMethods.test.d.ts +2 -0
  151. package/dist/auth/useAuthMethods.test.d.ts.map +1 -0
  152. package/dist/auth/useAuthMethods.test.js +145 -0
  153. package/dist/auth/useAuthMethods.test.js.map +1 -0
  154. package/dist/auth/useJwtAuth.d.ts +31 -0
  155. package/dist/auth/useJwtAuth.d.ts.map +1 -0
  156. package/dist/auth/useJwtAuth.js +58 -0
  157. package/dist/auth/useJwtAuth.js.map +1 -0
  158. package/dist/auth/useJwtAuth.test.d.ts +2 -0
  159. package/dist/auth/useJwtAuth.test.d.ts.map +1 -0
  160. package/dist/auth/useJwtAuth.test.js +165 -0
  161. package/dist/auth/useJwtAuth.test.js.map +1 -0
  162. package/dist/auth/useLoginController.d.ts +248 -0
  163. package/dist/auth/useLoginController.d.ts.map +1 -0
  164. package/dist/auth/useLoginController.js +671 -0
  165. package/dist/auth/useLoginController.js.map +1 -0
  166. package/dist/auth/useLoginController.types.test.d.ts +2 -0
  167. package/dist/auth/useLoginController.types.test.d.ts.map +1 -0
  168. package/dist/auth/useLoginController.types.test.js +19 -0
  169. package/dist/auth/useLoginController.types.test.js.map +1 -0
  170. package/dist/buildNumber.d.ts +34 -0
  171. package/dist/buildNumber.d.ts.map +1 -0
  172. package/dist/buildNumber.js +62 -0
  173. package/dist/buildNumber.js.map +1 -0
  174. package/dist/buildNumber.test.d.ts +2 -0
  175. package/dist/buildNumber.test.d.ts.map +1 -0
  176. package/dist/buildNumber.test.js +114 -0
  177. package/dist/buildNumber.test.js.map +1 -0
  178. package/dist/client.d.ts +10 -1
  179. package/dist/client.d.ts.map +1 -1
  180. package/dist/client.js +237 -184
  181. package/dist/client.js.map +1 -1
  182. package/dist/client.socketEvents.test.d.ts +2 -0
  183. package/dist/client.socketEvents.test.d.ts.map +1 -0
  184. package/dist/client.socketEvents.test.js +64 -0
  185. package/dist/client.socketEvents.test.js.map +1 -0
  186. package/dist/client.test.js +60 -1
  187. package/dist/client.test.js.map +1 -1
  188. package/dist/codegen/cli.js +23 -12
  189. package/dist/codegen/cli.js.map +1 -1
  190. package/dist/codegen/cli.test.js +57 -0
  191. package/dist/codegen/cli.test.js.map +1 -1
  192. package/dist/codegen/discoverCollections.d.ts.map +1 -1
  193. package/dist/codegen/discoverCollections.js +4 -0
  194. package/dist/codegen/discoverCollections.js.map +1 -1
  195. package/dist/codegen/discoverOperations.d.ts +11 -0
  196. package/dist/codegen/discoverOperations.d.ts.map +1 -0
  197. package/dist/codegen/discoverOperations.js +135 -0
  198. package/dist/codegen/discoverOperations.js.map +1 -0
  199. package/dist/codegen/emitApi.d.ts +8 -0
  200. package/dist/codegen/emitApi.d.ts.map +1 -0
  201. package/dist/codegen/emitApi.js +312 -0
  202. package/dist/codegen/emitApi.js.map +1 -0
  203. package/dist/codegen/emitApi.test.d.ts +2 -0
  204. package/dist/codegen/emitApi.test.d.ts.map +1 -0
  205. package/dist/codegen/emitApi.test.js +360 -0
  206. package/dist/codegen/emitApi.test.js.map +1 -0
  207. package/dist/codegen/emitSdk.js +2 -2
  208. package/dist/codegen/generate.d.ts +6 -1
  209. package/dist/codegen/generate.d.ts.map +1 -1
  210. package/dist/codegen/generate.js +18 -0
  211. package/dist/codegen/generate.js.map +1 -1
  212. package/dist/codegen/generate.test.js +53 -1
  213. package/dist/codegen/generate.test.js.map +1 -1
  214. package/dist/codegen/hookNames.d.ts +11 -0
  215. package/dist/codegen/hookNames.d.ts.map +1 -1
  216. package/dist/codegen/hookNames.js +23 -0
  217. package/dist/codegen/hookNames.js.map +1 -1
  218. package/dist/codegen/safeIdentifiers.d.ts +5 -1
  219. package/dist/codegen/safeIdentifiers.d.ts.map +1 -1
  220. package/dist/codegen/safeIdentifiers.js +7 -2
  221. package/dist/codegen/safeIdentifiers.js.map +1 -1
  222. package/dist/codegen/safeIdentifiers.test.js +9 -0
  223. package/dist/codegen/safeIdentifiers.test.js.map +1 -1
  224. package/dist/codegen/types.d.ts +46 -1
  225. package/dist/codegen/types.d.ts.map +1 -1
  226. package/dist/config/baseUrl.d.ts +13 -0
  227. package/dist/config/baseUrl.d.ts.map +1 -0
  228. package/dist/config/baseUrl.js +49 -0
  229. package/dist/config/baseUrl.js.map +1 -0
  230. package/dist/config/baseUrl.test.d.ts +2 -0
  231. package/dist/config/baseUrl.test.d.ts.map +1 -0
  232. package/dist/config/baseUrl.test.js +42 -0
  233. package/dist/config/baseUrl.test.js.map +1 -0
  234. package/dist/config/resolveBaseUrls.d.ts +53 -0
  235. package/dist/config/resolveBaseUrls.d.ts.map +1 -0
  236. package/dist/config/resolveBaseUrls.js +80 -0
  237. package/dist/config/resolveBaseUrls.js.map +1 -0
  238. package/dist/config/resolveBaseUrls.test.d.ts +2 -0
  239. package/dist/config/resolveBaseUrls.test.d.ts.map +1 -0
  240. package/dist/config/resolveBaseUrls.test.js +265 -0
  241. package/dist/config/resolveBaseUrls.test.js.map +1 -0
  242. package/dist/crypto/keyProviders.d.ts +2 -2
  243. package/dist/crypto/keyProviders.d.ts.map +1 -1
  244. package/dist/crypto/keyProviders.js +15 -4
  245. package/dist/crypto/keyProviders.js.map +1 -1
  246. package/dist/crypto/keyProviders.test.js +19 -0
  247. package/dist/crypto/keyProviders.test.js.map +1 -1
  248. package/dist/crypto/types.d.ts +5 -0
  249. package/dist/crypto/types.d.ts.map +1 -1
  250. package/dist/flags/flagTestServer.d.ts +19 -0
  251. package/dist/flags/flagTestServer.d.ts.map +1 -0
  252. package/dist/flags/flagTestServer.js +58 -0
  253. package/dist/flags/flagTestServer.js.map +1 -0
  254. package/dist/flags/useFeatureFlags.d.ts +30 -0
  255. package/dist/flags/useFeatureFlags.d.ts.map +1 -0
  256. package/dist/flags/useFeatureFlags.js +83 -0
  257. package/dist/flags/useFeatureFlags.js.map +1 -0
  258. package/dist/flags/useFeatureFlags.test.d.ts +2 -0
  259. package/dist/flags/useFeatureFlags.test.d.ts.map +1 -0
  260. package/dist/flags/useFeatureFlags.test.js +116 -0
  261. package/dist/flags/useFeatureFlags.test.js.map +1 -0
  262. package/dist/flags/useTerrenoFeatureFlags.d.ts +50 -0
  263. package/dist/flags/useTerrenoFeatureFlags.d.ts.map +1 -0
  264. package/dist/flags/useTerrenoFeatureFlags.js +125 -0
  265. package/dist/flags/useTerrenoFeatureFlags.js.map +1 -0
  266. package/dist/flags/useTerrenoFeatureFlags.test.d.ts +2 -0
  267. package/dist/flags/useTerrenoFeatureFlags.test.d.ts.map +1 -0
  268. package/dist/flags/useTerrenoFeatureFlags.test.js +259 -0
  269. package/dist/flags/useTerrenoFeatureFlags.test.js.map +1 -0
  270. package/dist/index.d.ts +2 -2
  271. package/dist/index.d.ts.map +1 -1
  272. package/dist/index.js +1 -1
  273. package/dist/index.js.map +1 -1
  274. package/dist/isolated/TerrenoAccountSecurityScreen.isolated.d.ts +2 -0
  275. package/dist/isolated/TerrenoAccountSecurityScreen.isolated.d.ts.map +1 -0
  276. package/dist/isolated/TerrenoAccountSecurityScreen.isolated.js +94 -0
  277. package/dist/isolated/TerrenoAccountSecurityScreen.isolated.js.map +1 -0
  278. package/dist/isolated/TerrenoLoginScreen.isolated.d.ts +2 -0
  279. package/dist/isolated/TerrenoLoginScreen.isolated.d.ts.map +1 -0
  280. package/dist/isolated/TerrenoLoginScreen.isolated.js +183 -0
  281. package/dist/isolated/TerrenoLoginScreen.isolated.js.map +1 -0
  282. package/dist/isolated/betterAuthClient.isolated.d.ts +2 -0
  283. package/dist/isolated/betterAuthClient.isolated.d.ts.map +1 -0
  284. package/dist/isolated/betterAuthClient.isolated.js +1734 -0
  285. package/dist/isolated/betterAuthClient.isolated.js.map +1 -0
  286. package/dist/isolated/betterAuthClient.native.isolated.d.ts +2 -0
  287. package/dist/isolated/betterAuthClient.native.isolated.d.ts.map +1 -0
  288. package/dist/isolated/betterAuthClient.native.isolated.js +153 -0
  289. package/dist/isolated/betterAuthClient.native.isolated.js.map +1 -0
  290. package/dist/isolated/mcpTools.isolated.d.ts +2 -0
  291. package/dist/isolated/mcpTools.isolated.d.ts.map +1 -0
  292. package/dist/isolated/mcpTools.isolated.js +197 -0
  293. package/dist/isolated/mcpTools.isolated.js.map +1 -0
  294. package/dist/isolated/rememberedAccounts.native.isolated.d.ts +2 -0
  295. package/dist/isolated/rememberedAccounts.native.isolated.d.ts.map +1 -0
  296. package/dist/isolated/rememberedAccounts.native.isolated.js +50 -0
  297. package/dist/isolated/rememberedAccounts.native.isolated.js.map +1 -0
  298. package/dist/isolated/sessionLogout.isolated.d.ts +2 -0
  299. package/dist/isolated/sessionLogout.isolated.d.ts.map +1 -0
  300. package/dist/isolated/sessionLogout.isolated.js +133 -0
  301. package/dist/isolated/sessionLogout.isolated.js.map +1 -0
  302. package/dist/isolated/tokenExpiry.isolated.d.ts +2 -0
  303. package/dist/isolated/tokenExpiry.isolated.d.ts.map +1 -0
  304. package/dist/isolated/tokenExpiry.isolated.js +232 -0
  305. package/dist/isolated/tokenExpiry.isolated.js.map +1 -0
  306. package/dist/isolated/upgradeCheck.isolated.d.ts +2 -0
  307. package/dist/isolated/upgradeCheck.isolated.d.ts.map +1 -0
  308. package/dist/isolated/upgradeCheck.isolated.js +241 -0
  309. package/dist/isolated/upgradeCheck.isolated.js.map +1 -0
  310. package/dist/isolated/useAccountSecurity.isolated.d.ts +2 -0
  311. package/dist/isolated/useAccountSecurity.isolated.d.ts.map +1 -0
  312. package/dist/isolated/useAccountSecurity.isolated.js +851 -0
  313. package/dist/isolated/useAccountSecurity.isolated.js.map +1 -0
  314. package/dist/isolated/useAccountSecurity.native.isolated.d.ts +2 -0
  315. package/dist/isolated/useAccountSecurity.native.isolated.d.ts.map +1 -0
  316. package/dist/isolated/useAccountSecurity.native.isolated.js +52 -0
  317. package/dist/isolated/useAccountSecurity.native.isolated.js.map +1 -0
  318. package/dist/isolated/useLoginController.isolated.d.ts +2 -0
  319. package/dist/isolated/useLoginController.isolated.d.ts.map +1 -0
  320. package/dist/isolated/useLoginController.isolated.js +1116 -0
  321. package/dist/isolated/useLoginController.isolated.js.map +1 -0
  322. package/dist/persisters/defaultPersisterFactory.native.d.ts.map +1 -1
  323. package/dist/persisters/defaultPersisterFactory.native.js +2 -0
  324. package/dist/persisters/defaultPersisterFactory.native.js.map +1 -1
  325. package/dist/persisters/encryptedIndexedDbPersister.d.ts.map +1 -1
  326. package/dist/persisters/encryptedIndexedDbPersister.js +3 -0
  327. package/dist/persisters/encryptedIndexedDbPersister.js.map +1 -1
  328. package/dist/persisters/types.d.ts +6 -0
  329. package/dist/persisters/types.d.ts.map +1 -1
  330. package/dist/query/queryWindows.js +2 -2
  331. package/dist/query/queryWindows.js.map +1 -1
  332. package/dist/react/apiHooks.d.ts +87 -0
  333. package/dist/react/apiHooks.d.ts.map +1 -0
  334. package/dist/react/apiHooks.js +195 -0
  335. package/dist/react/apiHooks.js.map +1 -0
  336. package/dist/react/apiHooks.test.d.ts +2 -0
  337. package/dist/react/apiHooks.test.d.ts.map +1 -0
  338. package/dist/react/apiHooks.test.js +366 -0
  339. package/dist/react/apiHooks.test.js.map +1 -0
  340. package/dist/react/index.d.ts +2 -0
  341. package/dist/react/index.d.ts.map +1 -1
  342. package/dist/react/index.js +2 -0
  343. package/dist/react/index.js.map +1 -1
  344. package/dist/react/provider.d.ts +2 -0
  345. package/dist/react/provider.d.ts.map +1 -1
  346. package/dist/react/provider.js +2 -0
  347. package/dist/react/provider.js.map +1 -1
  348. package/dist/react/useSocketEvent.d.ts +27 -0
  349. package/dist/react/useSocketEvent.d.ts.map +1 -0
  350. package/dist/react/useSocketEvent.js +36 -0
  351. package/dist/react/useSocketEvent.js.map +1 -0
  352. package/dist/react/useSocketEvent.test.d.ts +2 -0
  353. package/dist/react/useSocketEvent.test.d.ts.map +1 -0
  354. package/dist/react/useSocketEvent.test.js +76 -0
  355. package/dist/react/useSocketEvent.test.js.map +1 -0
  356. package/dist/sync/replayCoordinator.js +1 -1
  357. package/dist/sync/replayCoordinator.js.map +1 -1
  358. package/dist/sync/socketTransport.d.ts.map +1 -1
  359. package/dist/sync/socketTransport.js +14 -1
  360. package/dist/sync/socketTransport.js.map +1 -1
  361. package/dist/sync/socketTransport.test.js +42 -0
  362. package/dist/sync/socketTransport.test.js.map +1 -1
  363. package/dist/sync/transport.d.ts +9 -0
  364. package/dist/sync/transport.d.ts.map +1 -1
  365. package/dist/sync/transport.js +13 -0
  366. package/dist/sync/transport.js.map +1 -1
  367. package/dist/testing/fakeTransport.d.ts +5 -1
  368. package/dist/testing/fakeTransport.d.ts.map +1 -1
  369. package/dist/testing/fakeTransport.js +26 -0
  370. package/dist/testing/fakeTransport.js.map +1 -1
  371. package/dist/testing/fakeTransport.test.js +15 -0
  372. package/dist/testing/fakeTransport.test.js.map +1 -1
  373. package/package.json +93 -8
  374. package/src/api/apiError.ts +47 -0
  375. package/src/api/apiFetch.ts +245 -0
  376. package/src/api/client.test.ts +711 -0
  377. package/src/api/client.ts +367 -0
  378. package/src/app/app.ts +30 -0
  379. package/src/app/devConsoleLogger.test.ts +246 -0
  380. package/src/app/devConsoleLogger.ts +173 -0
  381. package/src/app/mcpTools.ts +101 -0
  382. package/src/app/permissions.test.ts +44 -0
  383. package/src/app/permissions.ts +58 -0
  384. package/src/app/upgradeCheck.ts +177 -0
  385. package/src/auth/SessionProvider.test.tsx +286 -0
  386. package/src/auth/SessionProvider.tsx +87 -0
  387. package/src/auth/TerrenoAccountSecurityScreen.tsx +56 -0
  388. package/src/auth/TerrenoLoginScreen.tsx +131 -0
  389. package/src/auth/auth.ts +117 -0
  390. package/src/auth/betterAuthAdapter.ts +1 -1
  391. package/src/auth/betterAuthClient.ts +997 -0
  392. package/src/auth/betterAuthClient.types.test.ts +197 -0
  393. package/src/auth/betterAuthClientRegistry.test.ts +114 -0
  394. package/src/auth/betterAuthClientRegistry.ts +99 -0
  395. package/src/auth/betterAuthTypes.ts +189 -0
  396. package/src/auth/jwtAuthAdapter.test.ts +754 -0
  397. package/src/auth/jwtAuthAdapter.ts +420 -0
  398. package/src/auth/loginErrors.test.ts +97 -0
  399. package/src/auth/loginErrors.ts +249 -0
  400. package/src/auth/ownEntry.test.ts +22 -0
  401. package/src/auth/ownEntry.ts +15 -0
  402. package/src/auth/platform.ts +4 -0
  403. package/src/auth/rememberedAccounts.test.ts +844 -0
  404. package/src/auth/rememberedAccounts.ts +568 -0
  405. package/src/auth/session.test.ts +976 -0
  406. package/src/auth/session.ts +509 -0
  407. package/src/auth/tokenExpiry.ts +185 -0
  408. package/src/auth/types.ts +1 -1
  409. package/src/auth/useAccountSecurity.ts +678 -0
  410. package/src/auth/useAccountSecurity.types.test.ts +28 -0
  411. package/src/auth/useAuthMethods.test.ts +181 -0
  412. package/src/auth/useAuthMethods.ts +137 -0
  413. package/src/auth/useJwtAuth.test.tsx +202 -0
  414. package/src/auth/useJwtAuth.ts +102 -0
  415. package/src/auth/useLoginController.ts +1038 -0
  416. package/src/auth/useLoginController.types.test.ts +26 -0
  417. package/src/buildNumber.test.ts +139 -0
  418. package/src/buildNumber.ts +75 -0
  419. package/src/client.socketEvents.test.ts +77 -0
  420. package/src/client.test.ts +73 -1
  421. package/src/client.ts +87 -18
  422. package/src/codegen/cli.test.ts +66 -0
  423. package/src/codegen/cli.ts +23 -12
  424. package/src/codegen/discoverCollections.ts +4 -0
  425. package/src/codegen/discoverOperations.ts +172 -0
  426. package/src/codegen/emitApi.test.tsx +445 -0
  427. package/src/codegen/emitApi.ts +396 -0
  428. package/src/codegen/emitSdk.ts +2 -2
  429. package/src/codegen/fixtures/openapi.api.json +840 -0
  430. package/src/codegen/generate.test.ts +54 -1
  431. package/src/codegen/generate.ts +20 -1
  432. package/src/codegen/hookNames.ts +35 -0
  433. package/src/codegen/safeIdentifiers.test.ts +20 -0
  434. package/src/codegen/safeIdentifiers.ts +7 -2
  435. package/src/codegen/types.ts +45 -1
  436. package/src/config/baseUrl.test.ts +53 -0
  437. package/src/config/baseUrl.ts +68 -0
  438. package/src/config/resolveBaseUrls.test.ts +308 -0
  439. package/src/config/resolveBaseUrls.ts +118 -0
  440. package/src/crypto/keyProviders.test.ts +23 -0
  441. package/src/crypto/keyProviders.ts +15 -4
  442. package/src/crypto/types.ts +5 -0
  443. package/src/flags/flagTestServer.ts +77 -0
  444. package/src/flags/useFeatureFlags.test.tsx +146 -0
  445. package/src/flags/useFeatureFlags.ts +130 -0
  446. package/src/flags/useTerrenoFeatureFlags.test.tsx +329 -0
  447. package/src/flags/useTerrenoFeatureFlags.ts +188 -0
  448. package/src/index.ts +2 -1
  449. package/src/isolated/TerrenoAccountSecurityScreen.isolated.tsx +123 -0
  450. package/src/isolated/TerrenoLoginScreen.isolated.tsx +256 -0
  451. package/src/isolated/betterAuthClient.isolated.ts +2198 -0
  452. package/src/isolated/betterAuthClient.native.isolated.ts +173 -0
  453. package/src/isolated/mcpTools.isolated.ts +259 -0
  454. package/src/isolated/rememberedAccounts.native.isolated.ts +63 -0
  455. package/src/isolated/sessionLogout.isolated.ts +152 -0
  456. package/src/isolated/tokenExpiry.isolated.ts +271 -0
  457. package/src/isolated/upgradeCheck.isolated.tsx +321 -0
  458. package/src/isolated/useAccountSecurity.isolated.ts +1089 -0
  459. package/src/isolated/useAccountSecurity.native.isolated.ts +61 -0
  460. package/src/isolated/useLoginController.isolated.ts +1384 -0
  461. package/src/persisters/defaultPersisterFactory.native.ts +7 -1
  462. package/src/persisters/encryptedIndexedDbPersister.ts +3 -0
  463. package/src/persisters/types.ts +6 -0
  464. package/src/query/queryWindows.ts +2 -2
  465. package/src/react/apiHooks.test.tsx +473 -0
  466. package/src/react/apiHooks.tsx +336 -0
  467. package/src/react/index.ts +2 -0
  468. package/src/react/provider.tsx +3 -0
  469. package/src/react/useSocketEvent.test.tsx +96 -0
  470. package/src/react/useSocketEvent.ts +59 -0
  471. package/src/sync/replayCoordinator.ts +1 -1
  472. package/src/sync/socketTransport.test.ts +49 -0
  473. package/src/sync/socketTransport.ts +15 -0
  474. package/src/sync/transport.ts +25 -0
  475. package/src/testing/fakeTransport.test.ts +18 -0
  476. package/src/testing/fakeTransport.ts +36 -5
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Type-level tests: the clients createBetterAuthClient returns satisfy LoginControllerClient, so
3
+ * apps pass their client to useLoginController and TerrenoLoginScreen without a cast.
4
+ * `bun run compile` checks this file through tsconfig.typetests.json.
5
+ */
6
+ import {describe, expect, it} from "bun:test";
7
+
8
+ import type {BetterAuthClient, BetterAuthClientWithFeatures} from "./betterAuthClient";
9
+ import type {LoginControllerClient, LoginControllerClientInput} from "./useLoginController";
10
+
11
+ // Each helper is only type-checked; none of them runs.
12
+ const typeChecks = {
13
+ allFeatures: (
14
+ client: BetterAuthClientWithFeatures<{multiSession: true; passkey: true; twoFactor: true}>
15
+ ): LoginControllerClient => client,
16
+ // A client without features is typed loosely, so the option's input type lists it on its own.
17
+ noFeatures: (client: BetterAuthClient): LoginControllerClientInput => client,
18
+ someFeatures: (client: BetterAuthClientWithFeatures<{twoFactor: true}>): LoginControllerClient =>
19
+ client,
20
+ };
21
+
22
+ describe("LoginControllerClient types", () => {
23
+ it("accepts every client createBetterAuthClient returns", () => {
24
+ expect(Object.keys(typeChecks)).toEqual(["allFeatures", "noFeatures", "someFeatures"]);
25
+ });
26
+ });
@@ -0,0 +1,139 @@
1
+ import {afterAll, beforeEach, describe, expect, it} from "bun:test";
2
+ import * as fs from "node:fs";
3
+ import * as os from "node:os";
4
+ import * as path from "node:path";
5
+
6
+ import {coerceBuildNumber, resolveBuildNumber} from "./buildNumber";
7
+
8
+ describe("coerceBuildNumber", () => {
9
+ it("returns undefined for undefined", () => {
10
+ expect(coerceBuildNumber(undefined)).toBeUndefined();
11
+ });
12
+
13
+ it("returns undefined for null", () => {
14
+ expect(coerceBuildNumber(null)).toBeUndefined();
15
+ });
16
+
17
+ it("returns the number for a valid positive integer", () => {
18
+ expect(coerceBuildNumber(42)).toBe(42);
19
+ });
20
+
21
+ it("returns the number for zero", () => {
22
+ expect(coerceBuildNumber(0)).toBe(0);
23
+ });
24
+
25
+ it("returns undefined for NaN", () => {
26
+ expect(coerceBuildNumber(Number.NaN)).toBeUndefined();
27
+ });
28
+
29
+ it("returns undefined for Infinity", () => {
30
+ expect(coerceBuildNumber(Number.POSITIVE_INFINITY)).toBeUndefined();
31
+ });
32
+
33
+ it("parses a valid numeric string", () => {
34
+ expect(coerceBuildNumber("123")).toBe(123);
35
+ });
36
+
37
+ it("returns undefined for a non-numeric string", () => {
38
+ expect(coerceBuildNumber("abc")).toBeUndefined();
39
+ });
40
+
41
+ it("returns the number for a negative integer", () => {
42
+ expect(coerceBuildNumber(-5)).toBe(-5);
43
+ });
44
+
45
+ it("parses a string with leading zeros", () => {
46
+ expect(coerceBuildNumber("007")).toBe(7);
47
+ });
48
+ });
49
+
50
+ describe("resolveBuildNumber", () => {
51
+ const ORIGINAL_ENV = process.env;
52
+
53
+ beforeEach(() => {
54
+ process.env = {...ORIGINAL_ENV};
55
+ delete process.env.EXPO_PUBLIC_BUILD_NUMBER;
56
+ });
57
+
58
+ afterAll(() => {
59
+ process.env = ORIGINAL_ENV;
60
+ });
61
+
62
+ it("returns override when provided", () => {
63
+ expect(resolveBuildNumber({override: 99})).toBe(99);
64
+ });
65
+
66
+ it("returns configValue when override is not provided", () => {
67
+ expect(resolveBuildNumber({configValue: 50})).toBe(50);
68
+ });
69
+
70
+ it("returns env var when override and configValue are not provided", () => {
71
+ process.env.EXPO_PUBLIC_BUILD_NUMBER = "200";
72
+ expect(resolveBuildNumber()).toBe(200);
73
+ });
74
+
75
+ it("uses custom envVar name", () => {
76
+ process.env.CUSTOM_BUILD = "77";
77
+ expect(resolveBuildNumber({envVar: "CUSTOM_BUILD"})).toBe(77);
78
+ });
79
+
80
+ it("prefers override over configValue", () => {
81
+ expect(resolveBuildNumber({configValue: 10, override: 20})).toBe(20);
82
+ });
83
+
84
+ it("prefers configValue over env var", () => {
85
+ process.env.EXPO_PUBLIC_BUILD_NUMBER = "300";
86
+ expect(resolveBuildNumber({configValue: 15})).toBe(15);
87
+ });
88
+
89
+ it("falls back to git rev-list count when nothing else is set", () => {
90
+ const result = resolveBuildNumber();
91
+ // In a git repo, this should return a positive integer
92
+ expect(typeof result).toBe("number");
93
+ expect(result).toBeGreaterThan(0);
94
+ });
95
+
96
+ it("skips invalid env var values and falls through to git", () => {
97
+ process.env.EXPO_PUBLIC_BUILD_NUMBER = "not-a-number";
98
+ // Should fall through past the env var to git
99
+ const result = resolveBuildNumber();
100
+ expect(typeof result).toBe("number");
101
+ expect(result).toBeGreaterThan(0);
102
+ });
103
+
104
+ it("skips undefined override and uses configValue", () => {
105
+ expect(resolveBuildNumber({configValue: 42, override: undefined})).toBe(42);
106
+ });
107
+
108
+ it("skips invalid configValue and uses env var", () => {
109
+ process.env.EXPO_PUBLIC_BUILD_NUMBER = "88";
110
+ expect(resolveBuildNumber({configValue: "bad"})).toBe(88);
111
+ });
112
+
113
+ it("returns a number with default options", () => {
114
+ const result = resolveBuildNumber();
115
+ expect(result).toBeDefined();
116
+ expect(typeof result).toBe("number");
117
+ });
118
+
119
+ it("prefers override over env var", () => {
120
+ process.env.EXPO_PUBLIC_BUILD_NUMBER = "999";
121
+ expect(resolveBuildNumber({override: 1})).toBe(1);
122
+ });
123
+
124
+ it("returns undefined when git rev-list fails (no git, detached HEAD, etc.)", () => {
125
+ // Use a freshly-created mkdtemp directory that we know is not inside any git
126
+ // worktree (parents won't be a repo because we create it under the OS temp dir
127
+ // and no parent has a `.git` folder). This makes `git rev-list --count HEAD`
128
+ // exit non-zero so execSync throws, exercising the catch branch.
129
+ const originalCwd = process.cwd();
130
+ const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "syncdb-buildnumber-no-git-"));
131
+ process.chdir(tmpDir);
132
+ try {
133
+ expect(resolveBuildNumber()).toBeUndefined();
134
+ } finally {
135
+ process.chdir(originalCwd);
136
+ fs.rmSync(tmpDir, {force: true, recursive: true});
137
+ }
138
+ });
139
+ });
@@ -0,0 +1,75 @@
1
+ /// <reference types="node" />
2
+ /**
3
+ * `@terreno/syncdb/buildNumber` — node-only helpers for `app.config.ts` that
4
+ * stamp `extra.buildNumber`, which `useUpgradeCheck` sends to `/version-check`.
5
+ * Never import this from app runtime code: it shells out to git.
6
+ */
7
+ import {execSync} from "node:child_process";
8
+
9
+ /**
10
+ * Coerce a value to a valid build number (finite positive integer), or undefined.
11
+ * Useful for validating build numbers from environment variables, config overrides, etc.
12
+ */
13
+ export const coerceBuildNumber = (value: unknown): number | undefined => {
14
+ if (value === undefined || value === null) {
15
+ return undefined;
16
+ }
17
+ const n = typeof value === "number" ? value : parseInt(String(value), 10);
18
+ return Number.isFinite(n) ? n : undefined;
19
+ };
20
+
21
+ interface ResolveBuildNumberOptions {
22
+ /** Hard-coded override — set to a number to test version-check behavior locally. */
23
+ override?: number;
24
+ /** Existing build number from Expo config (`config.extra?.buildNumber`). */
25
+ configValue?: unknown;
26
+ /** Environment variable name to read (default: `"EXPO_PUBLIC_BUILD_NUMBER"`). */
27
+ envVar?: string;
28
+ }
29
+
30
+ /**
31
+ * Resolve a build number using the standard Terreno priority chain:
32
+ * 1. `override` (for local testing)
33
+ * 2. `configValue` (from existing Expo config / EAS Build)
34
+ * 3. `EXPO_PUBLIC_BUILD_NUMBER` env var (or custom `envVar`)
35
+ * 4. `git rev-list --count HEAD`
36
+ * 5. `undefined` (version check will be skipped)
37
+ *
38
+ * Import this in your `app.config.ts` to avoid duplicating the resolution logic:
39
+ * ```ts
40
+ * import {resolveBuildNumber} from "@terreno/syncdb/buildNumber";
41
+ *
42
+ * export default ({config}) => ({
43
+ * ...config,
44
+ * extra: {...config.extra, buildNumber: resolveBuildNumber({configValue: config.extra?.buildNumber})},
45
+ * });
46
+ * ```
47
+ */
48
+ export const resolveBuildNumber = (options: ResolveBuildNumberOptions = {}): number | undefined => {
49
+ const {override, configValue, envVar = "EXPO_PUBLIC_BUILD_NUMBER"} = options;
50
+
51
+ const fromOverride = coerceBuildNumber(override);
52
+ if (fromOverride !== undefined) {
53
+ return fromOverride;
54
+ }
55
+
56
+ const fromConfig = coerceBuildNumber(configValue);
57
+ if (fromConfig !== undefined) {
58
+ return fromConfig;
59
+ }
60
+
61
+ const envValue = process.env[envVar];
62
+ if (envValue) {
63
+ const fromEnv = coerceBuildNumber(envValue);
64
+ if (fromEnv !== undefined) {
65
+ return fromEnv;
66
+ }
67
+ }
68
+
69
+ try {
70
+ return parseInt(execSync("git rev-list --count HEAD").toString().trim(), 10);
71
+ } catch {
72
+ // Leave undefined so the version check is skipped in environments without git
73
+ return undefined;
74
+ }
75
+ };
@@ -0,0 +1,77 @@
1
+ import "fake-indexeddb/auto";
2
+ import {describe, expect, it} from "bun:test";
3
+
4
+ import {createSyncDb, type SyncDb} from "./client";
5
+ import {memoryPersisterFactory} from "./persisters/memoryPersister";
6
+ import type {SyncTransport} from "./sync/transport";
7
+ import {createFakeTransport, type FakeTransport} from "./testing/fakeTransport";
8
+ import type {AuthProvider} from "./types";
9
+
10
+ let nameCounter = 0;
11
+
12
+ const authProvider: AuthProvider = {
13
+ getToken: async () => "token",
14
+ getUserId: async () => "u1",
15
+ onAuthChange: () => () => {},
16
+ };
17
+
18
+ const makeClient = (transport: SyncTransport): SyncDb => {
19
+ nameCounter += 1;
20
+ return createSyncDb({
21
+ authProvider,
22
+ collections: ["todos"],
23
+ name: `socket-events-${nameCounter}`,
24
+ persisterFactory: memoryPersisterFactory,
25
+ reconcileIntervalMs: 0,
26
+ transport,
27
+ });
28
+ };
29
+
30
+ describe("SyncDb.onSocketEvent", () => {
31
+ it("forwards server events from the sync transport until unsubscribed", () => {
32
+ const transport: FakeTransport = createFakeTransport();
33
+ const client = makeClient(transport);
34
+ const received: unknown[][] = [];
35
+
36
+ const unsubscribe = client.onSocketEvent("featureFlagsChanged", (...args) => {
37
+ received.push(args);
38
+ });
39
+ transport.emitEvent("featureFlagsChanged", {key: "beta"});
40
+ transport.emitEvent("somethingElse", {ignored: true});
41
+ expect(received).toEqual([[{key: "beta"}]]);
42
+
43
+ unsubscribe();
44
+ transport.emitEvent("featureFlagsChanged", {key: "later"});
45
+ expect(received).toHaveLength(1);
46
+ expect(transport.eventListenerCount("featureFlagsChanged")).toBe(0);
47
+ });
48
+
49
+ it("keeps listeners bound across stop() and start()", async () => {
50
+ const transport = createFakeTransport();
51
+ const client = makeClient(transport);
52
+ let calls = 0;
53
+ client.onSocketEvent("featureFlagsChanged", () => {
54
+ calls += 1;
55
+ });
56
+
57
+ await client.start();
58
+ await client.stop();
59
+ await client.start();
60
+ transport.emitEvent("featureFlagsChanged");
61
+ await client.stop();
62
+
63
+ expect(calls).toBe(1);
64
+ });
65
+
66
+ it("throws for names the sync protocol reserves", () => {
67
+ const client = makeClient(createFakeTransport());
68
+ expect(() => client.onSocketEvent("sync:delta", () => {})).toThrow("reserved");
69
+ });
70
+
71
+ it("returns a no-op unsubscribe when the transport has no event support", () => {
72
+ const {onEvent: _onEvent, ...withoutEvents} = createFakeTransport();
73
+ const client = makeClient(withoutEvents);
74
+ const unsubscribe = client.onSocketEvent("featureFlagsChanged", () => {});
75
+ expect(() => unsubscribe()).not.toThrow();
76
+ });
77
+ });
@@ -8,7 +8,11 @@ import {Server} from "socket.io";
8
8
 
9
9
  import {betterAuthAdapter} from "./auth/betterAuthAdapter";
10
10
  import {createSyncDb, type SyncDbConfig} from "./client";
11
- import {createLocalKeyProvider, DEFAULT_KEY_CACHE_DB_NAME} from "./crypto/keyProviders";
11
+ import {
12
+ createLocalKeyProvider,
13
+ createServerKeyProvider,
14
+ DEFAULT_KEY_CACHE_DB_NAME,
15
+ } from "./crypto/keyProviders";
12
16
  import {getConflict} from "./mutations/conflicts";
13
17
  import {createDefaultPersisterFactory as createWebPersisterFactory} from "./persisters/defaultPersisterFactory.web";
14
18
  import {memoryPersisterFactory} from "./persisters/memoryPersister";
@@ -2957,6 +2961,74 @@ describe("createSyncDb", () => {
2957
2961
  });
2958
2962
  });
2959
2963
 
2964
+ describe("logout while start() is running", () => {
2965
+ const keyMaterial = Buffer.from(crypto.getRandomValues(new Uint8Array(32))).toString("base64");
2966
+
2967
+ it("persists without a post-logout /sync/key fetch and never connects after stop()", async () => {
2968
+ const session = {active: true};
2969
+ const keyFetches: Array<"ok" | "401"> = [];
2970
+ const keyProvider = createServerKeyProvider({
2971
+ appName: "logout-race",
2972
+ cacheDbName: uniqueName(),
2973
+ fetchKeyMaterial: async (): Promise<string> => {
2974
+ if (!session.active) {
2975
+ keyFetches.push("401");
2976
+ throw new Error("401 from /sync/key");
2977
+ }
2978
+ keyFetches.push("ok");
2979
+ return keyMaterial;
2980
+ },
2981
+ });
2982
+ const webFactory = createWebPersisterFactory({keyProvider, saveDebounceMs: 20});
2983
+ const harness = makeHarness();
2984
+ const observable = makeObservableTransport(harness.transport);
2985
+ let stopPromise: Promise<void> | undefined;
2986
+ // The user logs out while start() is still opening persistence: the session
2987
+ // ends, and the host app's logout effect calls stop().
2988
+ const persisterFactory: PersisterFactory = (args) => {
2989
+ const persister = webFactory(args);
2990
+ return {
2991
+ ...persister,
2992
+ startAutoSave: async (): Promise<typeof persister> => {
2993
+ if (!stopPromise) {
2994
+ session.active = false;
2995
+ harness.auth.setUserId(null);
2996
+ stopPromise = client.stop();
2997
+ }
2998
+ return persister.startAutoSave();
2999
+ },
3000
+ };
3001
+ };
3002
+ const client = createSyncDb({
3003
+ ...harness.config,
3004
+ persisterFactory,
3005
+ transport: observable.transport,
3006
+ });
3007
+
3008
+ await client.start();
3009
+ await stopPromise;
3010
+
3011
+ expect(keyFetches).toEqual(["ok"]);
3012
+ expect(client.getSyncStatus().persistence).toBe("durable");
3013
+ expect(observable.events).not.toContain("connect");
3014
+ });
3015
+
3016
+ it("stop() called before a queued start() runs cancels that start()", async () => {
3017
+ const harness = makeHarness();
3018
+ const observable = makeObservableTransport(harness.transport);
3019
+ const client = createSyncDb({...harness.config, transport: observable.transport});
3020
+
3021
+ const startPromise = client.start();
3022
+ const stopPromise = client.stop();
3023
+ await Promise.all([startPromise, stopPromise]);
3024
+
3025
+ expect(observable.events).not.toContain("connect");
3026
+ expect((): unknown =>
3027
+ client.mutate({collection: "todos", data: {title: "x"}, operation: "create"})
3028
+ ).toThrow("requires start()");
3029
+ });
3030
+ });
3031
+
2960
3032
  describe("schema versioning (E2)", () => {
2961
3033
  it("wipes and re-bootstraps when the persisted schemaVersion is stale", async () => {
2962
3034
  const name = uniqueName();
package/src/client.ts CHANGED
@@ -28,7 +28,12 @@ import {
28
28
  } from "./sync/httpChannel";
29
29
  import {createReplayCoordinator, type ReplayCoordinator} from "./sync/replayCoordinator";
30
30
  import {createSocketTransport} from "./sync/socketTransport";
31
- import type {SendMutationBatchResult, SendMutationResult, SyncTransport} from "./sync/transport";
31
+ import type {
32
+ SendMutationBatchResult,
33
+ SendMutationResult,
34
+ SocketEventHandler,
35
+ SyncTransport,
36
+ } from "./sync/transport";
32
37
  import {type HydrateWindowEntitiesResult, hydrateWindowEntities} from "./sync/windowHydrate";
33
38
  import type {
34
39
  AuthProvider,
@@ -339,6 +344,15 @@ export interface SyncDb {
339
344
  * Returns an unsubscribe function.
340
345
  */
341
346
  onStatusChange: (callback: () => void) => () => void;
347
+ /**
348
+ * Listen for an app-level server event on the sync socket (for example the
349
+ * feature-flags `featureFlagsChanged` push). One socket serves sync and app
350
+ * events. Listeners survive stop/start and reconnects; they fire only while the
351
+ * socket is connected. Names starting with `sync:` and Socket.io lifecycle
352
+ * events are reserved and throw. Returns an unsubscribe function; a transport
353
+ * without event support returns a no-op.
354
+ */
355
+ onSocketEvent: (event: string, handler: SocketEventHandler) => () => void;
342
356
  /**
343
357
  * In-memory debug event log when `config.debug` is enabled; otherwise
344
358
  * undefined. Its `snapshot()` is a plain serializable object suitable for
@@ -508,6 +522,12 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
508
522
  let unbindDeltaHandler: (() => void) | undefined;
509
523
  /** True once a start() has completed without a matching stop() (E1 double-start guard). */
510
524
  let isStarted = false;
525
+ // Bumped synchronously by every stop()/signOut() CALL, before it queues on the
526
+ // lifecycle mutex. `generation` only changes once the stop runs, which is after
527
+ // any start() ahead of it in the queue has finished, so this is how a start()
528
+ // already running (or still queued) learns the host app logged out and stops
529
+ // before opening persistence or connecting the transport without a session.
530
+ let stopRequests = 0;
511
531
 
512
532
  /**
513
533
  * Queue `op` onto the lifecycle mutex; resolves/rejects with `op`'s own
@@ -1470,7 +1490,10 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
1470
1490
  */
1471
1491
  let persistenceMode: "durable" | "memory" | "error" = "durable";
1472
1492
 
1473
- const createAndStartPersister = async (userId: string): Promise<void> => {
1493
+ const createAndStartPersister = async (
1494
+ userId: string,
1495
+ {isSuperseded}: {isSuperseded?: () => boolean} = {}
1496
+ ): Promise<void> => {
1474
1497
  // Reset per-call: a fresh persister/load attempt starts optimistic even
1475
1498
  // if a PRIOR persister instance (e.g. before a wipe-and-rebuild) had
1476
1499
  // flagged a load failure.
@@ -1534,11 +1557,26 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
1534
1557
  // app supplying its own storage backend can still opt into E3 SyncStatus
1535
1558
  // surfacing; the default factory already received the same callbacks
1536
1559
  // above (at creation time) and ignores this second copy.
1537
- persister = factory({
1560
+ const created = factory({
1538
1561
  databaseName: config.name,
1539
1562
  hooks: {onDecryptFailure, onLoadFailure, onSaveFailure},
1540
1563
  store: store.raw,
1541
1564
  });
1565
+ persister = created;
1566
+ // Resolve the encryption key now, while the session that start() resolved is
1567
+ // still valid. Otherwise the first fetch happens on the first (debounced) save,
1568
+ // and a logout in that window leaves every save, including stop()'s flush of
1569
+ // pending outbox writes, failing with a 401 from /sync/key. A failure here
1570
+ // (offline cold start) is not fatal: saves retry the key and report through
1571
+ // onSaveFailure.
1572
+ await created.prepare?.().catch((): void => {});
1573
+ if (isSuperseded?.()) {
1574
+ // A stop() arrived while the key was resolving. Nothing has loaded into this
1575
+ // persister, so drop it without saving rather than let stop() flush it.
1576
+ persister = undefined;
1577
+ await created.destroy();
1578
+ return;
1579
+ }
1542
1580
  await persister.startAutoLoad();
1543
1581
  // Read through a function call: `onLoadFailure` (invoked synchronously
1544
1582
  // from inside `startAutoLoad()`, not after it returns) mutates
@@ -1898,9 +1936,16 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
1898
1936
  * `await` — belt-and-suspenders against any future call site that manages
1899
1937
  * to bypass the mutex (e.g. a direct call from a test), and cheap enough to
1900
1938
  * always do.
1939
+ *
1940
+ * A stop()/signOut() call also cancels a start() that is running or queued
1941
+ * ahead of it (see `stopRequests`): the start() returns at its next check, so
1942
+ * a logout mid-start never opens persistence or connects the transport after
1943
+ * the session is gone. Pending local writes still reach storage through
1944
+ * stop()'s flush, which uses the key start() resolved up front.
1901
1945
  */
1902
- const start = async (): Promise<void> =>
1903
- withLifecycle(async (): Promise<void> => {
1946
+ const start = async (): Promise<void> => {
1947
+ const stopRequestsAtCall = stopRequests;
1948
+ return withLifecycle(async (): Promise<void> => {
1904
1949
  if (isStarted) {
1905
1950
  // E1: double-start() is a no-op rather than a second full
1906
1951
  // initialization — calling start() again would double-register the
@@ -1908,8 +1953,17 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
1908
1953
  // A caller that wants a hard restart should stop() first.
1909
1954
  return;
1910
1955
  }
1956
+ if (stopRequests !== stopRequestsAtCall) {
1957
+ // A stop() was called after this start() but before it ran: the host app
1958
+ // already logged out, so there is nothing to start.
1959
+ return;
1960
+ }
1911
1961
  generation += 1;
1912
1962
  const myGeneration = generation;
1963
+ // Superseded by a later lifecycle op, or cancelled by a stop()/signOut() call
1964
+ // that is still queued behind this start().
1965
+ const isCancelled = (): boolean =>
1966
+ generation !== myGeneration || stopRequests !== stopRequestsAtCall;
1913
1967
  const authRetryAttempts = Math.max(
1914
1968
  1,
1915
1969
  config.startAuthRetryAttempts ?? DEFAULT_START_AUTH_RETRY_ATTEMPTS
@@ -1922,31 +1976,33 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
1922
1976
  break;
1923
1977
  }
1924
1978
  await sleep(authRetryDelayMs);
1925
- if (generation !== myGeneration) {
1979
+ if (isCancelled()) {
1926
1980
  // A stop() (or another start()) ran while we were retrying auth
1927
1981
  // resolution — abandon this attempt, see the generation check below.
1928
1982
  return;
1929
1983
  }
1930
1984
  }
1931
- if (!userId) {
1932
- throw new Error("createSyncDb.start() requires an authenticated user");
1933
- }
1934
- if (generation !== myGeneration) {
1985
+ if (isCancelled()) {
1935
1986
  // A stop() (or another start()) ran while awaiting the auth
1936
1987
  // provider — that operation now owns the lifecycle; abandon this one
1937
1988
  // rather than initializing state a newer generation doesn't expect.
1989
+ // Checked before the no-user error: a logout that cancels this start()
1990
+ // is expected, not a failure.
1938
1991
  return;
1939
1992
  }
1993
+ if (!userId) {
1994
+ throw new Error("createSyncDb.start() requires an authenticated user");
1995
+ }
1940
1996
  simulatedOffline = false;
1941
1997
  setAuthPaused(false);
1942
1998
  // Re-open the cross-window debug bridge a previous stop()/signOut() closed.
1943
1999
  attachDebugBridge();
1944
- await createAndStartPersister(userId);
1945
- if (generation !== myGeneration) {
2000
+ await createAndStartPersister(userId, {isSuperseded: isCancelled});
2001
+ if (isCancelled()) {
1946
2002
  return;
1947
2003
  }
1948
2004
  const {userChanged} = await runUserCheck(userId);
1949
- if (generation !== myGeneration) {
2005
+ if (isCancelled()) {
1950
2006
  return;
1951
2007
  }
1952
2008
  if (userChanged) {
@@ -2004,7 +2060,7 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2004
2060
  // up syncing when connectivity returns.
2005
2061
  warn("transport connect failed; starting offline")(error);
2006
2062
  }
2007
- if (generation !== myGeneration) {
2063
+ if (isCancelled()) {
2008
2064
  return;
2009
2065
  }
2010
2066
  subscribeConfiguredCollections();
@@ -2018,9 +2074,11 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2018
2074
  isStarted = true;
2019
2075
  void replayOutbox().catch(warn("startup replay failed"));
2020
2076
  });
2077
+ };
2021
2078
 
2022
- const stop = async (): Promise<void> =>
2023
- withLifecycle(async (): Promise<void> => {
2079
+ const stop = async (): Promise<void> => {
2080
+ stopRequests += 1;
2081
+ return withLifecycle(async (): Promise<void> => {
2024
2082
  generation += 1;
2025
2083
  isStarted = false;
2026
2084
  closeDebugBridge();
@@ -2051,6 +2109,7 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2051
2109
  await persisterToStop.destroy();
2052
2110
  }
2053
2111
  });
2112
+ };
2054
2113
 
2055
2114
  const goOffline = (): void => {
2056
2115
  if (simulatedOffline) {
@@ -2330,8 +2389,9 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2330
2389
  * reconcile/replay from the signed-out session sees itself superseded and
2331
2390
  * stands down instead of writing into a store that no longer has an owner.
2332
2391
  */
2333
- const signOut = async (): Promise<void> =>
2334
- withLifecycle(async (): Promise<void> => {
2392
+ const signOut = async (): Promise<void> => {
2393
+ stopRequests += 1;
2394
+ return withLifecycle(async (): Promise<void> => {
2335
2395
  generation += 1;
2336
2396
  isStarted = false;
2337
2397
  closeDebugBridge();
@@ -2376,6 +2436,14 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2376
2436
  await persisterToStop.destroy();
2377
2437
  }
2378
2438
  });
2439
+ };
2440
+
2441
+ const onSocketEvent = (event: string, handler: SocketEventHandler): (() => void) => {
2442
+ if (!transport.onEvent) {
2443
+ return () => {};
2444
+ }
2445
+ return transport.onEvent(event, handler);
2446
+ };
2379
2447
 
2380
2448
  const client: SyncDb = {
2381
2449
  debug: debugLog,
@@ -2385,6 +2453,7 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2385
2453
  goOnline,
2386
2454
  hydrateWindow,
2387
2455
  mutate,
2456
+ onSocketEvent,
2388
2457
  onStatusChange,
2389
2458
  outbox,
2390
2459
  queryWindows,