@rapidmx/web-client 0.15.1 → 0.16.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 (189) hide show
  1. package/README.md +373 -373
  2. package/apps/admin/branding/index.tsx +39 -39
  3. package/apps/admin/data-requests/index.tsx +482 -480
  4. package/apps/admin/domains/[uid].tsx +164 -164
  5. package/apps/admin/escrow-scopes/[uid].tsx +348 -348
  6. package/apps/admin/index.tsx +127 -124
  7. package/apps/admin/mailboxes/[uid].tsx +269 -224
  8. package/apps/admin/mailboxes/new/index.tsx +28 -28
  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 +378 -378
  16. package/apps/shared/components/admin/mailboxes/EraseLeftoverDataDialog.tsx +238 -0
  17. package/apps/shared/components/admin/mailboxes/EscrowScopeCard.tsx +152 -152
  18. package/apps/shared/components/admin/mailboxes/LeftoverMailboxesSection.tsx +194 -0
  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/MailboxCreateForm.tsx +50 -3
  22. package/apps/shared/components/admin/settings/MailboxPolicyForm.tsx +198 -198
  23. package/apps/shared/components/admin/settings/PluginsManager.tsx +1545 -1545
  24. package/apps/shared/components/admin/settings/RetentionPolicyForm.tsx +182 -182
  25. package/apps/shared/components/admin/setup/EscrowSetupStep.tsx +288 -288
  26. package/apps/shared/components/admin/setup/SetupWizard.tsx +444 -444
  27. package/apps/shared/components/admin/usePagedList.tsx +129 -129
  28. package/apps/shared/components/calendar/EventEditor.tsx +5 -10
  29. package/apps/shared/components/calendar/EventFormParts.tsx +16 -47
  30. package/apps/shared/components/calendar/EventModal.tsx +206 -206
  31. package/apps/shared/components/calendar/GuestInput.tsx +100 -0
  32. package/apps/shared/components/calendar/MonthView.tsx +185 -185
  33. package/apps/shared/components/calendar/RecurrenceEditor.tsx +227 -227
  34. package/apps/shared/components/calendar/RequestChangeForm.tsx +23 -54
  35. package/apps/shared/components/calendar/SplitDayView.tsx +144 -144
  36. package/apps/shared/components/calendar/TimeGridView.tsx +246 -246
  37. package/apps/shared/components/calendar/allDay.ts +124 -124
  38. package/apps/shared/components/calendar/eventForm.ts +2 -2
  39. package/apps/shared/components/calendar/eventFormat.ts +49 -22
  40. package/apps/shared/components/calendar/layout/CalendarShell.tsx +201 -200
  41. package/apps/shared/components/contacts/ContactForm.tsx +383 -383
  42. package/apps/shared/components/contacts/ContactsSidebar.tsx +1 -1
  43. package/apps/shared/components/contacts/ContactsToolbar.tsx +103 -98
  44. package/apps/shared/components/contacts/layout/ContactsShell.tsx +217 -216
  45. package/apps/shared/components/escrow/layout/EscrowShell.tsx +155 -155
  46. package/apps/shared/components/layout/AppShell.tsx +480 -480
  47. package/apps/shared/components/layout/FloatingActionButton.tsx +31 -0
  48. package/apps/shared/components/layout/KeyEnrollmentGate.tsx +398 -398
  49. package/apps/shared/components/layout/MailboxProvisioning.tsx +168 -168
  50. package/apps/shared/components/layout/ResponsiveToolbar.tsx +315 -315
  51. package/apps/shared/components/layout/ThemeSwitch.tsx +84 -84
  52. package/apps/shared/components/layout/UserMenu.tsx +439 -424
  53. package/apps/shared/components/mail/ConversationList.tsx +323 -323
  54. package/apps/shared/components/mail/ConversationThreadPane.tsx +612 -491
  55. package/apps/shared/components/mail/MailSelectionBar.tsx +236 -227
  56. package/apps/shared/components/mail/MessageDetailPane.tsx +1559 -1559
  57. package/apps/shared/components/mail/compose/ComposeContext.tsx +312 -312
  58. package/apps/shared/components/mail/compose/ComposeToolbar.tsx +422 -422
  59. package/apps/shared/components/mail/compose/ComposeWindow.tsx +1681 -1677
  60. package/apps/shared/components/mail/compose/RecipientInput.tsx +54 -11
  61. package/apps/shared/components/mail/compose/RichTextEditor.tsx +147 -147
  62. package/apps/shared/components/mail/compose/composeFlushRegistry.ts +60 -60
  63. package/apps/shared/components/mail/compose/quotedBody.ts +161 -161
  64. package/apps/shared/components/mail/layout/FolderBadgeChip.tsx +21 -0
  65. package/apps/shared/components/mail/layout/MailShell.tsx +137 -113
  66. package/apps/shared/components/mail/layout/SidebarSection.tsx +66 -0
  67. package/apps/shared/components/mail/reading/PendingMessageCard.tsx +68 -0
  68. package/apps/shared/components/mail/verificationSeals.ts +125 -125
  69. package/apps/shared/components/rules/RuleBuilder.tsx +311 -311
  70. package/apps/shared/components/settings/SigningCertificateCard.tsx +344 -344
  71. package/apps/shared/components/settings/layout/SettingsShell.tsx +255 -254
  72. package/apps/shared/components/tasks/TasksSidebar.tsx +1 -1
  73. package/apps/shared/components/tasks/layout/TasksShell.tsx +218 -217
  74. package/apps/shared/keyboard/GlobalShortcuts.tsx +51 -51
  75. package/apps/shared/keyboard/ShortcutProvider.tsx +62 -62
  76. package/apps/shared/keyboard/ShortcutsDialog.tsx +84 -84
  77. package/apps/shared/keyboard/dispatch.ts +124 -124
  78. package/apps/shared/keyboard/format.ts +89 -89
  79. package/apps/shared/keyboard/keymap.ts +114 -114
  80. package/apps/shared/keyboard/registry.ts +65 -65
  81. package/apps/shared/keyboard/targets.ts +79 -79
  82. package/apps/shared/mail/folderCounts.ts +17 -0
  83. package/apps/shared/mail/folderTree.ts +143 -143
  84. package/apps/shared/mail/listAllPages.ts +39 -39
  85. package/apps/shared/mail/newMailNotifications.ts +171 -171
  86. package/apps/shared/mail/outbox/outgoingReplies.ts +192 -0
  87. package/apps/shared/mail/outbox/sendJob.ts +19 -1
  88. package/apps/shared/mail/outbox/sendOutcomes.ts +13 -4
  89. package/apps/shared/mail/primaryMailbox.ts +71 -0
  90. package/apps/shared/mail/useCollapsedSections.ts +146 -0
  91. package/apps/shared/mail/useMailConnection.ts +205 -203
  92. package/apps/shared/mail/useMailLiveUpdates.ts +277 -277
  93. package/apps/shared/mail/useMarkMessageRead.ts +47 -47
  94. package/apps/shared/mail/useNewMailNotifications.ts +178 -178
  95. package/apps/shared/navigation/AppRouter.tsx +300 -300
  96. package/apps/shared/navigation/routerContext.tsx +83 -83
  97. package/apps/shared/notifications/store.ts +560 -560
  98. package/apps/shared/search/LocalIndexLifecycle.tsx +114 -114
  99. package/apps/shared/search/crossMailboxSearch.ts +169 -0
  100. package/apps/shared/search/localIndexBuilder.ts +481 -481
  101. package/apps/shared/signing/enrollmentStorage.ts +33 -33
  102. package/apps/shared/signing/enrollmentTracker.ts +385 -385
  103. package/apps/shared/signing/enrollmentView.ts +251 -251
  104. package/apps/shared/signing/useNow.ts +19 -19
  105. package/apps/shared/signing/useSigningEnrollmentWatcher.ts +90 -90
  106. package/apps/shared/styles/app.css +396 -386
  107. package/apps/www/calendar/index.tsx +578 -571
  108. package/apps/www/contacts/[uid].tsx +109 -109
  109. package/apps/www/contacts/index.tsx +6 -0
  110. package/apps/www/index.tsx +2847 -2479
  111. package/apps/www/messages/[uid].tsx +135 -135
  112. package/apps/www/settings/auto-reply/index.tsx +133 -133
  113. package/apps/www/settings/encryption/index.tsx +1287 -1287
  114. package/apps/www/settings/filters/[uid].tsx +176 -176
  115. package/apps/www/settings/filters/index.tsx +102 -102
  116. package/apps/www/settings/filters/new/index.tsx +140 -140
  117. package/apps/www/settings/labels/index.tsx +204 -204
  118. package/apps/www/settings/privacy/index.tsx +492 -492
  119. package/apps/www/settings/profile/index.tsx +248 -248
  120. package/apps/www/settings/read-receipts/index.tsx +147 -147
  121. package/apps/www/settings/sharing/index.tsx +256 -256
  122. package/apps/www/settings/signatures/[uid].tsx +172 -172
  123. package/apps/www/settings/signatures/index.tsx +88 -88
  124. package/apps/www/settings/signatures/new/index.tsx +135 -135
  125. package/apps/www/tasks/index.tsx +649 -649
  126. package/dist/apps/admin/data-requests/index.js +1 -1
  127. package/dist/apps/admin/index.js +2 -1
  128. package/dist/apps/admin/mailboxes/[uid].js +12 -2
  129. package/dist/apps/shared/components/admin/layout/AdminShell.js +2 -2
  130. package/dist/apps/shared/components/admin/mailboxes/EraseLeftoverDataDialog.d.ts +35 -0
  131. package/dist/apps/shared/components/admin/mailboxes/EraseLeftoverDataDialog.js +115 -0
  132. package/dist/apps/shared/components/admin/mailboxes/LeftoverMailboxesSection.d.ts +16 -0
  133. package/dist/apps/shared/components/admin/mailboxes/LeftoverMailboxesSection.js +92 -0
  134. package/dist/apps/shared/components/admin/settings/BrandingForm.js +3 -3
  135. package/dist/apps/shared/components/admin/settings/MailboxCreateForm.js +25 -3
  136. package/dist/apps/shared/components/calendar/EventEditor.js +5 -10
  137. package/dist/apps/shared/components/calendar/EventFormParts.d.ts +3 -2
  138. package/dist/apps/shared/components/calendar/EventFormParts.js +5 -16
  139. package/dist/apps/shared/components/calendar/GuestInput.d.ts +45 -0
  140. package/dist/apps/shared/components/calendar/GuestInput.js +30 -0
  141. package/dist/apps/shared/components/calendar/RequestChangeForm.js +11 -22
  142. package/dist/apps/shared/components/calendar/eventForm.d.ts +2 -2
  143. package/dist/apps/shared/components/calendar/eventFormat.d.ts +21 -8
  144. package/dist/apps/shared/components/calendar/eventFormat.js +50 -23
  145. package/dist/apps/shared/components/calendar/layout/CalendarShell.js +3 -2
  146. package/dist/apps/shared/components/contacts/ContactsSidebar.js +1 -1
  147. package/dist/apps/shared/components/contacts/ContactsToolbar.d.ts +3 -1
  148. package/dist/apps/shared/components/contacts/ContactsToolbar.js +4 -2
  149. package/dist/apps/shared/components/contacts/layout/ContactsShell.js +4 -3
  150. package/dist/apps/shared/components/layout/FloatingActionButton.d.ts +13 -0
  151. package/dist/apps/shared/components/layout/FloatingActionButton.js +9 -0
  152. package/dist/apps/shared/components/layout/UserMenu.d.ts +4 -1
  153. package/dist/apps/shared/components/layout/UserMenu.js +6 -5
  154. package/dist/apps/shared/components/mail/ConversationThreadPane.js +127 -22
  155. package/dist/apps/shared/components/mail/MailSelectionBar.d.ts +6 -1
  156. package/dist/apps/shared/components/mail/MailSelectionBar.js +3 -3
  157. package/dist/apps/shared/components/mail/compose/ComposeWindow.js +8 -4
  158. package/dist/apps/shared/components/mail/compose/RecipientInput.d.ts +21 -1
  159. package/dist/apps/shared/components/mail/compose/RecipientInput.js +18 -10
  160. package/dist/apps/shared/components/mail/layout/FolderBadgeChip.d.ts +6 -0
  161. package/dist/apps/shared/components/mail/layout/FolderBadgeChip.js +9 -0
  162. package/dist/apps/shared/components/mail/layout/MailShell.d.ts +5 -0
  163. package/dist/apps/shared/components/mail/layout/MailShell.js +64 -45
  164. package/dist/apps/shared/components/mail/layout/SidebarSection.d.ts +23 -0
  165. package/dist/apps/shared/components/mail/layout/SidebarSection.js +16 -0
  166. package/dist/apps/shared/components/mail/reading/PendingMessageCard.d.ts +14 -0
  167. package/dist/apps/shared/components/mail/reading/PendingMessageCard.js +16 -0
  168. package/dist/apps/shared/components/settings/layout/SettingsShell.js +6 -5
  169. package/dist/apps/shared/components/tasks/TasksSidebar.js +1 -1
  170. package/dist/apps/shared/components/tasks/layout/TasksShell.js +4 -3
  171. package/dist/apps/shared/mail/folderCounts.d.ts +10 -0
  172. package/dist/apps/shared/mail/folderCounts.js +12 -0
  173. package/dist/apps/shared/mail/outbox/outgoingReplies.d.ts +80 -0
  174. package/dist/apps/shared/mail/outbox/outgoingReplies.js +131 -0
  175. package/dist/apps/shared/mail/outbox/sendJob.d.ts +5 -1
  176. package/dist/apps/shared/mail/outbox/sendJob.js +14 -1
  177. package/dist/apps/shared/mail/outbox/sendOutcomes.js +13 -4
  178. package/dist/apps/shared/mail/primaryMailbox.d.ts +29 -0
  179. package/dist/apps/shared/mail/primaryMailbox.js +61 -0
  180. package/dist/apps/shared/mail/useCollapsedSections.d.ts +32 -0
  181. package/dist/apps/shared/mail/useCollapsedSections.js +110 -0
  182. package/dist/apps/shared/mail/useMailConnection.js +3 -1
  183. package/dist/apps/shared/search/crossMailboxSearch.d.ts +72 -0
  184. package/dist/apps/shared/search/crossMailboxSearch.js +136 -0
  185. package/dist/apps/shared/styles/app.css +396 -386
  186. package/dist/apps/www/calendar/index.js +3 -2
  187. package/dist/apps/www/contacts/index.js +3 -1
  188. package/dist/apps/www/index.js +426 -189
  189. package/package.json +2 -2
