convex 1.40.0 → 1.41.0

package/dist/esm/cli/lib/command.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/lib/command.ts"],
-  "sourcesContent": ["import { Command, Option, OptionValues } from \"@commander-js/extra-typings\";\nimport { OneoffCtx } from \"../../bundler/context.js\";\nimport { LogMode } from \"./logs.js\";\nimport {\n  CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n  CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME,\n  CONVEX_SELF_HOSTED_URL_VAR_NAME,\n  parseInteger,\n  parsePositiveInteger,\n} from \"./utils/utils.js\";\nimport { INLINE_QUERY_DESCRIPTION } from \"./runTestFunction.js\";\n\ndeclare module \"@commander-js/extra-typings\" {\n  interface Command<Args extends any[] = [], Opts extends OptionValues = {}> {\n    /**\n     * For a command that talks to the configured dev deployment by default,\n     * add flags for talking to prod, preview, or other deployment in the same\n     * project.\n     *\n     * These flags are added to the end of `command` (ordering matters for `--help`\n     * output). `action` should look like \"Import data into\" because it is prefixed\n     * onto help strings.\n     *\n     * The options can be passed to `deploymentSelectionFromOptions`.\n     *\n     * NOTE: This method only exists at runtime if this file is imported.\n     * To help avoid this bug, this method takes in an `ActionDescription` which\n     * can only be constructed via `actionDescription` from this file.\n     *\n     * @param action - The action description\n     * @param options - Optional settings\n     * @param options.showUrlHelp - If true, show the --url option in help output\n     */\n    addDeploymentSelectionOptions(\n      action: ActionDescription,\n      options?: { showUrlHelp?: boolean },\n    ): Command<\n      Args,\n      Opts & {\n        envFile?: string;\n        url?: string;\n        adminKey?: string;\n        prod?: boolean;\n        previewName?: string;\n        deploymentName?: string;\n        deployment?: string;\n      }\n    >;\n\n    /**\n     * Adds options for the `deploy` command.\n     */\n    addDeployOptions(): Command<\n      Args,\n      Opts & {\n        verbose?: boolean;\n        dryRun?: boolean;\n        yes?: boolean;\n        typecheck: \"enable\" | \"try\" | \"disable\";\n        typecheckComponents: boolean;\n        codegen: \"enable\" | \"disable\";\n        cmd?: string;\n        cmdUrlEnvVarName?: string;\n        debugBundlePath?: string;\n        debug?: boolean;\n        writePushRequest?: string;\n        liveComponentSources?: boolean;\n      }\n    >;\n\n    /**\n     * Adds options for `self-host` subcommands.\n     */\n    addSelfHostOptions(): Command<\n      Args,\n      Opts & {\n        url?: string;\n        adminKey?: string;\n        env?: string;\n      }\n    >;\n\n    /**\n     * Adds options and arguments for the `run` command.\n     */\n    addRunOptions(): Command<\n      [...Args, string | undefined, string | undefined],\n      Opts & {\n        watch?: boolean;\n        push?: boolean;\n        identity?: string;\n        inlineQuery?: string;\n        typecheck: \"enable\" | \"try\" | \"disable\";\n        typecheckComponents: boolean;\n        codegen: \"enable\" | \"disable\";\n        component?: string;\n        liveComponentSources?: boolean;\n      }\n    >;\n\n    /**\n     * Adds options for the `import` command.\n     */\n    addImportOptions(): Command<\n      [...Args, string],\n      Opts & {\n        table?: string;\n        format?: \"csv\" | \"jsonLines\" | \"jsonArray\" | \"zip\";\n        replace?: boolean;\n        append?: boolean;\n        replaceAll?: boolean;\n        yes?: boolean;\n        component?: string;\n      }\n    >;\n\n    /**\n     * Adds options for the `export` command.\n     */\n    addExportOptions(): Command<\n      Args,\n      Opts & {\n        path: string;\n        includeFileStorage?: boolean;\n      }\n    >;\n\n    /**\n     * Adds options for the `data` command.\n     */\n    addDataOptions(): Command<\n      [...Args, string | undefined],\n      Opts & {\n        limit: number;\n        order: \"asc\" | \"desc\";\n        component?: string;\n        format?: \"json\" | \"jsonArray\" | \"jsonLines\" | \"jsonl\" | \"pretty\";\n      }\n    >;\n\n    /**\n     * Adds options for the `logs` command.\n     */\n    addLogsOptions(): Command<\n      Args,\n      Opts & {\n        history: number;\n        success: boolean;\n        jsonl: boolean;\n        tail?: number | boolean;\n      }\n    >;\n\n    /**\n     * Adds options for the `network-test` command.\n     */\n    addNetworkTestOptions(): Command<\n      Args,\n      Opts & {\n        timeout?: string;\n        ipFamily?: string;\n        speedTest?: boolean;\n      }\n    >;\n  }\n}\n\nCommand.prototype.addDeploymentSelectionOptions = function (\n  action: ActionDescription,\n  options?: { showUrlHelp?: boolean },\n) {\n  const urlOption = new Option(\n    \"--url <url>\",\n    options?.showUrlHelp\n      ? action + \" the deployment at the given URL.\"\n      : undefined,\n  ).conflicts([\n    \"--prod\",\n    \"--preview-name\",\n    \"--deployment-name\",\n    \"--deployment\",\n  ]);\n  if (!options?.showUrlHelp) {\n    urlOption.hideHelp();\n  }\n  return this.addOption(urlOption)\n    .addOption(new Option(\"--admin-key <adminKey>\").hideHelp())\n    .addOption(\n      new Option(\n        \"--prod\",\n        action + \" this project's default production deployment.\",\n      ).conflicts([\n        \"--preview-name\",\n        \"--deployment-name\",\n        \"--url\",\n        \"--deployment\",\n      ]),\n    )\n    .addOption(\n      new Option(\n        \"--preview-name <previewName>\",\n        action + \" the preview deployment with the given name.\",\n      )\n        .conflicts([\"--prod\", \"--deployment-name\", \"--url\", \"--deployment\"])\n        .hideHelp(),\n    )\n    .addOption(\n      new Option(\n        \"--deployment-name <deploymentName>\",\n        action + \" the specified deployment.\",\n      )\n        .conflicts([\"--prod\", \"--preview-name\", \"--url\", \"--deployment\"])\n        .hideHelp(),\n    )\n    .addOption(\n      new Option(\n        \"--deployment <deployment>\",\n        action +\n          \" a specific deployment. Accepts:\\n\" +\n          \"\u2022 a deployment name (e.g. joyful-capybara-123)\\n\" +\n          \"\u2022 a deployment reference (e.g. dev/james, staging)\\n\" +\n          \"\u2022 `dev` (for your personal dev deployment)\\n\" +\n          \"\u2022 `prod` (for your project\u2019s default production deployment)\\n\" +\n          \"\u2022 `local` (for your local dev deployment).\" +\n          \"\\nYou can also select deployments in other projects with `project-slug:reference` or `team-slug:project-slug:reference`.\",\n      ).conflicts([\"--prod\", \"--preview-name\", \"--deployment-name\", \"--url\"]),\n    )\n    .addOption(\n      new Option(\n        \"--env-file <envFile>\",\n        `Path to a custom file of environment variables, for choosing the \\\ndeployment, e.g. ${CONVEX_DEPLOYMENT_ENV_VAR_NAME} or ${CONVEX_SELF_HOSTED_URL_VAR_NAME}. \\\nSame format as .env.local or .env files, and overrides them.`,\n      ).hideHelp(),\n    ) as any;\n};\n\ndeclare const tag: unique symbol;\ntype ActionDescription = string & { readonly [tag]: \"noop\" };\nexport function actionDescription(action: string): ActionDescription {\n  return action as any;\n}\n\nexport async function normalizeDevOptions(\n  ctx: OneoffCtx,\n  cmdOptions: {\n    verbose?: boolean;\n    typecheck: \"enable\" | \"try\" | \"disable\";\n    typecheckComponents?: boolean;\n    codegen: \"enable\" | \"disable\";\n    once?: boolean;\n    untilSuccess: boolean;\n    start?: string;\n    runSh?: string;\n    run?: string | undefined;\n    runComponent?: string;\n    tailLogs?: string | true;\n    traceEvents: boolean;\n    debugBundlePath?: string | undefined;\n    debugNodeApis?: boolean;\n    liveComponentSources?: boolean;\n    pushAllModules?: boolean;\n    while?: string;\n  },\n): Promise<{\n  verbose: boolean;\n  typecheck: \"enable\" | \"try\" | \"disable\";\n  typecheckComponents: boolean;\n  codegen: boolean;\n  once: boolean;\n  untilSuccess: boolean;\n  run?:\n    | { kind: \"function\"; name: string; component?: string | undefined }\n    | { kind: \"shell\"; command: string }\n    | undefined;\n  tailLogs: LogMode;\n  traceEvents: boolean;\n  debugBundlePath?: string | undefined;\n  debugNodeApis: boolean;\n  liveComponentSources: boolean;\n  pushAllModules: boolean;\n}> {\n  if (cmdOptions.runComponent && !cmdOptions.run) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: \"Can't specify `--run-component` option without `--run`\",\n    });\n  }\n\n  if (cmdOptions.debugBundlePath !== undefined && !cmdOptions.once) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: \"`--debug-bundle-path` can only be used with `--once`.\",\n    });\n  }\n  if (cmdOptions.debugNodeApis && !cmdOptions.once) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: \"`--debug-node-apis` can only be used with `--once`.\",\n    });\n  }\n\n  return {\n    verbose: !!cmdOptions.verbose,\n    typecheck: cmdOptions.typecheck,\n    typecheckComponents: !!cmdOptions.typecheckComponents,\n    codegen: cmdOptions.codegen === \"enable\",\n    once: !!cmdOptions.once,\n    untilSuccess: cmdOptions.untilSuccess,\n    run:\n      cmdOptions.run !== undefined\n        ? {\n            kind: \"function\",\n            name: cmdOptions.run,\n            component: cmdOptions.runComponent,\n          }\n        : (cmdOptions.start ?? cmdOptions.runSh) !== undefined\n          ? {\n              kind: \"shell\",\n              command: (cmdOptions.start ?? cmdOptions.runSh)!,\n            }\n          : undefined,\n    tailLogs:\n      typeof cmdOptions.tailLogs === \"string\"\n        ? (cmdOptions.tailLogs as LogMode)\n        : \"pause-on-deploy\",\n    traceEvents: cmdOptions.traceEvents,\n    debugBundlePath: cmdOptions.debugBundlePath,\n    debugNodeApis: !!cmdOptions.debugNodeApis,\n    liveComponentSources: !!cmdOptions.liveComponentSources,\n    pushAllModules: !!cmdOptions.pushAllModules,\n  };\n}\n\nCommand.prototype.addDeployOptions = function () {\n  return this.option(\"-v, --verbose\", \"Show full listing of changes\")\n    .option(\n      \"--dry-run\",\n      \"Print out the generated configuration without deploying to your Convex deployment\",\n    )\n    .addOption(\n      new Option(\n        \"-y, --yes\",\n        \"Skip confirmation prompt when running interactively. Warning: this deploys to PRODUCTION. To deploy to your current dev environment, run npx convex dev --once\",\n      ).hideHelp(),\n    )\n    .addOption(\n      new Option(\n        \"--typecheck <mode>\",\n        `Whether to check TypeScript files with \\`tsc --noEmit\\` before deploying.`,\n      )\n        .choices([\"enable\", \"try\", \"disable\"] as const)\n        .default(\"try\" as const),\n    )\n    .option(\n      \"--typecheck-components\",\n      \"Check TypeScript files within component implementations with `tsc --noEmit`.\",\n      false,\n    )\n    .addOption(\n      new Option(\n        \"--codegen <mode>\",\n        \"Whether to regenerate code in `convex/_generated/` before pushing.\",\n      )\n        .choices([\"enable\", \"disable\"] as const)\n        .default(\"enable\" as const),\n    )\n    .addOption(\n      new Option(\n        \"--cmd <command>\",\n        \"Command to run as part of deploying your app (e.g. `vite build`). This command can depend on the environment variables specified in `--cmd-url-env-var-name` being set.\",\n      ),\n    )\n    .addOption(\n      new Option(\n        \"--cmd-url-env-var-name <name>\",\n        \"Environment variable name to set Convex deployment URL (e.g. `VITE_CONVEX_URL`) when using `--cmd`\",\n      ),\n    )\n    .addOption(new Option(\"--debug-bundle-path <path>\").hideHelp())\n    .addOption(new Option(\"--debug\").hideHelp())\n    .addOption(new Option(\"--write-push-request <writePushRequest>\").hideHelp())\n    .addOption(new Option(\"--live-component-sources\").hideHelp())\n    .addOption(\n      new Option(\n        \"--push-all-modules\",\n        \"Push all modules without checking for unchanged module hashes from the server\",\n      )\n        .default(false)\n        .hideHelp(),\n    );\n};\n\nCommand.prototype.addSelfHostOptions = function () {\n  return this.option(\n    \"--admin-key <adminKey>\",\n    `An admin key for the deployment. Can alternatively be set as \\`${CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME}\\` environment variable.`,\n  )\n    .option(\n      \"--url <url>\",\n      `The url of the deployment. Can alternatively be set as \\`${CONVEX_SELF_HOSTED_URL_VAR_NAME}\\` environment variable.`,\n    )\n    .option(\n      \"--env <env>\",\n      `Path to a custom file of environment variables, containing \\`${CONVEX_SELF_HOSTED_URL_VAR_NAME}\\` and \\`${CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME}\\`.`,\n    );\n};\n\nCommand.prototype.addRunOptions = function () {\n  return (\n    this.argument(\n      \"[functionName]\",\n      \"identifier of the function to run, like `listMessages` or `dir/file:myFunction`\",\n    )\n      .argument(\n        \"[args]\",\n        \"JSON-formatted arguments object to pass to the function.\",\n      )\n      .option(\n        \"-w, --watch\",\n        \"Watch a query, printing its result if the underlying data changes. Given function must be a query.\",\n      )\n      .addOption(\n        new Option(\n          \"--inline-query <query>\",\n          INLINE_QUERY_DESCRIPTION,\n        ).conflicts(\"--watch\"),\n      )\n      .option(\"--push\", \"Push code to deployment before running the function.\")\n      .addOption(\n        new Option(\n          \"--identity <identity>\",\n          'JSON-formatted UserIdentity object, e.g. \\'{ name: \"John\", address: \"0x123\" }\\'',\n        ),\n      )\n      // For backwards compatibility we still support --no-push which is a noop\n      .addOption(new Option(\"--no-push\").hideHelp())\n      // Options for the deploy that --push does\n      .addOption(\n        new Option(\n          \"--typecheck <mode>\",\n          `Whether to check TypeScript files with \\`tsc --noEmit\\`.`,\n        )\n          .choices([\"enable\", \"try\", \"disable\"] as const)\n          .default(\"try\" as const),\n      )\n      .option(\n        \"--typecheck-components\",\n        \"Check TypeScript files within component implementations with `tsc --noEmit`.\",\n        false,\n      )\n      .addOption(\n        new Option(\n          \"--codegen <mode>\",\n          \"Regenerate code in `convex/_generated/`\",\n        )\n          .choices([\"enable\", \"disable\"] as const)\n          .default(\"enable\" as const),\n      )\n      .addOption(\n        new Option(\n          \"--component <path>\",\n          'Path to the component (e.g. \"workflow\" or \"workflow/workpool\")',\n        ),\n      )\n      .addOption(new Option(\"--live-component-sources\").hideHelp())\n  );\n};\n\nCommand.prototype.addImportOptions = function () {\n  return this.argument(\"<path>\", \"Path to the input file\")\n    .addOption(\n      new Option(\n        \"--table <table>\",\n        \"Destination table name. Required if format is csv, jsonLines, or jsonArray. Not supported if format is zip.\",\n      ),\n    )\n    .addOption(\n      new Option(\n        \"--replace\",\n        \"Replace all existing data in any of the imported tables\",\n      )\n        .conflicts(\"--append\")\n        .conflicts(\"--replace-all\"),\n    )\n    .addOption(\n      new Option(\"--append\", \"Append imported data to any existing tables\")\n        .conflicts(\"--replace-all\")\n        .conflicts(\"--replace\"),\n    )\n    .addOption(\n      new Option(\n        \"--replace-all\",\n        \"Replace all existing data in the deployment with the imported tables,\\n\" +\n          \"  deleting tables that don't appear in the import file or the schema,\\n\" +\n          \"  and clearing tables that appear in the schema but not in the import file\",\n      )\n        .conflicts(\"--append\")\n        .conflicts(\"--replace\"),\n    )\n    .option(\n      \"-y, --yes\",\n      \"Skip confirmation prompt when import leads to deleting existing documents\",\n    )\n    .addOption(\n      new Option(\n        \"--format <format>\",\n        \"Input file format. This flag is only required if the filename is missing an extension.\\n\" +\n          \"- CSV files must have a header, and each row's entries are interpreted either as a (floating point) number or a string.\\n\" +\n          \"- JSON files must be an array of JSON objects.\\n\" +\n          \"- JSONLines files must have a JSON object per line.\\n\" +\n          \"- ZIP files must have one directory per table, containing <table>/documents.jsonl. Snapshot exports from the Convex dashboard have this format.\",\n      ).choices([\"csv\", \"jsonLines\", \"jsonArray\", \"zip\"]),\n    )\n    .addOption(\n      new Option(\n        \"--component <path>\",\n        'Path to the component (e.g. \"workflow\" or \"workflow/workpool\")',\n      ),\n    );\n};\n\nCommand.prototype.addExportOptions = function () {\n  return this.requiredOption(\n    \"--path <zipFilePath>\",\n    \"Exports data into a ZIP file at this path, which may be a directory or unoccupied .zip path\",\n  ).addOption(\n    new Option(\n      \"--include-file-storage\",\n      \"Includes stored files (https://dashboard.convex.dev/deployment/files) in a _storage folder within the ZIP file\",\n    ),\n  );\n};\n\nCommand.prototype.addDataOptions = function () {\n  return this.addOption(\n    new Option(\n      \"--limit <n>\",\n      \"List only the `n` the most recently created documents.\",\n    )\n      .default(100)\n      .argParser(parsePositiveInteger),\n  )\n    .addOption(\n      new Option(\n        \"--order <choice>\",\n        \"Order the documents by their `_creationTime`.\",\n      )\n        .choices([\"asc\", \"desc\"])\n        .default(\"desc\"),\n    )\n    .addOption(\n      new Option(\n        \"--component <path>\",\n        'Path to the component (e.g. \"workflow\" or \"workflow/workpool\")',\n      ),\n    )\n    .addOption(\n      new Option(\n        \"--format <format>\",\n        \"Format to print the data in. This flag is only required if the filename is missing an extension.\\n\" +\n          \"- jsonArray (aka json): print the data as a JSON array of objects.\\n\" +\n          \"- jsonLines (aka jsonl): print the data as a JSON object per line.\\n\" +\n          \"- pretty: print the data in a human-readable format.\",\n      ).choices([\"jsonArray\", \"json\", \"jsonLines\", \"jsonl\", \"pretty\"]),\n    )\n    .argument(\"[table]\", \"If specified, list documents in this table.\");\n};\n\nCommand.prototype.addLogsOptions = function () {\n  return this.option(\n    \"--history [n]\",\n    \"Show `n` most recent logs. Defaults to showing all available logs.\",\n    parseInteger,\n  )\n    .option(\n      \"--success\",\n      \"Print a log line for every successful function execution\",\n      false,\n    )\n    .option(\"--jsonl\", \"Output raw log events as JSONL\", false)\n    .addOption(\n      new Option(\n        \"--tail [n]\",\n        \"Deprecated/unnecessary: `convex logs` already tails by default. Accepted as an alias for --history for compatibility with agents that pass it.\",\n      )\n        .argParser(parseInteger)\n        .hideHelp(),\n    );\n};\n\nCommand.prototype.addNetworkTestOptions = function () {\n  return this.addOption(\n    new Option(\n      \"--timeout <timeout>\",\n      \"Timeout in seconds for the network test (default: 30).\",\n    ),\n  )\n    .addOption(\n      new Option(\n        \"--ip-family <ipFamily>\",\n        \"IP family to use (ipv4, ipv6, or auto)\",\n      ),\n    )\n    .addOption(\n      new Option(\n        \"--speed-test\",\n        \"Perform a large echo test to measure network speed.\",\n      ),\n    );\n};\n"],
+  "sourcesContent": ["import { Command, Option, OptionValues } from \"@commander-js/extra-typings\";\nimport { OneoffCtx } from \"../../bundler/context.js\";\nimport { LogMode } from \"./logs.js\";\nimport {\n  CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n  CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME,\n  CONVEX_SELF_HOSTED_URL_VAR_NAME,\n  parseInteger,\n  parsePositiveInteger,\n} from \"./utils/utils.js\";\nimport { INLINE_QUERY_DESCRIPTION } from \"./runTestFunction.js\";\n\ndeclare module \"@commander-js/extra-typings\" {\n  interface Command<Args extends any[] = [], Opts extends OptionValues = {}> {\n    /**\n     * For a command that talks to the configured dev deployment by default,\n     * add flags for talking to prod, preview, or other deployment in the same\n     * project.\n     *\n     * These flags are added to the end of `command` (ordering matters for `--help`\n     * output). `action` should look like \"Import data into\" because it is prefixed\n     * onto help strings.\n     *\n     * The options can be passed to `deploymentSelectionFromOptions`.\n     *\n     * NOTE: This method only exists at runtime if this file is imported.\n     * To help avoid this bug, this method takes in an `ActionDescription` which\n     * can only be constructed via `actionDescription` from this file.\n     *\n     * @param action - The action description\n     * @param options - Optional settings\n     * @param options.showUrlHelp - If true, show the --url option in help output\n     */\n    addDeploymentSelectionOptions(\n      action: ActionDescription,\n      options?: { showUrlHelp?: boolean },\n    ): Command<\n      Args,\n      Opts & {\n        envFile?: string;\n        url?: string;\n        adminKey?: string;\n        prod?: boolean;\n        previewName?: string;\n        deploymentName?: string;\n        deployment?: string;\n      }\n    >;\n\n    /**\n     * Adds options for the `deploy` command.\n     */\n    addDeployOptions(): Command<\n      Args,\n      Opts & {\n        verbose?: boolean;\n        dryRun?: boolean;\n        yes?: boolean;\n        typecheck: \"enable\" | \"try\" | \"disable\";\n        typecheckComponents: boolean;\n        codegen: \"enable\" | \"disable\";\n        cmd?: string;\n        cmdUrlEnvVarName?: string;\n        debugBundlePath?: string;\n        debug?: boolean;\n        writePushRequest?: string;\n        liveComponentSources?: boolean;\n      }\n    >;\n\n    /**\n     * Adds options for `self-host` subcommands.\n     */\n    addSelfHostOptions(): Command<\n      Args,\n      Opts & {\n        url?: string;\n        adminKey?: string;\n        env?: string;\n      }\n    >;\n\n    /**\n     * Adds options and arguments for the `run` command.\n     */\n    addRunOptions(): Command<\n      [...Args, string | undefined, string | undefined],\n      Opts & {\n        watch?: boolean;\n        push?: boolean;\n        identity?: string;\n        inlineQuery?: string;\n        typecheck: \"enable\" | \"try\" | \"disable\";\n        typecheckComponents: boolean;\n        codegen: \"enable\" | \"disable\";\n        component?: string;\n        liveComponentSources?: boolean;\n      }\n    >;\n\n    /**\n     * Adds options for the `import` command.\n     */\n    addImportOptions(): Command<\n      [...Args, string],\n      Opts & {\n        table?: string;\n        format?: \"csv\" | \"jsonLines\" | \"jsonArray\" | \"zip\";\n        replace?: boolean;\n        append?: boolean;\n        replaceAll?: boolean;\n        yes?: boolean;\n        component?: string;\n      }\n    >;\n\n    /**\n     * Adds options for the `export` command.\n     */\n    addExportOptions(): Command<\n      Args,\n      Opts & {\n        path: string;\n        includeFileStorage?: boolean;\n      }\n    >;\n\n    /**\n     * Adds options for the `data` command.\n     */\n    addDataOptions(): Command<\n      [...Args, string | undefined],\n      Opts & {\n        limit: number;\n        order: \"asc\" | \"desc\";\n        component?: string;\n        format?: \"json\" | \"jsonArray\" | \"jsonLines\" | \"jsonl\" | \"pretty\";\n      }\n    >;\n\n    /**\n     * Adds options for the `logs` command.\n     */\n    addLogsOptions(): Command<\n      Args,\n      Opts & {\n        history: number;\n        success: boolean;\n        jsonl: boolean;\n        tail?: number | boolean;\n      }\n    >;\n\n    /**\n     * Adds options for the `network-test` command.\n     */\n    addNetworkTestOptions(): Command<\n      Args,\n      Opts & {\n        timeout?: string;\n        ipFamily?: string;\n        speedTest?: boolean;\n      }\n    >;\n  }\n}\n\nCommand.prototype.addDeploymentSelectionOptions = function (\n  action: ActionDescription,\n  options?: { showUrlHelp?: boolean },\n) {\n  const urlOption = new Option(\n    \"--url <url>\",\n    options?.showUrlHelp\n      ? action + \" the deployment at the given URL.\"\n      : undefined,\n  ).conflicts([\n    \"--prod\",\n    \"--preview-name\",\n    \"--deployment-name\",\n    \"--deployment\",\n  ]);\n  if (!options?.showUrlHelp) {\n    urlOption.hideHelp();\n  }\n  return this.addOption(urlOption)\n    .addOption(new Option(\"--admin-key <adminKey>\").hideHelp())\n    .addOption(\n      new Option(\n        \"--prod\",\n        action + \" this project's default production deployment.\",\n      ).conflicts([\n        \"--preview-name\",\n        \"--deployment-name\",\n        \"--url\",\n        \"--deployment\",\n      ]),\n    )\n    .addOption(\n      new Option(\n        \"--preview-name <previewName>\",\n        action + \" the preview deployment with the given name.\",\n      )\n        .conflicts([\"--prod\", \"--deployment-name\", \"--url\", \"--deployment\"])\n        .hideHelp(),\n    )\n    .addOption(\n      new Option(\n        \"--deployment-name <deploymentName>\",\n        action + \" the specified deployment.\",\n      )\n        .conflicts([\"--prod\", \"--preview-name\", \"--url\", \"--deployment\"])\n        .hideHelp(),\n    )\n    .addOption(\n      new Option(\n        \"--deployment <deployment>\",\n        action +\n          \" a specific deployment. Accepts:\\n\" +\n          \"\u2022 a deployment name (e.g. joyful-capybara-123)\\n\" +\n          \"\u2022 a deployment reference (e.g. dev/james, staging)\\n\" +\n          \"\u2022 `dev` (for your personal dev deployment)\\n\" +\n          \"\u2022 `prod` (for your project\u2019s default production deployment)\\n\" +\n          \"\u2022 `local` (for your local dev deployment).\" +\n          \"\\nYou can also select deployments in other projects with `project-slug:reference` or `team-slug:project-slug:reference`.\",\n      ).conflicts([\"--prod\", \"--preview-name\", \"--deployment-name\", \"--url\"]),\n    )\n    .addOption(\n      new Option(\n        \"--env-file <envFile>\",\n        `Path to a custom file of environment variables, for choosing the \\\ndeployment, e.g. ${CONVEX_DEPLOYMENT_ENV_VAR_NAME} or ${CONVEX_SELF_HOSTED_URL_VAR_NAME}. \\\nSame format as .env.local or .env files, and overrides them.`,\n      ).hideHelp(),\n    ) as any;\n};\n\ndeclare const tag: unique symbol;\ntype ActionDescription = string & { readonly [tag]: \"noop\" };\nexport function actionDescription(action: string): ActionDescription {\n  return action as any;\n}\n\nexport async function normalizeDevOptions(\n  ctx: OneoffCtx,\n  cmdOptions: {\n    verbose?: boolean;\n    typecheck: \"enable\" | \"try\" | \"disable\";\n    typecheckComponents?: boolean;\n    codegen: \"enable\" | \"disable\";\n    once?: boolean;\n    untilSuccess: boolean;\n    start?: string;\n    runSh?: string;\n    run?: string | undefined;\n    runComponent?: string;\n    tailLogs?: string | true;\n    traceEvents: boolean;\n    debugBundlePath?: string | undefined;\n    debugNodeApis?: boolean;\n    liveComponentSources?: boolean;\n    pushAllModules?: boolean;\n    while?: string;\n  },\n): Promise<{\n  verbose: boolean;\n  typecheck: \"enable\" | \"try\" | \"disable\";\n  typecheckComponents: boolean;\n  codegen: boolean;\n  once: boolean;\n  untilSuccess: boolean;\n  run?:\n    | { kind: \"function\"; name: string; component?: string | undefined }\n    | { kind: \"shell\"; command: string }\n    | undefined;\n  tailLogs: LogMode;\n  traceEvents: boolean;\n  debugBundlePath?: string | undefined;\n  debugNodeApis: boolean;\n  liveComponentSources: boolean;\n  pushAllModules: boolean;\n}> {\n  if (cmdOptions.runComponent && !cmdOptions.run) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: \"Can't specify `--run-component` option without `--run`\",\n    });\n  }\n\n  if (cmdOptions.debugBundlePath !== undefined && !cmdOptions.once) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: \"`--debug-bundle-path` can only be used with `--once`.\",\n    });\n  }\n  if (cmdOptions.debugNodeApis && !cmdOptions.once) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: \"`--debug-node-apis` can only be used with `--once`.\",\n    });\n  }\n\n  return {\n    verbose: !!cmdOptions.verbose,\n    typecheck: cmdOptions.typecheck,\n    typecheckComponents: !!cmdOptions.typecheckComponents,\n    codegen: cmdOptions.codegen === \"enable\",\n    once: !!cmdOptions.once,\n    untilSuccess: cmdOptions.untilSuccess,\n    run:\n      cmdOptions.run !== undefined\n        ? {\n            kind: \"function\",\n            name: cmdOptions.run,\n            component: cmdOptions.runComponent,\n          }\n        : (cmdOptions.start ?? cmdOptions.runSh) !== undefined\n          ? {\n              kind: \"shell\",\n              command: (cmdOptions.start ?? cmdOptions.runSh)!,\n            }\n          : undefined,\n    tailLogs:\n      typeof cmdOptions.tailLogs === \"string\"\n        ? (cmdOptions.tailLogs as LogMode)\n        : \"pause-on-deploy\",\n    traceEvents: cmdOptions.traceEvents,\n    debugBundlePath: cmdOptions.debugBundlePath,\n    debugNodeApis: !!cmdOptions.debugNodeApis,\n    liveComponentSources: !!cmdOptions.liveComponentSources,\n    pushAllModules: !!cmdOptions.pushAllModules,\n  };\n}\n\nCommand.prototype.addDeployOptions = function () {\n  return this.option(\"-v, --verbose\", \"Show full listing of changes\")\n    .option(\n      \"--dry-run\",\n      \"Print out the generated configuration without deploying to your Convex deployment\",\n    )\n    .addOption(\n      new Option(\n        \"-y, --yes\",\n        \"Skip confirmation prompt when running interactively. Warning: this deploys to PRODUCTION. To deploy to your current dev environment, run npx convex dev --once\",\n      ).hideHelp(),\n    )\n    .addOption(\n      new Option(\n        \"--typecheck <mode>\",\n        `Whether to check TypeScript files with \\`tsc --noEmit\\` before deploying.`,\n      )\n        .choices([\"enable\", \"try\", \"disable\"] as const)\n        .default(\"try\" as const),\n    )\n    .option(\n      \"--typecheck-components\",\n      \"Check TypeScript files within component implementations with `tsc --noEmit`.\",\n      false,\n    )\n    .addOption(\n      new Option(\n        \"--codegen <mode>\",\n        \"Whether to regenerate code in `convex/_generated/` before pushing.\",\n      )\n        .choices([\"enable\", \"disable\"] as const)\n        .default(\"enable\" as const),\n    )\n    .addOption(\n      new Option(\n        \"--cmd <command>\",\n        \"Command to run as part of deploying your app (e.g. `vite build`). This command can depend on the environment variables specified in `--cmd-url-env-var-name` being set.\",\n      ),\n    )\n    .addOption(\n      new Option(\n        \"--cmd-url-env-var-name <name>\",\n        \"Environment variable name to set Convex deployment URL (e.g. `VITE_CONVEX_URL`) when using `--cmd`\",\n      ),\n    )\n    .addOption(new Option(\"--debug-bundle-path <path>\").hideHelp())\n    .addOption(new Option(\"--debug\").hideHelp())\n    .addOption(new Option(\"--write-push-request <writePushRequest>\").hideHelp())\n    .addOption(new Option(\"--live-component-sources\").hideHelp())\n    .addOption(\n      new Option(\n        \"--push-all-modules\",\n        \"Push all modules without checking for unchanged module hashes from the server\",\n      )\n        .default(false)\n        .hideHelp(),\n    );\n};\n\nCommand.prototype.addSelfHostOptions = function () {\n  return this.option(\n    \"--admin-key <adminKey>\",\n    `An admin key for the deployment. Can alternatively be set as \\`${CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME}\\` environment variable.`,\n  )\n    .option(\n      \"--url <url>\",\n      `The url of the deployment. Can alternatively be set as \\`${CONVEX_SELF_HOSTED_URL_VAR_NAME}\\` environment variable.`,\n    )\n    .option(\n      \"--env <env>\",\n      `Path to a custom file of environment variables, containing \\`${CONVEX_SELF_HOSTED_URL_VAR_NAME}\\` and \\`${CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME}\\`.`,\n    );\n};\n\nCommand.prototype.addRunOptions = function () {\n  return (\n    this.argument(\n      \"[functionName]\",\n      \"identifier of the function to run, like `listMessages` or `dir/file:myFunction`\",\n    )\n      .argument(\n        \"[args]\",\n        \"JSON-formatted arguments object to pass to the function.\",\n      )\n      .option(\n        \"-w, --watch\",\n        \"Watch a query, printing its result if the underlying data changes. Given function must be a query.\",\n      )\n      .addOption(\n        new Option(\n          \"--inline-query <query>\",\n          INLINE_QUERY_DESCRIPTION,\n        ).conflicts(\"--watch\"),\n      )\n      .option(\"--push\", \"Push code to deployment before running the function.\")\n      .addOption(\n        new Option(\n          \"--identity <identity>\",\n          'JSON-formatted UserIdentity object, e.g. \\'{ name: \"John\", address: \"0x123\" }\\'',\n        ),\n      )\n      // For backwards compatibility we still support --no-push which is a noop\n      .addOption(new Option(\"--no-push\").hideHelp())\n      // Options for the deploy that --push does\n      .addOption(\n        new Option(\n          \"--typecheck <mode>\",\n          `Whether to check TypeScript files with \\`tsc --noEmit\\`.`,\n        )\n          .choices([\"enable\", \"try\", \"disable\"] as const)\n          .default(\"try\" as const),\n      )\n      .option(\n        \"--typecheck-components\",\n        \"Check TypeScript files within component implementations with `tsc --noEmit`.\",\n        false,\n      )\n      .addOption(\n        new Option(\n          \"--codegen <mode>\",\n          \"Regenerate code in `convex/_generated/`\",\n        )\n          .choices([\"enable\", \"disable\"] as const)\n          .default(\"enable\" as const),\n      )\n      .addOption(\n        new Option(\n          \"--component <path>\",\n          'Path to the component (e.g. \"workflow\" or \"workflow/workpool\")',\n        ),\n      )\n      .addOption(new Option(\"--live-component-sources\").hideHelp())\n  );\n};\n\nCommand.prototype.addImportOptions = function () {\n  return this.argument(\"<path>\", \"Path to the input file\")\n    .addOption(\n      new Option(\n        \"--table <table>\",\n        \"Destination table name. Required if format is csv, jsonLines, or jsonArray. Not supported if format is zip.\",\n      ),\n    )\n    .addOption(\n      new Option(\n        \"--replace\",\n        \"Replace all existing data in any of the imported tables\",\n      )\n        .conflicts(\"--append\")\n        .conflicts(\"--replace-all\"),\n    )\n    .addOption(\n      new Option(\"--append\", \"Append imported data to any existing tables\")\n        .conflicts(\"--replace-all\")\n        .conflicts(\"--replace\"),\n    )\n    .addOption(\n      new Option(\n        \"--replace-all\",\n        \"Replace all existing data in the deployment with the imported tables,\\n\" +\n          \"deleting tables that don't appear in the import file or the schema,\\n\" +\n          \"and clearing tables that appear in the schema but not in the import file\",\n      )\n        .conflicts(\"--append\")\n        .conflicts(\"--replace\"),\n    )\n    .option(\n      \"-y, --yes\",\n      \"Skip confirmation prompt when import leads to deleting existing documents\",\n    )\n    .addOption(\n      new Option(\n        \"--format <format>\",\n        \"Input file format. This flag is only required if the filename is missing an extension.\\n\" +\n          \"- CSV files must have a header, and each row's entries are interpreted either as a (floating point) number or a string.\\n\" +\n          \"- JSON files must be an array of JSON objects.\\n\" +\n          \"- JSONLines files must have a JSON object per line.\\n\" +\n          \"- ZIP files must have one directory per table, containing <table>/documents.jsonl. Snapshot exports from the Convex dashboard have this format.\",\n      ).choices([\"csv\", \"jsonLines\", \"jsonArray\", \"zip\"]),\n    )\n    .addOption(\n      new Option(\n        \"--component <path>\",\n        'Path to the component (e.g. \"workflow\" or \"workflow/workpool\")',\n      ),\n    );\n};\n\nCommand.prototype.addExportOptions = function () {\n  return this.requiredOption(\n    \"--path <zipFilePath>\",\n    \"Exports data into a ZIP file at this path, which may be a directory or unoccupied .zip path\",\n  ).addOption(\n    new Option(\n      \"--include-file-storage\",\n      \"Includes stored files (https://dashboard.convex.dev/deployment/files) in a _storage folder within the ZIP file\",\n    ),\n  );\n};\n\nCommand.prototype.addDataOptions = function () {\n  return this.addOption(\n    new Option(\n      \"--limit <n>\",\n      \"List only the `n` the most recently created documents.\",\n    )\n      .default(100)\n      .argParser(parsePositiveInteger),\n  )\n    .addOption(\n      new Option(\n        \"--order <choice>\",\n        \"Order the documents by their `_creationTime`.\",\n      )\n        .choices([\"asc\", \"desc\"])\n        .default(\"desc\"),\n    )\n    .addOption(\n      new Option(\n        \"--component <path>\",\n        'Path to the component (e.g. \"workflow\" or \"workflow/workpool\")',\n      ),\n    )\n    .addOption(\n      new Option(\n        \"--format <format>\",\n        \"Format to print the data in. This flag is only required if the filename is missing an extension.\\n\" +\n          \"- jsonArray (aka json): print the data as a JSON array of objects.\\n\" +\n          \"- jsonLines (aka jsonl): print the data as a JSON object per line.\\n\" +\n          \"- pretty: print the data in a human-readable format.\",\n      ).choices([\"jsonArray\", \"json\", \"jsonLines\", \"jsonl\", \"pretty\"]),\n    )\n    .argument(\"[table]\", \"If specified, list documents in this table.\");\n};\n\nCommand.prototype.addLogsOptions = function () {\n  return this.option(\n    \"--history [n]\",\n    \"Show `n` most recent logs. Defaults to showing all available logs.\",\n    parseInteger,\n  )\n    .option(\n      \"--success\",\n      \"Print a log line for every successful function execution\",\n      false,\n    )\n    .option(\"--jsonl\", \"Output raw log events as JSONL\", false)\n    .addOption(\n      new Option(\n        \"--tail [n]\",\n        \"Deprecated/unnecessary: `convex logs` already tails by default. Accepted as an alias for --history for compatibility with agents that pass it.\",\n      )\n        .argParser(parseInteger)\n        .hideHelp(),\n    );\n};\n\nCommand.prototype.addNetworkTestOptions = function () {\n  return this.addOption(\n    new Option(\n      \"--timeout <timeout>\",\n      \"Timeout in seconds for the network test (default: 30).\",\n    ),\n  )\n    .addOption(\n      new Option(\n        \"--ip-family <ipFamily>\",\n        \"IP family to use (ipv4, ipv6, or auto)\",\n      ),\n    )\n    .addOption(\n      new Option(\n        \"--speed-test\",\n        \"Perform a large echo test to measure network speed.\",\n      ),\n    );\n};\n"],
   "mappings": "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",
   "names": []
 }

