@mo7yw4ng/openape 1.0.3 → 1.0.5

package/esm/src/commands/forums.js

@@ -1,5 +1,5 @@
-import { getBaseDir, stripHtmlTags } from "../lib/utils.js";
-import { getEnrolledCoursesApi, getForumsApi, getForumDiscussionsApi, getDiscussionPostsApi } from "../lib/moodle.js";
+import { getBaseDir, stripHtmlTags, getOutputFormat, formatTimestamp } from "../lib/utils.js";
+import { getEnrolledCoursesApi, getForumsApi, getForumDiscussionsApi, getDiscussionPostsApi, addForumDiscussionApi, addForumPostApi, deleteForumPostApi } from "../lib/moodle.js";
 import { createLogger } from "../lib/logger.js";
 import { loadWsToken, loadSesskey } from "../lib/token.js";
 import path from "node:path";
@@ -7,28 +7,24 @@ import fs from "node:fs";
 export function registerForumsCommand(program) {
     const forumsCmd = program.command("forums");
     forumsCmd.description("Forum 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 = 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;
         }
         // Try to load sesskey from cache
@@ -65,6 +61,7 @@ export function registerForumsCommand(program) {
                 allForums.push({
                     course_id: wsForum.courseid,
                     course_name: course.fullname,
+                    intro: wsForum.intro,
                     cmid: wsForum.cmid.toString(),
                     forum_id: wsForum.id,
                     name: wsForum.name,
@@ -73,16 +70,15 @@ export function registerForumsCommand(program) {
                 });
             }
         }
-        const result = {
+        console.log(JSON.stringify({
             status: "success",
             timestamp: new Date().toISOString(),
-            forums: allForums,
-            summary: {
-                total_courses: courses.length,
-                total_forums: allForums.length,
-            },
-        };
-        console.log(JSON.stringify(result));
+            total_courses: courses.length,
+            total_forums: allForums.length,
+        }));
+        for (const forum of allForums) {
+            console.log(JSON.stringify(forum));
+        }
     });
     forumsCmd
         .command("list-all")
@@ -109,6 +105,7 @@ export function registerForumsCommand(program) {
                 allForums.push({
                     course_id: wsForum.courseid,
                     course_name: course.fullname,
+                    intro: wsForum.intro,
                     cmid: wsForum.cmid.toString(),
                     forum_id: wsForum.id,
                     name: wsForum.name,
@@ -116,16 +113,15 @@ export function registerForumsCommand(program) {
                 });
             }
         }
-        const result = {
+        console.log(JSON.stringify({
             status: "success",
             timestamp: new Date().toISOString(),
-            forums: allForums,
-            summary: {
-                total_courses: courses.length,
-                total_forums: allForums.length,
-            },
-        };
-        console.log(JSON.stringify(result));
+            total_courses: courses.length,
+            total_forums: allForums.length,
+        }));
+        for (const forum of allForums) {
+            console.log(JSON.stringify(forum));
+        }
     });
     forumsCmd
         .command("discussions")
@@ -155,27 +151,29 @@ export function registerForumsCommand(program) {
         const course = courses.find(c => c.id === targetForum.courseid);
         // Get discussions via WS API
         const discussions = await getForumDiscussionsApi(apiContext.session, targetForum.id);
-        const result = {
+        // Output NDJSON: one line per discussion entry for stream-friendly parsing
+        const meta = {
             status: "success",
             timestamp: new Date().toISOString(),
             forum_id: targetForum.id,
             forum_name: targetForum.name,
+            forum_intro: targetForum.intro,
             course_id: course?.id,
             course_name: course?.fullname,
-            discussions: discussions.map(d => ({
+            total_discussions: discussions.length,
+        };
+        console.log(JSON.stringify(meta));
+        for (const d of discussions) {
+            console.log(JSON.stringify({
                 id: d.id,
                 name: d.name,
                 user_id: d.userId,
                 time_modified: d.timeModified,
                 post_count: d.postCount,
                 unread: d.unread,
-                message: (stripHtmlTags(d.message || "")).substring(0, 250) + "...",
-            })),
-            summary: {
-                total_discussions: discussions.length,
-            },
-        };
-        console.log(JSON.stringify(result));
+                message: stripHtmlTags(d.message || ""),
+            }));
+        }
     });
     forumsCmd
         .command("posts")
