convex 1.45.0 → 1.47.0

package/dist/cjs/cli/lib/api.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/lib/api.ts"],
-  "sourcesContent": ["import { Context } from \"../../bundler/context.js\";\nimport { logVerbose, logWarning } from \"../../bundler/log.js\";\nimport { getTeamAndProjectFromPreviewAdminKey } from \"./deployment.js\";\nimport {\n  assertLocalBackendRunning,\n  localDeploymentUrl,\n} from \"./localDeployment/run.js\";\nimport {\n  ThrowingFetchError,\n  bigBrainAPI,\n  bigBrainAPIMaybeThrows,\n  logAndHandleFetchError,\n  typedPlatformClient,\n} from \"./utils/utils.js\";\nimport { z } from \"zod\";\nimport {\n  DeploymentSelection,\n  ProjectSelection,\n} from \"./deploymentSelection.js\";\nimport { loadLocalDeploymentCredentials } from \"./localDeployment/localDeployment.js\";\nimport { loadAnonymousDeployment } from \"./localDeployment/anonymous.js\";\nimport {\n  parseDeploymentSelector,\n  InProjectSelector,\n} from \"./deploymentSelector.js\";\nimport { loadProjectLocalConfig } from \"./localDeployment/filePaths.js\";\nimport { chalkStderr } from \"chalk\";\nimport { RegionName } from \"../generatedApi.js\";\nexport type DeploymentName = string;\nexport type CloudDeploymentType = \"prod\" | \"dev\" | \"preview\" | \"custom\";\nexport type AccountRequiredDeploymentType = CloudDeploymentType | \"local\";\nexport type DeploymentType = AccountRequiredDeploymentType | \"anonymous\";\n\nexport type Project = {\n  id: number;\n  name: string;\n  slug: string;\n};\n\ntype AdminKey = string;\n\n/**\n * Create a new project. If `deploymentToProvision` is specified, also provision a deployment for the project.\n */\nexport async function createProject(\n  ctx: Context,\n  {\n    teamId,\n    projectName,\n    deploymentToProvision,\n  }: {\n    teamId: number;\n    projectName: string;\n    deploymentToProvision: {\n      deploymentType: \"prod\" | \"dev\";\n      region: RegionName | null;\n    } | null;\n  },\n): Promise<{\n  projectSlug: string;\n}> {\n  const response = await typedPlatformClient(ctx).POST(\n    \"/teams/{team_id}/create_project\",\n    {\n      params: { path: { team_id: teamId } },\n      body: {\n        projectName,\n        deploymentType: deploymentToProvision?.deploymentType ?? null,\n        deploymentRegion: deploymentToProvision?.region ?? null,\n      },\n    },\n  );\n  const projectSlug = response.data?.slug;\n  if (projectSlug === undefined) {\n    const error =\n      \"Unexpected response during provisioning: \" + JSON.stringify(response);\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"transient\",\n      errForSentry: error,\n      printedMessage: error,\n    });\n  }\n  return {\n    projectSlug,\n  };\n}\n\n// ----------------------------------------------------------------------\n// Helpers for `deploymentSelectionFromOptions`\n// ----------------------------------------------------------------------\n\nexport const deploymentSelectionWithinProjectSchema = z.discriminatedUnion(\n  \"kind\",\n  [\n    z.object({ kind: z.literal(\"previewName\"), previewName: z.string() }),\n    z.object({ kind: z.literal(\"deploymentName\"), deploymentName: z.string() }),\n    z.object({ kind: z.literal(\"prod\") }),\n    z.object({ kind: z.literal(\"implicitProd\") }),\n    z.object({ kind: z.literal(\"unspecified\") }),\n    z.object({\n      kind: z.literal(\"deploymentSelector\"),\n      selector: z.string(),\n    }),\n  ],\n);\n\nexport type DeploymentSelectionWithinProject = z.infer<\n  typeof deploymentSelectionWithinProjectSchema\n>;\n\ntype DeploymentSelectionOptionsWithinProject = {\n  prod?: boolean | undefined;\n  // Whether this command defaults to prod when no other flags are provided. If\n  // this is not set, the default will be \"ownDev\"\n  implicitProd?: boolean;\n\n  previewName?: string | undefined;\n  deploymentName?: string | undefined;\n  deployment?: string | undefined;\n};\n\nexport type DeploymentSelectionOptions =\n  DeploymentSelectionOptionsWithinProject & {\n    url?: string | undefined;\n    adminKey?: string | undefined;\n    envFile?: string | undefined;\n  };\n\nexport function deploymentSelectionWithinProjectFromOptions(\n  options: DeploymentSelectionOptions,\n): DeploymentSelectionWithinProject {\n  if (options.deployment !== undefined) {\n    return { kind: \"deploymentSelector\", selector: options.deployment };\n  }\n  if (options.previewName !== undefined) {\n    return { kind: \"previewName\", previewName: options.previewName };\n  }\n  if (options.deploymentName !== undefined) {\n    return { kind: \"deploymentName\", deploymentName: options.deploymentName };\n  }\n  if (options.prod) {\n    return { kind: \"prod\" };\n  }\n  if (options.implicitProd) {\n    return { kind: \"implicitProd\" };\n  }\n  return { kind: \"unspecified\" };\n}\n\nexport async function validateDeploymentSelectionForExistingDeployment(\n  ctx: Context,\n  deploymentSelection: DeploymentSelectionWithinProject,\n  source: \"selfHosted\" | \"deployKey\" | \"cliArgs\",\n) {\n  if (\n    deploymentSelection.kind === \"unspecified\" ||\n    deploymentSelection.kind === \"implicitProd\"\n  ) {\n    // These are both considered the \"default\" selection depending on the command, so this is always fine\n    return;\n  }\n  if (deploymentSelection.kind === \"deploymentSelector\") {\n    switch (source) {\n      case \"selfHosted\":\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"The `--deployment` flag cannot be used with a self-hosted deployment.\",\n        });\n      case \"deployKey\":\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"The `--deployment` flag cannot be used with CONVEX_DEPLOY_KEY.\",\n        });\n      case \"cliArgs\":\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"The `--deployment` flag cannot be used with --url and --admin-key.\",\n        });\n    }\n  }\n  switch (source) {\n    case \"selfHosted\":\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"The `--prod`, `--preview-name`, and `--deployment-name` flags cannot be used with a self-hosted deployment.\",\n      });\n    case \"deployKey\":\n      logWarning(\n        \"Ignoring `--prod`, `--preview-name`, or `--deployment-name` flags and using deployment from CONVEX_DEPLOY_KEY\",\n      );\n      break;\n    case \"cliArgs\":\n      logWarning(\n        \"Ignoring `--prod`, `--preview-name`, or `--deployment-name` flags since this command was run with --url and --admin-key\",\n      );\n      break;\n  }\n}\n\n// ----------------------------------------------------------------------\n// Helpers for `checkAccessToSelectedProject`\n// ----------------------------------------------------------------------\n\nasync function hasAccessToProject(\n  ctx: Context,\n  selector: { projectSlug: string; teamSlug: string },\n): Promise<boolean> {\n  try {\n    await typedPlatformClient(ctx, { throw: true }).GET(\n      \"/teams/{team_id_or_slug}/projects/{project_slug}\",\n      {\n        params: {\n          path: {\n            team_id_or_slug: selector.teamSlug,\n            project_slug: selector.projectSlug,\n          },\n        },\n      },\n    );\n    return true;\n  } catch (err) {\n    if (\n      err instanceof ThrowingFetchError &&\n      (err.serverErrorData?.code === \"TeamNotFound\" ||\n        err.serverErrorData?.code === \"ProjectNotFound\")\n    ) {\n      return false;\n    }\n    return logAndHandleFetchError(ctx, err);\n  }\n}\n\nexport async function checkAccessToSelectedProject(\n  ctx: Context,\n  projectSelection: ProjectSelection,\n): Promise<\n  | { kind: \"hasAccess\"; teamSlug: string; projectSlug: string }\n  | { kind: \"noAccess\" }\n  | { kind: \"unknown\" }\n> {\n  switch (projectSelection.kind) {\n    case \"deploymentName\": {\n      const result = await getTeamAndProjectSlugForDeployment(ctx, {\n        deploymentName: projectSelection.deploymentName,\n      });\n      if (result === null) {\n        return { kind: \"noAccess\" };\n      }\n      return {\n        kind: \"hasAccess\",\n        teamSlug: result.teamSlug,\n        projectSlug: result.projectSlug,\n      };\n    }\n    case \"teamAndProjectSlugs\": {\n      const hasAccess = await hasAccessToProject(ctx, {\n        teamSlug: projectSelection.teamSlug,\n        projectSlug: projectSelection.projectSlug,\n      });\n      if (!hasAccess) {\n        return { kind: \"noAccess\" };\n      }\n      return {\n        kind: \"hasAccess\",\n        teamSlug: projectSelection.teamSlug,\n        projectSlug: projectSelection.projectSlug,\n      };\n    }\n    case \"projectDeployKey\":\n      // Ideally we would be able to do an explicit check here, but if the key is invalid,\n      // it will instead fail as soon as we try to use the key.\n      return { kind: \"unknown\" };\n    default: {\n      projectSelection satisfies never;\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: `Invalid project selection: ${(projectSelection as any).kind}`,\n      });\n    }\n  }\n}\n\nexport async function getTeamAndProjectSlugForDeployment(\n  ctx: Context,\n  selector: { deploymentName: string },\n): Promise<{ teamSlug: string; projectSlug: string } | null> {\n  try {\n    const body = await bigBrainAPIMaybeThrows({\n      ctx,\n      path: `deployment/${selector.deploymentName}/team_and_project`,\n      method: \"GET\",\n    });\n    return { teamSlug: body.team, projectSlug: body.project };\n  } catch (err) {\n    if (\n      err instanceof ThrowingFetchError &&\n      (err.serverErrorData?.code === \"DeploymentNotFound\" ||\n        err.serverErrorData?.code === \"ProjectNotFound\")\n    ) {\n      return null;\n    }\n    return logAndHandleFetchError(ctx, err);\n  }\n}\n\n// ----------------------------------------------------------------------\n// Helpers for fetching deployment credentials\n// ----------------------------------------------------------------------\n\n// Used by dev for upgrade from team and project in convex.json to CONVEX_DEPLOYMENT\nexport async function fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows(\n  ctx: Context,\n  projectSelection:\n    | { kind: \"teamAndProjectSlugs\"; teamSlug: string; projectSlug: string }\n    | { kind: \"projectDeployKey\"; projectDeployKey: string },\n  deploymentType: \"prod\" | \"dev\",\n): Promise<{\n  deploymentName: string;\n  deploymentUrl: string;\n  adminKey: AdminKey;\n  reference: string;\n  isDefault: boolean;\n}> {\n  if (projectSelection.kind === \"projectDeployKey\") {\n    const auth = ctx.bigBrainAuth();\n    const doesAuthMatch =\n      auth !== null &&\n      auth.kind === \"projectKey\" &&\n      auth.projectKey === projectSelection.projectDeployKey;\n    if (!doesAuthMatch) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        errForSentry: new Error(\n          \"Expected project deploy key to match the big brain auth header\",\n        ),\n        printedMessage: \"Unexpected error when loading the Convex deployment\",\n      });\n    }\n  }\n  let data;\n  try {\n    data = await bigBrainAPIMaybeThrows({\n      ctx,\n      method: \"POST\",\n      path: \"deployment/provision_and_authorize\",\n      data: {\n        teamSlug:\n          projectSelection.kind === \"teamAndProjectSlugs\"\n            ? projectSelection.teamSlug\n            : null,\n        projectSlug:\n          projectSelection.kind === \"teamAndProjectSlugs\"\n            ? projectSelection.projectSlug\n            : null,\n        deploymentType: deploymentType === \"prod\" ? \"prod\" : \"dev\",\n      },\n    });\n  } catch (error) {\n    const msg = \"Unknown error during authorization: \" + error;\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"transient\",\n      errForSentry: new Error(msg),\n      printedMessage: msg,\n    });\n  }\n  const { adminKey, url, deploymentName, reference, isDefault } = data;\n  if (adminKey === undefined || url === undefined) {\n    const msg = \"Unknown error during authorization: \" + JSON.stringify(data);\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"transient\",\n      errForSentry: new Error(msg),\n      printedMessage: msg,\n    });\n  }\n  return { adminKey, deploymentUrl: url, deploymentName, reference, isDefault };\n}\n\nasync function fetchExistingDevDeploymentCredentialsOrCrash(\n  ctx: Context,\n  deploymentName: DeploymentName,\n): Promise<DeploymentAuthResponse> {\n  const slugs = await fetchTeamAndProject(ctx, deploymentName);\n  const credentials =\n    await fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows(\n      ctx,\n      {\n        kind: \"teamAndProjectSlugs\",\n        teamSlug: slugs.team,\n        projectSlug: slugs.project,\n      },\n      \"dev\",\n    );\n  return {\n    deploymentName: credentials.deploymentName,\n    adminKey: credentials.adminKey,\n    url: credentials.deploymentUrl,\n    deploymentType: \"dev\",\n    reference: credentials.reference,\n    isDefault: credentials.isDefault,\n  };\n}\n\n// ----------------------------------------------------------------------\n// Helpers for `loadSelectedDeploymentCredentials`\n// ----------------------------------------------------------------------\n\ntype DeploymentAuthResponse = {\n  deploymentName: string;\n  adminKey: string;\n  url: string;\n  deploymentType: DeploymentType;\n  reference: string | null; // null = local deployment\n  isDefault: boolean;\n};\n\n// Returns the user's own dev deployment, which may be a local deployment\n// if one is configured. Used for dev commands (including `npx convex dev`)\n// when no specific deployment is specified.\nasync function handleOwnDev(\n  ctx: Context,\n  projectSelection: ProjectSelection,\n): Promise<DeploymentAuthResponse> {\n  switch (projectSelection.kind) {\n    case \"deploymentName\": {\n      if (projectSelection.deploymentType === \"local\") {\n        const credentials = await loadLocalDeploymentCredentials(\n          ctx,\n          projectSelection.deploymentName,\n        );\n        return {\n          deploymentName: projectSelection.deploymentName,\n          adminKey: credentials.adminKey,\n          url: credentials.deploymentUrl,\n          deploymentType: \"local\",\n          reference: null,\n          isDefault: false,\n        };\n      }\n      return await fetchExistingDevDeploymentCredentialsOrCrash(\n        ctx,\n        projectSelection.deploymentName,\n      );\n    }\n    case \"teamAndProjectSlugs\":\n    case \"projectDeployKey\": {\n      // Note -- this provisions a dev deployment if one doesn't exist\n      const credentials =\n        await fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows(\n          ctx,\n          projectSelection,\n          \"dev\",\n        );\n      return {\n        url: credentials.deploymentUrl,\n        adminKey: credentials.adminKey,\n        deploymentName: credentials.deploymentName,\n        deploymentType: \"dev\",\n        reference: credentials.reference,\n        isDefault: credentials.isDefault,\n      };\n    }\n    default: {\n      projectSelection satisfies never;\n      return ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        // This should be unreachable, so don't bother with a printed message.\n        printedMessage: null,\n        errForSentry: `Unexpected project selection: ${(projectSelection as any).kind}`,\n      });\n    }\n  }\n}\n\nasync function handleProd(\n  ctx: Context,\n  projectSelection: ProjectSelection,\n): Promise<DeploymentAuthResponse & { deploymentType: \"prod\" }> {\n  switch (projectSelection.kind) {\n    case \"deploymentName\": {\n      const credentials = await bigBrainAPI({\n        ctx,\n        method: \"POST\",\n        path: \"deployment/authorize_prod\",\n        data: {\n          deploymentName: projectSelection.deploymentName,\n        },\n      });\n      return credentials;\n    }\n    case \"teamAndProjectSlugs\":\n    case \"projectDeployKey\": {\n      const credentials =\n        await fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows(\n          ctx,\n          projectSelection,\n          \"prod\",\n        );\n      return {\n        url: credentials.deploymentUrl,\n        adminKey: credentials.adminKey,\n        deploymentName: credentials.deploymentName,\n        deploymentType: \"prod\",\n        reference: credentials.reference,\n        isDefault: credentials.isDefault,\n      };\n    }\n  }\n}\n\nasync function handlePreview(\n  ctx: Context,\n  previewName: string,\n  projectSelection: ProjectSelection,\n): Promise<DeploymentAuthResponse & { deploymentType: \"preview\" }> {\n  switch (projectSelection.kind) {\n    case \"deploymentName\":\n    case \"teamAndProjectSlugs\": {\n      const credentials = await bigBrainAPI({\n        ctx,\n        method: \"POST\",\n        path: \"deployment/authorize_preview\",\n        data: {\n          previewName: previewName,\n          projectSelection: projectSelection,\n        },\n      });\n      return credentials;\n    }\n\n    case \"projectDeployKey\":\n      // TODO -- this should be supported\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"Project deploy keys are not supported for preview deployments\",\n      });\n  }\n}\n\nasync function handleDeploymentName(\n  ctx: Context,\n  deploymentName: string,\n  projectSelection: ProjectSelection,\n): Promise<DeploymentAuthResponse> {\n  switch (projectSelection.kind) {\n    case \"deploymentName\":\n    case \"teamAndProjectSlugs\": {\n      const credentials = await bigBrainAPI({\n        ctx,\n        method: \"POST\",\n        path: \"deployment/authorize_within_current_project\",\n        data: {\n          selectedDeploymentName: deploymentName,\n          projectSelection: projectSelection,\n        },\n      });\n      return credentials;\n    }\n    case \"projectDeployKey\":\n      // TODO -- this should be supported\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"Project deploy keys are not supported with the --deployment-name flag\",\n      });\n  }\n}\n\nasync function fetchDeploymentCredentialsWithinCurrentProject(\n  ctx: Context,\n  projectSelection: ProjectSelection,\n  deploymentSelection: DeploymentSelectionWithinProject,\n): Promise<DeploymentAuthResponse> {\n  switch (deploymentSelection.kind) {\n    case \"unspecified\": {\n      // default to the user's default dev deployment\n      // TODO: this currently also handles local dev, but that should probably be split out into a different DeploymenSelection kind\n      return await handleOwnDev(ctx, projectSelection);\n    }\n    case \"implicitProd\":\n    case \"prod\": {\n      return await handleProd(ctx, projectSelection);\n    }\n    case \"previewName\":\n      return await handlePreview(\n        ctx,\n        deploymentSelection.previewName,\n        projectSelection,\n      );\n    case \"deploymentName\":\n      return await handleDeploymentName(\n        ctx,\n        deploymentSelection.deploymentName,\n        projectSelection,\n      );\n    case \"deploymentSelector\":\n      return await handleDeploymentSelector(\n        ctx,\n        deploymentSelection.selector,\n        projectSelection,\n      );\n    default: {\n      deploymentSelection satisfies never;\n      return ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        // This should be unreachable, so don't bother with a printed message.\n        printedMessage: null,\n        errForSentry: `Unexpected deployment selection: ${deploymentSelection as any}`,\n      });\n    }\n  }\n}\n\nasync function resolveDeploymentNameByReference(\n  ctx: Context,\n  teamSlug: string,\n  projectSlug: string,\n  reference: string,\n): Promise<string> {\n  try {\n    const result = await typedPlatformClient(ctx, { throw: true }).GET(\n      \"/teams/{team_id_or_slug}/projects/{project_slug}/deployment\",\n      {\n        params: {\n          path: { team_id_or_slug: teamSlug, project_slug: projectSlug },\n          query: { reference },\n        },\n      },\n    );\n\n    return result.data!.name;\n  } catch (err) {\n    if (\n      err instanceof ThrowingFetchError &&\n      err.serverErrorData?.code === \"DeploymentNotFound\"\n    ) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: `Deployment \u201C${reference}\u201D not found. To create a new deployment, use ${chalkStderr.bold(`npx convex deployment create ${teamSlug}:${projectSlug}:${reference} --select`)}`,\n        errForSentry: err,\n      });\n    }\n    return await logAndHandleFetchError(ctx, err);\n  }\n}\n\nasync function handleRefInProject(\n  ctx: Context,\n  selector: InProjectSelector,\n  projectSelection: ProjectSelection,\n): Promise<DeploymentAuthResponse> {\n  switch (selector.kind) {\n    case \"local\": {\n      // The mismatch check for `[team:project:]local` has already happened in\n      // `_getDeploymentSelection`, so we only need to load credentials here.\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      const credentials = await loadLocalDeploymentCredentials(\n        ctx,\n        localConfig.deploymentName,\n      );\n      return {\n        deploymentName: localConfig.deploymentName,\n        adminKey: credentials.adminKey,\n        url: credentials.deploymentUrl,\n        deploymentType: \"local\",\n        reference: null,\n        isDefault: false,\n      };\n    }\n    case \"dev\": {\n      const access = await checkAccessToSelectedProject(ctx, projectSelection);\n      if (access.kind !== \"hasAccess\") {\n        return await 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      const deploymentName = await resolveDefaultCloudDevDeploymentName(\n        ctx,\n        access.teamSlug,\n        access.projectSlug,\n      );\n      // Pass teamAndProjectSlugs instead of the original projectSelection,\n      // because handleDeploymentName sends projectSelection to Big Brain's\n      // authorize_within_current_project endpoint, which doesn't understand\n      // deploymentType \"local\".\n      return await handleDeploymentName(ctx, deploymentName, {\n        kind: \"teamAndProjectSlugs\",\n        teamSlug: access.teamSlug,\n        projectSlug: access.projectSlug,\n      });\n    }\n    case \"prod\":\n      return await handleProd(ctx, projectSelection);\n    case \"reference\": {\n      const access = await checkAccessToSelectedProject(ctx, projectSelection);\n      if (access.kind !== \"hasAccess\") {\n        return await 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      const deploymentName = await resolveDeploymentNameByReference(\n        ctx,\n        access.teamSlug,\n        access.projectSlug,\n        selector.reference,\n      );\n      return await handleDeploymentName(ctx, deploymentName, projectSelection);\n    }\n  }\n}\n\nasync function handleDeploymentSelector(\n  ctx: Context,\n  selector: string,\n  projectSelection: ProjectSelection,\n): Promise<DeploymentAuthResponse> {\n  const parsed = parseDeploymentSelector(selector);\n  switch (parsed.kind) {\n    case \"deploymentName\":\n      return await handleDeploymentName(\n        ctx,\n        parsed.deploymentName,\n        projectSelection,\n      );\n    case \"inCurrentProject\":\n      return await handleRefInProject(ctx, parsed.selector, projectSelection);\n    case \"inProject\": {\n      const access = await checkAccessToSelectedProject(ctx, projectSelection);\n      if (access.kind !== \"hasAccess\") {\n        return await 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 handleRefInProject(ctx, parsed.selector, {\n        kind: \"teamAndProjectSlugs\",\n        teamSlug: access.teamSlug,\n        projectSlug: parsed.projectSlug,\n      });\n    }\n    case \"inTeamProject\":\n      return await handleRefInProject(ctx, parsed.selector, {\n        kind: \"teamAndProjectSlugs\",\n        teamSlug: parsed.teamSlug,\n        projectSlug: parsed.projectSlug,\n      });\n  }\n}\n\nasync function _loadExistingDeploymentCredentialsForProject(\n  ctx: Context,\n  targetProject: ProjectSelection,\n  deploymentSelection: DeploymentSelectionWithinProject,\n  { ensureLocalRunning } = { ensureLocalRunning: true },\n): Promise<DetailedDeploymentCredentials> {\n  const accessResult = await checkAccessToSelectedProject(ctx, targetProject);\n  if (accessResult.kind === \"noAccess\") {\n    return await 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  const result = await fetchDeploymentCredentialsWithinCurrentProject(\n    ctx,\n    targetProject,\n    deploymentSelection,\n  );\n  logVerbose(\n    `Deployment URL: ${result.url}, Deployment Name: ${result.deploymentName}, Deployment Type: ${result.deploymentType}`,\n  );\n  if (ensureLocalRunning && result.deploymentType === \"local\") {\n    await assertLocalBackendRunning(ctx, {\n      url: result.url,\n      deploymentName: result.deploymentName,\n    });\n  }\n  return {\n    ...result,\n    deploymentFields: {\n      deploymentName: result.deploymentName,\n      deploymentType: result.deploymentType,\n      reference: result.reference,\n      isDefault: result.isDefault,\n      projectSlug:\n        accessResult.kind === \"hasAccess\" ? accessResult.projectSlug : null,\n      teamSlug:\n        accessResult.kind === \"hasAccess\" ? accessResult.teamSlug : null,\n    },\n  };\n}\n\nexport type DetailedDeploymentCredentials = {\n  adminKey: string;\n  url: string;\n  deploymentFields: {\n    deploymentName: string;\n    deploymentType: DeploymentType;\n    projectSlug: string | null;\n    teamSlug: string | null;\n    reference: string | null;\n    isDefault: boolean;\n  } | null;\n};\n\n/**\n * This is used by most commands to determine which deployment to act on, taking into account the deployment selection flags.\n */\nexport async function loadSelectedDeploymentCredentials(\n  ctx: Context,\n  deploymentSelection: DeploymentSelection,\n  { ensureLocalRunning } = { ensureLocalRunning: true },\n): Promise<DetailedDeploymentCredentials> {\n  switch (deploymentSelection.kind) {\n    case \"existingDeployment\":\n      // We're already set up.\n      logVerbose(\n        `Deployment URL: ${deploymentSelection.deploymentToActOn.url}, Deployment Name: ${deploymentSelection.deploymentToActOn.deploymentFields?.deploymentName ?? \"unknown\"}, Deployment Type: ${deploymentSelection.deploymentToActOn.deploymentFields?.deploymentType ?? \"unknown\"}`,\n      );\n      return {\n        adminKey: deploymentSelection.deploymentToActOn.adminKey,\n        url: deploymentSelection.deploymentToActOn.url,\n        deploymentFields:\n          deploymentSelection.deploymentToActOn.deploymentFields,\n      };\n    case \"chooseProject\":\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"No CONVEX_DEPLOYMENT set, run `npx convex dev` to configure a Convex project\",\n      });\n    case \"preview\": {\n      const slugs = await getTeamAndProjectFromPreviewAdminKey(\n        ctx,\n        deploymentSelection.previewDeployKey,\n      );\n      return await _loadExistingDeploymentCredentialsForProject(\n        ctx,\n        {\n          kind: \"teamAndProjectSlugs\",\n          teamSlug: slugs.teamSlug,\n          projectSlug: slugs.projectSlug,\n        },\n        // Note that the user could select a non-preview deployment here, and it would succeed if the user is logged in locally because getBigBrainAuth prefers the user's access token over the preview deploy key.\n        deploymentSelection.selectionWithinProject,\n        { ensureLocalRunning },\n      );\n    }\n    case \"deploymentWithinProject\": {\n      return await _loadExistingDeploymentCredentialsForProject(\n        ctx,\n        deploymentSelection.targetProject,\n        deploymentSelection.selectionWithinProject,\n        { ensureLocalRunning },\n      );\n    }\n    case \"anonymous\": {\n      if (deploymentSelection.deploymentName === null) {\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"No CONVEX_DEPLOYMENT set, run `npx convex dev` to configure a Convex project\",\n        });\n      }\n      const config = await loadAnonymousDeployment(\n        ctx,\n        deploymentSelection.deploymentName,\n      );\n      const url = localDeploymentUrl(config.ports.cloud);\n      if (ensureLocalRunning) {\n        await assertLocalBackendRunning(ctx, {\n          url,\n          deploymentName: deploymentSelection.deploymentName,\n        });\n      }\n      return {\n        adminKey: config.adminKey,\n        url,\n        deploymentFields: {\n          deploymentName: deploymentSelection.deploymentName,\n          deploymentType: \"anonymous\",\n          projectSlug: null,\n          teamSlug: null,\n          reference: null,\n          isDefault: false,\n        },\n      };\n    }\n    default: {\n      deploymentSelection satisfies never;\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: \"Unknown deployment type\",\n      });\n    }\n  }\n}\n\nexport async function fetchTeamAndProject(\n  ctx: Context,\n  deploymentName: string,\n) {\n  const data = (await bigBrainAPI({\n    ctx,\n    method: \"GET\",\n    path: `deployment/${deploymentName}/team_and_project`,\n  })) as {\n    team: string; // slug\n    project: string; // slug\n    teamId: number;\n    projectId: number;\n  };\n\n  const { team, project } = data;\n  if (team === undefined || project === undefined) {\n    const msg =\n      \"Unknown error when fetching team and project: \" + JSON.stringify(data);\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"transient\",\n      errForSentry: new Error(msg),\n      printedMessage: msg,\n    });\n  }\n\n  return data;\n}\n\nexport async function fetchTeamAndProjectForKey(\n  ctx: Context,\n  // Deployment deploy key, like `prod:happy-animal-123|<stuff>`\n  deployKey: string,\n) {\n  const data = (await bigBrainAPI({\n    ctx,\n    method: \"POST\",\n    path: `deployment/team_and_project_for_key`,\n    data: {\n      deployKey: deployKey,\n    },\n  })) as {\n    team: string; // slug\n    project: string; // slug\n    teamId: number;\n    projectId: number;\n    reference: string | null;\n    isDefault: boolean;\n  };\n\n  const { team, project } = data;\n  if (team === undefined || project === undefined) {\n    const msg =\n      \"Unknown error when fetching team and project: \" + JSON.stringify(data);\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"transient\",\n      errForSentry: new Error(msg),\n      printedMessage: msg,\n    });\n  }\n\n  return data;\n}\n\nexport async function getTeamsForUser(ctx: Context) {\n  const teams = await bigBrainAPI<{ id: number; name: string; slug: string }[]>(\n    {\n      ctx,\n      method: \"GET\",\n      path: \"teams\",\n    },\n  );\n  return teams;\n}\n\nasync function resolveDefaultCloudDevDeploymentName(\n  ctx: Context,\n  teamSlug: string,\n  projectSlug: string,\n): Promise<string> {\n  try {\n    const result = await typedPlatformClient(ctx, { throw: true }).GET(\n      \"/teams/{team_id_or_slug}/projects/{project_slug}/deployment\",\n      {\n        params: {\n          path: { team_id_or_slug: teamSlug, project_slug: projectSlug },\n          query: { defaultDev: true },\n        },\n      },\n    );\n    return result.data!.name;\n  } catch (err) {\n    if (\n      err instanceof ThrowingFetchError &&\n      err.serverErrorData?.code === \"DeploymentNotFound\"\n    ) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: `You don\u2019t have a personal cloud dev deployment in this project. Run ${chalkStderr.bold(\"npx convex deployment create --type dev --default\")} to create one.`,\n        errForSentry: err,\n      });\n    }\n    return await logAndHandleFetchError(ctx, err);\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { Context } from \"../../bundler/context.js\";\nimport { logVerbose, logWarning } from \"../../bundler/log.js\";\nimport { getTeamAndProjectFromPreviewAdminKey } from \"./deployment.js\";\nimport {\n  assertLocalBackendRunning,\n  localDeploymentUrl,\n} from \"./localDeployment/run.js\";\nimport {\n  ThrowingFetchError,\n  bigBrainAPI,\n  bigBrainAPIMaybeThrows,\n  logAndHandleFetchError,\n  typedPlatformClient,\n} from \"./utils/utils.js\";\nimport { z } from \"zod\";\nimport {\n  DeploymentSelection,\n  ProjectSelection,\n} from \"./deploymentSelection.js\";\nimport { loadLocalDeploymentCredentials } from \"./localDeployment/localDeployment.js\";\nimport { loadAnonymousDeployment } from \"./localDeployment/anonymous.js\";\nimport {\n  parseDeploymentSelector,\n  InProjectSelector,\n} from \"./deploymentSelector.js\";\nimport { loadProjectLocalConfig } from \"./localDeployment/filePaths.js\";\nimport { chalkStderr } from \"chalk\";\nimport { RegionName } from \"../generatedApi.js\";\nimport type { RegionName as PublishedRegionName } from \"@convex-dev/platform/managementApi\";\nexport type DeploymentName = string;\nexport type CloudDeploymentType = \"prod\" | \"dev\" | \"preview\" | \"custom\";\nexport type AccountRequiredDeploymentType = CloudDeploymentType | \"local\";\nexport type DeploymentType = AccountRequiredDeploymentType | \"anonymous\";\n\nexport type Project = {\n  id: number;\n  name: string;\n  slug: string;\n};\n\ntype AdminKey = string;\n\n/**\n * Create a new project. If `deploymentToProvision` is specified, also provision a deployment for the project.\n */\nexport async function createProject(\n  ctx: Context,\n  {\n    teamId,\n    projectName,\n    deploymentToProvision,\n  }: {\n    teamId: number;\n    projectName: string;\n    deploymentToProvision: {\n      deploymentType: \"prod\" | \"dev\";\n      region: RegionName | null;\n    } | null;\n  },\n): Promise<{\n  projectSlug: string;\n}> {\n  const response = await typedPlatformClient(ctx).POST(\n    \"/teams/{team_id}/create_project\",\n    {\n      params: { path: { team_id: teamId } },\n      body: {\n        projectName,\n        deploymentType: deploymentToProvision?.deploymentType ?? null,\n        // The published platform types lag the CLI's own spec by a release,\n        // so the cast is deliberate: a new region needs no change here.\n        deploymentRegion: (deploymentToProvision?.region ??\n          null) as PublishedRegionName | null,\n      },\n    },\n  );\n  const projectSlug = response.data?.slug;\n  if (projectSlug === undefined) {\n    const error =\n      \"Unexpected response during provisioning: \" + JSON.stringify(response);\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"transient\",\n      errForSentry: error,\n      printedMessage: error,\n    });\n  }\n  return {\n    projectSlug,\n  };\n}\n\n// ----------------------------------------------------------------------\n// Helpers for `deploymentSelectionFromOptions`\n// ----------------------------------------------------------------------\n\nexport const deploymentSelectionWithinProjectSchema = z.discriminatedUnion(\n  \"kind\",\n  [\n    z.object({ kind: z.literal(\"previewName\"), previewName: z.string() }),\n    z.object({ kind: z.literal(\"deploymentName\"), deploymentName: z.string() }),\n    z.object({ kind: z.literal(\"prod\") }),\n    z.object({ kind: z.literal(\"implicitProd\") }),\n    z.object({ kind: z.literal(\"unspecified\") }),\n    z.object({\n      kind: z.literal(\"deploymentSelector\"),\n      selector: z.string(),\n    }),\n  ],\n);\n\nexport type DeploymentSelectionWithinProject = z.infer<\n  typeof deploymentSelectionWithinProjectSchema\n>;\n\ntype DeploymentSelectionOptionsWithinProject = {\n  prod?: boolean | undefined;\n  // Whether this command defaults to prod when no other flags are provided. If\n  // this is not set, the default will be \"ownDev\"\n  implicitProd?: boolean;\n\n  previewName?: string | undefined;\n  deploymentName?: string | undefined;\n  deployment?: string | undefined;\n};\n\nexport type DeploymentSelectionOptions =\n  DeploymentSelectionOptionsWithinProject & {\n    url?: string | undefined;\n    adminKey?: string | undefined;\n    envFile?: string | undefined;\n  };\n\nexport function deploymentSelectionWithinProjectFromOptions(\n  options: DeploymentSelectionOptions,\n): DeploymentSelectionWithinProject {\n  if (options.deployment !== undefined) {\n    return { kind: \"deploymentSelector\", selector: options.deployment };\n  }\n  if (options.previewName !== undefined) {\n    return { kind: \"previewName\", previewName: options.previewName };\n  }\n  if (options.deploymentName !== undefined) {\n    return { kind: \"deploymentName\", deploymentName: options.deploymentName };\n  }\n  if (options.prod) {\n    return { kind: \"prod\" };\n  }\n  if (options.implicitProd) {\n    return { kind: \"implicitProd\" };\n  }\n  return { kind: \"unspecified\" };\n}\n\nexport async function validateDeploymentSelectionForExistingDeployment(\n  ctx: Context,\n  deploymentSelection: DeploymentSelectionWithinProject,\n  source: \"selfHosted\" | \"deployKey\" | \"cliArgs\",\n) {\n  if (\n    deploymentSelection.kind === \"unspecified\" ||\n    deploymentSelection.kind === \"implicitProd\"\n  ) {\n    // These are both considered the \"default\" selection depending on the command, so this is always fine\n    return;\n  }\n  if (deploymentSelection.kind === \"deploymentSelector\") {\n    switch (source) {\n      case \"selfHosted\":\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"The `--deployment` flag cannot be used with a self-hosted deployment.\",\n        });\n      case \"deployKey\":\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"The `--deployment` flag cannot be used with CONVEX_DEPLOY_KEY.\",\n        });\n      case \"cliArgs\":\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"The `--deployment` flag cannot be used with --url and --admin-key.\",\n        });\n    }\n  }\n  switch (source) {\n    case \"selfHosted\":\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"The `--prod`, `--preview-name`, and `--deployment-name` flags cannot be used with a self-hosted deployment.\",\n      });\n    case \"deployKey\":\n      logWarning(\n        \"Ignoring `--prod`, `--preview-name`, or `--deployment-name` flags and using deployment from CONVEX_DEPLOY_KEY\",\n      );\n      break;\n    case \"cliArgs\":\n      logWarning(\n        \"Ignoring `--prod`, `--preview-name`, or `--deployment-name` flags since this command was run with --url and --admin-key\",\n      );\n      break;\n  }\n}\n\n// ----------------------------------------------------------------------\n// Helpers for `checkAccessToSelectedProject`\n// ----------------------------------------------------------------------\n\nasync function hasAccessToProject(\n  ctx: Context,\n  selector: { projectSlug: string; teamSlug: string },\n): Promise<boolean> {\n  try {\n    await typedPlatformClient(ctx, { throw: true }).GET(\n      \"/teams/{team_id_or_slug}/projects/{project_slug}\",\n      {\n        params: {\n          path: {\n            team_id_or_slug: selector.teamSlug,\n            project_slug: selector.projectSlug,\n          },\n        },\n      },\n    );\n    return true;\n  } catch (err) {\n    if (\n      err instanceof ThrowingFetchError &&\n      (err.serverErrorData?.code === \"TeamNotFound\" ||\n        err.serverErrorData?.code === \"ProjectNotFound\")\n    ) {\n      return false;\n    }\n    return logAndHandleFetchError(ctx, err);\n  }\n}\n\nexport async function checkAccessToSelectedProject(\n  ctx: Context,\n  projectSelection: ProjectSelection,\n): Promise<\n  | { kind: \"hasAccess\"; teamSlug: string; projectSlug: string }\n  | { kind: \"noAccess\" }\n  | { kind: \"unknown\" }\n> {\n  switch (projectSelection.kind) {\n    case \"deploymentName\": {\n      const result = await getTeamAndProjectSlugForDeployment(ctx, {\n        deploymentName: projectSelection.deploymentName,\n      });\n      if (result === null) {\n        return { kind: \"noAccess\" };\n      }\n      return {\n        kind: \"hasAccess\",\n        teamSlug: result.teamSlug,\n        projectSlug: result.projectSlug,\n      };\n    }\n    case \"teamAndProjectSlugs\": {\n      const hasAccess = await hasAccessToProject(ctx, {\n        teamSlug: projectSelection.teamSlug,\n        projectSlug: projectSelection.projectSlug,\n      });\n      if (!hasAccess) {\n        return { kind: \"noAccess\" };\n      }\n      return {\n        kind: \"hasAccess\",\n        teamSlug: projectSelection.teamSlug,\n        projectSlug: projectSelection.projectSlug,\n      };\n    }\n    case \"projectDeployKey\":\n      // Ideally we would be able to do an explicit check here, but if the key is invalid,\n      // it will instead fail as soon as we try to use the key.\n      return { kind: \"unknown\" };\n    default: {\n      projectSelection satisfies never;\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: `Invalid project selection: ${(projectSelection as any).kind}`,\n      });\n    }\n  }\n}\n\nexport async function getTeamAndProjectSlugForDeployment(\n  ctx: Context,\n  selector: { deploymentName: string },\n): Promise<{ teamSlug: string; projectSlug: string } | null> {\n  try {\n    const body = await bigBrainAPIMaybeThrows({\n      ctx,\n      path: `deployment/${selector.deploymentName}/team_and_project`,\n      method: \"GET\",\n    });\n    return { teamSlug: body.team, projectSlug: body.project };\n  } catch (err) {\n    if (\n      err instanceof ThrowingFetchError &&\n      (err.serverErrorData?.code === \"DeploymentNotFound\" ||\n        err.serverErrorData?.code === \"ProjectNotFound\")\n    ) {\n      return null;\n    }\n    return logAndHandleFetchError(ctx, err);\n  }\n}\n\n// ----------------------------------------------------------------------\n// Helpers for fetching deployment credentials\n// ----------------------------------------------------------------------\n\n// Used by dev for upgrade from team and project in convex.json to CONVEX_DEPLOYMENT\nexport async function fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows(\n  ctx: Context,\n  projectSelection:\n    | { kind: \"teamAndProjectSlugs\"; teamSlug: string; projectSlug: string }\n    | { kind: \"projectDeployKey\"; projectDeployKey: string },\n  deploymentType: \"prod\" | \"dev\",\n): Promise<{\n  deploymentName: string;\n  deploymentUrl: string;\n  adminKey: AdminKey;\n  reference: string;\n  isDefault: boolean;\n}> {\n  if (projectSelection.kind === \"projectDeployKey\") {\n    const auth = ctx.bigBrainAuth();\n    const doesAuthMatch =\n      auth !== null &&\n      auth.kind === \"projectKey\" &&\n      auth.projectKey === projectSelection.projectDeployKey;\n    if (!doesAuthMatch) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        errForSentry: new Error(\n          \"Expected project deploy key to match the big brain auth header\",\n        ),\n        printedMessage: \"Unexpected error when loading the Convex deployment\",\n      });\n    }\n  }\n  let data;\n  try {\n    data = await bigBrainAPIMaybeThrows({\n      ctx,\n      method: \"POST\",\n      path: \"deployment/provision_and_authorize\",\n      data: {\n        teamSlug:\n          projectSelection.kind === \"teamAndProjectSlugs\"\n            ? projectSelection.teamSlug\n            : null,\n        projectSlug:\n          projectSelection.kind === \"teamAndProjectSlugs\"\n            ? projectSelection.projectSlug\n            : null,\n        deploymentType: deploymentType === \"prod\" ? \"prod\" : \"dev\",\n      },\n    });\n  } catch (error) {\n    const msg = \"Unknown error during authorization: \" + error;\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"transient\",\n      errForSentry: new Error(msg),\n      printedMessage: msg,\n    });\n  }\n  const { adminKey, url, deploymentName, reference, isDefault } = data;\n  if (adminKey === undefined || url === undefined) {\n    const msg = \"Unknown error during authorization: \" + JSON.stringify(data);\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"transient\",\n      errForSentry: new Error(msg),\n      printedMessage: msg,\n    });\n  }\n  return { adminKey, deploymentUrl: url, deploymentName, reference, isDefault };\n}\n\nasync function fetchExistingDevDeploymentCredentialsOrCrash(\n  ctx: Context,\n  deploymentName: DeploymentName,\n): Promise<DeploymentAuthResponse> {\n  const slugs = await fetchTeamAndProject(ctx, deploymentName);\n  const credentials =\n    await fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows(\n      ctx,\n      {\n        kind: \"teamAndProjectSlugs\",\n        teamSlug: slugs.team,\n        projectSlug: slugs.project,\n      },\n      \"dev\",\n    );\n  return {\n    deploymentName: credentials.deploymentName,\n    adminKey: credentials.adminKey,\n    url: credentials.deploymentUrl,\n    deploymentType: \"dev\",\n    reference: credentials.reference,\n    isDefault: credentials.isDefault,\n  };\n}\n\n// ----------------------------------------------------------------------\n// Helpers for `loadSelectedDeploymentCredentials`\n// ----------------------------------------------------------------------\n\ntype DeploymentAuthResponse = {\n  deploymentName: string;\n  adminKey: string;\n  url: string;\n  deploymentType: DeploymentType;\n  reference: string | null; // null = local deployment\n  isDefault: boolean;\n};\n\n// Returns the user's own dev deployment, which may be a local deployment\n// if one is configured. Used for dev commands (including `npx convex dev`)\n// when no specific deployment is specified.\nasync function handleOwnDev(\n  ctx: Context,\n  projectSelection: ProjectSelection,\n): Promise<DeploymentAuthResponse> {\n  switch (projectSelection.kind) {\n    case \"deploymentName\": {\n      if (projectSelection.deploymentType === \"local\") {\n        const credentials = await loadLocalDeploymentCredentials(\n          ctx,\n          projectSelection.deploymentName,\n        );\n        return {\n          deploymentName: projectSelection.deploymentName,\n          adminKey: credentials.adminKey,\n          url: credentials.deploymentUrl,\n          deploymentType: \"local\",\n          reference: null,\n          isDefault: false,\n        };\n      }\n      return await fetchExistingDevDeploymentCredentialsOrCrash(\n        ctx,\n        projectSelection.deploymentName,\n      );\n    }\n    case \"teamAndProjectSlugs\":\n    case \"projectDeployKey\": {\n      // Note -- this provisions a dev deployment if one doesn't exist\n      const credentials =\n        await fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows(\n          ctx,\n          projectSelection,\n          \"dev\",\n        );\n      return {\n        url: credentials.deploymentUrl,\n        adminKey: credentials.adminKey,\n        deploymentName: credentials.deploymentName,\n        deploymentType: \"dev\",\n        reference: credentials.reference,\n        isDefault: credentials.isDefault,\n      };\n    }\n    default: {\n      projectSelection satisfies never;\n      return ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        // This should be unreachable, so don't bother with a printed message.\n        printedMessage: null,\n        errForSentry: `Unexpected project selection: ${(projectSelection as any).kind}`,\n      });\n    }\n  }\n}\n\nasync function handleProd(\n  ctx: Context,\n  projectSelection: ProjectSelection,\n): Promise<DeploymentAuthResponse & { deploymentType: \"prod\" }> {\n  switch (projectSelection.kind) {\n    case \"deploymentName\": {\n      const credentials = await bigBrainAPI({\n        ctx,\n        method: \"POST\",\n        path: \"deployment/authorize_prod\",\n        data: {\n          deploymentName: projectSelection.deploymentName,\n        },\n      });\n      return credentials;\n    }\n    case \"teamAndProjectSlugs\":\n    case \"projectDeployKey\": {\n      const credentials =\n        await fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows(\n          ctx,\n          projectSelection,\n          \"prod\",\n        );\n      return {\n        url: credentials.deploymentUrl,\n        adminKey: credentials.adminKey,\n        deploymentName: credentials.deploymentName,\n        deploymentType: \"prod\",\n        reference: credentials.reference,\n        isDefault: credentials.isDefault,\n      };\n    }\n  }\n}\n\nasync function handlePreview(\n  ctx: Context,\n  previewName: string,\n  projectSelection: ProjectSelection,\n): Promise<DeploymentAuthResponse & { deploymentType: \"preview\" }> {\n  switch (projectSelection.kind) {\n    case \"deploymentName\":\n    case \"teamAndProjectSlugs\": {\n      const credentials = await bigBrainAPI({\n        ctx,\n        method: \"POST\",\n        path: \"deployment/authorize_preview\",\n        data: {\n          previewName: previewName,\n          projectSelection: projectSelection,\n        },\n      });\n      return credentials;\n    }\n\n    case \"projectDeployKey\":\n      // TODO -- this should be supported\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"Project deploy keys are not supported for preview deployments\",\n      });\n  }\n}\n\nasync function handleDeploymentName(\n  ctx: Context,\n  deploymentName: string,\n  projectSelection: ProjectSelection,\n): Promise<DeploymentAuthResponse> {\n  switch (projectSelection.kind) {\n    case \"deploymentName\":\n    case \"teamAndProjectSlugs\": {\n      const credentials = await bigBrainAPI({\n        ctx,\n        method: \"POST\",\n        path: \"deployment/authorize_within_current_project\",\n        data: {\n          selectedDeploymentName: deploymentName,\n          projectSelection: projectSelection,\n        },\n      });\n      return credentials;\n    }\n    case \"projectDeployKey\":\n      // TODO -- this should be supported\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"Project deploy keys are not supported with the --deployment-name flag\",\n      });\n  }\n}\n\nasync function fetchDeploymentCredentialsWithinCurrentProject(\n  ctx: Context,\n  projectSelection: ProjectSelection,\n  deploymentSelection: DeploymentSelectionWithinProject,\n): Promise<DeploymentAuthResponse> {\n  switch (deploymentSelection.kind) {\n    case \"unspecified\": {\n      // default to the user's default dev deployment\n      // TODO: this currently also handles local dev, but that should probably be split out into a different DeploymenSelection kind\n      return await handleOwnDev(ctx, projectSelection);\n    }\n    case \"implicitProd\":\n    case \"prod\": {\n      return await handleProd(ctx, projectSelection);\n    }\n    case \"previewName\":\n      return await handlePreview(\n        ctx,\n        deploymentSelection.previewName,\n        projectSelection,\n      );\n    case \"deploymentName\":\n      return await handleDeploymentName(\n        ctx,\n        deploymentSelection.deploymentName,\n        projectSelection,\n      );\n    case \"deploymentSelector\":\n      return await handleDeploymentSelector(\n        ctx,\n        deploymentSelection.selector,\n        projectSelection,\n      );\n    default: {\n      deploymentSelection satisfies never;\n      return ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        // This should be unreachable, so don't bother with a printed message.\n        printedMessage: null,\n        errForSentry: `Unexpected deployment selection: ${deploymentSelection as any}`,\n      });\n    }\n  }\n}\n\nasync function resolveDeploymentNameByReference(\n  ctx: Context,\n  teamSlug: string,\n  projectSlug: string,\n  reference: string,\n): Promise<string> {\n  try {\n    const result = await typedPlatformClient(ctx, { throw: true }).GET(\n      \"/teams/{team_id_or_slug}/projects/{project_slug}/deployment\",\n      {\n        params: {\n          path: { team_id_or_slug: teamSlug, project_slug: projectSlug },\n          query: { reference },\n        },\n      },\n    );\n\n    return result.data!.name;\n  } catch (err) {\n    if (\n      err instanceof ThrowingFetchError &&\n      err.serverErrorData?.code === \"DeploymentNotFound\"\n    ) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: `Deployment \u201C${reference}\u201D not found. To create a new deployment, use ${chalkStderr.bold(`npx convex deployment create ${teamSlug}:${projectSlug}:${reference} --select`)}`,\n        errForSentry: err,\n      });\n    }\n    return await logAndHandleFetchError(ctx, err);\n  }\n}\n\nasync function handleRefInProject(\n  ctx: Context,\n  selector: InProjectSelector,\n  projectSelection: ProjectSelection,\n): Promise<DeploymentAuthResponse> {\n  switch (selector.kind) {\n    case \"local\": {\n      // The mismatch check for `[team:project:]local` has already happened in\n      // `_getDeploymentSelection`, so we only need to load credentials here.\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      const credentials = await loadLocalDeploymentCredentials(\n        ctx,\n        localConfig.deploymentName,\n      );\n      return {\n        deploymentName: localConfig.deploymentName,\n        adminKey: credentials.adminKey,\n        url: credentials.deploymentUrl,\n        deploymentType: \"local\",\n        reference: null,\n        isDefault: false,\n      };\n    }\n    case \"dev\": {\n      const access = await checkAccessToSelectedProject(ctx, projectSelection);\n      if (access.kind !== \"hasAccess\") {\n        return await 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      const deploymentName = await resolveDefaultCloudDevDeploymentName(\n        ctx,\n        access.teamSlug,\n        access.projectSlug,\n      );\n      // Pass teamAndProjectSlugs instead of the original projectSelection,\n      // because handleDeploymentName sends projectSelection to Big Brain's\n      // authorize_within_current_project endpoint, which doesn't understand\n      // deploymentType \"local\".\n      return await handleDeploymentName(ctx, deploymentName, {\n        kind: \"teamAndProjectSlugs\",\n        teamSlug: access.teamSlug,\n        projectSlug: access.projectSlug,\n      });\n    }\n    case \"prod\":\n      return await handleProd(ctx, projectSelection);\n    case \"reference\": {\n      const access = await checkAccessToSelectedProject(ctx, projectSelection);\n      if (access.kind !== \"hasAccess\") {\n        return await 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      const deploymentName = await resolveDeploymentNameByReference(\n        ctx,\n        access.teamSlug,\n        access.projectSlug,\n        selector.reference,\n      );\n      return await handleDeploymentName(ctx, deploymentName, projectSelection);\n    }\n  }\n}\n\nasync function handleDeploymentSelector(\n  ctx: Context,\n  selector: string,\n  projectSelection: ProjectSelection,\n): Promise<DeploymentAuthResponse> {\n  const parsed = parseDeploymentSelector(selector);\n  switch (parsed.kind) {\n    case \"deploymentName\":\n      return await handleDeploymentName(\n        ctx,\n        parsed.deploymentName,\n        projectSelection,\n      );\n    case \"inCurrentProject\":\n      return await handleRefInProject(ctx, parsed.selector, projectSelection);\n    case \"inProject\": {\n      const access = await checkAccessToSelectedProject(ctx, projectSelection);\n      if (access.kind !== \"hasAccess\") {\n        return await 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 handleRefInProject(ctx, parsed.selector, {\n        kind: \"teamAndProjectSlugs\",\n        teamSlug: access.teamSlug,\n        projectSlug: parsed.projectSlug,\n      });\n    }\n    case \"inTeamProject\":\n      return await handleRefInProject(ctx, parsed.selector, {\n        kind: \"teamAndProjectSlugs\",\n        teamSlug: parsed.teamSlug,\n        projectSlug: parsed.projectSlug,\n      });\n  }\n}\n\nasync function _loadExistingDeploymentCredentialsForProject(\n  ctx: Context,\n  targetProject: ProjectSelection,\n  deploymentSelection: DeploymentSelectionWithinProject,\n  { ensureLocalRunning } = { ensureLocalRunning: true },\n): Promise<DetailedDeploymentCredentials> {\n  const accessResult = await checkAccessToSelectedProject(ctx, targetProject);\n  if (accessResult.kind === \"noAccess\") {\n    return await 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  const result = await fetchDeploymentCredentialsWithinCurrentProject(\n    ctx,\n    targetProject,\n    deploymentSelection,\n  );\n  logVerbose(\n    `Deployment URL: ${result.url}, Deployment Name: ${result.deploymentName}, Deployment Type: ${result.deploymentType}`,\n  );\n  if (ensureLocalRunning && result.deploymentType === \"local\") {\n    await assertLocalBackendRunning(ctx, {\n      url: result.url,\n      deploymentName: result.deploymentName,\n    });\n  }\n  return {\n    ...result,\n    deploymentFields: {\n      deploymentName: result.deploymentName,\n      deploymentType: result.deploymentType,\n      reference: result.reference,\n      isDefault: result.isDefault,\n      projectSlug:\n        accessResult.kind === \"hasAccess\" ? accessResult.projectSlug : null,\n      teamSlug:\n        accessResult.kind === \"hasAccess\" ? accessResult.teamSlug : null,\n    },\n  };\n}\n\nexport type DetailedDeploymentCredentials = {\n  adminKey: string;\n  url: string;\n  deploymentFields: {\n    deploymentName: string;\n    deploymentType: DeploymentType;\n    projectSlug: string | null;\n    teamSlug: string | null;\n    reference: string | null;\n    isDefault: boolean;\n  } | null;\n};\n\n/**\n * This is used by most commands to determine which deployment to act on, taking into account the deployment selection flags.\n */\nexport async function loadSelectedDeploymentCredentials(\n  ctx: Context,\n  deploymentSelection: DeploymentSelection,\n  { ensureLocalRunning } = { ensureLocalRunning: true },\n): Promise<DetailedDeploymentCredentials> {\n  switch (deploymentSelection.kind) {\n    case \"existingDeployment\":\n      // We're already set up.\n      logVerbose(\n        `Deployment URL: ${deploymentSelection.deploymentToActOn.url}, Deployment Name: ${deploymentSelection.deploymentToActOn.deploymentFields?.deploymentName ?? \"unknown\"}, Deployment Type: ${deploymentSelection.deploymentToActOn.deploymentFields?.deploymentType ?? \"unknown\"}`,\n      );\n      return {\n        adminKey: deploymentSelection.deploymentToActOn.adminKey,\n        url: deploymentSelection.deploymentToActOn.url,\n        deploymentFields:\n          deploymentSelection.deploymentToActOn.deploymentFields,\n      };\n    case \"chooseProject\":\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"No CONVEX_DEPLOYMENT set, run `npx convex dev` to configure a Convex project\",\n      });\n    case \"preview\": {\n      const slugs = await getTeamAndProjectFromPreviewAdminKey(\n        ctx,\n        deploymentSelection.previewDeployKey,\n      );\n      return await _loadExistingDeploymentCredentialsForProject(\n        ctx,\n        {\n          kind: \"teamAndProjectSlugs\",\n          teamSlug: slugs.teamSlug,\n          projectSlug: slugs.projectSlug,\n        },\n        // Note that the user could select a non-preview deployment here, and it would succeed if the user is logged in locally because getBigBrainAuth prefers the user's access token over the preview deploy key.\n        deploymentSelection.selectionWithinProject,\n        { ensureLocalRunning },\n      );\n    }\n    case \"deploymentWithinProject\": {\n      return await _loadExistingDeploymentCredentialsForProject(\n        ctx,\n        deploymentSelection.targetProject,\n        deploymentSelection.selectionWithinProject,\n        { ensureLocalRunning },\n      );\n    }\n    case \"anonymous\": {\n      if (deploymentSelection.deploymentName === null) {\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"No CONVEX_DEPLOYMENT set, run `npx convex dev` to configure a Convex project\",\n        });\n      }\n      const config = await loadAnonymousDeployment(\n        ctx,\n        deploymentSelection.deploymentName,\n      );\n      const url = localDeploymentUrl(config.ports.cloud);\n      if (ensureLocalRunning) {\n        await assertLocalBackendRunning(ctx, {\n          url,\n          deploymentName: deploymentSelection.deploymentName,\n        });\n      }\n      return {\n        adminKey: config.adminKey,\n        url,\n        deploymentFields: {\n          deploymentName: deploymentSelection.deploymentName,\n          deploymentType: \"anonymous\",\n          projectSlug: null,\n          teamSlug: null,\n          reference: null,\n          isDefault: false,\n        },\n      };\n    }\n    default: {\n      deploymentSelection satisfies never;\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: \"Unknown deployment type\",\n      });\n    }\n  }\n}\n\nexport async function fetchTeamAndProject(\n  ctx: Context,\n  deploymentName: string,\n) {\n  const data = (await bigBrainAPI({\n    ctx,\n    method: \"GET\",\n    path: `deployment/${deploymentName}/team_and_project`,\n  })) as {\n    team: string; // slug\n    project: string; // slug\n    teamId: number;\n    projectId: number;\n  };\n\n  const { team, project } = data;\n  if (team === undefined || project === undefined) {\n    const msg =\n      \"Unknown error when fetching team and project: \" + JSON.stringify(data);\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"transient\",\n      errForSentry: new Error(msg),\n      printedMessage: msg,\n    });\n  }\n\n  return data;\n}\n\nexport async function fetchTeamAndProjectForKey(\n  ctx: Context,\n  // Deployment deploy key, like `prod:happy-animal-123|<stuff>`\n  deployKey: string,\n) {\n  const data = (await bigBrainAPI({\n    ctx,\n    method: \"POST\",\n    path: `deployment/team_and_project_for_key`,\n    data: {\n      deployKey: deployKey,\n    },\n  })) as {\n    team: string; // slug\n    project: string; // slug\n    teamId: number;\n    projectId: number;\n    reference: string | null;\n    isDefault: boolean;\n  };\n\n  const { team, project } = data;\n  if (team === undefined || project === undefined) {\n    const msg =\n      \"Unknown error when fetching team and project: \" + JSON.stringify(data);\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"transient\",\n      errForSentry: new Error(msg),\n      printedMessage: msg,\n    });\n  }\n\n  return data;\n}\n\nexport async function getTeamsForUser(ctx: Context) {\n  const teams = await bigBrainAPI<{ id: number; name: string; slug: string }[]>(\n    {\n      ctx,\n      method: \"GET\",\n      path: \"teams\",\n    },\n  );\n  return teams;\n}\n\nasync function resolveDefaultCloudDevDeploymentName(\n  ctx: Context,\n  teamSlug: string,\n  projectSlug: string,\n): Promise<string> {\n  try {\n    const result = await typedPlatformClient(ctx, { throw: true }).GET(\n      \"/teams/{team_id_or_slug}/projects/{project_slug}/deployment\",\n      {\n        params: {\n          path: { team_id_or_slug: teamSlug, project_slug: projectSlug },\n          query: { defaultDev: true },\n        },\n      },\n    );\n    return result.data!.name;\n  } catch (err) {\n    if (\n      err instanceof ThrowingFetchError &&\n      err.serverErrorData?.code === \"DeploymentNotFound\"\n    ) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: `You don\u2019t have a personal cloud dev deployment in this project. Run ${chalkStderr.bold(\"npx convex deployment create --type dev --default\")} to create one.`,\n        errForSentry: err,\n      });\n    }\n    return await logAndHandleFetchError(ctx, err);\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/cli/lib/checkForLargeIndexBackfill.js

@@ -0,0 +1,113 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var checkForLargeIndexBackfill_exports = {};
+__export(checkForLargeIndexBackfill_exports, {
+  blockingIndexesFromSchemaEvaluation: () => blockingIndexesFromSchemaEvaluation,
+  checkForLargeIndexBackfill: () => checkForLargeIndexBackfill
+});
+module.exports = __toCommonJS(checkForLargeIndexBackfill_exports);
+var import_chalk = require("chalk");
+var import_log = require("../../bundler/log.js");
+var import_indexes = require("./indexes.js");
+var import_prompts = require("./utils/prompts.js");
+var import_utils = require("./utils/utils.js");
+const MIN_DOCUMENTS_FOR_INDEX_BACKFILL_WARNING = 1e5;
+async function checkForLargeIndexBackfill({
+  ctx,
+  span,
+  schemaEvaluation,
+  options,
+  mode
+}) {
+  (0, import_log.changeSpinner)("Verifying that the push isn\u2019t creating large indexes...");
+  const response = await schemaEvaluation(span);
+  if (response === null) {
+    return;
+  }
+  const blockingIndexes = blockingIndexesFromSchemaEvaluation(
+    response,
+    minDocumentsForIndexBackfillWarning()
+  );
+  if (blockingIndexes.length === 0) {
+    return;
+  }
+  const plural = blockingIndexes.length !== 1;
+  (0, import_log.logMessage)(`\u26A0\uFE0F  This push will ${import_chalk.chalkStderr.bold("create")} the following ${plural ? "indexes on large tables" : "index on a large table"}
+in your deployment (${options.url}). The deploy will block until ${plural ? "they finish" : "it finishes"} backfilling:
+
+${blockingIndexes.map(formatBlockingIndex).join("\n")}
+
+Tip: stage the index (e.g. \`.index("by_field", { fields: ["field"], staged: true })\`) to backfill
+it in the background without blocking the deploy, then remove \`staged\` in a later push once it\u2019s ready.
+Learn more at https://docs.convex.dev/database/reading-data/indexes#staged-indexes
+`);
+  if (mode === "warn") {
+    return;
+  }
+  if (mode === "has confirmation") {
+    (0, import_log.logFinishedStep)(
+      "Proceeding with push since --skip-large-indexes-check is set"
+    );
+    return;
+  }
+  if (!process.stdin.isTTY) {
+    return ctx.crash({
+      exitCode: 1,
+      errorType: "fatal",
+      printedMessage: `To confirm the push:
+\u2022 run the deploy command in an ${import_chalk.chalkStderr.bold("interactive terminal")}
+\u2022 or run the deploy command with the ${import_chalk.chalkStderr.bold("--skip-large-indexes-check")} flag`
+    });
+  }
+  (0, import_log.stopSpinner)();
+  if (!await (0, import_prompts.promptYesNo)(ctx, {
+    message: `Create ${plural ? "these indexes" : "this index"} now?`,
+    default: false
+  })) {
+    return ctx.crash({
+      exitCode: 1,
+      errorType: "fatal",
+      printedMessage: `Canceling push`
+    });
+  }
+  (0, import_log.logFinishedStep)("Proceeding with push.");
+}
+function blockingIndexesFromSchemaEvaluation(response, minDocuments) {
+  return Object.entries(response.componentSchemaEvaluations).flatMap(
+    ([componentPath, prediction]) => prediction.indexes.filter(
+      (index) => index.needsBackfill && !index.staged && (index.change === "added" || index.change === "enabled") && index.numDocs >= minDocuments
+    ).map((index) => ({ componentPath, index }))
+  );
+}
+function formatBlockingIndex({ componentPath, index }) {
+  const componentNameFormatted = componentPath !== "" ? `${import_chalk.chalkStderr.gray(componentPath)}:` : "";
+  const documentsCountFormatted = import_chalk.chalkStderr.yellowBright(
+    `\u26A0\uFE0F  ${index.numDocs.toLocaleString()} documents`
+  );
+  const enabledNote = index.change === "enabled" ? `
+   ${import_chalk.chalkStderr.gray("enabled before its staged backfill finished")}` : "";
+  return "\u26D4 " + componentNameFormatted + (0, import_indexes.formatIndex)(index) + "  " + documentsCountFormatted + enabledNote;
+}
+function minDocumentsForIndexBackfillWarning() {
+  return (0, import_utils.integerFromEnv)(
+    "CONVEX_MIN_DOCUMENTS_FOR_INDEX_BACKFILL_WARNING",
+    MIN_DOCUMENTS_FOR_INDEX_BACKFILL_WARNING
+  );
+}
+//# sourceMappingURL=checkForLargeIndexBackfill.js.map

package/dist/cjs/cli/lib/checkForLargeIndexBackfill.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cli/lib/checkForLargeIndexBackfill.ts"],
+  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { Context } from \"../../bundler/context.js\";\nimport {\n  changeSpinner,\n  logFinishedStep,\n  logMessage,\n  stopSpinner,\n} from \"../../bundler/log.js\";\nimport { formatIndex } from \"./indexes.js\";\nimport { promptYesNo } from \"./utils/prompts.js\";\nimport { Span } from \"./tracing.js\";\nimport {\n  EvaluateSchemaResponse,\n  IndexPrediction,\n} from \"./deployApi/evaluateSchema.js\";\nimport { SchemaEvaluation } from \"./schemaEvaluation.js\";\nimport { integerFromEnv } from \"./utils/utils.js\";\n\n// Same size as the large index deletion check, so both index guards fire at\n// the same table size. Separate env override so tests can trigger one\n// without the other.\nconst MIN_DOCUMENTS_FOR_INDEX_BACKFILL_WARNING = 100_000;\n\nexport type LargeIndexBackfillCheck =\n  // Don\u2019t check whether the push creates indexes on large tables\n  | \"no verification\"\n  // If it does, ask for confirmation (and fail in non-interactive envs)\n  | \"ask for confirmation\"\n  // If it does, proceed (the user has used --skip-large-indexes-check)\n  | \"has confirmation\";\n\ntype BlockingIndex = {\n  // The component instance path (\"\" for the root component), matching the\n  // keys of `componentSchemaEvaluations`.\n  componentPath: string;\n  index: IndexPrediction;\n};\n\n/**\n * Warn \u2014 and on a real deploy require confirmation \u2014 when a push creates or\n * enables a non-staged index on a large table. `wait_for_schema` blocks the\n * deploy until every such index is backfilled, which can take a long time on\n * large tables; staging the index instead backfills it in the background.\n *\n * Skipped silently when the deployment doesn't support `evaluate_schema`:\n * the check protects the developer's time, not correctness.\n */\nexport async function checkForLargeIndexBackfill({\n  ctx,\n  span,\n  schemaEvaluation,\n  options,\n  mode,\n}: {\n  ctx: Context;\n  span: Span;\n  schemaEvaluation: SchemaEvaluation;\n  options: { url: string };\n  // \"warn\" prints the warning without prompting, for dry runs.\n  mode: \"warn\" | \"ask for confirmation\" | \"has confirmation\";\n}): Promise<void> {\n  changeSpinner(\"Verifying that the push isn\u2019t creating large indexes...\");\n  const response = await schemaEvaluation(span);\n  if (response === null) {\n    return;\n  }\n\n  const blockingIndexes = blockingIndexesFromSchemaEvaluation(\n    response,\n    minDocumentsForIndexBackfillWarning(),\n  );\n  if (blockingIndexes.length === 0) {\n    return;\n  }\n\n  const plural = blockingIndexes.length !== 1;\n  logMessage(`\u26A0\uFE0F  This push will ${chalkStderr.bold(\"create\")} the following ${plural ? \"indexes on large tables\" : \"index on a large table\"}\nin your deployment (${options.url}). The deploy will block until ${plural ? \"they finish\" : \"it finishes\"} backfilling:\n\n${blockingIndexes.map(formatBlockingIndex).join(\"\\n\")}\n\nTip: stage the index (e.g. \\`.index(\"by_field\", { fields: [\"field\"], staged: true })\\`) to backfill\nit in the background without blocking the deploy, then remove \\`staged\\` in a later push once it\u2019s ready.\nLearn more at https://docs.convex.dev/database/reading-data/indexes#staged-indexes\n`);\n\n  if (mode === \"warn\") {\n    return;\n  }\n\n  if (mode === \"has confirmation\") {\n    logFinishedStep(\n      \"Proceeding with push since --skip-large-indexes-check is set\",\n    );\n    return;\n  }\n\n  if (!process.stdin.isTTY) {\n    return ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `To confirm the push:\n\u2022 run the deploy command in an ${chalkStderr.bold(\"interactive terminal\")}\n\u2022 or run the deploy command with the ${chalkStderr.bold(\"--skip-large-indexes-check\")} flag`,\n    });\n  }\n\n  stopSpinner();\n  if (\n    !(await promptYesNo(ctx, {\n      message: `Create ${plural ? \"these indexes\" : \"this index\"} now?`,\n      default: false,\n    }))\n  ) {\n    return ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `Canceling push`,\n    });\n  }\n\n  logFinishedStep(\"Proceeding with push.\");\n}\n\n// An index blocks the deploy when this push starts (`added`) or waits on\n// (`enabled` before its staged backfill finished) a backfill that isn't\n// staged. Added staged indexes report `needsBackfill` too but never block,\n// and an in-progress backfill an earlier push started (`identical`) isn't\n// this push's doing.\nexport function blockingIndexesFromSchemaEvaluation(\n  response: EvaluateSchemaResponse,\n  minDocuments: number,\n): BlockingIndex[] {\n  return Object.entries(response.componentSchemaEvaluations).flatMap(\n    ([componentPath, prediction]) =>\n      prediction.indexes\n        .filter(\n          (index) =>\n            index.needsBackfill &&\n            !index.staged &&\n            (index.change === \"added\" || index.change === \"enabled\") &&\n            index.numDocs >= minDocuments,\n        )\n        .map((index) => ({ componentPath, index })),\n  );\n}\n\nfunction formatBlockingIndex({ componentPath, index }: BlockingIndex) {\n  const componentNameFormatted =\n    componentPath !== \"\" ? `${chalkStderr.gray(componentPath)}:` : \"\";\n  const documentsCountFormatted = chalkStderr.yellowBright(\n    `\u26A0\uFE0F  ${index.numDocs.toLocaleString()} documents`,\n  );\n  const enabledNote =\n    index.change === \"enabled\"\n      ? `\\n   ${chalkStderr.gray(\"enabled before its staged backfill finished\")}`\n      : \"\";\n  return (\n    \"\u26D4 \" +\n    componentNameFormatted +\n    formatIndex(index) +\n    \"  \" +\n    documentsCountFormatted +\n    enabledNote\n  );\n}\n\nfunction minDocumentsForIndexBackfillWarning(): number {\n  return integerFromEnv(\n    \"CONVEX_MIN_DOCUMENTS_FOR_INDEX_BACKFILL_WARNING\",\n    MIN_DOCUMENTS_FOR_INDEX_BACKFILL_WARNING,\n  );\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA4B;AAE5B,iBAKO;AACP,qBAA4B;AAC5B,qBAA4B;AAO5B,mBAA+B;AAK/B,MAAM,2CAA2C;AA0BjD,eAAsB,2BAA2B;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAOkB;AAChB,gCAAc,8DAAyD;AACvE,QAAM,WAAW,MAAM,iBAAiB,IAAI;AAC5C,MAAI,aAAa,MAAM;AACrB;AAAA,EACF;AAEA,QAAM,kBAAkB;AAAA,IACtB;AAAA,IACA,oCAAoC;AAAA,EACtC;AACA,MAAI,gBAAgB,WAAW,GAAG;AAChC;AAAA,EACF;AAEA,QAAM,SAAS,gBAAgB,WAAW;AAC1C,6BAAW,gCAAsB,yBAAY,KAAK,QAAQ,CAAC,kBAAkB,SAAS,4BAA4B,wBAAwB;AAAA,sBACtH,QAAQ,GAAG,kCAAkC,SAAS,gBAAgB,aAAa;AAAA;AAAA,EAEvG,gBAAgB,IAAI,mBAAmB,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,CAKpD;AAEC,MAAI,SAAS,QAAQ;AACnB;AAAA,EACF;AAEA,MAAI,SAAS,oBAAoB;AAC/B;AAAA,MACE;AAAA,IACF;AACA;AAAA,EACF;AAEA,MAAI,CAAC,QAAQ,MAAM,OAAO;AACxB,WAAO,IAAI,MAAM;AAAA,MACf,UAAU;AAAA,MACV,WAAW;AAAA,MACX,gBAAgB;AAAA,sCACW,yBAAY,KAAK,sBAAsB,CAAC;AAAA,4CAClC,yBAAY,KAAK,4BAA4B,CAAC;AAAA,IACjF,CAAC;AAAA,EACH;AAEA,8BAAY;AACZ,MACE,CAAE,UAAM,4BAAY,KAAK;AAAA,IACvB,SAAS,UAAU,SAAS,kBAAkB,YAAY;AAAA,IAC1D,SAAS;AAAA,EACX,CAAC,GACD;AACA,WAAO,IAAI,MAAM;AAAA,MACf,UAAU;AAAA,MACV,WAAW;AAAA,MACX,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH;AAEA,kCAAgB,uBAAuB;AACzC;AAOO,SAAS,oCACd,UACA,cACiB;AACjB,SAAO,OAAO,QAAQ,SAAS,0BAA0B,EAAE;AAAA,IACzD,CAAC,CAAC,eAAe,UAAU,MACzB,WAAW,QACR;AAAA,MACC,CAAC,UACC,MAAM,iBACN,CAAC,MAAM,WACN,MAAM,WAAW,WAAW,MAAM,WAAW,cAC9C,MAAM,WAAW;AAAA,IACrB,EACC,IAAI,CAAC,WAAW,EAAE,eAAe,MAAM,EAAE;AAAA,EAChD;AACF;AAEA,SAAS,oBAAoB,EAAE,eAAe,MAAM,GAAkB;AACpE,QAAM,yBACJ,kBAAkB,KAAK,GAAG,yBAAY,KAAK,aAAa,CAAC,MAAM;AACjE,QAAM,0BAA0B,yBAAY;AAAA,IAC1C,iBAAO,MAAM,QAAQ,eAAe,CAAC;AAAA,EACvC;AACA,QAAM,cACJ,MAAM,WAAW,YACb;AAAA,KAAQ,yBAAY,KAAK,6CAA6C,CAAC,KACvE;AACN,SACE,YACA,6BACA,4BAAY,KAAK,IACjB,OACA,0BACA;AAEJ;AAEA,SAAS,sCAA8C;AACrD,aAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/cjs/cli/lib/checkForLargeIndexDeletion.js

@@ -18,7 +18,9 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var checkForLargeIndexDeletion_exports = {};
 __export(checkForLargeIndexDeletion_exports, {
-  checkForLargeIndexDeletion: () => checkForLargeIndexDeletion
+  checkForLargeIndexDeletion: () => checkForLargeIndexDeletion,
+  deletedIndexesFromSchemaEvaluation: () => deletedIndexesFromSchemaEvaluation,
+  deletedIndexesFromTableSizes: () => deletedIndexesFromTableSizes
 });
 module.exports = __toCommonJS(checkForLargeIndexDeletion_exports);
 var import_chalk = require("chalk");
@@ -27,80 +29,50 @@ var import_indexes = require("./indexes.js");
 var import_prompts = require("./utils/prompts.js");
 var import_deploy2 = require("./deploy2.js");
 var import_run = require("./run.js");
+var import_utils = require("./utils/utils.js");
 const MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING = 1e5;
 async function checkForLargeIndexDeletion({
   ctx,
   span,
   request,
   options,
+  schemaEvaluation,
   askForConfirmation
 }) {
   (0, import_log.changeSpinner)("Verifying that the push isn\u2019t deleting large indexes...");
-  const { schemaChange } = await (0, import_deploy2.evaluatePush)(ctx, span, request, options);
-  const indexDiffs = schemaChange.indexDiffs ?? {};
-  const deletedIndexes = Object.entries(indexDiffs).flatMap(
-    ([componentDefinitionPath, indexDiff]) => indexDiff.removed_indexes.map((index) => ({
-      componentDefinitionPath,
-      index
-    }))
-  );
+  const schemaEvaluationResponse = await schemaEvaluation(span);
+  let deletedIndexes;
+  if (schemaEvaluationResponse !== null) {
+    deletedIndexes = deletedIndexesFromSchemaEvaluation(
+      schemaEvaluationResponse
+    );
+  } else {
+    (0, import_log.logVerbose)(
+      "Schema evaluation unavailable, sizing deleted indexes per table"
+    );
+    deletedIndexes = await deletedIndexesFromTableSizes({
+      ctx,
+      span,
+      request,
+      options
+    });
+  }
   if (deletedIndexes.length === 0) {
     (0, import_log.logFinishedStep)("No indexes are deleted by this push");
     return;
   }
-  const tablesWithDeletedIndexes = [
-    ...new Set(
-      deletedIndexes.map(
-        ({ componentDefinitionPath, index }) => `${componentDefinitionPath}:${getTableName(index)}`
-      )
-    )
-  ].map((str) => {
-    const [componentDefinitionPath, table] = str.split(":");
-    return { componentDefinitionPath, table };
-  });
-  (0, import_log.changeSpinner)("Checking whether the deleted indexes are on large tables...");
-  const documentCounts = await Promise.all(
-    tablesWithDeletedIndexes.map(
-      async ({ componentDefinitionPath, table }) => ({
-        componentDefinitionPath,
-        table,
-        count: await (0, import_run.runSystemQuery)(ctx, {
-          deploymentUrl: options.url,
-          adminKey: options.adminKey,
-          functionName: "_system/cli/tableSize:default",
-          componentPath: componentDefinitionPath,
-          args: { tableName: table }
-        })
-      })
-    )
-  );
-  const deletedIndexesWithDocumentsCount = deletedIndexes.map(
-    ({ componentDefinitionPath, index }) => ({
-      componentDefinitionPath,
-      index,
-      count: documentCounts.find(
-        (count) => count.table === getTableName(index) && count.componentDefinitionPath === componentDefinitionPath
-      ).count
-    })
-  );
   const minDocumentsForWarning = minDocumentsForIndexDeleteWarning();
-  if (!deletedIndexesWithDocumentsCount.some(
-    ({ count }) => count >= minDocumentsForWarning
+  if (!deletedIndexes.some(
+    ({ documentsCount }) => documentsCount >= minDocumentsForWarning
   )) {
     (0, import_log.logFinishedStep)("No large indexes are deleted by this push");
     return;
   }
-  (0, import_log.logMessage)(`\u26A0\uFE0F  This code push will ${import_chalk.chalkStderr.bold("delete")} the following ${deletedIndexesWithDocumentsCount.length === 1 ? "index" : "indexes"}
+  (0, import_log.logMessage)(`\u26A0\uFE0F  This code push will ${import_chalk.chalkStderr.bold("delete")} the following ${deletedIndexes.length === 1 ? "index" : "indexes"}
 from your production deployment (${options.url}):
 
-${deletedIndexesWithDocumentsCount.map(
-    ({ componentDefinitionPath, index, count }) => formatDeletedIndex({
-      componentDefinitionPath,
-      index,
-      indexDiff: indexDiffs[componentDefinitionPath],
-      documentsCount: count,
-      minDocumentsForWarning
-    })
+${deletedIndexes.map(
+    (deletedIndex) => formatDeletedIndex({ ...deletedIndex, minDocumentsForWarning })
   ).join("\n")}
 
 The documents that are in the index won\u2019t be deleted, but the index will need
@@ -108,7 +80,7 @@ to be backfilled again if you want to restore it later.
 `);
   if (!askForConfirmation) {
     (0, import_log.logFinishedStep)(
-      "Proceeding with push since --allow-deleting-large-indexes is set"
+      "Proceeding with push since deleting large indexes was allowed by flag"
     );
     return;
   }
@@ -118,12 +90,12 @@ to be backfilled again if you want to restore it later.
       errorType: "fatal",
       printedMessage: `To confirm the push:
 \u2022 run the deploy command in an ${import_chalk.chalkStderr.bold("interactive terminal")}
-\u2022 or run the deploy command with the ${import_chalk.chalkStderr.bold("--allow-deleting-large-indexes")} flag`
+\u2022 or run the deploy command with the ${import_chalk.chalkStderr.bold("--skip-large-indexes-check")} flag`
     });
   }
   (0, import_log.stopSpinner)();
   if (!await (0, import_prompts.promptYesNo)(ctx, {
-    message: `Delete ${deletedIndexesWithDocumentsCount.length === 1 ? "this index" : "these indexes"}?`,
+    message: `Delete ${deletedIndexes.length === 1 ? "this index" : "these indexes"}?`,
     default: false
   })) {
     return ctx.crash({
@@ -134,16 +106,78 @@ to be backfilled again if you want to restore it later.
   }
   (0, import_log.logFinishedStep)("Proceeding with push.");
 }
+function deletedIndexesFromSchemaEvaluation(response) {
+  return Object.entries(response.componentSchemaEvaluations).flatMap(
+    ([componentPath, prediction]) => prediction.indexes.filter((index) => index.change === "dropped").map((index) => ({
+      componentPath,
+      index,
+      documentsCount: index.numDocs,
+      replacedBy: prediction.indexes.find(
+        (other) => other.change === "added" && other.name === index.name
+      ) ?? null
+    }))
+  );
+}
+async function deletedIndexesFromTableSizes({
+  ctx,
+  span,
+  request,
+  options
+}) {
+  const { schemaChange } = await (0, import_deploy2.evaluatePush)(ctx, span, request, options);
+  const indexDiffs = schemaChange.indexDiffs ?? {};
+  const deletedIndexes = Object.entries(indexDiffs).flatMap(
+    ([componentPath, indexDiff]) => indexDiff.removed_indexes.map((index) => ({
+      componentPath,
+      index,
+      replacedBy: indexDiff.added_indexes.find((other) => other.name === index.name) ?? null
+    }))
+  );
+  if (deletedIndexes.length === 0) {
+    return [];
+  }
+  const tablesWithDeletedIndexes = [
+    ...new Set(
+      deletedIndexes.map(
+        ({ componentPath, index }) => `${componentPath}:${getTableName(index)}`
+      )
+    )
+  ].map((str) => {
+    const [componentPath, table] = str.split(":");
+    return { componentPath, table };
+  });
+  (0, import_log.changeSpinner)("Checking whether the deleted indexes are on large tables...");
+  const documentCounts = await Promise.all(
+    tablesWithDeletedIndexes.map(async ({ componentPath, table }) => ({
+      componentPath,
+      table,
+      count: await (0, import_run.runSystemQuery)(ctx, {
+        deploymentUrl: options.url,
+        adminKey: options.adminKey,
+        functionName: "_system/cli/tableSize:default",
+        componentPath,
+        args: { tableName: table }
+      })
+    }))
+  );
+  return deletedIndexes.map(({ componentPath, index, replacedBy }) => ({
+    componentPath,
+    index,
+    replacedBy,
+    documentsCount: documentCounts.find(
+      (count) => count.table === getTableName(index) && count.componentPath === componentPath
+    ).count
+  }));
+}
 function formatDeletedIndex({
-  componentDefinitionPath,
+  componentPath,
   index,
-  indexDiff,
   documentsCount,
+  replacedBy,
   minDocumentsForWarning
 }) {
-  const componentNameFormatted = componentDefinitionPath !== "" ? `${import_chalk.chalkStderr.gray(componentDefinitionPath)}:` : "";
+  const componentNameFormatted = componentPath !== "" ? `${import_chalk.chalkStderr.gray(componentPath)}:` : "";
   const documentsCountFormatted = documentsCount >= minDocumentsForWarning ? `  ${import_chalk.chalkStderr.yellowBright(`\u26A0\uFE0F  ${documentsCount.toLocaleString()} documents`)}` : `  ${documentsCount.toLocaleString()} ${documentsCount === 1 ? "document" : "documents"}`;
-  const replacedBy = indexDiff.added_indexes.find((i) => i.name === index.name);
   const replacedByFormatted = replacedBy ? `
    ${import_chalk.chalkStderr.green("\u2192 replaced by:")} ${(0, import_indexes.formatIndex)(replacedBy)}` : "";
   return "\u26D4 " + componentNameFormatted + (0, import_indexes.formatIndex)(index) + documentsCountFormatted + replacedByFormatted;
@@ -153,13 +187,9 @@ function getTableName(index) {
   return tableName;
 }
 function minDocumentsForIndexDeleteWarning() {
-  const envValue = process.env.CONVEX_MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING;
-  if (envValue !== void 0) {
-    const parsed = parseInt(envValue, 10);
-    if (!isNaN(parsed)) {
-      return parsed;
-    }
-  }
-  return MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING;
+  return (0, import_utils.integerFromEnv)(
+    "CONVEX_MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING",
+    MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING
+  );
 }
 //# sourceMappingURL=checkForLargeIndexDeletion.js.map