@mo7yw4ng/openape 1.0.1 → 1.0.3

package/README.md

@@ -1,4 +1,7 @@
-# OpenApe CLI (Unofficial)
+<h1 align="center">
+  <img src="assets/logo.svg" width="150" /><br/>
+  OpenApe CLI (Unofficial)
+</h1>
 
 中原大學 [i-Learning](https://ilearning.cycu.edu.tw/) (Moodle) 平台自動化命令列工具 (CLI)，幫助你快速查詢課程、觀看影片、下載教材。
 
@@ -6,7 +9,7 @@
 - 📚 **課程資訊**：列出修課清單、成績、課程大綱與進度。
 - 📺 **影片輔助**：列出/下載影片，甚至自動標記為已觀看。
 - 📝 **測驗與教材**：快速查看測驗、下載教材。
-- 💬 **討論區與公告**：在終端機直接閱讀公告與討論區。
+- 💬 **討論區與公告**：閱讀公告與討論區。
 - 📅 **行事曆**：內建行事曆事件查詢與匯出。
 - 🤖 **Agent Skills**：提供 Claude Code 等 Skills 工作流支援。
 
@@ -33,8 +36,8 @@ deno install -A -g -n openape jsr:@openape/openape
 第一次使用需要登入，會開啟瀏覽器讓你手動完成登入，隨後會快取 Session 供未來使用。
 ```bash
 openape login          # 登入並儲存 session (開啟瀏覽器)
-openape auth status    # 檢查當前登入狀態
-openape auth logout    # 登出並清除 session
+openape status         # 檢查當前登入狀態
+openape logout         # 登出並清除 session
 ```
 
 ### 課程 (Courses)
@@ -42,7 +45,7 @@ openape auth logout    # 登出並清除 session
 openape courses list               # 列出所有課程 (支援 --incomplete-only, --level)
 openape courses info <id>          # 顯示特定課程的詳細資訊
 openape courses progress <id>      # 顯示特定課程的進度
-openape courses syllabus <id>      # 顯示課程大綱 (從 CMAP 取得)
+openape courses syllabus <id>      # 顯示課程大綱
 ```
 
 ### 影片 (Videos)

package/esm/_dnt.polyfills.d.ts

@@ -1,5 +1,49 @@
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+import { createRequire } from "node:module";
+import { type URL } from "node:url";
 declare global {
     interface ImportMeta {
+        /** A string representation of the fully qualified module URL. When the
+         * module is loaded locally, the value will be a file URL (e.g.
+         * `file:///path/module.ts`).
+         *
+         * You can also parse the string as a URL to determine more information about
+         * how the current module was loaded. For example to determine if a module was
+         * local or not:
+         *
+         * ```ts
+         * const url = new URL(import.meta.url);
+         * if (url.protocol === "file:") {
+         *   console.log("this module was loaded locally");
+         * }
+         * ```
+         */
+        url: string;
+        /**
+         * A function that returns resolved specifier as if it would be imported
+         * using `import(specifier)`.
+         *
+         * ```ts
+         * console.log(import.meta.resolve("./foo.js"));
+         * // file:///dev/foo.js
+         * ```
+         *
+         * @param specifier The module specifier to resolve relative to `parent`.
+         * @param parent The absolute parent module URL to resolve from.
+         * @returns The absolute (`file:`) URL string for the resolved module.
+         */
+        resolve(specifier: string, parent?: string | URL | undefined): string;
         /** A flag that indicates if the current module is the main module that was
          * called when starting the program under Deno.
          *
@@ -10,15 +54,48 @@ declare global {
          * ```
          */
         main: boolean;
-        /** A function that returns resolved specifier as if it would be imported
-         * using `import(specifier)`.
+        /** The absolute path of the current module.
          *
-         * ```ts
-         * console.log(import.meta.resolve("./foo.js"));
-         * // file:///dev/foo.js
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.filename); // /home/alice/my_module.ts
+         *
+         * // Windows
+         * console.log(import.meta.filename); // C:\alice\my_module.ts
          * ```
          */
-        resolve(specifier: string): string;
+        filename: string;
+        /** The absolute path of the directory containing the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.dirname); // /home/alice
+         *
+         * // Windows
+         * console.log(import.meta.dirname); // C:\alice
+         * ```
+         */
+        dirname: string;
     }
 }
