@terreno/ui 57.18.0 → 57.20.0

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 (361) hide show
  1. package/.ai/guidelines/core.md +1 -1
  2. package/CHANGELOG.md +2074 -0
  3. package/dist/Accordion.d.ts.map +1 -1
  4. package/dist/Accordion.js +3 -3
  5. package/dist/Accordion.js.map +1 -1
  6. package/dist/AreaChart.d.ts.map +1 -1
  7. package/dist/AreaChart.js +2 -2
  8. package/dist/AreaChart.js.map +1 -1
  9. package/dist/Avatar.d.ts.map +1 -1
  10. package/dist/Avatar.js +3 -1
  11. package/dist/Avatar.js.map +1 -1
  12. package/dist/BarChart.d.ts.map +1 -1
  13. package/dist/BarChart.js +2 -2
  14. package/dist/BarChart.js.map +1 -1
  15. package/dist/Box.d.ts.map +1 -1
  16. package/dist/Box.js +66 -8
  17. package/dist/Box.js.map +1 -1
  18. package/dist/Card.d.ts.map +1 -1
  19. package/dist/Card.js +5 -4
  20. package/dist/Card.js.map +1 -1
  21. package/dist/ChartCard.d.ts.map +1 -1
  22. package/dist/ChartCard.js +4 -2
  23. package/dist/ChartCard.js.map +1 -1
  24. package/dist/Common.d.ts +240 -14
  25. package/dist/Common.d.ts.map +1 -1
  26. package/dist/Common.js.map +1 -1
  27. package/dist/ConsentFormScreen.d.ts +1 -1
  28. package/dist/ConsentFormScreen.d.ts.map +1 -1
  29. package/dist/ConsentFormScreen.js +13 -4
  30. package/dist/ConsentFormScreen.js.map +1 -1
  31. package/dist/DateTimeField.d.ts.map +1 -1
  32. package/dist/DateTimeField.js +5 -3
  33. package/dist/DateTimeField.js.map +1 -1
  34. package/dist/DonutChart.d.ts.map +1 -1
  35. package/dist/DonutChart.js +2 -2
  36. package/dist/DonutChart.js.map +1 -1
  37. package/dist/Field.d.ts.map +1 -1
  38. package/dist/Field.js +2 -0
  39. package/dist/Field.js.map +1 -1
  40. package/dist/FormContainer.d.ts +68 -0
  41. package/dist/FormContainer.d.ts.map +1 -0
  42. package/dist/FormContainer.js +79 -0
  43. package/dist/FormContainer.js.map +1 -0
  44. package/dist/GPTChat.d.ts.map +1 -1
  45. package/dist/GPTChat.js +2 -1
  46. package/dist/GPTChat.js.map +1 -1
  47. package/dist/Heading.d.ts +1 -1
  48. package/dist/Heading.d.ts.map +1 -1
  49. package/dist/Heading.js +5 -2
  50. package/dist/Heading.js.map +1 -1
  51. package/dist/Icon.d.ts +4 -0
  52. package/dist/Icon.d.ts.map +1 -1
  53. package/dist/Icon.js +43 -2
  54. package/dist/Icon.js.map +1 -1
  55. package/dist/LabeledCheckBox.d.ts +22 -0
  56. package/dist/LabeledCheckBox.d.ts.map +1 -0
  57. package/dist/LabeledCheckBox.js +30 -0
  58. package/dist/LabeledCheckBox.js.map +1 -0
  59. package/dist/LineChart.d.ts.map +1 -1
  60. package/dist/LineChart.js +2 -2
  61. package/dist/LineChart.js.map +1 -1
  62. package/dist/ListDetailLayout.d.ts +36 -0
  63. package/dist/ListDetailLayout.d.ts.map +1 -0
  64. package/dist/ListDetailLayout.js +153 -0
  65. package/dist/ListDetailLayout.js.map +1 -0
  66. package/dist/MarkdownEditor.d.ts.map +1 -1
  67. package/dist/MarkdownEditor.js +2 -1
  68. package/dist/MarkdownEditor.js.map +1 -1
  69. package/dist/MediaQuery.d.ts +1 -1
  70. package/dist/MediaQuery.d.ts.map +1 -1
  71. package/dist/MediaQuery.js +1 -1
  72. package/dist/MediaQuery.js.map +1 -1
  73. package/dist/OtpField.d.ts +60 -0
  74. package/dist/OtpField.d.ts.map +1 -0
  75. package/dist/OtpField.js +154 -0
  76. package/dist/OtpField.js.map +1 -0
  77. package/dist/Page.d.ts +1 -0
  78. package/dist/Page.d.ts.map +1 -1
  79. package/dist/Page.js +10 -1
  80. package/dist/Page.js.map +1 -1
  81. package/dist/ProvisionalConsentSigner.d.ts +21 -0
  82. package/dist/ProvisionalConsentSigner.d.ts.map +1 -0
  83. package/dist/ProvisionalConsentSigner.js +199 -0
  84. package/dist/ProvisionalConsentSigner.js.map +1 -0
  85. package/dist/ResponsiveBreakpoint.d.ts +5 -0
  86. package/dist/ResponsiveBreakpoint.d.ts.map +1 -1
  87. package/dist/ResponsiveBreakpoint.js +7 -0
  88. package/dist/ResponsiveBreakpoint.js.map +1 -1
  89. package/dist/Scorecard.d.ts.map +1 -1
  90. package/dist/Scorecard.js +5 -2
  91. package/dist/Scorecard.js.map +1 -1
  92. package/dist/Skeleton.d.ts +39 -0
  93. package/dist/Skeleton.d.ts.map +1 -0
  94. package/dist/Skeleton.js +195 -0
  95. package/dist/Skeleton.js.map +1 -0
  96. package/dist/SocialLoginButton.d.ts +10 -0
  97. package/dist/SocialLoginButton.d.ts.map +1 -1
  98. package/dist/SocialLoginButton.js +26 -8
  99. package/dist/SocialLoginButton.js.map +1 -1
  100. package/dist/SplitPage.d.ts +12 -1
  101. package/dist/SplitPage.d.ts.map +1 -1
  102. package/dist/SplitPage.js +14 -7
  103. package/dist/SplitPage.js.map +1 -1
  104. package/dist/SplitPage.native.d.ts +1 -1
  105. package/dist/SplitPage.native.d.ts.map +1 -1
  106. package/dist/SplitPage.native.js +6 -3
  107. package/dist/SplitPage.native.js.map +1 -1
  108. package/dist/SplitPageLoading.d.ts +14 -0
  109. package/dist/SplitPageLoading.d.ts.map +1 -0
  110. package/dist/SplitPageLoading.js +19 -0
  111. package/dist/SplitPageLoading.js.map +1 -0
  112. package/dist/SyncStatusBanner.d.ts +7 -1
  113. package/dist/SyncStatusBanner.d.ts.map +1 -1
  114. package/dist/SyncStatusBanner.js +20 -4
  115. package/dist/SyncStatusBanner.js.map +1 -1
  116. package/dist/Text.d.ts +3 -1
  117. package/dist/Text.d.ts.map +1 -1
  118. package/dist/Text.js +2 -0
  119. package/dist/Text.js.map +1 -1
  120. package/dist/TextField.d.ts.map +1 -1
  121. package/dist/TextField.js +44 -10
  122. package/dist/TextField.js.map +1 -1
  123. package/dist/charts/ChartFrame.d.ts +2 -2
  124. package/dist/charts/ChartFrame.d.ts.map +1 -1
  125. package/dist/charts/ChartFrame.js +9 -2
  126. package/dist/charts/ChartFrame.js.map +1 -1
  127. package/dist/fieldElements/FieldError.d.ts.map +1 -1
  128. package/dist/fieldElements/FieldError.js +1 -1
  129. package/dist/fieldElements/FieldError.js.map +1 -1
  130. package/dist/index.d.ts +21 -3
  131. package/dist/index.d.ts.map +1 -1
  132. package/dist/index.js +16 -1
  133. package/dist/index.js.map +1 -1
  134. package/dist/lazyBoundaries/heavyOptionalExports.d.ts +3 -0
  135. package/dist/lazyBoundaries/heavyOptionalExports.d.ts.map +1 -1
  136. package/dist/lazyBoundaries/heavyOptionalExports.js +2 -0
  137. package/dist/lazyBoundaries/heavyOptionalExports.js.map +1 -1
  138. package/dist/login/LastUsedBadge.d.ts +14 -0
  139. package/dist/login/LastUsedBadge.d.ts.map +1 -0
  140. package/dist/login/LastUsedBadge.js +23 -0
  141. package/dist/login/LastUsedBadge.js.map +1 -0
  142. package/dist/login/LoginAccountCard.d.ts +38 -0
  143. package/dist/login/LoginAccountCard.d.ts.map +1 -0
  144. package/dist/login/LoginAccountCard.js +72 -0
  145. package/dist/login/LoginAccountCard.js.map +1 -0
  146. package/dist/login/LoginAccountList.d.ts +33 -0
  147. package/dist/login/LoginAccountList.d.ts.map +1 -0
  148. package/dist/login/LoginAccountList.js +30 -0
  149. package/dist/login/LoginAccountList.js.map +1 -0
  150. package/dist/login/LoginScreen.d.ts +4 -4
  151. package/dist/login/LoginScreen.d.ts.map +1 -1
  152. package/dist/login/LoginScreen.js +294 -13
  153. package/dist/login/LoginScreen.js.map +1 -1
  154. package/dist/login/OutlinePill.d.ts +28 -0
  155. package/dist/login/OutlinePill.d.ts.map +1 -0
  156. package/dist/login/OutlinePill.js +48 -0
  157. package/dist/login/OutlinePill.js.map +1 -0
  158. package/dist/login/TwoFactorChallengeScreen.d.ts +26 -0
  159. package/dist/login/TwoFactorChallengeScreen.d.ts.map +1 -0
  160. package/dist/login/TwoFactorChallengeScreen.js +139 -0
  161. package/dist/login/TwoFactorChallengeScreen.js.map +1 -0
  162. package/dist/login/loginMethods.d.ts +27 -0
  163. package/dist/login/loginMethods.d.ts.map +1 -0
  164. package/dist/login/loginMethods.js +37 -0
  165. package/dist/login/loginMethods.js.map +1 -0
  166. package/dist/login/loginTypes.d.ts +202 -5
  167. package/dist/login/loginTypes.d.ts.map +1 -1
  168. package/dist/pdfHtmlTemplate.d.ts +17 -0
  169. package/dist/pdfHtmlTemplate.d.ts.map +1 -1
  170. package/dist/pdfHtmlTemplate.js +78 -0
  171. package/dist/pdfHtmlTemplate.js.map +1 -1
  172. package/dist/security/AccountSecurityScreen.d.ts +10 -0
  173. package/dist/security/AccountSecurityScreen.d.ts.map +1 -0
  174. package/dist/security/AccountSecurityScreen.js +50 -0
  175. package/dist/security/AccountSecurityScreen.js.map +1 -0
  176. package/dist/security/LinkedAccountsCard.d.ts +32 -0
  177. package/dist/security/LinkedAccountsCard.d.ts.map +1 -0
  178. package/dist/security/LinkedAccountsCard.js +145 -0
  179. package/dist/security/LinkedAccountsCard.js.map +1 -0
  180. package/dist/security/PasskeysCard.d.ts +39 -0
  181. package/dist/security/PasskeysCard.d.ts.map +1 -0
  182. package/dist/security/PasskeysCard.js +168 -0
  183. package/dist/security/PasskeysCard.js.map +1 -0
  184. package/dist/security/PasswordCard.d.ts +32 -0
  185. package/dist/security/PasswordCard.d.ts.map +1 -0
  186. package/dist/security/PasswordCard.js +198 -0
  187. package/dist/security/PasswordCard.js.map +1 -0
  188. package/dist/security/SessionsCard.d.ts +39 -0
  189. package/dist/security/SessionsCard.d.ts.map +1 -0
  190. package/dist/security/SessionsCard.js +168 -0
  191. package/dist/security/SessionsCard.js.map +1 -0
  192. package/dist/security/TwoFactorSettingsCard.d.ts +55 -0
  193. package/dist/security/TwoFactorSettingsCard.d.ts.map +1 -0
  194. package/dist/security/TwoFactorSettingsCard.js +458 -0
  195. package/dist/security/TwoFactorSettingsCard.js.map +1 -0
  196. package/dist/security/securityMethods.d.ts +40 -0
  197. package/dist/security/securityMethods.d.ts.map +1 -0
  198. package/dist/security/securityMethods.js +66 -0
  199. package/dist/security/securityMethods.js.map +1 -0
  200. package/dist/security/securityTypes.d.ts +467 -0
  201. package/dist/security/securityTypes.d.ts.map +1 -0
  202. package/dist/security/securityTypes.js +2 -0
  203. package/dist/security/securityTypes.js.map +1 -0
  204. package/dist/security/userAgent.d.ts +26 -0
  205. package/dist/security/userAgent.d.ts.map +1 -0
  206. package/dist/security/userAgent.js +80 -0
  207. package/dist/security/userAgent.js.map +1 -0
  208. package/dist/signUp/OAuthButtons.d.ts +28 -5
  209. package/dist/signUp/OAuthButtons.d.ts.map +1 -1
  210. package/dist/signUp/OAuthButtons.js +44 -5
  211. package/dist/signUp/OAuthButtons.js.map +1 -1
  212. package/dist/signUp/SignUpScreen.d.ts.map +1 -1
  213. package/dist/signUp/SignUpScreen.js +50 -5
  214. package/dist/signUp/SignUpScreen.js.map +1 -1
  215. package/dist/signUp/signUpTypes.d.ts +21 -1
  216. package/dist/signUp/signUpTypes.d.ts.map +1 -1
  217. package/dist/useConsentForms.d.ts +9 -0
  218. package/dist/useConsentForms.d.ts.map +1 -1
  219. package/dist/useConsentForms.js +18 -0
  220. package/dist/useConsentForms.js.map +1 -1
  221. package/dist/useProvisionalConsent.d.ts +124 -0
  222. package/dist/useProvisionalConsent.d.ts.map +1 -0
  223. package/dist/useProvisionalConsent.js +79 -0
  224. package/dist/useProvisionalConsent.js.map +1 -0
  225. package/dist/withLoading.d.ts +20 -0
  226. package/dist/withLoading.d.ts.map +1 -0
  227. package/dist/withLoading.js +24 -0
  228. package/dist/withLoading.js.map +1 -0
  229. package/package.json +4 -2
  230. package/src/Accordion.test.tsx +5 -0
  231. package/src/Accordion.tsx +3 -8
  232. package/src/AreaChart.test.tsx +15 -0
  233. package/src/AreaChart.tsx +6 -0
  234. package/src/Avatar.test.tsx +8 -0
  235. package/src/Avatar.tsx +2 -0
  236. package/src/BarChart.test.tsx +15 -0
  237. package/src/BarChart.tsx +6 -0
  238. package/src/Box.test.tsx +131 -1
  239. package/src/Box.tsx +77 -8
  240. package/src/Card.test.tsx +48 -0
  241. package/src/Card.tsx +13 -2
  242. package/src/ChartCard.test.tsx +30 -0
  243. package/src/ChartCard.tsx +18 -1
  244. package/src/Common.ts +263 -14
  245. package/src/ConsentFormScreen.test.tsx +84 -0
  246. package/src/ConsentFormScreen.tsx +28 -4
  247. package/src/DateTimeField.tsx +5 -3
  248. package/src/DonutChart.test.tsx +15 -0
  249. package/src/DonutChart.tsx +6 -0
  250. package/src/Field.tsx +2 -0
  251. package/src/FilePickerButton.test.tsx +35 -0
  252. package/src/FormContainer.test.tsx +242 -0
  253. package/src/FormContainer.tsx +177 -0
  254. package/src/GPTChat.test.tsx +16 -0
  255. package/src/GPTChat.tsx +8 -2
  256. package/src/Heading.test.tsx +14 -0
  257. package/src/Heading.tsx +6 -1
  258. package/src/Icon.test.tsx +52 -1
  259. package/src/Icon.tsx +92 -3
  260. package/src/IconButton.test.tsx +85 -0
  261. package/src/LabeledCheckBox.test.tsx +45 -0
  262. package/src/LabeledCheckBox.tsx +89 -0
  263. package/src/LineChart.test.tsx +18 -0
  264. package/src/LineChart.tsx +6 -0
  265. package/src/ListDetailLayout.tsx +247 -0
  266. package/src/MarkdownEditor.tsx +2 -1
  267. package/src/MediaQuery.ts +1 -0
  268. package/src/OtpField.test.tsx +280 -0
  269. package/src/OtpField.tsx +307 -0
  270. package/src/Page.test.tsx +38 -0
  271. package/src/Page.tsx +38 -19
  272. package/src/ProvisionalConsentSigner.test.tsx +625 -0
  273. package/src/ProvisionalConsentSigner.tsx +423 -0
  274. package/src/ResponsiveBreakpoint.test.tsx +7 -0
  275. package/src/ResponsiveBreakpoint.tsx +14 -0
  276. package/src/RootImportRegression.test.tsx +3 -0
  277. package/src/Scorecard.test.tsx +11 -0
  278. package/src/Scorecard.tsx +21 -0
  279. package/src/Skeleton.test.tsx +262 -0
  280. package/src/Skeleton.tsx +430 -0
  281. package/src/SocialLoginButton.test.tsx +14 -0
  282. package/src/SocialLoginButton.tsx +51 -7
  283. package/src/SplitPage.native.tsx +16 -3
  284. package/src/SplitPage.tsx +29 -12
  285. package/src/SplitPageLoading.test.tsx +51 -0
  286. package/src/SplitPageLoading.tsx +53 -0
  287. package/src/SyncStatusBanner.test.tsx +61 -4
  288. package/src/SyncStatusBanner.tsx +29 -3
  289. package/src/Text.tsx +4 -1
  290. package/src/TextField.test.tsx +150 -0
  291. package/src/TextField.tsx +66 -8
  292. package/src/__snapshots__/AddressField.test.tsx.snap +12 -0
  293. package/src/__snapshots__/AiSuggestionBox.test.tsx.snap +15 -0
  294. package/src/__snapshots__/Avatar.test.tsx.snap +1 -0
  295. package/src/__snapshots__/CustomSelectField.test.tsx.snap +3 -0
  296. package/src/__snapshots__/EmailField.test.tsx.snap +6 -0
  297. package/src/__snapshots__/Field.test.tsx.snap +37 -0
  298. package/src/__snapshots__/HeightField.test.tsx.snap +2 -0
  299. package/src/__snapshots__/MobileAddressAutoComplete.test.tsx.snap +3 -0
  300. package/src/__snapshots__/NumberField.test.tsx.snap +3 -0
  301. package/src/__snapshots__/Page.test.tsx.snap +28 -5
  302. package/src/__snapshots__/PhoneNumberField.test.tsx.snap +12 -0
  303. package/src/__snapshots__/Slider.test.tsx.snap +1 -0
  304. package/src/__snapshots__/SocialLoginButton.test.tsx.snap +43 -22
  305. package/src/__snapshots__/SplitPage.test.tsx.snap +16 -0
  306. package/src/__snapshots__/TapToEdit.test.tsx.snap +3 -0
  307. package/src/__snapshots__/TextArea.test.tsx.snap +17 -1
  308. package/src/__snapshots__/TextField.test.tsx.snap +19 -2
  309. package/src/__snapshots__/TypedSignatureField.test.tsx.snap +3 -0
  310. package/src/__snapshots__/UnifiedAddressAutoComplete.test.tsx.snap +18 -0
  311. package/src/__snapshots__/WebAddressAutocomplete.test.tsx.snap +12 -0
  312. package/src/bunSetup.ts +13 -1
  313. package/src/charts/ChartFrame.tsx +19 -8
  314. package/src/fieldElements/FieldError.tsx +1 -0
  315. package/src/fieldElements/__snapshots__/FieldError.test.tsx.snap +2 -0
  316. package/src/index.tsx +44 -1
  317. package/src/isolated/ListDetailLayout.isolated.tsx +634 -0
  318. package/src/lazyBoundaries/heavyOptionalExports.tsx +7 -0
  319. package/src/login/LastUsedBadge.tsx +40 -0
  320. package/src/login/LoginAccountCard.tsx +205 -0
  321. package/src/login/LoginAccountList.tsx +115 -0
  322. package/src/login/LoginScreen.test.tsx +837 -1
  323. package/src/login/LoginScreen.tsx +674 -91
  324. package/src/login/OutlinePill.tsx +110 -0
  325. package/src/login/TwoFactorChallengeScreen.test.tsx +376 -0
  326. package/src/login/TwoFactorChallengeScreen.tsx +307 -0
  327. package/src/login/__snapshots__/LoginScreen.test.tsx.snap +1454 -334
  328. package/src/login/loginMethods.test.ts +53 -0
  329. package/src/login/loginMethods.ts +60 -0
  330. package/src/login/loginTypes.ts +208 -5
  331. package/src/pdfHtmlTemplate.test.ts +243 -4
  332. package/src/pdfHtmlTemplate.ts +93 -0
  333. package/src/security/AccountSecurityScreen.test.tsx +262 -0
  334. package/src/security/AccountSecurityScreen.tsx +156 -0
  335. package/src/security/LinkedAccountsCard.test.tsx +371 -0
  336. package/src/security/LinkedAccountsCard.tsx +297 -0
  337. package/src/security/PasskeysCard.test.tsx +378 -0
  338. package/src/security/PasskeysCard.tsx +371 -0
  339. package/src/security/PasswordCard.test.tsx +445 -0
  340. package/src/security/PasswordCard.tsx +342 -0
  341. package/src/security/SessionsCard.test.tsx +349 -0
  342. package/src/security/SessionsCard.tsx +362 -0
  343. package/src/security/TwoFactorSettingsCard.test.tsx +700 -0
  344. package/src/security/TwoFactorSettingsCard.tsx +872 -0
  345. package/src/security/securityMethods.test.ts +101 -0
  346. package/src/security/securityMethods.ts +104 -0
  347. package/src/security/securityTypes.ts +480 -0
  348. package/src/security/userAgent.test.ts +119 -0
  349. package/src/security/userAgent.ts +102 -0
  350. package/src/signUp/OAuthButtons.test.tsx +27 -0
  351. package/src/signUp/OAuthButtons.tsx +153 -19
  352. package/src/signUp/SignUpScreen.test.tsx +170 -1
  353. package/src/signUp/SignUpScreen.tsx +87 -25
  354. package/src/signUp/__snapshots__/SignUpScreen.test.tsx.snap +22 -11
  355. package/src/signUp/signUpTypes.ts +23 -1
  356. package/src/useConsentForms.test.ts +37 -1
  357. package/src/useConsentForms.ts +25 -0
  358. package/src/useProvisionalConsent.test.ts +256 -0
  359. package/src/useProvisionalConsent.ts +218 -0
  360. package/src/withLoading.test.tsx +61 -0
  361. package/src/withLoading.tsx +50 -0
