@tier0/opcua-client 0.4.0 → 0.5.0

package/BENCHMARK.md

@@ -132,3 +132,30 @@ The same deployed Flow was tested with a separate native client generating the f
 Write CSV parsing was then changed from multiple whole-payload arrays and object copies to a single line scan that constructs compact final write descriptors. Two mixed Node-RED runs, each producing CSV and executing all 100,000 writes inside the Flow, recorded stable peaks of 226.73 MB and 226.06 MB. The immediately preceding fresh-process repeat peaked at 362.29 MB, so the repeatable peak reduction was approximately 37.6%. The optimized repeat recorded Write P50/P95 of 1,410/1,769 ms, delivered 120,000/120,000 native notifications with zero drops, and converged 20,000/20,000 final values. These are process-RSS engineering measurements; allocator and garbage-collector behavior still require production baselines on the target Node-RED image.
 
 The 20,000-point outage acceptance stopped and restarted the real OPC UA fixture after the initial four Subscriptions were created. The Subscribe node rebuilt exactly four Subscriptions with 20,000/20,000 MonitoredItems and zero failures. Two subsequent complete write rounds plus the rebuilt initial values delivered 60,000/60,000 native notifications with zero drops and final convergence for all 20,000 points. Recovery-phase RSS peaked at 175.04 MB and the complete run at 184.5 MB. The recovery status explicitly reported `rebuilt=true` and `dataGapPossible=true` because a server-side subscription rebuild cannot guarantee changes that occurred during the outage.
+
+## 0.5.0 knee-point benchmark
+
+Recorded on 2026-08-24 with Node-RED 4.1.10, Node.js 22.22.2, open62541 1.4.16, and package 0.5.0. Every tier used a fresh Node-RED process constrained to 2 vCPU and 2 GB. The server and clients used security mode `None` over container loopback. Service batches contained 500 nodes, each server Subscription contained at most 5,000 MonitoredItems, publishing and sampling intervals were 100 ms, and an independent native client changed every monitored value so the Node-RED Subscribe path could be measured without CSV construction in the Write node.
+
+| Points | Read P50 / P95 | External write P50 / P95 | Subscribe setup | Native notifications | Max callback lag | Node-RED peak RSS |
+| ---: | ---: | ---: | ---: | ---: | ---: | ---: |
+| 5,000 | 195 / 206 ms | 195 / 196 ms | 232 ms | 30,000, 0 dropped | 0.21 ms | 132.4 MB |
+| 10,000 | 411 / 467 ms | 392 / 396 ms | 475 ms | 60,000, 0 dropped | 1.00 ms | 153.4 MB |
+| 20,000 | 817 / 852 ms | 788 / 792 ms | 915 ms | 120,000, 0 dropped | 2.42 ms | 182.1 MB |
+| 30,000 | 1,263 / 1,274 ms | 1,208 / 1,219 ms | 1,523 ms | 180,000, 0 dropped | 2.18 ms | 194.4 MB |
+| 40,000 | 1,673 / 1,701 ms | 1,753 / 1,795 ms | 1,889 ms | 240,000, 0 dropped | 2.27 ms | 218.8 MB |
+| 60,000 | 2,521 / 2,556 ms | 2,590 / 2,641 ms | 2,860 ms | 360,000, 0 dropped | 5.07 ms | 261.3 MB |
+| 100,000 | 4,215 / 4,263 ms | 4,758 / 4,884 ms | 5,174 ms | 600,000, 0 dropped | 1.64 ms | 391.4 MB |
+| 150,000 | 6,353 / 6,470 ms | 8,045 / 8,137 ms | 7,582 ms | 600,000, 0 dropped | 27.53 ms | 463.2 MB |
+| 175,000 | 7,488 ms | 11,864 ms | 9,290 ms | 525,000, 0 dropped | 1.91 ms | 526.7 MB |
+| 200,000 | 8,485 / 8,663 ms | 42,410 / 43,425 ms | 10,968 ms | 800,000, 0 dropped | 1.73 ms | 564.0 MB |
+
+The 5,000 through 100,000 Read results remain close to 23,000-25,000 values per second. A one-second full-poll target therefore crosses its practical boundary between 20,000 and 30,000 points even though larger batches remain correct. Subscription creation stays near 18,000-22,000 MonitoredItems per second through 200,000 points.
+
+The coupled server/client system begins a soft knee around 150,000 monitored points. At that tier callback lag repeatedly reached about 27 ms and the default 100,000-entry NodeId cache started heavy eviction. Increasing the cache to 200,000 removed all evictions and improved Read P50 from 6,524 ms to 6,353 ms, but raised peak RSS from 425 MB to 463 MB and did not remove the callback-lag spike. Cache size is therefore a secondary tuning control, not the main scale limit.
+
+The sharp knee occurred between 175,000 and 200,000 monitored points. Increasing the point set by 14% increased one full write from about 11.9 seconds to 42.4 seconds. Node-RED still delivered all 800,000 native notifications with zero drops at 200,000 points, so the collapse occurred first in the open62541 server's processing of value changes under a very large monitored set, rather than in the Node-RED callback queue. A Siemens WinCC server can reach its own knee much earlier or later depending on licensed limits, Session and Subscription quotas, security, hardware, and project load.
+
+The editor Browse API intentionally caps one tree request at 100,000 total nodes. A namespace containing approximately 100,000 variables plus their Area objects therefore cannot be rendered as one complete selectable tree. Browse a narrower Area/root or import the point list instead of raising this UI protection.
+
+For production, keep a one-second full Read at or below roughly 20,000 points per Connection on equivalent hardware. For Subscribe, 50,000-60,000 monitored points per Connection is a conservative local-loopback engineering envelope with substantial margin below the observed system knee. Do not automatically add Sessions to exceed it: first verify the target server's Session, Subscription, MonitoredItem, publish, and sampling limits. Above 100,000 points, raise `nodeIdCacheSize` only with a corresponding memory budget and test the real server under the expected change rate and security policy.

