kitcn 0.25.4 → 0.25.5

package/dist/aggregate/index.d.ts

@@ -1,5 +1,5 @@
 import { Bn as ConvexTextBuilderInitial, Xt as ConvexTableWithColumns } from "../capabilities-DtDfpdcH.js";
-import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial } from "../where-clause-compiler-CCMtAIdx.js";
+import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial } from "../where-clause-compiler-DlRUDuMx.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/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-DwYwySy3.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-B3ByVG3_.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-DJONf8X5.js";
 import { t as GetAuth } from "../types-Bf3XQex5.js";
 import { t as GenericCtx } from "../context-utils-DwZ3Cam1.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-DwYwySy3.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-B3ByVG3_.js";
 import * as convex_values0 from "convex/values";
 import { Infer } from "convex/values";
 import { AuthConfig, DocumentByName, GenericDataModel, GenericMutationCtx, GenericQueryCtx, GenericSchema, PaginationOptions, PaginationResult, SchemaDefinition, TableNamesInDataModel } from "convex/server";
@@ -123,7 +123,6 @@ declare const adapterWhereValidator: convex_values0.VObject<{
   value: convex_values0.VUnion<string | number | boolean | string[] | number[] | null, [convex_values0.VString<string, "required">, convex_values0.VFloat64<number, "required">, convex_values0.VBoolean<boolean, "required">, convex_values0.VArray<string[], convex_values0.VString<string, "required">, "required">, convex_values0.VArray<number[], convex_values0.VFloat64<number, "required">, "required">, convex_values0.VNull<null, "required">], "required", never>;
 }, "required", "mode" | "value" | "connector" | "field" | "operator">;
 declare const adapterArgsValidator: convex_values0.VObject<{
-  limit?: number | undefined;
   select?: string[] | undefined;
   where?: {
     mode?: "sensitive" | "insensitive" | undefined;
@@ -132,6 +131,7 @@ declare const adapterArgsValidator: convex_values0.VObject<{
     value: string | number | boolean | string[] | number[] | null;
     field: string;
   }[] | undefined;
+  limit?: number | undefined;
   offset?: number | undefined;
   sortBy?: {
     direction: "asc" | "desc";
@@ -169,7 +169,7 @@ declare const adapterArgsValidator: convex_values0.VObject<{
     operator: convex_values0.VUnion<"lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined, [convex_values0.VLiteral<"lt", "required">, convex_values0.VLiteral<"lte", "required">, convex_values0.VLiteral<"gt", "required">, convex_values0.VLiteral<"gte", "required">, convex_values0.VLiteral<"eq", "required">, convex_values0.VLiteral<"in", "required">, convex_values0.VLiteral<"not_in", "required">, convex_values0.VLiteral<"ne", "required">, convex_values0.VLiteral<"contains", "required">, convex_values0.VLiteral<"starts_with", "required">, convex_values0.VLiteral<"ends_with", "required">], "optional", never>;
     value: convex_values0.VUnion<string | number | boolean | string[] | number[] | null, [convex_values0.VString<string, "required">, convex_values0.VFloat64<number, "required">, convex_values0.VBoolean<boolean, "required">, convex_values0.VArray<string[], convex_values0.VString<string, "required">, "required">, convex_values0.VArray<number[], convex_values0.VFloat64<number, "required">, "required">, convex_values0.VNull<null, "required">], "required", never>;
   }, "required", "mode" | "value" | "connector" | "field" | "operator">, "optional">;
-}, "required", "limit" | "model" | "select" | "where" | "offset" | "sortBy" | "sortBy.direction" | "sortBy.field">;
+}, "required", "model" | "select" | "where" | "limit" | "offset" | "sortBy" | "sortBy.direction" | "sortBy.field">;
 declare const hasUniqueFields: (betterAuthSchema: BetterAuthDBSchema, model: string, input: Record<string, any>) => boolean;
 declare const checkUniqueFields: <Schema extends SchemaDefinition<any, any>>(ctx: GenericQueryCtx<GenericDataModel>, schema: Schema, betterAuthSchema: BetterAuthDBSchema, table: string, input: Record<string, any>, doc?: Record<string, any>) => Promise<void>;
 declare const selectFields: <T extends TableNamesInDataModel<GenericDataModel>, D extends DocumentByName<GenericDataModel, T>>(doc: D | null, select?: string[]) => D | null;

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { C as Columns, D as TableName, E as RlsPolicies, O as createSystemFields, S as getRankIndexes, T as OrmSchemaExtensions, _ as loadEsbuild, a as generateMeta, b as getAggregateIndexes, c as resolveSchemaDefaultExport, f as createProjectJiti, g as loadDotenv, h as loadClackPrompts, i as resolveConfiguredBackend, l as schemaDeclaresAggregateIndexes, m as loadBabelParser, n as withLocalCodegenEnv, o as getConvexConfig, p as CRPC_BUILDER_STUB_SOURCE, r as loadCliConfig, s as collectSchemaTables, t as getLocalBackendEnvVars, u as logger, v as highlighter, w as EnableRLS, x as getIndexes, y as isColorEnabled } from "./local-env-Dkh4a_BK.mjs";
+import { C as Columns, D as TableName, E as RlsPolicies, O as createSystemFields, S as getRankIndexes, T as OrmSchemaExtensions, _ as loadEsbuild, a as generateMeta, b as getAggregateIndexes, c as resolveSchemaDefaultExport, f as createProjectJiti, g as loadDotenv, h as loadClackPrompts, i as resolveConfiguredBackend, l as schemaDeclaresAggregateIndexes, m as loadBabelParser, n as withLocalCodegenEnv, o as getConvexConfig, p as CRPC_BUILDER_STUB_SOURCE, r as loadCliConfig, s as collectSchemaTables, t as getLocalBackendEnvVars, u as logger, v as highlighter, w as EnableRLS, x as getIndexes, y as isColorEnabled } from "./local-env-CiPqNKS_.mjs";
 import { createRequire } from "node:module";
 import fs, { existsSync, readFileSync } from "node:fs";
 import path, { basename, delimiter, dirname, extname, isAbsolute, join, posix, relative, resolve } from "node:path";

package/dist/{generated-contract-disabled-DwYwySy3.d.ts → generated-contract-disabled-B3ByVG3_.d.ts}

@@ -224,7 +224,6 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
     };
   }, Promise<Record<string, unknown> | undefined>>;
   findMany: convex_server0.RegisteredQuery<"internal", {
-    limit?: number | undefined;
     join?: any;
     where?: {
       mode?: "sensitive" | "insensitive" | undefined;
@@ -233,6 +232,7 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
       value: string | number | boolean | string[] | number[] | null;
       field: string;
     }[] | undefined;
+    limit?: number | undefined;
     offset?: number | undefined;
     sortBy?: {
       direction: "asc" | "desc";
@@ -270,16 +270,16 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
         value: string | number | boolean | string[] | number[] | null;
         field: string;
       }[] | undefined;
-      model: string;
       update: {
         [x: string]: unknown;
         [x: number]: unknown;
         [x: symbol]: unknown;
       };
+      model: string;
     } | {
       where?: any[] | undefined;
-      model: string;
       update: any;
+      model: string;
     };
     paginationOpts: {
       id?: number;
@@ -305,16 +305,16 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
         value: string | number | boolean | string[] | number[] | null;
         field: string;
       }[] | undefined;
