@matter/nodejs-ble 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/esm/BleScanner.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ChannelType } from "@matter/general";
+import { CommissionableDevice, CommissionableDeviceIdentifiers, Scanner } from "@project-chip/matter.js/common";
+import type { Peripheral } from "@stoprocent/noble";
+import { NobleBleClient } from "./NobleBleClient.js";
+export type DiscoveredBleDevice = {
+    deviceData: CommissionableDeviceData;
+    peripheral: Peripheral;
+    hasAdditionalAdvertisementData: boolean;
+};
+type CommissionableDeviceData = CommissionableDevice & {
+    SD: number;
+};
+export declare class BleScanner implements Scanner {
+    private readonly nobleClient;
+    get type(): ChannelType;
+    private readonly recordWaiters;
+    private readonly discoveredMatterDevices;
+    constructor(nobleClient: NobleBleClient);
+    getDiscoveredDevice(address: string): DiscoveredBleDevice;
+    /**
+     * Registers a deferred promise for a specific queryId together with a timeout and return the promise.
+     * The promise will be resolved when the timer runs out latest.
+     */
+    private registerWaiterPromise;
+    /**
+     * Remove a waiter promise for a specific queryId and stop the connected timer. If required also resolve the
+     * promise.
+     */
+    private finishWaiter;
+    cancelCommissionableDeviceDiscovery(identifier: CommissionableDeviceIdentifiers): void;
+    private handleDiscoveredDevice;
+    private findCommissionableQueryIdentifier;
+    /**
+     * Builds an identifier string for commissionable queries based on the given identifier object.
+     * Some identifiers are identical to the official DNS-SD identifiers, others are custom.
+     */
+    private buildCommissionableQueryIdentifier;
+    private getCommissionableDevices;
+    findOperationalDevice(): Promise<undefined>;
+    getDiscoveredOperationalDevice(): undefined;
+    findCommissionableDevices(identifier: CommissionableDeviceIdentifiers, timeoutSeconds?: number): Promise<CommissionableDevice[]>;
+    findCommissionableDevicesContinuously(identifier: CommissionableDeviceIdentifiers, callback: (device: CommissionableDevice) => void, timeoutSeconds?: number): Promise<CommissionableDevice[]>;
+    getDiscoveredCommissionableDevices(identifier: CommissionableDeviceIdentifiers): CommissionableDevice[];
+    close(): void;
+}
+export {};
+//# sourceMappingURL=BleScanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BleScanner.d.ts","sourceRoot":"","sources":["../../src/BleScanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAS,WAAW,EAAsC,MAAM,iBAAiB,CAAC;AAGzF,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAEhH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIrD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,UAAU,EAAE,wBAAwB,CAAC;IACrC,UAAU,EAAE,UAAU,CAAC;IACvB,8BAA8B,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF,KAAK,wBAAwB,GAAG,oBAAoB,GAAG;IACnD,EAAE,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,qBAAa,UAAW,YAAW,OAAO;IAe1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAdxC,IAAI,IAAI,gBAEP;IAED,OAAO,CAAC,QAAQ,CAAC,aAAa,CAO1B;IACJ,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA0C;gBAErD,WAAW,EAAE,cAAc;IAMjD,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB;IAQhE;;;OAGG;YACW,qBAAqB;IAcnC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAapB,mCAAmC,CAAC,UAAU,EAAE,+BAA+B;IAK/E,OAAO,CAAC,sBAAsB;IAoC9B,OAAO,CAAC,iCAAiC;IAmCzC;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IAa1C,OAAO,CAAC,wBAAwB;IA4B1B,qBAAqB,IAAI,OAAO,CAAC,SAAS,CAAC;IAKjD,8BAA8B,IAAI,SAAS;IAKrC,yBAAyB,CAC3B,UAAU,EAAE,+BAA+B,EAC3C,cAAc,SAAK,GACpB,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAc5B,qCAAqC,CACvC,UAAU,EAAE,+BAA+B,EAC3C,QAAQ,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,EAChD,cAAc,SAAK,GACpB,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA0BlC,kCAAkC,CAAC,UAAU,EAAE,+BAA+B,GAAG,oBAAoB,EAAE;IAIvG,KAAK,IAAI,IAAI;CAMhB"}

package/dist/esm/BleScanner.js

