@falkenslab/moodle-driver 0.0.0-stage → 0.3.1

package/dist/core/files.d.ts

@@ -0,0 +1,16 @@
+import type { BrowserContext } from "playwright-core";
+/** Local files given to upload (a submission, an attachment, a resource): absolute, and there. */
+export declare function checkLocalFiles(files: string[]): Promise<void>;
+/** A file name from Content-Disposition, else the URL's last segment; never a path. */
+export declare function fileNameFor(url: URL, disposition: string | undefined): string;
+export interface DownloadedFile {
+    path: string;
+    name: string;
+    size: number;
+    contentType?: string;
+}
+/**
+ * Saves a file of the site into `destDir` with the person's session, never overwriting. Only URLs of
+ * the site's origin: the session's cookies go nowhere else (its media outside Moodle's path included).
+ */
+export declare function downloadFile(context: BrowserContext, siteUrl: string, url: string, destDir: string): Promise<DownloadedFile>;

package/dist/core/files.js

@@ -0,0 +1,58 @@
+import { access, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { NotLoggedInError } from "./session.js";
+import { MoodleError } from "./errors.js";
+/** Local files given to upload (a submission, an attachment, a resource): absolute, and there. */
+export async function checkLocalFiles(files) {
+    for (const file of files) {
+        if (!path.isAbsolute(file))
+            throw new MoodleError(`Give files as absolute paths: "${file}".`, "invalid-input");
+        await access(file).catch(() => {
+            throw new MoodleError(`There's no file at ${file}.`, "not-found");
+        });
+    }
+}
+/** A file name from Content-Disposition, else the URL's last segment; never a path. */
+export function fileNameFor(url, disposition) {
+    const encoded = disposition && /filename\*=UTF-8''([^;]+)/i.exec(disposition)?.[1];
+    const plain = disposition && /filename="?([^";]+)"?/i.exec(disposition)?.[1];
+    const raw = encoded ? decodeURIComponent(encoded) : (plain ?? decodeURIComponent(url.pathname.split("/").pop() || "download"));
+    // The last segment of whatever path it names, then without characters a file name can't have.
+    const name = (raw.split(/[\\/]/).pop() ?? "").replace(/[:*?"<>|]+/g, "_").trim();
+    return name === "" || name === "." || name === ".." ? "download" : name;
+}
+/** `dir/name`, or `dir/name (2).ext`… when it exists: a download never overwrites. */
+async function freePath(dir, name) {
+    const { name: stem, ext } = path.parse(name);
+    for (let n = 1;; n++) {
+        const candidate = path.join(dir, n === 1 ? name : `${stem} (${n})${ext}`);
+        if (!(await access(candidate).then(() => true, () => false)))
+            return candidate;
+    }
+}
+/**
+ * Saves a file of the site into `destDir` with the person's session, never overwriting. Only URLs of
+ * the site's origin: the session's cookies go nowhere else (its media outside Moodle's path included).
+ */
+export async function downloadFile(context, siteUrl, url, destDir) {
+    const target = new URL(url);
+    const origin = new URL(siteUrl).origin;
+    if (target.origin !== origin)
+        throw new MoodleError(`Only files of ${origin} can be downloaded with the session; ${target.origin} isn't the site.`, "outside-site");
+    if (!path.isAbsolute(destDir))
+        throw new MoodleError(`Give the destination folder as an absolute path: "${destDir}".`, "invalid-input");
+    // The context's request API carries its cookies without opening a tab.
+    const response = await context.request.get(target.href, { maxRedirects: 5 });
+    const contentType = response.headers()["content-type"]?.split(";")[0]?.trim();
+    // A file the session can't reach comes back as the login page.
+    if (contentType === "text/html" && new URL(response.url()).pathname.includes("/login/"))
+        throw new NotLoggedInError();
+    if (!response.ok())
+        throw new MoodleError(`Moodle answered ${response.status()} for ${target.pathname}: the file doesn't exist or you can't see it.`, "not-found");
+    await mkdir(destDir, { recursive: true });
+    const body = await response.body();
+    const saved = await freePath(destDir, fileNameFor(target, response.headers()["content-disposition"]));
+    await writeFile(saved, body);
+    return { path: saved, name: path.basename(saved), size: body.length, contentType };
+}
+//# sourceMappingURL=files.js.map

package/dist/core/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/core/files.ts"],"names":[],"mappings":"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"}

package/dist/core/forms.d.ts

@@ -0,0 +1,45 @@
+import type { BrowserContext, Page } from "playwright-core";
+import { MoodleError } from "./errors.js";
+/** A form field's value: text, a number, a checkbox, or a multiple select's values. */
+export type FieldValue = string | number | boolean | string[];
+/** Moodle refused the form, or a field to set isn't in it. */
+export declare class FormError extends MoodleError {
+    readonly fields: {
+        field: string;
+        message: string;
+    }[];
+    name: string;
+    constructor(message: string, fields: {
+        field: string;
+        message: string;
+    }[]);
+}
+/** Opens a Moodle form page and waits for its editors to be ready. */
+export declare function openForm(context: BrowserContext, siteUrl: string, pathAndQuery: string): Promise<Page>;
+/** A hidden field's value in the form (a draft area id, the course id…). */
+export declare function formValue(page: Page, name: string): Promise<string | undefined>;
+/**
+ * Sets fields by their form name: text inputs and textareas (through TinyMCE when it edits them),
+ * selects (several values for a multiple one), checkboxes and radios, in the order given (a field can
+ * enable the next one). Throws `FormError` naming the fields the form doesn't have, and those it has
+ * disabled: Moodle wouldn't send them, and the change would be lost unnoticed.
+ */
+export declare function setFields(page: Page, values: Record<string, FieldValue>, formSelector?: string): Promise<void>;
+/**
+ * Uploads local files to a form's draft area, as the file picker's "Upload a file" does: the
+ * upload repository's id comes from the page's file picker settings, the context from `M.cfg`.
+ */
+export declare function uploadToDraft(page: Page, draftItemId: string, filePaths: string[]): Promise<void>;
+/**
+ * Submits the form with one of its buttons and waits for the next page. Throws `FormError` with
+ * Moodle's messages by field (`#id_error_<field>`) when the form comes back with errors.
+ */
+export declare function submitForm(page: Page, button: string): Promise<void>;
+/**
+ * The values of a Moodle date selector's parts (`name[day]`, `[month]`, `[year]`, `[hour]`,
+ * `[minute]`) for `date`, in the person's time zone (`M.cfg.usertimezone`), which is how Moodle
+ * reads them. Its "enable" checkbox, when it has one, is the caller's to set first.
+ */
+export declare function dateSelectorValues(page: Page, name: string, date: Date): Promise<Record<string, FieldValue>>;
+/** The date a Moodle date selector holds (`name[day]`… in the person's time zone), or undefined when it's off. */
+export declare function dateSelectorDate(page: Page, name: string): Promise<Date | undefined>;

package/dist/core/forms.js

@@ -0,0 +1,200 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { openSitePage } from "./session.js";
+import { MoodleError } from "./errors.js";
+/** Moodle refused the form, or a field to set isn't in it. */
+export class FormError extends MoodleError {
+    fields;
+    name = "FormError";
+    constructor(message, fields) {
+        super(`${message} ${fields.map((f) => `${f.field}: ${f.message}`).join("; ")}`, "form");
+        this.fields = fields;
+    }
+}
+/** Opens a Moodle form page and waits for its editors to be ready. */
+export async function openForm(context, siteUrl, pathAndQuery) {
+    const page = await openSitePage(context, siteUrl, pathAndQuery);
+    try {
+        if ((await page.locator("form.mform").count()) === 0)
+            throw new FormError("This page has no Moodle form.", [{ field: "page", message: pathAndQuery }]);
+        await page.waitForLoadState("load");
+        // TinyMCE starts after load; its content must be set through it, or the save takes the old one.
+        await page
+            .waitForFunction(() => {
+            const tiny = globalThis.tinymce;
+            return !tiny || tiny.get().every((editor) => editor.initialized);
+        }, undefined, { timeout: 15_000 })
+            .catch(() => undefined);
+        // Moodle enables and disables fields as others change (disabledIf) once its form dependencies
+        // start, after load: a field set before then stays disabled (confirmed empirically, 5.2).
+        const dependent = await page.evaluate(() => globalThis.document.documentElement.innerHTML.includes("M.form.initFormDependencies"));
+        if (dependent) {
+            await page
+                .waitForFunction(() => {
+                const g = globalThis;
+                const id = g.document.querySelector("form.mform")?.id ?? "";
+                return Boolean(g.M?.form?.dependencyManagers?.[id]);
+            }, undefined, { timeout: 15_000 })
+                .catch(() => undefined);
+        }
+        return page;
+    }
+    catch (error) {
+        await page.close().catch(() => undefined);
+        throw error;
+    }
+}
+/** A hidden field's value in the form (a draft area id, the course id…). */
+export function formValue(page, name) {
+    return page.evaluate((name) => {
+        const field = globalThis.document.querySelector(`form.mform [name="${name}"]`);
+        return field?.value;
+    }, name);
+}
+/**
+ * Sets fields by their form name: text inputs and textareas (through TinyMCE when it edits them),
+ * selects (several values for a multiple one), checkboxes and radios, in the order given (a field can
+ * enable the next one). Throws `FormError` naming the fields the form doesn't have, and those it has
+ * disabled: Moodle wouldn't send them, and the change would be lost unnoticed.
+ */
+export async function setFields(page, values, formSelector = "form.mform") {
+    const missing = [];
+    const disabled = [];
+    // One field at a time: Moodle enables dependent fields in handlers that run after the change event
+    // (choosing whether to rescale enables a maximum grade, confirmed empirically, 5.2).
+    for (const [name, value] of Object.entries(values)) {
+        const outcome = await setField(page, name, value, formSelector);
+        if (outcome === "missing")
+            missing.push(name);
+        if (outcome === "disabled")
+            disabled.push(name);
+    }
+    if (missing.length > 0) {
+        throw new FormError("The form has no such field:", missing.map((field) => ({ field, message: "not in this form; check its name in Moodle's form" })));
+    }
+    if (disabled.length > 0) {
+        throw new FormError("The form has these fields disabled, so Moodle wouldn't save them:", disabled.map((field) => ({ field, message: "disabled; another field enables it (set that one first, in the same call)" })));
+    }
+}
+function setField(page, name, value, formSelector) {
+    return page.evaluate(({ name, value, formSelector }) => {
+        const g = globalThis;
+        const form = g.document.querySelector(formSelector);
+        const all = Array.from(form?.querySelectorAll(`[name="${name}"]`) ?? []);
+        // A Moodle checkbox comes with a hidden twin holding its unchecked value.
+        const fields = all.length > 1 ? all.filter((field) => field.type !== "hidden") : all;
+        if (fields.length === 0)
+            return "missing";
+        // Checked now, after the fields before it: their change events may have enabled it.
+        if (fields.every((field) => field.disabled))
+            return "disabled";
+        for (const field of fields) {
+            if (field.type === "checkbox")
+                field.checked = value === true || value === 1 || value === "1";
+            else if (field.type === "radio")
+                field.checked = field.value === String(value);
+            else if (field.multiple && field.options) {
+                const wanted = (Array.isArray(value) ? value : [value]).map(String);
+                for (const option of Array.from(field.options))
+                    option.selected = wanted.includes(option.value);
+            }
+            else {
+                field.value = String(value);
+                const editor = field.id ? g.tinymce?.get(field.id) : null;
+                if (editor) {
+                    editor.setContent(String(value));
+                    editor.save();
+                }
+            }
+            field.dispatchEvent(new g.Event("change", { bubbles: true }));
+        }
+        return "set";
+    }, { name, value, formSelector });
+}
+/**
+ * Uploads local files to a form's draft area, as the file picker's "Upload a file" does: the
+ * upload repository's id comes from the page's file picker settings, the context from `M.cfg`.
+ */
+export async function uploadToDraft(page, draftItemId, filePaths) {
+    const files = await Promise.all(filePaths.map(async (filePath) => ({ name: path.basename(filePath), base64: (await readFile(filePath)).toString("base64") })));
+    const errors = await page.evaluate(async ({ draftItemId, files }) => {
+        const g = globalThis;
+        const repo = /"id":"(\d+)","name":"(?:[^"\\]|\\.)*","type":"upload"/.exec(g.document.documentElement.innerHTML)?.[1];
+        if (!repo)
+            return ["the site has no upload repository enabled"];
+        const failed = [];
+        for (const file of files) {
+            const body = new g.FormData();
+            body.append("repo_upload_file", new g.Blob([Uint8Array.from(g.atob(file.base64), (c) => c.charCodeAt(0))]), file.name);
+            for (const [key, value] of Object.entries({ sesskey: g.M.cfg.sesskey, repo_id: repo, itemid: draftItemId, ctx_id: String(g.M.cfg.contextid), savepath: "/", title: file.name, env: "filemanager", author: "" })) {
+                body.append(key, value);
+            }
+            const response = await g.fetch(`${g.M.cfg.wwwroot}/repository/repository_ajax.php?action=upload`, { method: "POST", body, credentials: "same-origin" });
+            const answer = await response.json().catch(() => ({ error: "the answer isn't JSON" }));
+            if (answer.error)
+                failed.push(`${file.name}: ${answer.error}`);
+        }
+        return failed;
+    }, { draftItemId, files });
+    if (errors.length > 0)
+        throw new FormError("Uploading failed:", errors.map((message) => ({ field: "files", message })));
+}
+/**
+ * Submits the form with one of its buttons and waits for the next page. Throws `FormError` with
+ * Moodle's messages by field (`#id_error_<field>`) when the form comes back with errors.
+ */
+export async function submitForm(page, button) {
+    // The navigation's timeout, not the click's: saving can take Moodle long (regrading after a new
+    // maximum grade took over 30 seconds, confirmed empirically on the sandbox, 5.2).
+    await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), page.click(`form.mform [name="${button}"]`, { noWaitAfter: true })]);
+    const errors = await page.evaluate(() => {
+        const doc = globalThis.document;
+        return Array.from(doc.querySelectorAll('form.mform [id^="id_error_"]'))
+            .map((element) => ({ field: element.id.slice("id_error_".length), message: (element.textContent ?? "").replace(/\s+/g, " ").trim() }))
+            .filter((error) => error.message !== "");
+    });
+    if (errors.length > 0)
+        throw new FormError("Moodle refused the form:", errors);
+}
+/**
+ * The values of a Moodle date selector's parts (`name[day]`, `[month]`, `[year]`, `[hour]`,
+ * `[minute]`) for `date`, in the person's time zone (`M.cfg.usertimezone`), which is how Moodle
+ * reads them. Its "enable" checkbox, when it has one, is the caller's to set first.
+ */
+export async function dateSelectorValues(page, name, date) {
+    const timeZone = await page.evaluate(() => globalThis.M?.cfg?.usertimezone ?? "UTC");
+    let parts;
+    try {
+        parts = new Intl.DateTimeFormat("en-GB", { timeZone, year: "numeric", month: "numeric", day: "numeric", hour: "numeric", minute: "numeric", hourCycle: "h23" }).formatToParts(date);
+    }
+    catch {
+        throw new FormError(`The person's time zone in Moodle ("${timeZone}") isn't one the driver knows, so a date can't be set.`, [{ field: name, message: "unknown time zone" }]);
+    }
+    const part = (type) => Number(parts.find((p) => p.type === type)?.value);
+    return { [`${name}[day]`]: part("day"), [`${name}[month]`]: part("month"), [`${name}[year]`]: part("year"), [`${name}[hour]`]: part("hour"), [`${name}[minute]`]: part("minute") };
+}
+/** The date a Moodle date selector holds (`name[day]`… in the person's time zone), or undefined when it's off. */
+export async function dateSelectorDate(page, name) {
+    const read = await page.evaluate((name) => {
+        const g = globalThis;
+        const enabled = g.document.querySelector(`form.mform [name="${name}[enabled]"][type="checkbox"]`);
+        if (enabled && !enabled.checked)
+            return undefined;
+        // Anonymous callbacks only: see the conventions on page.evaluate.
+        const [year, month, day, hour, minute] = ["year", "month", "day", "hour", "minute"].map((p) => Number(g.document.querySelector(`form.mform [name="${name}[${p}]"]`)?.value) || 0);
+        return { timeZone: g.M?.cfg?.usertimezone ?? "UTC", year: year, month: month, day: day, hour: hour, minute: minute };
+    }, name);
+    if (!read || !read.year)
+        return undefined;
+    // The wall time in that zone: start from it as if UTC, then take away the zone's offset at that moment (twice, across a DST change).
+    const wall = Date.UTC(read.year, read.month - 1, read.day, read.hour, read.minute);
+    let time = wall;
+    for (let i = 0; i < 2; i++) {
+        const parts = new Intl.DateTimeFormat("en-GB", { timeZone: read.timeZone, year: "numeric", month: "numeric", day: "numeric", hour: "numeric", minute: "numeric", hourCycle: "h23" }).formatToParts(new Date(time));
+        const part = (type) => Number(parts.find((p) => p.type === type)?.value);
+        const shown = Date.UTC(part("year"), part("month") - 1, part("day"), part("hour"), part("minute"));
+        time += wall - shown;
+    }
+    return new Date(time);
+}
+//# sourceMappingURL=forms.js.map

