kitcn 0.25.1 → 0.25.3

package/dist/aggregate/index.d.ts

@@ -1,5 +1,5 @@
-import { Bn as ConvexTextBuilderInitial, Xt as ConvexTableWithColumns } from "../capabilities-Bem7xvGK.js";
-import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial } from "../where-clause-compiler-Dmq4HMrK.js";
+import { Bn as ConvexTextBuilderInitial, Xt as ConvexTableWithColumns } from "../capabilities-DtDfpdcH.js";
+import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial } from "../where-clause-compiler-Bke7ULoY.js";
 import * 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-BEc4d98x.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-SzH57bhp.js";
 export { type AuthRuntime, BetterAuthOptionsWithoutDatabase, type GeneratedAuthDisabledReasonKind, GenericAuthBeforeResult, GenericAuthDefinition, GenericAuthTriggerChange, GenericAuthTriggerHandlers, GenericAuthTriggers, createDisabledAuthRuntime, defineAuth, getGeneratedAuthDisabledReason };

package/dist/auth/index.d.ts

@@ -1,7 +1,7 @@
 import { a as QueryCtxWithPreferredOrmQueryTable, n as LookupByIdResultByCtx, t as DocByCtx } from "../query-context-DJONf8X5.js";
 import { t as GetAuth } from "../types-Bf3XQex5.js";
 import { t as GenericCtx } from "../context-utils-DwZ3Cam1.js";
-import { S as defineAuth, _ as GenericAuthBeforeResult, a as AuthFunctions, b as GenericAuthTriggerHandlers, c as createApi, d as deleteOneHandler, f as findManyHandler, g as BetterAuthOptionsWithoutDatabase, h as updateOneHandler, i as getGeneratedAuthDisabledReason, l as createHandler, m as updateManyHandler, n as GeneratedAuthDisabledReasonKind, o as Triggers, p as findOneHandler, r as createDisabledAuthRuntime, s as createClient, t as AuthRuntime, u as deleteManyHandler, v as GenericAuthDefinition, x as GenericAuthTriggers, y as GenericAuthTriggerChange } from "../generated-contract-disabled-BEc4d98x.js";
+import { S as defineAuth, _ as GenericAuthBeforeResult, a as AuthFunctions, b as GenericAuthTriggerHandlers, c as createApi, d as deleteOneHandler, f as findManyHandler, g as BetterAuthOptionsWithoutDatabase, h as updateOneHandler, i as getGeneratedAuthDisabledReason, l as createHandler, m as updateManyHandler, n as GeneratedAuthDisabledReasonKind, o as Triggers, p as findOneHandler, r as createDisabledAuthRuntime, s as createClient, t as AuthRuntime, u as deleteManyHandler, v as GenericAuthDefinition, x as GenericAuthTriggers, y as GenericAuthTriggerChange } from "../generated-contract-disabled-SzH57bhp.js";
 import * 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";
@@ -134,8 +134,8 @@ declare const adapterArgsValidator: convex_values0.VObject<{
   limit?: number | undefined;
   offset?: number | undefined;
   sortBy?: {
-    field: string;
     direction: "asc" | "desc";
+    field: string;
   } | undefined;
   model: string;
 }, {
@@ -144,12 +144,12 @@ declare const adapterArgsValidator: convex_values0.VObject<{
   offset: convex_values0.VFloat64<number | undefined, "optional">;
   select: convex_values0.VArray<string[] | undefined, convex_values0.VString<string, "required">, "optional">;
   sortBy: convex_values0.VObject<{
-    field: string;
     direction: "asc" | "desc";
+    field: string;
   } | undefined, {
     direction: convex_values0.VUnion<"asc" | "desc", [convex_values0.VLiteral<"asc", "required">, convex_values0.VLiteral<"desc", "required">], "required", never>;
     field: convex_values0.VString<string, "required">;
-  }, "optional", "field" | "direction">;
+  }, "optional", "direction" | "field">;
   where: convex_values0.VArray<{
     mode?: "sensitive" | "insensitive" | undefined;
     connector?: "AND" | "OR" | undefined;
@@ -169,7 +169,7 @@ declare const adapterArgsValidator: convex_values0.VObject<{
     operator: convex_values0.VUnion<"lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined, [convex_values0.VLiteral<"lt", "required">, convex_values0.VLiteral<"lte", "required">, convex_values0.VLiteral<"gt", "required">, convex_values0.VLiteral<"gte", "required">, convex_values0.VLiteral<"eq", "required">, convex_values0.VLiteral<"in", "required">, convex_values0.VLiteral<"not_in", "required">, convex_values0.VLiteral<"ne", "required">, convex_values0.VLiteral<"contains", "required">, convex_values0.VLiteral<"starts_with", "required">, convex_values0.VLiteral<"ends_with", "required">], "optional", never>;
     value: convex_values0.VUnion<string | number | boolean | string[] | number[] | null, [convex_values0.VString<string, "required">, convex_values0.VFloat64<number, "required">, convex_values0.VBoolean<boolean, "required">, convex_values0.VArray<string[], convex_values0.VString<string, "required">, "required">, convex_values0.VArray<number[], convex_values0.VFloat64<number, "required">, "required">, convex_values0.VNull<null, "required">], "required", never>;
   }, "required", "mode" | "value" | "connector" | "field" | "operator">, "optional">;
-}, "required", "model" | "select" | "where" | "limit" | "offset" | "sortBy" | "sortBy.field" | "sortBy.direction">;
+}, "required", "model" | "select" | "where" | "limit" | "offset" | "sortBy" | "sortBy.direction" | "sortBy.field">;
 declare const hasUniqueFields: (betterAuthSchema: BetterAuthDBSchema, model: string, input: Record<string, any>) => boolean;
 declare const checkUniqueFields: <Schema extends SchemaDefinition<any, any>>(ctx: GenericQueryCtx<GenericDataModel>, schema: Schema, betterAuthSchema: BetterAuthDBSchema, table: string, input: Record<string, any>, doc?: Record<string, any>) => Promise<void>;
 declare const selectFields: <T extends TableNamesInDataModel<GenericDataModel>, D extends DocumentByName<GenericDataModel, T>>(doc: D | null, select?: string[]) => D | null;

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

