@falkenslab/moodle-driver 0.0.0-stage → 0.4.0

package/dist/areas/scorm/scorm.d.ts

@@ -0,0 +1,60 @@
+import type { BrowserContext } from "playwright-core";
+import type { BrowserManager } from "../../browser/manager.js";
+import { MoodleError } from "../../core/errors.js";
+/** The activity isn't a SCORM the person can open, or Moodle didn't open its player. */
+export declare class ScormError extends MoodleError {
+    name: string;
+    constructor(message: string);
+}
+/** A SCO's status for the person, as Moodle tracks it from what the package reports. */
+export type ScoStatus = "not-attempted" | "incomplete" | "completed" | "passed" | "failed" | "browsed" | "suspended";
+/** A SCO (a launchable part of the package) with the person's status and score in the attempt read. */
+export interface ScormSco {
+    id: number;
+    title: string;
+    status?: ScoStatus;
+    score?: number;
+}
+export interface ScormActivity {
+    id: number;
+    name: string;
+    /** The activity's description, as HTML. */
+    description?: string;
+    /** Attempts the person may make: none means unlimited. */
+    attemptsAllowed?: number;
+    attemptsMade?: number;
+    /** How Moodle grades the activity, in the site's words ("Highest attempt"). */
+    gradingMethod?: string;
+    /** The grade reported to the gradebook, and each attempt's, as Moodle shows them ("100%"); none before the first attempt. */
+    grade?: string;
+    attemptGrades: {
+        attempt: number;
+        grade: string;
+    }[];
+    /** The SCOs with the person's status in their last attempt (the first, before any). */
+    scos: ScormSco[];
+}
+/** Where `openScorm` left the working tab: the player, at a SCO of an attempt. */
+export interface OpenedScorm {
+    attempt: number;
+    scoId: number;
+    /** The SCORM version the player speaks to the package with. */
+    version?: "SCORM 1.2" | "SCORM 2004" | "AICC";
+    url: string;
+}
+/**
+ * A SCORM activity as the person sees it: its attempts (allowed and made), the grading method, the
+ * grade reported and each attempt's, and its SCOs with the person's status and score in the last
+ * attempt. Moodle doesn't show a SCORM's version on its page: `openScorm` tells it.
+ */
+export declare function scorm(context: BrowserContext, siteUrl: string, activityId: number): Promise<ScormActivity>;
+/**
+ * Opens a SCORM in Moodle's player, in normal mode, on the browser's working tab (ADR-007), for the
+ * person (or a program driving the tab) to do it there: the last attempt continues unless `newAttempt`,
+ * at the activity's first SCO unless `scoId`. Resolves once the SCO's frame has loaded. Opening the
+ * player is what starts an attempt in Moodle.
+ */
+export declare function openScorm(browser: BrowserManager, siteUrl: string, activityId: number, options?: {
+    scoId?: number;
+    newAttempt?: boolean;
+}): Promise<OpenedScorm>;

package/dist/areas/scorm/scorm.js

