dingtalk-manager 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 buwai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,267 @@
+# dingtalk-manager
+
+钉钉工作通知 API 客户端，支持 Node.js/Bun。通过工作通知 API 向钉钉用户发送 Markdown 和文本消息。
+
+## 安装
+
+```bash
+# npm
+npm install dingtalk-manager
+
+# yarn
+yarn add dingtalk-manager
+
+# bun
+bun add dingtalk-manager
+```
+
+## 快速开始
+
+### 方式一：直接传入凭证
+
+```typescript
+import { DingTalk } from 'dingtalk-manager';
+
+const client = new DingTalk({
+  credentials: {
+    appKey: 'your-app-key',
+    appSecret: 'your-app-secret',
+    agentId: 'your-agent-id',
+    userId: 'target-user-id',
+  },
+});
+
+// 发送 Markdown 消息
+const result = await client.sendMarkdown('标题', '**加粗** 内容\n- 项目 1\n- 项目 2');
+
+if (result.success) {
+  console.log('消息已发送！Task ID:', result.taskId);
+}
+
+// 发送文本消息
+await client.sendText('纯文本消息');
+```
+
+### 方式二：环境变量
+
+```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"
+```
+
+```typescript
+import { DingTalk } from 'dingtalk-manager';
+
+const client = new DingTalk();
+await client.sendMarkdown('标题', '内容');
+```
+
+### 方式三：凭证文件
+
+```typescript
+import { DingTalk } from 'dingtalk-manager';
+
+const client = new DingTalk({
+  credentialsPath: '/path/to/credentials.json',
+});
+
+await client.sendMarkdown('标题', '内容');
+```
+
+凭证文件格式 (`credentials.json`):
+
+```json
+{
+  "appKey": "your-app-key",
+  "appSecret": "your-app-secret",
+  "agentId": "your-agent-id",
+  "userId": "target-user-id"
+}
+```
+
+## API 参考
+
+### `new DingTalk(options?)`
+
+创建 DingTalk 客户端实例。
+
+| 参数 | 类型 | 说明 |
+|--------|------|-------------|
+| `credentials` | `DingTalkCredentials` | 直接传入凭证（优先级最高） |
+| `credentialsPath` | `string` | 凭证 JSON 文件路径 |
+| `tokenCacheDir` | `string` | access_token 缓存目录（默认：`os.tmpdir()`） |
+
+### `client.sendMarkdown(title, content)`
+
+发送 Markdown 消息。
+
+```typescript
+const result = await client.sendMarkdown('报告', `
+## 每日报告
+
+- 任务 1: 完成 ✅
+- 任务 2: 待处理 ⏳
+
+**总计**: 2 个任务
+`);
+
+console.log(result.success);    // true
+console.log(result.taskId);     // '123456789'
+console.log(result.error);      // undefined（成功时）
+```
+
+### `client.sendText(content)`
+
+发送纯文本消息。
+
+```typescript
+const result = await client.sendText('你好，这是一条纯文本消息。');
+```
+
+### `client.getSendResult(taskId)`
+
+查询消息发送状态。
+
+```typescript
+const status = await client.getSendResult('123456789');
+
+console.log(status.success);           // true
+console.log(status.readUserIdList);    // ['user1', 'user2'] 已读用户
+console.log(status.unreadUserIdList);  // ['user3'] 未读用户
+console.log(status.forbiddenList);     // [{ code: '143106', userid: 'user4', count: 1 }] 被限流用户
+```
+
+### `DingTalk.getForbiddenCodeInfo(code)`
+
+获取错误码的可读描述。
+
+```typescript
+const info = DingTalk.getForbiddenCodeInfo('143106');
+// {
+//   description: '应用重复消息发送限超限（同一用户每天只能接收一条相同内容的消息）',
+//   solution: '修改消息内容后重新发送，或等待明天自动重置'
+// }
+```
+
+### `client.getAccessToken()`
+
+获取 access_token（带缓存）。通常不需要直接调用，但如有需要可以使用。
+
+```typescript
+const token = await client.getAccessToken();
+```
+
+## 错误码
+
+| 错误码 | 描述 | 解决方案 |
+|------|-------------|----------|
+| 143103 | 企业应用消息发送QPM超限 | 稍后重试，或优化发送频率 |
+| 143104 | 企业每分钟发送QPM超限 | 稍后重试，或优化发送频率 |
+| 143105 | 应用发送日限超限 | 已达每日上限，明天再试 |
+| 143106 | 重复消息发送限超限 | 修改消息内容，或等待明天 |
+
+## 错误处理
+
+```typescript
+import { DingTalk, DingTalkError, TokenError, MessageError, CredentialError } from 'dingtalk-manager';
+
+try {
+  const client = new DingTalk();
+  const result = await client.sendMarkdown('标题', '内容');
+  
+  if (!result.success) {
+    console.error('发送失败:', result.error);
+  }
+} catch (error) {
+  if (error instanceof CredentialError) {
+    console.error('凭证无效:', error.message);
+  } else if (error instanceof TokenError) {
+    console.error('Token 错误:', error.message);
+  } else if (error instanceof DingTalkError) {
+    console.error('钉钉错误:', error.message);
+  }
+}
+```
+
+## Token 缓存
+
+access_token 会自动缓存以减少 API 调用。Token 有效期为 2 小时，本库会提前 5 分钟刷新。
+
+默认缓存位置：`os.tmpdir()/dingtalk-token-cache.json`
+
+自定义缓存目录：
+
+```typescript
+const client = new DingTalk({
+  credentials: { /* ... */ },
+  tokenCacheDir: '/custom/cache/directory',
+});
+```
+
+## 开发
+
+### 安装依赖
+
+```bash
+bun install
+```
+
+### 可用命令
+
+| 命令 | 说明 |
+|------|------|
+| `bun run build` | 完整构建（清理 → 编译 JS → 生成类型声明） |
+| `bun run build:clean` | 清理 `dist/` 目录 |
+| `bun run build:js` | 编译 TypeScript 到 ES Module JS（使用 Bun） |
+| `bun run build:types` | 生成 `.d.ts` 类型声明文件（使用 tsc） |
+| `bun test` | 运行所有测试 |
+| `bun run test:watch` | 监听模式运行测试（文件变化自动重跑） |
+| `bun run release` | 构建并发布到 npm |
+| `bun run release:dry` | 模拟发布（检查打包内容，不实际上传） |
+
+### 命令详解
+
+#### 构建相关
+
+```bash
+# 完整构建流程
+bun run build
+# 等同于依次执行：
+# 1. bun run build:clean  → 删除 dist/ 目录
+# 2. bun run build:js     → 编译 src/index.ts 到 dist/index.js
+# 3. bun run build:types  → 生成 dist/*.d.ts 类型声明
+```
+
+#### 测试相关
+
+```bash
+# 运行测试
+bun test
+
+# 监听模式（开发时推荐）
+bun run test:watch
+```
+
+#### 发布相关
+
+```bash
+# 模拟发布（检查打包内容、文件大小等）
+bun run release:dry
+
+# 正式发布（会自动执行 prepublishOnly 钩子）
+npm publish
+# 或使用封装命令
+bun run release
+```
+
+**注意**：`npm publish` 会自动触发 `prepublishOnly` 钩子，先执行 `bun run build && bun test`，确保构建和测试都通过后才发布。
+
+## 环境要求
+
+- Node.js >= 18.0.0 或 Bun >= 1.0.0
+
+## 许可证
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,15 @@
+import type { DingTalkOptions, SendMessageResult, SendResult } from './types.js';
+export declare class DingTalk {
+    private credentials;
+    private tokenManager;
+    constructor(options?: DingTalkOptions);
+    getAccessToken(): Promise<string>;
+    sendMarkdown(title: string, content: string): Promise<SendMessageResult>;
+    sendText(content: string): Promise<SendMessageResult>;
+    getSendResult(taskId: string): Promise<SendResult>;
+    static getForbiddenCodeInfo(code: string): {
+        description: string;
+        solution: string;
+    } | null;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,iBAAiB,EACjB,UAAU,EAIX,MAAM,YAAY,CAAC;AAMpB,qBAAa,QAAQ;IACnB,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,YAAY,CAAe;gBAEvB,OAAO,CAAC,EAAE,eAAe;IAK/B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAiCjC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0CxE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuCrD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA2CxD,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAG5F"}

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+export declare class DingTalkError extends Error {
+    constructor(message: string);
+}
+export declare class TokenError extends DingTalkError {
+    constructor(message: string);
+}
+export declare class MessageError extends DingTalkError {
+    constructor(message: string);
+}
+export declare class CredentialError extends DingTalkError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,UAAW,SAAQ,aAAa;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { DingTalk } from './client.js';
+export type { DingTalkOptions, DingTalkCredentials, SendMessageResult, SendResult, ForbiddenInfo, ForbiddenCodeInfo, TokenCache, } from './types.js';
+export { DingTalkError, TokenError, MessageError, CredentialError } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,307 @@
+// 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);
+  }
+}
+export {
+  TokenError,
+  MessageError,
+  DingTalkError,
+  DingTalk,
+  CredentialError
+};
+
+//# debugId=7AFD9129F0A4FCB764756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/utils.ts", "../src/errors.ts", "../src/client.ts"],
+  "sourcesContent": [
+    "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": "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",
+  "debugId": "7AFD9129F0A4FCB764756E2164756E21",
+  "names": []
+}

