@rapidmx/web-client 0.20.0 → 0.21.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 (118) hide show
  1. package/README.md +381 -381
  2. package/apps/admin/branding/index.tsx +39 -39
  3. package/apps/admin/data-requests/index.tsx +482 -482
  4. package/apps/admin/domains/[uid].tsx +166 -166
  5. package/apps/admin/escrow-scopes/[uid].tsx +350 -350
  6. package/apps/admin/index.tsx +129 -129
  7. package/apps/admin/mailboxes/[uid].tsx +271 -271
  8. package/apps/admin/mailboxes/new/index.tsx +30 -30
  9. package/apps/admin/plugins/index.tsx +15 -15
  10. package/apps/admin/retention-policy/index.tsx +39 -39
  11. package/apps/admin/signing-certificates/index.tsx +343 -343
  12. package/apps/escrow/audit-log/index.tsx +196 -196
  13. package/apps/escrow/matters/[uid].tsx +621 -621
  14. package/apps/shared/auth/adminAccess.ts +99 -99
  15. package/apps/shared/components/admin/layout/AdminShell.tsx +384 -384
  16. package/apps/shared/components/admin/mailboxes/EraseLeftoverDataDialog.tsx +238 -238
  17. package/apps/shared/components/admin/mailboxes/EscrowScopeCard.tsx +152 -152
  18. package/apps/shared/components/admin/mailboxes/LeftoverMailboxesSection.tsx +194 -194
  19. package/apps/shared/components/admin/settings/BrandingForm.tsx +423 -423
  20. package/apps/shared/components/admin/settings/EncryptionPolicyForm.tsx +119 -119
  21. package/apps/shared/components/admin/settings/MailboxPolicyForm.tsx +198 -198
  22. package/apps/shared/components/admin/settings/PluginsManager.tsx +2093 -2093
  23. package/apps/shared/components/admin/settings/RetentionPolicyForm.tsx +182 -182
  24. package/apps/shared/components/admin/setup/EscrowSetupStep.tsx +288 -288
  25. package/apps/shared/components/admin/setup/SetupWizard.tsx +446 -446
  26. package/apps/shared/components/admin/usePagedList.tsx +129 -129
  27. package/apps/shared/components/calendar/EventModal.tsx +206 -206
  28. package/apps/shared/components/calendar/MonthView.tsx +185 -185
  29. package/apps/shared/components/calendar/RecurrenceEditor.tsx +227 -227
  30. package/apps/shared/components/calendar/SplitDayView.tsx +144 -144
  31. package/apps/shared/components/calendar/TimeGridView.tsx +246 -246
  32. package/apps/shared/components/calendar/allDay.ts +124 -124
  33. package/apps/shared/components/contacts/ContactForm.tsx +383 -383
  34. package/apps/shared/components/contacts/ContactsToolbar.tsx +103 -103
  35. package/apps/shared/components/escrow/layout/EscrowShell.tsx +155 -155
  36. package/apps/shared/components/layout/AppShell.tsx +463 -461
  37. package/apps/shared/components/layout/KeyEnrollmentGate.tsx +398 -398
  38. package/apps/shared/components/layout/MailboxProvisioning.tsx +168 -168
  39. package/apps/shared/components/layout/ResponsiveToolbar.tsx +315 -315
  40. package/apps/shared/components/layout/ThemeSwitch.tsx +84 -84
  41. package/apps/shared/components/layout/UserMenu.tsx +439 -439
  42. package/apps/shared/components/mail/ConversationList.tsx +332 -332
  43. package/apps/shared/components/mail/ConversationThreadPane.tsx +613 -613
  44. package/apps/shared/components/mail/MailSelectionBar.tsx +240 -240
  45. package/apps/shared/components/mail/MenuButton.tsx +404 -404
  46. package/apps/shared/components/mail/MessageDetailPane.tsx +1757 -1757
  47. package/apps/shared/components/mail/compose/ComposeContext.tsx +312 -312
  48. package/apps/shared/components/mail/compose/ComposeToolbar.tsx +422 -422
  49. package/apps/shared/components/mail/compose/ComposeWindow.tsx +1705 -1681
  50. package/apps/shared/components/mail/compose/RichTextEditor.tsx +147 -147
  51. package/apps/shared/components/mail/compose/composeFlushRegistry.ts +60 -60
  52. package/apps/shared/components/mail/compose/quotedBody.ts +161 -161
  53. package/apps/shared/components/mail/reading/MessageMoreMenu.tsx +258 -258
  54. package/apps/shared/components/mail/reading/MessageSourceDialog.tsx +79 -79
  55. package/apps/shared/components/mail/reading/messageExport.ts +59 -59
  56. package/apps/shared/components/mail/reading/printMessage.ts +99 -99
  57. package/apps/shared/components/mail/reading/useMessageActions.ts +443 -443
  58. package/apps/shared/components/mail/verificationSeals.ts +125 -125
  59. package/apps/shared/components/rules/RuleBuilder.tsx +311 -311
  60. package/apps/shared/components/settings/SigningCertificateCard.tsx +344 -344
  61. package/apps/shared/keyboard/GlobalShortcuts.tsx +51 -51
  62. package/apps/shared/keyboard/ShortcutProvider.tsx +62 -62
  63. package/apps/shared/keyboard/ShortcutsDialog.tsx +84 -84
  64. package/apps/shared/keyboard/dispatch.ts +124 -124
  65. package/apps/shared/keyboard/format.ts +89 -89
  66. package/apps/shared/keyboard/keymap.ts +114 -114
  67. package/apps/shared/keyboard/registry.ts +65 -65
  68. package/apps/shared/keyboard/targets.ts +79 -79
  69. package/apps/shared/mail/folderOfType.ts +49 -49
  70. package/apps/shared/mail/folderTree.ts +143 -143
  71. package/apps/shared/mail/listAllPages.ts +39 -39
  72. package/apps/shared/mail/newMailNotifications.ts +171 -171
  73. package/apps/shared/mail/outbox/sendJob.ts +445 -445
  74. package/apps/shared/mail/outbox/sendOutcomes.ts +155 -155
  75. package/apps/shared/mail/reportNotices.ts +66 -66
  76. package/apps/shared/mail/senderBlocking.ts +141 -141
  77. package/apps/shared/mail/useMailConnection.ts +205 -205
  78. package/apps/shared/mail/useMailLiveUpdates.ts +277 -277
  79. package/apps/shared/mail/useMailboxUpdateAccess.ts +60 -60
  80. package/apps/shared/mail/useMarkMessageRead.ts +47 -47
  81. package/apps/shared/mail/useNewMailNotifications.ts +178 -178
  82. package/apps/shared/notifications/store.ts +560 -560
  83. package/apps/shared/search/LocalIndexLifecycle.tsx +114 -114
  84. package/apps/shared/search/localIndexBuilder.ts +481 -481
  85. package/apps/shared/signing/enrollmentStorage.ts +33 -33
  86. package/apps/shared/signing/enrollmentTracker.ts +385 -385
  87. package/apps/shared/signing/enrollmentView.ts +251 -251
  88. package/apps/shared/signing/useNow.ts +19 -19
  89. package/apps/shared/signing/useSigningEnrollmentWatcher.ts +90 -90
  90. package/apps/shared/styles/app.css +396 -396
  91. package/apps/www/calendar/index.tsx +581 -581
  92. package/apps/www/contacts/[uid].tsx +112 -112
  93. package/apps/www/index.tsx +3012 -3012
  94. package/apps/www/messages/[uid].tsx +139 -139
  95. package/apps/www/settings/auto-reply/index.tsx +136 -136
  96. package/apps/www/settings/blocked-senders/index.tsx +303 -303
  97. package/apps/www/settings/encryption/index.tsx +1290 -1290
  98. package/apps/www/settings/filters/[uid].tsx +179 -179
  99. package/apps/www/settings/filters/index.tsx +105 -105
  100. package/apps/www/settings/filters/new/index.tsx +165 -165
  101. package/apps/www/settings/labels/index.tsx +207 -207
  102. package/apps/www/settings/privacy/index.tsx +495 -495
  103. package/apps/www/settings/profile/index.tsx +251 -251
  104. package/apps/www/settings/read-receipts/index.tsx +150 -150
  105. package/apps/www/settings/sharing/index.tsx +259 -259
  106. package/apps/www/settings/signatures/[uid].tsx +175 -175
  107. package/apps/www/settings/signatures/index.tsx +91 -91
  108. package/apps/www/settings/signatures/new/index.tsx +138 -138
  109. package/apps/www/tasks/index.tsx +654 -654
  110. package/dist/apps/shared/components/admin/layout/AdminShell.js +2 -2
  111. package/dist/apps/shared/components/admin/settings/BrandingForm.js +3 -3
  112. package/dist/apps/shared/components/escrow/layout/EscrowShell.js +2 -2
  113. package/dist/apps/shared/components/layout/AppShell.js +4 -2
  114. package/dist/apps/shared/components/mail/compose/ComposeWindow.d.ts +7 -1
  115. package/dist/apps/shared/components/mail/compose/ComposeWindow.js +20 -1
  116. package/dist/apps/shared/components/mail/reading/printMessage.js +11 -11
  117. package/dist/apps/shared/styles/app.css +396 -396
  118. package/package.json +2 -2
