@mo7yw4ng/openape 1.0.0

package/script/src/lib/moodle.js

@@ -0,0 +1,966 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMessagesApi = exports.getResourcesByCoursesApi = exports.getQuizzesByCoursesApi = exports.getSupervideosInCourseApi = exports.getSiteInfoApi = exports.completeVideo = exports.downloadVideo = exports.getVideoMetadata = exports.getCalendarEventsApi = exports.getCalendarEvents = exports.getCourseGradesApi = exports.getCourseGrades = exports.getResourcesInCourse = exports.getDiscussionPosts = exports.getForumDiscussions = exports.getForumsByCourseIds = exports.getForumIdFromPage = exports.getForumsApi = exports.getForumsInCourse = exports.getQuizzesInCourse = exports.getSupervideosInCourse = exports.getCourseState = exports.getEnrolledCourses = exports.getEnrolledCoursesApi = exports.moodleAjax = exports.moodleApiCall = void 0;
+const dntShim = __importStar(require("../../_dnt.shims.js"));
+const node_html_parser_1 = require("node-html-parser");
+// ── HTML Parsing Helpers ──────────────────────────────────────────────────
+/**
+ * Get the HTML content of a page and parse it.
+ */
+async function fetchAndParse(page, url) {
+    await page.goto(url, { waitUntil: "domcontentloaded", timeout: 30000 });
+    const content = await page.content();
+    return (0, node_html_parser_1.parse)(content);
+}
+// ── Core Moodle AJAX Wrapper ───────────────────────────────────────────
+/**
+ * Moodle WS API functions that are known to work via /webservice/rest/server.php
+ * Other functions should use the sesskey-based AJAX API.
+ */
+const WS_API_FUNCTIONS = new Set([
+    "mod_forum_get_forums_by_courses",
+    "mod_forum_get_forum_discussions",
+    "mod_forum_get_forum_discussion_posts",
+    "gradereport_user_get_grade_items",
+    "core_calendar_get_calendar_events",
+    "core_course_get_contents",
+    "mod_quiz_get_quizzes_by_courses",
+    "mod_resource_get_resources_by_courses",
+    "core_message_get_messages",
+    "core_webservice_get_site_info",
+]);
+/**
+ * Convert args to URLSearchParams, handling arrays properly for Moodle WS API.
+ * Moodle expects array parameters as: courseids[0]=1&courseids[1]=2
+ */
+function buildWsParams(args) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(args)) {
+        if (Array.isArray(value)) {
+            // Array parameters: courseids[0]=1&courseids[1]=2
+            value.forEach((v, i) => {
+                params.append(`${key}[${i}]`, String(v));
+            });
+        }
+        else if (value !== null && value !== undefined) {
+            params.append(key, String(value));
+        }
+    }
+    return params;
+}
+/**
+ * Direct HTTP API call without browser (for WS API only).
+ * This is much faster than browser-based calls.
+ */
+async function moodleApiCall(session, methodname, args) {
+    if (!session.wsToken) {
+        throw new Error(`WS Token required for API call: ${methodname}`);
+    }
+    const params = buildWsParams(args);
+    params.set("wstoken", session.wsToken);
+    params.set("wsfunction", methodname);
+    params.set("moodlewsrestformat", "json");
+    const url = `${session.moodleBaseUrl}/webservice/rest/server.php?${params.toString()}`;
+    const response = await fetch(url, { method: "GET" });
+    const result = await response.json();
+    if (result.error) {
+        throw new Error(`WS ${methodname} failed: ${result.message ?? result.exception?.message ?? "Unknown error"}`);
+    }
+    return result;
+}
+exports.moodleApiCall = moodleApiCall;
+/**
+ * Send a Moodle AJAX request and return the result.
+ * Uses Web Service token if available AND the function is in WS_API_FUNCTIONS,
+ * otherwise falls back to sesskey-based AJAX (via /lib/ajax/service.php).
+ */
+async function moodleAjax(page, session, methodname, args) {
+    // Only use WS API for known WS functions
+    const useWsApi = session.wsToken && WS_API_FUNCTIONS.has(methodname);
+    if (useWsApi) {
+        // Use Moodle Web Service API
+        // Format: /webservice/rest/server.php?wstoken=TOKEN&wsfunction=FUNCTION&moodlewsrestformat=json
+        const params = buildWsParams(args);
+        params.set("wstoken", session.wsToken);
+        params.set("wsfunction", methodname);
+        params.set("moodlewsrestformat", "json");
+        const url = `${session.moodleBaseUrl}/webservice/rest/server.php?${params.toString()}`;
+        const result = await page.evaluate(async ({ url }) => {
+            const res = await fetch(url, { method: "GET" });
+            return res.json();
+        }, { url });
+        if (result.error) {
+            throw new Error(`WS ${methodname} failed: ${result.message ?? result.exception?.message ?? "Unknown error"}`);
+        }
+        return result;
+    }
+    else {
+        // Legacy sesskey-based AJAX format
+        const url = `${session.moodleBaseUrl}/lib/ajax/service.php?sesskey=${session.sesskey}&info=${methodname}`;
+        const payload = [{ index: 0, methodname, args }];
+        const result = await page.evaluate(async ({ url, payload }) => {
+            const res = await fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(payload),
+            });
+            return res.json();
+        }, { url, payload });
+        if (result?.[0]?.error) {
+            throw new Error(`AJAX ${methodname} failed: ${result[0].exception?.message ?? "Unknown error"}`);
+        }
+        return result[0].data;
+    }
+}
+exports.moodleAjax = moodleAjax;
+// ── Course Operations ─────────────────────────────────────────────────────
+/**
+ * Fetch enrolled courses via pure API (no browser required).
+ * Fast and lightweight - uses HTTP fetch directly.
+ */
+async function getEnrolledCoursesApi(session, options = {}) {
+    const data = await moodleApiCall(session, "core_course_get_enrolled_courses_by_timeline_classification", {
+        offset: 0,
+        limit: options.limit ?? 0,
+        classification: options.classification ?? "all",
+        sort: "fullname",
+        customfieldname: "",
+        customfieldvalue: "",
+        requiredfields: [
+            "id",
+            "fullname",
+            "shortname",
+            "idnumber",
+            "category",
+            "progress",
+            "startdate",
+            "enddate",
+        ],
+    });
+    return (data?.courses ?? []).map((c) => ({
+        id: c.id,
+        fullname: c.fullname,
+        shortname: c.shortname,
+        idnumber: c.idnumber,
+        category: c.category?.name,
+        progress: c.progress,
+        startdate: c.startdate,
+        enddate: c.enddate,
+    }));
+}
+exports.getEnrolledCoursesApi = getEnrolledCoursesApi;
+/**
+ * Fetch all enrolled courses via Moodle AJAX API.
+ */
+async function getEnrolledCourses(page, session, log, options = {}) {
+    log.debug("Fetching enrolled courses via AJAX...");
+    const data = await moodleAjax(page, session, "core_course_get_enrolled_courses_by_timeline_classification", {
+        offset: 0,
+        limit: options.limit ?? 0,
+        classification: options.classification ?? "all",
+        sort: "fullname",
+        customfieldname: "",
+        customfieldvalue: "",
+        requiredfields: [
+            "id",
+            "fullname",
+            "shortname",
+            "showcoursecategory",
+            "showshortname",
+            "visible",
+            "enddate",
+        ],
+    });
+    const courses = (data?.courses ?? []).map((c) => ({
+        id: c.id,
+        fullname: c.fullname,
+        shortname: c.shortname,
+        idnumber: c.idnumber,
+        category: c.category?.name,
+        progress: c.progress,
+        startdate: c.startdate,
+        enddate: c.enddate,
+    }));
+    log.debug(`Found ${courses.length} course${courses.length === 1 ? "" : "s"}.`);
+    return courses;
+}
+exports.getEnrolledCourses = getEnrolledCourses;
+/**
+ * Get course state (modules) via core_courseformat_get_state.
+ */
+async function getCourseState(page, session, courseId) {
+    const data = await moodleAjax(page, session, "core_courseformat_get_state", {
+        courseid: courseId,
+    });
+    return typeof data === "string" ? JSON.parse(data) : data;
+}
+exports.getCourseState = getCourseState;
+// ── Video Operations ──────────────────────────────────────────────────────
+/**
+ * Get all SuperVideo modules in a course.
+ */
+async function getSupervideosInCourse(page, session, courseId, log, options = {}) {
+    const state = await getCourseState(page, session, courseId);
+    const cms = state?.cm ?? [];
+    log.debug(`  Course state returned ${cms.length} modules`);
+    // Debug: log first few modules
+    for (let i = 0; i < Math.min(3, cms.length); i++) {
+        log.debug(`  Module ${i}: ${JSON.stringify(cms[i])}`);
+    }
+    const allSupervideos = cms.filter((cm) => cm.module === "supervideo" || cm.modname === "supervideo");
+    log.debug(`  Found ${allSupervideos.length} supervideo modules`);
+    const incomplete = allSupervideos.filter((cm) => !("isoverallcomplete" in cm && cm.isoverallcomplete));
+    log.debug(`  SuperVideo: ${allSupervideos.length} total, ${incomplete.length} incomplete`);
+    // Return only incomplete if requested, otherwise return all
+    const videos = options.incompleteOnly ? incomplete : allSupervideos;
+    return videos.map((cm) => ({
+        cmid: cm.cmid?.toString() ?? cm.id?.toString() ?? "",
+        name: cm.name,
+        url: cm.url,
+        isComplete: !!cm.isoverallcomplete,
+    }));
+}
+exports.getSupervideosInCourse = getSupervideosInCourse;
+// ── Quiz Operations ───────────────────────────────────────────────────────
+/**
+ * Get all Quiz modules in a course.
+ */
+async function getQuizzesInCourse(page, session, courseId, log) {
+    const state = await getCourseState(page, session, courseId);
+    const cms = state?.cm ?? [];
+    const allQuizzes = cms.filter((cm) => cm.module === "quiz");
+    const available = allQuizzes.filter((cm) => !("isoverallcomplete" in cm) || !cm.isoverallcomplete);
+    log.debug(`  Quiz: ${allQuizzes.length} total, ${available.length} available`);
+    return available.map((cm) => ({
+        cmid: cm.cmid?.toString() ?? cm.id?.toString() ?? "",
+        name: cm.name,
+        url: cm.url,
+        isComplete: !!cm.isoverallcomplete,
+        timeOpen: cm.timeopen,
+        timeClose: cm.timeclose,
+    }));
+}
+exports.getQuizzesInCourse = getQuizzesInCourse;
+// ── Forum Operations ──────────────────────────────────────────────────────
+/**
+ * Get all forum modules in a course.
+ * If WS token is available, fetches forum IDs directly via WS API.
+ */
+async function getForumsInCourse(page, session, courseId, log) {
+    // First get basic forum info from course state
+    const state = await getCourseState(page, session, courseId);
+    const cms = state?.cm ?? [];
+    const forums = cms.filter((cm) => cm.module === "forum");
+    log.debug(`  Found ${forums.length} forum${forums.length === 1 ? "" : "s"}.`);
+    const result = forums.map((cm) => ({
+        cmid: cm.cmid?.toString() ?? cm.id?.toString() ?? "",
+        forumId: 0,
+        name: cm.name,
+        url: cm.url,
+        courseId,
+        forumType: cm.modname,
+    }));
+    // If WS token is available, fetch forum IDs directly
+    if (session.wsToken && forums.length > 0) {
+        try {
+            const wsForums = await moodleAjax(page, session, "mod_forum_get_forums_by_courses", { courseids: [courseId] });
+            // Create maps for lookup by different fields
+            const byId = new Map(); // cmid -> forum id
+            const byName = new Map(); // name -> forum id
+            for (const wsForum of wsForums || []) {
+                if (wsForum.cmid) {
+                    byId.set(wsForum.cmid, wsForum.id);
+                }
+                if (wsForum.name) {
+                    byName.set(wsForum.name, wsForum.id);
+                }
+            }
+            // Merge forum IDs into result
+            for (const forum of result) {
+                const cmid = parseInt(forum.cmid, 10);
+                if (byId.has(cmid)) {
+                    forum.forumId = byId.get(cmid);
+                }
+                else if (byName.has(forum.name)) {
+                    forum.forumId = byName.get(forum.name);
+                }
+            }
+            const matchedCount = result.filter(f => f.forumId > 0).length;
+            log.debug(`  WS API provided forum IDs for ${matchedCount}/${result.length} forums.`);
+        }
+        catch (e) {
+            log.debug(`  WS API forum lookup failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    return result;
+}
+exports.getForumsInCourse = getForumsInCourse;
+/**
+ * Get all forums via pure WS API (no browser required).
+ * Fast and lightweight - uses HTTP fetch directly.
+ */
+async function getForumsApi(session, courseIds) {
+    const data = await moodleApiCall(session, "mod_forum_get_forums_by_courses", { courseids: courseIds });
+    return (data ?? []).map((f) => ({
+        id: f.id,
+        cmid: f.cmid,
+        name: f.name,
+        courseid: f.course, // API returns 'course' not 'courseid'
+    }));
+}
+exports.getForumsApi = getForumsApi;
+/**
+ * Extract forum ID from forum page.
+ * First tries to find it in embedded page data, then falls back to
+ * extracting it from discussion posts API.
+ */
+async function getForumIdFromPage(page, cmid, session) {
+    try {
+        await page.goto(`https://ilearning.cycu.edu.tw/mod/forum/view.php?id=${cmid}`, { waitUntil: "domcontentloaded", timeout: 30000 });
+        // First try: extract from page HTML
+        const forumId = await page.evaluate(() => {
+            // Try multiple patterns to find the forum ID
+            const patterns = [
+                /"forumid":(\d+)/,
+                /"forumId":(\d+)/,
+                /forumid=(\d+)/,
+                /data-forum-id="(\d+)"/,
+            ];
+            const html = document.body.innerHTML;
+            for (const pattern of patterns) {
+                const match = html.match(pattern);
+                if (match)
+                    return parseInt(match[1], 10);
+            }
+            // Try to find it in a script tag with forum configuration
+            const scripts = Array.from(document.querySelectorAll('script'));
+            for (const script of scripts) {
+                const text = script.textContent || '';
+                const match = text.match(/"forumid":(\d+)/);
+                if (match)
+                    return parseInt(match[1], 10);
+            }
+            // Try to find from discussion links - extract from API data embedded in page
+            const discussLinks = Array.from(document.querySelectorAll('a[href*="discuss.php"]'));
+            for (const link of discussLinks) {
+                const href = link.href;
+                // The discussion page might have forum info
+                const dMatch = href.match(/d=(\d+)/);
+                if (dMatch) {
+                    // Try to find parent element with forum data
+                    let parent = link.parentElement;
+                    let depth = 0;
+                    while (parent && depth < 10) {
+                        const parentHtml = parent.innerHTML;
+                        const fMatch = parentHtml.match(/"forum":(\d+)/);
+                        if (fMatch)
+                            return parseInt(fMatch[1], 10);
+                        parent = parent.parentElement;
+                        depth++;
+                    }
+                }
+            }
+            return null;
+        });
+        if (forumId)
+            return forumId;
+        // Fallback: if session is provided, try to get instance ID from discussion posts
+        if (session) {
+            // Get first discussion ID from page
+            const firstDiscussionId = await page.evaluate(() => {
+                const link = document.querySelector('a[href*="discuss.php"]');
+                if (!link)
+                    return null;
+                const href = link.href;
+                const match = href.match(/d=(\d+)/);
+                return match ? parseInt(match[1], 10) : null;
+            });
+            if (firstDiscussionId) {
+                // Try to get posts and extract forum ID from response
+                const data = await moodleAjax(page, session, "mod_forum_get_forum_discussion_posts", {
+                    discussionid: firstDiscussionId,
+                });
+                if (data?.posts && data.posts.length > 0) {
+                    const firstPost = data.posts[0];
+                    if (firstPost.forum) {
+                        return firstPost.forum;
+                    }
+                }
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+exports.getForumIdFromPage = getForumIdFromPage;
+/**
+ * Get forums by course IDs via AJAX.
+ * Returns forum instance IDs directly from Moodle API.
+ * This is the cleanest way to get forum instance IDs.
+ */
+async function getForumsByCourseIds(page, session, courseIds) {
+    if (courseIds.length === 0)
+        return [];
+    try {
+        const data = await moodleAjax(page, session, "mod_forum_get_forums_by_courses", {
+            courseids: courseIds,
+        });
+        return data ?? [];
+    }
+    catch (e) {
+        // Re-throw with more context
+        throw new Error(`mod_forum_get_forums_by_courses failed: ${e?.message || e}`);
+    }
+}
+exports.getForumsByCourseIds = getForumsByCourseIds;
+/**
+ * Get discussions in a forum via AJAX.
+ * Note: Requires forum instance ID, not cmid. Use getForumsByCourseIds() first.
+ */
+async function getForumDiscussions(page, session, forumId) {
+    const data = await moodleAjax(page, session, "mod_forum_get_forum_discussions", {
+        forumid: forumId,
+    });
+    return (data?.discussions ?? []).map((d) => ({
+        id: d.id,
+        forumId: d.forum,
+        name: d.name,
+        firstPostId: d.firstpost,
+        userId: d.userid,
+        groupId: d.groupid,
+        timedue: d.timedue,
+        timeModified: d.timemodified,
+        userModified: d.usermodified,
+        postCount: d.numdiscussion,
+        unread: d.unread,
+    }));
+}
+exports.getForumDiscussions = getForumDiscussions;
+/**
+ * Get posts in a discussion via AJAX.
+ */
+async function getDiscussionPosts(page, session, discussionId) {
+    try {
+        const data = await moodleAjax(page, session, "mod_forum_get_forum_discussion_posts", {
+            discussionid: discussionId,
+        });
+        if (!data?.posts || data.posts.length === 0) {
+            return [];
+        }
+        return data.posts.map((p) => ({
+            id: p.id,
+            subject: p.subject || "",
+            author: p.author?.fullname ?? p.username ?? "Unknown",
+            authorId: p.userid,
+            created: p.created,
+            modified: p.modified,
+            message: p.message || "",
+            discussionId: p.discussion,
+            unread: p.unread ?? false,
+        }));
+    }
+    catch (error) {
+        // Return empty array on error instead of throwing
+        // This allows commands to gracefully handle inaccessible discussions
+        return [];
+    }
+}
+exports.getDiscussionPosts = getDiscussionPosts;
+// ── Resource/Material Operations ──────────────────────────────────────────
+/**
+ * Get all resource modules in a course.
+ */
+async function getResourcesInCourse(page, session, courseId, log) {
+    const state = await getCourseState(page, session, courseId);
+    const cms = state?.cm ?? [];
+    const resources = cms.filter((cm) => ["resource", "url"].includes(cm.module));
+    log.debug(`  Found ${resources.length} resource${resources.length === 1 ? "" : "s"}.`);
+    return resources.map((cm) => ({
+        cmid: cm.cmid?.toString() ?? cm.id?.toString() ?? "",
+        name: cm.name,
+        url: cm.url,
+        courseId,
+        modType: cm.module,
+        mimetype: undefined,
+        filesize: undefined,
+        modified: 0,
+    }));
+}
+exports.getResourcesInCourse = getResourcesInCourse;
+// ── Grade Operations ──────────────────────────────────────────────────────
+/**
+ * Get course grades for the current user via AJAX.
+ */
+async function getCourseGrades(page, session, courseId) {
+    const data = await moodleAjax(page, session, "gradereport_user_get_grade_items", {
+        courseid: courseId,
+    });
+    const userGrades = data?.usergrades?.[0];
+    if (!userGrades) {
+        return { courseId, courseName: "", items: [] };
+    }
+    return {
+        courseId,
+        courseName: userGrades.coursefullname ?? "",
+        grade: userGrades.grade,
+        gradeFormatted: userGrades.gradeformatted,
+        rank: userGrades.rank,
+        totalUsers: userGrades.totalusers,
+        items: (userGrades.gradeitems ?? []).map((item) => ({
+            id: item.id,
+            name: item.itemname || item.itemmodule,
+            grade: item.grade,
+            gradeFormatted: item.gradeformatted,
+            range: item.graderangeformatted,
+            percentage: item.percentage,
+            weight: item.weight,
+            feedback: item.feedback,
+            graded: !!item.graded,
+        })),
+    };
+}
+exports.getCourseGrades = getCourseGrades;
+/**
+ * Get course grades for the current user via pure WS API (no browser required).
+ * Fast and lightweight - uses HTTP fetch directly.
+ */
+async function getCourseGradesApi(session, courseId) {
+    const data = await moodleApiCall(session, "gradereport_user_get_grade_items", {
+        courseid: courseId,
+    });
+    const userGrades = data?.usergrades?.[0];
+    if (!userGrades) {
+        return { courseId, courseName: "", items: [] };
+    }
+    return {
+        courseId,
+        courseName: userGrades.coursefullname ?? "",
+        grade: userGrades.grade,
+        gradeFormatted: userGrades.gradeformatted,
+        rank: userGrades.rank,
+        totalUsers: userGrades.totalusers,
+        items: (userGrades.gradeitems ?? []).map((item) => ({
+            id: item.id,
+            name: item.itemname || item.itemmodule,
+            grade: item.grade,
+            gradeFormatted: item.gradeformatted,
+            range: item.graderangeformatted,
+            percentage: item.percentage,
+            weight: item.weight,
+            feedback: item.feedback,
+            graded: !!item.graded,
+        })),
+    };
+}
+exports.getCourseGradesApi = getCourseGradesApi;
+// ── Calendar Operations ───────────────────────────────────────────────────
+/**
+ * Get calendar events via AJAX.
+ */
+async function getCalendarEvents(page, session, options = {}) {
+    const data = await moodleAjax(page, session, "core_calendar_get_calendar_events", {
+        ...options,
+    });
+    return (data?.events ?? []).map((e) => ({
+        id: e.id,
+        name: e.name,
+        description: e.description,
+        format: e.format,
+        courseid: e.courseid,
+        categoryid: e.categoryid,
+        groupid: e.groupid,
+        userid: e.userid,
+        moduleid: e.moduleid,
+        modulename: e.modulename,
+        instance: e.instance,
+        eventtype: e.eventtype,
+        timestart: e.timestart * 1000,
+        timeduration: e.timeduration ? e.timeduration * 1000 : undefined,
+        timedue: e.timedue ? e.timedue * 1000 : undefined,
+        visible: e.visible,
+        location: e.location,
+    }));
+}
+exports.getCalendarEvents = getCalendarEvents;
+/**
+ * Get calendar events via pure WS API (no browser required).
+ * Fast and lightweight - uses HTTP fetch directly.
+ */
+async function getCalendarEventsApi(session, options = {}) {
+    const data = await moodleApiCall(session, "core_calendar_get_calendar_events", {
+        ...options,
+    });
+    return (data?.events ?? []).map((e) => ({
+        id: e.id,
+        name: e.name,
+        description: e.description,
+        format: e.format,
+        courseid: e.courseid,
+        categoryid: e.categoryid,
+        groupid: e.groupid,
+        userid: e.userid,
+        moduleid: e.moduleid,
+        modulename: e.modulename,
+        instance: e.instance,
+        eventtype: e.eventtype,
+        timestart: e.timestart * 1000,
+        timeduration: e.timeduration ? e.timeduration * 1000 : undefined,
+        timedue: e.timedue ? e.timedue * 1000 : undefined,
+        visible: e.visible,
+        location: e.location,
+    }));
+}
+exports.getCalendarEventsApi = getCalendarEventsApi;
+// ── Video Metadata (from original course.ts) ───────────────────────────────
+/**
+ * Visit a SuperVideo activity page and extract view_id + duration.
+ */
+async function getVideoMetadata(page, activityUrl, log) {
+    await page.goto(activityUrl, { waitUntil: "domcontentloaded", timeout: 20000 });
+    const name = await page.title();
+    const pageSource = await page.content();
+    let viewId = null;
+    const viewIdPatterns = [
+        /player_create.*?amd\.\w+\((\d+)/,
+        /view_id['":\s]+(\d+)/,
+    ];
+    for (const pattern of viewIdPatterns) {
+        const match = pageSource.match(pattern);
+        if (match) {
+            viewId = parseInt(match[1], 10);
+            break;
+        }
+    }
+    if (viewId === null) {
+        throw new Error(`Could not extract view_id from ${activityUrl}`);
+    }
+    let duration = null;
+    const isYoutube = pageSource.includes("youtube.com") || pageSource.includes("youtu.be");
+    if (!isYoutube) {
+        try {
+            await page.waitForSelector("video", { timeout: 10000 });
+            duration = await page.evaluate(() => {
+                return new Promise((resolve) => {
+                    const media = document.querySelector("video");
+                    if (!media)
+                        return resolve(null);
+                    if (media.duration && isFinite(media.duration)) {
+                        return resolve(Math.ceil(media.duration));
+                    }
+                    media.addEventListener("loadedmetadata", () => {
+                        resolve(Math.ceil(media.duration));
+                    });
+                    setTimeout(() => resolve(null), 8000);
+                });
+            });
+        }
+        catch {
+            // no video element
+        }
+    }
+    if (!duration) {
+        const durationMatch = pageSource.match(/["']?duration["']?\s*[:=]\s*(\d+)/);
+        if (durationMatch) {
+            duration = parseInt(durationMatch[1], 10);
+        }
+    }
+    if (!duration) {
+        duration = 600;
+        log.debug(`    Duration unknown${isYoutube ? " (YouTube)" : ""}, using ${duration}s`);
+    }
+    log.debug(`    viewId=${viewId}, duration=${duration}s`);
+    // Phase 1: Extract video sources
+    const videoSources = [];
+    const youtubeIds = [];
+    // 1. Get src from <video> element
+    const videoSrc = await page.evaluate(() => {
+        const video = document.querySelector("video");
+        return video?.src || null;
+    });
+    if (videoSrc)
+        videoSources.push(videoSrc);
+    // 2. Get src from <source> elements
+    const sourceSrcs = await page.evaluate(() => {
+        const sources = Array.from(document.querySelectorAll("source"));
+        return sources.map(s => s.src).filter((src) => !!src);
+    });
+    videoSources.push(...sourceSrcs);
+    // 3. Get src from <iframe> elements (YouTube, Vimeo, etc.)
+    // Wait a bit for iframes to load
+    await page.waitForTimeout(1000);
+    const iframeSrcs = await page.evaluate(() => {
+        const iframes = Array.from(document.querySelectorAll("iframe"));
+        return iframes.map(f => f.src).filter((src) => !!src && src.length > 0);
+    });
+    // Extract YouTube video IDs from iframe URLs
+    for (const iframeSrc of iframeSrcs) {
+        videoSources.push(iframeSrc);
+        // Extract YouTube video ID
+        const ytMatch = iframeSrc.match(/(?:youtube\.com\/(?:embed\/|v\/|watch\?v=)|youtu\.be\/)([a-zA-Z0-9_-]{11})/);
+        if (ytMatch) {
+            youtubeIds.push(ytMatch[1]);
+        }
+    }
+    // 4. Check for blob/data URLs
+    const hasBlobUrl = await page.evaluate(() => {
+        const video = document.querySelector("video");
+        const src = video?.src || "";
+        return src.startsWith("blob:") || src.startsWith("data:");
+    });
+    // Deduplicate sources
+    const uniqueSources = [...new Set(videoSources)];
+    log.debug(`    Found ${uniqueSources.length} video source(s)`);
+    if (uniqueSources.length > 0) {
+        log.debug(`    Sources: ${uniqueSources.map(s => s.substring(0, 50) + (s.length > 50 ? "..." : "")).join(", ")}`);
+    }
+    if (youtubeIds.length > 0) {
+        log.debug(`    YouTube IDs: ${youtubeIds.join(", ")}`);
+    }
+    if (hasBlobUrl) {
+        log.warn(`    Video uses blob URL - cannot download directly`);
+    }
+    return {
+        name,
+        url: activityUrl,
+        viewId,
+        duration,
+        existingPercent: 0,
+        videoSources: uniqueSources,
+        youtubeIds,
+    };
+}
+exports.getVideoMetadata = getVideoMetadata;
+// ── Video Download ─────────────────────────────────────────────────────────────
+/**
+ * Download a video from SuperVideo activity.
+ * Supports direct video URLs (pluginfile.php) and YouTube videos.
+ */
+async function downloadVideo(page, metadata, outputPath, log) {
+    const { name, videoSources, youtubeIds } = metadata;
+    log.info(`正在下載: ${name}`);
+    // Priority 1: Direct video URL (pluginfile.php, .mp4, etc.)
+    const directUrl = videoSources.find(s => s.includes("pluginfile.php") ||
+        s.endsWith(".mp4") ||
+        s.endsWith(".webm") ||
+        s.endsWith(".mov"));
+    if (directUrl) {
+        log.debug(`  類型: 直接下載 (${directUrl.substring(0, 60)}...)`);
+        try {
+            // Get session cookies from the page for authentication
+            const cookies = await page.context().cookies();
+            const cookieHeader = cookies
+                .map(c => `${c.name}=${c.value}`)
+                .join("; ");
+            // Use native fetch with session cookies
+            const response = await fetch(directUrl, {
+                headers: {
+                    "Cookie": cookieHeader,
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}`);
+            }
+            // Get array buffer and convert to Uint8Array
+            const arrayBuffer = await response.arrayBuffer();
+            const uint8Array = new Uint8Array(arrayBuffer);
+            // Write to file using Deno
+            await dntShim.Deno.writeFile(outputPath, uint8Array);
+            return { success: true, path: outputPath, type: "direct" };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            log.error(`  下載失敗: ${msg}`);
+            return { success: false, error: msg };
+        }
+    }
+    // Priority 2: YouTube video
+    if (youtubeIds && youtubeIds.length > 0) {
+        log.debug(`  類型: YouTube (ID: ${youtubeIds[0]})`);
+        return {
+            success: false,
+            error: `YouTube 影片無法直接下載。請使用 yt-dlp: yt-dlp https://www.youtube.com/watch?v=${youtubeIds[0]}`,
+            type: "youtube",
+        };
+    }
+    // Priority 3: Other iframe/embedded video
+    if (videoSources.length > 0) {
+        log.debug(`  類型: 嵌入影片 (${videoSources[0].substring(0, 60)}...)`);
+        return {
+            success: false,
+            error: "嵌入影片無法直接下載",
+            type: "embedded",
+        };
+    }
+    return {
+        success: false,
+        error: "未找到影片來源",
+    };
+}
+exports.downloadVideo = downloadVideo;
+// ── Progress Completion (from original progress.ts) ───────────────────────
+/**
+ * Complete a video by forging progress AJAX call.
+ */
+async function completeVideo(page, session, video, log) {
+    const { viewId, duration } = video;
+    // Build duration map array (required by Moodle)
+    const map = Array.from({ length: 100 }, (_, i) => ({
+        time: Math.round((duration * i) / 100),
+        percent: i,
+    }));
+    const payload = {
+        view_id: viewId,
+        currenttime: duration,
+        duration: duration,
+        percent: 100,
+        mapa: JSON.stringify(map),
+    };
+    const url = `${session.moodleBaseUrl}/lib/ajax/service.php?sesskey=${session.sesskey}&info=mod_supervideo_progress_save`;
+    const ajaxPayload = [{ index: 0, methodname: "mod_supervideo_progress_save", args: payload }];
+    try {
+        const result = await page.evaluate(async ({ url, ajaxPayload }) => {
+            const res = await fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(ajaxPayload),
+            });
+            return res.json();
+        }, { url, ajaxPayload });
+        if (result?.[0]?.error) {
+            log.debug(`    Error: ${result[0].exception?.message ?? "Unknown error"}`);
+            return false;
+        }
+        return true;
+    }
+    catch (err) {
+        log.debug(`    Exception: ${err instanceof Error ? err.message : String(err)}`);
+        return false;
+    }
+}
+exports.completeVideo = completeVideo;
+// ── Site Info (Get User ID) ───────────────────────────────────────────────────
+/**
+ * Get site info including current user ID via pure WS API.
+ */
+async function getSiteInfoApi(session) {
+    const data = await moodleApiCall(session, "core_webservice_get_site_info", {});
+    return {
+        userid: data.userid,
+        username: data.username,
+        fullname: data.fullname,
+        sitename: data.sitename,
+    };
+}
+exports.getSiteInfoApi = getSiteInfoApi;
+// ── Videos via WS API ─────────────────────────────────────────────────────────
+/**
+ * Get course contents and filter for SuperVideo modules via pure WS API.
+ */
+async function getSupervideosInCourseApi(session, courseId) {
+    const data = await moodleApiCall(session, "core_course_get_contents", { courseid: courseId });
+    const videos = [];
+    // data is an array of sections
+    for (const section of data || []) {
+        // Each section has modules array
+        if (!section.modules)
+            continue;
+        for (const module of section.modules) {
+            // Filter for SuperVideo modname
+            if (module.modname === "supervideo") {
+                videos.push({
+                    cmid: module.id.toString(),
+                    name: module.name,
+                    url: module.url,
+                    isComplete: false, // API doesn't provide completion status
+                });
+            }
+        }
+    }
+    return videos;
+}
+exports.getSupervideosInCourseApi = getSupervideosInCourseApi;
+/**
+ * Get quizzes in courses via pure WS API.
+ */
+async function getQuizzesByCoursesApi(session, courseIds) {
+    if (courseIds.length === 0)
+        return [];
+    const data = await moodleApiCall(session, "mod_quiz_get_quizzes_by_courses", { courseids: courseIds });
+    return (data?.quizzes ?? []).map((q) => ({
+        cmid: q.coursemodule.toString(),
+        name: q.name,
+        url: q.viewurl,
+        isComplete: false,
+        timeOpen: q.timeopen,
+        timeClose: q.timeclose,
+        courseId: q.course,
+    }));
+}
+exports.getQuizzesByCoursesApi = getQuizzesByCoursesApi;
+// ── Materials via WS API ──────────────────────────────────────────────────────
+/**
+ * Get resources in courses via pure WS API.
+ */
+async function getResourcesByCoursesApi(session, courseIds) {
+    if (courseIds.length === 0)
+        return [];
+    const data = await moodleApiCall(session, "mod_resource_get_resources_by_courses", { courseids: courseIds });
+    return (data?.resources ?? []).map((r) => {
+        // Extract file info from contentfiles array
+        const firstFile = r.contentfiles?.[0];
+        return {
+            cmid: r.coursemodule?.toString() ?? r.id?.toString() ?? "",
+            name: r.name,
+            url: firstFile?.fileurl ?? "",
+            courseId: r.course,
+            modType: "resource",
+            mimetype: firstFile?.mimetype,
+            filesize: firstFile?.filesize,
+            modified: r.timemodified,
+        };
+    });
+}
+exports.getResourcesByCoursesApi = getResourcesByCoursesApi;
+/**
+ * Get messages for the current user via pure WS API.
+ */
+async function getMessagesApi(session, userIdTo, options = {}) {
+    const data = await moodleApiCall(session, "core_message_get_messages", { useridto: userIdTo, ...options });
+    return (data?.messages ?? []).map((m) => ({
+        id: m.id,
+        useridfrom: m.useridfrom,
+        useridto: m.useridto,
+        subject: m.subject,
+        text: m.smallmessage,
+        timecreated: m.timecreated,
+        fullmessage: m.fullmessage,
+        fullmessageformat: m.fullmessageformat,
+        fullmessagehtml: m.fullmessagehtml,
+    }));
+}
+exports.getMessagesApi = getMessagesApi;