@huo15/dingtalk-connector-pro 1.0.0 → 1.0.2

package/src/core/provider.ts

@@ -1,111 +0,0 @@
-/**
- * 钉钉消息流 Provider 入口
- *
- * 职责：
- * - 提供 monitorDingtalkProvider 函数作为钉钉消息流的统一入口
- * - 协调单账号和多账号监控场景
- * - 并行导入连接层和消息处理模块，避免循环依赖
- *
- * 主要功能：
- * - 根据 accountId 参数决定启动单账号或所有账号
- * - 验证账号配置状态
- * - 并行启动多个账号的消息流连接
- */
-import type { ClawdbotConfig, RuntimeEnv } from "openclaw/plugin-sdk";
-import * as monitorState from "./state";
-import { createLogger } from "../utils/logger";
-
-// 只解构 monitorState 的导出
-const {
-  clearDingtalkWebhookRateLimitStateForTest,
-  getDingtalkWebhookRateLimitStateSizeForTest,
-  isWebhookRateLimitedForTest,
-  stopDingtalkMonitorState,
-} = monitorState;
-
-export type MonitorDingtalkOpts = {
-  config?: ClawdbotConfig;
-  runtime?: RuntimeEnv;
-  abortSignal?: AbortSignal;
-  accountId?: string;
-  /** 可选：连接状态变更时回调，用于更新 UI 显示的 Connected / Last inbound 字段 */
-  onStatusChange?: (patch: Record<string, unknown>) => void;
-};
-
-export {
-  clearDingtalkWebhookRateLimitStateForTest,
-  getDingtalkWebhookRateLimitStateSizeForTest,
-  isWebhookRateLimitedForTest,
-} from "./state";
-
-// 只导出类型，不 re-export 函数（避免循环依赖）
-export type { DingtalkReactionCreatedEvent } from "./connection";
-
-export async function monitorDingtalkProvider(opts: MonitorDingtalkOpts = {}): Promise<void> {
-  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: Promise<void>[] = [];
-  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?: string): void {
-  stopDingtalkMonitorState(accountId);
-}

package/src/core/state.ts

@@ -1,54 +0,0 @@
-/**
- * 钉钉消息流状态管理
- * 
- * 职责：
- * - 管理每个钉钉账号的运行状态
- * - 存储 AbortController 用于优雅停止消息流
- * - 提供测试工具函数
- * 
- * 核心功能：
- * - setDingtalkMonitorState: 设置账号运行状态
- * - getDingtalkMonitorState: 获取账号运行状态
- * - stopDingtalkMonitorState: 停止单个或多个账号的消息流
- * - 测试工具：clearDingtalkWebhookRateLimitStateForTest 等
- */
-const monitorState = new Map<string, { running: boolean; abortController?: AbortController }>();
-
-export function setDingtalkMonitorState(accountId: string, state: { running: boolean; abortController?: AbortController }): void {
-  monitorState.set(accountId, state);
-}
-
-export function getDingtalkMonitorState(accountId: string): { running: boolean; abortController?: AbortController } | undefined {
-  return monitorState.get(accountId);
-}
-
-export function stopDingtalkMonitorState(accountId?: string): void {
-  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(): void {
-  // DingTalk doesn't use webhook rate limiting
-}
-
-export function getDingtalkWebhookRateLimitStateSizeForTest(): number {
-  return 0;
-}
-
-export function isWebhookRateLimitedForTest(): boolean {
-  return false;
-}

package/src/directory.ts

@@ -1,95 +0,0 @@
-import type { ClawdbotConfig } from "openclaw/plugin-sdk";
-import { resolveDingtalkAccount } from "./config/accounts.ts";
-import { normalizeDingtalkTarget } from "./targets.ts";
-
-export type DingtalkDirectoryPeer = {
-  kind: "user";
-  id: string;
-  name?: string;
-};
-
-export type DingtalkDirectoryGroup = {
-  kind: "group";
-  id: string;
-  name?: string;
-};
-
-export async function listDingtalkDirectoryPeers(params: {
-  cfg: ClawdbotConfig;
-  query?: string;
-  limit?: number;
-  accountId?: string;
-}): Promise<DingtalkDirectoryPeer[]> {
-  const account = resolveDingtalkAccount({ cfg: params.cfg, accountId: params.accountId });
-  const dingtalkCfg = account.config;
-  const q = params.query?.trim().toLowerCase() || "";
-  const ids = new Set<string>();
-
-  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" as const, id }));
-}
-
-export async function listDingtalkDirectoryGroups(params: {
-  cfg: ClawdbotConfig;
-  query?: string;
-  limit?: number;
-  accountId?: string;
-}): Promise<DingtalkDirectoryGroup[]> {
-  const account = resolveDingtalkAccount({ cfg: params.cfg, accountId: params.accountId });
-  const dingtalkCfg = account.config;
-  const q = params.query?.trim().toLowerCase() || "";
-  const ids = new Set<string>();
-
-  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" as const, id }));
-}
-
-export async function listDingtalkDirectoryPeersLive(params: {
-  cfg: ClawdbotConfig;
-  query?: string;
-  limit?: number;
-  accountId?: string;
-}): Promise<DingtalkDirectoryPeer[]> {
-  // 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: {
-  cfg: ClawdbotConfig;
-  query?: string;
-  limit?: number;
-  accountId?: string;
-}): Promise<DingtalkDirectoryGroup[]> {
-  // DingTalk doesn't have a public API to list groups, so we fall back to static list
-  return listDingtalkDirectoryGroups(params);
-}

