nworks 0.2.2 → 0.3.1

package/README.md

@@ -25,8 +25,8 @@ nworks login \
   --private-key <PATH_TO_KEY> \
   --bot-id <BOT_ID>
 
-# User OAuth 로그인 (캘린더 등 사용자 API용)
-nworks login --user --scope calendar.read
+# User OAuth 로그인 (캘린더, 드라이브 등 사용자 API용)
+nworks login --user --scope calendar.read,file
 
 # 인증 확인
 nworks whoami
@@ -39,6 +39,12 @@ nworks directory members
 
 # 오늘 일정 조회
 nworks calendar list
+
+# 드라이브 파일 목록
+nworks drive list
+
+# 파일 업로드
+nworks drive upload --file ./report.pdf
 ```
 
 ## CLI Commands
@@ -95,6 +101,36 @@ nworks calendar list --user <userId>
 
 > **Note**: 캘린더 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope calendar.read`를 실행하세요.
 
+### 드라이브 (User OAuth 필요)
+
+```bash
+# 루트 파일/폴더 목록
+nworks drive list
+
+# 특정 폴더 내 파일 목록
+nworks drive list --folder <folderId>
+
+# 페이지네이션
+nworks drive list --count 50 --cursor <nextCursor>
+
+# 파일 업로드 (루트)
+nworks drive upload --file ./report.pdf
+
+# 특정 폴더에 업로드
+nworks drive upload --file ./report.pdf --folder <folderId>
+
+# 동일 파일명 덮어쓰기
+nworks drive upload --file ./report.pdf --overwrite
+
+# 파일 다운로드
+nworks drive download --file-id <fileId>
+
+# 다운로드 경로/파일명 지정
+nworks drive download --file-id <fileId> --out ./downloads --name report.pdf
+```
+
+> **Note**: 드라이브 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope file`을 실행하세요. 읽기만 필요하면 `file.read` scope로 충분합니다.
+
 ### MCP 서버
 
 ```bash
@@ -134,6 +170,8 @@ nworks mcp --list-tools # 등록된 tool 목록
 | `bot.read` | Bot 채널/구성원 조회 | Service Account | `message members` |
 | `user.read` | 조직 구성원 조회 | Service Account | `directory members` |
 | `calendar.read` | 캘린더 일정 조회 | User OAuth | `calendar list` |
