@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,568 @@
1
+ /**
2
+ * Accounts remembered on this device, for the login screen's "last used" badge and
3
+ * "Continue as" cards.
4
+ *
5
+ * The device may be shared (a family tablet, a clinic kiosk), so the store is conservative:
6
+ * by default it keeps only `{userId, method, lastUsedAt}`. Name, a masked email and an avatar
7
+ * URL are kept only when the app opts in with `rememberIdentity: true`, and turning that off
8
+ * scrubs identity already on the device the next time the store loads or writes. Nothing here
9
+ * is a credential: a remembered account still signs in with its method.
10
+ */
11
+ import type {LoginAccountOption} from "@terreno/ui";
12
+ import * as SecureStore from "expo-secure-store";
13
+ import {DateTime} from "luxon";
14
+ import {useCallback, useMemo, useSyncExternalStore} from "react";
15
+
16
+ import {IsWeb} from "./platform";
17
+
18
+ /** One account remembered on this device. */
19
+ export interface RememberedAccount {
20
+ /** The Better Auth user id. */
21
+ userId: string;
22
+ /** How the account last signed in: a provider id, `"email"`, or `"passkey"`. */
23
+ method: string;
24
+ /** When the account last signed in on this device, as an ISO 8601 UTC timestamp. */
25
+ lastUsedAt: string;
26
+ /** Display name. Stored only with `rememberIdentity: true`. */
27
+ name?: string;
28
+ /** Masked email such as `j***@n***.io`. Stored only with `rememberIdentity: true`. */
29
+ email?: string;
30
+ /** Avatar URL (https only). Stored only with `rememberIdentity: true`. */
31
+ image?: string;
32
+ }
33
+
34
+ /** What {@link RememberedAccountsStore.record} accepts after a successful sign-in. */
35
+ export interface RememberedAccountInput {
36
+ userId: string;
37
+ method: string;
38
+ /** ISO 8601 timestamp. Defaults to now. */
39
+ lastUsedAt?: string;
40
+ /** Kept only with `rememberIdentity: true`. */
41
+ name?: string | null;
42
+ /** Kept only with `rememberIdentity: true`, and always masked before it is stored. */
43
+ email?: string | null;
44
+ /** Kept only with `rememberIdentity: true`. */
45
+ image?: string | null;
46
+ }
47
+
48
+ /**
49
+ * Key/value storage the store persists to. Sync (localStorage) and async (SecureStore)
50
+ * implementations both work; with an async `getItem` the store starts unhydrated.
51
+ */
52
+ export interface RememberedAccountsStorage {
53
+ getItem: (key: string) => string | null | Promise<string | null>;
54
+ setItem: (key: string, value: string) => void | Promise<void>;
55
+ removeItem: (key: string) => void | Promise<void>;
56
+ }
57
+
58
+ export interface RememberedAccountsStoreOptions {
59
+ /**
60
+ * Required. Pass `false` to remember only the method (the conservative choice for shared
61
+ * devices), or `true` to also remember name, masked email and avatar.
62
+ */
63
+ rememberIdentity: boolean;
64
+ /**
65
+ * Storage key. Defaults to `terreno_remembered_accounts`. On native it must use only
66
+ * letters, digits, `.`, `-` and `_` (an expo-secure-store requirement).
67
+ */
68
+ storageKey?: string;
69
+ /** How many accounts to keep, newest first. Defaults to 5. */
70
+ max?: number;
71
+ /** Storage override. Defaults to SecureStore on native and localStorage on web. */
72
+ storage?: RememberedAccountsStorage;
73
+ }
74
+
75
+ /** An immutable view of the store, replaced on every change. */
76
+ export interface RememberedAccountsSnapshot {
77
+ /** Remembered accounts, most recently used first. */
78
+ accounts: RememberedAccount[];
79
+ /** The newest account's method, or undefined when nothing is remembered. */
80
+ lastUsedMethod?: string;
81
+ /** False until async storage (native) has loaded. Always true for sync storage. */
82
+ isHydrated: boolean;
83
+ }
84
+
85
+ export interface RememberedAccountsStore {
86
+ /** Records a sign-in, replacing any earlier entry for the same user. */
87
+ record: (entry: RememberedAccountInput) => Promise<void>;
88
+ /** Removes one account from this device. */
89
+ forget: (userId: string) => Promise<void>;
90
+ /** Removes every remembered account and the storage key. */
91
+ clear: () => Promise<void>;
92
+ /** Remembered accounts, most recently used first. */
93
+ list: () => RememberedAccount[];
94
+ /** The newest account's method, or undefined. */
95
+ lastUsedMethod: () => string | undefined;
96
+ isHydrated: () => boolean;
97
+ /** Resolves once storage has loaded. */
98
+ ready: Promise<void>;
99
+ getSnapshot: () => RememberedAccountsSnapshot;
100
+ /** Calls `listener` after every change. Returns an unsubscribe function. */
101
+ subscribe: (listener: () => void) => () => void;
102
+ /** Stops listening for changes made in other browser tabs. */
103
+ dispose: () => void;
104
+ }
105
+
106
+ export interface UseRememberedAccountsResult {
107
+ accounts: RememberedAccount[];
108
+ lastUsedMethod?: string;
109
+ isHydrated: boolean;
110
+ forget: (userId: string) => Promise<void>;
111
+ clear: () => Promise<void>;
112
+ }
113
+
114
+ const DEFAULT_STORAGE_KEY = "terreno_remembered_accounts";
115
+ const DEFAULT_MAX = 5;
116
+ const STORAGE_VERSION = 1;
117
+ // expo-secure-store rejects or warns on values over 2048 bytes on some platforms.
118
+ const MAX_STORED_BYTES = 2048;
119
+ const MAX_USER_ID_LENGTH = 128;
120
+ const MAX_METHOD_LENGTH = 64;
121
+ const MAX_NAME_LENGTH = 64;
122
+ const MAX_IMAGE_LENGTH = 256;
123
+
124
+ // window.localStorage's synchronous surface.
125
+ interface SyncKeyValueStorage {
126
+ getItem: (key: string) => string | null;
127
+ setItem: (key: string, value: string) => void;
128
+ removeItem: (key: string) => void;
129
+ }
130
+
131
+ const NO_STORAGE: SyncKeyValueStorage = {
132
+ getItem: () => null,
133
+ removeItem: () => {},
134
+ setItem: () => {},
135
+ };
136
+
137
+ const resolveLocalStorage = (): SyncKeyValueStorage => {
138
+ if (typeof window === "undefined") {
139
+ return NO_STORAGE;
140
+ }
141
+ try {
142
+ // Reading `window.localStorage` throws when the browser blocks site storage.
143
+ return window.localStorage ?? NO_STORAGE;
144
+ } catch {
145
+ return NO_STORAGE;
146
+ }
147
+ };
148
+
149
+ /**
150
+ * The default storage: SecureStore on native (on iOS, never restored to another device from a
151
+ * backup; on Android, excluded from Auto Backup by the expo-secure-store config plugin),
152
+ * localStorage on web, resolved on each call so a store created before `window` exists still
153
+ * finds it. `isWeb` is a parameter so both branches are testable without reloading modules.
154
+ */
155
+ export const createRememberedAccountsStorage = (
156
+ isWeb: boolean = IsWeb
157
+ ): RememberedAccountsStorage => {
158
+ if (!isWeb) {
159
+ const options = {keychainAccessible: SecureStore.WHEN_UNLOCKED_THIS_DEVICE_ONLY};
160
+ return {
161
+ getItem: (key: string): Promise<string | null> => SecureStore.getItemAsync(key, options),
162
+ removeItem: (key: string): Promise<void> => SecureStore.deleteItemAsync(key, options),
163
+ setItem: (key: string, value: string): Promise<void> =>
164
+ SecureStore.setItemAsync(key, value, options),
165
+ };
166
+ }
167
+ return {
168
+ getItem: (key: string): string | null => {
169
+ try {
170
+ return resolveLocalStorage().getItem(key);
171
+ } catch {
172
+ return null;
173
+ }
174
+ },
175
+ removeItem: (key: string): void => {
176
+ resolveLocalStorage().removeItem(key);
177
+ },
178
+ setItem: (key: string, value: string): void => {
179
+ resolveLocalStorage().setItem(key, value);
180
+ },
181
+ };
182
+ };
183
+
184
+ /**
185
+ * Masks an email for display on a shared device: the first character of the local part and of
186
+ * the domain stay, the rest is hidden, and only the top-level domain is shown in full. Any
187
+ * subdomains fold into the hidden part, and a one-letter local part looks like a long one.
188
+ * `josh@mail.flourish.health` becomes `j***@m***.health`. Idempotent. Returns undefined for
189
+ * anything that is not an email.
190
+ */
191
+ export const maskEmail = (email: string): string | undefined => {
192
+ const trimmed = email.trim().toLowerCase();
193
+ const at = trimmed.lastIndexOf("@");
194
+ if (at <= 0 || at === trimmed.length - 1) {
195
+ return undefined;
196
+ }
197
+ const local = trimmed.slice(0, at);
198
+ const labels = trimmed.slice(at + 1).split(".");
199
+ if (labels.some((label) => label.length === 0)) {
200
+ return undefined;
201
+ }
202
+ const hide = (value: string): string => `${Array.from(value)[0]}***`;
203
+ if (labels.length === 1) {
204
+ return `${hide(local)}@${hide(labels[0])}`;
205
+ }
206
+ const topLevel = labels[labels.length - 1];
207
+ return `${hide(local)}@${hide(labels.slice(0, -1).join("."))}.${topLevel}`;
208
+ };
209
+
210
+ const isNonEmptyString = (value: unknown, maxLength: number): value is string => {
211
+ return typeof value === "string" && value.length > 0 && value.length <= maxLength;
212
+ };
213
+
214
+ const normalizeTimestamp = (value: unknown): string | undefined => {
215
+ if (typeof value !== "string") {
216
+ return undefined;
217
+ }
218
+ const parsed = DateTime.fromISO(value, {zone: "utc"});
219
+ if (!parsed.isValid) {
220
+ return undefined;
221
+ }
222
+ return parsed.toUTC().toISO() ?? undefined;
223
+ };
224
+
225
+ const sanitizeName = (value: unknown): string | undefined => {
226
+ if (typeof value !== "string" || value.trim().length === 0) {
227
+ return undefined;
228
+ }
229
+ return Array.from(value.trim()).slice(0, MAX_NAME_LENGTH).join("");
230
+ };
231
+
232
+ const sanitizeImage = (value: unknown): string | undefined => {
233
+ if (typeof value !== "string" || value.length > MAX_IMAGE_LENGTH) {
234
+ return undefined;
235
+ }
236
+ return /^https:\/\//i.test(value) ? value : undefined;
237
+ };
238
+
239
+ // Builds an account with a fixed key order so serialization is stable across loads.
240
+ const sanitizeAccount = (
241
+ value: unknown,
242
+ rememberIdentity: boolean
243
+ ): RememberedAccount | undefined => {
244
+ if (typeof value !== "object" || value === null) {
245
+ return undefined;
246
+ }
247
+ const raw = value as Record<string, unknown>;
248
+ const lastUsedAt = normalizeTimestamp(raw.lastUsedAt);
249
+ if (
250
+ !isNonEmptyString(raw.userId, MAX_USER_ID_LENGTH) ||
251
+ !isNonEmptyString(raw.method, MAX_METHOD_LENGTH) ||
252
+ !lastUsedAt
253
+ ) {
254
+ return undefined;
255
+ }
256
+ const account: RememberedAccount = {lastUsedAt, method: raw.method, userId: raw.userId};
257
+ if (!rememberIdentity) {
258
+ return account;
259
+ }
260
+ const name = sanitizeName(raw.name);
261
+ const email = typeof raw.email === "string" ? maskEmail(raw.email) : undefined;
262
+ const image = sanitizeImage(raw.image);
263
+ if (name) {
264
+ account.name = name;
265
+ }
266
+ if (email) {
267
+ account.email = email;
268
+ }
269
+ if (image) {
270
+ account.image = image;
271
+ }
272
+ return account;
273
+ };
274
+
275
+ const byteLength = (value: string): number => {
276
+ return encodeURIComponent(value).replace(/%[0-9A-F]{2}/g, "x").length;
277
+ };
278
+
279
+ const serialize = (accounts: RememberedAccount[]): string => {
280
+ return JSON.stringify({accounts, v: STORAGE_VERSION});
281
+ };
282
+
283
+ // Newest first, one entry per user, at most `max`, and small enough for SecureStore.
284
+ const normalizeList = (accounts: RememberedAccount[], max: number): RememberedAccount[] => {
285
+ const seen = new Set<string>();
286
+ const unique = accounts
287
+ .map((account, index) => ({
288
+ account,
289
+ index,
290
+ millis: DateTime.fromISO(account.lastUsedAt).toMillis(),
291
+ }))
292
+ .sort((a, b) => b.millis - a.millis || a.index - b.index)
293
+ .map(({account}) => account)
294
+ .filter((account) => {
295
+ if (seen.has(account.userId)) {
296
+ return false;
297
+ }
298
+ seen.add(account.userId);
299
+ return true;
300
+ });
301
+ const kept = unique.slice(0, max);
302
+ while (kept.length > 0 && byteLength(serialize(kept)) > MAX_STORED_BYTES) {
303
+ kept.pop();
304
+ }
305
+ return kept;
306
+ };
307
+
308
+ // Returns undefined when the stored value is unusable and should be reset.
309
+ const parseStored = (raw: string, rememberIdentity: boolean): RememberedAccount[] | undefined => {
310
+ if (byteLength(raw) > MAX_STORED_BYTES) {
311
+ return undefined;
312
+ }
313
+ let parsed: unknown;
314
+ try {
315
+ parsed = JSON.parse(raw);
316
+ } catch {
317
+ return undefined;
318
+ }
319
+ if (typeof parsed !== "object" || parsed === null) {
320
+ return undefined;
321
+ }
322
+ const {accounts, v} = parsed as {accounts?: unknown; v?: unknown};
323
+ if (v !== STORAGE_VERSION || !Array.isArray(accounts)) {
324
+ return undefined;
325
+ }
326
+ return accounts
327
+ .map((account) => sanitizeAccount(account, rememberIdentity))
328
+ .filter((account): account is RememberedAccount => account !== undefined);
329
+ };
330
+
331
+ interface StoredRead {
332
+ accounts: RememberedAccount[];
333
+ action: "none" | "reset" | "rewrite";
334
+ }
335
+
336
+ const isPromise = <T>(value: T | Promise<T>): value is Promise<T> => {
337
+ return typeof (value as {then?: unknown} | null)?.then === "function";
338
+ };
339
+
340
+ /**
341
+ * Creates the on-device store of remembered accounts. Create one per app (module scope) and
342
+ * share it between the login screen and sign-out. See "Remember accounts on this device" in
343
+ * docs/how-to/configure-better-auth.md.
344
+ */
345
+ export const createRememberedAccountsStore = ({
346
+ rememberIdentity,
347
+ storageKey = DEFAULT_STORAGE_KEY,
348
+ max = DEFAULT_MAX,
349
+ storage = createRememberedAccountsStorage(),
350
+ }: RememberedAccountsStoreOptions): RememberedAccountsStore => {
351
+ const limit = Math.max(1, Math.floor(max));
352
+ const listeners = new Set<() => void>();
353
+ let snapshot: RememberedAccountsSnapshot = {accounts: [], isHydrated: false};
354
+
355
+ const setState = (accounts: RememberedAccount[], isHydrated: boolean): void => {
356
+ snapshot = {accounts, isHydrated, lastUsedMethod: accounts[0]?.method};
357
+ for (const listener of listeners) {
358
+ listener();
359
+ }
360
+ };
361
+
362
+ const reset = async (): Promise<void> => {
363
+ try {
364
+ await storage.removeItem(storageKey);
365
+ } catch (error) {
366
+ console.warn("[rememberedAccounts] Could not clear stored accounts", error);
367
+ }
368
+ };
369
+
370
+ const persist = async (accounts: RememberedAccount[]): Promise<void> => {
371
+ if (accounts.length === 0) {
372
+ await reset();
373
+ return;
374
+ }
375
+ try {
376
+ await storage.setItem(storageKey, serialize(accounts));
377
+ } catch (error) {
378
+ console.warn("[rememberedAccounts] Could not save remembered accounts", error);
379
+ await reset();
380
+ }
381
+ };
382
+
383
+ // Interprets a stored value. Unusable data reads as empty and must be reset; data the current
384
+ // options would store differently (identity after opting out, unmasked email, over `max`)
385
+ // must be rewritten.
386
+ const interpret = (raw: string | null): StoredRead => {
387
+ if (raw === null) {
388
+ return {accounts: [], action: "none"};
389
+ }
390
+ const parsed = parseStored(raw, rememberIdentity);
391
+ if (!parsed) {
392
+ console.warn("[rememberedAccounts] Ignoring unreadable remembered accounts");
393
+ return {accounts: [], action: "reset"};
394
+ }
395
+ const accounts = normalizeList(parsed, limit);
396
+ if (accounts.length === 0 || serialize(accounts) !== raw) {
397
+ return {accounts, action: "rewrite"};
398
+ }
399
+ return {accounts, action: "none"};
400
+ };
401
+
402
+ const settle = async ({accounts, action}: StoredRead): Promise<void> => {
403
+ if (action === "reset") {
404
+ await reset();
405
+ } else if (action === "rewrite") {
406
+ await persist(accounts);
407
+ }
408
+ };
409
+
410
+ // Stays synchronous for synchronous storage, so web state is ready as soon as the store exists.
411
+ const hydrate = (): Promise<void> => {
412
+ let raw: string | null | Promise<string | null>;
413
+ try {
414
+ raw = storage.getItem(storageKey);
415
+ } catch (error) {
416
+ console.warn("[rememberedAccounts] Could not read remembered accounts", error);
417
+ setState([], true);
418
+ return Promise.resolve();
419
+ }
420
+ const apply = (value: string | null): Promise<void> => {
421
+ const read = interpret(value);
422
+ setState(read.accounts, true);
423
+ return settle(read);
424
+ };
425
+ if (!isPromise(raw)) {
426
+ return apply(raw);
427
+ }
428
+ return raw.then(apply, (error: unknown) => {
429
+ console.warn("[rememberedAccounts] Could not read remembered accounts", error);
430
+ setState([], true);
431
+ });
432
+ };
433
+
434
+ // Storage is the source of truth: another tab, or another store on the same key, may have
435
+ // changed it since this store last looked. Keeps the in-memory list when storage is unreadable.
436
+ const readCurrent = async (): Promise<RememberedAccount[]> => {
437
+ try {
438
+ return interpret(await storage.getItem(storageKey)).accounts;
439
+ } catch (error) {
440
+ console.warn("[rememberedAccounts] Could not read remembered accounts", error);
441
+ return snapshot.accounts;
442
+ }
443
+ };
444
+
445
+ const ready = hydrate();
446
+ // Operations run one at a time after hydration, so a sign-in recorded while native storage is
447
+ // still loading merges with what was stored. Each runs after the previous one settles, even
448
+ // when it failed, so one failure is reported to its caller without blocking later calls.
449
+ let queue: Promise<void> = ready;
450
+ const run = (operation: () => Promise<void>): Promise<void> => {
451
+ const next = queue.catch(() => {}).then(operation);
452
+ queue = next;
453
+ return next;
454
+ };
455
+
456
+ const enqueue = (
457
+ change: (accounts: RememberedAccount[]) => RememberedAccount[]
458
+ ): Promise<void> => {
459
+ return run(async () => {
460
+ const accounts = normalizeList(change(await readCurrent()), limit);
461
+ setState(accounts, true);
462
+ await persist(accounts);
463
+ });
464
+ };
465
+
466
+ // On web, follow changes other tabs make to the same key (`key` is null when a tab clears
467
+ // all of localStorage).
468
+ const eventTarget = typeof window === "undefined" ? undefined : window;
469
+ const onStorage = (event: {key: string | null}): void => {
470
+ if (event.key !== null && event.key !== storageKey) {
471
+ return;
472
+ }
473
+ run(async () => {
474
+ setState(await readCurrent(), true);
475
+ }).catch((error: unknown) => {
476
+ console.warn("[rememberedAccounts] Could not reload remembered accounts", error);
477
+ });
478
+ };
479
+ if (typeof eventTarget?.addEventListener === "function") {
480
+ eventTarget.addEventListener("storage", onStorage);
481
+ }
482
+
483
+ const record = (entry: RememberedAccountInput): Promise<void> => {
484
+ if (
485
+ !isNonEmptyString(entry.userId, MAX_USER_ID_LENGTH) ||
486
+ !isNonEmptyString(entry.method, MAX_METHOD_LENGTH)
487
+ ) {
488
+ console.warn(
489
+ "[rememberedAccounts] Not recording an account without a valid userId and method"
490
+ );
491
+ return Promise.resolve();
492
+ }
493
+ return enqueue((accounts) => {
494
+ const existing = accounts.find((account) => account.userId === entry.userId);
495
+ const next = sanitizeAccount(
496
+ {
497
+ email: entry.email ?? existing?.email,
498
+ image: entry.image ?? existing?.image,
499
+ lastUsedAt: normalizeTimestamp(entry.lastUsedAt) ?? DateTime.utc().toISO(),
500
+ method: entry.method,
501
+ name: entry.name ?? existing?.name,
502
+ userId: entry.userId,
503
+ },
504
+ rememberIdentity
505
+ ) as RememberedAccount;
506
+ return [next, ...accounts.filter((account) => account.userId !== entry.userId)];
507
+ });
508
+ };
509
+
510
+ return {
511
+ clear: (): Promise<void> => enqueue(() => []),
512
+ dispose: (): void => {
513
+ if (typeof eventTarget?.removeEventListener === "function") {
514
+ eventTarget.removeEventListener("storage", onStorage);
515
+ }
516
+ },
517
+ forget: (userId: string): Promise<void> =>
518
+ enqueue((accounts) => accounts.filter((account) => account.userId !== userId)),
519
+ getSnapshot: (): RememberedAccountsSnapshot => snapshot,
520
+ isHydrated: (): boolean => snapshot.isHydrated,
521
+ lastUsedMethod: (): string | undefined => snapshot.lastUsedMethod,
522
+ list: (): RememberedAccount[] => snapshot.accounts,
523
+ ready,
524
+ record,
525
+ subscribe: (listener: () => void): (() => void) => {
526
+ listeners.add(listener);
527
+ return (): void => {
528
+ listeners.delete(listener);
529
+ };
530
+ },
531
+ };
532
+ };
533
+
534
+ /** Maps remembered accounts to `@terreno/ui` LoginScreen `rememberedAccounts`, keyed by userId. */
535
+ export const toLoginAccountOptions = (accounts: RememberedAccount[]): LoginAccountOption[] => {
536
+ return accounts.map(({userId, method, name, email, image}) => {
537
+ const option: LoginAccountOption = {id: userId, method};
538
+ if (name) {
539
+ option.name = name;
540
+ }
541
+ if (email) {
542
+ option.email = email;
543
+ }
544
+ if (image) {
545
+ option.image = image;
546
+ }
547
+ return option;
548
+ });
549
+ };
550
+
551
+ /** Subscribes a component to a remembered-accounts store. */
552
+ export const useRememberedAccounts = (
553
+ store: RememberedAccountsStore
554
+ ): UseRememberedAccountsResult => {
555
+ const snapshot = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
556
+ const forget = useCallback((userId: string): Promise<void> => store.forget(userId), [store]);
557
+ const clear = useCallback((): Promise<void> => store.clear(), [store]);
558
+ return useMemo(
559
+ (): UseRememberedAccountsResult => ({
560
+ accounts: snapshot.accounts,
561
+ clear,
562
+ forget,
563
+ isHydrated: snapshot.isHydrated,
564
+ lastUsedMethod: snapshot.lastUsedMethod,
565
+ }),
566
+ [snapshot, clear, forget]
567
+ );
568
+ };