modbus-rs 0.13.0 → 0.15.0

package/README.md

@@ -5,10 +5,13 @@ High-performance Modbus TCP/RTU/ASCII client, server, and gateway for Node.js, p
 ## Features
 
 - **Async/Promise-based API** - All operations return Promises
-- **TCP Client** - Full Modbus TCP/IP client implementation
+- **TCP Client** - Full Modbus TCP/IP client implementation (supports communicating with multiple unit IDs behind a single IP address and a serial port)
 - **Serial Client** - Modbus RTU and ASCII over serial port
-- **TCP Server** - Build Modbus TCP servers with JavaScript handlers
-- **TCP Gateway** - Route requests to multiple downstream servers based on unit ID
+- **TCP & Serial Servers** - Build Modbus TCP servers, or Serial RTU and ASCII servers, using custom JavaScript handlers to respond to incoming requests
+- **Modbus Gateway** - Deploy high-performance gateways supporting WebSockets, TCP, and Serial (RTU/ASCII) as upstream channels, and TCP/Serial (RTU/ASCII) as downstream channels (WebSocket downstream support planned for a future release), dynamically routing requests based on unit ID mapping tables
+- **Thread Safety & Concurrency** - Rust-backed concurrent architecture ensures safe access across multiple async execution contexts
+- **Safety Locks** - Integrated bus locking to prevent command collisions and state corruption
+- **Multi-drop Serial Support** - Manage and communicate with multiple device unit IDs on a single physical RTU/ASCII bus
 - **High Performance** - Native Rust core with napi-rs bindings
 - **Type Safe** - Full TypeScript definitions included
 - **Cross Platform** - Pre-built binaries for Linux, macOS, and Windows
@@ -21,19 +24,23 @@ npm install modbus-rs
 
 ## Quick Start
 