+type NodeRequest = ReturnType<typeof createRequire>;
+type NodeModule = NonNullable<NodeRequest["main"]>;
+interface ImportMetaPonyfillCommonjs {
+    (require: NodeRequest, module: NodeModule): ImportMeta;
+}
+interface ImportMetaPonyfillEsmodule {
+    (importMeta: ImportMeta): ImportMeta;
+}
+interface ImportMetaPonyfill extends ImportMetaPonyfillCommonjs, ImportMetaPonyfillEsmodule {
+}
+export declare let import_meta_ponyfill_commonjs: ImportMetaPonyfillCommonjs;
+export declare let import_meta_ponyfill_esmodule: ImportMetaPonyfillEsmodule;
+export declare let import_meta_ponyfill: ImportMetaPonyfill;
 export {};
+//# sourceMappingURL=_dnt.polyfills.d.ts.map

package/esm/_dnt.polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAgC,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB;;;;;;;;;;;;;;WAcG;QACH,GAAG,EAAE,MAAM,CAAC;QACZ;;;;;;;;;;;;WAYG;QACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,GAAG,MAAM,CAAC;QACtE;;;;;;;;WAQG;QACH,IAAI,EAAE,OAAO,CAAC;QAEd;;;;;;;;;;;;WAYG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;;;;;;;;;;WAYG;QACH,OAAO,EAAE,MAAM,CAAC;KACjB;CACF;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,KAAK,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,UAAU,0BAA0B;IAClC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACxD;AACD,UAAU,0BAA0B;IAClC,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;CACtC;AACD,UAAU,kBACR,SAAQ,0BAA0B,EAAE,0BAA0B;CAC/D;AAiBD,eAAO,IAAI,6BAA6B,EA2BnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,6BAA6B,EA4DnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,oBAAoB,EAoB1B,kBAAkB,CAAC"}

package/esm/_dnt.polyfills.js