@@ -0,0 +1,362 @@
1
+ import {DateTime} from "luxon";
2
+ import {type FC, useCallback, useEffect, useMemo, useState} from "react";
3
+ import {View} from "react-native";
4
+
5
+ import {Badge} from "../Badge";
6
+ import {Box} from "../Box";
7
+ import {Button} from "../Button";
8
+ import {Card} from "../Card";
9
+ import type {IconName} from "../Common";
10
+ import {Heading} from "../Heading";
11
+ import {Icon} from "../Icon";
12
+ import {Modal} from "../Modal";
13
+ import {Text} from "../Text";
14
+ import {formatRelativeSecurityTime, getRejectionMessage} from "./securityMethods";
15
+ import type {AccountSession, SessionsCardProps} from "./securityTypes";
16
+ import {getUserAgentLabel, parseUserAgent, type UserAgentDeviceType} from "./userAgent";
17
+
18
+ /** Pending key for "Sign out everywhere else"; rows use their session id. */
19
+ const REVOKE_OTHERS_KEY = "__revoke-others__";
20
+
21
+ /** How often relative times are recomputed when no `now` is injected. */
22
+ const RELATIVE_TIME_REFRESH_MS = 60_000;
23
+
24
+ const DEVICE_ICONS: Record<UserAgentDeviceType, IconName> = {
25
+ desktop: "desktop",
26
+ mobile: "mobile-screen",
27
+ tablet: "tablet-screen-button",
28
+ unknown: "circle-question",
29
+ };
30
+
31
+ /** One session as a row shows it. */
32
+ interface SessionRow {
33
+ session: AccountSession;
34
+ isCurrent: boolean;
35
+ /** "Chrome on macOS", or whichever part is known, or "Unknown device". */
36
+ label: string;
37
+ iconName: IconName;
38
+ /** "Denver, US · 203.0.113.4", or undefined when neither is known. */
39
+ details?: string;
40
+ /** "9 days ago" from `createdAt`, or undefined when unknown. */
41
+ signedIn?: string;
42
+ /** "2 hours ago" from `updatedAt`, or undefined when unknown. */
43
+ lastRefreshed?: string;
44
+ }
45
+
46
+ /** Milliseconds since the epoch for sorting, or 0 when unknown. */
47
+ const toMillis = (value?: string | Date): number => {
48
+ if (!value) {
49
+ return 0;
50
+ }
51
+ const date = value instanceof Date ? DateTime.fromJSDate(value) : DateTime.fromISO(value);
52
+ return date.isValid ? date.toMillis() : 0;
53
+ };
54
+
55
+ /** Builds rows with the current session first, then the most recently refreshed. */
56
+ const buildRows = ({
57
+ sessions,
58
+ currentSessionId,
59
+ currentSessionToken,
60
+ now,
61
+ }: {
62
+ sessions: AccountSession[];
63
+ currentSessionId?: string;
64
+ currentSessionToken?: string;
65
+ now: Date;
66
+ }): SessionRow[] => {
67
+ const rows = sessions.map((session): SessionRow => {
68
+ const parsed = parseUserAgent(session.userAgent);
69
+ const isCurrent =
70
+ (currentSessionId !== undefined && session.id === currentSessionId) ||
71
+ (currentSessionToken !== undefined && session.token === currentSessionToken);
72
+ const detailParts = [session.location, session.ipAddress].filter((part): part is string =>
73
+ Boolean(part)
74
+ );
75
+ return {
76
+ details: detailParts.length > 0 ? detailParts.join(" · ") : undefined,
77
+ iconName: DEVICE_ICONS[parsed.deviceType],
78
+ isCurrent,
79
+ label: getUserAgentLabel(parsed),
80
+ lastRefreshed: formatRelativeSecurityTime({now, value: session.updatedAt}),
81
+ session,
82
+ signedIn: formatRelativeSecurityTime({now, value: session.createdAt}),
83
+ };
84
+ });
85
+ return rows.sort((a, b) => {
86
+ if (a.isCurrent !== b.isCurrent) {
87
+ return a.isCurrent ? -1 : 1;
88
+ }
89
+ return (
90
+ toMillis(b.session.updatedAt ?? b.session.createdAt) -
91
+ toMillis(a.session.updatedAt ?? a.session.createdAt)
92
+ );
93
+ });
94
+ };
95
+
96
+ /**
97
+ * Lists the user's signed-in sessions: the device and browser (parsed from the user agent), the
98
+ * location and IP address when known, when each signed in (`createdAt`), and when it was last
99
+ * refreshed (`updatedAt`, which Better Auth only moves once per `session.updateAge`, a day by
100
+ * default, so it is not a live "last active" time). The current session comes first, marked
101
+ * "This device" and "Active now", and can't be signed out on its own here. Every other session
102
+ * has a Sign out button, and "Sign out everywhere else" (with a confirm) ends them all. Relative
103
+ * times are recomputed every minute unless `now` is passed. Presentational: it reports actions
104
+ * through `onRevoke` and `onRevokeOthers` and never calls an auth client.
105
+ *
106
+ * @example
107
+ * ```tsx
108
+ * // The Better Auth client resolves {data, error} rather than throwing; throw so the card
109
+ * // shows the error.
110
+ * <SessionsCard
111
+ * sessions={sessions} // authClient.listSessions() data
112
+ * currentSessionId={session.data?.session.id}
113
+ * onRevoke={async (revoked) => {
114
+ * if (!revoked.token) {
115
+ * throw new Error("This session can't be signed out.");
116
+ * }
117
+ * const {error} = await authClient.revokeSession({token: revoked.token});
118
+ * if (error) {
119
+ * throw new Error(error.message ?? "Couldn't sign out that session.");
120
+ * }
121
+ * }}
122
+ * onRevokeOthers={async () => {
123
+ * const {error} = await authClient.revokeOtherSessions();
124
+ * if (error) {
125
+ * throw new Error(error.message ?? "Couldn't sign out your other sessions.");
126
+ * }
127
+ * }}
128
+ * />
129
+ * ```
130
+ */
131
+ export const SessionsCard: FC<SessionsCardProps> = ({
132
+ sessions,
133
+ currentSessionId,
134
+ currentSessionToken,
135
+ onRevoke,
136
+ onRevokeOthers,
137
+ now,
138
+ error,
139
+ disabled = false,
140
+ title = "Where you're signed in",
141
+ description = "Sign out of any device you don't recognize.",
142
+ testID = "sessions-card",
143
+ }) => {
144
+ const [pendingKey, setPendingKey] = useState<string | undefined>(undefined);
145
+ const [isConfirmingRevokeOthers, setIsConfirmingRevokeOthers] = useState(false);
146
+ const [actionError, setActionError] = useState<string | undefined>(undefined);
147
+ const [clock, setClock] = useState<Date>(() => DateTime.now().toJSDate());
148
+
149
+ // Without an injected `now`, tick every minute so relative times don't freeze at first render.
150
+ useEffect(() => {
151
+ if (now) {
152
+ return undefined;
153
+ }
154
+ const interval = setInterval(() => {
155
+ setClock(DateTime.now().toJSDate());
156
+ }, RELATIVE_TIME_REFRESH_MS);
157
+ return (): void => {
158
+ clearInterval(interval);
159
+ };
160
+ }, [now]);
161
+
162
+ const effectiveNow = now ?? clock;
163
+ const rows = useMemo(
164
+ () => buildRows({currentSessionId, currentSessionToken, now: effectiveNow, sessions}),
165
+ [currentSessionId, currentSessionToken, effectiveNow, sessions]
166
+ );
167
+ const otherSessionCount = rows.filter((row) => !row.isCurrent).length;
168
+ const isBusy = disabled || pendingKey !== undefined;
169
+ const shownError = error ?? actionError;
170
+
171
+ const runAction = useCallback(
172
+ async ({
173
+ key,
174
+ action,
175
+ fallback,
176
+ }: {
177
+ key: string;
178
+ action: () => void | Promise<void>;
179
+ fallback: string;
180
+ }): Promise<void> => {
181
+ setActionError(undefined);
182
+ setPendingKey(key);
183
+ try {
184
+ await action();
185
+ } catch (rejection: unknown) {
186
+ console.warn("SessionsCard: action rejected", rejection);
187
+ setActionError(getRejectionMessage({error: rejection, fallback}));
188
+ } finally {
189
+ setPendingKey(undefined);
190
+ }
191
+ },
192
+ []
193
+ );
194
+
195
+ const handleRevoke = useCallback(
196
+ async (row: SessionRow): Promise<void> => {
197
+ if (!onRevoke || isBusy || row.isCurrent) {
198
+ return;
199
+ }
200
+ await runAction({
201
+ action: () => onRevoke(row.session),
202
+ fallback: `Couldn't sign out ${row.label}. Try again.`,
203
+ key: row.session.id,
204
+ });
205
+ },
206
+ [isBusy, onRevoke, runAction]
207
+ );
208
+
209
+ const handleOpenRevokeOthers = useCallback((): void => {
210
+ setIsConfirmingRevokeOthers(true);
211
+ }, []);
212
+
213
+ const handleDismissConfirm = useCallback((): void => {
214
+ setIsConfirmingRevokeOthers(false);
215
+ }, []);
216
+
217
+ const handleConfirmRevokeOthers = useCallback(async (): Promise<void> => {
218
+ setIsConfirmingRevokeOthers(false);
219
+ if (!onRevokeOthers) {
220
+ return;
221
+ }
222
+ await runAction({
223
+ action: onRevokeOthers,
224
+ fallback: "Couldn't sign out your other sessions. Try again.",
225
+ key: REVOKE_OTHERS_KEY,
226
+ });
227
+ }, [onRevokeOthers, runAction]);
228
+
229
+ return (
230
+ <Card testID={testID}>
231
+ <Box gap={4}>
232
+ <Box gap={1}>
233
+ <Heading level={2} size="md" testID={`${testID}-title`}>
234
+ {title}
235
+ </Heading>
236
+ <Text color="secondaryLight">{description}</Text>
237
+ </Box>
238
+
239
+ {rows.length === 0 && (
240
+ <Text color="secondaryLight" testID={`${testID}-empty`}>
241
+ No active sessions.
242
+ </Text>
243
+ )}
244
+
245
+ {rows.map((row) => {
246
+ const {details, iconName, isCurrent, label, lastRefreshed, session, signedIn} = row;
247
+ const {id} = session;
248
+ return (
249
+ <Box
250
+ alignItems="center"
251
+ direction="row"
252
+ gap={3}
253
+ key={id}
254
+ testID={`${testID}-row-${id}`}
255
+ >
256
+ <Box alignItems="center" width={24}>
257
+ <Icon iconName={iconName} size="lg" />
258
+ </Box>
259
+ <Box flex="grow" gap={1}>
260
+ <Box alignItems="center" direction="row" gap={2} wrap>
261
+ <Text bold testID={`${testID}-name-${id}`}>
262
+ {label}
263
+ </Text>
264
+ {isCurrent && (
265
+ <Badge
266
+ secondary
267
+ status="success"
268
+ testID={`${testID}-current-${id}`}
269
+ value="This device"
270
+ />
271
+ )}
272
+ </Box>
273
+ {Boolean(details) && (
274
+ <Text color="secondaryLight" size="sm" testID={`${testID}-details-${id}`}>
275
+ {details}
276
+ </Text>
277
+ )}
278
+ {Boolean(signedIn) && (
279
+ <Text color="secondaryLight" size="sm" testID={`${testID}-signed-in-${id}`}>
280
+ {`Signed in ${signedIn}`}
281
+ </Text>
282
+ )}
283
+ {isCurrent && (
284
+ <Text color="secondaryLight" size="sm" testID={`${testID}-activity-${id}`}>
285
+ Active now
286
+ </Text>
287
+ )}
288
+ {!isCurrent && Boolean(lastRefreshed) && (
289
+ <Text color="secondaryLight" size="sm" testID={`${testID}-activity-${id}`}>
290
+ {`Last refreshed ${lastRefreshed}`}
291
+ </Text>
292
+ )}
293
+ </Box>
294
+ {!isCurrent && Boolean(onRevoke) && (
295
+ <Button
296
+ accessibilityLabel={
297
+ signedIn ? `Sign out ${label}, signed in ${signedIn}` : `Sign out ${label}`
298
+ }
299
+ disabled={isBusy}
300
+ loading={pendingKey === id}
301
+ onClick={() => handleRevoke(row)}
302
+ size="sm"
303
+ testID={`${testID}-revoke-${id}`}
304
+ text="Sign out"
305
+ variant="outline"
306
+ />
307
+ )}
308
+ </Box>
309
+ );
310
+ })}
311
+
312
+ {rows.length > 0 && otherSessionCount === 0 && (
313
+ <Text color="secondaryLight" testID={`${testID}-no-others`}>
314
+ You're not signed in anywhere else.
315
+ </Text>
316
+ )}
317
+
318
+ {Boolean(shownError) && (
319
+ <View role="alert" testID={`${testID}-error`}>
320
+ <Text color="error">{shownError}</Text>
321
+ </View>
322
+ )}
323
+
324
+ {Boolean(onRevokeOthers) && (
325
+ <Box alignItems="start">
326
+ <Button
327
+ disabled={isBusy || otherSessionCount === 0}
328
+ iconName="right-from-bracket"
329
+ loading={pendingKey === REVOKE_OTHERS_KEY}
330
+ onClick={handleOpenRevokeOthers}
331
+ testID={`${testID}-revoke-others`}
332
+ text="Sign out everywhere else"
333
+ variant="secondary"
334
+ />
335
+ </Box>
336
+ )}
337
+ </Box>
338
+
339
+ {isConfirmingRevokeOthers && (
340
+ <Modal
341
+ onDismiss={handleDismissConfirm}
342
+ primaryButtonOnClick={handleConfirmRevokeOthers}
343
+ primaryButtonText="Sign out"
344
+ secondaryButtonOnClick={handleDismissConfirm}
345
+ secondaryButtonText="Cancel"
346
+ testIDs={{
347
+ dismiss: `${testID}-confirm-dismiss`,
348
+ primaryButton: `${testID}-confirm-submit`,
349
+ root: `${testID}-confirm`,
350
+ secondaryButton: `${testID}-confirm-cancel`,
351
+ title: `${testID}-confirm-title`,
352
+ }}
353
+ text={`This signs you out on ${otherSessionCount} other ${
354
+ otherSessionCount === 1 ? "session" : "sessions"
355
+ }. You'll stay signed in here.`}
356
+ title="Sign out everywhere else?"
357
+ visible
358
+ />
359
+ )}
360
+ </Card>
361
+ );
362
+ };