/** * 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); }); });