convex 1.46.0 → 1.48.0-alpha.0

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/lib/dev.ts"],
-  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { spawn, ChildProcess } from \"child_process\";\nimport { OneoffCtx } from \"../../bundler/context.js\";\nimport {\n  logError,\n  logFinishedStep,\n  logMessage,\n  logWarning,\n  showSpinner,\n  showSpinnerIfSlow,\n  stopSpinner,\n} from \"../../bundler/log.js\";\nimport { runPush } from \"./components.js\";\nimport { performance } from \"perf_hooks\";\nimport path from \"path\";\nimport { LogManager, LogMode, watchLogs } from \"./logs.js\";\nimport { PushOptions } from \"./components.js\";\nimport {\n  formatDuration,\n  getCurrentTimeString,\n  waitForever,\n  waitUntilCalled,\n} from \"./utils/utils.js\";\nimport { Crash, WatchContext, Watcher } from \"./watch.js\";\nimport { runFunctionAndLog, subscribe } from \"./run.js\";\nimport { Value } from \"../../values/index.js\";\nimport { DeploymentType } from \"./api.js\";\nimport { readProjectConfig, getAuthKitConfig } from \"./config.js\";\nimport {\n  syncAuthKitConfigAfterPush,\n  ensureAuthKitProvisionedBeforeBuild,\n} from \"./workos/workos.js\";\nimport { handleDashboard } from \"./localDeployment/dashboard.js\";\nimport { loadDeploymentConfig } from \"./localDeployment/filePaths.js\";\nimport { LocalDeploymentError } from \"./localDeployment/errors.js\";\n\nexport async function devAgainstDeployment(\n  ctx: OneoffCtx,\n  credentials: {\n    url: string;\n    adminKey: string;\n    deploymentName: string | null;\n    deploymentType?: DeploymentType;\n    backendVersion?: string | undefined;\n  },\n  devOptions: {\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) {\n  const logManager = new LogManager(devOptions.tailLogs);\n\n  // Pre-flight check: Ensure AuthKit is provisioned before starting dev\n  const { projectConfig } = await readProjectConfig(ctx);\n  const authKitConfig = await getAuthKitConfig(ctx, projectConfig);\n\n  if (authKitConfig && credentials.deploymentName) {\n    // Only provision for cloud deployments (dev/preview/prod)\n    // Skip for local and anonymous deployments\n    const deploymentType = credentials.deploymentType;\n    if (\n      deploymentType === \"dev\" ||\n      deploymentType === \"preview\" ||\n      deploymentType === \"prod\"\n    ) {\n      await ensureAuthKitProvisionedBeforeBuild(\n        ctx,\n        credentials.deploymentName,\n        { deploymentUrl: credentials.url, adminKey: credentials.adminKey },\n        deploymentType,\n      );\n    }\n  }\n\n  // Anonymous mode starts a local dashboard server alongside long-running `npx convex dev` commands.\n  if (\n    !devOptions.once &&\n    !devOptions.untilSuccess &&\n    credentials.deploymentType === \"anonymous\" &&\n    credentials.deploymentName !== null\n  ) {\n    const deploymentConfig = loadDeploymentConfig(\n      ctx,\n      \"anonymous\",\n      credentials.deploymentName,\n    );\n    if (deploymentConfig === null) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: `Could not find local deployment config. This is a bug in Convex.`,\n        errForSentry: new LocalDeploymentError(\n          `Could not find local deployment config to start the anonymous dashboard.`,\n        ),\n      });\n    }\n    await handleDashboard(\n      ctx,\n      {\n        name: credentials.deploymentName,\n        cloudPort: deploymentConfig.ports.cloud,\n        adminKey: deploymentConfig.adminKey,\n      },\n      {\n        backendVersion: credentials.backendVersion,\n      },\n    );\n  }\n\n  const promises = [];\n  if (devOptions.tailLogs !== \"disable\") {\n    promises.push(\n      watchLogs(ctx, credentials.url, credentials.adminKey, \"stderr\", {\n        logManager,\n        success: false,\n      }),\n    );\n  }\n\n  promises.push(\n    watchAndPush(\n      ctx,\n      {\n        ...credentials,\n        verbose: devOptions.verbose,\n        dryRun: false,\n        typecheck: devOptions.typecheck,\n        typecheckComponents: devOptions.typecheckComponents,\n        debug: false,\n        debugBundlePath: devOptions.debugBundlePath,\n        debugNodeApis: devOptions.debugNodeApis,\n        codegen: devOptions.codegen,\n        liveComponentSources: devOptions.liveComponentSources,\n        pushAllModules: devOptions.pushAllModules,\n        logManager, // Pass logManager to control logs during deploy\n        largeIndexDeletionCheck: \"no verification\", // `convex dev` can\u2019t push to prod\n        warnOnSlowSchemaValidation: true,\n        message: null,\n      },\n      devOptions,\n    ),\n  );\n  await Promise.race(promises);\n  await ctx.flushAndExit(0);\n}\n\nexport async function watchAndPush(\n  outerCtx: OneoffCtx,\n  options: PushOptions,\n  cmdOptions: {\n    run?:\n      | { kind: \"function\"; name: string; component?: string | undefined }\n      | { kind: \"shell\"; command: string }\n      | undefined;\n    once: boolean;\n    untilSuccess: boolean;\n    traceEvents: boolean;\n  },\n) {\n  const watch: { watcher: Watcher | undefined } = { watcher: undefined };\n  const authKitCache: { lastAppliedConfig: string | undefined } = {\n    lastAppliedConfig: undefined,\n  };\n  let numFailures = 0;\n  let ran = false;\n  let pushed = false;\n  let shellChild: ChildProcess | undefined;\n  let shellExited: Promise<void> | undefined;\n  let shellCleanupHandle: string | undefined;\n  let shellSigintListener: (() => void) | undefined;\n  let tableNameTriggeringRetry;\n  let shouldRetryOnDeploymentEnvVarChange;\n  let isFirstPush = true; // Track if this is the first push in the session\n\n  try {\n    while (true) {\n      const start = performance.now();\n      tableNameTriggeringRetry = null;\n      shouldRetryOnDeploymentEnvVarChange = false;\n\n      const ctx = new WatchContext(\n        cmdOptions.traceEvents,\n        outerCtx.bigBrainAuth(),\n        isFirstPush,\n      );\n      options.logManager?.beginDeploy();\n      showSpinner(\"Preparing Convex functions...\");\n      try {\n        await runPush(ctx, options);\n        const end = performance.now();\n        // NOTE: If `runPush` throws, `endDeploy` will not be called.\n        // This allows you to see the output from the failed deploy without\n        // logs getting in the way.\n        options.logManager?.endDeploy();\n        numFailures = 0;\n        logFinishedStep(\n          `${getCurrentTimeString()} Convex functions ready! (${formatDuration(\n            end - start,\n          )})`,\n        );\n\n        // Sync AuthKit configuration if it has changed\n        const { projectConfig } = await readProjectConfig(ctx);\n        const authKitConfig = await getAuthKitConfig(ctx, projectConfig);\n\n        // Check if config has changed by comparing stringified versions\n        const currentConfigString = authKitConfig\n          ? JSON.stringify(authKitConfig)\n          : undefined;\n\n        // Skip sync on first push since ensureAuthKitProvisionedBeforeBuild already configured WorkOS\n        if (\n          !isFirstPush &&\n          currentConfigString !== authKitCache.lastAppliedConfig\n        ) {\n          // Config has changed, sync it\n          await syncAuthKitConfigAfterPush(ctx, projectConfig, {\n            deploymentUrl: options.url,\n            adminKey: options.adminKey,\n          });\n        }\n\n        // Always update cache after push (even if we skipped sync)\n        authKitCache.lastAppliedConfig = currentConfigString;\n        isFirstPush = false;\n        if (cmdOptions.run !== undefined && !ran) {\n          switch (cmdOptions.run.kind) {\n            case \"function\":\n              await runFunctionInDev(\n                ctx,\n                options,\n                cmdOptions.run.name,\n                cmdOptions.run.component,\n              );\n              break;\n            case \"shell\": {\n              // Spawn the shell command as a long-running child process,\n              // piping stdin/stdout/stderr. It runs alongside dev and is\n              // waited on during clean exit or killed on signal exit.\n              const shellCommand = cmdOptions.run.command;\n              const signalShellChild = (signal: NodeJS.Signals) => {\n                if (!shellChild) {\n                  return;\n                }\n                const child = shellChild;\n                // Kill the entire process group so children of the shell\n                // are also killed.\n                try {\n                  if (child.pid !== undefined) {\n                    // Kill the negative PID to signal the entire process\n                    // group. Falls back to the child directly if the\n                    // group is already gone.\n                    try {\n                      process.kill(-child.pid, signal);\n                    } catch {\n                      child.kill(signal);\n                    }\n                  } else {\n                    child.kill(signal);\n                  }\n                } catch {\n                  // Child may already be dead.\n                }\n              };\n              const clearShellSigintListener = () => {\n                if (shellSigintListener) {\n                  process.off(\"SIGINT\", shellSigintListener);\n                  shellSigintListener = undefined;\n                }\n              };\n              shellChild = spawn(shellCommand, [], {\n                shell: true,\n                stdio: \"inherit\",\n                detached: true,\n              });\n              shellSigintListener = () => {\n                clearShellSigintListener();\n                signalShellChild(\"SIGINT\");\n              };\n              process.prependListener(\"SIGINT\", shellSigintListener);\n              shellCleanupHandle = outerCtx.registerCleanup(async () => {\n                if (shellSigintListener) {\n                  clearShellSigintListener();\n                } else {\n                  // If the listener already fired (and cleared itself),\n                  // the child got SIGINT \u2014 give it a moment to exit on\n                  // its own before escalating to SIGTERM.\n                  const SIGTERM_ESCALATION_MS = 1000;\n                  await Promise.race([\n                    shellExited,\n                    new Promise((resolve) =>\n                      setTimeout(resolve, SIGTERM_ESCALATION_MS),\n                    ),\n                  ]);\n                }\n                if (shellChild) {\n                  signalShellChild(\"SIGTERM\");\n                }\n                await shellExited;\n              });\n              shellExited = new Promise<void>((resolve) => {\n                shellChild!.on(\"error\", (error) => {\n                  logError(\n                    `Failed to run command \\`${shellCommand}\\`: ${error.message}`,\n                  );\n                  shellChild = undefined;\n                  resolve();\n                  void outerCtx.flushAndExit(1);\n                });\n                shellChild!.on(\"exit\", (code, signal) => {\n                  shellChild = undefined;\n                  resolve();\n                  // If killed by a signal (e.g. from cleanup on shutdown),\n                  // don't treat it as a failure \u2014 convex dev is already\n                  // shutting down.\n                  if (signal) {\n                    return;\n                  }\n                  if (code !== null && code !== 0) {\n                    logError(\n                      `Command \\`${shellCommand}\\` exited with code ${code}`,\n                    );\n                    void outerCtx.flushAndExit(1);\n                  }\n                });\n              });\n              break;\n            }\n            default: {\n              cmdOptions.run satisfies never;\n              // Don't return this since it'll bypass the `catch` below.\n              await ctx.crash({\n                exitCode: 1,\n                errorType: \"fatal\",\n                printedMessage: `Unexpected arguments for --run`,\n                errForSentry: `Unexpected arguments for --run: ${JSON.stringify(\n                  cmdOptions.run,\n                )}`,\n              });\n            }\n          }\n          ran = true;\n        }\n        pushed = true;\n      } catch (e: any) {\n        // Crash the app on unexpected errors.\n        if (!(e instanceof Crash) || !e.errorType) {\n          // eslint-disable-next-line no-restricted-syntax\n          throw e;\n        }\n        if (e.errorType === \"fatal\") {\n          break;\n        }\n        // Retry after an exponential backoff if we hit a transient error.\n        if (e.errorType === \"transient\" || e.errorType === \"already handled\") {\n          const delay = nextBackoff(numFailures);\n          numFailures += 1;\n          if (e.errorType === \"transient\") {\n            logWarning(\n              chalkStderr.yellow(\n                `Failed due to network error, retrying in ${formatDuration(\n                  delay,\n                )}...`,\n              ),\n            );\n          }\n          await new Promise((resolve) => setTimeout(resolve, delay));\n          continue;\n        }\n\n        // Fall through if we had a filesystem-based error.\n        // TODO(sarah): Replace this with `logError`.\n        // eslint-disable-next-line no-console\n        console.assert(\n          e.errorType === \"invalid filesystem data\" ||\n            e.errorType === \"invalid filesystem or env vars\" ||\n            e.errorType[\"invalid filesystem or db data\"] !== undefined,\n        );\n        if (e.errorType === \"invalid filesystem or env vars\") {\n          shouldRetryOnDeploymentEnvVarChange = true;\n        } else if (\n          e.errorType !== \"invalid filesystem data\" &&\n          e.errorType[\"invalid filesystem or db data\"] !== undefined\n        ) {\n          tableNameTriggeringRetry =\n            e.errorType[\"invalid filesystem or db data\"];\n        }\n        if (cmdOptions.once) {\n          await outerCtx.flushAndExit(1, e.errorType);\n        }\n        // Make sure that we don't spin if this push failed\n        // in any edge cases that didn't call `logFailure`\n        // before throwing.\n        stopSpinner();\n      }\n      if (cmdOptions.once) {\n        return;\n      }\n      if (pushed && cmdOptions.untilSuccess) {\n        return;\n      }\n      const fileSystemWatch = getFileSystemWatch(ctx, watch, cmdOptions);\n      const tableWatch = getTableWatch(\n        ctx,\n        options,\n        tableNameTriggeringRetry?.tableName ?? null,\n        tableNameTriggeringRetry?.componentPath,\n      );\n      const envVarWatch = getDeplymentEnvVarWatch(\n        ctx,\n        options,\n        shouldRetryOnDeploymentEnvVarChange,\n      );\n      await Promise.race([\n        fileSystemWatch.watch(),\n        tableWatch.watch(),\n        envVarWatch.watch(),\n      ]);\n      fileSystemWatch.stop();\n      void tableWatch.stop();\n      void envVarWatch.stop();\n    }\n  } finally {\n    // On clean exit (e.g. --once, --until-success), wait for the shell\n    // command to finish naturally. Keep the SIGINT listener active so\n    // Ctrl+C during the wait still forwards to the child. On signal\n    // exit (e.g. Ctrl+C), the registered cleanup handler will have\n    // already killed it.\n    if (shellExited) {\n      await shellExited;\n    }\n    if (shellSigintListener) {\n      process.off(\"SIGINT\", shellSigintListener);\n      shellSigintListener = undefined;\n    }\n    if (shellCleanupHandle) {\n      outerCtx.removeCleanup(shellCleanupHandle);\n    }\n  }\n}\n\nasync function runFunctionInDev(\n  ctx: WatchContext,\n  credentials: {\n    url: string;\n    adminKey: string;\n  },\n  functionName: string,\n  componentPath: string | undefined,\n) {\n  await runFunctionAndLog(ctx, {\n    deploymentUrl: credentials.url,\n    adminKey: credentials.adminKey,\n    functionName,\n    argsString: \"{}\",\n    componentPath,\n    callbacks: {\n      onSuccess: () => {\n        logFinishedStep(`Finished running function \"${functionName}\"`);\n      },\n    },\n  });\n}\n\nfunction getTableWatch(\n  ctx: WatchContext,\n  credentials: {\n    url: string;\n    adminKey: string;\n  },\n  tableName: string | null,\n  componentPath: string | undefined,\n) {\n  return getFunctionWatch(ctx, {\n    deploymentUrl: credentials.url,\n    adminKey: credentials.adminKey,\n    parsedFunctionName: \"_system/cli/queryTable\",\n    getArgs: () => (tableName !== null ? { tableName } : null),\n    componentPath,\n  });\n}\n\nfunction getDeplymentEnvVarWatch(\n  ctx: WatchContext,\n  credentials: {\n    url: string;\n    adminKey: string;\n  },\n  shouldRetryOnDeploymentEnvVarChange: boolean,\n) {\n  return getFunctionWatch(ctx, {\n    deploymentUrl: credentials.url,\n    adminKey: credentials.adminKey,\n    parsedFunctionName: \"_system/cli/queryEnvironmentVariables\",\n    getArgs: () => (shouldRetryOnDeploymentEnvVarChange ? {} : null),\n    componentPath: undefined,\n  });\n}\n\nfunction getFunctionWatch(\n  ctx: WatchContext,\n  args: {\n    deploymentUrl: string;\n    adminKey: string;\n    parsedFunctionName: string;\n    getArgs: () => Record<string, Value> | null;\n    componentPath: string | undefined;\n  },\n) {\n  const [stopPromise, stop] = waitUntilCalled();\n  return {\n    watch: async () => {\n      const functionArgs = args.getArgs();\n      if (functionArgs === null) {\n        return waitForever();\n      }\n      let changes = 0;\n      return subscribe(ctx, {\n        deploymentUrl: args.deploymentUrl,\n        adminKey: args.adminKey,\n        parsedFunctionName: args.parsedFunctionName,\n        parsedFunctionArgs: functionArgs,\n        componentPath: args.componentPath,\n        until: stopPromise,\n        callbacks: {\n          onChange: () => {\n            changes++;\n            // First bump is just the initial results reporting\n            if (changes > 1) {\n              stop();\n            }\n          },\n        },\n      });\n    },\n    stop: () => {\n      stop();\n    },\n  };\n}\n\nfunction getFileSystemWatch(\n  ctx: WatchContext,\n  watch: { watcher: Watcher | undefined },\n  cmdOptions: { traceEvents: boolean },\n) {\n  let hasStopped = false;\n  return {\n    watch: async () => {\n      const observations = ctx.fs.finalize();\n      if (observations === \"invalidated\") {\n        logMessage(\"Filesystem changed during push, retrying...\");\n        return;\n      }\n      // Initialize the watcher if we haven't done it already. Chokidar expects to have a\n      // nonempty watch set at initialization, so we can't do it before running our first\n      // push.\n      if (!watch.watcher) {\n        watch.watcher = new Watcher(observations);\n        await showSpinnerIfSlow(\n          \"Preparing to watch files...\",\n          500,\n          async () => {\n            await watch.watcher!.ready();\n          },\n        );\n        stopSpinner();\n      }\n      // Watch new directories if needed.\n      watch.watcher.update(observations);\n\n      // Process events until we find one that overlaps with our previous observations.\n      let anyChanges = false;\n      do {\n        await watch.watcher.waitForEvent();\n        if (hasStopped) {\n          return;\n        }\n        for (const event of watch.watcher.drainEvents()) {\n          if (cmdOptions.traceEvents) {\n            logMessage(\n              \"Processing\",\n              event.name,\n              path.relative(\"\", event.absPath),\n            );\n          }\n          const result = observations.overlaps(event);\n          if (result.overlaps) {\n            const relPath = path.relative(\"\", event.absPath);\n            if (cmdOptions.traceEvents) {\n              logMessage(`${relPath} ${result.reason}, rebuilding...`);\n            }\n            anyChanges = true;\n            break;\n          }\n        }\n      } while (!anyChanges);\n\n      // Wait for the filesystem to quiesce before starting a new push. It's okay to\n      // drop filesystem events at this stage since we're already committed to doing\n      // a push and resubscribing based on that push's observations.\n      let deadline = performance.now() + quiescenceDelay;\n      while (true) {\n        const now = performance.now();\n        if (now >= deadline) {\n          break;\n        }\n        const remaining = deadline - now;\n        if (cmdOptions.traceEvents) {\n          logMessage(`Waiting for ${formatDuration(remaining)} to quiesce...`);\n        }\n        const remainingWait = new Promise<\"timeout\">((resolve) =>\n          setTimeout(() => resolve(\"timeout\"), deadline - now),\n        );\n        const result = await Promise.race([\n          remainingWait,\n          watch.watcher.waitForEvent().then<\"newEvents\">(() => \"newEvents\"),\n        ]);\n        if (result === \"newEvents\") {\n          for (const event of watch.watcher.drainEvents()) {\n            const result = observations.overlaps(event);\n            // Delay another `quiescenceDelay` since we had an overlapping event.\n            if (result.overlaps) {\n              if (cmdOptions.traceEvents) {\n                logMessage(\n                  `Received an overlapping event at ${event.absPath}, delaying push.`,\n                );\n              }\n              deadline = performance.now() + quiescenceDelay;\n            }\n          }\n        } else {\n          // Let the check above `break` from the loop if we're past our deadlne.\n          if (result !== \"timeout\") {\n            logError(\n              \"Assertion failed: Unexpected result from watcher: \" + result,\n            );\n          }\n        }\n      }\n    },\n    stop: () => {\n      hasStopped = true;\n    },\n  };\n}\n\nconst initialBackoff = 500;\nconst maxBackoff = 16000;\nconst quiescenceDelay = 500;\n\nexport function nextBackoff(prevFailures: number): number {\n  const baseBackoff = initialBackoff * Math.pow(2, prevFailures);\n  const actualBackoff = Math.min(baseBackoff, maxBackoff);\n  const jitter = actualBackoff * (Math.random() - 0.5);\n  return actualBackoff + jitter;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { spawn, ChildProcess } from \"child_process\";\nimport { OneoffCtx } from \"../../bundler/context.js\";\nimport {\n  logError,\n  logFinishedStep,\n  logMessage,\n  logWarning,\n  showSpinner,\n  showSpinnerIfSlow,\n  stopSpinner,\n} from \"../../bundler/log.js\";\nimport { runPush } from \"./components.js\";\nimport { performance } from \"perf_hooks\";\nimport path from \"path\";\nimport { LogManager, LogMode, watchLogs } from \"./logs.js\";\nimport { PushOptions } from \"./components.js\";\nimport {\n  formatDuration,\n  getCurrentTimeString,\n  waitForever,\n  waitUntilCalled,\n} from \"./utils/utils.js\";\nimport { Crash, WatchContext, Watcher } from \"./watch.js\";\nimport { runFunctionAndLog, subscribe } from \"./run.js\";\nimport { Value } from \"../../values/index.js\";\nimport { DeploymentType } from \"./api.js\";\nimport { readProjectConfig, getAuthKitConfig } from \"./config.js\";\nimport {\n  syncAuthKitConfigAfterPush,\n  ensureAuthKitProvisionedBeforeBuild,\n} from \"./workos/workos.js\";\nimport { handleDashboard } from \"./localDeployment/dashboard.js\";\nimport { loadDeploymentConfig } from \"./localDeployment/filePaths.js\";\nimport { LocalDeploymentError } from \"./localDeployment/errors.js\";\n\nexport async function devAgainstDeployment(\n  ctx: OneoffCtx,\n  credentials: {\n    url: string;\n    adminKey: string;\n    deploymentName: string | null;\n    deploymentType?: DeploymentType;\n    backendVersion?: string | undefined;\n  },\n  devOptions: {\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    allowUnstagingSchema: boolean;\n  },\n) {\n  const logManager = new LogManager(devOptions.tailLogs);\n\n  // Pre-flight check: Ensure AuthKit is provisioned before starting dev\n  const { projectConfig } = await readProjectConfig(ctx);\n  const authKitConfig = await getAuthKitConfig(ctx, projectConfig);\n\n  if (authKitConfig && credentials.deploymentName) {\n    // Only provision for cloud deployments (dev/preview/prod)\n    // Skip for local and anonymous deployments\n    const deploymentType = credentials.deploymentType;\n    if (\n      deploymentType === \"dev\" ||\n      deploymentType === \"preview\" ||\n      deploymentType === \"prod\"\n    ) {\n      await ensureAuthKitProvisionedBeforeBuild(\n        ctx,\n        credentials.deploymentName,\n        { deploymentUrl: credentials.url, adminKey: credentials.adminKey },\n        deploymentType,\n      );\n    }\n  }\n\n  // Anonymous mode starts a local dashboard server alongside long-running `npx convex dev` commands.\n  if (\n    !devOptions.once &&\n    !devOptions.untilSuccess &&\n    credentials.deploymentType === \"anonymous\" &&\n    credentials.deploymentName !== null\n  ) {\n    const deploymentConfig = loadDeploymentConfig(\n      ctx,\n      \"anonymous\",\n      credentials.deploymentName,\n    );\n    if (deploymentConfig === null) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: `Could not find local deployment config. This is a bug in Convex.`,\n        errForSentry: new LocalDeploymentError(\n          `Could not find local deployment config to start the anonymous dashboard.`,\n        ),\n      });\n    }\n    await handleDashboard(\n      ctx,\n      {\n        name: credentials.deploymentName,\n        cloudPort: deploymentConfig.ports.cloud,\n        adminKey: deploymentConfig.adminKey,\n      },\n      {\n        backendVersion: credentials.backendVersion,\n      },\n    );\n  }\n\n  const promises = [];\n  if (devOptions.tailLogs !== \"disable\") {\n    promises.push(\n      watchLogs(ctx, credentials.url, credentials.adminKey, \"stderr\", {\n        logManager,\n        success: false,\n      }),\n    );\n  }\n\n  promises.push(\n    watchAndPush(\n      ctx,\n      {\n        ...credentials,\n        verbose: devOptions.verbose,\n        dryRun: false,\n        typecheck: devOptions.typecheck,\n        typecheckComponents: devOptions.typecheckComponents,\n        debug: false,\n        debugBundlePath: devOptions.debugBundlePath,\n        debugNodeApis: devOptions.debugNodeApis,\n        codegen: devOptions.codegen,\n        liveComponentSources: devOptions.liveComponentSources,\n        pushAllModules: devOptions.pushAllModules,\n        logManager, // Pass logManager to control logs during deploy\n        largeIndexDeletionCheck: \"no verification\", // `convex dev` can\u2019t push to prod\n        // `convex dev --prod` pushes straight to production, where an\n        // unstaged index on a large table blocks the push for the whole\n        // backfill; dev deployments are small enough to let it through.\n        largeIndexBackfillCheck:\n          credentials.deploymentType === \"prod\"\n            ? \"ask for confirmation\"\n            : \"no verification\",\n        stagedValidatorDeletionCheck:\n          credentials.deploymentType === \"prod\"\n            ? devOptions.allowUnstagingSchema\n              ? \"has confirmation\"\n              : \"ask for confirmation\"\n            : \"no verification\",\n        warnOnSlowSchemaValidation: true,\n        message: null,\n      },\n      devOptions,\n    ),\n  );\n  await Promise.race(promises);\n  await ctx.flushAndExit(0);\n}\n\nexport async function watchAndPush(\n  outerCtx: OneoffCtx,\n  options: PushOptions,\n  cmdOptions: {\n    run?:\n      | { kind: \"function\"; name: string; component?: string | undefined }\n      | { kind: \"shell\"; command: string }\n      | undefined;\n    once: boolean;\n    untilSuccess: boolean;\n    traceEvents: boolean;\n  },\n) {\n  const watch: { watcher: Watcher | undefined } = { watcher: undefined };\n  const authKitCache: { lastAppliedConfig: string | undefined } = {\n    lastAppliedConfig: undefined,\n  };\n  let numFailures = 0;\n  let ran = false;\n  let pushed = false;\n  let shellChild: ChildProcess | undefined;\n  let shellExited: Promise<void> | undefined;\n  let shellCleanupHandle: string | undefined;\n  let shellSigintListener: (() => void) | undefined;\n  let tableNameTriggeringRetry;\n  let shouldRetryOnDeploymentEnvVarChange;\n  let isFirstPush = true; // Track if this is the first push in the session\n\n  try {\n    while (true) {\n      const start = performance.now();\n      tableNameTriggeringRetry = null;\n      shouldRetryOnDeploymentEnvVarChange = false;\n\n      const ctx = new WatchContext(\n        cmdOptions.traceEvents,\n        outerCtx.bigBrainAuth(),\n        isFirstPush,\n      );\n      options.logManager?.beginDeploy();\n      showSpinner(\"Preparing Convex functions...\");\n      try {\n        await runPush(ctx, options);\n        const end = performance.now();\n        // NOTE: If `runPush` throws, `endDeploy` will not be called.\n        // This allows you to see the output from the failed deploy without\n        // logs getting in the way.\n        options.logManager?.endDeploy();\n        numFailures = 0;\n        logFinishedStep(\n          `${getCurrentTimeString()} Convex functions ready! (${formatDuration(\n            end - start,\n          )})`,\n        );\n\n        // Sync AuthKit configuration if it has changed\n        const { projectConfig } = await readProjectConfig(ctx);\n        const authKitConfig = await getAuthKitConfig(ctx, projectConfig);\n\n        // Check if config has changed by comparing stringified versions\n        const currentConfigString = authKitConfig\n          ? JSON.stringify(authKitConfig)\n          : undefined;\n\n        // Skip sync on first push since ensureAuthKitProvisionedBeforeBuild already configured WorkOS\n        if (\n          !isFirstPush &&\n          currentConfigString !== authKitCache.lastAppliedConfig\n        ) {\n          // Config has changed, sync it\n          await syncAuthKitConfigAfterPush(ctx, projectConfig, {\n            deploymentUrl: options.url,\n            adminKey: options.adminKey,\n          });\n        }\n\n        // Always update cache after push (even if we skipped sync)\n        authKitCache.lastAppliedConfig = currentConfigString;\n        isFirstPush = false;\n        if (cmdOptions.run !== undefined && !ran) {\n          switch (cmdOptions.run.kind) {\n            case \"function\":\n              await runFunctionInDev(\n                ctx,\n                options,\n                cmdOptions.run.name,\n                cmdOptions.run.component,\n              );\n              break;\n            case \"shell\": {\n              // Spawn the shell command as a long-running child process,\n              // piping stdin/stdout/stderr. It runs alongside dev and is\n              // waited on during clean exit or killed on signal exit.\n              const shellCommand = cmdOptions.run.command;\n              const signalShellChild = (signal: NodeJS.Signals) => {\n                if (!shellChild) {\n                  return;\n                }\n                const child = shellChild;\n                // Kill the entire process group so children of the shell\n                // are also killed.\n                try {\n                  if (child.pid !== undefined) {\n                    // Kill the negative PID to signal the entire process\n                    // group. Falls back to the child directly if the\n                    // group is already gone.\n                    try {\n                      process.kill(-child.pid, signal);\n                    } catch {\n                      child.kill(signal);\n                    }\n                  } else {\n                    child.kill(signal);\n                  }\n                } catch {\n                  // Child may already be dead.\n                }\n              };\n              const clearShellSigintListener = () => {\n                if (shellSigintListener) {\n                  process.off(\"SIGINT\", shellSigintListener);\n                  shellSigintListener = undefined;\n                }\n              };\n              shellChild = spawn(shellCommand, [], {\n                shell: true,\n                stdio: \"inherit\",\n                detached: true,\n              });\n              shellSigintListener = () => {\n                clearShellSigintListener();\n                signalShellChild(\"SIGINT\");\n              };\n              process.prependListener(\"SIGINT\", shellSigintListener);\n              shellCleanupHandle = outerCtx.registerCleanup(async () => {\n                if (shellSigintListener) {\n                  clearShellSigintListener();\n                } else {\n                  // If the listener already fired (and cleared itself),\n                  // the child got SIGINT \u2014 give it a moment to exit on\n                  // its own before escalating to SIGTERM.\n                  const SIGTERM_ESCALATION_MS = 1000;\n                  await Promise.race([\n                    shellExited,\n                    new Promise((resolve) =>\n                      setTimeout(resolve, SIGTERM_ESCALATION_MS),\n                    ),\n                  ]);\n                }\n                if (shellChild) {\n                  signalShellChild(\"SIGTERM\");\n                }\n                await shellExited;\n              });\n              shellExited = new Promise<void>((resolve) => {\n                shellChild!.on(\"error\", (error) => {\n                  logError(\n                    `Failed to run command \\`${shellCommand}\\`: ${error.message}`,\n                  );\n                  shellChild = undefined;\n                  resolve();\n                  void outerCtx.flushAndExit(1);\n                });\n                shellChild!.on(\"exit\", (code, signal) => {\n                  shellChild = undefined;\n                  resolve();\n                  // If killed by a signal (e.g. from cleanup on shutdown),\n                  // don't treat it as a failure \u2014 convex dev is already\n                  // shutting down.\n                  if (signal) {\n                    return;\n                  }\n                  if (code !== null && code !== 0) {\n                    logError(\n                      `Command \\`${shellCommand}\\` exited with code ${code}`,\n                    );\n                    void outerCtx.flushAndExit(1);\n                  }\n                });\n              });\n              break;\n            }\n            default: {\n              cmdOptions.run satisfies never;\n              // Don't return this since it'll bypass the `catch` below.\n              await ctx.crash({\n                exitCode: 1,\n                errorType: \"fatal\",\n                printedMessage: `Unexpected arguments for --run`,\n                errForSentry: `Unexpected arguments for --run: ${JSON.stringify(\n                  cmdOptions.run,\n                )}`,\n              });\n            }\n          }\n          ran = true;\n        }\n        pushed = true;\n      } catch (e: any) {\n        // Crash the app on unexpected errors.\n        if (!(e instanceof Crash) || !e.errorType) {\n          // eslint-disable-next-line no-restricted-syntax\n          throw e;\n        }\n        if (e.errorType === \"fatal\") {\n          break;\n        }\n        // Retry after an exponential backoff if we hit a transient error.\n        if (e.errorType === \"transient\" || e.errorType === \"already handled\") {\n          const delay = nextBackoff(numFailures);\n          numFailures += 1;\n          if (e.errorType === \"transient\") {\n            logWarning(\n              chalkStderr.yellow(\n                `Failed due to network error, retrying in ${formatDuration(\n                  delay,\n                )}...`,\n              ),\n            );\n          }\n          await new Promise((resolve) => setTimeout(resolve, delay));\n          continue;\n        }\n\n        // Fall through if we had a filesystem-based error.\n        // TODO(sarah): Replace this with `logError`.\n        // eslint-disable-next-line no-console\n        console.assert(\n          e.errorType === \"invalid filesystem data\" ||\n            e.errorType === \"invalid filesystem or env vars\" ||\n            e.errorType[\"invalid filesystem or db data\"] !== undefined,\n        );\n        if (e.errorType === \"invalid filesystem or env vars\") {\n          shouldRetryOnDeploymentEnvVarChange = true;\n        } else if (\n          e.errorType !== \"invalid filesystem data\" &&\n          e.errorType[\"invalid filesystem or db data\"] !== undefined\n        ) {\n          tableNameTriggeringRetry =\n            e.errorType[\"invalid filesystem or db data\"];\n        }\n        if (cmdOptions.once) {\n          await outerCtx.flushAndExit(1, e.errorType);\n        }\n        // Make sure that we don't spin if this push failed\n        // in any edge cases that didn't call `logFailure`\n        // before throwing.\n        stopSpinner();\n      }\n      if (cmdOptions.once) {\n        return;\n      }\n      if (pushed && cmdOptions.untilSuccess) {\n        return;\n      }\n      const fileSystemWatch = getFileSystemWatch(ctx, watch, cmdOptions);\n      const tableWatch = getTableWatch(\n        ctx,\n        options,\n        tableNameTriggeringRetry?.tableName ?? null,\n        tableNameTriggeringRetry?.componentPath,\n      );\n      const envVarWatch = getDeplymentEnvVarWatch(\n        ctx,\n        options,\n        shouldRetryOnDeploymentEnvVarChange,\n      );\n      await Promise.race([\n        fileSystemWatch.watch(),\n        tableWatch.watch(),\n        envVarWatch.watch(),\n      ]);\n      fileSystemWatch.stop();\n      void tableWatch.stop();\n      void envVarWatch.stop();\n    }\n  } finally {\n    // On clean exit (e.g. --once, --until-success), wait for the shell\n    // command to finish naturally. Keep the SIGINT listener active so\n    // Ctrl+C during the wait still forwards to the child. On signal\n    // exit (e.g. Ctrl+C), the registered cleanup handler will have\n    // already killed it.\n    if (shellExited) {\n      await shellExited;\n    }\n    if (shellSigintListener) {\n      process.off(\"SIGINT\", shellSigintListener);\n      shellSigintListener = undefined;\n    }\n    if (shellCleanupHandle) {\n      outerCtx.removeCleanup(shellCleanupHandle);\n    }\n  }\n}\n\nasync function runFunctionInDev(\n  ctx: WatchContext,\n  credentials: {\n    url: string;\n    adminKey: string;\n  },\n  functionName: string,\n  componentPath: string | undefined,\n) {\n  await runFunctionAndLog(ctx, {\n    deploymentUrl: credentials.url,\n    adminKey: credentials.adminKey,\n    functionName,\n    argsString: \"{}\",\n    componentPath,\n    callbacks: {\n      onSuccess: () => {\n        logFinishedStep(`Finished running function \"${functionName}\"`);\n      },\n    },\n  });\n}\n\nfunction getTableWatch(\n  ctx: WatchContext,\n  credentials: {\n    url: string;\n    adminKey: string;\n  },\n  tableName: string | null,\n  componentPath: string | undefined,\n) {\n  return getFunctionWatch(ctx, {\n    deploymentUrl: credentials.url,\n    adminKey: credentials.adminKey,\n    parsedFunctionName: \"_system/cli/queryTable\",\n    getArgs: () => (tableName !== null ? { tableName } : null),\n    componentPath,\n  });\n}\n\nfunction getDeplymentEnvVarWatch(\n  ctx: WatchContext,\n  credentials: {\n    url: string;\n    adminKey: string;\n  },\n  shouldRetryOnDeploymentEnvVarChange: boolean,\n) {\n  return getFunctionWatch(ctx, {\n    deploymentUrl: credentials.url,\n    adminKey: credentials.adminKey,\n    parsedFunctionName: \"_system/cli/queryEnvironmentVariables\",\n    getArgs: () => (shouldRetryOnDeploymentEnvVarChange ? {} : null),\n    componentPath: undefined,\n  });\n}\n\nfunction getFunctionWatch(\n  ctx: WatchContext,\n  args: {\n    deploymentUrl: string;\n    adminKey: string;\n    parsedFunctionName: string;\n    getArgs: () => Record<string, Value> | null;\n    componentPath: string | undefined;\n  },\n) {\n  const [stopPromise, stop] = waitUntilCalled();\n  return {\n    watch: async () => {\n      const functionArgs = args.getArgs();\n      if (functionArgs === null) {\n        return waitForever();\n      }\n      let changes = 0;\n      return subscribe(ctx, {\n        deploymentUrl: args.deploymentUrl,\n        adminKey: args.adminKey,\n        parsedFunctionName: args.parsedFunctionName,\n        parsedFunctionArgs: functionArgs,\n        componentPath: args.componentPath,\n        until: stopPromise,\n        callbacks: {\n          onChange: () => {\n            changes++;\n            // First bump is just the initial results reporting\n            if (changes > 1) {\n              stop();\n            }\n          },\n        },\n      });\n    },\n    stop: () => {\n      stop();\n    },\n  };\n}\n\nfunction getFileSystemWatch(\n  ctx: WatchContext,\n  watch: { watcher: Watcher | undefined },\n  cmdOptions: { traceEvents: boolean },\n) {\n  let hasStopped = false;\n  return {\n    watch: async () => {\n      const observations = ctx.fs.finalize();\n      if (observations === \"invalidated\") {\n        logMessage(\"Filesystem changed during push, retrying...\");\n        return;\n      }\n      // Initialize the watcher if we haven't done it already. Chokidar expects to have a\n      // nonempty watch set at initialization, so we can't do it before running our first\n      // push.\n      if (!watch.watcher) {\n        watch.watcher = new Watcher(observations);\n        await showSpinnerIfSlow(\n          \"Preparing to watch files...\",\n          500,\n          async () => {\n            await watch.watcher!.ready();\n          },\n        );\n        stopSpinner();\n      }\n      // Watch new directories if needed.\n      watch.watcher.update(observations);\n\n      // Process events until we find one that overlaps with our previous observations.\n      let anyChanges = false;\n      do {\n        await watch.watcher.waitForEvent();\n        if (hasStopped) {\n          return;\n        }\n        for (const event of watch.watcher.drainEvents()) {\n          if (cmdOptions.traceEvents) {\n            logMessage(\n              \"Processing\",\n              event.name,\n              path.relative(\"\", event.absPath),\n            );\n          }\n          const result = observations.overlaps(event);\n          if (result.overlaps) {\n            const relPath = path.relative(\"\", event.absPath);\n            if (cmdOptions.traceEvents) {\n              logMessage(`${relPath} ${result.reason}, rebuilding...`);\n            }\n            anyChanges = true;\n            break;\n          }\n        }\n      } while (!anyChanges);\n\n      // Wait for the filesystem to quiesce before starting a new push. It's okay to\n      // drop filesystem events at this stage since we're already committed to doing\n      // a push and resubscribing based on that push's observations.\n      let deadline = performance.now() + quiescenceDelay;\n      while (true) {\n        const now = performance.now();\n        if (now >= deadline) {\n          break;\n        }\n        const remaining = deadline - now;\n        if (cmdOptions.traceEvents) {\n          logMessage(`Waiting for ${formatDuration(remaining)} to quiesce...`);\n        }\n        const remainingWait = new Promise<\"timeout\">((resolve) =>\n          setTimeout(() => resolve(\"timeout\"), deadline - now),\n        );\n        const result = await Promise.race([\n          remainingWait,\n          watch.watcher.waitForEvent().then<\"newEvents\">(() => \"newEvents\"),\n        ]);\n        if (result === \"newEvents\") {\n          for (const event of watch.watcher.drainEvents()) {\n            const result = observations.overlaps(event);\n            // Delay another `quiescenceDelay` since we had an overlapping event.\n            if (result.overlaps) {\n              if (cmdOptions.traceEvents) {\n                logMessage(\n                  `Received an overlapping event at ${event.absPath}, delaying push.`,\n                );\n              }\n              deadline = performance.now() + quiescenceDelay;\n            }\n          }\n        } else {\n          // Let the check above `break` from the loop if we're past our deadlne.\n          if (result !== \"timeout\") {\n            logError(\n              \"Assertion failed: Unexpected result from watcher: \" + result,\n            );\n          }\n        }\n      }\n    },\n    stop: () => {\n      hasStopped = true;\n    },\n  };\n}\n\nconst initialBackoff = 500;\nconst maxBackoff = 16000;\nconst quiescenceDelay = 500;\n\nexport function nextBackoff(prevFailures: number): number {\n  const baseBackoff = initialBackoff * Math.pow(2, prevFailures);\n  const actualBackoff = Math.min(baseBackoff, maxBackoff);\n  const jitter = actualBackoff * (Math.random() - 0.5);\n  return actualBackoff + jitter;\n}\n"],
+  "mappings": "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",
   "names": ["path", "result"]
 }

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

