@falkenslab/moodle-driver 0.0.0-stage → 0.3.1

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,mGAAmG;AACnG,gGAAgG;AAEhG,kFAAkF;AAClF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAC7D,+FAA+F;AAC/F,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAG,eAAe,EAAE,UAAU,CAAU,CAAC;AAGlE,4GAA4G;AAC5G,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,WAAW,EAAE,MAAM,CAAU,CAAC;AAkBrD,iCAAiC;AACjC,MAAM,OAAO,cAAe,SAAQ,WAAW;IACpC,IAAI,GAAG,gBAAgB,CAAC;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC/B,CAAC;CACF;AAED,6FAA6F;AAC7F,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,cAAc,CAAC,sCAAsC,KAAK,IAAI,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,cAAc,CAAC,8CAA8C,KAAK,IAAI,CAAC,CAAC;IACpF,CAAC;IACD,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAChB,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC;IACrD,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC"}

package/dist/sessionCookies.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-mcp-session-cookies.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/sessionCookies.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-mcp-session-cookies.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=sessionCookies.js.map

package/dist/sessionCookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionCookies.js","sourceRoot":"","sources":["../src/sessionCookies.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,iCAAiC,CAAC;AAEtE,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/testing/fakeMoodle.d.ts

@@ -0,0 +1,55 @@
+import { type Browser, type BrowserContext } from "playwright-core";
+export declare const SITE = "http://moodle.test/";
+/**
+ * A Moodle page reduced to what the driver reads: the body class, `M.cfg` (`wwwroot`, `sesskey`,
+ * `userId`), the logout link in the user menu and the page heading, as Moodle 5.2 renders them.
+ */
+export declare function moodlePage({ userId, heading, guest, sesskey, wwwroot, body, bodyId, bodyClass, }: {
+    userId: number;
+    heading?: string;
+    guest?: boolean;
+    sesskey?: string;
+    wwwroot?: string;
+    body?: string;
+    bodyId?: string;
+    bodyClass?: string;
+}): string;
+/**
+ * The first browser that launches headless: the system's Edge or Chrome, or Playwright's own Chromium
+ * (the test container, `npm run test:docker`); `undefined` skips the tests that need one.
+ */
+export declare function launchTestBrowser(): Promise<Browser | undefined>;
+/** Thrown by a fake service to answer with Moodle's exception `errorcode`. */
+export declare class ServiceFailure extends Error {
+    readonly errorcode: string;
+    constructor(errorcode: string);
+}
+export interface FakeMoodleState {
+    /** The logged-in user; none means every page is the login page. */
+    user?: {
+        id: number;
+        fullName: string;
+    };
+    /** The session's sesskey: changing it makes older tabs' service calls fail with `invalidsesskey`. */
+    sesskey?: string;
+    /** AJAX services by name: what each returns as `data` for its arguments; throwing `ServiceFailure` answers with that error code. */
+    services?: Record<string, (args: Record<string, unknown>) => unknown>;
+    /** Extra body HTML for the pages at these paths (logged in only). */
+    bodies?: Record<string, string>;
+    /** Extra body classes for the pages at these paths, as Moodle adds (`format-topics` on a course page). */
+    bodyClasses?: Record<string, string>;
+    /** Every page path served, for tests that count page loads. */
+    pagesServed?: string[];
+    /** Every service call received. */
+    serviceCalls?: {
+        methodname: string;
+        args: Record<string, unknown>;
+    }[];
+}
+/**
+ * Serves a fake Moodle at `SITE` in `context`: logged out, every page is the login page, as with
+ * Moodle's forced login (served in place: Playwright doesn't route the request after a redirect it
+ * fulfilled, confirmed empirically); `state.user` logs someone in. `lib/ajax/service.php` answers
+ * like Moodle's, exceptions included.
+ */
+export declare function serveFakeMoodle(context: BrowserContext, state: FakeMoodleState): Promise<void>;

package/dist/testing/fakeMoodle.js

