node-opcua-transport 2.170.0 → 2.173.0

package/dist/source/client_tcp_transport.d.ts

@@ -2,28 +2,9 @@
  * @module node-opcua-transport
  */
 import type { ErrorCallback } from "node-opcua-status-code";
-import { AcknowledgeMessage } from "./AcknowledgeMessage";
-import { TCP_transport } from "./tcp_transport";
-export interface ClientTCP_transport {
-    on(eventName: "chunk", eventHandler: (messageChunk: Buffer) => void): this;
-    on(eventName: "close", eventHandler: (err: Error | null) => void): this;
-    on(eventName: "connection_break", eventHandler: (err: Error | null) => void): this;
-    on(eventName: "connect", eventHandler: () => void): this;
-    once(eventName: "chunk", eventHandler: (messageChunk: Buffer) => void): this;
-    once(eventName: "close", eventHandler: (err: Error | null) => void): this;
-    once(eventName: "connection_break", eventHandler: (err: Error | null) => void): this;
-    once(eventName: "connect", eventHandler: () => void): this;
-    emit(eventName: "chunk", messageChunk: Buffer): boolean;
-    emit(eventName: "close", err?: Error | null): boolean;
-    emit(eventName: "connection_break", err?: Error | null): boolean;
-    emit(eventName: "connect"): boolean;
-}
-export interface TransportSettingsOptions {
-    maxChunkCount?: number;
-    maxMessageSize?: number;
-    receiveBufferSize?: number;
-    sendBufferSize?: number;
-}
+import { ClientTransportBase } from "./client_transport_base";
+import type { TransportSettingsOptions } from "./i_client_transport";
+export type { TransportSettingsOptions };
 /**
  * a ClientTCP_transport connects to a remote server socket and
  * initiates a communication with a HEL/ACK transaction.
@@ -59,23 +40,7 @@ export interface TransportSettingsOptions {
  *
  *
  */
