@react-native/dev-middleware 0.75.0-rc.2 → 0.76.0-nightly-20240628-TEMP

package/dist/inspector-proxy/Device.js

@@ -8,6 +8,7 @@ var _DeviceEventReporter = _interopRequireDefault(
   require("./DeviceEventReporter")
 );
 var fs = _interopRequireWildcard(require("fs"));
+var _invariant = _interopRequireDefault(require("invariant"));
 var _nodeFetch = _interopRequireDefault(require("node-fetch"));
 var path = _interopRequireWildcard(require("path"));
 var _ws = _interopRequireDefault(require("ws"));
@@ -54,90 +55,28 @@ function _interopRequireWildcard(obj, nodeInterop) {
 function _interopRequireDefault(obj) {
   return obj && obj.__esModule ? obj : { default: obj };
 }
-/**
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- *
- * @format
- * @oncall react_native
- */
-
 const debug = require("debug")("Metro:InspectorProxy");
 const PAGES_POLLING_INTERVAL = 1000;
-
-// Replace hosts appearing in the `url` and `sourceMapURL` fields of
-// `Debugger.scriptParsed`, and back again in messages from the debugger,
-// to account for device/debugger/proxy running on different networks.
-const REWRITE_HOSTS_TO_LOCALHOST = [
-  // A device may retrieve a bundle through 127.0.0.1 via a (SSH) tunnel, but
-  // the (remote) Metro server may be on a host without an IPv4 loopback, so
-  // 127.0.0.1 may not be addressible locally for (e.g., for source map
-  // fetching). Replacing with the more general 'localhost' should always be
-  // safe while also more compatible with IPv6-only setups.
-  "127.0.0.1",
-  // Android's stock emulator and other emulators such as genymotion use a
-  // standard localhost alias.
-  "10.0.2.2",
-  "10.0.3.2",
-];
-
-// Prefix for script URLs that are alphanumeric IDs. See comment in #processMessageFromDeviceLegacy method for
-// more details.
+const REWRITE_HOSTS_TO_LOCALHOST = ["127.0.0.1", "10.0.2.2", "10.0.3.2"];
 const FILE_PREFIX = "file://";
 const REACT_NATIVE_RELOADABLE_PAGE_ID = "-1";
-
-/**
- * Device class represents single device connection to Inspector Proxy. Each device
- * can have multiple inspectable pages.
- */
 class Device {
-  // ID of the device.
   #id;
-
-  // Name of the device.
   #name;
-
-  // Package name of the app.
   #app;
-
-  // Sequences async processing of messages from device to preserve order. Only
-  // necessary while we need to accommodate #processMessageFromDeviceLegacy's
-  // async fetch.
   #messageFromDeviceQueue = Promise.resolve();
-
-  // Stores socket connection between Inspector Proxy and device.
   #deviceSocket;
-
-  // Stores the most recent listing of device's pages, keyed by the `id` field.
-  #pages;
-
-  // Stores information about currently connected debugger (if any).
+  #pages = new Map();
   #debuggerConnection = null;
-
-  // Last known Page ID of the React Native page.
-  // This is used by debugger connections that don't have PageID specified
-  // (and will interact with the latest React Native page).
   #lastConnectedLegacyReactNativePage = null;
-
-  // Whether we are in the middle of a reload in the REACT_NATIVE_RELOADABLE_PAGE.
   #isLegacyPageReloading = false;
-
-  // The previous "GetPages" message, for deduplication in debug logs.
   #lastGetPagesMessage = "";
-
-  // Mapping built from scriptParsed events and used to fetch file content in `Debugger.getScriptSource`.
   #scriptIdToSourcePathMapping = new Map();
-
-  // Root of the project used for relative to absolute source path conversion.
   #projectRoot;
   #deviceEventReporter;
   #pagesPollingIntervalId;
-
-  // The device message middleware factory function allowing implementers to handle unsupported CDP messages.
   #createCustomMessageHandler;
+  #connectedPageIds = new Set();
   constructor(
     id,
     name,
@@ -146,11 +85,29 @@ class Device {
     projectRoot,
     eventReporter,
     createMessageMiddleware
+  ) {
+    this.#dangerouslyConstruct(
+      id,
+      name,
+      app,
+      socket,
+      projectRoot,
+      eventReporter,
+      createMessageMiddleware
+    );
+  }
+  #dangerouslyConstruct(
+    id,
+    name,
+    app,
+    socket,
+    projectRoot,
+    eventReporter,
+    createMessageMiddleware
   ) {
     this.#id = id;
     this.#name = name;
     this.#app = app;
-    this.#pages = new Map();
     this.#deviceSocket = socket;
     this.#projectRoot = projectRoot;
     this.#deviceEventReporter = eventReporter
@@ -161,14 +118,11 @@ class Device {
         })
       : null;
     this.#createCustomMessageHandler = createMessageMiddleware;
-
-    // $FlowFixMe[incompatible-call]
     this.#deviceSocket.on("message", (message) => {
       this.#messageFromDeviceQueue = this.#messageFromDeviceQueue
         .then(async () => {
           const parsedMessage = JSON.parse(message);
           if (parsedMessage.event === "getPages") {
-            // There's a 'getPages' message every second, so only show them if they change
             if (message !== this.#lastGetPagesMessage) {
               debug(
                 "(Debugger)    (Proxy) <- (Device), getPages ping has changed: " +
@@ -197,7 +151,6 @@ class Device {
           }
         });
     });
-    // Sends 'getPages' request to device every PAGES_POLLING_INTERVAL milliseconds.
     this.#pagesPollingIntervalId = setInterval(
       () =>
         this.#sendMessageToDevice({
@@ -206,15 +159,59 @@ class Device {
       PAGES_POLLING_INTERVAL
     );
     this.#deviceSocket.on("close", () => {
-      this.#deviceEventReporter?.logDisconnection("device");
-      // Device disconnected - close debugger connection.
-      if (this.#debuggerConnection) {
-        this.#debuggerConnection.socket.close();
-        this.#debuggerConnection = null;
+      if (socket === this.#deviceSocket) {
+        this.#deviceEventReporter?.logDisconnection("device");
+        this.#terminateDebuggerConnection();
+        clearInterval(this.#pagesPollingIntervalId);
       }
-      clearInterval(this.#pagesPollingIntervalId);
     });
   }
+  #terminateDebuggerConnection() {
+    const debuggerConnection = this.#debuggerConnection;
+    if (debuggerConnection) {
+      this.#sendDisconnectEventToDevice(
+        this.#mapToDevicePageId(debuggerConnection.pageId)
+      );
+      debuggerConnection.socket.close();
+      this.#debuggerConnection = null;
+    }
+  }
+  dangerouslyRecreateDevice(
+    id,
+    name,
+    app,
+    socket,
+    projectRoot,
+    eventReporter,
+    createMessageMiddleware
+  ) {
+    (0, _invariant.default)(
+      id === this.#id,
+      "dangerouslyRecreateDevice() can only be used for the same device ID"
+    );
+    const oldDebugger = this.#debuggerConnection;
+    if (this.#app !== app || this.#name !== name) {
+      this.#deviceSocket.close();
+      this.#terminateDebuggerConnection();
+    }
+    this.#debuggerConnection = null;
+    if (oldDebugger) {
+      oldDebugger.socket.removeAllListeners();
+      this.#deviceSocket.close();
+      this.handleDebuggerConnection(oldDebugger.socket, oldDebugger.pageId, {
+        userAgent: oldDebugger.userAgent,
+      });
+    }
+    this.#dangerouslyConstruct(
+      id,
+      name,
+      app,
+      socket,
+      projectRoot,
+      eventReporter,
+      createMessageMiddleware
+    );
+  }
   getName() {
     return this.#name;
   }