package/dist/core/forms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.js","sourceRoot":"","sources":["../../src/core/forms.ts"],"names":[],"mappings":"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"}

package/dist/core/http.d.ts

@@ -0,0 +1,18 @@
+import type { BrowserContext } from "playwright-core";
+export interface SiteRequest {
+    method?: "GET" | "POST";
+    headers?: Record<string, string>;
+    body?: string;
+}
+/** What the site answered: the status, the URL after redirects, the body as text. */
+export interface SiteResponse {
+    status: number;
+    url: string;
+    body: string;
+}
+type Transport = (url: string, request: SiteRequest) => Promise<SiteResponse>;
+/** Sends this context's requests through `transport` instead of `context.request` (for the fake Moodle). */
+export declare function setTransport(context: BrowserContext, transport: Transport): void;
+/** A request to `url` with the context's cookies; redirects are followed, and any status is returned. */
+export declare function siteFetch(context: BrowserContext, url: string, request?: SiteRequest): Promise<SiteResponse>;
+export {};

package/dist/core/http.js

@@ -0,0 +1,22 @@
+// A context's own way to make requests, when it has one: the fake Moodle answers through its routes,
+// which `context.request` doesn't go through (confirmed empirically, playwright-core 1.64).
+const transports = new WeakMap();
+/** Sends this context's requests through `transport` instead of `context.request` (for the fake Moodle). */
+export function setTransport(context, transport) {
+    transports.set(context, transport);
+}
+/** A request to `url` with the context's cookies; redirects are followed, and any status is returned. */
+export async function siteFetch(context, url, request = {}) {
+    const transport = transports.get(context);
+    if (transport)
+        return transport(url, request);
+    const response = await context.request.fetch(url, {
+        method: request.method ?? "GET",
+        headers: request.headers,
+        data: request.body,
+        maxRedirects: 10,
+        failOnStatusCode: false,
+    });
+    return { status: response.status(), url: response.url(), body: await response.text() };
+}
+//# sourceMappingURL=http.js.map

