@matter-server/ble-proxy 0.0.1

package/README.md

@@ -0,0 +1,116 @@
+# @matter-server/ble-proxy
+
+BLE proxy support for the Matter server — enables BLE commissioning of Matter devices through a remote Bluetooth adapter over WebSocket.
+
+## Overview
+
+Instead of requiring a Bluetooth adapter on the server host, a **proxy client** sits next to the BLE hardware and executes BLE commands on behalf of the server over a WebSocket connection:
+
+```
+[Matter Device]  <-- BLE -->  [Proxy Client]  <-- WebSocket /ble -->  [Matter Server]
+```
+
+The primary use case is Home Assistant (with local or ESPHome BLE proxies) acting as the proxy client. See the [BLE Proxy Protocol documentation](../../docs/ble-proxy-protocol.md) for the full protocol specification.
+
+For a Python implementation of the protocol (Bleak-based CLI + reusable library used by the Home Assistant Matter integration), see [`python_ble_proxy/`](../../python_ble_proxy/) and the [`matter-ble-proxy`](https://pypi.org/project/matter-ble-proxy/) package on PyPI.
+
+## Enabling BLE Proxy Mode on the Server
+
+Start the Matter server with the `--ble-proxy` flag:
+
+```bash
+npm run server -- --ble-proxy
+# or
+BLE_PROXY=true npm run server
+```
+
+This exposes a `/ble` WebSocket endpoint (e.g. `ws://localhost:5580/ble`) that proxy clients connect to.
+
+> **Note:** `--ble-proxy` and `--bluetooth-adapter` are mutually exclusive.
+
+## Noble Example Client
+
+The package includes a reference proxy client that bridges a local Bluetooth adapter to the server using [Noble](https://github.com/stoprocent/noble). This is useful for:
+- Testing BLE commissioning without Home Assistant
+- Running the server on a machine without native BLE bindings
+
+### Prerequisites
+
+- A host with a Bluetooth adapter (Linux or macOS)
+- Server running with `--ble-proxy`
+- `@matter/nodejs-ble` optional dependency available (listed in `optionalDependencies`)
+
+For Noble-specific setup (permissions, platform requirements, known limitations), see the
+[Noble prerequisites section](https://github.com/matter-js/matter.js/tree/main/packages/nodejs-ble#prerequisites-and-limitations)
+in the `@matter/nodejs-ble` README.
+
+### Running
+
+```bash
+# Default: connect to ws://localhost:5580/ble
+npm run noble-ble-proxy
+
+# Custom server URL
+npm run noble-ble-proxy -- --server ws://192.168.1.100:5580/ble
+
+# Specific HCI adapter
+npm run noble-ble-proxy -- --hci-id 1
+
+# Help
+npm run noble-ble-proxy -- --help
+```
+
+Once connected, you will see:
+
+```
+Connecting to ws://localhost:5580/ble...
+BLE proxy handshake complete (protocol v1)
+Connected. BLE proxy active. Press Ctrl+C to stop.
+```
+
+The proxy stays connected and handles BLE commissioning commands transparently whenever a commission-via-BLE is triggered.
+
+## Python Example Client
+
+The repository also ships a Python reference proxy client built on
+[Bleak](https://github.com/hbldh/bleak), published to PyPI as
+[`matter-ble-proxy`](https://pypi.org/project/matter-ble-proxy/). Same use
+cases as the Noble client; pick whichever stack you already have set up. The
+Home Assistant Matter integration consumes the library form of this package.
+
+### Prerequisites
+
+- Python 3.12+
+- A host with a Bluetooth adapter (Linux, macOS, or Windows — Bleak supports all three)
+- Server running with `--ble-proxy`
+
+### Running from a release
+
+```bash
+pip install matter-ble-proxy
+matter-ble-proxy --server ws://localhost:5580/ble
+```
+
+### Running from this repository
+
+```bash
+# Default: connect to ws://localhost:5580/ble
+npm run python-ble-proxy:run
+
+# Custom server URL
+npm run python-ble-proxy:run -- --server ws://192.168.1.100:5580/ble --log-level INFO
+```
+
+Once connected, you will see:
+
+```
+17:46:35.541 INFO matter_ble_proxy.cli: Connected. BLE proxy active. Press Ctrl+C to stop.
+```
+
+See [`python_ble_proxy/`](../../python_ble_proxy/) for the library API
+(`MatterBleProxy`, `BleScanSource`, `BleDeviceResolver`, ...) used by
+integrators that bring their own BLE source.
+
+## Home Assistant Integration
+
+The Home Assistant Matter integration automatically connects to `/ble` when the server reports `ble_proxy_enabled: true`. Start the server with `--ble-proxy` (or `ble_proxy: true` in the add-on config). No further HA-side configuration is needed.

package/dist/esm/BleProxyHandler.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+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";
+type HttpServer = ReturnType<typeof createServer>;
+/**
+ * WebSocket server handler 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.
+ */
+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>;
+    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;
+}
+export {};
+//# sourceMappingURL=BleProxyHandler.d.ts.map

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

@@ -0,0 +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,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEK,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEhD;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;CAwHJ"}

package/dist/esm/BleProxyHandler.js

@@ -0,0 +1,256 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createPromise, Logger, Observable, Seconds, Time, withTimeout } from "@matter/main";
+import { WebSocket, WebSocketServer } from "ws";
+import {
+  BLE_PROXY_PROTOCOL_VERSION,
+  decodeBinaryFrame,
+  encodeBinaryFrame
+} from "./BleProxyProtocol.js";
+const logger = Logger.get("BleProxyHandler");
+const HANDSHAKE_TIMEOUT = Seconds(10);
+const COMMAND_TIMEOUT = Seconds(60);
+class BleProxyHandler {
+  #wss;
+  /** Upgrade listener removers, one per HTTP server `register()` call (multi-bind). */
+  #removeUpgradeListeners = [];
+  #client;
+  #handshakeComplete = false;
+  #pendingCommands = /* @__PURE__ */ new Map();
+  /** Command ID counter. Rolls over at 0xFFFF to stay in safe integer range. */
+  #nextCommandId = 0;
+  #closed = false;
+  /** Emitted when a JSON event is received from the BLE proxy client. */
+  eventReceived = new Observable();
+  /** Emitted when a binary frame is received from the BLE proxy client. */
+  binaryFrameReceived = new Observable();
+  get connected() {
+    return this.#handshakeComplete && this.#client?.readyState === WebSocket.OPEN;
+  }
+  async register(server) {
+    const wss = this.#wss = new WebSocketServer({ noServer: true });
+    const upgradeHandler = (req, socket, head) => {
+      logger.debug(`Upgrade request received: ${req.url}`);
+      const path = req.url?.split("?")[0];
+      if (path === "/ble") {
+        req._matterHandledUpgrade = true;
+        wss.handleUpgrade(
+          req,
+          socket,
+          head,
+          (ws) => wss.emit("connection", ws, req)
+        );
+      }
+    };
+    server.on("upgrade", upgradeHandler);
+    this.#removeUpgradeListeners.push(() => server.removeListener("upgrade", upgradeHandler));
+    logger.info("BLE proxy WebSocket endpoint registered on /ble");
+    wss.on("connection", (ws) => {
+      if (this.#closed) {
+        ws.close();
+        return;
+      }
+      if (this.#client) {
+        logger.warn("Rejecting new BLE proxy client - only one connection allowed");
+        ws.close(4e3, "Only one BLE proxy client allowed");
+        return;
+      }
+      logger.info("BLE proxy client connected, waiting for handshake");
+      this.#client = ws;
+      this.#handshakeComplete = false;
+      const handshakeTimer = Time.getTimer("BLE proxy handshake timeout", HANDSHAKE_TIMEOUT, () => {
+        if (!this.#handshakeComplete) {
+          logger.warn("BLE proxy handshake timeout - closing connection");
+          ws.close(4001, "Handshake timeout");
+          this.#cleanupClient();
+        }
+      }).start();
+      ws.on("message", (data, isBinary) => {
+        if (isBinary) {
+          this.#handleBinaryMessage(data);
+        } else {
+          this.#handleTextMessage(data.toString(), handshakeTimer);
+        }
+      });
+      ws.on("close", () => {
+        handshakeTimer.stop();
+        logger.info("BLE proxy client disconnected");
+        this.#cleanupClient();
+      });
+      ws.on("error", (err) => {
+        logger.error("BLE proxy WebSocket error:", err);
+        handshakeTimer.stop();
+        this.#cleanupClient();
+      });
+    });
+  }
+  unregister() {
+    if (!this.#wss || this.#closed) {
+      return Promise.resolve();
+    }
+    this.#closed = true;
+    for (const remove of this.#removeUpgradeListeners) remove();
+    this.#removeUpgradeListeners = [];
+    if (this.#client && this.#client.readyState === WebSocket.OPEN) {
+      this.#client.close();
+    }
+    this.#cleanupClient();
+    const wss = this.#wss;
+    this.#wss = void 0;
+    wss.clients.forEach((client) => {
+      if (client.readyState === WebSocket.OPEN) {
+        client.close();
+      }
+    });
+    return new Promise((resolve, reject) => {
+      wss.close((err) => {
+        if (err) {
+          reject(err);
+        } else {
+          resolve();
+        }
+      });
+    });
+  }
+  /**
+   * 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.
+   */
+  async sendCommand(command, ...rest) {
+    if (!this.connected || !this.#client) {
+      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.#client.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));
+  }
+  /**
+   * Send a binary frame to the BLE proxy client.
+   */
+  sendBinaryFrame(opcode, connectionHandle, payload) {
+    if (!this.connected || !this.#client) {
+      throw new Error("BLE proxy client not connected");
+    }
+    const frame = encodeBinaryFrame(opcode, connectionHandle, payload);
+    this.#client.send(frame);
+  }
+  #handleTextMessage(raw, handshakeTimer) {
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      logger.warn("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) {
+      this.#handleEvent(msg);
+      return;
+    }
+    logger.warn("Received unknown message from BLE proxy client:", msg);
+  }
+  #handleHandshake(msg, handshakeTimer) {
+    if (msg.type !== "hello") {
+      logger.warn(`Expected hello message, got: ${JSON.stringify(msg)}`);
+      this.#client?.close(4002, "Expected hello message");
+      this.#cleanupClient();
+      return;
+    }
+    const hello = msg;
+    handshakeTimer.stop();
+    if (hello.version !== BLE_PROXY_PROTOCOL_VERSION) {
+      logger.warn(
+        `BLE proxy client version ${hello.version} not supported (server supports ${BLE_PROXY_PROTOCOL_VERSION})`
+      );
+      this.#client?.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.#client?.close(4003, "Unsupported protocol version");
+      this.#cleanupClient();
+      return;
+    }
+    this.#handshakeComplete = true;
+    this.#client?.send(
+      JSON.stringify({
+        type: "hello_response",
+        version: BLE_PROXY_PROTOCOL_VERSION
+      })
+    );
+    logger.info(`BLE proxy handshake complete (version ${BLE_PROXY_PROTOCOL_VERSION})`);
+  }
+  #handleResponse(msg) {
+    const pending = this.#pendingCommands.get(msg.id);
+    if (!pending) {
+      logger.warn(`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}`));
+    }
+  }
+  #handleEvent(msg) {
+    this.eventReceived.emit(msg.event, msg.data);
+  }
+  #handleBinaryMessage(data) {
+    if (!this.#handshakeComplete) {
+      logger.warn("Received binary frame before handshake");
+      return;
+    }
+    try {
+      const frame = decodeBinaryFrame(new Uint8Array(data));
+      this.binaryFrameReceived.emit(frame);
+    } catch (err) {
+      logger.error("Failed to decode binary frame:", err);
+    }
+  }
+  #cleanupClient() {
+    if (this.#client) {
+      if (this.#client.readyState === WebSocket.OPEN) {
+        this.#client.close();
+      }
+      this.#client = void 0;
+    }
+    this.#handshakeComplete = false;
+    for (const [id, pending] of this.#pendingCommands) {
+      pending.rejecter(new Error("BLE proxy client disconnected"));
+      this.#pendingCommands.delete(id);
+    }
+  }
+}
+export {
+  BleProxyHandler
+};
+//# sourceMappingURL=BleProxyHandler.js.map

