@mo7yw4ng/openape 1.0.5 → 1.0.6

package/script/src/commands/quizzes.js

@@ -1,16 +1,10 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerQuizzesCommand = registerQuizzesCommand;
 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 index_js_1 = require("../index.js");
-const token_js_1 = require("../lib/token.js");
-const node_path_1 = __importDefault(require("node:path"));
-const node_fs_1 = __importDefault(require("node:fs"));
 function stripHtmlKeepLines(html) {
     return html
         .replace(/<br\s*\/?>/gi, "\n")
@@ -65,38 +59,6 @@ function parseQuizQuestions(questions) {
 function registerQuizzesCommand(program) {
     const quizzesCmd = program.command("quizzes");
     quizzesCmd.description("Quiz operations");
-    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, outputFormat);
-        const baseDir = (0, utils_js_1.getBaseDir)();
-        const sessionPath = node_path_1.default.resolve(baseDir, ".auth", "storage-state.json");
-        // Check if session exists
-        if (!node_fs_1.default.existsSync(sessionPath)) {
-            log.error("未找到登入 session。請先執行 'openape login' 進行登入。");
-            log.info(`Session 預期位置: ${sessionPath}`);
-            return null;
-        }
-        // Try to load WS token
-        const wsToken = (0, token_js_1.loadWsToken)(sessionPath);
-        if (!wsToken) {
-            log.error("未找到 WS token。請先執行 'openape login' 進行登入。");
-            return null;
-        }
-        return {
-            log,
-            session: {
-                wsToken,
-                moodleBaseUrl: "https://ilearning.cycu.edu.tw",
-            },
-        };
-    }
     quizzesCmd
         .command("list")
         .description("List incomplete quizzes in a course")
@@ -104,8 +66,8 @@ function registerQuizzesCommand(program) {
         .option("--all", "Include completed quizzes")
         .option("--output <format>", "Output format: json|csv|table|silent")
         .action(async (courseId, options, command) => {
-        const output = getOutputFormat(command);
-        const apiContext = await createApiContext(options, command);
+        const output = (0, utils_js_1.getOutputFormat)(command);
+        const apiContext = await (0, auth_js_1.createApiContext)(options, command);
         if (!apiContext) {
             process.exitCode = 1;
             return;
@@ -126,8 +88,8 @@ function registerQuizzesCommand(program) {
         .option("--all", "Include completed quizzes")
         .option("--output <format>", "Output format: json|csv|table|silent")
         .action(async (options, command) => {
-        const output = getOutputFormat(command);
-        const apiContext = await createApiContext(options, command);
+        const output = (0, utils_js_1.getOutputFormat)(command);
+        const apiContext = await (0, auth_js_1.createApiContext)(options, command);
         if (!apiContext) {
             process.exitCode = 1;
             return;
@@ -167,8 +129,8 @@ function registerQuizzesCommand(program) {
         .argument("<quiz-id>", "Quiz ID")
         .option("--output <format>", "Output format: json|csv|table|silent")
         .action(async (quizCmid, options, command) => {
-        const output = getOutputFormat(command);
-        const apiContext = await createApiContext(options, command);
+        const output = (0, utils_js_1.getOutputFormat)(command);
+        const apiContext = await (0, auth_js_1.createApiContext)(options, command);
         if (!apiContext) {
             process.exitCode = 1;
             return;
@@ -205,8 +167,8 @@ function registerQuizzesCommand(program) {
         .option("--page <number>", "Page number (-1 for all pages)", "-1")
         .option("--output <format>", "Output format: json|csv|table|silent")
         .action(async (attemptId, options, command) => {
-        const output = getOutputFormat(command);
-        const apiContext = await createApiContext(options, command);
+        const output = (0, utils_js_1.getOutputFormat)(command);
+        const apiContext = await (0, auth_js_1.createApiContext)(options, command);
         if (!apiContext) {
             process.exitCode = 1;
             return;
@@ -240,8 +202,8 @@ function registerQuizzesCommand(program) {
         .option("--submit", "Submit the attempt after saving")
         .option("--output <format>", "Output format: json|csv|table|silent")
         .action(async (attemptId, answersJson, options, command) => {
-        const output = getOutputFormat(command);
-        const apiContext = await createApiContext(options, command);
+        const output = (0, utils_js_1.getOutputFormat)(command);
+        const apiContext = await (0, auth_js_1.createApiContext)(options, command);
         if (!apiContext) {
             process.exitCode = 1;
             return;

package/script/src/commands/skills.js

@@ -7,6 +7,7 @@ exports.registerSkillsCommand = registerSkillsCommand;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_os_1 = __importDefault(require("node:os"));
+const node_url_1 = require("node:url");
 const SKILL_NAME = "openape";
 const GITHUB_RAW_URL = `https://raw.githubusercontent.com/mo7yw4ng/openape/refs/heads/main/skills/${SKILL_NAME}/SKILL.md`;
 /**
@@ -24,11 +25,10 @@ const PLATFORMS = {
 async function readSkillContent() {
     // Try local path first (relative to this file's location)
     try {
-        const base = node_path_1.default.dirname(new URL(globalThis[Symbol.for("import-meta-ponyfill-commonjs")](require, module).url).pathname);
-        const normalized = process.platform === "win32" ? base.replace(/^\//, "") : base;
+        const base = node_path_1.default.dirname((0, node_url_1.fileURLToPath)(globalThis[Symbol.for("import-meta-ponyfill-commonjs")](require, module).url));
         // When running from source: src/commands/ → ../../skills/openape/SKILL.md
         // When bundled by dnt into build/: esm/commands/ or script/ → ../../skills/openape/SKILL.md
-        const localPath = node_path_1.default.resolve(normalized, "..", "..", "skills", SKILL_NAME, "SKILL.md");
+        const localPath = node_path_1.default.resolve(base, "..", "..", "skills", SKILL_NAME, "SKILL.md");
         return await node_fs_1.default.promises.readFile(localPath, "utf-8");
     }
     catch {

package/script/src/commands/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/src/commands/upload.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2D5D"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/src/commands/upload.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwD5D"}

package/script/src/commands/upload.js

@@ -26,19 +26,16 @@ function registerUploadCommand(program) {
             process.exitCode = 1;
             return;
         }
-        // Resolve file path
         const resolvedPath = node_path_1.default.resolve(filePath);
-        // Check if file exists
+        let stats;
         try {
-            await promises_1.default.access(resolvedPath);
+            stats = await promises_1.default.stat(resolvedPath);
         }
         catch {
             apiContext.log.error(`檔案不存在: ${filePath}`);
             process.exitCode = 1;
             return;
         }
-        // Get file size
-        const stats = await promises_1.default.stat(resolvedPath);
         const fileSizeKB = (0, utils_js_1.formatFileSize)(stats.size);
         apiContext.log.info(`上傳檔案: ${node_path_1.default.basename(resolvedPath)} (${fileSizeKB} KB)`);
         // Upload file

package/script/src/commands/videos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"videos.d.ts","sourceRoot":"","sources":["../../../src/src/commands/videos.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgY5D"}
+{"version":3,"file":"videos.d.ts","sourceRoot":"","sources":["../../../src/src/commands/videos.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgT5D"}

package/script/src/commands/videos.js

@@ -6,80 +6,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerVideosCommand = registerVideosCommand;
 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 index_js_1 = require("../index.js");
-const token_js_1 = require("../lib/token.js");
 const node_path_1 = __importDefault(require("node:path"));
 const node_fs_1 = __importDefault(require("node:fs"));
 function registerVideosCommand(program) {
     const videosCmd = program.command("videos");
     videosCmd.description("Video progress operations");
-    // Pure API context - no browser required (fast!)
-    async function createApiContext(options, command) {
-        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
-        // Don't silence logs for commands that don't have explicit output format control
-        const outputFormat = command && command.optsWithGlobals ? (0, utils_js_1.getOutputFormat)(command) : "table";
-        const silent = outputFormat === "json" && !opts.verbose;
-        const log = (0, logger_js_1.createLogger)(opts.verbose, silent, outputFormat);
-        const baseDir = (0, utils_js_1.getBaseDir)();
-        const sessionPath = node_path_1.default.resolve(baseDir, ".auth", "storage-state.json");
-        // Check if session exists
-        if (!node_fs_1.default.existsSync(sessionPath)) {
-            console.error("未找到登入 session。請先執行 'openape login' 進行登入。");
-            log.info(`Session 預期位置: ${sessionPath}`);
-            return null;
-        }
-        // Try to load WS token
-        const wsToken = (0, token_js_1.loadWsToken)(sessionPath);
-        if (!wsToken) {
-            console.error("未找到 WS token。請先執行 'openape login' 進行登入。");
-            return null;
-        }
-        return {
-            log,
-            session: {
-                wsToken,
-                moodleBaseUrl: "https://ilearning.cycu.edu.tw",
-            },
-        };
-    }
-    // Helper function to create session context (for browser-only commands)
-    async function createSessionContext(options, command) {
-        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
-        const outputFormat = (0, utils_js_1.getOutputFormat)(command || { optsWithGlobals: () => ({ output: "json" }) });
-        const silent = outputFormat === "json" && !opts.verbose;
-        const log = (0, logger_js_1.createLogger)(opts.verbose, silent, outputFormat);
-        const baseDir = (0, utils_js_1.getBaseDir)();
-        const sessionPath = node_path_1.default.resolve(baseDir, ".auth", "storage-state.json");
-        if (!node_fs_1.default.existsSync(sessionPath)) {
-            console.error("未找到登入 session。請先執行 'openape login' 進行登入。");
-            return null;
-        }
-        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;
-        }
-    }
     videosCmd
         .command("list")
         .description("List videos in a course")
@@ -88,7 +21,7 @@ function registerVideosCommand(program) {
         .option("--output <format>", "Output format: json|csv|table|silent")
         .action(async (courseId, options, command) => {
         const output = (0, utils_js_1.getOutputFormat)(command);
-        const apiContext = await createApiContext(options, command);
+        const apiContext = await (0, auth_js_1.createApiContext)(options, command);
         if (!apiContext) {
             process.exitCode = 1;
             return;
@@ -109,7 +42,7 @@ function registerVideosCommand(program) {
         .action(async (courseId, options, command) => {
         const output = (0, utils_js_1.getOutputFormat)(command);
         // Get API context for getting incomplete videos and completion
-        const apiContext = await createApiContext(options, command);
+        const apiContext = await (0, auth_js_1.createApiContext)(options, command);
         if (!apiContext) {
             process.exitCode = 1;
             return;
@@ -134,7 +67,7 @@ function registerVideosCommand(program) {
             return;
         }
         // Need browser only for getting viewId and duration (not needed for dry-run)
-        const context = await createSessionContext(options, command);
+        const context = await (0, auth_js_1.createBrowserContext)(options, command);
         if (!context) {
             process.exitCode = 1;
             return;
@@ -171,7 +104,7 @@ function registerVideosCommand(program) {
             }
         }
         finally {
-            await (0, auth_js_2.closeBrowserSafely)(browser, browserContext);
+            await (0, auth_js_1.closeBrowserSafely)(browser, browserContext);
         }
     });
     videosCmd
@@ -182,7 +115,7 @@ function registerVideosCommand(program) {
         .action(async (options, command) => {
         const output = (0, utils_js_1.getOutputFormat)(command);
         // Get API context for getting incomplete videos and completion
-        const apiContext = await createApiContext(options, command);
+        const apiContext = await (0, auth_js_1.createApiContext)(options, command);
         if (!apiContext) {
             process.exitCode = 1;
             return;
@@ -227,7 +160,7 @@ function registerVideosCommand(program) {
             return;
         }
         // Need browser only for getting viewId and duration (not needed for dry-run)
-        const context = await createSessionContext(options, command);
+        const context = await (0, auth_js_1.createBrowserContext)(options, command);
         if (!context) {
             process.exitCode = 1;
             return;
@@ -272,7 +205,7 @@ function registerVideosCommand(program) {
             }
         }
         finally {
-            await (0, auth_js_2.closeBrowserSafely)(browser, browserContext);
+            await (0, auth_js_1.closeBrowserSafely)(browser, browserContext);
         }
     });
     videosCmd
@@ -282,7 +215,7 @@ function registerVideosCommand(program) {
         .option("--output-dir <path>", "Output directory", "./downloads/videos")
         .option("--incomplete-only", "Download only incomplete videos")
         .action(async (courseId, options, command) => {
-        const context = await createSessionContext(options, command);
+        const context = await (0, auth_js_1.createBrowserContext)(options, command);
         if (!context) {
             process.exitCode = 1;
             return;
@@ -322,7 +255,7 @@ function registerVideosCommand(program) {
             const completed = downloaded.filter(d => d.success).length;
             const failed = downloaded.filter(d => !d.success).length;
             log.info(`\n執行結果: ${completed} 成功, ${failed} 失敗`);
-            console.log(JSON.stringify({
+            (0, index_js_1.formatAndOutput)(downloaded, "json", log, {
                 status: "success",
                 timestamp: new Date().toISOString(),
                 course_id: courseId,
@@ -330,13 +263,10 @@ function registerVideosCommand(program) {
                 total_videos: videos.length,
                 downloaded: completed,
                 failed,
-            }));
-            for (const v of downloaded) {
-                console.log(JSON.stringify(v));
-            }
+            });
         }
         finally {
-            await (0, auth_js_2.closeBrowserSafely)(browser, browserContext);
+            await (0, auth_js_1.closeBrowserSafely)(browser, browserContext);
         }
     });
 }

package/script/src/index.d.ts

@@ -21,7 +21,8 @@ export declare function createSessionContext(options: {
 /**
  * Helper to output formatted data.
  * For JSON output (agent mode), exits immediately after output.
+ * If meta is provided, it is printed as the first line before items.
  */
-export declare function formatAndOutput<T extends Record<string, unknown>>(data: T | T[], format: OutputFormat, log: Logger): void;
+export declare function formatAndOutput<T extends Record<string, unknown>>(data: T | T[], format: OutputFormat, log: Logger, meta?: Record<string, unknown>): void;
 export { createLogger, type AppConfig, type Logger, type SessionInfo, type OutputFormat };
 //# sourceMappingURL=index.d.ts.map

package/script/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/src/index.ts"],"names":[],"mappings":";AACA,OAAO,sBAAsB,CAAC;AAO9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAwEnF;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,OAAO,CAAC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAAC,CAoBhH;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EACb,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,GACV,IAAI,CAyBN;AA2CD,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/src/index.ts"],"names":[],"mappings":";AACA,OAAO,sBAAsB,CAAC;AAO9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAwEnF;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,OAAO,CAAC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAAC,CAoBhH;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EACb,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CA4BN;AA2CD,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,CAAC"}

package/script/src/index.js

@@ -94,9 +94,13 @@ async function createSessionContext(options) {
 /**
  * Helper to output formatted data.
  * For JSON output (agent mode), exits immediately after output.
+ * If meta is provided, it is printed as the first line before items.
  */
-function formatAndOutput(data, format, log) {
+function formatAndOutput(data, format, log, meta) {
     if (format === "json") {
+        if (meta) {
+            console.log(JSON.stringify(meta));
+        }
         if (Array.isArray(data)) {
             for (const item of data) {
                 console.log(JSON.stringify(item));

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

@@ -1,7 +1,7 @@
 import { type Browser, type BrowserContext, type Page } from "playwright-core";
-import type { AppConfig, Logger, OutputFormat } from "./types.js";
+import type { AppConfig, Logger, OutputFormat, SessionInfo } from "./types.js";
 /**
- * Find a Chromium-based browser executable on Windows.
+ * Find a Chromium-based browser executable on Windows, macOS, or Linux.
  * Priority: Edge → Chrome → Brave
  */
 export declare function findEdgePath(): string;
@@ -44,4 +44,23 @@ export declare function createApiContext(options: {
         moodleBaseUrl: string;
     };
 } | null>;
+/**
+ * Create an authenticated browser context for commands that need page access.
+ * Launches a browser, restores or creates a session, and extracts session info.
+ */
+export declare function createBrowserContext(options: {
+    verbose?: boolean;
+    headed?: boolean;
+}, command?: {
+    optsWithGlobals(): {
+        output?: OutputFormat;
+        verbose?: boolean;
+    };
+}): Promise<{
+    log: Logger;
+    page: Page;
+    session: SessionInfo;
+    browser: Browser;
+    context: BrowserContext;
+} | null>;
 //# sourceMappingURL=auth.d.ts.map

package/script/src/lib/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/src/lib/auth.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGlE;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAuBrC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4DtF;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,cAAc,EACxB,SAAS,GAAE,MAAa,EACxB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAoHD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EAChD,OAAO,CAAC,EAAE;IAAE,eAAe,IAAI;QAAE,MAAM,CAAC,EAAE,YAAY,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAC5E,OAAO,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD,GAAG,IAAI,CAAC,CA0BR"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/src/lib/auth.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM/E;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAiDrC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4DtF;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,cAAc,EACxB,SAAS,GAAE,MAAa,EACxB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAoHD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EAChD,OAAO,CAAC,EAAE;IAAE,eAAe,IAAI;QAAE,MAAM,CAAC,EAAE,YAAY,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAC5E,OAAO,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD,GAAG,IAAI,CAAC,CAoBR;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EAChD,OAAO,CAAC,EAAE;IAAE,eAAe,IAAI;QAAE,MAAM,CAAC,EAAE,YAAY,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAC5E,OAAO,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,IAAI,CAAC,CA0BR"}

package/script/src/lib/auth.js

@@ -1,37 +1,4 @@
 "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 () {
-    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;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -40,32 +7,66 @@ exports.findEdgePath = findEdgePath;
 exports.launchAuthenticated = launchAuthenticated;
 exports.closeBrowserSafely = closeBrowserSafely;
 exports.createApiContext = createApiContext;
+exports.createBrowserContext = createBrowserContext;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const playwright_core_1 = require("playwright-core");
 const token_js_1 = require("./token.js");
+const logger_js_1 = require("./logger.js");
+const utils_js_1 = require("./utils.js");
+const session_js_1 = require("./session.js");
 /**
- * Find a Chromium-based browser executable on Windows.
+ * Find a Chromium-based browser executable on Windows, macOS, or Linux.
  * Priority: Edge → Chrome → Brave
  */
 function findEdgePath() {
-    const roots = [
-        process.env.PROGRAMFILES,
-        process.env["PROGRAMFILES(X86)"],
-        process.env.LOCALAPPDATA,
-    ].filter(Boolean);
-    const browsers = [
-        { name: "Edge", suffix: "Microsoft\\Edge\\Application\\msedge.exe" },
-        { name: "Chrome", suffix: "Google\\Chrome\\Application\\chrome.exe" },
-        { name: "Brave", suffix: "BraveSoftware\\Brave-Browser\\Application\\brave.exe" },
-    ];
-    for (const { suffix } of browsers) {
-        for (const root of roots) {
-            const candidate = node_path_1.default.join(root, suffix);
+    const platform = process.platform;
+    if (platform === "darwin") {
+        const candidates = [
+            "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+            "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+            "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
+        ];
+        for (const candidate of candidates) {
             if (node_fs_1.default.existsSync(candidate))
                 return candidate;
         }
     }
+    else if (platform === "linux") {
+        const candidates = [
+            "/usr/bin/microsoft-edge",
+            "/usr/bin/google-chrome",
+            "/usr/bin/chromium-browser",
+            "/usr/bin/chromium",
+            "/usr/bin/brave-browser",
+        ];
+        for (const candidate of candidates) {
+            if (node_fs_1.default.existsSync(candidate))
+                return candidate;
+        }
+    }
+    else if (platform === "win32") {
+        const roots = [
+            process.env.PROGRAMFILES,
+            process.env["PROGRAMFILES(X86)"],
+            process.env.LOCALAPPDATA,
+        ].filter(Boolean);
+        const browsers = [
+            { suffix: "Microsoft\\Edge\\Application\\msedge.exe" },
+            { suffix: "Google\\Chrome\\Application\\chrome.exe" },
+            { suffix: "BraveSoftware\\Brave-Browser\\Application\\brave.exe" },
+        ];
+        for (const { suffix } of browsers) {
+            for (const root of roots) {
+                const candidate = node_path_1.default.join(root, suffix);
+                if (node_fs_1.default.existsSync(candidate))
+                    return candidate;
+            }
+        }
+    }
+    else {
+        throw new Error(`不支援的作業系統：${platform}`);
+    }
     throw new Error("找不到可用的瀏覽器（Edge / Chrome / Brave）。請確認已安裝其中一種。");
 }
 /**
@@ -245,18 +246,14 @@ async function login(page, config, log) {
  * Returns null if session is invalid or WS token is missing.
  */
 async function createApiContext(options, command) {
-    const { createLogger } = await Promise.resolve().then(() => __importStar(require("./logger.js")));
-    const { loadWsToken } = await Promise.resolve().then(() => __importStar(require("./token.js")));
-    const { getOutputFormat, getSessionPath } = await Promise.resolve().then(() => __importStar(require("./utils.js")));
     const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
-    const outputFormat = command ? getOutputFormat(command) : "json";
+    const outputFormat = command ? (0, utils_js_1.getOutputFormat)(command) : "json";
     const silent = outputFormat === "json" && !opts.verbose;
-    const log = createLogger(opts.verbose, silent, outputFormat);
-    const sessionPath = getSessionPath();
-    // Try to load WS token
-    const wsToken = loadWsToken(sessionPath);
+    const log = (0, logger_js_1.createLogger)(opts.verbose, silent, outputFormat);
+    const sessionPath = (0, utils_js_1.getSessionPath)();
+    const wsToken = (0, token_js_1.loadWsToken)(sessionPath);
     if (!wsToken) {
-        console.error("未找到 WS token。請先執行 'openape login' 進行登入。");
+        log.error("未找到 WS token。請先執行 'openape login' 進行登入。");
         return null;
     }
     return {
@@ -267,3 +264,33 @@ async function createApiContext(options, command) {
         },
     };
 }
+/**
+ * Create an authenticated browser context for commands that need page access.
+ * Launches a browser, restores or creates a session, and extracts session info.
+ */
+async function createBrowserContext(options, command) {
+    const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
+    const outputFormat = command ? (0, utils_js_1.getOutputFormat)(command) : "json";
+    const silent = outputFormat === "json" && !opts.verbose;
+    const log = (0, logger_js_1.createLogger)(opts.verbose, silent, outputFormat);
+    const sessionPath = (0, utils_js_1.getSessionPath)();
+    const headed = "headed" in options ? options.headed : false;
+    const config = {
+        courseUrl: "",
+        moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+        headless: !headed,
+        slowMo: 0,
+        authStatePath: sessionPath,
+        ollamaBaseUrl: "",
+    };
+    try {
+        log.info("啟動瀏覽器...");
+        const { browser, context, page, wsToken } = await launchAuthenticated(config, log);
+        const session = await (0, session_js_1.extractSessionInfo)(page, config, log, wsToken);
+        return { log, page, session, browser, context };
+    }
+    catch (err) {
+        log.error(err instanceof Error ? err.message : String(err));
+        return null;
+    }
+}

package/script/src/lib/logger.d.ts

@@ -1,3 +1,3 @@
-import type { Logger } from "./types.js";
-export declare function createLogger(verbose?: boolean, silent?: boolean, outputFormat?: string): Logger;
+import type { Logger, OutputFormat } from "./types.js";
+export declare function createLogger(verbose?: boolean, silent?: boolean, outputFormat?: OutputFormat): Logger;
 //# sourceMappingURL=logger.d.ts.map

package/script/src/lib/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/src/lib/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAOzC,wBAAgB,YAAY,CAAC,OAAO,UAAQ,EAAE,MAAM,UAAQ,EAAE,YAAY,GAAE,MAAe,GAAG,MAAM,CAwBnG"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/src/lib/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAOvD,wBAAgB,YAAY,CAAC,OAAO,UAAQ,EAAE,MAAM,UAAQ,EAAE,YAAY,GAAE,YAAqB,GAAG,MAAM,CAuBzG"}

package/script/src/lib/logger.js

@@ -4,8 +4,7 @@ exports.createLogger = createLogger;
 const NO_COLOR = !!process.env.NO_COLOR;
 const c = (code, text) => NO_COLOR ? text : `\x1b[${code}m${text}\x1b[0m`;
 function createLogger(verbose = false, silent = false, outputFormat = "json") {
-    const jsonError = outputFormat === "json";
-    const errorFn = jsonError
+    const errorFn = outputFormat === "json"
         ? (msg) => console.error(JSON.stringify({ error: msg }))
         : (msg) => console.error(c("31", "[ERR]") + `   ${msg}`);
     if (silent) {

package/script/src/lib/moodle.d.ts

@@ -57,6 +57,20 @@ export declare function getForumsApi(session: {
     courseid: number;
     timemodified: number;
 }>>;
+/**
+ * Resolve a forum ID (cmid or instance ID) to a forum instance ID.
+ * Tries cmid resolution first (via core_course_get_course_module) to get name/course info.
+ * Falls back to treating the ID as a raw forum instance ID.
+ */
+export declare function resolveForumId(session: {
+    wsToken: string;
+    moodleBaseUrl: string;
+}, id: string): Promise<{
+    forumId: number;
+    cmid?: number;
+    name?: string;
+    courseid?: number;
+} | null>;
 /**
  * Get discussions in a forum via WS API (no browser required).
  * Uses mod_forum_get_forum_discussions