package/dist/core/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"AAmBA,qGAAqG;AACrG,4FAA4F;AAC5F,MAAM,UAAU,GAAG,IAAI,OAAO,EAA6B,CAAC;AAE5D,4GAA4G;AAC5G,MAAM,UAAU,YAAY,CAAC,OAAuB,EAAE,SAAoB;IACxE,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AACrC,CAAC;AAED,yGAAyG;AACzG,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAuB,EAAE,GAAW,EAAE,UAAuB,EAAE;IAC7F,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;QAChD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,YAAY,EAAE,EAAE;QAChB,gBAAgB,EAAE,KAAK;KACxB,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;AACzF,CAAC"}

package/dist/core/inPage.d.ts

@@ -0,0 +1,8 @@
+import type { Page } from "playwright-core";
+/**
+ * Runs `fn(arg)` in the page, like `page.evaluate`, but with a `__name` helper defined first: tsx
+ * (the tests) compiles with esbuild's keepNames, which wraps named inner functions in `__name(...)`
+ * calls the page doesn't have (confirmed empirically). The bundle doesn't, and the helper is unused
+ * there. `arg` must be JSON.
+ */
+export declare function inPage<A, R>(page: Page, fn: (arg: A) => R | Promise<R>, arg: A): Promise<R>;

package/dist/core/inPage.js

