Function connectWebSocket

connectWebSocket(
url: string,
opts?: Omit<MqttConnectOptions, "hostname" | "transport" | "url">,
): Promise<MqttSession>
Connects to an MQTT broker over WebSocket (subprotocol mqtt) and returns a live session.

Opens the WebSocket with the mqtt subprotocol, wraps it in a binary-frame packet transport, and runs the same CONNECT/CONNACK handshake and read pump as the TCP path. The WS carries the identical MQTT control packets as binary frames. Use this for brokers fronted by a WebSocket listener, or set transport: 'ws' with a url on connect.
Parameters
- url: string
  The ws:// or wss:// broker endpoint.
- opts: Omit<MqttConnectOptions, "hostname" | "transport" | "url"> = {}
  Connection and credential options (the hostname field is unused here).
Returns Promise<MqttSession>
The live session.
Throws
If the broker rejects the credentials.

Throws
If the WebSocket upgrade fails.

Throws
If the broker speaks the protocol incorrectly.

Since
1.0.0
Example
```
import { connectWebSocket } from 'edgeport/mqtt';

await using mqtt = await connectWebSocket('wss://broker.example.com/mqtt', { hostname: 'broker' });
await mqtt.publish('a/b', 'hello');
```
- Defined in src/mqtt/index.ts:886