@falkenslab/moodle-driver 0.4.1 → 0.5.0

package/dist/areas/workshops/workshops.d.ts

@@ -0,0 +1,133 @@
+import type { BrowserContext, Page } from "playwright-core";
+import { MoodleError } from "../../core/errors.js";
+import { type FieldValue } from "../../core/forms.js";
+/** The activity isn't a workshop the person can view, or Moodle refused what was asked of it. */
+export declare class WorkshopError extends MoodleError {
+    name: string;
+    constructor(message: string);
+}
+/** A workshop's phases, in their order. */
+export type WorkshopPhase = "setup" | "submission" | "assessment" | "evaluation" | "closed";
+/** The phase names, in their order. */
+export declare const WORKSHOP_PHASES: WorkshopPhase[];
+/** A submission in the workshop's report. */
+export interface WorkshopSubmission {
+    id: number;
+    title: string;
+    authorId: number;
+    author: string;
+    /** The grade for the submission Moodle calculated from its assessments (out of the workshop's grade), once it has. */
+    grade?: number;
+    /** The teacher's override of it, when there is one. */
+    gradeOverride?: number;
+}
+/** An assessment of a submission, by its reviewer. */
+export interface WorkshopAssessment {
+    id: number;
+    submissionId?: number;
+    /** The submission's author (the reviewee). */
+    authorId?: number;
+    author?: string;
+    /** Left out when the person can't see reviewers' names. */
+    reviewerId?: number;
+    reviewer?: string;
+    /** The grade it gives the submission (out of the workshop's grade); left out until it's assessed. */
+    grade?: number;
+    /** The grade for the assessment itself, once the evaluation phase calculated it, and the teacher's override of it. */
+    gradingGrade?: number;
+    gradingGradeOverride?: number;
+    /** Its weight in the submission's grade. */
+    weight: number;
+}
+/** A workshop's phase and, for those who can see them, its submissions and their assessments (`workshopInfo`). */
+export interface WorkshopInfo {
+    activityId: number;
+    phase: WorkshopPhase;
+    /** From the workshop's report, which Moodle shows those who can see every submission (from the submission phase on); empty otherwise. */
+    submissions: WorkshopSubmission[];
+    assessments: WorkshopAssessment[];
+}
+/** One participant's rows of the report, as read in the page. */
+interface ReportRow {
+    userId: number;
+    name: string;
+    submission?: {
+        id: number;
+        title: string;
+    };
+    grade?: string;
+    gradeOverride?: string;
+    received: ReportAssessment[];
+    given: ReportAssessment[];
+}
+interface ReportAssessment {
+    id: number;
+    grade: string;
+    gradingGrade: string;
+    gradingGradeOverride?: string;
+    weight?: string;
+    /** The other person: the reviewer of a received one, the author of a given one. */
+    userId?: number;
+    name?: string;
+}
+/** The report's rows (a participant's cells span several rows, one per assessment) and the last page number of its paging bar. */
+export declare function readReport(page: Page): Promise<{
+    rows: ReportRow[];
+    lastPage: number;
+}>;
+/** The report's rows as submissions and assessments: an assessment appears as received by its author and given by its reviewer, and is merged by id. */
+export declare function reportInfo(rows: ReportRow[]): Pick<WorkshopInfo, "submissions" | "assessments">;
+/**
+ * A workshop's phase, and its report as the workshop's page shows it to a teacher: every submission
+ * (its author, title, and grade once calculated) and every assessment (reviewer, the submission's
+ * author, the grade it gives, its weight, the grade for assessing once calculated), all of its pages.
+ * The report is Moodle's own: it shows from the submission phase on to those who can see every
+ * submission, in the course's current group; for anyone else the lists are empty. Grades are out of
+ * the workshop's grade for submission, as Moodle shows them. Throws `WorkshopError` for an activity
+ * that isn't a workshop the person can view.
+ */
+export declare function workshopInfo(context: BrowserContext, siteUrl: string, activityId: number): Promise<WorkshopInfo>;
+/**
+ * Switches a workshop to a phase, as its page's phase links do, confirming Moodle's question (any
+ * phase, forwards or back; Moodle allocates nothing and calculates no grades on its own when it
+ * switches). Returns a sentence of what changed and the phase afterwards. Throws `WorkshopError` when
+ * the person can't switch the workshop's phases (Moodle's `mod/workshop:switchphase`, a teacher's) or
+ * the id isn't a workshop's.
+ */
+export declare function setWorkshopPhase(context: BrowserContext, siteUrl: string, activityId: number, phase: WorkshopPhase): Promise<{
+    changed: string;
+    phase: WorkshopPhase;
+}>;
+/** What to say about one criterion of the assessment form, in the form's order. */
+export interface WorkshopCriterion {
+    /**
+     * Accumulative grading: the points (the menu's number) or a scale item's name. Number of errors:
+     * `1` when the assertion holds, `-1` when it doesn't, or the word the teacher gave either. Rubric:
+     * the level, by its position (`1` for the first) or its definition. Comments: none.
+     */
+    grade?: number | string;
+    /** The comment on the criterion (accumulative, comments and number of errors). */
+    comment?: string;
+}
+/**
+ * Assesses a submission as the person, through the workshop's assessment form (its grading
+ * strategy's: accumulative, comments, number of errors or rubric), as "Assess" on the submission's
+ * page and the form do: a teacher who hasn't assessed it yet gets an assessment of their own, and one
+ * already made is changed. `criteria` go in the form's order; `feedback` is the overall feedback for
+ * the author (HTML), where the workshop has it on; `fields` sets any other field of the form by name
+ * (`weight`…). Returns a sentence of what changed, the assessment's id, and the grade it gives the
+ * submission out of the workshop's grade. Throws `WorkshopError` outside the assessment phase, when a
+ * criterion's grade isn't one it takes, or when the workshop has no overall feedback; `FormError` when
+ * Moodle refuses the form (a criterion left without a grade).
+ */
+export declare function assessWorkshopSubmission(context: BrowserContext, siteUrl: string, activityId: number, submissionId: number, { criteria, feedback, fields }: {
+    criteria?: WorkshopCriterion[];
+    feedback?: string;
+    fields?: Record<string, FieldValue>;
+}): Promise<{
+    changed: string;
+    assessmentId: number;
+    grade?: number;
+    maxGrade?: number;
+}>;
+export {};