@@ -0,0 +1,10 @@
+/**
+ * Runs `fn(arg)` in the page, like `page.evaluate`, but with a `__name` helper defined first: tsx
+ * (the tests) compiles with esbuild's keepNames, which wraps named inner functions in `__name(...)`
+ * calls the page doesn't have (confirmed empirically). The bundle doesn't, and the helper is unused
+ * there. `arg` must be JSON.
+ */
+export function inPage(page, fn, arg) {
+    return page.evaluate(`(() => { const __name = (f) => f; return (${fn.toString()})(${JSON.stringify(arg)}); })()`);
+}
+//# sourceMappingURL=inPage.js.map

package/dist/core/inPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inPage.js","sourceRoot":"","sources":["../../src/core/inPage.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAO,IAAU,EAAE,EAA8B,EAAE,GAAM;IAC7E,OAAO,IAAI,CAAC,QAAQ,CAAC,6CAA6C,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAe,CAAC;AAClI,CAAC"}

package/dist/core/login.d.ts

@@ -0,0 +1,40 @@
+import type { BrowserContext, Page } from "playwright-core";
+import type { BrowserManager } from "../browser/manager.js";
+import { MoodleError } from "./errors.js";
+export declare class LoginTimeoutError extends MoodleError {
+    name: string;
+    constructor(message: string);
+}
+export declare class LoginWindowClosedError extends MoodleError {
+    name: string;
+    constructor();
+}
+/** The logged-in user, read from their own profile page (`user/profile.php`). */
+export declare function readOwnProfile(context: BrowserContext, siteUrl: string): Promise<{
+    userId: number;
+    fullName: string;
+}>;
+/**
+ * Waits until `page` shows the site with a user logged in. The person may go through other domains
+ * (SSO) on the way; reads fail while a page navigates, and are retried.
+ */
+export declare function waitForLogin(page: Page, siteUrl: string, { timeoutMs, pollMs, onWait }: {
+    timeoutMs: number;
+    pollMs?: number;
+    onWait?: (elapsedMs: number) => void;
+}): Promise<void>;
+export interface LoginResult {
+    status: "already-logged-in" | "logged-in";
+    userId: number;
+    fullName: string;
+}
+/**
+ * Makes sure there's a session: the user at once if there is one; otherwise a browser window at the
+ * site's login page, waiting (calling `onWait`) until the person logs in there themselves. The session
+ * is saved (ADR-003), and the window closes again unless the browser is shown on demand. It waits
+ * `timeoutMs`, 5 minutes by default.
+ */
+export declare function logIn(browser: BrowserManager, siteUrl: string, { timeoutMs, onWait }?: {
+    timeoutMs?: number;
+    onWait?: (elapsedMs: number) => void;
+}): Promise<LoginResult>;

