import { readFileSync } from "node:fs"; import { join } from "node:path"; import { expect, test } from "@playwright/test"; // ─── Utility Tools ────────────────────────────────────────────────── // Tests for: info, compare, find-duplicates, color-palette, // qr-generate, barcode-read, bulk-rename // These tools extract metadata, compare images, and generate assets. const FIXTURES = join(process.cwd(), "tests", "fixtures"); const FORMATS = join(FIXTURES, "formats"); const CONTENT = join(FIXTURES, "content"); let token: string; test.beforeAll(async ({ request }) => { const res = await request.post("/api/auth/login", { data: { username: "admin", password: "admin" }, }); const body = await res.json(); token = body.token; }); function fixture(name: string): Buffer { return readFileSync(join(FIXTURES, name)); } function formatFixture(name: string): Buffer { return readFileSync(join(FORMATS, name)); } function contentFixture(name: string): Buffer { return readFileSync(join(CONTENT, name)); } /** * Build a raw multipart/form-data body. Playwright's `multipart` option * does not support arrays for the same field name, so multi-file uploads * must be assembled manually. */ function buildMultipart( files: Array<{ name: string; filename: string; contentType: string; buffer: Buffer }>, fields: Array<{ name: string; value: string }>, ): { body: Buffer; contentType: string } { const boundary = `----PlaywrightBoundary${Date.now()}`; const parts: Buffer[] = []; for (const file of files) { parts.push( Buffer.from( `--${boundary}\r\nContent-Disposition: form-data; name="${file.name}"; filename="${file.filename}"\r\nContent-Type: ${file.contentType}\r\n\r\n`, ), ); parts.push(file.buffer); parts.push(Buffer.from("\r\n")); } for (const field of fields) { parts.push( Buffer.from( `--${boundary}\r\nContent-Disposition: form-data; name="${field.name}"\r\n\r\n${field.value}\r\n`, ), ); } parts.push(Buffer.from(`--${boundary}--\r\n`)); return { body: Buffer.concat(parts), contentType: `multipart/form-data; boundary=${boundary}`, }; } const PNG_200x150 = fixture("test-200x150.png"); const JPG_100x100 = fixture("test-100x100.jpg"); const JPG_WITH_EXIF = fixture("test-with-exif.jpg"); const HEIC_200x150 = fixture("test-200x150.heic"); const WEBP_50x50 = fixture("test-50x50.webp"); // ─── Info ──────────────────────────────────────────────────────────── test.describe("Info", () => { test("returns metadata for PNG image", async ({ request }) => { const res = await request.post("/api/v1/tools/image/info", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.filename).toBe("test.png"); expect(body.width).toBe(200); expect(body.height).toBe(150); expect(body.format).toBe("png"); expect(body.channels).toBeGreaterThan(0); expect(typeof body.hasAlpha).toBe("boolean"); expect(body.fileSize).toBeGreaterThan(0); expect(body.colorSpace).toBeTruthy(); }); test("returns metadata for JPEG image", async ({ request }) => { const res = await request.post("/api/v1/tools/image/info", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.jpg", mimeType: "image/jpeg", buffer: JPG_100x100 }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.width).toBe(100); expect(body.height).toBe(100); expect(body.format).toBe("jpeg"); }); test("returns EXIF info for JPEG with metadata", async ({ request }) => { const res = await request.post("/api/v1/tools/image/info", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test-with-exif.jpg", mimeType: "image/jpeg", buffer: JPG_WITH_EXIF }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.hasExif).toBe(true); expect(body.fileSize).toBeGreaterThan(0); }); test("returns metadata for HEIC image", async ({ request }) => { const res = await request.post("/api/v1/tools/image/info", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.heic", mimeType: "image/heic", buffer: HEIC_200x150 }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.width).toBeGreaterThan(0); expect(body.height).toBeGreaterThan(0); expect(body.fileSize).toBeGreaterThan(0); }); test("returns histogram data", async ({ request }) => { const res = await request.post("/api/v1/tools/image/info", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.histogram).toBeInstanceOf(Array); expect(body.histogram.length).toBeGreaterThan(0); const firstChannel = body.histogram[0]; expect(firstChannel.channel).toBeTruthy(); expect(typeof firstChannel.min).toBe("number"); expect(typeof firstChannel.max).toBe("number"); expect(typeof firstChannel.mean).toBe("number"); expect(typeof firstChannel.stdev).toBe("number"); }); test("returns metadata for WebP image", async ({ request }) => { const res = await request.post("/api/v1/tools/image/info", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.webp", mimeType: "image/webp", buffer: WEBP_50x50 }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.width).toBe(50); expect(body.height).toBe(50); expect(body.format).toBe("webp"); }); test("returns metadata for BMP from formats fixture", async ({ request }) => { const bmp = formatFixture("sample.bmp"); const res = await request.post("/api/v1/tools/image/info", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "sample.bmp", mimeType: "image/bmp", buffer: bmp }, }, }); // BMP may not be supported if Sharp can't decode it natively if (res.ok()) { const body = await res.json(); expect(body.width).toBeGreaterThan(0); expect(body.height).toBeGreaterThan(0); } else { expect([400, 422]).toContain(res.status()); } }); test("rejects request with no file", async ({ request }) => { const res = await request.post("/api/v1/tools/image/info", { headers: { Authorization: `Bearer ${token}` }, multipart: {}, }); expect(res.ok()).toBe(false); }); }); // ─── Compare ──────────────────────────────────────────────────────── test.describe("Compare", () => { test("compare two identical images returns high similarity", async ({ request }) => { const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "b.png", contentType: "image/png", buffer: PNG_200x150 }, ], [], ); const res = await request.post("/api/v1/tools/image/compare", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(true); const json = await res.json(); // API returns similarity as a percentage (0-100) expect(json.similarity).toBeGreaterThan(99); expect(json.downloadUrl).toBeTruthy(); }); test("compare two different images returns lower similarity", async ({ request }) => { const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "b.jpg", contentType: "image/jpeg", buffer: JPG_100x100 }, ], [], ); const res = await request.post("/api/v1/tools/image/compare", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(true); const json = await res.json(); // API returns similarity as a percentage (0-100) expect(typeof json.similarity).toBe("number"); expect(json.similarity).toBeGreaterThanOrEqual(0); expect(json.similarity).toBeLessThanOrEqual(100); }); test("compare rejects single file", async ({ request }) => { const { body, contentType } = buildMultipart( [{ name: "file", filename: "a.png", contentType: "image/png", buffer: PNG_200x150 }], [], ); const res = await request.post("/api/v1/tools/image/compare", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(false); const json = await res.json(); expect(json.error).toContain("Two"); }); }); // ─── Find Duplicates ──────────────────────────────────────────────── test.describe("Find Duplicates", () => { test("detect duplicates among identical images", async ({ request }) => { const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "b.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "c.jpg", contentType: "image/jpeg", buffer: JPG_100x100 }, ], [], ); const res = await request.post("/api/v1/tools/image/find-duplicates", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(true); const json = await res.json(); // Should detect the two identical PNGs as duplicates expect(json.duplicateGroups).toBeTruthy(); expect(json.duplicateGroups.length).toBeGreaterThan(0); }); test("no duplicates among unique images", async ({ request }) => { const portrait = readFileSync(join(CONTENT, "portrait-bw.jpeg")); const motorcycle = readFileSync(join(CONTENT, "motorcycle.heif")); const { body, contentType } = buildMultipart( [ { name: "file", filename: "portrait.jpeg", contentType: "image/jpeg", buffer: portrait }, { name: "file", filename: "motorcycle.heif", contentType: "image/heif", buffer: motorcycle, }, ], [], ); const res = await request.post("/api/v1/tools/image/find-duplicates", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(true); const json = await res.json(); // Visually distinct images — zero duplicate groups expect(json.duplicateGroups).toBeInstanceOf(Array); expect(json.duplicateGroups.length).toBe(0); }); test("find-duplicates response includes file info", async ({ request }) => { const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "b.png", contentType: "image/png", buffer: PNG_200x150 }, ], [], ); const res = await request.post("/api/v1/tools/image/find-duplicates", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(true); const json = await res.json(); // Response should contain duplicateGroups and totalImages expect(json.duplicateGroups).toBeTruthy(); expect(json.totalImages).toBeGreaterThan(0); }); }); // ─── Color Palette ────────────────────────────────────────────────── test.describe("Color Palette", () => { test("extract colors from PNG", async ({ request }) => { const res = await request.post("/api/v1/tools/image/color-palette", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.filename).toBe("test.png"); expect(body.colors).toBeInstanceOf(Array); expect(body.colors.length).toBeGreaterThan(0); expect(body.count).toBe(body.colors.length); // Each color should be a hex string for (const color of body.colors) { expect(color).toMatch(/^#[0-9a-fA-F]{6}$/); } }); test("extract colors from JPEG", async ({ request }) => { const res = await request.post("/api/v1/tools/image/color-palette", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.jpg", mimeType: "image/jpeg", buffer: JPG_100x100 }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.colors).toBeInstanceOf(Array); expect(body.colors.length).toBeGreaterThan(0); }); test("extract colors from sample JPEG has diverse palette", async ({ request }) => { const sample = formatFixture("sample.jpg"); const res = await request.post("/api/v1/tools/image/color-palette", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "sample.jpg", mimeType: "image/jpeg", buffer: sample }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); // A real photograph should have multiple distinct colors expect(body.colors.length).toBeGreaterThanOrEqual(3); }); test("extract colors from HEIC image", async ({ request }) => { const res = await request.post("/api/v1/tools/image/color-palette", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.heic", mimeType: "image/heic", buffer: HEIC_200x150 }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.colors).toBeInstanceOf(Array); }); }); // ─── QR Generate ──────────────────────────────────────────────────── test.describe("QR Generate", () => { test("generate QR code from URL", async ({ request }) => { const res = await request.post("/api/v1/tools/image/qr-generate", { headers: { Authorization: `Bearer ${token}` }, data: { text: "https://snapotter.app", size: 512, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.downloadUrl).toBeTruthy(); expect(body.processedSize).toBeGreaterThan(0); }); test("generate QR code with custom colors", async ({ request }) => { const res = await request.post("/api/v1/tools/image/qr-generate", { headers: { Authorization: `Bearer ${token}` }, data: { text: "Hello World", size: 400, foreground: "#0000FF", background: "#FFFF00", }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.downloadUrl).toBeTruthy(); }); test("generate QR code with high error correction", async ({ request }) => { const res = await request.post("/api/v1/tools/image/qr-generate", { headers: { Authorization: `Bearer ${token}` }, data: { text: "https://github.com/snapotter/snapotter", size: 300, errorCorrection: "H", }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.downloadUrl).toBeTruthy(); }); test("generate QR code with minimum size", async ({ request }) => { const res = await request.post("/api/v1/tools/image/qr-generate", { headers: { Authorization: `Bearer ${token}` }, data: { text: "test", size: 100, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.downloadUrl).toBeTruthy(); }); test("reject empty text", async ({ request }) => { const res = await request.post("/api/v1/tools/image/qr-generate", { headers: { Authorization: `Bearer ${token}` }, data: { text: "", size: 400, }, }); expect(res.ok()).toBe(false); const body = await res.json(); expect(body.error).toBeDefined(); }); test("reject size below minimum", async ({ request }) => { const res = await request.post("/api/v1/tools/image/qr-generate", { headers: { Authorization: `Bearer ${token}` }, data: { text: "test", size: 10, }, }); expect(res.ok()).toBe(false); }); }); // ─── Barcode Read ─────────────────────────────────────────────────── test.describe("Barcode Read", () => { test("read QR code from generated image (round-trip)", async ({ request }) => { // Generate a QR code first, then read it back const genRes = await request.post("/api/v1/tools/image/qr-generate", { headers: { Authorization: `Bearer ${token}` }, data: { text: "https://example.com/test", size: 400 }, }); expect(genRes.ok()).toBe(true); const genBody = await genRes.json(); // Download the generated QR image const dlRes = await request.get(genBody.downloadUrl, { headers: { Authorization: `Bearer ${token}` }, }); expect(dlRes.ok()).toBe(true); const qrBuffer = Buffer.from(await dlRes.body()); // Now read it with barcode-read const res = await request.post("/api/v1/tools/image/barcode-read", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "qr.png", mimeType: "image/png", buffer: qrBuffer }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.barcodes).toBeInstanceOf(Array); expect(body.barcodes.length).toBeGreaterThan(0); const barcode = body.barcodes[0]; expect(barcode.text).toBe("https://example.com/test"); }); test("read barcode from barcode fixture", async ({ request }) => { const barcodeImage = contentFixture("barcode.avif"); const res = await request.post("/api/v1/tools/image/barcode-read", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "barcode.avif", mimeType: "image/avif", buffer: barcodeImage }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.barcodes).toBeInstanceOf(Array); // Should detect at least one barcode if (body.barcodes.length > 0) { expect(body.barcodes[0].text).toBeTruthy(); expect(body.annotatedUrl).toBeTruthy(); } }); test("return empty array for image with no barcodes", async ({ request }) => { const res = await request.post("/api/v1/tools/image/barcode-read", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.barcodes).toBeInstanceOf(Array); expect(body.barcodes.length).toBe(0); expect(body.annotatedUrl).toBeNull(); }); test("annotated image URL returned when barcodes found", async ({ request }) => { const qrImage = contentFixture("qr-code.avif"); const res = await request.post("/api/v1/tools/image/barcode-read", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "qr-code.avif", mimeType: "image/avif", buffer: qrImage }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); if (body.barcodes.length > 0) { expect(body.annotatedUrl).toBeTruthy(); expect(body.previewUrl).toBeTruthy(); // Verify the annotated image can be downloaded const downloadRes = await request.get(body.annotatedUrl, { headers: { Authorization: `Bearer ${token}` }, }); expect(downloadRes.ok()).toBe(true); } }); }); // ─── Bulk Rename ──────────────────────────────────────────────────── test.describe("Bulk Rename", () => { test("rename files with default pattern", async ({ request }) => { const { body: reqBody, contentType } = buildMultipart( [ { name: "file", filename: "photo1.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "photo2.jpg", contentType: "image/jpeg", buffer: JPG_100x100 }, ], [{ name: "settings", value: JSON.stringify({ pattern: "image-{{index}}" }) }], ); const res = await request.post("/api/v1/tools/image/bulk-rename", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: reqBody, }); expect(res.ok()).toBe(true); // Bulk rename returns a ZIP with renamed files const resContentType = res.headers()["content-type"] ?? ""; // Should be a ZIP or JSON with download URL if (resContentType.includes("application/json")) { const json = await res.json(); expect(json.downloadUrl || json.files).toBeTruthy(); } else { // Binary ZIP response const buffer = Buffer.from(await res.body()); expect(buffer.length).toBeGreaterThan(0); } }); test("rename files with custom pattern and start index", async ({ request }) => { const { body: reqBody, contentType } = buildMultipart( [ { name: "file", filename: "a.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "b.jpg", contentType: "image/jpeg", buffer: JPG_100x100 }, { name: "file", filename: "c.webp", contentType: "image/webp", buffer: WEBP_50x50 }, ], [ { name: "settings", value: JSON.stringify({ pattern: "vacation-{{index}}", startIndex: 100 }), }, ], ); const res = await request.post("/api/v1/tools/image/bulk-rename", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: reqBody, }); expect(res.ok()).toBe(true); }); test("reject empty file list", async ({ request }) => { const { body: reqBody, contentType } = buildMultipart( [], [{ name: "settings", value: JSON.stringify({ pattern: "test-{{index}}" }) }], ); const res = await request.post("/api/v1/tools/image/bulk-rename", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: reqBody, }); expect(res.ok()).toBe(false); const json = await res.json(); expect(json.error).toBeDefined(); }); }); // ─── Image to Base64 ─────────────────────────────────────────────── test.describe("Image to Base64", () => { test("encode PNG to base64 returns data URI", async ({ request }) => { const res = await request.post("/api/v1/tools/image/image-to-base64", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.results).toBeInstanceOf(Array); expect(body.results.length).toBeGreaterThan(0); const result = body.results[0]; expect(result.base64).toBeTruthy(); expect(result.dataUri).toContain("data:image/"); expect(result.mimeType).toBe("image/png"); expect(result.width).toBe(200); expect(result.height).toBe(150); }); test("encode JPEG to base64", async ({ request }) => { const res = await request.post("/api/v1/tools/image/image-to-base64", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.jpg", mimeType: "image/jpeg", buffer: JPG_100x100 }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.results[0].base64).toBeTruthy(); expect(body.results[0].mimeType).toContain("image/"); }); test("encode with maxWidth constraint", async ({ request }) => { const res = await request.post("/api/v1/tools/image/image-to-base64", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, settings: JSON.stringify({ maxWidth: 50 }), }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.results[0].width).toBeLessThanOrEqual(50); }); test("encode with output format conversion", async ({ request }) => { const res = await request.post("/api/v1/tools/image/image-to-base64", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, settings: JSON.stringify({ outputFormat: "jpeg", quality: 50 }), }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.results[0].mimeType).toBe("image/jpeg"); }); test("encode HEIC image to base64", async ({ request }) => { const res = await request.post("/api/v1/tools/image/image-to-base64", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.heic", mimeType: "image/heic", buffer: HEIC_200x150 }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.results[0].base64).toBeTruthy(); expect(body.results[0].width).toBeGreaterThan(0); }); test("overhead percent is calculated", async ({ request }) => { const res = await request.post("/api/v1/tools/image/image-to-base64", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(typeof body.results[0].overheadPercent).toBe("number"); expect(body.results[0].overheadPercent).toBeGreaterThan(0); }); }); // ─── QR Read (from content fixtures) ─────────────────────────────── test.describe("QR Read", () => { test("read QR code from content fixture", async ({ request }) => { const qrImage = contentFixture("qr-code.avif"); const res = await request.post("/api/v1/tools/image/barcode-read", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "qr-code.avif", mimeType: "image/avif", buffer: qrImage }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.barcodes).toBeInstanceOf(Array); if (body.barcodes.length > 0) { expect(body.barcodes[0].text).toBeTruthy(); } }); }); // ─── Compare — Additional ────────────────────────────────────── test.describe("Compare — additional", () => { test("compare HEIC and PNG images", async ({ request }) => { const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.heic", contentType: "image/heic", buffer: HEIC_200x150 }, { name: "file", filename: "b.png", contentType: "image/png", buffer: PNG_200x150 }, ], [], ); const res = await request.post("/api/v1/tools/image/compare", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(true); const json = await res.json(); expect(typeof json.similarity).toBe("number"); expect(json.similarity).toBeGreaterThanOrEqual(0); expect(json.similarity).toBeLessThanOrEqual(100); }); test("compare two different format images of same content", async ({ request }) => { const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.webp", contentType: "image/webp", buffer: WEBP_50x50 }, { name: "file", filename: "b.webp", contentType: "image/webp", buffer: WEBP_50x50 }, ], [], ); const res = await request.post("/api/v1/tools/image/compare", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(true); const json = await res.json(); // Same image should have very high similarity expect(json.similarity).toBeGreaterThan(99); }); }); // ─── Find Duplicates — Additional ───────────────────────────── test.describe("Find Duplicates — additional", () => { test("find duplicates with 4 files (2 pairs)", async ({ request }) => { const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "b.jpg", contentType: "image/jpeg", buffer: JPG_100x100 }, { name: "file", filename: "c.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "d.jpg", contentType: "image/jpeg", buffer: JPG_100x100 }, ], [], ); const res = await request.post("/api/v1/tools/image/find-duplicates", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(true); const json = await res.json(); expect(json.duplicateGroups).toBeInstanceOf(Array); expect(json.duplicateGroups.length).toBeGreaterThan(0); expect(json.totalImages).toBe(4); }); test("find duplicates with HEIC images", async ({ request }) => { const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.heic", contentType: "image/heic", buffer: HEIC_200x150 }, { name: "file", filename: "b.heic", contentType: "image/heic", buffer: HEIC_200x150 }, { name: "file", filename: "c.png", contentType: "image/png", buffer: PNG_200x150 }, ], [], ); const res = await request.post("/api/v1/tools/image/find-duplicates", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(true); const json = await res.json(); expect(json.duplicateGroups).toBeInstanceOf(Array); }); }); // ─── QR Generate — Output Verification ───────────────────────── test.describe("QR Generate — output verification", () => { test("QR code image can be downloaded", async ({ request }) => { const res = await request.post("/api/v1/tools/image/qr-generate", { headers: { Authorization: `Bearer ${token}` }, data: { text: "https://test.snapotter.app/verify", size: 300, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.downloadUrl).toBeTruthy(); // Download the QR code const dlRes = await request.get(body.downloadUrl, { headers: { Authorization: `Bearer ${token}` }, }); expect(dlRes.ok()).toBe(true); const buffer = Buffer.from(await dlRes.body()); expect(buffer.length).toBeGreaterThan(0); }); test("QR code with all error correction levels", async ({ request }) => { const levels = ["L", "M", "Q", "H"] as const; for (const errorCorrection of levels) { const res = await request.post("/api/v1/tools/image/qr-generate", { headers: { Authorization: `Bearer ${token}` }, data: { text: `EC-${errorCorrection}`, size: 200, errorCorrection, }, }); expect(res.ok(), `QR with EC=${errorCorrection} should succeed`).toBe(true); const body = await res.json(); expect(body.downloadUrl).toBeTruthy(); } }); }); // ─── Color Palette — Additional ──────────────────────────────── test.describe("Color Palette — additional", () => { test("extract colors from WebP image", async ({ request }) => { const res = await request.post("/api/v1/tools/image/color-palette", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.webp", mimeType: "image/webp", buffer: WEBP_50x50 }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.colors).toBeInstanceOf(Array); expect(body.colors.length).toBeGreaterThan(0); }); test("color palette on content image has rich palette", async ({ request }) => { const portrait = contentFixture("portrait-color.jpg"); const res = await request.post("/api/v1/tools/image/color-palette", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "portrait.jpg", mimeType: "image/jpeg", buffer: portrait }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.colors.length).toBeGreaterThanOrEqual(3); }); }); // ─── Find Duplicates -- 5+ Files ────────────────────────────────── test.describe("Find Duplicates -- large set", () => { test("find duplicates with 5 files (3 identical, 2 unique)", async ({ request }) => { const portrait = contentFixture("portrait-color.jpg"); const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "b.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "c.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "d.jpg", contentType: "image/jpeg", buffer: JPG_100x100 }, { name: "file", filename: "e.jpg", contentType: "image/jpeg", buffer: portrait, }, ], [], ); const res = await request.post("/api/v1/tools/image/find-duplicates", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(true); const json = await res.json(); expect(json.totalImages).toBe(5); expect(json.duplicateGroups).toBeInstanceOf(Array); // The three identical PNGs should form at least one duplicate group expect(json.duplicateGroups.length).toBeGreaterThan(0); }); test("find duplicates with 6 files (2 pairs of duplicates)", async ({ request }) => { const portrait = contentFixture("portrait-color.jpg"); const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "b.jpg", contentType: "image/jpeg", buffer: JPG_100x100 }, { name: "file", filename: "c.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "d.jpg", contentType: "image/jpeg", buffer: JPG_100x100 }, { name: "file", filename: "e.webp", contentType: "image/webp", buffer: WEBP_50x50 }, { name: "file", filename: "f.jpg", contentType: "image/jpeg", buffer: portrait, }, ], [], ); const res = await request.post("/api/v1/tools/image/find-duplicates", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(true); const json = await res.json(); expect(json.totalImages).toBe(6); expect(json.duplicateGroups).toBeInstanceOf(Array); // Perceptual hashing may group small test images aggressively expect(json.duplicateGroups.length).toBeGreaterThanOrEqual(1); }); test("find-duplicates with all unique files returns 0 groups", async ({ request }) => { const portrait = contentFixture("portrait-color.jpg"); const motorcycle = contentFixture("motorcycle.heif"); const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "b.jpg", contentType: "image/jpeg", buffer: portrait }, { name: "file", filename: "c.heif", contentType: "image/heif", buffer: motorcycle }, { name: "file", filename: "d.webp", contentType: "image/webp", buffer: WEBP_50x50 }, ], [], ); const res = await request.post("/api/v1/tools/image/find-duplicates", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: body, }); expect(res.ok()).toBe(true); const json = await res.json(); expect(json.totalImages).toBe(4); expect(json.duplicateGroups).toBeInstanceOf(Array); expect(json.duplicateGroups.length).toBe(0); }); }); // ─── Color Palette -- Count Variations ─────────────────────────── test.describe("Color Palette -- count variations", () => { test("extract palette from monochrome-like image", async ({ request }) => { const portraitBw = contentFixture("portrait-bw.jpeg"); const res = await request.post("/api/v1/tools/image/color-palette", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "bw.jpeg", mimeType: "image/jpeg", buffer: portraitBw }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.colors).toBeInstanceOf(Array); expect(body.colors.length).toBeGreaterThan(0); for (const color of body.colors) { expect(color).toMatch(/^#[0-9a-fA-F]{6}$/); } }); test("extract palette from colorful content image", async ({ request }) => { const portrait = contentFixture("portrait-color.jpg"); const res = await request.post("/api/v1/tools/image/color-palette", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "colorful.jpg", mimeType: "image/jpeg", buffer: portrait }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.colors).toBeInstanceOf(Array); // Colorful images should yield more colors expect(body.colors.length).toBeGreaterThanOrEqual(4); }); test("extract palette from large stress image", async ({ request }) => { const large = contentFixture("stress-large.jpg"); const res = await request.post("/api/v1/tools/image/color-palette", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "large.jpg", mimeType: "image/jpeg", buffer: large }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.colors).toBeInstanceOf(Array); expect(body.colors.length).toBeGreaterThan(0); expect(body.count).toBe(body.colors.length); }); }); // ─── QR Generate -- All Error Correction Levels with Round-trip ── test.describe("QR Generate -- EC levels round-trip", () => { const ecLevels = ["L", "M", "Q", "H"] as const; for (const ec of ecLevels) { test(`generate QR with EC=${ec} and verify via barcode-read`, async ({ request }) => { const testText = `EC-${ec}-round-trip`; const genRes = await request.post("/api/v1/tools/image/qr-generate", { headers: { Authorization: `Bearer ${token}` }, data: { text: testText, size: 400, errorCorrection: ec }, }); expect(genRes.ok(), `QR generation with EC=${ec} should succeed`).toBe(true); const genBody = await genRes.json(); expect(genBody.downloadUrl).toBeTruthy(); // Download the generated QR const dlRes = await request.get(genBody.downloadUrl, { headers: { Authorization: `Bearer ${token}` }, }); expect(dlRes.ok()).toBe(true); const qrBuffer = Buffer.from(await dlRes.body()); expect(qrBuffer.length).toBeGreaterThan(0); // Read it back const readRes = await request.post("/api/v1/tools/image/barcode-read", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "qr.png", mimeType: "image/png", buffer: qrBuffer }, settings: JSON.stringify({}), }, }); expect(readRes.ok()).toBe(true); const readBody = await readRes.json(); expect(readBody.barcodes).toBeInstanceOf(Array); expect(readBody.barcodes.length).toBeGreaterThan(0); expect(readBody.barcodes[0].text).toBe(testText); }); } }); // ─── QR Generate -- Size Variations ────────────────────────────── test.describe("QR Generate -- size variations", () => { const sizes = [100, 200, 400, 512, 1024] as const; for (const size of sizes) { test(`generate QR code at size=${size}`, async ({ request }) => { const res = await request.post("/api/v1/tools/image/qr-generate", { headers: { Authorization: `Bearer ${token}` }, data: { text: `size-${size}`, size }, }); expect(res.ok(), `QR at size=${size} should succeed`).toBe(true); const body = await res.json(); expect(body.downloadUrl).toBeTruthy(); expect(body.processedSize).toBeGreaterThan(0); }); } }); // ─── Barcode Read -- No Barcode in Image ───────────────────────── test.describe("Barcode Read -- no barcode scenarios", () => { test("return empty for WebP with no barcode", async ({ request }) => { const res = await request.post("/api/v1/tools/image/barcode-read", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.webp", mimeType: "image/webp", buffer: WEBP_50x50 }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.barcodes).toBeInstanceOf(Array); expect(body.barcodes.length).toBe(0); }); test("return empty for HEIC with no barcode", async ({ request }) => { const res = await request.post("/api/v1/tools/image/barcode-read", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.heic", mimeType: "image/heic", buffer: HEIC_200x150 }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.barcodes).toBeInstanceOf(Array); expect(body.barcodes.length).toBe(0); }); }); // ─── Image to Base64 -- Data URI Format Verification ───────────── test.describe("Image to Base64 -- data URI verification", () => { test("data URI starts with correct MIME prefix for PNG", async ({ request }) => { const res = await request.post("/api/v1/tools/image/image-to-base64", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); const result = body.results[0]; expect(result.dataUri).toMatch(/^data:image\/png;base64,/); expect(result.base64.length).toBeGreaterThan(0); // Base64 encoding is ~33% overhead expect(result.overheadPercent).toBeGreaterThan(20); expect(result.overheadPercent).toBeLessThan(50); }); test("data URI starts with correct MIME prefix for JPEG", async ({ request }) => { const res = await request.post("/api/v1/tools/image/image-to-base64", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.jpg", mimeType: "image/jpeg", buffer: JPG_100x100 }, settings: JSON.stringify({}), }, }); expect(res.ok()).toBe(true); const body = await res.json(); const result = body.results[0]; expect(result.dataUri).toMatch(/^data:image\/jpeg;base64,/); expect(result.mimeType).toBe("image/jpeg"); }); test("data URI with format conversion has correct prefix", async ({ request }) => { const res = await request.post("/api/v1/tools/image/image-to-base64", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, settings: JSON.stringify({ outputFormat: "webp", quality: 80 }), }, }); expect(res.ok()).toBe(true); const body = await res.json(); const result = body.results[0]; expect(result.dataUri).toMatch(/^data:image\/webp;base64,/); expect(result.mimeType).toBe("image/webp"); }); test("base64 output with maxWidth and maxHeight", async ({ request }) => { const res = await request.post("/api/v1/tools/image/image-to-base64", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, settings: JSON.stringify({ maxWidth: 50, maxHeight: 50 }), }, }); expect(res.ok()).toBe(true); const body = await res.json(); const result = body.results[0]; expect(result.width).toBeLessThanOrEqual(50); expect(result.height).toBeLessThanOrEqual(50); expect(result.base64).toBeTruthy(); }); }); // ─── Bulk Rename -- ZIP Content Verification ───────────────────── test.describe("Bulk Rename -- ZIP verification", () => { test("renamed files ZIP is downloadable", async ({ request }) => { const { body: reqBody, contentType } = buildMultipart( [ { name: "file", filename: "photo1.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "photo2.jpg", contentType: "image/jpeg", buffer: JPG_100x100 }, { name: "file", filename: "photo3.webp", contentType: "image/webp", buffer: WEBP_50x50 }, ], [{ name: "settings", value: JSON.stringify({ pattern: "renamed-{{index}}" }) }], ); const res = await request.post("/api/v1/tools/image/bulk-rename", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: reqBody, }); expect(res.ok()).toBe(true); const resContentType = res.headers()["content-type"] ?? ""; if (resContentType.includes("application/json")) { const json = await res.json(); expect(json.downloadUrl || json.files).toBeTruthy(); if (json.downloadUrl) { const dlRes = await request.get(json.downloadUrl, { headers: { Authorization: `Bearer ${token}` }, }); expect(dlRes.ok()).toBe(true); const buffer = Buffer.from(await dlRes.body()); expect(buffer.length).toBeGreaterThan(0); // ZIP magic bytes expect(buffer[0]).toBe(0x50); expect(buffer[1]).toBe(0x4b); } } else { const buffer = Buffer.from(await res.body()); expect(buffer.length).toBeGreaterThan(0); expect(buffer[0]).toBe(0x50); expect(buffer[1]).toBe(0x4b); } }); test("rename with original-name pattern", async ({ request }) => { const { body: reqBody, contentType } = buildMultipart( [ { name: "file", filename: "sunrise.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "sunset.jpg", contentType: "image/jpeg", buffer: JPG_100x100 }, ], [ { name: "settings", value: JSON.stringify({ pattern: "edited-{{original}}" }), }, ], ); const res = await request.post("/api/v1/tools/image/bulk-rename", { headers: { Authorization: `Bearer ${token}`, "Content-Type": contentType }, data: reqBody, }); expect(res.ok()).toBe(true); }); }); // ─── Info -- Detailed Metadata ────────────────────────────────── test.describe("Info -- detailed metadata", () => { test("info returns density and color space for JPEG", async ({ request }) => { const sample = contentFixture("portrait-color.jpg"); const res = await request.post("/api/v1/tools/image/info", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "portrait.jpg", mimeType: "image/jpeg", buffer: sample }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.width).toBeGreaterThan(0); expect(body.height).toBeGreaterThan(0); expect(body.format).toBe("jpeg"); expect(body.colorSpace).toBeTruthy(); expect(body.channels).toBeGreaterThanOrEqual(3); expect(body.fileSize).toBeGreaterThan(0); }); test("info returns correct format for AVIF", async ({ request }) => { const avif = readFileSync(join(FORMATS, "sample.avif")); const res = await request.post("/api/v1/tools/image/info", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "sample.avif", mimeType: "image/avif", buffer: avif }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.width).toBeGreaterThan(0); expect(body.height).toBeGreaterThan(0); }); test("info returns correct format for TIFF", async ({ request }) => { const tiff = readFileSync(join(FORMATS, "sample.tiff")); const res = await request.post("/api/v1/tools/image/info", { headers: { Authorization: `Bearer ${token}` }, multipart: { file: { name: "sample.tiff", mimeType: "image/tiff", buffer: tiff }, }, }); expect(res.ok()).toBe(true); const body = await res.json(); expect(body.width).toBeGreaterThan(0); expect(body.height).toBeGreaterThan(0); expect(body.format).toBeTruthy(); }); }); // ─── Auth Failure ────────────────────────────────────────────────── test.describe("Auth failure", () => { test("info without token returns 401", async ({ request }) => { const res = await request.post("/api/v1/tools/image/info", { multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, }, }); expect(res.status()).toBe(401); }); test("qr-generate without token returns 401", async ({ request }) => { const res = await request.post("/api/v1/tools/image/qr-generate", { data: { text: "https://snapotter.app", size: 512 }, }); expect(res.status()).toBe(401); }); test("color-palette without token returns 401", async ({ request }) => { const res = await request.post("/api/v1/tools/image/color-palette", { multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, }, }); expect(res.status()).toBe(401); }); test("compare without token returns 401", async ({ request }) => { const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "b.png", contentType: "image/png", buffer: PNG_200x150 }, ], [], ); const res = await request.post("/api/v1/tools/image/compare", { headers: { "Content-Type": contentType }, data: body, }); expect(res.status()).toBe(401); }); test("find-duplicates without token returns 401", async ({ request }) => { const { body, contentType } = buildMultipart( [ { name: "file", filename: "a.png", contentType: "image/png", buffer: PNG_200x150 }, { name: "file", filename: "b.png", contentType: "image/png", buffer: PNG_200x150 }, ], [], ); const res = await request.post("/api/v1/tools/image/find-duplicates", { headers: { "Content-Type": contentType }, data: body, }); expect(res.status()).toBe(401); }); test("barcode-read without token returns 401", async ({ request }) => { const res = await request.post("/api/v1/tools/image/barcode-read", { multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, settings: JSON.stringify({}), }, }); expect(res.status()).toBe(401); }); test("image-to-base64 without token returns 401", async ({ request }) => { const res = await request.post("/api/v1/tools/image/image-to-base64", { multipart: { file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 }, settings: JSON.stringify({}), }, }); expect(res.status()).toBe(401); }); });