convex 1.37.0 → 1.38.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "convex",
   "description": "Client for the Convex Cloud",
-  "version": "1.37.0",
+  "version": "1.38.0",
   "author": "Convex, Inc. <no-reply@convex.dev>",
   "homepage": "https://convex.dev",
   "repository": {

package/schemas/convex.schema.json

@@ -123,7 +123,7 @@
         },
         "nodeVersion": {
           "type": "string",
-          "description": "The Node.js version to use for Node.js actions. The currently supported values are '18', '20', and '22'.\n\nDocumentation: https://docs.convex.dev/production/project-configuration#configuring-the-nodejs-version",
+          "description": "The Node.js version to use for Node.js actions. The currently supported values are '20', '22', and '24'.\n\nDocumentation: https://docs.convex.dev/production/project-configuration#configuring-the-nodejs-version",
           "default": "20"
         }
       }

package/src/bundler/debugBundle.ts

@@ -9,6 +9,7 @@ import {
   logMessage,
 } from "./log.js";
 import { wasmPlugin } from "./wasm.js";
+import { serverOnlyPlugin } from "./serverOnly.js";
 import dependencyTrackerPlugin from "./depgraph.js";
 
 export async function innerEsbuild({
@@ -111,7 +112,7 @@ export async function debugIsolateBundlesSerially(
         chunksFolder: "_deps",
         extraConditions,
         dir,
-        plugins: [plugin, wasmPlugin],
+        plugins: [serverOnlyPlugin, plugin, wasmPlugin],
         logLevel: "silent",
       });
     } catch (error) {

package/src/bundler/index.ts

@@ -8,6 +8,7 @@ import { Filesystem, consistentPathSort } from "./fs.js";
 import { Context } from "./context.js";
 import { logVerbose, logWarning } from "./log.js";
 import { wasmPlugin } from "./wasm.js";
+import { serverOnlyPlugin } from "./serverOnly.js";
 import {
   ExternalPackage,
   computeExternalPackages,
@@ -100,8 +101,10 @@ async function doEsbuild({
       chunksFolder,
       extraConditions,
       dir,
-      // The wasmPlugin should be last so it doesn't run on external modules.
-      plugins: [external.plugin, wasmPlugin],
+      // serverOnlyPlugin runs first so `server-only` is always stubbed,
+      // even if it appears in the external packages list.
+      // wasmPlugin runs last so it doesn't run on external modules.
+      plugins: [serverOnlyPlugin, external.plugin, wasmPlugin],
       includeSourcesContent,
       splitting,
     });
@@ -112,7 +115,8 @@ async function doEsbuild({
       if (
         relPath.indexOf("(disabled):") !== -1 ||
         relPath.startsWith("wasm-binary:") ||
-        relPath.startsWith("wasm-stub:")
+        relPath.startsWith("wasm-stub:") ||
+        relPath.startsWith("server-only-stub:")
       ) {
         continue;
       }

package/src/bundler/serverOnly.ts

@@ -0,0 +1,18 @@
+import { Plugin } from "esbuild";
+
+// Stub `import "server-only"` to an empty module so user code that uses
+// Next.js's server-only can be bundled and analyzed correctly:
+// https://nextjs.org/docs/app/getting-started/server-and-client-components#preventing-environment-poisoning
+export const serverOnlyPlugin: Plugin = {
+  name: "convex-server-only",
+  setup(build) {
+    build.onResolve({ filter: /^server-only$/ }, (args) => ({
+      path: args.path,
+      namespace: "server-only-stub",
+    }));
+    build.onLoad({ filter: /.*/, namespace: "server-only-stub" }, () => ({
+      contents: "",
+      loader: "js",
+    }));
+  },
+};

package/src/cli/configure.ts

@@ -43,7 +43,6 @@ import {
   promptString,
   promptYesNo,
 } from "./lib/utils/prompts.js";
-import { readGlobalConfig } from "./lib/utils/globalConfig.js";
 import { attemptSetupAiFiles } from "./lib/aiFiles/index.js";
 import {
   DeploymentSelection,
@@ -175,17 +174,6 @@ export async function _deploymentCredentialsOrConfigure(
     } | null;
   }
 > {
-  const config = readGlobalConfig(ctx);
-  const globallyForceCloud = !!config?.optOutOfLocalDevDeploymentsUntilBetaOver;
-  if (globallyForceCloud && cmdOptions.local) {
-    return await ctx.crash({
-      exitCode: 1,
-      errorType: "fatal",
-      printedMessage:
-        "Can't specify --local when local deployments are disabled on this machine. Run `npx convex disable-local-deployments --undo-global` to allow use of --local.",
-    });
-  }
-
   switch (deploymentSelection.kind) {
     case "existingDeployment":
       return {
@@ -205,9 +193,6 @@ export async function _deploymentCredentialsOrConfigure(
         ctx,
         chosenConfiguration,
         deploymentSelection.selectionWithinProject,
-        {
-          globallyForceCloud,
-        },
         cmdOptions,
       );
     }
@@ -222,7 +207,6 @@ export async function _deploymentCredentialsOrConfigure(
         chosenConfiguration,
         deploymentSelection,
         cmdOptions,
-        globallyForceCloud,
       });
     }
     case "anonymous": {
@@ -244,9 +228,6 @@ export async function _deploymentCredentialsOrConfigure(
             ctx,
             chosenConfiguration,
             deploymentSelection.selectionWithinProject,
-            {
-              globallyForceCloud,
-            },
             cmdOptions,
           );
         }
@@ -300,9 +281,6 @@ export async function _deploymentCredentialsOrConfigure(
         ctx,
         chosenConfiguration,
         deploymentSelection.selectionWithinProject,
-        {
-          globallyForceCloud,
-        },
         cmdOptions,
       );
     }
@@ -315,14 +293,12 @@ async function handleDeploymentWithinProject(
     chosenConfiguration,
     deploymentSelection,
     cmdOptions,
-    globallyForceCloud,
   }: {
     chosenConfiguration: ChosenConfiguration;
     deploymentSelection: DeploymentSelection & {
       kind: "deploymentWithinProject";
     };
     cmdOptions: ConfigureCmdOptions;
-    globallyForceCloud: boolean;
   },
 ) {
   const hasAuth = ctx.bigBrainAuth() !== null;
@@ -343,9 +319,6 @@ async function handleDeploymentWithinProject(
       ctx,
       chosenConfiguration,
       deploymentSelection.selectionWithinProject,
-      {
-        globallyForceCloud,
-      },
       cmdOptions,
     );
     return result;
@@ -361,9 +334,6 @@ async function handleDeploymentWithinProject(
       ctx,
       chosenConfiguration,
       deploymentSelection.selectionWithinProject,
-      {
-        globallyForceCloud,
-      },
       cmdOptions,
     );
     return result;
@@ -405,9 +375,6 @@ async function handleChooseProject(
   ctx: Context,
   chosenConfiguration: ChosenConfiguration,
   selectionWithinProject: DeploymentSelectionWithinProject,
-  args: {
-    globallyForceCloud: boolean;
-  },
   cmdOptions: ConfigureCmdOptions,
 ): Promise<
   DeploymentCredentials & {
@@ -429,8 +396,8 @@ async function handleChooseProject(
     team: cmdOptions.team,
     project: cmdOptions.project,
     devDeployment: cmdOptions.devDeployment,
-    local: args.globallyForceCloud ? false : cmdOptions.local,
-    cloud: args.globallyForceCloud ? true : cmdOptions.cloud,
+    local: cmdOptions.local,
+    cloud: cmdOptions.cloud,
   });
   // TODO complain about any non-default cmdOptions.localOptions here
   // because we're ignoring them if this isn't a local development.

package/src/cli/deploy.ts

@@ -227,7 +227,7 @@ async function deployToNewPreviewDeployment(
       exitCode: 1,
       errorType: "fatal",
       printedMessage:
-        "`npx convex deploy` to a preview deployment could not determine the preview name. Provide one using `--preview-create`",
+        "`npx convex deploy` to a preview deployment could not determine the preview name. Provide one using `--preview-name`",
     });
   }
 

package/src/cli/deploymentCreate.test.ts

@@ -217,6 +217,8 @@ describe("non-interactive create flow", () => {
         deploymentName: "local-test-123",
         adminKey: "test-key",
       });
+      setupPlatformClient();
+      mockPlatformGet.mockResolvedValue({ data: { items: [] } });
 
       await deploymentCreate.parseAsync(["local"], { from: "user" });
 
@@ -263,6 +265,8 @@ describe("non-interactive create flow", () => {
         deploymentName: "local-test-123",
         adminKey: "test-key",
       });
+      setupPlatformClient();
+      mockPlatformGet.mockResolvedValue({ data: { items: [] } });
 
       await deploymentCreate.parseAsync(["local", "--select"], {
         from: "user",

package/src/cli/deploymentCreate.ts

@@ -40,6 +40,8 @@ import {
   LOCAL_BACKEND_INSTANCE_SECRET,
 } from "./lib/localDeployment/utils.js";
 import { bigBrainStart } from "./lib/localDeployment/bigBrain.js";
+import { importDefaultEnvVars } from "./lib/localDeployment/localDeployment.js";
+import { localDeploymentUrl } from "./lib/localDeployment/run.js";
 
 const SUPPORTED_TYPES = ["dev", "prod", "preview"] as const;
 
@@ -70,7 +72,10 @@ export const deploymentCreate = new Command("create")
     "--expiration <value>",
     'When the deployment expires (e.g. "none", "in 7 days", "2026-04-01T00:00:00Z", or a UNIX timestamp in seconds or milliseconds)',
   )
+  .addOption(new Option("--expiry <value>").hideHelp())
+  .addOption(new Option("--expires <value>").hideHelp())
   .action(async (refParam, options) => {
+    const expiration = options.expiration ?? options.expiry ?? options.expires;
     const ctx = await oneoffContext({
       url: undefined,
       adminKey: undefined,
@@ -86,13 +91,7 @@ export const deploymentCreate = new Command("create")
     // Handle `deployment create local`
     if (refParam !== undefined) {
       if (refParam === "local") {
-        const cloudOnlyFlags = [
-          "type",
-          "region",
-          "class",
-          "default",
-          "expiration",
-        ] as const;
+        const cloudOnlyFlags = ["type", "region", "class", "default"] as const;
         for (const flag of cloudOnlyFlags) {
           if (options[flag]) {
             return await ctx.crash({
@@ -102,6 +101,13 @@ export const deploymentCreate = new Command("create")
             });
           }
         }
+        if (expiration !== undefined) {
+          return await ctx.crash({
+            exitCode: 1,
+            errorType: "fatal",
+            printedMessage: `--expiration cannot be used when creating a local deployment`,
+          });
+        }
         await createLocalDeployment(
           ctx,
           currentDeployment,
@@ -111,7 +117,7 @@ export const deploymentCreate = new Command("create")
       }
     }
 
-    const expiresAt = await resolveExpiresAtOrCrash(ctx, options.expiration);
+    const expiresAt = await resolveExpiresAtOrCrash(ctx, expiration);
 
     const {
       ref,
@@ -212,7 +218,7 @@ export const deploymentCreate = new Command("create")
     }
   });
 
-async function createLocalDeployment(
+export async function createLocalDeployment(
   ctx: Context,
   currentDeployment: DeploymentSelection,
   select: boolean,
@@ -255,6 +261,14 @@ async function createLocalDeployment(
 
   logFinishedStep("Created local deployment.");
 
+  await importDefaultEnvVars(ctx, {
+    teamSlug,
+    projectSlug,
+    deploymentName,
+    deploymentUrl: localDeploymentUrl(cloudPort),
+    adminKey,
+  });
+
   if (select) {
     const selection: DeploymentSelection = {
       kind: "deploymentWithinProject",

package/src/cli/deploymentSelect.test.ts

@@ -1,4 +1,6 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+// @inquirer/testing/vitest must be imported before modules that use @inquirer/*
+import { screen } from "@inquirer/testing/vitest";
 import path from "path";
 import { nodeFs } from "../bundler/fs.js";
 import { deploymentSelect } from "./deploymentSelect.js";
@@ -8,6 +10,9 @@ import { globalConfigPath } from "./lib/utils/globalConfig.js";
 // Mock GET functions — can be configured per test
 const mockPlatformGet = vi.fn();
 const mockDeploymentGet = vi.fn();
+const { mockCreateLocalDeployment } = vi.hoisted(() => ({
+  mockCreateLocalDeployment: vi.fn(),
+}));
 
 // In-memory filesystem — populated in beforeEach, written to by real configure code
 let testFiles: Map<string, string>;
@@ -50,6 +55,14 @@ vi.mock("@sentry/node", () => ({
   close: vi.fn(),
 }));
 
+vi.mock("./deploymentCreate.js", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("./deploymentCreate.js")>();
+  return {
+    ...actual,
+    createLocalDeployment: mockCreateLocalDeployment,
+  };
+});
+
 vi.mock("./lib/localDeployment/run.js", async (importOriginal) => {
   const actual =
     await importOriginal<typeof import("./lib/localDeployment/run.js")>();
@@ -501,14 +514,38 @@ describe("npx convex select", () => {
       expect(envContent).not.toContain("CONVEX_SITE_URL");
     });
 
-    it("fails with 'No local deployment found' when no local config exists", async () => {
-      await expect(
-        deploymentSelect.parseAsync(["local"], { from: "user" }),
-      ).rejects.toThrow();
+    it("creates a local deployment when user approves the 'Create one now?' prompt", async () => {
+      mockCreateLocalDeployment.mockResolvedValue(undefined);
 
-      expect(process.stderr.write).toHaveBeenCalledWith(
-        expect.stringContaining("No local deployment found"),
+      const promise = deploymentSelect.parseAsync(["local"], { from: "user" });
+
+      await screen.next();
+      expect(screen.getScreen()).toContain(
+        "No local deployment found. Create one now?",
       );
+      screen.keypress("y");
+      screen.keypress("enter");
+
+      await promise;
+
+      expect(mockCreateLocalDeployment).toHaveBeenCalledTimes(1);
+    });
+
+    it("fails with 'No local deployment found' when no local config exists and stdin is not a TTY", async () => {
+      const previousIsTTY = process.stdin.isTTY;
+      process.stdin.isTTY = false as any;
+      try {
+        await expect(
+          deploymentSelect.parseAsync(["local"], { from: "user" }),
+        ).rejects.toThrow();
+
+        expect(process.stderr.write).toHaveBeenCalledWith(
+          expect.stringContaining("No local deployment found"),
+        );
+        expect(mockCreateLocalDeployment).not.toHaveBeenCalled();
+      } finally {
+        process.stdin.isTTY = previousIsTTY as any;
+      }
     });
   });
 
@@ -610,6 +647,23 @@ describe("npx convex select", () => {
       expect(envContent).toContain("CONVEX_DEPLOYMENT=dev:clever-otter-890");
     });
 
+    it("fails with 'No project configured' for 'local' when no local deployment exists yet", async () => {
+      // No `.convex/local/default/config.json` exists, so we'd normally prompt
+      // "Create one now?". But since creating a local deployment requires a
+      // project, we should fail up-front instead.
+      await expect(
+        deploymentSelect.parseAsync(["local"], { from: "user" }),
+      ).rejects.toThrow();
+
+      expect(process.stderr.write).toHaveBeenCalledWith(
+        expect.stringContaining("No project configured"),
+      );
+      expect(process.stderr.write).not.toHaveBeenCalledWith(
+        expect.stringContaining("Create one now?"),
+      );
+      expect(mockCreateLocalDeployment).not.toHaveBeenCalled();
+    });
+
     it("selects local deployment without project configured", async () => {
       testFiles.set(
         path.resolve(".convex/local/default/config.json"),

package/src/cli/deploymentSelect.ts

@@ -9,6 +9,9 @@ import {
 import { parseDeploymentSelector } from "./lib/deploymentSelector.js";
 import { updateEnvAndConfigForDeploymentSelection } from "./configure.js";
 import { fetchDeploymentCanonicalUrls } from "./lib/deploy2.js";
+import { loadProjectLocalConfig } from "./lib/localDeployment/filePaths.js";
+import { promptYesNo } from "./lib/utils/prompts.js";
+import { createLocalDeployment } from "./deploymentCreate.js";
 import { chalkStderr } from "chalk";
 
 export const deploymentSelect = new Command("select")
@@ -50,6 +53,37 @@ export const deploymentSelect = new Command("select")
       });
     }
 
+    // If selecting `local` and no local deployment exists, offer to create one interactively.
+    if (
+      parsed.kind === "local" &&
+      process.stdin.isTTY &&
+      loadProjectLocalConfig(ctx) === null
+    ) {
+      // Creating a local deployment requires a configured project, so bail out
+      // before prompting the user if there isn't one.
+      if (currentSelection.kind === "chooseProject") {
+        return await ctx.crash({
+          exitCode: 1,
+          errorType: "fatal",
+          printedMessage: `No project configured. Run \`npx convex dev\` to set up a project first.`,
+        });
+      }
+
+      const wantsToCreate = await promptYesNo(ctx, {
+        message: "No local deployment found. Create one now?",
+        default: true,
+      });
+      if (!wantsToCreate) {
+        return await ctx.crash({
+          exitCode: 1,
+          errorType: "fatal",
+          printedMessage: `No local deployment found. Run ${chalkStderr.bold("npx convex deployment create local")} to create one.`,
+        });
+      }
+      await createLocalDeployment(ctx, currentSelection, true);
+      return;
+    }
+
     // Resolve the new deployment using the selector relative to the current project
     const newSelection = await getDeploymentSelection(ctx, {
       url: undefined,

package/src/cli/deploymentSelection.test.ts

@@ -394,6 +394,65 @@ describe("deployment selection flows", () => {
       );
     });
 
+    it("resolves CONVEX_DEPLOYMENT_TOKEN as an alias for CONVEX_DEPLOY_KEY", async () => {
+      process.env.CONVEX_DEPLOYMENT_TOKEN =
+        "prod:joyful-capybara-123|secretkey";
+
+      setupBigBrainRoutes({
+        "deployment/url_for_key": () =>
+          "https://joyful-capybara-123.eu-west-1.convex.cloud",
+        "deployment/team_and_project_for_key": () => ({
+          team: "my-team",
+          project: "my-project",
+          teamId: 1,
+          projectId: 1,
+        }),
+      });
+
+      const mockFetch = vi.fn().mockResolvedValue({ ok: true });
+      vi.mocked(deploymentFetch).mockReturnValue(mockFetch as any);
+
+      await env.parseAsync(["set", "ABC", "DEF"], { from: "user" });
+
+      expect(deploymentFetch).toHaveBeenCalledWith(
+        expect.anything(),
+        expect.objectContaining({
+          deploymentUrl: "https://joyful-capybara-123.eu-west-1.convex.cloud",
+          adminKey: "prod:joyful-capybara-123|secretkey",
+        }),
+      );
+    });
+
+    it("CONVEX_DEPLOY_KEY takes precedence over CONVEX_DEPLOYMENT_TOKEN", async () => {
+      process.env.CONVEX_DEPLOY_KEY = "prod:joyful-capybara-123|secretkey";
+      process.env.CONVEX_DEPLOYMENT_TOKEN =
+        "prod:other-deployment-456|otherkey";
+
+      setupBigBrainRoutes({
+        "deployment/url_for_key": () =>
+          "https://joyful-capybara-123.eu-west-1.convex.cloud",
+        "deployment/team_and_project_for_key": () => ({
+          team: "my-team",
+          project: "my-project",
+          teamId: 1,
+          projectId: 1,
+        }),
+      });
+
+      const mockFetch = vi.fn().mockResolvedValue({ ok: true });
+      vi.mocked(deploymentFetch).mockReturnValue(mockFetch as any);
+
+      await env.parseAsync(["set", "ABC", "DEF"], { from: "user" });
+
+      expect(deploymentFetch).toHaveBeenCalledWith(
+        expect.anything(),
+        expect.objectContaining({
+          deploymentUrl: "https://joyful-capybara-123.eu-west-1.convex.cloud",
+          adminKey: "prod:joyful-capybara-123|secretkey",
+        }),
+      );
+    });
+
     it("resolves CONVEX_DEPLOY_KEY with project deploy key to dev deployment by default", async () => {
       process.env.CONVEX_DEPLOY_KEY = "project:identifier|secretkey";
 
@@ -1662,6 +1721,18 @@ describe("deployment selection flows", () => {
       expect(runPush).toHaveBeenCalled();
     });
 
+    it("suggests --preview-name when preview name cannot be determined", async () => {
+      process.env.CONVEX_DEPLOY_KEY = "preview:my-team:my-project|secretkey";
+
+      await expect(deploy.parseAsync([], { from: "user" })).rejects.toThrow();
+
+      expect(process.stderr.write).toHaveBeenCalledWith(
+        expect.stringContaining("Provide one using `--preview-name`"),
+      );
+      expect(bigBrainAPI).not.toHaveBeenCalled();
+      expect(runPush).not.toHaveBeenCalled();
+    });
+
     it("deploys to existing preview with CONVEX_DEPLOYMENT and --preview-name", async () => {
       process.env.CONVEX_DEPLOYMENT = "dev:joyful-capybara-123";
       vi.mocked(readGlobalConfig).mockReturnValue({
@@ -1746,7 +1817,7 @@ describe("deployment selection flows", () => {
     it("dev --local uses local deployment when local is allowed", async () => {
       vi.mocked(readGlobalConfig).mockReturnValue({
         accessToken: "test-token",
-      }); // no optOutOfLocalDevDeploymentsUntilBetaOver
+      });
       vi.mocked(validateOrSelectTeam).mockResolvedValue({
         team: { slug: "my-team", id: 1, name: "My Team" } as any,
         chosen: false,
@@ -1829,24 +1900,6 @@ describe("deployment selection flows", () => {
       );
     });
 
-    it("dev --local crashes when local deployments are globally disabled", async () => {
-      vi.mocked(readGlobalConfig).mockReturnValue({
-        accessToken: "test-token",
-        optOutOfLocalDevDeploymentsUntilBetaOver: true,
-      });
-
-      await expect(
-        dev.parseAsync(["--skip-push", "--local"], { from: "user" }),
-      ).rejects.toThrow();
-
-      expect(process.stderr.write).toHaveBeenCalledWith(
-        expect.stringContaining(
-          "Can't specify --local when local deployments are disabled on this machine",
-        ),
-      );
-      expect(devAgainstDeployment).not.toHaveBeenCalled();
-    });
-
     it("resolves CONVEX_DEPLOYMENT to the configured deployment", async () => {
       process.env.CONVEX_DEPLOYMENT = "dev:joyful-capybara-123";
       vi.mocked(readGlobalConfig).mockReturnValue({

package/src/cli/deploymentTokenCreate.ts

@@ -7,6 +7,7 @@ import { actionDescription } from "./lib/command.js";
 import { getDeploymentSelection } from "./lib/deploymentSelection.js";
 import { changedEnvVarFile } from "./lib/envvars.js";
 import {
+  CONVEX_DEPLOYMENT_TOKEN_ENV_VAR_NAME,
   CONVEX_DEPLOY_KEY_ENV_VAR_NAME,
   ENV_VAR_FILE_PATH,
   typedPlatformClient,
@@ -40,7 +41,9 @@ export const deploymentTokenCreate = new Command("create")
         printedMessage: `Creating a deploy key currently requires being logged in with a personal access token. ${
           process.env[CONVEX_DEPLOY_KEY_ENV_VAR_NAME]
             ? `Unset ${CONVEX_DEPLOY_KEY_ENV_VAR_NAME}`
-            : `Run ${chalkStderr.bold("npx convex login")}`
+            : process.env[CONVEX_DEPLOYMENT_TOKEN_ENV_VAR_NAME]
+              ? `Unset ${CONVEX_DEPLOYMENT_TOKEN_ENV_VAR_NAME}`
+              : `Run ${chalkStderr.bold("npx convex login")}`
         } and try again.`,
       });
     }

package/src/cli/deploymentTokenDelete.ts

@@ -6,6 +6,7 @@ import { loadSelectedDeploymentCredentials } from "./lib/api.js";
 import { actionDescription } from "./lib/command.js";
 import { getDeploymentSelection } from "./lib/deploymentSelection.js";
 import {
+  CONVEX_DEPLOYMENT_TOKEN_ENV_VAR_NAME,
   CONVEX_DEPLOY_KEY_ENV_VAR_NAME,
   typedPlatformClient,
 } from "./lib/utils/utils.js";
@@ -34,7 +35,14 @@ export const deploymentTokenDelete = new Command("delete")
       return await ctx.crash({
         exitCode: 1,
         errorType: "fatal",
-        printedMessage: `Deleting a deploy key requires being logged in with a personal access token. ${auth === null ? "Run " : `Unset ${CONVEX_DEPLOY_KEY_ENV_VAR_NAME} and run `}${chalkStderr.bold("npx convex login")} and try again.`,
+        printedMessage: `Deleting a deploy key requires being logged in with a personal access token. ${
+          auth === null
+            ? "Run "
+            : process.env[CONVEX_DEPLOYMENT_TOKEN_ENV_VAR_NAME] &&
+                !process.env[CONVEX_DEPLOY_KEY_ENV_VAR_NAME]
+              ? `Unset ${CONVEX_DEPLOYMENT_TOKEN_ENV_VAR_NAME} and run `
+              : `Unset ${CONVEX_DEPLOY_KEY_ENV_VAR_NAME} and run `
+        }${chalkStderr.bold("npx convex login")} and try again.`,
       });
     }
 

package/src/cli/index.ts

@@ -26,7 +26,6 @@ import { data } from "./data.js";
 import { format } from "util";
 import { functionSpec } from "./functionSpec.js";
 import { insights } from "./insights.js";
-import { disableLocalDeployments } from "./disableLocalDev.js";
 import { mcp } from "./mcp.js";
 import { deployment } from "./deployment.js";
 import { aiFiles } from "./aiFiles.js";
@@ -161,7 +160,6 @@ async function main() {
     .addCommand(integration, { hidden: true })
     .addCommand(functionSpec)
     .addCommand(insights)
-    .addCommand(disableLocalDeployments)
     .addCommand(mcp)
     .addCommand(aiFiles)
     .helpCommand("help <command>", "Show help for given <command>")
@@ -183,6 +181,12 @@ async function main() {
   } finally {
     await Sentry.close();
   }
+  // When stdout is a pipe, Node buffers writes and `process.exit()` does not
+  // wait for them to flush — drain first so piped output isn't truncated.
+  await Promise.all([
+    new Promise<void>((resolve) => process.stdout.write("", () => resolve())),
+    new Promise<void>((resolve) => process.stderr.write("", () => resolve())),
+  ]);
   process.exit();
 }
 void main();