modbus-rs-wasm 0.13.0 → 0.14.0

package/README.md

@@ -2,7 +2,7 @@
 
 Browser-native WebAssembly bindings for [modbus-rs](https://github.com/Raghava-Ch/modbus-rs), enabling Modbus TCP (via WebSockets) and Modbus RTU/ASCII (via Web Serial) directly in the browser.
 
-> **Note:** If you are building a Node.js backend application, use the native [`modbus-rs`](https://www.npmjs.com/package/modbus-rs) package instead.
+> **Note:** This package is designed for browser-native environments (using WebSockets and Web Serial). If you are building a Node.js backend application, use the native [`modbus-rs`](https://www.npmjs.com/package/modbus-rs) package instead. Running this package in pure Node.js requires `--experimental-wasm-modules` and is not officially supported.
 
 ## Installation
 
@@ -10,6 +10,29 @@ Browser-native WebAssembly bindings for [modbus-rs](https://github.com/Raghava-C
 npm install modbus-rs-wasm
 ```
 
+## Integration & Frameworks (Vite, Svelte, React, etc.)
+
+No custom resolver aliases or configuration workarounds are required starting in `v0.14.0`. Standard package entry points are resolved automatically based on your builder/bundler targets.
+
+### Web (Direct / HTML / Vanilla JS)
+When loading the package in browser environments without a bundler, import the web entry point and await the initialization promise:
+
+```javascript
+import init, { WasmModbusClient } from 'modbus-rs-wasm/dist/web/modbus-rs.js';
+
+await init();
+const client = new WasmModbusClient('ws://localhost:8502', 1, 5000, 3, 20);
+```
+
+### Bundlers & Frameworks (Vite, SvelteKit, Next.js, etc.)
+When using modern bundlers, the root import automatically maps to the bundler target:
+
+```javascript
+import { WasmModbusClient } from 'modbus-rs-wasm';
+```
+*(Make sure your bundler is configured to load WebAssembly, e.g., using `vite-plugin-wasm` and `vite-plugin-top-level-await` in Vite).*
+
+
 ## Quick Start (Modbus TCP via WebSocket Gateway)
 
 First, run the gateway [modbus-gateway](https://github.com/Raghava-Ch/modbus-gateway).

package/dist/bundler/modbus-rs.d.ts

@@ -1,10 +1,35 @@
 /* tslint:disable */
 /* eslint-disable */
 
+export interface WasmSerialTransportOptions {
+    mode?: "rtu" | "ascii";
+    baudRate: number;
+    dataBits?: 5 | 6 | 7 | 8;
+    stopBits?: 1 | 2;
+    parity?: "none" | "even" | "odd";
+    responseTimeoutMs?: number;
+    retryAttempts?: number;
+    tickIntervalMs?: number;
+}
+
+
+
+export interface WasmTcpTransportOptions {
+    responseTimeoutMs?: number;
+    retryAttempts?: number;
+    tickIntervalMs?: number;
+}
+export interface WasmCreateClientOptions {
+    unitId?: number;
+}
+
+
+
 /**
- * Browser-facing Modbus client that communicates over a WebSocket transport.
+ * Browser-facing Modbus client bound to a specific unit ID.
  */
 export class WasmModbusClient {
+    private constructor();
     free(): void;
     [Symbol.dispose](): void;
     /**
@@ -28,13 +53,11 @@ export class WasmModbusClient {
      */
     get_comm_event_log(): Promise<any>;
     /**
-     * Returns `true` if there are in-flight Modbus requests waiting for
-     * response/timeout resolution.
+     * Returns `true` if there are in-flight Modbus requests.
      */
     has_pending_requests(): boolean;
     /**
-     * Returns `true` when the underlying WebSocket is open and the transport
-     * considers itself connected.
+     * Returns `true` when the underlying WebSocket is open.
      */
     is_connected(): boolean;
     /**
@@ -44,17 +67,6 @@ export class WasmModbusClient {
      * Returns a `Promise` resolving with `true` or rejects on error.
      */
     mask_write_register(address: number, and_mask: number, or_mask: number): Promise<any>;
-    /**
-     * Create a new Modbus master client and immediately start the background tick loop.
-     *
-     * # Arguments
-     * - `ws_url`           — WebSocket URL of the Modbus/TCP gateway (e.g. `"ws://192.168.1.1:8502"`).
-     * - `unit_id`          — Modbus unit ID / slave address of the target device (1–247).
-     * - `response_timeout_ms` — How long (ms) to wait before retrying or failing a request.
-     * - `retry_attempts`   — Number of retries before reporting an error to JS.
-     * - `tick_interval_ms` — How often (ms) the tick loop calls `poll()`. 20 ms is a safe default.
-     */
-    constructor(ws_url: string, unit_id: number, response_timeout_ms: number, retry_attempts: number, tick_interval_ms: number);
     /**
      * Read `quantity` coils starting at `address`.
      *
@@ -142,11 +154,6 @@ export class WasmModbusClient {
      * Returns a `Promise` resolving with a `Uint16Array` (the values read) or rejects on error.
      */
     read_write_multiple_registers(read_address: number, read_quantity: number, write_address: number, _write_quantity: number, values: Uint16Array): Promise<any>;
-    /**
-     * Drop all pending in-flight requests and attempt to reconnect the WebSocket.
-     * Outstanding Promises for dropped requests will be rejected with `"ConnectionLost"`.
-     */
-    reconnect(): boolean;
     /**
      * Report Server ID (FC 17).
      *
@@ -188,9 +195,10 @@ export class WasmModbusClient {
 }
 
 /**
- * Browser-facing Modbus client that communicates over Web Serial RTU or ASCII.
+ * Browser-facing Modbus client bound to a specific serial unit ID.
  */
 export class WasmSerialModbusClient {
+    private constructor();
     free(): void;
     [Symbol.dispose](): void;
     /**
@@ -214,12 +222,11 @@ export class WasmSerialModbusClient {
      */
     get_comm_event_log(): Promise<any>;
     /**
-     * Returns `true` if there are in-flight Modbus requests waiting for
-     * response/timeout resolution.
+     * Returns `true` if there are in-flight Modbus requests.
      */
     has_pending_requests(): boolean;
     /**
-     * Returns `true` when the serial port is open and the transport considers itself connected.
+     * Returns `true` when the serial port is open.
      */
     is_connected(): boolean;
     /**
@@ -229,13 +236,6 @@ export class WasmSerialModbusClient {
      * Returns a `Promise` resolving with `true` or rejects on error.
      */
     mask_write_register(address: number, and_mask: number, or_mask: number): Promise<any>;
-    /**
-     * Creates a Modbus serial client over browser Web Serial.
-     *
-     * `mode` accepts "rtu" or "ascii" (case-insensitive).
-     * `parity` accepts "none", "even", or "odd".
-     */
-    constructor(port_handle: WasmSerialPortHandle, unit_id: number, mode: string, baud_rate: number, data_bits: number, stop_bits: number, parity: string, response_timeout_ms: number, retry_attempts: number, tick_interval_ms: number);
     /**
      * Read `quantity` coils starting at `address`.
      *
@@ -320,11 +320,6 @@ export class WasmSerialModbusClient {
      * Returns a `Promise` resolving with a `Uint16Array` (the values read) or rejects on error.
      */
     read_write_multiple_registers(read_address: number, read_quantity: number, write_address: number, _write_quantity: number, values: Uint16Array): Promise<any>;
-    /**
-     * Drop all pending in-flight requests and attempt to reopen the serial port.
-     * Outstanding Promises for dropped requests will be rejected with `"ConnectionLost"`.
-     */
-    reconnect(): boolean;
     /**
      * Report Server ID (FC 17).
      *
@@ -461,6 +456,41 @@ export class WasmSerialServerConfig {
     static rtu(): WasmSerialServerConfig;
 }
 
+/**
+ * Connection and polling manager for browser Modbus Serial clients.
+ */
+export class WasmSerialTransport {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Closes the serial port connection and rejects all pending requests.
+     */
+    close(): void;
+    /**
+     * Creates a device client bound to the specified unit ID.
+     */
+    createClient(options?: WasmCreateClientOptions | null): WasmSerialModbusClient;
+    /**
+     * Returns `true` if there are in-flight Modbus requests.
+     */
+    has_pending_requests(): boolean;
+    /**
+     * Returns `true` when the serial port is open and connected.
+     */
+    is_connected(): boolean;
+    /**
+     * Creates a new Serial (RTU) transport using the provided `port_handle`.
+     *
+     * The transport claims the underlying serial stream and manages the
+     * read/write loop, allowing multiple clients to multiplex requests over it.
+     */
+    constructor(port_handle: WasmSerialPortHandle, options?: WasmSerialTransportOptions | null);
+    /**
+     * Drop all pending in-flight requests and attempt to reopen the serial port.
+     */
+    reconnect(): boolean;
+}
+
 /**
  * High-level design descriptor for phased server binding rollout.
  */
@@ -637,6 +667,41 @@ export class WasmTcpServer {
     ws_url(): string;
 }
 
+/**
+ * Connection and background polling manager for browser Modbus TCP clients.
+ */
+export class WasmTcpTransport {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Closes the connection and rejects all pending requests.
+     */
+    close(): void;
+    /**
+     * Creates a device client bound to the specified unit ID.
+     */
+    createClient(options?: WasmCreateClientOptions | null): WasmModbusClient;
+    /**
+     * Returns `true` if there are in-flight Modbus requests.
+     */
+    has_pending_requests(): boolean;
+    /**
+     * Returns `true` when the underlying WebSocket is open and connected.
+     */
+    is_connected(): boolean;
+    /**
+     * Creates a new TCP/WebSocket transport.
+     *
+     * This establishes a connection to the provided `ws_url` and handles
+     * the underlying read/write loops.
+     */
+    constructor(ws_url: string, options?: WasmTcpTransportOptions | null);
+    /**
+     * Drop all pending in-flight requests and attempt to reconnect.
+     */
+    reconnect(): boolean;
+}
+
 /**
  * Requests a browser serial port from `navigator.serial.requestPort()`.
  *

package/dist/bundler/modbus-rs.js

@@ -5,5 +5,5 @@ import { __wbg_set_wasm } from "./modbus-rs_bg.js";
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
 export {
-    WasmModbusClient, WasmSerialModbusClient, WasmSerialPortHandle, WasmSerialServer, WasmSerialServerConfig, WasmServerBindingPlan, WasmServerStatusSnapshot, WasmServerTransportKind, WasmTcpGatewayConfig, WasmTcpServer, request_serial_port
+    WasmModbusClient, WasmSerialModbusClient, WasmSerialPortHandle, WasmSerialServer, WasmSerialServerConfig, WasmSerialTransport, WasmServerBindingPlan, WasmServerStatusSnapshot, WasmServerTransportKind, WasmTcpGatewayConfig, WasmTcpServer, WasmTcpTransport, request_serial_port
 } from "./modbus-rs_bg.js";