@matter-server/ble-proxy 0.7.2-alpha.0-20260601-e778038 → 0.8.0

package/dist/esm/BleProxyConnection.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Observable } from "@matter/main";
+import { WebSocket } from "ws";
+import { type BinaryFrame, type BleProxyCommandMap, type BleProxyCommandName, type BleProxyEventName } from "./BleProxyProtocol.js";
+/**
+ * One BLE proxy client socket. Owns that client's handshake state, pending
+ * command map, and command/event/binary-frame plumbing. The hub
+ * (`BleProxyHandler`) creates one per accepted WebSocket connection.
+ */
+export declare class BleProxyConnection {
+    #private;
+    readonly binaryFrameReceived: Observable<[frame: BinaryFrame], void>;
+    readonly eventReceived: Observable<[event: BleProxyEventName, data: Record<string, unknown>], void>;
+    /** Emitted once when this connection completes the protocol handshake. */
+    readonly handshakeCompleted: Observable<[], void>;
+    /** Emitted once when this connection is torn down (close, error, or handshake failure). */
+    readonly closed: Observable<[], void>;
+    constructor(ws: WebSocket);
+    get id(): string;
+    get connected(): boolean;
+    /**
+     * Send a typed command to this client and wait for the response.
+     * Rejects if the connection is not ready or the client disconnects first.
+     */
+    sendCommand<C extends BleProxyCommandName>(command: C, ...rest: BleProxyCommandMap[C]["args"] extends undefined ? [] : [args: BleProxyCommandMap[C]["args"]]): Promise<BleProxyCommandMap[C]["result"]>;
+    sendBinaryFrame(opcode: number, connectionHandle: number, payload: Uint8Array): void;
+    /** Close the socket if open, reject all pending commands, emit `closed` once. */
+    close(): void;
+}
+//# sourceMappingURL=BleProxyConnection.d.ts.map

package/dist/esm/BleProxyConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BleProxyConnection.d.ts","sourceRoot":"","sources":["../../src/BleProxyConnection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAyB,UAAU,EAA8B,MAAM,cAAc,CAAC;AAE7F,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAIH,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAKzB,MAAM,uBAAuB,CAAC;AAiC/B;;;;GAIG;AACH,qBAAa,kBAAkB;;IAY3B,QAAQ,CAAC,mBAAmB,yCAA0C;IACtE,QAAQ,CAAC,aAAa,8EAA+E;IACrG,0EAA0E;IAC1E,QAAQ,CAAC,kBAAkB,uBAAwB;IACnD,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,uBAAwB;IAEvC,YAAY,EAAE,EAAE,SAAS,EA+BxB;IAED,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACG,WAAW,CAAC,CAAC,SAAS,mBAAmB,EAC3C,OAAO,EAAE,CAAC,EACV,GAAG,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GACtG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CA0B1C;IAED,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAQnF;IAkGD,iFAAiF;IACjF,KAAK,IAAI,IAAI,CAKZ;CAeJ"}

package/dist/esm/BleProxyConnection.js