package/README.md

@@ -39,6 +39,8 @@ Browse output can be wired directly into Read or Subscribe. In the Read and Writ
 
 Subscription commands are `replace`, `add`, `remove`, and `clear`. Read and Write split large arrays into configurable service batches; they do not loop over scalar OPC UA requests.
 
+Subscribe nodes can save or import their own point list and establish it automatically after deploy. Repeating an unchanged `replace` command preserves existing server Subscriptions and MonitoredItems. Only added, removed, or monitoring-parameter-changed points are reconciled. A rejected point is reported in `failures` without stopping valid points, and requested versus server-revised publishing, sampling, lifetime, keepalive, and queue settings are included in subscription status output.
+
 New Read nodes default to compact results: `nodeId`, optional `alias`, `value`,
 `statusCode`, and `sourceTimestamp`. Browse metadata and subscription-only point
 settings are not repeated on every Read. **Value only** emits an array in point-
@@ -107,6 +109,13 @@ Session is intentional. Read/Write diagnostics and subscription status outputs
 include `connectionGovernance`, with the equivalent and active configuration
 counts.
 
+`connectionUsage` reports the current Read/Write/Browse/Subscribe consumer count
+and types, each consumer's last use, aggregate operation counts, and connection
+idle time. It is diagnostic only: `automaticIdleDisconnect` is false. A deployed
+Connection therefore remains stable for subscriptions until its configuration
+node is closed; deleting the last referencing flow is visible as a zero consumer
+count but does not race an idle timer.
+
 ## Connection and subscription recovery
 
 The native client reports secure-channel, session, connectivity-check, and subscription-inactivity transitions to a JavaScript connection supervisor. Recoverable channel interruptions keep the native client alive. Terminal failures replace the native client and retry with exponential backoff, 20% jitter, and the configured maximum interval. Operations fail fast with `OPCUA_RECONNECTING` while the connection is unavailable instead of building an unbounded request queue.
@@ -137,6 +146,12 @@ message or Write node identifies one target NodeId. A configured single
 `useInput` point behaves the same way. Set `msg.opcua.pointList = true` only when
 an array payload must be forced to mean a dynamic list of point descriptors.
 