package/dist/areas/workshops/workshops.js

@@ -0,0 +1,335 @@
+import { inPage } from "../../core/inPage.js";
+import { moodleErrorMessage, openSitePage, readSessionFacts } from "../../core/session.js";
+import { MoodleError } from "../../core/errors.js";
+import { setFields, submitForm } from "../../core/forms.js";
+/** The activity isn't a workshop the person can view, or Moodle refused what was asked of it. */
+export class WorkshopError extends MoodleError {
+    name = "WorkshopError";
+    constructor(message) {
+        super(message, "workshop");
+    }
+}
+/** Moodle's codes for the phases (workshop::PHASE_*). */
+const PHASE_CODES = { setup: 10, submission: 20, assessment: 30, evaluation: 40, closed: 50 };
+/** The phase names, in their order. */
+export const WORKSHOP_PHASES = Object.keys(PHASE_CODES);
+/** The user plan's current phase, `undefined` when the page has none. */
+async function currentPhase(page) {
+    const code = await page.evaluate(() => {
+        const dt = globalThis.document.querySelector("dl.phase dt.active");
+        return /\bphase(\d+)\b/.exec(dt?.className ?? "")?.[1];
+    });
+    return WORKSHOP_PHASES.find((phase) => String(PHASE_CODES[phase]) === code);
+}
+async function openWorkshop(context, siteUrl, activityId, pageNumber = 0) {
+    const page = await openSitePage(context, siteUrl, `mod/workshop/view.php?id=${activityId}${pageNumber > 0 ? `&page=${pageNumber}` : ""}`);
+    if ((await page.locator("body#page-mod-workshop-view").count()) === 0) {
+        await page.close().catch(() => undefined);
+        throw new WorkshopError(`Activity ${activityId} isn't a workshop you can view. Take the id of a workshop (module "workshop") from the course structure.`);
+    }
+    return page;
+}
+/** The report's rows (a participant's cells span several rows, one per assessment) and the last page number of its paging bar. */
+export function readReport(page) {
+    return inPage(page, () => {
+        const doc = globalThis.document;
+        const text = (el) => (el?.textContent ?? "").replace(/\s+/g, " ").trim();
+        const param = (href, name) => {
+            const match = new RegExp(`[?&]${name}=(\\d+)`).exec(href ?? "");
+            return match ? Number(match[1]) : undefined;
+        };
+        const assessment = (cell) => {
+            const link = cell.querySelector('a.grade[href*="assessment.php"]');
+            const id = param(link?.getAttribute("href"), "asid");
+            if (!link || id === undefined)
+                return undefined;
+            const gradingGrade = link.querySelector(".gradinggrade");
+            const over = gradingGrade?.querySelector("ins");
+            const user = cell.querySelector(".user");
+            return {
+                id,
+                grade: text(link.querySelector(".grade") ?? link),
+                gradingGrade: text(gradingGrade?.querySelector("del") ?? gradingGrade).replace(/^\(|\)$/g, ""),
+                ...(over ? { gradingGradeOverride: text(over) } : {}),
+                ...(link.querySelector(".weight") ? { weight: text(link.querySelector(".weight")) } : {}),
+                ...(user ? { userId: param(user.querySelector('a[href*="/user/view.php"]')?.getAttribute("href"), "id"), name: text(user.querySelector(".fullname")) } : {}),
+            };
+        };
+        const rows = [];
+        for (const tr of Array.from(doc.querySelectorAll("table.grading-report tbody tr"))) {
+            const participant = tr.querySelector("td.participant");
+            if (participant) {
+                const title = tr.querySelector("td.submission a.title");
+                const total = tr.querySelector("td.submissiongrade");
+                const over = total?.querySelector("ins");
+                rows.push({
+                    userId: param(participant.querySelector('a[href*="/user/view.php"]')?.getAttribute("href"), "id") ?? 0,
+                    name: text(participant.querySelector(":scope > span")),
+                    ...(title ? { submission: { id: param(title.getAttribute("href"), "id") ?? 0, title: text(title) } } : {}),
+                    ...(total ? { grade: text(total.querySelector("del") ?? total) } : {}),
+                    ...(over ? { gradeOverride: text(over) } : {}),
+                    received: [],
+                    given: [],
+                });
+            }
+            const row = rows[rows.length - 1];
+            if (!row)
+                continue;
+            const received = tr.querySelector("td.receivedgrade");
+            const given = tr.querySelector("td.givengrade");
+            const r = received ? assessment(received) : undefined;
+            const g = given ? assessment(given) : undefined;
+            if (r)
+                row.received.push(r);
+            if (g)
+                row.given.push(g);
+        }
+        const pages = Array.from(doc.querySelectorAll('#region-main .pagination a[href*="page="]')).map((a) => param(a.getAttribute("href"), "page") ?? 0);
+        return { rows, lastPage: Math.max(0, ...pages) };
+    }, undefined);
+}
+/** A grade as the report shows it ("80.00", "80,00" where the site writes a decimal comma); `undefined` for Moodle's "-". */
+function gradeNumber(shown) {
+    const match = /-?\d+(?:[.,]\d+)?/.exec(shown ?? "");
+    return match ? Number(match[0].replace(",", ".")) : undefined;
+}
+/** The report's rows as submissions and assessments: an assessment appears as received by its author and given by its reviewer, and is merged by id. */
+export function reportInfo(rows) {
+    const submissions = [];
+    const assessments = new Map();
+    const submissionOf = new Map(rows.flatMap((row) => (row.submission ? [[row.userId, row.submission.id]] : [])));
+    const merge = (seen, sides) => {
+        const grade = gradeNumber(seen.grade);
+        const gradingGrade = gradeNumber(seen.gradingGrade);
+        const gradingGradeOverride = gradeNumber(seen.gradingGradeOverride);
+        const known = assessments.get(seen.id);
+        assessments.set(seen.id, {
+            id: seen.id,
+            ...known,
+            ...Object.fromEntries(Object.entries(sides).filter(([, value]) => value !== undefined && value !== "")),
+            ...(grade !== undefined ? { grade } : {}),
+            ...(gradingGrade !== undefined ? { gradingGrade } : {}),
+            ...(gradingGradeOverride !== undefined ? { gradingGradeOverride } : {}),
+            weight: gradeNumber(seen.weight) ?? 1,
+        });
+    };
+    for (const row of rows) {
+        if (row.submission) {
+            const grade = gradeNumber(row.grade);
+            const gradeOverride = gradeNumber(row.gradeOverride);
+            submissions.push({
+                id: row.submission.id,
+                title: row.submission.title,
+                authorId: row.userId,
+                author: row.name,
+                ...(grade !== undefined ? { grade } : {}),
+                ...(gradeOverride !== undefined ? { gradeOverride } : {}),
+            });
+        }
+        for (const seen of row.received)
+            merge(seen, { submissionId: row.submission?.id, authorId: row.userId, author: row.name, reviewerId: seen.userId, reviewer: seen.name });
+        for (const seen of row.given)
+            merge(seen, { submissionId: seen.userId !== undefined ? submissionOf.get(seen.userId) : undefined, authorId: seen.userId, author: seen.name, reviewerId: row.userId, reviewer: row.name });
+    }
+    return { submissions, assessments: [...assessments.values()].sort((a, b) => a.id - b.id) };
+}
+/**
+ * A workshop's phase, and its report as the workshop's page shows it to a teacher: every submission
+ * (its author, title, and grade once calculated) and every assessment (reviewer, the submission's
+ * author, the grade it gives, its weight, the grade for assessing once calculated), all of its pages.
+ * The report is Moodle's own: it shows from the submission phase on to those who can see every
+ * submission, in the course's current group; for anyone else the lists are empty. Grades are out of
+ * the workshop's grade for submission, as Moodle shows them. Throws `WorkshopError` for an activity
+ * that isn't a workshop the person can view.
+ */
+export async function workshopInfo(context, siteUrl, activityId) {
+    const rows = [];
+    let phase;
+    let lastPage = 0;
+    for (let pageNumber = 0; pageNumber <= lastPage; pageNumber++) {
+        const page = await openWorkshop(context, siteUrl, activityId, pageNumber);
+        try {
+            phase ??= await currentPhase(page);
+            const report = await readReport(page);
+            rows.push(...report.rows);
+            lastPage = Math.max(lastPage, report.lastPage);
+        }
+        finally {
+            await page.close().catch(() => undefined);
+        }
+    }
+    if (!phase)
+        throw new WorkshopError(`Workshop ${activityId}'s page shows no phase: it isn't what the driver expects of Moodle's workshop page.`);
+    return { activityId, phase, ...reportInfo(rows) };
+}
+/**
+ * Switches a workshop to a phase, as its page's phase links do, confirming Moodle's question (any
+ * phase, forwards or back; Moodle allocates nothing and calculates no grades on its own when it
+ * switches). Returns a sentence of what changed and the phase afterwards. Throws `WorkshopError` when
+ * the person can't switch the workshop's phases (Moodle's `mod/workshop:switchphase`, a teacher's) or
+ * the id isn't a workshop's.
+ */
+export async function setWorkshopPhase(context, siteUrl, activityId, phase) {
+    if (!(phase in PHASE_CODES))
+        throw new MoodleError(`A workshop's phase is one of ${WORKSHOP_PHASES.join(", ")}; not "${phase}".`, "invalid-input");
+    const page = await openSitePage(context, siteUrl, `mod/workshop/switchphase.php?cmid=${activityId}&phase=${PHASE_CODES[phase]}`);
+    try {
+        const refused = await moodleErrorMessage(page);
+        if (refused !== undefined)
+            throw new WorkshopError(`Moodle didn't let you switch workshop ${activityId}'s phase: ${refused}`);
+        const confirm = page.locator('form[action*="/mod/workshop/switchphase.php"]:has(input[name="confirm"]) [type="submit"]');
+        if ((await confirm.count()) === 0)
+            throw new WorkshopError(`Activity ${activityId} isn't a workshop whose phase you can switch: Moodle asked no confirmation.`);
+        await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), confirm.first().click({ noWaitAfter: true })]);
+        const failed = await moodleErrorMessage(page);
+        if (failed !== undefined)
+            throw new WorkshopError(`Moodle didn't switch workshop ${activityId}'s phase: ${failed}`);
+        const now = await currentPhase(page);
+        if (now !== phase)
+            throw new WorkshopError(`Moodle didn't switch workshop ${activityId} to the ${phase} phase${now ? `: it's in the ${now} phase` : ""}.`);
+        return { changed: `Workshop ${activityId} switched to the ${phase} phase.`, phase };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+/** The assessment form's grading strategy and its criteria's grade controls, by index. */
+function readAssessmentForm(page) {
+    return inPage(page, () => {
+        const doc = globalThis.document;
+        const form = doc.querySelector("form.assessmentform");
+        if (!form)
+            return { strategy: "", criteria: [], feedback: false };
+        const clean = (s) => (s ?? "").replace(/\s+/g, " ").trim();
+        const count = form.querySelectorAll('input[name^="dimensionid__idx_"]').length;
+        const criteria = [];
+        for (let i = 0; i < count; i++) {
+            const select = form.querySelector(`select[name="grade__idx_${i}"]`);
+            if (select) {
+                // Without its "Choose..." (-1), which isn't a grade.
+                const options = Array.from(select.querySelectorAll("option")).filter((o) => o.value !== "-1");
+                criteria.push({ name: select.name, rubric: false, options: options.map((o) => ({ value: o.value, text: clean(o.text) })) });
+                continue;
+            }
+            const radios = Array.from(form.querySelectorAll(`input[type="radio"][name="grade__idx_${i}"], input[type="radio"][name="chosenlevelid__idx_${i}"]`));
+            if (radios.length === 0) {
+                criteria.push(undefined);
+                continue;
+            }
+            criteria.push({
+                name: radios[0].name,
+                rubric: radios[0].name.startsWith("chosenlevelid"),
+                options: radios.map((radio) => ({ value: radio.value, text: clean((radio.closest("label") ?? form.querySelector(`label[for="${radio.id}"]`))?.textContent) })),
+            });
+        }
+        return { strategy: form.querySelector('input[name="strategy"]')?.value ?? "", criteria, feedback: form.querySelector('[name="feedbackauthor_editor[text]"]') !== null };
+    }, undefined);
+}
+/** The form values for the criteria given; refuses a grade the criterion doesn't take. */
+function criteriaValues(submissionId, strategy, controls, criteria) {
+    if (criteria.length > controls.length)
+        throw new WorkshopError(`The workshop's assessment form has ${controls.length} criteria; ${criteria.length} were given.`);
+    const values = {};
+    criteria.forEach((criterion, i) => {
+        if (criterion.grade !== undefined) {
+            const control = controls[i];
+            if (!control)
+                throw new WorkshopError(`Criterion ${i + 1} of the assessment form (${strategy}) takes no grade, only a comment.`);
+            const options = control.options;
+            const wanted = String(criterion.grade);
+            const option = control.rubric
+                ? (typeof criterion.grade === "number" ? options[criterion.grade - 1] : undefined) ?? options.find((o) => o.text === wanted)
+                : options.find((o) => o.value === wanted) ?? options.find((o) => o.text === wanted);
+            if (!option)
+                throw new WorkshopError(`Criterion ${i + 1} of submission ${submissionId}'s assessment takes ${options.map((o, n) => (control.rubric ? `${n + 1} ("${o.text}")` : `"${o.value}"${o.text && o.text !== o.value ? ` ("${o.text}")` : ""}`)).join(", ")}; not "${wanted}".`);
+            values[control.name] = option.value;
+        }
+        if (criterion.comment !== undefined)
+            values[`peercomment__idx_${i}`] = criterion.comment;
+    });
+    return values;
+}
+function formValueIn(page, form, name) {
+    return page.evaluate(({ form, name }) => globalThis.document.querySelector(`${form} [name="${name}"]`)?.value, { form, name });
+}
+/** Where the person's own assessment of a submission is: its id, from the submission page (adding it, as "Assess" does, when there's none). */
+async function ownAssessment(page, activityId, submissionId) {
+    const me = (await readSessionFacts(page)).userId;
+    const existing = await page.evaluate((me) => {
+        const doc = globalThis.document;
+        for (const box of Array.from(doc.querySelectorAll(".assessment-full"))) {
+            const reviewer = box.querySelector('.reviewer .fullname a[href*="/user/view.php"]')?.getAttribute("href") ?? "";
+            if (new RegExp(`[?&]id=${me}(&|$)`).test(reviewer)) {
+                const asid = box.querySelector('.actions form[action*="/mod/workshop/assessment.php"] input[name="asid"]')?.value ?? /[?&]asid=(\d+)/.exec(box.querySelector('.actions form[action*="/mod/workshop/assessment.php"]')?.getAttribute("action") ?? "")?.[1];
+                if (asid)
+                    return Number(asid);
+            }
+        }
+        return undefined;
+    }, me);
+    if (existing !== undefined)
+        return existing;
+    const assess = page.locator('form[action*="/mod/workshop/submission.php"]:has(input[name="assess"]) [type="submit"]');
+    if ((await assess.count()) === 0) {
+        throw new WorkshopError(`Moodle offers you no assessment of submission ${submissionId} in workshop ${activityId}: assessing is only open in the assessment phase, to its reviewers and teachers.`);
+    }
+    await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), assess.first().click({ noWaitAfter: true })]);
+    // Moodle redirects to the new assessment's page, whose form carries its id too.
+    const asid = /[?&]asid=(\d+)/.exec(page.url())?.[1] ?? (await formValueIn(page, "form.assessmentform", "asid"));
+    if (!asid)
+        throw new WorkshopError(`Moodle didn't open an assessment of submission ${submissionId} in workshop ${activityId}.`);
+    return Number(asid);
+}
+/** The person's assessment's grade and maximum, as its page's header shows them ("80.00 of 80.00"). */
+async function assessmentGrade(page) {
+    const shown = await page.evaluate(() => {
+        const box = globalThis.document.querySelector(".assessment-full .header .grade:not(.nograde)");
+        return box?.textContent ?? "";
+    });
+    const [grade, maxGrade] = (shown.match(/\d+(?:[.,]\d+)?/g) ?? []).map((n) => Number(n.replace(",", ".")));
+    return { ...(grade !== undefined ? { grade } : {}), ...(maxGrade !== undefined ? { maxGrade } : {}) };
+}
+/**
+ * Assesses a submission as the person, through the workshop's assessment form (its grading
+ * strategy's: accumulative, comments, number of errors or rubric), as "Assess" on the submission's
+ * page and the form do: a teacher who hasn't assessed it yet gets an assessment of their own, and one
+ * already made is changed. `criteria` go in the form's order; `feedback` is the overall feedback for
+ * the author (HTML), where the workshop has it on; `fields` sets any other field of the form by name
+ * (`weight`…). Returns a sentence of what changed, the assessment's id, and the grade it gives the
+ * submission out of the workshop's grade. Throws `WorkshopError` outside the assessment phase, when a
+ * criterion's grade isn't one it takes, or when the workshop has no overall feedback; `FormError` when
+ * Moodle refuses the form (a criterion left without a grade).
+ */
+export async function assessWorkshopSubmission(context, siteUrl, activityId, submissionId, { criteria = [], feedback, fields = {} }) {
+    const page = await openSitePage(context, siteUrl, `mod/workshop/submission.php?cmid=${activityId}&id=${submissionId}`);
+    try {
+        const refused = await moodleErrorMessage(page);
+        if (refused !== undefined)
+            throw new WorkshopError(`You can't open submission ${submissionId} of workshop ${activityId}: ${refused}`);
+        if ((await page.locator("body#page-mod-workshop-submission").count()) === 0)
+            throw new WorkshopError(`Activity ${activityId} isn't a workshop with submission ${submissionId}.`);
+        const assessmentId = await ownAssessment(page, activityId, submissionId);
+        if (!/\/mod\/workshop\/assessment\.php/.test(page.url()))
+            await page.goto(new URL(`mod/workshop/assessment.php?asid=${assessmentId}`, siteUrl).href, { waitUntil: "domcontentloaded" });
+        await page.waitForLoadState("load");
+        const form = await readAssessmentForm(page);
+        if (!form.strategy)
+            throw new WorkshopError(`Assessment ${assessmentId} has no form you can fill: assessing is only open in the assessment phase.`);
+        if (feedback !== undefined && !form.feedback)
+            throw new WorkshopError(`Workshop ${activityId} has no overall feedback: it's off in its settings.`);
+        const values = { ...criteriaValues(submissionId, form.strategy, form.criteria, criteria), ...(feedback !== undefined ? { "feedbackauthor_editor[text]": feedback } : {}), ...fields };
+        await setFields(page, values, "form.assessmentform");
+        // "Save and continue" comes back to the assessment, whose header then shows the grade.
+        await submitForm(page, "saveandcontinue");
+        const shown = await assessmentGrade(page);
+        return {
+            changed: `Submission ${submissionId} of workshop ${activityId} assessed${shown.grade !== undefined ? `: ${shown.grade}${shown.maxGrade !== undefined ? ` of ${shown.maxGrade}` : ""}` : ""}.`,
+            assessmentId,
+            ...shown,
+        };
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=workshops.js.map

package/dist/areas/workshops/workshops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workshops.js","sourceRoot":"","sources":["../../../src/areas/workshops/workshops.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAmB,MAAM,qBAAqB,CAAC;AAE7E,iGAAiG;AACjG,MAAM,OAAO,aAAc,SAAQ,WAAW;IACnC,IAAI,GAAG,eAAe,CAAC;IAChC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7B,CAAC;CACF;AAKD,yDAAyD;AACzD,MAAM,WAAW,GAAkC,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAE7H,uCAAuC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAoB,CAAC;AA0C3E,yEAAyE;AACzE,KAAK,UAAU,YAAY,CAAC,IAAU;IACpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;QACpC,MAAM,EAAE,GAAI,UAAkG,CAAC,QAAQ,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;QAC5J,OAAO,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IACH,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,OAAuB,EAAE,OAAe,EAAE,UAAkB,EAAE,UAAU,GAAG,CAAC;IACtG,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,4BAA4B,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1I,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,IAAI,aAAa,CAAC,YAAY,UAAU,0GAA0G,CAAC,CAAC;IAC5J,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAwBD,kIAAkI;AAClI,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,OAAO,MAAM,CACX,IAAI,EACJ,GAAG,EAAE;QAQH,MAAM,GAAG,GAAI,UAA0C,CAAC,QAAQ,CAAC;QACjE,MAAM,IAAI,GAAG,CAAC,EAAyB,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAChG,MAAM,KAAK,GAAG,CAAC,IAA+B,EAAE,IAAY,EAAE,EAAE;YAC9D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAChE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9C,CAAC,CAAC;QACF,MAAM,UAAU,GAAG,CAAC,IAAQ,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,iCAAiC,CAAC,CAAC;YACnE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;YACrD,IAAI,CAAC,IAAI,IAAI,EAAE,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;YAChD,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;YACzD,MAAM,IAAI,GAAG,YAAY,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACzC,OAAO;gBACL,EAAE;gBACF,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;gBACjD,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;gBAC9F,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzF,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,2BAA2B,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7J,CAAC;QACJ,CAAC,CAAC;QACF,MAAM,IAAI,GAAgB,EAAE,CAAC;QAC7B,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,+BAA+B,CAAC,CAAC,EAAE,CAAC;YACnF,MAAM,WAAW,GAAG,EAAE,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;YACvD,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAG,EAAE,CAAC,aAAa,CAAC,uBAAuB,CAAC,CAAC;gBACxD,MAAM,KAAK,GAAG,EAAE,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;gBACrD,MAAM,IAAI,GAAG,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;gBACzC,IAAI,CAAC,IAAI,CAAC;oBACR,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,2BAA2B,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC;oBACtG,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;oBACtD,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC1G,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC9C,QAAQ,EAAE,EAAE;oBACZ,KAAK,EAAE,EAAE;iBACV,CAAC,CAAC;YACL,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAClC,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,MAAM,QAAQ,GAAG,EAAE,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;YACtD,MAAM,KAAK,GAAG,EAAE,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;YAChD,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACtD,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAChD,IAAI,CAAC;gBAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC;gBAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,2CAA2C,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACnJ,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;IACnD,CAAC,EACD,SAAS,CACV,CAAC;AACJ,CAAC;AAED,6HAA6H;AAC7H,SAAS,WAAW,CAAC,KAAyB;IAC5C,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChE,CAAC;AAED,wJAAwJ;AACxJ,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,MAAM,WAAW,GAAyB,EAAE,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC1D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,CAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxH,MAAM,KAAK,GAAG,CAAC,IAAsB,EAAE,KAAkC,EAAE,EAAE;QAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpD,MAAM,oBAAoB,GAAG,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;YACvB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,GAAG,KAAK;YACR,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;YACvG,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,oBAAoB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;SACtC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACrD,WAAW,CAAC,IAAI,CAAC;gBACf,EAAE,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;gBACrB,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK;gBAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM;gBACpB,MAAM,EAAE,GAAG,CAAC,IAAI;gBAChB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzC,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1D,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACzK,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3N,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAuB,EAAE,OAAe,EAAE,UAAkB;IAC7F,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,IAAI,KAAgC,CAAC;IACrC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,IAAI,QAAQ,EAAE,UAAU,EAAE,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAC1E,IAAI,CAAC;YACH,KAAK,KAAK,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,aAAa,CAAC,YAAY,UAAU,qFAAqF,CAAC,CAAC;IACjJ,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAuB,EAAE,OAAe,EAAE,UAAkB,EAAE,KAAoB;IACvH,IAAI,CAAC,CAAC,KAAK,IAAI,WAAW,CAAC;QAAE,MAAM,IAAI,WAAW,CAAC,gCAAgC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,eAAe,CAAC,CAAC;IACnJ,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,qCAAqC,UAAU,UAAU,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjI,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,aAAa,CAAC,yCAAyC,UAAU,aAAa,OAAO,EAAE,CAAC,CAAC;QAC9H,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,0FAA0F,CAAC,CAAC;QACzH,IAAI,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,aAAa,CAAC,YAAY,UAAU,6EAA6E,CAAC,CAAC;QAChK,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7H,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,aAAa,CAAC,iCAAiC,UAAU,aAAa,MAAM,EAAE,CAAC,CAAC;QACpH,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,GAAG,KAAK,KAAK;YAAE,MAAM,IAAI,aAAa,CAAC,iCAAiC,UAAU,WAAW,KAAK,SAAS,GAAG,CAAC,CAAC,CAAC,iBAAiB,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC3J,OAAO,EAAE,OAAO,EAAE,YAAY,UAAU,oBAAoB,KAAK,SAAS,EAAE,KAAK,EAAE,CAAC;IACtF,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAqBD,0FAA0F;AAC1F,SAAS,kBAAkB,CAAC,IAAU;IACpC,OAAO,MAAM,CACX,IAAI,EACJ,GAAG,EAAE;QAaH,MAAM,GAAG,GAAI,UAA0C,CAAC,QAAQ,CAAC;QACjE,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAClE,MAAM,KAAK,GAAG,CAAC,CAA4B,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACtF,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,kCAAkC,CAAC,CAAC,MAAM,CAAC;QAC/E,MAAM,QAAQ,GAAiC,EAAE,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC;YACpE,IAAI,MAAM,EAAE,CAAC;gBACX,qDAAqD;gBACrD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;gBAC9F,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC5H,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,wCAAwC,CAAC,oDAAoD,CAAC,IAAI,CAAC,CAAC,CAAC;YACrJ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACzB,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,IAAI;gBACrB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;gBACnD,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,cAAc,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;aAC/J,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,wBAAwB,CAAC,EAAE,KAAK,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,sCAAsC,CAAC,KAAK,IAAI,EAAE,CAAC;IAC1K,CAAC,EACD,SAAS,CACV,CAAC;AACJ,CAAC;AAED,0FAA0F;AAC1F,SAAS,cAAc,CAAC,YAAoB,EAAE,QAAgB,EAAE,QAAsC,EAAE,QAA6B;IACnI,IAAI,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM;QAAE,MAAM,IAAI,aAAa,CAAC,sCAAsC,QAAQ,CAAC,MAAM,cAAc,QAAQ,CAAC,MAAM,cAAc,CAAC,CAAC;IACjK,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE;QAChC,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,aAAa,CAAC,aAAa,CAAC,GAAG,CAAC,4BAA4B,QAAQ,mCAAmC,CAAC,CAAC;YACjI,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAChC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM;gBAC3B,CAAC,CAAC,CAAC,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;gBAC5H,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;YACtF,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,aAAa,CAAC,aAAa,CAAC,GAAG,CAAC,kBAAkB,YAAY,uBAAuB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC,CAAC;YACvR,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QACtC,CAAC;QACD,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;IAC3F,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,IAAU,EAAE,IAAY,EAAE,IAAY;IACzD,OAAO,IAAI,CAAC,QAAQ,CAClB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAE,UAA8F,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,WAAW,IAAI,IAAI,CAAC,EAAE,KAAK,EAC7K,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;AACJ,CAAC;AAED,+IAA+I;AAC/I,KAAK,UAAU,aAAa,CAAC,IAAU,EAAE,UAAkB,EAAE,YAAoB;IAC/E,MAAM,EAAE,GAAG,CAAC,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE;QAO1C,MAAM,GAAG,GAAI,UAA0C,CAAC,QAAQ,CAAC;QACjE,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa,CAAC,+CAA+C,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAChH,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnD,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,0EAA0E,CAAC,EAAE,KAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,uDAAuD,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC1P,IAAI,IAAI;oBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,wFAAwF,CAAC,CAAC;IACtH,IAAI,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,aAAa,CAAC,iDAAiD,YAAY,gBAAgB,UAAU,kFAAkF,CAAC,CAAC;IACrM,CAAC;IACD,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5H,gFAAgF;IAChF,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,IAAI,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC;IAChH,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,aAAa,CAAC,kDAAkD,YAAY,gBAAgB,UAAU,GAAG,CAAC,CAAC;IAChI,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,uGAAuG;AACvG,KAAK,UAAU,eAAe,CAAC,IAAU;IACvC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;QACrC,MAAM,GAAG,GAAI,UAA2G,CAAC,QAAQ,CAAC,aAAa,CAAC,+CAA+C,CAAC,CAAC;QACjM,OAAO,GAAG,EAAE,WAAW,IAAI,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1G,OAAO,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACxG,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAuB,EACvB,OAAe,EACf,UAAkB,EAClB,YAAoB,EACpB,EAAE,QAAQ,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,EAAE,EAA8F;IAEpI,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,oCAAoC,UAAU,OAAO,YAAY,EAAE,CAAC,CAAC;IACvH,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,aAAa,CAAC,6BAA6B,YAAY,gBAAgB,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;QACtI,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,aAAa,CAAC,YAAY,UAAU,qCAAqC,YAAY,GAAG,CAAC,CAAC;QACjL,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QACzE,IAAI,CAAC,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAAE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,oCAAoC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACxL,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,aAAa,CAAC,cAAc,YAAY,4EAA4E,CAAC,CAAC;QACpJ,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,aAAa,CAAC,YAAY,UAAU,qDAAqD,CAAC,CAAC;QACnJ,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,6BAA6B,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;QACtL,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC;QACrD,uFAAuF;QACvF,MAAM,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO;YACL,OAAO,EAAE,cAAc,YAAY,gBAAgB,UAAU,YAAY,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG;YAC7L,YAAY;YACZ,GAAG,KAAK;SACT,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/browser/background.d.ts

@@ -0,0 +1,43 @@
+import type { Channel } from "../options.js";
+import { type BrowserManager } from "./manager.js";
+/** The file a background browser leaves in its profile: where it is and its token, readable only by the person. */
+export declare const BACKGROUND_FILE = ".browser.json";
+/** A browser kept open by another process, as its profile's `.browser.json` says. */
+export interface BackgroundBrowser {
+    /** The WebSocket to connect to, on 127.0.0.1. */
+    endpoint: string;
+    /** Sent as `Authorization: Bearer <token>`: without it the browser refuses the connection. */
+    token: string;
+    /** The process holding the browser. */
+    pid: number;
+    channel: Channel;
+    /** Whether it shows a window. */
+    headed: boolean;
+}
+/** The background browser `connectBrowserManager` connects to (`endpoint` and `token` as `backgroundBrowser` gives them), and how to use it. */
+export interface ConnectOptions {
+    endpoint: string;
+    token: string;
+    /** Whether the browser shows a window: the pages functions open are then followed in it (ADR-007). */
+    headed?: boolean;
+    channel?: Channel;
+    /** The browser's profile, to save the session cookies in when disconnecting (ADR-003). */
+    profileDir?: string;
+}
+/**
+ * The browser another process keeps open on `profileDir` (the `moodle open` command's), or `undefined`
+ * when there's none. A `.browser.json` left by a process that's gone is removed.
+ */
+export declare function backgroundBrowser(profileDir: string): Promise<BackgroundBrowser | undefined>;
+/**
+ * Asks the background browser on `profileDir` to save the session and close, and waits until it has;
+ * `false` when there's none.
+ */
+export declare function closeBackgroundBrowser(profileDir: string, timeoutMs?: number): Promise<boolean>;
+/**
+ * A browser manager on a browser another process keeps open (`backgroundBrowser`), for a program to
+ * share it: it connects on first use, works in the browser's own context, and `close()` only
+ * disconnects, leaving the browser open. With a window, the pages functions open are followed in its
+ * first tab (ADR-007); it can't add or remove a window from a browser it didn't launch.
+ */
+export declare function connectBrowserManager(options: ConnectOptions): BrowserManager;