node-red-contrib-i3x 0.0.1

package/nodes/i3x-history.html

@@ -0,0 +1,75 @@
+<script type="text/html" data-template-name="i3x-history">
+    <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="Name">
+    </div>
+    <div class="form-row">
+        <label for="node-input-server"><i class="fa fa-server"></i> Server</label>
+        <input type="text" id="node-input-server">
+    </div>
+    <div class="form-row">
+        <label for="node-input-elementIds"><i class="fa fa-list"></i> Element IDs</label>
+        <input type="text" id="node-input-elementIds" placeholder="comma-separated element IDs">
+    </div>
+    <div class="form-row">
+        <label for="node-input-startTime"><i class="fa fa-clock-o"></i> Start Time</label>
+        <input type="text" id="node-input-startTime" placeholder="ISO 8601 or relative (e.g. -1h, -7d)">
+    </div>
+    <div class="form-row">
+        <label for="node-input-endTime"><i class="fa fa-clock-o"></i> End Time</label>
+        <input type="text" id="node-input-endTime" placeholder="ISO 8601 or relative (default: now)">
+    </div>
+    <div class="form-row">
+        <label for="node-input-maxDepth"><i class="fa fa-level-down"></i> Max Depth</label>
+        <input type="number" id="node-input-maxDepth" placeholder="1" min="0" step="1">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="i3x-history">
+    <p>Queries historical values for one or more i3X objects.</p>
+
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt class="optional">elementIds <span class="property-type">string | string[]</span></dt>
+        <dd>Element IDs to query history for. Also accepts <code>msg.nodeIds</code>.</dd>
+        <dt class="optional">startTime <span class="property-type">string</span></dt>
+        <dd>Start of the time range. ISO 8601 timestamp or relative notation (<code>-1h</code>, <code>-7d</code>, <code>-30m</code>).</dd>
+        <dt class="optional">endTime <span class="property-type">string</span></dt>
+        <dd>End of the time range. Defaults to current time.</dd>
+        <dt class="optional">maxDepth <span class="property-type">number</span></dt>
+        <dd>Recursion depth. <code>0</code> = infinite, <code>1</code> = no recursion (default).</dd>
+    </dl>
+
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">array</span></dt>
+        <dd>Historical time-series data returned by the API.</dd>
+    </dl>
+
+    <h3>Details</h3>
+    <p>Uses <code>POST /objects/history</code>. Time values support both ISO 8601 and
+    relative notation: <code>-30s</code> (seconds), <code>-5m</code> (minutes), <code>-1h</code> (hours),
+    <code>-7d</code> (days), <code>-1w</code> (weeks).</p>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType("i3x-history", {
+        category: "i3x",
+        color: "#5DB87C",
+        defaults: {
+            name: { value: "" },
+            server: { value: "", type: "i3x-server", required: true },
+            elementIds: { value: "" },
+            startTime: { value: "-1h" },
+            endTime: { value: "" },
+            maxDepth: { value: 1 },
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: "i3x-icon.svg",
+        paletteLabel: "i3x history",
+        label: function () {
+            return this.name || this.elementIds || "i3x history";
+        },
+    });
+</script>

package/nodes/i3x-history.js

@@ -0,0 +1,67 @@
+/**
+ * i3x-history – Query historical values from the i3X API.
+ */
+"use strict";
+
+const { bindServer, parseIds, safeSend } = require("../lib/node-utils");
+
+/**
+ * Resolve relative time strings like "-1h", "-7d", "-30m" to ISO 8601.
+ * @param {string} input
+ * @returns {string|undefined} ISO 8601 timestamp
+ */
+function resolveTime(input) {
+    if (!input) return undefined;
+    const rel = /^-(\d+)([smhdw])$/i.exec(input.trim());
+    if (!rel) return input;
+    const amount = parseInt(rel[1], 10);
+    const unit = rel[2].toLowerCase();
+    const ms = { s: 1000, m: 60000, h: 3600000, d: 86400000, w: 604800000 };
+    return new Date(Date.now() - amount * (ms[unit] || 0)).toISOString();
+}
+
+module.exports = function (RED) {
+    function I3XHistoryNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        node.elementIds = config.elementIds || "";
+        node.startTime = config.startTime || "";
+        node.endTime = config.endTime || "";
+        node.maxDepth = parseInt(config.maxDepth, 10);
+        if (isNaN(node.maxDepth)) node.maxDepth = 1;
+
+        if (!bindServer(node, RED, config.server)) return;
+
+        node.on("input", async function (msg, send, done) {
+            send = safeSend(node, send);
+            const client = node.server.client;
+
+            const ids = parseIds(msg.elementIds || msg.nodeIds || node.elementIds);
+            if (ids.length === 0) {
+                const err = new Error("elementIds is required");
+                if (done) done(err); else node.error(err, msg);
+                return;
+            }
+
+            const startTime = resolveTime(msg.startTime || node.startTime);
+            const endTime = resolveTime(msg.endTime || node.endTime);
+            const maxDepth = msg.maxDepth !== undefined ? parseInt(msg.maxDepth, 10) : node.maxDepth;
+
+            node.status({ fill: "blue", shape: "dot", text: "querying..." });
+
+            try {
+                const result = await client.readHistory(ids, { startTime, endTime, maxDepth });
+                msg.payload = result;
+                node.status({ fill: "green", shape: "dot", text: "ok" });
+                send(msg);
+                if (done) done();
+            } catch (err) {
+                node.status({ fill: "red", shape: "ring", text: err.message.substring(0, 32) });
+                if (done) done(err); else node.error(err, msg);
+            }
+        });
+    }
+
+    RED.nodes.registerType("i3x-history", I3XHistoryNode);
+};

