new system-udf to query process.env.CONVEX_CLOUD_URL (#34464)

create a new system-udf that's a query returning `process.env.CONVEX_CLOUD_URL`. this is currently redundant but will be used once we add canonical custom domains.

It'll be used by the dashboard, which displays the canonical domain and lets you pick a new one.

It will also be used by the CLI, which will set it to `VITE_CONVEX_URL` during deployment.

Put it in a file in `_system/cli/` which indicates it has a higher standard of backwards-compatibility, but also re-export it from `_system/frontend/` to indicate it's used in the dashboard too.

(for review to @jordanhunt22 for canonical urls and @atrakh for system udf placement and naming)

GitOrigin-RevId: a7c278a18e941dac8a6ede9cdeb2936667606bec

Author: ldanilek

npm-packages/system-udfs/convex/_generated/api.d.ts

@@ -13,6 +13,7 @@ import type {
   FilterApi,
   FunctionReference,
 } from "convex/server";
+import type * as _system_cli_convexUrl from "../_system/cli/convexUrl.js";
 import type * as _system_cli_exports from "../_system/cli/exports.js";
 import type * as _system_cli_modules from "../_system/cli/modules.js";
 import type * as _system_cli_queryEnvironmentVariables from "../_system/cli/queryEnvironmentVariables.js";
@@ -24,6 +25,7 @@ import type * as _system_frontend_addDocument from "../_system/frontend/addDocum
 import type * as _system_frontend_clearTablePage from "../_system/frontend/clearTablePage.js";
 import type * as _system_frontend_common from "../_system/frontend/common.js";
 import type * as _system_frontend_components from "../_system/frontend/components.js";
+import type * as _system_frontend_convexCloudUrl from "../_system/frontend/convexCloudUrl.js";
 import type * as _system_frontend_convexSiteUrl from "../_system/frontend/convexSiteUrl.js";
 import type * as _system_frontend_createTable from "../_system/frontend/createTable.js";
 import type * as _system_frontend_deleteDocuments from "../_system/frontend/deleteDocuments.js";
@@ -69,6 +71,7 @@ import type * as tableDefs_snapshotImport from "../tableDefs/snapshotImport.js";
  * ```
  */
 declare const fullApi: ApiFromModules<{
+  "_system/cli/convexUrl": typeof _system_cli_convexUrl;
   "_system/cli/exports": typeof _system_cli_exports;
   "_system/cli/modules": typeof _system_cli_modules;
   "_system/cli/queryEnvironmentVariables": typeof _system_cli_queryEnvironmentVariables;
@@ -80,6 +83,7 @@ declare const fullApi: ApiFromModules<{
   "_system/frontend/clearTablePage": typeof _system_frontend_clearTablePage;
   "_system/frontend/common": typeof _system_frontend_common;
   "_system/frontend/components": typeof _system_frontend_components;
+  "_system/frontend/convexCloudUrl": typeof _system_frontend_convexCloudUrl;
   "_system/frontend/convexSiteUrl": typeof _system_frontend_convexSiteUrl;
   "_system/frontend/createTable": typeof _system_frontend_createTable;
   "_system/frontend/deleteDocuments": typeof _system_frontend_deleteDocuments;

npm-packages/system-udfs/convex/_system/cli/convexUrl.ts

@@ -0,0 +1,10 @@
+import { queryPrivateSystem } from "../secretSystemTables";
+
+declare const process: { env: { CONVEX_CLOUD_URL: string } };
+
+export const cloudUrl = queryPrivateSystem({
+  args: {},
+  handler: async function () {
+    return process.env.CONVEX_CLOUD_URL;
+  },
+});

npm-packages/system-udfs/convex/_system/frontend/convexCloudUrl.ts

@@ -0,0 +1,3 @@
+import { cloudUrl } from "../cli/convexUrl";
+
+export default cloudUrl;