@@ -228,24 +225,26 @@ class Device {
       return [...this.#pages.values()];
     }
   }
-
-  // Handles new debugger connection to this device:
-  // 1. Sends connect event to device
-  // 2. Forwards all messages from the debugger to device as wrappedEvent
-  // 3. Sends disconnect event to device when debugger connection socket closes.
   handleDebuggerConnection(socket, pageId, metadata) {
-    // Clear any commands we were waiting on.
+    const page =
+      pageId === REACT_NATIVE_RELOADABLE_PAGE_ID
+        ? this.#createSyntheticPage()
+        : this.#pages.get(pageId);
+    if (!page) {
+      debug(
+        `Got new debugger connection for page ${pageId} of ${
+          this.#name
+        }, but no such page exists`
+      );
+      socket.close();
+      return;
+    }
     this.#deviceEventReporter?.logDisconnection("debugger");
+    this.#terminateDebuggerConnection();
     this.#deviceEventReporter?.logConnection("debugger", {
       pageId,
       frontendUserAgent: metadata.userAgent,
     });
-
-    // Disconnect current debugger if we already have debugger connected.
-    if (this.#debuggerConnection) {
-      this.#debuggerConnection.socket.close();
-      this.#debuggerConnection = null;
-    }
     const debuggerInfo = {
       socket,
       prependedFilePrefix: false,
@@ -253,16 +252,9 @@ class Device {
       userAgent: metadata.userAgent,
       customHandler: null,
     };
-
-    // TODO(moti): Handle null case explicitly, e.g. refuse to connect to
-    // unknown pages.
-    const page =
-      pageId === REACT_NATIVE_RELOADABLE_PAGE_ID
-        ? this.#createSyntheticPage()
-        : this.#pages.get(pageId);
     this.#debuggerConnection = debuggerInfo;
     debug(`Got new debugger connection for page ${pageId} of ${this.#name}`);
-    if (page && this.#debuggerConnection && this.#createCustomMessageHandler) {
+    if (this.#debuggerConnection && this.#createCustomMessageHandler) {
       this.#debuggerConnection.customHandler = this.#createCustomMessageHandler(
         {
           page,
@@ -304,14 +296,7 @@ class Device {
         );
       }
     }
-    this.#sendMessageToDevice({
-      event: "connect",
-      payload: {
-        pageId: this.#mapToDevicePageId(pageId),
-      },
-    });
-
-    // $FlowFixMe[incompatible-call]
+    this.#sendConnectEventToDevice(this.#mapToDevicePageId(pageId));
     socket.on("message", (message) => {
       debug("(Debugger) -> (Proxy)    (Device): " + message);
       const debuggerRequest = JSON.parse(message);
@@ -330,7 +315,7 @@ class Device {
       ) {
         return;
       }
-      if (!page || !this.#pageHasCapability(page, "nativeSourceCodeFetching")) {
+      if (!this.#pageHasCapability(page, "nativeSourceCodeFetching")) {
         processedReq = this.#interceptClientMessageForSourceFetching(
           debuggerRequest,
           debuggerInfo,
@@ -350,66 +335,43 @@ class Device {
     socket.on("close", () => {
       debug(`Debugger for page ${pageId} and ${this.#name} disconnected.`);
       this.#deviceEventReporter?.logDisconnection("debugger");
-      this.#sendMessageToDevice({
-        event: "disconnect",
-        payload: {
-          pageId: this.#mapToDevicePageId(pageId),
-        },
-      });
-      this.#debuggerConnection = null;
+      if (this.#debuggerConnection?.socket === socket) {
+        this.#terminateDebuggerConnection();
+      }
     });
-
-    // $FlowFixMe[method-unbinding]
     const sendFunc = socket.send;
-    // $FlowFixMe[cannot-write]
     socket.send = function (message) {
       debug("(Debugger) <- (Proxy)    (Device): " + message);
       return sendFunc.call(socket, message);
     };
   }
-
-  /**
-   * Handles cleaning up a duplicate device connection, by client-side device ID.
-   * 1. Checks if the same device is attempting to reconnect for the same app.
-   * 2. If not, close both the device and debugger socket.
-   * 3. If the debugger connection can be reused, close the device socket only.
-   *
-   * This allows users to reload the app, either as result of a crash, or manually
-   * reloading, without having to restart the debugger.
-   */
-  handleDuplicateDeviceConnection(newDevice) {
-    if (
-      this.#app !== newDevice.getApp() ||
-      this.#name !== newDevice.getName()
-    ) {
-      this.#deviceSocket.close();
-      this.#debuggerConnection?.socket.close();
+  #sendConnectEventToDevice(devicePageId) {
+    if (this.#connectedPageIds.has(devicePageId)) {
+      return;
     }
-    const oldDebugger = this.#debuggerConnection;
-    this.#debuggerConnection = null;
-    if (oldDebugger) {
-      oldDebugger.socket.removeAllListeners();
-      this.#deviceSocket.close();
-      newDevice.handleDebuggerConnection(
-        oldDebugger.socket,
-        oldDebugger.pageId,
-        {
-          userAgent: oldDebugger.userAgent,
-        }
-      );
+    this.#connectedPageIds.add(devicePageId);
+    this.#sendMessageToDevice({
+      event: "connect",
+      payload: {
+        pageId: devicePageId,
+      },
+    });
+  }
+  #sendDisconnectEventToDevice(devicePageId) {
+    if (!this.#connectedPageIds.has(devicePageId)) {
+      return;
     }
+    this.#connectedPageIds.delete(devicePageId);
+    this.#sendMessageToDevice({
+      event: "disconnect",
+      payload: {
+        pageId: devicePageId,
+      },
+    });
   }