package/nodes/i3x-read.html

@@ -0,0 +1,60 @@
+<script type="text/html" data-template-name="i3x-read">
+    <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="Name">
+    </div>
+    <div class="form-row">
+        <label for="node-input-server"><i class="fa fa-server"></i> Server</label>
+        <input type="text" id="node-input-server">
+    </div>
+    <div class="form-row">
+        <label for="node-input-elementIds"><i class="fa fa-list"></i> Element IDs</label>
+        <input type="text" id="node-input-elementIds" placeholder="comma-separated element IDs">
+    </div>
+    <div class="form-row">
+        <label for="node-input-maxDepth"><i class="fa fa-level-down"></i> Max Depth</label>
+        <input type="number" id="node-input-maxDepth" placeholder="1" min="0" step="1">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="i3x-read">
+    <p>Reads the last known values for one or more i3X objects.</p>
+
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt class="optional">elementIds <span class="property-type">string | string[]</span></dt>
+        <dd>Element IDs to read. Comma-separated string or array. Also accepts <code>msg.nodeIds</code>.</dd>
+        <dt class="optional">maxDepth <span class="property-type">number</span></dt>
+        <dd>Recursion depth for child components. <code>0</code> = infinite, <code>1</code> = this element only (default).</dd>
+    </dl>
+
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">object | array</span></dt>
+        <dd>Last known value(s) returned by the i3X API.</dd>
+    </dl>
+
+    <h3>Details</h3>
+    <p>Uses <code>POST /objects/value</code>. The <code>maxDepth</code> parameter controls whether
+    child component values are included recursively.</p>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType("i3x-read", {
+        category: "i3x",
+        color: "#5DB87C",
+        defaults: {
+            name: { value: "" },
+            server: { value: "", type: "i3x-server", required: true },
+            elementIds: { value: "" },
+            maxDepth: { value: 1 },
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: "i3x-icon.svg",
+        paletteLabel: "i3x read",
+        label: function () {
+            return this.name || this.elementIds || "i3x read";
+        },
+    });
+</script>

package/nodes/i3x-read.js

@@ -0,0 +1,48 @@
+/**
+ * i3x-read – Read last known values from one or more i3X objects.
+ */
+"use strict";
+
+const { bindServer, parseIds, safeSend } = require("../lib/node-utils");
+
+module.exports = function (RED) {
+    function I3XReadNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        node.elementIds = config.elementIds || "";
+        node.maxDepth = parseInt(config.maxDepth, 10);
+        if (isNaN(node.maxDepth)) node.maxDepth = 1;
+
+        if (!bindServer(node, RED, config.server)) return;
+
+        node.on("input", async function (msg, send, done) {
+            send = safeSend(node, send);
+            const client = node.server.client;
+
+            const ids = parseIds(msg.elementIds || msg.nodeIds || node.elementIds);
+            if (ids.length === 0) {
+                const err = new Error("elementIds is required (string, comma-separated, or array)");
+                if (done) done(err); else node.error(err, msg);
+                return;
+            }
+
+            const maxDepth = msg.maxDepth !== undefined ? parseInt(msg.maxDepth, 10) : node.maxDepth;
+
+            node.status({ fill: "blue", shape: "dot", text: "requesting..." });
+
+            try {
+                const result = await client.readValues(ids, { maxDepth });
+                msg.payload = result;
+                node.status({ fill: "green", shape: "dot", text: "ok" });
+                send(msg);
+                if (done) done();
+            } catch (err) {
+                node.status({ fill: "red", shape: "ring", text: err.message.substring(0, 32) });
+                if (done) done(err); else node.error(err, msg);
+            }
+        });
+    }
+
+    RED.nodes.registerType("i3x-read", I3XReadNode);
+};

