chromium-bidi 0.1.2 → 0.4.3

package/README.md

@@ -1,13 +1,129 @@
 # WebDriver BiDi for Chromium [![chromium-bidi on npm](https://img.shields.io/npm/v/chromium-bidi)](https://www.npmjs.com/package/chromium-bidi)
 
+![E2E Tests](https://github.com/GoogleChromeLabs/chromium-bidi/actions/workflows/e2e.js.yml/badge.svg)
+![Unit Tests](https://github.com/GoogleChromeLabs/chromium-bidi/actions/workflows/unit.js.yml/badge.svg)
+![WPT Tests](https://github.com/GoogleChromeLabs/chromium-bidi/actions/workflows/wpt.yml/badge.svg)
+
 This is an implementation of the
-[WebDriver BiDi](https://w3c.github.io/webdriver-bidi/) protocol for Chromium,
-implemented as a JavaScript layer translating between BiDi and CDP, running
-inside a Chrome tab.
+[WebDriver BiDi](https://w3c.github.io/webdriver-bidi/) protocol with some
+extensions (**BiDi+**)
+for Chromium, implemented as a JavaScript layer translating between BiDi and CDP,
+running inside a Chrome tab.
 
-Current status can be checked here:
-[Chromium BiDi progress](https://docs.google.com/spreadsheets/d/1acM-kHlubpwnW1mFboS9hePawq3u1kf21oQzD16q-Ao/edit?usp=sharing&resourcekey=0-PuLHQYLmDJUOXH_mFO-QiA)
-.
+Current status can be checked
+in [WPT WebDriver BiDi status](https://wpt.fyi/results/webdriver/tests/bidi).
+
+## BiDi+
+
+**"BiDi+"** is an extension of the WebDriver BiDi protocol. In addition to
+the [WebDriver BiDi](https://w3c.github.io/webdriver-bidi/) it has:
+
+### Command `cdp.sendCommand`
+
+```cddl
+CdpSendCommandCommand = {
+  method: "cdp.sendCommand",
+  params: ScriptEvaluateParameters,
+}
+
+CdpSendCommandParameters = {
+   cdpMethod: text,
+   cdpParams: any,
+   cdpSession?: text,
+}
+
+CdpSendCommandResult = {
+   result: any,
+   cdpSession: text,
+}
+```
+
+The command runs the
+described [CDP command](https://chromedevtools.github.io/devtools-protocol)
+and returns result.
+
+### Command `cdp.getSession`
+
+```cddl
+CdpGetSessionCommand = {
+   method: "cdp.sendCommand",
+   params: ScriptEvaluateParameters,
+}
+
+CdpGetSessionParameters = {
+   context: BrowsingContext,
+}
+
+CdpGetSessionResult = {
+   cdpSession: text,
+}
+```
+
+The command returns the default CDP session for the selected browsing context.
+
+### Event `cdp.eventReceived`
+
+```cddl
+CdpEventReceivedEvent = {
+   method: "cdp.eventReceived",
+   params: ScriptEvaluateParameters,
+}
+
+CdpEventReceivedParameters = {
+   cdpMethod: text,
+   cdpParams: any,
+   cdpSession: string,
+}
+```
+
+The event contains a CDP event.
+
+## Field `channel`
+
+Each command can be extended with a `channel`:
+
+```cddl
+Command = {
+   id: js-uint,
+   channel?: text,
+   CommandData,
+   Extensible,
+}
+```
+
+If provided and non-empty string, the very same `channel` is added to the response:
+
+```cddl
+CommandResponse = {
+   id: js-uint,
+   channel?: text,
+   result: ResultData,
+   Extensible,
+}
+
+ErrorResponse = {
+  id: js-uint / null,
+  channel?: text,
+  error: ErrorCode,
+  message: text,
+  ?stacktrace: text,
+  Extensible
+}
+```
+
+When client uses
+commands [`session.subscribe`](https://w3c.github.io/webdriver-bidi/#command-session-subscribe)
+and [`session.unsubscribe`](https://w3c.github.io/webdriver-bidi/#command-session-unsubscribe)
+with `channel`, the subscriptions are handled per channel, and the corresponding
+`channel` filed is added to the event message:
+
+```cddl
+Event = {
+  channel?: text,
+  EventData,
+  Extensible,
+}
+```
 
 # Setup
 
@@ -19,12 +135,13 @@ npm install
 
 # Starting the Server
 
+This will run the server on port `8080`:
+
 ```sh
 npm run server
 ```
 
-This will run the server on port 8080. Use the `PORT` environment variable
-or `--port=...` argument to run it on another port:
+Use the `PORT=` environment variable or `--port=` argument to run it on another port:
 
 ```sh
 PORT=8081 npm run server
@@ -43,6 +160,17 @@ Use the CLI argument `--headless=false` to run browser in headful mode:
 npm run server -- --headless=false
 ```
 
+Use the `CHANNEL=...` environment variable or `--channel=...` argument with one of
+the following values to run the specific Chrome channel: `chrome`,
+`chrome-beta`, `chrome-canary`, `chrome-dev`.
+
+The requested Chrome version should be installed.
+
+```sh
+CHANNEL=chrome-dev npm run server
+npm run server -- --channel=chrome-dev
+```
+
 ## Starting on Linux and Mac
 
 TODO: verify if it works on Windows.
@@ -66,8 +194,8 @@ npm run unit
 
 ## e2e tests
 
-The e2e tests are written using Python, in order to learn how to eventually do
-this in web-platform-tests.
+The e2e tests are written using Python, in order to learn how to eventually do this
+in web-platform-tests.
 
 ### Installation
 
@@ -79,8 +207,8 @@ python3 -m pip install --user -r tests/requirements.txt
 
 ### Running
 
-The e2e tests require BiDi server running on the same host. By default, tests
-try to connect to the port `8080`. The server can be run from the project root:
+The e2e tests require BiDi server running on the same host. By default, tests try to
+connect to the port `8080`. The server can be run from the project root:
 
 ```sh
 npm run e2e
@@ -94,15 +222,15 @@ PORT=8081 npm run e2e
 
 ## Examples
 
-The examples are stored in the `/examples` folder and are intended to show who
-the BiDi protocol can be used. Examples are based on
+The examples are stored in the `/examples` folder and are intended to show who the
+BiDi protocol can be used. Examples are based on
 [Puppeteer's examples](https://github.com/puppeteer/puppeteer/tree/main/examples)
 .
 
-### Instalation
+### Installation
 
-The examples are written using Python, to align with e2e test. Python 3.6+ and
-some dependencies are required:
+The examples are written using Python, to align with e2e test. Python 3.6+ and some
+dependencies are required:
 
 ```sh
 python3 -m pip install --user -r tests/requirements.txt
@@ -110,8 +238,8 @@ python3 -m pip install --user -r tests/requirements.txt
 
 ### Running
 
-The examples require BiDi server running on the same host on the port `8080`.
-The server can be run from the project root:
+The examples require BiDi server running on the same host on the port `8080`. The
+server can be run from the project root:
 
 ```sh
 npm run server
@@ -120,22 +248,22 @@ npm run server
 After running server, examples can be simply run:
 
 ```sh
-python3 examples/cross-browser.py
+python3 examples/console_log_example.py
+python3 examples/script_example.py
 ```
 
 ## WPT
 
 WPT is added as
-a [git submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules). To get
-run WPT tests:
+a [git submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules). To get run
+WPT tests:
 
 ### Check out WPT and setup
 
 #### 1. Check out WPT
 
 ```sh
-git submodule init
-git submodule update
+git submodule update --init
 ```
 
 #### 2. Go to the WPT folder
@@ -170,8 +298,8 @@ This must be run in a PowerShell session with Administrator privileges:
 python wpt make-hosts-file | Out-File $env:SystemRoot\System32\drivers\etc\hosts -Encoding ascii -Append
 ```
 
-If you are behind a proxy, you also need to make sure the domains above are
-excluded from your proxy lookups.
+If you are behind a proxy, you also need to make sure the domains above are excluded
+from your proxy lookups.
 
 #### 5. Set the `WPT_BROWSER_PATH` environment variable to a Chrome, Edge or Chromium binary to launch. For example, on macOS:
 
@@ -183,6 +311,10 @@ export WPT_BROWSER_PATH="/Applications/Chromium.app/Contents/MacOS/Chromium"
 
 ### Run WPT tests
 
+#### 1. Make sure you have Chrome Dev instaled
+
+https://www.google.com/chrome/dev/
+
 #### 1. Build ChromeDriver BiDi
 
 ```sh
@@ -234,12 +366,32 @@ The architecture is described in the
 
 There are 2 main modules:
 
-1. backend WS server in `src`. It runs webSocket server, and for each ws
-   connection runs an instance of browser with BiDi Mapper.
-2. front-end BiDi Mapper in `src/bidiMapper`. Gets BiDi commands from the
-   backend, and map them to CDP commands.
+1. backend WS server in `src`. It runs webSocket server, and for each ws connection
+   runs an instance of browser with BiDi Mapper.
+2. front-end BiDi Mapper in `src/bidiMapper`. Gets BiDi commands from the backend,
+   and map them to CDP commands.
 
 ## Contributing
 
-The BiDi commands are processed in the `src/bidiMapper/commandProcessor.ts`. To
-add a new command, add it to `_processCommand`, write and call processor for it.
+The BiDi commands are processed in the `src/bidiMapper/commandProcessor.ts`. To add a
+new command, add it to `_processCommand`, write and call processor for it.
+
+## Publish new `npm` release
+
+1. On the `main` branch, bump the chromium-bidi version number in `package.json`:
+
+   ```sh
+   npm version patch -m 'Release v%s'
+   ```
+
+   Instead of `patch`, use `minor` or `major` [as needed](https://semver.org/).
+
+   Note that this produces a Git commit + tag.
+
+1. Push the release commit and tag:
+
+   ```sh
+   git push && git push --tags
+   ```
+
+   Our CI then automatically publishes the new release to npm.

package/lib/cjs/bidiMapper/BidiServer.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright 2021 Google LLC.
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { EventEmitter } from '../utils/EventEmitter.js';
+import { BidiTransport } from './BidiTransport.js';
+import type { Message } from '../protocol/protocol.js';
+import { OutgoingBidiMessage } from './OutgoindBidiMessage.js';
+import { BidiParser } from './CommandProcessor.js';
+import { CdpConnection } from './CdpConnection.js';
+declare type BidiServerEvents = {
+    message: Message.RawCommandRequest;
+};
+export declare class BidiServer extends EventEmitter<BidiServerEvents> {
+    #private;
+    private constructor();
+    static createAndStart(bidiTransport: BidiTransport, cdpConnection: CdpConnection, selfTargetId: string, parser?: BidiParser): Promise<BidiServer>;
+    /**
+     * Sends BiDi message.
+     */
+    emitOutgoingMessage(messageEntry: Promise<OutgoingBidiMessage>): void;
+    close(): void;
+}
+export {};

package/lib/cjs/bidiMapper/BidiServer.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Copyright 2021 Google LLC.
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BidiServer = void 0;
+const EventEmitter_js_1 = require("../utils/EventEmitter.js");
+const processingQueue_js_1 = require("../utils/processingQueue.js");
+const EventManager_js_1 = require("./domains/events/EventManager.js");
+const CommandProcessor_js_1 = require("./CommandProcessor.js");
+const browsingContextStorage_js_1 = require("./domains/context/browsingContextStorage.js");
+class BidiServer extends EventEmitter_js_1.EventEmitter {
+    #messageQueue;
+    #transport;
+    #commandProcessor;
+    constructor(bidiTransport, cdpConnection, selfTargetId, parser) {
+        super();
+        this.#messageQueue = new processingQueue_js_1.ProcessingQueue(this.#processOutgoingMessage);
+        this.#transport = bidiTransport;
+        this.#transport.setOnMessage(this.#handleIncomingMessage);
+        this.#commandProcessor = new CommandProcessor_js_1.CommandProcessor(cdpConnection, new EventManager_js_1.EventManager(this), selfTargetId, parser);
+        this.#commandProcessor.on('response', (response) => {
+            this.emitOutgoingMessage(response);
+        });
+    }
+    static async createAndStart(bidiTransport, cdpConnection, selfTargetId, parser) {
+        const server = new BidiServer(bidiTransport, cdpConnection, selfTargetId, parser);
+        const cdpClient = cdpConnection.browserClient();
+        // Needed to get events about new targets.
+        await cdpClient.sendCommand('Target.setDiscoverTargets', { discover: true });
+        // Needed to automatically attach to new targets.
+        await cdpClient.sendCommand('Target.setAutoAttach', {
+            autoAttach: true,
+            waitForDebuggerOnStart: true,
+            flatten: true,
+        });
+        await Promise.all(browsingContextStorage_js_1.BrowsingContextStorage.getTopLevelContexts().map((c) => c.awaitLoaded()));
+        return server;
+    }
+    #processOutgoingMessage = async (messageEntry) => {
+        const message = messageEntry.message;
+        if (messageEntry.channel !== null) {
+            message['channel'] = messageEntry.channel;
+        }
+        await this.#transport.sendMessage(message);
+    };
+    /**
+     * Sends BiDi message.
+     */
+    emitOutgoingMessage(messageEntry) {
+        this.#messageQueue.add(messageEntry);
+    }
+    close() {
+        this.#transport.close();
+    }
+    #handleIncomingMessage = async (message) => {
+        this.#commandProcessor.processCommand(message);
+    };
+}
+exports.BidiServer = BidiServer;
+//# sourceMappingURL=BidiServer.js.map

package/lib/cjs/bidiMapper/BidiServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BidiServer.js","sourceRoot":"","sources":["../../../src/bidiMapper/BidiServer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH,8DAAsD;AAItD,oEAA4D;AAE5D,sEAA8D;AAC9D,+DAAmE;AAEnE,2FAAmF;AAMnF,MAAa,UAAW,SAAQ,8BAA8B;IAC5D,aAAa,CAAuC;IACpD,UAAU,CAAgB;IAC1B,iBAAiB,CAAmB;IAEpC,YACE,aAA4B,EAC5B,aAA4B,EAC5B,YAAoB,EACpB,MAAmB;QAEnB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,GAAG,IAAI,oCAAe,CACtC,IAAI,CAAC,uBAAuB,CAC7B,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,aAAa,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC1D,IAAI,CAAC,iBAAiB,GAAG,IAAI,sCAAgB,CAC3C,aAAa,EACb,IAAI,8BAAY,CAAC,IAAI,CAAC,EACtB,YAAY,EACZ,MAAM,CACP,CAAC;QACF,IAAI,CAAC,iBAAiB,CAAC,EAAE,CACvB,UAAU,EACV,CAAC,QAAsC,EAAE,EAAE;YACzC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC,CACF,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,cAAc,CAChC,aAA4B,EAC5B,aAA4B,EAC5B,YAAoB,EACpB,MAAmB;QAEnB,MAAM,MAAM,GAAG,IAAI,UAAU,CAC3B,aAAa,EACb,aAAa,EACb,YAAY,EACZ,MAAM,CACP,CAAC;QACF,MAAM,SAAS,GAAG,aAAa,CAAC,aAAa,EAAE,CAAC;QAEhD,0CAA0C;QAC1C,MAAM,SAAS,CAAC,WAAW,CAAC,2BAA2B,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAC;QAE3E,iDAAiD;QACjD,MAAM,SAAS,CAAC,WAAW,CAAC,sBAAsB,EAAE;YAClD,UAAU,EAAE,IAAI;YAChB,sBAAsB,EAAE,IAAI;YAC5B,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,CACf,kDAAsB,CAAC,mBAAmB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CACzE,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uBAAuB,GAAG,KAAK,EAAE,YAAiC,EAAE,EAAE;QACpE,MAAM,OAAO,GAAG,YAAY,CAAC,OAAc,CAAC;QAE5C,IAAI,YAAY,CAAC,OAAO,KAAK,IAAI,EAAE;YACjC,OAAO,CAAC,SAAS,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC;SAC3C;QAED,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF;;OAEG;IACH,mBAAmB,CAAC,YAA0C;QAC5D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,sBAAsB,GAAG,KAAK,EAAE,OAAkC,EAAE,EAAE;QACpE,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC,CAAC;CACH;AArFD,gCAqFC"}

package/lib/cjs/bidiMapper/BidiTransport.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Copyright 2022 Google LLC.
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { Message } from '../protocol/protocol.js';
+export interface BidiTransport {
+    setOnMessage: (handler: (message: Message.RawCommandRequest) => Promise<void>) => void;
+    sendMessage: (message: Message.OutgoingMessage) => Promise<void>;
+    close(): void;
+}

package/lib/cjs/bidiMapper/BidiTransport.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Copyright 2022 Google LLC.
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=BidiTransport.js.map

package/lib/cjs/bidiMapper/BidiTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BidiTransport.js","sourceRoot":"","sources":["../../../src/bidiMapper/BidiTransport.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG"}

package/lib/cjs/bidiMapper/CdpConnection.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Copyright 2022 Google LLC.
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { ProtocolMapping } from 'devtools-protocol/types/protocol-mapping.js';
+import { EventEmitter } from '../utils/EventEmitter.js';
+declare type CdpEvents = {
+    [Property in keyof ProtocolMapping.Events]: ProtocolMapping.Events[Property][0];
+};
+/**
+ * CDP interfaces that BiDi Mapper expects.
+ */
+export interface CdpConnection {
+    browserClient(): CdpClient;
+    getCdpClient(sessionId: string): CdpClient;
+}
+export interface CdpClient extends EventEmitter<CdpEvents> {
+    sendCommand<T extends keyof ProtocolMapping.Commands>(method: T, ...params: ProtocolMapping.Commands[T]['paramsType']): Promise<ProtocolMapping.Commands[T]['returnType']>;
+}
+export {};

package/lib/cjs/bidiMapper/CdpConnection.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Copyright 2022 Google LLC.
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=CdpConnection.js.map

package/lib/cjs/bidiMapper/CdpConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CdpConnection.js","sourceRoot":"","sources":["../../../src/bidiMapper/CdpConnection.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG"}

package/lib/cjs/bidiMapper/CommandProcessor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Copyright 2021 Google LLC.
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Message, Session, BrowsingContext, Script, CDP } from '../protocol/protocol.js';
+import { CdpConnection } from './CdpConnection.js';
+import { OutgoingBidiMessage } from './OutgoindBidiMessage.js';
+import { IEventManager } from './domains/events/EventManager.js';
+import { EventEmitter } from '../utils/EventEmitter.js';
+declare type CommandProcessorEvents = {
+    response: Promise<OutgoingBidiMessage>;
+};
+export interface BidiParser {
+    parseGetRealmsParams(params: object): Script.GetRealmsParameters;
+    parseCallFunctionParams(params: object): Script.CallFunctionParameters;
+    parseEvaluateParams(params: object): Script.EvaluateParameters;
+    parseDisownParams(params: object): Script.DisownParameters;
+    parseSendCommandParams(params: object): CDP.SendCommandParams;
+    parseGetSessionParams(params: object): CDP.GetSessionParams;
+    parseNavigateParams(params: object): BrowsingContext.NavigateParameters;
+    parseGetTreeParams(params: object): BrowsingContext.GetTreeParameters;
+    parseSubscribeParams(params: object): Session.SubscribeParameters;
+    parseCreateParams(params: object): BrowsingContext.CreateParameters;
+    parseCloseParams(params: object): BrowsingContext.CloseParameters;
+}
+export declare class CommandProcessor extends EventEmitter<CommandProcessorEvents> {
+    #private;
+    constructor(cdpConnection: CdpConnection, eventManager: IEventManager, selfTargetId: string, parser?: BidiParser);
+    processCommand: (command: Message.RawCommandRequest) => Promise<void>;
+}
+export {};