@capacitor-community/bluetooth-le 7.1.1 → 7.3.0

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 (29) hide show
  1. package/README.md +69 -161
  2. package/android/src/main/java/com/capacitorjs/community/plugins/bluetoothle/BluetoothLe.kt +47 -21
  3. package/android/src/main/java/com/capacitorjs/community/plugins/bluetoothle/Device.kt +87 -36
  4. package/dist/docs.json +957 -890
  5. package/dist/esm/bleClient.d.ts +3 -2
  6. package/dist/esm/bleClient.js +18 -6
  7. package/dist/esm/bleClient.js.map +1 -1
  8. package/dist/esm/config.js.map +1 -1
  9. package/dist/esm/conversion.d.ts +12 -0
  10. package/dist/esm/conversion.js +33 -0
  11. package/dist/esm/conversion.js.map +1 -1
  12. package/dist/esm/definitions.d.ts +42 -3
  13. package/dist/esm/definitions.js.map +1 -1
  14. package/dist/esm/index.js.map +1 -1
  15. package/dist/esm/plugin.js.map +1 -1
  16. package/dist/esm/queue.js.map +1 -1
  17. package/dist/esm/timeout.js.map +1 -1
  18. package/dist/esm/validators.js.map +1 -1
  19. package/dist/esm/web.d.ts +1 -0
  20. package/dist/esm/web.js +66 -3
  21. package/dist/esm/web.js.map +1 -1
  22. package/dist/plugin.cjs.js +118 -8
  23. package/dist/plugin.cjs.js.map +1 -1
  24. package/dist/plugin.js +118 -8
  25. package/dist/plugin.js.map +1 -1
  26. package/ios/Plugin/DeviceListView.swift +121 -0
  27. package/ios/Plugin/DeviceManager.swift +114 -13
  28. package/ios/Plugin/Plugin.swift +61 -6
  29. package/package.json +13 -3
