@falkenslab/moodle-driver 0.0.0-stage → 0.3.1

package/dist/areas/site/info.d.ts

@@ -0,0 +1,25 @@
+import type { BrowserContext } from "playwright-core";
+/**
+ * What the site tells anyone about itself, through Moodle's AJAX entry point for services that need
+ * no login (`service-nologin.php`): readable before logging in, without the browser. Moodle shows its
+ * version only to administrators, so it isn't here.
+ */
+export declare function publicSiteInfo(siteUrl: string, fetchImpl?: typeof fetch): Promise<{
+    supportPage?: string | undefined;
+    maintenance?: string | undefined;
+    login: {
+        guestAccess: boolean;
+        identityProviders: string[];
+        appLogin?: "app" | "browser" | "embedded" | undefined;
+    };
+    languages?: string[] | undefined;
+    name: string;
+    url: string;
+    language: string | undefined;
+}>;
+/** The activity and resource types the person can add to a course: none when they can't edit it. */
+export declare function courseActivityTypes(context: BrowserContext, siteUrl: string, courseId: number): Promise<{
+    purpose?: string | undefined;
+    type: string;
+    title: string;
+}[]>;

package/dist/areas/site/info.js

@@ -0,0 +1,45 @@
+import { callService, parseServiceResponse } from "../../core/ajax.js";
+import { decodeEntities } from "../../core/text.js";
+const TIMEOUT_MS = 60_000;
+// typeoflogin: how the mobile app is told to log in, which says whether the site uses its own form.
+const LOGIN_TYPES = { 1: "app", 2: "browser", 3: "embedded" };
+/**
+ * What the site tells anyone about itself, through Moodle's AJAX entry point for services that need
+ * no login (`service-nologin.php`): readable before logging in, without the browser. Moodle shows its
+ * version only to administrators, so it isn't here.
+ */
+export async function publicSiteInfo(siteUrl, fetchImpl = fetch) {
+    const methodname = "tool_mobile_get_public_config";
+    const response = await fetchImpl(new URL(`lib/ajax/service-nologin.php?info=${methodname}`, siteUrl).href, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify([{ index: 0, methodname, args: {} }]),
+        signal: AbortSignal.timeout(TIMEOUT_MS),
+    });
+    const config = parseServiceResponse(methodname, response.status, await response.text());
+    // "en|English,es|Español": the languages the menu offers; empty means every installed one.
+    const languages = (config.langlist ?? "").split(",").map((entry) => entry.split("|")[0]?.trim() ?? "").filter(Boolean);
+    return {
+        name: decodeEntities(config.sitename),
+        url: config.wwwroot,
+        language: config.lang,
+        ...(languages.length > 0 ? { languages } : {}),
+        login: {
+            ...(config.typeoflogin !== undefined && LOGIN_TYPES[config.typeoflogin] ? { appLogin: LOGIN_TYPES[config.typeoflogin] } : {}),
+            guestAccess: config.guestlogin === 1,
+            identityProviders: (config.identityproviders ?? []).map((p) => decodeEntities(p.name)),
+        },
+        ...(config.maintenanceenabled ? { maintenance: decodeEntities(config.maintenancemessage ?? "") || "The site is in maintenance mode." } : {}),
+        ...(config.supportpage ? { supportPage: config.supportpage } : {}),
+    };
+}
+/** The activity and resource types the person can add to a course: none when they can't edit it. */
+export async function courseActivityTypes(context, siteUrl, courseId) {
+    const { content_items: items } = await callService(context, siteUrl, "core_course_get_course_content_items", { courseid: courseId });
+    // A type with several items (LTI tools) is listed once.
+    const seen = new Set();
+    return items
+        .filter((item) => !seen.has(item.name) && seen.add(item.name))
+        .map((item) => ({ type: item.name, title: decodeEntities(item.title), ...(item.purpose ? { purpose: item.purpose } : {}) }));
+}
+//# sourceMappingURL=info.js.map

package/dist/areas/site/info.js.map

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

package/dist/areas/site/users.d.ts

