@ya-modbus/transport 0.4.1-refactor-scope-driver-packages.0

package/README.md

@@ -0,0 +1,47 @@
+# @ya-modbus/transport
+
+Modbus transport implementations for RTU (serial) and TCP connections.
+
+## Features
+
+- RTU (RS-485/serial) transport
+- TCP/IP transport
+- Automatic retry on transient failures
+- Factory for auto-detecting transport type
+- TypeScript support
+
+## Installation
+
+```bash
+npm install @ya-modbus/transport
+```
+
+## Usage
+
+```typescript
+import { createTransport } from '@ya-modbus/transport'
+
+// RTU (serial) transport
+const rtuTransport = await createTransport({
+  port: '/dev/ttyUSB0',
+  baudRate: 9600,
+  dataBits: 8,
+  parity: 'none',
+  stopBits: 1,
+  slaveId: 1,
+})
+
+// TCP transport
+const tcpTransport = await createTransport({
+  host: '192.168.1.100',
+  port: 502, // optional, defaults to 502
+  slaveId: 1,
+})
+
+// Use transport with driver
+await rtuTransport.readHoldingRegisters(0, 10)
+```
+
+## License
+
+GPL-3.0-or-later

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

@@ -0,0 +1,16 @@
+import type { Transport } from '@ya-modbus/driver-types';
+import type ModbusRTU from 'modbus-serial';
+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.
+ *
+ * @param client - Configured ModbusRTU client instance
+ * @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;
+//# sourceMappingURL=create-modbus-transport.d.ts.map

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

@@ -0,0 +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"}

package/dist/create-modbus-transport.js