@@ -28,15 +28,18 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var envvars_exports = {};
 __export(envvars_exports, {
+  CONVEX_ACCOUNT_ENV_VAR: () => CONVEX_ACCOUNT_ENV_VAR,
   EXPECTED_CONVEX_URL_NAMES: () => EXPECTED_CONVEX_URL_NAMES,
   EXPECTED_SITE_URL_NAMES: () => EXPECTED_SITE_URL_NAMES,
   changedEnvVarFile: () => changedEnvVarFile,
   detectSuspiciousEnvironmentVariables: () => detectSuspiciousEnvironmentVariables,
   getBuildEnvironment: () => getBuildEnvironment,
   getDefaultDeployMessage: () => getDefaultDeployMessage,
+  getDeployKeySource: () => getDeployKeySource,
   getEnvVarRegex: () => getEnvVarRegex,
   gitBranchFromEnvironment: () => gitBranchFromEnvironment,
   isNonProdBuildEnvironment: () => isNonProdBuildEnvironment,
+  loadProjectEnvironmentVariables: () => loadProjectEnvironmentVariables,
   suggestedEnvVarNames: () => suggestedEnvVarNames,
   writeUrlsToEnvFile: () => writeUrlsToEnvFile
 });
@@ -45,6 +48,35 @@ var import_chalk = require("chalk");
 var dotenv = __toESM(require("dotenv"), 1);
 var import_log = require("../../bundler/log.js");
 var import_utils = require("./utils/utils.js");
