users: admin CRUD API and admin shell UI
ci / check (push) Canceled after 0s
ci / images (push) Canceled after 0s

Login, forced password change, admin layout with every 05 §2 page in the
sidebar (unbuilt ones name their milestone), Users table/cards + drawer
(General tab), one-time temporary passwords, reset password. The last
active admin can't be demoted, deactivated or deleted. Audit diffs only
mask secret strings. scripts/e2e has a dependency-free CDP browser check
for this task's acceptance flow.

Task: M1-T4
This commit is contained in:
iamdoubz committed 2026-10-17 15:18:08 -05:00
1 parent 13733ac262
commit 9a81e37725
25 files changed
+1774 -33

No files matched your search

+117
View File
@@ -0,0 +1,117 @@
// SPDX-License-Identifier: AGPL-3.0-or-later
// Minimal headless-Edge driver over the Chrome DevTools Protocol (no dependencies).
import { spawn } from 'node:child_process';
import { mkdtempSync, writeFileSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
// Any Chromium: set BROWSER, e.g. /usr/bin/chromium or the Edge/Chrome .exe on Windows.
const EDGE = process.env.BROWSER ?? 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe';
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
export async function launch({ width = 1280, height = 800, shotsDir }) {
const profile = mkdtempSync(join(tmpdir(), 'sp-edge-'));
const port = 9300 + Math.floor(Math.random() * 500);
const proc = spawn(EDGE, [
'--headless=new',
`--remote-debugging-port=${port}`,
`--user-data-dir=${profile}`,
'--no-first-run',
`--window-size=${width},${height}`,
'about:blank',
]);
let info;
for (let i = 0; i < 50 && !info; i++) {
await sleep(200);
info = await fetch(`http://127.0.0.1:${port}/json/list`)
.then((r) => r.json())
.then((l) => l.find((t) => t.type === 'page'))
.catch(() => undefined);
}
const ws = new WebSocket(info.webSocketDebuggerUrl);
await new Promise((r) => ws.addEventListener('open', r));
let id = 0;
const pending = new Map();
const consoleErrors = [];
ws.addEventListener('message', (ev) => {
const m = JSON.parse(ev.data);
if (m.id && pending.has(m.id)) {
const { resolve, reject } = pending.get(m.id);
pending.delete(m.id);
if (m.error) reject(new Error(m.error.message));
else resolve(m.result);
}
if (m.method === 'Runtime.exceptionThrown') consoleErrors.push(m.params.exceptionDetails.text);
if (m.method === 'Runtime.consoleAPICalled' && m.params.type === 'error')
consoleErrors.push(m.params.args.map((a) => a.value ?? a.description).join(' '));
});
const send = (method, params = {}) =>
new Promise((resolve, reject) => {
pending.set(++id, { resolve, reject });
ws.send(JSON.stringify({ id, method, params }));
});
await send('Page.enable');
await send('Runtime.enable');
await send('Emulation.setDeviceMetricsOverride', {
width,
height,
deviceScaleFactor: 1,
mobile: width < 500,
});
const evaluate = async (expr) => {
const r = await send('Runtime.evaluate', {
expression: expr,
awaitPromise: true,
returnByValue: true,
});
if (r.exceptionDetails)
throw new Error(r.exceptionDetails.exception?.description ?? 'eval failed');
return r.result.value;
};
const waitFor = async (expr, what, timeout = 8000) => {
const end = Date.now() + timeout;
while (Date.now() < end) {
if (await evaluate(expr).catch(() => false)) return;
await sleep(100);
}
throw new Error(`timeout waiting for: ${what ?? expr}`);
};
const page = {
evaluate,
waitFor,
consoleErrors,
goto: (url) => send('Page.navigate', { url }),
path: () => evaluate('location.pathname'),
/** Sets an input/select found by its <label> text, the way a user typing would (React sees it). */
fill: (label, value) =>
evaluate(`(() => {
const l = [...document.querySelectorAll('label')].find(l => l.textContent.trim().startsWith(${JSON.stringify(label)}) && l.htmlFor && document.getElementById(l.htmlFor)?.offsetParent !== null);
if (!l) throw new Error('no visible field ' + ${JSON.stringify(label)});
const el = document.getElementById(l.htmlFor);
const proto = el.tagName === 'SELECT' ? HTMLSelectElement.prototype : HTMLInputElement.prototype;
Object.getOwnPropertyDescriptor(proto, 'value').set.call(el, ${JSON.stringify(value)});
el.dispatchEvent(new Event(el.tagName === 'SELECT' ? 'change' : 'input', { bubbles: true }));
return true;
})()`),
/** Clicks the first visible button/link whose text or aria-label matches. */
click: (text) =>
evaluate(`(() => {
const t = ${JSON.stringify(text)};
const el = [...document.querySelectorAll('button, a')].reverse().find(e => (e.textContent.trim() === t || e.getAttribute('aria-label') === t) && e.getClientRects().length);
if (!el) throw new Error('no visible button ' + t);
el.click();
return true;
})()`),
text: () => evaluate('document.body.innerText'),
shot: async (name) => {
const r = await send('Page.captureScreenshot', { format: 'png' });
writeFileSync(join(shotsDir, `${name}.png`), Buffer.from(r.data, 'base64'));
},
close: async () => {
ws.close();
proc.kill();
},
};
return page;
}