@@ -1,4 +1,4 @@
-import { H as ConvexContext, W as LazyCaller } from "../../procedure-name-Bjw1JDIS.js";
+import { H as ConvexContext, W as LazyCaller } from "../../procedure-name-l2YusEZI.js";
 import { t as GetTokenOptions } from "../../token-kQaqFby4.js";
 
 //#region src/auth-nextjs/index.d.ts

package/dist/{builder-C6JSHkRK.js → builder-DoeyW4Vq.js}

@@ -3,8 +3,8 @@ import { n as customCtx, t as NoOp } from "./customFunctions-ivbc6-_g.js";
 import { s as getTransformer } from "./transformer-D8wO-kEj.js";
 import { ConvexError, v } from "convex/values";
 import { HttpRouter, actionGeneric, httpActionGeneric, internalActionGeneric, internalMutationGeneric, internalQueryGeneric, mutationGeneric, queryGeneric } from "convex/server";
-import { z } from "zod";
-import * as z$1 from "zod/v4";
+import * as z$1 from "zod";
+import * as z$2 from "zod/v4";
 import * as zCore from "zod/v4/core";
 
 //#region src/internal/upstream/server/zod4.ts
@@ -190,7 +190,7 @@ function zCustomAction(action, customization) {
 * @returns A Zod schema representing a Convex `Id`
 */
 const zid = (tableName) => {
-	const result = z$1.custom((val) => typeof val === "string");
+	const result = z$2.custom((val) => typeof val === "string");
 	_zidRegistry.add(result, { tableName });
 	return result;
 };
@@ -413,35 +413,35 @@ function convexToZod(convexValidator) {
 			zodValidator = zid(convexValidator.tableName);
 			break;
 		case "string":
-			zodValidator = z$1.string();
+			zodValidator = z$2.string();
 			break;
 		case "float64":
-			zodValidator = z$1.number();
+			zodValidator = z$2.number();
 			break;
 		case "int64":
-			zodValidator = z$1.bigint();
+			zodValidator = z$2.bigint();
 			break;
 		case "commitTs":
-			zodValidator = z$1.union([z$1.bigint(), z$1.custom(isCommitTsPlaceholder)]);
+			zodValidator = z$2.union([z$2.bigint(), z$2.custom(isCommitTsPlaceholder)]);
 			break;
 		case "boolean":
-			zodValidator = z$1.boolean();
+			zodValidator = z$2.boolean();
 			break;
 		case "null":
-			zodValidator = z$1.null();
+			zodValidator = z$2.null();
 			break;
 		case "any":
-			zodValidator = z$1.any();
+			zodValidator = z$2.any();
 			break;
 		case "array":
-			zodValidator = z$1.array(convexToZod(convexValidator.element));
+			zodValidator = z$2.array(convexToZod(convexValidator.element));
 			break;
 		case "object":
-			zodValidator = z$1.object(convexToZodFields(convexValidator.fields));
+			zodValidator = z$2.object(convexToZodFields(convexValidator.fields));
 			break;
 		case "union": {
 			if (convexValidator.members.length === 0) {
-				zodValidator = z$1.never();
+				zodValidator = z$2.never();
 				break;
 			}
 			if (convexValidator.members.length === 1) {
@@ -449,21 +449,21 @@ function convexToZod(convexValidator) {
 				break;
 			}
 			const memberValidators = convexValidator.members.map((member) => convexToZod(member));
-			zodValidator = z$1.union([...memberValidators]);
+			zodValidator = z$2.union([...memberValidators]);
 			break;
 		}
 		case "literal": {
 			const literalValidator = convexValidator;
-			zodValidator = z$1.literal(literalValidator.value);
+			zodValidator = z$2.literal(literalValidator.value);
 			break;
 		}
 		case "record":
-			zodValidator = z$1.record(convexToZod(convexValidator.key), convexToZod(convexValidator.value));
+			zodValidator = z$2.record(convexToZod(convexValidator.key), convexToZod(convexValidator.value));
 			break;
 		case "bytes": throw new Error("v.bytes() is not supported");
 		default: throw new Error(`Unknown convex validator type: ${kind}`);
 	}
-	return isOptional ? z$1.optional(zodValidator) : zodValidator;
+	return isOptional ? z$2.optional(zodValidator) : zodValidator;
 }
 /**
 * Like {@link convexToZod}, but it takes in a bare object, as expected by Convex
@@ -503,7 +503,7 @@ function withSystemFields(tableName, zObject) {
 	return {
 		...zObject,
 		_id: zid(tableName),
-		_creationTime: z$1.number()
+		_creationTime: z$2.number()
 	};
 }
 /**
@@ -523,7 +523,7 @@ function customFnBuilder(builder, customization) {
 	const inputArgs = customization.args ?? NoOp.args;
 	return function customBuilder(fn) {
 		const { args, handler = fn, skipConvexValidation = false, skipZodReturnsValidation = false, returns: maybeObject, ...extra } = fn;
-		const returns = maybeObject && !(maybeObject instanceof zCore.$ZodType) ? z$1.object(maybeObject) : maybeObject;
+		const returns = maybeObject && !(maybeObject instanceof zCore.$ZodType) ? z$2.object(maybeObject) : maybeObject;
 		const returnValidator = returns && !skipConvexValidation ? { returns: zodOutputToConvex(returns) } : null;
 		const parseReturns = returns && !skipZodReturnsValidation ? (value) => returns.parseAsync(value === void 0 ? null : value) : null;
 		if (args) {
@@ -541,7 +541,7 @@ function customFnBuilder(builder, customization) {
 				handler: async (ctx, allArgs) => {
 					const added = await customInput(ctx, inputArgKeys.length === 0 ? {} : pickKeys(allArgs, inputArgKeySet), extra);
 					const rawArgs = pickKeys(allArgs, argKeySet);
-					argsSchema ??= z$1.object(argsValidator);
+					argsSchema ??= z$2.object(argsValidator);
 					const parsed = await argsSchema.safeParseAsync(rawArgs);
 					if (!parsed.success) throw new ConvexError({ ZodError: JSON.parse(JSON.stringify(parsed.error.issues, null, 2)) });
 					const args = parsed.data;
@@ -990,8 +990,8 @@ async function readFormDataBody(request) {
 	}
 }
 function getBaseSchema(schema) {
-	if (schema instanceof z.ZodOptional || schema instanceof z.ZodNullable) return getBaseSchema(schema.unwrap());
-	if (schema instanceof z.ZodDefault) return getBaseSchema(schema._def.innerType);
+	if (schema instanceof z$1.ZodOptional || schema instanceof z$1.ZodNullable) return getBaseSchema(schema.unwrap());
+	if (schema instanceof z$1.ZodDefault) return getBaseSchema(schema._def.innerType);
 	return schema;
 }
 /**
@@ -1007,12 +1007,12 @@ function getBaseSchema(schema) {
 */
 function buildQueryCoercion(schema) {
 	const coercion = /* @__PURE__ */ new Map();
-	if (!(schema instanceof z.ZodObject)) return coercion;
+	if (!(schema instanceof z$1.ZodObject)) return coercion;
 	for (const [key, fieldSchema] of Object.entries(schema.shape)) {
 		const base = getBaseSchema(fieldSchema);
-		if (base instanceof z.ZodArray) coercion.set(key, "array");
-		else if (base instanceof z.ZodNumber) coercion.set(key, "number");
-		else if (base instanceof z.ZodBoolean) coercion.set(key, "boolean");
+		if (base instanceof z$1.ZodArray) coercion.set(key, "array");
+		else if (base instanceof z$1.ZodNumber) coercion.set(key, "number");
+		else if (base instanceof z$1.ZodBoolean) coercion.set(key, "boolean");
 	}
 	return coercion;
 }
@@ -1083,7 +1083,7 @@ function createProcedure(def, handler, _type) {
 				if (def.paramsSchema) try {
 					parsedParams = def.paramsSchema.parse(pathParams);
 				} catch (error) {
-					if (error instanceof z.ZodError) throw new CRPCError({
+					if (error instanceof z$1.ZodError) throw new CRPCError({
 						code: "BAD_REQUEST",
 						message: "Invalid path params",
 						cause: error
@@ -1096,7 +1096,7 @@ function createProcedure(def, handler, _type) {
 					try {
 						parsedQuery = def.querySchema.parse(queryParams);
 					} catch (error) {
-						if (error instanceof z.ZodError) throw new CRPCError({
+						if (error instanceof z$1.ZodError) throw new CRPCError({
 							code: "BAD_REQUEST",
 							message: "Invalid query params",
 							cause: error
@@ -1116,7 +1116,7 @@ function createProcedure(def, handler, _type) {
 					try {
 						parsedInput = def.inputSchema.parse(def.functionConfig.transformer.input.deserialize(body));
 					} catch (error) {
-						if (error instanceof z.ZodError) throw new CRPCError({
+						if (error instanceof z$1.ZodError) throw new CRPCError({
 							code: "BAD_REQUEST",
 							message: "Invalid input",
 							cause: error
@@ -1132,7 +1132,7 @@ function createProcedure(def, handler, _type) {
 					try {
 						parsedForm = def.formSchema.parse(formObj);
 					} catch (error) {
-						if (error instanceof z.ZodError) throw new CRPCError({
+						if (error instanceof z$1.ZodError) throw new CRPCError({
 							code: "BAD_REQUEST",
 							message: "Invalid form data",
 							cause: error
@@ -1598,13 +1598,13 @@ function inferProcedureNameFromCallsite() {
 *
 * Core library - no project-specific dependencies
 */
-z.object({
-	cursor: z.union([z.string(), z.null()]),
-	limit: z.number()
+z$1.object({
+	cursor: z$1.union([z$1.string(), z$1.null()]),
+	limit: z$1.number()
 });
-z.object({
-	cursor: z.union([z.string(), z.null()]).optional(),
-	limit: z.number().optional()
+z$1.object({
+	cursor: z$1.union([z$1.string(), z$1.null()]).optional(),
+	limit: z$1.number().optional()
 });
 /**
 * Create a middleware factory for building reusable middleware chains
@@ -1731,32 +1731,32 @@ const withConvexSafeRunners = (ctx) => {
 	return changed ? wrappedContext : contextObject;
 };
 const replaceUnencodableOutputTypes = (schema) => {
-	if (schema instanceof z.ZodDate) return z.any();
-	if (schema instanceof z.ZodArray) return z.array(replaceUnencodableOutputTypes(schema.element));
-	if (schema instanceof z.ZodObject) {
+	if (schema instanceof z$1.ZodDate) return z$1.any();
+	if (schema instanceof z$1.ZodArray) return z$1.array(replaceUnencodableOutputTypes(schema.element));
+	if (schema instanceof z$1.ZodObject) {
 		const nextShape = {};
 		for (const [key, value] of Object.entries(schema.shape)) nextShape[key] = replaceUnencodableOutputTypes(value);
-		return z.object(nextShape);
+		return z$1.object(nextShape);
 	}
-	if (schema instanceof z.ZodUnion) return z.union(schema.options.map((option) => replaceUnencodableOutputTypes(option)));
-	if (schema instanceof z.ZodOptional) return replaceUnencodableOutputTypes(schema.unwrap()).optional();
-	if (schema instanceof z.ZodNullable) return replaceUnencodableOutputTypes(schema.unwrap()).nullable();
-	if (schema instanceof z.ZodRecord) return z.record(schema.keyType, replaceUnencodableOutputTypes(schema.valueType));
+	if (schema instanceof z$1.ZodUnion) return z$1.union(schema.options.map((option) => replaceUnencodableOutputTypes(option)));
+	if (schema instanceof z$1.ZodOptional) return replaceUnencodableOutputTypes(schema.unwrap()).optional();
+	if (schema instanceof z$1.ZodNullable) return replaceUnencodableOutputTypes(schema.unwrap()).nullable();
+	if (schema instanceof z$1.ZodRecord) return z$1.record(schema.keyType, replaceUnencodableOutputTypes(schema.valueType));
 	return schema;
 };
 const replaceUnencodableInputTypes = (schema) => {
-	if (schema instanceof z.ZodDate) return z.any();
-	if (schema instanceof z.ZodArray) return z.array(replaceUnencodableInputTypes(schema.element));
-	if (schema instanceof z.ZodObject) {
+	if (schema instanceof z$1.ZodDate) return z$1.any();
+	if (schema instanceof z$1.ZodArray) return z$1.array(replaceUnencodableInputTypes(schema.element));
+	if (schema instanceof z$1.ZodObject) {
 		const nextShape = {};
 		for (const [key, value] of Object.entries(schema.shape)) nextShape[key] = replaceUnencodableInputTypes(value);
-		return z.object(nextShape);
+		return z$1.object(nextShape);
 	}
-	if (schema instanceof z.ZodUnion) return z.union(schema.options.map((option) => replaceUnencodableInputTypes(option)));
-	if (schema instanceof z.ZodOptional) return replaceUnencodableInputTypes(schema.unwrap()).optional();
-	if (schema instanceof z.ZodNullable) return replaceUnencodableInputTypes(schema.unwrap()).nullable();
-	if (schema instanceof z.ZodRecord) return z.record(schema.keyType, replaceUnencodableInputTypes(schema.valueType));
-	if (schema instanceof z.ZodDefault) return replaceUnencodableInputTypes(schema.removeDefault());
+	if (schema instanceof z$1.ZodUnion) return z$1.union(schema.options.map((option) => replaceUnencodableInputTypes(option)));
+	if (schema instanceof z$1.ZodOptional) return replaceUnencodableInputTypes(schema.unwrap()).optional();
+	if (schema instanceof z$1.ZodNullable) return replaceUnencodableInputTypes(schema.unwrap()).nullable();
+	if (schema instanceof z$1.ZodRecord) return z$1.record(schema.keyType, replaceUnencodableInputTypes(schema.valueType));
+	if (schema instanceof z$1.ZodDefault) return replaceUnencodableInputTypes(schema.removeDefault());
 	return schema;
 };
 /**
@@ -1776,11 +1776,11 @@ const resolveConvexArgsShape = (inputShape) => {
 	try {
 		return toWireShape(inputShape);
 	} catch {
-		const compatibleSchema = replaceUnencodableInputTypes(z.object(inputShape));
+		const compatibleSchema = replaceUnencodableInputTypes(z$1.object(inputShape));
 		try {
 			return toWireShape(compatibleSchema.shape);
 		} catch {
-			return Object.fromEntries(Object.keys(inputShape).map((key) => [key, z.any()]));
+			return Object.fromEntries(Object.keys(inputShape).map((key) => [key, z$1.any()]));
 		}
 	}
 };
@@ -1795,7 +1795,7 @@ const resolveConvexArgsShape = (inputShape) => {
 const relaxSupersededKeys = (schema, superseded) => {
 	if (superseded.length === 0) return schema;
 	try {
-		return schema.safeExtend(Object.fromEntries(superseded.map((key) => [key, z.any()])));
+		return schema.safeExtend(Object.fromEntries(superseded.map((key) => [key, z$1.any()])));
 	} catch {
 		return schema;
 	}
@@ -1852,7 +1852,7 @@ const parseInput = (plan, value) => {
 		}
 		return parsed;
 	} catch (cause) {
-		if (cause instanceof z.ZodError) throw new ConvexError({ ZodError: JSON.parse(JSON.stringify(cause.issues, null, 2)) });
+		if (cause instanceof z$1.ZodError) throw new ConvexError({ ZodError: JSON.parse(JSON.stringify(cause.issues, null, 2)) });
 		throw cause;
 	}
 };
@@ -2011,14 +2011,14 @@ var QueryProcedureBuilder = class QueryProcedureBuilder extends ProcedureBuilder
 	* @param opts.item - Zod schema for each item in the page array
 	*/
 	paginated(opts) {
-		const paginationSchemaWithDefault = z.object({
-			cursor: z.union([z.string(), z.null()]).default(null),
-			limit: z.number().default(opts.limit).transform((n) => Math.min(n, opts.limit))
+		const paginationSchemaWithDefault = z$1.object({
+			cursor: z$1.union([z$1.string(), z$1.null()]).default(null),
+			limit: z$1.number().default(opts.limit).transform((n) => Math.min(n, opts.limit))
 		});
-		const outputSchema = z.object({
-			continueCursor: z.union([z.string(), z.null()]),
-			isDone: z.boolean(),
-			page: z.array(opts.item)
+		const outputSchema = z$1.object({
+			continueCursor: z$1.union([z$1.string(), z$1.null()]),
+			isDone: z$1.boolean(),
+			page: z$1.array(opts.item)
 		});
 		return new QueryProcedureBuilder({
 			...this._def,

package/dist/{capabilities-Bem7xvGK.d.ts → capabilities-DtDfpdcH.d.ts}

@@ -2139,7 +2139,7 @@ declare const createAggregateError: (code: AggregateErrorCode, message: string)
 declare const ensureCountAllowedForRls: (tableConfig: TableRelationalConfig, rlsMode: "skip" | "default" | undefined) => void;
 declare const ensureAggregateAllowedForRls: (tableConfig: TableRelationalConfig, rlsMode: "skip" | "default" | undefined, methodName: string) => void;
 declare namespace runtime_d_exports$1 {
-  export { AGGREGATE_ERROR, AGGREGATE_STATE_KIND_METRIC, AGGREGATE_STATE_KIND_RANK, AggregateBucketDelta, AggregateErrorCode, AggregateExtremaDelta, AggregateIndexDefinition, AggregateMemberWrite, AggregateMembershipDelta, AggregateQueryPlan, AggregateRangeConstraint, COUNT_ERROR, COUNT_STATUS_BUILDING, COUNT_STATUS_CLEARING, COUNT_STATUS_READY, ClearIndexChunkResult, CountErrorCode, CountIndexDefinition, CountQueryPlan, CountState, PlanBucketReadCache, applyAggregateIndexesForChange, applyCountIndexesForChange, asUnknownArray, assertAggregateIndexesWritable, clearCountIndexChunk, compileAggregateQueryPlan, compileCountFieldQueryPlan, compileCountQueryPlan, computeAggregateMembershipDelta, computeAggregateMetricValues, computeCountKeyParts, createAggregateError, createCountError, ensureAggregateAllowedForRls, ensureAggregateIndexReady, ensureCountAllowedForRls, ensureCountIndexReady, flushAggregateMembershipDeltas, getAggregateIndexDefinitions, getCountIndexDefinitions, getCountIndexValuesForFields, getCountState, isAggregatePlanZero, isIndexCountZero, listCountStates, listSchemaAggregateIndexes, listSchemaCountIndexes, parseAggregateWhere, parseCountWhere, readAverageFromBuckets, readCountFieldFromBuckets, readCountFromBuckets, readExtremaFromBuckets, readPlanBuckets, readSumFromBuckets, reconcileAggregateMembership, serializeCountKeyParts, setCountState, setCountStateError };
+  export { AGGREGATE_ERROR, AGGREGATE_STATE_KIND_METRIC, AGGREGATE_STATE_KIND_RANK, AggregateBucketDelta, AggregateErrorCode, AggregateExtremaDelta, AggregateIndexDefinition, AggregateMemberWrite, AggregateMembershipDelta, AggregateQueryPlan, AggregateRangeConstraint, COUNT_ERROR, COUNT_STATUS_BUILDING, COUNT_STATUS_CLEARING, COUNT_STATUS_READY, ClearIndexChunkResult, CountErrorCode, CountIndexDefinition, CountQueryPlan, CountState, NULLISH_PROBE_VALUES, PlanBucketReadCache, applyAggregateIndexesForChange, applyCountIndexesForChange, asUnknownArray, assertAggregateIndexesWritable, clearCountIndexChunk, compileAggregateQueryPlan, compileCountFieldQueryPlan, compileCountQueryPlan, computeAggregateMembershipDelta, computeAggregateMetricValues, computeCountKeyParts, createAggregateError, createCountError, ensureAggregateAllowedForRls, ensureAggregateIndexReady, ensureCountAllowedForRls, ensureCountIndexReady, flushAggregateMembershipDeltas, getAggregateIndexDefinitions, getCountIndexDefinitions, getCountIndexValuesForFields, getCountState, isAggregatePlanZero, isIndexCountZero, listCountStates, listSchemaAggregateIndexes, listSchemaCountIndexes, parseAggregateWhere, parseCountWhere, readAverageFromBuckets, readCountFieldFromBuckets, readCountFromBuckets, readExtremaFromBuckets, readPlanBuckets, readSumFromBuckets, reconcileAggregateMembership, serializeCountKeyParts, setCountState, setCountStateError };
 }
 declare const AGGREGATE_STATE_KIND_METRIC = "metric";
 declare const AGGREGATE_STATE_KIND_RANK = "rank";
@@ -2216,6 +2216,17 @@ type AggregateQueryPlan = {
   metric: AggregateMetricRequest;
 };
 type PlanBucketReadCache = Map<string, Promise<unknown[]>>;
+/**
+ * A nullable column is `v.optional(v.union(v.null(), ...))`, so a row that
+ * never had the column written stores it absent, and `computeCountKeyParts`
+ * encodes absent as the `__kitcnUndefined` sentinel — a different bucket from
+ * the one an explicit `null` lands in. `isNull` means null-or-absent
+ * everywhere else in the ORM, so probing only the `null` bucket silently
+ * undercounts every row written before the column existed. Both probes are
+ * looked up through `serializeStable`, which maps `undefined` onto the same
+ * sentinel the write path stored.
+ */
+declare const NULLISH_PROBE_VALUES: readonly unknown[];
 declare const serializeCountKeyParts: (parts: unknown[]) => string;
 declare const compileCountQueryPlan: (tableConfig: TableRelationalConfig, where: unknown) => CountQueryPlan;
 declare const compileCountFieldQueryPlan: (tableConfig: TableRelationalConfig, where: unknown, field: string) => AggregateQueryPlan;
@@ -3030,6 +3041,14 @@ declare class GelRelationalQuery<TSchema extends TablesRelationalConfig, TTableC
   private _pushGroupByConstraint;
   private _parseGroupByFieldConstraint;
   private _collectGroupByFieldValues;
+  /**
+   * One group per distinct value, where `null` and absent count as the same
+   * value. They occupy different aggregate buckets, so the emitted group key
+   * and the filter that reads it diverge: the key reports `null` while the
+   * filter keeps `isNull` so the aggregate compiler reads both buckets and
+   * combines their metrics into a single row.
+   */
+  private _buildGroupBySlots;
   private _buildGroupByCandidates;
   private _coerceGroupByByFields;
   private _isGroupByOrderDirection;

package/dist/cli.mjs

@@ -6,12 +6,46 @@ import path, { basename, delimiter, dirname, extname, isAbsolute, join, posix, r
 import { fileURLToPath } from "node:url";
 import { createHash, randomBytes } from "node:crypto";
 import { execa } from "execa";
-import { createInterface } from "node:readline/promises";
 import os from "node:os";
+import { createInterface } from "node:readline/promises";
 import { diffWords, structuredPatch } from "diff";
 import { parseEnv } from "node:util";
 import { createServer } from "node:http";
 
+//#region src/internal/concurrency.ts
+/**
+* Bounded-concurrency fan-out, shared by the ORM write path, relation loading
+* and the CLI's entry-point analyzer.
+*
+* Deliberately dependency-free: ORM callers reach it from a Convex function
+* entry, and Convex bundles every static import of an entry.
+*/
+/**
+* Runs `worker` over `items` with at most `limit` in flight. Results keep input
+* order, so callers can rely on a stable mapping back to `items`.
+*
+* Unbounded `Promise.all` is not an option for the ORM caller: a fan-out is
+* bounded only by `mutationMaxRows` (10,000), and that many simultaneous
+* in-flight syscalls is its own failure mode.
+*/
+async function mapWithConcurrency(items, limit, worker) {
+	if (items.length === 0) return [];
+	const width = Math.max(1, Math.min(limit, items.length));
+	const results = new Array(items.length);
+	let nextIndex = 0;
+	const runWorker = async () => {
+		while (true) {
+			const index = nextIndex;
+			nextIndex += 1;
+			if (index >= items.length) return;
+			results[index] = await worker(items[index], index);
+		}
+	};
+	await Promise.all(Array.from({ length: width }, () => runWorker()));
+	return results;
+}
+
+//#endregion
 //#region src/orm/mutation-utils.ts
 const UTF8_ENCODER = new TextEncoder();
 function getTableName(table) {
@@ -830,20 +864,32 @@ const collectAnalyzeEntrySelection = async (roots, options) => {
 		handlerExportsByEntry
 	};
 };
+const MAX_ANALYZE_CONCURRENCY = 8;
+/**
+* esbuild bundles are independent, so the entry sweep runs through a bounded
+* pool instead of one build at a time. The cap stays low enough to avoid
+* oversubscribing esbuild's worker pool on small machines.
+*/
+const resolveAnalyzeConcurrency = (taskCount) => {
+	if (taskCount <= 1) return 1;
+	const cpuCount = os.cpus().length || 1;
+	return Math.max(1, Math.min(MAX_ANALYZE_CONCURRENCY, cpuCount - 1, taskCount));
+};
 const collectHotspotRows = async (roots, options, includeDeepData) => {
 	const { isolateEntries, generatedEntries, entryPoints, handlerExportsByEntry } = await collectAnalyzeEntrySelection(roots, options);
-	const rows = [];
-	for (const entryPoint of entryPoints) try {
-		rows.push({
-			...await analyzeHotspotEntry(entryPoint, roots.projectRoot, includeDeepData),
-			handlerExports: handlerExportsByEntry.get(entryPoint) ?? []
-		});
-	} catch (error) {
-		rows.push({
-			entry: path.relative(roots.projectRoot, entryPoint),
-			error: error instanceof Error ? error.message : String(error)
-		});
-	}
+	const rows = await mapWithConcurrency(entryPoints, resolveAnalyzeConcurrency(entryPoints.length), async (entryPoint) => {
+		try {
+			return {
+				...await analyzeHotspotEntry(entryPoint, roots.projectRoot, includeDeepData),
+				handlerExports: handlerExportsByEntry.get(entryPoint) ?? []
+			};
+		} catch (error) {
+			return {
+				entry: path.relative(roots.projectRoot, entryPoint),
+				error: error instanceof Error ? error.message : String(error)
+			};
+		}
+	});
 	return {
 		isolateEntries,
 		generatedEntries,
@@ -3270,7 +3316,7 @@ const upsertReadOptionalRuntimeEnvOption = (source, keys) => {
 const renderEnvHelperContent = (envFields, existingContent) => {
 	const fields = resolveBootstrapEnvFields(envFields);
 	const readOptionalRuntimeEnvKeys = resolveReadOptionalRuntimeEnvKeys(fields);
-	if (!existingContent) return `import { createEnv } from 'kitcn/server';\nimport { z } from 'zod';\n\nconst envSchema = z.object({\n${fields.map((field) => `  ${field.key}: ${field.schema},`).join("\n")}\n});\n\nexport const getEnv = createEnv({\n${renderReadOptionalRuntimeEnvOption(readOptionalRuntimeEnvKeys)}  schema: envSchema,\n});\n`;
+	if (!existingContent) return `import { createEnv } from 'kitcn/server';\nimport * as z from 'zod';\n\nconst envSchema = z.object({\n${fields.map((field) => `  ${field.key}: ${field.schema},`).join("\n")}\n});\n\nexport const getEnv = createEnv({\n${renderReadOptionalRuntimeEnvOption(readOptionalRuntimeEnvKeys)}  schema: envSchema,\n});\n`;
 	const match = existingContent.match(ENV_SCHEMA_RE);
 	if (!match) throw new Error("Expected env helper to define `const envSchema = z.object({ ... });`.");
 	const existingBody = match[2];
@@ -6782,7 +6828,7 @@ const authRegistryItem = defineInternalRegistryItem({
 //#region src/cli/registry/items/ratelimit/ratelimit-functions.template.ts
 const PROJECT_CRPC_IMPORT_PLACEHOLDER$3 = "__KITCN_PROJECT_CRPC_IMPORT__";
 const RATELIMIT_FUNCTIONS_TEMPLATE = `import { cleanupRatelimitState } from "kitcn/ratelimit";
-import { z } from "zod";
+import * as z from "zod";
 import { privateMutation } from "${PROJECT_CRPC_IMPORT_PLACEHOLDER$3}";
 
 const DEFAULT_BATCH_SIZE = 500;
@@ -7098,7 +7144,7 @@ import {
   Text,
 } from '@react-email/components';
 import { render } from '@react-email/render';
-import { z } from 'zod';
+import * as z from 'zod';
 import { privateAction } from '${PROJECT_CRPC_IMPORT_PLACEHOLDER$2}';
 ${PROJECT_GET_ENV_IMPORT_PLACEHOLDER$1}
 import { createResendCaller } from '${FUNCTIONS_DIR_IMPORT_PLACEHOLDER$2}/generated/plugins/resend.runtime';
@@ -7218,7 +7264,7 @@ const RESEND_FUNCTIONS_TEMPLATE = `import {
   shouldRetry,
 } from '@kitcn/resend';
 import { eq, inArray } from 'kitcn/orm';
-import { z } from 'zod';
+import * as z from 'zod';
 import { privateAction, privateMutation, privateQuery } from '${PROJECT_CRPC_IMPORT_PLACEHOLDER$1}';
 import { resend } from '${PLUGIN_CONFIG_IMPORT_PLACEHOLDER}';
 import {
@@ -8916,7 +8962,7 @@ function renderInitNextEnvLocalTemplate(source) {
 //#endregion
 //#region src/cli/registry/init/next/init-next-messages.template.ts
 const resolveCrpcImportPath = (functionsDirRelative) => functionsDirRelative === "convex" ? "./lib/crpc" : "../lib/crpc";
-const renderInitNextMessagesTemplate = (functionsDirRelative = "convex/functions") => `import { z } from 'zod';
+const renderInitNextMessagesTemplate = (functionsDirRelative = "convex/functions") => `import * as z from 'zod';
 
 import { publicMutation, publicQuery } from '${resolveCrpcImportPath(functionsDirRelative)}';
 
@@ -14368,6 +14414,54 @@ const assertRawConvexAuthDeploymentReady = () => {
 	const convexUrl = localEnv[projectContext.convexUrlEnvKey]?.trim();
 	if (!deployment || !convexUrl) throw new Error(RAW_CONVEX_AUTH_DEPLOYMENT_ERROR);
 };
+const runDependencyInstallStage = async (installPlan, stage, execaFn) => {
+	try {
+		await applyDependencyInstallPlan(installPlan, execaFn);
+	} catch (error) {
+		throw new Error(`${stage}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+};
+/**
+* The baseline install and the plugin package install run back to back with no
+* code between them, so they collapse into a single package-manager call.
+* Merging only happens when both legs target the same package.json with the
+* same package manager; otherwise each leg runs on its own.
+*/
+const mergeBaselineAndPluginInstall = (baseline, plugin) => {
+	if (!baseline) return null;
+	if (plugin.skipped || !(plugin.packageName && plugin.packageJsonPath)) return null;
+	if (resolve(baseline.cwd) !== resolve(dirname(plugin.packageJsonPath))) return null;
+	if (detectPackageManager(baseline.cwd) !== baseline.packageManager) return null;
+	const pluginSpec = plugin.packageSpec ?? plugin.packageName;
+	const packages = [...baseline.packages, pluginSpec];
+	const { args, command } = resolveDependencyInstallCommand(baseline.packageManager, packages);
+	return {
+		...baseline,
+		args,
+		command,
+		packages
+	};
+};
+const installBaselineAndPluginDependencies = async (params) => {
+	const { baseline, plugin, pluginKey, execaFn } = params;
+	const merged = mergeBaselineAndPluginInstall(baseline, plugin);
+	if (merged) {
+		await runDependencyInstallStage(merged, `Installing baseline dependencies and the ${pluginKey} package`, execaFn);
+		return {
+			packageName: plugin.packageName,
+			packageSpec: plugin.packageSpec ?? plugin.packageName,
+			packageJsonPath: plugin.packageJsonPath,
+			installed: true,
+			skipped: false
+		};
+	}
+	await runDependencyInstallStage(baseline, "Installing baseline dependencies", execaFn);
+	try {
+		return await applyPluginDependencyInstall(plugin, execaFn);
+	} catch (error) {
+		throw new Error(`Installing the ${pluginKey} package: ${error instanceof Error ? error.message : String(error)}`);
+	}
+};
 const handleAddCommand = async (argv, deps = {}) => {
 	const parsed = parseArgs(argv);
 	if (HELP_FLAGS$10.has(argv[0] ?? "") || HELP_FLAGS$10.has(parsed.restArgs[0] ?? "")) {
@@ -14481,8 +14575,12 @@ const handleAddCommand = async (argv, deps = {}) => {
 		yes: addArgs.yes,
 		promptAdapter
 	});
-	await applyDependencyInstallPlan(initializationPlan?.dependencyInstall ?? null, execaFn);
-	const dependencyInstall = await applyPluginDependencyInstall(plan.dependency, execaFn);
+	const dependencyInstall = await installBaselineAndPluginDependencies({
+		baseline: initializationPlan?.dependencyInstall ?? null,
+		plugin: plan.dependency,
+		pluginKey: selectedPlugin,
+		execaFn
+	});
 	const installedDependencyHints = await applyDependencyHintsInstall(plan.dependencyHints, execaFn);
 	const payload = {
 		command: "add",

package/dist/{generated-contract-disabled-BEc4d98x.d.ts → generated-contract-disabled-SzH57bhp.d.ts}

@@ -235,8 +235,8 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
     limit?: number | undefined;
     offset?: number | undefined;
     sortBy?: {
-      field: string;
       direction: "asc" | "desc";
+      field: string;
     } | undefined;
     model: string;
     paginationOpts: {

package/dist/{middleware-CdqNVyp8.js → middleware-DIj-bwVi.js}

@@ -1,4 +1,4 @@
-import { a as createMiddlewareFactory } from "./builder-C6JSHkRK.js";
+import { a as createMiddlewareFactory } from "./builder-DoeyW4Vq.js";
 
 //#region src/plugins/middleware.ts
 const PLUGIN_CONFIG_RESOLVERS = Symbol.for("kitcn:PluginConfigResolvers");

package/dist/orm/aggregate-index/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as RankOrderField, G as CountBackfillKickoffArgs, J as AggregateQueryPlan, K as CountBackfillMode, Q as RankIndexDefinition, W as CountBackfillChunkArgs, X as AggregateIndexDefinition, Y as CountQueryPlan, Z as CountIndexDefinition, q as CountBackfillStatusArgs, r as OrmCapability } from "../../capabilities-Bem7xvGK.js";
+import { $ as RankOrderField, G as CountBackfillKickoffArgs, J as AggregateQueryPlan, K as CountBackfillMode, Q as RankIndexDefinition, W as CountBackfillChunkArgs, X as AggregateIndexDefinition, Y as CountQueryPlan, Z as CountIndexDefinition, q as CountBackfillStatusArgs, r as OrmCapability } from "../../capabilities-DtDfpdcH.js";
 
 //#region src/orm/aggregate-index/capability.d.ts
 /**