import { randomUUID } from "node:crypto"; import { mkdir, readFile, writeFile } from "node:fs/promises"; import { basename, extname, resolve } from "node:path"; import { fileURLToPath } from "node:url"; import { ImageGenError } from "../core/errors.js"; const allowed = new Set([".png", ".jpg", ".jpeg", ".webp"]); export function detectImageFormat(buffer: Buffer): { mimeType: string; ext: string } | undefined { if (buffer.length >= 8 && buffer.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]))) return { mimeType: "image/png", ext: "png" }; if (buffer.length >= 3 && buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) return { mimeType: "image/jpeg", ext: "jpg" }; if (buffer.length >= 12 && buffer.toString("ascii", 0, 4) === "RIFF" && buffer.toString("ascii", 8, 12) === "WEBP") return { mimeType: "image/webp", ext: "webp" }; return undefined; } export function extensionForMime(mime: string, fallback = "png"): string { if (mime.includes("jpeg") || mime.includes("jpg")) return "jpg"; if (mime.includes("webp")) return "webp"; if (mime.includes("png")) return "png"; return fallback.replace(/^\./, ""); } export async function saveImageBuffer(buffer: Buffer, outputDir: string, ext: string): Promise { if (buffer.length === 0) throw new ImageGenError("invalid_image", "图片内容为空。", "检查 API 返回或输入文件。 "); validateImageSignature(buffer, ext); const cleanExt = ext.toLowerCase().replace(/^\./, ""); if (!["png", "jpg", "jpeg", "webp"].includes(cleanExt)) throw new ImageGenError("unsupported_format", `不支持的图片格式:${ext}`, "使用 png、jpg、jpeg 或 webp。 "); await mkdir(outputDir, { recursive: true }); const date = new Date().toISOString().slice(0, 10); const path = resolve(outputDir, `${date}-${randomUUID().slice(0, 8)}.${cleanExt === "jpeg" ? "jpg" : cleanExt}`); await writeFile(path, buffer, { flag: "wx" }); return path; } export async function loadLocalImage(input: string): Promise<{ name: string; buffer: Buffer; mimeType: string }> { const path = normalizeImagePath(input); const ext = extname(path).toLowerCase(); if (!allowed.has(ext)) throw new ImageGenError("unsupported_format", `不支持的图片格式:${ext || "未知"}`, "仅支持 .png、.jpg、.jpeg、.webp。 "); const buffer = await readFile(path).catch((cause: unknown) => { throw new ImageGenError("invalid_image", `无法读取图片:${path}`, cause instanceof Error ? cause.message : "确认路径存在且可读。 "); }); validateImageSignature(buffer, ext); return { name: basename(path), buffer, mimeType: mimeFromExt(ext) }; } export function normalizeImagePath(input: string): string { const clean = input.startsWith("@") ? input.slice(1) : input; if (clean.startsWith("file://")) return fileURLToPath(clean); if (/^https?:\/\//i.test(clean)) throw new ImageGenError("unsupported_format", "此处需要本地图片路径。", "远程图片会由下载模块处理。 "); return resolve(clean); } export function mimeFromExt(ext: string): string { switch (ext.toLowerCase()) { case ".jpg": case ".jpeg": return "image/jpeg"; case ".webp": return "image/webp"; case ".png": return "image/png"; default: throw new ImageGenError("unsupported_format", `不支持的图片格式:${ext}`, "仅支持 png、jpg、jpeg、webp。 "); } } function validateImageSignature(buffer: Buffer, ext: string): void { const clean = ext.toLowerCase().replace(/^\./, ""); const png = buffer.length >= 8 && buffer.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10])); const jpg = buffer.length >= 3 && buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff; const webp = buffer.length >= 12 && buffer.toString("ascii", 0, 4) === "RIFF" && buffer.toString("ascii", 8, 12) === "WEBP"; if ((clean === "png" && !png) || ((clean === "jpg" || clean === "jpeg") && !jpg) || (clean === "webp" && !webp)) throw new ImageGenError("invalid_image", "内容不是有效的图片文件。", "Provider 可能返回了鉴权页或错误页面。 "); } export function decodeBase64Image(data: string): { buffer: Buffer; mimeType: string; ext: string } { const match = data.match(/^data:(image\/(png|jpeg|jpg|webp));base64,(.+)$/i); const payload = match?.[3] ?? data; const buffer = Buffer.from(payload, "base64"); if (buffer.length === 0) throw new ImageGenError("invalid_image", "API 返回了空 base64 图片。", "检查服务商响应。 "); const detected = detectImageFormat(buffer); const mimeType = match?.[1] ?? detected?.mimeType ?? "image/png"; const ext = match?.[1] ? extensionForMime(mimeType) : detected?.ext ?? "png"; return { buffer, mimeType, ext }; }