npm - @capacitor-community/bluetooth-le - Versions diffs - 7.1.0 → 7.1.1 - Mend

@capacitor-community/bluetooth-le 7.1.0 → 7.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md +21 -12
package/android/src/main/java/com/capacitorjs/community/plugins/bluetoothle/BluetoothLe.kt +7 -0
package/dist/docs.json +35 -1
package/dist/esm/definitions.d.ts +17 -5
package/dist/esm/definitions.js.map +1 -1
package/dist/plugin.cjs.js +39 -41
package/dist/plugin.cjs.js.map +1 -1
package/dist/plugin.js +39 -41
package/dist/plugin.js.map +1 -1
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -13,7 +13,7 @@
   <a href="https://www.npmjs.com/package/@capacitor-community/bluetooth-le"><img src="https://img.shields.io/npm/dw/@capacitor-community/bluetooth-le?style=flat-square" /></a>
   <a href="https://www.npmjs.com/package/@capacitor-community/bluetooth-le"><img src="https://img.shields.io/npm/v/@capacitor-community/bluetooth-le?style=flat-square" /></a>
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-<a href="#contributors-"><img src="https://img.shields.io/badge/all%20contributors-22-orange?style=flat-square" /></a>
+<a href="#contributors-"><img src="https://img.shields.io/badge/all%20contributors-23-orange?style=flat-square" /></a>
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 </p>
@@ -255,7 +255,7 @@ export async function main(): Promise<void> {
       HEART_RATE_MEASUREMENT_CHARACTERISTIC,
       (value) => {
         console.log('current heart rate', parseHeartRate(value));
-      }
+      },
     );
     // disconnect after 10 sec
