@terreno/syncdb 57.21.0 → 58.0.0-beta.2

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 (490) hide show
  1. package/CHANGELOG.md +89 -0
  2. package/README.md +8 -8
  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 +18 -1
  179. package/dist/client.d.ts.map +1 -1
  180. package/dist/client.js +245 -185
  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 +87 -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 +4 -3
  271. package/dist/index.d.ts.map +1 -1
  272. package/dist/index.js +2 -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/mutations/entityIds.d.ts +23 -0
  323. package/dist/mutations/entityIds.d.ts.map +1 -0
  324. package/dist/mutations/entityIds.js +31 -0
  325. package/dist/mutations/entityIds.js.map +1 -0
  326. package/dist/mutations/entityIds.test.d.ts +2 -0
  327. package/dist/mutations/entityIds.test.d.ts.map +1 -0
  328. package/dist/mutations/entityIds.test.js +48 -0
  329. package/dist/mutations/entityIds.test.js.map +1 -0
  330. package/dist/persisters/defaultPersisterFactory.native.d.ts.map +1 -1
  331. package/dist/persisters/defaultPersisterFactory.native.js +2 -0
  332. package/dist/persisters/defaultPersisterFactory.native.js.map +1 -1
  333. package/dist/persisters/encryptedIndexedDbPersister.d.ts.map +1 -1
  334. package/dist/persisters/encryptedIndexedDbPersister.js +3 -0
  335. package/dist/persisters/encryptedIndexedDbPersister.js.map +1 -1
  336. package/dist/persisters/types.d.ts +6 -0
  337. package/dist/persisters/types.d.ts.map +1 -1
  338. package/dist/query/queryWindows.js +2 -2
  339. package/dist/query/queryWindows.js.map +1 -1
  340. package/dist/react/apiHooks.d.ts +87 -0
  341. package/dist/react/apiHooks.d.ts.map +1 -0
  342. package/dist/react/apiHooks.js +195 -0
  343. package/dist/react/apiHooks.js.map +1 -0
  344. package/dist/react/apiHooks.test.d.ts +2 -0
  345. package/dist/react/apiHooks.test.d.ts.map +1 -0
  346. package/dist/react/apiHooks.test.js +366 -0
  347. package/dist/react/apiHooks.test.js.map +1 -0
  348. package/dist/react/index.d.ts +2 -0
  349. package/dist/react/index.d.ts.map +1 -1
  350. package/dist/react/index.js +2 -0
  351. package/dist/react/index.js.map +1 -1
  352. package/dist/react/provider.d.ts +2 -0
  353. package/dist/react/provider.d.ts.map +1 -1
  354. package/dist/react/provider.js +2 -0
  355. package/dist/react/provider.js.map +1 -1
  356. package/dist/react/useSocketEvent.d.ts +27 -0
  357. package/dist/react/useSocketEvent.d.ts.map +1 -0
  358. package/dist/react/useSocketEvent.js +36 -0
  359. package/dist/react/useSocketEvent.js.map +1 -0
  360. package/dist/react/useSocketEvent.test.d.ts +2 -0
  361. package/dist/react/useSocketEvent.test.d.ts.map +1 -0
  362. package/dist/react/useSocketEvent.test.js +76 -0
  363. package/dist/react/useSocketEvent.test.js.map +1 -0
  364. package/dist/sync/replayCoordinator.d.ts.map +1 -1
  365. package/dist/sync/replayCoordinator.js +5 -4
  366. package/dist/sync/replayCoordinator.js.map +1 -1
  367. package/dist/sync/socketTransport.d.ts.map +1 -1
  368. package/dist/sync/socketTransport.js +14 -1
  369. package/dist/sync/socketTransport.js.map +1 -1
  370. package/dist/sync/socketTransport.test.js +42 -0
  371. package/dist/sync/socketTransport.test.js.map +1 -1
  372. package/dist/sync/transport.d.ts +9 -0
  373. package/dist/sync/transport.d.ts.map +1 -1
  374. package/dist/sync/transport.js +13 -0
  375. package/dist/sync/transport.js.map +1 -1
  376. package/dist/testing/fakeTransport.d.ts +5 -1
  377. package/dist/testing/fakeTransport.d.ts.map +1 -1
  378. package/dist/testing/fakeTransport.js +26 -0
  379. package/dist/testing/fakeTransport.js.map +1 -1
  380. package/dist/testing/fakeTransport.test.js +15 -0
  381. package/dist/testing/fakeTransport.test.js.map +1 -1
  382. package/dist/types.d.ts +8 -0
  383. package/dist/types.d.ts.map +1 -1
  384. package/package.json +93 -8
  385. package/src/api/apiError.ts +47 -0
  386. package/src/api/apiFetch.ts +245 -0
  387. package/src/api/client.test.ts +711 -0
  388. package/src/api/client.ts +367 -0
  389. package/src/app/app.ts +30 -0
  390. package/src/app/devConsoleLogger.test.ts +246 -0
  391. package/src/app/devConsoleLogger.ts +173 -0
  392. package/src/app/mcpTools.ts +101 -0
  393. package/src/app/permissions.test.ts +44 -0
  394. package/src/app/permissions.ts +58 -0
  395. package/src/app/upgradeCheck.ts +177 -0
  396. package/src/auth/SessionProvider.test.tsx +286 -0
  397. package/src/auth/SessionProvider.tsx +87 -0
  398. package/src/auth/TerrenoAccountSecurityScreen.tsx +56 -0
  399. package/src/auth/TerrenoLoginScreen.tsx +131 -0
  400. package/src/auth/auth.ts +117 -0
  401. package/src/auth/betterAuthAdapter.ts +1 -1
  402. package/src/auth/betterAuthClient.ts +997 -0
  403. package/src/auth/betterAuthClient.types.test.ts +197 -0
  404. package/src/auth/betterAuthClientRegistry.test.ts +114 -0
  405. package/src/auth/betterAuthClientRegistry.ts +99 -0
  406. package/src/auth/betterAuthTypes.ts +189 -0
  407. package/src/auth/jwtAuthAdapter.test.ts +754 -0
  408. package/src/auth/jwtAuthAdapter.ts +420 -0
  409. package/src/auth/loginErrors.test.ts +97 -0
  410. package/src/auth/loginErrors.ts +249 -0
  411. package/src/auth/ownEntry.test.ts +22 -0
  412. package/src/auth/ownEntry.ts +15 -0
  413. package/src/auth/platform.ts +4 -0
  414. package/src/auth/rememberedAccounts.test.ts +844 -0
  415. package/src/auth/rememberedAccounts.ts +568 -0
  416. package/src/auth/session.test.ts +976 -0
  417. package/src/auth/session.ts +509 -0
  418. package/src/auth/tokenExpiry.ts +185 -0
  419. package/src/auth/types.ts +1 -1
  420. package/src/auth/useAccountSecurity.ts +678 -0
  421. package/src/auth/useAccountSecurity.types.test.ts +28 -0
  422. package/src/auth/useAuthMethods.test.ts +181 -0
  423. package/src/auth/useAuthMethods.ts +137 -0
  424. package/src/auth/useJwtAuth.test.tsx +202 -0
  425. package/src/auth/useJwtAuth.ts +102 -0
  426. package/src/auth/useLoginController.ts +1038 -0
  427. package/src/auth/useLoginController.types.test.ts +26 -0
  428. package/src/buildNumber.test.ts +139 -0
  429. package/src/buildNumber.ts +75 -0
  430. package/src/client.socketEvents.test.ts +77 -0
  431. package/src/client.test.ts +109 -1
  432. package/src/client.ts +104 -19
  433. package/src/codegen/cli.test.ts +66 -0
  434. package/src/codegen/cli.ts +23 -12
  435. package/src/codegen/discoverCollections.ts +4 -0
  436. package/src/codegen/discoverOperations.ts +172 -0
  437. package/src/codegen/emitApi.test.tsx +445 -0
  438. package/src/codegen/emitApi.ts +396 -0
  439. package/src/codegen/emitSdk.ts +2 -2
  440. package/src/codegen/fixtures/openapi.api.json +840 -0
  441. package/src/codegen/generate.test.ts +54 -1
  442. package/src/codegen/generate.ts +20 -1
  443. package/src/codegen/hookNames.ts +35 -0
  444. package/src/codegen/safeIdentifiers.test.ts +20 -0
  445. package/src/codegen/safeIdentifiers.ts +7 -2
  446. package/src/codegen/types.ts +45 -1
  447. package/src/config/baseUrl.test.ts +53 -0
  448. package/src/config/baseUrl.ts +68 -0
  449. package/src/config/resolveBaseUrls.test.ts +308 -0
  450. package/src/config/resolveBaseUrls.ts +118 -0
  451. package/src/crypto/keyProviders.test.ts +23 -0
  452. package/src/crypto/keyProviders.ts +15 -4
  453. package/src/crypto/types.ts +5 -0
  454. package/src/flags/flagTestServer.ts +77 -0
  455. package/src/flags/useFeatureFlags.test.tsx +146 -0
  456. package/src/flags/useFeatureFlags.ts +130 -0
  457. package/src/flags/useTerrenoFeatureFlags.test.tsx +329 -0
  458. package/src/flags/useTerrenoFeatureFlags.ts +188 -0
  459. package/src/index.ts +4 -1
  460. package/src/isolated/TerrenoAccountSecurityScreen.isolated.tsx +123 -0
  461. package/src/isolated/TerrenoLoginScreen.isolated.tsx +256 -0
  462. package/src/isolated/betterAuthClient.isolated.ts +2198 -0
  463. package/src/isolated/betterAuthClient.native.isolated.ts +173 -0
  464. package/src/isolated/mcpTools.isolated.ts +259 -0
  465. package/src/isolated/rememberedAccounts.native.isolated.ts +63 -0
  466. package/src/isolated/sessionLogout.isolated.ts +152 -0
  467. package/src/isolated/tokenExpiry.isolated.ts +271 -0
  468. package/src/isolated/upgradeCheck.isolated.tsx +321 -0
  469. package/src/isolated/useAccountSecurity.isolated.ts +1089 -0
  470. package/src/isolated/useAccountSecurity.native.isolated.ts +61 -0
  471. package/src/isolated/useLoginController.isolated.ts +1384 -0
  472. package/src/mutations/entityIds.test.ts +55 -0
  473. package/src/mutations/entityIds.ts +50 -0
  474. package/src/persisters/defaultPersisterFactory.native.ts +7 -1
  475. package/src/persisters/encryptedIndexedDbPersister.ts +3 -0
  476. package/src/persisters/types.ts +6 -0
  477. package/src/query/queryWindows.ts +2 -2
  478. package/src/react/apiHooks.test.tsx +473 -0
  479. package/src/react/apiHooks.tsx +336 -0
  480. package/src/react/index.ts +2 -0
  481. package/src/react/provider.tsx +3 -0
  482. package/src/react/useSocketEvent.test.tsx +96 -0
  483. package/src/react/useSocketEvent.ts +59 -0
  484. package/src/sync/replayCoordinator.ts +5 -4
  485. package/src/sync/socketTransport.test.ts +49 -0
  486. package/src/sync/socketTransport.ts +15 -0
  487. package/src/sync/transport.ts +25 -0
  488. package/src/testing/fakeTransport.test.ts +18 -0
  489. package/src/testing/fakeTransport.ts +36 -5
  490. package/src/types.ts +9 -0