@@ -0,0 +1,220 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes, ChannelType, createPromise, Logger, Time } from "@matter/general";
+import { BleError } from "@project-chip/matter.js/ble";
+import { BtpCodec } from "@project-chip/matter.js/codec";
+import { VendorId } from "@project-chip/matter.js/datatype";
+const logger = Logger.get("BleScanner");
+class BleScanner {
+  constructor(nobleClient) {
+    this.nobleClient = nobleClient;
+    this.nobleClient.setDiscoveryCallback(
+      (address, manufacturerData) => this.handleDiscoveredDevice(address, manufacturerData)
+    );
+  }
+  get type() {
+    return ChannelType.BLE;
+  }
+  recordWaiters = /* @__PURE__ */ new Map();
+  discoveredMatterDevices = /* @__PURE__ */ new Map();
+  getDiscoveredDevice(address) {
+    const device = this.discoveredMatterDevices.get(address);
+    if (device === void 0) {
+      throw new BleError(`No device found for address ${address}`);
+    }
+    return device;
+  }
+  /**
+   * Registers a deferred promise for a specific queryId together with a timeout and return the promise.
+   * The promise will be resolved when the timer runs out latest.
+   */
+  async registerWaiterPromise(queryId, timeoutSeconds, resolveOnUpdatedRecords = true) {
+    const { promise, resolver } = createPromise();
+    const timer = Time.getTimer(
+      "BLE query timeout",
+      timeoutSeconds * 1e3,
+      () => this.finishWaiter(queryId, true)
+    ).start();
+    this.recordWaiters.set(queryId, { resolver, timer, resolveOnUpdatedRecords });
+    logger.debug(
+      `Registered waiter for query ${queryId} with timeout ${timeoutSeconds} seconds${resolveOnUpdatedRecords ? "" : " (not resolving on updated records)"}`
+    );
+    await promise;
+  }
+  /**
+   * Remove a waiter promise for a specific queryId and stop the connected timer. If required also resolve the
+   * promise.
+   */
+  finishWaiter(queryId, resolvePromise, isUpdatedRecord = false) {
+    const waiter = this.recordWaiters.get(queryId);
+    if (waiter === void 0) return;
+    const { timer, resolver, resolveOnUpdatedRecords } = waiter;
+    if (isUpdatedRecord && !resolveOnUpdatedRecords) return;
+    logger.debug(`Finishing waiter for query ${queryId}, resolving: ${resolvePromise}`);
+    timer.stop();
+    if (resolvePromise) {
+      resolver();
+    }
+    this.recordWaiters.delete(queryId);
+  }
+  cancelCommissionableDeviceDiscovery(identifier) {
+    const queryKey = this.buildCommissionableQueryIdentifier(identifier);
+    this.finishWaiter(queryKey, true);
+  }
+  handleDiscoveredDevice(peripheral, manufacturerServiceData) {
+    logger.debug(
+      `Discovered device ${peripheral.address} ${manufacturerServiceData === void 0 ? void 0 : Bytes.toHex(manufacturerServiceData)}`
+    );
+    try {
+      const { discriminator, vendorId, productId, hasAdditionalAdvertisementData } = BtpCodec.decodeBleAdvertisementServiceData(manufacturerServiceData);
+      const commissionableDevice = {
+        deviceIdentifier: peripheral.address,
+        D: discriminator,
+        SD: discriminator >> 8 & 15,
+        VP: `${vendorId}+${productId}`,
+        CM: 1,
+        // Can be no other mode,
+        addresses: [{ type: "ble", peripheralAddress: peripheral.address }]
+      };
+      logger.debug(`Discovered device ${peripheral.address} data: ${Logger.toJSON(commissionableDevice)}`);
+      const deviceExisting = this.discoveredMatterDevices.has(peripheral.address);
+      this.discoveredMatterDevices.set(peripheral.address, {
+        deviceData: commissionableDevice,
+        peripheral,
+        hasAdditionalAdvertisementData
+      });
+      const queryKey = this.findCommissionableQueryIdentifier(commissionableDevice);
+      if (queryKey !== void 0) {
+        this.finishWaiter(queryKey, true, deviceExisting);
+      }
+    } catch (error) {
+      logger.debug(`Seems not to be a valid Matter device: Failed to decode device data: ${error}`);
+    }
+  }
+  findCommissionableQueryIdentifier(record) {
+    const longDiscriminatorQueryId = this.buildCommissionableQueryIdentifier({ longDiscriminator: record.D });
+    if (this.recordWaiters.has(longDiscriminatorQueryId)) {
+      return longDiscriminatorQueryId;
+    }
+    const shortDiscriminatorQueryId = this.buildCommissionableQueryIdentifier({ shortDiscriminator: record.SD });
+    if (this.recordWaiters.has(shortDiscriminatorQueryId)) {
+      return shortDiscriminatorQueryId;
+    }
+    if (record.VP !== void 0) {
+      const vendorIdQueryId = this.buildCommissionableQueryIdentifier({
+        vendorId: VendorId(parseInt(record.VP.split("+")[0]))
+      });
+      if (this.recordWaiters.has(vendorIdQueryId)) {
+        return vendorIdQueryId;
+      }
+      if (record.VP.includes("+")) {
+        const productIdQueryId = this.buildCommissionableQueryIdentifier({
+          vendorId: VendorId(parseInt(record.VP.split("+")[1]))
+        });
+        if (this.recordWaiters.has(productIdQueryId)) {
+          return productIdQueryId;
+        }
+      }
+    }
+    if (this.recordWaiters.has("*")) {
+      return "*";
+    }
+    return void 0;
+  }
+  /**
+   * Builds an identifier string for commissionable queries based on the given identifier object.
+   * Some identifiers are identical to the official DNS-SD identifiers, others are custom.
+   */
+  buildCommissionableQueryIdentifier(identifier) {
+    if ("longDiscriminator" in identifier) {
+      return `D:${identifier.longDiscriminator}`;
+    } else if ("shortDiscriminator" in identifier) {
+      return `SD:${identifier.shortDiscriminator}`;
+    } else if ("vendorId" in identifier) {
+      return `V:${identifier.vendorId}`;
+    } else if ("productId" in identifier) {
+      return `P:${identifier.productId}`;
+    } else return "*";
+  }
+  getCommissionableDevices(identifier) {
+    const storedRecords = Array.from(this.discoveredMatterDevices.values());
+    const foundRecords = new Array();
+    if ("longDiscriminator" in identifier) {
+      foundRecords.push(...storedRecords.filter(({ deviceData: { D } }) => D === identifier.longDiscriminator));
+    } else if ("shortDiscriminator" in identifier) {
+      foundRecords.push(
+        ...storedRecords.filter(({ deviceData: { SD } }) => SD === identifier.shortDiscriminator)
+      );
+    } else if ("vendorId" in identifier) {
+      foundRecords.push(
+        ...storedRecords.filter(
+          ({ deviceData: { VP } }) => VP === `${identifier.vendorId}` || VP?.startsWith(`${identifier.vendorId}+`)
+        )
+      );
+    } else if ("productId" in identifier) {
+      foundRecords.push(
+        ...storedRecords.filter(({ deviceData: { VP } }) => VP?.endsWith(`+${identifier.productId}`))
+      );
+    } else {
+      foundRecords.push(...storedRecords.filter(({ deviceData: { CM } }) => CM === 1 || CM === 2));
+    }
+    return foundRecords;
+  }
+  async findOperationalDevice() {
+    logger.info(`skip BLE scan because scanning for operational devices is not supported`);
+    return void 0;
+  }
+  getDiscoveredOperationalDevice() {
+    logger.info(`skip BLE scan because scanning for operational devices is not supported`);
+    return void 0;
+  }
+  async findCommissionableDevices(identifier, timeoutSeconds = 10) {
+    let storedRecords = this.getCommissionableDevices(identifier);
+    if (storedRecords.length === 0) {
+      const queryKey = this.buildCommissionableQueryIdentifier(identifier);
+      await this.nobleClient.startScanning();
+      await this.registerWaiterPromise(queryKey, timeoutSeconds);
+      storedRecords = this.getCommissionableDevices(identifier);
+      await this.nobleClient.stopScanning();
+    }
+    return storedRecords.map(({ deviceData }) => deviceData);
+  }
+  async findCommissionableDevicesContinuously(identifier, callback, timeoutSeconds = 60) {
+    const discoveredDevices = /* @__PURE__ */ new Set();
+    const discoveryEndTime = Time.nowMs() + timeoutSeconds * 1e3;
+    const queryKey = this.buildCommissionableQueryIdentifier(identifier);
+    await this.nobleClient.startScanning();
+    while (true) {
+      this.getCommissionableDevices(identifier).forEach(({ deviceData }) => {
+        const { deviceIdentifier } = deviceData;
+        if (!discoveredDevices.has(deviceIdentifier)) {
+          discoveredDevices.add(deviceIdentifier);
+          callback(deviceData);
+        }
+      });
+      const remainingTime = Math.ceil((discoveryEndTime - Time.nowMs()) / 1e3);
+      if (remainingTime <= 0) {
+        break;
+      }
+      await this.registerWaiterPromise(queryKey, remainingTime, false);
+    }
+    await this.nobleClient.stopScanning();
+    return this.getCommissionableDevices(identifier).map(({ deviceData }) => deviceData);
+  }
+  getDiscoveredCommissionableDevices(identifier) {
+    return this.getCommissionableDevices(identifier).map(({ deviceData }) => deviceData);
+  }
+  close() {
+    void this.nobleClient.stopScanning();
+    [...this.recordWaiters.keys()].forEach(
+      (queryId) => this.finishWaiter(queryId, !!this.recordWaiters.get(queryId)?.timer)
+    );
+  }
+}
+export {
+  BleScanner
+};
+//# sourceMappingURL=BleScanner.js.map

