@mo7yw4ng/openape 1.0.1 → 1.0.3

package/script/src/lib/moodle.js

@@ -15,26 +15,49 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : 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;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __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;
+exports.moodleApiCall = moodleApiCall;
+exports.moodleAjax = moodleAjax;
+exports.getEnrolledCoursesApi = getEnrolledCoursesApi;
+exports.getEnrolledCourses = getEnrolledCourses;
+exports.getCourseState = getCourseState;
+exports.getSupervideosInCourse = getSupervideosInCourse;
+exports.getForumsApi = getForumsApi;
+exports.getForumDiscussionsApi = getForumDiscussionsApi;
+exports.getDiscussionPostsApi = getDiscussionPostsApi;
+exports.getResourcesInCourse = getResourcesInCourse;
+exports.getCalendarEventsApi = getCalendarEventsApi;
+exports.getCourseGradesApi = getCourseGradesApi;
+exports.getVideoMetadata = getVideoMetadata;
+exports.downloadVideo = downloadVideo;
+exports.completeVideoApi = completeVideoApi;
+exports.completeVideo = completeVideo;
+exports.updateActivityCompletionStatusManually = updateActivityCompletionStatusManually;
+exports.getSiteInfoApi = getSiteInfoApi;
+exports.getIncompleteVideosApi = getIncompleteVideosApi;
+exports.getSupervideosInCourseApi = getSupervideosInCourseApi;
+exports.getQuizzesByCoursesApi = getQuizzesByCoursesApi;
+exports.getResourcesByCoursesApi = getResourcesByCoursesApi;
+exports.getMessagesApi = getMessagesApi;
 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);
-}
+const utils_js_1 = require("./utils.js");
 // ── Core Moodle AJAX Wrapper ───────────────────────────────────────────
 /**
  * Moodle WS API functions that are known to work via /webservice/rest/server.php
@@ -47,6 +70,12 @@ const WS_API_FUNCTIONS = new Set([
     "gradereport_user_get_grade_items",
     "core_calendar_get_calendar_events",
     "core_course_get_contents",
+    "core_course_get_course_module",
+    "core_completion_get_activities_completion_status",
+    "core_completion_update_activity_completion_status_manually",
+    "mod_supervideo_progress_save",
+    "mod_supervideo_progress_save_mobile",
+    "mod_supervideo_view_supervideo",
     "mod_quiz_get_quizzes_by_courses",
     "mod_resource_get_resources_by_courses",
     "core_message_get_messages",
@@ -91,7 +120,6 @@ async function moodleApiCall(session, methodname, args) {
     }
     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,
@@ -135,7 +163,6 @@ async function moodleAjax(page, session, methodname, args) {
         return result[0].data;
     }
 }
-exports.moodleAjax = moodleAjax;
 // ── Course Operations ─────────────────────────────────────────────────────
 /**
  * Fetch enrolled courses via pure API (no browser required).
@@ -162,7 +189,7 @@ async function getEnrolledCoursesApi(session, options = {}) {
     });
     return (data?.courses ?? []).map((c) => ({
         id: c.id,
-        fullname: c.fullname,
+        fullname: (0, utils_js_1.extractCourseName)(c.fullname),
         shortname: c.shortname,
         idnumber: c.idnumber,
         category: c.category?.name,
@@ -171,7 +198,6 @@ async function getEnrolledCoursesApi(session, options = {}) {
         enddate: c.enddate,
     }));
 }
-exports.getEnrolledCoursesApi = getEnrolledCoursesApi;
 /**
  * Fetch all enrolled courses via Moodle AJAX API.
  */
