test: expand coverage to 3,382 tests across all layers

- Unit: 1,353 tests (42 files) — +256 new tests covering AI bridge modules, image-engine sharpen/optimize-for-web, Zustand stores, and icon-map validation - Integration: 1,640 tests (57 files) — +826 new tests across all tool routes, pipeline/progress/batch infrastructure, user-files, edit-metadata, and a 321-test cross-format matrix - E2E-Docker: 389 passing (20 spec files) — 6 new spec files for batch processing, format conversion, layout, optimization, watermark/overlay, and pipeline chains. Tests verified against fresh Docker container with all 6 AI bundles installed. Bug fixes discovered during testing: - fix(compress): SVG/BMP/exotic formats crashed Sharp encoder — added format-safety fallback to PNG - fix(rate-limit): increase default login attempt limit from 10 to 500 per minute — previous value caused false test failures and is too restrictive for a self-hosted app - fix(auth.setup): wait for consent button visibility before clicking to prevent flaky E2E-Docker auth setup
2026-08-03 07:46:42 +02:00 · 2026-04-24 22:43:14 +08:00
parent bc82781282
commit 7f62bc32db
48 changed files with 13121 additions and 154 deletions
@@ -293,4 +293,353 @@ describe("Compose", () => {

    expect(res.statusCode).toBe(401);
  });
+
+  // ── Extended coverage: blend modes, edge positions, HEIC ───────────
+
+  it("uses overlay blend mode", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({ blendMode: "overlay" }) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+    const result = JSON.parse(res.body);
+    expect(result.downloadUrl).toBeDefined();
+  });
+
+  it("uses darken blend mode", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({ blendMode: "darken" }) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+  });
+
+  it("uses lighten blend mode", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({ blendMode: "lighten" }) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+  });
+
+  it("uses hard-light blend mode", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({ blendMode: "hard-light" }) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+  });
+
+  it("uses soft-light blend mode", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({ blendMode: "soft-light" }) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+  });
+
+  it("uses difference blend mode", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({ blendMode: "difference" }) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+  });
+
+  it("uses exclusion blend mode", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({ blendMode: "exclusion" }) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+  });
+
+  it("positions overlay at bottom-right edge", async () => {
+    // Overlay is 100x100, base is 200x150 -> place at (100, 50)
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({ x: 100, y: 50 }) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+    const result = JSON.parse(res.body);
+    // Output should still be base dimensions
+    const dlRes = await app.inject({
+      method: "GET",
+      url: result.downloadUrl,
+      headers: { authorization: `Bearer ${adminToken}` },
+    });
+    const meta = await sharp(dlRes.rawPayload).metadata();
+    expect(meta.width).toBe(200);
+    expect(meta.height).toBe(150);
+  });
+
+  it("applies zero opacity (completely transparent overlay)", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({ opacity: 0 }) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+  });
+
+  it("applies full opacity (default, 100%)", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({ opacity: 100 }) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+  });
+
+  it("handles HEIC base image", async () => {
+    const HEIC = readFileSync(join(FIXTURES, "test-200x150.heic"));
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.heic", contentType: "image/heic", content: HEIC },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({}) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+    const result = JSON.parse(res.body);
+    expect(result.downloadUrl).toBeDefined();
+  });
+
+  it("handles HEIC overlay image", async () => {
+    const HEIC = readFileSync(join(FIXTURES, "test-200x150.heic"));
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.heic", contentType: "image/heic", content: HEIC },
+      { name: "settings", content: JSON.stringify({}) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+    const result = JSON.parse(res.body);
+    expect(result.downloadUrl).toBeDefined();
+  });
+
+  it("uses WebP overlay on PNG base", async () => {
+    const WEBP = readFileSync(join(FIXTURES, "test-50x50.webp"));
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.webp", contentType: "image/webp", content: WEBP },
+      { name: "settings", content: JSON.stringify({ x: 10, y: 10 }) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+    const result = JSON.parse(res.body);
+    // Output should preserve base filename
+    expect(result.downloadUrl).toBeDefined();
+  });
+
+  it("preserves original filename in download URL", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "my-photo.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "watermark.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({}) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+    const result = JSON.parse(res.body);
+    expect(result.downloadUrl).toContain("my-photo.png");
+  });
+
+  it("rejects negative x position", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: JSON.stringify({ x: -10 }) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      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: "base.png", contentType: "image/png", content: PNG },
+      { name: "overlay", filename: "overlay.jpg", contentType: "image/jpeg", content: JPG },
+      { name: "settings", content: "{not valid" },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/compose",
+      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);
+  });
 });