package/dist/core/login.js

@@ -0,0 +1,83 @@
+import { NotLoggedInError, openSitePage, pageIsLoggedIn } from "./session.js";
+import { MoodleError } from "./errors.js";
+const POLL_MS = 1000;
+const LOGIN_TIMEOUT_MS = 5 * 60_000;
+export class LoginTimeoutError extends MoodleError {
+    name = "LoginTimeoutError";
+    constructor(message) {
+        super(message, "login-timeout");
+    }
+}
+export class LoginWindowClosedError extends MoodleError {
+    name = "LoginWindowClosedError";
+    constructor() {
+        super("The login window was closed before the person logged in.", "login-window-closed");
+    }
+}
+/** The logged-in user, read from their own profile page (`user/profile.php`). */
+export async function readOwnProfile(context, siteUrl) {
+    const page = await openSitePage(context, siteUrl, "user/profile.php");
+    try {
+        return await page.evaluate(() => {
+            const g = globalThis;
+            // The page heading is the user's full name, in any interface language.
+            const heading = g.document.querySelector("#page-header h1, .page-header-headings h1, h1");
+            return { userId: g.M.cfg.userId, fullName: heading?.textContent?.trim() ?? "" };
+        });
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * Waits until `page` shows the site with a user logged in. The person may go through other domains
+ * (SSO) on the way; reads fail while a page navigates, and are retried.
+ */
+export async function waitForLogin(page, siteUrl, { timeoutMs, pollMs = POLL_MS, onWait }) {
+    const start = Date.now();
+    for (;;) {
+        if (page.isClosed())
+            throw new LoginWindowClosedError();
+        if (await pageIsLoggedIn(page, siteUrl).catch(() => false))
+            return;
+        const elapsed = Date.now() - start;
+        if (elapsed >= timeoutMs)
+            throw new LoginTimeoutError(`Nobody logged in within ${Math.round(timeoutMs / 1000)} seconds; the window was closed.`);
+        onWait?.(elapsed);
+        await new Promise((resolve) => setTimeout(resolve, pollMs));
+    }
+}
+/**
+ * Makes sure there's a session: the user at once if there is one; otherwise a browser window at the
+ * site's login page, waiting (calling `onWait`) until the person logs in there themselves. The session
+ * is saved (ADR-003), and the window closes again unless the browser is shown on demand. It waits
+ * `timeoutMs`, 5 minutes by default.
+ */
+export async function logIn(browser, siteUrl, { timeoutMs = LOGIN_TIMEOUT_MS, onWait } = {}) {
+    try {
+        return { status: "already-logged-in", ...(await readOwnProfile(await browser.context(), siteUrl)) };
+    }
+    catch (error) {
+        if (!(error instanceof NotLoggedInError))
+            throw error;
+    }
+    const context = await browser.context({ headed: true });
+    const page = context.pages()[0] ?? (await context.newPage());
+    await page.goto(new URL("login/index.php", siteUrl).href, { waitUntil: "domcontentloaded" });
+    await page.bringToFront();
+    try {
+        await waitForLogin(page, siteUrl, { timeoutMs, onWait });
+    }
+    catch (error) {
+        if (error instanceof LoginTimeoutError)
+            await browser.close();
+        throw error;
+    }
+    const user = await readOwnProfile(context, siteUrl);
+    await browser.saveSession();
+    // Back to the chosen mode: the next call reopens the browser without a window.
+    if (!browser.visible())
+        await browser.close();
+    return { status: "logged-in", ...user };
+}
+//# sourceMappingURL=login.js.map

package/dist/core/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/core/login.ts"],"names":[],"mappings":"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"}

package/dist/core/pace.d.ts

@@ -0,0 +1,4 @@
+/** How long a person would take to read `text`, in seconds. */
+export declare function readingSeconds(text: string): number;
+/** Waits `seconds`, calling `onProgress` every few seconds so clients keep waiting. */
+export declare function pause(seconds: number, onProgress?: (elapsedSeconds: number) => void): Promise<void>;

package/dist/core/pace.js

@@ -0,0 +1,21 @@
+// Reading at a person's pace (ADR-005): about 240 words a minute, bounded per page.
+const WORDS_PER_SECOND = 4;
+const MIN_SECONDS = 3;
+const MAX_SECONDS = 90;
+const PROGRESS_EVERY_MS = 5000;
+/** How long a person would take to read `text`, in seconds. */
+export function readingSeconds(text) {
+    const words = text.split(/\s+/).filter(Boolean).length;
+    return Math.min(MAX_SECONDS, Math.max(MIN_SECONDS, Math.round(words / WORDS_PER_SECOND)));
+}
+/** Waits `seconds`, calling `onProgress` every few seconds so clients keep waiting. */
+export async function pause(seconds, onProgress) {
+    const end = Date.now() + seconds * 1000;
+    // A timer can fire a millisecond before Date.now() says it's due: what's left below that is done,
+    // or the loop would go round once more and report the same second twice.
+    while (end - Date.now() > 5) {
+        await new Promise((resolve) => setTimeout(resolve, Math.min(PROGRESS_EVERY_MS, end - Date.now())));
+        onProgress?.(Math.round(seconds - (end - Date.now()) / 1000));
+    }
+}
+//# sourceMappingURL=pace.js.map

package/dist/core/pace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pace.js","sourceRoot":"","sources":["../../src/core/pace.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACvD,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAe,EAAE,UAA6C;IACxF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC;IACxC,kGAAkG;IAClG,yEAAyE;IACzE,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QACnG,UAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}