dingtalk-manager 1.0.0 → 1.1.0

package/README.md

@@ -15,6 +15,69 @@ yarn add dingtalk-manager
 bun add dingtalk-manager
 ```
 
+## 命令行工具
+
+本包支持通过 `bunx` 或 `npx` 直接作为命令行工具使用，无需安装。
+
+### 配置凭证
+
+首先设置环境变量：
+
+```bash
+export DINGTALK_APP_KEY="your-app-key"
+export DINGTALK_APP_SECRET="your-app-secret"
+export DINGTALK_AGENT_ID="your-agent-id"
+export DINGTALK_USER_ID="target-user-id"
+```
+
+或者使用凭证文件（`--credentials-path` 参数）：
+
+```bash
+bunx dingtalk-manager@latest sendMarkdown --credentials-path /path/to/credentials.json --title "标题" --content "内容"
+```
+
+### 发送 Markdown 消息
+
+```bash
+bunx dingtalk-manager@latest sendMarkdown --title "标题" --content "**加粗** 内容\n- 项目 1\n- 项目 2"
+```
+
+### 发送文本消息
+
+```bash
+bunx dingtalk-manager@latest sendText --content "纯文本消息"
+```
+
+### 输出格式
+
+命令执行成功时输出 JSON 格式的结果：
+
+```json
+{
+  "success": true,
+  "taskId": "123456789"
+}
+```
+
+失败时：
+
+```json
+{
+  "success": false,
+  "error": "错误信息"
+}
+```
+
+### 帮助信息
+
+```bash
+bunx dingtalk-manager@latest --help
+bunx dingtalk-manager@latest sendMarkdown --help
+bunx dingtalk-manager@latest sendText --help
+```
+
+---
+
 ## 快速开始
 
 ### 方式一：直接传入凭证

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,355 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { Command } from "commander";
+import { readFileSync as readFileSync2 } from "node:fs";
+import { dirname, join as join2 } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// src/utils.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+
+// src/errors.ts
+class DingTalkError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "DingTalkError";
+  }
+}
+
+class TokenError extends DingTalkError {
+  constructor(message) {
+    super(message);
+    this.name = "TokenError";
+  }
+}
+
+class MessageError extends DingTalkError {
+  constructor(message) {
+    super(message);
+    this.name = "MessageError";
+  }
+}
+
+class CredentialError extends DingTalkError {
+  constructor(message) {
+    super(message);
+    this.name = "CredentialError";
+  }
+}
+
+// src/utils.ts
+var ENV_KEYS = {
+  APP_KEY: "DINGTALK_APP_KEY",
+  APP_SECRET: "DINGTALK_APP_SECRET",
+  AGENT_ID: "DINGTALK_AGENT_ID",
+  USER_ID: "DINGTALK_USER_ID"
+};
+
+class TokenManager {
+  cacheDir;
+  cacheFile;
+  constructor(cacheDir) {
+    this.cacheDir = cacheDir ?? tmpdir();
+    this.cacheFile = join(this.cacheDir, "dingtalk-token-cache.json");
+  }
+  load() {
+    try {
+      if (!existsSync(this.cacheFile)) {
+        return null;
+      }
+      const content = readFileSync(this.cacheFile, "utf-8");
+      return JSON.parse(content);
+    } catch {
+      return null;
+    }
+  }
+  save(cache) {
+    try {
+      if (!existsSync(this.cacheDir)) {
+        mkdirSync(this.cacheDir, { recursive: true, mode: 448 });
+      }
+      writeFileSync(this.cacheFile, JSON.stringify(cache, null, 2), { mode: 384 });
+    } catch (error) {
+      console.error("Failed to cache DingTalk token:", error instanceof Error ? error.message : String(error));
+    }
+  }
+  isValid(cache) {
+    return cache !== null && cache.expiresAt > Date.now();
+  }
+}
+function loadCredentials(options) {
+  if (options?.credentials) {
+    validateCredentials(options.credentials);
+    return options.credentials;
+  }
+  if (options?.credentialsPath) {
+    const creds = loadFromFile(options.credentialsPath);
+    if (creds) {
+      validateCredentials(creds);
+      return creds;
+    }
+  }
+  const envCreds = loadFromEnv();
+  if (envCreds) {
+    validateCredentials(envCreds);
+    return envCreds;
+  }
+  throw new CredentialError("DingTalk credentials not found. Provide credentials via options.credentials, options.credentialsPath, or environment variables (DINGTALK_APP_KEY, DINGTALK_APP_SECRET, DINGTALK_AGENT_ID, DINGTALK_USER_ID)");
+}
+function loadFromEnv() {
+  const appKey = process.env[ENV_KEYS.APP_KEY];
+  const appSecret = process.env[ENV_KEYS.APP_SECRET];
+  const agentId = process.env[ENV_KEYS.AGENT_ID];
+  const userId = process.env[ENV_KEYS.USER_ID];
+  if (appKey && appSecret && agentId && userId) {
+    return { appKey, appSecret, agentId, userId };
+  }
+  return null;
+}
+function loadFromFile(path) {
+  try {
+    if (!existsSync(path)) {
+      return null;
+    }
+    const content = readFileSync(path, "utf-8");
+    const data = JSON.parse(content);
+    return {
+      appKey: data.appKey,
+      appSecret: data.appSecret,
+      agentId: data.agentId,
+      userId: data.userId ?? data.userid
+    };
+  } catch {
+    return null;
+  }
+}
+function validateCredentials(creds) {
+  const missing = [];
+  if (!creds.appKey)
+    missing.push("appKey");
+  if (!creds.appSecret)
+    missing.push("appSecret");
+  if (!creds.agentId)
+    missing.push("agentId");
+  if (!creds.userId)
+    missing.push("userId");
+  if (missing.length > 0) {
+    throw new CredentialError(`Missing required credentials: ${missing.join(", ")}`);
+  }
+}
+var FORBIDDEN_CODES = {
+  "143103": {
+    description: "企业应用消息发送QPM（每分钟请求数）超限",
+    solution: "请稍后重试，或优化发送频率"
+  },
+  "143104": {
+    description: "企业每分钟发送QPM超限",
+    solution: "请稍后重试，或优化发送频率"
+  },
+  "143105": {
+    description: "应用发送日限超限（自建应用: 500条/天/用户, ISV应用: 50条/天/用户）",
+    solution: "已达到每日发送上限，请明天再试"
+  },
+  "143106": {
+    description: "应用重复消息发送限超限（同一用户每天只能接收一条相同内容的消息）",
+    solution: "修改消息内容后重新发送，或等待明天自动重置"
+  }
+};
+function getForbiddenCodeInfo(code) {
+  return FORBIDDEN_CODES[code] ?? null;
+}
+
+// src/client.ts
+var TOKEN_EXPIRY_BUFFER_SECONDS = 300;
+
+class DingTalk {
+  credentials;
+  tokenManager;
+  constructor(options) {
+    this.credentials = loadCredentials(options);
+    this.tokenManager = new TokenManager(options?.tokenCacheDir);
+  }
+  async getAccessToken() {
+    const cached = this.tokenManager.load();
+    if (this.tokenManager.isValid(cached)) {
+      return cached.accessToken;
+    }
+    const url = `https://oapi.dingtalk.com/gettoken?appkey=${encodeURIComponent(this.credentials.appKey)}&appsecret=${encodeURIComponent(this.credentials.appSecret)}`;
+    const response = await fetch(url, { method: "GET" });
+    if (!response.ok) {
+      throw new TokenError(`Failed to get access token: HTTP ${response.status}`);
+    }
+    const data = await response.json();
+    if (data.errcode !== 0) {
+      throw new TokenError(`Failed to get access token: ${data.errmsg ?? "Unknown error"}`);
+    }
+    if (!data.access_token) {
+      throw new TokenError("Access token missing in response");
+    }
+    const expiresInSeconds = data.expires_in ?? 7200;
+    this.tokenManager.save({
+      accessToken: data.access_token,
+      expiresAt: Date.now() + (expiresInSeconds - TOKEN_EXPIRY_BUFFER_SECONDS) * 1000
+    });
+    return data.access_token;
+  }
+  async sendMarkdown(title, content) {
+    try {
+      const accessToken = await this.getAccessToken();
+      const url = `https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=${accessToken}`;
+      const body = {
+        agent_id: this.credentials.agentId,
+        userid_list: this.credentials.userId,
+        msg: {
+          msgtype: "markdown",
+          markdown: {
+            title,
+            text: content
+          }
+        }
+      };
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body)
+      });
+      if (!response.ok) {
+        return { success: false, error: `HTTP ${response.status}` };
+      }
+      const data = await response.json();
+      if (data.errcode !== 0) {
+        return { success: false, error: data.errmsg ?? `Error code: ${data.errcode}` };
+      }
+      return { success: true, taskId: data.task_id?.toString() };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  async sendText(content) {
+    try {
+      const accessToken = await this.getAccessToken();
+      const url = `https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=${accessToken}`;
+      const body = {
+        agent_id: this.credentials.agentId,
+        userid_list: this.credentials.userId,
+        msg: {
+          msgtype: "text",
+          text: { content }
+        }
+      };
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body)
+      });
+      if (!response.ok) {
+        return { success: false, error: `HTTP ${response.status}` };
+      }
+      const data = await response.json();
+      if (data.errcode !== 0) {
+        return { success: false, error: data.errmsg ?? `Error code: ${data.errcode}` };
+      }
+      return { success: true, taskId: data.task_id?.toString() };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  async getSendResult(taskId) {
+    try {
+      const accessToken = await this.getAccessToken();
+      const url = `https://oapi.dingtalk.com/topapi/message/corpconversation/getsendresult?access_token=${accessToken}`;
+      const body = {
+        agent_id: this.credentials.agentId,
+        task_id: Number(taskId)
+      };
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body)
+      });
+      if (!response.ok) {
+        return { success: false, error: `HTTP ${response.status}` };
+      }
+      const data = await response.json();
+      if (data.errcode !== 0) {
+        return { success: false, error: data.errmsg ?? `Error code: ${data.errcode}` };
+      }
+      return {
+        success: true,
+        invalidUserIdList: data.send_result?.invalid_user_id_list,
+        forbiddenUserIdList: data.send_result?.forbidden_user_id_list,
+        failedUserIdList: data.send_result?.failed_user_id_list,
+        readUserIdList: data.send_result?.read_user_id_list,
+        unreadUserIdList: data.send_result?.unread_user_id_list,
+        forbiddenList: data.send_result?.forbidden_list
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  static getForbiddenCodeInfo(code) {
+    return getForbiddenCodeInfo(code);
+  }
+}
+
+// src/cli.ts
+var __dirname2 = dirname(fileURLToPath(import.meta.url));
+var packageJson = JSON.parse(readFileSync2(join2(__dirname2, "../package.json"), "utf-8"));
+var program = new Command;
+program.name("dingtalk-manager").description("DingTalk work notification CLI - send markdown and text messages").version(packageJson.version).option("--credentials-path <path>", "Path to credentials JSON file");
+program.command("sendMarkdown").description("Send a markdown message to DingTalk").requiredOption("--title <title>", "Message title").requiredOption("--content <content>", "Markdown content").action(async (options, cmd) => {
+  const globalOpts = cmd.optsWithGlobals();
+  const clientOptions = {};
+  if (globalOpts.credentialsPath) {
+    clientOptions.credentialsPath = globalOpts.credentialsPath;
+  }
+  try {
+    const client = new DingTalk(clientOptions);
+    const result = await client.sendMarkdown(options.title, options.content);
+    console.log(JSON.stringify(result, null, 2));
+    process.exit(result.success ? 0 : 1);
+  } catch (error) {
+    const result = {
+      success: false,
+      error: error instanceof Error ? error.message : String(error)
+    };
+    console.log(JSON.stringify(result, null, 2));
+    process.exit(1);
+  }
+});
+program.command("sendText").description("Send a text message to DingTalk").requiredOption("--content <content>", "Text content").action(async (options, cmd) => {
+  const globalOpts = cmd.optsWithGlobals();
+  const clientOptions = {};
+  if (globalOpts.credentialsPath) {
+    clientOptions.credentialsPath = globalOpts.credentialsPath;
+  }
+  try {
+    const client = new DingTalk(clientOptions);
+    const result = await client.sendText(options.content);
+    console.log(JSON.stringify(result, null, 2));
+    process.exit(result.success ? 0 : 1);
+  } catch (error) {
+    const result = {
+      success: false,
+      error: error instanceof Error ? error.message : String(error)
+    };
+    console.log(JSON.stringify(result, null, 2));
+    process.exit(1);
+  }
+});
+program.parse();
+
+//# debugId=4B8AA822D0E0923864756E2164756E21
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/cli.ts", "../src/utils.ts", "../src/errors.ts", "../src/client.ts"],
+  "sourcesContent": [
+    "#!/usr/bin/env node\nimport { Command } from 'commander';\nimport { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { DingTalk } from './client.js';\nimport type { DingTalkOptions } from './types.js';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));\n\nconst program = new Command();\n\nprogram\n  .name('dingtalk-manager')\n  .description('DingTalk work notification CLI - send markdown and text messages')\n  .version(packageJson.version)\n  .option('--credentials-path <path>', 'Path to credentials JSON file');\n\nprogram\n  .command('sendMarkdown')\n  .description('Send a markdown message to DingTalk')\n  .requiredOption('--title <title>', 'Message title')\n  .requiredOption('--content <content>', 'Markdown content')\n  .action(async (options, cmd) => {\n    const globalOpts = cmd.optsWithGlobals();\n    const clientOptions: DingTalkOptions = {};\n    \n    if (globalOpts.credentialsPath) {\n      clientOptions.credentialsPath = globalOpts.credentialsPath;\n    }\n    \n    try {\n      const client = new DingTalk(clientOptions);\n      const result = await client.sendMarkdown(options.title, options.content);\n      \n      console.log(JSON.stringify(result, null, 2));\n      process.exit(result.success ? 0 : 1);\n    } catch (error) {\n      const result = {\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n      };\n      console.log(JSON.stringify(result, null, 2));\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('sendText')\n  .description('Send a text message to DingTalk')\n  .requiredOption('--content <content>', 'Text content')\n  .action(async (options, cmd) => {\n    const globalOpts = cmd.optsWithGlobals();\n    const clientOptions: DingTalkOptions = {};\n    \n    if (globalOpts.credentialsPath) {\n      clientOptions.credentialsPath = globalOpts.credentialsPath;\n    }\n    \n    try {\n      const client = new DingTalk(clientOptions);\n      const result = await client.sendText(options.content);\n      \n      console.log(JSON.stringify(result, null, 2));\n      process.exit(result.success ? 0 : 1);\n    } catch (error) {\n      const result = {\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n      };\n      console.log(JSON.stringify(result, null, 2));\n      process.exit(1);\n    }\n  });\n\nprogram.parse();\n",
+    "import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\nimport type { DingTalkCredentials, DingTalkOptions, TokenCache } from './types.js';\nimport { CredentialError } from './errors.js';\n\nconst ENV_KEYS = {\n  APP_KEY: 'DINGTALK_APP_KEY',\n  APP_SECRET: 'DINGTALK_APP_SECRET',\n  AGENT_ID: 'DINGTALK_AGENT_ID',\n  USER_ID: 'DINGTALK_USER_ID',\n} as const;\n\nexport class TokenManager {\n  private cacheDir: string;\n  private cacheFile: string;\n\n  constructor(cacheDir?: string) {\n    this.cacheDir = cacheDir ?? tmpdir();\n    this.cacheFile = join(this.cacheDir, 'dingtalk-token-cache.json');\n  }\n\n  load(): TokenCache | null {\n    try {\n      if (!existsSync(this.cacheFile)) {\n        return null;\n      }\n      const content = readFileSync(this.cacheFile, 'utf-8');\n      return JSON.parse(content) as TokenCache;\n    } catch {\n      return null;\n    }\n  }\n\n  save(cache: TokenCache): void {\n    try {\n      if (!existsSync(this.cacheDir)) {\n        mkdirSync(this.cacheDir, { recursive: true, mode: 0o700 });\n      }\n      writeFileSync(this.cacheFile, JSON.stringify(cache, null, 2), { mode: 0o600 });\n    } catch (error) {\n      console.error('Failed to cache DingTalk token:', error instanceof Error ? error.message : String(error));\n    }\n  }\n\n  isValid(cache: TokenCache | null): cache is TokenCache {\n    return cache !== null && cache.expiresAt > Date.now();\n  }\n}\n\nexport function loadCredentials(options?: DingTalkOptions): DingTalkCredentials {\n  if (options?.credentials) {\n    validateCredentials(options.credentials);\n    return options.credentials;\n  }\n\n  if (options?.credentialsPath) {\n    const creds = loadFromFile(options.credentialsPath);\n    if (creds) {\n      validateCredentials(creds);\n      return creds;\n    }\n  }\n\n  const envCreds = loadFromEnv();\n  if (envCreds) {\n    validateCredentials(envCreds);\n    return envCreds;\n  }\n\n  throw new CredentialError(\n    'DingTalk credentials not found. Provide credentials via options.credentials, options.credentialsPath, or environment variables (DINGTALK_APP_KEY, DINGTALK_APP_SECRET, DINGTALK_AGENT_ID, DINGTALK_USER_ID)'\n  );\n}\n\nfunction loadFromEnv(): DingTalkCredentials | null {\n  const appKey = process.env[ENV_KEYS.APP_KEY];\n  const appSecret = process.env[ENV_KEYS.APP_SECRET];\n  const agentId = process.env[ENV_KEYS.AGENT_ID];\n  const userId = process.env[ENV_KEYS.USER_ID];\n\n  if (appKey && appSecret && agentId && userId) {\n    return { appKey, appSecret, agentId, userId };\n  }\n  return null;\n}\n\nfunction loadFromFile(path: string): DingTalkCredentials | null {\n  try {\n    if (!existsSync(path)) {\n      return null;\n    }\n    const content = readFileSync(path, 'utf-8');\n    const data = JSON.parse(content);\n    return {\n      appKey: data.appKey,\n      appSecret: data.appSecret,\n      agentId: data.agentId,\n      userId: data.userId ?? data.userid,\n    };\n  } catch {\n    return null;\n  }\n}\n\nfunction validateCredentials(creds: DingTalkCredentials): void {\n  const missing: string[] = [];\n  if (!creds.appKey) missing.push('appKey');\n  if (!creds.appSecret) missing.push('appSecret');\n  if (!creds.agentId) missing.push('agentId');\n  if (!creds.userId) missing.push('userId');\n\n  if (missing.length > 0) {\n    throw new CredentialError(`Missing required credentials: ${missing.join(', ')}`);\n  }\n}\n\nexport const FORBIDDEN_CODES: Record<string, { description: string; solution: string }> = {\n  '143103': {\n    description: '企业应用消息发送QPM（每分钟请求数）超限',\n    solution: '请稍后重试，或优化发送频率',\n  },\n  '143104': {\n    description: '企业每分钟发送QPM超限',\n    solution: '请稍后重试，或优化发送频率',\n  },\n  '143105': {\n    description: '应用发送日限超限（自建应用: 500条/天/用户, ISV应用: 50条/天/用户）',\n    solution: '已达到每日发送上限，请明天再试',\n  },\n  '143106': {\n    description: '应用重复消息发送限超限（同一用户每天只能接收一条相同内容的消息）',\n    solution: '修改消息内容后重新发送，或等待明天自动重置',\n  },\n};\n\nexport function getForbiddenCodeInfo(code: string): { description: string; solution: string } | null {\n  return FORBIDDEN_CODES[code] ?? null;\n}\n",
+    "export class DingTalkError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'DingTalkError';\n  }\n}\n\nexport class TokenError extends DingTalkError {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TokenError';\n  }\n}\n\nexport class MessageError extends DingTalkError {\n  constructor(message: string) {\n    super(message);\n    this.name = 'MessageError';\n  }\n}\n\nexport class CredentialError extends DingTalkError {\n  constructor(message: string) {\n    super(message);\n    this.name = 'CredentialError';\n  }\n}\n",
+    "import type {\n  DingTalkOptions,\n  DingTalkCredentials,\n  SendMessageResult,\n  SendResult,\n  TokenResponse,\n  SendResponse,\n  SendResultResponse,\n} from './types.js';\nimport { TokenManager, loadCredentials, getForbiddenCodeInfo } from './utils.js';\nimport { TokenError, MessageError } from './errors.js';\n\nconst TOKEN_EXPIRY_BUFFER_SECONDS = 300;\n\nexport class DingTalk {\n  private credentials: DingTalkCredentials;\n  private tokenManager: TokenManager;\n\n  constructor(options?: DingTalkOptions) {\n    this.credentials = loadCredentials(options);\n    this.tokenManager = new TokenManager(options?.tokenCacheDir);\n  }\n\n  async getAccessToken(): Promise<string> {\n    const cached = this.tokenManager.load();\n    if (this.tokenManager.isValid(cached)) {\n      return cached.accessToken;\n    }\n\n    const url = `https://oapi.dingtalk.com/gettoken?appkey=${encodeURIComponent(this.credentials.appKey)}&appsecret=${encodeURIComponent(this.credentials.appSecret)}`;\n\n    const response = await fetch(url, { method: 'GET' });\n\n    if (!response.ok) {\n      throw new TokenError(`Failed to get access token: HTTP ${response.status}`);\n    }\n\n    const data = (await response.json()) as TokenResponse;\n\n    if (data.errcode !== 0) {\n      throw new TokenError(`Failed to get access token: ${data.errmsg ?? 'Unknown error'}`);\n    }\n\n    if (!data.access_token) {\n      throw new TokenError('Access token missing in response');\n    }\n\n    const expiresInSeconds = data.expires_in ?? 7200;\n    this.tokenManager.save({\n      accessToken: data.access_token,\n      expiresAt: Date.now() + (expiresInSeconds - TOKEN_EXPIRY_BUFFER_SECONDS) * 1000,\n    });\n\n    return data.access_token;\n  }\n\n  async sendMarkdown(title: string, content: string): Promise<SendMessageResult> {\n    try {\n      const accessToken = await this.getAccessToken();\n      const url = `https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=${accessToken}`;\n\n      const body = {\n        agent_id: this.credentials.agentId,\n        userid_list: this.credentials.userId,\n        msg: {\n          msgtype: 'markdown',\n          markdown: {\n            title,\n            text: content,\n          },\n        },\n      };\n\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify(body),\n      });\n\n      if (!response.ok) {\n        return { success: false, error: `HTTP ${response.status}` };\n      }\n\n      const data = (await response.json()) as SendResponse;\n\n      if (data.errcode !== 0) {\n        return { success: false, error: data.errmsg ?? `Error code: ${data.errcode}` };\n      }\n\n      return { success: true, taskId: data.task_id?.toString() };\n    } catch (error) {\n      return {\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n\n  async sendText(content: string): Promise<SendMessageResult> {\n    try {\n      const accessToken = await this.getAccessToken();\n      const url = `https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=${accessToken}`;\n\n      const body = {\n        agent_id: this.credentials.agentId,\n        userid_list: this.credentials.userId,\n        msg: {\n          msgtype: 'text',\n          text: { content },\n        },\n      };\n\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify(body),\n      });\n\n      if (!response.ok) {\n        return { success: false, error: `HTTP ${response.status}` };\n      }\n\n      const data = (await response.json()) as SendResponse;\n\n      if (data.errcode !== 0) {\n        return { success: false, error: data.errmsg ?? `Error code: ${data.errcode}` };\n      }\n\n      return { success: true, taskId: data.task_id?.toString() };\n    } catch (error) {\n      return {\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n\n  async getSendResult(taskId: string): Promise<SendResult> {\n    try {\n      const accessToken = await this.getAccessToken();\n      const url = `https://oapi.dingtalk.com/topapi/message/corpconversation/getsendresult?access_token=${accessToken}`;\n\n      const body = {\n        agent_id: this.credentials.agentId,\n        task_id: Number(taskId),\n      };\n\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify(body),\n      });\n\n      if (!response.ok) {\n        return { success: false, error: `HTTP ${response.status}` };\n      }\n\n      const data = (await response.json()) as SendResultResponse;\n\n      if (data.errcode !== 0) {\n        return { success: false, error: data.errmsg ?? `Error code: ${data.errcode}` };\n      }\n\n      return {\n        success: true,\n        invalidUserIdList: data.send_result?.invalid_user_id_list,\n        forbiddenUserIdList: data.send_result?.forbidden_user_id_list,\n        failedUserIdList: data.send_result?.failed_user_id_list,\n        readUserIdList: data.send_result?.read_user_id_list,\n        unreadUserIdList: data.send_result?.unread_user_id_list,\n        forbiddenList: data.send_result?.forbidden_list,\n      };\n    } catch (error) {\n      return {\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n\n  static getForbiddenCodeInfo(code: string): { description: string; solution: string } | null {\n    return getForbiddenCodeInfo(code);\n  }\n}\n"
+  ],
+  "mappings": ";;;AACA;AACA,yBAAS;AACT,0BAAkB;AAClB;;;ACJA;AACA;AACA;;;ACFO,MAAM,sBAAsB,MAAM;AAAA,EACvC,WAAW,CAAC,SAAiB;AAAA,IAC3B,MAAM,OAAO;AAAA,IACb,KAAK,OAAO;AAAA;AAEhB;AAAA;AAEO,MAAM,mBAAmB,cAAc;AAAA,EAC5C,WAAW,CAAC,SAAiB;AAAA,IAC3B,MAAM,OAAO;AAAA,IACb,KAAK,OAAO;AAAA;AAEhB;AAAA;AAEO,MAAM,qBAAqB,cAAc;AAAA,EAC9C,WAAW,CAAC,SAAiB;AAAA,IAC3B,MAAM,OAAO;AAAA,IACb,KAAK,OAAO;AAAA;AAEhB;AAAA;AAEO,MAAM,wBAAwB,cAAc;AAAA,EACjD,WAAW,CAAC,SAAiB;AAAA,IAC3B,MAAM,OAAO;AAAA,IACb,KAAK,OAAO;AAAA;AAEhB;;;ADpBA,IAAM,WAAW;AAAA,EACf,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,SAAS;AACX;AAAA;AAEO,MAAM,aAAa;AAAA,EAChB;AAAA,EACA;AAAA,EAER,WAAW,CAAC,UAAmB;AAAA,IAC7B,KAAK,WAAW,YAAY,OAAO;AAAA,IACnC,KAAK,YAAY,KAAK,KAAK,UAAU,2BAA2B;AAAA;AAAA,EAGlE,IAAI,GAAsB;AAAA,IACxB,IAAI;AAAA,MACF,IAAI,CAAC,WAAW,KAAK,SAAS,GAAG;AAAA,QAC/B,OAAO;AAAA,MACT;AAAA,MACA,MAAM,UAAU,aAAa,KAAK,WAAW,OAAO;AAAA,MACpD,OAAO,KAAK,MAAM,OAAO;AAAA,MACzB,MAAM;AAAA,MACN,OAAO;AAAA;AAAA;AAAA,EAIX,IAAI,CAAC,OAAyB;AAAA,IAC5B,IAAI;AAAA,MACF,IAAI,CAAC,WAAW,KAAK,QAAQ,GAAG;AAAA,QAC9B,UAAU,KAAK,UAAU,EAAE,WAAW,MAAM,MAAM,IAAM,CAAC;AAAA,MAC3D;AAAA,MACA,cAAc,KAAK,WAAW,KAAK,UAAU,OAAO,MAAM,CAAC,GAAG,EAAE,MAAM,IAAM,CAAC;AAAA,MAC7E,OAAO,OAAO;AAAA,MACd,QAAQ,MAAM,mCAAmC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA;AAAA;AAAA,EAI3G,OAAO,CAAC,OAA+C;AAAA,IACrD,OAAO,UAAU,QAAQ,MAAM,YAAY,KAAK,IAAI;AAAA;AAExD;AAEO,SAAS,eAAe,CAAC,SAAgD;AAAA,EAC9E,IAAI,SAAS,aAAa;AAAA,IACxB,oBAAoB,QAAQ,WAAW;AAAA,IACvC,OAAO,QAAQ;AAAA,EACjB;AAAA,EAEA,IAAI,SAAS,iBAAiB;AAAA,IAC5B,MAAM,QAAQ,aAAa,QAAQ,eAAe;AAAA,IAClD,IAAI,OAAO;AAAA,MACT,oBAAoB,KAAK;AAAA,MACzB,OAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,WAAW,YAAY;AAAA,EAC7B,IAAI,UAAU;AAAA,IACZ,oBAAoB,QAAQ;AAAA,IAC5B,OAAO;AAAA,EACT;AAAA,EAEA,MAAM,IAAI,gBACR,6MACF;AAAA;AAGF,SAAS,WAAW,GAA+B;AAAA,EACjD,MAAM,SAAS,QAAQ,IAAI,SAAS;AAAA,EACpC,MAAM,YAAY,QAAQ,IAAI,SAAS;AAAA,EACvC,MAAM,UAAU,QAAQ,IAAI,SAAS;AAAA,EACrC,MAAM,SAAS,QAAQ,IAAI,SAAS;AAAA,EAEpC,IAAI,UAAU,aAAa,WAAW,QAAQ;AAAA,IAC5C,OAAO,EAAE,QAAQ,WAAW,SAAS,OAAO;AAAA,EAC9C;AAAA,EACA,OAAO;AAAA;AAGT,SAAS,YAAY,CAAC,MAA0C;AAAA,EAC9D,IAAI;AAAA,IACF,IAAI,CAAC,WAAW,IAAI,GAAG;AAAA,MACrB,OAAO;AAAA,IACT;AAAA,IACA,MAAM,UAAU,aAAa,MAAM,OAAO;AAAA,IAC1C,MAAM,OAAO,KAAK,MAAM,OAAO;AAAA,IAC/B,OAAO;AAAA,MACL,QAAQ,KAAK;AAAA,MACb,WAAW,KAAK;AAAA,MAChB,SAAS,KAAK;AAAA,MACd,QAAQ,KAAK,UAAU,KAAK;AAAA,IAC9B;AAAA,IACA,MAAM;AAAA,IACN,OAAO;AAAA;AAAA;AAIX,SAAS,mBAAmB,CAAC,OAAkC;AAAA,EAC7D,MAAM,UAAoB,CAAC;AAAA,EAC3B,IAAI,CAAC,MAAM;AAAA,IAAQ,QAAQ,KAAK,QAAQ;AAAA,EACxC,IAAI,CAAC,MAAM;AAAA,IAAW,QAAQ,KAAK,WAAW;AAAA,EAC9C,IAAI,CAAC,MAAM;AAAA,IAAS,QAAQ,KAAK,SAAS;AAAA,EAC1C,IAAI,CAAC,MAAM;AAAA,IAAQ,QAAQ,KAAK,QAAQ;AAAA,EAExC,IAAI,QAAQ,SAAS,GAAG;AAAA,IACtB,MAAM,IAAI,gBAAgB,iCAAiC,QAAQ,KAAK,IAAI,GAAG;AAAA,EACjF;AAAA;AAGK,IAAM,kBAA6E;AAAA,EACxF,UAAU;AAAA,IACR,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,UAAU;AAAA,IACR,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,UAAU;AAAA,IACR,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,UAAU;AAAA,IACR,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AACF;AAEO,SAAS,oBAAoB,CAAC,MAAgE;AAAA,EACnG,OAAO,gBAAgB,SAAS;AAAA;;;AE7HlC,IAAM,8BAA8B;AAAA;AAE7B,MAAM,SAAS;AAAA,EACZ;AAAA,EACA;AAAA,EAER,WAAW,CAAC,SAA2B;AAAA,IACrC,KAAK,cAAc,gBAAgB,OAAO;AAAA,IAC1C,KAAK,eAAe,IAAI,aAAa,SAAS,aAAa;AAAA;AAAA,OAGvD,eAAc,GAAoB;AAAA,IACtC,MAAM,SAAS,KAAK,aAAa,KAAK;AAAA,IACtC,IAAI,KAAK,aAAa,QAAQ,MAAM,GAAG;AAAA,MACrC,OAAO,OAAO;AAAA,IAChB;AAAA,IAEA,MAAM,MAAM,6CAA6C,mBAAmB,KAAK,YAAY,MAAM,eAAe,mBAAmB,KAAK,YAAY,SAAS;AAAA,IAE/J,MAAM,WAAW,MAAM,MAAM,KAAK,EAAE,QAAQ,MAAM,CAAC;AAAA,IAEnD,IAAI,CAAC,SAAS,IAAI;AAAA,MAChB,MAAM,IAAI,WAAW,oCAAoC,SAAS,QAAQ;AAAA,IAC5E;AAAA,IAEA,MAAM,OAAQ,MAAM,SAAS,KAAK;AAAA,IAElC,IAAI,KAAK,YAAY,GAAG;AAAA,MACtB,MAAM,IAAI,WAAW,+BAA+B,KAAK,UAAU,iBAAiB;AAAA,IACtF;AAAA,IAEA,IAAI,CAAC,KAAK,cAAc;AAAA,MACtB,MAAM,IAAI,WAAW,kCAAkC;AAAA,IACzD;AAAA,IAEA,MAAM,mBAAmB,KAAK,cAAc;AAAA,IAC5C,KAAK,aAAa,KAAK;AAAA,MACrB,aAAa,KAAK;AAAA,MAClB,WAAW,KAAK,IAAI,KAAK,mBAAmB,+BAA+B;AAAA,IAC7E,CAAC;AAAA,IAED,OAAO,KAAK;AAAA;AAAA,OAGR,aAAY,CAAC,OAAe,SAA6C;AAAA,IAC7E,IAAI;AAAA,MACF,MAAM,cAAc,MAAM,KAAK,eAAe;AAAA,MAC9C,MAAM,MAAM,uFAAuF;AAAA,MAEnG,MAAM,OAAO;AAAA,QACX,UAAU,KAAK,YAAY;AAAA,QAC3B,aAAa,KAAK,YAAY;AAAA,QAC9B,KAAK;AAAA,UACH,SAAS;AAAA,UACT,UAAU;AAAA,YACR;AAAA,YACA,MAAM;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAAA,MAEA,MAAM,WAAW,MAAM,MAAM,KAAK;AAAA,QAChC,QAAQ;AAAA,QACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,QAC9C,MAAM,KAAK,UAAU,IAAI;AAAA,MAC3B,CAAC;AAAA,MAED,IAAI,CAAC,SAAS,IAAI;AAAA,QAChB,OAAO,EAAE,SAAS,OAAO,OAAO,QAAQ,SAAS,SAAS;AAAA,MAC5D;AAAA,MAEA,MAAM,OAAQ,MAAM,SAAS,KAAK;AAAA,MAElC,IAAI,KAAK,YAAY,GAAG;AAAA,QACtB,OAAO,EAAE,SAAS,OAAO,OAAO,KAAK,UAAU,eAAe,KAAK,UAAU;AAAA,MAC/E;AAAA,MAEA,OAAO,EAAE,SAAS,MAAM,QAAQ,KAAK,SAAS,SAAS,EAAE;AAAA,MACzD,OAAO,OAAO;AAAA,MACd,OAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MAC9D;AAAA;AAAA;AAAA,OAIE,SAAQ,CAAC,SAA6C;AAAA,IAC1D,IAAI;AAAA,MACF,MAAM,cAAc,MAAM,KAAK,eAAe;AAAA,MAC9C,MAAM,MAAM,uFAAuF;AAAA,MAEnG,MAAM,OAAO;AAAA,QACX,UAAU,KAAK,YAAY;AAAA,QAC3B,aAAa,KAAK,YAAY;AAAA,QAC9B,KAAK;AAAA,UACH,SAAS;AAAA,UACT,MAAM,EAAE,QAAQ;AAAA,QAClB;AAAA,MACF;AAAA,MAEA,MAAM,WAAW,MAAM,MAAM,KAAK;AAAA,QAChC,QAAQ;AAAA,QACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,QAC9C,MAAM,KAAK,UAAU,IAAI;AAAA,MAC3B,CAAC;AAAA,MAED,IAAI,CAAC,SAAS,IAAI;AAAA,QAChB,OAAO,EAAE,SAAS,OAAO,OAAO,QAAQ,SAAS,SAAS;AAAA,MAC5D;AAAA,MAEA,MAAM,OAAQ,MAAM,SAAS,KAAK;AAAA,MAElC,IAAI,KAAK,YAAY,GAAG;AAAA,QACtB,OAAO,EAAE,SAAS,OAAO,OAAO,KAAK,UAAU,eAAe,KAAK,UAAU;AAAA,MAC/E;AAAA,MAEA,OAAO,EAAE,SAAS,MAAM,QAAQ,KAAK,SAAS,SAAS,EAAE;AAAA,MACzD,OAAO,OAAO;AAAA,MACd,OAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MAC9D;AAAA;AAAA;AAAA,OAIE,cAAa,CAAC,QAAqC;AAAA,IACvD,IAAI;AAAA,MACF,MAAM,cAAc,MAAM,KAAK,eAAe;AAAA,MAC9C,MAAM,MAAM,wFAAwF;AAAA,MAEpG,MAAM,OAAO;AAAA,QACX,UAAU,KAAK,YAAY;AAAA,QAC3B,SAAS,OAAO,MAAM;AAAA,MACxB;AAAA,MAEA,MAAM,WAAW,MAAM,MAAM,KAAK;AAAA,QAChC,QAAQ;AAAA,QACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,QAC9C,MAAM,KAAK,UAAU,IAAI;AAAA,MAC3B,CAAC;AAAA,MAED,IAAI,CAAC,SAAS,IAAI;AAAA,QAChB,OAAO,EAAE,SAAS,OAAO,OAAO,QAAQ,SAAS,SAAS;AAAA,MAC5D;AAAA,MAEA,MAAM,OAAQ,MAAM,SAAS,KAAK;AAAA,MAElC,IAAI,KAAK,YAAY,GAAG;AAAA,QACtB,OAAO,EAAE,SAAS,OAAO,OAAO,KAAK,UAAU,eAAe,KAAK,UAAU;AAAA,MAC/E;AAAA,MAEA,OAAO;AAAA,QACL,SAAS;AAAA,QACT,mBAAmB,KAAK,aAAa;AAAA,QACrC,qBAAqB,KAAK,aAAa;AAAA,QACvC,kBAAkB,KAAK,aAAa;AAAA,QACpC,gBAAgB,KAAK,aAAa;AAAA,QAClC,kBAAkB,KAAK,aAAa;AAAA,QACpC,eAAe,KAAK,aAAa;AAAA,MACnC;AAAA,MACA,OAAO,OAAO;AAAA,MACd,OAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MAC9D;AAAA;AAAA;AAAA,SAIG,oBAAoB,CAAC,MAAgE;AAAA,IAC1F,OAAO,qBAAqB,IAAI;AAAA;AAEpC;;;AH/KA,IAAM,aAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AACxD,IAAM,cAAc,KAAK,MAAM,cAAa,MAAK,YAAW,iBAAiB,GAAG,OAAO,CAAC;AAExF,IAAM,UAAU,IAAI;AAEpB,QACG,KAAK,kBAAkB,EACvB,YAAY,kEAAkE,EAC9E,QAAQ,YAAY,OAAO,EAC3B,OAAO,6BAA6B,+BAA+B;AAEtE,QACG,QAAQ,cAAc,EACtB,YAAY,qCAAqC,EACjD,eAAe,mBAAmB,eAAe,EACjD,eAAe,uBAAuB,kBAAkB,EACxD,OAAO,OAAO,SAAS,QAAQ;AAAA,EAC9B,MAAM,aAAa,IAAI,gBAAgB;AAAA,EACvC,MAAM,gBAAiC,CAAC;AAAA,EAExC,IAAI,WAAW,iBAAiB;AAAA,IAC9B,cAAc,kBAAkB,WAAW;AAAA,EAC7C;AAAA,EAEA,IAAI;AAAA,IACF,MAAM,SAAS,IAAI,SAAS,aAAa;AAAA,IACzC,MAAM,SAAS,MAAM,OAAO,aAAa,QAAQ,OAAO,QAAQ,OAAO;AAAA,IAEvE,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,IAC3C,QAAQ,KAAK,OAAO,UAAU,IAAI,CAAC;AAAA,IACnC,OAAO,OAAO;AAAA,IACd,MAAM,SAAS;AAAA,MACb,SAAS;AAAA,MACT,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,IAC9D;AAAA,IACA,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,IAC3C,QAAQ,KAAK,CAAC;AAAA;AAAA,CAEjB;AAEH,QACG,QAAQ,UAAU,EAClB,YAAY,iCAAiC,EAC7C,eAAe,uBAAuB,cAAc,EACpD,OAAO,OAAO,SAAS,QAAQ;AAAA,EAC9B,MAAM,aAAa,IAAI,gBAAgB;AAAA,EACvC,MAAM,gBAAiC,CAAC;AAAA,EAExC,IAAI,WAAW,iBAAiB;AAAA,IAC9B,cAAc,kBAAkB,WAAW;AAAA,EAC7C;AAAA,EAEA,IAAI;AAAA,IACF,MAAM,SAAS,IAAI,SAAS,aAAa;AAAA,IACzC,MAAM,SAAS,MAAM,OAAO,SAAS,QAAQ,OAAO;AAAA,IAEpD,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,IAC3C,QAAQ,KAAK,OAAO,UAAU,IAAI,CAAC;AAAA,IACnC,OAAO,OAAO;AAAA,IACd,MAAM,SAAS;AAAA,MACb,SAAS;AAAA,MACT,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,IAC9D;AAAA,IACA,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,IAC3C,QAAQ,KAAK,CAAC;AAAA;AAAA,CAEjB;AAEH,QAAQ,MAAM;",
+  "debugId": "4B8AA822D0E0923864756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dingtalk-manager",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "DingTalk work notification API client for Node.js/Bun - send markdown and text messages",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,6 +12,9 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "bin": {
+    "dingtalk-manager": "./dist/cli.js"
+  },
   "files": [
     "dist",
     "README.md",
@@ -20,7 +23,7 @@
   "scripts": {
     "build": "bun run build:clean && bun run build:js && bun run build:types",
     "build:clean": "rm -rf dist",
-    "build:js": "bun build ./src/index.ts --outdir ./dist --target node --format esm --sourcemap --external commander",
+    "build:js": "bun build ./src/index.ts ./src/cli.ts --outdir ./dist --target node --format esm --sourcemap --external commander",
     "build:types": "tsc --emitDeclarationOnly --declaration --outDir dist",
     "test": "bun test",
     "test:watch": "bun test --watch",
@@ -49,6 +52,9 @@
   "engines": {
     "node": ">=18.0.0"
   },
+  "dependencies": {
+    "commander": "^12.0.0"
+  },
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.3.0"