@rapidmx/web-client 0.15.1 → 0.17.0

package/apps/www/settings/read-receipts/index.tsx

@@ -1,147 +1,150 @@
-///////////////////////////////////////////////////////////////////////////////
-// Copyright (C) 2026 Jean-Philippe Steinmetz
-// SPDX-License-Identifier: MPL-2.0
-///////////////////////////////////////////////////////////////////////////////
-import { routedPage } from "../../_routedPage.js";
-import React, { FormEvent, useState } from "react";
-import { updateMailbox } from "@rapidmx/react-shared/mail/mailApi.js";
-import SettingsShell, { SettingsShellProps, useSettingsShell } from "../../../shared/components/settings/layout/SettingsShell.js";
-import Button from "@rapidmx/react-shared/components/buttons/Button.js";
-import { notifyApiError } from "../../../shared/notifications/apiErrors.js";
-
-export type SettingsReadReceiptsPageProps = Omit<SettingsShellProps, "active">;
-
-function SettingsReadReceiptsPage(props: SettingsReadReceiptsPageProps) {
-    return (
-        <SettingsShell {...props} active="read-receipts">
-            <ReadReceiptsContent />
-        </SettingsShell>
-    );
-}
-
-function ReadReceiptsContent() {
-    const { mailboxUid, mailboxes } = useSettingsShell();
-    // `SettingsShell` only ever renders its children once `mailboxes` has loaded and `mailboxUid` has
-    // resolved to one of them — same established non-null pattern as `apps/www/settings/auto-reply/index.tsx`.
-    const mailbox = mailboxes.find((mb) => mb.uid === mailboxUid)!;
-
-    const [alwaysRequestReceiptInternal, setAlwaysRequestReceiptInternal] = useState(mailbox.alwaysRequestReceiptInternal ?? true);
-    const [alwaysRequestReceiptFederated, setAlwaysRequestReceiptFederated] = useState(mailbox.alwaysRequestReceiptFederated ?? false);
-    const [alwaysRequestReceiptExternal, setAlwaysRequestReceiptExternal] = useState(mailbox.alwaysRequestReceiptExternal ?? false);
-    const [autoSendReceiptsInternal, setAutoSendReceiptsInternal] = useState(mailbox.autoSendReceiptsInternal ?? true);
-    const [autoSendReceiptsFederated, setAutoSendReceiptsFederated] = useState(mailbox.autoSendReceiptsFederated ?? false);
-    const [autoSendReceiptsExternal, setAutoSendReceiptsExternal] = useState(mailbox.autoSendReceiptsExternal ?? false);
-    // See auto-reply/index.tsx's identical note - later saves must carry the version the previous save returned.
-    const [version, setVersion] = useState(mailbox.version);
-    const [saving, setSaving] = useState(false);
-    const [saved, setSaved] = useState(false);
-
-    async function handleSubmit(e: FormEvent) {
-        e.preventDefault();
-        setSaved(false);
-        setSaving(true);
-        try {
-            const updated = await updateMailbox({
-                uid: mailbox.uid,
-                version,
-                alwaysRequestReceiptInternal,
-                alwaysRequestReceiptFederated,
-                alwaysRequestReceiptExternal,
-                autoSendReceiptsInternal,
-                autoSendReceiptsFederated,
-                autoSendReceiptsExternal,
-            });
-            setVersion(updated.version);
-            setSaved(true);
-        } catch (err) {
-            notifyApiError(err, "Couldn't save the read receipt settings");
-        } finally {
-            setSaving(false);
-        }
-    }
-
-    return (
-        <div className="flex-1 min-w-0 overflow-y-auto p-6">
-            <div className="max-w-xl">
-                <h1 className="text-lg font-bold tracking-tight mb-1">Read Receipts</h1>
-                <p className="text-sm text-text-muted mb-4">
-                    Controls when this mailbox requests a delivery/read receipt on mail it sends, and how it
-                    responds to a receipt requested of it. A per-message &ldquo;Request a read receipt&rdquo;
-                    checkbox in Compose always overrides the request-side settings below for that one message.
-                </p>
-
-                {saved && <div className="mb-4 text-sm text-success font-medium">Saved.</div>}
-
-                <form onSubmit={handleSubmit} className="flex flex-col gap-5">
-                    <fieldset className="flex flex-col gap-2">
-                        <legend className="text-sm font-semibold mb-1">Request receipts when sending</legend>
-                        <label className="flex items-center gap-2 text-sm">
-                            <input
-                                type="checkbox"
-                                checked={alwaysRequestReceiptInternal}
-                                onChange={(e) => setAlwaysRequestReceiptInternal(e.target.checked)}
-                            />
-                            From internal recipients (mail to this organization)
-                        </label>
-                        <label className="flex items-center gap-2 text-sm">
-                            <input
-                                type="checkbox"
-                                checked={alwaysRequestReceiptFederated}
-                                onChange={(e) => setAlwaysRequestReceiptFederated(e.target.checked)}
-                            />
-                            From federated recipients (partner organizations)
-                        </label>
-                        <label className="flex items-center gap-2 text-sm">
-                            <input
-                                type="checkbox"
-                                checked={alwaysRequestReceiptExternal}
-                                onChange={(e) => setAlwaysRequestReceiptExternal(e.target.checked)}
-                            />
-                            From external recipients
-                        </label>
-                    </fieldset>
-
-                    <fieldset className="flex flex-col gap-2">
-                        <legend className="text-sm font-semibold mb-1">Respond automatically to requests</legend>
-                        <label className="flex items-center gap-2 text-sm">
-                            <input
-                                type="checkbox"
-                                checked={autoSendReceiptsInternal}
-                                onChange={(e) => setAutoSendReceiptsInternal(e.target.checked)}
-                            />
-                            From internal senders
-                        </label>
-                        <label className="flex items-center gap-2 text-sm">
-                            <input
-                                type="checkbox"
-                                checked={autoSendReceiptsFederated}
-                                onChange={(e) => setAutoSendReceiptsFederated(e.target.checked)}
-                            />
-                            From federated senders (partner organizations)
-                        </label>
-                        <label className="flex items-center gap-2 text-sm">
-                            <input
-                                type="checkbox"
-                                checked={autoSendReceiptsExternal}
-                                onChange={(e) => setAutoSendReceiptsExternal(e.target.checked)}
-                            />
-                            From external senders
-                        </label>
-                        <p className="text-xs text-text-muted">
-                            Unchecked means a request from that sender waits in your Inbox for you to send or
-                            decline it explicitly.
-                        </p>
-                    </fieldset>
-
-                    <div>
-                        <Button type="submit" loading={saving} disabled={saving} className="!w-auto">
-                            Save
-                        </Button>
-                    </div>
-                </form>
-            </div>
-        </div>
-    );
-}
-
-export default routedPage("/settings/read-receipts", SettingsReadReceiptsPage);
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { pageTitle } from "../../../shared/navigation/pageTitle.js";
+import React, { FormEvent, useState } from "react";
+import { updateMailbox } from "@rapidmx/react-shared/mail/mailApi.js";
+import SettingsShell, { SettingsShellProps, useSettingsShell } from "../../../shared/components/settings/layout/SettingsShell.js";
+import Button from "@rapidmx/react-shared/components/buttons/Button.js";
+import { notifyApiError } from "../../../shared/notifications/apiErrors.js";
+
+export type SettingsReadReceiptsPageProps = Omit<SettingsShellProps, "active">;
+
+function SettingsReadReceiptsPage(props: SettingsReadReceiptsPageProps) {
+    return (
+        <SettingsShell {...props} active="read-receipts">
+            <ReadReceiptsContent />
+        </SettingsShell>
+    );
+}
+
+function ReadReceiptsContent() {
+    const { mailboxUid, mailboxes } = useSettingsShell();
+    // `SettingsShell` only ever renders its children once `mailboxes` has loaded and `mailboxUid` has
+    // resolved to one of them — same established non-null pattern as `apps/www/settings/auto-reply/index.tsx`.
+    const mailbox = mailboxes.find((mb) => mb.uid === mailboxUid)!;
+
+    const [alwaysRequestReceiptInternal, setAlwaysRequestReceiptInternal] = useState(mailbox.alwaysRequestReceiptInternal ?? true);
+    const [alwaysRequestReceiptFederated, setAlwaysRequestReceiptFederated] = useState(mailbox.alwaysRequestReceiptFederated ?? false);
+    const [alwaysRequestReceiptExternal, setAlwaysRequestReceiptExternal] = useState(mailbox.alwaysRequestReceiptExternal ?? false);
+    const [autoSendReceiptsInternal, setAutoSendReceiptsInternal] = useState(mailbox.autoSendReceiptsInternal ?? true);
+    const [autoSendReceiptsFederated, setAutoSendReceiptsFederated] = useState(mailbox.autoSendReceiptsFederated ?? false);
+    const [autoSendReceiptsExternal, setAutoSendReceiptsExternal] = useState(mailbox.autoSendReceiptsExternal ?? false);
+    // See auto-reply/index.tsx's identical note - later saves must carry the version the previous save returned.
+    const [version, setVersion] = useState(mailbox.version);
+    const [saving, setSaving] = useState(false);
+    const [saved, setSaved] = useState(false);
+
+    async function handleSubmit(e: FormEvent) {
+        e.preventDefault();
+        setSaved(false);
+        setSaving(true);
+        try {
+            const updated = await updateMailbox({
+                uid: mailbox.uid,
+                version,
+                alwaysRequestReceiptInternal,
+                alwaysRequestReceiptFederated,
+                alwaysRequestReceiptExternal,
+                autoSendReceiptsInternal,
+                autoSendReceiptsFederated,
+                autoSendReceiptsExternal,
+            });
+            setVersion(updated.version);
+            setSaved(true);
+        } catch (err) {
+            notifyApiError(err, "Couldn't save the read receipt settings");
+        } finally {
+            setSaving(false);
+        }
+    }
+
+    return (
+        <div className="flex-1 min-w-0 overflow-y-auto p-6">
+            <div className="max-w-xl">
+                <h1 className="text-lg font-bold tracking-tight mb-1">Read Receipts</h1>
+                <p className="text-sm text-text-muted mb-4">
+                    Controls when this mailbox requests a delivery/read receipt on mail it sends, and how it
+                    responds to a receipt requested of it. A per-message &ldquo;Request a read receipt&rdquo;
+                    checkbox in Compose always overrides the request-side settings below for that one message.
+                </p>
+
+                {saved && <div className="mb-4 text-sm text-success font-medium">Saved.</div>}
+
+                <form onSubmit={handleSubmit} className="flex flex-col gap-5">
+                    <fieldset className="flex flex-col gap-2">
+                        <legend className="text-sm font-semibold mb-1">Request receipts when sending</legend>
+                        <label className="flex items-center gap-2 text-sm">
+                            <input
+                                type="checkbox"
+                                checked={alwaysRequestReceiptInternal}
+                                onChange={(e) => setAlwaysRequestReceiptInternal(e.target.checked)}
+                            />
+                            From internal recipients (mail to this organization)
+                        </label>
+                        <label className="flex items-center gap-2 text-sm">
+                            <input
+                                type="checkbox"
+                                checked={alwaysRequestReceiptFederated}
+                                onChange={(e) => setAlwaysRequestReceiptFederated(e.target.checked)}
+                            />
+                            From federated recipients (partner organizations)
+                        </label>
+                        <label className="flex items-center gap-2 text-sm">
+                            <input
+                                type="checkbox"
+                                checked={alwaysRequestReceiptExternal}
+                                onChange={(e) => setAlwaysRequestReceiptExternal(e.target.checked)}
+                            />
+                            From external recipients
+                        </label>
+                    </fieldset>
+
+                    <fieldset className="flex flex-col gap-2">
+                        <legend className="text-sm font-semibold mb-1">Respond automatically to requests</legend>
+                        <label className="flex items-center gap-2 text-sm">
+                            <input
+                                type="checkbox"
+                                checked={autoSendReceiptsInternal}
+                                onChange={(e) => setAutoSendReceiptsInternal(e.target.checked)}
+                            />
+                            From internal senders
+                        </label>
+                        <label className="flex items-center gap-2 text-sm">
+                            <input
+                                type="checkbox"
+                                checked={autoSendReceiptsFederated}
+                                onChange={(e) => setAutoSendReceiptsFederated(e.target.checked)}
+                            />
+                            From federated senders (partner organizations)
+                        </label>
+                        <label className="flex items-center gap-2 text-sm">
+                            <input
+                                type="checkbox"
+                                checked={autoSendReceiptsExternal}
+                                onChange={(e) => setAutoSendReceiptsExternal(e.target.checked)}
+                            />
+                            From external senders
+                        </label>
+                        <p className="text-xs text-text-muted">
+                            Unchecked means a request from that sender waits in your Inbox for you to send or
+                            decline it explicitly.
+                        </p>
+                    </fieldset>
+
+                    <div>
+                        <Button type="submit" loading={saving} disabled={saving} className="!w-auto">
+                            Save
+                        </Button>
+                    </div>
+                </form>
+            </div>
+        </div>
+    );
+}
+
+export default SettingsReadReceiptsPage;
+
+/** The tab's title: `Brand: Settings` (see `pageTitle()`). */
+export const title = pageTitle("Settings");