@bridgething/adapter-network 0.1.4

package/README.md

@@ -0,0 +1,90 @@
+# @bridgething/adapter-network
+
+Network-gateway transport for [`@bridgething/gateway`](../gateway/typescript).
+Speaks the daemon's WebSocket gateway on TCP port 8892 (`bridgething.local`
+by default), so any host that can open a WebSocket can drive a Car Thing
+without native code, NAPI bindings, or platform-specific Bluetooth stacks.
+
+Replaces the retired `@bridgething/adapter-node`.
+
+## Quick start
+
+```ts
+import { BridgethingGateway } from '@bridgething/gateway';
+import { NetworkAdapter } from '@bridgething/adapter-network';
+
+const adapter = new NetworkAdapter(); // defaults to ws://bridgething.local:8892/
+const gateway = new BridgethingGateway(adapter);
+
+gateway.on(event => {
+  if (event.type === 'connected') console.log('up:', event.device);
+  if (event.type === 'disconnected') console.log('down:', event.deviceId);
+});
+
+await gateway.start();
+```
+
+## Single device, custom host
+
+```ts
+new NetworkAdapter({ discovery: 'ws://10.42.1.1:8892/' });
+new NetworkAdapter({ discovery: { id: 'lab-1', url: 'ws://thing-a.local:8892/', name: 'Lab A' } });
+```
+
+## Multiple known hosts
+
+```ts
+new NetworkAdapter({
+  discovery: [
+    { id: 'rack-1', url: 'ws://thing-a.local:8892/' },
+    { id: 'rack-2', url: 'ws://thing-b.local:8892/' },
+  ],
+});
+```
+
+## mDNS browsing
+
+For Node / Bun. Install the optional peer dependency first:
+
+```sh
+bun add bonjour-service
+```
+
+```ts
+import { NetworkAdapter } from '@bridgething/adapter-network';
+import { MDNSDiscoverer } from '@bridgething/adapter-network/mdns';
+
+const adapter = new NetworkAdapter({ discovery: new MDNSDiscoverer() });
+```
+
+`MDNSDiscoverer` browses `_bridgething._tcp` and surfaces each daemon as
+its own `Endpoint` with the device's mDNS-advertised nickname propagated
+through `Endpoint.metadata.nickname`.
+
+## Browser support
+
+`NetworkAdapter` works in browsers that can open WebSockets. The default
+URL (`ws://bridgething.local:8892/`) relies on the OS resolver for `.local`
+hostnames (mDNS via systemd-resolved / mDNSResponder / Windows DNS Client).
+mDNS *browsing* is not available in browsers; use the static-URL form.
+
+For the in-browser Bluetooth Classic path, use `WebSerialAdapter` from
+`@bridgething/gateway` instead — `NetworkAdapter` covers the dev-tether
+(USB-CDC-ECM) case only.
+
+## Reconnection
+
+Per-peer auto-reconnect with exponential backoff (`500ms → 15s`, ladder
+repeats). Configure with `options.reconnect`:
+
+```ts
+new NetworkAdapter({ reconnect: false });                  // off
+new NetworkAdapter({ reconnect: [1000, 5000, 30000] });    // custom ladder
+```
+
+## Posture
+
+The network gateway has no auth (matches the project posture). Treat the
+WebSocket like a debug interface: only expose it on the USB-CDC-ECM
+gadget link or a trusted LAN. The daemon binds `0.0.0.0:8892`, so deny
+external reach with the host firewall if the device is wifi-bridged.

package/dist/discovery.d.ts

