@processlink/node-red-contrib-processlink 1.2.0 → 1.2.2

package/.claude/settings.local.json

@@ -4,7 +4,10 @@
       "Bash(git add:*)",
       "Bash(git commit -m \"$\\(cat <<''EOF''\nAdd folder/area support to upload API\n\n- Add areaId and folderId params to /api/upload endpoint\n- Add API key auth to /api/sites/[siteId]/folders endpoint\n- Add new /api/sites/[siteId]/areas endpoint with API key auth\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
       "Bash(git commit -m \"$\\(cat <<''EOF''\nAdd location selector for file uploads \\(v1.2.0\\)\n\n- Add Location dropdown showing Area > Folder hierarchy\n- Fetch areas and folders from Files API with API key auth\n- Send areaId and folderId in upload requests\n- Update README documentation\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
-      "Bash(npm publish:*)"
+      "Bash(npm publish:*)",
+      "WebFetch(domain:files.processlink.com.au)",
+      "Bash(git commit:*)",
+      "Bash(npm view:*)"
     ]
   }
 }

package/CLAUDE.md

@@ -0,0 +1,63 @@
+# CLAUDE.md - AI Assistant Guidelines
+
+## Critical: This is a Published NPM Package
+
+This package (`@processlink/node-red-contrib-processlink`) is **published to NPM** and used by real customers in production Node-RED environments. Changes here can break many people's workflows.
+
+### Before Making Any Changes
+
+1. **Understand the impact** - Changes affect all users who update the package
+2. **Backwards compatibility** - Existing node configurations must continue to work
+3. **Test thoroughly** - Test in a real Node-RED instance before publishing
+4. **Version carefully** - Follow semver (patch for fixes, minor for features, major for breaking changes)
+
+### Publishing Checklist
+
+Before running `npm publish`:
+- [ ] Test all nodes in Node-RED editor (deploy, configure, run)
+- [ ] Verify existing flows still work after update
+- [ ] Check browser console for JavaScript errors
+- [ ] Test error handling paths
+- [ ] Update version in package.json appropriately
+- [ ] Document changes in commit message
+
+## Architecture Notes
+
+### Node-RED Security Model
+
+**Important**: Credentials (API keys, passwords) are stored server-side only and are NEVER accessible from the browser/editor HTML code.
+
+- `node.credentials.apiKey` - Only accessible in `.js` files (server-side)
+- `configNode.credentials` - Always `undefined` in `.html` files (client-side)
+
+To access credentials from the editor, create an admin HTTP endpoint:
+```javascript
+// In the .js file
+RED.httpAdmin.get("/your-endpoint/:id", function(req, res) {
+  const node = RED.nodes.getNode(req.params.id);
+  const apiKey = node.credentials?.apiKey; // Access credentials here
+  // Make API calls server-side, return results to client
+});
+```
+
+### File Structure
+
+```
+nodes/
+  config/
+    processlink-config.js    # Shared credentials config node
+    processlink-config.html
+  files/
+    processlink-files-upload.js   # File upload node
+    processlink-files-upload.html
+  system/
+    processlink-system-info.js    # System info node
+    processlink-system-info.html
+```
+
+### Node-RED Conventions
+
+- Dual outputs: First output for success, second for errors
+- Status indicators: green=success, yellow=processing, red=error
+- Config nodes: Store shared credentials, referenced by other nodes
+- Always use `send` and `done` callbacks for proper async handling

package/nodes/config/processlink-config.js

@@ -4,6 +4,8 @@
  */
 
 module.exports = function (RED) {
+  const https = require("https");
+
   function ProcessLinkConfigNode(config) {
     RED.nodes.createNode(this, config);
     this.name = config.name;
@@ -16,4 +18,95 @@ module.exports = function (RED) {
       apiKey: { type: "password" },
     },
   });
