kitcn 0.15.7 → 0.15.9

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/react/index.d.ts

@@ -39,6 +39,9 @@ declare function isAuthMutationError(error: unknown): error is AuthMutationError
 //#endregion
 //#region src/react/auth-mutations.d.ts
 type MutationOptionsHook<TData, TVariables = void> = (options?: Omit<UseMutationOptions<TData, DefaultError, TVariables>, 'mutationFn'>) => UseMutationOptions<TData, DefaultError, TVariables>;
+type SignInMutationOptionsHook<TData, TVariables = void> = (options?: Omit<UseMutationOptions<TData, DefaultError, TVariables>, 'mutationFn'> & {
+  signInMethod?: string;
+}) => UseMutationOptions<TData, DefaultError, TVariables>;
 type AnyAuthFn = (...args: never[]) => unknown;
 type MutationArgsWithFetchOptions = {
   fetchOptions?: Record<string, unknown>;
@@ -72,8 +75,9 @@ type AuthClient = {
   signOut?: AnyAuthFn;
   signIn?: {
     anonymous?: AnyAuthFn;
-    social?: AnyAuthFn;
     email?: AnyAuthFn;
+    social?: AnyAuthFn;
+    [method: string]: AnyAuthFn | undefined;
   };
   signUp?: {
     email?: AnyAuthFn;
@@ -105,7 +109,7 @@ type AuthClient = {
 type AuthMutationsResult = {
   useSignOutMutationOptions: MutationOptionsHook<unknown, MutationArgsWithFetchOptions | void>;
   useSignInSocialMutationOptions: MutationOptionsHook<unknown, unknown>;
-  useSignInMutationOptions: MutationOptionsHook<unknown, unknown>;
+  useSignInMutationOptions: SignInMutationOptionsHook<unknown, unknown>;
   useSignUpMutationOptions: MutationOptionsHook<unknown, unknown>;
 };
 declare function createAuthMutations(authClient: AuthClient): AuthMutationsResult;

package/dist/react/index.js

@@ -1574,12 +1574,13 @@ function createAuthMutations(authClient) {
 	const useSignInMutationOptions = ((options) => {
 		const authStoreApi = useAuthStore();
 		const convexQueryClient = useConvexQueryClient();
+		const { signInMethod = "email", ...mutationOptions } = options ?? {};
 		return {
-			...options,
+			...mutationOptions,
 			mutationFn: async (args) => {
-				const signInEmail = authClient.signIn?.email;
-				if (typeof signInEmail !== "function") throw new Error("Auth client does not expose signIn.email");
-				const res = await callAuthMethod(signInEmail, withDisabledSessionSignal(args));
+				const signIn = authClient.signIn?.[signInMethod];
+				if (typeof signIn !== "function") throw new Error(`Auth client does not expose signIn.${signInMethod}`);
+				const res = await callAuthMethod(signIn, withDisabledSessionSignal(args));
 				if (res?.error) throw toAuthMutationError(res.error);
 				seedReturnedToken(authStoreApi, res);
 				await hydrateReturnedSession(authClient, res);

package/dist/solid/index.d.ts

@@ -148,12 +148,23 @@ declare function isAuthMutationError(error: unknown): error is AuthMutationError
 //#endregion
 //#region src/solid/auth-mutations.d.ts
 type MutationOptionsHook<TData, TVariables = void> = (options?: Omit<SolidMutationOptions<TData, DefaultError, TVariables>, 'mutationFn'>) => SolidMutationOptions<TData, DefaultError, TVariables>;
+type SignInMethod<T extends AuthClient> = Extract<keyof T['signIn'], string>;
+type EmailSignInMutationOptions<T extends AuthClient> = Omit<SolidMutationOptions<Awaited<ReturnType<T['signIn']['email']>>, DefaultError, Parameters<T['signIn']['email']>[0]>, 'mutationFn'> & {
+  signInMethod?: 'email';
+};
+type CustomSignInMutationOptions<T extends AuthClient, TMethod extends SignInMethod<T>> = Omit<SolidMutationOptions<Awaited<ReturnType<T['signIn'][TMethod]>>, DefaultError, Parameters<T['signIn'][TMethod]>[0]>, 'mutationFn'> & {
+  signInMethod: TMethod;
+};
+type SignInMutationOptionsHook<T extends AuthClient> = {
+  (options?: EmailSignInMutationOptions<T>): SolidMutationOptions<Awaited<ReturnType<T['signIn']['email']>>, DefaultError, Parameters<T['signIn']['email']>[0]>;
+  <TMethod extends Exclude<SignInMethod<T>, 'email'>>(options: CustomSignInMutationOptions<T, TMethod>): SolidMutationOptions<Awaited<ReturnType<T['signIn'][TMethod]>>, DefaultError, Parameters<T['signIn'][TMethod]>[0]>;
+};
 type AnyFn = (...args: any[]) => Promise<any>;
 type AuthClient = {
   signOut: AnyFn;
-  signIn: {
-    social: AnyFn;
+  signIn: Record<string, AnyFn> & {
     email: AnyFn;
+    social: AnyFn;
   };
   signUp: {
     email: AnyFn;
@@ -162,7 +173,7 @@ type AuthClient = {
 type AuthMutationsResult<T extends AuthClient> = {
   useSignOutMutationOptions: MutationOptionsHook<Awaited<ReturnType<T['signOut']>>, Parameters<T['signOut']>[0] | void>;
   useSignInSocialMutationOptions: MutationOptionsHook<Awaited<ReturnType<T['signIn']['social']>>, Parameters<T['signIn']['social']>[0]>;
-  useSignInMutationOptions: MutationOptionsHook<Awaited<ReturnType<T['signIn']['email']>>, Parameters<T['signIn']['email']>[0]>;
+  useSignInMutationOptions: SignInMutationOptionsHook<T>;
   useSignUpMutationOptions: MutationOptionsHook<Awaited<ReturnType<T['signUp']['email']>>, Parameters<T['signUp']['email']>[0]>;
 };
 /**

package/dist/solid/index.js

@@ -1728,10 +1728,13 @@ function createAuthMutations(authClient) {
 	});
 	const useSignInMutationOptions = ((options) => {
 		const authStoreApi = useAuthStore();
+		const { signInMethod = "email", ...mutationOptions } = options ?? {};
 		return {
-			...options,
+			...mutationOptions,
 			mutationFn: async (args) => {
-				const res = await authClient.signIn.email(args);
+				const signIn = authClient.signIn[signInMethod];
+				if (typeof signIn !== "function") throw new Error(`Auth client does not expose signIn.${signInMethod}`);
+				const res = await signIn(args);
 				if (res?.error) throw new AuthMutationError(res.error);
 				seedReturnedToken(authStoreApi, res);
 				await ensureAuth(authStoreApi);

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/package.json

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

@@ -326,6 +326,15 @@ const signUp = useMutation(useSignUpMutationOptions({ onSuccess: () => router.pu
 signUp.mutate({ callbackURL: window.location.origin, email, name, password });
 ```
 
+**Plugin sign-in methods** (requires the matching Better Auth client plugin):
+```ts
+const signIn = useMutation(useSignInMutationOptions({
+  signInMethod: 'username',
+  onSuccess: () => router.push('/'),
+}));
+signIn.mutate({ callbackURL: window.location.origin, password, username });
+```
+
 ### Sign Out
 
 ```ts
@@ -492,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