package/dist/esm/cli/lib/deployment.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/lib/deployment.ts"],
-  "sourcesContent": ["import * as dotenv from \"dotenv\";\nimport { Context } from \"../../bundler/context.js\";\nimport { changedEnvVarFile, getEnvVarRegex } from \"./envvars.js\";\nimport {\n  CONVEX_DEPLOY_KEY_ENV_VAR_NAME,\n  CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n  ENV_VAR_FILE_PATH,\n} from \"./utils/utils.js\";\nimport { DeploymentType } from \"./api.js\";\n\n// Given a deployment string like \"dev:tall-forest-1234\"\n// returns only the slug \"tall-forest-1234\".\n// If there's no prefix returns the original string.\nexport function stripDeploymentTypePrefix(deployment: string) {\n  return deployment.split(\":\").at(-1)!;\n}\n\n// Handling legacy CONVEX_DEPLOYMENT without type prefix as well\nexport function getDeploymentTypeFromConfiguredDeployment(raw: string) {\n  const typeRaw = raw.split(\":\")[0];\n  const type =\n    typeRaw === \"prod\" ||\n    typeRaw === \"dev\" ||\n    typeRaw === \"preview\" ||\n    typeRaw === \"local\"\n      ? typeRaw\n      : null;\n  return type;\n}\n\nexport function isAnonymousDeployment(deploymentName: string) {\n  return deploymentName.startsWith(\"anonymous-\");\n}\n\nexport function removeAnonymousPrefix(deploymentName: string) {\n  if (isAnonymousDeployment(deploymentName)) {\n    return deploymentName.slice(\"anonymous-\".length);\n  }\n  return deploymentName;\n}\n\nexport async function writeDeploymentEnvVar(\n  ctx: Context,\n  deploymentType: DeploymentType,\n  deployment: {\n    team: string | null;\n    project: string | null;\n    deploymentName: string;\n  },\n  existingValue: string | null,\n): Promise<{ wroteToGitIgnore: boolean; changedDeploymentEnvVar: boolean }> {\n  const existingFile = ctx.fs.exists(ENV_VAR_FILE_PATH)\n    ? ctx.fs.readUtf8File(ENV_VAR_FILE_PATH)\n    : null;\n  const changedFile = changesToEnvVarFile(\n    existingFile,\n    deploymentType,\n    deployment,\n  );\n  const deploymentEnvVarValue =\n    deploymentType + \":\" + deployment.deploymentName;\n  // The `existingValue` that reaches this function is at least sometimes is missing its prefix.\n  // Until this is cleaned up consider either of these values not a change.\n  // Otherwise we spam the init instructions (Welcome to Convex etc.) on every run of `npx convex dev`.\n  const changedDeploymentEnvVar =\n    !!changedFile &&\n    existingValue !== deployment.deploymentName &&\n    existingValue !== deploymentEnvVarValue;\n\n  if (changedFile !== null) {\n    ctx.fs.writeUtf8File(ENV_VAR_FILE_PATH, changedFile);\n    // Only do this if we're not reinitializing an existing setup\n    return {\n      wroteToGitIgnore: await gitIgnoreEnvVarFile(ctx),\n      changedDeploymentEnvVar,\n    };\n  }\n  return {\n    wroteToGitIgnore: false,\n    changedDeploymentEnvVar,\n  };\n}\n\n// Only used in the internal --url flow\nexport async function eraseDeploymentEnvVar(ctx: Context): Promise<boolean> {\n  const existingFile = ctx.fs.exists(ENV_VAR_FILE_PATH)\n    ? ctx.fs.readUtf8File(ENV_VAR_FILE_PATH)\n    : null;\n  if (existingFile === null) {\n    return false;\n  }\n  const config = dotenv.parse(existingFile);\n  const existing = config[CONVEX_DEPLOYMENT_ENV_VAR_NAME];\n  if (existing === undefined) {\n    return false;\n  }\n  const changedFile = existingFile.replace(\n    getEnvVarRegex(CONVEX_DEPLOYMENT_ENV_VAR_NAME),\n    \"\",\n  );\n  ctx.fs.writeUtf8File(ENV_VAR_FILE_PATH, changedFile);\n  return true;\n}\n\nasync function gitIgnoreEnvVarFile(ctx: Context): Promise<boolean> {\n  const gitIgnorePath = \".gitignore\";\n  const gitIgnoreContents = ctx.fs.exists(gitIgnorePath)\n    ? ctx.fs.readUtf8File(gitIgnorePath)\n    : \"\";\n  const changedGitIgnore = changesToGitIgnore(gitIgnoreContents);\n  if (changedGitIgnore !== null) {\n    ctx.fs.writeUtf8File(gitIgnorePath, changedGitIgnore);\n    return true;\n  }\n  return false;\n}\n\n// exported for tests\nexport function changesToEnvVarFile(\n  existingFile: string | null,\n  deploymentType: DeploymentType,\n  {\n    team,\n    project,\n    deploymentName,\n  }: { team: string | null; project: string | null; deploymentName: string },\n): string | null {\n  const deploymentValue = deploymentType + \":\" + deploymentName;\n  const commentOnPreviousLine = \"# Deployment used by `npx convex dev`\";\n  const commentAfterValue =\n    team !== null && project !== null\n      ? `team: ${team}, project: ${project}`\n      : null;\n  return changedEnvVarFile({\n    existingFileContent: existingFile,\n    envVarName: CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n    envVarValue: deploymentValue,\n    commentAfterValue,\n    commentOnPreviousLine,\n  });\n}\n\n// exported for tests\nexport function changesToGitIgnore(existingFile: string | null): string | null {\n  if (existingFile === null) {\n    return `${ENV_VAR_FILE_PATH}\\n`;\n  }\n  const gitIgnoreLines = existingFile.split(\"\\n\");\n  const envVarFileIgnored = gitIgnoreLines.some((line) => {\n    if (line.startsWith(\"#\")) return false;\n    if (line.startsWith(\"!\")) return false;\n\n    // .gitignore ignores trailing whitespace, and also we need to remove\n    // the trailing `\\r` from Windows-style newline since we split on `\\n`.\n    const trimmedLine = line.trimEnd();\n\n    const envIgnorePatterns = [\n      /^\\.env\\.local$/,\n      /^\\.env\\.\\*$/,\n      /^\\.env\\*$/,\n      /^.*\\.local$/,\n      /^\\.env\\*\\.local$/,\n    ];\n\n    return envIgnorePatterns.some((pattern) => pattern.test(trimmedLine));\n  });\n  if (!envVarFileIgnored) {\n    return `${existingFile}\\n${ENV_VAR_FILE_PATH}\\n`;\n  } else {\n    return null;\n  }\n}\n\nexport async function deploymentNameFromAdminKeyOrCrash(\n  ctx: Context,\n  adminKey: string,\n) {\n  const deploymentName = deploymentNameFromAdminKey(adminKey);\n  if (deploymentName === null) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `Please set ${CONVEX_DEPLOY_KEY_ENV_VAR_NAME} to a new key which you can find on your Convex dashboard.`,\n    });\n  }\n  return deploymentName;\n}\n\nfunction deploymentNameFromAdminKey(adminKey: string) {\n  const parts = adminKey.split(\"|\");\n  if (parts.length === 1) {\n    return null;\n  }\n  if (isPreviewDeployKey(adminKey)) {\n    // Preview deploy keys do not contain a deployment name.\n    return null;\n  }\n  return stripDeploymentTypePrefix(parts[0]);\n}\n\n// Needed to differentiate a preview deploy key\n// from a concrete preview deployment's deploy key.\n// preview deploy key: `preview:team:project|key`\n// preview deployment's deploy key: `preview:deploymentName|key`\nexport function isPreviewDeployKey(adminKey: string) {\n  const parts = adminKey.split(\"|\");\n  if (parts.length === 1) {\n    return false;\n  }\n  const [prefix] = parts;\n  const prefixParts = prefix.split(\":\");\n  return prefixParts[0] === \"preview\" && prefixParts.length === 3;\n}\n\nexport function isProjectKey(adminKey: string) {\n  return /^project:.*\\|/.test(adminKey);\n}\n\n// \"dev deploy keys\" and \"prod deploy keys\" are deployment keys.\n// On the client these are also known as admin keys.\nexport function isDeploymentKey(adminKey: string) {\n  return /^(dev|prod):.*\\|/.test(adminKey);\n}\n\n// For current keys returns prod|dev|preview,\n// for legacy keys returns \"prod\".\n// Examples:\n//  \"prod:deploymentName|key\" -> \"prod\"\n//  \"preview:deploymentName|key\" -> \"preview\"\n//  \"dev:deploymentName|key\" -> \"dev\"\n//  \"custom:deploymentName|key\" -> \"custom\"\n//  \"key\" -> \"prod\"\nexport function deploymentTypeFromAdminKey(adminKey: string) {\n  const parts = adminKey.split(\":\");\n  if (parts.length === 1) {\n    return \"prod\";\n  }\n  return parts.at(0)! as DeploymentType;\n}\n\nexport async function getTeamAndProjectFromPreviewAdminKey(\n  ctx: Context,\n  adminKey: string,\n) {\n  const parts = adminKey.split(\"|\")[0].split(\":\");\n  if (parts.length !== 3) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"Malformed preview CONVEX_DEPLOY_KEY, get a new key from Project Settings.\",\n    });\n  }\n  const [_preview, teamSlug, projectSlug] = parts;\n  return { teamSlug, projectSlug };\n}\n\nexport type OnDeploymentActivityFunc = (\n  isOffline: boolean,\n  wasOffline: boolean,\n) => Promise<void>;\nexport type CleanupDeploymentFunc = () => Promise<void>;\nexport type DeploymentDetails = {\n  deploymentName: string;\n  deploymentUrl: string;\n  adminKey: string;\n  reference: string | null;\n  isDefault: boolean;\n  onActivity: OnDeploymentActivityFunc | null;\n};\n"],
+  "sourcesContent": ["import * as dotenv from \"dotenv\";\nimport { Context } from \"../../bundler/context.js\";\nimport { changedEnvVarFile, getEnvVarRegex } from \"./envvars.js\";\nimport {\n  CONVEX_DEPLOY_KEY_ENV_VAR_NAME,\n  CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n  ENV_VAR_FILE_PATH,\n} from \"./utils/utils.js\";\nimport { DeploymentType } from \"./api.js\";\n\n// Given a deployment string like \"dev:tall-forest-1234\"\n// returns only the slug \"tall-forest-1234\".\n// If there's no prefix returns the original string.\nexport function stripDeploymentTypePrefix(deployment: string) {\n  return deployment.split(\":\").at(-1)!;\n}\n\n// Handling legacy CONVEX_DEPLOYMENT without type prefix as well\nexport function getDeploymentTypeFromConfiguredDeployment(raw: string) {\n  const typeRaw = raw.split(\":\")[0];\n  const type =\n    typeRaw === \"prod\" ||\n    typeRaw === \"dev\" ||\n    typeRaw === \"preview\" ||\n    typeRaw === \"local\"\n      ? typeRaw\n      : null;\n  return type;\n}\n\nexport function isAnonymousDeployment(deploymentName: string) {\n  return deploymentName.startsWith(\"anonymous-\");\n}\n\nexport function removeAnonymousPrefix(deploymentName: string) {\n  if (isAnonymousDeployment(deploymentName)) {\n    return deploymentName.slice(\"anonymous-\".length);\n  }\n  return deploymentName;\n}\n\nexport async function writeDeploymentEnvVar(\n  ctx: Context,\n  deploymentType: DeploymentType,\n  deployment: {\n    team: string | null;\n    project: string | null;\n    deploymentName: string;\n  },\n  existingValue: string | null,\n): Promise<{ wroteToGitIgnore: boolean; changedDeploymentEnvVar: boolean }> {\n  const existingFile = ctx.fs.exists(ENV_VAR_FILE_PATH)\n    ? ctx.fs.readUtf8File(ENV_VAR_FILE_PATH)\n    : null;\n  const changedFile = changesToEnvVarFile(\n    existingFile,\n    deploymentType,\n    deployment,\n  );\n  const deploymentEnvVarValue =\n    deploymentType + \":\" + deployment.deploymentName;\n  // The `existingValue` that reaches this function is at least sometimes is missing its prefix.\n  // Until this is cleaned up consider either of these values not a change.\n  // Otherwise we spam the init instructions (Welcome to Convex etc.) on every run of `npx convex dev`.\n  const changedDeploymentEnvVar =\n    !!changedFile &&\n    existingValue !== deployment.deploymentName &&\n    existingValue !== deploymentEnvVarValue;\n\n  if (changedFile !== null) {\n    ctx.fs.writeUtf8File(ENV_VAR_FILE_PATH, changedFile);\n    // Only do this if we're not reinitializing an existing setup\n    return {\n      wroteToGitIgnore: await gitIgnoreEnvVarFile(ctx),\n      changedDeploymentEnvVar,\n    };\n  }\n  return {\n    wroteToGitIgnore: false,\n    changedDeploymentEnvVar,\n  };\n}\n\n// Only used in the internal --url flow\nexport async function eraseDeploymentEnvVar(ctx: Context): Promise<boolean> {\n  const existingFile = ctx.fs.exists(ENV_VAR_FILE_PATH)\n    ? ctx.fs.readUtf8File(ENV_VAR_FILE_PATH)\n    : null;\n  if (existingFile === null) {\n    return false;\n  }\n  const config = dotenv.parse(existingFile);\n  const existing = config[CONVEX_DEPLOYMENT_ENV_VAR_NAME];\n  if (existing === undefined) {\n    return false;\n  }\n  const changedFile = existingFile.replace(\n    getEnvVarRegex(CONVEX_DEPLOYMENT_ENV_VAR_NAME),\n    \"\",\n  );\n  ctx.fs.writeUtf8File(ENV_VAR_FILE_PATH, changedFile);\n  return true;\n}\n\nasync function gitIgnoreEnvVarFile(ctx: Context): Promise<boolean> {\n  const gitIgnorePath = \".gitignore\";\n  const gitIgnoreContents = ctx.fs.exists(gitIgnorePath)\n    ? ctx.fs.readUtf8File(gitIgnorePath)\n    : \"\";\n  const changedGitIgnore = changesToGitIgnore(gitIgnoreContents);\n  if (changedGitIgnore !== null) {\n    ctx.fs.writeUtf8File(gitIgnorePath, changedGitIgnore);\n    return true;\n  }\n  return false;\n}\n\n// exported for tests\nexport function changesToEnvVarFile(\n  existingFile: string | null,\n  deploymentType: DeploymentType,\n  {\n    team,\n    project,\n    deploymentName,\n  }: { team: string | null; project: string | null; deploymentName: string },\n): string | null {\n  const deploymentValue = deploymentType + \":\" + deploymentName;\n  const commentOnPreviousLine = \"# Deployment used by `npx convex dev`\";\n  const commentAfterValue =\n    team !== null && project !== null\n      ? `team: ${team}, project: ${project}`\n      : null;\n  return changedEnvVarFile({\n    existingFileContent: existingFile,\n    envVarName: CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n    envVarValue: deploymentValue,\n    commentAfterValue,\n    commentOnPreviousLine,\n  });\n}\n\n// exported for tests\nexport function changesToGitIgnore(existingFile: string | null): string | null {\n  if (existingFile === null) {\n    return `${ENV_VAR_FILE_PATH}\\n`;\n  }\n  const gitIgnoreLines = existingFile.split(\"\\n\");\n  const envVarFileIgnored = gitIgnoreLines.some((line) => {\n    if (line.startsWith(\"#\")) return false;\n    if (line.startsWith(\"!\")) return false;\n\n    // .gitignore ignores trailing whitespace, and also we need to remove\n    // the trailing `\\r` from Windows-style newline since we split on `\\n`.\n    const trimmedLine = line.trimEnd();\n\n    const envIgnorePatterns = [\n      /^\\.env\\.local$/,\n      /^\\.env\\.\\*$/,\n      /^\\.env\\*$/,\n      /^.*\\.local$/,\n      /^\\.env\\*\\.local$/,\n    ];\n\n    return envIgnorePatterns.some((pattern) => pattern.test(trimmedLine));\n  });\n  if (!envVarFileIgnored) {\n    return `${existingFile}\\n${ENV_VAR_FILE_PATH}\\n`;\n  } else {\n    return null;\n  }\n}\n\nexport async function deploymentNameFromAdminKeyOrCrash(\n  ctx: Context,\n  adminKey: string,\n) {\n  const deploymentName = deploymentNameFromAdminKey(adminKey);\n  if (deploymentName === null) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `Please set ${CONVEX_DEPLOY_KEY_ENV_VAR_NAME} to a new key which you can find on your Convex dashboard.`,\n    });\n  }\n  return deploymentName;\n}\n\nfunction deploymentNameFromAdminKey(adminKey: string) {\n  const parts = adminKey.split(\"|\");\n  if (parts.length === 1) {\n    return null;\n  }\n  if (isPreviewDeployKey(adminKey)) {\n    // Preview deploy keys do not contain a deployment name.\n    return null;\n  }\n  return stripDeploymentTypePrefix(parts[0]);\n}\n\n// Needed to differentiate a preview deploy key\n// from a concrete preview deployment's deploy key.\n// preview deploy key: `preview:team:project|key`\n// preview deployment's deploy key: `preview:deploymentName|key`\nexport function isPreviewDeployKey(adminKey: string) {\n  const parts = adminKey.split(\"|\");\n  if (parts.length === 1) {\n    return false;\n  }\n  const [prefix] = parts;\n  const prefixParts = prefix.split(\":\");\n  return prefixParts[0] === \"preview\" && prefixParts.length === 3;\n}\n\nexport function isProjectKey(adminKey: string) {\n  return /^project:.*\\|/.test(adminKey);\n}\n\n// \"dev deploy keys\" and \"prod deploy keys\" are deployment keys.\n// On the client these are also known as admin keys.\nexport function isDeploymentKey(adminKey: string) {\n  return /^(dev|prod):.*\\|/.test(adminKey);\n}\n\n// For current keys returns prod|dev|preview,\n// for legacy keys returns \"prod\".\n// Examples:\n//  \"prod:deploymentName|key\" -> \"prod\"\n//  \"preview:deploymentName|key\" -> \"preview\"\n//  \"dev:deploymentName|key\" -> \"dev\"\n//  \"custom:deploymentName|key\" -> \"custom\"\n//  \"key\" -> \"prod\"\nexport function deploymentTypeFromAdminKey(adminKey: string) {\n  const parts = adminKey.split(\":\");\n  if (parts.length === 1) {\n    return \"prod\";\n  }\n  return parts.at(0)! as DeploymentType;\n}\n\nexport async function getTeamAndProjectFromPreviewAdminKey(\n  ctx: Context,\n  adminKey: string,\n) {\n  const parts = adminKey.split(\"|\")[0].split(\":\");\n  if (parts.length !== 3) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"Malformed preview CONVEX_DEPLOY_KEY, get a new key from Project Settings.\",\n    });\n  }\n  const [_preview, teamSlug, projectSlug] = parts;\n  return { teamSlug, projectSlug };\n}\n\nexport type CleanupDeploymentFunc = () => Promise<void>;\nexport type DeploymentDetails = {\n  deploymentName: string;\n  deploymentUrl: string;\n  adminKey: string;\n  reference: string | null;\n  isDefault: boolean;\n};\n"],
   "mappings": "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",
   "names": []
 }