@@ -200,8 +198,8 @@ export function registerForumsCommand(program) {
                     subject: p.subject,
                     author: p.author,
                     author_id: p.authorId,
-                    created: new Date(p.created * 1000).toISOString(),
-                    modified: new Date(p.modified * 1000).toISOString(),
+                    created: formatTimestamp(p.created),
+                    modified: formatTimestamp(p.modified),
                     message: p.message,
                     unread: p.unread,
                 })),
@@ -223,4 +221,98 @@ export function registerForumsCommand(program) {
             console.table(tablePosts);
         }
     });
+    forumsCmd
+        .command("post")
+        .description("Post a new discussion to a forum")
+        .argument("<forum-id>", "Forum ID")
+        .argument("<subject>", "Discussion subject")
+        .argument("<message>", "Discussion message")
+        .option("--subscribe", "Subscribe to the discussion", false)
+        .option("--pin", "Pin the discussion", false)
+        .action(async (forumId, subject, message, options, command) => {
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, session } = apiContext;
+        // Get courses to find the forum
+        const courses = await getEnrolledCoursesApi(session, {
+            classification: "inprogress",
+        });
+        const courseIds = courses.map(c => c.id);
+        const wsForums = await getForumsApi(session, courseIds);
+        // Find forum by cmid or instance ID
+        const targetForum = wsForums.find(f => f.cmid.toString() === forumId || f.id === parseInt(forumId, 10));
+        if (!targetForum) {
+            log.error(`Forum not found: ${forumId}`);
+            process.exitCode = 1;
+            return;
+        }
+        const course = courses.find(c => c.id === targetForum.courseid);
+        log.info(`Posting to forum: ${targetForum.name} (${course?.fullname})`);
+        const result = await addForumDiscussionApi(session, targetForum.id, subject, message);
+        if (result.success) {
+            log.success(`✓ Discussion posted successfully!`);
+            log.info(`  Discussion ID: ${result.discussionId}`);
+        }
+        else {
+            log.error(`✗ Failed to post discussion: ${result.error}`);
+            process.exitCode = 1;
+        }
+    });
+    forumsCmd
+        .command("reply")
+        .description("Reply to a discussion post")
+        .argument("<post-id>", "Parent post ID to reply to")
+        .argument("<subject>", "Reply subject")
+        .argument("<message>", "Reply message")
+        .option("--attachment-id <id>", "Draft file ID for attachment")
+        .option("--inline-attachment-id <id>", "Draft file ID for inline attachment")
+        .action(async (postId, subject, message, options, command) => {
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, session } = apiContext;
+        log.info(`Replying to post: ${postId}`);
+        log.info(`  Subject: ${subject}`);
+        log.info(`  Message: ${message}`);
+        if (options.attachmentId) {
+            log.info(`  Attachment ID: ${options.attachmentId}`);
+        }
+        const result = await addForumPostApi(session, parseInt(postId, 10), subject, message, {
+            attachmentId: options.attachmentId ? parseInt(options.attachmentId, 10) : undefined,
+            inlineAttachmentId: options.inlineAttachmentId ? parseInt(options.inlineAttachmentId, 10) : undefined,
+        });
+        if (result.success) {
+            log.success(`✓ Reply posted successfully!`);
+            log.info(`  Post ID: ${result.postId}`);
+        }
+        else {
+            log.error(`✗ Failed to post reply: ${result.error}`);
+            process.exitCode = 1;
+        }
+    });
+    forumsCmd
+        .command("delete")
+        .description("Delete a forum post or discussion (by post ID)")
+        .argument("<post-id>", "Post ID to delete (deletes entire discussion if it's the first post)")
+        .action(async (postId, options, command) => {
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, session } = apiContext;
+        const result = await deleteForumPostApi(session, parseInt(postId, 10));
+        if (result.success) {
+            log.success(`✓ Post ${postId} deleted successfully!`);
+        }
+        else {
+            log.error(`✗ Failed to delete post: ${result.error}`);
+            process.exitCode = 1;
+        }
+    });
 }

package/esm/src/commands/grades.js

@@ -17,19 +17,19 @@ export function registerGradesCommand(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' 進行登入。");
+            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 {

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

@@ -1 +1 @@
-{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../../src/src/commands/materials.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgCpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqlB/D"}
+{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../../src/src/commands/materials.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAid/D"}