cyberchef 10.22.1 → 10.24.0

package/src/core/operations/AddTextToImage.mjs

@@ -9,13 +9,19 @@ import OperationError from "../errors/OperationError.mjs";
 import { isImage } from "../lib/FileType.mjs";
 import { toBase64 } from "../lib/Base64.mjs";
 import { isWorkerEnvironment } from "../Utils.mjs";
-import Jimp from "jimp/es/index.js";
+import {
+    Jimp,
+    JimpMime,
+    ResizeStrategy,
+    measureText,
+    measureTextHeight,
+    loadFont,
+} from "jimp";
 
 /**
  * Add Text To Image operation
  */
 class AddTextToImage extends Operation {
-
     /**
      * AddTextToImage constructor
      */
@@ -24,7 +30,8 @@ class AddTextToImage extends Operation {
 
         this.name = "Add Text To Image";
         this.module = "Image";
-        this.description = "Adds text onto an image.<br><br>Text can be horizontally or vertically aligned, or the position can be manually specified.<br>Variants of the Roboto font face are available in any size or colour.";
+        this.description =
+            "Adds text onto an image.<br><br>Text can be horizontally or vertically aligned, or the position can be manually specified.<br>Variants of the Roboto font face are available in any size or colour.";
         this.infoURL = "";
         this.inputType = "ArrayBuffer";
         this.outputType = "ArrayBuffer";
@@ -33,72 +40,67 @@ class AddTextToImage extends Operation {
             {
                 name: "Text",
                 type: "string",
-                value: ""
+                value: "",
             },
             {
                 name: "Horizontal align",
                 type: "option",
-                value: ["None", "Left", "Center", "Right"]
+                value: ["None", "Left", "Center", "Right"],
             },
             {
                 name: "Vertical align",
                 type: "option",
-                value: ["None", "Top", "Middle", "Bottom"]
+                value: ["None", "Top", "Middle", "Bottom"],
             },
             {
                 name: "X position",
                 type: "number",
-                value: 0
+                value: 0,
             },
             {
                 name: "Y position",
                 type: "number",
-                value: 0
+                value: 0,
             },
             {
                 name: "Size",
                 type: "number",
                 value: 32,
-                min: 8
+                min: 8,
             },
             {
                 name: "Font face",
                 type: "option",
-                value: [
-                    "Roboto",
-                    "Roboto Black",
-                    "Roboto Mono",
-                    "Roboto Slab"
-                ]
+                value: ["Roboto", "Roboto Black", "Roboto Mono", "Roboto Slab"],
             },
             {
                 name: "Red",
                 type: "number",
                 value: 255,
                 min: 0,
-                max: 255
+                max: 255,
             },
             {
                 name: "Green",
                 type: "number",
                 value: 255,
                 min: 0,
-                max: 255
+                max: 255,
             },
             {
                 name: "Blue",
                 type: "number",
                 value: 255,
                 min: 0,
-                max: 255
+                max: 255,
             },
             {
                 name: "Alpha",
                 type: "number",
                 value: 255,
                 min: 0,
-                max: 255
-            }
+                max: 255,
+            },
         ];
     }
 
@@ -131,41 +133,60 @@ class AddTextToImage extends Operation {
         } catch (err) {
             throw new OperationError(`Error loading image. (${err})`);
         }
-        try {
-            if (isWorkerEnvironment())
-                self.sendStatusMessage("Adding text to image...");
 
-            const fontsMap = {};
+        if (isWorkerEnvironment())
+            self.sendStatusMessage("Adding text to image...");
+
+        const fontsMap = {};
+        try {
             const fonts = [
-                import(/* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/Roboto72White.fnt"),
-                import(/* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/RobotoBlack72White.fnt"),
-                import(/* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/RobotoMono72White.fnt"),
-                import(/* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/RobotoSlab72White.fnt")
+                import(
+                    /* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/Roboto72White.fnt"
+                ),
+                import(
+                    /* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/RobotoBlack72White.fnt"
+                ),
+                import(
+                    /* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/RobotoMono72White.fnt"
+                ),
+                import(
+                    /* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/RobotoSlab72White.fnt"
+                ),
             ];
 
-            await Promise.all(fonts)
-                .then(fonts => {
-                    fontsMap.Roboto = fonts[0];
-                    fontsMap["Roboto Black"] = fonts[1];
-                    fontsMap["Roboto Mono"] = fonts[2];
-                    fontsMap["Roboto Slab"] = fonts[3];
-                });
-
-
+            await Promise.all(fonts).then((fonts) => {
+                fontsMap.Roboto = fonts[0];
+                fontsMap["Roboto Black"] = fonts[1];
+                fontsMap["Roboto Mono"] = fonts[2];
+                fontsMap["Roboto Slab"] = fonts[3];
+            });
             // Make Webpack load the png font images
             await Promise.all([
-                import(/* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/Roboto72White.png"),
-                import(/* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/RobotoSlab72White.png"),
-                import(/* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/RobotoMono72White.png"),
-                import(/* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/RobotoBlack72White.png")
+                import(
+                    /* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/Roboto72White.png"
+                ),
+                import(
+                    /* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/RobotoSlab72White.png"
+                ),
+                import(
+                    /* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/RobotoMono72White.png"
+                ),
+                import(
+                    /* webpackMode: "eager" */ "../../web/static/fonts/bmfonts/RobotoBlack72White.png"
+                ),
             ]);
+        } catch (err) {
+            throw new OperationError(`Error preparing fonts. (${err})`);
+        }
 
