@falkenslab/moodle-driver 0.0.0-stage → 0.3.1

package/dist/areas/activities/content.js

@@ -0,0 +1,113 @@
+import { pause, readingSeconds } from "../../core/pace.js";
+import { openSitePage } from "../../core/session.js";
+import { readMedia, readTexts } from "../../core/text.js";
+import { MoodleError } from "../../core/errors.js";
+export const CONTENT_TYPES = ["page", "book", "label", "url", "resource", "folder"];
+// A book has a reasonable number of chapters; the bound stops a loop on a broken "next" link.
+const MAX_CHAPTERS = 200;
+/** The activity isn't of the given type, or the person can't view it. */
+export class NotViewableError extends MoodleError {
+    name = "NotViewableError";
+    constructor(message) {
+        super(message, "not-viewable");
+    }
+}
+async function links(page, selector) {
+    return page.evaluate((selector) => {
+        const anchors = globalThis.document.querySelectorAll(selector);
+        return Array.from(anchors).map((a) => ({ name: (a.textContent ?? "").replace(/\s+/g, " ").trim(), url: a.href }));
+    }, selector);
+}
+/** A book chapter's title and text, the title taken off the text's start. */
+function chapter(title, body) {
+    return { title, text: body.startsWith(title) ? body.slice(title.length).trim() : body };
+}
+export async function activityContent(context, siteUrl, activityOrId, typeOrOptions, options) {
+    if (typeof activityOrId === "number")
+        return readContent(context, siteUrl, activityOrId, typeOrOptions, options);
+    const { id, type } = activityOrId;
+    if (!CONTENT_TYPES.includes(type)) {
+        throw new NotViewableError(`Activity ${id} is a ${type}: activityContent reads ${CONTENT_TYPES.join(", ")}.`);
+    }
+    return readContent(context, siteUrl, id, type, typeOrOptions);
+}
+async function readContent(context, siteUrl, activityId, type, { trail = "realistic", onProgress } = {}) {
+    const realistic = trail === "realistic";
+    const output = { activity: { id: activityId, type }, trail };
+    let secondsRead = 0;
+    const readAsAPerson = async (text) => {
+        if (!realistic)
+            return;
+        const seconds = readingSeconds(text);
+        await pause(seconds, (elapsed) => onProgress?.(secondsRead + elapsed));
+        secondsRead += seconds;
+    };
+    // Opens the activity's page and checks it shows what this type should.
+    const view = async (path, ready) => {
+        const page = await openSitePage(context, siteUrl, path);
+        if ((await page.locator(ready).count()) === 0) {
+            await page.close().catch(() => undefined);
+            throw new NotViewableError(`Activity ${activityId} isn't a ${type} you can view. Take its id and module from the course structure.`);
+        }
+        return page;
+    };
+    if (type === "page" || type === "label") {
+        const path = type === "page" ? `mod/page/view.php?id=${activityId}` : `mod/label/view.php?id=${activityId}`;
+        const selector = type === "page" ? "#region-main .generalbox" : `[data-for="cmitem"][data-id="${activityId}"] .activity-altcontent`;
+        const page = await view(path, selector);
+        output.text = (await readTexts(page, selector))[0] ?? "";
+        output.media = await readMedia(page, selector);
+        await page.close();
+        await readAsAPerson(output.text);
+    }
+    else if (type === "book") {
+        output.chapters = [];
+        const media = [];
+        if (realistic) {
+            // Chapter by chapter, following "next", as a reader does.
+            const page = await view(`mod/book/view.php?id=${activityId}`, "#region-main .book_content");
+            try {
+                for (let i = 0; i < MAX_CHAPTERS; i++) {
+                    const title = (await readTexts(page, "#region-main .book_content h3, #region-main .book_content h2"))[0] ?? "";
+                    const read = chapter(title, (await readTexts(page, "#region-main .book_content"))[0] ?? "");
+                    output.chapters.push(read);
+                    media.push(...(await readMedia(page, "#region-main .book_content")));
+                    await readAsAPerson(read.text);
+                    const next = page.locator("#region-main a.btn-next").first();
+                    if ((await next.count()) === 0)
+                        break;
+                    await page.goto((await next.getAttribute("href")), { waitUntil: "domcontentloaded" });
+                }
+            }
+            finally {
+                await page.close().catch(() => undefined);
+            }
+        }
+        else {
+            const page = await view(`mod/book/tool/print/index.php?id=${activityId}`, ".book_chapter");
+            const titles = await readTexts(page, ".book_chapter h2, .book_chapter h3");
+            const bodies = await readTexts(page, ".book_chapter");
+            output.chapters = bodies.map((body, i) => chapter(titles[i] ?? "", body));
+            media.push(...(await readMedia(page, ".book_chapter")));
+            await page.close();
+        }
+        // The same video can appear in several chapters: once each.
+        output.media = [...new Map(media.map((item) => [item.url, item])).values()];
+    }
+    else if (type === "url") {
+        // forceview logs the view and shows the link instead of leaving the site.
+        const page = await view(`mod/url/view.php?id=${activityId}&forceview=1`, ".urlworkaround a");
+        output.url = (await links(page, ".urlworkaround a"))[0]?.url;
+        await page.close();
+    }
+    else {
+        const [path, selector] = type === "resource" ? [`mod/resource/view.php?id=${activityId}&forceview=1`, ".resourceworkaround a"] : [`mod/folder/view.php?id=${activityId}`, '.foldertree a[href*="pluginfile.php"]'];
+        const page = await view(path, selector);
+        output.files = await links(page, selector);
+        await page.close();
+    }
+    if (secondsRead > 0)
+        output.readingSeconds = secondsRead;
+    return output;
+}
+//# sourceMappingURL=content.js.map