package/dist/esm/BleScanner.js.map

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

package/dist/esm/BlenoBleServer.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Channel } from "@matter/general";
+import { BleChannel } from "@project-chip/matter.js/ble";
+import { BleOptions } from "./NodeJsBle.js";
+/**
+ * Implements the Matter over BLE server using Bleno as Peripheral.
+ *
+ * Note: Bleno is only supporting a single connection at a time right now - mainly because it also only can announce
+ * one BLE device at a time!
+ */
+export declare class BlenoBleServer extends BleChannel<Uint8Array> {
+    private state;
+    isAdvertising: boolean;
+    private additionalAdvertisingData;
+    private advertisingData;
+    private latestHandshakePayload;
+    private btpSession;
+    private onMatterMessageListener;
+    private writeConformationResolver;
+    clientAddress: string | undefined;
+    private btpHandshakeTimeout;
+    private readonly matterBleService;
+    constructor(options?: BleOptions);
+    /**
+     * Process a Write request on characteristic C1 from the Matter service.
+     * The data are checked if it might be a handshake request and stored until the subscribe request comes in.
+     * Otherwise, the data are forwarded to the BTP session handler to be decoded and processed.
+     *
+     * @param data
+     * @param offset
+     * @param withoutResponse
+     */
+    handleC1WriteRequest(data: Buffer, offset: number, withoutResponse: boolean): void;
+    /**
+     * Process a Subscribe request on characteristic C2 from the Matter service.
+     * This is expected directly after a handshake request and initializes the BTP session handler with the stored
+     * handshake payload.
+     * The BtpSessionHandler instance is wired with the bleno instance for sending data and disconnecting.
+     *
+     * @param maxValueSize
+     * @param updateValueCallback
+     */
+    handleC2SubscribeRequest(maxValueSize: number, updateValueCallback: (data: Buffer) => void): Promise<void>;
+    handleC2Indicate(): void;
+    /**
+     * Process a Read request on characteristic C3 from the Matter service.
+     * The relevant data needs optionally to be set before advertising, else empty data are used.
+     *
+     * @param offset
+     */
+    handleC3ReadRequest(offset: number): Buffer;
+    advertise(advertiseData: Uint8Array, additionalAdvertisementData?: Uint8Array): Promise<void>;
+    stopAdvertising(): Promise<void>;
+    setMatterMessageListener(listener: (socket: Channel<Uint8Array>, data: Uint8Array) => void): void;
+    btpHandshakeTimeoutTriggered(): Promise<void>;
+    close(): Promise<void>;
+    disconnect(): Promise<void>;
+    /**
+     * Send a Matter message to the connected device - need to do BTP assembly first.
+     *
+     * @param data
+     */
+    send(data: Uint8Array): Promise<void>;
+    get name(): string;
+}
+//# sourceMappingURL=BlenoBleServer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlenoBleServer.d.ts","sourceRoot":"","sources":["../../src/BlenoBleServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAA8C,MAAM,iBAAiB,CAAC;AAEtF,OAAO,EAMH,UAAU,EAIb,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAmG5C;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,UAAU,CAAC,UAAU,CAAC;IACtD,OAAO,CAAC,KAAK,CAAa;IAC1B,aAAa,UAAS;IACtB,OAAO,CAAC,yBAAyB,CAA2B;IAC5D,OAAO,CAAC,eAAe,CAAqB;IAE5C,OAAO,CAAC,sBAAsB,CAAqB;IACnD,OAAO,CAAC,UAAU,CAAgC;IAElD,OAAO,CAAC,uBAAuB,CAAwE;IACvG,OAAO,CAAC,yBAAyB,CAAsC;IAEhE,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,OAAO,CAAC,mBAAmB,CAEzB;IAEF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAEtB,OAAO,CAAC,EAAE,UAAU;IAiEhC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO;IA0B3E;;;;;;;;OAQG;IACG,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;IAsChG,gBAAgB;IAShB;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM;IAQ5B,SAAS,CAAC,aAAa,EAAE,UAAU,EAAE,2BAA2B,CAAC,EAAE,UAAU;IAyB7E,eAAe;IAYrB,wBAAwB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI;IAOpF,4BAA4B;IAK5B,KAAK;IAUL,UAAU;IAahB;;;;OAIG;IACG,IAAI,CAAC,IAAI,EAAE,UAAU;IAQ3B,IAAI,IAAI,WAEP;CACJ"}