+        let jimpFont;
+        try {
             const font = fontsMap[fontFace];
 
             // LoadFont needs an absolute url, so append the font name to self.docURL
-            const jimpFont = await Jimp.loadFont(self.docURL + "/" + font.default);
+            jimpFont = await loadFont(self.docURL + "/" + font.default);
 
-            jimpFont.pages.forEach(function(page) {
+            jimpFont.pages.forEach(function (page) {
                 if (page.bitmap) {
                     // Adjust the RGB values of the image pages to change the font colour.
                     const pageWidth = page.bitmap.width;
@@ -175,32 +196,56 @@ class AddTextToImage extends Operation {
                             const idx = (iy * pageWidth + ix) << 2;
 
                             const newRed = page.bitmap.data[idx] - (255 - red);
-                            const newGreen = page.bitmap.data[idx + 1] - (255 - green);
-                            const newBlue = page.bitmap.data[idx + 2] - (255 - blue);
-                            const newAlpha = page.bitmap.data[idx + 3] - (255 - alpha);
+                            const newGreen =
+                                page.bitmap.data[idx + 1] - (255 - green);
+                            const newBlue =
+                                page.bitmap.data[idx + 2] - (255 - blue);
+                            const newAlpha =
+                                page.bitmap.data[idx + 3] - (255 - alpha);
 
                             // Make sure the bitmap values don't go below 0 as that makes jimp very unhappy
-                            page.bitmap.data[idx] = (newRed > 0) ? newRed : 0;
-                            page.bitmap.data[idx + 1] = (newGreen > 0) ? newGreen : 0;
-                            page.bitmap.data[idx + 2] = (newBlue > 0) ? newBlue : 0;
-                            page.bitmap.data[idx + 3] = (newAlpha > 0) ? newAlpha : 0;
+                            page.bitmap.data[idx] = newRed > 0 ? newRed : 0;
+                            page.bitmap.data[idx + 1] =
+                                newGreen > 0 ? newGreen : 0;
+                            page.bitmap.data[idx + 2] =
+                                newBlue > 0 ? newBlue : 0;
+                            page.bitmap.data[idx + 3] =
+                                newAlpha > 0 ? newAlpha : 0;
                         }
                     }
                 }
             });
+        } catch (err) {
+            throw new OperationError(`Error loading font. (${err})`);
+        }
 
+        try {
             // Create a temporary image to hold the rendered text
-            const textImage = new Jimp(Jimp.measureText(jimpFont, text), Jimp.measureTextHeight(jimpFont, text));
-            textImage.print(jimpFont, 0, 0, text);
+            const textImage = new Jimp({
+                width: measureText(jimpFont, text),
+                height: measureTextHeight(jimpFont, text),
+            });
+            textImage.print({
+                font: jimpFont,
+                x: 0,
+                y: 0,
+                text,
+            });
 
             // Scale the rendered text image to the correct size
             const scaleFactor = size / 72;
             if (size !== 1) {
                 // Use bicubic for decreasing size
                 if (size > 1) {
-                    textImage.scale(scaleFactor, Jimp.RESIZE_BICUBIC);
+                    textImage.scale({
+                        f: scaleFactor,
+                        mode: ResizeStrategy.BICUBIC,
+                    });
                 } else {
-                    textImage.scale(scaleFactor, Jimp.RESIZE_BILINEAR);
+                    textImage.scale({
+                        f: scaleFactor,
+                        mode: ResizeStrategy.BILINEAR,
+                    });
                 }
             }
 
@@ -210,10 +255,10 @@ class AddTextToImage extends Operation {
                     xPos = 0;
                     break;
                 case "Center":
-                    xPos = (image.getWidth() / 2) - (textImage.getWidth() / 2);
+                    xPos = image.width / 2 - textImage.width / 2;
                     break;
                 case "Right":
-                    xPos = image.getWidth() - textImage.getWidth();
+                    xPos = image.width - textImage.width;
                     break;
             }
 
@@ -222,25 +267,33 @@ class AddTextToImage extends Operation {
                     yPos = 0;
                     break;
                 case "Middle":
-                    yPos = (image.getHeight() / 2) - (textImage.getHeight() / 2);
+                    yPos = image.height / 2 - textImage.height / 2;
                     break;
                 case "Bottom":
-                    yPos = image.getHeight() - textImage.getHeight();
+                    yPos = image.height - textImage.height;
                     break;
             }
 
             // Blit the rendered text image onto the original source image
-            image.blit(textImage, xPos, yPos);
+            image.blit({
+                src: textImage,
+                x: xPos,
+                y: yPos,
+            });
+        } catch (err) {
+            throw new OperationError(`Error adding text to image. (${err})`);
+        }
 
+        try {
             let imageBuffer;
-            if (image.getMIME() === "image/gif") {
-                imageBuffer = await image.getBufferAsync(Jimp.MIME_PNG);
+            if (image.mime === "image/gif") {
+                imageBuffer = await image.getBuffer(JimpMime.png);
             } else {
-                imageBuffer = await image.getBufferAsync(Jimp.AUTO);
+                imageBuffer = await image.getBuffer(image.mime);
             }
             return imageBuffer.buffer;
         } catch (err) {
-            throw new OperationError(`Error adding text to image. (${err})`);
+            throw new OperationError(`Error exporting image. (${err})`);
         }
     }
 
@@ -261,7 +314,6 @@ class AddTextToImage extends Operation {
 
         return `<img src="data:${type};base64,${toBase64(dataArray)}">`;
     }
-
 }
 
 export default AddTextToImage;

