convex 1.40.0 → 1.41.0

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/dev.ts"],
-  "sourcesContent": ["import { Command, Option } from \"@commander-js/extra-typings\";\nimport { chalkStderr } from \"chalk\";\nimport { installSigintHandler, oneoffContext } from \"../bundler/context.js\";\nimport { deploymentCredentialsOrConfigure } from \"./configure.js\";\nimport { announceDeploymentTarget } from \"./lib/announceDeploymentTarget.js\";\nimport { usageStateWarning } from \"./lib/usage.js\";\nimport { normalizeDevOptions } from \"./lib/command.js\";\nimport { devAgainstDeployment } from \"./lib/dev.js\";\nimport {\n  CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n  CONVEX_SELF_HOSTED_URL_VAR_NAME,\n} from \"./lib/utils/utils.js\";\nimport {\n  getDeploymentSelection,\n  type DeploymentSelection,\n} from \"./lib/deploymentSelection.js\";\nimport { checkVersionAndAiFilesStaleness } from \"./lib/updates.js\";\n\nexport const dev = new Command(\"dev\")\n  .summary(\"Develop against a dev deployment, watching for changes\")\n  .description(\n    \"Develop against a dev deployment, watching for changes\\n\\n\" +\n      \"  1. Configures a new or existing project (if needed)\\n\" +\n      \"  2. Updates generated types and pushes code to the configured dev deployment\\n\" +\n      \"  3. Runs the provided command (if `--start` or `--run` is used)\\n\" +\n      \"  4. Watches for file changes, and repeats step 2\\n\",\n  )\n  .allowExcessArguments(false)\n  .option(\"-v, --verbose\", \"Show full listing of changes\")\n  .addOption(\n    new Option(\n      \"--typecheck <mode>\",\n      `Check TypeScript files with \\`tsc --noEmit\\`.`,\n    )\n      .choices([\"enable\", \"try\", \"disable\"] as const)\n      .default(\"try\" as const),\n  )\n  .option(\n    \"--typecheck-components\",\n    \"Check TypeScript files within component implementations with `tsc --noEmit`.\",\n    false,\n  )\n  .addOption(\n    new Option(\"--codegen <mode>\", \"Regenerate code in `convex/_generated/`\")\n      .choices([\"enable\", \"disable\"] as const)\n      .default(\"enable\" as const),\n  )\n  .addOption(\n    new Option(\n      \"--push-all-modules\",\n      \"Push all modules without checking for unchanged module hashes from the server\",\n    )\n      .default(false)\n      .hideHelp(),\n  )\n  .option(\n    \"--once\",\n    \"Execute only the first 3 steps, stop on any failure\",\n    false,\n  )\n  .option(\n    \"--until-success\",\n    \"Execute only the first 3 steps, on failure watch for local and remote changes and retry steps 2 and 3\",\n    false,\n  )\n  .addOption(\n    new Option(\n      \"--start <command>\",\n      \"Start a long-running command alongside `convex dev`, like a frontend \" +\n        \"dev server. The command inherits stdin/stdout so you can interact \" +\n        \"with it directly. Example: npx convex dev --start 'vite --open'\",\n    ).conflicts([\"--run\", \"--run-sh\"]),\n  )\n  .addOption(\n    new Option(\"--run-sh <command>\", \"Deprecated: use --start instead.\")\n      .conflicts([\"--start\", \"--run\"])\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--run <functionName>\",\n      \"The identifier of the function to run in step 3, \" +\n        \"like `api.init.createData` or `myDir/myFile:myFunction`\",\n    ).conflicts([\"--start\"]),\n  )\n  .option(\n    \"--run-component <functionName>\",\n    'If --run is used and the function is in a component, the path to the component (e.g. \"workflow\" or \"workflow/workpool\"). ' +\n      \"Components are a beta feature. This flag is unstable and may change in subsequent releases.\",\n  )\n  .addOption(\n    new Option(\n      \"--tail-logs [mode]\",\n      [\n        \"Choose whether to tail Convex function logs in this terminal: \",\n        \"- `always` shows logs continuously\",\n        \"- `pause-on-deploy` (the default) pauses logs during deploys so you can spot sync issues\",\n        \"- `disable` hides logs while developing.\",\n      ].join(\"\\n\"),\n    )\n      .choices([\"always\", \"pause-on-deploy\", \"disable\"] as const)\n      .default(\"pause-on-deploy\"),\n  )\n  .addOption(new Option(\"--trace-events\").default(false).hideHelp())\n  .addOption(new Option(\"--debug-bundle-path <path>\").hideHelp())\n  .addOption(new Option(\"--debug-node-apis\").hideHelp())\n  .addOption(new Option(\"--live-component-sources\").hideHelp())\n  .addOption(\n    new Option(\n      \"--configure [choice]\",\n      \"Ignore existing configuration and configure new or existing project, interactively or set by --team <team_slug>, --project <project_slug>, and --dev-deployment local|cloud\",\n    )\n      .choices([\"new\", \"existing\"] as const)\n      .conflicts([\"--url\", \"--admin-key\", \"--env-file\"]),\n  )\n  .addOption(\n    new Option(\n      \"--team <team_slug>\",\n      \"The team you'd like to use for this project\",\n    ).hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--project <project_slug>\",\n      \"The name of the project you'd like to configure\",\n    ).hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--dev-deployment <mode>\",\n      \"Use a local or cloud deployment for dev for this project\",\n    )\n      .choices([\"cloud\", \"local\"] as const)\n      .conflicts([\"--prod\"])\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--prod\",\n      \"Develop live against this project's production deployment.\",\n    )\n      .default(false)\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--env-file <envFile>\",\n      `Path to a custom file of environment variables, for choosing the \\\ndeployment, e.g. ${CONVEX_DEPLOYMENT_ENV_VAR_NAME} or ${CONVEX_SELF_HOSTED_URL_VAR_NAME}. \\\nSame format as .env.local or .env files, and overrides them.`,\n    ),\n  )\n  .addOption(new Option(\"--skip-push\").default(false).hideHelp())\n  .addOption(new Option(\"--admin-key <adminKey>\").hideHelp())\n  .addOption(new Option(\"--url <url>\").hideHelp())\n  // Options for testing\n  .addOption(new Option(\"--override-auth-url <url>\").hideHelp())\n  .addOption(new Option(\"--override-auth-client <id>\").hideHelp())\n  .addOption(new Option(\"--override-auth-username <username>\").hideHelp())\n  .addOption(new Option(\"--override-auth-password <password>\").hideHelp())\n  .addOption(new Option(\"--local-cloud-port <port>\").hideHelp())\n  .addOption(new Option(\"--local-site-port <port>\").hideHelp())\n  .addOption(new Option(\"--local-backend-version <version>\").hideHelp())\n  .addOption(new Option(\"--local-force-upgrade\").default(false).hideHelp())\n  .addOption(new Option(\"--deployment <deployment>\").hideHelp())\n  .addOption(new Option(\"--local\").default(false).hideHelp())\n  .addOption(new Option(\"--cloud\").default(false).hideHelp())\n  .showHelpAfterError()\n  .action(async (cmdOptions) => {\n    const ctx = await oneoffContext(cmdOptions);\n    installSigintHandler(ctx);\n\n    if (cmdOptions.deployment !== undefined) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"`--deployment` can\u2019t be used with `npx convex dev`. \\n\\n\" +\n          \"  To select this deployment for development, run: \\n\" +\n          chalkStderr.bold(\n            `      npx convex deployment select ${cmdOptions.deployment}\\n`,\n          ) +\n          \"  Then, run `npx convex dev` again.\",\n      });\n    }\n\n    if (cmdOptions.local) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"`--local` is deprecated. \\n\\n\" +\n          \"  To select your local deployment, run: \\n\" +\n          chalkStderr.bold(\"      npx convex deployment select local\\n\") +\n          \"  Then, run `npx convex dev` again.\",\n      });\n    }\n\n    if (cmdOptions.cloud) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"`--cloud` is deprecated. \\n\\n\" +\n          \"  To select your personal cloud dev deployment, run: \\n\" +\n          chalkStderr.bold(\"      npx convex deployment select dev\\n\") +\n          \"  Then, run `npx convex dev` again.\",\n      });\n    }\n\n    const devOptions = await normalizeDevOptions(ctx, cmdOptions);\n\n    if (cmdOptions.configure === undefined) {\n      if (cmdOptions.team || cmdOptions.project || cmdOptions.devDeployment)\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"`--team, --project, and --dev-deployment can can only be used with `--configure`.\",\n        });\n    }\n\n    const localOptions: {\n      ports: { cloud: number | undefined; site: number | undefined };\n      backendVersion: string | undefined;\n      forceUpgrade: boolean;\n    } = {\n      ports: {\n        cloud:\n          cmdOptions.localCloudPort !== undefined\n            ? parseInt(cmdOptions.localCloudPort)\n            : undefined,\n        site:\n          cmdOptions.localSitePort !== undefined\n            ? parseInt(cmdOptions.localSitePort)\n            : undefined,\n      },\n      backendVersion: cmdOptions.localBackendVersion,\n      forceUpgrade: cmdOptions.localForceUpgrade,\n    };\n\n    const configure =\n      cmdOptions.configure === true ? \"ask\" : (cmdOptions.configure ?? null);\n    // --configure means \"pick a project\" \u2014 skip deployment selection entirely\n    const deploymentSelection =\n      configure !== null\n        ? ({\n            kind: \"chooseProject\",\n            selectionWithinProject: {\n              // For backwards compatibility, allow `--configure --prod`\n              kind: cmdOptions.prod ? \"prod\" : \"unspecified\",\n            },\n          } satisfies DeploymentSelection)\n        : await getDeploymentSelection(ctx, cmdOptions);\n    const credentials = await deploymentCredentialsOrConfigure(\n      ctx,\n      deploymentSelection,\n      configure,\n      {\n        ...cmdOptions,\n        localOptions,\n      },\n    );\n\n    announceDeploymentTarget(\"Developing against deployment:\", credentials);\n\n    await Promise.all([\n      ...(!cmdOptions.skipPush\n        ? [\n            devAgainstDeployment(\n              ctx,\n              {\n                url: credentials.url,\n                adminKey: credentials.adminKey,\n                deploymentName:\n                  credentials.deploymentFields?.deploymentName ?? null,\n                ...(credentials.deploymentFields?.deploymentType !== undefined\n                  ? {\n                      deploymentType:\n                        credentials.deploymentFields.deploymentType,\n                    }\n                  : {}),\n              },\n              devOptions,\n            ),\n          ]\n        : []),\n      ...(credentials.deploymentFields !== null\n        ? [\n            usageStateWarning(ctx, credentials.deploymentFields.deploymentName),\n            checkVersionAndAiFilesStaleness(ctx),\n          ]\n        : []),\n    ]);\n  });\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { Command, Option } from \"@commander-js/extra-typings\";\nimport { chalkStderr } from \"chalk\";\nimport { installSigintHandler, oneoffContext } from \"../bundler/context.js\";\nimport { deploymentCredentialsOrConfigure } from \"./configure.js\";\nimport { announceDeploymentTarget } from \"./lib/announceDeploymentTarget.js\";\nimport { usageStateWarning } from \"./lib/usage.js\";\nimport { normalizeDevOptions } from \"./lib/command.js\";\nimport { devAgainstDeployment } from \"./lib/dev.js\";\nimport {\n  CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n  CONVEX_SELF_HOSTED_URL_VAR_NAME,\n} from \"./lib/utils/utils.js\";\nimport {\n  getDeploymentSelection,\n  type DeploymentSelection,\n} from \"./lib/deploymentSelection.js\";\nimport { checkVersionAndAiFilesStaleness } from \"./lib/updates.js\";\n\nexport const dev = new Command(\"dev\")\n  .summary(\"Develop against a dev deployment, watching for changes\")\n  .description(\n    \"Develop against a dev deployment, watching for changes\\n\\n\" +\n      \"  1. Configures a new or existing project (if needed)\\n\" +\n      \"  2. Updates generated types and pushes code to the configured dev deployment\\n\" +\n      \"  3. Runs the provided command (if `--start` or `--run` is used)\\n\" +\n      \"  4. Watches for file changes, and repeats step 2\\n\",\n  )\n  .allowExcessArguments(false)\n  .option(\"-v, --verbose\", \"Show full listing of changes\")\n  .addOption(\n    new Option(\n      \"--typecheck <mode>\",\n      `Check TypeScript files with \\`tsc --noEmit\\`.`,\n    )\n      .choices([\"enable\", \"try\", \"disable\"] as const)\n      .default(\"try\" as const),\n  )\n  .option(\n    \"--typecheck-components\",\n    \"Check TypeScript files within component implementations with `tsc --noEmit`.\",\n    false,\n  )\n  .addOption(\n    new Option(\"--codegen <mode>\", \"Regenerate code in `convex/_generated/`\")\n      .choices([\"enable\", \"disable\"] as const)\n      .default(\"enable\" as const),\n  )\n  .addOption(\n    new Option(\n      \"--push-all-modules\",\n      \"Push all modules without checking for unchanged module hashes from the server\",\n    )\n      .default(false)\n      .hideHelp(),\n  )\n  .option(\n    \"--once\",\n    \"Execute only the first 3 steps, stop on any failure\",\n    false,\n  )\n  .option(\n    \"--until-success\",\n    \"Execute only the first 3 steps, on failure watch for local and remote changes and retry steps 2 and 3\",\n    false,\n  )\n  .addOption(\n    new Option(\n      \"--start <command>\",\n      \"Start a long-running command alongside `npx convex dev`, like a frontend \" +\n        \"dev server. The command inherits stdin/stdout so you can interact \" +\n        \"with it directly. Example: npx convex dev --start 'vite --open'\",\n    ).conflicts([\"--run\", \"--run-sh\"]),\n  )\n  .addOption(\n    new Option(\"--run-sh <command>\", \"Deprecated: use --start instead.\")\n      .conflicts([\"--start\", \"--run\"])\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--run <functionName>\",\n      \"The identifier of the function to run in step 3, \" +\n        \"like `api.init.createData` or `myDir/myFile:myFunction`\",\n    ).conflicts([\"--start\"]),\n  )\n  .option(\n    \"--run-component <functionName>\",\n    'If --run is used and the function is in a component, the path to the component (e.g. \"workflow\" or \"workflow/workpool\"). ' +\n      \"Components are a beta feature. This flag is unstable and may change in subsequent releases.\",\n  )\n  .addOption(\n    new Option(\n      \"--tail-logs [mode]\",\n      [\n        \"Choose whether to tail Convex function logs in this terminal: \",\n        \"\u2022 `always` shows logs continuously\",\n        \"\u2022 `pause-on-deploy` (the default) pauses logs during deploys so you can spot sync issues\",\n        \"\u2022 `disable` hides logs while developing.\",\n      ].join(\"\\n\"),\n    )\n      .choices([\"always\", \"pause-on-deploy\", \"disable\"] as const)\n      .default(\"pause-on-deploy\"),\n  )\n  .addOption(new Option(\"--trace-events\").default(false).hideHelp())\n  .addOption(new Option(\"--debug-bundle-path <path>\").hideHelp())\n  .addOption(new Option(\"--debug-node-apis\").hideHelp())\n  .addOption(new Option(\"--live-component-sources\").hideHelp())\n  .addOption(\n    new Option(\n      \"--configure [choice]\",\n      \"Ignore existing configuration and configure new or existing project, interactively or set by --team <team_slug>, --project <project_slug>, and --dev-deployment local|cloud\",\n    )\n      .choices([\"new\", \"existing\"] as const)\n      .conflicts([\"--url\", \"--admin-key\", \"--env-file\"]),\n  )\n  .addOption(\n    new Option(\n      \"--team <team_slug>\",\n      \"The team you'd like to use for this project\",\n    ).hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--project <project_slug>\",\n      \"The name of the project you'd like to configure\",\n    ).hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--dev-deployment <mode>\",\n      \"Use a local or cloud deployment for dev for this project\",\n    )\n      .choices([\"cloud\", \"local\"] as const)\n      .conflicts([\"--prod\"])\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--prod\",\n      \"Develop live against this project's production deployment.\",\n    )\n      .default(false)\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--env-file <envFile>\",\n      `Path to a custom file of environment variables, for choosing the \\\ndeployment, e.g. ${CONVEX_DEPLOYMENT_ENV_VAR_NAME} or ${CONVEX_SELF_HOSTED_URL_VAR_NAME}. \\\nSame format as .env.local or .env files, and overrides them.`,\n    ),\n  )\n  .addOption(new Option(\"--skip-push\").default(false).hideHelp())\n  .addOption(new Option(\"--admin-key <adminKey>\").hideHelp())\n  .addOption(new Option(\"--url <url>\").hideHelp())\n  // Options for testing\n  .addOption(new Option(\"--override-auth-url <url>\").hideHelp())\n  .addOption(new Option(\"--override-auth-client <id>\").hideHelp())\n  .addOption(new Option(\"--override-auth-username <username>\").hideHelp())\n  .addOption(new Option(\"--override-auth-password <password>\").hideHelp())\n  .addOption(new Option(\"--local-cloud-port <port>\").hideHelp())\n  .addOption(new Option(\"--local-site-port <port>\").hideHelp())\n  .addOption(new Option(\"--local-backend-version <version>\").hideHelp())\n  .addOption(new Option(\"--local-force-upgrade\").default(false).hideHelp())\n  .addOption(new Option(\"--deployment <deployment>\").hideHelp())\n  .addOption(new Option(\"--local\").default(false).hideHelp())\n  .addOption(new Option(\"--cloud\").default(false).hideHelp())\n  .showHelpAfterError()\n  .action(async (cmdOptions) => {\n    const ctx = await oneoffContext(cmdOptions);\n    installSigintHandler(ctx);\n\n    if (cmdOptions.deployment !== undefined) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"`--deployment` can\u2019t be used with `npx convex dev`. \\n\\n\" +\n          \"  To select this deployment for development, run: \\n\" +\n          chalkStderr.bold(\n            `      npx convex deployment select ${cmdOptions.deployment}\\n`,\n          ) +\n          \"  Then, run `npx convex dev` again.\",\n      });\n    }\n\n    if (cmdOptions.local) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"`--local` is deprecated. \\n\\n\" +\n          \"  To select your local deployment, run: \\n\" +\n          chalkStderr.bold(\"      npx convex deployment select local\\n\") +\n          \"  Then, run `npx convex dev` again.\",\n      });\n    }\n\n    if (cmdOptions.cloud) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"`--cloud` is deprecated. \\n\\n\" +\n          \"  To select your personal cloud dev deployment, run: \\n\" +\n          chalkStderr.bold(\"      npx convex deployment select dev\\n\") +\n          \"  Then, run `npx convex dev` again.\",\n      });\n    }\n\n    const devOptions = await normalizeDevOptions(ctx, cmdOptions);\n\n    if (cmdOptions.configure === undefined) {\n      if (cmdOptions.team || cmdOptions.project || cmdOptions.devDeployment)\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"`--team, --project, and --dev-deployment can can only be used with `--configure`.\",\n        });\n    }\n\n    const localOptions: {\n      ports: { cloud: number | undefined; site: number | undefined };\n      backendVersion: string | undefined;\n      forceUpgrade: boolean;\n    } = {\n      ports: {\n        cloud:\n          cmdOptions.localCloudPort !== undefined\n            ? parseInt(cmdOptions.localCloudPort)\n            : undefined,\n        site:\n          cmdOptions.localSitePort !== undefined\n            ? parseInt(cmdOptions.localSitePort)\n            : undefined,\n      },\n      backendVersion: cmdOptions.localBackendVersion,\n      forceUpgrade: cmdOptions.localForceUpgrade,\n    };\n\n    const configure =\n      cmdOptions.configure === true ? \"ask\" : (cmdOptions.configure ?? null);\n    // --configure means \"pick a project\" \u2014 skip deployment selection entirely\n    const deploymentSelection =\n      configure !== null\n        ? ({\n            kind: \"chooseProject\",\n            selectionWithinProject: {\n              // For backwards compatibility, allow `--configure --prod`\n              kind: cmdOptions.prod ? \"prod\" : \"unspecified\",\n            },\n          } satisfies DeploymentSelection)\n        : await getDeploymentSelection(ctx, cmdOptions);\n    const credentials = await deploymentCredentialsOrConfigure(\n      ctx,\n      deploymentSelection,\n      configure,\n      {\n        ...cmdOptions,\n        localOptions,\n      },\n    );\n\n    announceDeploymentTarget(\"Developing against deployment:\", credentials);\n\n    await Promise.all([\n      ...(!cmdOptions.skipPush\n        ? [\n            devAgainstDeployment(\n              ctx,\n              {\n                url: credentials.url,\n                adminKey: credentials.adminKey,\n                deploymentName:\n                  credentials.deploymentFields?.deploymentName ?? null,\n                ...(credentials.deploymentFields?.deploymentType !== undefined\n                  ? {\n                      deploymentType:\n                        credentials.deploymentFields.deploymentType,\n                    }\n                  : {}),\n                backendVersion: localOptions.backendVersion,\n              },\n              devOptions,\n            ),\n          ]\n        : []),\n      ...(credentials.deploymentFields !== null\n        ? [\n            usageStateWarning(ctx, credentials.deploymentFields.deploymentName),\n            checkVersionAndAiFilesStaleness(ctx),\n          ]\n        : []),\n    ]);\n  });\n"],
+  "mappings": ";AAAA,SAAS,SAAS,cAAc;AAChC,SAAS,mBAAmB;AAC5B,SAAS,sBAAsB,qBAAqB;AACpD,SAAS,wCAAwC;AACjD,SAAS,gCAAgC;AACzC,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,4BAA4B;AACrC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,OAEK;AACP,SAAS,uCAAuC;AAEzC,aAAM,MAAM,IAAI,QAAQ,KAAK,EACjC,QAAQ,wDAAwD,EAChE;AAAA,EACC;AAKF,EACC,qBAAqB,KAAK,EAC1B,OAAO,iBAAiB,8BAA8B,EACtD;AAAA,EACC,IAAI;AAAA,IACF;AAAA,IACA;AAAA,EACF,EACG,QAAQ,CAAC,UAAU,OAAO,SAAS,CAAU,EAC7C,QAAQ,KAAc;AAC3B,EACC;AAAA,EACC;AAAA,EACA;AAAA,EACA;AACF,EACC;AAAA,EACC,IAAI,OAAO,oBAAoB,yCAAyC,EACrE,QAAQ,CAAC,UAAU,SAAS,CAAU,EACtC,QAAQ,QAAiB;AAC9B,EACC;AAAA,EACC,IAAI;AAAA,IACF;AAAA,IACA;AAAA,EACF,EACG,QAAQ,KAAK,EACb,SAAS;AACd,EACC;AAAA,EACC;AAAA,EACA;AAAA,EACA;AACF,EACC;AAAA,EACC;AAAA,EACA;AAAA,EACA;AACF,EACC;AAAA,EACC,IAAI;AAAA,IACF;AAAA,IACA;AAAA,EAGF,EAAE,UAAU,CAAC,SAAS,UAAU,CAAC;AACnC,EACC;AAAA,EACC,IAAI,OAAO,sBAAsB,kCAAkC,EAChE,UAAU,CAAC,WAAW,OAAO,CAAC,EAC9B,SAAS;AACd,EACC;AAAA,EACC,IAAI;AAAA,IACF;AAAA,IACA;AAAA,EAEF,EAAE,UAAU,CAAC,SAAS,CAAC;AACzB,EACC;AAAA,EACC;AAAA,EACA;AAEF,EACC;AAAA,EACC,IAAI;AAAA,IACF;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI;AAAA,EACb,EACG,QAAQ,CAAC,UAAU,mBAAmB,SAAS,CAAU,EACzD,QAAQ,iBAAiB;AAC9B,EACC,UAAU,IAAI,OAAO,gBAAgB,EAAE,QAAQ,KAAK,EAAE,SAAS,CAAC,EAChE,UAAU,IAAI,OAAO,4BAA4B,EAAE,SAAS,CAAC,EAC7D,UAAU,IAAI,OAAO,mBAAmB,EAAE,SAAS,CAAC,EACpD,UAAU,IAAI,OAAO,0BAA0B,EAAE,SAAS,CAAC,EAC3D;AAAA,EACC,IAAI;AAAA,IACF;AAAA,IACA;AAAA,EACF,EACG,QAAQ,CAAC,OAAO,UAAU,CAAU,EACpC,UAAU,CAAC,SAAS,eAAe,YAAY,CAAC;AACrD,EACC;AAAA,EACC,IAAI;AAAA,IACF;AAAA,IACA;AAAA,EACF,EAAE,SAAS;AACb,EACC;AAAA,EACC,IAAI;AAAA,IACF;AAAA,IACA;AAAA,EACF,EAAE,SAAS;AACb,EACC;AAAA,EACC,IAAI;AAAA,IACF;AAAA,IACA;AAAA,EACF,EACG,QAAQ,CAAC,SAAS,OAAO,CAAU,EACnC,UAAU,CAAC,QAAQ,CAAC,EACpB,SAAS;AACd,EACC;AAAA,EACC,IAAI;AAAA,IACF;AAAA,IACA;AAAA,EACF,EACG,QAAQ,KAAK,EACb,SAAS;AACd,EACC;AAAA,EACC,IAAI;AAAA,IACF;AAAA,IACA,qFACa,8BAA8B,OAAO,+BAA+B;AAAA,EAEnF;AACF,EACC,UAAU,IAAI,OAAO,aAAa,EAAE,QAAQ,KAAK,EAAE,SAAS,CAAC,EAC7D,UAAU,IAAI,OAAO,wBAAwB,EAAE,SAAS,CAAC,EACzD,UAAU,IAAI,OAAO,aAAa,EAAE,SAAS,CAAC,EAE9C,UAAU,IAAI,OAAO,2BAA2B,EAAE,SAAS,CAAC,EAC5D,UAAU,IAAI,OAAO,6BAA6B,EAAE,SAAS,CAAC,EAC9D,UAAU,IAAI,OAAO,qCAAqC,EAAE,SAAS,CAAC,EACtE,UAAU,IAAI,OAAO,qCAAqC,EAAE,SAAS,CAAC,EACtE,UAAU,IAAI,OAAO,2BAA2B,EAAE,SAAS,CAAC,EAC5D,UAAU,IAAI,OAAO,0BAA0B,EAAE,SAAS,CAAC,EAC3D,UAAU,IAAI,OAAO,mCAAmC,EAAE,SAAS,CAAC,EACpE,UAAU,IAAI,OAAO,uBAAuB,EAAE,QAAQ,KAAK,EAAE,SAAS,CAAC,EACvE,UAAU,IAAI,OAAO,2BAA2B,EAAE,SAAS,CAAC,EAC5D,UAAU,IAAI,OAAO,SAAS,EAAE,QAAQ,KAAK,EAAE,SAAS,CAAC,EACzD,UAAU,IAAI,OAAO,SAAS,EAAE,QAAQ,KAAK,EAAE,SAAS,CAAC,EACzD,mBAAmB,EACnB,OAAO,OAAO,eAAe;AAC5B,QAAM,MAAM,MAAM,cAAc,UAAU;AAC1C,uBAAqB,GAAG;AAExB,MAAI,WAAW,eAAe,QAAW;AACvC,WAAO,MAAM,IAAI,MAAM;AAAA,MACrB,UAAU;AAAA,MACV,WAAW;AAAA,MACX,gBACE,sHAEA,YAAY;AAAA,QACV,sCAAsC,WAAW,UAAU;AAAA;AAAA,MAC7D,IACA;AAAA,IACJ,CAAC;AAAA,EACH;AAEA,MAAI,WAAW,OAAO;AACpB,WAAO,MAAM,IAAI,MAAM;AAAA,MACrB,UAAU;AAAA,MACV,WAAW;AAAA,MACX,gBACE,4EAEA,YAAY,KAAK,4CAA4C,IAC7D;AAAA,IACJ,CAAC;AAAA,EACH;AAEA,MAAI,WAAW,OAAO;AACpB,WAAO,MAAM,IAAI,MAAM;AAAA,MACrB,UAAU;AAAA,MACV,WAAW;AAAA,MACX,gBACE,yFAEA,YAAY,KAAK,0CAA0C,IAC3D;AAAA,IACJ,CAAC;AAAA,EACH;AAEA,QAAM,aAAa,MAAM,oBAAoB,KAAK,UAAU;AAE5D,MAAI,WAAW,cAAc,QAAW;AACtC,QAAI,WAAW,QAAQ,WAAW,WAAW,WAAW;AACtD,aAAO,MAAM,IAAI,MAAM;AAAA,QACrB,UAAU;AAAA,QACV,WAAW;AAAA,QACX,gBACE;AAAA,MACJ,CAAC;AAAA,EACL;AAEA,QAAM,eAIF;AAAA,IACF,OAAO;AAAA,MACL,OACE,WAAW,mBAAmB,SAC1B,SAAS,WAAW,cAAc,IAClC;AAAA,MACN,MACE,WAAW,kBAAkB,SACzB,SAAS,WAAW,aAAa,IACjC;AAAA,IACR;AAAA,IACA,gBAAgB,WAAW;AAAA,IAC3B,cAAc,WAAW;AAAA,EAC3B;AAEA,QAAM,YACJ,WAAW,cAAc,OAAO,QAAS,WAAW,aAAa;AAEnE,QAAM,sBACJ,cAAc,OACT;AAAA,IACC,MAAM;AAAA,IACN,wBAAwB;AAAA;AAAA,MAEtB,MAAM,WAAW,OAAO,SAAS;AAAA,IACnC;AAAA,EACF,IACA,MAAM,uBAAuB,KAAK,UAAU;AAClD,QAAM,cAAc,MAAM;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,MACE,GAAG;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,2BAAyB,kCAAkC,WAAW;AAEtE,QAAM,QAAQ,IAAI;AAAA,IAChB,GAAI,CAAC,WAAW,WACZ;AAAA,MACE;AAAA,QACE;AAAA,QACA;AAAA,UACE,KAAK,YAAY;AAAA,UACjB,UAAU,YAAY;AAAA,UACtB,gBACE,YAAY,kBAAkB,kBAAkB;AAAA,UAClD,GAAI,YAAY,kBAAkB,mBAAmB,SACjD;AAAA,YACE,gBACE,YAAY,iBAAiB;AAAA,UACjC,IACA,CAAC;AAAA,UACL,gBAAgB,aAAa;AAAA,QAC/B;AAAA,QACA;AAAA,MACF;AAAA,IACF,IACA,CAAC;AAAA,IACL,GAAI,YAAY,qBAAqB,OACjC;AAAA,MACE,kBAAkB,KAAK,YAAY,iBAAiB,cAAc;AAAA,MAClE,gCAAgC,GAAG;AAAA,IACrC,IACA,CAAC;AAAA,EACP,CAAC;AACH,CAAC;",
   "names": []
 }

