kitcn 0.25.3 → 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-Bke7ULoY.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-SzH57bhp.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-SzH57bhp.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";

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-SzH57bhp.d.ts → generated-contract-disabled-B3ByVG3_.d.ts}

@@ -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/aggregate-index/index.js

@@ -1,6 +1,6 @@
 import { t as DirectAggregate } from "../../runtime-BdqTbgKh.js";
 import { a as Columns } from "../../table-CX2lnX7e.js";
-import { Y as normalizeTemporalComparableValue, _t as PUBLIC_CREATED_AT_FIELD, c as AGGREGATE_ERROR, f as createError, gt as INTERNAL_CREATION_TIME_FIELD, i as AGGREGATE_STATE_TABLE, l as COUNT_ERROR, n as AGGREGATE_EXTREMA_TABLE, o as getAggregateIndexDefinitions, ot as mapWithConcurrency, r as AGGREGATE_MEMBER_TABLE, s as getRankIndexDefinitions, t as AGGREGATE_BUCKET_TABLE, vt as usesSystemCreatedAtAlias } from "../../schema-D8sVYuYO.js";
+import { Y as normalizeTemporalComparableValue, bt as PUBLIC_CREATED_AT_FIELD, c as AGGREGATE_ERROR, f as createError, i as AGGREGATE_STATE_TABLE, l as COUNT_ERROR, lt as mapWithConcurrency, n as AGGREGATE_EXTREMA_TABLE, o as getAggregateIndexDefinitions, r as AGGREGATE_MEMBER_TABLE, s as getRankIndexDefinitions, t as AGGREGATE_BUCKET_TABLE, xt as usesSystemCreatedAtAlias, yt as INTERNAL_CREATION_TIME_FIELD } from "../../schema-e0wbZ_Ax.js";
 
 //#region src/orm/aggregate-index/runtime.ts
 const UNDEFINED_SENTINEL = "__kitcnUndefined";

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-Bke7ULoY.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

@@ -4,7 +4,7 @@ import { a as pretendRequired, i as pretend, n as deprecated } from "../validato
 import { t as id } from "../id-CuSfWa5q.js";
 import { A as or, C as matchLikePattern, D as notIlike, E as notBetween, O as notInArray, S as lte, T as not, _ as isFieldReference, a as between, b as like, c as endsWith, d as filterValueInList, f as filterValuesEqual, g as inArray, h as ilike, i as arrayOverlaps, j as startsWith, k as notLike, l as eq, m as gte, n as arrayContained, o as column, p as gt, r as arrayContains, s as contains, t as and, u as fieldRef, v as isNotNull, w as ne, x as lt, y as isNull } from "../filter-expression-Dydt8wS0.js";
 import { a as indexKeyWithinBounds, c as streamIndexRange, i as getIndexFields, l as isUnsetToken, n as EmptyStream, o as mergedStream, r as QueryStream, s as stream, t as getByIdWithOrmQueryFallback, u as unsetToken } from "../query-context-DOm5Xm3H.js";