+OPC UA Int64 and UInt64 values inside the JavaScript safe-integer range are
+returned as Numbers. Larger values are returned as exact decimal strings so
+totals and counters never silently lose precision. Use decimal strings for
+64-bit writes; unsafe Numbers, fractional integers, and values outside the OPC UA
+type range are rejected before a service request.
+
 ```json
 {
   "topic": "ns=2;s=Recipe.Steps",
@@ -154,6 +169,13 @@ The Browse editor loads the address space through the deployed Connection node.
 
 The selected Variable descriptors are saved with the Browse node. Each input message outputs the full saved selection so it can be wired directly into Read or Subscribe. Send `msg.opcua.liveBrowse = true` when a flow needs to ignore the saved selection and perform a new live Browse.
 
+Recursive Browse requests batch multiple parent nodes and honor the server's
+`MaxNodesPerBrowse` OperationLimit. `Browse batch` and `References / page` bound
+each request. If `Maximum depth` or `Maximum nodes` truncates a live Browse,
+`msg.opcua.browse.truncated` and `truncationReason` make the partial result
+explicit. Unused server ContinuationPoints are released before the operation
+finishes.
+
 Node editors show only the standard settings by default. Connection security/timeouts/cache, Browse limits/paging, Read/Write batching/output, and Subscribe queue/deadband tuning remain available under a closed **Advanced settings** section. Existing flows retain their stored advanced values.
 
 ## Secure connections
@@ -190,7 +212,7 @@ Node-RED Alpine image, the pinned open62541 v1.4.16 source archive, and its
 not contact npm or GitHub and does not invoke a compiler:
 
 ```bash
-npm install ./tier0-opcua-client-0.4.0.tgz --offline
+npm install ./tier0-opcua-client-0.5.0.tgz --offline
 ```
 
 The loader uses the bundled native addon directly. Set
@@ -207,6 +229,11 @@ npm run build:offline-prebuild -- --nodedir=/usr/local
 npm pack
 ```
 
+Before publishing, `npm run test:release` runs the JavaScript, native, offline
+runtime, and deployed Node-RED suites when their test Server and Node-RED runtime
+are available. `npm pack` also reruns the JavaScript suite and rejects an
+incomplete offline package.
+
 See `THIRD_PARTY_NOTICES.md` for the bundled open62541 and node-addon-api
 licenses.
 

package/lib/client.js

