@xgjktech/xg_cwork_im 1.11.1 → 1.11.4

package/{src/resource-file.ts → dist/src/resource-file.js}

@@ -1,339 +1,317 @@
-/**
- * 资源中心整文件上传 + OpenClaw deliver 媒体 URL 拉取
- *
- * 上传地址固定为 `baseUrl + /file/upDownload/uploadWholeFile`，与 IM 同域，使用与发消息相同的 access-token。
- */
-
-import axios from "axios";
-import { File } from "node:buffer";
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import type { Log } from "./auth.js";
-
-const DEFAULT_MAX_BYTES = 50 * 1024 * 1024;
-
-/** 整文件上传接口路径（拼在 channels.xg_cwork_im.baseUrl 上） */
-export const RESOURCE_UPLOAD_PATH = "/file/upDownload/uploadWholeFile";
-
-export function resolveResourceUploadUrl(baseUrl: string): string {
-    const b = baseUrl.trim();
-    if (!b) throw new Error("[cwork_im] baseUrl is required for resource upload");
-    return new URL(RESOURCE_UPLOAD_PATH, b.endsWith("/") ? b : `${b}/`).href;
-}
-
-/** 从上传接口 JSON 中解析 fileId（兼容常见嵌套 data） */
-export function extractFileIdFromUploadResponse(data: unknown): string | undefined {
-    if (data == null) return undefined;
-    if (typeof data === "string" && data.trim().length > 0) return data.trim();
-    if (typeof data !== "object") return undefined;
-    const o = data as Record<string, unknown>;
-    for (const key of ["fileId", "id", "resourceId", "file_id"]) {
-        const v = o[key];
-        if (typeof v === "string" && v.length > 0) return v;
-    }
-    if (o.data != null) {
-        const nested = extractFileIdFromUploadResponse(o.data);
-        if (nested) return nested;
-    }
-    return undefined;
-}
-
-export function formatFromFilename(filename: string): string {
-    const ext = path.extname(filename).replace(/^\./, "").toLowerCase();
-    if (ext && ext.length <= 16 && /^[a-z0-9]+$/i.test(ext)) return ext;
-    return "bin";
-}
-
-/** 仅当含 %XX 序列时 decodeURIComponent，避免对已解码的 Unicode 再 decode 抛错 */
-export function safeDecodeUriFilenameSegment(segment: string): string {
-    const s = segment.trim();
-    if (!s) return s;
-    if (!/%[0-9A-Fa-f]{2}/.test(s)) return s;
-    try {
-        return decodeURIComponent(s.replace(/\+/g, " "));
-    } catch {
-        return s;
-    }
-}
-
-/**
- * 从 HTTP Content-Disposition 解析文件名（优先 RFC 5987 `filename*=` UTF-8，再普通 filename=）。
- */
-export function parseFilenameFromContentDisposition(header: string | undefined): string | undefined {
-    if (header == null || typeof header !== "string") return undefined;
-    const h = header.trim();
-    if (!h) return undefined;
-
-    const star = /filename\*\s*=\s*(?:UTF-8|utf-8)''([^;\r\n]+)/i.exec(h);
-    if (star?.[1]) {
-        const v = star[1].trim();
-        const decoded = safeDecodeUriFilenameSegment(v);
-        if (decoded) return decoded;
-    }
-
-    const quoted = /filename\s*=\s*"((?:[^"\\]|\\.)*)"/i.exec(h);
-    if (quoted?.[1]) {
-        const inner = quoted[1].replace(/\\(.)/g, "$1").trim();
-        if (inner) return safeDecodeUriFilenameSegment(inner);
-    }
-
-    const unquoted = /filename\s*=\s*([^;\r\n]+)/i.exec(h);
-    if (unquoted?.[1]) {
-        let v = unquoted[1].trim().replace(/^["']|["']$/g, "");
-        if (v.toLowerCase().startsWith("utf-8''")) v = v.slice(7);
-        if (v) return safeDecodeUriFilenameSegment(v);
-    }
-
-    return undefined;
-}
-
-export function displayNameFromUrl(url: string): string {
-    try {
-        if (url.startsWith("file://")) {
-            return path.basename(fileURLToPath(url)) || "file";
-        }
-        const u = new URL(url);
-        const qName = u.searchParams.get("filename") ?? u.searchParams.get("name");
-        if (qName?.trim()) {
-            return safeDecodeUriFilenameSegment(qName.trim()) || "attachment";
-        }
-        const pathname = u.pathname || "/";
-        const last = pathname.split("/").filter(Boolean).pop() ?? "";
-        const base = safeDecodeUriFilenameSegment(last.split("?")[0] || "");
-        return base || "attachment";
-    } catch {
-        return "attachment";
-    }
-}
-
-/** 日志用：截断过长路径/URL */
-export function summarizeMediaRef(ref: string, maxLen = 160): string {
-    const t = ref.trim().replace(/\s+/g, " ");
-    if (t.length <= maxLen) return t;
-    return `${t.slice(0, maxLen)}…(len=${t.length})`;
-}
-
-function isHttpOrHttps(ref: string): boolean {
-    try {
-        const u = new URL(ref.trim());
-        return u.protocol === "http:" || u.protocol === "https:";
-    } catch {
-        return false;
-    }
-}
-
-/**
- * 将字符串解析为可交给 readFile 的本机路径（兼容 Windows / macOS / Linux）。
- * - 使用当前进程的 path.isAbsolute（各 OS 语义正确）。
- * - Windows：Git Bash / MSYS 的 `/c/Users/...`、Cygwin `/cygdrive/c/...`。
- * - 非 Windows：若传入 `D:\...` 形式仍做一次规范化（多用于日志/失败提示，读文件通常会失败）。
- */
-export function resolveLocalFsPath(ref: string): { fsPath: string; via: string } | null {
-    const raw = ref.trim();
-    if (!raw) return null;
-
-    if (process.platform === "win32") {
-        // MSYS/Git Bash: /c/Users/foo → C:\Users\foo（要求 /<盘符>/ 后仍有路径，避免误伤 /Users）
-        const msys = /^\/([a-zA-Z])\/(.+)$/.exec(raw.replace(/\\/g, "/"));
-        if (msys) {
-            const letter = msys[1].toUpperCase();
-            const rest = msys[2].split("/").join(path.win32.sep);
-            const fsPath = path.win32.normalize(`${letter}:${path.win32.sep}${rest}`);
-            return { fsPath, via: "git-bash-msys" };
-        }
-        const cyg = /^\/cygdrive\/([a-zA-Z])\/(.+)$/i.exec(raw.replace(/\\/g, "/"));
-        if (cyg) {
-            const letter = cyg[1].toUpperCase();
-            const rest = cyg[2].split("/").join(path.win32.sep);
-            const fsPath = path.win32.normalize(`${letter}:${path.win32.sep}${rest}`);
-            return { fsPath, via: "cygwin" };
-        }
-    }
-
-    if (path.isAbsolute(raw)) {
-        return { fsPath: path.normalize(raw), via: `native-${process.platform}` };
-    }
-
-    // Linux/macOS 上 WSL 互操作常见：/mnt/c/... 已是 posix 绝对路径，上面已命中
-
-    if (process.platform !== "win32" && /^[a-zA-Z]:[/\\]/.test(raw)) {
-        return { fsPath: path.win32.normalize(raw), via: "win-style-path" };
-    }
-
-    return null;
-}
-
-async function readLocalFsIntoBuffer(fsPath: string, maxBytes: number, log?: Log): Promise<{ buffer: Buffer; filename: string }> {
-    const buffer = await readFile(fsPath);
-    if (buffer.length > maxBytes) {
-        throw new Error(`local file size ${buffer.length} exceeds maxAttachmentBytes=${maxBytes}`);
-    }
-    const filename = path.basename(fsPath) || "file";
-    log?.info(`[cwork_im:media] local ok bytes=${buffer.length} name=${filename}`);
-    return { buffer, filename };
-}
-
-/**
- * 将 OpenClaw 约定的 `/workspace/<rel>` 路径解析为本机绝对路径（跨平台）。
- *
- * OpenClaw 在所有平台启动时均会 chdir 到 workspace 目录，因此
- * `process.cwd()` 即为 workspace 根，/workspace/<rel> 等价于 cwd/<rel>：
- *   - Windows : C:\Users\..\.openclaw\workspace\<rel>
- *   - macOS   : ~/.openclaw/workspace/<rel>
- *   - Linux容器: /workspace/<rel>（cwd=/workspace，path.join 结果不变）
- *
- * 返回 null 表示路径不符合 /workspace/ 格式。
- */
-export function resolveWorkspacePrefixPath(raw: string): string | null {
-    if (!raw.startsWith("/workspace/") && raw !== "/workspace") return null;
-    const rel = raw.startsWith("/workspace/") ? raw.slice("/workspace/".length) : "";
-    const cwd = process.cwd();
-    return rel ? path.join(cwd, rel) : cwd;
-}
-
-export async function downloadMediaBuffer(
-    url: string,
-    maxBytes: number,
-    log?: Log,
-): Promise<{ buffer: Buffer; filename: string }> {
-    const raw = url.trim();
-    log?.info(`[cwork_im:media] resolve ref=${summarizeMediaRef(raw)}`);
-
-    // Handle OpenClaw /workspace/ convention: map to actual workspace directory.
-    const workspaceResolved = resolveWorkspacePrefixPath(raw);
-    if (workspaceResolved && workspaceResolved !== raw) {
-        log?.info(`[cwork_im:media] /workspace/ -> ${summarizeMediaRef(workspaceResolved)}`);
-        try {
-            return await readLocalFsIntoBuffer(workspaceResolved, maxBytes, log);
-        } catch (err: unknown) {
-            log?.error(`[cwork_im:media] readFile failed /workspace/ ${summarizeMediaRef(workspaceResolved)}: ${String(err)}`);
-            throw err;
-        }
-    }
-
-    if (raw.startsWith("file://")) {
-        let fsPath: string;
-        try {
-            fsPath = fileURLToPath(raw);
-        } catch (e) {
-            log?.error(`[cwork_im:media] invalid file:// URL: ${summarizeMediaRef(raw)} ${String(e)}`);
-            throw e;
-        }
-        log?.info(`[cwork_im:media] read file:// -> ${summarizeMediaRef(fsPath)}`);
-        try {
-            return await readLocalFsIntoBuffer(fsPath, maxBytes, log);
-        } catch (err: unknown) {
-            log?.error(`[cwork_im:media] readFile failed file:// ${summarizeMediaRef(fsPath)}: ${String(err)}`);
-            throw err;
-        }
-    }
-
-    if (isHttpOrHttps(raw)) {
-        log?.info(`[cwork_im:media] GET ${summarizeMediaRef(raw)}`);
-        try {
-            const res = await axios.get(raw, {
-                responseType: "arraybuffer",
-                timeout: 120_000,
-                maxContentLength: maxBytes,
-                maxBodyLength: maxBytes,
-                validateStatus: (s) => s >= 200 && s < 300,
-            });
-            const buffer = Buffer.from(res.data as ArrayBuffer);
-            let filename = displayNameFromUrl(raw);
-            const cdRaw = res.headers["content-disposition"];
-            const cd = Array.isArray(cdRaw) ? cdRaw[0] : cdRaw;
-            if (typeof cd === "string") {
-                const fromCd = parseFilenameFromContentDisposition(cd);
-                if (fromCd) filename = fromCd;
-            }
-            log?.info(`[cwork_im:media] http ok bytes=${buffer.length} name=${filename}`);
-            return { buffer, filename };
-        } catch (err: unknown) {
-            const detail = axios.isAxiosError(err)
-                ? `${err.message}${err.code ? ` axiosCode=${err.code}` : ""}${err.response?.status != null ? ` httpStatus=${err.response.status}` : ""}`
-                : String(err);
-            log?.error(`[cwork_im:media] http failed ref=${summarizeMediaRef(raw)}: ${detail}`);
-            throw err;
-        }
-    }
-
-    const resolved = resolveLocalFsPath(raw);
-    if (resolved) {
-        log?.info(`[cwork_im:media] local via=${resolved.via} -> ${summarizeMediaRef(resolved.fsPath)}`);
-        try {
-            return await readLocalFsIntoBuffer(resolved.fsPath, maxBytes, log);
-        } catch (err: unknown) {
-            log?.error(`[cwork_im:media] readFile failed ${summarizeMediaRef(resolved.fsPath)}: ${String(err)}`);
-            throw err;
-        }
-    }
-
-    const hint =
-        "请使用 http(s)、file://（三系统通用），或本机绝对路径：Windows C:\\\\... / UNC；macOS/Linux /Users、/home、/mnt/c/...（WSL）；Windows 下 Git Bash 可用 /c/...";
-    log?.error(`[cwork_im:media] unsupported ref=${summarizeMediaRef(raw)} (${hint})`);
-    throw new Error(`[cwork_im] 无法读取媒体（${hint}）: ${summarizeMediaRef(raw)}`);
-}
-
-/**
- * multipart 上传整文件，返回 fileId 与字节数。
- */
-export async function uploadWholeResourceFile(args: {
-    fileUploadUrl: string;
-    token: string;
-    buffer: Buffer;
-    filename: string;
-    formField: string;
-    log?: Log;
-}): Promise<{ fileId: string; size: number }> {
-    const { fileUploadUrl, token, buffer, filename, formField, log } = args;
-    const form = new FormData();
-    // 使用 File 携带 UTF-8 文件名，避免部分环境下 Blob+第三参在 multipart 里被错误编码导致服务端乱码
-    const file = new File([buffer], filename, { type: "application/octet-stream" });
-    form.append(formField, file);
-
-    log?.info(`[cwork_im:upload] POST ${fileUploadUrl} field=${formField} name=${filename} bytes=${buffer.length}`);
-
-    const res = await fetch(fileUploadUrl, {
-        method: "POST",
-        headers: {
-            "access-token": token,
-        },
-        body: form,
-    });
-
-    const rawText = await res.text();
-    let json: unknown;
-    try {
-        json = rawText ? JSON.parse(rawText) : undefined;
-    } catch {
-        json = undefined;
-    }
-
-    if (!res.ok) {
-        log?.error(`[cwork_im:upload] HTTP ${res.status} body=${rawText.slice(0, 500)}`);
-        throw new Error(`upload HTTP ${res.status}: ${rawText.slice(0, 500)}`);
-    }
-
-    // Unified IM API response: { data, resultCode: 1, resultMsg: "" } — resultCode=1 means success.
-    if (json && typeof json === "object") {
-        const j = json as Record<string, unknown>;
-        if (j.resultCode !== undefined && j.resultCode !== 1) {
-            const msg = `upload IM API error resultCode=${j.resultCode}${j.resultMsg ? ` resultMsg=${j.resultMsg}` : ""}`;
-            log?.error(`[cwork_im:upload] ${msg} body=${rawText.slice(0, 500)}`);
-            throw new Error(msg);
-        }
-    }
-
-    const fileId = extractFileIdFromUploadResponse(json ?? rawText);
-    if (!fileId) {
-        log?.error(`[cwork_im:upload] missing fileId in body=${rawText.slice(0, 500)}`);
-        throw new Error(`upload response missing fileId: ${rawText.slice(0, 500)}`);
-    }
-
-    return { fileId, size: buffer.length };
-}
-
-export function resolveMaxAttachmentBytes(config: { maxAttachmentBytes?: number }): number {
-    return config.maxAttachmentBytes ?? DEFAULT_MAX_BYTES;
-}
+/**
+ * 资源中心整文件上传 + OpenClaw deliver 媒体 URL 拉取
+ *
+ * 上传地址固定为 `baseUrl + /file/upDownload/uploadWholeFile`，与 IM 同域，使用与发消息相同的 access-token。
+ */
+import axios from "axios";
+import { File } from "node:buffer";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const DEFAULT_MAX_BYTES = 50 * 1024 * 1024;
+/** 整文件上传接口路径（拼在 channels.xg_cwork_im.baseUrl 上） */
+export const RESOURCE_UPLOAD_PATH = "/file/upDownload/uploadWholeFile";
+export function resolveResourceUploadUrl(baseUrl) {
+    const b = baseUrl.trim();
+    if (!b)
+        throw new Error("[cwork_im] baseUrl is required for resource upload");
+    return new URL(RESOURCE_UPLOAD_PATH, b.endsWith("/") ? b : `${b}/`).href;
+}
+/** 从上传接口 JSON 中解析 fileId（兼容常见嵌套 data） */
+export function extractFileIdFromUploadResponse(data) {
+    if (data == null)
+        return undefined;
+    if (typeof data === "string" && data.trim().length > 0)
+        return data.trim();
+    if (typeof data !== "object")
+        return undefined;
+    const o = data;
+    for (const key of ["fileId", "id", "resourceId", "file_id"]) {
+        const v = o[key];
+        if (typeof v === "string" && v.length > 0)
+            return v;
+    }
+    if (o.data != null) {
+        const nested = extractFileIdFromUploadResponse(o.data);
+        if (nested)
+            return nested;
+    }
+    return undefined;
+}
+export function formatFromFilename(filename) {
+    const ext = path.extname(filename).replace(/^\./, "").toLowerCase();
+    if (ext && ext.length <= 16 && /^[a-z0-9]+$/i.test(ext))
+        return ext;
+    return "bin";
+}
+/** 仅当含 %XX 序列时 decodeURIComponent，避免对已解码的 Unicode 再 decode 抛错 */
+export function safeDecodeUriFilenameSegment(segment) {
+    const s = segment.trim();
+    if (!s)
+        return s;
+    if (!/%[0-9A-Fa-f]{2}/.test(s))
+        return s;
+    try {
+        return decodeURIComponent(s.replace(/\+/g, " "));
+    }
+    catch {
+        return s;
+    }
+}
+/**
+ * 从 HTTP Content-Disposition 解析文件名（优先 RFC 5987 `filename*=` UTF-8，再普通 filename=）。
+ */
+export function parseFilenameFromContentDisposition(header) {
+    if (header == null || typeof header !== "string")
+        return undefined;
+    const h = header.trim();
+    if (!h)
+        return undefined;
+    const star = /filename\*\s*=\s*(?:UTF-8|utf-8)''([^;\r\n]+)/i.exec(h);
+    if (star?.[1]) {
+        const v = star[1].trim();
+        const decoded = safeDecodeUriFilenameSegment(v);
+        if (decoded)
+            return decoded;
+    }
+    const quoted = /filename\s*=\s*"((?:[^"\\]|\\.)*)"/i.exec(h);
+    if (quoted?.[1]) {
+        const inner = quoted[1].replace(/\\(.)/g, "$1").trim();
+        if (inner)
+            return safeDecodeUriFilenameSegment(inner);
+    }
+    const unquoted = /filename\s*=\s*([^;\r\n]+)/i.exec(h);
+    if (unquoted?.[1]) {
+        let v = unquoted[1].trim().replace(/^["']|["']$/g, "");
+        if (v.toLowerCase().startsWith("utf-8''"))
+            v = v.slice(7);
+        if (v)
+            return safeDecodeUriFilenameSegment(v);
+    }
+    return undefined;
+}
+export function displayNameFromUrl(url) {
+    try {
+        if (url.startsWith("file://")) {
+            return path.basename(fileURLToPath(url)) || "file";
+        }
+        const u = new URL(url);
+        const qName = u.searchParams.get("filename") ?? u.searchParams.get("name");
+        if (qName?.trim()) {
+            return safeDecodeUriFilenameSegment(qName.trim()) || "attachment";
+        }
+        const pathname = u.pathname || "/";
+        const last = pathname.split("/").filter(Boolean).pop() ?? "";
+        const base = safeDecodeUriFilenameSegment(last.split("?")[0] || "");
+        return base || "attachment";
+    }
+    catch {
+        return "attachment";
+    }
+}
+/** 日志用：截断过长路径/URL */
+export function summarizeMediaRef(ref, maxLen = 160) {
+    const t = ref.trim().replace(/\s+/g, " ");
+    if (t.length <= maxLen)
+        return t;
+    return `${t.slice(0, maxLen)}…(len=${t.length})`;
+}
+function isHttpOrHttps(ref) {
+    try {
+        const u = new URL(ref.trim());
+        return u.protocol === "http:" || u.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 将字符串解析为可交给 readFile 的本机路径（兼容 Windows / macOS / Linux）。
+ * - 使用当前进程的 path.isAbsolute（各 OS 语义正确）。
+ * - Windows：Git Bash / MSYS 的 `/c/Users/...`、Cygwin `/cygdrive/c/...`。
+ * - 非 Windows：若传入 `D:\...` 形式仍做一次规范化（多用于日志/失败提示，读文件通常会失败）。
+ */
+export function resolveLocalFsPath(ref) {
+    const raw = ref.trim();
+    if (!raw)
+        return null;
+    if (process.platform === "win32") {
+        // MSYS/Git Bash: /c/Users/foo → C:\Users\foo（要求 /<盘符>/ 后仍有路径，避免误伤 /Users）
+        const msys = /^\/([a-zA-Z])\/(.+)$/.exec(raw.replace(/\\/g, "/"));
+        if (msys) {
+            const letter = msys[1].toUpperCase();
+            const rest = msys[2].split("/").join(path.win32.sep);
+            const fsPath = path.win32.normalize(`${letter}:${path.win32.sep}${rest}`);
+            return { fsPath, via: "git-bash-msys" };
+        }
+        const cyg = /^\/cygdrive\/([a-zA-Z])\/(.+)$/i.exec(raw.replace(/\\/g, "/"));
+        if (cyg) {
+            const letter = cyg[1].toUpperCase();
+            const rest = cyg[2].split("/").join(path.win32.sep);
+            const fsPath = path.win32.normalize(`${letter}:${path.win32.sep}${rest}`);
+            return { fsPath, via: "cygwin" };
+        }
+    }
+    if (path.isAbsolute(raw)) {
+        return { fsPath: path.normalize(raw), via: `native-${process.platform}` };
+    }
+    // Linux/macOS 上 WSL 互操作常见：/mnt/c/... 已是 posix 绝对路径，上面已命中
+    if (process.platform !== "win32" && /^[a-zA-Z]:[/\\]/.test(raw)) {
+        return { fsPath: path.win32.normalize(raw), via: "win-style-path" };
+    }
+    return null;
+}
+async function readLocalFsIntoBuffer(fsPath, maxBytes, log) {
+    const buffer = await readFile(fsPath);
+    if (buffer.length > maxBytes) {
+        throw new Error(`local file size ${buffer.length} exceeds maxAttachmentBytes=${maxBytes}`);
+    }
+    const filename = path.basename(fsPath) || "file";
+    log?.info(`[cwork_im:media] local ok bytes=${buffer.length} name=${filename}`);
+    return { buffer, filename };
+}
+/**
+ * 将 OpenClaw 约定的 `/workspace/<rel>` 路径解析为本机绝对路径（跨平台）。
+ *
+ * OpenClaw 在所有平台启动时均会 chdir 到 workspace 目录，因此
+ * `process.cwd()` 即为 workspace 根，/workspace/<rel> 等价于 cwd/<rel>：
+ *   - Windows : C:\Users\..\.openclaw\workspace\<rel>
+ *   - macOS   : ~/.openclaw/workspace/<rel>
+ *   - Linux容器: /workspace/<rel>（cwd=/workspace，path.join 结果不变）
+ *
+ * 返回 null 表示路径不符合 /workspace/ 格式。
+ */
+export function resolveWorkspacePrefixPath(raw) {
+    if (!raw.startsWith("/workspace/") && raw !== "/workspace")
+        return null;
+    const rel = raw.startsWith("/workspace/") ? raw.slice("/workspace/".length) : "";
+    const cwd = process.cwd();
+    return rel ? path.join(cwd, rel) : cwd;
+}
+export async function downloadMediaBuffer(url, maxBytes, log) {
+    const raw = url.trim();
+    log?.info(`[cwork_im:media] resolve ref=${summarizeMediaRef(raw)}`);
+    // Handle OpenClaw /workspace/ convention: map to actual workspace directory.
+    const workspaceResolved = resolveWorkspacePrefixPath(raw);
+    if (workspaceResolved && workspaceResolved !== raw) {
+        log?.info(`[cwork_im:media] /workspace/ -> ${summarizeMediaRef(workspaceResolved)}`);
+        try {
+            return await readLocalFsIntoBuffer(workspaceResolved, maxBytes, log);
+        }
+        catch (err) {
+            log?.error(`[cwork_im:media] readFile failed /workspace/ ${summarizeMediaRef(workspaceResolved)}: ${String(err)}`);
+            throw err;
+        }
+    }
+    if (raw.startsWith("file://")) {
+        let fsPath;
+        try {
+            fsPath = fileURLToPath(raw);
+        }
+        catch (e) {
+            log?.error(`[cwork_im:media] invalid file:// URL: ${summarizeMediaRef(raw)} ${String(e)}`);
+            throw e;
+        }
+        log?.info(`[cwork_im:media] read file:// -> ${summarizeMediaRef(fsPath)}`);
+        try {
+            return await readLocalFsIntoBuffer(fsPath, maxBytes, log);
+        }
+        catch (err) {
+            log?.error(`[cwork_im:media] readFile failed file:// ${summarizeMediaRef(fsPath)}: ${String(err)}`);
+            throw err;
+        }
+    }
+    if (isHttpOrHttps(raw)) {
+        log?.info(`[cwork_im:media] GET ${summarizeMediaRef(raw)}`);
+        try {
+            const res = await axios.get(raw, {
+                responseType: "arraybuffer",
+                timeout: 120_000,
+                maxContentLength: maxBytes,
+                maxBodyLength: maxBytes,
+                validateStatus: (s) => s >= 200 && s < 300,
+            });
+            const buffer = Buffer.from(res.data);
+            let filename = displayNameFromUrl(raw);
+            const cdRaw = res.headers["content-disposition"];
+            const cd = Array.isArray(cdRaw) ? cdRaw[0] : cdRaw;
+            if (typeof cd === "string") {
+                const fromCd = parseFilenameFromContentDisposition(cd);
+                if (fromCd)
+                    filename = fromCd;
+            }
+            log?.info(`[cwork_im:media] http ok bytes=${buffer.length} name=${filename}`);
+            return { buffer, filename };
+        }
+        catch (err) {
+            const detail = axios.isAxiosError(err)
+                ? `${err.message}${err.code ? ` axiosCode=${err.code}` : ""}${err.response?.status != null ? ` httpStatus=${err.response.status}` : ""}`
+                : String(err);
+            log?.error(`[cwork_im:media] http failed ref=${summarizeMediaRef(raw)}: ${detail}`);
+            throw err;
+        }
+    }
+    const resolved = resolveLocalFsPath(raw);
+    if (resolved) {
+        log?.info(`[cwork_im:media] local via=${resolved.via} -> ${summarizeMediaRef(resolved.fsPath)}`);
+        try {
+            return await readLocalFsIntoBuffer(resolved.fsPath, maxBytes, log);
+        }
+        catch (err) {
+            log?.error(`[cwork_im:media] readFile failed ${summarizeMediaRef(resolved.fsPath)}: ${String(err)}`);
+            throw err;
+        }
+    }
+    const hint = "请使用 http(s)、file://（三系统通用），或本机绝对路径：Windows C:\\\\... / UNC；macOS/Linux /Users、/home、/mnt/c/...（WSL）；Windows 下 Git Bash 可用 /c/...";
+    log?.error(`[cwork_im:media] unsupported ref=${summarizeMediaRef(raw)} (${hint})`);
+    throw new Error(`[cwork_im] 无法读取媒体（${hint}）: ${summarizeMediaRef(raw)}`);
+}
+/**
+ * multipart 上传整文件，返回 fileId 与字节数。
+ */
+export async function uploadWholeResourceFile(args) {
+    const { fileUploadUrl, token, buffer, filename, formField, log } = args;
+    const form = new FormData();
+    // 使用 File 携带 UTF-8 文件名，避免部分环境下 Blob+第三参在 multipart 里被错误编码导致服务端乱码
+    const file = new File([buffer], filename, { type: "application/octet-stream" });
+    form.append(formField, file);
+    log?.info(`[cwork_im:upload] POST ${fileUploadUrl} field=${formField} name=${filename} bytes=${buffer.length}`);
+    const res = await fetch(fileUploadUrl, {
+        method: "POST",
+        headers: {
+            "access-token": token,
+        },
+        body: form,
+    });
+    const rawText = await res.text();
+    let json;
+    try {
+        json = rawText ? JSON.parse(rawText) : undefined;
+    }
+    catch {
+        json = undefined;
+    }
+    if (!res.ok) {
+        log?.error(`[cwork_im:upload] HTTP ${res.status} body=${rawText.slice(0, 500)}`);
+        throw new Error(`upload HTTP ${res.status}: ${rawText.slice(0, 500)}`);
+    }
+    // Unified IM API response: { data, resultCode: 1, resultMsg: "" } — resultCode=1 means success.
+    if (json && typeof json === "object") {
+        const j = json;
+        if (j.resultCode !== undefined && j.resultCode !== 1) {
+            const msg = `upload IM API error resultCode=${j.resultCode}${j.resultMsg ? ` resultMsg=${j.resultMsg}` : ""}`;
+            log?.error(`[cwork_im:upload] ${msg} body=${rawText.slice(0, 500)}`);
+            throw new Error(msg);
+        }
+    }
+    const fileId = extractFileIdFromUploadResponse(json ?? rawText);
+    if (!fileId) {
+        log?.error(`[cwork_im:upload] missing fileId in body=${rawText.slice(0, 500)}`);
+        throw new Error(`upload response missing fileId: ${rawText.slice(0, 500)}`);
+    }
+    return { fileId, size: buffer.length };
+}
+export function resolveMaxAttachmentBytes(config) {
+    return config.maxAttachmentBytes ?? DEFAULT_MAX_BYTES;
+}
+//# sourceMappingURL=resource-file.js.map