node-opcua / node-opcua / 25845700254 / 1

92%

master: 92%

push

github

feat(client-browser): WebSocket transport + unit tests

Second slice of the browser-client split. Adds the
`node-opcua-client-browser` WebSocket transport implementation that
satisfies `IClientTransport` from `node-opcua-transport`, so the upstream
`ClientSecureChannelLayer.transportFactory` option (merged as #1503) can
route client traffic over `opc.ws://` / `opc.wss://` in addition to
`opc.tcp://`.

Purely additive: no existing source file is modified; the package's
public surface grows from `{ VERSION }` to `{ VERSION, ClientWS_transport,
browserWsTransportFactory, parseWsEndpointUrl, OPCUA_UACP_SUBPROTOCOL,
WsSocketAdapter, uacp }`. Follow-up PRs add `createBrowserClient()`, the
standalone browser bundle (esbuild + shims), and the full OPC UA E2E
specs that replace the current smoke test.

Thin re-exports of the byte-level UACP encoders/decoders from
`node-opcua-transport` (`AcknowledgeMessage`, `HelloMessage`,
`TCPErrorMessage`, `packTcpMessage`, `readRawMessageHeader`). Single
point of audit if a future release introduces a Node-only import there.

`WsSocketAdapter` wraps a browser/`ws`-package WebSocket into an
`ISocketLike` that `TCP_transport` from `node-opcua-transport` can
consume unchanged. Handles:

- event translation: `open` → `connect`, binary `message` → `data`,
  `close` → `end` + `close(hadError)`, `error` → `error`.
- outgoing writes: ArrayBuffer/Buffer/Uint8Array normalized to a
  binary WebSocket frame (one UACP chunk per frame, per Part 6 §7.5).
- lifecycle: `end()` closes with code 1000, `destroy()` with 1001.
- stubs for `setKeepAlive`, `setNoDelay`, `setTimeout` so the
  TCP_transport setup sequence runs without changes.

Text frames are ignored with a `console.warn`, per spec.

`ClientWS_transport extends ClientTCP_transport`. Overrides `connect()`
to construct a `WebSocket`, wrap it in `WsSocketAdapter`, and hand it
to the parent's `_install_socket` + `_perform_HEL_ACK_transaction`.
HEL/ACK + chunk-reassembly machinery is i... (continued)

18650 of 22175 branches covered (84.1%)

163437 of 177314 relevant lines covered (92.17%)

469087.59 hits per line