@@ -1 +1,127 @@
-export {};
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+//@ts-ignore
+import { createRequire } from "node:module";
+//@ts-ignore
+import { fileURLToPath, pathToFileURL } from "node:url";
+//@ts-ignore
+import { dirname } from "node:path";
+const defineGlobalPonyfill = (symbolFor, fn) => {
+    if (!Reflect.has(globalThis, Symbol.for(symbolFor))) {
+        Object.defineProperty(globalThis, Symbol.for(symbolFor), {
+            configurable: true,
+            get() {
+                return fn;
+            },
+        });
+    }
+};
+export let import_meta_ponyfill_commonjs = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-commonjs")) ??
+    (() => {
+        const moduleImportMetaWM = new WeakMap();
+        return (require, module) => {
+            let importMetaCache = moduleImportMetaWM.get(module);
+            if (importMetaCache == null) {
+                const importMeta = Object.assign(Object.create(null), {
+                    url: pathToFileURL(module.filename).href,
+                    main: require.main == module,
+                    resolve: (specifier, parentURL = importMeta.url) => {
+                        return pathToFileURL((importMeta.url === parentURL
+                            ? require
+                            : createRequire(parentURL))
+                            .resolve(specifier)).href;
+                    },
+                    filename: module.filename,
+                    dirname: module.path,
+                });
+                moduleImportMetaWM.set(module, importMeta);
+                importMetaCache = importMeta;
+            }
+            return importMetaCache;
+        };
+    })());
+defineGlobalPonyfill("import-meta-ponyfill-commonjs", import_meta_ponyfill_commonjs);
+export let import_meta_ponyfill_esmodule = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-esmodule")) ??
+    ((importMeta) => {
+        const resolveFunStr = String(importMeta.resolve);
+        const shimWs = new WeakSet();
+        //@ts-ignore
+        const mainUrl = ("file:///" + process.argv[1].replace(/\\/g, "/"))
+            .replace(/\/{3,}/, "///");
+        const commonShim = (importMeta) => {
+            if (typeof importMeta.main !== "boolean") {
+                importMeta.main = importMeta.url === mainUrl;
+            }
+            if (typeof importMeta.filename !== "string") {
+                importMeta.filename = fileURLToPath(importMeta.url);
+                importMeta.dirname = dirname(importMeta.filename);
+            }
+        };
+        if (
+        // v16.2.0+, v14.18.0+: Add support for WHATWG URL object to parentURL parameter.
+        resolveFunStr === "undefined" ||
+            // v20.0.0+, v18.19.0+"" This API now returns a string synchronously instead of a Promise.
+            resolveFunStr.startsWith("async")
+        // enable by --experimental-import-meta-resolve flag
+        ) {
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    const importMetaUrlRequire = {
+                        url: importMeta.url,
+                        require: createRequire(importMeta.url),
+                    };
+                    importMeta.resolve = function resolve(specifier, parentURL = importMeta.url) {
+                        return pathToFileURL((importMetaUrlRequire.url === parentURL
+                            ? importMetaUrlRequire.require
+                            : createRequire(parentURL)).resolve(specifier)).href;
+                    };
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        else {
+            /// native support
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        return import_meta_ponyfill_esmodule(importMeta);
+    }));
+defineGlobalPonyfill("import-meta-ponyfill-esmodule", import_meta_ponyfill_esmodule);
+export let import_meta_ponyfill = ((...args) => {
+    const _MODULE = (() => {
+        if (typeof require === "function" && typeof module === "object") {
+            return "commonjs";
+        }
+        else {
+            // eval("typeof import.meta");
+            return "esmodule";
+        }
+    })();
+    if (_MODULE === "commonjs") {
+        //@ts-ignore
+        import_meta_ponyfill = (r, m) => import_meta_ponyfill_commonjs(r, m);
+    }
+    else {
+        //@ts-ignore
+        import_meta_ponyfill = (im) => import_meta_ponyfill_esmodule(im);
+    }
+    //@ts-ignore
+    return import_meta_ponyfill(...args);
+});

package/esm/_dnt.shims.d.ts

@@ -3,3 +3,4 @@ export { Deno } from "@deno/shim-deno";
 export declare const dntGlobalThis: Omit<typeof globalThis, "Deno"> & {
     Deno: typeof Deno;
 };
+//# sourceMappingURL=_dnt.shims.d.ts.map

package/esm/_dnt.shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKvC,eAAO,MAAM,aAAa;;CAA2C,CAAC"}

package/esm/deno.d.ts

@@ -10,6 +10,7 @@ declare namespace _default {
         "build:npm": string;
     };
     let imports: {
+        "@deno/dnt": string;
         commander: string;
         "playwright-core": string;
         "node-html-parser": string;
@@ -21,3 +22,4 @@ declare namespace _default {
     let unstable: string[];
 }
 export default _default;
+//# sourceMappingURL=deno.d.ts.map

package/esm/deno.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deno.d.ts","sourceRoot":"","sources":["../src/deno.js"],"names":[],"mappings":""}

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "@openape/openape",
-    "version": "1.0.1",
+    "version": "1.0.3",
     "description": "CLI tool for CYCU i-Learning platform",
     "license": "MIT",
     "exports": "./src/index.ts",
@@ -10,6 +10,7 @@ export default {
         "build:npm": "deno run -A src/build_npm.ts"
     },
     "imports": {
+        "@deno/dnt": "jsr:@deno/dnt@^0.42.3",
         "commander": "npm:commander@^12.1.0",
         "playwright-core": "npm:playwright-core@^1.48.0",
         "node-html-parser": "npm:node-html-parser@^6.1.13"

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"announcements.d.ts","sourceRoot":"","sources":["../../../src/src/commands/announcements.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqJnE"}

package/esm/src/commands/announcements.js

@@ -0,0 +1,135 @@
+import { getBaseDir } from "../lib/utils.js";
+import { getSiteInfoApi, getMessagesApi, getDiscussionPostsApi } from "../lib/moodle.js";
+import { createLogger } from "../lib/logger.js";
+import { loadWsToken } from "../lib/token.js";
+import path from "node:path";
+import fs from "node:fs";
+export 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 = createLogger(opts.verbose, silent);
+        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.info(`Session 預期位置: ${sessionPath}`);
+            return null;
+        }
+        // Try to load WS token
+        const wsToken = loadWsToken(sessionPath);
+        if (!wsToken) {
+            log.error("未找到 WS token。請先執行 'openape auth login' 進行登入。");
+            return null;
+        }
+        return {
+            log,
+            session: {
+                wsToken,
+                moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+            },
+        };
+    }
+    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);
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        // Get site info to retrieve userid
+        const siteInfo = await getSiteInfoApi(apiContext.session);
+        // Get messages for the current user
+        const messages = await getMessagesApi(apiContext.session, siteInfo.userid, {
+            limitnum: limit,
+        });
+        // Convert messages to announcement format
+        const allAnnouncements = messages.map(m => ({
+            course_id: 0, // Messages don't have courseId
+            course_name: "Notifications",
+            id: m.id,
+            subject: m.subject,
+            author: `User ${m.useridfrom}`,
+            authorId: m.useridfrom,
+            createdAt: m.timecreated,
+            modifiedAt: m.timecreated,
+            unread: false, // Messages API doesn't provide unread status
+            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));
+    });
+    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 apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        const posts = await getDiscussionPostsApi(apiContext.session, parseInt(announcementId, 10));
+        if (posts.length === 0) {
+            apiContext.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));
+    });
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/src/commands/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoQtD"}