@ya-modbus/transport 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [0.10.0](https://github.com/groupsky/ya-modbus/compare/@ya-modbus/transport@0.9.1...@ya-modbus/transport@0.10.0) (2026-10-12)
+
+### Features
+
+- **transport:** survive a lost serial port and reopen it after a backoff ([#549](https://github.com/groupsky/ya-modbus/issues/549)) ([b5b3e34](https://github.com/groupsky/ya-modbus/commit/b5b3e34e3f219b6600cd975f98680adebafe3093)), closes [#517](https://github.com/groupsky/ya-modbus/issues/517)
+
+## [0.9.1](https://github.com/groupsky/ya-modbus/compare/@ya-modbus/transport@0.9.0...@ya-modbus/transport@0.9.1) (2026-10-12)
+
+### Bug Fixes
+
+- **transport:** make Modbus TCP work from the CLI and profiler ([#542](https://github.com/groupsky/ya-modbus/issues/542)) ([2aa24ac](https://github.com/groupsky/ya-modbus/commit/2aa24ac1753416c261d05bb8b8b12fccbc10e3e4))
+
 # [0.9.0](https://github.com/groupsky/ya-modbus/compare/@ya-modbus/transport@0.8.1...@ya-modbus/transport@0.9.0) (2026-10-12)
 
 - feat!: drop Node.js 20 support (#516) ([70002ab](https://github.com/groupsky/ya-modbus/commit/70002ab28155432e0984c67a70d1469fc5be7cb3)), closes [#516](https://github.com/groupsky/ya-modbus/issues/516)

package/README.md

@@ -7,6 +7,7 @@ Modbus transport implementations for RTU (serial) and TCP connections.
 - RTU (RS-485/serial) transport
 - TCP/IP transport
 - Automatic retry on transient failures
+- Survives a lost port (unplugged USB adapter) and opens it again
 - Factory for auto-detecting transport type
 - TypeScript support
 
@@ -69,6 +70,73 @@ try {
 
 `normalizeModbusError(error)` applies the same conversion to any caught value.
 
+### Lost connections
+
+When a USB serial adapter is unplugged or a TCP connection closes, `modbus-serial` emits a
+`close` event, and an `error` event when a write fails. The transports listen for these events,
+so the process does not crash. The connection is then lost:
+
+- A request in flight rejects at once. It does not wait for the response timeout.
+- Later requests reject at once, without using the port.
+- The error has the name `ConnectionLostError` and a message like
+  `Connection to /dev/ttyUSB0 lost: port closed`, or
+  `Connection to /dev/ttyUSB0 lost: EIO: i/o error, write` when a write failed. The underlying
+  error is in `cause`. `code` and `errno` are set only when the underlying error is a Node.js
+  system error, for example `ECONNREFUSED` when a TCP connection cannot be opened again.
+
+After a TCP socket error, `modbus-serial` emits no event. The next request fails with the error of
+`modbus-serial` (for example `Port Not Open`), and the connection is lost from then on.
+
+`createTransport` and `TransportManager` open the port again on a later request. There are no
+attempts in the background. The first request 1 second after the loss opens the port again. If
+this fails, the next attempt waits 2 seconds, then 4 seconds, and so on, up to 60 seconds.
+Requests between the attempts reject with the last error. The delay also doubles when the port
+opens but is lost again before a request succeeds. A successful request sets the delay back to
+1 second. `TransportManager` opens one new client for all devices on the bus.
+
+A short-lived program, like a CLI command, can stop at the first `ConnectionLostError`.
+
+```typescript
+import { isConnectionLostError } from '@ya-modbus/transport'
+
+try {
+  await transport.readHoldingRegisters(0, 10)
+} catch (error) {
+  if (isConnectionLostError(error)) {
+    // port is gone, the transport opens it again on a later request
+  }
+}
+```
+
+A USB adapter can get a new name when it is plugged in again (`/dev/ttyUSB0` becomes
+`/dev/ttyUSB1`), but the port is opened again with the same path. Use a stable path:
+
+- `/dev/serial/by-id/...` for adapters with a unique serial number.
+- `/dev/serial/by-path/...` for adapters without a serial number (many CH340 adapters). This name
+  is the physical USB port, so it changes when the adapter moves to another USB port.
+
+To use your own `modbus-serial` client with the same handling, wrap it in a `ModbusConnection`:
+
+```typescript
+import { createModbusTransport, ModbusConnection, type OpenClient } from '@ya-modbus/transport'
+import ModbusRTU from 'modbus-serial'
+
+// Returns a new connected client
+const open: OpenClient = async () => {
+  const client = new ModbusRTU()
+  await client.connectRTUBuffered('/dev/ttyUSB0', { baudRate: 9600 })
+  client.setID(1)
+  client.setTimeout(1000)
+  return client
+}
+
+const connection = new ModbusConnection(await open(), '/dev/ttyUSB0', open)
+const transport = createModbusTransport(connection)
+```
+
+Without the `open` function, a lost connection works again only when you open the same client
+again.
+
 ## License
 
 GPL-3.0-or-later

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

@@ -0,0 +1,90 @@
+/**
+ * Detection of lost connections and reopening of modbus-serial clients
+ */
+import type ModbusRTU from 'modbus-serial';
+import { type ModbusError } from './normalize-error.js';
+/** Delay before the first attempt to reopen a lost connection, in milliseconds */
+export declare const REOPEN_DELAY_MS = 1000;
+/** Longest delay between attempts to reopen a lost connection, in milliseconds */
+export declare const MAX_REOPEN_DELAY_MS = 60000;
+/**
+ * Opens a new connected and configured client
+ */
+export type OpenClient = () => Promise<ModbusRTU>;
+/**
+ * Check if an error means that the connection is lost (see ModbusConnection)
+ *
+ * @param error - Value that was thrown or used to reject a promise
+ * @returns True for a ConnectionLostError
+ */
+export declare function isConnectionLostError(error: unknown): error is ModbusError;
+/** Marks ModbusConnection objects, the same for all copies of this package */
+declare const CONNECTION: unique symbol;
+/**
+ * A modbus-serial client together with the state of its connection.
+ *
+ * modbus-serial emits 'error' (for example when a USB serial adapter is unplugged)
+ * and 'close' when the port fails. Node.js throws an 'error' event that has no
+ * listener, which crashes the process. ModbusConnection listens for both events
+ * and for clients that are no longer open, and then marks the connection as lost:
+ * - requests in flight reject at once, without waiting for the response timeout
+ * - later requests reject with the same ConnectionLostError without using the port
+ * - with an `open` function, the first request after a delay opens a new client.
+ *   The delay starts at REOPEN_DELAY_MS and doubles after each attempt that does
+ *   not lead to a successful request, up to MAX_REOPEN_DELAY_MS.
+ * - without an `open` function, requests reject until the owner of the client
+ *   opens it again
+ */
+export declare class ModbusConnection {
+    private readonly target?;
+    private readonly open?;
+    readonly [CONNECTION] = true;
+    private client;
+    private lostError;
+    private reopenDelay;
+    private reopenAt;
+    private reopening;
+    private closed;
+    private readonly inFlight;
+    /**
+     * @param client - Connected modbus-serial client
+     * @param target - Port path or host:port, used in error messages
+     * @param open - Opens a new client after the connection is lost
+     */
+    constructor(client: ModbusRTU, target?: string | undefined, open?: OpenClient | undefined);
+    /**
+     * Run a request with the client
+     *
+     * @param request - Request to run
+     * @returns Result of the request
+     * @throws ConnectionLostError when the connection is lost before or during the request
+     */
+    run<T>(request: (client: ModbusRTU) => Promise<T>): Promise<T>;
+    /**
+     * Close the client and stop reopening it
+     */
+    close(): Promise<void>;
+    private watch;
+    private lose;
+    /** Set the time of the next reopen attempt, and wait longer after that one */
+    private delayReopen;
+    /**
+     * Get a working client for a lost connection, unless it is too early to try again
+     *
+     * @param lostError - The error that the connection was lost with
+     */
+    private reopen;
+    private openClient;
+}
+/**
+ * Use a ModbusConnection as it is, or wrap a plain client in a new one
+ *
+ * Checks the mark instead of `instanceof`, because the CommonJS and ES module
+ * builds of this package each have their own ModbusConnection class.
+ *
+ * @param client - A ModbusConnection or a connected modbus-serial client
+ * @returns The connection
+ */
+export declare function toConnection(client: ModbusRTU | ModbusConnection): ModbusConnection;
+export {};
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/connection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,SAAS,MAAM,eAAe,CAAA;AAE1C,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAE7E,kFAAkF;AAClF,eAAO,MAAM,eAAe,OAAO,CAAA;AAEnC,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,QAAS,CAAA;AAEzC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAA;AAEjD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAE1E;AAeD,8EAA8E;AAC9E,QAAA,MAAM,UAAU,eAAsD,CAAA;AAqBtE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAgB;IAiBzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IAjBxB,QAAQ,CAAC,CAAC,UAAU,CAAC,QAAO;IAC5B,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IAEnE;;;;OAIG;gBAED,MAAM,EAAE,SAAS,EACA,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,EAAE,UAAU,YAAA;IAMpC;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA0BpE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,IAAI;IAYZ,8EAA8E;IAC9E,OAAO,CAAC,WAAW;IAKnB;;;;OAIG;IACH,OAAO,CAAC,MAAM;YAkBA,UAAU;CAqBzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,GAAG,gBAAgB,CAEnF"}

package/dist/cjs/src/connection.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Detection of lost connections and reopening of modbus-serial clients
+ */
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModbusConnection = exports.MAX_REOPEN_DELAY_MS = exports.REOPEN_DELAY_MS = void 0;
+exports.isConnectionLostError = isConnectionLostError;
+exports.toConnection = toConnection;
+const node_events_1 = require("node:events");
+const normalize_error_js_1 = require("./normalize-error.js");
+/** Delay before the first attempt to reopen a lost connection, in milliseconds */
+exports.REOPEN_DELAY_MS = 1000;
+/** Longest delay between attempts to reopen a lost connection, in milliseconds */
+exports.MAX_REOPEN_DELAY_MS = 60000;
+/**
+ * Check if an error means that the connection is lost (see ModbusConnection)
+ *
+ * @param error - Value that was thrown or used to reject a promise
+ * @returns True for a ConnectionLostError
+ */
+function isConnectionLostError(error) {
+    return error instanceof Error && error.name === 'ConnectionLostError';
+}
+/**
+ * Close a client so that a late 'error' event cannot crash the process
+ *
+ * modbus-serial stops forwarding the 'error' events of its port when the client
+ * closes. An error that the port emits after that (for example from an unplugged
+ * adapter) would have no listener, so the port keeps one that ignores it.
+ */
+function closeClient(client, callback) {
+    const port = Reflect.get(client, '_port');
+    if (port instanceof node_events_1.EventEmitter)
+        port.on('error', () => undefined);
+    client.close(callback);
+}
+/** Marks ModbusConnection objects, the same for all copies of this package */
+const CONNECTION = Symbol.for('@ya-modbus/transport/ModbusConnection');
+/**
+ * Error for a lost connection, with code and errno of a Node.js system error cause
+ */
+function connectionLostError(target, cause) {
+    const reason = (0, normalize_error_js_1.normalizeModbusError)(cause);
+    const error = new Error(`Connection ${target === undefined ? '' : `to ${target} `}lost: ${reason.message}`, { cause: reason });
+    error.name = 'ConnectionLostError';
+    // modbus-serial gives all its port errors errno 'ECONNREFUSED', also an unplugged
+    // serial adapter. Only Node.js system errors (they have a code) give a real errno.
+    if (reason.code !== undefined) {
+        error.code = reason.code;
+        error.errno = reason.errno;
+    }
+    return error;
+}
+/**
+ * A modbus-serial client together with the state of its connection.
+ *
+ * modbus-serial emits 'error' (for example when a USB serial adapter is unplugged)
+ * and 'close' when the port fails. Node.js throws an 'error' event that has no
+ * listener, which crashes the process. ModbusConnection listens for both events
+ * and for clients that are no longer open, and then marks the connection as lost:
+ * - requests in flight reject at once, without waiting for the response timeout
+ * - later requests reject with the same ConnectionLostError without using the port
+ * - with an `open` function, the first request after a delay opens a new client.
+ *   The delay starts at REOPEN_DELAY_MS and doubles after each attempt that does
+ *   not lead to a successful request, up to MAX_REOPEN_DELAY_MS.
+ * - without an `open` function, requests reject until the owner of the client
+ *   opens it again
+ */
+class ModbusConnection {
+    /**
+     * @param client - Connected modbus-serial client
+     * @param target - Port path or host:port, used in error messages
+     * @param open - Opens a new client after the connection is lost
+     */
+    constructor(client, target, open) {
+        this.target = target;
+        this.open = open;
+        this[_a] = true;
+        this.reopenDelay = exports.REOPEN_DELAY_MS;
+        this.reopenAt = 0;
+        this.closed = false;
+        this.inFlight = new Set();
+        this.client = client;
+        this.watch(client);
+    }
+    /**
+     * Run a request with the client
+     *
+     * @param request - Request to run
+     * @returns Result of the request
+     * @throws ConnectionLostError when the connection is lost before or during the request
+     */
+    async run(request) {
+        // No await while the connection works, so the request starts at once
+        const client = this.lostError === undefined ? this.client : await this.reopen(this.lostError);
+        // Assigned at once: the promise executor runs synchronously
+        let rejectOnLoss;
+        const lost = new Promise((_resolve, reject) => {
+            rejectOnLoss = reject;
+        });
+        // Handled here too, in case request() throws before Promise.race() listens
+        lost.catch(() => undefined);
+        this.inFlight.add(rejectOnLoss);
+        try {
+            const value = await Promise.race([request(client), lost]);
+            // The port works, so the next loss starts again with the shortest delay
+            this.reopenDelay = exports.REOPEN_DELAY_MS;
+            return value;
+        }
+        catch (error) {
+            // modbus-serial clears isOpen on some failures without an event (TCP socket errors)
+            if (!client.isOpen)
+                this.lose(client, error);
+            throw error;
+        }
+        finally {
+            this.inFlight.delete(rejectOnLoss);
+        }
+    }
+    /**
+     * Close the client and stop reopening it
+     */
+    async close() {
+        this.closed = true;
+        // A lost client or a client that is not open needs no close. modbus-serial never
+        // calls back when it closes a TCP client whose socket is closed.
+        if (this.lostError !== undefined || !this.client.isOpen)
+            return;
+        const client = this.client;
+        await new Promise((resolve) => {
+            closeClient(client, () => resolve());
+        });
+    }
+    watch(client) {
+        // The listeners stay for the life of the client: a late 'error' from a lost
+        // client must not crash the process
+        client.on('error', (error) => this.lose(client, error));
+        client.on('close', () => this.lose(client, 'port closed'));
+    }
+    lose(client, cause) {
+        // Ignore events from clients that were replaced, and repeated events
+        if (client !== this.client || this.lostError !== undefined || this.closed)
+            return;
+        this.lostError = connectionLostError(this.target, cause);
+        this.delayReopen();
+        for (const reject of this.inFlight)
+            reject(this.lostError);
+        // serialport closes the port on a disconnect. A port that is still open keeps
+        // its lock, and the reopen would fail.
+        if (client.isOpen)
+            closeClient(client, () => undefined);
+    }
+    /** Set the time of the next reopen attempt, and wait longer after that one */
+    delayReopen() {
+        this.reopenAt = performance.now() + this.reopenDelay;
+        this.reopenDelay = Math.min(this.reopenDelay * 2, exports.MAX_REOPEN_DELAY_MS);
+    }
+    /**
+     * Get a working client for a lost connection, unless it is too early to try again
+     *
+     * @param lostError - The error that the connection was lost with
+     */
+    reopen(lostError) {
+        if (this.open === undefined) {
+            // The owner of the client can open it again
+            if (this.client.isOpen && !this.closed) {
+                this.lostError = undefined;
+                return Promise.resolve(this.client);
+            }
+            return Promise.reject(lostError);
+        }
+        if (this.closed || performance.now() < this.reopenAt)
+            return Promise.reject(lostError);
+        // Requests that come while the client opens wait for the same attempt
+        this.reopening ?? (this.reopening = this.openClient(this.open, lostError).finally(() => {
+            this.reopening = undefined;
+        }));
+        return this.reopening;
+    }
+    async openClient(open, lostError) {
+        let client;
+        try {
+            client = await open();
+        }
+        catch (error) {
+            const openError = connectionLostError(this.target, error);
+            this.lostError = openError;
+            this.delayReopen();
+            throw openError;
+        }
+        if (this.closed) {
+            // close() was called while the client was opening
+            closeClient(client, () => undefined);
+            throw lostError;
+        }
+        this.client = client;
+        this.lostError = undefined;
+        this.watch(client);
+        return client;
+    }
+}
+exports.ModbusConnection = ModbusConnection;
+_a = CONNECTION;
+/**
+ * Use a ModbusConnection as it is, or wrap a plain client in a new one
+ *
+ * Checks the mark instead of `instanceof`, because the CommonJS and ES module
+ * builds of this package each have their own ModbusConnection class.
+ *
+ * @param client - A ModbusConnection or a connected modbus-serial client
+ * @returns The connection
+ */
+function toConnection(client) {
+    return CONNECTION in client ? client : new ModbusConnection(client);
+}
+//# sourceMappingURL=connection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/connection.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;AAyBH,sDAEC;AA4MD,oCAEC;AAvOD,6CAA0C;AAI1C,6DAA6E;AAE7E,kFAAkF;AACrE,QAAA,eAAe,GAAG,IAAI,CAAA;AAEnC,kFAAkF;AACrE,QAAA,mBAAmB,GAAG,KAAM,CAAA;AAOzC;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,KAAc;IAClD,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAA;AACvE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,MAAiB,EAAE,QAAoB;IAC1D,MAAM,IAAI,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClD,IAAI,IAAI,YAAY,0BAAY;QAAE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IACnE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;AACxB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAA;AAEtE;;GAEG;AACH,SAAS,mBAAmB,CAAC,MAA0B,EAAE,KAAc;IACrE,MAAM,MAAM,GAAG,IAAA,yCAAoB,EAAC,KAAK,CAAC,CAAA;IAC1C,MAAM,KAAK,GAAgB,IAAI,KAAK,CAClC,cAAc,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,MAAM,GAAG,SAAS,MAAM,CAAC,OAAO,EAAE,EAClF,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAA;IACD,KAAK,CAAC,IAAI,GAAG,qBAAqB,CAAA;IAClC,kFAAkF;IAClF,mFAAmF;IACnF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;QACxB,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC5B,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAa,gBAAgB;IAU3B;;;;OAIG;IACH,YACE,MAAiB,EACA,MAAe,EACf,IAAiB;QADjB,WAAM,GAAN,MAAM,CAAS;QACf,SAAI,GAAJ,IAAI,CAAa;QAjB3B,QAAY,GAAG,IAAI,CAAA;QAGpB,gBAAW,GAAG,uBAAe,CAAA;QAC7B,aAAQ,GAAG,CAAC,CAAA;QAEZ,WAAM,GAAG,KAAK,CAAA;QACL,aAAQ,GAAG,IAAI,GAAG,EAAgC,CAAA;QAYjE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACpB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAI,OAA0C;QACrD,qEAAqE;QACrE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAE7F,4DAA4D;QAC5D,IAAI,YAA2C,CAAA;QAC/C,MAAM,IAAI,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;YACnD,YAAY,GAAG,MAAM,CAAA;QACvB,CAAC,CAAC,CAAA;QACF,2EAA2E;QAC3E,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;QAC/B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;YACzD,wEAAwE;YACxE,IAAI,CAAC,WAAW,GAAG,uBAAe,CAAA;YAClC,OAAO,KAAK,CAAA;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oFAAoF;YACpF,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YAC5C,MAAM,KAAK,CAAA;QACb,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,iFAAiF;QACjF,iEAAiE;QACjE,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAM;QAE/D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAC1B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;QACtC,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,KAAK,CAAC,MAAiB;QAC7B,4EAA4E;QAC5E,oCAAoC;QACpC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;QAChE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;IAC5D,CAAC;IAEO,IAAI,CAAC,MAAiB,EAAE,KAAc;QAC5C,qEAAqE;QACrE,IAAI,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QAEjF,IAAI,CAAC,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACxD,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC1D,8EAA8E;QAC9E,uCAAuC;QACvC,IAAI,MAAM,CAAC,MAAM;YAAE,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IACzD,CAAC;IAED,8EAA8E;IACtE,WAAW;QACjB,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAA;QACpD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,EAAE,2BAAmB,CAAC,CAAA;IACxE,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,SAAsB;QACnC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,4CAA4C;YAC5C,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACvC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;gBAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACrC,CAAC;YACD,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAClC,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAEtF,sEAAsE;QACtE,IAAI,CAAC,SAAS,KAAd,IAAI,CAAC,SAAS,GAAK,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACpE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC5B,CAAC,CAAC,EAAA;QACF,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,IAAgB,EAAE,SAAsB;QAC/D,IAAI,MAAiB,CAAA;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,EAAE,CAAA;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YACzD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;YAC1B,IAAI,CAAC,WAAW,EAAE,CAAA;YAClB,MAAM,SAAS,CAAA;QACjB,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,kDAAkD;YAClD,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YACpC,MAAM,SAAS,CAAA;QACjB,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAClB,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AA7ID,4CA6IC;KA5IW,UAAU;AA8ItB;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAAC,MAAoC;IAC/D,OAAO,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAA;AACrE,CAAC"}

package/dist/cjs/src/create-modbus-transport.d.ts

@@ -1,16 +1,18 @@
 import type { Transport } from '@ya-modbus/driver-types';
 import type ModbusRTU from 'modbus-serial';
+import { type ModbusConnection } from './connection.js';
 import { type RetryLogger } from './retry.js';
 /**
  * Create a Transport implementation from a ModbusRTU client
  *
  * This factory wraps all modbus-serial client methods with retry logic
  * and converts them to the Transport interface expected by device drivers.
+ * Requests on a lost connection reject with a ConnectionLostError (see ModbusConnection).
  *
- * @param client - Configured ModbusRTU client instance
+ * @param client - Configured ModbusRTU client instance, or a ModbusConnection that can reopen it
  * @param maxRetries - Maximum retry attempts (default: 3, use 1 for discovery to disable retries)
  * @param logger - Optional callback to log retry attempts for debugging
  * @returns Transport implementation
  */
-export declare function createModbusTransport(client: ModbusRTU, maxRetries?: number, logger?: RetryLogger): Transport;
+export declare function createModbusTransport(client: ModbusRTU | ModbusConnection, maxRetries?: number, logger?: RetryLogger): Transport;
 //# sourceMappingURL=create-modbus-transport.d.ts.map

package/dist/cjs/src/create-modbus-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-modbus-transport.d.ts","sourceRoot":"","sources":["../../../src/create-modbus-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,SAAS,MAAM,eAAe,CAAA;AAE1C,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAExD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,UAAU,GAAE,MAAU,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,SAAS,CAoGX"}
+{"version":3,"file":"create-modbus-transport.d.ts","sourceRoot":"","sources":["../../../src/create-modbus-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,SAAS,MAAM,eAAe,CAAA;AAE1C,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAExD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,GAAG,gBAAgB,EACpC,UAAU,GAAE,MAAU,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,SAAS,CA4GX"}

package/dist/cjs/src/create-modbus-transport.js

@@ -1,61 +1,64 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createModbusTransport = createModbusTransport;
+const connection_js_1 = require("./connection.js");
 const retry_js_1 = require("./retry.js");
 /**
  * Create a Transport implementation from a ModbusRTU client
  *
  * This factory wraps all modbus-serial client methods with retry logic
  * and converts them to the Transport interface expected by device drivers.
+ * Requests on a lost connection reject with a ConnectionLostError (see ModbusConnection).
  *
- * @param client - Configured ModbusRTU client instance
+ * @param client - Configured ModbusRTU client instance, or a ModbusConnection that can reopen it
  * @param maxRetries - Maximum retry attempts (default: 3, use 1 for discovery to disable retries)
  * @param logger - Optional callback to log retry attempts for debugging
  * @returns Transport implementation
  */
 function createModbusTransport(client, maxRetries = 3, logger) {
+    const connection = (0, connection_js_1.toConnection)(client);
     return {
         async readHoldingRegisters(address, count) {
-            return (0, retry_js_1.withRetry)(async () => {
-                const result = await client.readHoldingRegisters(address, count);
+            return (0, retry_js_1.withRetry)(() => connection.run(async (modbus) => {
+                const result = await modbus.readHoldingRegisters(address, count);
                 return result.buffer;
-            }, maxRetries, logger);
+            }), maxRetries, logger);
         },
         async readInputRegisters(address, count) {
-            return (0, retry_js_1.withRetry)(async () => {
-                const result = await client.readInputRegisters(address, count);
+            return (0, retry_js_1.withRetry)(() => connection.run(async (modbus) => {
+                const result = await modbus.readInputRegisters(address, count);
                 return result.buffer;
-            }, maxRetries, logger);
+            }), maxRetries, logger);
         },
         async readCoils(address, count) {
-            return (0, retry_js_1.withRetry)(async () => {
-                const result = await client.readCoils(address, count);
+            return (0, retry_js_1.withRetry)(() => connection.run(async (modbus) => {
+                const result = await modbus.readCoils(address, count);
                 return result.buffer;
-            }, maxRetries, logger);
+            }), maxRetries, logger);
         },
         async readDiscreteInputs(address, count) {
-            return (0, retry_js_1.withRetry)(async () => {
-                const result = await client.readDiscreteInputs(address, count);
+            return (0, retry_js_1.withRetry)(() => connection.run(async (modbus) => {
+                const result = await modbus.readDiscreteInputs(address, count);
                 return result.buffer;
-            }, maxRetries, logger);
+            }), maxRetries, logger);
         },
         async writeSingleRegister(address, value) {
-            return (0, retry_js_1.withRetry)(async () => {
-                await client.writeRegister(address, value);
-            }, maxRetries, logger);
+            return (0, retry_js_1.withRetry)(() => connection.run(async (modbus) => {
+                await modbus.writeRegister(address, value);
+            }), maxRetries, logger);
         },
         async writeMultipleRegisters(address, values) {
-            return (0, retry_js_1.withRetry)(async () => {
-                await client.writeRegisters(address, values);
-            }, maxRetries, logger);
+            return (0, retry_js_1.withRetry)(() => connection.run(async (modbus) => {
+                await modbus.writeRegisters(address, values);
+            }), maxRetries, logger);
         },
         async writeSingleCoil(address, value) {
-            return (0, retry_js_1.withRetry)(async () => {
-                await client.writeCoil(address, value);
-            }, maxRetries, logger);
+            return (0, retry_js_1.withRetry)(() => connection.run(async (modbus) => {
+                await modbus.writeCoil(address, value);
+            }), maxRetries, logger);
         },
         async writeMultipleCoils(address, values) {
-            return (0, retry_js_1.withRetry)(async () => {
+            return (0, retry_js_1.withRetry)(() => connection.run(async (modbus) => {
                 // Convert Buffer to boolean array
                 const bools = [];
                 for (let i = 0; i < values.length * 8; i++) {
@@ -64,13 +67,11 @@ function createModbusTransport(client, maxRetries = 3, logger) {
                     const byte = values[byteIndex]; // byteIndex < values.length due to loop condition
                     bools.push((byte & (1 << bitIndex)) !== 0);
                 }
-                await client.writeCoils(address, bools);
-            }, maxRetries, logger);
+                await modbus.writeCoils(address, bools);
+            }), maxRetries, logger);
         },
         async close() {
-            return new Promise((resolve) => {
-                client.close(resolve);
-            });
+            return connection.close();
         },
     };
 }

package/dist/cjs/src/create-modbus-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-modbus-transport.js","sourceRoot":"","sources":["../../../src/create-modbus-transport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-modbus-transport.js","sourceRoot":"","sources":["../../../src/create-modbus-transport.ts"],"names":[],"mappings":"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"}

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

@@ -11,8 +11,8 @@ export type TransportConfig = RTUConfig | TCPConfig;
  * Create a transport instance based on configuration
  *
  * Detects whether to create RTU or TCP transport based on the config:
- * - If `port` is provided → RTU transport
- * - If `host` is provided → TCP transport
+ * - If `host` is provided → TCP transport (`port` is the optional TCP port number)
+ * - Otherwise, if `port` is provided → RTU transport (`port` is the serial path)
  *
  * @param config - Transport configuration (RTU or TCP)
  * @returns Transport implementation

package/dist/cjs/src/factory.js

@@ -4,33 +4,33 @@ exports.createTransport = createTransport;
 const rtu_transport_js_1 = require("./rtu-transport.js");
 const tcp_transport_js_1 = require("./tcp-transport.js");
 /**
- * Type guard to check if config is RTU
+ * Type guard to check if config is TCP
  */
-function isRTUConfig(config) {
-    return 'port' in config && !('host' in config);
+function isTCPConfig(config) {
+    return 'host' in config;
 }
 /**
  * Create a transport instance based on configuration
  *
  * Detects whether to create RTU or TCP transport based on the config:
- * - If `port` is provided → RTU transport
- * - If `host` is provided → TCP transport
+ * - If `host` is provided → TCP transport (`port` is the optional TCP port number)
+ * - Otherwise, if `port` is provided → RTU transport (`port` is the serial path)
  *
  * @param config - Transport configuration (RTU or TCP)
  * @returns Transport implementation
  * @throws Error if config is invalid
  */
 async function createTransport(config) {
-    // Validate that exactly one of port/host is provided
-    if ('port' in config && 'host' in config) {
-        throw new Error('Cannot specify both port (RTU) and host (TCP)');
+    if (isTCPConfig(config)) {
+        // A string `port` is a serial path, which cannot be combined with a TCP host
+        if (typeof config.port === 'string') {
+            throw new Error('Cannot specify both port (RTU) and host (TCP)');
+        }
+        return (0, tcp_transport_js_1.createTCPTransport)(config);
     }
-    if (isRTUConfig(config)) {
+    if ('port' in config) {
         return (0, rtu_transport_js_1.createRTUTransport)(config);
     }
-    if ('host' in config) {
-        return (0, tcp_transport_js_1.createTCPTransport)(config);
-    }
     throw new Error('Either port (for RTU) or host (for TCP) must be specified');
 }
 //# sourceMappingURL=factory.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/factory.ts"],"names":[],"mappings":";;AAgCA,0CAeC;AA7CD,yDAAuE;AACvE,yDAAuE;AAWvE;;GAEG;AACH,SAAS,WAAW,CAAC,MAAuB;IAC1C,OAAO,MAAM,IAAI,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,CAAA;AAChD,CAAC;AAED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,eAAe,CAAC,MAAuB;IAC3D,qDAAqD;IACrD,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IAClE,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,IAAA,qCAAkB,EAAC,MAAM,CAAC,CAAA;IACnC,CAAC;IAED,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrB,OAAO,IAAA,qCAAkB,EAAC,MAAM,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;AAC9E,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/factory.ts"],"names":[],"mappings":";;AAgCA,0CAeC;AA7CD,yDAAuE;AACvE,yDAAuE;AAWvE;;GAEG;AACH,SAAS,WAAW,CAAC,MAAuB;IAC1C,OAAO,MAAM,IAAI,MAAM,CAAA;AACzB,CAAC;AAED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,eAAe,CAAC,MAAuB;IAC3D,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,6EAA6E;QAC7E,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QAClE,CAAC;QAED,OAAO,IAAA,qCAAkB,EAAC,MAAM,CAAC,CAAA;IACnC,CAAC;IAED,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrB,OAAO,IAAA,qCAAkB,EAAC,MAAM,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;AAC9E,CAAC"}

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

@@ -10,6 +10,7 @@ export { createTCPTransport, type TCPConfig } from './tcp-transport.js';
 export { createModbusTransport } from './create-modbus-transport.js';
 export { withRetry, MAX_RETRIES, RETRY_DELAY_MS, type RetryLogger } from './retry.js';
 export { normalizeModbusError, type ModbusError } from './normalize-error.js';
+export { isConnectionLostError, ModbusConnection, type OpenClient } from './connection.js';
 export { TransportManager, type TransportStats } from './manager.js';
 export { MutexTransport } from './mutex-transport.js';
 export { SlaveTransport } from './slave-transport.js';