package/dist/esm/cli/lib/deploymentSelection.js

@@ -29,6 +29,7 @@ import { getBuildEnvironment } from "./envvars.js";
 import { readGlobalConfig } from "./utils/globalConfig.js";
 import {
   CONVEX_DEPLOYMENT_ENV_VAR_NAME,
+  CONVEX_DEPLOYMENT_TOKEN_ENV_VAR_NAME,
   CONVEX_DEPLOY_KEY_ENV_VAR_NAME,
   CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME,
   CONVEX_SELF_HOSTED_URL_VAR_NAME,
@@ -158,6 +159,43 @@ function getBigBrainAuth(ctx, opts) {
   }
   return null;
 }
+export async function ensureLoggedInWithAccessToken(ctx, action) {
+  const auth = ctx.bigBrainAuth();
+  if (auth !== null && auth.kind === "accessToken") {
+    return;
+  }
+  const prefix = 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 `;
+  return await ctx.crash({
+    exitCode: 1,
+    errorType: "fatal",
+    printedMessage: `${action} requires being logged in with a personal access token. ${prefix}${chalkStderr.bold(
+      "npx convex login"
+    )} and try again.`
+  });
+}
+export async function ensureAuthCanCreateDeployment(ctx) {
+  const auth = ctx.bigBrainAuth();
+  if (auth !== null && (auth.kind === "accessToken" || auth.kind === "projectKey")) {
+    return;
+  }
+  if (auth === null) {
+    return await ctx.crash({
+      exitCode: 1,
+      errorType: "fatal",
+      printedMessage: `Creating a deployment requires logging in. Run ${chalkStderr.bold(
+        "npx convex login"
+      )} and try again.`
+    });
+  }
+  const envVar = process.env[CONVEX_DEPLOY_KEY_ENV_VAR_NAME] ? CONVEX_DEPLOY_KEY_ENV_VAR_NAME : CONVEX_DEPLOYMENT_TOKEN_ENV_VAR_NAME;
+  return await ctx.crash({
+    exitCode: 1,
+    errorType: "fatal",
+    printedMessage: `Creating a deployment isn't supported with a deploy key (${envVar}). Run ${chalkStderr.bold(
+      "npx convex login"
+    )} (or use a project key) and try again.`
+  });
+}
 export async function getDeploymentSelection(ctx, cliArgs) {
   const metadata = await _getDeploymentSelection(ctx, cliArgs);
   if (metadata.kind === "existingDeployment") {

package/dist/esm/cli/lib/deploymentSelection.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/lib/deploymentSelection.ts"],
-  "sourcesContent": ["import { PlatformProjectDetails } from \"@convex-dev/platform/managementApi\";\nimport { BigBrainAuth, Context } from \"../../bundler/context.js\";\nimport { logVerbose } from \"../../bundler/log.js\";\nimport {\n  AccountRequiredDeploymentType,\n  DeploymentSelectionOptions,\n  DeploymentSelectionWithinProject,\n  deploymentSelectionWithinProjectFromOptions,\n  DeploymentType,\n  fetchTeamAndProjectForKey,\n  getTeamAndProjectSlugForDeployment,\n  validateDeploymentSelectionForExistingDeployment,\n} from \"./api.js\";\nimport {\n  deploymentNameFromAdminKeyOrCrash,\n  deploymentTypeFromAdminKey,\n  getDeploymentTypeFromConfiguredDeployment,\n  isAnonymousDeployment,\n  isDeploymentKey,\n  isPreviewDeployKey,\n  isProjectKey,\n  stripDeploymentTypePrefix,\n} from \"./deployment.js\";\nimport {\n  parseDeploymentSelector,\n  ParsedDeploymentSelector,\n} from \"./deploymentSelector.js\";\nimport { loadProjectLocalConfig } from \"./localDeployment/filePaths.js\";\nimport {\n  checkLocalConfigMatchesProject,\n  targetProjectForLocalSelector,\n} from \"./localDeployment/projectMismatch.js\";\nimport { chalkStderr } from \"chalk\";\nimport { getBuildEnvironment } from \"./envvars.js\";\nimport { readGlobalConfig } from \"./utils/globalConfig.js\";\nimport {\n  CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n  CONVEX_DEPLOY_KEY_ENV_VAR_NAME,\n  CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME,\n  CONVEX_SELF_HOSTED_URL_VAR_NAME,\n  ENV_VAR_FILE_PATH,\n  bigBrainAPI,\n  processDeployKeyValue,\n  readDeployKeyFromEnv,\n  typedPlatformClient,\n} from \"./utils/utils.js\";\nimport * as dotenv from \"dotenv\";\n\n// ----------------------------------------------------------------------------\n// Big Brain Auth\n// ----------------------------------------------------------------------------\n\n/**\n * The auth header can be a few different things:\n * * An access token (corresponds to device authorization, usually stored in `~/.convex/config.json`)\n * * A preview deploy key (set via the `CONVEX_DEPLOY_KEY` environment variable)\n * * A project key (set via the `CONVEX_DEPLOY_KEY` environment variable)\n * * A deployment key if a deployment key (set via `CONVEX_DEPLOY_KEY` environment variable)\n *\n * Project keys take precedence over the the access token.\n * Deployment keys take precedence over the the access token.\n * This makes using one of these keys while logged in or logged out work the same.\n *\n * We check for the `CONVEX_DEPLOY_KEY` in the `--env-file` if it's provided.\n * Otherwise, we check in the `.env` and `.env.local` files.\n *\n * If we later prompt for log in, we need to call `ctx.setBigBrainAuthHeader` to\n * update the value.\n *\n * @param ctx\n * @param envFile\n * @returns\n */\nexport async function initializeBigBrainAuth(\n  ctx: Context,\n  initialArgs: {\n    url?: string | undefined;\n    adminKey?: string | undefined;\n    envFile?: string | undefined;\n  },\n): Promise<void> {\n  if (initialArgs.url !== undefined && initialArgs.adminKey !== undefined) {\n    // Do not check any env vars if `url` and `adminKey` are specified via CLI\n    ctx._updateBigBrainAuth(\n      getBigBrainAuth(ctx, {\n        previewDeployKey: null,\n        projectKey: null,\n        deploymentKey: null,\n      }),\n    );\n    return;\n  }\n  if (initialArgs.envFile !== undefined) {\n    const existingFile = ctx.fs.exists(initialArgs.envFile)\n      ? ctx.fs.readUtf8File(initialArgs.envFile)\n      : null;\n    if (existingFile === null) {\n      return ctx.crash({\n        exitCode: 1,\n        errorType: \"invalid filesystem or env vars\",\n        printedMessage: \"env file does not exist\",\n      });\n    }\n    const config = dotenv.parse(existingFile);\n    const rawDeployKey = readDeployKeyFromEnv((name) => config[name]);\n    const deployKey = await processDeployKeyValue(ctx, rawDeployKey);\n    if (deployKey !== undefined) {\n      const bigBrainAuth = getBigBrainAuth(ctx, {\n        previewDeployKey: isPreviewDeployKey(deployKey) ? deployKey : null,\n        projectKey: isProjectKey(deployKey) ? deployKey : null,\n        deploymentKey: isDeploymentKey(deployKey) ? deployKey : null,\n      });\n      ctx._updateBigBrainAuth(bigBrainAuth);\n      return;\n    }\n    // No deploy key was found in the env file, so fall back on using the global config\n    ctx._updateBigBrainAuth(\n      getBigBrainAuth(ctx, {\n        previewDeployKey: null,\n        projectKey: null,\n        deploymentKey: null,\n      }),\n    );\n    return;\n  }\n  dotenv.config({ path: ENV_VAR_FILE_PATH });\n  dotenv.config();\n  const rawDeployKey = readDeployKeyFromEnv((name) => process.env[name]);\n  const deployKey = await processDeployKeyValue(ctx, rawDeployKey);\n  if (deployKey !== undefined) {\n    const bigBrainAuth = getBigBrainAuth(ctx, {\n      previewDeployKey: isPreviewDeployKey(deployKey) ? deployKey : null,\n      projectKey: isProjectKey(deployKey) ? deployKey : null,\n      deploymentKey: isDeploymentKey(deployKey) ? deployKey : null,\n    });\n    ctx._updateBigBrainAuth(bigBrainAuth);\n    return;\n  }\n  ctx._updateBigBrainAuth(\n    getBigBrainAuth(ctx, {\n      previewDeployKey: null,\n      projectKey: null,\n      deploymentKey: null,\n    }),\n  );\n  return;\n}\n\nexport async function updateBigBrainAuthAfterLogin(\n  ctx: Context,\n  accessToken: string,\n) {\n  const existingAuth = ctx.bigBrainAuth();\n  if (existingAuth !== null && existingAuth.kind === \"projectKey\") {\n    logVerbose(\n      `Ignoring update to big brain auth since project key takes precedence`,\n    );\n    return;\n  }\n  ctx._updateBigBrainAuth({\n    accessToken: accessToken,\n    kind: \"accessToken\",\n    header: `Bearer ${accessToken}`,\n  });\n}\n\nexport async function clearBigBrainAuth(ctx: Context) {\n  ctx._updateBigBrainAuth(null);\n}\n\nfunction getBigBrainAuth(\n  ctx: Context,\n  opts: {\n    previewDeployKey: string | null;\n    projectKey: string | null;\n    deploymentKey: string | null;\n  },\n): BigBrainAuth | null {\n  if (process.env.CONVEX_OVERRIDE_ACCESS_TOKEN) {\n    return {\n      accessToken: process.env.CONVEX_OVERRIDE_ACCESS_TOKEN,\n      kind: \"accessToken\",\n      header: `Bearer ${process.env.CONVEX_OVERRIDE_ACCESS_TOKEN}`,\n    };\n  }\n  if (opts.projectKey !== null) {\n    // Project keys take precedence over global config.\n    return {\n      header: `Bearer ${opts.projectKey}`,\n      kind: \"projectKey\",\n      projectKey: opts.projectKey,\n    };\n  }\n  if (opts.deploymentKey !== null) {\n    // Deployment keys take precedence over global config.\n    return {\n      header: `Bearer ${opts.deploymentKey}`,\n      kind: \"deploymentKey\",\n      deploymentKey: opts.deploymentKey,\n    };\n  }\n  const globalConfig = readGlobalConfig(ctx);\n  if (globalConfig) {\n    return {\n      kind: \"accessToken\",\n      header: `Bearer ${globalConfig.accessToken}`,\n      accessToken: globalConfig.accessToken,\n    };\n  }\n  if (opts.previewDeployKey !== null) {\n    return {\n      header: `Bearer ${opts.previewDeployKey}`,\n      kind: \"previewDeployKey\",\n      previewDeployKey: opts.previewDeployKey,\n    };\n  }\n  return null;\n}\n\n// ----------------------------------------------------------------------------\n// Deployment Selection\n// ----------------------------------------------------------------------------\n/**\n * Our CLI has logic to select which deployment to act on.\n *\n * We first check whether we're targeting a deployment within a project, or if we\n * know exactly which deployment to act on (e.g. in the case of self-hosting).\n *\n * We also special case preview deploys since the presence of a preview deploy key\n * triggers different behavior in `npx convex deploy`.\n *\n * Most commands will immediately compute the deployment selection, and then combine\n * that with any relevant CLI flags to figure out which deployment to talk to.\n *\n * Different commands do different things (e.g. `dev` will allow you to create a new project,\n * `deploy` has different behavior for preview deploys)\n *\n * This should be kept in sync with `initializeBigBrainAuth` since environment variables\n * like `CONVEX_DEPLOY_KEY` are used for both deployment selection and auth.\n */\nexport type DeploymentSelection =\n  | {\n      kind: \"existingDeployment\";\n      deploymentToActOn: {\n        url: string;\n        adminKey: string;\n      } & (\n        | {\n            deploymentFields: DeploymentFields;\n            source: \"deployKey\";\n          }\n        | {\n            deploymentFields: null;\n            source: \"selfHosted\" | \"cliArgs\";\n          }\n      );\n    }\n  | {\n      kind: \"deploymentWithinProject\";\n      targetProject: ProjectSelection;\n      selectionWithinProject: DeploymentSelectionWithinProject;\n    }\n  | {\n      kind: \"preview\";\n      previewDeployKey: string;\n      selectionWithinProject: DeploymentSelectionWithinProject;\n    }\n  | {\n      kind: \"chooseProject\";\n      selectionWithinProject: DeploymentSelectionWithinProject;\n    }\n  | {\n      kind: \"anonymous\";\n      deploymentName: string | null;\n      selectionWithinProject: DeploymentSelectionWithinProject;\n    };\n\ntype DeploymentFields = {\n  deploymentName: string;\n  deploymentType: DeploymentType;\n  projectSlug: string;\n  teamSlug: string;\n  reference: string | null;\n  isDefault: boolean;\n};\n\nexport type ProjectSelection =\n  | {\n      kind: \"teamAndProjectSlugs\";\n      teamSlug: string;\n      projectSlug: string;\n    }\n  | {\n      kind: \"deploymentName\";\n      deploymentName: string;\n      deploymentType: AccountRequiredDeploymentType | null;\n    }\n  | {\n      kind: \"projectDeployKey\";\n      projectDeployKey: string;\n    };\n\nexport async function getDeploymentSelection(\n  ctx: Context,\n  cliArgs: DeploymentSelectionOptions,\n): Promise<DeploymentSelection> {\n  const metadata = await _getDeploymentSelection(ctx, cliArgs);\n  if (metadata.kind === \"existingDeployment\") {\n    const selectionWithinProject =\n      deploymentSelectionWithinProjectFromOptions(cliArgs);\n    await validateDeploymentSelectionForExistingDeployment(\n      ctx,\n      selectionWithinProject,\n      metadata.deploymentToActOn.source,\n    );\n  }\n  logDeploymentSelection(ctx, metadata);\n  return metadata;\n}\n\nfunction logDeploymentSelection(_ctx: Context, selection: DeploymentSelection) {\n  switch (selection.kind) {\n    case \"existingDeployment\": {\n      logVerbose(\n        `Existing deployment: ${selection.deploymentToActOn.url} ${selection.deploymentToActOn.source}`,\n      );\n      break;\n    }\n    case \"deploymentWithinProject\": {\n      logVerbose(\n        `Deployment within project: ${prettyProjectSelection(selection.targetProject)}`,\n      );\n      break;\n    }\n    case \"preview\": {\n      logVerbose(`Preview deploy key`);\n      break;\n    }\n    case \"chooseProject\": {\n      logVerbose(`Choose project`);\n      break;\n    }\n    case \"anonymous\": {\n      logVerbose(\n        `Anonymous, has selected deployment?: ${selection.deploymentName !== null}`,\n      );\n      break;\n    }\n    default: {\n      selection satisfies never;\n      logVerbose(`Unknown deployment selection`);\n    }\n  }\n  return null;\n}\n\nfunction prettyProjectSelection(selection: ProjectSelection) {\n  switch (selection.kind) {\n    case \"teamAndProjectSlugs\": {\n      return `Team and project slugs: ${selection.teamSlug} ${selection.projectSlug}`;\n    }\n    case \"deploymentName\": {\n      return `Deployment name: ${selection.deploymentName}`;\n    }\n    case \"projectDeployKey\": {\n      return `Project deploy key`;\n    }\n    default: {\n      selection satisfies never;\n      return `Unknown`;\n    }\n  }\n}\n\nasync function _getDeploymentSelection(\n  ctx: Context,\n  cliArgs: DeploymentSelectionOptions,\n): Promise<DeploymentSelection> {\n  const selectionWithinProject =\n    deploymentSelectionWithinProjectFromOptions(cliArgs);\n  /*\n   - url + adminKey specified via CLI\n   - Do not check any env vars (including ones relevant for auth)\n  */\n  if (cliArgs.url !== undefined && cliArgs.adminKey !== undefined) {\n    return {\n      kind: \"existingDeployment\",\n      deploymentToActOn: {\n        url: cliArgs.url,\n        adminKey: cliArgs.adminKey,\n        deploymentFields: null,\n        source: \"cliArgs\",\n      },\n    };\n  }\n\n  // If --deployment is a fully qualified selector (team:project:ref or\n  // deployment name), we don't need a current project context \u2192 handle it\n  // before env var resolution.\n  if (cliArgs.deployment !== undefined) {\n    const parsed = parseDeploymentSelector(cliArgs.deployment);\n    if (parsed.kind === \"inTeamProject\" && parsed.selector.kind !== \"local\") {\n      return {\n        kind: \"deploymentWithinProject\",\n        targetProject: {\n          kind: \"teamAndProjectSlugs\",\n          teamSlug: parsed.teamSlug,\n          projectSlug: parsed.projectSlug,\n        },\n        selectionWithinProject: {\n          kind: \"deploymentSelector\",\n          selector: cliArgs.deployment,\n        },\n      };\n    }\n    if (parsed.kind === \"deploymentName\") {\n      return {\n        kind: \"deploymentWithinProject\",\n        targetProject: {\n          kind: \"deploymentName\",\n          deploymentName: parsed.deploymentName,\n          deploymentType: null,\n        },\n        selectionWithinProject: {\n          kind: \"deploymentSelector\",\n          selector: cliArgs.deployment,\n        },\n      };\n    }\n    if (parsed.kind === \"inTeamProject\" && parsed.selector.kind === \"local\") {\n      // team:project:local \u2014 we have the cloud project context up front and\n      // don't need to consult env vars at all.\n      return await resolveLocalDeploymentSelection(\n        ctx,\n        parsed,\n        selectionWithinProject,\n        null,\n      );\n    }\n  }\n\n  const baseSelection = await resolveBaseDeploymentSelection(\n    ctx,\n    cliArgs,\n    selectionWithinProject,\n  );\n\n  // If --deployment is a project-scoped local selector (`local` or\n  // `project:local`), override the env-var-derived selection with the local\n  // deployment after performing a cloud-project-mismatch check.\n  if (cliArgs.deployment !== undefined) {\n    const parsed = parseDeploymentSelector(cliArgs.deployment);\n    if (\n      (parsed.kind === \"inCurrentProject\" || parsed.kind === \"inProject\") &&\n      parsed.selector.kind === \"local\"\n    ) {\n      return await resolveLocalDeploymentSelection(\n        ctx,\n        parsed,\n        selectionWithinProject,\n        baseSelection,\n      );\n    }\n  }\n\n  return baseSelection;\n}\n\nasync function resolveBaseDeploymentSelection(\n  ctx: Context,\n  cliArgs: DeploymentSelectionOptions,\n  selectionWithinProject: DeploymentSelectionWithinProject,\n): Promise<DeploymentSelection> {\n  if (cliArgs.envFile !== undefined) {\n    // If an `--env-file` is specified, it must contain enough information for both auth and deployment selection.\n    logVerbose(`Checking env file: ${cliArgs.envFile}`);\n    const existingFile = ctx.fs.exists(cliArgs.envFile)\n      ? ctx.fs.readUtf8File(cliArgs.envFile)\n      : null;\n    if (existingFile === null) {\n      return ctx.crash({\n        exitCode: 1,\n        errorType: \"invalid filesystem or env vars\",\n        printedMessage: \"env file does not exist\",\n      });\n    }\n    const config = dotenv.parse(existingFile);\n    const result = await getDeploymentSelectionFromEnv(\n      ctx,\n      selectionWithinProject,\n      (name) =>\n        config[name] === undefined || config[name] === \"\" ? null : config[name],\n    );\n    if (result.kind === \"unknown\") {\n      return ctx.crash({\n        exitCode: 1,\n        errorType: \"invalid filesystem or env vars\",\n        printedMessage:\n          `env file \\`${cliArgs.envFile}\\` did not contain environment variables for a Convex deployment. ` +\n          `Expected \\`${CONVEX_DEPLOY_KEY_ENV_VAR_NAME}\\`, \\`${CONVEX_DEPLOYMENT_ENV_VAR_NAME}\\`, or both \\`${CONVEX_SELF_HOSTED_URL_VAR_NAME}\\` and \\`${CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME}\\` to be set.`,\n      });\n    }\n    return result.metadata;\n  }\n  // start with .env.local (but doesn't override existing)\n  dotenv.config({ path: ENV_VAR_FILE_PATH });\n  // for variables not already set, use .env values\n  dotenv.config();\n  const result = await getDeploymentSelectionFromEnv(\n    ctx,\n    selectionWithinProject,\n    (name) => {\n      const value = process.env[name];\n      if (value === undefined || value === \"\") {\n        return null;\n      }\n      return value;\n    },\n  );\n  if (result.kind !== \"unknown\") {\n    return result.metadata;\n  }\n  // none of these?\n\n  const isLoggedIn = ctx.bigBrainAuth() !== null;\n  if (\n    (!isLoggedIn ||\n      process.env.CONVEX_AGENT_MODE === \"anonymous\" ||\n      !process.stdin.isTTY) &&\n    !cliArgs.implicitProd &&\n    shouldAllowAnonymousDevelopment()\n  ) {\n    return {\n      kind: \"anonymous\",\n      deploymentName: null,\n      selectionWithinProject,\n    };\n  }\n\n  // Choose a project interactively later\n  return {\n    kind: \"chooseProject\",\n    selectionWithinProject,\n  };\n}\n\n/**\n * Handles the `[team:project:]local` selector. Loads the on-disk local config\n * and (if the config has a `cloudProjectId`) verifies it matches the cloud\n * project the user is asking about. Crashes on mismatch.\n */\nasync function resolveLocalDeploymentSelection(\n  ctx: Context,\n  parsed: ParsedDeploymentSelector,\n  selectionWithinProject: DeploymentSelectionWithinProject,\n  currentSelection: DeploymentSelection | null,\n): Promise<DeploymentSelection> {\n  const localConfig = loadProjectLocalConfig(ctx);\n  if (localConfig === null) {\n    return ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `No local deployment found. Run ${chalkStderr.bold(\"npx convex deployment create local\")} to create one.`,\n    });\n  }\n  // Only resolve the target cloud project if the on-disk config has a\n  // `cloudProjectId` to compare against \u2014 this avoids unnecessary platform\n  // calls for older configs and anonymous mode.\n  if (localConfig.config.cloudProjectId !== undefined) {\n    const target = await targetProjectForLocalSelector(\n      ctx,\n      parsed,\n      currentSelection ?? { kind: \"chooseProject\", selectionWithinProject },\n    );\n    if (target !== null) {\n      const match = checkLocalConfigMatchesProject(\n        ctx,\n        localConfig.config,\n        target,\n      );\n      if (match === \"mismatch\") {\n        const newSelector = `${target.teamSlug}:${target.slug}:local`;\n        return ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            `The local deployment in this directory is in a different project than \\`${target.teamSlug}:${target.slug}\\`. ` +\n            `\\n${chalkStderr.dim(`${chalkStderr.bold(\"Hint\")}: If you want to move the local deployment to this project, run ${chalkStderr.bold(`npx convex deployment select ${newSelector}`)}`)}`,\n        });\n      }\n    }\n  }\n  return {\n    kind: \"deploymentWithinProject\",\n    targetProject: {\n      kind: \"deploymentName\",\n      deploymentName: localConfig.deploymentName,\n      deploymentType: \"local\",\n    },\n    selectionWithinProject,\n  };\n}\n\nasync function getDeploymentSelectionFromEnv(\n  ctx: Context,\n  selectionWithinProject: DeploymentSelectionWithinProject,\n  getEnv: (name: string) => string | null,\n): Promise<\n  { kind: \"success\"; metadata: DeploymentSelection } | { kind: \"unknown\" }\n> {\n  const rawDeployKey = readDeployKeyFromEnv(getEnv);\n  const deployKey = await processDeployKeyValue(ctx, rawDeployKey);\n  if (deployKey !== undefined) {\n    const deployKeyType = isPreviewDeployKey(deployKey)\n      ? \"preview\"\n      : isProjectKey(deployKey)\n        ? \"project\"\n        : \"deployment\";\n    switch (deployKeyType) {\n      case \"preview\": {\n        // `CONVEX_DEPLOY_KEY` is set to a preview deploy key so this takes precedence over anything else.\n        // At the moment, we don't verify that there aren't other env vars that would also be used for deployment selection (e.g. `CONVEX_DEPLOYMENT`)\n        return {\n          kind: \"success\",\n          metadata: {\n            kind: \"preview\",\n            previewDeployKey: deployKey,\n            selectionWithinProject,\n          },\n        };\n      }\n      case \"project\": {\n        // `CONVEX_DEPLOY_KEY` is set to a project deploy key.\n        // Commands can select any deployment within the project. At the moment we don't check for other env vars (e.g. `CONVEX_DEPLOYMENT`)\n        return {\n          kind: \"success\",\n          metadata: {\n            kind: \"deploymentWithinProject\",\n            targetProject: {\n              kind: \"projectDeployKey\",\n              projectDeployKey: deployKey,\n            },\n            selectionWithinProject,\n          },\n        };\n      }\n      case \"deployment\": {\n        // `CONVEX_DEPLOY_KEY` is set to a deployment's deploy key.\n        // Deploy to this deployment -- selectors like `--prod` / `--preview-name` will be ignored.\n        // At the moment, we don't verify that there aren't other env vars that would also be used for deployment selection (e.g. `CONVEX_DEPLOYMENT`)\n        const deploymentName = await deploymentNameFromAdminKeyOrCrash(\n          ctx,\n          deployKey,\n        );\n        const deploymentType = deploymentTypeFromAdminKey(deployKey);\n        // We cannot derive the deployment URL from the deploy key, because it\n        // might be a custom domain. Ask big brain for the URL.\n        const url = await bigBrainAPI({\n          ctx,\n          method: \"POST\",\n          path: \"deployment/url_for_key\",\n          data: {\n            deployKey: deployKey,\n          },\n        });\n        const slugs = await fetchTeamAndProjectForKey(ctx, deployKey);\n        return {\n          kind: \"success\",\n          metadata: {\n            kind: \"existingDeployment\",\n            deploymentToActOn: {\n              url: url,\n              adminKey: deployKey,\n              deploymentFields: {\n                deploymentName: deploymentName,\n                deploymentType: deploymentType,\n                teamSlug: slugs.team,\n                projectSlug: slugs.project,\n                reference: slugs.reference,\n                isDefault: slugs.isDefault,\n              },\n              source: \"deployKey\",\n            },\n          },\n        };\n      }\n      default: {\n        deployKeyType satisfies never;\n        return ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage: `Unexpected deploy key type: ${deployKeyType as any}`,\n        });\n      }\n    }\n  }\n\n  const convexDeployment = getEnv(CONVEX_DEPLOYMENT_ENV_VAR_NAME);\n  const selfHostedUrl = getEnv(CONVEX_SELF_HOSTED_URL_VAR_NAME);\n  const selfHostedAdminKey = getEnv(CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME);\n\n  if (selfHostedUrl !== null && selfHostedAdminKey !== null) {\n    if (convexDeployment !== null) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"invalid filesystem or env vars\",\n        printedMessage: `${CONVEX_DEPLOYMENT_ENV_VAR_NAME} must not be set when ${CONVEX_SELF_HOSTED_URL_VAR_NAME} and ${CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME} are set`,\n      });\n    }\n    return {\n      kind: \"success\",\n      metadata: {\n        kind: \"existingDeployment\",\n        deploymentToActOn: {\n          url: selfHostedUrl,\n          adminKey: selfHostedAdminKey,\n          deploymentFields: null,\n          source: \"selfHosted\",\n        },\n      },\n    };\n  }\n\n  // --deployment-name\u2019s deployment may be in a different project from CONVEX_DEPLOYMENT.\n  if (selectionWithinProject.kind === \"deploymentName\") {\n    return {\n      kind: \"success\",\n      metadata: {\n        kind: \"deploymentWithinProject\",\n        targetProject: {\n          kind: \"deploymentName\",\n          deploymentName: selectionWithinProject.deploymentName,\n          deploymentType: null,\n        },\n        selectionWithinProject,\n      },\n    };\n  }\n\n  if (convexDeployment !== null) {\n    if (selfHostedUrl !== null || selfHostedAdminKey !== null) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"invalid filesystem or env vars\",\n        printedMessage: `${CONVEX_SELF_HOSTED_URL_VAR_NAME} and ${CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME} must not be set when ${CONVEX_DEPLOYMENT_ENV_VAR_NAME} is set`,\n      });\n    }\n    const targetDeploymentType =\n      getDeploymentTypeFromConfiguredDeployment(convexDeployment);\n\n    // Commands can select a deployment within the project that this deployment belongs to.\n    const targetDeploymentName = stripDeploymentTypePrefix(convexDeployment);\n    const isAnonymous = isAnonymousDeployment(targetDeploymentName);\n    if (isAnonymous) {\n      if (!shouldAllowAnonymousDevelopment()) {\n        return {\n          kind: \"unknown\",\n        };\n      }\n      return {\n        kind: \"success\",\n        metadata: {\n          kind: \"anonymous\",\n          deploymentName: targetDeploymentName,\n          selectionWithinProject,\n        },\n      };\n    }\n\n    // Overwrite the selection within project\n    const newSelectionWithinProject =\n      selectionWithinProject.kind === \"unspecified\" &&\n      // Fetching local deployment credentials uses the \"unspecified\" code path\n      targetDeploymentType !== \"local\"\n        ? {\n            kind: \"deploymentName\" as const,\n            deploymentName: targetDeploymentName,\n          }\n        : selectionWithinProject;\n    return {\n      kind: \"success\",\n      metadata: {\n        kind: \"deploymentWithinProject\",\n        targetProject: {\n          kind: \"deploymentName\",\n          deploymentName: targetDeploymentName,\n          deploymentType: targetDeploymentType,\n        },\n        selectionWithinProject: newSelectionWithinProject,\n      },\n    };\n  }\n\n  // Throw a nice error if we're in something like a CI environment where we need a valid deployment configuration\n  await checkIfBuildEnvironmentRequiresDeploymentConfig(ctx);\n\n  return { kind: \"unknown\" };\n}\n\nasync function checkIfBuildEnvironmentRequiresDeploymentConfig(ctx: Context) {\n  const buildEnvironment = getBuildEnvironment();\n  if (buildEnvironment) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        `${buildEnvironment} build environment detected but no Convex deployment configuration found.\\n` +\n        `Set one of:\\n` +\n        `  \u2022 ${CONVEX_DEPLOY_KEY_ENV_VAR_NAME} for Convex Cloud deployments\\n` +\n        `  \u2022 ${CONVEX_SELF_HOSTED_URL_VAR_NAME} and ${CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME} for self-hosted deployments\\n` +\n        `See https://docs.convex.dev/production/hosting or https://docs.convex.dev/self-hosting`,\n    });\n  }\n}\n\n/**\n * Used for things like `npx convex docs` where we want to best effort extract a deployment name\n * but don't do the full deployment selection logic.\n */\nexport const deploymentNameFromSelection = (\n  selection: DeploymentSelection,\n): string | null => {\n  return deploymentNameAndTypeFromSelection(selection)?.name ?? null;\n};\n\nexport const deploymentNameAndTypeFromSelection = (\n  selection: DeploymentSelection,\n): { name: string | null; type: string | null } | null => {\n  switch (selection.kind) {\n    case \"existingDeployment\": {\n      return {\n        name:\n          selection.deploymentToActOn.deploymentFields?.deploymentName ?? null,\n        type:\n          selection.deploymentToActOn.deploymentFields?.deploymentType ?? null,\n      };\n    }\n    case \"deploymentWithinProject\": {\n      return selection.targetProject.kind === \"deploymentName\"\n        ? {\n            name: selection.targetProject.deploymentName,\n            type: selection.targetProject.deploymentType,\n          }\n        : null;\n    }\n    case \"preview\": {\n      return null;\n    }\n    case \"chooseProject\": {\n      return null;\n    }\n    case \"anonymous\": {\n      return null;\n    }\n    default: {\n      selection satisfies never;\n    }\n  }\n  return null;\n};\n\nexport const shouldAllowAnonymousDevelopment = (): boolean => {\n  // Kill switch / temporary opt out\n  if (process.env.CONVEX_ALLOW_ANONYMOUS === \"false\") {\n    return false;\n  }\n  return true;\n};\n\n/**\n * Fetch the project details corresponding to the given ProjectSelection.\n */\nexport async function getProjectDetails(\n  ctx: Context,\n  projectSelection: ProjectSelection,\n): Promise<PlatformProjectDetails> {\n  switch (projectSelection.kind) {\n    case \"deploymentName\": {\n      if (projectSelection.deploymentType === \"local\") {\n        const result = await getTeamAndProjectSlugForDeployment(ctx, {\n          deploymentName: projectSelection.deploymentName,\n        });\n        if (result === null) {\n          return ctx.crash({\n            exitCode: 1,\n            errorType: \"fatal\",\n            printedMessage:\n              \"You don't have access to the selected project. Run `npx convex dev` to select a different project.\",\n          });\n        }\n        return await getProjectDetails(ctx, {\n          kind: \"teamAndProjectSlugs\",\n          teamSlug: result.teamSlug,\n          projectSlug: result.projectSlug,\n        });\n      }\n\n      const deployment = (\n        await typedPlatformClient(ctx).GET(\"/deployments/{deployment_name}\", {\n          params: {\n            path: { deployment_name: projectSelection.deploymentName },\n          },\n        })\n      ).data!;\n      return (\n        await typedPlatformClient(ctx).GET(\"/projects/{project_id}\", {\n          params: { path: { project_id: deployment.projectId } },\n        })\n      ).data!;\n    }\n    case \"teamAndProjectSlugs\": {\n      return (\n        await typedPlatformClient(ctx).GET(\n          \"/teams/{team_id_or_slug}/projects/{project_slug}\",\n          {\n            params: {\n              path: {\n                team_id_or_slug: projectSelection.teamSlug,\n                project_slug: projectSelection.projectSlug,\n              },\n            },\n          },\n        )\n      ).data!;\n    }\n    case \"projectDeployKey\": {\n      const result = await fetchTeamAndProjectForKey(\n        ctx,\n        projectSelection.projectDeployKey,\n      );\n      return (\n        await typedPlatformClient(ctx).GET(\"/projects/{project_id}\", {\n          params: { path: { project_id: result.projectId } },\n        })\n      ).data!;\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { PlatformProjectDetails } from \"@convex-dev/platform/managementApi\";\nimport { BigBrainAuth, Context } from \"../../bundler/context.js\";\nimport { logVerbose } from \"../../bundler/log.js\";\nimport {\n  AccountRequiredDeploymentType,\n  DeploymentSelectionOptions,\n  DeploymentSelectionWithinProject,\n  deploymentSelectionWithinProjectFromOptions,\n  DeploymentType,\n  fetchTeamAndProjectForKey,\n  getTeamAndProjectSlugForDeployment,\n  validateDeploymentSelectionForExistingDeployment,\n} from \"./api.js\";\nimport {\n  deploymentNameFromAdminKeyOrCrash,\n  deploymentTypeFromAdminKey,\n  getDeploymentTypeFromConfiguredDeployment,\n  isAnonymousDeployment,\n  isDeploymentKey,\n  isPreviewDeployKey,\n  isProjectKey,\n  stripDeploymentTypePrefix,\n} from \"./deployment.js\";\nimport {\n  parseDeploymentSelector,\n  ParsedDeploymentSelector,\n} from \"./deploymentSelector.js\";\nimport { loadProjectLocalConfig } from \"./localDeployment/filePaths.js\";\nimport {\n  checkLocalConfigMatchesProject,\n  targetProjectForLocalSelector,\n} from \"./localDeployment/projectMismatch.js\";\nimport { chalkStderr } from \"chalk\";\nimport { getBuildEnvironment } from \"./envvars.js\";\nimport { readGlobalConfig } from \"./utils/globalConfig.js\";\nimport {\n  CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n  CONVEX_DEPLOYMENT_TOKEN_ENV_VAR_NAME,\n  CONVEX_DEPLOY_KEY_ENV_VAR_NAME,\n  CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME,\n  CONVEX_SELF_HOSTED_URL_VAR_NAME,\n  ENV_VAR_FILE_PATH,\n  bigBrainAPI,\n  processDeployKeyValue,\n  readDeployKeyFromEnv,\n  typedPlatformClient,\n} from \"./utils/utils.js\";\nimport * as dotenv from \"dotenv\";\n\n// ----------------------------------------------------------------------------\n// Big Brain Auth\n// ----------------------------------------------------------------------------\n\n/**\n * The auth header can be a few different things:\n * * An access token (corresponds to device authorization, usually stored in `~/.convex/config.json`)\n * * A preview deploy key (set via the `CONVEX_DEPLOY_KEY` environment variable)\n * * A project key (set via the `CONVEX_DEPLOY_KEY` environment variable)\n * * A deployment key if a deployment key (set via `CONVEX_DEPLOY_KEY` environment variable)\n *\n * Project keys take precedence over the the access token.\n * Deployment keys take precedence over the the access token.\n * This makes using one of these keys while logged in or logged out work the same.\n *\n * We check for the `CONVEX_DEPLOY_KEY` in the `--env-file` if it's provided.\n * Otherwise, we check in the `.env` and `.env.local` files.\n *\n * If we later prompt for log in, we need to call `ctx.setBigBrainAuthHeader` to\n * update the value.\n *\n * @param ctx\n * @param envFile\n * @returns\n */\nexport async function initializeBigBrainAuth(\n  ctx: Context,\n  initialArgs: {\n    url?: string | undefined;\n    adminKey?: string | undefined;\n    envFile?: string | undefined;\n  },\n): Promise<void> {\n  if (initialArgs.url !== undefined && initialArgs.adminKey !== undefined) {\n    // Do not check any env vars if `url` and `adminKey` are specified via CLI\n    ctx._updateBigBrainAuth(\n      getBigBrainAuth(ctx, {\n        previewDeployKey: null,\n        projectKey: null,\n        deploymentKey: null,\n      }),\n    );\n    return;\n  }\n  if (initialArgs.envFile !== undefined) {\n    const existingFile = ctx.fs.exists(initialArgs.envFile)\n      ? ctx.fs.readUtf8File(initialArgs.envFile)\n      : null;\n    if (existingFile === null) {\n      return ctx.crash({\n        exitCode: 1,\n        errorType: \"invalid filesystem or env vars\",\n        printedMessage: \"env file does not exist\",\n      });\n    }\n    const config = dotenv.parse(existingFile);\n    const rawDeployKey = readDeployKeyFromEnv((name) => config[name]);\n    const deployKey = await processDeployKeyValue(ctx, rawDeployKey);\n    if (deployKey !== undefined) {\n      const bigBrainAuth = getBigBrainAuth(ctx, {\n        previewDeployKey: isPreviewDeployKey(deployKey) ? deployKey : null,\n        projectKey: isProjectKey(deployKey) ? deployKey : null,\n        deploymentKey: isDeploymentKey(deployKey) ? deployKey : null,\n      });\n      ctx._updateBigBrainAuth(bigBrainAuth);\n      return;\n    }\n    // No deploy key was found in the env file, so fall back on using the global config\n    ctx._updateBigBrainAuth(\n      getBigBrainAuth(ctx, {\n        previewDeployKey: null,\n        projectKey: null,\n        deploymentKey: null,\n      }),\n    );\n    return;\n  }\n  dotenv.config({ path: ENV_VAR_FILE_PATH });\n  dotenv.config();\n  const rawDeployKey = readDeployKeyFromEnv((name) => process.env[name]);\n  const deployKey = await processDeployKeyValue(ctx, rawDeployKey);\n  if (deployKey !== undefined) {\n    const bigBrainAuth = getBigBrainAuth(ctx, {\n      previewDeployKey: isPreviewDeployKey(deployKey) ? deployKey : null,\n      projectKey: isProjectKey(deployKey) ? deployKey : null,\n      deploymentKey: isDeploymentKey(deployKey) ? deployKey : null,\n    });\n    ctx._updateBigBrainAuth(bigBrainAuth);\n    return;\n  }\n  ctx._updateBigBrainAuth(\n    getBigBrainAuth(ctx, {\n      previewDeployKey: null,\n      projectKey: null,\n      deploymentKey: null,\n    }),\n  );\n  return;\n}\n\nexport async function updateBigBrainAuthAfterLogin(\n  ctx: Context,\n  accessToken: string,\n) {\n  const existingAuth = ctx.bigBrainAuth();\n  if (existingAuth !== null && existingAuth.kind === \"projectKey\") {\n    logVerbose(\n      `Ignoring update to big brain auth since project key takes precedence`,\n    );\n    return;\n  }\n  ctx._updateBigBrainAuth({\n    accessToken: accessToken,\n    kind: \"accessToken\",\n    header: `Bearer ${accessToken}`,\n  });\n}\n\nexport async function clearBigBrainAuth(ctx: Context) {\n  ctx._updateBigBrainAuth(null);\n}\n\nfunction getBigBrainAuth(\n  ctx: Context,\n  opts: {\n    previewDeployKey: string | null;\n    projectKey: string | null;\n    deploymentKey: string | null;\n  },\n): BigBrainAuth | null {\n  if (process.env.CONVEX_OVERRIDE_ACCESS_TOKEN) {\n    return {\n      accessToken: process.env.CONVEX_OVERRIDE_ACCESS_TOKEN,\n      kind: \"accessToken\",\n      header: `Bearer ${process.env.CONVEX_OVERRIDE_ACCESS_TOKEN}`,\n    };\n  }\n  if (opts.projectKey !== null) {\n    // Project keys take precedence over global config.\n    return {\n      header: `Bearer ${opts.projectKey}`,\n      kind: \"projectKey\",\n      projectKey: opts.projectKey,\n    };\n  }\n  if (opts.deploymentKey !== null) {\n    // Deployment keys take precedence over global config.\n    return {\n      header: `Bearer ${opts.deploymentKey}`,\n      kind: \"deploymentKey\",\n      deploymentKey: opts.deploymentKey,\n    };\n  }\n  const globalConfig = readGlobalConfig(ctx);\n  if (globalConfig) {\n    return {\n      kind: \"accessToken\",\n      header: `Bearer ${globalConfig.accessToken}`,\n      accessToken: globalConfig.accessToken,\n    };\n  }\n  if (opts.previewDeployKey !== null) {\n    return {\n      header: `Bearer ${opts.previewDeployKey}`,\n      kind: \"previewDeployKey\",\n      previewDeployKey: opts.previewDeployKey,\n    };\n  }\n  return null;\n}\n\n// These guards mirror the management API's auth rules client-side so we can\n// fail with a clear message instead of an opaque 401; the server stays\n// authoritative. Creating a deployment also allows project keys, while the\n// deploy-key commands stay personal-access-token only.\n\n/** Crashes unless logged in with a personal access token (not a deploy key). */\nexport async function ensureLoggedInWithAccessToken(\n  ctx: Context,\n  action: string,\n): Promise<void> {\n  const auth = ctx.bigBrainAuth();\n  if (auth !== null && auth.kind === \"accessToken\") {\n    return;\n  }\n  // Name whichever deploy-key env var is in effect (CONVEX_DEPLOY_KEY wins).\n  const prefix =\n    auth === null\n      ? \"Run \"\n      : process.env[CONVEX_DEPLOYMENT_TOKEN_ENV_VAR_NAME] &&\n          !process.env[CONVEX_DEPLOY_KEY_ENV_VAR_NAME]\n        ? `Unset ${CONVEX_DEPLOYMENT_TOKEN_ENV_VAR_NAME} and run `\n        : `Unset ${CONVEX_DEPLOY_KEY_ENV_VAR_NAME} and run `;\n  return await ctx.crash({\n    exitCode: 1,\n    errorType: \"fatal\",\n    printedMessage: `${action} requires being logged in with a personal access token. ${prefix}${chalkStderr.bold(\n      \"npx convex login\",\n    )} and try again.`,\n  });\n}\n\n/**\n * Crashes unless the auth can create a deployment: personal access tokens and\n * project keys are accepted, deploy keys are not.\n */\nexport async function ensureAuthCanCreateDeployment(\n  ctx: Context,\n): Promise<void> {\n  const auth = ctx.bigBrainAuth();\n  if (\n    auth !== null &&\n    (auth.kind === \"accessToken\" || auth.kind === \"projectKey\")\n  ) {\n    return;\n  }\n  if (auth === null) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `Creating a deployment requires logging in. Run ${chalkStderr.bold(\n        \"npx convex login\",\n      )} and try again.`,\n    });\n  }\n  const envVar = process.env[CONVEX_DEPLOY_KEY_ENV_VAR_NAME]\n    ? CONVEX_DEPLOY_KEY_ENV_VAR_NAME\n    : CONVEX_DEPLOYMENT_TOKEN_ENV_VAR_NAME;\n  return await ctx.crash({\n    exitCode: 1,\n    errorType: \"fatal\",\n    printedMessage: `Creating a deployment isn't supported with a deploy key (${envVar}). Run ${chalkStderr.bold(\n      \"npx convex login\",\n    )} (or use a project key) and try again.`,\n  });\n}\n\n// ----------------------------------------------------------------------------\n// Deployment Selection\n// ----------------------------------------------------------------------------\n/**\n * Our CLI has logic to select which deployment to act on.\n *\n * We first check whether we're targeting a deployment within a project, or if we\n * know exactly which deployment to act on (e.g. in the case of self-hosting).\n *\n * We also special case preview deploys since the presence of a preview deploy key\n * triggers different behavior in `npx convex deploy`.\n *\n * Most commands will immediately compute the deployment selection, and then combine\n * that with any relevant CLI flags to figure out which deployment to talk to.\n *\n * Different commands do different things (e.g. `dev` will allow you to create a new project,\n * `deploy` has different behavior for preview deploys)\n *\n * This should be kept in sync with `initializeBigBrainAuth` since environment variables\n * like `CONVEX_DEPLOY_KEY` are used for both deployment selection and auth.\n */\nexport type DeploymentSelection =\n  | {\n      kind: \"existingDeployment\";\n      deploymentToActOn: {\n        url: string;\n        adminKey: string;\n      } & (\n        | {\n            deploymentFields: DeploymentFields;\n            source: \"deployKey\";\n          }\n        | {\n            deploymentFields: null;\n            source: \"selfHosted\" | \"cliArgs\";\n          }\n      );\n    }\n  | {\n      kind: \"deploymentWithinProject\";\n      targetProject: ProjectSelection;\n      selectionWithinProject: DeploymentSelectionWithinProject;\n    }\n  | {\n      kind: \"preview\";\n      previewDeployKey: string;\n      selectionWithinProject: DeploymentSelectionWithinProject;\n    }\n  | {\n      kind: \"chooseProject\";\n      selectionWithinProject: DeploymentSelectionWithinProject;\n    }\n  | {\n      kind: \"anonymous\";\n      deploymentName: string | null;\n      selectionWithinProject: DeploymentSelectionWithinProject;\n    };\n\ntype DeploymentFields = {\n  deploymentName: string;\n  deploymentType: DeploymentType;\n  projectSlug: string;\n  teamSlug: string;\n  reference: string | null;\n  isDefault: boolean;\n};\n\nexport type ProjectSelection =\n  | {\n      kind: \"teamAndProjectSlugs\";\n      teamSlug: string;\n      projectSlug: string;\n    }\n  | {\n      kind: \"deploymentName\";\n      deploymentName: string;\n      deploymentType: AccountRequiredDeploymentType | null;\n    }\n  | {\n      kind: \"projectDeployKey\";\n      projectDeployKey: string;\n    };\n\nexport async function getDeploymentSelection(\n  ctx: Context,\n  cliArgs: DeploymentSelectionOptions,\n): Promise<DeploymentSelection> {\n  const metadata = await _getDeploymentSelection(ctx, cliArgs);\n  if (metadata.kind === \"existingDeployment\") {\n    const selectionWithinProject =\n      deploymentSelectionWithinProjectFromOptions(cliArgs);\n    await validateDeploymentSelectionForExistingDeployment(\n      ctx,\n      selectionWithinProject,\n      metadata.deploymentToActOn.source,\n    );\n  }\n  logDeploymentSelection(ctx, metadata);\n  return metadata;\n}\n\nfunction logDeploymentSelection(_ctx: Context, selection: DeploymentSelection) {\n  switch (selection.kind) {\n    case \"existingDeployment\": {\n      logVerbose(\n        `Existing deployment: ${selection.deploymentToActOn.url} ${selection.deploymentToActOn.source}`,\n      );\n      break;\n    }\n    case \"deploymentWithinProject\": {\n      logVerbose(\n        `Deployment within project: ${prettyProjectSelection(selection.targetProject)}`,\n      );\n      break;\n    }\n    case \"preview\": {\n      logVerbose(`Preview deploy key`);\n      break;\n    }\n    case \"chooseProject\": {\n      logVerbose(`Choose project`);\n      break;\n    }\n    case \"anonymous\": {\n      logVerbose(\n        `Anonymous, has selected deployment?: ${selection.deploymentName !== null}`,\n      );\n      break;\n    }\n    default: {\n      selection satisfies never;\n      logVerbose(`Unknown deployment selection`);\n    }\n  }\n  return null;\n}\n\nfunction prettyProjectSelection(selection: ProjectSelection) {\n  switch (selection.kind) {\n    case \"teamAndProjectSlugs\": {\n      return `Team and project slugs: ${selection.teamSlug} ${selection.projectSlug}`;\n    }\n    case \"deploymentName\": {\n      return `Deployment name: ${selection.deploymentName}`;\n    }\n    case \"projectDeployKey\": {\n      return `Project deploy key`;\n    }\n    default: {\n      selection satisfies never;\n      return `Unknown`;\n    }\n  }\n}\n\nasync function _getDeploymentSelection(\n  ctx: Context,\n  cliArgs: DeploymentSelectionOptions,\n): Promise<DeploymentSelection> {\n  const selectionWithinProject =\n    deploymentSelectionWithinProjectFromOptions(cliArgs);\n  /*\n   - url + adminKey specified via CLI\n   - Do not check any env vars (including ones relevant for auth)\n  */\n  if (cliArgs.url !== undefined && cliArgs.adminKey !== undefined) {\n    return {\n      kind: \"existingDeployment\",\n      deploymentToActOn: {\n        url: cliArgs.url,\n        adminKey: cliArgs.adminKey,\n        deploymentFields: null,\n        source: \"cliArgs\",\n      },\n    };\n  }\n\n  // If --deployment is a fully qualified selector (team:project:ref or\n  // deployment name), we don't need a current project context \u2192 handle it\n  // before env var resolution.\n  if (cliArgs.deployment !== undefined) {\n    const parsed = parseDeploymentSelector(cliArgs.deployment);\n    if (parsed.kind === \"inTeamProject\" && parsed.selector.kind !== \"local\") {\n      return {\n        kind: \"deploymentWithinProject\",\n        targetProject: {\n          kind: \"teamAndProjectSlugs\",\n          teamSlug: parsed.teamSlug,\n          projectSlug: parsed.projectSlug,\n        },\n        selectionWithinProject: {\n          kind: \"deploymentSelector\",\n          selector: cliArgs.deployment,\n        },\n      };\n    }\n    if (parsed.kind === \"deploymentName\") {\n      return {\n        kind: \"deploymentWithinProject\",\n        targetProject: {\n          kind: \"deploymentName\",\n          deploymentName: parsed.deploymentName,\n          deploymentType: null,\n        },\n        selectionWithinProject: {\n          kind: \"deploymentSelector\",\n          selector: cliArgs.deployment,\n        },\n      };\n    }\n    if (parsed.kind === \"inTeamProject\" && parsed.selector.kind === \"local\") {\n      // team:project:local \u2014 we have the cloud project context up front and\n      // don't need to consult env vars at all.\n      return await resolveLocalDeploymentSelection(\n        ctx,\n        parsed,\n        selectionWithinProject,\n        null,\n      );\n    }\n  }\n\n  const baseSelection = await resolveBaseDeploymentSelection(\n    ctx,\n    cliArgs,\n    selectionWithinProject,\n  );\n\n  // If --deployment is a project-scoped local selector (`local` or\n  // `project:local`), override the env-var-derived selection with the local\n  // deployment after performing a cloud-project-mismatch check.\n  if (cliArgs.deployment !== undefined) {\n    const parsed = parseDeploymentSelector(cliArgs.deployment);\n    if (\n      (parsed.kind === \"inCurrentProject\" || parsed.kind === \"inProject\") &&\n      parsed.selector.kind === \"local\"\n    ) {\n      return await resolveLocalDeploymentSelection(\n        ctx,\n        parsed,\n        selectionWithinProject,\n        baseSelection,\n      );\n    }\n  }\n\n  return baseSelection;\n}\n\nasync function resolveBaseDeploymentSelection(\n  ctx: Context,\n  cliArgs: DeploymentSelectionOptions,\n  selectionWithinProject: DeploymentSelectionWithinProject,\n): Promise<DeploymentSelection> {\n  if (cliArgs.envFile !== undefined) {\n    // If an `--env-file` is specified, it must contain enough information for both auth and deployment selection.\n    logVerbose(`Checking env file: ${cliArgs.envFile}`);\n    const existingFile = ctx.fs.exists(cliArgs.envFile)\n      ? ctx.fs.readUtf8File(cliArgs.envFile)\n      : null;\n    if (existingFile === null) {\n      return ctx.crash({\n        exitCode: 1,\n        errorType: \"invalid filesystem or env vars\",\n        printedMessage: \"env file does not exist\",\n      });\n    }\n    const config = dotenv.parse(existingFile);\n    const result = await getDeploymentSelectionFromEnv(\n      ctx,\n      selectionWithinProject,\n      (name) =>\n        config[name] === undefined || config[name] === \"\" ? null : config[name],\n    );\n    if (result.kind === \"unknown\") {\n      return ctx.crash({\n        exitCode: 1,\n        errorType: \"invalid filesystem or env vars\",\n        printedMessage:\n          `env file \\`${cliArgs.envFile}\\` did not contain environment variables for a Convex deployment. ` +\n          `Expected \\`${CONVEX_DEPLOY_KEY_ENV_VAR_NAME}\\`, \\`${CONVEX_DEPLOYMENT_ENV_VAR_NAME}\\`, or both \\`${CONVEX_SELF_HOSTED_URL_VAR_NAME}\\` and \\`${CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME}\\` to be set.`,\n      });\n    }\n    return result.metadata;\n  }\n  // start with .env.local (but doesn't override existing)\n  dotenv.config({ path: ENV_VAR_FILE_PATH });\n  // for variables not already set, use .env values\n  dotenv.config();\n  const result = await getDeploymentSelectionFromEnv(\n    ctx,\n    selectionWithinProject,\n    (name) => {\n      const value = process.env[name];\n      if (value === undefined || value === \"\") {\n        return null;\n      }\n      return value;\n    },\n  );\n  if (result.kind !== \"unknown\") {\n    return result.metadata;\n  }\n  // none of these?\n\n  const isLoggedIn = ctx.bigBrainAuth() !== null;\n  if (\n    (!isLoggedIn ||\n      process.env.CONVEX_AGENT_MODE === \"anonymous\" ||\n      !process.stdin.isTTY) &&\n    !cliArgs.implicitProd &&\n    shouldAllowAnonymousDevelopment()\n  ) {\n    return {\n      kind: \"anonymous\",\n      deploymentName: null,\n      selectionWithinProject,\n    };\n  }\n\n  // Choose a project interactively later\n  return {\n    kind: \"chooseProject\",\n    selectionWithinProject,\n  };\n}\n\n/**\n * Handles the `[team:project:]local` selector. Loads the on-disk local config\n * and (if the config has a `cloudProjectId`) verifies it matches the cloud\n * project the user is asking about. Crashes on mismatch.\n */\nasync function resolveLocalDeploymentSelection(\n  ctx: Context,\n  parsed: ParsedDeploymentSelector,\n  selectionWithinProject: DeploymentSelectionWithinProject,\n  currentSelection: DeploymentSelection | null,\n): Promise<DeploymentSelection> {\n  const localConfig = loadProjectLocalConfig(ctx);\n  if (localConfig === null) {\n    return ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `No local deployment found. Run ${chalkStderr.bold(\"npx convex deployment create local\")} to create one.`,\n    });\n  }\n  // Only resolve the target cloud project if the on-disk config has a\n  // `cloudProjectId` to compare against \u2014 this avoids unnecessary platform\n  // calls for older configs and anonymous mode.\n  if (localConfig.config.cloudProjectId !== undefined) {\n    const target = await targetProjectForLocalSelector(\n      ctx,\n      parsed,\n      currentSelection ?? { kind: \"chooseProject\", selectionWithinProject },\n    );\n    if (target !== null) {\n      const match = checkLocalConfigMatchesProject(\n        ctx,\n        localConfig.config,\n        target,\n      );\n      if (match === \"mismatch\") {\n        const newSelector = `${target.teamSlug}:${target.slug}:local`;\n        return ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            `The local deployment in this directory is in a different project than \\`${target.teamSlug}:${target.slug}\\`. ` +\n            `\\n${chalkStderr.dim(`${chalkStderr.bold(\"Hint\")}: If you want to move the local deployment to this project, run ${chalkStderr.bold(`npx convex deployment select ${newSelector}`)}`)}`,\n        });\n      }\n    }\n  }\n  return {\n    kind: \"deploymentWithinProject\",\n    targetProject: {\n      kind: \"deploymentName\",\n      deploymentName: localConfig.deploymentName,\n      deploymentType: \"local\",\n    },\n    selectionWithinProject,\n  };\n}\n\nasync function getDeploymentSelectionFromEnv(\n  ctx: Context,\n  selectionWithinProject: DeploymentSelectionWithinProject,\n  getEnv: (name: string) => string | null,\n): Promise<\n  { kind: \"success\"; metadata: DeploymentSelection } | { kind: \"unknown\" }\n> {\n  const rawDeployKey = readDeployKeyFromEnv(getEnv);\n  const deployKey = await processDeployKeyValue(ctx, rawDeployKey);\n  if (deployKey !== undefined) {\n    const deployKeyType = isPreviewDeployKey(deployKey)\n      ? \"preview\"\n      : isProjectKey(deployKey)\n        ? \"project\"\n        : \"deployment\";\n    switch (deployKeyType) {\n      case \"preview\": {\n        // `CONVEX_DEPLOY_KEY` is set to a preview deploy key so this takes precedence over anything else.\n        // At the moment, we don't verify that there aren't other env vars that would also be used for deployment selection (e.g. `CONVEX_DEPLOYMENT`)\n        return {\n          kind: \"success\",\n          metadata: {\n            kind: \"preview\",\n            previewDeployKey: deployKey,\n            selectionWithinProject,\n          },\n        };\n      }\n      case \"project\": {\n        // `CONVEX_DEPLOY_KEY` is set to a project deploy key.\n        // Commands can select any deployment within the project. At the moment we don't check for other env vars (e.g. `CONVEX_DEPLOYMENT`)\n        return {\n          kind: \"success\",\n          metadata: {\n            kind: \"deploymentWithinProject\",\n            targetProject: {\n              kind: \"projectDeployKey\",\n              projectDeployKey: deployKey,\n            },\n            selectionWithinProject,\n          },\n        };\n      }\n      case \"deployment\": {\n        // `CONVEX_DEPLOY_KEY` is set to a deployment's deploy key.\n        // Deploy to this deployment -- selectors like `--prod` / `--preview-name` will be ignored.\n        // At the moment, we don't verify that there aren't other env vars that would also be used for deployment selection (e.g. `CONVEX_DEPLOYMENT`)\n        const deploymentName = await deploymentNameFromAdminKeyOrCrash(\n          ctx,\n          deployKey,\n        );\n        const deploymentType = deploymentTypeFromAdminKey(deployKey);\n        // We cannot derive the deployment URL from the deploy key, because it\n        // might be a custom domain. Ask big brain for the URL.\n        const url = await bigBrainAPI({\n          ctx,\n          method: \"POST\",\n          path: \"deployment/url_for_key\",\n          data: {\n            deployKey: deployKey,\n          },\n        });\n        const slugs = await fetchTeamAndProjectForKey(ctx, deployKey);\n        return {\n          kind: \"success\",\n          metadata: {\n            kind: \"existingDeployment\",\n            deploymentToActOn: {\n              url: url,\n              adminKey: deployKey,\n              deploymentFields: {\n                deploymentName: deploymentName,\n                deploymentType: deploymentType,\n                teamSlug: slugs.team,\n                projectSlug: slugs.project,\n                reference: slugs.reference,\n                isDefault: slugs.isDefault,\n              },\n              source: \"deployKey\",\n            },\n          },\n        };\n      }\n      default: {\n        deployKeyType satisfies never;\n        return ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage: `Unexpected deploy key type: ${deployKeyType as any}`,\n        });\n      }\n    }\n  }\n\n  const convexDeployment = getEnv(CONVEX_DEPLOYMENT_ENV_VAR_NAME);\n  const selfHostedUrl = getEnv(CONVEX_SELF_HOSTED_URL_VAR_NAME);\n  const selfHostedAdminKey = getEnv(CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME);\n\n  if (selfHostedUrl !== null && selfHostedAdminKey !== null) {\n    if (convexDeployment !== null) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"invalid filesystem or env vars\",\n        printedMessage: `${CONVEX_DEPLOYMENT_ENV_VAR_NAME} must not be set when ${CONVEX_SELF_HOSTED_URL_VAR_NAME} and ${CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME} are set`,\n      });\n    }\n    return {\n      kind: \"success\",\n      metadata: {\n        kind: \"existingDeployment\",\n        deploymentToActOn: {\n          url: selfHostedUrl,\n          adminKey: selfHostedAdminKey,\n          deploymentFields: null,\n          source: \"selfHosted\",\n        },\n      },\n    };\n  }\n\n  // --deployment-name\u2019s deployment may be in a different project from CONVEX_DEPLOYMENT.\n  if (selectionWithinProject.kind === \"deploymentName\") {\n    return {\n      kind: \"success\",\n      metadata: {\n        kind: \"deploymentWithinProject\",\n        targetProject: {\n          kind: \"deploymentName\",\n          deploymentName: selectionWithinProject.deploymentName,\n          deploymentType: null,\n        },\n        selectionWithinProject,\n      },\n    };\n  }\n\n  if (convexDeployment !== null) {\n    if (selfHostedUrl !== null || selfHostedAdminKey !== null) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"invalid filesystem or env vars\",\n        printedMessage: `${CONVEX_SELF_HOSTED_URL_VAR_NAME} and ${CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME} must not be set when ${CONVEX_DEPLOYMENT_ENV_VAR_NAME} is set`,\n      });\n    }\n    const targetDeploymentType =\n      getDeploymentTypeFromConfiguredDeployment(convexDeployment);\n\n    // Commands can select a deployment within the project that this deployment belongs to.\n    const targetDeploymentName = stripDeploymentTypePrefix(convexDeployment);\n    const isAnonymous = isAnonymousDeployment(targetDeploymentName);\n    if (isAnonymous) {\n      if (!shouldAllowAnonymousDevelopment()) {\n        return {\n          kind: \"unknown\",\n        };\n      }\n      return {\n        kind: \"success\",\n        metadata: {\n          kind: \"anonymous\",\n          deploymentName: targetDeploymentName,\n          selectionWithinProject,\n        },\n      };\n    }\n\n    // Overwrite the selection within project\n    const newSelectionWithinProject =\n      selectionWithinProject.kind === \"unspecified\" &&\n      // Fetching local deployment credentials uses the \"unspecified\" code path\n      targetDeploymentType !== \"local\"\n        ? {\n            kind: \"deploymentName\" as const,\n            deploymentName: targetDeploymentName,\n          }\n        : selectionWithinProject;\n    return {\n      kind: \"success\",\n      metadata: {\n        kind: \"deploymentWithinProject\",\n        targetProject: {\n          kind: \"deploymentName\",\n          deploymentName: targetDeploymentName,\n          deploymentType: targetDeploymentType,\n        },\n        selectionWithinProject: newSelectionWithinProject,\n      },\n    };\n  }\n\n  // Throw a nice error if we're in something like a CI environment where we need a valid deployment configuration\n  await checkIfBuildEnvironmentRequiresDeploymentConfig(ctx);\n\n  return { kind: \"unknown\" };\n}\n\nasync function checkIfBuildEnvironmentRequiresDeploymentConfig(ctx: Context) {\n  const buildEnvironment = getBuildEnvironment();\n  if (buildEnvironment) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        `${buildEnvironment} build environment detected but no Convex deployment configuration found.\\n` +\n        `Set one of:\\n` +\n        `  \u2022 ${CONVEX_DEPLOY_KEY_ENV_VAR_NAME} for Convex Cloud deployments\\n` +\n        `  \u2022 ${CONVEX_SELF_HOSTED_URL_VAR_NAME} and ${CONVEX_SELF_HOSTED_ADMIN_KEY_VAR_NAME} for self-hosted deployments\\n` +\n        `See https://docs.convex.dev/production/hosting or https://docs.convex.dev/self-hosting`,\n    });\n  }\n}\n\n/**\n * Used for things like `npx convex docs` where we want to best effort extract a deployment name\n * but don't do the full deployment selection logic.\n */\nexport const deploymentNameFromSelection = (\n  selection: DeploymentSelection,\n): string | null => {\n  return deploymentNameAndTypeFromSelection(selection)?.name ?? null;\n};\n\nexport const deploymentNameAndTypeFromSelection = (\n  selection: DeploymentSelection,\n): { name: string | null; type: string | null } | null => {\n  switch (selection.kind) {\n    case \"existingDeployment\": {\n      return {\n        name:\n          selection.deploymentToActOn.deploymentFields?.deploymentName ?? null,\n        type:\n          selection.deploymentToActOn.deploymentFields?.deploymentType ?? null,\n      };\n    }\n    case \"deploymentWithinProject\": {\n      return selection.targetProject.kind === \"deploymentName\"\n        ? {\n            name: selection.targetProject.deploymentName,\n            type: selection.targetProject.deploymentType,\n          }\n        : null;\n    }\n    case \"preview\": {\n      return null;\n    }\n    case \"chooseProject\": {\n      return null;\n    }\n    case \"anonymous\": {\n      return null;\n    }\n    default: {\n      selection satisfies never;\n    }\n  }\n  return null;\n};\n\nexport const shouldAllowAnonymousDevelopment = (): boolean => {\n  // Kill switch / temporary opt out\n  if (process.env.CONVEX_ALLOW_ANONYMOUS === \"false\") {\n    return false;\n  }\n  return true;\n};\n\n/**\n * Fetch the project details corresponding to the given ProjectSelection.\n */\nexport async function getProjectDetails(\n  ctx: Context,\n  projectSelection: ProjectSelection,\n): Promise<PlatformProjectDetails> {\n  switch (projectSelection.kind) {\n    case \"deploymentName\": {\n      if (projectSelection.deploymentType === \"local\") {\n        const result = await getTeamAndProjectSlugForDeployment(ctx, {\n          deploymentName: projectSelection.deploymentName,\n        });\n        if (result === null) {\n          return ctx.crash({\n            exitCode: 1,\n            errorType: \"fatal\",\n            printedMessage:\n              \"You don't have access to the selected project. Run `npx convex dev` to select a different project.\",\n          });\n        }\n        return await getProjectDetails(ctx, {\n          kind: \"teamAndProjectSlugs\",\n          teamSlug: result.teamSlug,\n          projectSlug: result.projectSlug,\n        });\n      }\n\n      const deployment = (\n        await typedPlatformClient(ctx).GET(\"/deployments/{deployment_name}\", {\n          params: {\n            path: { deployment_name: projectSelection.deploymentName },\n          },\n        })\n      ).data!;\n      return (\n        await typedPlatformClient(ctx).GET(\"/projects/{project_id}\", {\n          params: { path: { project_id: deployment.projectId } },\n        })\n      ).data!;\n    }\n    case \"teamAndProjectSlugs\": {\n      return (\n        await typedPlatformClient(ctx).GET(\n          \"/teams/{team_id_or_slug}/projects/{project_slug}\",\n          {\n            params: {\n              path: {\n                team_id_or_slug: projectSelection.teamSlug,\n                project_slug: projectSelection.projectSlug,\n              },\n            },\n          },\n        )\n      ).data!;\n    }\n    case \"projectDeployKey\": {\n      const result = await fetchTeamAndProjectForKey(\n        ctx,\n        projectSelection.projectDeployKey,\n      );\n      return (\n        await typedPlatformClient(ctx).GET(\"/projects/{project_id}\", {\n          params: { path: { project_id: result.projectId } },\n        })\n      ).data!;\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": ["rawDeployKey", "deployKey", "result"]
 }

package/dist/esm/cli/lib/dev.js

@@ -27,6 +27,9 @@ import {
   syncAuthKitConfigAfterPush,
   ensureAuthKitProvisionedBeforeBuild
 } from "./workos/workos.js";
+import { handleDashboard } from "./localDeployment/dashboard.js";
+import { loadDeploymentConfig } from "./localDeployment/filePaths.js";
+import { LocalDeploymentError } from "./localDeployment/errors.js";
 export async function devAgainstDeployment(ctx, credentials, devOptions) {
   const logManager = new LogManager(devOptions.tailLogs);
   const { projectConfig } = await readProjectConfig(ctx);
@@ -42,6 +45,34 @@ export async function devAgainstDeployment(ctx, credentials, devOptions) {
       );
     }
   }
+  if (!devOptions.once && !devOptions.untilSuccess && credentials.deploymentType === "anonymous" && credentials.deploymentName !== null) {
+    const deploymentConfig = loadDeploymentConfig(
+      ctx,
+      "anonymous",
+      credentials.deploymentName
+    );
+    if (deploymentConfig === null) {
+      return await ctx.crash({
+        exitCode: 1,
+        errorType: "fatal",
+        printedMessage: `Could not find local deployment config. This is a bug in Convex.`,
+        errForSentry: new LocalDeploymentError(
+          `Could not find local deployment config to start the anonymous dashboard.`
+        )
+      });
+    }
+    await handleDashboard(
+      ctx,
+      {
+        name: credentials.deploymentName,
+        cloudPort: deploymentConfig.ports.cloud,
+        adminKey: deploymentConfig.adminKey
+      },
+      {
+        backendVersion: credentials.backendVersion
+      }
+    );
+  }
   const promises = [];
   if (devOptions.tailLogs !== "disable") {
     promises.push(