@@ -0,0 +1,210 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createPromise, Logger, Observable, Seconds, Time, withTimeout } from "@matter/main";
+import { Mark } from "@matter/main/protocol";
+import { WebSocket } from "ws";
+import {
+  BLE_PROXY_PROTOCOL_VERSION,
+  decodeBinaryFrame,
+  encodeBinaryFrame
+} from "./BleProxyProtocol.js";
+const logger = Logger.get("BleProxyConnection");
+const frameHead = (payload) => Array.from(payload.subarray(0, 8)).map((b) => b.toString(16).padStart(2, "0")).join("");
+let connectionIdCounter = 0;
+function generateConnectionId() {
+  const id = connectionIdCounter;
+  connectionIdCounter = connectionIdCounter + 1 & 65535;
+  return `ble${id.toString(16)}`;
+}
+const HANDSHAKE_TIMEOUT = Seconds(10);
+const COMMAND_TIMEOUT = Seconds(60);
+class BleProxyConnection {
+  #ws;
+  #id = generateConnectionId();
+  #handshakeComplete = false;
+  #closedEmitted = false;
+  #pendingCommands = /* @__PURE__ */ new Map();
+  /** Command ID counter. Rolls over at 0xFFFF to stay in safe integer range. */
+  #nextCommandId = 0;
+  binaryFrameReceived = new Observable();
+  eventReceived = new Observable();
+  /** Emitted once when this connection completes the protocol handshake. */
+  handshakeCompleted = new Observable();
+  /** Emitted once when this connection is torn down (close, error, or handshake failure). */
+  closed = new Observable();
+  constructor(ws) {
+    this.#ws = ws;
+    logger.info(`[${this.#id}] BLE proxy connection established, waiting for handshake`);
+    const handshakeTimer = Time.getTimer("BLE proxy handshake timeout", HANDSHAKE_TIMEOUT, () => {
+      if (!this.#handshakeComplete) {
+        logger.warn(`[${this.#id}] Handshake timeout - closing connection`);
+        ws.close(4001, "Handshake timeout");
+        this.#cleanup();
+      }
+    }).start();
+    ws.on("message", (data, isBinary) => {
+      if (isBinary) {
+        this.#handleBinaryMessage(data);
+      } else {
+        this.#handleTextMessage(data.toString(), handshakeTimer);
+      }
+    });
+    ws.on("close", () => {
+      handshakeTimer.stop();
+      logger.info(`[${this.#id}] BLE proxy connection closed`);
+      this.#cleanup();
+    });
+    ws.on("error", (err) => {
+      logger.error(`[${this.#id}] BLE proxy WebSocket error`, err);
+      handshakeTimer.stop();
+      this.#cleanup();
+    });
+  }
+  get id() {
+    return this.#id;
+  }
+  get connected() {
+    return this.#handshakeComplete && this.#ws.readyState === WebSocket.OPEN;
+  }
+  /**
+   * Send a typed command to this client and wait for the response.
+   * Rejects if the connection is not ready or the client disconnects first.
+   */
+  async sendCommand(command, ...rest) {
+    if (!this.connected) {
+      throw new Error("BLE proxy client not connected");
+    }
+    const args = rest[0];
+    const id = this.#nextCommandId;
+    this.#nextCommandId = this.#nextCommandId + 1 & 65535;
+    const message = { id, command };
+    if (args !== void 0) {
+      message.args = args;
+    }
+    const { promise, resolver, rejecter } = createPromise();
+    this.#pendingCommands.set(id, { resolver, rejecter });
+    this.#ws.send(JSON.stringify(message), (err) => {
+      if (err) {
+        this.#pendingCommands.delete(id);
+        rejecter(new Error(`Failed to send command ${command}: ${err.message}`));
+      }
+    });
+    return withTimeout(COMMAND_TIMEOUT, promise, () => this.#pendingCommands.delete(id));
+  }
+  sendBinaryFrame(opcode, connectionHandle, payload) {
+    if (!this.connected) {
+      throw new Error("BLE proxy client not connected");
+    }
+    logger.debug(
+      `[${this.#id}] [FRAME] ${Mark.OUTBOUND} opcode=${opcode} handle=${connectionHandle} len=${payload.length} head=${frameHead(payload)}`
+    );
+    this.#ws.send(encodeBinaryFrame(opcode, connectionHandle, payload));
+  }
+  #handleTextMessage(raw, handshakeTimer) {
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      logger.warn(`[${this.#id}] Received invalid JSON from BLE proxy client`);
+      return;
+    }
+    const msg = parsed;
+    if (!this.#handshakeComplete) {
+      this.#handleHandshake(msg, handshakeTimer);
+      return;
+    }
+    if ("id" in msg && "success" in msg) {
+      this.#handleResponse(msg);
+      return;
+    }
+    if ("event" in msg && "data" in msg) {
+      const evt = msg;
+      this.eventReceived.emit(evt.event, evt.data);
+      return;
+    }
+    logger.warn(`[${this.#id}] Received unknown message from BLE proxy client:`, msg);
+  }
+  #handleHandshake(msg, handshakeTimer) {
+    if (msg.type !== "hello") {
+      logger.warn(`[${this.#id}] Expected hello message, got: ${JSON.stringify(msg)}`);
+      this.#ws.close(4002, "Expected hello message");
+      this.#cleanup();
+      return;
+    }
+    const hello = msg;
+    handshakeTimer.stop();
+    if (hello.version !== BLE_PROXY_PROTOCOL_VERSION) {
+      logger.warn(
+        `[${this.#id}] BLE proxy client version ${hello.version} not supported (server supports ${BLE_PROXY_PROTOCOL_VERSION})`
+      );
+      this.#ws.send(
+        JSON.stringify({
+          type: "hello_response",
+          version: BLE_PROXY_PROTOCOL_VERSION,
+          error: "unsupported_version",
+          message: `Server supports protocol version ${BLE_PROXY_PROTOCOL_VERSION}, client sent version ${hello.version}`
+        })
+      );
+      this.#ws.close(4003, "Unsupported protocol version");
+      this.#cleanup();
+      return;
+    }
+    this.#handshakeComplete = true;
+    this.#ws.send(JSON.stringify({ type: "hello_response", version: BLE_PROXY_PROTOCOL_VERSION }));
+    logger.info(`[${this.#id}] BLE proxy handshake complete (version ${BLE_PROXY_PROTOCOL_VERSION})`);
+    this.handshakeCompleted.emit();
+  }
+  #handleResponse(msg) {
+    const pending = this.#pendingCommands.get(msg.id);
+    if (!pending) {
+      logger.warn(`[${this.#id}] Received response for unknown command id ${msg.id}`);
+      return;
+    }
+    this.#pendingCommands.delete(msg.id);
+    if (msg.success) {
+      pending.resolver(msg.result);
+    } else {
+      pending.rejecter(new Error(`${msg.error}: ${msg.message}`));
+    }
+  }
+  #handleBinaryMessage(data) {
+    if (!this.#handshakeComplete) {
+      logger.warn(`[${this.#id}] Received binary frame before handshake`);
+      return;
+    }
+    try {
+      const frame = decodeBinaryFrame(new Uint8Array(data));
+      logger.debug(
+        `[${this.#id}] [FRAME] ${Mark.INBOUND} opcode=${frame.opcode} handle=${frame.connectionHandle} len=${frame.payload.length} head=${frameHead(frame.payload)}`
+      );
+      this.binaryFrameReceived.emit(frame);
+    } catch (err) {
+      logger.warn(`[${this.#id}] Failed to decode binary frame:`, err);
+    }
+  }
+  /** Close the socket if open, reject all pending commands, emit `closed` once. */
+  close() {
+    if (this.#ws.readyState === WebSocket.OPEN) {
+      this.#ws.close();
+    }
+    this.#cleanup();
+  }
+  #cleanup() {
+    this.#handshakeComplete = false;
+    for (const [id, pending] of this.#pendingCommands) {
+      pending.rejecter(new Error("BLE proxy client disconnected"));
+      this.#pendingCommands.delete(id);
+    }
+    if (!this.#closedEmitted) {
+      this.#closedEmitted = true;
+      this.closed.emit();
+    }
+  }
+}
+export {
+  BleProxyConnection
+};
+//# sourceMappingURL=BleProxyConnection.js.map