@@ -1,343 +1,343 @@
1
- ///////////////////////////////////////////////////////////////////////////////
2
- // Copyright (C) 2026 Jean-Philippe Steinmetz
3
- // SPDX-License-Identifier: MPL-2.0
4
- ///////////////////////////////////////////////////////////////////////////////
5
- import React, { ChangeEvent, useEffect, useRef, useState } from "react";
6
- import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
7
- import {
8
- AdminSigningEnrollment,
9
- getSigningEnrollmentInfo,
10
- listSigningEnrollments,
11
- looksLikePemCertificate,
12
- rejectSigningEnrollment,
13
- signingEnrollmentCsrUrl,
14
- SigningEnrollmentInfo,
15
- uploadSigningEnrollmentCertificate,
16
- } from "@rapidmx/react-shared/crypto/signingProviderApi.js";
17
- import AdminShell, { AdminShellProps } from "../../shared/components/admin/layout/AdminShell.js";
18
- import Alert from "@rapidmx/react-shared/components/feedback/Alert.js";
19
- import Button from "@rapidmx/react-shared/components/buttons/Button.js";
20
- import Modal from "@rapidmx/react-shared/components/overlays/Modal.js";
21
- import { notify } from "../../shared/notifications/store.js";
22
-
23
- const INPUT_CLASS = "text-sm border border-border rounded-sm py-1.5 px-2 bg-surface";
24
- const TEXTAREA_CLASS = `${INPUT_CLASS} font-mono text-xs`;
25
-
26
- function errorMessage(err: unknown, fallback: string): string {
27
- return err instanceof ApiRequestError ? err.message : fallback;
28
- }
29
-
30
- function statusBadgeClass(status: AdminSigningEnrollment["status"]): string {
31
- if (status === "failed") return "bg-danger-bg text-danger";
32
- if (status === "pending") return "bg-surface-alt text-text-muted";
33
- return "bg-success text-white";
34
- }
35
-
36
- function providerLabel(provider: AdminSigningEnrollment["provider"]): string {
37
- return provider === "rfc8823" ? "Automatic (RFC 8823)" : "Manual";
38
- }
39
-
40
- export default function SigningCertificatesPage(props: Omit<AdminShellProps, "active">) {
41
- return (
42
- <AdminShell {...props} active="signingCertificates">
43
- <div className="flex flex-col gap-6">
44
- <div>
45
- <h1 className="text-xl font-bold uppercase tracking-wide mb-1">Signing Certificates</h1>
46
- <p className="text-sm text-text-muted">
47
- Every mailbox's pending signing (digital-signature) certificate request. Requests issued automatically by a
48
- certificate authority are listed for visibility only; a manual request needs a certificate uploaded here once
49
- the certificate authority has issued one.
50
- </p>
51
- </div>
52
- <BackendSummary />
53
- <EnrollmentsTable />
54
- </div>
55
- </AdminShell>
56
- );
57
- }
58
-
59
- /** How signing certificates are issued in this deployment - fetched once, since it doesn't change while the page is open. */
60
- function BackendSummary() {
61
- const [info, setInfo] = useState<SigningEnrollmentInfo | null>(null);
62
- const [error, setError] = useState<string | null>(null);
63
-
64
- useEffect(() => {
65
- getSigningEnrollmentInfo()
66
- .then(setInfo)
67
- .catch((err) => setError(errorMessage(err, "Could not load the signing certificate backend.")));
68
- }, []);
69
-
70
- if (error) {
71
- return <Alert>{error}</Alert>;
72
- }
73
- if (!info) {
74
- return null;
75
- }
76
- if (info.backend === "none") {
77
- return <p className="text-sm text-text-muted">Signing certificates are not enabled in this deployment.</p>;
78
- }
79
-
80
- return (
81
- <div className="text-sm border border-border rounded-sm p-3 bg-surface-alt flex flex-col gap-1">
82
- <span>
83
- <strong>{info.automatic ? "Automatic issuance" : "Manual issuance"}</strong>
84
- {info.ca && <> through {info.ca.host}</>}
85
- {info.typicalDurationMinutes !== undefined && <> &middot; typically {info.typicalDurationMinutes} minutes</>}
86
- </span>
87
- {info.health && !info.health.ok && (
88
- <span className="text-danger">
89
- The certificate authority could not be reached{info.health.lastError && <>: {info.health.lastError}</>}.
90
- </span>
91
- )}
92
- </div>
93
- );
94
- }
95
-
96
- function EnrollmentsTable() {
97
- const [items, setItems] = useState<AdminSigningEnrollment[] | null>(null);
98
- const [loadError, setLoadError] = useState<string | null>(null);
99
- const [uploadTarget, setUploadTarget] = useState<AdminSigningEnrollment | null>(null);
100
- const [rejectTarget, setRejectTarget] = useState<AdminSigningEnrollment | null>(null);
101
-
102
- async function reload() {
103
- try {
104
- setItems(await listSigningEnrollments());
105
- setLoadError(null);
106
- } catch (err) {
107
- setLoadError(errorMessage(err, "Could not load the pending signing certificate requests."));
108
- }
109
- }
110
-
111
- useEffect(() => {
112
- void reload();
113
- }, []);
114
-
115
- if (loadError) {
116
- return <Alert>{loadError}</Alert>;
117
- }
118
- if (items === null) {
119
- return <p className="text-sm text-text-muted">Loading&hellip;</p>;
120
- }
121
- if (items.length === 0) {
122
- return <p className="text-sm text-text-muted">No pending signing certificate requests.</p>;
123
- }
124
-
125
- return (
126
- <div className="overflow-x-auto">
127
- <table className="w-full text-sm border-collapse">
128
- <thead>
129
- <tr className="text-left text-xs font-bold uppercase tracking-wide text-text-muted border-b border-border">
130
- <th className="py-2 pr-3">Mailbox</th>
131
- <th className="py-2 pr-3">Requested</th>
132
- <th className="py-2 pr-3">Provider</th>
133
- <th className="py-2 pr-3">Status</th>
134
- <th className="py-2 pr-3">Actions</th>
135
- </tr>
136
- </thead>
137
- <tbody>
138
- {items.map((row) => (
139
- <tr key={row.enrollmentId} className="border-b border-border">
140
- <td className="py-2 pr-3 break-all">{row.identity}</td>
141
- <td className="py-2 pr-3 whitespace-nowrap">{new Date(row.requestedAt).toLocaleString()}</td>
142
- <td className="py-2 pr-3 whitespace-nowrap">{providerLabel(row.provider)}</td>
143
- <td className="py-2 pr-3">
144
- <span className={`text-xs font-bold uppercase tracking-wide py-0.5 px-2 rounded-pill ${statusBadgeClass(row.status)}`}>
145
- {row.status}
146
- </span>
147
- {row.lastError && <div className="text-xs text-danger mt-1 max-w-xs">{row.lastError}</div>}
148
- </td>
149
- <td className="py-2 pr-3">
150
- <div className="flex items-center gap-3 flex-wrap">
151
- {row.provider === "manual" && (
152
- <a
153
- href={signingEnrollmentCsrUrl(row.enrollmentId)}
154
- className="text-primary-dark hover:underline font-medium whitespace-nowrap"
155
- >
156
- Download CSR
157
- </a>
158
- )}
159
- {row.canUpload && (
160
- <Button type="button" variant="secondary" className="!w-auto" onClick={() => setUploadTarget(row)}>
161
- Upload certificate
162
- </Button>
163
- )}
164
- {row.status === "pending" && row.provider === "manual" && (
165
- <Button type="button" variant="secondary" className="!w-auto" onClick={() => setRejectTarget(row)}>
166
- Reject
167
- </Button>
168
- )}
169
- {row.uploadBlockedReason && !row.canUpload && (
170
- <span className="text-xs text-text-muted max-w-xs">{row.uploadBlockedReason}</span>
171
- )}
172
- </div>
173
- </td>
174
- </tr>
175
- ))}
176
- </tbody>
177
- </table>
178
-
179
- <UploadCertificateModal target={uploadTarget} onClose={() => setUploadTarget(null)} onDone={reload} />
180
- <RejectModal target={rejectTarget} onClose={() => setRejectTarget(null)} onDone={reload} />
181
- </div>
182
- );
183
- }
184
-
185
- function UploadCertificateModal({
186
- target,
187
- onClose,
188
- onDone,
189
- }: {
190
- target: AdminSigningEnrollment | null;
191
- onClose: () => void;
192
- onDone: () => Promise<void>;
193
- }) {
194
- const [certificate, setCertificate] = useState("");
195
- const [uploading, setUploading] = useState(false);
196
- const [error, setError] = useState<string | null>(null);
197
- const fileInputRef = useRef<HTMLInputElement>(null);
198
-
199
- function reset() {
200
- setCertificate("");
201
- setError(null);
202
- }
203
-
204
- function dismiss() {
205
- if (!uploading) {
206
- reset();
207
- onClose();
208
- }
209
- }
210
-
211
- function handleFileChange(e: ChangeEvent<HTMLInputElement>) {
212
- const file = e.target.files?.[0];
213
- e.target.value = "";
214
- if (!file) {
215
- return;
216
- }
217
- file.text()
218
- .then((text) => setCertificate(text))
219
- .catch(() => setError("Could not read this file."));
220
- }
221
-
222
- // Only invoked from the button below, which only renders once `target` is set (the modal's body) - same
223
- // non-null-assertion pattern as `data-requests`' `handleApprove()`/`handleDeny()`.
224
- async function handleUpload() {
225
- setError(null);
226
- setUploading(true);
227
- try {
228
- const result = await uploadSigningEnrollmentCertificate(target!.enrollmentId, certificate);
229
- notify({
230
- kind: "success",
231
- title: "Certificate accepted",
232
- message: `${result.identity}: ${result.message}`,
233
- });
234
- reset();
235
- onClose();
236
- await onDone();
237
- } catch (err) {
238
- setError(errorMessage(err, "Could not upload this certificate."));
239
- } finally {
240
- setUploading(false);
241
- }
242
- }
243
-
244
- const sane = looksLikePemCertificate(certificate);
245
-
246
- return (
247
- <Modal open={target !== null} onClose={dismiss} title="Upload signing certificate">
248
- <p className="text-sm mb-3">
249
- Paste, or choose a file for, the certificate (or certificate chain, leaf first) the certificate authority issued for{" "}
250
- <strong className="break-all">{target?.identity}</strong>.
251
- </p>
252
- <label className="flex flex-col gap-1.5 text-sm mb-3">
253
- <span className="font-semibold">Certificate (PEM)</span>
254
- <textarea
255
- aria-label="Certificate PEM"
256
- className={TEXTAREA_CLASS}
257
- rows={8}
258
- value={certificate}
259
- onChange={(e) => setCertificate(e.target.value)}
260
- placeholder="-----BEGIN CERTIFICATE-----&#10;...&#10;-----END CERTIFICATE-----"
261
- />
262
- </label>
263
- <div className="mb-4">
264
- <input ref={fileInputRef} type="file" accept=".pem,.crt,.cer,.txt" className="hidden" onChange={handleFileChange} />
265
- <Button type="button" variant="secondary" className="!w-auto" onClick={() => fileInputRef.current?.click()}>
266
- Choose file&hellip;
267
- </Button>
268
- </div>
269
- {certificate.trim() !== "" && !sane && (
270
- <p role="status" className="mb-3 py-2 px-3 rounded-sm text-xs bg-warning/15 text-text">
271
- This doesn't look like a PEM certificate (it should start with -----BEGIN CERTIFICATE-----).
272
- </p>
273
- )}
274
- {error && <Alert>{error}</Alert>}
275
- <div className="flex gap-3 justify-end mt-2">
276
- <Button type="button" variant="secondary" className="!w-auto" disabled={uploading} onClick={dismiss}>
277
- Cancel
278
- </Button>
279
- <Button type="button" className="!w-auto" loading={uploading} disabled={uploading || !certificate.trim()} onClick={handleUpload}>
280
- Upload
281
- </Button>
282
- </div>
283
- </Modal>
284
- );
285
- }
286
-
287
- function RejectModal({ target, onClose, onDone }: { target: AdminSigningEnrollment | null; onClose: () => void; onDone: () => Promise<void> }) {
288
- const [reason, setReason] = useState("");
289
- const [rejecting, setRejecting] = useState(false);
290
- const [error, setError] = useState<string | null>(null);
291
-
292
- function dismiss() {
293
- if (!rejecting) {
294
- setReason("");
295
- setError(null);
296
- onClose();
297
- }
298
- }
299
-
300
- // Only invoked from the button below, which only renders once `target` is set - see `handleUpload()`'s identical note.
301
- async function handleReject() {
302
- setError(null);
303
- setRejecting(true);
304
- try {
305
- await rejectSigningEnrollment(target!.enrollmentId, reason);
306
- notify({ kind: "info", title: "Request rejected", message: `${target!.identity}'s signing certificate request was rejected.` });
307
- setReason("");
308
- onClose();
309
- await onDone();
310
- } catch (err) {
311
- setError(errorMessage(err, "Could not reject this request."));
312
- } finally {
313
- setRejecting(false);
314
- }
315
- }
316
-
317
- return (
318
- <Modal open={target !== null} onClose={dismiss} title="Reject signing certificate request">
319
- <p className="text-sm mb-3">
320
- The reason below is shown to <strong className="break-all">{target?.identity}</strong>'s owner.
321
- </p>
322
- <label className="flex flex-col gap-1.5 text-sm mb-4">
323
- <span className="font-semibold">Reason</span>
324
- <input aria-label="Rejection reason" className={INPUT_CLASS} value={reason} onChange={(e) => setReason(e.target.value)} />
325
- </label>
326
- {error && <Alert>{error}</Alert>}
327
- <div className="flex gap-3 justify-end">
328
- <Button type="button" variant="secondary" className="!w-auto" disabled={rejecting} onClick={dismiss}>
329
- Cancel
330
- </Button>
331
- <Button
332
- type="button"
333
- className="!w-auto !bg-none !bg-danger !border-danger hover:!bg-danger"
334
- loading={rejecting}
335
- disabled={rejecting || !reason.trim()}
336
- onClick={handleReject}
337
- >
338
- Reject
339
- </Button>
340
- </div>
341
- </Modal>
342
- );
343
- }
1
+ ///////////////////////////////////////////////////////////////////////////////
2
+ // Copyright (C) 2026 Jean-Philippe Steinmetz
3
+ // SPDX-License-Identifier: MPL-2.0
4
+ ///////////////////////////////////////////////////////////////////////////////
5
+ import React, { ChangeEvent, useEffect, useRef, useState } from "react";
6
+ import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
7
+ import {
8
+ AdminSigningEnrollment,
9
+ getSigningEnrollmentInfo,
10
+ listSigningEnrollments,
11
+ looksLikePemCertificate,
12
+ rejectSigningEnrollment,
13
+ signingEnrollmentCsrUrl,
14
+ SigningEnrollmentInfo,
15
+ uploadSigningEnrollmentCertificate,
16
+ } from "@rapidmx/react-shared/crypto/signingProviderApi.js";
17
+ import AdminShell, { AdminShellProps } from "../../shared/components/admin/layout/AdminShell.js";
18
+ import Alert from "@rapidmx/react-shared/components/feedback/Alert.js";
19
+ import Button from "@rapidmx/react-shared/components/buttons/Button.js";
20
+ import Modal from "@rapidmx/react-shared/components/overlays/Modal.js";
21
+ import { notify } from "../../shared/notifications/store.js";
22
+
23
+ const INPUT_CLASS = "text-sm border border-border rounded-sm py-1.5 px-2 bg-surface";
24
+ const TEXTAREA_CLASS = `${INPUT_CLASS} font-mono text-xs`;
25
+
26
+ function errorMessage(err: unknown, fallback: string): string {
27
+ return err instanceof ApiRequestError ? err.message : fallback;
28
+ }
29
+
30
+ function statusBadgeClass(status: AdminSigningEnrollment["status"]): string {
31
+ if (status === "failed") return "bg-danger-bg text-danger";
32
+ if (status === "pending") return "bg-surface-alt text-text-muted";
33
+ return "bg-success text-white";
34
+ }
35
+
36
+ function providerLabel(provider: AdminSigningEnrollment["provider"]): string {
37
+ return provider === "rfc8823" ? "Automatic (RFC 8823)" : "Manual";
38
+ }
39
+
40
+ export default function SigningCertificatesPage(props: Omit<AdminShellProps, "active">) {
41
+ return (
42
+ <AdminShell {...props} active="signingCertificates">
43
+ <div className="flex flex-col gap-6">
44
+ <div>
45
+ <h1 className="text-xl font-bold uppercase tracking-wide mb-1">Signing Certificates</h1>
46
+ <p className="text-sm text-text-muted">
47
+ Every mailbox's pending signing (digital-signature) certificate request. Requests issued automatically by a
48
+ certificate authority are listed for visibility only; a manual request needs a certificate uploaded here once
49
+ the certificate authority has issued one.
50
+ </p>
51
+ </div>
52
+ <BackendSummary />
53
+ <EnrollmentsTable />
54
+ </div>
55
+ </AdminShell>
56
+ );
57
+ }
58
+
59
+ /** How signing certificates are issued in this deployment - fetched once, since it doesn't change while the page is open. */
60
+ function BackendSummary() {
61
+ const [info, setInfo] = useState<SigningEnrollmentInfo | null>(null);
62
+ const [error, setError] = useState<string | null>(null);
63
+
64
+ useEffect(() => {
65
+ getSigningEnrollmentInfo()
66
+ .then(setInfo)
67
+ .catch((err) => setError(errorMessage(err, "Could not load the signing certificate backend.")));
68
+ }, []);
69
+
70
+ if (error) {
71
+ return <Alert>{error}</Alert>;
72
+ }
73
+ if (!info) {
74
+ return null;
75
+ }
76
+ if (info.backend === "none") {
77
+ return <p className="text-sm text-text-muted">Signing certificates are not enabled in this deployment.</p>;
78
+ }
79
+
80
+ return (
81
+ <div className="text-sm border border-border rounded-sm p-3 bg-surface-alt flex flex-col gap-1">
82
+ <span>
83
+ <strong>{info.automatic ? "Automatic issuance" : "Manual issuance"}</strong>
84
+ {info.ca && <> through {info.ca.host}</>}
85
+ {info.typicalDurationMinutes !== undefined && <> &middot; typically {info.typicalDurationMinutes} minutes</>}
86
+ </span>
87
+ {info.health && !info.health.ok && (
88
+ <span className="text-danger">
89
+ The certificate authority could not be reached{info.health.lastError && <>: {info.health.lastError}</>}.
90
+ </span>
91
+ )}
92
+ </div>
93
+ );
94
+ }
95
+
96
+ function EnrollmentsTable() {
97
+ const [items, setItems] = useState<AdminSigningEnrollment[] | null>(null);
98
+ const [loadError, setLoadError] = useState<string | null>(null);
99
+ const [uploadTarget, setUploadTarget] = useState<AdminSigningEnrollment | null>(null);
100
+ const [rejectTarget, setRejectTarget] = useState<AdminSigningEnrollment | null>(null);
101
+
102
+ async function reload() {
103
+ try {
104
+ setItems(await listSigningEnrollments());
105
+ setLoadError(null);
106
+ } catch (err) {
107
+ setLoadError(errorMessage(err, "Could not load the pending signing certificate requests."));
108
+ }
109
+ }
110
+
111
+ useEffect(() => {
112
+ void reload();
113
+ }, []);
114
+
115
+ if (loadError) {
116
+ return <Alert>{loadError}</Alert>;
117
+ }
118
+ if (items === null) {
119
+ return <p className="text-sm text-text-muted">Loading&hellip;</p>;
120
+ }
121
+ if (items.length === 0) {
122
+ return <p className="text-sm text-text-muted">No pending signing certificate requests.</p>;
123
+ }
124
+
125
+ return (
126
+ <div className="overflow-x-auto">
127
+ <table className="w-full text-sm border-collapse">
128
+ <thead>
129
+ <tr className="text-left text-xs font-bold uppercase tracking-wide text-text-muted border-b border-border">
130
+ <th className="py-2 pr-3">Mailbox</th>
131
+ <th className="py-2 pr-3">Requested</th>
132
+ <th className="py-2 pr-3">Provider</th>
133
+ <th className="py-2 pr-3">Status</th>
134
+ <th className="py-2 pr-3">Actions</th>
135
+ </tr>
136
+ </thead>
137
+ <tbody>
138
+ {items.map((row) => (
139
+ <tr key={row.enrollmentId} className="border-b border-border">
140
+ <td className="py-2 pr-3 break-all">{row.identity}</td>
141
+ <td className="py-2 pr-3 whitespace-nowrap">{new Date(row.requestedAt).toLocaleString()}</td>
142
+ <td className="py-2 pr-3 whitespace-nowrap">{providerLabel(row.provider)}</td>
143
+ <td className="py-2 pr-3">
144
+ <span className={`text-xs font-bold uppercase tracking-wide py-0.5 px-2 rounded-pill ${statusBadgeClass(row.status)}`}>
145
+ {row.status}
146
+ </span>
147
+ {row.lastError && <div className="text-xs text-danger mt-1 max-w-xs">{row.lastError}</div>}
148
+ </td>
149
+ <td className="py-2 pr-3">
150
+ <div className="flex items-center gap-3 flex-wrap">
151
+ {row.provider === "manual" && (
152
+ <a
153
+ href={signingEnrollmentCsrUrl(row.enrollmentId)}
154
+ className="text-primary-dark hover:underline font-medium whitespace-nowrap"
155
+ >
156
+ Download CSR
157
+ </a>
158
+ )}
159
+ {row.canUpload && (
160
+ <Button type="button" variant="secondary" className="!w-auto" onClick={() => setUploadTarget(row)}>
161
+ Upload certificate
162
+ </Button>
163
+ )}
164
+ {row.status === "pending" && row.provider === "manual" && (
165
+ <Button type="button" variant="secondary" className="!w-auto" onClick={() => setRejectTarget(row)}>
166
+ Reject
167
+ </Button>
168
+ )}
169
+ {row.uploadBlockedReason && !row.canUpload && (
170
+ <span className="text-xs text-text-muted max-w-xs">{row.uploadBlockedReason}</span>
171
+ )}
172
+ </div>
173
+ </td>
174
+ </tr>
175
+ ))}
176
+ </tbody>
177
+ </table>
178
+
179
+ <UploadCertificateModal target={uploadTarget} onClose={() => setUploadTarget(null)} onDone={reload} />
180
+ <RejectModal target={rejectTarget} onClose={() => setRejectTarget(null)} onDone={reload} />
181
+ </div>
182
+ );
183
+ }
184
+
185
+ function UploadCertificateModal({
186
+ target,
187
+ onClose,
188
+ onDone,
189
+ }: {
190
+ target: AdminSigningEnrollment | null;
191
+ onClose: () => void;
192
+ onDone: () => Promise<void>;
193
+ }) {
194
+ const [certificate, setCertificate] = useState("");
195
+ const [uploading, setUploading] = useState(false);
196
+ const [error, setError] = useState<string | null>(null);
197
+ const fileInputRef = useRef<HTMLInputElement>(null);
198
+
199
+ function reset() {
200
+ setCertificate("");
201
+ setError(null);
202
+ }
203
+
204
+ function dismiss() {
205
+ if (!uploading) {
206
+ reset();
207
+ onClose();
208
+ }
209
+ }
210
+
211
+ function handleFileChange(e: ChangeEvent<HTMLInputElement>) {
212
+ const file = e.target.files?.[0];
213
+ e.target.value = "";
214
+ if (!file) {
215
+ return;
216
+ }
217
+ file.text()
218
+ .then((text) => setCertificate(text))
219
+ .catch(() => setError("Could not read this file."));
220
+ }
221
+
222
+ // Only invoked from the button below, which only renders once `target` is set (the modal's body) - same
223
+ // non-null-assertion pattern as `data-requests`' `handleApprove()`/`handleDeny()`.
224
+ async function handleUpload() {
225
+ setError(null);
226
+ setUploading(true);
227
+ try {
228
+ const result = await uploadSigningEnrollmentCertificate(target!.enrollmentId, certificate);
229
+ notify({
230
+ kind: "success",
231
+ title: "Certificate accepted",
232
+ message: `${result.identity}: ${result.message}`,
233
+ });
234
+ reset();
235
+ onClose();
236
+ await onDone();
237
+ } catch (err) {
238
+ setError(errorMessage(err, "Could not upload this certificate."));
239
+ } finally {
240
+ setUploading(false);
241
+ }
242
+ }
243
+
244
+ const sane = looksLikePemCertificate(certificate);
245
+
246
+ return (
247
+ <Modal open={target !== null} onClose={dismiss} title="Upload signing certificate">
248
+ <p className="text-sm mb-3">
249
+ Paste, or choose a file for, the certificate (or certificate chain, leaf first) the certificate authority issued for{" "}
250
+ <strong className="break-all">{target?.identity}</strong>.
251
+ </p>
252
+ <label className="flex flex-col gap-1.5 text-sm mb-3">
253
+ <span className="font-semibold">Certificate (PEM)</span>
254
+ <textarea
255
+ aria-label="Certificate PEM"
256
+ className={TEXTAREA_CLASS}
257
+ rows={8}
258
+ value={certificate}
259
+ onChange={(e) => setCertificate(e.target.value)}
260
+ placeholder="-----BEGIN CERTIFICATE-----&#10;...&#10;-----END CERTIFICATE-----"
261
+ />
262
+ </label>
263
+ <div className="mb-4">
264
+ <input ref={fileInputRef} type="file" accept=".pem,.crt,.cer,.txt" className="hidden" onChange={handleFileChange} />
265
+ <Button type="button" variant="secondary" className="!w-auto" onClick={() => fileInputRef.current?.click()}>
266
+ Choose file&hellip;
267
+ </Button>
268
+ </div>
269
+ {certificate.trim() !== "" && !sane && (
270
+ <p role="status" className="mb-3 py-2 px-3 rounded-sm text-xs bg-warning/15 text-text">
271
+ This doesn't look like a PEM certificate (it should start with -----BEGIN CERTIFICATE-----).
272
+ </p>
273
+ )}
274
+ {error && <Alert>{error}</Alert>}
275
+ <div className="flex gap-3 justify-end mt-2">
276
+ <Button type="button" variant="secondary" className="!w-auto" disabled={uploading} onClick={dismiss}>
277
+ Cancel
278
+ </Button>
279
+ <Button type="button" className="!w-auto" loading={uploading} disabled={uploading || !certificate.trim()} onClick={handleUpload}>
280
+ Upload
281
+ </Button>
282
+ </div>
283
+ </Modal>
284
+ );
285
+ }
286
+
287
+ function RejectModal({ target, onClose, onDone }: { target: AdminSigningEnrollment | null; onClose: () => void; onDone: () => Promise<void> }) {
288
+ const [reason, setReason] = useState("");
289
+ const [rejecting, setRejecting] = useState(false);
290
+ const [error, setError] = useState<string | null>(null);
291
+
292
+ function dismiss() {
293
+ if (!rejecting) {
294
+ setReason("");
295
+ setError(null);
296
+ onClose();
297
+ }
298
+ }
299
+
300
+ // Only invoked from the button below, which only renders once `target` is set - see `handleUpload()`'s identical note.
301
+ async function handleReject() {
302
+ setError(null);
303
+ setRejecting(true);
304
+ try {
305
+ await rejectSigningEnrollment(target!.enrollmentId, reason);
306
+ notify({ kind: "info", title: "Request rejected", message: `${target!.identity}'s signing certificate request was rejected.` });
307
+ setReason("");
308
+ onClose();
309
+ await onDone();
310
+ } catch (err) {
311
+ setError(errorMessage(err, "Could not reject this request."));
312
+ } finally {
313
+ setRejecting(false);
314
+ }
315
+ }
316
+
317
+ return (
318
+ <Modal open={target !== null} onClose={dismiss} title="Reject signing certificate request">
319
+ <p className="text-sm mb-3">
320
+ The reason below is shown to <strong className="break-all">{target?.identity}</strong>'s owner.
321
+ </p>
322
+ <label className="flex flex-col gap-1.5 text-sm mb-4">
323
+ <span className="font-semibold">Reason</span>
324
+ <input aria-label="Rejection reason" className={INPUT_CLASS} value={reason} onChange={(e) => setReason(e.target.value)} />
325
+ </label>
326
+ {error && <Alert>{error}</Alert>}
327
+ <div className="flex gap-3 justify-end">
328
+ <Button type="button" variant="secondary" className="!w-auto" disabled={rejecting} onClick={dismiss}>
329
+ Cancel
330
+ </Button>
331
+ <Button
332
+ type="button"
333
+ className="!w-auto !bg-none !bg-danger !border-danger hover:!bg-danger"
334
+ loading={rejecting}
335
+ disabled={rejecting || !reason.trim()}
336
+ onClick={handleReject}
337
+ >
338
+ Reject
339
+ </Button>
340
+ </div>
341
+ </Modal>
342
+ );
343
+ }