-      model: string;
       update: {
         [x: string]: unknown;
         [x: number]: unknown;
         [x: symbol]: unknown;
       };
+      model: string;
     } | {
       where?: any[] | undefined;
-      model: string;
       update: any;
+      model: string;
     };
   }, Promise<any>>;
 };

package/dist/{local-env-Dkh4a_BK.mjs → local-env-CiPqNKS_.mjs}

@@ -473,8 +473,23 @@ export class CRPCError extends Error {
   }
 }
 
-export const createEnv = ({ schema }) => () =>
-  typeof schema?.parse === "function" ? schema.parse(process.env) : process.env;
+export const createEnv = ({ schema }) => () => {
+  if (typeof schema?.parse !== "function") return process.env;
+  if (globalThis.__KITCN_CODEGEN__ !== true || !schema.shape) {
+    return schema.parse(process.env);
+  }
+  const fallback = Object.fromEntries(
+    Object.entries(schema.shape).map(([key, zodType]) => {
+      const result = zodType?.safeParse?.(undefined);
+      if (result?.success) return [key, result.data];
+      if (Array.isArray(zodType?.options) && zodType.options.length > 0) {
+        return [key, zodType.options[0]];
+      }
+      return [key, ""];
+    })
+  );
+  return schema.parse({ ...fallback, ...process.env });
+};
 export const createHttpRouter = (_app, httpRouter) => httpRouter ?? {};
 export const createCallerFactory = () => () => ({});
 export const createApiLeaf = (fnOrRoot, pathOrMeta, maybeMeta) => {
@@ -2587,6 +2602,9 @@ const TS_EXTENSION_RE = /\.ts$/;
 /** Pattern to detect default exports in auth contract files. */
 const DEFAULT_EXPORT_RE = /\bexport\s+default\b/;
 const MISSING_KITCN_IMPORT_RE = /Cannot find (?:module|package) ['"]kitcn(?:\/[^'"]+)?['"]/;
+const LEGACY_PROCEDURE_LOOKUP_START_RE = /\bregisterProcedureNameLookup\s*\(\s*(\{)/;
+const LEGACY_PROCEDURE_FILE_RE = /("(?:\\.|[^"\\])*")\s*:\s*\[([\s\S]*?)\]\s*,?/g;
+const LEGACY_PROCEDURE_ENTRY_RE = /\{\s*column:\s*(\d+)\s*,\s*line:\s*(\d+)\s*,\s*name:\s*("(?:\\.|[^"\\])*")\s*\}/g;
 const RUNTIME_CALLER_RESERVED_EXPORTS = new Set(["actions", "schedule"]);
 const DEFAULT_TRIM_SEGMENTS = ["plugins", "generated"];
 const CODEGEN_SCOPES$1 = new Set([
@@ -2784,6 +2802,59 @@ function emitProcedureNameLookupLiteral(lookup) {
 		return `  ${JSON.stringify(file)}: [${items}],`;
 	}).join("\n")}\n}`;
 }
+function extractObjectLiteral(source, startIndex) {
+	let depth = 0;
+	let quote = null;
+	let escaped = false;
+	for (let index = startIndex; index < source.length; index += 1) {
+		const character = source[index];
+		if (quote) {
+			if (escaped) escaped = false;
+			else if (character === "\\") escaped = true;
+			else if (character === quote) quote = null;
+			continue;
+		}
+		if (character === "\"" || character === "'") quote = character;
+		else if (character === "{") depth += 1;
+		else if (character === "}") {
+			depth -= 1;
+			if (depth === 0) return source.slice(startIndex, index + 1);
+		}
+	}
+	return null;
+}
+function readLegacyProcedureNameLookup(serverOutputFile) {
+	if (!fs.existsSync(serverOutputFile)) return;
+	const source = fs.readFileSync(serverOutputFile, "utf8");
+	const startMatch = LEGACY_PROCEDURE_LOOKUP_START_RE.exec(source);
+	if (!startMatch || startMatch.index === void 0) return;
+	const literal = extractObjectLiteral(source, startMatch.index + startMatch[0].lastIndexOf("{"));
+	if (!literal) return;
+	if (literal.trim() === "{}") return {};
+	const lookup = {};
+	for (const fileMatch of literal.matchAll(LEGACY_PROCEDURE_FILE_RE)) {
+		const fileLiteral = fileMatch[1];
+		const entriesLiteral = fileMatch[2];
+		if (!fileLiteral || entriesLiteral === void 0) return;
+		const file = JSON.parse(fileLiteral);
+		if (typeof file !== "string") return;
+		const entries = [];
+		for (const entryMatch of entriesLiteral.matchAll(LEGACY_PROCEDURE_ENTRY_RE)) {
+			const nameLiteral = entryMatch[3];
+			if (!nameLiteral) return;
+			const name = JSON.parse(nameLiteral);
+			if (typeof name !== "string") return;
+			entries.push({
+				column: Number(entryMatch[1]),
+				line: Number(entryMatch[2]),
+				name
+			});
+		}
+		if (entries.length === 0) return;
+		lookup[file] = entries;
+	}
+	return Object.keys(lookup).length > 0 ? lookup : void 0;
+}
 function formatKey(key) {
 	return VALID_IDENTIFIER_RE.test(key) ? key : `'${key}'`;
 }
@@ -2877,6 +2948,20 @@ function getModuleImportPath(outputFile, functionsDir, moduleName) {
 	const moduleFile = path.join(functionsDir, moduleName);
 	return ensureRelativeImportPath(normalizeImportPath(path.relative(path.dirname(outputFile), moduleFile)));
 }
+/**
+* Convex's own generated server module. `convex codegen` writes it, and kitcn
+* codegen runs before it on a first bootstrap, so it can legitimately be
+* missing.
+*/
+function getConvexGeneratedServerFile(functionsDir) {
+	const base = path.join(functionsDir, "_generated", "server");
+	return [
+		".js",
+		".ts",
+		".mjs",
+		".cjs"
+	].map((extension) => `${base}${extension}`).find((candidate) => fs.existsSync(candidate));
+}
 function getRuntimeApiImportPath(outputFile, functionsDir) {
 	const runtimeApiFile = path.join(functionsDir, "_generated", "api.js");
 	return ensureRelativeImportPath(normalizeImportPath(path.relative(path.dirname(outputFile), runtimeApiFile)));
@@ -2931,6 +3016,17 @@ function getGeneratedAuthOutputFile(functionsDir) {
 function getGeneratedMigrationsHelperOutputFile(functionsDir) {
 	return path.join(functionsDir, GENERATED_DIR, "migrations.gen.ts");
 }
+/**
+* The only parse-derived input to `generated/server.ts`, split into its own
+* module so `server.ts` stays fully determined by pre-parse facts and can be
+* written before codegen evaluates the modules that import it.
+*
+* Two dots in the basename keep Convex's entry-point walker from deploying it
+* as a function module, matching `migrations.gen.ts`.
+*/
+function getGeneratedProcedureNamesOutputFile(functionsDir) {
+	return path.join(functionsDir, GENERATED_DIR, "procedure-names.gen.ts");
+}
 function getLegacyGeneratedOutputFile(functionsDir) {
 	return path.join(functionsDir, "generated.ts");
 }
@@ -2992,6 +3088,19 @@ export const getAuth = () => ({} as Record<string, unknown>);
 export const auth = {} as Record<string, unknown>;
 `;
 }
