devtools-protocol 0.0.1336433 → 0.0.1337664

package/json/browser_protocol.json

@@ -26656,6 +26656,155 @@
                     ]
                 }
             ]
+        },
+        {
+            "domain": "BluetoothEmulation",
+            "description": "This domain allows configuring virtual Bluetooth devices to test\nthe web-bluetooth API.",
+            "experimental": true,
+            "types": [
+                {
+                    "id": "CentralState",
+                    "description": "Indicates the various states of Central.",
+                    "type": "string",
+                    "enum": [
+                        "absent",
+                        "powered-off",
+                        "powered-on"
+                    ]
+                },
+                {
+                    "id": "ManufacturerData",
+                    "description": "Stores the manufacturer data",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "key",
+                            "description": "Company identifier\nhttps://bitbucket.org/bluetooth-SIG/public/src/main/assigned_numbers/company_identifiers/company_identifiers.yaml\nhttps://usb.org/developers",
+                            "type": "integer"
+                        },
+                        {
+                            "name": "data",
+                            "description": "Manufacturer-specific data (Encoded as a base64 string when passed over JSON)",
+                            "type": "string"
+                        }
+                    ]
+                },
+                {
+                    "id": "ScanRecord",
+                    "description": "Stores the byte data of the advertisement packet sent by a Bluetooth device.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "name",
+                            "optional": true,
+                            "type": "string"
+                        },
+                        {
+                            "name": "uuids",
+                            "optional": true,
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        },
+                        {
+                            "name": "appearance",
+                            "description": "Stores the external appearance description of the device.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "txPower",
+                            "description": "Stores the transmission power of a broadcasting device.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "manufacturerData",
+                            "description": "Key is the company identifier and the value is an array of bytes of\nmanufacturer specific data.",
+                            "optional": true,
+                            "type": "array",
+                            "items": {
+                                "$ref": "ManufacturerData"
+                            }
+                        }
+                    ]
+                },
+                {
+                    "id": "ScanEntry",
+                    "description": "Stores the advertisement packet information that is sent by a Bluetooth device.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "deviceAddress",
+                            "type": "string"
+                        },
+                        {
+                            "name": "rssi",
+                            "type": "integer"
+                        },
+                        {
+                            "name": "scanRecord",
+                            "$ref": "ScanRecord"
+                        }
+                    ]
+                }
+            ],
+            "commands": [
+                {
+                    "name": "enable",
+                    "description": "Enable the BluetoothEmulation domain.",
+                    "parameters": [
+                        {
+                            "name": "state",
+                            "description": "State of the simulated central.",
+                            "$ref": "CentralState"
+                        }
+                    ]
+                },
+                {
+                    "name": "disable",
+                    "description": "Disable the BluetoothEmulation domain."
+                },
+                {
+                    "name": "simulatePreconnectedPeripheral",
+                    "description": "Simulates a peripheral with |address|, |name| and |knownServiceUuids|\nthat has already been connected to the system.",
+                    "parameters": [
+                        {
+                            "name": "address",
+                            "type": "string"
+                        },
+                        {
+                            "name": "name",
+                            "type": "string"
+                        },
+                        {
+                            "name": "manufacturerData",
+                            "type": "array",
+                            "items": {
+                                "$ref": "ManufacturerData"
+                            }
+                        },
+                        {
+                            "name": "knownServiceUuids",
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ]
+                },
+                {
+                    "name": "simulateAdvertisement",
+                    "description": "Simulates an advertisement packet described in |entry| being received by\nthe central.",
+                    "parameters": [
+                        {
+                            "name": "entry",
+                            "$ref": "ScanEntry"
+                        }
+                    ]
+                }
+            ]
         }
     ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtools-protocol",
-  "version": "0.0.1336433",
+  "version": "0.0.1337664",
   "description": "The Chrome DevTools Protocol JSON",
   "repository": "https://github.com/ChromeDevTools/devtools-protocol",
   "author": "The Chromium Authors",

package/pdl/browser_protocol.pdl

@@ -12612,3 +12612,67 @@ experimental domain PWA
       # supported yet.
       optional boolean linkCapturing
       optional DisplayMode displayMode
