@depup/react-native__dev-middleware 0.84.1-depup.1

package/README.md

@@ -0,0 +1,38 @@
+# @depup/react-native__dev-middleware
+
+> Dependency-bumped version of [@react-native/dev-middleware](https://www.npmjs.com/package/@react-native/dev-middleware)
+
+Generated by [DepUp](https://github.com/depup/npm) -- all production
+dependencies bumped to latest versions.
+
+## Installation
+
+```bash
+npm install @depup/react-native__dev-middleware
+```
+
+| Field | Value |
+|-------|-------|
+| Original | [@react-native/dev-middleware](https://www.npmjs.com/package/@react-native/dev-middleware) @ 0.84.1 |
+| Processed | 2026-03-21 |
+| Smoke test | failed |
+| Deps updated | 8 |
+
+## Dependency Changes
+
+| Dependency | From | To |
+|------------|------|-----|
+| @isaacs/ttlcache | ^1.4.1 | ^2.1.4 |
+| chrome-launcher | ^0.15.2 | ^1.2.1 |
+| chromium-edge-launcher | ^0.2.0 | ^0.3.0 |
+| connect | ^3.6.5 | ^3.7.0 |
+| debug | ^4.4.0 | ^4.4.3 |
+| open | ^7.0.3 | ^11.0.0 |
+| serve-static | ^1.16.2 | ^2.2.1 |
+| ws | ^7.5.10 | ^8.20.0 |
+
+---
+
+Source: https://github.com/depup/npm | Original: https://www.npmjs.com/package/@react-native/dev-middleware
+
+License inherited from the original package.

package/changes.json

@@ -0,0 +1,38 @@
+{
+  "bumped": {
+    "@isaacs/ttlcache": {
+      "from": "^1.4.1",
+      "to": "^2.1.4"
+    },
+    "chrome-launcher": {
+      "from": "^0.15.2",
+      "to": "^1.2.1"
+    },
+    "chromium-edge-launcher": {
+      "from": "^0.2.0",
+      "to": "^0.3.0"
+    },
+    "connect": {
+      "from": "^3.6.5",
+      "to": "^3.7.0"
+    },
+    "debug": {
+      "from": "^4.4.0",
+      "to": "^4.4.3"
+    },
+    "open": {
+      "from": "^7.0.3",
+      "to": "^11.0.0"
+    },
+    "serve-static": {
+      "from": "^1.16.2",
+      "to": "^2.2.1"
+    },
+    "ws": {
+      "from": "^7.5.10",
+      "to": "^8.20.0"
+    }
+  },
+  "timestamp": "2026-03-21T20:09:16.980Z",
+  "totalUpdated": 8
+}

package/dist/createDevMiddleware.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 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
+ */
+
+import type { CreateCustomMessageHandlerFn } from "./inspector-proxy/CustomMessageHandler";
+import type { BrowserLauncher } from "./types/BrowserLauncher";
+import type { EventReporter } from "./types/EventReporter";
+import type { ExperimentsConfig } from "./types/Experiments";
+import type { Logger } from "./types/Logger";
+import type { NextHandleFunction } from "connect";
+type Options = Readonly<{
+  /**
+   * The base URL to the dev server, as reachable from the machine on which
+   * dev-middleware is hosted. Typically `http://localhost:${metroPort}`.
+   */
+  serverBaseUrl: string;
+  logger?: Logger;
+  /**
+   * An interface for integrators to provide a custom implementation for
+   * opening URLs in a web browser.
+   *
+   * This is an unstable API with no semver guarantees.
+   */
+  unstable_browserLauncher?: BrowserLauncher;
+  /**
+   * An interface for logging events.
+   *
+   * This is an unstable API with no semver guarantees.
+   */
+  unstable_eventReporter?: EventReporter;
+  /**
+   * The set of experimental features to enable.
+   *
+   * This is an unstable API with no semver guarantees.
+   */
+  unstable_experiments?: ExperimentsConfig;
+  /**
+   * Create custom handler to add support for unsupported CDP events, or debuggers.
+   * This handler is instantiated per logical device and debugger pair.
+   *
+   * This is an unstable API with no semver guarantees.
+   */
+  unstable_customInspectorMessageHandler?: CreateCustomMessageHandlerFn;
+  /**
+   * Whether to measure the event loop performance of inspector proxy and log report it via the event reporter.
+   *
+   * This is an unstable API with no semver guarantees.
+   */
+  unstable_trackInspectorProxyEventLoopPerf?: boolean;
+}>;
+type DevMiddlewareAPI = Readonly<{
+  middleware: NextHandleFunction;
+  websocketEndpoints: { [path: string]: ws$WebSocketServer };
+}>;
+declare function createDevMiddleware($$PARAM_0$$: Options): DevMiddlewareAPI;
+export default createDevMiddleware;

package/dist/createDevMiddleware.js

@@ -0,0 +1,140 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.default = createDevMiddleware;
+var _InspectorProxy = _interopRequireDefault(
+  require("./inspector-proxy/InspectorProxy"),
+);
+var _openDebuggerMiddleware = _interopRequireDefault(
+  require("./middleware/openDebuggerMiddleware"),
+);
+var _DefaultBrowserLauncher = _interopRequireDefault(
+  require("./utils/DefaultBrowserLauncher"),
+);
+var _debuggerFrontend = _interopRequireDefault(
+  require("@react-native/debugger-frontend"),
+);
+var _connect = _interopRequireDefault(require("connect"));
+var _path = _interopRequireDefault(require("path"));
+var _serveStatic = _interopRequireDefault(require("serve-static"));
+function _interopRequireDefault(e) {
+  return e && e.__esModule ? e : { default: e };
+}
+function createDevMiddleware({
+  serverBaseUrl,
+  logger,
+  unstable_browserLauncher = _DefaultBrowserLauncher.default,
+  unstable_eventReporter,
+  unstable_experiments: experimentConfig = {},
+  unstable_customInspectorMessageHandler,
+  unstable_trackInspectorProxyEventLoopPerf = false,
+}) {
+  const experiments = getExperiments(experimentConfig);
+  const eventReporter = createWrappedEventReporter(
+    unstable_eventReporter,
+    logger,
+    experiments,
+  );
+  const inspectorProxy = new _InspectorProxy.default(
+    serverBaseUrl,
+    eventReporter,
+    experiments,
+    logger,
+    unstable_customInspectorMessageHandler,
+    unstable_trackInspectorProxyEventLoopPerf,
+  );
+  const middleware = (0, _connect.default)()
+    .use(
+      "/open-debugger",
+      (0, _openDebuggerMiddleware.default)({
+        serverBaseUrl,
+        inspectorProxy,
+        browserLauncher: unstable_browserLauncher,
+        eventReporter,
+        experiments,
+        logger,
+      }),
+    )
+    .use(
+      "/debugger-frontend/embedder-static/embedderScript.js",
+      (_req, res) => {
+        res.setHeader("Content-Type", "application/javascript");
+        res.end("");
+      },
+    )
+    .use(
+      "/debugger-frontend",
+      (0, _serveStatic.default)(_path.default.join(_debuggerFrontend.default), {
+        fallthrough: false,
+      }),
+    )
+    .use((...args) => inspectorProxy.processRequest(...args));
+  return {
+    middleware,
+    websocketEndpoints: inspectorProxy.createWebSocketListeners(),
+  };
+}
+function getExperiments(config) {
+  return {
+    enableOpenDebuggerRedirect: config.enableOpenDebuggerRedirect ?? false,
+    enableNetworkInspector: config.enableNetworkInspector ?? false,
+    enableStandaloneFuseboxShell: config.enableStandaloneFuseboxShell ?? true,
+  };
+}
+function createWrappedEventReporter(reporter, logger, experiments) {
+  return {
+    logEvent(event) {
+      switch (event.type) {
+        case "profiling_target_registered":
+          logger?.info(
+            "Profiling build target '%s' registered for debugging",
+            event.appId ?? "unknown",
+          );
+          break;
+        case "fusebox_console_notice":
+          logger?.info(
+            "\u001B[1m\u001B[7m💡 JavaScript logs have moved!\u001B[22m They can now be " +
+              "viewed in React Native DevTools. Tip: Type \u001B[1mj\u001B[22m in " +
+              "the terminal to open" +
+              (experiments.enableStandaloneFuseboxShell
+                ? ""
+                : " (requires Google Chrome or Microsoft Edge)") +
+              ".\u001B[27m",
+          );
+          break;
+        case "fusebox_shell_preparation_attempt":
+          switch (event.result.code) {
+            case "success":
+            case "not_implemented":
+              break;
+            case "unexpected_error": {
+              let message =
+                event.result.humanReadableMessage ??
+                "An unknown error occurred while installing React Native DevTools.";
+              if (event.result.verboseInfo != null) {
+                message += ` Details:\n\n${event.result.verboseInfo}`;
+              } else {
+                message += ".";
+              }
+              logger?.error(message);
+              break;
+            }
+            case "possible_corruption":
+            case "platform_not_supported":
+            case "likely_offline":
+              logger?.warn(
+                event.result.humanReadableMessage ??
+                  `An error of type ${event.result.code} occurred while installing React Native DevTools.`,
+              );
+              break;
+            default:
+              event.result.code;
+              break;
+          }
+      }
+      reporter?.logEvent(event);
+    },
+  };
+}

package/dist/createDevMiddleware.js.flow

@@ -0,0 +1,72 @@
+/**
+ * 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.
+ *
+ * @flow strict-local
+ * @format
+ */
+
+import type { CreateCustomMessageHandlerFn } from "./inspector-proxy/CustomMessageHandler";
+import type { BrowserLauncher } from "./types/BrowserLauncher";
+import type { EventReporter } from "./types/EventReporter";
+import type { ExperimentsConfig } from "./types/Experiments";
+import type { Logger } from "./types/Logger";
+import type { NextHandleFunction } from "connect";
+
+type Options = $ReadOnly<{
+  /**
+   * The base URL to the dev server, as reachable from the machine on which
+   * dev-middleware is hosted. Typically `http://localhost:${metroPort}`.
+   */
+  serverBaseUrl: string,
+
+  logger?: Logger,
+
+  /**
+   * An interface for integrators to provide a custom implementation for
+   * opening URLs in a web browser.
+   *
+   * This is an unstable API with no semver guarantees.
+   */
+  unstable_browserLauncher?: BrowserLauncher,
+
+  /**
+   * An interface for logging events.
+   *
+   * This is an unstable API with no semver guarantees.
+   */
+  unstable_eventReporter?: EventReporter,
+
+  /**
+   * The set of experimental features to enable.
+   *
+   * This is an unstable API with no semver guarantees.
+   */
+  unstable_experiments?: ExperimentsConfig,
+
+  /**
+   * Create custom handler to add support for unsupported CDP events, or debuggers.
+   * This handler is instantiated per logical device and debugger pair.
+   *
+   * This is an unstable API with no semver guarantees.
+   */
+  unstable_customInspectorMessageHandler?: CreateCustomMessageHandlerFn,
+
+  /**
+   * Whether to measure the event loop performance of inspector proxy and log report it via the event reporter.
+   *
+   * This is an unstable API with no semver guarantees.
+   */
+  unstable_trackInspectorProxyEventLoopPerf?: boolean,
+}>;
+
+type DevMiddlewareAPI = $ReadOnly<{
+  middleware: NextHandleFunction,
+  websocketEndpoints: { [path: string]: ws$WebSocketServer },
+}>;
+
+declare export default function createDevMiddleware(
+  $$PARAM_0$$: Options,
+): DevMiddlewareAPI;

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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
+ */
+
+export type {
+  BrowserLauncher,
+  DebuggerShellPreparationResult,
+} from "./types/BrowserLauncher";
+export type { EventReporter, ReportableEvent } from "./types/EventReporter";
+export type {
+  CustomMessageHandler,
+  CustomMessageHandlerConnection,
+  CreateCustomMessageHandlerFn,
+} from "./inspector-proxy/CustomMessageHandler";
+export type { Logger } from "./types/Logger";
+export { default as unstable_DefaultBrowserLauncher } from "./utils/DefaultBrowserLauncher";
+export { default as createDevMiddleware } from "./createDevMiddleware";

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+Object.defineProperty(exports, "createDevMiddleware", {
+  enumerable: true,
+  get: function () {
+    return _createDevMiddleware.default;
+  },
+});
+Object.defineProperty(exports, "unstable_DefaultBrowserLauncher", {
+  enumerable: true,
+  get: function () {
+    return _DefaultBrowserLauncher.default;
+  },
+});
+var _DefaultBrowserLauncher = _interopRequireDefault(
+  require("./utils/DefaultBrowserLauncher"),
+);
+var _createDevMiddleware = _interopRequireDefault(
+  require("./createDevMiddleware"),
+);
+function _interopRequireDefault(e) {
+  return e && e.__esModule ? e : { default: e };
+}

package/dist/index.js.flow

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ *
+ * @flow strict-local
+ * @format
+ */
+
+export type {
+  BrowserLauncher,
+  DebuggerShellPreparationResult,
+} from "./types/BrowserLauncher";
+export type { EventReporter, ReportableEvent } from "./types/EventReporter";
+export type {
+  CustomMessageHandler,
+  CustomMessageHandlerConnection,
+  CreateCustomMessageHandlerFn,
+} from "./inspector-proxy/CustomMessageHandler";
+export type { Logger } from "./types/Logger";
+
+export { default as unstable_DefaultBrowserLauncher } from "./utils/DefaultBrowserLauncher";
+export { default as createDevMiddleware } from "./createDevMiddleware";

package/dist/inspector-proxy/CdpDebugLogging.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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
+ */
+
+export type CDPMessageDestination =
+  | "DebuggerToProxy"
+  | "ProxyToDebugger"
+  | "DeviceToProxy"
+  | "ProxyToDevice";
+declare class CdpDebugLogging {
+  constructor();
+  log(destination: CDPMessageDestination, message: string): void;
+}
+export default CdpDebugLogging;

package/dist/inspector-proxy/CdpDebugLogging.js

@@ -0,0 +1,117 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.default = void 0;
+var _timers = require("timers");
+var _util = _interopRequireDefault(require("util"));
+function _interopRequireDefault(e) {
+  return e && e.__esModule ? e : { default: e };
+}
+const debug = require("debug")("Metro:InspectorProxy");
+const debugCDPMessages = require("debug")("Metro:InspectorProxyCDPMessages");
+const CDP_MESSAGES_BATCH_DEBUGGING_THROTTLE_MS = 5000;
+function getCDPLogPrefix(destination) {
+  return _util.default.format(
+    "[(Debugger) %s (Proxy) %s (Device)]",
+    destination === "DebuggerToProxy"
+      ? "->"
+      : destination === "ProxyToDebugger"
+        ? "<-"
+        : "  ",
+    destination === "ProxyToDevice"
+      ? "->"
+      : destination === "DeviceToProxy"
+        ? "<-"
+        : "  ",
+  );
+}
+class CdpDebugLogging {
+  #cdpMessagesLoggingBatchingFn = {
+    DebuggerToProxy: () => {},
+    ProxyToDebugger: () => {},
+    DeviceToProxy: () => {},
+    ProxyToDevice: () => {},
+  };
+  constructor() {
+    if (debug.enabled) {
+      this.#initializeThrottledCDPMessageLogging();
+    }
+  }
+  #initializeThrottledCDPMessageLogging() {
+    const batchingCounters = {
+      DebuggerToProxy: {
+        count: 0,
+        size: 0,
+      },
+      ProxyToDebugger: {
+        count: 0,
+        size: 0,
+      },
+      DeviceToProxy: {
+        count: 0,
+        size: 0,
+      },
+      ProxyToDevice: {
+        count: 0,
+        size: 0,
+      },
+    };
+    Object.keys(batchingCounters).forEach((destination) => {
+      let timeout = null;
+      this.#cdpMessagesLoggingBatchingFn[destination] = (message) => {
+        if (message.length > 1024 * 100) {
+          const messagePreview = JSON.stringify(
+            JSON.parse(message, (key, value) => {
+              if (Array.isArray(value)) {
+                return "[ARRAY]";
+              }
+              if (typeof value === "string" && value.length > 50) {
+                return value.slice(0, 50) + "...";
+              }
+              return value;
+            }),
+            null,
+            2,
+          );
+          debug(
+            "%s A large message (%s MB) was %s- %s",
+            getCDPLogPrefix(destination),
+            (message.length / (1024 * 1024)).toFixed(2),
+            destination.startsWith("Proxy") ? "  sent  " : "received",
+            messagePreview,
+          );
+        }
+        if (timeout == null) {
+          timeout = (0, _timers.setTimeout)(() => {
+            debug(
+              "%s %s CDP messages of size %s MB %s in the last %ss.",
+              getCDPLogPrefix(destination),
+              String(batchingCounters[destination].count).padStart(4),
+              String(
+                (batchingCounters[destination].size / (1024 * 1024)).toFixed(2),
+              ).padStart(6),
+              destination.startsWith("Proxy") ? "  sent  " : "received",
+              CDP_MESSAGES_BATCH_DEBUGGING_THROTTLE_MS / 1000,
+            );
+            batchingCounters[destination].count = 0;
+            batchingCounters[destination].size = 0;
+            timeout = null;
+          }, CDP_MESSAGES_BATCH_DEBUGGING_THROTTLE_MS).unref();
+        }
+        batchingCounters[destination].count++;
+        batchingCounters[destination].size += message.length;
+      };
+    });
+  }
+  log(destination, message) {
+    if (debugCDPMessages.enabled) {
+      debugCDPMessages("%s message: %s", getCDPLogPrefix(destination), message);
+    }
+    if (debug.enabled) {
+      this.#cdpMessagesLoggingBatchingFn[destination](message);
+    }
+  }
+}
+exports.default = CdpDebugLogging;

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