@@ -0,0 +1,56 @@
+import type { BrowserContext } from "playwright-core";
+/** A user, with what Moodle lets the person see of them. */
+export interface User {
+    id: number;
+    username?: string;
+    fullName: string;
+    email?: string;
+    /** ISO 8601; none when they never came. */
+    firstAccess?: string;
+    lastAccess?: string;
+}
+/** A user by id, or `undefined` when Moodle gives nobody (no such user, or not one the person may see). */
+export declare function userById(context: BrowserContext, siteUrl: string, userId: number): Promise<User | undefined>;
+/** The site's name, from its public settings; `undefined` where the mobile app support is off. */
+export declare function siteName(context: BrowserContext, siteUrl: string): Promise<string | undefined>;
+/** A user's roles in a course, from their profile there: role links carry the role id in any language. */
+export declare function courseRoles(context: BrowserContext, siteUrl: string, userId: number, courseId: number): Promise<{
+    id: number;
+    name: string;
+}[]>;
+/**
+ * What the person can do in a course, asked of read-only services that need the capability: the
+ * activity types they can add (none without `moodle/course:manageactivities`) and the grader
+ * report's users (`nopermissions` without `gradereport/grader:view`). Nothing is changed.
+ */
+export declare function courseAbilities(context: BrowserContext, siteUrl: string, courseId: number, sectionId: number): Promise<{
+    canEdit: boolean;
+    canGrade: boolean;
+}>;
+export interface Me {
+    userId: number;
+    username?: string;
+    fullName: string;
+    email?: string;
+    /** The interface language in use. */
+    language: string;
+    timeZone: string;
+    firstAccess?: string;
+    lastAccess?: string;
+    site: {
+        name?: string;
+        url: string;
+    };
+    /** With a course: the person's roles there and what they can do. */
+    course?: {
+        id: number;
+        roles: {
+            id: number;
+            name: string;
+        }[];
+        canEdit: boolean;
+        canGrade: boolean;
+    };
+}
+/** Who the logged-in person is; with `courseId`, also their roles and abilities in that course. */
+export declare function whoAmI(context: BrowserContext, siteUrl: string, courseId?: number): Promise<Me>;

package/dist/areas/site/users.js