+const CONVEX_ACCOUNT_ENV_VAR = "CONVEX_ACCOUNT";
+const loadedEnvironment = /* @__PURE__ */ new Map();
+function loadProjectEnvironmentVariables() {
+  for (const [name, { value }] of loadedEnvironment) {
+    if (process.env[name] === value) delete process.env[name];
+  }
+  loadedEnvironment.clear();
+  const environment = {};
+  for (const [name, value] of Object.entries(process.env)) {
+    if (value !== void 0) environment[name] = value;
+  }
+  for (const file of [import_utils.ENV_VAR_FILE_PATH, ".env"]) {
+    dotenv.config({ path: file, processEnv: environment });
+    for (const [name, value] of Object.entries(environment)) {
+      if (name !== CONVEX_ACCOUNT_ENV_VAR && process.env[name] === void 0) {
+        process.env[name] = value;
+        loadedEnvironment.set(name, { value, source: file });
+      }
+    }
+  }
+}
+function getDeployKeySource(key) {
+  const envVarName = (0, import_utils.readDeployKeyEnvVar)((name) => process.env[name])?.name ?? import_utils.CONVEX_DEPLOY_KEY_ENV_VAR_NAME;
+  const loaded = loadedEnvironment.get(envVarName);
+  return {
+    envVarName,
+    source: loaded?.value === key ? loaded.source : "shell environment"
+  };
+}
 const _FRAMEWORKS = [
   "create-react-app",
   "Next.js",

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/lib/envvars.ts"],
-  "sourcesContent": ["/**\n * Help the developer store the CONVEX_URL environment variable.\n */\nimport { chalkStderr } from \"chalk\";\nimport * as dotenv from \"dotenv\";\n\nimport { Context } from \"../../bundler/context.js\";\nimport { logWarning } from \"../../bundler/log.js\";\nimport { loadPackageJson } from \"./utils/utils.js\";\n\nconst _FRAMEWORKS = [\n  \"create-react-app\",\n  \"Next.js\",\n  \"Vite\",\n  \"Remix\",\n  \"SvelteKit\",\n  \"Expo\",\n  \"TanStackStart\",\n] as const;\ntype Framework = (typeof _FRAMEWORKS)[number];\n\n/**\n * A configuration for writing the actual (framework specific) `CONVEX_URL`\n * and `CONVEX_SITE_URL` environment variables to a \".env\" type file.\n *\n * May be `null` if there was an error determining any of the field values.\n */\ntype EnvFileUrlConfig = {\n  /** The name of the file - typically `.env.local` */\n  envFile: string;\n  /**\n   * The framework specific `CONVEX_URL`\n   *\n   * If `null`, ignore and don't update that environment variable.\n   */\n  convexUrlEnvVar: string | null;\n  /**\n   * The framework specific `CONVEX_SITE_URL`\n   *\n   * If `null`, ignore and don't update that environment variable.\n   */\n  siteUrlEnvVar: string | null;\n  /** Existing content loaded from the `envFile`, if it exists */\n  existingFileContent: string | null;\n} | null;\n\nexport async function writeUrlsToEnvFile(\n  ctx: Context,\n  options: {\n    convexUrl: string;\n    siteUrl?: string | null | undefined;\n  },\n): Promise<EnvFileUrlConfig> {\n  const envFileConfig = await loadEnvFileUrlConfig(ctx, options);\n\n  if (envFileConfig === null) {\n    return null;\n  }\n\n  const { envFile, convexUrlEnvVar, siteUrlEnvVar, existingFileContent } =\n    envFileConfig;\n  let updatedFileContent: string | null = null;\n  if (convexUrlEnvVar) {\n    updatedFileContent = changedEnvVarFile({\n      existingFileContent,\n      envVarName: convexUrlEnvVar,\n      envVarValue: options.convexUrl,\n      commentAfterValue: null,\n      commentOnPreviousLine: null,\n    })!;\n  }\n  if (siteUrlEnvVar && options.siteUrl) {\n    updatedFileContent = changedEnvVarFile({\n      existingFileContent: updatedFileContent ?? existingFileContent,\n      envVarName: siteUrlEnvVar,\n      envVarValue: options.siteUrl,\n      commentAfterValue: null,\n      commentOnPreviousLine: null,\n    })!;\n  }\n  if (updatedFileContent) {\n    ctx.fs.writeUtf8File(envFile, updatedFileContent);\n  }\n\n  return envFileConfig;\n}\n\nexport function changedEnvVarFile({\n  existingFileContent,\n  envVarName,\n  envVarValue,\n  commentAfterValue,\n  commentOnPreviousLine,\n}: {\n  existingFileContent: string | null;\n  envVarName: string;\n  envVarValue: string;\n  commentAfterValue: string | null;\n  commentOnPreviousLine: string | null;\n}): string | null {\n  const varAssignment = `${envVarName}=${envVarValue}${\n    commentAfterValue === null ? \"\" : ` # ${commentAfterValue}`\n  }`;\n  const commentOnPreviousLineWithLineBreak =\n    commentOnPreviousLine === null ? \"\" : `${commentOnPreviousLine}\\n`;\n  if (existingFileContent === null) {\n    return `${commentOnPreviousLineWithLineBreak}${varAssignment}\\n`;\n  }\n  const config = dotenv.parse(existingFileContent);\n  const existing = config[envVarName];\n  if (existing === envVarValue) {\n    return null;\n  }\n  if (existing !== undefined) {\n    return existingFileContent.replace(\n      getEnvVarRegex(envVarName),\n      `${varAssignment}`,\n    );\n  } else {\n    const doubleLineBreak = existingFileContent.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\";\n    return (\n      existingFileContent +\n      doubleLineBreak +\n      commentOnPreviousLineWithLineBreak +\n      varAssignment +\n      \"\\n\"\n    );\n  }\n}\n\nexport function getEnvVarRegex(envVarName: string) {\n  return new RegExp(`^${envVarName}.*$`, \"m\");\n}\n\nexport async function suggestedEnvVarNames(ctx: Context): Promise<{\n  detectedFramework?: Framework;\n  convexUrlEnvVar: ConvexUrlEnvVar;\n  convexSiteEnvVar: ConvexSiteUrlEnvVar;\n  frontendDevUrl?: string;\n  publicPrefix?: string;\n}> {\n  // no package.json, that's fine, just guess\n  if (!ctx.fs.exists(\"package.json\")) {\n    return {\n      convexUrlEnvVar: \"CONVEX_URL\",\n      convexSiteEnvVar: \"CONVEX_SITE_URL\",\n    };\n  }\n\n  const packages = await loadPackageJson(ctx);\n\n  // Is it create-react-app?\n  const isCreateReactApp = \"react-scripts\" in packages;\n  if (isCreateReactApp) {\n    return {\n      detectedFramework: \"create-react-app\",\n      convexUrlEnvVar: \"REACT_APP_CONVEX_URL\",\n      convexSiteEnvVar: \"REACT_APP_CONVEX_SITE_URL\",\n      frontendDevUrl: \"http://localhost:3000\",\n      publicPrefix: \"REACT_APP_\",\n    };\n  }\n\n  const isNextJs = \"next\" in packages;\n  if (isNextJs) {\n    return {\n      detectedFramework: \"Next.js\",\n      convexUrlEnvVar: \"NEXT_PUBLIC_CONVEX_URL\",\n      convexSiteEnvVar: \"NEXT_PUBLIC_CONVEX_SITE_URL\",\n      frontendDevUrl: \"http://localhost:3000\",\n      publicPrefix: \"NEXT_PUBLIC_\",\n    };\n  }\n\n  const isExpo = \"expo\" in packages;\n  if (isExpo) {\n    return {\n      detectedFramework: \"Expo\",\n      convexUrlEnvVar: \"EXPO_PUBLIC_CONVEX_URL\",\n      convexSiteEnvVar: \"EXPO_PUBLIC_CONVEX_SITE_URL\",\n      publicPrefix: \"EXPO_PUBLIC_\",\n    };\n  }\n\n  const isSvelteKit = \"@sveltejs/kit\" in packages;\n  if (isSvelteKit) {\n    return {\n      detectedFramework: \"SvelteKit\",\n      convexUrlEnvVar: \"PUBLIC_CONVEX_URL\",\n      convexSiteEnvVar: \"PUBLIC_CONVEX_SITE_URL\",\n      frontendDevUrl: \"http://localhost:5173\",\n      publicPrefix: \"PUBLIC_\",\n    };\n  }\n\n  // TanStackStart currently supports VITE_FOO for browser-side envvars.\n  const isTanStackStart =\n    \"@tanstack/start\" in packages || \"@tanstack/react-start\" in packages;\n\n  if (isTanStackStart) {\n    return {\n      detectedFramework: \"TanStackStart\",\n      convexUrlEnvVar: \"VITE_CONVEX_URL\",\n      convexSiteEnvVar: \"VITE_CONVEX_SITE_URL\",\n      frontendDevUrl: \"http://localhost:3000\",\n      publicPrefix: \"VITE_\",\n    };\n  }\n\n  // Vite is a dependency of a lot of things; vite appearing in dependencies is not a strong indicator.\n  const isVite = \"vite\" in packages;\n\n  if (isVite) {\n    return {\n      detectedFramework: \"Vite\",\n      convexUrlEnvVar: \"VITE_CONVEX_URL\",\n      convexSiteEnvVar: \"VITE_CONVEX_SITE_URL\",\n      frontendDevUrl: \"http://localhost:5173\",\n      publicPrefix: \"VITE_\",\n    };\n  }\n\n  // We detect Remix after Vite because when using Remix as a plugin of Vite\n  // (Remix Vite), we want to use Vite-style environment variables.\n  const isRemix = \"@remix-run/dev\" in packages;\n  if (isRemix) {\n    return {\n      detectedFramework: \"Remix\",\n      convexUrlEnvVar: \"CONVEX_URL\",\n      convexSiteEnvVar: \"CONVEX_SITE_URL\",\n      frontendDevUrl: \"http://localhost:3000\",\n    };\n  }\n\n  return {\n    convexUrlEnvVar: \"CONVEX_URL\",\n    convexSiteEnvVar: \"CONVEX_SITE_URL\",\n  };\n}\n\nasync function loadEnvFileUrlConfig(\n  ctx: Context,\n  options: {\n    convexUrl: string;\n    siteUrl?: string | null | undefined;\n  },\n): Promise<EnvFileUrlConfig> {\n  const { detectedFramework, convexUrlEnvVar, convexSiteEnvVar } =\n    await suggestedEnvVarNames(ctx);\n\n  const { envFile, existing } = suggestedDevEnvFile(ctx, detectedFramework);\n\n  if (!existing) {\n    return {\n      envFile,\n      convexUrlEnvVar,\n      siteUrlEnvVar: convexSiteEnvVar,\n      existingFileContent: null,\n    };\n  }\n\n  const existingFileContent = ctx.fs.readUtf8File(envFile);\n  const config = dotenv.parse(existingFileContent);\n\n  const resolvedConvexUrlEnvVar = resolveEnvVarName(\n    convexUrlEnvVar,\n    options.convexUrl,\n    envFile,\n    config,\n    EXPECTED_CONVEX_URL_NAMES,\n  );\n  const resolvedSiteUrlEnvVar = resolveEnvVarName(\n    convexSiteEnvVar,\n    options.siteUrl ?? \"\",\n    envFile,\n    config,\n    EXPECTED_SITE_URL_NAMES,\n  );\n  if (\n    resolvedConvexUrlEnvVar.kind === \"invalid\" ||\n    resolvedSiteUrlEnvVar.kind === \"invalid\"\n  ) {\n    return null;\n  }\n  return {\n    envFile,\n    convexUrlEnvVar: resolvedConvexUrlEnvVar.envVarName,\n    siteUrlEnvVar: resolvedSiteUrlEnvVar.envVarName,\n    existingFileContent,\n  };\n}\n\nfunction resolveEnvVarName(\n  envVarName: string,\n  envVarValue: string,\n  envFile: string,\n  config: dotenv.DotenvParseOutput,\n  expectedNames: Set<string>,\n):\n  | {\n      kind: \"invalid\";\n    }\n  | {\n      kind: \"valid\";\n      envVarName: string | null;\n    } {\n  const matching = Object.keys(config).filter((key) => expectedNames.has(key));\n  if (matching.length > 1) {\n    logWarning(\n      chalkStderr.yellow(\n        `Found multiple ${envVarName} environment variables in ${envFile} so cannot update automatically.`,\n      ),\n    );\n    return { kind: \"invalid\" };\n  }\n  if (matching.length === 1) {\n    const [existingEnvVarName, oldValue] = [matching[0], config[matching[0]]];\n    if (oldValue === envVarValue) {\n      // Set envVarName to null to indicate that it shouldn't be updated.\n      return { kind: \"valid\", envVarName: null };\n    }\n    if (\n      oldValue !== \"\" &&\n      Object.values(config).filter((v) => v === oldValue).length !== 1\n    ) {\n      logWarning(\n        chalkStderr.yellow(\n          `Can't safely modify ${envFile} for ${envVarName}, please edit manually.`,\n        ),\n      );\n      return { kind: \"invalid\" };\n    }\n    return { kind: \"valid\", envVarName: existingEnvVarName };\n  }\n  return { kind: \"valid\", envVarName };\n}\n\nfunction suggestedDevEnvFile(\n  ctx: Context,\n  framework?: Framework,\n): {\n  existing: boolean;\n  envFile: string;\n} {\n  // If a .env.local file exists, that's unequivocally the right file\n  if (ctx.fs.exists(\".env.local\")) {\n    return {\n      existing: true,\n      envFile: \".env.local\",\n    };\n  }\n\n  // Remix is on team \"don't commit the .env file,\" so .env is for dev.\n  if (framework === \"Remix\") {\n    return {\n      existing: ctx.fs.exists(\".env\"),\n      envFile: \".env\",\n    };\n  }\n\n  // The most dev-looking env file that exists, or .env.local\n  return {\n    existing: ctx.fs.exists(\".env.local\"),\n    envFile: \".env.local\",\n  };\n}\n\nexport const EXPECTED_CONVEX_URL_NAMES = new Set([\n  \"CONVEX_URL\" as const,\n  \"PUBLIC_CONVEX_URL\" as const,\n  \"NEXT_PUBLIC_CONVEX_URL\" as const,\n  \"VITE_CONVEX_URL\" as const,\n  \"REACT_APP_CONVEX_URL\" as const,\n  \"EXPO_PUBLIC_CONVEX_URL\" as const,\n]);\ntype ConvexUrlEnvVar =\n  typeof EXPECTED_CONVEX_URL_NAMES extends Set<infer T> ? T : never;\n\nexport const EXPECTED_SITE_URL_NAMES = new Set([\n  \"CONVEX_SITE_URL\" as const,\n  \"PUBLIC_CONVEX_SITE_URL\" as const,\n  \"NEXT_PUBLIC_CONVEX_SITE_URL\" as const,\n  \"VITE_CONVEX_SITE_URL\" as const,\n  \"REACT_APP_CONVEX_SITE_URL\" as const,\n  \"EXPO_PUBLIC_CONVEX_SITE_URL\" as const,\n]);\ntype ConvexSiteUrlEnvVar =\n  typeof EXPECTED_SITE_URL_NAMES extends Set<infer T> ? T : never;\n\n// Crash or warn on\n// CONVEX_DEPLOY_KEY=project:me:new-project|eyABCD0= npx convex\n// which parses as\n// CONVEX_DEPLOY_KEY=project:me:new-project | eyABCD0='' npx convex\n// when what was intended was\n// CONVEX_DEPLOY_KEY=project:me:new-project|eyABCD0= npx convex\n// This only fails so catastrophically when the key ends with `=`.\nexport async function detectSuspiciousEnvironmentVariables(\n  ctx: Context,\n  ignoreSuspiciousEnvVars = false,\n) {\n  for (const [key, value] of Object.entries(process.env)) {\n    if (value === \"\" && key.startsWith(\"ey\")) {\n      try {\n        // add a \"=\" to the end and try to base64 decode (expected format of Convex keys)\n        const decoded = JSON.parse(\n          Buffer.from(key + \"=\", \"base64\").toString(\"utf8\"),\n        );\n        // Only parseable v2 tokens to be sure this is a Convex token before complaining.\n        if (!(\"v2\" in decoded)) {\n          continue;\n        }\n      } catch {\n        continue;\n      }\n\n      if (ignoreSuspiciousEnvVars) {\n        logWarning(\n          `ignoring suspicious environment variable ${key}, did you mean to use quotes like CONVEX_DEPLOY_KEY='...'?`,\n        );\n      } else {\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage: `Quotes are required around environment variable values by your shell: CONVEX_DEPLOY_KEY='project:name:project|${key.slice(0, 4)}...${key.slice(key.length - 4)}=' npx convex dev`,\n        });\n      }\n    }\n  }\n}\n\nexport function getBuildEnvironment(): string | false {\n  return process.env.VERCEL\n    ? \"Vercel\"\n    : process.env.NETLIFY\n      ? \"Netlify\"\n      : process.env.CF_PAGES || process.env.WORKERS_CI\n        ? \"Cloudflare\"\n        : false;\n}\n\nexport function getDefaultDeployMessage(): string | null {\n  const platforms: Array<{\n    name: string;\n    detect: () => boolean;\n    commitShaVar: string;\n  }> = [\n    {\n      name: \"GitHub Actions\",\n      detect: () => !!process.env.GITHUB_ACTIONS,\n      commitShaVar: \"GITHUB_SHA\",\n    },\n    {\n      name: \"Vercel\",\n      detect: () => !!process.env.VERCEL,\n      commitShaVar: \"VERCEL_GIT_COMMIT_SHA\",\n    },\n    {\n      name: \"Netlify\",\n      detect: () => !!process.env.NETLIFY,\n      commitShaVar: \"COMMIT_REF\",\n    },\n    {\n      name: \"Cloudflare Pages\",\n      detect: () => !!process.env.CF_PAGES,\n      commitShaVar: \"CF_PAGES_COMMIT_SHA\",\n    },\n    {\n      name: \"Cloudflare Workers\",\n      detect: () => !!process.env.WORKERS_CI,\n      commitShaVar: \"WORKERS_CI_COMMIT_SHA\",\n    },\n    {\n      name: \"Render\",\n      detect: () => !!process.env.RENDER,\n      commitShaVar: \"RENDER_GIT_COMMIT\",\n    },\n    {\n      name: \"Railway\",\n      detect: () => !!process.env.RAILWAY_ENVIRONMENT,\n      commitShaVar: \"RAILWAY_GIT_COMMIT_SHA\",\n    },\n    {\n      name: \"GitLab CI\",\n      detect: () => !!process.env.GITLAB_CI,\n      commitShaVar: \"CI_COMMIT_SHA\",\n    },\n    {\n      name: \"CircleCI\",\n      detect: () => !!process.env.CIRCLECI,\n      commitShaVar: \"CIRCLE_SHA1\",\n    },\n    {\n      name: \"Google Cloud Build\",\n      detect: () =>\n        !!process.env.BUILD_ID &&\n        !!process.env.PROJECT_ID &&\n        !!process.env.PROJECT_NUMBER &&\n        !!process.env.LOCATION,\n      commitShaVar: \"SHORT_SHA\",\n    },\n    {\n      name: \"Heroku\",\n      detect: () => !!process.env.HEROKU_APP_NAME || !!process.env.DYNO,\n      commitShaVar: \"HEROKU_BUILD_COMMIT\",\n    },\n  ];\n\n  const platform = platforms.find((p) => p.detect());\n  if (!platform) {\n    return null;\n  }\n\n  const commitSha = process.env[platform.commitShaVar];\n  if (!commitSha) {\n    return `Deployed from ${platform.name}`;\n  }\n\n  const shortSha = commitSha.slice(0, 7);\n  return `Deployed from ${platform.name} \u2022 ${shortSha}`;\n}\n\nexport function gitBranchFromEnvironment(): string | null {\n  if (process.env.VERCEL) {\n    // https://vercel.com/docs/projects/environment-variables/system-environment-variables\n    return process.env.VERCEL_GIT_COMMIT_REF ?? null;\n  }\n  if (process.env.NETLIFY) {\n    // https://docs.netlify.com/configure-builds/environment-variables/\n    return process.env.HEAD ?? null;\n  }\n  if (process.env.CF_PAGES || process.env.WORKERS_CI) {\n    // https://developers.cloudflare.com/pages/configuration/build-configuration/#environment-variables\n    // https://developers.cloudflare.com/workers/ci-cd/builds/configuration/#environment-variables\n    return process.env.CF_PAGES_BRANCH ?? process.env.WORKERS_CI_BRANCH ?? null;\n  }\n\n  if (process.env.CI) {\n    // https://docs.github.com/en/actions/learn-github-actions/variables\n    // https://docs.gitlab.com/ee/ci/variables/predefined_variables.html\n    return (\n      process.env.GITHUB_HEAD_REF ?? process.env.CI_COMMIT_REF_NAME ?? null\n    );\n  }\n\n  return null;\n}\n\nexport function isNonProdBuildEnvironment(): boolean {\n  if (process.env.VERCEL) {\n    // https://vercel.com/docs/projects/environment-variables/system-environment-variables\n    return process.env.VERCEL_ENV !== \"production\";\n  }\n  if (process.env.NETLIFY) {\n    // https://docs.netlify.com/configure-builds/environment-variables/\n    return process.env.CONTEXT !== \"production\";\n  }\n  if (process.env.CF_PAGES || process.env.WORKERS_CI) {\n    // https://developers.cloudflare.com/pages/configuration/build-configuration/#environment-variables\n    // https://developers.cloudflare.com/workers/ci-cd/builds/configuration/#environment-variables\n    // Branch !== \"main\" is the closest heuristic; Cloudflare Pages\n    // does not expose a dedicated production/preview flag.\n    const branch = process.env.CF_PAGES_BRANCH ?? process.env.WORKERS_CI_BRANCH;\n    return branch !== \"main\";\n  }\n  return false;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Help the developer store the CONVEX_URL environment variable.\n */\nimport { chalkStderr } from \"chalk\";\nimport * as dotenv from \"dotenv\";\n\nimport { Context } from \"../../bundler/context.js\";\nimport { logWarning } from \"../../bundler/log.js\";\nimport {\n  CONVEX_DEPLOY_KEY_ENV_VAR_NAME,\n  readDeployKeyEnvVar,\n  ENV_VAR_FILE_PATH,\n  loadPackageJson,\n} from \"./utils/utils.js\";\n\nexport const CONVEX_ACCOUNT_ENV_VAR = \"CONVEX_ACCOUNT\";\n\nconst loadedEnvironment = new Map<string, { value: string; source: string }>();\n\nexport function loadProjectEnvironmentVariables() {\n  // Only remove values supplied by our previous load; later shell overrides win.\n  for (const [name, { value }] of loadedEnvironment) {\n    if (process.env[name] === value) delete process.env[name];\n  }\n  loadedEnvironment.clear();\n  const environment: Record<string, string> = {};\n  for (const [name, value] of Object.entries(process.env)) {\n    if (value !== undefined) environment[name] = value;\n  }\n  for (const file of [ENV_VAR_FILE_PATH, \".env\"]) {\n    dotenv.config({ path: file, processEnv: environment });\n    for (const [name, value] of Object.entries(environment)) {\n      // Account selection reads the current project's files directly.\n      if (name !== CONVEX_ACCOUNT_ENV_VAR && process.env[name] === undefined) {\n        process.env[name] = value;\n        loadedEnvironment.set(name, { value, source: file });\n      }\n    }\n  }\n}\n\nexport function getDeployKeySource(key: string) {\n  const envVarName =\n    readDeployKeyEnvVar((name) => process.env[name])?.name ??\n    CONVEX_DEPLOY_KEY_ENV_VAR_NAME;\n  const loaded = loadedEnvironment.get(envVarName);\n  return {\n    envVarName,\n    source: loaded?.value === key ? loaded.source : \"shell environment\",\n  };\n}\n\nconst _FRAMEWORKS = [\n  \"create-react-app\",\n  \"Next.js\",\n  \"Vite\",\n  \"Remix\",\n  \"SvelteKit\",\n  \"Expo\",\n  \"TanStackStart\",\n] as const;\ntype Framework = (typeof _FRAMEWORKS)[number];\n\n/**\n * A configuration for writing the actual (framework specific) `CONVEX_URL`\n * and `CONVEX_SITE_URL` environment variables to a \".env\" type file.\n *\n * May be `null` if there was an error determining any of the field values.\n */\ntype EnvFileUrlConfig = {\n  /** The name of the file - typically `.env.local` */\n  envFile: string;\n  /**\n   * The framework specific `CONVEX_URL`\n   *\n   * If `null`, ignore and don't update that environment variable.\n   */\n  convexUrlEnvVar: string | null;\n  /**\n   * The framework specific `CONVEX_SITE_URL`\n   *\n   * If `null`, ignore and don't update that environment variable.\n   */\n  siteUrlEnvVar: string | null;\n  /** Existing content loaded from the `envFile`, if it exists */\n  existingFileContent: string | null;\n} | null;\n\nexport async function writeUrlsToEnvFile(\n  ctx: Context,\n  options: {\n    convexUrl: string;\n    siteUrl?: string | null | undefined;\n  },\n): Promise<EnvFileUrlConfig> {\n  const envFileConfig = await loadEnvFileUrlConfig(ctx, options);\n\n  if (envFileConfig === null) {\n    return null;\n  }\n\n  const { envFile, convexUrlEnvVar, siteUrlEnvVar, existingFileContent } =\n    envFileConfig;\n  let updatedFileContent: string | null = null;\n  if (convexUrlEnvVar) {\n    updatedFileContent = changedEnvVarFile({\n      existingFileContent,\n      envVarName: convexUrlEnvVar,\n      envVarValue: options.convexUrl,\n      commentAfterValue: null,\n      commentOnPreviousLine: null,\n    })!;\n  }\n  if (siteUrlEnvVar && options.siteUrl) {\n    updatedFileContent = changedEnvVarFile({\n      existingFileContent: updatedFileContent ?? existingFileContent,\n      envVarName: siteUrlEnvVar,\n      envVarValue: options.siteUrl,\n      commentAfterValue: null,\n      commentOnPreviousLine: null,\n    })!;\n  }\n  if (updatedFileContent) {\n    ctx.fs.writeUtf8File(envFile, updatedFileContent);\n  }\n\n  return envFileConfig;\n}\n\nexport function changedEnvVarFile({\n  existingFileContent,\n  envVarName,\n  envVarValue,\n  commentAfterValue,\n  commentOnPreviousLine,\n}: {\n  existingFileContent: string | null;\n  envVarName: string;\n  envVarValue: string;\n  commentAfterValue: string | null;\n  commentOnPreviousLine: string | null;\n}): string | null {\n  const varAssignment = `${envVarName}=${envVarValue}${\n    commentAfterValue === null ? \"\" : ` # ${commentAfterValue}`\n  }`;\n  const commentOnPreviousLineWithLineBreak =\n    commentOnPreviousLine === null ? \"\" : `${commentOnPreviousLine}\\n`;\n  if (existingFileContent === null) {\n    return `${commentOnPreviousLineWithLineBreak}${varAssignment}\\n`;\n  }\n  const config = dotenv.parse(existingFileContent);\n  const existing = config[envVarName];\n  if (existing === envVarValue) {\n    return null;\n  }\n  if (existing !== undefined) {\n    return existingFileContent.replace(\n      getEnvVarRegex(envVarName),\n      `${varAssignment}`,\n    );\n  } else {\n    const doubleLineBreak = existingFileContent.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\";\n    return (\n      existingFileContent +\n      doubleLineBreak +\n      commentOnPreviousLineWithLineBreak +\n      varAssignment +\n      \"\\n\"\n    );\n  }\n}\n\nexport function getEnvVarRegex(envVarName: string) {\n  return new RegExp(`^${envVarName}.*$`, \"m\");\n}\n\nexport async function suggestedEnvVarNames(ctx: Context): Promise<{\n  detectedFramework?: Framework;\n  convexUrlEnvVar: ConvexUrlEnvVar;\n  convexSiteEnvVar: ConvexSiteUrlEnvVar;\n  frontendDevUrl?: string;\n  publicPrefix?: string;\n}> {\n  // no package.json, that's fine, just guess\n  if (!ctx.fs.exists(\"package.json\")) {\n    return {\n      convexUrlEnvVar: \"CONVEX_URL\",\n      convexSiteEnvVar: \"CONVEX_SITE_URL\",\n    };\n  }\n\n  const packages = await loadPackageJson(ctx);\n\n  // Is it create-react-app?\n  const isCreateReactApp = \"react-scripts\" in packages;\n  if (isCreateReactApp) {\n    return {\n      detectedFramework: \"create-react-app\",\n      convexUrlEnvVar: \"REACT_APP_CONVEX_URL\",\n      convexSiteEnvVar: \"REACT_APP_CONVEX_SITE_URL\",\n      frontendDevUrl: \"http://localhost:3000\",\n      publicPrefix: \"REACT_APP_\",\n    };\n  }\n\n  const isNextJs = \"next\" in packages;\n  if (isNextJs) {\n    return {\n      detectedFramework: \"Next.js\",\n      convexUrlEnvVar: \"NEXT_PUBLIC_CONVEX_URL\",\n      convexSiteEnvVar: \"NEXT_PUBLIC_CONVEX_SITE_URL\",\n      frontendDevUrl: \"http://localhost:3000\",\n      publicPrefix: \"NEXT_PUBLIC_\",\n    };\n  }\n\n  const isExpo = \"expo\" in packages;\n  if (isExpo) {\n    return {\n      detectedFramework: \"Expo\",\n      convexUrlEnvVar: \"EXPO_PUBLIC_CONVEX_URL\",\n      convexSiteEnvVar: \"EXPO_PUBLIC_CONVEX_SITE_URL\",\n      publicPrefix: \"EXPO_PUBLIC_\",\n    };\n  }\n\n  const isSvelteKit = \"@sveltejs/kit\" in packages;\n  if (isSvelteKit) {\n    return {\n      detectedFramework: \"SvelteKit\",\n      convexUrlEnvVar: \"PUBLIC_CONVEX_URL\",\n      convexSiteEnvVar: \"PUBLIC_CONVEX_SITE_URL\",\n      frontendDevUrl: \"http://localhost:5173\",\n      publicPrefix: \"PUBLIC_\",\n    };\n  }\n\n  // TanStackStart currently supports VITE_FOO for browser-side envvars.\n  const isTanStackStart =\n    \"@tanstack/start\" in packages || \"@tanstack/react-start\" in packages;\n\n  if (isTanStackStart) {\n    return {\n      detectedFramework: \"TanStackStart\",\n      convexUrlEnvVar: \"VITE_CONVEX_URL\",\n      convexSiteEnvVar: \"VITE_CONVEX_SITE_URL\",\n      frontendDevUrl: \"http://localhost:3000\",\n      publicPrefix: \"VITE_\",\n    };\n  }\n\n  // Vite is a dependency of a lot of things; vite appearing in dependencies is not a strong indicator.\n  const isVite = \"vite\" in packages;\n\n  if (isVite) {\n    return {\n      detectedFramework: \"Vite\",\n      convexUrlEnvVar: \"VITE_CONVEX_URL\",\n      convexSiteEnvVar: \"VITE_CONVEX_SITE_URL\",\n      frontendDevUrl: \"http://localhost:5173\",\n      publicPrefix: \"VITE_\",\n    };\n  }\n\n  // We detect Remix after Vite because when using Remix as a plugin of Vite\n  // (Remix Vite), we want to use Vite-style environment variables.\n  const isRemix = \"@remix-run/dev\" in packages;\n  if (isRemix) {\n    return {\n      detectedFramework: \"Remix\",\n      convexUrlEnvVar: \"CONVEX_URL\",\n      convexSiteEnvVar: \"CONVEX_SITE_URL\",\n      frontendDevUrl: \"http://localhost:3000\",\n    };\n  }\n\n  return {\n    convexUrlEnvVar: \"CONVEX_URL\",\n    convexSiteEnvVar: \"CONVEX_SITE_URL\",\n  };\n}\n\nasync function loadEnvFileUrlConfig(\n  ctx: Context,\n  options: {\n    convexUrl: string;\n    siteUrl?: string | null | undefined;\n  },\n): Promise<EnvFileUrlConfig> {\n  const { detectedFramework, convexUrlEnvVar, convexSiteEnvVar } =\n    await suggestedEnvVarNames(ctx);\n\n  const { envFile, existing } = suggestedDevEnvFile(ctx, detectedFramework);\n\n  if (!existing) {\n    return {\n      envFile,\n      convexUrlEnvVar,\n      siteUrlEnvVar: convexSiteEnvVar,\n      existingFileContent: null,\n    };\n  }\n\n  const existingFileContent = ctx.fs.readUtf8File(envFile);\n  const config = dotenv.parse(existingFileContent);\n\n  const resolvedConvexUrlEnvVar = resolveEnvVarName(\n    convexUrlEnvVar,\n    options.convexUrl,\n    envFile,\n    config,\n    EXPECTED_CONVEX_URL_NAMES,\n  );\n  const resolvedSiteUrlEnvVar = resolveEnvVarName(\n    convexSiteEnvVar,\n    options.siteUrl ?? \"\",\n    envFile,\n    config,\n    EXPECTED_SITE_URL_NAMES,\n  );\n  if (\n    resolvedConvexUrlEnvVar.kind === \"invalid\" ||\n    resolvedSiteUrlEnvVar.kind === \"invalid\"\n  ) {\n    return null;\n  }\n  return {\n    envFile,\n    convexUrlEnvVar: resolvedConvexUrlEnvVar.envVarName,\n    siteUrlEnvVar: resolvedSiteUrlEnvVar.envVarName,\n    existingFileContent,\n  };\n}\n\nfunction resolveEnvVarName(\n  envVarName: string,\n  envVarValue: string,\n  envFile: string,\n  config: dotenv.DotenvParseOutput,\n  expectedNames: Set<string>,\n):\n  | {\n      kind: \"invalid\";\n    }\n  | {\n      kind: \"valid\";\n      envVarName: string | null;\n    } {\n  const matching = Object.keys(config).filter((key) => expectedNames.has(key));\n  if (matching.length > 1) {\n    logWarning(\n      chalkStderr.yellow(\n        `Found multiple ${envVarName} environment variables in ${envFile} so cannot update automatically.`,\n      ),\n    );\n    return { kind: \"invalid\" };\n  }\n  if (matching.length === 1) {\n    const [existingEnvVarName, oldValue] = [matching[0], config[matching[0]]];\n    if (oldValue === envVarValue) {\n      // Set envVarName to null to indicate that it shouldn't be updated.\n      return { kind: \"valid\", envVarName: null };\n    }\n    if (\n      oldValue !== \"\" &&\n      Object.values(config).filter((v) => v === oldValue).length !== 1\n    ) {\n      logWarning(\n        chalkStderr.yellow(\n          `Can't safely modify ${envFile} for ${envVarName}, please edit manually.`,\n        ),\n      );\n      return { kind: \"invalid\" };\n    }\n    return { kind: \"valid\", envVarName: existingEnvVarName };\n  }\n  return { kind: \"valid\", envVarName };\n}\n\nfunction suggestedDevEnvFile(\n  ctx: Context,\n  framework?: Framework,\n): {\n  existing: boolean;\n  envFile: string;\n} {\n  // If a .env.local file exists, that's unequivocally the right file\n  if (ctx.fs.exists(\".env.local\")) {\n    return {\n      existing: true,\n      envFile: \".env.local\",\n    };\n  }\n\n  // Remix is on team \"don't commit the .env file,\" so .env is for dev.\n  if (framework === \"Remix\") {\n    return {\n      existing: ctx.fs.exists(\".env\"),\n      envFile: \".env\",\n    };\n  }\n\n  // The most dev-looking env file that exists, or .env.local\n  return {\n    existing: ctx.fs.exists(\".env.local\"),\n    envFile: \".env.local\",\n  };\n}\n\nexport const EXPECTED_CONVEX_URL_NAMES = new Set([\n  \"CONVEX_URL\" as const,\n  \"PUBLIC_CONVEX_URL\" as const,\n  \"NEXT_PUBLIC_CONVEX_URL\" as const,\n  \"VITE_CONVEX_URL\" as const,\n  \"REACT_APP_CONVEX_URL\" as const,\n  \"EXPO_PUBLIC_CONVEX_URL\" as const,\n]);\ntype ConvexUrlEnvVar =\n  typeof EXPECTED_CONVEX_URL_NAMES extends Set<infer T> ? T : never;\n\nexport const EXPECTED_SITE_URL_NAMES = new Set([\n  \"CONVEX_SITE_URL\" as const,\n  \"PUBLIC_CONVEX_SITE_URL\" as const,\n  \"NEXT_PUBLIC_CONVEX_SITE_URL\" as const,\n  \"VITE_CONVEX_SITE_URL\" as const,\n  \"REACT_APP_CONVEX_SITE_URL\" as const,\n  \"EXPO_PUBLIC_CONVEX_SITE_URL\" as const,\n]);\ntype ConvexSiteUrlEnvVar =\n  typeof EXPECTED_SITE_URL_NAMES extends Set<infer T> ? T : never;\n\n// Crash or warn on\n// CONVEX_DEPLOY_KEY=project:me:new-project|eyABCD0= npx convex\n// which parses as\n// CONVEX_DEPLOY_KEY=project:me:new-project | eyABCD0='' npx convex\n// when what was intended was\n// CONVEX_DEPLOY_KEY=project:me:new-project|eyABCD0= npx convex\n// This only fails so catastrophically when the key ends with `=`.\nexport async function detectSuspiciousEnvironmentVariables(\n  ctx: Context,\n  ignoreSuspiciousEnvVars = false,\n) {\n  for (const [key, value] of Object.entries(process.env)) {\n    if (value === \"\" && key.startsWith(\"ey\")) {\n      try {\n        // add a \"=\" to the end and try to base64 decode (expected format of Convex keys)\n        const decoded = JSON.parse(\n          Buffer.from(key + \"=\", \"base64\").toString(\"utf8\"),\n        );\n        // Only parseable v2 tokens to be sure this is a Convex token before complaining.\n        if (!(\"v2\" in decoded)) {\n          continue;\n        }\n      } catch {\n        continue;\n      }\n\n      if (ignoreSuspiciousEnvVars) {\n        logWarning(\n          `ignoring suspicious environment variable ${key}, did you mean to use quotes like CONVEX_DEPLOY_KEY='...'?`,\n        );\n      } else {\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage: `Quotes are required around environment variable values by your shell: CONVEX_DEPLOY_KEY='project:name:project|${key.slice(0, 4)}...${key.slice(key.length - 4)}=' npx convex dev`,\n        });\n      }\n    }\n  }\n}\n\nexport function getBuildEnvironment(): string | false {\n  return process.env.VERCEL\n    ? \"Vercel\"\n    : process.env.NETLIFY\n      ? \"Netlify\"\n      : process.env.CF_PAGES || process.env.WORKERS_CI\n        ? \"Cloudflare\"\n        : false;\n}\n\nexport function getDefaultDeployMessage(): string | null {\n  const platforms: Array<{\n    name: string;\n    detect: () => boolean;\n    commitShaVar: string;\n  }> = [\n    {\n      name: \"GitHub Actions\",\n      detect: () => !!process.env.GITHUB_ACTIONS,\n      commitShaVar: \"GITHUB_SHA\",\n    },\n    {\n      name: \"Vercel\",\n      detect: () => !!process.env.VERCEL,\n      commitShaVar: \"VERCEL_GIT_COMMIT_SHA\",\n    },\n    {\n      name: \"Netlify\",\n      detect: () => !!process.env.NETLIFY,\n      commitShaVar: \"COMMIT_REF\",\n    },\n    {\n      name: \"Cloudflare Pages\",\n      detect: () => !!process.env.CF_PAGES,\n      commitShaVar: \"CF_PAGES_COMMIT_SHA\",\n    },\n    {\n      name: \"Cloudflare Workers\",\n      detect: () => !!process.env.WORKERS_CI,\n      commitShaVar: \"WORKERS_CI_COMMIT_SHA\",\n    },\n    {\n      name: \"Render\",\n      detect: () => !!process.env.RENDER,\n      commitShaVar: \"RENDER_GIT_COMMIT\",\n    },\n    {\n      name: \"Railway\",\n      detect: () => !!process.env.RAILWAY_ENVIRONMENT,\n      commitShaVar: \"RAILWAY_GIT_COMMIT_SHA\",\n    },\n    {\n      name: \"GitLab CI\",\n      detect: () => !!process.env.GITLAB_CI,\n      commitShaVar: \"CI_COMMIT_SHA\",\n    },\n    {\n      name: \"CircleCI\",\n      detect: () => !!process.env.CIRCLECI,\n      commitShaVar: \"CIRCLE_SHA1\",\n    },\n    {\n      name: \"Google Cloud Build\",\n      detect: () =>\n        !!process.env.BUILD_ID &&\n        !!process.env.PROJECT_ID &&\n        !!process.env.PROJECT_NUMBER &&\n        !!process.env.LOCATION,\n      commitShaVar: \"SHORT_SHA\",\n    },\n    {\n      name: \"Heroku\",\n      detect: () => !!process.env.HEROKU_APP_NAME || !!process.env.DYNO,\n      commitShaVar: \"HEROKU_BUILD_COMMIT\",\n    },\n  ];\n\n  const platform = platforms.find((p) => p.detect());\n  if (!platform) {\n    return null;\n  }\n\n  const commitSha = process.env[platform.commitShaVar];\n  if (!commitSha) {\n    return `Deployed from ${platform.name}`;\n  }\n\n  const shortSha = commitSha.slice(0, 7);\n  return `Deployed from ${platform.name} \u2022 ${shortSha}`;\n}\n\nexport function gitBranchFromEnvironment(): string | null {\n  if (process.env.VERCEL) {\n    // https://vercel.com/docs/projects/environment-variables/system-environment-variables\n    return process.env.VERCEL_GIT_COMMIT_REF ?? null;\n  }\n  if (process.env.NETLIFY) {\n    // https://docs.netlify.com/configure-builds/environment-variables/\n    return process.env.HEAD ?? null;\n  }\n  if (process.env.CF_PAGES || process.env.WORKERS_CI) {\n    // https://developers.cloudflare.com/pages/configuration/build-configuration/#environment-variables\n    // https://developers.cloudflare.com/workers/ci-cd/builds/configuration/#environment-variables\n    return process.env.CF_PAGES_BRANCH ?? process.env.WORKERS_CI_BRANCH ?? null;\n  }\n\n  if (process.env.CI) {\n    // https://docs.github.com/en/actions/learn-github-actions/variables\n    // https://docs.gitlab.com/ee/ci/variables/predefined_variables.html\n    return (\n      process.env.GITHUB_HEAD_REF ?? process.env.CI_COMMIT_REF_NAME ?? null\n    );\n  }\n\n  return null;\n}\n\nexport function isNonProdBuildEnvironment(): boolean {\n  if (process.env.VERCEL) {\n    // https://vercel.com/docs/projects/environment-variables/system-environment-variables\n    return process.env.VERCEL_ENV !== \"production\";\n  }\n  if (process.env.NETLIFY) {\n    // https://docs.netlify.com/configure-builds/environment-variables/\n    return process.env.CONTEXT !== \"production\";\n  }\n  if (process.env.CF_PAGES || process.env.WORKERS_CI) {\n    // https://developers.cloudflare.com/pages/configuration/build-configuration/#environment-variables\n    // https://developers.cloudflare.com/workers/ci-cd/builds/configuration/#environment-variables\n    // Branch !== \"main\" is the closest heuristic; Cloudflare Pages\n    // does not expose a dedicated production/preview flag.\n    const branch = process.env.CF_PAGES_BRANCH ?? process.env.WORKERS_CI_BRANCH;\n    return branch !== \"main\";\n  }\n  return false;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,mBAA4B;AAC5B,aAAwB;AAGxB,iBAA2B;AAC3B,mBAKO;AAEA,MAAM,yBAAyB;AAEtC,MAAM,oBAAoB,oBAAI,IAA+C;AAEtE,SAAS,kCAAkC;AAEhD,aAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,mBAAmB;AACjD,QAAI,QAAQ,IAAI,IAAI,MAAM,MAAO,QAAO,QAAQ,IAAI,IAAI;AAAA,EAC1D;AACA,oBAAkB,MAAM;AACxB,QAAM,cAAsC,CAAC;AAC7C,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,QAAQ,GAAG,GAAG;AACvD,QAAI,UAAU,OAAW,aAAY,IAAI,IAAI;AAAA,EAC/C;AACA,aAAW,QAAQ,CAAC,gCAAmB,MAAM,GAAG;AAC9C,WAAO,OAAO,EAAE,MAAM,MAAM,YAAY,YAAY,CAAC;AACrD,eAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,WAAW,GAAG;AAEvD,UAAI,SAAS,0BAA0B,QAAQ,IAAI,IAAI,MAAM,QAAW;AACtE,gBAAQ,IAAI,IAAI,IAAI;AACpB,0BAAkB,IAAI,MAAM,EAAE,OAAO,QAAQ,KAAK,CAAC;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,mBAAmB,KAAa;AAC9C,QAAM,iBACJ,kCAAoB,CAAC,SAAS,QAAQ,IAAI,IAAI,CAAC,GAAG,QAClD;AACF,QAAM,SAAS,kBAAkB,IAAI,UAAU;AAC/C,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,QAAQ,UAAU,MAAM,OAAO,SAAS;AAAA,EAClD;AACF;AAEA,MAAM,cAAc;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AA4BA,eAAsB,mBACpB,KACA,SAI2B;AAC3B,QAAM,gBAAgB,MAAM,qBAAqB,KAAK,OAAO;AAE7D,MAAI,kBAAkB,MAAM;AAC1B,WAAO;AAAA,EACT;AAEA,QAAM,EAAE,SAAS,iBAAiB,eAAe,oBAAoB,IACnE;AACF,MAAI,qBAAoC;AACxC,MAAI,iBAAiB;AACnB,yBAAqB,kBAAkB;AAAA,MACrC;AAAA,MACA,YAAY;AAAA,MACZ,aAAa,QAAQ;AAAA,MACrB,mBAAmB;AAAA,MACnB,uBAAuB;AAAA,IACzB,CAAC;AAAA,EACH;AACA,MAAI,iBAAiB,QAAQ,SAAS;AACpC,yBAAqB,kBAAkB;AAAA,MACrC,qBAAqB,sBAAsB;AAAA,MAC3C,YAAY;AAAA,MACZ,aAAa,QAAQ;AAAA,MACrB,mBAAmB;AAAA,MACnB,uBAAuB;AAAA,IACzB,CAAC;AAAA,EACH;AACA,MAAI,oBAAoB;AACtB,QAAI,GAAG,cAAc,SAAS,kBAAkB;AAAA,EAClD;AAEA,SAAO;AACT;AAEO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMkB;AAChB,QAAM,gBAAgB,GAAG,UAAU,IAAI,WAAW,GAChD,sBAAsB,OAAO,KAAK,MAAM,iBAAiB,EAC3D;AACA,QAAM,qCACJ,0BAA0B,OAAO,KAAK,GAAG,qBAAqB;AAAA;AAChE,MAAI,wBAAwB,MAAM;AAChC,WAAO,GAAG,kCAAkC,GAAG,aAAa;AAAA;AAAA,EAC9D;AACA,QAAM,SAAS,OAAO,MAAM,mBAAmB;AAC/C,QAAM,WAAW,OAAO,UAAU;AAClC,MAAI,aAAa,aAAa;AAC5B,WAAO;AAAA,EACT;AACA,MAAI,aAAa,QAAW;AAC1B,WAAO,oBAAoB;AAAA,MACzB,eAAe,UAAU;AAAA,MACzB,GAAG,aAAa;AAAA,IAClB;AAAA,EACF,OAAO;AACL,UAAM,kBAAkB,oBAAoB,SAAS,IAAI,IAAI,OAAO;AACpE,WACE,sBACA,kBACA,qCACA,gBACA;AAAA,EAEJ;AACF;AAEO,SAAS,eAAe,YAAoB;AACjD,SAAO,IAAI,OAAO,IAAI,UAAU,OAAO,GAAG;AAC5C;AAEA,eAAsB,qBAAqB,KAMxC;AAED,MAAI,CAAC,IAAI,GAAG,OAAO,cAAc,GAAG;AAClC,WAAO;AAAA,MACL,iBAAiB;AAAA,MACjB,kBAAkB;AAAA,IACpB;AAAA,EACF;AAEA,QAAM,WAAW,UAAM,8BAAgB,GAAG;AAG1C,QAAM,mBAAmB,mBAAmB;AAC5C,MAAI,kBAAkB;AACpB,WAAO;AAAA,MACL,mBAAmB;AAAA,MACnB,iBAAiB;AAAA,MACjB,kBAAkB;AAAA,MAClB,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAChB;AAAA,EACF;AAEA,QAAM,WAAW,UAAU;AAC3B,MAAI,UAAU;AACZ,WAAO;AAAA,MACL,mBAAmB;AAAA,MACnB,iBAAiB;AAAA,MACjB,kBAAkB;AAAA,MAClB,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAChB;AAAA,EACF;AAEA,QAAM,SAAS,UAAU;AACzB,MAAI,QAAQ;AACV,WAAO;AAAA,MACL,mBAAmB;AAAA,MACnB,iBAAiB;AAAA,MACjB,kBAAkB;AAAA,MAClB,cAAc;AAAA,IAChB;AAAA,EACF;AAEA,QAAM,cAAc,mBAAmB;AACvC,MAAI,aAAa;AACf,WAAO;AAAA,MACL,mBAAmB;AAAA,MACnB,iBAAiB;AAAA,MACjB,kBAAkB;AAAA,MAClB,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAChB;AAAA,EACF;AAGA,QAAM,kBACJ,qBAAqB,YAAY,2BAA2B;AAE9D,MAAI,iBAAiB;AACnB,WAAO;AAAA,MACL,mBAAmB;AAAA,MACnB,iBAAiB;AAAA,MACjB,kBAAkB;AAAA,MAClB,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAChB;AAAA,EACF;AAGA,QAAM,SAAS,UAAU;AAEzB,MAAI,QAAQ;AACV,WAAO;AAAA,MACL,mBAAmB;AAAA,MACnB,iBAAiB;AAAA,MACjB,kBAAkB;AAAA,MAClB,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAChB;AAAA,EACF;AAIA,QAAM,UAAU,oBAAoB;AACpC,MAAI,SAAS;AACX,WAAO;AAAA,MACL,mBAAmB;AAAA,MACnB,iBAAiB;AAAA,MACjB,kBAAkB;AAAA,MAClB,gBAAgB;AAAA,IAClB;AAAA,EACF;AAEA,SAAO;AAAA,IACL,iBAAiB;AAAA,IACjB,kBAAkB;AAAA,EACpB;AACF;AAEA,eAAe,qBACb,KACA,SAI2B;AAC3B,QAAM,EAAE,mBAAmB,iBAAiB,iBAAiB,IAC3D,MAAM,qBAAqB,GAAG;AAEhC,QAAM,EAAE,SAAS,SAAS,IAAI,oBAAoB,KAAK,iBAAiB;AAExE,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,eAAe;AAAA,MACf,qBAAqB;AAAA,IACvB;AAAA,EACF;AAEA,QAAM,sBAAsB,IAAI,GAAG,aAAa,OAAO;AACvD,QAAM,SAAS,OAAO,MAAM,mBAAmB;AAE/C,QAAM,0BAA0B;AAAA,IAC9B;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,QAAM,wBAAwB;AAAA,IAC5B;AAAA,IACA,QAAQ,WAAW;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,MACE,wBAAwB,SAAS,aACjC,sBAAsB,SAAS,WAC/B;AACA,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL;AAAA,IACA,iBAAiB,wBAAwB;AAAA,IACzC,eAAe,sBAAsB;AAAA,IACrC;AAAA,EACF;AACF;AAEA,SAAS,kBACP,YACA,aACA,SACA,QACA,eAQI;AACJ,QAAM,WAAW,OAAO,KAAK,MAAM,EAAE,OAAO,CAAC,QAAQ,cAAc,IAAI,GAAG,CAAC;AAC3E,MAAI,SAAS,SAAS,GAAG;AACvB;AAAA,MACE,yBAAY;AAAA,QACV,kBAAkB,UAAU,6BAA6B,OAAO;AAAA,MAClE;AAAA,IACF;AACA,WAAO,EAAE,MAAM,UAAU;AAAA,EAC3B;AACA,MAAI,SAAS,WAAW,GAAG;AACzB,UAAM,CAAC,oBAAoB,QAAQ,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,SAAS,CAAC,CAAC,CAAC;AACxE,QAAI,aAAa,aAAa;AAE5B,aAAO,EAAE,MAAM,SAAS,YAAY,KAAK;AAAA,IAC3C;AACA,QACE,aAAa,MACb,OAAO,OAAO,MAAM,EAAE,OAAO,CAAC,MAAM,MAAM,QAAQ,EAAE,WAAW,GAC/D;AACA;AAAA,QACE,yBAAY;AAAA,UACV,uBAAuB,OAAO,QAAQ,UAAU;AAAA,QAClD;AAAA,MACF;AACA,aAAO,EAAE,MAAM,UAAU;AAAA,IAC3B;AACA,WAAO,EAAE,MAAM,SAAS,YAAY,mBAAmB;AAAA,EACzD;AACA,SAAO,EAAE,MAAM,SAAS,WAAW;AACrC;AAEA,SAAS,oBACP,KACA,WAIA;AAEA,MAAI,IAAI,GAAG,OAAO,YAAY,GAAG;AAC/B,WAAO;AAAA,MACL,UAAU;AAAA,MACV,SAAS;AAAA,IACX;AAAA,EACF;AAGA,MAAI,cAAc,SAAS;AACzB,WAAO;AAAA,MACL,UAAU,IAAI,GAAG,OAAO,MAAM;AAAA,MAC9B,SAAS;AAAA,IACX;AAAA,EACF;AAGA,SAAO;AAAA,IACL,UAAU,IAAI,GAAG,OAAO,YAAY;AAAA,IACpC,SAAS;AAAA,EACX;AACF;AAEO,MAAM,4BAA4B,oBAAI,IAAI;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAIM,MAAM,0BAA0B,oBAAI,IAAI;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAWD,eAAsB,qCACpB,KACA,0BAA0B,OAC1B;AACA,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,GAAG,GAAG;AACtD,QAAI,UAAU,MAAM,IAAI,WAAW,IAAI,GAAG;AACxC,UAAI;AAEF,cAAM,UAAU,KAAK;AAAA,UACnB,OAAO,KAAK,MAAM,KAAK,QAAQ,EAAE,SAAS,MAAM;AAAA,QAClD;AAEA,YAAI,EAAE,QAAQ,UAAU;AACtB;AAAA,QACF;AAAA,MACF,QAAQ;AACN;AAAA,MACF;AAEA,UAAI,yBAAyB;AAC3B;AAAA,UACE,4CAA4C,GAAG;AAAA,QACjD;AAAA,MACF,OAAO;AACL,eAAO,MAAM,IAAI,MAAM;AAAA,UACrB,UAAU;AAAA,UACV,WAAW;AAAA,UACX,gBAAgB,iHAAiH,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,MAAM,IAAI,SAAS,CAAC,CAAC;AAAA,QACjL,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,sBAAsC;AACpD,SAAO,QAAQ,IAAI,SACf,WACA,QAAQ,IAAI,UACV,YACA,QAAQ,IAAI,YAAY,QAAQ,IAAI,aAClC,eACA;AACV;AAEO,SAAS,0BAAyC;AACvD,QAAM,YAID;AAAA,IACH;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,MAAM,CAAC,CAAC,QAAQ,IAAI;AAAA,MAC5B,cAAc;AAAA,IAChB;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,MAAM,CAAC,CAAC,QAAQ,IAAI;AAAA,MAC5B,cAAc;AAAA,IAChB;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,MAAM,CAAC,CAAC,QAAQ,IAAI;AAAA,MAC5B,cAAc;AAAA,IAChB;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,MAAM,CAAC,CAAC,QAAQ,IAAI;AAAA,MAC5B,cAAc;AAAA,IAChB;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,MAAM,CAAC,CAAC,QAAQ,IAAI;AAAA,MAC5B,cAAc;AAAA,IAChB;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,MAAM,CAAC,CAAC,QAAQ,IAAI;AAAA,MAC5B,cAAc;AAAA,IAChB;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,MAAM,CAAC,CAAC,QAAQ,IAAI;AAAA,MAC5B,cAAc;AAAA,IAChB;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,MAAM,CAAC,CAAC,QAAQ,IAAI;AAAA,MAC5B,cAAc;AAAA,IAChB;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,MAAM,CAAC,CAAC,QAAQ,IAAI;AAAA,MAC5B,cAAc;AAAA,IAChB;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,MACN,CAAC,CAAC,QAAQ,IAAI,YACd,CAAC,CAAC,QAAQ,IAAI,cACd,CAAC,CAAC,QAAQ,IAAI,kBACd,CAAC,CAAC,QAAQ,IAAI;AAAA,MAChB,cAAc;AAAA,IAChB;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,MAAM,CAAC,CAAC,QAAQ,IAAI,mBAAmB,CAAC,CAAC,QAAQ,IAAI;AAAA,MAC7D,cAAc;AAAA,IAChB;AAAA,EACF;AAEA,QAAM,WAAW,UAAU,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;AACjD,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,QAAQ,IAAI,SAAS,YAAY;AACnD,MAAI,CAAC,WAAW;AACd,WAAO,iBAAiB,SAAS,IAAI;AAAA,EACvC;AAEA,QAAM,WAAW,UAAU,MAAM,GAAG,CAAC;AACrC,SAAO,iBAAiB,SAAS,IAAI,WAAM,QAAQ;AACrD;AAEO,SAAS,2BAA0C;AACxD,MAAI,QAAQ,IAAI,QAAQ;AAEtB,WAAO,QAAQ,IAAI,yBAAyB;AAAA,EAC9C;AACA,MAAI,QAAQ,IAAI,SAAS;AAEvB,WAAO,QAAQ,IAAI,QAAQ;AAAA,EAC7B;AACA,MAAI,QAAQ,IAAI,YAAY,QAAQ,IAAI,YAAY;AAGlD,WAAO,QAAQ,IAAI,mBAAmB,QAAQ,IAAI,qBAAqB;AAAA,EACzE;AAEA,MAAI,QAAQ,IAAI,IAAI;AAGlB,WACE,QAAQ,IAAI,mBAAmB,QAAQ,IAAI,sBAAsB;AAAA,EAErE;AAEA,SAAO;AACT;AAEO,SAAS,4BAAqC;AACnD,MAAI,QAAQ,IAAI,QAAQ;AAEtB,WAAO,QAAQ,IAAI,eAAe;AAAA,EACpC;AACA,MAAI,QAAQ,IAAI,SAAS;AAEvB,WAAO,QAAQ,IAAI,YAAY;AAAA,EACjC;AACA,MAAI,QAAQ,IAAI,YAAY,QAAQ,IAAI,YAAY;AAKlD,UAAM,SAAS,QAAQ,IAAI,mBAAmB,QAAQ,IAAI;AAC1D,WAAO,WAAW;AAAA,EACpB;AACA,SAAO;AACT;",
   "names": []
 }

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

@@ -0,0 +1,47 @@
+"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 formatValidationProgress_exports = {};
+__export(formatValidationProgress_exports, {
+  formatDiscardedStagedValidator: () => formatDiscardedStagedValidator,
+  formatValidationProgress: () => formatValidationProgress
+});
+module.exports = __toCommonJS(formatValidationProgress_exports);
+var import_chalk = require("chalk");
+function formatValidationProgress({
+  numDocsValidated,
+  totalDocs
+}) {
+  const checked = numDocsValidated.toLocaleString();
+  return totalDocs === null || totalDocs === void 0 ? `${checked} documents checked` : `${checked} of approximately ${totalDocs.toLocaleString()} documents checked`;
+}
+function formatDiscardedStagedValidator(validator) {
+  let status;
+  switch (validator.state.state) {
+    case "pending": {
+      status = `validating in the background (${formatValidationProgress(validator.state)})`;
+      break;
+    }
+    case "valid":
+      status = import_chalk.chalkStderr.green("validated");
+      break;
+  }
+  const action = validator.replaced ? "the push stages a different validator" : "the push removes the staged validator";
+  return `${status}; ${action}`;
+}
+//# sourceMappingURL=formatValidationProgress.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cli/lib/formatValidationProgress.ts"],
+  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { DiscardedStagedValidator } from \"./deployApi/evaluateSchema.js\";\n\nexport function formatValidationProgress({\n  numDocsValidated,\n  totalDocs,\n}: {\n  numDocsValidated: number;\n  totalDocs?: number | null | undefined;\n}): string {\n  const checked = numDocsValidated.toLocaleString();\n  return totalDocs === null || totalDocs === undefined\n    ? `${checked} documents checked`\n    : `${checked} of approximately ${totalDocs.toLocaleString()} documents checked`;\n}\n\n/** \"validated; the push removes the staged validator\" */\nexport function formatDiscardedStagedValidator(\n  validator: DiscardedStagedValidator,\n): string {\n  let status;\n  switch (validator.state.state) {\n    case \"pending\": {\n      status = `validating in the background (${formatValidationProgress(validator.state)})`;\n      break;\n    }\n    case \"valid\":\n      status = chalkStderr.green(\"validated\");\n      break;\n  }\n  const action = validator.replaced\n    ? \"the push stages a different validator\"\n    : \"the push removes the staged validator\";\n  return `${status}; ${action}`;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA4B;AAGrB,SAAS,yBAAyB;AAAA,EACvC;AAAA,EACA;AACF,GAGW;AACT,QAAM,UAAU,iBAAiB,eAAe;AAChD,SAAO,cAAc,QAAQ,cAAc,SACvC,GAAG,OAAO,uBACV,GAAG,OAAO,qBAAqB,UAAU,eAAe,CAAC;AAC/D;AAGO,SAAS,+BACd,WACQ;AACR,MAAI;AACJ,UAAQ,UAAU,MAAM,OAAO;AAAA,IAC7B,KAAK,WAAW;AACd,eAAS,iCAAiC,yBAAyB,UAAU,KAAK,CAAC;AACnF;AAAA,IACF;AAAA,IACA,KAAK;AACH,eAAS,yBAAY,MAAM,WAAW;AACtC;AAAA,EACJ;AACA,QAAM,SAAS,UAAU,WACrB,0CACA;AACJ,SAAO,GAAG,MAAM,KAAK,MAAM;AAC7B;",
+  "names": []
+}

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