+/**
+* Pure data, zero imports: nothing here can throw while codegen evaluates the
+* project, and the value export survives tree-shaking even when the app sets
+* `"sideEffects": false` (a bare side-effect import would not).
+*/
+function emitGeneratedProcedureNamesFile(procedureNameLookup) {
+	return `// biome-ignore-all format: generated
+// This file is auto-generated by kitcn
+// Do not edit manually. Run \`kitcn codegen\` to regenerate.
+
+export const procedureNames = ${emitProcedureNameLookupLiteral(procedureNameLookup)};
+`;
+}
 function emitGeneratedMigrationsPlaceholderFile() {
 	return `// biome-ignore-all format: generated
 /* eslint-disable @typescript-eslint/no-require-imports, @typescript-eslint/no-unused-vars */
@@ -3010,16 +3119,25 @@ function writeFileIfChanged(filePath, content) {
 }
 function ensureGeneratedSupportPlaceholders(functionsDir, options) {
 	const createdPlaceholderFiles = [];
+	const replacedFiles = [];
 	const serverOutputFile = getGeneratedServerOutputFile(functionsDir);
 	const authOutputFile = getGeneratedAuthOutputFile(functionsDir);
 	const migrationsHelperOutputFile = getGeneratedMigrationsHelperOutputFile(functionsDir);
+	const procedureNamesOutputFile = getGeneratedProcedureNamesOutputFile(functionsDir);
 	const generatedDir = path.dirname(serverOutputFile);
 	fs.mkdirSync(generatedDir, { recursive: true });
 	const includeAuth = options?.includeAuth ?? true;
 	if (!fs.existsSync(serverOutputFile)) {
 		writeFileIfChanged(serverOutputFile, emitGeneratedServerPlaceholderFile(functionsDir));
 		createdPlaceholderFiles.push(serverOutputFile);
+	} else if (options?.replaceServer) {
+		const content = fs.readFileSync(serverOutputFile, "utf8");
+		if (writeFileIfChanged(serverOutputFile, emitGeneratedServerPlaceholderFile(functionsDir))) replacedFiles.push({
+			content,
+			filePath: serverOutputFile
+		});
 	}
+	if (!fs.existsSync(procedureNamesOutputFile)) writeFileIfChanged(procedureNamesOutputFile, emitGeneratedProcedureNamesFile(options?.procedureNameLookup ?? {}));
 	if (includeAuth && !fs.existsSync(authOutputFile)) {
 		writeFileIfChanged(authOutputFile, emitGeneratedAuthPlaceholderFile());
 		createdPlaceholderFiles.push(authOutputFile);
@@ -3028,7 +3146,22 @@ function ensureGeneratedSupportPlaceholders(functionsDir, options) {
 		writeFileIfChanged(migrationsHelperOutputFile, emitGeneratedMigrationsPlaceholderFile());
 		createdPlaceholderFiles.push(migrationsHelperOutputFile);
 	}
-	return createdPlaceholderFiles;
+	return {
+		createdFiles: createdPlaceholderFiles,
+		replacedFiles
+	};
+}
+async function withCodegenParseSentinel(callback) {
+	const globals = globalThis;
+	const hadSentinel = Object.hasOwn(globals, "__KITCN_CODEGEN__");
+	const previousSentinel = globals.__KITCN_CODEGEN__;
+	globals.__KITCN_CODEGEN__ = true;
+	try {
+		return await callback();
+	} finally {
+		if (hadSentinel) globals.__KITCN_CODEGEN__ = previousSentinel;
+		else delete globals.__KITCN_CODEGEN__;
+	}
 }
 function emitGeneratedRuntimePlaceholderFile(exportNames) {
 	const { callerExportName, handlerExportName } = exportNames;
@@ -3086,8 +3219,7 @@ async function resolveSchemaMetadataForCodegen(functionsDir, debug, createJitiIn
 			hasTriggers
 		};
 	} catch (error) {
-		if (debug) logger.warn(`⚠️  Failed to load schema extensions from ${schemaPath}: ${error.message}`);
-		return EMPTY_SCHEMA_METADATA;
+		throw new Error(`kitcn codegen could not load ${schemaPath}: ${error.message}`, { cause: error });
 	}
 }
 /**
@@ -3108,7 +3240,13 @@ function cleanupGeneratedPluginArtifacts(functionsDir) {
 		force: true
 	});
 }
-function emitGeneratedServerFile(outputFile, functionsDir, hasOrmSchema, hasAggregateIndexes, hasMigrationsManifest, procedureNameLookup) {
+/**
+* Every input here is known before codegen evaluates any project module, so
+* this file is written first and is authoritative: a stale copy on disk is
+* replaced before anything can import it. The parse-derived procedure-name
+* lookup lives in `procedure-names.gen.ts` to keep that true.
+*/
+function emitGeneratedServerFile(outputFile, functionsDir, hasOrmSchema, hasAggregateIndexes, hasMigrationsManifest) {
 	const asSingleQuotedImport = (importPath) => `'${importPath.replaceAll("'", "\\'")}'`;
 	const serverTypesImportPath = getServerTypesImportPath(outputFile, functionsDir);
 	const dataModelImportPath = getDataModelImportPath(outputFile, functionsDir);
@@ -3124,7 +3262,7 @@ function emitGeneratedServerFile(outputFile, functionsDir, hasOrmSchema, hasAggr
 	const capabilityEntries = [...hasAggregateIndexes ? ["aggregateCapability()"] : [], ...hasMigrationsManifest ? ["migrationCapability()"] : []];
 	const capabilitiesConfigLine = capabilityEntries.length > 0 ? `  capabilities: [${capabilityEntries.join(", ")}],\n` : "";
 	const functionsDirHint = normalizeImportPath(path.relative(process.cwd(), functionsDir)) || "convex";
-	const procedureNameLookupLiteral = emitProcedureNameLookupLiteral(procedureNameLookup);
+	const procedureNamesImportLiteral = asSingleQuotedImport(ensureRelativeImportPath(normalizeImportPath(path.relative(path.dirname(outputFile), getGeneratedProcedureNamesOutputFile(functionsDir))).replace(TS_EXTENSION_RE, "")));
 	if (!hasOrmSchema) return `// biome-ignore-all format: generated
 // This file is auto-generated by kitcn
 // Do not edit manually. Run \`kitcn codegen\` to regenerate.
@@ -3140,6 +3278,7 @@ import type {
   QueryCtx as ServerQueryCtx,
 } from ${serverTypesImportLiteral};
 import { httpAction, internalMutation } from ${serverTypesImportLiteral};
+import { procedureNames } from ${procedureNamesImportLiteral};
 
 export type QueryCtx = ServerQueryCtx;
 export type MutationCtx = ServerMutationCtx;
@@ -3147,10 +3286,7 @@ export type ActionCtx = ServerActionCtx;
 export type GenericCtx = QueryCtx | MutationCtx | ActionCtx;
 export type OrmCtx<Ctx = QueryCtx> = Ctx;
 
-registerProcedureNameLookup(
-  ${procedureNameLookupLiteral},
-  ${JSON.stringify(functionsDirHint)}
-);
+registerProcedureNameLookup(procedureNames, ${JSON.stringify(functionsDirHint)});
 
 export function withOrm<Ctx extends ServerQueryCtx | ServerMutationCtx>(ctx: Ctx): OrmCtx<Ctx> {
   return ctx as OrmCtx<Ctx>;
@@ -3187,6 +3323,7 @@ import type {
 } from ${serverTypesImportLiteral};
 import { httpAction, internalMutation } from ${serverTypesImportLiteral};
 import schema from ${schemaImportLiteral};
+import { procedureNames } from ${procedureNamesImportLiteral};
 ${migrationsImportLine}
 
 ${`const ormFunctions: OrmFunctions = {
@@ -3198,10 +3335,7 @@ ${`const ormFunctions: OrmFunctions = {
 };`}
 const ormSchema = schema;
 
-registerProcedureNameLookup(
-  ${procedureNameLookupLiteral},
-  ${JSON.stringify(functionsDirHint)}
-);
+registerProcedureNameLookup(procedureNames, ${JSON.stringify(functionsDirHint)});
 
 export const orm = createOrm({
   schema: ormSchema,
@@ -3745,6 +3879,7 @@ async function generateMeta(sharedDir, options) {
 	const crpcOutputFile = getGeneratedCrpcOutputFile(functionsDir);
 	const authOutputFile = getGeneratedAuthOutputFile(functionsDir);
 	const migrationsHelperOutputFile = getGeneratedMigrationsHelperOutputFile(functionsDir);
+	const procedureNamesOutputFile = getGeneratedProcedureNamesOutputFile(functionsDir);
 	const legacyGeneratedMigrationsOutputFile = path.join(functionsDir, GENERATED_DIR, "migrations.ts");
 	const legacyGeneratedMigrationsRuntimeOutputFile = path.join(functionsDir, GENERATED_DIR, "migrations.runtime.ts");
 	const legacyGeneratedMigrationsUnderscoreOutputFile = path.join(functionsDir, GENERATED_DIR, "_migrations.ts");
@@ -3761,7 +3896,10 @@ async function generateMeta(sharedDir, options) {
 	const procedureNameLookup = {};
 	const fatalParseFailures = [];
 	let createdRuntimePlaceholders = [];
-	let createdSupportPlaceholders = [];
+	let supportPlaceholderState = {
+		createdFiles: [],
+		replacedFiles: []
+	};
 	const runtimeFilesPreservedFromParseFailures = /* @__PURE__ */ new Set();
 	let totalFunctions = 0;
 	const authFilePath = path.join(functionsDir, "auth.ts");
@@ -3773,7 +3911,7 @@ async function generateMeta(sharedDir, options) {
 	};
 	let sharedJitiInstance;
 	const getSharedJitiInstance = () => sharedJitiInstance ??= createProjectJiti();
-	const schemaMetadata = await resolveSchemaMetadataForCodegen(functionsDir, debug, getSharedJitiInstance);
+	const schemaMetadata = await withCodegenParseSentinel(() => resolveSchemaMetadataForCodegen(functionsDir, debug, getSharedJitiInstance));
 	const hasOrmSchemaMetadata = schemaMetadata.hasOrmSchema;
 	const hasRelationsMetadata = schemaMetadata.hasRelations;
 	const hasRelationsExport = hasNamedExport(path.join(functionsDir, "schema.ts"), "relations");
@@ -3783,7 +3921,14 @@ async function generateMeta(sharedDir, options) {
 	if (hasRelationsExport) throw new Error("Codegen error: do not export `relations` from schema.ts. Chain relations on the default schema export with `defineSchema(...).relations(...)`.");
 	if (hasSchemaTriggersExport || hasDedicatedTriggersExport) throw new Error("Codegen error: do not export `triggers` from schema.ts or triggers.ts. Chain triggers on the default schema export with `defineSchema(...).relations(...).triggers(...)`.");
 	const hasOrmSchema = hasOrmSchemaMetadata;
-	createdSupportPlaceholders = ensureGeneratedSupportPlaceholders(functionsDir, { includeAuth: generateAuth });
+	const convexGeneratedServerFile = getConvexGeneratedServerFile(functionsDir);
+	supportPlaceholderState = ensureGeneratedSupportPlaceholders(functionsDir, {
+		includeAuth: generateAuth,
+		procedureNameLookup: fs.existsSync(procedureNamesOutputFile) ? void 0 : readLegacyProcedureNameLookup(serverOutputFile),
+		replaceServer: convexGeneratedServerFile === void 0
+	});
+	const emitServerFile = () => writeFileIfChanged(serverOutputFile, emitGeneratedServerFile(serverOutputFile, functionsDir, hasOrmSchema, schemaMetadata.hasAggregateIndexes, hasMigrationsManifest));
+	if (convexGeneratedServerFile) emitServerFile();
 	if (generateApi) {
 		globalThis.__KITCN_CODEGEN__ = true;
 		try {
@@ -3844,7 +3989,8 @@ async function generateMeta(sharedDir, options) {
 	}
 	if (fatalParseFailures.length > 0) {
 		for (const createdRuntimePlaceholder of createdRuntimePlaceholders) fs.rmSync(createdRuntimePlaceholder, { force: true });
-		for (const createdSupportPlaceholder of createdSupportPlaceholders) fs.rmSync(createdSupportPlaceholder, { force: true });
+		for (const createdSupportPlaceholder of supportPlaceholderState.createdFiles) fs.rmSync(createdSupportPlaceholder, { force: true });
+		for (const replacedSupportFile of supportPlaceholderState.replacedFiles) fs.writeFileSync(replacedSupportFile.filePath, replacedSupportFile.content, "utf8");
 		const failureSummary = fatalParseFailures.map(({ file, error }) => `- ${file}: ${error instanceof Error ? error.message : String(error)}`).join("\n");
 		throw new Error(`kitcn codegen aborted because module parsing failed:\n${failureSummary}`);
 	}
@@ -3906,10 +4052,10 @@ ${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, schemaMetadata.hasAggregateIndexes, hasMigrationsManifest, procedureNameLookup);
 	const generatedOutputDirname = path.dirname(serverOutputFile);
 	if (!fs.existsSync(generatedOutputDirname)) fs.mkdirSync(generatedOutputDirname, { recursive: true });
-	writeFileIfChanged(serverOutputFile, serverOutput);
+	emitServerFile();
+	if (generateApi) writeFileIfChanged(procedureNamesOutputFile, emitGeneratedProcedureNamesFile(procedureNameLookup));
 	if (hasOrmSchema) writeFileIfChanged(aggregateOutputFile, emitGeneratedAggregateFile(aggregateOutputFile, functionsDir));
 	else fs.rmSync(aggregateOutputFile, { force: true });
 	fs.rmSync(ormOutputFile, { force: true });

package/dist/orm/index.d.ts

@@ -1,5 +1,5 @@
 import { $n as BinaryExpression, $t as OrmLifecycleOperation, A as DatabaseWithMutations, An as ConvexCheckConfig, Ar as AnyColumn, At as VectorQueryConfig, B as RlsContext, Bn as ConvexTextBuilderInitial, Br as IsUnique, Bt as RelationsBuilderColumnConfig, C as MigrationTableName, Cn as aggregateIndex, Cr as notBetween, Ct as OrderDirection, D as defineMigrationSet, Dn as uniqueIndex, Dt as ReturningResult, E as defineMigration, En as searchIndex, Er as startsWith, Et as ReturningAll, Fn as ConvexUniqueConstraintConfig, Fr as ColumnBuilderWithTableName, Ft as ExtractTablesWithRelations, Gt as defineRelations, H as EdgeMetadata, In as check, Ir as ColumnDataType, It as ManyConfig, Jt as ConvexDeletionConfig, Kt as defineRelationsPart, Ln as foreignKey, Lr as DrizzleEntity, Lt as OneConfig, M as OrmReader$1, Mn as ConvexForeignKeyConfig, Mr as ColumnBuilderBaseConfig, Mt as unsetToken, N as OrmWriter$1, Nn as ConvexUniqueConstraintBuilder, Nr as ColumnBuilderRuntimeConfig, O as detectMigrationDrift, On as vectorIndex, Or as SystemFields, Ot as ReturningSelection, Pn as ConvexUniqueConstraintBuilderOn, Pr as ColumnBuilderTypeConfig, Pt as ExtractTablesFromSchema, Qn as TableName, Qt as OrmLifecycleChange, Rn as unique, Rr as HasDefault, Rt as RelationsBuilder, S as MigrationStep, Sn as ConvexVectorIndexConfig, Sr as not, St as OrderByClause, T as buildMigrationPlan, Tn as rankIndex, Tr as or, Tt as PredicateWhereIndexConfig, U as extractRelationsConfig, Un as Brand, Ut as TableRelationalConfig, V as RlsMode, Vn as text, Vr as NotNull, Wn as Columns, Wt as TablesRelationalConfig, Xn as OrmSchemaRelations, Xt as ConvexTableWithColumns, Yn as OrmSchemaExtensions, Yt as ConvexTable, Zn as OrmSchemaTriggers, Zt as DiscriminatorBuilderConfig, _ as MigrationMigrateOne, _n as ConvexSearchIndexBuilder, _r as isNull, _t as MutationPaginateConfig, an as RlsPolicyConfig, ar as and, at as CountConfig, b as MigrationSet, bn as ConvexVectorIndexBuilder, br as lte, bt as MutationReturning, cn as RlsRole, cr as endsWith, ct as FilterOperators, d as MigrationDefinition, dn as ConvexAggregateIndexBuilder, dr as gt, dt as InferModelFromColumns, en as TableConfig, er as ExpressionVisitor, et as AggregateConfig, f as MigrationDirection, fn as ConvexAggregateIndexBuilderOn, fr as gte, ft as InferSelectModel, g as MigrationManifestEntry, gn as ConvexRankIndexBuilderOn, gr as isNotNull, gt as MutationExecutionMode, h as MigrationDriftIssue, hn as ConvexRankIndexBuilder, hr as isFieldReference, ht as MutationExecuteResult, i as OrmMigrationCapability, in as RlsPolicy, ir as UnaryExpression, it as BuildRelationResult, j as DatabaseWithQuery, jn as ConvexForeignKeyBuilder, jr as ColumnBuilder, jt as VectorSearchProvider, kn as ConvexCheckBuilder, kt as UpdateSet, ln as RlsRoleConfig, lr as eq, lt as GetColumnData, m as MigrationDocContext, mn as ConvexIndexBuilderOn, mr as inArray, mt as MutationExecuteConfig, n as OrmCapabilities, nn as deletion, nr as FilterExpression, nt as AggregateResult, on as RlsPolicyToOption, or as between, ot as CountResult, p as MigrationDoc, pn as ConvexIndexBuilder, pr as ilike, pt as InsertValue, qn as OrmSchemaExtensionTables, qt as ConvexDeletionBuilder, r as OrmCapability, rn as discriminator, rr as LogicalExpression, rt as BuildQueryResult, sn as rlsPolicy, sr as contains, st as DBQueryConfig, t as OrmAggregateCapability, tn as convexTable, tr as FieldReference, tt as AggregateFieldValue, u as MigrationAppliedState, un as rlsRole, ur as fieldRef, ut as InferInsertModel, v as MigrationPlan, vn as ConvexSearchIndexBuilderOn, vr as like, vt as MutationPaginatedResult, w as MigrationWriteMode, wn as index, wr as notInArray, wt as PaginatedResult, x as MigrationStateMap, xn as ConvexVectorIndexBuilderOn, xr as ne, xt as MutationRunMode, y as MigrationRunStatus, yn as ConvexSearchIndexConfig, yr as lt, yt as MutationResult, zn as ConvexTextBuilder, zr as IsPrimaryKey, zt as RelationsBuilderColumnBase } from "../capabilities-DtDfpdcH.js";
-import { $ as OrmClientWithApi$1, A as ConvexDateMode, B as ConvexBytesBuilderInitial, C as ConvexNumberBuilderInitial, D as id, E as ConvexIdBuilderInitial, F as custom, G as ConvexBigIntBuilder, H as ConvexBooleanBuilder, I as json, J as CreateOrmOptions, K as ConvexBigIntBuilderInitial, L as objectOf, M as ConvexCustomBuilder, N as ConvexCustomBuilderInitial, O as ConvexDateBuilder, P as arrayOf, Q as OrmClientBase$1, R as unionOf, S as ConvexNumberBuilder, St as defineTriggers, T as ConvexIdBuilder, U as ConvexBooleanBuilderInitial, V as bytes, W as boolean, X as GenericOrmCtx$1, Y as GenericOrm$1, Z as OrmApiResult, _ as ConvexTimestampMode, _t as OrmBeforeResult, a as requireSchemaRelations, at as ScheduledMutationBatchArgs, b as ConvexTextEnumBuilderInitial, bt as OrmTriggerContext, c as TableConfigResult, ct as scheduledDeleteFactory, d as OrmNotFoundError, et as OrmFunctions, f as ConvexVectorBuilder, g as ConvexTimestampBuilderInitial, gt as defineSchemaExtension, h as ConvexTimestampBuilder, ht as SchemaExtension, i as getSchemaTriggers, it as createOrm, j as date, k as ConvexDateBuilderInitial, l as getTableColumns, m as vector, n as defineSchema, nt as OrmWriterCtx, o as asc, ot as scheduledMutationBatchFactory, p as ConvexVectorBuilderInitial, q as bigint, r as getSchemaRelations, rt as ResolveOrmSchema, s as desc, st as ScheduledDeleteArgs, t as WhereClauseResult, tt as OrmReaderCtx, u as getTableConfig, v as timestamp, vt as OrmTableTriggers, w as integer, x as textEnum, xt as OrmTriggers, y as ConvexTextEnumBuilder, yt as OrmTriggerChange, z as ConvexBytesBuilder } from "../where-clause-compiler-CCMtAIdx.js";
+import { $ as OrmClientWithApi$1, A as ConvexDateMode, B as ConvexBytesBuilderInitial, C as ConvexNumberBuilderInitial, D as id, E as ConvexIdBuilderInitial, F as custom, G as ConvexBigIntBuilder, H as ConvexBooleanBuilder, I as json, J as CreateOrmOptions, K as ConvexBigIntBuilderInitial, L as objectOf, M as ConvexCustomBuilder, N as ConvexCustomBuilderInitial, O as ConvexDateBuilder, P as arrayOf, Q as OrmClientBase$1, R as unionOf, S as ConvexNumberBuilder, St as defineTriggers, T as ConvexIdBuilder, U as ConvexBooleanBuilderInitial, V as bytes, W as boolean, X as GenericOrmCtx$1, Y as GenericOrm$1, Z as OrmApiResult, _ as ConvexTimestampMode, _t as OrmBeforeResult, a as requireSchemaRelations, at as ScheduledMutationBatchArgs, b as ConvexTextEnumBuilderInitial, bt as OrmTriggerContext, c as TableConfigResult, ct as scheduledDeleteFactory, d as OrmNotFoundError, et as OrmFunctions, f as ConvexVectorBuilder, g as ConvexTimestampBuilderInitial, gt as defineSchemaExtension, h as ConvexTimestampBuilder, ht as SchemaExtension, i as getSchemaTriggers, it as createOrm, j as date, k as ConvexDateBuilderInitial, l as getTableColumns, m as vector, n as defineSchema, nt as OrmWriterCtx, o as asc, ot as scheduledMutationBatchFactory, p as ConvexVectorBuilderInitial, q as bigint, r as getSchemaRelations, rt as ResolveOrmSchema, s as desc, st as ScheduledDeleteArgs, t as WhereClauseResult, tt as OrmReaderCtx, u as getTableConfig, v as timestamp, vt as OrmTableTriggers, w as integer, x as textEnum, xt as OrmTriggers, y as ConvexTextEnumBuilder, yt as OrmTriggerChange, z as ConvexBytesBuilder } from "../where-clause-compiler-DlRUDuMx.js";
 import { i as pretendRequired, n as deprecated, r as pretend } from "../validators-wOIjhkfN.js";
 import { a as QueryCtxWithPreferredOrmQueryTable, i as QueryCtxWithOrmQueryTable, n as LookupByIdResultByCtx, o as getByIdWithOrmQueryFallback, r as QueryCtxWithOptionalOrmQueryTable, t as DocByCtx } from "../query-context-DJONf8X5.js";
 import { DefineSchemaOptions, GenericDatabaseReader, GenericDatabaseWriter, GenericSchema, SchemaDefinition } from "convex/server";

package/dist/orm/index.js

@@ -277,7 +277,7 @@ const resolveOrmCapabilities = (capabilities) => {
 	}
 	return resolved;
 };
-const AGGREGATE_SETUP_HINT = "Generated ORM: declare an aggregateIndex(...)/rankIndex(...) in your schema and rerun `kitcn codegen`, which registers the capability in <functionsDir>/generated/server.ts. Hand-written ORM: import { aggregateCapability } from 'kitcn/orm/aggregate-index' and pass createOrm({ schema, capabilities: [aggregateCapability()] }).";
+const AGGREGATE_SETUP_HINT = "Generated ORM: `kitcn codegen` registers the capability in <functionsDir>/generated/server.ts from the aggregateIndex(...)/rankIndex(...) declarations in your schema — if you are seeing this from that generated file, delete it and run `kitcn codegen` again. Hand-written ORM: import { aggregateCapability } from 'kitcn/orm/aggregate-index' and pass createOrm({ schema, capabilities: [aggregateCapability()] }).";
 const missingAggregateCapabilityError = (usage) => /* @__PURE__ */ new Error(`${usage} requires the aggregate capability. ${AGGREGATE_SETUP_HINT}`);
 const requireAggregateCapability = (capabilities, usage) => {
 	const aggregate = capabilities?.aggregate;
@@ -286,7 +286,7 @@ const requireAggregateCapability = (capabilities, usage) => {
 };
 const requireMigrationCapability = (capabilities, usage) => {
 	const migrations = capabilities?.migrations;
-	if (!migrations) throw new Error(`${usage} requires the migration capability. Generated ORM: add a migration under <functionsDir>/migrations and rerun \`kitcn codegen\`, which registers the capability in <functionsDir>/generated/server.ts. Hand-written ORM: import { migrationCapability } from 'kitcn/orm/migrations' and pass createOrm({ schema, capabilities: [migrationCapability()] }).`);
+	if (!migrations) throw new Error(`${usage} requires the migration capability. Generated ORM: \`kitcn codegen\` registers the capability in <functionsDir>/generated/server.ts once <functionsDir>/migrations/manifest.ts exists — if you are seeing this from that generated file, delete it and run \`kitcn codegen\` again. Hand-written ORM: import { migrationCapability } from 'kitcn/orm/migrations' and pass createOrm({ schema, capabilities: [migrationCapability()] }).`);
 	return migrations;
 };
 

package/dist/orm/migrations/index.d.ts

@@ -1,3 +1,3 @@
 import { C as MigrationTableName, D as defineMigrationSet, E as defineMigration, O as detectMigrationDrift, S as MigrationStep, T as buildMigrationPlan, _ as MigrationMigrateOne, a as MigrationCancelArgs, b as MigrationSet, c as MigrationStatusArgs, d as MigrationDefinition, f as MigrationDirection, g as MigrationManifestEntry, h as MigrationDriftIssue, l as createMigrationHandlers, m as MigrationDocContext, o as MigrationRunArgs, p as MigrationDoc, s as MigrationRunChunkArgs, u as MigrationAppliedState, v as MigrationPlan, w as MigrationWriteMode, x as MigrationStateMap, y as MigrationRunStatus } from "../../capabilities-DtDfpdcH.js";
-import { Ct as migrationCapability, dt as MIGRATION_STORAGE_TABLE_NAMES, ft as injectMigrationStorageTables, lt as MIGRATION_RUN_TABLE, mt as migrationStorageTables, pt as migrationExtension, ut as MIGRATION_STATE_TABLE } from "../../where-clause-compiler-CCMtAIdx.js";
+import { Ct as migrationCapability, dt as MIGRATION_STORAGE_TABLE_NAMES, ft as injectMigrationStorageTables, lt as MIGRATION_RUN_TABLE, mt as migrationStorageTables, pt as migrationExtension, ut as MIGRATION_STATE_TABLE } from "../../where-clause-compiler-DlRUDuMx.js";
 export { MIGRATION_RUN_TABLE, MIGRATION_STATE_TABLE, MIGRATION_STORAGE_TABLE_NAMES, type MigrationAppliedState, type MigrationCancelArgs, type MigrationDefinition, type MigrationDirection, type MigrationDoc, type MigrationDocContext, type MigrationDriftIssue, type MigrationManifestEntry, type MigrationMigrateOne, type MigrationPlan, type MigrationRunArgs, type MigrationRunChunkArgs, type MigrationRunStatus, type MigrationSet, type MigrationStateMap, type MigrationStatusArgs, type MigrationStep, type MigrationTableName, type MigrationWriteMode, buildMigrationPlan, createMigrationHandlers, defineMigration, defineMigrationSet, detectMigrationDrift, injectMigrationStorageTables, migrationCapability, migrationExtension, migrationStorageTables };

package/dist/watcher.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as generateMeta, d as PARSE_SNAPSHOT_SUFFIX, i as resolveConfiguredBackend, n as withLocalCodegenEnv, o as getConvexConfig, r as loadCliConfig, u as logger } from "./local-env-Dkh4a_BK.mjs";
+import { a as generateMeta, d as PARSE_SNAPSHOT_SUFFIX, i as resolveConfiguredBackend, n as withLocalCodegenEnv, o as getConvexConfig, r as loadCliConfig, u as logger } from "./local-env-CiPqNKS_.mjs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 

