Bring in pipeline, auth, deploy and docs from the boilerplate
roledesk is built on the boilerplate from here on: pipeline 2.0 (queue and scheduler), auth (one password, sessions, passkeys), the deploy kit and its docs, plus the coupling and packaging tests. Downstream copies, unedited. Refreshed from boilerplate/d56949f7d0f6c0bfe5745478e09007bfad67ae87 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
1f436104f3
commit
9d666d0937
76 files changed
+15235
No files matched your search
@@ -0,0 +1,280 @@
|
||||
/* The queue, on screen, for an app that has not written a UI yet.
|
||||
*
|
||||
* <script type="module" src="/_jobs/jobs.js"></script>
|
||||
* <desk-jobs></desk-jobs>
|
||||
*
|
||||
* That is the whole of it. The element finds `/ws/jobs` itself, shows what is
|
||||
* running with a progress bar and a Kill button each, says how many are
|
||||
* waiting, and reconnects when the server restarts under you.
|
||||
*
|
||||
* One file, and the styles are in it rather than beside it, because the
|
||||
* shadow root scopes them anyway and a second file is a second route, a
|
||||
* second cache header and a second thing to forget to copy. Themed from
|
||||
* outside through the custom properties at the top of `CSS` — set them on
|
||||
* `desk-jobs` or on `:root` and nothing here has to be forked.
|
||||
*
|
||||
* What it deliberately does not do is talk about failures. It raises a
|
||||
* `desk-jobs:notice` event and leaves the wording to the app, because a
|
||||
* useful sentence names things only the app knows — its backends, its feeds,
|
||||
* its config keys. `pipeline/notices.py` is the same split on the server.
|
||||
*
|
||||
* Attributes, all optional:
|
||||
* base="/api" prefix for the HTTP calls, if the router is mounted deeper
|
||||
* socket="..." the socket's URL, if it is not `/ws/jobs` on this origin
|
||||
* probe="/api/status"
|
||||
* an authenticated endpoint to try when the socket closes. A
|
||||
* refused handshake and a dead server look identical from
|
||||
* here — the server rejects an unauthenticated upgrade before
|
||||
* completing it, so the browser reports the same abnormal
|
||||
* close for "your session expired" as for "the server is
|
||||
* gone". One cheap request tells them apart. Without this the
|
||||
* element assumes the server went away, which is the more
|
||||
* common reason and the less confusing thing to be wrong about.
|
||||
* idle="hide" with nothing running or queued, take up no space. The
|
||||
* default, since a chip that is always there is furniture.
|
||||
*/
|
||||
|
||||
const CSS = `
|
||||
:host {
|
||||
--desk-jobs-bg: #16181d;
|
||||
--desk-jobs-fg: #e7e9ee;
|
||||
--desk-jobs-dim: #9aa1ad;
|
||||
--desk-jobs-accent: #4c8dff;
|
||||
--desk-jobs-error: #ff6b6b;
|
||||
--desk-jobs-radius: 10px;
|
||||
--desk-jobs-font: system-ui, -apple-system, "Segoe UI", sans-serif;
|
||||
--desk-jobs-gap: 8px;
|
||||
|
||||
display: block;
|
||||
font-family: var(--desk-jobs-font);
|
||||
font-size: 13px;
|
||||
color: var(--desk-jobs-fg);
|
||||
}
|
||||
:host([hidden]) { display: none; }
|
||||
|
||||
.strip {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: var(--desk-jobs-gap);
|
||||
background: var(--desk-jobs-bg);
|
||||
border-radius: var(--desk-jobs-radius);
|
||||
padding: 10px 12px;
|
||||
}
|
||||
.job { display: grid; grid-template-columns: 1fr auto; gap: 2px 10px; align-items: center; }
|
||||
.what { font-weight: 600; }
|
||||
.said { color: var(--desk-jobs-dim); grid-column: 1; }
|
||||
.count { color: var(--desk-jobs-dim); font-variant-numeric: tabular-nums; }
|
||||
|
||||
/* A bar only when there is a fraction to draw. A handler that reports no
|
||||
* total is working on one thing, and an empty trough reads as stalled. */
|
||||
.bar {
|
||||
grid-column: 1 / -1;
|
||||
height: 3px;
|
||||
border-radius: 2px;
|
||||
background: color-mix(in srgb, var(--desk-jobs-fg) 15%, transparent);
|
||||
overflow: hidden;
|
||||
}
|
||||
.bar > i { display: block; height: 100%; background: var(--desk-jobs-accent); transition: width .2s; }
|
||||
|
||||
button {
|
||||
font: inherit;
|
||||
color: var(--desk-jobs-dim);
|
||||
background: none;
|
||||
border: 1px solid currentColor;
|
||||
border-radius: 6px;
|
||||
padding: 1px 8px;
|
||||
cursor: pointer;
|
||||
}
|
||||
button:hover { color: var(--desk-jobs-error); }
|
||||
button[disabled] { opacity: .4; cursor: default; }
|
||||
|
||||
.offline { color: var(--desk-jobs-error); }
|
||||
`;
|
||||
|
||||
/** Backing off rather than hammering. The usual reason a socket closed is the
|
||||
* server restarting under --reload, which comes back inside a second; the
|
||||
* ceiling is for when it is not coming back at all. */
|
||||
const FIRST_WAIT = 500;
|
||||
const LONGEST_WAIT = 30000;
|
||||
|
||||
/** How long down is long enough to say so. A reload blinks the socket every
|
||||
* time a file is saved, and a warning that flashes on every save is one you
|
||||
* stop reading — which would cost us the case that matters, where the server
|
||||
* really is gone and the strip is quietly showing state from a minute ago. */
|
||||
const QUIET_ABOUT_IT_FOR = 4000;
|
||||
|
||||
class DeskJobs extends HTMLElement {
|
||||
#root;
|
||||
#socket = null;
|
||||
#wait = FIRST_WAIT;
|
||||
#timer = null;
|
||||
#state = { running: [], queued: [], recent: [] };
|
||||
#offline = false;
|
||||
#killing = new Set();
|
||||
|
||||
constructor() {
|
||||
super();
|
||||
this.#root = this.attachShadow({ mode: "open" });
|
||||
const style = document.createElement("style");
|
||||
style.textContent = CSS;
|
||||
this.#root.append(style, document.createElement("div"));
|
||||
}
|
||||
|
||||
connectedCallback() { this.#connect(); this.#render(); }
|
||||
|
||||
disconnectedCallback() {
|
||||
clearTimeout(this.#timer);
|
||||
this.#socket?.close();
|
||||
this.#socket = null;
|
||||
}
|
||||
|
||||
get #base() { return this.getAttribute("base") ?? ""; }
|
||||
|
||||
get #socketUrl() {
|
||||
const given = this.getAttribute("socket");
|
||||
if (given) return given;
|
||||
const scheme = location.protocol === "https:" ? "wss" : "ws";
|
||||
return `${scheme}://${location.host}${this.#base}/ws/jobs`;
|
||||
}
|
||||
|
||||
#connect() {
|
||||
let socket;
|
||||
try {
|
||||
socket = new WebSocket(this.#socketUrl);
|
||||
} catch {
|
||||
this.#reconnect(); // a malformed URL, or no network
|
||||
return;
|
||||
}
|
||||
this.#socket = socket;
|
||||
|
||||
socket.onopen = () => {
|
||||
this.#wait = FIRST_WAIT;
|
||||
this.#offline = false;
|
||||
this.#render();
|
||||
};
|
||||
socket.onmessage = (event) => {
|
||||
let message;
|
||||
try { message = JSON.parse(event.data); } catch { return; }
|
||||
if (message.type === "jobs") {
|
||||
const { type, ...state } = message;
|
||||
this.#state = state;
|
||||
this.#render();
|
||||
} else if (message.type === "notice") {
|
||||
// The app's to word. Composed, so a listener on `document` hears it
|
||||
// through the shadow boundary.
|
||||
this.dispatchEvent(new CustomEvent("desk-jobs:notice", {
|
||||
detail: message, bubbles: true, composed: true,
|
||||
}));
|
||||
}
|
||||
};
|
||||
socket.onerror = () => socket.close();
|
||||
socket.onclose = async () => {
|
||||
if (this.#socket !== socket) return; // a later connection owns us now
|
||||
this.#socket = null;
|
||||
await this.#whyClosed();
|
||||
this.#reconnect();
|
||||
};
|
||||
}
|
||||
|
||||
/** Ask before assuming. See the `probe` attribute. */
|
||||
async #whyClosed() {
|
||||
const probe = this.getAttribute("probe");
|
||||
if (!probe) return;
|
||||
try {
|
||||
const answer = await fetch(this.#base + probe, { credentials: "same-origin" });
|
||||
if (answer.status === 401 || answer.status === 403) {
|
||||
this.dispatchEvent(new CustomEvent("desk-jobs:signed-out", {
|
||||
bubbles: true, composed: true,
|
||||
}));
|
||||
}
|
||||
} catch { /* offline; the strip says so below */ }
|
||||
}
|
||||
|
||||
#reconnect() {
|
||||
if (this.#wait >= QUIET_ABOUT_IT_FOR) {
|
||||
this.#offline = true;
|
||||
this.#render();
|
||||
}
|
||||
clearTimeout(this.#timer);
|
||||
this.#timer = setTimeout(() => this.#connect(), this.#wait);
|
||||
this.#wait = Math.min(this.#wait * 2, LONGEST_WAIT);
|
||||
}
|
||||
|
||||
async #kill(id) {
|
||||
this.#killing.add(id);
|
||||
this.#render();
|
||||
try {
|
||||
await fetch(`${this.#base}/api/jobs/${id}/cancel`,
|
||||
{ method: "POST", credentials: "same-origin" });
|
||||
} finally {
|
||||
// The socket reports the actual ending — a running job stops at its next
|
||||
// checkpoint, so the button going quiet is the whole of what happens here.
|
||||
this.#killing.delete(id);
|
||||
}
|
||||
}
|
||||
|
||||
#render() {
|
||||
const { running = [], queued = [] } = this.#state;
|
||||
const strip = this.#root.lastElementChild;
|
||||
this.hidden = this.getAttribute("idle") !== "show"
|
||||
&& !running.length && !queued.length && !this.#offline;
|
||||
|
||||
strip.className = "strip";
|
||||
strip.replaceChildren();
|
||||
|
||||
if (this.#offline) {
|
||||
const said = document.createElement("div");
|
||||
said.className = "offline";
|
||||
said.textContent = "Not connected — what you see here may be out of date.";
|
||||
strip.append(said);
|
||||
}
|
||||
|
||||
for (const job of running) {
|
||||
strip.append(this.#row(job));
|
||||
}
|
||||
if (queued.length) {
|
||||
const waiting = document.createElement("div");
|
||||
waiting.className = "count";
|
||||
waiting.textContent = `${queued.length} waiting`;
|
||||
strip.append(waiting);
|
||||
}
|
||||
}
|
||||
|
||||
#row(job) {
|
||||
const row = document.createElement("div");
|
||||
row.className = "job";
|
||||
|
||||
const what = document.createElement("span");
|
||||
what.className = "what";
|
||||
what.textContent = job.label || job.kind;
|
||||
row.append(what);
|
||||
|
||||
const kill = document.createElement("button");
|
||||
kill.textContent = "Kill";
|
||||
kill.disabled = this.#killing.has(job.id) || job.cancel_requested;
|
||||
kill.addEventListener("click", () => this.#kill(job.id));
|
||||
row.append(kill);
|
||||
|
||||
if (job.message) {
|
||||
const said = document.createElement("span");
|
||||
said.className = "said";
|
||||
said.textContent = job.message;
|
||||
row.append(said);
|
||||
}
|
||||
if (job.total > 0) {
|
||||
const bar = document.createElement("div");
|
||||
bar.className = "bar";
|
||||
const fill = document.createElement("i");
|
||||
fill.style.width = `${Math.min(100, (job.done / job.total) * 100)}%`;
|
||||
bar.append(fill);
|
||||
row.append(bar);
|
||||
}
|
||||
return row;
|
||||
}
|
||||
}
|
||||
|
||||
if (!customElements.get("desk-jobs")) {
|
||||
customElements.define("desk-jobs", DeskJobs);
|
||||
}
|
||||
|
||||
export { DeskJobs };
|
||||
@@ -0,0 +1,543 @@
|
||||
/* The schedule table, on screen, for an app that has not written a UI yet.
|
||||
*
|
||||
* <script type="module" src="/_jobs/schedules.js"></script>
|
||||
* <desk-schedules></desk-schedules>
|
||||
*
|
||||
* A row per schedule — name, kind, cadence, on or off, next run, last run and
|
||||
* how that job ended — plus Run now, Delete, and a row at the bottom for
|
||||
* adding one. The kinds come from `/api/jobs/kinds`, so a new `@job` is a new
|
||||
* option here without this file being touched.
|
||||
*
|
||||
* It reads `/ws/jobs` for `schedules` messages, so a row edited in another tab
|
||||
* redraws in this one, and a firing moves the times without anybody polling.
|
||||
* The socket's opening message is the *job* list, though, so the table is
|
||||
* fetched once on connect: the push says what changed, not what there is. The
|
||||
* job list is read as it goes past as well, for the last column — a schedule
|
||||
* is pushed when it fires, which is before its job has ended, so the state it
|
||||
* ended in can only come from there.
|
||||
*
|
||||
* The same one-file, shadow-root, custom-property shape as `<desk-jobs>`, and
|
||||
* deliberately the same `--desk-jobs-*` names: an app that themed one element
|
||||
* has themed both, and two schemes for two halves of one page is the thing
|
||||
* nobody wants to maintain.
|
||||
*
|
||||
* Failures are not worded here. A refused change raises `desk-schedules:error`
|
||||
* carrying the server's own `detail` — which the endpoints promise is one
|
||||
* readable sentence — and the app toasts it. Notices arriving on the socket
|
||||
* are re-raised as `desk-jobs:notice`, the same event `<desk-jobs>` raises, so
|
||||
* an app that listens for one is listening for both.
|
||||
*
|
||||
* Attributes, all optional:
|
||||
* base="/api" prefix for the HTTP calls, if the router is mounted deeper
|
||||
* socket="..." the socket's URL, if it is not `/ws/jobs` on this origin
|
||||
*/
|
||||
|
||||
const CSS = `
|
||||
:host {
|
||||
--desk-jobs-bg: #16181d;
|
||||
--desk-jobs-fg: #e7e9ee;
|
||||
--desk-jobs-dim: #9aa1ad;
|
||||
--desk-jobs-accent: #4c8dff;
|
||||
--desk-jobs-error: #ff6b6b;
|
||||
--desk-jobs-radius: 10px;
|
||||
--desk-jobs-font: system-ui, -apple-system, "Segoe UI", sans-serif;
|
||||
--desk-jobs-gap: 8px;
|
||||
|
||||
display: block;
|
||||
font-family: var(--desk-jobs-font);
|
||||
font-size: 13px;
|
||||
color: var(--desk-jobs-fg);
|
||||
}
|
||||
:host([hidden]) { display: none; }
|
||||
|
||||
.panel {
|
||||
background: var(--desk-jobs-bg);
|
||||
border-radius: var(--desk-jobs-radius);
|
||||
padding: 10px 12px;
|
||||
}
|
||||
|
||||
table { width: 100%; border-collapse: collapse; }
|
||||
th, td {
|
||||
text-align: left;
|
||||
padding: 6px 8px 6px 0;
|
||||
vertical-align: baseline;
|
||||
border-bottom: 1px solid color-mix(in srgb, var(--desk-jobs-fg) 12%, transparent);
|
||||
}
|
||||
th { color: var(--desk-jobs-dim); font-weight: 600; white-space: nowrap; }
|
||||
tr:last-child > td { border-bottom: 0; }
|
||||
td.actions { text-align: right; white-space: nowrap; }
|
||||
|
||||
.name { font-weight: 600; }
|
||||
.kind, .when { color: var(--desk-jobs-dim); font-variant-numeric: tabular-nums; }
|
||||
.off { opacity: .55; }
|
||||
.bad { color: var(--desk-jobs-error); }
|
||||
|
||||
/* The cadence is edited in place: a box that looks like text until you are in
|
||||
* it, because a table of eight input fields reads as a form to fill in rather
|
||||
* than as a list of what is running. */
|
||||
input.cadence, input.text {
|
||||
font: inherit;
|
||||
color: inherit;
|
||||
background: none;
|
||||
border: 1px solid transparent;
|
||||
border-radius: 6px;
|
||||
padding: 1px 4px;
|
||||
min-width: 9em;
|
||||
}
|
||||
input.cadence:hover { border-color: color-mix(in srgb, var(--desk-jobs-fg) 20%, transparent); }
|
||||
input:focus { outline: none; border-color: var(--desk-jobs-accent); }
|
||||
input::placeholder { color: var(--desk-jobs-dim); }
|
||||
|
||||
select {
|
||||
font: inherit;
|
||||
color: inherit;
|
||||
background: var(--desk-jobs-bg);
|
||||
border: 1px solid color-mix(in srgb, var(--desk-jobs-fg) 20%, transparent);
|
||||
border-radius: 6px;
|
||||
padding: 1px 4px;
|
||||
}
|
||||
|
||||
button {
|
||||
font: inherit;
|
||||
color: var(--desk-jobs-dim);
|
||||
background: none;
|
||||
border: 1px solid currentColor;
|
||||
border-radius: 6px;
|
||||
padding: 1px 8px;
|
||||
margin-left: 6px;
|
||||
cursor: pointer;
|
||||
}
|
||||
button:hover { color: var(--desk-jobs-accent); }
|
||||
button.remove:hover { color: var(--desk-jobs-error); }
|
||||
button[disabled] { opacity: .4; cursor: default; }
|
||||
|
||||
.state { font-size: 11px; padding: 0 5px; border-radius: 999px;
|
||||
border: 1px solid currentColor; margin-left: 6px; }
|
||||
.state.failed, .state.cancelled { color: var(--desk-jobs-error); }
|
||||
.state.running, .state.queued { color: var(--desk-jobs-accent); }
|
||||
|
||||
.empty, .offline { color: var(--desk-jobs-dim); padding: 6px 0; }
|
||||
.offline { color: var(--desk-jobs-error); }
|
||||
`;
|
||||
|
||||
/** The same backoff as `<desk-jobs>`: the usual reason a socket closed is the
|
||||
* server restarting under --reload, which comes back inside a second. */
|
||||
const FIRST_WAIT = 500;
|
||||
const LONGEST_WAIT = 30000;
|
||||
|
||||
/** The grammar, in the one place a person is asked to use it. Two of the five
|
||||
* as the placeholder, because a box wide enough for all five is a box wide
|
||||
* enough to unbalance the row it is in — and all five on hover, which is also
|
||||
* what the server's refusal says if they get it wrong anyway. */
|
||||
const FORMS = "every 15m · every 6h · every 2d · daily at 06:00 · weekly mon 07:00";
|
||||
const HINT = "every 15m · daily at 06:00";
|
||||
|
||||
/** A stamp as a person reads it. Today is a time, anything else is a date and
|
||||
* a time, and "never" is said rather than left blank — an empty cell reads as
|
||||
* a bug, and "never" is a fact. */
|
||||
function when(stamp) {
|
||||
if (!stamp) return "never";
|
||||
const at = new Date(stamp);
|
||||
if (isNaN(at)) return stamp;
|
||||
const today = at.toDateString() === new Date().toDateString();
|
||||
const clock = at.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
|
||||
return today ? clock : `${at.toLocaleDateString()} ${clock}`;
|
||||
}
|
||||
|
||||
class DeskSchedules extends HTMLElement {
|
||||
#root;
|
||||
#socket = null;
|
||||
#wait = FIRST_WAIT;
|
||||
#timer = null;
|
||||
#rows = [];
|
||||
#kinds = [];
|
||||
#offline = false;
|
||||
#busy = new Set();
|
||||
#loaded = false;
|
||||
|
||||
constructor() {
|
||||
super();
|
||||
this.#root = this.attachShadow({ mode: "open" });
|
||||
const style = document.createElement("style");
|
||||
style.textContent = CSS;
|
||||
this.#root.append(style, document.createElement("div"));
|
||||
}
|
||||
|
||||
connectedCallback() {
|
||||
this.#render();
|
||||
this.#load();
|
||||
this.#connect();
|
||||
}
|
||||
|
||||
disconnectedCallback() {
|
||||
clearTimeout(this.#timer);
|
||||
this.#socket?.close();
|
||||
this.#socket = null;
|
||||
}
|
||||
|
||||
get #base() { return this.getAttribute("base") ?? ""; }
|
||||
|
||||
get #socketUrl() {
|
||||
const given = this.getAttribute("socket");
|
||||
if (given) return given;
|
||||
const scheme = location.protocol === "https:" ? "wss" : "ws";
|
||||
return `${scheme}://${location.host}${this.#base}/ws/jobs`;
|
||||
}
|
||||
|
||||
/* -- the server ------------------------------------------------------- */
|
||||
|
||||
/** Every call goes through here, so one place raises the event and one
|
||||
* place knows that a refusal carries `{"detail": "<sentence>"}`. */
|
||||
async #ask(path, options) {
|
||||
const o = Object.assign({ credentials: "same-origin" }, options);
|
||||
if (o.body !== undefined && typeof o.body !== "string") {
|
||||
o.headers = Object.assign({ "Content-Type": "application/json" }, o.headers);
|
||||
o.body = JSON.stringify(o.body);
|
||||
}
|
||||
let answer;
|
||||
try {
|
||||
answer = await fetch(this.#base + path, o);
|
||||
} catch (e) {
|
||||
this.#failed("Could not reach the server.");
|
||||
throw e;
|
||||
}
|
||||
const text = await answer.text();
|
||||
let body = null;
|
||||
if (text) { try { body = JSON.parse(text); } catch (e) { body = null; } }
|
||||
if (!answer.ok) {
|
||||
this.#failed((body && body.detail)
|
||||
|| `The server answered ${answer.status} and said nothing about why.`);
|
||||
throw new Error(String((body && body.detail) || answer.status));
|
||||
}
|
||||
return body;
|
||||
}
|
||||
|
||||
#failed(detail) {
|
||||
// Composed, so a listener on `document` hears it through the shadow
|
||||
// boundary. The wording is the server's; this element has no opinion.
|
||||
this.dispatchEvent(new CustomEvent("desk-schedules:error", {
|
||||
detail: { detail: String(detail) }, bubbles: true, composed: true,
|
||||
}));
|
||||
}
|
||||
|
||||
async #load() {
|
||||
try {
|
||||
const [rows, kinds] = await Promise.all([
|
||||
this.#ask("/api/schedules"),
|
||||
this.#ask("/api/jobs/kinds"),
|
||||
]);
|
||||
this.#rows = rows || [];
|
||||
this.#kinds = kinds || [];
|
||||
} catch (e) {
|
||||
/* already raised */
|
||||
} finally {
|
||||
this.#loaded = true;
|
||||
this.#render();
|
||||
}
|
||||
}
|
||||
|
||||
#connect() {
|
||||
let socket;
|
||||
try {
|
||||
socket = new WebSocket(this.#socketUrl);
|
||||
} catch {
|
||||
this.#reconnect();
|
||||
return;
|
||||
}
|
||||
this.#socket = socket;
|
||||
|
||||
socket.onopen = () => {
|
||||
this.#wait = FIRST_WAIT;
|
||||
if (this.#offline) {
|
||||
// Down and back: what changed while we were away came as nothing, so
|
||||
// the list is read again rather than waited for.
|
||||
this.#offline = false;
|
||||
this.#load();
|
||||
}
|
||||
this.#render();
|
||||
};
|
||||
socket.onmessage = (event) => {
|
||||
let message;
|
||||
try { message = JSON.parse(event.data); } catch { return; }
|
||||
if (message.type === "schedules") {
|
||||
this.#rows = message.schedules || [];
|
||||
this.#render();
|
||||
} else if (message.type === "jobs") {
|
||||
this.#catchUp(message);
|
||||
} else if (message.type === "notice") {
|
||||
this.dispatchEvent(new CustomEvent("desk-jobs:notice", {
|
||||
detail: message, bubbles: true, composed: true,
|
||||
}));
|
||||
}
|
||||
};
|
||||
socket.onerror = () => socket.close();
|
||||
socket.onclose = () => {
|
||||
if (this.#socket !== socket) return; // a later connection owns us
|
||||
this.#socket = null;
|
||||
this.#reconnect();
|
||||
};
|
||||
}
|
||||
|
||||
/* The last column says how the last job ended, and the `schedules` message
|
||||
* is pushed when a schedule *fires* — at which point that job has not ended
|
||||
* and the cell reads `running`. Nothing pushes a schedule again when the
|
||||
* job finishes, so without this the table goes on reporting a job as
|
||||
* running long after it is done, which is the one thing this column is for.
|
||||
*
|
||||
* The job list arrives on this same socket four times a second while
|
||||
* anything is going, and it carries the state of every job worth knowing
|
||||
* about, so the answer is already here: take it off the snapshot rather
|
||||
* than ask the server a second time. A job old enough to have left `recent`
|
||||
* keeps whatever it was last seen as; its schedule has fired since, or it
|
||||
* has been on screen for an hour. */
|
||||
#catchUp(snapshot) {
|
||||
const states = new Map();
|
||||
for (const list of ["running", "queued", "recent"]) {
|
||||
for (const job of snapshot[list] || []) states.set(job.id, job.state);
|
||||
}
|
||||
let moved = false;
|
||||
for (const row of this.#rows) {
|
||||
const state = states.get(row.last_job_id);
|
||||
if (state && state !== row.last_state) {
|
||||
row.last_state = state;
|
||||
moved = true;
|
||||
}
|
||||
}
|
||||
if (moved) this.#render();
|
||||
}
|
||||
|
||||
#reconnect() {
|
||||
if (this.#wait >= 4000) {
|
||||
this.#offline = true;
|
||||
this.#render();
|
||||
}
|
||||
clearTimeout(this.#timer);
|
||||
this.#timer = setTimeout(() => this.#connect(), this.#wait);
|
||||
this.#wait = Math.min(this.#wait * 2, LONGEST_WAIT);
|
||||
}
|
||||
|
||||
/* One wrapper for every change: the row is greyed while the request is in
|
||||
* the air, and the new list arrives on the socket rather than being patched
|
||||
* in here — so what is on screen is always what the server holds. */
|
||||
async #change(id, run) {
|
||||
this.#busy.add(id);
|
||||
this.#render();
|
||||
try {
|
||||
await run();
|
||||
} catch (e) {
|
||||
/* already raised */
|
||||
} finally {
|
||||
this.#busy.delete(id);
|
||||
this.#render();
|
||||
}
|
||||
}
|
||||
|
||||
/* -- drawing ---------------------------------------------------------- */
|
||||
|
||||
#render() {
|
||||
const panel = this.#root.lastElementChild;
|
||||
panel.className = "panel";
|
||||
panel.replaceChildren();
|
||||
|
||||
if (this.#offline) {
|
||||
const said = document.createElement("div");
|
||||
said.className = "offline";
|
||||
said.textContent = "Not connected — what you see here may be out of date.";
|
||||
panel.append(said);
|
||||
}
|
||||
|
||||
const table = document.createElement("table");
|
||||
table.append(this.#head());
|
||||
const body = document.createElement("tbody");
|
||||
for (const row of this.#rows) body.append(this.#row(row));
|
||||
body.append(this.#adder());
|
||||
table.append(body);
|
||||
panel.append(table);
|
||||
|
||||
if (this.#loaded && !this.#rows.length) {
|
||||
const empty = document.createElement("div");
|
||||
empty.className = "empty";
|
||||
empty.textContent = "Nothing is scheduled. Add one below.";
|
||||
panel.insertBefore(empty, table);
|
||||
}
|
||||
}
|
||||
|
||||
#head() {
|
||||
const head = document.createElement("thead");
|
||||
const row = document.createElement("tr");
|
||||
for (const label of ["Name", "Kind", "Cadence", "On", "Next", "Last", ""]) {
|
||||
const cell = document.createElement("th");
|
||||
cell.textContent = label;
|
||||
row.append(cell);
|
||||
}
|
||||
head.append(row);
|
||||
return head;
|
||||
}
|
||||
|
||||
#row(schedule) {
|
||||
const row = document.createElement("tr");
|
||||
const busy = this.#busy.has(schedule.id);
|
||||
if (!schedule.enabled) row.classList.add("off");
|
||||
|
||||
row.append(this.#cell("name", schedule.name));
|
||||
|
||||
const kind = this.#cell("kind", schedule.kind);
|
||||
if (schedule.unknown) {
|
||||
// Never fires, and says so rather than sitting there with a next run it
|
||||
// is not going to keep. Deleting it is the only thing left to do.
|
||||
const bad = document.createElement("span");
|
||||
bad.className = "state bad";
|
||||
bad.textContent = "unknown kind";
|
||||
kind.append(bad);
|
||||
}
|
||||
row.append(kind);
|
||||
|
||||
const cadence = document.createElement("td");
|
||||
const box = document.createElement("input");
|
||||
box.className = "cadence";
|
||||
box.value = schedule.cadence;
|
||||
box.title = FORMS;
|
||||
box.disabled = busy;
|
||||
const save = () => {
|
||||
const wanted = box.value.trim();
|
||||
if (!wanted || wanted === schedule.cadence) {
|
||||
box.value = schedule.cadence;
|
||||
return;
|
||||
}
|
||||
this.#change(schedule.id, () => this.#ask(`/api/schedules/${schedule.id}`,
|
||||
{ method: "PATCH", body: { cadence: wanted } }));
|
||||
};
|
||||
box.addEventListener("change", save);
|
||||
box.addEventListener("keydown", (e) => { if (e.key === "Enter") box.blur(); });
|
||||
cadence.append(box);
|
||||
row.append(cadence);
|
||||
|
||||
const onOff = document.createElement("td");
|
||||
const toggle = document.createElement("input");
|
||||
toggle.type = "checkbox";
|
||||
toggle.checked = !!schedule.enabled;
|
||||
toggle.disabled = busy;
|
||||
toggle.title = schedule.enabled ? "switch this schedule off" : "switch it on";
|
||||
toggle.addEventListener("change", () => this.#change(schedule.id,
|
||||
() => this.#ask(`/api/schedules/${schedule.id}`,
|
||||
{ method: "PATCH", body: { enabled: toggle.checked } })));
|
||||
onOff.append(toggle);
|
||||
row.append(onOff);
|
||||
|
||||
row.append(this.#cell("when", schedule.enabled ? when(schedule.next_run) : "—"));
|
||||
|
||||
const last = this.#cell("when", when(schedule.last_run));
|
||||
if (schedule.last_state) {
|
||||
const state = document.createElement("span");
|
||||
state.className = `state ${schedule.last_state}`;
|
||||
state.textContent = schedule.last_state;
|
||||
last.append(state);
|
||||
}
|
||||
row.append(last);
|
||||
|
||||
const actions = document.createElement("td");
|
||||
actions.className = "actions";
|
||||
const now = document.createElement("button");
|
||||
now.textContent = "Run now";
|
||||
now.disabled = busy || schedule.unknown;
|
||||
now.addEventListener("click", () => this.#change(schedule.id,
|
||||
() => this.#ask(`/api/schedules/${schedule.id}/run`, { method: "POST" })));
|
||||
const remove = document.createElement("button");
|
||||
remove.className = "remove";
|
||||
remove.textContent = "Delete";
|
||||
remove.disabled = busy;
|
||||
remove.addEventListener("click", () => this.#change(schedule.id,
|
||||
() => this.#ask(`/api/schedules/${schedule.id}`, { method: "DELETE" })));
|
||||
actions.append(now, remove);
|
||||
row.append(actions);
|
||||
|
||||
return row;
|
||||
}
|
||||
|
||||
#cell(className, text) {
|
||||
const cell = document.createElement("td");
|
||||
cell.className = className;
|
||||
const span = document.createElement("span");
|
||||
span.textContent = text;
|
||||
cell.append(span);
|
||||
return cell;
|
||||
}
|
||||
|
||||
/** The add row. In the table rather than in a form above it, because what
|
||||
* is being added is another one of these and the columns already say what
|
||||
* each box is for. */
|
||||
#adder() {
|
||||
const row = document.createElement("tr");
|
||||
const busy = this.#busy.has(0);
|
||||
|
||||
const name = document.createElement("input");
|
||||
name.className = "text";
|
||||
name.placeholder = "optional";
|
||||
name.disabled = busy;
|
||||
row.append(this.#wrap(name));
|
||||
|
||||
const kind = document.createElement("select");
|
||||
kind.disabled = busy || !this.#kinds.length;
|
||||
for (const k of this.#kinds) {
|
||||
const option = document.createElement("option");
|
||||
option.value = k.kind;
|
||||
option.textContent = k.label || k.kind;
|
||||
kind.append(option);
|
||||
}
|
||||
if (!this.#kinds.length) {
|
||||
const none = document.createElement("option");
|
||||
none.textContent = this.#loaded ? "nothing registered" : "loading…";
|
||||
kind.append(none);
|
||||
}
|
||||
row.append(this.#wrap(kind));
|
||||
|
||||
const cadence = document.createElement("input");
|
||||
cadence.className = "text";
|
||||
cadence.placeholder = HINT;
|
||||
cadence.title = FORMS;
|
||||
cadence.disabled = busy;
|
||||
row.append(this.#wrap(cadence));
|
||||
|
||||
row.append(document.createElement("td"), document.createElement("td"),
|
||||
document.createElement("td"));
|
||||
|
||||
const actions = document.createElement("td");
|
||||
actions.className = "actions";
|
||||
const add = document.createElement("button");
|
||||
add.textContent = "Add";
|
||||
add.disabled = busy;
|
||||
const submit = () => {
|
||||
if (!kind.value) return;
|
||||
this.#change(0, async () => {
|
||||
await this.#ask("/api/schedules", {
|
||||
method: "POST",
|
||||
body: { name: name.value.trim(), kind: kind.value,
|
||||
cadence: cadence.value.trim() },
|
||||
});
|
||||
// Cleared only on success, so a refused cadence is still there to be
|
||||
// corrected rather than retyped from memory.
|
||||
name.value = "";
|
||||
cadence.value = "";
|
||||
});
|
||||
};
|
||||
add.addEventListener("click", submit);
|
||||
for (const box of [name, cadence]) {
|
||||
box.addEventListener("keydown", (e) => { if (e.key === "Enter") submit(); });
|
||||
}
|
||||
actions.append(add);
|
||||
row.append(actions);
|
||||
return row;
|
||||
}
|
||||
|
||||
#wrap(control) {
|
||||
const cell = document.createElement("td");
|
||||
cell.append(control);
|
||||
return cell;
|
||||
}
|
||||
}
|
||||
|
||||
if (!customElements.get("desk-schedules")) {
|
||||
customElements.define("desk-schedules", DeskSchedules);
|
||||
}
|
||||
|
||||
export { DeskSchedules };
|
||||
Reference in new issue
Block a user