@@ -0,0 +1,74 @@
+import { withRetry } 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.
+ *
+ * @param client - Configured ModbusRTU client instance
+ * @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 function createModbusTransport(client, maxRetries = 3, logger) {
+    return {
+        async readHoldingRegisters(address, count) {
+            return withRetry(async () => {
+                const result = await client.readHoldingRegisters(address, count);
+                return result.buffer;
+            }, maxRetries, logger);
+        },
+        async readInputRegisters(address, count) {
+            return withRetry(async () => {
+                const result = await client.readInputRegisters(address, count);
+                return result.buffer;
+            }, maxRetries, logger);
+        },
+        async readCoils(address, count) {
+            return withRetry(async () => {
+                const result = await client.readCoils(address, count);
+                return result.buffer;
+            }, maxRetries, logger);
+        },
+        async readDiscreteInputs(address, count) {
+            return withRetry(async () => {
+                const result = await client.readDiscreteInputs(address, count);
+                return result.buffer;
+            }, maxRetries, logger);
+        },
+        async writeSingleRegister(address, value) {
+            return withRetry(async () => {
+                await client.writeRegister(address, value);
+            }, maxRetries, logger);
+        },
+        async writeMultipleRegisters(address, values) {
+            return withRetry(async () => {
+                await client.writeRegisters(address, values);
+            }, maxRetries, logger);
+        },
+        async writeSingleCoil(address, value) {
+            return withRetry(async () => {
+                await client.writeCoil(address, value);
+            }, maxRetries, logger);
+        },
+        async writeMultipleCoils(address, values) {
+            return withRetry(async () => {
+                // Convert Buffer to boolean array
+                const bools = [];
+                for (let i = 0; i < values.length * 8; i++) {
+                    const byteIndex = Math.floor(i / 8);
+                    const bitIndex = i % 8;
+                    const byte = values[byteIndex]; // byteIndex < values.length due to loop condition
+                    bools.push((byte & (1 << bitIndex)) !== 0);
+                }
+                await client.writeCoils(address, bools);
+            }, maxRetries, logger);
+        },
+        async close() {
+            return new Promise((resolve) => {
+                client.close(resolve);
+            });
+        },
+    };
+}
+//# sourceMappingURL=create-modbus-transport.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-modbus-transport.js","sourceRoot":"","sources":["../src/create-modbus-transport.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAoB,MAAM,YAAY,CAAA;AAExD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,aAAqB,CAAC,EACtB,MAAoB;IAEpB,OAAO;QACL,KAAK,CAAC,oBAAoB,CAAC,OAAe,EAAE,KAAa;YACvD,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;gBACT,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;gBAChE,OAAO,MAAM,CAAC,MAAM,CAAA;YACtB,CAAC,EACD,UAAU,EACV,MAAM,CACP,CAAA;QACH,CAAC;QAED,KAAK,CAAC,kBAAkB,CAAC,OAAe,EAAE,KAAa;YACrD,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;gBACT,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;gBAC9D,OAAO,MAAM,CAAC,MAAM,CAAA;YACtB,CAAC,EACD,UAAU,EACV,MAAM,CACP,CAAA;QACH,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,KAAa;YAC5C,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;gBACT,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;gBACrD,OAAO,MAAM,CAAC,MAAM,CAAA;YACtB,CAAC,EACD,UAAU,EACV,MAAM,CACP,CAAA;QACH,CAAC;QAED,KAAK,CAAC,kBAAkB,CAAC,OAAe,EAAE,KAAa;YACrD,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;gBACT,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;gBAC9D,OAAO,MAAM,CAAC,MAAM,CAAA;YACtB,CAAC,EACD,UAAU,EACV,MAAM,CACP,CAAA;QACH,CAAC;QAED,KAAK,CAAC,mBAAmB,CAAC,OAAe,EAAE,KAAa;YACtD,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;gBACT,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAC5C,CAAC,EACD,UAAU,EACV,MAAM,CACP,CAAA;QACH,CAAC;QAED,KAAK,CAAC,sBAAsB,CAAC,OAAe,EAAE,MAAc;YAC1D,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;gBACT,MAAM,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAC9C,CAAC,EACD,UAAU,EACV,MAAM,CACP,CAAA;QACH,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,KAAc;YACnD,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;gBACT,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YACxC,CAAC,EACD,UAAU,EACV,MAAM,CACP,CAAA;QACH,CAAC;QAED,KAAK,CAAC,kBAAkB,CAAC,OAAe,EAAE,MAAc;YACtD,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;gBACT,kCAAkC;gBAClC,MAAM,KAAK,GAAc,EAAE,CAAA;gBAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;oBACnC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAA;oBACtB,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAW,CAAA,CAAC,kDAAkD;oBAC3F,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;gBAC5C,CAAC;gBACD,MAAM,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YACzC,CAAC,EACD,UAAU,EACV,MAAM,CACP,CAAA;QACH,CAAC;QAED,KAAK,CAAC,KAAK;YACT,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBACnC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACvB,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/factory.d.ts

@@ -0,0 +1,22 @@
+import type { Transport } from '@ya-modbus/driver-types';
+import { type RTUConfig } from './rtu-transport.js';
+import { type TCPConfig } from './tcp-transport.js';
+export type { RTUConfig, TCPConfig };
+/**
+ * Combined transport configuration
+ * Can be either RTU or TCP, but not both
+ */
+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
+ *
+ * @param config - Transport configuration (RTU or TCP)
+ * @returns Transport implementation
+ * @throws Error if config is invalid
+ */
+export declare function createTransport(config: TransportConfig): Promise<Transport>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAGvE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,CAAA;AAEpC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,CAAA;AASnD;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAejF"}

package/dist/factory.js

