@huo15/dingtalk-connector-pro 1.0.4 → 1.0.7

package/dist/src/core/provider.js

@@ -0,0 +1,59 @@
+import * as monitorState from "./state.js";
+import { createLogger } from "../utils/logger.js";
+// 只解构 monitorState 的导出
+const { clearDingtalkWebhookRateLimitStateForTest, getDingtalkWebhookRateLimitStateSizeForTest, isWebhookRateLimitedForTest, stopDingtalkMonitorState, } = monitorState;
+export { clearDingtalkWebhookRateLimitStateForTest, getDingtalkWebhookRateLimitStateSizeForTest, isWebhookRateLimitedForTest, } from "./state.js";
+export async function monitorDingtalkProvider(opts = {}) {
+    const cfg = opts.config;
+    if (!cfg) {
+        throw new Error("Config is required for DingTalk monitor");
+    }
+    const log = createLogger(cfg.channels?.["dingtalk-connector"]?.debug ?? false);
+    // 并行导入所有模块（无循环依赖，可以并行）
+    const [accountsModule, monitorAccountModule, monitorSingleModule] = await Promise.all([
+        import("../config/accounts"),
+        import("./message-handler"),
+        import("./connection"),
+    ]);
+    const { resolveDingtalkAccount, listEnabledDingtalkAccounts } = accountsModule;
+    const { handleDingTalkMessage } = monitorAccountModule;
+    const { monitorSingleAccount, resolveReactionSyntheticEvent } = monitorSingleModule;
+    if (opts.accountId) {
+        const account = resolveDingtalkAccount({ cfg, accountId: opts.accountId });
+        if (!account.enabled || !account.configured) {
+            throw new Error(`DingTalk account "${opts.accountId}" not configured or disabled`);
+        }
+        return monitorSingleAccount({
+            cfg,
+            account,
+            runtime: opts.runtime,
+            abortSignal: opts.abortSignal,
+            messageHandler: handleDingTalkMessage,
+            onStatusChange: opts.onStatusChange,
+        });
+    }
+    const accounts = listEnabledDingtalkAccounts(cfg);
+    if (accounts.length === 0) {
+        throw new Error("No enabled DingTalk accounts configured");
+    }
+    log?.info?.(`dingtalk-connector: starting ${accounts.length} account(s): ${accounts.map((a) => a.accountId).join(", ")}`);
+    const monitorPromises = [];
+    for (const account of accounts) {
+        if (opts.abortSignal?.aborted) {
+            log?.info?.("dingtalk-connector: abort signal received during startup preflight; stopping startup");
+            break;
+        }
+        monitorPromises.push(monitorSingleAccount({
+            cfg,
+            account,
+            runtime: opts.runtime,
+            abortSignal: opts.abortSignal,
+            messageHandler: handleDingTalkMessage,
+            onStatusChange: opts.onStatusChange,
+        }));
+    }
+    await Promise.all(monitorPromises);
+}
+export function stopDingtalkMonitor(accountId) {
+    stopDingtalkMonitorState(accountId);
+}

package/dist/src/core/state.js

@@ -0,0 +1,49 @@
+/**
+ * 钉钉消息流状态管理
+ *
+ * 职责：
+ * - 管理每个钉钉账号的运行状态
+ * - 存储 AbortController 用于优雅停止消息流
+ * - 提供测试工具函数
+ *
+ * 核心功能：
+ * - setDingtalkMonitorState: 设置账号运行状态
+ * - getDingtalkMonitorState: 获取账号运行状态
+ * - stopDingtalkMonitorState: 停止单个或多个账号的消息流
+ * - 测试工具：clearDingtalkWebhookRateLimitStateForTest 等
+ */
+const monitorState = new Map();
+export function setDingtalkMonitorState(accountId, state) {
+    monitorState.set(accountId, state);
+}
+export function getDingtalkMonitorState(accountId) {
+    return monitorState.get(accountId);
+}
+export function stopDingtalkMonitorState(accountId) {
+    if (accountId) {
+        const state = monitorState.get(accountId);
+        if (state?.abortController) {
+            state.abortController.abort();
+        }
+        monitorState.delete(accountId);
+    }
+    else {
+        // Stop all monitors
+        for (const [id, state] of monitorState.entries()) {
+            if (state.abortController) {
+                state.abortController.abort();
+            }
+        }
+        monitorState.clear();
+    }
+}
+// Test utilities
+export function clearDingtalkWebhookRateLimitStateForTest() {
+    // DingTalk doesn't use webhook rate limiting
+}
+export function getDingtalkWebhookRateLimitStateSizeForTest() {
+    return 0;
+}
+export function isWebhookRateLimitedForTest() {
+    return false;
+}