package/dist/areas/activities/content.js.map

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

package/dist/areas/assignments/grader.d.ts

@@ -0,0 +1,68 @@
+import type { BrowserContext, Page } from "playwright-core";
+import { type FieldValue } from "../../core/forms.js";
+import { MoodleError } from "../../core/errors.js";
+/** An assignment's ids beyond its course module id, which only the grader page shows. */
+export interface AssignmentIds {
+    instanceId: number;
+    contextId: number;
+}
+/** The id isn't an assignment's course module, or the person can't grade it. */
+export declare class NotAnAssignmentError extends MoodleError {
+    name: string;
+    constructor(message: string);
+}
+/** Reads `data-assignmentid` and `data-contextid` from a page (the grader's), or `undefined`. */
+export declare function readAssignmentIds(page: Page): Promise<AssignmentIds | undefined>;
+export declare function assignmentIds(context: BrowserContext, siteUrl: string, activityId: number): Promise<AssignmentIds>;
+/** A participant as `mod_assign_list_participants` returns it (Moodle 5.2), the fields read. */
+export interface MoodleParticipant {
+    id: number;
+    fullname: string;
+    submitted: boolean;
+    requiregrading: boolean;
+    grantedextension: boolean;
+    submissionstatus: string;
+}
+/** The dates `mod_assign_get_participant` gives for one participant (Unix seconds; 0 is none). */
+export interface MoodleParticipantDates {
+    allowsubmissionsfromdate: number;
+    duedate: number;
+    cutoffdate: number;
+}
+export declare function listParticipants(context: BrowserContext, siteUrl: string, instanceId: number): Promise<MoodleParticipant[]>;
+export declare function participantDates(context: BrowserContext, siteUrl: string, instanceId: number, userId: number): Promise<MoodleParticipantDates>;
+/** One submission plugin's content: its text, paragraphs kept, and its files. */
+export interface PluginContent {
+    plugin: string;
+    text: string;
+    files: {
+        name: string;
+        url: string;
+    }[];
+}
+/**
+ * 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 declare function readSubmissionContent(page: Page, html: string): Promise<PluginContent[]>;
+/** The grader panel's HTML for one participant: their current submission and grade form. */
+export declare function gradingPanelHtml(context: BrowserContext, siteUrl: string, contextId: number, userId: number): Promise<string>;
+/** Moodle's grader didn't take the grade. */
+export declare class GradingError extends MoodleError {
+    name: string;
+    constructor(message: string);
+}
+/**
+ * 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 declare function fillGradingForm(page: Page, panelHtml: string, fields: Record<string, FieldValue>): Promise<string>;
+/** The grade and feedback currently in a grading panel, if any. */
+export declare function panelGrade(page: Page, panelHtml: string): Promise<{
+    grade?: string;
+    gradebookGrade?: string;
+    feedback?: string;
+}>;
+/** Submits a serialized grading form; Moodle answers warnings when it refuses it. */
+export declare function submitGradingForm(context: BrowserContext, siteUrl: string, instanceId: number, userId: number, serialized: string): Promise<void>;

package/dist/areas/assignments/grader.js