package/dist/esm/BleProxyHandler.js.map

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

package/dist/esm/BleProxyProtocol.d.ts

@@ -0,0 +1,230 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * BLE Proxy Protocol constants, types, and codec.
+ * See docs/ble-proxy-protocol.md for the full specification.
+ */
+export declare const BLE_PROXY_PROTOCOL_VERSION = 1;
+export interface HelloMessage {
+    type: "hello";
+    version: number;
+}
+export interface HelloResponseMessage {
+    type: "hello_response";
+    version: number;
+    error?: string;
+    message?: string;
+}
+export type HandshakeMessage = HelloMessage | HelloResponseMessage;
+export declare const BleProxyCommand: {
+    readonly StartScan: "start_scan";
+    readonly StopScan: "stop_scan";
+    readonly Connect: "connect";
+    readonly Disconnect: "disconnect";
+    readonly DiscoverServices: "discover_services";
+    readonly DiscoverCharacteristics: "discover_characteristics";
+    readonly ReadCharacteristic: "read_characteristic";
+    readonly WriteCharacteristic: "write_characteristic";
+    readonly SubscribeCharacteristic: "subscribe_characteristic";
+    readonly UnsubscribeCharacteristic: "unsubscribe_characteristic";
+    readonly RequestMtu: "request_mtu";
+};
+export type BleProxyCommandName = (typeof BleProxyCommand)[keyof typeof BleProxyCommand];
+export declare const BleProxyEvent: {
+    readonly DeviceDiscovered: "device_discovered";
+    readonly Disconnected: "disconnected";
+    readonly ScanStopped: "scan_stopped";
+    readonly CharacteristicNotification: "characteristic_notification";
+};
+export type BleProxyEventName = (typeof BleProxyEvent)[keyof typeof BleProxyEvent];
+export interface StartScanArgs {
+    service_uuids?: string[];
+    allow_duplicates?: boolean;
+}
+export interface ConnectArgs {
+    address: string;
+    timeout?: number;
+}
+export interface DisconnectArgs {
+    connection_handle: number;
+}
+export interface DiscoverServicesArgs {
+    connection_handle: number;
+}
+export interface DiscoverCharacteristicsArgs {
+    connection_handle: number;
+    service_uuid: string;
+}
+export interface ReadCharacteristicArgs {
+    connection_handle: number;
+    characteristic_uuid: string;
+}
+export interface WriteCharacteristicArgs {
+    connection_handle: number;
+    characteristic_uuid: string;
+    value: string;
+    response?: boolean;
+}
+export interface SubscribeCharacteristicArgs {
+    connection_handle: number;
+    characteristic_uuid: string;
+}
+export interface UnsubscribeCharacteristicArgs {
+    connection_handle: number;
+    characteristic_uuid: string;
+}
+export interface RequestMtuArgs {
+    connection_handle: number;
+    mtu: number;
+}
+export interface ConnectResult {
+    connection_handle: number;
+    mtu: number;
+}
+export interface DiscoverServicesResult {
+    services: Array<{
+        uuid: string;
+    }>;
+}
+export interface DiscoverCharacteristicsResult {
+    characteristics: Array<{
+        uuid: string;
+        properties: string[];
+    }>;
+}
+export interface ReadCharacteristicResult {
+    value: string;
+}
+export interface RequestMtuResult {
+    mtu: number;
+}
+export interface DeviceDiscoveredData {
+    address: string;
+    name?: string;
+    rssi?: number;
+    connectable: boolean;
+    service_data?: Record<string, string>;
+    manufacturer_data?: Record<string, string>;
+    service_uuids?: string[];
+}
+export interface DisconnectedData {
+    connection_handle: number;
+    reason?: string;
+}
+export interface ScanStoppedData {
+    reason: string;
+}
+export interface CharacteristicNotificationData {
+    connection_handle: number;
+    characteristic_uuid: string;
+    value: string;
+}
+/** Maps each command name to its args and result types for type-safe sendCommand. */
+export interface BleProxyCommandMap {
+    [BleProxyCommand.StartScan]: {
+        args: StartScanArgs;
+        result: void;
+    };
+    [BleProxyCommand.StopScan]: {
+        args: undefined;
+        result: void;
+    };
+    [BleProxyCommand.Connect]: {
+        args: ConnectArgs;
+        result: ConnectResult;
+    };
+    [BleProxyCommand.Disconnect]: {
+        args: DisconnectArgs;
+        result: void;
+    };
+    [BleProxyCommand.DiscoverServices]: {
+        args: DiscoverServicesArgs;
+        result: DiscoverServicesResult;
+    };
+    [BleProxyCommand.DiscoverCharacteristics]: {
+        args: DiscoverCharacteristicsArgs;
+        result: DiscoverCharacteristicsResult;
+    };
+    [BleProxyCommand.ReadCharacteristic]: {
+        args: ReadCharacteristicArgs;
+        result: ReadCharacteristicResult;
+    };
+    [BleProxyCommand.WriteCharacteristic]: {
+        args: WriteCharacteristicArgs;
+        result: void;
+    };
+    [BleProxyCommand.SubscribeCharacteristic]: {
+        args: SubscribeCharacteristicArgs;
+        result: void;
+    };
+    [BleProxyCommand.UnsubscribeCharacteristic]: {
+        args: UnsubscribeCharacteristicArgs;
+        result: void;
+    };
+    [BleProxyCommand.RequestMtu]: {
+        args: RequestMtuArgs;
+        result: RequestMtuResult;
+    };
+}
+export interface CommandMessage {
+    id: number;
+    command: BleProxyCommandName;
+    args?: Record<string, unknown>;
+}
+export interface SuccessResponseMessage {
+    id: number;
+    success: true;
+    result?: Record<string, unknown>;
+}
+export interface ErrorResponseMessage {
+    id: number;
+    success: false;
+    error: string;
+    message: string;
+}
+export type ResponseMessage = SuccessResponseMessage | ErrorResponseMessage;
+export interface EventMessage {
+    event: BleProxyEventName;
+    data: Record<string, unknown>;
+}
+export declare const BleProxyErrorCode: {
+    readonly BluetoothUnavailable: "bluetooth_unavailable";
+    readonly AlreadyScanning: "already_scanning";
+    readonly NotScanning: "not_scanning";
+    readonly DeviceNotFound: "device_not_found";
+    readonly ConnectionFailed: "connection_failed";
+    readonly AlreadyConnected: "already_connected";
+    readonly NotConnected: "not_connected";
+    readonly Timeout: "timeout";
+    readonly ServiceNotFound: "service_not_found";
+    readonly CharacteristicNotFound: "characteristic_not_found";
+    readonly ReadFailed: "read_failed";
+    readonly WriteFailed: "write_failed";
+    readonly SubscribeFailed: "subscribe_failed";
+    readonly NotSubscribed: "not_subscribed";
+    readonly NotifyNotSupported: "notify_not_supported";
+    readonly MtuRequestFailed: "mtu_request_failed";
+    readonly DiscoveryFailed: "discovery_failed";
+    readonly InternalError: "internal_error";
+};
+export type BleProxyErrorCodeValue = (typeof BleProxyErrorCode)[keyof typeof BleProxyErrorCode];
+export declare const BinaryFrameOpcode: {
+    /** Server -> Client: write payload to the active write characteristic */
+    readonly WriteData: 1;
+    /** Client -> Server: notification data from a subscribed characteristic */
+    readonly Notification: 2;
+    /** Client -> Server: response data for a read_characteristic command */
+    readonly ReadResponse: 3;
+};
+export type BinaryFrameOpcodeValue = (typeof BinaryFrameOpcode)[keyof typeof BinaryFrameOpcode];
+export interface BinaryFrame {
+    opcode: number;
+    connectionHandle: number;
+    payload: Uint8Array;
+}
+export declare function encodeBinaryFrame(opcode: number, connectionHandle: number, payload: Uint8Array): Uint8Array;
+export declare function decodeBinaryFrame(data: Uint8Array): BinaryFrame;
+//# sourceMappingURL=BleProxyProtocol.d.ts.map

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

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