@@ -0,0 +1,103 @@
+import { chromium } from "playwright-core";
+import { setTransport } from "../core/http.js";
+export const SITE = "http://moodle.test/";
+// The fake's own blank page, for requests the driver makes without a tab.
+const TRANSPORT_PATH = "__fake-transport";
+/**
+ * A Moodle page reduced to what the driver reads: the body class, `M.cfg` (`wwwroot`, `sesskey`,
+ * `userId`), the logout link in the user menu and the page heading, as Moodle 5.2 renders them.
+ */
+export function moodlePage({ userId, heading = "Dashboard", guest = false, sesskey = "s1", wwwroot = "http://moodle.test", body = "", bodyId = "", bodyClass = "", }) {
+    const loggedIn = userId > 0;
+    return `<!DOCTYPE html><html><head><title>${heading}</title>
+<script>var M = {}; M.cfg = {"wwwroot":${JSON.stringify(wwwroot).replaceAll("/", "\\/")},"sesskey":"${sesskey}","userId":${userId},"language":"en","usertimezone":"Europe/Madrid"};</script></head>
+<body${bodyId ? ` id="${bodyId}"` : ""} class="${loggedIn ? "" : "notloggedin"} ${bodyClass}">
+<nav>${loggedIn && !guest ? '<div class="usermenu"><a href="http://moodle.test/login/logout.php?sesskey=x">Log out</a></div>' : '<a href="http://moodle.test/login/index.php">Log in</a>'}</nav>
+<div id="page-header"><div class="page-header-headings"><h1>${heading}</h1></div></div>
+${body}
+</body></html>`;
+}
+/**
+ * The first browser that launches headless: the system's Edge or Chrome, or Playwright's own Chromium
+ * (the test container, `npm run test:docker`); `undefined` skips the tests that need one.
+ */
+export async function launchTestBrowser() {
+    for (const channel of ["msedge", "chrome", "chromium"]) {
+        try {
+            return await chromium.launch({ channel, headless: true });
+        }
+        catch {
+            // Try the next one.
+        }
+    }
+    return undefined;
+}
+/** Thrown by a fake service to answer with Moodle's exception `errorcode`. */
+export class ServiceFailure extends Error {
+    errorcode;
+    constructor(errorcode) {
+        super(errorcode);
+        this.errorcode = errorcode;
+    }
+}
+/**
+ * Serves a fake Moodle at `SITE` in `context`: logged out, every page is the login page, as with
+ * Moodle's forced login (served in place: Playwright doesn't route the request after a redirect it
+ * fulfilled, confirmed empirically); `state.user` logs someone in. `lib/ajax/service.php` answers
+ * like Moodle's, exceptions included.
+ */
+export async function serveFakeMoodle(context, state) {
+    // The driver's requests without a tab (`context.request`) don't go through routes: here they go
+    // through a blank page of the site's origin, whose `fetch` does (the page itself isn't counted).
+    let transportPage;
+    setTransport(context, async (url, request) => {
+        transportPage ??= context.newPage().then(async (page) => {
+            await page.goto(`${SITE}${TRANSPORT_PATH}`);
+            return page;
+        });
+        const page = await transportPage;
+        return page.evaluate(async ({ url, request }) => {
+            const g = globalThis;
+            const response = await g.fetch(url, { method: request.method ?? "GET", headers: request.headers, body: request.body, credentials: "same-origin" });
+            return { status: response.status, url: response.url, body: await response.text() };
+        }, { url, request });
+    });
+    await context.route(`${SITE}**`, async (route) => {
+        const url = new URL(route.request().url());
+        if (url.pathname === `/${TRANSPORT_PATH}`)
+            return route.fulfill({ status: 200, contentType: "text/html", body: "<!DOCTYPE html><title>transport</title>" });
+        const sesskey = state.sesskey ?? "s1";
+        if (url.pathname === "/lib/ajax/service.php") {
+            const json = (body) => route.fulfill({ status: 200, contentType: "application/json", body: JSON.stringify(body) });
+            const [request] = JSON.parse(route.request().postData() ?? "[]");
+            if (!request)
+                return json([]);
+            state.serviceCalls?.push({ methodname: request.methodname, args: request.args });
+            const fail = (errorcode) => json([{ error: true, exception: { message: errorcode, errorcode } }]);
+            if (!state.user)
+                return fail("servicerequireslogin");
+            if (url.searchParams.get("sesskey") !== sesskey)
+                return fail("invalidsesskey");
+            const service = state.services?.[request.methodname];
+            if (!service)
+                return fail("invalidrecord");
+            try {
+                return json([{ error: false, data: service(request.args) }]);
+            }
+            catch (error) {
+                if (error instanceof ServiceFailure)
+                    return fail(error.errorcode);
+                throw error;
+            }
+        }
+        state.pagesServed?.push(url.pathname);
+        const html = (body) => route.fulfill({ status: 200, contentType: "text/html", body });
+        if (!state.user)
+            return html(moodlePage({ userId: 0, heading: "Log in", sesskey }));
+        const heading = url.pathname === "/user/profile.php" ? state.user.fullName : "Dashboard";
+        // Moodle names each page in the body id: /mod/forum/view.php is page-mod-forum-view.
+        const bodyId = `page${url.pathname.replace(/\.php$/, "").replaceAll("/", "-")}`;
+        return html(moodlePage({ userId: state.user.id, heading, sesskey, body: state.bodies?.[url.pathname], bodyId, bodyClass: state.bodyClasses?.[url.pathname] }));
+    });
+}
+//# sourceMappingURL=fakeMoodle.js.map

