@falkenslab/moodle-driver 0.0.0-stage → 0.3.1

package/dist/internals.js

@@ -0,0 +1,15 @@
+// @falkenslab/moodle-driver/internals: the primitives the operations are built from, for a program
+// that goes lower level than them (a service the driver doesn't wrap, a form of its own, a page read
+// by hand). Stable as the main entry is, but closer to Moodle: they take pages and form names.
+export { callService, readPageConfig } from "./core/ajax.js";
+export { openSitePage, fetchSitePage, readSessionFacts, htmlSessionFacts, readMoodleConfig, isLoggedIn, pageIsLoggedIn, moodleErrorMessage } from "./core/session.js";
+export { readOwnProfile } from "./core/login.js";
+export { openForm, formValue, setFields, submitForm, uploadToDraft, dateSelectorValues, dateSelectorDate } from "./core/forms.js";
+export { inPage } from "./core/inPage.js";
+export { decodeEntities, readTexts, readMedia } from "./core/text.js";
+export { readingSeconds, pause } from "./core/pace.js";
+export { editCourse, renameActivity, renameSection } from "./core/editor.js";
+export { readWwwroot } from "./core/site.js";
+export { fileNameFor } from "./core/files.js";
+export { courseState, activityDetails } from "./areas/courses/state.js";
+//# sourceMappingURL=internals.js.map

package/dist/internals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internals.js","sourceRoot":"","sources":["../src/internals.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,qGAAqG;AACrG,+FAA+F;AAC/F,OAAO,EAAE,WAAW,EAAE,cAAc,EAAmB,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAqB,MAAM,mBAAmB,CAAC;AACzL,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClI,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAqB,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,eAAe,EAA0C,MAAM,0BAA0B,CAAC"}

package/dist/moodle/activities.d.ts

@@ -0,0 +1,94 @@
+import type { BrowserContext, Page } from "playwright-core";
+import { type FieldValue } from "./forms.js";
+import { type CourseSection } from "./structure.js";
+/** "stealth": hidden from the course page but available by link, where the site allows it. */
+export declare const ACTIVITY_VISIBILITIES: readonly ["shown", "hidden", "stealth"];
+export type ActivityVisibility = (typeof ACTIVITY_VISIBILITIES)[number];
+/** The common inputs of an activity's form; anything else goes in `settings` by its form field name. */
+export interface ActivityFields {
+    name?: string;
+    /** The description (HTML), shown on the activity's page. */
+    description?: string;
+    /** A page's content, or a label's text (HTML). */
+    content?: string;
+    /** A URL resource's target. */
+    url?: string;
+    visibility?: ActivityVisibility;
+    settings?: Record<string, FieldValue>;
+}
+/** What a change did, its new id when it created something, and the course afterwards. */
+export interface CourseChange {
+    changed: string;
+    activityId?: number;
+    newId?: number;
+    url?: string;
+    sections: CourseSection[];
+}
+/**
+ * Creates an activity or resource of any type at the end of a section, through Moodle's own form,
+ * hidden from students unless `visibility` says otherwise. `files` are local paths uploaded to a file
+ * resource or folder.
+ */
+export declare function createActivity(context: BrowserContext, siteUrl: string, input: ActivityFields & {
+    courseId: number;
+    sectionId: number;
+    type: string;
+    files?: string[];
+}): Promise<CourseChange>;
+/** Changes an existing activity through its form: only what's given changes; files stay as they are. */
+export declare function updateActivity(context: BrowserContext, siteUrl: string, cmid: number, input: ActivityFields): Promise<CourseChange>;
+/** Renames, shows or hides, or moves an activity (to a section's end, or before another one). */
+export declare function editActivity(context: BrowserContext, siteUrl: string, courseId: number, cmid: number, { name, visibility, sectionId, beforeActivityId }: {
+    name?: string;
+    visibility?: ActivityVisibility;
+    sectionId?: number;
+    beforeActivityId?: number;
+}): Promise<CourseChange>;
+export declare function duplicateActivity(context: BrowserContext, siteUrl: string, courseId: number, cmid: number): Promise<CourseChange>;
+export declare function deleteActivity(context: BrowserContext, siteUrl: string, courseId: number, cmid: number): Promise<CourseChange>;
+/** Adds a section after another one (at the end without it), named when a name is given. */
+export declare function addSection(context: BrowserContext, siteUrl: string, courseId: number, { name, afterSectionId }?: {
+    name?: string;
+    afterSectionId?: number;
+}): Promise<CourseChange>;
+/** Renames, shows or hides, or moves a section after another one. */
+export declare function editSection(context: BrowserContext, siteUrl: string, courseId: number, sectionId: number, { name, visible, afterSectionId }: {
+    name?: string;
+    visible?: boolean;
+    afterSectionId?: number;
+}): Promise<CourseChange>;
+/** Deletes a section and every activity in it, with their participants' data. */
+export declare function deleteSection(context: BrowserContext, siteUrl: string, courseId: number, sectionId: number): Promise<CourseChange>;
+/** One field of a Moodle form, as it is now: its name (what `settings` takes), label, value and options. */
+export interface FormField {
+    name: string;
+    type: "text" | "textarea" | "select" | "checkbox" | "radio" | "number" | "date" | "other";
+    label?: string;
+    /** Text, the selected option (several for a multiple select), the checked radio's value. */
+    value?: string | string[];
+    checked?: boolean;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    /** Disabled until another field enables it; Moodle doesn't save it as it is. */
+    disabled?: boolean;
+}
+/** The fields of a Moodle form in `page`, internal ones (sesskey, ids, buttons) left out, editors' HTML included. */
+export declare function readFormFields(page: Page): Promise<FormField[]>;
+/** Nobody can see that activity's settings: not an activity, or not the person's to edit. */
+export declare class ActivitySettingsError extends Error {
+    name: string;
+}
+/**
+ * An activity's settings as its form holds them, without submitting it: its module, name and
+ * description, and every field by the name `updateActivity` takes in `settings`. Teachers only.
+ */
+export declare function activitySettings(context: BrowserContext, siteUrl: string, cmid: number): Promise<{
+    id: number;
+    module: string;
+    courseId: number;
+    name: string;
+    description: string;
+    fields: FormField[];
+}>;