@@ -164,7 +164,28 @@ class OpcUaClient extends EventEmitter {
   }
 
   async browse(options) {
-    return this.#invoke('browseAsync', options);
+    const items = await this.#invoke('browseAsync', options);
+    const browse = {
+      truncated: Boolean(items?.truncated),
+      truncationReason: items?.truncationReason || null,
+      serviceCalls: Number(items?.serviceCalls) || 0,
+      browseBatchSize: Number(items?.browseBatchSize) || 1,
+      releasedContinuationPoints: Number(items?.releasedContinuationPoints) || 0,
+      failures: Array.isArray(items?.browseFailures) ? items.browseFailures : [],
+    };
+    this.diagnostics.browse = browse;
+    if (Array.isArray(items)) {
+      for (const field of [
+        'truncated', 'truncationReason', 'serviceCalls', 'browseBatchSize',
+        'releasedContinuationPoints', 'browseFailures',
+      ]) delete items[field];
+      Object.defineProperty(items, 'diagnostics', {
+        configurable: true,
+        enumerable: false,
+        value: browse,
+      });
+    }
+    return items;
   }
 
   async readMany(points, batchSize = 500) {
@@ -248,6 +269,7 @@ class OpcUaClient extends EventEmitter {
       const nativeDiagnostics = addon.getClientDiagnostics(this.handle) || {};
       this.diagnostics = {
         ...nativeDiagnostics,
+        browse: this.diagnostics.browse,
         connection: {
           ...(nativeDiagnostics.connection || {}),
           supervisor: { ...this.supervisorDiagnostics },

package/lib/points.js

@@ -6,6 +6,17 @@ const DEFAULTS = Object.freeze({
   discardOldest: true,
 });
 
+const INTEGER_RANGES = Object.freeze({
+  SByte: [-128n, 127n],
+  Byte: [0n, 255n],
+  Int16: [-32768n, 32767n],
+  UInt16: [0n, 65535n],
+  Int32: [-2147483648n, 2147483647n],
+  UInt32: [0n, 4294967295n],
+  Int64: [-9223372036854775808n, 9223372036854775807n],
+  UInt64: [0n, 18446744073709551615n],
+});
+
 function positiveNumber(value, fallback) {
   const number = Number(value);
   return Number.isFinite(number) && number > 0 ? number : fallback;
@@ -245,15 +256,39 @@ function messagePoints(msg, staticNodeId, defaults = {}, options = {}) {
 }
 
 function coerceWriteValue(value, dataType) {
-  if (value == null || typeof value !== 'string') return value;
   const type = String(dataType || 'String');
+  if (Array.isArray(value)) {
+    return value.map((item) => coerceWriteValue(item, type));
+  }
+  if (value == null) return value;
   if (type === 'Boolean') {
-    if (/^(true|1)$/i.test(value)) return true;
-    if (/^(false|0)$/i.test(value)) return false;
+    if (typeof value === 'boolean') return value;
+    if (/^(true|1)$/i.test(String(value))) return true;
+    if (/^(false|0)$/i.test(String(value))) return false;
     throw new Error(`Invalid Boolean value: ${value}`);
   }
-  if (/^(S?Byte|U?Int(16|32|64)|Float|Double)$/.test(type)) {
-    const number = Number(value);
+  if (Object.prototype.hasOwnProperty.call(INTEGER_RANGES, type)) {
+    let integer;
+    if (typeof value === 'bigint') integer = value;
+    else if (typeof value === 'number') {
+      if (!Number.isSafeInteger(value)) {
+        throw new Error(`Invalid ${type} value: ${value}; use a decimal string for 64-bit integers`);
+      }
+      integer = BigInt(value);
+    } else if (typeof value === 'string' && /^-?\d+$/.test(value.trim())) {
+      integer = BigInt(value.trim());
+    } else throw new Error(`Invalid ${type} value: ${value}`);
+    const [minimum, maximum] = INTEGER_RANGES[type];
+    if (integer < minimum || integer > maximum) {
+      throw new Error(`Invalid ${type} value: ${value}; outside OPC UA range`);
+    }
+    if (type === 'Int64' || type === 'UInt64') {
+      return typeof value === 'number' ? value : integer.toString();
+    }
+    return Number(integer);
+  }
+  if (type === 'Float' || type === 'Double') {
+    const number = typeof value === 'number' ? value : Number(value);
     if (!Number.isFinite(number)) throw new Error(`Invalid ${type} value: ${value}`);
     return number;
   }

package/nodes/browse.html

@@ -36,6 +36,8 @@
     <div class="form-row"><label for="node-input-variablesOnly">Variables only</label><input type="checkbox" id="node-input-variablesOnly" style="width:auto"></div>
     <div class="form-row"><label for="node-input-maxDepth">Maximum depth</label><input type="number" id="node-input-maxDepth"></div>
     <div class="form-row"><label for="node-input-maxNodes">Maximum nodes</label><input type="number" id="node-input-maxNodes"></div>
+    <div class="form-row"><label for="node-input-browseBatchSize">Browse batch</label><input type="number" id="node-input-browseBatchSize"></div>
+    <div class="form-row"><label for="node-input-referencesPerNode">References / page</label><input type="number" id="node-input-referencesPerNode"></div>
     <div class="form-row"><label for="node-input-attributeBatchSize">Attribute batch</label><input type="number" id="node-input-attributeBatchSize"></div>
     <div class="form-row"><label for="node-input-outputMode">Output</label><select id="node-input-outputMode"><option value="all">All selected points</option><option value="paged">Paged selected points</option></select></div>
     <div class="form-row"><label for="node-input-pageSize">Page size</label><input type="number" id="node-input-pageSize"></div>
@@ -54,7 +56,7 @@
       <li><code>msg.nodeId</code> 或 <code>msg.topic</code> 可覆盖根 NodeId；默认根节点为 ObjectsFolder。</li>
     </ul>
     <h4>输出</h4>
-    <p><code>msg.payload</code> 是点位描述数组，包含 NodeId、名称、Browse 路径、数据类型和访问属性，可直接连接 Read 或 Subscribe。Paged 模式会分批输出，并通过 <code>msg.opcua.command</code> 标记 replace/add。</p>
+    <p><code>msg.payload</code> 是点位描述数组，包含 NodeId、名称、Browse 路径、数据类型和访问属性，可直接连接 Read 或 Subscribe。Paged 模式会分批输出，并通过 <code>msg.opcua.command</code> 标记 replace/add。浏览被最大深度或节点数截断时，<code>msg.opcua.browse.truncated</code> 为 true；节点会释放未使用的 ContinuationPoint。</p>
   </section>
   <hr>
   <section lang="en">
@@ -68,7 +70,7 @@
       <li><code>msg.nodeId</code> or <code>msg.topic</code> can override the root NodeId; the default root is ObjectsFolder.</li>
     </ul>
     <h4>Output</h4>
-    <p><code>msg.payload</code> is an array of point descriptors containing NodeId, names, Browse path, data type, and access attributes. It can feed Read or Subscribe directly. Paged mode emits multiple messages with replace/add in <code>msg.opcua.command</code>.</p>
+    <p><code>msg.payload</code> is an array of point descriptors containing NodeId, names, Browse path, data type, and access attributes. It can feed Read or Subscribe directly. Paged mode emits multiple messages with replace/add in <code>msg.opcua.command</code>. When maximum depth or node count truncates a Browse, <code>msg.opcua.browse.truncated</code> is true; unused ContinuationPoints are released.</p>
   </section>
 </script>
 <script type="text/javascript">
@@ -78,6 +80,8 @@
       connection: { value: '', type: 'tier0-opcua-connection', required: true }, rootNodeId: { value: 'ns=0;i=85' },
       selectedNodes: { value: [] }, recursive: { value: true }, variablesOnly: { value: true },
       maxDepth: { value: 10, validate: RED.validators.number() }, maxNodes: { value: 10000, validate: RED.validators.number() },
+      browseBatchSize: { value: 100, validate: RED.validators.number() },
+      referencesPerNode: { value: 1000, validate: RED.validators.number() },
       attributeBatchSize: { value: 200, validate: RED.validators.number() }, outputMode: { value: 'all' },
       pageSize: { value: 500, validate: RED.validators.number() }, name: { value: '' }
     },
@@ -240,6 +244,8 @@
             rootNodeId: $('#node-input-rootNodeId').val() || 'ns=0;i=85',
             maxDepth: $('#node-input-maxDepth').val(),
             maxNodes: $('#node-input-maxNodes').val(),
+            browseBatchSize: $('#node-input-browseBatchSize').val(),
+            referencesPerNode: $('#node-input-referencesPerNode').val(),
             attributeBatchSize: $('#node-input-attributeBatchSize').val()
           })
         }).done((data) => {
@@ -248,6 +254,11 @@
             return;
           }
           renderTree(data.tree);
+          if (data.truncated) {
+            statusArea.text(`${data.total} node(s) loaded; truncated by ${data.truncationReason || 'server limit'}.`);
+          } else if (Array.isArray(data.failures) && data.failures.length) {
+            statusArea.text(`${data.total} node(s) loaded; ${data.failures.length} branch(es) failed.`);
+          }
         }).fail((request) => {
           const message = request.responseJSON && request.responseJSON.error || request.responseText || 'Browse failed';
           statusArea.text(message);

package/nodes/browse.js

@@ -36,16 +36,22 @@ module.exports = function registerBrowseNode(RED) {
 
       activeEditorBrowses.add(connectionId);
       try {
+        connection.markUsed?.('editor-browse');
         const items = await connection.client.browse({
           rootNodeId,
           recursive: true,
           variablesOnly: false,
           maxDepth: positiveInteger(body.maxDepth, 10, 50),
           maxNodes: positiveInteger(body.maxNodes, 10000, 100000),
+          browseBatchSize: positiveInteger(body.browseBatchSize, 100, 5000),
+          referencesPerNode: positiveInteger(body.referencesPerNode, 1000, 10000),
           attributeBatchSize: positiveInteger(body.attributeBatchSize, 200, 5000),
         });
         const tree = buildBrowseTree(items, rootNodeId);
-        res.send({ tree, total: items.length, rootNodeId });
+        res.send({
+          tree, total: items.length, rootNodeId,
+          ...(items.diagnostics || {}),
+        });
       } catch (error) {
         const status = error?.code === 'OPCUA_RECONNECTING' ? 503 : 500;
         res.status(status).send({ error: error.message || String(error) });
@@ -59,11 +65,15 @@ module.exports = function registerBrowseNode(RED) {
     RED.nodes.createNode(this, config);
     const node = this;
     node.connection = RED.nodes.getNode(config.connection);
+    const consumer = node.connection?.registerConsumer?.('browse', {
+      nodeId: config.id, name: config.name,
+    });
 
     node.on('input', async (msg, send, done) => {
       if (!node.connection) return done(new Error('OPC UA connection not configured'));
 
       try {
+        consumer?.markUsed('browse');
         const rootNodeId = msg.nodeId || msg.topic || config.rootNodeId || 'ns=0;i=85';
         node.status({ fill: 'blue', shape: 'dot', text: 'browsing' });
         const configuredSelection = selectedVariables(config.selectedNodes);
@@ -75,8 +85,11 @@ module.exports = function registerBrowseNode(RED) {
             maxNodes: Number(config.maxNodes) || 10000,
             variablesOnly: config.variablesOnly !== false,
             namespaceIndexes: msg.opcua?.namespaceIndexes || [],
+            browseBatchSize: Number(config.browseBatchSize) || 100,
+            referencesPerNode: Number(config.referencesPerNode) || 1000,
             attributeBatchSize: Number(config.attributeBatchSize) || 200,
           });
+        const browseDiagnostics = useSelection ? null : points.diagnostics || null;
 
         const outputMode = config.outputMode || 'all';
         if (outputMode === 'paged') {
@@ -93,6 +106,7 @@ module.exports = function registerBrowseNode(RED) {
               pages: pages.length,
               done: index === pages.length - 1,
               total: points.length,
+              ...(browseDiagnostics ? { browse: browseDiagnostics } : {}),
             },
           }));
         } else {
@@ -104,17 +118,30 @@ module.exports = function registerBrowseNode(RED) {
             rootNodeId,
             done: true,
             total: points.length,
+            ...(browseDiagnostics ? { browse: browseDiagnostics } : {}),
           };
           send(msg);
         }
 
-        node.status({ fill: 'green', shape: 'dot', text: `${points.length} points` });
+        const partial = browseDiagnostics?.truncated || browseDiagnostics?.failures?.length;
+        node.status({
+          fill: partial ? 'yellow' : 'green', shape: partial ? 'ring' : 'dot',
+          text: `${points.length} points` +
+            (browseDiagnostics?.truncated
+              ? ` / truncated: ${browseDiagnostics.truncationReason}` : ''),
+        });
         done();
       } catch (error) {
         node.status({ fill: 'red', shape: 'ring', text: error.message });
         done(error);
       }
     });
+
+    node.on('close', (removed, done) => {
+      if (typeof removed === 'function') done = removed;
+      consumer?.release();
+      done?.();
+    });
   }
 
   RED.nodes.registerType('tier0-opcua-browse', OpcUaBrowseNode);

package/nodes/connection.js

@@ -126,6 +126,58 @@ module.exports = function registerConnectionNode(RED) {
   function OpcUaConnectionNode(config) {
     RED.nodes.createNode(this, config);
     const node = this;
+    const dependentCleanups = new Set();
+    const consumers = new Map();
+    const operations = new Map();
+    let nextConsumerId = 1;
+    let lastUsedAt = null;
+    let totalOperations = 0;
+
+    function markUsed(operation = 'unknown', consumer) {
+      const now = Date.now();
+      const name = String(operation || 'unknown');
+      lastUsedAt = now;
+      totalOperations += 1;
+      operations.set(name, (operations.get(name) || 0) + 1);
+      if (consumer && consumers.has(consumer.id)) {
+        consumer.lastUsedAt = now;
+        consumer.operations += 1;
+      }
+    }
+
+    function connectionUsage() {
+      const consumerTypes = {};
+      for (const consumer of consumers.values()) {
+        consumerTypes[consumer.type] = (consumerTypes[consumer.type] || 0) + 1;
+      }
+      return {
+        consumerCount: consumers.size,
+        consumerTypes,
+        consumers: [...consumers.values()].map((consumer) => ({
+          id: consumer.nodeId || consumer.id,
+          type: consumer.type,
+          name: consumer.name || '',
+          registeredAt: new Date(consumer.registeredAt).toISOString(),
+          lastUsedAt: consumer.lastUsedAt == null
+            ? null : new Date(consumer.lastUsedAt).toISOString(),
+          operations: consumer.operations,
+        })),
+        lastUsedAt: lastUsedAt == null ? null : new Date(lastUsedAt).toISOString(),
+        idleMs: lastUsedAt == null ? null : Math.max(0, Date.now() - lastUsedAt),
+        totalOperations,
+        operations: Object.fromEntries(operations),
+        automaticIdleDisconnect: false,
+      };
+    }
+
+    function runDependentCleanup(record) {
+      if (!record.promise) {
+        record.promise = Promise.resolve()
+          .then(record.cleanup)
+          .finally(() => dependentCleanups.delete(record));
+      }
+      return record.promise;
+    }
 
     const options = clientOptions(config, node.credentials);
     const registration = connectionRegistry.register(options);
@@ -137,7 +189,41 @@ module.exports = function registerConnectionNode(RED) {
     node.getDiagnostics = () => ({
       ...node.client.getDiagnostics(),
       connectionGovernance: node.getConnectionGovernance(),
+      connectionUsage: connectionUsage(),
     });
+    node.getConnectionUsage = connectionUsage;
+    node.markUsed = (operation) => markUsed(operation);
+    node.registerConsumer = (type, details = {}) => {
+      const consumer = {
+        id: nextConsumerId++,
+        nodeId: String(details.nodeId || ''),
+        name: String(details.name || ''),
+        type: String(type || 'unknown'),
+        registeredAt: Date.now(),
+        lastUsedAt: null,
+        operations: 0,
+      };
+      consumers.set(consumer.id, consumer);
+      let released = false;
+      return {
+        markUsed(operation) {
+          if (!released) markUsed(operation || consumer.type, consumer);
+        },
+        release() {
+          if (released) return;
+          released = true;
+          consumers.delete(consumer.id);
+        },
+      };
+    };
+    node.registerDependentCleanup = (cleanup) => {
+      if (typeof cleanup !== 'function') {
+        throw new TypeError('OPC UA dependent cleanup must be a function');
+      }
+      const record = { cleanup, promise: null };
+      dependentCleanups.add(record);
+      return () => runDependentCleanup(record);
+    };
 
     if (registration.duplicate && config.allowParallelSession !== true) {
       node.warn(
@@ -161,6 +247,15 @@ module.exports = function registerConnectionNode(RED) {
       node.client.off('fault', onFault);
       node.client.off('state', onState);
       registration.unregister();
+      const cleanupResults = await Promise.allSettled(
+        [...dependentCleanups].map(runDependentCleanup)
+      );
+      for (const result of cleanupResults) {
+        if (result.status === 'rejected') {
+          node.warn(`OPC UA dependent cleanup failed: ${result.reason?.message || result.reason}`);
+        }
+      }
+      consumers.clear();
       try {
         await node.client.disconnect();
       } catch (error) {

package/nodes/read.html

@@ -60,6 +60,7 @@
       <li><b>Value only</b>：批量时按点表顺序输出值数组，单点时输出标量。</li>
       <li><b>Full metadata</b>：同时输出完整点表描述和客户端诊断，适合排障。</li>
     </ul>
+    <p>Int64/UInt64 超出 JavaScript 安全整数范围时以十进制字符串输出，避免累计量和计数器精度丢失。</p>
     <p>大点表会按照 Batch size 和服务器 OperationLimits 自动拆分为批量服务请求，不会逐点建立连接。</p>
   </section>
   <hr>
@@ -79,6 +80,7 @@
       <li><b>Value only</b>: A value array in point-list order for batch reads, or a scalar for one point.</li>
       <li><b>Full metadata</b>: Full point descriptors and client diagnostics for troubleshooting.</li>
     </ul>
+    <p>Int64/UInt64 values outside the JavaScript safe-integer range are emitted as decimal strings to preserve exact counters and totals.</p>
     <p>Large point lists are split according to Batch size and server OperationLimits. The node does not create one connection per point.</p>
   </section>
 </script>

package/nodes/read.js

@@ -27,11 +27,15 @@ module.exports = function registerReadNode(RED) {
     RED.nodes.createNode(this, config);
     const node = this;
     node.connection = RED.nodes.getNode(config.connection);
+    const consumer = node.connection?.registerConsumer?.('read', {
+      nodeId: config.id, name: config.name,
+    });
 
     node.on('input', async (msg, send, done) => {
       if (!node.connection) return done(new Error('OPC UA connection not configured'));
 
       try {
+        consumer?.markUsed('read');
         const points = messagePoints(msg, config.nodeId, {
           indexRange: config.indexRange,
         }, {
@@ -99,6 +103,12 @@ module.exports = function registerReadNode(RED) {
         done(error);
       }
     });
+
+    node.on('close', (removed, done) => {
+      if (typeof removed === 'function') done = removed;
+      consumer?.release();
+      done?.();
+    });
   }
 
   RED.nodes.registerType('tier0-opcua-read', OpcUaReadNode);