@@ -196,7 +222,7 @@ async function getEnrolledCourses(page, session, log, options = {}) {
     });
     const courses = (data?.courses ?? []).map((c) => ({
         id: c.id,
-        fullname: c.fullname,
+        fullname: (0, utils_js_1.extractCourseName)(c.fullname),
         shortname: c.shortname,
         idnumber: c.idnumber,
         category: c.category?.name,
@@ -207,7 +233,6 @@ async function getEnrolledCourses(page, session, log, options = {}) {
     log.debug(`Found ${courses.length} course${courses.length === 1 ? "" : "s"}.`);
     return courses;
 }
-exports.getEnrolledCourses = getEnrolledCourses;
 /**
  * Get course state (modules) via core_courseformat_get_state.
  */
@@ -217,7 +242,6 @@ async function getCourseState(page, session, courseId) {
     });
     return typeof data === "string" ? JSON.parse(data) : data;
 }
-exports.getCourseState = getCourseState;
 // ── Video Operations ──────────────────────────────────────────────────────
 /**
  * Get all SuperVideo modules in a course.
@@ -225,15 +249,17 @@ exports.getCourseState = getCourseState;
 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`);
+    // Filter: Only include videos with completion tracking enabled (have completionstate field)
+    // and are not yet completed (completionstate != 1 or isoverallcomplete != true)
+    const incomplete = allSupervideos.filter((cm) => {
+        // Has completionstate field = completion tracking is enabled for this video
+        const hasCompletionTracking = "completionstate" in cm;
+        // Is not yet completed
+        const isIncomplete = cm.completionstate !== 1 && cm.isoverallcomplete !== true;
+        return hasCompletionTracking && isIncomplete;
+    });
+    log.debug(`  SuperVideo: ${allSupervideos.length} total, ${incomplete.length} incomplete (with completion enabled)`);
     // Return only incomplete if requested, otherwise return all
     const videos = options.incompleteOnly ? incomplete : allSupervideos;
     return videos.map((cm) => ({
@@ -243,81 +269,7 @@ async function getSupervideosInCourse(page, session, courseId, log, options = {}
         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.
@@ -329,144 +281,52 @@ async function getForumsApi(session, courseIds) {
         cmid: f.cmid,
         name: f.name,
         courseid: f.course, // API returns 'course' not 'courseid'
+        timemodified: f.timemodified,
     }));
 }
-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.
+ * Get discussions in a forum via WS API (no browser required).
+ * Uses mod_forum_get_forum_discussions
  */
-async function getForumDiscussions(page, session, forumId) {
-    const data = await moodleAjax(page, session, "mod_forum_get_forum_discussions", {
-        forumid: forumId,
-    });
+async function getForumDiscussionsApi(session, forumId, options) {
+    const params = { forumid: forumId, sortorder: options?.sortorder ?? 2 };
+    if (options?.page !== undefined)
+        params.page = options.page;
+    if (options?.perpage !== undefined)
+        params.perpage = options.perpage;
+    if (options?.groupid !== undefined)
+        params.groupid = options.groupid;
+    const data = await moodleApiCall(session, "mod_forum_get_forum_discussions", params);
     return (data?.discussions ?? []).map((d) => ({
-        id: d.id,
+        id: d.discussion,
         forumId: d.forum,
         name: d.name,
         firstPostId: d.firstpost,
         userId: d.userid,
+        userFullName: d.userfullname || "",
         groupId: d.groupid,
         timedue: d.timedue,
         timeModified: d.timemodified,
+        timeStart: d.timestart,
+        timeEnd: d.timeend,
         userModified: d.usermodified,
-        postCount: d.numdiscussion,
-        unread: d.unread,
+        userModifiedFullName: d.usermodifiedfullname,
+        postCount: d.numreplies,
+        unread: (d.numunread ?? 0) > 0,
+        subject: (0, utils_js_1.stripHtmlTags)(d.subject ?? ""),
+        message: d.message,
+        pinned: d.pinned,
+        locked: d.locked,
+        starred: d.starred,
     }));
 }
-exports.getForumDiscussions = getForumDiscussions;
 /**
- * Get posts in a discussion via AJAX.
+ * Get posts in a discussion via WS API (no browser required).
+ * Uses mod_forum_get_forum_discussion_posts
  */
-async function getDiscussionPosts(page, session, discussionId) {
+async function getDiscussionPostsApi(session, discussionId) {
     try {
-        const data = await moodleAjax(page, session, "mod_forum_get_forum_discussion_posts", {
+        const data = await moodleApiCall(session, "mod_forum_get_discussion_posts", {
             discussionid: discussionId,
         });
         if (!data?.posts || data.posts.length === 0) {
@@ -474,13 +334,13 @@ async function getDiscussionPosts(page, session, discussionId) {
         }
         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,
+            subject: (0, utils_js_1.stripHtmlTags)(p.subject || ""),
+            author: p.author?.fullname ?? "Unknown",
+            authorId: p.author?.id ?? p.userid,
+            created: p.timecreated,
+            modified: p.timemodified,
+            message: (0, utils_js_1.stripHtmlTags)(p.message || ""),
+            discussionId: p.discussionid,
             unread: p.unread ?? false,
         }));
     }
@@ -490,7 +350,6 @@ async function getDiscussionPosts(page, session, discussionId) {
         return [];
     }
 }
-exports.getDiscussionPosts = getDiscussionPosts;
 // ── Resource/Material Operations ──────────────────────────────────────────
 /**
  * Get all resource modules in a course.
@@ -511,79 +370,13 @@ async function getResourcesInCourse(page, session, courseId, log) {
         modified: 0,
     }));
 }
-exports.getResourcesInCourse = getResourcesInCourse;
-// ── Grade Operations ──────────────────────────────────────────────────────
+// ── Calendar 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).
+ * Get calendar events 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", {
+async function getCalendarEventsApi(session, options = {}) {
+    const data = await moodleApiCall(session, "core_calendar_get_calendar_events", {
         ...options,
     });
     return (data?.events ?? []).map((e) => ({
@@ -599,48 +392,50 @@ async function getCalendarEvents(page, session, options = {}) {
         modulename: e.modulename,
         instance: e.instance,
         eventtype: e.eventtype,
-        timestart: e.timestart * 1000,
+        timestart: e.timestart * 1000, // Convert to milliseconds
         timeduration: e.timeduration ? e.timeduration * 1000 : undefined,
         timedue: e.timedue ? e.timedue * 1000 : undefined,
         visible: e.visible,
         location: e.location,
     }));
 }
-exports.getCalendarEvents = getCalendarEvents;
+// ── Grade Operations ──────────────────────────────────────────────────────
 /**
- * Get calendar events via pure WS API (no browser required).
+ * Get course grades for the current user 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,
-    }));
+async function getCourseGradesApi(session, courseId) {
+    const data = await moodleApiCall(session, "gradereport_user_get_grade_items", { courseid: courseId });
+    // The API returns grade items for the course
+    const gradeItems = (data?.usergrades ?? []);
+    // Return a single CourseGrade object with items array
+    return {
+        courseId,
+        courseName: gradeItems[0]?.coursefullname ?? "",
+        grade: gradeItems[0]?.grade,
+        gradeFormatted: gradeItems[0]?.gradeformatted,
+        rank: gradeItems[0]?.rank,
+        totalUsers: gradeItems[0]?.totalusers,
+        items: gradeItems.map((g) => ({
+            id: g.id,
+            name: g.itemname || g.itemtype,
+            grade: g.grade,
+            gradeFormatted: g.gradeformatted,
+            range: g.grade ? `${g.grademin ?? 0}-${g.grademax ?? 100}` : undefined,
+        })),
+    };
 }
-exports.getCalendarEventsApi = getCalendarEventsApi;
 // ── Video Metadata (from original course.ts) ───────────────────────────────
 /**
  * Visit a SuperVideo activity page and extract view_id + duration.
  */
+/**
+ * Optimized video metadata extraction - minimal page load overhead.
+ * Blocks images, fonts, stylesheets to speed up viewId extraction.
+ */
 async function getVideoMetadata(page, activityUrl, log) {
+    // Block unnecessary resources for faster loading
+    await page.route("**/*.{png,jpg,jpeg,gif,webp,svg,ico,woff,woff2,ttf,css}", (route) => route.abort());
     await page.goto(activityUrl, { waitUntil: "domcontentloaded", timeout: 20000 });
     const name = await page.title();
     const pageSource = await page.content();
@@ -754,7 +549,6 @@ async function getVideoMetadata(page, activityUrl, log) {
         youtubeIds,
     };
 }
-exports.getVideoMetadata = getVideoMetadata;
 // ── Video Download ─────────────────────────────────────────────────────────────
 /**
  * Download a video from SuperVideo activity.
@@ -788,7 +582,7 @@ async function downloadVideo(page, metadata, outputPath, log) {
             // Get array buffer and convert to Uint8Array
             const arrayBuffer = await response.arrayBuffer();
             const uint8Array = new Uint8Array(arrayBuffer);
-            // Write to file using Deno
+            // Write to file
             await dntShim.Deno.writeFile(outputPath, uint8Array);
             return { success: true, path: outputPath, type: "direct" };
         }
@@ -821,24 +615,57 @@ async function downloadVideo(page, metadata, outputPath, log) {
         error: "未找到影片來源",
     };
 }
-exports.downloadVideo = downloadVideo;
 // ── Progress Completion (from original progress.ts) ───────────────────────
 /**
- * Complete a video by forging progress AJAX call.
+ * Build duration map array for video progress tracking.
+ * Cached and scaled per duration to avoid repeated allocations.
  */
-async function completeVideo(page, session, video, log) {
-    const { viewId, duration } = video;
-    // Build duration map array (required by Moodle)
+function buildDurationMap(duration) {
+    // Build the map array (0% to 100% in 1% increments)
     const map = Array.from({ length: 100 }, (_, i) => ({
         time: Math.round((duration * i) / 100),
         percent: i,
     }));
+    return JSON.stringify(map);
+}
+/**
+ * Complete a video using WS API (mobile service only).
+ * Uses mod_supervideo_progress_save_mobile which is accessible via moodle_mobile_app service token.
+ */
+async function completeVideoApi(session, video) {
+    const { viewId, duration } = video;
+    try {
+        const result = await moodleApiCall(session, "mod_supervideo_progress_save_mobile", // Use mobile service specific function
+        {
+            view_id: viewId,
+            currenttime: duration,
+            duration: duration,
+            percent: 100,
+            mapa: buildDurationMap(duration),
+        });
+        // Debug: log the full result
+        console.debug(`completeVideoApi result:`, JSON.stringify(result));
+        const success = result?.[0]?.success === true || result?.success === true;
+        return { success, error: success ? undefined : `API returned success=false, result=${JSON.stringify(result)}`, result };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.debug(`completeVideoApi error: ${msg}`);
+        return { success: false, error: msg };
+    }
+}
+/**
+ * Complete a video by forging progress AJAX call (legacy, requires browser).
+ * Note: This uses sesskey-based AJAX which works for mod_supervideo_progress_save.
+ */
+async function completeVideo(page, session, video, log) {
+    const { viewId, duration } = video;
     const payload = {
         view_id: viewId,
         currenttime: duration,
         duration: duration,
         percent: 100,
-        mapa: JSON.stringify(map),
+        mapa: buildDurationMap(duration),
     };
     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 }];
@@ -862,21 +689,95 @@ async function completeVideo(page, session, video, log) {
         return false;
     }
 }
-exports.completeVideo = completeVideo;
+/**
+ * Update activity completion status manually via WS API.
+ * Used for marking resources as complete/incomplete.
+ */
+async function updateActivityCompletionStatusManually(session, cmid, completed) {
+    try {
+        const result = await moodleApiCall(session, "core_completion_update_activity_completion_status_manually", {
+            cmid: cmid,
+            completed: completed ? 1 : 0,
+        });
+        return result.status === true;
+    }
+    catch (e) {
+        console.debug(`Failed to update completion status for cmid ${cmid}: ${e}`);
+        return false;
+    }
+}
 // ── Site Info (Get User ID) ───────────────────────────────────────────────────
+/** Cache for site info to avoid redundant API calls */
+let siteInfoCache = null;
+let siteInfoCacheTime = 0;
+const SITE_INFO_CACHE_TTL = 5 * 60 * 1000; // 5 minutes
 /**
  * Get site info including current user ID via pure WS API.
+ * Results are cached for 5 minutes to avoid redundant calls.
  */
 async function getSiteInfoApi(session) {
+    const now = Date.now();
+    if (siteInfoCache && (now - siteInfoCacheTime) < SITE_INFO_CACHE_TTL) {
+        return siteInfoCache;
+    }
     const data = await moodleApiCall(session, "core_webservice_get_site_info", {});
-    return {
+    siteInfoCache = {
         userid: data.userid,
         username: data.username,
         fullname: data.fullname,
         sitename: data.sitename,
     };
+    siteInfoCacheTime = now;
+    return siteInfoCache;
+}
+/**
+ * Get incomplete supervideos with completion tracking enabled via WS API.
+ * Uses core_completion_get_activities_completion_status to get only videos that:
+ * 1. Have completion tracking enabled (hascompletion: true)
+ * 2. Are not yet completed (isoverallcomplete: false or state !== 1)
+ */
+async function getIncompleteVideosApi(session, courseId) {
+    // Get user ID
+    const siteInfo = await getSiteInfoApi(session);
+    // Get completion status for all activities
+    const completionData = await moodleApiCall(session, "core_completion_get_activities_completion_status", { courseid: courseId, userid: siteInfo.userid });
+    if (!completionData?.statuses) {
+        return [];
+    }
+    // Get course contents to get URLs
+    const contentsData = await moodleApiCall(session, "core_course_get_contents", { courseid: courseId });
+    // Create a map of cmid to URL
+    const urlMap = new Map();
+    for (const section of contentsData || []) {
+        if (!section.modules)
+            continue;
+        for (const module of section.modules) {
+            if (module.id) {
+                urlMap.set(module.id, module.url);
+            }
+        }
+    }
+    // Filter for incomplete supervideos with completion tracking enabled
+    const incompleteVideos = [];
+    for (const status of completionData.statuses) {
+        // Only supervideo modules
+        if (status.modname !== "supervideo")
+            continue;
+        // Must have completion enabled
+        if (!status.hascompletion)
+            continue;
+        // Must be incomplete
+        if (status.isoverallcomplete === true || status.state === 1)
+            continue;
+        const url = urlMap.get(status.cmid) || "";
+        incompleteVideos.push({
+            cmid: status.cmid,
+            name: status.name,
+            url,
+        });
+    }
+    return incompleteVideos;
 }
-exports.getSiteInfoApi = getSiteInfoApi;
 // ── Videos via WS API ─────────────────────────────────────────────────────────
 /**
  * Get course contents and filter for SuperVideo modules via pure WS API.
@@ -896,14 +797,41 @@ async function getSupervideosInCourseApi(session, courseId) {
                     cmid: module.id.toString(),
                     name: module.name,
                     url: module.url,
-                    isComplete: false, // API doesn't provide completion status
+                    instance: module.instance, // supervideo instance id (not cmid!)
+                    isComplete: false, // Will be updated from completion API
                 });
             }
         }
     }
+    // Get completion status using core_completion_get_activities_completion_status
+    try {
+        // First get user ID
+        const siteInfo = await getSiteInfoApi(session);
+        const completionData = await moodleApiCall(session, "core_completion_get_activities_completion_status", { courseid: courseId, userid: siteInfo.userid });
+        // Create a map of cmid to completion status
+        const completionMap = new Map();
+        if (completionData?.statuses) {
+            for (const status of completionData.statuses) {
+                // Only include modules that have completion enabled
+                if (status.hascompletion) {
+                    completionMap.set(status.cmid, status.isoverallcomplete === true);
+                }
+            }
+        }
+        // Update isComplete based on completion data
+        for (const video of videos) {
+            const cmid = parseInt(video.cmid, 10);
+            if (completionMap.has(cmid)) {
+                video.isComplete = completionMap.get(cmid) ?? false;
+            }
+        }
+    }
+    catch (e) {
+        // If completion API fails, continue with isComplete=false
+        console.debug(`Failed to get completion status: ${e}`);
+    }
     return videos;
 }
-exports.getSupervideosInCourseApi = getSupervideosInCourseApi;
 /**
  * Get quizzes in courses via pure WS API.
  */
@@ -915,13 +843,12 @@ async function getQuizzesByCoursesApi(session, courseIds) {
         cmid: q.coursemodule.toString(),
         name: q.name,
         url: q.viewurl,
-        isComplete: false,
+        isComplete: false, // API doesn't provide completion status
         timeOpen: q.timeopen,
         timeClose: q.timeclose,
         courseId: q.course,
     }));
 }
-exports.getQuizzesByCoursesApi = getQuizzesByCoursesApi;
 // ── Materials via WS API ──────────────────────────────────────────────────────
 /**
  * Get resources in courses via pure WS API.
@@ -938,14 +865,13 @@ async function getResourcesByCoursesApi(session, courseIds) {
             name: r.name,
             url: firstFile?.fileurl ?? "",
             courseId: r.course,
-            modType: "resource",
+            modType: "resource", // This API only returns resources
             mimetype: firstFile?.mimetype,
             filesize: firstFile?.filesize,
             modified: r.timemodified,
         };
     });
 }
-exports.getResourcesByCoursesApi = getResourcesByCoursesApi;
 /**
  * Get messages for the current user via pure WS API.
  */
@@ -963,4 +889,3 @@ async function getMessagesApi(session, userIdTo, options = {}) {
         fullmessagehtml: m.fullmessagehtml,
     }));
 }
-exports.getMessagesApi = getMessagesApi;