@mo7yw4ng/openape 1.0.3 → 1.0.5

package/esm/src/commands/quizzes.js

@@ -1,13 +1,61 @@
-import { getBaseDir } from "../lib/utils.js";
-import { getEnrolledCoursesApi, getQuizzesByCoursesApi } from "../lib/moodle.js";
+import { getBaseDir, formatTimestamp } from "../lib/utils.js";
+import { getEnrolledCoursesApi, getQuizzesByCoursesApi, startQuizAttemptApi, getQuizAttemptDataApi, getAllQuizAttemptDataApi, processQuizAttemptApi } from "../lib/moodle.js";
 import { createLogger } from "../lib/logger.js";
-import { launchAuthenticated } from "../lib/auth.js";
-import { extractSessionInfo } from "../lib/session.js";
-import { closeBrowserSafely } from "../lib/auth.js";
 import { formatAndOutput } from "../index.js";
 import { loadWsToken } from "../lib/token.js";
 import path from "node:path";
 import fs from "node:fs";
+function stripHtmlKeepLines(html) {
+    return html
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<\/p>/gi, "\n")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+function parseQuestionHtml(html) {
+    const qtextMatch = html.match(/<div class="qtext">([\s\S]*?)<\/div>\s*<\/div>/);
+    const text = stripHtmlKeepLines(qtextMatch?.[1] ?? "");
+    const options = [];
+    const optionRegex = /data-region="answer-label">([\s\S]*?)<\/div>\s*<\/div>/g;
+    let match;
+    while ((match = optionRegex.exec(html)) !== null) {
+        options.push(stripHtmlKeepLines(match[1]));
+    }
+    return { text, options };
+}
+function parseSavedAnswer(html) {
+    const radioChecked = html.match(/<input type="radio"[^>]*value="(\d+)"[^>]*checked="checked"/);
+    if (radioChecked && radioChecked[1] !== "-1")
+        return radioChecked[1];
+    const checkboxChecked = [...html.matchAll(/<input type="checkbox"[^>]*name="[^"]*choice(\d+)"[^>]*checked="checked"/g)];
+    if (checkboxChecked.length > 0)
+        return checkboxChecked.map(m => m[1]);
+    // Match <input> with both name="*_answer" and type="text" in any attribute order
+    const textMatch = html.match(/<input[^>]*(?:name="[^"]*:_answer"|type="text")[^>]*(?:name="[^"]*:_answer"|type="text")[^>]*value="([^"]*)"/);
+    if (textMatch && textMatch[1] !== "")
+        return textMatch[1];
+    return null;
+}
+function parseQuizQuestions(questions) {
+    return Object.values(questions).map((q) => {
+        const parsed = parseQuestionHtml(q.html ?? "");
+        const savedAnswer = parseSavedAnswer(q.html ?? "");
+        return {
+            slot: q.slot,
+            type: q.type,
+            status: q.status,
+            stateclass: q.stateclass,
+            savedAnswer,
+            question: parsed.text,
+            options: parsed.options,
+        };
+    });
+}
 export function registerQuizzesCommand(program) {
     const quizzesCmd = program.command("quizzes");
     quizzesCmd.description("Quiz operations");
@@ -20,19 +68,19 @@ export function registerQuizzesCommand(program) {
         const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
         const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
         const silent = outputFormat === "json" && !opts.verbose;
-        const log = createLogger(opts.verbose, silent);
+        const log = createLogger(opts.verbose, silent, outputFormat);
         const baseDir = getBaseDir();
         const sessionPath = path.resolve(baseDir, ".auth", "storage-state.json");
         // Check if session exists
         if (!fs.existsSync(sessionPath)) {
-            log.error("未找到登入 session。請先執行 'openape auth login' 進行登入。");
+            log.error("未找到登入 session。請先執行 'openape login' 進行登入。");
             log.info(`Session 預期位置: ${sessionPath}`);
             return null;
         }
         // Try to load WS token
         const wsToken = loadWsToken(sessionPath);
         if (!wsToken) {
-            log.error("未找到 WS token。請先執行 'openape auth login' 進行登入。");
+            log.error("未找到 WS token。請先執行 'openape login' 進行登入。");
             return null;
         }
         return {
@@ -43,45 +91,11 @@ export function registerQuizzesCommand(program) {
             },
         };
     }
-    // Helper function to create session context (for open command only)
-    async function createSessionContext(options, command) {
-        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
-        const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
-        const silent = outputFormat === "json" && !opts.verbose;
-        const log = createLogger(opts.verbose, silent);
-        const baseDir = getBaseDir();
-        const sessionPath = path.resolve(baseDir, ".auth", "storage-state.json");
-        if (!fs.existsSync(sessionPath)) {
-            log.error("未找到登入 session。請先執行 'openape auth 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 launchAuthenticated(config, log);
-        try {
-            const session = await extractSessionInfo(page, config, log);
-            return { log, page, session, browser, context };
-        }
-        catch (err) {
-            await context.close();
-            await browser.close();
-            throw err;
-        }
-    }
     quizzesCmd
         .command("list")
-        .description("List quizzes in a course")
+        .description("List incomplete quizzes in a course")
         .argument("<course-id>", "Course ID")
-        .option("--available-only", "Show only available quizzes")
+        .option("--all", "Include completed quizzes")
         .option("--output <format>", "Output format: json|csv|table|silent")
         .action(async (courseId, options, command) => {
         const output = getOutputFormat(command);
@@ -91,16 +105,19 @@ export function registerQuizzesCommand(program) {
             return;
         }
         const quizzes = await getQuizzesByCoursesApi(apiContext.session, [parseInt(courseId, 10)]);
-        // Note: API doesn't provide completion status, so --available-only shows all
-        if (options.availableOnly) {
-            apiContext.log.warn("--available-only is not supported in API mode, showing all quizzes");
-        }
-        formatAndOutput(quizzes, output, apiContext.log);
+        // Default: only show incomplete quizzes
+        const filtered = options.all ? quizzes : quizzes.filter(q => !q.isComplete);
+        const formattedQuizzes = filtered.map(({ courseId, ...q }) => ({
+            ...q,
+            timeClose: q.timeClose ? formatTimestamp(q.timeClose) : null,
+        }));
+        formatAndOutput(formattedQuizzes, output, apiContext.log);
     });
     quizzesCmd
         .command("list-all")
-        .description("List all available quizzes across all courses")
+        .description("List all incomplete quizzes across all courses")
         .option("--level <type>", "Course level: in_progress (default) | all", "in_progress")
+        .option("--all", "Include completed quizzes")
         .option("--output <format>", "Output format: json|csv|table|silent")
         .action(async (options, command) => {
         const output = getOutputFormat(command);
@@ -121,13 +138,17 @@ export function registerQuizzesCommand(program) {
         const allQuizzes = [];
         for (const q of apiQuizzes) {
             const course = courseMap.get(q.courseId);
-            if (course) {
+            if (course && (options.all || !q.isComplete)) {
                 allQuizzes.push({
                     courseName: course.fullname,
+                    courseId: q.courseId,
                     name: q.name,
                     url: q.url,
-                    cmid: q.cmid,
+                    quizid: q.quizid,
                     isComplete: q.isComplete,
+                    attemptsUsed: q.attemptsUsed,
+                    maxAttempts: q.maxAttempts,
+                    timeClose: q.timeClose ? formatTimestamp(q.timeClose) : null,
                 });
             }
         }
@@ -135,26 +156,116 @@ export function registerQuizzesCommand(program) {
         formatAndOutput(allQuizzes, output, apiContext.log);
     });
     quizzesCmd
-        .command("open")
-        .description("Open a quiz URL in browser (manual mode)")
-        .argument("<quiz-url>", "Quiz URL")
-        .option("--headed", "Run browser in visible mode (default: true)")
-        .action(async (quizUrl, options, command) => {
-        const context = await createSessionContext({ ...options, headed: true }, command);
-        if (!context) {
+        .command("start")
+        .description("Start a new quiz attempt")
+        .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);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const result = await startQuizAttemptApi(apiContext.session, quizCmid);
+            apiContext.log.success(`Quiz attempt ${result.attempt.attemptid} started.`);
+            const attemptId = result.attempt.attemptid;
+            const data = await getAllQuizAttemptDataApi(apiContext.session, attemptId);
+            const questions = parseQuizQuestions(data.questions);
+            const outputData = [{
+                    attemptId,
+                    quizId: result.attempt.quizid,
+                    state: result.attempt.state,
+                    timeStart: formatTimestamp(result.attempt.timestart),
+                    timeFinish: result.attempt.timefinish
+                        ? formatTimestamp(result.attempt.timefinish)
+                        : null,
+                    isPreview: result.attempt.preview,
+                    totalQuestions: questions.length,
+                    questions,
+                }];
+            formatAndOutput(outputData, output, apiContext.log);
+        }
+        catch (error) {
+            apiContext.log.error(`Failed to start quiz attempt: ${error instanceof Error ? error.message : String(error)}`);
+            process.exitCode = 1;
+        }
+    });
+    quizzesCmd
+        .command("info")
+        .description("Get quiz attempt data and questions")
+        .argument("<attempt-id>", "Quiz attempt ID")
+        .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);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const pageNumber = parseInt(options.page);
+            const data = pageNumber === -1
+                ? await getAllQuizAttemptDataApi(apiContext.session, parseInt(attemptId))
+                : await getQuizAttemptDataApi(apiContext.session, parseInt(attemptId), pageNumber);
+            const questions = parseQuizQuestions(data.questions);
+            const outputData = [{
+                    attemptId: data.attempt.attemptid,
+                    quizId: data.attempt.quizid,
+                    state: data.attempt.state,
+                    totalQuestions: questions.length,
+                    questions,
+                }];
+            apiContext.log.success(`Retrieved attempt ${data.attempt.attemptid}`);
+            formatAndOutput(outputData, output, apiContext.log);
+        }
+        catch (error) {
+            apiContext.log.error(`Failed to get attempt data: ${error instanceof Error ? error.message : String(error)}`);
+            process.exitCode = 1;
+        }
+    });
+    quizzesCmd
+        .command("save")
+        .description("Save answers for a quiz attempt")
+        .argument("<attempt-id>", "Quiz attempt ID")
+        .argument("<answers>", "Answers JSON: [{slot:1,answer:\"0\"}]  multichoice=number, multichoices=\"0,2\", shortanswer=\"text\"")
+        .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);
+        if (!apiContext) {
             process.exitCode = 1;
             return;
         }