-import { $ as serializeFilterExpression, A as ensureNonNullValues, B as getMutationExecutionMode, C as deserializeFilterExpression, D as enforcePolymorphicWrite, E as enforceForeignKeys, F as getChecks, G as getUniqueIndexes, H as getTableColumns$2, I as getColumnName$1, J as normalizeDateFieldsForWrite, K as hardDeleteRow, L as getForeignKeys, M as evaluateCheckConstraintTriState, N as evaluateFilter, O as enforceUniqueIndexes, P as extractPrimaryIdLookup, Q as selectReturningRowWithHydration, R as getMutationAsyncDelayMs, S as decodeUndefinedDeep, T as enforceCheckConstraints, U as getTableDeleteConfig, V as getOrmContext, W as getTableName, X as patchReferencingRows, Y as normalizeTemporalComparableValue, Z as resolveOrmRuntimeDefaults, _ as applyIncomingForeignKeyActionsOnUpdate, _t as PUBLIC_CREATED_AT_FIELD, a as aggregateExtension, at as markLifecycleHookedTables, b as collectMutationRowsBounded, c as AGGREGATE_ERROR, ct as findRelationIndex, d as createCountError, dt as getAggregateIndexes, et as softDeleteRow, ft as getIndexes, g as applyIncomingForeignKeyActionsOnDelete, gt as INTERNAL_CREATION_TIME_FIELD, h as applyDefaults, ht as CREATED_AT_MIGRATION_MESSAGE, it as hasLifecycleHooks, j as ensureNullableColumns, k as ensureDefaultColumns, l as COUNT_ERROR, lt as findSearchIndexByName, m as ensureCountAllowedForRls, mt as resolveIndexOrderPushdown, nt as takeRowsWithinByteBudget, o as getAggregateIndexDefinitions, ot as mapWithConcurrency, p as ensureAggregateAllowedForRls, pt as getRankIndexes, q as hydrateDateFieldsForRead, rt as toConvexFilter, s as getRankIndexDefinitions, st as findIndexForColumns, tt as splitReturningSelection, u as createAggregateError, ut as findVectorIndexByName, v as buildForeignKeyGraph, vt as usesSystemCreatedAtAlias, w as encodeUndefinedDeep, x as collectPrimaryIdLookupRows, y as canUsePrimaryIdLookupCursor, z as getMutationCollectionLimits } from "../schema-D8sVYuYO.js";
+import { $ as serializeFilterExpression, A as ensureNonNullValues, B as getMutationExecutionMode, C as deserializeFilterExpression, D as enforcePolymorphicWrite, E as enforceForeignKeys, F as getChecks, G as getUniqueIndexes, H as getTableColumns$2, I as getColumnName$1, J as normalizeDateFieldsForWrite, K as hardDeleteRow, L as getForeignKeys, M as evaluateCheckConstraintTriState, N as evaluateFilter, O as enforceUniqueIndexes, P as extractPrimaryIdLookup, Q as selectReturningRowWithHydration, R as getMutationAsyncDelayMs, S as decodeUndefinedDeep, T as enforceCheckConstraints, U as getTableDeleteConfig, V as getOrmContext, W as getTableName, X as patchReferencingRows, Y as normalizeTemporalComparableValue, Z as resolveOrmRuntimeDefaults, _ as applyIncomingForeignKeyActionsOnUpdate, _t as resolveIndexOrderPushdown, a as aggregateExtension, at as markLifecycleHookedTables, b as collectMutationRowsBounded, bt as PUBLIC_CREATED_AT_FIELD, c as AGGREGATE_ERROR, ct as isConvexEnforceableFilter, d as createCountError, dt as findRelationIndex, et as softDeleteRow, ft as findSearchIndexByName, g as applyIncomingForeignKeyActionsOnDelete, gt as getRankIndexes, h as applyDefaults, ht as getIndexes, it as hasLifecycleHooks, j as ensureNullableColumns, k as ensureDefaultColumns, l as COUNT_ERROR, lt as mapWithConcurrency, m as ensureCountAllowedForRls, mt as getAggregateIndexes, nt as takeRowsWithinByteBudget, o as getAggregateIndexDefinitions, ot as compileConvexFilter, p as ensureAggregateAllowedForRls, pt as findVectorIndexByName, q as hydrateDateFieldsForRead, rt as toConvexFilter, s as getRankIndexDefinitions, st as convexAnd, tt as splitReturningSelection, u as createAggregateError, ut as findIndexForColumns, v as buildForeignKeyGraph, vt as CREATED_AT_MIGRATION_MESSAGE, w as encodeUndefinedDeep, x as collectPrimaryIdLookupRows, xt as usesSystemCreatedAtAlias, y as canUsePrimaryIdLookupCursor, yt as INTERNAL_CREATION_TIME_FIELD, z as getMutationCollectionLimits } from "../schema-e0wbZ_Ax.js";
 import { t as defineSchemaExtension } from "../extensions-Blzsyekm.js";
 import { compareValues, v } from "convex/values";
 import { defineSchema as defineSchema$1, internalActionGeneric, internalMutationGeneric } from "convex/server";
@@ -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;
 };
 
