@falkenslab/moodle-driver 0.0.0-stage → 0.3.1

package/dist/moodle/assign.js

@@ -0,0 +1,162 @@
+import { callService } from "./ajax.js";
+import { setFields } from "./forms.js";
+import { openSitePage } from "./session.js";
+/** The id isn't an assignment's course module, or the person can't grade it. */
+export class NotAnAssignmentError extends Error {
+    name = "NotAnAssignmentError";
+}
+// Ids never change for a course module: one grader page per assignment and site, for the process.
+const idCache = new Map();
+/** Reads `data-assignmentid` and `data-contextid` from a page (the grader's), or `undefined`. */
+export function readAssignmentIds(page) {
+    return page.evaluate(() => {
+        const g = globalThis;
+        const element = g.document.querySelector("[data-assignmentid][data-contextid]");
+        const instanceId = Number(element?.getAttribute("data-assignmentid"));
+        const contextId = Number(element?.getAttribute("data-contextid"));
+        return instanceId > 0 && contextId > 0 ? { instanceId, contextId } : undefined;
+    });
+}
+export async function assignmentIds(context, siteUrl, cmid) {
+    const key = `${siteUrl}|${cmid}`;
+    const cached = idCache.get(key);
+    if (cached)
+        return cached;
+    const page = await openSitePage(context, siteUrl, `mod/assign/view.php?id=${cmid}&action=grader`);
+    try {
+        const ids = await readAssignmentIds(page);
+        if (!ids)
+            throw new NotAnAssignmentError(`Activity ${cmid} isn't an assignment you can grade (its grader page has no assignment). Take the id of an assignment (module "assign").`);
+        idCache.set(key, ids);
+        return ids;
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+export function listParticipants(context, siteUrl, instanceId) {
+    return callService(context, siteUrl, "mod_assign_list_participants", {
+        assignid: instanceId,
+        groupid: 0,
+        filter: "",
+        skip: 0,
+        limit: 0,
+        onlyids: false,
+        includeenrolments: false,
+        tablesort: false,
+    });
+}
+export function participantDates(context, siteUrl, instanceId, userId) {
+    return callService(context, siteUrl, "mod_assign_get_participant", { assignid: instanceId, userid: userId, embeduser: false });
+}
+/**
+ * The content of a submission as the grader's panel renders it: per plugin, the full block
+ * (`.full_assignsubmission_<plugin>_<sid>`) or, for content short enough to have none, the summary
+ * one. Parsed in the page, by class only (ADR-004). The comments plugin isn't the submission.
+ */
+export function readSubmissionContent(page, html) {
+    return page.evaluate((html) => {
+        const g = globalThis;
+        const doc = new g.DOMParser().parseFromString(html, "text/html");
+        const BLOCKS = new Set(["P", "DIV", "LI", "UL", "OL", "TR", "TABLE", "PRE", "BLOCKQUOTE", "H1", "H2", "H3", "H4", "H5", "H6"]);
+        const found = new Map();
+        for (const element of Array.from(doc.querySelectorAll('[class*="assignsubmission_"]'))) {
+            const match = /\b(full|summary)_assignsubmission_([a-z0-9]+)_(\d+)\b/.exec(element.className);
+            if (!match || match[2] === "comments")
+                continue;
+            const key = `${match[2]}_${match[3]}`;
+            const entry = found.get(key) ?? { plugin: match[2] };
+            entry[match[1]] = element;
+            found.set(key, entry);
+        }
+        return Array.from(found.values()).map(({ plugin, full, summary }) => {
+            const block = (full ?? summary);
+            for (const control of Array.from(block.querySelectorAll(".expandsummaryicon, script, style")))
+                control.remove();
+            const files = Array.from(block.querySelectorAll('a[href*="pluginfile.php"]')).map((a) => ({ name: (a.textContent ?? "").trim(), url: a.getAttribute("href") ?? "" }));
+            // Depth first with a stack, not a named recursive function: tsx's keepNames would wrap it in a
+            // `__name` helper the page doesn't have (confirmed empirically).
+            let raw = "";
+            const stack = [block];
+            while (stack.length > 0) {
+                const item = stack.pop();
+                if (typeof item === "string")
+                    raw += item;
+                else if (item.nodeType === 3)
+                    raw += (item.textContent ?? "").replace(/\s+/g, " ");
+                else if (item.nodeName === "BR")
+                    raw += "\n";
+                else if (item.nodeName === "PRE")
+                    raw += `\n${item.textContent ?? ""}\n`;
+                else {
+                    const isBlock = BLOCKS.has(item.nodeName);
+                    raw += item.nodeName === "LI" ? "\n- " : isBlock ? "\n" : "";
+                    // A list item ends where the next one starts: no blank line between items.
+                    stack.push(isBlock && item.nodeName !== "LI" ? "\n" : "", ...Array.from(item.childNodes).reverse());
+                }
+            }
+            const text = raw
+                .replace(/[ \t]+\n/g, "\n")
+                .replace(/\n[ \t]+/g, "\n")
+                .replace(/\n- +/g, "\n- ")
+                .replace(/\n{3,}/g, "\n\n")
+                .trim();
+            return { plugin, text, files };
+        });
+    }, html);
+}
+/** The grader panel's HTML for one participant: their current submission and grade form. */
+export async function gradingPanelHtml(context, siteUrl, contextId, userId) {
+    const fragment = await callService(context, siteUrl, "core_get_fragment", {
+        component: "mod_assign",
+        callback: "gradingpanel",
+        contextid: contextId,
+        args: [
+            { name: "userid", value: String(userId) },
+            { name: "attemptnumber", value: "-1" },
+            { name: "jsonformdata", value: '""' },
+        ],
+    });
+    return fragment.html;
+}
+/** Moodle's grader didn't take the grade. */
+export class GradingError extends Error {
+    name = "GradingError";
+}
+/**
+ * Fills the grading panel's form for one participant in `page` (a blank tab), and returns it
+ * serialized as the grader does (`form.serialize()`), ready for `mod_assign_submit_grading_form`.
+ */
+export async function fillGradingForm(page, panelHtml, fields) {
+    await page.setContent(panelHtml);
+    await setFields(page, fields);
+    return page.evaluate(() => {
+        const g = globalThis;
+        return new g.URLSearchParams(new g.FormData(g.document.querySelector("form.gradeform"))).toString();
+    });
+}
+/** The grade and feedback currently in a grading panel, if any. */
+export async function panelGrade(page, panelHtml) {
+    await page.setContent(panelHtml);
+    return page.evaluate(() => {
+        const doc = globalThis.document;
+        const grade = doc.querySelector('form.gradeform [name="grade"]')?.value;
+        const feedback = doc.querySelector('form.gradeform [name="assignfeedbackcomments_editor[text]"]')?.value;
+        // "Current grade in gradebook": the total Moodle computed, also for a rubric or a guide.
+        const gradebook = (doc.querySelector('form.gradeform [id^="fitem_id_currentgrade"] .felement')?.textContent ?? "").replace(/\s+/g, " ").trim();
+        return { grade: grade || undefined, ...(gradebook && gradebook !== "-" ? { gradebookGrade: gradebook } : {}), feedback: feedback || undefined };
+    });
+}
+/** Submits a serialized grading form; Moodle answers warnings when it refuses it. */
+export async function submitGradingForm(context, siteUrl, instanceId, userId, serialized) {
+    const warnings = await callService(context, siteUrl, "mod_assign_submit_grading_form", {
+        assignmentid: instanceId,
+        userid: userId,
+        jsonformdata: JSON.stringify(serialized),
+    });
+    if (warnings.length > 0) {
+        // Moodle's form messages don't reach the service's warnings: a grade out of range only says it couldn't save.
+        throw new GradingError(`Moodle didn't save the grade: ${warnings.map((w) => w.message ?? w.warningcode).join("; ")} Check the grade is within the assignment's range or scale, and the fields' names.`);
+    }
+}
+//# sourceMappingURL=assign.js.map

package/dist/moodle/assign.js.map

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

package/dist/moodle/calendar.d.ts

@@ -0,0 +1,41 @@
+import type { BrowserContext } from "playwright-core";
+/** Moodle refused the event, or it isn't there. */
+export declare class CalendarError extends Error {
+    name: string;
+}
+export interface CalendarEvent {
+    id: number;
+    name: string;
+    /** The event's kind: "course", "group", "user", or an activity's ("due", "open"…). */
+    type: string;
+    start: string;
+    durationMinutes?: number;
+    courseId?: number;
+    /** For an activity's event, its module and instance. */
+    activity?: {
+        type: string;
+        instance: number;
+    };
+}
+/** The person's upcoming events, as the calendar's "Upcoming events" view lists them, in one course or all. */
+export declare function upcomingEvents(context: BrowserContext, siteUrl: string, { courseId }?: {
+    courseId?: number;
+}): Promise<CalendarEvent[]>;
+/**
+ * Creates a course event, through the calendar's own form: its start, and its duration and
+ * description when given. Returns it as the calendar has it.
+ */
+export declare function createEvent(context: BrowserContext, siteUrl: string, { courseId, name, start, durationMinutes, description }: {
+    courseId: number;
+    name: string;
+    start: Date;
+    durationMinutes?: number;
+    description?: string;
+}): Promise<{
+    changed: string;
+    event: CalendarEvent;
+}>;
+/** Deletes a calendar event the person can manage. */
+export declare function deleteEvent(context: BrowserContext, siteUrl: string, eventId: number): Promise<{
+    changed: string;
+}>;

package/dist/moodle/calendar.js

@@ -0,0 +1,80 @@
+import { MoodleServiceError, callService } from "./ajax.js";
+import { isoDate } from "./courses.js";
+import { setFields } from "./forms.js";
+import { decodeEntities } from "./text.js";
+/** Moodle refused the event, or it isn't there. */
+export class CalendarError extends Error {
+    name = "CalendarError";
+}
+function toEvent(raw) {
+    return {
+        id: raw.id,
+        name: decodeEntities(raw.name),
+        type: raw.eventtype,
+        start: isoDate(raw.timestart),
+        ...(raw.timeduration > 0 ? { durationMinutes: Math.round(raw.timeduration / 60) } : {}),
+        ...(raw.course ? { courseId: raw.course.id } : {}),
+        ...(raw.modulename && raw.instance ? { activity: { type: raw.modulename, instance: raw.instance } } : {}),
+    };
+}
+/** The person's upcoming events, as the calendar's "Upcoming events" view lists them, in one course or all. */
+export async function upcomingEvents(context, siteUrl, { courseId } = {}) {
+    // Course 1 is the site: every course the person is in.
+    const { events } = await callService(context, siteUrl, "core_calendar_get_calendar_upcoming_view", { courseid: courseId ?? 1, categoryid: 0 });
+    return events.map(toEvent);
+}
+/**
+ * Creates a course event, through the calendar's own form: its start, and its duration and
+ * description when given. Returns it as the calendar has it.
+ */
+export async function createEvent(context, siteUrl, { courseId, name, start, durationMinutes, description }) {
+    // The form takes its start as the time it's opened for: no date fields to fill in the person's time zone.
+    const fragment = await callService(context, siteUrl, "core_get_fragment", {
+        component: "core_calendar",
+        callback: "event_form",
+        contextid: 1,
+        args: [
+            { name: "courseid", value: String(courseId) },
+            { name: "starttime", value: String(Math.floor(start.getTime() / 1000)) },
+        ],
+    });
+    const page = await context.newPage();
+    let formdata;
+    try {
+        await page.setContent(fragment.html);
+        const types = await page.evaluate(() => Array.from(globalThis.document.querySelectorAll('form [name="eventtype"] option')).map((o) => o.value));
+        if (!types.includes("course"))
+            throw new CalendarError(`You can't add events to course ${courseId}'s calendar.`);
+        const values = { name, eventtype: "course", courseid: String(courseId) };
+        if (durationMinutes !== undefined)
+            Object.assign(values, { duration: 2, timedurationminutes: durationMinutes });
+        if (description !== undefined)
+            values["description[text]"] = description;
+        await setFields(page, values, "form");
+        formdata = await page.evaluate(() => {
+            const g = globalThis;
+            return new g.URLSearchParams(new g.FormData(g.document.querySelector("form"))).toString();
+        });
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+    const answer = await callService(context, siteUrl, "core_calendar_submit_create_update_form", { formdata });
+    if (!answer.event || answer.validationerror)
+        throw new CalendarError(`Moodle refused the event "${name}": check its name, start and duration.`);
+    const event = toEvent(answer.event);
+    return { changed: `Event ${event.id} "${event.name}" added to course ${courseId}'s calendar.`, event };
+}
+/** Deletes a calendar event the person can manage. */
+export async function deleteEvent(context, siteUrl, eventId) {
+    try {
+        await callService(context, siteUrl, "core_calendar_delete_calendar_events", { events: [{ eventid: eventId, repeat: false }] });
+    }
+    catch (error) {
+        if (error instanceof MoodleServiceError && /^invalidrecord/.test(error.errorcode))
+            throw new CalendarError(`There's no calendar event ${eventId}: it was deleted, or never existed.`);
+        throw error;
+    }
+    return { changed: `Event ${eventId} deleted.` };
+}
+//# sourceMappingURL=calendar.js.map

package/dist/moodle/calendar.js.map

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

package/dist/moodle/choice.d.ts

@@ -0,0 +1,33 @@
+import type { BrowserContext, Page } from "playwright-core";
+/** The choice isn't there, or the person can't answer it now. */
+export declare class ChoiceError extends Error {
+    name: string;
+}
+export interface Choice {
+    id: number;
+    name: string;
+    intro: string;
+    /** The options with the ids answers take; full ones can't be chosen. */
+    options: {
+        id: number;
+        text: string;
+        selected: boolean;
+        full: boolean;
+    }[];
+    /** Several options at once. */
+    multiple: boolean;
+    /** The form is there: the choice is open and the person may answer (or change their answer). */
+    canAnswer: boolean;
+    /** Whether a given answer can be removed or changed. */
+    canChange: boolean;
+    /** The options chosen, as the page names them, also where the form is gone. */
+    answer: string[];
+    /** The page's notices: closed, not open yet, results not published… */
+    messages: string[];
+}
+/** The choice page, by its form's inputs and the selection block. */
+export declare function readChoice(page: Page): Promise<Omit<Choice, "id">>;
+/** A choice: its options, whether it can be answered or changed, and the person's answer. */
+export declare function getChoice(context: BrowserContext, siteUrl: string, cmid: number): Promise<Choice>;
+/** Answers a choice with one option (several where it allows them) by id, as "Save my choice" does; returns the choice afterwards. */
+export declare function answerChoice(context: BrowserContext, siteUrl: string, cmid: number, optionIds: number[]): Promise<Choice>;

package/dist/moodle/choice.js

@@ -0,0 +1,100 @@
+import { inPage } from "./inPage.js";
+import { openSitePage } from "./session.js";
+/** The choice isn't there, or the person can't answer it now. */
+export class ChoiceError extends Error {
+    name = "ChoiceError";
+}
+/** The choice page, by its form's inputs and the selection block. */
+export function readChoice(page) {
+    // Through inPage: it has a helper function (see the conventions on page.evaluate).
+    return inPage(page, () => {
+        const doc = globalThis.document;
+        const text = (el) => (el?.innerText ?? "").replace(/\s+/g, " ").trim();
+        const form = doc.querySelector('#region-main form[action*="/mod/choice/view.php"]');
+        const inputs = Array.from(form?.querySelectorAll('input[name="answer"], input[name="answer[]"]') ?? []);
+        const options = inputs.map((input) => ({
+            id: Number(input.value),
+            text: text(doc.querySelector(`label[for="${input.id}"]`)),
+            selected: input.checked,
+            full: input.disabled,
+        }));
+        // "Your selection: while" (several joined with "; ")? The label before the colon is the site's language.
+        const selection = text(doc.querySelector("#yourselection"));
+        const fromBlock = selection.includes(":") ? selection.slice(selection.indexOf(":") + 1).split(/;\s*/).map((s) => s.trim()).filter(Boolean) : [];
+        return {
+            name: doc.querySelector("[data-activityname]")?.getAttribute("data-activityname") ?? "",
+            intro: text(doc.querySelector(".activity-description, #intro")),
+            options,
+            multiple: inputs.some((input) => input.type === "checkbox"),
+            canAnswer: form !== null && options.length > 0,
+            canChange: doc.querySelector('#region-main a[href*="action=delchoice"]') !== null,
+            answer: options.some((o) => o.selected) ? options.filter((o) => o.selected).map((o) => o.text) : fromBlock,
+            messages: Array.from(doc.querySelectorAll("#region-main .alert, #region-main .generalbox"))
+                .filter((box) => box.id !== "yourselection" && !box.querySelector("form"))
+                .map((box) => {
+                // Without the notification's close button, whose label is in the site's language.
+                const copy = box.cloneNode(true);
+                for (const extra of Array.from(copy.querySelectorAll("button, .visually-hidden")))
+                    extra.remove();
+                return (copy.textContent ?? "").replace(/\s+/g, " ").trim();
+            })
+                .filter(Boolean),
+        };
+    }, null);
+}
+async function openChoice(context, siteUrl, cmid) {
+    const page = await openSitePage(context, siteUrl, `mod/choice/view.php?id=${cmid}`);
+    if ((await page.locator("body#page-mod-choice-view").count()) === 0) {
+        await page.close().catch(() => undefined);
+        throw new ChoiceError(`Activity ${cmid} isn't a choice you can open. Take the id of a choice (module "choice") from the course structure.`);
+    }
+    return page;
+}
+/** A choice: its options, whether it can be answered or changed, and the person's answer. */
+export async function getChoice(context, siteUrl, cmid) {
+    const page = await openChoice(context, siteUrl, cmid);
+    try {
+        return { id: cmid, ...(await readChoice(page)) };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** Answers a choice with one option (several where it allows them) by id, as "Save my choice" does; returns the choice afterwards. */
+export async function answerChoice(context, siteUrl, cmid, optionIds) {
+    if (optionIds.length === 0)
+        throw new ChoiceError("Give the id of the option to choose.");
+    const page = await openChoice(context, siteUrl, cmid);
+    try {
+        const choice = await readChoice(page);
+        if (!choice.canAnswer) {
+            // Moodle explains only some cases (closed before answering); an answered, closed choice just shows the answer.
+            const answered = choice.answer.length > 0 ? ` Your answer stays: ${choice.answer.join(", ")}.` : "";
+            const said = choice.messages.length > 0 ? ` Moodle says: ${choice.messages.join(" ")}` : "";
+            throw new ChoiceError(`You can't answer choice ${cmid} now: it's closed, not open yet, or doesn't let answers change.${answered}${said}`);
+        }
+        if (!choice.multiple && optionIds.length > 1)
+            throw new ChoiceError(`Choice ${cmid} takes one option only.`);
+        for (const id of optionIds) {
+            const option = choice.options.find((o) => o.id === id);
+            if (!option)
+                throw new ChoiceError(`Choice ${cmid} has no option ${id}; its options are: ${choice.options.map((o) => `${o.id} "${o.text}"`).join(", ")}.`);
+            if (option.full)
+                throw new ChoiceError(`Option ${id} "${option.text}" is full.`);
+        }
+        const form = '#region-main form[action*="/mod/choice/view.php"]';
+        for (const option of choice.options) {
+            const input = page.locator(`${form} input[name^="answer"][value="${option.id}"]`);
+            if (optionIds.includes(option.id))
+                await input.check();
+            else if (choice.multiple)
+                await input.uncheck();
+        }
+        await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), page.click(`${form} [type="submit"]`)]);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+    return getChoice(context, siteUrl, cmid);
+}
+//# sourceMappingURL=choice.js.map

package/dist/moodle/choice.js.map

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

package/dist/moodle/completion.d.ts

@@ -0,0 +1,48 @@
+import type { BrowserContext, Page } from "playwright-core";
+import { type CompletionState } from "./structure.js";
+/** Completion can't be changed or read there: not enabled, automatic, or not allowed. */
+export declare class CompletionError extends Error {
+    name: string;
+}
+/**
+ * Marks the person's own completion of an activity with manual completion, done or not, as its
+ * "Mark as done" button does; doing it twice changes nothing. An activity that completes on its own
+ * gives a `CompletionError`.
+ */
+export declare function setCompletion(context: BrowserContext, siteUrl: string, cmid: number, done: boolean): Promise<{
+    changed: string;
+}>;
+/** Sets someone's completion of an activity as a teacher does from the progress report; returns the state saved. */
+export declare function overrideCompletion(context: BrowserContext, siteUrl: string, cmid: number, userId: number, state: CompletionState): Promise<{
+    changed: string;
+    state: CompletionState;
+    overridden: boolean;
+}>;
+export interface CompletionCell {
+    activityId: number;
+    state: CompletionState;
+    tracking: "manual" | "auto";
+    /** A teacher set it, not the person or Moodle. */
+    overridden: boolean;
+}
+export interface CompletionReport {
+    activities: {
+        id: number;
+        name: string;
+        type: string;
+    }[];
+    participants: {
+        userId: number;
+        fullName: string;
+        completion: CompletionCell[];
+    }[];
+}
+/** One page of the progress report: its activities from the header links, its rows' icons by name. */
+export declare function readCompletionReport(page: Page): Promise<CompletionReport>;
+/**
+ * A course's progress report: every participant's completion of every activity that tracks it, page
+ * by page, in one group when given. People come as user id and full name only.
+ */
+export declare function completionReport(context: BrowserContext, siteUrl: string, courseId: number, { group }?: {
+    group?: number;
+}): Promise<CompletionReport>;

package/dist/moodle/completion.js

@@ -0,0 +1,108 @@
+import { MoodleServiceError, callService } from "./ajax.js";
+import { openSitePage } from "./session.js";
+import { COMPLETION_STATES } from "./structure.js";
+/** Completion can't be changed or read there: not enabled, automatic, or not allowed. */
+export class CompletionError extends Error {
+    name = "CompletionError";
+}
+/** Moodle's refusals, in its terms. */
+function completionError(error, cmid) {
+    if (!(error instanceof MoodleServiceError))
+        return error;
+    if (error.errorcode === "cannotmanualctrack")
+        return new CompletionError(`Activity ${cmid} completes automatically (on view, grade, submission…): it can't be marked by hand.`);
+    if (error.errorcode === "completionnotenabled")
+        return new CompletionError(`Completion isn't enabled in activity ${cmid}'s course.`);
+    if (error.errorcode === "nopermissions" || error.errorcode === "nopermission")
+        return new CompletionError(`You aren't allowed to change completion in activity ${cmid}.`);
+    return error;
+}
+/**
+ * Marks the person's own completion of an activity with manual completion, done or not, as its
+ * "Mark as done" button does; doing it twice changes nothing. An activity that completes on its own
+ * gives a `CompletionError`.
+ */
+export async function setCompletion(context, siteUrl, cmid, done) {
+    try {
+        await callService(context, siteUrl, "core_completion_update_activity_completion_status_manually", { cmid, completed: done });
+    }
+    catch (error) {
+        throw completionError(error, cmid);
+    }
+    return { changed: `Activity ${cmid} marked ${done ? "done" : "not done"}.` };
+}
+/** Sets someone's completion of an activity as a teacher does from the progress report; returns the state saved. */
+export async function overrideCompletion(context, siteUrl, cmid, userId, state) {
+    let saved;
+    try {
+        saved = await callService(context, siteUrl, "core_completion_override_activity_completion_status", { userid: userId, cmid, newstate: COMPLETION_STATES.indexOf(state) });
+    }
+    catch (error) {
+        throw completionError(error, cmid);
+    }
+    const now = COMPLETION_STATES[saved.state] ?? "incomplete";
+    return { changed: `User ${userId}'s completion of activity ${cmid} set to ${now}.`, state: now, overridden: Boolean(saved.overrideby) };
+}
+/** One page of the progress report: its activities from the header links, its rows' icons by name. */
+export function readCompletionReport(page) {
+    return page.evaluate(() => {
+        const doc = globalThis.document;
+        const STATES = { n: "incomplete", y: "complete", pass: "complete-pass", fail: "complete-fail" };
+        const activities = Array.from(doc.querySelectorAll("#completion-progress thead th.completion-header a")).flatMap((link) => {
+            const match = /\/mod\/([a-z0-9_]+)\/view\.php\?(?:.*&)?id=(\d+)/.exec(link.getAttribute("href") ?? "");
+            return match ? [{ id: Number(match[2]), name: (link.getAttribute("title") ?? link.textContent ?? "").trim(), type: match[1] }] : [];
+        });
+        const participants = Array.from(doc.querySelectorAll("#completion-progress tbody tr")).flatMap((row) => {
+            const link = row.querySelector('th a[href*="/user/view.php?id="]');
+            const userId = Number(new URL(link?.getAttribute("href") ?? "", "http://x/").searchParams.get("id"));
+            if (!userId)
+                return [];
+            // One cell per activity, in the header's order; the icon's file names the state.
+            const completion = Array.from(row.querySelectorAll("td.completion-progresscell")).flatMap((cell, i) => {
+                const icon = /completion-(manual|auto)-(n|y|pass|fail)(-override)?/.exec(cell.querySelector("img")?.getAttribute("src") ?? "");
+                const activity = activities[i];
+                return icon && activity ? [{ activityId: activity.id, state: STATES[icon[2]], tracking: icon[1], overridden: icon[3] !== undefined }] : [];
+            });
+            return [{ userId, fullName: (link?.textContent ?? "").replace(/\s+/g, " ").trim(), completion }];
+        });
+        return { activities, participants };
+    });
+}
+const MAX_PAGES = 100;
+/**
+ * A course's progress report: every participant's completion of every activity that tracks it, page
+ * by page, in one group when given. People come as user id and full name only.
+ */
+export async function completionReport(context, siteUrl, courseId, { group } = {}) {
+    const report = { activities: [], participants: [] };
+    const seen = new Set();
+    let start = 0;
+    for (let p = 0; p < MAX_PAGES; p++) {
+        const page = await openSitePage(context, siteUrl, `report/progress/index.php?course=${courseId}&start=${start}${group ? `&group=${group}` : ""}`);
+        try {
+            // An error page keeps the report's body id; only the report has its activity selector.
+            if ((await page.locator("body#page-report-progress-index #include-activity-select-report").count()) === 0) {
+                throw new CompletionError(`You can't see course ${courseId}'s progress report: the course doesn't exist, or you aren't allowed.`);
+            }
+            if ((await page.locator("#completion-progress").count()) === 0) {
+                // The page explains in the site's language: no activity tracks completion, or nobody to list.
+                return report;
+            }
+            const read = await readCompletionReport(page);
+            if (p === 0)
+                report.activities = read.activities;
+            const fresh = read.participants.filter((row) => !seen.has(row.userId));
+            if (fresh.length === 0)
+                break;
+            for (const row of fresh)
+                seen.add(row.userId);
+            report.participants.push(...fresh);
+            start += read.participants.length;
+        }
+        finally {
+            await page.close().catch(() => undefined);
+        }
+    }
+    return report;
+}
+//# sourceMappingURL=completion.js.map

package/dist/moodle/completion.js.map

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