@falkenslab/moodle-driver 0.0.0-stage → 0.3.1

package/dist/moodle/grading.js

@@ -0,0 +1,161 @@
+import { GradingError, NotAnAssignmentError, assignmentIds, fillGradingForm, gradingPanelHtml, listParticipants, panelGrade, participantDates, readSubmissionContent, submitGradingForm } from "./assign.js";
+import { isoDate } from "./courses.js";
+import { dateSelectorDate, dateSelectorValues, openForm, setFields, submitForm } from "./forms.js";
+import { NotLoggedInError } from "./session.js";
+import { inPage } from "./inPage.js";
+/** The grader's feedback comments field, when the assignment has them on. */
+const FEEDBACK_FIELD = "assignfeedbackcomments_editor[text]";
+/** An extension's date, as its form holds it (no service open to AJAX gives it). */
+async function extensionDate(context, siteUrl, cmid, userId) {
+    const page = await openForm(context, siteUrl, `mod/assign/view.php?id=${cmid}&action=grantextension&userid=${userId}`).catch((error) => {
+        if (error instanceof NotLoggedInError)
+            throw error;
+        return undefined;
+    });
+    if (!page)
+        return undefined;
+    try {
+        return (await dateSelectorDate(page, "extensionduedate"))?.toISOString();
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** Every participant's submission to an assignment, with its content unless `includeContent` is false. */
+export async function assignmentSubmissions(context, siteUrl, cmid, { includeContent = true } = {}) {
+    const ids = await assignmentIds(context, siteUrl, cmid);
+    const participants = await listParticipants(context, siteUrl, ids.instanceId);
+    // A blank tab parses the panels' HTML: nothing of Moodle's loads there.
+    const parser = includeContent ? await context.newPage() : undefined;
+    const submissions = [];
+    try {
+        // One participant at a time: the calls share the kept service tab (ADR-004).
+        for (const participant of participants) {
+            const dates = await participantDates(context, siteUrl, ids.instanceId, participant.id);
+            const status = participant.submissionstatus || "none";
+            const withContent = parser && (status === "submitted" || status === "draft");
+            submissions.push({
+                userId: participant.id,
+                fullName: participant.fullname,
+                status,
+                submitted: participant.submitted,
+                needsGrading: participant.requiregrading,
+                extensionGranted: participant.grantedextension,
+                extensionDueDate: participant.grantedextension ? await extensionDate(context, siteUrl, cmid, participant.id) : undefined,
+                allowSubmissionsFrom: isoDate(dates.allowsubmissionsfromdate),
+                dueDate: isoDate(dates.duedate),
+                cutoffDate: isoDate(dates.cutoffdate),
+                content: withContent ? await readSubmissionContent(parser, await gradingPanelHtml(context, siteUrl, ids.contextId, participant.id)) : undefined,
+            });
+        }
+    }
+    finally {
+        await parser?.close().catch(() => undefined);
+    }
+    return { assignment: { id: cmid, instanceId: ids.instanceId }, submissions };
+}
+/**
+ * Grades a participant as the grader does: a grade (simple grading), a rubric's level per criterion
+ * or a marking guide's score per criterion (by their ids, from `rubric()`), remarks per criterion,
+ * feedback comments (HTML), whether to notify, and any other grading field by name. Returns the
+ * grade saved and the gradebook's grade, the total Moodle computes for a rubric or a guide.
+ */
+export async function gradeSubmission(context, siteUrl, cmid, userId, { grade, rubric, guide, remarks, feedback, notify, fields, }) {
+    const ids = await assignmentIds(context, siteUrl, cmid);
+    const values = { ...fields };
+    if (grade !== undefined)
+        values.grade = grade;
+    for (const [criterion, level] of Object.entries(rubric ?? {}))
+        values[`advancedgrading[criteria][${criterion}][levelid]`] = String(level);
+    for (const [criterion, score] of Object.entries(guide ?? {}))
+        values[`advancedgrading[criteria][${criterion}][score]`] = String(score);
+    for (const [criterion, remark] of Object.entries(remarks ?? {}))
+        values[`advancedgrading[criteria][${criterion}][remark]`] = remark;
+    if (feedback !== undefined)
+        values[FEEDBACK_FIELD] = feedback;
+    if (notify !== undefined)
+        values.sendstudentnotifications = notify ? 1 : 0;
+    // A blank tab holds the panel's form: nothing of the grader's page needs to load.
+    const page = await context.newPage();
+    try {
+        const serialized = await fillGradingForm(page, await gradingPanelHtml(context, siteUrl, ids.contextId, userId), values).catch((error) => {
+            if (feedback !== undefined && error.message.includes(FEEDBACK_FIELD)) {
+                throw new Error("This assignment has no feedback comments: grade it without feedback, or turn feedback comments on in its settings.");
+            }
+            throw error;
+        });
+        await submitGradingForm(context, siteUrl, ids.instanceId, userId, serialized);
+        const saved = await panelGrade(page, await gradingPanelHtml(context, siteUrl, ids.contextId, userId));
+        return { changed: `Graded user ${userId} in assignment ${cmid}${feedback !== undefined ? ", with feedback" : ""}.`, ...saved };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** The grading method and its criteria, read from a grading panel's form by field names and blocks. */
+export async function readGradingDefinition(page, panelHtml) {
+    await page.setContent(panelHtml);
+    // Through inPage: it has a helper function (see the conventions on page.evaluate).
+    return inPage(page, () => {
+        const doc = globalThis.document;
+        const text = (el) => (el?.textContent ?? "").replace(/\s+/g, " ").trim();
+        const method = doc.querySelector(".gradingform_rubric") ? "rubric" : doc.querySelector(".gradingform_guide") ? "guide" : "simple";
+        const criteria = Array.from(doc.querySelectorAll('.gradingform_rubric tr.criterion, .gradingform_guide tr.criterion')).flatMap((row) => {
+            const id = Number(/-criteria-(\d+)$/.exec(row.id)?.[1]);
+            if (!id)
+                return [];
+            if (method === "rubric") {
+                const levels = Array.from(row.querySelectorAll("td.level")).map((level) => ({
+                    id: Number(level.querySelector('input[type="radio"]')?.value),
+                    definition: text(level.querySelector(".definition")),
+                    score: Number(text(level.querySelector(".scorevalue"))),
+                }));
+                return [{ id, description: text(row.querySelector("td.description")), levels }];
+            }
+            const max = Number(text(row.querySelector(".criteriondescriptionscore")));
+            const details = text(row.querySelector(".criteriondescription"));
+            const markers = text(row.querySelector(".criteriondescriptionmarkers"));
+            return [{ id, description: text(row.querySelector(".criterionshortname")), ...(details ? { details } : {}), ...(markers ? { markers } : {}), ...(max ? { maxScore: max } : {}) }];
+        });
+        return { method, criteria };
+    }, null);
+}
+/**
+ * An assignment's grading method and, for a rubric or a marking guide, its criteria with the ids
+ * `gradeSubmission` takes: read from the grader's panel for its first participant.
+ */
+export async function rubric(context, siteUrl, cmid) {
+    const ids = await assignmentIds(context, siteUrl, cmid);
+    const [first] = await listParticipants(context, siteUrl, ids.instanceId);
+    if (!first)
+        throw new GradingError(`Assignment ${cmid} has no participants: its grading form can't be read without one.`);
+    const page = await context.newPage();
+    try {
+        return { assignment: { id: cmid }, ...(await readGradingDefinition(page, await gradingPanelHtml(context, siteUrl, ids.contextId, first.id))) };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * Grants participants an extension until a date, through the assignment's extension form (several at
+ * once as its bulk action does). Moodle refuses a date before the assignment's due date.
+ */
+export async function grantExtension(context, siteUrl, cmid, userIds, until) {
+    if (userIds.length === 0)
+        throw new GradingError("Give the participants to grant the extension to.");
+    const page = await openForm(context, siteUrl, `mod/assign/view.php?id=${cmid}&action=grantextension&userid=${userIds[0]}`).catch((error) => {
+        if (error instanceof NotLoggedInError)
+            throw error;
+        throw new NotAnAssignmentError(`You can't grant extensions in activity ${cmid}: it isn't an assignment, or you aren't allowed.`);
+    });
+    try {
+        await setFields(page, { selectedusers: userIds.join(","), "extensionduedate[enabled]": true, ...(await dateSelectorValues(page, "extensionduedate", until)) });
+        await submitForm(page, "submitbutton");
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+    return { changed: `Extension until ${until.toISOString()} granted to user${userIds.length > 1 ? "s" : ""} ${userIds.join(", ")} in assignment ${cmid}.` };
+}
+//# sourceMappingURL=grading.js.map

package/dist/moodle/grading.js.map

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

package/dist/moodle/h5p.d.ts

@@ -0,0 +1,31 @@
+import type { BrowserContext, Page } from "playwright-core";
+/** The activity isn't an H5P activity the person can open. */
+export declare class NotAnH5PActivityError extends Error {
+    name: string;
+}
+export interface H5PAttempt {
+    /** Moodle's id for the attempt (its report's), and its number for the person. */
+    attemptId?: number;
+    number: number;
+    score?: number;
+    maxScore?: number;
+    completed?: boolean;
+    passed?: boolean;
+}
+export interface H5PActivity {
+    id: number;
+    name: string;
+    /** The H5P library ("H5P.MultiChoice") and its version, from the content's player. */
+    contentType?: {
+        library: string;
+        version: string;
+    };
+    /** Whether Moodle records attempts and scores (the activity's tracking setting). */
+    tracked: boolean;
+    /** The person's own attempts, oldest first: a teacher's report lists participants instead, so none. */
+    attempts: H5PAttempt[];
+}
+/** The rows of the person's "all attempts" table: positions fixed by Moodle's template, icons by class. */
+export declare function readH5PAttempts(page: Page): Promise<H5PAttempt[]>;
+/** An H5P activity: its content type, whether attempts are tracked, and the person's attempts with their scores. */
+export declare function h5pActivity(context: BrowserContext, siteUrl: string, cmid: number): Promise<H5PActivity>;

package/dist/moodle/h5p.js

@@ -0,0 +1,100 @@
+import { inPage } from "./inPage.js";
+import { openSitePage } from "./session.js";
+import { decodeEntities } from "./text.js";
+/** The activity isn't an H5P activity the person can open. */
+export class NotAnH5PActivityError extends Error {
+    name = "NotAnH5PActivityError";
+}
+/** The rows of the person's "all attempts" table: positions fixed by Moodle's template, icons by class. */
+export function readH5PAttempts(page) {
+    // Through inPage: it has a helper function (see the conventions on page.evaluate).
+    return inPage(page, () => {
+        const doc = globalThis.document;
+        // The page shows the scored attempt's table first and every attempt's last.
+        const tables = Array.from(doc.querySelectorAll("#region-main table")).filter((table) => table.querySelector('a[href*="attemptid="]'));
+        const all = tables[tables.length - 1];
+        if (!all)
+            return [];
+        // An attempt row starts with its number; a teacher's participants table has names there.
+        const rows = Array.from(all.querySelectorAll("tbody tr")).filter((row) => /^\d+$/.test((row.querySelector("th")?.textContent ?? "").trim()) && row.querySelectorAll("td").length >= 6);
+        return rows.map((row) => {
+            const cells = Array.from(row.querySelectorAll("td"));
+            // The score cell starts with the raw score; a hidden " / max" follows for small screens.
+            const raw = Array.from(cells[1]?.childNodes ?? [])
+                .filter((node) => node.nodeType === 3)
+                .map((node) => node.textContent ?? "")
+                .join("")
+                .trim();
+            const max = (cells[2]?.textContent ?? "").trim();
+            const completion = cells[4]?.querySelector("img, i");
+            const success = cells[5]?.querySelector("i, img");
+            const mark = (icon) => {
+                if (!icon)
+                    return undefined;
+                const look = `${icon.className} ${icon.getAttribute("src") ?? ""}`;
+                return /check|-y\b|completion-[a-z]+-y/.test(look) ? true : /circle|-n\b/.test(look) ? false : undefined;
+            };
+            const link = row.querySelector('a[href*="attemptid="]')?.getAttribute("href") ?? "";
+            return {
+                ...(/attemptid=(\d+)/.test(link) ? { attemptId: Number(/attemptid=(\d+)/.exec(link)[1]) } : {}),
+                number: Number((row.querySelector("th")?.textContent ?? "").trim()),
+                ...(raw !== "" && !Number.isNaN(Number(raw)) ? { score: Number(raw) } : {}),
+                ...(max !== "" && !Number.isNaN(Number(max)) ? { maxScore: Number(max) } : {}),
+                ...(mark(completion) !== undefined ? { completed: mark(completion) } : {}),
+                ...(mark(success) !== undefined ? { passed: mark(success) } : {}),
+            };
+        });
+    }, null);
+}
+/** An H5P activity: its content type, whether attempts are tracked, and the person's attempts with their scores. */
+export async function h5pActivity(context, siteUrl, cmid) {
+    const page = await openSitePage(context, siteUrl, `mod/h5pactivity/view.php?id=${cmid}`);
+    let facts;
+    try {
+        if ((await page.locator("body#page-mod-h5pactivity-view").count()) === 0) {
+            throw new NotAnH5PActivityError(`Activity ${cmid} isn't an H5P activity you can open. Take the id of an H5P activity (module "h5pactivity") from the course structure.`);
+        }
+        facts = await page.evaluate(() => {
+            const doc = globalThis.document;
+            return {
+                name: doc.querySelector("[data-activityname]")?.getAttribute("data-activityname") ?? "",
+                player: doc.querySelector("iframe.h5p-player")?.getAttribute("src") ?? undefined,
+                // The attempts report is linked only where Moodle tracks attempts.
+                tracked: doc.querySelector('a[href*="/mod/h5pactivity/report.php"]') !== null,
+            };
+        });
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+    const activity = { id: cmid, name: decodeEntities(facts.name), tracked: facts.tracked, attempts: [] };
+    if (facts.player) {
+        // The player page names the content's main library in its H5P settings, before any script runs.
+        const player = await context.newPage();
+        let html = "";
+        try {
+            await player.goto(new URL(facts.player, siteUrl).href, { waitUntil: "domcontentloaded" });
+            html = await player.content();
+        }
+        catch {
+            // No player to read: the content type stays unknown.
+        }
+        finally {
+            await player.close().catch(() => undefined);
+        }
+        const library = /"library":"([^"\s]+) (\d+\.\d+)"/.exec(html);
+        if (library)
+            activity.contentType = { library: library[1], version: library[2] };
+    }
+    if (facts.tracked) {
+        const report = await openSitePage(context, siteUrl, `mod/h5pactivity/report.php?id=${cmid}`);
+        try {
+            activity.attempts = (await readH5PAttempts(report)).sort((a, b) => a.number - b.number);
+        }
+        finally {
+            await report.close().catch(() => undefined);
+        }
+    }
+    return activity;
+}
+//# sourceMappingURL=h5p.js.map

package/dist/moodle/h5p.js.map

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

package/dist/moodle/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/moodle/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/moodle/inPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inPage.js","sourceRoot":"","sources":["../../src/moodle/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/moodle/lesson.d.ts

@@ -0,0 +1,57 @@
+import type { BrowserContext, Page } from "playwright-core";
+import type { Trail } from "../options.js";
+/** The lesson isn't there, or the page can't take that answer. */
+export declare class LessonError extends Error {
+    name: string;
+}
+/** One input of a question page, by its form name. */
+export interface LessonField {
+    name: string;
+    kind: "choice" | "checkbox" | "text" | "select";
+    label?: string;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+}
+export interface LessonPage {
+    /** What the page is: content with buttons, a question, the feedback after an answer, or the lesson's end. */
+    kind: "content" | "question" | "feedback" | "end";
+    /** The page's id; for feedback, the page it goes on to (-9 is the end). */
+    pageId?: number;
+    title?: string;
+    /** The page's text as shown: its content, the question, Moodle's messages, the score at the end. */
+    text: string;
+    /** A content page's buttons, by label, and the page each jumps to (Moodle's jump codes: -1 next, -9 end…). */
+    buttons?: {
+        label: string;
+        jumpTo: number;
+    }[];
+    /** A question page's inputs. */
+    fields?: LessonField[];
+    /** After an answer: whether Moodle took it as right, and the teacher's response to it. */
+    feedback?: {
+        correct?: boolean;
+        response?: string;
+    };
+}
+/** The lesson page on screen, read by its forms and blocks. */
+export declare function readLessonPage(page: Page): Promise<LessonPage>;
+/** The lesson page the person is on (starting the lesson the first time). */
+export declare function lessonPage(context: BrowserContext, siteUrl: string, cmid: number): Promise<LessonPage>;
+/**
+ * Answers the page the person is on: a content page's button (its label or position), or a
+ * question's fields by name. Returns Moodle's feedback when it gives one, and the page that follows,
+ * going on past the feedback as its "Continue" does; reaching the end ends the attempt. With the
+ * realistic trail it first takes the time a reader needs for the page (ADR-005).
+ */
+export declare function answerLessonPage(context: BrowserContext, siteUrl: string, cmid: number, answer: {
+    button?: string | number;
+    responses?: Record<string, string>;
+}, { trail, onProgress }?: {
+    trail?: Trail;
+    onProgress?: (elapsed: number, total: number) => void;
+}): Promise<{
+    feedback?: LessonPage;
+    page: LessonPage;
+}>;

package/dist/moodle/lesson.js

@@ -0,0 +1,140 @@
+import { setFields } from "./forms.js";
+import { inPage } from "./inPage.js";
+import { pause, readingSeconds } from "./pace.js";
+import { openSitePage } from "./session.js";
+/** The lesson isn't there, or the page can't take that answer. */
+export class LessonError extends Error {
+    name = "LessonError";
+}
+/** The lesson page on screen, read by its forms and blocks. */
+export function readLessonPage(page) {
+    return inPage(page, () => {
+        const doc = globalThis.document;
+        const main = doc.querySelector('#region-main [role="main"]') ?? doc.querySelector("#region-main");
+        const text = (el) => (el?.innerText ?? "").replace(/[ \t]+/g, " ").replace(/\n{3,}/g, "\n\n").trim();
+        const title = text(main?.querySelector("h2")) || undefined;
+        const question = main?.querySelector('form.mform[action*="/mod/lesson/continue.php"]');
+        const pageIdOf = (form) => Number(form?.querySelector('input[name="pageid"]')?.getAttribute("value")) || undefined;
+        if (question) {
+            const fields = [];
+            for (const input of Array.from(question.querySelectorAll("input:not([type=hidden]), select, textarea"))) {
+                if (!input.name || input.type === "submit")
+                    continue;
+                const label = text(input.closest("label")) || undefined;
+                if (input.type === "radio") {
+                    let field = fields.find((f) => f.name === input.name);
+                    if (!field) {
+                        field = { name: input.name, kind: "choice", options: [] };
+                        fields.push(field);
+                    }
+                    field.options.push({ value: input.value, label: label ?? input.value });
+                }
+                else if (input.type === "checkbox")
+                    fields.push({ name: input.name, kind: "checkbox", ...(label ? { label } : {}) });
+                else if (input.tagName === "SELECT") {
+                    fields.push({ name: input.name, kind: "select", ...(label ? { label } : {}), options: Array.from(input.options).map((o) => ({ value: o.value, label: o.text.trim() })) });
+                }
+                else
+                    fields.push({ name: input.name, kind: "text", ...(label ? { label } : {}) });
+            }
+            return { kind: "question", pageId: pageIdOf(question), ...(title ? { title } : {}), text: text(question.querySelector(".contents")), fields };
+        }
+        const buttons = Array.from(main?.querySelectorAll('.branchbuttoncontainer form[action*="/mod/lesson/continue.php"]') ?? []);
+        if (buttons.length > 0) {
+            return {
+                kind: "content",
+                pageId: pageIdOf(buttons[0]),
+                ...(title ? { title } : {}),
+                text: text(main?.querySelector(".contents")),
+                buttons: buttons.map((form) => ({ label: text(form.querySelector("button, [type=submit]")), jumpTo: Number(form.querySelector('input[name="jumpto"]')?.getAttribute("value")) })),
+            };
+        }
+        const next = main?.querySelector('form[action*="/mod/lesson/view.php"]');
+        if (next) {
+            const response = main?.querySelector(".response");
+            const correct = response ? (/\bcorrect\b/.test(response.className) ? true : /\bincorrect\b/.test(response.className) ? false : undefined) : undefined;
+            return {
+                kind: "feedback",
+                pageId: pageIdOf(next),
+                text: text(main).replace(text(next), "").trim(),
+                feedback: { ...(correct !== undefined ? { correct } : {}), ...(response ? { response: text(response).replace(/^[^:\n]*:\s*/, "") } : {}) },
+            };
+        }
+        return { kind: "end", ...(title ? { title } : {}), text: text(main) };
+    }, null);
+}
+/** Opens the lesson where the person is: Moodle asks whether to go on from the last page seen, and they do. */
+async function openLesson(context, siteUrl, cmid) {
+    const page = await openSitePage(context, siteUrl, `mod/lesson/view.php?id=${cmid}`);
+    try {
+        if ((await page.locator("body#page-mod-lesson-view").count()) === 0) {
+            throw new LessonError(`Activity ${cmid} isn't a lesson you can open. Take the id of a lesson (module "lesson") from the course structure.`);
+        }
+        const resume = page.locator('#region-main a[href*="startlastseen=yes"]');
+        if ((await resume.count()) > 0)
+            await page.goto((await resume.first().getAttribute("href")), { waitUntil: "domcontentloaded" });
+        return page;
+    }
+    catch (error) {
+        await page.close().catch(() => undefined);
+        throw error;
+    }
+}
+/** The lesson page the person is on (starting the lesson the first time). */
+export async function lessonPage(context, siteUrl, cmid) {
+    const page = await openLesson(context, siteUrl, cmid);
+    try {
+        return await readLessonPage(page);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * Answers the page the person is on: a content page's button (its label or position), or a
+ * question's fields by name. Returns Moodle's feedback when it gives one, and the page that follows,
+ * going on past the feedback as its "Continue" does; reaching the end ends the attempt. With the
+ * realistic trail it first takes the time a reader needs for the page (ADR-005).
+ */
+export async function answerLessonPage(context, siteUrl, cmid, answer, { trail = "realistic", onProgress } = {}) {
+    const page = await openLesson(context, siteUrl, cmid);
+    try {
+        const current = await readLessonPage(page);
+        // What the answer can't be is told before the reading pause, not after it.
+        const buttons = current.buttons ?? [];
+        const index = typeof answer.button === "number" ? answer.button : buttons.findIndex((b) => b.label === answer.button);
+        if (current.kind === "content" && (answer.button === undefined || index < 0 || index >= buttons.length)) {
+            throw new LessonError(`This content page's buttons are: ${buttons.map((b, i) => `${i}: "${b.label}"`).join(", ")}. Give one by label or position.`);
+        }
+        if (current.kind === "question" && (!answer.responses || Object.keys(answer.responses).length === 0)) {
+            throw new LessonError("This page is a question: answer it with its fields' values (responses).");
+        }
+        if (current.kind === "end" || current.kind === "feedback") {
+            throw new LessonError(current.kind === "end" ? "The lesson has ended: there's nothing more to answer." : "This page only goes on: answer the page it leads to.");
+        }
+        if (trail === "realistic") {
+            const seconds = readingSeconds([current.text, ...(current.fields ?? []).flatMap((f) => [f.label ?? "", ...(f.options ?? []).map((o) => o.label)])].join(" "));
+            await pause(seconds, (elapsed) => onProgress?.(elapsed, seconds));
+        }
+        if (current.kind === "content") {
+            await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), page.locator('.branchbuttoncontainer form[action*="/mod/lesson/continue.php"] [type=submit], .branchbuttoncontainer form button').nth(index).click()]);
+        }
+        else {
+            const form = 'form.mform[action*="/mod/lesson/continue.php"]';
+            await setFields(page, answer.responses, form);
+            await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), page.click(`${form} [name="submitbutton"]`)]);
+        }
+        let next = await readLessonPage(page);
+        let feedback;
+        if (next.kind === "feedback") {
+            feedback = next;
+            await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), page.click('#region-main form[action*="/mod/lesson/view.php"] [type=submit], #region-main form[action*="/mod/lesson/view.php"] button')]);
+            next = await readLessonPage(page);
+        }
+        return { ...(feedback ? { feedback } : {}), page: next };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=lesson.js.map

package/dist/moodle/lesson.js.map

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

package/dist/moodle/login.d.ts

@@ -0,0 +1,37 @@
+import type { BrowserContext, Page } from "playwright-core";
+import type { BrowserManager } from "../browser.js";
+export declare class LoginTimeoutError extends Error {
+    name: string;
+}
+export declare class LoginWindowClosedError extends Error {
+    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.
+ */
+export declare function logIn(browser: BrowserManager, siteUrl: string, { timeoutMs, onWait }: {
+    timeoutMs: number;
+    onWait?: (elapsedMs: number) => void;
+}): Promise<LoginResult>;