@@ -305,7 +305,7 @@ export async function scan(): Promise<void> {
       },
       (result) => {
         console.log('received new scan result', result);
-      }
+      },
     );
     setTimeout(async () => {
@@ -928,15 +928,23 @@ Stop listening to the changes of the value of a characteristic. For an example,
 #### RequestBleDeviceOptions
-| Prop                   | Type                                                                                                                                          | Description                                                                                                                                                                                                                                               |
-| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`services`**         | <code>string[]</code>                                                                                                                         | Filter devices by service UUIDs. UUIDs have to be specified as 128 bit UUID strings, e.g. ['0000180d-0000-1000-8000-00805f9b34fb'] There is a helper function to convert numbers to UUIDs. e.g. [numberToUUID(0x180f)]. (see [UUID format](#uuid-format)) |
-| **`name`**             | <code>string</code>                                                                                                                           | Filter devices by name                                                                                                                                                                                                                                    |
-| **`namePrefix`**       | <code>string</code>                                                                                                                           | Filter devices by name prefix                                                                                                                                                                                                                             |
-| **`optionalServices`** | <code>string[]</code>                                                                                                                         | For **web**, all services that will be used have to be listed under services or optionalServices, e.g. [numberToUUID(0x180f)] (see [UUID format](#uuid-format))                                                                                           |
-| **`allowDuplicates`**  | <code>boolean</code>                                                                                                                          | Normally scans will discard the second and subsequent advertisements from a single device. If you need to receive them, set allowDuplicates to true (only applicable in `requestLEScan`). (default: false)                                                |
-| **`scanMode`**         | <code><a href="#scanmode">ScanMode</a></code>                                                                                                 | Android scan mode (default: <a href="#scanmode">ScanMode.SCAN_MODE_BALANCED</a>)                                                                                                                                                                          |
-| **`manufacturerData`** | <code>{ companyIdentifier: number; dataPrefix?: <a href="#uint8array">Uint8Array</a>; mask?: <a href="#uint8array">Uint8Array</a>; }[]</code> | Allow scanning for devices with a specific manufacturer data https://developer.mozilla.org/en-US/docs/Web/API/Bluetooth/requestDevice#manufacturerdata                                                                                                    |
+| Prop                   | Type                                          | Description                                                                                                                                                                                                                                               |
+| ---------------------- | --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`services`**         | <code>string[]</code>                         | Filter devices by service UUIDs. UUIDs have to be specified as 128 bit UUID strings, e.g. ['0000180d-0000-1000-8000-00805f9b34fb'] There is a helper function to convert numbers to UUIDs. e.g. [numberToUUID(0x180f)]. (see [UUID format](#uuid-format)) |
+| **`name`**             | <code>string</code>                           | Filter devices by name                                                                                                                                                                                                                                    |
+| **`namePrefix`**       | <code>string</code>                           | Filter devices by name prefix                                                                                                                                                                                                                             |
+| **`optionalServices`** | <code>string[]</code>                         | For **web**, all services that will be used have to be listed under services or optionalServices, e.g. [numberToUUID(0x180f)] (see [UUID format](#uuid-format))                                                                                           |
+| **`allowDuplicates`**  | <code>boolean</code>                          | Normally scans will discard the second and subsequent advertisements from a single device. If you need to receive them, set allowDuplicates to true (only applicable in `requestLEScan`). (default: false)                                                |
+| **`scanMode`**         | <code><a href="#scanmode">ScanMode</a></code> | Android scan mode (default: <a href="#scanmode">ScanMode.SCAN_MODE_BALANCED</a>)                                                                                                                                                                          |
+| **`manufacturerData`** | <code>ManufacturerDataFilter[]</code>         | Allow scanning for devices with a specific manufacturer data https://developer.mozilla.org/en-US/docs/Web/API/Bluetooth/requestDevice#manufacturerdata                                                                                                    |
+#### ManufacturerDataFilter
+| Prop                    | Type                                              | Description                                                                                                                                                                                                 |
+| ----------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`companyIdentifier`** | <code>number</code>                               | Company ID (sometimes called the manufacturer ID) to search for in the manufacturer data field.                                                                                                             |
+| **`dataPrefix`**        | <code><a href="#uint8array">Uint8Array</a></code> | Prefix to match in the manufacturer data field. On **Android** this field is mandatory.                                                                                                                     |
+| **`mask`**              | <code><a href="#uint8array">Uint8Array</a></code> | Set filter on partial manufacture data. For any bit in the mask, set it the 1 if it needs to match the one in manufacturer data, otherwise set it to 0. The `mask` must have the same length of dataPrefix. |
 #### Uint8Array
@@ -1201,6 +1209,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     </tr>
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/gion-andri"><img src="https://avatars.githubusercontent.com/u/540998?v=4?s=100" width="100px;" alt="Gion-Andri Cantieni"/><br /><sub><b>Gion-Andri Cantieni</b></sub></a><br /><a href="https://github.com/capacitor-community/bluetooth-le/commits?author=gion-andri" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/JasonAsmk"><img src="https://avatars.githubusercontent.com/u/994111?v=4?s=100" width="100px;" alt="Iason Asimakopoulos"/><br /><sub><b>Iason Asimakopoulos</b></sub></a><br /><a href="https://github.com/capacitor-community/bluetooth-le/commits?author=JasonAsmk" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

package/android/src/main/java/com/capacitorjs/community/plugins/bluetoothle/BluetoothLe.kt CHANGED Viewed

@@ -874,6 +874,13 @@ class BluetoothLe : Plugin() {
                     filters.add(filterBuilder.build())
                 }
             }
+            // Create filters when providing only name
+            if (name != null && filters.isEmpty()) {
+                val filterBuilder = ScanFilter.Builder()
+                filterBuilder.setDeviceName(name)
+                filters.add(filterBuilder.build())
+            }
             return filters;
         } catch (e: IllegalArgumentException) {
             call.reject("Invalid UUID or Manufacturer data provided.")

package/dist/docs.json CHANGED Viewed

@@ -1113,10 +1113,44 @@
           "name": "manufacturerData",
           "tags": [],
           "docs": "Allow scanning for devices with a specific manufacturer data\r\nhttps://developer.mozilla.org/en-US/docs/Web/API/Bluetooth/requestDevice#manufacturerdata",
+          "complexTypes": [
+            "ManufacturerDataFilter"
+          ],
+          "type": "ManufacturerDataFilter[] | undefined"
+        }
+      ]
+    },
+    {
+      "name": "ManufacturerDataFilter",
+      "slug": "manufacturerdatafilter",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "companyIdentifier",
+          "tags": [],
+          "docs": "Company ID (sometimes called the manufacturer ID) to search for in the manufacturer data field.",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "dataPrefix",
+          "tags": [],
+          "docs": "Prefix to match in the manufacturer data field.\r\nOn **Android** this field is mandatory.",
+          "complexTypes": [
+            "Uint8Array"
+          ],
+          "type": "Uint8Array"
+        },
+        {
+          "name": "mask",
+          "tags": [],
+          "docs": "Set filter on partial manufacture data. For any bit in the mask, set it the 1 if it needs to match the one in manufacturer data, otherwise set it to 0.\r\nThe `mask` must have the same length of dataPrefix.",
           "complexTypes": [
             "Uint8Array"
           ],
-          "type": "{ companyIdentifier: number; dataPrefix?: Uint8Array | undefined; mask?: Uint8Array | undefined; }[] | undefined"
+          "type": "Uint8Array"
         }
       ]
     },

package/dist/esm/definitions.d.ts CHANGED Viewed

@@ -47,11 +47,7 @@ export interface RequestBleDeviceOptions {
      * Allow scanning for devices with a specific manufacturer data
      * https://developer.mozilla.org/en-US/docs/Web/API/Bluetooth/requestDevice#manufacturerdata
      */
-    manufacturerData?: {
-        companyIdentifier: number;
-        dataPrefix?: Uint8Array;
-        mask?: Uint8Array;
-    }[];
+    manufacturerData?: ManufacturerDataFilter[];
 }
 /**
  * Android scan mode
@@ -93,6 +89,22 @@ export declare enum ConnectionPriority {
      */
     CONNECTION_PRIORITY_LOW_POWER = 2
 }
+export interface ManufacturerDataFilter {
+    /**
+     * Company ID (sometimes called the manufacturer ID) to search for in the manufacturer data field.
+     */
+    companyIdentifier: number;
+    /**
+     * Prefix to match in the manufacturer data field.
+     * On **Android** this field is mandatory.
+     */
+    dataPrefix?: Uint8Array;
+    /**
+     * Set filter on partial manufacture data. For any bit in the mask, set it the 1 if it needs to match the one in manufacturer data, otherwise set it to 0.
+     * The `mask` must have the same length of dataPrefix.
+     */
+    mask?: Uint8Array;
+}
 export interface BleDevice {
     /**
      * ID of the device, which will be needed for further calls.

package/dist/esm/definitions.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAuDA;;GAEG;AACH,MAAM,CAAN,IAAY,QAgBX;AAhBD,WAAY,QAAQ;IAClB;;;OAGG;IACH,qEAAuB,CAAA;IACvB;;;OAGG;IACH,mEAAsB,CAAA;IACtB;;;OAGG;IACH,yEAAyB,CAAA;AAC3B,CAAC,EAhBW,QAAQ,KAAR,QAAQ,QAgBnB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,kBAgBX;AAhBD,WAAY,kBAAkB;IAC5B;;;OAGG;IACH,2GAAgC,CAAA;IAChC;;;OAGG;IACH,mGAA4B,CAAA;IAC5B;;;OAGG;IACH,6GAAiC,CAAA;AACnC,CAAC,EAhBW,kBAAkB,KAAlB,kBAAkB,QAgB7B","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\r\n\r\nimport type { DisplayStrings } from './config';\r\n\r\nexport interface InitializeOptions {\r\n /*\r\n If your app doesn't use Bluetooth scan results to derive physical\r\n * location information, you can strongly assert that your app\r\n * doesn't derive physical location. (Android only)\r\n * Requires adding 'neverForLocation' to AndroidManifest.xml\r\n * https://developer.android.com/guide/topics/connectivity/bluetooth/permissions#assert-never-for-location\r\n * @default false\r\n /\r\n androidNeverForLocation?: boolean;\r\n}\r\n\r\nexport interface RequestBleDeviceOptions {\r\n /\r\n Filter devices by service UUIDs.\r\n * UUIDs have to be specified as 128 bit UUID strings,\r\n * e.g. ['0000180d-0000-1000-8000-00805f9b34fb']\r\n * There is a helper function to convert numbers to UUIDs.\r\n * e.g. [numberToUUID(0x180f)]. (see [UUID format](#uuid-format))\r\n /\r\n services?: string[];\r\n /\r\n Filter devices by name\r\n /\r\n name?: string;\r\n /\r\n Filter devices by name prefix\r\n /\r\n namePrefix?: string;\r\n /\r\n For web, all services that will be used have to be listed under services or optionalServices,\r\n * e.g. [numberToUUID(0x180f)] (see [UUID format](#uuid-format))\r\n /\r\n optionalServices?: string[];\r\n /\r\n Normally scans will discard the second and subsequent advertisements from a single device.\r\n * If you need to receive them, set allowDuplicates to true (only applicable in `requestLEScan`).\r\n * (default: false)\r\n /\r\n allowDuplicates?: boolean;\r\n /\r\n Android scan mode (default: ScanMode.SCAN_MODE_BALANCED)\r\n /\r\n scanMode?: ScanMode;\r\n /\r\n Allow scanning for devices with a specific manufacturer data\r\n * https://developer.mozilla.org/en-US/docs/Web/API/Bluetooth/requestDevice#manufacturerdata\r\n /\r\n manufacturerData?: { companyIdentifier: number; dataPrefix?: Uint8Array; mask?: Uint8Array }[];\r\n}\r\n\r\n/\r\n Android scan mode\r\n /\r\nexport enum ScanMode {\r\n /\r\n Perform Bluetooth LE scan in low power mode. This mode is enforced if the scanning application is not in foreground.\r\n * https://developer.android.com/reference/android/bluetooth/le/ScanSettings#SCAN_MODE_LOW_POWER\r\n /\r\n SCAN_MODE_LOW_POWER = 0,\r\n /\r\n Perform Bluetooth LE scan in balanced power mode. (default) Scan results are returned at a rate that provides a good trade-off between scan frequency and power consumption.\r\n * https://developer.android.com/reference/android/bluetooth/le/ScanSettings#SCAN_MODE_BALANCED\r\n /\r\n SCAN_MODE_BALANCED = 1,\r\n /\r\n Scan using highest duty cycle. It's recommended to only use this mode when the application is running in the foreground.\r\n * https://developer.android.com/reference/android/bluetooth/le/ScanSettings#SCAN_MODE_LOW_LATENCY\r\n /\r\n SCAN_MODE_LOW_LATENCY = 2,\r\n}\r\n\r\n/\r\n Android connection priority used in `requestConnectionPriority`\r\n /\r\nexport enum ConnectionPriority {\r\n /\r\n Use the connection parameters recommended by the Bluetooth SIG. This is the default value if no connection parameter update is requested.\r\n * https://developer.android.com/reference/android/bluetooth/BluetoothGatt#CONNECTION_PRIORITY_BALANCED\r\n /\r\n CONNECTION_PRIORITY_BALANCED = 0,\r\n /\r\n Request a high priority, low latency connection. An application should only request high priority connection parameters to transfer large amounts of data over LE quickly. Once the transfer is complete, the application should request CONNECTION_PRIORITY_BALANCED connection parameters to reduce energy use.\r\n * https://developer.android.com/reference/android/bluetooth/BluetoothGatt#CONNECTION_PRIORITY_HIGH\r\n /\r\n CONNECTION_PRIORITY_HIGH = 1,\r\n /\r\n Request low power, reduced data rate connection parameters.\r\n * https://developer.android.com/reference/android/bluetooth/BluetoothGatt#CONNECTION_PRIORITY_LOW_POWER\r\n /\r\n CONNECTION_PRIORITY_LOW_POWER = 2,\r\n}\r\n\r\nexport interface BleDevice {\r\n /\r\n ID of the device, which will be needed for further calls.\r\n * On Android this is the BLE MAC address.\r\n * On iOS and web it is an identifier.\r\n /\r\n deviceId: string;\r\n /\r\n Name of the peripheral device.\r\n /\r\n name?: string;\r\n uuids?: string[];\r\n}\r\n\r\nexport interface DeviceIdOptions {\r\n deviceId: string;\r\n}\r\nexport interface TimeoutOptions {\r\n /\r\n Timeout in milliseconds for plugin call.\r\n * Default is 10000 for `connect` and 5000 for other plugin methods.\r\n /\r\n timeout?: number;\r\n}\r\n\r\nexport interface RequestConnectionPriorityOptions extends DeviceIdOptions {\r\n connectionPriority: ConnectionPriority;\r\n}\r\n\r\nexport interface GetDevicesOptions {\r\n deviceIds: string[];\r\n}\r\n\r\nexport interface GetConnectedDevicesOptions {\r\n services: string[];\r\n}\r\n\r\nexport interface BleService {\r\n readonly uuid: string;\r\n readonly characteristics: BleCharacteristic[];\r\n}\r\n\r\nexport interface BleDescriptor {\r\n readonly uuid: string;\r\n}\r\n\r\nexport interface BleCharacteristic {\r\n readonly uuid: string;\r\n readonly properties: BleCharacteristicProperties;\r\n readonly descriptors: BleDescriptor[];\r\n}\r\n\r\nexport interface BleCharacteristicProperties {\r\n readonly broadcast: boolean;\r\n readonly read: boolean;\r\n readonly writeWithoutResponse: boolean;\r\n readonly write: boolean;\r\n readonly notify: boolean;\r\n readonly indicate: boolean;\r\n readonly authenticatedSignedWrites: boolean;\r\n readonly reliableWrite?: boolean;\r\n readonly writableAuxiliaries?: boolean;\r\n readonly extendedProperties?: boolean;\r\n readonly notifyEncryptionRequired?: boolean;\r\n readonly indicateEncryptionRequired?: boolean;\r\n}\r\n\r\nexport interface BleServices {\r\n services: BleService[];\r\n}\r\n\r\nexport interface ReadOptions {\r\n deviceId: string;\r\n service: string;\r\n characteristic: string;\r\n}\r\n\r\nexport interface ReadDescriptorOptions {\r\n deviceId: string;\r\n service: string;\r\n characteristic: string;\r\n descriptor: string;\r\n}\r\n\r\nexport type Data = DataView \| string;\r\n\r\nexport interface WriteOptions {\r\n deviceId: string;\r\n service: string;\r\n characteristic: string;\r\n /\r\n android, ios: string\r\n * web: DataView\r\n /\r\n value: Data;\r\n}\r\n\r\nexport interface WriteDescriptorOptions {\r\n deviceId: string;\r\n service: string;\r\n characteristic: string;\r\n descriptor: string;\r\n /\r\n android, ios: string\r\n * web: DataView\r\n /\r\n value: Data;\r\n}\r\n\r\nexport interface BooleanResult {\r\n value: boolean;\r\n}\r\n\r\nexport interface GetDevicesResult {\r\n devices: BleDevice[];\r\n}\r\n\r\nexport interface GetMtuResult {\r\n value: number;\r\n}\r\n\r\nexport interface ReadRssiResult {\r\n value: string;\r\n}\r\n\r\nexport interface ReadResult {\r\n /\r\n android, ios: string\r\n * web: DataView\r\n /\r\n value?: Data;\r\n}\r\n\r\nexport interface ScanResultInternal<T = Data> {\r\n device: BleDevice;\r\n localName?: string;\r\n rssi?: number;\r\n txPower?: number;\r\n manufacturerData?: { [key: string]: T };\r\n serviceData?: { [key: string]: T };\r\n uuids?: string[];\r\n rawAdvertisement?: T;\r\n}\r\n\r\nexport interface ScanResult {\r\n /\r\n The peripheral device that was found in the scan.\r\n * Android and web: `device.name` is always identical to `localName`.\r\n * iOS: `device.name` is identical to `localName` the first time a device is discovered, but after connecting `device.name` is the cached GAP name in subsequent scans.\r\n /\r\n device: BleDevice;\r\n /\r\n The name of the peripheral device from the advertisement data.\r\n /\r\n localName?: string;\r\n /\r\n Received Signal Strength Indication.\r\n /\r\n rssi?: number;\r\n /\r\n Transmit power in dBm. A value of 127 indicates that it is not available.\r\n /\r\n txPower?: number;\r\n /\r\n Manufacturer data, key is a company identifier and value is the data.\r\n /\r\n manufacturerData?: { [key: string]: DataView };\r\n /\r\n Service data, key is a service UUID and value is the data.\r\n /\r\n serviceData?: { [key: string]: DataView };\r\n /\r\n Advertised services.\r\n /\r\n uuids?: string[];\r\n /\r\n Raw advertisement data (Android only).\r\n */\r\n rawAdvertisement?: DataView;\r\n}\r\n\r\nexport interface BluetoothLePlugin {\r\n initialize(options?: InitializeOptions): Promise<void>;\r\n isEnabled(): Promise<BooleanResult>;\r\n requestEnable(): Promise<void>;\r\n enable(): Promise<void>;\r\n disable(): Promise<void>;\r\n startEnabledNotifications(): Promise<void>;\r\n stopEnabledNotifications(): Promise<void>;\r\n isLocationEnabled(): Promise<BooleanResult>;\r\n openLocationSettings(): Promise<void>;\r\n openBluetoothSettings(): Promise<void>;\r\n openAppSettings(): Promise<void>;\r\n setDisplayStrings(displayStrings: DisplayStrings): Promise<void>;\r\n requestDevice(options?: RequestBleDeviceOptions): Promise<BleDevice>;\r\n requestLEScan(options?: RequestBleDeviceOptions): Promise<void>;\r\n stopLEScan(): Promise<void>;\r\n getDevices(options: GetDevicesOptions): Promise<GetDevicesResult>;\r\n getConnectedDevices(options: GetConnectedDevicesOptions): Promise<GetDevicesResult>;\r\n getBondedDevices(): Promise<GetDevicesResult>;\r\n addListener(\r\n eventName: 'onEnabledChanged',\r\n listenerFunc: (result: BooleanResult) => void,\r\n ): Promise<PluginListenerHandle>;\r\n addListener(eventName: string, listenerFunc: (event: ReadResult) => void): Promise<PluginListenerHandle>;\r\n addListener(\r\n eventName: 'onScanResult',\r\n listenerFunc: (result: ScanResultInternal) => void,\r\n ): Promise<PluginListenerHandle>;\r\n connect(options: DeviceIdOptions & TimeoutOptions): Promise<void>;\r\n createBond(options: DeviceIdOptions & TimeoutOptions): Promise<void>;\r\n isBonded(options: DeviceIdOptions): Promise<BooleanResult>;\r\n disconnect(options: DeviceIdOptions): Promise<void>;\r\n getServices(options: DeviceIdOptions): Promise<BleServices>;\r\n discoverServices(options: DeviceIdOptions): Promise<void>;\r\n getMtu(options: DeviceIdOptions): Promise<GetMtuResult>;\r\n requestConnectionPriority(options: RequestConnectionPriorityOptions): Promise<void>;\r\n readRssi(options: DeviceIdOptions): Promise<ReadRssiResult>;\r\n read(options: ReadOptions & TimeoutOptions): Promise<ReadResult>;\r\n write(options: WriteOptions & TimeoutOptions): Promise<void>;\r\n writeWithoutResponse(options: WriteOptions & TimeoutOptions): Promise<void>;\r\n readDescriptor(options: ReadDescriptorOptions & TimeoutOptions): Promise<ReadResult>;\r\n writeDescriptor(options: WriteDescriptorOptions & TimeoutOptions): Promise<void>;\r\n startNotifications(options: ReadOptions): Promise<void>;\r\n stopNotifications(options: ReadOptions): Promise<void>;\r\n}\r\n"]}
1	+ {"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAuDA;;GAEG;AACH,MAAM,CAAN,IAAY,QAgBX;AAhBD,WAAY,QAAQ;IAClB;;;OAGG;IACH,qEAAuB,CAAA;IACvB;;;OAGG;IACH,mEAAsB,CAAA;IACtB;;;OAGG;IACH,yEAAyB,CAAA;AAC3B,CAAC,EAhBW,QAAQ,KAAR,QAAQ,QAgBnB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,kBAgBX;AAhBD,WAAY,kBAAkB;IAC5B;;;OAGG;IACH,2GAAgC,CAAA;IAChC;;;OAGG;IACH,mGAA4B,CAAA;IAC5B;;;OAGG;IACH,6GAAiC,CAAA;AACnC,CAAC,EAhBW,kBAAkB,KAAlB,kBAAkB,QAgB7B","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\r\n\r\nimport type { DisplayStrings } from './config';\r\n\r\nexport interface InitializeOptions {\r\n /*\r\n If your app doesn't use Bluetooth scan results to derive physical\r\n * location information, you can strongly assert that your app\r\n * doesn't derive physical location. (Android only)\r\n * Requires adding 'neverForLocation' to AndroidManifest.xml\r\n * https://developer.android.com/guide/topics/connectivity/bluetooth/permissions#assert-never-for-location\r\n * @default false\r\n /\r\n androidNeverForLocation?: boolean;\r\n}\r\n\r\nexport interface RequestBleDeviceOptions {\r\n /\r\n Filter devices by service UUIDs.\r\n * UUIDs have to be specified as 128 bit UUID strings,\r\n * e.g. ['0000180d-0000-1000-8000-00805f9b34fb']\r\n * There is a helper function to convert numbers to UUIDs.\r\n * e.g. [numberToUUID(0x180f)]. (see [UUID format](#uuid-format))\r\n /\r\n services?: string[];\r\n /\r\n Filter devices by name\r\n /\r\n name?: string;\r\n /\r\n Filter devices by name prefix\r\n /\r\n namePrefix?: string;\r\n /\r\n For web, all services that will be used have to be listed under services or optionalServices,\r\n * e.g. [numberToUUID(0x180f)] (see [UUID format](#uuid-format))\r\n /\r\n optionalServices?: string[];\r\n /\r\n Normally scans will discard the second and subsequent advertisements from a single device.\r\n * If you need to receive them, set allowDuplicates to true (only applicable in `requestLEScan`).\r\n * (default: false)\r\n /\r\n allowDuplicates?: boolean;\r\n /\r\n Android scan mode (default: ScanMode.SCAN_MODE_BALANCED)\r\n /\r\n scanMode?: ScanMode;\r\n /\r\n Allow scanning for devices with a specific manufacturer data\r\n * https://developer.mozilla.org/en-US/docs/Web/API/Bluetooth/requestDevice#manufacturerdata\r\n /\r\n manufacturerData?: ManufacturerDataFilter[];\r\n}\r\n\r\n/\r\n Android scan mode\r\n /\r\nexport enum ScanMode {\r\n /\r\n Perform Bluetooth LE scan in low power mode. This mode is enforced if the scanning application is not in foreground.\r\n * https://developer.android.com/reference/android/bluetooth/le/ScanSettings#SCAN_MODE_LOW_POWER\r\n /\r\n SCAN_MODE_LOW_POWER = 0,\r\n /\r\n Perform Bluetooth LE scan in balanced power mode. (default) Scan results are returned at a rate that provides a good trade-off between scan frequency and power consumption.\r\n * https://developer.android.com/reference/android/bluetooth/le/ScanSettings#SCAN_MODE_BALANCED\r\n /\r\n SCAN_MODE_BALANCED = 1,\r\n /\r\n Scan using highest duty cycle. It's recommended to only use this mode when the application is running in the foreground.\r\n * https://developer.android.com/reference/android/bluetooth/le/ScanSettings#SCAN_MODE_LOW_LATENCY\r\n /\r\n SCAN_MODE_LOW_LATENCY = 2,\r\n}\r\n\r\n/\r\n Android connection priority used in `requestConnectionPriority`\r\n /\r\nexport enum ConnectionPriority {\r\n /\r\n Use the connection parameters recommended by the Bluetooth SIG. This is the default value if no connection parameter update is requested.\r\n * https://developer.android.com/reference/android/bluetooth/BluetoothGatt#CONNECTION_PRIORITY_BALANCED\r\n /\r\n CONNECTION_PRIORITY_BALANCED = 0,\r\n /\r\n Request a high priority, low latency connection. An application should only request high priority connection parameters to transfer large amounts of data over LE quickly. Once the transfer is complete, the application should request CONNECTION_PRIORITY_BALANCED connection parameters to reduce energy use.\r\n * https://developer.android.com/reference/android/bluetooth/BluetoothGatt#CONNECTION_PRIORITY_HIGH\r\n /\r\n CONNECTION_PRIORITY_HIGH = 1,\r\n /\r\n Request low power, reduced data rate connection parameters.\r\n * https://developer.android.com/reference/android/bluetooth/BluetoothGatt#CONNECTION_PRIORITY_LOW_POWER\r\n /\r\n CONNECTION_PRIORITY_LOW_POWER = 2,\r\n}\r\n\r\nexport interface ManufacturerDataFilter {\r\n /\r\n Company ID (sometimes called the manufacturer ID) to search for in the manufacturer data field.\r\n /\r\n companyIdentifier: number;\r\n\r\n /\r\n Prefix to match in the manufacturer data field.\r\n * On Android this field is mandatory.\r\n /\r\n dataPrefix?: Uint8Array;\r\n\r\n /\r\n Set filter on partial manufacture data. For any bit in the mask, set it the 1 if it needs to match the one in manufacturer data, otherwise set it to 0.\r\n * The `mask` must have the same length of dataPrefix.\r\n /\r\n mask?: Uint8Array;\r\n}\r\n\r\nexport interface BleDevice {\r\n /\r\n ID of the device, which will be needed for further calls.\r\n * On Android this is the BLE MAC address.\r\n * On iOS and web it is an identifier.\r\n /\r\n deviceId: string;\r\n /\r\n Name of the peripheral device.\r\n /\r\n name?: string;\r\n uuids?: string[];\r\n}\r\n\r\nexport interface DeviceIdOptions {\r\n deviceId: string;\r\n}\r\nexport interface TimeoutOptions {\r\n /\r\n Timeout in milliseconds for plugin call.\r\n * Default is 10000 for `connect` and 5000 for other plugin methods.\r\n /\r\n timeout?: number;\r\n}\r\n\r\nexport interface RequestConnectionPriorityOptions extends DeviceIdOptions {\r\n connectionPriority: ConnectionPriority;\r\n}\r\n\r\nexport interface GetDevicesOptions {\r\n deviceIds: string[];\r\n}\r\n\r\nexport interface GetConnectedDevicesOptions {\r\n services: string[];\r\n}\r\n\r\nexport interface BleService {\r\n readonly uuid: string;\r\n readonly characteristics: BleCharacteristic[];\r\n}\r\n\r\nexport interface BleDescriptor {\r\n readonly uuid: string;\r\n}\r\n\r\nexport interface BleCharacteristic {\r\n readonly uuid: string;\r\n readonly properties: BleCharacteristicProperties;\r\n readonly descriptors: BleDescriptor[];\r\n}\r\n\r\nexport interface BleCharacteristicProperties {\r\n readonly broadcast: boolean;\r\n readonly read: boolean;\r\n readonly writeWithoutResponse: boolean;\r\n readonly write: boolean;\r\n readonly notify: boolean;\r\n readonly indicate: boolean;\r\n readonly authenticatedSignedWrites: boolean;\r\n readonly reliableWrite?: boolean;\r\n readonly writableAuxiliaries?: boolean;\r\n readonly extendedProperties?: boolean;\r\n readonly notifyEncryptionRequired?: boolean;\r\n readonly indicateEncryptionRequired?: boolean;\r\n}\r\n\r\nexport interface BleServices {\r\n services: BleService[];\r\n}\r\n\r\nexport interface ReadOptions {\r\n deviceId: string;\r\n service: string;\r\n characteristic: string;\r\n}\r\n\r\nexport interface ReadDescriptorOptions {\r\n deviceId: string;\r\n service: string;\r\n characteristic: string;\r\n descriptor: string;\r\n}\r\n\r\nexport type Data = DataView \| string;\r\n\r\nexport interface WriteOptions {\r\n deviceId: string;\r\n service: string;\r\n characteristic: string;\r\n /\r\n android, ios: string\r\n * web: DataView\r\n /\r\n value: Data;\r\n}\r\n\r\nexport interface WriteDescriptorOptions {\r\n deviceId: string;\r\n service: string;\r\n characteristic: string;\r\n descriptor: string;\r\n /\r\n android, ios: string\r\n * web: DataView\r\n /\r\n value: Data;\r\n}\r\n\r\nexport interface BooleanResult {\r\n value: boolean;\r\n}\r\n\r\nexport interface GetDevicesResult {\r\n devices: BleDevice[];\r\n}\r\n\r\nexport interface GetMtuResult {\r\n value: number;\r\n}\r\n\r\nexport interface ReadRssiResult {\r\n value: string;\r\n}\r\n\r\nexport interface ReadResult {\r\n /\r\n android, ios: string\r\n * web: DataView\r\n /\r\n value?: Data;\r\n}\r\n\r\nexport interface ScanResultInternal<T = Data> {\r\n device: BleDevice;\r\n localName?: string;\r\n rssi?: number;\r\n txPower?: number;\r\n manufacturerData?: { [key: string]: T };\r\n serviceData?: { [key: string]: T };\r\n uuids?: string[];\r\n rawAdvertisement?: T;\r\n}\r\n\r\nexport interface ScanResult {\r\n /\r\n The peripheral device that was found in the scan.\r\n * Android and web: `device.name` is always identical to `localName`.\r\n * iOS: `device.name` is identical to `localName` the first time a device is discovered, but after connecting `device.name` is the cached GAP name in subsequent scans.\r\n /\r\n device: BleDevice;\r\n /\r\n The name of the peripheral device from the advertisement data.\r\n /\r\n localName?: string;\r\n /\r\n Received Signal Strength Indication.\r\n /\r\n rssi?: number;\r\n /\r\n Transmit power in dBm. A value of 127 indicates that it is not available.\r\n /\r\n txPower?: number;\r\n /\r\n Manufacturer data, key is a company identifier and value is the data.\r\n /\r\n manufacturerData?: { [key: string]: DataView };\r\n /\r\n Service data, key is a service UUID and value is the data.\r\n /\r\n serviceData?: { [key: string]: DataView };\r\n /\r\n Advertised services.\r\n /\r\n uuids?: string[];\r\n /\r\n Raw advertisement data (Android only).\r\n */\r\n rawAdvertisement?: DataView;\r\n}\r\n\r\nexport interface BluetoothLePlugin {\r\n initialize(options?: InitializeOptions): Promise<void>;\r\n isEnabled(): Promise<BooleanResult>;\r\n requestEnable(): Promise<void>;\r\n enable(): Promise<void>;\r\n disable(): Promise<void>;\r\n startEnabledNotifications(): Promise<void>;\r\n stopEnabledNotifications(): Promise<void>;\r\n isLocationEnabled(): Promise<BooleanResult>;\r\n openLocationSettings(): Promise<void>;\r\n openBluetoothSettings(): Promise<void>;\r\n openAppSettings(): Promise<void>;\r\n setDisplayStrings(displayStrings: DisplayStrings): Promise<void>;\r\n requestDevice(options?: RequestBleDeviceOptions): Promise<BleDevice>;\r\n requestLEScan(options?: RequestBleDeviceOptions): Promise<void>;\r\n stopLEScan(): Promise<void>;\r\n getDevices(options: GetDevicesOptions): Promise<GetDevicesResult>;\r\n getConnectedDevices(options: GetConnectedDevicesOptions): Promise<GetDevicesResult>;\r\n getBondedDevices(): Promise<GetDevicesResult>;\r\n addListener(\r\n eventName: 'onEnabledChanged',\r\n listenerFunc: (result: BooleanResult) => void,\r\n ): Promise<PluginListenerHandle>;\r\n addListener(eventName: string, listenerFunc: (event: ReadResult) => void): Promise<PluginListenerHandle>;\r\n addListener(\r\n eventName: 'onScanResult',\r\n listenerFunc: (result: ScanResultInternal) => void,\r\n ): Promise<PluginListenerHandle>;\r\n connect(options: DeviceIdOptions & TimeoutOptions): Promise<void>;\r\n createBond(options: DeviceIdOptions & TimeoutOptions): Promise<void>;\r\n isBonded(options: DeviceIdOptions): Promise<BooleanResult>;\r\n disconnect(options: DeviceIdOptions): Promise<void>;\r\n getServices(options: DeviceIdOptions): Promise<BleServices>;\r\n discoverServices(options: DeviceIdOptions): Promise<void>;\r\n getMtu(options: DeviceIdOptions): Promise<GetMtuResult>;\r\n requestConnectionPriority(options: RequestConnectionPriorityOptions): Promise<void>;\r\n readRssi(options: DeviceIdOptions): Promise<ReadRssiResult>;\r\n read(options: ReadOptions & TimeoutOptions): Promise<ReadResult>;\r\n write(options: WriteOptions & TimeoutOptions): Promise<void>;\r\n writeWithoutResponse(options: WriteOptions & TimeoutOptions): Promise<void>;\r\n readDescriptor(options: ReadDescriptorOptions & TimeoutOptions): Promise<ReadResult>;\r\n writeDescriptor(options: WriteDescriptorOptions & TimeoutOptions): Promise<void>;\r\n startNotifications(options: ReadOptions): Promise<void>;\r\n stopNotifications(options: ReadOptions): Promise<void>;\r\n}\r\n"]}

package/dist/plugin.cjs.js CHANGED Viewed

@@ -1,7 +1,5 @@
 'use strict';
-Object.defineProperty(exports, '__esModule', { value: true });
 var core = require('@capacitor/core');
 /**
@@ -209,7 +207,7 @@ class BleClientClass {
         await this.queue(async () => {
             var _a;
             const key = `onEnabledChanged`;
-            await ((_a = this.eventListeners.get(key)) === null || _a === void 0 ? void 0 : _a.remove());
+            await ((_a = this.eventListeners.get(key)) === null || _a === undefined ? undefined : _a.remove());
             const listener = await BluetoothLe.addListener(key, (result) => {
                 callback(result.value);
             });
@@ -221,7 +219,7 @@ class BleClientClass {
         await this.queue(async () => {
             var _a;
             const key = `onEnabledChanged`;
-            await ((_a = this.eventListeners.get(key)) === null || _a === void 0 ? void 0 : _a.remove());
+            await ((_a = this.eventListeners.get(key)) === null || _a === undefined ? undefined : _a.remove());
             this.eventListeners.delete(key);
             await BluetoothLe.stopEnabledNotifications();
         });
@@ -265,7 +263,7 @@ class BleClientClass {
         options = this.validateRequestBleDeviceOptions(options);
         await this.queue(async () => {
             var _a;
-            await ((_a = this.scanListener) === null || _a === void 0 ? void 0 : _a.remove());
+            await ((_a = this.scanListener) === null || _a === undefined ? undefined : _a.remove());
             this.scanListener = await BluetoothLe.addListener('onScanResult', (resultInternal) => {
                 const result = Object.assign(Object.assign({}, resultInternal), { manufacturerData: this.convertObject(resultInternal.manufacturerData), serviceData: this.convertObject(resultInternal.serviceData), rawAdvertisement: resultInternal.rawAdvertisement
                         ? this.convertValue(resultInternal.rawAdvertisement)
@@ -278,7 +276,7 @@ class BleClientClass {
     async stopLEScan() {
         await this.queue(async () => {
             var _a;
-            await ((_a = this.scanListener) === null || _a === void 0 ? void 0 : _a.remove());
+            await ((_a = this.scanListener) === null || _a === undefined ? undefined : _a.remove());
             this.scanListener = null;
             await BluetoothLe.stopLEScan();
         });
@@ -313,7 +311,7 @@ class BleClientClass {
             var _a;
             if (onDisconnect) {
                 const key = `disconnected|${deviceId}`;
-                await ((_a = this.eventListeners.get(key)) === null || _a === void 0 ? void 0 : _a.remove());
+                await ((_a = this.eventListeners.get(key)) === null || _a === undefined ? undefined : _a.remove());
                 const listener = await BluetoothLe.addListener(key, () => {
                     onDisconnect(deviceId);
                 });
@@ -385,7 +383,7 @@ class BleClientClass {
         service = parseUUID(service);
         characteristic = parseUUID(characteristic);
         return this.queue(async () => {
-            if (!(value === null || value === void 0 ? void 0 : value.buffer)) {
+            if (!(value === null || value === undefined ? undefined : value.buffer)) {
                 throw new Error('Invalid data.');
             }
             let writeValue = value;
@@ -402,7 +400,7 @@ class BleClientClass {
         service = parseUUID(service);
         characteristic = parseUUID(characteristic);
         await this.queue(async () => {
-            if (!(value === null || value === void 0 ? void 0 : value.buffer)) {
+            if (!(value === null || value === undefined ? undefined : value.buffer)) {
                 throw new Error('Invalid data.');
             }
             let writeValue = value;
@@ -433,7 +431,7 @@ class BleClientClass {
         characteristic = parseUUID(characteristic);
         descriptor = parseUUID(descriptor);
         return this.queue(async () => {
-            if (!(value === null || value === void 0 ? void 0 : value.buffer)) {
+            if (!(value === null || value === undefined ? undefined : value.buffer)) {
                 throw new Error('Invalid data.');
             }
             let writeValue = value;
@@ -453,9 +451,9 @@ class BleClientClass {
         await this.queue(async () => {
             var _a;
             const key = `notification|${deviceId}|${service}|${characteristic}`;
-            await ((_a = this.eventListeners.get(key)) === null || _a === void 0 ? void 0 : _a.remove());
+            await ((_a = this.eventListeners.get(key)) === null || _a === undefined ? undefined : _a.remove());
             const listener = await BluetoothLe.addListener(key, (event) => {
-                callback(this.convertValue(event === null || event === void 0 ? void 0 : event.value));
+                callback(this.convertValue(event === null || event === undefined ? undefined : event.value));
             });
             this.eventListeners.set(key, listener);
             await BluetoothLe.startNotifications({
@@ -471,7 +469,7 @@ class BleClientClass {
         await this.queue(async () => {
             var _a;
             const key = `notification|${deviceId}|${service}|${characteristic}`;
-            await ((_a = this.eventListeners.get(key)) === null || _a === void 0 ? void 0 : _a.remove());
+            await ((_a = this.eventListeners.get(key)) === null || _a === undefined ? undefined : _a.remove());
             this.eventListeners.delete(key);
             await BluetoothLe.stopNotifications({
                 deviceId,
@@ -579,7 +577,7 @@ class BluetoothLeWeb extends core.WebPlugin {
         const filters = this.getFilters(options);
         const device = await navigator.bluetooth.requestDevice({
             filters: filters.length ? filters : undefined,
-            optionalServices: options === null || options === void 0 ? void 0 : options.optionalServices,
+            optionalServices: options === null || options === undefined ? undefined : options.optionalServices,
             acceptAllDevices: filters.length === 0,
         });
         this.deviceMap.set(device.id, device);
@@ -596,7 +594,7 @@ class BluetoothLeWeb extends core.WebPlugin {
         this.scan = await navigator.bluetooth.requestLEScan({
             filters: filters.length ? filters : undefined,
             acceptAllAdvertisements: filters.length === 0,
-            keepRepeatedDevices: options === null || options === void 0 ? void 0 : options.allowDuplicates,
+            keepRepeatedDevices: options === null || options === undefined ? undefined : options.allowDuplicates,
         });
     }
     onAdvertisementReceived(event) {
@@ -604,7 +602,7 @@ class BluetoothLeWeb extends core.WebPlugin {
         const deviceId = event.device.id;
         this.deviceMap.set(deviceId, event.device);
         const isNew = !this.discoveredDevices.has(deviceId);
-        if (isNew || ((_a = this.requestBleDeviceOptions) === null || _a === void 0 ? void 0 : _a.allowDuplicates)) {
+        if (isNew || ((_a = this.requestBleDeviceOptions) === null || _a === undefined ? undefined : _a.allowDuplicates)) {
             this.discoveredDevices.set(deviceId, true);
             const device = this.getBleDevice(event.device);
             const result = {
@@ -614,14 +612,14 @@ class BluetoothLeWeb extends core.WebPlugin {
                 txPower: event.txPower,
                 manufacturerData: mapToObject(event.manufacturerData),
                 serviceData: mapToObject(event.serviceData),
-                uuids: (_b = event.uuids) === null || _b === void 0 ? void 0 : _b.map(webUUIDToString),
+                uuids: (_b = event.uuids) === null || _b === undefined ? undefined : _b.map(webUUIDToString),
             };
             this.notifyListeners('onScanResult', result);
         }
     }
     async stopLEScan() {
         var _a;
-        if ((_a = this.scan) === null || _a === void 0 ? void 0 : _a.active) {
+        if ((_a = this.scan) === null || _a === undefined ? undefined : _a.active) {
             this.scan.stop();
         }
         this.scan = null;
@@ -642,7 +640,7 @@ class BluetoothLeWeb extends core.WebPlugin {
         const bleDevices = devices
             .filter((device) => {
             var _a;
-            return (_a = device.gatt) === null || _a === void 0 ? void 0 : _a.connected;
+            return (_a = device.gatt) === null || _a === undefined ? undefined : _a.connected;
         })
             .map((device) => {
             this.deviceMap.set(device.id, device);
@@ -670,7 +668,7 @@ class BluetoothLeWeb extends core.WebPlugin {
         catch (error) {
             // cancel pending connect call, does not work yet in chromium because of a bug:
             // https://bugs.chromium.org/p/chromium/issues/detail?id=684073
-            await ((_b = device.gatt) === null || _b === void 0 ? void 0 : _b.disconnect());
+            await ((_b = device.gatt) === null || _b === undefined ? undefined : _b.disconnect());
             if (error === timeoutError) {
                 throw new Error('Connection timeout');
             }
@@ -692,11 +690,11 @@ class BluetoothLeWeb extends core.WebPlugin {
     }
     async disconnect(options) {
         var _a;
-        (_a = this.getDeviceFromMap(options.deviceId).gatt) === null || _a === void 0 ? void 0 : _a.disconnect();
+        (_a = this.getDeviceFromMap(options.deviceId).gatt) === null || _a === undefined ? undefined : _a.disconnect();
     }
     async getServices(options) {
         var _a, _b;
-        const services = (_b = (await ((_a = this.getDeviceFromMap(options.deviceId).gatt) === null || _a === void 0 ? void 0 : _a.getPrimaryServices()))) !== null && _b !== void 0 ? _b : [];
+        const services = (_b = (await ((_a = this.getDeviceFromMap(options.deviceId).gatt) === null || _a === undefined ? undefined : _a.getPrimaryServices()))) !== null && _b !== undefined ? _b : [];
         const bleServices = [];
         for (const service of services) {
             const characteristics = await service.getCharacteristics();
@@ -738,12 +736,12 @@ class BluetoothLeWeb extends core.WebPlugin {
     }
     async getCharacteristic(options) {
         var _a;
-        const service = await ((_a = this.getDeviceFromMap(options.deviceId).gatt) === null || _a === void 0 ? void 0 : _a.getPrimaryService(options === null || options === void 0 ? void 0 : options.service));
-        return service === null || service === void 0 ? void 0 : service.getCharacteristic(options === null || options === void 0 ? void 0 : options.characteristic);
+        const service = await ((_a = this.getDeviceFromMap(options.deviceId).gatt) === null || _a === undefined ? undefined : _a.getPrimaryService(options === null || options === undefined ? undefined : options.service));
+        return service === null || service === undefined ? undefined : service.getCharacteristic(options === null || options === undefined ? undefined : options.characteristic);
     }
     async getDescriptor(options) {
         const characteristic = await this.getCharacteristic(options);
-        return characteristic === null || characteristic === void 0 ? void 0 : characteristic.getDescriptor(options === null || options === void 0 ? void 0 : options.descriptor);
+        return characteristic === null || characteristic === undefined ? undefined : characteristic.getDescriptor(options === null || options === undefined ? undefined : options.descriptor);
     }
     async discoverServices(_options) {
         throw this.unavailable('discoverServices is not available on web.');
@@ -759,7 +757,7 @@ class BluetoothLeWeb extends core.WebPlugin {
     }
     async read(options) {
         const characteristic = await this.getCharacteristic(options);
-        const value = await (characteristic === null || characteristic === void 0 ? void 0 : characteristic.readValue());
+        const value = await (characteristic === null || characteristic === undefined ? undefined : characteristic.readValue());
         return { value };
     }
     async write(options) {
@@ -771,7 +769,7 @@ class BluetoothLeWeb extends core.WebPlugin {
         else {
             dataView = options.value;
         }
-        await (characteristic === null || characteristic === void 0 ? void 0 : characteristic.writeValueWithResponse(dataView));
+        await (characteristic === null || characteristic === undefined ? undefined : characteristic.writeValueWithResponse(dataView));
     }
     async writeWithoutResponse(options) {
         const characteristic = await this.getCharacteristic(options);
@@ -782,11 +780,11 @@ class BluetoothLeWeb extends core.WebPlugin {
         else {
             dataView = options.value;
         }
-        await (characteristic === null || characteristic === void 0 ? void 0 : characteristic.writeValueWithoutResponse(dataView));
+        await (characteristic === null || characteristic === undefined ? undefined : characteristic.writeValueWithoutResponse(dataView));
     }
     async readDescriptor(options) {
         const descriptor = await this.getDescriptor(options);
-        const value = await (descriptor === null || descriptor === void 0 ? void 0 : descriptor.readValue());
+        const value = await (descriptor === null || descriptor === undefined ? undefined : descriptor.readValue());
         return { value };
     }
     async writeDescriptor(options) {
@@ -798,43 +796,43 @@ class BluetoothLeWeb extends core.WebPlugin {
         else {
             dataView = options.value;
         }
-        await (descriptor === null || descriptor === void 0 ? void 0 : descriptor.writeValue(dataView));
+        await (descriptor === null || descriptor === undefined ? undefined : descriptor.writeValue(dataView));
     }
     async startNotifications(options) {
         const characteristic = await this.getCharacteristic(options);
-        characteristic === null || characteristic === void 0 ? void 0 : characteristic.removeEventListener('characteristicvaluechanged', this.onCharacteristicValueChangedCallback);
-        characteristic === null || characteristic === void 0 ? void 0 : characteristic.addEventListener('characteristicvaluechanged', this.onCharacteristicValueChangedCallback);
-        await (characteristic === null || characteristic === void 0 ? void 0 : characteristic.startNotifications());
+        characteristic === null || characteristic === undefined ? undefined : characteristic.removeEventListener('characteristicvaluechanged', this.onCharacteristicValueChangedCallback);
+        characteristic === null || characteristic === undefined ? undefined : characteristic.addEventListener('characteristicvaluechanged', this.onCharacteristicValueChangedCallback);
+        await (characteristic === null || characteristic === undefined ? undefined : characteristic.startNotifications());
     }
     onCharacteristicValueChanged(event) {
         var _a, _b;
         const characteristic = event.target;
-        const key = `notification|${(_a = characteristic.service) === null || _a === void 0 ? void 0 : _a.device.id}|${(_b = characteristic.service) === null || _b === void 0 ? void 0 : _b.uuid}|${characteristic.uuid}`;
+        const key = `notification|${(_a = characteristic.service) === null || _a === undefined ? undefined : _a.device.id}|${(_b = characteristic.service) === null || _b === undefined ? undefined : _b.uuid}|${characteristic.uuid}`;
         this.notifyListeners(key, {
             value: characteristic.value,
         });
     }
     async stopNotifications(options) {
         const characteristic = await this.getCharacteristic(options);
-        await (characteristic === null || characteristic === void 0 ? void 0 : characteristic.stopNotifications());
+        await (characteristic === null || characteristic === undefined ? undefined : characteristic.stopNotifications());
     }
     getFilters(options) {
         var _a, _b;
         const filters = [];
-        for (const service of (_a = options === null || options === void 0 ? void 0 : options.services) !== null && _a !== void 0 ? _a : []) {
+        for (const service of (_a = options === null || options === undefined ? undefined : options.services) !== null && _a !== undefined ? _a : []) {
             filters.push({
                 services: [service],
-                name: options === null || options === void 0 ? void 0 : options.name,
-                namePrefix: options === null || options === void 0 ? void 0 : options.namePrefix,
+                name: options === null || options === undefined ? undefined : options.name,
+                namePrefix: options === null || options === undefined ? undefined : options.namePrefix,
             });
         }
-        if (((options === null || options === void 0 ? void 0 : options.name) || (options === null || options === void 0 ? void 0 : options.namePrefix)) && filters.length === 0) {
+        if (((options === null || options === undefined ? undefined : options.name) || (options === null || options === undefined ? undefined : options.namePrefix)) && filters.length === 0) {
             filters.push({
                 name: options.name,
                 namePrefix: options.namePrefix,
             });
         }
-        for (const manufacturerData of (_b = options === null || options === void 0 ? void 0 : options.manufacturerData) !== null && _b !== void 0 ? _b : []) {
+        for (const manufacturerData of (_b = options === null || options === undefined ? undefined : options.manufacturerData) !== null && _b !== undefined ? _b : []) {
             filters.push({
                 manufacturerData: [manufacturerData],
             });
@@ -853,7 +851,7 @@ class BluetoothLeWeb extends core.WebPlugin {
         const bleDevice = {
             deviceId: device.id,
             // use undefined instead of null if name is not available
-            name: (_a = device.name) !== null && _a !== void 0 ? _a : undefined,
+            name: (_a = device.name) !== null && _a !== undefined ? _a : undefined,
         };
         return bleDevice;
     }