package/dist/src/directory.js

@@ -0,0 +1,53 @@
+import { resolveDingtalkAccount } from "./config/accounts.js";
+import { normalizeDingtalkTarget } from "./targets.js";
+export async function listDingtalkDirectoryPeers(params) {
+    const account = resolveDingtalkAccount({ cfg: params.cfg, accountId: params.accountId });
+    const dingtalkCfg = account.config;
+    const q = params.query?.trim().toLowerCase() || "";
+    const ids = new Set();
+    for (const entry of dingtalkCfg?.allowFrom ?? []) {
+        const trimmed = String(entry).trim();
+        if (trimmed && trimmed !== "*") {
+            ids.add(trimmed);
+        }
+    }
+    return Array.from(ids)
+        .map((raw) => raw.trim())
+        .filter(Boolean)
+        .map((raw) => normalizeDingtalkTarget(raw) ?? raw)
+        .filter((id) => (q ? id.toLowerCase().includes(q) : true))
+        .slice(0, params.limit && params.limit > 0 ? params.limit : undefined)
+        .map((id) => ({ kind: "user", id }));
+}
+export async function listDingtalkDirectoryGroups(params) {
+    const account = resolveDingtalkAccount({ cfg: params.cfg, accountId: params.accountId });
+    const dingtalkCfg = account.config;
+    const q = params.query?.trim().toLowerCase() || "";
+    const ids = new Set();
+    for (const groupId of Object.keys(dingtalkCfg?.groups ?? {})) {
+        const trimmed = groupId.trim();
+        if (trimmed && trimmed !== "*") {
+            ids.add(trimmed);
+        }
+    }
+    for (const entry of dingtalkCfg?.groupAllowFrom ?? []) {
+        const trimmed = String(entry).trim();
+        if (trimmed && trimmed !== "*") {
+            ids.add(trimmed);
+        }
+    }
+    return Array.from(ids)
+        .map((raw) => raw.trim())
+        .filter(Boolean)
+        .filter((id) => (q ? id.toLowerCase().includes(q) : true))
+        .slice(0, params.limit && params.limit > 0 ? params.limit : undefined)
+        .map((id) => ({ kind: "group", id }));
+}
+export async function listDingtalkDirectoryPeersLive(params) {
+    // DingTalk doesn't have a public API to list users, so we fall back to static list
+    return listDingtalkDirectoryPeers(params);
+}
+export async function listDingtalkDirectoryGroupsLive(params) {
+    // DingTalk doesn't have a public API to list groups, so we fall back to static list
+    return listDingtalkDirectoryGroups(params);
+}

package/dist/src/docs.js

