kitcn 0.12.27 → 0.13.0

package/dist/auth/start/index.js

@@ -1,8 +1,31 @@
-import { convexBetterAuthReactStart as convexBetterAuthReactStart$1 } from "@convex-dev/better-auth/react-start";
-
-export * from "@convex-dev/better-auth/react-start"
+import { t as getToken } from "../../token-tpipF-7y.js";
+import { stripIndent } from "common-tags";
+import { ConvexHttpClient } from "convex/browser";
+import React from "react";
 
 //#region src/auth-start/index.ts
+const fallbackCache = (fn) => fn;
+const cache = React.cache ?? fallbackCache;
+const TANSTACK_REACT_START_SERVER = "@tanstack/react-start/server";
+const TRAILING_COLON_RE = /:$/;
+function setupClient(options) {
+	const client = new ConvexHttpClient(options.convexUrl);
+	if (options.token !== void 0) client.setAuth(options.token);
+	client.setFetchOptions?.({ cache: "no-store" });
+	return client;
+}
+const parseConvexSiteUrl = (url) => {
+	if (!url) throw new Error(stripIndent`
+      CONVEX_SITE_URL is not set.
+      This is automatically set in the Convex backend, but must be set in the TanStack Start environment.
+      For local development, this can be set in the .env.local file.
+    `);
+	if (url.endsWith(".convex.cloud")) throw new Error(stripIndent`
+      CONVEX_SITE_URL should be set to your Convex Site URL, which ends in .convex.site.
+      Currently set to ${url}.
+    `);
+	return url;
+};
 const appendSetCookieHeaders = (target, source) => {
 	const getSetCookie = source.getSetCookie;
 	if (typeof getSetCookie === "function") {
@@ -26,13 +49,79 @@ const cloneAuthHandlerResponse = (response) => {
 		statusText: response.statusText
 	});
 };
-const convexBetterAuthReactStart = ((...args) => {
-	const auth = convexBetterAuthReactStart$1(...args);
+const handler = (request, opts) => {
+	const requestUrl = new URL(request.url);
+	const nextUrl = `${opts.convexSiteUrl}${requestUrl.pathname}${requestUrl.search}`;
+	const headers = new Headers(request.headers);
+	const proto = requestUrl.protocol.replace(TRAILING_COLON_RE, "");
+	headers.set("accept-encoding", "application/json");
+	headers.set("host", new URL(opts.convexSiteUrl).host);
+	headers.set("x-forwarded-host", requestUrl.host);
+	headers.set("x-forwarded-proto", proto);
+	headers.set("x-better-auth-forwarded-host", requestUrl.host);
+	headers.set("x-better-auth-forwarded-proto", proto);
+	return fetch(nextUrl, {
+		body: request.method !== "GET" && request.method !== "HEAD" ? request.body : void 0,
+		duplex: "half",
+		headers,
+		method: request.method,
+		redirect: "manual"
+	});
+};
+const convexBetterAuthReactStart = (opts) => {
+	const siteUrl = parseConvexSiteUrl(opts.convexSiteUrl);
+	const cachedGetToken = cache(async (opts) => {
+		const { getRequestHeaders } = await import(TANSTACK_REACT_START_SERVER);
+		const headers = getRequestHeaders();
+		const mutableHeaders = new Headers(headers);
+		mutableHeaders.delete("content-length");
+		mutableHeaders.delete("transfer-encoding");
+		mutableHeaders.set("accept-encoding", "identity");
+		return getToken(siteUrl, mutableHeaders, opts);
+	});
+	const callWithToken = async (fn) => {
+		const token = await cachedGetToken(opts) ?? {};
+		try {
+			return await fn(token?.token);
+		} catch (error) {
+			if (!opts?.jwtCache?.enabled || token.isFresh || !opts.jwtCache?.isAuthError(error)) throw error;
+			return await fn((await cachedGetToken({
+				...opts,
+				forceRefresh: true
+			})).token);
+		}
+	};
 	return {
-		...auth,
-		handler: async (request) => cloneAuthHandlerResponse(await auth.handler(request))
+		getToken: async () => {
+			return (await cachedGetToken(opts)).token;
+		},
+		handler: async (request) => cloneAuthHandlerResponse(await handler(request, opts)),
+		fetchAuthQuery: async (query, ...args) => {
+			return callWithToken((token) => {
+				return setupClient({
+					...opts,
+					token
+				}).query(query, ...args);
+			});
+		},
+		fetchAuthMutation: async (mutation, ...args) => {
+			return callWithToken((token) => {
+				return setupClient({
+					...opts,
+					token
+				}).mutation(mutation, ...args);
+			});
+		},
+		fetchAuthAction: async (action, ...args) => {
+			return callWithToken((token) => {
+				return setupClient({
+					...opts,
+					token
+				}).action(action, ...args);
+			});
+		}
 	};
-});
+};
 
 //#endregion
 export { convexBetterAuthReactStart };

package/dist/{backend-core-DqCCa0nr.mjs → backend-core-CXmrWqdi.mjs}

