twinny 0.0.0-dev.260525150705

package/dist/lark/files.js

@@ -0,0 +1,191 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+export class LarkFileDownloader {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async downloadMessageResource(params) {
+        const response = await this.options.openApiClient.download(`/im/v1/messages/${encodePathSegment(params.messageId)}/resources/${encodePathSegment(params.fileKey)}`, {
+            method: "GET",
+            query: {
+                type: params.resourceType
+            }
+        });
+        await fs.mkdir(params.outputDir, { recursive: true });
+        const fileName = buildFileName(params, response.contentType, response.contentDisposition);
+        const { fileName: uniqueFileName, filePath } = await uniqueFileDestination(params.outputDir, fileName);
+        await fs.writeFile(filePath, response.body);
+        return {
+            resourceType: params.resourceType,
+            fileKey: params.fileKey,
+            fileName: uniqueFileName,
+            path: filePath,
+            size: response.body.byteLength,
+            contentType: response.contentType
+        };
+    }
+    async uploadImage(params) {
+        const fileName = sanitizeFileName(params.fileName ?? path.basename(params.filePath));
+        const body = await fs.readFile(params.filePath);
+        const raw = await this.options.openApiClient.uploadMultipart("/im/v1/images", { image_type: "message" }, [
+            {
+                fieldName: "image",
+                fileName,
+                body,
+                contentType: params.contentType ?? contentTypeForFileName(fileName)
+            }
+        ]);
+        const imageKey = extractNestedString(raw, "data", "image_key");
+        if (!imageKey) {
+            throw new Error("Lark image upload response did not include image_key");
+        }
+        return { imageKey, raw };
+    }
+    async uploadFile(params) {
+        const fileName = sanitizeFileName(params.fileName ?? path.basename(params.filePath));
+        const body = await fs.readFile(params.filePath);
+        const raw = await this.options.openApiClient.uploadMultipart("/im/v1/files", {
+            file_type: params.fileType ?? larkFileTypeForFileName(fileName),
+            file_name: fileName,
+            duration: params.durationMs
+        }, [
+            {
+                fieldName: "file",
+                fileName,
+                body,
+                contentType: params.contentType ?? contentTypeForFileName(fileName)
+            }
+        ]);
+        const fileKey = extractNestedString(raw, "data", "file_key");
+        if (!fileKey) {
+            throw new Error("Lark file upload response did not include file_key");
+        }
+        return { fileKey, raw };
+    }
+}
+function buildFileName(params, contentType, contentDisposition) {
+    const dispositionFileName = filenameFromContentDisposition(contentDisposition);
+    const baseName = sanitizeFileName(params.fileName ?? dispositionFileName ?? params.fileKey);
+    if (path.extname(baseName)) {
+        return baseName;
+    }
+    return `${baseName}${extensionForContentType(contentType)}`;
+}
+function filenameFromContentDisposition(contentDisposition) {
+    if (!contentDisposition) {
+        return undefined;
+    }
+    const utf8Match = /filename\*=UTF-8''([^;]+)/i.exec(contentDisposition);
+    if (utf8Match?.[1]) {
+        try {
+            return decodeURIComponent(utf8Match[1]);
+        }
+        catch {
+            return utf8Match[1];
+        }
+    }
+    const asciiMatch = /filename="?([^";]+)"?/i.exec(contentDisposition);
+    return asciiMatch?.[1];
+}
+async function uniqueFileDestination(outputDir, fileName) {
+    const extension = path.extname(fileName);
+    const stem = extension ? fileName.slice(0, -extension.length) : fileName;
+    for (let suffix = 1;; suffix += 1) {
+        const candidate = suffix === 1 ? fileName : `${stem}(${suffix})${extension}`;
+        const filePath = path.join(outputDir, candidate);
+        if (!(await pathExists(filePath))) {
+            return { fileName: candidate, filePath };
+        }
+    }
+}
+async function pathExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function sanitizeFileName(value) {
+    const name = path.basename(value).replace(/[\u0000-\u001f\u007f]/g, "_").trim();
+    return name && name !== "." && name !== ".." ? name : "lark_file";
+}
+function extensionForContentType(contentType) {
+    const normalized = contentType?.split(";")[0]?.trim().toLowerCase();
+    switch (normalized) {
+        case "image/jpeg":
+            return ".jpg";
+        case "image/png":
+            return ".png";
+        case "image/gif":
+            return ".gif";
+        case "image/webp":
+            return ".webp";
+        case "application/pdf":
+            return ".pdf";
+        case "text/plain":
+            return ".txt";
+        default:
+            return "";
+    }
+}
+function contentTypeForFileName(fileName) {
+    switch (path.extname(fileName).toLowerCase()) {
+        case ".jpg":
+        case ".jpeg":
+            return "image/jpeg";
+        case ".png":
+            return "image/png";
+        case ".gif":
+            return "image/gif";
+        case ".webp":
+            return "image/webp";
+        case ".bmp":
+            return "image/bmp";
+        case ".mp4":
+            return "video/mp4";
+        case ".pdf":
+            return "application/pdf";
+        case ".txt":
+            return "text/plain";
+        default:
+            return undefined;
+    }
+}
+function larkFileTypeForFileName(fileName) {
+    switch (path.extname(fileName).toLowerCase()) {
+        case ".opus":
+            return "opus";
+        case ".mp4":
+            return "mp4";
+        case ".pdf":
+            return "pdf";
+        case ".doc":
+        case ".docx":
+            return "doc";
+        case ".xls":
+        case ".xlsx":
+            return "xls";
+        case ".ppt":
+        case ".pptx":
+            return "ppt";
+        default:
+            return "stream";
+    }
+}
+function extractNestedString(value, ...pathSegments) {
+    let current = value;
+    for (const segment of pathSegments) {
+        if (!current || typeof current !== "object" || Array.isArray(current)) {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return typeof current === "string" && current.trim() !== "" ? current : undefined;
+}
+function encodePathSegment(value) {
+    return encodeURIComponent(value);
+}
+//# sourceMappingURL=files.js.map

package/dist/lark/files.js.map

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

package/dist/lark/filters.d.ts

@@ -0,0 +1,73 @@
+import type { IncomingLarkBotMenuAction, IncomingLarkMessage, IncomingLarkMessageRecall, IncomingLarkMessageResource } from "../types.js";
+export interface RawLarkMessageReceiveEvent {
+    event_id?: string;
+    uuid?: string;
+    create_time?: string;
+    sender?: {
+        sender_id?: {
+            open_id?: string;
+            user_id?: string;
+            union_id?: string;
+        };
+        name?: string;
+        sender_name?: string;
+        display_name?: string;
+        sender_display_name?: string;
+        sender_type?: string;
+        tenant_key?: string;
+    };
+    message?: {
+        message_id?: string;
+        root_id?: string;
+        parent_id?: string;
+        thread_id?: string;
+        create_time?: string;
+        chat_id?: string;
+        chat_type?: string;
+        message_type?: string;
+        mentions?: unknown;
+        content?: unknown;
+    };
+}
+export type LarkMessageIgnoreReason = "malformed_event" | "missing_sender_open_id" | "bot_self_message" | "unsupported_chat_type" | "missing_message_id";
+export type LarkMessageChangeIgnoreReason = "malformed_event" | "missing_message_id";
+export type LarkBotMenuIgnoreReason = "malformed_event" | "missing_event_key" | "unsupported_event_key" | "missing_operator_open_id";
+export interface NormalizeLarkMessageOptions {
+    botOpenId?: string;
+}
+export type NormalizeLarkMessageResult = {
+    kind: "message";
+    message: IncomingLarkMessage;
+} | {
+    kind: "ignored";
+    reason: LarkMessageIgnoreReason;
+    raw: unknown;
+};
+export type NormalizeLarkMessageRecallResult = {
+    kind: "recall";
+    recall: IncomingLarkMessageRecall;
+} | {
+    kind: "ignored";
+    reason: LarkMessageChangeIgnoreReason;
+    raw: unknown;
+};
+export type NormalizeLarkBotMenuResult = {
+    kind: "bot_menu";
+    action: IncomingLarkBotMenuAction;
+} | {
+    kind: "ignored";
+    reason: LarkBotMenuIgnoreReason;
+    raw: unknown;
+};
+export declare function normalizeIncomingLarkMessage(raw: unknown, options?: NormalizeLarkMessageOptions): IncomingLarkMessage | null;
+export declare function normalizeIncomingLarkMessageWithReason(raw: unknown, options?: NormalizeLarkMessageOptions): NormalizeLarkMessageResult;
+export declare function normalizeLarkBotMenuWithReason(raw: unknown): NormalizeLarkBotMenuResult;
+export declare function normalizeLarkMessageRecallWithReason(raw: unknown): NormalizeLarkMessageRecallResult;
+export interface NormalizedLarkMessageContent {
+    text: string | null;
+    resources: IncomingLarkMessageResource[];
+    rawForCodex: boolean;
+}
+export declare function normalizeLarkMessageContent(messageType: string, content: unknown): NormalizedLarkMessageContent;
+export declare function stringifyRawLarkMessageForCodex(message: Record<string, unknown>): string;
+export declare function normalizeTextContent(content: unknown): string | null;