@@ -38,7 +38,7 @@ function recursivelyDelete(ctx, deletePath, opts) {
   const dryRun = !!opts?.dryRun;
   let st;
   try {
-    st = ctx.fs.stat(deletePath);
+    st = opts?.followSymlinks === false ? ctx.fs.lstat(deletePath) : ctx.fs.stat(deletePath);
   } catch (err) {
     if (err.code === "ENOENT" && opts?.force) {
       return;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/lib/fsUtils.ts"],
-  "sourcesContent": ["import { Context } from \"../../bundler/context.js\";\nimport { logOutput } from \"../../bundler/log.js\";\nimport path from \"path\";\nimport { NodeFs } from \"../../bundler/fs.js\";\n\nexport function recursivelyDelete(\n  ctx: Context,\n  deletePath: string,\n  opts?: { force?: boolean; dryRun?: boolean },\n) {\n  const dryRun = !!opts?.dryRun;\n  let st;\n  try {\n    st = ctx.fs.stat(deletePath);\n  } catch (err: any) {\n    if (err.code === \"ENOENT\" && opts?.force) {\n      return;\n    }\n    // eslint-disable-next-line no-restricted-syntax\n    throw err;\n  }\n  if (st.isDirectory()) {\n    for (const entry of ctx.fs.listDir(deletePath)) {\n      recursivelyDelete(ctx, path.join(deletePath, entry.name), opts);\n    }\n    if (dryRun) {\n      logOutput(`Command would delete directory: ${deletePath}`);\n      return;\n    }\n    try {\n      ctx.fs.rmdir(deletePath);\n    } catch (err: any) {\n      if (err.code !== \"ENOENT\") {\n        // eslint-disable-next-line no-restricted-syntax\n        throw err;\n      }\n    }\n  } else {\n    if (dryRun) {\n      logOutput(`Command would delete file: ${deletePath}`);\n      return;\n    }\n    try {\n      ctx.fs.unlink(deletePath);\n    } catch (err: any) {\n      if (err.code !== \"ENOENT\") {\n        // eslint-disable-next-line no-restricted-syntax\n        throw err;\n      }\n    }\n  }\n}\n\nexport async function recursivelyCopy(\n  ctx: Context,\n  nodeFs: NodeFs,\n  src: string,\n  dest: string,\n) {\n  const st = nodeFs.stat(src);\n  if (st.isDirectory()) {\n    nodeFs.mkdir(dest, { recursive: true });\n    for (const entry of nodeFs.listDir(src)) {\n      await recursivelyCopy(\n        ctx,\n        nodeFs,\n        path.join(src, entry.name),\n        path.join(dest, entry.name),\n      );\n    }\n  } else {\n    // Don't use writeUtf8File to allow copying arbitrary files\n    await nodeFs.writeFileStream(dest, nodeFs.createReadStream(src, {}));\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,iBAA0B;AAC1B,kBAAiB;AAGV,SAAS,kBACd,KACA,YACA,MACA;AACA,QAAM,SAAS,CAAC,CAAC,MAAM;AACvB,MAAI;AACJ,MAAI;AACF,SAAK,IAAI,GAAG,KAAK,UAAU;AAAA,EAC7B,SAAS,KAAU;AACjB,QAAI,IAAI,SAAS,YAAY,MAAM,OAAO;AACxC;AAAA,IACF;AAEA,UAAM;AAAA,EACR;AACA,MAAI,GAAG,YAAY,GAAG;AACpB,eAAW,SAAS,IAAI,GAAG,QAAQ,UAAU,GAAG;AAC9C,wBAAkB,KAAK,YAAAA,QAAK,KAAK,YAAY,MAAM,IAAI,GAAG,IAAI;AAAA,IAChE;AACA,QAAI,QAAQ;AACV,gCAAU,mCAAmC,UAAU,EAAE;AACzD;AAAA,IACF;AACA,QAAI;AACF,UAAI,GAAG,MAAM,UAAU;AAAA,IACzB,SAAS,KAAU;AACjB,UAAI,IAAI,SAAS,UAAU;AAEzB,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF,OAAO;AACL,QAAI,QAAQ;AACV,gCAAU,8BAA8B,UAAU,EAAE;AACpD;AAAA,IACF;AACA,QAAI;AACF,UAAI,GAAG,OAAO,UAAU;AAAA,IAC1B,SAAS,KAAU;AACjB,UAAI,IAAI,SAAS,UAAU;AAEzB,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAsB,gBACpB,KACA,QACA,KACA,MACA;AACA,QAAM,KAAK,OAAO,KAAK,GAAG;AAC1B,MAAI,GAAG,YAAY,GAAG;AACpB,WAAO,MAAM,MAAM,EAAE,WAAW,KAAK,CAAC;AACtC,eAAW,SAAS,OAAO,QAAQ,GAAG,GAAG;AACvC,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA,YAAAA,QAAK,KAAK,KAAK,MAAM,IAAI;AAAA,QACzB,YAAAA,QAAK,KAAK,MAAM,MAAM,IAAI;AAAA,MAC5B;AAAA,IACF;AAAA,EACF,OAAO;AAEL,UAAM,OAAO,gBAAgB,MAAM,OAAO,iBAAiB,KAAK,CAAC,CAAC,CAAC;AAAA,EACrE;AACF;",
+  "sourcesContent": ["import { Context } from \"../../bundler/context.js\";\nimport { logOutput } from \"../../bundler/log.js\";\nimport path from \"path\";\nimport { NodeFs } from \"../../bundler/fs.js\";\n\nexport function recursivelyDelete(\n  ctx: Context,\n  deletePath: string,\n  opts?: { force?: boolean; dryRun?: boolean; followSymlinks?: boolean },\n) {\n  const dryRun = !!opts?.dryRun;\n  let st;\n  try {\n    st =\n      opts?.followSymlinks === false\n        ? ctx.fs.lstat(deletePath)\n        : ctx.fs.stat(deletePath);\n  } catch (err: any) {\n    if (err.code === \"ENOENT\" && opts?.force) {\n      return;\n    }\n    // eslint-disable-next-line no-restricted-syntax\n    throw err;\n  }\n  if (st.isDirectory()) {\n    for (const entry of ctx.fs.listDir(deletePath)) {\n      recursivelyDelete(ctx, path.join(deletePath, entry.name), opts);\n    }\n    if (dryRun) {\n      logOutput(`Command would delete directory: ${deletePath}`);\n      return;\n    }\n    try {\n      ctx.fs.rmdir(deletePath);\n    } catch (err: any) {\n      if (err.code !== \"ENOENT\") {\n        // eslint-disable-next-line no-restricted-syntax\n        throw err;\n      }\n    }\n  } else {\n    if (dryRun) {\n      logOutput(`Command would delete file: ${deletePath}`);\n      return;\n    }\n    try {\n      ctx.fs.unlink(deletePath);\n    } catch (err: any) {\n      if (err.code !== \"ENOENT\") {\n        // eslint-disable-next-line no-restricted-syntax\n        throw err;\n      }\n    }\n  }\n}\n\nexport async function recursivelyCopy(\n  ctx: Context,\n  nodeFs: NodeFs,\n  src: string,\n  dest: string,\n) {\n  const st = nodeFs.stat(src);\n  if (st.isDirectory()) {\n    nodeFs.mkdir(dest, { recursive: true });\n    for (const entry of nodeFs.listDir(src)) {\n      await recursivelyCopy(\n        ctx,\n        nodeFs,\n        path.join(src, entry.name),\n        path.join(dest, entry.name),\n      );\n    }\n  } else {\n    // Don't use writeUtf8File to allow copying arbitrary files\n    await nodeFs.writeFileStream(dest, nodeFs.createReadStream(src, {}));\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,iBAA0B;AAC1B,kBAAiB;AAGV,SAAS,kBACd,KACA,YACA,MACA;AACA,QAAM,SAAS,CAAC,CAAC,MAAM;AACvB,MAAI;AACJ,MAAI;AACF,SACE,MAAM,mBAAmB,QACrB,IAAI,GAAG,MAAM,UAAU,IACvB,IAAI,GAAG,KAAK,UAAU;AAAA,EAC9B,SAAS,KAAU;AACjB,QAAI,IAAI,SAAS,YAAY,MAAM,OAAO;AACxC;AAAA,IACF;AAEA,UAAM;AAAA,EACR;AACA,MAAI,GAAG,YAAY,GAAG;AACpB,eAAW,SAAS,IAAI,GAAG,QAAQ,UAAU,GAAG;AAC9C,wBAAkB,KAAK,YAAAA,QAAK,KAAK,YAAY,MAAM,IAAI,GAAG,IAAI;AAAA,IAChE;AACA,QAAI,QAAQ;AACV,gCAAU,mCAAmC,UAAU,EAAE;AACzD;AAAA,IACF;AACA,QAAI;AACF,UAAI,GAAG,MAAM,UAAU;AAAA,IACzB,SAAS,KAAU;AACjB,UAAI,IAAI,SAAS,UAAU;AAEzB,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF,OAAO;AACL,QAAI,QAAQ;AACV,gCAAU,8BAA8B,UAAU,EAAE;AACpD;AAAA,IACF;AACA,QAAI;AACF,UAAI,GAAG,OAAO,UAAU;AAAA,IAC1B,SAAS,KAAU;AACjB,UAAI,IAAI,SAAS,UAAU;AAEzB,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAsB,gBACpB,KACA,QACA,KACA,MACA;AACA,QAAM,KAAK,OAAO,KAAK,GAAG;AAC1B,MAAI,GAAG,YAAY,GAAG;AACpB,WAAO,MAAM,MAAM,EAAE,WAAW,KAAK,CAAC;AACtC,eAAW,SAAS,OAAO,QAAQ,GAAG,GAAG;AACvC,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA,YAAAA,QAAK,KAAK,KAAK,MAAM,IAAI;AAAA,QACzB,YAAAA,QAAK,KAAK,MAAM,MAAM,IAAI;AAAA,MAC5B;AAAA,IACF;AAAA,EACF,OAAO;AAEL,UAAM,OAAO,gBAAgB,MAAM,OAAO,iBAAiB,KAAK,CAAC,CAAC,CAAC;AAAA,EACrE;AACF;",
   "names": ["path"]
 }

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

@@ -201,7 +201,7 @@ function escapeMdx(text) {
 function renderCopyableCommands(text) {
   return text.split("\n").map(
     (line) => /^- /.test(line) ? line.replace(
-      /`(npx convex [^`]*)`/g,
+      /`(npx convex(?:@[^\s`]+)? [^`]*)`/g,
       (_, command) => `<CodeWithCopyButton text={${JSON.stringify(command)}} />`
     ) : line
   ).join("\n");

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/lib/generateDocs.ts"],
-  "sourcesContent": ["import type { CommandUnknownOpts } from \"@commander-js/extra-typings\";\n\nexport type GeneratedDocs = Record<string, string>;\n\ntype CommandInfo = {\n  command: CommandUnknownOpts;\n  // Full path of command names from the root, e.g. [\"convex\", \"env\", \"set\"].\n  path: string[];\n};\n\n/**\n * Generate Markdown reference docs for a Commander main command.\n *\n * Returns a map of file paths (relative, e.g. `env.mdx`) to Markdown\n * contents. One file is generated for each visible main command (a direct\n * child of the root); the root itself gets no page, so \"Command Reference\"\n * is a sidebar section with no landing page. Descendant subcommands are\n * rendered as sections inside their main command's file, with their heading\n * level reflecting their depth: a direct subcommand (`env default`) is an\n * `## h2`, a sub-subcommand (`env default set`) an `### h3`, and so on.\n *\n * Each page carries a `description` frontmatter equal to the command's\n * summary; the `/cli` page reads these back via Docusaurus metadata to render\n * the list of commands dynamically.\n */\nexport function generateDocs(root: CommandUnknownOpts): GeneratedDocs {\n  const docs: GeneratedDocs = {};\n  const all = collectCommands(root, [root.name()]);\n\n  let mainCommandPosition = 0;\n  for (const entry of all) {\n    // Skip the root command (no landing page) and any descendant beyond a\n    // main command (those are rendered inside their main command's file).\n    if (entry.path.length !== 2) continue;\n    const filePath = `${entry.path[1]}.mdx`;\n    const sidebarPosition = ++mainCommandPosition;\n    const summary =\n      entry.command.summary() || entry.command.description() || \"\";\n    // Collapse to a single line so it's a valid YAML frontmatter scalar, and\n    // quote it safely (summaries contain `[BETA]`, `:`, etc.).\n    const description = JSON.stringify(summary.replace(/\\s+/g, \" \").trim());\n\n    const lines: string[] = [];\n    const sidebarLabel = `npx ${entry.path.join(\" \")}`;\n    lines.push(\"---\");\n    lines.push(`sidebar_position: ${sidebarPosition}`);\n    // Set an explicit `title` so the Docusaurus <title> (and browser tab) reads\n    // the full command, e.g. `npx convex dev | \u2026`. Without it Docusaurus\n    // derives the title from the doc id (the file name), which would be just\n    // `dev`.\n    lines.push(`title: \"${sidebarLabel}\"`);\n    lines.push(`sidebar_label: \"${sidebarLabel}\"`);\n    lines.push(`description: ${description}`);\n    lines.push(\"---\");\n    lines.push(\"\");\n    lines.push(\n      \"{/* @generated from the command definitions, do not edit manually (run `just regenerate-cli-docs` to regenerate) */}\",\n    );\n    lines.push(\"\");\n    lines.push(renderCommand(entry, all, { headingLevel: 1 }));\n\n    const descendants = all.filter(\n      (e) =>\n        e.path.length > entry.path.length &&\n        entry.path.every((p, i) => e.path[i] === p),\n    );\n    for (const d of descendants) {\n      // Render the heading hierarchically by depth below the root: a direct\n      // subcommand (`env default`, path length 3) is an h2, a sub-subcommand\n      // (`env default set`, path length 4) is an h3, and so on. This nests\n      // sub-subcommands under their parent group instead of flattening every\n      // descendant to the same h2 level.\n      lines.push(\n        renderCommand(d, all, {\n          headingLevel: d.path.length - 1,\n          includeSubcommandsList: false,\n        }),\n      );\n    }\n\n    docs[filePath] = lines.join(\"\\n\");\n  }\n\n  return docs;\n}\n\nfunction collectCommands(\n  command: CommandUnknownOpts,\n  path: string[],\n): CommandInfo[] {\n  const result: CommandInfo[] = [{ command, path }];\n  for (const sub of command.commands) {\n    // Skip hidden commands and Commander's built-in help command.\n    if ((sub as any)._hidden) continue;\n    if (sub.name() === \"help\") continue;\n    result.push(...collectCommands(sub, [...path, sub.name()]));\n  }\n  return result;\n}\n\nfunction displayName(path: string[]): string {\n  return `npx ${path.join(\" \")}`;\n}\n\n// Build the usage suffix (everything after the command name) for the Syntax\n// code block. We derive the argument portion from the command's registered\n// arguments rather than trusting a manual `.usage()` override, so the Syntax\n// line always agrees with the Arguments section below. For example `env set`\n// overrides `.usage()` to show `<name> <value>` (pretending the args are\n// required) for nicer `--help` output, even though it registers them as\n// optional `[name] [value]`; reproducing the override verbatim would make the\n// generated page contradict itself. Commands with no registered arguments keep\n// their `.usage()` string verbatim (e.g. the root's `<command> [options]`).\nfunction commandUsage(command: CommandUnknownOpts): string {\n  const args = (command as any).registeredArguments ?? [];\n  if (args.length === 0) {\n    return command.usage();\n  }\n  // Mirror Commander's default usage order: options, then a subcommand\n  // placeholder, then the positional arguments. `[options]` is always present\n  // because the built-in `--help` option is always registered.\n  const parts = [\"[options]\"];\n  if (command.commands.length > 0) {\n    parts.push(\"[command]\");\n  }\n  for (const arg of args) {\n    const name = `${arg._name}${arg.variadic ? \"...\" : \"\"}`;\n    parts.push(arg.required ? `<${name}>` : `[${name}]`);\n  }\n  return parts.join(\" \");\n}\n\n// Anchor id for a descendant command rendered as an h2 section inside its\n// main command's file. Built from the path segments below the main command,\n// joined with `-`, so sub-subcommands stay unique. For example, both\n// `deployment create` and `deployment token create` would collide on `#create`\n// if we used only the leaf name; instead they become `#create` and\n// `#token-create`.\nfunction anchorSlug(path: string[]): string {\n  return path.slice(2).join(\"-\");\n}\n\n// Link target for a subcommand listed inside a command's \"Subcommands\"\n// section. From the root index, main commands live in sibling files. From a\n// main command page, descendants are rendered as h2 sections in the same\n// file, anchored by their path below the main command.\nfunction subcommandLink(parentPath: string[], subPath: string[]): string {\n  if (parentPath.length === 1) {\n    return `./${subPath[1]}`;\n  }\n  return `#${anchorSlug(subPath)}`;\n}\n\nfunction renderCommand(\n  entry: CommandInfo,\n  all: CommandInfo[],\n  options: { headingLevel: number; includeSubcommandsList?: boolean },\n): string {\n  const { headingLevel, includeSubcommandsList = true } = options;\n  const h1 = \"#\".repeat(headingLevel);\n  const h2 = \"#\".repeat(headingLevel + 1);\n\n  const { command, path } = entry;\n  const display = displayName(path);\n  const description = renderCopyableCommands(\n    escapeMdx(\n      formatExampleLines(\n        replaceBullets(command.description() || command.summary() || \"\"),\n      ),\n    ),\n  );\n\n  const lines: string[] = [];\n  // For nested subcommand sections, pin the heading id to the path below the\n  // main command so anchors like `#set` and `#token-create` stay unique even\n  // when leaf names collide across different parents.\n  const headingSuffix = headingLevel > 1 ? ` \\\\{#${anchorSlug(path)}}` : \"\";\n  lines.push(`${h1} \\`${display}\\`${headingSuffix}`);\n  lines.push(\"\");\n  if (description) {\n    lines.push(description);\n    lines.push(\"\");\n  }\n\n  const usage = commandUsage(command);\n  lines.push(`${h2} Syntax`);\n  lines.push(\"\");\n  lines.push(\"```sh\");\n  lines.push(`${display} ${usage}`.trim());\n  lines.push(\"```\");\n  lines.push(\"\");\n\n  const aliases = command.aliases();\n  if (aliases.length > 0) {\n    lines.push(`${h2} Aliases`);\n    lines.push(\"\");\n    for (const alias of aliases) {\n      lines.push(`- \\`${alias}\\``);\n    }\n    lines.push(\"\");\n  }\n\n  const args = (command as any).registeredArguments ?? [];\n  if (args.length > 0) {\n    lines.push(`${h2} Arguments`);\n    lines.push(\"\");\n    lines.push(\"<dl>\");\n    for (const arg of args) {\n      const name = arg.required ? `<${arg._name}>` : `[${arg._name}]`;\n      const desc = escapeMdx(replaceBullets(arg.description || \"\"));\n      lines.push(`<dt>\\`${name}\\`</dt>`);\n      lines.push(`<dd>`);\n      lines.push(\"\");\n      lines.push(desc);\n      lines.push(\"\");\n      lines.push(`</dd>`);\n    }\n    lines.push(\"</dl>\");\n    lines.push(\"\");\n  }\n\n  const opts = command.options.filter((o: any) => !o.hidden);\n  if (opts.length > 0) {\n    lines.push(`${h2} Options`);\n    lines.push(\"\");\n    lines.push(\"<dl>\");\n    for (const opt of opts) {\n      const flags = (opt as any).flags as string;\n      const desc = escapeMdx(replaceBullets(opt.description || \"\"));\n      lines.push(`<dt>\\`${flags}\\`</dt>`);\n      lines.push(`<dd>`);\n      lines.push(\"\");\n      lines.push(desc);\n      lines.push(\"\");\n      lines.push(`</dd>`);\n    }\n    lines.push(\"</dl>\");\n    lines.push(\"\");\n  }\n\n  if (includeSubcommandsList) {\n    const subEntries = all.filter(\n      (e) =>\n        e.path.length === path.length + 1 &&\n        path.every((p, i) => e.path[i] === p),\n    );\n    if (subEntries.length > 0) {\n      lines.push(`${h2} Subcommands`);\n      lines.push(\"\");\n      for (const sub of subEntries) {\n        const subDisplay = displayName(sub.path);\n        const target = subcommandLink(path, sub.path);\n        const subDesc = indentContinuation(\n          escapeMdx(sub.command.summary() || sub.command.description() || \"\"),\n        );\n        lines.push(`- [\\`${subDisplay}\\`](${target}) \u2014 ${subDesc}`.trimEnd());\n      }\n      lines.push(\"\");\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n\n// Escape characters that MDX would otherwise parse as JSX. Backslash-escaping\n// `<` and `{` keeps placeholder text like `<team_slug>` rendering as literal\n// text instead of being interpreted as a tag or expression.\n//\n// MDX only parses `<` and `{` specially in prose \u2014 inside an inline code span\n// (backticks) both are already literal, and a backslash there renders verbatim\n// (e.g. `` `\\<nameOrToken>` `` shows the backslash). So leave code spans\n// untouched and escape only the surrounding prose.\nfunction escapeMdx(text: string): string {\n  return text\n    .split(/(`[^`]*`)/)\n    .map((segment, i) =>\n      // Odd indices are the captured code spans; even indices are prose.\n      i % 2 === 1 ? segment : segment.replace(/[<{]/g, (c) => `\\\\${c}`),\n    )\n    .join(\"\");\n}\n\n// Turn inline code spans that are full `npx convex ...` commands into a\n// CodeWithCopyButton component so readers can copy them with one click. The\n// component is registered globally in the docs site's MDXComponents, so no\n// import is needed in the generated page. This runs after escapeMdx, which\n// leaves code spans verbatim, so the command text inside the backticks is\n// unescaped and drops straight into the `text` attribute.\n//\n// We pass the command as a JSX expression containing a JSON-encoded string\n// (`text={\"...\"}`) rather than a plain attribute (`text=\"...\"`) because\n// commands routinely contain double quotes (e.g. JSON arguments like\n// `'{\"body\": \"hello\"}'`), which would otherwise terminate the attribute value\n// and produce invalid MDX. JSON.stringify escapes quotes and backslashes for\n// us.\nfunction renderCopyableCommands(text: string): string {\n  return text\n    .split(\"\\n\")\n    .map((line) =>\n      /^- /.test(line)\n        ? line.replace(\n            /`(npx convex [^`]*)`/g,\n            (_, command) =>\n              `<CodeWithCopyButton text={${JSON.stringify(command)}} />`,\n          )\n        : line,\n    )\n    .join(\"\\n\");\n}\n\n// Replace \"\u2022\" bullet points with markdown \"-\" bullet points. Every line that is\n// (maybe leading spaces +) \"\u2022 \" becomes the same spaces + \"- \". This runs before\n// formatExampleLines and renderCopyableCommands so that `npx convex ...` commands\n// in bulleted help text are recognized as list items and get a copy button.\nexport function replaceBullets(text: string): string {\n  return text.replace(/^( *)\u2022 /gm, \"$1- \");\n}\n\n// Convert indented example lines (e.g., from CLI help text) into markdown lists\n// so they render with proper line breaks instead of collapsing into one line.\n// Consecutive indented lines are gathered into a block; any line indented by at\n// least two spaces belongs to the block, regardless of how deeply it nests.\n//\n// How much the block is dedented depends on what precedes it:\n//   - When the block follows a list item, its indentation encodes real nesting\n//     (a sub-list under that item), so it is preserved verbatim. This keeps a\n//     3-level list like the deploy command's preview-key description intact\n//     instead of flattening the 2-space sub-item to a top-level bullet.\n//   - When the block follows prose (or starts the text), the indentation is\n//     just help-text formatting, so the block is dedented by its smallest\n//     indent to the left margin. Otherwise an indented list wouldn't interrupt\n//     the preceding paragraph and would collapse into it.\nfunction formatExampleLines(text: string): string {\n  const lines = text.split(\"\\n\");\n  const result: string[] = [];\n  let blockLines: string[] = [];\n\n  const flushBlock = () => {\n    if (blockLines.length === 0) {\n      return;\n    }\n    const prev = result[result.length - 1];\n    const followsListItem = prev !== undefined && isListItem(prev);\n    const dedent = followsListItem\n      ? 0\n      : Math.min(...blockLines.map(indentWidth));\n    for (const blockLine of blockLines) {\n      result.push(toListItem(blockLine.substring(dedent)));\n    }\n    blockLines = [];\n  };\n\n  for (const line of lines) {\n    // Any line indented by at least two spaces (and not blank) is part of an\n    // example block, regardless of nesting depth.\n    if (/^ {2,}\\S/.test(line)) {\n      blockLines.push(line);\n    } else {\n      flushBlock();\n      result.push(line);\n    }\n  }\n  flushBlock();\n\n  return result.join(\"\\n\");\n}\n\nfunction indentWidth(line: string): number {\n  return line.length - line.trimStart().length;\n}\n\nfunction isListItem(line: string): boolean {\n  const content = line.trimStart();\n  return content.startsWith(\"- \") || /^\\d+\\.\\s/.test(content);\n}\n\n// Render an example line as a markdown list item, preserving any leading indent\n// so nested items stay nested. Lines that are already list items \u2014 either a\n// bullet (`- `) or an ordered-list item (`1. `) \u2014 are kept verbatim so they\n// render as their intended list type. Prefixing an ordered-list item with `- `\n// would nest it inside a bullet, which renders as roman numerals instead of the\n// numbered steps.\nfunction toListItem(line: string): string {\n  if (isListItem(line)) {\n    return line;\n  }\n  const indent = line.slice(0, indentWidth(line));\n  return `${indent}- ${line.trimStart()}`;\n}\n\nfunction indentContinuation(text: string): string {\n  return text.replace(/\\n/g, \"\\n  \");\n}\n"],
+  "sourcesContent": ["import type { CommandUnknownOpts } from \"@commander-js/extra-typings\";\n\nexport type GeneratedDocs = Record<string, string>;\n\ntype CommandInfo = {\n  command: CommandUnknownOpts;\n  // Full path of command names from the root, e.g. [\"convex\", \"env\", \"set\"].\n  path: string[];\n};\n\n/**\n * Generate Markdown reference docs for a Commander main command.\n *\n * Returns a map of file paths (relative, e.g. `env.mdx`) to Markdown\n * contents. One file is generated for each visible main command (a direct\n * child of the root); the root itself gets no page, so \"Command Reference\"\n * is a sidebar section with no landing page. Descendant subcommands are\n * rendered as sections inside their main command's file, with their heading\n * level reflecting their depth: a direct subcommand (`env default`) is an\n * `## h2`, a sub-subcommand (`env default set`) an `### h3`, and so on.\n *\n * Each page carries a `description` frontmatter equal to the command's\n * summary; the `/cli` page reads these back via Docusaurus metadata to render\n * the list of commands dynamically.\n */\nexport function generateDocs(root: CommandUnknownOpts): GeneratedDocs {\n  const docs: GeneratedDocs = {};\n  const all = collectCommands(root, [root.name()]);\n\n  let mainCommandPosition = 0;\n  for (const entry of all) {\n    // Skip the root command (no landing page) and any descendant beyond a\n    // main command (those are rendered inside their main command's file).\n    if (entry.path.length !== 2) continue;\n    const filePath = `${entry.path[1]}.mdx`;\n    const sidebarPosition = ++mainCommandPosition;\n    const summary =\n      entry.command.summary() || entry.command.description() || \"\";\n    // Collapse to a single line so it's a valid YAML frontmatter scalar, and\n    // quote it safely (summaries contain `[BETA]`, `:`, etc.).\n    const description = JSON.stringify(summary.replace(/\\s+/g, \" \").trim());\n\n    const lines: string[] = [];\n    const sidebarLabel = `npx ${entry.path.join(\" \")}`;\n    lines.push(\"---\");\n    lines.push(`sidebar_position: ${sidebarPosition}`);\n    // Set an explicit `title` so the Docusaurus <title> (and browser tab) reads\n    // the full command, e.g. `npx convex dev | \u2026`. Without it Docusaurus\n    // derives the title from the doc id (the file name), which would be just\n    // `dev`.\n    lines.push(`title: \"${sidebarLabel}\"`);\n    lines.push(`sidebar_label: \"${sidebarLabel}\"`);\n    lines.push(`description: ${description}`);\n    lines.push(\"---\");\n    lines.push(\"\");\n    lines.push(\n      \"{/* @generated from the command definitions, do not edit manually (run `just regenerate-cli-docs` to regenerate) */}\",\n    );\n    lines.push(\"\");\n    lines.push(renderCommand(entry, all, { headingLevel: 1 }));\n\n    const descendants = all.filter(\n      (e) =>\n        e.path.length > entry.path.length &&\n        entry.path.every((p, i) => e.path[i] === p),\n    );\n    for (const d of descendants) {\n      // Render the heading hierarchically by depth below the root: a direct\n      // subcommand (`env default`, path length 3) is an h2, a sub-subcommand\n      // (`env default set`, path length 4) is an h3, and so on. This nests\n      // sub-subcommands under their parent group instead of flattening every\n      // descendant to the same h2 level.\n      lines.push(\n        renderCommand(d, all, {\n          headingLevel: d.path.length - 1,\n          includeSubcommandsList: false,\n        }),\n      );\n    }\n\n    docs[filePath] = lines.join(\"\\n\");\n  }\n\n  return docs;\n}\n\nfunction collectCommands(\n  command: CommandUnknownOpts,\n  path: string[],\n): CommandInfo[] {\n  const result: CommandInfo[] = [{ command, path }];\n  for (const sub of command.commands) {\n    // Skip hidden commands and Commander's built-in help command.\n    if ((sub as any)._hidden) continue;\n    if (sub.name() === \"help\") continue;\n    result.push(...collectCommands(sub, [...path, sub.name()]));\n  }\n  return result;\n}\n\nfunction displayName(path: string[]): string {\n  return `npx ${path.join(\" \")}`;\n}\n\n// Build the usage suffix (everything after the command name) for the Syntax\n// code block. We derive the argument portion from the command's registered\n// arguments rather than trusting a manual `.usage()` override, so the Syntax\n// line always agrees with the Arguments section below. For example `env set`\n// overrides `.usage()` to show `<name> <value>` (pretending the args are\n// required) for nicer `--help` output, even though it registers them as\n// optional `[name] [value]`; reproducing the override verbatim would make the\n// generated page contradict itself. Commands with no registered arguments keep\n// their `.usage()` string verbatim (e.g. the root's `<command> [options]`).\nfunction commandUsage(command: CommandUnknownOpts): string {\n  const args = (command as any).registeredArguments ?? [];\n  if (args.length === 0) {\n    return command.usage();\n  }\n  // Mirror Commander's default usage order: options, then a subcommand\n  // placeholder, then the positional arguments. `[options]` is always present\n  // because the built-in `--help` option is always registered.\n  const parts = [\"[options]\"];\n  if (command.commands.length > 0) {\n    parts.push(\"[command]\");\n  }\n  for (const arg of args) {\n    const name = `${arg._name}${arg.variadic ? \"...\" : \"\"}`;\n    parts.push(arg.required ? `<${name}>` : `[${name}]`);\n  }\n  return parts.join(\" \");\n}\n\n// Anchor id for a descendant command rendered as an h2 section inside its\n// main command's file. Built from the path segments below the main command,\n// joined with `-`, so sub-subcommands stay unique. For example, both\n// `deployment create` and `deployment token create` would collide on `#create`\n// if we used only the leaf name; instead they become `#create` and\n// `#token-create`.\nfunction anchorSlug(path: string[]): string {\n  return path.slice(2).join(\"-\");\n}\n\n// Link target for a subcommand listed inside a command's \"Subcommands\"\n// section. From the root index, main commands live in sibling files. From a\n// main command page, descendants are rendered as h2 sections in the same\n// file, anchored by their path below the main command.\nfunction subcommandLink(parentPath: string[], subPath: string[]): string {\n  if (parentPath.length === 1) {\n    return `./${subPath[1]}`;\n  }\n  return `#${anchorSlug(subPath)}`;\n}\n\nfunction renderCommand(\n  entry: CommandInfo,\n  all: CommandInfo[],\n  options: { headingLevel: number; includeSubcommandsList?: boolean },\n): string {\n  const { headingLevel, includeSubcommandsList = true } = options;\n  const h1 = \"#\".repeat(headingLevel);\n  const h2 = \"#\".repeat(headingLevel + 1);\n\n  const { command, path } = entry;\n  const display = displayName(path);\n  const description = renderCopyableCommands(\n    escapeMdx(\n      formatExampleLines(\n        replaceBullets(command.description() || command.summary() || \"\"),\n      ),\n    ),\n  );\n\n  const lines: string[] = [];\n  // For nested subcommand sections, pin the heading id to the path below the\n  // main command so anchors like `#set` and `#token-create` stay unique even\n  // when leaf names collide across different parents.\n  const headingSuffix = headingLevel > 1 ? ` \\\\{#${anchorSlug(path)}}` : \"\";\n  lines.push(`${h1} \\`${display}\\`${headingSuffix}`);\n  lines.push(\"\");\n  if (description) {\n    lines.push(description);\n    lines.push(\"\");\n  }\n\n  const usage = commandUsage(command);\n  lines.push(`${h2} Syntax`);\n  lines.push(\"\");\n  lines.push(\"```sh\");\n  lines.push(`${display} ${usage}`.trim());\n  lines.push(\"```\");\n  lines.push(\"\");\n\n  const aliases = command.aliases();\n  if (aliases.length > 0) {\n    lines.push(`${h2} Aliases`);\n    lines.push(\"\");\n    for (const alias of aliases) {\n      lines.push(`- \\`${alias}\\``);\n    }\n    lines.push(\"\");\n  }\n\n  const args = (command as any).registeredArguments ?? [];\n  if (args.length > 0) {\n    lines.push(`${h2} Arguments`);\n    lines.push(\"\");\n    lines.push(\"<dl>\");\n    for (const arg of args) {\n      const name = arg.required ? `<${arg._name}>` : `[${arg._name}]`;\n      const desc = escapeMdx(replaceBullets(arg.description || \"\"));\n      lines.push(`<dt>\\`${name}\\`</dt>`);\n      lines.push(`<dd>`);\n      lines.push(\"\");\n      lines.push(desc);\n      lines.push(\"\");\n      lines.push(`</dd>`);\n    }\n    lines.push(\"</dl>\");\n    lines.push(\"\");\n  }\n\n  const opts = command.options.filter((o: any) => !o.hidden);\n  if (opts.length > 0) {\n    lines.push(`${h2} Options`);\n    lines.push(\"\");\n    lines.push(\"<dl>\");\n    for (const opt of opts) {\n      const flags = (opt as any).flags as string;\n      const desc = escapeMdx(replaceBullets(opt.description || \"\"));\n      lines.push(`<dt>\\`${flags}\\`</dt>`);\n      lines.push(`<dd>`);\n      lines.push(\"\");\n      lines.push(desc);\n      lines.push(\"\");\n      lines.push(`</dd>`);\n    }\n    lines.push(\"</dl>\");\n    lines.push(\"\");\n  }\n\n  if (includeSubcommandsList) {\n    const subEntries = all.filter(\n      (e) =>\n        e.path.length === path.length + 1 &&\n        path.every((p, i) => e.path[i] === p),\n    );\n    if (subEntries.length > 0) {\n      lines.push(`${h2} Subcommands`);\n      lines.push(\"\");\n      for (const sub of subEntries) {\n        const subDisplay = displayName(sub.path);\n        const target = subcommandLink(path, sub.path);\n        const subDesc = indentContinuation(\n          escapeMdx(sub.command.summary() || sub.command.description() || \"\"),\n        );\n        lines.push(`- [\\`${subDisplay}\\`](${target}) \u2014 ${subDesc}`.trimEnd());\n      }\n      lines.push(\"\");\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n\n// Escape characters that MDX would otherwise parse as JSX. Backslash-escaping\n// `<` and `{` keeps placeholder text like `<team_slug>` rendering as literal\n// text instead of being interpreted as a tag or expression.\n//\n// MDX only parses `<` and `{` specially in prose \u2014 inside an inline code span\n// (backticks) both are already literal, and a backslash there renders verbatim\n// (e.g. `` `\\<nameOrToken>` `` shows the backslash). So leave code spans\n// untouched and escape only the surrounding prose.\nfunction escapeMdx(text: string): string {\n  return text\n    .split(/(`[^`]*`)/)\n    .map((segment, i) =>\n      // Odd indices are the captured code spans; even indices are prose.\n      i % 2 === 1 ? segment : segment.replace(/[<{]/g, (c) => `\\\\${c}`),\n    )\n    .join(\"\");\n}\n\n// Turn inline code spans that are full `npx convex ...` commands into a\n// CodeWithCopyButton component so readers can copy them with one click. The\n// component is registered globally in the docs site's MDXComponents, so no\n// import is needed in the generated page. This runs after escapeMdx, which\n// leaves code spans verbatim, so the command text inside the backticks is\n// unescaped and drops straight into the `text` attribute.\n//\n// We pass the command as a JSX expression containing a JSON-encoded string\n// (`text={\"...\"}`) rather than a plain attribute (`text=\"...\"`) because\n// commands routinely contain double quotes (e.g. JSON arguments like\n// `'{\"body\": \"hello\"}'`), which would otherwise terminate the attribute value\n// and produce invalid MDX. JSON.stringify escapes quotes and backslashes for\n// us.\nfunction renderCopyableCommands(text: string): string {\n  return text\n    .split(\"\\n\")\n    .map((line) =>\n      /^- /.test(line)\n        ? line.replace(\n            /`(npx convex(?:@[^\\s`]+)? [^`]*)`/g,\n            (_, command) =>\n              `<CodeWithCopyButton text={${JSON.stringify(command)}} />`,\n          )\n        : line,\n    )\n    .join(\"\\n\");\n}\n\n// Replace \"\u2022\" bullet points with markdown \"-\" bullet points. Every line that is\n// (maybe leading spaces +) \"\u2022 \" becomes the same spaces + \"- \". This runs before\n// formatExampleLines and renderCopyableCommands so that `npx convex ...` commands\n// in bulleted help text are recognized as list items and get a copy button.\nexport function replaceBullets(text: string): string {\n  return text.replace(/^( *)\u2022 /gm, \"$1- \");\n}\n\n// Convert indented example lines (e.g., from CLI help text) into markdown lists\n// so they render with proper line breaks instead of collapsing into one line.\n// Consecutive indented lines are gathered into a block; any line indented by at\n// least two spaces belongs to the block, regardless of how deeply it nests.\n//\n// How much the block is dedented depends on what precedes it:\n//   - When the block follows a list item, its indentation encodes real nesting\n//     (a sub-list under that item), so it is preserved verbatim. This keeps a\n//     3-level list like the deploy command's preview-key description intact\n//     instead of flattening the 2-space sub-item to a top-level bullet.\n//   - When the block follows prose (or starts the text), the indentation is\n//     just help-text formatting, so the block is dedented by its smallest\n//     indent to the left margin. Otherwise an indented list wouldn't interrupt\n//     the preceding paragraph and would collapse into it.\nfunction formatExampleLines(text: string): string {\n  const lines = text.split(\"\\n\");\n  const result: string[] = [];\n  let blockLines: string[] = [];\n\n  const flushBlock = () => {\n    if (blockLines.length === 0) {\n      return;\n    }\n    const prev = result[result.length - 1];\n    const followsListItem = prev !== undefined && isListItem(prev);\n    const dedent = followsListItem\n      ? 0\n      : Math.min(...blockLines.map(indentWidth));\n    for (const blockLine of blockLines) {\n      result.push(toListItem(blockLine.substring(dedent)));\n    }\n    blockLines = [];\n  };\n\n  for (const line of lines) {\n    // Any line indented by at least two spaces (and not blank) is part of an\n    // example block, regardless of nesting depth.\n    if (/^ {2,}\\S/.test(line)) {\n      blockLines.push(line);\n    } else {\n      flushBlock();\n      result.push(line);\n    }\n  }\n  flushBlock();\n\n  return result.join(\"\\n\");\n}\n\nfunction indentWidth(line: string): number {\n  return line.length - line.trimStart().length;\n}\n\nfunction isListItem(line: string): boolean {\n  const content = line.trimStart();\n  return content.startsWith(\"- \") || /^\\d+\\.\\s/.test(content);\n}\n\n// Render an example line as a markdown list item, preserving any leading indent\n// so nested items stay nested. Lines that are already list items \u2014 either a\n// bullet (`- `) or an ordered-list item (`1. `) \u2014 are kept verbatim so they\n// render as their intended list type. Prefixing an ordered-list item with `- `\n// would nest it inside a bullet, which renders as roman numerals instead of the\n// numbered steps.\nfunction toListItem(line: string): string {\n  if (isListItem(line)) {\n    return line;\n  }\n  const indent = line.slice(0, indentWidth(line));\n  return `${indent}- ${line.trimStart()}`;\n}\n\nfunction indentContinuation(text: string): string {\n  return text.replace(/\\n/g, \"\\n  \");\n}\n"],
   "mappings": "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",
   "names": []
 }

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/lib/indexes.ts"],
-  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { deploymentDashboardUrlPage } from \"./dashboard.js\";\nimport { DeveloperIndexConfig } from \"./deployApi/finishPush.js\";\n\nexport type IndexMetadata = {\n  table: string;\n  name: string;\n  fields:\n    | string[]\n    | {\n        searchField: string;\n        filterFields: string[];\n      }\n    | {\n        dimensions: number;\n        vectorField: string;\n        filterFields: string[];\n      };\n  backfill: {\n    state: \"in_progress\" | \"done\";\n  };\n  staged: boolean;\n};\n\nexport type LargeIndexDeletionCheck =\n  // Don\u2019t verify whether large indexes have been deleted\n  | \"no verification\"\n  // If large indexes are being deleted, ask for confirmation (and fail in non-interactive envs)\n  | \"ask for confirmation\"\n  // If large indexes are being deleted, confirm (the user has used --allow-deleting-large-indexes)\n  | \"has confirmation\";\n\nexport function addProgressLinkIfSlow(\n  msg: string,\n  deploymentName: string | null,\n  start: number,\n): string {\n  if (Date.now() - start > 10_000) {\n    const dashboardUrl = deploymentDashboardUrlPage(\n      deploymentName,\n      `/schema?showSchema=true`,\n    );\n    msg = msg.concat(`\\nSee progress here: ${dashboardUrl}`);\n  }\n  return msg;\n}\n\nexport function formatIndex(index: DeveloperIndexConfig) {\n  const [tableName, indexName] = index.name.split(\".\");\n  return `${tableName}.${chalkStderr.bold(indexName)} ${chalkStderr.gray(formatIndexFields(index))}${index.staged ? chalkStderr.blue(\"  (staged)\") : \"\"}`;\n}\n\nfunction formatIndexFields(index: DeveloperIndexConfig) {\n  switch (index.type) {\n    case \"database\":\n      return (\n        \"  \" + index.fields.map((f) => chalkStderr.underline(f)).join(\", \")\n      );\n    case \"search\":\n      return `${chalkStderr.cyan(\"(text)\")}   ${chalkStderr.underline(index.searchField)}${formatFilterFields(index.filterFields)}`;\n    case \"vector\":\n      return `${chalkStderr.cyan(\"(vector)\")}   ${chalkStderr.underline(index.vectorField)} (${index.dimensions} dimensions)${formatFilterFields(index.filterFields)}`;\n    default:\n      index satisfies never;\n      return \"\";\n  }\n}\n\nfunction formatFilterFields(filterFields: string[]) {\n  if (filterFields.length === 0) {\n    return \"\";\n  }\n  return `, filter${filterFields.length === 1 ? \"\" : \"s\"} on ${filterFields.map((f) => chalkStderr.underline(f)).join(\", \")}`;\n}\n"],
+  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { deploymentDashboardUrlPage } from \"./dashboard.js\";\nimport { DeveloperIndexConfig } from \"./deployApi/finishPush.js\";\n\nexport type IndexMetadata = {\n  table: string;\n  name: string;\n  fields:\n    | string[]\n    | {\n        searchField: string;\n        filterFields: string[];\n      }\n    | {\n        dimensions: number;\n        vectorField: string;\n        filterFields: string[];\n      };\n  backfill: {\n    state: \"in_progress\" | \"done\";\n  };\n  staged: boolean;\n};\n\nexport type LargeIndexDeletionCheck =\n  // Don\u2019t verify whether large indexes have been deleted\n  | \"no verification\"\n  // If large indexes are being deleted, ask for confirmation (and fail in non-interactive envs)\n  | \"ask for confirmation\"\n  // If large indexes are being deleted, confirm (the user has used --skip-large-indexes-check)\n  | \"has confirmation\";\n\nexport function addProgressLinkIfSlow(\n  msg: string,\n  deploymentName: string | null,\n  start: number,\n): string {\n  if (Date.now() - start > 10_000) {\n    const dashboardUrl = deploymentDashboardUrlPage(\n      deploymentName,\n      `/schema?showSchema=true`,\n    );\n    msg = msg.concat(`\\nSee progress here: ${dashboardUrl}`);\n  }\n  return msg;\n}\n\nexport function formatIndex(index: DeveloperIndexConfig) {\n  const [tableName, indexName] = index.name.split(\".\");\n  return `${tableName}.${chalkStderr.bold(indexName)} ${chalkStderr.gray(formatIndexFields(index))}${index.staged ? chalkStderr.blue(\"  (staged)\") : \"\"}`;\n}\n\nfunction formatIndexFields(index: DeveloperIndexConfig) {\n  switch (index.type) {\n    case \"database\":\n      return (\n        \"  \" + index.fields.map((f) => chalkStderr.underline(f)).join(\", \")\n      );\n    case \"search\":\n      return `${chalkStderr.cyan(\"(text)\")}   ${chalkStderr.underline(index.searchField)}${formatFilterFields(index.filterFields)}`;\n    case \"vector\":\n      return `${chalkStderr.cyan(\"(vector)\")}   ${chalkStderr.underline(index.vectorField)} (${index.dimensions} dimensions)${formatFilterFields(index.filterFields)}`;\n    default:\n      index satisfies never;\n      return \"\";\n  }\n}\n\nfunction formatFilterFields(filterFields: string[]) {\n  if (filterFields.length === 0) {\n    return \"\";\n  }\n  return `, filter${filterFields.length === 1 ? \"\" : \"s\"} on ${filterFields.map((f) => chalkStderr.underline(f)).join(\", \")}`;\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA4B;AAC5B,uBAA2C;AA+BpC,SAAS,sBACd,KACA,gBACA,OACQ;AACR,MAAI,KAAK,IAAI,IAAI,QAAQ,KAAQ;AAC/B,UAAM,mBAAe;AAAA,MACnB;AAAA,MACA;AAAA,IACF;AACA,UAAM,IAAI,OAAO;AAAA,qBAAwB,YAAY,EAAE;AAAA,EACzD;AACA,SAAO;AACT;AAEO,SAAS,YAAY,OAA6B;AACvD,QAAM,CAAC,WAAW,SAAS,IAAI,MAAM,KAAK,MAAM,GAAG;AACnD,SAAO,GAAG,SAAS,IAAI,yBAAY,KAAK,SAAS,CAAC,IAAI,yBAAY,KAAK,kBAAkB,KAAK,CAAC,CAAC,GAAG,MAAM,SAAS,yBAAY,KAAK,YAAY,IAAI,EAAE;AACvJ;AAEA,SAAS,kBAAkB,OAA6B;AACtD,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aACE,OAAO,MAAM,OAAO,IAAI,CAAC,MAAM,yBAAY,UAAU,CAAC,CAAC,EAAE,KAAK,IAAI;AAAA,IAEtE,KAAK;AACH,aAAO,GAAG,yBAAY,KAAK,QAAQ,CAAC,MAAM,yBAAY,UAAU,MAAM,WAAW,CAAC,GAAG,mBAAmB,MAAM,YAAY,CAAC;AAAA,IAC7H,KAAK;AACH,aAAO,GAAG,yBAAY,KAAK,UAAU,CAAC,MAAM,yBAAY,UAAU,MAAM,WAAW,CAAC,KAAK,MAAM,UAAU,eAAe,mBAAmB,MAAM,YAAY,CAAC;AAAA,IAChK;AACE;AACA,aAAO;AAAA,EACX;AACF;AAEA,SAAS,mBAAmB,cAAwB;AAClD,MAAI,aAAa,WAAW,GAAG;AAC7B,WAAO;AAAA,EACT;AACA,SAAO,WAAW,aAAa,WAAW,IAAI,KAAK,GAAG,OAAO,aAAa,IAAI,CAAC,MAAM,yBAAY,UAAU,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;AAC3H;",
   "names": []
 }