@mo7yw4ng/openape 1.0.0

package/script/src/commands/courses.js

@@ -0,0 +1,484 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCoursesCommand = void 0;
+const utils_js_1 = require("../lib/utils.js");
+const moodle_js_1 = require("../lib/moodle.js");
+const logger_js_1 = require("../lib/logger.js");
+const auth_js_1 = require("../lib/auth.js");
+const session_js_1 = require("../lib/session.js");
+const token_js_1 = require("../lib/token.js");
+const index_js_1 = require("../index.js");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+function registerCoursesCommand(program) {
+    const coursesCmd = program.command("courses");
+    coursesCmd.description("Course operations");
+    // Helper to get output format from global or local options
+    function getOutputFormat(command) {
+        const opts = command.optsWithGlobals();
+        return opts.output || "json";
+    }
+    // Pure API context - no browser required (fast!)
+    async function createApiContext(options, command) {
+        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
+        const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
+        const silent = outputFormat === "json" && !opts.verbose;
+        const log = (0, logger_js_1.createLogger)(opts.verbose, silent);
+        const baseDir = (0, utils_js_1.getBaseDir)();
+        const sessionPath = path_1.default.resolve(baseDir, ".auth", "storage-state.json");
+        // Check if session exists
+        if (!fs_1.default.existsSync(sessionPath)) {
+            return null;
+        }
+        // Try to load WS token
+        const wsToken = (0, token_js_1.loadWsToken)(sessionPath);
+        if (!wsToken) {
+            return null;
+        }
+        return {
+            log,
+            session: {
+                wsToken,
+                moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+            },
+        };
+    }
+    // Helper function to create session context (browser mode - fallback)
+    async function createSessionContext(options, command) {
+        // Get global options if command is provided (for --verbose, --silent flags)
+        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
+        // Auto-enable silent mode for JSON output (unless --verbose is also set)
+        const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
+        const silent = outputFormat === "json" && !opts.verbose;
+        const log = (0, logger_js_1.createLogger)(opts.verbose, silent);
+        // Determine session path
+        const baseDir = (0, utils_js_1.getBaseDir)();
+        const sessionPath = path_1.default.resolve(baseDir, ".auth", "storage-state.json");
+        // Check if session exists
+        if (!fs_1.default.existsSync(sessionPath)) {
+            log.error("未找到登入 session。請先執行 'openape auth login' 進行登入。");
+            log.info(`Session 預期位置: ${sessionPath}`);
+            return null;
+        }
+        // Create minimal config
+        const config = {
+            username: "",
+            password: "",
+            courseUrl: "",
+            moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+            headless: !options.headed,
+            slowMo: 0,
+            authStatePath: sessionPath,
+            ollamaBaseUrl: "",
+        };
+        log.info("啟動瀏覽器...");
+        const { browser, context, page } = await (0, auth_js_1.launchAuthenticated)(config, log);
+        try {
+            const session = await (0, session_js_1.extractSessionInfo)(page, config, log);
+            return { log, page, session, browser, context };
+        }
+        catch (err) {
+            await context.close();
+            await browser.close();
+            throw err;
+        }
+    }
+    coursesCmd
+        .command("list")
+        .description("List enrolled courses")
+        .option("--incomplete-only", "Show only incomplete courses")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .option("--level <type>", "Course level: in_progress (default) | past | future | all", "in_progress")
+        .action(async (options, command) => {
+        const output = getOutputFormat(command);
+        // Map level to classification
+        const classification = options.level === "all" ? undefined :
+            options.level === "past" ? "past" :
+                options.level === "future" ? "future" : "inprogress";
+        // Try API mode first (no browser, fast!)
+        const apiContext = await createApiContext(options, command);
+        if (apiContext) {
+            try {
+                const courses = await (0, moodle_js_1.getEnrolledCoursesApi)(apiContext.session, {
+                    classification,
+                });
+                let filteredCourses = courses;
+                if (options.incompleteOnly) {
+                    filteredCourses = courses.filter(c => (c.progress ?? 0) < 100);
+                }
+                (0, index_js_1.formatAndOutput)(filteredCourses, output, apiContext.log);
+                return;
+            }
+            catch (e) {
+                // API failed, fall through to browser mode
+                const msg = e instanceof Error ? e.message : String(e);
+                console.error(`// API mode failed: ${msg}, trying browser mode...`);
+            }
+        }
+        // Fallback to browser mode
+        const context = await createSessionContext(options, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, session, browser, context: browserContext } = context;
+        try {
+            const courses = await (0, moodle_js_1.getEnrolledCourses)(page, session, log, {
+                classification,
+            });
+            let filteredCourses = courses;
+            if (options.incompleteOnly) {
+                filteredCourses = courses.filter(c => (c.progress ?? 0) < 100);
+            }
+            (0, index_js_1.formatAndOutput)(filteredCourses, output, log);
+        }
+        finally {
+            await (0, auth_js_1.closeBrowserSafely)(browser, browserContext);
+        }
+    });
+    coursesCmd
+        .command("info")
+        .description("Show detailed course information")
+        .argument("<course-id>", "Course ID")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (courseId, options, command) => {
+        const output = getOutputFormat(command);
+        // Try pure API mode (no browser, fast!)
+        const apiContext = await createApiContext(options, command);
+        if (apiContext) {
+            try {
+                const courses = await (0, moodle_js_1.getEnrolledCoursesApi)(apiContext.session);
+                const course = courses.find(c => c.id === parseInt(courseId, 10));
+                if (!course) {
+                    apiContext.log.error(`Course not found: ${courseId}`);
+                    process.exitCode = 1;
+                    return;
+                }
+                (0, index_js_1.formatAndOutput)(course, output, apiContext.log);
+                return;
+            }
+            catch (e) {
+                // API failed, fall through to browser mode
+                const msg = e instanceof Error ? e.message : String(e);
+                console.error(`// API mode failed: ${msg}, trying browser mode...`);
+            }
+        }
+        // Fallback to browser mode
+        const context = await createSessionContext(options, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, session, browser, context: browserContext } = context;
+        try {
+            const courses = await (0, moodle_js_1.getEnrolledCourses)(page, session, log);
+            const course = courses.find(c => c.id === parseInt(courseId, 10));
+            if (!course) {
+                log.error(`Course not found: ${courseId}`);
+                process.exitCode = 1;
+                return;
+            }
+            (0, index_js_1.formatAndOutput)(course, output, log);
+        }
+        finally {
+            await (0, auth_js_1.closeBrowserSafely)(browser, browserContext);
+        }
+    });
+    coursesCmd
+        .command("progress")
+        .description("Show course progress")
+        .argument("<course-id>", "Course ID")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (courseId, options, command) => {
+        const output = getOutputFormat(command);
+        // Try pure API mode (no browser, fast!)
+        const apiContext = await createApiContext(options, command);
+        if (apiContext) {
+            try {
+                const courses = await (0, moodle_js_1.getEnrolledCoursesApi)(apiContext.session);
+                const course = courses.find(c => c.id === parseInt(courseId, 10));
+                if (!course) {
+                    apiContext.log.error(`Course not found: ${courseId}`);
+                    process.exitCode = 1;
+                    return;
+                }
+                const progressData = {
+                    courseId: course.id,
+                    courseName: course.fullname,
+                    progress: course.progress ?? 0,
+                    startDate: course.startdate ? new Date(course.startdate * 1000).toISOString() : null,
+                    endDate: course.enddate ? new Date(course.enddate * 1000).toISOString() : null,
+                };
+                (0, index_js_1.formatAndOutput)(progressData, output, apiContext.log);
+                return;
+            }
+            catch (e) {
+                // API failed, fall through to browser mode
+                const msg = e instanceof Error ? e.message : String(e);
+                console.error(`// API mode failed: ${msg}, trying browser mode...`);
+            }
+        }
+        // Fallback to browser mode
+        const context = await createSessionContext(options, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, session, browser, context: browserContext } = context;
+        try {
+            const courses = await (0, moodle_js_1.getEnrolledCourses)(page, session, log);
+            const course = courses.find(c => c.id === parseInt(courseId, 10));
+            if (!course) {
+                log.error(`Course not found: ${courseId}`);
+                process.exitCode = 1;
+                return;
+            }
+            const progressData = {
+                courseId: course.id,
+                courseName: course.fullname,
+                progress: course.progress ?? 0,
+                startDate: course.startdate ? new Date(course.startdate * 1000).toISOString() : null,
+                endDate: course.enddate ? new Date(course.enddate * 1000).toISOString() : null,
+            };
+            (0, index_js_1.formatAndOutput)(progressData, output, log);
+        }
+        finally {
+            await (0, auth_js_1.closeBrowserSafely)(browser, browserContext);
+        }
+    });
+    // Helper function to fetch syllabus from CMAP using GWT-RPC API
+    async function fetchSyllabus(shortname) {
+        try {
+            const parts = shortname.split("_");
+            if (parts.length < 2) {
+                return { error: "Invalid course shortname format" };
+            }
+            const [yearTerm, opCode] = parts;
+            // Build GWT-RPC request body
+            // Format: 7|0|8|<base_url>|<permutation>|<service>|<method>|<param_types>|<params>...|1|2|3|4|3|5|5|5|6|7|8|
+            const gwtBody = `7|0|8|https://cmap.cycu.edu.tw:8443/Syllabus/syllabus/|339796D6E7B561A6465F5E9B5F4943FA|com.sanfong.syllabus.shared.SyllabusClientService|findClassTargetByYearAndOpCode|java.lang.String/2004016611|${yearTerm}|${opCode}|zh_TW|1|2|3|4|3|5|5|5|6|7|8|`;
+            const response = await fetch("https://cmap.cycu.edu.tw:8443/Syllabus/syllabus/syllabusClientService", {
+                method: "POST",
+                headers: {
+                    "X-GWT-Permutation": "339796D6E7B561A6465F5E9B5F4943FA",
+                    "Accept": "text/x-gwt-rpc, */*; q=0.01",
+                    "Content-Type": "text/x-gwt-rpc; charset=UTF-8",
+                },
+                body: gwtBody,
+            });
+            if (!response.ok) {
+                return { error: `HTTP ${response.status}`, url: "https://cmap.cycu.edu.tw:8443/Syllabus/syllabus/syllabusClientService" };
+            }
+            const rawText = await response.text();
+            // GWT-RPC response format: //OK[...data...]
+            if (!rawText.startsWith("//OK")) {
+                return { error: "Invalid GWT-RPC response", rawResponse: rawText.slice(0, 200) };
+            }
+            // Extract the JSON array part from the GWT response
+            // Response format: //OK[data1,data2,...]
+            const content = rawText.slice(4); // Remove "//OK"
+            // Parse the GWT string table - GWT uses a special format where strings are escaped
+            // Format: ["string1","string2",...] or [123,"string2",...]
+            const stringTable = [];
+            // Simple parser for GWT string table
+            let current = "";
+            let inString = false;
+            let escaped = false;
+            for (let i = 0; i < content.length; i++) {
+                const char = content[i];
+                if (escaped) {
+                    // Handle escape sequences
+                    switch (char) {
+                        case 'n':
+                            current += '\n';
+                            break;
+                        case 'r':
+                            current += '\r';
+                            break;
+                        case 't':
+                            current += '\t';
+                            break;
+                        case '"':
+                            current += '"';
+                            break;
+                        case '\\':
+                            current += '\\';
+                            break;
+                        case '0':
+                            current += '\0';
+                            break;
+                        default:
+                            // Unknown escape, just append the char
+                            current += char;
+                    }
+                    escaped = false;
+                    continue;
+                }
+                if (char === "\\") {
+                    escaped = true;
+                    continue;
+                }
+                if (char === '"') {
+                    inString = !inString;
+                    if (!inString && current.length > 0) {
+                        stringTable.push(current);
+                        current = "";
+                    }
+                    continue;
+                }
+                if (inString) {
+                    current += char;
+                }
+            }
+            // Parse schedule from string table
+            // Strategy: Find week numbers (1-18), extract title (previous field) and date
+            const schedule = [];
+            const datePattern = /^\d{4}-\d{2}-\d{2}$/;
+            // Track processed indices to avoid duplicates
+            const processedIndices = new Set();
+            for (let i = 0; i < stringTable.length; i++) {
+                const s = stringTable[i];
+                // Look for week numbers (1-18)
+                if (/^[1-9]$|^1[0-8]$/.test(s) && !processedIndices.has(i)) {
+                    const week = s;
+                    let date = "";
+                    let title = "";
+                    // Previous field is the title
+                    if (i - 1 >= 0 && !processedIndices.has(i - 1)) {
+                        title = stringTable[i - 1];
+                    }
+                    // For week 1 & 2, find date before the week number
+                    // For week 18, also look before (last week has no "next week")
+                    // For other weeks (3-17), next field is next week's date
+                    if (week === "1" || week === "2" || week === "18") {
+                        // Look backwards for date pattern (search further back for week 18)
+                        const maxLookback = week === "18" ? 15 : 6;
+                        for (let j = i - 1; j >= Math.max(0, i - maxLookback); j--) {
+                            if (datePattern.test(stringTable[j]) && !processedIndices.has(j)) {
+                                date = stringTable[j];
+                                processedIndices.add(j);
+                                break;
+                            }
+                        }
+                    }
+                    else {
+                        // Week 3-17: look for next week number, then get date before it
+                        for (let j = i + 1; j < Math.min(i + 10, stringTable.length); j++) {
+                            if (/^[1-9]$|^1[0-8]$/.test(stringTable[j]) && !processedIndices.has(j)) {
+                                // Found next week, look before it for date
+                                for (let k = j - 1; k >= Math.max(0, j - 6); k--) {
+                                    if (datePattern.test(stringTable[k]) && !processedIndices.has(k)) {
+                                        date = stringTable[k];
+                                        processedIndices.add(k);
+                                        break;
+                                    }
+                                }
+                                break;
+                            }
+                        }
+                    }
+                    // Clean up title
+                    title = title.trim()
+                        .replace(/[\r\n]+/g, ' ')
+                        .replace(/,+$/, '')
+                        .trim()
+                        .slice(0, 200);
+                    // Only add if we have title (date is optional, will be inferred if missing)
+                    if (title.length > 1) {
+                        // If no date found, try to infer from the last added date
+                        if (date.length === 0 && schedule.length > 0) {
+                            const lastEntry = schedule[schedule.length - 1];
+                            const lastDate = new Date(lastEntry.date);
+                            const nextDate = new Date(lastDate.getTime() + 7 * 24 * 60 * 60 * 1000);
+                            const year = nextDate.getFullYear();
+                            const month = String(nextDate.getMonth() + 1).padStart(2, "0");
+                            const day = String(nextDate.getDate()).padStart(2, "0");
+                            date = `${year}-${month}-${day}`;
+                        }
+                        schedule.push({
+                            week,
+                            date,
+                            title,
+                        });
+                    }
+                    processedIndices.add(i);
+                }
+            }
+            // Sort by date to maintain order
+            schedule.sort((a, b) => a.date.localeCompare(b.date));
+            // Extract course info from string table
+            const result = {
+                yearTerm,
+                opCode,
+                url: `https://cmap.cycu.edu.tw:8443/Syllabus/CoursePreview.html?yearTerm=${yearTerm}&opCode=${opCode}&locale=zh_TW`,
+                schedule,
+            };
+            // Try to find instructor (look for common patterns)
+            for (let i = 0; i < stringTable.length; i++) {
+                const s = stringTable[i];
+                if (s.includes("教授") || s.includes("老師") || s.includes("教師") || s.includes("Instructor")) {
+                    result.instructor = s;
+                    break;
+                }
+            }
+            return result;
+        }
+        catch (e) {
+            return { error: e instanceof Error ? e.message : String(e) };
+        }
+    }
+    coursesCmd
+        .command("syllabus")
+        .description("Show course syllabus (from CMAP)")
+        .argument("<course-id>", "Course ID")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (courseId, options, command) => {
+        const output = getOutputFormat(command);
+        // First get course info to get shortname
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            console.error("// Unable to get course info without session");
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const courses = await (0, moodle_js_1.getEnrolledCoursesApi)(apiContext.session);
+            const course = courses.find(c => c.id === parseInt(courseId, 10));
+            if (!course) {
+                apiContext.log.error(`Course not found: ${courseId}`);
+                process.exitCode = 1;
+                return;
+            }
+            // Fetch syllabus from CMAP
+            const syllabus = await fetchSyllabus(course.shortname);
+            if (!syllabus) {
+                apiContext.log.warn(`Syllabus not found for course: ${course.shortname}`);
+                // Return course info at least
+                (0, index_js_1.formatAndOutput)({
+                    courseId: course.id,
+                    shortname: course.shortname,
+                    fullname: course.fullname,
+                    note: "Syllabus not available from CMAP",
+                }, output, apiContext.log);
+                return;
+            }
+            // Combine course info with syllabus
+            const result = {
+                courseId: course.id,
+                shortname: course.shortname,
+                fullname: course.fullname,
+                ...syllabus,
+            };
+            (0, index_js_1.formatAndOutput)(result, output, apiContext.log);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            apiContext.log.error(`Error fetching syllabus: ${msg}`);
+            process.exitCode = 1;
+        }
+    });
+}
+exports.registerCoursesCommand = registerCoursesCommand;

package/script/src/commands/forums.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerForumsCommand(program: Command): void;