package/nodes/i3x-server.html

@@ -0,0 +1,98 @@
+<script type="text/html" data-template-name="i3x-server">
+    <div class="form-row">
+        <label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-config-input-name" placeholder="i3X Server">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-baseUrl"><i class="fa fa-globe"></i> Base URL</label>
+        <input type="text" id="node-config-input-baseUrl" placeholder="https://i3x.cesmii.net">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-apiVersion"><i class="fa fa-code-fork"></i> API Version</label>
+        <input type="text" id="node-config-input-apiVersion" placeholder="v0 (leave empty for current)">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-authType"><i class="fa fa-lock"></i> Auth Type</label>
+        <select id="node-config-input-authType">
+            <option value="none">None</option>
+            <option value="basic">Basic Auth</option>
+            <option value="bearer">Bearer Token</option>
+            <option value="apikey">API Key</option>
+        </select>
+    </div>
+    <div class="form-row i3x-auth-basic">
+        <label for="node-config-input-username"><i class="fa fa-user"></i> Username</label>
+        <input type="text" id="node-config-input-username">
+    </div>
+    <div class="form-row i3x-auth-basic">
+        <label for="node-config-input-password"><i class="fa fa-key"></i> Password</label>
+        <input type="password" id="node-config-input-password">
+    </div>
+    <div class="form-row i3x-auth-bearer">
+        <label for="node-config-input-token"><i class="fa fa-ticket"></i> Token</label>
+        <input type="password" id="node-config-input-token">
+    </div>
+    <div class="form-row i3x-auth-apikey">
+        <label for="node-config-input-apiKey"><i class="fa fa-key"></i> API Key</label>
+        <input type="password" id="node-config-input-apiKey">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-tlsConfig"><i class="fa fa-shield"></i> TLS</label>
+        <input type="text" id="node-config-input-tlsConfig">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-timeout"><i class="fa fa-clock-o"></i> Timeout (ms)</label>
+        <input type="number" id="node-config-input-timeout" placeholder="10000" min="1000" step="1000">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="i3x-server">
+    <p>Configuration node for an i3X API server connection.</p>
+    <h3>Properties</h3>
+    <dl class="message-properties">
+        <dt>Base URL <span class="property-type">string</span></dt>
+        <dd>The root URL of the i3X API server, e.g. <code>https://i3x.cesmii.net</code>.</dd>
+        <dt>API Version <span class="property-type">string</span></dt>
+        <dd>Optional path prefix for versioned endpoints (e.g. <code>v0</code>). Leave empty for current default.</dd>
+        <dt>Auth Type <span class="property-type">select</span></dt>
+        <dd>Authentication method: None, Basic Auth, Bearer Token, or API Key.</dd>
+        <dt>TLS <span class="property-type">tls-config</span></dt>
+        <dd>Optional TLS configuration for custom certificates.</dd>
+        <dt>Timeout <span class="property-type">number</span></dt>
+        <dd>HTTP request timeout in milliseconds (default 10000).</dd>
+    </dl>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType("i3x-server", {
+        category: "config",
+        defaults: {
+            name: { value: "" },
+            baseUrl: { value: "", required: true },
+            apiVersion: { value: "" },
+            authType: { value: "none" },
+            tlsConfig: { value: "", type: "tls-config", required: false },
+            timeout: { value: 10000 },
+        },
+        credentials: {
+            username: { type: "text" },
+            password: { type: "password" },
+            token: { type: "password" },
+            apiKey: { type: "password" },
+        },
+        label: function () {
+            return this.name || this.baseUrl || "i3x server";
+        },
+        oneditprepare: function () {
+            var authType = $("#node-config-input-authType");
+            function toggleAuth() {
+                var val = authType.val();
+                $(".i3x-auth-basic").toggle(val === "basic");
+                $(".i3x-auth-bearer").toggle(val === "bearer");
+                $(".i3x-auth-apikey").toggle(val === "apikey");
+            }
+            authType.on("change", toggleAuth);
+            toggleAuth();
+        },
+    });
+</script>

