kitcn 0.12.18 → 0.12.20

package/dist/aggregate/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial, dn as ConvexTableWithColumns, tr as ConvexTextBuilderInitial } from "../where-clause-compiler-Dw3EVdi6.js";
+import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial, dn as ConvexTableWithColumns, tr as ConvexTextBuilderInitial } from "../where-clause-compiler-DdjN63Io.js";
 import * as convex_values0 from "convex/values";
 import { GenericId, Infer, Value } from "convex/values";
 import { DocumentByName, GenericDataModel, GenericDatabaseReader, GenericDatabaseWriter, TableNamesInDataModel } from "convex/server";

package/dist/{api-entry-BckXqaLb.js → api-entry-BUAh_K4k.js}

@@ -5,6 +5,7 @@ const isQueryCtx = (ctx) => "db" in ctx;
 const isMutationCtx = (ctx) => "db" in ctx && "scheduler" in ctx;
 const isActionCtx = (ctx) => "runAction" in ctx;
 const isRunMutationCtx = (ctx) => "runMutation" in ctx;
+const isSchedulerCtx = (ctx) => "scheduler" in ctx && typeof ctx.scheduler === "object" && ctx.scheduler !== null;
 const requireQueryCtx = (ctx) => {
 	if (!isQueryCtx(ctx)) throw new Error("Query context required");
 	return ctx;
@@ -14,13 +15,20 @@ const requireMutationCtx = (ctx) => {
 	return ctx;
 };
 const requireActionCtx = (ctx) => {
-	if (!isActionCtx(ctx)) throw new Error("Action context required");
+	if (!isActionCtx(ctx)) {
+		if (isSchedulerCtx(ctx)) throw new Error("Action context required. This ctx can schedule work but cannot call action procedures directly. Use requireSchedulerCtx(ctx) with caller.schedule.*.");
+		throw new Error("Action context required");
+	}
 	return ctx;
 };
 const requireRunMutationCtx = (ctx) => {
 	if (!isRunMutationCtx(ctx)) throw new Error("Mutation or action context required");
 	return ctx;
 };
+const requireSchedulerCtx = (ctx) => {
+	if (!isSchedulerCtx(ctx)) throw new Error("Mutation or action context with scheduler required");
+	return ctx;
+};
 
 //#endregion
 //#region src/server/api-entry.ts
@@ -63,4 +71,4 @@ function createGeneratedFunctionReference(name) {
 }
 
 //#endregion
-export { isMutationCtx as a, requireActionCtx as c, requireRunMutationCtx as d, isActionCtx as i, requireMutationCtx as l, createGeneratedFunctionReference as n, isQueryCtx as o, getGeneratedValue as r, isRunMutationCtx as s, createApiLeaf as t, requireQueryCtx as u };
+export { isMutationCtx as a, isSchedulerCtx as c, requireQueryCtx as d, requireRunMutationCtx as f, isActionCtx as i, requireActionCtx as l, createGeneratedFunctionReference as n, isQueryCtx as o, requireSchedulerCtx as p, getGeneratedValue as r, isRunMutationCtx as s, createApiLeaf as t, requireMutationCtx as u };

package/dist/auth/generated/index.d.ts

@@ -1,2 +1,2 @@
-import { S as defineAuth, _ as GenericAuthBeforeResult, b as GenericAuthTriggerHandlers, g as BetterAuthOptionsWithoutDatabase, i as getGeneratedAuthDisabledReason, n as GeneratedAuthDisabledReasonKind, r as createDisabledAuthRuntime, t as AuthRuntime, v as GenericAuthDefinition, x as GenericAuthTriggers, y as GenericAuthTriggerChange } from "../../generated-contract-disabled-Dzx2IRId.js";
+import { S as defineAuth, _ as GenericAuthBeforeResult, b as GenericAuthTriggerHandlers, g as BetterAuthOptionsWithoutDatabase, i as getGeneratedAuthDisabledReason, n as GeneratedAuthDisabledReasonKind, r as createDisabledAuthRuntime, t as AuthRuntime, v as GenericAuthDefinition, x as GenericAuthTriggers, y as GenericAuthTriggerChange } from "../../generated-contract-disabled-21YxPk5W.js";
 export { type AuthRuntime, BetterAuthOptionsWithoutDatabase, type GeneratedAuthDisabledReasonKind, GenericAuthBeforeResult, GenericAuthDefinition, GenericAuthTriggerChange, GenericAuthTriggerHandlers, GenericAuthTriggers, createDisabledAuthRuntime, defineAuth, getGeneratedAuthDisabledReason };

package/dist/auth/index.d.ts

@@ -1,7 +1,7 @@
 import { a as QueryCtxWithPreferredOrmQueryTable, n as LookupByIdResultByCtx, t as DocByCtx } from "../query-context-CFZqIvD7.js";
 import { t as GetAuth } from "../types-BiJE7qxR.js";
-import { t as GenericCtx } from "../context-utils-HPC5nXzx.js";
-import { S as defineAuth, _ as GenericAuthBeforeResult, a as AuthFunctions, b as GenericAuthTriggerHandlers, c as createApi, d as deleteOneHandler, f as findManyHandler, g as BetterAuthOptionsWithoutDatabase, h as updateOneHandler, i as getGeneratedAuthDisabledReason, l as createHandler, m as updateManyHandler, n as GeneratedAuthDisabledReasonKind, o as Triggers, p as findOneHandler, r as createDisabledAuthRuntime, s as createClient, t as AuthRuntime, u as deleteManyHandler, v as GenericAuthDefinition, x as GenericAuthTriggers, y as GenericAuthTriggerChange } from "../generated-contract-disabled-Dzx2IRId.js";
+import { t as GenericCtx } from "../context-utils-BvWW0Ilq.js";
+import { S as defineAuth, _ as GenericAuthBeforeResult, a as AuthFunctions, b as GenericAuthTriggerHandlers, c as createApi, d as deleteOneHandler, f as findManyHandler, g as BetterAuthOptionsWithoutDatabase, h as updateOneHandler, i as getGeneratedAuthDisabledReason, l as createHandler, m as updateManyHandler, n as GeneratedAuthDisabledReasonKind, o as Triggers, p as findOneHandler, r as createDisabledAuthRuntime, s as createClient, t as AuthRuntime, u as deleteManyHandler, v as GenericAuthDefinition, x as GenericAuthTriggers, y as GenericAuthTriggerChange } from "../generated-contract-disabled-21YxPk5W.js";
 import * as convex_values0 from "convex/values";
 import { Infer } from "convex/values";
 import { DocumentByName, GenericDataModel, GenericMutationCtx, GenericQueryCtx, GenericSchema, PaginationOptions, PaginationResult, SchemaDefinition, TableNamesInDataModel } from "convex/server";

package/dist/auth/index.js

@@ -1,6 +1,6 @@
 import { r as partial, s as asyncMap } from "../validators-B7oIJCAp.js";
 import { i as defineAuth, n as createDisabledAuthRuntime, r as getGeneratedAuthDisabledReason, t as DEFAULT_AUTH_DEFINITION_PATH } from "../generated-contract-disabled-Cih4eITO.js";
-import { n as createGeneratedFunctionReference, o as isQueryCtx, s as isRunMutationCtx } from "../api-entry-BckXqaLb.js";
+import { n as createGeneratedFunctionReference, o as isQueryCtx, s as isRunMutationCtx } from "../api-entry-BUAh_K4k.js";
 import { n as customCtx, r as customMutation } from "../customFunctions-C0voKmtx.js";
 import { a as mergedStream, l as unsetToken, o as stream, t as getByIdWithOrmQueryFallback, v as eq } from "../query-context-B8o6-8kC.js";
 import { v } from "convex/values";

package/dist/auth/nextjs/index.d.ts

@@ -1,4 +1,4 @@
-import { L as ConvexContext, z as LazyCaller } from "../../procedure-caller-DloN1DNv.js";
+import { U as LazyCaller, V as ConvexContext } from "../../procedure-name-D-fDCBlo.js";
 import { GetTokenOptions } from "@convex-dev/better-auth/utils";
 
 //#region src/auth-nextjs/index.d.ts

package/dist/{backend-core-CGjsBIOp.mjs → backend-core-C0uwGXLx.mjs}

@@ -2356,6 +2356,7 @@ export const createApiLeaf = (fnOrRoot, pathOrMeta, maybeMeta) => {
 export const createGeneratedFunctionReference = (name) => ({
   [Symbol.for("functionName")]: name,
 });
+export const registerProcedureNameLookup = () => {};
 export const typedProcedureResolver = (_functionRef, resolver) => resolver;
 export const createGeneratedRegistryRuntime = () => ({
   getCallerFactory() {
@@ -2443,6 +2444,7 @@ const buildTsconfigPathAliases = (cwd) => {
 const getProjectServerParserShimPath = (cwd = process.cwd()) => ensureServerParserShim(cwd);
 const createProjectJiti = (cwd = process.cwd()) => createJiti(cwd, {
 	interopDefault: true,
+	jsx: { runtime: "automatic" },
 	moduleCache: false,
 	alias: {
 		...buildTsconfigPathAliases(cwd),
@@ -2478,10 +2480,10 @@ const ENTRY_POINT_EXTENSIONS = new Set([
 const SCHEMA_RESOLVE_FILTER = /^\.{1,2}\/schema(\.ts|\.js)?$/;
 const USE_NODE_DIRECTIVE_REGEX = /^\s*("|')use node\1;?\s*$/;
 const VALID_IDENTIFIER_REGEX$2 = /^[a-zA-Z_$][\w$]*$/;
-const EXPORTED_CONST_CAPTURE_REGEX = /export\s+const\s+([a-zA-Z_$][\w$]*)\s*=/g;
-const CHAINED_PROCEDURE_CAPTURE_REGEX = /\.\s*(?:query|mutation|action)\s*\(/;
-const EXPORTED_NATIVE_HANDLER_CAPTURE_REGEX = /export\s+const\s+([a-zA-Z_$][\w$]*)\s*=\s*(?:[\w$]+\.)?(?:query|mutation|action|internalQuery|internalMutation|internalAction)\s*\(/g;
-const EXPORTED_ORM_API_DESTRUCTURE_CAPTURE_REGEX = /export\s+const\s*\{([^}]+)\}\s*=\s*orm\.api\s*\(\s*\)\s*;?/g;
+const EXPORTED_CONST_CAPTURE_REGEX$1 = /export\s+const\s+([a-zA-Z_$][\w$]*)\s*=/g;
+const CHAINED_PROCEDURE_CAPTURE_REGEX$1 = /\.\s*(?:query|mutation|action)\s*\(/;
+const EXPORTED_NATIVE_HANDLER_CAPTURE_REGEX$1 = /export\s+const\s+([a-zA-Z_$][\w$]*)\s*=\s*(?:[\w$]+\.)?(?:query|mutation|action|internalQuery|internalMutation|internalAction)\s*\(/g;
+const EXPORTED_ORM_API_DESTRUCTURE_CAPTURE_REGEX$1 = /export\s+const\s*\{([^}]+)\}\s*=\s*orm\.api\s*\(\s*\)\s*;?/g;
 const supportsColor = isColorEnabled();
 const isInteractiveTerminal = process.stdin.isTTY && process.stdout.isTTY;
 let colorEnabled = supportsColor;
@@ -2645,17 +2647,17 @@ const isNodeEntryPoint = (entryPoint, functionsRoot) => {
 };
 const hasRuntimeProcedureType = (value) => value === "query" || value === "mutation" || value === "action";
 const getNativeHandlerExportNames = (source) => {
-	const exportNames = new Set(Array.from(source.matchAll(EXPORTED_NATIVE_HANDLER_CAPTURE_REGEX)).map((match) => match[1]).filter((name) => !!name));
-	const exportConstMatches = Array.from(source.matchAll(EXPORTED_CONST_CAPTURE_REGEX));
+	const exportNames = new Set(Array.from(source.matchAll(EXPORTED_NATIVE_HANDLER_CAPTURE_REGEX$1)).map((match) => match[1]).filter((name) => !!name));
+	const exportConstMatches = Array.from(source.matchAll(EXPORTED_CONST_CAPTURE_REGEX$1));
 	for (const [index, match] of exportConstMatches.entries()) {
 		const exportName = match[1];
 		if (!exportName) continue;
 		const start = (match.index ?? 0) + match[0].length;
 		const end = exportConstMatches[index + 1]?.index ?? source.length;
 		const initializerSlice = source.slice(start, end);
-		if (CHAINED_PROCEDURE_CAPTURE_REGEX.test(initializerSlice)) exportNames.add(exportName);
+		if (CHAINED_PROCEDURE_CAPTURE_REGEX$1.test(initializerSlice)) exportNames.add(exportName);
 	}
-	for (const match of source.matchAll(EXPORTED_ORM_API_DESTRUCTURE_CAPTURE_REGEX)) {
+	for (const match of source.matchAll(EXPORTED_ORM_API_DESTRUCTURE_CAPTURE_REGEX$1)) {
 		const bindings = match[1];
 		for (const binding of bindings.split(",")) {
 			const trimmed = binding.trim();
@@ -3935,6 +3937,11 @@ const EXCLUDED_FILES = new Set([
 	"convex.config.ts",
 	"auth.config.ts"
 ]);
+const EXPORTED_CONST_CAPTURE_REGEX = /export\s+const\s+([a-zA-Z_$][\w$]*)\s*=/g;
+const CHAINED_PROCEDURE_CAPTURE_REGEX = /\.\s*(?:query|mutation|action)\s*\(/;
+const EXPORTED_NATIVE_HANDLER_CAPTURE_REGEX = /export\s+const\s+([a-zA-Z_$][\w$]*)\s*=\s*(?:[\w$]+\.)?(?:query|mutation|action|internalQuery|internalMutation|internalAction)\s*\(/g;
+const EXPORTED_ORM_API_DESTRUCTURE_CAPTURE_REGEX = /export\s+const\s*\{([^}]+)\}\s*=\s*orm\.api\s*\(\s*\)\s*;?/g;
+const DIRECT_CODEGEN_META_CAPTURE_REGEX = /\b_crpc(?:Meta|HttpRoute)\b/;
 /**
 * Check if a file path should be included in meta generation.
 * Filters out private files/directories (prefixed with _) and config files.
@@ -3951,6 +3958,20 @@ function isValidConvexFile(file) {
 	if (EXCLUDED_FILES.has(basename)) return false;
 	return true;
 }
+function hasPotentialCodegenExports(source, filePath) {
+	const normalizedFilePath = filePath?.replace(/\\/g, "/");
+	if (normalizedFilePath === "http.ts" || normalizedFilePath?.endsWith("/http.ts")) return true;
+	if (DIRECT_CODEGEN_META_CAPTURE_REGEX.test(source)) return true;
+	if (Array.from(source.matchAll(EXPORTED_NATIVE_HANDLER_CAPTURE_REGEX)).length) return true;
+	if (Array.from(source.matchAll(EXPORTED_ORM_API_DESTRUCTURE_CAPTURE_REGEX)).length) return true;
+	const exportConstMatches = Array.from(source.matchAll(EXPORTED_CONST_CAPTURE_REGEX));
+	for (const [index, match] of exportConstMatches.entries()) {
+		const start = (match.index ?? 0) + match[0].length;
+		const end = exportConstMatches[index + 1]?.index ?? source.length;
+		if (CHAINED_PROCEDURE_CAPTURE_REGEX.test(source.slice(start, end))) return true;
+	}
+	return false;
+}
 
 //#endregion
 //#region src/cli/utils/logger.ts
@@ -4144,6 +4165,47 @@ function normalizeImportPath(value) {
 function escapeRegex$1(value) {
 	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
+function getIndexLineColumn(source, index) {
+	const lines = source.slice(0, index).split("\n");
+	return {
+		column: (lines.at(-1)?.length ?? 0) + 1,
+		line: lines.length
+	};
+}
+function findProcedureCallIndex(params) {
+	const exportMatch = (params.exportName === "default" ? /\bexport\s+default\b/g : new RegExp(`\\bexport\\s+const\\s+${escapeRegex$1(params.exportName)}\\s*=`, "g")).exec(params.source);
+	if (!exportMatch) return;
+	const tail = params.source.slice(exportMatch.index);
+	const callMatch = new RegExp(`\\.\\s*${params.type}\\s*\\(`, "g").exec(tail);
+	if (!callMatch || callMatch.index < 0) return;
+	return exportMatch.index + callMatch.index;
+}
+function buildProcedureNameLookupEntries(params) {
+	if (params.procedures.length === 0) return [];
+	const source = fs.readFileSync(params.filePath, "utf8");
+	return params.procedures.flatMap((procedure) => {
+		const callIndex = findProcedureCallIndex({
+			exportName: procedure.exportName,
+			source,
+			type: procedure.type
+		});
+		if (callIndex === void 0) return [];
+		const location = getIndexLineColumn(source, callIndex);
+		return [{
+			column: location.column,
+			line: location.line,
+			name: `${params.moduleName}:${procedure.exportName}`
+		}];
+	});
+}
+function emitProcedureNameLookupLiteral(lookup) {
+	const entries = Object.entries(lookup);
+	if (entries.length === 0) return "{}";
+	return `{\n${entries.map(([file, locations]) => {
+		const items = locations.map((location) => `{ column: ${location.column}, line: ${location.line}, name: ${JSON.stringify(location.name)} }`).join(", ");
+		return `  ${JSON.stringify(file)}: [${items}],`;
+	}).join("\n")}\n}`;
+}
 function formatKey(key) {
 	return VALID_IDENTIFIER_RE.test(key) ? key : `'${key}'`;
 }
@@ -4302,13 +4364,17 @@ function getGeneratedRuntimeOutputFile(functionsDir, moduleName) {
 	const runtimeModuleName = moduleName.startsWith(`${GENERATED_DIR}/`) ? moduleName.slice(10) : moduleName;
 	return path.join(functionsDir, GENERATED_DIR, `${runtimeModuleName}.runtime.ts`);
 }
-function emitGeneratedServerPlaceholderFile() {
+function emitGeneratedServerPlaceholderFile(functionsDir) {
+	const functionsDirHint = normalizeImportPath(path.relative(process.cwd(), functionsDir)) || "convex";
 	return `// @ts-nocheck
 // biome-ignore-all format: generated
 /* eslint-disable @typescript-eslint/no-require-imports, @typescript-eslint/no-unused-vars */
 // This file is auto-generated by kitcn
 // Do not edit manually. Run \`kitcn codegen\` to regenerate.
 
+import {
+  registerProcedureNameLookup,
+} from 'kitcn/server';
 import type {
   ActionCtx as ServerActionCtx,
   MutationCtx as ServerMutationCtx,
@@ -4322,6 +4388,8 @@ export type GenericCtx = QueryCtx | MutationCtx | ActionCtx;
 
 ${CRPC_BUILDER_STUB_SOURCE}
 
+registerProcedureNameLookup({}, ${JSON.stringify(functionsDirHint)});
+
 export function withOrm<Ctx>(ctx: Ctx): Ctx {
   return ctx;
 }
@@ -4368,7 +4436,7 @@ function ensureGeneratedSupportPlaceholders(functionsDir, options) {
 	fs.mkdirSync(generatedDir, { recursive: true });
 	const includeAuth = options?.includeAuth ?? true;
 	if (!fs.existsSync(serverOutputFile)) {
-		writeFileIfChanged(serverOutputFile, emitGeneratedServerPlaceholderFile());
+		writeFileIfChanged(serverOutputFile, emitGeneratedServerPlaceholderFile(functionsDir));
 		createdPlaceholderFiles.push(serverOutputFile);
 	}
 	if (includeAuth && !fs.existsSync(authOutputFile)) {
@@ -4449,7 +4517,7 @@ function cleanupGeneratedPluginArtifacts(functionsDir) {
 		force: true
 	});
 }
-function emitGeneratedServerFile(outputFile, functionsDir, hasOrmSchema, hasMigrationsManifest) {
+function emitGeneratedServerFile(outputFile, functionsDir, hasOrmSchema, hasMigrationsManifest, procedureNameLookup) {
 	const asSingleQuotedImport = (importPath) => `'${importPath.replaceAll("'", "\\'")}'`;
 	const serverTypesImportPath = getServerTypesImportPath(outputFile, functionsDir);
 	const dataModelImportPath = getDataModelImportPath(outputFile, functionsDir);
@@ -4461,11 +4529,16 @@ function emitGeneratedServerFile(outputFile, functionsDir, hasOrmSchema, hasMigr
 	const migrationsManifestImportLiteral = asSingleQuotedImport(migrationsManifestImportPath);
 	const migrationsImportLine = hasMigrationsManifest ? `import { migrations } from ${migrationsManifestImportLiteral};\n` : "";
 	const migrationsConfigLine = hasMigrationsManifest ? "  migrations,\n" : "";
+	const functionsDirHint = normalizeImportPath(path.relative(process.cwd(), functionsDir)) || "convex";
+	const procedureNameLookupLiteral = emitProcedureNameLookupLiteral(procedureNameLookup);
 	if (!hasOrmSchema) return `// biome-ignore-all format: generated
 // This file is auto-generated by kitcn
 // Do not edit manually. Run \`kitcn codegen\` to regenerate.
 
-import { initCRPC as baseInitCRPC } from 'kitcn/server';
+import {
+  initCRPC as baseInitCRPC,
+  registerProcedureNameLookup,
+} from 'kitcn/server';
 import type { DataModel } from ${dataModelImportLiteral};
 import type {
   ActionCtx as ServerActionCtx,
@@ -4480,6 +4553,11 @@ export type ActionCtx = ServerActionCtx;
 export type GenericCtx = QueryCtx | MutationCtx | ActionCtx;
 export type OrmCtx<Ctx = QueryCtx> = Ctx;
 
+registerProcedureNameLookup(
+  ${procedureNameLookupLiteral},
+  ${JSON.stringify(functionsDirHint)}
+);
+
 export function withOrm<Ctx extends ServerQueryCtx | ServerMutationCtx>(ctx: Ctx): OrmCtx<Ctx> {
   return ctx as OrmCtx<Ctx>;
 }
@@ -4504,6 +4582,7 @@ import {
 import {
   createGeneratedFunctionReference,
   initCRPC as baseInitCRPC,
+  registerProcedureNameLookup,
 } from 'kitcn/server';
 import type { DataModel } from ${dataModelImportLiteral};
 import type {
@@ -4524,6 +4603,11 @@ ${`const ormFunctions: OrmFunctions = {
 };`}
 const ormSchema = schema;
 
+registerProcedureNameLookup(
+  ${procedureNameLookupLiteral},
+  ${JSON.stringify(functionsDirHint)}
+);
+
 export const orm = createOrm({
   schema: ormSchema,
   ormFunctions,
@@ -5037,6 +5121,7 @@ async function generateMeta(sharedDir, options) {
 	const meta = {};
 	const allHttpRoutes = {};
 	const procedureEntries = [];
+	const procedureNameLookup = {};
 	const fatalParseFailures = [];
 	let createdRuntimePlaceholders = [];
 	let createdSupportPlaceholders = [];
@@ -5065,6 +5150,7 @@ async function generateMeta(sharedDir, options) {
 		try {
 			const jitiInstance = createProjectJiti();
 			const files = listFilesRecursive(functionsDir).filter((file) => file.endsWith(".ts") && isValidConvexFile(file));
+			const parseCandidateFiles = files.filter((file) => hasPotentialCodegenExports(fs.readFileSync(path.join(functionsDir, file), "utf8"), file));
 			const existingRuntimeFilesBeforeParse = new Set(listGeneratedRuntimeFiles(functionsDir));
 			const runtimePlaceholderModules = [...new Set([
 				...files.map((file) => file.replace(TS_EXTENSION_RE$2, "")),
@@ -5072,7 +5158,7 @@ async function generateMeta(sharedDir, options) {
 				...generateAuth ? [generatedAuthModuleName] : []
 			])];
 			createdRuntimePlaceholders = ensureGeneratedRuntimePlaceholders(functionsDir, runtimePlaceholderModules, resolveModuleRuntimeExportNames(runtimePlaceholderModules, normalizedTrimSegments));
-			for (const file of files) {
+			for (const file of parseCandidateFiles) {
 				const filePath = path.join(functionsDir, file);
 				const moduleName = file.replace(TS_EXTENSION_RE$2, "");
 				try {
@@ -5092,6 +5178,13 @@ async function generateMeta(sharedDir, options) {
 						type: procedure.type,
 						kind: "crpc"
 					});
+					const procedureNameEntries = buildProcedureNameLookupEntries({
+						file,
+						filePath,
+						moduleName,
+						procedures
+					});
+					if (procedureNameEntries.length > 0) procedureNameLookup[file] = procedureNameEntries;
 				} catch (error) {
 					const runtimeFile = getGeneratedRuntimeOutputFile(functionsDir, moduleName);
 					if (existingRuntimeFilesBeforeParse.has(runtimeFile)) runtimeFilesPreservedFromParseFailures.add(runtimeFile);
@@ -5172,7 +5265,7 @@ ${optionalTypeExports}
 		if (!fs.existsSync(outputDirname)) fs.mkdirSync(outputDirname, { recursive: true });
 		writeFileIfChanged(outputFile, output);
 	} else fs.rmSync(outputFile, { force: true });
-	const serverOutput = emitGeneratedServerFile(serverOutputFile, functionsDir, hasOrmSchema, hasMigrationsManifest);
+	const serverOutput = emitGeneratedServerFile(serverOutputFile, functionsDir, hasOrmSchema, hasMigrationsManifest, procedureNameLookup);
 	const generatedOutputDirname = path.dirname(serverOutputFile);
 	if (!fs.existsSync(generatedOutputDirname)) fs.mkdirSync(generatedOutputDirname, { recursive: true });
 	writeFileIfChanged(serverOutputFile, serverOutput);

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

@@ -925,9 +925,19 @@ function createNewHttpBuilder(def1, def2) {
 		...def2
 	});
 }
+function resolveHttpProcedureInfo(def) {
+	const route = def.route;
+	return {
+		type: "httpAction",
+		name: def.procedureName ?? (route ? `${route.method} ${route.path}` : void 0),
+		method: route?.method,
+		path: route?.path
+	};
+}
 /** Internal method to create the HTTP procedure */
 function createProcedure(def, handler, _type) {
 	if (!def.route) throw new Error("Route must be defined before action. Use .route(path, method) first.");
+	const middlewareProcedure = resolveHttpProcedureInfo(def);
 	/**
 	* Hono-compatible handler function.
 	* When used with HttpRouterWithHono, Convex ctx is passed via c.env.
@@ -947,6 +957,7 @@ function createProcedure(def, handler, _type) {
 			for (const middleware of def.middlewares) {
 				const result = await middleware({
 					ctx,
+					procedure: middlewareProcedure,
 					input: currentInput,
 					getRawInput,
 					next: async (opts) => {
@@ -1092,6 +1103,9 @@ function createHttpBuilder(def) {
 				...value
 			} : value });
 		},
+		name(value) {
+			return createNewHttpBuilder(def, { procedureName: value });
+		},
 		route(path, method) {
 			const pathParamNames = extractPathParams(path);
 			return createNewHttpBuilder(def, { route: {
@@ -1363,6 +1377,117 @@ function extractRouteMap(procedures) {
 	return result;
 }
 
+//#endregion
+//#region src/server/procedure-name.ts
+const LOOKUP_KEY = "__KITCN_PROCEDURE_NAME_LOOKUP__";
+const HINTS_KEY = "__KITCN_PROCEDURE_NAME_HINTS__";
+const PATH_SEPARATOR_RE = /\\/g;
+const TRIM_SLASHES_RE = /^\/+|\/+$/g;
+const PACKAGE_FRAME_MARKERS = ["/node_modules/kitcn/", "/packages/kitcn/"];
+function decodeFileName(value) {
+	if (!value.startsWith("file://")) return value;
+	try {
+		return decodeURIComponent(new URL(value).pathname);
+	} catch {
+		return value;
+	}
+}
+function normalizePath(value) {
+	return value.replace(PATH_SEPARATOR_RE, "/");
+}
+function normalizeHint(value) {
+	return normalizePath(value).replace(TRIM_SLASHES_RE, "");
+}
+function getGlobalLookup() {
+	const globalScope = globalThis;
+	const existing = globalScope[LOOKUP_KEY];
+	if (existing && typeof existing === "object") return existing;
+	const lookup = {};
+	globalScope[LOOKUP_KEY] = lookup;
+	return lookup;
+}
+function getGlobalHints() {
+	const globalScope = globalThis;
+	const existing = globalScope[HINTS_KEY];
+	if (Array.isArray(existing)) return existing;
+	const hints = [];
+	globalScope[HINTS_KEY] = hints;
+	return hints;
+}
+function registerProcedureNameLookup(lookup, functionsDirHint) {
+	const globalLookup = getGlobalLookup();
+	for (const [relativeFilePath, entries] of Object.entries(lookup)) {
+		const key = normalizePath(relativeFilePath);
+		const existing = globalLookup[key] ?? [];
+		const deduped = /* @__PURE__ */ new Map();
+		for (const entry of [...existing, ...entries]) deduped.set(`${entry.line}:${entry.column}:${entry.name}`, entry);
+		globalLookup[key] = [...deduped.values()].sort((left, right) => left.line - right.line || left.column - right.column || left.name.localeCompare(right.name));
+	}
+	const normalizedHint = normalizeHint(functionsDirHint);
+	if (!normalizedHint) return;
+	const hints = getGlobalHints();
+	if (!hints.includes(normalizedHint)) {
+		hints.push(normalizedHint);
+		hints.sort((left, right) => right.length - left.length);
+	}
+}
+function isPackageFrame(filePath) {
+	const normalized = normalizePath(filePath);
+	return PACKAGE_FRAME_MARKERS.some((marker) => normalized.includes(marker));
+}
+function captureCallsite() {
+	const originalPrepareStackTrace = Error.prepareStackTrace;
+	try {
+		Error.prepareStackTrace = (_error, stack) => stack;
+		const frames = (/* @__PURE__ */ new Error("Capture procedure callsite for middleware name inference.")).stack;
+		for (const frame of frames ?? []) {
+			const rawFileName = frame.getFileName?.();
+			if (!rawFileName) continue;
+			const filePath = normalizePath(decodeFileName(rawFileName));
+			if (filePath.startsWith("node:") || isPackageFrame(filePath)) continue;
+			const line = frame.getLineNumber?.();
+			const column = frame.getColumnNumber?.();
+			if (!line || !column) continue;
+			return {
+				filePath,
+				line,
+				column
+			};
+		}
+	} catch {
+		return;
+	} finally {
+		Error.prepareStackTrace = originalPrepareStackTrace;
+	}
+}
+function resolveRelativeFilePath(filePath) {
+	const normalizedFilePath = normalizePath(filePath);
+	const hints = getGlobalHints();
+	for (const hint of hints) {
+		const marker = `/${hint}/`;
+		const markerIndex = normalizedFilePath.lastIndexOf(marker);
+		if (markerIndex >= 0) return normalizedFilePath.slice(markerIndex + marker.length);
+		if (normalizedFilePath.startsWith(`${hint}/`)) return normalizedFilePath.slice(hint.length + 1);
+	}
+}
+function findBestEntry(entries, location) {
+	const sameLine = entries.filter((entry) => entry.line === location.line);
+	if (sameLine.length === 0) return;
+	return sameLine.reduce((best, entry) => {
+		const bestDistance = Math.abs(best.column - location.column);
+		return Math.abs(entry.column - location.column) < bestDistance ? entry : best;
+	});
+}
+function inferProcedureNameFromCallsite() {
+	const location = captureCallsite();
+	if (!location) return;
+	const relativeFilePath = resolveRelativeFilePath(location.filePath);
+	if (!relativeFilePath) return;
+	const entries = getGlobalLookup()[relativeFilePath];
+	if (!entries || entries.length === 0) return;
+	return findBestEntry(entries, location)?.name;
+}
+
 //#endregion
 //#region src/server/builder.ts
 /**
@@ -1408,8 +1533,15 @@ function createMiddlewareFactory() {
 		return createMiddlewareInner([fn]);
 	};
 }
+const FUNCTION_NAME_SYMBOL = Symbol.for("functionName");
+const resolveProcedureInfo = (type, procedureName, procedureFn) => {
+	return {
+		type,
+		name: (procedureFn && typeof procedureFn === "object" && typeof procedureFn[FUNCTION_NAME_SYMBOL] === "string" ? procedureFn[FUNCTION_NAME_SYMBOL] : void 0) ?? procedureName
+	};
+};
 /** Execute middleware chain recursively with input access */
-async function executeMiddlewares(middlewares, ctx, meta, input, getRawInput, index = 0) {
+async function executeMiddlewares(middlewares, ctx, meta, procedure, input, getRawInput, index = 0) {
 	if (index >= middlewares.length) return {
 		marker: void 0,
 		ctx,
@@ -1421,13 +1553,14 @@ async function executeMiddlewares(middlewares, ctx, meta, input, getRawInput, in
 		const nextCtx = opts?.ctx ?? ctx;
 		const nextInput = opts?.input ?? currentInput;
 		if (opts?.input !== void 0) currentInput = opts.input;
-		return await executeMiddlewares(middlewares, nextCtx, meta, nextInput, getRawInput, index + 1);
+		return await executeMiddlewares(middlewares, nextCtx, meta, procedure, nextInput, getRawInput, index + 1);
 	};
 	return {
 		marker: void 0,
 		ctx: (await middleware({
 			ctx,
 			meta,
+			procedure,
 			input,
 			getRawInput,
 			next
@@ -1630,6 +1763,13 @@ var ProcedureBuilder = class {
 			} : value
 		};
 	}
+	/** Set server-only procedure name for middleware/logging */
+	_name(value) {
+		return {
+			...this._def,
+			procedureName: value
+		};
+	}
 	/** Merge all input schemas into one */
 	_getMergedInput() {
 		const { inputSchemas } = this._def;
@@ -1637,7 +1777,7 @@ var ProcedureBuilder = class {
 		return Object.assign({}, ...inputSchemas);
 	}
 	_createFunction(handler, baseFunction, customFn, fnType) {
-		const { middlewares, outputSchema, meta, functionConfig, isInternal } = this._def;
+		const { middlewares, outputSchema, meta, procedureName, functionConfig, isInternal } = this._def;
 		const mergedInput = this._getMergedInput();
 		const inputSchema = mergedInput ? z.object(mergedInput) : void 0;
 		const convexArgs = resolveConvexArgsShape(mergedInput);
@@ -1646,7 +1786,9 @@ var ProcedureBuilder = class {
 		const typedReturnsSchema = returnsSchema;
 		const typedArgs = convexArgs ?? {};
 		const shouldValidateOutputWithZod = !!outputSchema && returnsSchema !== outputSchema;
-		const fn = customFunction({
+		const resolvedProcedureName = procedureName ?? inferProcedureNameFromCallsite();
+		let fn;
+		fn = customFunction({
 			args: typedArgs,
 			...typedReturnsSchema ? { returns: typedReturnsSchema } : {},
 			handler: async (ctx, rawInput) => {
@@ -1654,7 +1796,7 @@ var ProcedureBuilder = class {
 				const parsedInput = inputSchema ? inputSchema.parse(decodedInput) : decodedInput;
 				const getRawInput = async () => parsedInput;
 				try {
-					const result = await executeMiddlewares(middlewares, ctx, meta, parsedInput, getRawInput);
+					const result = await executeMiddlewares(middlewares, ctx, meta, resolveProcedureInfo(fnType, resolvedProcedureName, fn), parsedInput, getRawInput);
 					const handlerInput = result.input === parsedInput ? parsedInput : functionConfig.transformer.input.deserialize(result.input ?? parsedInput);
 					const output = await handler({
 						ctx: result.ctx,
@@ -1696,6 +1838,10 @@ var QueryProcedureBuilder = class QueryProcedureBuilder extends ProcedureBuilder
 	meta(value) {
 		return new QueryProcedureBuilder(this._meta(value));
 	}
+	/** Set a server-only procedure name for middleware/logging */
+	name(value) {
+		return new QueryProcedureBuilder(this._name(value));
+	}
 	/** Define input schema (chainable - schemas are merged) */
 	input(schema) {
 		return new QueryProcedureBuilder(this._input(schema));
@@ -1768,6 +1914,10 @@ var MutationProcedureBuilder = class MutationProcedureBuilder extends ProcedureB
 	meta(value) {
 		return new MutationProcedureBuilder(this._meta(value));
 	}
+	/** Set a server-only procedure name for middleware/logging */
+	name(value) {
+		return new MutationProcedureBuilder(this._name(value));
+	}
 	/** Define input schema (chainable - schemas are merged) */
 	input(schema) {
 		return new MutationProcedureBuilder(this._input(schema));
@@ -1807,6 +1957,10 @@ var ActionProcedureBuilder = class ActionProcedureBuilder extends ProcedureBuild
 	meta(value) {
 		return new ActionProcedureBuilder(this._meta(value));
 	}
+	/** Set a server-only procedure name for middleware/logging */
+	name(value) {
+		return new ActionProcedureBuilder(this._name(value));
+	}
 	/** Define input schema (chainable - schemas are merged) */
 	input(schema) {
 		return new ActionProcedureBuilder(this._input(schema));
@@ -1972,4 +2126,4 @@ const initCRPC = {
 };
 
 //#endregion
-export { zodOutputToConvexFields as A, convexToZodFields as C, zCustomQuery as D, zCustomMutation as E, zodToConvexFields as M, zid as O, convexToZod as S, zCustomAction as T, CRPC_ERROR_CODE_TO_HTTP as _, createMiddlewareFactory as a, isCRPCError as b, createHttpRouter as c, createHttpProcedureBuilder as d, extractPathParams as f, CRPC_ERROR_CODES_BY_KEY as g, CRPCError as h, QueryProcedureBuilder as i, zodToConvex as j, zodOutputToConvex as k, createHttpRouterFactory as l, matchPathParams as m, MutationProcedureBuilder as n, initCRPC as o, handleHttpError as p, ProcedureBuilder as r, HttpRouterWithHono as s, ActionProcedureBuilder as t, extractRouteMap as u, getCRPCErrorFromUnknown as v, withSystemFields as w, toCRPCError as x, getHTTPStatusCodeFromError as y };
+export { zid as A, toCRPCError as C, zCustomAction as D, withSystemFields as E, zodOutputToConvexFields as M, zodToConvex as N, zCustomMutation as O, zodToConvexFields as P, isCRPCError as S, convexToZodFields as T, CRPCError as _, createMiddlewareFactory as a, getCRPCErrorFromUnknown as b, registerProcedureNameLookup as c, createHttpRouterFactory as d, extractRouteMap as f, matchPathParams as g, handleHttpError as h, QueryProcedureBuilder as i, zodOutputToConvex as j, zCustomQuery as k, HttpRouterWithHono as l, extractPathParams as m, MutationProcedureBuilder as n, initCRPC as o, createHttpProcedureBuilder as p, ProcedureBuilder as r, inferProcedureNameFromCallsite as s, ActionProcedureBuilder as t, createHttpRouter as u, CRPC_ERROR_CODES_BY_KEY as v, convexToZod as w, getHTTPStatusCodeFromError as x, CRPC_ERROR_CODE_TO_HTTP as y };

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-CGjsBIOp.mjs";
+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-C0uwGXLx.mjs";
 import fs, { existsSync, readFileSync } from "node:fs";
 import path, { delimiter, dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/{context-utils-HPC5nXzx.d.ts → context-utils-BvWW0Ilq.d.ts}

@@ -5,13 +5,20 @@ type GenericCtx<DataModel extends GenericDataModel = GenericDataModel> = Generic
 type RunMutationCtx<DataModel extends GenericDataModel> = (GenericMutationCtx<DataModel> | GenericActionCtx<DataModel>) & {
   runMutation: GenericMutationCtx<DataModel>['runMutation'];
 };
+type SchedulerCtx<TCtx> = TCtx extends {
+  scheduler?: infer TScheduler;
+} ? TCtx & {
+  scheduler: NonNullable<TScheduler>;
+} : never;
 declare const isQueryCtx: <DataModel extends GenericDataModel>(ctx: GenericCtx<DataModel>) => ctx is GenericQueryCtx<DataModel>;
 declare const isMutationCtx: <DataModel extends GenericDataModel>(ctx: GenericCtx<DataModel>) => ctx is GenericMutationCtx<DataModel>;
 declare const isActionCtx: <DataModel extends GenericDataModel>(ctx: GenericCtx<DataModel>) => ctx is GenericActionCtx<DataModel>;
 declare const isRunMutationCtx: <DataModel extends GenericDataModel>(ctx: GenericCtx<DataModel>) => ctx is RunMutationCtx<DataModel>;
+declare const isSchedulerCtx: <TCtx extends object>(ctx: TCtx) => ctx is SchedulerCtx<TCtx>;
 declare const requireQueryCtx: <DataModel extends GenericDataModel>(ctx: GenericCtx<DataModel>) => GenericQueryCtx<DataModel>;
 declare const requireMutationCtx: <DataModel extends GenericDataModel>(ctx: GenericCtx<DataModel>) => GenericMutationCtx<DataModel>;
 declare const requireActionCtx: <DataModel extends GenericDataModel>(ctx: GenericCtx<DataModel>) => GenericActionCtx<DataModel>;
 declare const requireRunMutationCtx: <DataModel extends GenericDataModel>(ctx: GenericCtx<DataModel>) => RunMutationCtx<DataModel>;
+declare const requireSchedulerCtx: <TCtx extends object>(ctx: TCtx) => SchedulerCtx<TCtx>;
 //#endregion
-export { isQueryCtx as a, requireMutationCtx as c, isMutationCtx as i, requireQueryCtx as l, RunMutationCtx as n, isRunMutationCtx as o, isActionCtx as r, requireActionCtx as s, GenericCtx as t, requireRunMutationCtx as u };
+export { isMutationCtx as a, isSchedulerCtx as c, requireQueryCtx as d, requireRunMutationCtx as f, isActionCtx as i, requireActionCtx as l, RunMutationCtx as n, isQueryCtx as o, requireSchedulerCtx as p, SchedulerCtx as r, isRunMutationCtx as s, GenericCtx as t, requireMutationCtx as u };