@zhin.js/adapter-dingtalk 1.0.81 → 1.1.2

package/src/webhook.ts

@@ -0,0 +1,75 @@
+/**
+ * DingTalk webhook HTTP: signature → parse → admit.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
+import { formatCompact, getLogger } from '@zhin.js/logger';
+import {
+  headerValue,
+  readTextBody,
+  verifySignature,
+  type DingTalkEvent,
+  type ResolvedDingTalkConfig,
+} from './protocol.js';
+
+const logger = getLogger('dingtalk');
+
+export interface DingTalkWebhookHandler {
+  readonly config: ResolvedDingTalkConfig;
+  readonly isOpen: boolean;
+  admit(event: DingTalkEvent): void;
+}
+
+export function registerDingTalkWebhookRoutes(
+  http: HttpHost,
+  handler: DingTalkWebhookHandler,
+): HttpRouteRegistration[] {
+  const path = handler.config.webhookPath;
+  return [
+    http.route('POST', path, async (request, response) => {
+      await handleDingTalkWebhookRequest(request, response, handler);
+    }, { summary: 'DingTalk robot webhook', tags: ['dingtalk'] }),
+  ];
+}
+
+export async function handleDingTalkWebhookRequest(
+  request: IncomingMessage,
+  response: ServerResponse,
+  handler: DingTalkWebhookHandler,
+): Promise<void> {
+  try {
+    // DingTalk outgoing callbacks put timestamp/sign on the URL query;
+    // headers are accepted as a fallback for legacy senders.
+    const query = new URL(request.url ?? '/', 'http://localhost').searchParams;
+    const timestamp = query.get('timestamp') || headerValue(request.headers, 'timestamp');
+    const sign = query.get('sign') || headerValue(request.headers, 'sign');
+    // Missing credentials must never be admitted: verify unconditionally.
+    if (!timestamp || !sign || !verifySignature(handler.config.appSecret, timestamp, sign)) {
+      logger.warn(formatCompact({ op: 'webhook', ok: false, error: 'invalid signature' }));
+      response.writeHead(403, { 'Content-Type': 'application/json' });
+      response.end(JSON.stringify({ code: -1, msg: 'Forbidden' }));
+      return;
+    }
+
+    const rawBody = await readTextBody(request);
+    let event: DingTalkEvent;
+    try {
+      event = JSON.parse(rawBody) as DingTalkEvent;
+    } catch {
+      response.writeHead(200, { 'Content-Type': 'application/json' });
+      response.end(JSON.stringify({ code: 0, msg: 'success' }));
+      return;
+    }
+
+    if (event.msgtype && handler.isOpen) {
+      handler.admit(event);
+    }
+
+    response.writeHead(200, { 'Content-Type': 'application/json' });
+    response.end(JSON.stringify({ code: 0, msg: 'success' }));
+  } catch (error) {
+    logger.error('Webhook error:', error);
+    response.writeHead(500, { 'Content-Type': 'application/json' });
+    response.end(JSON.stringify({ code: -1, msg: 'Internal Server Error' }));
+  }
+}

package/lib/adapter.d.ts

@@ -1,16 +0,0 @@
-/**
- * 钉钉适配器
- */
-import { Adapter, Plugin } from "zhin.js";
-import { DingTalkBot } from "./bot.js";
-import type { DingTalkBotConfig } from "./types.js";
-export declare class DingTalkAdapter extends Adapter<DingTalkBot> {
-    #private;
-    constructor(plugin: Plugin, router: any);
-    createBot(config: DingTalkBotConfig): DingTalkBot;
-    kickMember(botId: string, sceneId: string, userId: string): Promise<boolean>;
-    setGroupName(botId: string, sceneId: string, name: string): Promise<boolean>;
-    getGroupInfo(botId: string, sceneId: string): Promise<any>;
-    start(): Promise<void>;
-}
-//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,OAAO,EACP,MAAM,EACP,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,qBAAa,eAAgB,SAAQ,OAAO,CAAC,WAAW,CAAC;;gBAG3C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG;IAKvC,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW;IAI3C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAMzD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAMzD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAM3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/lib/adapter.js

