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

package/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "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:*)"
+    ]
+  }
+}

package/README.md

@@ -28,6 +28,7 @@ Connect your Node-RED flows to the [Process Link](https://processlink.com.au) pl
 | Node | Description |
 |------|-------------|
 | **files upload** | Upload files to Process Link Files API |
+| **system info** | Output system diagnostics (hostname, memory, disk, uptime, etc.) |
 
 *More nodes coming soon: mail, downtime logging, notes*
 
@@ -70,49 +71,136 @@ Then restart Node-RED.
 ### 3. Connect Your Flow
 
 ```
-[File In] → [files upload] → [Debug]
+[Inject] → [File In] → [files upload] ─┬─ Output 1 (success) → [Debug]
+                                       └─ Output 2 (error)   → [Debug]
 ```
 
+---
+
 ## Node Reference
 
-### Files Upload
+---
+
+## Files Upload
 
 Uploads files to the Process Link Files API.
 
-#### Configuration
+### Configuration
 
 | Property | Description |
 |----------|-------------|
 | Config | Your Process Link credentials (Site ID + API Key) |
-| Filename | Default filename (optional, can be set via `msg.filename`) |
+| Filename | Filename for uploaded file (takes priority over `msg.filename`) |
+| Location | Destination area/folder in the Files app (default: site root) |
+| Prefix with timestamp | Adds `YYYY-MM-DD_HH-mm-ss_` prefix to filename (ISO 8601 format) |
 | Timeout | Request timeout in milliseconds (default: 30000) |
 
-#### Inputs
+**Filename priority:** Config filename → `msg.filename` → `file.bin`
+
+**Location:** The dropdown shows your site's folder structure organized by area. Select where uploaded files should be stored. Areas and folders are fetched from the Files API when you open the node configuration.
+
+**Timestamp prefix:** When enabled, always prepends the current date/time to the filename, regardless of whether it came from config or `msg.filename`.
+
+### Inputs
 
 | Property | Type | Description |
 |----------|------|-------------|
 | `msg.payload` | Buffer \| string | The file content to upload |
-| `msg.filename` | string | *(Optional)* Filename to use |
+| `msg.filename` | string | *(Optional)* Fallback filename if not set in config |
 
-#### Outputs
+### Outputs
 
-| Property | Type | Description |
-|----------|------|-------------|
-| `msg.payload` | object | API response with `ok`, `file_id`, `created_at` |
-| `msg.file_id` | string | The UUID of the uploaded file |
-| `msg.statusCode` | number | HTTP status code (201 on success) |
+This node has **two outputs**:
+
+| Output | When | Properties |
+|--------|------|------------|
+| **1 - Success** | HTTP 201 | `msg.payload.ok`, `msg.payload.file_id`, `msg.file_id`, `msg.statusCode` |
+| **2 - Error** | API error, network error, timeout | `msg.payload.error`, `msg.statusCode` |
 
-#### Status Indicators
+### Status Indicators
 
 | Color | Meaning |
 |-------|---------|
+| 🔴 Red | Error occurred |
 | 🟡 Yellow | Uploading in progress |
 | 🟢 Green | Upload successful |
-| 🔴 Red | Error occurred |
 
-## Example Flow (Copy & Import)
+### Status Codes
+
+| Code | Meaning |
+|------|---------|
+| 201 | Success |
+| 400 | Bad request |
+| 401 | Invalid API key |
+| 403 | API access not enabled |
+| 404 | Site not found |
+| 429 | Rate limit exceeded (max 30/min) |
+| 507 | Storage limit exceeded |
+
+---
+
+## System Info
 
-Copy the JSON below and import it into Node-RED: **Menu → Import → Clipboard**
+Outputs system information for diagnostics and monitoring.
+
+### Configuration
+
+| Property | Description |
+|----------|-------------|
+| Send on deploy | When checked (default), outputs system info when the flow is deployed |
+
+### Triggers
+
+- **On deploy** (if enabled) - Automatically sends when flow starts
+- **On input** - Any incoming message triggers a fresh reading
+
+### Output
+
+`msg.payload` contains:
+
+| Property | Description |
+|----------|-------------|
+| `timestamp` | ISO 8601 UTC timestamp |
+| `localTime` | Device local time string |
+| `timezone` | Timezone name (e.g., "Australia/Sydney") |
+| `hostname` | Device hostname |
+| `platform` | "win32", "linux", or "darwin" |
+| `os` | OS name and version |
+| `arch` | CPU architecture |
+| `user` | User running Node-RED |
+| `workingDirectory` | Node-RED working directory |
+| `uptime` | System uptime (`raw`, `breakdown`, `formatted`) |
+| `cpu` | Model, cores, architecture |
+| `memory` | Total, free, used (bytes + formatted), usedPercent |
+| `disk` | Total, free, used (bytes + formatted), usedPercent |
+| `network` | primaryIP, mac, interfaces |
+| `nodeRed` | version, uptime |
+| `nodejs` | version |
+| `processMemory` | rss, heapTotal, heapUsed |
+
+### Uptime/Memory Structure
+
+```json
+{
+  "uptime": {
+    "raw": 432000,
+    "breakdown": { "days": 5, "hours": 0, "minutes": 0, "seconds": 0 },
+    "formatted": "5d 0h 0m 0s"
+  },
+  "memory": {
+    "total": { "bytes": 17179869184, "formatted": "16.00 GB" },
+    "free": { "bytes": 8589934592, "formatted": "8.00 GB" },
+    "used": { "bytes": 8589934592, "formatted": "8.00 GB" },
+    "usedPercent": 50
+  }
+}
+```
+
+---
+
+## Example Flow
+
+Copy the JSON below and import into Node-RED: **Menu → Import → Clipboard**
 
 ```json
 [
@@ -158,21 +246,36 @@ Copy the JSON below and import it into Node-RED: **Menu → Import → Clipboard
         "apiUrl": "https://files.processlink.com.au/api/upload",
         "x": 470,
         "y": 100,
-        "wires": [["pl-debug"]]
+        "wires": [["pl-debug-success"], ["pl-debug-error"]]
     },
     {
-        "id": "pl-debug",
+        "id": "pl-debug-success",
         "type": "debug",
         "z": "",
-        "name": "Result",
+        "name": "Success",
         "active": true,
         "tosidebar": true,
         "console": false,
         "tostatus": false,
         "complete": "true",
         "targetType": "full",
-        "x": 650,
-        "y": 100,
+        "x": 680,
+        "y": 80,
+        "wires": []
+    },
+    {
+        "id": "pl-debug-error",
+        "type": "debug",
+        "z": "",
+        "name": "Error",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "true",
+        "targetType": "full",
+        "x": 670,
+        "y": 120,
         "wires": []
     }
 ]
@@ -184,43 +287,7 @@ Copy the JSON below and import it into Node-RED: **Menu → Import → Clipboard
 3. Click **Deploy**
 4. Click the inject button to upload
 
-### Dynamic Filename
-
-Use a Function node to set the filename dynamically:
-
-```javascript
-msg.filename = "report-" + new Date().toISOString().split('T')[0] + ".csv";
-return msg;
-```
-
-### Upload with Error Handling
-
-```
-[File In] → [files upload] → [Switch] → [Debug (success)]
-                                     ↘ [Debug (error)]
-```
-
-Use a Switch node to route based on `msg.statusCode`:
-- Route 1: `msg.statusCode == 201` (success)
-- Route 2: Otherwise (error)
-
-## Error Handling
-
-| Status Code | Meaning | Solution |
-|-------------|---------|----------|
-| 201 | Success | File uploaded successfully |
-| 400 | Bad Request | Check that payload is a valid file buffer |
-| 401 | Unauthorized | Verify your API key is correct |
-| 403 | Forbidden | Enable API access in site settings |
-| 404 | Not Found | Verify your Site ID is correct |
-| 429 | Rate Limited | Max 30 uploads/minute per site |
-| 507 | Storage Full | Contact administrator to increase storage |
-
-## Rate Limits
-
-- **30 uploads per minute** per site
-- Exceeding the limit returns a 429 status code
-- Implement retry logic in your flow for high-volume uploads
+---
 
 ## Security
 
@@ -235,15 +302,10 @@ Use a Switch node to route based on `msg.statusCode`:
 
 ## Support
 
-- 📖 **Documentation**: [GitHub Wiki](https://github.com/process-link/node-red-contrib-processlink/wiki)
 - 🐛 **Issues**: [GitHub Issues](https://github.com/process-link/node-red-contrib-processlink/issues)
 - 📧 **Email**: support@processlink.com.au
 - 🌐 **Website**: [processlink.com.au](https://processlink.com.au)
 
-## Contributing
-
-Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) before submitting a pull request.
-
 ## License
 
 [MIT](LICENSE)

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

@@ -6,6 +6,8 @@
       name: { value: "" },
       server: { value: "", type: "processlink-config", required: true },
       filename: { value: "" },
+      areaId: { value: "" },
+      folderId: { value: "" },
       timestampPrefix: { value: false },
       timeout: { value: "30000" },
       apiUrl: { value: "https://files.processlink.com.au/api/upload" },
@@ -22,6 +24,131 @@
     },
     inputLabels: "file buffer",
     outputLabels: ["success", "error"],
+    oneditprepare: function () {
+      var node = this;
+      var $location = $("#node-input-location");
+      var $areaId = $("#node-input-areaId");
+      var $folderId = $("#node-input-folderId");
+      var $server = $("#node-input-server");
+
+      function loadLocations() {
+        var configId = $server.val();
+        if (!configId) {
+          $location.html('<option value="">-- Select config first --</option>');
+          return;
+        }
+
+        var configNode = RED.nodes.node(configId);
+        if (!configNode || !configNode.siteId) {
+          $location.html('<option value="">-- Config not ready --</option>');
+          return;
+        }
+
+        $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] || [];
+
+          // Build current selection key for matching
+          var currentAreaId = node.areaId || "";
+          var currentFolderId = node.folderId || "";
+          var currentKey = currentAreaId + "|" + currentFolderId;
+
+          var options = '<option value="|" data-area="" data-folder="">Site root (default)</option>';
+
+          // Group folders by area
+          var foldersByArea = {};
+          folders.forEach(function (f) {
+            var areaKey = f.area_id || "";
+            if (!foldersByArea[areaKey]) foldersByArea[areaKey] = [];
+            foldersByArea[areaKey].push(f);
+          });
+
+          // Add areas with their folders
+          areas.forEach(function (area) {
+            var areaFolders = foldersByArea[area.id] || [];
+            options += '<optgroup label="' + area.area_name + '">';
+
+            // Area root option
+            var areaRootKey = area.id + "|";
+            var areaRootSelected = areaRootKey === currentKey ? ' selected' : '';
+            options += '<option value="' + areaRootKey + '" data-area="' + area.id + '" data-folder=""' + areaRootSelected + '>' + area.area_name + ' (root)</option>';
+
+            // Root folders in this area
+            var rootFolders = areaFolders.filter(function (f) { return !f.parent_id; });
+            rootFolders.sort(function (a, b) { return a.name.localeCompare(b.name); });
+
+            rootFolders.forEach(function (folder) {
+              var folderKey = area.id + "|" + folder.id;
+              var selected = folderKey === currentKey ? ' selected' : '';
+              options += '<option value="' + folderKey + '" data-area="' + area.id + '" data-folder="' + folder.id + '"' + selected + '>&nbsp;&nbsp;' + folder.name + '</option>';
+
+              // Child folders
+              var children = areaFolders.filter(function (c) { return c.parent_id === folder.id; });
+              children.sort(function (a, b) { return a.name.localeCompare(b.name); });
+              children.forEach(function (child) {
+                var childKey = area.id + "|" + child.id;
+                var childSelected = childKey === currentKey ? ' selected' : '';
+                options += '<option value="' + childKey + '" data-area="' + area.id + '" data-folder="' + child.id + '"' + childSelected + '>&nbsp;&nbsp;&nbsp;&nbsp;' + child.name + '</option>';
+              });
+            });
+
+            options += '</optgroup>';
+          });
+
+          // Add folders without an area
+          var noAreaFolders = foldersByArea[""] || [];
+          if (noAreaFolders.length > 0) {
+            options += '<optgroup label="No Area">';
+            var rootFolders = noAreaFolders.filter(function (f) { return !f.parent_id; });
+            rootFolders.sort(function (a, b) { return a.name.localeCompare(b.name); });
+
+            rootFolders.forEach(function (folder) {
+              var folderKey = "|" + folder.id;
+              var selected = folderKey === currentKey ? ' selected' : '';
+              options += '<option value="' + folderKey + '" data-area="" data-folder="' + folder.id + '"' + selected + '>' + folder.name + '</option>';
+
+              var children = noAreaFolders.filter(function (c) { return c.parent_id === folder.id; });
+              children.sort(function (a, b) { return a.name.localeCompare(b.name); });
+              children.forEach(function (child) {
+                var childKey = "|" + child.id;
+                var childSelected = childKey === currentKey ? ' selected' : '';
+                options += '<option value="' + childKey + '" data-area="" data-folder="' + child.id + '"' + childSelected + '>&nbsp;&nbsp;' + child.name + '</option>';
+              });
+            });
+            options += '</optgroup>';
+          }
+
+          $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>');
+        });
+      }
+
+      // Update hidden inputs when selection changes
+      $location.on("change", function () {
+        var $selected = $location.find(":selected");
+        $areaId.val($selected.data("area") || "");
+        $folderId.val($selected.data("folder") || "");
+      });
+
+      // Load locations when config changes
+      $server.on("change", function () {
+        loadLocations();
+      });
+
+      // Initial load
+      loadLocations();
+    },
   });
 </script>
 
@@ -38,10 +165,18 @@
     <label for="node-input-filename"><i class="fa fa-file"></i> Filename</label>
     <input type="text" id="node-input-filename" placeholder="msg.filename (or specify default)" />
   </div>
+  <div class="form-row">
+    <label for="node-input-location"><i class="fa fa-folder"></i> Location</label>
+    <select id="node-input-location" style="width: 70%">
+      <option value="|">Site root (default)</option>
+    </select>
+    <input type="hidden" id="node-input-areaId" />
+    <input type="hidden" id="node-input-folderId" />
+  </div>
   <div class="form-row">
     <label for="node-input-timestampPrefix">&nbsp;</label>
     <input type="checkbox" id="node-input-timestampPrefix" style="width: auto; margin-right: 10px;">
-    <span>Prefix filename with timestamp (YYYY-MM-DD_HH-MM-SS_)</span>
+    <span>Prefix filename with timestamp (YYYY-MM-DD_HH-mm-ss_)</span>
   </div>
   <div class="form-row">
     <label for="node-input-timeout"><i class="fa fa-clock-o"></i> Timeout</label>
@@ -62,7 +197,7 @@
     <dt>payload <span class="property-type">buffer | string</span></dt>
     <dd>The file content to upload.</dd>
     <dt class="optional">filename <span class="property-type">string</span></dt>
-    <dd>Filename for the upload. Can be set via <code>msg.filename</code> or in the node config. Defaults to "file.bin".</dd>
+    <dd>Fallback filename if not set in config. Priority: config → <code>msg.filename</code> → "file.bin".</dd>
   </dl>
 
   <h3>Outputs</h3>
@@ -95,9 +230,11 @@
   <h3>Configuration</h3>
   <dl class="message-properties">
     <dt>Filename <span class="property-type">string</span></dt>
-    <dd>Default filename if <code>msg.filename</code> is not set.</dd>
+    <dd>Filename for uploaded file. Takes priority over <code>msg.filename</code>.</dd>
+    <dt>Location <span class="property-type">select</span></dt>
+    <dd>Destination area/folder in the Files app. Default: site root.</dd>
     <dt>Prefix with timestamp <span class="property-type">boolean</span></dt>
-    <dd>Adds <code>YYYY-MM-DD_HH-MM-SS_</code> prefix to filename.</dd>
+    <dd>Adds <code>YYYY-MM-DD_HH-mm-ss_</code> prefix (ISO 8601). Applied regardless of filename source.</dd>
     <dt>Timeout <span class="property-type">number</span></dt>
     <dd>Request timeout in ms. Default: 30000.</dd>
   </dl>

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

@@ -53,8 +53,8 @@ module.exports = function (RED) {
         return;
       }
 
-      // Get filename
-      const filename = msg.filename || config.filename || "file.bin";
+      // Get filename (config takes priority over msg.filename)
+      const filename = config.filename || msg.filename || "file.bin";
       let basename = filename.split(/[\\/]/).pop();
 
       // Add timestamp prefix if enabled
@@ -71,14 +71,38 @@ module.exports = function (RED) {
 
       // Build multipart form data
       const boundary = "----NodeREDProcessLink" + Date.now() + Math.random().toString(36).substring(2);
+      const parts = [];
 
-      const header = Buffer.from(
+      // Add file part
+      parts.push(Buffer.from(
         `--${boundary}\r\n` +
         `Content-Disposition: form-data; name="file"; filename="${basename}"\r\n` +
         `Content-Type: application/octet-stream\r\n\r\n`
-      );
-      const footer = Buffer.from(`\r\n--${boundary}--\r\n`);
-      const body = Buffer.concat([header, fileBuffer, footer]);
+      ));
+      parts.push(fileBuffer);
+
+      // Add areaId if specified
+      if (config.areaId) {
+        parts.push(Buffer.from(
+          `\r\n--${boundary}\r\n` +
+          `Content-Disposition: form-data; name="areaId"\r\n\r\n` +
+          config.areaId
+        ));
+      }
+
+      // Add folderId if specified
+      if (config.folderId) {
+        parts.push(Buffer.from(
+          `\r\n--${boundary}\r\n` +
+          `Content-Disposition: form-data; name="folderId"\r\n\r\n` +
+          config.folderId
+        ));
+      }
+
+      // Add closing boundary
+      parts.push(Buffer.from(`\r\n--${boundary}--\r\n`));
+
+      const body = Buffer.concat(parts);
 
       // Parse URL
       const apiUrl = config.apiUrl || "https://files.processlink.com.au/api/upload";

package/package.json

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