modbus-rs 0.14.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
@@ -33,7 +36,7 @@ async function main() {
   const transport = await AsyncTcpTransport.connect({
     host: '127.0.0.1',
     port: 502,
-    timeoutMs: 5000,
+    requestTimeoutMs: 5000,
   });
 
   const client = transport.createClient({ unitId: 1 });
@@ -96,8 +99,8 @@ const { AsyncTcpModbusServer } = require('modbus-rs');
 
 const holdingRegisters = new Array(1000).fill(0);
 
-function main() {
-  const server = AsyncTcpModbusServer.bind(
+async function main() {
+  const server = await AsyncTcpModbusServer.bind(
     { host: '0.0.0.0', port: 502, unitId: 1 },
     {
       onReadHoldingRegisters: (req) => {
@@ -117,11 +120,7 @@ function main() {
   });
 }
 
-try {
-  main();
-} catch (err) {
-  console.error(err);
-}
+main().catch(console.error);
 ```
 
 ### TCP Gateway
@@ -155,6 +154,37 @@ 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
 
 ### AsyncTcpTransport
@@ -162,7 +192,7 @@ main().catch(console.error);
 - `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 (defaults to `1`)
+- `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
@@ -199,31 +229,19 @@ These logical clients contain all the Modbus function code methods:
 
 ### AsyncTcpModbusServer
 
-- `bind(opts, handlers)` - Create and start a TCP server
-- `shutdown()` - Stop the server
-
-### AsyncTcpGateway
+- `static bind(opts, handlers): Promise<AsyncTcpModbusServer>` - Create and start a TCP server
+- `shutdown(): Promise<void>` - Stop the server
 
-- `bind(opts, config)` - Create and start a gateway
-- `shutdown()` - Stop the gateway
+### AsyncSerialModbusServer
 
-## Error Handling
+- `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
 
-All errors are thrown as JavaScript Error objects with descriptive messages:
+### AsyncTcpGateway
 
-```javascript
-try {
-  await client.readHoldingRegisters({ address: 0, quantity: 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
 

package/index.d.ts

@@ -72,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>
 }
@@ -145,7 +143,7 @@ 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>
 }
@@ -155,7 +153,7 @@ 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 | undefined | null): AsyncTcpModbusClient
+  createClient(opts: CreateClientOptions): AsyncTcpModbusClient
   /** Sets the per-request timeout in milliseconds. */
   setRequestTimeout(timeoutMs: number): void
   /** Clears the per-request timeout. */
@@ -184,12 +182,16 @@ export interface AsciiTransportOptions {
   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
+  unitId: number
 }
 
 /** Device identification object. */
@@ -219,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. */
@@ -247,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>
 }
@@ -263,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). */
@@ -273,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"). */
@@ -289,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. */
@@ -296,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. */
@@ -313,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. */
@@ -323,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. */
@@ -342,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. */
@@ -366,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). */
@@ -380,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. */
@@ -407,6 +459,10 @@ export interface RtuTransportOptions {
   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. */
@@ -456,7 +512,11 @@ export interface TcpTransportOptions {
   /** Target TCP port (typically 502). */
   port: number
   /** Per-request timeout in milliseconds (optional). */
-  timeoutMs?: number
+  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. */
@@ -464,7 +524,13 @@ 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. */
@@ -474,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. */
@@ -491,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. */
@@ -508,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. */
@@ -525,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. */
@@ -534,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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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.14.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) {
@@ -584,3 +584,26 @@ 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.14.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.14.0",
-    "modbus-rs-linux-x64-gnu": "0.14.0",
-    "modbus-rs-darwin-x64": "0.14.0",
-    "modbus-rs-darwin-arm64": "0.14.0",
-    "modbus-rs-linux-arm64-gnu": "0.14.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"
   }
 }