node-red-contrib-vectorprime 0.1.3 → 0.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-vectorprime",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "VectorPrime Decision Kernel node for Node-RED",
   "main": "vectorprime.js",
   "license": "MIT",

package/vectorprime.html

@@ -28,87 +28,86 @@
 </script>
 
 <script type="text/javascript">
-    (function () {
-        function normalizeBaseUrl(url) {
-            url = (url || "").trim();
-            if (!url) return "";
-            // Remove trailing slash
-            if (url.endsWith("/")) url = url.slice(0, -1);
-            return url;
-        }
-
-        RED.nodes.registerType("vectorprime-config", {
-            category: "config",
-            defaults: {
-                baseUrl: { value: "https://vectorprime-kernel-backend.onrender.com", required: true }
-            },
-            credentials: {
-                apiKey: { type: "password" }
-            },
-            label: function () {
-                return "VectorPrime Config";
-            },
-            oneditprepare: function () {
-                const statusEl = document.getElementById("vp-key-status");
-                const btn = document.getElementById("vp-get-free-key");
-
-                btn.onclick = async function (e) {
-                    e.preventDefault();
-                    statusEl.textContent = "Requesting free key...";
-                    statusEl.style.color = "#444";
-
-                    try {
-                        const baseUrlInput = document.getElementById("node-config-input-baseUrl");
-                        const apiKeyInput = document.getElementById("node-config-input-apiKey");
-
-                        const baseUrl = normalizeBaseUrl(baseUrlInput.value);
-
-                        if (!baseUrl.startsWith("http")) {
-                            statusEl.textContent = "❌ Base URL missing/invalid";
-                            statusEl.style.color = "red";
-                            return;
-                        }
-
-                        // Call backend directly from the editor
-                        const resp = await fetch(`${baseUrl}/v1/keys/free`, {
-                            method: "POST",
-                            headers: { "Content-Type": "application/json" },
-                            body: JSON.stringify({ source: "node-red" })
-                        });
-
-                        const text = await resp.text();
-                        let data;
-                        try { data = JSON.parse(text); } catch { data = { raw: text }; }
-
-                        if (!resp.ok) {
-                            statusEl.textContent = `❌ Failed (${resp.status}): ${data.message || data.error || "unknown"}`;
-                            statusEl.style.color = "red";
-                            return;
-                        }
-
-                        if (!data.api_key) {
-                            statusEl.textContent = "❌ Backend did not return api_key";
-                            statusEl.style.color = "red";
-                            return;
-                        }
-
-                        apiKeyInput.value = data.api_key;
-                        statusEl.textContent = "✅ Free key generated + saved";
-                        statusEl.style.color = "green";
-                    } catch (err) {
-                        statusEl.textContent = `❌ Error: ${err.message}`;
-                        statusEl.style.color = "red";
-                    }
-                };
+  (function () {
+    function normalizeBaseUrl(url) {
+      url = (url || "").trim();
+      if (!url) return "";
+      if (url.endsWith("/")) url = url.slice(0, -1);
+      return url;
+    }
+
+    RED.nodes.registerType("vectorprime-config", {
+      category: "config",
+      defaults: {
+        baseUrl: { value: "https://vectorprime-kernel-backend.onrender.com", required: true }
+      },
+      credentials: {
+        apiKey: { type: "password" }
+      },
+      label: function () {
+        return "VectorPrime Config";
+      },
+      oneditprepare: function () {
+        const statusEl = document.getElementById("vp-key-status");
+        const btn = document.getElementById("vp-get-free-key");
+
+        btn.onclick = async function (e) {
+          e.preventDefault();
+          statusEl.textContent = "Requesting free key...";
+          statusEl.style.color = "#444";
+
+          try {
+            const baseUrlInput = document.getElementById("node-config-input-baseUrl");
+            const apiKeyInput = document.getElementById("node-config-input-apiKey");
+
+            const baseUrl = normalizeBaseUrl(baseUrlInput.value);
+
+            if (!baseUrl.startsWith("http")) {
+              statusEl.textContent = "❌ Base URL missing/invalid";
+              statusEl.style.color = "red";
+              return;
             }
-        });
-    })();
+
+            const resp = await fetch(`${baseUrl}/v1/keys/free`, {
+              method: "POST",
+              headers: { "Content-Type": "application/json" },
+              body: JSON.stringify({ source: "node-red" })
+            });
+
+            const text = await resp.text();
+            let data;
+            try { data = JSON.parse(text); } catch { data = { raw: text }; }
+
+            if (!resp.ok) {
+              statusEl.textContent = `❌ Failed (${resp.status}): ${data.message || data.error || "unknown"}`;
+              statusEl.style.color = "red";
+              return;
+            }
+
+            if (!data.api_key) {
+              statusEl.textContent = "❌ Backend did not return api_key";
+              statusEl.style.color = "red";
+              return;
+            }
+
+            apiKeyInput.value = data.api_key;
+            statusEl.textContent = "✅ Free key generated + saved";
+            statusEl.style.color = "green";
+          } catch (err) {
+            statusEl.textContent = `❌ Error: ${err.message}`;
+            statusEl.style.color = "red";
+          }
+        };
+      }
+    });
+  })();
 </script>
 
+
 <script type="text/html" data-template-name="vectorprime-rank">
   <div class="form-row">
     <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
-    <input type="text" id="node-input-name" placeholder="VectorPrime Rank">
+    <input type="text" id="node-input-name" placeholder="Rank Decision (VectorPrime)">
   </div>
 
   <div class="form-row">
@@ -123,25 +122,79 @@
 
   <div class="form-row">
     <div style="font-size:12px; color:#666;">
-      ✅ This node sends <code>msg.payload</code> to VectorPrime and returns the response in <code>msg.payload</code>.
+      ✅ Sends <code>msg.payload</code> to VectorPrime and returns the response in <code>msg.payload</code>.
     </div>
   </div>
 </script>
 
 <script type="text/javascript">
-    RED.nodes.registerType("vectorprime-rank", {
-        category: "VectorPrime",
-        color: "#2563EB",   // ✅ FIX: readable (NOT black)
-        defaults: {
-            name: { value: "" },
-            config: { type: "vectorprime-config", required: true },
-            endpoint: { value: "/v1/kernel/rank", required: true }
-        },
-        inputs: 1,
-        outputs: 1,
-        icon: "font-awesome/fa-bolt",
-        label: function () {
-            return this.name || "VectorPrime Rank";
-        }
-    });
+  RED.nodes.registerType("vectorprime-rank", {
+    category: "network",                 // ✅ CHANGED: Network category
+    color: "#2563EB",
+    defaults: {
+      name: { value: "" },
+      config: { type: "vectorprime-config", required: true },
+      endpoint: { value: "/v1/kernel/rank", required: true }
+    },
+    inputs: 1,
+    outputs: 1,
+    icon: "font-awesome/fa-bolt",
+
+    paletteLabel: "Rank Decision (VectorPrime)",   // ✅ 1-second clarity
+
+    label: function () {
+      return this.name || "Rank Decision (VectorPrime)";
+    },
+
+    labelStyle: function () {
+      return this.name ? "node_label_italic" : "";
+    }
+  });
+</script>
+
+
+<!-- ✅ Help docs (fixes “no information available”) -->
+<script type="text/html" data-help-name="vectorprime-config">
+  <p><b>VectorPrime Config</b></p>
+  <p>
+    Stores your VectorPrime backend URL + API Key securely using Node-RED credentials.
+  </p>
+
+  <h3>Fields</h3>
+  <ul>
+    <li><b>Base URL</b> — your VectorPrime backend (Render URL by default).</li>
+    <li><b>API Key</b> — stored securely (not exported with flows).</li>
+  </ul>
+
+  <p>
+    Click <b>Get Free Key</b> to generate a free-tier key automatically (requires backend support).
+  </p>
+</script>
+
+<script type="text/html" data-help-name="vectorprime-rank">
+  <p><b>Rank Decision (VectorPrime)</b></p>
+
+  <p>
+    Sends <code>msg.payload</code> to VectorPrime for ranking and returns the result in <code>msg.payload</code>.
+  </p>
+
+  <h3>Input Example</h3>
+  <pre>{
+  "decision_id": "node-red-demo-001",
+  "prompt": "Pick one.",
+  "options": [{"id":"a","label":"A"},{"id":"b","label":"B"}],
+  "engine": "classical",
+  "seed": 123
+}</pre>
+
+  <h3>Output</h3>
+  <p>
+    Returns ranked options, probabilities, and metadata in <code>msg.payload</code>.
+  </p>
+
+  <h3>Authentication</h3>
+  <ul>
+    <li>If <code>msg.headers.Authorization</code> is provided, it uses that.</li>
+    <li>Otherwise it uses the key stored in <b>VectorPrime Config</b>.</li>
+  </ul>
 </script>

package/vectorprime.js

@@ -1,6 +1,7 @@
 module.exports = function (RED) {
+    // ✅ Works with node-fetch v2 or v3
     const fetch = (...args) =>
-        import("node-fetch").then(({ default: fetch }) => fetch(...args));
+        import("node-fetch").then((mod) => (mod.default ? mod.default(...args) : mod(...args)));
 
     function normalizeBaseUrl(url) {
         url = (url || "").trim();
@@ -11,6 +12,7 @@ module.exports = function (RED) {
 
     function normalizeEndpoint(path) {
         path = (path || "").trim();
+        if (!path) return "/v1/kernel/rank";
         if (!path.startsWith("/")) path = "/" + path;
         return path;
     }
@@ -38,15 +40,19 @@ module.exports = function (RED) {
         node.name = config.name;
         node.endpoint = config.endpoint || "/v1/kernel/rank";
 
-        const cfg = RED.nodes.getNode(config.config);
-
         node.on("input", async function (msg, send, done) {
+            send = send || function () { node.send.apply(node, arguments); };
+
             try {
+                const cfg = RED.nodes.getNode(config.config);
                 if (!cfg) {
                     node.status({ fill: "red", shape: "ring", text: "missing config" });
-                    throw new Error(
-                        "VectorPrime config missing. Open node settings and set Config."
-                    );
+                    msg.payload = {
+                        error: "VectorPrime config missing. Open node settings and set Config.",
+                    };
+                    send(msg);
+                    if (done) done();
+                    return;
                 }
 
                 const baseUrl = normalizeBaseUrl(cfg.baseUrl);
@@ -54,10 +60,16 @@ module.exports = function (RED) {
 
                 if (!baseUrl.startsWith("http")) {
                     node.status({ fill: "red", shape: "ring", text: "invalid base url" });
-                    throw new Error(`Base URL missing/invalid: ${baseUrl}`);
+                    msg.payload = { error: `Base URL missing/invalid: ${baseUrl}` };
+                    send(msg);
+                    if (done) done();
+                    return;
                 }
 
+                // ✅ Ensure headers object exists
                 msg.headers = msg.headers || {};
+
+                // ✅ Allow incoming Authorization override (advanced users)
                 const incomingAuth =
                     msg.headers.authorization ||
                     msg.headers.Authorization ||
@@ -68,17 +80,21 @@ module.exports = function (RED) {
                         ? String(cfg.credentials.apiKey).trim()
                         : "";
 
-                // If user didn't provide Authorization, use stored key
+                // ✅ If user didn't provide Authorization, use stored key from config credentials
                 if (!incomingAuth) {
                     if (!storedKey) {
                         node.status({ fill: "red", shape: "ring", text: "missing api key" });
-                        throw new Error(
-                            "No API key. Open VectorPrime Config and click 'Get Free Key'."
-                        );
+                        msg.payload = {
+                            error: "No API key. Open VectorPrime Config and click 'Get Free Key'.",
+                        };
+                        send(msg);
+                        if (done) done();
+                        return;
                     }
                     msg.headers.Authorization = `Bearer ${storedKey}`;
                 }
 
+                // ✅ Force JSON
                 msg.headers["Content-Type"] = "application/json";
 
                 const payload = msg.payload || {};
@@ -99,7 +115,7 @@ module.exports = function (RED) {
                     data = { raw: text };
                 }
 
-                // If free tier limit hit → return upgrade url inside Node-RED
+                // ✅ Free tier limit hit → return upgrade url inside Node-RED
                 if (!resp.ok) {
                     const upgradeUrl = data.upgrade_url || data.checkout_url || null;
 
@@ -112,24 +128,26 @@ module.exports = function (RED) {
                         msg.payload = data;
                         msg.vectorprime = { upgrade_url: upgradeUrl };
                         send(msg);
-                        done();
+                        if (done) done();
                         return;
                     }
 
                     node.status({ fill: "red", shape: "ring", text: `error ${resp.status}` });
                     msg.payload = data;
                     send(msg);
-                    done();
+                    if (done) done();
                     return;
                 }
 
                 node.status({ fill: "green", shape: "dot", text: "ok" });
                 msg.payload = data;
                 send(msg);
-                done();
+                if (done) done();
             } catch (err) {
                 node.status({ fill: "red", shape: "ring", text: "failed" });
-                done(err);
+                msg.payload = { error: err.message || String(err) };
+                send(msg);
+                if (done) done(err);
             }
         });
     }