Files
SnapOtter/tests/integration/split.test.ts
T
SnapOtter a0556772e8 test: expand coverage across all layers -- 1,268 new tests, fix replace-color div-by-zero
14-agent parallel test expansion covering integration, unit, E2E, E2E-Docker,
cross-format matrix, adversarial, GUI navigation/tools/settings/visual/a11y/perf.

- Integration: expand 23 tool test files with HEIC, stress, batch, edge cases
- Unit: close coverage gaps in image-engine, stores, lib (metadata, auto-enhance,
  connection-store, lazy-with-retry, collage/file-store HEIC preview)
- AI bridge: 141 new tests for dispatcher buffering, crash recovery, OOM/segfault
- Cross-format: 794 parameterized tests (16 formats x 12 tools + no-crash matrix)
- Adversarial: memory stress (50x large file), zero-byte, corrupted headers, unicode
- E2E-Docker: expand 8 spec files with dimension verification, pipeline chains
- GUI E2E: tool UI settings/interactions for all 47 tools, remove all test.skip,
  RBAC per-role verification, visual screenshot naming, cross-browser smoke tests,
  a11y ARIA/focus/contrast, performance budgets, 15-tool stability test
- Fix: replace-color.ts tolerance=0 caused division-by-zero producing NaN pixels

Total: 8,958 tests passing across 202 files. Zero failures, zero skips.
2026-05-09 18:02:58 +08:00

1657 lines
50 KiB
TypeScript