-        const { log, page, browser, context: browserContext } = context;
+        let answers;
         try {
-            log.info(`導航至測驗頁面: ${quizUrl}`);
-            await page.goto(quizUrl, { waitUntil: "domcontentloaded" });
-            log.info("瀏覽器已開啟，請手動完成測驗。");
-            log.info("按 Ctrl+C 關閉瀏覽器。");
-            await new Promise(() => { });
-        }
-        finally {
-            await closeBrowserSafely(browser, browserContext);
+            answers = JSON.parse(answersJson);
+        }
+        catch {
+            apiContext.log.error("Invalid answers JSON. Expected format: [{\"slot\":1,\"answer\":\"0\"},...]");
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            // Get attempt data to find uniqueid and sequencecheck values
+            const attemptData = await getAllQuizAttemptDataApi(apiContext.session, parseInt(attemptId));
+            const uniqueId = attemptData.attempt.uniqueid ?? attemptData.attempt.attemptid;
+            const sequenceChecks = new Map();
+            for (const q of Object.values(attemptData.questions)) {
+                if (q.sequencecheck !== undefined) {
+                    sequenceChecks.set(q.slot, q.sequencecheck);
+                }
+            }
+            const result = await processQuizAttemptApi(apiContext.session, parseInt(attemptId), uniqueId, answers, sequenceChecks, !!options.submit);
+            apiContext.log.success(`Attempt ${attemptId} state: ${result.state}`);
+            formatAndOutput([result], output, apiContext.log);
+        }
+        catch (error) {
+            apiContext.log.error(`Failed to submit attempt: ${error instanceof Error ? error.message : String(error)}`);
+            process.exitCode = 1;
         }
     });
 }

