@matter-server/ble-proxy 0.0.1

package/dist/esm/ProxyBleClient.js

@@ -0,0 +1,100 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Logger } from "@matter/main";
+import { MatterBle } from "@matter/main/protocol";
+import { BleProxyCommand, BleProxyEvent } from "./BleProxyProtocol.js";
+const logger = Logger.get("ProxyBleClient");
+class ProxyBleClient {
+  #handler;
+  #discoveredPeripherals = /* @__PURE__ */ new Map();
+  #deviceDiscoveredCallback;
+  #isScanning = false;
+  #eventObserver = (event, data) => {
+    if (event === BleProxyEvent.DeviceDiscovered) {
+      this.#handleDeviceDiscovered(data);
+    } else if (event === BleProxyEvent.ScanStopped) {
+      logger.info(`Scan stopped by proxy client: ${data.reason ?? "unknown"}`);
+      this.#isScanning = false;
+    }
+  };
+  constructor(handler) {
+    this.#handler = handler;
+    this.#handler.eventReceived.on(this.#eventObserver);
+  }
+  setDiscoveryCallback(callback) {
+    this.#deviceDiscoveredCallback = callback;
+    for (const { peripheral, matterServiceData } of this.#discoveredPeripherals.values()) {
+      this.#deviceDiscoveredCallback(peripheral, matterServiceData);
+    }
+  }
+  async startScanning() {
+    if (this.#isScanning) {
+      return;
+    }
+    if (!this.#handler.connected) {
+      logger.info("BLE proxy not connected, deferring scan start");
+      return;
+    }
+    logger.debug("Start BLE scanning via proxy ...");
+    await this.#handler.sendCommand(BleProxyCommand.StartScan, {
+      service_uuids: ["fff6"],
+      allow_duplicates: true
+    });
+    this.#isScanning = true;
+  }
+  async stopScanning() {
+    if (!this.#isScanning) {
+      return;
+    }
+    if (!this.#handler.connected) {
+      this.#isScanning = false;
+      return;
+    }
+    logger.debug("Stop BLE scanning via proxy ...");
+    await this.#handler.sendCommand(BleProxyCommand.StopScan);
+    this.#isScanning = false;
+  }
+  close() {
+    this.#isScanning = false;
+    this.#handler.eventReceived.off(this.#eventObserver);
+  }
+  #handleDeviceDiscovered(data) {
+    const { address, name, rssi, connectable, service_data } = data;
+    const serviceData = /* @__PURE__ */ new Map();
+    let matterServiceData;
+    if (service_data) {
+      for (const [uuid, base64Value] of Object.entries(service_data)) {
+        const bytes = Buffer.from(base64Value, "base64");
+        serviceData.set(uuid, bytes);
+        if (MatterBle.isServiceUuid(uuid)) {
+          matterServiceData = bytes;
+        }
+      }
+    }
+    const peripheral = {
+      address,
+      name,
+      rssi,
+      connectable,
+      serviceData
+    };
+    if (!connectable) {
+      logger.debug(`Peripheral ${address} is not connectable, ignoring`);
+      return;
+    }
+    if (matterServiceData === void 0 || matterServiceData.length !== 8) {
+      logger.debug(`Peripheral ${address} does not advertise valid Matter service data, ignoring`);
+      return;
+    }
+    logger.debug(`Discovered device ${address} (${name ?? "unnamed"}) via proxy`);
+    this.#discoveredPeripherals.set(address, { peripheral, matterServiceData });
+    this.#deviceDiscoveredCallback?.(peripheral, matterServiceData);
+  }
+}
+export {
+  ProxyBleClient
+};
+//# sourceMappingURL=ProxyBleClient.js.map

