@rnx-kit/cli 0.16.12 → 0.16.14

package/lib/start.js

@@ -22,82 +22,37 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.rnxStart = void 0;
+const logger = __importStar(require("@rnx-kit/console"));
 const metro_service_1 = require("@rnx-kit/metro-service");
-const chalk_1 = __importDefault(require("chalk"));
-const os = __importStar(require("os"));
 const path = __importStar(require("path"));
-const qrcode_1 = __importDefault(require("qrcode"));
-const readline_1 = __importDefault(require("readline"));
 const metro_config_1 = require("./metro-config");
+const external_1 = require("./serve/external");
+const help_1 = require("./serve/help");
+const keyboard_1 = require("./serve/keyboard");
 const kit_config_1 = require("./serve/kit-config");
-function friendlyRequire(...modules) {
-    try {
-        const modulePath = modules.reduce((startDir, module) => {
-            return require.resolve(module, { paths: [startDir] });
-        }, process.cwd());
-        return require(modulePath);
-    }
-    catch (_) {
-        const module = modules[modules.length - 1];
-        throw new Error(`Cannot find module '${module}'. This probably means that '@rnx-kit/cli' is not compatible with the version of '@react-native-community/cli' that you are currently using. Please update to the latest version and try again. If the issue still persists after the update, please file a bug at https://github.com/microsoft/rnx-kit/issues.`);
-    }
-}
 function hasAttachToServerFunction(devServer) {
     return "attachToServer" in devServer;
 }