-export declare class ClientTCP_transport extends TCP_transport {
-    static defaultMaxChunk: number;
-    static defaultMaxMessageSize: number;
-    static defaultReceiveBufferSize: number;
-    static defaultSendBufferSize: number;
-    endpointUrl: string;
-    serverUri: string;
-    numberOfRetry: number;
-    parameters?: AcknowledgeMessage;
-    private _counter;
-    private _helloSettings;
-    constructor(transportSettings?: TransportSettingsOptions);
-    getTransportSettings(): TransportSettingsOptions;
+export declare class ClientTCP_transport extends ClientTransportBase {
     dispose(): void;
     connect(endpointUrl: string, callback: ErrorCallback): void;
-    private _handle_ACK_response;
-    private _send_HELLO_request;
-    private _on_ACK_response;
-    private _perform_HEL_ACK_transaction;
 }

package/dist/source/client_tcp_transport.js

@@ -12,24 +12,18 @@ const node_os_1 = __importDefault(require("node:os"));
 const node_util_1 = require("node:util");
 const chalk_1 = __importDefault(require("chalk"));
 const node_opcua_assert_1 = require("node-opcua-assert");
-const node_opcua_binary_stream_1 = require("node-opcua-binary-stream");
-const node_opcua_chunkmanager_1 = require("node-opcua-chunkmanager");
 const node_opcua_debug_1 = require("node-opcua-debug");
-const AcknowledgeMessage_1 = require("./AcknowledgeMessage");
-const HelloMessage_1 = require("./HelloMessage");
-const TCPErrorMessage_1 = require("./TCPErrorMessage");
+const client_transport_base_1 = require("./client_transport_base");
 const tcp_transport_1 = require("./tcp_transport");
 const tools_1 = require("./tools");
-const utils_1 = require("./utils");
 const doDebug = (0, node_opcua_debug_1.checkDebugFlag)(__filename);
 const debugLog = (0, node_opcua_debug_1.make_debugLog)(__filename);
-const warningLog = (0, node_opcua_debug_1.make_warningLog)(__filename);
 const errorLog = (0, node_opcua_debug_1.make_errorLog)(__filename);
 const gHostname = node_os_1.default.hostname();
 function createClientSocket(endpointUrl, timeout) {
     // create a socket based on Url
     const ep = (0, tools_1.parseEndpointUrl)(endpointUrl);
-    const port = parseInt(ep.port, 10);
+    const port = parseInt(ep.port || "4840", 10);
     const hostname = ep.hostname;
     let socket;
     switch (ep.protocol) {
@@ -86,39 +80,7 @@ function createClientSocket(endpointUrl, timeout) {
  *
  *
  */
-// biome-ignore lint/suspicious/noUnsafeDeclarationMerging: typed EventEmitter events - extending parent's event map in subclass hierarchy
-class ClientTCP_transport extends tcp_transport_1.TCP_transport {
-    static defaultMaxChunk = 0; // 0 - no limits
-    static defaultMaxMessageSize = 0; // 0 - no limits
-    static defaultReceiveBufferSize = 1024 * 64 * 10;
-    static defaultSendBufferSize = 1024 * 64 * 10; // 8192 min,
-    endpointUrl;
-    serverUri;
-    numberOfRetry;
-    parameters;
-    _counter;
-    _helloSettings;
-    constructor(transportSettings) {
-        super();
-        this.endpointUrl = "";
-        this.serverUri = "";
-        this._counter = 0;
-        this.numberOfRetry = 0;
-        // initially before HEL/ACK
-        this.maxChunkCount = 1;
-        this.maxMessageSize = 4 * 1024;
-        this.receiveBufferSize = 4 * 1024;
-        transportSettings = transportSettings || {};
-        this._helloSettings = {
-            maxChunkCount: transportSettings.maxChunkCount || ClientTCP_transport.defaultMaxChunk,
-            maxMessageSize: transportSettings.maxMessageSize || ClientTCP_transport.defaultMaxMessageSize,
-            receiveBufferSize: transportSettings.receiveBufferSize || ClientTCP_transport.defaultReceiveBufferSize,
-            sendBufferSize: transportSettings.sendBufferSize || ClientTCP_transport.defaultSendBufferSize
-        };
-    }
-    getTransportSettings() {
-        return this._helloSettings;
-    }
+class ClientTCP_transport extends client_transport_base_1.ClientTransportBase {
     dispose() {
         /* c8 ignore next */
         doDebug && debugLog(" ClientTCP_transport disposed");
@@ -131,7 +93,8 @@ class ClientTCP_transport extends tcp_transport_1.TCP_transport {
         doDebug && debugLog(chalk_1.default.cyan(`ClientTCP_transport#connect(endpointUrl = ${endpointUrl})`));
         let socket = null;
         try {
-            const _ep = (0, tools_1.parseEndpointUrl)(endpointUrl);
+            // validate the URL upfront so a parse error is reported synchronously
+            (0, tools_1.parseEndpointUrl)(endpointUrl);
             socket = createClientSocket(endpointUrl, this.timeout);
             socket.setTimeout(this.timeout >> 1, () => {
                 this.forceConnectionBreak();
@@ -143,30 +106,6 @@ class ClientTCP_transport extends tcp_transport_1.TCP_transport {
             callback(err);
             return;
         }
-        /**
-         *
-         */
-        const _on_socket_error_after_connection = (err) => {
-            /* c8 ignore next */
-            doDebug && debugLog(" _on_socket_error_after_connection ClientTCP_transport Socket Error", err.message);
-            // EPIPE : EPIPE (Broken pipe): A write on a pipe, socket, or FIFO for which there is no process to read the
-            // data. Commonly encountered at the net and http layers, indicative that the remote side of the stream
-            // being written to has been closed.
-            // ECONNRESET (Connection reset by peer): A connection was forcibly closed by a peer. This normally results
-            // from a loss of the connection on the remote socket due to a timeout or reboot. Commonly encountered
-            // via the http and net module
-            //  socket termination could happen:
-            //   * when the socket times out (lost of connection, network outage, etc...)
-            //   * or, when the server abruptly disconnects the socket ( in case of invalid communication for instance)
-            if (err.message.match(/ECONNRESET|EPIPE|premature socket termination/)) {
-                /**
-                 * @event connection_break
-                 *
-                 */
-                doDebug && debugLog("connection_break after reconnection", endpointUrl);
-                this.emit("connection_break", err);
-            }
-        };
         const _on_socket_connect = () => {
             /* c8 ignore next */
             doDebug && debugLog("entering _on_socket_connect");
@@ -177,13 +116,12 @@ class ClientTCP_transport extends tcp_transport_1.TCP_transport {
                     if (!this._socket) {
                         return callback(new Error("Abandoned"));
                     }
-                    // install error handler to detect connection break
-                    this._socket.on("error", _on_socket_error_after_connection);
+                    // install the post-connect "connection break" detector inherited from ClientTransportBase
+                    this._install_post_connect_error_handler(endpointUrl);
                     /**
                      * notify the observers that the transport is connected (the socket is connected and the the HEL/ACK
                      * transaction has been done)
                      * @event connect
-                     *
                      */
                     this.emit("connect");
                 }
@@ -219,95 +157,6 @@ class ClientTCP_transport extends tcp_transport_1.TCP_transport {
         this._socket?.once("end", _on_socket_end_for_connect);
         this._socket?.once("connect", _on_socket_connect);
     }
-    _handle_ACK_response(messageChunk, callback) {
-        const _stream = new node_opcua_binary_stream_1.BinaryStream(messageChunk);
-        const messageHeader = (0, node_opcua_chunkmanager_1.readMessageHeader)(_stream);
-        let err = null;
-        /* c8 ignore next */
-        if (messageHeader.isFinal !== "F") {
-            err = new Error(" invalid ACK message");
-            return callback(err);
-        }
-        let responseClass;
-        let response;
-        if (messageHeader.msgType === "ERR") {
-            responseClass = TCPErrorMessage_1.TCPErrorMessage;
-            _stream.rewind();
-            response = (0, tools_1.decodeMessage)(_stream, responseClass);
-            err = new Error(`ACK: ERR received ${response.statusCode.toString()} : ${response.reason}`);
-            err.statusCode = response.statusCode;
-            // c8 ignore next
-            utils_1.doTraceHelloAck && warningLog("receiving ERR instead of Ack", response.toString());
-            callback(err);
-        }
-        else {
-            responseClass = AcknowledgeMessage_1.AcknowledgeMessage;
-            _stream.rewind();
-            response = (0, tools_1.decodeMessage)(_stream, responseClass);
-            this.parameters = response;
-            this.setLimits(response);
-            // c8 ignore next
-            utils_1.doTraceHelloAck && warningLog("receiving Ack\n", response.toString());
-            callback();
-        }
-    }
-    _send_HELLO_request() {
-        /* c8 ignore next */
-        doDebug && debugLog("entering _send_HELLO_request");
-        (0, node_opcua_assert_1.assert)(this._socket);
-        (0, node_opcua_assert_1.assert)(Number.isFinite(this.protocolVersion));
-        (0, node_opcua_assert_1.assert)(this.endpointUrl.length > 0, " expecting a valid endpoint url");
-        const { maxChunkCount, maxMessageSize, receiveBufferSize, sendBufferSize } = this._helloSettings;
-        // Write a message to the socket as soon as the client is connected,
-        // the server will receive it as message from the client
-        const helloMessage = new HelloMessage_1.HelloMessage({
-            endpointUrl: this.endpointUrl,
-            protocolVersion: this.protocolVersion,
-            maxChunkCount,
-            maxMessageSize,
-            receiveBufferSize,
-            sendBufferSize
-        });
-        // c8 ignore next
-        utils_1.doTraceHelloAck && warningLog(`sending Hello\n ${helloMessage.toString()} `);
-        const messageChunk = (0, tools_1.packTcpMessage)("HEL", helloMessage);
-        this._write_chunk(messageChunk);
-    }
-    _on_ACK_response(externalCallback, err, data) {
-        /* c8 ignore next */
-        doDebug && debugLog("entering _on_ACK_response");
-        (0, node_opcua_assert_1.assert)(typeof externalCallback === "function");
-        (0, node_opcua_assert_1.assert)(this._counter === 0, "Ack response should only be received once !");
-        this._counter += 1;
-        if (err || !data) {
-            if (this._socket) {
-                const s = this._socket;
-                this._socket = null;
-                s.destroy();
-            }
-            externalCallback(err || new Error("no data"));
-        }
-        else {
-            this._handle_ACK_response(data, externalCallback);
-        }
-    }
-    _perform_HEL_ACK_transaction(callback) {
-        /* c8 ignore next */
-        if (!this._socket) {
-            return callback(new Error("No socket available to perform HEL/ACK transaction"));
-        }
-        (0, node_opcua_assert_1.assert)(this._socket, "expecting a valid socket to send a message");
-        (0, node_opcua_assert_1.assert)(typeof callback === "function");
-        this._counter = 0;
-        /* c8 ignore next */
-        doDebug && debugLog("entering _perform_HEL_ACK_transaction");
-        this._install_one_time_message_receiver((err, data) => {
-            /* c8 ignore next */
-            doDebug && debugLog("before  _on_ACK_response ", err ? err.message : "");
-            this._on_ACK_response(callback, err, data);
-        });
-        this._send_HELLO_request();
-    }
 }
 exports.ClientTCP_transport = ClientTCP_transport;
 //# sourceMappingURL=client_tcp_transport.js.map

package/dist/source/client_tcp_transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"client_tcp_transport.js","sourceRoot":"","sources":["../../source/client_tcp_transport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client_tcp_transport.js","sourceRoot":"","sources":["../../source/client_tcp_transport.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;AAEH,uCAA4C;AAC5C,sDAAyB;AACzB,yCAAkC;AAClC,kDAA0B;AAE1B,yDAA2C;AAC3C,uDAAgF;AAGhF,mEAA8D;AAE9D,mDAAqE;AACrE,mCAA2C;AAE3C,MAAM,OAAO,GAAG,IAAA,iCAAc,EAAC,UAAU,CAAC,CAAC;AAC3C,MAAM,QAAQ,GAAG,IAAA,gCAAa,EAAC,UAAU,CAAC,CAAC;AAC3C,MAAM,QAAQ,GAAG,IAAA,gCAAa,EAAC,UAAU,CAAC,CAAC;AAC3C,MAAM,SAAS,GAAG,iBAAE,CAAC,QAAQ,EAAE,CAAC;AAKhC,SAAS,kBAAkB,CAAC,WAAmB,EAAE,OAAe;IAC5D,+BAA+B;IAC/B,MAAM,EAAE,GAAG,IAAA,wBAAgB,EAAC,WAAW,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAK,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;IAE7B,IAAI,MAAmB,CAAC;IACxB,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;QAClB,KAAK,UAAU;YACX,MAAM,GAAG,IAAA,2BAAgB,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE;gBAC9D,OAAO,IAAI,QAAQ,CAAC,wBAAwB,QAAQ,IAAI,IAAI,YAAY,OAAO,GAAG,CAAC,CAAC;YACxF,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACzB,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC;YAExC,OAAO,MAAM,CAAC;QAClB,KAAK,OAAO;YACR,IAAA,0BAAM,EAAC,EAAE,CAAC,QAAQ,KAAK,OAAO,EAAE,iCAAiC,CAAC,CAAC;YACnE,MAAM,GAAG,IAAA,gCAAgB,GAAE,CAAC;YAC5B,OAAO,MAAM,CAAC;QAClB,OAAO,CAAC,CAAC,CAAC;YACN,MAAM,GAAG,GAAG,8DAA8D,EAAE,CAAC,QAAQ,EAAE,CAAC;YACxF,QAAQ,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAa,mBAAoB,SAAQ,2CAAmB;IACjD,OAAO;QACV,oBAAoB;QACpB,OAAO,IAAI,QAAQ,CAAC,+BAA+B,CAAC,CAAC;QAErD,KAAK,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC;IAEM,OAAO,CAAC,WAAmB,EAAE,QAAuB;QACvD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,OAAO,SAAS,SAAS,CAAC;QAC3C,oBAAoB;QACpB,OAAO,IAAI,QAAQ,CAAC,eAAK,CAAC,IAAI,CAAC,6CAA6C,WAAW,GAAG,CAAC,CAAC,CAAC;QAC7F,IAAI,MAAM,GAAuB,IAAI,CAAC;QACtC,IAAI,CAAC;YACD,sEAAsE;YACtE,IAAA,wBAAgB,EAAC,WAAW,CAAC,CAAC;YAC9B,MAAM,GAAG,kBAAkB,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAEvD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE,GAAG,EAAE;gBACtC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAChC,CAAC,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,oBAAoB;YACpB,OAAO,IAAI,QAAQ,CAAC,+BAA+B,CAAC,CAAC;YAErD,QAAQ,CAAC,GAAY,CAAC,CAAC;YACvB,OAAO;QACX,CAAC;QAED,MAAM,kBAAkB,GAAG,GAAG,EAAE;YAC5B,oBAAoB;YACpB,OAAO,IAAI,QAAQ,CAAC,6BAA6B,CAAC,CAAC;YAEnD,yBAAyB,EAAE,CAAC;YAC5B,IAAI,CAAC,4BAA4B,CAAC,CAAC,GAAG,EAAE,EAAE;gBACtC,IAAI,CAAC,GAAG,EAAE,CAAC;oBACP,oBAAoB;oBACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;wBAChB,OAAO,QAAQ,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;oBAC5C,CAAC;oBACD,0FAA0F;oBAC1F,IAAI,CAAC,mCAAmC,CAAC,WAAW,CAAC,CAAC;oBACtD;;;;uBAIG;oBACH,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACzB,CAAC;qBAAM,CAAC;oBACJ,QAAQ,CAAC,mDAAmD,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC/E,CAAC;gBACD,QAAQ,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;QAEF,MAAM,4BAA4B,GAAG,CAAC,GAAU,EAAE,EAAE;YAChD,yEAAyE;YACzE,oBAAoB;YACpB,OAAO,IAAI,QAAQ,CAAC,eAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3G,IAAA,0BAAM,EAAC,iBAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;YACjC,yBAAyB,EAAE,CAAC;YAC5B,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,MAAM,0BAA0B,GAAG,GAAG,EAAE;YACpC,oBAAoB;YACpB,OAAO;gBACH,QAAQ,CAAC,eAAK,CAAC,IAAI,CAAC,4FAA4F,CAAC,CAAC,CAAC;QAC3H,CAAC,CAAC;QAEF,MAAM,yBAAyB,GAAG,GAAG,EAAE;YACnC,oBAAoB;YACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAChB,OAAO;YACX,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAC;YACnE,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;QACnE,CAAC,CAAC;QAEF,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAE7B,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IACtD,CAAC;CACJ;AAtFD,kDAsFC"}

package/dist/source/client_transport_base.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @module node-opcua-transport
+ *
+ * Transport-agnostic base class for client-side OPC UA transports.
+ *
+ * Owns the UACP HEL/ACK handshake, the negotiated transport settings, and the
+ * post-connect connection-break detector. Concrete subclasses (`ClientTCP_transport`,
+ * `ClientWS_transport`, ...) implement only the socket-creation step in `connect()`.
+ *
+ * Browser-safe: does not import `node:net`, `node:os`, `node:util`, or any other
+ * Node-only built-in beyond what `TCP_transport` already inherits from `node:events`.
+ */
+import type { ErrorCallback } from "node-opcua-status-code";
+import { AcknowledgeMessage } from "./AcknowledgeMessage";
+import type { TransportSettingsOptions } from "./i_client_transport";
+import { TCP_transport } from "./tcp_transport";
+export interface ClientTransportBase {
+    on(eventName: "chunk", eventHandler: (messageChunk: Buffer) => void): this;
+    on(eventName: "close", eventHandler: (err: Error | null) => void): this;
+    on(eventName: "connection_break", eventHandler: (err: Error | null) => void): this;
+    on(eventName: "connect", eventHandler: () => void): this;
+    once(eventName: "chunk", eventHandler: (messageChunk: Buffer) => void): this;
+    once(eventName: "close", eventHandler: (err: Error | null) => void): this;
+    once(eventName: "connection_break", eventHandler: (err: Error | null) => void): this;
+    once(eventName: "connect", eventHandler: () => void): this;
+    emit(eventName: "chunk", messageChunk: Buffer): boolean;
+    emit(eventName: "close", err?: Error | null): boolean;
+    emit(eventName: "connection_break", err?: Error | null): boolean;
+    emit(eventName: "connect"): boolean;
+}
+export declare abstract class ClientTransportBase extends TCP_transport {
+    static defaultMaxChunk: number;
+    static defaultMaxMessageSize: number;
+    static defaultReceiveBufferSize: number;
+    static defaultSendBufferSize: number;
+    endpointUrl: string;
+    serverUri: string;
+    numberOfRetry: number;
+    parameters?: AcknowledgeMessage;
+    private _counter;
+    private _helloSettings;
+    constructor(transportSettings?: TransportSettingsOptions);
+    getTransportSettings(): TransportSettingsOptions;
+    dispose(): void;
+    /**
+     * Connect to `endpointUrl` and perform the UACP HEL/ACK handshake.
+     * Concrete subclasses are responsible for opening the underlying socket
+     * (TCP, WebSocket, ...) and then driving the inherited HEL/ACK machinery.
+     */
+    abstract connect(endpointUrl: string, callback: ErrorCallback): void;
+    /**
+     * Install the post-connect "connection break" detector. Subclasses call this
+     * once the underlying socket is open and the HEL/ACK transaction has succeeded.
+     *
+     * Detects ECONNRESET / EPIPE / premature socket termination on the live socket
+     * and re-emits them as `connection_break` so reconnection logic upstream can
+     * react.
+     */
+    protected _install_post_connect_error_handler(endpointUrl: string): void;
+    protected _perform_HEL_ACK_transaction(callback: ErrorCallback): void;
+    private _send_HELLO_request;
+    private _on_ACK_response;
+    private _handle_ACK_response;
+}

package/dist/source/client_transport_base.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * @module node-opcua-transport
+ *
+ * Transport-agnostic base class for client-side OPC UA transports.
+ *
+ * Owns the UACP HEL/ACK handshake, the negotiated transport settings, and the
+ * post-connect connection-break detector. Concrete subclasses (`ClientTCP_transport`,
+ * `ClientWS_transport`, ...) implement only the socket-creation step in `connect()`.
+ *
+ * Browser-safe: does not import `node:net`, `node:os`, `node:util`, or any other
+ * Node-only built-in beyond what `TCP_transport` already inherits from `node:events`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientTransportBase = void 0;
+const node_opcua_assert_1 = require("node-opcua-assert");
+const node_opcua_binary_stream_1 = require("node-opcua-binary-stream");
+const node_opcua_chunkmanager_1 = require("node-opcua-chunkmanager");
+const node_opcua_debug_1 = require("node-opcua-debug");
+const AcknowledgeMessage_1 = require("./AcknowledgeMessage");
+const HelloMessage_1 = require("./HelloMessage");
+const TCPErrorMessage_1 = require("./TCPErrorMessage");
+const tcp_transport_1 = require("./tcp_transport");
+const tools_1 = require("./tools");
+const utils_1 = require("./utils");
+// Use a string category instead of `__filename` so the module loads in
+// browsers without a Node-style filename global.
+const doDebug = (0, node_opcua_debug_1.checkDebugFlag)("ClientTransportBase");
+const debugLog = (0, node_opcua_debug_1.make_debugLog)("ClientTransportBase");
+const warningLog = (0, node_opcua_debug_1.make_warningLog)("ClientTransportBase");
+// biome-ignore lint/suspicious/noUnsafeDeclarationMerging: companion to the interface above
+class ClientTransportBase extends tcp_transport_1.TCP_transport {
+    static defaultMaxChunk = 0; // 0 - no limits
+    static defaultMaxMessageSize = 0; // 0 - no limits
+    static defaultReceiveBufferSize = 1024 * 64 * 10;
+    static defaultSendBufferSize = 1024 * 64 * 10; // 8192 min,
+    endpointUrl;
+    serverUri;
+    numberOfRetry;
+    parameters;
+    _counter;
+    _helloSettings;
+    constructor(transportSettings) {
+        super();
+        this.endpointUrl = "";
+        this.serverUri = "";
+        this._counter = 0;
+        this.numberOfRetry = 0;
+        // initially before HEL/ACK
+        this.maxChunkCount = 1;
+        this.maxMessageSize = 4 * 1024;
+        this.receiveBufferSize = 4 * 1024;
+        transportSettings = transportSettings || {};
+        this._helloSettings = {
+            maxChunkCount: transportSettings.maxChunkCount || ClientTransportBase.defaultMaxChunk,
+            maxMessageSize: transportSettings.maxMessageSize || ClientTransportBase.defaultMaxMessageSize,
+            receiveBufferSize: transportSettings.receiveBufferSize || ClientTransportBase.defaultReceiveBufferSize,
+            sendBufferSize: transportSettings.sendBufferSize || ClientTransportBase.defaultSendBufferSize
+        };
+    }
+    getTransportSettings() {
+        return this._helloSettings;
+    }
+    dispose() {
+        /* c8 ignore next */
+        doDebug && debugLog(" ClientTransportBase disposed");
+        super.dispose();
+    }
+    /**
+     * Install the post-connect "connection break" detector. Subclasses call this
+     * once the underlying socket is open and the HEL/ACK transaction has succeeded.
+     *
+     * Detects ECONNRESET / EPIPE / premature socket termination on the live socket
+     * and re-emits them as `connection_break` so reconnection logic upstream can
+     * react.
+     */
+    _install_post_connect_error_handler(endpointUrl) {
+        if (!this._socket)
+            return;
+        this._socket.on("error", (err) => {
+            // EPIPE : a write on a pipe/socket/FIFO with no reader.
+            // ECONNRESET : connection forcibly closed by the peer (timeout, reboot, ...).
+            // "premature socket termination" : abrupt close mid-message.
+            if (err.message.match(/ECONNRESET|EPIPE|premature socket termination/)) {
+                /* c8 ignore next */
+                doDebug && debugLog("connection_break after reconnection", endpointUrl);
+                this.emit("connection_break", err);
+            }
+        });
+    }
+    _perform_HEL_ACK_transaction(callback) {
+        /* c8 ignore next */
+        if (!this._socket) {
+            callback(new Error("No socket available to perform HEL/ACK transaction"));
+            return;
+        }
+        (0, node_opcua_assert_1.assert)(this._socket, "expecting a valid socket to send a message");
+        (0, node_opcua_assert_1.assert)(typeof callback === "function");
+        this._counter = 0;
+        /* c8 ignore next */
+        doDebug && debugLog("entering _perform_HEL_ACK_transaction");
+        this._install_one_time_message_receiver((err, data) => {
+            /* c8 ignore next */
+            doDebug && debugLog("before  _on_ACK_response ", err ? err.message : "");
+            this._on_ACK_response(callback, err, data);
+        });
+        this._send_HELLO_request();
+    }
+    _send_HELLO_request() {
+        /* c8 ignore next */
+        doDebug && debugLog("entering _send_HELLO_request");
+        (0, node_opcua_assert_1.assert)(this._socket);
+        (0, node_opcua_assert_1.assert)(Number.isFinite(this.protocolVersion));
+        (0, node_opcua_assert_1.assert)(this.endpointUrl.length > 0, " expecting a valid endpoint url");
+        const { maxChunkCount, maxMessageSize, receiveBufferSize, sendBufferSize } = this._helloSettings;
+        const helloMessage = new HelloMessage_1.HelloMessage({
+            endpointUrl: this.endpointUrl,
+            protocolVersion: this.protocolVersion,
+            maxChunkCount,
+            maxMessageSize,
+            receiveBufferSize,
+            sendBufferSize
+        });
+        // c8 ignore next
+        utils_1.doTraceHelloAck && warningLog(`sending Hello\n ${helloMessage.toString()} `);
+        const messageChunk = (0, tools_1.packTcpMessage)("HEL", helloMessage);
+        this._write_chunk(messageChunk);
+    }
+    _on_ACK_response(externalCallback, err, data) {
+        /* c8 ignore next */
+        doDebug && debugLog("entering _on_ACK_response");
+        (0, node_opcua_assert_1.assert)(typeof externalCallback === "function");
+        (0, node_opcua_assert_1.assert)(this._counter === 0, "Ack response should only be received once !");
+        this._counter += 1;
+        if (err || !data) {
+            if (this._socket) {
+                const s = this._socket;
+                this._socket = null;
+                s.destroy();
+            }
+            externalCallback(err || new Error("no data"));
+        }
+        else {
+            this._handle_ACK_response(data, externalCallback);
+        }
+    }
+    _handle_ACK_response(messageChunk, callback) {
+        const _stream = new node_opcua_binary_stream_1.BinaryStream(messageChunk);
+        const messageHeader = (0, node_opcua_chunkmanager_1.readMessageHeader)(_stream);
+        let err = null;
+        /* c8 ignore next */
+        if (messageHeader.isFinal !== "F") {
+            err = new Error(" invalid ACK message");
+            callback(err);
+            return;
+        }
+        let responseClass;
+        let response;
+        if (messageHeader.msgType === "ERR") {
+            responseClass = TCPErrorMessage_1.TCPErrorMessage;
+            _stream.rewind();
+            response = (0, tools_1.decodeMessage)(_stream, responseClass);
+            err = new Error(`ACK: ERR received ${response.statusCode.toString()} : ${response.reason}`);
+            // biome-ignore lint/suspicious/noExplicitAny: legacy diagnostic field tacked onto Error
+            err.statusCode = response.statusCode;
+            // c8 ignore next
+            utils_1.doTraceHelloAck && warningLog("receiving ERR instead of Ack", response.toString());
+            callback(err);
+        }
+        else {
+            responseClass = AcknowledgeMessage_1.AcknowledgeMessage;
+            _stream.rewind();
+            response = (0, tools_1.decodeMessage)(_stream, responseClass);
+            this.parameters = response;
+            this.setLimits(response);
+            // c8 ignore next
+            utils_1.doTraceHelloAck && warningLog("receiving Ack\n", response.toString());
+            callback();
+        }
+    }
+}
+exports.ClientTransportBase = ClientTransportBase;
+//# sourceMappingURL=client_transport_base.js.map

package/dist/source/client_transport_base.js.map

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

package/dist/source/default_client_transport_factory.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @module node-opcua-transport
+ */
+import type { IClientTransportFactory } from "./i_client_transport";
+/**
+ * The default client-transport factory, which returns a {@link ClientTCP_transport}.
+ *
+ * This is the implicit factory used by {@link ClientSecureChannelLayer} when no
+ * `transportFactory` option is provided, preserving the historical (Node-only)
+ * behavior byte-for-byte.
+ */
+export declare const defaultClientTransportFactory: IClientTransportFactory;

package/dist/source/default_client_transport_factory.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * @module node-opcua-transport
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultClientTransportFactory = void 0;
+const client_tcp_transport_1 = require("./client_tcp_transport");
+/**
+ * The default client-transport factory, which returns a {@link ClientTCP_transport}.
+ *
+ * This is the implicit factory used by {@link ClientSecureChannelLayer} when no
+ * `transportFactory` option is provided, preserving the historical (Node-only)
+ * behavior byte-for-byte.
+ */
+exports.defaultClientTransportFactory = {
+    create(settings) {
+        return new client_tcp_transport_1.ClientTCP_transport(settings);
+    }
+};
+//# sourceMappingURL=default_client_transport_factory.js.map

package/dist/source/default_client_transport_factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default_client_transport_factory.js","sourceRoot":"","sources":["../../source/default_client_transport_factory.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iEAA4F;AAG5F;;;;;;GAMG;AACU,QAAA,6BAA6B,GAA4B;IAClE,MAAM,CAAC,QAAmC;QACtC,OAAO,IAAI,0CAAmB,CAAC,QAAQ,CAAqB,CAAC;IACjE,CAAC;CACJ,CAAC"}