@aaqu/node-red-aaqu-pdf 0.4.4 → 0.4.6

package/README.md

@@ -1,11 +1,16 @@
+## Security Disclaimer
+
+> This package processes PDF data directly within the main execution context and does not utilize sandboxing, isolated workers, or any form of execution containment.  
+Accordingly, it provides **no warranties or representations**, whether express or implied, regarding safety, security, performance, or suitability for handling untrusted, user-supplied, or potentially malicious PDF content.
+>
+> The software is provided **“as is”**, without any guarantees of reliability or protection, and **no assurance** is given that it can safely process adversarial input.  
+Use in security-sensitive environments or with sensitive data is **not recommended** unless independent validation, isolation, and appropriate hardening measures are implemented.
 ## Important Information
 
 Your support in the ongoing development of this library would be sincerely appreciated. 🙂
 
 [![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-%23FFDD00?style=for-the-badge&logo=buymeacoffee&logoColor=black)](https://buymeacoffee.com/mazuralbert)
 
-_**The library requires testing and monitoring of RAM usage.**_
-
 # @aaqu/node-red-aaqu-pdf
 
 A [Node-RED](https://nodered.org/) node for operating on a PDF document.

package/nodes/pdf-get-page.js

@@ -5,35 +5,82 @@ module.exports = function (RED) {
     RED.nodes.createNode(this, config);
 
     this.pdfPage = config.pdfPage;
-
     const node = this;
 
     node.on("input", async function (msg) {
       try {
+        node.status({ fill: "blue", shape: "dot", text: "Processing PDF..." });
+
+        // Validate payload
+        if (!msg || typeof msg !== "object") {
+          throw new Error("Incoming msg is missing or not an object.");
+        }
+
+        if (!msg.payload) {
+          throw new Error(
+            "msg.payload is required and must contain a PDF file.",
+          );
+        }
+
+        // Payload must be a Buffer, Uint8Array or ArrayBuffer
+        const validTypes =
+          Buffer.isBuffer(msg.payload) ||
+          msg.payload instanceof Uint8Array ||
+          msg.payload instanceof ArrayBuffer;
+
+        if (!validTypes) {
+          throw new Error(
+            "msg.payload must be a Buffer, Uint8Array or ArrayBuffer containing a PDF.",
+          );
+        }
+
+        // Load PDF
         const pdfDoc = await PDFDocument.load(msg.payload);
-        //const pages = pdfDoc.getPageCount();
-        // console.log(pages);
+        const totalPages = pdfDoc.getPageCount();
 
-        const newPDF = await PDFDocument.create();
+        // Determine page number
+        const rawPage = msg.pdfPage ?? node.pdfPage;
+        const pageNum = Number(rawPage);
 
-        const copiedPages = await newPDF.copyPages(pdfDoc, [node.pdfPage - 1]);
+        if (!Number.isInteger(pageNum)) {
+          throw new Error(
+            `Invalid page number: '${rawPage}'. Must be an integer.`,
+          );
+        }
+
+        if (pageNum < 1 || pageNum > totalPages) {
+          throw new Error(
+            `Page number out of range: ${pageNum}. Valid range is 1–${totalPages}.`,
+          );
+        }
+
+        const pageIndex = pageNum - 1;
+
+        // Create output PDF with selected page only
+        const newPDF = await PDFDocument.create();
+        const copiedPages = await newPDF.copyPages(pdfDoc, [pageIndex]);
         const [page] = copiedPages;
 
         newPDF.addPage(page);
         const pdfBytes = await newPDF.save();
 
+        // Return result
         msg.payload = Buffer.from(pdfBytes);
+
+        node.status({ fill: "green", shape: "dot", text: "Page extracted" });
         node.send(msg);
       } catch (err) {
-        this.status({
+        node.status({
           fill: "red",
-          shape: "ring",
-          text: "Error parsing PDF",
+          shape: "dot",
+          text: "Error extracting page",
         });
 
-        node.error(err);
+        // Log error with msg context
+        node.error(err.message || err, msg);
       }
     });
   }
+
   RED.nodes.registerType("pdf-get-page", PDFGetPageNode);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aaqu/node-red-aaqu-pdf",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "node-red pdf creator",
   "scripts": {
     "node-red": "node-red"