package/esm/src/commands/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/src/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6CpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0E5D"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/src/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2CpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuE5D"}

package/esm/src/commands/skills.js

@@ -23,12 +23,10 @@ async function readSkillContent() {
         // 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 = path.resolve(normalized, "..", "..", "skills", SKILL_NAME, "SKILL.md");
-        if (fs.existsSync(localPath)) {
-            return fs.readFileSync(localPath, "utf-8");
-        }
+        return await fs.promises.readFile(localPath, "utf-8");
     }
     catch {
-        // import.meta.url may be unavailable in some environments
+        // import.meta.url may be unavailable in some environments, or file doesn't exist
     }
     // Fallback: fetch from GitHub
     const res = await fetch(GITHUB_RAW_URL, { headers: { "User-Agent": "openape-cli" } });
@@ -81,10 +79,8 @@ export function registerSkillsCommand(program) {
             for (const target of targets) {
                 console.log(`Installing to ${target.name} (${target.path})...`);
                 const destDir = path.join(target.path, SKILL_NAME);
-                if (!fs.existsSync(destDir)) {
-                    fs.mkdirSync(destDir, { recursive: true });
-                }
-                fs.writeFileSync(path.join(destDir, "SKILL.md"), content, "utf-8");
+                await fs.promises.mkdir(destDir, { recursive: true });
+                await fs.promises.writeFile(path.join(destDir, "SKILL.md"), content, "utf-8");
                 console.log(`  \x1b[32m✔\x1b[0m ${SKILL_NAME} installed!`);
             }
             console.log("\nDone!");

package/esm/src/commands/upload.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerUploadCommand(program: Command): void;
+//# sourceMappingURL=upload.d.ts.map

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

@@ -0,0 +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"}

package/esm/src/commands/upload.js

@@ -0,0 +1,58 @@
+import { getOutputFormat, formatFileSize } from "../lib/utils.js";
+import { uploadFileApi } from "../lib/moodle.js";
+import { createApiContext } from "../lib/auth.js";
+import { formatAndOutput } from "../index.js";
+import path from "node:path";
+import fs from "node:fs/promises";
+export function registerUploadCommand(program) {
+    const uploadCmd = program.command("upload");
+    uploadCmd.description("Upload files to Moodle draft area");
+    uploadCmd
+        .command("file")
+        .description("Upload a file to Moodle draft area")
+        .argument("<file-path>", "Path to the file to upload")
+        .option("--filename <name>", "Custom filename (default: original filename)")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (filePath, options, command) => {
+        const output = getOutputFormat(command);
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        // Resolve file path
+        const resolvedPath = path.resolve(filePath);
+        // Check if file exists
+        try {
+            await fs.access(resolvedPath);
+        }
+        catch {
+            apiContext.log.error(`檔案不存在: ${filePath}`);
+            process.exitCode = 1;
+            return;
+        }
+        // Get file size
+        const stats = await fs.stat(resolvedPath);
+        const fileSizeKB = formatFileSize(stats.size);
+        apiContext.log.info(`上傳檔案: ${path.basename(resolvedPath)} (${fileSizeKB} KB)`);
+        // Upload file
+        const result = await uploadFileApi(apiContext.session, resolvedPath, {
+            filename: options.filename,
+        });
+        if (!result.success) {
+            apiContext.log.error(`上傳失敗: ${result.error}`);
+            process.exitCode = 1;
+            return;
+        }
+        apiContext.log.info(`✓ 上傳成功！Draft ID: ${result.draftId}`);
+        const uploadResult = {
+            success: true,
+            draft_id: result.draftId,
+            filename: path.basename(resolvedPath),
+            filesize: stats.size,
+            filesize_kb: formatFileSize(stats.size),
+            message: "Use this draft ID for assignment submission or forum posts",
+        };
+        formatAndOutput(uploadResult, output, apiContext.log);
+    });
+}

