node-opcua / node-opcua / 25273947109

92%

Build Type

push

github

Committed by erossignon

Commit Message

feat(transport): add IClientTransport interface and default factory

Adds two new files to node-opcua-transport plus two re-exports from
source/index.ts. No behaviour change; no edits to ClientTCP_transport or
any other existing file.

- source/i_client_transport.ts — new interface IClientTransport. Codifies
  the surface that ClientSecureChannelLayer already duck-types against
  ClientTCP_transport: lifecycle (connect, disconnect, dispose, write,
  prematureTerminate, forceConnectionBreak, isValid, isDisconnecting),
  diagnostic fields (bytesRead, bytesWritten, chunkReadCount,
  chunkWrittenCount, name), HEL/ACK negotiated values (parameters,
  receiveBufferSize, sendBufferSize, maxChunkCount, maxMessageSize),
  mutable config (protocolVersion, timeout, numberOfRetry, endpointUrl,
  serverUri), and the typed EventEmitter events (chunk, close, connect,
  connection_break). ClientTCP_transport satisfies this interface
  structurally; no changes to the class are required.

- source/default_client_transport_factory.ts — new interface
  IClientTransportFactory with a single create(settings?): IClientTransport
  method, plus a concrete defaultClientTransportFactory whose create()
  returns new ClientTCP_transport(opts). Preserves every Node-side code
  path that currently constructs ClientTCP_transport directly.

This is the first of a small series that introduces a pluggable seam at
the secure-channel layer. Splitting from the follow-up (transportFactory
option on ClientSecureChannelLayerOptions) because the interface and the
consumer-side wiring are two distinct changes with independent review
surface:

1. This commit: define the contract that any transport must satisfy;
   provide a default factory that reproduces current behaviour
   byte-for-byte.
2. Follow-up: add an optional transportFactory option to
   ClientSecureChannelLayerOptions that threads through to channel
   construction.

On its own, this commit adds two unused public exports. The follo... (continued)

Coverage Stats

18484 of 21956 branches covered (84.19%)

145 of 145 new or added lines in 3 files covered. (100.0%)

5 existing lines in 1 file now uncovered.

162337 of 176059 relevant lines covered (92.21%)

471849.14 hits per line