package/dist/testing/fakeMoodle.js.map

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

package/dist/testing/gradingPanel.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A grader panel reduced to its submission status table, as Moodle 5.2 renders it: online text
+ * with a summary and a full block, a short online text with only a summary, files, and comments.
+ * Made up; no real submission.
+ */
+export declare const PANEL = "<div class=\"submissionstatustable\"><h3>Submission</h3>\n<div class=\"assignsubmission assignsubmission_onlinetext\">\n  <div class=\"box plugincontentsummary summary_assignsubmission_onlinetext_8\">\n    <a class=\"expandsummaryicon expand_assignsubmission_onlinetext_8\" aria-label=\"View full\" href=\"\"><i class=\"icon\"></i></a>(40 words) First paragraph\u2026\n  </div>\n  <div class=\"box hidefull full_assignsubmission_onlinetext_8\">\n    <a class=\"expandsummaryicon contract_assignsubmission_onlinetext_8\" aria-label=\"View summary\" href=\"\"><i class=\"icon\"></i></a>\n    <div class=\"no-overflow\"><p>First   paragraph, with <code>x = 1</code>.</p><p>Second<br>line &amp; more.</p><ul><li>one</li><li>two</li></ul></div>\n  </div>\n</div>\n<div class=\"box plugincontentsummary summary_assignsubmission_file_8\">\n  <div class=\"fileuploadsubmission\"><a href=\"http://moodle.test/pluginfile.php/17/assignsubmission_file/submission_files/8/essay.pdf?forcedownload=1\">essay.pdf</a></div>\n</div>\n<div class=\"box plugincontentsummary summary_assignsubmission_onlinetext_9\"><div class=\"no-overflow\"><p>Short answer.</p></div></div>\n<div class=\"box plugincontentsummary summary_assignsubmission_comments_8\"><a href=\"#\">Comments (0)</a></div>\n</div>";

package/dist/testing/gradingPanel.js

@@ -0,0 +1,22 @@
+/**
+ * A grader panel reduced to its submission status table, as Moodle 5.2 renders it: online text
+ * with a summary and a full block, a short online text with only a summary, files, and comments.
+ * Made up; no real submission.
+ */
+export const PANEL = `<div class="submissionstatustable"><h3>Submission</h3>
+<div class="assignsubmission assignsubmission_onlinetext">
+  <div class="box plugincontentsummary summary_assignsubmission_onlinetext_8">
+    <a class="expandsummaryicon expand_assignsubmission_onlinetext_8" aria-label="View full" href=""><i class="icon"></i></a>(40 words) First paragraph…
+  </div>
+  <div class="box hidefull full_assignsubmission_onlinetext_8">
+    <a class="expandsummaryicon contract_assignsubmission_onlinetext_8" aria-label="View summary" href=""><i class="icon"></i></a>
+    <div class="no-overflow"><p>First   paragraph, with <code>x = 1</code>.</p><p>Second<br>line &amp; more.</p><ul><li>one</li><li>two</li></ul></div>
+  </div>
+</div>
+<div class="box plugincontentsummary summary_assignsubmission_file_8">
+  <div class="fileuploadsubmission"><a href="http://moodle.test/pluginfile.php/17/assignsubmission_file/submission_files/8/essay.pdf?forcedownload=1">essay.pdf</a></div>
+</div>
+<div class="box plugincontentsummary summary_assignsubmission_onlinetext_9"><div class="no-overflow"><p>Short answer.</p></div></div>
+<div class="box plugincontentsummary summary_assignsubmission_comments_8"><a href="#">Comments (0)</a></div>
+</div>`;
+//# sourceMappingURL=gradingPanel.js.map