package/dist/esm/BleProxyConnection.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/BleProxyConnection.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,eAAe,QAAQ,YAAY,SAAS,MAAM,mBAAmB;AAC9E,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAC1B;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,OASG;AAEP,MAAM,SAAS,OAAO,IAAI,oBAAoB;AAE9C,MAAM,YAAY,CAAC,YACf,MAAM,KAAK,QAAQ,SAAS,GAAG,CAAC,CAAC,EAC5B,IAAI,OAAK,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EACxC,KAAK,EAAE;AAGhB,IAAI,sBAAsB;AAO1B,SAAS,uBAA+B;AACpC,QAAM,KAAK;AACX,wBAAuB,sBAAsB,IAAK;AAClD,SAAO,MAAM,GAAG,SAAS,EAAE,CAAC;AAChC;AAEA,MAAM,oBAAoB,QAAQ,EAAE;AAQpC,MAAM,kBAAkB,QAAQ,EAAE;AAO3B,MAAM,mBAAmB;AAAA,EACnB;AAAA,EACA,MAAM,qBAAqB;AAAA,EACpC,qBAAqB;AAAA,EACrB,iBAAiB;AAAA,EACjB,mBAAmB,oBAAI,IAGrB;AAAA;AAAA,EAEF,iBAAiB;AAAA,EAER,sBAAsB,IAAI,WAAiC;AAAA,EAC3D,gBAAgB,IAAI,WAAsE;AAAA;AAAA,EAE1F,qBAAqB,IAAI,WAAe;AAAA;AAAA,EAExC,SAAS,IAAI,WAAe;AAAA,EAErC,YAAY,IAAe;AACvB,SAAK,MAAM;AACX,WAAO,KAAK,IAAI,KAAK,GAAG,2DAA2D;AAEnF,UAAM,iBAAiB,KAAK,SAAS,+BAA+B,mBAAmB,MAAM;AACzF,UAAI,CAAC,KAAK,oBAAoB;AAC1B,eAAO,KAAK,IAAI,KAAK,GAAG,0CAA0C;AAClE,WAAG,MAAM,MAAM,mBAAmB;AAClC,aAAK,SAAS;AAAA,MAClB;AAAA,IACJ,CAAC,EAAE,MAAM;AAET,OAAG,GAAG,WAAW,CAAC,MAAM,aAAa;AACjC,UAAI,UAAU;AACV,aAAK,qBAAqB,IAAc;AAAA,MAC5C,OAAO;AACH,aAAK,mBAAmB,KAAK,SAAS,GAAG,cAAc;AAAA,MAC3D;AAAA,IACJ,CAAC;AAED,OAAG,GAAG,SAAS,MAAM;AACjB,qBAAe,KAAK;AACpB,aAAO,KAAK,IAAI,KAAK,GAAG,+BAA+B;AACvD,WAAK,SAAS;AAAA,IAClB,CAAC;AAED,OAAG,GAAG,SAAS,SAAO;AAClB,aAAO,MAAM,IAAI,KAAK,GAAG,+BAA+B,GAAG;AAC3D,qBAAe,KAAK;AACpB,WAAK,SAAS;AAAA,IAClB,CAAC;AAAA,EACL;AAAA,EAEA,IAAI,KAAa;AACb,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,YAAqB;AACrB,WAAO,KAAK,sBAAsB,KAAK,IAAI,eAAe,UAAU;AAAA,EACxE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,YACF,YACG,MACqC;AACxC,QAAI,CAAC,KAAK,WAAW;AACjB,YAAM,IAAI,MAAM,gCAAgC;AAAA,IACpD;AAEA,UAAM,OAAO,KAAK,CAAC;AACnB,UAAM,KAAK,KAAK;AAChB,SAAK,iBAAkB,KAAK,iBAAiB,IAAK;AAClD,UAAM,UAA0B,EAAE,IAAI,QAAQ;AAC9C,QAAI,SAAS,QAAW;AACpB,cAAQ,OAAO;AAAA,IACnB;AAEA,UAAM,EAAE,SAAS,UAAU,SAAS,IAAI,cAAmD;AAC3F,SAAK,iBAAiB,IAAI,IAAI,EAAE,UAAU,SAAS,CAAC;AAEpD,SAAK,IAAI,KAAK,KAAK,UAAU,OAAO,GAAG,SAAO;AAC1C,UAAI,KAAK;AACL,aAAK,iBAAiB,OAAO,EAAE;AAC/B,iBAAS,IAAI,MAAM,0BAA0B,OAAO,KAAK,IAAI,OAAO,EAAE,CAAC;AAAA,MAC3E;AAAA,IACJ,CAAC;AAED,WAAO,YAAY,iBAAiB,SAAS,MAAM,KAAK,iBAAiB,OAAO,EAAE,CAAC;AAAA,EAGvF;AAAA,EAEA,gBAAgB,QAAgB,kBAA0B,SAA2B;AACjF,QAAI,CAAC,KAAK,WAAW;AACjB,YAAM,IAAI,MAAM,gCAAgC;AAAA,IACpD;AACA,WAAO;AAAA,MACH,IAAI,KAAK,GAAG,aAAa,KAAK,QAAQ,WAAW,MAAM,WAAW,gBAAgB,QAAQ,QAAQ,MAAM,SAAS,UAAU,OAAO,CAAC;AAAA,IACvI;AACA,SAAK,IAAI,KAAK,kBAAkB,QAAQ,kBAAkB,OAAO,CAAC;AAAA,EACtE;AAAA,EAEA,mBAAmB,KAAa,gBAA4C;AACxE,QAAI;AACJ,QAAI;AACA,eAAS,KAAK,MAAM,GAAG;AAAA,IAC3B,QAAQ;AACJ,aAAO,KAAK,IAAI,KAAK,GAAG,+CAA+C;AACvE;AAAA,IACJ;AAEA,UAAM,MAAM;AAEZ,QAAI,CAAC,KAAK,oBAAoB;AAC1B,WAAK,iBAAiB,KAAK,cAAc;AACzC;AAAA,IACJ;AAEA,QAAI,QAAQ,OAAO,aAAa,KAAK;AACjC,WAAK,gBAAgB,GAAiC;AACtD;AAAA,IACJ;AAEA,QAAI,WAAW,OAAO,UAAU,KAAK;AACjC,YAAM,MAAM;AACZ,WAAK,cAAc,KAAK,IAAI,OAAO,IAAI,IAAI;AAC3C;AAAA,IACJ;AAEA,WAAO,KAAK,IAAI,KAAK,GAAG,qDAAqD,GAAG;AAAA,EACpF;AAAA,EAEA,iBAAiB,KAA8B,gBAA4C;AACvF,QAAI,IAAI,SAAS,SAAS;AACtB,aAAO,KAAK,IAAI,KAAK,GAAG,kCAAkC,KAAK,UAAU,GAAG,CAAC,EAAE;AAC/E,WAAK,IAAI,MAAM,MAAM,wBAAwB;AAC7C,WAAK,SAAS;AACd;AAAA,IACJ;AAEA,UAAM,QAAQ;AACd,mBAAe,KAAK;AAEpB,QAAI,MAAM,YAAY,4BAA4B;AAC9C,aAAO;AAAA,QACH,IAAI,KAAK,GAAG,8BAA8B,MAAM,OAAO,mCAAmC,0BAA0B;AAAA,MACxH;AACA,WAAK,IAAI;AAAA,QACL,KAAK,UAAU;AAAA,UACX,MAAM;AAAA,UACN,SAAS;AAAA,UACT,OAAO;AAAA,UACP,SAAS,oCAAoC,0BAA0B,yBAAyB,MAAM,OAAO;AAAA,QACjH,CAAC;AAAA,MACL;AACA,WAAK,IAAI,MAAM,MAAM,8BAA8B;AACnD,WAAK,SAAS;AACd;AAAA,IACJ;AAEA,SAAK,qBAAqB;AAC1B,SAAK,IAAI,KAAK,KAAK,UAAU,EAAE,MAAM,kBAAkB,SAAS,2BAA2B,CAAC,CAAC;AAC7F,WAAO,KAAK,IAAI,KAAK,GAAG,2CAA2C,0BAA0B,GAAG;AAChG,SAAK,mBAAmB,KAAK;AAAA,EACjC;AAAA,EAEA,gBAAgB,KAA4B;AACxC,UAAM,UAAU,KAAK,iBAAiB,IAAI,IAAI,EAAE;AAChD,QAAI,CAAC,SAAS;AACV,aAAO,KAAK,IAAI,KAAK,GAAG,8CAA8C,IAAI,EAAE,EAAE;AAC9E;AAAA,IACJ;AACA,SAAK,iBAAiB,OAAO,IAAI,EAAE;AAEnC,QAAI,IAAI,SAAS;AACb,cAAQ,SAAS,IAAI,MAAM;AAAA,IAC/B,OAAO;AACH,cAAQ,SAAS,IAAI,MAAM,GAAG,IAAI,KAAK,KAAK,IAAI,OAAO,EAAE,CAAC;AAAA,IAC9D;AAAA,EACJ;AAAA,EAEA,qBAAqB,MAAoB;AACrC,QAAI,CAAC,KAAK,oBAAoB;AAC1B,aAAO,KAAK,IAAI,KAAK,GAAG,0CAA0C;AAClE;AAAA,IACJ;AAEA,QAAI;AACA,YAAM,QAAQ,kBAAkB,IAAI,WAAW,IAAI,CAAC;AACpD,aAAO;AAAA,QACH,IAAI,KAAK,GAAG,aAAa,KAAK,OAAO,WAAW,MAAM,MAAM,WAAW,MAAM,gBAAgB,QAAQ,MAAM,QAAQ,MAAM,SAAS,UAAU,MAAM,OAAO,CAAC;AAAA,MAC9J;AACA,WAAK,oBAAoB,KAAK,KAAK;AAAA,IACvC,SAAS,KAAK;AACV,aAAO,KAAK,IAAI,KAAK,GAAG,oCAAoC,GAAG;AAAA,IACnE;AAAA,EACJ;AAAA;AAAA,EAGA,QAAc;AACV,QAAI,KAAK,IAAI,eAAe,UAAU,MAAM;AACxC,WAAK,IAAI,MAAM;AAAA,IACnB;AACA,SAAK,SAAS;AAAA,EAClB;AAAA,EAEA,WAAiB;AACb,SAAK,qBAAqB;AAE1B,eAAW,CAAC,IAAI,OAAO,KAAK,KAAK,kBAAkB;AAC/C,cAAQ,SAAS,IAAI,MAAM,+BAA+B,CAAC;AAC3D,WAAK,iBAAiB,OAAO,EAAE;AAAA,IACnC;AAEA,QAAI,CAAC,KAAK,gBAAgB;AACtB,WAAK,iBAAiB;AACtB,WAAK,OAAO,KAAK;AAAA,IACrB;AAAA,EACJ;AACJ;",
+  "names": []
+}

