@mo7yw4ng/openape 1.0.0

package/script/src/commands/announcements.js

@@ -0,0 +1,288 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAnnouncementsCommand = 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 auth_js_2 = require("../lib/auth.js");
+const token_js_1 = require("../lib/token.js");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+function registerAnnouncementsCommand(program) {
+    const announcementsCmd = program.command("announcements");
+    announcementsCmd.description("Announcement 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
+    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;
+        }
+    }
+    announcementsCmd
+        .command("list-all")
+        .description("List all announcements across all courses")
+        .option("--level <type>", "Course level: in_progress (default) | all", "in_progress")
+        .option("--unread-only", "Show only unread announcements")
+        .option("--limit <n>", "Maximum number of announcements to show", "20")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (options, command) => {
+        const limit = parseInt(options.limit, 10);
+        // Try pure API mode (no browser, fast!)
+        const apiContext = await createApiContext(options, command);
+        if (apiContext) {
+            try {
+                // Get site info to retrieve userid
+                const siteInfo = await (0, moodle_js_1.getSiteInfoApi)(apiContext.session);
+                // Get messages for the current user
+                const messages = await (0, moodle_js_1.getMessagesApi)(apiContext.session, siteInfo.userid, {
+                    limitnum: limit,
+                });
+                // Convert messages to announcement format
+                const allAnnouncements = messages.map(m => ({
+                    course_id: 0,
+                    course_name: "Notifications",
+                    id: m.id,
+                    subject: m.subject,
+                    author: `User ${m.useridfrom}`,
+                    authorId: m.useridfrom,
+                    createdAt: m.timecreated,
+                    modifiedAt: m.timecreated,
+                    unread: false,
+                    forumId: 0,
+                }));
+                // Sort by created date (newest first)
+                allAnnouncements.sort((a, b) => b.createdAt - a.createdAt);
+                // Apply limit
+                let filteredAnnouncements = allAnnouncements.slice(0, limit);
+                const output = {
+                    status: "success",
+                    timestamp: new Date().toISOString(),
+                    level: options.level,
+                    announcements: filteredAnnouncements.map(a => ({
+                        course_id: a.course_id,
+                        course_name: a.course_name,
+                        id: a.id,
+                        subject: a.subject,
+                        author: a.author,
+                        author_id: a.authorId,
+                        created_at: new Date(a.createdAt * 1000).toISOString(),
+                        modified_at: new Date(a.modifiedAt * 1000).toISOString(),
+                        unread: a.unread,
+                    })),
+                    summary: {
+                        total_announcements: allAnnouncements.length,
+                        shown: filteredAnnouncements.length,
+                    },
+                };
+                console.log(JSON.stringify(output));
+                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 classification = options.level === "all" ? undefined : "inprogress";
+            const courses = await (0, moodle_js_1.getEnrolledCourses)(page, session, log, { classification });
+            const allAnnouncements = [];
+            for (const course of courses) {
+                const forums = await (0, moodle_js_1.getForumsInCourse)(page, session, course.id, log);
+                // Find news/announcement forums (usually named "news" or "Announcements")
+                const announcementForums = forums.filter(f => f.forumType === "news" ||
+                    f.name.toLowerCase().includes("news") ||
+                    f.name.toLowerCase().includes("announcement") ||
+                    f.name.toLowerCase().includes("公告"));
+                for (const forum of announcementForums) {
+                    try {
+                        const discussions = await (0, moodle_js_1.getForumDiscussions)(page, session, parseInt(forum.cmid, 10));
+                        for (const discussion of discussions) {
+                            // Get the first post to get author info
+                            let author = "Unknown";
+                            let authorId = 0;
+                            let createdAt = discussion.timeModified;
+                            try {
+                                const posts = await (0, moodle_js_1.getDiscussionPosts)(page, session, discussion.id);
+                                if (posts.length > 0) {
+                                    const firstPost = posts[0];
+                                    author = firstPost.author;
+                                    authorId = firstPost.authorId || 0;
+                                    createdAt = firstPost.created;
+                                }
+                            }
+                            catch {
+                                // Ignore errors fetching posts
+                            }
+                            allAnnouncements.push({
+                                course_id: course.id,
+                                course_name: course.fullname,
+                                id: discussion.id,
+                                subject: discussion.name,
+                                author,
+                                authorId,
+                                createdAt,
+                                modifiedAt: discussion.timeModified,
+                                unread: discussion.unread,
+                                forumId: parseInt(forum.cmid, 10),
+                            });
+                        }
+                    }
+                    catch (err) {
+                        log.debug(`Failed to fetch announcements for ${course.fullname}: ${err}`);
+                    }
+                }
+            }
+            // Sort by created date (newest first)
+            allAnnouncements.sort((a, b) => b.createdAt - a.createdAt);
+            // Apply limit
+            let filteredAnnouncements = allAnnouncements.slice(0, limit);
+            // Filter unread only if requested
+            if (options.unreadOnly) {
+                filteredAnnouncements = filteredAnnouncements.filter(a => a.unread);
+            }
+            const output = {
+                status: "success",
+                timestamp: new Date().toISOString(),
+                announcements: filteredAnnouncements.map(a => ({
+                    course_id: a.course_id,
+                    course_name: a.course_name,
+                    id: a.id,
+                    subject: a.subject,
+                    author: a.author,
+                    author_id: a.authorId,
+                    created_at: new Date(a.createdAt * 1000).toISOString(),
+                    modified_at: new Date(a.modifiedAt * 1000).toISOString(),
+                    unread: a.unread,
+                })),
+                summary: {
+                    total_announcements: allAnnouncements.length,
+                    unread: allAnnouncements.filter(a => a.unread).length,
+                    shown: filteredAnnouncements.length,
+                },
+            };
+            console.log(JSON.stringify(output));
+        }
+        catch (err) {
+            log.error(`Error: ${err}`);
+        }
+        finally {
+            await (0, auth_js_2.closeBrowserSafely)(browser, browserContext);
+        }
+    });
+    announcementsCmd
+        .command("read")
+        .description("Read a specific announcement (shows full content)")
+        .argument("<announcement-id>", "Discussion ID of the announcement")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (announcementId, options, command) => {
+        const context = await createSessionContext(options, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, session, browser, context: browserContext } = context;
+        try {
+            const posts = await (0, moodle_js_1.getDiscussionPosts)(page, session, parseInt(announcementId, 10));
+            if (posts.length === 0) {
+                log.error(`Announcement not found: ${announcementId}`);
+                process.exitCode = 1;
+                return;
+            }
+            const firstPost = posts[0];
+            const output = {
+                status: "success",
+                timestamp: new Date().toISOString(),
+                announcement: {
+                    id: announcementId,
+                    subject: firstPost.subject,
+                    author: firstPost.author,
+                    author_id: firstPost.authorId,
+                    created_at: new Date(firstPost.created * 1000).toISOString(),
+                    modified_at: new Date(firstPost.modified * 1000).toISOString(),
+                    message: firstPost.message,
+                },
+            };
+            console.log(JSON.stringify(output));
+        }
+        finally {
+            await (0, auth_js_2.closeBrowserSafely)(browser, browserContext);
+        }
+    });
+}
+exports.registerAnnouncementsCommand = registerAnnouncementsCommand;

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

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

