@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,197 @@
1
+ /**
2
+ * Type-level tests for createBetterAuthClient's `features` option. `bun run compile` checks this
3
+ * file through tsconfig.typetests.json; every `@ts-expect-error` line fails the compile if the
4
+ * error it expects goes away. Only types are imported, so the runtime test loads nothing.
5
+ */
6
+ import {describe, expect, it} from "bun:test";
7
+ import type {createAuthClient, ReactAuthClient} from "better-auth/react";
8
+ import type {
9
+ BetterAuthClient,
10
+ BetterAuthClientWithFeatures,
11
+ BetterAuthHandoffClient,
12
+ completeBetterAuthOAuthHandoff,
13
+ createBetterAuthClient,
14
+ ExpoAuthClientPlugin,
15
+ signInSocialWithHandoff,
16
+ } from "./betterAuthClient";
17
+ import type {
18
+ BetterAuthClientConfig,
19
+ BetterAuthClientFeatures,
20
+ BetterAuthOAuthProvider,
21
+ } from "./betterAuthTypes";
22
+ import type {createSessionStore} from "./session";
23
+
24
+ type Create = typeof createBetterAuthClient;
25
+
26
+ // Exact type equality: mutual assignability is too loose for client types that contain `any`.
27
+ type Equals<A, B> =
28
+ (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2 ? true : false;
29
+
30
+ // createBetterAuthClient's return type before `features` existed.
31
+ type ClientBeforeFeatures = ReactAuthClient<{
32
+ baseURL: string;
33
+ fetchOptions?: NonNullable<Parameters<typeof createAuthClient>[0]>["fetchOptions"];
34
+ plugins: [ExpoAuthClientPlugin];
35
+ }>;
36
+
37
+ // Each helper is only type-checked; none of them runs.
38
+ const typeChecks = {
39
+ // Every feature on: each namespace is typed, with its request bodies checked.
40
+ allFeatures: (create: Create): void => {
41
+ const client = create({
42
+ baseURL: "http://localhost:4000",
43
+ features: {
44
+ lastLoginMethod: true,
45
+ multiSession: true,
46
+ oneTimeToken: true,
47
+ passkey: true,
48
+ twoFactor: {
49
+ onTwoFactorRedirect: ({twoFactorMethods}): void => {
50
+ void twoFactorMethods?.includes("totp");
51
+ },
52
+ },
53
+ },
54
+ scheme: "terreno",
55
+ });
56
+ void client.twoFactor.enable({password: "secret"});
57
+ void client.twoFactor.verifyTotp({code: "123456"});
58
+ void client.twoFactor.verifyBackupCode({code: "abcde-12345"});
59
+ // @ts-expect-error verifyTotp requires a code
60
+ void client.twoFactor.verifyTotp({});
61
+ void client.passkey.addPasskey({name: "Laptop"});
62
+ void client.passkey.listUserPasskeys();
63
+ void client.signIn.passkey();
64
+ void client.multiSession.listDeviceSessions();
65
+ void client.multiSession.setActive({sessionToken: "token"});
66
+ void client.oneTimeToken.verify({token: "token"});
67
+ const lastMethod: string | null = client.getLastUsedLoginMethod();
68
+ void lastMethod;
69
+ // Social sign-in and the session stay typed alongside the features.
70
+ void client.signIn.social({provider: "github"});
71
+ void client.signIn.social({provider: "mock-oidc"});
72
+ void client.getSession();
73
+ },
74
+ // Existing apps: no `features` keeps today's return type exactly.
75
+ defaultClient: (create: Create): void => {
76
+ const client = create({baseURL: "http://localhost:4000", scheme: "terreno"});
77
+ const unchanged: Equals<typeof client, ClientBeforeFeatures> = true;
78
+ const sameAsAlias: Equals<typeof client, BetterAuthClient> = true;
79
+ void unchanged;
80
+ void sameAsAlias;
81
+ void client.signIn.social({provider: "google"});
82
+ void client.getSession();
83
+ },
84
+
85
+ // Features that are off (or omitted) add nothing.
86
+ disabledFeatures: (create: Create): void => {
87
+ const client = create({
88
+ baseURL: "http://localhost:4000",
89
+ features: {multiSession: false, twoFactor: false},
90
+ scheme: "terreno",
91
+ });
92
+ // @ts-expect-error twoFactor: false adds no namespace
93
+ void client.twoFactor;
94
+ // @ts-expect-error multiSession: false adds no namespace
95
+ void client.multiSession;
96
+ },
97
+
98
+ // The exported feature client type names the same client createBetterAuthClient returns.
99
+ featureClientAlias: (create: Create): void => {
100
+ const client = create({
101
+ baseURL: "http://localhost:4000",
102
+ features: {twoFactor: true},
103
+ scheme: "terreno",
104
+ });
105
+ const named: Equals<
106
+ typeof client,
107
+ BetterAuthClientWithFeatures<{readonly twoFactor: true}>
108
+ > = true;
109
+ void named;
110
+ },
111
+
112
+ // Generic OAuth providers are accepted wherever a provider is named.
113
+ genericProviders: (): void => {
114
+ const provider: BetterAuthOAuthProvider = "mock-oidc";
115
+ const branded: BetterAuthOAuthProvider = "google";
116
+ void provider;
117
+ void branded;
118
+ },
119
+
120
+ // Clients with and without features work with the OAuth handoff helpers.
121
+ helpersAcceptFeatureClients: (
122
+ create: Create,
123
+ signIn: typeof signInSocialWithHandoff,
124
+ complete: typeof completeBetterAuthOAuthHandoff
125
+ ): void => {
126
+ const client = create({
127
+ baseURL: "http://localhost:4000",
128
+ features: {multiSession: true, passkey: true, twoFactor: true},
129
+ scheme: "terreno",
130
+ webAuth: "bearer",
131
+ });
132
+ const handoffClient: BetterAuthHandoffClient = client;
133
+ void complete({client: handoffClient});
134
+ signIn({client, provider: "mock-oidc"});
135
+ const plain = create({baseURL: "http://localhost:4000", scheme: "terreno", webAuth: "bearer"});
136
+ signIn({client: plain, provider: "google"});
137
+ void complete({client: plain});
138
+ },
139
+
140
+ // Turning one feature on types only that namespace.
141
+ oneFeature: (create: Create): void => {
142
+ const client = create({
143
+ baseURL: "http://localhost:4000",
144
+ features: {passkey: true},
145
+ scheme: "terreno",
146
+ });
147
+ void client.passkey.addPasskey();
148
+ // @ts-expect-error twoFactor is off
149
+ void client.twoFactor;
150
+ },
151
+
152
+ // A config typed as BetterAuthClientConfig does not know its features, so the client is the
153
+ // untyped BetterAuthClient rather than one claiming every namespace.
154
+ preTypedConfig: (create: Create, config: BetterAuthClientConfig): void => {
155
+ const client = create(config);
156
+ const untyped: Equals<typeof client, BetterAuthClient> = true;
157
+ void untyped;
158
+ },
159
+ // ReturnType of the factory is still the client it returned before features existed.
160
+ returnTypeUnchanged: (): void => {
161
+ const unchanged: Equals<ReturnType<Create>, ClientBeforeFeatures> = true;
162
+ const sameAsAlias: Equals<ReturnType<Create>, BetterAuthClient> = true;
163
+ void unchanged;
164
+ void sameAsAlias;
165
+ },
166
+
167
+ // A client with features plugs into the session store like any other.
168
+ sessionStoreAcceptsFeatureClients: (create: Create, store: typeof createSessionStore): void => {
169
+ const authClient = create({
170
+ baseURL: "http://localhost:4000",
171
+ features: {lastLoginMethod: true, multiSession: true, passkey: true, twoFactor: true},
172
+ scheme: "terreno",
173
+ });
174
+ store({authClient});
175
+ },
176
+
177
+ // A wrapper that forwards features it does not know gets the untyped client too.
178
+ wrapper: (create: Create): void => {
179
+ const createAppClient = (features?: BetterAuthClientFeatures): BetterAuthClient =>
180
+ create({baseURL: "http://localhost:4000", features, scheme: "terreno"});
181
+ const client = createAppClient({twoFactor: true});
182
+ const forwarded = create({
183
+ baseURL: "http://localhost:4000",
184
+ features: {} as BetterAuthClientFeatures,
185
+ scheme: "terreno",
186
+ });
187
+ const untyped: Equals<typeof forwarded, BetterAuthClient> = true;
188
+ void client;
189
+ void untyped;
190
+ },
191
+ };
192
+
193
+ describe("createBetterAuthClient types", () => {
194
+ it("are checked by the compile step", () => {
195
+ expect(Object.keys(typeChecks).length).toBeGreaterThan(0);
196
+ });
197
+ });
@@ -0,0 +1,114 @@
1
+ import {afterEach, beforeEach, describe, expect, it} from "bun:test";
2
+
3
+ import {
4
+ bearerTokenKey,
5
+ getBetterAuthBearerToken,
6
+ getBetterAuthClientWebAuth,
7
+ handoffClients,
8
+ resolveBearerStorage,
9
+ } from "./betterAuthClientRegistry";
10
+ import type {BetterAuthBearerStorage} from "./betterAuthTypes";
11
+
12
+ const memoryStorage = (): BetterAuthBearerStorage & {items: Map<string, string>} => {
13
+ const items = new Map<string, string>();
14
+ return {
15
+ getItem: (key: string): string | null => items.get(key) ?? null,
16
+ items,
17
+ removeItem: (key: string): void => {
18
+ items.delete(key);
19
+ },
20
+ setItem: (key: string, value: string): void => {
21
+ items.set(key, value);
22
+ },
23
+ };
24
+ };
25
+
26
+ describe("resolveBearerStorage", () => {
27
+ const globalWithWindow = globalThis as {window?: unknown};
28
+ let hadWindow: boolean;
29
+ let originalWindow: unknown;
30
+
31
+ beforeEach(() => {
32
+ hadWindow = "window" in globalWithWindow;
33
+ originalWindow = globalWithWindow.window;
34
+ });
35
+
36
+ afterEach(() => {
37
+ if (hadWindow) {
38
+ globalWithWindow.window = originalWindow;
39
+ } else {
40
+ delete globalWithWindow.window;
41
+ }
42
+ });
43
+
44
+ it("uses the storage the caller passed over localStorage", () => {
45
+ const passed = memoryStorage();
46
+ globalWithWindow.window = {localStorage: memoryStorage()};
47
+
48
+ expect(resolveBearerStorage(passed)).toBe(passed);
49
+ });
50
+
51
+ it("keeps the signed-out fallback empty when there is no window (SSR)", () => {
52
+ delete globalWithWindow.window;
53
+ const storage = resolveBearerStorage();
54
+ const key = bearerTokenKey();
55
+
56
+ storage.setItem(key, "token-1");
57
+ expect(storage.getItem(key)).toBeNull();
58
+ expect(() => storage.removeItem(key)).not.toThrow();
59
+ expect(getBetterAuthBearerToken()).toBeNull();
60
+ });
61
+
62
+ it("falls back to signed-out storage when the browser blocks localStorage", () => {
63
+ globalWithWindow.window = {
64
+ get localStorage(): never {
65
+ throw new Error("SecurityError: storage is blocked");
66
+ },
67
+ };
68
+ const storage = resolveBearerStorage();
69
+ const key = bearerTokenKey("blocked");
70
+
71
+ storage.setItem(key, "token-2");
72
+ expect(storage.getItem(key)).toBeNull();
73
+ expect(() => storage.removeItem(key)).not.toThrow();
74
+ });
75
+
76
+ it("falls back when window exists without localStorage", () => {
77
+ globalWithWindow.window = {};
78
+
79
+ expect(resolveBearerStorage().getItem(bearerTokenKey())).toBeNull();
80
+ });
81
+ });
82
+
83
+ describe("getBetterAuthClientWebAuth", () => {
84
+ it("reports bearer mode with the stored token for a registered web bearer client", () => {
85
+ const bearerStorage = memoryStorage();
86
+ bearerStorage.setItem(bearerTokenKey("registry"), "token-3");
87
+ const client = {};
88
+ handoffClients.set(client, {
89
+ authBaseURL: "http://api.test/api/auth",
90
+ bearerStorage,
91
+ isWebBearer: true,
92
+ storagePrefix: "registry",
93
+ });
94
+
95
+ expect(getBetterAuthClientWebAuth(client)).toEqual({
96
+ bearerToken: "token-3",
97
+ webAuth: "bearer",
98
+ });
99
+
100
+ bearerStorage.removeItem(bearerTokenKey("registry"));
101
+ expect(getBetterAuthClientWebAuth(client)).toEqual({bearerToken: null, webAuth: "bearer"});
102
+ });
103
+
104
+ it("reports cookie mode for a registered client that is not web bearer", () => {
105
+ const client = {};
106
+ handoffClients.set(client, {
107
+ authBaseURL: "http://api.test/api/auth",
108
+ isWebBearer: false,
109
+ storagePrefix: "registry",
110
+ });
111
+
112
+ expect(getBetterAuthClientWebAuth(client)).toEqual({bearerToken: null, webAuth: "cookie"});
113
+ });
114
+ });
@@ -0,0 +1,99 @@
1
+ /**
2
+ * What `createBetterAuthClient` records about each client it makes (web bearer mode, storage), and
3
+ * the reads built on it. Kept apart from betterAuthClient.ts, which loads the Expo plugin and other
4
+ * native modules, so the Redux slice can ask how a client authenticates without loading them.
5
+ */
6
+ import type {BetterAuthBearerStorage, BetterAuthWebAuth} from "./betterAuthTypes";
7
+
8
+ /** @internal Storage key prefix when `createBetterAuthClient` is given none. */
9
+ export const DEFAULT_STORAGE_PREFIX = "terreno";
10
+
11
+ // Signed-out fallback for environments with no usable localStorage (SSR, blocked storage).
12
+ const NO_BEARER_STORAGE: BetterAuthBearerStorage = {
13
+ getItem: () => null,
14
+ removeItem: () => {},
15
+ setItem: () => {},
16
+ };
17
+
18
+ /** @internal */
19
+ export const resolveBearerStorage = (
20
+ bearerStorage?: BetterAuthBearerStorage
21
+ ): BetterAuthBearerStorage => {
22
+ if (bearerStorage) {
23
+ return bearerStorage;
24
+ }
25
+ if (typeof window === "undefined") {
26
+ return NO_BEARER_STORAGE;
27
+ }
28
+ try {
29
+ // Reading `window.localStorage` throws when the browser blocks site storage.
30
+ return window.localStorage ?? NO_BEARER_STORAGE;
31
+ } catch {
32
+ return NO_BEARER_STORAGE;
33
+ }
34
+ };
35
+
36
+ /** @internal */
37
+ export const bearerTokenKey = (storagePrefix?: string): string => {
38
+ return `${storagePrefix ?? DEFAULT_STORAGE_PREFIX}_bearer_token`;
39
+ };
40
+
41
+ /**
42
+ * Reads the bearer token that `createBetterAuthClient({webAuth: "bearer"})` stored, without a
43
+ * network call. Pass the same `storagePrefix` and `bearerStorage` the client was created with.
44
+ * Returns `null` when signed out or when no storage is available.
45
+ *
46
+ * @example
47
+ * ```typescript
48
+ * const token = getBetterAuthBearerToken({storagePrefix: "myapp"});
49
+ * ```
50
+ */
51
+ export const getBetterAuthBearerToken = ({
52
+ bearerStorage,
53
+ storagePrefix,
54
+ }: {
55
+ bearerStorage?: BetterAuthBearerStorage;
56
+ storagePrefix?: string;
57
+ } = {}): string | null => {
58
+ return resolveBearerStorage(bearerStorage).getItem(bearerTokenKey(storagePrefix));
59
+ };
60
+
61
+ /**
62
+ * How a client `createBetterAuthClient` made authenticates on web, and, in bearer mode, the token
63
+ * it holds. Returns `{webAuth: "cookie", bearerToken: null}` on native (the Expo plugin keeps the
64
+ * session there), in cookie mode, and for a client this factory did not make. Makes no request.
65
+ *
66
+ * @example
67
+ * ```typescript
68
+ * const {webAuth, bearerToken} = getBetterAuthClientWebAuth(authClient);
69
+ * ```
70
+ */
71
+ export const getBetterAuthClientWebAuth = (
72
+ client: object
73
+ ): {webAuth: BetterAuthWebAuth; bearerToken: string | null} => {
74
+ const config = handoffClients.get(client);
75
+ if (!config?.isWebBearer) {
76
+ return {bearerToken: null, webAuth: "cookie"};
77
+ }
78
+ return {
79
+ bearerToken: getBetterAuthBearerToken({
80
+ bearerStorage: config.bearerStorage,
81
+ storagePrefix: config.storagePrefix,
82
+ }),
83
+ webAuth: "bearer",
84
+ };
85
+ };
86
+
87
+ /** What the OAuth handoff needs to know about a client `createBetterAuthClient` made. */
88
+ export interface HandoffClientConfig {
89
+ /** Better Auth's base URL with its path, as the client resolved it, without a trailing slash. */
90
+ authBaseURL: string;
91
+ bearerStorage?: BetterAuthBearerStorage;
92
+ isWebBearer: boolean;
93
+ storagePrefix: string;
94
+ }
95
+
96
+ // Keyed by the client itself: Better Auth's client is a route proxy, so nothing can be added to
97
+ // it, and bearer mode only exists on clients this factory made.
98
+ /** @internal */
99
+ export const handoffClients = new WeakMap<object, HandoffClientConfig>();
@@ -0,0 +1,189 @@
1
+ /**
2
+ * Better Auth types shared by the session store, `SessionProvider`, and app code.
3
+ *
4
+ * Type-only module: importing it never loads Better Auth, Expo, or React Native.
5
+ */
6
+
7
+ /**
8
+ * What Better Auth hands `onTwoFactorRedirect` when a sign-in needs a second factor.
9
+ */
10
+ export interface BetterAuthTwoFactorRedirectContext {
11
+ /** The user's enabled second factors, such as `["totp", "otp"]`. */
12
+ twoFactorMethods?: string[];
13
+ }
14
+
15
+ /**
16
+ * Options for `features.twoFactor`.
17
+ */
18
+ export interface BetterAuthTwoFactorFeature {
19
+ /**
20
+ * Called when a sign-in answers `twoFactorRedirect` instead of a session. Show the 2FA
21
+ * challenge here; on native the challenge cookie is already stored when it runs.
22
+ */
23
+ onTwoFactorRedirect?: (context: BetterAuthTwoFactorRedirectContext) => void | Promise<void>;
24
+ }
25
+
26
+ /**
27
+ * Better Auth client plugins `createBetterAuthClient` adds, matching the server features
28
+ * `BetterAuthConfig` turns on. Each enabled feature adds its typed namespace to the client.
29
+ */
30
+ export interface BetterAuthClientFeatures {
31
+ /**
32
+ * `twoFactorClient`: `client.twoFactor.*` (enable, disable, getTotpUri, verifyTotp, sendOtp,
33
+ * verifyOtp, generateBackupCodes, verifyBackupCode). Pass an object to set
34
+ * `onTwoFactorRedirect`.
35
+ */
36
+ twoFactor?: boolean | BetterAuthTwoFactorFeature;
37
+ /**
38
+ * `passkeyClient` from `@better-auth/passkey/client`: `client.passkey.*` (addPasskey,
39
+ * listUserPasskeys, deletePasskey, updatePasskey) and `client.signIn.passkey`. WebAuthn needs
40
+ * a browser, so passkey calls work on web only.
41
+ */
42
+ passkey?: boolean;
43
+ /**
44
+ * `multiSessionClient`: `client.multiSession.*` (listDeviceSessions, setActive, revoke).
45
+ */
46
+ multiSession?: boolean;
47
+ /**
48
+ * `lastLoginMethodClient`: `client.getLastUsedLoginMethod()`,
49
+ * `client.isLastUsedLoginMethod(method)` and `client.clearLastUsedLoginMethod()`. They read
50
+ * the server's `last_used_login_method` cookie, so they return null on native and when the
51
+ * API is on another site.
52
+ */
53
+ lastLoginMethod?: boolean;
54
+ /**
55
+ * `oneTimeTokenClient`: `client.oneTimeToken.generate` and `client.oneTimeToken.verify`.
56
+ * The OAuth handoff verifies its token without this plugin.
57
+ */
58
+ oneTimeToken?: boolean;
59
+ }
60
+
61
+ /**
62
+ * Configuration options for the Better Auth client.
63
+ */
64
+ export interface BetterAuthClientConfig<
65
+ Features extends BetterAuthClientFeatures = BetterAuthClientFeatures,
66
+ > {
67
+ /**
68
+ * Base URL of the auth server (e.g., "http://localhost:3000").
69
+ */
70
+ baseURL: string;
71
+
72
+ /**
73
+ * App URL scheme for deep linking (e.g., "terreno").
74
+ */
75
+ scheme: string;
76
+
77
+ /**
78
+ * Storage key prefix for auth tokens.
79
+ * @default "terreno"
80
+ */
81
+ storagePrefix?: string;
82
+
83
+ /**
84
+ * How the web client authenticates to the auth server. Native ignores it: the Expo plugin
85
+ * already keeps the session without browser cookies.
86
+ *
87
+ * - `"cookie"` (default): the browser sends Better Auth's HttpOnly session cookie. Use it
88
+ * when the frontend and API share a site.
89
+ * - `"bearer"`: the client stores the `set-auth-token` header from the server's bearer
90
+ * plugin, sends `Authorization: Bearer` on every Better Auth call, and sends no cookies
91
+ * (`credentials: "omit"`). Use it when the frontend and API are on different sites, where
92
+ * browsers block or partition third-party cookies.
93
+ * @default "cookie"
94
+ */
95
+ webAuth?: BetterAuthWebAuth;
96
+
97
+ /**
98
+ * Where `webAuth: "bearer"` keeps the token, under the key `${storagePrefix}_bearer_token`.
99
+ * Pass `window.sessionStorage` on shared devices so the token ends with the browser session.
100
+ * @default window.localStorage
101
+ */
102
+ bearerStorage?: BetterAuthBearerStorage;
103
+
104
+ /**
105
+ * Client plugins for the Better Auth features the server enables. Omit it and the client is
106
+ * exactly what it was before features existed.
107
+ *
108
+ * @example
109
+ * ```typescript
110
+ * createBetterAuthClient({
111
+ * baseURL,
112
+ * features: {multiSession: true, passkey: true, twoFactor: {onTwoFactorRedirect}},
113
+ * scheme: "myapp",
114
+ * });
115
+ * ```
116
+ */
117
+ features?: Features;
118
+ }
119
+
120
+ /**
121
+ * Web authentication modes for `createBetterAuthClient`.
122
+ */
123
+ export type BetterAuthWebAuth = "cookie" | "bearer";
124
+
125
+ /**
126
+ * Synchronous key-value storage for the web bearer token. `window.localStorage` and
127
+ * `window.sessionStorage` both satisfy it.
128
+ */
129
+ export interface BetterAuthBearerStorage {
130
+ getItem: (key: string) => string | null;
131
+ removeItem: (key: string) => void;
132
+ setItem: (key: string, value: string) => void;
133
+ }
134
+
135
+ /**
136
+ * User data from Better Auth session.
137
+ */
138
+ export interface BetterAuthUser {
139
+ id: string;
140
+ email: string;
141
+ name: string | null;
142
+ image: string | null;
143
+ emailVerified: boolean;
144
+ createdAt: Date;
145
+ updatedAt: Date;
146
+ }
147
+
148
+ /**
149
+ * Session data from Better Auth.
150
+ */
151
+ export interface BetterAuthSession {
152
+ id: string;
153
+ userId: string;
154
+ expiresAt: Date;
155
+ ipAddress: string | null;
156
+ userAgent: string | null;
157
+ createdAt: Date;
158
+ updatedAt: Date;
159
+ }
160
+
161
+ /**
162
+ * Combined session and user data from Better Auth.
163
+ */
164
+ export interface BetterAuthSessionData {
165
+ session: BetterAuthSession;
166
+ user: BetterAuthUser;
167
+ }
168
+
169
+ /**
170
+ * OAuth provider ids: the branded ones Better Auth knows, or any generic OAuth provider id the
171
+ * server registers (such as `"mock-oidc"`).
172
+ */
173
+ export type BetterAuthOAuthProvider = "google" | "github" | "apple" | (string & {});
174
+
175
+ /**
176
+ * Minimal Better Auth client surface the session store needs: read the session, sign out,
177
+ * and (optionally) the nanostore session atom that pushes changes. The client returned by
178
+ * `createBetterAuthClient` satisfies it; tests can pass a plain object.
179
+ *
180
+ * `useSession` and `$store` are typed `unknown` because the React client exposes
181
+ * `useSession` as a hook and the atom under `$store.atoms.session`, while nanostore-style
182
+ * wrappers expose `useSession.subscribe` — the session source probes both at runtime.
183
+ */
184
+ export interface BetterAuthSessionClientLike {
185
+ getSession: () => Promise<unknown>;
186
+ signOut: () => Promise<unknown>;
187
+ useSession?: unknown;
188
+ $store?: unknown;
189
+ }