@terreno/syncdb 57.20.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 +93 -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 +96 -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,336 @@
1
+ /**
2
+ * React bindings for the `@terreno/syncdb/api` request client. Call shapes follow
3
+ * RTK Query (`{data, isLoading, refetch}`, `[trigger, state]`, `.unwrap()`) so
4
+ * generated hooks and migrated screens read the same way.
5
+ */
6
+ import type React from "react";
7
+ import {
8
+ createContext,
9
+ useCallback,
10
+ useContext,
11
+ useEffect,
12
+ useMemo,
13
+ useRef,
14
+ useState,
15
+ useSyncExternalStore,
16
+ } from "react";
17
+
18
+ import {type ApiClient, type ApiQueryState, type ApiRequestArgs, apiQueryKey} from "../api/client";
19
+
20
+ const ApiClientContext = createContext<ApiClient | null>(null);
21
+
22
+ export interface ApiClientProviderProps {
23
+ client: ApiClient;
24
+ children?: React.ReactNode;
25
+ }
26
+
27
+ /** Makes an {@link ApiClient} available to `useApiQuery` / `useApiMutation`. */
28
+ export const ApiClientProvider: React.FC<ApiClientProviderProps> = ({client, children}) => (
29
+ <ApiClientContext.Provider value={client}>{children}</ApiClientContext.Provider>
30
+ );
31
+
32
+ /** The client from the nearest `ApiClientProvider`, or `override` when given. */
33
+ export const useApiClient = (override?: ApiClient): ApiClient => {
34
+ const fromContext = useContext(ApiClientContext);
35
+ const client = override ?? fromContext;
36
+ if (!client) {
37
+ throw new Error(
38
+ "useApiClient: wrap the tree in <ApiClientProvider client={...}> or pass `client`."
39
+ );
40
+ }
41
+ return client;
42
+ };
43
+
44
+ /** Result promise for triggers: resolves `{data}` / `{error}`; `unwrap()` rejects on error. */
45
+ export type ApiTriggerResult<T> = Promise<
46
+ {data: T; error?: undefined} | {data?: undefined; error: unknown}
47
+ > & {
48
+ unwrap: () => Promise<T>;
49
+ };
50
+
51
+ const toTriggerResult = <T,>(promise: Promise<T>): ApiTriggerResult<T> => {
52
+ const settled = promise.then(
53
+ (data) => ({data}),
54
+ (error: unknown) => ({error})
55
+ );
56
+ // unwrap() is optional for callers, so keep its rejection from being unhandled.
57
+ promise.catch(() => {});
58
+ return Object.assign(settled, {unwrap: () => promise});
59
+ };
60
+
61
+ export interface UseApiQueryOptions<TRaw, TData> {
62
+ skip?: boolean;
63
+ providesTags?: readonly string[];
64
+ /** Re-request on this interval (ms) while mounted. */
65
+ pollingInterval?: number;
66
+ transformResponse?: (raw: TRaw) => TData;
67
+ client?: ApiClient;
68
+ }
69
+
70
+ export interface ApiRefetchResult<T> {
71
+ data?: T;
72
+ error?: unknown;
73
+ isError: boolean;
74
+ }
75
+
76
+ export interface UseApiQueryResult<T> {
77
+ data: T | undefined;
78
+ error: unknown;
79
+ isUninitialized: boolean;
80
+ isLoading: boolean;
81
+ isFetching: boolean;
82
+ isSuccess: boolean;
83
+ isError: boolean;
84
+ refetch: () => Promise<ApiRefetchResult<T>>;
85
+ }
86
+
87
+ const IDLE: ApiQueryState = {
88
+ data: undefined,
89
+ error: undefined,
90
+ isFetching: false,
91
+ status: "uninitialized",
92
+ };
93
+
94
+ const noopUnsubscribe = (): void => {};
95
+
96
+ /**
97
+ * Cached GET-style request. Identical args share one cache entry across the app.
98
+ * Pass `null` args or `skip: true` to hold off (hook order stays stable).
99
+ */
100
+ export const useApiQuery = <TRaw = unknown, TData = TRaw>(
101
+ args: ApiRequestArgs | null,
102
+ options: UseApiQueryOptions<TRaw, TData> = {}
103
+ ): UseApiQueryResult<TData> => {
104
+ const client = useApiClient(options.client);
105
+ const active = args !== null && !options.skip;
106
+ const key = active ? apiQueryKey(args) : null;
107
+ const argsRef = useRef(args);
108
+ argsRef.current = args;
109
+ const tagsKey = (options.providesTags ?? []).join("\u0000");
110
+ const providesTags = useMemo(() => (tagsKey ? tagsKey.split("\u0000") : []), [tagsKey]);
111
+
112
+ const subscribe = useCallback(
113
+ (listener: () => void): (() => void) => {
114
+ if (!key || !argsRef.current) {
115
+ return noopUnsubscribe;
116
+ }
117
+ return client.subscribeQuery(argsRef.current, listener, {providesTags});
118
+ },
119
+ [client, key, providesTags]
120
+ );
121
+ const getSnapshot = useCallback(
122
+ (): ApiQueryState => (key && argsRef.current ? client.getQueryState(argsRef.current) : IDLE),
123
+ [client, key]
124
+ );
125
+ const state = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
126
+
127
+ // Load on mount, on arg change, and again after a reset or tag drop empties the entry. Keyed on
128
+ // the state object, not its status: a reset in the same commit as the first request turns
129
+ // `uninitialized` → `pending` → `uninitialized` before the next render sees it.
130
+ useEffect(() => {
131
+ if (!key || !argsRef.current || state.status !== "uninitialized") {
132
+ return;
133
+ }
134
+ client.fetchQuery(argsRef.current, {providesTags}).catch(() => {});
135
+ }, [client, key, providesTags, state]);
136
+
137
+ // A new subscriber retries a previously failed request once, like RTK Query does.
138
+ const retriedKey = useRef<string | null>(null);
139
+ useEffect(() => {
140
+ if (!key || !argsRef.current || retriedKey.current === key) {
141
+ return;
142
+ }
143
+ retriedKey.current = key;
144
+ if (client.getQueryState(argsRef.current).status === "rejected") {
145
+ client.fetchQuery(argsRef.current, {force: true, providesTags}).catch(() => {});
146
+ }
147
+ }, [client, key, providesTags]);
148
+
149
+ // Poll while mounted, matching RTK's `pollingInterval`.
150
+ useEffect(() => {
151
+ if (!key || !options.pollingInterval) {
152
+ return;
153
+ }
154
+ const timer = setInterval(() => {
155
+ if (argsRef.current) {
156
+ client.fetchQuery(argsRef.current, {force: true, providesTags}).catch(() => {});
157
+ }
158
+ }, options.pollingInterval);
159
+ return () => {
160
+ clearInterval(timer);
161
+ };
162
+ }, [client, key, options.pollingInterval, providesTags]);
163
+
164
+ const transformRef = useRef(options.transformResponse);
165
+ transformRef.current = options.transformResponse;
166
+ const rawData = state.data as TRaw | undefined;
167
+ const data = useMemo(
168
+ (): TData | undefined =>
169
+ rawData === undefined || !transformRef.current
170
+ ? (rawData as unknown as TData | undefined)
171
+ : transformRef.current(rawData),
172
+ [rawData]
173
+ );
174
+
175
+ const refetch = useCallback(async (): Promise<ApiRefetchResult<TData>> => {
176
+ if (!key || !argsRef.current) {
177
+ return {isError: false};
178
+ }
179
+ try {
180
+ const raw = (await client.fetchQuery(argsRef.current, {force: true, providesTags})) as TRaw;
181
+ const transformed = transformRef.current
182
+ ? transformRef.current(raw)
183
+ : (raw as unknown as TData);
184
+ return {data: transformed, isError: false};
185
+ } catch (error) {
186
+ return {error, isError: true};
187
+ }
188
+ }, [client, key, providesTags]);
189
+
190
+ return {
191
+ data,
192
+ error: state.error,
193
+ isError: state.status === "rejected",
194
+ isFetching: state.isFetching,
195
+ isLoading: active && state.data === undefined && state.status !== "rejected",
196
+ isSuccess: state.status === "fulfilled",
197
+ isUninitialized: !active,
198
+ refetch,
199
+ };
200
+ };
201
+
202
+ export type UseLazyApiQueryResult<T, TArg = ApiRequestArgs> = [
203
+ (arg: TArg) => ApiTriggerResult<T>,
204
+ UseApiQueryResult<T> & {lastArgs: ApiRequestArgs | null},
205
+ ];
206
+
207
+ export interface UseLazyApiQueryOptions<T, TArg>
208
+ extends Omit<UseApiQueryOptions<T, T>, "skip" | "transformResponse"> {
209
+ /** Map a typed trigger argument to request args (generated hooks pass this). */
210
+ toRequest?: (arg: TArg) => ApiRequestArgs;
211
+ }
212
+
213
+ /** Query that runs only when triggered; each trigger fetches fresh data. */
214
+ export const useLazyApiQuery = <T = unknown, TArg = ApiRequestArgs>(
215
+ options: UseLazyApiQueryOptions<T, TArg> = {}
216
+ ): UseLazyApiQueryResult<T, TArg> => {
217
+ const {toRequest, ...queryOptions} = options;
218
+ const client = useApiClient(queryOptions.client);
219
+ const [lastArgs, setLastArgs] = useState<ApiRequestArgs | null>(null);
220
+ const state = useApiQuery<T>(lastArgs, {...queryOptions, client});
221
+ const tagsKey = (queryOptions.providesTags ?? []).join("\u0000");
222
+ const toRequestRef = useRef(toRequest);
223
+ toRequestRef.current = toRequest;
224
+ const trigger = useCallback(
225
+ (arg: TArg): ApiTriggerResult<T> => {
226
+ const args = toRequestRef.current ? toRequestRef.current(arg) : (arg as ApiRequestArgs);
227
+ setLastArgs(args);
228
+ const providesTags = tagsKey ? tagsKey.split("\u0000") : [];
229
+ return toTriggerResult(client.fetchQuery<T>(args, {force: true, providesTags}));
230
+ },
231
+ [client, tagsKey]
232
+ );
233
+ return [trigger, {...state, lastArgs}];
234
+ };
235
+
236
+ export interface UseApiMutationOptions<TArg, TResult> {
237
+ invalidatesTags?: readonly string[] | ((result: TResult, arg: TArg) => readonly string[]);
238
+ client?: ApiClient;
239
+ }
240
+
241
+ export interface ApiMutationState<T> {
242
+ data: T | undefined;
243
+ error: unknown;
244
+ isLoading: boolean;
245
+ isSuccess: boolean;
246
+ isError: boolean;
247
+ reset: () => void;
248
+ }
249
+
250
+ interface MutationSnapshot<T> {
251
+ data: T | undefined;
252
+ error: unknown;
253
+ status: "idle" | "pending" | "fulfilled" | "rejected";
254
+ }
255
+
256
+ export type UseApiMutationResult<TArg, TResult> = [
257
+ (arg: TArg) => ApiTriggerResult<TResult>,
258
+ ApiMutationState<TResult>,
259
+ ];
260
+
261
+ /**
262
+ * Write-style request. `trigger(arg)` resolves `{data}` or `{error}`;
263
+ * `trigger(arg).unwrap()` resolves the data or throws the `ApiError`.
264
+ */
265
+ export const useApiMutation = <TArg = void, TResult = unknown>(
266
+ toRequest: (arg: TArg) => ApiRequestArgs,
267
+ options: UseApiMutationOptions<TArg, TResult> = {}
268
+ ): UseApiMutationResult<TArg, TResult> => {
269
+ const client = useApiClient(options.client);
270
+ const [snapshot, setSnapshot] = useState<MutationSnapshot<TResult>>({
271
+ data: undefined,
272
+ error: undefined,
273
+ status: "idle",
274
+ });
275
+ const toRequestRef = useRef(toRequest);
276
+ toRequestRef.current = toRequest;
277
+ const invalidatesRef = useRef(options.invalidatesTags);
278
+ invalidatesRef.current = options.invalidatesTags;
279
+ const latestCall = useRef(0);
280
+ const mounted = useRef(true);
281
+
282
+ // Ignore results that settle after unmount.
283
+ useEffect(() => {
284
+ mounted.current = true;
285
+ return () => {
286
+ mounted.current = false;
287
+ };
288
+ }, []);
289
+
290
+ const trigger = useCallback(
291
+ (arg: TArg): ApiTriggerResult<TResult> => {
292
+ latestCall.current += 1;
293
+ const call = latestCall.current;
294
+ const update = (next: MutationSnapshot<TResult>): void => {
295
+ if (mounted.current && call === latestCall.current) {
296
+ setSnapshot(next);
297
+ }
298
+ };
299
+ update({data: undefined, error: undefined, status: "pending"});
300
+ const promise = client.request<TResult>(toRequestRef.current(arg)).then(
301
+ (data) => {
302
+ const invalidates = invalidatesRef.current;
303
+ const tags = typeof invalidates === "function" ? invalidates(data, arg) : invalidates;
304
+ if (tags?.length) {
305
+ client.invalidateTags(tags);
306
+ }
307
+ update({data, error: undefined, status: "fulfilled"});
308
+ return data;
309
+ },
310
+ (error: unknown) => {
311
+ update({data: undefined, error, status: "rejected"});
312
+ throw error;
313
+ }
314
+ );
315
+ return toTriggerResult(promise);
316
+ },
317
+ [client]
318
+ );
319
+
320
+ const reset = useCallback((): void => {
321
+ latestCall.current += 1;
322
+ setSnapshot({data: undefined, error: undefined, status: "idle"});
323
+ }, []);
324
+
325
+ return [
326
+ trigger,
327
+ {
328
+ data: snapshot.data,
329
+ error: snapshot.error,
330
+ isError: snapshot.status === "rejected",
331
+ isLoading: snapshot.status === "pending",
332
+ isSuccess: snapshot.status === "fulfilled",
333
+ reset,
334
+ },
335
+ ];
336
+ };
@@ -7,6 +7,8 @@
7
7
  * main entry means non-React (node/backend) consumers never load React.
