/** * Integration tests for the watermark-image tool. * * Overlays one image onto another as a watermark. Uses a custom route * (not createToolRoute) with two file fields: "file" for the main image * and "watermark" for the overlay image. */ import { readFileSync } from "node:fs"; import { join } from "node:path"; 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")); const SMALL_PNG = readFileSync(join(FIXTURES, "test-1x1.png")); const JPG = readFileSync(join(FIXTURES, "test-100x100.jpg")); 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("watermark-image", () => { it("overlays a watermark image with default settings", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({}) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); const json = JSON.parse(res.body); expect(json.downloadUrl).toBeDefined(); expect(json.jobId).toBeDefined(); expect(json.processedSize).toBeGreaterThan(0); }); it("output differs from the main input", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.jpg", contentType: "image/jpeg", content: JPG }, { name: "settings", content: JSON.stringify({ scale: 50 }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); const json = JSON.parse(res.body); const dlRes = await app.inject({ method: "GET", url: json.downloadUrl, headers: { authorization: `Bearer ${adminToken}` }, }); expect(dlRes.statusCode).toBe(200); expect(Buffer.from(dlRes.rawPayload).equals(PNG)).toBe(false); }); it.each([ "center", "top-left", "top-right", "bottom-left", "bottom-right", ] as const)("supports position: %s", async (position) => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({ position }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); }); it("respects custom opacity and scale", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({ opacity: 30, scale: 10 }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); }); it("rejects request without main image", async () => { const { body, contentType } = createMultipartPayload([ { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({}) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(400); const json = JSON.parse(res.body); expect(json.error).toContain("No main image"); }); it("rejects request without watermark image", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "settings", content: JSON.stringify({}) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(400); const json = JSON.parse(res.body); expect(json.error).toContain("No watermark image"); }); it("rejects invalid settings JSON", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: "not-json" }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(400); }); it("rejects opacity out of range", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({ opacity: 150 }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(400); }); // ── Branch coverage: lines 44-48 (multipart parse error) ────────── it("returns 400 for invalid Zod settings (scale out of range)", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({ scale: 200 }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(400); const json = JSON.parse(res.body); expect(json.error).toContain("Invalid settings"); }); // ── Branch coverage: lines 164-168 (processing failure) ─────────── it("returns 422 when processing fails on corrupted main image", async () => { // A buffer that passes multipart parsing but fails Sharp processing const corruptedBuffer = Buffer.alloc(100, 0xff); const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: corruptedBuffer }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({}) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(422); const json = JSON.parse(res.body); expect(json.error).toContain("Processing failed"); }); // ── HEIC input handling ─────────────────────────────────────────── it("processes HEIC main image", async () => { const HEIC = readFileSync(join(FIXTURES, "test-200x150.heic")); const { body, contentType } = createMultipartPayload([ { name: "file", filename: "photo.heic", contentType: "image/heic", content: HEIC }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({}) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); const json = JSON.parse(res.body); expect(json.downloadUrl).toBeDefined(); expect(json.processedSize).toBeGreaterThan(0); }); // ── Full opacity watermark (opacity=100 skips opacity mask) ─────── it("applies watermark at full opacity (100)", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({ opacity: 100, scale: 25 }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); const json = JSON.parse(res.body); expect(json.downloadUrl).toBeDefined(); }); // ── Stress: large file ──────────────────────────────────────────── it("processes stress-large.jpg as main 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: "watermark", filename: "wm.jpg", contentType: "image/jpeg", content: JPG }, { name: "settings", content: JSON.stringify({ scale: 10 }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); const json = JSON.parse(res.body); expect(json.processedSize).toBeGreaterThan(0); }); // ── Tiny main image with larger watermark ─────────────────────── it("handles small main image with watermark", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.jpg", contentType: "image/jpeg", content: JPG }, { name: "settings", content: JSON.stringify({ scale: 1 }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); }); // ── No settings field (defaults applied) ────────────────────────── it("works when no settings field is provided at all", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); const json = JSON.parse(res.body); expect(json.downloadUrl).toBeDefined(); }); // ── Corrupted watermark image (processing failure) ─────────────── it("returns 422 when watermark image is corrupted", async () => { const corruptedWm = Buffer.alloc(50, 0xaa); const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: corruptedWm }, { name: "settings", content: JSON.stringify({}) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(422); const json = JSON.parse(res.body); expect(json.error).toContain("Processing failed"); }); // ── Tiny 1x1 main image ────────────────────────────────────────── it("handles 1x1 pixel main image", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "tiny.png", contentType: "image/png", content: SMALL_PNG }, { name: "watermark", filename: "wm.jpg", contentType: "image/jpeg", content: JPG }, { name: "settings", content: JSON.stringify({ scale: 50, position: "center" }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); const json = JSON.parse(res.body); expect(json.processedSize).toBeGreaterThan(0); }); // ── HEIC watermark image ───────────────────────────────────────── it("processes HEIC watermark image", async () => { const HEIC = readFileSync(join(FIXTURES, "test-200x150.heic")); const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.heic", contentType: "image/heic", content: HEIC }, { name: "settings", content: JSON.stringify({ scale: 25 }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); const json = JSON.parse(res.body); expect(json.downloadUrl).toBeDefined(); }); // ── Minimum scale (1%) ─────────────────────────────────────────── it("applies watermark at minimum scale (1%)", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.jpg", contentType: "image/jpeg", content: JPG }, { name: "settings", content: JSON.stringify({ scale: 1, opacity: 50 }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); }); // ── Maximum scale (100%) ───────────────────────────────────────── it("applies watermark at maximum scale (100%)", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.jpg", contentType: "image/jpeg", content: JPG }, { name: "settings", content: JSON.stringify({ scale: 100, opacity: 100, position: "center" }), }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); // scale=100 causes the watermark to be resized to full main-image width, // which can exceed the main image dimensions when composited. The route // returns 422 because Sharp's composite rejects overlapping bounds. expect(res.statusCode).toBe(422); }); // ── Minimum opacity (0%) ───────────────────────────────────────── it("applies watermark at zero opacity", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({ opacity: 0, scale: 25 }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); }); // ── Rejects unauthenticated request ────────────────────────────── it("rejects unauthenticated request", async () => { const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({}) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { "content-type": contentType }, body, }); expect(res.statusCode).toBe(401); }); // ── HEIF input ──────────────────────────────────────────────────── it("processes HEIF main image (motorcycle.heif)", async () => { const HEIF = readFileSync(join(FIXTURES, "content", "motorcycle.heif")); const { body, contentType } = createMultipartPayload([ { name: "file", filename: "photo.heif", contentType: "image/heif", content: HEIF }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({ scale: 10 }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); const json = JSON.parse(res.body); expect(json.downloadUrl).toBeDefined(); expect(json.processedSize).toBeGreaterThan(0); }, 60_000); // ── Animated GIF input ────────────────────────────────────────── it("processes animated GIF main image", async () => { const GIF = readFileSync(join(FIXTURES, "animated.gif")); const { body, contentType } = createMultipartPayload([ { name: "file", filename: "anim.gif", contentType: "image/gif", content: GIF }, { name: "watermark", filename: "wm.png", contentType: "image/png", content: SMALL_PNG }, { name: "settings", content: JSON.stringify({ scale: 20 }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); const json = JSON.parse(res.body); expect(json.processedSize).toBeGreaterThan(0); }); // ── WebP watermark image ───────────────────────────────────────── it("processes WebP watermark image", async () => { const WEBP = readFileSync(join(FIXTURES, "test-50x50.webp")); const { body, contentType } = createMultipartPayload([ { name: "file", filename: "main.png", contentType: "image/png", content: PNG }, { name: "watermark", filename: "wm.webp", contentType: "image/webp", content: WEBP }, { name: "settings", content: JSON.stringify({ scale: 30, position: "top-left" }) }, ]); const res = await app.inject({ method: "POST", url: "/api/v1/tools/watermark-image", headers: { authorization: `Bearer ${adminToken}`, "content-type": contentType }, body, }); expect(res.statusCode).toBe(200); const json = JSON.parse(res.body); expect(json.downloadUrl).toBeDefined(); }); });