@@ -0,0 +1,44 @@
+/**
+ * A discoverer surfaces bridgething daemons reachable over the network gateway WebSocket.
+ * The adapter opens/closes connections as `Endpoint` lifecycle events arrive.
+ *
+ * Two bundled implementations:
+ *   - `StaticDiscoverer`: one fixed URL, works everywhere including browsers.
+ *   - `MDNSDiscoverer`: browses `_bridgething._tcp` (Node/Bun only; optional `bonjour-service` peer dep).
+ *
+ * Callers can supply their own (e.g. polling a config file, resolving hostnames over DNS).
+ */
+/** A daemon reachable at `url`. `id` is stable for the endpoint's lifetime and used as the adapter's `deviceId`. */
+export type Endpoint = {
+    id: string;
+    url: string;
+    name?: string;
+    metadata?: Record<string, string>;
+};
+export type DiscoveryListener = {
+    type: 'found';
+    endpoint: Endpoint;
+} | {
+    type: 'lost';
+    id: string;
+};
+export interface Discoverer {
+    start(listener: (event: DiscoveryListener) => void): Promise<void>;
+    stop(): Promise<void>;
+}
+/**
+ * Single fixed endpoint. The common case: USB-CDC-ECM tether with `bridgething.local:8892`.
+ * Works in the browser and on any host whose resolver understands `.local`.
+ */
+export declare class StaticDiscoverer implements Discoverer {
+    private readonly endpoint;
+    private started;
+    constructor(options: {
+        url: string;
+        id?: string;
+        name?: string;
+    } | string);
+    start(listener: (event: DiscoveryListener) => void): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oHAAoH;AACpH,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAErG,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IASzE,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAItB"}

package/dist/discovery.js

@@ -0,0 +1,38 @@
+/**
+ * A discoverer surfaces bridgething daemons reachable over the network gateway WebSocket.
+ * The adapter opens/closes connections as `Endpoint` lifecycle events arrive.
+ *
+ * Two bundled implementations:
+ *   - `StaticDiscoverer`: one fixed URL, works everywhere including browsers.
+ *   - `MDNSDiscoverer`: browses `_bridgething._tcp` (Node/Bun only; optional `bonjour-service` peer dep).
+ *
+ * Callers can supply their own (e.g. polling a config file, resolving hostnames over DNS).
+ */
+/**
+ * Single fixed endpoint. The common case: USB-CDC-ECM tether with `bridgething.local:8892`.
+ * Works in the browser and on any host whose resolver understands `.local`.
+ */
+export class StaticDiscoverer {
+    endpoint;
+    started = false;
+    constructor(options) {
+        const opts = typeof options === 'string' ? { url: options } : options;
+        this.endpoint = {
+            id: opts.id ?? opts.url,
+            url: opts.url,
+            name: opts.name,
+        };
+    }
+    start(listener) {
+        if (this.started)
+            return Promise.resolve();
+        this.started = true;
+        listener({ type: 'found', endpoint: this.endpoint });
+        return Promise.resolve();
+    }
+    stop() {
+        this.started = false;
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiBH;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACV,QAAQ,CAAW;IAC5B,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,OAA6D;QACvE,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACtE,IAAI,CAAC,QAAQ,GAAG;YACd,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG;YACvB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAA4C;QAChD,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+import type { Adapter, AdapterListener } from '@bridgething/gateway';
+import { LogVerbosity } from '@bridgething/lib';
+import { StaticDiscoverer, type Discoverer, type DiscoveryListener, type Endpoint } from './discovery';
+export { StaticDiscoverer, type Discoverer, type DiscoveryListener, type Endpoint };
+export type NetworkAdapterOptions = {
+    /**
+     * Where to look for daemons. Pass a string URL or an `Endpoint` for the
+     * common single-device case, an array for multiple known hosts, or a
+     * `Discoverer` for mDNS / custom strategies.
+     */
+    discovery?: string | Endpoint | Endpoint[] | Discoverer;
+    /** Constructor for the underlying WebSocket. Defaults to the global. */
+    websocket?: typeof WebSocket;
+    /**
+     * Auto-reconnect dropped peers with exponential backoff. The default
+     * ladder is `[500, 1_000, 2_000, 4_000, 8_000, 15_000]` ms; the last
+     * entry repeats. Set to `false` to disable.
+     */
+    reconnect?: boolean | number[];
+    logLevel?: LogVerbosity;
+};
+/**
+ * Byte-level transport for `@bridgething/gateway` over the daemon's network gateway WebSocket.
+ * One instance can hold many peers; each `Endpoint` becomes a `Device` whose `id` is the
+ * gateway-visible `deviceId`. Works wherever a `WebSocket` exists.
+ */
+export declare class NetworkAdapter implements Adapter {
+    private readonly logger;
+    private readonly listeners;
+    private readonly peers;
+    private readonly websocketCtor;
+    private readonly reconnectLadder;
+    private readonly discoverer;
+    private running;
+    constructor(options?: NetworkAdapterOptions);
+    on(listener: AdapterListener): void;
+    off(listener: AdapterListener): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    disconnect(deviceId: string): Promise<void>;
+    send(deviceId: string, frame: Uint8Array): Promise<void>;
+    private handleDiscovery;
+    private emit;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAgB,eAAe,EAAU,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAU,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvG,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,CAAC;AAIpF,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,EAAE,GAAG,UAAU,CAAC;IAExD,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAE7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAE/B,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,qBAAa,cAAe,YAAW,OAAO;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,qBAA0B;IAkB/C,EAAE,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAInC,GAAG,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxD,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,IAAI;CASb"}

package/dist/index.js

@@ -0,0 +1,344 @@
+import { Logger, LogVerbosity } from '@bridgething/lib';
+import { StaticDiscoverer } from './discovery';
+export { StaticDiscoverer };
+const DEFAULT_RECONNECT_BACKOFF_MS = [500, 1_000, 2_000, 4_000, 8_000, 15_000];
+/**
+ * Byte-level transport for `@bridgething/gateway` over the daemon's network gateway WebSocket.
+ * One instance can hold many peers; each `Endpoint` becomes a `Device` whose `id` is the
+ * gateway-visible `deviceId`. Works wherever a `WebSocket` exists.
+ */
+export class NetworkAdapter {
+    logger;
+    listeners = new Set();
+    peers = new Map();
+    websocketCtor;
+    reconnectLadder;
+    discoverer;
+    running = false;
+    constructor(options = {}) {
+        this.logger = new Logger('NetworkAdapter', options.logLevel ?? LogVerbosity.Log);
+        this.websocketCtor =
+            options.websocket ?? (typeof WebSocket !== 'undefined' ? WebSocket : undefined);
+        if (!this.websocketCtor) {
+            throw new Error('NetworkAdapter: no global WebSocket. Pass `options.websocket` (e.g. import { WebSocket } from "ws" on older Node).');
+        }
+        this.reconnectLadder =
+            options.reconnect === false
+                ? null
+                : Array.isArray(options.reconnect)
+                    ? options.reconnect
+                    : DEFAULT_RECONNECT_BACKOFF_MS;
+        this.discoverer = resolveDiscoverer(options.discovery);
+    }
+    on(listener) {
+        this.listeners.add(listener);
+    }
+    off(listener) {
+        this.listeners.delete(listener);
+    }
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        await this.discoverer.start(event => this.handleDiscovery(event));
+    }
+    async stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        await this.discoverer.stop();
+        const peers = Array.from(this.peers.values());
+        this.peers.clear();
+        for (const peer of peers)
+            peer.shutdown('adapter-stop');
+    }
+    disconnect(deviceId) {
+        const peer = this.peers.get(deviceId);
+        if (!peer)
+            return Promise.resolve();
+        this.peers.delete(deviceId);
+        peer.shutdown('client-disconnect');
+        return Promise.resolve();
+    }
+    send(deviceId, frame) {
+        const peer = this.peers.get(deviceId);
+        if (!peer)
+            return Promise.reject(new Error(`network-adapter: no active peer for ${deviceId}`));
+        peer.send(frame);
+        return Promise.resolve();
+    }
+    handleDiscovery(event) {
+        if (event.type === 'found') {
+            const existing = this.peers.get(event.endpoint.id);
+            if (existing) {
+                existing.updateEndpoint(event.endpoint);
+                return;
+            }
+            const peer = new Peer({
+                endpoint: event.endpoint,
+                websocketCtor: this.websocketCtor,
+                reconnectLadder: this.reconnectLadder,
+                logger: this.logger,
+                emit: e => this.emit(e),
+            });
+            this.peers.set(event.endpoint.id, peer);
+            peer.start();
+            return;
+        }
+        const peer = this.peers.get(event.id);
+        if (!peer)
+            return;
+        this.peers.delete(event.id);
+        peer.shutdown('discoverer-lost');
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (err) {
+                this.logger.error('listener threw', err);
+            }
+        }
+    }
+}
+function resolveDiscoverer(input) {
+    if (!input)
+        return new StaticDiscoverer({ url: defaultUrl() });
+    if (typeof input === 'string')
+        return new StaticDiscoverer({ url: input });
+    if (Array.isArray(input))
+        return new MultiStaticDiscoverer(input);
+    if (isDiscoverer(input))
+        return input;
+    return new StaticDiscoverer({ url: input.url, id: input.id, name: input.name });
+}
+function isDiscoverer(value) {
+    return ('start' in value &&
+        typeof value.start === 'function' &&
+        'stop' in value &&
+        typeof value.stop === 'function');
+}
+function defaultUrl() {
+    return 'ws://bridgething.local:8892/';
+}
+class MultiStaticDiscoverer {
+    endpoints;
+    started = false;
+    constructor(endpoints) {
+        this.endpoints = endpoints;
+    }
+    start(listener) {
+        if (this.started)
+            return Promise.resolve();
+        this.started = true;
+        for (const endpoint of this.endpoints) {
+            listener({ type: 'found', endpoint });
+        }
+        return Promise.resolve();
+    }
+    stop() {
+        this.started = false;
+        return Promise.resolve();
+    }
+}
+class Peer {
+    endpoint;
+    websocketCtor;
+    reconnectLadder;
+    logger;
+    emit;
+    socket = null;
+    connected = false;
+    intentionalClose = false;
+    reconnectTimer = null;
+    reconnectAttempt = 0;
+    sendQueue = [];
+    constructor(opts) {
+        this.endpoint = opts.endpoint;
+        this.websocketCtor = opts.websocketCtor;
+        this.reconnectLadder = opts.reconnectLadder;
+        this.logger = opts.logger;
+        this.emit = opts.emit;
+    }
+    start() {
+        this.openSocket();
+    }
+    updateEndpoint(next) {
+        const urlChanged = next.url !== this.endpoint.url;
+        this.endpoint = next;
+        if (!urlChanged)
+            return;
+        this.logger.log(`endpoint ${next.id} url changed to ${next.url}, reconnecting`);
+        this.reconnectSoon();
+    }
+    send(frame) {
+        if (this.socket && this.connected) {
+            try {
+                this.socket.send(toArrayBufferSlice(frame));
+            }
+            catch (err) {
+                this.logger.warn(`send to ${this.endpoint.id} failed, queueing`, err);
+                this.sendQueue.push(frame);
+                this.reconnectSoon();
+            }
+            return;
+        }
+        this.sendQueue.push(frame);
+    }
+    shutdown(reason) {
+        this.intentionalClose = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.sendQueue = [];
+        const socket = this.socket;
+        this.socket = null;
+        if (socket) {
+            try {
+                socket.close(1000, reason);
+            }
+            catch {
+                // best-effort
+            }
+        }
+        if (this.connected) {
+            this.connected = false;
+            this.emit({ type: 'disconnected', deviceId: this.endpoint.id });
+        }
+    }
+    openSocket() {
+        if (this.intentionalClose)
+            return;
+        let socket;
+        try {
+            socket = new this.websocketCtor(this.endpoint.url);
+        }
+        catch (err) {
+            this.logger.warn(`failed to construct websocket for ${this.endpoint.url}`, err);
+            this.scheduleReconnect();
+            return;
+        }
+        socket.binaryType = 'arraybuffer';
+        this.socket = socket;
+        socket.addEventListener('open', () => {
+            this.connected = true;
+            this.reconnectAttempt = 0;
+            this.emit({
+                type: 'connected',
+                device: this.deviceForEndpoint(),
+            });
+            this.flushQueue();
+        });
+        socket.addEventListener('message', event => this.handleMessage(event.data));
+        socket.addEventListener('close', () => {
+            this.socket = null;
+            if (this.connected) {
+                this.connected = false;
+                this.emit({ type: 'disconnected', deviceId: this.endpoint.id });
+            }
+            if (!this.intentionalClose)
+                this.scheduleReconnect();
+        });
+        socket.addEventListener('error', () => {
+            this.logger.trace(`ws error on ${this.endpoint.id}`);
+        });
+    }
+    handleMessage(raw) {
+        let bytes = null;
+        if (raw instanceof ArrayBuffer)
+            bytes = new Uint8Array(raw);
+        else if (raw instanceof Uint8Array)
+            bytes = raw;
+        else if (ArrayBuffer.isView(raw)) {
+            const view = raw;
+            bytes = new Uint8Array(view.buffer, view.byteOffset, view.byteLength);
+        }
+        else if (typeof raw === 'string') {
+            this.logger.warn(`unexpected text frame from ${this.endpoint.id}; network gateway is binary-only`);
+            return;
+        }
+        else if (raw && typeof raw.arrayBuffer === 'function') {
+            void raw
+                .arrayBuffer()
+                .then(buf => this.emit({ type: 'bytes', deviceId: this.endpoint.id, data: new Uint8Array(buf) }))
+                .catch(err => this.logger.warn(`failed to read Blob frame from ${this.endpoint.id}`, err));
+            return;
+        }
+        if (!bytes || bytes.byteLength === 0)
+            return;
+        this.emit({ type: 'bytes', deviceId: this.endpoint.id, data: bytes });
+    }
+    flushQueue() {
+        const queued = this.sendQueue;
+        this.sendQueue = [];
+        for (const frame of queued) {
+            if (!this.socket || !this.connected) {
+                this.sendQueue.push(frame);
+                continue;
+            }
+            try {
+                this.socket.send(toArrayBufferSlice(frame));
+            }
+            catch (err) {
+                this.logger.warn(`flush send to ${this.endpoint.id} failed`, err);
+                this.sendQueue.push(frame);
+                this.reconnectSoon();
+                return;
+            }
+        }
+    }
+    reconnectSoon() {
+        if (this.intentionalClose)
+            return;
+        const socket = this.socket;
+        this.socket = null;
+        if (socket) {
+            try {
+                socket.close(1000, 'reconnect');
+            }
+            catch {
+                // best-effort
+            }
+        }
+        if (this.connected) {
+            this.connected = false;
+            this.emit({ type: 'disconnected', deviceId: this.endpoint.id });
+        }
+        this.scheduleReconnect();
+    }
+    scheduleReconnect() {
+        if (!this.reconnectLadder)
+            return;
+        const idx = Math.min(this.reconnectAttempt, this.reconnectLadder.length - 1);
+        const delay = this.reconnectLadder[idx];
+        this.reconnectAttempt += 1;
+        if (this.reconnectTimer)
+            clearTimeout(this.reconnectTimer);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.openSocket();
+        }, delay);
+    }
+    deviceForEndpoint() {
+        return {
+            id: this.endpoint.id,
+            name: this.endpoint.name ?? this.endpoint.url,
+        };
+    }
+}
+/**
+ * DOM type checking rejects `Uint8Array<ArrayBufferLike>` because the union includes
+ * `SharedArrayBuffer`. The codec only produces `ArrayBuffer`-backed views, so this slice is safe.
+ */
+function toArrayBufferSlice(frame) {
+    const buffer = frame.buffer;
+    if (buffer instanceof ArrayBuffer && frame.byteOffset === 0 && frame.byteLength === buffer.byteLength) {
+        return buffer;
+    }
+    const out = new ArrayBuffer(frame.byteLength);
+    new Uint8Array(out).set(frame);
+    return out;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mdns.d.ts

@@ -0,0 +1,26 @@
+import type { Discoverer, DiscoveryListener } from './discovery';
+export type MDNSDiscovererOptions = {
+    /** Service type without the `_…._tcp` decoration. Defaults to `bridgething`. */
+    serviceType?: string;
+    /** Override the URL builder. Default builds `ws://<host>:<port>/`. */
+    buildUrl?: (service: {
+        host: string;
+        port: number;
+        addresses: string[];
+        nickname?: string;
+    }) => string;
+};
+export declare class MDNSDiscoverer implements Discoverer {
+    private readonly serviceType;
+    private readonly buildUrl;
+    private bonjour;
+    private browser;
+    private readonly seen;
+    constructor(options?: MDNSDiscovererOptions);
+    start(listener: (event: DiscoveryListener) => void): Promise<void>;
+    stop(): Promise<void>;
+    private endpointFor;
+}
+/** Convenience factory mirroring the daemon's defaults. */
+export declare function discoverBridgethingDaemons(options?: MDNSDiscovererOptions): MDNSDiscoverer;
+//# sourceMappingURL=mdns.d.ts.map

package/dist/mdns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdns.d.ts","sourceRoot":"","sources":["../src/mdns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAY,MAAM,aAAa,CAAC;AAgC3E,MAAM,MAAM,qBAAqB,GAAG;IAClC,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;CACxG,CAAC;AAEF,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiD;IAC1E,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;gBAExC,OAAO,GAAE,qBAA0B;IAKzC,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBxE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,OAAO,CAAC,WAAW;CAkBpB;AAED,2DAA2D;AAC3D,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAM1F"}

package/dist/mdns.js

@@ -0,0 +1,107 @@
+import { BRIDGETHING_MDNS_SERVICE_TYPE, BRIDGETHING_NETWORK_GATEWAY_PORT } from '@bridgething/lib';
+export class MDNSDiscoverer {
+    serviceType;
+    buildUrl;
+    bonjour = null;
+    browser = null;
+    seen = new Map();
+    constructor(options = {}) {
+        this.serviceType = options.serviceType ?? BRIDGETHING_MDNS_SERVICE_TYPE;
+        this.buildUrl = options.buildUrl ?? (({ host, port }) => `ws://${host}:${port}/`);
+    }
+    async start(listener) {
+        if (this.bonjour)
+            return;
+        const { Bonjour } = await loadBonjour();
+        this.bonjour = new Bonjour();
+        const handleUp = (svc) => {
+            const endpoint = this.endpointFor(svc);
+            if (!endpoint)
+                return;
+            const existing = this.seen.get(endpoint.id);
+            if (existing && existing.url === endpoint.url)
+                return;
+            this.seen.set(endpoint.id, endpoint);
+            listener({ type: 'found', endpoint });
+        };
+        const handleDown = (svc) => {
+            const id = serviceId(svc);
+            if (!this.seen.delete(id))
+                return;
+            listener({ type: 'lost', id });
+        };
+        this.browser = this.bonjour.find({ type: this.serviceType, protocol: 'tcp' }, handleUp);
+        this.browser.on('up', handleUp);
+        this.browser.on('down', handleDown);
+    }
+    stop() {
+        this.browser?.stop();
+        this.browser = null;
+        this.bonjour?.destroy();
+        this.bonjour = null;
+        this.seen.clear();
+        return Promise.resolve();
+    }
+    endpointFor(svc) {
+        if (!svc.host || !svc.port)
+            return null;
+        const addresses = svc.addresses ?? [];
+        const txt = normalizeTxt(svc.txt);
+        const nickname = txt['nickname'];
+        const url = this.buildUrl({
+            host: svc.host,
+            port: svc.port,
+            addresses,
+            nickname,
+        });
+        return {
+            id: serviceId(svc),
+            url,
+            name: nickname || svc.name,
+            metadata: txt,
+        };
+    }
+}
+/** Convenience factory mirroring the daemon's defaults. */
+export function discoverBridgethingDaemons(options) {
+    return new MDNSDiscoverer({
+        serviceType: BRIDGETHING_MDNS_SERVICE_TYPE,
+        buildUrl: ({ host, port }) => `ws://${host}:${port || BRIDGETHING_NETWORK_GATEWAY_PORT}/`,
+        ...options,
+    });
+}
+function serviceId(svc) {
+    return svc.fqdn ?? `${svc.name}.${svc.type}.${svc.protocol}`;
+}
+function normalizeTxt(txt) {
+    if (!txt)
+        return {};
+    const out = {};
+    for (const [key, value] of Object.entries(txt)) {
+        if (typeof value === 'string') {
+            out[key] = value;
+        }
+        else if (value instanceof Uint8Array) {
+            out[key] = new TextDecoder().decode(value);
+        }
+        else {
+            out[key] = String(value);
+        }
+    }
+    return out;
+}
+async function loadBonjour() {
+    try {
+        const mod = (await import('bonjour-service'));
+        if (mod.Bonjour)
+            return { Bonjour: mod.Bonjour };
+        if (mod.default?.Bonjour)
+            return { Bonjour: mod.default.Bonjour };
+        throw new Error('bonjour-service module did not export Bonjour');
+    }
+    catch (err) {
+        throw new Error(`@bridgething/adapter-network: MDNSDiscoverer needs the optional 'bonjour-service' dependency. ` +
+            `Install it with 'bun add bonjour-service'. Underlying: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=mdns.js.map

package/dist/mdns.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@bridgething/adapter-network",
+  "version": "0.1.4",
+  "description": "Network-gateway WebSocket transport for @bridgething/gateway.",
+  "license": "MIT",
+  "author": "Joey Eamigh <55670930+JoeyEamigh@users.noreply.github.com> (https://github.com/JoeyEamigh)",
+  "homepage": "https://bridgething.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JoeyEamigh/bridgething.git",
+    "directory": "packages/adapter-network"
+  },
+  "bugs": {
+    "url": "https://github.com/JoeyEamigh/bridgething/issues"
+  },
+  "keywords": ["bridgething", "spotify", "car-thing", "superbird", "websocket", "transport"],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./mdns": {
+      "types": "./dist/mdns.d.ts",
+      "default": "./dist/mdns.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "@bridgething/gateway": "0.1.4",
+    "@bridgething/lib": "0.1.4"
+  },
+  "peerDependencies": {
+    "bonjour-service": "^1.3.0",
+    "typescript": "^6.0.3"
+  },
+  "peerDependenciesMeta": {
+    "bonjour-service": {
+      "optional": true
+    }
+  }
+}