package/nodes/i3x-server.js

@@ -0,0 +1,75 @@
+/**
+ * i3x-server – Config node providing a shared I3XClient instance.
+ */
+"use strict";
+
+const I3XClient = require("../lib/i3x-client");
+
+module.exports = function (RED) {
+    function I3XServerNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        node.name = config.name;
+        node.baseUrl = config.baseUrl;
+        node.apiVersion = config.apiVersion || "";
+        node.authType = config.authType || "none";
+        node.timeout = parseInt(config.timeout, 10) || 10000;
+        node.tlsConfigId = config.tlsConfig;
+
+        const clientConfig = {
+            baseUrl: node.baseUrl,
+            apiVersion: node.apiVersion,
+            authType: node.authType,
+            timeout: node.timeout,
+        };
+
+        if (node.credentials) {
+            clientConfig.username = node.credentials.username;
+            clientConfig.password = node.credentials.password;
+            clientConfig.token = node.credentials.token;
+            clientConfig.apiKey = node.credentials.apiKey;
+        }
+
+        if (node.tlsConfigId) {
+            const tlsNode = RED.nodes.getNode(node.tlsConfigId);
+            if (tlsNode && tlsNode.addTLSOptions) {
+                const tlsOpts = {};
+                tlsNode.addTLSOptions(tlsOpts);
+                if (tlsOpts.ca || tlsOpts.cert || tlsOpts.key || tlsOpts.rejectUnauthorized !== undefined) {
+                    clientConfig.tlsOptions = tlsOpts;
+                }
+            }
+        }
+
+        node.client = new I3XClient(clientConfig);
+        node.setMaxListeners(0);
+
+        node.client.testConnection()
+            .then(() => {
+                node.connected = true;
+                node.emit("connected");
+                node.log("Connected to i3X server: " + node.baseUrl);
+            })
+            .catch((err) => {
+                node.connected = false;
+                node.emit("disconnected", err);
+                node.warn("i3X connection test failed: " + err.message);
+            });
+
+        node.on("close", function (done) {
+            node.client.destroy();
+            node.connected = false;
+            done();
+        });
+    }
+
+    RED.nodes.registerType("i3x-server", I3XServerNode, {
+        credentials: {
+            username: { type: "text" },
+            password: { type: "password" },
+            token: { type: "password" },
+            apiKey: { type: "password" },
+        },
+    });
+};

package/nodes/i3x-subscribe.html