package/dist/{where-clause-compiler-CCMtAIdx.d.ts → where-clause-compiler-DlRUDuMx.d.ts}

@@ -102,15 +102,6 @@ declare const migrationStorageTables: {
           fieldName: "status";
         };
       };
-      cursor: ConvexTextBuilderInitial<""> & {
-        _: {
-          tableName: "migration_state";
-        };
-      } & {
-        _: {
-          fieldName: "cursor";
-        };
-      };
       migrationId: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
@@ -168,6 +159,15 @@ declare const migrationStorageTables: {
           fieldName: "runId";
         };
       };
+      cursor: ConvexTextBuilderInitial<""> & {
+        _: {
+          tableName: "migration_state";
+        };
+      } & {
+        _: {
+          fieldName: "cursor";
+        };
+      };
       processed: ConvexNumberBuilderInitial<""> & {
         _: {
           notNull: true;
@@ -1008,7 +1008,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
   readonly aggregate_bucket: ConvexTableWithColumns<{
     name: "aggregate_bucket";
     columns: {
-      count: ConvexNumberBuilderInitial<""> & {
+      updatedAt: ConvexNumberBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1018,10 +1018,10 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "count";
+          fieldName: "updatedAt";
         };
       };
-      updatedAt: ConvexNumberBuilderInitial<""> & {
+      indexName: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1031,10 +1031,10 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "updatedAt";
+          fieldName: "indexName";
         };
       };
-      indexName: ConvexTextBuilderInitial<""> & {
+      tableKey: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1044,10 +1044,10 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "indexName";
+          fieldName: "tableKey";
         };
       };
-      tableKey: ConvexTextBuilderInitial<""> & {
+      count: ConvexNumberBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1057,7 +1057,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "tableKey";
+          fieldName: "count";
         };
       };
       keyHash: ConvexTextBuilderInitial<""> & {
@@ -1323,7 +1323,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
   readonly aggregate_extrema: ConvexTableWithColumns<{
     name: "aggregate_extrema";
     columns: {
-      count: ConvexNumberBuilderInitial<""> & {
+      updatedAt: ConvexNumberBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1333,10 +1333,10 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "count";
+          fieldName: "updatedAt";
         };
       };
-      updatedAt: ConvexNumberBuilderInitial<""> & {
+      indexName: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1346,14 +1346,10 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "updatedAt";
+          fieldName: "indexName";
         };
       };
-      value: ConvexCustomBuilderInitial<"", convex_values0.VAny<any, "required", string>> & {
-        _: {
-          $type: convex_values0.Value;
-        };
-      } & {
+      tableKey: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1363,10 +1359,14 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "value";
+          fieldName: "tableKey";
         };
       };