+
+  // Admin endpoint to fetch locations (areas and folders) for a config node
+  RED.httpAdmin.get("/processlink/locations/:id", function (req, res) {
+    const configNode = RED.nodes.getNode(req.params.id);
+    if (!configNode) {
+      return res.status(404).json({ error: "Config node not found" });
+    }
+
+    const siteId = configNode.siteId;
+    const apiKey = configNode.credentials?.apiKey;
+
+    if (!siteId || !apiKey) {
+      return res.status(400).json({ error: "Config not ready" });
+    }
+
+    const baseUrl = `/api/sites/${siteId}`;
+    const headers = {
+      Authorization: `Bearer ${apiKey}`,
+    };
+
+    // Fetch both areas and folders
+    let areasData = [];
+    let foldersData = [];
+    let completed = 0;
+    let hasError = false;
+
+    function checkComplete() {
+      completed++;
+      if (completed === 2 && !hasError) {
+        res.json({ areas: areasData, folders: foldersData });
+      }
+    }
+
+    // Fetch areas
+    const areasReq = https.request(
+      {
+        hostname: "files.processlink.com.au",
+        path: `${baseUrl}/areas`,
+        method: "GET",
+        headers: headers,
+      },
+      (areasRes) => {
+        let data = "";
+        areasRes.on("data", (chunk) => (data += chunk));
+        areasRes.on("end", () => {
+          try {
+            areasData = JSON.parse(data);
+          } catch (e) {
+            areasData = [];
+          }
+          checkComplete();
+        });
+      }
+    );
+    areasReq.on("error", () => {
+      if (!hasError) {
+        hasError = true;
+        res.status(500).json({ error: "Failed to fetch areas" });
+      }
+    });
+    areasReq.end();
+
+    // Fetch folders
+    const foldersReq = https.request(
+      {
+        hostname: "files.processlink.com.au",
+        path: `${baseUrl}/folders`,
+        method: "GET",
+        headers: headers,
+      },
+      (foldersRes) => {
+        let data = "";
+        foldersRes.on("data", (chunk) => (data += chunk));
+        foldersRes.on("end", () => {
+          try {
+            foldersData = JSON.parse(data);
+          } catch (e) {
+            foldersData = [];
+          }
+          checkComplete();
+        });
+      }
+    );
+    foldersReq.on("error", () => {
+      if (!hasError) {
+        hasError = true;
+        res.status(500).json({ error: "Failed to fetch folders" });
+      }
+    });
+    foldersReq.end();
+  });
 };

package/nodes/files/processlink-files-upload.html

@@ -46,16 +46,13 @@
 
         $location.html('<option value="">Loading...</option>');
 
-        var baseUrl = "https://files.processlink.com.au/api/sites/" + configNode.siteId;
-        var headers = { "Authorization": "Bearer " + configNode.credentials.apiKey };
-
-        // Fetch both areas and folders in parallel
-        $.when(
-          $.ajax({ url: baseUrl + "/areas", method: "GET", headers: headers }),
-          $.ajax({ url: baseUrl + "/folders", method: "GET", headers: headers })
-        ).done(function (areasResult, foldersResult) {
-          var areas = areasResult[0] || [];
-          var folders = foldersResult[0] || [];
+        // Fetch locations via server-side endpoint (credentials are not accessible client-side)
+        $.ajax({
+          url: "processlink/locations/" + configId,
+          method: "GET",
+        }).done(function (result) {
+          var areas = result.areas || [];
+          var folders = result.folders || [];
 
           // Build current selection key for matching
           var currentAreaId = node.areaId || "";
@@ -130,7 +127,8 @@
           $location.html(options);
         }).fail(function (xhr) {
           console.error("Failed to load locations:", xhr.responseText);
-          $location.html('<option value="|">Site root (default)</option><option disabled>-- Failed to load --</option>');
+          // Still allow site root if API fails
+          $location.html('<option value="|">Site root (default)</option><option disabled>-- Failed to load locations --</option>');
         });
       }
 

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Node-RED nodes for Process Link platform integration - upload files, send notifications, and connect to industrial automation systems",
   "keywords": [
     "node-red",