8
8
  */
9
9
 
10
+ export * from "./apiHooks";
10
11
  export * from "./collectionHooks";
11
12
  export * from "./hooks";
12
13
  export * from "./provider";
14
+ export * from "./useSocketEvent";
@@ -25,3 +25,6 @@ export const useSyncDbClient = (): SyncDb => {
25
25
  }
26
26
  return client;
27
27
  };
28
+
29
+ /** The SyncDb client from context, or `null` when no provider is mounted. */
30
+ export const useOptionalSyncDbClient = (): SyncDb | null => useContext(SyncDbContext);
@@ -0,0 +1,96 @@
1
+ import "fake-indexeddb/auto";
2
+ import {describe, expect, it} from "bun:test";
3
+ import {renderHook} from "@testing-library/react-native";
4
+ import type React from "react";
5
+
6
+ import {createSyncDb, type SyncDb} from "../client";
7
+ import {memoryPersisterFactory} from "../persisters/memoryPersister";
8
+ import {createFakeTransport, type FakeTransport} from "../testing/fakeTransport";
9
+ import {SyncDbProvider} from "./provider";
10
+ import {useSocketEvent} from "./useSocketEvent";
11
+
12
+ let nameCounter = 0;
13
+
14
+ const makeClient = (): {client: SyncDb; transport: FakeTransport} => {
15
+ nameCounter += 1;
16
+ const transport = createFakeTransport();
17
+ const client = createSyncDb({
18
+ authProvider: {
19
+ getToken: async () => "token",
20
+ getUserId: async () => "u1",
21
+ onAuthChange: () => () => {},
22
+ },
23
+ collections: ["todos"],
24
+ name: `use-socket-event-${nameCounter}`,
25
+ persisterFactory: memoryPersisterFactory,
26
+ reconcileIntervalMs: 0,
27
+ transport,
28
+ });
29
+ return {client, transport};
30
+ };
31
+
32
+ const providerWrapper =
33
+ (client: SyncDb): React.FC<{children: React.ReactNode}> =>
34
+ ({children}) => <SyncDbProvider client={client}>{children}</SyncDbProvider>;
35
+
36
+ describe("useSocketEvent", () => {
37
+ it("calls the latest handler for events on the provider's socket", () => {
38
+ const {client, transport} = makeClient();
39
+ const calls: string[] = [];
40
+ const {rerender} = renderHook(
41
+ ({label}: {label: string}) => {
42
+ useSocketEvent("featureFlagsChanged", (payload) => {
43
+ calls.push(`${label}:${(payload as {key: string}).key}`);
44
+ });
45
+ },
46
+ {initialProps: {label: "first"}, wrapper: providerWrapper(client)}
47
+ );
48
+
49
+ transport.emitEvent("featureFlagsChanged", {key: "a"});
50
+ rerender({label: "second"});
51
+ transport.emitEvent("featureFlagsChanged", {key: "b"});
52
+
53
+ expect(calls).toEqual(["first:a", "second:b"]);
54
+ // Re-rendering with a new handler does not rebind the listener.
55
+ expect(transport.eventListenerCount("featureFlagsChanged")).toBe(1);
56
+ });
57
+
58
+ it("unbinds on unmount and while disabled", () => {
59
+ const {client, transport} = makeClient();
60
+ const {rerender, unmount} = renderHook(
61
+ ({enabled}: {enabled: boolean}) => {
62
+ useSocketEvent("ping", () => {}, {client, enabled});
63
+ },
64
+ {initialProps: {enabled: true}}
65
+ );
66
+ expect(transport.eventListenerCount("ping")).toBe(1);
67
+
68
+ rerender({enabled: false});
69
+ expect(transport.eventListenerCount("ping")).toBe(0);
70
+
71
+ rerender({enabled: true});
72
+ expect(transport.eventListenerCount("ping")).toBe(1);
73
+ unmount();
74
+ expect(transport.eventListenerCount("ping")).toBe(0);
75
+ });
76
+
77
+ it("listens to nothing when given a null client", () => {
78
+ const {result} = renderHook(() => {
79
+ useSocketEvent("ping", () => {}, {client: null});
80
+ return "rendered";
81
+ });
82
+ expect(result.current).toBe("rendered");
83
+ });
84
+
85
+ it("throws without a provider or an explicit client", () => {
86
+ const originalError = console.error;
87
+ console.error = (): void => {};
88
+ try {
89
+ expect(() => renderHook(() => useSocketEvent("ping", () => {}))).toThrow(
90
+ "useSocketEvent must be used within a <SyncDbProvider"
91
+ );
92
+ } finally {
93
+ console.error = originalError;
94
+ }
95
+ });
96
+ });
@@ -0,0 +1,59 @@
1
+ import {useEffect, useRef} from "react";
2
+
3
+ import type {SyncDb} from "../client";
4
+ import type {SocketEventHandler} from "../sync/transport";
5
+ import {useOptionalSyncDbClient} from "./provider";
6
+
7
+ /** Anything that can bind a socket event listener; a `SyncDb` client qualifies. */
8
+ export type SocketEventSource = Pick<SyncDb, "onSocketEvent">;
9
+
10
+ export interface UseSocketEventOptions {
11
+ /**
12
+ * Event source. Omitted: the client from `SyncDbProvider` (throws when none is
13
+ * mounted). `null`: listen to nothing (for example before login).
14
+ */
15
+ client?: SocketEventSource | null;
16
+ /** Set `false` to unbind without changing hook order. Default `true`. */
17
+ enabled?: boolean;
18
+ }
19
+
20
+ /**
21
+ * Listen for an app-level server event on the syncdb socket while mounted. The
22
+ * handler may change every render; the latest one is always called, and the
23
+ * listener is rebound only when the event, client, or `enabled` changes.
24
+ *
25
+ * @example
26
+ * ```tsx
27
+ * useSocketEvent("announcementPublished", (payload) => {
28
+ * console.info("announcement", payload);
29
+ * });
30
+ * ```
31
+ */
32
+ export const useSocketEvent = (
33
+ event: string,
34
+ handler: SocketEventHandler,
35
+ options: UseSocketEventOptions = {}
36
+ ): void => {
37
+ const contextClient = useOptionalSyncDbClient();
38
+ const hasOverride = "client" in options;
39
+ const client = hasOverride ? (options.client ?? null) : contextClient;
40
+ if (!hasOverride && !contextClient) {
41
+ throw new Error(
42
+ "useSocketEvent must be used within a <SyncDbProvider client={...}> or be given `client`."
43
+ );
44
+ }
45
+ const enabled = options.enabled ?? true;
46
+ const handlerRef = useRef(handler);
47
+ handlerRef.current = handler;
48
+
49
+ // Bind one listener per (client, event); it forwards to the latest handler so
50
+ // callers do not need to memoize it.
51
+ useEffect((): (() => void) | undefined => {
52
+ if (!client || !enabled) {
53
+ return undefined;
54
+ }
55
+ return client.onSocketEvent(event, (...args: unknown[]): void => {
56
+ handlerRef.current(...args);
57
+ });
58
+ }, [client, enabled, event]);
59
+ };
@@ -1248,7 +1248,7 @@ export const createReplayCoordinator = ({
1248
1248
 
1249
1249
  const replay = ({userId}: {userId: string}): Promise<ReplayResult> => {
1250
1250
  const existing = inFlightReplays.get(userId);
1251
- if (existing) {
1251
+ if (existing !== undefined) {
1252
1252
  // The running drain may have already taken its final "queue empty"
1253
1253
  // snapshot before this call's mutation was enqueued; request a
1254
1254
  // follow-up check once it settles rather than silently stranding the
@@ -504,4 +504,53 @@ describe("createSocketTransport", () => {
504
504
 
505
505
  expect(statuses[statuses.length - 1]).toEqual({connected: false});
506
506
  });
507
+
508
+ it("delivers app-level server events to onEvent listeners across reconnects", async () => {
509
+ const connecting = makeTransport();
510
+ const received: unknown[][] = [];
511
+ const unsubscribe = connecting.onEvent?.("featureFlagsChanged", (...args: unknown[]) => {
512
+ received.push(args);
513
+ });
514
+ await connecting.connect();
515
+
516
+ server.io.emit("featureFlagsChanged", {key: "dark-mode"});
517
+ await waitUntil(() => received.length === 1);
518
+ expect(received).toEqual([[{key: "dark-mode"}]]);
519
+
520
+ // Listeners are bound to the socket, so they survive a disconnect + reconnect.
521
+ connecting.disconnect();
522
+ await connecting.connect();
523
+ server.io.emit("featureFlagsChanged", {key: "beta"});
524
+ await waitUntil(() => received.length === 2);
525
+ expect(received[1]).toEqual([{key: "beta"}]);
526
+
527
+ unsubscribe?.();
528
+ server.io.emit("featureFlagsChanged", {key: "ignored"});
529
+ await new Promise((resolve) => setTimeout(resolve, 30));
530
+ expect(received).toHaveLength(2);
531
+ });
532
+
533
+ it("unbinds only the listener whose unsubscribe was called", async () => {
534
+ const connecting = makeTransport();
535
+ const calls: string[] = [];
536
+ const handler = (): void => {
537
+ calls.push("shared");
538
+ };
539
+ const first = connecting.onEvent?.("ping", handler);
540
+ connecting.onEvent?.("ping", handler);
541
+ await connecting.connect();
542
+
543
+ first?.();
544
+ server.io.emit("ping");
545
+ await waitUntil(() => calls.length === 1);
546
+ await new Promise((resolve) => setTimeout(resolve, 20));
547
+ expect(calls).toEqual(["shared"]);
548
+ });
549
+
550
+ it("rejects sync protocol and Socket.io lifecycle event names", () => {
551
+ const connecting = makeTransport();
552
+ expect(() => connecting.onEvent?.("sync:delta", () => {})).toThrow("reserved");
553
+ expect(() => connecting.onEvent?.("connect", () => {})).toThrow("reserved");
554
+ expect(() => connecting.onEvent?.("disconnect", () => {})).toThrow("reserved");
555
+ });
507
556
  });
@@ -11,8 +11,10 @@ import type {
11
11
  } from "../types";
12
12
  import {
13
13
  DEFAULT_MUTATION_TIMEOUT_MS,
14
+ isReservedSocketEvent,
14
15
  type SendMutationBatchResult,
15
16
  type SendMutationResult,
17
+ type SocketEventHandler,
16
18
  type SyncTransport,
17
19
  type TransportStatus,
18
20
  } from "./transport";
@@ -473,6 +475,19 @@ export const createSocketTransport = ({
473
475
  inboundDeltaBatches.delete(callback);
474
476
  };
475
477
  },
478
+ onEvent: (event: string, handler: SocketEventHandler): (() => void) => {
479
+ if (isReservedSocketEvent(event)) {
480
+ throw new Error(`onSocketEvent: "${event}" is reserved by the sync protocol`);
481
+ }
482
+ // Wrap so the same handler can be registered twice and removed independently.
483
+ const listener = (...args: unknown[]): void => {
484
+ handler(...args);
485
+ };
486
+ socket.on(event, listener);
487
+ return () => {
488
+ socket.off(event, listener);
489
+ };
490
+ },
476
491
  onStatusChange: (callback: (status: TransportStatus) => void): (() => void) => {
477
492
  statusListeners.add(callback);
478
493
  return () => {
@@ -10,6 +10,22 @@ import type {
10
10
  /** Default time to wait for a mutation ack/nack before rejecting. */
11
11
  export const DEFAULT_MUTATION_TIMEOUT_MS = 15_000;
12
12
 
13
+ /**
14
+ * Events the sync protocol and Socket.io own. App listeners cannot bind them, so a
15
+ * stray handler can never interfere with ack correlation or connection state.
16
+ */
17
+ const RESERVED_EVENT_NAMES = new Set([
18
+ "connect",
19
+ "connect_error",
20
+ "disconnect",
21
+ "disconnecting",
22
+ "newListener",
23
+ "removeListener",
24
+ ]);
25
+
26
+ export const isReservedSocketEvent = (event: string): boolean =>
27
+ RESERVED_EVENT_NAMES.has(event) || event.startsWith("sync:");
28
+
13
29
  /** Default max mutations per batch send (server also enforces this cap). */
14
30
  export const DEFAULT_BATCH_SIZE = 50;
15
31
 
@@ -86,4 +102,13 @@ export interface SyncTransport {
86
102
  onDeltaBatch?: (callback: (deltas: SyncDelta[]) => void) => () => void;
87
103
  /** Subscribe to connection status changes. Returns an unsubscribe function. */
88
104
  onStatusChange: (callback: (status: TransportStatus) => void) => () => void;
105
+ /**
106
+ * Listen for an app-level server event on the same connection (for example
107
+ * `featureFlagsChanged`). Listeners survive reconnects. Returns an unsubscribe
108
+ * function. Optional so HTTP-only doubles satisfy the contract.
109
+ */
110
+ onEvent?: (event: string, handler: SocketEventHandler) => () => void;
89
111
  }
112
+
113
+ /** Handler for an app-level server socket event; receives the event's arguments. */
114
+ export type SocketEventHandler = (...args: unknown[]) => void;
@@ -14,6 +14,24 @@ const makeDelta = (overrides: Partial<SyncDelta> = {}): SyncDelta => ({
14
14
  });
15
15
 
16
16
  describe("createFakeTransport", () => {
17
+ it("emits app events to onEvent listeners and tracks listener counts", () => {
18
+ const transport = createFakeTransport();
19
+ const seen: unknown[][] = [];
20
+ const first = transport.onEvent?.("featureFlagsChanged", (...args) => seen.push(args));
21
+ const second = transport.onEvent?.("featureFlagsChanged", (...args) => seen.push(args));
22
+ expect(transport.eventListenerCount("featureFlagsChanged")).toBe(2);
23
+
24
+ transport.emitEvent("featureFlagsChanged", {key: "a"});
25
+ expect(seen).toEqual([[{key: "a"}], [{key: "a"}]]);
26
+
27
+ first?.();
28
+ second?.();
29
+ expect(transport.eventListenerCount("featureFlagsChanged")).toBe(0);
30
+ transport.emitEvent("featureFlagsChanged");
31
+ expect(seen).toHaveLength(2);
32
+ expect(() => transport.onEvent?.("sync:ack", () => {})).toThrow("reserved");
33
+ });
34
+
17
35
  it("connect/disconnect notify status listeners once per change", async () => {
18
36
  const transport = createFakeTransport();
19
37
  const statuses: TransportStatus[] = [];