feat: add utility tools (image info, compare, duplicates, color palette, QR, barcode)

Add 6 utility tools with API routes and frontend settings: - info: read-only image metadata inspector with channel histogram - compare: side-by-side pixel diff with similarity percentage - find-duplicates: dHash perceptual hashing for duplicate detection - color-palette: frequency-based dominant color extraction - qr-generate: QR code generator from text/URL (custom JSON route) - barcode-read: QR code reader using jsQR
2026-08-03 07:46:42 +02:00 · 2026-03-22 04:20:35 +08:00
parent aeaf783ee4
commit 0c3c64eeac
12 changed files with 1253 additions and 0 deletions
@@ -0,0 +1,85 @@
+import sharp from "sharp";
+import jsQR from "jsqr";
+import type { FastifyInstance, FastifyRequest, FastifyReply } from "fastify";
+import { basename } from "node:path";
+
+/**
+ * Read QR codes and barcodes from uploaded images.
+ */
+export function registerBarcodeRead(app: FastifyInstance) {
+  app.post(
+    "/api/v1/tools/barcode-read",
+    async (request: FastifyRequest, reply: FastifyReply) => {
+      let fileBuffer: Buffer | null = null;
+      let filename = "image";
+
+      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 ?? "image");
+          }
+        }
+      } 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 image file provided" });
+      }
+
+      try {
+        // Convert to RGBA raw pixel data for jsQR
+        const image = sharp(fileBuffer);
+        const metadata = await image.metadata();
+        const width = metadata.width ?? 0;
+        const height = metadata.height ?? 0;
+
+        const rawData = await image
+          .ensureAlpha()
+          .raw()
+          .toBuffer();
+
+        const code = jsQR(
+          new Uint8ClampedArray(rawData.buffer, rawData.byteOffset, rawData.length),
+          width,
+          height,
+        );
+
+        if (!code) {
+          return reply.send({
+            filename,
+            found: false,
+            text: null,
+            message: "No QR code found in the image",
+          });
+        }
+
+        return reply.send({
+          filename,
+          found: true,
+          text: code.data,
+          location: {
+            topLeft: code.location.topLeftCorner,
+            topRight: code.location.topRightCorner,
+            bottomLeft: code.location.bottomLeftCorner,
+            bottomRight: code.location.bottomRightCorner,
+          },
+        });
+      } catch (err) {
+        return reply.status(422).send({
+          error: "Barcode reading failed",
+          details: err instanceof Error ? err.message : "Unknown error",
+        });
+      }
+    },
+  );
+}