package/dist/moodle/activities.js

@@ -0,0 +1,240 @@
+import { courseState } from "./course.js";
+import { editCourse, renameActivity, renameSection } from "./editor.js";
+import { checkLocalFiles } from "./files.js";
+import { formValue, openForm, setFields, submitForm, uploadToDraft } from "./forms.js";
+import { inPage } from "./inPage.js";
+import { moodleErrorMessage, openSitePage } from "./session.js";
+import { structureOf } from "./structure.js";
+/** "stealth": hidden from the course page but available by link, where the site allows it. */
+export const ACTIVITY_VISIBILITIES = ["shown", "hidden", "stealth"];
+const FORM_VISIBILITY = { shown: 1, hidden: 0, stealth: -1 };
+const VISIBILITY_ACTIONS = { shown: "cm_show", hidden: "cm_hide", stealth: "cm_stealth" };
+/** The form values the common inputs stand for, given the activity's type. */
+function fieldsFor(type, input) {
+    const values = {};
+    if (input.name !== undefined)
+        values.name = input.name;
+    if (input.description !== undefined)
+        values["introeditor[text]"] = input.description;
+    if (input.content !== undefined) {
+        // A label's text is its description field; a page has its own content editor.
+        if (type === "label")
+            values["introeditor[text]"] = input.content;
+        else if (type === "page")
+            values["page[text]"] = input.content;
+        else
+            throw new Error(`content is for pages and labels; for a ${type}, use description or settings.`);
+    }
+    if (input.url !== undefined)
+        values.externalurl = input.url;
+    if (input.visibility !== undefined)
+        values.visible = FORM_VISIBILITY[input.visibility];
+    return { ...values, ...input.settings };
+}
+async function afterChange(context, siteUrl, courseId, changed, extra = {}) {
+    return { changed, ...extra, sections: structureOf(await courseState(context, siteUrl, courseId)) };
+}
+/**
+ * Creates an activity or resource of any type at the end of a section, through Moodle's own form,
+ * hidden from students unless `visibility` says otherwise. `files` are local paths uploaded to a file
+ * resource or folder.
+ */
+export async function createActivity(context, siteUrl, input) {
+    if (input.files)
+        await checkLocalFiles(input.files);
+    const before = await courseState(context, siteUrl, input.courseId);
+    const target = before.section.find((s) => Number(s.id) === input.sectionId);
+    if (!target)
+        throw new Error(`Course ${input.courseId} has no section ${input.sectionId}. Take its id from the course structure.`);
+    const page = await openForm(context, siteUrl, `course/modedit.php?add=${input.type}&course=${input.courseId}&section=${target.number}&return=0`);
+    try {
+        if (input.files && input.files.length > 0) {
+            const draft = await formValue(page, "files");
+            if (!draft)
+                throw new Error(`A ${input.type} takes no files in its form.`);
+            await uploadToDraft(page, draft, input.files);
+        }
+        // Hidden unless asked: a teacher publishes after checking.
+        await setFields(page, fieldsFor(input.type, { ...input, visibility: input.visibility ?? "hidden" }));
+        await submitForm(page, "submitbutton2");
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+    const after = await courseState(context, siteUrl, input.courseId);
+    const created = after.cm.find((cm) => !before.cm.some((old) => old.id === cm.id));
+    return {
+        changed: created ? `Created ${input.type} ${created.id} "${created.name}" in section ${target.number}.` : `The form was saved, but no new activity appears in course ${input.courseId}.`,
+        activityId: created ? Number(created.id) : undefined,
+        url: created?.url,
+        sections: structureOf(after),
+    };
+}
+/** Changes an existing activity through its form: only what's given changes; files stay as they are. */
+export async function updateActivity(context, siteUrl, cmid, input) {
+    const page = await openForm(context, siteUrl, `course/modedit.php?update=${cmid}&return=0`);
+    let courseId;
+    try {
+        courseId = Number(await formValue(page, "course"));
+        const type = (await formValue(page, "modulename")) ?? "";
+        await setFields(page, fieldsFor(type, input));
+        await submitForm(page, "submitbutton2");
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+    const after = await courseState(context, siteUrl, courseId);
+    const cm = after.cm.find((c) => Number(c.id) === cmid);
+    return { changed: `Updated activity ${cmid}${cm ? ` "${cm.name}"` : ""}.`, activityId: cmid, url: cm?.url, sections: structureOf(after) };
+}
+/** Renames, shows or hides, or moves an activity (to a section's end, or before another one). */
+export async function editActivity(context, siteUrl, courseId, cmid, { name, visibility, sectionId, beforeActivityId }) {
+    const done = [];
+    if (name !== undefined) {
+        await renameActivity(context, siteUrl, cmid, name);
+        done.push(`renamed to "${name}"`);
+    }
+    if (visibility !== undefined) {
+        await editCourse(context, siteUrl, courseId, VISIBILITY_ACTIONS[visibility], [cmid]);
+        done.push(`made ${visibility}`);
+    }
+    if (sectionId !== undefined || beforeActivityId !== undefined) {
+        await editCourse(context, siteUrl, courseId, "cm_move", [cmid], { sectionId, activityId: beforeActivityId });
+        done.push(beforeActivityId !== undefined ? `moved before activity ${beforeActivityId}` : `moved to the end of section ${sectionId}`);
+    }
+    return afterChange(context, siteUrl, courseId, done.length > 0 ? `Activity ${cmid} ${done.join(", ")}.` : "Nothing to change.");
+}
+export async function duplicateActivity(context, siteUrl, courseId, cmid) {
+    const before = new Set((await courseState(context, siteUrl, courseId)).cm.map((cm) => cm.id));
+    await editCourse(context, siteUrl, courseId, "cm_duplicate", [cmid]);
+    const copy = (await courseState(context, siteUrl, courseId)).cm.find((cm) => !before.has(cm.id));
+    return afterChange(context, siteUrl, courseId, `Activity ${cmid} duplicated${copy ? ` as ${copy.id}` : ""}.`, { newId: copy ? Number(copy.id) : undefined });
+}
+export async function deleteActivity(context, siteUrl, courseId, cmid) {
+    await editCourse(context, siteUrl, courseId, "cm_delete", [cmid]);
+    return afterChange(context, siteUrl, courseId, `Activity ${cmid} deleted.`);
+}
+/** Adds a section after another one (at the end without it), named when a name is given. */
+export async function addSection(context, siteUrl, courseId, { name, afterSectionId } = {}) {
+    const before = new Set((await courseState(context, siteUrl, courseId)).section.map((s) => s.id));
+    await editCourse(context, siteUrl, courseId, "section_add", [], { sectionId: afterSectionId });
+    const added = (await courseState(context, siteUrl, courseId)).section.find((s) => !before.has(s.id));
+    if (added && name !== undefined)
+        await renameSection(context, siteUrl, courseId, Number(added.id), name);
+    return afterChange(context, siteUrl, courseId, `Section ${added?.id ?? "?"} added${name !== undefined ? ` as "${name}"` : ""}.`, { newId: added ? Number(added.id) : undefined });
+}
+/** Renames, shows or hides, or moves a section after another one. */
+export async function editSection(context, siteUrl, courseId, sectionId, { name, visible, afterSectionId }) {
+    const done = [];
+    if (name !== undefined) {
+        await renameSection(context, siteUrl, courseId, sectionId, name);
+        done.push(`renamed to "${name}"`);
+    }
+    if (visible !== undefined) {
+        await editCourse(context, siteUrl, courseId, visible ? "section_show" : "section_hide", [sectionId]);
+        done.push(visible ? "shown" : "hidden");
+    }
+    if (afterSectionId !== undefined) {
+        await editCourse(context, siteUrl, courseId, "section_move_after", [sectionId], { sectionId: afterSectionId });
+        done.push(`moved after section ${afterSectionId}`);
+    }
+    return afterChange(context, siteUrl, courseId, done.length > 0 ? `Section ${sectionId} ${done.join(", ")}.` : "Nothing to change.");
+}
+/** Deletes a section and every activity in it, with their participants' data. */
+export async function deleteSection(context, siteUrl, courseId, sectionId) {
+    await editCourse(context, siteUrl, courseId, "section_delete", [sectionId]);
+    return afterChange(context, siteUrl, courseId, `Section ${sectionId} deleted, with its activities.`);
+}
+/** The fields of a Moodle form in `page`, internal ones (sesskey, ids, buttons) left out, editors' HTML included. */
+export function readFormFields(page) {
+    return inPage(page, () => {
+        const doc = globalThis.document;
+        const clean = (s) => (s ?? "").replace(/\s+/g, " ").trim();
+        // A field's label: its own <label for>, or its row's (a date selector's parts, a radio group).
+        const labelOf = (field) => {
+            const own = field.id ? doc.querySelector(`label[for="${field.id}"]`) : null;
+            const row = field.closest(".fitem")?.querySelector(".col-form-label label, .col-form-label p, legend");
+            return clean(own?.textContent) || clean(row?.textContent) || undefined;
+        };
+        const fields = [];
+        const internal = /^(sesskey|_qf__|mform_isexpanded_|mform_showmore_|course$|coursemodule$|section$|module$|modulename$|instance$|add$|update$|return$|sr$|beforemod$)/;
+        for (const field of Array.from(doc.querySelectorAll("form.mform [name]"))) {
+            const name = field.name;
+            if (!name || internal.test(name) || ["hidden", "submit", "button", "fieldset"].includes(field.type) || field.tagName === "FIELDSET")
+                continue;
+            if (field.type === "radio") {
+                let group = fields.find((f) => f.name === name);
+                if (!group) {
+                    group = { name, type: "radio", label: clean(field.closest(".fitem")?.querySelector(".col-form-label, legend")?.textContent) || undefined, options: [] };
+                    fields.push(group);
+                }
+                group.options.push({ value: field.value, label: clean((doc.querySelector(`label[for="${field.id}"]`) ?? field.closest("label"))?.textContent) || field.value });
+                if (field.checked)
+                    group.value = field.value;
+            }
+            else if (field.type === "checkbox") {
+                fields.push({ name, type: "checkbox", label: labelOf(field), value: field.value, checked: field.checked });
+            }
+            else if (field.tagName === "SELECT") {
+                const options = Array.from(field.options);
+                const selected = options.filter((o) => o.selected).map((o) => o.value);
+                // A date selector's parts (duedate[day]…) are numbers, named by their row ("Due date (day)").
+                const part = /\[(day|month|year|hour|minute)\]$/.exec(name)?.[1];
+                if (part) {
+                    // The group's label is id_<group>_label (id_duedate_label for duedate[day]).
+                    const row = clean(doc.querySelector(`#id_${name.slice(0, name.indexOf("["))}_label`)?.textContent);
+                    fields.push({ name, type: "date", label: row ? `${row} (${part})` : part, value: selected[0] });
+                }
+                else {
+                    fields.push({ name, type: "select", label: labelOf(field), value: field.multiple ? selected : selected[0], options: options.map((o) => ({ value: o.value, label: clean(o.text) })) });
+                }
+            }
+            else {
+                const type = field.tagName === "TEXTAREA" ? "textarea" : field.type === "number" ? "number" : field.type === "text" || field.type === "url" || field.type === "email" ? "text" : "other";
+                fields.push({ name, type, label: labelOf(field), value: field.value });
+            }
+        }
+        // Moodle disables fields until another enables them (a date until its "enable", a maximum grade until rescaling is chosen).
+        for (const f of fields) {
+            const elements = Array.from(doc.querySelectorAll(`form.mform [name="${f.name}"]`)).filter((e) => e.type !== "hidden");
+            if (elements.length > 0 && elements.every((e) => e.disabled))
+                f.disabled = true;
+            // No label, no key: plain data for the program.
+            for (const key of Object.keys(f))
+                if (f[key] === undefined)
+                    delete f[key];
+        }
+        return fields;
+    }, null);
+}
+/** Nobody can see that activity's settings: not an activity, or not the person's to edit. */
+export class ActivitySettingsError extends Error {
+    name = "ActivitySettingsError";
+}
+/**
+ * An activity's settings as its form holds them, without submitting it: its module, name and
+ * description, and every field by the name `updateActivity` takes in `settings`. Teachers only.
+ */
+export async function activitySettings(context, siteUrl, cmid) {
+    const page = await openSitePage(context, siteUrl, `course/modedit.php?update=${cmid}&return=0`);
+    try {
+        if ((await page.locator("form.mform").count()) === 0) {
+            throw new ActivitySettingsError(`You can't see activity ${cmid}'s settings: ${(await moodleErrorMessage(page)) ?? "it doesn't exist, or you can't edit it"}`);
+        }
+        await page.waitForLoadState("load");
+        const fields = await readFormFields(page);
+        const value = (name) => fields.find((f) => f.name === name)?.value;
+        return {
+            id: cmid,
+            module: (await formValue(page, "modulename")) ?? "",
+            courseId: Number(await formValue(page, "course")),
+            name: value("name") ?? "",
+            description: value("introeditor[text]") ?? "",
+            fields,
+        };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=activities.js.map

package/dist/moodle/activities.js.map

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

package/dist/moodle/ajax.d.ts

@@ -0,0 +1,22 @@
+import type { BrowserContext } from "playwright-core";
+/** A Moodle AJAX service answered with an exception. */
+export declare class MoodleServiceError extends Error {
+    readonly methodname: string;
+    readonly errorcode: string;
+    name: string;
+    constructor(methodname: string, errorcode: string, message: string);
+}
+/** The response of `lib/ajax/service.php` for one request: `data`, or throws. */
+export declare function parseServiceResponse<T>(methodname: string, status: number, body: string): T;
+/**
+ * Calls one of Moodle's AJAX services as the logged-in person (ADR-004). Throws `NotLoggedInError`
+ * when there's no session, `MoodleServiceError` when the service fails.
+ */
+export declare function callService<T>(context: BrowserContext, siteUrl: string, methodname: string, args: Record<string, unknown>): Promise<T>;
+/** What `M.cfg` says about the logged-in person on the kept service tab. */
+export interface PageConfig {
+    userId: number;
+    language: string;
+    timeZone: string;
+}
+export declare function readPageConfig(context: BrowserContext, siteUrl: string): Promise<PageConfig>;

package/dist/moodle/ajax.js

@@ -0,0 +1,91 @@
+import { NotLoggedInError, openSitePage } from "./session.js";
+/** A Moodle AJAX service answered with an exception. */
+export class MoodleServiceError extends Error {
+    methodname;
+    errorcode;
+    name = "MoodleServiceError";
+    constructor(methodname, errorcode, message) {
+        super(`Moodle's ${methodname} failed (${errorcode}): ${message}`);
+        this.methodname = methodname;
+        this.errorcode = errorcode;
+    }
+}
+// What service.php answers when the session is gone or the tab's sesskey is from an older one.
+const SESSION_ERRORS = new Set(["servicerequireslogin", "invalidsesskey"]);
+// A light page that needs a session: the tab only lends its cookies and `M.cfg.sesskey`.
+const SERVICE_PAGE = "user/preferences.php";
+/** The tab kept open per context for service calls (ADR-004), and the site it belongs to. */
+const servicePages = new WeakMap();
+/** The response of `lib/ajax/service.php` for one request: `data`, or throws. */
+export function parseServiceResponse(methodname, status, body) {
+    let responses;
+    try {
+        responses = JSON.parse(body);
+    }
+    catch {
+        throw new MoodleServiceError(methodname, `http${status}`, "the answer isn't JSON");
+    }
+    const response = (Array.isArray(responses) ? responses[0] : responses);
+    if (!response)
+        throw new MoodleServiceError(methodname, `http${status}`, "empty answer");
+    if (response.error === false)
+        return response.data;
+    // A failure before any function runs (bad sesskey) comes as a bare exception object.
+    const exception = response.exception ?? response;
+    throw new MoodleServiceError(methodname, exception.errorcode ?? "unknown", exception.message ?? "no message");
+}
+async function postFromPage(page, methodname, args) {
+    return page.evaluate(async ({ methodname, args }) => {
+        // Runs in the page, with its cookies and Moodle's globals.
+        const g = globalThis;
+        const url = `${g.M.cfg.wwwroot}/lib/ajax/service.php?sesskey=${encodeURIComponent(g.M.cfg.sesskey)}&info=${encodeURIComponent(methodname)}`;
+        const response = await g.fetch(url, {
+            method: "POST",
+            credentials: "same-origin",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify([{ index: 0, methodname, args }]),
+        });
+        return { status: response.status, body: await response.text() };
+    }, { methodname, args });
+}
+async function servicePage(context, siteUrl, fresh) {
+    const current = servicePages.get(context);
+    // The program may have changed the site since the tab was opened.
+    if (current && !current.page.isClosed() && current.siteUrl === siteUrl && !fresh)
+        return current.page;
+    await current?.page.close().catch(() => undefined);
+    // The kept tab isn't a page a function works on: nothing to follow when it's replaced.
+    const page = await openSitePage(context, siteUrl, SERVICE_PAGE, { follow: false });
+    servicePages.set(context, { page, siteUrl });
+    return page;
+}
+/**
+ * Calls one of Moodle's AJAX services as the logged-in person (ADR-004). Throws `NotLoggedInError`
+ * when there's no session, `MoodleServiceError` when the service fails.
+ */
+export async function callService(context, siteUrl, methodname, args) {
+    for (const fresh of [false, true]) {
+        const page = await servicePage(context, siteUrl, fresh);
+        const { status, body } = await postFromPage(page, methodname, args);
+        try {
+            return parseServiceResponse(methodname, status, body);
+        }
+        catch (error) {
+            const sessionError = error instanceof MoodleServiceError && SESSION_ERRORS.has(error.errorcode);
+            if (!sessionError)
+                throw error;
+            // The kept tab's session may be stale (a new login, an expiry): a new tab tells which.
+            if (fresh)
+                throw new NotLoggedInError();
+        }
+    }
+    throw new NotLoggedInError(); // Unreachable: the fresh attempt returns or throws.
+}
+export async function readPageConfig(context, siteUrl) {
+    const page = await servicePage(context, siteUrl, false);
+    return page.evaluate(() => {
+        const cfg = globalThis.M.cfg;
+        return { userId: cfg.userId, language: cfg.language, timeZone: cfg.usertimezone };
+    });
+}
+//# sourceMappingURL=ajax.js.map

package/dist/moodle/ajax.js.map

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

package/dist/moodle/assign.d.ts

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