-
-  /**
-   * Returns `true` if a page supports the given target capability flag.
-   */
   #pageHasCapability(page, flag) {
     return page.capabilities[flag] === true;
   }
-
-  /**
-   * Returns the synthetic "React Native Experimental (Improved Chrome Reloads)" page.
-   */
   #createSyntheticPage() {
     return {
       id: REACT_NATIVE_RELOADABLE_PAGE_ID,
@@ -419,14 +381,6 @@ class Device {
       capabilities: {},
     };
   }
-
-  // Handles messages received from device:
-  // 1. For getPages responses updates local #pages list.
-  // 2. All other messages are forwarded to debugger as wrappedEvent.
-  //
-  // In the future more logic will be added to this method for modifying
-  // some of the messages (like updating messages with source maps and file
-  // locations).
   async #handleMessageFromDevice(message) {
     if (message.event === "getPages") {
       this.#pages = new Map(
@@ -454,12 +408,6 @@ class Device {
           )}`
         );
       }
-
-      // Check if device has a new legacy React Native page.
-      // There is usually no more than 2-3 pages per device so this operation
-      // is not expensive.
-      // TODO(hypuk): It is better for VM to send update event when new page is
-      // created instead of manually checking this on every getPages result.
       for (const page of this.#pages.values()) {
         if (this.#pageHasCapability(page, "nativePageReloads")) {
           continue;
@@ -472,11 +420,7 @@ class Device {
         }
       }
     } else if (message.event === "disconnect") {
-      // Device sends disconnect events only when page is reloaded or
-      // if debugger socket was disconnected.
       const pageId = message.payload.pageId;
-      // TODO(moti): Handle null case explicitly, e.g. swallow disconnect events
-      // for unknown pages.
       const page = this.#pages.get(pageId);
       if (page != null && this.#pageHasCapability(page, "nativePageReloads")) {
         return;
@@ -501,17 +445,11 @@ class Device {
       if (this.#debuggerConnection == null) {
         return;
       }
-
-      // FIXME: Is it possible that we received message for pageID that does not
-      // correspond to current debugger connection?
-      // TODO(moti): yes, fix multi-debugger case
-
       const debuggerSocket = this.#debuggerConnection.socket;
       if (
         debuggerSocket == null ||
         debuggerSocket.readyState !== _ws.default.OPEN
       ) {
-        // TODO(hypuk): Send error back to device?
         return;
       }
       const parsedPayload = JSON.parse(message.payload.wrappedEvent);
@@ -544,8 +482,6 @@ class Device {
       }
     }
   }
-
-  // Sends single message to device.
   #sendMessageToDevice(message) {
     try {
       if (message.event !== "getPages") {
@@ -554,43 +490,22 @@ class Device {
       this.#deviceSocket.send(JSON.stringify(message));
     } catch (error) {}
   }
-
-  // We received new React Native Page ID.
   #newLegacyReactNativePage(page) {
     debug(`React Native page updated to ${page.id}`);
     if (
       this.#debuggerConnection == null ||
       this.#debuggerConnection.pageId !== REACT_NATIVE_RELOADABLE_PAGE_ID
     ) {
-      // We can just remember new page ID without any further actions if no
-      // debugger is currently attached or attached debugger is not
-      // "Reloadable React Native" connection.
       this.#lastConnectedLegacyReactNativePage = page;
       return;
     }
     const oldPageId = this.#lastConnectedLegacyReactNativePage?.id;
     this.#lastConnectedLegacyReactNativePage = page;
     this.#isLegacyPageReloading = true;
-
-    // We already had a debugger connected to React Native page and a
-    // new one appeared - in this case we need to emulate execution context
-    // detroy and resend Debugger.enable and Runtime.enable commands to new
-    // page.
-
     if (oldPageId != null) {
-      this.#sendMessageToDevice({
-        event: "disconnect",
-        payload: {
-          pageId: oldPageId,
-        },
-      });
+      this.#sendDisconnectEventToDevice(oldPageId);
     }
-    this.#sendMessageToDevice({
-      event: "connect",
-      payload: {
-        pageId: page.id,
-      },
-    });
+    this.#sendConnectEventToDevice(page.id);
     const toSend = [
       {
         method: "Runtime.enable",
@@ -617,15 +532,8 @@ class Device {
       });
     }
   }
-
-  // Allows to make changes in incoming message from device.
   async #processMessageFromDeviceLegacy(payload, debuggerInfo, pageId) {
-    // TODO(moti): Handle null case explicitly, or ideally associate a copy
-    // of the page metadata object with the connection so this can never be
-    // null.
     const page = pageId != null ? this.#pages.get(pageId) : null;
-
-    // Replace Android addresses for scriptParsed event.
     if (
       (!page || !this.#pageHasCapability(page, "nativeSourceCodeFetching")) &&
       payload.method === "Debugger.scriptParsed" &&
@@ -635,7 +543,6 @@ class Device {
       if ("sourceMapURL" in params) {
         for (const hostToRewrite of REWRITE_HOSTS_TO_LOCALHOST) {
           if (params.sourceMapURL.includes(hostToRewrite)) {
-            // $FlowFixMe[cannot-write]
             payload.params.sourceMapURL = params.sourceMapURL.replace(
               hostToRewrite,
               "localhost"
@@ -645,14 +552,8 @@ class Device {
         }
         const sourceMapURL = this.#tryParseHTTPURL(params.sourceMapURL);
         if (sourceMapURL) {
-          // Some debug clients do not support fetching HTTP URLs. If the
-          // message headed to the debug client identifies the source map with
-          // an HTTP URL, fetch the content here and convert the content to a
-          // Data URL (which is more widely supported) before passing the
-          // message to the debug client.
           try {
             const sourceMap = await this.#fetchText(sourceMapURL);
-            // $FlowFixMe[cannot-write]
             payload.params.sourceMapURL =
               "data:application/json;charset=utf-8;base64," +
               Buffer.from(sourceMap).toString("base64");
@@ -666,23 +567,14 @@ class Device {
       if ("url" in params) {
         for (const hostToRewrite of REWRITE_HOSTS_TO_LOCALHOST) {
           if (params.url.includes(hostToRewrite)) {
-            // $FlowFixMe[cannot-write]
             payload.params.url = params.url.replace(hostToRewrite, "localhost");
             debuggerInfo.originalSourceURLAddress = hostToRewrite;
           }
         }
-
-        // Chrome doesn't download source maps if URL param is not a valid
-        // URL. Some frameworks pass alphanumeric script ID instead of URL which causes
-        // Chrome to not download source maps. In this case we want to prepend script ID
-        // with 'file://' prefix.
         if (payload.params.url.match(/^[0-9a-z]+$/)) {
-          // $FlowFixMe[cannot-write]
           payload.params.url = FILE_PREFIX + payload.params.url;
           debuggerInfo.prependedFilePrefix = true;
         }
-
-        // $FlowFixMe[prop-missing]
         if (params.scriptId != null) {
           this.#scriptIdToSourcePathMapping.set(params.scriptId, params.url);
         }
@@ -692,22 +584,11 @@ class Device {
       payload.method === "Runtime.executionContextCreated" &&
       this.#isLegacyPageReloading
     ) {
-      // The new context is ready. First notify Chrome that we've reloaded so
-      // it'll resend its breakpoints. If we do this earlier, we may not be
-      // ready to receive them.
       debuggerInfo.socket.send(
         JSON.stringify({
           method: "Runtime.executionContextsCleared",
         })
       );
-
-      // The VM starts in a paused mode. Ask it to resume.
-      // Note that if setting breakpoints in early initialization functions,
-      // there's a currently race condition between these functions executing
-      // and Chrome re-applying the breakpoints due to the message above.
-      //
-      // This is not an issue in VSCode/Nuclide where the IDE knows to resume
-      // at its convenience.
       const resumeMessage = {
         method: "Debugger.resume",
         id: 0,
@@ -729,18 +610,11 @@ class Device {
       this.#isLegacyPageReloading = false;
     }
   }
-
-  /**
-   * Intercept an incoming message from a connected debugger. Returns either an
-   * original/replacement CDP message object, or `null` (will forward nothing
-   * to the target).
-   */
   #interceptClientMessageForSourceFetching(req, debuggerInfo, socket) {
     switch (req.method) {
       case "Debugger.setBreakpointByUrl":
         return this.#processDebuggerSetBreakpointByUrl(req, debuggerInfo);
       case "Debugger.getScriptSource":
-        // Sends response to debugger via side-effect
         this.#processDebuggerGetScriptSource(req, socket);
         return null;
       default:
@@ -748,7 +622,6 @@ class Device {
     }
   }
   #processDebuggerSetBreakpointByUrl(req, debuggerInfo) {
-    // If we replaced Android emulator's address to localhost we need to change it back.
     if (debuggerInfo.originalSourceURLAddress != null) {
       const processedReq = {
         ...req,
@@ -766,8 +639,6 @@ class Device {
           processedReq.params.url.startsWith(FILE_PREFIX) &&
           debuggerInfo.prependedFilePrefix
         ) {
-          // Remove fake URL prefix if we modified URL in #processMessageFromDeviceLegacy.
-          // $FlowFixMe[incompatible-use]
           processedReq.params.url = processedReq.params.url.slice(
             FILE_PREFIX.length
           );
@@ -776,7 +647,6 @@ class Device {
       if (processedReq.params.urlRegex != null) {
         processedReq.params.urlRegex = processedReq.params.urlRegex.replace(
           /localhost/g,
-          // $FlowFixMe[incompatible-call]
           debuggerInfo.originalSourceURLAddress
         );
       }
@@ -801,8 +671,6 @@ class Device {
       });
     };
     const sendErrorResponse = (error) => {
-      // Tell the client that the request failed
-
       const response = {
         id: req.id,
         result: {
@@ -812,8 +680,6 @@ class Device {
         },
       };
       socket.send(JSON.stringify(response));
-
-      // Send to the console as well, so the user can see it
       this.#sendErrorToDebugger(error);
       const pageId = this.#debuggerConnection?.pageId ?? null;
       this.#deviceEventReporter?.logResponse(response, "proxy", {
@@ -874,18 +740,12 @@ class Device {
     }
     return parsedURL;
   }
-
-  // Fetch text, raising an exception if the text could not be fetched,
-  // or is too large.
   async #fetchText(url) {
-    // $FlowFixMe[incompatible-call] Suppress arvr node-fetch flow error
     const response = await (0, _nodeFetch.default)(url);
     if (!response.ok) {
       throw new Error("HTTP " + response.status + " " + response.statusText);
     }
     const text = await response.text();
-    // Restrict the length to well below the 500MB limit for nodejs (leaving
-    // room some some later manipulation, e.g. base64 or wrapping in JSON)
     if (text.length > 350000000) {
       throw new Error("file too large to fetch via HTTP");
     }
@@ -918,5 +778,8 @@ class Device {
     }
     return this.#pageHasCapability(page, "prefersFuseboxFrontend");
   }
+  dangerouslyGetSocket() {
+    return this.#deviceSocket;
+  }
 }
 exports.default = Device;

package/dist/inspector-proxy/Device.js.flow

@@ -29,6 +29,15 @@ declare export default class Device {
     eventReporter: ?EventReporter,
     createMessageMiddleware: ?CreateCustomMessageHandlerFn
   ): void;
+  dangerouslyRecreateDevice(
+    id: string,
+    name: string,
+    app: string,
+    socket: WS,
+    projectRoot: string,
+    eventReporter: ?EventReporter,
+    createMessageMiddleware: ?CreateCustomMessageHandlerFn
+  ): void;
   getName(): string;
   getApp(): string;
   getPagesList(): $ReadOnlyArray<Page>;
@@ -39,5 +48,5 @@ declare export default class Device {
       userAgent: string | null,
     }>
   ): void;
-  handleDuplicateDeviceConnection(newDevice: Device): void;
+  dangerouslyGetSocket(): WS;
 }