@marinoscar/vault-web 0.0.0-stage → 0.1.0-next.4

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 (287) hide show
  1. package/CHANGELOG.md +46 -0
  2. package/LICENSE +21 -0
  3. package/README.md +98 -2
  4. package/dist/agent/headless/agentActivity.d.ts +57 -0
  5. package/dist/agent/headless/agentActivity.js +70 -0
  6. package/dist/agent/headless/cardGrants.d.ts +28 -0
  7. package/dist/agent/headless/cardGrants.js +61 -0
  8. package/dist/agent/headless/index.d.ts +4 -0
  9. package/dist/agent/headless/index.js +5 -0
  10. package/dist/agent/headless/useAgentActivity.d.ts +9 -0
  11. package/dist/agent/headless/useAgentActivity.js +30 -0
  12. package/dist/agent/headless/useCardGrants.d.ts +19 -0
  13. package/dist/agent/headless/useCardGrants.js +51 -0
  14. package/dist/agent/ui/components/AgentActivityTable.d.ts +25 -0
  15. package/dist/agent/ui/components/AgentActivityTable.js +122 -0
  16. package/dist/agent/ui/components/CardAgentAccessPanel.d.ts +17 -0
  17. package/dist/agent/ui/components/CardAgentAccessPanel.js +44 -0
  18. package/dist/agent/ui/components/CardGrantDialog.d.ts +16 -0
  19. package/dist/agent/ui/components/CardGrantDialog.js +101 -0
  20. package/dist/agent/ui/components/IdentityAgentAccessPanel.d.ts +20 -0
  21. package/dist/agent/ui/components/IdentityAgentAccessPanel.js +61 -0
  22. package/dist/agent/ui/index.d.ts +6 -0
  23. package/dist/agent/ui/index.js +7 -0
  24. package/dist/agent/ui/pages/AgentAccessSettingsPage.d.ts +7 -0
  25. package/dist/agent/ui/pages/AgentAccessSettingsPage.js +105 -0
  26. package/dist/agent/ui/pages/AgentActivityPage.d.ts +6 -0
  27. package/dist/agent/ui/pages/AgentActivityPage.js +61 -0
  28. package/dist/backups/headless/backupContents.d.ts +69 -0
  29. package/dist/backups/headless/backupContents.js +133 -0
  30. package/dist/backups/headless/backupPassword.d.ts +34 -0
  31. package/dist/backups/headless/backupPassword.js +80 -0
  32. package/dist/backups/headless/backupSchedule.d.ts +56 -0
  33. package/dist/backups/headless/backupSchedule.js +189 -0
  34. package/dist/backups/headless/index.d.ts +4 -0
  35. package/dist/backups/headless/index.js +5 -0
  36. package/dist/backups/headless/useBackupRunHistory.d.ts +36 -0
  37. package/dist/backups/headless/useBackupRunHistory.js +83 -0
  38. package/dist/backups/ui/components/AdminBackupDownloadDialog.d.ts +20 -0
  39. package/dist/backups/ui/components/AdminBackupDownloadDialog.js +65 -0
  40. package/dist/backups/ui/components/BackupContentsGroup.d.ts +17 -0
  41. package/dist/backups/ui/components/BackupContentsGroup.js +21 -0
  42. package/dist/backups/ui/components/BackupPasswordFields.d.ts +18 -0
  43. package/dist/backups/ui/components/BackupPasswordFields.js +40 -0
  44. package/dist/backups/ui/components/BackupRunsTable.d.ts +44 -0
  45. package/dist/backups/ui/components/BackupRunsTable.js +61 -0
  46. package/dist/backups/ui/components/DataBackup.d.ts +14 -0
  47. package/dist/backups/ui/components/DataBackup.js +169 -0
  48. package/dist/backups/ui/components/ScheduledBackups.d.ts +13 -0
  49. package/dist/backups/ui/components/ScheduledBackups.js +304 -0
  50. package/dist/backups/ui/index.d.ts +8 -0
  51. package/dist/backups/ui/index.js +9 -0
  52. package/dist/backups/ui/pages/BackupSettingsPage.d.ts +8 -0
  53. package/dist/backups/ui/pages/BackupSettingsPage.js +19 -0
  54. package/dist/backups/ui/pages/MyBackupsPage.d.ts +8 -0
  55. package/dist/backups/ui/pages/MyBackupsPage.js +19 -0
  56. package/dist/brand/BrandLockup.d.ts +14 -0
  57. package/dist/brand/BrandLockup.js +13 -0
  58. package/dist/brand/assets/vault-mark.png +0 -0
  59. package/dist/brand/contrast.d.ts +8 -0
  60. package/dist/brand/contrast.js +21 -0
  61. package/dist/brand/index.d.ts +7 -0
  62. package/dist/brand/index.js +8 -0
  63. package/dist/brand/mark.d.ts +6 -0
  64. package/dist/brand/mark.js +7 -0
  65. package/dist/brand/theme.d.ts +25 -0
  66. package/dist/brand/theme.js +84 -0
  67. package/dist/brand/tokens.d.ts +52 -0
  68. package/dist/brand/tokens.js +54 -0
  69. package/dist/cards/headless/cardExpiry.d.ts +57 -0
  70. package/dist/cards/headless/cardExpiry.js +138 -0
  71. package/dist/cards/headless/cardFormat.d.ts +60 -0
  72. package/dist/cards/headless/cardFormat.js +135 -0
  73. package/dist/cards/headless/cardImage.d.ts +293 -0
  74. package/dist/cards/headless/cardImage.js +518 -0
  75. package/dist/cards/headless/index.d.ts +6 -0
  76. package/dist/cards/headless/index.js +7 -0
  77. package/dist/cards/headless/useCardImport.d.ts +137 -0
  78. package/dist/cards/headless/useCardImport.js +391 -0
  79. package/dist/cards/headless/useCardRenewal.d.ts +102 -0
  80. package/dist/cards/headless/useCardRenewal.js +305 -0
  81. package/dist/cards/headless/useCards.d.ts +80 -0
  82. package/dist/cards/headless/useCards.js +114 -0
  83. package/dist/cards/ui/components/AiEgressNotice.d.ts +13 -0
  84. package/dist/cards/ui/components/AiEgressNotice.js +18 -0
  85. package/dist/cards/ui/components/CardCaptureStep.d.ts +59 -0
  86. package/dist/cards/ui/components/CardCaptureStep.js +96 -0
  87. package/dist/cards/ui/components/CardCropAdjuster.d.ts +43 -0
  88. package/dist/cards/ui/components/CardCropAdjuster.js +215 -0
  89. package/dist/cards/ui/components/CardCropReview.d.ts +51 -0
  90. package/dist/cards/ui/components/CardCropReview.js +88 -0
  91. package/dist/cards/ui/components/CardExpiryBadge.d.ts +8 -0
  92. package/dist/cards/ui/components/CardExpiryBadge.js +43 -0
  93. package/dist/cards/ui/components/CardFieldDiff.d.ts +37 -0
  94. package/dist/cards/ui/components/CardFieldDiff.js +66 -0
  95. package/dist/cards/ui/components/CardFlowStepper.d.ts +24 -0
  96. package/dist/cards/ui/components/CardFlowStepper.js +23 -0
  97. package/dist/cards/ui/components/CardReviewForm.d.ts +44 -0
  98. package/dist/cards/ui/components/CardReviewForm.js +102 -0
  99. package/dist/cards/ui/components/CardScanModelSection.d.ts +23 -0
  100. package/dist/cards/ui/components/CardScanModelSection.js +82 -0
  101. package/dist/cards/ui/components/CardTile.d.ts +40 -0
  102. package/dist/cards/ui/components/CardTile.js +94 -0
  103. package/dist/cards/ui/index.d.ts +15 -0
  104. package/dist/cards/ui/index.js +16 -0
  105. package/dist/cards/ui/pages/AiSettingsPage.d.ts +12 -0
  106. package/dist/cards/ui/pages/AiSettingsPage.js +24 -0
  107. package/dist/cards/ui/pages/CardsPage.d.ts +26 -0
  108. package/dist/cards/ui/pages/CardsPage.js +161 -0
  109. package/dist/cards/ui/pages/ImportCardPage.d.ts +24 -0
  110. package/dist/cards/ui/pages/ImportCardPage.js +343 -0
  111. package/dist/cards/ui/pages/RenewCardPage.d.ts +35 -0
  112. package/dist/cards/ui/pages/RenewCardPage.js +350 -0
  113. package/dist/core/headless/api.d.ts +276 -0
  114. package/dist/core/headless/api.js +432 -0
  115. package/dist/core/headless/cardScanAvailability.d.ts +20 -0
  116. package/dist/core/headless/cardScanAvailability.js +27 -0
  117. package/dist/core/headless/clipboard.d.ts +60 -0
  118. package/dist/core/headless/clipboard.js +101 -0
  119. package/dist/core/headless/http.d.ts +53 -0
  120. package/dist/core/headless/http.js +59 -0
  121. package/dist/core/headless/index.d.ts +12 -0
  122. package/dist/core/headless/index.js +13 -0
  123. package/dist/core/headless/relativeTime.d.ts +7 -0
  124. package/dist/core/headless/relativeTime.js +28 -0
  125. package/dist/core/headless/saveBlob.d.ts +6 -0
  126. package/dist/core/headless/saveBlob.js +21 -0
  127. package/dist/core/headless/types.d.ts +458 -0
  128. package/dist/core/headless/types.js +51 -0
  129. package/dist/core/headless/useAiStatus.d.ts +41 -0
  130. package/dist/core/headless/useAiStatus.js +42 -0
  131. package/dist/core/headless/useCopyToClipboard.d.ts +20 -0
  132. package/dist/core/headless/useCopyToClipboard.js +52 -0
  133. package/dist/core/headless/useDashboardResource.d.ts +22 -0
  134. package/dist/core/headless/useDashboardResource.js +52 -0
  135. package/dist/core/headless/useSystemSettings.d.ts +17 -0
  136. package/dist/core/headless/useSystemSettings.js +106 -0
  137. package/dist/core/headless/useUserSettings.d.ts +13 -0
  138. package/dist/core/headless/useUserSettings.js +103 -0
  139. package/dist/core/ui/ErrorBoundary.d.ts +15 -0
  140. package/dist/core/ui/ErrorBoundary.js +27 -0
  141. package/dist/core/ui/LoadingSpinner.d.ts +6 -0
  142. package/dist/core/ui/LoadingSpinner.js +14 -0
  143. package/dist/core/ui/SettingsPageFrame.d.ts +19 -0
  144. package/dist/core/ui/SettingsPageFrame.js +12 -0
  145. package/dist/core/ui/StorageSettingsLink.d.ts +19 -0
  146. package/dist/core/ui/StorageSettingsLink.js +26 -0
  147. package/dist/core/ui/index.d.ts +4 -0
  148. package/dist/core/ui/index.js +5 -0
  149. package/dist/home/headless/homeLinks.d.ts +24 -0
  150. package/dist/home/headless/homeLinks.js +24 -0
  151. package/dist/home/headless/index.d.ts +1 -0
  152. package/dist/home/headless/index.js +2 -0
  153. package/dist/home/ui/components/BackupStatusPanel.d.ts +28 -0
  154. package/dist/home/ui/components/BackupStatusPanel.js +99 -0
  155. package/dist/home/ui/components/DashboardPanel.d.ts +33 -0
  156. package/dist/home/ui/components/DashboardPanel.js +21 -0
  157. package/dist/home/ui/components/ExpiringCardsPanel.d.ts +31 -0
  158. package/dist/home/ui/components/ExpiringCardsPanel.js +35 -0
  159. package/dist/home/ui/components/FirstRunPanel.d.ts +7 -0
  160. package/dist/home/ui/components/FirstRunPanel.js +21 -0
  161. package/dist/home/ui/components/QuickActions.d.ts +14 -0
  162. package/dist/home/ui/components/QuickActions.js +40 -0
  163. package/dist/home/ui/components/RecentSecretsPanel.d.ts +19 -0
  164. package/dist/home/ui/components/RecentSecretsPanel.js +20 -0
  165. package/dist/home/ui/components/StatsRow.d.ts +19 -0
  166. package/dist/home/ui/components/StatsRow.js +46 -0
  167. package/dist/home/ui/components/WelcomeHeader.d.ts +11 -0
  168. package/dist/home/ui/components/WelcomeHeader.js +15 -0
  169. package/dist/home/ui/index.d.ts +9 -0
  170. package/dist/home/ui/index.js +10 -0
  171. package/dist/home/ui/pages/HomePage.d.ts +14 -0
  172. package/dist/home/ui/pages/HomePage.js +121 -0
  173. package/dist/index.d.ts +5 -0
  174. package/dist/index.js +5 -0
  175. package/dist/media/headless/index.d.ts +2 -0
  176. package/dist/media/headless/index.js +3 -0
  177. package/dist/media/headless/useMediaFiles.d.ts +20 -0
  178. package/dist/media/headless/useMediaFiles.js +82 -0
  179. package/dist/media/headless/useMediaFolders.d.ts +22 -0
  180. package/dist/media/headless/useMediaFolders.js +81 -0
  181. package/dist/media/ui/components/FolderList.d.ts +19 -0
  182. package/dist/media/ui/components/FolderList.js +36 -0
  183. package/dist/media/ui/components/MediaList.d.ts +20 -0
  184. package/dist/media/ui/components/MediaList.js +55 -0
  185. package/dist/media/ui/components/MediaPlayer.d.ts +7 -0
  186. package/dist/media/ui/components/MediaPlayer.js +361 -0
  187. package/dist/media/ui/index.d.ts +10 -0
  188. package/dist/media/ui/index.js +11 -0
  189. package/dist/media/ui/pages/CreateFolderPage.d.ts +1 -0
  190. package/dist/media/ui/pages/CreateFolderPage.js +39 -0
  191. package/dist/media/ui/pages/EditFolderPage.d.ts +1 -0
  192. package/dist/media/ui/pages/EditFolderPage.js +59 -0
  193. package/dist/media/ui/pages/MediaFolderPage.d.ts +1 -0
  194. package/dist/media/ui/pages/MediaFolderPage.js +68 -0
  195. package/dist/media/ui/pages/MediaFoldersPage.d.ts +1 -0
  196. package/dist/media/ui/pages/MediaFoldersPage.js +58 -0
  197. package/dist/media/ui/pages/MediaPlayerPage.d.ts +1 -0
  198. package/dist/media/ui/pages/MediaPlayerPage.js +76 -0
  199. package/dist/media/ui/pages/MediaUploadPage.d.ts +1 -0
  200. package/dist/media/ui/pages/MediaUploadPage.js +88 -0
  201. package/dist/media/ui/pages/RenameMediaFilePage.d.ts +1 -0
  202. package/dist/media/ui/pages/RenameMediaFilePage.js +63 -0
  203. package/dist/navigation/destinations.d.ts +50 -0
  204. package/dist/navigation/destinations.js +109 -0
  205. package/dist/navigation/index.d.ts +1 -0
  206. package/dist/navigation/index.js +4 -0
  207. package/dist/secrets/headless/fieldOptionsValidation.d.ts +45 -0
  208. package/dist/secrets/headless/fieldOptionsValidation.js +79 -0
  209. package/dist/secrets/headless/index.d.ts +6 -0
  210. package/dist/secrets/headless/index.js +7 -0
  211. package/dist/secrets/headless/secretFields.d.ts +91 -0
  212. package/dist/secrets/headless/secretFields.js +197 -0
  213. package/dist/secrets/headless/useSecretDetail.d.ts +34 -0
  214. package/dist/secrets/headless/useSecretDetail.js +88 -0
  215. package/dist/secrets/headless/useSecretTypes.d.ts +16 -0
  216. package/dist/secrets/headless/useSecretTypes.js +62 -0
  217. package/dist/secrets/headless/useSecrets.d.ts +24 -0
  218. package/dist/secrets/headless/useSecrets.js +59 -0
  219. package/dist/secrets/headless/useTotpCode.d.ts +24 -0
  220. package/dist/secrets/headless/useTotpCode.js +116 -0
  221. package/dist/secrets/ui/components/CardImages.d.ts +31 -0
  222. package/dist/secrets/ui/components/CardImages.js +208 -0
  223. package/dist/secrets/ui/components/DynamicSecretFields.d.ts +10 -0
  224. package/dist/secrets/ui/components/DynamicSecretFields.js +90 -0
  225. package/dist/secrets/ui/components/FieldDefinitionBuilder.d.ts +13 -0
  226. package/dist/secrets/ui/components/FieldDefinitionBuilder.js +114 -0
  227. package/dist/secrets/ui/components/FieldOptionsEditor.d.ts +15 -0
  228. package/dist/secrets/ui/components/FieldOptionsEditor.js +45 -0
  229. package/dist/secrets/ui/components/SecretAttachments.d.ts +15 -0
  230. package/dist/secrets/ui/components/SecretAttachments.js +106 -0
  231. package/dist/secrets/ui/components/SecretForm.d.ts +34 -0
  232. package/dist/secrets/ui/components/SecretForm.js +83 -0
  233. package/dist/secrets/ui/components/SecretFormDialog.d.ts +15 -0
  234. package/dist/secrets/ui/components/SecretFormDialog.js +95 -0
  235. package/dist/secrets/ui/components/SecretTypeFormDialog.d.ts +15 -0
  236. package/dist/secrets/ui/components/SecretTypeFormDialog.js +92 -0
  237. package/dist/secrets/ui/components/SecretTypeIcon.d.ts +8 -0
  238. package/dist/secrets/ui/components/SecretTypeIcon.js +16 -0
  239. package/dist/secrets/ui/components/SecretTypesList.d.ts +10 -0
  240. package/dist/secrets/ui/components/SecretTypesList.js +13 -0
  241. package/dist/secrets/ui/components/SecretValueField.d.ts +20 -0
  242. package/dist/secrets/ui/components/SecretValueField.js +52 -0
  243. package/dist/secrets/ui/components/SecretVersionDrawer.d.ts +22 -0
  244. package/dist/secrets/ui/components/SecretVersionDrawer.js +131 -0
  245. package/dist/secrets/ui/components/SecretsTable.d.ts +49 -0
  246. package/dist/secrets/ui/components/SecretsTable.js +174 -0
  247. package/dist/secrets/ui/components/TotpCodeCard.d.ts +8 -0
  248. package/dist/secrets/ui/components/TotpCodeCard.js +34 -0
  249. package/dist/secrets/ui/index.d.ts +20 -0
  250. package/dist/secrets/ui/index.js +21 -0
  251. package/dist/secrets/ui/pages/CreateSecretPage.d.ts +2 -0
  252. package/dist/secrets/ui/pages/CreateSecretPage.js +25 -0
  253. package/dist/secrets/ui/pages/CreateSecretTypePage.d.ts +1 -0
  254. package/dist/secrets/ui/pages/CreateSecretTypePage.js +62 -0
  255. package/dist/secrets/ui/pages/EditSecretPage.d.ts +5 -0
  256. package/dist/secrets/ui/pages/EditSecretPage.js +55 -0
  257. package/dist/secrets/ui/pages/EditSecretTypePage.d.ts +1 -0
  258. package/dist/secrets/ui/pages/EditSecretTypePage.js +88 -0
  259. package/dist/secrets/ui/pages/SecretDetailPage.d.ts +7 -0
  260. package/dist/secrets/ui/pages/SecretDetailPage.js +191 -0
  261. package/dist/secrets/ui/pages/SecretTypesPage.d.ts +1 -0
  262. package/dist/secrets/ui/pages/SecretTypesPage.js +23 -0
  263. package/dist/secrets/ui/pages/SecretsPage.d.ts +6 -0
  264. package/dist/secrets/ui/pages/SecretsPage.js +179 -0
  265. package/dist/settings/ui/components/FeatureFlagsList.d.ts +7 -0
  266. package/dist/settings/ui/components/FeatureFlagsList.js +46 -0
  267. package/dist/settings/ui/components/ImageUpload.d.ts +6 -0
  268. package/dist/settings/ui/components/ImageUpload.js +61 -0
  269. package/dist/settings/ui/components/ProfileSettings.d.ts +11 -0
  270. package/dist/settings/ui/components/ProfileSettings.js +55 -0
  271. package/dist/settings/ui/components/ThemeSettings.d.ts +7 -0
  272. package/dist/settings/ui/components/ThemeSettings.js +24 -0
  273. package/dist/settings/ui/components/UISettings.d.ts +9 -0
  274. package/dist/settings/ui/components/UISettings.js +25 -0
  275. package/dist/settings/ui/components/UserProfileCard.d.ts +1 -0
  276. package/dist/settings/ui/components/UserProfileCard.js +39 -0
  277. package/dist/settings/ui/components/UserSettingsSection.d.ts +23 -0
  278. package/dist/settings/ui/components/UserSettingsSection.js +29 -0
  279. package/dist/settings/ui/index.d.ts +10 -0
  280. package/dist/settings/ui/index.js +11 -0
  281. package/dist/settings/ui/pages/AppearanceSettingsPage.d.ts +6 -0
  282. package/dist/settings/ui/pages/AppearanceSettingsPage.js +11 -0
  283. package/dist/settings/ui/pages/GeneralSettingsPage.d.ts +9 -0
  284. package/dist/settings/ui/pages/GeneralSettingsPage.js +41 -0
  285. package/dist/settings/ui/pages/ProfileSettingsPage.d.ts +6 -0
  286. package/dist/settings/ui/pages/ProfileSettingsPage.js +12 -0
  287. package/package.json +144 -4