package/dist/esm/BleProxyHandler.d.ts

@@ -6,36 +6,31 @@
 import type { WebServerHandler } from "@matter-server/ws-controller";
 import { Observable } from "@matter/main";
 import type { createServer } from "node:http";
-import { type BinaryFrame, type BleProxyCommandMap, type BleProxyCommandName, type BleProxyEventName } from "./BleProxyProtocol.js";
+import { BleProxyConnection } from "./BleProxyConnection.js";
+import { type DeviceDiscoveredData, type StartScanArgs } from "./BleProxyProtocol.js";
 type HttpServer = ReturnType<typeof createServer>;
 /**
- * WebSocket server handler for the /ble BLE proxy endpoint.
+ * WebSocket server handler (hub) for the `/ble` BLE proxy endpoint.
  *
- * Accepts a single client connection, performs the protocol handshake,
- * and routes commands/events/binary frames between the proxy implementation
- * and the connected BLE proxy client.
+ * Accepts any number of proxy client connections, broadcasts scan commands to
+ * all of them, and tracks which client owns each discovered peripheral so that
+ * per-peripheral traffic routes to a single client.
  */
 export declare class BleProxyHandler implements WebServerHandler {
     #private;
-    /** Emitted when a JSON event is received from the BLE proxy client. */
-    readonly eventReceived: Observable<[event: BleProxyEventName, data: Record<string, unknown>], void>;
-    /** Emitted when a binary frame is received from the BLE proxy client. */
-    readonly binaryFrameReceived: Observable<[frame: BinaryFrame], void>;
-    /** Emitted once a proxy client has completed the handshake and `connected` is true. */
+    /** Emitted whenever a connection completes its handshake. */
     readonly connectionEstablished: Observable<[], void>;
+    /** Emitted for each `device_discovered`, after ownership is updated. */
+    readonly deviceDiscovered: Observable<[data: DeviceDiscoveredData, connection: BleProxyConnection], void>;
+    /** Emitted once no connection is scanning anymore. */
+    readonly scanStopped: Observable<[reason: string], void>;
     get connected(): boolean;
     register(server: HttpServer): Promise<void>;
     unregister(): Promise<void>;
-    /**
-     * Send a typed command to the BLE proxy client and wait for the response.
-     * The return type is inferred from the command name via BleProxyCommandMap.
-     * Rejects if no client is connected or the client disconnects before responding.
-     */
-    sendCommand<C extends BleProxyCommandName>(command: C, ...rest: BleProxyCommandMap[C]["args"] extends undefined ? [] : [args: BleProxyCommandMap[C]["args"]]): Promise<BleProxyCommandMap[C]["result"]>;
-    /**
-     * Send a binary frame to the BLE proxy client.
-     */
-    sendBinaryFrame(opcode: number, connectionHandle: number, payload: Uint8Array): void;
+    /** Returns the connection that owns `address`, if it is still connected. */
+    getOwner(address: string): BleProxyConnection | undefined;
+    startScan(args: StartScanArgs): Promise<void>;
+    stopScan(): Promise<void>;
 }
 export {};
 //# sourceMappingURL=BleProxyHandler.d.ts.map