package/dist/esm/ProxyBleClient.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/ProxyBleClient.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,cAAc;AACvB,SAAS,iBAAiB;AAE1B,SAAS,iBAAiB,qBAAgD;AAE1E,MAAM,SAAS,OAAO,IAAI,gBAAgB;AAoBnC,MAAM,eAAe;AAAA,EACf;AAAA,EACA,yBAAyB,oBAAI,IAA4E;AAAA,EAClH;AAAA,EACA,cAAc;AAAA,EAEL,iBAAiB,CAAC,OAAe,SAAkC;AACxE,QAAI,UAAU,cAAc,kBAAkB;AAC1C,WAAK,wBAAwB,IAAuC;AAAA,IACxE,WAAW,UAAU,cAAc,aAAa;AAC5C,aAAO,KAAK,iCAAkC,KAA6B,UAAU,SAAS,EAAE;AAChG,WAAK,cAAc;AAAA,IACvB;AAAA,EACJ;AAAA,EAEA,YAAY,SAA0B;AAClC,SAAK,WAAW;AAChB,SAAK,SAAS,cAAc,GAAG,KAAK,cAAc;AAAA,EACtD;AAAA,EAEA,qBAAqB,UAAsF;AACvG,SAAK,4BAA4B;AACjC,eAAW,EAAE,YAAY,kBAAkB,KAAK,KAAK,uBAAuB,OAAO,GAAG;AAClF,WAAK,0BAA0B,YAAY,iBAAiB;AAAA,IAChE;AAAA,EACJ;AAAA,EAEA,MAAM,gBAA+B;AACjC,QAAI,KAAK,aAAa;AAClB;AAAA,IACJ;AAEA,QAAI,CAAC,KAAK,SAAS,WAAW;AAC1B,aAAO,KAAK,+CAA+C;AAC3D;AAAA,IACJ;AAEA,WAAO,MAAM,kCAAkC;AAC/C,UAAM,KAAK,SAAS,YAAY,gBAAgB,WAAW;AAAA,MACvD,eAAe,CAAC,MAAM;AAAA,MACtB,kBAAkB;AAAA,IACtB,CAAC;AACD,SAAK,cAAc;AAAA,EACvB;AAAA,EAEA,MAAM,eAA8B;AAChC,QAAI,CAAC,KAAK,aAAa;AACnB;AAAA,IACJ;AAEA,QAAI,CAAC,KAAK,SAAS,WAAW;AAC1B,WAAK,cAAc;AACnB;AAAA,IACJ;AAEA,WAAO,MAAM,iCAAiC;AAC9C,UAAM,KAAK,SAAS,YAAY,gBAAgB,QAAQ;AACxD,SAAK,cAAc;AAAA,EACvB;AAAA,EAEA,QAAc;AACV,SAAK,cAAc;AACnB,SAAK,SAAS,cAAc,IAAI,KAAK,cAAc;AAAA,EACvD;AAAA,EAEA,wBAAwB,MAAkC;AACtD,UAAM,EAAE,SAAS,MAAM,MAAM,aAAa,aAAa,IAAI;AAI3D,UAAM,cAAc,oBAAI,IAAwB;AAChD,QAAI;AACJ,QAAI,cAAc;AACd,iBAAW,CAAC,MAAM,WAAW,KAAK,OAAO,QAAQ,YAAY,GAAG;AAC5D,cAAM,QAAQ,OAAO,KAAK,aAAa,QAAQ;AAC/C,oBAAY,IAAI,MAAM,KAAK;AAC3B,YAAI,UAAU,cAAc,IAAI,GAAG;AAC/B,8BAAoB;AAAA,QACxB;AAAA,MACJ;AAAA,IACJ;AAEA,UAAM,aAA8B;AAAA,MAChC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACJ;AAEA,QAAI,CAAC,aAAa;AACd,aAAO,MAAM,cAAc,OAAO,+BAA+B;AACjE;AAAA,IACJ;AAEA,QAAI,sBAAsB,UAAa,kBAAkB,WAAW,GAAG;AACnE,aAAO,MAAM,cAAc,OAAO,yDAAyD;AAC3F;AAAA,IACJ;AAEA,WAAO,MAAM,qBAAqB,OAAO,KAAK,QAAQ,SAAS,aAAa;AAC5E,SAAK,uBAAuB,IAAI,SAAS,EAAE,YAAY,kBAAkB,CAAC;AAC1E,SAAK,4BAA4B,YAAY,iBAAiB;AAAA,EAClE;AACJ;",
+  "names": []
+}

