nworks 0.3.2 → 0.4.0

package/README.md

@@ -26,7 +26,7 @@ nworks login \
   --bot-id <BOT_ID>
 
 # User OAuth 로그인 (캘린더, 드라이브 등 사용자 API용)
-nworks login --user --scope calendar.read,file
+nworks login --user --scope calendar.read,file,mail
 
 # 인증 확인
 nworks whoami
@@ -45,6 +45,12 @@ nworks drive list
 
 # 파일 업로드
 nworks drive upload --file ./report.pdf
+
+# 메일 전송
+nworks mail send --to "user@example.com" --subject "제목" --body "내용"
+
+# 받은편지함 조회
+nworks mail list
 ```
 
 ## CLI Commands
@@ -131,6 +137,27 @@ nworks drive download --file-id <fileId> --out ./downloads --name report.pdf
 
 > **Note**: 드라이브 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope file`을 실행하세요. 읽기만 필요하면 `file.read` scope로 충분합니다.
 
+### 메일 (User OAuth 필요)
+
+```bash
+# 메일 전송
+nworks mail send --to "user@example.com" --subject "제목" --body "내용"
+
+# CC/BCC 포함
+nworks mail send --to "user@example.com" --cc "cc@example.com" --subject "제목" --body "내용"
+
+# 받은편지함 목록
+nworks mail list
+
+# 읽지 않은 메일만
+nworks mail list --unread
+
+# 메일 상세 조회
+nworks mail read --id <mailId>
+```
+
+> **Note**: 메일 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope mail`을 실행하세요. 읽기만 필요하면 `mail.read` scope로 충분합니다.
+
 ### MCP 서버
 
 ```bash
@@ -172,6 +199,8 @@ nworks mcp --list-tools # 등록된 tool 목록
 | `calendar.read` | 캘린더 일정 조회 | User OAuth | `calendar list` |
 | `file` | 드라이브 읽기/쓰기 | User OAuth | `drive list/upload/download` |
 | `file.read` | 드라이브 읽기 전용 | User OAuth | `drive list/download` |