@@ -6159,14 +6159,18 @@ function resolveProjectScaffoldContext(params = {}) {
 //#endregion
 //#region src/cli/supported-dependencies.ts
 const EXACT_VERSION_RE = /^(\d+)\.(\d+)\.\d+$/;
-const SUPPORTED_CONVEX_VERSION = "1.33.0";
-const SUPPORTED_BETTER_AUTH_VERSION = "1.5.3";
+const VERSION_IN_SPEC_RE = /(\d+)\.(\d+)(?:\.\d+)?/;
+const PLAIN_VERSION_SPEC_RE = /^[\^~]?v?\d+\.\d+(?:\.\d+)?$/;
+const UPPER_BOUND_RE = /(?:^|\s)<={0,1}\s*v?(\d+)\.(\d+)(?:\.\d+)?/g;
+const SUPPORTED_CONVEX_VERSION = "1.35.1";
+const SUPPORTED_BETTER_AUTH_VERSION = "1.6.5";
 const SUPPORTED_HONO_VERSION = "4.12.9";
 const SUPPORTED_OPENTELEMETRY_API_VERSION = "1.9.0";
 const SUPPORTED_TANSTACK_REACT_QUERY_VERSION = "5.95.2";
 const SUPPORTED_ZOD_VERSION = "4.3.6";
 const KITCN_INSTALL_SPEC_ENV = "KITCN_INSTALL_SPEC";
 const KITCN_RESEND_INSTALL_SPEC_ENV = "KITCN_RESEND_INSTALL_SPEC";
+let ownVersion;
 function getMinimumVersionRange(version) {
 	const match = EXACT_VERSION_RE.exec(version);
 	if (!match) throw new Error(`Unsupported exact version "${version}". Expected x.y.z format.`);
@@ -6189,10 +6193,37 @@ const LOCAL_INSTALL_SPEC_ENV_BY_PACKAGE_NAME = {
 	"@kitcn/resend": KITCN_RESEND_INSTALL_SPEC_ENV
 };
 function resolveSupportedDependencyInstallSpec(spec, env = process.env) {
+	if (getPackageNameFromInstallSpec(spec) === "kitcn") return resolveScaffoldInstallSpec(env);
 	const envKey = LOCAL_INSTALL_SPEC_ENV_BY_PACKAGE_NAME[getPackageNameFromInstallSpec(spec)];
 	const override = envKey ? env[envKey]?.trim() : void 0;
 	return override && override.length > 0 ? override : spec;
 }
+function readOwnVersion() {
+	if (ownVersion !== void 0) return ownVersion ?? void 0;
+	let currentDir = dirname(fileURLToPath(import.meta.url));
+	while (true) {
+		const packageJsonPath = join(currentDir, "package.json");
+		if (fs.existsSync(packageJsonPath)) {
+			const parsed = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+			if (parsed.name === "kitcn") {
+				ownVersion = parsed.version ?? null;
+				return ownVersion ?? void 0;
+			}
+		}
+		const parentDir = dirname(currentDir);
+		if (parentDir === currentDir) {
+			ownVersion = null;
+			return;
+		}
+		currentDir = parentDir;
+	}
+}
+function resolveScaffoldInstallSpec(env = process.env) {
+	const override = env[KITCN_INSTALL_SPEC_ENV]?.trim();
+	if (override) return override;
+	const version = readOwnVersion();
+	return version ? `kitcn@${version}` : "kitcn";
+}
 const SUPPORTED_DEPENDENCY_VERSIONS = {
 	convex: {
 		exact: SUPPORTED_CONVEX_VERSION,
@@ -6221,6 +6252,73 @@ const BASELINE_DEPENDENCY_INSTALL_SPECS = [
 	PINNED_HONO_INSTALL_SPEC
 ];
 const INIT_TEMPLATE_DEPENDENCY_INSTALL_SPECS = ["superjson"];
+const DEPENDENCY_SECTIONS = [
+	"dependencies",
+	"devDependencies",
+	"peerDependencies",
+	"optionalDependencies"
+];
+function findNearestPackageJsonPath$2(cwd) {
+	let currentDir = cwd;
+	while (true) {
+		const packageJsonPath = join(currentDir, "package.json");
+		if (fs.existsSync(packageJsonPath)) return packageJsonPath;
+		const parentDir = dirname(currentDir);
+		if (parentDir === currentDir) return;
+		currentDir = parentDir;
+	}
+}
+function readDependencyVersion(packageJson, packageName) {
+	for (const section of DEPENDENCY_SECTIONS) {
+		const version = packageJson[section]?.[packageName];
+		if (version) return version;
+	}
+}
+function readInstalledDependencyVersion(packageJsonPath, packageName) {
+	const installedPackageJsonPath = join(dirname(packageJsonPath), "node_modules", ...packageName.split("/"), "package.json");
+	if (!fs.existsSync(installedPackageJsonPath)) return;
+	return JSON.parse(fs.readFileSync(installedPackageJsonPath, "utf8")).version;
+}
+function compareMajorMinor(aMajor, aMinor, bMajor, bMinor) {
+	if (aMajor !== bMajor) return aMajor - bMajor;
+	return aMinor - bMinor;
+}
+function isConcreteVersionSpecBelowMinimum(spec, minimum) {
+	const specMatch = VERSION_IN_SPEC_RE.exec(spec);
+	const minimumMatch = VERSION_IN_SPEC_RE.exec(minimum);
+	if (!specMatch || !minimumMatch) return false;
+	return compareMajorMinor(Number(specMatch[1]), Number(specMatch[2]), Number(minimumMatch[1]), Number(minimumMatch[2])) < 0;
+}
+function isDeclaredVersionSpecBelowMinimum(spec, minimum) {
+	const normalized = spec.trim();
+	if (PLAIN_VERSION_SPEC_RE.test(normalized)) return isConcreteVersionSpecBelowMinimum(normalized, minimum);
+	const minimumMatch = VERSION_IN_SPEC_RE.exec(minimum);
+	if (!minimumMatch) return false;
+	const minimumMajor = Number(minimumMatch[1]);
+	const minimumMinor = Number(minimumMatch[2]);
+	for (const match of normalized.matchAll(UPPER_BOUND_RE)) if (compareMajorMinor(Number(match[1]), Number(match[2]), minimumMajor, minimumMinor) <= 0) return true;
+	return false;
+}
+function resolveSupportedDependencyWarnings(cwd = process.cwd()) {
+	const packageJsonPath = findNearestPackageJsonPath$2(cwd);
+	if (!packageJsonPath) return [];
+	const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+	const installedConvexVersion = readInstalledDependencyVersion(packageJsonPath, "convex");
+	if (installedConvexVersion && isConcreteVersionSpecBelowMinimum(installedConvexVersion, SUPPORTED_DEPENDENCY_VERSIONS.convex.minimum)) return [{
+		packageName: "convex",
+		current: installedConvexVersion,
+		minimum: SUPPORTED_DEPENDENCY_VERSIONS.convex.minimum,
+		installSpec: PINNED_CONVEX_INSTALL_SPEC
+	}];
+	const convexVersion = readDependencyVersion(packageJson, "convex");
+	if (!convexVersion || !isDeclaredVersionSpecBelowMinimum(convexVersion, SUPPORTED_DEPENDENCY_VERSIONS.convex.minimum)) return [];
+	return [{
+		packageName: "convex",
+		current: convexVersion,
+		minimum: SUPPORTED_DEPENDENCY_VERSIONS.convex.minimum,
+		installSpec: PINNED_CONVEX_INSTALL_SPEC
+	}];
+}
 
 //#endregion
 //#region src/cli/registry/dependencies.ts
@@ -6257,7 +6355,7 @@ const resolvePackageJsonInstallTarget = () => {
 const resolveBunPeerWarningPreinstallSpecs = () => {
 	const { packageJsonPath, packageJson } = resolvePackageJsonInstallTarget();
 	if (!packageJsonPath || !packageJson) return [];
-	if (!(hasDependency(packageJson, "kitcn") || hasDependency(packageJson, "better-auth") || hasDependency(packageJson, "@convex-dev/better-auth"))) return [];
+	if (!(hasDependency(packageJson, "kitcn") || hasDependency(packageJson, "better-auth"))) return [];
 	if (hasDependency(packageJson, getPackageNameFromInstallSpec(OPENTELEMETRY_API_INSTALL_SPEC))) return [];
 	const bunLockPath = join(dirname(packageJsonPath), BUN_LOCK_PATH);
 	if (!fs.existsSync(bunLockPath)) return [];
@@ -6308,25 +6406,25 @@ const resolveMissingDependencyHints = (dependencyHints) => {
 };
 const applyDependencyHintsInstall = async (dependencyHints, execaFn) => {
 	const preinstalledSpecs = await applyBunPeerWarningPreinstall(execaFn);
-	const missingDependencyHints = resolveMissingDependencyHints(dependencyHints).filter((dependencyHint) => !preinstalledSpecs.includes(dependencyHint));
-	if (missingDependencyHints.length === 0) return preinstalledSpecs;
+	const installSpecs = resolveMissingDependencyHints(dependencyHints).filter((dependencyHint) => !preinstalledSpecs.includes(dependencyHint)).map((dependencyHint) => resolveSupportedDependencyInstallSpec(dependencyHint));
+	if (installSpecs.length === 0) return preinstalledSpecs;
 	const { packageJsonPath } = resolvePackageJsonInstallTarget();
-	await execaFn("bun", ["add", ...missingDependencyHints], {
+	await execaFn("bun", ["add", ...installSpecs], {
 		cwd: dirname(packageJsonPath),
 		stdio: "inherit"
 	});
-	return [...preinstalledSpecs, ...missingDependencyHints];
+	return [...preinstalledSpecs, ...installSpecs];
 };
 const applyPlanningDependencyInstall = async (dependencySpecs, execaFn) => {
 	const preinstalledSpecs = await applyBunPeerWarningPreinstall(execaFn);
-	const missingDependencySpecs = resolveMissingDependencyHints(dependencySpecs).filter((dependencySpec) => !preinstalledSpecs.includes(dependencySpec));
-	if (missingDependencySpecs.length === 0) return preinstalledSpecs;
+	const installSpecs = resolveMissingDependencyHints(dependencySpecs).filter((dependencySpec) => !preinstalledSpecs.includes(dependencySpec)).map((dependencySpec) => resolveSupportedDependencyInstallSpec(dependencySpec));
+	if (installSpecs.length === 0) return preinstalledSpecs;
 	const { packageJsonPath } = resolvePackageJsonInstallTarget();
-	await execaFn("bun", ["add", ...missingDependencySpecs], {
+	await execaFn("bun", ["add", ...installSpecs], {
 		cwd: dirname(packageJsonPath),
 		stdio: "inherit"
 	});
-	return [...preinstalledSpecs, ...missingDependencySpecs];
+	return [...preinstalledSpecs, ...installSpecs];
 };
 const applyPluginDependencyInstall = async (install, execaFn) => {
 	if (install.skipped || !install.packageName || !install.packageJsonPath) return install;
@@ -8633,7 +8731,8 @@ import {
   useSignUpMutationOptions,
 } from '@/lib/convex/auth-client';
 
-export const Route = createFileRoute('/auth' as never)({
+// @ts-ignore routeTree.gen.ts is refreshed by TanStack Router during dev/build.
+export const Route = createFileRoute('/auth')({
   component: AuthPage,
 });
 
@@ -8790,7 +8889,8 @@ const AUTH_START_ROUTE_TEMPLATE = `import { createFileRoute } from '@tanstack/re
 
 import { handler } from '@/lib/convex/auth-server';
 
-export const Route = createFileRoute('/api/auth/$' as never)({
+// @ts-ignore routeTree.gen.ts is refreshed by TanStack Router during dev/build.
+export const Route = createFileRoute('/api/auth/$')({
   server: {
     handlers: {
       GET: ({ request }) => handler(request),
@@ -9297,7 +9397,7 @@ const DEFAULT_AUTH_SCHEMA_ENV = {
 	SITE_URL: "http://localhost:3000"
 };
 const loadGetAuthTables = async () => (await import("better-auth/db")).getAuthTables;
-const loadConvexAuthPlugin = async () => (await import("@convex-dev/better-auth/plugins")).convex;
+const loadConvexAuthPlugin = async () => (await import("./convex-plugin-tWTDqoKJ.mjs")).convex;
 const ts$1 = createTypeScriptProxy();
 const withAuthSchemaEnv = async (run) => {
 	const globalScope = globalThis;
@@ -9537,8 +9637,8 @@ const AUTH_CONVEX_FILES = [
 		target: "functions",
 		content: AUTH_CONVEX_TEMPLATE,
 		requires: ["auth-config-convex"],
-		dependencyHintMessage: "Auth runtime depends on OpenTelemetry API.",
-		dependencyHints: [OPENTELEMETRY_API_INSTALL_SPEC]
+		dependencyHintMessage: "Auth runtime depends on OpenTelemetry API and kitcn runtime helpers.",
+		dependencyHints: [OPENTELEMETRY_API_INSTALL_SPEC, "kitcn"]
 	}),
 	createRegistryFile({
 		id: "auth-client-convex",
@@ -12453,7 +12553,6 @@ const createSpinner = (text, options = {}) => {
 //#region src/cli/backend-core.ts
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-let ownVersion;
 const ts = createTypeScriptProxy();
 const require = createRequire(import.meta.url);
 const realConvex = join(dirname(require.resolve("convex/package.json")), "bin/main.js");
@@ -12671,30 +12770,6 @@ function createCommandEnv(overrides) {
 		...overrides
 	};
 }
-function resolveOwnPackageJsonPath(filePath) {
-	let current = dirname(filePath);
-	while (true) {
-		const candidate = join(current, "package.json");
-		if (fs.existsSync(candidate)) {
-			if (JSON.parse(fs.readFileSync(candidate, "utf8")).name === "kitcn") return candidate;
-		}
-		const parent = dirname(current);
-		if (parent === current) throw new Error(`Could not find kitcn package.json from ${filePath}.`);
-		current = parent;
-	}
-}
-function readOwnVersion() {
-	if (ownVersion !== void 0) return ownVersion ?? void 0;
-	const packageJsonPath = resolveOwnPackageJsonPath(__filename);
-	ownVersion = JSON.parse(fs.readFileSync(packageJsonPath, "utf8")).version ?? null;
-	return ownVersion ?? void 0;
-}
-function resolveScaffoldInstallSpec(env = process.env) {
-	const override = env[KITCN_INSTALL_SPEC_ENV]?.trim();
-	if (override) return override;
-	const version = readOwnVersion();
-	return version ? `kitcn@${version}` : "kitcn";
-}
 const CONVEX_DEPLOYMENT_ENV_KEYS = [
 	"CONVEX_DEPLOYMENT",
 	"CONVEX_DEPLOY_KEY",
@@ -12715,6 +12790,9 @@ function createBackendCommandEnv(overrides) {
 		...overrides
 	};
 }
+function getConvexDeploymentCommandEnv(env = process.env) {
+	return Object.fromEntries(CONVEX_DEPLOYMENT_ENV_KEYS.map((key) => [key, env[key]]));
+}
 function hasRemoteConvexDeploymentEnv(env) {
 	const deployment = env.CONVEX_DEPLOYMENT?.trim();
 	if (deployment && !isLocalConvexDeploymentValue(deployment)) return true;
@@ -14395,13 +14473,9 @@ async function runConvexInitIfNeeded(params) {
 		stderr: ""
 	};
 	const shouldUseLocalDevPreflight = getAggregateBackfillDeploymentKey(params.targetArgs ?? [], process.cwd(), params.env) === "local";
-	const agentModeOverride = params.yes && shouldUseLocalDevPreflight ? "anonymous" : params.env?.CONVEX_AGENT_MODE;
 	const runCommand = async (commandArgs) => normalizeConvexCommandResult(await params.execaFn(params.backendAdapter.command, commandArgs, {
 		cwd: process.cwd(),
-		env: createBackendCommandEnv({
-			...params.env,
-			...agentModeOverride ? { CONVEX_AGENT_MODE: agentModeOverride } : {}
-		}),
+		env: createBackendCommandEnv(params.env),
 		reject: false,
 		stdio: "pipe"
 	}));
@@ -14525,7 +14599,6 @@ async function runInitializationCodegen(params) {
 		const initResult = await runConvexInitIfNeeded({
 			execaFn: params.execaFn,
 			backendAdapter: runtimeAdapter,
-			yes: params.yes,
 			targetArgs: params.targetArgs
 		});
 		if (initResult.exitCode !== 0) throw new Error(`Failed to configure Convex project via \`convex init\`.\n${`${initResult.stdout}\n${initResult.stderr}`.trim()}`);
@@ -14671,6 +14744,7 @@ const VALID_BACKFILL_ENABLED = new Set([
 ]);
 const CONVEX_DEV_PRE_RUN_CONFLICT_FLAGS = [
 	"--run",
+	"--start",
 	"--run-sh",
 	"--run-component"
 ];
@@ -15337,4 +15411,4 @@ function isEntryPoint(entry, filename) {
 }
 
 //#endregion
-export { resolveAddTemplateDefaults as $, resolveConfiguredBackend as A, runConvexInitIfNeeded as B, isInitialized as C, generateMeta as Ct, readPackageVersions as D, parseInitCommandArgs as E, highlighter as Et, runAfterScaffoldScript as F, trackProcess as G, runInitCommandFlow as H, runAggregateBackfillFlow as I, createSpinner as J, withLocalCodegenEnv as K, runAggregatePruneFlow as L, resolveInitProjectDir as M, resolveMigrationConfig as N, resolveBackfillConfig as O, resolveRunDeps as P, promptForScaffoldTemplateSelection as Q, runBackendFunction as R, isEntryPoint as S, stripConvexCommandNoise as St, parseBackendRunJson as T, logger as Tt, runMigrationCreate as U, runDevSchemaBackfillIfNeeded as V, runMigrationFlow as W, filterScaffoldTemplatePathMap as X, collectPluginScaffoldTemplates as Y, promptForPluginSelection as Z, formatInfoOutput as _, applyPluginDependencyInstall as _t, cleanup as a, getSupportedPluginKeys as at, hasRemoteConvexDeploymentEnv as b, resolveAuthEnvState as bt, createCommandEnv as c, resolvePluginScaffoldRoots as ct, extractBackfillCliOptions as d, getPluginLockfilePath as dt, resolvePluginPreset as et, extractConcaveRunTargetArgs as f, getSchemaFilePath as ft, formatDocsOutput as g, applyPlanningDependencyInstall as gt, extractResetCliOptions as h, applyDependencyHintsInstall as ht, buildInitializationPlan as i, getPluginCatalogEntry as it, resolveDocTopic as j, resolveCodegenTrimSegments as k, ensureConvexGitignoreEntry as l, assertSchemaFileExists as lt, extractMigrationDownOptions as m, resolveSchemaInstalledPlugins as mt, applyPluginInstallPlanFiles as n, resolveTemplateSelectionSource as nt, createBackendAdapter as o, isSupportedPluginKey as ot, extractMigrationCliOptions as p, readPluginLockfile as pt, withWorkingDirectory as q, assertNoRemovedDevPreRunFlag as r, resolveTemplatesByIdOrThrow as rt, createBackendCommandEnv as s, buildPluginInstallPlan as st, applyDependencyInstallPlan as t, resolvePresetScaffoldTemplates as tt, extractBackendRunTargetArgs as u, collectInstalledPluginKeys as ut, getAggregateBackfillDeploymentKey as v, inspectPluginDependencyInstall as vt, parseArgs as w, getConvexConfig as wt, isConvexDevPreRunConflictFlag as x, serializeEnvValue as xt, getDevAggregateBackfillStatePath as y, resolveProjectScaffoldContext as yt, runConfiguredCodegen as z };
+export { promptForScaffoldTemplateSelection as $, resolveCodegenTrimSegments as A, runConfiguredCodegen as B, isEntryPoint as C, serializeEnvValue as Ct, parseInitCommandArgs as D, logger as Dt, parseBackendRunJson as E, getConvexConfig as Et, resolveRunDeps as F, runMigrationFlow as G, runDevSchemaBackfillIfNeeded as H, runAfterScaffoldScript as I, withWorkingDirectory as J, trackProcess as K, runAggregateBackfillFlow as L, resolveDocTopic as M, resolveInitProjectDir as N, readPackageVersions as O, highlighter as Ot, resolveMigrationConfig as P, promptForPluginSelection as Q, runAggregatePruneFlow as R, isConvexDevPreRunConflictFlag as S, resolveAuthEnvState as St, parseArgs as T, generateMeta as Tt, runInitCommandFlow as U, runConvexInitIfNeeded as V, runMigrationCreate as W, collectPluginScaffoldTemplates as X, createSpinner as Y, filterScaffoldTemplatePathMap as Z, formatInfoOutput as _, applyPlanningDependencyInstall as _t, cleanup as a, getPluginCatalogEntry as at, getDevAggregateBackfillStatePath as b, resolveSupportedDependencyWarnings as bt, createCommandEnv as c, buildPluginInstallPlan as ct, extractBackfillCliOptions as d, collectInstalledPluginKeys as dt, resolveAddTemplateDefaults as et, extractConcaveRunTargetArgs as f, getPluginLockfilePath as ft, formatDocsOutput as g, applyDependencyHintsInstall as gt, extractResetCliOptions as h, resolveSchemaInstalledPlugins as ht, buildInitializationPlan as i, resolveTemplatesByIdOrThrow as it, resolveConfiguredBackend as j, resolveBackfillConfig as k, ensureConvexGitignoreEntry as l, resolvePluginScaffoldRoots as lt, extractMigrationDownOptions as m, readPluginLockfile as mt, applyPluginInstallPlanFiles as n, resolvePresetScaffoldTemplates as nt, createBackendAdapter as o, getSupportedPluginKeys as ot, extractMigrationCliOptions as p, getSchemaFilePath as pt, withLocalCodegenEnv as q, assertNoRemovedDevPreRunFlag as r, resolveTemplateSelectionSource as rt, createBackendCommandEnv as s, isSupportedPluginKey as st, applyDependencyInstallPlan as t, resolvePluginPreset as tt, extractBackendRunTargetArgs as u, assertSchemaFileExists as ut, getAggregateBackfillDeploymentKey as v, applyPluginDependencyInstall as vt, isInitialized as w, stripConvexCommandNoise as wt, hasRemoteConvexDeploymentEnv as x, resolveProjectScaffoldContext as xt, getConvexDeploymentCommandEnv as y, inspectPluginDependencyInstall as yt, runBackendFunction as z };

package/dist/{builder-Cb6gloDB.js → builder-DBgto1yn.js}

@@ -1,6 +1,7 @@
-import { l as pick, o as vRequired, t as addFieldsToValidator } from "./validators-B7oIJCAp.js";
-import { n as customCtx, t as NoOp } from "./customFunctions-C0voKmtx.js";
-import { s as getTransformer } from "./transformer-DtDhR3Lc.js";
+import { i as pick } from "./upstream-BR6sBLg3.js";
+import { o as vRequired, t as addFieldsToValidator } from "./validators-C7LelqTN.js";
+import { n as customCtx, t as NoOp } from "./customFunctions-DxEEO4Dq.js";
+import { s as getTransformer } from "./transformer-C6pGVHqx.js";
 import { ConvexError, v } from "convex/values";
 import { HttpRouter, actionGeneric, httpActionGeneric, internalActionGeneric, internalMutationGeneric, internalQueryGeneric, mutationGeneric, queryGeneric } from "convex/server";
 import { z } from "zod";

package/dist/{caller-factory-cTXNvYdz.js → caller-factory-NEfgD5E0.js}

@@ -1,5 +1,5 @@
-import { i as getFunctionType, n as getFuncRef, t as buildMetaIndex } from "./meta-utils-0Pu0Nrap.js";
-import { s as getTransformer } from "./transformer-DtDhR3Lc.js";
+import { i as getFunctionType, n as getFuncRef, t as buildMetaIndex } from "./meta-utils-D9K4fICl.js";
+import { s as getTransformer } from "./transformer-C6pGVHqx.js";
 import { fetchAction, fetchMutation, fetchQuery } from "convex/nextjs";
 
 //#region src/server/caller.ts
@@ -114,7 +114,7 @@ function createLazyCaller(api, createContext) {
 /** biome-ignore-all lint/suspicious/noExplicitAny: lib */
 /**
 * Framework-agnostic caller factory.
-* getToken is passed as a parameter - decoupled from @convex-dev/better-auth.
+* getToken is passed as a parameter so framework auth helpers stay decoupled.
 */
 const CONVEX_SITE_URL_RE = /\.convex\.site(?=\/|$)/;
 const getArgsAndOptions = (args, token, url) => [args[0], {

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { $ as resolveAddTemplateDefaults, A as resolveConfiguredBackend, B as runConvexInitIfNeeded, C as isInitialized, D as readPackageVersions, E as parseInitCommandArgs, Et as highlighter, F as runAfterScaffoldScript, G as trackProcess, H as runInitCommandFlow, I as runAggregateBackfillFlow, J as createSpinner, K as withLocalCodegenEnv, L as runAggregatePruneFlow, M as resolveInitProjectDir, N as resolveMigrationConfig, O as resolveBackfillConfig, P as resolveRunDeps, Q as promptForScaffoldTemplateSelection, R as runBackendFunction, S as isEntryPoint, St as stripConvexCommandNoise, T as parseBackendRunJson, Tt as logger, U as runMigrationCreate, V as runDevSchemaBackfillIfNeeded, W as runMigrationFlow, X as filterScaffoldTemplatePathMap, Y as collectPluginScaffoldTemplates, Z as promptForPluginSelection, _ as formatInfoOutput, _t as applyPluginDependencyInstall, a as cleanup, at as getSupportedPluginKeys, b as hasRemoteConvexDeploymentEnv, bt as resolveAuthEnvState, c as createCommandEnv, ct as resolvePluginScaffoldRoots, d as extractBackfillCliOptions, dt as getPluginLockfilePath, et as resolvePluginPreset, f as extractConcaveRunTargetArgs, ft as getSchemaFilePath, g as formatDocsOutput, gt as applyPlanningDependencyInstall, h as extractResetCliOptions, ht as applyDependencyHintsInstall, i as buildInitializationPlan, it as getPluginCatalogEntry, j as resolveDocTopic, k as resolveCodegenTrimSegments, l as ensureConvexGitignoreEntry, lt as assertSchemaFileExists, m as extractMigrationDownOptions, mt as resolveSchemaInstalledPlugins, n as applyPluginInstallPlanFiles, nt as resolveTemplateSelectionSource, o as createBackendAdapter, ot as isSupportedPluginKey, p as extractMigrationCliOptions, pt as readPluginLockfile, q as withWorkingDirectory, r as assertNoRemovedDevPreRunFlag, rt as resolveTemplatesByIdOrThrow, s as createBackendCommandEnv, st as buildPluginInstallPlan, t as applyDependencyInstallPlan, tt as resolvePresetScaffoldTemplates, u as extractBackendRunTargetArgs, ut as collectInstalledPluginKeys, v as getAggregateBackfillDeploymentKey, vt as inspectPluginDependencyInstall, w as parseArgs, x as isConvexDevPreRunConflictFlag, xt as serializeEnvValue, y as getDevAggregateBackfillStatePath, yt as resolveProjectScaffoldContext, z as runConfiguredCodegen } from "./backend-core-DqCCa0nr.mjs";
+import { $ as promptForScaffoldTemplateSelection, A as resolveCodegenTrimSegments, B as runConfiguredCodegen, C as isEntryPoint, Ct as serializeEnvValue, D as parseInitCommandArgs, Dt as logger, E as parseBackendRunJson, F as resolveRunDeps, G as runMigrationFlow, H as runDevSchemaBackfillIfNeeded, I as runAfterScaffoldScript, J as withWorkingDirectory, K as trackProcess, L as runAggregateBackfillFlow, M as resolveDocTopic, N as resolveInitProjectDir, O as readPackageVersions, Ot as highlighter, P as resolveMigrationConfig, Q as promptForPluginSelection, R as runAggregatePruneFlow, S as isConvexDevPreRunConflictFlag, St as resolveAuthEnvState, T as parseArgs, U as runInitCommandFlow, V as runConvexInitIfNeeded, W as runMigrationCreate, X as collectPluginScaffoldTemplates, Y as createSpinner, Z as filterScaffoldTemplatePathMap, _ as formatInfoOutput, _t as applyPlanningDependencyInstall, a as cleanup, at as getPluginCatalogEntry, b as getDevAggregateBackfillStatePath, bt as resolveSupportedDependencyWarnings, c as createCommandEnv, ct as buildPluginInstallPlan, d as extractBackfillCliOptions, dt as collectInstalledPluginKeys, et as resolveAddTemplateDefaults, f as extractConcaveRunTargetArgs, ft as getPluginLockfilePath, g as formatDocsOutput, gt as applyDependencyHintsInstall, h as extractResetCliOptions, ht as resolveSchemaInstalledPlugins, i as buildInitializationPlan, it as resolveTemplatesByIdOrThrow, j as resolveConfiguredBackend, k as resolveBackfillConfig, l as ensureConvexGitignoreEntry, lt as resolvePluginScaffoldRoots, m as extractMigrationDownOptions, mt as readPluginLockfile, n as applyPluginInstallPlanFiles, nt as resolvePresetScaffoldTemplates, o as createBackendAdapter, ot as getSupportedPluginKeys, p as extractMigrationCliOptions, pt as getSchemaFilePath, q as withLocalCodegenEnv, r as assertNoRemovedDevPreRunFlag, rt as resolveTemplateSelectionSource, s as createBackendCommandEnv, st as isSupportedPluginKey, t as applyDependencyInstallPlan, tt as resolvePluginPreset, u as extractBackendRunTargetArgs, ut as assertSchemaFileExists, v as getAggregateBackfillDeploymentKey, vt as applyPluginDependencyInstall, w as isInitialized, wt as stripConvexCommandNoise, x as hasRemoteConvexDeploymentEnv, xt as resolveProjectScaffoldContext, y as getConvexDeploymentCommandEnv, yt as inspectPluginDependencyInstall, z as runBackendFunction } from "./backend-core-CXmrWqdi.mjs";
 import fs, { existsSync, readFileSync } from "node:fs";
 import path, { delimiter, dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -381,7 +381,7 @@ function filterDevStartupLine(rawLine) {
 	const line = stripConvexCommandNoise(rawLine).trim();
 	if (!line) return { kind: "skip" };
 	if (DEV_SUPPRESSED_LINE_PATTERNS.some((pattern) => pattern.test(line))) return { kind: "skip" };
-	if (line.includes("Finished running function \"init\"") || line.includes("CONVEX_AGENT_MODE=anonymous mode is in beta") || line.includes("Convex AI files are not installed.") || line.includes("Preparing Convex functions...") || line.includes("Bundling component schemas and implementations") || line.includes("Uploading functions to Convex")) return { kind: "skip" };
+	if (line.includes("Finished running function \"init\"") || line.includes("Convex AI files are not installed.") || line.includes("Preparing Convex functions...") || line.includes("Bundling component schemas and implementations") || line.includes("Uploading functions to Convex")) return { kind: "skip" };
 	if (DEV_READY_LINE_RE.test(line)) return {
 		kind: "ready",
 		message: line.toLowerCase().includes("concave") ? "Concave ready" : "Convex ready"
@@ -652,12 +652,6 @@ function resolveImplicitConvexRemoteDeploymentEnv(cwd = process.cwd()) {
 		CONVEX_SELF_HOSTED_ADMIN_KEY: parsed.CONVEX_SELF_HOSTED_ADMIN_KEY
 	};
 }
-function resolveImplicitConvexAnonymousAgentMode(cwd = process.cwd()) {
-	const envLocalPath = join(cwd, ".env.local");
-	if (!fs.existsSync(envLocalPath)) return;
-	const deployment = parseEnv(fs.readFileSync(envLocalPath, "utf8")).CONVEX_DEPLOYMENT?.trim();
-	if (deployment === "anonymous-agent" || deployment?.startsWith("anonymous:")) return "anonymous";
-}
 function resolveConvexEnvFileCommandEnv(args, cwd = process.cwd()) {
 	let envFilePath = null;
 	for (let i = 0; i < args.length; i += 1) {
@@ -880,12 +874,11 @@ const handleDevCommand = async (argv, deps) => {
 	const explicitConvexTargetArgs = extractBackendRunTargetArgs("convex", convexDevArgs);
 	const explicitConvexCommandEnv = resolveConvexEnvFileCommandEnv(convexDevArgs);
 	const implicitConvexCommandEnv = backend === "convex" && explicitConvexTargetArgs.length === 0 && explicitConvexCommandEnv === null ? resolveImplicitConvexRemoteDeploymentEnv() : null;
-	const implicitConvexAgentMode = backend === "convex" && explicitConvexTargetArgs.length === 0 && !explicitConvexCommandEnv?.CONVEX_AGENT_MODE && !implicitConvexCommandEnv?.CONVEX_AGENT_MODE ? resolveImplicitConvexAnonymousAgentMode() : void 0;
 	const effectiveConvexCommandEnv = explicitConvexCommandEnv ?? implicitConvexCommandEnv;
 	const preRunFunction = config.dev.preRun;
 	if (bootstrap && backend !== "convex") throw new Error("`kitcn dev --bootstrap` is only supported for backend convex.");
 	if (preRunFunction && backend === "concave") throw new Error("`dev.preRun` is only supported for backend convex. Concave dev has no equivalent `--run` flow.");
-	if (preRunFunction && convexDevArgs.some((arg) => isConvexDevPreRunConflictFlag(arg))) throw new Error("`dev.preRun` cannot be combined with Convex dev run flags (`--run`, `--run-sh`, `--run-component`).");
+	if (preRunFunction && convexDevArgs.some((arg) => isConvexDevPreRunConflictFlag(arg))) throw new Error("`dev.preRun` cannot be combined with Convex dev run flags (`--run`, `--start`, `--run-sh`, `--run-component`).");
 	const backendAdapter = createBackendAdapter({
 		backend,
 		realConvexPath,
@@ -926,8 +919,7 @@ const handleDevCommand = async (argv, deps) => {
 		echoOutput: false,
 		env: {
 			...localNodeEnvOverrides,
-			...effectiveConvexCommandEnv,
-			...implicitConvexAgentMode ? { CONVEX_AGENT_MODE: implicitConvexAgentMode } : {}
+			...effectiveConvexCommandEnv
 		},
 		targetArgs
 	});
@@ -980,7 +972,6 @@ const handleDevCommand = async (argv, deps) => {
 		env: createBackendCommandEnv({
 			...localNodeEnvOverrides,
 			...effectiveConvexCommandEnv,
-			...implicitConvexAgentMode ? { CONVEX_AGENT_MODE: implicitConvexAgentMode } : {},
 			...concaveLocalDevContract?.backendEnv
 		}),
 		reject: false
@@ -1781,6 +1772,7 @@ const handleDeployCommand = async (argv, deps = {}) => {
 	const { remainingArgs: deployArgsWithoutMigrationFlags, overrides: deployMigrationOverrides } = extractMigrationCliOptions(parsed.convexArgs);
 	const { remainingArgs: deployCommandArgs, overrides: deployBackfillOverrides } = extractBackfillCliOptions(deployArgsWithoutMigrationFlags);
 	const deployArgs = [...config.deploy.args, ...deployCommandArgs];
+	const deployCommandEnv = backend === "convex" ? getConvexDeploymentCommandEnv() : void 0;
 	const deployResult = await execaFn(backendAdapter.command, [
 		...backendAdapter.argsPrefix,
 		"deploy",
@@ -1788,7 +1780,7 @@ const handleDeployCommand = async (argv, deps = {}) => {
 	], {
 		stdio: "inherit",
 		cwd: process.cwd(),
-		env: createBackendCommandEnv(),
+		env: createBackendCommandEnv(deployCommandEnv),
 		reject: false
 	});
 	if ((deployResult.exitCode ?? 1) !== 0) return deployResult.exitCode ?? 1;
@@ -1800,6 +1792,7 @@ const handleDeployCommand = async (argv, deps = {}) => {
 		backendAdapter,
 		migrationConfig,
 		targetArgs,
+		env: deployCommandEnv,
 		context: "deploy",
 		direction: "up"
 	});
@@ -1810,6 +1803,7 @@ const handleDeployCommand = async (argv, deps = {}) => {
 		backfillConfig,
 		mode: "resume",
 		targetArgs,
+		env: deployCommandEnv,
 		context: "deploy"
 	});
 };
@@ -2470,16 +2464,6 @@ Options:
 function assertNoVerifyLifecycleFlags(args) {
 	if (args.includes("--once") || args.includes("--bootstrap")) throw new Error("`kitcn verify` already runs one-shot runtime proof. Do not pass `--once` or `--bootstrap`.");
 }
-async function withAnonymousVerifyAgentMode(run) {
-	const previous = process.env.CONVEX_AGENT_MODE;
-	if (!previous) process.env.CONVEX_AGENT_MODE = "anonymous";
-	try {
-		return await run();
-	} finally {
-		if (previous === void 0) delete process.env.CONVEX_AGENT_MODE;
-		else process.env.CONVEX_AGENT_MODE = previous;
-	}
-}
 function hasConfiguredLocalConvexDeployment(cwd = process.cwd()) {
 	return fs.existsSync(path.join(cwd, ".convex", "local", "default", "config.json"));
 }
@@ -2524,7 +2508,7 @@ const handleVerifyCommand = async (argv, deps) => {
 	if (getAggregateBackfillDeploymentKey(extractBackendRunTargetArgs(backend, parsed.convexArgs)) !== "local") throw new Error("`kitcn verify` is local-only. Remove remote deployment flags like `--prod`, `--preview-name`, and `--deployment-name`.");
 	const devArgv = buildVerifyDevArgv(argv);
 	if (hasConfiguredLocalConvexDeployment()) return handleDevCommand(devArgv, deps);
-	return withIsolatedLocalConvexState(() => withAnonymousVerifyAgentMode(() => handleDevCommand(devArgv, deps)));
+	return withIsolatedLocalConvexState(() => handleDevCommand(devArgv, deps));
 };
 
 //#endregion
@@ -2654,6 +2638,15 @@ const LOCAL_NODE_REEXEC_COMMANDS = new Set([
 	"init",
 	"verify"
 ]);
+const DEPENDENCY_WARNING_COMMANDS = new Set([
+	"add",
+	"codegen",
+	"deploy",
+	"dev",
+	"env",
+	"init",
+	"verify"
+]);
 const COMMAND_HELP = {
 	init: INIT_HELP_TEXT,
 	add: ADD_HELP_TEXT,
@@ -2759,6 +2752,10 @@ const printCommandHelp = (command, backend = "convex") => {
 	}
 	printRootHelp(backend);
 };
+function warnSupportedDependencyIssues(command) {
+	if (!DEPENDENCY_WARNING_COMMANDS.has(command)) return;
+	for (const warning of resolveSupportedDependencyWarnings()) logger.warn(`⚠️  kitcn expects ${warning.packageName} ${warning.minimum}; found ${warning.current}. Run \`bun add ${warning.installSpec}\` when you can.`);
+}
 const handlePassthroughCommand = async (argv, deps) => {
 	const parsed = parseArgs(argv);
 	const { execa: execaFn, loadCliConfig, realConvex, realConcave } = resolveRunDeps(deps);
@@ -2811,6 +2808,7 @@ async function run(argv, deps) {
 			deps
 		});
 		if (reexecExitCode !== null) return reexecExitCode;
+		warnSupportedDependencyIssues("dev");
 		return handleDevCommand(argv, deps);
 	}
 	if (VERSION_FLAGS.has(argv[0])) {
@@ -2846,7 +2844,9 @@ async function run(argv, deps) {
 		printCommandHelp(parsed.command, getBackend());
 		return 0;
 	}
-	return (COMMAND_HANDLERS[parsed.command] ?? handlePassthroughCommand)(argv, deps);
+	const handler = COMMAND_HANDLERS[parsed.command] ?? handlePassthroughCommand;
+	warnSupportedDependencyIssues(parsed.command);
+	return handler(argv, deps);
 }
 if (isEntryPoint(process.argv[1], __filename)) {
 	process.on("SIGINT", () => process.exit(0));