@@ -0,0 +1,20 @@
+/**
+ * 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.
+ *
+ * @flow strict-local
+ * @format
+ */
+
+export type CDPMessageDestination =
+  | "DebuggerToProxy"
+  | "ProxyToDebugger"
+  | "DeviceToProxy"
+  | "ProxyToDevice";
+
+declare export default class CdpDebugLogging {
+  constructor(): void;
+  log(destination: CDPMessageDestination, message: string): void;
+}

package/dist/inspector-proxy/CustomMessageHandler.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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
+ */
+
+import type { JSONSerializable, Page } from "./types";
+type ExposedDevice = Readonly<{
+  appId: string;
+  id: string;
+  name: string;
+  sendMessage: (message: JSONSerializable) => void;
+}>;
+type ExposedDebugger = Readonly<{
+  userAgent: string | null;
+  sendMessage: (message: JSONSerializable) => void;
+}>;
+export type CustomMessageHandlerConnection = Readonly<{
+  page: Page;
+  device: ExposedDevice;
+  debugger: ExposedDebugger;
+}>;
+export type CreateCustomMessageHandlerFn = (
+  connection: CustomMessageHandlerConnection,
+) => null | undefined | CustomMessageHandler;
+/**
+ * The device message middleware allows implementers to handle unsupported CDP messages.
+ * It is instantiated per device and may contain state that is specific to that device.
+ * The middleware can also mark messages from the device or debugger as handled, which stops propagating.
+ */
+export interface CustomMessageHandler {
+  /**
+   * Handle a CDP message coming from the device.
+   * This is invoked before the message is sent to the debugger.
+   * When returning true, the message is considered handled and will not be sent to the debugger.
+   */
+  handleDeviceMessage(message: JSONSerializable): true | void;
+  /**
+   * Handle a CDP message coming from the debugger.
+   * This is invoked before the message is sent to the device.
+   * When returning true, the message is considered handled and will not be sent to the device.
+   */
+  handleDebuggerMessage(message: JSONSerializable): true | void;
+}