@@ -0,0 +1,197 @@
1
+ /**
2
+ * Pure helpers for the secrets UI (E10.4, issue #95): form validation that
3
+ * mirrors the API, copy formatting, the version diff and date labels.
4
+ *
5
+ * Nothing here holds a secret value beyond the call that receives it.
6
+ */
7
+ import { parseTotpSecret } from '@marinoscar/vault-contract/secrets';
8
+ import { CARD_TYPE_NAME } from '../../cards/headless/useCards.js';
9
+ import { formatCardNumberForCopy, formatSecurityCodeForCopy, formatExpiryMonthForCopy, formatExpiryYearShortForCopy, } from '../../cards/headless/cardFormat.js';
10
+ /** Bounds of `createSecretSchema` / `updateSecretSchema` in the API. */
11
+ export const SECRET_NAME_MAX = 255;
12
+ export const SECRET_DESCRIPTION_MAX = 1000;
13
+ /** How long a copied secret value may stay on the clipboard (best effort). */
14
+ export const SECRET_CLIPBOARD_CLEAR_MS = 30_000;
15
+ /** How long a revealed value stays on screen before it is masked again. */
16
+ export const SECRET_REVEAL_TIMEOUT_MS = 30_000;
17
+ /** True for the system Card type, whose secrets also live in the Cards flows. */
18
+ export function isCardType(type) {
19
+ return Boolean(type?.isSystem && type.name === CARD_TYPE_NAME);
20
+ }
21
+ function isBlank(value) {
22
+ return value === undefined || value === null || String(value).trim() === '';
23
+ }
24
+ /** The Credential field that holds the authenticator key. */
25
+ export const TOTP_FIELD_NAME = 'totp';
26
+ /** Shown under the authenticator-key field when the pasted text is not a usable key. */
27
+ export const TOTP_FIELD_HELP = "Paste the setup key or the otpauth:// link from the site's QR code setup";
28
+ /**
29
+ * Map a failed save to per-field messages. The API answers 400 with
30
+ * `details.errors` entries such as `Field "totp" ...`; the totp one becomes the
31
+ * friendly help text, any other field's message is kept as sent. Empty when the
32
+ * error carries nothing field-specific.
33
+ */
34
+ export function fieldErrorsFromApiError(err, fields) {
35
+ const raw = err?.details?.errors;
36
+ if (!Array.isArray(raw))
37
+ return {};
38
+ const out = {};
39
+ for (const entry of raw) {
40
+ const text = typeof entry === 'string' ? entry : '';
41
+ const match = /^Field "([^"]+)"/.exec(text);
42
+ const name = match?.[1];
43
+ if (!name || !fields.some((f) => f.name === name))
44
+ continue;
45
+ out[name] = name === TOTP_FIELD_NAME ? TOTP_FIELD_HELP : text;
46
+ }
47
+ return out;
48
+ }
49
+ /**
50
+ * Validate field values against the type's field definitions, with the same
51
+ * rules `SecretsService.validateDataAgainstType` applies on the server: a
52
+ * required field is non-empty, a number parses, a date is a real date and a
53
+ * select value is one of its options (when options exist). Empty optional
54
+ * fields are fine.
55
+ *
56
+ * @returns field name to message; empty when valid.
57
+ */
58
+ export function validateSecretFields(fields, data) {
59
+ const errors = {};
60
+ for (const field of fields) {
61
+ const value = data[field.name];
62
+ if (isBlank(value)) {
63
+ if (field.required)
64
+ errors[field.name] = `${field.label} is required`;
65
+ continue;
66
+ }
67
+ if (field.name === TOTP_FIELD_NAME && field.sensitive) {
68
+ if (parseTotpSecret(String(value)) === null)
69
+ errors[field.name] = TOTP_FIELD_HELP;
70
+ }
71
+ else if (field.type === 'number' && Number.isNaN(Number(value))) {
72
+ errors[field.name] = `${field.label} must be a number`;
73
+ }
74
+ else if (field.type === 'date' && Number.isNaN(new Date(String(value)).getTime())) {
75
+ errors[field.name] = `${field.label} must be a valid date`;
76
+ }
77
+ else if (field.type === 'select') {
78
+ const options = Array.isArray(field.options) ? field.options : [];
79
+ if (options.length > 0 && !options.includes(String(value))) {
80
+ errors[field.name] = `${field.label} must be one of: ${options.join(', ')}`;
81
+ }
82
+ }
83
+ }
84
+ return errors;
85
+ }
86
+ /** Validate the whole create/edit form; `hasErrors` tells whether to submit. */
87
+ export function validateSecretForm(input) {
88
+ const errors = { fields: validateSecretFields(input.fields, input.data) };
89
+ const name = input.name.trim();
90
+ if (name === '')
91
+ errors.name = 'Name is required';
92
+ else if (name.length > SECRET_NAME_MAX)
93
+ errors.name = `Name must be at most ${SECRET_NAME_MAX} characters`;
94
+ if (input.description.trim().length > SECRET_DESCRIPTION_MAX) {
95
+ errors.description = `Description must be at most ${SECRET_DESCRIPTION_MAX} characters`;
96
+ }
97
+ if (input.requireType && !input.typeId)
98
+ errors.typeId = 'Type is required';
99
+ const hasErrors = Boolean(errors.name || errors.description || errors.typeId) ||
100
+ Object.keys(errors.fields).length > 0;
101
+ return { errors, hasErrors };
102
+ }
103
+ /**
104
+ * Drop keys the type does not declare and empty optional values, so the body
105
+ * never carries a field the API would refuse as unknown.
106
+ */
107
+ export function cleanSecretData(fields, data) {
108
+ const out = {};
109
+ for (const field of fields) {
110
+ const value = data[field.name];
111
+ if (!isBlank(value))
112
+ out[field.name] = value;
113
+ }
114
+ return out;
115
+ }
116
+ /** Card fields reformatted on copy so they paste cleanly into a checkout form. */
117
+ const CARD_COPY_FORMATTERS = {
118
+ number: formatCardNumberForCopy,
119
+ cvv: formatSecurityCodeForCopy,
120
+ security_code_2: formatSecurityCodeForCopy,
121
+ exp_month: formatExpiryMonthForCopy,
122
+ exp_year: formatExpiryYearShortForCopy,
123
+ };
124
+ /** The text a field's copy button puts on the clipboard. */
125
+ export function formatSecretValueForCopy(value, fieldName) {
126
+ const formatter = fieldName ? CARD_COPY_FORMATTERS[fieldName] : undefined;
127
+ if (!formatter)
128
+ return value;
129
+ const formatted = formatter(value);
130
+ // Formatters return '' for values they cannot parse; the stored value is
131
+ // more useful than nothing.
132
+ return formatted === '' ? value : formatted;
133
+ }
134
+ function asText(value) {
135
+ return value === undefined || value === null ? '' : String(value);
136
+ }
137
+ /**
138
+ * Compare a historical version's values with the current ones, field by
139
+ * field, in the type's field order. "added" means the current version has a
140
+ * value the inspected one lacks; "removed" the reverse.
141
+ */
142
+ export function diffSecretValues(fields, versionValues, currentValues) {
143
+ return fields.map((field) => {
144
+ const version = asText(versionValues[field.name]);
145
+ const current = asText(currentValues[field.name]);
146
+ let change = 'unchanged';
147
+ if (version !== current) {
148
+ if (version === '')
149
+ change = 'added';
150
+ else if (current === '')
151
+ change = 'removed';
152
+ else
153
+ change = 'changed';
154
+ }
155
+ return { field, change, version, current };
156
+ });
157
+ }
158
+ /** "just now", "5m ago", "3h ago", "2d ago", then a locale date past 30 days. */
159
+ export function formatRelativeTime(dateString, now = new Date()) {
160
+ const date = new Date(dateString);
161
+ const diffMs = now.getTime() - date.getTime();
162
+ const minutes = Math.floor(diffMs / 60_000);
163
+ const hours = Math.floor(minutes / 60);
164
+ const days = Math.floor(hours / 24);
165
+ if (days > 30)
166
+ return date.toLocaleDateString();
167
+ if (days > 0)
168
+ return `${days}d ago`;
169
+ if (hours > 0)
170
+ return `${hours}h ago`;
171
+ if (minutes > 0)
172
+ return `${minutes}m ago`;
173
+ return 'just now';
174
+ }
175
+ /** True for the system `Credential` type, the only one that may be opened to agents. */
176
+ export function supportsAgentAccess(type) {
177
+ return !!type && type.name === 'Credential' && type.isSystem !== false;
178
+ }
179
+ /** True for the system type `name` (`Card`, `Identity`): the ones with their own agent-access panel (ADR-0003). */
180
+ export function isSystemType(type, name) {
181
+ return !!type && type.name === name && type.isSystem !== false;
182
+ }
183
+ /** A friendly message for a failed agent-access change. */
184
+ export function agentAccessErrorMessage(err) {
185
+ const code = err?.code;
186
+ if (code === 'AGENT_ACCESS_UNSUPPORTED_TYPE') {
187
+ return 'Only a login, a card or an identity item can be opened to agents.';
188
+ }
189
+ if (code === 'OWNER_SESSION_REQUIRED') {
190
+ return 'Sign in to Vault to change what agents may do with this item.';
191
+ }
192
+ const status = err?.status;
193
+ if (status === 403) {
194
+ return 'You cannot change agent access for this secret.';
195
+ }
196
+ return err instanceof Error ? err.message : 'Failed to update agent access';
197
+ }
@@ -0,0 +1,34 @@
1
+ import type { SecretAgentAccess, SecretAttachment, SecretDetail, SecretVersion, SecretVersionDetail } from '../../core/headless/types.js';
2
+ /**
3
+ * A version detail as `GET /secrets/:id/versions/:versionId` actually returns
4
+ * it: the API includes the attachments the version owns (carried forward when
5
+ * the version was minted), which is what lets a historical version render its
6
+ * own card photos rather than the current ones.
7
+ *
8
+ * Declared here rather than widened in `types/index.ts` because the shared
9
+ * `SecretVersionDetail` is consumed by callers that do not read attachments;
10
+ * `attachments` is optional so a response without it still type-checks.
11
+ */
12
+ export interface SecretVersionDetailWithAttachments extends SecretVersionDetail {
13
+ attachments?: SecretAttachment[];
14
+ }
15
+ interface UseSecretDetailResult {
16
+ secret: SecretDetail | null;
17
+ versions: SecretVersion[];
18
+ isLoading: boolean;
19
+ error: string | null;
20
+ fetchSecret: (id: string) => Promise<void>;
21
+ updateSecret: (id: string, data: {
22
+ name?: string;
23
+ description?: string | null;
24
+ data?: Record<string, unknown>;
25
+ }) => Promise<void>;
26
+ fetchVersions: (secretId: string) => Promise<void>;
27
+ fetchVersion: (secretId: string, versionId: string) => Promise<SecretVersionDetailWithAttachments>;
28
+ rollback: (secretId: string, versionId: string) => Promise<void>;
29
+ /** Throws on failure (the caller shows it); does not set the hook's `error`. */
30
+ /** `allowedOrigins`: Identity only (ADR-0003); omit to keep them. */
31
+ setAgentAccess: (id: string, agentAccess: SecretAgentAccess, allowedOrigins?: string[]) => Promise<void>;
32
+ }
33
+ export declare function useSecretDetail(): UseSecretDetailResult;
34
+ export {};
@@ -0,0 +1,88 @@
1
+ import { useState, useCallback } from 'react';
2
+ import { getSecret as fetchSecretApi, updateSecret as updateSecretApi, getSecretVersions as fetchVersionsApi, getSecretVersion as fetchVersionApi, rollbackSecretVersion as rollbackApi, updateSecretAgentAccess as updateAgentAccessApi, } from '../../core/headless/api.js';
3
+ export function useSecretDetail() {
4
+ const [secret, setSecret] = useState(null);
5
+ const [versions, setVersions] = useState([]);
6
+ const [isLoading, setIsLoading] = useState(false);
7
+ const [error, setError] = useState(null);
8
+ const fetchSecret = useCallback(async (id) => {
9
+ setIsLoading(true);
10
+ setError(null);
11
+ try {
12
+ const result = await fetchSecretApi(id);
13
+ setSecret(result);
14
+ }
15
+ catch (err) {
16
+ const message = err instanceof Error ? err.message : 'Failed to fetch secret';
17
+ setError(message);
18
+ setSecret(null);
19
+ }
20
+ finally {
21
+ setIsLoading(false);
22
+ }
23
+ }, []);
24
+ const updateSecret = useCallback(async (id, data) => {
25
+ setError(null);
26
+ try {
27
+ const result = await updateSecretApi(id, data);
28
+ setSecret(result);
29
+ }
30
+ catch (err) {
31
+ const message = err instanceof Error ? err.message : 'Failed to update secret';
32
+ setError(message);
33
+ throw err;
34
+ }
35
+ }, []);
36
+ const fetchVersions = useCallback(async (secretId) => {
37
+ setError(null);
38
+ try {
39
+ const result = await fetchVersionsApi(secretId);
40
+ setVersions(result);
41
+ }
42
+ catch (err) {
43
+ const message = err instanceof Error ? err.message : 'Failed to fetch versions';
44
+ setError(message);
45
+ }
46
+ }, []);
47
+ const fetchVersion = useCallback(async (secretId, versionId) => {
48
+ setError(null);
49
+ try {
50
+ return await fetchVersionApi(secretId, versionId);
51
+ }
52
+ catch (err) {
53
+ const message = err instanceof Error ? err.message : 'Failed to fetch version';
54
+ setError(message);
55
+ throw err;
56
+ }
57
+ }, []);
58
+ const rollback = useCallback(async (secretId, versionId) => {
59
+ setError(null);
60
+ try {
61
+ const result = await rollbackApi(secretId, versionId);
62
+ setSecret(result);
63
+ // Refresh versions list
64
+ await fetchVersions(secretId);
65
+ }
66
+ catch (err) {
67
+ const message = err instanceof Error ? err.message : 'Failed to rollback';
68
+ setError(message);
69
+ throw err;
70
+ }
71
+ }, [fetchVersions]);
72
+ const setAgentAccess = useCallback(async (id, agentAccess, allowedOrigins) => {
73
+ const result = await updateAgentAccessApi(id, agentAccess, allowedOrigins);
74
+ // Only the agent-access fields change; keep the loaded values and attachments.
75
+ setSecret((prev) => prev
76
+ ? {
77
+ ...prev,
78
+ agentAccess: result.agentAccess ?? agentAccess,
79
+ agentAccessChangedAt: result.agentAccessChangedAt ?? prev.agentAccessChangedAt,
80
+ agentOrigins: result.agentOrigins ?? prev.agentOrigins,
81
+ }
82
+ : result);
83
+ }, []);
84
+ return {
85
+ secret, versions, isLoading, error,
86
+ fetchSecret, updateSecret, fetchVersions, fetchVersion, rollback, setAgentAccess,
87
+ };
88
+ }
@@ -0,0 +1,16 @@
1
+ import type { SecretType } from '../../core/headless/types.js';
2
+ import { createSecretType as createSecretTypeApi, updateSecretType as updateSecretTypeApi } from '../../core/headless/api.js';
3
+ interface UseSecretTypesResult {
4
+ types: SecretType[];
5
+ isLoading: boolean;
6
+ error: string | null;
7
+ fetchTypes: (params?: {
8
+ search?: string;
9
+ includeSystem?: boolean;
10
+ }) => Promise<void>;
11
+ createType: (data: Parameters<typeof createSecretTypeApi>[0]) => Promise<SecretType>;
12
+ updateType: (id: string, data: Parameters<typeof updateSecretTypeApi>[1]) => Promise<SecretType>;
13
+ deleteType: (id: string) => Promise<void>;
14
+ }
15
+ export declare function useSecretTypes(): UseSecretTypesResult;
16
+ export {};
@@ -0,0 +1,62 @@
1
+ import { useState, useCallback } from 'react';
2
+ import { getSecretTypes as fetchSecretTypesApi, createSecretType as createSecretTypeApi, updateSecretType as updateSecretTypeApi, deleteSecretType as deleteSecretTypeApi, } from '../../core/headless/api.js';
3
+ export function useSecretTypes() {
4
+ const [types, setTypes] = useState([]);
5
+ const [isLoading, setIsLoading] = useState(false);
6
+ const [error, setError] = useState(null);
7
+ const fetchTypes = useCallback(async (params) => {
8
+ setIsLoading(true);
9
+ setError(null);
10
+ try {
11
+ const result = await fetchSecretTypesApi(params);
12
+ setTypes(result);
13
+ }
14
+ catch (err) {
15
+ const message = err instanceof Error ? err.message : 'Failed to fetch secret types';
16
+ setError(message);
17
+ setTypes([]);
18
+ }
19
+ finally {
20
+ setIsLoading(false);
21
+ }
22
+ }, []);
23
+ const createType = useCallback(async (data) => {
24
+ setError(null);
25
+ try {
26
+ const result = await createSecretTypeApi(data);
27
+ await fetchTypes();
28
+ return result;
29
+ }
30
+ catch (err) {
31
+ const message = err instanceof Error ? err.message : 'Failed to create secret type';
32
+ setError(message);
33
+ throw err;
34
+ }
35
+ }, [fetchTypes]);
36
+ const updateType = useCallback(async (id, data) => {
37
+ setError(null);
38
+ try {
39
+ const result = await updateSecretTypeApi(id, data);
40
+ await fetchTypes();
41
+ return result;
42
+ }
43
+ catch (err) {
44
+ const message = err instanceof Error ? err.message : 'Failed to update secret type';
45
+ setError(message);
46
+ throw err;
47
+ }
48
+ }, [fetchTypes]);
49
+ const deleteType = useCallback(async (id) => {
50
+ setError(null);
51
+ try {
52
+ await deleteSecretTypeApi(id);
53
+ await fetchTypes();
54
+ }
55
+ catch (err) {
56
+ const message = err instanceof Error ? err.message : 'Failed to delete secret type';
57
+ setError(message);
58
+ throw err;
59
+ }
60
+ }, [fetchTypes]);
61
+ return { types, isLoading, error, fetchTypes, createType, updateType, deleteType };
62
+ }
@@ -0,0 +1,24 @@
1
+ import type { SecretAgentAccess, SecretListItem } from '../../core/headless/types.js';
2
+ import { createSecret as createSecretApi } from '../../core/headless/api.js';
3
+ interface UseSecretsResult {
4
+ secrets: SecretListItem[];
5
+ totalItems: number;
6
+ page: number;
7
+ pageSize: number;
8
+ totalPages: number;
9
+ isLoading: boolean;
10
+ error: string | null;
11
+ fetchSecrets: (params?: {
12
+ page?: number;
13
+ pageSize?: number;
14
+ typeId?: string;
15
+ search?: string;
16
+ sortBy?: string;
17
+ sortOrder?: string;
18
+ agentAccess?: SecretAgentAccess;
19
+ }) => Promise<void>;
20
+ createSecret: (data: Parameters<typeof createSecretApi>[0]) => Promise<void>;
21
+ deleteSecret: (id: string) => Promise<void>;
22
+ }
23
+ export declare function useSecrets(): UseSecretsResult;
24
+ export {};
@@ -0,0 +1,59 @@
1
+ import { useState, useCallback } from 'react';
2
+ import { getSecrets as fetchSecretsApi, createSecret as createSecretApi, deleteSecret as deleteSecretApi, } from '../../core/headless/api.js';
3
+ export function useSecrets() {
4
+ const [secrets, setSecrets] = useState([]);
5
+ const [totalItems, setTotalItems] = useState(0);
6
+ const [page, setPage] = useState(1);
7
+ const [pageSize, setPageSize] = useState(20);
8
+ const [totalPages, setTotalPages] = useState(0);
9
+ const [isLoading, setIsLoading] = useState(false);
10
+ const [error, setError] = useState(null);
11
+ const fetchSecrets = useCallback(async (params) => {
12
+ setIsLoading(true);
13
+ setError(null);
14
+ try {
15
+ const response = await fetchSecretsApi(params);
16
+ setSecrets(response.items);
17
+ setTotalItems(response.meta.totalItems);
18
+ setPage(response.meta.page);
19
+ setPageSize(response.meta.pageSize);
20
+ setTotalPages(response.meta.totalPages);
21
+ }
22
+ catch (err) {
23
+ const message = err instanceof Error ? err.message : 'Failed to fetch secrets';
24
+ setError(message);
25
+ setSecrets([]);
26
+ }
27
+ finally {
28
+ setIsLoading(false);
29
+ }
30
+ }, []);
31
+ const createSecret = useCallback(async (data) => {
32
+ setError(null);
33
+ try {
34
+ await createSecretApi(data);
35
+ await fetchSecrets({ page, pageSize });
36
+ }
37
+ catch (err) {
38
+ const message = err instanceof Error ? err.message : 'Failed to create secret';
39
+ setError(message);
40
+ throw err;
41
+ }
42
+ }, [fetchSecrets, page, pageSize]);
43
+ const deleteSecret = useCallback(async (id) => {
44
+ setError(null);
45
+ try {
46
+ await deleteSecretApi(id);
47
+ await fetchSecrets({ page, pageSize });
48
+ }
49
+ catch (err) {
50
+ const message = err instanceof Error ? err.message : 'Failed to delete secret';
51
+ setError(message);
52
+ throw err;
53
+ }
54
+ }, [fetchSecrets, page, pageSize]);
55
+ return {
56
+ secrets, totalItems, page, pageSize, totalPages, isLoading, error,
57
+ fetchSecrets, createSecret, deleteSecret,
58
+ };
59
+ }
@@ -0,0 +1,24 @@
1
+ export type TotpStatus = 'idle' | 'loading' | 'ready' | 'error';
2
+ export interface UseTotpCodeResult {
3
+ status: TotpStatus;
4
+ /** The current code (digits only), or null until shown. Held in state only, never stored. */
5
+ code: string | null;
6
+ period: number;
7
+ /** Milliseconds until the code expires; 0 when none. */
8
+ remainingMs: number;
9
+ /** A friendly message when `status` is `error`. */
10
+ error: string | null;
11
+ /** Fetch a code now (the "Show code" action). */
12
+ show: () => void;
13
+ /** Forget the code and stop refreshing. */
14
+ hide: () => void;
15
+ }
16
+ /** "123456" -> "123 456"; "12345678" -> "1234 5678". */
17
+ export declare function groupTotpCode(code: string): string;
18
+ /**
19
+ * The on-demand authenticator code of one secret. Nothing is fetched until
20
+ * {@link UseTotpCodeResult.show}; the code lives in component state only, is
21
+ * re-fetched when it expires while the page is visible, and is dropped on
22
+ * unmount or hide. A hidden tab does not refresh; it catches up when shown.
23
+ */
24
+ export declare function useTotpCode(secretId: string): UseTotpCodeResult;
@@ -0,0 +1,116 @@
1
+ import { useCallback, useEffect, useRef, useState } from 'react';
2
+ import { getSecretTotp } from '../../core/headless/api.js';
3
+ /** "123456" -> "123 456"; "12345678" -> "1234 5678". */
4
+ export function groupTotpCode(code) {
5
+ if (code.length === 8)
6
+ return `${code.slice(0, 4)} ${code.slice(4)}`;
7
+ if (code.length % 3 === 0)
8
+ return code.replace(/(.{3})(?=.)/g, '$1 ');
9
+ const half = Math.ceil(code.length / 2);
10
+ return `${code.slice(0, half)} ${code.slice(half)}`;
11
+ }
12
+ function describeError(err) {
13
+ if (err?.status === 404) {
14
+ return 'This secret has no authenticator key. Add one by editing the secret.';
15
+ }
16
+ if (err?.status === 403) {
17
+ return 'You cannot read codes for this secret.';
18
+ }
19
+ return 'Could not get a code. Try again.';
20
+ }
21
+ const TICK_MS = 250;
22
+ /**
23
+ * The on-demand authenticator code of one secret. Nothing is fetched until
24
+ * {@link UseTotpCodeResult.show}; the code lives in component state only, is
25
+ * re-fetched when it expires while the page is visible, and is dropped on
26
+ * unmount or hide. A hidden tab does not refresh; it catches up when shown.
27
+ */
28
+ export function useTotpCode(secretId) {
29
+ const [status, setStatus] = useState('idle');
30
+ const [data, setData] = useState(null);
31
+ const [error, setError] = useState(null);
32
+ const [now, setNow] = useState(() => Date.now());
33
+ const wanted = useRef(false);
34
+ const inFlight = useRef(false);
35
+ // Synchronous copy of the expiry so a tick never acts on a stale (already replaced) code.
36
+ const expiryRef = useRef(0);
37
+ const mounted = useRef(true);
38
+ useEffect(() => {
39
+ mounted.current = true;
40
+ return () => {
41
+ mounted.current = false;
42
+ wanted.current = false;
43
+ };
44
+ }, []);
45
+ const load = useCallback(async () => {
46
+ if (inFlight.current)
47
+ return;
48
+ inFlight.current = true;
49
+ try {
50
+ const result = await getSecretTotp(secretId);
51
+ if (!mounted.current || !wanted.current)
52
+ return;
53
+ expiryRef.current = new Date(result.expiresAt).getTime();
54
+ setData(result);
55
+ setError(null);
56
+ setNow(Date.now());
57
+ setStatus('ready');
58
+ }
59
+ catch (err) {
60
+ if (!mounted.current || !wanted.current)
61
+ return;
62
+ wanted.current = false;
63
+ expiryRef.current = 0;
64
+ setData(null);
65
+ setError(describeError(err));
66
+ setStatus('error');
67
+ }
68
+ finally {
69
+ inFlight.current = false;
70
+ }
71
+ }, [secretId]);
72
+ const show = useCallback(() => {
73
+ wanted.current = true;
74
+ setError(null);
75
+ setStatus((s) => (s === 'ready' ? s : 'loading'));
76
+ void load();
77
+ }, [load]);
78
+ const hide = useCallback(() => {
79
+ wanted.current = false;
80
+ expiryRef.current = 0;
81
+ setData(null);
82
+ setError(null);
83
+ setStatus('idle');
84
+ }, []);
85
+ const expiresMs = data ? new Date(data.expiresAt).getTime() : 0;
86
+ // Tick for the countdown and refresh when the code has expired and the page is visible.
87
+ useEffect(() => {
88
+ if (!data)
89
+ return undefined;
90
+ const tick = () => {
91
+ const t = Date.now();
92
+ setNow(t);
93
+ if (t >= expiryRef.current && document.visibilityState !== 'hidden')
94
+ void load();
95
+ };
96
+ const timer = setInterval(tick, TICK_MS);
97
+ const onVisible = () => {
98
+ if (document.visibilityState === 'visible')
99
+ tick();
100
+ };
101
+ document.addEventListener('visibilitychange', onVisible);
102
+ return () => {
103
+ clearInterval(timer);
104
+ document.removeEventListener('visibilitychange', onVisible);
105
+ };
106
+ }, [data, load]);
107
+ return {
108
+ status,
109
+ code: data ? data.code : null,
110
+ period: data?.period ?? 30,
111
+ remainingMs: data ? Math.max(0, expiresMs - now) : 0,
112
+ error,
113
+ show,
114
+ hide,
115
+ };
116
+ }
@@ -0,0 +1,31 @@
1
+ import type { AttachmentRole, SecretAttachment, SecretType } from '../../../core/headless/types.js';
2
+ /**
3
+ * Whether a secret should offer card front/back image slots.
4
+ *
5
+ * Attachments are the gate: a type that forbids them can never hold a card
6
+ * face. Beyond that, the system Card type always gets slots (so a brand new
7
+ * card offers somewhere to put its photos), and any other type gets them only
8
+ * once it actually holds a role-bearing attachment — which keeps a Document,
9
+ * whose attachments are all role-less, completely unaffected.
10
+ */
11
+ export declare function supportsCardImages(type: SecretType | null | undefined, attachments?: SecretAttachment[]): boolean;
12
+ /** Pick the single attachment holding a given card role, if any. */
13
+ export declare function findCardImage(attachments: SecretAttachment[], role: AttachmentRole): SecretAttachment | undefined;
14
+ export interface CardImagesProps {
15
+ secretId: string;
16
+ attachments: SecretAttachment[];
17
+ /** Called after an upload or removal so the caller can refetch the secret. */
18
+ onChange?: () => void;
19
+ /** Historical versions are immutable — no upload or remove controls. */
20
+ readOnly?: boolean;
21
+ title?: string;
22
+ }
23
+ /**
24
+ * Front and back card face images for a secret.
25
+ *
26
+ * Both faces stay concealed until the viewer asks for them: a card photo shows
27
+ * the number, the holder's name and often the signature strip, so it is card
28
+ * data in exactly the same sense as the fields in `DynamicSecretFields`, and is
29
+ * gated the same way.
30
+ */
31
+ export declare function CardImages({ secretId, attachments, onChange, readOnly, title, }: CardImagesProps): import("react").JSX.Element;