feat: add format tools (SVG-to-raster, vectorize, GIF) and optimization (rename, favicon, image-to-PDF)

Add 6 tools for format conversion and optimization extras: - svg-to-raster: SVG to PNG/JPG/WebP at custom resolution - vectorize: raster to SVG via potrace (B&W and color modes) - gif-tools: animated GIF resize, frame extraction, optimization - bulk-rename: pattern-based file renaming with ZIP output - favicon: generate all favicon/app icon sizes with manifest.json - image-to-pdf: combine images into PDF using pdfkit
2026-08-03 07:46:42 +02:00 · 2026-03-22 04:20:54 +08:00
parent b8aba1719c
commit b88d0d0af8
12 changed files with 1374 additions and 0 deletions
@@ -0,0 +1,123 @@
+import { z } from "zod";
+import sharp from "sharp";
+import type { FastifyInstance } from "fastify";
+import { randomUUID } from "node:crypto";
+import { writeFile } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { createWorkspace } from "../../lib/workspace.js";
+
+const settingsSchema = z.object({
+  width: z.number().min(1).max(8192).default(1024),
+  height: z.number().min(1).max(8192).optional(),
+  backgroundColor: z.string().regex(/^#[0-9a-fA-F]{6,8}$/).default("#00000000"),
+  outputFormat: z.enum(["png", "jpg", "webp"]).default("png"),
+});
+
+/**
+ * SVG to raster conversion.
+ * Custom route since input is SVG (not validated as image by magic bytes).
+ */
+export function registerSvgToRaster(app: FastifyInstance) {
+  app.post(
+    "/api/v1/tools/svg-to-raster",
+    async (request, reply) => {
+      let fileBuffer: Buffer | null = null;
+      let filename = "output";
+      let settingsRaw: string | null = null;
+
+      try {
+        const parts = request.parts();
+        for await (const part of parts) {
+          if (part.type === "file") {
+            const chunks: Buffer[] = [];
+            for await (const chunk of part.file) {
+              chunks.push(chunk);
+            }
+            fileBuffer = Buffer.concat(chunks);
+            filename = basename(part.filename ?? "output").replace(/\.svg$/i, "");
+          } else if (part.fieldname === "settings") {
+            settingsRaw = part.value as string;
+          }
+        }
+      } catch (err) {
+        return reply.status(400).send({
+          error: "Failed to parse multipart request",
+          details: err instanceof Error ? err.message : String(err),
+        });
+      }
+
+      if (!fileBuffer || fileBuffer.length === 0) {
+        return reply.status(400).send({ error: "No SVG file provided" });
+      }
+
+      let settings: z.infer<typeof settingsSchema>;
+      try {
+        const parsed = settingsRaw ? JSON.parse(settingsRaw) : {};
+        const result = settingsSchema.safeParse(parsed);
+        if (!result.success) {
+          return reply.status(400).send({ error: "Invalid settings", details: result.error.issues });
+        }
+        settings = result.data;
+      } catch {
+        return reply.status(400).send({ error: "Settings must be valid JSON" });
+      }
+
+      try {
+        let image = sharp(fileBuffer, { density: 300 }).resize(
+          settings.width,
+          settings.height ?? undefined,
+          { fit: "inside" },
+        );
+
+        // Apply background if not transparent
+        if (settings.backgroundColor !== "#00000000") {
+          const bgR = parseInt(settings.backgroundColor.slice(1, 3), 16);
+          const bgG = parseInt(settings.backgroundColor.slice(3, 5), 16);
+          const bgB = parseInt(settings.backgroundColor.slice(5, 7), 16);
+          image = image.flatten({ background: { r: bgR, g: bgG, b: bgB } });
+        }
+
+        let buffer: Buffer;
+        let ext: string;
+        let contentType: string;
+
+        switch (settings.outputFormat) {
+          case "jpg":
+            buffer = await image.jpeg({ quality: 90 }).toBuffer();
+            ext = "jpg";
+            contentType = "image/jpeg";
+            break;
+          case "webp":
+            buffer = await image.webp({ quality: 90 }).toBuffer();
+            ext = "webp";
+            contentType = "image/webp";
+            break;
+          case "png":
+          default:
+            buffer = await image.png().toBuffer();
+            ext = "png";
+            contentType = "image/png";
+            break;
+        }
+
+        const outFilename = `${filename}.${ext}`;
+        const jobId = randomUUID();
+        const workspacePath = await createWorkspace(jobId);
+        const outputPath = join(workspacePath, "output", outFilename);
+        await writeFile(outputPath, buffer);
+
+        return reply.send({
+          jobId,
+          downloadUrl: `/api/v1/download/${jobId}/${encodeURIComponent(outFilename)}`,
+          originalSize: fileBuffer.length,
+          processedSize: buffer.length,
+        });
+      } catch (err) {
+        return reply.status(422).send({
+          error: "SVG conversion failed",
+          details: err instanceof Error ? err.message : "Unknown error",
+        });
+      }
+    },
+  );
+}