package/dist/inspector-proxy/CustomMessageHandler.js

@@ -0,0 +1 @@
+"use strict";

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

@@ -0,0 +1,54 @@
+/**
+ * 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.
+ *
+ * @flow strict-local
+ * @format
+ */
+
+import type { JSONSerializable, Page } from "./types";
+
+type ExposedDevice = $ReadOnly<{
+  appId: string,
+  id: string,
+  name: string,
+  sendMessage: (message: JSONSerializable) => void,
+}>;
+
+type ExposedDebugger = $ReadOnly<{
+  userAgent: string | null,
+  sendMessage: (message: JSONSerializable) => void,
+}>;
+
+export type CustomMessageHandlerConnection = $ReadOnly<{
+  page: Page,
+  device: ExposedDevice,
+  debugger: ExposedDebugger,
+}>;
+
+export type CreateCustomMessageHandlerFn = (
+  connection: CustomMessageHandlerConnection,
+) => ?CustomMessageHandler;
+
+/**
+ * The device message middleware allows implementers to handle unsupported CDP messages.
+ * It is instantiated per device and may contain state that is specific to that device.
+ * The middleware can also mark messages from the device or debugger as handled, which stops propagating.
+ */
+export interface CustomMessageHandler {
+  /**
+   * Handle a CDP message coming from the device.
+   * This is invoked before the message is sent to the debugger.
+   * When returning true, the message is considered handled and will not be sent to the debugger.
+   */
+  handleDeviceMessage(message: JSONSerializable): true | void;
+
+  /**
+   * Handle a CDP message coming from the debugger.
+   * This is invoked before the message is sent to the device.
+   * When returning true, the message is considered handled and will not be sent to the device.
+   */
+  handleDebuggerMessage(message: JSONSerializable): true | void;
+}