+| `file` | 드라이브 읽기/쓰기 | User OAuth | `drive list/upload/download` |
+| `file.read` | 드라이브 읽기 전용 | User OAuth | `drive list/download` |
 
 > **Tip**: scope를 변경한 후에는 토큰을 재발급해야 합니다.
 > ```bash
@@ -186,7 +224,7 @@ NWORKS_VERBOSE=1           # optional, 디버그 로깅
 
 - ~~**v0.1** — 메시지, 조직 구성원, MCP 서버~~
 - ~~**v0.2** — 캘린더 일정 조회 + User OAuth~~
-- **v0.3** — 드라이브 파일 조회/업로드 (`nworks drive`)
+- ~~**v0.3** — 드라이브 파일 조회/업로드/다운로드 (`nworks drive`)~~
 - **v0.4** — 게시판, 메일 (`nworks board`, `nworks mail`)
 
 ## License

package/dist/index.js

@@ -7,7 +7,7 @@ var __export = (target, all) => {
 
 // src/index.ts
 import { createRequire } from "module";
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 
 // src/commands/login.ts
 import { Command } from "commander";
@@ -827,9 +827,237 @@ var listCommand = new Command6("list").description("List calendar events (requir
 });
 var calendarCommand = new Command6("calendar").description("Calendar operations (requires User OAuth)").addCommand(listCommand);
 
-// src/commands/mcp-cmd.ts
+// src/commands/drive.ts
+import { writeFile as writeFile2 } from "fs/promises";
+import { join as join2 } from "path";
 import { Command as Command7 } from "commander";
 
+// src/api/drive.ts
+import { readFile as readFile4, stat } from "fs/promises";
+import { basename } from "path";
+var BASE_URL3 = "https://www.worksapis.com/v1.0";
+async function authedFetch(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 handleError(res) {
+  if (res.status === 401) {
+    throw new AuthError("User token expired. Run `nworks login --user --scope file` 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 listFiles(userId = "me", folderId, count = 20, cursor, profile = "default") {
+  const base = `${BASE_URL3}/users/${userId}/drive/files`;
+  const path = folderId ? `${base}/${folderId}/children` : base;
+  const params = new URLSearchParams();
+  params.set("count", String(count));
+  if (cursor) params.set("cursor", cursor);
+  const url2 = `${path}?${params.toString()}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url2}`);
+  }
+  const res = await authedFetch(url2, { method: "GET" }, profile);
+  if (!res.ok) return handleError(res);
+  const data = await res.json();
+  return { files: data.files ?? [], responseMetaData: data.responseMetaData };
+}
+async function uploadFile(localPath, userId = "me", folderId, overwrite = false, profile = "default") {
+  const fileName = basename(localPath);
+  const fileStat = await stat(localPath);
+  const fileSize = fileStat.size;
+  const base = `${BASE_URL3}/users/${userId}/drive/files`;
+  const createUrl = folderId ? `${base}/${folderId}` : base;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] POST ${createUrl} (create upload URL)`);
+  }
+  const createRes = await authedFetch(
+    createUrl,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ fileName, fileSize, overwrite })
+    },
+    profile
+  );
+  if (!createRes.ok) return handleError(createRes);
+  const { uploadUrl } = await createRes.json();
+  const fileBuffer = await readFile4(localPath);
+  const boundary = `----nworks${Date.now()}`;
+  const header = Buffer.from(
+    `--${boundary}\r
+Content-Disposition: form-data; name="Filedata"; filename="${fileName}"\r
+Content-Type: application/octet-stream\r
+\r
+`
+  );
+  const footer = Buffer.from(`\r
+--${boundary}--\r
+`);
+  const body = Buffer.concat([header, fileBuffer, footer]);
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] POST ${uploadUrl} (upload content, ${fileSize} bytes)`);
+  }
+  const uploadRes = await authedFetch(
+    uploadUrl,
+    {
+      method: "POST",
+      headers: { "Content-Type": `multipart/form-data; boundary=${boundary}` },
+      body
+    },
+    profile
+  );
+  if (!uploadRes.ok) return handleError(uploadRes);
+  return await uploadRes.json();
+}
+async function downloadFile(fileId, userId = "me", profile = "default") {
+  const url2 = `${BASE_URL3}/users/${userId}/drive/files/${fileId}/download`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url2} (get download URL)`);
+  }
+  const redirectRes = await authedFetch(
+    url2,
+    { method: "GET", redirect: "manual" },
+    profile
+  );
+  if (redirectRes.status === 401) {
+    throw new AuthError("User token expired. Run `nworks login --user --scope file` again.");
+  }
+  const location = redirectRes.headers.get("location");
+  if (!location) {
+    if (!redirectRes.ok) return handleError(redirectRes);
+    throw new ApiError("NO_REDIRECT", "No download URL returned", redirectRes.status);
+  }
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${location} (download content)`);
+  }
+  const downloadRes = await authedFetch(location, { method: "GET" }, profile);
+  if (!downloadRes.ok) return handleError(downloadRes);
+  const arrayBuffer = await downloadRes.arrayBuffer();
+  const buffer = Buffer.from(arrayBuffer);
+  const disposition = downloadRes.headers.get("content-disposition");
+  let fileName;
+  if (disposition) {
+    const match = disposition.match(/filename\*?=(?:UTF-8''|"?)([^";]+)/i);
+    if (match?.[1]) {
+      fileName = decodeURIComponent(match[1].replace(/"/g, ""));
+    }
+  }
+  return { buffer, fileName };
+}
+
+// src/commands/drive.ts
+var listCommand2 = new Command7("list").description("List files in Drive (requires User OAuth with file or file.read scope)").option("--user <userId>", "Target user ID (default: me)").option("--folder <folderId>", "Folder ID to list (default: root)").option("--count <n>", "Items per page (default: 20)", "20").option("--cursor <cursor>", "Pagination cursor").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const result = await listFiles(
+      opts.user ?? "me",
+      opts.folder,
+      parseInt(opts.count, 10),
+      opts.cursor,
+      opts.profile
+    );
+    const files = result.files.map((f) => ({
+      name: f.fileName,
+      type: f.fileType,
+      size: f.fileSize,
+      modified: f.modifiedTime,
+      fileId: f.fileId
+    }));
+    output(
+      {
+        files,
+        count: files.length,
+        nextCursor: result.responseMetaData?.nextCursor ?? null
+      },
+      opts
+    );
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var uploadCommand = new Command7("upload").description("Upload a file to Drive (requires User OAuth with file scope)").requiredOption("--file <path>", "Local file path to upload").option("--user <userId>", "Target user ID (default: me)").option("--folder <folderId>", "Destination folder ID (default: root)").option("--overwrite", "Overwrite if file exists", false).option("--profile <name>", "Profile name", "default").option("--json", "JSON output").option("--dry-run", "Print request without uploading").action(async (opts) => {
+  try {
+    if (opts.dryRun) {
+      output(
+        {
+          dryRun: true,
+          request: {
+            file: opts.file,
+            user: opts.user ?? "me",
+            folder: opts.folder ?? "(root)",
+            overwrite: opts.overwrite
+          }
+        },
+        opts
+      );
+      return;
+    }
+    const result = await uploadFile(
+      opts.file,
+      opts.user ?? "me",
+      opts.folder,
+      opts.overwrite,
+      opts.profile
+    );
+    output(
+      {
+        success: true,
+        fileId: result.fileId,
+        fileName: result.fileName,
+        fileSize: result.fileSize,
+        filePath: result.filePath,
+        fileType: result.fileType
+      },
+      opts
+    );
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var downloadCommand = new Command7("download").description("Download a file from Drive (requires User OAuth with file or file.read scope)").requiredOption("--file-id <fileId>", "File ID to download").option("--out <path>", "Output directory (default: current directory)").option("--name <filename>", "Output filename (default: original name)").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 downloadFile(
+      opts.fileId,
+      opts.user ?? "me",
+      opts.profile
+    );
+    const fileName = opts.name ?? result.fileName ?? opts.fileId;
+    const outDir = opts.out ?? process.cwd();
+    const outPath = join2(outDir, fileName);
+    await writeFile2(outPath, result.buffer);
+    output(
+      {
+        success: true,
+        fileName,
+        path: outPath,
+        size: result.buffer.length
+      },
+      opts
+    );
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+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
+import { Command as Command8 } from "commander";
+
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -14712,6 +14940,105 @@ function registerTools(server) {
       }
     }
   );
+  server.tool(
+    "nworks_drive_list",
+    "\uB4DC\uB77C\uC774\uBE0C \uD30C\uC77C/\uD3F4\uB354 \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4 (User OAuth file \uB610\uB294 file.read scope \uD544\uC694)",
+    {
+      userId: external_exports.string().optional().describe("\uB300\uC0C1 \uC0AC\uC6A9\uC790 ID (\uBBF8\uC9C0\uC815 \uC2DC me)"),
+      folderId: external_exports.string().optional().describe("\uD3F4\uB354 ID (\uBBF8\uC9C0\uC815 \uC2DC \uB8E8\uD2B8)"),
+      count: external_exports.number().optional().describe("\uD398\uC774\uC9C0\uB2F9 \uD56D\uBAA9 \uC218 (\uAE30\uBCF8: 20, \uCD5C\uB300: 200)"),
+      cursor: external_exports.string().optional().describe("\uD398\uC774\uC9C0\uB124\uC774\uC158 \uCEE4\uC11C")
+    },
+    async ({ userId, folderId, count, cursor }) => {
+      try {
+        const result = await listFiles(
+          userId ?? "me",
+          folderId,
+          count ?? 20,
+          cursor
+        );
+        const files = result.files.map((f) => ({
+          fileId: f.fileId,
+          name: f.fileName,
+          type: f.fileType,
+          size: f.fileSize,
+          modified: f.modifiedTime,
+          path: f.filePath
+        }));
+        return {
+          content: [{ type: "text", text: JSON.stringify({ files, count: files.length, nextCursor: result.responseMetaData?.nextCursor ?? null }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_drive_upload",
+    "\uB85C\uCEEC \uD30C\uC77C\uC744 \uB4DC\uB77C\uC774\uBE0C\uC5D0 \uC5C5\uB85C\uB4DC\uD569\uB2C8\uB2E4 (User OAuth file scope \uD544\uC694)",
+    {
+      filePath: external_exports.string().describe("\uC5C5\uB85C\uB4DC\uD560 \uB85C\uCEEC \uD30C\uC77C \uACBD\uB85C"),
+      userId: external_exports.string().optional().describe("\uB300\uC0C1 \uC0AC\uC6A9\uC790 ID (\uBBF8\uC9C0\uC815 \uC2DC me)"),
+      folderId: external_exports.string().optional().describe("\uC5C5\uB85C\uB4DC\uD560 \uD3F4\uB354 ID (\uBBF8\uC9C0\uC815 \uC2DC \uB8E8\uD2B8)"),
+      overwrite: external_exports.boolean().optional().describe("\uB3D9\uC77C \uD30C\uC77C\uBA85 \uB36E\uC5B4\uC4F0\uAE30 (\uAE30\uBCF8: false)")
+    },
+    async ({ filePath, userId, folderId, overwrite }) => {
+      try {
+        const result = await uploadFile(
+          filePath,
+          userId ?? "me",
+          folderId,
+          overwrite ?? false
+        );
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true, ...result }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  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)",
+    {
+      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)"),
+      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);
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true, fileName, path: outPath, size: result.buffer.length }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
   server.tool(
     "nworks_whoami",
     "\uD604\uC7AC \uC778\uC99D\uB41C NAVER WORKS \uACC4\uC815 \uC815\uBCF4\uB97C \uD655\uC778\uD569\uB2C8\uB2E4",
@@ -14753,7 +15080,7 @@ async function startMcpServer() {
 }
 
 // src/commands/mcp-cmd.ts
-var mcpCommand = new Command7("mcp").description("Start MCP server (stdio transport)").option("--list-tools", "List available MCP tools").action(async (opts) => {
+var mcpCommand = new Command8("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");
@@ -14768,13 +15095,14 @@ var mcpCommand = new Command7("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 Command8().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 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");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
 program.addCommand(whoamiCommand);
 program.addCommand(messageCommand);
 program.addCommand(directoryCommand);
 program.addCommand(calendarCommand);
+program.addCommand(driveCommand);
 program.addCommand(mcpCommand);
 program.parse();
 //# sourceMappingURL=index.js.map