/**
* Integration tests for the split tool (/api/v1/tools/split).
*
* The split tool divides an image into a grid of tiles and returns a ZIP.
* It uses reply.hijack() to stream the ZIP directly, so responses are
* raw binary rather than JSON.
*/
import { readFileSync } from "node:fs";
import { join } from "node:path";
import AdmZip from "adm-zip";
import sharp from "sharp";
import { afterAll, beforeAll, describe, expect, it } from "vitest";
import { buildTestApp, createMultipartPayload, loginAsAdmin, type TestApp } from "./test-server.js";
const FIXTURES = join(__dirname, "..", "fixtures");
const PNG = readFileSync(join(FIXTURES, "test-200x150.png"));
let testApp: TestApp;
let app: TestApp["app"];
let adminToken: string;
beforeAll(async () => {
testApp = await buildTestApp();
app = testApp.app;
adminToken = await loginAsAdmin(app);
}, 30_000);
afterAll(async () => {
await testApp.cleanup();
}, 10_000);
describe("Split", () => {
it("splits a 200x150 image into a 2x2 grid", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
expect(res.headers["content-type"]).toBe("application/zip");
// Parse the ZIP and verify 4 tiles
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
// Verify tile naming convention: test_r1_c1.png, test_r1_c2.png, etc.
const names = entries.map((e) => e.entryName).sort();
expect(names).toEqual(["test_r1_c1.png", "test_r1_c2.png", "test_r2_c1.png", "test_r2_c2.png"]);
// Verify each tile has correct dimensions
// 200/2 = 100 wide, 150/2 = 75 tall
for (const entry of entries) {
const meta = await sharp(entry.getData()).metadata();
expect(meta.width).toBe(100);
expect(meta.height).toBe(75);
}
});
it("splits into a 3x3 grid with remainder tiles", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "img.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 3, rows: 3 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(9);
// Bottom-right tile gets the remainder pixels
// 200/3 = floor 66, last col: 200 - 2*66 = 68
// 150/3 = floor 50, last row: 150 - 2*50 = 50
const bottomRight = entries.find((e) => e.entryName === "img_r3_c3.png");
expect(bottomRight).toBeDefined();
const meta = await sharp(bottomRight?.getData()).metadata();
expect(meta.width).toBe(200 - 2 * 66); // 68
expect(meta.height).toBe(150 - 2 * 50); // 50
});
it("splits using fixed tile dimensions", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ tileWidth: 100, tileHeight: 75 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
// 200/100 = 2 cols, 150/75 = 2 rows = 4 tiles
expect(entries.length).toBe(4);
});
it("converts tile format to webp", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 1, outputFormat: "webp" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(2);
// Verify filenames have .webp extension
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.webp$/);
}
// Verify actual format is webp
const meta = await sharp(entries[0].getData()).metadata();
expect(meta.format).toBe("webp");
});
it("uses default settings (3x3 grid) when none provided", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{ name: "settings", content: JSON.stringify({}) },
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
// Default is 3 columns x 3 rows = 9 tiles
expect(zip.getEntries().length).toBe(9);
});
// ── Validation ──────────────────────────────────────────────────────
it("rejects requests without a file", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "settings", content: JSON.stringify({ columns: 2, rows: 2 }) },
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(400);
const result = JSON.parse(res.body);
expect(result.error).toMatch(/no image/i);
});
it("rejects columns exceeding max (100)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 101, rows: 2 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(400);
});
it("rejects unauthenticated requests", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{ name: "settings", content: JSON.stringify({ columns: 2, rows: 2 }) },
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: { "content-type": contentType },
body,
});
expect(res.statusCode).toBe(401);
});
// ── Extended coverage: grid modes, output formats, tile dimensions ──
it("splits into a 1x1 grid (single tile = full image)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 1, rows: 1 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(1);
const meta = await sharp(entries[0].getData()).metadata();
expect(meta.width).toBe(200);
expect(meta.height).toBe(150);
});
it("splits into a 4x1 grid (4 columns, 1 row)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 4, rows: 1 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
// Each tile should have full height
for (const entry of entries) {
const meta = await sharp(entry.getData()).metadata();
expect(meta.height).toBe(150);
}
});
it("splits into a 1x3 grid (1 column, 3 rows)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 1, rows: 3 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(3);
// Each tile should have full width
for (const entry of entries) {
const meta = await sharp(entry.getData()).metadata();
expect(meta.width).toBe(200);
}
});
it("converts tile format to jpeg with quality", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2, outputFormat: "jpg", quality: 70 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.jpg$/);
const meta = await sharp(entry.getData()).metadata();
expect(meta.format).toBe("jpeg");
}
});
it("converts tile format to avif", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 1, outputFormat: "avif" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(2);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.avif$/);
}
});
it("keeps original format when outputFormat is 'original'", async () => {
const JPG = readFileSync(join(FIXTURES, "test-100x100.jpg"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.jpg", contentType: "image/jpeg", content: JPG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 1, outputFormat: "original" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(2);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.jpg$/);
}
});
it("uses fixed tile dimensions that divide evenly", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ tileWidth: 50, tileHeight: 50 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
// 200/50 = 4 cols, 150/50 = 3 rows = 12 tiles
expect(entries.length).toBe(12);
for (const entry of entries) {
const meta = await sharp(entry.getData()).metadata();
expect(meta.width).toBe(50);
expect(meta.height).toBe(50);
}
});
it("uses fixed tile dimensions with remainder (non-even divide)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ tileWidth: 80, tileHeight: 80 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
// 200/80 = ceil(2.5) = 3 cols, 150/80 = ceil(1.875) = 2 rows = 6 tiles
expect(entries.length).toBe(6);
// Last column tile should have remainder width
const lastColTile = entries.find((e) => e.entryName.includes("_r1_c3"));
expect(lastColTile).toBeDefined();
const lastColMeta = await sharp(lastColTile?.getData()).metadata();
expect(lastColMeta.width).toBe(200 - 2 * 80); // 40
expect(lastColMeta.height).toBe(80);
// Last row tile should have remainder height
const lastRowTile = entries.find((e) => e.entryName.includes("_r2_c1"));
expect(lastRowTile).toBeDefined();
const lastRowMeta = await sharp(lastRowTile?.getData()).metadata();
expect(lastRowMeta.width).toBe(80);
expect(lastRowMeta.height).toBe(150 - 80); // 70
});
it("uses fixed tile dimensions with output format conversion", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({
tileWidth: 100,
tileHeight: 75,
outputFormat: "webp",
quality: 85,
}),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.webp$/);
const meta = await sharp(entry.getData()).metadata();
expect(meta.format).toBe("webp");
}
});
it("splits a JPEG input image", async () => {
const JPG = readFileSync(join(FIXTURES, "test-100x100.jpg"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "photo.jpg", contentType: "image/jpeg", content: JPG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
// Tiles should use the original extension
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.jpg$/);
}
});
it("splits a WebP input image", async () => {
const WEBP = readFileSync(join(FIXTURES, "test-50x50.webp"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "img.webp", contentType: "image/webp", content: WEBP },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.webp$/);
}
});
it("splits a HEIC input image", { timeout: 120_000 }, async () => {
const HEIC = readFileSync(join(FIXTURES, "test-200x150.heic"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "photo.heic", contentType: "image/heic", content: HEIC },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2, outputFormat: "png" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.png$/);
const meta = await sharp(entry.getData()).metadata();
expect(meta.format).toBe("png");
}
});
it("returns proper content-disposition header with job ID", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
expect(res.headers["content-type"]).toBe("application/zip");
expect(res.headers["content-disposition"]).toMatch(/^attachment; filename="split-/);
});
it("rejects rows exceeding max (100)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 101 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(400);
});
it("rejects invalid JSON in settings", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{ name: "settings", content: "not json" },
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(400);
const result = JSON.parse(res.body);
expect(result.error).toMatch(/json/i);
});
it("rejects invalid output format", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2, outputFormat: "bmp" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(400);
});
it("splits into a 4x4 grid", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 4, rows: 4 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(16);
// First tile dimensions: 200/4 = 50 wide, 150/4 = floor(37) tall
const firstTile = entries.find((e) => e.entryName === "test_r1_c1.png");
expect(firstTile).toBeDefined();
const meta = await sharp(firstTile?.getData()).metadata();
expect(meta.width).toBe(50);
expect(meta.height).toBe(37);
});
it("splits into a 5x5 grid", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 5, rows: 5 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(25);
// Each standard tile: 200/5 = 40 wide, 150/5 = 30 tall
const midTile = entries.find((e) => e.entryName === "test_r2_c2.png");
expect(midTile).toBeDefined();
const meta = await sharp(midTile?.getData()).metadata();
expect(meta.width).toBe(40);
expect(meta.height).toBe(30);
});
it("handles a 10x10 grid (many tiles)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 10, rows: 10 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(100);
});
// ── Branch coverage: HEIC with grid split (lines 59-165) ────────────
it("splits a HEIC image into a grid without format conversion", {
timeout: 120_000,
}, async () => {
const HEIC = readFileSync(join(FIXTURES, "test-200x150.heic"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "photo.heic", contentType: "image/heic", content: HEIC },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
});
// ── Branch coverage: custom tile dimensions with HEIC ───────────────
it("splits HEIC image using fixed tile dimensions", { timeout: 120_000 }, async () => {
const HEIC = readFileSync(join(FIXTURES, "test-200x150.heic"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "photo.heic", contentType: "image/heic", content: HEIC },
{
name: "settings",
content: JSON.stringify({ tileWidth: 100, tileHeight: 75, outputFormat: "jpg" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.jpg$/);
}
});
// ── Branch coverage: 1x1 pixel image split ──────────────────────────
it("splits a 1x1 pixel image into a single tile", async () => {
const TINY = readFileSync(join(FIXTURES, "test-1x1.png"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "tiny.png", contentType: "image/png", content: TINY },
{
name: "settings",
content: JSON.stringify({ columns: 1, rows: 1 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(1);
const meta = await sharp(entries[0].getData()).metadata();
expect(meta.width).toBe(1);
expect(meta.height).toBe(1);
});
// ── Branch coverage: large stress image ─────────────────────────────
it("splits a large stress image", async () => {
const LARGE = readFileSync(join(FIXTURES, "content", "stress-large.jpg"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "large.jpg", contentType: "image/jpeg", content: LARGE },
{
name: "settings",
content: JSON.stringify({ columns: 3, rows: 3, outputFormat: "jpg", quality: 80 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(9);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.jpg$/);
}
});
// ── Branch coverage: tile dimensions larger than image ──────────────
it("uses tile dimensions larger than the image (single tile)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ tileWidth: 500, tileHeight: 500 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
// 200/500 = ceil(0.4) = 1 col, 150/500 = ceil(0.3) = 1 row = 1 tile
expect(entries.length).toBe(1);
const meta = await sharp(entries[0].getData()).metadata();
expect(meta.width).toBe(200);
expect(meta.height).toBe(150);
});
// ── Branch coverage: tile dimensions with avif format conversion ────
it("splits using tile dimensions with avif output format", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({
tileWidth: 100,
tileHeight: 75,
outputFormat: "avif",
quality: 60,
}),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.avif$/);
}
});
// ── Branch coverage: file without extension ─────────────────────────
it("handles a file without an extension (uses .png default)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "noext", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
});
// ── Branch coverage: PNG format conversion ──────────────────────────
it("converts tiles to explicit png format from jpg source", async () => {
const JPG = readFileSync(join(FIXTURES, "test-100x100.jpg"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.jpg", contentType: "image/jpeg", content: JPG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2, outputFormat: "png" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.png$/);
const meta = await sharp(entry.getData()).metadata();
expect(meta.format).toBe("png");
}
});
// ── Branch coverage: split with jpg quality conversion ──────────────
it("splits PNG source to jpg tiles with custom quality setting", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 1, outputFormat: "jpg", quality: 50 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(2);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.jpg$/);
const meta = await sharp(entry.getData()).metadata();
expect(meta.format).toBe("jpeg");
}
});
// ── Branch coverage: portrait image split ───────────────────────────
it("splits a portrait image into a grid", async () => {
const PORTRAIT = readFileSync(join(FIXTURES, "test-portrait.jpg"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "portrait.jpg", contentType: "image/jpeg", content: PORTRAIT },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 3 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(6);
});
// ── Branch coverage: HEIC split with webp output ────────────────────
it("splits HEIC image with webp output format", { timeout: 120_000 }, async () => {
const HEIC = readFileSync(join(FIXTURES, "test-200x150.heic"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "photo.heic", contentType: "image/heic", content: HEIC },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2, outputFormat: "webp", quality: 75 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.webp$/);
const meta = await sharp(entry.getData()).metadata();
expect(meta.format).toBe("webp");
}
});
// ── Branch coverage: tileWidth only (no tileHeight) uses grid mode ─
it("falls back to grid columns/rows when only tileWidth is provided", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ tileWidth: 50, columns: 2, rows: 2 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
// Without tileHeight, tileWidth is ignored, falls back to columns/rows: 2x2 = 4
expect(entries.length).toBe(4);
});
// ── Branch coverage: columns 0 is clamped by Zod min(1) ────────────
it("rejects columns less than minimum (1)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 0, rows: 2 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(400);
});
// ── Branch coverage: tileHeight below min(10) ──────────────────────
it("rejects tileHeight below minimum (10)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ tileWidth: 50, tileHeight: 5 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(400);
});
// ── Branch coverage: exif-oriented image split ──────────────────────
it("splits an image with EXIF orientation data", async () => {
const EXIF = readFileSync(join(FIXTURES, "test-with-exif.jpg"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "exif.jpg", contentType: "image/jpeg", content: EXIF },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2, outputFormat: "png" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
for (const entry of entries) {
const meta = await sharp(entry.getData()).metadata();
expect(meta.format).toBe("png");
expect(meta.width).toBeGreaterThan(0);
expect(meta.height).toBeGreaterThan(0);
}
});
// ── Batch endpoint for split (exercises registerToolProcessFn) ──────
it("splits via batch endpoint with grid mode", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "batch1.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split/batch",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
expect(res.headers["content-type"]).toBe("application/zip");
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBeGreaterThan(0);
});
it("splits via batch endpoint with tileWidth and tileHeight", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "batch-tile.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ tileWidth: 100, tileHeight: 75 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split/batch",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
expect(res.headers["content-type"]).toBe("application/zip");
});
it("splits via batch endpoint with output format conversion", async () => {
const JPG = readFileSync(join(FIXTURES, "test-100x100.jpg"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "batch-fmt.jpg", contentType: "image/jpeg", content: JPG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2, outputFormat: "webp", quality: 80 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split/batch",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
});
it("splits via batch endpoint with avif output and custom quality", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "batch-avif.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 1, outputFormat: "avif", quality: 60 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split/batch",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
});
it("splits via batch endpoint with remainder tiles", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "batch-rem.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ tileWidth: 80, tileHeight: 80 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split/batch",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
});
// ── Additional edge cases ──────────────────────────────────────────
it("splits large stress image via batch endpoint", async () => {
const LARGE = readFileSync(join(FIXTURES, "content", "stress-large.jpg"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "stress.jpg", contentType: "image/jpeg", content: LARGE },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2, outputFormat: "jpg", quality: 70 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split/batch",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
});
it("splits with original format preserved via batch endpoint", async () => {
const JPG = readFileSync(join(FIXTURES, "test-100x100.jpg"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "keep.jpg", contentType: "image/jpeg", content: JPG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 1, outputFormat: "original" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split/batch",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
});
it("splits file without extension via batch endpoint", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "noext", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split/batch",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
});
// ── HEIF format input ─────────────────────────────────────────────
it("splits a HEIF input image", { timeout: 120_000 }, async () => {
const HEIF = readFileSync(join(FIXTURES, "content", "motorcycle.heif"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "photo.heif", contentType: "image/heif", content: HEIF },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2, outputFormat: "png" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
for (const entry of entries) {
expect(entry.entryName).toMatch(/\.png$/);
const meta = await sharp(entry.getData()).metadata();
expect(meta.format).toBe("png");
expect(meta.width).toBeGreaterThan(0);
expect(meta.height).toBeGreaterThan(0);
}
});
// ── Animated GIF input ────────────────────────────────────────────
it("splits an animated GIF input image", async () => {
const GIF = readFileSync(join(FIXTURES, "animated.gif"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "anim.gif", contentType: "image/gif", content: GIF },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2, outputFormat: "png" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
});
// ── SVG input ─────────────────────────────────────────────────────
it("splits an SVG input image", async () => {
const SVG = readFileSync(join(FIXTURES, "test-100x100.svg"));
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "icon.svg", contentType: "image/svg+xml", content: SVG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2, outputFormat: "png" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(200);
const zip = new AdmZip(res.rawPayload);
const entries = zip.getEntries();
expect(entries.length).toBe(4);
for (const entry of entries) {
const meta = await sharp(entry.getData()).metadata();
expect(meta.format).toBe("png");
expect(meta.width).toBeGreaterThan(0);
expect(meta.height).toBeGreaterThan(0);
}
});
// ── JXL output format ─────────────────────────────────────────────
it("accepts jxl as a valid output format in settings schema", async () => {
// JXL support depends on the Sharp build. The split route uses reply.hijack()
// which means errors after headers are sent can hang the connection. Instead
// of testing actual JXL output, we verify the settings schema accepts "jxl"
// by confirming it doesn't get rejected with 400, using the batch endpoint
// which returns JSON rather than streaming.
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 1, outputFormat: "jxl", quality: 75 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split/batch",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
// Should not be 400 (invalid settings) -- jxl is a valid enum value
expect(res.statusCode).not.toBe(400);
});
// ── Corrupt image file ────────────────────────────────────────────
it("rejects a corrupt image file", async () => {
const corruptBuffer = Buffer.from("this is not an image file at all");
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "corrupt.png", contentType: "image/png", content: corruptBuffer },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
// Split hijacks the reply, so error may come as 422 or fail to stream
expect([400, 422]).toContain(res.statusCode);
});
// ── Quality at boundary values ────────────────────────────────────
it("rejects quality below minimum (1)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ columns: 2, rows: 2, outputFormat: "jpg", quality: 0 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(400);
});
// ── tileWidth below minimum ───────────────────────────────────────
it("rejects tileWidth below minimum (10)", async () => {
const { body, contentType } = createMultipartPayload([
{ name: "file", filename: "test.png", contentType: "image/png", content: PNG },
{
name: "settings",
content: JSON.stringify({ tileWidth: 5, tileHeight: 50 }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/split",
headers: {
authorization: `Bearer ${adminToken}`,
"content-type": contentType,
},
body,
});
expect(res.statusCode).toBe(400);
});
});