+
+# This domain allows configuring virtual Bluetooth devices to test
+# the web-bluetooth API.
+experimental domain BluetoothEmulation
+  # Indicates the various states of Central.
+  type CentralState extends string
+    enum
+      absent
+      powered-off
+      powered-on
+
+  # Stores the manufacturer data
+  type ManufacturerData extends object
+    properties
+      # Company identifier
+      # https://bitbucket.org/bluetooth-SIG/public/src/main/assigned_numbers/company_identifiers/company_identifiers.yaml
+      # https://usb.org/developers
+      integer key
+      # Manufacturer-specific data
+      binary data
+
+  # Stores the byte data of the advertisement packet sent by a Bluetooth device.
+  type ScanRecord extends object
+    properties
+      optional string name
+      optional array of string uuids
+      # Stores the external appearance description of the device.
+      optional integer appearance
+      # Stores the transmission power of a broadcasting device.
+      optional integer txPower
+      # Key is the company identifier and the value is an array of bytes of
+      # manufacturer specific data.
+      optional array of ManufacturerData manufacturerData
+
+  # Stores the advertisement packet information that is sent by a Bluetooth device.
+  type ScanEntry extends object
+    properties
+      string deviceAddress
+      integer rssi
+      ScanRecord scanRecord
+
+  # Enable the BluetoothEmulation domain.
+  command enable
+    parameters
+      # State of the simulated central.
+      CentralState state
+
+  # Disable the BluetoothEmulation domain.
+  command disable
+
+  # Simulates a peripheral with |address|, |name| and |knownServiceUuids|
+  # that has already been connected to the system.
+  command simulatePreconnectedPeripheral
+    parameters
+      string address
+      string name
+      array of ManufacturerData manufacturerData
+      array of string knownServiceUuids
+
+  # Simulates an advertisement packet described in |entry| being received by
+  # the central.
+  command simulateAdvertisement
+    parameters
+      ScanEntry entry

package/types/protocol-mapping.d.ts

@@ -5079,6 +5079,36 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.PWA.ChangeAppUserSettingsRequest];
             returnType: void;
         };
+        /**
+         * Enable the BluetoothEmulation domain.
+         */
+        'BluetoothEmulation.enable': {
+            paramsType: [Protocol.BluetoothEmulation.EnableRequest];
+            returnType: void;
+        };
+        /**
+         * Disable the BluetoothEmulation domain.
+         */
+        'BluetoothEmulation.disable': {
+            paramsType: [];
+            returnType: void;
+        };
+        /**
+         * Simulates a peripheral with |address|, |name| and |knownServiceUuids|
+         * that has already been connected to the system.
+         */
+        'BluetoothEmulation.simulatePreconnectedPeripheral': {
+            paramsType: [Protocol.BluetoothEmulation.SimulatePreconnectedPeripheralRequest];
+            returnType: void;
+        };
+        /**
+         * Simulates an advertisement packet described in |entry| being received by
+         * the central.
+         */
+        'BluetoothEmulation.simulateAdvertisement': {
+            paramsType: [Protocol.BluetoothEmulation.SimulateAdvertisementRequest];
+            returnType: void;
+        };
     }
 }
 

package/types/protocol-proxy-api.d.ts

@@ -116,6 +116,8 @@ export namespace ProtocolProxyApi {
 
         PWA: PWAApi;
 
+        BluetoothEmulation: BluetoothEmulationApi;
+
     }
 
 
@@ -4339,6 +4341,31 @@ export namespace ProtocolProxyApi {
         changeAppUserSettings(params: Protocol.PWA.ChangeAppUserSettingsRequest): Promise<void>;
 
     }
+
+    export interface BluetoothEmulationApi {
+        /**
+         * Enable the BluetoothEmulation domain.
+         */
+        enable(params: Protocol.BluetoothEmulation.EnableRequest): Promise<void>;
+
+        /**
+         * Disable the BluetoothEmulation domain.
+         */
+        disable(): Promise<void>;
+
+        /**
+         * Simulates a peripheral with |address|, |name| and |knownServiceUuids|
+         * that has already been connected to the system.
+         */
+        simulatePreconnectedPeripheral(params: Protocol.BluetoothEmulation.SimulatePreconnectedPeripheralRequest): Promise<void>;
+
+        /**
+         * Simulates an advertisement packet described in |entry| being received by
+         * the central.
+         */
+        simulateAdvertisement(params: Protocol.BluetoothEmulation.SimulateAdvertisementRequest): Promise<void>;
+
+    }
 }
 
 export default ProtocolProxyApi;

