kitcn 0.15.8 → 0.15.9

package/dist/aggregate/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial, dn as ConvexTableWithColumns, tr as ConvexTextBuilderInitial } from "../where-clause-compiler-CgQj3ZHP.js";
+import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial, dn as ConvexTableWithColumns, tr as ConvexTextBuilderInitial } from "../where-clause-compiler-Dc58we_m.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-0xEF3NtW.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-3mwCSv2F.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-CNo9ffvI.js";
 import { t as GetAuth } from "../types-BCl8gfGy.js";
 import { t as GenericCtx } from "../context-utils-OMkMGhBk.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-0xEF3NtW.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-3mwCSv2F.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";
@@ -107,27 +107,27 @@ type AdapterPaginationOptions = PaginationOptions & {
 };
 declare const adapterWhereValidator: convex_values0.VObject<{
   mode?: "sensitive" | "insensitive" | undefined;
+  operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
   connector?: "AND" | "OR" | undefined;
-  operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
   value: string | number | boolean | string[] | number[] | null;
   field: string;
 }, {
   connector: convex_values0.VUnion<"AND" | "OR" | undefined, [convex_values0.VLiteral<"AND", "required">, convex_values0.VLiteral<"OR", "required">], "optional", never>;
   field: convex_values0.VString<string, "required">;
   mode: convex_values0.VUnion<"sensitive" | "insensitive" | undefined, [convex_values0.VLiteral<"sensitive", "required">, convex_values0.VLiteral<"insensitive", "required">], "optional", never>;
-  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>;
+  operator: convex_values0.VUnion<"eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "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">;
+}, "required", "mode" | "operator" | "value" | "field" | "connector">;
 declare const adapterArgsValidator: convex_values0.VObject<{
-  select?: string[] | undefined;
+  limit?: number | undefined;
   where?: {
     mode?: "sensitive" | "insensitive" | undefined;
+    operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
     connector?: "AND" | "OR" | undefined;
-    operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
     value: string | number | boolean | string[] | number[] | null;
     field: string;
   }[] | undefined;
-  limit?: number | undefined;
+  select?: string[] | undefined;
   offset?: number | undefined;
   sortBy?: {
     field: string;
@@ -148,24 +148,24 @@ declare const adapterArgsValidator: convex_values0.VObject<{
   }, "optional", "field" | "direction">;
   where: convex_values0.VArray<{
     mode?: "sensitive" | "insensitive" | undefined;
+    operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
     connector?: "AND" | "OR" | undefined;
-    operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
     value: string | number | boolean | string[] | number[] | null;
     field: string;
   }[] | undefined, convex_values0.VObject<{
     mode?: "sensitive" | "insensitive" | undefined;
+    operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
     connector?: "AND" | "OR" | undefined;
-    operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
     value: string | number | boolean | string[] | number[] | null;
     field: string;
   }, {
     connector: convex_values0.VUnion<"AND" | "OR" | undefined, [convex_values0.VLiteral<"AND", "required">, convex_values0.VLiteral<"OR", "required">], "optional", never>;
     field: convex_values0.VString<string, "required">;
     mode: convex_values0.VUnion<"sensitive" | "insensitive" | undefined, [convex_values0.VLiteral<"sensitive", "required">, convex_values0.VLiteral<"insensitive", "required">], "optional", never>;
-    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>;
+    operator: convex_values0.VUnion<"eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "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", "model" | "select" | "where" | "limit" | "offset" | "sortBy" | "sortBy.field" | "sortBy.direction">;
+  }, "required", "mode" | "operator" | "value" | "field" | "connector">, "optional">;
+}, "required", "limit" | "where" | "model" | "select" | "offset" | "sortBy" | "sortBy.field" | "sortBy.direction">;
 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/{backend-core-CQmXi2Q0.mjs → backend-core-CRJpuVnf.mjs}

@@ -7068,8 +7068,8 @@ const READ_OPTIONAL_RUNTIME_ENV_PROPERTY_RE = /\breadOptionalRuntimeEnv\s*:/m;
 const READ_OPTIONAL_RUNTIME_ENV_RE = /(\s*readOptionalRuntimeEnv\s*:\s*\[)([\s\S]*?)(\]\s*,?)/m;
 const LEADING_WHITESPACE_RE = /^\s*/;
 const STRING_LITERAL_ARRAY_ENTRY_RE = /^(['"])([^'"]+)\1$/;
-const WHITESPACE_RE$1 = /\s/;
-const findMatchingObjectBraceIndex = (source, openIndex) => {
+const WHITESPACE_RE$2 = /\s/;
+const findMatchingObjectBraceIndex$1 = (source, openIndex) => {
 	let depth = 0;
 	let quote;
 	let escaped = false;
@@ -7188,7 +7188,7 @@ const upsertReadOptionalRuntimeEnvOption = (source, keys) => {
 	const createEnvMatch = source.match(CREATE_ENV_OPTIONS_START_RE);
 	if (!createEnvMatch || createEnvMatch.index === void 0) throw new Error("Expected env helper to call `createEnv({ ... })` before adding `readOptionalRuntimeEnv`.");
 	const insertIndex = createEnvMatch.index + createEnvMatch[0].lastIndexOf("{") + 1;
-	const closingBraceIndex = findMatchingObjectBraceIndex(source, insertIndex - 1);
+	const closingBraceIndex = findMatchingObjectBraceIndex$1(source, insertIndex - 1);
 	if (closingBraceIndex === -1) throw new Error("Expected env helper `createEnv` options object to close before adding `readOptionalRuntimeEnv`.");
 	const existingOptionsBody = source.slice(insertIndex, closingBraceIndex);
 	const existingMatch = existingOptionsBody.match(READ_OPTIONAL_RUNTIME_ENV_RE);
@@ -7378,9 +7378,9 @@ const getPlannedFileContent = (files, absolutePath) => {
 	const normalizedPath = normalizePath$1(relative(process.cwd(), absolutePath));
 	return files?.find((file) => file.path === normalizedPath)?.content;
 };
-const skipWhitespace$1 = (source, start) => {
+const skipWhitespace$2 = (source, start) => {
 	let index = start;
-	while (index < source.length && WHITESPACE_RE$1.test(source[index] ?? "")) index += 1;
+	while (index < source.length && WHITESPACE_RE$2.test(source[index] ?? "")) index += 1;
 	return index;
 };
 const findBalancedParenEnd$1 = (source, openParenIndex) => {
@@ -7418,7 +7418,7 @@ const findSchemaExtensionInsertIndex = (source) => {
 	};
 	const cursor = defineSchemaCloseParenIndex + 1;
 	while (cursor < source.length) {
-		const nextSegmentIndex = skipWhitespace$1(source, cursor);
+		const nextSegmentIndex = skipWhitespace$2(source, cursor);
 		if (source.startsWith(".relations(", nextSegmentIndex) || source.startsWith(".triggers(", nextSegmentIndex)) return {
 			closeParenIndex: -1,
 			hasExtend: false,
@@ -7662,7 +7662,7 @@ const createTypeScriptProxy = () => new Proxy({}, { get(_target, property) {
 const OBJECT_ENTRY_INDENT = "  ";
 const LEADING_INDENT_RE = /^[ \t]*/;
 const LEGACY_MANAGED_COMMENT_RE = /^[ \t]*\/\* kitcn-managed [^*]+ \*\/\n?/gm;
-const WHITESPACE_RE = /\s/;
+const WHITESPACE_RE$1 = /\s/;
 const ts$2 = createTypeScriptProxy();
 let printer = null;
 const getPrinter = () => {
@@ -8003,9 +8003,9 @@ const updateTablesObject = (source, registrations) => {
 	if (!changed) return source;
 	return replaceRange(source, info.object.getStart(info.sourceFile), info.object.end, renderObjectLiteral(getIndentAt(source, info.object.getStart(info.sourceFile)), existingEntries));
 };
-const skipWhitespace = (source, start) => {
+const skipWhitespace$1 = (source, start) => {
 	let cursor = start;
-	while (cursor < source.length && WHITESPACE_RE.test(source[cursor])) cursor += 1;
+	while (cursor < source.length && WHITESPACE_RE$1.test(source[cursor])) cursor += 1;
 	return cursor;
 };
 const findBalancedParenEnd = (source, openParenIndex) => {
@@ -8029,7 +8029,7 @@ const findRelationsInsertIndex = (source) => {
 	if (defineSchemaCloseParenIndex < 0) return -1;
 	let cursor = defineSchemaCloseParenIndex + 1;
 	while (cursor < source.length) {
-		const nextSegmentIndex = skipWhitespace(source, cursor);
+		const nextSegmentIndex = skipWhitespace$1(source, cursor);
 		if (source.startsWith(".relations(", nextSegmentIndex)) return nextSegmentIndex;
 		if (source.startsWith(".triggers(", nextSegmentIndex)) return nextSegmentIndex;
 		if (!source.startsWith(".extend(", nextSegmentIndex)) return nextSegmentIndex;
@@ -13646,6 +13646,8 @@ const INIT_NEXT_IMPORT_SEMICOLON_RE = /^\s*import .*;\s*$/m;
 const INIT_NEXT_TRAILING_NEWLINES_RE = /\n*$/;
 const INIT_NEXT_PROVIDERS_IMPORT_RE = /from ['"]@\/components\/providers['"]/;
 const INIT_NEXT_CHILDREN_SLOT_RE = /\{\s*children\s*\}/g;
+const IDENTIFIER_CHAR_RE = /[A-Za-z0-9_$]/;
+const WHITESPACE_RE = /\s/;
 const VALID_SCOPES = new Set([
 	"all",
 	"auth",
@@ -14741,9 +14743,248 @@ function patchInitReactMainContent(source) {
 	}
 	return nextSource.endsWith("\n") ? nextSource : `${nextSource}\n`;
 }
+function findMatchingObjectBraceIndex(source, openIndex) {
+	let depth = 0;
+	let quote;
+	let escaped = false;
+	let lineComment = false;
+	let blockComment = false;
+	for (let index = openIndex; index < source.length; index++) {
+		const char = source[index];
+		const nextChar = source[index + 1];
+		if (lineComment) {
+			if (char === "\n" || char === "\r") lineComment = false;
+			continue;
+		}
+		if (blockComment) {
+			if (char === "*" && nextChar === "/") {
+				blockComment = false;
+				index++;
+			}
+			continue;
+		}
+		if (quote) {
+			if (escaped) {
+				escaped = false;
+				continue;
+			}
+			if (char === "\\") {
+				escaped = true;
+				continue;
+			}
+			if (char === quote) quote = void 0;
+			continue;
+		}
+		if (char === "/" && nextChar === "/") {
+			lineComment = true;
+			index++;
+			continue;
+		}
+		if (char === "/" && nextChar === "*") {
+			blockComment = true;
+			index++;
+			continue;
+		}
+		if (char === "\"" || char === "'" || char === "`") {
+			quote = char;
+			continue;
+		}
+		if (char === "{") {
+			depth++;
+			continue;
+		}
+		if (char === "}") {
+			depth--;
+			if (depth === 0) return index;
+		}
+	}
+	return -1;
+}
+function isIdentifierChar(char) {
+	return typeof char === "string" && IDENTIFIER_CHAR_RE.test(char);
+}
+function isIdentifierAt(source, index, identifier) {
+	return source.startsWith(identifier, index) && !isIdentifierChar(source[index - 1]) && !isIdentifierChar(source[index + identifier.length]);
+}
+function skipWhitespace(source, index) {
+	let nextIndex = index;
+	while (nextIndex < source.length && WHITESPACE_RE.test(source[nextIndex] ?? "")) nextIndex++;
+	return nextIndex;
+}
+function skipTrivia(source, index) {
+	let nextIndex = index;
+	while (nextIndex < source.length) {
+		const whitespaceIndex = skipWhitespace(source, nextIndex);
+		if (whitespaceIndex !== nextIndex) {
+			nextIndex = whitespaceIndex;
+			continue;
+		}
+		const char = source[nextIndex];
+		const nextChar = source[nextIndex + 1];
+		if (char === "/" && nextChar === "/") {
+			const lineEndIndex = source.indexOf("\n", nextIndex + 2);
+			nextIndex = lineEndIndex === -1 ? source.length : lineEndIndex + 1;
+			continue;
+		}
+		if (char === "/" && nextChar === "*") {
+			const blockEndIndex = source.indexOf("*/", nextIndex + 2);
+			nextIndex = blockEndIndex === -1 ? source.length : blockEndIndex + 2;
+			continue;
+		}
+		break;
+	}
+	return nextIndex;
+}
+function readObjectPropertyNameEndIndex(source, index, propertyName) {
+	const char = source[index];
+	if (char === "\"" || char === "'") {
+		const closeIndex = source.indexOf(char, index + 1);
+		if (closeIndex === -1) return -1;
+		return source.slice(index + 1, closeIndex) === propertyName ? closeIndex + 1 : -1;
+	}
+	if (isIdentifierAt(source, index, propertyName)) return index + propertyName.length;
+	return -1;
+}
+function findConfigObjectOpenIndex(source) {
+	let quote;
+	let escaped = false;
+	let lineComment = false;
+	let blockComment = false;
+	for (let index = 0; index < source.length; index++) {
+		const char = source[index];
+		const nextChar = source[index + 1];
+		if (lineComment) {
+			if (char === "\n" || char === "\r") lineComment = false;
+			continue;
+		}
+		if (blockComment) {
+			if (char === "*" && nextChar === "/") {
+				blockComment = false;
+				index++;
+			}
+			continue;
+		}
+		if (quote) {
+			if (escaped) {
+				escaped = false;
+				continue;
+			}
+			if (char === "\\") {
+				escaped = true;
+				continue;
+			}
+			if (char === quote) quote = void 0;
+			continue;
+		}
+		if (char === "/" && nextChar === "/") {
+			lineComment = true;
+			index++;
+			continue;
+		}
+		if (char === "/" && nextChar === "*") {
+			blockComment = true;
+			index++;
+			continue;
+		}
+		if (char === "\"" || char === "'" || char === "`") {
+			quote = char;
+			continue;
+		}
+		if (isIdentifierAt(source, index, "defineConfig")) {
+			const callIndex = skipTrivia(source, index + 12);
+			if (source[callIndex] === "(") {
+				const objectOpenIndex = skipTrivia(source, callIndex + 1);
+				if (source[objectOpenIndex] === "{") return objectOpenIndex;
+			}
+		}
+		if (isIdentifierAt(source, index, "export")) {
+			const defaultIndex = skipTrivia(source, index + 6);
+			if (isIdentifierAt(source, defaultIndex, "default")) {
+				const objectOpenIndex = skipTrivia(source, defaultIndex + 7);
+				if (source[objectOpenIndex] === "{") return objectOpenIndex;
+			}
+		}
+	}
+	return -1;
+}
+function findObjectPropertyValueIndex(source, openIndex, propertyName) {
+	const closeIndex = findMatchingObjectBraceIndex(source, openIndex);
+	if (closeIndex === -1) return -1;
+	let depth = 1;
+	let quote;
+	let escaped = false;
+	let lineComment = false;
+	let blockComment = false;
+	for (let index = openIndex + 1; index < closeIndex; index++) {
+		const char = source[index];
+		const nextChar = source[index + 1];
+		if (lineComment) {
+			if (char === "\n" || char === "\r") lineComment = false;
+			continue;
+		}
+		if (blockComment) {
+			if (char === "*" && nextChar === "/") {
+				blockComment = false;
+				index++;
+			}
+			continue;
+		}
+		if (quote) {
+			if (escaped) {
+				escaped = false;
+				continue;
+			}
+			if (char === "\\") {
+				escaped = true;
+				continue;
+			}
+			if (char === quote) quote = void 0;
+			continue;
+		}
+		if (char === "/" && nextChar === "/") {
+			lineComment = true;
+			index++;
+			continue;
+		}
+		if (char === "/" && nextChar === "*") {
+			blockComment = true;
+			index++;
+			continue;
+		}
+		if (depth === 1) {
+			const propertyNameEndIndex = readObjectPropertyNameEndIndex(source, index, propertyName);
+			if (propertyNameEndIndex !== -1) {
+				const colonIndex = skipTrivia(source, propertyNameEndIndex);
+				if (source[colonIndex] === ":") return skipTrivia(source, colonIndex + 1);
+			}
+		}
+		if (char === "\"" || char === "'" || char === "`") {
+			quote = char;
+			continue;
+		}
+		if (char === "{") {
+			depth++;
+			continue;
+		}
+		if (char === "}") depth--;
+	}
+	return -1;
+}
+function hasEnabledTsconfigPathsValueAt(source, index) {
+	const valueIndex = skipTrivia(source, index);
+	return source[valueIndex] === "{" || isIdentifierAt(source, valueIndex, "true");
+}
+function hasResolveTsconfigPathsOption(source) {
+	const configOpenIndex = findConfigObjectOpenIndex(source);
+	if (configOpenIndex === -1) return false;
+	const resolveValueIndex = findObjectPropertyValueIndex(source, configOpenIndex, "resolve");
+	if (source[resolveValueIndex] !== "{") return false;
+	const tsconfigPathsValueIndex = findObjectPropertyValueIndex(source, resolveValueIndex, "tsconfigPaths");
+	return tsconfigPathsValueIndex !== -1 && hasEnabledTsconfigPathsValueAt(source, tsconfigPathsValueIndex);
+}
 function patchInitReactViteConfigContent(source) {
 	if (source.includes("'@convex'") || source.includes("\"@convex\"")) return source.endsWith("\n") ? source : `${source}\n`;
-	if (source.includes("viteTsConfigPaths(") || source.includes("tsConfigPaths(")) return source.endsWith("\n") ? source : `${source}\n`;
+	if (source.includes("viteTsConfigPaths(") || source.includes("tsConfigPaths(") || hasResolveTsconfigPathsOption(source)) return source.endsWith("\n") ? source : `${source}\n`;
 	if (!source.includes("alias: {")) throw new Error("Could not patch vite.config.ts: expected a resolve.alias block.");
 	const nextSource = source.replace("alias: {", `alias: {\n      '@convex': path.resolve(__dirname, './convex/shared'),`);
 	return nextSource.endsWith("\n") ? nextSource : `${nextSource}\n`;

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { $ as promptForScaffoldTemplateSelection, A as resolveCodegenTrimSegments, At as highlighter, B as runConfiguredCodegen, C as isEntryPoint, Ct as formatDependencyInstallCommand, D as parseInitCommandArgs, E as parseBackendRunJson, Et as stripConvexCommandNoise, F as resolveRunDeps, G as runMigrationFlow, H as runDevSchemaBackfillIfNeeded, I as runAfterScaffoldScript, J as withWorkingDirectory, K as trackProcess, L as runAggregateBackfillFlow, M as resolveDocTopic, N as resolveInitProjectDir, O as readPackageVersions, P as resolveMigrationConfig, Q as promptForPluginSelection, R as runAggregatePruneFlow, S as isConvexDevPreRunConflictFlag, St as detectPackageManager, T as parseArgs, Tt as serializeEnvValue, U as runInitCommandFlow, V as runConvexInitIfNeeded, W as runMigrationCreate, X as collectPluginScaffoldTemplates, Y as createSpinner, Z as filterScaffoldTemplatePathMap, _ as formatInfoOutput, _t as applyPlanningDependencyInstall, a as cleanup, at as getPluginCatalogEntry, b as getDevAggregateBackfillStatePath, bt as resolveSupportedDependencyWarnings, c as createCommandEnv, ct as buildPluginInstallPlan, d as extractBackfillCliOptions, dt as collectInstalledPluginKeys, et as resolveAddTemplateDefaults, f as extractConcaveRunTargetArgs, ft as getPluginLockfilePath, g as formatDocsOutput, gt as applyDependencyHintsInstall, h as extractResetCliOptions, ht as resolveSchemaInstalledPlugins, i as buildInitializationPlan, it as resolveTemplatesByIdOrThrow, j as resolveConfiguredBackend, k as resolveBackfillConfig, kt as logger, l as ensureConvexGitignoreEntry, lt as resolvePluginScaffoldRoots, m as extractMigrationDownOptions, mt as readPluginLockfile, n as applyPluginInstallPlanFiles, nt as resolvePresetScaffoldTemplates, o as createBackendAdapter, ot as getSupportedPluginKeys, p as extractMigrationCliOptions, pt as getSchemaFilePath, q as withLocalCodegenEnv, r as assertNoRemovedDevPreRunFlag, rt as resolveTemplateSelectionSource, s as createBackendCommandEnv, st as isSupportedPluginKey, t as applyDependencyInstallPlan, tt as resolvePluginPreset, u as extractBackendRunTargetArgs, ut as assertSchemaFileExists, v as getAggregateBackfillDeploymentKey, vt as applyPluginDependencyInstall, w as isInitialized, wt as resolveAuthEnvState, x as hasRemoteConvexDeploymentEnv, xt as resolveProjectScaffoldContext, y as getConvexDeploymentCommandEnv, yt as inspectPluginDependencyInstall, z as runBackendFunction } from "./backend-core-CQmXi2Q0.mjs";
+import { $ as promptForScaffoldTemplateSelection, A as resolveCodegenTrimSegments, At as highlighter, B as runConfiguredCodegen, C as isEntryPoint, Ct as formatDependencyInstallCommand, D as parseInitCommandArgs, E as parseBackendRunJson, Et as stripConvexCommandNoise, F as resolveRunDeps, G as runMigrationFlow, H as runDevSchemaBackfillIfNeeded, I as runAfterScaffoldScript, J as withWorkingDirectory, K as trackProcess, L as runAggregateBackfillFlow, M as resolveDocTopic, N as resolveInitProjectDir, O as readPackageVersions, P as resolveMigrationConfig, Q as promptForPluginSelection, R as runAggregatePruneFlow, S as isConvexDevPreRunConflictFlag, St as detectPackageManager, T as parseArgs, Tt as serializeEnvValue, U as runInitCommandFlow, V as runConvexInitIfNeeded, W as runMigrationCreate, X as collectPluginScaffoldTemplates, Y as createSpinner, Z as filterScaffoldTemplatePathMap, _ as formatInfoOutput, _t as applyPlanningDependencyInstall, a as cleanup, at as getPluginCatalogEntry, b as getDevAggregateBackfillStatePath, bt as resolveSupportedDependencyWarnings, c as createCommandEnv, ct as buildPluginInstallPlan, d as extractBackfillCliOptions, dt as collectInstalledPluginKeys, et as resolveAddTemplateDefaults, f as extractConcaveRunTargetArgs, ft as getPluginLockfilePath, g as formatDocsOutput, gt as applyDependencyHintsInstall, h as extractResetCliOptions, ht as resolveSchemaInstalledPlugins, i as buildInitializationPlan, it as resolveTemplatesByIdOrThrow, j as resolveConfiguredBackend, k as resolveBackfillConfig, kt as logger, l as ensureConvexGitignoreEntry, lt as resolvePluginScaffoldRoots, m as extractMigrationDownOptions, mt as readPluginLockfile, n as applyPluginInstallPlanFiles, nt as resolvePresetScaffoldTemplates, o as createBackendAdapter, ot as getSupportedPluginKeys, p as extractMigrationCliOptions, pt as getSchemaFilePath, q as withLocalCodegenEnv, r as assertNoRemovedDevPreRunFlag, rt as resolveTemplateSelectionSource, s as createBackendCommandEnv, st as isSupportedPluginKey, t as applyDependencyInstallPlan, tt as resolvePluginPreset, u as extractBackendRunTargetArgs, ut as assertSchemaFileExists, v as getAggregateBackfillDeploymentKey, vt as applyPluginDependencyInstall, w as isInitialized, wt as resolveAuthEnvState, x as hasRemoteConvexDeploymentEnv, xt as resolveProjectScaffoldContext, y as getConvexDeploymentCommandEnv, yt as inspectPluginDependencyInstall, z as runBackendFunction } from "./backend-core-CRJpuVnf.mjs";
 import fs, { existsSync, readFileSync } from "node:fs";
 import path, { delimiter, dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/{generated-contract-disabled-0xEF3NtW.d.ts → generated-contract-disabled-3mwCSv2F.d.ts}

@@ -173,10 +173,18 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
     };
   }, Promise<any>>;
   deleteMany: convex_server0.RegisteredMutation<"internal", {
+    paginationOpts: {
+      id?: number;
+      endCursor?: string | null;
+      maximumRowsRead?: number;
+      maximumBytesRead?: number;
+      numItems: number;
+      cursor: string | null;
+    };
     input: {
       where?: {
+        operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
         connector?: "AND" | "OR" | undefined;
-        operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
         value: string | number | boolean | string[] | number[] | null;
         field: string;
       }[] | undefined;
@@ -185,14 +193,6 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
       where?: any[] | undefined;
       model: string;
     };
-    paginationOpts: {
-      id?: number;
-      endCursor?: string | null;
-      maximumRowsRead?: number;
-      maximumBytesRead?: number;
-      numItems: number;
-      cursor: string | null;
-    };
   }, Promise<{
     count: number;
     ids: any[];
@@ -204,8 +204,8 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
   deleteOne: convex_server0.RegisteredMutation<"internal", {
     input: {
       where?: {
+        operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
         connector?: "AND" | "OR" | undefined;
-        operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
         value: string | number | boolean | string[] | number[] | null;
         field: string;
       }[] | undefined;
@@ -216,21 +216,20 @@ 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;
+      operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
       connector?: "AND" | "OR" | undefined;
-      operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
       value: string | number | boolean | string[] | number[] | null;
       field: string;
     }[] | undefined;
-    limit?: number | undefined;
     offset?: number | undefined;
     sortBy?: {
       field: string;
       direction: "asc" | "desc";
     } | undefined;
-    model: string;
     paginationOpts: {
       id?: number;
       endCursor?: string | null;
@@ -239,47 +238,48 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
       numItems: number;
       cursor: string | null;
     };
+    model: string;
   }, Promise<convex_server0.PaginationResult<convex_server0.GenericDocument>>>;
   findOne: convex_server0.RegisteredQuery<"internal", {
     join?: any;
-    select?: string[] | undefined;
     where?: {
       mode?: "sensitive" | "insensitive" | undefined;
+      operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
       connector?: "AND" | "OR" | undefined;
-      operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
       value: string | number | boolean | string[] | number[] | null;
       field: string;
     }[] | undefined;
+    select?: string[] | undefined;
     model: string;
   }, Promise<convex_server0.GenericDocument | null>>;
   getLatestJwks: convex_server0.RegisteredAction<"internal", {}, Promise<unknown>>;
   rotateKeys: convex_server0.RegisteredAction<"internal", {}, Promise<unknown>>;
   updateMany: convex_server0.RegisteredMutation<"internal", {
+    paginationOpts: {
+      id?: number;
+      endCursor?: string | null;
+      maximumRowsRead?: number;
+      maximumBytesRead?: number;
+      numItems: number;
+      cursor: string | null;
+    };
     input: {
       where?: {
+        operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
         connector?: "AND" | "OR" | undefined;
-        operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
         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;
-    };
-    paginationOpts: {
-      id?: number;
-      endCursor?: string | null;
-      maximumRowsRead?: number;
-      maximumBytesRead?: number;
-      numItems: number;
-      cursor: string | null;
+      model: string;
     };
   }, Promise<{
     count: number;
@@ -292,21 +292,21 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
   updateOne: convex_server0.RegisteredMutation<"internal", {
     input: {
       where?: {
+        operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
         connector?: "AND" | "OR" | undefined;
-        operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
         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/orm/index.d.ts

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

package/dist/watcher.mjs

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

package/dist/{where-clause-compiler-CgQj3ZHP.d.ts → where-clause-compiler-Dc58we_m.d.ts}

@@ -3990,11 +3990,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
   readonly aggregate_extrema: ConvexTableWithColumns<{
     name: "aggregate_extrema";
     columns: {
-      value: ConvexCustomBuilderInitial<"", convex_values0.VAny<any, "required", string>> & {
-        _: {
-          $type: convex_values0.Value;
-        };
-      } & {
+      count: ConvexNumberBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -4004,10 +4000,14 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "value";
+          fieldName: "count";
         };
       };
-      count: ConvexNumberBuilderInitial<""> & {
+      value: ConvexCustomBuilderInitial<"", convex_values0.VAny<any, "required", string>> & {
+        _: {
+          $type: convex_values0.Value;
+        };
+      } & {
         _: {
           notNull: true;
         };
@@ -4017,7 +4017,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "count";
+          fieldName: "value";
         };
       };
       updatedAt: ConvexNumberBuilderInitial<""> & {
@@ -4409,22 +4409,22 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
           fieldName: "status";
         };
       };
-      cursor: ConvexTextBuilderInitial<""> & {
+      direction: ConvexTextBuilderInitial<""> & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "cursor";
+          fieldName: "direction";
         };
       };
-      direction: ConvexTextBuilderInitial<""> & {
+      cursor: ConvexTextBuilderInitial<""> & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "direction";
+          fieldName: "cursor";
         };
       };
       updatedAt: ConvexNumberBuilderInitial<""> & {

package/package.json

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

package/skills/kitcn/SKILL.md

@@ -1,8 +1,7 @@
 ---
 name: kitcn
-description: ALWAYS use this skill when working with convex or kitcn. Covers both setup and e2e feature paths using cRPC + ORM + auth + React.
+description: "Use for Convex/kitcn setup and feature work: cRPC, ORM, auth, React."
 sources: [www/content/docs/concepts.mdx, www/content/docs/orm/index.mdx, www/content/docs/orm/schema/relations.mdx, www/content/docs/orm/schema/triggers.mdx, www/content/docs/orm/queries/aggregates.mdx, www/content/docs/orm/queries/pagination.mdx, www/content/docs/server/error-handling.mdx, www/content/docs/server/http.mdx, www/content/docs/server/middlewares.mdx, www/content/docs/server/procedures.mdx, www/content/docs/server/server-side-calls.mdx, www/content/docs/react/queries.mdx, www/content/docs/react/mutations.mdx, www/content/docs/react/infinite-queries.mdx, www/content/docs/auth/client.mdx, www/content/docs/auth/server.mdx]
-metadata: { sources: [www/content/docs/concepts.mdx, www/content/docs/orm/index.mdx, www/content/docs/orm/schema/relations.mdx, www/content/docs/orm/schema/triggers.mdx, www/content/docs/orm/queries/aggregates.mdx, www/content/docs/orm/queries/pagination.mdx, www/content/docs/server/error-handling.mdx, www/content/docs/server/http.mdx, www/content/docs/server/middlewares.mdx, www/content/docs/server/procedures.mdx, www/content/docs/server/server-side-calls.mdx, www/content/docs/react/queries.mdx, www/content/docs/react/mutations.mdx, www/content/docs/react/infinite-queries.mdx, www/content/docs/auth/client.mdx, www/content/docs/auth/server.mdx] }
 ---
 # kitcn Core Skill (80% Path)
 Use this file first for everyday feature delivery in an already configured kitcn app.
@@ -25,7 +24,7 @@ Out of scope:
 4. Use `CRPCError` for expected failures.
 5. Prefer schema triggers for cross-row invariants, but move invariant maintenance to explicit mutation helpers if trigger execution is unstable (for example init/seed hangs or recursive write paths).
 6. Keep auth/rate-limit checks server-side.
-7. **Inter-procedure calls**: `create<Module>Handler(ctx)` in queries/mutations (zero overhead) unless validation is relevant, `create<Module>Caller(ctx)` in actions/HTTP routes. In action context use `caller.actions.*` for action procedures and `caller.schedule.*` for scheduling. Import from `./generated/<module>.runtime`. Never call `ctx.runQuery`/`ctx.runMutation`/`ctx.runAction` directly for module procedures.
+7. **Inter-procedure calls**: use generated runtime helpers: `create<Module>Handler(ctx)` in queries/mutations, `create<Module>Caller(ctx)` in actions/HTTP routes, `caller.actions.*` for action procedures, and `caller.schedule.*` for scheduling. Never call `ctx.runQuery`/`ctx.runMutation`/`ctx.runAction` directly for module procedures.
 ## Shortcut Mode (tRPC + Drizzle Mental Model)
 Default assumption:
 - cRPC behavior is tRPC-like (builder chain + middleware + TanStack options).
@@ -50,9 +49,9 @@ Only remember these non-parity deltas:
 17. In RSC, `prefetch` hydrates client, `caller` is server-only and not hydrated, `preloadQuery` hydrates but can cause stale split ownership if also rendered client-side.
 18. Better Auth Next.js shortcut is `convexBetterAuth(...)`; generic server-only shortcut is `createCallerFactory(...)`.
 19. On the kitcn auth client path, use `createAuthMutations(authClient)` wrappers so logout unsubscribes auth queries before sign out. Raw Convex preset keeps a smaller plain `authClient`.
-20. **NEVER** use `ctx.runQuery`/`ctx.runMutation`/`ctx.runAction` directly for module-to-module calls. Use `create<Module>Handler(ctx)` or `create<Module>Caller(ctx)` from `convex/functions/generated/<module>.runtime` instead.
-21. **`create<Module>Handler(ctx)`** — default choice for queries/mutations. Bypasses input validation, middleware, output validation → zero overhead. Query/mutation ctx only. Import from `./generated/<module>.runtime`.
-22. **`create<Module>Caller(ctx)`** — use in actions and HTTP routes (where handler is unavailable). Goes through validation + middleware. Root caller exposes query+mutation procedures. In `ActionCtx`, action procedures are under `caller.actions.*`; scheduling is under `caller.schedule.now|after|at` with `caller.schedule.cancel(id)`. Use `requireActionCtx(ctx)` only when the callback truly runs in `ActionCtx` and you need `caller.actions.*`. If the callback can run from `MutationCtx | ActionCtx` or generic scheduler-capable context, keep the seam honest: use `requireSchedulerCtx(ctx)` and `caller.schedule.*` instead of pretending the path is action-only. Import from `./generated/<module>.runtime`. Each caller/handler eagerly loads every procedure in its module (no lazy loading) — split large modules to keep bundles lean.
+20. **NEVER** use `ctx.runQuery`/`ctx.runMutation`/`ctx.runAction` directly for module-to-module calls. Use the generated runtime helpers from `convex/functions/generated/<module>.runtime`.
+21. **`create<Module>Handler(ctx)`** is the default in queries/mutations: zero overhead, query/mutation ctx only, and no redundant validation or middleware.
+22. **`create<Module>Caller(ctx)`** is for actions and HTTP routes. Action procedures live under `caller.actions.*`; scheduling lives under `caller.schedule.now|after|at|cancel`. Use `requireActionCtx(ctx)` only for true `ActionCtx` callbacks; use `requireSchedulerCtx(ctx)` when mutation or action contexts can schedule. Each caller/handler eagerly loads its module, so split large modules.
 23. API types (`Api`, `ApiInputs`, `ApiOutputs`, `Select`, `Insert`, `TableName`) import from `@convex/api` — no manual `inferApiInputs<typeof api>`.
 24. HTTP router must export as `httpRouter` (not `appRouter`) for codegen.
 25. Server wiring imports come from `convex/functions/generated/` directory: `getAuth`, `defineAuth` from `generated/auth`; `initCRPC`, `QueryCtx`, `MutationCtx`, `OrmCtx` from `generated/server`; `create<Module>Caller`, `create<Module>Handler` from `generated/<module>.runtime`. No manual `convex/lib/orm.ts`.
@@ -61,7 +60,7 @@ Only remember these non-parity deltas:
 28. Async mutation batching is the default (codegen wires it). Customize per call: `execute({ batchSize, delayMs })`. Opt into sync: `execute({ mode: 'sync' })` or `defineSchema(..., { defaults: { mutationExecutionMode: 'sync' } })`. Relevant defaults: `mutationBatchSize`, `mutationLeafBatchSize`, `mutationMaxRows`, `mutationScheduleCallCap`.
 29. Polymorphic unions are schema-first: use `actionType: discriminator({ variants, as? })` in `convexTable(...)`. Query config does not include a `polymorphic` option. Writes stay flat; reads synthesize nested `details` (or custom alias). Use `withVariants: true` to auto-load all `one()` relations on discriminator tables.
 30. Do not add manual ORM mutation batching loops in app/plugin code by default. Convex runtime batching already handles mutation execution. Prefer set-based deletes/updates over per-row loops. Only add explicit chunking when batching external side effects (for example Resend API calls) or bounded cleanup sweeps.
-## Directory Boundary (Important)
+## Directory Boundary
 Use `references/setup/` when the task needs:
 1. Project/file structure setup → `setup/index.md` + `setup/server.md`
 2. Auth bootstrap → `setup/auth.md`

package/skills/kitcn/references/features/auth-admin.md

@@ -425,22 +425,6 @@ const canDelete = authClient.admin.checkRolePermission({
 
 ## API Reference
 
-| Operation | Method | Admin Required |
-|-----------|--------|----------------|
-| Create user | `authClient.admin.createUser` | Yes |
-| List users | `authClient.admin.listUsers` | Yes |
-| Set role | `authClient.admin.setRole` | Yes |
-| Set password | `authClient.admin.setUserPassword` | Yes |
-| Update user | `authClient.admin.updateUser` | Yes |
-| Ban user | `authClient.admin.banUser` | Yes |
-| Unban user | `authClient.admin.unbanUser` | Yes |
-| List sessions | `authClient.admin.listUserSessions` | Yes |
-| Revoke session | `authClient.admin.revokeUserSession` | Yes |
-| Revoke all sessions | `authClient.admin.revokeUserSessions` | Yes |
-| Impersonate | `authClient.admin.impersonateUser` | Yes |
-| Stop impersonating | `authClient.admin.stopImpersonating` | Yes |
-| Remove user | `authClient.admin.removeUser` | Yes |
-| Check permission | `authClient.admin.hasPermission` | No |
-| Check role permission | `authClient.admin.checkRolePermission` | No |
-
-Use Convex functions for custom admin operations. Use Better Auth client API for standard operations like user management, banning, and session management.
+Use Better Auth client admin methods for standard user management, roles,
+passwords, bans, sessions, impersonation, removal, and permission checks. Use
+Convex functions only for custom admin operations.

package/skills/kitcn/references/features/auth-organizations.md

@@ -1127,24 +1127,6 @@ await authClient.organization.setActiveTeam({ teamId });
 
 ## API Reference
 
-| Operation          | Method          | Multi-table |
-| ------------------ | --------------- | ----------- |
-| Create org         | Better Auth API | Yes         |
-| Update org         | Better Auth API | No          |
-| Delete org         | Better Auth API | Yes         |
-| List orgs          | ORM             | No          |
-| Check slug         | ORM             | No          |
-| Invite member      | Better Auth API | Yes         |
-| Accept invite      | Better Auth API | Yes         |
-| Reject invite      | Better Auth API | Yes         |
-| Cancel invite      | Better Auth API | Yes         |
-| List user invites  | ORM             | No          |
-| Add member         | Better Auth API | Yes         |
-| Update role        | Better Auth API | Yes         |
-| Remove member      | Better Auth API | Yes         |
-| Leave org          | Better Auth API | Yes         |
-| Create team        | Better Auth API | Yes         |
-| Add team member    | Better Auth API | Yes         |
-| Remove team member | Better Auth API | Yes         |
-
-Use Better Auth API for multi-table operations. Use `ctx.orm` for simple single-table reads/updates.
+Use Better Auth API for multi-table org, invitation, member, role, and team
+operations. Use `ctx.orm` for simple single-table reads such as list orgs,
+check slug, and list user invitations.

package/skills/kitcn/references/features/auth-polar.md

@@ -561,19 +561,8 @@ Example-parity helper module:
 
 ## API Reference
 
-| Operation | Method | Type |
-|-----------|--------|------|
-| Checkout | `authClient.checkout` | Client |
-| Customer portal | `authClient.customer.portal` | Client |
-| Customer state | `authClient.customer.state` | Client |
-| List benefits | `authClient.customer.benefits.list` | Client |
-| List orders | `authClient.customer.orders.list` | Client |
-| List subscriptions | `authClient.customer.subscriptions.list` | Client |
-| Event ingestion | `authClient.usage.ingestion` | Client |
-| List meters | `authClient.usage.meters.list` | Client |
-| Create customer | `internal.polarCustomer.createCustomer` | Internal action |
-| Link customer ID | `internal.polarCustomer.updateUserPolarCustomerId` | Internal mutation |
-| Create subscription | `internal.polarSubscription.createSubscription` | Internal mutation |
-| Update subscription | `internal.polarSubscription.updateSubscription` | Internal mutation |
-| Cancel subscription | Convex action | User action |
-| Resume subscription | Convex action | User action |
+Client operations: checkout, portal, customer state, benefits, orders,
+subscriptions, usage ingestion, and meter listing.
+
+Internal operations: create/link Polar customers and create/update
+subscriptions. User-facing cancellation/resume flows should be Convex actions.

package/skills/kitcn/references/features/auth.md

@@ -501,12 +501,8 @@ Auth triggers (`defineAuth(...).triggers`) handle auth lifecycle events. DB trig
 
 Nested `{ create, update, delete, change }` per table, matching ORM `defineTriggers` pattern:
 
-| Hook | Signature | Return |
-|------|-----------|--------|
-| `create.before` | `(data, ctx) => void \| { data } \| false` | Merge / cancel |
-| `create.after` | `(doc, ctx) => void` | Side effects |
-| `update.before` | `(update, ctx) => void \| { data } \| false` | Merge / cancel |
-| `update.after` | `(newDoc, ctx) => void` | Sync changes |
-| `delete.before` | `(doc, ctx) => void \| { data } \| false` | Guard / cancel |
-| `delete.after` | `(doc, ctx) => void` | Cleanup |
-| `change` | `(change, ctx) => void` | Cross-operation |
+- `create.before(data, ctx)` / `update.before(update, ctx)` /
+  `delete.before(doc, ctx)` may return `{ data }` or `false`.
+- `create.after(doc, ctx)`, `update.after(newDoc, ctx)`, and
+  `delete.after(doc, ctx)` run side effects.
+- `change(change, ctx)` handles cross-operation sync.

package/skills/kitcn/references/features/http.md

@@ -617,60 +617,32 @@ if (ctx.isAuthenticated) await ctx.caller.todos.create({ title: "New task" });
 
 ### Route Builder Patterns
 
-| Pattern                                  | Use Case                 |
-| ---------------------------------------- | ------------------------ |
-| `publicRoute.get('/path').query()`       | Public GET endpoint      |
-| `authRoute.post('/path').mutation()`     | Auth-required POST       |
-| `optionalAuthRoute.get('/path').query()` | Optional auth endpoint   |
-| `.params(z.object({id}))`                | Path params `/todos/:id` |
-| `.searchParams(z.object({limit}))`       | Query params `?limit=10` |
-| `.input(z.object({...}))`                | JSON body (POST/PATCH)   |
-| `.form(z.object({file, description}))`   | FormData uploads         |
-| `.output(z.object({...}))`               | Response validation      |
-| `.meta({ ratelimit: 'api/heavy' })`      | Procedure metadata       |
-| `.use(middleware)`                       | Custom middleware        |
-| `router({ endpoint1, endpoint2 })`       | Group endpoints          |
+- `publicRoute.get("/path").query()` for public GET.
+- `authRoute.post("/path").mutation()` for authenticated writes.
+- `optionalAuthRoute.get("/path").query()` for optional-auth reads.
+- Chain `.params(...)`, `.searchParams(...)`, `.input(...)`, `.form(...)`,
+  `.output(...)`, `.meta(...)`, and `.use(...)` as needed.
+- Use `router({ endpoint })` for feature-level endpoint groups.
 
 ### HTTP Methods
 
-| Method | Builder                | Use Case          | Has Body |
-| ------ | ---------------------- | ----------------- | -------- |
-| GET    | `.get().query()`       | Read operations   | No       |
-| POST   | `.post().mutation()`   | Create operations | Yes      |
-| PATCH  | `.patch().mutation()`  | Partial updates   | Yes      |
-| DELETE | `.delete().mutation()` | Delete operations | No       |
+Use `.get().query()` for reads, `.post().mutation()` for creates,
+`.patch().mutation()` for partial updates, and `.delete().mutation()` for
+deletes. GET/DELETE should not carry JSON bodies.
 
 ### Error Codes
 
-| Code                    | HTTP Status | Use Case                          |
-| ----------------------- | ----------- | --------------------------------- |
-| `BAD_REQUEST`           | 400         | Invalid request format            |
-| `UNAUTHORIZED`          | 401         | Missing or invalid authentication |
-| `FORBIDDEN`             | 403         | Authenticated but not authorized  |
-| `NOT_FOUND`             | 404         | Resource doesn't exist            |
-| `CONFLICT`              | 409         | Resource conflict (duplicate)     |
-| `UNPROCESSABLE_CONTENT` | 422         | Validation failed                 |
-| `TOO_MANY_REQUESTS`     | 429         | Rate limit exceeded               |
-| `INTERNAL_SERVER_ERROR` | 500         | Unexpected server error           |
+Map expected failures through `CRPCError`: `BAD_REQUEST` 400, `UNAUTHORIZED`
+401, `FORBIDDEN` 403, `NOT_FOUND` 404, `CONFLICT` 409,
+`UNPROCESSABLE_CONTENT` 422, `TOO_MANY_REQUESTS` 429, and
+`INTERNAL_SERVER_ERROR` 500.
 
 ### Input Args
 
-| Property       | Type                                    | Description                           |
-| -------------- | --------------------------------------- | ------------------------------------- |
-| `params`       | `Record<string, string>`                | Path parameters (`:id`)               |
-| `searchParams` | `Record<string, string \| string[]>`    | Query string params                   |
-| `form`         | `z.infer<TForm>`                        | Typed FormData (if `.form()` defined) |
-| `fetch`        | `typeof fetch`                          | Custom fetch function                 |
-| `init`         | `RequestInit`                           | Request options                       |
-| `headers`      | `Record<string, string> \| (() => ...)` | Headers (incl. cookies)               |
-| `[key]`        | `unknown`                               | JSON body fields at root              |
+Client args can include `params`, `searchParams`, `form`, custom `fetch`,
+`init`, `headers`, and root JSON body fields.
 
 ### Client Methods
 
-| Method               | Signature             | Description                               |
-| -------------------- | --------------------- | ----------------------------------------- |
-| `queryOptions`       | `(args?, queryOpts?)` | Options for `useQuery`/`useSuspenseQuery` |
-| `staticQueryOptions` | `(args?, queryOpts?)` | For event handlers/prefetching (no hooks) |
-| `mutationOptions`    | `(mutationOpts?)`     | Options for `useMutation`                 |
-| `queryKey`           | `(args?)`             | Get query key for cache operations        |
-| `queryFilter`        | `(args?, filters?)`   | Filter for `invalidateQueries`            |
+Generated clients expose `queryOptions`, `staticQueryOptions`,
+`mutationOptions`, `queryKey`, and `queryFilter`.

package/skills/kitcn/references/features/orm.md

@@ -1120,56 +1120,34 @@ export default defineSchema(tables, {
 
 ### Column Types
 
-All from `kitcn/orm`:
-
-| Builder                         | TS Type       | Convex                 | Notes                                      |
-| ------------------------------- | ------------- | ---------------------- | ------------------------------------------ |
-| `text()`                        | `string`      | `v.string()`           |                                            |
-| `textEnum(['a','b'] as const)`  | `'a' \| 'b'`  | `v.string()`           | Runtime-validated                          |
-| `integer()`                     | `number`      | `v.number()`           | Float64                                    |
-| `boolean()`                     | `boolean`     | `v.boolean()`          |                                            |
-| `bigint()`                      | `bigint`      | `v.int64()`            |                                            |
-| `timestamp()`                   | `Date`        | `v.number()`           | `.defaultNow()` for createdAt              |
-| `timestamp({ mode: 'string' })` | `string`      | `v.number()`           |                                            |
-| `date()`                        | `string`      | `v.string()`           | YYYY-MM-DD, or `{ mode: 'date' }` → `Date` |
-| `id('table')`                   | `Id<'table'>` | `v.id('table')`        | Typed reference                            |
-| `vector(dims)`                  | `number[]`    | `v.array(v.float64())` | For vectorIndex                            |
-| `bytes()`                       | `ArrayBuffer` | `v.bytes()`            |                                            |
-| `unionOf(text(), integer())`    | `string \| number` | `v.union(...)`    | Builder-only scalar union sugar            |
-| `objectOf(text().notNull())`    | `Record<string, string>` | `v.record(...)` | Homogeneous record values                  |
-| `json<T>()`                     | `T`           | `v.any()`              | Type-only, no runtime validation           |
-| `custom(validator)`             | inferred      | any `v.*`              | Full Convex validator                      |
+All come from `kitcn/orm`: `text`, `textEnum`, `integer`, `boolean`,
+`bigint`, `timestamp`, `date`, `id`, `vector`, `bytes`, `unionOf`, `objectOf`,
+`json`, and `custom`.
+
+Key type notes: `timestamp()` stores Convex numbers and exposes `Date`;
+`timestamp({ mode: "string" })` exposes `string`; `date()` is YYYY-MM-DD unless
+`{ mode: "date" }`; `json<T>()` is type-only over `v.any()`; `custom(...)`
+keeps the provided Convex validator.
 
 ### Operators
 
-| Category            | Operators                                                                    |
-| ------------------- | ---------------------------------------------------------------------------- |
-| Comparison          | `eq`, `ne`, `gt`, `gte`, `lt`, `lte`                                         |
-| Range               | `between` (inclusive), `notBetween` (strict outside)                         |
-| Set                 | `in`, `notIn`                                                                |
-| Null                | `isNull`, `isNotNull`                                                        |
-| Logical             | `AND`, `OR`, `NOT`                                                           |
-| String (post-fetch) | `like`, `ilike`, `notLike`, `notIlike`, `startsWith`, `endsWith`, `contains` |
-| Array (post-fetch)  | `arrayContains`, `arrayContained`, `arrayOverlaps`                           |
+- Comparison: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`
+- Range/set/null: `between`, `notBetween`, `in`, `notIn`, `isNull`, `isNotNull`
+- Logical: `AND`, `OR`, `NOT`
+- Post-fetch string/array: `like`, `ilike`, `notLike`, `notIlike`,
+  `startsWith`, `endsWith`, `contains`, `arrayContains`, `arrayContained`,
+  `arrayOverlaps`
 
 ### Select Composition Limitations
 
-| Combination               | Status        |
-| ------------------------- | ------------- |
-| `select() + search`       | Not supported |
-| `select() + vectorSearch` | Not supported |
-| `select() + offset`       | Not supported |
-| `select() + with`         | Not supported |
-| `select() + extras`       | Not supported |
-| `select() + columns`      | Not supported |
+Do not combine `select()` with `search`, `vectorSearch`, `offset`, `with`,
+`extras`, or `columns`.
 
 ### Full-Scan Operator Workarounds
 
-| Operator                           | Scalable workaround                                |
-| ---------------------------------- | -------------------------------------------------- |
-| `arrayContains/Contained/Overlaps` | Inverted/join table keyed by element               |
-| `contains`                         | `withSearchIndex` or tokenized denormalized field  |
-| `endsWith`                         | Store reversed column, use `startsWith`            |
-| `ilike`/`notIlike`                 | Lowercase column + `startsWith`/`like('prefix%')`  |
-| `notLike`                          | Indexed positive pre-filter + `notLike` post-fetch |
-| `NOT` (general)                    | Rewrite to positive predicates; cap with `maxScan` |
+- Array membership/overlap: use an inverted or join table keyed by element.
+- `contains`: use `withSearchIndex` or tokenized denormalized fields.
+- `endsWith`: store a reversed column and query with `startsWith`.
+- `ilike` / `notIlike`: lowercase a query column and use prefix/like filters.
+- `notLike` and general `NOT`: rewrite to positive indexed predicates and cap
+  fallback scans with `maxScan`.

package/skills/kitcn/references/features/react.md

@@ -657,11 +657,6 @@ Don't render `preloadQuery` data in BOTH Server and Client components — the se
 
 ### Infinite Query Return Value
 
-| Property | Type | Description |
-|----------|------|-------------|
-| `data` | `T[]` | Flattened array of all items |
-| `pages` | `T[][]` | Raw page arrays |
-| `fetchNextPage` | `(limit?) => void` | Load next page |
-| `hasNextPage` | `boolean` | More pages exist |
-| `status` | `PaginationStatus` | `'LoadingFirstPage' \| 'LoadingMore' \| 'CanLoadMore' \| 'Exhausted'` |
-| `isPlaceholderData` | `boolean` | Showing placeholder |
+Return fields: flattened `data`, raw `pages`, `fetchNextPage(limit?)`,
+`hasNextPage`, `status`, and `isPlaceholderData`. Status is one of
+`LoadingFirstPage`, `LoadingMore`, `CanLoadMore`, or `Exhausted`.

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

@@ -728,58 +728,19 @@ Then sanity-check auth runtime paths:
 16. Phase A gate (Section 11.2) passes before any auth implementation.
 17. If auth enabled: Phase B auth sign-in gate (Section 11.3) passes before optional modules/plugins.
 18. No legacy Ents patterns in setup code.
-19. NEVER use `@ts-nocheck` in app/convex source files.
+19. Do not use `@ts-nocheck` in app/convex source files.
 
 ## 13. Troubleshooting
 
 See the [Troubleshooting Reference](#troubleshooting-reference) at the bottom of this document for the full symptom/cause/fix matrix.
 
-## Coverage Matrix
-
-Source coverage mapping used to build this runbook:
-
-| Source                                            | Mapped In Setup      |
-| ------------------------------------------------- | -------------------- |
-| `www/content/docs/cli/registry.mdx`               | Sections 3, 11       |
-| `www/content/docs/quickstart.mdx`                 | Sections 3, 4, 11, 12 |
-| `www/content/docs/server/setup.mdx`               | Section 5.3          |
-| `www/content/docs/auth/server.mdx`                | Sections 6.1 - 6.10  |
-| `www/content/docs/auth/client.mdx`                | Section 7.1          |
-| `www/content/docs/auth/server.mdx#triggers`       | Section 6.3, 9.2     |
-| `www/content/docs/react/index.mdx`                | Sections 7.2 - 7.4   |
-| `www/content/docs/nextjs/index.mdx`               | Section 8.A          |
-| `www/content/docs/tanstack-start.mdx`             | Section 8.B          |
-| `www/content/docs/server/http.mdx`                | Sections 6.6, 9.6    |
-| `www/content/docs/server/server-side-calls.mdx`   | Section 8.A.1, 8.B.3 |
-| `www/content/docs/plugins/ratelimit.mdx`          | Section 9.4          |
-| `www/content/docs/orm/queries/aggregates.mdx`     | Section 9.3          |
-| `www/content/docs/server/scheduling.mdx`          | Section 9.5          |
-| `www/content/docs/orm/queries/index.mdx`          | Sections 5, 12       |
-| `www/content/docs/orm/mutations/index.mdx`        | Sections 5, 12       |
-| `www/content/docs/orm/triggers.mdx`               | Sections 9.2, 9.3    |
-| `www/content/docs/orm/rls.mdx`                    | Section 9.1          |
-| `www/content/docs/auth/plugins/admin.mdx`         | Section 10.1         |
-| `www/content/docs/auth/plugins/organizations.mdx` | Section 10.2         |
-| `www/content/docs/auth/plugins/polar.mdx`         | Section 10.3         |
-| `www/content/docs/cli/backend.mdx`                | Section 11           |
-
-### Template Coverage (Recreation Target)
-
-This runbook + references map to the canonical template shape as follows:
-
-| Example Group                                                                                             | Primary Setup Section           | Additional Reference                     |
-| --------------------------------------------------------------------------------------------------------- | ------------------------------- | ---------------------------------------- |
-| Core infra (`schema.ts`, `functions/generated/`, `crpc.ts`, `http.ts`)                                    | Sections 5, 6.6, 9.6            | `orm.md`, `http.md`                      |
-| Shared contracts (`shared/api.ts`, `shared/auth-shared.ts`, `shared/polar-shared.ts`)                     | Sections 5.4, 6.3.2, 10.2, 10.3 | `auth-organizations.md`                  |
-| Auth core (`auth.config.ts`, `auth.ts`)                                                                   | Section 6                       | `auth.md`                                |
-| Auth plugins (`admin.ts`, `organization.ts`, `polar*`)                                                    | Section 10                      | `auth-admin.md`, `auth-organizations.md` |
-| Feature modules (`user.ts`, `projects.ts`, `tags.ts`, `todoComments.ts`, `public.ts`, `items/queries.ts`) | Sections 5, 6.3.1, 9            | core `SKILL.md`, `orm.md`                |
-| HTTP routers (`routers/health.ts`, `routers/todos.ts`, `routers/examples.ts`)                             | Section 9.6                     | `http.md`                                |
-| Aggregates + rate limits (`aggregates.ts`, `lib/plugins/ratelimit/plugin.ts`)                             | Sections 9.3, 9.4               | `aggregates.md`, `orm.md`                |
-| Scheduling + internals (`todoInternal.ts`, delayed jobs)                                                  | Sections 9.5, 11.1              | `scheduling.md`                          |
-| Email + Resend (`functions/plugins/email.tsx`, `lib/plugins/resend/*`)                                    | Section 9.7                     | `auth-organizations.md`                  |
-| Dev bootstrap (`init.ts`, `seed.ts`, `reset.ts`)                                                          | Section 11.1                    | `testing.md` (for verification)          |
-| Generated outputs (`functions/_generated/*`, `functions/generated/`, `shared/api.ts`)                     | Section 5.5                     | n/a (generated by CLI)                   |
+## Coverage Notes
+
+This setup runbook compresses the CLI registry, quickstart, server setup,
+auth, React, Next.js, TanStack Start, HTTP, scheduling, aggregate, ORM,
+RLS/trigger, plugin, and backend CLI docs. Use the feature references for
+domain depth: `orm.md`, `http.md`, `react.md`, `aggregates.md`,
+`scheduling.md`, `testing.md`, `auth*.md`, and `create-plugins.md`.
 
 ## Troubleshooting Reference