[js] Add Javascript/Typescript CDDL code generator for WebDriver BiDi (#17574)

* [js] Add Javascript/Typescript CDDL code generator for WebDriver BiDi

* Fix linting

* [js] Add Javascript/Typescript CDDL code generator for WebDriver BiDi

* Fix linting

* [js] Add Javascript/Typescript CDDL code generator for WebDriver BiDi

* Fix linting

* [js] Fix enhancements manifest issues found in code review

- back()/forward(): accept a context id instead of hard-coding an empty
  string; delegate to traverseHistory({ context, delta: ±1 })
- continueWithAuth: replace username!/password! non-null assertions with
  an explicit undefined guard that throws a descriptive error
- continueWithAuth: capture bidi.send() response and apply the same
  response['type'] === 'error' check as generated methods, preventing
  silent failures

* ...

* [js] Update comment for changes made to index.js

* [js] Emit BiDi events via EventEmitter in bidi/index.js

* Fix linting

Author: pujagani

.gitignore

@@ -100,6 +100,9 @@ obj/
 *.aps
 launchSettings.json
 Generated/
+# Un-ignore the hand-written tests for the generated BiDi domain API (macOS
+# case-insensitive filesystem would otherwise match "Generated/" above).
+!javascript/selenium-webdriver/test/bidi/generated/
 ipch/
 /iedriver.log
 /phantomjsdriver.log

javascript/selenium-webdriver/BUILD.bazel

@@ -1,5 +1,5 @@
 load("@aspect_bazel_lib//lib:copy_to_bin.bzl", "copy_to_bin")
-load("@aspect_rules_js//js:defs.bzl", "js_library")
+load("@aspect_rules_js//js:defs.bzl", "js_binary", "js_library")
 load("@aspect_rules_js//npm:defs.bzl", "npm_package")
 load("@npm//:defs.bzl", "npm_link_all_packages")
 load("@npm//javascript/selenium-webdriver:eslint/package_json.bzl", eslint_bin = "bin")
@@ -10,9 +10,37 @@ load("//common:defs.bzl", "copy_file")
 load("//javascript:defs.bzl", "mocha_test")
 load("//javascript/private:browsers.bzl", "BROWSERS")
 load("//javascript/private:jsdoc.bzl", "jsdoc")
+load("//javascript/selenium-webdriver/private:generate_bidi.bzl", "generate_bidi_library")
 
 npm_link_all_packages(name = "node_modules")
 
+# Generator script that reads the merged CDDL spec and produces one .ts file per BiDi domain.
+js_binary(
+    name = "generate_bidi_script",
+    data = [
+        "generate_bidi.mjs",
+        ":node_modules/cddl",
+        ":node_modules/cddl2ts",
+    ],
+    entry_point = "generate_bidi.mjs",
+)
+
+# Generate WebDriver BiDi TypeScript modules from CDDL specification.
+# extra_cddl_files are merged with the primary BiDi spec before generation so that
+# adjacent specs (Permissions, Prefetch, UA Client Hints, Web Bluetooth) are included.
+generate_bidi_library(
+    name = "create-bidi-src",
+    cddl_file = "@webdriver_bidi_all_cddl//file:spec.cddl",
+    enhancements_manifest = "//javascript/selenium-webdriver/private:bidi_enhancements_manifest",
+    extra_cddl_files = [
+        "@permissions_all_cddl//file:spec.cddl",
+        "@prefetch_all_cddl//file:spec.cddl",
+        "@ua_client_hints_all_cddl//file:spec.cddl",
+        "@web_bluetooth_all_cddl//file:spec.cddl",
+    ],
+    spec_version = "1.0",
+)
+
 VERSION = "4.45.0-nightly202605121853"
 
 BROWSER_VERSIONS = [
@@ -53,6 +81,7 @@ js_library(
 npm_package(
     name = "selenium-webdriver",
     srcs = [
+        ":create-bidi-src",
         ":license",
         ":manager-linux",
         ":manager-macos",

javascript/selenium-webdriver/bidi/index.js

@@ -79,10 +79,31 @@ class Index extends EventEmitter {
         }
         return
       }
-      // Messages without a numeric id are BiDi events, not command
-      // responses; they are routed via subscribe/EventEmitter elsewhere
-      // and intentionally ignored by this dispatcher.
+      // Messages without a numeric id are BiDi events, not command responses.
+      // Re-emit them on this EventEmitter by method name (e.g.
+      // 'browsingContext.contextCreated') so that generated domain classes can
+      // subscribe via bidi.on(methodName, callback) instead of each attaching
+      // a new raw ws.on('message', ...) listener.  The existing hand-written
+      // modules (logInspector, network, etc.) continue to use their own
+      // ws.on('message', ...) listeners unchanged — this emission is purely
+      // additive and does not affect those code paths.
       if (payload == null || typeof payload.id !== 'number') {
+        if (payload != null && typeof payload.method === 'string') {
+          // 'error' is a reserved EventEmitter event — emitting it without a
+          // listener throws and crashes the process. Route any peer-supplied
+          // method named 'error' through the same guarded path used for JSON
+          // parse failures rather than forwarding it directly.
+          if (payload.method === 'error') {
+            const err = new Error(`BiDi protocol error event: ${JSON.stringify(payload.params)}`)
+            if (this.listenerCount('error') > 0) {
+              this.emit('error', err)
+            } else {
+              process.emitWarning(err.message, 'BiDiProtocolWarning')
+            }
+          } else {
+            this.emit(payload.method, payload.params)
+          }
+        }
         return
       }
       const entry = this._pending.get(payload.id)