+| `mail` | 메일 읽기/쓰기 | User OAuth | `mail send/list/read` |
+| `mail.read` | 메일 읽기 전용 | User OAuth | `mail list/read` |
 
 > **Tip**: scope를 변경한 후에는 토큰을 재발급해야 합니다.
 > ```bash
@@ -225,7 +254,10 @@ NWORKS_VERBOSE=1           # optional, 디버그 로깅
 - ~~**v0.1** — 메시지, 조직 구성원, MCP 서버~~
 - ~~**v0.2** — 캘린더 일정 조회 + User OAuth~~
 - ~~**v0.3** — 드라이브 파일 조회/업로드/다운로드 (`nworks drive`)~~
-- **v0.4** — 게시판, 메일 (`nworks board`, `nworks mail`)
+- ~~**v0.4** — 메일 (`nworks mail send/list/read`)~~
+- **v0.5** — 할 일 (`nworks task list/create/update/delete`)
+- **v0.6** — 캘린더 쓰기 (`nworks calendar create/update/delete`)
+- **v0.7** — 게시판 (`nworks board list/post/read`)
 
 ## License
 

package/dist/index.js

@@ -7,7 +7,7 @@ var __export = (target, all) => {
 
 // src/index.ts
 import { createRequire } from "module";
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 
 // src/commands/login.ts
 import { Command } from "commander";
@@ -1100,9 +1100,185 @@ var downloadCommand = new Command7("download").description("Download a file from
 });
 var driveCommand = new Command7("drive").description("Drive operations (requires User OAuth with file scope)").addCommand(listCommand2).addCommand(uploadCommand).addCommand(downloadCommand);
 
-// src/commands/mcp-cmd.ts
+// src/commands/mail.ts
 import { Command as Command8 } from "commander";
 
+// src/api/mail.ts
+var BASE_URL4 = "https://www.worksapis.com/v1.0";
+async function authedFetch2(url2, init, profile) {
+  const token = await getValidUserToken(profile);
+  const headers = new Headers(init.headers);
+  headers.set("Authorization", `Bearer ${token}`);
+  return fetch(url2, { ...init, headers });
+}
+async function handleError2(res) {
+  if (res.status === 401) {
+    throw new AuthError("User token expired. Run `nworks login --user --scope mail` again.");
+  }
+  let code = "UNKNOWN";
+  let description = `HTTP ${res.status}`;
+  try {
+    const body = await res.json();
+    code = body.code ?? code;
+    description = body.description ?? description;
+  } catch {
+  }
+  throw new ApiError(code, description, res.status);
+}
+async function sendMail(opts) {
+  const userId = opts.userId ?? "me";
+  const profile = opts.profile ?? "default";
+  const url2 = `${BASE_URL4}/users/${userId}/mail`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] POST ${url2}`);
+  }
+  const body = {
+    to: opts.to,
+    subject: opts.subject
+  };
+  if (opts.body !== void 0) body.body = opts.body;
+  if (opts.cc) body.cc = opts.cc;
+  if (opts.bcc) body.bcc = opts.bcc;
+  if (opts.contentType) body.contentType = opts.contentType;
+  const res = await authedFetch2(
+    url2,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    },
+    profile
+  );
+  if (res.status === 202) return;
+  if (!res.ok) return handleError2(res);
+}
+async function listMails(folderId = 0, userId = "me", count = 30, cursor, isUnread, profile = "default") {
+  const params = new URLSearchParams();
+  params.set("count", String(count));
+  if (cursor) params.set("cursor", cursor);
+  if (isUnread) params.set("isUnread", "true");
+  const url2 = `${BASE_URL4}/users/${userId}/mail/mailfolders/${folderId}/children?${params.toString()}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url2}`);
+  }
+  const res = await authedFetch2(url2, { method: "GET" }, profile);
+  if (!res.ok) return handleError2(res);
+  const data = await res.json();
+  return {
+    mails: data.mails ?? [],
+    unreadCount: data.unreadCount,
+    folderName: data.folderName,
+    totalCount: data.totalCount,
+    responseMetaData: data.responseMetaData
+  };
+}
+async function readMail(mailId, userId = "me", profile = "default") {
+  const url2 = `${BASE_URL4}/users/${userId}/mail/${mailId}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url2}`);
+  }
+  const res = await authedFetch2(url2, { method: "GET" }, profile);
+  if (!res.ok) return handleError2(res);
+  return await res.json();
+}
+
+// src/commands/mail.ts
+var sendCommand2 = new Command8("send").description("Send a mail (requires User OAuth with mail scope)").requiredOption("--to <emails>", "Recipient email addresses (separate with ;)").requiredOption("--subject <subject>", "Mail subject").option("--body <body>", "Mail body content").option("--cc <emails>", "CC email addresses (separate with ;)").option("--bcc <emails>", "BCC email addresses (separate with ;)").option("--content-type <type>", "Body format: html or text", "html").option("--user <userId>", "Sender user ID (default: me)").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").option("--dry-run", "Print request without sending").action(async (opts) => {
+  try {
+    const sendOpts = {
+      to: opts.to,
+      subject: opts.subject,
+      body: opts.body,
+      cc: opts.cc,
+      bcc: opts.bcc,
+      contentType: opts.contentType,
+      userId: opts.user ?? "me",
+      profile: opts.profile
+    };
+    if (opts.dryRun) {
+      output({ dryRun: true, request: sendOpts }, opts);
+      return;
+    }
+    await sendMail(sendOpts);
+    output({ success: true, message: "Mail sent (async)" }, opts);
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var listCommand3 = new Command8("list").description("List mails in a folder (requires User OAuth with mail or mail.read scope)").option("--folder <folderId>", "Folder ID (default: 0 = inbox)", "0").option("--count <n>", "Items per page (default: 30)", "30").option("--cursor <cursor>", "Pagination cursor").option("--unread", "Show unread mails only", false).option("--user <userId>", "Target user ID (default: me)").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const result = await listMails(
+      parseInt(opts.folder, 10),
+      opts.user ?? "me",
+      parseInt(opts.count, 10),
+      opts.cursor,
+      opts.unread,
+      opts.profile
+    );
+    const mails = result.mails.map((m) => ({
+      mailId: m.mailId,
+      from: m.from.email,
+      subject: m.subject,
+      date: m.receivedTime,
+      status: m.status,
+      attachments: m.attachCount ?? 0
+    }));
+    output(
+      {
+        mails,
+        count: mails.length,
+        totalCount: result.totalCount,
+        unreadCount: result.unreadCount,
+        folderName: result.folderName,
+        nextCursor: result.responseMetaData?.nextCursor ?? null
+      },
+      opts
+    );
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var readCommand = new Command8("read").description("Read a specific mail (requires User OAuth with mail or mail.read scope)").requiredOption("--id <mailId>", "Mail ID").option("--user <userId>", "Target user ID (default: me)").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const result = await readMail(
+      parseInt(opts.id, 10),
+      opts.user ?? "me",
+      opts.profile
+    );
+    const mail = result.mail;
+    output(
+      {
+        mailId: mail.mailId,
+        from: mail.from,
+        to: mail.to,
+        cc: mail.cc ?? [],
+        subject: mail.subject,
+        body: mail.body,
+        date: mail.receivedTime,
+        attachments: result.attachments?.map((a) => ({
+          id: a.attachmentId,
+          filename: a.filename,
+          contentType: a.contentType,
+          size: a.size
+        })) ?? []
+      },
+      opts
+    );
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var mailCommand = new Command8("mail").description("Mail operations (requires User OAuth with mail scope)").addCommand(sendCommand2).addCommand(listCommand3).addCommand(readCommand);
+
+// src/commands/mcp-cmd.ts
+import { Command as Command9 } from "commander";
+
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -15079,27 +15255,154 @@ function registerTools(server) {
   );
   server.tool(
     "nworks_drive_download",
-    "\uB4DC\uB77C\uC774\uBE0C \uD30C\uC77C\uC744 \uB2E4\uC6B4\uB85C\uB4DC\uD569\uB2C8\uB2E4 (User OAuth file \uB610\uB294 file.read scope \uD544\uC694)",
+    "\uB4DC\uB77C\uC774\uBE0C \uD30C\uC77C\uC744 \uB2E4\uC6B4\uB85C\uB4DC\uD569\uB2C8\uB2E4 (User OAuth file \uB610\uB294 file.read scope \uD544\uC694). outputDir\uC744 \uC9C0\uC815\uD558\uBA74 \uB85C\uCEEC\uC5D0 \uD30C\uC77C\uB85C \uC800\uC7A5\uD558\uACE0, \uBBF8\uC9C0\uC815 \uC2DC \uD30C\uC77C \uB0B4\uC6A9\uC744 \uC9C1\uC811 \uBC18\uD658\uD569\uB2C8\uB2E4 (\uD14D\uC2A4\uD2B8 \uD30C\uC77C\uC740 text, \uBC14\uC774\uB108\uB9AC\uB294 base64).",
     {
       fileId: external_exports.string().describe("\uB2E4\uC6B4\uB85C\uB4DC\uD560 \uD30C\uC77C ID"),
-      outputDir: external_exports.string().optional().describe("\uC800\uC7A5 \uB514\uB809\uD1A0\uB9AC (\uBBF8\uC9C0\uC815 \uC2DC \uD604\uC7AC \uB514\uB809\uD1A0\uB9AC)"),
+      outputDir: external_exports.string().optional().describe("\uC800\uC7A5 \uB514\uB809\uD1A0\uB9AC (\uC9C0\uC815 \uC2DC \uD30C\uC77C\uB85C \uC800\uC7A5, \uBBF8\uC9C0\uC815 \uC2DC \uB0B4\uC6A9\uC744 \uC9C1\uC811 \uBC18\uD658)"),
       outputName: external_exports.string().optional().describe("\uC800\uC7A5 \uD30C\uC77C\uBA85 (\uBBF8\uC9C0\uC815 \uC2DC \uC6D0\uBCF8 \uD30C\uC77C\uBA85)"),
       userId: external_exports.string().optional().describe("\uB300\uC0C1 \uC0AC\uC6A9\uC790 ID (\uBBF8\uC9C0\uC815 \uC2DC me)")
     },
     async ({ fileId, outputDir, outputName, userId }) => {
       try {
-        const { writeFile: writeFile3 } = await import("fs/promises");
-        const { join: join3 } = await import("path");
         const result = await downloadFile(
           fileId,
           userId ?? "me"
         );
         const fileName = outputName ?? result.fileName ?? fileId;
-        const dir = outputDir ?? process.cwd();
-        const outPath = join3(dir, fileName);
-        await writeFile3(outPath, result.buffer);
+        if (outputDir) {
+          const { writeFile: writeFile3 } = await import("fs/promises");
+          const { join: join3 } = await import("path");
+          const outPath = join3(outputDir, fileName);
+          await writeFile3(outPath, result.buffer);
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, fileName, path: outPath, size: result.buffer.length }) }]
+          };
+        }
+        const textExtensions = /\.(txt|md|csv|json|xml|html|htm|css|js|ts|jsx|tsx|yaml|yml|toml|ini|cfg|conf|log|sh|bash|zsh|py|rb|java|go|rs|c|cpp|h|hpp|sql|graphql|env|gitignore|dockerignore|editorconfig)$/i;
+        const isText = textExtensions.test(fileName);
+        if (isText) {
+          const text = result.buffer.toString("utf-8");
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, fileName, size: result.buffer.length, encoding: "text", content: text }) }]
+          };
+        }
+        const base643 = result.buffer.toString("base64");
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true, fileName, size: result.buffer.length, encoding: "base64", content: base643 }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_mail_send",
+    "\uBA54\uC77C\uC744 \uC804\uC1A1\uD569\uB2C8\uB2E4 (User OAuth mail scope \uD544\uC694). \uBE44\uB3D9\uAE30 \uC804\uC1A1\uC73C\uB85C, \uC131\uACF5 \uC2DC 202 \uC751\uB2F5\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4.",
+    {
+      to: external_exports.string().describe("\uC218\uC2E0\uC790 \uC774\uBA54\uC77C (\uC5EC\uB7EC \uBA85\uC740 ; \uB85C \uAD6C\uBD84)"),
+      subject: external_exports.string().describe("\uBA54\uC77C \uC81C\uBAA9"),
+      body: external_exports.string().optional().describe("\uBA54\uC77C \uBCF8\uBB38"),
+      cc: external_exports.string().optional().describe("\uCC38\uC870 \uC774\uBA54\uC77C (\uC5EC\uB7EC \uBA85\uC740 ; \uB85C \uAD6C\uBD84)"),
+      bcc: external_exports.string().optional().describe("\uC228\uC740\uCC38\uC870 \uC774\uBA54\uC77C (\uC5EC\uB7EC \uBA85\uC740 ; \uB85C \uAD6C\uBD84)"),
+      contentType: external_exports.enum(["html", "text"]).optional().describe("\uBCF8\uBB38 \uD615\uC2DD (\uAE30\uBCF8: html)"),
+      userId: external_exports.string().optional().describe("\uBC1C\uC2E0\uC790 ID (\uBBF8\uC9C0\uC815 \uC2DC me)")
+    },
+    async ({ to, subject, body, cc, bcc, contentType, userId }) => {
+      try {
+        await sendMail({
+          to,
+          subject,
+          body,
+          cc,
+          bcc,
+          contentType,
+          userId: userId ?? "me"
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true, message: "Mail sent (async)" }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_mail_list",
+    "\uBA54\uC77C\uD568\uC758 \uBA54\uC77C \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4 (User OAuth mail \uB610\uB294 mail.read scope \uD544\uC694)",
+    {
+      folderId: external_exports.number().optional().describe("\uBA54\uC77C \uD3F4\uB354 ID (\uAE30\uBCF8: 0 = \uBC1B\uC740\uD3B8\uC9C0\uD568)"),
+      count: external_exports.number().optional().describe("\uD398\uC774\uC9C0\uB2F9 \uD56D\uBAA9 \uC218 (\uAE30\uBCF8: 30, \uCD5C\uB300: 200)"),
+      cursor: external_exports.string().optional().describe("\uD398\uC774\uC9C0\uB124\uC774\uC158 \uCEE4\uC11C"),
+      isUnread: external_exports.boolean().optional().describe("\uC77D\uC9C0 \uC54A\uC740 \uBA54\uC77C\uB9CC \uC870\uD68C"),
+      userId: external_exports.string().optional().describe("\uB300\uC0C1 \uC0AC\uC6A9\uC790 ID (\uBBF8\uC9C0\uC815 \uC2DC me)")
+    },
+    async ({ folderId, count, cursor, isUnread, userId }) => {
+      try {
+        const result = await listMails(
+          folderId ?? 0,
+          userId ?? "me",
+          count ?? 30,
+          cursor,
+          isUnread
+        );
+        const mails = result.mails.map((m) => ({
+          mailId: m.mailId,
+          from: m.from.email,
+          subject: m.subject,
+          date: m.receivedTime,
+          status: m.status,
+          attachments: m.attachCount ?? 0
+        }));
+        return {
+          content: [{ type: "text", text: JSON.stringify({ mails, count: mails.length, totalCount: result.totalCount, unreadCount: result.unreadCount, nextCursor: result.responseMetaData?.nextCursor ?? null }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_mail_read",
+    "\uD2B9\uC815 \uBA54\uC77C\uC758 \uC0C1\uC138 \uB0B4\uC6A9\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4 (User OAuth mail \uB610\uB294 mail.read scope \uD544\uC694)",
+    {
+      mailId: external_exports.number().describe("\uBA54\uC77C ID"),
+      userId: external_exports.string().optional().describe("\uB300\uC0C1 \uC0AC\uC6A9\uC790 ID (\uBBF8\uC9C0\uC815 \uC2DC me)")
+    },
+    async ({ mailId, userId }) => {
+      try {
+        const result = await readMail(
+          mailId,
+          userId ?? "me"
+        );
+        const mail = result.mail;
         return {
-          content: [{ type: "text", text: JSON.stringify({ success: true, fileName, path: outPath, size: result.buffer.length }) }]
+          content: [{ type: "text", text: JSON.stringify({
+            mailId: mail.mailId,
+            from: mail.from,
+            to: mail.to,
+            cc: mail.cc ?? [],
+            subject: mail.subject,
+            body: mail.body,
+            date: mail.receivedTime,
+            attachments: result.attachments?.map((a) => ({
+              id: a.attachmentId,
+              filename: a.filename,
+              contentType: a.contentType,
+              size: a.size
+            })) ?? []
+          }) }]
         };
       } catch (err) {
         const error48 = err;
@@ -15151,7 +15454,7 @@ async function startMcpServer() {
 }
 
 // src/commands/mcp-cmd.ts
-var mcpCommand = new Command8("mcp").description("Start MCP server (stdio transport)").option("--list-tools", "List available MCP tools").action(async (opts) => {
+var mcpCommand = new Command9("mcp").description("Start MCP server (stdio transport)").option("--list-tools", "List available MCP tools").action(async (opts) => {
   if (opts.listTools) {
     console.log("nworks_message_send     \u2014 Send message to user or channel");
     console.log("nworks_message_members  \u2014 List channel members");
@@ -15166,7 +15469,7 @@ var mcpCommand = new Command8("mcp").description("Start MCP server (stdio transp
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version: version2 } = require2("../package.json");
-var program = new Command9().name("nworks").description("NAVER WORKS CLI \u2014 built for humans and AI agents").version(version2).option("--json", "Always output JSON").option("-v, --verbose", "Debug logging").option("--dry-run", "Print request without calling API").option("-p, --profile <name>", "Profile name", "default");
+var program = new Command10().name("nworks").description("NAVER WORKS CLI \u2014 built for humans and AI agents").version(version2).option("--json", "Always output JSON").option("-v, --verbose", "Debug logging").option("--dry-run", "Print request without calling API").option("-p, --profile <name>", "Profile name", "default");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
 program.addCommand(whoamiCommand);
@@ -15174,6 +15477,7 @@ program.addCommand(messageCommand);
 program.addCommand(directoryCommand);
 program.addCommand(calendarCommand);
 program.addCommand(driveCommand);
+program.addCommand(mailCommand);
 program.addCommand(mcpCommand);
 program.parse();
 //# sourceMappingURL=index.js.map