@estifanos-sh/convex-auth 0.0.5-alpha.0 → 0.0.6

package/dist/bin.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
 import { execFileSync } from "node:child_process";
-import { existsSync, lstatSync, mkdtempSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { existsSync, lstatSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import os, { tmpdir } from "node:os";
 import path, { dirname, join } from "node:path";
 import process$1, { stdin, stdout } from "node:process";
 import { fileURLToPath } from "node:url";
-import { stripVTControlCharacters, styleText } from "node:util";
+import { parseArgs, stripVTControlCharacters, styleText } from "node:util";
 import * as _ from "node:readline";
 import P from "node:readline";
 import tty, { ReadStream } from "node:tty";
@@ -6251,6 +6251,49 @@ gradient.summer = summer;
 gradient.rainbow = rainbow;
 gradient.pastel = pastel;
 
+//#endregion
+//#region src/cli/convex.ts
+const cliPathByProject = /* @__PURE__ */ new Map();
+/** Resolve the Convex CLI installed for a project without invoking its package manager. */
+function resolveConvexCliPath(projectDirectory = process$1.cwd()) {
+	const projectPath = path.resolve(projectDirectory);
+	const cached = cliPathByProject.get(projectPath);
+	if (cached !== void 0) return cached;
+	const requireFromProject = createRequire(path.join(projectPath, "package.json"));
+	let packagePath;
+	try {
+		packagePath = requireFromProject.resolve("convex/package.json");
+	} catch (cause) {
+		if (typeof cause === "object" && cause !== null && "code" in cause && cause.code !== "MODULE_NOT_FOUND") throw new Error("Could not resolve the project-local Convex package metadata.", { cause });
+		throw new Error("Could not find the project-local \"convex\" package. Install Convex in this project before running convex-auth.", { cause });
+	}
+	let parsedPackageJson;
+	try {
+		parsedPackageJson = JSON.parse(readFileSync(packagePath, "utf8"));
+	} catch (cause) {
+		throw new Error(`Could not read Convex package metadata at ${packagePath}.`, { cause });
+	}
+	if (typeof parsedPackageJson !== "object" || parsedPackageJson === null || Array.isArray(parsedPackageJson)) throw new Error(`Convex package metadata at ${packagePath} is not a JSON object.`);
+	const packageJson = parsedPackageJson;
+	const bin = typeof packageJson.bin === "string" ? packageJson.bin : packageJson.bin?.convex;
+	if (typeof bin !== "string" || bin.length === 0) throw new Error("The installed \"convex\" package does not expose a convex CLI executable.");
+	const cliPath = path.resolve(path.dirname(packagePath), bin);
+	try {
+		if (!statSync(cliPath).isFile()) throw new Error("not a file");
+	} catch (cause) {
+		throw new Error(`The installed "convex" package points to a missing or invalid CLI file: ${cliPath}`, { cause });
+	}
+	cliPathByProject.set(projectPath, cliPath);
+	return cliPath;
+}
+/** Build a shell-free command for the project-local Convex CLI. */
+function convexCommand(...args) {
+	return {
+		file: process$1.execPath,
+		args: [resolveConvexCliPath(), ...args]
+	};
+}
+
 //#endregion
 //#region src/shared/keyring.ts
 /** Version of the serialized auth keyring stored in `AUTH_KEYS`. */
@@ -6321,59 +6364,6 @@ function getPackageVersion() {
 	return "unknown";
 }
 const version = getPackageVersion();
-function detectPackageRunner() {
-	let dir = process$1.cwd();
-	const root = path.parse(dir).root;
-	while (dir !== root) {
-		const pkgPath = path.join(dir, "package.json");
-		if (existsSync(pkgPath)) try {
-			const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-			if (typeof pkg.packageManager === "string") {
-				const name = pkg.packageManager.split("@")[0];
-				if (name === "pnpm") return {
-					cmd: "pnpm",
-					args: ["exec"]
-				};
-				if (name === "bun") return {
-					cmd: "bunx",
-					args: []
-				};
-				if (name === "yarn") return {
-					cmd: "yarn",
-					args: ["dlx"]
-				};
-			}
-		} catch {}
-		if (existsSync(path.join(dir, "pnpm-lock.yaml"))) return {
-			cmd: "pnpm",
-			args: ["exec"]
-		};
-		if (existsSync(path.join(dir, "bun.lockb")) || existsSync(path.join(dir, "bun.lock"))) return {
-			cmd: "bunx",
-			args: []
-		};
-		if (existsSync(path.join(dir, "yarn.lock"))) return {
-			cmd: "yarn",
-			args: ["dlx"]
-		};
-		dir = path.dirname(dir);
-	}
-	return {
-		cmd: "npx",
-		args: []
-	};
-}
-const runner = detectPackageRunner();
-function convexCmd(...subArgs) {
-	return {
-		file: runner.cmd,
-		args: [
-			...runner.args,
-			"convex",
-			...subArgs
-		]
-	};
-}
 const flagDefs = new Map([
 	["app-url", {
 		type: "string",
@@ -6395,6 +6385,10 @@ const flagDefs = new Map([
 		type: "string",
 		description: "Convex deployment URL."
 	}],
+	["site-url", {
+		type: "string",
+		description: "Convex HTTP actions URL (required when it cannot be derived)."
+	}],
 	["admin-key", {
 		type: "string",
 		description: "Convex admin key."
@@ -6403,13 +6397,9 @@ const flagDefs = new Map([
 		type: "boolean",
 		description: "Set environment variables on this project's production deployment."
 	}],
-	["preview-name", {
-		type: "string",
-		description: "Set environment variables on the preview deployment with the given name."
-	}],
-	["deployment-name", {
+	["deployment", {
 		type: "string",
-		description: "Set environment variables on the specified deployment."
+		description: "Target a Convex deployment selector."
 	}],
 	["help", {
 		type: "boolean",
@@ -6437,73 +6427,58 @@ function printHelp() {
 	}
 	console.log();
 }
-function parseArgs(argv) {
-	const rawArgs = argv.slice(2);
-	const knownCommands = new Set([
+/** @internal */
+function parseCliOptions(argv) {
+	let parsed;
+	try {
+		parsed = parseArgs({
+			args: argv.slice(2),
+			options: Object.fromEntries([...flagDefs].map(([name, definition]) => [name, { type: definition.type }])),
+			allowPositionals: true,
+			strict: true
+		});
+	} catch (error) {
+		logErrorAndExit(error instanceof Error ? error.message : String(error));
+	}
+	const [commandName, ...extraPositionals] = parsed.positionals;
+	if (commandName !== void 0 && !new Set([
 		"setup",
 		"doctor",
 		"urls",
 		"keys"
-	]);
-	const firstArg = rawArgs[0];
-	const command = knownCommands.has(firstArg ?? "") ? firstArg : "setup";
-	const args = command === "setup" && !knownCommands.has(firstArg ?? "") ? rawArgs : rawArgs.slice(1);
-	const strings = /* @__PURE__ */ new Map();
-	const booleans = /* @__PURE__ */ new Set();
-	let i = 0;
-	while (i < args.length) {
-		const arg = args[i];
-		if (!arg.startsWith("--")) {
-			i++;
-			continue;
-		}
-		const name = arg.slice(2);
-		const def = flagDefs.get(name);
-		if (def === void 0) {
-			O.error(`Unknown flag: ${arg}`);
-			process$1.exit(1);
-		}
-		if (def.type === "boolean") {
-			booleans.add(name);
-			i++;
-		} else {
-			const value = args[i + 1];
-			if (value === void 0 || value.startsWith("--")) {
-				O.error(`Flag --${name} requires a value.`);
-				process$1.exit(1);
-			}
-			strings.set(name, value);
-			i += 2;
-		}
-	}
-	if (booleans.has("help")) {
+	]).has(commandName)) logErrorAndExit(`Unknown command: ${commandName}`);
+	if (extraPositionals.length > 0) logErrorAndExit(`Unexpected arguments: ${extraPositionals.join(" ")}`);
+	if (parsed.values.help === true) {
 		printHelp();
 		process$1.exit(0);
 	}
-	if (booleans.has("version")) {
+	if (parsed.values.version === true) {
 		console.log(version);
 		process$1.exit(0);
 	}
+	const stringValue = (name) => {
+		const value = parsed.values[name];
+		return typeof value === "string" ? value : void 0;
+	};
 	return {
-		command,
-		appUrl: strings.get("app-url"),
-		variables: strings.get("variables"),
-		skipGitCheck: booleans.has("skip-git-check"),
-		allowDirtyGitState: booleans.has("allow-dirty-git-state"),
-		url: strings.get("url"),
-		adminKey: strings.get("admin-key"),
-		prod: booleans.has("prod"),
-		previewName: strings.get("preview-name"),
-		deploymentName: strings.get("deployment-name")
+		command: commandName ?? "setup",
+		appUrl: stringValue("app-url"),
+		variables: stringValue("variables"),
+		skipGitCheck: parsed.values["skip-git-check"] === true,
+		allowDirtyGitState: parsed.values["allow-dirty-git-state"] === true,
+		url: stringValue("url"),
+		siteUrl: stringValue("site-url"),
+		adminKey: stringValue("admin-key"),
+		prod: parsed.values.prod === true,
+		deployment: stringValue("deployment")
 	};
 }
 function validateDeploymentSelectionOptions(options) {
 	if ([
 		options.url !== void 0,
 		options.prod,
-		options.previewName !== void 0,
-		options.deploymentName !== void 0
-	].filter(Boolean).length > 1) logErrorAndExit("Choose only one of --url, --prod, --preview-name, or --deployment-name.");
+		options.deployment !== void 0
+	].filter(Boolean).length > 1) logErrorAndExit("Choose only one of --url, --prod, or --deployment.");
 }
 function handleCancel(value) {
 	if (q(value)) {
@@ -6550,18 +6525,70 @@ async function runDoctor(options) {
 	const configPath = existingNonEmptySourcePath(path.join(convexFolderPath, "convex.config"));
 	const authPath = existingNonEmptySourcePath(path.join(convexFolderPath, "auth"));
 	const authConfigPath = existingNonEmptySourcePath(path.join(convexFolderPath, "auth.config"));
-	if (configPath === null) O.warn("Missing convex.config.ts/js.");
-	else O.success(`Found ${configPath}`);
-	if (authPath === null) O.warn("Missing auth.ts/js.");
-	else O.success(`Found ${authPath}`);
-	if (authConfigPath === null) O.warn("Missing auth.config.ts/js.");
-	else O.success(`Found ${authConfigPath}`);
-	gt("Doctor checks complete.");
+	let healthy = true;
+	if (configPath === null) {
+		healthy = false;
+		O.warn("Missing convex.config.ts/js.");
+	} else O.success(`Found ${configPath}`);
+	if (authPath === null) {
+		healthy = false;
+		O.warn("Missing auth.ts/js.");
+	} else O.success(`Found ${authPath}`);
+	if (authConfigPath === null) {
+		healthy = false;
+		O.warn("Missing auth.config.ts/js.");
+	} else O.success(`Found ${authConfigPath}`);
+	const deployment = readConvexDeployment(options);
+	const config = {
+		isExpo: false,
+		isNextjs: false,
+		isVite: false,
+		usesTypeScript: true,
+		convexFolderPath,
+		deployment,
+		step: 1
+	};
+	for (const name of ["AUTH_KEYS", "APP_URL"]) if (hasBackendEnvVar(config, name)) O.success(`${name} is configured.`);
+	else {
+		healthy = false;
+		O.warn(`${name} is missing or unreadable.`);
+	}
+	const siteUrl = resolveConvexSiteUrl(deployment);
+	if (siteUrl === null) {
+		healthy = false;
+		O.warn("Could not derive the HTTP actions URL. Pass --site-url.");
+	} else {
+		const authSiteUrl = `${siteUrl}/auth`;
+		healthy = await checkAuthEndpoint(`${authSiteUrl}/.well-known/openid-configuration`, "OpenID configuration") && healthy;
+		healthy = await checkAuthEndpoint(`${authSiteUrl}/.well-known/jwks.json`, "JWKS") && healthy;
+	}
+	if (!healthy) process$1.exitCode = 1;
+	gt(healthy ? "Convex Auth is healthy." : "Convex Auth needs attention.");
+}
+async function checkAuthEndpoint(url, label) {
+	try {
+		const response = await fetch(url, {
+			headers: { Accept: "application/json" },
+			redirect: "error"
+		});
+		if (!response.ok) {
+			O.warn(`${label} returned HTTP ${response.status}: ${url}`);
+			return false;
+		}
+		await response.json();
+		O.success(`${label} is reachable.`);
+		return true;
+	} catch (error) {
+		O.warn(`${label} is unreachable: ${error instanceof Error ? error.message : String(error)}`);
+		return false;
+	}
 }
 async function runUrls(options) {
 	validateDeploymentSelectionOptions(options);
 	printBanner();
-	const authSiteUrl = `${(readConvexDeployment(options).options.url ?? "https://<deployment>.convex.site").replace(/\/$/, "")}/auth`;
+	const convexSiteUrl = resolveConvexSiteUrl(readConvexDeployment(options));
+	if (convexSiteUrl === null) logErrorAndExit("Could not derive the HTTP actions URL. Pass --site-url.");
+	const authSiteUrl = `${convexSiteUrl.replace(/\/$/, "")}/auth`;
 	O.info("Convex Auth URLs:");
 	O.message([
 		`Issuer: ${authSiteUrl}`,
@@ -6598,7 +6625,7 @@ async function runKeys(options) {
 * @returns A promise that resolves when setup completes successfully.
 */
 const runCli = async (argv = process$1.argv) => {
-	const options = parseArgs(argv);
+	const options = parseCliOptions(argv);
 	if (options.command === "setup") await runSetup(options);
 	else if (options.command === "doctor") await runDoctor(options);
 	else if (options.command === "urls") await runUrls(options);
@@ -6683,14 +6710,25 @@ async function configureKeys(config) {
 	s2.stop("Keys configured.");
 }
 function backendEnvVar(config, name) {
-	const { file, args } = convexCmd("env", "get", ...deploymentArgs(config), name);
-	return execFileSync(file, args, {
+	const { file, args } = convexCommand("env", "get", ...deploymentArgs(config), name);
+	return stripTrailingLineBreak(execFileSync(file, args, {
 		stdio: "pipe",
 		encoding: "utf-8"
-	}).slice(0, -1);
+	}));
+}
+/** @internal */
+function stripTrailingLineBreak(output) {
+	return output.replace(/\r?\n$/, "");
+}
+function hasBackendEnvVar(config, name) {
+	try {
+		return backendEnvVar(config, name).trim() !== "";
+	} catch {
+		return false;
+	}
 }
 async function setEnvVar(config, name, value, options) {
-	const { file, args } = convexCmd("env", "set", ...deploymentArgs(config), "--", name, value);
+	const { file, args } = convexCommand("env", "set", ...deploymentArgs(config), "--", name, value);
 	execFileSync(file, args, { stdio: options?.hideValue ? "ignore" : "inherit" });
 	if (options?.hideValue) O.success(`Set ${name} on ${printDeployment(config)}`);
 }
@@ -6698,25 +6736,28 @@ async function setEnvVarFromFile(config, name, value) {
 	const tmpDir = mkdtempSync(path.join(tmpdir(), "convex-auth-"));
 	const tmpFile = path.join(tmpDir, `${name}.tmp`);
 	try {
-		writeFileSync(tmpFile, value, "utf-8");
-		const { file, args } = convexCmd("env", "set", ...deploymentArgs(config), name, "--from-file", tmpFile);
+		writeFileSync(tmpFile, value, {
+			encoding: "utf8",
+			mode: 384
+		});
+		const { file, args } = convexCommand("env", "set", ...deploymentArgs(config), name, "--from-file", tmpFile);
 		execFileSync(file, args, { stdio: "ignore" });
 		O.success(`Set ${name} on ${printDeployment(config)}`);
 	} finally {
-		try {
-			unlinkSync(tmpFile);
-		} catch {}
+		rmSync(tmpDir, {
+			recursive: true,
+			force: true
+		});
 	}
 }
 function deploymentArgs(config) {
-	const { deployment: { options: { adminKey, url, prod, previewName, deploymentName } } } = config;
+	const { deployment: { options: { adminKey, url, prod, deployment } } } = config;
 	const args = [];
 	if (adminKey !== void 0) args.push("--admin-key", adminKey);
 	const selectionArgs = [
 		url ? ["--url", url] : null,
 		prod ? ["--prod"] : null,
-		previewName ? ["--preview-name", previewName] : null,
-		deploymentName ? ["--deployment-name", deploymentName] : null
+		deployment ? ["--deployment", deployment] : null
 	].find((s) => s !== null) ?? [];
 	args.push(...selectionArgs);
 	return args;
@@ -6754,7 +6795,7 @@ const validTsConfig = `\
 }
 `;
 async function modifyTsConfig(config) {
-	logStep(config, "Modify tsconfig file");
+	logStep(config, "Update tsconfig file");
 	const projectLevelTsConfigPath = "tsconfig.json";
 	const tsConfigPath = path.join(config.convexFolderPath, "tsconfig.json");
 	if (!existsSync(tsConfigPath)) {
@@ -6778,7 +6819,7 @@ async function modifyTsConfig(config) {
 		return;
 	}
 	if (!compilerOptionsPattern.test(existingTsConfig)) {
-		O.info(`Modify your ${tsConfigPath} to include the following:`);
+		O.info(`Update your ${tsConfigPath} to include the following:`);
 		O.message(indent(`\n"moduleResolution": "Bundler",\n"skipLibCheck": true\n`));
 		const ready = await ot({ message: "Ready to continue?" });
 		handleCancel(ready);
@@ -7061,7 +7102,7 @@ function loadEnvFiles() {
 }
 /** @internal */
 function readConvexDeployment(options) {
-	const { adminKey, url, prod, previewName, deploymentName } = options;
+	const { adminKey, url, prod, deployment } = options;
 	if (url) return {
 		name: url,
 		type: null,
@@ -7074,13 +7115,9 @@ function readConvexDeployment(options) {
 			name: adminKeyName,
 			type: "prod"
 		} : null,
-		previewName ? {
-			name: previewName,
-			type: "preview"
-		} : null,
-		deploymentName ? {
-			name: deploymentName,
-			type: adminKeyType
+		deployment ? {
+			name: deployment,
+			type: adminKeyType ?? (deployment === "prod" ? "prod" : deployment === "dev" || deployment === "local" ? "dev" : null)
 		} : null,
 		adminKey ? {
 			name: adminKeyName,
@@ -7103,6 +7140,25 @@ function readConvexDeployment(options) {
 	logErrorAndExit("Could not find a configured CONVEX_DEPLOYMENT. Did you forget to run `npx convex dev` first?");
 }
 /** @internal */
+function resolveConvexSiteUrl(deployment) {
+	const explicitSiteUrl = deployment.options.siteUrl;
+	if (explicitSiteUrl !== void 0) return normalizedHttpUrl(explicitSiteUrl);
+	const cloudUrl = deployment.options.url;
+	if (cloudUrl !== void 0) {
+		const parsed = new URL(cloudUrl);
+		if (parsed.hostname.endsWith(".convex.cloud")) parsed.hostname = `${parsed.hostname.slice(0, -13)}.convex.site`;
+		else if ((parsed.hostname === "127.0.0.1" || parsed.hostname === "localhost") && parsed.port === "3210") parsed.port = "3211";
+		return parsed.toString().replace(/\/$/, "");
+	}
+	if (deployment.name !== null && /^[a-z0-9]+(?:-[a-z0-9]+)+$/.test(deployment.name)) return `https://${deployment.name}.convex.site`;
+	return null;
+}
+function normalizedHttpUrl(value) {
+	const parsed = new URL(value);
+	if (parsed.protocol !== "http:" && parsed.protocol !== "https:") logErrorAndExit("Invalid --site-url.", "Expected an HTTP or HTTPS URL.");
+	return parsed.toString().replace(/\/$/, "");
+}
+/** @internal */
 function stripDeploymentTypePrefix(deployment) {
 	const [type, name] = deployment.split(":");
 	if (type !== "prod" && type !== "dev" && type !== "preview" || !name) logErrorAndExit("Invalid CONVEX_DEPLOYMENT.", "Expected a typed deployment like \"dev:my-deployment\", \"prod:my-deployment\", or \"preview:my-deployment\".");

package/dist/component/_generated/component.d.ts

@@ -56,7 +56,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
         name?: string;
         phone?: string;
         phoneVerificationTime?: number;
-        sessionEpoch?: number;
+        sessionEpoch: number;
       };
     }, Name>;
     completeCredentialsSignIn: FunctionReference<"mutation", "internal", {
@@ -94,7 +94,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
         name?: string;
         phone?: string;
         phoneVerificationTime?: number;
-        sessionEpoch?: number;
+        sessionEpoch: number;
       };
     }, Name>;
     create: FunctionReference<"mutation", "internal", {
@@ -888,7 +888,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
       session: {
         _creationTime: number;
         _id: string;
-        epoch?: number;
+        epoch: number;
         expirationTime: number;
         userId: string;
       } | null;
@@ -906,7 +906,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
         name?: string;
         phone?: string;
         phoneVerificationTime?: number;
-        sessionEpoch?: number;
+        sessionEpoch: number;
       } | null;
     }, Name>;
   };
@@ -1527,7 +1527,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
           name?: string;
           phone?: string;
           phoneVerificationTime?: number;
-          sessionEpoch?: number;
+          sessionEpoch: number;
         };
       }, Name>;
       completeEnrollment: FunctionReference<"mutation", "internal", {
@@ -1581,7 +1581,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
           name?: string;
           phone?: string;
           phoneVerificationTime?: number;
-          sessionEpoch?: number;
+          sessionEpoch: number;
         };
       }, Name>;
       completeRegistration: FunctionReference<"mutation", "internal", {
@@ -1629,7 +1629,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
           name?: string;
           phone?: string;
           phoneVerificationTime?: number;
-          sessionEpoch?: number;
+          sessionEpoch: number;
         };
       }, Name>;
       completeRotation: FunctionReference<"mutation", "internal", {
@@ -1680,7 +1680,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
           name?: string;
           phone?: string;
           phoneVerificationTime?: number;
-          sessionEpoch?: number;
+          sessionEpoch: number;
         };
       }, Name>;
       create: FunctionReference<"mutation", "internal", {
@@ -1837,7 +1837,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
           name?: string;
           phone?: string;
           phoneVerificationTime?: number;
-          sessionEpoch?: number;
+          sessionEpoch: number;
         };
       }, Name>;
       create: FunctionReference<"mutation", "internal", {
@@ -1872,7 +1872,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
           name?: string;
           phone?: string;
           phoneVerificationTime?: number;
-          sessionEpoch?: number;
+          sessionEpoch: number;
         };
         verifierId: string;
       }, Name>;
@@ -2689,7 +2689,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
         name?: string;
         phone?: string;
         phoneVerificationTime?: number;
-        sessionEpoch?: number;
+        sessionEpoch: number;
       };
       userId: string;
     }, Name>;
@@ -2698,7 +2698,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
     }, {
       _creationTime: number;
       _id: string;
-      epoch?: number;
+      epoch: number;
       expirationTime: number;
       userId: string;
     } | null, Name>;
@@ -2707,7 +2707,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
     }, Array<{
       _creationTime: number;
       _id: string;
-      epoch?: number;
+      epoch: number;
       expirationTime: number;
       userId: string;
     }>, Name>;
@@ -2802,7 +2802,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
       } | null, Name>;
     };
     pkce: {
-      consume: FunctionReference<"mutation", "internal", {
+      accept: FunctionReference<"mutation", "internal", {
         expectedSignature?: string;
         selector: {
           id: string;
@@ -2883,7 +2883,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
           name?: string;
           phone?: string;
           phoneVerificationTime?: number;
-          sessionEpoch?: number;
+          sessionEpoch: number;
         };
         userId: string;
       } | {
@@ -2993,7 +2993,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
           name?: string;
           phone?: string;
           phoneVerificationTime?: number;
-          sessionEpoch?: number;
+          sessionEpoch: number;
         };
       } | {
         refreshTokenId?: string;
@@ -3015,7 +3015,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
           name?: string;
           phone?: string;
           phoneVerificationTime?: number;
-          sessionEpoch?: number;
+          sessionEpoch: number;
         };
       }, Name>;
       create: FunctionReference<"mutation", "internal", {
@@ -3119,7 +3119,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
       name?: string;
       phone?: string;
       phoneVerificationTime?: number;
-      sessionEpoch?: number;
+      sessionEpoch: number;
     } | null | Array<{
       _creationTime: number;
       _id: string;
@@ -3134,7 +3134,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
       name?: string;
       phone?: string;
       phoneVerificationTime?: number;
-      sessionEpoch?: number;
+      sessionEpoch: number;
     } | null>, Name>;
     key: {
       create: FunctionReference<"mutation", "internal", {
@@ -3320,7 +3320,7 @@ type ComponentApi<Name extends string | undefined = string | undefined> = {
         name?: string;
         phone?: string;
         phoneVerificationTime?: number;
-        sessionEpoch?: number;
+        sessionEpoch: number;
       }>;
       pageStatus?: "SplitRecommended" | "SplitRequired" | null;
       splitCursor?: string | null;