-async function rnxStart(_argv, cliConfig, cliOptions) {
-    const serverConfig = (0, kit_config_1.getKitServerConfig)(cliOptions);
-    const { createDevServerMiddleware, indexPageMiddleware } = friendlyRequire("react-native", "@react-native-community/cli", "@react-native-community/cli-server-api");
+async function rnxStart(_argv, ctx, args) {
+    var _a;
+    const serverConfig = (0, kit_config_1.getKitServerConfig)(args);
+    const { createDevServerMiddleware, indexPageMiddleware } = (0, external_1.requireExternal)("@react-native-community/cli-server-api");
     // interactive mode requires raw access to stdin
-    let interactive = cliOptions.interactive;
+    let interactive = args.interactive;
     if (interactive) {
         interactive = process.stdin.isTTY;
         if (!interactive) {
-            console.warn(chalk_1.default.yellow("Warning: Interactive mode is not supported on this terminal"));
+            logger.warn("Interactive mode is not supported in this environment");
         }
     }
-    // create a Metro terminal and reporter for writing to the console
-    const { terminal, reporter: terminalReporter } = (0, metro_service_1.createTerminal)(cliOptions.customLogReporterPath);
-    const printHelp = () => {
-        const dim = chalk_1.default.dim;
-        const press = dim(" › Press ");
-        [
-            ["r", "reload the app"],
-            ["d", "open developer menu"],
-            ["a", "show bundler address QR code"],
-            ["h", "show this help message"],
-            ["ctrl-c", "quit"],
-        ].forEach(([key, description]) => {
-            terminal.log(press + key + dim(` to ${description}.`));
-        });
-    };
-    // create a reporter function, to be bound to the Metro configuration.
-    // which writes to the Metro terminal and
-    // also notifies the `reportEvent` delegate.
-    let reportEventDelegate = undefined;
-    const reporter = {
-        update(event) {
-            terminalReporter.update(event);
-            if (reportEventDelegate) {
-                reportEventDelegate(event);
-            }
-            if (interactive && event.type === "dep_graph_loading") {
-                printHelp();
-            }
-        },
-    };
     // load Metro configuration, applying overrides from the command line
-    const metroConfig = await (0, metro_service_1.loadMetroConfig)(cliConfig, {
-        ...cliOptions,
+    const metroConfig = await (0, metro_service_1.loadMetroConfig)(ctx, {
+        ...args,
         ...(serverConfig.projectRoot
             ? { projectRoot: path.resolve(serverConfig.projectRoot) }
             : undefined),
-        reporter,
         ...(serverConfig.sourceExts
             ? { sourceExts: serverConfig.sourceExts }
             : undefined),
@@ -107,52 +62,112 @@ async function rnxStart(_argv, cliConfig, cliOptions) {
             }
             : undefined),
     });
+    // create a Metro terminal and reporter for writing to the console
+    const { terminal, reporter: terminalReporter } = (0, metro_service_1.createTerminal)(args.customLogReporterPath);
     // customize the metro config to include plugins, presets, etc.
-    (0, metro_config_1.customizeMetroConfig)(metroConfig, serverConfig, (message) => {
-        terminal.log(message);
-    });
+    const log = (message) => terminal.log(message);
+    (0, metro_config_1.customizeMetroConfig)(metroConfig, serverConfig, log);
+    const { projectRoot, server: { port }, watchFolders, } = metroConfig;
+    const scheme = args.https === true ? "https" : "http";
+    const serverStatus = await (0, metro_service_1.isDevServerRunning)(scheme, args.host, port, projectRoot);
+    switch (serverStatus) {
+        case "already_running":
+            logger.info(`A dev server is already running for this project on port ${port}. ` +
+                "Exiting...");
+            return;
+        case "in_use":
+            logger.error(`Another process is using port ${port}. Please terminate this ` +
+                "process and try again, or try another port with `--port`.");
+            return;
+    }
     // create middleware -- a collection of plugins which handle incoming
     // http(s) requests, routing them to static pages or JS functions.
-    const devServer = createDevServerMiddleware({
-        host: cliOptions.host,
-        port: metroConfig.server.port,
-        watchFolders: metroConfig.watchFolders,
-    });
-    const middleware = devServer.middleware;
-    middleware.use(indexPageMiddleware);
-    // merge the Metro config middleware with our middleware
-    const enhanceMiddleware = metroConfig.server.enhanceMiddleware;
-    // @ts-expect-error We want to assign to read-only `enhanceMiddleware`
-    metroConfig.server.enhanceMiddleware = (metroMiddleware, metroServer) => {
-        return middleware.use(enhanceMiddleware
-            ? enhanceMiddleware(metroMiddleware, metroServer)
-            : metroMiddleware);
-    };
+    const host = ((_a = args.host) === null || _a === void 0 ? void 0 : _a.length) ? args.host : "localhost";
+    const devServer = createDevServerMiddleware({ host, port, watchFolders });
+    const coreDevMiddleware = (() => {
+        try {
+            // https://github.com/facebook/react-native/blob/3e7a873f2d1c5170a7f4c88064897e74a149c5d5/packages/community-cli-plugin/src/commands/start/runServer.js#L115
+            const { createDevMiddleware } = (0, external_1.requireExternal)("@react-native/dev-middleware");
+            return createDevMiddleware({
+                projectRoot,
+                logger,
+                unstable_experiments: {
+                    // NOTE: Only affects the /open-debugger endpoint
+                    enableCustomDebuggerFrontend: true,
+                },
+            });
+        }
+        catch (_) {
+            // Fallback to the behavior from before 0.73
+            const middleware = devServer.middleware;
+            middleware.use(indexPageMiddleware);
+            // merge the Metro config middleware with our middleware
+            const enhanceMiddleware = metroConfig.server.enhanceMiddleware;
+            // @ts-expect-error We want to override `enhanceMiddleware`
+            metroConfig.server.enhanceMiddleware = (metroMiddleware, metroServer) => {
+                return middleware.use(enhanceMiddleware
+                    ? enhanceMiddleware(metroMiddleware, metroServer)
+                    : metroMiddleware);
+            };
+            return undefined;
+        }
+    })();
     // `createDevServerMiddleware` changed its return type in
     // https://github.com/react-native-community/cli/pull/1560
     let websocketEndpoints = undefined;
     let messageSocketEndpoint;
+    let reportEventDelegate = undefined;
     if (!hasAttachToServerFunction(devServer)) {
         websocketEndpoints = devServer.websocketEndpoints;
         messageSocketEndpoint = devServer.messageSocketEndpoint;
         // bind our `reportEvent` delegate to the Metro server
         reportEventDelegate = devServer.eventsSocketEndpoint.reportEvent;
     }
-    // start the Metro server
-    const serverOptions = {
-        host: cliOptions.host,
-        secure: cliOptions.https,
-        secureCert: cliOptions.cert,
-        secureKey: cliOptions.key,
-        websocketEndpoints,
+    const printHelp = (0, help_1.makeHelp)(terminal, {
+        hasDebugger: Boolean(coreDevMiddleware),
+    });
+    // @ts-expect-error We want to override `reporter`
+    metroConfig.reporter = {
+        update(event) {
+            terminalReporter.update(event);
+            if (reportEventDelegate) {
+                reportEventDelegate(event);
+            }
+            if (interactive && event.type === "dep_graph_loading") {
+                printHelp();
+            }
+        },
     };
-    const serverInstance = await (0, metro_service_1.startServer)(metroConfig, serverOptions);
+    const serverInstance = await (0, metro_service_1.startServer)(metroConfig, {
+        host: args.host,
+        secure: args.https,
+        secureCert: args.cert,
+        secureKey: args.key,
+        ...(coreDevMiddleware
+            ? {
+                unstable_extraMiddleware: [
+                    devServer.middleware,
+                    indexPageMiddleware,
+                    coreDevMiddleware.middleware,
+                ],
+                websocketEndpoints: {
+                    ...websocketEndpoints,
+                    ...coreDevMiddleware.websocketEndpoints,
+                },
+            }
+            : { websocketEndpoints }),
+    });
     if (hasAttachToServerFunction(devServer)) {
         const { messageSocket, eventsSocket } = devServer.attachToServer(serverInstance);
         messageSocketEndpoint = messageSocket;
         // bind our `reportEvent` delegate to the Metro server
         reportEventDelegate = eventsSocket.reportEvent;
     }
+    else {
+        // `messageSocketEndpoint` should already be set at this point. But this
+        // makes TypeScript happier.
+        messageSocketEndpoint = devServer.messageSocketEndpoint;
+    }
     // In Node 8, the default keep-alive for an HTTP connection is 5 seconds. In
     // early versions of Node 8, this was implemented in a buggy way which caused
     // some HTTP responses (like those containing large JS bundles) to be
@@ -167,51 +182,11 @@ async function rnxStart(_argv, cliConfig, cliOptions) {
     // in interactive mode, listen for keyboard events from stdin and bind
     // them to specific actions.
     if (interactive) {
-        readline_1.default.emitKeypressEvents(process.stdin);
-        process.stdin.setRawMode(true);
-        process.stdin.on("keypress", (_key, data) => {
-            const { ctrl, name } = data;
-            if (ctrl === true) {
-                switch (name) {
-                    case "c":
-                        terminal.log(chalk_1.default.green("Exiting..."));
-                        process.exit();
-                        break;
-                    case "z":
-                        process.emit("SIGTSTP", "SIGTSTP");
-                        break;
-                }
-            }
-            else {
-                switch (name) {
-                    case "a": {
-                        const protocol = cliOptions.https ? "https" : "http";
-                        const host = cliOptions.host || os.hostname();
-                        const port = metroConfig.server.port;
-                        const url = `${protocol}://${host}:${port}/index.bundle`;
-                        qrcode_1.default.toString(url, { type: "terminal" }, (_err, qr) => {
-                            terminal.log("");
-                            terminal.log(url + ":");
-                            terminal.log(qr);
-                        });
-                        break;
-                    }
-                    case "d":
-                        terminal.log(chalk_1.default.green("Opening developer menu..."));
-                        messageSocketEndpoint.broadcast("devMenu", undefined);
-                        break;
-                    case "h":
-                        printHelp();
-                        break;
-                    case "r":
-                        terminal.log(chalk_1.default.green("Reloading app..."));
-                        messageSocketEndpoint.broadcast("reload", undefined);
-                        break;
-                    case "return":
-                        terminal.log("");
-                        break;
-                }
-            }
+        (0, keyboard_1.attachKeyHandlers)({
+            devServerUrl: `${scheme}://${host}:${port}`,
+            help: printHelp,
+            messageSocketEndpoint,
+            terminal,
         });
     }
 }

package/lib/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"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"}

package/lib/write-third-party-notices.d.ts

@@ -9,6 +9,6 @@ type CliThirdPartyNoticesOptions = {
     preambleText?: string;
     additionalText?: string;
 };
-export declare function rnxWriteThirdPartyNotices(_argv: Array<string>, _config: CLIConfig, { additionalText, ignoreModules, ignoreScopes, json, outputFile, preambleText, rootPath, sourceMapFile, }: CliThirdPartyNoticesOptions): void;
+export declare function rnxWriteThirdPartyNotices(_argv: string[], _config: CLIConfig, { additionalText, ignoreModules, ignoreScopes, json, outputFile, preambleText, rootPath, sourceMapFile, }: CliThirdPartyNoticesOptions): void;
 export {};
 //# sourceMappingURL=write-third-party-notices.d.ts.map

package/lib/write-third-party-notices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-third-party-notices.d.ts","sourceRoot":"","sources":["../src/write-third-party-notices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAG7E,KAAK,2BAA2B,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EACpB,OAAO,EAAE,SAAS,EAClB,EACE,cAAc,EACd,aAAa,EACb,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,EAAE,2BAA2B,GAC7B,IAAI,CAYN"}
+{"version":3,"file":"write-third-party-notices.d.ts","sourceRoot":"","sources":["../src/write-third-party-notices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAG7E,KAAK,2BAA2B,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,SAAS,EAClB,EACE,cAAc,EACd,aAAa,EACb,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,EAAE,2BAA2B,GAC7B,IAAI,CAYN"}

package/lib/write-third-party-notices.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-third-party-notices.js","sourceRoot":"","sources":["../src/write-third-party-notices.ts"],"names":[],"mappings":";;;AACA,sEAAsE;AAatE,SAAgB,yBAAyB,CACvC,KAAoB,EACpB,OAAkB,EAClB,EACE,cAAc,EACd,aAAa,EACb,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,GACe;IAE9B,6EAA6E;IAC7E,IAAA,4CAAsB,EAAC;QACrB,QAAQ;QACR,aAAa;QACb,IAAI;QACJ,UAAU;QACV,YAAY,EAAE,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,KAAK,CAAC,GAAG,CAAC;QACtC,aAAa,EAAE,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,KAAK,CAAC,GAAG,CAAC;QACxC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;QACvD,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9D,CAAC,CAAC;AACL,CAAC;AAzBD,8DAyBC"}
+{"version":3,"file":"write-third-party-notices.js","sourceRoot":"","sources":["../src/write-third-party-notices.ts"],"names":[],"mappings":";;;AACA,sEAAsE;AAatE,SAAgB,yBAAyB,CACvC,KAAe,EACf,OAAkB,EAClB,EACE,cAAc,EACd,aAAa,EACb,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,GACe;IAE9B,6EAA6E;IAC7E,IAAA,4CAAsB,EAAC;QACrB,QAAQ;QACR,aAAa;QACb,IAAI;QACJ,UAAU;QACV,YAAY,EAAE,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,KAAK,CAAC,GAAG,CAAC;QACtC,aAAa,EAAE,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,KAAK,CAAC,GAAG,CAAC;QACxC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;QACvD,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9D,CAAC,CAAC;AACL,CAAC;AAzBD,8DAyBC"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@rnx-kit/cli",
-  "version": "0.16.12",
+  "version": "0.16.14",
   "description": "Command-line interface for working with kit packages in your repo",
-  "homepage": "https://github.com/microsoft/rnx-kit/tree/main/packages/cli",
+  "homepage": "https://github.com/microsoft/rnx-kit/tree/main/packages/cli#readme",
   "license": "MIT",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -26,8 +26,8 @@
     "@rnx-kit/metro-plugin-duplicates-checker": "^2.1.1",
     "@rnx-kit/metro-plugin-typescript": "^0.4.4",
     "@rnx-kit/metro-serializer": "^1.0.12",
-    "@rnx-kit/metro-serializer-esbuild": "^0.1.28",
-    "@rnx-kit/metro-service": "^3.1.1",
+    "@rnx-kit/metro-serializer-esbuild": "^0.1.29",
+    "@rnx-kit/metro-service": "^3.1.2",
     "@rnx-kit/third-party-notices": "^1.3.4",
     "@rnx-kit/tools-language": "^2.0.0",
     "@rnx-kit/tools-node": "^2.0.0",
@@ -35,12 +35,14 @@
     "chalk": "^4.1.0",
     "find-up": "^5.0.0",
     "fs-extra": "^10.0.0",
+    "node-fetch": "^2.6.7",
     "ora": "^5.4.1",
     "qrcode": "^1.5.0",
     "readline": "^1.3.0"
   },
   "peerDependencies": {
     "@react-native-community/cli": ">=5.0.1",
+    "@react-native-community/cli-clean": ">=8.0.0",
     "@react-native-community/cli-server-api": ">=5.0.1",
     "jest-cli": ">=26.0",
     "react-native": ">=0.64"
@@ -49,6 +51,9 @@
     "@react-native-community/cli": {
       "optional": true
     },
+    "@react-native-community/cli-clean": {
+      "optional": true
+    },
     "@react-native-community/cli-server-api": {
       "optional": true
     },
@@ -60,25 +65,24 @@
     }
   },
   "devDependencies": {
-    "@react-native-community/cli-types": "^10.0.0",
+    "@react-native-community/cli-types": "^11.0.0",
     "@rnx-kit/scripts": "*",
-    "@types/metro": "^0.76.0",
-    "@types/metro-babel-transformer": "^0.76.0",
-    "@types/metro-config": "^0.76.0",
+    "@types/connect": "^3.4.36",
+    "@types/node-fetch": "^2.6.5",
     "@types/qrcode": "^1.4.2",
     "eslint": "^8.0.0",
     "jest": "^29.2.1",
     "memfs": "^4.0.0",
-    "metro-config": "^0.73.7",
+    "metro": "^0.76.5",
+    "metro-babel-transformer": "^0.76.8",
+    "metro-config": "^0.76.5",
     "prettier": "^3.0.0",
-    "type-fest": "^3.0.0",
+    "type-fest": "^4.0.0",
     "typescript": "^5.0.0"
   },
   "depcheck": {
     "ignoreMatches": [
-      "@react-native-community/cli-clean",
-      "metro",
-      "metro-babel-transformer",
+      "connect",
       "readline"
     ]
   },

package/src/bundle.ts

@@ -15,7 +15,7 @@ type CLIBundleOptions = CLICommonBundleOptions & {
 };
 
 export async function rnxBundle(
-  _argv: Array<string>,
+  _argv: string[],
   cliConfig: CLIConfig,
   cliOptions: CLIBundleOptions
 ): Promise<void> {

package/src/clean.ts

@@ -16,9 +16,7 @@ type Task = {
   action: () => Promise<void>;
 };
 
-type CLICommand = {
-  [key: string]: Task[];
-};
+type CLICommand = Record<string, Task[]>;
 
 export async function rnxClean(
   _argv: string[],

package/src/ram-bundle.ts

@@ -33,7 +33,7 @@ function disableTreeShaking(configs: CliPlatformBundleConfig[]): void {
 }
 
 export async function rnxRamBundle(
-  _argv: Array<string>,
+  _argv: string[],
   cliConfig: CLIConfig,
   cliOptions: CLIRamBundleOptions
 ): Promise<void> {

package/src/serve/external.ts

@@ -0,0 +1,50 @@
+import type { CliServerApi, CoreDevMiddleware } from "./types";
+
+type ExternalModule =
+  | "@react-native-community/cli-server-api"
+  | "@react-native/dev-middleware";
+
+function friendlyRequire<T>(...modules: string[]): T {
+  try {
+    const modulePath = modules.reduce((startDir, module) => {
+      return require.resolve(module, { paths: [startDir] });
+    }, process.cwd());
+    return require(modulePath) as T;
+  } catch (_) {
+    const module = modules[modules.length - 1];
+    throw new Error(
+      `Cannot find module '${module}'. This probably means that ` +
+        "'@rnx-kit/cli' is not compatible with the version of 'react-native' " +
+        "that you are currently using. Please update to the latest version " +
+        "and try again. If the issue still persists after the update, please " +
+        "file a bug at https://github.com/microsoft/rnx-kit/issues."
+    );
+  }
+}
+
+export function requireExternal(
+  module: "@react-native-community/cli-server-api"
+): CliServerApi;
+
+export function requireExternal(
+  module: "@react-native/dev-middleware"
+): CoreDevMiddleware;
+
+export function requireExternal(
+  module: ExternalModule
+): CliServerApi | CoreDevMiddleware {
+  switch (module) {
+    case "@react-native-community/cli-server-api":
+      return friendlyRequire<CliServerApi>(
+        "react-native",
+        "@react-native-community/cli",
+        "@react-native-community/cli-server-api"
+      );
+    case "@react-native/dev-middleware":
+      return friendlyRequire<CoreDevMiddleware>(
+        "react-native",
+        "@react-native/community-cli-plugin",
+        "@react-native/dev-middleware"
+      );
+  }
+}

package/src/serve/help.ts

@@ -0,0 +1,60 @@
+import type { MetroTerminal } from "@rnx-kit/metro-service";
+import chalk from "chalk";
+
+type HelpOptions = {
+  hasDebugger: boolean;
+};
+
+type MenuItem = [string, string];
+
+export function makeHelp(
+  terminal: MetroTerminal["terminal"],
+  { hasDebugger }: HelpOptions
+): () => void {
+  const openDebugger: MenuItem | null = hasDebugger
+    ? ["J", "Open debugger"]
+    : null;
+
+  const menuItems: ("" | MenuItem)[] = [
+    ["D", "Open developer menu"],
+    ...(openDebugger ? [openDebugger] : []),
+    ["Q", "Show bundler address QR code"],
+    ["R", "Reload the app"],
+    "",
+    ["H", "Show this help message"],
+    ["Ctrl-C", "Quit"],
+  ];
+
+  const margin = 4;
+  const maxColumnWidth = (index: number) => {
+    return (max: number, item: (typeof menuItems)[number]) => {
+      if (!item) {
+        return max;
+      }
+
+      const width = item[index].length;
+      return width > max ? width : max;
+    };
+  };
+
+  const keyWidth = menuItems.reduce(maxColumnWidth(0), 0);
+  const labelWidth = menuItems.reduce(maxColumnWidth(1), 0);
+  const separator = `┠${"─".repeat(labelWidth + keyWidth + margin + 1)}`;
+
+  const dim = chalk.dim;
+  const lines = menuItems.map((item) => {
+    if (!item) {
+      return separator;
+    }
+
+    const [key, label] = item;
+    const labelPadding = labelWidth - label.length;
+    const keyPadding = keyWidth - key.length;
+    const padding = " ".repeat(labelPadding + keyPadding + margin);
+    return `┃ ${dim(label)}${padding}${key}`;
+  });
+  lines.push("");
+
+  const help = lines.join("\n");
+  return () => terminal.log(help);
+}

package/src/serve/keyboard.ts

@@ -0,0 +1,73 @@
+import { info } from "@rnx-kit/console";
+import type { MetroTerminal } from "@rnx-kit/metro-service";
+import fetch from "node-fetch";
+import qrcode from "qrcode";
+import readline from "readline";
+import type { DevServerMiddleware } from "./types";
+
+type Options = {
+  devServerUrl: string;
+  help: () => void;
+  messageSocketEndpoint: DevServerMiddleware["messageSocketEndpoint"];
+  terminal: MetroTerminal["terminal"];
+};
+
+export function attachKeyHandlers({
+  devServerUrl,
+  help,
+  messageSocketEndpoint,
+  terminal,
+}: Options) {
+  process.stdin.setRawMode(true);
+  process.stdin.on("keypress", (_key, data) => {
+    const { ctrl, name } = data;
+    if (ctrl === true) {
+      switch (name) {
+        case "c":
+          info("Exiting...");
+          process.exit();
+          break;
+        case "z":
+          process.emit("SIGTSTP", "SIGTSTP");
+          break;
+      }
+    } else {
+      switch (name) {
+        case "d":
+          info("Opening developer menu...");
+          messageSocketEndpoint.broadcast("devMenu", undefined);
+          break;
+
+        case "h":
+          help();
+          break;
+
+        case "j": {
+          fetch(devServerUrl + "/open-debugger", { method: "POST" });
+          break;
+        }
+
+        case "q": {
+          const url = `${devServerUrl}/index.bundle`;
+          qrcode.toString(url, { type: "terminal" }, (_err, qr) => {
+            terminal.log("");
+            terminal.log(url + ":");
+            terminal.log(qr);
+          });
+          break;
+        }
+
+        case "r":
+          info("Reloading app...");
+          messageSocketEndpoint.broadcast("reload", undefined);
+          break;
+
+        case "return":
+          terminal.log("");
+          break;
+      }
+    }
+  });
+
+  readline.emitKeypressEvents(process.stdin);
+}