@falkenslab/moodle-driver 0.0.0-stage → 0.3.1

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

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

package/dist/browser/chromium.d.ts

@@ -0,0 +1,15 @@
+import { type ChildProcess } from "node:child_process";
+export type InstallChromium = () => Promise<void>;
+/**
+ * Starts a process that `killTree` can end with everything it starts: on Linux and macOS as the
+ * leader of its own process group; on Windows `taskkill /T` walks the tree, and no console opens.
+ */
+export declare function spawnTree(command: string, args: string[]): ChildProcess;
+/** Ends a process started by `spawnTree` and its children, at once; nothing if it's gone. */
+export declare function killTree(pid: number): void;
+/**
+ * Downloads the Chromium this `playwright-core` expects with its own CLI (ADR-001), into
+ * `PLAYWRIGHT_BROWSERS_PATH` when set, else the user's `ms-playwright` cache. The CLI is in
+ * `node_modules`, where `playwright-core` is (a peer dependency).
+ */
+export declare const installChromium: InstallChromium;

package/dist/browser/chromium.js

@@ -0,0 +1,53 @@
+import { spawn, spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { MoodleError } from "../core/errors.js";
+/**
+ * Starts a process that `killTree` can end with everything it starts: on Linux and macOS as the
+ * leader of its own process group; on Windows `taskkill /T` walks the tree, and no console opens.
+ */
+export function spawnTree(command, args) {
+    return spawn(command, args, { stdio: ["ignore", "pipe", "pipe"], detached: process.platform !== "win32", windowsHide: true });
+}
+/** Ends a process started by `spawnTree` and its children, at once; nothing if it's gone. */
+export function killTree(pid) {
+    try {
+        if (process.platform === "win32")
+            spawnSync("taskkill", ["/PID", String(pid), "/T", "/F"], { stdio: "ignore", windowsHide: true });
+        else
+            process.kill(-pid, "SIGKILL");
+    }
+    catch {
+        // Already gone.
+    }
+}
+/**
+ * Downloads the Chromium this `playwright-core` expects with its own CLI (ADR-001), into
+ * `PLAYWRIGHT_BROWSERS_PATH` when set, else the user's `ms-playwright` cache. The CLI is in
+ * `node_modules`, where `playwright-core` is (a peer dependency).
+ */
+export const installChromium = () => new Promise((resolve, reject) => {
+    const cli = path.join(path.dirname(createRequire(import.meta.url).resolve("playwright-core/package.json")), "cli.js");
+    // --no-shell: the driver launches full Chromium headless too (channel "chromium").
+    // --no-remove: the cache is shared, and other installations' browsers aren't ours to remove.
+    const child = spawnTree(process.execPath, [cli, "install", "chromium", "--no-shell", "--no-remove", "--no-progress"]);
+    // The CLI downloads from a child of its own: when the program exits, the whole tree goes with it,
+    // instead of downloading on with nobody to use it (a partial download is started over next time).
+    const stop = () => killTree(child.pid);
+    process.on("exit", stop);
+    // A program's stdout may be a protocol (an MCP server's): whatever the installer prints goes to stderr.
+    child.stdout.pipe(process.stderr, { end: false });
+    child.stderr.pipe(process.stderr, { end: false });
+    child.on("error", (error) => {
+        process.off("exit", stop);
+        reject(error);
+    });
+    child.on("exit", (code) => {
+        process.off("exit", stop);
+        if (code === 0)
+            resolve();
+        else
+            reject(new MoodleError(`Chromium's installer exited with code ${code}`, "chromium-install-failed"));
+    });
+});
+//# sourceMappingURL=chromium.js.map

package/dist/browser/chromium.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromium.js","sourceRoot":"","sources":["../../src/browser/chromium.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,IAAc;IACvD,OAAO,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AAChI,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAAE,SAAS,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;;YAC9H,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB,GAAG,EAAE,CACnD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACtH,mFAAmF;IACnF,6FAA6F;IAC7F,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC;IACtH,kGAAkG;IAClG,kGAAkG;IAClG,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAI,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzB,wGAAwG;IACxG,KAAK,CAAC,MAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,MAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACxB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;;YACrB,MAAM,CAAC,IAAI,WAAW,CAAC,yCAAyC,IAAI,EAAE,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAC3G,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/browser/cookies.d.ts

@@ -0,0 +1,11 @@
+import type { BrowserContext } from "playwright-core";
+/**
+ * Chromium drops session cookies (no expiry) when a persistent profile closes, and Moodle's
+ * `MoodleSession` is one (confirmed empirically, Edge and playwright-core 1.64, Moodle 5.2): the
+ * profile alone would forget the login on every restart. They are kept in this file inside the
+ * profile, as sensitive as the profile itself (ADR-003).
+ */
+export declare const SESSION_COOKIES_FILE = "moodle-session.json";
+export declare function saveSessionCookies(context: BrowserContext, profileDir: string): Promise<void>;
+/** Puts back the session cookies saved last time; a missing or unreadable file means none. */
+export declare function restoreSessionCookies(context: BrowserContext, profileDir: string): Promise<void>;

package/dist/browser/cookies.js

@@ -0,0 +1,31 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+/**
+ * Chromium drops session cookies (no expiry) when a persistent profile closes, and Moodle's
+ * `MoodleSession` is one (confirmed empirically, Edge and playwright-core 1.64, Moodle 5.2): the
+ * profile alone would forget the login on every restart. They are kept in this file inside the
+ * profile, as sensitive as the profile itself (ADR-003).
+ */
+export const SESSION_COOKIES_FILE = "moodle-session.json";
+export async function saveSessionCookies(context, profileDir) {
+    const sessionCookies = (await context.cookies()).filter((cookie) => cookie.expires === -1);
+    await writeFile(path.join(profileDir, SESSION_COOKIES_FILE), JSON.stringify(sessionCookies), { mode: 0o600 });
+}
+/** Puts back the session cookies saved last time; a missing or unreadable file means none. */
+export async function restoreSessionCookies(context, profileDir) {
+    let cookies;
+    try {
+        cookies = JSON.parse(await readFile(path.join(profileDir, SESSION_COOKIES_FILE), "utf8"));
+    }
+    catch {
+        return;
+    }
+    if (!Array.isArray(cookies) || cookies.length === 0)
+        return;
+    // Cookies the browser kept itself are newer than the file's.
+    const kept = new Set((await context.cookies()).map((c) => `${c.name}|${c.domain}|${c.path}`));
+    const missing = cookies.filter((c) => !kept.has(`${c.name}|${c.domain}|${c.path}`));
+    if (missing.length > 0)
+        await context.addCookies(missing).catch(() => undefined);
+}
+//# sourceMappingURL=cookies.js.map

package/dist/browser/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../src/browser/cookies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAuB,EAAE,UAAkB;IAClF,MAAM,cAAc,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3F,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAChH,CAAC;AAED,8FAA8F;AAC9F,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAuB,EAAE,UAAkB;IACrF,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC,CAAa,CAAC;IACxG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC5D,6DAA6D;IAC7D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9F,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACpF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AACnF,CAAC"}

package/dist/browser/manager.d.ts

@@ -0,0 +1,57 @@
+import { chromium, type BrowserContext, type Page } from "playwright-core";
+import { type InstallChromium } from "./chromium.js";
+import { type BrowserOptions, type Channel } from "../options.js";
+import { MoodleError } from "../core/errors.js";
+type LaunchPersistentContext = typeof chromium.launchPersistentContext;
+export interface ContextOptions {
+    /** A visible window, whatever the options say (logging in by hand). */
+    headed?: boolean;
+}
+/** The browser's single persistent context, opened on first use (ADR-002). */
+export interface BrowserManager {
+    /**
+     * The open context, launching it if needed. A headed request relaunches a headless context with
+     * a window; a headless request reuses a headed one rather than closing a window the person may be using.
+     */
+    context(options?: ContextOptions): Promise<BrowserContext>;
+    /** The channel of the open context, or `undefined` while none is open. */
+    openChannel(): Channel | undefined;
+    /** Whether Chromium is being downloaded, or the last download failed (ADR-001). */
+    chromiumDownload(): "downloading" | "failed" | undefined;
+    /** Whether the browser shows a window now: what `setVisible` asked for, else the options. */
+    visible(): boolean;
+    /**
+     * Shows the browser (relaunching it with a window now, session kept) and follows the pages functions open
+     * in it, or hides it (closing the window; the next call runs headless). ADR-007.
+     */
+    setVisible(visible: boolean): Promise<void>;
+    /** While following, brings `url` (a site page) to the front of the window; best effort, never throws. */
+    show(url: string): Promise<void>;
+    /** The one working tab a program drives itself (ADR-007), the same one following shows; opens the browser if needed. */
+    tab(): Promise<Page>;
+    /** Saves the session cookies of the open context, if any (ADR-003). */
+    saveSession(): Promise<void>;
+    close(): Promise<void>;
+}
+/** No installed browser could be launched, and Chromium can't be downloaded (ADR-001). */
+export declare class BrowserNotFoundError extends MoodleError {
+    name: string;
+    constructor(message: string);
+}
+/** No browser yet: Chromium is downloading in the background, and the call should be retried later. */
+export declare class BrowserDownloadingError extends MoodleError {
+    name: string;
+    constructor(message: string);
+}
+/** A window was asked for where there's no screen to show it (a container, a server). */
+export declare class NoDisplayError extends MoodleError {
+    name: string;
+    constructor(message: string);
+}
+/**
+ * Whether a window can be shown. On Linux it needs an X or Wayland display; without one (Docker, a
+ * server) the driver refuses rather than trying, so it never reaches a display it wasn't given.
+ */
+export declare function canShowWindow(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
+export declare function createBrowserManager(config: BrowserOptions, launch?: LaunchPersistentContext, install?: InstallChromium, windowsPossible?: () => boolean): BrowserManager;
+export {};

package/dist/browser/manager.js

@@ -0,0 +1,177 @@
+import { mkdir } from "node:fs/promises";
+import { chromium } from "playwright-core";
+import { installChromium } from "./chromium.js";
+import { SYSTEM_CHANNELS } from "../options.js";
+import { followPages } from "../core/session.js";
+import { restoreSessionCookies, saveSessionCookies } from "./cookies.js";
+import { MoodleError } from "../core/errors.js";
+/** No installed browser could be launched, and Chromium can't be downloaded (ADR-001). */
+export class BrowserNotFoundError extends MoodleError {
+    name = "BrowserNotFoundError";
+    constructor(message) {
+        super(message, "browser-not-found");
+    }
+}
+/** No browser yet: Chromium is downloading in the background, and the call should be retried later. */
+export class BrowserDownloadingError extends MoodleError {
+    name = "BrowserDownloadingError";
+    constructor(message) {
+        super(message, "browser-downloading");
+    }
+}
+/** A window was asked for where there's no screen to show it (a container, a server). */
+export class NoDisplayError extends MoodleError {
+    name = "NoDisplayError";
+    constructor(message) {
+        super(message, "no-display");
+    }
+}
+/**
+ * Whether a window can be shown. On Linux it needs an X or Wayland display; without one (Docker, a
+ * server) the driver refuses rather than trying, so it never reaches a display it wasn't given.
+ */
+export function canShowWindow(env = process.env, platform = process.platform) {
+    return platform !== "linux" || Boolean(env.DISPLAY || env.WAYLAND_DISPLAY);
+}
+// Playwright's message when a channel isn't installed: "Chromium distribution 'msedge' is not found",
+// with " at <path>" only when it knows where to look (playwright-core 1.64).
+const NOT_INSTALLED = /distribution '[^']+' is not (found|supported)|Executable doesn't exist/i;
+// Moodle pages can take long, above all the first ones after the site starts.
+const NAVIGATION_TIMEOUT_MS = 60_000;
+export function createBrowserManager(config, launch = chromium.launchPersistentContext.bind(chromium), install = installChromium, windowsPossible = canShowWindow) {
+    let open;
+    // What `setVisible` asked for, over the options; following goes with it.
+    let shown;
+    let followTab;
+    // The download runs in the background, outside the queue: it takes minutes, longer than some
+    // callers wait, so calls meanwhile answer at once that it's downloading.
+    let download;
+    let downloadFailure;
+    function startDownload() {
+        const retry = downloadFailure ? ` The previous download failed (${downloadFailure}); trying again.` : "";
+        downloadFailure = undefined;
+        download ??= install().then(() => {
+            download = undefined;
+        }, (error) => {
+            download = undefined;
+            downloadFailure = error.message ?? String(error);
+        });
+        return downloading(retry);
+    }
+    function downloading(extra = "") {
+        return new BrowserDownloadingError(`${config.channel === "chromium" ? "Chromium isn't downloaded yet" : "Neither Microsoft Edge nor Google Chrome is available"}, so it's being downloaded (about 180 MB, into PLAYWRIGHT_BROWSERS_PATH or the user's ms-playwright cache).${extra} Try again in a minute or two.`);
+    }
+    // One operation at a time: two launches on the same profile would fail.
+    let queue = Promise.resolve();
+    function exclusive(operation) {
+        const result = queue.then(operation, operation);
+        queue = result.catch(() => undefined);
+        return result;
+    }
+    async function launchFirstAvailable(headed) {
+        await mkdir(config.profileDir, { recursive: true });
+        const channels = config.channel ? [config.channel] : [...SYSTEM_CHANNELS, ...(config.downloadBrowser ? ["chromium"] : [])];
+        const missing = [];
+        for (const channel of channels) {
+            if (channel === "chromium" && download)
+                throw downloading();
+            let context;
+            try {
+                // A window keeps its own size; a fixed viewport would leave it half empty.
+                context = await launch(config.profileDir, { channel, headless: !headed, ...(headed ? { viewport: null } : {}) });
+            }
+            catch (error) {
+                const message = error.message ?? String(error);
+                if (!NOT_INSTALLED.test(message))
+                    throw error;
+                if (channel === "chromium" && config.downloadBrowser)
+                    throw startDownload();
+                missing.push(channel);
+                continue;
+            }
+            context.setDefaultNavigationTimeout(NAVIGATION_TIMEOUT_MS);
+            followPages(context, (url) => manager.show(url));
+            await restoreSessionCookies(context, config.profileDir);
+            const opened = { context, channel, headed };
+            // The person may close the window: the next call opens the browser again, headless if they had
+            // asked to see it (closing it says they're done watching).
+            context.on("close", () => {
+                if (open !== opened)
+                    return;
+                open = undefined;
+                if (opened.headed && shown)
+                    shown = false;
+            });
+            return opened;
+        }
+        throw new BrowserNotFoundError(`No browser found (tried ${missing.join(", ")}). Install Microsoft Edge or Google Chrome${config.downloadBrowser ? "" : ", or allow downloading Chromium (downloadBrowser)"}, or choose another channel.`);
+    }
+    /** The working tab in `context`: the one already in use, else the window's first empty tab, else a new one. */
+    async function workTab(context) {
+        if (!followTab || followTab.isClosed())
+            followTab = context.pages().find((p) => p.url() === "about:blank") ?? (await context.newPage());
+        return followTab;
+    }
+    async function closeOpen() {
+        const current = open;
+        open = undefined;
+        followTab = undefined;
+        if (!current)
+            return;
+        await saveSessionCookies(current.context, config.profileDir).catch(() => undefined);
+        await current.context.close().catch(() => undefined);
+    }
+    const manager = {
+        context({ headed = false } = {}) {
+            return exclusive(async () => {
+                const wantHeaded = headed || (shown ?? !config.headless);
+                if (open && (open.headed || !wantHeaded))
+                    return open.context;
+                if (wantHeaded && !windowsPossible()) {
+                    throw new NoDisplayError(`There's no screen to show a browser window here (no DISPLAY or WAYLAND_DISPLAY), so ${headed ? "logging in by hand isn't possible" : "a headed browser can't open"}. Run headless with a profile already logged in, or where there's a screen.`);
+                }
+                await closeOpen();
+                open = await launchFirstAvailable(wantHeaded);
+                return open.context;
+            });
+        },
+        visible: () => shown ?? !config.headless,
+        setVisible: (visible) => exclusive(async () => {
+            if (visible && !windowsPossible()) {
+                throw new NoDisplayError("There's no screen to show a browser window here (no DISPLAY or WAYLAND_DISPLAY). The browser keeps working headless.");
+            }
+            shown = visible;
+            if (visible && !open?.headed) {
+                await closeOpen();
+                open = await launchFirstAvailable(true);
+            }
+            else if (!visible && open?.headed) {
+                await closeOpen();
+            }
+        }),
+        async show(url) {
+            const current = open;
+            if (!shown || !current?.headed)
+                return;
+            try {
+                const tab = await workTab(current.context);
+                if (tab.url() !== url)
+                    await tab.goto(url, { waitUntil: "domcontentloaded" });
+                await tab.bringToFront();
+            }
+            catch {
+                // Following is a courtesy: a page that doesn't load never changes a function's result.
+            }
+        },
+        tab: async () => workTab(await manager.context()),
+        openChannel: () => open?.channel,
+        chromiumDownload: () => (download ? "downloading" : downloadFailure ? "failed" : undefined),
+        saveSession: () => exclusive(async () => {
+            if (open)
+                await saveSessionCookies(open.context, config.profileDir);
+        }),
+        close: () => exclusive(closeOpen),
+    };
+    return manager;
+}
+//# sourceMappingURL=manager.js.map

package/dist/browser/manager.js.map

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

package/dist/browser.d.ts

@@ -0,0 +1,53 @@
+import { chromium, type BrowserContext, type Page } from "playwright-core";
+import { type InstallChromium } from "./chromiumInstaller.js";
+import { type BrowserOptions, type Channel } from "./options.js";
+type LaunchPersistentContext = typeof chromium.launchPersistentContext;
+export interface ContextOptions {
+    /** A visible window, whatever the options say (logging in by hand). */
+    headed?: boolean;
+}
+/** The browser's single persistent context, opened on first use (ADR-002). */
+export interface BrowserManager {
+    /**
+     * The open context, launching it if needed. A headed request relaunches a headless context with
+     * a window; a headless request reuses a headed one rather than closing a window the person may be using.
+     */
+    context(options?: ContextOptions): Promise<BrowserContext>;
+    /** The channel of the open context, or `undefined` while none is open. */
+    openChannel(): Channel | undefined;
+    /** Whether Chromium is being downloaded, or the last download failed (ADR-001). */
+    chromiumDownload(): "downloading" | "failed" | undefined;
+    /** Whether the browser shows a window now: what `setVisible` asked for, else the options. */
+    visible(): boolean;
+    /**
+     * Shows the browser (relaunching it with a window now, session kept) and follows the pages functions open
+     * in it, or hides it (closing the window; the next call runs headless). ADR-007.
+     */
+    setVisible(visible: boolean): Promise<void>;
+    /** While following, brings `url` (a site page) to the front of the window; best effort, never throws. */
+    show(url: string): Promise<void>;
+    /** The one working tab a program drives itself (ADR-007), the same one following shows; opens the browser if needed. */
+    tab(): Promise<Page>;
+    /** Saves the session cookies of the open context, if any (ADR-003). */
+    saveSession(): Promise<void>;
+    close(): Promise<void>;
+}
+/** No installed browser could be launched, and Chromium can't be downloaded (ADR-001). */
+export declare class BrowserNotFoundError extends Error {
+    name: string;
+}
+/** No browser yet: Chromium is downloading in the background, and the call should be retried later. */
+export declare class BrowserDownloadingError extends Error {
+    name: string;
+}
+/** A window was asked for where there's no screen to show it (a container, a server). */
+export declare class NoDisplayError extends Error {
+    name: string;
+}
+/**
+ * Whether a window can be shown. On Linux it needs an X or Wayland display; without one (Docker, a
+ * server) the driver refuses rather than trying, so it never reaches a display it wasn't given.
+ */
+export declare function canShowWindow(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
+export declare function createBrowserManager(config: BrowserOptions, launch?: LaunchPersistentContext, install?: InstallChromium, windowsPossible?: () => boolean): BrowserManager;
+export {};

package/dist/browser.js

@@ -0,0 +1,167 @@
+import { mkdir } from "node:fs/promises";
+import { chromium } from "playwright-core";
+import { installChromium } from "./chromiumInstaller.js";
+import { SYSTEM_CHANNELS } from "./options.js";
+import { followPages } from "./moodle/session.js";
+import { restoreSessionCookies, saveSessionCookies } from "./sessionCookies.js";
+/** No installed browser could be launched, and Chromium can't be downloaded (ADR-001). */
+export class BrowserNotFoundError extends Error {
+    name = "BrowserNotFoundError";
+}
+/** No browser yet: Chromium is downloading in the background, and the call should be retried later. */
+export class BrowserDownloadingError extends Error {
+    name = "BrowserDownloadingError";
+}
+/** A window was asked for where there's no screen to show it (a container, a server). */
+export class NoDisplayError extends Error {
+    name = "NoDisplayError";
+}
+/**
+ * Whether a window can be shown. On Linux it needs an X or Wayland display; without one (Docker, a
+ * server) the driver refuses rather than trying, so it never reaches a display it wasn't given.
+ */
+export function canShowWindow(env = process.env, platform = process.platform) {
+    return platform !== "linux" || Boolean(env.DISPLAY || env.WAYLAND_DISPLAY);
+}
+// Playwright's message when a channel isn't installed: "Chromium distribution 'msedge' is not found",
+// with " at <path>" only when it knows where to look (playwright-core 1.64).
+const NOT_INSTALLED = /distribution '[^']+' is not (found|supported)|Executable doesn't exist/i;
+// Moodle pages can take long, above all the first ones after the site starts.
+const NAVIGATION_TIMEOUT_MS = 60_000;
+export function createBrowserManager(config, launch = chromium.launchPersistentContext.bind(chromium), install = installChromium, windowsPossible = canShowWindow) {
+    let open;
+    // What `setVisible` asked for, over the options; following goes with it.
+    let shown;
+    let followTab;
+    // The download runs in the background, outside the queue: it takes minutes, longer than some
+    // callers wait, so calls meanwhile answer at once that it's downloading.
+    let download;
+    let downloadFailure;
+    function startDownload() {
+        const retry = downloadFailure ? ` The previous download failed (${downloadFailure}); trying again.` : "";
+        downloadFailure = undefined;
+        download ??= install().then(() => {
+            download = undefined;
+        }, (error) => {
+            download = undefined;
+            downloadFailure = error.message ?? String(error);
+        });
+        return downloading(retry);
+    }
+    function downloading(extra = "") {
+        return new BrowserDownloadingError(`${config.channel === "chromium" ? "Chromium isn't downloaded yet" : "Neither Microsoft Edge nor Google Chrome is available"}, so it's being downloaded (about 180 MB, into PLAYWRIGHT_BROWSERS_PATH or the user's ms-playwright cache).${extra} Try again in a minute or two.`);
+    }
+    // One operation at a time: two launches on the same profile would fail.
+    let queue = Promise.resolve();
+    function exclusive(operation) {
+        const result = queue.then(operation, operation);
+        queue = result.catch(() => undefined);
+        return result;
+    }
+    async function launchFirstAvailable(headed) {
+        await mkdir(config.profileDir, { recursive: true });
+        const channels = config.channel ? [config.channel] : [...SYSTEM_CHANNELS, ...(config.downloadBrowser ? ["chromium"] : [])];
+        const missing = [];
+        for (const channel of channels) {
+            if (channel === "chromium" && download)
+                throw downloading();
+            let context;
+            try {
+                // A window keeps its own size; a fixed viewport would leave it half empty.
+                context = await launch(config.profileDir, { channel, headless: !headed, ...(headed ? { viewport: null } : {}) });
+            }
+            catch (error) {
+                const message = error.message ?? String(error);
+                if (!NOT_INSTALLED.test(message))
+                    throw error;
+                if (channel === "chromium" && config.downloadBrowser)
+                    throw startDownload();
+                missing.push(channel);
+                continue;
+            }
+            context.setDefaultNavigationTimeout(NAVIGATION_TIMEOUT_MS);
+            followPages(context, (url) => manager.show(url));
+            await restoreSessionCookies(context, config.profileDir);
+            const opened = { context, channel, headed };
+            // The person may close the window: the next call opens the browser again, headless if they had
+            // asked to see it (closing it says they're done watching).
+            context.on("close", () => {
+                if (open !== opened)
+                    return;
+                open = undefined;
+                if (opened.headed && shown)
+                    shown = false;
+            });
+            return opened;
+        }
+        throw new BrowserNotFoundError(`No browser found (tried ${missing.join(", ")}). Install Microsoft Edge or Google Chrome${config.downloadBrowser ? "" : ", or allow downloading Chromium (downloadBrowser)"}, or choose another channel.`);
+    }
+    /** The working tab in `context`: the one already in use, else the window's first empty tab, else a new one. */
+    async function workTab(context) {
+        if (!followTab || followTab.isClosed())
+            followTab = context.pages().find((p) => p.url() === "about:blank") ?? (await context.newPage());
+        return followTab;
+    }
+    async function closeOpen() {
+        const current = open;
+        open = undefined;
+        followTab = undefined;
+        if (!current)
+            return;
+        await saveSessionCookies(current.context, config.profileDir).catch(() => undefined);
+        await current.context.close().catch(() => undefined);
+    }
+    const manager = {
+        context({ headed = false } = {}) {
+            return exclusive(async () => {
+                const wantHeaded = headed || (shown ?? !config.headless);
+                if (open && (open.headed || !wantHeaded))
+                    return open.context;
+                if (wantHeaded && !windowsPossible()) {
+                    throw new NoDisplayError(`There's no screen to show a browser window here (no DISPLAY or WAYLAND_DISPLAY), so ${headed ? "logging in by hand isn't possible" : "a headed browser can't open"}. Run headless with a profile already logged in, or where there's a screen.`);
+                }
+                await closeOpen();
+                open = await launchFirstAvailable(wantHeaded);
+                return open.context;
+            });
+        },
+        visible: () => shown ?? !config.headless,
+        setVisible: (visible) => exclusive(async () => {
+            if (visible && !windowsPossible()) {
+                throw new NoDisplayError("There's no screen to show a browser window here (no DISPLAY or WAYLAND_DISPLAY). The browser keeps working headless.");
+            }
+            shown = visible;
+            if (visible && !open?.headed) {
+                await closeOpen();
+                open = await launchFirstAvailable(true);
+            }
+            else if (!visible && open?.headed) {
+                await closeOpen();
+            }
+        }),
+        async show(url) {
+            const current = open;
+            if (!shown || !current?.headed)
+                return;
+            try {
+                const tab = await workTab(current.context);
+                if (tab.url() !== url)
+                    await tab.goto(url, { waitUntil: "domcontentloaded" });
+                await tab.bringToFront();
+            }
+            catch {
+                // Following is a courtesy: a page that doesn't load never changes a function's result.
+            }
+        },
+        tab: async () => workTab(await manager.context()),
+        openChannel: () => open?.channel,
+        chromiumDownload: () => (download ? "downloading" : downloadFailure ? "failed" : undefined),
+        saveSession: () => exclusive(async () => {
+            if (open)
+                await saveSessionCookies(open.context, config.profileDir);
+        }),
+        close: () => exclusive(closeOpen),
+    };
+    return manager;
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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