@@ -1,383 +1,383 @@
1
- ///////////////////////////////////////////////////////////////////////////////
2
- // Copyright (C) 2026 Jean-Philippe Steinmetz
3
- // SPDX-License-Identifier: MPL-2.0
4
- ///////////////////////////////////////////////////////////////////////////////
5
- import React, { FormEvent, useState } from "react";
6
- import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
7
- import {
8
- Contact,
9
- ContactAddressKind,
10
- ContactEmail,
11
- ContactPatch,
12
- ContactPhone,
13
- ContactPostalAddress,
14
- createContact,
15
- updateContact,
16
- } from "@rapidmx/react-shared/contacts/contactsApi.js";
17
- import { Mailbox } from "@rapidmx/react-shared/mail/mailApi.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 FormField from "@rapidmx/react-shared/components/forms/FormField.js";
21
- import { findWellKnownFolderUid } from "../../mail/findWellKnownFolderUid.js";
22
- import { clearPinnedSignerCache } from "../mail/pinnedSigners.js";
23
-
24
- const INPUT_CLASS =
25
- "w-full text-sm py-2 px-3 border border-border rounded-sm bg-surface text-text focus:outline-none focus:border-primary";
26
- const SELECT_CLASS =
27
- "text-sm py-2 px-2 border border-border rounded-sm bg-surface text-text focus:outline-none focus:border-primary";
28
-
29
- export interface ContactFormProps {
30
- contact?: Contact;
31
- /** Create mode: the default mailbox (and its Contacts folder) to create in. */
32
- mailboxUid?: string;
33
- folderUid?: string;
34
- /** Create mode: every mailbox the contact could be created in - with more than one, a Mailbox selector
35
- * is shown. Choosing a mailbox other than `mailboxUid` looks up that mailbox's own Contacts folder. */
36
- mailboxes?: Mailbox[];
37
- onSaved: (contact: Contact) => void;
38
- onCancel: () => void;
39
- }
40
-
41
- const ADDRESS_KINDS: ContactAddressKind[] = ["home", "work", "other"];
42
-
43
- /**
44
- * A contact's create/edit form. Shared by the desktop inline pane (`apps/www/contacts/index.tsx`) and the
45
- * mobile detail route's own edit mode (`apps/www/contacts/[uid].tsx`) — creation itself stays
46
- * desktop-and-mobile-inline (see that route's own doc comment on why "new" never gets a dedicated route).
47
- */
48
- export default function ContactForm({ contact, mailboxUid, folderUid, mailboxes, onSaved, onCancel }: ContactFormProps) {
49
- const [targetMailboxUid, setTargetMailboxUid] = useState(mailboxUid);
50
- const [displayName, setDisplayName] = useState(contact?.displayName ?? "");
51
- const [givenName, setGivenName] = useState(contact?.givenName ?? "");
52
- const [surname, setSurname] = useState(contact?.surname ?? "");
53
- const [company, setCompany] = useState(contact?.company ?? "");
54
- const [jobTitle, setJobTitle] = useState(contact?.jobTitle ?? "");
55
- const [notes, setNotes] = useState(contact?.notes ?? "");
56
- const [favorite, setFavorite] = useState(contact?.favorite ?? false);
57
- const [categoriesText, setCategoriesText] = useState((contact?.categories ?? []).join(", "));
58
- const [emails, setEmails] = useState<ContactEmail[]>(contact?.emails ?? []);
59
- const [phones, setPhones] = useState<ContactPhone[]>(contact?.phones ?? []);
60
- // Every stored address is kept and editable - editing a contact must never silently drop addresses
61
- // beyond the first.
62
- const [addresses, setAddresses] = useState<ContactPostalAddress[]>(contact?.addresses ?? []);
63
- const [error, setError] = useState<string | null>(null);
64
- const [saving, setSaving] = useState(false);
65
-
66
- function updateEmail(index: number, patch: Partial<ContactEmail>) {
67
- setEmails((prev) => prev.map((e, i) => (i === index ? { ...e, ...patch } : e)));
68
- }
69
- function removeEmail(index: number) {
70
- setEmails((prev) => prev.filter((_, i) => i !== index));
71
- }
72
- function updatePhone(index: number, patch: Partial<ContactPhone>) {
73
- setPhones((prev) => prev.map((p, i) => (i === index ? { ...p, ...patch } : p)));
74
- }
75
- function removePhone(index: number) {
76
- setPhones((prev) => prev.filter((_, i) => i !== index));
77
- }
78
- function updateAddress(index: number, patch: Partial<ContactPostalAddress>) {
79
- setAddresses((prev) => prev.map((a, i) => (i === index ? { ...a, ...patch } : a)));
80
- }
81
- function removeAddress(index: number) {
82
- setAddresses((prev) => prev.filter((_, i) => i !== index));
83
- }
84
-
85
- async function handleSubmit(e: FormEvent) {
86
- e.preventDefault();
87
- setError(null);
88
-
89
- if (!displayName.trim()) {
90
- setError("A display name is required.");
91
- return;
92
- }
93
-
94
- setSaving(true);
95
- try {
96
- const categories = categoriesText
97
- .split(",")
98
- .map((c) => c.trim())
99
- .filter(Boolean);
100
- // An update merges only the fields in its body, so a field the user cleared is sent as an
101
- // explicit `null` (an omitted/undefined one would keep its stored value); a create just omits it.
102
- const cleared = contact ? null : undefined;
103
- const input = {
104
- displayName: displayName.trim(),
105
- givenName: givenName.trim() || cleared,
106
- surname: surname.trim() || cleared,
107
- company: company.trim() || cleared,
108
- jobTitle: jobTitle.trim() || cleared,
109
- notes: notes.trim() || cleared,
110
- favorite,
111
- categories,
112
- emails,
113
- phones,
114
- addresses,
115
- };
116
- let saved: Contact;
117
- if (contact) {
118
- saved = await updateContact({
119
- uid: contact.uid,
120
- version: contact.version,
121
- ...(input as Omit<ContactPatch, "uid" | "version">),
122
- });
123
- } else {
124
- const targetFolderUid =
125
- targetMailboxUid === mailboxUid ? folderUid : await findWellKnownFolderUid(targetMailboxUid as string, "contacts");
126
- if (!targetFolderUid) {
127
- setError("That mailbox has no Contacts folder.");
128
- return;
129
- }
130
- saved = await createContact({
131
- mailboxUid: targetMailboxUid as string,
132
- folderUid: targetFolderUid,
133
- ...(input as Omit<Parameters<typeof createContact>[0], "mailboxUid" | "folderUid">),
134
- });
135
- }
136
- // A message opened later in this page load must see the changed contact's signing keys.
137
- clearPinnedSignerCache();
138
- onSaved(saved);
139
- } catch (err) {
140
- setError(err instanceof ApiRequestError ? err.message : "Could not save this contact.");
141
- } finally {
142
- setSaving(false);
143
- }
144
- }
145
-
146
- return (
147
- // The form fills the pane it is in: the fields scroll in their own area and Save / Cancel stay in view under them (`rr-solid`: opaque over a
148
- // background image). Outside a bounded pane (the phone's page, which scrolls as a whole) the footer sticks above the bottom tab bar instead.
149
- <form onSubmit={handleSubmit} className="@container flex min-h-0 flex-1 flex-col">
150
- <div className="min-h-0 flex-1 overflow-y-auto p-6">
151
- <div className="flex max-w-xl flex-col gap-1">
152
- <h1 className="text-xl font-bold uppercase tracking-wide mb-3">{contact ? "Edit contact" : "New contact"}</h1>
153
-
154
- {error && <Alert>{error}</Alert>}
155
-
156
- {!contact && mailboxes && mailboxes.length > 1 && (
157
- <FormField label="Mailbox" htmlFor="contact-mailbox">
158
- <select
159
- id="contact-mailbox"
160
- className={`${SELECT_CLASS} w-full`}
161
- value={targetMailboxUid}
162
- onChange={(e) => setTargetMailboxUid(e.target.value)}
163
- >
164
- {mailboxes.map((mb) => (
165
- <option key={mb.uid} value={mb.uid}>
166
- {mb.displayName}
167
- {mb.ownerUserUid ? "" : " (shared)"}
168
- </option>
169
- ))}
170
- </select>
171
- </FormField>
172
- )}
173
-
174
- <FormField label="Display name" htmlFor="contact-displayName">
175
- <input
176
- id="contact-displayName"
177
- type="text"
178
- className={INPUT_CLASS}
179
- value={displayName}
180
- onChange={(e) => setDisplayName(e.target.value)}
181
- />
182
- </FormField>
183
-
184
- <div className="grid grid-cols-1 @md:grid-cols-2 gap-3">
185
- <FormField label="First name" htmlFor="contact-givenName">
186
- <input id="contact-givenName" type="text" className={INPUT_CLASS} value={givenName} onChange={(e) => setGivenName(e.target.value)} />
187
- </FormField>
188
- <FormField label="Last name" htmlFor="contact-surname">
189
- <input id="contact-surname" type="text" className={INPUT_CLASS} value={surname} onChange={(e) => setSurname(e.target.value)} />
190
- </FormField>
191
- </div>
192
-
193
- <div className="grid grid-cols-1 @md:grid-cols-2 gap-3">
194
- <FormField label="Company" htmlFor="contact-company">
195
- <input id="contact-company" type="text" className={INPUT_CLASS} value={company} onChange={(e) => setCompany(e.target.value)} />
196
- </FormField>
197
- <FormField label="Job title" htmlFor="contact-jobTitle">
198
- <input id="contact-jobTitle" type="text" className={INPUT_CLASS} value={jobTitle} onChange={(e) => setJobTitle(e.target.value)} />
199
- </FormField>
200
- </div>
201
-
202
- <label className="flex items-center gap-2 text-sm mb-4">
203
- <input type="checkbox" checked={favorite} onChange={(e) => setFavorite(e.target.checked)} />
204
- Favorite
205
- </label>
206
-
207
- <FormField label="Categories (comma-separated)" htmlFor="contact-categories">
208
- <input
209
- id="contact-categories"
210
- type="text"
211
- className={INPUT_CLASS}
212
- value={categoriesText}
213
- onChange={(e) => setCategoriesText(e.target.value)}
214
- placeholder="VIP, Work"
215
- />
216
- </FormField>
217
-
218
- <FormField label="Email" htmlFor="contact-emails">
219
- <div id="contact-emails" className="flex flex-col gap-2">
220
- {emails.map((email, i) => (
221
- <div key={i} className="flex gap-2">
222
- <input
223
- type="email"
224
- className={`${INPUT_CLASS} flex-1`}
225
- value={email.address}
226
- onChange={(e) => updateEmail(i, { address: e.target.value })}
227
- aria-label={`Email address ${i + 1}`}
228
- />
229
- <select
230
- className={SELECT_CLASS}
231
- value={email.type}
232
- onChange={(e) => updateEmail(i, { type: e.target.value as ContactAddressKind })}
233
- aria-label={`Email type ${i + 1}`}
234
- >
235
- {ADDRESS_KINDS.map((kind) => (
236
- <option key={kind} value={kind}>
237
- {kind}
238
- </option>
239
- ))}
240
- </select>
241
- <button type="button" onClick={() => removeEmail(i)} className="text-sm text-danger px-2" aria-label={`Remove email ${i + 1}`}>
242
- &times;
243
- </button>
244
- </div>
245
- ))}
246
- <button
247
- type="button"
248
- onClick={() => setEmails((prev) => [...prev, { address: "", type: "work" }])}
249
- className="self-start text-xs font-medium text-primary-dark hover:underline"
250
- >
251
- + Add email
252
- </button>
253
- </div>
254
- </FormField>
255
-
256
- <FormField label="Phone" htmlFor="contact-phones">
257
- <div id="contact-phones" className="flex flex-col gap-2">
258
- {phones.map((phone, i) => (
259
- <div key={i} className="flex gap-2">
260
- <input
261
- type="tel"
262
- className={`${INPUT_CLASS} flex-1`}
263
- value={phone.phoneNumber}
264
- onChange={(e) => updatePhone(i, { phoneNumber: e.target.value })}
265
- aria-label={`Phone number ${i + 1}`}
266
- />
267
- <select
268
- className={SELECT_CLASS}
269
- value={phone.type}
270
- onChange={(e) => updatePhone(i, { type: e.target.value as ContactAddressKind })}
271
- aria-label={`Phone type ${i + 1}`}
272
- >
273
- {ADDRESS_KINDS.map((kind) => (
274
- <option key={kind} value={kind}>
275
- {kind}
276
- </option>
277
- ))}
278
- </select>
279
- <button type="button" onClick={() => removePhone(i)} className="text-sm text-danger px-2" aria-label={`Remove phone ${i + 1}`}>
280
- &times;
281
- </button>
282
- </div>
283
- ))}
284
- <button
285
- type="button"
286
- onClick={() => setPhones((prev) => [...prev, { phoneNumber: "", type: "work" }])}
287
- className="self-start text-xs font-medium text-primary-dark hover:underline"
288
- >
289
- + Add phone
290
- </button>
291
- </div>
292
- </FormField>
293
-
294
- <FormField label="Address" htmlFor="contact-address">
295
- <div className="flex flex-col gap-3">
296
- {addresses.map((address, i) => (
297
- <div key={i} className="flex flex-col gap-2">
298
- <div className="grid grid-cols-1 @md:grid-cols-2 gap-2">
299
- <input
300
- type="text"
301
- placeholder="Street"
302
- className={INPUT_CLASS}
303
- value={address.street ?? ""}
304
- onChange={(e) => updateAddress(i, { street: e.target.value })}
305
- />
306
- <input
307
- type="text"
308
- placeholder="City"
309
- className={INPUT_CLASS}
310
- value={address.city ?? ""}
311
- onChange={(e) => updateAddress(i, { city: e.target.value })}
312
- />
313
- <input
314
- type="text"
315
- placeholder="State/Province"
316
- className={INPUT_CLASS}
317
- value={address.state ?? ""}
318
- onChange={(e) => updateAddress(i, { state: e.target.value })}
319
- />
320
- <input
321
- type="text"
322
- placeholder="Postal code"
323
- className={INPUT_CLASS}
324
- value={address.postalCode ?? ""}
325
- onChange={(e) => updateAddress(i, { postalCode: e.target.value })}
326
- />
327
- <input
328
- type="text"
329
- placeholder="Country"
330
- className={INPUT_CLASS}
331
- value={address.country ?? ""}
332
- onChange={(e) => updateAddress(i, { country: e.target.value })}
333
- />
334
- <select
335
- className={SELECT_CLASS}
336
- value={address.type}
337
- onChange={(e) => updateAddress(i, { type: e.target.value as ContactAddressKind })}
338
- aria-label={i === 0 ? "Address type" : `Address type ${i + 1}`}
339
- >
340
- {ADDRESS_KINDS.map((kind) => (
341
- <option key={kind} value={kind}>
342
- {kind}
343
- </option>
344
- ))}
345
- </select>
346
- </div>
347
- <button
348
- type="button"
349
- onClick={() => removeAddress(i)}
350
- className="self-start text-xs font-medium text-danger hover:underline"
351
- aria-label={i === 0 ? "Remove address" : `Remove address ${i + 1}`}
352
- >
353
- Remove address
354
- </button>
355
- </div>
356
- ))}
357
- <button
358
- type="button"
359
- onClick={() => setAddresses((prev) => [...prev, { type: "home" }])}
360
- className="self-start text-xs font-medium text-primary-dark hover:underline"
361
- >
362
- + Add address
363
- </button>
364
- </div>
365
- </FormField>
366
-
367
- <FormField label="Notes" htmlFor="contact-notes">
368
- <textarea id="contact-notes" rows={3} className={INPUT_CLASS} value={notes} onChange={(e) => setNotes(e.target.value)} />
369
- </FormField>
370
-
371
- </div>
372
- </div>
373
- <div className="rr-solid sticky bottom-14 z-10 flex shrink-0 gap-3 border-t border-border bg-surface px-6 py-3 md:bottom-0">
374
- <Button type="submit" loading={saving} disabled={saving} className="!w-auto">
375
- Save
376
- </Button>
377
- <Button type="button" variant="secondary" className="!w-auto" onClick={onCancel}>
378
- Cancel
379
- </Button>
380
- </div>
381
- </form>
382
- );
383
- }
1
+ ///////////////////////////////////////////////////////////////////////////////
2
+ // Copyright (C) 2026 Jean-Philippe Steinmetz
3
+ // SPDX-License-Identifier: MPL-2.0
4
+ ///////////////////////////////////////////////////////////////////////////////
5
+ import React, { FormEvent, useState } from "react";
6
+ import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
7
+ import {
8
+ Contact,
9
+ ContactAddressKind,
10
+ ContactEmail,
11
+ ContactPatch,
12
+ ContactPhone,
13
+ ContactPostalAddress,
14
+ createContact,
15
+ updateContact,
16
+ } from "@rapidmx/react-shared/contacts/contactsApi.js";
17
+ import { Mailbox } from "@rapidmx/react-shared/mail/mailApi.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 FormField from "@rapidmx/react-shared/components/forms/FormField.js";
21
+ import { findWellKnownFolderUid } from "../../mail/findWellKnownFolderUid.js";
22
+ import { clearPinnedSignerCache } from "../mail/pinnedSigners.js";
23
+
24
+ const INPUT_CLASS =
25
+ "w-full text-sm py-2 px-3 border border-border rounded-sm bg-surface text-text focus:outline-none focus:border-primary";
26
+ const SELECT_CLASS =
27
+ "text-sm py-2 px-2 border border-border rounded-sm bg-surface text-text focus:outline-none focus:border-primary";
28
+
29
+ export interface ContactFormProps {
30
+ contact?: Contact;
31
+ /** Create mode: the default mailbox (and its Contacts folder) to create in. */
32
+ mailboxUid?: string;
33
+ folderUid?: string;
34
+ /** Create mode: every mailbox the contact could be created in - with more than one, a Mailbox selector
35
+ * is shown. Choosing a mailbox other than `mailboxUid` looks up that mailbox's own Contacts folder. */
36
+ mailboxes?: Mailbox[];
37
+ onSaved: (contact: Contact) => void;
38
+ onCancel: () => void;
39
+ }
40
+
41
+ const ADDRESS_KINDS: ContactAddressKind[] = ["home", "work", "other"];
42
+
43
+ /**
44
+ * A contact's create/edit form. Shared by the desktop inline pane (`apps/www/contacts/index.tsx`) and the
45
+ * mobile detail route's own edit mode (`apps/www/contacts/[uid].tsx`) — creation itself stays
46
+ * desktop-and-mobile-inline (see that route's own doc comment on why "new" never gets a dedicated route).
47
+ */
48
+ export default function ContactForm({ contact, mailboxUid, folderUid, mailboxes, onSaved, onCancel }: ContactFormProps) {
49
+ const [targetMailboxUid, setTargetMailboxUid] = useState(mailboxUid);
50
+ const [displayName, setDisplayName] = useState(contact?.displayName ?? "");
51
+ const [givenName, setGivenName] = useState(contact?.givenName ?? "");
52
+ const [surname, setSurname] = useState(contact?.surname ?? "");
53
+ const [company, setCompany] = useState(contact?.company ?? "");
54
+ const [jobTitle, setJobTitle] = useState(contact?.jobTitle ?? "");
55
+ const [notes, setNotes] = useState(contact?.notes ?? "");
56
+ const [favorite, setFavorite] = useState(contact?.favorite ?? false);
57
+ const [categoriesText, setCategoriesText] = useState((contact?.categories ?? []).join(", "));
58
+ const [emails, setEmails] = useState<ContactEmail[]>(contact?.emails ?? []);
59
+ const [phones, setPhones] = useState<ContactPhone[]>(contact?.phones ?? []);
60
+ // Every stored address is kept and editable - editing a contact must never silently drop addresses
61
+ // beyond the first.
62
+ const [addresses, setAddresses] = useState<ContactPostalAddress[]>(contact?.addresses ?? []);
63
+ const [error, setError] = useState<string | null>(null);
64
+ const [saving, setSaving] = useState(false);
65
+
66
+ function updateEmail(index: number, patch: Partial<ContactEmail>) {
67
+ setEmails((prev) => prev.map((e, i) => (i === index ? { ...e, ...patch } : e)));
68
+ }
69
+ function removeEmail(index: number) {
70
+ setEmails((prev) => prev.filter((_, i) => i !== index));
71
+ }
72
+ function updatePhone(index: number, patch: Partial<ContactPhone>) {
73
+ setPhones((prev) => prev.map((p, i) => (i === index ? { ...p, ...patch } : p)));
74
+ }
75
+ function removePhone(index: number) {
76
+ setPhones((prev) => prev.filter((_, i) => i !== index));
77
+ }
78
+ function updateAddress(index: number, patch: Partial<ContactPostalAddress>) {
79
+ setAddresses((prev) => prev.map((a, i) => (i === index ? { ...a, ...patch } : a)));
80
+ }
81
+ function removeAddress(index: number) {
82
+ setAddresses((prev) => prev.filter((_, i) => i !== index));
83
+ }
84
+
85
+ async function handleSubmit(e: FormEvent) {
86
+ e.preventDefault();
87
+ setError(null);
88
+
89
+ if (!displayName.trim()) {
90
+ setError("A display name is required.");
91
+ return;
92
+ }
93
+
94
+ setSaving(true);
95
+ try {
96
+ const categories = categoriesText
97
+ .split(",")
98
+ .map((c) => c.trim())
99
+ .filter(Boolean);
100
+ // An update merges only the fields in its body, so a field the user cleared is sent as an
101
+ // explicit `null` (an omitted/undefined one would keep its stored value); a create just omits it.
102
+ const cleared = contact ? null : undefined;
103
+ const input = {
104
+ displayName: displayName.trim(),
105
+ givenName: givenName.trim() || cleared,
106
+ surname: surname.trim() || cleared,
107
+ company: company.trim() || cleared,
108
+ jobTitle: jobTitle.trim() || cleared,
109
+ notes: notes.trim() || cleared,
110
+ favorite,
111
+ categories,
112
+ emails,
113
+ phones,
114
+ addresses,
115
+ };
116
+ let saved: Contact;
117
+ if (contact) {
118
+ saved = await updateContact({
119
+ uid: contact.uid,
120
+ version: contact.version,
121
+ ...(input as Omit<ContactPatch, "uid" | "version">),
122
+ });
123
+ } else {
124
+ const targetFolderUid =
125
+ targetMailboxUid === mailboxUid ? folderUid : await findWellKnownFolderUid(targetMailboxUid as string, "contacts");
126
+ if (!targetFolderUid) {
127
+ setError("That mailbox has no Contacts folder.");
128
+ return;
129
+ }
130
+ saved = await createContact({
131
+ mailboxUid: targetMailboxUid as string,
132
+ folderUid: targetFolderUid,
133
+ ...(input as Omit<Parameters<typeof createContact>[0], "mailboxUid" | "folderUid">),
134
+ });
135
+ }
136
+ // A message opened later in this page load must see the changed contact's signing keys.
137
+ clearPinnedSignerCache();
138
+ onSaved(saved);
139
+ } catch (err) {
140
+ setError(err instanceof ApiRequestError ? err.message : "Could not save this contact.");
141
+ } finally {
142
+ setSaving(false);
143
+ }
144
+ }
145
+
146
+ return (
147
+ // The form fills the pane it is in: the fields scroll in their own area and Save / Cancel stay in view under them (`rr-solid`: opaque over a
148
+ // background image). Outside a bounded pane (the phone's page, which scrolls as a whole) the footer sticks above the bottom tab bar instead.
149
+ <form onSubmit={handleSubmit} className="@container flex min-h-0 flex-1 flex-col">
150
+ <div className="min-h-0 flex-1 overflow-y-auto p-6">
151
+ <div className="flex max-w-xl flex-col gap-1">
152
+ <h1 className="text-xl font-bold uppercase tracking-wide mb-3">{contact ? "Edit contact" : "New contact"}</h1>
153
+
154
+ {error && <Alert>{error}</Alert>}
155
+
156
+ {!contact && mailboxes && mailboxes.length > 1 && (
157
+ <FormField label="Mailbox" htmlFor="contact-mailbox">
158
+ <select
159
+ id="contact-mailbox"
160
+ className={`${SELECT_CLASS} w-full`}
161
+ value={targetMailboxUid}
162
+ onChange={(e) => setTargetMailboxUid(e.target.value)}
163
+ >
164
+ {mailboxes.map((mb) => (
165
+ <option key={mb.uid} value={mb.uid}>
166
+ {mb.displayName}
167
+ {mb.ownerUserUid ? "" : " (shared)"}
168
+ </option>
169
+ ))}
170
+ </select>
171
+ </FormField>
172
+ )}
173
+
174
+ <FormField label="Display name" htmlFor="contact-displayName">
175
+ <input
176
+ id="contact-displayName"
177
+ type="text"
178
+ className={INPUT_CLASS}
179
+ value={displayName}
180
+ onChange={(e) => setDisplayName(e.target.value)}
181
+ />
182
+ </FormField>
183
+
184
+ <div className="grid grid-cols-1 @md:grid-cols-2 gap-3">
185
+ <FormField label="First name" htmlFor="contact-givenName">
186
+ <input id="contact-givenName" type="text" className={INPUT_CLASS} value={givenName} onChange={(e) => setGivenName(e.target.value)} />
187
+ </FormField>
188
+ <FormField label="Last name" htmlFor="contact-surname">
189
+ <input id="contact-surname" type="text" className={INPUT_CLASS} value={surname} onChange={(e) => setSurname(e.target.value)} />
190
+ </FormField>
191
+ </div>
192
+
193
+ <div className="grid grid-cols-1 @md:grid-cols-2 gap-3">
194
+ <FormField label="Company" htmlFor="contact-company">
195
+ <input id="contact-company" type="text" className={INPUT_CLASS} value={company} onChange={(e) => setCompany(e.target.value)} />
196
+ </FormField>
197
+ <FormField label="Job title" htmlFor="contact-jobTitle">
198
+ <input id="contact-jobTitle" type="text" className={INPUT_CLASS} value={jobTitle} onChange={(e) => setJobTitle(e.target.value)} />
199
+ </FormField>
200
+ </div>
201
+
202
+ <label className="flex items-center gap-2 text-sm mb-4">
203
+ <input type="checkbox" checked={favorite} onChange={(e) => setFavorite(e.target.checked)} />
204
+ Favorite
205
+ </label>
206
+
207
+ <FormField label="Categories (comma-separated)" htmlFor="contact-categories">
208
+ <input
209
+ id="contact-categories"
210
+ type="text"
211
+ className={INPUT_CLASS}
212
+ value={categoriesText}
213
+ onChange={(e) => setCategoriesText(e.target.value)}
214
+ placeholder="VIP, Work"
215
+ />
216
+ </FormField>
217
+
218
+ <FormField label="Email" htmlFor="contact-emails">
219
+ <div id="contact-emails" className="flex flex-col gap-2">
220
+ {emails.map((email, i) => (
221
+ <div key={i} className="flex gap-2">
222
+ <input
223
+ type="email"
224
+ className={`${INPUT_CLASS} flex-1`}
225
+ value={email.address}
226
+ onChange={(e) => updateEmail(i, { address: e.target.value })}
227
+ aria-label={`Email address ${i + 1}`}
228
+ />
229
+ <select
230
+ className={SELECT_CLASS}
231
+ value={email.type}
232
+ onChange={(e) => updateEmail(i, { type: e.target.value as ContactAddressKind })}
233
+ aria-label={`Email type ${i + 1}`}
234
+ >
235
+ {ADDRESS_KINDS.map((kind) => (
236
+ <option key={kind} value={kind}>
237
+ {kind}
238
+ </option>
239
+ ))}
240
+ </select>
241
+ <button type="button" onClick={() => removeEmail(i)} className="text-sm text-danger px-2" aria-label={`Remove email ${i + 1}`}>
242
+ &times;
243
+ </button>
244
+ </div>
245
+ ))}
246
+ <button
247
+ type="button"
248
+ onClick={() => setEmails((prev) => [...prev, { address: "", type: "work" }])}
249
+ className="self-start text-xs font-medium text-primary-dark hover:underline"
250
+ >
251
+ + Add email
252
+ </button>
253
+ </div>
254
+ </FormField>
255
+
256
+ <FormField label="Phone" htmlFor="contact-phones">
257
+ <div id="contact-phones" className="flex flex-col gap-2">
258
+ {phones.map((phone, i) => (
259
+ <div key={i} className="flex gap-2">
260
+ <input
261
+ type="tel"
262
+ className={`${INPUT_CLASS} flex-1`}
263
+ value={phone.phoneNumber}
264
+ onChange={(e) => updatePhone(i, { phoneNumber: e.target.value })}
265
+ aria-label={`Phone number ${i + 1}`}
266
+ />
267
+ <select
268
+ className={SELECT_CLASS}
269
+ value={phone.type}
270
+ onChange={(e) => updatePhone(i, { type: e.target.value as ContactAddressKind })}
271
+ aria-label={`Phone type ${i + 1}`}
272
+ >
273
+ {ADDRESS_KINDS.map((kind) => (
274
+ <option key={kind} value={kind}>
275
+ {kind}
276
+ </option>
277
+ ))}
278
+ </select>
279
+ <button type="button" onClick={() => removePhone(i)} className="text-sm text-danger px-2" aria-label={`Remove phone ${i + 1}`}>
280
+ &times;
281
+ </button>
282
+ </div>
283
+ ))}
284
+ <button
285
+ type="button"
286
+ onClick={() => setPhones((prev) => [...prev, { phoneNumber: "", type: "work" }])}
287
+ className="self-start text-xs font-medium text-primary-dark hover:underline"
288
+ >
289
+ + Add phone
290
+ </button>
291
+ </div>
292
+ </FormField>
293
+
294
+ <FormField label="Address" htmlFor="contact-address">
295
+ <div className="flex flex-col gap-3">
296
+ {addresses.map((address, i) => (
297
+ <div key={i} className="flex flex-col gap-2">
298
+ <div className="grid grid-cols-1 @md:grid-cols-2 gap-2">
299
+ <input
300
+ type="text"
301
+ placeholder="Street"
302
+ className={INPUT_CLASS}
303
+ value={address.street ?? ""}
304
+ onChange={(e) => updateAddress(i, { street: e.target.value })}
305
+ />
306
+ <input
307
+ type="text"
308
+ placeholder="City"
309
+ className={INPUT_CLASS}
310
+ value={address.city ?? ""}
311
+ onChange={(e) => updateAddress(i, { city: e.target.value })}
312
+ />
313
+ <input
314
+ type="text"
315
+ placeholder="State/Province"
316
+ className={INPUT_CLASS}
317
+ value={address.state ?? ""}
318
+ onChange={(e) => updateAddress(i, { state: e.target.value })}
319
+ />
320
+ <input
321
+ type="text"
322
+ placeholder="Postal code"
323
+ className={INPUT_CLASS}
324
+ value={address.postalCode ?? ""}
325
+ onChange={(e) => updateAddress(i, { postalCode: e.target.value })}
326
+ />
327
+ <input
328
+ type="text"
329
+ placeholder="Country"
330
+ className={INPUT_CLASS}
331
+ value={address.country ?? ""}
332
+ onChange={(e) => updateAddress(i, { country: e.target.value })}
333
+ />
334
+ <select
335
+ className={SELECT_CLASS}
336
+ value={address.type}
337
+ onChange={(e) => updateAddress(i, { type: e.target.value as ContactAddressKind })}
338
+ aria-label={i === 0 ? "Address type" : `Address type ${i + 1}`}
339
+ >
340
+ {ADDRESS_KINDS.map((kind) => (
341
+ <option key={kind} value={kind}>
342
+ {kind}
343
+ </option>
344
+ ))}
345
+ </select>
346
+ </div>
347
+ <button
348
+ type="button"
349
+ onClick={() => removeAddress(i)}
350
+ className="self-start text-xs font-medium text-danger hover:underline"
351
+ aria-label={i === 0 ? "Remove address" : `Remove address ${i + 1}`}
352
+ >
353
+ Remove address
354
+ </button>
355
+ </div>
356
+ ))}
357
+ <button
358
+ type="button"
359
+ onClick={() => setAddresses((prev) => [...prev, { type: "home" }])}
360
+ className="self-start text-xs font-medium text-primary-dark hover:underline"
361
+ >
362
+ + Add address
363
+ </button>
364
+ </div>
365
+ </FormField>
366
+
367
+ <FormField label="Notes" htmlFor="contact-notes">
368
+ <textarea id="contact-notes" rows={3} className={INPUT_CLASS} value={notes} onChange={(e) => setNotes(e.target.value)} />
369
+ </FormField>
370
+
371
+ </div>
372
+ </div>
373
+ <div className="rr-solid sticky bottom-14 z-10 flex shrink-0 gap-3 border-t border-border bg-surface px-6 py-3 md:bottom-0">
374
+ <Button type="submit" loading={saving} disabled={saving} className="!w-auto">
375
+ Save
376
+ </Button>
377
+ <Button type="button" variant="secondary" className="!w-auto" onClick={onCancel}>
378
+ Cancel
379
+ </Button>
380
+ </div>
381
+ </form>
382
+ );
383
+ }