package/dist/types.d.ts

@@ -0,0 +1,132 @@
+/**
+ * DingTalk credentials for API authentication
+ */
+export interface DingTalkCredentials {
+    /** DingTalk application AppKey */
+    appKey: string;
+    /** DingTalk application AppSecret */
+    appSecret: string;
+    /** DingTalk application AgentId */
+    agentId: string;
+    /** User ID to receive messages */
+    userId: string;
+}
+/**
+ * Options for configuring the DingTalk client
+ */
+export interface DingTalkOptions {
+    /**
+     * Direct credentials configuration
+     * Takes priority over credentialsPath
+     */
+    credentials?: DingTalkCredentials;
+    /**
+     * Path to credentials JSON file
+     * File should contain: { appKey, appSecret, agentId, userId }
+     * @default undefined (uses environment variables)
+     */
+    credentialsPath?: string;
+    /**
+     * Directory to cache access tokens
+     * @default os.tmpdir() for safety
+     */
+    tokenCacheDir?: string;
+}
+/**
+ * Internal token cache structure
+ */
+export interface TokenCache {
+    /** Cached access token */
+    accessToken: string;
+    /** Expiration timestamp in milliseconds */
+    expiresAt: number;
+}
+/**
+ * Result of sending a message
+ */
+export interface SendMessageResult {
+    /** Whether the message was sent successfully */
+    success: boolean;
+    /** Task ID for tracking message delivery (available on success) */
+    taskId?: string;
+    /** Error message (available on failure) */
+    error?: string;
+}
+/**
+ * Information about a forbidden/limited user
+ */
+export interface ForbiddenInfo {
+    /** Error code */
+    code: string;
+    /** Count of forbidden messages */
+    count: number;
+    /** User ID that was forbidden */
+    userid: string;
+}
+/**
+ * Result of querying message delivery status
+ */
+export interface SendResult {
+    /** Whether the query was successful */
+    success: boolean;
+    /** List of user IDs who read the message */
+    readUserIdList?: string[];
+    /** List of user IDs who haven't read the message */
+    unreadUserIdList?: string[];
+    /** List of user IDs for whom sending failed */
+    failedUserIdList?: string[];
+    /** List of invalid user IDs */
+    invalidUserIdList?: string[];
+    /** List of user IDs who were rate-limited */
+    forbiddenUserIdList?: string[];
+    /** Detailed forbidden information with error codes */
+    forbiddenList?: ForbiddenInfo[];
+    /** Error message (available on failure) */
+    error?: string;
+}
+/**
+ * Information about a DingTalk error code
+ */
+export interface ForbiddenCodeInfo {
+    /** Human-readable description of the error */
+    description: string;
+    /** Suggested solution for the error */
+    solution: string;
+}
+/**
+ * DingTalk API response for token endpoint
+ */
+export interface TokenResponse {
+    errcode?: number;
+    errmsg?: string;
+    access_token?: string;
+    expires_in?: number;
+}
+/**
+ * DingTalk API response for message sending
+ */
+export interface SendResponse {
+    errcode?: number;
+    errmsg?: string;
+    task_id?: number;
+}
+/**
+ * DingTalk API response for message status query
+ */
+export interface SendResultResponse {
+    errcode?: number;
+    errmsg?: string;
+    send_result?: {
+        invalid_user_id_list?: string[];
+        forbidden_user_id_list?: string[];
+        failed_user_id_list?: string[];
+        read_user_id_list?: string[];
+        unread_user_id_list?: string[];
+        forbidden_list?: Array<{
+            code: string;
+            count: number;
+            userid: string;
+        }>;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -0,0 +1,19 @@
+import type { DingTalkCredentials, DingTalkOptions, TokenCache } from './types.js';
+export declare class TokenManager {
+    private cacheDir;
+    private cacheFile;
+    constructor(cacheDir?: string);
+    load(): TokenCache | null;
+    save(cache: TokenCache): void;
+    isValid(cache: TokenCache | null): cache is TokenCache;
+}
+export declare function loadCredentials(options?: DingTalkOptions): DingTalkCredentials;
+export declare const FORBIDDEN_CODES: Record<string, {
+    description: string;
+    solution: string;
+}>;
+export declare function getForbiddenCodeInfo(code: string): {
+    description: string;
+    solution: string;
+} | null;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAUnF,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,CAAC,EAAE,MAAM;IAK7B,IAAI,IAAI,UAAU,GAAG,IAAI;IAYzB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAW7B,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,KAAK,IAAI,UAAU;CAGvD;AAED,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,mBAAmB,CAuB9E;AA4CD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAiBrF,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAEnG"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "dingtalk-manager",
+  "version": "1.0.0",
+  "description": "DingTalk work notification API client for Node.js/Bun - send markdown and text messages",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "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:types": "tsc --emitDeclarationOnly --declaration --outDir dist",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "prepublishOnly": "bun run build && bun test",
+    "release": "bun run build && npm publish",
+    "release:dry": "npm publish --dry-run"
+  },
+  "keywords": [
+    "dingtalk",
+    "钉钉",
+    "notification",
+    "work-notify",
+    "message",
+    "markdown"
+  ],
+  "author": "buwai",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/buwai/dingtalk-manager.git"
+  },
+  "bugs": {
+    "url": "https://github.com/buwai/dingtalk-manager/issues"
+  },
+  "homepage": "https://github.com/buwai/dingtalk-manager#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.3.0"
+  }
+}