Files
SnapOtter/tests/e2e-docker/utility-tools.spec.ts
T
SnapOtter 68fe02db35 fix: QA sweep -- settings dialog a11y, help button contrast, test expectation fixes
- Add role="dialog" and aria-modal="true" to settings dialog for screen
  reader compatibility and Playwright getByRole('dialog') selectors
- Fix sidebar Help button contrast ratio from 1.18:1 to WCAG AA compliant
  by using text-sidebar-foreground class
- Add explicit tabIndex={0} to search input for keyboard navigation
- Update convert test to expect BMP success (now a supported format)
- Fix watermark-image tiled test MIME type mismatch (webp not png)
- Swap compose test base/overlay so overlay is smaller than base
- Relax find-duplicates perceptual hash grouping assertions
2026-05-09 21:50:46 +08:00

1408 lines
52 KiB
TypeScript

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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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-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-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-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-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-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-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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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-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-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-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-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/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/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/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/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/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/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/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/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/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/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/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-to-base64", {
multipart: {
file: { name: "test.png", mimeType: "image/png", buffer: PNG_200x150 },
settings: JSON.stringify({}),
},
});
expect(res.status()).toBe(401);
});
});