kitcn 0.14.2 → 0.15.0

package/dist/{backend-core-DDs8CYH7.mjs → backend-core-B091CyHN.mjs}

@@ -5964,6 +5964,51 @@ async function pullEnv(options = {}, deps = {}) {
 }
 const syncEnv = pushEnv;
 
+//#endregion
+//#region src/cli/package-manager.ts
+function detectPackageManagerFromUserAgent(env = process.env) {
+	const userAgent = env.npm_config_user_agent?.trim().toLowerCase();
+	if (!userAgent) return null;
+	if (userAgent.startsWith("bun/")) return "bun";
+	if (userAgent.startsWith("pnpm/")) return "pnpm";
+	if (userAgent.startsWith("yarn/")) return "yarn";
+	if (userAgent.startsWith("npm/")) return "npm";
+	return null;
+}
+function detectPackageManager(projectDir, env = process.env) {
+	let current = resolve(projectDir);
+	while (true) {
+		const packageJsonPath = join(current, "package.json");
+		if (fs.existsSync(packageJsonPath)) try {
+			const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+			if (typeof pkg.packageManager === "string") {
+				if (pkg.packageManager.startsWith("bun@")) return "bun";
+				if (pkg.packageManager.startsWith("pnpm@")) return "pnpm";
+				if (pkg.packageManager.startsWith("yarn@")) return "yarn";
+				if (pkg.packageManager.startsWith("npm@")) return "npm";
+			}
+		} catch {}
+		if (fs.existsSync(join(current, "bun.lock")) || fs.existsSync(join(current, "bun.lockb"))) return "bun";
+		if (fs.existsSync(join(current, "pnpm-lock.yaml")) || fs.existsSync(join(current, "pnpm-workspace.yaml"))) return "pnpm";
+		if (fs.existsSync(join(current, "yarn.lock"))) return "yarn";
+		if (fs.existsSync(join(current, "package-lock.json"))) return "npm";
+		const parent = dirname(current);
+		if (parent === current) break;
+		current = parent;
+	}
+	return detectPackageManagerFromUserAgent(env) ?? "bun";
+}
+function resolveDependencyInstallCommand(packageManager, packageSpecs) {
+	return {
+		command: packageManager,
+		args: packageManager === "npm" ? ["install", ...packageSpecs] : ["add", ...packageSpecs]
+	};
+}
+function formatDependencyInstallCommand(packageManager, packageSpecs) {
+	const { args, command } = resolveDependencyInstallCommand(packageManager, packageSpecs);
+	return `${command} ${args.join(" ")}`;
+}
+
 //#endregion
 //#region src/cli/project-context.ts
 function isReactScaffoldFramework(framework) {
@@ -6188,7 +6233,7 @@ const EXACT_VERSION_RE = /^(\d+)\.(\d+)\.\d+$/;
 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.36.1";
+const SUPPORTED_CONVEX_VERSION = "1.38.0";
 const SUPPORTED_BETTER_AUTH_VERSION = "1.6.9";
 const SUPPORTED_HONO_VERSION = "4.12.9";
 const SUPPORTED_OPENTELEMETRY_API_VERSION = "1.9.0";
@@ -6378,6 +6423,14 @@ const resolvePackageJsonInstallTarget = () => {
 		packageJson: packageJsonPath ? JSON.parse(fs.readFileSync(packageJsonPath, "utf8")) : null
 	};
 };
