@rapidmx/web-client 0.15.1 → 0.17.0

package/apps/www/settings/filters/[uid].tsx

@@ -1,176 +1,179 @@
-///////////////////////////////////////////////////////////////////////////////
-// Copyright (C) 2026 Jean-Philippe Steinmetz
-// SPDX-License-Identifier: MPL-2.0
-///////////////////////////////////////////////////////////////////////////////
-import { routedPage } from "../../_routedPage.js";
-import React, { FormEvent, useEffect, useState } from "react";
-import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
-import { Folder, listFolders } from "@rapidmx/react-shared/mail/mailApi.js";
-import {
-    MailFilterAction,
-    MailFilterConditions,
-    MailFilterRule,
-    getMailFilterRule,
-    updateMailFilterRule,
-} from "@rapidmx/react-shared/mail/mailFilterRulesApi.js";
-import SettingsShell, { SettingsShellProps, useSettingsShell } from "../../../shared/components/settings/layout/SettingsShell.js";
-import RuleBuilder, { hasConditions, RuleBuilderValue } from "../../../shared/components/rules/RuleBuilder.js";
-import { MAIL_FILTER_CONDITION_FIELDS, buildMailFilterActionTypes } from "./_mailFilterRuleConfig.js";
-import Alert from "@rapidmx/react-shared/components/feedback/Alert.js";
-import Button from "@rapidmx/react-shared/components/buttons/Button.js";
-import FormField from "@rapidmx/react-shared/components/forms/FormField.js";
-import { notifyApiError } from "../../../shared/notifications/apiErrors.js";
-
-const INPUT_CLASS =
-    "w-full text-sm py-2.5 px-3 border border-border rounded-sm bg-surface text-text focus:outline-none focus:border-primary";
-
-export type MailFilterDetailPageProps = Omit<SettingsShellProps, "active"> & { params: { uid: string } };
-
-function MailFilterDetailPage(props: MailFilterDetailPageProps) {
-    return (
-        <SettingsShell {...props} active="filters">
-            <MailFilterDetailContent uid={props.params.uid} />
-        </SettingsShell>
-    );
-}
-
-function MailFilterDetailContent({ uid }: { uid: string }) {
-    const { mailboxUid } = useSettingsShell();
-    const [original, setOriginal] = useState<MailFilterRule | null>(null);
-    const [name, setName] = useState("");
-    const [rule, setRule] = useState<RuleBuilderValue<MailFilterConditions, MailFilterAction> | null>(null);
-    const [folders, setFolders] = useState<Folder[] | null>(null);
-    const [loading, setLoading] = useState(true);
-    const [error, setError] = useState<string | null>(null);
-    const [saving, setSaving] = useState(false);
-    const [saved, setSaved] = useState(false);
-    const [showValidation, setShowValidation] = useState(false);
-
-    // The folder picker lists the *rule's own* mailbox's folders, not the switcher's - a rule opened by
-    // direct link (or after switching mailboxes) can belong to a different mailbox than `mailboxUid`,
-    // and a move-to-folder action must only ever offer folders the rule can actually target.
-    const ruleMailboxUid = original?.mailboxUid;
-    useEffect(() => {
-        if (!ruleMailboxUid) {
-            return;
-        }
-        listFolders(ruleMailboxUid).then(setFolders).catch(() => setFolders([]));
-    }, [ruleMailboxUid]);
-
-    useEffect(() => {
-        setLoading(true);
-        setError(null);
-        getMailFilterRule(uid)
-            .then((loaded) => {
-                setOriginal(loaded);
-                if (loaded) {
-                    setName(loaded.name);
-                    setRule({
-                        enabled: loaded.enabled,
-                        sequence: loaded.sequence,
-                        stopProcessingRules: loaded.stopProcessingRules,
-                        conditions: loaded.conditions,
-                        actions: loaded.actions,
-                    });
-                }
-            })
-            .catch((err) => setError(err instanceof ApiRequestError ? err.message : "Could not load this mail filter."))
-            .finally(() => setLoading(false));
-    }, [uid]);
-
-    // Only ever invoked from the form below, which itself only renders once `original`/`rule` are
-    // loaded (the early returns above cover every other state) — the non-null assertions reflect that
-    // real invariant, matching `TransportRuleDetailContent.handleSubmit`'s identical pattern.
-    async function handleSubmit(e: FormEvent) {
-        e.preventDefault();
-        setError(null);
-
-        if (!name.trim()) {
-            setError("A name is required.");
-            return;
-        }
-        if (!hasConditions(rule!.conditions)) {
-            setShowValidation(true);
-            setError("Add at least one condition. A filter without conditions would apply to every message.");
-            return;
-        }
-
-        setSaving(true);
-        setSaved(false);
-        try {
-            const updated = await updateMailFilterRule({
-                uid: original!.uid,
-                version: original!.version,
-                name: name.trim(),
-                ...rule!,
-            });
-            setOriginal(updated);
-            setSaved(true);
-        } catch (err) {
-            // A pop-up: `error` is only this form's own validation (and the load failure above).
-            notifyApiError(err, "Couldn't save the mail filter");
-        } finally {
-            setSaving(false);
-        }
-    }
-
-    if (loading) {
-        return <p className="p-6 text-sm text-text-muted">Loading&hellip;</p>;
-    }
-    if (error && !original) {
-        return (
-            <div className="p-6">
-                <Alert>{error}</Alert>
-            </div>
-        );
-    }
-    if (!original || !rule) {
-        return (
-            <div className="p-6">
-                <Alert>Mail filter not found.</Alert>
-            </div>
-        );
-    }
-    // The folder list is fetched for the rule's own mailbox, so it can only start once the rule has loaded.
-    if (folders === null) {
-        return <p className="p-6 text-sm text-text-muted">Loading&hellip;</p>;
-    }
-
-    return (
-        <div className="flex-1 min-w-0 overflow-y-auto p-6">
-            <div className="max-w-3xl">
-                <a href={`/settings/filters?mailboxUid=${encodeURIComponent(mailboxUid!)}`} className="text-sm text-primary-dark hover:underline">
-                    &larr; All mail filters
-                </a>
-                <h1 className="text-lg font-bold tracking-tight mt-1 mb-5">{original.name}</h1>
-
-                {error && <Alert>{error}</Alert>}
-                {saved && !error && <div className="mb-4 text-sm text-success font-medium">Saved.</div>}
-
-                <form onSubmit={handleSubmit} className="flex flex-col gap-5">
-                    <div className="bg-surface border border-border rounded-md p-6">
-                        <FormField label="Name" htmlFor="name">
-                            <input id="name" type="text" className={INPUT_CLASS} value={name} onChange={(e) => setName(e.target.value)} />
-                        </FormField>
-                    </div>
-
-                    <RuleBuilder
-                        value={rule}
-                        onChange={setRule}
-                        conditionFields={MAIL_FILTER_CONDITION_FIELDS}
-                        actionTypes={buildMailFilterActionTypes(folders)}
-                        showValidation={showValidation}
-                    />
-
-                    <div>
-                        <Button type="submit" loading={saving} disabled={saving} className="!w-auto">
-                            Save changes
-                        </Button>
-                    </div>
-                </form>
-            </div>
-        </div>
-    );
-}
-
-export default routedPage("/settings/filters/:uid", MailFilterDetailPage);
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { pageTitle } from "../../../shared/navigation/pageTitle.js";
+import React, { FormEvent, useEffect, useState } from "react";
+import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
+import { Folder, listFolders } from "@rapidmx/react-shared/mail/mailApi.js";
+import {
+    MailFilterAction,
+    MailFilterConditions,
+    MailFilterRule,
+    getMailFilterRule,
+    updateMailFilterRule,
+} from "@rapidmx/react-shared/mail/mailFilterRulesApi.js";
+import SettingsShell, { SettingsShellProps, useSettingsShell } from "../../../shared/components/settings/layout/SettingsShell.js";
+import RuleBuilder, { hasConditions, RuleBuilderValue } from "../../../shared/components/rules/RuleBuilder.js";
+import { MAIL_FILTER_CONDITION_FIELDS, buildMailFilterActionTypes } from "./_mailFilterRuleConfig.js";
+import Alert from "@rapidmx/react-shared/components/feedback/Alert.js";
+import Button from "@rapidmx/react-shared/components/buttons/Button.js";
+import FormField from "@rapidmx/react-shared/components/forms/FormField.js";
+import { notifyApiError } from "../../../shared/notifications/apiErrors.js";
+
+const INPUT_CLASS =
+    "w-full text-sm py-2.5 px-3 border border-border rounded-sm bg-surface text-text focus:outline-none focus:border-primary";
+
+export type MailFilterDetailPageProps = Omit<SettingsShellProps, "active"> & { params: { uid: string } };
+
+function MailFilterDetailPage(props: MailFilterDetailPageProps) {
+    return (
+        <SettingsShell {...props} active="filters">
+            <MailFilterDetailContent uid={props.params.uid} />
+        </SettingsShell>
+    );
+}
+
+function MailFilterDetailContent({ uid }: { uid: string }) {
+    const { mailboxUid } = useSettingsShell();
+    const [original, setOriginal] = useState<MailFilterRule | null>(null);
+    const [name, setName] = useState("");
+    const [rule, setRule] = useState<RuleBuilderValue<MailFilterConditions, MailFilterAction> | null>(null);
+    const [folders, setFolders] = useState<Folder[] | null>(null);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState<string | null>(null);
+    const [saving, setSaving] = useState(false);
+    const [saved, setSaved] = useState(false);
+    const [showValidation, setShowValidation] = useState(false);
+
+    // The folder picker lists the *rule's own* mailbox's folders, not the switcher's - a rule opened by
+    // direct link (or after switching mailboxes) can belong to a different mailbox than `mailboxUid`,
+    // and a move-to-folder action must only ever offer folders the rule can actually target.
+    const ruleMailboxUid = original?.mailboxUid;
+    useEffect(() => {
+        if (!ruleMailboxUid) {
+            return;
+        }
+        listFolders(ruleMailboxUid).then(setFolders).catch(() => setFolders([]));
+    }, [ruleMailboxUid]);
+
+    useEffect(() => {
+        setLoading(true);
+        setError(null);
+        getMailFilterRule(uid)
+            .then((loaded) => {
+                setOriginal(loaded);
+                if (loaded) {
+                    setName(loaded.name);
+                    setRule({
+                        enabled: loaded.enabled,
+                        sequence: loaded.sequence,
+                        stopProcessingRules: loaded.stopProcessingRules,
+                        conditions: loaded.conditions,
+                        actions: loaded.actions,
+                    });
+                }
+            })
+            .catch((err) => setError(err instanceof ApiRequestError ? err.message : "Could not load this mail filter."))
+            .finally(() => setLoading(false));
+    }, [uid]);
+
+    // Only ever invoked from the form below, which itself only renders once `original`/`rule` are
+    // loaded (the early returns above cover every other state) — the non-null assertions reflect that
+    // real invariant, matching `TransportRuleDetailContent.handleSubmit`'s identical pattern.
+    async function handleSubmit(e: FormEvent) {
+        e.preventDefault();
+        setError(null);
+
+        if (!name.trim()) {
+            setError("A name is required.");
+            return;
+        }
+        if (!hasConditions(rule!.conditions)) {
+            setShowValidation(true);
+            setError("Add at least one condition. A filter without conditions would apply to every message.");
+            return;
+        }
+
+        setSaving(true);
+        setSaved(false);
+        try {
+            const updated = await updateMailFilterRule({
+                uid: original!.uid,
+                version: original!.version,
+                name: name.trim(),
+                ...rule!,
+            });
+            setOriginal(updated);
+            setSaved(true);
+        } catch (err) {
+            // A pop-up: `error` is only this form's own validation (and the load failure above).
+            notifyApiError(err, "Couldn't save the mail filter");
+        } finally {
+            setSaving(false);
+        }
+    }
+
+    if (loading) {
+        return <p className="p-6 text-sm text-text-muted">Loading&hellip;</p>;
+    }
+    if (error && !original) {
+        return (
+            <div className="p-6">
+                <Alert>{error}</Alert>
+            </div>
+        );
+    }
+    if (!original || !rule) {
+        return (
+            <div className="p-6">
+                <Alert>Mail filter not found.</Alert>
+            </div>
+        );
+    }
+    // The folder list is fetched for the rule's own mailbox, so it can only start once the rule has loaded.
+    if (folders === null) {
+        return <p className="p-6 text-sm text-text-muted">Loading&hellip;</p>;
+    }
+
+    return (
+        <div className="flex-1 min-w-0 overflow-y-auto p-6">
+            <div className="max-w-3xl">
+                <a href={`/settings/filters?mailboxUid=${encodeURIComponent(mailboxUid!)}`} className="text-sm text-primary-dark hover:underline">
+                    &larr; All mail filters
+                </a>
+                <h1 className="text-lg font-bold tracking-tight mt-1 mb-5">{original.name}</h1>
+
+                {error && <Alert>{error}</Alert>}
+                {saved && !error && <div className="mb-4 text-sm text-success font-medium">Saved.</div>}
+
+                <form onSubmit={handleSubmit} className="flex flex-col gap-5">
+                    <div className="bg-surface border border-border rounded-md p-6">
+                        <FormField label="Name" htmlFor="name">
+                            <input id="name" type="text" className={INPUT_CLASS} value={name} onChange={(e) => setName(e.target.value)} />
+                        </FormField>
+                    </div>
+
+                    <RuleBuilder
+                        value={rule}
+                        onChange={setRule}
+                        conditionFields={MAIL_FILTER_CONDITION_FIELDS}
+                        actionTypes={buildMailFilterActionTypes(folders)}
+                        showValidation={showValidation}
+                    />
+
+                    <div>
+                        <Button type="submit" loading={saving} disabled={saving} className="!w-auto">
+                            Save changes
+                        </Button>
+                    </div>
+                </form>
+            </div>
+        </div>
+    );
+}
+
+export default MailFilterDetailPage;
+
+/** The tab's title: `Brand: Settings` (see `pageTitle()`). */
+export const title = pageTitle("Settings");