package/dist/esm/cli/env.js

@@ -24,16 +24,16 @@ const envSetCmd = new Command("set").usage("[options] <name> <value>").argument(
   [
     "Set environment variables on your deployment.",
     "",
-    "- `npx convex env set NAME 'value'`",
-    "- `npx convex env set NAME # omit a value to set one interactively`",
-    "- `npx convex env set NAME --from-file value.txt`",
-    "- `npx convex env set --from-file .env.defaults`",
+    "\u2022 `npx convex env set NAME 'value'`",
+    "\u2022 `npx convex env set NAME # omit a value to set one interactively`",
+    "\u2022 `npx convex env set NAME --from-file value.txt`",
+    "\u2022 `npx convex env set --from-file .env.defaults`",
     "",
     "When setting multiple values, it will refuse all changes if any variables are already set to different values by default. Pass --force to overwrite the provided values.",
     "",
     "To keep secrets out of your shell history, omit the value to pipe it in via stdin, for instance:",
-    "- `pbpaste | npx convex env set API_KEY` (macOS)",
-    "- `Get-Clipboard | npx convex env set API_KEY` (Windows PowerShell)",
+    "\u2022 `pbpaste | npx convex env set API_KEY` (macOS)",
+    "\u2022 `Get-Clipboard | npx convex env set API_KEY` (Windows PowerShell)",
     "",
     "To update many variables at once, save them with `npx convex env list > .env.convex`, edit the file, then reapply the changes with `npx convex env set --force < .env.convex`."
   ].join("\n")
@@ -114,11 +114,11 @@ const envRemoveCmd = new Command("remove").alias("rm").alias("unset").argument("
     }
   });
 });
