@falkenslab/moodle-driver 0.0.0-stage → 0.3.1

package/dist/moodle/quiz.js

@@ -0,0 +1,291 @@
+import { dateSelectorValues, openForm, setFields, submitForm } from "./forms.js";
+import { pause, readingSeconds } from "./pace.js";
+import { inPage } from "./inPage.js";
+import { NotLoggedInError, openSitePage } from "./session.js";
+/** The quiz or attempt isn't there, or the person can't do what was asked. */
+export class QuizError extends Error {
+    name = "QuizError";
+}
+const NOT_A_QUIZ = (id) => new QuizError(`Activity ${id} isn't a quiz you can open. Take the id of a quiz (module "quiz") from the course structure.`);
+export function readQuizView(page) {
+    return inPage(page, () => {
+        const doc = globalThis.document;
+        const text = (el) => (el?.innerText ?? "").replace(/[ \t]+/g, " ").trim();
+        const attempts = Array.from(doc.querySelectorAll(".card")).flatMap((card) => {
+            if (!card.querySelector("table.quizreviewsummary"))
+                return [];
+            const link = card.querySelector('a[href*="review.php?attempt="], a[href*="attempt.php?attempt="]');
+            const href = link?.getAttribute("href") ?? "";
+            const id = Number(/attempt=(\d+)/.exec(href)?.[1]);
+            const details = Array.from(card.querySelectorAll("table.quizreviewsummary tr")).map((row) => ({ label: text(row.querySelector("th")), value: text(row.querySelector("td")) }));
+            return id ? [{ attemptId: id, inProgress: /\/attempt\.php/.test(href), details }] : [];
+        });
+        return {
+            intro: text(doc.querySelector("#intro")),
+            info: Array.from(doc.querySelectorAll(".quizinfo p")).map((p) => text(p)),
+            dates: Array.from(doc.querySelectorAll('[data-region="activity-dates"] .date-item')).map((item) => {
+                const label = text(item.querySelector(".date-item-label"));
+                return { label: label.replace(/:$/, ""), value: text(item).slice(label.length).trim() };
+            }),
+            feedback: text(doc.querySelector("#feedback")) || undefined,
+            attempts,
+            canStart: doc.querySelector('form[action*="startattempt.php"]') !== null,
+            messages: Array.from(doc.querySelectorAll(".quizattempt p, .quizattempt .alert")).map((p) => text(p)).filter(Boolean),
+        };
+    }, null);
+}
+/** The questions on an attempt or review page, with their fields read from the form. */
+export function readQuestions(page) {
+    return inPage(page, () => {
+        const doc = globalThis.document;
+        // Text as the page shows it, without what only screen readers get ("Answer Question 4").
+        const text = (el) => {
+            if (!el)
+                return "";
+            const copy = el.cloneNode(true);
+            for (const hidden of Array.from(copy.querySelectorAll(".accesshide, .visually-hidden, .sr-only")))
+                hidden.remove();
+            doc.body.appendChild(copy);
+            const shown = copy.innerText ?? "";
+            copy.remove();
+            return shown.replace(/[ \t]+/g, " ").trim();
+        };
+        return Array.from(doc.querySelectorAll(".que")).flatMap((q) => {
+            const match = /^question-\d+-(\d+)$/.exec(q.id);
+            if (!match)
+                return [];
+            const classes = q.className.split(/\s+/);
+            const fields = [];
+            const inputs = Array.from(q.querySelectorAll("input:not([type=hidden]), select, textarea")).filter((input) => !/:flagged$|_:sequencecheck$/.test(input.name) && input.name);
+            for (const input of inputs) {
+                // An option's label, without its "a." numbering: the element named after the input, or its row.
+                const labelEl = (doc.getElementById(`${input.id}_label`) ?? input.closest(".answer > div, label"))?.cloneNode(true);
+                for (const numbering of Array.from(labelEl?.querySelectorAll(".answernumber") ?? []))
+                    numbering.remove();
+                const label = labelEl ? (labelEl.innerText ?? "").replace(/\s+/g, " ").trim() : undefined;
+                if (input.type === "radio") {
+                    let field = fields.find((f) => f.name === input.name);
+                    if (!field) {
+                        field = { name: input.name, kind: "choice", options: [] };
+                        fields.push(field);
+                    }
+                    // A single-choice question's hidden "clear my choice" radio has the value -1 and no label of its own.
+                    field.options.push({ value: input.value, label: label || (input.value === "-1" ? "(clear my choice)" : input.value) });
+                    if (input.checked)
+                        field.value = input.value;
+                }
+                else if (input.type === "checkbox") {
+                    fields.push({ name: input.name, kind: "checkbox", label, value: input.checked ? "1" : "0" });
+                }
+                else if (input.tagName === "SELECT") {
+                    const options = Array.from(input.options);
+                    fields.push({
+                        name: input.name,
+                        kind: "select",
+                        label: text(input.closest("tr")?.querySelector(".text")) || undefined,
+                        options: options.map((o) => ({ value: o.value, label: o.text.trim() })),
+                        value: options.find((o) => o.selected)?.value,
+                    });
+                }
+                else {
+                    fields.push({ name: input.name, kind: "text", value: input.value || undefined });
+                }
+            }
+            return [
+                {
+                    slot: Number(match[1]),
+                    number: text(q.querySelector(".qno")) || undefined,
+                    type: classes[1] ?? "",
+                    state: classes[3] ?? "",
+                    mark: text(q.querySelector(".info .grade")) || undefined,
+                    text: text(q.querySelector(".qtext")),
+                    images: Array.from(q.querySelectorAll(".qtext img")).map((img) => img.src),
+                    fields,
+                    feedback: [text(q.querySelector(".specificfeedback")), text(q.querySelector(".generalfeedback"))].filter(Boolean).join("\n") || undefined,
+                    rightAnswer: text(q.querySelector(".rightanswer")) || undefined,
+                },
+            ];
+        });
+    }, null);
+}
+/** The pages of an attempt, from its navigation: slot → page. */
+export function readNavigation(page) {
+    return page.evaluate(() => {
+        const buttons = globalThis.document.querySelectorAll('.qnbutton[id^="quiznavbutton"]');
+        const pages = {};
+        for (const button of Array.from(buttons))
+            pages[Number(button.id.slice("quiznavbutton".length))] = Number(button.getAttribute("data-quiz-page") ?? 0);
+        return pages;
+    });
+}
+export async function quizInfo(context, siteUrl, quizId) {
+    const page = await openSitePage(context, siteUrl, `mod/quiz/view.php?id=${quizId}`);
+    try {
+        if ((await page.locator("body#page-mod-quiz-view").count()) === 0)
+            throw NOT_A_QUIZ(quizId);
+        return await readQuizView(page);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** Starts an attempt, or continues the one in progress, as the quiz page's button does; returns its id. */
+export async function startAttempt(context, siteUrl, quizId) {
+    const page = await openSitePage(context, siteUrl, `mod/quiz/view.php?id=${quizId}`);
+    try {
+        if ((await page.locator("body#page-mod-quiz-view").count()) === 0)
+            throw NOT_A_QUIZ(quizId);
+        const start = page.locator('form[action*="startattempt.php"] [type="submit"]').first();
+        if ((await start.count()) === 0)
+            throw new QuizError(`You can't start an attempt at quiz ${quizId} now: ${(await readQuizView(page)).messages.join(" ") || "see the quiz's information"}.`);
+        await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), start.click()]);
+        // A time limit or a password first asks for confirmation on a form of its own.
+        if ((await page.locator("#mod_quiz_preflight_form, form[action*='startattempt.php'] [name='submitbutton']").count()) > 0) {
+            if ((await page.locator("#mod_quiz_preflight_form [name='quizpassword']").count()) > 0)
+                throw new QuizError(`Quiz ${quizId} asks for a password, which this server doesn't type.`);
+            await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), page.click("[name='submitbutton']")]);
+        }
+        const id = Number(new URL(page.url()).searchParams.get("attempt"));
+        if (!id)
+            throw new QuizError(`Quiz ${quizId} didn't open an attempt (it landed on ${new URL(page.url()).pathname}).`);
+        return id;
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** Every question of an attempt, page by page, with the page each is on. */
+export async function readAttempt(context, siteUrl, attemptId) {
+    const page = await openSitePage(context, siteUrl, `mod/quiz/attempt.php?attempt=${attemptId}&page=0`);
+    try {
+        if ((await page.locator("#responseform").count()) === 0)
+            throw new QuizError(`Attempt ${attemptId} isn't open: it's finished, or not yours. Read its review instead.`);
+        const pages = await readNavigation(page);
+        const last = Math.max(0, ...Object.values(pages));
+        const questions = [];
+        for (let p = 0; p <= last; p++) {
+            if (p > 0)
+                await page.goto(new URL(`mod/quiz/attempt.php?attempt=${attemptId}&page=${p}`, siteUrl).href, { waitUntil: "domcontentloaded" });
+            for (const question of await readQuestions(page))
+                questions.push({ ...question, page: p });
+        }
+        return questions;
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * Saves answers page by page, as the attempt's "next" button does; `beforeSave` runs with each
+ * page's questions (the realistic trail's reading pause). Throws, saving nothing more, on a field
+ * a page doesn't have.
+ */
+export async function saveAnswers(context, siteUrl, attemptId, answers, beforeSave) {
+    const page = await openSitePage(context, siteUrl, `mod/quiz/attempt.php?attempt=${attemptId}&page=0`);
+    try {
+        if ((await page.locator("#responseform").count()) === 0)
+            throw new QuizError(`Attempt ${attemptId} isn't open: it's finished, or not yours.`);
+        const pages = await readNavigation(page);
+        const byPage = new Map();
+        for (const answer of answers) {
+            const p = pages[answer.slot];
+            if (p === undefined)
+                throw new QuizError(`Attempt ${attemptId} has no question in slot ${answer.slot}.`);
+            byPage.set(p, { ...byPage.get(p), ...answer.responses });
+        }
+        for (const [p, responses] of [...byPage].sort(([a], [b]) => a - b)) {
+            await page.goto(new URL(`mod/quiz/attempt.php?attempt=${attemptId}&page=${p}`, siteUrl).href, { waitUntil: "domcontentloaded" });
+            await setFields(page, responses, "#responseform");
+            await beforeSave?.(await readQuestions(page));
+            await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), page.click('#responseform [name="next"]')]);
+        }
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** Submits the attempt for grading, as "Submit all and finish" does, without its confirm dialog. */
+export async function finishAttempt(context, siteUrl, attemptId) {
+    const page = await openSitePage(context, siteUrl, `mod/quiz/summary.php?attempt=${attemptId}`);
+    try {
+        const form = page.locator('form[action*="processattempt.php"]:has([name="finishattempt"])');
+        if ((await form.count()) === 0)
+            throw new QuizError(`Attempt ${attemptId} can't be finished: it's already finished, or not yours.`);
+        await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), form.evaluate((f) => f.submit())]);
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** A finished attempt's review, as far as the quiz's review options let the person see it. */
+export async function readReview(context, siteUrl, attemptId) {
+    const page = await openSitePage(context, siteUrl, `mod/quiz/review.php?attempt=${attemptId}&showall=1`);
+    try {
+        if ((await page.locator("body#page-mod-quiz-review").count()) === 0)
+            throw new QuizError(`Attempt ${attemptId}'s review isn't available to you (not finished, not yours, or the quiz doesn't show reviews yet).`);
+        const summary = await page.evaluate(() => Array.from(globalThis.document.querySelectorAll("table.quizreviewsummary tr")).map((row) => ({ label: (row.querySelector("th")?.innerText ?? "").trim(), value: (row.querySelector("td")?.innerText ?? "").replace(/\s+/g, " ").trim() })));
+        return { summary, questions: await readQuestions(page) };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** Starts an attempt, or continues the one in progress, and gives its questions. */
+export async function startQuizAttempt(context, siteUrl, quizId) {
+    const attemptId = await startAttempt(context, siteUrl, quizId);
+    return { attemptId, questions: await readAttempt(context, siteUrl, attemptId) };
+}
+/**
+ * Saves answers in an attempt in progress without finishing it, and gives its questions afterwards.
+ * With the realistic trail, it first takes the time a reader needs for the questions and their
+ * options (ADR-005), calling `onProgress` with the seconds elapsed and the total.
+ */
+export async function answerQuizQuestions(context, siteUrl, attemptId, answers, { trail = "realistic", onProgress } = {}) {
+    const beforeSave = trail === "realistic"
+        ? async (questions) => {
+            const seconds = readingSeconds(questions.map((q) => [q.text, ...q.fields.flatMap((f) => [f.label ?? "", ...(f.options ?? []).map((o) => o.label)])].join(" ")).join(" "));
+            await pause(seconds, (elapsed) => onProgress?.(elapsed, seconds));
+        }
+        : undefined;
+    await saveAnswers(context, siteUrl, attemptId, answers, beforeSave);
+    return { attemptId, questions: await readAttempt(context, siteUrl, attemptId) };
+}
+/** Submits an attempt for grading, and gives its review when the quiz shows it. */
+export async function finishQuizAttempt(context, siteUrl, attemptId) {
+    await finishAttempt(context, siteUrl, attemptId);
+    const review = await readReview(context, siteUrl, attemptId).catch(() => undefined);
+    return { attemptId, finished: true, review };
+}
+/**
+ * Sets a user override on a quiz, through its override form: other opening and closing dates, a time
+ * limit in minutes, or a number of attempts (0 unlimited); what isn't given stays the quiz's.
+ */
+export async function setQuizOverride(context, siteUrl, quizId, userId, { open, close, timeLimitMinutes, attempts }) {
+    const page = await openForm(context, siteUrl, `mod/quiz/overrideedit.php?action=adduser&cmid=${quizId}`).catch((error) => {
+        if (error instanceof NotLoggedInError)
+            throw error;
+        throw new QuizError(`You can't add overrides to activity ${quizId}: it isn't a quiz, or you aren't allowed.`);
+    });
+    try {
+        const values = { userid: String(userId) };
+        if (open)
+            Object.assign(values, { "timeopen[enabled]": true, ...(await dateSelectorValues(page, "timeopen", open)) });
+        if (close)
+            Object.assign(values, { "timeclose[enabled]": true, ...(await dateSelectorValues(page, "timeclose", close)) });
+        if (timeLimitMinutes !== undefined)
+            Object.assign(values, { "timelimit[enabled]": true, "timelimit[number]": timeLimitMinutes, "timelimit[timeunit]": 60 });
+        if (attempts !== undefined)
+            values.attempts = String(attempts);
+        const offered = await page.evaluate((user) => globalThis.document.querySelector(`form.mform select[name="userid"] option[value="${user}"]`) !== null, userId);
+        if (!offered)
+            throw new QuizError(`User ${userId} can't get an override in quiz ${quizId}: not a participant, or already overridden (change that override in Moodle).`);
+        await setFields(page, values);
+        await submitForm(page, "submitbutton");
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+    const what = [open && `opens ${open.toISOString()}`, close && `closes ${close.toISOString()}`, timeLimitMinutes !== undefined && `${timeLimitMinutes} minutes`, attempts !== undefined && `${attempts || "unlimited"} attempts`].filter(Boolean);
+    return { changed: `Override for user ${userId} in quiz ${quizId}: ${what.join(", ") || "the quiz's settings"}.` };
+}
+//# sourceMappingURL=quiz.js.map

package/dist/moodle/quiz.js.map

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

package/dist/moodle/quizResults.d.ts

@@ -0,0 +1,36 @@
+import type { BrowserContext, Page } from "playwright-core";
+export interface QuizAttemptResult {
+    attemptId: number;
+    userId: number;
+    fullName: string;
+    /** As the report shows them, in the site's language. */
+    state?: string;
+    started?: string;
+    completed?: string;
+    duration?: string;
+    grade?: string;
+    questions: {
+        slot: number;
+        /** The mark (overview) as shown; "-" left out. */
+        mark?: string;
+        /** The answer given, with `responses` (the responses report). */
+        response?: string;
+        /** How it was marked: "correct", "incorrect", "partiallycorrect", "notanswered", "requiresgrading"… */
+        result?: string;
+    }[];
+}
+/** 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[]>;
+/**
+ * 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.
+ * Every page of the report.
+ */
+export declare function quizResults(context: BrowserContext, siteUrl: string, quizId: number, { responses }?: {
+    responses?: boolean;
+}): Promise<{
+    quiz: {
+        id: number;
+    };
+    attempts: QuizAttemptResult[];
+}>;

package/dist/moodle/quizResults.js

@@ -0,0 +1,93 @@
+import { inPage } from "./inPage.js";
+import { QuizError } from "./quiz.js";
+import { moodleErrorMessage, openSitePage } from "./session.js";
+/** One report page's rows: ids from inputs and links, the grade column by its class, the rest by position from it. */
+export function readQuizReport(page, mode) {
+    return inPage(page, (mode) => {
+        const doc = globalThis.document;
+        const table = doc.querySelector("#attempts") ?? doc.querySelector("#region-main table.generaltable");
+        if (!table)
+            return [];
+        const clean = (s) => (s ?? "").replace(/\s+/g, " ").trim();
+        // The grade column is the bold one that isn't the name's (sticky).
+        const headers = Array.from(table.querySelectorAll("thead th"));
+        const gradeAt = headers.findIndex((th) => /\bbold\b/.test(th.className) && !/\bsticky-column\b/.test(th.className));
+        return Array.from(table.querySelectorAll("tbody tr")).flatMap((row) => {
+            const attemptId = Number(row.querySelector('input[name="attemptid[]"]')?.value);
+            const user = row.querySelector('td:not(.picture) a[href*="/user/view.php?id="]');
+            if (!attemptId || !user)
+                return [];
+            const cells = Array.from(row.querySelectorAll("td"));
+            const at = (i) => (i >= 0 && cells[i] ? clean(cells[i].textContent) || undefined : undefined);
+            const questions = cells.flatMap((cell) => {
+                const link = cell.querySelector('a[href*="reviewquestion.php"]');
+                const slot = Number(new URL(link?.getAttribute("href") ?? "", "http://x/").searchParams.get("slot"));
+                if (!link || !slot)
+                    return [];
+                const shown = link.querySelector(".que span:last-child") ?? link;
+                const value = clean(shown.textContent);
+                const result = (shown.className.split(/\s+/).find(Boolean) ?? "") || undefined;
+                return [{ slot, ...(value && value !== "-" ? (mode === "responses" ? { response: value } : { mark: value }) : {}), ...(result ? { result } : {}) }];
+            });
+            // Overview: state, started, completed and duration come right before the grade; responses: the state alone.
+            const before = mode === "overview" ? [4, 3, 2, 1] : [1];
+            const [state, started, completed, duration] = before.map((n) => at(gradeAt - n));
+            return [
+                {
+                    attemptId,
+                    userId: Number(new URL(user.getAttribute("href") ?? "", "http://x/").searchParams.get("id")),
+                    fullName: clean(user.textContent),
+                    ...(state ? { state } : {}),
+                    ...(started ? { started } : {}),
+                    ...(completed ? { completed } : {}),
+                    ...(duration ? { duration } : {}),
+                    ...(at(gradeAt) && at(gradeAt) !== "-" ? { grade: at(gradeAt) } : {}),
+                    questions,
+                },
+            ];
+        });
+    }, mode);
+}
+const MAX_PAGES = 100;
+async function readReport(context, siteUrl, quizId, mode) {
+    const all = new Map();
+    for (let p = 0; p < MAX_PAGES; p++) {
+        const page = await openSitePage(context, siteUrl, `mod/quiz/report.php?id=${quizId}&mode=${mode}&attempts=enrolled_with&page=${p}`);
+        try {
+            if ((await page.locator("body#page-mod-quiz-report").count()) === 0 || (await moodleErrorMessage(page)) !== undefined) {
+                throw new QuizError(`You can't see quiz ${quizId}'s results: ${(await moodleErrorMessage(page)) ?? "it isn't a quiz, or you aren't allowed"}`);
+            }
+            const rows = await readQuizReport(page, mode);
+            const fresh = rows.filter((row) => !all.has(row.attemptId));
+            if (fresh.length === 0)
+                break;
+            for (const row of fresh)
+                all.set(row.attemptId, row);
+        }
+        finally {
+            await page.close().catch(() => undefined);
+        }
+    }
+    return Array.from(all.values());
+}
+/**
+ * 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.
+ * Every page of the report.
+ */
+export async function quizResults(context, siteUrl, quizId, { responses = false } = {}) {
+    const attempts = await readReport(context, siteUrl, quizId, "overview");
+    if (responses) {
+        const answered = new Map((await readReport(context, siteUrl, quizId, "responses")).map((row) => [row.attemptId, row]));
+        for (const attempt of attempts) {
+            const other = answered.get(attempt.attemptId);
+            for (const question of attempt.questions) {
+                const response = other?.questions.find((q) => q.slot === question.slot)?.response;
+                if (response !== undefined)
+                    question.response = response;
+            }
+        }
+    }
+    return { quiz: { id: quizId }, attempts };
+}
+//# sourceMappingURL=quizResults.js.map

package/dist/moodle/quizResults.js.map

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

package/dist/moodle/quizStructure.d.ts

@@ -0,0 +1,42 @@
+import type { BrowserContext, Page } from "playwright-core";
+export interface QuizSlot {
+    /** Moodle's id for the slot, and its question number. */
+    slotId: number;
+    number?: number;
+    page: number;
+    /** The question's id; none for a random slot. */
+    questionId?: number;
+    /** The question type ("multichoice"…), "random" for a random question. */
+    type: string;
+    name: string;
+    mark?: string;
+}
+/** The edit page's slots in order, each with the page it's on; read by ids, classes and links. */
+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. */
+export declare function quizStructure(context: BrowserContext, siteUrl: string, quizId: number): Promise<{
+    quiz: {
+        id: number;
+    };
+    slots: QuizSlot[];
+}>;
+/**
+ * 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
+ * already attempted can't change its questions: Moodle refuses, and so does this.
+ */
+export declare function addQuestionsToQuiz(context: BrowserContext, siteUrl: string, quizId: number, { questionIds, random, page: onPage }: {
+    questionIds?: number[];
+    random?: {
+        categoryId: number;
+        count: number;
+        includeSubcategories?: boolean;
+    };
+    page?: number;
+}): Promise<{
+    changed: string;
+    quiz: {
+        id: number;
+    };
+    slots: QuizSlot[];
+}>;

package/dist/moodle/quizStructure.js

@@ -0,0 +1,100 @@
+import { QuizError } from "./quiz.js";
+import { moodleErrorMessage, openSitePage } from "./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) {
+    return page.evaluate(() => {
+        const doc = globalThis.document;
+        const slots = [];
+        let current = 0;
+        for (const item of Array.from(doc.querySelectorAll("li.page, li.slot"))) {
+            const page = /^page-(\d+)$/.exec(item.id);
+            if (page) {
+                current = Number(page[1]);
+                continue;
+            }
+            const slotId = Number(/^slot-(\d+)$/.exec(item.id)?.[1]);
+            if (!slotId)
+                continue;
+            // A random slot (a question set reference in Moodle 5) has an empty "qtype_" class (confirmed empirically, 5.2).
+            const type = /\bqtype_([a-z0-9_]*)/.exec(item.className)?.[1] || "random";
+            const edit = item.querySelector('a[href*="/question/bank/editquestion/question.php"]');
+            const questionId = Number(new URL(edit?.getAttribute("href") ?? "", "http://x/").searchParams.get("id")) || undefined;
+            const number = Number(((item.querySelector(".slotnumber.unshuffled") ?? item.querySelector(".slotnumber"))?.textContent ?? "").replace(/\D+/g, "")) || undefined;
+            const mark = (item.querySelector(".instancemaxmark")?.textContent ?? "").replace(/\s+/g, " ").trim() || undefined;
+            slots.push({
+                slotId,
+                ...(number ? { number } : {}),
+                page: current,
+                ...(questionId && type !== "random" ? { questionId } : {}),
+                type,
+                name: (item.querySelector(".questionname")?.textContent ?? item.querySelector(".instancename")?.textContent ?? "").replace(/\s+/g, " ").trim(),
+                ...(mark ? { mark } : {}),
+            });
+        }
+        return slots;
+    });
+}
+async function openEditPage(context, siteUrl, quizId) {
+    const page = await openSitePage(context, siteUrl, `mod/quiz/edit.php?cmid=${quizId}`);
+    if ((await page.locator("body#page-mod-quiz-edit").count()) === 0) {
+        const reason = await moodleErrorMessage(page);
+        await page.close().catch(() => undefined);
+        throw new QuizError(`You can't edit quiz ${quizId}: ${reason ?? "it isn't a quiz, or you aren't allowed"}.`);
+    }
+    return page;
+}
+/** A quiz's questions as its edit page lists them: slots with their page, question, type, name and mark. */
+export async function quizStructure(context, siteUrl, quizId) {
+    const page = await openEditPage(context, siteUrl, quizId);
+    try {
+        return { quiz: { id: quizId }, slots: await readQuizSlots(page) };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * 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
+ * already attempted can't change its questions: Moodle refuses, and so does this.
+ */
+export async function addQuestionsToQuiz(context, siteUrl, quizId, { questionIds = [], random, page: onPage }) {
+    if (questionIds.length === 0 && !random)
+        throw new QuizError("Give the questions to add: their ids, or a category to draw random ones from.");
+    const page = await openEditPage(context, siteUrl, quizId);
+    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 ${quizId} can't change its questions now: it has attempts already. Make a new quiz, or delete its attempts in Moodle.`);
+        }
+        const before = (await readQuizSlots(page)).length;
+        const posts = [];
+        if (questionIds.length > 0)
+            posts.push({ add: "1", addonpage: String(onPage ?? 0), ...Object.fromEntries(questionIds.map((id) => [`q${id}`, "1"])) });
+        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 });
+            if (status >= 400)
+                throw new QuizError(`Moodle answered ${status} adding questions to quiz ${quizId}: check the questions' ids and the category.`);
+        }
+        await page.reload({ waitUntil: "domcontentloaded" });
+        const slots = await readQuizSlots(page);
+        const added = slots.length - before;
+        if (added <= 0)
+            throw new QuizError(`Moodle added no question to quiz ${quizId}: check the questions' ids (from the bank) and the category.`);
+        return { changed: `Added ${added} question${added === 1 ? "" : "s"} to quiz ${quizId}.`, quiz: { id: quizId }, slots };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=quizStructure.js.map

package/dist/moodle/quizStructure.js.map

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