@@ -1270,24 +1270,6 @@ var WhereClauseCompiler = class {
 
 //#endregion
 //#region src/orm/query.ts
-/**
-* Operators that Convex's `.filter()` cannot express, so `_toConvexExpression`
-* compiles them to a `() => true` placeholder and `_evaluatePostFetchFilter`
-* applies the real predicate in JavaScript after the rows are read.
-* Keep in sync with the string/array cases in `_toConvexExpression`.
-*/
-const POST_FETCH_ONLY_OPERATORS = new Set([
-	"like",
-	"ilike",
-	"notLike",
-	"notIlike",
-	"startsWith",
-	"endsWith",
-	"contains",
-	"arrayContains",
-	"arrayContained",
-	"arrayOverlaps"
-]);
 const DEFAULT_RELATION_FAN_OUT_MAX_KEYS = 1e3;
 /**
 * How many child rows the bounded relation stream filters at a time. Batching
@@ -1743,14 +1725,7 @@ var GelRelationalQuery = class GelRelationalQuery extends QueryPromise {
 	* expression before relying on it.
 	*/
 	_isConvexEnforceableFilter(filter) {
-		if (filter.type === "binary") return !POST_FETCH_ONLY_OPERATORS.has(filter.operator);
-		if (filter.type === "unary") {
-			const [operand] = filter.operands;
-			if (isFieldReference(operand)) return true;
-			return this._isConvexEnforceableFilter(operand);
-		}
-		if (filter.type === "logical") return filter.operands.every((operand) => this._isConvexEnforceableFilter(operand));
-		return true;
+		return isConvexEnforceableFilter(filter);
 	}
 	/**
 	* Evaluate a filter expression against a fetched row
@@ -4098,14 +4073,7 @@ var GelRelationalQuery = class GelRelationalQuery extends QueryPromise {
 					return indexQuery;
 				});
 				if (probeBound !== void 0 && probeOrderDirection) probeQuery = probeQuery.order(probeOrderDirection);
-				if (convexProbeFilters.length > 0) probeQuery = probeQuery.filter((q) => {
-					let result = null;
-					for (const filter of convexProbeFilters) {
-						const expr = this._toConvexExpression(filter)(q);
-						result = result ? q.and(result, expr) : expr;
-					}
-					return result ?? q;
-				});
+				if (convexProbeFilters.length > 0) probeQuery = probeQuery.filter((q) => convexAnd(q, convexProbeFilters.map((filter) => this._toConvexExpression(filter)(q))));
 				return probeBound === void 0 ? await probeQuery.collect() : await probeQuery.take(probeBound);
 			}));
 			let rows = Array.from(new Map(probeRows.flat().map((row) => [String(row._id), row])).values());
@@ -4220,14 +4188,7 @@ var GelRelationalQuery = class GelRelationalQuery extends QueryPromise {
 					splitCursor: paginationResult.splitCursor
 				};
 			}
-			if (convexPostFilters.length > 0) query = query.filter((q) => {
-				let result = null;
-				for (const filter of convexPostFilters) {
-					const expr = this._toConvexExpression(filter)(q);
-					result = result ? q.and(result, expr) : expr;
-				}
-				return result ?? q;
-			});
+			if (convexPostFilters.length > 0) query = query.filter((q) => convexAnd(q, convexPostFilters.map((filter) => this._toConvexExpression(filter)(q))));
 			if (queryConfig.order && primaryOrder) {
 				if (needsPostFetchSortForPrimary) {
 					if (strict) throw new Error(`Pagination: Field '${primaryOrder.field}' has no index. Add an index or disable strict.`);
@@ -4252,14 +4213,7 @@ var GelRelationalQuery = class GelRelationalQuery extends QueryPromise {
 		const convexPostFilters = queryConfig.postFilters.filter((filter) => this._isConvexEnforceableFilter(filter));
 		const hasResidualPostFilter = convexPostFilters.length !== queryConfig.postFilters.length;
 		const hasPostFetchMembership = this._hasSearchDisallowedRelationFilter(whereFilter, this.tableConfig) || this.rls?.mode !== "skip" && isRlsEnabled(this.tableConfig.table);
-		if (convexPostFilters.length > 0) query = query.filter((q) => {
-			let result = null;
-			for (const filter of convexPostFilters) {
-				const expr = this._toConvexExpression(filter)(q);
-				result = result ? q.and(result, expr) : expr;
-			}
-			return result ?? q;
-		});
+		if (convexPostFilters.length > 0) query = query.filter((q) => convexAnd(q, convexPostFilters.map((filter) => this._toConvexExpression(filter)(q))));
 		const offset = config.offset ?? 0;
 		if (typeof offset !== "number") throw new Error("Only numeric offset is supported in kitcn ORM.");
 		const limit = this._resolveNonPaginatedLimit(config);
@@ -4375,9 +4329,7 @@ var GelRelationalQuery = class GelRelationalQuery extends QueryPromise {
 		return builder;
 	}
 	_buildFilterPredicate(q, fields, values) {
-		let expression = q.eq(q.field(fields[0]), values[0]);
-		for (let i = 1; i < fields.length; i += 1) expression = q.and(expression, q.eq(q.field(fields[i]), values[i]));
-		return expression;
+		return convexAnd(q, fields.map((field, index) => q.eq(q.field(field), values[index])));
 	}
 	_queryByFields(query, fields, values, indexName) {
 		if (indexName) return query.withIndex(indexName, (q) => this._buildIndexPredicate(q, fields, values));
@@ -4421,79 +4373,10 @@ var GelRelationalQuery = class GelRelationalQuery extends QueryPromise {
 	* Uses visitor pattern to traverse expression tree
 	*/
 	_toConvexExpression(expression) {
-		const visitor = {
-			visitBinary: (expr) => {
-				const [field, value] = expr.operands;
-				if (!isFieldReference(field)) throw new Error("Binary expression must have FieldReference as first operand");
-				const fieldName = field.fieldName;
-				const normalizedValue = this._normalizeComparableValue(fieldName, value);
-				switch (expr.operator) {
-					case "eq": return (q) => q.eq(q.field(fieldName), normalizedValue);
-					case "ne": return (q) => q.neq(q.field(fieldName), normalizedValue);
-					case "gt": return (q) => q.gt(q.field(fieldName), normalizedValue);
-					case "gte": return (q) => q.gte(q.field(fieldName), normalizedValue);
-					case "lt": return (q) => q.lt(q.field(fieldName), normalizedValue);
-					case "lte": return (q) => q.lte(q.field(fieldName), normalizedValue);
-					case "inArray": {
-						const values = normalizedValue;
-						return (q) => {
-							if (values.length === 0) return q.eq(q.field("_id"), "__better_convex_never__");
-							return values.map((v) => q.eq(q.field(fieldName), v)).reduce((acc, cond) => q.or(acc, cond));
-						};
-					}
-					case "notInArray": {
-						const values = normalizedValue;
-						return (q) => {
-							return values.map((v) => q.neq(q.field(fieldName), v)).reduce((acc, cond) => q.and(acc, cond));
-						};
-					}
-					case "like":
-					case "ilike":
-					case "notLike":
-					case "notIlike":
-					case "startsWith":
-					case "endsWith":
-					case "contains":
-					case "arrayContains":
-					case "arrayContained":
-					case "arrayOverlaps": return () => true;
-					default: throw new Error(`Unsupported binary operator: ${expr.operator}`);
-				}
-			},
-			visitLogical: (expr) => {
-				const operandFns = expr.operands.map((op) => op.accept(visitor));
-				if (expr.operator === "and") return (q) => {
-					let result = operandFns[0](q);
-					for (let i = 1; i < operandFns.length; i++) result = q.and(result, operandFns[i](q));
-					return result;
-				};
-				if (expr.operator === "or") return (q) => {
-					let result = operandFns[0](q);
-					for (let i = 1; i < operandFns.length; i++) result = q.or(result, operandFns[i](q));
-					return result;
-				};
-				throw new Error(`Unsupported logical operator: ${expr.operator}`);
-			},
-			visitUnary: (expr) => {
-				const operand = expr.operands[0];
-				if (expr.operator === "not") {
-					const operandFn = operand.accept(visitor);
-					return (q) => q.not(operandFn(q));
-				}
-				if (expr.operator === "isNull") {
-					if (!isFieldReference(operand)) throw new Error("isNull must operate on a field reference");
-					const fieldName = operand.fieldName;
-					return (q) => q.or(q.eq(q.field(fieldName), null), q.eq(q.field(fieldName), void 0));
-				}
-				if (expr.operator === "isNotNull") {
-					if (!isFieldReference(operand)) throw new Error("isNotNull must operate on a field reference");
-					const fieldName = operand.fieldName;
-					return (q) => q.and(q.neq(q.field(fieldName), null), q.neq(q.field(fieldName), void 0));
-				}
-				throw new Error(`Unsupported unary operator: ${expr.operator}`);
-			}
-		};
-		return expression.accept(visitor);
+		return compileConvexFilter(expression, {
+			normalizeValue: (fieldName, value) => this._normalizeComparableValue(fieldName, value),
+			nullMatchesUndefined: true
+		});
 	}
 	/**
 	* Get edge metadata for a target table
@@ -5755,14 +5638,7 @@ var ConvexInsertBuilder = class extends QueryPromise {
 		else {
 			if (!allowFullScan) throw new Error("onConflict requires allowFullScan: true when no index is available.");
 			if (strict) console.warn("onConflict running without index (allowFullScan: true).");
-			query = query.filter((q) => {
-				let expr = q.eq(q.field(filterValuePairs[0][0]), filterValuePairs[0][1]);
-				for (let i = 1; i < filterValuePairs.length; i++) {
-					const [field, fieldValue] = filterValuePairs[i];
-					expr = q.and(expr, q.eq(q.field(field), fieldValue));
-				}
-				return expr;
-			});
+			query = query.filter((q) => convexAnd(q, filterValuePairs.map(([field, fieldValue]) => q.eq(q.field(field), fieldValue))));
 		}
 		const row = await query.first();
 		return row ? row : null;

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-Bke7ULoY.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/{schema-D8sVYuYO.js → schema-e0wbZ_Ax.js}

@@ -125,6 +125,138 @@ async function mapWithConcurrency(items, limit, worker) {
 	return results;
 }
 
+//#endregion
+//#region src/orm/convex-filter-compiler.ts
+/**
+* Operators Convex's `.filter()` cannot express, so they compile to a
+* `() => true` placeholder and the real predicate runs in JavaScript after the
+* rows are read. Callers that push a compiled expression into Convex must
+* first check `isConvexEnforceableFilter`: a `true` placeholder makes a
+* downstream `take()` spend its budget on unfiltered rows, and a surrounding
+* `NOT` turns it into `q.not(true)`, which matches nothing.
+*/
+const POST_FETCH_ONLY_OPERATORS = new Set([
+	"like",
+	"ilike",
+	"notLike",
+	"notIlike",
+	"startsWith",
+	"endsWith",
+	"contains",
+	"arrayContains",
+	"arrayContained",
+	"arrayOverlaps"
+]);
+/**
+* Compared against `_id`, which is a Convex id and can never equal a plain
+* string, so `eq` against it is unsatisfiable. Convex's expression grammar has
+* no literal boolean, so this is how `in []` says "match nothing".
+*/
+const NEVER_MATCH_SENTINEL = "__better_convex_never__";
+/**
+* Convex's `q.or` / `q.and` are variadic — `or(...exprs)` serializes to a flat
+* `{ $or: [...] }` (see `convex/src/server/impl/filter_builder_impl.ts`).
+* Folding them pairwise instead nests one `$or` per operand, so the serialized
+* filter's JSON depth grows as `2N + 1` and the backend rejects the whole query
+* with `Received invalid json: recursion limit exceeded` once the list passes a
+* few dozen entries. Always combine in one variadic call.
+*/
+function convexOr(q, expressions) {
+	return expressions.length === 1 ? expressions[0] : q.or(...expressions);
+}
+/** Flat `$and` counterpart of {@link convexOr}. */
+function convexAnd(q, expressions) {
+	return expressions.length === 1 ? expressions[0] : q.and(...expressions);
+}
+/**
+* Whether Convex can carry the whole expression in `.filter()`, or some part of
+* it compiles to a `() => true` placeholder that only JavaScript can enforce.
+*/
+function isConvexEnforceableFilter(filter) {
+	if (filter.type === "binary") return !POST_FETCH_ONLY_OPERATORS.has(filter.operator);
+	if (filter.type === "unary") {
+		const [operand] = filter.operands;
+		if (isFieldReference(operand)) return true;
+		return isConvexEnforceableFilter(operand);
+	}
+	if (filter.type === "logical") return filter.operands.every((operand) => isConvexEnforceableFilter(operand));
+	return true;
+}
+/**
+* Compile a filter expression to a Convex `.filter()` callback.
+*
+* @param expression - Filter expression tree
+* @param options - Per-lane semantics; see {@link ConvexFilterCompilerOptions}
+*/
+function compileConvexFilter(expression, options = {}) {
+	const { normalizeValue, nullMatchesUndefined = false } = options;
+	const visitor = {
+		visitBinary: (expr) => {
+			const [field, value] = expr.operands;
+			if (!isFieldReference(field)) throw new Error("Binary expression must have FieldReference as first operand");
+			const fieldName = field.fieldName;
+			const normalizedValue = normalizeValue ? normalizeValue(fieldName, value) : value;
+			switch (expr.operator) {
+				case "eq": return (q) => q.eq(q.field(fieldName), normalizedValue);
+				case "ne": return (q) => q.neq(q.field(fieldName), normalizedValue);
+				case "gt": return (q) => q.gt(q.field(fieldName), normalizedValue);
+				case "gte": return (q) => q.gte(q.field(fieldName), normalizedValue);
+				case "lt": return (q) => q.lt(q.field(fieldName), normalizedValue);
+				case "lte": return (q) => q.lte(q.field(fieldName), normalizedValue);
+				case "inArray": {
+					const values = normalizedValue;
+					return (q) => {
+						if (values.length === 0) return q.eq(q.field("_id"), NEVER_MATCH_SENTINEL);
+						return convexOr(q, values.map((v) => q.eq(q.field(fieldName), v)));
+					};
+				}
+				case "notInArray": {
+					const values = normalizedValue;
+					return (q) => convexAnd(q, values.map((v) => q.neq(q.field(fieldName), v)));
+				}
+				case "like":
+				case "ilike":
+				case "notLike":
+				case "notIlike":
+				case "startsWith":
+				case "endsWith":
+				case "contains":
+				case "arrayContains":
+				case "arrayContained":
+				case "arrayOverlaps": return () => true;
+				default: throw new Error(`Unsupported binary operator: ${expr.operator}`);
+			}
+		},
+		visitLogical: (expr) => {
+			const operandFns = expr.operands.map((op) => op.accept(visitor));
+			if (expr.operator === "and") return (q) => convexAnd(q, operandFns.map((fn) => fn(q)));
+			if (expr.operator === "or") return (q) => convexOr(q, operandFns.map((fn) => fn(q)));
+			throw new Error(`Unsupported logical operator: ${expr.operator}`);
+		},
+		visitUnary: (expr) => {
+			const operand = expr.operands[0];
+			if (expr.operator === "not") {
+				const operandFn = operand.accept(visitor);
+				return (q) => q.not(operandFn(q));
+			}
+			if (expr.operator === "isNull") {
+				if (!isFieldReference(operand)) throw new Error("isNull must operate on a field reference");
+				const fieldName = operand.fieldName;
+				if (!nullMatchesUndefined) return (q) => q.eq(q.field(fieldName), null);
+				return (q) => q.or(q.eq(q.field(fieldName), null), q.eq(q.field(fieldName), void 0));
+			}
+			if (expr.operator === "isNotNull") {
+				if (!isFieldReference(operand)) throw new Error("isNotNull must operate on a field reference");
+				const fieldName = operand.fieldName;
+				if (!nullMatchesUndefined) return (q) => q.neq(q.field(fieldName), null);
+				return (q) => q.and(q.neq(q.field(fieldName), null), q.neq(q.field(fieldName), void 0));
+			}
+			throw new Error(`Unsupported unary operator: ${expr.operator}`);
+		}
+	};
+	return expression.accept(visitor);
+}
+
 //#endregion
 //#region src/orm/write-fanout.ts
 /**
@@ -385,7 +517,9 @@ const deserializeFilterExpression = (expression) => {
 	}
 	if (expression.type === "logical") {
 		const logical = expression;
-		return createLogicalExpression(logical.operator, logical.operands.map((operand) => deserializeFilterExpression(operand)).filter((operand) => !!operand));
+		const operands = logical.operands.map((operand) => deserializeFilterExpression(operand)).filter((operand) => !!operand);
+		if (operands.length === 0) throw new Error("Serialized logical expression requires at least one operand.");
+		return createLogicalExpression(logical.operator, operands);
 	}
 	const unary = expression;
 	const operand = unary.operand;
@@ -754,9 +888,7 @@ function buildIndexPredicate(q, columns, values) {
 	return builder;
 }
 function buildFilterPredicate(q, columns, values) {
-	let expr = q.eq(q.field(columns[0]), values[0]);
-	for (let i = 1; i < columns.length; i++) expr = q.and(expr, q.eq(q.field(columns[i]), values[i]));
-	return expr;
+	return convexAnd(q, columns.map((column, index) => q.eq(q.field(column), values[index])));
 }
 function ensureNullableColumns(table, columns, context) {
 	for (const columnName of columns) {
@@ -1197,78 +1329,7 @@ function enforceCheckConstraints(table, candidate) {
 	for (const check of checks) if (evaluateCheckConstraintTriState(candidate, check.expression) === false) throw new Error(`Check constraint '${check.name}' violation on '${tableName}'.`);
 }
 function toConvexFilter(expression) {
-	const visitor = {
-		visitBinary: (expr) => {
-			const [field, value] = expr.operands;
-			if (!isFieldReference(field)) throw new Error("Binary expression must have FieldReference as first operand");
-			const fieldName = field.fieldName;
-			switch (expr.operator) {
-				case "eq": return (q) => q.eq(q.field(fieldName), value);
-				case "ne": return (q) => q.neq(q.field(fieldName), value);
-				case "gt": return (q) => q.gt(q.field(fieldName), value);
-				case "gte": return (q) => q.gte(q.field(fieldName), value);
-				case "lt": return (q) => q.lt(q.field(fieldName), value);
-				case "lte": return (q) => q.lte(q.field(fieldName), value);
-				case "inArray": {
-					const values = value;
-					return (q) => {
-						if (values.length === 0) return q.eq(q.field("_id"), "__better_convex_never__");
-						return values.map((v) => q.eq(q.field(fieldName), v)).reduce((acc, cond) => q.or(acc, cond));
-					};
-				}
-				case "notInArray": {
-					const values = value;
-					return (q) => {
-						return values.map((v) => q.neq(q.field(fieldName), v)).reduce((acc, cond) => q.and(acc, cond));
-					};
-				}
-				case "like":
-				case "ilike":
-				case "notLike":
-				case "notIlike":
-				case "startsWith":
-				case "endsWith":
-				case "contains":
-				case "arrayContains":
-				case "arrayContained":
-				case "arrayOverlaps": return () => true;
-				default: throw new Error(`Unsupported binary operator: ${expr.operator}`);
-			}
-		},
-		visitLogical: (expr) => {
-			const operandFns = expr.operands.map((op) => op.accept(visitor));
-			if (expr.operator === "and") return (q) => {
-				let result = operandFns[0](q);
-				for (let i = 1; i < operandFns.length; i++) result = q.and(result, operandFns[i](q));
-				return result;
-			};
-			if (expr.operator === "or") return (q) => {
-				let result = operandFns[0](q);
-				for (let i = 1; i < operandFns.length; i++) result = q.or(result, operandFns[i](q));
-				return result;
-			};
-			throw new Error(`Unsupported logical operator: ${expr.operator}`);
-		},
-		visitUnary: (expr) => {
-			const operand = expr.operands[0];
-			if (expr.operator === "not") {
-				const operandFn = operand.accept(visitor);
-				return (q) => q.not(operandFn(q));
-			}
-			if (expr.operator === "isNull") {
-				if (!isFieldReference(operand)) throw new Error("isNull must operate on a field reference");
-				const fieldName = operand.fieldName;
-				return (q) => q.eq(q.field(fieldName), null);
-			}
-			if (expr.operator === "isNotNull") {
-				if (!isFieldReference(operand)) throw new Error("isNotNull must operate on a field reference");
-				const fieldName = operand.fieldName;
-				return (q) => q.neq(q.field(fieldName), null);
-			}
-			throw new Error(`Unsupported unary operator: ${expr.operator}`);
-		}
-	};
-	return expression.accept(visitor);
+	return compileConvexFilter(expression);
 }
 
 //#endregion
@@ -1422,4 +1483,4 @@ function aggregateExtension() {
 }
 
 //#endregion
-export { serializeFilterExpression as $, ensureNonNullValues as A, getMutationExecutionMode as B, deserializeFilterExpression as C, enforcePolymorphicWrite as D, enforceForeignKeys as E, getChecks as F, getUniqueIndexes as G, getTableColumns as H, getColumnName as I, normalizeDateFieldsForWrite as J, hardDeleteRow as K, getForeignKeys as L, evaluateCheckConstraintTriState as M, evaluateFilter as N, enforceUniqueIndexes as O, extractPrimaryIdLookup as P, selectReturningRowWithHydration as Q, getMutationAsyncDelayMs as R, decodeUndefinedDeep as S, enforceCheckConstraints as T, getTableDeleteConfig as U, getOrmContext as V, getTableName as W, patchReferencingRows as X, normalizeTemporalComparableValue as Y, resolveOrmRuntimeDefaults as Z, applyIncomingForeignKeyActionsOnUpdate as _, PUBLIC_CREATED_AT_FIELD as _t, aggregateExtension as a, markLifecycleHookedTables as at, collectMutationRowsBounded as b, AGGREGATE_ERROR as c, findRelationIndex as ct, createCountError as d, getAggregateIndexes as dt, softDeleteRow as et, createError as f, getIndexes as ft, applyIncomingForeignKeyActionsOnDelete as g, INTERNAL_CREATION_TIME_FIELD as gt, applyDefaults as h, CREATED_AT_MIGRATION_MESSAGE as ht, AGGREGATE_STATE_TABLE as i, hasLifecycleHooks as it, ensureNullableColumns as j, ensureDefaultColumns as k, COUNT_ERROR as l, findSearchIndexByName as lt, ensureCountAllowedForRls as m, resolveIndexOrderPushdown as mt, AGGREGATE_EXTREMA_TABLE as n, takeRowsWithinByteBudget as nt, getAggregateIndexDefinitions as o, mapWithConcurrency as ot, ensureAggregateAllowedForRls as p, getRankIndexes as pt, hydrateDateFieldsForRead as q, AGGREGATE_MEMBER_TABLE as r, toConvexFilter as rt, getRankIndexDefinitions as s, findIndexForColumns as st, AGGREGATE_BUCKET_TABLE as t, splitReturningSelection as tt, createAggregateError as u, findVectorIndexByName as ut, buildForeignKeyGraph as v, usesSystemCreatedAtAlias as vt, encodeUndefinedDeep as w, collectPrimaryIdLookupRows as x, canUsePrimaryIdLookupCursor as y, getMutationCollectionLimits as z };
+export { serializeFilterExpression as $, ensureNonNullValues as A, getMutationExecutionMode as B, deserializeFilterExpression as C, enforcePolymorphicWrite as D, enforceForeignKeys as E, getChecks as F, getUniqueIndexes as G, getTableColumns as H, getColumnName as I, normalizeDateFieldsForWrite as J, hardDeleteRow as K, getForeignKeys as L, evaluateCheckConstraintTriState as M, evaluateFilter as N, enforceUniqueIndexes as O, extractPrimaryIdLookup as P, selectReturningRowWithHydration as Q, getMutationAsyncDelayMs as R, decodeUndefinedDeep as S, enforceCheckConstraints as T, getTableDeleteConfig as U, getOrmContext as V, getTableName as W, patchReferencingRows as X, normalizeTemporalComparableValue as Y, resolveOrmRuntimeDefaults as Z, applyIncomingForeignKeyActionsOnUpdate as _, resolveIndexOrderPushdown as _t, aggregateExtension as a, markLifecycleHookedTables as at, collectMutationRowsBounded as b, PUBLIC_CREATED_AT_FIELD as bt, AGGREGATE_ERROR as c, isConvexEnforceableFilter as ct, createCountError as d, findRelationIndex as dt, softDeleteRow as et, createError as f, findSearchIndexByName as ft, applyIncomingForeignKeyActionsOnDelete as g, getRankIndexes as gt, applyDefaults as h, getIndexes as ht, AGGREGATE_STATE_TABLE as i, hasLifecycleHooks as it, ensureNullableColumns as j, ensureDefaultColumns as k, COUNT_ERROR as l, mapWithConcurrency as lt, ensureCountAllowedForRls as m, getAggregateIndexes as mt, AGGREGATE_EXTREMA_TABLE as n, takeRowsWithinByteBudget as nt, getAggregateIndexDefinitions as o, compileConvexFilter as ot, ensureAggregateAllowedForRls as p, findVectorIndexByName as pt, hydrateDateFieldsForRead as q, AGGREGATE_MEMBER_TABLE as r, toConvexFilter as rt, getRankIndexDefinitions as s, convexAnd as st, AGGREGATE_BUCKET_TABLE as t, splitReturningSelection as tt, createAggregateError as u, findIndexForColumns as ut, buildForeignKeyGraph as v, CREATED_AT_MIGRATION_MESSAGE as vt, encodeUndefinedDeep as w, collectPrimaryIdLookupRows as x, usesSystemCreatedAtAlias as xt, canUsePrimaryIdLookupCursor as y, INTERNAL_CREATION_TIME_FIELD as yt, getMutationCollectionLimits as z };

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-Bke7ULoY.d.ts → where-clause-compiler-DlRUDuMx.d.ts}

@@ -1021,7 +1021,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
           fieldName: "updatedAt";
         };
       };
-      count: ConvexNumberBuilderInitial<""> & {
+      indexName: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1031,10 +1031,10 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "count";
+          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<""> & {
@@ -1336,11 +1336,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
           fieldName: "updatedAt";
         };
       };
-      value: ConvexCustomBuilderInitial<"", convex_values0.VAny<any, "required", string>> & {
-        _: {
-          $type: convex_values0.Value;
-        };
-      } & {
+      indexName: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1350,10 +1346,10 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "value";
+          fieldName: "indexName";
         };
       };
-      count: ConvexNumberBuilderInitial<""> & {
+      tableKey: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1363,10 +1359,14 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "count";
+          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<""> & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitcn",
-  "version": "0.25.3",
+  "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`.