@@ -0,0 +1,79 @@
+<script type="text/html" data-template-name="i3x-subscribe">
+    <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="Name">
+    </div>
+    <div class="form-row">
+        <label for="node-input-server"><i class="fa fa-server"></i> Server</label>
+        <input type="text" id="node-input-server">
+    </div>
+    <div class="form-row">
+        <label for="node-input-elementIds"><i class="fa fa-list"></i> Element IDs</label>
+        <input type="text" id="node-input-elementIds" placeholder="comma-separated element IDs to monitor">
+    </div>
+    <div class="form-row">
+        <label for="node-input-mode"><i class="fa fa-exchange"></i> Mode</label>
+        <select id="node-input-mode">
+            <option value="sse">SSE (Server-Sent Events)</option>
+            <option value="poll">Polling (sync)</option>
+        </select>
+    </div>
+    <div class="form-row i3x-sub-poll">
+        <label for="node-input-pollingInterval"><i class="fa fa-clock-o"></i> Poll Interval (ms)</label>
+        <input type="number" id="node-input-pollingInterval" placeholder="5000" min="500" step="500">
+    </div>
+    <div class="form-row">
+        <label for="node-input-maxDepth"><i class="fa fa-level-down"></i> Max Depth</label>
+        <input type="number" id="node-input-maxDepth" placeholder="1" min="0" step="1">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="i3x-subscribe">
+    <p>Subscribes to value changes on one or more i3X objects and emits messages on each update.</p>
+
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">object | array</span></dt>
+        <dd>Value change events from the subscription.</dd>
+        <dt>topic <span class="property-type">string</span></dt>
+        <dd>Always <code>i3x/subscription</code>.</dd>
+    </dl>
+
+    <h3>Details</h3>
+    <p>Creates a server-side subscription via the i3X Subscribe API and monitors the specified elements.</p>
+    <p><b>SSE mode</b> opens a persistent Server-Sent Events stream (<code>GET /subscriptions/{id}/stream</code>)
+    and emits messages in real-time as values change.</p>
+    <p><b>Polling mode</b> periodically calls <code>POST /subscriptions/{id}/sync</code> to retrieve and
+    clear queued updates. If SSE setup fails, the node automatically falls back to polling.</p>
+    <p>The subscription is automatically cleaned up (deleted from the server) when the node is stopped or re-deployed.</p>
+</script>
+
+<script type="text/javascript">
+    RED.nodes.registerType("i3x-subscribe", {
+        category: "i3x",
+        color: "#5DB87C",
+        defaults: {
+            name: { value: "" },
+            server: { value: "", type: "i3x-server", required: true },
+            elementIds: { value: "" },
+            mode: { value: "sse" },
+            pollingInterval: { value: 5000 },
+            maxDepth: { value: 1 },
+        },
+        inputs: 0,
+        outputs: 1,
+        icon: "i3x-icon.svg",
+        paletteLabel: "i3x subscribe",
+        label: function () {
+            return this.name || this.elementIds || "i3x subscribe";
+        },
+        oneditprepare: function () {
+            var mode = $("#node-input-mode");
+            function togglePoll() {
+                $(".i3x-sub-poll").toggle(mode.val() === "poll");
+            }
+            mode.on("change", togglePoll);
+            togglePoll();
+        },
+    });
+</script>

package/nodes/i3x-subscribe.js

