Updated docs to link to the current version of the service, `charac…

…teristic`, and `manufacturer data` blocklists

  * https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
  * https://github.com/WebBluetoothCG/registries/blob/master/manufacturer_data_blocklist.txt

CHANGELOG.md

@@ -14,6 +14,9 @@
     * Use `BluetoothDefaultCharacteristicUUIDS.characteristics` to get a list of all the non-deprecated characteristic
       UUIDS.
     * Added the `id` field to the enum, this contains the official Bluetooth SIG id of the UUID.
+* Updated docs to link to the current version of the `service`, `characteristic`, and `manufacturer data` blocklists
+  * https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  * https://github.com/WebBluetoothCG/registries/blob/master/manufacturer_data_blocklist.txt
 
 ## 0.2.3
 

README.md

@@ -61,7 +61,8 @@ You must beforehand specify which services you want to connect to! If you do not
 access to a specific service then you won't be able to discover the service!
 
 Some services are also part of a so called blocklist. This is different per browsers and these services are just off 
-limit.
+limit. The Web Bluetooth Community Group has a [list](https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt) 
+of all block services and characteristics.
 
 ```dart
 // Define the services you want to communicate with here!

lib/src/bluetooth_service.dart

@@ -72,6 +72,10 @@ class BluetoothService {
   /// for this browser. Check [hasIncludedService] to make sure you don't get
   /// this error.
   ///
+  /// **NOTE:** Some services are on a block list, and are thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   Future<BluetoothService> getIncludedService(final String uuid) async {
     try {
       final service = await _bluetoothService.getIncludedService(uuid);
@@ -105,6 +109,10 @@ class BluetoothService {
   ///
   /// - May throw [StateError] if the service is null.
   ///
+  /// **NOTE:** Some characteristics are on a block list, and are thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   Future<BluetoothCharacteristic> getCharacteristic(final String uuid) async {
     try {
       final characteristic = await _bluetoothService.getCharacteristic(uuid);
@@ -138,6 +146,9 @@ class BluetoothService {
   ///
   /// - May throw [StateError] if the service is null.
   ///
+  /// **NOTE:** Some characteristics are on a block list, and are thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
   ///
   Future<List<BluetoothCharacteristic>> getCharacteristics(
       {final String? uuid}) async {

lib/src/request_options_builder.dart

@@ -25,11 +25,19 @@ class RequestOptionsBuilder {
   /// [optionalServices] is a list of services that are a nice to have. If a
   /// device doesn't have this service then the browser won't reject it.
   ///
+  /// **NOTE:** For [optionalServices]\: Some services are on a block list,
+  /// and are thus not available. The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   /// [optionalManufacturerData] is a list of manufacturer codes. These codes
   /// are then used to grand access to specific manufacturer data. This can
   /// be a list of either strings in hexadecimal or ints. **NOTE** these values
   /// can be a maximum of unsigned 16 bits.
   ///
+  /// **NOTE:** For [optionalManufacturerData]\: Some manufacturer data is on a
+  /// block list, and is thus not available. The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/manufacturer_data_blocklist.txt
+  ///
   /// **NOTE:** You **NEED** to define a service in either the [requestFilters]
   /// or [optionalServices] if you want to be able to communicate with a
   /// characteristic in it.
@@ -67,11 +75,19 @@ class RequestOptionsBuilder {
   /// [optionalServices] is a list of services that are a nice to have. If a
   /// device doesn't have this service then the browser won't reject it.
   ///
+  /// **NOTE:** For [optionalServices]\: Some services are on a block list,
+  /// and are thus not available. The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   /// [optionalManufacturerData] is a list of manufacturer codes. These codes
   /// are then used to grand access to specific manufacturer data. This can
   /// be a list of either strings in hexadecimal or ints. **NOTE** these values
   /// can be a maximum of unsigned 16 bits.
   ///
+  /// **NOTE:** For [optionalManufacturerData]\: Some manufacturer data is on a
+  /// block list, and is thus not available. The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/manufacturer_data_blocklist.txt
+  ///
   /// **NOTE:** You **NEED** to define a service in [optionalServices] if you
   /// want to be able to communicate communicate with a
   /// characteristic in it.
@@ -273,6 +289,11 @@ class ServiceDataFilterBuilder {
 /// This can be used to define the services that the device should have before
 /// being able to communicate with it.
 ///
+///
+///  **NOTE:** Some manufacturer data is on a block list, and is thus not available.
+///  The complete blocklist can be found here:
+///  https://github.com/WebBluetoothCG/registries/blob/master/manufacturer_data_blocklist.txt
+///
 class ManufacturerDataFilterBuilder {
   ///
   /// The 16 bit identifier of the company that either made the device, or more
@@ -357,11 +378,19 @@ class RequestFilterBuilder {
   /// [services] is a list of service UUIDS. The device must have all the
   /// services advertised in the list or it won't be allowed access.
   ///
+  /// **NOTE:** For [services]\: Some services are on a block list,
+  /// and are thus not available. The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   /// [manufacturerData] is a list of [ManufacturerDataFilterBuilder]
   /// for what the manufacture data of the device should match before it shows
   /// up in the available devices list. Note that if you set multiple manufacturer
   /// data filters then a single device must match all of them.
   ///
+  ///  **NOTE:** For [manufacturerData]\: Some manufacturer data is on a
+  ///  block list, and is thus not available. The complete blocklist can be found here:
+  ///  https://github.com/WebBluetoothCG/registries/blob/master/manufacturer_data_blocklist.txt
+  ///
   /// [serviceData] **Note** this is not stable yet and my not be implemented.
   /// ignore: deprecated_member_use_from_same_package
   /// A list of [ServiceDataFilterBuilder]s for the services that the

lib/web/native_bluetooth_remote_gatt_server.dart

@@ -101,6 +101,10 @@ class NativeBluetoothRemoteGATTServer {
   ///
   /// - May throw NotFoundError if the services was found.
   ///
+  /// **NOTE:** Some services are on a block list, and are thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   /// See:
   ///
   /// - [getPrimaryServices]
@@ -134,6 +138,10 @@ class NativeBluetoothRemoteGATTServer {
   ///
   /// - May throw NotFoundError if no services were found.
   ///
+  /// **NOTE:** Some services are on a block list, and are thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   /// See:
   ///
   /// - [getPrimaryService]

lib/web/web_bluetooth_remote_gatt_service.dart

@@ -116,6 +116,10 @@ class WebBluetoothRemoteGATTService {
   ///
   /// - May throw NotFoundError if the characteristic was not found.
   ///
+  /// **NOTE:** Some characteristics are on a block list, and are thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   /// See:
   ///
   /// - [getCharacteristics]
@@ -162,6 +166,10 @@ class WebBluetoothRemoteGATTService {
   ///
   /// - May throw NotFoundError if the characteristic was not found.
   ///
+  /// **NOTE:** Some characteristics are on a block list, and are thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   /// See:
   ///
   /// - [hasGetCharacteristicsFunction]
@@ -236,6 +244,10 @@ class WebBluetoothRemoteGATTService {
   ///
   /// - May throw NotFoundError if the service was not found.
   ///
+  /// **NOTE:** Some services are on a block list, and are thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   /// See:
   ///
   /// - [hasGetIncludedServiceFunction]
@@ -295,6 +307,10 @@ class WebBluetoothRemoteGATTService {
   ///
   /// - May throw NotFoundError if the service was not found.
   ///
+  /// **NOTE:** Some services are on a block list, and are thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   /// See:
   ///
   /// - [hasGetIncludedServiceFunction]

lib/web/web_bluetooth_request_options.dart

@@ -43,6 +43,10 @@ class RequestOptions {
   /// or [optionalServices] if you want to be able to communicate with a
   /// characteristic in it.
   ///
+  /// **NOTE:** Some services are on a block list, and are thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   external List<String> get optionalServices;
 
   ///
@@ -51,6 +55,10 @@ class RequestOptions {
   /// *NOTE:** You **NEED** to define a manufacturer's code in either the [filters]
   /// or [optionalManufacturerData] if you want to be able to get its data.
   ///
+  /// **NOTE:** Some manufacturer data is on a block list, and is thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/manufacturer_data_blocklist.txt
+  ///
   external List<int> get optionalManufacturerData;
 
   ///

lib/web/web_bluetooth_scan_filters.dart

@@ -110,6 +110,10 @@ class BluetoothScanFilter {
   /// A list of UUIDS (should be lower case) of the services that the device
   /// must have. A device is only allowed if it has all the services.
   ///
+  /// **NOTE:** Some services are on a block list, and are thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt
+  ///
   external List<String>? get services;
 
   ///
@@ -131,6 +135,10 @@ class BluetoothScanFilter {
   /// up in the available devices list. Note that if you set multiple manufacturer
   /// data filters then a single device must match all of them.
   ///
+  /// **NOTE:** Some manufacturer data is on a block list, and is thus not available.
+  /// The complete blocklist can be found here:
+  /// https://github.com/WebBluetoothCG/registries/blob/master/manufacturer_data_blocklist.txt
+  ///
   external List<BluetoothManufacturerDataFilter>? get manufacturerData;
 
   ///