@@ -0,0 +1,89 @@
+import { MoodleServiceError, callService, readPageConfig } from "../../core/ajax.js";
+import { courseState } from "../courses/state.js";
+import { isoDate } from "../courses/list.js";
+import { openSitePage } from "../../core/session.js";
+import { decodeEntities } from "../../core/text.js";
+/** A user by id, or `undefined` when Moodle gives nobody (no such user, or not one the person may see). */
+export async function userById(context, siteUrl, userId) {
+    const [user] = await callService(context, siteUrl, "core_user_get_users_by_field", { field: "id", values: [String(userId)] });
+    if (!user)
+        return undefined;
+    return {
+        id: user.id,
+        ...(user.username !== undefined ? { username: user.username } : {}),
+        fullName: decodeEntities(user.fullname),
+        ...(user.email !== undefined ? { email: user.email } : {}),
+        ...(user.firstaccess ? { firstAccess: isoDate(user.firstaccess) } : {}),
+        ...(user.lastaccess ? { lastAccess: isoDate(user.lastaccess) } : {}),
+    };
+}
+/** The site's name, from its public settings; `undefined` where the mobile app support is off. */
+export async function siteName(context, siteUrl) {
+    try {
+        return (await callService(context, siteUrl, "tool_mobile_get_public_config", {})).sitename;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** A user's roles in a course, from their profile there: role links carry the role id in any language. */
+export async function courseRoles(context, siteUrl, userId, courseId) {
+    const page = await openSitePage(context, siteUrl, `user/view.php?id=${userId}&course=${courseId}`);
+    try {
+        return await page.evaluate(() => {
+            const links = globalThis.document.querySelectorAll('#region-main a[href*="/user/index.php"][href*="roleid="]');
+            const roles = new Map();
+            for (const link of Array.from(links)) {
+                const id = Number(new URL(link.href).searchParams.get("roleid"));
+                if (id > 0)
+                    roles.set(id, (link.textContent ?? "").trim());
+            }
+            return Array.from(roles, ([id, name]) => ({ id, name }));
+        });
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * What the person can do in a course, asked of read-only services that need the capability: the
+ * activity types they can add (none without `moodle/course:manageactivities`) and the grader
+ * report's users (`nopermissions` without `gradereport/grader:view`). Nothing is changed.
+ */
+export async function courseAbilities(context, siteUrl, courseId, sectionId) {
+    const items = await callService(context, siteUrl, "core_courseformat_get_section_content_items", { courseid: courseId, sectionid: sectionId });
+    let canGrade = true;
+    try {
+        await callService(context, siteUrl, "gradereport_grader_get_users_in_report", { courseid: courseId });
+    }
+    catch (error) {
+        if (!(error instanceof MoodleServiceError && error.errorcode === "nopermissions"))
+            throw error;
+        canGrade = false;
+    }
+    return { canEdit: items.content_items.length > 0, canGrade };
+}
+/** Who the logged-in person is; with `courseId`, also their roles and abilities in that course. */
+export async function whoAmI(context, siteUrl, courseId) {
+    const cfg = await readPageConfig(context, siteUrl);
+    const user = await userById(context, siteUrl, cfg.userId);
+    const me = {
+        userId: cfg.userId,
+        username: user?.username,
+        fullName: user?.fullName ?? "",
+        email: user?.email,
+        language: cfg.language,
+        timeZone: cfg.timeZone,
+        firstAccess: user?.firstAccess,
+        lastAccess: user?.lastAccess,
+        site: { name: await siteName(context, siteUrl), url: siteUrl },
+    };
+    if (courseId !== undefined) {
+        // The course's state checks that it exists and the person can see it, and gives a section.
+        const state = await courseState(context, siteUrl, courseId);
+        const abilities = await courseAbilities(context, siteUrl, courseId, Number(state.section[0]?.id ?? 0));
+        me.course = { id: courseId, roles: await courseRoles(context, siteUrl, cfg.userId, courseId), ...abilities };
+    }
+    return me;
+}
+//# sourceMappingURL=users.js.map

package/dist/areas/site/users.js.map

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

package/dist/areas/surveys/choice.d.ts

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

package/dist/areas/surveys/choice.js

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

package/dist/areas/surveys/choice.js.map

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

package/dist/areas/surveys/surveys.d.ts

@@ -0,0 +1,51 @@
+import type { BrowserContext, Page } from "playwright-core";
+import { MoodleError } from "../../core/errors.js";
+/** The two survey modules: the questionnaire plugin (mod_questionnaire) and Moodle's feedback. */
+export type SurveyType = "questionnaire" | "feedback";
+export declare class SurveyError extends MoodleError {
+    name: string;
+    constructor(message: string);
+}
+/** One field of a survey question, by its form name. */
+export interface SurveyField {
+    name: string;
+    kind: "choice" | "checkbox" | "text" | "select";
+    label?: string;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    value?: string;
+}
+export interface SurveyQuestion {
+    page: number;
+    number?: string;
+    text: string;
+    required: boolean;
+    fields: SurveyField[];
+}
+/** The questions on a survey page, with their fields read from the form (names, options, labels). */
+export declare function readSurveyPage(page: Page, type: SurveyType, pageNumber: number): Promise<SurveyQuestion[]>;
+/** Which survey module an activity is, from the page each module answers with its own view (body id). */
+export declare function surveyType(context: BrowserContext, siteUrl: string, activityId: number): Promise<SurveyType>;
+/** A survey (questionnaire or feedback): whether it can be answered, its intro and messages, and its questions page by page. Its module is found when not given. */
+export declare function getSurvey(context: BrowserContext, siteUrl: string, activityId: number, type?: SurveyType): Promise<{
+    questions: SurveyQuestion[];
+    canAnswer: boolean;
+    intro: string;
+    messages: string[];
+}>;
+/**
+ * Fills the survey page by page with `responses` (field name → value) and submits it on the last
+ * page. Every name is checked against the form first, so nothing is sent with a wrong one.
+ */
+export declare function submitSurvey(context: BrowserContext, siteUrl: string, activityId: number, type: SurveyType, responses: Record<string, string>): Promise<{
+    changed: string;
+    messages: string[];
+}>;
+export declare function submitSurvey(context: BrowserContext, siteUrl: string, activityId: number, responses: Record<string, string>, options?: {
+    type?: SurveyType;
+}): Promise<{
+    changed: string;
+    messages: string[];
+}>;

package/dist/areas/surveys/surveys.js

@@ -0,0 +1,201 @@
+import { setFields } from "../../core/forms.js";
+import { inPage } from "../../core/inPage.js";
+import { openSitePage } from "../../core/session.js";
+import { MoodleError } from "../../core/errors.js";
+export class SurveyError extends MoodleError {
+    name = "SurveyError";
+    constructor(message) {
+        super(message, "survey");
+    }
+}
+/** Where each module keeps its form, its questions, their text and their "required" mark. */
+const LAYOUT = {
+    questionnaire: { form: "#phpesp_response", question: "fieldset.qn-container", text: ".qn-question", required: "img.req", number: ".qn-number", next: "next", finish: "submit" },
+    feedback: { form: "form.feedback_form", question: ".feedback_itemlist", text: ".col-form-label", required: ".col-form-label .text-danger", number: ".itemnr", next: "gonextpage", finish: "savevalues" },
+};
+/** The questions on a survey page, with their fields read from the form (names, options, labels). */
+export function readSurveyPage(page, type, pageNumber) {
+    return inPage(page, ({ layout, pageNumber }) => {
+        const doc = globalThis.document;
+        // Text as shown, without what only screen readers get.
+        const text = (el) => {
+            if (!el)
+                return "";
+            const copy = el.cloneNode(true);
+            for (const hidden of Array.from(copy.querySelectorAll(".accesshide, .visually-hidden, .sr-only, input")))
+                hidden.remove();
+            doc.body.appendChild(copy);
+            const shown = copy.innerText ?? "";
+            copy.remove();
+            return shown.replace(/\s+/g, " ").trim();
+        };
+        // An option's label: its own <label for>, the label around it, or (a rating row) nothing.
+        const labelOf = (input) => {
+            const own = input.id ? doc.querySelector(`label[for="${input.id}"]:not(.accesshide)`) : null;
+            const around = input.closest("label");
+            return text(own ?? around) || undefined;
+        };
+        const form = doc.querySelector(layout.form);
+        if (!form)
+            return [];
+        return Array.from(form.querySelectorAll(layout.question)).map((question) => {
+            const fields = [];
+            for (const input of Array.from(question.querySelectorAll("input:not([type=hidden]), select, textarea"))) {
+                if (!input.name)
+                    continue;
+                if (input.type === "radio") {
+                    let field = fields.find((f) => f.name === input.name);
+                    if (!field) {
+                        // A rating row's item is the row's first cell.
+                        const row = input.closest("tr.raterow");
+                        field = { name: input.name, kind: "choice", options: [], ...(row ? { label: text(row.querySelector("td")) } : {}) };
+                        fields.push(field);
+                    }
+                    const label = labelOf(input);
+                    field.options.push({ value: input.value, label: label && !label.includes(",") ? label : input.value === "-999" ? "(no answer)" : (label ?? input.value) });
+                    if (input.checked)
+                        field.value = input.value;
+                }
+                else if (input.type === "checkbox") {
+                    fields.push({ name: input.name, kind: "checkbox", label: labelOf(input), value: input.checked ? "1" : "0" });
+                }
+                else if (input.tagName === "SELECT") {
+                    const options = Array.from(input.options);
+                    fields.push({ name: input.name, kind: "select", 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", ...(input.value ? { value: input.value } : {}) });
+                }
+            }
+            return {
+                page: pageNumber,
+                number: text(question.querySelector(layout.number)) || undefined,
+                text: text(question.querySelector(layout.text)),
+                required: question.querySelector(layout.required) !== null,
+                fields,
+            };
+        });
+    }, { layout: LAYOUT[type], pageNumber });
+}
+/** Whether the person can answer now, and the survey's page message (completed, closed…). */
+async function surveyStatus(context, siteUrl, activityId, type) {
+    const page = await openSitePage(context, siteUrl, `mod/${type}/view.php?id=${activityId}`);
+    try {
+        if ((await page.locator(`body#page-mod-${type}-view`).count()) === 0)
+            throw new SurveyError(`Activity ${activityId} isn't a ${type} you can open. Take its id and module from the course structure.`);
+        return await page.evaluate(() => {
+            const doc = globalThis.document;
+            return {
+                canAnswer: doc.querySelector('#region-main a[href*="complete.php"]') !== null,
+                intro: (doc.querySelector(".activity-description, #intro")?.innerText ?? "").trim(),
+                messages: Array.from(doc.querySelectorAll("#region-main .alert, #region-main .notifymessage, #region-main .complete, #region-main .generalbox p"))
+                    .map((e) => e.innerText.replace(/\s+/g, " ").trim())
+                    .filter(Boolean)
+                    .slice(0, 6),
+            };
+        });
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** Every page of the survey's form: feedback pages through `gopage`, questionnaire sections through `sec`. */
+async function readAllPages(context, siteUrl, activityId, type) {
+    const layout = LAYOUT[type];
+    const questions = [];
+    const page = await openSitePage(context, siteUrl, `mod/${type}/complete.php?id=${activityId}`);
+    try {
+        for (let p = 0; p < 50; p++) {
+            if (p > 0) {
+                const next = type === "feedback" ? `mod/feedback/complete.php?id=${activityId}&gopage=${p}` : `mod/questionnaire/complete.php?id=${activityId}&sec=${p + 1}`;
+                await page.goto(new URL(next, siteUrl).href, { waitUntil: "domcontentloaded" });
+            }
+            const found = await readSurveyPage(page, type, p);
+            if (found.length === 0)
+                break;
+            questions.push(...found);
+            if ((await page.locator(`${layout.form} [name="${layout.next}"]`).count()) === 0)
+                break;
+        }
+        return questions;
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+// A course module's module never changes: one look per survey and site, for the process.
+const surveyTypes = new Map();
+/** Which survey module an activity is, from the page each module answers with its own view (body id). */
+export async function surveyType(context, siteUrl, activityId) {
+    const key = `${siteUrl}|${activityId}`;
+    const known = surveyTypes.get(key);
+    if (known)
+        return known;
+    for (const type of ["questionnaire", "feedback"]) {
+        const page = await openSitePage(context, siteUrl, `mod/${type}/view.php?id=${activityId}`, { follow: false });
+        try {
+            if ((await page.locator(`body#page-mod-${type}-view`).count()) > 0) {
+                surveyTypes.set(key, type);
+                return type;
+            }
+        }
+        finally {
+            await page.close().catch(() => undefined);
+        }
+    }
+    throw new SurveyError(`Activity ${activityId} isn't a questionnaire or a feedback activity you can open. Take its id and module from the course structure.`);
+}
+/** A survey (questionnaire or feedback): whether it can be answered, its intro and messages, and its questions page by page. Its module is found when not given. */
+export async function getSurvey(context, siteUrl, activityId, type) {
+    type ??= await surveyType(context, siteUrl, activityId);
+    const status = await surveyStatus(context, siteUrl, activityId, type);
+    return { ...status, questions: status.canAnswer ? await readAllPages(context, siteUrl, activityId, type) : [] };
+}
+export async function submitSurvey(context, siteUrl, activityId, typeOrResponses, responsesOrOptions) {
+    // (activityId, type, responses), as before 0.2, or (activityId, responses, { type }), the module found when not given.
+    const responses = (typeof typeOrResponses === "string" ? responsesOrOptions : typeOrResponses);
+    const type = typeof typeOrResponses === "string" ? typeOrResponses : (responsesOrOptions?.type ?? (await surveyType(context, siteUrl, activityId)));
+    const layout = LAYOUT[type];
+    const status = await surveyStatus(context, siteUrl, activityId, type);
+    if (!status.canAnswer)
+        throw new SurveyError(`You can't answer ${type} ${activityId} now: ${status.messages.join(" ") || "it's completed, closed or not open yet"}.`);
+    const known = new Set((await readAllPages(context, siteUrl, activityId, type)).flatMap((q) => q.fields.map((f) => f.name)));
+    const unknown = Object.keys(responses).filter((name) => !known.has(name));
+    if (unknown.length > 0)
+        throw new SurveyError(`The survey has no field ${unknown.join(", ")}: take the names from the survey's questions.`);
+    const page = await openSitePage(context, siteUrl, `mod/${type}/complete.php?id=${activityId}`);
+    try {
+        for (let p = 0; p < 50; p++) {
+            const here = new Set((await readSurveyPage(page, type, p)).flatMap((q) => q.fields.map((f) => f.name)));
+            const values = Object.fromEntries(Object.entries(responses).filter(([name]) => here.has(name)));
+            await setFields(page, values, layout.form);
+            const last = (await page.locator(`${layout.form} [name="${layout.next}"]`).count()) === 0;
+            const [response] = await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), page.click(`${layout.form} [name="${last ? layout.finish : layout.next}"]`)]);
+            if (response && response.status() >= 500) {
+                throw new SurveyError(`The site answered ${response.status()} ${last ? "on submitting" : "on the way"}; it may or may not have recorded the answers. Read the survey again before trying again.`);
+            }
+            // Moodle sends the page back when something's missing or wrong.
+            const problems = await page.evaluate((form) => {
+                const doc = globalThis.document;
+                const messages = Array.from(doc.querySelectorAll(`${form} [id^="id_error_"], #region-main .alert-danger`)).map((e) => {
+                    // Without the notification's close button ("Dismiss this notification").
+                    const copy = e.cloneNode(true);
+                    for (const button of Array.from(copy.querySelectorAll("button, .close, .visually-hidden")))
+                        button.remove();
+                    const text = (copy.innerText ?? e.innerText).replace(/\s+/g, " ").trim();
+                    return text ? `${e.id ? e.id.replace("id_error_", "") + ": " : ""}${text}` : "";
+                });
+                return [...new Set(messages.filter(Boolean))];
+            }, layout.form);
+            if (problems.length > 0)
+                throw new SurveyError(`Moodle didn't accept the answers on page ${p + 1}: ${problems.join("; ")}`);
+            if (last)
+                break;
+        }
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+    return { changed: `Submitted ${type} ${activityId}.`, messages: (await surveyStatus(context, siteUrl, activityId, type)).messages };
+}
+//# sourceMappingURL=surveys.js.map