Follows the design and guard commits before it. Written by Sonnet,
reviewed by Opus.
The report address
- Baseline: users.dmarc_default_mode, users.dmarc_default_address and
domains.dmarc_rua_user_id are gone. domains.dmarc_rua alone says
where reports go: '' is no reports (a new domain), the address
SelfPost derives for the domain is the hosted choice (while hosted
reports are on), anything else is a typed address.
- Removed: the user default and its store functions, a domain
following a user, keep / inherit, followCreator, POST /account/dmarc
with its handler, the DMARC box of Account, the user-delete item
about domains losing their address.
- Domain settings offers the three choices; beside the typed address a
"Use my e-mail" button fills in the profile e-mail (panel.js: one
generic data-fill hook; absent without a profile e-mail; it fills,
it does not save).
- The DMARC record's note names the address and no user. This closes
L4 of the security review.
- Domain export / import carries the address as a plain string.
- The ingest allow-list is the generic mailbox plus each domain's
address on this host; the generic mailbox is always open now.
- dev/migrate1x (not in the tree): a 1.x domain that inherited the
instance default gets that address as its own, so no published rua=
changes.
Row actions
- row_action partial (RowAction: Label, Post, Confirm, Danger);
panel.css has the mockup's three rules. A row of the Applications
table is Edit, New password, Delete; the confirmation texts are the
ones the application page's head uses. Both roles, with the checks
of the application page.
Tests cover: a new domain has no reports; each choice saved and shown
selected; hosted refused when hosted reports are off; a bad address
refused with what was typed kept; an untouched save changes nothing in
each state; the fill button with and without a profile e-mail; deleting
a user leaves every domain's address; the row's forms, targets and
confirmations for both roles and a 404 for a stranger.
Known: if hosted reports are switched off later, a stored hosted address
reads as a typed one. docs/guide.md still describes the old choices -
the documentation step.
Evidence
- docs/assets/panel-redesign/evidence/account.png,
out-domain-settings.png, out-domain.png, user-delete.png, help.png:
1440 px wide, headless Edge, real templates served locally with
their fixtures - NOT from the container.
- panel/audit.js on out-domain, out-domain-settings, account, help,
components and user-delete at 1440 and 1280: 1420 texts checked,
problems: [].
- In a browser: the fill button sets the field and does not submit;
the row buttons have the font, size and colour of the Edit link,
Delete the red of the other delete links; data-confirm fires on
both. Hover and focus states were not observed.
- go test -count=1 ./internal/web/... ./internal/store/...
./internal/dmarc/... ./internal/app/... ./internal/inbound/...
./cmd/panel: ok (ten packages; dev/migrate1x also ok).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
261 lines
8.9 KiB
JavaScript
261 lines
8.9 KiB
JavaScript
// Panel progressive enhancement. Everything here is optional convenience: the
|
|
// pages are fully usable with JavaScript disabled or blocked, and nothing is
|
|
// sent to the server from this file.
|
|
(function () {
|
|
"use strict";
|
|
|
|
// --- Copy buttons ---------------------------------------------------
|
|
// copy_field joins a read-only input or textarea to a Copy button marked
|
|
// data-copy; the two sit together in one .has-addons field, and the value is
|
|
// read from the field itself, so it can never drift from what is shown. Where
|
|
// the clipboard API is absent (plain HTTP outside localhost) the value is
|
|
// selected instead, ready for the operator's own Ctrl+C. The button's icon
|
|
// stays; only its word changes for a moment.
|
|
document.addEventListener("click", function (ev) {
|
|
var button = ev.target.closest("button[data-copy]");
|
|
if (!button) {
|
|
return;
|
|
}
|
|
var group = button.closest(".has-addons");
|
|
var field = group && group.querySelector("input, textarea");
|
|
if (!field) {
|
|
return;
|
|
}
|
|
if (!navigator.clipboard) {
|
|
field.focus();
|
|
field.select();
|
|
return;
|
|
}
|
|
navigator.clipboard.writeText(field.value).then(function () {
|
|
var label = button.lastChild;
|
|
if (!label || label.nodeType !== Node.TEXT_NODE) {
|
|
return;
|
|
}
|
|
var original = label.nodeValue;
|
|
label.nodeValue = "Copied";
|
|
setTimeout(function () {
|
|
label.nodeValue = original;
|
|
}, 1500);
|
|
}, function () {
|
|
field.focus();
|
|
field.select();
|
|
});
|
|
});
|
|
|
|
// --- Fill buttons -----------------------------------------------------
|
|
// A type="button" with data-fill="<id of an input>" and data-fill-value="<text>"
|
|
// puts the text in that input and tells the page it changed. It only fills:
|
|
// saving stays the form's own button. Without scripts the button does nothing
|
|
// and the field can be typed in.
|
|
document.addEventListener("click", function (ev) {
|
|
var button = ev.target.closest("button[data-fill]");
|
|
if (!button) {
|
|
return;
|
|
}
|
|
var input = document.getElementById(button.dataset.fill);
|
|
if (!input) {
|
|
return;
|
|
}
|
|
input.value = button.dataset.fillValue || "";
|
|
input.dispatchEvent(new Event("input", { bubbles: true }));
|
|
input.dispatchEvent(new Event("change", { bubbles: true }));
|
|
input.focus();
|
|
});
|
|
|
|
// --- Confirmation on destructive forms --------------------------------
|
|
// Forms that delete something or invalidate a working credential carry a
|
|
// data-confirm message. The prompt lives here rather than in an inline
|
|
// onsubmit attribute because the panel's Content-Security-Policy allows no
|
|
// inline script. The listener is delegated from the document,
|
|
// so it also covers markup swapped in by HTMX. With JavaScript disabled the
|
|
// form submits without asking — exactly as the inline handler behaved.
|
|
document.addEventListener("submit", function (ev) {
|
|
var form = ev.target.closest("form[data-confirm]");
|
|
if (form && !window.confirm(form.dataset.confirm)) {
|
|
ev.preventDefault();
|
|
}
|
|
});
|
|
|
|
// --- Conditional field visibility ------------------------------------
|
|
// Several forms hide a block until a select, checkbox or file input says it
|
|
// applies. One rule table drives them all so the five near-identical helpers
|
|
// do not drift.
|
|
var showWhenRules = [
|
|
{
|
|
match: "select[data-list-mode]",
|
|
target: "[data-addresses]",
|
|
visible: function (el) { return el.value === el.dataset.listMode; }
|
|
},
|
|
{
|
|
match: "select[data-custom-mode]",
|
|
target: "[data-custom-address]",
|
|
visible: function (el) { return el.value === el.dataset.customMode; }
|
|
},
|
|
{
|
|
match: "select[data-ratelimit-mode]",
|
|
target: "[data-manual-fields]",
|
|
visible: function (el) { return el.value === "manual"; }
|
|
},
|
|
{
|
|
match: "select[data-ratelimit-mode]",
|
|
target: "[data-auto-fields]",
|
|
visible: function (el) { return el.value === "auto"; }
|
|
},
|
|
{
|
|
match: "select[data-global-role]",
|
|
target: "[data-domain-pick]",
|
|
visible: function (el) { return el.value !== el.dataset.globalRole; }
|
|
},
|
|
{
|
|
match: "input[data-encrypt-toggle]",
|
|
target: "[data-encrypt-fields]",
|
|
visible: function (el) { return el.checked; },
|
|
clearWhenHidden: true
|
|
},
|
|
{
|
|
match: "input[data-import-file]",
|
|
target: "[data-import-password-fields]",
|
|
visible: function (el) {
|
|
var name = (el.files && el.files[0] && el.files[0].name || "").toLowerCase();
|
|
return name !== "" && !/\.json$/.test(name);
|
|
},
|
|
clearWhenHidden: true
|
|
}
|
|
];
|
|
|
|
function syncShowWhen(control) {
|
|
var form = control.closest("form");
|
|
if (!form) {
|
|
return;
|
|
}
|
|
// A control can drive more than one block (the rate-limit select shows the
|
|
// manual fields or the auto ones), so every rule that matches is applied.
|
|
for (var i = 0; i < showWhenRules.length; i++) {
|
|
var rule = showWhenRules[i];
|
|
if (!control.matches(rule.match)) {
|
|
continue;
|
|
}
|
|
// A block can be several elements (the user form's two lists of domains).
|
|
var show = rule.visible(control);
|
|
form.querySelectorAll(rule.target).forEach(function (target) {
|
|
// hidden alone does not hide an element whose own stylesheet gives it a
|
|
// display (Bulma's .box), so Bulma's is-hidden helper goes with it.
|
|
target.hidden = !show;
|
|
target.classList.toggle("is-hidden", !show);
|
|
if (!show && rule.clearWhenHidden) {
|
|
target.querySelectorAll("input").forEach(function (input) {
|
|
input.value = "";
|
|
});
|
|
}
|
|
});
|
|
}
|
|
}
|
|
|
|
function initShowWhen(root) {
|
|
showWhenRules.forEach(function (rule) {
|
|
root.querySelectorAll(rule.match).forEach(function (control) {
|
|
syncShowWhen(control);
|
|
control.addEventListener("change", function () {
|
|
syncShowWhen(control);
|
|
});
|
|
});
|
|
});
|
|
}
|
|
|
|
document.addEventListener("DOMContentLoaded", function () {
|
|
initShowWhen(document);
|
|
});
|
|
|
|
// --- Adaptive monitoring polling ---------------------------------------
|
|
// The four monitoring fragments carry data-poll and hx-trigger="load" for
|
|
// the first fetch only. panel.js schedules the rest: 5 s while the operator
|
|
// is active on the page, 30 s when the tab is visible but idle, and nothing
|
|
// while the tab is hidden. hx-trigger="every Ns [expr]" could express some
|
|
// of that, but the filter is evaluated with `new Function`, which the
|
|
// panel's CSP (default-src 'self', no 'unsafe-eval') would silently break.
|
|
var pollActiveMs = 5000;
|
|
var pollIdleMs = 30000;
|
|
// No pointer/keyboard/scroll input for this long → treat the tab as idle.
|
|
var userIdleMs = 30000;
|
|
var lastActivity = Date.now();
|
|
var pollTimers = Object.create(null);
|
|
|
|
["mousedown", "mousemove", "keydown", "scroll", "touchstart"].forEach(function (evt) {
|
|
document.addEventListener(evt, function () {
|
|
lastActivity = Date.now();
|
|
}, { passive: true });
|
|
});
|
|
|
|
function pollDelayMs() {
|
|
return Date.now() - lastActivity < userIdleMs ? pollActiveMs : pollIdleMs;
|
|
}
|
|
|
|
function triggerPoll(el) {
|
|
htmx.ajax("GET", el.getAttribute("hx-get"), {
|
|
target: "#" + el.id,
|
|
swap: el.getAttribute("hx-swap") || "outerHTML"
|
|
});
|
|
}
|
|
|
|
function schedulePoll(el) {
|
|
if (!el || !el.id || !el.hasAttribute("data-poll")) {
|
|
return;
|
|
}
|
|
if (pollTimers[el.id]) {
|
|
clearTimeout(pollTimers[el.id]);
|
|
delete pollTimers[el.id];
|
|
}
|
|
if (document.hidden) {
|
|
return;
|
|
}
|
|
var id = el.id;
|
|
pollTimers[id] = setTimeout(function () {
|
|
delete pollTimers[id];
|
|
var current = document.getElementById(id);
|
|
if (!current || !current.hasAttribute("data-poll")) {
|
|
return;
|
|
}
|
|
if (document.hidden) {
|
|
schedulePoll(current);
|
|
return;
|
|
}
|
|
triggerPoll(current);
|
|
}, pollDelayMs());
|
|
}
|
|
|
|
function onPollElementReady(el) {
|
|
if (!el || !el.hasAttribute("data-poll")) {
|
|
return;
|
|
}
|
|
// Swapped-in markup still carries hx-trigger="load"; strip it so htmx does
|
|
// not issue a duplicate GET on top of the response we just received.
|
|
el.removeAttribute("hx-trigger");
|
|
schedulePoll(el);
|
|
}
|
|
|
|
document.body.addEventListener("htmx:afterSwap", function (ev) {
|
|
onPollElementReady(ev.detail.elt);
|
|
});
|
|
|
|
document.body.addEventListener("htmx:responseError", function (ev) {
|
|
onPollElementReady(ev.detail.elt);
|
|
});
|
|
|
|
document.body.addEventListener("htmx:beforeRequest", function (ev) {
|
|
if (document.hidden && ev.target.hasAttribute && ev.target.hasAttribute("data-poll")) {
|
|
ev.preventDefault();
|
|
}
|
|
});
|
|
|
|
document.addEventListener("visibilitychange", function () {
|
|
if (document.hidden) {
|
|
Object.keys(pollTimers).forEach(function (id) {
|
|
clearTimeout(pollTimers[id]);
|
|
delete pollTimers[id];
|
|
});
|
|
return;
|
|
}
|
|
document.querySelectorAll("[data-poll]").forEach(schedulePoll);
|
|
});
|
|
})();
|