@@ -1,37 +0,0 @@
-/**
- * 钉钉适配器
- */
-import { Adapter, } from "zhin.js";
-import { DingTalkBot } from "./bot.js";
-export class DingTalkAdapter extends Adapter {
-    #router;
-    constructor(plugin, router) {
-        super(plugin, "dingtalk", []);
-        this.#router = router;
-    }
-    createBot(config) {
-        return new DingTalkBot(this, this.#router, config);
-    }
-    async kickMember(botId, sceneId, userId) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.updateChat(sceneId, { del_useridlist: [userId] });
-    }
-    async setGroupName(botId, sceneId, name) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.updateChat(sceneId, { name });
-    }
-    async getGroupInfo(botId, sceneId) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.getChatInfo(sceneId);
-    }
-    async start() {
-        await super.start();
-    }
-}
-//# sourceMappingURL=adapter.js.map

package/lib/adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,OAAO,GAER,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC,MAAM,OAAO,eAAgB,SAAQ,OAAoB;IACvD,OAAO,CAAM;IAEb,YAAY,MAAc,EAAE,MAAW;QACrC,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,SAAS,CAAC,MAAyB;QACjC,OAAO,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,OAAe,EAAE,MAAc;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,OAAe,EAAE,IAAY;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,OAAe;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF"}

package/lib/bot.d.ts

@@ -1,46 +0,0 @@
-/**
- * 钉钉 Bot 实现
- */
-import { Bot, Message, SendOptions } from 'zhin.js';
-import type { DingTalkBotConfig, DingTalkMessage } from "./types.js";
-import type { DingTalkAdapter } from "./adapter.js";
-export declare class DingTalkBot implements Bot<DingTalkBotConfig, DingTalkMessage> {
-    adapter: DingTalkAdapter;
-    $config: DingTalkBotConfig;
-    $connected: boolean;
-    private router;
-    private accessToken;
-    private baseURL;
-    private sessionWebhooks;
-    get $id(): string;
-    get logger(): import("zhin.js").Logger;
-    constructor(adapter: DingTalkAdapter, router: any, $config: DingTalkBotConfig);
-    private request;
-    private setupWebhookRoute;
-    private handleWebhook;
-    private verifySignature;
-    private handleEvent;
-    private ensureAccessToken;
-    private refreshAccessToken;
-    $formatMessage(msg: DingTalkMessage): Message<DingTalkMessage>;
-    private parseMessageContent;
-    $sendMessage(options: SendOptions): Promise<string>;
-    $recallMessage(id: string): Promise<void>;
-    private formatSendContent;
-    $connect(): Promise<void>;
-    $disconnect(): Promise<void>;
-    getUserInfo(userId: string): Promise<any>;
-    getDepartmentUsers(deptId: number): Promise<any[]>;
-    sendWorkNotice(userIdList: string[], content: any): Promise<boolean>;
-    getDepartmentList(deptId?: number): Promise<any[]>;
-    getDepartmentInfo(deptId: number): Promise<any>;
-    createChat(name: string, ownerUserId: string, userIdList: string[]): Promise<string | null>;
-    getChatInfo(chatId: string): Promise<any>;
-    updateChat(chatId: string, options: {
-        name?: string;
-        owner?: string;
-        add_useridlist?: string[];
-        del_useridlist?: string[];
-    }): Promise<boolean>;
-}
-//# sourceMappingURL=bot.d.ts.map

package/lib/bot.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiB,GAAG,EAAE,OAAO,EAAwC,WAAW,EAAE,MAAM,SAAS,CAAC;AAGzG,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EAGhB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,qBAAa,WAAY,YAAW,GAAG,CAAC,iBAAiB,EAAE,eAAe,CAAC;IAgBhE,OAAO,EAAE,eAAe;IAExB,OAAO,EAAE,iBAAiB;IAjBnC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAkC;IAEzD,IAAI,GAAG,WAEN;IAED,IAAI,MAAM,6BAET;gBAGQ,OAAO,EAAE,eAAe,EAC/B,MAAM,EAAE,GAAG,EACJ,OAAO,EAAE,iBAAiB;YASrB,OAAO;IA4BrB,OAAO,CAAC,iBAAiB;YAMX,aAAa;IA0B3B,OAAO,CAAC,eAAe;YAaT,WAAW;YAeX,iBAAiB;YAajB,kBAAkB;IA2BhC,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAiC9D,OAAO,CAAC,mBAAmB;IAoGrB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAwCnD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,OAAO,CAAC,iBAAiB;IA8EnB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAYzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAczC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAclD,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBpE,iBAAiB,CAAC,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAcrD,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAc/C,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqBnB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAczC,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,GACA,OAAO,CAAC,OAAO,CAAC;CAgBpB"}