feat: Add methods for all BLE interactions

[richardhopton]

This PR contains connection logic to call all relevant BLE interactions on the ESP native API.

BLE Advertisements:-

const listener = (advertisement) => { /* some logic */};
connection
  .on('message.BluetoothLEAdvertisementResponse', listener)
  .subscribeBluetoothAdvertisementService();

Note: Unsubscribing has been added to ESPHome & AIOESPHomeApi but it hasn't been released yet so will be hard to test. To unsubscribe you'd want to do this:-

connection
  .off('message.BluetoothLEAdvertisementResponse', listener)
  .unsubscribeBluetoothAdvertisementService();

In the examples I've included below, you will need an address to pass in. The address is the decimal encoded MAC address of the device but is also returned in the BluetoothLEAdvertisementResponse.

Connect to connectable BLE device:-

await connection.connectBluetoothDeviceService(address);

Disconnect from connectable BLE device:-

await connection.disconnectBluetoothDeviceService(address);

For all the following examples you MUST be connected or they will fail.

BLE list GATT services:-

const result = await connection.listBluetoothGATTServicesService(address);

In the following examples, you will need a handle that can be retrieved from the GATT services list.

BLE read GATT Characteristic:-

const result = await connection.listBluetoothGATTServicesService(address, handle);

BLE notify GATT Characteristic:-

connection
  .on('message.BluetoothGATTNotifyDataResponse', (message) => { /* do something with the message.data */ })
  .notifyBluetoothGATTCharacteristicService(address, handle);

BLE write GATT Characteristic:-

// the 4th argument on this function is whether to wait for a response. I'd recommend using true because
// If you don't wait then the message might sit in the queue until it's ready to drain (like on disconnect from esphome)
await connection.writeBluetoothGATTCharacteristicService(address, handle, someUint8Array, true);

BLE write GATT Descriptor:-

await connection.writeBluetoothGATTDescriptorService(address, handle, someUint8Array);

[richardhopton]

this is needed because esp sends 64-bit integers, but JS can only handle 53-bit precision. protocolbuffers/protobuf#3666 (comment)

[twocolors]

Thanks for the help and code.