@rapidmx/web-client 0.14.1 → 0.16.0

package/apps/shared/components/admin/settings/MailboxPolicyForm.tsx

@@ -1,198 +1,198 @@
-///////////////////////////////////////////////////////////////////////////////
-// Copyright (C) 2026 Jean-Philippe Steinmetz
-// SPDX-License-Identifier: MPL-2.0
-///////////////////////////////////////////////////////////////////////////////
-import React, { FormEvent, useEffect, useState } from "react";
-import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
-import { MailboxPolicy, updateMailboxPolicy } from "@rapidmx/react-shared/admin/mailboxPolicyApi.js";
-import Alert from "@rapidmx/react-shared/components/feedback/Alert.js";
-import Button from "@rapidmx/react-shared/components/buttons/Button.js";
-
-const INPUT_CLASS =
-    "w-full text-sm py-2 px-3 border border-border rounded-sm bg-surface text-text focus:outline-none focus:border-primary";
-
-const GB = 1_000_000_000;
-
-/** Unrounded, so a quota that isn't a whole number of hundredths of a GB (say 4 MB) is shown as it is. */
-function toGb(bytes: number): string {
-    return String(bytes / GB);
-}
-
-/** Whether a quota field's text is not the given number of bytes. */
-function differsFromBytes(text: string, bytes: number): boolean {
-    return Math.round(Number(text) * GB) !== bytes;
-}
-
-/** Puts a field back to the server's config value; nothing is saved until the form is. */
-function ResetToDefault({ label, shown, onClick }: { label: string; shown: boolean; onClick: () => void }) {
-    if (!shown) {
-        return null;
-    }
-    return (
-        <Button type="button" variant="text" className="!w-auto self-start text-xs -mt-2" onClick={onClick}>
-            Reset to server default ({label})
-        </Button>
-    );
-}
-
-/** The form's values as they were loaded or last saved. */
-interface Baseline {
-    defaultQuotaGb: string;
-    autoProvisionEnabled: boolean;
-    autoProvisionQuotaGb: string;
-}
-
-export interface MailboxPolicyFormProps {
-    policy: MailboxPolicy;
-    onChange: (policy: MailboxPolicy) => void;
-    /** Told whether the form has edits that haven't been saved. */
-    onDirtyChange?: (dirty: boolean) => void;
-    /** Set when shown as one section of a page with its own heading (the setup wizard), so the title is a smaller,
-     * lower-level heading. */
-    embedded?: boolean;
-}
-
-/**
- * The mailbox defaults editor, shared by the Mailbox Policy page and the setup wizard. Each field can be reset to what
- * the server's config currently says (`policy.defaults`), which lets an administrator take a newly deployed value
- * without typing it in; the reset fills the field in and is saved with the rest of the form.
- */
-export default function MailboxPolicyForm({ policy, onChange, onDirtyChange, embedded = false }: MailboxPolicyFormProps) {
-    const defaults = policy.defaults;
-    const [defaultQuotaGb, setDefaultQuotaGb] = useState(toGb(policy.defaultQuotaBytes));
-    const [autoProvisionEnabled, setAutoProvisionEnabled] = useState(policy.autoProvisionEnabled);
-    const [autoProvisionQuotaGb, setAutoProvisionQuotaGb] = useState(toGb(policy.autoProvisionQuotaBytes));
-    const [error, setError] = useState<string | null>(null);
-    const [saving, setSaving] = useState(false);
-    const [saved, setSaved] = useState(false);
-
-    // Edits are unsaved until they match what was loaded or last saved.
-    const [baseline, setBaseline] = useState<Baseline>({ defaultQuotaGb, autoProvisionEnabled, autoProvisionQuotaGb });
-    const dirty: boolean =
-        defaultQuotaGb !== baseline.defaultQuotaGb ||
-        autoProvisionEnabled !== baseline.autoProvisionEnabled ||
-        autoProvisionQuotaGb !== baseline.autoProvisionQuotaGb;
-    useEffect(() => onDirtyChange?.(dirty), [dirty]);
-
-    async function handleSubmit(e: FormEvent) {
-        e.preventDefault();
-        setError(null);
-        setSaved(false);
-        // Only fields the administrator changed are sent, so a quota left alone keeps its exact stored bytes.
-        const patch: Partial<MailboxPolicy> = {};
-        for (const [field, text, base] of [
-            ["defaultQuotaBytes", defaultQuotaGb, baseline.defaultQuotaGb],
-            ["autoProvisionQuotaBytes", autoProvisionQuotaGb, baseline.autoProvisionQuotaGb],
-        ] as const) {
-            if (text === base) {
-                continue;
-            }
-            const bytes: number = Math.round(Number(text) * GB);
-            if (!(bytes >= 1)) {
-                setError("Quotas must be more than 0 GB.");
-                return;
-            }
-            patch[field] = bytes;
-        }
-        if (autoProvisionEnabled !== baseline.autoProvisionEnabled) {
-            patch.autoProvisionEnabled = autoProvisionEnabled;
-        }
-        const current: Baseline = { defaultQuotaGb, autoProvisionEnabled, autoProvisionQuotaGb };
-        if (Object.keys(patch).length === 0) {
-            setSaved(true);
-            return;
-        }
-        setSaving(true);
-        try {
-            const updated = await updateMailboxPolicy(patch);
-            onChange(updated);
-            setBaseline(current);
-            setSaved(true);
-        } catch (err) {
-            setError(err instanceof ApiRequestError ? err.message : "Could not save the mailbox policy.");
-        } finally {
-            setSaving(false);
-        }
-    }
-
-    return (
-        <div className="max-w-xl">
-            {embedded ? (
-                <h3 className="text-base font-bold uppercase tracking-wide mb-1">Mailboxes</h3>
-            ) : (
-                <h2 className="text-lg font-bold uppercase tracking-wide mb-1">Mailboxes</h2>
-            )}
-            <p className="text-sm text-text-muted mb-5">Defaults for new mailboxes on this server.</p>
-
-            {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-4">
-                <label className="flex flex-col gap-1.5 text-sm">
-                    <span className="font-semibold">Default quota (GB)</span>
-                    <input
-                        aria-label="Default quota (GB)"
-                        type="number"
-                        min={0}
-                        step="any"
-                        className={INPUT_CLASS}
-                        value={defaultQuotaGb}
-                        onChange={(e) => setDefaultQuotaGb(e.target.value)}
-                    />
-                    <span className="text-xs text-text-muted">The storage a mailbox starts with when an administrator creates it.</span>
-                </label>
-                <ResetToDefault
-                    label={defaults ? `${toGb(defaults.defaultQuotaBytes)} GB` : ""}
-                    shown={!!defaults && differsFromBytes(defaultQuotaGb, defaults.defaultQuotaBytes)}
-                    onClick={() => setDefaultQuotaGb(toGb(defaults!.defaultQuotaBytes))}
-                />
-                <label className="flex items-start gap-2 text-sm">
-                    <input
-                        type="checkbox"
-                        className="mt-1"
-                        checked={autoProvisionEnabled}
-                        onChange={(e) => setAutoProvisionEnabled(e.target.checked)}
-                    />
-                    <span>
-                        <span className="font-semibold block">Let people create their own mailbox</span>
-                        <span className="text-xs text-text-muted">
-                            Someone who signs in without a mailbox can create one, using their username on one of this
-                            server&rsquo;s verified domains.
-                        </span>
-                    </span>
-                </label>
-                <ResetToDefault
-                    label={defaults?.autoProvisionEnabled ? "on" : "off"}
-                    shown={!!defaults && autoProvisionEnabled !== defaults.autoProvisionEnabled}
-                    onClick={() => setAutoProvisionEnabled(defaults!.autoProvisionEnabled)}
-                />
-                {autoProvisionEnabled && (
-                    <>
-                        <label className="flex flex-col gap-1.5 text-sm">
-                            <span className="font-semibold">Quota for self-created mailboxes (GB)</span>
-                            <input
-                                aria-label="Quota for self-created mailboxes (GB)"
-                                type="number"
-                                min={0}
-                                step="any"
-                                className={INPUT_CLASS}
-                                value={autoProvisionQuotaGb}
-                                onChange={(e) => setAutoProvisionQuotaGb(e.target.value)}
-                            />
-                        </label>
-                        <ResetToDefault
-                            label={defaults ? `${toGb(defaults.autoProvisionQuotaBytes)} GB` : ""}
-                            shown={!!defaults && differsFromBytes(autoProvisionQuotaGb, defaults.autoProvisionQuotaBytes)}
-                            onClick={() => setAutoProvisionQuotaGb(toGb(defaults!.autoProvisionQuotaBytes))}
-                        />
-                    </>
-                )}
-                <div>
-                    <Button type="submit" loading={saving} disabled={saving} className="!w-auto">
-                        Save
-                    </Button>
-                </div>
-            </form>
-        </div>
-    );
-}
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import React, { FormEvent, useEffect, useState } from "react";
+import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
+import { MailboxPolicy, updateMailboxPolicy } from "@rapidmx/react-shared/admin/mailboxPolicyApi.js";
+import Alert from "@rapidmx/react-shared/components/feedback/Alert.js";
+import Button from "@rapidmx/react-shared/components/buttons/Button.js";
+
+const INPUT_CLASS =
+    "w-full text-sm py-2 px-3 border border-border rounded-sm bg-surface text-text focus:outline-none focus:border-primary";
+
+const GB = 1_000_000_000;
+
+/** Unrounded, so a quota that isn't a whole number of hundredths of a GB (say 4 MB) is shown as it is. */
+function toGb(bytes: number): string {
+    return String(bytes / GB);
+}
+
+/** Whether a quota field's text is not the given number of bytes. */
+function differsFromBytes(text: string, bytes: number): boolean {
+    return Math.round(Number(text) * GB) !== bytes;
+}
+
+/** Puts a field back to the server's config value; nothing is saved until the form is. */
+function ResetToDefault({ label, shown, onClick }: { label: string; shown: boolean; onClick: () => void }) {
+    if (!shown) {
+        return null;
+    }
+    return (
+        <Button type="button" variant="text" className="!w-auto self-start text-xs -mt-2" onClick={onClick}>
+            Reset to server default ({label})
+        </Button>
+    );
+}
+
+/** The form's values as they were loaded or last saved. */
+interface Baseline {
+    defaultQuotaGb: string;
+    autoProvisionEnabled: boolean;
+    autoProvisionQuotaGb: string;
+}
+
+export interface MailboxPolicyFormProps {
+    policy: MailboxPolicy;
+    onChange: (policy: MailboxPolicy) => void;
+    /** Told whether the form has edits that haven't been saved. */
+    onDirtyChange?: (dirty: boolean) => void;
+    /** Set when shown as one section of a page with its own heading (the setup wizard), so the title is a smaller,
+     * lower-level heading. */
+    embedded?: boolean;
+}
+
+/**
+ * The mailbox defaults editor, shared by the Mailbox Policy page and the setup wizard. Each field can be reset to what
+ * the server's config currently says (`policy.defaults`), which lets an administrator take a newly deployed value
+ * without typing it in; the reset fills the field in and is saved with the rest of the form.
+ */
+export default function MailboxPolicyForm({ policy, onChange, onDirtyChange, embedded = false }: MailboxPolicyFormProps) {
+    const defaults = policy.defaults;
+    const [defaultQuotaGb, setDefaultQuotaGb] = useState(toGb(policy.defaultQuotaBytes));
+    const [autoProvisionEnabled, setAutoProvisionEnabled] = useState(policy.autoProvisionEnabled);
+    const [autoProvisionQuotaGb, setAutoProvisionQuotaGb] = useState(toGb(policy.autoProvisionQuotaBytes));
+    const [error, setError] = useState<string | null>(null);
+    const [saving, setSaving] = useState(false);
+    const [saved, setSaved] = useState(false);
+
+    // Edits are unsaved until they match what was loaded or last saved.
+    const [baseline, setBaseline] = useState<Baseline>({ defaultQuotaGb, autoProvisionEnabled, autoProvisionQuotaGb });
+    const dirty: boolean =
+        defaultQuotaGb !== baseline.defaultQuotaGb ||
+        autoProvisionEnabled !== baseline.autoProvisionEnabled ||
+        autoProvisionQuotaGb !== baseline.autoProvisionQuotaGb;
+    useEffect(() => onDirtyChange?.(dirty), [dirty]);
+
+    async function handleSubmit(e: FormEvent) {
+        e.preventDefault();
+        setError(null);
+        setSaved(false);
+        // Only fields the administrator changed are sent, so a quota left alone keeps its exact stored bytes.
+        const patch: Partial<MailboxPolicy> = {};
+        for (const [field, text, base] of [
+            ["defaultQuotaBytes", defaultQuotaGb, baseline.defaultQuotaGb],
+            ["autoProvisionQuotaBytes", autoProvisionQuotaGb, baseline.autoProvisionQuotaGb],
+        ] as const) {
+            if (text === base) {
+                continue;
+            }
+            const bytes: number = Math.round(Number(text) * GB);
+            if (!(bytes >= 1)) {
+                setError("Quotas must be more than 0 GB.");
+                return;
+            }
+            patch[field] = bytes;
+        }
+        if (autoProvisionEnabled !== baseline.autoProvisionEnabled) {
+            patch.autoProvisionEnabled = autoProvisionEnabled;
+        }
+        const current: Baseline = { defaultQuotaGb, autoProvisionEnabled, autoProvisionQuotaGb };
+        if (Object.keys(patch).length === 0) {
+            setSaved(true);
+            return;
+        }
+        setSaving(true);
+        try {
+            const updated = await updateMailboxPolicy(patch);
+            onChange(updated);
+            setBaseline(current);
+            setSaved(true);
+        } catch (err) {
+            setError(err instanceof ApiRequestError ? err.message : "Could not save the mailbox policy.");
+        } finally {
+            setSaving(false);
+        }
+    }
+
+    return (
+        <div className="max-w-xl">
+            {embedded ? (
+                <h3 className="text-base font-bold uppercase tracking-wide mb-1">Mailboxes</h3>
+            ) : (
+                <h2 className="text-lg font-bold uppercase tracking-wide mb-1">Mailboxes</h2>
+            )}
+            <p className="text-sm text-text-muted mb-5">Defaults for new mailboxes on this server.</p>
+
+            {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-4">
+                <label className="flex flex-col gap-1.5 text-sm">
+                    <span className="font-semibold">Default quota (GB)</span>
+                    <input
+                        aria-label="Default quota (GB)"
+                        type="number"
+                        min={0}
+                        step="any"
+                        className={INPUT_CLASS}
+                        value={defaultQuotaGb}
+                        onChange={(e) => setDefaultQuotaGb(e.target.value)}
+                    />
+                    <span className="text-xs text-text-muted">The storage a mailbox starts with when an administrator creates it.</span>
+                </label>
+                <ResetToDefault
+                    label={defaults ? `${toGb(defaults.defaultQuotaBytes)} GB` : ""}
+                    shown={!!defaults && differsFromBytes(defaultQuotaGb, defaults.defaultQuotaBytes)}
+                    onClick={() => setDefaultQuotaGb(toGb(defaults!.defaultQuotaBytes))}
+                />
+                <label className="flex items-start gap-2 text-sm">
+                    <input
+                        type="checkbox"
+                        className="mt-1"
+                        checked={autoProvisionEnabled}
+                        onChange={(e) => setAutoProvisionEnabled(e.target.checked)}
+                    />
+                    <span>
+                        <span className="font-semibold block">Let people create their own mailbox</span>
+                        <span className="text-xs text-text-muted">
+                            Someone who signs in without a mailbox can create one, using their username on one of this
+                            server&rsquo;s verified domains.
+                        </span>
+                    </span>
+                </label>
+                <ResetToDefault
+                    label={defaults?.autoProvisionEnabled ? "on" : "off"}
+                    shown={!!defaults && autoProvisionEnabled !== defaults.autoProvisionEnabled}
+                    onClick={() => setAutoProvisionEnabled(defaults!.autoProvisionEnabled)}
+                />
+                {autoProvisionEnabled && (
+                    <>
+                        <label className="flex flex-col gap-1.5 text-sm">
+                            <span className="font-semibold">Quota for self-created mailboxes (GB)</span>
+                            <input
+                                aria-label="Quota for self-created mailboxes (GB)"
+                                type="number"
+                                min={0}
+                                step="any"
+                                className={INPUT_CLASS}
+                                value={autoProvisionQuotaGb}
+                                onChange={(e) => setAutoProvisionQuotaGb(e.target.value)}
+                            />
+                        </label>
+                        <ResetToDefault
+                            label={defaults ? `${toGb(defaults.autoProvisionQuotaBytes)} GB` : ""}
+                            shown={!!defaults && differsFromBytes(autoProvisionQuotaGb, defaults.autoProvisionQuotaBytes)}
+                            onClick={() => setAutoProvisionQuotaGb(toGb(defaults!.autoProvisionQuotaBytes))}
+                        />
+                    </>
+                )}
+                <div>
+                    <Button type="submit" loading={saving} disabled={saving} className="!w-auto">
+                        Save
+                    </Button>
+                </div>
+            </form>
+        </div>
+    );
+}

package/apps/shared/components/admin/settings/PluginsManager.tsx

@@ -268,8 +268,9 @@ export default function PluginsManager({ embedded = false }: PluginsManagerProps
         void refreshUpdates();
     }
 
-    /** Runs an action on an installed plugin's row, which is busy meanwhile, and shows why it failed. */
-    async function onRow(plugin: Plugin, action: () => Promise<string | null>) {
+    /** Runs an action on a plugin's row (an installed plugin's, or an uninstalled one's), which is busy meanwhile, and
+     * shows why it failed. */
+    async function onRow(plugin: { uid: string }, action: () => Promise<string | null>) {
         setBusy(plugin.uid, true);
         setError(null);
         setRetryEnableUid(null);
@@ -383,6 +384,20 @@ export default function PluginsManager({ embedded = false }: PluginsManagerProps
         return onRow(plugin, () => changeVersion(plugin, packageVersion));
     }
 
+    /** Installs an uninstalled plugin again, at its latest version - as adding it by name would. */
+    function reinstall(purge: PluginPurgeInfo) {
+        const displayName: string = purgeName(purge);
+        return onRow(purge, async () => {
+            let latest: string;
+            try {
+                latest = (await planPluginChange(purge.name)).plugin.version;
+            } catch (err) {
+                return errorMessage(err, `Could not install ${displayName}.`);
+            }
+            return install(purge.name, latest, displayName);
+        });
+    }
+
     /** Runs the steps of a failed data deletion that failed, again. */
     async function retryPurge(purge: PluginPurgeInfo) {
         setBusy(purge.uid, true);
@@ -564,7 +579,13 @@ export default function PluginsManager({ embedded = false }: PluginsManagerProps
                                 );
                             })}
                             {purges.map((purge) => (
-                                <UninstalledPluginRow key={purge.uid} purge={purge} busy={busyUids.has(purge.uid)} onRetry={() => void retryPurge(purge)} />
+                                <UninstalledPluginRow
+                                    key={purge.uid}
+                                    purge={purge}
+                                    busy={busyUids.has(purge.uid)}
+                                    onRetry={() => void retryPurge(purge)}
+                                    onInstall={() => void reinstall(purge)}
+                                />
                             ))}
                         </tbody>
                     </table>
@@ -899,7 +920,7 @@ function PluginServers({ plugin, status }: { plugin: Plugin; status: PluginStatu
 }
 
 /** The row of a plugin that was uninstalled but whose data deletion is still listed: what became of its data. */
-function UninstalledPluginRow({ purge, busy, onRetry }: { purge: PluginPurgeInfo; busy: boolean; onRetry: () => void }) {
+function UninstalledPluginRow({ purge, busy, onRetry, onInstall }: { purge: PluginPurgeInfo; busy: boolean; onRetry: () => void; onInstall: () => void }) {
     const failedSteps = purge.steps.filter((step) => !step.ok);
     return (
         <tr role="row" className={INSTALLED_ROW_CLASS}>
@@ -940,8 +961,8 @@ function UninstalledPluginRow({ purge, busy, onRetry }: { purge: PluginPurgeInfo
                 </div>
             </td>
             <td role="cell" className={`${INSTALLED_TD_CLASS} basis-full pt-1 pb-3`}>
-                {purge.state === "failed" && (
-                    <div className="flex lg:justify-end">
+                <div className="flex gap-2 lg:justify-end">
+                    {purge.state === "failed" && (
                         <Button
                             type="button"
                             variant="secondary"
@@ -953,8 +974,20 @@ function UninstalledPluginRow({ purge, busy, onRetry }: { purge: PluginPurgeInfo
                         >
                             Retry
                         </Button>
-                    </div>
-                )}
+                    )}
+                    {/* A plugin can always be installed again. Adding it before its data is deleted cancels the deletion;
+                        while the deletion is running the server asks to wait until it has finished. */}
+                    <Button
+                        type="button"
+                        variant="secondary"
+                        className="!w-auto"
+                        aria-label={`Install ${purgeName(purge)}`}
+                        disabled={busy || purge.state === "running"}
+                        onClick={onInstall}
+                    >
+                        Install
+                    </Button>
+                </div>
             </td>
         </tr>
     );
@@ -1266,12 +1299,32 @@ function needsSelection(definition: PluginSettingDefinition, saved: PluginSettin
     );
 }
 
+/** What a plugin's setting default writes for the host this console was reached at, like `https://<host>/meet`. */
+const HOST_PLACEHOLDER = "<host>";
+
+/**
+ * The value offered for a text setting whose default names the host (`https://<host>/meet`) and that has no real value
+ * saved yet - nothing, an empty value, or the placeholder itself, which an older server stores when it installs the
+ * plugin. It's the default with this console's host filled in, and is only stored once the form is saved.
+ */
+function suggestedHost(definition: PluginSettingDefinition, saved: PluginSettingValue | undefined): string | undefined {
+    if (typeof definition.default !== "string" || !definition.default.includes(HOST_PLACEHOLDER) || typeof window === "undefined") {
+        return undefined;
+    }
+    const unset: boolean = saved === undefined || saved === "" || (typeof saved === "string" && saved.includes(HOST_PLACEHOLDER));
+    return unset ? definition.default.split(HOST_PLACEHOLDER).join(window.location.host) : undefined;
+}
+
 /** A setting's current form value: its saved value, else its default - or, for a required select with neither, its
  * first option. Kept as a string for text inputs. */
 function initialValue(definition: PluginSettingDefinition, saved: PluginSettingValue | undefined): PluginSettingValue | "" {
     if (needsSelection(definition, saved)) {
         return definition.options![0].value;
     }
+    const suggestion = suggestedHost(definition, saved);
+    if (suggestion !== undefined) {
+        return suggestion;
+    }
     const value = saved ?? definition.default;
     if (definition.type === "boolean") {
         return value === true;
@@ -1291,13 +1344,14 @@ function SettingsModal({ plugin, onClose, onSaved }: { plugin: Plugin; onClose:
         e.preventDefault();
         // The server replaces the whole settings object, so every setting is sent. One left alone is sent as it's saved
         // - `null` when nothing is, so it keeps following the plugin's default rather than pinning the default shown.
-        // A required select with nothing to fall back on is sent as the form picked it.
+        // A required select with nothing to fall back on, and a setting offering this console's host, are sent as the
+        // form shows them.
         const settings: Record<string, PluginSettingValue | null> = {};
         let changed = false;
         for (const definition of definitions) {
             const key: string = definition.key;
             const value = values[key];
-            if (value === initial.current[key] && !needsSelection(definition, plugin.settings[key])) {
+            if (value === initial.current[key] && !needsSelection(definition, plugin.settings[key]) && suggestedHost(definition, plugin.settings[key]) === undefined) {
                 settings[key] = plugin.settings[key] ?? null;
                 continue;
             }