@falkenslab/moodle-driver 0.4.1 → 0.5.1

package/dist/areas/quizzes/grading.js

@@ -0,0 +1,131 @@
+import { FormError } from "../../core/forms.js";
+import { inPage } from "../../core/inPage.js";
+import { moodleErrorMessage, openSitePage } from "../../core/session.js";
+import { QuizError } from "./attempts.js";
+import { readReport } from "./results.js";
+/** The manual grading report's list of questions: slot and question from its links, type from its icon, counts by column. */
+export function readQuestionsToGrade(page) {
+    return inPage(page, () => {
+        const doc = globalThis.document;
+        const count = (el) => Number(/\d+/.exec(el?.textContent ?? "")?.[0] ?? 0);
+        return Array.from(doc.querySelectorAll("table#questionstograde tbody tr")).flatMap((row) => {
+            const cells = Array.from(row.querySelectorAll("td"));
+            const link = row.querySelector('a.gradetheselink[href*="slot="]');
+            if (!link || cells.length < 6)
+                return [];
+            const params = new URL(link.getAttribute("href") ?? "", "http://x/").searchParams;
+            const slot = Number(params.get("slot"));
+            if (!slot)
+                return [];
+            const questionId = Number(params.get("qid")) || undefined;
+            // Columns: number, type, name, to grade, already graded, (automatically graded,) total.
+            return [
+                {
+                    slot,
+                    ...(questionId ? { questionId } : {}),
+                    name: (cells[2]?.textContent ?? "").replace(/\s+/g, " ").trim(),
+                    type: /\/qtype_([a-z0-9_]+)\//.exec(cells[1]?.querySelector("img")?.getAttribute("src") ?? "")?.[1] ?? "",
+                    toGrade: count(cells[3]),
+                    graded: count(cells[4]),
+                    total: count(cells[cells.length - 1]),
+                },
+            ];
+        });
+    }, null);
+}
+/**
+ * The questions of a quiz that wait for grading by hand (essays…), as its manual grading report lists
+ * them, each with the finished attempts whose answer requires grading (from the results report).
+ * People as user id and full name.
+ */
+export async function questionsToGrade(context, siteUrl, activityId) {
+    const page = await openSitePage(context, siteUrl, `mod/quiz/report.php?id=${activityId}&mode=grading`);
+    let listed;
+    try {
+        if ((await page.locator("body#page-mod-quiz-report").count()) === 0 || (await moodleErrorMessage(page)) !== undefined) {
+            throw new QuizError(`You can't grade quiz ${activityId}: ${((await moodleErrorMessage(page)) ?? "it isn't a quiz, or you aren't allowed").replace(/\.$/, "")}.`);
+        }
+        listed = await readQuestionsToGrade(page);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+    const waiting = listed.some((q) => q.toGrade > 0) ? await readReport(context, siteUrl, activityId, "overview") : [];
+    return {
+        quiz: { id: activityId },
+        questions: listed.map((question) => ({
+            ...question,
+            attempts: waiting
+                .filter((attempt) => attempt.questions.some((q) => q.slot === question.slot && q.result === "requiresgrading"))
+                .map((attempt) => ({ id: attempt.id, userId: attempt.userId, fullName: attempt.fullName })),
+        })),
+    };
+}
+/**
+ * Grades one question of a finished attempt by hand, with a comment, through Moodle's comment form
+ * (the review's "Make comment or override mark"): an essay waiting for grading, or any question whose
+ * mark the teacher overrides. The mark is in the question's points (0 to its maximum in the quiz).
+ * Returns the attempt's grade afterwards when the results report shows it.
+ */
+export async function gradeQuizQuestion(context, siteUrl, attemptId, slot, { mark, comment }) {
+    if (!Number.isFinite(mark))
+        throw new QuizError("Give the mark as a number of points.");
+    const page = await openSitePage(context, siteUrl, `mod/quiz/comment.php?attempt=${attemptId}&slot=${slot}`);
+    let activityId;
+    let maxMark;
+    try {
+        if ((await page.locator("body#page-mod-quiz-comment form#manualgradingform").count()) === 0) {
+            throw new QuizError(`You can't grade question ${slot} of attempt ${attemptId}: ${((await moodleErrorMessage(page)) ?? "the attempt isn't finished, the slot isn't in it, or you aren't allowed").replace(/\.$/, "")}.`);
+        }
+        // The course module id is in the body's classes (cmid-<id>).
+        activityId = Number(/\bcmid-(\d+)\b/.exec((await page.locator("body").getAttribute("class")) ?? "")?.[1]);
+        const outcome = await page.evaluate(async ({ mark, comment }) => {
+            const g = globalThis;
+            const form = g.document.querySelector("form#manualgradingform");
+            const fields = Array.from(form.querySelectorAll("[name]"));
+            const markField = fields.find((f) => /_-mark$/.test(f.name));
+            const commentField = fields.find((f) => /_-comment$/.test(f.name));
+            const maxMark = fields.find((f) => /_-maxmark$/.test(f.name))?.value;
+            if (!markField)
+                return { kind: "nomark" };
+            // Sent as the form would be, URL-encoded (it has no files).
+            const data = new g.URLSearchParams(new g.FormData(form));
+            data.set(markField.name, String(mark));
+            if (comment !== undefined && commentField)
+                data.set(commentField.name, comment);
+            data.set("submit", "1");
+            const response = await g.fetch(form.action, { method: "POST", body: data, credentials: "same-origin" });
+            const answer = new g.DOMParser().parseFromString(await response.text(), "text/html");
+            // A mark out of range or badly written: the form again, its mark marked as an error.
+            const fieldError = (answer.querySelector(".que .comment span.error")?.textContent ?? "").replace(/\s+/g, " ").trim();
+            if (fieldError)
+                return { kind: "field", message: fieldError, maxMark };
+            if (answer.querySelector("form#manualgradingform")) {
+                return { kind: "refused", message: (answer.querySelector("#region-main .alert-danger, #region-main .alert-error")?.textContent ?? "").replace(/\s+/g, " ").trim(), maxMark };
+            }
+            if (response.status >= 400)
+                return { kind: "refused", message: `HTTP ${response.status}`, maxMark };
+            return { kind: "saved", maxMark };
+        }, { mark, comment });
+        if (outcome.kind === "nomark")
+            throw new QuizError(`Question ${slot} of attempt ${attemptId} has no mark to set: it's a description, or not graded.`);
+        maxMark = outcome.maxMark !== undefined ? Number(outcome.maxMark) : undefined;
+        if (outcome.kind === "field")
+            throw new FormError(`Moodle refused the mark for question ${slot} of attempt ${attemptId}:`, [{ field: "mark", message: outcome.message }]);
+        if (outcome.kind === "refused")
+            throw new QuizError(`Moodle didn't save the grade for question ${slot} of attempt ${attemptId}: ${outcome.message || "it showed the form again"}.`);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+    const grade = activityId ? (await readReport(context, siteUrl, activityId, "overview").catch(() => [])).find((a) => a.id === attemptId)?.grade : undefined;
+    return {
+        changed: `Graded question ${slot} of attempt ${attemptId}: ${mark}${maxMark !== undefined ? ` out of ${maxMark}` : ""}${comment !== undefined ? ", with a comment" : ""}${grade ? `; the attempt's grade is now ${grade}` : ""}.`,
+        attemptId,
+        slot,
+        mark,
+        ...(maxMark !== undefined ? { maxMark } : {}),
+        ...(grade ? { grade } : {}),
+    };
+}
+//# sourceMappingURL=grading.js.map

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

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

package/dist/areas/quizzes/results.d.ts

@@ -1,4 +1,5 @@
 import type { BrowserContext, Page } from "playwright-core";
+/** An attempt at a quiz, as `quizResults` reads it from the quiz's reports. */
 export interface QuizAttemptResult {
     id: number;
     userId: number;
@@ -21,6 +22,8 @@ export interface QuizAttemptResult {
 }
 /** One report page's rows: ids from inputs and links, the grade column by its class, the rest by position from it. */
 export declare function readQuizReport(page: Page, mode: "overview" | "responses"): Promise<QuizAttemptResult[]>;
+/** Every page of one of a quiz's reports, its attempts once each. */
+export declare function readReport(context: BrowserContext, siteUrl: string, activityId: number, mode: "overview" | "responses"): Promise<QuizAttemptResult[]>;
 /**
  * A quiz's attempts as its grades report shows them: per attempt the user, state, dates, grade and
  * the mark per question; with `responses`, also the answer per question from the responses report.

package/dist/areas/quizzes/results.js

@@ -49,7 +49,8 @@ export function readQuizReport(page, mode) {
     }, mode);
 }
 const MAX_PAGES = 100;
-async function readReport(context, siteUrl, activityId, mode) {
+/** Every page of one of a quiz's reports, its attempts once each. */
+export async function readReport(context, siteUrl, activityId, mode) {
     const all = new Map();
     for (let p = 0; p < MAX_PAGES; p++) {
         const page = await openSitePage(context, siteUrl, `mod/quiz/report.php?id=${activityId}&mode=${mode}&attempts=enrolled_with&page=${p}`);

package/dist/areas/quizzes/results.js.map

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

package/dist/areas/quizzes/structure.d.ts

@@ -1,7 +1,11 @@
 import type { BrowserContext, Page } from "playwright-core";
+/** A place for a question in a quiz, as `quizStructure` reads it from the quiz's edit page. */
 export interface QuizSlot {
-    /** Moodle's id for the slot, and its question number. */
+    /** Moodle's id for the slot. */
     id: number;
+    /** The slot's place in the quiz, from 1: what the other functions take as `slot`. */
+    slot: number;
+    /** The question's number as shown (descriptions have none). */
     number?: number;
     page: number;
     /** The question's id; none for a random slot. */
@@ -11,15 +15,39 @@ export interface QuizSlot {
     name: string;
     mark?: string;
 }
-/** The edit page's slots in order, each with the page it's on; read by ids, classes and links. */
+/** A section of a quiz: a heading before a group of pages, whose questions may be shuffled. */
+export interface QuizSection {
+    id: number;
+    /** Empty for an untitled section (the first one, by default). */
+    heading: string;
+    /** The slot it starts at. */
+    firstSlot: number;
+    shuffle: boolean;
+}
+/** The edit page's sections and slots in order, each slot with the page it's on; read by ids, classes and links. */
+export declare function readQuizEditor(page: Page): Promise<{
+    sections: QuizSection[];
+    slots: QuizSlot[];
+}>;
+/** The edit page's slots in order, each with the page it's on. */
 export declare function readQuizSlots(page: Page): Promise<QuizSlot[]>;
-/** A quiz's questions as its edit page lists them: slots with their page, question, type, name and mark. */
+/** A quiz's questions as its edit page lists them: slots with their page, question, type, name and mark, and its sections. */
 export declare function quizStructure(context: BrowserContext, siteUrl: string, activityId: number): Promise<{
     quiz: {
         id: number;
     };
     slots: QuizSlot[];
+    sections: QuizSection[];
 }>;
+/** What a change to a quiz's structure answers: what changed, and the quiz's slots and sections afterwards. */
+export type QuizChange = {
+    changed: string;
+    quiz: {
+        id: number;
+    };
+    slots: QuizSlot[];
+    sections: QuizSection[];
+};
 /**
  * Adds bank questions to a quiz by id, and random questions from a bank category, at the end or on a
  * page, as the edit page's bank actions post them. Returns the quiz's structure afterwards. A quiz
@@ -33,10 +61,38 @@ export declare function addQuestionsToQuiz(context: BrowserContext, siteUrl: str
         includeSubcategories?: boolean;
     };
     page?: number;
-}): Promise<{
-    changed: string;
-    quiz: {
-        id: number;
-    };
-    slots: QuizSlot[];
+}): Promise<QuizChange>;
+/**
+ * Changes one slot of a quiz (by its place, from 1): its maximum mark, through the slots' service,
+ * and where it is, as dragging it on the edit page does: after another slot (`moveAfter`, 0 for
+ * first) and on a page. Moodle lets the mark change after attempts (it regrades them), not the rest.
+ */
+export declare function editQuizSlot(context: BrowserContext, siteUrl: string, activityId: number, slot: number, { maxMark, moveAfter, page: toPage }: {
+    maxMark?: number;
+    moveAfter?: number;
+    page?: number;
+}): Promise<QuizChange>;
+/** Removes a slot (by its place, from 1) from a quiz, as the edit page's delete icon does; the question stays in its bank. */
+export declare function removeQuizSlot(context: BrowserContext, siteUrl: string, activityId: number, slot: number): Promise<QuizChange>;
+/**
+ * Sets a quiz's pages: `perPage` questions a page (0 for all on one), as the edit page's
+ * "Repaginate" does, or page breaks exactly after the given slots (and nowhere else), as its page
+ * break icons do one by one.
+ */
+export declare function setQuizPages(context: BrowserContext, siteUrl: string, activityId: number, pages: {
+    perPage: number;
+} | {
+    breaksAfter: number[];
+}): Promise<QuizChange>;
+/**
+ * Adds a section to a quiz starting at a slot, with its heading and whether its questions are
+ * shuffled, as the edit page's "Add a new section heading" and its heading and shuffle controls do.
+ * A section starts at a page: the slot must be the first of its page (see `setQuizPages`).
+ */
+export declare function addQuizSection(context: BrowserContext, siteUrl: string, activityId: number, { firstSlot, heading, shuffle }: {
+    firstSlot: number;
+    heading: string;
+    shuffle?: boolean;
+}): Promise<QuizChange & {
+    sectionId: number;
 }>;

package/dist/areas/quizzes/structure.js

@@ -1,12 +1,26 @@
 import { QuizError } from "./attempts.js";
+import { callService } from "../../core/ajax.js";
 import { moodleErrorMessage, openSitePage } from "../../core/session.js";
-/** The edit page's slots in order, each with the page it's on; read by ids, classes and links. */
-export function readQuizSlots(page) {
+/** The edit page's sections and slots in order, each slot with the page it's on; read by ids, classes and links. */
+export function readQuizEditor(page) {
     return page.evaluate(() => {
         const doc = globalThis.document;
         const slots = [];
+        const sections = [];
         let current = 0;
-        for (const item of Array.from(doc.querySelectorAll("li.page, li.slot"))) {
+        for (const item of Array.from(doc.querySelectorAll("li.section, li.page, li.slot"))) {
+            const section = /^section-(\d+)$/.exec(item.id);
+            if (section) {
+                const title = item.querySelector(".instancesection");
+                sections.push({
+                    id: Number(section[1]),
+                    // An untitled section's heading is a hidden placeholder in the site's language.
+                    heading: title && !/\bvisually-hidden\b/.test(title.className) ? (title.textContent ?? "").replace(/\s+/g, " ").trim() : "",
+                    firstSlot: slots.length + 1,
+                    shuffle: item.querySelector(`#shuffle-${section[1]}`)?.checked ?? false,
+                });
+                continue;
+            }
             const page = /^page-(\d+)$/.exec(item.id);
             if (page) {
                 current = Number(page[1]);
@@ -23,6 +37,7 @@ export function readQuizSlots(page) {
             const mark = (item.querySelector(".instancemaxmark")?.textContent ?? "").replace(/\s+/g, " ").trim() || undefined;
             slots.push({
                 id: slotId,
+                slot: slots.length + 1,
                 ...(number ? { number } : {}),
                 page: current,
                 ...(questionId && type !== "random" ? { questionId } : {}),
@@ -31,9 +46,14 @@ export function readQuizSlots(page) {
                 ...(mark ? { mark } : {}),
             });
         }
-        return slots;
+        // A section placed after the last slot would start nowhere: keep the ones that start at a slot.
+        return { sections: sections.filter((s) => s.firstSlot <= slots.length), slots };
     });
 }
+/** The edit page's slots in order, each with the page it's on. */
+export async function readQuizSlots(page) {
+    return (await readQuizEditor(page)).slots;
+}
 async function openEditPage(context, siteUrl, activityId) {
     const page = await openSitePage(context, siteUrl, `mod/quiz/edit.php?cmid=${activityId}`);
     if ((await page.locator("body#page-mod-quiz-edit").count()) === 0) {
@@ -43,16 +63,79 @@ async function openEditPage(context, siteUrl, activityId) {
     }
     return page;
 }
-/** A quiz's questions as its edit page lists them: slots with their page, question, type, name and mark. */
+/** A quiz's questions as its edit page lists them: slots with their page, question, type, name and mark, and its sections. */
 export async function quizStructure(context, siteUrl, activityId) {
     const page = await openEditPage(context, siteUrl, activityId);
     try {
-        return { quiz: { id: activityId }, slots: await readQuizSlots(page) };
+        const { slots, sections } = await readQuizEditor(page);
+        return { quiz: { id: activityId }, slots, sections };
     }
     finally {
         await page.close().catch(() => undefined);
     }
 }
+/** The edit page's add menus are empty when the quiz can't change (it has attempts): Moodle's notice says why. */
+async function checkEditable(page, activityId) {
+    if ((await page.locator(".add-menu-outer *").count()) > 0)
+        return;
+    const notice = ((await page.locator(".statusdisplay").first().textContent().catch(() => null)) ?? "").replace(/\s+/g, " ").trim();
+    throw new QuizError(`Quiz ${activityId} can't change its questions now: ${notice || "it has attempts already"}. Make a new quiz, or delete its attempts in Moodle.`);
+}
+/** Posts to the edit page as its forms do (adding, repaginating); Moodle redirects back to it, or shows an error. */
+async function postEditPage(page, activityId, fields) {
+    return page.evaluate(async ({ fields, quizId }) => {
+        const g = globalThis;
+        const response = await g.fetch(`${g.M.cfg.wwwroot}/mod/quiz/edit.php?cmid=${quizId}`, {
+            method: "POST",
+            credentials: "same-origin",
+            body: new g.URLSearchParams({ ...fields, sesskey: g.M.cfg.sesskey }),
+        });
+        const answer = new g.DOMParser().parseFromString(await response.text(), "text/html");
+        const error = (answer.querySelector('[data-rel="fatalerror"] .errormessage')?.textContent ?? "").replace(/\s+/g, " ").trim();
+        return { status: response.status, ...(error ? { error } : {}) };
+    }, { fields, quizId: activityId });
+}
+/** The quiz's instance id, which the edit page's own requests carry (its toolboxes' settings). */
+async function quizInstanceId(page, activityId) {
+    const html = await page.content();
+    const id = Number(/"quizid":"?(\d+)/.exec(html)?.[1]);
+    if (!id)
+        throw new QuizError(`Quiz ${activityId}'s edit page doesn't say which quiz it is: Moodle's page isn't what the driver expects.`);
+    return id;
+}
+/** One of the edit page's requests to edit_rest.php, with the sesskey and the quiz; throws Moodle's error as a `QuizError`. */
+async function editRest(page, quizId, activityId, fields) {
+    const answer = await page.evaluate(async ({ fields, quizId }) => {
+        const g = globalThis;
+        const body = { sesskey: g.M.cfg.sesskey, quizid: String(quizId) };
+        for (const [key, value] of Object.entries(fields))
+            body[key] = String(value);
+        const response = await g.fetch(`${g.M.cfg.wwwroot}/mod/quiz/edit_rest.php`, { method: "POST", credentials: "same-origin", body: new g.URLSearchParams(body) });
+        return { status: response.status, text: await response.text() };
+    }, { fields, quizId });
+    let json;
+    try {
+        json = JSON.parse(answer.text);
+    }
+    catch {
+        throw new QuizError(`Moodle didn't change quiz ${activityId}: its answer (HTTP ${answer.status}) isn't the edit page's JSON.`);
+    }
+    const error = json?.error;
+    if (error)
+        throw new QuizError(`Moodle didn't change quiz ${activityId}: ${error.replace(/\.$/, "")}.`);
+    return json;
+}
+function slotAt(slots, slot, activityId) {
+    const found = slots.find((s) => s.slot === slot);
+    if (!found)
+        throw new QuizError(`Quiz ${activityId} has no slot ${slot}: it has ${slots.length} (see its structure).`);
+    return found;
+}
+async function afterChange(page, activityId, changed) {
+    await page.reload({ waitUntil: "domcontentloaded" });
+    const { slots, sections } = await readQuizEditor(page);
+    return { changed, quiz: { id: activityId }, slots, sections };
+}
 /**
  * Adds bank questions to a quiz by id, and random questions from a bank category, at the end or on a
  * page, as the edit page's bank actions post them. Returns the quiz's structure afterwards. A quiz
@@ -63,10 +146,7 @@ export async function addQuestionsToQuiz(context, siteUrl, activityId, { questio
         throw new QuizError("Give the questions to add: their ids, or a category to draw random ones from.");
     const page = await openEditPage(context, siteUrl, activityId);
     try {
-        // The page's add menus are empty when the quiz can't change (it has attempts).
-        if ((await page.locator(".add-menu-outer *").count()) === 0) {
-            throw new QuizError(`Quiz ${activityId} can't change its questions now: it has attempts already. Make a new quiz, or delete its attempts in Moodle.`);
-        }
+        await checkEditable(page, activityId);
         const before = (await readQuizSlots(page)).length;
         const posts = [];
         if (questionIds.length > 0)
@@ -74,24 +154,143 @@ export async function addQuestionsToQuiz(context, siteUrl, activityId, { questio
         if (random)
             posts.push({ addrandom: "1", addonpage: String(onPage ?? 0), categoryid: String(random.categoryId), randomcount: String(random.count), recurse: random.includeSubcategories ? "1" : "0" });
         for (const fields of posts) {
-            const status = await page.evaluate(async ({ fields, quizId }) => {
-                const g = globalThis;
-                const response = await g.fetch(`${g.M.cfg.wwwroot}/mod/quiz/edit.php?cmid=${quizId}`, {
-                    method: "POST",
-                    credentials: "same-origin",
-                    body: new g.URLSearchParams({ ...fields, sesskey: g.M.cfg.sesskey }),
-                });
-                return response.status;
-            }, { fields, quizId: activityId });
+            const { status } = await postEditPage(page, activityId, fields);
             if (status >= 400)
                 throw new QuizError(`Moodle answered ${status} adding questions to quiz ${activityId}: check the questions' ids and the category.`);
         }
-        await page.reload({ waitUntil: "domcontentloaded" });
-        const slots = await readQuizSlots(page);
-        const added = slots.length - before;
+        const result = await afterChange(page, activityId, "");
+        const added = result.slots.length - before;
         if (added <= 0)
             throw new QuizError(`Moodle added no question to quiz ${activityId}: check the questions' ids (from the bank) and the category.`);
-        return { changed: `Added ${added} question${added === 1 ? "" : "s"} to quiz ${activityId}.`, quiz: { id: activityId }, slots };
+        return { ...result, changed: `Added ${added} question${added === 1 ? "" : "s"} to quiz ${activityId}.` };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * Changes one slot of a quiz (by its place, from 1): its maximum mark, through the slots' service,
+ * and where it is, as dragging it on the edit page does: after another slot (`moveAfter`, 0 for
+ * first) and on a page. Moodle lets the mark change after attempts (it regrades them), not the rest.
+ */
+export async function editQuizSlot(context, siteUrl, activityId, slot, { maxMark, moveAfter, page: toPage }) {
+    if (maxMark === undefined && moveAfter === undefined && toPage === undefined)
+        throw new QuizError("Give what to change in the slot: maxMark, moveAfter or page.");
+    if (maxMark !== undefined && !(Number.isFinite(maxMark) && maxMark >= 0))
+        throw new QuizError("The maximum mark is a number of points, 0 or more.");
+    const page = await openEditPage(context, siteUrl, activityId);
+    try {
+        const quizId = await quizInstanceId(page, activityId);
+        const { slots } = await readQuizEditor(page);
+        const moving = slotAt(slots, slot, activityId);
+        const done = [];
+        if (moveAfter !== undefined || toPage !== undefined) {
+            await checkEditable(page, activityId);
+            // Staying in place unless moved: after the slot before it.
+            const after = moveAfter ?? slot - 1;
+            const previous = after > 0 ? slotAt(slots, after, activityId) : undefined;
+            if (previous?.id === moving.id)
+                throw new QuizError(`Slot ${slot} can't move after itself.`);
+            // Moodle takes a page from the previous slot's to the next one's; by default the previous slot's.
+            const target = toPage ?? previous?.page ?? 1;
+            await editRest(page, quizId, activityId, { class: "resource", field: "move", id: moving.id, previousid: previous?.id ?? 0, page: target });
+            done.push(moveAfter !== undefined ? `moved slot ${slot} ${after === 0 ? "first" : `after slot ${after}`}${toPage !== undefined ? `, on page ${toPage}` : ""}` : `moved slot ${slot} to page ${toPage}`);
+        }
+        if (maxMark !== undefined) {
+            await callService(context, siteUrl, "mod_quiz_update_slots", { quizid: quizId, slots: [{ id: moving.id, maxmark: maxMark }] });
+            done.push(`set the maximum mark of question "${moving.name}" to ${maxMark}`);
+        }
+        return await afterChange(page, activityId, `In quiz ${activityId}: ${done.join("; ")}.`);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** Removes a slot (by its place, from 1) from a quiz, as the edit page's delete icon does; the question stays in its bank. */
+export async function removeQuizSlot(context, siteUrl, activityId, slot) {
+    const page = await openEditPage(context, siteUrl, activityId);
+    try {
+        await checkEditable(page, activityId);
+        const quizId = await quizInstanceId(page, activityId);
+        const removed = slotAt(await readQuizSlots(page), slot, activityId);
+        // The edit page simulates a DELETE request with this parameter.
+        await editRest(page, quizId, activityId, { class: "resource", action: "DELETE", id: removed.id });
+        return await afterChange(page, activityId, `Removed slot ${slot} ("${removed.name}") from quiz ${activityId}.`);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * Sets a quiz's pages: `perPage` questions a page (0 for all on one), as the edit page's
+ * "Repaginate" does, or page breaks exactly after the given slots (and nowhere else), as its page
+ * break icons do one by one.
+ */
+export async function setQuizPages(context, siteUrl, activityId, pages) {
+    const page = await openEditPage(context, siteUrl, activityId);
+    try {
+        await checkEditable(page, activityId);
+        if ("perPage" in pages) {
+            if (!(Number.isInteger(pages.perPage) && pages.perPage >= 0))
+                throw new QuizError("perPage is a whole number of questions, 0 for all on one page.");
+            const { status, error } = await postEditPage(page, activityId, { repaginate: "1", questionsperpage: String(pages.perPage) });
+            if (error || status >= 400)
+                throw new QuizError(`Moodle didn't repaginate quiz ${activityId}: ${error ?? `HTTP ${status}`}.`);
+            return await afterChange(page, activityId, `Repaginated quiz ${activityId}: ${pages.perPage ? `${pages.perPage} question${pages.perPage === 1 ? "" : "s"} a page` : "all questions on one page"}.`);
+        }
+        const quizId = await quizInstanceId(page, activityId);
+        const slots = await readQuizSlots(page);
+        for (const after of pages.breaksAfter) {
+            if (after < 1 || after >= slots.length)
+                throw new QuizError(`A page break goes after a slot from 1 to ${slots.length - 1} in quiz ${activityId}; ${after} isn't one.`);
+        }
+        let toggled = 0;
+        for (let i = 1; i < slots.length; i++) {
+            const wanted = pages.breaksAfter.includes(i);
+            const has = slots[i].page !== slots[i - 1].page;
+            if (wanted === has)
+                continue;
+            // The request names the slot after the break: 2 splits the page there, 1 joins it to the previous one.
+            await editRest(page, quizId, activityId, { class: "resource", field: "updatepagebreak", id: slots[i].id, value: wanted ? 2 : 1 });
+            toggled++;
+        }
+        const where = pages.breaksAfter.length > 0 ? `after slot${pages.breaksAfter.length === 1 ? "" : "s"} ${[...pages.breaksAfter].sort((a, b) => a - b).join(", ")}` : "nowhere (one page)";
+        return await afterChange(page, activityId, toggled > 0 ? `Quiz ${activityId}'s page breaks are now ${where}.` : `Quiz ${activityId} already had its page breaks ${where}.`);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * Adds a section to a quiz starting at a slot, with its heading and whether its questions are
+ * shuffled, as the edit page's "Add a new section heading" and its heading and shuffle controls do.
+ * A section starts at a page: the slot must be the first of its page (see `setQuizPages`).
+ */
+export async function addQuizSection(context, siteUrl, activityId, { firstSlot, heading, shuffle = false }) {
+    const page = await openEditPage(context, siteUrl, activityId);
+    try {
+        await checkEditable(page, activityId);
+        const quizId = await quizInstanceId(page, activityId);
+        const before = await readQuizEditor(page);
+        const first = slotAt(before.slots, firstSlot, activityId);
+        if (before.slots.some((s) => s.slot < firstSlot && s.page === first.page)) {
+            throw new QuizError(`Slot ${firstSlot} isn't the first of its page in quiz ${activityId}, and a section starts at a page: put a page break before it first.`);
+        }
+        let sectionId = before.sections.find((s) => s.firstSlot === firstSlot)?.id;
+        if (sectionId !== undefined)
+            throw new QuizError(`Quiz ${activityId} already has a section starting at slot ${firstSlot} (section ${sectionId}).`);
+        const { status, error } = await postEditPage(page, activityId, { addsectionatpage: String(first.page) });
+        if (error || status >= 400)
+            throw new QuizError(`Moodle didn't add a section to quiz ${activityId}: ${error ?? `HTTP ${status}`}.`);
+        await page.reload({ waitUntil: "domcontentloaded" });
+        sectionId = (await readQuizEditor(page)).sections.find((s) => !before.sections.some((old) => old.id === s.id))?.id;
+        if (sectionId === undefined)
+            throw new QuizError(`Moodle added no section to quiz ${activityId}.`);
+        await editRest(page, quizId, activityId, { class: "section", field: "updatesectiontitle", id: sectionId, newheading: heading });
+        if (shuffle)
+            await editRest(page, quizId, activityId, { class: "section", field: "updateshufflequestions", id: sectionId, newshuffle: 1 });
+        const result = await afterChange(page, activityId, `Added section "${heading}" to quiz ${activityId} at slot ${firstSlot}${shuffle ? ", its questions shuffled" : ""}.`);
+        return { ...result, sectionId };
     }
     finally {
         await page.close().catch(() => undefined);