@ya-modbus/transport 0.12.0 → 0.12.1

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.12.1](https://github.com/groupsky/ya-modbus/compare/@ya-modbus/transport@0.12.0...@ya-modbus/transport@0.12.1) (2026-10-14)
+
+### Bug Fixes
+
+- exclude Node.js 26.4+ in engines and warn about it for serial devices ([#636](https://github.com/groupsky/ya-modbus/issues/636)) ([8c46664](https://github.com/groupsky/ya-modbus/commit/8c46664bdffd90181e6dad4fb6a7fc31ef9fdcc0)), closes [#622](https://github.com/groupsky/ya-modbus/issues/622)
+
 # [0.12.0](https://github.com/groupsky/ya-modbus/compare/@ya-modbus/transport@0.11.2...@ya-modbus/transport@0.12.0) (2026-10-12)
 
 ### Features

package/dist/cjs/src/index.d.ts

@@ -14,5 +14,6 @@ export { isConnectionLostError, ModbusConnection, type OpenClient } from './conn
 export { TransportManager, type TransportManagerOptions, type TransportStats } from './manager.js';
 export { MutexTransport } from './mutex-transport.js';
 export { SlaveTransport } from './slave-transport.js';
+export { getSerialNodeWarning } from './serial-node-warning.js';
 export { listSerialPorts, matchSerialPorts, type SerialPortInfo, type SerialPortMatch, } from './serial-ports.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC1F,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC1F,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAA"}

package/dist/cjs/src/index.js

@@ -6,7 +6,7 @@
  * and transport pooling with mutex-based RTU bus serialization
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.matchSerialPorts = exports.listSerialPorts = exports.SlaveTransport = exports.MutexTransport = exports.TransportManager = exports.ModbusConnection = exports.isConnectionLostError = exports.normalizeModbusError = exports.RETRY_DELAY_MS = exports.MAX_RETRIES = exports.withRetry = exports.createModbusTransport = exports.createTCPTransport = exports.createRTUTransport = exports.createTransport = void 0;
+exports.matchSerialPorts = exports.listSerialPorts = exports.getSerialNodeWarning = exports.SlaveTransport = exports.MutexTransport = exports.TransportManager = exports.ModbusConnection = exports.isConnectionLostError = exports.normalizeModbusError = exports.RETRY_DELAY_MS = exports.MAX_RETRIES = exports.withRetry = exports.createModbusTransport = exports.createTCPTransport = exports.createRTUTransport = exports.createTransport = void 0;
 var factory_js_1 = require("./factory.js");
 Object.defineProperty(exports, "createTransport", { enumerable: true, get: function () { return factory_js_1.createTransport; } });
 var rtu_transport_js_1 = require("./rtu-transport.js");
@@ -30,6 +30,8 @@ var mutex_transport_js_1 = require("./mutex-transport.js");
 Object.defineProperty(exports, "MutexTransport", { enumerable: true, get: function () { return mutex_transport_js_1.MutexTransport; } });
 var slave_transport_js_1 = require("./slave-transport.js");
 Object.defineProperty(exports, "SlaveTransport", { enumerable: true, get: function () { return slave_transport_js_1.SlaveTransport; } });
+var serial_node_warning_js_1 = require("./serial-node-warning.js");
+Object.defineProperty(exports, "getSerialNodeWarning", { enumerable: true, get: function () { return serial_node_warning_js_1.getSerialNodeWarning; } });
 var serial_ports_js_1 = require("./serial-ports.js");
 Object.defineProperty(exports, "listSerialPorts", { enumerable: true, get: function () { return serial_ports_js_1.listSerialPorts; } });
 Object.defineProperty(exports, "matchSerialPorts", { enumerable: true, get: function () { return serial_ports_js_1.matchSerialPorts; } });

package/dist/cjs/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,2CAAoE;AAA3D,6GAAA,eAAe,OAAA;AACxB,uDAAuE;AAA9D,sHAAA,kBAAkB,OAAA;AAC3B,uDAAuE;AAA9D,sHAAA,kBAAkB,OAAA;AAC3B,2EAAoE;AAA3D,mIAAA,qBAAqB,OAAA;AAC9B,uCAAqF;AAA5E,qGAAA,SAAS,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,0GAAA,cAAc,OAAA;AAC/C,2DAA6E;AAApE,0HAAA,oBAAoB,OAAA;AAC7B,iDAA0F;AAAjF,sHAAA,qBAAqB,OAAA;AAAE,iHAAA,gBAAgB,OAAA;AAChD,2CAAkG;AAAzF,8GAAA,gBAAgB,OAAA;AACzB,2DAAqD;AAA5C,oHAAA,cAAc,OAAA;AACvB,2DAAqD;AAA5C,oHAAA,cAAc,OAAA;AACvB,qDAK0B;AAJxB,kHAAA,eAAe,OAAA;AACf,mHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,2CAAoE;AAA3D,6GAAA,eAAe,OAAA;AACxB,uDAAuE;AAA9D,sHAAA,kBAAkB,OAAA;AAC3B,uDAAuE;AAA9D,sHAAA,kBAAkB,OAAA;AAC3B,2EAAoE;AAA3D,mIAAA,qBAAqB,OAAA;AAC9B,uCAAqF;AAA5E,qGAAA,SAAS,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,0GAAA,cAAc,OAAA;AAC/C,2DAA6E;AAApE,0HAAA,oBAAoB,OAAA;AAC7B,iDAA0F;AAAjF,sHAAA,qBAAqB,OAAA;AAAE,iHAAA,gBAAgB,OAAA;AAChD,2CAAkG;AAAzF,8GAAA,gBAAgB,OAAA;AACzB,2DAAqD;AAA5C,oHAAA,cAAc,OAAA;AACvB,2DAAqD;AAA5C,oHAAA,cAAc,OAAA;AACvB,mEAA+D;AAAtD,8HAAA,oBAAoB,OAAA;AAC7B,qDAK0B;AAJxB,kHAAA,eAAe,OAAA;AACf,mHAAA,gBAAgB,OAAA"}

package/dist/cjs/src/serial-node-warning.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Get the warning for Node.js versions on which serial (RTU) requests time out
+ *
+ * Since Node.js 26.4.0, Node does not run pending promise work after a native addon calls
+ * into JavaScript without `MakeCallback` (nodejs/node#66158). The serialport poller does
+ * that, so received data waits and the request times out (serialport/bindings-cpp#239).
+ * Modbus TCP is not affected.
+ *
+ * @param nodeVersion - Node.js version as in `process.version` ('v26.4.0') or
+ *   `process.versions.node` ('26.4.0')
+ * @returns The warning text, or undefined when serial requests work on this version
+ */
+export declare function getSerialNodeWarning(nodeVersion: string): string | undefined;
+//# sourceMappingURL=serial-node-warning.d.ts.map

package/dist/cjs/src/serial-node-warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serial-node-warning.d.ts","sourceRoot":"","sources":["../../../src/serial-node-warning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ5E"}

package/dist/cjs/src/serial-node-warning.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSerialNodeWarning = getSerialNodeWarning;
+/**
+ * Get the warning for Node.js versions on which serial (RTU) requests time out
+ *
+ * Since Node.js 26.4.0, Node does not run pending promise work after a native addon calls
+ * into JavaScript without `MakeCallback` (nodejs/node#66158). The serialport poller does
+ * that, so received data waits and the request times out (serialport/bindings-cpp#239).
+ * Modbus TCP is not affected.
+ *
+ * @param nodeVersion - Node.js version as in `process.version` ('v26.4.0') or
+ *   `process.versions.node` ('26.4.0')
+ * @returns The warning text, or undefined when serial requests work on this version
+ */
+function getSerialNodeWarning(nodeVersion) {
+    const [major, minor] = nodeVersion.replace(/^v/, '').split('.').map(Number);
+    if (major < 26 || (major === 26 && minor < 4))
+        return undefined;
+    return (`Warning: on Node.js 26.4 and newer, serial (RTU) requests time out (this is Node.js ${nodeVersion}). ` +
+        'Use Node.js 22 or 24. See https://github.com/groupsky/ya-modbus/issues/507');
+}
+//# sourceMappingURL=serial-node-warning.js.map

package/dist/cjs/src/serial-node-warning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serial-node-warning.js","sourceRoot":"","sources":["../../../src/serial-node-warning.ts"],"names":[],"mappings":";;AAYA,oDAQC;AApBD;;;;;;;;;;;GAWG;AACH,SAAgB,oBAAoB,CAAC,WAAmB;IACtD,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAqB,CAAA;IAC/F,IAAI,KAAK,GAAG,EAAE,IAAI,CAAC,KAAK,KAAK,EAAE,IAAI,KAAK,GAAG,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IAE/D,OAAO,CACL,uFAAuF,WAAW,KAAK;QACvG,4EAA4E,CAC7E,CAAA;AACH,CAAC"}