package/dist/esm/bleClient.d.ts CHANGED
@@ -219,8 +219,9 @@ export interface BleClientInterface {
219
219
  * @param service UUID of the service (see [UUID format](#uuid-format))
220
220
  * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))
221
221
  * @param callback Callback function to use when the value of the characteristic changes
222
+ * @param options Options for plugin call. Timeout not supported on **web**.
222
223
  */
223
- startNotifications(deviceId: string, service: string, characteristic: string, callback: (value: DataView) => void): Promise<void>;
224
+ startNotifications(deviceId: string, service: string, characteristic: string, callback: (value: DataView) => void, options?: TimeoutOptions): Promise<void>;
224
225
  /**
225
226
  * Stop listening to the changes of the value of a characteristic. For an example, see [usage](#usage).
226
227
  * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))
@@ -267,7 +268,7 @@ declare class BleClientClass implements BleClientInterface {
267
268
  writeWithoutResponse(deviceId: string, service: string, characteristic: string, value: DataView, options?: TimeoutOptions): Promise<void>;
268
269
  readDescriptor(deviceId: string, service: string, characteristic: string, descriptor: string, options?: TimeoutOptions): Promise<DataView>;
269
270
  writeDescriptor(deviceId: string, service: string, characteristic: string, descriptor: string, value: DataView, options?: TimeoutOptions): Promise<void>;
270
- startNotifications(deviceId: string, service: string, characteristic: string, callback: (value: DataView) => void): Promise<void>;
271
+ startNotifications(deviceId: string, service: string, characteristic: string, callback: (value: DataView) => void, options?: TimeoutOptions): Promise<void>;
271
272
  stopNotifications(deviceId: string, service: string, characteristic: string): Promise<void>;
272
273
  private validateRequestBleDeviceOptions;
273
274
  private convertValue;
package/dist/esm/bleClient.js CHANGED
@@ -1,5 +1,5 @@
1
1
  import { Capacitor } from '@capacitor/core';
2
- import { dataViewToHexString, hexStringToDataView } from './conversion';
2
+ import { dataViewToHexString, hexStringToDataView, toUint8Array, toHexString } from './conversion';
3
3
  import { BluetoothLe } from './plugin';
4
4
  import { getQueue } from './queue';
5
5
  import { parseUUID } from './validators';
@@ -284,7 +284,7 @@ class BleClientClass {
284
284
  descriptor, value: writeValue }, options));
285
285
  });
286
286
  }
287
- async startNotifications(deviceId, service, characteristic, callback) {
287
+ async startNotifications(deviceId, service, characteristic, callback, options) {
288
288
  service = parseUUID(service);
289
289
  characteristic = parseUUID(characteristic);
290
290
  await this.queue(async () => {
@@ -295,11 +295,9 @@ class BleClientClass {
295
295
  callback(this.convertValue(event === null || event === void 0 ? void 0 : event.value));
296
296
  });
297
297
  this.eventListeners.set(key, listener);
298
- await BluetoothLe.startNotifications({
299
- deviceId,
298
+ await BluetoothLe.startNotifications(Object.assign({ deviceId,
300
299
  service,
301
- characteristic,
302
- });
300
+ characteristic }, options));
303
301
  });
304
302
  }
305
303
  async stopNotifications(deviceId, service, characteristic) {
@@ -324,6 +322,20 @@ class BleClientClass {
324
322
  if (options.optionalServices) {
325
323
  options.optionalServices = options.optionalServices.map(parseUUID);
326
324
  }
325
+ if (options.serviceData && Capacitor.getPlatform() !== 'web') {
326
+ // Native platforms: convert to hex strings
327
+ options.serviceData = options.serviceData.map((filter) => (Object.assign(Object.assign({}, filter), { serviceUuid: parseUUID(filter.serviceUuid), dataPrefix: toHexString(filter.dataPrefix), mask: toHexString(filter.mask) })));
328
+ }
329
+ if (options.manufacturerData) {
330
+ if (Capacitor.getPlatform() !== 'web') {
331
+ // Native platforms: convert to hex strings
332
+ options.manufacturerData = options.manufacturerData.map((filter) => (Object.assign(Object.assign({}, filter), { dataPrefix: toHexString(filter.dataPrefix), mask: toHexString(filter.mask) })));
333
+ }
334
+ else {
335
+ // Web platform: convert to Uint8Array for Web Bluetooth API
336
+ options.manufacturerData = options.manufacturerData.map((filter) => (Object.assign(Object.assign({}, filter), { dataPrefix: toUint8Array(filter.dataPrefix), mask: toUint8Array(filter.mask) })));
337
+ }
338
+ }
327
339
  return options;
328
340
  }
329
341
  convertValue(value) {
package/dist/esm/bleClient.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"bleClient.js","sourceRoot":"","sources":["../../src/bleClient.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\r\nimport { Capacitor } from '@capacitor/core';\r\n\r\nimport type { DisplayStrings } from './config';\r\nimport { dataViewToHexString, hexStringToDataView } from './conversion';\r\nimport type {\r\n BleDevice,\r\n BleService,\r\n ConnectionPriority,\r\n Data,\r\n InitializeOptions,\r\n ReadResult,\r\n RequestBleDeviceOptions,\r\n ScanResult,\r\n ScanResultInternal,\r\n TimeoutOptions,\r\n} from './definitions';\r\nimport { BluetoothLe } from './plugin';\r\nimport { getQueue } from './queue';\r\nimport { parseUUID } from './validators';\r\n\r\nexport interface BleClientInterface {\r\n /**\r\n * Initialize Bluetooth Low Energy (BLE). If it fails, BLE might be unavailable on this device.\r\n * On **Android** it will ask for the location permission. On **iOS** it will ask for the Bluetooth permission.\r\n * For an example, see [usage](#usage).\r\n */\r\n initialize(options?: InitializeOptions): Promise<void>;\r\n\r\n /**\r\n * Reports whether Bluetooth is enabled on this device.\r\n * Always returns `true` on **web**.\r\n */\r\n isEnabled(): Promise<boolean>;\r\n\r\n /**\r\n * Request enabling Bluetooth. Show a system activity that allows the user to turn on Bluetooth. See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#ACTION_REQUEST_ENABLE\r\n * Only available on **Android**.*/\r\n requestEnable(): Promise<void>;\r\n\r\n /**\r\n * Enable Bluetooth.\r\n * Only available on **Android**.\r\n * **Deprecated** Will fail on Android SDK >= 33. Use `requestEnable` instead. See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#enable()\r\n * @deprecated Will fail on Android SDK >= 33. Use `requestEnable` instead. See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#enable()\r\n */\r\n enable(): Promise<void>;\r\n\r\n /**\r\n * Disable Bluetooth.\r\n * Only available on **Android**.\r\n * **Deprecated** Will fail on Android SDK >= 33. See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#disable()\r\n * @deprecated Will fail on Android SDK >= 33. See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#disable()\r\n */\r\n disable(): Promise<void>;\r\n\r\n /**\r\n * Register a callback function that will be invoked when Bluetooth is enabled (true) or disabled (false) on this device.\r\n * Not available on **web** (the callback will never be invoked).\r\n * @param callback Callback function to use when the Bluetooth state changes.\r\n */\r\n startEnabledNotifications(callback: (value: boolean) => void): Promise<void>;\r\n\r\n /**\r\n * Stop the enabled notifications registered with `startEnabledNotifications`.\r\n */\r\n stopEnabledNotifications(): Promise<void>;\r\n\r\n /**\r\n * Reports whether Location Services are enabled on this device.\r\n * Only available on **Android**.\r\n */\r\n isLocationEnabled(): Promise<boolean>;\r\n\r\n /**\r\n * Open Location settings.\r\n * Only available on **Android**.\r\n */\r\n openLocationSettings(): Promise<void>;\r\n\r\n /**\r\n * Open Bluetooth settings.\r\n * Only available on **Android**.\r\n */\r\n openBluetoothSettings(): Promise<void>;\r\n\r\n /**\r\n * Open App settings.\r\n * Not available on **web**.\r\n * On **iOS** when a user declines the request to use Bluetooth on the first call of `initialize`, it is not possible\r\n * to request for Bluetooth again from within the app. In this case Bluetooth has to be enabled in the app settings\r\n * for the app to be able use it.\r\n */\r\n openAppSettings(): Promise<void>;\r\n\r\n /**\r\n * Set the strings that are displayed in the `requestDevice` dialog.\r\n * @param displayStrings\r\n */\r\n setDisplayStrings(displayStrings: DisplayStrings): Promise<void>;\r\n\r\n /**\r\n * Request a peripheral BLE device to interact with. This will scan for available devices according to the filters in the options and show a dialog to pick a device.\r\n * For an example, see [usage](#usage).\r\n * @param options Device filters, see [RequestBleDeviceOptions](#RequestBleDeviceOptions)\r\n */\r\n requestDevice(options?: RequestBleDeviceOptions): Promise<BleDevice>;\r\n\r\n /**\r\n * Start scanning for BLE devices to interact with according to the filters in the options. The callback will be invoked on each device that is found.\r\n * Scanning will continue until `stopLEScan` is called. For an example, see [usage](#usage).\r\n * **Note**: Use with care on **web** platform, the required API is still behind a flag in most browsers.\r\n * @param options\r\n * @param callback\r\n */\r\n requestLEScan(options: RequestBleDeviceOptions, callback: (result: ScanResult) => void): Promise<void>;\r\n\r\n /**\r\n * Stop scanning for BLE devices. For an example, see [usage](#usage).\r\n */\r\n stopLEScan(): Promise<void>;\r\n\r\n /**\r\n * On iOS and web, if you want to connect to a previously connected device without scanning first, you can use `getDevice`.\r\n * Uses [retrievePeripherals](https://developer.apple.com/documentation/corebluetooth/cbcentralmanager/1519127-retrieveperipherals) on iOS and\r\n * [getDevices](https://developer.mozilla.org/en-US/docs/Web/API/Bluetooth/getDevices) on web.\r\n * On Android, you can directly connect to the device with the deviceId.\r\n * @param deviceIds List of device IDs, e.g. saved from a previous app run.\r\n */\r\n getDevices(deviceIds: string[]): Promise<BleDevice[]>;\r\n\r\n /**\r\n * Get a list of currently bonded devices.\r\n * Only available on **Android**.\r\n * Uses [getBondedDevices](https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#getBondedDevices()) on Android\r\n */\r\n getBondedDevices(): Promise<BleDevice[]>;\r\n\r\n /**\r\n * Get a list of currently connected devices.\r\n * Uses [retrieveConnectedPeripherals](https://developer.apple.com/documentation/corebluetooth/cbcentralmanager/1518924-retrieveconnectedperipherals) on iOS,\r\n * [getConnectedDevices](https://developer.android.com/reference/android/bluetooth/BluetoothManager#getConnectedDevices(int)) on Android\r\n * and [getDevices](https://developer.mozilla.org/en-US/docs/Web/API/Bluetooth/getDevices) on web.\r\n * @param services List of services to filter the devices by. If no service is specified, no devices will be returned. Only applies to iOS.\r\n */\r\n getConnectedDevices(services: string[]): Promise<BleDevice[]>;\r\n\r\n /**\r\n * Connect to a peripheral BLE device. For an example, see [usage](#usage).\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n * @param onDisconnect Optional disconnect callback function that will be used when the device disconnects\r\n * @param options Options for plugin call\r\n */\r\n connect(deviceId: string, onDisconnect?: (deviceId: string) => void, options?: TimeoutOptions): Promise<void>;\r\n\r\n /**\r\n * Create a bond with a peripheral BLE device.\r\n * Only available on **Android**. On iOS bonding is handled by the OS.\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n * @param options Options for plugin call\r\n */\r\n createBond(deviceId: string, options?: TimeoutOptions): Promise<void>;\r\n\r\n /**\r\n * Report whether a peripheral BLE device is bonded.\r\n * Only available on **Android**. On iOS bonding is handled by the OS.\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n */\r\n isBonded(deviceId: string): Promise<boolean>;\r\n\r\n /**\r\n * Disconnect from a peripheral BLE device. For an example, see [usage](#usage).\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n */\r\n disconnect(deviceId: string): Promise<void>;\r\n\r\n /**\r\n * Get services, characteristics and descriptors of a device.\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n */\r\n getServices(deviceId: string): Promise<BleService[]>;\r\n\r\n /**\r\n * Discover services, characteristics and descriptors of a device.\r\n * You only need this method if your peripheral device changes its services and characteristics at runtime.\r\n * If the discovery was successful, the remote services can be retrieved using the getServices function.\r\n * Not available on **web**.\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n */\r\n discoverServices(deviceId: string): Promise<void>;\r\n\r\n /**\r\n * Get the MTU of a connected device. Note that the maximum write value length is 3 bytes less than the MTU.\r\n * Not available on **web**.\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n */\r\n getMtu(deviceId: string): Promise<number>;\r\n\r\n /**\r\n * Request a connection parameter update.\r\n * Only available on **Android**. https://developer.android.com/reference/android/bluetooth/BluetoothGatt#requestConnectionPriority(int)\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n * @param connectionPriority Request a specific connection priority. See [ConnectionPriority](#connectionpriority)\r\n */\r\n requestConnectionPriority(deviceId: string, connectionPriority: ConnectionPriority): Promise<void>;\r\n\r\n /**\r\n * Read the RSSI value of a connected device.\r\n * Not available on **web**.\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n */\r\n readRssi(deviceId: string): Promise<number>;\r\n\r\n /**\r\n * Read the value of a characteristic. For an example, see [usage](#usage).\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n * @param service UUID of the service (see [UUID format](#uuid-format))\r\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\r\n * @param options Options for plugin call\r\n */\r\n read(deviceId: string, service: string, characteristic: string, options?: TimeoutOptions): Promise<DataView>;\r\n\r\n /**\r\n * Write a value to a characteristic. For an example, see [usage](#usage).\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n * @param service UUID of the service (see [UUID format](#uuid-format))\r\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\r\n * @param value The value to write as a DataView. To create a DataView from an array of numbers, there is a helper function, e.g. numbersToDataView([1, 0])\r\n * @param options Options for plugin call\r\n */\r\n write(\r\n deviceId: string,\r\n service: string,\r\n characteristic: string,\r\n value: DataView,\r\n options?: TimeoutOptions,\r\n ): Promise<void>;\r\n\r\n /**\r\n * Write a value to a characteristic without waiting for a response.\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n * @param service UUID of the service (see [UUID format](#uuid-format))\r\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\r\n * @param value The value to write as a DataView. To create a DataView from an array of numbers, there is a helper function, e.g. numbersToDataView([1, 0])\r\n * @param options Options for plugin call\r\n */\r\n writeWithoutResponse(\r\n deviceId: string,\r\n service: string,\r\n characteristic: string,\r\n value: DataView,\r\n options?: TimeoutOptions,\r\n ): Promise<void>;\r\n\r\n /**\r\n * Read the value of a descriptor.\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n * @param service UUID of the service (see [UUID format](#uuid-format))\r\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\r\n * @param descriptor UUID of the descriptor (see [UUID format](#uuid-format))\r\n * @param options Options for plugin call\r\n */\r\n readDescriptor(\r\n deviceId: string,\r\n service: string,\r\n characteristic: string,\r\n descriptor: string,\r\n options?: TimeoutOptions,\r\n ): Promise<DataView>;\r\n\r\n /**\r\n * Write a value to a descriptor.\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n * @param service UUID of the service (see [UUID format](#uuid-format))\r\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\r\n * @param descriptor UUID of the descriptor (see [UUID format](#uuid-format))\r\n * @param value The value to write as a DataView. To create a DataView from an array of numbers, there is a helper function, e.g. numbersToDataView([1, 0])\r\n * @param options Options for plugin call\r\n */\r\n writeDescriptor(\r\n deviceId: string,\r\n service: string,\r\n characteristic: string,\r\n descriptor: string,\r\n value: DataView,\r\n options?: TimeoutOptions,\r\n ): Promise<void>;\r\n\r\n /**\r\n * Start listening to changes of the value of a characteristic.\r\n * Note that you should only start the notifications once per characteristic in your app and share the data and\r\n * not call `startNotifications` in every component that needs the data.\r\n * For an example, see [usage](#usage).\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n * @param service UUID of the service (see [UUID format](#uuid-format))\r\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\r\n * @param callback Callback function to use when the value of the characteristic changes\r\n */\r\n startNotifications(\r\n deviceId: string,\r\n service: string,\r\n characteristic: string,\r\n callback: (value: DataView) => void,\r\n ): Promise<void>;\r\n\r\n /**\r\n * Stop listening to the changes of the value of a characteristic. For an example, see [usage](#usage).\r\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\r\n * @param service UUID of the service (see [UUID format](#uuid-format))\r\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\r\n */\r\n stopNotifications(deviceId: string, service: string, characteristic: string): Promise<void>;\r\n}\r\n\r\nclass BleClientClass implements BleClientInterface {\r\n private scanListener: PluginListenerHandle | null = null;\r\n private eventListeners = new Map<string, PluginListenerHandle>();\r\n private queue = getQueue(true);\r\n\r\n enableQueue() {\r\n this.queue = getQueue(true);\r\n }\r\n\r\n disableQueue() {\r\n this.queue = getQueue(false);\r\n }\r\n\r\n async initialize(options?: InitializeOptions): Promise<void> {\r\n await this.queue(async () => {\r\n await BluetoothLe.initialize(options);\r\n });\r\n }\r\n\r\n async isEnabled(): Promise<boolean> {\r\n const enabled = await this.queue(async () => {\r\n const result = await BluetoothLe.isEnabled();\r\n return result.value;\r\n });\r\n return enabled;\r\n }\r\n\r\n async requestEnable(): Promise<void> {\r\n await this.queue(async () => {\r\n await BluetoothLe.requestEnable();\r\n });\r\n }\r\n\r\n async enable(): Promise<void> {\r\n await this.queue(async () => {\r\n await BluetoothLe.enable();\r\n });\r\n }\r\n\r\n async disable(): Promise<void> {\r\n await this.queue(async () => {\r\n await BluetoothLe.disable();\r\n });\r\n }\r\n\r\n async startEnabledNotifications(callback: (value: boolean) => void): Promise<void> {\r\n await this.queue(async () => {\r\n const key = `onEnabledChanged`;\r\n await this.eventListeners.get(key)?.remove();\r\n const listener = await BluetoothLe.addListener(key, (result) => {\r\n callback(result.value);\r\n });\r\n this.eventListeners.set(key, listener);\r\n await BluetoothLe.startEnabledNotifications();\r\n });\r\n }\r\n\r\n async stopEnabledNotifications(): Promise<void> {\r\n await this.queue(async () => {\r\n const key = `onEnabledChanged`;\r\n await this.eventListeners.get(key)?.remove();\r\n this.eventListeners.delete(key);\r\n await BluetoothLe.stopEnabledNotifications();\r\n });\r\n }\r\n\r\n async isLocationEnabled(): Promise<boolean> {\r\n const enabled = await this.queue(async () => {\r\n const result = await BluetoothLe.isLocationEnabled();\r\n return result.value;\r\n });\r\n return enabled;\r\n }\r\n\r\n async openLocationSettings(): Promise<void> {\r\n await this.queue(async () => {\r\n await BluetoothLe.openLocationSettings();\r\n });\r\n }\r\n\r\n async openBluetoothSettings(): Promise<void> {\r\n await this.queue(async () => {\r\n await BluetoothLe.openBluetoothSettings();\r\n });\r\n }\r\n\r\n async openAppSettings(): Promise<void> {\r\n await this.queue(async () => {\r\n await BluetoothLe.openAppSettings();\r\n });\r\n }\r\n\r\n async setDisplayStrings(displayStrings: DisplayStrings): Promise<void> {\r\n await this.queue(async () => {\r\n await BluetoothLe.setDisplayStrings(displayStrings);\r\n });\r\n }\r\n\r\n async requestDevice(options?: RequestBleDeviceOptions): Promise<BleDevice> {\r\n options = options ? this.validateRequestBleDeviceOptions(options) : undefined;\r\n const result = await this.queue(async () => {\r\n const device = await BluetoothLe.requestDevice(options);\r\n return device;\r\n });\r\n return result;\r\n }\r\n\r\n async requestLEScan(options: RequestBleDeviceOptions, callback: (result: ScanResult) => void): Promise<void> {\r\n options = this.validateRequestBleDeviceOptions(options);\r\n await this.queue(async () => {\r\n await this.scanListener?.remove();\r\n this.scanListener = await BluetoothLe.addListener('onScanResult', (resultInternal: ScanResultInternal) => {\r\n const result: ScanResult = {\r\n ...resultInternal,\r\n manufacturerData: this.convertObject(resultInternal.manufacturerData),\r\n serviceData: this.convertObject(resultInternal.serviceData),\r\n rawAdvertisement: resultInternal.rawAdvertisement\r\n ? this.convertValue(resultInternal.rawAdvertisement)\r\n : undefined,\r\n };\r\n callback(result);\r\n });\r\n await BluetoothLe.requestLEScan(options);\r\n });\r\n }\r\n\r\n async stopLEScan(): Promise<void> {\r\n await this.queue(async () => {\r\n await this.scanListener?.remove();\r\n this.scanListener = null;\r\n await BluetoothLe.stopLEScan();\r\n });\r\n }\r\n\r\n async getDevices(deviceIds: string[]): Promise<BleDevice[]> {\r\n if (!Array.isArray(deviceIds)) {\r\n throw new Error('deviceIds must be an array');\r\n }\r\n return this.queue(async () => {\r\n const result = await BluetoothLe.getDevices({ deviceIds });\r\n return result.devices;\r\n });\r\n }\r\n\r\n async getConnectedDevices(services: string[]): Promise<BleDevice[]> {\r\n if (!Array.isArray(services)) {\r\n throw new Error('services must be an array');\r\n }\r\n services = services.map(parseUUID);\r\n return this.queue(async () => {\r\n const result = await BluetoothLe.getConnectedDevices({ services });\r\n return result.devices;\r\n });\r\n }\r\n\r\n async getBondedDevices(): Promise<BleDevice[]> {\r\n return this.queue(async () => {\r\n const result = await BluetoothLe.getBondedDevices();\r\n return result.devices;\r\n });\r\n }\r\n\r\n async connect(deviceId: string, onDisconnect?: (deviceId: string) => void, options?: TimeoutOptions): Promise<void> {\r\n await this.queue(async () => {\r\n if (onDisconnect) {\r\n const key = `disconnected|${deviceId}`;\r\n await this.eventListeners.get(key)?.remove();\r\n const listener = await BluetoothLe.addListener(key, () => {\r\n onDisconnect(deviceId);\r\n });\r\n this.eventListeners.set(key, listener);\r\n }\r\n await BluetoothLe.connect({ deviceId, ...options });\r\n });\r\n }\r\n\r\n async createBond(deviceId: string, options?: TimeoutOptions): Promise<void> {\r\n await this.queue(async () => {\r\n await BluetoothLe.createBond({ deviceId, ...options });\r\n });\r\n }\r\n\r\n async isBonded(deviceId: string): Promise<boolean> {\r\n const isBonded = await this.queue(async () => {\r\n const result = await BluetoothLe.isBonded({ deviceId });\r\n return result.value;\r\n });\r\n return isBonded;\r\n }\r\n\r\n async disconnect(deviceId: string): Promise<void> {\r\n await this.queue(async () => {\r\n await BluetoothLe.disconnect({ deviceId });\r\n });\r\n }\r\n\r\n async getServices(deviceId: string): Promise<BleService[]> {\r\n const services = await this.queue(async () => {\r\n const result = await BluetoothLe.getServices({ deviceId });\r\n return result.services;\r\n });\r\n return services;\r\n }\r\n\r\n async discoverServices(deviceId: string): Promise<void> {\r\n await this.queue(async () => {\r\n await BluetoothLe.discoverServices({ deviceId });\r\n });\r\n }\r\n\r\n async getMtu(deviceId: string): Promise<number> {\r\n const value = await this.queue(async () => {\r\n const result = await BluetoothLe.getMtu({ deviceId });\r\n return result.value;\r\n });\r\n return value;\r\n }\r\n\r\n async requestConnectionPriority(deviceId: string, connectionPriority: ConnectionPriority): Promise<void> {\r\n await this.queue(async () => {\r\n await BluetoothLe.requestConnectionPriority({ deviceId, connectionPriority });\r\n });\r\n }\r\n\r\n async readRssi(deviceId: string): Promise<number> {\r\n const value = await this.queue(async () => {\r\n const result = await BluetoothLe.readRssi({ deviceId });\r\n return parseFloat(result.value);\r\n });\r\n return value;\r\n }\r\n\r\n async read(deviceId: string, service: string, characteristic: string, options?: TimeoutOptions): Promise<DataView> {\r\n service = parseUUID(service);\r\n characteristic = parseUUID(characteristic);\r\n const value = await this.queue(async () => {\r\n const result = await BluetoothLe.read({\r\n deviceId,\r\n service,\r\n characteristic,\r\n ...options,\r\n });\r\n return this.convertValue(result.value);\r\n });\r\n return value;\r\n }\r\n\r\n async write(\r\n deviceId: string,\r\n service: string,\r\n characteristic: string,\r\n value: DataView,\r\n options?: TimeoutOptions,\r\n ): Promise<void> {\r\n service = parseUUID(service);\r\n characteristic = parseUUID(characteristic);\r\n return this.queue(async () => {\r\n if (!value?.buffer) {\r\n throw new Error('Invalid data.');\r\n }\r\n let writeValue: DataView | string = value;\r\n if (Capacitor.getPlatform() !== 'web') {\r\n // on native we can only write strings\r\n writeValue = dataViewToHexString(value);\r\n }\r\n await BluetoothLe.write({\r\n deviceId,\r\n service,\r\n characteristic,\r\n value: writeValue,\r\n ...options,\r\n });\r\n });\r\n }\r\n\r\n async writeWithoutResponse(\r\n deviceId: string,\r\n service: string,\r\n characteristic: string,\r\n value: DataView,\r\n options?: TimeoutOptions,\r\n ): Promise<void> {\r\n service = parseUUID(service);\r\n characteristic = parseUUID(characteristic);\r\n await this.queue(async () => {\r\n if (!value?.buffer) {\r\n throw new Error('Invalid data.');\r\n }\r\n let writeValue: DataView | string = value;\r\n if (Capacitor.getPlatform() !== 'web') {\r\n // on native we can only write strings\r\n writeValue = dataViewToHexString(value);\r\n }\r\n await BluetoothLe.writeWithoutResponse({\r\n deviceId,\r\n service,\r\n characteristic,\r\n value: writeValue,\r\n ...options,\r\n });\r\n });\r\n }\r\n\r\n async readDescriptor(\r\n deviceId: string,\r\n service: string,\r\n characteristic: string,\r\n descriptor: string,\r\n options?: TimeoutOptions,\r\n ): Promise<DataView> {\r\n service = parseUUID(service);\r\n characteristic = parseUUID(characteristic);\r\n descriptor = parseUUID(descriptor);\r\n const value = await this.queue(async () => {\r\n const result = await BluetoothLe.readDescriptor({\r\n deviceId,\r\n service,\r\n characteristic,\r\n descriptor,\r\n ...options,\r\n });\r\n return this.convertValue(result.value);\r\n });\r\n return value;\r\n }\r\n\r\n async writeDescriptor(\r\n deviceId: string,\r\n service: string,\r\n characteristic: string,\r\n descriptor: string,\r\n value: DataView,\r\n options?: TimeoutOptions,\r\n ): Promise<void> {\r\n service = parseUUID(service);\r\n characteristic = parseUUID(characteristic);\r\n descriptor = parseUUID(descriptor);\r\n return this.queue(async () => {\r\n if (!value?.buffer) {\r\n throw new Error('Invalid data.');\r\n }\r\n let writeValue: DataView | string = value;\r\n if (Capacitor.getPlatform() !== 'web') {\r\n // on native we can only write strings\r\n writeValue = dataViewToHexString(value);\r\n }\r\n await BluetoothLe.writeDescriptor({\r\n deviceId,\r\n service,\r\n characteristic,\r\n descriptor,\r\n value: writeValue,\r\n ...options,\r\n });\r\n });\r\n }\r\n\r\n async startNotifications(\r\n deviceId: string,\r\n service: string,\r\n characteristic: string,\r\n callback: (value: DataView) => void,\r\n ): Promise<void> {\r\n service = parseUUID(service);\r\n characteristic = parseUUID(characteristic);\r\n await this.queue(async () => {\r\n const key = `notification|${deviceId}|${service}|${characteristic}`;\r\n await this.eventListeners.get(key)?.remove();\r\n const listener = await BluetoothLe.addListener(key, (event: ReadResult) => {\r\n callback(this.convertValue(event?.value));\r\n });\r\n this.eventListeners.set(key, listener);\r\n await BluetoothLe.startNotifications({\r\n deviceId,\r\n service,\r\n characteristic,\r\n });\r\n });\r\n }\r\n\r\n async stopNotifications(deviceId: string, service: string, characteristic: string): Promise<void> {\r\n service = parseUUID(service);\r\n characteristic = parseUUID(characteristic);\r\n await this.queue(async () => {\r\n const key = `notification|${deviceId}|${service}|${characteristic}`;\r\n await this.eventListeners.get(key)?.remove();\r\n this.eventListeners.delete(key);\r\n await BluetoothLe.stopNotifications({\r\n deviceId,\r\n service,\r\n characteristic,\r\n });\r\n });\r\n }\r\n\r\n private validateRequestBleDeviceOptions(options: RequestBleDeviceOptions): RequestBleDeviceOptions {\r\n if (options.services) {\r\n options.services = options.services.map(parseUUID);\r\n }\r\n if (options.optionalServices) {\r\n options.optionalServices = options.optionalServices.map(parseUUID);\r\n }\r\n return options;\r\n }\r\n\r\n private convertValue(value?: Data): DataView {\r\n if (typeof value === 'string') {\r\n return hexStringToDataView(value);\r\n } else if (value === undefined) {\r\n return new DataView(new ArrayBuffer(0));\r\n }\r\n return value;\r\n }\r\n\r\n private convertObject(obj?: { [key: string]: Data }): { [key: string]: DataView } | undefined {\r\n if (obj === undefined) {\r\n return undefined;\r\n }\r\n const result: { [key: string]: DataView } = {};\r\n for (const key of Object.keys(obj)) {\r\n result[key] = this.convertValue(obj[key]);\r\n }\r\n return result;\r\n }\r\n}\r\n\r\nexport const BleClient = new BleClientClass();\r\n"]}
1
+ {"version":3,"file":"bleClient.js","sourceRoot":"","sources":["../../src/bleClient.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\nimport { Capacitor } from '@capacitor/core';\n\nimport type { DisplayStrings } from './config';\nimport { dataViewToHexString, hexStringToDataView, toUint8Array, toHexString } from './conversion';\nimport type {\n BleDevice,\n BleService,\n ConnectionPriority,\n Data,\n InitializeOptions,\n ReadResult,\n RequestBleDeviceOptions,\n ScanResult,\n ScanResultInternal,\n TimeoutOptions,\n} from './definitions';\nimport { BluetoothLe } from './plugin';\nimport { getQueue } from './queue';\nimport { parseUUID } from './validators';\n\nexport interface BleClientInterface {\n /**\n * Initialize Bluetooth Low Energy (BLE). If it fails, BLE might be unavailable on this device.\n * On **Android** it will ask for the location permission. On **iOS** it will ask for the Bluetooth permission.\n * For an example, see [usage](#usage).\n */\n initialize(options?: InitializeOptions): Promise<void>;\n\n /**\n * Reports whether Bluetooth is enabled on this device.\n * Always returns `true` on **web**.\n */\n isEnabled(): Promise<boolean>;\n\n /**\n * Request enabling Bluetooth. Show a system activity that allows the user to turn on Bluetooth. See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#ACTION_REQUEST_ENABLE\n * Only available on **Android**.*/\n requestEnable(): Promise<void>;\n\n /**\n * Enable Bluetooth.\n * Only available on **Android**.\n * **Deprecated** Will fail on Android SDK >= 33. Use `requestEnable` instead. See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#enable()\n * @deprecated Will fail on Android SDK >= 33. Use `requestEnable` instead. See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#enable()\n */\n enable(): Promise<void>;\n\n /**\n * Disable Bluetooth.\n * Only available on **Android**.\n * **Deprecated** Will fail on Android SDK >= 33. See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#disable()\n * @deprecated Will fail on Android SDK >= 33. See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#disable()\n */\n disable(): Promise<void>;\n\n /**\n * Register a callback function that will be invoked when Bluetooth is enabled (true) or disabled (false) on this device.\n * Not available on **web** (the callback will never be invoked).\n * @param callback Callback function to use when the Bluetooth state changes.\n */\n startEnabledNotifications(callback: (value: boolean) => void): Promise<void>;\n\n /**\n * Stop the enabled notifications registered with `startEnabledNotifications`.\n */\n stopEnabledNotifications(): Promise<void>;\n\n /**\n * Reports whether Location Services are enabled on this device.\n * Only available on **Android**.\n */\n isLocationEnabled(): Promise<boolean>;\n\n /**\n * Open Location settings.\n * Only available on **Android**.\n */\n openLocationSettings(): Promise<void>;\n\n /**\n * Open Bluetooth settings.\n * Only available on **Android**.\n */\n openBluetoothSettings(): Promise<void>;\n\n /**\n * Open App settings.\n * Not available on **web**.\n * On **iOS** when a user declines the request to use Bluetooth on the first call of `initialize`, it is not possible\n * to request for Bluetooth again from within the app. In this case Bluetooth has to be enabled in the app settings\n * for the app to be able use it.\n */\n openAppSettings(): Promise<void>;\n\n /**\n * Set the strings that are displayed in the `requestDevice` dialog.\n * @param displayStrings\n */\n setDisplayStrings(displayStrings: DisplayStrings): Promise<void>;\n\n /**\n * Request a peripheral BLE device to interact with. This will scan for available devices according to the filters in the options and show a dialog to pick a device.\n * For an example, see [usage](#usage).\n * @param options Device filters, see [RequestBleDeviceOptions](#RequestBleDeviceOptions)\n */\n requestDevice(options?: RequestBleDeviceOptions): Promise<BleDevice>;\n\n /**\n * Start scanning for BLE devices to interact with according to the filters in the options. The callback will be invoked on each device that is found.\n * Scanning will continue until `stopLEScan` is called. For an example, see [usage](#usage).\n * **Note**: Use with care on **web** platform, the required API is still behind a flag in most browsers.\n * @param options\n * @param callback\n */\n requestLEScan(options: RequestBleDeviceOptions, callback: (result: ScanResult) => void): Promise<void>;\n\n /**\n * Stop scanning for BLE devices. For an example, see [usage](#usage).\n */\n stopLEScan(): Promise<void>;\n\n /**\n * On iOS and web, if you want to connect to a previously connected device without scanning first, you can use `getDevice`.\n * Uses [retrievePeripherals](https://developer.apple.com/documentation/corebluetooth/cbcentralmanager/1519127-retrieveperipherals) on iOS and\n * [getDevices](https://developer.mozilla.org/en-US/docs/Web/API/Bluetooth/getDevices) on web.\n * On Android, you can directly connect to the device with the deviceId.\n * @param deviceIds List of device IDs, e.g. saved from a previous app run.\n */\n getDevices(deviceIds: string[]): Promise<BleDevice[]>;\n\n /**\n * Get a list of currently bonded devices.\n * Only available on **Android**.\n * Uses [getBondedDevices](https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#getBondedDevices()) on Android\n */\n getBondedDevices(): Promise<BleDevice[]>;\n\n /**\n * Get a list of currently connected devices.\n * Uses [retrieveConnectedPeripherals](https://developer.apple.com/documentation/corebluetooth/cbcentralmanager/1518924-retrieveconnectedperipherals) on iOS,\n * [getConnectedDevices](https://developer.android.com/reference/android/bluetooth/BluetoothManager#getConnectedDevices(int)) on Android\n * and [getDevices](https://developer.mozilla.org/en-US/docs/Web/API/Bluetooth/getDevices) on web.\n * @param services List of services to filter the devices by. If no service is specified, no devices will be returned. Only applies to iOS.\n */\n getConnectedDevices(services: string[]): Promise<BleDevice[]>;\n\n /**\n * Connect to a peripheral BLE device. For an example, see [usage](#usage).\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n * @param onDisconnect Optional disconnect callback function that will be used when the device disconnects\n * @param options Options for plugin call\n */\n connect(deviceId: string, onDisconnect?: (deviceId: string) => void, options?: TimeoutOptions): Promise<void>;\n\n /**\n * Create a bond with a peripheral BLE device.\n * Only available on **Android**. On iOS bonding is handled by the OS.\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n * @param options Options for plugin call\n */\n createBond(deviceId: string, options?: TimeoutOptions): Promise<void>;\n\n /**\n * Report whether a peripheral BLE device is bonded.\n * Only available on **Android**. On iOS bonding is handled by the OS.\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n */\n isBonded(deviceId: string): Promise<boolean>;\n\n /**\n * Disconnect from a peripheral BLE device. For an example, see [usage](#usage).\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n */\n disconnect(deviceId: string): Promise<void>;\n\n /**\n * Get services, characteristics and descriptors of a device.\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n */\n getServices(deviceId: string): Promise<BleService[]>;\n\n /**\n * Discover services, characteristics and descriptors of a device.\n * You only need this method if your peripheral device changes its services and characteristics at runtime.\n * If the discovery was successful, the remote services can be retrieved using the getServices function.\n * Not available on **web**.\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n */\n discoverServices(deviceId: string): Promise<void>;\n\n /**\n * Get the MTU of a connected device. Note that the maximum write value length is 3 bytes less than the MTU.\n * Not available on **web**.\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n */\n getMtu(deviceId: string): Promise<number>;\n\n /**\n * Request a connection parameter update.\n * Only available on **Android**. https://developer.android.com/reference/android/bluetooth/BluetoothGatt#requestConnectionPriority(int)\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n * @param connectionPriority Request a specific connection priority. See [ConnectionPriority](#connectionpriority)\n */\n requestConnectionPriority(deviceId: string, connectionPriority: ConnectionPriority): Promise<void>;\n\n /**\n * Read the RSSI value of a connected device.\n * Not available on **web**.\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n */\n readRssi(deviceId: string): Promise<number>;\n\n /**\n * Read the value of a characteristic. For an example, see [usage](#usage).\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n * @param service UUID of the service (see [UUID format](#uuid-format))\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\n * @param options Options for plugin call\n */\n read(deviceId: string, service: string, characteristic: string, options?: TimeoutOptions): Promise<DataView>;\n\n /**\n * Write a value to a characteristic. For an example, see [usage](#usage).\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n * @param service UUID of the service (see [UUID format](#uuid-format))\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\n * @param value The value to write as a DataView. To create a DataView from an array of numbers, there is a helper function, e.g. numbersToDataView([1, 0])\n * @param options Options for plugin call\n */\n write(\n deviceId: string,\n service: string,\n characteristic: string,\n value: DataView,\n options?: TimeoutOptions,\n ): Promise<void>;\n\n /**\n * Write a value to a characteristic without waiting for a response.\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n * @param service UUID of the service (see [UUID format](#uuid-format))\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\n * @param value The value to write as a DataView. To create a DataView from an array of numbers, there is a helper function, e.g. numbersToDataView([1, 0])\n * @param options Options for plugin call\n */\n writeWithoutResponse(\n deviceId: string,\n service: string,\n characteristic: string,\n value: DataView,\n options?: TimeoutOptions,\n ): Promise<void>;\n\n /**\n * Read the value of a descriptor.\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n * @param service UUID of the service (see [UUID format](#uuid-format))\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\n * @param descriptor UUID of the descriptor (see [UUID format](#uuid-format))\n * @param options Options for plugin call\n */\n readDescriptor(\n deviceId: string,\n service: string,\n characteristic: string,\n descriptor: string,\n options?: TimeoutOptions,\n ): Promise<DataView>;\n\n /**\n * Write a value to a descriptor.\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n * @param service UUID of the service (see [UUID format](#uuid-format))\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\n * @param descriptor UUID of the descriptor (see [UUID format](#uuid-format))\n * @param value The value to write as a DataView. To create a DataView from an array of numbers, there is a helper function, e.g. numbersToDataView([1, 0])\n * @param options Options for plugin call\n */\n writeDescriptor(\n deviceId: string,\n service: string,\n characteristic: string,\n descriptor: string,\n value: DataView,\n options?: TimeoutOptions,\n ): Promise<void>;\n\n /**\n * Start listening to changes of the value of a characteristic.\n * Note that you should only start the notifications once per characteristic in your app and share the data and\n * not call `startNotifications` in every component that needs the data.\n * For an example, see [usage](#usage).\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n * @param service UUID of the service (see [UUID format](#uuid-format))\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\n * @param callback Callback function to use when the value of the characteristic changes\n * @param options Options for plugin call. Timeout not supported on **web**.\n */\n startNotifications(\n deviceId: string,\n service: string,\n characteristic: string,\n callback: (value: DataView) => void,\n options?: TimeoutOptions,\n ): Promise<void>;\n\n /**\n * Stop listening to the changes of the value of a characteristic. For an example, see [usage](#usage).\n * @param deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))\n * @param service UUID of the service (see [UUID format](#uuid-format))\n * @param characteristic UUID of the characteristic (see [UUID format](#uuid-format))\n */\n stopNotifications(deviceId: string, service: string, characteristic: string): Promise<void>;\n}\n\nclass BleClientClass implements BleClientInterface {\n private scanListener: PluginListenerHandle | null = null;\n private eventListeners = new Map<string, PluginListenerHandle>();\n private queue = getQueue(true);\n\n enableQueue() {\n this.queue = getQueue(true);\n }\n\n disableQueue() {\n this.queue = getQueue(false);\n }\n\n async initialize(options?: InitializeOptions): Promise<void> {\n await this.queue(async () => {\n await BluetoothLe.initialize(options);\n });\n }\n\n async isEnabled(): Promise<boolean> {\n const enabled = await this.queue(async () => {\n const result = await BluetoothLe.isEnabled();\n return result.value;\n });\n return enabled;\n }\n\n async requestEnable(): Promise<void> {\n await this.queue(async () => {\n await BluetoothLe.requestEnable();\n });\n }\n\n async enable(): Promise<void> {\n await this.queue(async () => {\n await BluetoothLe.enable();\n });\n }\n\n async disable(): Promise<void> {\n await this.queue(async () => {\n await BluetoothLe.disable();\n });\n }\n\n async startEnabledNotifications(callback: (value: boolean) => void): Promise<void> {\n await this.queue(async () => {\n const key = `onEnabledChanged`;\n await this.eventListeners.get(key)?.remove();\n const listener = await BluetoothLe.addListener(key, (result) => {\n callback(result.value);\n });\n this.eventListeners.set(key, listener);\n await BluetoothLe.startEnabledNotifications();\n });\n }\n\n async stopEnabledNotifications(): Promise<void> {\n await this.queue(async () => {\n const key = `onEnabledChanged`;\n await this.eventListeners.get(key)?.remove();\n this.eventListeners.delete(key);\n await BluetoothLe.stopEnabledNotifications();\n });\n }\n\n async isLocationEnabled(): Promise<boolean> {\n const enabled = await this.queue(async () => {\n const result = await BluetoothLe.isLocationEnabled();\n return result.value;\n });\n return enabled;\n }\n\n async openLocationSettings(): Promise<void> {\n await this.queue(async () => {\n await BluetoothLe.openLocationSettings();\n });\n }\n\n async openBluetoothSettings(): Promise<void> {\n await this.queue(async () => {\n await BluetoothLe.openBluetoothSettings();\n });\n }\n\n async openAppSettings(): Promise<void> {\n await this.queue(async () => {\n await BluetoothLe.openAppSettings();\n });\n }\n\n async setDisplayStrings(displayStrings: DisplayStrings): Promise<void> {\n await this.queue(async () => {\n await BluetoothLe.setDisplayStrings(displayStrings);\n });\n }\n\n async requestDevice(options?: RequestBleDeviceOptions): Promise<BleDevice> {\n options = options ? this.validateRequestBleDeviceOptions(options) : undefined;\n const result = await this.queue(async () => {\n const device = await BluetoothLe.requestDevice(options);\n return device;\n });\n return result;\n }\n\n async requestLEScan(options: RequestBleDeviceOptions, callback: (result: ScanResult) => void): Promise<void> {\n options = this.validateRequestBleDeviceOptions(options);\n await this.queue(async () => {\n await this.scanListener?.remove();\n this.scanListener = await BluetoothLe.addListener('onScanResult', (resultInternal: ScanResultInternal) => {\n const result: ScanResult = {\n ...resultInternal,\n manufacturerData: this.convertObject(resultInternal.manufacturerData),\n serviceData: this.convertObject(resultInternal.serviceData),\n rawAdvertisement: resultInternal.rawAdvertisement\n ? this.convertValue(resultInternal.rawAdvertisement)\n : undefined,\n };\n callback(result);\n });\n await BluetoothLe.requestLEScan(options);\n });\n }\n\n async stopLEScan(): Promise<void> {\n await this.queue(async () => {\n await this.scanListener?.remove();\n this.scanListener = null;\n await BluetoothLe.stopLEScan();\n });\n }\n\n async getDevices(deviceIds: string[]): Promise<BleDevice[]> {\n if (!Array.isArray(deviceIds)) {\n throw new Error('deviceIds must be an array');\n }\n return this.queue(async () => {\n const result = await BluetoothLe.getDevices({ deviceIds });\n return result.devices;\n });\n }\n\n async getConnectedDevices(services: string[]): Promise<BleDevice[]> {\n if (!Array.isArray(services)) {\n throw new Error('services must be an array');\n }\n services = services.map(parseUUID);\n return this.queue(async () => {\n const result = await BluetoothLe.getConnectedDevices({ services });\n return result.devices;\n });\n }\n\n async getBondedDevices(): Promise<BleDevice[]> {\n return this.queue(async () => {\n const result = await BluetoothLe.getBondedDevices();\n return result.devices;\n });\n }\n\n async connect(deviceId: string, onDisconnect?: (deviceId: string) => void, options?: TimeoutOptions): Promise<void> {\n await this.queue(async () => {\n if (onDisconnect) {\n const key = `disconnected|${deviceId}`;\n await this.eventListeners.get(key)?.remove();\n const listener = await BluetoothLe.addListener(key, () => {\n onDisconnect(deviceId);\n });\n this.eventListeners.set(key, listener);\n }\n await BluetoothLe.connect({ deviceId, ...options });\n });\n }\n\n async createBond(deviceId: string, options?: TimeoutOptions): Promise<void> {\n await this.queue(async () => {\n await BluetoothLe.createBond({ deviceId, ...options });\n });\n }\n\n async isBonded(deviceId: string): Promise<boolean> {\n const isBonded = await this.queue(async () => {\n const result = await BluetoothLe.isBonded({ deviceId });\n return result.value;\n });\n return isBonded;\n }\n\n async disconnect(deviceId: string): Promise<void> {\n await this.queue(async () => {\n await BluetoothLe.disconnect({ deviceId });\n });\n }\n\n async getServices(deviceId: string): Promise<BleService[]> {\n const services = await this.queue(async () => {\n const result = await BluetoothLe.getServices({ deviceId });\n return result.services;\n });\n return services;\n }\n\n async discoverServices(deviceId: string): Promise<void> {\n await this.queue(async () => {\n await BluetoothLe.discoverServices({ deviceId });\n });\n }\n\n async getMtu(deviceId: string): Promise<number> {\n const value = await this.queue(async () => {\n const result = await BluetoothLe.getMtu({ deviceId });\n return result.value;\n });\n return value;\n }\n\n async requestConnectionPriority(deviceId: string, connectionPriority: ConnectionPriority): Promise<void> {\n await this.queue(async () => {\n await BluetoothLe.requestConnectionPriority({ deviceId, connectionPriority });\n });\n }\n\n async readRssi(deviceId: string): Promise<number> {\n const value = await this.queue(async () => {\n const result = await BluetoothLe.readRssi({ deviceId });\n return parseFloat(result.value);\n });\n return value;\n }\n\n async read(deviceId: string, service: string, characteristic: string, options?: TimeoutOptions): Promise<DataView> {\n service = parseUUID(service);\n characteristic = parseUUID(characteristic);\n const value = await this.queue(async () => {\n const result = await BluetoothLe.read({\n deviceId,\n service,\n characteristic,\n ...options,\n });\n return this.convertValue(result.value);\n });\n return value;\n }\n\n async write(\n deviceId: string,\n service: string,\n characteristic: string,\n value: DataView,\n options?: TimeoutOptions,\n ): Promise<void> {\n service = parseUUID(service);\n characteristic = parseUUID(characteristic);\n return this.queue(async () => {\n if (!value?.buffer) {\n throw new Error('Invalid data.');\n }\n let writeValue: DataView | string = value;\n if (Capacitor.getPlatform() !== 'web') {\n // on native we can only write strings\n writeValue = dataViewToHexString(value);\n }\n await BluetoothLe.write({\n deviceId,\n service,\n characteristic,\n value: writeValue,\n ...options,\n });\n });\n }\n\n async writeWithoutResponse(\n deviceId: string,\n service: string,\n characteristic: string,\n value: DataView,\n options?: TimeoutOptions,\n ): Promise<void> {\n service = parseUUID(service);\n characteristic = parseUUID(characteristic);\n await this.queue(async () => {\n if (!value?.buffer) {\n throw new Error('Invalid data.');\n }\n let writeValue: DataView | string = value;\n if (Capacitor.getPlatform() !== 'web') {\n // on native we can only write strings\n writeValue = dataViewToHexString(value);\n }\n await BluetoothLe.writeWithoutResponse({\n deviceId,\n service,\n characteristic,\n value: writeValue,\n ...options,\n });\n });\n }\n\n async readDescriptor(\n deviceId: string,\n service: string,\n characteristic: string,\n descriptor: string,\n options?: TimeoutOptions,\n ): Promise<DataView> {\n service = parseUUID(service);\n characteristic = parseUUID(characteristic);\n descriptor = parseUUID(descriptor);\n const value = await this.queue(async () => {\n const result = await BluetoothLe.readDescriptor({\n deviceId,\n service,\n characteristic,\n descriptor,\n ...options,\n });\n return this.convertValue(result.value);\n });\n return value;\n }\n\n async writeDescriptor(\n deviceId: string,\n service: string,\n characteristic: string,\n descriptor: string,\n value: DataView,\n options?: TimeoutOptions,\n ): Promise<void> {\n service = parseUUID(service);\n characteristic = parseUUID(characteristic);\n descriptor = parseUUID(descriptor);\n return this.queue(async () => {\n if (!value?.buffer) {\n throw new Error('Invalid data.');\n }\n let writeValue: DataView | string = value;\n if (Capacitor.getPlatform() !== 'web') {\n // on native we can only write strings\n writeValue = dataViewToHexString(value);\n }\n await BluetoothLe.writeDescriptor({\n deviceId,\n service,\n characteristic,\n descriptor,\n value: writeValue,\n ...options,\n });\n });\n }\n\n async startNotifications(\n deviceId: string,\n service: string,\n characteristic: string,\n callback: (value: DataView) => void,\n options?: TimeoutOptions,\n ): Promise<void> {\n service = parseUUID(service);\n characteristic = parseUUID(characteristic);\n await this.queue(async () => {\n const key = `notification|${deviceId}|${service}|${characteristic}`;\n await this.eventListeners.get(key)?.remove();\n const listener = await BluetoothLe.addListener(key, (event: ReadResult) => {\n callback(this.convertValue(event?.value));\n });\n this.eventListeners.set(key, listener);\n await BluetoothLe.startNotifications({\n deviceId,\n service,\n characteristic,\n ...options,\n });\n });\n }\n\n async stopNotifications(deviceId: string, service: string, characteristic: string): Promise<void> {\n service = parseUUID(service);\n characteristic = parseUUID(characteristic);\n await this.queue(async () => {\n const key = `notification|${deviceId}|${service}|${characteristic}`;\n await this.eventListeners.get(key)?.remove();\n this.eventListeners.delete(key);\n await BluetoothLe.stopNotifications({\n deviceId,\n service,\n characteristic,\n });\n });\n }\n\n private validateRequestBleDeviceOptions(options: RequestBleDeviceOptions): RequestBleDeviceOptions {\n if (options.services) {\n options.services = options.services.map(parseUUID);\n }\n if (options.optionalServices) {\n options.optionalServices = options.optionalServices.map(parseUUID);\n }\n if (options.serviceData && Capacitor.getPlatform() !== 'web') {\n // Native platforms: convert to hex strings\n options.serviceData = options.serviceData.map((filter) => ({\n ...filter,\n serviceUuid: parseUUID(filter.serviceUuid),\n dataPrefix: toHexString(filter.dataPrefix),\n mask: toHexString(filter.mask),\n })) as any;\n }\n if (options.manufacturerData) {\n if (Capacitor.getPlatform() !== 'web') {\n // Native platforms: convert to hex strings\n options.manufacturerData = options.manufacturerData.map((filter) => ({\n ...filter,\n dataPrefix: toHexString(filter.dataPrefix),\n mask: toHexString(filter.mask),\n })) as any;\n } else {\n // Web platform: convert to Uint8Array for Web Bluetooth API\n options.manufacturerData = options.manufacturerData.map((filter) => ({\n ...filter,\n dataPrefix: toUint8Array(filter.dataPrefix),\n mask: toUint8Array(filter.mask),\n }));\n }\n }\n return options;\n }\n\n private convertValue(value?: Data): DataView {\n if (typeof value === 'string') {\n return hexStringToDataView(value);\n } else if (value === undefined) {\n return new DataView(new ArrayBuffer(0));\n }\n return value;\n }\n\n private convertObject(obj?: { [key: string]: Data }): { [key: string]: DataView } | undefined {\n if (obj === undefined) {\n return undefined;\n }\n const result: { [key: string]: DataView } = {};\n for (const key of Object.keys(obj)) {\n result[key] = this.convertValue(obj[key]);\n }\n return result;\n }\n}\n\nexport const BleClient = new BleClientClass();\n"]}
package/dist/esm/config.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\r\n\r\ndeclare module '@capacitor/cli' {\r\n export interface PluginsConfig {\r\n /**\r\n * These config values are available:\r\n */\r\n BluetoothLe?: {\r\n /**\r\n * The strings that are displayed in the device selection dialog on iOS and Android when using `requestDevice()`.\r\n *\r\n * @since 0.0.1\r\n * @default {\r\n \"scanning\": \"Scanning...\",\r\n \"cancel\": \"Cancel\",\r\n \"availableDevices\": \"Available devices\",\r\n \"noDeviceFound\": \"No device found\"\r\n }\r\n * @example {\r\n scanning: \"Am Scannen...\",\r\n cancel: \"Abbrechen\",\r\n availableDevices: \"Verfügbare Geräte\",\r\n noDeviceFound: \"Kein Gerät gefunden\",\r\n }\r\n */\r\n displayStrings?: DisplayStrings;\r\n };\r\n }\r\n}\r\n\r\nexport interface DisplayStrings {\r\n /**\r\n * @since 0.0.1\r\n * @default \"Scanning...\"\r\n * @example \"Am Scannen...\"\r\n */\r\n scanning?: string;\r\n\r\n /**\r\n * @since 0.0.1\r\n * @default \"Cancel\"\r\n * @example \"Abbrechen\"\r\n */\r\n cancel?: string;\r\n\r\n /**\r\n * @since 0.0.1\r\n * @default \"Available devices\"\r\n * @example \"Verfügbare Geräte\"\r\n */\r\n availableDevices?: string;\r\n\r\n /**\r\n * @since 0.0.1\r\n * @default \"No device found\"\r\n * @example \"Kein Gerät gefunden\"\r\n */\r\n noDeviceFound?: string;\r\n}\r\n"]}
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\ndeclare module '@capacitor/cli' {\n export interface PluginsConfig {\n /**\n * These config values are available:\n */\n BluetoothLe?: {\n /**\n * The strings that are displayed in the device selection dialog on iOS and Android when using `requestDevice()`.\n *\n * @since 0.0.1\n * @default {\n \"scanning\": \"Scanning...\",\n \"cancel\": \"Cancel\",\n \"availableDevices\": \"Available devices\",\n \"noDeviceFound\": \"No device found\"\n }\n * @example {\n scanning: \"Am Scannen...\",\n cancel: \"Abbrechen\",\n availableDevices: \"Verfügbare Geräte\",\n noDeviceFound: \"Kein Gerät gefunden\",\n }\n */\n displayStrings?: DisplayStrings;\n };\n }\n}\n\nexport interface DisplayStrings {\n /**\n * @since 0.0.1\n * @default \"Scanning...\"\n * @example \"Am Scannen...\"\n */\n scanning?: string;\n\n /**\n * @since 0.0.1\n * @default \"Cancel\"\n * @example \"Abbrechen\"\n */\n cancel?: string;\n\n /**\n * @since 0.0.1\n * @default \"Available devices\"\n * @example \"Verfügbare Geräte\"\n */\n availableDevices?: string;\n\n /**\n * @since 0.0.1\n * @default \"No device found\"\n * @example \"Kein Gerät gefunden\"\n */\n noDeviceFound?: string;\n}\n"]}
package/dist/esm/conversion.d.ts CHANGED
@@ -32,3 +32,15 @@ export declare function webUUIDToString(uuid: string | number): string;
32
32
  export declare function mapToObject<V>(map?: Map<string | number, V>): {
33
33
  [key: string]: V;
34
34
  } | undefined;
35
+ /**
36
+ * Convert Data or Uint8Array to Uint8Array.
37
+ * @param value DataView, Uint8Array, or undefined
38
+ * @return Uint8Array or undefined
39
+ */
40
+ export declare function toUint8Array(value: DataView | Uint8Array | undefined): Uint8Array | undefined;
41
+ /**
42
+ * Convert Data, Uint8Array, or string to hex string.
43
+ * @param value DataView, Uint8Array, or undefined
44
+ * @return hex string or undefined
45
+ */
46
+ export declare function toHexString(value: DataView | Uint8Array | undefined): string | undefined;
package/dist/esm/conversion.js CHANGED
@@ -82,4 +82,37 @@ export function mapToObject(map) {
82
82
  });
83
83
  return obj;
84
84
  }
85
+ /**
86
+ * Convert Data or Uint8Array to Uint8Array.
87
+ * @param value DataView, Uint8Array, or undefined
88
+ * @return Uint8Array or undefined
89
+ */
90
+ export function toUint8Array(value) {
91
+ if (value === undefined) {
92
+ return undefined;
93
+ }
94
+ if (typeof value === 'string') {
95
+ const dataView = hexStringToDataView(value);
96
+ return new Uint8Array(dataView.buffer, dataView.byteOffset, dataView.byteLength);
97
+ }
98
+ if (value instanceof DataView) {
99
+ return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
100
+ }
101
+ return value; // Already Uint8Array
102
+ }
103
+ /**
104
+ * Convert Data, Uint8Array, or string to hex string.
105
+ * @param value DataView, Uint8Array, or undefined
106
+ * @return hex string or undefined
107
+ */
108
+ export function toHexString(value) {
109
+ if (value === undefined) {
110
+ return undefined;
111
+ }
112
+ if (value instanceof DataView) {
113
+ return dataViewToHexString(value);
114
+ }
115
+ // Uint8Array
116
+ return dataViewToHexString(new DataView(value.buffer, value.byteOffset, value.byteLength));
117
+ }
85
118
  //# sourceMappingURL=conversion.js.map
package/dist/esm/conversion.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"conversion.js","sourceRoot":"","sources":["../../src/conversion.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Convert an array of numbers into a DataView.\r\n */\r\nexport function numbersToDataView(value: number[]): DataView {\r\n return new DataView(Uint8Array.from(value).buffer);\r\n}\r\n\r\n/**\r\n * Convert a DataView into an array of numbers.\r\n */\r\nexport function dataViewToNumbers(value: DataView): number[] {\r\n return Array.from(new Uint8Array(value.buffer, value.byteOffset, value.byteLength));\r\n}\r\n\r\n/**\r\n * Convert a string into a DataView.\r\n */\r\nexport function textToDataView(value: string): DataView {\r\n return numbersToDataView(value.split('').map((s) => s.charCodeAt(0)));\r\n}\r\n\r\n/**\r\n * Convert a DataView into a string.\r\n */\r\nexport function dataViewToText(value: DataView): string {\r\n return String.fromCharCode(...dataViewToNumbers(value));\r\n}\r\n\r\n/**\r\n * Convert a 16 bit UUID into a 128 bit UUID string\r\n * @param value number, e.g. 0x180d\r\n * @return string, e.g. '0000180d-0000-1000-8000-00805f9b34fb'\r\n */\r\nexport function numberToUUID(value: number): string {\r\n return `0000${value.toString(16).padStart(4, '0')}-0000-1000-8000-00805f9b34fb`;\r\n}\r\n\r\n/**\r\n * Convert a string of hex into a DataView of raw bytes.\r\n * Note: characters other than [0-9a-fA-F] are ignored\r\n * @param hex string of values, e.g. \"00 01 02\" or \"000102\"\r\n * @return DataView of raw bytes\r\n */\r\nexport function hexStringToDataView(hex: string): DataView {\r\n const bin = [];\r\n let i,\r\n c,\r\n isEmpty = 1,\r\n buffer = 0;\r\n for (i = 0; i < hex.length; i++) {\r\n c = hex.charCodeAt(i);\r\n if ((c > 47 && c < 58) || (c > 64 && c < 71) || (c > 96 && c < 103)) {\r\n buffer = (buffer << 4) ^ ((c > 64 ? c + 9 : c) & 15);\r\n if ((isEmpty ^= 1)) {\r\n bin.push(buffer & 0xff);\r\n }\r\n }\r\n }\r\n return numbersToDataView(bin);\r\n}\r\n\r\nexport function dataViewToHexString(value: DataView): string {\r\n return dataViewToNumbers(value)\r\n .map((n) => {\r\n let s = n.toString(16);\r\n if (s.length == 1) {\r\n s = '0' + s;\r\n }\r\n return s;\r\n })\r\n .join('');\r\n}\r\n\r\nexport function webUUIDToString(uuid: string | number): string {\r\n if (typeof uuid === 'string') {\r\n return uuid;\r\n } else if (typeof uuid === 'number') {\r\n return numberToUUID(uuid);\r\n } else {\r\n throw new Error('Invalid UUID');\r\n }\r\n}\r\n\r\nexport function mapToObject<V>(map?: Map<string | number, V>): { [key: string]: V } | undefined {\r\n const obj: { [key: string]: V } = {};\r\n if (!map) {\r\n return undefined;\r\n }\r\n map.forEach((value, key) => {\r\n obj[key.toString()] = value;\r\n });\r\n return obj;\r\n}\r\n"]}
1
+ {"version":3,"file":"conversion.js","sourceRoot":"","sources":["../../src/conversion.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Convert an array of numbers into a DataView.\n */\nexport function numbersToDataView(value: number[]): DataView {\n return new DataView(Uint8Array.from(value).buffer);\n}\n\n/**\n * Convert a DataView into an array of numbers.\n */\nexport function dataViewToNumbers(value: DataView): number[] {\n return Array.from(new Uint8Array(value.buffer, value.byteOffset, value.byteLength));\n}\n\n/**\n * Convert a string into a DataView.\n */\nexport function textToDataView(value: string): DataView {\n return numbersToDataView(value.split('').map((s) => s.charCodeAt(0)));\n}\n\n/**\n * Convert a DataView into a string.\n */\nexport function dataViewToText(value: DataView): string {\n return String.fromCharCode(...dataViewToNumbers(value));\n}\n\n/**\n * Convert a 16 bit UUID into a 128 bit UUID string\n * @param value number, e.g. 0x180d\n * @return string, e.g. '0000180d-0000-1000-8000-00805f9b34fb'\n */\nexport function numberToUUID(value: number): string {\n return `0000${value.toString(16).padStart(4, '0')}-0000-1000-8000-00805f9b34fb`;\n}\n\n/**\n * Convert a string of hex into a DataView of raw bytes.\n * Note: characters other than [0-9a-fA-F] are ignored\n * @param hex string of values, e.g. \"00 01 02\" or \"000102\"\n * @return DataView of raw bytes\n */\nexport function hexStringToDataView(hex: string): DataView {\n const bin = [];\n let i,\n c,\n isEmpty = 1,\n buffer = 0;\n for (i = 0; i < hex.length; i++) {\n c = hex.charCodeAt(i);\n if ((c > 47 && c < 58) || (c > 64 && c < 71) || (c > 96 && c < 103)) {\n buffer = (buffer << 4) ^ ((c > 64 ? c + 9 : c) & 15);\n if ((isEmpty ^= 1)) {\n bin.push(buffer & 0xff);\n }\n }\n }\n return numbersToDataView(bin);\n}\n\nexport function dataViewToHexString(value: DataView): string {\n return dataViewToNumbers(value)\n .map((n) => {\n let s = n.toString(16);\n if (s.length == 1) {\n s = '0' + s;\n }\n return s;\n })\n .join('');\n}\n\nexport function webUUIDToString(uuid: string | number): string {\n if (typeof uuid === 'string') {\n return uuid;\n } else if (typeof uuid === 'number') {\n return numberToUUID(uuid);\n } else {\n throw new Error('Invalid UUID');\n }\n}\n\nexport function mapToObject<V>(map?: Map<string | number, V>): { [key: string]: V } | undefined {\n const obj: { [key: string]: V } = {};\n if (!map) {\n return undefined;\n }\n map.forEach((value, key) => {\n obj[key.toString()] = value;\n });\n return obj;\n}\n\n/**\n * Convert Data or Uint8Array to Uint8Array.\n * @param value DataView, Uint8Array, or undefined\n * @return Uint8Array or undefined\n */\nexport function toUint8Array(value: DataView | Uint8Array | undefined): Uint8Array | undefined {\n if (value === undefined) {\n return undefined;\n }\n if (typeof value === 'string') {\n const dataView = hexStringToDataView(value);\n return new Uint8Array(dataView.buffer, dataView.byteOffset, dataView.byteLength);\n }\n if (value instanceof DataView) {\n return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\n }\n return value; // Already Uint8Array\n}\n\n/**\n * Convert Data, Uint8Array, or string to hex string.\n * @param value DataView, Uint8Array, or undefined\n * @return hex string or undefined\n */\nexport function toHexString(value: DataView | Uint8Array | undefined): string | undefined {\n if (value === undefined) {\n return undefined;\n }\n if (value instanceof DataView) {\n return dataViewToHexString(value);\n }\n // Uint8Array\n return dataViewToHexString(new DataView(value.buffer, value.byteOffset, value.byteLength));\n}\n"]}
package/dist/esm/definitions.d.ts CHANGED
@@ -48,6 +48,19 @@ export interface RequestBleDeviceOptions {
48
48
  * https://developer.mozilla.org/en-US/docs/Web/API/Bluetooth/requestDevice#manufacturerdata
49
49
  */
50
50
  manufacturerData?: ManufacturerDataFilter[];
51
+ /**
52
+ * Display mode for the device list in `requestDevice` (**iOS** only).
53
+ * - `"alert"`: Classic alert dialog (default)
54
+ * - `"list"`: Scrollable list view
55
+ * @default "alert"
56
+ */
57
+ displayMode?: 'alert' | 'list';
58
+ /**
59
+ * Allow scanning for devices with specific service data.
60
+ * Service data is data associated with a specific service UUID in the advertisement packet.
61
+ * Useful for protocols like OpenDroneID, EddyStone, and Open Beacon.
62
+ */
63
+ serviceData?: ServiceDataFilter[];
51
64
  }
52
65
  /**
53
66
  * Android scan mode
@@ -97,13 +110,39 @@ export interface ManufacturerDataFilter {
97
110
  /**
98
111
  * Prefix to match in the manufacturer data field.
99
112
  * On **Android** this field is mandatory.
113
+ * android, ios: DataView
114
+ * web: Uint8Array
100
115
  */
101
- dataPrefix?: Uint8Array;
116
+ dataPrefix?: DataView | Uint8Array;
102
117
  /**
103
118
  * 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.
104
119
  * The `mask` must have the same length of dataPrefix.
120
+ * android, ios: DataView
121
+ * web: Uint8Array
122
+ */
123
+ mask?: DataView | Uint8Array;
124
+ }
125
+ export interface ServiceDataFilter {
126
+ /**
127
+ * Service UUID to filter by. The service data must be associated with this UUID.
128
+ * UUIDs have to be specified as 128 bit UUID strings,
129
+ * e.g. '0000fffa-0000-1000-8000-00805f9b34fb'
130
+ */
131
+ serviceUuid: string;
132
+ /**
133
+ * Prefix to match in the service data field.
134
+ * For example, OpenDroneID uses [0x0D] as the advertisement code.
135
+ * android, ios: string
136
+ * web: DataView
137
+ */
138
+ dataPrefix?: DataView;
139
+ /**
140
+ * Set filter on partial service data. For any bit in the mask, set it to 1 if it needs to match the one in service data, otherwise set it to 0.
141
+ * The `mask` must have the same length as dataPrefix.
142
+ * android, ios: string
143
+ * web: DataView
105
144
  */
106
- mask?: Uint8Array;
145
+ mask?: DataView;
107
146
  }
108
147
  export interface BleDevice {
109
148
  /**
@@ -308,6 +347,6 @@ export interface BluetoothLePlugin {
308
347
  writeWithoutResponse(options: WriteOptions & TimeoutOptions): Promise<void>;
309
348
  readDescriptor(options: ReadDescriptorOptions & TimeoutOptions): Promise<ReadResult>;
310
349
  writeDescriptor(options: WriteDescriptorOptions & TimeoutOptions): Promise<void>;
311
- startNotifications(options: ReadOptions): Promise<void>;
350
+ startNotifications(options: ReadOptions & TimeoutOptions): Promise<void>;
312
351
  stopNotifications(options: ReadOptions): Promise<void>;
313
352
  }
package/dist/esm/definitions.js.map CHANGED
@@ -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?: 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"]}
1
+ {"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAoEA;;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';\n\nimport type { DisplayStrings } from './config';\n\nexport interface InitializeOptions {\n /**\n * If your app doesn't use Bluetooth scan results to derive physical\n * location information, you can strongly assert that your app\n * doesn't derive physical location. (Android only)\n * Requires adding 'neverForLocation' to AndroidManifest.xml\n * https://developer.android.com/guide/topics/connectivity/bluetooth/permissions#assert-never-for-location\n * @default false\n */\n androidNeverForLocation?: boolean;\n}\n\nexport interface RequestBleDeviceOptions {\n /**\n * Filter devices by service UUIDs.\n * UUIDs have to be specified as 128 bit UUID strings,\n * e.g. ['0000180d-0000-1000-8000-00805f9b34fb']\n * There is a helper function to convert numbers to UUIDs.\n * e.g. [numberToUUID(0x180f)]. (see [UUID format](#uuid-format))\n */\n services?: string[];\n /**\n * Filter devices by name\n */\n name?: string;\n /**\n * Filter devices by name prefix\n */\n namePrefix?: string;\n /**\n * For **web**, all services that will be used have to be listed under services or optionalServices,\n * e.g. [numberToUUID(0x180f)] (see [UUID format](#uuid-format))\n */\n optionalServices?: string[];\n /**\n * Normally scans will discard the second and subsequent advertisements from a single device.\n * If you need to receive them, set allowDuplicates to true (only applicable in `requestLEScan`).\n * (default: false)\n */\n allowDuplicates?: boolean;\n /**\n * Android scan mode (default: ScanMode.SCAN_MODE_BALANCED)\n */\n scanMode?: ScanMode;\n /**\n * Allow scanning for devices with a specific manufacturer data\n * https://developer.mozilla.org/en-US/docs/Web/API/Bluetooth/requestDevice#manufacturerdata\n */\n manufacturerData?: ManufacturerDataFilter[];\n /**\n * Display mode for the device list in `requestDevice` (**iOS** only).\n * - `\"alert\"`: Classic alert dialog (default)\n * - `\"list\"`: Scrollable list view\n * @default \"alert\"\n */\n displayMode?: 'alert' | 'list';\n /**\n * Allow scanning for devices with specific service data.\n * Service data is data associated with a specific service UUID in the advertisement packet.\n * Useful for protocols like OpenDroneID, EddyStone, and Open Beacon.\n */\n serviceData?: ServiceDataFilter[];\n}\n\n/**\n * Android scan mode\n */\nexport enum ScanMode {\n /**\n * Perform Bluetooth LE scan in low power mode. This mode is enforced if the scanning application is not in foreground.\n * https://developer.android.com/reference/android/bluetooth/le/ScanSettings#SCAN_MODE_LOW_POWER\n */\n SCAN_MODE_LOW_POWER = 0,\n /**\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.\n * https://developer.android.com/reference/android/bluetooth/le/ScanSettings#SCAN_MODE_BALANCED\n */\n SCAN_MODE_BALANCED = 1,\n /**\n * Scan using highest duty cycle. It's recommended to only use this mode when the application is running in the foreground.\n * https://developer.android.com/reference/android/bluetooth/le/ScanSettings#SCAN_MODE_LOW_LATENCY\n */\n SCAN_MODE_LOW_LATENCY = 2,\n}\n\n/**\n * Android connection priority used in `requestConnectionPriority`\n */\nexport enum ConnectionPriority {\n /**\n * Use the connection parameters recommended by the Bluetooth SIG. This is the default value if no connection parameter update is requested.\n * https://developer.android.com/reference/android/bluetooth/BluetoothGatt#CONNECTION_PRIORITY_BALANCED\n */\n CONNECTION_PRIORITY_BALANCED = 0,\n /**\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.\n * https://developer.android.com/reference/android/bluetooth/BluetoothGatt#CONNECTION_PRIORITY_HIGH\n */\n CONNECTION_PRIORITY_HIGH = 1,\n /**\n * Request low power, reduced data rate connection parameters.\n * https://developer.android.com/reference/android/bluetooth/BluetoothGatt#CONNECTION_PRIORITY_LOW_POWER\n */\n CONNECTION_PRIORITY_LOW_POWER = 2,\n}\n\nexport interface ManufacturerDataFilter {\n /**\n * Company ID (sometimes called the manufacturer ID) to search for in the manufacturer data field.\n */\n companyIdentifier: number;\n\n /**\n * Prefix to match in the manufacturer data field.\n * On **Android** this field is mandatory.\n * android, ios: DataView\n * web: Uint8Array\n */\n dataPrefix?: DataView | Uint8Array;\n\n /**\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.\n * The `mask` must have the same length of dataPrefix.\n * android, ios: DataView\n * web: Uint8Array\n */\n mask?: DataView | Uint8Array;\n}\n\nexport interface ServiceDataFilter {\n /**\n * Service UUID to filter by. The service data must be associated with this UUID.\n * UUIDs have to be specified as 128 bit UUID strings,\n * e.g. '0000fffa-0000-1000-8000-00805f9b34fb'\n */\n serviceUuid: string;\n\n /**\n * Prefix to match in the service data field.\n * For example, OpenDroneID uses [0x0D] as the advertisement code.\n * android, ios: string\n * web: DataView\n */\n dataPrefix?: DataView;\n\n /**\n * Set filter on partial service data. For any bit in the mask, set it to 1 if it needs to match the one in service data, otherwise set it to 0.\n * The `mask` must have the same length as dataPrefix.\n * android, ios: string\n * web: DataView\n */\n mask?: DataView;\n}\n\nexport interface BleDevice {\n /**\n * ID of the device, which will be needed for further calls.\n * On **Android** this is the BLE MAC address.\n * On **iOS** and **web** it is an identifier.\n */\n deviceId: string;\n /**\n * Name of the peripheral device.\n */\n name?: string;\n uuids?: string[];\n}\n\nexport interface DeviceIdOptions {\n deviceId: string;\n}\nexport interface TimeoutOptions {\n /**\n * Timeout in milliseconds for plugin call.\n * Default is 10000 for `connect` and 5000 for other plugin methods.\n */\n timeout?: number;\n}\n\nexport interface RequestConnectionPriorityOptions extends DeviceIdOptions {\n connectionPriority: ConnectionPriority;\n}\n\nexport interface GetDevicesOptions {\n deviceIds: string[];\n}\n\nexport interface GetConnectedDevicesOptions {\n services: string[];\n}\n\nexport interface BleService {\n readonly uuid: string;\n readonly characteristics: BleCharacteristic[];\n}\n\nexport interface BleDescriptor {\n readonly uuid: string;\n}\n\nexport interface BleCharacteristic {\n readonly uuid: string;\n readonly properties: BleCharacteristicProperties;\n readonly descriptors: BleDescriptor[];\n}\n\nexport interface BleCharacteristicProperties {\n readonly broadcast: boolean;\n readonly read: boolean;\n readonly writeWithoutResponse: boolean;\n readonly write: boolean;\n readonly notify: boolean;\n readonly indicate: boolean;\n readonly authenticatedSignedWrites: boolean;\n readonly reliableWrite?: boolean;\n readonly writableAuxiliaries?: boolean;\n readonly extendedProperties?: boolean;\n readonly notifyEncryptionRequired?: boolean;\n readonly indicateEncryptionRequired?: boolean;\n}\n\nexport interface BleServices {\n services: BleService[];\n}\n\nexport interface ReadOptions {\n deviceId: string;\n service: string;\n characteristic: string;\n}\n\nexport interface ReadDescriptorOptions {\n deviceId: string;\n service: string;\n characteristic: string;\n descriptor: string;\n}\n\nexport type Data = DataView | string;\n\nexport interface WriteOptions {\n deviceId: string;\n service: string;\n characteristic: string;\n /**\n * android, ios: string\n * web: DataView\n */\n value: Data;\n}\n\nexport interface WriteDescriptorOptions {\n deviceId: string;\n service: string;\n characteristic: string;\n descriptor: string;\n /**\n * android, ios: string\n * web: DataView\n */\n value: Data;\n}\n\nexport interface BooleanResult {\n value: boolean;\n}\n\nexport interface GetDevicesResult {\n devices: BleDevice[];\n}\n\nexport interface GetMtuResult {\n value: number;\n}\n\nexport interface ReadRssiResult {\n value: string;\n}\n\nexport interface ReadResult {\n /**\n * android, ios: string\n * web: DataView\n */\n value?: Data;\n}\n\nexport interface ScanResultInternal<T = Data> {\n device: BleDevice;\n localName?: string;\n rssi?: number;\n txPower?: number;\n manufacturerData?: { [key: string]: T };\n serviceData?: { [key: string]: T };\n uuids?: string[];\n rawAdvertisement?: T;\n}\n\nexport interface ScanResult {\n /**\n * The peripheral device that was found in the scan.\n * **Android** and **web**: `device.name` is always identical to `localName`.\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.\n */\n device: BleDevice;\n /**\n * The name of the peripheral device from the advertisement data.\n */\n localName?: string;\n /**\n * Received Signal Strength Indication.\n */\n rssi?: number;\n /**\n * Transmit power in dBm. A value of 127 indicates that it is not available.\n */\n txPower?: number;\n /**\n * Manufacturer data, key is a company identifier and value is the data.\n */\n manufacturerData?: { [key: string]: DataView };\n /**\n * Service data, key is a service UUID and value is the data.\n */\n serviceData?: { [key: string]: DataView };\n /**\n * Advertised services.\n */\n uuids?: string[];\n /**\n * Raw advertisement data (**Android** only).\n */\n rawAdvertisement?: DataView;\n}\n\nexport interface BluetoothLePlugin {\n initialize(options?: InitializeOptions): Promise<void>;\n isEnabled(): Promise<BooleanResult>;\n requestEnable(): Promise<void>;\n enable(): Promise<void>;\n disable(): Promise<void>;\n startEnabledNotifications(): Promise<void>;\n stopEnabledNotifications(): Promise<void>;\n isLocationEnabled(): Promise<BooleanResult>;\n openLocationSettings(): Promise<void>;\n openBluetoothSettings(): Promise<void>;\n openAppSettings(): Promise<void>;\n setDisplayStrings(displayStrings: DisplayStrings): Promise<void>;\n requestDevice(options?: RequestBleDeviceOptions): Promise<BleDevice>;\n requestLEScan(options?: RequestBleDeviceOptions): Promise<void>;\n stopLEScan(): Promise<void>;\n getDevices(options: GetDevicesOptions): Promise<GetDevicesResult>;\n getConnectedDevices(options: GetConnectedDevicesOptions): Promise<GetDevicesResult>;\n getBondedDevices(): Promise<GetDevicesResult>;\n addListener(\n eventName: 'onEnabledChanged',\n listenerFunc: (result: BooleanResult) => void,\n ): Promise<PluginListenerHandle>;\n addListener(eventName: string, listenerFunc: (event: ReadResult) => void): Promise<PluginListenerHandle>;\n addListener(\n eventName: 'onScanResult',\n listenerFunc: (result: ScanResultInternal) => void,\n ): Promise<PluginListenerHandle>;\n connect(options: DeviceIdOptions & TimeoutOptions): Promise<void>;\n createBond(options: DeviceIdOptions & TimeoutOptions): Promise<void>;\n isBonded(options: DeviceIdOptions): Promise<BooleanResult>;\n disconnect(options: DeviceIdOptions): Promise<void>;\n getServices(options: DeviceIdOptions): Promise<BleServices>;\n discoverServices(options: DeviceIdOptions): Promise<void>;\n getMtu(options: DeviceIdOptions): Promise<GetMtuResult>;\n requestConnectionPriority(options: RequestConnectionPriorityOptions): Promise<void>;\n readRssi(options: DeviceIdOptions): Promise<ReadRssiResult>;\n read(options: ReadOptions & TimeoutOptions): Promise<ReadResult>;\n write(options: WriteOptions & TimeoutOptions): Promise<void>;\n writeWithoutResponse(options: WriteOptions & TimeoutOptions): Promise<void>;\n readDescriptor(options: ReadDescriptorOptions & TimeoutOptions): Promise<ReadResult>;\n writeDescriptor(options: WriteDescriptorOptions & TimeoutOptions): Promise<void>;\n startNotifications(options: ReadOptions & TimeoutOptions): Promise<void>;\n stopNotifications(options: ReadOptions): Promise<void>;\n}\n"]}
package/dist/esm/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC","sourcesContent":["export * from './definitions';\r\nexport * from './bleClient';\r\nexport * from './conversion';\r\nexport * from './plugin';\r\nexport * from './config';\r\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC","sourcesContent":["export * from './definitions';\nexport * from './bleClient';\nexport * from './conversion';\nexport * from './plugin';\nexport * from './config';\n"]}
package/dist/esm/plugin.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAoB,aAAa,EAAE;IAC1E,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;CAC/D,CAAC,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\r\n\r\nimport type { BluetoothLePlugin } from './definitions';\r\n\r\nexport const BluetoothLe = registerPlugin<BluetoothLePlugin>('BluetoothLe', {\r\n web: () => import('./web').then((m) => new m.BluetoothLeWeb()),\r\n});\r\n"]}
1
+ {"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAoB,aAAa,EAAE;IAC1E,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;CAC/D,CAAC,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { BluetoothLePlugin } from './definitions';\n\nexport const BluetoothLe = registerPlugin<BluetoothLePlugin>('BluetoothLe', {\n web: () => import('./web').then((m) => new m.BluetoothLeWeb()),\n});\n"]}
package/dist/esm/queue.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/queue.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG,GAAU,EAAE;IAC5B,IAAI,WAAW,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IACtD,qDAAqD;IACrD,qDAAqD;IACrD,OAAO,CAAC,EAAE,EAAE,EAAE,CACZ,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9B,WAAW,GAAG,WAAW;aACtB,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;aAChB,IAAI,CAAC,OAAO,CAAC;aACb,KAAK,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,IAAI,OAAO,EAAE;QACX,OAAO,SAAS,EAAE,CAAC;KACpB;IACD,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;AACtB,CAAC","sourcesContent":["type Queue = <T>(fn: () => Promise<T>) => Promise<T>;\r\n\r\nconst makeQueue = (): Queue => {\r\n let currentTask: Promise<unknown> = Promise.resolve();\r\n // create a new promise so that errors can be bubbled\r\n // up to the caller without being caught by the queue\r\n return (fn) =>\r\n new Promise((resolve, reject) => {\r\n currentTask = currentTask\r\n .then(() => fn())\r\n .then(resolve)\r\n .catch(reject);\r\n });\r\n};\r\n\r\nexport function getQueue(enabled: boolean): Queue {\r\n if (enabled) {\r\n return makeQueue();\r\n }\r\n return (fn) => fn();\r\n}\r\n"]}
1
+ {"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/queue.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG,GAAU,EAAE;IAC5B,IAAI,WAAW,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IACtD,qDAAqD;IACrD,qDAAqD;IACrD,OAAO,CAAC,EAAE,EAAE,EAAE,CACZ,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9B,WAAW,GAAG,WAAW;aACtB,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;aAChB,IAAI,CAAC,OAAO,CAAC;aACb,KAAK,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,IAAI,OAAO,EAAE;QACX,OAAO,SAAS,EAAE,CAAC;KACpB;IACD,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;AACtB,CAAC","sourcesContent":["type Queue = <T>(fn: () => Promise<T>) => Promise<T>;\n\nconst makeQueue = (): Queue => {\n let currentTask: Promise<unknown> = Promise.resolve();\n // create a new promise so that errors can be bubbled\n // up to the caller without being caught by the queue\n return (fn) =>\n new Promise((resolve, reject) => {\n currentTask = currentTask\n .then(() => fn())\n .then(resolve)\n .catch(reject);\n });\n};\n\nexport function getQueue(enabled: boolean): Queue {\n if (enabled) {\n return makeQueue();\n }\n return (fn) => fn();\n}\n"]}
package/dist/esm/timeout.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/timeout.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAyB,EAAE,IAAY,EAAE,SAAiB;IAC7F,IAAI,KAAoC,CAAC;IACzC,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,OAAO;QACP,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YACxB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC;KACH,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC","sourcesContent":["export async function runWithTimeout(promise: Promise<unknown>, time: number, exception: symbol): Promise<unknown> {\r\n let timer: ReturnType<typeof setTimeout>;\r\n return Promise.race([\r\n promise,\r\n new Promise((_, reject) => {\r\n timer = setTimeout(() => reject(exception), time);\r\n }),\r\n ]).finally(() => clearTimeout(timer));\r\n}\r\n"]}
1
+ {"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/timeout.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAyB,EAAE,IAAY,EAAE,SAAiB;IAC7F,IAAI,KAAoC,CAAC;IACzC,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,OAAO;QACP,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YACxB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC;KACH,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC","sourcesContent":["export async function runWithTimeout(promise: Promise<unknown>, time: number, exception: symbol): Promise<unknown> {\n let timer: ReturnType<typeof setTimeout>;\n return Promise.race([\n promise,\n new Promise((_, reject) => {\n timer = setTimeout(() => reject(exception), time);\n }),\n ]).finally(() => clearTimeout(timer));\n}\n"]}
package/dist/esm/validators.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/validators.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,IAAS;IACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAC5B,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,IAAI,oBAAoB,CAAC,CAAC;KACvE;IACD,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,wEAAwE,CAAC,IAAI,CAAC,CAAC;IAChH,IAAI,CAAC,YAAY,EAAE;QACjB,MAAM,IAAI,KAAK,CACb,uBAAuB,IAAI,0EAA0E,CACtG,CAAC;KACH;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["export function parseUUID(uuid: any): string {\r\n if (typeof uuid !== 'string') {\r\n throw new Error(`Invalid UUID type ${typeof uuid}. Expected string.`);\r\n }\r\n uuid = uuid.toLowerCase();\r\n const is128BitUuid = uuid.search(/^[0-9a-f]{8}\\b-[0-9a-f]{4}\\b-[0-9a-f]{4}\\b-[0-9a-f]{4}\\b-[0-9a-f]{12}$/) >= 0;\r\n if (!is128BitUuid) {\r\n throw new Error(\r\n `Invalid UUID format ${uuid}. Expected 128 bit string (e.g. \"0000180d-0000-1000-8000-00805f9b34fb\").`,\r\n );\r\n }\r\n return uuid;\r\n}\r\n"]}
1
+ {"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/validators.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,IAAS;IACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAC5B,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,IAAI,oBAAoB,CAAC,CAAC;KACvE;IACD,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,wEAAwE,CAAC,IAAI,CAAC,CAAC;IAChH,IAAI,CAAC,YAAY,EAAE;QACjB,MAAM,IAAI,KAAK,CACb,uBAAuB,IAAI,0EAA0E,CACtG,CAAC;KACH;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["export function parseUUID(uuid: any): string {\n if (typeof uuid !== 'string') {\n throw new Error(`Invalid UUID type ${typeof uuid}. Expected string.`);\n }\n uuid = uuid.toLowerCase();\n const is128BitUuid = uuid.search(/^[0-9a-f]{8}\\b-[0-9a-f]{4}\\b-[0-9a-f]{4}\\b-[0-9a-f]{4}\\b-[0-9a-f]{12}$/) >= 0;\n if (!is128BitUuid) {\n throw new Error(\n `Invalid UUID format ${uuid}. Expected 128 bit string (e.g. \"0000180d-0000-1000-8000-00805f9b34fb\").`,\n );\n }\n return uuid;\n}\n"]}
package/dist/esm/web.d.ts CHANGED
@@ -51,6 +51,7 @@ export declare class BluetoothLeWeb extends WebPlugin implements BluetoothLePlug
51
51
  private onCharacteristicValueChanged;
52
52
  stopNotifications(options: ReadOptions): Promise<void>;
53
53
  private getFilters;
54
+ private matchesServiceDataFilter;
54
55
  private getDeviceFromMap;
55
56
  private getBleDevice;
56
57
  }