@@ -0,0 +1,152 @@
+/**
+ * i3x-subscribe – Subscribe to value changes via SSE streaming or polling fallback.
+ */
+"use strict";
+
+const { bindServer, parseIds } = require("../lib/node-utils");
+
+module.exports = function (RED) {
+    function I3XSubscribeNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        node.elementIds = config.elementIds || "";
+        node.mode = config.mode || "sse";
+        node.pollingInterval = parseInt(config.pollingInterval, 10) || 5000;
+        node.maxDepth = parseInt(config.maxDepth, 10);
+        if (isNaN(node.maxDepth)) node.maxDepth = 1;
+
+        node._subscriptionId = null;
+        node._sseHandle = null;
+        node._pollTimer = null;
+        node._closing = false;
+
+        if (!bindServer(node, RED, config.server)) return;
+
+        async function setup() {
+            const client = node.server.client;
+            const ids = parseIds(node.elementIds);
+            if (ids.length === 0) {
+                node.status({ fill: "yellow", shape: "ring", text: "no element IDs" });
+                return;
+            }
+
+            node.status({ fill: "yellow", shape: "dot", text: "subscribing..." });
+
+            try {
+                const sub = await client.createSubscription();
+                node._subscriptionId = sub.subscriptionId;
+                await client.registerMonitoredItems(node._subscriptionId, ids, node.maxDepth);
+
+                if (node.mode === "sse") {
+                    startSSE(client);
+                } else {
+                    startPolling(client);
+                }
+            } catch (err) {
+                node.status({ fill: "red", shape: "ring", text: err.message.substring(0, 32) });
+                node.error("Subscription setup failed: " + err.message);
+
+                if (node.mode === "sse" && !node._closing) {
+                    node.warn("SSE setup failed, falling back to polling");
+                    fallbackToPolling(client, ids);
+                }
+            }
+        }
+
+        async function fallbackToPolling(client, ids) {
+            try {
+                if (!node._subscriptionId) {
+                    const sub = await client.createSubscription();
+                    node._subscriptionId = sub.subscriptionId;
+                    await client.registerMonitoredItems(node._subscriptionId, ids, node.maxDepth);
+                }
+                startPolling(client);
+            } catch (pollErr) {
+                node.status({ fill: "red", shape: "ring", text: "failed" });
+                node.error("Polling fallback also failed: " + pollErr.message);
+            }
+        }
+
+        function startSSE(client) {
+            node.status({ fill: "green", shape: "dot", text: "streaming (SSE)" });
+
+            node._sseHandle = client.streamSubscription(node._subscriptionId, {
+                onData: (event) => {
+                    if (node._closing) return;
+                    node.send({ payload: event, topic: "i3x/subscription" });
+                },
+                onError: (err) => {
+                    if (node._closing) return;
+                    node.status({ fill: "red", shape: "ring", text: "stream error" });
+                    node.error("SSE stream error: " + err.message);
+                },
+                onReconnect: (attempt) => {
+                    if (node._closing) return;
+                    node.status({ fill: "yellow", shape: "dot", text: "reconnecting (" + attempt + ")..." });
+                    node.warn("SSE stream reconnecting, attempt " + attempt);
+                },
+            });
+        }
+
+        function startPolling(client) {
+            node.status({ fill: "green", shape: "dot", text: "polling (" + node.pollingInterval + "ms)" });
+
+            async function poll() {
+                if (node._closing) return;
+                try {
+                    const data = await client.syncSubscription(node._subscriptionId);
+                    if (data && (Array.isArray(data) ? data.length > 0 : Object.keys(data).length > 0)) {
+                        node.send({ payload: data, topic: "i3x/subscription" });
+                    }
+                } catch (err) {
+                    if (!node._closing) {
+                        node.status({ fill: "red", shape: "ring", text: "poll error" });
+                        node.error("Polling error: " + err.message);
+                    }
+                }
+            }
+
+            poll();
+            node._pollTimer = setInterval(poll, node.pollingInterval);
+        }
+
+        async function teardown(done) {
+            node._closing = true;
+
+            if (node._pollTimer) {
+                clearInterval(node._pollTimer);
+                node._pollTimer = null;
+            }
+
+            if (node._sseHandle) {
+                node._sseHandle.close();
+                node._sseHandle = null;
+            }
+
+            if (node._subscriptionId && node.server && node.server.client) {
+                try {
+                    await node.server.client.deleteSubscription(node._subscriptionId);
+                } catch (_) {
+                    // best-effort cleanup
+                }
+                node._subscriptionId = null;
+            }
+
+            done();
+        }
+
+        if (node.server.connected) {
+            setup();
+        }
+        node.server.on("connected", () => {
+            if (!node._subscriptionId && !node._closing) {
+                setup();
+            }
+        });
+
+        node.on("close", teardown);
+    }
+
+    RED.nodes.registerType("i3x-subscribe", I3XSubscribeNode);
+};