convex 1.43.0 → 1.45.0-alpha.0

package/dist/cjs/cli/codegen_templates/component_server.js

@@ -24,8 +24,9 @@ module.exports = __toCommonJS(component_server_exports);
 var import_common = require("./common.js");
 var import_server = require("./server.js");
 function componentServerTS(isRoot, envVars) {
-  const hasEnv = !!envVars && envVars.length > 0;
-  const envInterface = hasEnv ? (0, import_server.generateEnvInterface)(envVars) : "";
+  const emittedEnvVars = envVars === void 0 ? void 0 : (0, import_server.withPlatformEnvVars)(envVars);
+  const hasEnv = emittedEnvVars !== void 0;
+  const envInterface = hasEnv ? (0, import_server.generateEnvInterface)(emittedEnvVars) : "";
   const result = `
   ${(0, import_common.header)(
     "Generated utilities for implementing server-side Convex query and mutation functions."
@@ -128,7 +129,7 @@ function componentServerTS(isRoot, envVars) {
    * @returns The wrapped function. Import this function from \`convex/http.js\` and route it to hook it up.
    */
   export const httpAction: HttpActionBuilder = httpActionGeneric;
-  ${hasEnv ? "export const env: Env = process.env as unknown as Env;" : envVars === void 0 ? "export const env: Record<string, string | undefined> = process.env as unknown as Record<string, string | undefined>;" : ""}
+  ${hasEnv ? "export const env: Env = (globalThis as unknown as { process: { env: Env } }).process.env;" : "export const env: Record<string, string | undefined> = (globalThis as unknown as { process: { env: Record<string, string | undefined> } }).process.env;"}
 
   /**
    * A set of services for use within Convex query functions.

package/dist/cjs/cli/codegen_templates/component_server.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/codegen_templates/component_server.ts"],
-  "sourcesContent": ["import { header } from \"./common.js\";\nimport { EnvVarMeta, generateEnvInterface } from \"./server.js\";\n\nexport function componentServerTS(\n  isRoot: boolean,\n  // - undefined: not yet known (initial codegen). Emits an untyped `env` stub.\n  // - non-empty array: emit typed `Env` interface and typed `env` export.\n  // - empty array: no env vars declared. Omit `env` from generated code.\n  envVars: EnvVarMeta[] | undefined,\n): string {\n  const hasEnv = !!envVars && envVars.length > 0;\n  const envInterface = hasEnv ? generateEnvInterface(envVars!) : \"\";\n\n  const result = `\n  ${header(\n    \"Generated utilities for implementing server-side Convex query and mutation functions.\",\n  )}\n  import type {\n    ActionBuilder,\n    ${isRoot ? \"AnyComponents,\" : \"\"}\n    HttpActionBuilder,\n    MutationBuilder,\n    QueryBuilder,\n    GenericActionCtx,\n    GenericMutationCtx,\n    GenericQueryCtx,\n    GenericDatabaseReader,\n    GenericDatabaseWriter,\n  } from \"convex/server\";\n  import {\n    actionGeneric,\n    httpActionGeneric,\n    queryGeneric,\n    mutationGeneric,\n    internalActionGeneric,\n    internalMutationGeneric,\n    internalQueryGeneric,\n    ${isRoot ? \"componentsGeneric,\" : \"\"}\n  } from \"convex/server\";\n  import type { DataModel } from \"./dataModel.js\";\n  ${envInterface}\n\n  /**\n   * Define a query in this Convex app's public API.\n   *\n   * This function will be allowed to read your Convex database and will be accessible from the client.\n   *\n   * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n   * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n   */\n  export const query: QueryBuilder<DataModel, \"public\"> = queryGeneric;\n\n  /**\n   * Define a query that is only accessible from other Convex functions (but not from the client).\n   *\n   * This function will be allowed to read from your Convex database. It will not be accessible from the client.\n   *\n   * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n   * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n   */\n  export const internalQuery: QueryBuilder<DataModel, \"internal\"> = internalQueryGeneric;\n\n  /**\n   * Define a mutation in this Convex app's public API.\n   *\n   * This function will be allowed to modify your Convex database and will be accessible from the client.\n   *\n   * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n   * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n   */\n  export const mutation: MutationBuilder<DataModel, \"public\"> = mutationGeneric;\n\n  /**\n   * Define a mutation that is only accessible from other Convex functions (but not from the client).\n   *\n   * This function will be allowed to modify your Convex database. It will not be accessible from the client.\n   *\n   * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n   * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n   */\n  export const internalMutation: MutationBuilder<DataModel, \"internal\"> = internalMutationGeneric;\n\n  /**\n   * Define an action in this Convex app's public API.\n   *\n   * An action is a function which can execute any JavaScript code, including non-deterministic\n   * code and code with side-effects, like calling third-party services.\n   * They can be run in Convex's JavaScript environment or in Node.js using the \"use node\" directive.\n   * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.\n   *\n   * @param func - The action. It receives an {@link ActionCtx} as its first argument.\n   * @returns The wrapped action. Include this as an \\`export\\` to name it and make it accessible.\n   */\n  export const action: ActionBuilder<DataModel, \"public\"> = actionGeneric;\n\n  /**\n   * Define an action that is only accessible from other Convex functions (but not from the client).\n   *\n   * @param func - The function. It receives an {@link ActionCtx} as its first argument.\n   * @returns The wrapped function. Include this as an \\`export\\` to name it and make it accessible.\n   */\n  export const internalAction: ActionBuilder<DataModel, \"internal\"> = internalActionGeneric;\n\n  /**\n   * Define an HTTP action.\n   *\n   * The wrapped function will be used to respond to HTTP requests received\n   * by a Convex deployment if the requests matches the path and method where\n   * this action is routed. Be sure to route your httpAction in \\`convex/http.js\\`.\n   *\n   * @param func - The function. It receives an {@link ActionCtx} as its first argument\n   * and a Fetch API \\`Request\\` object as its second.\n   * @returns The wrapped function. Import this function from \\`convex/http.js\\` and route it to hook it up.\n   */\n  export const httpAction: HttpActionBuilder = httpActionGeneric;\n  ${hasEnv ? \"export const env: Env = process.env as unknown as Env;\" : envVars === undefined ? \"export const env: Record<string, string | undefined> = process.env as unknown as Record<string, string | undefined>;\" : \"\"}\n\n  /**\n   * A set of services for use within Convex query functions.\n   *\n   * The query context is passed as the first argument to any Convex query\n   * function run on the server.\n   *\n   * If you're using code generation, use the \\`QueryCtx\\` type in \\`convex/_generated/server.d.ts\\` instead.\n   */\n  export type QueryCtx = GenericQueryCtx<DataModel>;\n\n  /**\n   * A set of services for use within Convex mutation functions.\n   *\n   * The mutation context is passed as the first argument to any Convex mutation\n   * function run on the server.\n   *\n   * If you're using code generation, use the \\`MutationCtx\\` type in \\`convex/_generated/server.d.ts\\` instead.\n   */\n  export type MutationCtx = GenericMutationCtx<DataModel>;\n\n  /**\n   * A set of services for use within Convex action functions.\n   *\n   * The action context is passed as the first argument to any Convex action\n   * function run on the server.\n   */\n  export type ActionCtx = GenericActionCtx<DataModel>;\n\n  /**\n   * An interface to read from the database within Convex query functions.\n   *\n   * The two entry points are {@link DatabaseReader.get}, which fetches a single\n   * document by its {@link Id}, or {@link DatabaseReader.query}, which starts\n   * building a query.\n   */\n  export type DatabaseReader = GenericDatabaseReader<DataModel>;\n\n  /**\n   * An interface to read from and write to the database within Convex mutation\n   * functions.\n   *\n   * Convex guarantees that all writes within a single mutation are\n   * executed atomically, so you never have to worry about partial writes leaving\n   * your data in an inconsistent state. See [the Convex Guide](https://docs.convex.dev/understanding/convex-fundamentals/functions#atomicity-and-optimistic-concurrency-control)\n   * for the guarantees Convex provides your functions.\n   */\n  export type DatabaseWriter = GenericDatabaseWriter<DataModel>;\n  ${\n    isRoot\n      ? `\n  /**\n   * Load the API for calling functions from this Convex deployment's components.\n   */\n  export const components: AnyComponents = componentsGeneric();`\n      : \"\"\n  }\n  `;\n  return result;\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAAuB;AACvB,oBAAiD;AAE1C,SAAS,kBACd,QAIA,SACQ;AACR,QAAM,SAAS,CAAC,CAAC,WAAW,QAAQ,SAAS;AAC7C,QAAM,eAAe,aAAS,oCAAqB,OAAQ,IAAI;AAE/D,QAAM,SAAS;AAAA,QACb;AAAA,IACA;AAAA,EACF,CAAC;AAAA;AAAA;AAAA,MAGG,SAAS,mBAAmB,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAkB9B,SAAS,uBAAuB,EAAE;AAAA;AAAA;AAAA,IAGpC,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IA2EZ,SAAS,2DAA2D,YAAY,SAAY,yHAAyH,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkDvN,SACI;AAAA;AAAA;AAAA;AAAA,mEAKA,EACN;AAAA;AAEA,SAAO;AACT;",
+  "sourcesContent": ["import { header } from \"./common.js\";\nimport {\n  EnvVarMeta,\n  generateEnvInterface,\n  withPlatformEnvVars,\n} from \"./server.js\";\n\nexport function componentServerTS(\n  isRoot: boolean,\n  // - undefined: not yet known (initial codegen). Emits an untyped `env` stub.\n  // - array (empty or not): emit a typed `Env` interface and typed `env`\n  //   export. The interface always includes the platform-provided env vars.\n  envVars: EnvVarMeta[] | undefined,\n): string {\n  const emittedEnvVars =\n    envVars === undefined ? undefined : withPlatformEnvVars(envVars);\n  const hasEnv = emittedEnvVars !== undefined;\n  const envInterface = hasEnv ? generateEnvInterface(emittedEnvVars!) : \"\";\n\n  const result = `\n  ${header(\n    \"Generated utilities for implementing server-side Convex query and mutation functions.\",\n  )}\n  import type {\n    ActionBuilder,\n    ${isRoot ? \"AnyComponents,\" : \"\"}\n    HttpActionBuilder,\n    MutationBuilder,\n    QueryBuilder,\n    GenericActionCtx,\n    GenericMutationCtx,\n    GenericQueryCtx,\n    GenericDatabaseReader,\n    GenericDatabaseWriter,\n  } from \"convex/server\";\n  import {\n    actionGeneric,\n    httpActionGeneric,\n    queryGeneric,\n    mutationGeneric,\n    internalActionGeneric,\n    internalMutationGeneric,\n    internalQueryGeneric,\n    ${isRoot ? \"componentsGeneric,\" : \"\"}\n  } from \"convex/server\";\n  import type { DataModel } from \"./dataModel.js\";\n  ${envInterface}\n\n  /**\n   * Define a query in this Convex app's public API.\n   *\n   * This function will be allowed to read your Convex database and will be accessible from the client.\n   *\n   * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n   * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n   */\n  export const query: QueryBuilder<DataModel, \"public\"> = queryGeneric;\n\n  /**\n   * Define a query that is only accessible from other Convex functions (but not from the client).\n   *\n   * This function will be allowed to read from your Convex database. It will not be accessible from the client.\n   *\n   * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n   * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n   */\n  export const internalQuery: QueryBuilder<DataModel, \"internal\"> = internalQueryGeneric;\n\n  /**\n   * Define a mutation in this Convex app's public API.\n   *\n   * This function will be allowed to modify your Convex database and will be accessible from the client.\n   *\n   * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n   * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n   */\n  export const mutation: MutationBuilder<DataModel, \"public\"> = mutationGeneric;\n\n  /**\n   * Define a mutation that is only accessible from other Convex functions (but not from the client).\n   *\n   * This function will be allowed to modify your Convex database. It will not be accessible from the client.\n   *\n   * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n   * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n   */\n  export const internalMutation: MutationBuilder<DataModel, \"internal\"> = internalMutationGeneric;\n\n  /**\n   * Define an action in this Convex app's public API.\n   *\n   * An action is a function which can execute any JavaScript code, including non-deterministic\n   * code and code with side-effects, like calling third-party services.\n   * They can be run in Convex's JavaScript environment or in Node.js using the \"use node\" directive.\n   * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.\n   *\n   * @param func - The action. It receives an {@link ActionCtx} as its first argument.\n   * @returns The wrapped action. Include this as an \\`export\\` to name it and make it accessible.\n   */\n  export const action: ActionBuilder<DataModel, \"public\"> = actionGeneric;\n\n  /**\n   * Define an action that is only accessible from other Convex functions (but not from the client).\n   *\n   * @param func - The function. It receives an {@link ActionCtx} as its first argument.\n   * @returns The wrapped function. Include this as an \\`export\\` to name it and make it accessible.\n   */\n  export const internalAction: ActionBuilder<DataModel, \"internal\"> = internalActionGeneric;\n\n  /**\n   * Define an HTTP action.\n   *\n   * The wrapped function will be used to respond to HTTP requests received\n   * by a Convex deployment if the requests matches the path and method where\n   * this action is routed. Be sure to route your httpAction in \\`convex/http.js\\`.\n   *\n   * @param func - The function. It receives an {@link ActionCtx} as its first argument\n   * and a Fetch API \\`Request\\` object as its second.\n   * @returns The wrapped function. Import this function from \\`convex/http.js\\` and route it to hook it up.\n   */\n  export const httpAction: HttpActionBuilder = httpActionGeneric;\n  ${hasEnv ? \"export const env: Env = (globalThis as unknown as { process: { env: Env } }).process.env;\" : \"export const env: Record<string, string | undefined> = (globalThis as unknown as { process: { env: Record<string, string | undefined> } }).process.env;\"}\n\n  /**\n   * A set of services for use within Convex query functions.\n   *\n   * The query context is passed as the first argument to any Convex query\n   * function run on the server.\n   *\n   * If you're using code generation, use the \\`QueryCtx\\` type in \\`convex/_generated/server.d.ts\\` instead.\n   */\n  export type QueryCtx = GenericQueryCtx<DataModel>;\n\n  /**\n   * A set of services for use within Convex mutation functions.\n   *\n   * The mutation context is passed as the first argument to any Convex mutation\n   * function run on the server.\n   *\n   * If you're using code generation, use the \\`MutationCtx\\` type in \\`convex/_generated/server.d.ts\\` instead.\n   */\n  export type MutationCtx = GenericMutationCtx<DataModel>;\n\n  /**\n   * A set of services for use within Convex action functions.\n   *\n   * The action context is passed as the first argument to any Convex action\n   * function run on the server.\n   */\n  export type ActionCtx = GenericActionCtx<DataModel>;\n\n  /**\n   * An interface to read from the database within Convex query functions.\n   *\n   * The two entry points are {@link DatabaseReader.get}, which fetches a single\n   * document by its {@link Id}, or {@link DatabaseReader.query}, which starts\n   * building a query.\n   */\n  export type DatabaseReader = GenericDatabaseReader<DataModel>;\n\n  /**\n   * An interface to read from and write to the database within Convex mutation\n   * functions.\n   *\n   * Convex guarantees that all writes within a single mutation are\n   * executed atomically, so you never have to worry about partial writes leaving\n   * your data in an inconsistent state. See [the Convex Guide](https://docs.convex.dev/understanding/convex-fundamentals/functions#atomicity-and-optimistic-concurrency-control)\n   * for the guarantees Convex provides your functions.\n   */\n  export type DatabaseWriter = GenericDatabaseWriter<DataModel>;\n  ${\n    isRoot\n      ? `\n  /**\n   * Load the API for calling functions from this Convex deployment's components.\n   */\n  export const components: AnyComponents = componentsGeneric();`\n      : \"\"\n  }\n  `;\n  return result;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAAuB;AACvB,oBAIO;AAEA,SAAS,kBACd,QAIA,SACQ;AACR,QAAM,iBACJ,YAAY,SAAY,aAAY,mCAAoB,OAAO;AACjE,QAAM,SAAS,mBAAmB;AAClC,QAAM,eAAe,aAAS,oCAAqB,cAAe,IAAI;AAEtE,QAAM,SAAS;AAAA,QACb;AAAA,IACA;AAAA,EACF,CAAC;AAAA;AAAA;AAAA,MAGG,SAAS,mBAAmB,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAkB9B,SAAS,uBAAuB,EAAE;AAAA;AAAA;AAAA,IAGpC,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IA2EZ,SAAS,8FAA8F,yJAAyJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkDhQ,SACI;AAAA;AAAA;AAAA;AAAA,mEAKA,EACN;AAAA;AAEA,SAAO;AACT;",
   "names": []
 }

package/dist/cjs/cli/codegen_templates/server.js

@@ -19,38 +19,50 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var server_exports = {};
 __export(server_exports, {
   generateEnvInterface: () => generateEnvInterface,
-  serverCodegen: () => serverCodegen
+  serverCodegen: () => serverCodegen,
+  withPlatformEnvVars: () => withPlatformEnvVars
 });
 module.exports = __toCommonJS(server_exports);
 var import_common = require("./common.js");
 var import_validator_helpers = require("./validator_helpers.js");
+const PLATFORM_ENV_VARS = [
+  ["CONVEX_CLOUD_URL", { type: "value", value: '{"type":"string"}' }],
+  ["CONVEX_SITE_URL", { type: "value", value: '{"type":"string"}' }]
+];
+function withPlatformEnvVars(envVars) {
+  return [...PLATFORM_ENV_VARS, ...envVars];
+}
 const ENV_DOCSTRING = `/**
- * Typesafe environment variables declared in \`convex.config.ts\`.
+ * Typesafe environment variables.
+ *
+ * This includes platform-provided env vars and any variables declared in
+ * \`convex.config.ts\`.
  */`;
 function serverCodegen({
   useTypeScript,
   envVars
 }) {
-  const hasEnv = !!envVars && envVars.length > 0;
-  const envInterface = hasEnv ? generateEnvInterface(envVars) : "";
+  const emittedEnvVars = envVars === void 0 ? void 0 : withPlatformEnvVars(envVars);
+  const hasEnv = emittedEnvVars !== void 0;
+  const envInterface = hasEnv ? generateEnvInterface(emittedEnvVars) : "";
   const envDeclDTS = hasEnv ? `
 ${ENV_DOCSTRING}
 export declare const env: Env;
-` : envVars === void 0 ? `
+` : `
 export declare const env: Record<string, string | undefined>;
-` : "";
+`;
   const envDeclTS = hasEnv ? `
 ${ENV_DOCSTRING}
-export const env: Env = process.env as unknown as Env;
-` : envVars === void 0 ? `
-export const env: Record<string, string | undefined> = process.env as unknown as Record<string, string | undefined>;
-` : "";
+export const env: Env = (globalThis as unknown as { process: { env: Env } }).process.env;
+` : `
+export const env: Record<string, string | undefined> = (globalThis as unknown as { process: { env: Record<string, string | undefined> } }).process.env;
+`;
   const envDeclJS = hasEnv ? `
 ${ENV_DOCSTRING}
 export const env = process.env;
-` : envVars === void 0 ? `
+` : `
 export const env = process.env;
-` : "";
+`;
   if (!useTypeScript) {
     const serverDTS = `
     ${(0, import_common.header)(

package/dist/cjs/cli/codegen_templates/server.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/codegen_templates/server.ts"],
-  "sourcesContent": ["import { header } from \"./common.js\";\nimport { parseValidator, validatorToType } from \"./validator_helpers.js\";\n\nexport type EnvVarMeta = [\n  string,\n  { type: \"value\"; value: string; optional?: boolean | undefined },\n];\n\nconst ENV_DOCSTRING = `/**\n * Typesafe environment variables declared in \\`convex.config.ts\\`.\n */`;\n\nexport function serverCodegen({\n  useTypeScript,\n  envVars,\n}: {\n  useTypeScript: boolean;\n  // - undefined: env var declarations not yet known (initial codegen before\n  //   server analysis). Emits an untyped `env` stub so imports don't break.\n  // - non-empty array: emit a typed `Env` interface and typed `env` export.\n  // - empty array: no env vars declared. Omit `env` from generated code.\n  envVars: EnvVarMeta[] | undefined;\n}) {\n  const hasEnv = !!envVars && envVars.length > 0;\n  const envInterface = hasEnv ? generateEnvInterface(envVars!) : \"\";\n  const envDeclDTS = hasEnv\n    ? `\n${ENV_DOCSTRING}\nexport declare const env: Env;\n`\n    : envVars === undefined\n      ? `\nexport declare const env: Record<string, string | undefined>;\n`\n      : \"\";\n  const envDeclTS = hasEnv\n    ? `\n${ENV_DOCSTRING}\nexport const env: Env = process.env as unknown as Env;\n`\n    : envVars === undefined\n      ? `\nexport const env: Record<string, string | undefined> = process.env as unknown as Record<string, string | undefined>;\n`\n      : \"\";\n  const envDeclJS = hasEnv\n    ? `\n${ENV_DOCSTRING}\nexport const env = process.env;\n`\n    : envVars === undefined\n      ? `\nexport const env = process.env;\n`\n      : \"\";\n\n  if (!useTypeScript) {\n    // Generate separate .js and .d.ts files\n    const serverDTS = `\n    ${header(\n      \"Generated utilities for implementing server-side Convex query and mutation functions.\",\n    )}\n    import {\n      ActionBuilder,\n      HttpActionBuilder,\n      MutationBuilder,\n      QueryBuilder,\n      GenericActionCtx,\n      GenericMutationCtx,\n      GenericQueryCtx,\n      GenericDatabaseReader,\n      GenericDatabaseWriter,\n    } from \"convex/server\";\n    import type { DataModel } from \"./dataModel.js\";\n    ${envInterface}\n\n    /**\n     * Define a query in this Convex app's public API.\n     *\n     * This function will be allowed to read your Convex database and will be accessible from the client.\n     *\n     * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n     * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export declare const query: QueryBuilder<DataModel, \"public\">;\n\n    /**\n     * Define a query that is only accessible from other Convex functions (but not from the client).\n     *\n     * This function will be allowed to read from your Convex database. It will not be accessible from the client.\n     *\n     * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n     * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export declare const internalQuery: QueryBuilder<DataModel, \"internal\">;\n\n    /**\n     * Define a mutation in this Convex app's public API.\n     *\n     * This function will be allowed to modify your Convex database and will be accessible from the client.\n     *\n     * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n     * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export declare const mutation: MutationBuilder<DataModel, \"public\">;\n\n    /**\n     * Define a mutation that is only accessible from other Convex functions (but not from the client).\n     *\n     * This function will be allowed to modify your Convex database. It will not be accessible from the client.\n     *\n     * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n     * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export declare const internalMutation: MutationBuilder<DataModel, \"internal\">;\n\n    /**\n     * Define an action in this Convex app's public API.\n     *\n     * An action is a function which can execute any JavaScript code, including non-deterministic\n     * code and code with side-effects, like calling third-party services.\n     * They can be run in Convex's JavaScript environment or in Node.js using the \"use node\" directive.\n     * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.\n     *\n     * @param func - The action. It receives an {@link ActionCtx} as its first argument.\n     * @returns The wrapped action. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export declare const action: ActionBuilder<DataModel, \"public\">;\n\n    /**\n     * Define an action that is only accessible from other Convex functions (but not from the client).\n     *\n     * @param func - The function. It receives an {@link ActionCtx} as its first argument.\n     * @returns The wrapped function. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export declare const internalAction: ActionBuilder<DataModel, \"internal\">;\n\n    /**\n     * Define an HTTP action.\n     *\n     * The wrapped function will be used to respond to HTTP requests received\n     * by a Convex deployment if the requests matches the path and method where\n     * this action is routed. Be sure to route your httpAction in \\`convex/http.js\\`.\n     *\n     * @param func - The function. It receives an {@link ActionCtx} as its first argument\n     * and a Fetch API \\`Request\\` object as its second.\n     * @returns The wrapped function. Import this function from \\`convex/http.js\\` and route it to hook it up.\n     */\n    export declare const httpAction: HttpActionBuilder;\n${envDeclDTS}\n    /**\n     * A set of services for use within Convex query functions.\n     *\n     * The query context is passed as the first argument to any Convex query\n     * function run on the server.\n     *\n     * This differs from the {@link MutationCtx} because all of the services are\n     * read-only.\n     */\n    export type QueryCtx = GenericQueryCtx<DataModel>;\n\n    /**\n     * A set of services for use within Convex mutation functions.\n     *\n     * The mutation context is passed as the first argument to any Convex mutation\n     * function run on the server.\n     */\n    export type MutationCtx = GenericMutationCtx<DataModel>;\n\n    /**\n     * A set of services for use within Convex action functions.\n     *\n     * The action context is passed as the first argument to any Convex action\n     * function run on the server.\n     */\n    export type ActionCtx = GenericActionCtx<DataModel>;\n\n    /**\n     * An interface to read from the database within Convex query functions.\n     *\n     * The two entry points are {@link DatabaseReader.get}, which fetches a single\n     * document by its {@link Id}, or {@link DatabaseReader.query}, which starts\n     * building a query.\n     */\n    export type DatabaseReader = GenericDatabaseReader<DataModel>;\n\n    /**\n     * An interface to read from and write to the database within Convex mutation\n     * functions.\n     *\n     * Convex guarantees that all writes within a single mutation are\n     * executed atomically, so you never have to worry about partial writes leaving\n     * your data in an inconsistent state. See [the Convex Guide](https://docs.convex.dev/understanding/convex-fundamentals/functions#atomicity-and-optimistic-concurrency-control)\n     * for the guarantees Convex provides your functions.\n     */\n    export type DatabaseWriter = GenericDatabaseWriter<DataModel>;`;\n\n    const serverJS = `\n    ${header(\n      \"Generated utilities for implementing server-side Convex query and mutation functions.\",\n    )}\n    import {\n      actionGeneric,\n      httpActionGeneric,\n      queryGeneric,\n      mutationGeneric,\n      internalActionGeneric,\n      internalMutationGeneric,\n      internalQueryGeneric,\n    } from \"convex/server\";\n\n    /**\n     * Define a query in this Convex app's public API.\n     *\n     * This function will be allowed to read your Convex database and will be accessible from the client.\n     *\n     * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n     * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export const query = queryGeneric;\n\n    /**\n     * Define a query that is only accessible from other Convex functions (but not from the client).\n     *\n     * This function will be allowed to read from your Convex database. It will not be accessible from the client.\n     *\n     * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n     * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export const internalQuery = internalQueryGeneric;\n\n    /**\n     * Define a mutation in this Convex app's public API.\n     *\n     * This function will be allowed to modify your Convex database and will be accessible from the client.\n     *\n     * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n     * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export const mutation = mutationGeneric;\n\n    /**\n     * Define a mutation that is only accessible from other Convex functions (but not from the client).\n     *\n     * This function will be allowed to modify your Convex database. It will not be accessible from the client.\n     *\n     * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n     * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export const internalMutation = internalMutationGeneric;\n\n    /**\n     * Define an action in this Convex app's public API.\n     *\n     * An action is a function which can execute any JavaScript code, including non-deterministic\n     * code and code with side-effects, like calling third-party services.\n     * They can be run in Convex's JavaScript environment or in Node.js using the \"use node\" directive.\n     * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.\n     *\n     * @param func - The action. It receives an {@link ActionCtx} as its first argument.\n     * @returns The wrapped action. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export const action = actionGeneric;\n\n    /**\n     * Define an action that is only accessible from other Convex functions (but not from the client).\n     *\n     * @param func - The function. It receives an {@link ActionCtx} as its first argument.\n     * @returns The wrapped function. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export const internalAction = internalActionGeneric;\n\n    /**\n     * Define an HTTP action.\n     *\n     * The wrapped function will be used to respond to HTTP requests received\n     * by a Convex deployment if the requests matches the path and method where\n     * this action is routed. Be sure to route your httpAction in \\`convex/http.js\\`.\n     *\n     * @param func - The function. It receives an {@link ActionCtx} as its first argument\n     * and a Fetch API \\`Request\\` object as its second.\n     * @returns The wrapped function. Import this function from \\`convex/http.js\\` and route it to hook it up.\n     */\n    export const httpAction = httpActionGeneric;\n${envDeclJS}\n    `;\n\n    return {\n      DTS: serverDTS,\n      JS: serverJS,\n    };\n  } else {\n    // Generate combined .ts file\n    const serverTS = `${header(\n      \"Generated utilities for implementing server-side Convex query and mutation functions.\",\n    )}\nimport {\n  actionGeneric,\n  httpActionGeneric,\n  queryGeneric,\n  mutationGeneric,\n  internalActionGeneric,\n  internalMutationGeneric,\n  internalQueryGeneric,\n} from \"convex/server\";\nimport type {\n  ActionBuilder,\n  HttpActionBuilder,\n  MutationBuilder,\n  QueryBuilder,\n  GenericActionCtx,\n  GenericMutationCtx,\n  GenericQueryCtx,\n  GenericDatabaseReader,\n  GenericDatabaseWriter,\n} from \"convex/server\";\nimport type { DataModel } from \"./dataModel.js\";\n${envInterface}\n\n/**\n * Define a query in this Convex app's public API.\n *\n * This function will be allowed to read your Convex database and will be accessible from the client.\n *\n * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n */\nexport const query: QueryBuilder<DataModel, \"public\"> = queryGeneric;\n\n/**\n * Define a query that is only accessible from other Convex functions (but not from the client).\n *\n * This function will be allowed to read from your Convex database. It will not be accessible from the client.\n *\n * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n */\nexport const internalQuery: QueryBuilder<DataModel, \"internal\"> = internalQueryGeneric;\n\n/**\n * Define a mutation in this Convex app's public API.\n *\n * This function will be allowed to modify your Convex database and will be accessible from the client.\n *\n * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n */\nexport const mutation: MutationBuilder<DataModel, \"public\"> = mutationGeneric;\n\n/**\n * Define a mutation that is only accessible from other Convex functions (but not from the client).\n *\n * This function will be allowed to modify your Convex database. It will not be accessible from the client.\n *\n * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n */\nexport const internalMutation: MutationBuilder<DataModel, \"internal\"> = internalMutationGeneric;\n\n/**\n * Define an action in this Convex app's public API.\n *\n * An action is a function which can execute any JavaScript code, including non-deterministic\n * code and code with side-effects, like calling third-party services.\n * They can be run in Convex's JavaScript environment or in Node.js using the \"use node\" directive.\n * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.\n *\n * @param func - The action. It receives an {@link ActionCtx} as its first argument.\n * @returns The wrapped action. Include this as an \\`export\\` to name it and make it accessible.\n */\nexport const action: ActionBuilder<DataModel, \"public\"> = actionGeneric;\n\n/**\n * Define an action that is only accessible from other Convex functions (but not from the client).\n *\n * @param func - The function. It receives an {@link ActionCtx} as its first argument.\n * @returns The wrapped function. Include this as an \\`export\\` to name it and make it accessible.\n */\nexport const internalAction: ActionBuilder<DataModel, \"internal\"> = internalActionGeneric;\n\n/**\n * Define an HTTP action.\n *\n * The wrapped function will be used to respond to HTTP requests received\n * by a Convex deployment if the requests matches the path and method where\n * this action is routed. Be sure to route your httpAction in \\`convex/http.js\\`.\n *\n * @param func - The function. It receives an {@link ActionCtx} as its first argument\n * and a Fetch API \\`Request\\` object as its second.\n * @returns The wrapped function. Import this function from \\`convex/http.js\\` and route it to hook it up.\n */\nexport const httpAction: HttpActionBuilder = httpActionGeneric;\n${envDeclTS}\n/**\n * A set of services for use within Convex query functions.\n *\n * The query context is passed as the first argument to any Convex query\n * function run on the server.\n *\n * This differs from the {@link MutationCtx} because all of the services are\n * read-only.\n */\nexport type QueryCtx = GenericQueryCtx<DataModel>;\n\n/**\n * A set of services for use within Convex mutation functions.\n *\n * The mutation context is passed as the first argument to any Convex mutation\n * function run on the server.\n */\nexport type MutationCtx = GenericMutationCtx<DataModel>;\n\n/**\n * A set of services for use within Convex action functions.\n *\n * The action context is passed as the first argument to any Convex action\n * function run on the server.\n */\nexport type ActionCtx = GenericActionCtx<DataModel>;\n\n/**\n * An interface to read from the database within Convex query functions.\n *\n * The two entry points are {@link DatabaseReader.get}, which fetches a single\n * document by its {@link Id}, or {@link DatabaseReader.query}, which starts\n * building a query.\n */\nexport type DatabaseReader = GenericDatabaseReader<DataModel>;\n\n/**\n * An interface to read from and write to the database within Convex mutation\n * functions.\n *\n * Convex guarantees that all writes within a single mutation are\n * executed atomically, so you never have to worry about partial writes leaving\n * your data in an inconsistent state. See [the Convex Guide](https://docs.convex.dev/understanding/convex-fundamentals/functions#atomicity-and-optimistic-concurrency-control)\n * for the guarantees Convex provides your functions.\n */\nexport type DatabaseWriter = GenericDatabaseWriter<DataModel>;`;\n\n    return {\n      TS: serverTS,\n    };\n  }\n}\n\nexport function generateEnvInterface(envVars: EnvVarMeta[]): string {\n  const lines: string[] = [];\n  for (const [name, decl] of envVars) {\n    const parsed = parseValidator(decl.value);\n    let tsType = parsed ? validatorToType(parsed, false) : \"unknown\";\n    if (decl.optional) {\n      tsType += \" | undefined\";\n    }\n    lines.push(`  readonly ${name}: ${tsType};`);\n  }\n  return `\n${ENV_DOCSTRING}\ntype Env = {\n${lines.join(\"\\n\")}\n};`;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { header } from \"./common.js\";\nimport { parseValidator, validatorToType } from \"./validator_helpers.js\";\n\nexport type EnvVarMeta = [\n  string,\n  { type: \"value\"; value: string; optional?: boolean | undefined },\n];\n\n// Environment variables the platform always injects into every deployment,\n// independent of the user's `convex.config.ts` declarations. Both are always\n// present, so they're typed as required `string`.\nconst PLATFORM_ENV_VARS: EnvVarMeta[] = [\n  [\"CONVEX_CLOUD_URL\", { type: \"value\", value: '{\"type\":\"string\"}' }],\n  [\"CONVEX_SITE_URL\", { type: \"value\", value: '{\"type\":\"string\"}' }],\n];\n\n// Prepend the always-present platform env vars. Users can't declare env vars\n// with these names \u2014 the backend rejects overriding built-in system env vars \u2014\n// so there's no collision to worry about.\nexport function withPlatformEnvVars(envVars: EnvVarMeta[]): EnvVarMeta[] {\n  return [...PLATFORM_ENV_VARS, ...envVars];\n}\n\nconst ENV_DOCSTRING = `/**\n * Typesafe environment variables.\n *\n * This includes platform-provided env vars and any variables declared in\n * \\`convex.config.ts\\`.\n */`;\n\nexport function serverCodegen({\n  useTypeScript,\n  envVars,\n}: {\n  useTypeScript: boolean;\n  // - undefined: env var declarations not yet known (initial codegen before\n  //   server analysis). Emits an untyped `env` stub so imports don't break.\n  // - array (empty or not): emit a typed `Env` interface and typed `env`\n  //   export. The interface always includes the platform-provided env vars, so\n  //   an empty array still yields a typed `env` with just those.\n  envVars: EnvVarMeta[] | undefined;\n}) {\n  const emittedEnvVars =\n    envVars === undefined ? undefined : withPlatformEnvVars(envVars);\n  const hasEnv = emittedEnvVars !== undefined;\n  const envInterface = hasEnv ? generateEnvInterface(emittedEnvVars!) : \"\";\n  const envDeclDTS = hasEnv\n    ? `\n${ENV_DOCSTRING}\nexport declare const env: Env;\n`\n    : `\nexport declare const env: Record<string, string | undefined>;\n`;\n  // Route through `globalThis` rather than the bare `process` global so the\n  // generated file typechecks even in projects without `@types/node`.\n  const envDeclTS = hasEnv\n    ? `\n${ENV_DOCSTRING}\nexport const env: Env = (globalThis as unknown as { process: { env: Env } }).process.env;\n`\n    : `\nexport const env: Record<string, string | undefined> = (globalThis as unknown as { process: { env: Record<string, string | undefined> } }).process.env;\n`;\n  const envDeclJS = hasEnv\n    ? `\n${ENV_DOCSTRING}\nexport const env = process.env;\n`\n    : `\nexport const env = process.env;\n`;\n\n  if (!useTypeScript) {\n    // Generate separate .js and .d.ts files\n    const serverDTS = `\n    ${header(\n      \"Generated utilities for implementing server-side Convex query and mutation functions.\",\n    )}\n    import {\n      ActionBuilder,\n      HttpActionBuilder,\n      MutationBuilder,\n      QueryBuilder,\n      GenericActionCtx,\n      GenericMutationCtx,\n      GenericQueryCtx,\n      GenericDatabaseReader,\n      GenericDatabaseWriter,\n    } from \"convex/server\";\n    import type { DataModel } from \"./dataModel.js\";\n    ${envInterface}\n\n    /**\n     * Define a query in this Convex app's public API.\n     *\n     * This function will be allowed to read your Convex database and will be accessible from the client.\n     *\n     * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n     * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export declare const query: QueryBuilder<DataModel, \"public\">;\n\n    /**\n     * Define a query that is only accessible from other Convex functions (but not from the client).\n     *\n     * This function will be allowed to read from your Convex database. It will not be accessible from the client.\n     *\n     * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n     * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export declare const internalQuery: QueryBuilder<DataModel, \"internal\">;\n\n    /**\n     * Define a mutation in this Convex app's public API.\n     *\n     * This function will be allowed to modify your Convex database and will be accessible from the client.\n     *\n     * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n     * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export declare const mutation: MutationBuilder<DataModel, \"public\">;\n\n    /**\n     * Define a mutation that is only accessible from other Convex functions (but not from the client).\n     *\n     * This function will be allowed to modify your Convex database. It will not be accessible from the client.\n     *\n     * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n     * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export declare const internalMutation: MutationBuilder<DataModel, \"internal\">;\n\n    /**\n     * Define an action in this Convex app's public API.\n     *\n     * An action is a function which can execute any JavaScript code, including non-deterministic\n     * code and code with side-effects, like calling third-party services.\n     * They can be run in Convex's JavaScript environment or in Node.js using the \"use node\" directive.\n     * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.\n     *\n     * @param func - The action. It receives an {@link ActionCtx} as its first argument.\n     * @returns The wrapped action. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export declare const action: ActionBuilder<DataModel, \"public\">;\n\n    /**\n     * Define an action that is only accessible from other Convex functions (but not from the client).\n     *\n     * @param func - The function. It receives an {@link ActionCtx} as its first argument.\n     * @returns The wrapped function. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export declare const internalAction: ActionBuilder<DataModel, \"internal\">;\n\n    /**\n     * Define an HTTP action.\n     *\n     * The wrapped function will be used to respond to HTTP requests received\n     * by a Convex deployment if the requests matches the path and method where\n     * this action is routed. Be sure to route your httpAction in \\`convex/http.js\\`.\n     *\n     * @param func - The function. It receives an {@link ActionCtx} as its first argument\n     * and a Fetch API \\`Request\\` object as its second.\n     * @returns The wrapped function. Import this function from \\`convex/http.js\\` and route it to hook it up.\n     */\n    export declare const httpAction: HttpActionBuilder;\n${envDeclDTS}\n    /**\n     * A set of services for use within Convex query functions.\n     *\n     * The query context is passed as the first argument to any Convex query\n     * function run on the server.\n     *\n     * This differs from the {@link MutationCtx} because all of the services are\n     * read-only.\n     */\n    export type QueryCtx = GenericQueryCtx<DataModel>;\n\n    /**\n     * A set of services for use within Convex mutation functions.\n     *\n     * The mutation context is passed as the first argument to any Convex mutation\n     * function run on the server.\n     */\n    export type MutationCtx = GenericMutationCtx<DataModel>;\n\n    /**\n     * A set of services for use within Convex action functions.\n     *\n     * The action context is passed as the first argument to any Convex action\n     * function run on the server.\n     */\n    export type ActionCtx = GenericActionCtx<DataModel>;\n\n    /**\n     * An interface to read from the database within Convex query functions.\n     *\n     * The two entry points are {@link DatabaseReader.get}, which fetches a single\n     * document by its {@link Id}, or {@link DatabaseReader.query}, which starts\n     * building a query.\n     */\n    export type DatabaseReader = GenericDatabaseReader<DataModel>;\n\n    /**\n     * An interface to read from and write to the database within Convex mutation\n     * functions.\n     *\n     * Convex guarantees that all writes within a single mutation are\n     * executed atomically, so you never have to worry about partial writes leaving\n     * your data in an inconsistent state. See [the Convex Guide](https://docs.convex.dev/understanding/convex-fundamentals/functions#atomicity-and-optimistic-concurrency-control)\n     * for the guarantees Convex provides your functions.\n     */\n    export type DatabaseWriter = GenericDatabaseWriter<DataModel>;`;\n\n    const serverJS = `\n    ${header(\n      \"Generated utilities for implementing server-side Convex query and mutation functions.\",\n    )}\n    import {\n      actionGeneric,\n      httpActionGeneric,\n      queryGeneric,\n      mutationGeneric,\n      internalActionGeneric,\n      internalMutationGeneric,\n      internalQueryGeneric,\n    } from \"convex/server\";\n\n    /**\n     * Define a query in this Convex app's public API.\n     *\n     * This function will be allowed to read your Convex database and will be accessible from the client.\n     *\n     * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n     * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export const query = queryGeneric;\n\n    /**\n     * Define a query that is only accessible from other Convex functions (but not from the client).\n     *\n     * This function will be allowed to read from your Convex database. It will not be accessible from the client.\n     *\n     * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n     * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export const internalQuery = internalQueryGeneric;\n\n    /**\n     * Define a mutation in this Convex app's public API.\n     *\n     * This function will be allowed to modify your Convex database and will be accessible from the client.\n     *\n     * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n     * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export const mutation = mutationGeneric;\n\n    /**\n     * Define a mutation that is only accessible from other Convex functions (but not from the client).\n     *\n     * This function will be allowed to modify your Convex database. It will not be accessible from the client.\n     *\n     * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n     * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export const internalMutation = internalMutationGeneric;\n\n    /**\n     * Define an action in this Convex app's public API.\n     *\n     * An action is a function which can execute any JavaScript code, including non-deterministic\n     * code and code with side-effects, like calling third-party services.\n     * They can be run in Convex's JavaScript environment or in Node.js using the \"use node\" directive.\n     * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.\n     *\n     * @param func - The action. It receives an {@link ActionCtx} as its first argument.\n     * @returns The wrapped action. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export const action = actionGeneric;\n\n    /**\n     * Define an action that is only accessible from other Convex functions (but not from the client).\n     *\n     * @param func - The function. It receives an {@link ActionCtx} as its first argument.\n     * @returns The wrapped function. Include this as an \\`export\\` to name it and make it accessible.\n     */\n    export const internalAction = internalActionGeneric;\n\n    /**\n     * Define an HTTP action.\n     *\n     * The wrapped function will be used to respond to HTTP requests received\n     * by a Convex deployment if the requests matches the path and method where\n     * this action is routed. Be sure to route your httpAction in \\`convex/http.js\\`.\n     *\n     * @param func - The function. It receives an {@link ActionCtx} as its first argument\n     * and a Fetch API \\`Request\\` object as its second.\n     * @returns The wrapped function. Import this function from \\`convex/http.js\\` and route it to hook it up.\n     */\n    export const httpAction = httpActionGeneric;\n${envDeclJS}\n    `;\n\n    return {\n      DTS: serverDTS,\n      JS: serverJS,\n    };\n  } else {\n    // Generate combined .ts file\n    const serverTS = `${header(\n      \"Generated utilities for implementing server-side Convex query and mutation functions.\",\n    )}\nimport {\n  actionGeneric,\n  httpActionGeneric,\n  queryGeneric,\n  mutationGeneric,\n  internalActionGeneric,\n  internalMutationGeneric,\n  internalQueryGeneric,\n} from \"convex/server\";\nimport type {\n  ActionBuilder,\n  HttpActionBuilder,\n  MutationBuilder,\n  QueryBuilder,\n  GenericActionCtx,\n  GenericMutationCtx,\n  GenericQueryCtx,\n  GenericDatabaseReader,\n  GenericDatabaseWriter,\n} from \"convex/server\";\nimport type { DataModel } from \"./dataModel.js\";\n${envInterface}\n\n/**\n * Define a query in this Convex app's public API.\n *\n * This function will be allowed to read your Convex database and will be accessible from the client.\n *\n * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n */\nexport const query: QueryBuilder<DataModel, \"public\"> = queryGeneric;\n\n/**\n * Define a query that is only accessible from other Convex functions (but not from the client).\n *\n * This function will be allowed to read from your Convex database. It will not be accessible from the client.\n *\n * @param func - The query function. It receives a {@link QueryCtx} as its first argument.\n * @returns The wrapped query. Include this as an \\`export\\` to name it and make it accessible.\n */\nexport const internalQuery: QueryBuilder<DataModel, \"internal\"> = internalQueryGeneric;\n\n/**\n * Define a mutation in this Convex app's public API.\n *\n * This function will be allowed to modify your Convex database and will be accessible from the client.\n *\n * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n */\nexport const mutation: MutationBuilder<DataModel, \"public\"> = mutationGeneric;\n\n/**\n * Define a mutation that is only accessible from other Convex functions (but not from the client).\n *\n * This function will be allowed to modify your Convex database. It will not be accessible from the client.\n *\n * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.\n * @returns The wrapped mutation. Include this as an \\`export\\` to name it and make it accessible.\n */\nexport const internalMutation: MutationBuilder<DataModel, \"internal\"> = internalMutationGeneric;\n\n/**\n * Define an action in this Convex app's public API.\n *\n * An action is a function which can execute any JavaScript code, including non-deterministic\n * code and code with side-effects, like calling third-party services.\n * They can be run in Convex's JavaScript environment or in Node.js using the \"use node\" directive.\n * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.\n *\n * @param func - The action. It receives an {@link ActionCtx} as its first argument.\n * @returns The wrapped action. Include this as an \\`export\\` to name it and make it accessible.\n */\nexport const action: ActionBuilder<DataModel, \"public\"> = actionGeneric;\n\n/**\n * Define an action that is only accessible from other Convex functions (but not from the client).\n *\n * @param func - The function. It receives an {@link ActionCtx} as its first argument.\n * @returns The wrapped function. Include this as an \\`export\\` to name it and make it accessible.\n */\nexport const internalAction: ActionBuilder<DataModel, \"internal\"> = internalActionGeneric;\n\n/**\n * Define an HTTP action.\n *\n * The wrapped function will be used to respond to HTTP requests received\n * by a Convex deployment if the requests matches the path and method where\n * this action is routed. Be sure to route your httpAction in \\`convex/http.js\\`.\n *\n * @param func - The function. It receives an {@link ActionCtx} as its first argument\n * and a Fetch API \\`Request\\` object as its second.\n * @returns The wrapped function. Import this function from \\`convex/http.js\\` and route it to hook it up.\n */\nexport const httpAction: HttpActionBuilder = httpActionGeneric;\n${envDeclTS}\n/**\n * A set of services for use within Convex query functions.\n *\n * The query context is passed as the first argument to any Convex query\n * function run on the server.\n *\n * This differs from the {@link MutationCtx} because all of the services are\n * read-only.\n */\nexport type QueryCtx = GenericQueryCtx<DataModel>;\n\n/**\n * A set of services for use within Convex mutation functions.\n *\n * The mutation context is passed as the first argument to any Convex mutation\n * function run on the server.\n */\nexport type MutationCtx = GenericMutationCtx<DataModel>;\n\n/**\n * A set of services for use within Convex action functions.\n *\n * The action context is passed as the first argument to any Convex action\n * function run on the server.\n */\nexport type ActionCtx = GenericActionCtx<DataModel>;\n\n/**\n * An interface to read from the database within Convex query functions.\n *\n * The two entry points are {@link DatabaseReader.get}, which fetches a single\n * document by its {@link Id}, or {@link DatabaseReader.query}, which starts\n * building a query.\n */\nexport type DatabaseReader = GenericDatabaseReader<DataModel>;\n\n/**\n * An interface to read from and write to the database within Convex mutation\n * functions.\n *\n * Convex guarantees that all writes within a single mutation are\n * executed atomically, so you never have to worry about partial writes leaving\n * your data in an inconsistent state. See [the Convex Guide](https://docs.convex.dev/understanding/convex-fundamentals/functions#atomicity-and-optimistic-concurrency-control)\n * for the guarantees Convex provides your functions.\n */\nexport type DatabaseWriter = GenericDatabaseWriter<DataModel>;`;\n\n    return {\n      TS: serverTS,\n    };\n  }\n}\n\nexport function generateEnvInterface(envVars: EnvVarMeta[]): string {\n  const lines: string[] = [];\n  for (const [name, decl] of envVars) {\n    const parsed = parseValidator(decl.value);\n    let tsType = parsed ? validatorToType(parsed, false) : \"unknown\";\n    if (decl.optional) {\n      tsType += \" | undefined\";\n    }\n    lines.push(`  readonly ${name}: ${tsType};`);\n  }\n  return `\n${ENV_DOCSTRING}\ntype Env = {\n${lines.join(\"\\n\")}\n};`;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/cli/convexExport.js

@@ -58,7 +58,7 @@ const convexExport = new import_extra_typings.Command("export").summary("Export
     deploymentNotice,
     snapshotExportDashboardLink: (0, import_dashboard.deploymentDashboardUrlPage)(
       deployment.deploymentFields?.deploymentName ?? null,
-      "/settings/snapshot-export"
+      "/settings/snapshots"
     )
   });
 });

package/dist/cjs/cli/convexExport.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/convexExport.ts"],
-  "sourcesContent": ["import { Command } from \"@commander-js/extra-typings\";\nimport { chalkStderr } from \"chalk\";\nimport { ensureHasConvexDependency } from \"./lib/utils/utils.js\";\nimport { oneoffContext } from \"../bundler/context.js\";\nimport { loadSelectedDeploymentCredentials } from \"./lib/api.js\";\nimport { deploymentDashboardUrlPage } from \"./lib/dashboard.js\";\nimport { actionDescription } from \"./lib/command.js\";\nimport { exportFromDeployment } from \"./lib/convexExport.js\";\nimport { getDeploymentSelection } from \"./lib/deploymentSelection.js\";\nexport const convexExport = new Command(\"export\")\n  .summary(\"Export data from your deployment to a ZIP file\")\n  .description(\n    [\n      \"Export data, and optionally file storage, from your Convex deployment to a ZIP file.\",\n      \"\",\n      \"\u2022 Export to a directory: `npx convex export --path dir/`\",\n      \"\u2022 Export to a ZIP file: `npx convex export --path snapshot.zip`\",\n      \"\u2022 Include file storage: `npx convex export --include-file-storage --path dir/`\",\n      \"\",\n      \"By default, this exports from your dev deployment.\",\n      \"\",\n      \"See the data export guide (https://docs.convex.dev/database/import-export/export) for details and use cases.\",\n    ].join(\"\\n\"),\n  )\n  .allowExcessArguments(false)\n  .addExportOptions()\n  .addDeploymentSelectionOptions(actionDescription(\"Export data from\"))\n  .showHelpAfterError()\n  .action(async (options) => {\n    const ctx = await oneoffContext(options);\n    await ensureHasConvexDependency(ctx, \"export\");\n\n    const deploymentSelection = await getDeploymentSelection(ctx, options);\n    const deployment = await loadSelectedDeploymentCredentials(\n      ctx,\n      deploymentSelection,\n    );\n\n    const deploymentNotice = options.prod\n      ? ` in your ${chalkStderr.bold(\"prod\")} deployment`\n      : \"\";\n    await exportFromDeployment(ctx, {\n      ...options,\n      deploymentUrl: deployment.url,\n      adminKey: deployment.adminKey,\n      deploymentNotice,\n      snapshotExportDashboardLink: deploymentDashboardUrlPage(\n        deployment.deploymentFields?.deploymentName ?? null,\n        \"/settings/snapshot-export\",\n      ),\n    });\n  });\n"],
+  "sourcesContent": ["import { Command } from \"@commander-js/extra-typings\";\nimport { chalkStderr } from \"chalk\";\nimport { ensureHasConvexDependency } from \"./lib/utils/utils.js\";\nimport { oneoffContext } from \"../bundler/context.js\";\nimport { loadSelectedDeploymentCredentials } from \"./lib/api.js\";\nimport { deploymentDashboardUrlPage } from \"./lib/dashboard.js\";\nimport { actionDescription } from \"./lib/command.js\";\nimport { exportFromDeployment } from \"./lib/convexExport.js\";\nimport { getDeploymentSelection } from \"./lib/deploymentSelection.js\";\nexport const convexExport = new Command(\"export\")\n  .summary(\"Export data from your deployment to a ZIP file\")\n  .description(\n    [\n      \"Export data, and optionally file storage, from your Convex deployment to a ZIP file.\",\n      \"\",\n      \"\u2022 Export to a directory: `npx convex export --path dir/`\",\n      \"\u2022 Export to a ZIP file: `npx convex export --path snapshot.zip`\",\n      \"\u2022 Include file storage: `npx convex export --include-file-storage --path dir/`\",\n      \"\",\n      \"By default, this exports from your dev deployment.\",\n      \"\",\n      \"See the data export guide (https://docs.convex.dev/database/import-export/export) for details and use cases.\",\n    ].join(\"\\n\"),\n  )\n  .allowExcessArguments(false)\n  .addExportOptions()\n  .addDeploymentSelectionOptions(actionDescription(\"Export data from\"))\n  .showHelpAfterError()\n  .action(async (options) => {\n    const ctx = await oneoffContext(options);\n    await ensureHasConvexDependency(ctx, \"export\");\n\n    const deploymentSelection = await getDeploymentSelection(ctx, options);\n    const deployment = await loadSelectedDeploymentCredentials(\n      ctx,\n      deploymentSelection,\n    );\n\n    const deploymentNotice = options.prod\n      ? ` in your ${chalkStderr.bold(\"prod\")} deployment`\n      : \"\";\n    await exportFromDeployment(ctx, {\n      ...options,\n      deploymentUrl: deployment.url,\n      adminKey: deployment.adminKey,\n      deploymentNotice,\n      snapshotExportDashboardLink: deploymentDashboardUrlPage(\n        deployment.deploymentFields?.deploymentName ?? null,\n        \"/settings/snapshots\",\n      ),\n    });\n  });\n"],
   "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2BAAwB;AACxB,mBAA4B;AAC5B,mBAA0C;AAC1C,qBAA8B;AAC9B,iBAAkD;AAClD,uBAA2C;AAC3C,qBAAkC;AAClC,0BAAqC;AACrC,iCAAuC;AAChC,MAAM,eAAe,IAAI,6BAAQ,QAAQ,EAC7C,QAAQ,gDAAgD,EACxD;AAAA,EACC;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb,EACC,qBAAqB,KAAK,EAC1B,iBAAiB,EACjB,kCAA8B,kCAAkB,kBAAkB,CAAC,EACnE,mBAAmB,EACnB,OAAO,OAAO,YAAY;AACzB,QAAM,MAAM,UAAM,8BAAc,OAAO;AACvC,YAAM,wCAA0B,KAAK,QAAQ;AAE7C,QAAM,sBAAsB,UAAM,mDAAuB,KAAK,OAAO;AACrE,QAAM,aAAa,UAAM;AAAA,IACvB;AAAA,IACA;AAAA,EACF;AAEA,QAAM,mBAAmB,QAAQ,OAC7B,YAAY,yBAAY,KAAK,MAAM,CAAC,gBACpC;AACJ,YAAM,0CAAqB,KAAK;AAAA,IAC9B,GAAG;AAAA,IACH,eAAe,WAAW;AAAA,IAC1B,UAAU,WAAW;AAAA,IACrB;AAAA,IACA,iCAA6B;AAAA,MAC3B,WAAW,kBAAkB,kBAAkB;AAAA,MAC/C;AAAA,IACF;AAAA,EACF,CAAC;AACH,CAAC;",
   "names": []
 }

package/dist/cjs/cli/index.js

@@ -30,9 +30,8 @@ var import_node_net = __toESM(require("node:net"), 1);
 var import_undici = require("undici");
 var import_log = require("../bundler/log.js");
 var import_program = require("./program.js");
-const HARD_MINIMUM_NODE_MAJOR_VERSION = 16;
-const HARD_MINIMUM_NODE_MINOR_VERSION = 15;
-const SOFT_MINIMUM_NODE_MAJOR_VERSION = 20;
+const HARD_MINIMUM_NODE_MAJOR_VERSION = 20;
+const HARD_MINIMUM_NODE_MINOR_VERSION = 0;
 function logToStderr(...args) {
   process.stderr.write(`${(0, import_util.format)(...args)}
 `);
@@ -76,35 +75,6 @@ async function main() {
     );
     process.exit(1);
   }
-  if (majorVersion < SOFT_MINIMUM_NODE_MAJOR_VERSION) {
-    logToStderr(
-      import_chalk.chalkStderr.yellow(
-        `Warning: Your Node version ${nodeVersion} is below the recommended minimum of Node v${SOFT_MINIMUM_NODE_MAJOR_VERSION}.x. Convex may work but could behave unexpectedly.`
-      )
-    );
-    logToStderr(
-      import_chalk.chalkStderr.gray(
-        `We recommend upgrading Node to v${SOFT_MINIMUM_NODE_MAJOR_VERSION} or newer.`
-      )
-    );
-    logToStderr(
-      import_chalk.chalkStderr.gray(
-        `You can use ${import_chalk.chalkStderr.bold(
-          "nvm"
-        )} (https://github.com/nvm-sh/nvm#installing-and-updating) to manage different versions of Node.`
-      )
-    );
-    logToStderr(
-      import_chalk.chalkStderr.gray(
-        "After installing `nvm`, install the latest version of Node with " + import_chalk.chalkStderr.bold("`nvm install node`.")
-      )
-    );
-    logToStderr(
-      import_chalk.chalkStderr.gray(
-        "Then, activate the installed version in your terminal with " + import_chalk.chalkStderr.bold("`nvm use`.")
-      )
-    );
-  }
   const program = (0, import_program.buildProgram)();
   try {
     await program.parseAsync(process.argv);

package/dist/cjs/cli/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/index.ts"],
-  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport * as Sentry from \"@sentry/node\";\nimport { initSentry } from \"./lib/utils/sentry.js\";\nimport { format } from \"util\";\nimport dns from \"node:dns\";\nimport net from \"node:net\";\nimport { setGlobalDispatcher, EnvHttpProxyAgent } from \"undici\";\nimport { logVerbose } from \"../bundler/log.js\";\nimport { buildProgram } from \"./program.js\";\n\nconst HARD_MINIMUM_NODE_MAJOR_VERSION = 16;\nconst HARD_MINIMUM_NODE_MINOR_VERSION = 15;\nconst SOFT_MINIMUM_NODE_MAJOR_VERSION = 20;\n\n// console.error before it started being red by default in Node.js v20\nfunction logToStderr(...args: unknown[]) {\n  process.stderr.write(`${format(...args)}\\n`);\n}\n\nasync function main() {\n  const nodeVersion = process.versions.node;\n  const majorVersion = parseInt(nodeVersion.split(\".\")[0], 10);\n  const minorVersion = parseInt(nodeVersion.split(\".\")[1], 10);\n\n  const proxy = process.env.HTTPS_PROXY || process.env.HTTP_PROXY;\n  if (proxy) {\n    setGlobalDispatcher(new EnvHttpProxyAgent());\n    logVerbose(`[proxy-bootstrap] Using proxy: ${proxy}`);\n  }\n\n  // Use ipv4 first for 127.0.0.1 in tests\n  dns.setDefaultResultOrder(\"ipv4first\");\n\n  // Increase the timeout from default 250ms for high latency situations,\n  // see https://github.com/nodejs/node/issues/54359.\n  if (majorVersion >= 20) {\n    // While we use Node.js v18 types\n    (net as any).setDefaultAutoSelectFamilyAttemptTimeout?.(1000);\n  }\n\n  initSentry();\n\n  if (\n    majorVersion < HARD_MINIMUM_NODE_MAJOR_VERSION ||\n    (majorVersion === HARD_MINIMUM_NODE_MAJOR_VERSION &&\n      minorVersion < HARD_MINIMUM_NODE_MINOR_VERSION)\n  ) {\n    logToStderr(\n      chalkStderr.red(\n        `Your Node version ${nodeVersion} is too old. Convex requires at least Node v${HARD_MINIMUM_NODE_MAJOR_VERSION}.${HARD_MINIMUM_NODE_MINOR_VERSION}`,\n      ),\n    );\n    logToStderr(\n      chalkStderr.gray(\n        `You can use ${chalkStderr.bold(\n          \"nvm\",\n        )} (https://github.com/nvm-sh/nvm#installing-and-updating) to manage different versions of Node.`,\n      ),\n    );\n    logToStderr(\n      chalkStderr.gray(\n        \"After installing `nvm`, install the latest version of Node with \" +\n          chalkStderr.bold(\"`nvm install node`.\"),\n      ),\n    );\n    logToStderr(\n      chalkStderr.gray(\n        \"Then, activate the installed version in your terminal with \" +\n          chalkStderr.bold(\"`nvm use`.\"),\n      ),\n    );\n    process.exit(1);\n  }\n\n  if (majorVersion < SOFT_MINIMUM_NODE_MAJOR_VERSION) {\n    logToStderr(\n      chalkStderr.yellow(\n        `Warning: Your Node version ${nodeVersion} is below the recommended minimum of Node v${SOFT_MINIMUM_NODE_MAJOR_VERSION}.x. Convex may work but could behave unexpectedly.`,\n      ),\n    );\n    logToStderr(\n      chalkStderr.gray(\n        `We recommend upgrading Node to v${SOFT_MINIMUM_NODE_MAJOR_VERSION} or newer.`,\n      ),\n    );\n    logToStderr(\n      chalkStderr.gray(\n        `You can use ${chalkStderr.bold(\n          \"nvm\",\n        )} (https://github.com/nvm-sh/nvm#installing-and-updating) to manage different versions of Node.`,\n      ),\n    );\n    logToStderr(\n      chalkStderr.gray(\n        \"After installing `nvm`, install the latest version of Node with \" +\n          chalkStderr.bold(\"`nvm install node`.\"),\n      ),\n    );\n    logToStderr(\n      chalkStderr.gray(\n        \"Then, activate the installed version in your terminal with \" +\n          chalkStderr.bold(\"`nvm use`.\"),\n      ),\n    );\n  }\n\n  const program = buildProgram();\n\n  // Run the command and be sure to flush Sentry before exiting.\n  try {\n    await program.parseAsync(process.argv);\n  } catch (e) {\n    Sentry.captureException(e);\n    process.exitCode = 1;\n    // This is too early to use `logError`, so just log directly.\n    // eslint-disable-next-line no-console\n    console.error(chalkStderr.red(\"Unexpected Error: \" + e));\n  } finally {\n    await Sentry.close();\n  }\n  // When stdout is a pipe, Node buffers writes and `process.exit()` does not\n  // wait for them to flush \u2014 drain first so piped output isn't truncated.\n  await Promise.all([\n    new Promise<void>((resolve) => process.stdout.write(\"\", () => resolve())),\n    new Promise<void>((resolve) => process.stderr.write(\"\", () => resolve())),\n  ]);\n  process.exit();\n}\nvoid main();\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;AAAA,mBAA4B;AAC5B,aAAwB;AACxB,oBAA2B;AAC3B,kBAAuB;AACvB,sBAAgB;AAChB,sBAAgB;AAChB,oBAAuD;AACvD,iBAA2B;AAC3B,qBAA6B;AAE7B,MAAM,kCAAkC;AACxC,MAAM,kCAAkC;AACxC,MAAM,kCAAkC;AAGxC,SAAS,eAAe,MAAiB;AACvC,UAAQ,OAAO,MAAM,OAAG,oBAAO,GAAG,IAAI,CAAC;AAAA,CAAI;AAC7C;AAEA,eAAe,OAAO;AACpB,QAAM,cAAc,QAAQ,SAAS;AACrC,QAAM,eAAe,SAAS,YAAY,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE;AAC3D,QAAM,eAAe,SAAS,YAAY,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE;AAE3D,QAAM,QAAQ,QAAQ,IAAI,eAAe,QAAQ,IAAI;AACrD,MAAI,OAAO;AACT,2CAAoB,IAAI,gCAAkB,CAAC;AAC3C,+BAAW,kCAAkC,KAAK,EAAE;AAAA,EACtD;AAGA,kBAAAA,QAAI,sBAAsB,WAAW;AAIrC,MAAI,gBAAgB,IAAI;AAEtB,IAAC,gBAAAC,QAAY,2CAA2C,GAAI;AAAA,EAC9D;AAEA,gCAAW;AAEX,MACE,eAAe,mCACd,iBAAiB,mCAChB,eAAe,iCACjB;AACA;AAAA,MACE,yBAAY;AAAA,QACV,qBAAqB,WAAW,+CAA+C,+BAA+B,IAAI,+BAA+B;AAAA,MACnJ;AAAA,IACF;AACA;AAAA,MACE,yBAAY;AAAA,QACV,eAAe,yBAAY;AAAA,UACzB;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AACA;AAAA,MACE,yBAAY;AAAA,QACV,qEACE,yBAAY,KAAK,qBAAqB;AAAA,MAC1C;AAAA,IACF;AACA;AAAA,MACE,yBAAY;AAAA,QACV,gEACE,yBAAY,KAAK,YAAY;AAAA,MACjC;AAAA,IACF;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,eAAe,iCAAiC;AAClD;AAAA,MACE,yBAAY;AAAA,QACV,8BAA8B,WAAW,8CAA8C,+BAA+B;AAAA,MACxH;AAAA,IACF;AACA;AAAA,MACE,yBAAY;AAAA,QACV,mCAAmC,+BAA+B;AAAA,MACpE;AAAA,IACF;AACA;AAAA,MACE,yBAAY;AAAA,QACV,eAAe,yBAAY;AAAA,UACzB;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AACA;AAAA,MACE,yBAAY;AAAA,QACV,qEACE,yBAAY,KAAK,qBAAqB;AAAA,MAC1C;AAAA,IACF;AACA;AAAA,MACE,yBAAY;AAAA,QACV,gEACE,yBAAY,KAAK,YAAY;AAAA,MACjC;AAAA,IACF;AAAA,EACF;AAEA,QAAM,cAAU,6BAAa;AAG7B,MAAI;AACF,UAAM,QAAQ,WAAW,QAAQ,IAAI;AAAA,EACvC,SAAS,GAAG;AACV,WAAO,iBAAiB,CAAC;AACzB,YAAQ,WAAW;AAGnB,YAAQ,MAAM,yBAAY,IAAI,uBAAuB,CAAC,CAAC;AAAA,EACzD,UAAE;AACA,UAAM,OAAO,MAAM;AAAA,EACrB;AAGA,QAAM,QAAQ,IAAI;AAAA,IAChB,IAAI,QAAc,CAAC,YAAY,QAAQ,OAAO,MAAM,IAAI,MAAM,QAAQ,CAAC,CAAC;AAAA,IACxE,IAAI,QAAc,CAAC,YAAY,QAAQ,OAAO,MAAM,IAAI,MAAM,QAAQ,CAAC,CAAC;AAAA,EAC1E,CAAC;AACD,UAAQ,KAAK;AACf;AACA,KAAK,KAAK;",
+  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport * as Sentry from \"@sentry/node\";\nimport { initSentry } from \"./lib/utils/sentry.js\";\nimport { format } from \"util\";\nimport dns from \"node:dns\";\nimport net from \"node:net\";\nimport { setGlobalDispatcher, EnvHttpProxyAgent } from \"undici\";\nimport { logVerbose } from \"../bundler/log.js\";\nimport { buildProgram } from \"./program.js\";\n\nconst HARD_MINIMUM_NODE_MAJOR_VERSION = 20;\nconst HARD_MINIMUM_NODE_MINOR_VERSION = 0;\n\n// console.error before it started being red by default in Node.js v20\nfunction logToStderr(...args: unknown[]) {\n  process.stderr.write(`${format(...args)}\\n`);\n}\n\nasync function main() {\n  const nodeVersion = process.versions.node;\n  const majorVersion = parseInt(nodeVersion.split(\".\")[0], 10);\n  const minorVersion = parseInt(nodeVersion.split(\".\")[1], 10);\n\n  const proxy = process.env.HTTPS_PROXY || process.env.HTTP_PROXY;\n  if (proxy) {\n    setGlobalDispatcher(new EnvHttpProxyAgent());\n    logVerbose(`[proxy-bootstrap] Using proxy: ${proxy}`);\n  }\n\n  // Use ipv4 first for 127.0.0.1 in tests\n  dns.setDefaultResultOrder(\"ipv4first\");\n\n  // Increase the timeout from default 250ms for high latency situations,\n  // see https://github.com/nodejs/node/issues/54359.\n  if (majorVersion >= 20) {\n    // While we use Node.js v18 types\n    (net as any).setDefaultAutoSelectFamilyAttemptTimeout?.(1000);\n  }\n\n  initSentry();\n\n  if (\n    majorVersion < HARD_MINIMUM_NODE_MAJOR_VERSION ||\n    (majorVersion === HARD_MINIMUM_NODE_MAJOR_VERSION &&\n      minorVersion < HARD_MINIMUM_NODE_MINOR_VERSION)\n  ) {\n    logToStderr(\n      chalkStderr.red(\n        `Your Node version ${nodeVersion} is too old. Convex requires at least Node v${HARD_MINIMUM_NODE_MAJOR_VERSION}.${HARD_MINIMUM_NODE_MINOR_VERSION}`,\n      ),\n    );\n    logToStderr(\n      chalkStderr.gray(\n        `You can use ${chalkStderr.bold(\n          \"nvm\",\n        )} (https://github.com/nvm-sh/nvm#installing-and-updating) to manage different versions of Node.`,\n      ),\n    );\n    logToStderr(\n      chalkStderr.gray(\n        \"After installing `nvm`, install the latest version of Node with \" +\n          chalkStderr.bold(\"`nvm install node`.\"),\n      ),\n    );\n    logToStderr(\n      chalkStderr.gray(\n        \"Then, activate the installed version in your terminal with \" +\n          chalkStderr.bold(\"`nvm use`.\"),\n      ),\n    );\n    process.exit(1);\n  }\n\n  const program = buildProgram();\n\n  // Run the command and be sure to flush Sentry before exiting.\n  try {\n    await program.parseAsync(process.argv);\n  } catch (e) {\n    Sentry.captureException(e);\n    process.exitCode = 1;\n    // This is too early to use `logError`, so just log directly.\n    // eslint-disable-next-line no-console\n    console.error(chalkStderr.red(\"Unexpected Error: \" + e));\n  } finally {\n    await Sentry.close();\n  }\n  // When stdout is a pipe, Node buffers writes and `process.exit()` does not\n  // wait for them to flush \u2014 drain first so piped output isn't truncated.\n  await Promise.all([\n    new Promise<void>((resolve) => process.stdout.write(\"\", () => resolve())),\n    new Promise<void>((resolve) => process.stderr.write(\"\", () => resolve())),\n  ]);\n  process.exit();\n}\nvoid main();\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;AAAA,mBAA4B;AAC5B,aAAwB;AACxB,oBAA2B;AAC3B,kBAAuB;AACvB,sBAAgB;AAChB,sBAAgB;AAChB,oBAAuD;AACvD,iBAA2B;AAC3B,qBAA6B;AAE7B,MAAM,kCAAkC;AACxC,MAAM,kCAAkC;AAGxC,SAAS,eAAe,MAAiB;AACvC,UAAQ,OAAO,MAAM,OAAG,oBAAO,GAAG,IAAI,CAAC;AAAA,CAAI;AAC7C;AAEA,eAAe,OAAO;AACpB,QAAM,cAAc,QAAQ,SAAS;AACrC,QAAM,eAAe,SAAS,YAAY,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE;AAC3D,QAAM,eAAe,SAAS,YAAY,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE;AAE3D,QAAM,QAAQ,QAAQ,IAAI,eAAe,QAAQ,IAAI;AACrD,MAAI,OAAO;AACT,2CAAoB,IAAI,gCAAkB,CAAC;AAC3C,+BAAW,kCAAkC,KAAK,EAAE;AAAA,EACtD;AAGA,kBAAAA,QAAI,sBAAsB,WAAW;AAIrC,MAAI,gBAAgB,IAAI;AAEtB,IAAC,gBAAAC,QAAY,2CAA2C,GAAI;AAAA,EAC9D;AAEA,gCAAW;AAEX,MACE,eAAe,mCACd,iBAAiB,mCAChB,eAAe,iCACjB;AACA;AAAA,MACE,yBAAY;AAAA,QACV,qBAAqB,WAAW,+CAA+C,+BAA+B,IAAI,+BAA+B;AAAA,MACnJ;AAAA,IACF;AACA;AAAA,MACE,yBAAY;AAAA,QACV,eAAe,yBAAY;AAAA,UACzB;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AACA;AAAA,MACE,yBAAY;AAAA,QACV,qEACE,yBAAY,KAAK,qBAAqB;AAAA,MAC1C;AAAA,IACF;AACA;AAAA,MACE,yBAAY;AAAA,QACV,gEACE,yBAAY,KAAK,YAAY;AAAA,MACjC;AAAA,IACF;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,cAAU,6BAAa;AAG7B,MAAI;AACF,UAAM,QAAQ,WAAW,QAAQ,IAAI;AAAA,EACvC,SAAS,GAAG;AACV,WAAO,iBAAiB,CAAC;AACzB,YAAQ,WAAW;AAGnB,YAAQ,MAAM,yBAAY,IAAI,uBAAuB,CAAC,CAAC;AAAA,EACzD,UAAE;AACA,UAAM,OAAO,MAAM;AAAA,EACrB;AAGA,QAAM,QAAQ,IAAI;AAAA,IAChB,IAAI,QAAc,CAAC,YAAY,QAAQ,OAAO,MAAM,IAAI,MAAM,QAAQ,CAAC,CAAC;AAAA,IACxE,IAAI,QAAc,CAAC,YAAY,QAAQ,OAAO,MAAM,IAAI,MAAM,QAAQ,CAAC,CAAC;AAAA,EAC1E,CAAC;AACD,UAAQ,KAAK;AACf;AACA,KAAK,KAAK;",
   "names": ["dns", "net"]
 }

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

@@ -150,11 +150,17 @@ async function validateDeploymentSelectionForExistingDeployment(ctx, deploymentS
 }
 async function hasAccessToProject(ctx, selector) {
   try {
-    await (0, import_utils.bigBrainAPIMaybeThrows)({
-      ctx,
-      path: `teams/${selector.teamSlug}/projects/${selector.projectSlug}/deployments`,
-      method: "GET"
-    });
+    await (0, import_utils.typedPlatformClient)(ctx, { throw: true }).GET(
+      "/teams/{team_id_or_slug}/projects/{project_slug}",
+      {
+        params: {
+          path: {
+            team_id_or_slug: selector.teamSlug,
+            project_slug: selector.projectSlug
+          }
+        }
+      }
+    );
     return true;
   } catch (err) {
     if (err instanceof import_utils.ThrowingFetchError && (err.serverErrorData?.code === "TeamNotFound" || err.serverErrorData?.code === "ProjectNotFound")) {