@juspay/neurolink 12.22.1 → 12.23.1

package/dist/utils/imageDetection.d.ts

@@ -7,6 +7,16 @@
  * otherwise a wrong default (historically `image/jpeg`) makes Anthropic reject
  * PNG/GIF/WebP with a media-type mismatch 400.
  */
+/**
+ * Detect an image's MIME type from its magic bytes, or `null` when the bytes
+ * match no known signature.
+ *
+ * Use this when the answer "not an image" has to be distinguishable from a
+ * default. `detectImageMimeType` collapses that distinction on purpose, which
+ * is right for a caller that already knows it holds an image and wrong for one
+ * deciding whether it does.
+ */
+export declare function sniffImageMimeType(buffer: Buffer): string | null;
 /**
  * Detect an image's MIME type from its magic bytes. Returns `image/png` for
  * buffers that match no known signature (the safest neutral default for the

package/dist/utils/imageDetection.js

@@ -8,17 +8,27 @@
  * PNG/GIF/WebP with a media-type mismatch 400.
  */
 /**
- * Detect an image's MIME type from its magic bytes. Returns `image/png` for
- * buffers that match no known signature (the safest neutral default for the
- * Vertex image path).
+ * Detect an image's MIME type from its magic bytes, or `null` when the bytes
+ * match no known signature.
+ *
+ * Use this when the answer "not an image" has to be distinguishable from a
+ * default. `detectImageMimeType` collapses that distinction on purpose, which
+ * is right for a caller that already knows it holds an image and wrong for one
+ * deciding whether it does.
  */
-export function detectImageMimeType(buffer) {
-    // PNG: 89 50 4E 47
+export function sniffImageMimeType(buffer) {
+    // PNG: the full 8-byte signature 89 50 4E 47 0D 0A 1A 0A. The trailing four
+    // bytes matter — a truncated `iVBORw==` carries only the first four and is
+    // not a decodable image.
     if (buffer.length >= 8 &&
         buffer[0] === 0x89 &&
         buffer[1] === 0x50 &&
         buffer[2] === 0x4e &&
-        buffer[3] === 0x47) {
+        buffer[3] === 0x47 &&
+        buffer[4] === 0x0d &&
+        buffer[5] === 0x0a &&
+        buffer[6] === 0x1a &&
+        buffer[7] === 0x0a) {
         return "image/png";
     }
     // JPEG: FF D8 FF
@@ -40,13 +50,29 @@ export function detectImageMimeType(buffer) {
         buffer[11] === 0x50) {
         return "image/webp";
     }
-    // GIF: "GIF"
+    // GIF: the full 6-byte header "GIF87a" or "GIF89a". The version stamp is
+    // what separates a header from three coincidental letters — the old check
+    // compared only "GIF" while guarding on `length >= 6`, so any six bytes
+    // beginning with those letters (base64 `R0lGAAAA` decodes to 47 49 46 00
+    // 00 00) were labelled image/gif. This gate is what decides whether bytes
+    // are an image at all, so it is only as strict as its weakest signature.
     if (buffer.length >= 6 &&
-        buffer[0] === 0x47 &&
-        buffer[1] === 0x49 &&
-        buffer[2] === 0x46) {
+        buffer[0] === 0x47 && // G
+        buffer[1] === 0x49 && // I
+        buffer[2] === 0x46 && // F
+        buffer[3] === 0x38 && // 8
+        (buffer[4] === 0x37 || buffer[4] === 0x39) && // 7 | 9
+        buffer[5] === 0x61 // a
+    ) {
         return "image/gif";
     }
-    // Unknown — neutral default.
-    return "image/png";
+    return null;
+}
+/**
+ * Detect an image's MIME type from its magic bytes. Returns `image/png` for
+ * buffers that match no known signature (the safest neutral default for the
+ * Vertex image path).
+ */
+export function detectImageMimeType(buffer) {
+    return sniffImageMimeType(buffer) ?? "image/png";
 }