package/esm/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,CA+X5D"}
+{"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"}

package/esm/src/commands/videos.js

@@ -17,19 +17,19 @@ export function registerVideosCommand(program) {
         // Don't silence logs for commands that don't have explicit output format control
         const outputFormat = command && command.optsWithGlobals ? getOutputFormat(command) : "table";
         const silent = outputFormat === "json" && !opts.verbose;
-        const log = createLogger(opts.verbose, silent);
+        const log = createLogger(opts.verbose, silent, outputFormat);
         const baseDir = getBaseDir();
         const sessionPath = path.resolve(baseDir, ".auth", "storage-state.json");
         // Check if session exists
         if (!fs.existsSync(sessionPath)) {
-            log.error("未找到登入 session。請先執行 'openape auth login' 進行登入。");
+            console.error("未找到登入 session。請先執行 'openape login' 進行登入。");
             log.info(`Session 預期位置: ${sessionPath}`);
             return null;
         }
         // Try to load WS token
         const wsToken = loadWsToken(sessionPath);
         if (!wsToken) {
-            log.error("未找到 WS token。請先執行 'openape auth login' 進行登入。");
+            console.error("未找到 WS token。請先執行 'openape login' 進行登入。");
             return null;
         }
         return {
@@ -45,11 +45,11 @@ export function registerVideosCommand(program) {
         const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
         const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
         const silent = outputFormat === "json" && !opts.verbose;
-        const log = createLogger(opts.verbose, silent);
+        const log = createLogger(opts.verbose, silent, outputFormat);
         const baseDir = getBaseDir();
         const sessionPath = path.resolve(baseDir, ".auth", "storage-state.json");
         if (!fs.existsSync(sessionPath)) {
-            log.error("未找到登入 session。請先執行 'openape auth login' 進行登入。");
+            console.error("未找到登入 session。請先執行 'openape login' 進行登入。");
             return null;
         }
         const config = {
@@ -316,7 +316,7 @@ export function registerVideosCommand(program) {
             const completed = downloaded.filter(d => d.success).length;
             const failed = downloaded.filter(d => !d.success).length;
             log.info(`\n執行結果: ${completed} 成功, ${failed} 失敗`);
-            const output = {
+            console.log(JSON.stringify({
                 status: "success",
                 timestamp: new Date().toISOString(),
                 course_id: courseId,
@@ -324,9 +324,10 @@ export function registerVideosCommand(program) {
                 total_videos: videos.length,
                 downloaded: completed,
                 failed,
-                videos: downloaded,
-            };
-            console.log(JSON.stringify(output));
+            }));
+            for (const v of downloaded) {
+                console.log(JSON.stringify(v));
+            }
         }
         finally {
             await closeBrowserSafely(browser, browserContext);

package/esm/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;AAoEnF;;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,CAmBN;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;;;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"}

package/esm/src/index.js

@@ -18,6 +18,8 @@ import { registerForumsCommand } from "./commands/forums.js";
 import { registerAnnouncementsCommand } from "./commands/announcements.js";
 import { registerCalendarCommand } from "./commands/calendar.js";
 import { registerSkillsCommand } from "./commands/skills.js";
+import { registerAssignmentsCommand } from "./commands/assignments.js";
+import { registerUploadCommand } from "./commands/upload.js";
 const program = new Command();
 program
     .name("openape")
@@ -42,6 +44,8 @@ registerForumsCommand(program);
 registerAnnouncementsCommand(program);
 registerCalendarCommand(program);
 registerSkillsCommand(program);
+registerAssignmentsCommand(program);
+registerUploadCommand(program);
 /**
  * Load configuration and authenticate, returning the context for commands.
  */
@@ -84,7 +88,14 @@ export async function createSessionContext(options) {
  */
 export function formatAndOutput(data, format, log) {
     if (format === "json") {
-        console.log(JSON.stringify(data));
+        if (Array.isArray(data)) {
+            for (const item of data) {
+                console.log(JSON.stringify(item));
+            }
+        }
+        else {
+            console.log(JSON.stringify(data));
+        }
         // Exit immediately for AI agent - no need to wait for browser cleanup
         process.exit(0);
     }

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

@@ -1,5 +1,5 @@
 import { type Browser, type BrowserContext, type Page } from "playwright-core";
-import type { AppConfig, Logger } from "./types.js";
+import type { AppConfig, Logger, OutputFormat } from "./types.js";
 /**
  * Find a Chromium-based browser executable on Windows.
  * Priority: Edge → Chrome → Brave
@@ -20,6 +20,28 @@ export declare function launchAuthenticated(config: AppConfig, log: Logger): Pro
  * Safely close browser and context with timeout.
  * Designed for AI agent usage - no human interaction needed.
  * If noWait is true, initiates cleanup but doesn't wait for completion.
+ *
+ * Note: Closes sequentially (context first, then browser) to avoid libuv
+ * assertion failures on Windows when handles are closed concurrently.
  */
 export declare function closeBrowserSafely(browser: Browser, context?: BrowserContext, timeoutMs?: number, noWait?: boolean): Promise<void>;
+/**
+ * Create API context for WS token operations (no browser required).
+ * Returns null if session is invalid or WS token is missing.
+ */
+export declare function createApiContext(options: {
+    verbose?: boolean;
+    headed?: boolean;
+}, command?: {
+    optsWithGlobals(): {
+        output?: OutputFormat;
+        verbose?: boolean;
+    };
+}): Promise<{
+    log: Logger;
+    session: {
+        wsToken: string;
+        moodleBaseUrl: string;
+    };
+} | null>;
 //# sourceMappingURL=auth.d.ts.map

package/esm/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,MAAM,YAAY,CAAC;AAGpD;;;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;;;;GAIG;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,CA4Bf"}
+{"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"}

package/esm/src/lib/auth.js

@@ -88,17 +88,20 @@ export async function launchAuthenticated(config, log) {
  * Safely close browser and context with timeout.
  * Designed for AI agent usage - no human interaction needed.
  * If noWait is true, initiates cleanup but doesn't wait for completion.
+ *
+ * Note: Closes sequentially (context first, then browser) to avoid libuv
+ * assertion failures on Windows when handles are closed concurrently.
  */
 export async function closeBrowserSafely(browser, context, timeoutMs = 5000, noWait = false) {
     const closePromises = [];
-    // Close context with error handling
+    // Close context first with error handling
     if (context) {
         closePromises.push(Promise.race([
             context.close().catch(() => { }),
             new Promise(resolve => setTimeout(() => resolve(), timeoutMs))
         ]));
     }
-    // Close browser with error handling
+    // Close browser after context with error handling
     closePromises.push(Promise.race([
         browser.close().catch(() => { }),
         new Promise(resolve => setTimeout(() => resolve(), timeoutMs))
@@ -108,7 +111,10 @@ export async function closeBrowserSafely(browser, context, timeoutMs = 5000, noW
         Promise.allSettled(closePromises);
         return;
     }
-    await Promise.allSettled(closePromises);
+    // Wait sequentially to avoid libuv issues on Windows
+    for (const promise of closePromises) {
+        await promise.catch(() => { });
+    }
 }
 /**
  * Attempt to restore a session from stored state.
@@ -192,3 +198,30 @@ async function login(page, config, log) {
     }
     log.success("Login completed successfully.");
 }
+/**
+ * Create API context for WS token operations (no browser required).
+ * Returns null if session is invalid or WS token is missing.
+ */
+export async function createApiContext(options, command) {
+    const { createLogger } = await import("./logger.js");
+    const { loadWsToken } = await import("./token.js");
+    const { getOutputFormat, getSessionPath } = await import("./utils.js");
+    const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
+    const outputFormat = command ? 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);
+    if (!wsToken) {
+        console.error("未找到 WS token。請先執行 'openape login' 進行登入。");
+        return null;
+    }
+    return {
+        log,
+        session: {
+            wsToken,
+            moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+        },
+    };
+}

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

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

package/esm/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,GAAG,MAAM,CAoBpE"}
+{"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"}