feat(tools): 2.0 phase 5 wave 5a - image gap-fill (11 tools) (#225)

2026-08-03 07:46:42 +02:00 · 2026-06-13 10:19:16 +08:00
parent fc7c1f850e
commit 6e1b9865f1
79 changed files with 7992 additions and 728 deletions
@@ -0,0 +1,116 @@
+/**
+ * Integration tests for the gif-webp tool (/api/v1/tools/gif-webp).
+ *
+ * Covers GIF-to-WebP, WebP-to-GIF conversions with animation preservation,
+ * and extension validation.
+ */
+
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+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 ANIMATED_GIF = readFileSync(join(FIXTURES, "animated.gif"));
+const ANIMATED_WEBP = readFileSync(join(FIXTURES, "animated.webp"));
+const STILL_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("GIF/WebP Converter", () => {
+  it("converts animated GIF to WebP with multiple pages", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "anim.gif", contentType: "image/gif", content: ANIMATED_GIF },
+      { name: "settings", content: JSON.stringify({}) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/gif-webp",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+    const result = JSON.parse(res.body);
+    expect(result.downloadUrl).toBeDefined();
+
+    // Download and verify animated WebP (pages > 1)
+    const dlRes = await app.inject({
+      method: "GET",
+      url: result.downloadUrl,
+      headers: { authorization: `Bearer ${adminToken}` },
+    });
+    const meta = await sharp(dlRes.rawPayload, { animated: true }).metadata();
+    expect(meta.pages).toBeGreaterThan(1);
+  });
+
+  it("converts animated WebP to GIF with multiple pages", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "anim.webp", contentType: "image/webp", content: ANIMATED_WEBP },
+      { name: "settings", content: JSON.stringify({}) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/gif-webp",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBe(200);
+    const result = JSON.parse(res.body);
+    expect(result.downloadUrl).toBeDefined();
+
+    // Download and verify animated GIF (pages > 1)
+    const dlRes = await app.inject({
+      method: "GET",
+      url: result.downloadUrl,
+      headers: { authorization: `Bearer ${adminToken}` },
+    });
+    const meta = await sharp(dlRes.rawPayload, { animated: true }).metadata();
+    expect(meta.pages).toBeGreaterThan(1);
+  });
+
+  it("rejects PNG input with extension guard", async () => {
+    const { body, contentType } = createMultipartPayload([
+      { name: "file", filename: "test.png", contentType: "image/png", content: STILL_PNG },
+      { name: "settings", content: JSON.stringify({}) },
+    ]);
+
+    const res = await app.inject({
+      method: "POST",
+      url: "/api/v1/tools/gif-webp",
+      headers: {
+        authorization: `Bearer ${adminToken}`,
+        "content-type": contentType,
+      },
+      body,
+    });
+
+    expect(res.statusCode).toBeGreaterThanOrEqual(400);
+    expect(res.statusCode).toBeLessThan(500);
+    const result = JSON.parse(res.body);
+    const msg = [result.error, result.details].join(" ");
+    expect(msg).toMatch(/only gif and webp/i);
+  });
+});