packages/community-cli-plugin/src/commands/start/middleware.js - main - githubmr/facebook-react-native

packages/community-cli-plugin/src/commands/start/middleware.js
93 строки3 KB
Sam Zhou
Migrate to suppression with error code in xplat: 1/n (#53439)
22 авг 2025, 20:35
22 авг 2025, 20:350530ea3
/**
 * 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 {Server} from 'connect';
import type {TerminalReportableEvent} from 'metro';

import {typeof createDevServerMiddleware as CreateDevServerMiddleware} from '@react-native-community/cli-server-api';

const debug = require('debug')('ReactNative:CommunityCliPlugin');

type MiddlewareReturn = {
  middleware: Server,
  websocketEndpoints: {
    [path: string]: ws$WebSocketServer,
  },
  messageSocketEndpoint: {
    server: ws$WebSocketServer,
    broadcast: (method: string, params?: Record<string, mixed> | null) => void,
  },
  eventsSocketEndpoint: {
    server: ws$WebSocketServer,
    reportEvent: (event: TerminalReportableEvent) => void,
  },
  ...
};

// $FlowFixMe[incompatible-type]
const unusedStubWSServer: ws$WebSocketServer = {};
// $FlowFixMe[incompatible-type]
const unusedMiddlewareStub: Server = {};

const communityMiddlewareFallback = {
  createDevServerMiddleware: (params: {
    host?: string,
    port: number,
    watchFolders: $ReadOnlyArray<string>,
  }): MiddlewareReturn => ({
    // FIXME: Several features will break without community middleware and
    // should be migrated into core.
    // e.g. used by Libraries/Core/Devtools:
    // - /open-stack-frame
    // - /open-url
    // - /symbolicate
    middleware: unusedMiddlewareStub,
    websocketEndpoints: {},
    messageSocketEndpoint: {
      server: unusedStubWSServer,
      broadcast: (
        method: string,
        _params?: Record<string, mixed> | null,
      ): void => {},
    },
    eventsSocketEndpoint: {
      server: unusedStubWSServer,
      reportEvent: (event: TerminalReportableEvent) => {},
    },
  }),
};

// Attempt to use the community middleware if it exists, but fallback to
// the stubs if it doesn't.
try {
  // `@react-native-community/cli` is an optional peer dependency of this
  // package, and should be a dev dependency of the host project (via the
  // community template's package.json).
  const communityCliPath = require.resolve('@react-native-community/cli');

  // Until https://github.com/react-native-community/cli/pull/2605 lands,
  // we need to find `@react-native-community/cli-server-api` via
  // `@react-native-community/cli`. Once that lands, we can simply
  // require('@react-native-community/cli').
  const communityCliServerApiPath = require.resolve(
    '@react-native-community/cli-server-api',
    {paths: [communityCliPath]},
  );
  // $FlowFixMe[unsupported-syntax] dynamic import
  communityMiddlewareFallback.createDevServerMiddleware = require(
    communityCliServerApiPath,
  ).createDevServerMiddleware as CreateDevServerMiddleware;
} catch {
  debug(`⚠️ Unable to find @react-native-community/cli-server-api
Starting the server without the community middleware.`);
}

export const createDevServerMiddleware =
  communityMiddlewareFallback.createDevServerMiddleware;