@@ -0,0 +1,171 @@
+import { inPage } from "../../core/inPage.js";
+import { NotLoggedInError, openSitePage } from "../../core/session.js";
+import { siteFetch } from "../../core/http.js";
+import { decodeEntities } from "../../core/text.js";
+import { MoodleError } from "../../core/errors.js";
+/** The activity isn't a SCORM the person can open, or Moodle didn't open its player. */
+export class ScormError extends MoodleError {
+    name = "ScormError";
+    constructor(message) {
+        super(message, "scorm");
+    }
+}
+// The activity's page, never skipped to the player (which would start an attempt).
+const viewPath = (activityId) => `mod/scorm/view.php?id=${activityId}&preventskip=1`;
+function readView(page) {
+    // Through inPage: it has a helper function (see the conventions on page.evaluate).
+    return inPage(page, () => {
+        const g = globalThis;
+        const doc = g.document.body;
+        const form = doc.querySelector("#scormviewform");
+        const field = (name) => form?.querySelector(`input[name="${name}"]`)?.getAttribute("value") ?? undefined;
+        // Moodle's attempt status: one paragraph, its lines separated by <br>.
+        const status = doc.querySelector('[role="main"] .generalbox p');
+        const intro = doc.querySelector("#intro")?.innerHTML.trim();
+        return {
+            scorm: doc.id === "page-mod-scorm-view",
+            name: doc.querySelector("[data-activityname]")?.getAttribute("data-activityname") ?? "",
+            ...(intro ? { description: intro } : {}),
+            lines: (status?.innerHTML ?? "")
+                .split(/<br\s*\/?>/i)
+                .map((line) => line.replace(/<[^>]*>/g, "").trim())
+                .filter((line) => line !== ""),
+            ...(field("scoid") ? { scoId: Number(field("scoid")) } : {}),
+            ...(field("currentorg") !== undefined ? { org: field("currentorg") } : {}),
+            ...(g.M?.cfg?.sesskey ? { sesskey: g.M.cfg.sesskey } : {}),
+        };
+    }, null);
+}
+/** The SCOs of a table of contents (`prereqs.php`'s), status by icon and score by its "(label: value)": no wording read. */
+function readScos(page, html) {
+    // Through inPage: it has a helper function (see the conventions on page.evaluate).
+    return inPage(page, (toc) => {
+        const g = globalThis;
+        const doc = new g.DOMParser().parseFromString(toc, "text/html");
+        // Font Awesome 6's icons (Moodle 4.4+), then 4's, then the images older themes use.
+        const ICONS = [
+            [/\bfa-square-check\b|\bfa-check-square-o\b/, "completed"],
+            [/\bfa-pen-to-square\b|\bfa-pencil-square-o\b/, "incomplete"],
+            [/\bfa-square\b|\bfa-square-o\b/, "not-attempted"],
+            [/\bfa-xmark\b|\bfa-times\b/, "failed"],
+            [/\bfa-check\b/, "passed"],
+            [/\bfa-eye\b/, "browsed"],
+            [/\bfa-pause\b/, "suspended"],
+        ];
+        const IMAGES = [
+            [/notattempted/, "not-attempted"],
+            [/incomplete/, "incomplete"],
+            [/completed/, "completed"],
+            [/passed/, "passed"],
+            [/failed/, "failed"],
+            [/browsed/, "browsed"],
+            [/suspend/, "suspended"],
+        ];
+        const statusOf = (link) => {
+            const icon = link.querySelector("i.icon, i[class*='fa-']");
+            if (icon)
+                return ICONS.find(([pattern]) => pattern.test(icon.className))?.[1];
+            const src = link.querySelector("img")?.getAttribute("src") ?? "";
+            return IMAGES.find(([pattern]) => pattern.test(src))?.[1];
+        };
+        return Array.from(doc.querySelectorAll("a[data-scoid]")).map((link) => {
+            const text = (link.textContent ?? "").replace(/\s+/g, " ").trim();
+            const score = /\(\s*[^():]+:\s*(-?\d+(?:[.,]\d+)?)\s*\)\s*$/.exec(text);
+            const status = statusOf(link);
+            return {
+                id: Number(link.getAttribute("data-scoid")),
+                title: (score ? text.slice(0, score.index) : text).trim(),
+                ...(status ? { status } : {}),
+                ...(score ? { score: Number(score[1].replace(",", ".")) } : {}),
+            };
+        });
+    }, html);
+}
+const count = (value) => (value !== undefined && /^\d+$/.test(value) ? Number(value) : undefined);
+// What follows a status line's label ("Number of attempts you have made: 2").
+const valueOf = (line) => (line === undefined ? undefined : decodeEntities(line.slice(line.lastIndexOf(":") + 1)).trim());
+/**
+ * A SCORM activity as the person sees it: its attempts (allowed and made), the grading method, the
+ * grade reported and each attempt's, and its SCOs with the person's status and score in the last
+ * attempt. Moodle doesn't show a SCORM's version on its page: `openScorm` tells it.
+ */
+export async function scorm(context, siteUrl, activityId) {
+    const page = await openSitePage(context, siteUrl, viewPath(activityId));
+    try {
+        const facts = await readView(page);
+        if (!facts.scorm)
+            throw new ScormError(`Activity ${activityId} isn't a SCORM you can open. Take the id of a SCORM activity (module "scorm") from the course structure.`);
+        // Moodle's attempt status, by position: allowed, made, one grade per attempt, method, reported.
+        const made = count(valueOf(facts.lines[1]));
+        const grades = facts.lines.slice(2, 2 + (made ?? 0));
+        const tail = facts.lines.slice(2 + (made ?? 0));
+        const reported = made ? valueOf(tail[1]) : undefined;
+        const activity = {
+            id: activityId,
+            name: decodeEntities(facts.name),
+            ...(facts.description ? { description: facts.description } : {}),
+            ...(count(valueOf(facts.lines[0])) !== undefined ? { attemptsAllowed: count(valueOf(facts.lines[0])) } : {}),
+            ...(made !== undefined ? { attemptsMade: made } : {}),
+            ...(tail[0] ? { gradingMethod: valueOf(tail[0]) } : {}),
+            ...(reported ? { grade: reported } : {}),
+            attemptGrades: grades.map((line, i) => ({ attempt: i + 1, grade: valueOf(line) ?? "" })),
+            scos: [],
+        };
+        // The table of contents the player shows, without opening it (which would start an attempt).
+        if (facts.scoId !== undefined && facts.sesskey) {
+            const query = new URLSearchParams({ id: String(activityId), scoid: String(facts.scoId), attempt: String(made || 1), mode: "normal", currentorg: facts.org ?? "", sesskey: facts.sesskey });
+            const toc = await siteFetch(context, new URL(`mod/scorm/prereqs.php?${query}`, siteUrl).href);
+            if (new URL(toc.url).pathname.endsWith("/login/index.php"))
+                throw new NotLoggedInError();
+            if (toc.status === 200)
+                activity.scos = await readScos(page, toc.body);
+        }
+        return activity;
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/**
+ * Opens a SCORM in Moodle's player, in normal mode, on the browser's working tab (ADR-007), for the
+ * person (or a program driving the tab) to do it there: the last attempt continues unless `newAttempt`,
+ * at the activity's first SCO unless `scoId`. Resolves once the SCO's frame has loaded. Opening the
+ * player is what starts an attempt in Moodle.
+ */
+export async function openScorm(browser, siteUrl, activityId, options = {}) {
+    const context = await browser.context();
+    const view = await openSitePage(context, siteUrl, viewPath(activityId), { follow: false });
+    let facts;
+    try {
+        facts = await readView(view);
+    }
+    finally {
+        await view.close().catch(() => undefined);
+    }
+    if (!facts.scorm)
+        throw new ScormError(`Activity ${activityId} isn't a SCORM you can open. Take the id of a SCORM activity (module "scorm") from the course structure.`);
+    const scoId = options.scoId ?? facts.scoId;
+    if (scoId === undefined)
+        throw new ScormError(`SCORM ${activityId} can't be entered: Moodle offers no "Enter" on its page (closed, or no attempts left).`);
+    const query = new URLSearchParams({ cm: String(activityId), scoid: String(scoId), currentorg: facts.org ?? "", mode: "normal", newattempt: options.newAttempt ? "on" : "off" });
+    const tab = await browser.tab();
+    await tab.goto(new URL(`mod/scorm/player.php?${query}`, siteUrl).href, { waitUntil: "domcontentloaded" });
+    const html = await tab.content();
+    // M.scorm_api.init(…, sesskey, scoid, attempt, mode, …): what the player opened.
+    const init = /M\.scorm_api\.init\([\s\S]*?"[^"]*",\s*"?(\d+)"?,\s*"?(\d+)"?,\s*"(normal|browse|review)"/.exec(html);
+    if (!init) {
+        if (new URL(tab.url()).pathname.endsWith("/login/index.php"))
+            throw new NotLoggedInError();
+        throw new ScormError(`Moodle didn't open SCORM ${activityId}'s player (no attempts left, or the SCO isn't available yet).`);
+    }
+    const frame = await tab.waitForSelector("#scorm_object", { timeout: 30_000 }).catch(() => null);
+    if (!frame)
+        throw new ScormError(`SCORM ${activityId}'s player opened, but no SCO loaded in it.`);
+    // The frame opens Moodle's loadSCO.php ("loading, please wait"), which then goes to the SCO itself.
+    const sco = await frame.contentFrame();
+    await sco?.waitForURL((url) => !url.pathname.endsWith("/mod/scorm/loadSCO.php"), { timeout: 30_000, waitUntil: "load" }).catch(() => undefined);
+    const model = /mod\/scorm\/datamodels\/(scorm_12|scorm_13|aicc)\.js/.exec(html)?.[1];
+    const version = model === "scorm_12" ? "SCORM 1.2" : model === "scorm_13" ? "SCORM 2004" : model === "aicc" ? "AICC" : undefined;
+    return { attempt: Number(init[2]), scoId: Number(init[1]), ...(version ? { version } : {}), url: tab.url() };
+}
+//# sourceMappingURL=scorm.js.map

package/dist/areas/scorm/scorm.js.map

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

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