@@ -0,0 +1,678 @@
1
+ /**
2
+ * Everything an account security screen needs from a Better Auth client, in one hook: linked
3
+ * providers (link and unlink), the password (change, or set a first one), passkeys, two-factor
4
+ * authentication, and signed-in sessions. It loads each section, builds the props of each
5
+ * `@terreno/ui` security card, unwraps every Better Auth `{data, error}` result into a thrown
6
+ * `Error` (so the card that called shows its message), and after each change refetches only the
7
+ * section that changed. `TerrenoAccountSecurityScreen` renders `@terreno/ui`'s
8
+ * `AccountSecurityScreen` from it; apps with their own screen can spread `screenProps` into theirs.
9
+ */
10
+ import type {
11
+ AccountPasskey,
12
+ AccountSecurityScreenProps,
13
+ AccountSession,
14
+ LinkedAccount,
15
+ LinkedAccountsCardProps,
16
+ PasskeysCardProps,
17
+ PasswordCardProps,
18
+ PasswordCardSubmission,
19
+ SessionsCardProps,
20
+ TwoFactorEnrollment,
21
+ TwoFactorSettingsCardProps,
22
+ } from "@terreno/ui";
23
+ import {useCallback, useEffect, useMemo, useRef, useState} from "react";
24
+
25
+ import {
26
+ type BetterAuthClient,
27
+ type BetterAuthLinkClient,
28
+ linkSocialWithHandoff,
29
+ } from "./betterAuthClient";
30
+ import {getOwnEntry} from "./ownEntry";
31
+ import {IsWeb} from "./platform";
32
+ import {type AuthMethodsClient, type BetterAuthMethods, useAuthMethods} from "./useAuthMethods";
33
+
34
+ /** A Better Auth error as the client returns it. */
35
+ export interface AccountSecurityClientError {
36
+ code?: string;
37
+ message?: string;
38
+ status?: number;
39
+ statusText?: string;
40
+ }
41
+
42
+ /** Better Auth client calls resolve `{data, error}` instead of throwing. */
43
+ export interface AccountSecurityClientResult<Data> {
44
+ data?: Data | null;
45
+ error?: AccountSecurityClientError | null;
46
+ }
47
+
48
+ /** The session user fields the hook reads. */
49
+ export interface AccountSecurityUser {
50
+ id: string;
51
+ email?: string | null;
52
+ name?: string | null;
53
+ /** Set by the server's `twoFactor` feature. */
54
+ twoFactorEnabled?: boolean | null;
55
+ }
56
+
57
+ /** The current session, from `getSession`. */
58
+ export interface AccountSecuritySessionData {
59
+ session: {id: string; token?: string};
60
+ user: AccountSecurityUser;
61
+ }
62
+
63
+ /** One `listAccounts` entry. */
64
+ export interface AccountSecurityAccountRow {
65
+ id: string;
66
+ providerId: string;
67
+ accountId?: string;
68
+ createdAt?: Date | string;
69
+ }
70
+
71
+ /**
72
+ * The part of a Better Auth client the hook calls. A client from `createBetterAuthClient`
73
+ * satisfies it; `passkey` and `twoFactor` exist when those `features` are on, and the hook leaves
74
+ * out the card of a namespace that is missing.
75
+ */
76
+ export interface AccountSecurityClient extends AuthMethodsClient {
77
+ $fetch(
78
+ path: string,
79
+ options?: {method?: "GET" | "POST"; body?: Record<string, unknown>}
80
+ ): Promise<{data: unknown; error: unknown}>;
81
+ getSession(options?: {
82
+ query?: {disableCookieCache?: boolean};
83
+ }): Promise<AccountSecurityClientResult<AccountSecuritySessionData | null>>;
84
+ listAccounts(): Promise<AccountSecurityClientResult<AccountSecurityAccountRow[]>>;
85
+ unlinkAccount(body: {accountId: string}): Promise<AccountSecurityClientResult<unknown>>;
86
+ linkSocial(body: {
87
+ callbackURL: string;
88
+ errorCallbackURL?: string;
89
+ provider: string;
90
+ }): Promise<{error: {code?: string; message?: string; status: number} | null}>;
91
+ changePassword(body: {
92
+ currentPassword: string;
93
+ newPassword: string;
94
+ revokeOtherSessions?: boolean;
95
+ }): Promise<AccountSecurityClientResult<unknown>>;
96
+ listSessions(): Promise<AccountSecurityClientResult<AccountSession[]>>;
97
+ revokeSession(body: {token: string}): Promise<AccountSecurityClientResult<unknown>>;
98
+ revokeOtherSessions(): Promise<AccountSecurityClientResult<unknown>>;
99
+ passkey?: {
100
+ listUserPasskeys(): Promise<AccountSecurityClientResult<AccountPasskey[]>>;
101
+ addPasskey(options?: {
102
+ name?: string;
103
+ }): Promise<AccountSecurityClientResult<unknown> | undefined>;
104
+ updatePasskey(body: {id: string; name: string}): Promise<AccountSecurityClientResult<unknown>>;
105
+ deletePasskey(body: {id: string}): Promise<AccountSecurityClientResult<unknown>>;
106
+ };
107
+ twoFactor?: {
108
+ enable(body: {password: string}): Promise<AccountSecurityClientResult<object>>;
109
+ verifyTotp(body: {code: string}): Promise<AccountSecurityClientResult<unknown>>;
110
+ generateBackupCodes(body: {
111
+ password: string;
112
+ }): Promise<AccountSecurityClientResult<{backupCodes: string[]}>>;
113
+ disable(body: {password: string}): Promise<AccountSecurityClientResult<unknown>>;
114
+ };
115
+ }
116
+
117
+ /**
118
+ * Any client `createBetterAuthClient` returns. One made without `features` is typed loosely, so
119
+ * it is listed on its own.
120
+ */
121
+ export type AccountSecurityClientInput = AccountSecurityClient | BetterAuthClient;
122
+
123
+ export interface UseAccountSecurityOptions {
124
+ /** A client from `createBetterAuthClient`, with the `passkey` and `twoFactor` features on. */
125
+ client: AccountSecurityClientInput;
126
+ /**
127
+ * The server's methods, when the app already loaded them with `useAuthMethods`. Otherwise the
128
+ * hook loads them. They decide which cards show.
129
+ */
130
+ methods?: BetterAuthMethods;
131
+ /**
132
+ * Where linking a provider returns: this security screen's route. In bearer mode it may be any
133
+ * page on one of the server's `oauthHandoff.webOrigins`.
134
+ */
135
+ callbackURL: string;
136
+ /** Where a failed link returns with `?error=`. Defaults to `callbackURL`. */
137
+ errorCallbackURL?: string;
138
+ /** The `?error=` this page was opened with after a link returned. Never displayed as is. */
139
+ linkError?: string | string[] | null;
140
+ /** Labels for providers without a brand, such as `{"mock-oidc": "Mock OIDC"}`. */
141
+ providerLabels?: Record<string, string>;
142
+ /**
143
+ * Whether this device can create passkeys. Defaults to whether WebAuthn is available on web.
144
+ */
145
+ passkeySupported?: boolean;
146
+ /** Minimum new-password length: the server's `minPasswordLength`. Defaults to Better Auth's 8. */
147
+ minPasswordLength?: number;
148
+ }
149
+
150
+ /** The `AccountSecurityScreen` props the hook fills in. */
151
+ export type AccountSecurityControllerScreenProps = Required<
152
+ Pick<AccountSecurityScreenProps, "isLoading" | "onRetry">
153
+ > &
154
+ Pick<
155
+ AccountSecurityScreenProps,
156
+ "error" | "linkedAccounts" | "password" | "passkeys" | "twoFactor" | "sessions"
157
+ >;
158
+
159
+ export interface AccountSecurity {
160
+ /** Spread into `AccountSecurityScreen`. A card's props are undefined when it is hidden. */
161
+ screenProps: AccountSecurityControllerScreenProps;
162
+ /** The server's methods; undefined while they load or after an error. */
163
+ methods: BetterAuthMethods | undefined;
164
+ /** The signed-in user, once the session loads. */
165
+ user: AccountSecurityUser | undefined;
166
+ /** Reloads every section. */
167
+ refetch: () => Promise<void>;
168
+ }
169
+
170
+ interface Section<Data> {
171
+ data: Data;
172
+ error?: string;
173
+ }
174
+
175
+ /** Shown when unlinking would leave the user without a way to sign in. */
176
+ export const LAST_SIGN_IN_METHOD_MESSAGE =
177
+ "You can't remove your only sign-in method. Add another one first.";
178
+
179
+ /** Shown when Better Auth needs a recent sign-in (`SESSION_NOT_FRESH`) for an action. */
180
+ export const SIGN_IN_AGAIN_MESSAGE = "Sign in again to manage this.";
181
+
182
+ /** Shown when the user has a credential row without a password and tries to change it. */
183
+ export const NO_PASSWORD_YET_MESSAGE = "You don't have a password yet. Set one below.";
184
+
185
+ const SESSION_NOT_FRESH_CODE = "SESSION_NOT_FRESH";
186
+ const CREDENTIAL_ACCOUNT_NOT_FOUND_CODE = "CREDENTIAL_ACCOUNT_NOT_FOUND";
187
+
188
+ const SIGNED_OUT_MESSAGE = "Sign in to manage your security settings.";
189
+ const LINK_FAILED_MESSAGE = "Couldn't link that account. Please try again.";
190
+
191
+ // What the security screen shows for a link's `?error=` return. URL text is never shown as is,
192
+ // because anyone can craft a link.
193
+ const LINK_ERROR_MESSAGES: Record<string, string> = {
194
+ account_already_linked_to_different_user: "That account is already linked to another user.",
195
+ email_does_not_match: "That account's email doesn't match the email on this account.",
196
+ LINKING_DISABLED: "This app does not link sign-in methods.",
197
+ };
198
+
199
+ /** The readable message of a `?error=` a link returned with. */
200
+ export const getLinkErrorMessage = (
201
+ code: string | string[] | null | undefined
202
+ ): string | undefined => {
203
+ const value = Array.isArray(code) ? code[0] : code;
204
+ if (!value) {
205
+ return undefined;
206
+ }
207
+ return getOwnEntry(LINK_ERROR_MESSAGES, value) ?? LINK_FAILED_MESSAGE;
208
+ };
209
+
210
+ /** Throws the Better Auth error, so the card that called shows its message. */
211
+ const unwrap = <Data>(
212
+ result: AccountSecurityClientResult<Data> | undefined,
213
+ fallback: string
214
+ ): Data | null | undefined => {
215
+ if (result?.error) {
216
+ // Better Auth asks for a recent sign-in before listing sessions, unlinking, or setting a
217
+ // password; its own message ("Session is not fresh") does not say what to do.
218
+ if (result.error.code === SESSION_NOT_FRESH_CODE) {
219
+ throw new Error(SIGN_IN_AGAIN_MESSAGE);
220
+ }
221
+ throw new Error(result.error.message || result.error.statusText || fallback);
222
+ }
223
+ return result?.data;
224
+ };
225
+
226
+ const messageOf = (error: unknown, fallback: string): string => {
227
+ if (error instanceof Error && error.message) {
228
+ return error.message;
229
+ }
230
+ return fallback;
231
+ };
232
+
233
+ const isWebAuthnAvailable = (): boolean => {
234
+ return (
235
+ IsWeb &&
236
+ typeof window !== "undefined" &&
237
+ typeof (window as {PublicKeyCredential?: unknown}).PublicKeyCredential !== "undefined"
238
+ );
239
+ };
240
+
241
+ const toLinkedAccount = (row: AccountSecurityAccountRow): LinkedAccount => ({
242
+ accountId: row.accountId,
243
+ id: row.id,
244
+ linkedAt: row.createdAt,
245
+ providerId: row.providerId,
246
+ });
247
+
248
+ const hasCredential = (accounts: LinkedAccount[]): boolean => {
249
+ return accounts.some((account) => account.providerId === "credential");
250
+ };
251
+
252
+ /**
253
+ * Drives an account security screen from a Better Auth client. See "Drop-in security screen" in
254
+ * docs/how-to/configure-better-auth.md.
255
+ *
256
+ * @example
257
+ * ```tsx
258
+ * const security = useAccountSecurity({client: authClient, callbackURL: "/security"});
259
+ * return <AccountSecurityScreen {...security.screenProps} />;
260
+ * ```
261
+ */
262
+ export const useAccountSecurity = ({
263
+ client: clientInput,
264
+ methods: methodsOption,
265
+ callbackURL,
266
+ errorCallbackURL,
267
+ linkError,
268
+ providerLabels,
269
+ passkeySupported,
270
+ minPasswordLength,
271
+ }: UseAccountSecurityOptions): AccountSecurity => {
272
+ const client = clientInput as AccountSecurityClient;
273
+ const loaded = useAuthMethods(client, {skip: Boolean(methodsOption)});
274
+ const methods = methodsOption ?? loaded.methods;
275
+
276
+ const [session, setSession] = useState<Section<AccountSecuritySessionData | undefined>>({
277
+ data: undefined,
278
+ });
279
+ const [accounts, setAccounts] = useState<Section<LinkedAccount[]>>({data: []});
280
+ const [passkeys, setPasskeys] = useState<Section<AccountPasskey[]>>({data: []});
281
+ const [sessions, setSessions] = useState<Section<AccountSession[]>>({data: []});
282
+ // False until the first load settles, so the cards never flash empty.
283
+ const [hasLoaded, setHasLoaded] = useState(false);
284
+ const [isCredentialWithoutPassword, setIsCredentialWithoutPassword] = useState(false);
285
+
286
+ const isPasskeyOn = Boolean(methods?.passkey && client.passkey && IsWeb);
287
+ const isTwoFactorOn = Boolean(methods?.twoFactor && client.twoFactor);
288
+
289
+ // Dropped once the screen unmounts, so a late response never sets state.
290
+ const isMounted = useRef(true);
291
+ // Mark the hook unmounted so late responses are ignored.
292
+ useEffect(() => {
293
+ isMounted.current = true;
294
+ return (): void => {
295
+ isMounted.current = false;
296
+ };
297
+ }, []);
298
+
299
+ // Each loader catches its own failure into its section, so one failed section never hides
300
+ // the others, and a refetch after a successful change never reports the change as failed.
301
+ const loadSession = useCallback(async (): Promise<void> => {
302
+ let next: Section<AccountSecuritySessionData | undefined>;
303
+ try {
304
+ // Read past the session cookie cache, which keeps a stale `twoFactorEnabled` for minutes.
305
+ const result = await client.getSession({query: {disableCookieCache: true}});
306
+ const data = unwrap(result, "Couldn't load your session.");
307
+ next = data?.session ? {data} : {data: undefined, error: SIGNED_OUT_MESSAGE};
308
+ } catch (error) {
309
+ next = {data: undefined, error: messageOf(error, "Couldn't load your session.")};
310
+ }
311
+ if (isMounted.current) {
312
+ setSession(next);
313
+ }
314
+ }, [client]);
315
+
316
+ const loadAccounts = useCallback(async (): Promise<void> => {
317
+ let next: Section<LinkedAccount[]>;
318
+ try {
319
+ const data = unwrap(await client.listAccounts(), "Couldn't load your sign-in methods.");
320
+ next = {data: (data ?? []).map(toLinkedAccount)};
321
+ } catch (error) {
322
+ next = {data: [], error: messageOf(error, "Couldn't load your sign-in methods.")};
323
+ }
324
+ if (isMounted.current) {
325
+ setAccounts((previous) => (next.error ? {...previous, error: next.error} : next));
326
+ }
327
+ }, [client]);
328
+
329
+ const loadPasskeys = useCallback(async (): Promise<void> => {
330
+ const passkey = client.passkey;
331
+ if (!passkey) {
332
+ return;
333
+ }
334
+ let next: Section<AccountPasskey[]>;
335
+ try {
336
+ const data = unwrap(await passkey.listUserPasskeys(), "Couldn't load your passkeys.");
337
+ next = {data: data ?? []};
338
+ } catch (error) {
339
+ next = {data: [], error: messageOf(error, "Couldn't load your passkeys.")};
340
+ }
341
+ if (isMounted.current) {
342
+ setPasskeys((previous) => (next.error ? {...previous, error: next.error} : next));
343
+ }
344
+ }, [client]);
345
+
346
+ const loadSessions = useCallback(async (): Promise<void> => {
347
+ let next: Section<AccountSession[]>;
348
+ try {
349
+ const data = unwrap(await client.listSessions(), "Couldn't load your sessions.");
350
+ next = {data: data ?? []};
351
+ } catch (error) {
352
+ next = {data: [], error: messageOf(error, "Couldn't load your sessions.")};
353
+ }
354
+ if (isMounted.current) {
355
+ setSessions((previous) => (next.error ? {...previous, error: next.error} : next));
356
+ }
357
+ }, [client]);
358
+
359
+ const loadAll = useCallback(async (): Promise<void> => {
360
+ setHasLoaded(false);
361
+ await Promise.all([
362
+ loadSession(),
363
+ loadAccounts(),
364
+ isPasskeyOn ? loadPasskeys() : null,
365
+ loadSessions(),
366
+ ]);
367
+ if (isMounted.current) {
368
+ setHasLoaded(true);
369
+ }
370
+ }, [isPasskeyOn, loadAccounts, loadPasskeys, loadSession, loadSessions]);
371
+
372
+ // Load every section once the server says which features are on.
373
+ useEffect(() => {
374
+ if (methods) {
375
+ void loadAll();
376
+ }
377
+ }, [loadAll, methods]);
378
+
379
+ const onRetry = useCallback((): void => {
380
+ if (!methods) {
381
+ loaded.refetch();
382
+ return;
383
+ }
384
+ void loadAll();
385
+ }, [loadAll, loaded, methods]);
386
+
387
+ const accountRows = accounts.data;
388
+ const passkeyRows = passkeys.data;
389
+ // Better Auth's account list does not say whether the credential row holds a password; a
390
+ // refused change (`CREDENTIAL_ACCOUNT_NOT_FOUND`) shows it does not.
391
+ const hasPassword = hasCredential(accountRows) && !isCredentialWithoutPassword;
392
+ const user = session.data?.user;
393
+
394
+ const onLink = useCallback(
395
+ async (provider: string): Promise<void> => {
396
+ const {error} = await linkSocialWithHandoff({
397
+ callbackURL,
398
+ // The client's $fetch is typed loosely here; linking calls only $fetch and linkSocial.
399
+ client: client as unknown as BetterAuthLinkClient,
400
+ provider,
401
+ ...(errorCallbackURL !== undefined ? {errorCallbackURL} : {}),
402
+ });
403
+ if (error) {
404
+ throw new Error(
405
+ (error.code ? getOwnEntry(LINK_ERROR_MESSAGES, error.code) : undefined) ??
406
+ error.message ??
407
+ LINK_FAILED_MESSAGE
408
+ );
409
+ }
410
+ // On web the page is on its way to the provider; on native the link has finished.
411
+ await loadAccounts();
412
+ },
413
+ [callbackURL, client, errorCallbackURL, loadAccounts]
414
+ );
415
+
416
+ const onUnlink = useCallback(
417
+ async (_providerId: string, account: LinkedAccount): Promise<void> => {
418
+ // Better Auth refuses to unlink the last account, and passkeys need an account to sign in
419
+ // again after a reset, so the only account is never sent to the server.
420
+ if (accountRows.length <= 1) {
421
+ throw new Error(LAST_SIGN_IN_METHOD_MESSAGE);
422
+ }
423
+ unwrap(await client.unlinkAccount({accountId: account.id}), "Couldn't unlink that account.");
424
+ await loadAccounts();
425
+ },
426
+ [accountRows.length, client, loadAccounts]
427
+ );
428
+
429
+ const onPasswordSubmit = useCallback(
430
+ async ({
431
+ mode,
432
+ currentPassword,
433
+ newPassword,
434
+ revokeOtherSessions,
435
+ }: PasswordCardSubmission): Promise<void> => {
436
+ if (mode === "change") {
437
+ const result = await client.changePassword({
438
+ currentPassword: currentPassword ?? "",
439
+ newPassword,
440
+ revokeOtherSessions,
441
+ });
442
+ if (result.error?.code === CREDENTIAL_ACCOUNT_NOT_FOUND_CODE) {
443
+ // The credential row has no password: switch the card to "Set a password".
444
+ setIsCredentialWithoutPassword(true);
445
+ throw new Error(NO_PASSWORD_YET_MESSAGE);
446
+ }
447
+ unwrap(result, "Couldn't change your password.");
448
+ // Revoking other sessions replaces the current one too.
449
+ if (revokeOtherSessions) {
450
+ await Promise.all([loadSession(), loadSessions()]);
451
+ }
452
+ return;
453
+ }
454
+ // Better Auth's own setPassword is server-only; Terreno's endpoint wraps it.
455
+ const result = await client.$fetch("/terreno/set-password", {
456
+ body: {newPassword},
457
+ method: "POST",
458
+ });
459
+ unwrap(result as AccountSecurityClientResult<unknown>, "Couldn't set your password.");
460
+ setIsCredentialWithoutPassword(false);
461
+ await loadAccounts();
462
+ },
463
+ [client, loadAccounts, loadSession, loadSessions]
464
+ );
465
+
466
+ const onAddPasskey = useCallback(
467
+ async (name?: string): Promise<void> => {
468
+ unwrap(
469
+ await client.passkey?.addPasskey(name ? {name} : undefined),
470
+ "Couldn't add a passkey."
471
+ );
472
+ await loadPasskeys();
473
+ },
474
+ [client, loadPasskeys]
475
+ );
476
+
477
+ const onRenamePasskey = useCallback(
478
+ async (id: string, name: string): Promise<void> => {
479
+ unwrap(await client.passkey?.updatePasskey({id, name}), "Couldn't rename that passkey.");
480
+ await loadPasskeys();
481
+ },
482
+ [client, loadPasskeys]
483
+ );
484
+
485
+ const onRemovePasskey = useCallback(
486
+ async (passkey: AccountPasskey): Promise<void> => {
487
+ if (accountRows.length + passkeyRows.length <= 1) {
488
+ throw new Error(LAST_SIGN_IN_METHOD_MESSAGE);
489
+ }
490
+ unwrap(
491
+ await client.passkey?.deletePasskey({id: passkey.id}),
492
+ "Couldn't remove that passkey."
493
+ );
494
+ await loadPasskeys();
495
+ },
496
+ [accountRows.length, client, loadPasskeys, passkeyRows.length]
497
+ );
498
+
499
+ const onStartEnroll = useCallback(
500
+ async (password?: string): Promise<TwoFactorEnrollment> => {
501
+ const data = unwrap(
502
+ await client.twoFactor?.enable({password: password ?? ""}),
503
+ "Couldn't start two-factor setup."
504
+ );
505
+ // `enable()` resolves `{method: "otp"}` or `{method: "totp", totpURI, backupCodes}`.
506
+ if (!data || !("totpURI" in data)) {
507
+ throw new Error("Couldn't start two-factor setup.");
508
+ }
509
+ const {backupCodes, totpURI} = data as {backupCodes?: string[]; totpURI: string};
510
+ return {backupCodes: backupCodes ?? [], totpURI};
511
+ },
512
+ [client]
513
+ );
514
+
515
+ const onVerifyTwoFactor = useCallback(
516
+ async (code: string): Promise<void> => {
517
+ unwrap(await client.twoFactor?.verifyTotp({code}), "That code didn't work.");
518
+ // Turning two-factor on replaces the current session.
519
+ await Promise.all([loadSession(), loadSessions()]);
520
+ },
521
+ [client, loadSession, loadSessions]
522
+ );
523
+
524
+ const onRegenerateBackupCodes = useCallback(
525
+ async (password?: string): Promise<string[]> => {
526
+ const data = unwrap(
527
+ await client.twoFactor?.generateBackupCodes({password: password ?? ""}),
528
+ "Couldn't create new backup codes."
529
+ );
530
+ return data?.backupCodes ?? [];
531
+ },
532
+ [client]
533
+ );
534
+
535
+ const onDisableTwoFactor = useCallback(
536
+ async (password?: string): Promise<void> => {
537
+ unwrap(
538
+ await client.twoFactor?.disable({password: password ?? ""}),
539
+ "Couldn't turn off two-factor authentication."
540
+ );
541
+ // Turning two-factor off replaces the current session.
542
+ await Promise.all([loadSession(), loadSessions()]);
543
+ },
544
+ [client, loadSession, loadSessions]
545
+ );
546
+
547
+ const onRevokeSession = useCallback(
548
+ async (revoked: AccountSession): Promise<void> => {
549
+ if (!revoked.token) {
550
+ throw new Error("Couldn't sign out that session.");
551
+ }
552
+ unwrap(await client.revokeSession({token: revoked.token}), "Couldn't sign out that session.");
553
+ await loadSessions();
554
+ },
555
+ [client, loadSessions]
556
+ );
557
+
558
+ const onRevokeOtherSessions = useCallback(async (): Promise<void> => {
559
+ unwrap(await client.revokeOtherSessions(), "Couldn't sign out your other sessions.");
560
+ await loadSessions();
561
+ }, [client, loadSessions]);
562
+
563
+ const linkErrorMessage = getLinkErrorMessage(linkError);
564
+
565
+ const linkedAccountsProps = useMemo((): LinkedAccountsCardProps | undefined => {
566
+ if (!methods || methods.providers.length === 0) {
567
+ return undefined;
568
+ }
569
+ return {
570
+ accounts: accountRows,
571
+ error: accounts.error ?? linkErrorMessage,
572
+ // With linking off, the card lists linked providers but offers no Link button.
573
+ ...(methods.accountLinking.mode === "never" ? {} : {onLink}),
574
+ onUnlink,
575
+ providers: methods.providers.map((id) => {
576
+ const label = getOwnEntry(providerLabels, id);
577
+ return {id, ...(label ? {label} : {})};
578
+ }),
579
+ };
580
+ }, [accountRows, accounts.error, linkErrorMessage, methods, onLink, onUnlink, providerLabels]);
581
+
582
+ const passwordProps = useMemo((): PasswordCardProps | undefined => {
583
+ if (!methods?.emailPassword) {
584
+ return undefined;
585
+ }
586
+ return {
587
+ hasPassword,
588
+ onSubmit: onPasswordSubmit,
589
+ ...(minPasswordLength !== undefined ? {minLength: minPasswordLength} : {}),
590
+ ...(user?.email ? {username: user.email} : {}),
591
+ };
592
+ }, [hasPassword, methods?.emailPassword, minPasswordLength, onPasswordSubmit, user?.email]);
593
+
594
+ const passkeysProps = useMemo((): PasskeysCardProps | undefined => {
595
+ if (!isPasskeyOn) {
596
+ return undefined;
597
+ }
598
+ return {
599
+ error: passkeys.error,
600
+ onAdd: onAddPasskey,
601
+ onRemove: onRemovePasskey,
602
+ onRename: onRenamePasskey,
603
+ passkeys: passkeyRows,
604
+ supported: passkeySupported ?? isWebAuthnAvailable(),
605
+ };
606
+ }, [
607
+ isPasskeyOn,
608
+ onAddPasskey,
609
+ onRemovePasskey,
610
+ onRenamePasskey,
611
+ passkeyRows,
612
+ passkeySupported,
613
+ passkeys.error,
614
+ ]);
615
+
616
+ const twoFactorProps = useMemo((): TwoFactorSettingsCardProps | undefined => {
617
+ if (!isTwoFactorOn) {
618
+ return undefined;
619
+ }
620
+ return {
621
+ enabled: Boolean(user?.twoFactorEnabled),
622
+ hasPassword,
623
+ onDisable: onDisableTwoFactor,
624
+ onRegenerateBackupCodes,
625
+ onStartEnroll,
626
+ onVerify: onVerifyTwoFactor,
627
+ ...(user?.email ? {username: user.email} : {}),
628
+ };
629
+ }, [
630
+ hasPassword,
631
+ isTwoFactorOn,
632
+ onDisableTwoFactor,
633
+ onRegenerateBackupCodes,
634
+ onStartEnroll,
635
+ onVerifyTwoFactor,
636
+ user?.email,
637
+ user?.twoFactorEnabled,
638
+ ]);
639
+
640
+ const sessionsProps = useMemo((): SessionsCardProps | undefined => {
641
+ if (!methods) {
642
+ return undefined;
643
+ }
644
+ return {
645
+ currentSessionId: session.data?.session.id,
646
+ error: sessions.error,
647
+ onRevoke: onRevokeSession,
648
+ onRevokeOthers: onRevokeOtherSessions,
649
+ sessions: sessions.data,
650
+ };
651
+ }, [
652
+ methods,
653
+ onRevokeOtherSessions,
654
+ onRevokeSession,
655
+ session.data?.session.id,
656
+ sessions.data,
657
+ sessions.error,
658
+ ]);
659
+
660
+ const isLoading = loaded.isLoading || (Boolean(methods) && !hasLoaded);
661
+ const error = methods ? session.error : loaded.error;
662
+
663
+ return {
664
+ methods,
665
+ refetch: loadAll,
666
+ screenProps: {
667
+ error,
668
+ isLoading,
669
+ linkedAccounts: linkedAccountsProps,
670
+ onRetry,
671
+ passkeys: passkeysProps,
672
+ password: passwordProps,
673
+ sessions: sessionsProps,
674
+ twoFactor: twoFactorProps,
675
+ },
676
+ user,
677
+ };
678
+ };
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Type-level tests: the clients createBetterAuthClient returns satisfy AccountSecurityClient, so
3
+ * apps pass their client to useAccountSecurity and TerrenoAccountSecurityScreen without a cast.
4
+ * `bun run compile` checks this file through tsconfig.typetests.json.
5
+ */
6
+ import {describe, expect, it} from "bun:test";
7
+
8
+ import type {BetterAuthClientWithFeatures} from "./betterAuthClient";
9
+ import type {AccountSecurityClient} from "./useAccountSecurity";
10
+
11
+ // Each helper is only type-checked; none of them runs.
12
+ const typeChecks = {
13
+ allFeatures: (
14
+ client: BetterAuthClientWithFeatures<{multiSession: true; passkey: true; twoFactor: true}>
15
+ ): AccountSecurityClient => client,
16
+ // A client that cannot list sessions is not a security client.
17
+ missingSessions: (client: Omit<AccountSecurityClient, "listSessions">): AccountSecurityClient =>
18
+ // @ts-expect-error listSessions is required
19
+ client,
20
+ someFeatures: (client: BetterAuthClientWithFeatures<{twoFactor: true}>): AccountSecurityClient =>
21
+ client,
22
+ };
23
+
24
+ describe("AccountSecurityClient types", () => {
25
+ it("accepts typed clients createBetterAuthClient returns and rejects incomplete ones", () => {
26
+ expect(Object.keys(typeChecks)).toEqual(["allFeatures", "missingSessions", "someFeatures"]);
27
+ });
28
+ });