package/src/core/operations/AnalyseUUID.mjs

@@ -1,5 +1,6 @@
 /**
  * @author n1474335 [n1474335@gmail.com]
+ * @author ko80240 [csk.dev@proton.me]
  * @copyright Crown Copyright 2023
  * @license Apache-2.0
  */
@@ -8,6 +9,7 @@ import * as uuid from "uuid";
 
 import Operation from "../Operation.mjs";
 import OperationError from "../errors/OperationError.mjs";
+import { toHex } from "../lib/Hex.mjs";
 
 /**
  * Analyse UUID operation
@@ -22,27 +24,128 @@ class AnalyseUUID extends Operation {
 
         this.name = "Analyse UUID";
         this.module = "Crypto";
-        this.description = "Tries to determine information about a given UUID and suggests which version may have been used to generate it";
+        this.description = "Operation for extracting metadata and detecting the version of a given UUID.";
         this.infoURL = "https://wikipedia.org/wiki/Universally_unique_identifier";
         this.inputType = "string";
         this.outputType = "string";
-        this.args = [];
+        this.args = [
+            {
+                name: "Include Metadata",
+                type: "boolean",
+                value: true
+            }
+        ];
     }
 
     /**
-     * @param {string} input
+     * @param {string} input - Expects a valid UUID string
      * @param {Object[]} args
      * @returns {string}
      */
     run(input, args) {
+        input = input.trim();
+
+        let uuidVersion, uuidBytes;
         try {
-            const uuidVersion = uuid.version(input);
-            return "UUID version: " + uuidVersion;
+            uuidVersion = uuid.version(input); // Re-using the uuid library to extract version
+            uuidBytes = uuid.parse(input);     // Re-using the uuid library to parse bytes
         } catch (error) {
             throw new OperationError("Invalid UUID");
         }
-    }
 
+        const [includeMetadata] = args;
+        const dv = new DataView(uuidBytes.buffer, uuidBytes.byteOffset, uuidBytes.byteLength); // Dataview helps handle the multi-byte ints
+        const uuidInteger = (dv.getBigUint64(0) << 64n) | dv.getBigUint64(8);
+
+        const sections = [`Version:\n${uuidVersion}`];
+
+        if (includeMetadata) {
+            const parser = UUID_PARSERS[uuidVersion];
+            const decoded = parser?.(uuidBytes, dv);
+            sections.push(formatDecoded(decoded));
+        }
+
+        sections.push(`UUID Integer:\n${uuidInteger}`);
+
+        return sections.filter(Boolean).join("\n\n");
+    }
 }
 
 export default AnalyseUUID;