package/script/src/commands/auth.js

@@ -0,0 +1,238 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAuthCommand = void 0;
+const utils_js_1 = require("../lib/utils.js");
+const playwright_core_1 = require("playwright-core");
+const logger_js_1 = require("../lib/logger.js");
+const auth_js_1 = require("../lib/auth.js");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+function registerAuthCommand(program) {
+    const authCmd = program.command("auth");
+    authCmd.description("Authentication commands");
+    // Register login directly on program (not under auth subcommand)
+    program
+        .command("login")
+        .description("Login to iLearning manually and save session")
+        .action(async (options) => {
+        const log = (0, logger_js_1.createLogger)(false);
+        // Determine session storage path
+        const baseDir = (0, utils_js_1.getBaseDir)();
+        const sessionDir = path_1.default.resolve(baseDir, ".auth");
+        const sessionPath = path_1.default.resolve(sessionDir, "storage-state.json");
+        // Ensure session directory exists
+        if (!fs_1.default.existsSync(sessionDir)) {
+            fs_1.default.mkdirSync(sessionDir, { recursive: true });
+        }
+        const edgePath = (0, auth_js_1.findEdgePath)();
+        const browser = await playwright_core_1.chromium.launch({
+            executablePath: edgePath,
+            headless: false,
+            slowMo: 0,
+        });
+        let context;
+        let page;
+        if (fs_1.default.existsSync(sessionPath)) {
+            log.info(`找到已有 session: ${sessionPath}`);
+            log.info("正在驗證 session...");
+            try {
+                context = await browser.newContext({ storageState: sessionPath });
+                page = await context.newPage();
+                await page.goto("https://ilearning.cycu.edu.tw/my/", {
+                    waitUntil: "domcontentloaded",
+                    timeout: 15000,
+                });
+                const url = page.url();
+                if (url.includes("login") || url.includes("microsoftonline")) {
+                    log.warn("Session 已過期，請重新登入。");
+                    await context.close();
+                    context = await browser.newContext();
+                    page = await context.newPage();
+                    await page.goto("https://ilearning.cycu.edu.tw/login/index.php", {
+                        waitUntil: "domcontentloaded",
+                    });
+                }
+                else {
+                    // Session is still valid, close browser and exit
+                    try {
+                        if (context)
+                            await context.close().catch(() => { });
+                    }
+                    catch { }
+                    try {
+                        await browser.close().catch(() => { });
+                    }
+                    catch { }
+                    // Wait a bit for browser to fully close
+                    await new Promise(resolve => setTimeout(resolve, 500));
+                    const result = {
+                        status: "success",
+                        message: "Session still valid",
+                        session_path: sessionPath,
+                        updated: false
+                    };
+                    console.log(JSON.stringify(result));
+                    return;
+                }
+            }
+            catch {
+                log.warn("無法恢復 session，請重新登入。");
+                // context might not have been initialized if the error occurred during newContext
+                if (context) {
+                    await context.close();
+                }
+                context = await browser.newContext();
+                page = await context.newPage();
+                await page.goto("https://ilearning.cycu.edu.tw/login/index.php", {
+                    waitUntil: "domcontentloaded",
+                });
+            }
+        }
+        else {
+            log.info("首次登入，請在瀏覽器中完成登入流程。");
+            context = await browser.newContext();
+            page = await context.newPage();
+            await page.goto("https://ilearning.cycu.edu.tw/login/index.php", {
+                waitUntil: "domcontentloaded",
+            });
+        }
+        log.info("\n請在瀏覽器中完成登入，登入成功後將自動儲存 session...\n");
+        try {
+            const startTime = Date.now();
+            const timeout = 300000;
+            let loggedIn = false;
+            while (Date.now() - startTime < timeout) {
+                await page.waitForTimeout(1000);
+                const currentUrl = page.url();
+                if (currentUrl.includes("ilearning.cycu.edu.tw") &&
+                    !currentUrl.includes("login") &&
+                    !currentUrl.includes("microsoftonline")) {
+                    await page.waitForTimeout(2000);
+                    const finalUrl = page.url();
+                    if (finalUrl.includes("ilearning.cycu.edu.tw") &&
+                        !finalUrl.includes("login") &&
+                        !finalUrl.includes("microsoftonline")) {
+                        loggedIn = true;
+                        break;
+                    }
+                }
+            }
+            if (loggedIn) {
+                await context.storageState({ path: sessionPath });
+                const stats = fs_1.default.statSync(sessionPath);
+                const result = {
+                    status: "success",
+                    message: "Login successful",
+                    session_path: sessionPath,
+                    session_size: stats.size,
+                    updated: true
+                };
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                throw new Error("TimeoutError");
+            }
+        }
+        catch (err) {
+            const errorResult = {
+                status: "error",
+                error: err instanceof Error ? err.message : String(err),
+                session_path: sessionPath
+            };
+            console.log(JSON.stringify(errorResult));
+        }
+        finally {
+            // Safely close browser with error handling
+            try {
+                if (context)
+                    await context.close().catch(() => { });
+            }
+            catch { }
+            try {
+                await browser.close().catch(() => { });
+            }
+            catch { }
+            // Wait for browser process to fully terminate
+            await new Promise(resolve => setTimeout(resolve, 500));
+        }
+    });
+    // auth subcommand group (for status and other auth-related commands)
+    authCmd
+        .command("status")
+        .description("Check session status")
+        .option("--session <path>", "Session file path", ".auth/storage-state.json")
+        .action(async (options) => {
+        const baseDir = (0, utils_js_1.getBaseDir)();
+        const sessionPath = path_1.default.resolve(baseDir, options.session);
+        if (fs_1.default.existsSync(sessionPath)) {
+            const stats = fs_1.default.statSync(sessionPath);
+            // Try to read and validate the session
+            try {
+                const content = fs_1.default.readFileSync(sessionPath, "utf8");
+                const state = JSON.parse(content);
+                const cookies = state.cookies || [];
+                const moodleSession = cookies.find((c) => c.name === "MoodleSession");
+                const result = {
+                    status: "success",
+                    session_path: sessionPath,
+                    exists: true,
+                    modified: new Date(stats.mtime).toISOString(),
+                    size: stats.size,
+                    moodle_session: moodleSession ? {
+                        exists: true,
+                        expires: new Date(moodleSession.expires * 1000).toISOString()
+                    } : {
+                        exists: false
+                    }
+                };
+                console.log(JSON.stringify(result, null, 2));
+            }
+            catch {
+                const result = {
+                    status: "error",
+                    error: "Session file is corrupted",
+                    session_path: sessionPath
+                };
+                console.log(JSON.stringify(result, null, 2));
+            }
+        }
+        else {
+            const result = {
+                status: "error",
+                error: "Session not found",
+                session_path: sessionPath,
+                hint: "Run 'openape auth login' first"
+            };
+            console.log(JSON.stringify(result, null, 2));
+        }
+    });
+    authCmd
+        .command("logout")
+        .description("Remove saved session")
+        .option("--session <path>", "Session file path", ".auth/storage-state.json")
+        .action(async (options) => {
+        const baseDir = (0, utils_js_1.getBaseDir)();
+        const sessionPath = path_1.default.resolve(baseDir, options.session);
+        if (fs_1.default.existsSync(sessionPath)) {
+            fs_1.default.unlinkSync(sessionPath);
+            const result = {
+                status: "success",
+                message: "Session removed",
+                session_path: sessionPath
+            };
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            const result = {
+                status: "error",
+                error: "Session not found",
+                session_path: sessionPath
+            };
+            console.log(JSON.stringify(result, null, 2));
+        }
+    });
+}
+exports.registerAuthCommand = registerAuthCommand;

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

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