package/dist/testing/gradingPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradingPanel.js","sourceRoot":"","sources":["../../src/testing/gradingPanel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;OAed,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,5 @@
+import type { BrowserManager } from "../browser/manager.js";
+export { SITE, ServiceFailure, launchTestBrowser, moodlePage, serveFakeMoodle, type FakeMoodleState } from "./fakeMoodle.js";
+export { PANEL } from "./gradingPanel.js";
+/** A browser manager that never launches anything, with these methods instead. */
+export declare function fakeBrowserManager(overrides?: Partial<BrowserManager>): BrowserManager;

package/dist/testing/index.js

@@ -0,0 +1,18 @@
+export { SITE, ServiceFailure, launchTestBrowser, moodlePage, serveFakeMoodle } from "./fakeMoodle.js";
+export { PANEL } from "./gradingPanel.js";
+/** A browser manager that never launches anything, with these methods instead. */
+export function fakeBrowserManager(overrides = {}) {
+    return {
+        context: () => Promise.reject(new Error("this test opens no browser")),
+        openChannel: () => undefined,
+        chromiumDownload: () => undefined,
+        visible: () => false,
+        setVisible: async () => undefined,
+        show: async () => undefined,
+        tab: () => Promise.reject(new Error("this test opens no browser")),
+        saveSession: async () => undefined,
+        close: async () => undefined,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,iBAAiB,EAAE,UAAU,EAAE,eAAe,EAAwB,MAAM,iBAAiB,CAAC;AAC7H,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,kFAAkF;AAClF,MAAM,UAAU,kBAAkB,CAAC,YAAqC,EAAE;IACxE,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACtE,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS;QAC5B,gBAAgB,EAAE,GAAG,EAAE,CAAC,SAAS;QACjC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK;QACpB,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QACjC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QAC3B,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAClE,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QAClC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QAC5B,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,79 @@
 {
   "name": "@falkenslab/moodle-driver",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.1",
+  "description": "Full control of Moodle as any user, from code or the command line, with their own login: no web services, no tokens, no admin.",
+  "author": "Falkenslab",
+  "license": "MIT",
+  "keywords": [
+    "moodle",
+    "lms",
+    "playwright",
+    "automation",
+    "browser"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./internals": {
+      "types": "./dist/internals.d.ts",
+      "import": "./dist/internals.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
+    }
+  },
+  "bin": {
+    "moodle": "dist/cli/main.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "tsx --test --test-concurrency=1 \"test/**/*.test.ts\"",
+    "test:docker": "node scripts/in-docker.mjs npm test",
+    "prepare": "npm run build",
+    "docs:install": "npm --prefix docs ci",
+    "docs:start": "npm --prefix docs start",
+    "docs:build": "npm --prefix docs run build",
+    "docs:check": "node scripts/check-doc-examples.mjs",
+    "cli:generate": "node scripts/generate-cli-commands.mjs",
+    "prebuild": "node scripts/generate-cli-commands.mjs --check"
+  },
+  "peerDependencies": {
+    "playwright-core": "^1.64.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^20.19.0",
+    "eslint": "^10.12.0",
+    "globals": "^17.13.0",
+    "playwright-core": "^1.64.0",
+    "tsx": "^4.23.15",
+    "typescript": "~6.0.3",
+    "typescript-eslint": "^8.71.1"
+  },
+  "allowScripts": {
+    "esbuild@0.28.2": true
+  },
+  "homepage": "https://falkenslab.github.io/moodle-driver/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/falkenslab/moodle-driver.git"
+  },
+  "bugs": {
+    "url": "https://github.com/falkenslab/moodle-driver/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}