@downcity/plugins 1.0.4

package/bin/chat/channels/feishu/FeishuPlatformLookup.js

@@ -0,0 +1,299 @@
+/**
+ * Feishu 平台查询与入站附件辅助函数。
+ *
+ * 关键点（中文）
+ * - 发送者姓名、群标题、reply 上下文、附件下载都属于“读取型平台能力”。
+ * - `FeishuPlatformClient` 只保留运行时状态与 token 管理，这里负责具体 OpenAPI 查询细节。
+ */
+import fs from "fs-extra";
+import path from "path";
+import { buildFeishuInboundCacheFileName } from "./InboundAttachment.js";
+import { buildFeishuReplyContext } from "./ReplyContext.js";
+function warnLookupOnce(deps, warningKey, message, details) {
+    const normalizedKey = String(warningKey || "").trim();
+    if (normalizedKey) {
+        if (deps.lookupWarnings.has(normalizedKey))
+            return;
+        deps.lookupWarnings.add(normalizedKey);
+    }
+    deps.logger.warn(message, details);
+}
+async function resolveSenderNameFromChatMembers(deps, params) {
+    const chatId = String(params.chatId || "").trim();
+    if (!chatId)
+        return undefined;
+    const token = await deps.getAppAccessToken();
+    if (!token)
+        return undefined;
+    const domain = deps.getNormalizedDomain();
+    try {
+        const response = await fetch(`${domain}/open-apis/im/v1/chats/${encodeURIComponent(chatId)}/members?member_id_type=${encodeURIComponent(params.idType)}&page_size=100`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+        });
+        const payload = (await response.json().catch(() => null));
+        if (!response.ok) {
+            warnLookupOnce(deps, `feishu-member-http:${chatId}:${params.idType}:${response.status}:${String(payload?.code ?? "")}`, "Feishu 群成员查询失败", {
+                chatId,
+                senderId: params.senderId,
+                idType: params.idType,
+                httpStatus: response.status,
+                code: payload?.code ?? null,
+                msg: payload?.msg ?? null,
+            });
+            return undefined;
+        }
+        if (payload?.code !== 0) {
+            warnLookupOnce(deps, `feishu-member-code:${chatId}:${params.idType}:${String(payload?.code ?? "")}`, "Feishu 群成员查询返回错误", {
+                chatId,
+                senderId: params.senderId,
+                idType: params.idType,
+                httpStatus: response.status,
+                code: payload?.code ?? null,
+                msg: payload?.msg ?? null,
+            });
+            return undefined;
+        }
+        const items = Array.isArray(payload?.data?.items) ? payload.data.items : [];
+        const matched = items.find((item) => String(item?.member_id || "").trim() === params.senderId);
+        const name = String(matched?.name || "").trim();
+        return name || undefined;
+    }
+    catch (error) {
+        warnLookupOnce(deps, `feishu-member-exception:${chatId}:${params.idType}:${error instanceof Error ? error.name : "unknown"}`, "Feishu 群成员查询异常", {
+            chatId,
+            senderId: params.senderId,
+            idType: params.idType,
+            error: String(error),
+        });
+        return undefined;
+    }
+}
+/**
+ * 解析发送者姓名。
+ */
+export async function resolveFeishuSenderName(deps, params) {
+    const senderId = String(params.senderId || "").trim();
+    const idType = params.idType;
+    if (!senderId || !idType)
+        return undefined;
+    const cacheKey = `${idType}:${senderId}`;
+    const cached = deps.senderNameBySenderKey.get(cacheKey);
+    if (cached)
+        return cached;
+    const token = await deps.getAppAccessToken();
+    if (!token)
+        return undefined;
+    const domain = deps.getNormalizedDomain();
+    try {
+        const response = await fetch(`${domain}/open-apis/contact/v3/users/${encodeURIComponent(senderId)}?user_id_type=${encodeURIComponent(idType)}`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+        });
+        const payload = (await response.json().catch(() => null));
+        if (!response.ok) {
+            warnLookupOnce(deps, `feishu-user-http:${idType}:${senderId}:${response.status}:${String(payload?.code ?? "")}`, "Feishu 用户信息查询失败", {
+                senderId,
+                idType,
+                httpStatus: response.status,
+                code: payload?.code ?? null,
+                msg: payload?.msg ?? null,
+            });
+        }
+        else if (payload?.code !== 0) {
+            warnLookupOnce(deps, `feishu-user-code:${idType}:${senderId}:${String(payload?.code ?? "")}`, "Feishu 用户信息查询返回错误", {
+                senderId,
+                idType,
+                httpStatus: response.status,
+                code: payload?.code ?? null,
+                msg: payload?.msg ?? null,
+            });
+        }
+        else {
+            const user = payload?.data?.user;
+            const name = [user?.nickname, user?.name, user?.en_name]
+                .map((value) => String(value || "").trim())
+                .find(Boolean);
+            if (name) {
+                deps.senderNameBySenderKey.set(cacheKey, name);
+                return name;
+            }
+            warnLookupOnce(deps, `feishu-user-empty:${idType}:${senderId}`, "Feishu 用户信息未返回姓名字段", {
+                senderId,
+                idType,
+                returnedFields: user ? Object.keys(user) : [],
+            });
+        }
+    }
+    catch (error) {
+        warnLookupOnce(deps, `feishu-user-exception:${idType}:${senderId}:${error instanceof Error ? error.name : "unknown"}`, "Feishu 用户信息查询异常", {
+            senderId,
+            idType,
+            error: String(error),
+        });
+    }
+    const memberName = await resolveSenderNameFromChatMembers(deps, {
+        chatId: params.chatId,
+        senderId,
+        idType,
+    });
+    if (memberName) {
+        deps.senderNameBySenderKey.set(cacheKey, memberName);
+        return memberName;
+    }
+    return undefined;
+}
+/**
+ * 解析群聊/会话标题。
+ */
+export async function resolveFeishuChatTitle(deps, chatId) {
+    const normalizedChatId = String(chatId || "").trim();
+    if (!normalizedChatId)
+        return undefined;
+    const cached = deps.chatTitleByChatId.get(normalizedChatId);
+    if (cached)
+        return cached;
+    const token = await deps.getAppAccessToken();
+    if (!token)
+        return undefined;
+    const domain = deps.getNormalizedDomain();
+    try {
+        const response = await fetch(`${domain}/open-apis/im/v1/chats/${encodeURIComponent(normalizedChatId)}`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            deps.logger.debug("Feishu 群信息查询失败", {
+                chatId: normalizedChatId,
+                httpStatus: response.status,
+            });
+            return undefined;
+        }
+        const payload = (await response.json().catch(() => null));
+        if (typeof payload?.code === "number" && payload.code !== 0) {
+            deps.logger.debug("Feishu 群信息查询返回错误", {
+                chatId: normalizedChatId,
+                code: payload.code,
+                msg: payload.msg ?? null,
+            });
+            return undefined;
+        }
+        const title = [
+            payload?.data?.name,
+            payload?.data?.chat_name,
+            payload?.data?.chat?.name,
+            payload?.data?.chat?.chat_name,
+        ]
+            .map((value) => String(value || "").trim())
+            .find(Boolean);
+        if (!title)
+            return undefined;
+        deps.chatTitleByChatId.set(normalizedChatId, title);
+        return title;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 查询 reply 的父消息上下文。
+ */
+export async function resolveFeishuReplyContext(deps, params) {
+    const parentMessageId = String(params.parentMessageId || "").trim();
+    if (!parentMessageId)
+        return undefined;
+    const token = await deps.getAppAccessToken();
+    if (!token)
+        return undefined;
+    const domain = deps.getNormalizedDomain();
+    try {
+        const response = await fetch(`${domain}/open-apis/im/v1/messages/${encodeURIComponent(parentMessageId)}`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+        });
+        const payload = (await response.json().catch(() => null));
+        if (!response.ok || payload?.code !== 0) {
+            deps.logger.debug("Feishu reply 父消息查询失败", {
+                parentMessageId,
+                httpStatus: response.status,
+                code: payload?.code ?? null,
+                msg: payload?.msg ?? null,
+            });
+            return undefined;
+        }
+        const item = Array.isArray(payload?.data?.items) ? payload.data.items[0] : undefined;
+        if (!item)
+            return undefined;
+        return buildFeishuReplyContext({
+            messageId: typeof item.message_id === "string" ? item.message_id : parentMessageId,
+            messageType: item.msg_type,
+            ...(typeof item.body?.content === "string"
+                ? { content: item.body.content }
+                : {}),
+        });
+    }
+    catch (error) {
+        deps.logger.debug("Feishu reply 父消息查询异常", {
+            parentMessageId,
+            error: String(error),
+        });
+        return undefined;
+    }
+}
+/**
+ * 下载入站附件。
+ */
+export async function downloadFeishuIncomingAttachments(deps, params) {
+    if (!deps.client || params.attachments.length === 0)
+        return [];
+    const dir = path.join(deps.rootPath, ".downcity", ".cache", "feishu");
+    await fs.ensureDir(dir);
+    const out = [];
+    for (const attachment of params.attachments) {
+        try {
+            const resource = await deps.client.im.v1.messageResource.get({
+                path: {
+                    message_id: params.messageId,
+                    file_key: attachment.resourceKey,
+                },
+                params: {
+                    type: attachment.resourceType,
+                },
+            });
+            const fileName = buildFeishuInboundCacheFileName({
+                attachment,
+                messageId: params.messageId,
+                headers: resource.headers,
+            });
+            const outPath = path.join(dir, fileName);
+            await resource.writeFile(outPath);
+            out.push({
+                type: attachment.type,
+                path: outPath,
+                ...(attachment.description ? { desc: attachment.description } : {}),
+            });
+        }
+        catch (error) {
+            deps.logger.warn("Failed to download incoming Feishu attachment", {
+                messageId: params.messageId,
+                resourceKey: attachment.resourceKey,
+                resourceType: attachment.resourceType,
+                error: String(error),
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=FeishuPlatformLookup.js.map

package/bin/chat/channels/feishu/FeishuPlatformLookup.js.map

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

package/bin/chat/channels/feishu/FeishuPlatformMessaging.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Feishu 平台发送与附件上传辅助函数。
+ *
+ * 关键点（中文）
+ * - 发送消息、上传图片/文件、解析本地附件路径属于“写入型平台能力”。
+ * - `FeishuPlatformClient` 只保留统一入口和状态，不再直接承载全部细节。
+ */
+import * as Lark from "@larksuiteoapi/node-sdk";
+import type { FeishuMessagePayloadType } from "../../../chat/channels/feishu/types/FeishuChannel.js";
+import type { ParsedFeishuAttachmentCommand } from "../../../chat/types/FeishuAttachment.js";
+/**
+ * Feishu 发送类依赖。
+ */
+export interface FeishuMessagingDeps {
+    /**
+     * 项目根目录。
+     */
+    rootPath: string;
+    /**
+     * 日志器。
+     */
+    logger: {
+        /**
+         * 记录 error 日志。
+         */
+        error(message: string, data?: Record<string, unknown>): void;
+    };
+    /**
+     * Feishu SDK client。
+     */
+    client: Lark.Client | null;
+    /**
+     * 获取 tenant_access_token 的回调。
+     */
+    getAppAccessToken: () => Promise<string | undefined>;
+    /**
+     * 归一化 domain 的回调。
+     */
+    getNormalizedDomain: () => string;
+}
+/**
+ * 发送平台消息。
+ */
+export declare function sendFeishuPlatformMessage(deps: FeishuMessagingDeps, chatId: string, chatType: string, messageId: string | undefined, msgType: FeishuMessagePayloadType, content: Record<string, unknown> | string): Promise<void>;
+/**
+ * 发送附件，并在需要时补发 caption 文本。
+ */
+export declare function sendFeishuAttachment(deps: FeishuMessagingDeps, chatId: string, chatType: string, messageId: string | undefined, attachment: ParsedFeishuAttachmentCommand): Promise<void>;
+//# sourceMappingURL=FeishuPlatformMessaging.d.ts.map

package/bin/chat/channels/feishu/FeishuPlatformMessaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuPlatformMessaging.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/feishu/FeishuPlatformMessaging.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,IAAI,MAAM,yBAAyB,CAAC;AAGhD,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE;QACN;;WAEG;QACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC9D,CAAC;IACF;;OAEG;IACH,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IAC3B;;OAEG;IACH,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrD;;OAEG;IACH,mBAAmB,EAAE,MAAM,MAAM,CAAC;CACnC;AA4FD;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GACxC,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,6BAA6B,GACxC,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/bin/chat/channels/feishu/FeishuPlatformMessaging.js

@@ -0,0 +1,139 @@
+/**
+ * Feishu 平台发送与附件上传辅助函数。
+ *
+ * 关键点（中文）
+ * - 发送消息、上传图片/文件、解析本地附件路径属于“写入型平台能力”。
+ * - `FeishuPlatformClient` 只保留统一入口和状态，不再直接承载全部细节。
+ */
+import fs from "fs-extra";
+import path from "path";
+async function resolveAttachmentLocalPath(deps, pathOrUrl) {
+    const raw = String(pathOrUrl || "").trim();
+    if (!raw) {
+        throw new Error("Attachment path is empty");
+    }
+    if (/^https?:\/\//i.test(raw)) {
+        throw new Error("Feishu attachment currently only supports local file path");
+    }
+    const absPath = path.isAbsolute(raw) ? raw : path.resolve(deps.rootPath, raw);
+    const exists = await fs.pathExists(absPath);
+    if (!exists) {
+        throw new Error(`Attachment file not found: ${raw}`);
+    }
+    const stat = await fs.stat(absPath);
+    if (!stat.isFile()) {
+        throw new Error(`Attachment path is not a file: ${raw}`);
+    }
+    return absPath;
+}
+async function uploadFileToFeishu(deps, localPath) {
+    const token = await deps.getAppAccessToken();
+    if (!token) {
+        throw new Error("Failed to get Feishu tenant_access_token");
+    }
+    const domain = deps.getNormalizedDomain();
+    const fileName = path.basename(localPath) || "attachment.bin";
+    const fileBuffer = await fs.readFile(localPath);
+    const form = new FormData();
+    form.set("file_type", "stream");
+    form.set("file_name", fileName);
+    form.set("file", new Blob([fileBuffer]), fileName);
+    const response = await fetch(`${domain}/open-apis/im/v1/files`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${token}`,
+        },
+        body: form,
+    });
+    const payload = (await response.json().catch(() => null));
+    const fileKey = String(payload?.data?.file_key || "").trim();
+    if (!response.ok || payload?.code !== 0 || !fileKey) {
+        throw new Error(`Feishu file upload failed: HTTP ${response.status}, code=${String(payload?.code ?? "")}, msg=${String(payload?.msg ?? "")}`);
+    }
+    return fileKey;
+}
+async function uploadImageToFeishu(deps, localPath) {
+    if (!deps.client) {
+        throw new Error("Feishu client is not initialized");
+    }
+    const fileBuffer = await fs.readFile(localPath);
+    const payload = await deps.client.im.v1.image.create({
+        data: {
+            image_type: "message",
+            image: fileBuffer,
+        },
+    });
+    const imageKey = String(payload?.image_key || "").trim();
+    if (!imageKey) {
+        throw new Error(`Feishu image upload failed: ${localPath}`);
+    }
+    return imageKey;
+}
+/**
+ * 发送平台消息。
+ */
+export async function sendFeishuPlatformMessage(deps, chatId, chatType, messageId, msgType, content) {
+    if (!deps.client) {
+        throw new Error("Feishu client is not initialized");
+    }
+    const serializedContent = typeof content === "string" ? content : JSON.stringify(content);
+    try {
+        if (chatType !== "p2p" && messageId) {
+            await deps.client.im.v1.message.reply({
+                path: {
+                    message_id: messageId,
+                },
+                data: {
+                    content: serializedContent,
+                    msg_type: msgType,
+                },
+            });
+            return;
+        }
+        await deps.client.im.v1.message.create({
+            params: {
+                receive_id_type: "chat_id",
+            },
+            data: {
+                receive_id: chatId,
+                content: serializedContent,
+                msg_type: msgType,
+            },
+        });
+    }
+    catch (error) {
+        deps.logger.error("Failed to send Feishu message", {
+            error: String(error),
+            msgType,
+            chatType,
+        });
+        throw error instanceof Error
+            ? error
+            : new Error(`Failed to send Feishu message: ${String(error)}`);
+    }
+}
+/**
+ * 发送附件，并在需要时补发 caption 文本。
+ */
+export async function sendFeishuAttachment(deps, chatId, chatType, messageId, attachment) {
+    const localPath = await resolveAttachmentLocalPath(deps, attachment.pathOrUrl);
+    if (attachment.type === "photo") {
+        const imageKey = await uploadImageToFeishu(deps, localPath);
+        await sendFeishuPlatformMessage(deps, chatId, chatType, messageId, "image", {
+            image_key: imageKey,
+        });
+    }
+    else {
+        const fileKey = await uploadFileToFeishu(deps, localPath);
+        await sendFeishuPlatformMessage(deps, chatId, chatType, messageId, "file", {
+            file_key: fileKey,
+        });
+    }
+    const caption = String(attachment.caption || "").trim();
+    if (caption) {
+        await sendFeishuPlatformMessage(deps, chatId, chatType, messageId, "text", {
+            text: caption,
+        });
+    }
+}
+//# sourceMappingURL=FeishuPlatformMessaging.js.map

package/bin/chat/channels/feishu/FeishuPlatformMessaging.js.map

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

package/bin/chat/channels/feishu/InboundAttachment.d.ts

@@ -0,0 +1,31 @@
+import type { FeishuIncomingAttachmentDescriptor } from "../../../chat/types/FeishuInboundAttachment.js";
+/**
+ * 解析飞书入站消息。
+ *
+ * 说明（中文）
+ * - 文本消息返回正文。
+ * - `post` 消息会降级成“纯文本 + 附件占位”。
+ * - 附件消息返回归一化附件描述；正文通常为空。
+ * - 不支持的 `message_type` 会返回 `unsupportedType`，由上层决定是否提示用户。
+ */
+export declare function parseFeishuInboundMessage(params: {
+    messageType: string;
+    content: string;
+}): {
+    text: string;
+    attachments: FeishuIncomingAttachmentDescriptor[];
+    unsupportedType?: string;
+};
+/**
+ * 生成飞书入站附件的本地缓存文件名。
+ *
+ * 关键点（中文）
+ * - 优先使用服务端返回的 `Content-Disposition` 文件名。
+ * - 若无文件名，则回退到附件原始文件名，再根据 MIME 或类型补扩展名。
+ */
+export declare function buildFeishuInboundCacheFileName(params: {
+    attachment: FeishuIncomingAttachmentDescriptor;
+    messageId: string;
+    headers?: Record<string, unknown>;
+}): string;
+//# sourceMappingURL=InboundAttachment.d.ts.map

package/bin/chat/channels/feishu/InboundAttachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InboundAttachment.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/feishu/InboundAttachment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,kCAAkC,EACnC,MAAM,yCAAyC,CAAC;AAsLjD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG;IACF,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,kCAAkC,EAAE,CAAC;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CA2BA;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,UAAU,EAAE,kCAAkC,CAAC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,MAAM,CAiBT"}