@@ -0,0 +1,209 @@
+/**
+ * 钉钉文档 API 客户端
+ * 支持读写钉钉在线文档（文档、表格等）
+ */
+import { getAccessToken, DINGTALK_API } from './utils/index.js';
+import { dingtalkHttp } from './utils/http-client.js';
+// ============ 钉钉文档客户端类 ============
+export class DingtalkDocsClient {
+    config;
+    log;
+    constructor(config, log) {
+        this.config = config;
+        this.log = log;
+    }
+    /** 获取带鉴权的请求头 */
+    async getHeaders() {
+        const token = await getAccessToken(this.config);
+        return {
+            'x-acs-dingtalk-access-token': token,
+            'Content-Type': 'application/json',
+        };
+    }
+    /**
+     * 获取文档元信息
+     */
+    async getDocInfo(spaceId, docId) {
+        try {
+            const headers = await this.getHeaders();
+            this.log?.info?.(`[DingTalk][Docs] 获取文档信息: spaceId=${spaceId}, docId=${docId}`);
+            const resp = await dingtalkHttp.get(`${DINGTALK_API}/v1.0/doc/spaces/${spaceId}/docs/${docId}`, { headers, timeout: 10_000 });
+            const data = resp.data;
+            this.log?.info?.(`[DingTalk][Docs] 文档信息获取成功: title=${data?.title}`);
+            return {
+                docId: data.docId || docId,
+                title: data.title || '',
+                docType: data.docType || 'unknown',
+                creatorId: data.creatorId,
+                updatedAt: data.updatedAt,
+            };
+        }
+        catch (err) {
+            this.log?.error?.(`[DingTalk][Docs] 获取文档信息失败: ${err.message}`);
+            return null;
+        }
+    }
+    /**
+     * 读取文档内容（通过 v2.0/wiki 节点 API）
+     */
+    async readDoc(nodeId, operatorId) {
+        try {
+            const headers = await this.getHeaders();
+            this.log?.info?.(`[DingTalk][Docs] 读取知识库节点: nodeId=${nodeId}, operatorId=${operatorId}`);
+            if (!operatorId) {
+                this.log?.error?.('[DingTalk][Docs] readDoc 需要 operatorId（unionId）');
+                return null;
+            }
+            const resp = await dingtalkHttp.get(`${DINGTALK_API}/v2.0/wiki/nodes/${nodeId}/content`, { headers, params: { operatorId }, timeout: 30_000 });
+            const node = resp.data?.node || resp.data;
+            const name = node.name || '未知文档';
+            const category = node.category || 'unknown';
+            const url = node.url || '';
+            const workspaceId = node.workspaceId || '';
+            const content = [
+                `文档名: ${name}`,
+                `类型: ${category}`,
+                `URL: ${url}`,
+                `工作区: ${workspaceId}`,
+            ].join('\n');
+            this.log?.info?.(`[DingTalk][Docs] 节点信息获取成功: name=${name}, category=${category}`);
+            return content;
+        }
+        catch (err) {
+            this.log?.error?.(`[DingTalk][Docs] 读取节点失败: ${err.message}`);
+            if (err.response) {
+                this.log?.error?.(`[DingTalk][Docs] 错误详情: status=${err.response.status} data=${JSON.stringify(err.response.data)}`);
+            }
+            return null;
+        }
+    }
+    /**
+     * 从 block 树中递归提取纯文本内容
+     */
+    extractTextFromBlocks(blocks) {
+        const result = [];
+        for (const block of blocks) {
+            if (block.text) {
+                result.push(block.text);
+            }
+            if (block.children && block.children.length > 0) {
+                result.push(...this.extractTextFromBlocks(block.children));
+            }
+        }
+        return result;
+    }
+    /**
+     * 向文档追加内容
+     */
+    async appendToDoc(docId, content, index = -1) {
+        try {
+            const headers = await this.getHeaders();
+            this.log?.info?.(`[DingTalk][Docs] 向文档追加内容: docId=${docId}, contentLen=${content.length}`);
+            const body = {
+                blockType: 'PARAGRAPH',
+                body: {
+                    text: content,
+                },
+                index,
+            };
+            await dingtalkHttp.post(`${DINGTALK_API}/v1.0/doc/documents/${docId}/blocks/root/children`, body, { headers, timeout: 10_000 });
+            this.log?.info?.(`[DingTalk][Docs] 内容追加成功`);
+            return true;
+        }
+        catch (err) {
+            this.log?.error?.(`[DingTalk][Docs] 追加内容失败: ${err.message}`);
+            if (err.response) {
+                this.log?.error?.(`[DingTalk][Docs] 错误详情: status=${err.response.status} data=${JSON.stringify(err.response.data)}`);
+            }
+            return false;
+        }
+    }
+    /**
+     * 创建新文档
+     */
+    async createDoc(spaceId, title, content) {
+        try {
+            const headers = await this.getHeaders();
+            this.log?.info?.(`[DingTalk][Docs] 创建文档: spaceId=${spaceId}, title=${title}`);
+            const body = {
+                spaceId,
+                parentDentryId: '',
+                name: title,
+                docType: 'alidoc',
+            };
+            const resp = await dingtalkHttp.post(`${DINGTALK_API}/v1.0/doc/spaces/${spaceId}/docs`, body, { headers, timeout: 10_000 });
+            const data = resp.data;
+            this.log?.info?.(`[DingTalk][Docs] 文档创建成功: docId=${data?.docId}`);
+            const docInfo = {
+                docId: data.docId || data.dentryUuid || '',
+                title: title,
+                docType: data.docType || 'alidoc',
+            };
+            if (content && docInfo.docId) {
+                await this.appendToDoc(docInfo.docId, content);
+            }
+            return docInfo;
+        }
+        catch (err) {
+            this.log?.error?.(`[DingTalk][Docs] 创建文档失败: ${err.message}`);
+            if (err.response) {
+                this.log?.error?.(`[DingTalk][Docs] 错误详情: status=${err.response.status} data=${JSON.stringify(err.response.data)}`);
+            }
+            return null;
+        }
+    }
+    /**
+     * 搜索文档
+     */
+    async searchDocs(keyword, spaceId) {
+        try {
+            const headers = await this.getHeaders();
+            this.log?.info?.(`[DingTalk][Docs] 搜索文档: keyword=${keyword}, spaceId=${spaceId || '全部'}`);
+            const body = { keyword, maxResults: 20 };
+            if (spaceId)
+                body.spaceId = spaceId;
+            const resp = await dingtalkHttp.post(`${DINGTALK_API}/v1.0/doc/docs/search`, body, { headers, timeout: 10_000 });
+            const items = resp.data?.items || [];
+            const docs = items.map((item) => ({
+                docId: item.docId || item.dentryUuid || '',
+                title: item.name || item.title || '',
+                docType: item.docType || 'unknown',
+                creatorId: item.creatorId,
+                updatedAt: item.updatedAt,
+            }));
+            this.log?.info?.(`[DingTalk][Docs] 搜索到 ${docs.length} 个文档`);
+            return docs;
+        }
+        catch (err) {
+            this.log?.error?.(`[DingTalk][Docs] 搜索文档失败: ${err.message}`);
+            return [];
+        }
+    }
+    /**
+     * 列出空间下的文档
+     */
+    async listDocs(spaceId, parentId) {
+        try {
+            const headers = await this.getHeaders();
+            this.log?.info?.(`[DingTalk][Docs] 列出文档: spaceId=${spaceId}, parentId=${parentId || '根目录'}`);
+            const params = { maxResults: 50 };
+            if (parentId)
+                params.parentDentryId = parentId;
+            const resp = await dingtalkHttp.get(`${DINGTALK_API}/v1.0/doc/spaces/${spaceId}/dentries`, { headers, params, timeout: 10_000 });
+            const items = resp.data?.items || [];
+            const docs = items.map((item) => ({
+                docId: item.dentryUuid || item.docId || '',
+                title: item.name || '',
+                docType: item.docType || item.dentryType || 'unknown',
+                creatorId: item.creatorId,
+                updatedAt: item.updatedAt,
+            }));
+            this.log?.info?.(`[DingTalk][Docs] 列出 ${docs.length} 个文档/目录`);
+            return docs;
+        }
+        catch (err) {
+            this.log?.error?.(`[DingTalk][Docs] 列出文档失败: ${err.message}`);
+            return [];
+        }
+    }
+}