-const envListCmd = new Command("list").summary("List all variables").description(
+const envListCmd = new Command("list").summary("List all variables and their values").description(
   [
-    "- List all variables: `npx convex env list`",
-    "- Save all variables to a file: `npx convex env list > .env.convex`",
-    "- Append to a file: `npx convex env list >> .env.convex`"
+    "\u2022 List all variables: `npx convex env list`",
+    "\u2022 Save all variables to a file: `npx convex env list > .env.convex`",
+    "\u2022 Append to a file: `npx convex env list >> .env.convex`"
   ].join("\n")
 ).configureHelp({ showGlobalOptions: true }).allowExcessArguments(false).action(async (_options, cmd) => {
   const options = cmd.optsWithGlobals();
@@ -137,12 +137,12 @@ export const env = new Command("env").summary("Set and view environment variable
   [
     "Set and view environment variables on your deployment",
     "",
-    "- Set a variable: `npx convex env set NAME 'value'`",
-    "- Set interactively: `npx convex env set NAME`",
-    "- Set multiple from file: `npx convex env set --from-file .env`",
-    "- Unset a variable: `npx convex env remove NAME`",
-    "- List all variables: `npx convex env list`",
-    "- Print a variable's value: `npx convex env get NAME`",
+    "\u2022 Set a variable: `npx convex env set NAME 'value'`",
+    "\u2022 Set interactively: `npx convex env set NAME`",
+    "\u2022 Set multiple from file: `npx convex env set --from-file .env`",
+    "\u2022 Unset a variable: `npx convex env remove NAME`",
+    "\u2022 List all variables: `npx convex env list`",
+    "\u2022 Print a variable's value: `npx convex env get NAME`",
     "",
     "By default, this sets and views variables on your dev deployment.",
     "",

package/dist/esm/cli/env.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/env.ts"],
-  "sourcesContent": ["import { Command } from \"@commander-js/extra-typings\";\nimport { chalkStderr } from \"chalk\";\nimport { Context, oneoffContext } from \"../bundler/context.js\";\nimport {\n  DeploymentSelectionOptions,\n  DetailedDeploymentCredentials,\n  loadSelectedDeploymentCredentials,\n} from \"./lib/api.js\";\nimport { actionDescription } from \"./lib/command.js\";\nimport { ensureHasConvexDependency } from \"./lib/utils/utils.js\";\nimport {\n  deploymentEnvBackend,\n  envGet,\n  envList,\n  envRemove,\n  envSet,\n} from \"./lib/env.js\";\nimport { getDeploymentSelection } from \"./lib/deploymentSelection.js\";\nimport { withRunningBackend } from \"./lib/localDeployment/run.js\";\nimport { envDefault } from \"./envDefault.js\";\n\nconst envSetCmd = new Command(\"set\")\n  // Pretend value is required\n  .usage(\"[options] <name> <value>\")\n  .argument(\"[name]\", \"The name of the environment variable to set.\")\n  .argument(\n    \"[value]\",\n    \"The value to set the variable to. Omit to set it interactively.\",\n  )\n  .summary(\"Set a variable\")\n  .description(\n    [\n      \"Set environment variables on your deployment.\",\n      \"\",\n      \"- `npx convex env set NAME 'value'`\",\n      \"- `npx convex env set NAME # omit a value to set one interactively`\",\n      \"- `npx convex env set NAME --from-file value.txt`\",\n      \"- `npx convex env set --from-file .env.defaults`\",\n      \"\",\n      \"When setting multiple values, it will refuse all changes if any variables are already set to different values by default. Pass --force to overwrite the provided values.\",\n      \"\",\n      \"To keep secrets out of your shell history, omit the value to pipe it in via stdin, for instance:\",\n      \"- `pbpaste | npx convex env set API_KEY` (macOS)\",\n      \"- `Get-Clipboard | npx convex env set API_KEY` (Windows PowerShell)\",\n      \"\",\n      \"To update many variables at once, save them with `npx convex env list > .env.convex`, edit the file, then reapply the changes with `npx convex env set --force < .env.convex`.\",\n    ].join(\"\\n\"),\n  )\n  .option(\n    \"--from-file <file>\",\n    \"Read environment variables from a .env file. Without --force, fails if any existing variable has a different value.\",\n  )\n  .option(\n    \"--force\",\n    \"When setting multiple variables, overwrite existing environment variable values instead of failing on mismatch.\",\n  )\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (name, value, cmdOptions, cmd) => {\n    // Note: We use `as` here because optsWithGlobals() type inference doesn't\n    // include global options from the parent command (added via addDeploymentSelectionOptions)\n    const options = cmd.optsWithGlobals() as DeploymentSelectionOptions;\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env set\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        const didAnything = await envSet(ctx, backend, name, value, cmdOptions);\n        if (didAnything === false) {\n          cmd.outputHelp({ error: true });\n          return await ctx.crash({\n            exitCode: 1,\n            errorType: \"fatal\",\n            printedMessage:\n              \"error: No environment variables specified to be set.\",\n          });\n        }\n      },\n    });\n  });\n\nexport async function selectEnvDeployment(\n  options: DeploymentSelectionOptions,\n): Promise<{\n  ctx: Context;\n  deployment: {\n    deploymentUrl: string;\n    adminKey: string;\n    deploymentNotice: string;\n    deploymentFields: DetailedDeploymentCredentials[\"deploymentFields\"];\n  };\n}> {\n  const ctx = await oneoffContext(options);\n  const deploymentSelection = await getDeploymentSelection(ctx, options);\n  const {\n    adminKey,\n    url: deploymentUrl,\n    deploymentFields,\n  } = await loadSelectedDeploymentCredentials(ctx, deploymentSelection, {\n    ensureLocalRunning: false,\n  });\n\n  const deploymentNotice =\n    deploymentFields !== null\n      ? ` (on ${chalkStderr.bold(deploymentFields.deploymentType)} deployment ${chalkStderr.bold(deploymentFields.deploymentName)})`\n      : \"\";\n  const result = {\n    ctx,\n    deployment: {\n      deploymentUrl,\n      adminKey,\n      deploymentNotice,\n      deploymentFields,\n    },\n  };\n  return result;\n}\n\nconst envGetCmd = new Command(\"get\")\n  .argument(\"<name>\", \"The name of the environment variable to print.\")\n  .summary(\"Print a variable's value\")\n  .description(\"Print a variable's value: `npx convex env get NAME`\")\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (envVarName, _options, cmd) => {\n    const options = cmd.optsWithGlobals();\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env get\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        await envGet(ctx, backend, envVarName);\n      },\n    });\n  });\n\nconst envRemoveCmd = new Command(\"remove\")\n  .alias(\"rm\")\n  .alias(\"unset\")\n  .argument(\"<name>\", \"The name of the environment variable to unset.\")\n  .summary(\"Unset a variable\")\n  .description(\n    \"Unset a variable: `npx convex env remove NAME`\\n\" +\n      \"If the variable doesn't exist, the command doesn't do anything and succeeds.\",\n  )\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (name, _options, cmd) => {\n    const options = cmd.optsWithGlobals();\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env remove\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        await envRemove(ctx, backend, name);\n      },\n    });\n  });\n\nconst envListCmd = new Command(\"list\")\n  .summary(\"List all variables\")\n  .description(\n    [\n      \"- List all variables: `npx convex env list`\",\n      \"- Save all variables to a file: `npx convex env list > .env.convex`\",\n      \"- Append to a file: `npx convex env list >> .env.convex`\",\n    ].join(\"\\n\"),\n  )\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (_options, cmd) => {\n    const options = cmd.optsWithGlobals();\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env list\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        await envList(ctx, backend);\n      },\n    });\n  });\n\nexport const env = new Command(\"env\")\n  .summary(\"Set and view environment variables\")\n  .description(\n    [\n      \"Set and view environment variables on your deployment\",\n      \"\",\n      \"- Set a variable: `npx convex env set NAME 'value'`\",\n      \"- Set interactively: `npx convex env set NAME`\",\n      \"- Set multiple from file: `npx convex env set --from-file .env`\",\n      \"- Unset a variable: `npx convex env remove NAME`\",\n      \"- List all variables: `npx convex env list`\",\n      \"- Print a variable's value: `npx convex env get NAME`\",\n      \"\",\n      \"By default, this sets and views variables on your dev deployment.\",\n      \"\",\n      \"See the environment variables guide (https://docs.convex.dev/production/environment-variables) to learn more.\",\n    ].join(\"\\n\"),\n  )\n  .addCommand(envSetCmd)\n  .addCommand(envGetCmd)\n  .addCommand(envRemoveCmd)\n  .addCommand(envListCmd)\n  .addCommand(envDefault)\n  .helpCommand(false)\n  .addDeploymentSelectionOptions(\n    actionDescription(\"Set and view environment variables on\"),\n  );\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { Command } from \"@commander-js/extra-typings\";\nimport { chalkStderr } from \"chalk\";\nimport { Context, oneoffContext } from \"../bundler/context.js\";\nimport {\n  DeploymentSelectionOptions,\n  DetailedDeploymentCredentials,\n  loadSelectedDeploymentCredentials,\n} from \"./lib/api.js\";\nimport { actionDescription } from \"./lib/command.js\";\nimport { ensureHasConvexDependency } from \"./lib/utils/utils.js\";\nimport {\n  deploymentEnvBackend,\n  envGet,\n  envList,\n  envRemove,\n  envSet,\n} from \"./lib/env.js\";\nimport { getDeploymentSelection } from \"./lib/deploymentSelection.js\";\nimport { withRunningBackend } from \"./lib/localDeployment/run.js\";\nimport { envDefault } from \"./envDefault.js\";\n\nconst envSetCmd = new Command(\"set\")\n  // Pretend value is required\n  .usage(\"[options] <name> <value>\")\n  .argument(\"[name]\", \"The name of the environment variable to set.\")\n  .argument(\n    \"[value]\",\n    \"The value to set the variable to. Omit to set it interactively.\",\n  )\n  .summary(\"Set a variable\")\n  .description(\n    [\n      \"Set environment variables on your deployment.\",\n      \"\",\n      \"\u2022 `npx convex env set NAME 'value'`\",\n      \"\u2022 `npx convex env set NAME # omit a value to set one interactively`\",\n      \"\u2022 `npx convex env set NAME --from-file value.txt`\",\n      \"\u2022 `npx convex env set --from-file .env.defaults`\",\n      \"\",\n      \"When setting multiple values, it will refuse all changes if any variables are already set to different values by default. Pass --force to overwrite the provided values.\",\n      \"\",\n      \"To keep secrets out of your shell history, omit the value to pipe it in via stdin, for instance:\",\n      \"\u2022 `pbpaste | npx convex env set API_KEY` (macOS)\",\n      \"\u2022 `Get-Clipboard | npx convex env set API_KEY` (Windows PowerShell)\",\n      \"\",\n      \"To update many variables at once, save them with `npx convex env list > .env.convex`, edit the file, then reapply the changes with `npx convex env set --force < .env.convex`.\",\n    ].join(\"\\n\"),\n  )\n  .option(\n    \"--from-file <file>\",\n    \"Read environment variables from a .env file. Without --force, fails if any existing variable has a different value.\",\n  )\n  .option(\n    \"--force\",\n    \"When setting multiple variables, overwrite existing environment variable values instead of failing on mismatch.\",\n  )\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (name, value, cmdOptions, cmd) => {\n    // Note: We use `as` here because optsWithGlobals() type inference doesn't\n    // include global options from the parent command (added via addDeploymentSelectionOptions)\n    const options = cmd.optsWithGlobals() as DeploymentSelectionOptions;\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env set\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        const didAnything = await envSet(ctx, backend, name, value, cmdOptions);\n        if (didAnything === false) {\n          cmd.outputHelp({ error: true });\n          return await ctx.crash({\n            exitCode: 1,\n            errorType: \"fatal\",\n            printedMessage:\n              \"error: No environment variables specified to be set.\",\n          });\n        }\n      },\n    });\n  });\n\nexport async function selectEnvDeployment(\n  options: DeploymentSelectionOptions,\n): Promise<{\n  ctx: Context;\n  deployment: {\n    deploymentUrl: string;\n    adminKey: string;\n    deploymentNotice: string;\n    deploymentFields: DetailedDeploymentCredentials[\"deploymentFields\"];\n  };\n}> {\n  const ctx = await oneoffContext(options);\n  const deploymentSelection = await getDeploymentSelection(ctx, options);\n  const {\n    adminKey,\n    url: deploymentUrl,\n    deploymentFields,\n  } = await loadSelectedDeploymentCredentials(ctx, deploymentSelection, {\n    ensureLocalRunning: false,\n  });\n\n  const deploymentNotice =\n    deploymentFields !== null\n      ? ` (on ${chalkStderr.bold(deploymentFields.deploymentType)} deployment ${chalkStderr.bold(deploymentFields.deploymentName)})`\n      : \"\";\n  const result = {\n    ctx,\n    deployment: {\n      deploymentUrl,\n      adminKey,\n      deploymentNotice,\n      deploymentFields,\n    },\n  };\n  return result;\n}\n\nconst envGetCmd = new Command(\"get\")\n  .argument(\"<name>\", \"The name of the environment variable to print.\")\n  .summary(\"Print a variable's value\")\n  .description(\"Print a variable's value: `npx convex env get NAME`\")\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (envVarName, _options, cmd) => {\n    const options = cmd.optsWithGlobals();\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env get\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        await envGet(ctx, backend, envVarName);\n      },\n    });\n  });\n\nconst envRemoveCmd = new Command(\"remove\")\n  .alias(\"rm\")\n  .alias(\"unset\")\n  .argument(\"<name>\", \"The name of the environment variable to unset.\")\n  .summary(\"Unset a variable\")\n  .description(\n    \"Unset a variable: `npx convex env remove NAME`\\n\" +\n      \"If the variable doesn't exist, the command doesn't do anything and succeeds.\",\n  )\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (name, _options, cmd) => {\n    const options = cmd.optsWithGlobals();\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env remove\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        await envRemove(ctx, backend, name);\n      },\n    });\n  });\n\nconst envListCmd = new Command(\"list\")\n  .summary(\"List all variables and their values\")\n  .description(\n    [\n      \"\u2022 List all variables: `npx convex env list`\",\n      \"\u2022 Save all variables to a file: `npx convex env list > .env.convex`\",\n      \"\u2022 Append to a file: `npx convex env list >> .env.convex`\",\n    ].join(\"\\n\"),\n  )\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (_options, cmd) => {\n    const options = cmd.optsWithGlobals();\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env list\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        await envList(ctx, backend);\n      },\n    });\n  });\n\nexport const env = new Command(\"env\")\n  .summary(\"Set and view environment variables\")\n  .description(\n    [\n      \"Set and view environment variables on your deployment\",\n      \"\",\n      \"\u2022 Set a variable: `npx convex env set NAME 'value'`\",\n      \"\u2022 Set interactively: `npx convex env set NAME`\",\n      \"\u2022 Set multiple from file: `npx convex env set --from-file .env`\",\n      \"\u2022 Unset a variable: `npx convex env remove NAME`\",\n      \"\u2022 List all variables: `npx convex env list`\",\n      \"\u2022 Print a variable's value: `npx convex env get NAME`\",\n      \"\",\n      \"By default, this sets and views variables on your dev deployment.\",\n      \"\",\n      \"See the environment variables guide (https://docs.convex.dev/production/environment-variables) to learn more.\",\n    ].join(\"\\n\"),\n  )\n  .addCommand(envSetCmd)\n  .addCommand(envGetCmd)\n  .addCommand(envRemoveCmd)\n  .addCommand(envListCmd)\n  .addCommand(envDefault)\n  .helpCommand(false)\n  .addDeploymentSelectionOptions(\n    actionDescription(\"Set and view environment variables on\"),\n  );\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/esm/cli/envDefault.js

@@ -35,10 +35,10 @@ const envDefaultSet = addEnvDefaultOptions(
     [
       "Set default environment variables for your project's deployment type.",
       "",
-      "- `npx convex env default set NAME 'value'`",
-      "- `npx convex env default set NAME # omit a value to set one interactively`",
-      "- `npx convex env default set NAME --from-file value.txt`",
-      "- `npx convex env default set --from-file .env.defaults`",
+      "\u2022 `npx convex env default set NAME 'value'`",
+      "\u2022 `npx convex env default set NAME # omit a value to set one interactively`",
+      "\u2022 `npx convex env default set NAME --from-file value.txt`",
+      "\u2022 `npx convex env default set --from-file .env.defaults`",
       "",
       "When setting multiple values, it will refuse all changes if any variables are already set to different values by default. Pass --force to overwrite the provided values.",
       "",
@@ -86,7 +86,7 @@ const envDefaultRemove = addEnvDefaultOptions(
     [
       "Unset a default variable.",
       "",
-      "- `npx convex env default remove NAME`",
+      "\u2022 `npx convex env default remove NAME`",
       "",
       "If the variable doesn't exist, the command doesn't do anything and succeeds.",
       "",
@@ -104,7 +104,7 @@ const envDefaultList = addEnvDefaultOptions(
     [
       "List all default variables.",
       "",
-      "- `npx convex env default list`",
+      "\u2022 `npx convex env default list`",
       "",
       "The deployment type is determined by the current deployment (local maps to dev), or by --type if provided."
     ].join("\n")
@@ -121,10 +121,10 @@ export const envDefault = new Command("default").summary("Manage project-level d
     "",
     "The default environment variables read and written to by this command are the ones for the deployment type of the current deployment (i.e. dev in most cases), unless --type is provided.",
     "",
-    "- Set a default variable: `npx convex env default set NAME 'value'`",
-    "- Unset a default variable: `npx convex env default remove NAME`",
-    "- List all default variables: `npx convex env default list`",
-    "- Print a default variable's value: `npx convex env default get NAME`"
+    "\u2022 Set a default variable: `npx convex env default set NAME 'value'`",
+    "\u2022 Unset a default variable: `npx convex env default remove NAME`",
+    "\u2022 List all default variables: `npx convex env default list`",
+    "\u2022 Print a default variable's value: `npx convex env default get NAME`"
   ].join("\n")
 ).addCommand(envDefaultSet).addCommand(envDefaultGet).addCommand(envDefaultRemove).addCommand(envDefaultList).helpCommand(false);
 async function resolveEnvDefaultBackend(options) {

package/dist/esm/cli/envDefault.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/envDefault.ts"],
-  "sourcesContent": ["import { Command, Option } from \"@commander-js/extra-typings\";\nimport {\n  envGet,\n  envList,\n  envRemove,\n  envSet,\n  EnvVarBackend,\n} from \"./lib/env.js\";\nimport { ensureHasConvexDependency } from \"./lib/utils/utils.js\";\nimport { defaultEnvBackend } from \"./lib/defaultEnv.js\";\nimport {\n  CloudDeploymentType,\n  DeploymentSelectionOptions,\n  DeploymentType,\n  fetchTeamAndProject,\n} from \"./lib/api.js\";\nimport { Context, oneoffContext } from \"../bundler/context.js\";\nimport { selectEnvDeployment } from \"./env.js\";\nimport { getProjectDetails } from \"./lib/deploymentSelection.js\";\n\ntype EnvDefaultExtraOptions = {\n  type?: string;\n  project?: string;\n};\n\nfunction addEnvDefaultOptions<T extends Command<any, any>>(cmd: T): T {\n  return cmd\n    .addOption(\n      new Option(\n        \"--type <type>\",\n        \"Manage default env vars for the given deployment type (dev, preview, prod) instead of inferring from the current deployment.\",\n      ),\n    )\n    .addOption(\n      new Option(\n        \"--project <project>\",\n        \"Select a project manually. Accepts `team-slug:project-slug` or just `project-slug` (team inferred from your current project). Requires --type.\",\n      ),\n    ) as T;\n}\n\nconst envDefaultSet = addEnvDefaultOptions(\n  new Command(\"set\")\n    .usage(\"[options] <name> <value>\")\n    .argument(\"[name]\", \"The name of the default environment variable to set.\")\n    .argument(\n      \"[value]\",\n      \"The value to set the variable to. Omit to set it interactively.\",\n    )\n    .summary(\"Set a default variable\")\n    .description(\n      [\n        \"Set default environment variables for your project's deployment type.\",\n        \"\",\n        \"- `npx convex env default set NAME 'value'`\",\n        \"- `npx convex env default set NAME # omit a value to set one interactively`\",\n        \"- `npx convex env default set NAME --from-file value.txt`\",\n        \"- `npx convex env default set --from-file .env.defaults`\",\n        \"\",\n        \"When setting multiple values, it will refuse all changes if any variables are already set to different values by default. Pass --force to overwrite the provided values.\",\n        \"\",\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n      ].join(\"\\n\"),\n    )\n    .option(\n      \"--from-file <file>\",\n      \"Read environment variables from a .env file. Without --force, fails if any existing variable has a different value.\",\n    )\n    .option(\n      \"--force\",\n      \"When setting multiple variables, overwrite existing environment variable values instead of failing on mismatch.\",\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (name, value, cmdOptions, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default set\");\n  const didAnything = await envSet(ctx, backend, name, value, cmdOptions);\n  if (didAnything === false) {\n    cmd.outputHelp({ error: true });\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: \"error: No environment variables specified to be set.\",\n    });\n  }\n});\n\nconst envDefaultGet = addEnvDefaultOptions(\n  new Command(\"get\")\n    .argument(\n      \"<name>\",\n      \"The name of the default environment variable to print.\",\n    )\n    .summary(\"Print a default variable's value\")\n    .description(\n      \"Print a default variable's value: `npx convex env default get NAME`\\n\" +\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (envVarName, _options, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default get\");\n  await envGet(ctx, backend, envVarName);\n});\n\nconst envDefaultRemove = addEnvDefaultOptions(\n  new Command(\"remove\")\n    .alias(\"rm\")\n    .alias(\"unset\")\n    .argument(\n      \"<name>\",\n      \"The name of the default environment variable to unset.\",\n    )\n    .summary(\"Unset a default variable\")\n    .description(\n      [\n        \"Unset a default variable.\",\n        \"\",\n        \"- `npx convex env default remove NAME`\",\n        \"\",\n        \"If the variable doesn't exist, the command doesn't do anything and succeeds.\",\n        \"\",\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n      ].join(\"\\n\"),\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (name, _options, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default remove\");\n  await envRemove(ctx, backend, name);\n});\n\nconst envDefaultList = addEnvDefaultOptions(\n  new Command(\"list\")\n    .summary(\"List all default variables\")\n    .description(\n      [\n        \"List all default variables.\",\n        \"\",\n        \"- `npx convex env default list`\",\n        \"\",\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n      ].join(\"\\n\"),\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (_options, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default list\");\n  await envList(ctx, backend);\n});\n\nexport const envDefault = new Command(\"default\")\n  .summary(\"Manage project-level default environment variables\")\n  .description(\n    [\n      \"Manage default environment variables for your project.\",\n      \"\",\n      \"The default environment variables read and written to by this command are the ones for the deployment type of the current deployment (i.e. dev in most cases), unless --type is provided.\",\n      \"\",\n      \"- Set a default variable: `npx convex env default set NAME 'value'`\",\n      \"- Unset a default variable: `npx convex env default remove NAME`\",\n      \"- List all default variables: `npx convex env default list`\",\n      \"- Print a default variable's value: `npx convex env default get NAME`\",\n    ].join(\"\\n\"),\n  )\n  .addCommand(envDefaultSet)\n  .addCommand(envDefaultGet)\n  .addCommand(envDefaultRemove)\n  .addCommand(envDefaultList)\n  .helpCommand(false);\n\ntype ParsedProjectOption =\n  | { kind: \"teamAndProject\"; teamSlug: string; projectSlug: string }\n  | { kind: \"projectOnly\"; projectSlug: string };\n\nasync function resolveEnvDefaultBackend(\n  options: DeploymentSelectionOptions & EnvDefaultExtraOptions,\n): Promise<{ ctx: Context; backend: EnvVarBackend }> {\n  const dtypeOverride = normalizeTypeOption(options.type);\n\n  if (options.project !== undefined) {\n    const parsedProject = parseProjectOption(options.project);\n    if (parsedProject === null) {\n      const ctx = await oneoffContext(options);\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"error: --project must be `team-slug:project-slug` or `project-slug`.\",\n      });\n    }\n    if (dtypeOverride === undefined) {\n      const ctx = await oneoffContext(options);\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: \"error: --project requires --type to also be set.\",\n      });\n    }\n\n    let ctx: Context;\n    let resolved: { teamSlug: string; projectSlug: string };\n    if (parsedProject.kind === \"teamAndProject\") {\n      ctx = await oneoffContext(options);\n      resolved = {\n        teamSlug: parsedProject.teamSlug,\n        projectSlug: parsedProject.projectSlug,\n      };\n    } else {\n      const selected = await selectEnvDeployment(options);\n      ctx = selected.ctx;\n      if (selected.deployment.deploymentFields === null) {\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"error: --project <project-slug> requires a current cloud deployment to infer the team from. Use `team-slug:project-slug` to specify the team explicitly.\",\n        });\n      }\n      const { team } = await fetchTeamAndProject(\n        ctx,\n        selected.deployment.deploymentFields.deploymentName,\n      );\n      resolved = { teamSlug: team, projectSlug: parsedProject.projectSlug };\n    }\n\n    const details = await getProjectDetails(ctx, {\n      kind: \"teamAndProjectSlugs\",\n      teamSlug: resolved.teamSlug,\n      projectSlug: resolved.projectSlug,\n    });\n    return {\n      ctx,\n      backend: defaultEnvBackend(ctx, details.id, dtypeOverride),\n    };\n  }\n\n  const { ctx, deployment } = await selectEnvDeployment(options);\n  const backend = await resolveDefaultEnvBackend(\n    ctx,\n    deployment.deploymentFields,\n    dtypeOverride,\n  );\n  return { ctx, backend };\n}\n\nfunction normalizeTypeOption(\n  type: string | undefined,\n): CloudDeploymentType | undefined {\n  if (type === undefined) return undefined;\n  if (type === \"development\") return \"dev\";\n  if (type === \"production\") return \"prod\";\n  return type as CloudDeploymentType;\n}\n\nfunction parseProjectOption(value: string): ParsedProjectOption | null {\n  const parts = value.split(\":\");\n  if (parts.length === 1 && parts[0].length > 0) {\n    return { kind: \"projectOnly\", projectSlug: parts[0] };\n  }\n  if (parts.length === 2 && parts[0].length > 0 && parts[1].length > 0) {\n    return {\n      kind: \"teamAndProject\",\n      teamSlug: parts[0],\n      projectSlug: parts[1],\n    };\n  }\n  return null;\n}\n\nexport async function resolveDefaultEnvBackend(\n  ctx: Context,\n  deploymentFields: {\n    deploymentName: string;\n    deploymentType: DeploymentType;\n  } | null,\n  dtypeOverride?: CloudDeploymentType,\n): Promise<EnvVarBackend> {\n  if (deploymentFields === null) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"Default environment variables are only available for cloud projects.\",\n    });\n  }\n  if (deploymentFields.deploymentType === \"anonymous\") {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"Default environment variables are not available for anonymous deployments.\",\n    });\n  }\n  const dtype =\n    dtypeOverride ?? resolveDefaultEnvDtype(deploymentFields.deploymentType);\n  const { projectId } = await fetchTeamAndProject(\n    ctx,\n    deploymentFields.deploymentName,\n  );\n  return defaultEnvBackend(ctx, projectId, dtype);\n}\n\nfunction resolveDefaultEnvDtype(\n  deploymentType: Exclude<DeploymentType, \"anonymous\">,\n): CloudDeploymentType {\n  if (deploymentType === \"local\") return \"dev\";\n  return deploymentType;\n}\n"],
+  "sourcesContent": ["import { Command, Option } from \"@commander-js/extra-typings\";\nimport {\n  envGet,\n  envList,\n  envRemove,\n  envSet,\n  EnvVarBackend,\n} from \"./lib/env.js\";\nimport { ensureHasConvexDependency } from \"./lib/utils/utils.js\";\nimport { defaultEnvBackend } from \"./lib/defaultEnv.js\";\nimport {\n  CloudDeploymentType,\n  DeploymentSelectionOptions,\n  DeploymentType,\n  fetchTeamAndProject,\n} from \"./lib/api.js\";\nimport { Context, oneoffContext } from \"../bundler/context.js\";\nimport { selectEnvDeployment } from \"./env.js\";\nimport { getProjectDetails } from \"./lib/deploymentSelection.js\";\n\ntype EnvDefaultExtraOptions = {\n  type?: string;\n  project?: string;\n};\n\nfunction addEnvDefaultOptions<T extends Command<any, any>>(cmd: T): T {\n  return cmd\n    .addOption(\n      new Option(\n        \"--type <type>\",\n        \"Manage default env vars for the given deployment type (dev, preview, prod) instead of inferring from the current deployment.\",\n      ),\n    )\n    .addOption(\n      new Option(\n        \"--project <project>\",\n        \"Select a project manually. Accepts `team-slug:project-slug` or just `project-slug` (team inferred from your current project). Requires --type.\",\n      ),\n    ) as T;\n}\n\nconst envDefaultSet = addEnvDefaultOptions(\n  new Command(\"set\")\n    .usage(\"[options] <name> <value>\")\n    .argument(\"[name]\", \"The name of the default environment variable to set.\")\n    .argument(\n      \"[value]\",\n      \"The value to set the variable to. Omit to set it interactively.\",\n    )\n    .summary(\"Set a default variable\")\n    .description(\n      [\n        \"Set default environment variables for your project's deployment type.\",\n        \"\",\n        \"\u2022 `npx convex env default set NAME 'value'`\",\n        \"\u2022 `npx convex env default set NAME # omit a value to set one interactively`\",\n        \"\u2022 `npx convex env default set NAME --from-file value.txt`\",\n        \"\u2022 `npx convex env default set --from-file .env.defaults`\",\n        \"\",\n        \"When setting multiple values, it will refuse all changes if any variables are already set to different values by default. Pass --force to overwrite the provided values.\",\n        \"\",\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n      ].join(\"\\n\"),\n    )\n    .option(\n      \"--from-file <file>\",\n      \"Read environment variables from a .env file. Without --force, fails if any existing variable has a different value.\",\n    )\n    .option(\n      \"--force\",\n      \"When setting multiple variables, overwrite existing environment variable values instead of failing on mismatch.\",\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (name, value, cmdOptions, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default set\");\n  const didAnything = await envSet(ctx, backend, name, value, cmdOptions);\n  if (didAnything === false) {\n    cmd.outputHelp({ error: true });\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: \"error: No environment variables specified to be set.\",\n    });\n  }\n});\n\nconst envDefaultGet = addEnvDefaultOptions(\n  new Command(\"get\")\n    .argument(\n      \"<name>\",\n      \"The name of the default environment variable to print.\",\n    )\n    .summary(\"Print a default variable's value\")\n    .description(\n      \"Print a default variable's value: `npx convex env default get NAME`\\n\" +\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (envVarName, _options, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default get\");\n  await envGet(ctx, backend, envVarName);\n});\n\nconst envDefaultRemove = addEnvDefaultOptions(\n  new Command(\"remove\")\n    .alias(\"rm\")\n    .alias(\"unset\")\n    .argument(\n      \"<name>\",\n      \"The name of the default environment variable to unset.\",\n    )\n    .summary(\"Unset a default variable\")\n    .description(\n      [\n        \"Unset a default variable.\",\n        \"\",\n        \"\u2022 `npx convex env default remove NAME`\",\n        \"\",\n        \"If the variable doesn't exist, the command doesn't do anything and succeeds.\",\n        \"\",\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n      ].join(\"\\n\"),\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (name, _options, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default remove\");\n  await envRemove(ctx, backend, name);\n});\n\nconst envDefaultList = addEnvDefaultOptions(\n  new Command(\"list\")\n    .summary(\"List all default variables\")\n    .description(\n      [\n        \"List all default variables.\",\n        \"\",\n        \"\u2022 `npx convex env default list`\",\n        \"\",\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n      ].join(\"\\n\"),\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (_options, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default list\");\n  await envList(ctx, backend);\n});\n\nexport const envDefault = new Command(\"default\")\n  .summary(\"Manage project-level default environment variables\")\n  .description(\n    [\n      \"Manage default environment variables for your project.\",\n      \"\",\n      \"The default environment variables read and written to by this command are the ones for the deployment type of the current deployment (i.e. dev in most cases), unless --type is provided.\",\n      \"\",\n      \"\u2022 Set a default variable: `npx convex env default set NAME 'value'`\",\n      \"\u2022 Unset a default variable: `npx convex env default remove NAME`\",\n      \"\u2022 List all default variables: `npx convex env default list`\",\n      \"\u2022 Print a default variable's value: `npx convex env default get NAME`\",\n    ].join(\"\\n\"),\n  )\n  .addCommand(envDefaultSet)\n  .addCommand(envDefaultGet)\n  .addCommand(envDefaultRemove)\n  .addCommand(envDefaultList)\n  .helpCommand(false);\n\ntype ParsedProjectOption =\n  | { kind: \"teamAndProject\"; teamSlug: string; projectSlug: string }\n  | { kind: \"projectOnly\"; projectSlug: string };\n\nasync function resolveEnvDefaultBackend(\n  options: DeploymentSelectionOptions & EnvDefaultExtraOptions,\n): Promise<{ ctx: Context; backend: EnvVarBackend }> {\n  const dtypeOverride = normalizeTypeOption(options.type);\n\n  if (options.project !== undefined) {\n    const parsedProject = parseProjectOption(options.project);\n    if (parsedProject === null) {\n      const ctx = await oneoffContext(options);\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"error: --project must be `team-slug:project-slug` or `project-slug`.\",\n      });\n    }\n    if (dtypeOverride === undefined) {\n      const ctx = await oneoffContext(options);\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: \"error: --project requires --type to also be set.\",\n      });\n    }\n\n    let ctx: Context;\n    let resolved: { teamSlug: string; projectSlug: string };\n    if (parsedProject.kind === \"teamAndProject\") {\n      ctx = await oneoffContext(options);\n      resolved = {\n        teamSlug: parsedProject.teamSlug,\n        projectSlug: parsedProject.projectSlug,\n      };\n    } else {\n      const selected = await selectEnvDeployment(options);\n      ctx = selected.ctx;\n      if (selected.deployment.deploymentFields === null) {\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"error: --project <project-slug> requires a current cloud deployment to infer the team from. Use `team-slug:project-slug` to specify the team explicitly.\",\n        });\n      }\n      const { team } = await fetchTeamAndProject(\n        ctx,\n        selected.deployment.deploymentFields.deploymentName,\n      );\n      resolved = { teamSlug: team, projectSlug: parsedProject.projectSlug };\n    }\n\n    const details = await getProjectDetails(ctx, {\n      kind: \"teamAndProjectSlugs\",\n      teamSlug: resolved.teamSlug,\n      projectSlug: resolved.projectSlug,\n    });\n    return {\n      ctx,\n      backend: defaultEnvBackend(ctx, details.id, dtypeOverride),\n    };\n  }\n\n  const { ctx, deployment } = await selectEnvDeployment(options);\n  const backend = await resolveDefaultEnvBackend(\n    ctx,\n    deployment.deploymentFields,\n    dtypeOverride,\n  );\n  return { ctx, backend };\n}\n\nfunction normalizeTypeOption(\n  type: string | undefined,\n): CloudDeploymentType | undefined {\n  if (type === undefined) return undefined;\n  if (type === \"development\") return \"dev\";\n  if (type === \"production\") return \"prod\";\n  return type as CloudDeploymentType;\n}\n\nfunction parseProjectOption(value: string): ParsedProjectOption | null {\n  const parts = value.split(\":\");\n  if (parts.length === 1 && parts[0].length > 0) {\n    return { kind: \"projectOnly\", projectSlug: parts[0] };\n  }\n  if (parts.length === 2 && parts[0].length > 0 && parts[1].length > 0) {\n    return {\n      kind: \"teamAndProject\",\n      teamSlug: parts[0],\n      projectSlug: parts[1],\n    };\n  }\n  return null;\n}\n\nexport async function resolveDefaultEnvBackend(\n  ctx: Context,\n  deploymentFields: {\n    deploymentName: string;\n    deploymentType: DeploymentType;\n  } | null,\n  dtypeOverride?: CloudDeploymentType,\n): Promise<EnvVarBackend> {\n  if (deploymentFields === null) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"Default environment variables are only available for cloud projects.\",\n    });\n  }\n  if (deploymentFields.deploymentType === \"anonymous\") {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"Default environment variables are not available for anonymous deployments.\",\n    });\n  }\n  const dtype =\n    dtypeOverride ?? resolveDefaultEnvDtype(deploymentFields.deploymentType);\n  const { projectId } = await fetchTeamAndProject(\n    ctx,\n    deploymentFields.deploymentName,\n  );\n  return defaultEnvBackend(ctx, projectId, dtype);\n}\n\nfunction resolveDefaultEnvDtype(\n  deploymentType: Exclude<DeploymentType, \"anonymous\">,\n): CloudDeploymentType {\n  if (deploymentType === \"local\") return \"dev\";\n  return deploymentType;\n}\n"],
   "mappings": "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",
   "names": ["ctx"]
 }

package/dist/esm/cli/insights.js

@@ -71,9 +71,9 @@ export const insights = new Command("insights").summary("Show health insights fo
     "Show health insights for a Convex deployment over the last 72 hours.",
     "Displays OCC conflicts and resource limit issues that may indicate performance problems.",
     "",
-    "- Show insights: `npx convex insights`",
-    "- Include recent events for each insight: `npx convex insights --details`",
-    "- Check the production deployment: `npx convex insights --prod`",
+    "\u2022 Show insights: `npx convex insights`",
+    "\u2022 Include recent events for each insight: `npx convex insights --details`",
+    "\u2022 Check the production deployment: `npx convex insights --prod`",
     "",
     "This command is only available for Convex cloud deployments when logged in as a user."
   ].join("\n")

package/dist/esm/cli/insights.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/insights.ts"],
-  "sourcesContent": ["import { Command } from \"@commander-js/extra-typings\";\n// eslint-disable-next-line no-restricted-imports -- stdout output uses default chalk\nimport chalk from \"chalk\";\nimport { oneoffContext } from \"../bundler/context.js\";\nimport { logOutput } from \"../bundler/log.js\";\nimport { loadSelectedDeploymentCredentials } from \"./lib/api.js\";\nimport { actionDescription } from \"./lib/command.js\";\nimport { deploymentDashboardUrlPage } from \"./lib/dashboard.js\";\nimport { getDeploymentSelection } from \"./lib/deploymentSelection.js\";\nimport { type Insight, fetchInsights } from \"./lib/insights.js\";\n\nfunction formatInsightKind(kind: string): string {\n  switch (kind) {\n    case \"occRetried\":\n      return \"OCC Retried\";\n    case \"occFailedPermanently\":\n      return \"OCC Failed Permanently\";\n    case \"bytesReadLimit\":\n      return \"Bytes Read Limit Exceeded\";\n    case \"bytesReadThreshold\":\n      return \"Bytes Read Near Limit\";\n    case \"documentsReadLimit\":\n      return \"Documents Read Limit Exceeded\";\n    case \"documentsReadThreshold\":\n      return \"Documents Read Near Limit\";\n    default:\n      return kind;\n  }\n}\n\nfunction formatFunctionName(insight: Insight): string {\n  if (insight.componentPath) {\n    return `${insight.componentPath}:${insight.functionId}`;\n  }\n  return insight.functionId;\n}\n\nfunction formatInsight(insight: Insight, details: boolean): string {\n  const severity =\n    insight.severity === \"error\"\n      ? chalk.red(`[ERROR]`)\n      : chalk.yellow(`[WARNING]`);\n  const kind = formatInsightKind(insight.kind);\n  const fn = chalk.bold(formatFunctionName(insight));\n\n  let detail: string;\n  if (\"occCalls\" in insight) {\n    const table = insight.occTableName\n      ? ` on table ${chalk.cyan(insight.occTableName)}`\n      : \"\";\n    detail = `${insight.occCalls} OCC conflict${insight.occCalls !== 1 ? \"s\" : \"\"}${table}`;\n  } else {\n    detail = `${insight.count} occurrence${insight.count !== 1 ? \"s\" : \"\"}`;\n  }\n\n  let output = `${severity} ${kind}: ${fn} \u2014 ${detail}`;\n\n  if (details && insight.recentEvents && insight.recentEvents.length > 0) {\n    output += \"\\n\";\n    for (const event of insight.recentEvents) {\n      const time = chalk.dim(new Date(event.timestamp).toLocaleString());\n      const reqId = chalk.dim(`req:${event.request_id}`);\n\n      if (\"occ_retry_count\" in event) {\n        const docId = event.occ_document_id\n          ? ` doc:${event.occ_document_id}`\n          : \"\";\n        const source = event.occ_write_source\n          ? ` source:${event.occ_write_source}`\n          : \"\";\n        output += `    ${time}  ${reqId}  retries:${event.occ_retry_count}${docId}${source}\\n`;\n      } else {\n        const status = event.success ? chalk.green(\"ok\") : chalk.red(\"fail\");\n        const calls = event.calls\n          .map(\n            (c) =>\n              `${c.table_name}(${c.documents_read} docs, ${c.bytes_read} bytes)`,\n          )\n          .join(\", \");\n        output += `    ${time}  ${reqId}  ${status}  ${calls}\\n`;\n      }\n    }\n  }\n\n  return output;\n}\n\nexport const insights = new Command(\"insights\")\n  .summary(\"Show health insights for your deployment\")\n  .description(\n    [\n      \"Show health insights for a Convex deployment over the last 72 hours.\",\n      \"Displays OCC conflicts and resource limit issues that may indicate performance problems.\",\n      \"\",\n      \"- Show insights: `npx convex insights`\",\n      \"- Include recent events for each insight: `npx convex insights --details`\",\n      \"- Check the production deployment: `npx convex insights --prod`\",\n      \"\",\n      \"This command is only available for Convex cloud deployments when logged in as a user.\",\n    ].join(\"\\n\"),\n  )\n  .allowExcessArguments(false)\n  .option(\"--details\", \"Show recent events for each insight\", false)\n  .addDeploymentSelectionOptions(actionDescription(\"Show insights for\"))\n  .showHelpAfterError()\n  .action(async (cmdOptions) => {\n    const ctx = await oneoffContext(cmdOptions);\n\n    const deploymentSelection = await getDeploymentSelection(ctx, cmdOptions);\n    const credentials = await loadSelectedDeploymentCredentials(\n      ctx,\n      deploymentSelection,\n    );\n\n    const deploymentName = credentials.deploymentFields?.deploymentName ?? null;\n    if (deploymentName === null) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"Insights are only available for cloud deployments. Local deployments do not have insights data.\",\n      });\n    }\n\n    const auth = ctx.bigBrainAuth();\n    if (\n      auth === null ||\n      auth.kind === \"deploymentKey\" ||\n      auth.kind === \"projectKey\"\n    ) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"Insights require to be logged in as a user. Deploy keys and project keys cannot access team usage data.\",\n      });\n    }\n\n    const insightsList = await fetchInsights(ctx, deploymentName, {\n      includeRecentEvents: cmdOptions.details,\n    });\n\n    const dashboardUrl = deploymentDashboardUrlPage(\n      deploymentName,\n      \"?view=insights\",\n    );\n\n    if (insightsList.length === 0) {\n      logOutput(\n        chalk.green(\n          \"No issues found. The deployment is healthy over the last 72 hours.\",\n        ),\n      );\n    } else {\n      const errorCount = insightsList.filter(\n        (i) => i.severity === \"error\",\n      ).length;\n      const warningCount = insightsList.filter(\n        (i) => i.severity === \"warning\",\n      ).length;\n\n      const parts: string[] = [];\n      if (errorCount > 0)\n        parts.push(\n          chalk.red(`${errorCount} error${errorCount > 1 ? \"s\" : \"\"}`),\n        );\n      if (warningCount > 0)\n        parts.push(\n          chalk.yellow(`${warningCount} warning${warningCount > 1 ? \"s\" : \"\"}`),\n        );\n      logOutput(`Found ${parts.join(\" and \")} in the last 72 hours:\\n`);\n\n      for (const insight of insightsList) {\n        logOutput(formatInsight(insight, cmdOptions.details));\n      }\n    }\n\n    logOutput(`\\nDashboard: ${chalk.cyan(dashboardUrl)}`);\n  });\n"],
+  "sourcesContent": ["import { Command } from \"@commander-js/extra-typings\";\n// eslint-disable-next-line no-restricted-imports -- stdout output uses default chalk\nimport chalk from \"chalk\";\nimport { oneoffContext } from \"../bundler/context.js\";\nimport { logOutput } from \"../bundler/log.js\";\nimport { loadSelectedDeploymentCredentials } from \"./lib/api.js\";\nimport { actionDescription } from \"./lib/command.js\";\nimport { deploymentDashboardUrlPage } from \"./lib/dashboard.js\";\nimport { getDeploymentSelection } from \"./lib/deploymentSelection.js\";\nimport { type Insight, fetchInsights } from \"./lib/insights.js\";\n\nfunction formatInsightKind(kind: string): string {\n  switch (kind) {\n    case \"occRetried\":\n      return \"OCC Retried\";\n    case \"occFailedPermanently\":\n      return \"OCC Failed Permanently\";\n    case \"bytesReadLimit\":\n      return \"Bytes Read Limit Exceeded\";\n    case \"bytesReadThreshold\":\n      return \"Bytes Read Near Limit\";\n    case \"documentsReadLimit\":\n      return \"Documents Read Limit Exceeded\";\n    case \"documentsReadThreshold\":\n      return \"Documents Read Near Limit\";\n    default:\n      return kind;\n  }\n}\n\nfunction formatFunctionName(insight: Insight): string {\n  if (insight.componentPath) {\n    return `${insight.componentPath}:${insight.functionId}`;\n  }\n  return insight.functionId;\n}\n\nfunction formatInsight(insight: Insight, details: boolean): string {\n  const severity =\n    insight.severity === \"error\"\n      ? chalk.red(`[ERROR]`)\n      : chalk.yellow(`[WARNING]`);\n  const kind = formatInsightKind(insight.kind);\n  const fn = chalk.bold(formatFunctionName(insight));\n\n  let detail: string;\n  if (\"occCalls\" in insight) {\n    const table = insight.occTableName\n      ? ` on table ${chalk.cyan(insight.occTableName)}`\n      : \"\";\n    detail = `${insight.occCalls} OCC conflict${insight.occCalls !== 1 ? \"s\" : \"\"}${table}`;\n  } else {\n    detail = `${insight.count} occurrence${insight.count !== 1 ? \"s\" : \"\"}`;\n  }\n\n  let output = `${severity} ${kind}: ${fn} \u2014 ${detail}`;\n\n  if (details && insight.recentEvents && insight.recentEvents.length > 0) {\n    output += \"\\n\";\n    for (const event of insight.recentEvents) {\n      const time = chalk.dim(new Date(event.timestamp).toLocaleString());\n      const reqId = chalk.dim(`req:${event.request_id}`);\n\n      if (\"occ_retry_count\" in event) {\n        const docId = event.occ_document_id\n          ? ` doc:${event.occ_document_id}`\n          : \"\";\n        const source = event.occ_write_source\n          ? ` source:${event.occ_write_source}`\n          : \"\";\n        output += `    ${time}  ${reqId}  retries:${event.occ_retry_count}${docId}${source}\\n`;\n      } else {\n        const status = event.success ? chalk.green(\"ok\") : chalk.red(\"fail\");\n        const calls = event.calls\n          .map(\n            (c) =>\n              `${c.table_name}(${c.documents_read} docs, ${c.bytes_read} bytes)`,\n          )\n          .join(\", \");\n        output += `    ${time}  ${reqId}  ${status}  ${calls}\\n`;\n      }\n    }\n  }\n\n  return output;\n}\n\nexport const insights = new Command(\"insights\")\n  .summary(\"Show health insights for your deployment\")\n  .description(\n    [\n      \"Show health insights for a Convex deployment over the last 72 hours.\",\n      \"Displays OCC conflicts and resource limit issues that may indicate performance problems.\",\n      \"\",\n      \"\u2022 Show insights: `npx convex insights`\",\n      \"\u2022 Include recent events for each insight: `npx convex insights --details`\",\n      \"\u2022 Check the production deployment: `npx convex insights --prod`\",\n      \"\",\n      \"This command is only available for Convex cloud deployments when logged in as a user.\",\n    ].join(\"\\n\"),\n  )\n  .allowExcessArguments(false)\n  .option(\"--details\", \"Show recent events for each insight\", false)\n  .addDeploymentSelectionOptions(actionDescription(\"Show insights for\"))\n  .showHelpAfterError()\n  .action(async (cmdOptions) => {\n    const ctx = await oneoffContext(cmdOptions);\n\n    const deploymentSelection = await getDeploymentSelection(ctx, cmdOptions);\n    const credentials = await loadSelectedDeploymentCredentials(\n      ctx,\n      deploymentSelection,\n    );\n\n    const deploymentName = credentials.deploymentFields?.deploymentName ?? null;\n    if (deploymentName === null) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"Insights are only available for cloud deployments. Local deployments do not have insights data.\",\n      });\n    }\n\n    const auth = ctx.bigBrainAuth();\n    if (\n      auth === null ||\n      auth.kind === \"deploymentKey\" ||\n      auth.kind === \"projectKey\"\n    ) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"Insights require to be logged in as a user. Deploy keys and project keys cannot access team usage data.\",\n      });\n    }\n\n    const insightsList = await fetchInsights(ctx, deploymentName, {\n      includeRecentEvents: cmdOptions.details,\n    });\n\n    const dashboardUrl = deploymentDashboardUrlPage(\n      deploymentName,\n      \"?view=insights\",\n    );\n\n    if (insightsList.length === 0) {\n      logOutput(\n        chalk.green(\n          \"No issues found. The deployment is healthy over the last 72 hours.\",\n        ),\n      );\n    } else {\n      const errorCount = insightsList.filter(\n        (i) => i.severity === \"error\",\n      ).length;\n      const warningCount = insightsList.filter(\n        (i) => i.severity === \"warning\",\n      ).length;\n\n      const parts: string[] = [];\n      if (errorCount > 0)\n        parts.push(\n          chalk.red(`${errorCount} error${errorCount > 1 ? \"s\" : \"\"}`),\n        );\n      if (warningCount > 0)\n        parts.push(\n          chalk.yellow(`${warningCount} warning${warningCount > 1 ? \"s\" : \"\"}`),\n        );\n      logOutput(`Found ${parts.join(\" and \")} in the last 72 hours:\\n`);\n\n      for (const insight of insightsList) {\n        logOutput(formatInsight(insight, cmdOptions.details));\n      }\n    }\n\n    logOutput(`\\nDashboard: ${chalk.cyan(dashboardUrl)}`);\n  });\n"],
   "mappings": "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",
   "names": []
 }

package/dist/esm/cli/lib/aiFiles/skills.js

@@ -11,7 +11,7 @@ function configuredSkillAgents(aiFilesConfig) {
   return aiFilesConfig?.skills?.agents ?? defaultAgents;
 }
 function runSkillsAdd(cwd, agents) {
-  const args = ["add", "get-convex/agent-skills", "--yes"];
+  const args = ["add", "get-convex/agent-skills", "--yes", "--copy"];
   for (const agent of agents) {
     args.push("--agent", agent);
   }
@@ -74,7 +74,7 @@ export async function installSkills({
   if (!skillsOk) {
     logMessage(
       chalkStderr.yellow(
-        "Could not install agent skills. You can retry manually with: npx skills add get-convex/agent-skills"
+        "Could not install agent skills. You can retry manually with: npx skills add get-convex/agent-skills --copy"
       )
     );
     return;

package/dist/esm/cli/lib/aiFiles/skills.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/cli/lib/aiFiles/skills.ts"],
-  "sourcesContent": ["import child_process from \"child_process\";\nimport path from \"path\";\n// eslint-disable-next-line no-restricted-imports\nimport { promises as fs } from \"fs\";\nimport { chalkStderr } from \"chalk\";\nimport { logMessage } from \"../../../bundler/log.js\";\nimport { getVersion, fetchAgentSkillsSha } from \"../versionApi.js\";\nimport { type AiFilesState } from \"./state.js\";\nimport { exhaustiveCheck } from \"./utils.js\";\n\nimport { type AiFilesProjectConfig } from \"../config.js\";\n\n/**\n * Resolve the configured agent list, falling back to defaults.\n */\nfunction configuredSkillAgents(\n  aiFilesConfig?: AiFilesProjectConfig | undefined,\n): string[] {\n  // We default to the two most popular agents for now, \"codex\" installs to `.agents` which also\n  // covers cursor and many other tools. See: https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents\n  const defaultAgents = [\"claude-code\", \"codex\"];\n  return aiFilesConfig?.skills?.agents ?? defaultAgents;\n}\n\n/**\n * Runs `npx skills add get-convex/agent-skills --yes` in the given directory.\n * Returns true on success, false if the process fails or cannot be started.\n */\nfunction runSkillsAdd(cwd: string, agents: string[]): Promise<boolean> {\n  const args = [\"add\", \"get-convex/agent-skills\", \"--yes\"];\n  for (const agent of agents) {\n    args.push(\"--agent\", agent);\n  }\n  return runSkillsCommand(cwd, args).then(({ ok }) => ok);\n}\n\n/**\n * Runs `npx skills remove <name...> --yes` to surgically remove only the\n * Convex-managed skills, leaving any skills from other sources intact.\n */\nfunction runSkillsRemove({\n  cwd,\n  skillNames,\n}: {\n  cwd: string;\n  skillNames: string[];\n}): Promise<boolean> {\n  return runSkillsCommand(cwd, [\"remove\", ...skillNames, \"--yes\"]).then(\n    ({ ok }) => ok,\n  );\n}\n\n/**\n * This function exists so we have a way to disable skills installs without pushing a new\n * version of the convex CLI\n */\nasync function shouldRunSkillsCli(): Promise<boolean> {\n  const versionData = await getVersion();\n\n  if (versionData.kind === \"error\") return true;\n\n  if (versionData.kind === \"ok\") {\n    if (versionData.data.disableSkillsCli) {\n      const message =\n        versionData.data.disableSkillsCliMessage ??\n        \"Agent skills are temporarily disabled.\";\n      logMessage(chalkStderr.yellow(message));\n      return false;\n    }\n    return true;\n  }\n\n  return exhaustiveCheck(versionData);\n}\n\n/**\n * Remove the skills-lock.json file if it only contains skills that we\n * are removing. The `npx skills remove` command leaves the lockfile behind\n * even when it's logically empty.\n */\nasync function removeSkillsLockIfEmpty({\n  projectDir,\n  removedSkillNames,\n}: {\n  projectDir: string;\n  removedSkillNames: string[];\n}): Promise<boolean> {\n  const lockPath = path.join(projectDir, \"skills-lock.json\");\n  try {\n    const content = await fs.readFile(lockPath, \"utf8\");\n    const lock = JSON.parse(content);\n\n    if (\n      !lock ||\n      typeof lock !== \"object\" ||\n      !lock.skills ||\n      typeof lock.skills !== \"object\"\n    ) {\n      return false;\n    }\n\n    const remainingSkills = Object.keys(lock.skills).filter(\n      (name) => !removedSkillNames.includes(name),\n    );\n\n    if (remainingSkills.length === 0) {\n      await fs.unlink(lockPath);\n      return true;\n    }\n    return false;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Install Convex agent skills and record the SHA into the state.\n * Handles the kill-switch check and all logging internally.\n */\nexport async function installSkills({\n  projectDir,\n  state,\n  aiFilesConfig,\n}: {\n  projectDir: string;\n  state: AiFilesState;\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<void> {\n  const agents = configuredSkillAgents(aiFilesConfig);\n  if (agents.length === 0) return;\n  if (!(await shouldRunSkillsCli())) return;\n\n  logMessage(\"Installing Convex agent skills...\");\n  const skillsOk = await runSkillsAdd(projectDir, agents);\n  if (!skillsOk) {\n    logMessage(\n      chalkStderr.yellow(\n        \"Could not install agent skills. You can retry manually with: npx skills add get-convex/agent-skills\",\n      ),\n    );\n    return;\n  }\n\n  const sha = await fetchAgentSkillsSha();\n  if (sha) state.agentSkillsSha = sha;\n\n  logMessage(`${chalkStderr.green(\"\u2714\")} Skills installed`);\n}\n\nexport type RemoveInstalledSkillsStatus = \"unchanged\" | \"removed\" | \"failed\";\n\n/**\n * Remove Convex-managed agent skills and clean up the lock file if empty.\n * Returns whether removal was skipped, succeeded, or failed.\n */\nexport async function removeInstalledSkills({\n  projectDir,\n  skillNames,\n}: {\n  projectDir: string;\n  skillNames: string[];\n}): Promise<RemoveInstalledSkillsStatus> {\n  if (skillNames.length === 0) return \"unchanged\";\n  if (!(await shouldRunSkillsCli())) return \"unchanged\";\n\n  logMessage(`Removing Convex agent skills: ${skillNames.join(\", \")}`);\n  const skillsOk = await runSkillsRemove({ cwd: projectDir, skillNames });\n  if (!skillsOk) {\n    logMessage(\n      chalkStderr.yellow(\n        \"Could not remove agent skills automatically. Remove them manually with: npx skills remove\",\n      ),\n    );\n    return \"failed\";\n  }\n\n  const lockRemoved = await removeSkillsLockIfEmpty({\n    projectDir,\n    removedSkillNames: skillNames,\n  });\n\n  if (lockRemoved)\n    logMessage(`${chalkStderr.green(\"\u2714\")} Deleted skills-lock.json.`);\n\n  return \"removed\";\n}\n\nfunction runSkillsCommand(\n  cwd: string,\n  args: string[],\n): Promise<{ ok: boolean; output: string }> {\n  return new Promise((resolve) => {\n    const proc = child_process.spawn(\n      \"npx\",\n      [\"--yes\", \"skills@latest\", ...args],\n      {\n        cwd,\n        stdio: \"pipe\",\n        // .cmd files on Windows require shell execution.\n        shell: process.platform === \"win32\",\n      },\n    );\n    let capturedOutput = \"\";\n    proc.stdout?.on(\"data\", (chunk) => {\n      capturedOutput += chunk.toString();\n    });\n    proc.stderr?.on(\"data\", (chunk) => {\n      capturedOutput += chunk.toString();\n    });\n    proc.on(\"close\", (code) => {\n      if (code !== 0 && capturedOutput.trim().length > 0) {\n        const lines = capturedOutput.trim().split(/\\r?\\n/);\n        const tail = lines.slice(-10).join(\"\\n\");\n        logMessage(chalkStderr.gray(`skills output (tail):\\n${tail}`));\n      }\n      resolve({ ok: code === 0, output: capturedOutput });\n    });\n    proc.on(\"error\", () => resolve({ ok: false, output: capturedOutput }));\n  });\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import child_process from \"child_process\";\nimport path from \"path\";\n// eslint-disable-next-line no-restricted-imports\nimport { promises as fs } from \"fs\";\nimport { chalkStderr } from \"chalk\";\nimport { logMessage } from \"../../../bundler/log.js\";\nimport { getVersion, fetchAgentSkillsSha } from \"../versionApi.js\";\nimport { type AiFilesState } from \"./state.js\";\nimport { exhaustiveCheck } from \"./utils.js\";\n\nimport { type AiFilesProjectConfig } from \"../config.js\";\n\n/**\n * Resolve the configured agent list, falling back to defaults.\n */\nfunction configuredSkillAgents(\n  aiFilesConfig?: AiFilesProjectConfig | undefined,\n): string[] {\n  // We default to the two most popular agents for now, \"codex\" installs to `.agents` which also\n  // covers cursor and many other tools. See: https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents\n  const defaultAgents = [\"claude-code\", \"codex\"];\n  return aiFilesConfig?.skills?.agents ?? defaultAgents;\n}\n\n/**\n * Runs `npx skills add get-convex/agent-skills --yes --copy` in the given directory.\n * Returns true on success, false if the process fails or cannot be started.\n */\nfunction runSkillsAdd(cwd: string, agents: string[]): Promise<boolean> {\n  const args = [\"add\", \"get-convex/agent-skills\", \"--yes\", \"--copy\"];\n  for (const agent of agents) {\n    args.push(\"--agent\", agent);\n  }\n  return runSkillsCommand(cwd, args).then(({ ok }) => ok);\n}\n\n/**\n * Runs `npx skills remove <name...> --yes` to surgically remove only the\n * Convex-managed skills, leaving any skills from other sources intact.\n */\nfunction runSkillsRemove({\n  cwd,\n  skillNames,\n}: {\n  cwd: string;\n  skillNames: string[];\n}): Promise<boolean> {\n  return runSkillsCommand(cwd, [\"remove\", ...skillNames, \"--yes\"]).then(\n    ({ ok }) => ok,\n  );\n}\n\n/**\n * This function exists so we have a way to disable skills installs without pushing a new\n * version of the convex CLI\n */\nasync function shouldRunSkillsCli(): Promise<boolean> {\n  const versionData = await getVersion();\n\n  if (versionData.kind === \"error\") return true;\n\n  if (versionData.kind === \"ok\") {\n    if (versionData.data.disableSkillsCli) {\n      const message =\n        versionData.data.disableSkillsCliMessage ??\n        \"Agent skills are temporarily disabled.\";\n      logMessage(chalkStderr.yellow(message));\n      return false;\n    }\n    return true;\n  }\n\n  return exhaustiveCheck(versionData);\n}\n\n/**\n * Remove the skills-lock.json file if it only contains skills that we\n * are removing. The `npx skills remove` command leaves the lockfile behind\n * even when it's logically empty.\n */\nasync function removeSkillsLockIfEmpty({\n  projectDir,\n  removedSkillNames,\n}: {\n  projectDir: string;\n  removedSkillNames: string[];\n}): Promise<boolean> {\n  const lockPath = path.join(projectDir, \"skills-lock.json\");\n  try {\n    const content = await fs.readFile(lockPath, \"utf8\");\n    const lock = JSON.parse(content);\n\n    if (\n      !lock ||\n      typeof lock !== \"object\" ||\n      !lock.skills ||\n      typeof lock.skills !== \"object\"\n    ) {\n      return false;\n    }\n\n    const remainingSkills = Object.keys(lock.skills).filter(\n      (name) => !removedSkillNames.includes(name),\n    );\n\n    if (remainingSkills.length === 0) {\n      await fs.unlink(lockPath);\n      return true;\n    }\n    return false;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Install Convex agent skills and record the SHA into the state.\n * Handles the kill-switch check and all logging internally.\n */\nexport async function installSkills({\n  projectDir,\n  state,\n  aiFilesConfig,\n}: {\n  projectDir: string;\n  state: AiFilesState;\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<void> {\n  const agents = configuredSkillAgents(aiFilesConfig);\n  if (agents.length === 0) return;\n  if (!(await shouldRunSkillsCli())) return;\n\n  logMessage(\"Installing Convex agent skills...\");\n  const skillsOk = await runSkillsAdd(projectDir, agents);\n  if (!skillsOk) {\n    logMessage(\n      chalkStderr.yellow(\n        \"Could not install agent skills. You can retry manually with: npx skills add get-convex/agent-skills --copy\",\n      ),\n    );\n    return;\n  }\n\n  const sha = await fetchAgentSkillsSha();\n  if (sha) state.agentSkillsSha = sha;\n\n  logMessage(`${chalkStderr.green(\"\u2714\")} Skills installed`);\n}\n\nexport type RemoveInstalledSkillsStatus = \"unchanged\" | \"removed\" | \"failed\";\n\n/**\n * Remove Convex-managed agent skills and clean up the lock file if empty.\n * Returns whether removal was skipped, succeeded, or failed.\n */\nexport async function removeInstalledSkills({\n  projectDir,\n  skillNames,\n}: {\n  projectDir: string;\n  skillNames: string[];\n}): Promise<RemoveInstalledSkillsStatus> {\n  if (skillNames.length === 0) return \"unchanged\";\n  if (!(await shouldRunSkillsCli())) return \"unchanged\";\n\n  logMessage(`Removing Convex agent skills: ${skillNames.join(\", \")}`);\n  const skillsOk = await runSkillsRemove({ cwd: projectDir, skillNames });\n  if (!skillsOk) {\n    logMessage(\n      chalkStderr.yellow(\n        \"Could not remove agent skills automatically. Remove them manually with: npx skills remove\",\n      ),\n    );\n    return \"failed\";\n  }\n\n  const lockRemoved = await removeSkillsLockIfEmpty({\n    projectDir,\n    removedSkillNames: skillNames,\n  });\n\n  if (lockRemoved)\n    logMessage(`${chalkStderr.green(\"\u2714\")} Deleted skills-lock.json.`);\n\n  return \"removed\";\n}\n\nfunction runSkillsCommand(\n  cwd: string,\n  args: string[],\n): Promise<{ ok: boolean; output: string }> {\n  return new Promise((resolve) => {\n    const proc = child_process.spawn(\n      \"npx\",\n      [\"--yes\", \"skills@latest\", ...args],\n      {\n        cwd,\n        stdio: \"pipe\",\n        // .cmd files on Windows require shell execution.\n        shell: process.platform === \"win32\",\n      },\n    );\n    let capturedOutput = \"\";\n    proc.stdout?.on(\"data\", (chunk) => {\n      capturedOutput += chunk.toString();\n    });\n    proc.stderr?.on(\"data\", (chunk) => {\n      capturedOutput += chunk.toString();\n    });\n    proc.on(\"close\", (code) => {\n      if (code !== 0 && capturedOutput.trim().length > 0) {\n        const lines = capturedOutput.trim().split(/\\r?\\n/);\n        const tail = lines.slice(-10).join(\"\\n\");\n        logMessage(chalkStderr.gray(`skills output (tail):\\n${tail}`));\n      }\n      resolve({ ok: code === 0, output: capturedOutput });\n    });\n    proc.on(\"error\", () => resolve({ ok: false, output: capturedOutput }));\n  });\n}\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -210,7 +210,7 @@ Command.prototype.addImportOptions = function() {
   ).addOption(
     new Option(
       "--replace-all",
-      "Replace all existing data in the deployment with the imported tables,\n  deleting tables that don't appear in the import file or the schema,\n  and clearing tables that appear in the schema but not in the import file"
+      "Replace all existing data in the deployment with the imported tables,\ndeleting tables that don't appear in the import file or the schema,\nand clearing tables that appear in the schema but not in the import file"
     ).conflicts("--append").conflicts("--replace")
   ).option(
     "-y, --yes",