@falkenslab/moodle-driver 0.0.0-stage → 0.3.1

package/dist/areas/grades/gradebook.js

@@ -0,0 +1,250 @@
+import { callService } from "../../core/ajax.js";
+import { setFields } from "../../core/forms.js";
+import { moodleErrorMessage, openSitePage } from "../../core/session.js";
+import { MoodleError } from "../../core/errors.js";
+/** The gradebook can't be read or changed: not allowed, recalculating, or a value Moodle refuses. */
+export class GradebookError extends MoodleError {
+    name = "GradebookError";
+    constructor(message) {
+        super(message, "gradebook");
+    }
+}
+/** Moodle's aggregations by their constant (GRADE_AGGREGATE_*). */
+const AGGREGATION_CODES = {
+    mean: 0,
+    median: 2,
+    lowest: 4,
+    highest: 6,
+    mode: 8,
+    "weighted-mean": 10,
+    "simple-weighted-mean": 11,
+    "mean-with-extra-credits": 12,
+    natural: 13,
+};
+export const GRADE_AGGREGATIONS = Object.keys(AGGREGATION_CODES);
+/** One page of the grader report, by data attributes and links, in any language. */
+export function readGraderReport(page) {
+    return page.evaluate(() => {
+        const doc = globalThis.document;
+        const columns = Array.from(doc.querySelectorAll("table#user-grades tr.heading th[data-itemid]")).map((th) => {
+            const header = th.querySelector(".gradeitemheader");
+            const copy = header?.cloneNode(true);
+            for (const extra of Array.from(copy?.querySelectorAll("img, .visually-hidden") ?? []))
+                extra.remove();
+            const match = /\/mod\/([a-z0-9_]+)\/view\.php\?(?:.*&)?id=(\d+)/.exec(header?.getAttribute("href") ?? "");
+            const kind = /\bcourseitem\b/.test(th.className) ? "course" : /\bcategoryitem\b/.test(th.className) ? "category" : "item";
+            return {
+                id: Number(th.getAttribute("data-itemid")),
+                name: (copy?.textContent ?? "").replace(/\s+/g, " ").trim(),
+                kind,
+                ...(match ? { activityId: Number(match[2]), activityType: match[1] } : {}),
+            };
+        });
+        const rows = Array.from(doc.querySelectorAll("table#user-grades tr.userrow[data-uid]")).map((row) => {
+            const link = row.querySelector("a.username")?.cloneNode(true);
+            for (const extra of Array.from(link?.querySelectorAll(".userinitials, img, .visually-hidden") ?? []))
+                extra.remove();
+            const grades = Array.from(row.querySelectorAll("td.gradecell[data-itemid]")).map((cell) => {
+                const value = (cell.querySelector(".gradevalue")?.textContent ?? "").replace(/\s+/g, " ").trim();
+                return { itemId: Number(cell.getAttribute("data-itemid")), ...(value && value !== "-" ? { grade: value } : {}) };
+            });
+            return { userId: Number(row.getAttribute("data-uid")), fullName: (link?.textContent ?? "").replace(/\s+/g, " ").trim(), grades };
+        });
+        return { columns, rows };
+    });
+}
+const MAX_PAGES = 100;
+/**
+ * Everyone's grades in a course as the grader report shows them, page by page, in one group when
+ * given. People come as user id and full name only.
+ */
+export async function graderReport(context, siteUrl, courseId, { group } = {}) {
+    const report = { columns: [], rows: [] };
+    const seen = new Set();
+    for (let p = 0; p < MAX_PAGES; p++) {
+        const page = await openSitePage(context, siteUrl, `grade/report/grader/index.php?id=${courseId}&page=${p}${group ? `&group=${group}` : ""}`);
+        try {
+            const refused = await moodleErrorMessage(page);
+            if (refused !== undefined || (await page.locator("body#page-grade-report-grader-index").count()) === 0) {
+                throw new GradebookError(`You can't see course ${courseId}'s grader report: ${refused ?? "the course doesn't exist, or you aren't allowed"}`);
+            }
+            // Moodle shows a progress bar instead while it recalculates grades (deleted activities, changed weights).
+            if ((await page.locator("table#user-grades").count()) === 0) {
+                throw new GradebookError(`Course ${courseId}'s grader report isn't available now: Moodle may be recalculating its grades. Try again in a moment.`);
+            }
+            const read = await readGraderReport(page);
+            if (p === 0)
+                report.columns = read.columns;
+            const fresh = read.rows.filter((row) => !seen.has(row.userId));
+            if (fresh.length === 0)
+                break;
+            for (const row of fresh)
+                seen.add(row.userId);
+            report.rows.push(...fresh);
+        }
+        finally {
+            await page.close().catch(() => undefined);
+        }
+    }
+    return report;
+}
+/** The gradebook setup page's rows, by data attributes and field names. */
+export function readGradebookSetup(page) {
+    return page.evaluate((codes) => {
+        const doc = globalThis.document;
+        const names = Object.fromEntries(Object.entries(codes).map(([name, code]) => [String(code), name]));
+        const categories = [];
+        const items = [];
+        for (const row of Array.from(doc.querySelectorAll("#grade_edit_tree_table tr[data-itemid]"))) {
+            const itemId = Number(row.getAttribute("data-itemid"));
+            const name = (row.querySelector(".rowtitle")?.textContent ?? "").replace(/\s+/g, " ").trim();
+            const parent = Number((row.getAttribute("data-parent-category") ?? "").replace(/^cg/, "")) || undefined;
+            const max = Number(row.getAttribute("data-grademax"));
+            const weightField = row.querySelector(`input[type="text"][name="weight_${itemId}"]`);
+            const weight = weightField && weightField.value !== "" ? Number(weightField.value) : undefined;
+            const category = row.getAttribute("data-category");
+            if (category) {
+                const aggregation = names[row.getAttribute("data-aggregation") ?? ""];
+                categories.push({
+                    id: Number(category.replace(/^cg/, "")),
+                    itemId,
+                    name,
+                    ...(parent ? { parentId: parent } : {}),
+                    ...(aggregation ? { aggregation: aggregation } : {}),
+                    ...(max > 0 ? { maxGrade: max } : {}),
+                    ...(weight !== undefined ? { weight } : {}),
+                });
+            }
+            else {
+                // The item's icon comes from its module's theme folder, or core's for a manual item.
+                const icon = /image\.php\/[^/]+\/([a-z0-9_]+)\//.exec(row.querySelector("img.itemicon")?.getAttribute("src") ?? "")?.[1];
+                items.push({
+                    id: itemId,
+                    name,
+                    ...(parent ? { categoryId: parent } : {}),
+                    type: !icon || icon === "core" ? "manual" : icon,
+                    ...(max > 0 ? { maxGrade: max } : {}),
+                    ...(weight !== undefined ? { weight } : {}),
+                    weightOverridden: row.querySelector(`input[type="checkbox"][name="weightoverride_${itemId}"]`)?.checked ?? false,
+                });
+            }
+        }
+        return { categories, items };
+    }, AGGREGATION_CODES);
+}
+/** A course's gradebook setup: its categories (aggregation, weights) and grade items (category, maximum, weight). */
+export async function gradebookSetup(context, siteUrl, courseId) {
+    const page = await openSitePage(context, siteUrl, `grade/edit/tree/index.php?id=${courseId}`);
+    try {
+        if ((await page.locator("body#page-grade-edit-tree-index #grade_edit_tree_table").count()) === 0) {
+            throw new GradebookError(`You can't see course ${courseId}'s gradebook setup: ${(await moodleErrorMessage(page)) ?? "the course doesn't exist, or you aren't allowed to manage its grades"}`);
+        }
+        const setup = await readGradebookSetup(page);
+        // Category and course totals are their categories' own items, not items of their own.
+        const totals = new Set(setup.categories.map((c) => c.itemId));
+        return { categories: setup.categories, items: setup.items.filter((item) => !totals.has(item.id)) };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * Fills one of Moodle's dynamic forms (core_form_dynamic_form) as its modal does: rendered by the
+ * service, filled in a blank tab, serialized and sent back. Throws `GradebookError` with Moodle's
+ * messages when it comes back unsubmitted; `prepare` can check the form before it's filled.
+ */
+async function submitDynamicForm(context, siteUrl, form, params, values, prepare) {
+    const formdata = new URLSearchParams(Object.entries(params).map(([key, value]) => [key, String(value)])).toString();
+    const rendered = await callService(context, siteUrl, "core_form_dynamic_form", { form, formdata });
+    const page = await context.newPage();
+    try {
+        await page.setContent(rendered.html);
+        await prepare?.(page);
+        await setFields(page, values);
+        const serialized = await page.evaluate(() => {
+            const g = globalThis;
+            return new g.URLSearchParams(new g.FormData(g.document.querySelector("form.mform"))).toString();
+        });
+        const answer = await callService(context, siteUrl, "core_form_dynamic_form", { form, formdata: serialized });
+        if (answer.submitted)
+            return;
+        // Back unsubmitted: the form again, with its errors (ids carry a random suffix).
+        await page.setContent(answer.html);
+        const errors = await page.evaluate(() => Array.from(globalThis.document.querySelectorAll('[id^="id_error_"]'))
+            .map((element) => ({ field: element.id.slice("id_error_".length).replace(/_[A-Za-z0-9]{15}$/, ""), message: (element.textContent ?? "").replace(/\s+/g, " ").trim() }))
+            .filter((error) => error.message !== ""));
+        throw new GradebookError(`Moodle refused the form: ${errors.map((e) => `${e.field}: ${e.message}`).join("; ") || "no reason given"}.`);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** Moves a grade item (`ig<id>`) or category (`cg<id>`) to the start of a category, as the setup page's "Move" does. */
+async function moveIntoCategory(context, siteUrl, courseId, element, categoryId) {
+    const page = await openSitePage(context, siteUrl, `grade/edit/tree/index.php?id=${courseId}`);
+    try {
+        const sesskey = await page.evaluate(() => globalThis.M.cfg.sesskey);
+        const move = `grade/edit/tree/index.php?id=${courseId}&action=move&eid=${element}&moveafter=cg${categoryId}&first=1&sesskey=${sesskey}`;
+        await page.goto(new URL(move, siteUrl).href, { waitUntil: "domcontentloaded" });
+        if ((await page.locator("#grade_edit_tree_table").count()) === 0) {
+            throw new GradebookError(`Moodle didn't move ${element.startsWith("cg") ? "category" : "item"} ${element.slice(2)} into category ${categoryId}: check both ids in the gradebook setup.`);
+        }
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * Changes a grade item: moves it into a category, sets its weight (percent, overriding Natural's
+ * automatic one), or its maximum grade (a manual item's; an activity's is set in the activity).
+ * Returns the item afterwards.
+ */
+export async function updateGradeItem(context, siteUrl, courseId, itemId, { category, weight, maxGrade }) {
+    if (category !== undefined)
+        await moveIntoCategory(context, siteUrl, courseId, `ig${itemId}`, category);
+    if (weight !== undefined || maxGrade !== undefined) {
+        const values = {};
+        if (weight !== undefined)
+            Object.assign(values, { weightoverride: 1, aggregationcoef2: weight });
+        if (maxGrade !== undefined)
+            values.grademax = maxGrade;
+        await submitDynamicForm(context, siteUrl, "core_grades\\form\\add_item", { courseid: courseId, itemid: itemId }, values, async (page) => {
+            const fields = await page.evaluate(() => {
+                const doc = globalThis.document;
+                const max = doc.querySelector('[name="grademax"]');
+                return { maxEditable: max !== null && !max.disabled, weight: doc.querySelector('[name="aggregationcoef2"]') !== null };
+            });
+            if (maxGrade !== undefined && !fields.maxEditable) {
+                throw new GradebookError(`Item ${itemId} belongs to an activity: its maximum grade is set in the activity's settings, not in the gradebook.`);
+            }
+            if (weight !== undefined && !fields.weight)
+                throw new GradebookError(`Item ${itemId}'s category doesn't aggregate with weights that can be set (Natural): change its aggregation first.`);
+        });
+    }
+    const done = [category !== undefined && `moved into category ${category}`, weight !== undefined && `weighted ${weight}%`, maxGrade !== undefined && `out of ${maxGrade}`].filter(Boolean);
+    const item = (await gradebookSetup(context, siteUrl, courseId)).items.find((i) => i.id === itemId);
+    return { changed: done.length > 0 ? `Grade item ${itemId} ${done.join(", ")}.` : "Nothing to change.", item };
+}
+/** Adds a grade category (at the course's top level, or inside `parentId`); returns it as the setup shows it. */
+export async function addGradeCategory(context, siteUrl, courseId, { name, aggregation, parentId }) {
+    const before = new Set((await gradebookSetup(context, siteUrl, courseId)).categories.map((c) => c.id));
+    const values = { fullname: name };
+    if (aggregation !== undefined)
+        values.aggregation = AGGREGATION_CODES[aggregation];
+    await submitDynamicForm(context, siteUrl, "core_grades\\form\\add_category", { courseid: courseId }, values, async (page) => {
+        if (aggregation === undefined)
+            return;
+        const offered = await page.evaluate(() => Array.from(globalThis.document.querySelectorAll('[name="aggregation"] option')).map((o) => o.value));
+        if (!offered.includes(String(AGGREGATION_CODES[aggregation]))) {
+            const available = GRADE_AGGREGATIONS.filter((a) => offered.includes(String(AGGREGATION_CODES[a])));
+            throw new GradebookError(`The site doesn't offer the ${aggregation} aggregation; it offers: ${available.join(", ")}.`);
+        }
+    });
+    let created = (await gradebookSetup(context, siteUrl, courseId)).categories.find((c) => !before.has(c.id));
+    if (created && parentId !== undefined) {
+        await moveIntoCategory(context, siteUrl, courseId, `cg${created.id}`, parentId);
+        created = (await gradebookSetup(context, siteUrl, courseId)).categories.find((c) => c.id === created.id);
+    }
+    return { changed: `Grade category ${created?.id ?? "?"} "${name}" added${parentId !== undefined ? ` in category ${parentId}` : ""}.`, category: created };
+}
+//# sourceMappingURL=gradebook.js.map

package/dist/areas/grades/gradebook.js.map

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

package/dist/areas/grades/user-report.d.ts

@@ -0,0 +1,26 @@
+import type { BrowserContext, Page } from "playwright-core";
+import { MoodleError } from "../../core/errors.js";
+/** A row of the user grade report, values as Moodle shows them ("-" left out). */
+export interface GradeRow {
+    /** A category's total row is "categoryTotal"; the course's, "courseTotal". */
+    kind: "item" | "category" | "categoryTotal" | "courseTotal";
+    name: string;
+    activityId?: number;
+    activityType?: string;
+    grade?: string;
+    range?: string;
+    percentage?: string;
+    weight?: string;
+    letter?: string;
+    feedback?: string;
+    contribution?: string;
+}
+/** The person can't see the grade report of that course. */
+export declare class NoGradeReportError extends MoodleError {
+    name: string;
+    constructor(message: string);
+}
+/** The rows of `table.user-grade`, by cell classes, never by header texts (ADR-004). */
+export declare function readGradeRows(page: Page): Promise<GradeRow[]>;
+/** The person's own grade report for a course. */
+export declare function myGrades(context: BrowserContext, siteUrl: string, courseId: number): Promise<GradeRow[]>;

package/dist/areas/grades/user-report.js

@@ -0,0 +1,71 @@
+import { openSitePage } from "../../core/session.js";
+import { MoodleError } from "../../core/errors.js";
+/** The person can't see the grade report of that course. */
+export class NoGradeReportError extends MoodleError {
+    name = "NoGradeReportError";
+    constructor(message) {
+        super(message, "no-grade-report");
+    }
+}
+/** The rows of `table.user-grade`, by cell classes, never by header texts (ADR-004). */
+export function readGradeRows(page) {
+    return page.evaluate(() => {
+        const doc = globalThis.document;
+        const rows = Array.from(doc.querySelectorAll("table.user-grade tr"));
+        const result = [];
+        for (const row of rows) {
+            const nameCell = row.querySelector(".column-itemname");
+            if (!nameCell || row.querySelector("th.column-itemname[scope='col'], thead"))
+                continue;
+            const classes = nameCell.className;
+            // Both totals are "baggt" rows; a category's holds a categoryitem block (confirmed empirically, Moodle 5.2).
+            const total = nameCell.querySelector(".categoryitem") ? "categoryTotal" : "courseTotal";
+            const kind = /\bbaggt\b/.test(classes) ? total : /\bcategory\b/.test(classes) ? "category" : /\bitem\b/.test(classes) ? "item" : undefined;
+            if (!kind)
+                continue;
+            const values = {};
+            for (const column of ["grade", "range", "percentage", "weight", "lettergrade", "feedback", "contributiontocoursetotal"]) {
+                const cell = row.querySelector(`.column-${column}`);
+                if (!cell)
+                    continue;
+                // The grade cell also holds an action menu whose text is in the site's language.
+                const copy = cell.cloneNode(true);
+                for (const menu of Array.from(copy.querySelectorAll(".action-menu, .dropdown, .visually-hidden")))
+                    menu.remove();
+                const text = (copy.textContent ?? "").replace(/\s+/g, " ").trim();
+                values[column] = text === "" || text === "-" ? undefined : text;
+            }
+            const link = nameCell.querySelector('a[href*="/mod/"][href*="view.php"]');
+            const href = link?.getAttribute("href") ?? "";
+            const match = /\/mod\/([a-z0-9_]+)\/view\.php\?(?:.*&)?id=(\d+)/.exec(href);
+            result.push({
+                kind,
+                name: ((nameCell.querySelector(".rowtitle") ?? nameCell).textContent ?? "").replace(/\s+/g, " ").trim(),
+                activityId: match ? Number(match[2]) : undefined,
+                activityType: match ? match[1] : undefined,
+                grade: values.grade,
+                range: values.range,
+                percentage: values.percentage,
+                weight: values.weight,
+                letter: values.lettergrade,
+                feedback: values.feedback,
+                contribution: values.contributiontocoursetotal,
+            });
+        }
+        return result;
+    });
+}
+/** The person's own grade report for a course. */
+export async function myGrades(context, siteUrl, courseId) {
+    const page = await openSitePage(context, siteUrl, `grade/report/user/index.php?id=${courseId}`);
+    try {
+        if ((await page.locator("body#page-grade-report-user-index table.user-grade").count()) === 0) {
+            throw new NoGradeReportError(`There's no grade report of yours to read in course ${courseId}: the course doesn't exist, you aren't graded there, or grades are hidden.`);
+        }
+        return await readGradeRows(page);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=user-report.js.map

package/dist/areas/grades/user-report.js.map

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

package/dist/areas/h5p/h5p.d.ts

@@ -0,0 +1,33 @@
+import type { BrowserContext, Page } from "playwright-core";
+import { MoodleError } from "../../core/errors.js";
+/** The activity isn't an H5P activity the person can open. */
+export declare class NotAnH5PActivityError extends MoodleError {
+    name: string;
+    constructor(message: string);
+}
+export interface H5PAttempt {
+    /** Moodle's id for the attempt (its report's), and its number for the person. */
+    id?: 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, activityId: number): Promise<H5PActivity>;

package/dist/areas/h5p/h5p.js

@@ -0,0 +1,104 @@
+import { inPage } from "../../core/inPage.js";
+import { openSitePage } from "../../core/session.js";
+import { decodeEntities } from "../../core/text.js";
+import { MoodleError } from "../../core/errors.js";
+/** The activity isn't an H5P activity the person can open. */
+export class NotAnH5PActivityError extends MoodleError {
+    name = "NotAnH5PActivityError";
+    constructor(message) {
+        super(message, "not-an-h5p-activity");
+    }
+}
+/** 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) ? { id: 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, activityId) {
+    const page = await openSitePage(context, siteUrl, `mod/h5pactivity/view.php?id=${activityId}`);
+    let facts;
+    try {
+        if ((await page.locator("body#page-mod-h5pactivity-view").count()) === 0) {
+            throw new NotAnH5PActivityError(`Activity ${activityId} 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: activityId, 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=${activityId}`);
+        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/areas/h5p/h5p.js.map

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

package/dist/areas/lessons/lessons.d.ts

@@ -0,0 +1,60 @@
+import type { BrowserContext, Page } from "playwright-core";
+import type { Trail } from "../../options.js";
+import { MoodleError } from "../../core/errors.js";
+/** The lesson isn't there, or the page can't take that answer. */
+export declare class LessonError extends MoodleError {
+    name: string;
+    constructor(message: 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, activityId: 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, activityId: number, answer: {
+    button?: string | number;
+    responses?: Record<string, string>;
+}, { trail, onProgress }?: {
+    trail?: Trail;
+    onProgress?: (elapsed: number, total: number) => void;
+}): Promise<{
+    changed: string;
+    feedback?: LessonPage;
+    page: LessonPage;
+}>;