+const runDependencyInstall = async (packageJsonPath, packageSpecs, execaFn) => {
+	const cwd = dirname(packageJsonPath);
+	const { args, command } = resolveDependencyInstallCommand(detectPackageManager(cwd), packageSpecs);
+	await execaFn(command, args, {
+		cwd,
+		stdio: "inherit"
+	});
+};
 const resolveBunPeerWarningPreinstallSpecs = () => {
 	const { packageJsonPath, packageJson } = resolvePackageJsonInstallTarget();
 	if (!packageJsonPath || !packageJson) return [];
@@ -6392,10 +6445,7 @@ const applyBunPeerWarningPreinstall = async (execaFn) => {
 	const dependencySpecs = resolveBunPeerWarningPreinstallSpecs();
 	if (dependencySpecs.length === 0) return [];
 	const { packageJsonPath } = resolvePackageJsonInstallTarget();
-	await execaFn("bun", ["add", ...dependencySpecs], {
-		cwd: dirname(packageJsonPath),
-		stdio: "inherit"
-	});
+	await runDependencyInstall(packageJsonPath, dependencySpecs, execaFn);
 	return dependencySpecs;
 };
 const inspectPluginDependencyInstall = async (params) => {
@@ -6435,10 +6485,7 @@ const applyDependencyHintsInstall = async (dependencyHints, execaFn) => {
 	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", ...installSpecs], {
-		cwd: dirname(packageJsonPath),
-		stdio: "inherit"
-	});
+	await runDependencyInstall(packageJsonPath, installSpecs, execaFn);
 	return [...preinstalledSpecs, ...installSpecs];
 };
 const applyPlanningDependencyInstall = async (dependencySpecs, execaFn) => {
@@ -6446,20 +6493,14 @@ const applyPlanningDependencyInstall = async (dependencySpecs, execaFn) => {
 	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", ...installSpecs], {
-		cwd: dirname(packageJsonPath),
-		stdio: "inherit"
-	});
+	await runDependencyInstall(packageJsonPath, installSpecs, execaFn);
 	return [...preinstalledSpecs, ...installSpecs];
 };
 const applyPluginDependencyInstall = async (install, execaFn) => {
 	if (install.skipped || !install.packageName || !install.packageJsonPath) return install;
 	await applyBunPeerWarningPreinstall(execaFn);
 	const packageSpec = install.packageSpec ?? install.packageName;
-	await execaFn("bun", ["add", packageSpec], {
-		cwd: dirname(install.packageJsonPath),
-		stdio: "inherit"
-	});
+	await runDependencyInstall(install.packageJsonPath, [packageSpec], execaFn);
 	return {
 		packageName: install.packageName,
 		packageSpec,
@@ -7361,8 +7402,10 @@ const buildPluginInstallPlan = async (params) => {
 		scaffoldFiles
 	}) ?? scaffoldFiles;
 	const dependency = await inspectPluginDependencyInstall({ descriptor: params.descriptor });
+	const dependencyPackageSpec = dependency.packageSpec ?? dependency.packageName;
 	const dependencyHints = [...new Set(effectiveTemplates.flatMap((template) => template.dependencyHints))];
-	const dependencyHintCommand = dependencyHints.length > 0 ? `bun add ${dependencyHints.join(" ")}` : void 0;
+	const dependencyPackageManager = detectPackageManager(dependency.packageJsonPath ? dirname(dependency.packageJsonPath) : process.cwd());
+	const dependencyHintCommand = dependencyHints.length > 0 ? formatDependencyInstallCommand(dependencyPackageManager, dependencyHints) : void 0;
 	const envReminders = rawConvexAuthPreset ? [] : resolvePluginEnvReminders(params.functionsDir, params.descriptor.envFields ?? []);
 	const nextSteps = dependencyHintCommand ? [`Install scaffold dependencies: ${dependencyHintCommand}`] : [];
 	const codegenCommand = rawConvexAuthPreset ? "kitcn codegen --scope auth" : "kitcn codegen";
@@ -7444,8 +7487,8 @@ const buildPluginInstallPlan = async (params) => {
 			status: dependency.skipped ? "skipped" : "pending",
 			reason: dependency.reason === "already_present" ? "Dependency already installed." : dependency.reason === "missing_package_json" ? "No package.json found for dependency installation." : `Install ${dependency.packageSpec ?? dependency.packageName}.`,
 			path: dependency.packageJsonPath ? normalizePath$1(relative(process.cwd(), dependency.packageJsonPath)) : void 0,
-			packageName: dependency.packageSpec ?? dependency.packageName,
-			command: (dependency.packageSpec ?? dependency.packageName) && dependency.packageJsonPath && !dependency.skipped ? `bun add ${dependency.packageSpec ?? dependency.packageName}` : void 0
+			packageName: dependencyPackageSpec,
+			command: dependencyPackageSpec && dependency.packageJsonPath && !dependency.skipped ? formatDependencyInstallCommand(dependencyPackageManager, [dependencyPackageSpec]) : void 0
 		},
 		{
 			kind: "codegen",
@@ -10635,8 +10678,7 @@ const authRegistryItem = defineInternalRegistryItem({
 //#endregion
 //#region src/cli/registry/items/ratelimit/ratelimit-plugin.template.ts
 const FUNCTIONS_DIR_IMPORT_PLACEHOLDER$4 = "__KITCN_FUNCTIONS_DIR__";
-const RATELIMIT_PLUGIN_TEMPLATE = `import { getSessionNetworkSignals } from "kitcn/auth";
-import { MINUTE, Ratelimit, RatelimitPlugin } from "kitcn/ratelimit";
+const RATELIMIT_PLUGIN_TEMPLATE = `import { MINUTE, Ratelimit, RatelimitPlugin } from "kitcn/ratelimit";
 import type { MutationCtx } from "${FUNCTIONS_DIR_IMPORT_PLACEHOLDER$4}/generated/server";
 
 const fixed = (rate: number) => Ratelimit.fixedWindow(rate, MINUTE);
@@ -10677,6 +10719,15 @@ export function getUserTier(user: RatelimitUser | null): RatelimitTier {
   return "free";
 }
 
+async function getRequestSignals(ctx: RatelimitCtx) {
+  const { ip, userAgent } = await ctx.meta.getRequestMetadata();
+
+  return {
+    ...(ip ? { ip } : {}),
+    ...(userAgent ? { userAgent } : {}),
+  };
+}
+
 export const ratelimit = RatelimitPlugin.configure({
   buckets: ratelimitBuckets,
   getBucket: ({ meta }: { meta: RatelimitMeta }) => meta.ratelimit ?? "default",
@@ -10684,7 +10735,7 @@ export const ratelimit = RatelimitPlugin.configure({
   getIdentifier: ({ user }: { user: RatelimitUser | null }) =>
     user?.id ?? "anonymous",
   getTier: getUserTier,
-  getSignals: ({ ctx }: { ctx: RatelimitCtx }) => getSessionNetworkSignals(ctx),
+  getSignals: ({ ctx }: { ctx: RatelimitCtx }) => getRequestSignals(ctx),
   prefix: ({ bucket, tier }) => \`ratelimit:\${bucket}:\${tier}\`,
   failureMode: "closed",
   enableProtection: true,
@@ -14821,29 +14872,6 @@ function buildTemplateInitializationPlanFiles(params) {
 		buildInitReactMainPlanFile(projectContext)
 	];
 }
-function detectPackageManager(projectDir) {
-	let current = resolve(projectDir);
-	while (true) {
-		const packageJsonPath = join(current, "package.json");
-		if (fs.existsSync(packageJsonPath)) try {
-			const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
-			if (typeof pkg.packageManager === "string") {
-				if (pkg.packageManager.startsWith("bun@")) return "bun";
-				if (pkg.packageManager.startsWith("pnpm@")) return "pnpm";
-				if (pkg.packageManager.startsWith("yarn@")) return "yarn";
-				if (pkg.packageManager.startsWith("npm@")) return "npm";
-			}
-		} catch {}
-		if (fs.existsSync(join(current, "bun.lock")) || fs.existsSync(join(current, "bun.lockb"))) return "bun";
-		if (fs.existsSync(join(current, "pnpm-lock.yaml")) || fs.existsSync(join(current, "pnpm-workspace.yaml"))) return "pnpm";
-		if (fs.existsSync(join(current, "yarn.lock"))) return "yarn";
-		if (fs.existsSync(join(current, "package-lock.json"))) return "npm";
-		const parent = dirname(current);
-		if (parent === current) break;
-		current = parent;
-	}
-	return "bun";
-}
 function resolveShadcnScaffoldProjectDir(projectDir, template) {
 	if (template !== "next") return projectDir;
 	const appsDir = join(projectDir, "apps");
@@ -14867,10 +14895,11 @@ function buildDependencyInstallPlan(projectDir, dependencies) {
 	if (missing.length === 0) return null;
 	const packageManager = detectPackageManager(projectDir);
 	const missingSpecs = missing.map((dependency) => dependency.installSpec);
+	const installCommand = resolveDependencyInstallCommand(packageManager, missingSpecs);
 	return {
 		packageManager,
-		command: packageManager,
-		args: packageManager === "npm" ? ["install", ...missingSpecs] : ["add", ...missingSpecs],
+		command: installCommand.command,
+		args: installCommand.args,
 		packages: missingSpecs,
 		cwd: projectDir
 	};
@@ -15141,7 +15170,6 @@ async function runInitCommandFlow(params) {
 			realConcavePath: params.realConcavePath
 		});
 	}
-	if (existingProjectContext?.framework === "expo") throw new Error("Expo adoption is not supported yet. Start with `kitcn init -t expo --yes`.");
 	if (!existingProjectContext) throw new Error("Could not detect a supported app scaffold. Use `kitcn init -t <next|expo|start|vite>` for a fresh app.");
 	return runScaffoldCommandFlow({
 		allowCodegenBootstrapFallback: !params.initArgs.json,
@@ -16541,4 +16569,4 @@ function isEntryPoint(entry, filename) {
 }
 
 //#endregion
-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 };
+export { promptForScaffoldTemplateSelection as $, resolveCodegenTrimSegments as A, highlighter as At, runConfiguredCodegen as B, isEntryPoint as C, formatDependencyInstallCommand as Ct, parseInitCommandArgs as D, generateMeta as Dt, parseBackendRunJson as E, stripConvexCommandNoise 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, getConvexConfig as Ot, resolveMigrationConfig as P, promptForPluginSelection as Q, runAggregatePruneFlow as R, isConvexDevPreRunConflictFlag as S, detectPackageManager as St, parseArgs as T, serializeEnvValue 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, logger as kt, 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, resolveAuthEnvState as wt, hasRemoteConvexDeploymentEnv as x, resolveProjectScaffoldContext as xt, getConvexDeploymentCommandEnv as y, inspectPluginDependencyInstall as yt, runBackendFunction as z };

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-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-DDs8CYH7.mjs";
+import { $ as promptForScaffoldTemplateSelection, A as resolveCodegenTrimSegments, At as highlighter, B as runConfiguredCodegen, C as isEntryPoint, Ct as formatDependencyInstallCommand, D as parseInitCommandArgs, E as parseBackendRunJson, Et as stripConvexCommandNoise, 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, P as resolveMigrationConfig, Q as promptForPluginSelection, R as runAggregatePruneFlow, S as isConvexDevPreRunConflictFlag, St as detectPackageManager, T as parseArgs, Tt as serializeEnvValue, 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, kt as logger, 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 resolveAuthEnvState, x as hasRemoteConvexDeploymentEnv, xt as resolveProjectScaffoldContext, y as getConvexDeploymentCommandEnv, yt as inspectPluginDependencyInstall, z as runBackendFunction } from "./backend-core-B091CyHN.mjs";
 import fs, { existsSync, readFileSync } from "node:fs";
 import path, { delimiter, dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -2765,7 +2765,11 @@ const printCommandHelp = (command, backend = "convex") => {
 };
 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 packageManager = detectPackageManager(process.cwd());
+	for (const warning of resolveSupportedDependencyWarnings()) {
+		const installCommand = formatDependencyInstallCommand(packageManager, [warning.installSpec]);
+		logger.warn(`⚠️  kitcn expects ${warning.packageName} ${warning.minimum}; found ${warning.current}. Run \`${installCommand}\` when you can.`);
+	}
 }
 const handlePassthroughCommand = async (argv, deps) => {
 	const parsed = parseArgs(argv);

package/dist/watcher.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { Dt as logger, Et as getConvexConfig, F as resolveRunDeps, Tt as generateMeta, j as resolveConfiguredBackend, q as withLocalCodegenEnv } from "./backend-core-DDs8CYH7.mjs";
+import { Dt as generateMeta, F as resolveRunDeps, Ot as getConvexConfig, j as resolveConfiguredBackend, kt as logger, q as withLocalCodegenEnv } from "./backend-core-B091CyHN.mjs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitcn",
-  "version": "0.14.2",
+  "version": "0.15.0",
   "description": "kitcn - React Query integration and CLI tools for Convex",
   "keywords": [
     "convex",
@@ -90,7 +90,7 @@
     "@tanstack/react-query": ">=5",
     "@tanstack/solid-query": ">=5",
     "better-auth": "1.6.9",
-    "convex": ">=1.36",
+    "convex": ">=1.38",
     "hono": "4.12.9",
     "next": ">=14",
     "react": ">=18",

package/skills/kitcn/references/setup/server.md

@@ -370,10 +370,8 @@ Create `convex/lib/plugins/ratelimit/plugin.ts` and call `ratelimit.middleware()
 Use `RatelimitPlugin` from `kitcn/ratelimit`:
 
 ```ts
-import { getSessionNetworkSignals } from "kitcn/auth";
 import { MINUTE, Ratelimit, RatelimitPlugin } from "kitcn/ratelimit";
 import type { MutationCtx } from "../../../functions/generated/server";
-import type { Select } from "../../../shared/api";
 
 const fixed = (rate: number) => Ratelimit.fixedWindow(rate, MINUTE);
 
@@ -392,7 +390,6 @@ type RatelimitUser = {
   id: string;
   isAdmin?: boolean;
   plan?: "premium" | "team" | null;
-  session?: Select<"session"> | null;
 };
 
 type RatelimitCtx = MutationCtx & {
@@ -409,6 +406,15 @@ export function getUserTier(user: RatelimitUser | null): RatelimitTier {
   return "free";
 }
 
+async function getRequestSignals(ctx: RatelimitCtx) {
+  const { ip, userAgent } = await ctx.meta.getRequestMetadata();
+
+  return {
+    ...(ip ? { ip } : {}),
+    ...(userAgent ? { userAgent } : {}),
+  };
+}
+
 export const ratelimit = RatelimitPlugin.configure({
   buckets: ratelimitBuckets,
   getBucket: ({ meta }: { meta: RatelimitMeta }) => meta.ratelimit ?? "default",
@@ -416,13 +422,7 @@ export const ratelimit = RatelimitPlugin.configure({
   getIdentifier: ({ user }: { user: RatelimitUser | null }) =>
     user?.id ?? "anonymous",
   getTier: getUserTier,
-  getSignals: ({
-    ctx,
-    user,
-  }: {
-    ctx: RatelimitCtx;
-    user: RatelimitUser | null;
-  }) => getSessionNetworkSignals(ctx, user?.session ?? null),
+  getSignals: ({ ctx }: { ctx: RatelimitCtx }) => getRequestSignals(ctx),
   prefix: ({ bucket, tier }) => `ratelimit:${bucket}:${tier}`,
   failureMode: "closed",
   enableProtection: true,
@@ -430,6 +430,8 @@ export const ratelimit = RatelimitPlugin.configure({
 });
 ```
 
+Use `ctx.meta.getRequestMetadata()` on Convex 1.38.0+ for IP/user-agent signals in mutation rate limits. Convex also exposes this metadata in actions; route action-side enforcement through a mutation when database-backed ratelimit state is required.
+
 ### 9.5 Scheduling gate
 
 Create `convex/functions/crons.ts` with `cronJobs()` and use `caller.schedule.now/after/at` in mutations/actions for delayed procedure jobs (`ctx.scheduler.*` only for raw `internal.*` functions).