@@ -0,0 +1,33 @@
+import { createRTUTransport } from './rtu-transport.js';
+import { createTCPTransport } from './tcp-transport.js';
+/**
+ * Type guard to check if config is RTU
+ */
+function isRTUConfig(config) {
+    return 'port' in config && !('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
+ *
+ * @param config - Transport configuration (RTU or TCP)
+ * @returns Transport implementation
+ * @throws Error if config is invalid
+ */
+export 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 (isRTUConfig(config)) {
+        return createRTUTransport(config);
+    }
+    if ('host' in config) {
+        return createTCPTransport(config);
+    }
+    throw new Error('Either port (for RTU) or host (for TCP) must be specified');
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAkB,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAkB,MAAM,oBAAoB,CAAA;AAWvE;;GAEG;AACH,SAAS,WAAW,CAAC,MAAuB;IAC1C,OAAO,MAAM,IAAI,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,CAAA;AAChD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,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,kBAAkB,CAAC,MAAM,CAAC,CAAA;IACnC,CAAC;IAED,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrB,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;AAC9E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @ya-modbus/transport - Modbus transport implementations
+ *
+ * Provides RTU and TCP transport implementations with automatic retry logic
+ * and transport pooling with mutex-based RTU bus serialization
+ */
+export { createTransport, type TransportConfig } from './factory.js';
+export { createRTUTransport, type RTUConfig } from './rtu-transport.js';
+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 { TransportManager, type TransportStats } from './manager.js';
+export { MutexTransport } from './mutex-transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @ya-modbus/transport - Modbus transport implementations
+ *
+ * Provides RTU and TCP transport implementations with automatic retry logic
+ * and transport pooling with mutex-based RTU bus serialization
+ */
+export { createTransport } from './factory.js';
+export { createRTUTransport } from './rtu-transport.js';
+export { createTCPTransport } from './tcp-transport.js';
+export { createModbusTransport } from './create-modbus-transport.js';
+export { withRetry, MAX_RETRIES, RETRY_DELAY_MS } from './retry.js';
+export { TransportManager } from './manager.js';
+export { MutexTransport } from './mutex-transport.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAwB,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAkB,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAkB,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,gBAAgB,EAAuB,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/manager.d.ts

@@ -0,0 +1,66 @@
+import type { Transport } from '@ya-modbus/driver-types';
+import { type TransportConfig } from './factory.js';
+/**
+ * Statistics about managed transports
+ */
+export interface TransportStats {
+    totalTransports: number;
+    rtuTransports: number;
+    tcpTransports: number;
+}
+/**
+ * TransportManager pools transport instances and provides mutex-based
+ * serialization for all transport operations to prevent concurrent access issues.
+ *
+ * Key behaviors:
+ * - All transports (RTU and TCP) are pooled by connection configuration
+ * - RTU transports are pooled by bus configuration (port, baud rate, parity, etc.)
+ * - TCP transports are pooled by host and port
+ * - Multiple devices on the same connection share a single transport instance
+ * - All operations are serialized using async-mutex to prevent race conditions
+ *
+ * Why TCP needs mutex protection:
+ * - Many Modbus devices allow only one or a limited number of TCP connections
+ * - Even with multiple connections, devices often process requests sequentially
+ * - Concurrent requests can cause timeouts, dropped packets, or incorrect responses
+ * - Serialization ensures reliable communication regardless of device limitations
+ */
+export declare class TransportManager {
+    private readonly transports;
+    /**
+     * Get or create a transport for the given configuration.
+     * Returns mutex-wrapped shared transport if one exists for the same connection.
+     *
+     * @param config - RTU or TCP transport configuration
+     * @returns Transport instance wrapped with mutex for thread-safe operations
+     */
+    getTransport(config: TransportConfig): Promise<Transport>;
+    /**
+     * Get statistics about managed transports
+     *
+     * @returns Transport statistics
+     */
+    getStats(): TransportStats;
+    /**
+     * Close all managed transports and clear the pool.
+     * Errors during close are logged but do not stop the process.
+     */
+    closeAll(): Promise<void>;
+    /**
+     * Generate a unique key for a transport configuration.
+     * For RTU: Key includes all bus parameters (port, baud, parity, etc.)
+     * For TCP: Key includes host and port
+     *
+     * @param config - Transport configuration
+     * @returns Connection key string
+     */
+    private getConnectionKey;
+    /**
+     * Type guard to check if config is RTU
+     *
+     * @param config - Transport configuration
+     * @returns True if RTU config
+     */
+    private isRTUConfig;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAGxD,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAepE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAE/D;;;;;;OAMG;IACG,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAqD/D;;;;OAIG;IACH,QAAQ,IAAI,cAAc;IAS1B;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAc/B;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IASxB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAGpB"}

package/dist/manager.js

@@ -0,0 +1,130 @@
+import { Mutex } from 'async-mutex';
+import { createTransport } from './factory.js';
+import { MutexTransport } from './mutex-transport.js';
+/**
+ * TransportManager pools transport instances and provides mutex-based
+ * serialization for all transport operations to prevent concurrent access issues.
+ *
+ * Key behaviors:
+ * - All transports (RTU and TCP) are pooled by connection configuration
+ * - RTU transports are pooled by bus configuration (port, baud rate, parity, etc.)
+ * - TCP transports are pooled by host and port
+ * - Multiple devices on the same connection share a single transport instance
+ * - All operations are serialized using async-mutex to prevent race conditions
+ *
+ * Why TCP needs mutex protection:
+ * - Many Modbus devices allow only one or a limited number of TCP connections
+ * - Even with multiple connections, devices often process requests sequentially
+ * - Concurrent requests can cause timeouts, dropped packets, or incorrect responses
+ * - Serialization ensures reliable communication regardless of device limitations
+ */
+export class TransportManager {
+    transports = new Map();
+    /**
+     * Get or create a transport for the given configuration.
+     * Returns mutex-wrapped shared transport if one exists for the same connection.
+     *
+     * @param config - RTU or TCP transport configuration
+     * @returns Transport instance wrapped with mutex for thread-safe operations
+     */
+    async getTransport(config) {
+        const key = this.getConnectionKey(config);
+        const isRTU = this.isRTUConfig(config);
+        // For RTU, reuse existing transport if available
+        if (isRTU) {
+            const entry = this.transports.get(key);
+            if (entry) {
+                return entry.wrappedTransport;
+            }
+            // Create new RTU transport with mutex wrapper
+            const rawTransport = await createTransport(config);
+            const mutex = new Mutex();
+            const wrappedTransport = new MutexTransport(rawTransport, mutex);
+            const newEntry = {
+                rawTransport,
+                wrappedTransport,
+                mutex,
+                config,
+                isRTU: true,
+            };
+            this.transports.set(key, newEntry);
+            return wrappedTransport;
+        }
+        // For TCP, reuse existing transport if available
+        // TCP is pooled like RTU because many devices support only one connection
+        // or process requests sequentially even with multiple connections
+        const entry = this.transports.get(key);
+        if (entry) {
+            return entry.wrappedTransport;
+        }
+        // Create new TCP transport with mutex wrapper
+        // Mutex prevents concurrent requests that could cause timeouts or errors
+        const rawTransport = await createTransport(config);
+        const mutex = new Mutex();
+        const wrappedTransport = new MutexTransport(rawTransport, mutex);
+        const newEntry = {
+            rawTransport,
+            wrappedTransport,
+            mutex,
+            config,
+            isRTU: false,
+        };
+        this.transports.set(key, newEntry);
+        return wrappedTransport;
+    }
+    /**
+     * Get statistics about managed transports
+     *
+     * @returns Transport statistics
+     */
+    getStats() {
+        const entries = Array.from(this.transports.values());
+        return {
+            totalTransports: entries.length,
+            rtuTransports: entries.filter((e) => e.isRTU).length,
+            tcpTransports: entries.filter((e) => !e.isRTU).length,
+        };
+    }
+    /**
+     * Close all managed transports and clear the pool.
+     * Errors during close are logged but do not stop the process.
+     */
+    async closeAll() {
+        const closePromises = Array.from(this.transports.values()).map(async (entry) => {
+            try {
+                await entry.rawTransport.close();
+            }
+            catch (error) {
+                // Log but don't throw - we want to close all transports
+                console.error('Error closing transport:', error);
+            }
+        });
+        await Promise.all(closePromises);
+        this.transports.clear();
+    }
+    /**
+     * Generate a unique key for a transport configuration.
+     * For RTU: Key includes all bus parameters (port, baud, parity, etc.)
+     * For TCP: Key includes host and port
+     *
+     * @param config - Transport configuration
+     * @returns Connection key string
+     */
+    getConnectionKey(config) {
+        if (this.isRTUConfig(config)) {
+            return `rtu:${config.port}:${config.baudRate}:${config.dataBits}:${config.parity}:${config.stopBits}`;
+        }
+        // TCP config - safe to access host/port because isRTUConfig returned false
+        return `tcp:${config.host}:${config.port ?? 502}`;
+    }
+    /**
+     * Type guard to check if config is RTU
+     *
+     * @param config - Transport configuration
+     * @returns True if RTU config
+     */
+    isRTUConfig(config) {
+        return 'port' in config && typeof config.port === 'string' && !('host' in config);
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/manager.js.map

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

package/dist/mutex-transport.d.ts

@@ -0,0 +1,26 @@
+import type { Transport } from '@ya-modbus/driver-types';
+import { Mutex } from 'async-mutex';
+/**
+ * Wraps a transport with mutex-based serialization.
+ * All operations are executed sequentially to prevent concurrent access issues.
+ *
+ * Used for:
+ * - RTU transports: Prevents bus collisions when multiple devices share a serial bus
+ * - TCP transports: Many Modbus devices support only one connection or process
+ *   requests sequentially. Serialization prevents timeouts and communication errors.
+ */
+export declare class MutexTransport implements Transport {
+    private readonly transport;
+    private readonly mutex;
+    constructor(transport: Transport, mutex: Mutex);
+    readHoldingRegisters(address: number, count: number): Promise<Buffer>;
+    readInputRegisters(address: number, count: number): Promise<Buffer>;
+    readCoils(address: number, count: number): Promise<Buffer>;
+    readDiscreteInputs(address: number, count: number): Promise<Buffer>;
+    writeSingleRegister(address: number, value: number): Promise<void>;
+    writeSingleCoil(address: number, value: boolean): Promise<void>;
+    writeMultipleRegisters(address: number, values: Buffer): Promise<void>;
+    writeMultipleCoils(address: number, values: Buffer): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=mutex-transport.d.ts.map

package/dist/mutex-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex-transport.d.ts","sourceRoot":"","sources":["../src/mutex-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEnC;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,SAAS;IAE5C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK;IAGzB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMrE,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM1D,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnE,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtE,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/mutex-transport.js

@@ -0,0 +1,62 @@
+/**
+ * Wraps a transport with mutex-based serialization.
+ * All operations are executed sequentially to prevent concurrent access issues.
+ *
+ * Used for:
+ * - RTU transports: Prevents bus collisions when multiple devices share a serial bus
+ * - TCP transports: Many Modbus devices support only one connection or process
+ *   requests sequentially. Serialization prevents timeouts and communication errors.
+ */
+export class MutexTransport {
+    transport;
+    mutex;
+    constructor(transport, mutex) {
+        this.transport = transport;
+        this.mutex = mutex;
+    }
+    async readHoldingRegisters(address, count) {
+        return this.mutex.runExclusive(() => {
+            return this.transport.readHoldingRegisters(address, count);
+        });
+    }
+    async readInputRegisters(address, count) {
+        return this.mutex.runExclusive(() => {
+            return this.transport.readInputRegisters(address, count);
+        });
+    }
+    async readCoils(address, count) {
+        return this.mutex.runExclusive(() => {
+            return this.transport.readCoils(address, count);
+        });
+    }
+    async readDiscreteInputs(address, count) {
+        return this.mutex.runExclusive(() => {
+            return this.transport.readDiscreteInputs(address, count);
+        });
+    }
+    async writeSingleRegister(address, value) {
+        await this.mutex.runExclusive(async () => {
+            await this.transport.writeSingleRegister(address, value);
+        });
+    }
+    async writeSingleCoil(address, value) {
+        await this.mutex.runExclusive(async () => {
+            await this.transport.writeSingleCoil(address, value);
+        });
+    }
+    async writeMultipleRegisters(address, values) {
+        return this.mutex.runExclusive(() => {
+            return this.transport.writeMultipleRegisters(address, values);
+        });
+    }
+    async writeMultipleCoils(address, values) {
+        return this.mutex.runExclusive(() => {
+            return this.transport.writeMultipleCoils(address, values);
+        });
+    }
+    async close() {
+        // No mutex needed for close - just delegate
+        return this.transport.close();
+    }
+}
+//# sourceMappingURL=mutex-transport.js.map

package/dist/mutex-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex-transport.js","sourceRoot":"","sources":["../src/mutex-transport.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAc;IAEN;IACA;IAFnB,YACmB,SAAoB,EACpB,KAAY;QADZ,cAAS,GAAT,SAAS,CAAW;QACpB,UAAK,GAAL,KAAK,CAAO;IAC5B,CAAC;IAEJ,KAAK,CAAC,oBAAoB,CAAC,OAAe,EAAE,KAAa;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE;YAClC,OAAO,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC5D,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,OAAe,EAAE,KAAa;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE;YAClC,OAAO,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC1D,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,KAAa;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE;YAClC,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACjD,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,OAAe,EAAE,KAAa;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE;YAClC,OAAO,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC1D,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,OAAe,EAAE,KAAa;QACtD,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE;YACvC,MAAM,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC1D,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,KAAc;QACnD,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE;YACvC,MAAM,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACtD,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,sBAAsB,CAAC,OAAe,EAAE,MAAc;QAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE;YAClC,OAAO,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC/D,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,OAAe,EAAE,MAAc;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE;YAClC,OAAO,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC3D,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,4CAA4C;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;IAC/B,CAAC;CACF"}

package/dist/retry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Retry configuration and utilities for Modbus transport operations
+ */
+/** Maximum number of retry attempts for failed operations */
+export declare const MAX_RETRIES = 3;
+/** Delay between retry attempts in milliseconds */
+export declare const RETRY_DELAY_MS = 100;
+/**
+ * Logger function to track retry attempts
+ *
+ * @param attempt - The attempt number (1-indexed)
+ * @param error - The error that caused the retry
+ */
+export type RetryLogger = (attempt: number, error: Error) => void;
+/**
+ * Retry a function with fixed delay between attempts
+ *
+ * @param fn - The async function to retry
+ * @param maxRetries - Maximum number of attempts (default: MAX_RETRIES)
+ * @param logger - Optional callback to log retry attempts
+ * @returns Promise resolving to the function's return value
+ * @throws The last error encountered if all retries are exhausted
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, maxRetries?: number, logger?: RetryLogger): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,WAAW,IAAI,CAAA;AAE5B,mDAAmD;AACnD,eAAO,MAAM,cAAc,MAAM,CAAA;AAYjC;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;AAEjE;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,GAAE,MAAoB,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC,CAqBZ"}

package/dist/retry.js

@@ -0,0 +1,46 @@
+/**
+ * Retry configuration and utilities for Modbus transport operations
+ */
+/** Maximum number of retry attempts for failed operations */
+export const MAX_RETRIES = 3;
+/** Delay between retry attempts in milliseconds */
+export const RETRY_DELAY_MS = 100;
+/**
+ * Sleep for a specified duration
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Promise that resolves after the specified duration
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Retry a function with fixed delay between attempts
+ *
+ * @param fn - The async function to retry
+ * @param maxRetries - Maximum number of attempts (default: MAX_RETRIES)
+ * @param logger - Optional callback to log retry attempts
+ * @returns Promise resolving to the function's return value
+ * @throws The last error encountered if all retries are exhausted
+ */
+export async function withRetry(fn, maxRetries = MAX_RETRIES, logger) {
+    let lastError = new Error('No retry attempts were made');
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Don't retry on the last attempt
+            if (attempt < maxRetries) {
+                // Log the retry attempt if logger is provided
+                if (logger) {
+                    logger(attempt, lastError);
+                }
+                await sleep(RETRY_DELAY_MS);
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAA;AAE5B,mDAAmD;AACnD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA;AAEjC;;;;;GAKG;AACH,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAC1D,CAAC;AAUD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,aAAqB,WAAW,EAChC,MAAoB;IAEpB,IAAI,SAAS,GAAU,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;IAE/D,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAA;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YAErE,kCAAkC;YAClC,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBACzB,8CAA8C;gBAC9C,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;gBAC5B,CAAC;gBACD,MAAM,KAAK,CAAC,cAAc,CAAC,CAAA;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAA;AACjB,CAAC"}