package/dist/esm/ProxyBleScanner.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BleScanner as BaseBleScanner, type DiscoveredBleDevice } from "@matter/main/protocol";
+import type { ProxyBleClient, ProxyPeripheral } from "./ProxyBleClient.js";
+export type { DiscoveredBleDevice } from "@matter/main/protocol";
+export type DiscoveredProxyBleDevice = Omit<DiscoveredBleDevice, "peripheral"> & {
+    peripheral: ProxyPeripheral;
+};
+/**
+ * BLE scanner that discovers Matter devices through the BLE proxy.
+ *
+ * Extends matter.js's base `BleScanner`, which already handles the
+ * `findCommissionableDevicesContinuously` waiter loop, advertisement parsing,
+ * and cancellation semantics. We only narrow the `getDiscoveredDevice` return
+ * type to expose the proxy-side `ProxyPeripheral` and route `closeClient`
+ * through `ProxyBleClient.close()`.
+ */
+export declare class ProxyBleScanner extends BaseBleScanner {
+    #private;
+    constructor(proxyClient: ProxyBleClient);
+    getDiscoveredDevice(address: string): DiscoveredProxyBleDevice;
+    protected closeClient(): void;
+}
+//# sourceMappingURL=ProxyBleScanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProxyBleScanner.d.ts","sourceRoot":"","sources":["../../src/ProxyBleScanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3E,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,mBAAmB,EAAE,YAAY,CAAC,GAAG;IAAE,UAAU,EAAE,eAAe,CAAA;CAAE,CAAC;AAEjH;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,cAAc;;IAG/C,YAAY,WAAW,EAAE,cAAc,EAGtC;IAEQ,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,CAEtE;IAED,UAAmB,WAAW,IAAI,IAAI,CAErC;CACJ"}

package/dist/esm/ProxyBleScanner.js

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BleScanner as BaseBleScanner } from "@matter/main/protocol";
+class ProxyBleScanner extends BaseBleScanner {
+  #proxyClient;
+  constructor(proxyClient) {
+    super(proxyClient);
+    this.#proxyClient = proxyClient;
+  }
+  getDiscoveredDevice(address) {
+    return super.getDiscoveredDevice(address);
+  }
+  closeClient() {
+    this.#proxyClient.close();
+  }
+}
+export {
+  ProxyBleScanner
+};
+//# sourceMappingURL=ProxyBleScanner.js.map

package/dist/esm/ProxyBleScanner.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/ProxyBleScanner.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,cAAc,sBAAgD;AAgBhE,MAAM,wBAAwB,eAAe;AAAA,EACvC;AAAA,EAET,YAAY,aAA6B;AACrC,UAAM,WAAW;AACjB,SAAK,eAAe;AAAA,EACxB;AAAA,EAES,oBAAoB,SAA2C;AACpE,WAAO,MAAM,oBAAoB,OAAO;AAAA,EAC5C;AAAA,EAEmB,cAAoB;AACnC,SAAK,aAAa,MAAM;AAAA,EAC5B;AACJ;",
+  "names": []
+}

package/dist/esm/example/NobleBleProxyClient.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare class NobleBleProxyClient {
+    #private;
+    constructor(serverUrl: string, hciId?: number);
+    connect(): Promise<void>;
+    close(): void;
+}
+//# sourceMappingURL=NobleBleProxyClient.d.ts.map

package/dist/esm/example/NobleBleProxyClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NobleBleProxyClient.d.ts","sourceRoot":"","sources":["../../../src/example/NobleBleProxyClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6EH,qBAAa,mBAAmB;;IAY5B,YAAY,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAI5C;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAsE7B;IAED,KAAK,IAAI,IAAI,CAeZ;CA4eJ"}