package/types/protocol-tests-proxy-api.d.ts

@@ -116,6 +116,8 @@ export namespace ProtocolTestsProxyApi {
 
         PWA: PWAApi;
 
+        BluetoothEmulation: BluetoothEmulationApi;
+
     }
 
 
@@ -4725,6 +4727,31 @@ export namespace ProtocolTestsProxyApi {
         changeAppUserSettings(params: Protocol.PWA.ChangeAppUserSettingsRequest): Promise<{id: number, result: void, sessionId: string}>;
 
     }
+
+    export interface BluetoothEmulationApi {
+        /**
+         * Enable the BluetoothEmulation domain.
+         */
+        enable(params: Protocol.BluetoothEmulation.EnableRequest): Promise<{id: number, result: void, sessionId: string}>;
+
+        /**
+         * Disable the BluetoothEmulation domain.
+         */
+        disable(): Promise<{id: number, result: void, sessionId: string}>;
+
+        /**
+         * Simulates a peripheral with |address|, |name| and |knownServiceUuids|
+         * that has already been connected to the system.
+         */
+        simulatePreconnectedPeripheral(params: Protocol.BluetoothEmulation.SimulatePreconnectedPeripheralRequest): Promise<{id: number, result: void, sessionId: string}>;
+
+        /**
+         * Simulates an advertisement packet described in |entry| being received by
+         * the central.
+         */
+        simulateAdvertisement(params: Protocol.BluetoothEmulation.SimulateAdvertisementRequest): Promise<{id: number, result: void, sessionId: string}>;
+
+    }
 }
 
 export default ProtocolTestsProxyApi;

package/types/protocol.d.ts

@@ -18755,6 +18755,82 @@ export namespace Protocol {
             displayMode?: DisplayMode;
         }
     }
+
+    /**
+     * This domain allows configuring virtual Bluetooth devices to test
+     * the web-bluetooth API.
+     */
+    export namespace BluetoothEmulation {
+
+        /**
+         * Indicates the various states of Central.
+         */
+        export type CentralState = ('absent' | 'powered-off' | 'powered-on');
+
+        /**
+         * Stores the manufacturer data
+         */
+        export interface ManufacturerData {
+            /**
+             * Company identifier
+             * https://bitbucket.org/bluetooth-SIG/public/src/main/assigned_numbers/company_identifiers/company_identifiers.yaml
+             * https://usb.org/developers
+             */
+            key: integer;
+            /**
+             * Manufacturer-specific data (Encoded as a base64 string when passed over JSON)
+             */
+            data: string;
+        }
+
+        /**
+         * Stores the byte data of the advertisement packet sent by a Bluetooth device.
+         */
+        export interface ScanRecord {
+            name?: string;
+            uuids?: string[];
+            /**
+             * Stores the external appearance description of the device.
+             */
+            appearance?: integer;
+            /**
+             * Stores the transmission power of a broadcasting device.
+             */
+            txPower?: integer;
+            /**
+             * Key is the company identifier and the value is an array of bytes of
+             * manufacturer specific data.
+             */
+            manufacturerData?: ManufacturerData[];
+        }
+
+        /**
+         * Stores the advertisement packet information that is sent by a Bluetooth device.
+         */
+        export interface ScanEntry {
+            deviceAddress: string;
+            rssi: integer;
+            scanRecord: ScanRecord;
+        }
+
+        export interface EnableRequest {
+            /**
+             * State of the simulated central.
+             */
+            state: CentralState;
+        }
+
+        export interface SimulatePreconnectedPeripheralRequest {
+            address: string;
+            name: string;
+            manufacturerData: ManufacturerData[];
+            knownServiceUuids: string[];
+        }
+
+        export interface SimulateAdvertisementRequest {
+            entry: ScanEntry;
+        }
+    }
 }
 
 export default Protocol;