-      indexName: ConvexTextBuilderInitial<""> & {
+      value: ConvexCustomBuilderInitial<"", convex_values0.VAny<any, "required", string>> & {
+        _: {
+          $type: convex_values0.Value;
+        };
+      } & {
         _: {
           notNull: true;
         };
@@ -1376,10 +1376,10 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "indexName";
+          fieldName: "value";
         };
       };
-      tableKey: ConvexTextBuilderInitial<""> & {
+      count: ConvexNumberBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1389,7 +1389,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "tableKey";
+          fieldName: "count";
         };
       };
       keyHash: ConvexTextBuilderInitial<""> & {
@@ -1744,15 +1744,6 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
           fieldName: "status";
         };
       };
-      cursor: ConvexTextBuilderInitial<""> & {
-        _: {
-          tableName: "migration_state";
-        };
-      } & {
-        _: {
-          fieldName: "cursor";
-        };
-      };
       migrationId: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
@@ -1810,6 +1801,15 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
           fieldName: "runId";
         };
       };
+      cursor: ConvexTextBuilderInitial<""> & {
+        _: {
+          tableName: "migration_state";
+        };
+      } & {
+        _: {
+          fieldName: "cursor";
+        };
+      };
       processed: ConvexNumberBuilderInitial<""> & {
         _: {
           notNull: true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitcn",
-  "version": "0.25.4",
+  "version": "0.25.5",
   "description": "kitcn - React Query integration and CLI tools for Convex",
   "keywords": [
     "convex",

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

@@ -141,6 +141,7 @@ bunx kitcn add resend
 - `convex/functions/schema.ts`
 - `convex/functions/http.ts`
 - `convex/functions/generated/server.ts`
+- `convex/functions/generated/procedure-names.gen.ts`
 - `convex/lib/crpc.ts`
 - `convex/lib/get-env.ts`
 - `convex/shared/api.ts`

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

@@ -218,6 +218,15 @@ This generates:
 - `convex/functions/generated/` directory
 - `convex/shared/api.ts`
 
+Everything under `convex/functions/generated/` is codegen-owned. Never edit it,
+and never hand-repair it. `convex/functions/generated/server.ts` is rewritten
+from the schema before codegen reads any app module.
+
+`convex/functions/generated/procedure-names.gen.ts` holds the procedure-name
+lookup. It is the only generated output that depends on scanning procedures, so
+only default-scope runs rebuild it; `kitcn codegen --scope auth|orm` preserves
+the recorded lookup.
+
 Agent command policy:
 
 1. Default to `bunx kitcn dev`.