Components CLI parity (#30650)

Add `--run-component` flag in `convex dev --run foo:bar --run-component baz` and stop hiding component-related functionality in the CLI.

GitOrigin-RevId: 5a7e089607fe567641111dd714c0709d22875ee3

Author: thomasballinger

src/cli/convexImport.ts

@@ -80,8 +80,7 @@ export const convexImport = new Command("import")
     new Option(
       "--component <path>",
       "Path to the component in the component tree defined in convex.config.ts",
-      // TODO(ENG-6967): Remove hideHelp before launching components
-    ).hideHelp(),
+    ),
   )
   .addDeploymentSelectionOptions(actionDescription("Import data into"))
   .argument("<path>", "Path to the input file")

src/cli/data.ts

@@ -49,7 +49,6 @@ export const data = new Command("data")
       "--component <path>",
       "Path to the component in the component tree defined in convex.config.ts.\n" +
         "  By default, inspects data in the root component",
-      // TODO(ENG-6967): Remove hideHelp before launching components
     ).hideHelp(),
   )
   .addDeploymentSelectionOptions(actionDescription("Inspect the database in"))

src/cli/dev.ts

@@ -85,6 +85,11 @@ export const dev = new Command("dev")
     "The identifier of the function to run in step 3, " +
       "like `init` or `dir/file:myFunction`",
   )
+  .option(
+    "--run-component <functionName>",
+    "If --run is used and the function is in a component, the path the component tree defined in convex.config.ts. " +
+      "Components are a beta feature. This flag is unstable and may change in subsequent releases.",
+  )
   .addOption(
     new Option(
       "--prod",
@@ -128,6 +133,15 @@ export const dev = new Command("dev")
       await ctx.flushAndExit(-2);
     });
 
+    if (cmdOptions.runComponent && !cmdOptions.run) {
+      return await ctx.crash({
+        exitCode: 1,
+        errorType: "fatal",
+        printedMessage:
+          "Can't specify `--run-component` option without `--run`",
+      });
+    }
+
     if (cmdOptions.debugBundlePath !== undefined && !cmdOptions.once) {
       return await ctx.crash({
         exitCode: 1,
@@ -221,6 +235,7 @@ export async function watchAndPush(
   options: PushOptions,
   cmdOptions: {
     run?: string;
+    runComponent?: string;
     once: boolean;
     untilSuccess: boolean;
     traceEvents: boolean;
@@ -250,7 +265,12 @@ export async function watchAndPush(
         )})`,
       );
       if (cmdOptions.run !== undefined && !ran) {
-        await runFunctionInDev(ctx, options, cmdOptions.run);
+        await runFunctionInDev(
+          ctx,
+          options,
+          cmdOptions.run,
+          cmdOptions.runComponent,
+        );
         ran = true;
       }
       pushed = true;
@@ -339,14 +359,15 @@ async function runFunctionInDev(
     adminKey: string;
   },
   functionName: string,
+  componentPath: string | undefined,
 ) {
   await runFunctionAndLog(
     ctx,
     credentials.url,
     credentials.adminKey,
     functionName,
     {},
-    undefined,
+    componentPath,
     {
       onSuccess: () => {
         logFinishedStep(ctx, `Finished running function "${functionName}"`);