@@ -0,0 +1,169 @@
+import { callService } from "../../core/ajax.js";
+import { setFields } from "../../core/forms.js";
+import { openSitePage } from "../../core/session.js";
+import { MoodleError } from "../../core/errors.js";
+/** The id isn't an assignment's course module, or the person can't grade it. */
+export class NotAnAssignmentError extends MoodleError {
+    name = "NotAnAssignmentError";
+    constructor(message) {
+        super(message, "not-an-assignment");
+    }
+}
+// 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, activityId) {
+    const key = `${siteUrl}|${activityId}`;
+    const cached = idCache.get(key);
+    if (cached)
+        return cached;
+    const page = await openSitePage(context, siteUrl, `mod/assign/view.php?id=${activityId}&action=grader`);
+    try {
+        const ids = await readAssignmentIds(page);
+        if (!ids)
+            throw new NotAnAssignmentError(`Activity ${activityId} 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 MoodleError {
+    name = "GradingError";
+    constructor(message) {
+        super(message, "grading");
+    }
+}
+/**
+ * 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=grader.js.map

package/dist/areas/assignments/grader.js.map

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

package/dist/areas/assignments/grading.d.ts

@@ -0,0 +1,86 @@
+import type { BrowserContext, Page } from "playwright-core";
+import { type PluginContent } from "./grader.js";
+import { type FieldValue } from "../../core/forms.js";
+export interface Submission {
+    userId: number;
+    fullName: string;
+    /** Moodle's status: "submitted", "draft", "new", "reopened", or "none" without a submission. */
+    status: string;
+    submitted: boolean;
+    needsGrading: boolean;
+    extensionGranted: boolean;
+    /** Until when, where an extension is granted. */
+    extensionDueDate?: string;
+    allowSubmissionsFrom?: string;
+    /** For this participant: overrides and extensions included. */
+    dueDate?: string;
+    cutoffDate?: string;
+    /** Per submission plugin; only for submitted and draft submissions. */
+    content?: PluginContent[];
+}
+/** Every participant's submission to an assignment, with its content unless `includeContent` is false. */
+export declare function assignmentSubmissions(context: BrowserContext, siteUrl: string, activityId: number, { includeContent }?: {
+    includeContent?: boolean | undefined;
+}): Promise<Submission[]>;
+/**
+ * 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 declare function gradeSubmission(context: BrowserContext, siteUrl: string, activityId: number, userId: number, { grade, rubric, guide, remarks, feedback, notify, fields, }: {
+    grade?: string | number;
+    /** Criterion id → level id. */
+    rubric?: Record<number, number>;
+    /** Criterion id → score. */
+    guide?: Record<number, number>;
+    /** Criterion id → remark, for a rubric or a guide. */
+    remarks?: Record<number, string>;
+    feedback?: string;
+    notify?: boolean;
+    fields?: Record<string, FieldValue>;
+}): Promise<{
+    grade?: string;
+    gradebookGrade?: string;
+    feedback?: string;
+    changed: string;
+}>;
+export interface GradingCriterion {
+    id: number;
+    /** A rubric criterion's description; a guide criterion's short name. */
+    description: string;
+    /** A guide criterion's description for students and for markers. */
+    details?: string;
+    markers?: string;
+    /** A rubric criterion's levels, by the ids grading takes. */
+    levels?: {
+        id: number;
+        definition: string;
+        score: number;
+    }[];
+    /** A guide criterion's maximum score. */
+    maxScore?: number;
+}
+export interface GradingDefinition {
+    /** "simple" for a plain grade (or a scale), "rubric" or "guide" for advanced grading. */
+    method: "simple" | "rubric" | "guide";
+    criteria: GradingCriterion[];
+}
+/** The grading method and its criteria, read from a grading panel's form by field names and blocks. */
+export declare function readGradingDefinition(page: Page, panelHtml: string): Promise<GradingDefinition>;
+/**
+ * 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 declare function rubric(context: BrowserContext, siteUrl: string, activityId: number): Promise<{
+    assignment: {
+        id: number;
+    };
+} & GradingDefinition>;
+/**
+ * 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 declare function grantExtension(context: BrowserContext, siteUrl: string, activityId: number, userIds: number[], until: Date): Promise<{
+    changed: string;
+}>;

package/dist/areas/assignments/grading.js

@@ -0,0 +1,162 @@
+import { GradingError, NotAnAssignmentError, assignmentIds, fillGradingForm, gradingPanelHtml, listParticipants, panelGrade, participantDates, readSubmissionContent, submitGradingForm } from "./grader.js";
+import { isoDate } from "../courses/list.js";
+import { dateSelectorDate, dateSelectorValues, openForm, setFields, submitForm } from "../../core/forms.js";
+import { NotLoggedInError } from "../../core/session.js";
+import { inPage } from "../../core/inPage.js";
+import { MoodleError } from "../../core/errors.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, activityId, userId) {
+    const page = await openForm(context, siteUrl, `mod/assign/view.php?id=${activityId}&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, activityId, { includeContent = true } = {}) {
+    const ids = await assignmentIds(context, siteUrl, activityId);
+    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: one person at a time, as Moodle expects of a session.
+        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, activityId, 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 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, activityId, userId, { grade, rubric, guide, remarks, feedback, notify, fields, }) {
+    const ids = await assignmentIds(context, siteUrl, activityId);
+    const values = { ...fields };
+    if (grade !== undefined)
+        values.grade = String(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 MoodleError("This assignment has no feedback comments: grade it without feedback, or turn feedback comments on in its settings.", "not-available");
+            }
+            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 ${activityId}${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, activityId) {
+    const ids = await assignmentIds(context, siteUrl, activityId);
+    const [first] = await listParticipants(context, siteUrl, ids.instanceId);
+    if (!first)
+        throw new GradingError(`Assignment ${activityId} has no participants: its grading form can't be read without one.`);
+    const page = await context.newPage();
+    try {
+        return { assignment: { id: activityId }, ...(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, activityId, 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=${activityId}&action=grantextension&userid=${userIds[0]}`).catch((error) => {
+        if (error instanceof NotLoggedInError)
+            throw error;
+        throw new NotAnAssignmentError(`You can't grant extensions in activity ${activityId}: 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 ${activityId}.` };
+}
+//# sourceMappingURL=grading.js.map

package/dist/areas/assignments/grading.js.map

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