package/dist/esm/BleProxyHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BleProxyHandler.d.ts","sourceRoot":"","sources":["../../src/BleProxyHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAyB,UAAU,EAAqC,MAAM,cAAc,CAAC;AACpG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAIH,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAKzB,MAAM,uBAAuB,CAAC;AAE/B,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAclD;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;;IAcpD,uEAAuE;IACvE,QAAQ,CAAC,aAAa,8EAA+E;IAErG,yEAAyE;IACzE,QAAQ,CAAC,mBAAmB,yCAA0C;IAEtE,uFAAuF;IACvF,QAAQ,CAAC,qBAAqB,uBAAwB;IAEtD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEK,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA+EhD;IAED,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAmC1B;IAED;;;;OAIG;IACG,WAAW,CAAC,CAAC,SAAS,mBAAmB,EAC3C,OAAO,EAAE,CAAC,EACV,GAAG,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GACtG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CA0B1C;IAED;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAMnF;CA+HJ"}
+{"version":3,"file":"BleProxyHandler.d.ts","sourceRoot":"","sources":["../../src/BleProxyHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAU,UAAU,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAkC,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtH,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAIlD;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;;IAgBpD,6DAA6D;IAC7D,QAAQ,CAAC,qBAAqB,uBAAwB;IACtD,wEAAwE;IACxE,QAAQ,CAAC,gBAAgB,iFAAkF;IAC3G,sDAAsD;IACtD,QAAQ,CAAC,WAAW,qCAAsC;IAE1D,IAAI,SAAS,IAAI,OAAO,CAKvB;IAEK,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAyChD;IAED,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CA4B1B;IAED,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAIxD;IAEK,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBlD;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAc9B;CAuEJ"}