package/apps/www/settings/filters/index.tsx

@@ -1,102 +1,105 @@
-///////////////////////////////////////////////////////////////////////////////
-// Copyright (C) 2026 Jean-Philippe Steinmetz
-// SPDX-License-Identifier: MPL-2.0
-///////////////////////////////////////////////////////////////////////////////
-import { routedPage } from "../../_routedPage.js";
-import React, { useEffect, useState } from "react";
-import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
-import { MailFilterRule, listMailFilterRules } from "@rapidmx/react-shared/mail/mailFilterRulesApi.js";
-import SettingsShell, { SettingsShellProps, useSettingsShell } from "../../../shared/components/settings/layout/SettingsShell.js";
-import Alert from "@rapidmx/react-shared/components/feedback/Alert.js";
-import Button from "@rapidmx/react-shared/components/buttons/Button.js";
-
-export type SettingsFiltersPageProps = Omit<SettingsShellProps, "active">;
-
-function SettingsFiltersPage(props: SettingsFiltersPageProps) {
-    return (
-        <SettingsShell {...props} active="filters">
-            <FiltersContent />
-        </SettingsShell>
-    );
-}
-
-function FiltersContent() {
-    const { mailboxUid } = useSettingsShell();
-    const [rules, setRules] = useState<MailFilterRule[]>([]);
-    const [loading, setLoading] = useState(true);
-    const [error, setError] = useState<string | null>(null);
-
-    // `SettingsShell` only ever renders its children once `mailboxUid` has resolved — same established
-    // non-null pattern as `apps/www/settings/auto-reply/index.tsx`.
-    useEffect(() => {
-        listMailFilterRules(mailboxUid!)
-            .then(setRules)
-            .catch((err) => setError(err instanceof ApiRequestError ? err.message : "Could not load mail filters."))
-            .finally(() => setLoading(false));
-    }, [mailboxUid]);
-
-    const sorted = [...rules].sort((a, b) => a.sequence - b.sequence);
-
-    return (
-        <div className="flex-1 min-w-0 overflow-y-auto p-6">
-            <div className="max-w-3xl">
-                <div className="flex items-center justify-between mb-5">
-                    <h1 className="text-lg font-bold tracking-tight">Mail Filters</h1>
-                    <a href={`/settings/filters/new?mailboxUid=${encodeURIComponent(mailboxUid!)}`}>
-                        <Button type="button" className="!w-auto">
-                            + New filter
-                        </Button>
-                    </a>
-                </div>
-                <p className="text-sm text-text-muted mb-4">
-                    Applied in order once a message is verdicted safe to deliver, before it reaches your Inbox.
-                </p>
-
-                {error && <Alert>{error}</Alert>}
-
-                {loading ? (
-                    <p className="text-sm text-text-muted">Loading&hellip;</p>
-                ) : sorted.length === 0 ? (
-                    <p className="text-sm text-text-muted">No mail filters yet.</p>
-                ) : (
-                    <div className="overflow-x-auto">
-                        <table className="w-full text-sm border-collapse">
-                            <thead>
-                                <tr>
-                                    {["Sequence", "Name", "Enabled", "Actions", ""].map((h) => (
-                                        <th
-                                            key={h}
-                                            className="text-left text-xs uppercase tracking-wide text-text-muted py-2 px-2.5 border-b border-border"
-                                        >
-                                            {h}
-                                        </th>
-                                    ))}
-                                </tr>
-                            </thead>
-                            <tbody>
-                                {sorted.map((rule) => (
-                                    <tr key={rule.uid}>
-                                        <td className="py-2.5 px-2.5 border-b border-border">{rule.sequence}</td>
-                                        <td className="py-2.5 px-2.5 border-b border-border">{rule.name}</td>
-                                        <td className="py-2.5 px-2.5 border-b border-border">{rule.enabled ? "Yes" : "No"}</td>
-                                        <td className="py-2.5 px-2.5 border-b border-border">{rule.actions.length}</td>
-                                        <td className="py-2.5 px-2.5 border-b border-border text-right">
-                                            <a
-                                                href={`/settings/filters/${encodeURIComponent(rule.uid)}?mailboxUid=${encodeURIComponent(mailboxUid!)}`}
-                                                className="text-primary-dark hover:underline font-medium"
-                                            >
-                                                View
-                                            </a>
-                                        </td>
-                                    </tr>
-                                ))}
-                            </tbody>
-                        </table>
-                    </div>
-                )}
-            </div>
-        </div>
-    );
-}
-
-export default routedPage("/settings/filters", SettingsFiltersPage);
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { pageTitle } from "../../../shared/navigation/pageTitle.js";
+import React, { useEffect, useState } from "react";
+import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
+import { MailFilterRule, listMailFilterRules } from "@rapidmx/react-shared/mail/mailFilterRulesApi.js";
+import SettingsShell, { SettingsShellProps, useSettingsShell } from "../../../shared/components/settings/layout/SettingsShell.js";
+import Alert from "@rapidmx/react-shared/components/feedback/Alert.js";
+import Button from "@rapidmx/react-shared/components/buttons/Button.js";
+
+export type SettingsFiltersPageProps = Omit<SettingsShellProps, "active">;
+
+function SettingsFiltersPage(props: SettingsFiltersPageProps) {
+    return (
+        <SettingsShell {...props} active="filters">
+            <FiltersContent />
+        </SettingsShell>
+    );
+}
+
+function FiltersContent() {
+    const { mailboxUid } = useSettingsShell();
+    const [rules, setRules] = useState<MailFilterRule[]>([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState<string | null>(null);
+
+    // `SettingsShell` only ever renders its children once `mailboxUid` has resolved — same established
+    // non-null pattern as `apps/www/settings/auto-reply/index.tsx`.
+    useEffect(() => {
+        listMailFilterRules(mailboxUid!)
+            .then(setRules)
+            .catch((err) => setError(err instanceof ApiRequestError ? err.message : "Could not load mail filters."))
+            .finally(() => setLoading(false));
+    }, [mailboxUid]);
+
+    const sorted = [...rules].sort((a, b) => a.sequence - b.sequence);
+
+    return (
+        <div className="flex-1 min-w-0 overflow-y-auto p-6">
+            <div className="max-w-3xl">
+                <div className="flex items-center justify-between mb-5">
+                    <h1 className="text-lg font-bold tracking-tight">Mail Filters</h1>
+                    <a href={`/settings/filters/new?mailboxUid=${encodeURIComponent(mailboxUid!)}`}>
+                        <Button type="button" className="!w-auto">
+                            + New filter
+                        </Button>
+                    </a>
+                </div>
+                <p className="text-sm text-text-muted mb-4">
+                    Applied in order once a message is verdicted safe to deliver, before it reaches your Inbox.
+                </p>
+
+                {error && <Alert>{error}</Alert>}
+
+                {loading ? (
+                    <p className="text-sm text-text-muted">Loading&hellip;</p>
+                ) : sorted.length === 0 ? (
+                    <p className="text-sm text-text-muted">No mail filters yet.</p>
+                ) : (
+                    <div className="overflow-x-auto">
+                        <table className="w-full text-sm border-collapse">
+                            <thead>
+                                <tr>
+                                    {["Sequence", "Name", "Enabled", "Actions", ""].map((h) => (
+                                        <th
+                                            key={h}
+                                            className="text-left text-xs uppercase tracking-wide text-text-muted py-2 px-2.5 border-b border-border"
+                                        >
+                                            {h}
+                                        </th>
+                                    ))}
+                                </tr>
+                            </thead>
+                            <tbody>
+                                {sorted.map((rule) => (
+                                    <tr key={rule.uid}>
+                                        <td className="py-2.5 px-2.5 border-b border-border">{rule.sequence}</td>
+                                        <td className="py-2.5 px-2.5 border-b border-border">{rule.name}</td>
+                                        <td className="py-2.5 px-2.5 border-b border-border">{rule.enabled ? "Yes" : "No"}</td>
+                                        <td className="py-2.5 px-2.5 border-b border-border">{rule.actions.length}</td>
+                                        <td className="py-2.5 px-2.5 border-b border-border text-right">
+                                            <a
+                                                href={`/settings/filters/${encodeURIComponent(rule.uid)}?mailboxUid=${encodeURIComponent(mailboxUid!)}`}
+                                                className="text-primary-dark hover:underline font-medium"
+                                            >
+                                                View
+                                            </a>
+                                        </td>
+                                    </tr>
+                                ))}
+                            </tbody>
+                        </table>
+                    </div>
+                )}
+            </div>
+        </div>
+    );
+}
+
+export default SettingsFiltersPage;
+
+/** The tab's title: `Brand: Settings` (see `pageTitle()`). */
+export const title = pageTitle("Settings");