+### Examples
+[https://github.com/Raghava-Ch/modbus-rs/tree/main/mbus-ffi/nodejs/examples](https://github.com/Raghava-Ch/modbus-rs/tree/main/mbus-ffi/nodejs/examples)
+
 ### TCP Client
 
 ```javascript
-const { AsyncTcpModbusClient } = require('modbus-rs');
+const { AsyncTcpTransport } = require('modbus-rs');
 
 async function main() {
-  const client = await AsyncTcpModbusClient.connect({
+  const transport = await AsyncTcpTransport.connect({
     host: '127.0.0.1',
     port: 502,
-    unitId: 1,
-    timeoutMs: 5000,
+    requestTimeoutMs: 5000,
   });
 
+  const client = transport.createClient({ unitId: 1 });
+
   try {
     // Read holding registers (FC03)
     const registers = await client.readHoldingRegisters({
@@ -48,7 +55,7 @@ async function main() {
       value: 12345,
     });
   } finally {
-    await client.close();
+    await transport.close();
   }
 }
 
@@ -58,18 +65,19 @@ main().catch(console.error);
 ### Serial RTU Client
 
 ```javascript
-const { AsyncSerialModbusClient } = require('modbus-rs');
+const { AsyncRtuTransport } = require('modbus-rs');
 
 async function main() {
-  const client = await AsyncSerialModbusClient.connectRtu({
+  const transport = await AsyncRtuTransport.open({
     portPath: '/dev/ttyUSB0',
-    unitId: 1,
     baudRate: 19200,
     dataBits: 8,
     stopBits: 1,
     parity: 'even',
   });
 
+  const client = transport.createClient({ unitId: 1 });
+
   try {
     const registers = await client.readHoldingRegisters({
       address: 0,
@@ -77,7 +85,7 @@ async function main() {
     });
     console.log('Registers:', registers);
   } finally {
-    await client.close();
+    await transport.close();
   }
 }
 
@@ -93,14 +101,13 @@ const holdingRegisters = new Array(1000).fill(0);
 
 async function main() {
   const server = await AsyncTcpModbusServer.bind(
-    { host: '0.0.0.0', port: 502 },
+    { host: '0.0.0.0', port: 502, unitId: 1 },
     {
       onReadHoldingRegisters: (req) => {
-        return holdingRegisters.slice(req.address, req.address + req.count);
+        return holdingRegisters.slice(req.address, req.address + req.quantity);
       },
       onWriteSingleRegister: (req) => {
         holdingRegisters[req.address] = req.value;
-        return true;
       },
     }
   );
@@ -147,12 +154,63 @@ async function main() {
 main().catch(console.error);
 ```
 
+## Migration Guide
+
+Detailed step-by-step migration guides are available in the [Migration Guides](https://github.com/Raghava-Ch/modbus-rs/tree/main/documentation/migrations) directory.
+
+
+## Error Handling with Code Constants
+
+Error code constants are now exported:
+
+```js
+const { getModbusErrorCode, ModbusErrorCode } = require('modbus-rs');
+
+try {
+  await client.readHoldingRegisters({ address: 0, quantity: 10 });
+} catch (err) {
+  const code = getModbusErrorCode(err);
+  switch (code) {
+    case ModbusErrorCode.EXCEPTION:      console.error('Modbus exception'); break;
+    case ModbusErrorCode.TIMEOUT:        console.error('Request timed out'); break;
+    case ModbusErrorCode.CONNECTION_CLOSED: console.error('Disconnected'); break;
+    default:                             console.error('Unknown error:', err.message);
+  }
+}
+```
+
+## Known Limitations
+
+- **AbortSignal**: Uses `signal.onabort` instead of `signal.addEventListener`. Only one abort handler per signal object is supported.
+- **Gateway route limit**: `AsyncTcpGateway` supports a maximum of **64 routing entries**. Attempting to add more will throw at `bind()` time.
+- **Gateway Downstream**: WebSockets are currently not supported as a downstream channel (support is planned for a future release).
+
 ## API Reference
 
-### AsyncTcpModbusClient
+### AsyncTcpTransport
+
+- `static connect(opts: TcpTransportOptions): Promise<AsyncTcpTransport>` - Connect to a Modbus TCP server
+- `close(): Promise<void>` - Close the connection
+- `reconnect(): Promise<void>` - Re-establish the connection
+- `createClient(opts: CreateClientOptions): AsyncTcpModbusClient` - Create a logical client instance bound to a specific unit ID (required)
+- `setRequestTimeout(ms: number): void` - Set a global request timeout (in milliseconds)
+- `clearRequestTimeout(): void` - Clear the global request timeout
+- `pendingRequests: boolean` - (Getter) Returns whether there are requests currently in flight
+
+### AsyncRtuTransport / AsyncAsciiTransport
+
+- `static open(opts: RtuTransportOptions | AsciiTransportOptions): Promise<AsyncRtuTransport | AsyncAsciiTransport>` - Open the serial port
+- `close(): Promise<void>` - Close the connection
+- `reconnect(): Promise<void>` - Re-establish the connection
+- `createClient(opts: CreateClientOptions): AsyncSerialModbusClient` - Create a logical client instance bound to a specific unit ID (required)
+- `setRequestTimeout(ms: number): void` - Set a global request timeout (in milliseconds)
+- `clearRequestTimeout(): void` - Clear the global request timeout
+- `pendingRequests: boolean` - (Getter) Returns whether there are requests currently in flight
+
+### AsyncTcpModbusClient / AsyncSerialModbusClient
+
+These logical clients contain all the Modbus function code methods:
 
-- `connect(opts: TcpClientOptions)` - Connect to a Modbus TCP server
-- `close()` - Close the connection
 - `readCoils(opts)` - FC01: Read Coils
 - `readDiscreteInputs(opts)` - FC02: Read Discrete Inputs
 - `readHoldingRegisters(opts)` - FC03: Read Holding Registers
@@ -169,40 +227,21 @@ main().catch(console.error);
 - `diagnostics(opts)` - FC08: Diagnostics
 - `readDeviceIdentification(opts)` - FC43/14: Read Device Identification
 
-### AsyncSerialModbusClient
-
-Same methods as `AsyncTcpModbusClient`, with different connection options:
-
-- `connectRtu(opts: SerialClientOptions)` - Connect using Modbus RTU
-- `connectAscii(opts: SerialClientOptions)` - Connect using Modbus ASCII
-
 ### AsyncTcpModbusServer
 
-- `bind(opts, handlers)` - Create and start a TCP server
-- `shutdown()` - Stop the server
+- `static bind(opts, handlers): Promise<AsyncTcpModbusServer>` - Create and start a TCP server
+- `shutdown(): Promise<void>` - Stop the server
 
-### AsyncTcpGateway
+### AsyncSerialModbusServer
 
-- `bind(opts, config)` - Create and start a gateway
-- `shutdown()` - Stop the gateway
+- `static bindRtu(opts, handlers): Promise<AsyncSerialModbusServer>` - Create and start a Serial RTU server
+- `static bindAscii(opts, handlers): Promise<AsyncSerialModbusServer>` - Create and start a Serial ASCII server
+- `shutdown(): Promise<void>` - Stop the server
 
-## Error Handling
-
-All errors are thrown as JavaScript Error objects with descriptive messages:
+### AsyncTcpGateway
 
-```javascript
-try {
-  await client.readHoldingRegisters({ address: 0, count: 10 });
-} catch (err) {
-  if (err.message.includes('MODBUS_EXCEPTION')) {
-    console.error('Modbus exception:', err.message);
-  } else if (err.message.includes('MODBUS_TIMEOUT')) {
-    console.error('Request timed out');
-  } else {
-    console.error('Error:', err.message);
-  }
-}
-```
+- `static bind(opts, config): Promise<AsyncTcpGateway>` - Create and start a gateway
+- `shutdown(): Promise<void>` - Stop the gateway
 
 ## Supported platforms
 
@@ -211,7 +250,7 @@ Pre-built binaries are published for:
 - Linux x64 (glibc), Linux arm64 (glibc)
 - macOS x64, macOS arm64
 - Windows x64 (MSVC)
-- WebAssembly `modbus-rs-wasm`
+- WebAssembly [modbus-rs-wasm](https://www.npmjs.com/package/modbus-rs-wasm)
 
 Other targets can be built locally via `cargo build -p mbus-ffi --features nodejs,full`
 followed by `npm run build`.

package/index.d.ts

@@ -1,21 +1,43 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
-/** Async Modbus Serial client supporting RTU and ASCII transports. */
-export declare class AsyncSerialModbusClient {
-  /** Creates and connects a new Serial RTU client. */
-  static connectRtu(opts: SerialClientOptions): Promise<AsyncSerialModbusClient>
-  /** Creates and connects a new Serial ASCII client. */
-  static connectAscii(opts: SerialClientOptions): Promise<AsyncSerialModbusClient>
+/** Physical serial port in ASCII mode. Factory for device clients. */
+export declare class AsyncAsciiTransport {
+  /** Opens the serial port in ASCII mode. */
+  static open(opts: AsciiTransportOptions): Promise<AsyncAsciiTransport>
+  /** Creates a device client bound to the specified unit ID. */
+  createClient(opts: CreateClientOptions): AsyncSerialModbusClient
+  /** Sets the per-request timeout in milliseconds. */
+  setRequestTimeout(timeoutMs: number): void
+  /** Clears the per-request timeout. */
+  clearRequestTimeout(): void
+  /** Returns whether there are pending requests. */
+  get pendingRequests(): boolean
+  /** Closes the transport. */
+  close(): Promise<void>
+  /** Reconnects the transport after a disconnect. */
+  reconnect(): Promise<void>
+}
+
+/** Physical serial port in RTU mode. Factory for device clients. */
+export declare class AsyncRtuTransport {
+  /** Opens the serial port in RTU mode. */
+  static open(opts: RtuTransportOptions): Promise<AsyncRtuTransport>
+  /** Creates a device client bound to the specified unit ID. */
+  createClient(opts: CreateClientOptions): AsyncSerialModbusClient
   /** Sets the per-request timeout in milliseconds. */
   setRequestTimeout(timeoutMs: number): void
   /** Clears the per-request timeout. */
   clearRequestTimeout(): void
   /** Returns whether there are pending requests. */
   get pendingRequests(): boolean
-  /** Closes the client connection. */
+  /** Closes the transport. */
   close(): Promise<void>
-  /** Reconnects the client after a disconnect. */
+  /** Reconnects the transport after a disconnect. */
   reconnect(): Promise<void>
+}
+
+/** Lightweight device client sharing the serial transport. */
+export declare class AsyncSerialModbusClient {
   /** Reads holding registers (FC03). */
   readHoldingRegisters(opts: ReadRegistersOptions): Promise<number[]>
   /** Reads input registers (FC04). */
@@ -50,10 +72,8 @@ export declare class AsyncSerialModbusClient {
 
 /** Async Modbus Serial server supporting RTU and ASCII transports. */
 export declare class AsyncSerialModbusServer {
-  /** Binds and starts a new Serial RTU server. */
-  static bindRtu(opts: SerialServerOptions, handlers: object): AsyncSerialModbusServer
-  /** Binds and starts a new Serial ASCII server. */
-  static bindAscii(opts: SerialServerOptions, handlers: object): AsyncSerialModbusServer
+  static bindRtu(opts: SerialServerOptions, handlers: ServerHandlers): Promise<AsyncSerialModbusServer>
+  static bindAscii(opts: SerialServerOptions, handlers: ServerHandlers): Promise<AsyncSerialModbusServer>
   /** Stops the server. */
   shutdown(): Promise<void>
 }
@@ -76,30 +96,8 @@ export declare class AsyncTcpGateway {
   shutdown(): Promise<void>
 }
 
-/**
- * Async Modbus TCP client.
- *
- * All methods are async and return Promises. The client must be connected
- * before issuing Modbus requests.
- */
+/** Lightweight device client sharing the TCP transport. */
 export declare class AsyncTcpModbusClient {
-  /**
-   * Creates and connects a new TCP client.
-   *
-   * @param opts - Connection options including host, port, unitId, and optional timeout.
-   * @returns A connected client instance.
-   */
-  static connect(opts: TcpClientOptions): Promise<AsyncTcpModbusClient>
-  /** Sets the per-request timeout in milliseconds. */
-  setRequestTimeout(timeoutMs: number): void
-  /** Clears the per-request timeout. */
-  clearRequestTimeout(): void
-  /** Returns whether there are pending requests. */
-  get pendingRequests(): boolean
-  /** Closes the client connection. */
-  close(): Promise<void>
-  /** Reconnects the client after a disconnect. */
-  reconnect(): Promise<void>
   /** Reads holding registers (FC03). */
   readHoldingRegisters(opts: ReadRegistersOptions): Promise<number[]>
   /** Reads input registers (FC04). */
@@ -145,11 +143,57 @@ export declare class AsyncTcpModbusServer {
    * @param handlers - Object containing handler functions for each Modbus operation.
    * @returns A running server instance.
    */
-  static bind(opts: TcpServerOptions, handlers: object): AsyncTcpModbusServer
+  static bind(opts: TcpServerOptions, handlers: ServerHandlers): Promise<AsyncTcpModbusServer>
   /** Stops the server. */
   shutdown(): Promise<void>
 }
 
+/** Physical TCP socket connection to a Modbus device or gateway. */
+export declare class AsyncTcpTransport {
+  /** Connects to a Modbus TCP device or gateway. */
+  static connect(opts: TcpTransportOptions): Promise<AsyncTcpTransport>
+  /** Creates a device client bound to the specified unit ID. */
+  createClient(opts: CreateClientOptions): AsyncTcpModbusClient
+  /** Sets the per-request timeout in milliseconds. */
+  setRequestTimeout(timeoutMs: number): void
+  /** Clears the per-request timeout. */
+  clearRequestTimeout(): void
+  /** Returns whether there are pending requests. */
+  get pendingRequests(): boolean
+  /** Closes the connection. */
+  close(): Promise<void>
+  /** Reconnects the transport after a disconnect. */
+  reconnect(): Promise<void>
+}
+
+/** Connection options for the serial ASCII transport. */
+export interface AsciiTransportOptions {
+  /** Serial port path (e.g., "/dev/ttyUSB0", "COM3"). */
+  portPath: string
+  /** Baud rate (e.g., 9600, 19200, 38400, 57600, 115200). */
+  baudRate: number
+  /** Data bits (5, 6, 7, or 8). */
+  dataBits?: number
+  /** Parity ("none", "even", "odd"). */
+  parity?: string
+  /** Stop bits (1 or 2). */
+  stopBits?: number
+  /** Response timeout in milliseconds. */
+  responseTimeoutMs?: number
+  /** Per-request timeout in milliseconds. */
+  requestTimeoutMs?: number
+  /** Number of retry attempts on failure (0 = none). Default: 0. */
+  retryAttempts?: number
+  /** Backoff strategy: "immediate", "fixed", or "exponential". Default: "immediate". */
+  retryBackoffStrategy?: string
+}
+
+/** Options for creating a device client. */
+export interface CreateClientOptions {
+  /** Modbus unit ID (1-247). */
+  unitId: number
+}
+
 /** Device identification object. */
 export interface DeviceIdentificationObject {
   /** Object ID. */
@@ -177,7 +221,7 @@ export interface DiagnosticsOptions {
   /** Data words for the request. */
   data: Array<number>
   /** Optional abort signal to cancel the request. */
-  signal?: object
+  signal?: AbortSignal
 }
 
 /** Handler request for diagnostics. */
@@ -205,8 +249,6 @@ export interface DownstreamConfig {
 
 /** Response from reading FIFO queue. */
 export interface FifoQueueResponse {
-  /** Number of values in the queue. */
-  count: number
   /** Queue values. */
   values: Array<number>
 }
@@ -221,6 +263,13 @@ export interface FileRecordReadRequest {
   recordLength: number
 }
 
+/** A single file record read sub-request on the server side. */
+export interface FileRecordReadServerSubRequest {
+  fileNumber: number
+  recordNumber: number
+  recordLength: number
+}
+
 /** A single file record write sub-request. */
 export interface FileRecordWriteRequest {
   /** File number (1-65535). */
@@ -231,6 +280,13 @@ export interface FileRecordWriteRequest {
   recordData: Array<number>
 }
 
+/** A single file record write sub-request on the server side. */
+export interface FileRecordWriteSubRequest {
+  fileNumber: number
+  recordNumber: number
+  recordData: Array<number>
+}
+
 /** Gateway bind options. */
 export interface GatewayBindOptions {
   /** Bind host address (e.g., "0.0.0.0"). */
@@ -247,6 +303,24 @@ export interface GatewayConfig {
   routes: Array<RouteEntry>
 }
 
+/** Stable error code: The connection was closed. */
+export const MODBUS_ERROR_CODE_CONNECTION_CLOSED: string
+
+/** Stable error code: Modbus protocol exception received. */
+export const MODBUS_ERROR_CODE_EXCEPTION: string
+
+/** Stable error code: Internal library error. */
+export const MODBUS_ERROR_CODE_INTERNAL: string
+
+/** Stable error code: Invalid argument passed to the API. */
+export const MODBUS_ERROR_CODE_INVALID_ARGUMENT: string
+
+/** Stable error code: Request timed out. */
+export const MODBUS_ERROR_CODE_TIMEOUT: string
+
+/** Stable error code: Transport/framing error. */
+export const MODBUS_ERROR_CODE_TRANSPORT: string
+
 /** Options for reading coils or discrete inputs. */
 export interface ReadBitsOptions {
   /** Starting address. */
@@ -254,7 +328,7 @@ export interface ReadBitsOptions {
   /** Number of bits to read. */
   quantity: number
   /** Optional abort signal to cancel the request. */
-  signal?: object
+  signal?: AbortSignal
 }
 
 /** Handler request for reading coils. */
@@ -271,7 +345,7 @@ export interface ReadDeviceIdentificationOptions {
   /** Starting object ID. */
   objectId: number
   /** Optional abort signal to cancel the request. */
-  signal?: object
+  signal?: AbortSignal
 }
 
 /** Handler request for reading discrete inputs. */
@@ -281,12 +355,17 @@ export interface ReadDiscreteInputsRequest {
   quantity: number
 }
 
+/** Handler request for reading exception status. */
+export interface ReadExceptionStatusRequest {
+  unitId: number
+}
+
 /** Options for reading FIFO queue. */
 export interface ReadFifoQueueOptions {
   /** FIFO pointer address. */
   address: number
   /** Optional abort signal to cancel the request. */
-  signal?: object
+  signal?: AbortSignal
 }
 
 /** Handler request for reading FIFO queue. */
@@ -300,7 +379,13 @@ export interface ReadFileRecordOptions {
   /** Array of sub-requests. */
   requests: Array<FileRecordReadRequest>
   /** Optional abort signal to cancel the request. */
-  signal?: object
+  signal?: AbortSignal
+}
+
+/** Handler request for reading file records. */
+export interface ReadFileRecordRequest {
+  unitId: number
+  requests: Array<FileRecordReadServerSubRequest>
 }
 
 /** Handler request for reading holding registers. */
@@ -324,7 +409,7 @@ export interface ReadRegistersOptions {
   /** Number of registers to read. */
   quantity: number
   /** Optional abort signal to cancel the request. */
-  signal?: object
+  signal?: AbortSignal
 }
 
 /** Options for read/write multiple registers (FC23). */
@@ -338,7 +423,16 @@ export interface ReadWriteMultipleRegistersOptions {
   /** Values to write. */
   writeValues: Array<number>
   /** Optional abort signal to cancel the request. */
-  signal?: object
+  signal?: AbortSignal
+}
+
+/** Handler request for read/write multiple registers (FC23). */
+export interface ReadWriteMultipleRegistersRequest {
+  unitId: number
+  readAddress: number
+  readQuantity: number
+  writeAddress: number
+  writeValues: Array<number>
 }
 
 /** Route entry mapping unit ID to a downstream channel. */
@@ -349,8 +443,8 @@ export interface RouteEntry {
   channel: number
 }
 
-/** Connection options for the serial client. */
-export interface SerialClientOptions {
+/** Connection options for the serial RTU transport. */
+export interface RtuTransportOptions {
   /** Serial port path (e.g., "/dev/ttyUSB0", "COM3"). */
   portPath: string
   /** Baud rate (e.g., 9600, 19200, 38400, 57600, 115200). */
@@ -361,12 +455,14 @@ export interface SerialClientOptions {
   parity?: string
   /** Stop bits (1 or 2). */
   stopBits?: number
-  /** Modbus unit ID (1-247). */
-  unitId: number
   /** Response timeout in milliseconds. */
   responseTimeoutMs?: number
   /** Per-request timeout in milliseconds. */
   requestTimeoutMs?: number
+  /** Number of retry attempts on failure (0 = none). Default: 0. */
+  retryAttempts?: number
+  /** Backoff strategy: "immediate", "fixed", or "exponential". Default: "immediate". */
+  retryBackoffStrategy?: string
 }
 
 /** Server bind options for serial port. */
@@ -399,18 +495,6 @@ export interface ServerExceptionResponse {
   exception?: number
 }
 
-/** Connection options for the TCP client. */
-export interface TcpClientOptions {
-  /** Target host address (IP or hostname). */
-  host: string
-  /** Target TCP port (typically 502). */
-  port: number
-  /** Modbus unit ID (1-247). */
-  unitId: number
-  /** Per-request timeout in milliseconds (optional). */
-  timeoutMs?: number
-}
-
 /** Server bind options. */
 export interface TcpServerOptions {
   /** Bind host address (e.g., "0.0.0.0"). */
@@ -421,12 +505,32 @@ export interface TcpServerOptions {
   unitId: number
 }
 
+/** Connection options for the TCP transport. */
+export interface TcpTransportOptions {
+  /** Target host address (IP or hostname). */
+  host: string
+  /** Target TCP port (typically 502). */
+  port: number
+  /** Per-request timeout in milliseconds (optional). */
+  requestTimeoutMs?: number
+  /** Number of retry attempts on failure (0 = none). Default: 0. */
+  retryAttempts?: number
+  /** Backoff strategy: "immediate", "fixed", or "exponential". Default: "immediate". */
+  retryBackoffStrategy?: string
+}
+
 /** Options for writing file records. */
 export interface WriteFileRecordOptions {
   /** Array of sub-requests. */
   requests: Array<FileRecordWriteRequest>
   /** Optional abort signal to cancel the request. */
-  signal?: object
+  signal?: AbortSignal
+}
+
+/** Handler request for writing file records. */
+export interface WriteFileRecordRequest {
+  unitId: number
+  requests: Array<FileRecordWriteSubRequest>
 }
 
 /** Options for writing multiple coils. */
@@ -436,7 +540,7 @@ export interface WriteMultipleCoilsOptions {
   /** Values to write. */
   values: Array<boolean>
   /** Optional abort signal to cancel the request. */
-  signal?: object
+  signal?: AbortSignal
 }
 
 /** Handler request for writing multiple coils. */
@@ -453,7 +557,7 @@ export interface WriteMultipleRegistersOptions {
   /** Values to write. */
   values: Array<number>
   /** Optional abort signal to cancel the request. */
-  signal?: object
+  signal?: AbortSignal
 }
 
 /** Handler request for writing multiple registers. */
@@ -470,7 +574,7 @@ export interface WriteSingleCoilOptions {
   /** Value to write. */
   value: boolean
   /** Optional abort signal to cancel the request. */
-  signal?: object
+  signal?: AbortSignal
 }
 
 /** Handler request for writing a single coil. */
@@ -487,7 +591,7 @@ export interface WriteSingleRegisterOptions {
   /** Value to write. */
   value: number
   /** Optional abort signal to cancel the request. */
-  signal?: object
+  signal?: AbortSignal
 }
 
 /** Handler request for writing a single register. */
@@ -496,3 +600,35 @@ export interface WriteSingleRegisterRequest {
   address: number
   value: number
 }
+
+export interface ModbusException {
+  exception: number;
+}
+
+export interface ServerHandlers {
+  onReadCoils?: (req: ReadCoilsRequest) => boolean[] | ModbusException | Promise<boolean[] | ModbusException>;
+  onReadDiscreteInputs?: (req: ReadDiscreteInputsRequest) => boolean[] | ModbusException | Promise<boolean[] | ModbusException>;
+  onReadHoldingRegisters?: (req: ReadHoldingRegistersRequest) => number[] | ModbusException | Promise<number[] | ModbusException>;
+  onReadInputRegisters?: (req: ReadInputRegistersRequest) => number[] | ModbusException | Promise<number[] | ModbusException>;
+  onWriteSingleCoil?: (req: WriteSingleCoilRequest) => void | ModbusException | Promise<void | ModbusException>;
+  onWriteSingleRegister?: (req: WriteSingleRegisterRequest) => void | ModbusException | Promise<void | ModbusException>;
+  onReadExceptionStatus?: (req: ReadExceptionStatusRequest) => number | ModbusException | Promise<number | ModbusException>;
+  onDiagnostics?: (req: DiagnosticsRequest) => ServerDiagnosticsResponse | ModbusException | Promise<ServerDiagnosticsResponse | ModbusException>;
+  onWriteMultipleCoils?: (req: WriteMultipleCoilsRequest) => void | ModbusException | Promise<void | ModbusException>;
+  onWriteMultipleRegisters?: (req: WriteMultipleRegistersRequest) => void | ModbusException | Promise<void | ModbusException>;
+  onReadFileRecord?: (req: ReadFileRecordRequest) => number[][] | ModbusException | Promise<number[][] | ModbusException>;
+  onWriteFileRecord?: (req: WriteFileRecordRequest) => void | ModbusException | Promise<void | ModbusException>;
+  onReadWriteMultipleRegisters?: (req: ReadWriteMultipleRegistersRequest) => number[] | ModbusException | Promise<number[] | ModbusException>;
+  onReadFifoQueue?: (req: ReadFifoQueueRequest) => number[] | ModbusException | Promise<number[] | ModbusException>;
+}
+
+export declare const ModbusErrorCode: {
+  readonly EXCEPTION: 'MODBUS_EXCEPTION';
+  readonly TIMEOUT: 'MODBUS_TIMEOUT';
+  readonly TRANSPORT: 'MODBUS_TRANSPORT';
+  readonly INVALID_ARGUMENT: 'MODBUS_INVALID_ARGUMENT';
+  readonly CONNECTION_CLOSED: 'MODBUS_CONNECTION_CLOSED';
+  readonly INTERNAL: 'MODBUS_INTERNAL';
+};
+
+export declare function getModbusErrorCode(err: Error): string | undefined;

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-android-arm64')
         const bindingPackageVersion = require('modbus-rs-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-android-arm-eabi')
         const bindingPackageVersion = require('modbus-rs-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-win32-x64-gnu')
         const bindingPackageVersion = require('modbus-rs-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-win32-x64-msvc')
         const bindingPackageVersion = require('modbus-rs-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-win32-ia32-msvc')
         const bindingPackageVersion = require('modbus-rs-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-win32-arm64-msvc')
         const bindingPackageVersion = require('modbus-rs-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('modbus-rs-darwin-universal')
       const bindingPackageVersion = require('modbus-rs-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-darwin-x64')
         const bindingPackageVersion = require('modbus-rs-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-darwin-arm64')
         const bindingPackageVersion = require('modbus-rs-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-freebsd-x64')
         const bindingPackageVersion = require('modbus-rs-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-freebsd-arm64')
         const bindingPackageVersion = require('modbus-rs-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('modbus-rs-linux-x64-musl')
           const bindingPackageVersion = require('modbus-rs-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('modbus-rs-linux-x64-gnu')
           const bindingPackageVersion = require('modbus-rs-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('modbus-rs-linux-arm64-musl')
           const bindingPackageVersion = require('modbus-rs-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('modbus-rs-linux-arm64-gnu')
           const bindingPackageVersion = require('modbus-rs-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('modbus-rs-linux-arm-musleabihf')
           const bindingPackageVersion = require('modbus-rs-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('modbus-rs-linux-arm-gnueabihf')
           const bindingPackageVersion = require('modbus-rs-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('modbus-rs-linux-loong64-musl')
           const bindingPackageVersion = require('modbus-rs-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('modbus-rs-linux-loong64-gnu')
           const bindingPackageVersion = require('modbus-rs-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('modbus-rs-linux-riscv64-musl')
           const bindingPackageVersion = require('modbus-rs-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('modbus-rs-linux-riscv64-gnu')
           const bindingPackageVersion = require('modbus-rs-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-linux-ppc64-gnu')
         const bindingPackageVersion = require('modbus-rs-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-linux-s390x-gnu')
         const bindingPackageVersion = require('modbus-rs-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-openharmony-arm64')
         const bindingPackageVersion = require('modbus-rs-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-openharmony-x64')
         const bindingPackageVersion = require('modbus-rs-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('modbus-rs-openharmony-arm')
         const bindingPackageVersion = require('modbus-rs-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.13.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.13.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -576,8 +576,34 @@ if (!nativeBinding) {
 }
 
 module.exports = nativeBinding
+module.exports.AsyncAsciiTransport = nativeBinding.AsyncAsciiTransport
+module.exports.AsyncRtuTransport = nativeBinding.AsyncRtuTransport
 module.exports.AsyncSerialModbusClient = nativeBinding.AsyncSerialModbusClient
 module.exports.AsyncSerialModbusServer = nativeBinding.AsyncSerialModbusServer
 module.exports.AsyncTcpGateway = nativeBinding.AsyncTcpGateway
 module.exports.AsyncTcpModbusClient = nativeBinding.AsyncTcpModbusClient
 module.exports.AsyncTcpModbusServer = nativeBinding.AsyncTcpModbusServer
+module.exports.AsyncTcpTransport = nativeBinding.AsyncTcpTransport
+module.exports.MODBUS_ERROR_CODE_CONNECTION_CLOSED = nativeBinding.MODBUS_ERROR_CODE_CONNECTION_CLOSED
+module.exports.MODBUS_ERROR_CODE_EXCEPTION = nativeBinding.MODBUS_ERROR_CODE_EXCEPTION
+module.exports.MODBUS_ERROR_CODE_INTERNAL = nativeBinding.MODBUS_ERROR_CODE_INTERNAL
+module.exports.MODBUS_ERROR_CODE_INVALID_ARGUMENT = nativeBinding.MODBUS_ERROR_CODE_INVALID_ARGUMENT
+module.exports.MODBUS_ERROR_CODE_TIMEOUT = nativeBinding.MODBUS_ERROR_CODE_TIMEOUT
+module.exports.MODBUS_ERROR_CODE_TRANSPORT = nativeBinding.MODBUS_ERROR_CODE_TRANSPORT
+
+// Error code constants
+module.exports.ModbusErrorCode = {
+  EXCEPTION: 'MODBUS_EXCEPTION',
+  TIMEOUT: 'MODBUS_TIMEOUT',
+  TRANSPORT: 'MODBUS_TRANSPORT',
+  INVALID_ARGUMENT: 'MODBUS_INVALID_ARGUMENT',
+  CONNECTION_CLOSED: 'MODBUS_CONNECTION_CLOSED',
+  INTERNAL: 'MODBUS_INTERNAL',
+}
+
+// Helper to extract the code from a Modbus error message
+module.exports.getModbusErrorCode = function getModbusErrorCode(err) {
+  if (!err || typeof err.message !== 'string') return undefined
+  const m = err.message.match(/^\[([A-Z_]+)(?::[^\]]*)?\]/)
+  return m ? m[1] : undefined
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modbus-rs",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "High-performance Modbus TCP/RTU/ASCII client, server and gateway for Node.js, powered by Rust",
   "main": "index.js",
   "types": "index.d.ts",
@@ -8,8 +8,8 @@
     ".": "./index.js"
   },
   "scripts": {
-    "build": "napi build --platform --release --features nodejs,full --js index.js --dts index.d.ts --output-dir . --manifest-path ../Cargo.toml",
-    "build:debug": "napi build --platform --features nodejs,full --js index.js --dts index.d.ts --output-dir . --manifest-path ../Cargo.toml",
+    "build": "napi build --platform --release --features nodejs-full --js index.js --dts index.d.ts --output-dir . --manifest-path ../Cargo.toml && node scripts/postbuild.js",
+    "build:debug": "napi build --platform --features nodejs-full --js index.js --dts index.d.ts --output-dir . --manifest-path ../Cargo.toml && node scripts/postbuild.js",
     "test": "node --test __test__/*.test.mjs",
     "prepublishOnly": "napi prepublish -t npm",
     "artifacts": "napi artifacts",
@@ -64,10 +64,10 @@
   ],
   "dependencies": {},
   "optionalDependencies": {
-    "modbus-rs-win32-x64-msvc": "0.9.0",
-    "modbus-rs-linux-x64-gnu": "0.9.0",
-    "modbus-rs-darwin-x64": "0.9.0",
-    "modbus-rs-darwin-arm64": "0.9.0",
-    "modbus-rs-linux-arm64-gnu": "0.9.0"
+    "modbus-rs-win32-x64-msvc": "0.15.0",
+    "modbus-rs-linux-x64-gnu": "0.15.0",
+    "modbus-rs-darwin-x64": "0.15.0",
+    "modbus-rs-darwin-arm64": "0.15.0",
+    "modbus-rs-linux-arm64-gnu": "0.15.0"
   }
 }