+
+/**
+ * Metadata can be extracted for versions 1, 6, and 7.
+ * Enum-like frozen mapping of UUID version to parser function.
+ */
+const UUID_PARSERS = Object.freeze({
+    1: parsev1v6,
+    6: parsev1v6,
+    7: parsev7,
+});
+
+/**
+ * Versions 1 and 6. Note 6 is a re-order of 1.
+ * Version 1 == layout: timeLow(32) | timeMid(16) | timeHi(12)
+ * Version 6 == layout: timeHi(32)  | timeMid(16) | timeLow(12)
+ */
+function parsev1v6(uuidBytes, dv) {
+    const isV1 = (uuidBytes[6] >> 4) === 1;
+
+    const timeStamp =
+        isV1 ? (
+            (BigInt(dv.getUint16(6) & 0x0fff) << 48n) | // mask off version bits
+            (BigInt(dv.getUint16(4)) << 32n) |
+            BigInt(dv.getUint32(0))
+        ) : (
+            (BigInt(dv.getUint32(0)) << 28n) |
+            (BigInt(dv.getUint16(4)) << 12n) |
+            (BigInt(dv.getUint16(6) & 0x0fff))
+        );
+
+    // Convert to Unix time
+    const milliseconds =
+        Number(
+            (timeStamp - 122192928000000000n) / 10000n
+        );
+
+    return {
+        timestamp: milliseconds,
+        isoTimestamp: new Date(milliseconds).toISOString(),
+        clock: ((uuidBytes[8] & 0x3f) << 8) | uuidBytes[9],
+        node: toHex(uuidBytes.slice(10), ":").toUpperCase()
+    };
+}
+
+/** Version 7 */
+function parsev7(uuidBytes, dv) {
+    const milliseconds = Number((BigInt(dv.getUint32(0)) << 16n) | BigInt(dv.getUint16(4)));
+
+    return {
+        timestamp: milliseconds,
+        isoTimestamp: new Date(milliseconds).toISOString(),
+        randA: ((uuidBytes[6] & 0x0f) << 8) | uuidBytes[7],
+        randB: toHex(uuidBytes.slice(8), "").toUpperCase()
+    };
+}
+
+/**
+ * Formats metadata
+ *
+ * @param {Object|undefined} decoded
+ * @returns {string}
+ */
+function formatDecoded(decoded) {
+    if (!decoded) return "No metadata available. Only versions 1, 6, 7 are supported.";
+
+    return Object.entries({
+        "Timestamp": decoded.timestamp,
+        "Timestamp (ISO)": decoded.isoTimestamp,
+        "Node": decoded.node,
+        "Clock": decoded.clock,
+        "Rand A": decoded.randA,
+        "Rand B": decoded.randB
+    })
+        .filter(([, value]) => value !== undefined)
+        .map(([label, value]) => `${label}:\n${value}`)
+        .join("\n\n");
+}

package/src/core/operations/BlurImage.mjs

@@ -9,14 +9,12 @@ import OperationError from "../errors/OperationError.mjs";
 import { isWorkerEnvironment } from "../Utils.mjs";
 import { isImage } from "../lib/FileType.mjs";
 import { toBase64 } from "../lib/Base64.mjs";
-import { gaussianBlur } from "../lib/ImageManipulation.mjs";
-import Jimp from "jimp/es/index.js";
+import { Jimp, JimpMime } from "jimp";
 
 /**
  * Blur Image operation
  */
 class BlurImage extends Operation {
-
     /**
      * BlurImage constructor
      */
@@ -25,7 +23,8 @@ class BlurImage extends Operation {
 
         this.name = "Blur Image";
         this.module = "Image";
-        this.description = "Applies a blur effect to the image.<br><br>Gaussian blur is much slower than fast blur, but produces better results.";
+        this.description =
+            "Applies a blur effect to the image.<br><br>Gaussian blur is much slower than fast blur, but produces better results.";
         this.infoURL = "https://wikipedia.org/wiki/Gaussian_blur";
         this.inputType = "ArrayBuffer";
         this.outputType = "ArrayBuffer";
@@ -35,13 +34,13 @@ class BlurImage extends Operation {
                 name: "Amount",
                 type: "number",
                 value: 5,
-                min: 1
+                min: 1,
             },
             {
                 name: "Type",
                 type: "option",
-                value: ["Fast", "Gaussian"]
-            }
+                value: ["Fast", "Gaussian"],
+            },
         ];
     }
 
@@ -73,15 +72,15 @@ class BlurImage extends Operation {
                 case "Gaussian":
                     if (isWorkerEnvironment())
                         self.sendStatusMessage("Gaussian blurring image...");
-                    image = gaussianBlur(image, blurAmount);
+                    image.gaussian(blurAmount);
                     break;
             }
 
             let imageBuffer;
-            if (image.getMIME() === "image/gif") {
-                imageBuffer = await image.getBufferAsync(Jimp.MIME_PNG);
+            if (image.mime === "image/gif") {
+                imageBuffer = await image.getBuffer(JimpMime.png);
             } else {
-                imageBuffer = await image.getBufferAsync(Jimp.AUTO);
+                imageBuffer = await image.getBuffer(image.mime);
             }
             return imageBuffer.buffer;
         } catch (err) {
@@ -106,7 +105,6 @@ class BlurImage extends Operation {
 
         return `<img src="data:${type};base64,${toBase64(dataArray)}">`;
     }
-
 }
 
 export default BlurImage;