package/src/docs.ts

@@ -1,293 +0,0 @@
-/**
- * 钉钉文档 API 客户端
- * 支持读写钉钉在线文档（文档、表格等）
- */
-
-import type { DingtalkConfig } from './types/index.ts';
-import { getAccessToken, DINGTALK_API } from './utils/index.ts';
-import { dingtalkHttp } from './utils/http-client.ts';
-
-// ============ 类型定义 ============
-
-/** 文档信息接口 */
-export interface DocInfo {
-  docId: string;
-  title: string;
-  docType: string;
-  creatorId?: string;
-  updatedAt?: string;
-}
-
-/** 文档内容块 */
-interface DocBlock {
-  blockId: string;
-  blockType: string;
-  text?: string;
-  children?: DocBlock[];
-}
-
-// ============ 钉钉文档客户端类 ============
-
-export class DingtalkDocsClient {
-  private config: DingtalkConfig;
-  private log?: any;
-
-  constructor(config: DingtalkConfig, log?: any) {
-    this.config = config;
-    this.log = log;
-  }
-
-  /** 获取带鉴权的请求头 */
-  private async getHeaders(): Promise<Record<string, string>> {
-    const token = await getAccessToken(this.config);
-    return {
-      'x-acs-dingtalk-access-token': token,
-      'Content-Type': 'application/json',
-    };
-  }
-
-  /**
-   * 获取文档元信息
-   */
-  async getDocInfo(spaceId: string, docId: string): Promise<DocInfo | null> {
-    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: any) {
-      this.log?.error?.(`[DingTalk][Docs] 获取文档信息失败: ${err.message}`);
-      return null;
-    }
-  }
-
-  /**
-   * 读取文档内容（通过 v2.0/wiki 节点 API）
-   */
-  async readDoc(nodeId: string, operatorId?: string): Promise<string | null> {
-    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: any) {
-      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 树中递归提取纯文本内容
-   */
-  private extractTextFromBlocks(blocks: DocBlock[]): string[] {
-    const result: string[] = [];
-    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: string,
-    content: string,
-    index: number = -1,
-  ): Promise<boolean> {
-    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: any) {
-      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: string,
-    title: string,
-    content?: string,
-  ): Promise<DocInfo | null> {
-    try {
-      const headers = await this.getHeaders();
-      this.log?.info?.(`[DingTalk][Docs] 创建文档: spaceId=${spaceId}, title=${title}`);
-
-      const body: any = {
-        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: 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: any) {
-      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: string,
-    spaceId?: string,
-  ): Promise<DocInfo[]> {
-    try {
-      const headers = await this.getHeaders();
-      this.log?.info?.(`[DingTalk][Docs] 搜索文档: keyword=${keyword}, spaceId=${spaceId || '全部'}`);
-
-      const body: any = { 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: DocInfo[] = items.map((item: any) => ({
-        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: any) {
-      this.log?.error?.(`[DingTalk][Docs] 搜索文档失败: ${err.message}`);
-      return [];
-    }
-  }
-
-  /**
-   * 列出空间下的文档
-   */
-  async listDocs(
-    spaceId: string,
-    parentId?: string,
-  ): Promise<DocInfo[]> {
-    try {
-      const headers = await this.getHeaders();
-      this.log?.info?.(`[DingTalk][Docs] 列出文档: spaceId=${spaceId}, parentId=${parentId || '根目录'}`);
-
-      const params: any = { 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: DocInfo[] = items.map((item: any) => ({
-        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: any) {
-      this.log?.error?.(`[DingTalk][Docs] 列出文档失败: ${err.message}`);
-      return [];
-    }
-  }
-}