kitcn 0.22.1 → 0.23.0

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

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

package/dist/auth/nextjs/index.js

@@ -1,6 +1,6 @@
 import { t as getToken } from "../../token-xlpENMVn.js";
 import { n as defaultIsUnauthorized } from "../../error-Bvo7YEhk.js";
-import { t as createCallerFactory } from "../../caller-factory-DHywSoGZ.js";
+import { t as createCallerFactory } from "../../caller-factory-CWa0ELLD.js";
 
 //#region src/auth-nextjs/index.ts
 /** biome-ignore-all lint/suspicious/noExplicitAny: lib */

package/dist/{builder-Dwy6D2QA.js → builder-CsxVc5xC.js}

@@ -1,7 +1,6 @@
-import { i as pick } from "./upstream-BR6sBLg3.js";
 import { o as vRequired, t as addFieldsToValidator } from "./validators-C7LelqTN.js";
 import { n as customCtx, t as NoOp } from "./customFunctions-DxEEO4Dq.js";
-import { s as getTransformer } from "./transformer-C6pGVHqx.js";
+import { s as getTransformer } from "./transformer-yZuBWo8v.js";
 import { ConvexError, v } from "convex/values";
 import { HttpRouter, actionGeneric, httpActionGeneric, internalActionGeneric, internalMutationGeneric, internalQueryGeneric, mutationGeneric, queryGeneric } from "convex/server";
 import { z } from "zod";
@@ -501,25 +500,43 @@ function withSystemFields(tableName, zObject) {
 		_creationTime: z$1.number()
 	};
 }
+/**
+* Single-pass `pick` over own keys, preserving `obj`'s insertion order.
+*
+* The shared `pick` helper is `Object.fromEntries(Object.entries(obj).filter(
+* ([k]) => keys.includes(k)))`, i.e. O(fields^2) with three intermediate
+* allocations. This runs on every request, so it gets a Set instead.
+*/
+function pickKeys(obj, keys) {
+	const result = {};
+	for (const key of Object.keys(obj)) if (keys.has(key)) result[key] = obj[key];
+	return result;
+}
 function customFnBuilder(builder, customization) {
 	const customInput = customization.input ?? NoOp.input;
 	const inputArgs = customization.args ?? NoOp.args;
 	return function customBuilder(fn) {
-		const { args, handler = fn, skipConvexValidation = false, returns: maybeObject, ...extra } = 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 returnValidator = returns && !skipConvexValidation ? { returns: zodOutputToConvex(returns) } : null;
+		const parseReturns = returns && !skipZodReturnsValidation ? (value) => returns.parseAsync(value === void 0 ? null : value) : null;
 		if (args) {
 			let argsValidator = args;
 			if (argsValidator instanceof zCore.$ZodType) if (argsValidator instanceof zCore.$ZodObject) argsValidator = argsValidator._zod.def.shape;
 			else throw new Error("Unsupported zod type as args validator: " + argsValidator.constructor.name);
 			const convexValidator = zodToConvexFields(argsValidator);
+			const inputArgKeys = Object.keys(inputArgs);
+			const inputArgKeySet = new Set(inputArgKeys);
+			const argKeySet = new Set(Object.keys(argsValidator));
+			let argsSchema;
 			return builder({
 				args: skipConvexValidation ? void 0 : addFieldsToValidator(convexValidator, inputArgs),
 				...returnValidator,
 				handler: async (ctx, allArgs) => {
-					const added = await customInput(ctx, pick(allArgs, Object.keys(inputArgs)), extra);
-					const rawArgs = pick(allArgs, Object.keys(argsValidator));
-					const parsed = await z$1.object(argsValidator).safeParseAsync(rawArgs);
+					const added = await customInput(ctx, inputArgKeys.length === 0 ? {} : pickKeys(allArgs, inputArgKeySet), extra);
+					const rawArgs = pickKeys(allArgs, argKeySet);
+					argsSchema ??= z$1.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;
 					const ret = await handler({
@@ -529,7 +546,7 @@ function customFnBuilder(builder, customization) {
 						...args,
 						...added.args
 					});
-					const result = returns ? await returns.parseAsync(ret === void 0 ? null : ret) : ret;
+					const result = parseReturns ? await parseReturns(ret) : ret;
 					if (added.onSuccess) await added.onSuccess({
 						ctx,
 						args,
@@ -551,7 +568,7 @@ function customFnBuilder(builder, customization) {
 					...args,
 					...added.args
 				});
-				const result = returns ? await returns.parseAsync(ret === void 0 ? null : ret) : ret;
+				const result = parseReturns ? await parseReturns(ret) : ret;
 				if (added.onSuccess) await added.onSuccess({
 					ctx,
 					args,
@@ -971,29 +988,51 @@ function getBaseSchema(schema) {
 	if (schema instanceof z.ZodDefault) return getBaseSchema(schema._def.innerType);
 	return schema;
 }
-function isArraySchema(schema) {
-	return getBaseSchema(schema) instanceof z.ZodArray;
-}
-function isNumberSchema(schema) {
-	return getBaseSchema(schema) instanceof z.ZodNumber;
-}
-function isBooleanSchema(schema) {
-	return getBaseSchema(schema) instanceof z.ZodBoolean;
+/**
+* Resolve each field's coercion kind from the query schema, once.
+*
+* The kind is a static property of the schema, but zod 4 overrides
+* `Symbol.hasInstance`, so leaving it in the request path pays a `Set.has`
+* per unwrap step per field per request.
+*
+* Fields absent from the map fall through to the raw string(s) branch, which
+* is also where a non-`ZodObject` query schema lands (it has no readable
+* shape, so it gets no coercion at all).
+*/
+function buildQueryCoercion(schema) {
+	const coercion = /* @__PURE__ */ new Map();
+	if (!(schema instanceof z.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");
+	}
+	return coercion;
 }
-function parseQueryParams(url, schema) {
+function parseQueryParams(url, coercion) {
 	const params = {};
-	const keys = new Set(url.searchParams.keys());
-	const shape = schema instanceof z.ZodObject ? schema.shape : {};
-	for (const key of keys) {
-		const values = url.searchParams.getAll(key);
-		const fieldSchema = shape[key];
-		if (fieldSchema) if (isArraySchema(fieldSchema)) params[key] = values;
-		else if (isNumberSchema(fieldSchema)) params[key] = Number(values[0]);
-		else if (isBooleanSchema(fieldSchema)) {
+	const collected = /* @__PURE__ */ new Map();
+	for (const [key, value] of url.searchParams) {
+		const existing = collected.get(key);
+		if (existing) existing.push(value);
+		else collected.set(key, [value]);
+	}
+	for (const [key, values] of collected) switch (coercion.get(key)) {
+		case "array":
+			params[key] = values;
+			break;
+		case "number":
+			params[key] = Number(values[0]);
+			break;
+		case "boolean": {
 			const val = values[0].toLowerCase();
 			params[key] = val === "true" || val === "1";
-		} else params[key] = values.length === 1 ? values[0] : values;
-		else params[key] = values.length === 1 ? values[0] : values;
+			break;
+		}
+		default:
+			params[key] = values.length === 1 ? values[0] : values;
+			break;
 	}
 	return params;
 }
@@ -1017,6 +1056,7 @@ function resolveHttpProcedureInfo(def) {
 function createProcedure(def, handler, _type) {
 	if (!def.route) throw new Error("Route must be defined before action. Use .route(path, method) first.");
 	const middlewareProcedure = resolveHttpProcedureInfo(def);
+	const queryCoercion = buildQueryCoercion(def.querySchema);
 	/**
 	* Hono-compatible handler function.
 	* When used with HttpRouterWithHono, Convex ctx is passed via c.env.
@@ -1046,7 +1086,7 @@ function createProcedure(def, handler, _type) {
 				}
 				let parsedQuery;
 				if (def.querySchema) {
-					const queryParams = parseQueryParams(url, def.querySchema);
+					const queryParams = parseQueryParams(url, queryCoercion);
 					try {
 						parsedQuery = def.querySchema.parse(queryParams);
 					} catch (error) {
@@ -1720,24 +1760,18 @@ const replaceUnencodableInputTypes = (schema) => {
 * unchanged) but carries no checks, transforms, or defaults. cRPC's own
 * `.input()` parse stays the single authoritative one, so refinements and
 * transforms never run twice.
+*
+* Throws when the shape has no Convex equivalent, which is also the
+* feasibility test `resolveConvexArgsShape` steps down its fallback ladder on.
 */
-const toWireShape = (shape) => {
-	try {
-		return convexToZodFields(zodToConvexFields(shape));
-	} catch {
-		return shape;
-	}
-};
+const toWireShape = (shape) => convexToZodFields(zodToConvexFields(shape));
 const resolveConvexArgsShape = (inputShape) => {
 	if (!inputShape) return;
-	const rawSchema = z.object(inputShape);
 	try {
-		zodToConvex(rawSchema);
 		return toWireShape(inputShape);
 	} catch {
-		const compatibleSchema = replaceUnencodableInputTypes(rawSchema);
+		const compatibleSchema = replaceUnencodableInputTypes(z.object(inputShape));
 		try {
-			zodToConvex(compatibleSchema);
 			return toWireShape(compatibleSchema.shape);
 		} catch {
 			return Object.fromEntries(Object.keys(inputShape).map((key) => [key, z.any()]));
@@ -1760,6 +1794,29 @@ const relaxSupersededKeys = (schema, superseded) => {
 		return schema;
 	}
 };
+const buildInputPlan = (inputSchemas) => {
+	if (inputSchemas.length === 1) return {
+		entries: [],
+		single: inputSchemas[0]
+	};
+	const ownerOf = /* @__PURE__ */ new Map();
+	inputSchemas.forEach((schema, index) => {
+		for (const key of Object.keys(schema.shape)) ownerOf.set(key, index);
+	});
+	return { entries: inputSchemas.map((schema, index) => {
+		const keys = Object.keys(schema.shape);
+		const owned = [];
+		const superseded = /* @__PURE__ */ new Set();
+		for (const key of keys) if (ownerOf.get(key) === index) owned.push(key);
+		else superseded.add(key);
+		return {
+			keys,
+			owned,
+			scoped: relaxSupersededKeys(schema, [...superseded]),
+			superseded
+		};
+	}) };
+};
 /**
 * Parse the wire payload through every `.input()` schema.
 *
@@ -1768,20 +1825,14 @@ const relaxSupersededKeys = (schema, superseded) => {
 * so object-level checks run against the shape they were written for without an
 * earlier, superseded declaration vetoing the payload.
 */
-const parseInput = (inputSchemas, value) => {
+const parseInput = (plan, value) => {
 	try {
-		if (inputSchemas.length === 1) return inputSchemas[0].parse(value);
-		const ownerOf = /* @__PURE__ */ new Map();
-		inputSchemas.forEach((schema, index) => {
-			for (const key of Object.keys(schema.shape)) ownerOf.set(key, index);
-		});
+		if (plan.single) return plan.single.parse(value);
+		const { entries } = plan;
 		const source = isPlainObject(value) ? value : {};
 		const parsed = {};
-		for (let index = inputSchemas.length - 1; index >= 0; index -= 1) {
-			const schema = inputSchemas[index];
-			const keys = Object.keys(schema.shape);
-			const superseded = new Set(keys.filter((key) => ownerOf.get(key) !== index));
-			const scoped = relaxSupersededKeys(schema, [...superseded]);
+		for (let index = entries.length - 1; index >= 0; index -= 1) {
+			const { keys, owned, scoped, superseded } = entries[index];
 			const narrowed = {};
 			for (const key of keys) {
 				if (superseded.has(key)) {
@@ -1791,7 +1842,7 @@ const parseInput = (inputSchemas, value) => {
 				if (Object.hasOwn(source, key)) narrowed[key] = source[key];
 			}
 			const result = scoped.parse(narrowed);
-			for (const key of keys) if (ownerOf.get(key) === index && key in result) parsed[key] = result[key];
+			for (const key of owned) if (key in result) parsed[key] = result[key];
 		}
 		return parsed;
 	} catch (cause) {
@@ -1877,19 +1928,21 @@ var ProcedureBuilder = class {
 	_createFunction(handler, baseFunction, customFn, fnType) {
 		const { middlewares, inputSchemas, outputSchema, meta, procedureName, functionConfig, isInternal } = this._def;
 		const convexArgs = resolveConvexArgsShape(this._getMergedInput());
+		const inputPlan = buildInputPlan(inputSchemas);
 		const customFunction = customFn(baseFunction, customCtx(async (_ctx) => withConvexSafeRunners(await functionConfig.createContext(_ctx))));
-		const returnsSchema = resolveConvexReturnsSchema(outputSchema);
-		const typedReturnsSchema = returnsSchema;
+		const typedReturnsSchema = resolveConvexReturnsSchema(outputSchema);
 		const typedArgs = convexArgs ?? {};
-		const shouldValidateOutputWithZod = !!outputSchema && returnsSchema !== outputSchema;
 		const resolvedProcedureName = procedureName ?? inferProcedureNameFromCallsite();
 		let fn;
 		fn = customFunction({
 			args: typedArgs,
-			...typedReturnsSchema ? { returns: typedReturnsSchema } : {},
+			...typedReturnsSchema ? {
+				returns: typedReturnsSchema,
+				skipZodReturnsValidation: true
+			} : {},
 			handler: async (ctx, rawInput) => {
 				const decodedInput = functionConfig.transformer.input.deserialize(rawInput);
-				const parsedInput = inputSchemas.length > 0 ? parseInput(inputSchemas, decodedInput) : decodedInput;
+				const parsedInput = inputSchemas.length > 0 ? parseInput(inputPlan, decodedInput) : decodedInput;
 				const getRawInput = async () => parsedInput;
 				try {
 					const result = await executeMiddlewares(middlewares, ctx, meta, resolveProcedureInfo(fnType, resolvedProcedureName, fn), parsedInput, getRawInput, async ({ ctx: resolvedCtx, input: resolvedInput }) => {
@@ -1898,7 +1951,7 @@ var ProcedureBuilder = class {
 							input: resolvedInput === parsedInput ? parsedInput : functionConfig.transformer.input.deserialize(resolvedInput ?? parsedInput)
 						});
 					});
-					const validatedOutput = shouldValidateOutputWithZod ? outputSchema.parse(result.output) : result.output;
+					const validatedOutput = outputSchema ? await outputSchema.parseAsync(result.output) : result.output;
 					return functionConfig.transformer.output.serialize(validatedOutput);
 				} catch (cause) {
 					const err = toCRPCError(cause);

package/dist/{caller-factory-DHywSoGZ.js → caller-factory-CWa0ELLD.js}

@@ -1,6 +1,6 @@
 import { n as defaultIsUnauthorized } from "./error-Bvo7YEhk.js";
 import { i as getFunctionType, n as getFuncRef, t as buildMetaIndex } from "./meta-utils-D9K4fICl.js";
-import { s as getTransformer } from "./transformer-C6pGVHqx.js";
+import { s as getTransformer } from "./transformer-yZuBWo8v.js";
 import { fetchAction, fetchMutation, fetchQuery } from "convex/nextjs";
 
 //#region src/server/caller.ts

package/dist/crpc/index.d.ts

@@ -1,5 +1,5 @@
-import { A as DataTransformer, F as decodeWire, I as defaultCRPCTransformer, L as encodeWire, M as WireCodec, N as createTaggedTransformer, O as CombinedDataTransformer, P as dateWireCodec, R as getTransformer, a as HttpProcedureCall, c as InferHttpInput, i as HttpErrorCode, j as DataTransformerOptions, k as DATE_CODEC_TAG, l as InferHttpOutput, n as HttpClientError, o as HttpRouteInfo, r as HttpClientFromRouter, s as HttpRouteMap, t as HttpClient, u as isHttpClientError, z as identityTransformer } from "../http-types-zsMHb_QN.js";
-import { A as HttpInputArgs, C as ReservedMutationOptions, D as VanillaMutation, E as VanillaAction, F as replaceUrlParam, M as RESERVED_KEYS, N as buildSearchParams, O as HttpClientOptions, P as executeHttpRequest, S as ReservedInfiniteQueryOptions, T as StaticQueryOptsParam, _ as IsPaginated, a as BaseInfiniteQueryOptsParam, b as PaginatedFnMeta, c as ConvexMutationKey, d as ConvexQueryMeta, f as EmptyObject, g as InfiniteQueryInput, h as FnMeta, i as BaseConvexQueryOptions, j as HttpProxyBaseOptions, k as HttpFormValue, l as ConvexQueryHookOptions, m as FUNC_REF_SYMBOL, n as BaseConvexActionOptions, o as ConvexActionKey, p as ExtractPaginatedItem, r as BaseConvexInfiniteQueryOptions, s as ConvexInfiniteQueryMeta, t as AuthType, u as ConvexQueryKey, v as Meta, w as ReservedQueryOptions, x as PaginationOpts, y as MutationVariables } from "../types-jNTcza_a.js";
+import { A as DataTransformer, F as decodeWire, I as defaultCRPCTransformer, L as encodeWire, M as WireCodec, N as createTaggedTransformer, O as CombinedDataTransformer, P as dateWireCodec, R as getTransformer, a as HttpProcedureCall, c as InferHttpInput, i as HttpErrorCode, j as DataTransformerOptions, k as DATE_CODEC_TAG, l as InferHttpOutput, n as HttpClientError, o as HttpRouteInfo, r as HttpClientFromRouter, s as HttpRouteMap, t as HttpClient, u as isHttpClientError, z as identityTransformer } from "../http-types-BoSDAh4Y.js";
+import { A as HttpInputArgs, C as ReservedMutationOptions, D as VanillaMutation, E as VanillaAction, F as replaceUrlParam, M as RESERVED_KEYS, N as buildSearchParams, O as HttpClientOptions, P as executeHttpRequest, S as ReservedInfiniteQueryOptions, T as StaticQueryOptsParam, _ as IsPaginated, a as BaseInfiniteQueryOptsParam, b as PaginatedFnMeta, c as ConvexMutationKey, d as ConvexQueryMeta, f as EmptyObject, g as InfiniteQueryInput, h as FnMeta, i as BaseConvexQueryOptions, j as HttpProxyBaseOptions, k as HttpFormValue, l as ConvexQueryHookOptions, m as FUNC_REF_SYMBOL, n as BaseConvexActionOptions, o as ConvexActionKey, p as ExtractPaginatedItem, r as BaseConvexInfiniteQueryOptions, s as ConvexInfiniteQueryMeta, t as AuthType, u as ConvexQueryKey, v as Meta, w as ReservedQueryOptions, x as PaginationOpts, y as MutationVariables } from "../types-C0Xl7P8K.js";
 import { FunctionArgs, FunctionReference } from "convex/server";
 
 //#region src/crpc/auth-error.d.ts

package/dist/crpc/index.js

@@ -1,5 +1,5 @@
 import { a as isCRPCErrorCode, i as isCRPCError, n as defaultIsUnauthorized, r as isCRPCClientError, t as CRPCClientError } from "../error-Bvo7YEhk.js";
-import { a as defaultCRPCTransformer, c as identityTransformer, i as decodeWire, n as createTaggedTransformer, o as encodeWire, r as dateWireCodec, s as getTransformer, t as DATE_CODEC_TAG } from "../transformer-C6pGVHqx.js";
+import { a as defaultCRPCTransformer, c as identityTransformer, i as decodeWire, n as createTaggedTransformer, o as encodeWire, r as dateWireCodec, s as getTransformer, t as DATE_CODEC_TAG } from "../transformer-yZuBWo8v.js";
 import { a as buildSearchParams, c as HttpClientError, i as RESERVED_KEYS, l as isHttpClientError, n as convexInfiniteQueryOptions, o as executeHttpRequest, r as convexQuery, s as replaceUrlParam, t as convexAction } from "../query-options-C_eBSIXG.js";
 
 //#region src/crpc/auth-error.ts

package/dist/{http-types-zsMHb_QN.d.ts → http-types-BoSDAh4Y.d.ts}

@@ -30,6 +30,18 @@ interface WireCodec {
   decode(value: unknown): unknown;
   encode(value: unknown): unknown;
   isType(value: unknown): boolean;
+  /**
+   * Declares that `isType` only ever claims a value where
+   * `typeof value === 'object' && value !== null` - never a primitive, a
+   * function, `null` or `undefined`.
+   *
+   * Lets `serialize` skip codec dispatch on primitives, which are the majority
+   * of visited nodes. It is opt-in because an arbitrary predicate cannot be
+   * classified by sampling values: a codec that claims, say, one specific
+   * number would be misread as object-only and silently lose its encoding.
+   * Codecs that leave it unset keep full dispatch.
+   */
+  readonly objectsOnly?: boolean;
   readonly tag: `$${string}`;
 }
 /**
@@ -51,6 +63,9 @@ declare const defaultCRPCTransformer: DataTransformer;
 /**
  * Normalize transformer config to split input/output shape.
  * User transformers are additive and always composed with default Date handling.
+ *
+ * Idempotent: passing a transformer this function already resolved returns it
+ * unchanged.
  */
 declare const getTransformer: (transformer?: DataTransformerOptions) => CombinedDataTransformer;
 /**

package/dist/{middleware-qzHEHaDy.js → middleware-DUd1Sj39.js}

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

package/dist/plugins/index.js

@@ -1,3 +1,3 @@
-import { n as resolvePluginOptions, t as definePlugin } from "../middleware-qzHEHaDy.js";
+import { n as resolvePluginOptions, t as definePlugin } from "../middleware-DUd1Sj39.js";
 
 export { definePlugin, resolvePluginOptions };

package/dist/{procedure-caller-JB9kjYsy.js → procedure-caller-DQxnLBS_.js}

@@ -1,5 +1,5 @@
-import { i as decodeWire, o as encodeWire } from "./transformer-C6pGVHqx.js";
-import { _ as CRPCError } from "./builder-Dwy6D2QA.js";
+import { i as decodeWire, o as encodeWire } from "./transformer-yZuBWo8v.js";
+import { _ as CRPCError } from "./builder-CsxVc5xC.js";
 import { z } from "zod";
 
 //#region src/server/env.ts

package/dist/{procedure-name-exVcmr_p.d.ts → procedure-name-C55TynK3.d.ts}

@@ -1,5 +1,5 @@
 import { t as VRequired } from "./validators-BhsByJeg.js";
-import { C as HttpProcedure, D as ProcedureMeta, R as getTransformer, S as HttpMethod, c as InferHttpInput, d as CRPCHttpRouter, j as DataTransformerOptions, l as InferHttpOutput, p as HttpRouterRecord, w as HttpProcedureBuilderDef, x as HttpHandlerOpts } from "./http-types-zsMHb_QN.js";
+import { C as HttpProcedure, D as ProcedureMeta, R as getTransformer, S as HttpMethod, c as InferHttpInput, d as CRPCHttpRouter, j as DataTransformerOptions, l as InferHttpOutput, p as HttpRouterRecord, w as HttpProcedureBuilderDef, x as HttpHandlerOpts } from "./http-types-BoSDAh4Y.js";
 import { g as UnsetMarker, i as IntersectIfDefined, o as MiddlewareBuilder, p as Overwrite$1, s as MiddlewareFunction, t as AnyMiddleware } from "./types-CnTpHR1F.js";
 import { ConvexError, GenericId, GenericValidator, ObjectType, OptionalProperty, PropertyValidators, VAny, VArray, VBoolean, VBytes, VFloat64, VId, VInt64, VLiteral, VNull, VObject, VOptional, VRecord, VString, VUnion, Validator, Value as Value$1 } from "convex/values";
 import { ActionBuilder, ArgsArrayToObject, DefaultFunctionArgs, FunctionReference, FunctionReturnType, FunctionVisibility, GenericActionCtx, GenericDataModel, GenericMutationCtx, GenericQueryCtx, MutationBuilder, QueryBuilder, RegisteredAction, RegisteredMutation, RegisteredQuery, TableNamesInDataModel } from "convex/server";
@@ -497,14 +497,17 @@ declare function withSystemFields<Table extends string, T extends {
  * arguments. If the customization requires arguments, however, the resulting
  * builder will require argument validation too.
  */
-type CustomBuilder<FuncType extends 'query' | 'mutation' | 'action', CustomArgsValidator extends PropertyValidators, CustomCtx extends Record<string, any>, CustomMadeArgs extends Record<string, any>, InputCtx, Visibility extends FunctionVisibility, ExtraArgs extends Record<string, any>> = <ArgsValidator extends ZodFields | zCore.$ZodObject<any> | void, ReturnsZodValidator extends zCore.$ZodType | ZodFields | void = void, ReturnValue extends ReturnValueInput<ReturnsZodValidator> = any>(func: ({
+type CustomBuilder<FuncType extends 'query' | 'mutation' | 'action', CustomArgsValidator extends PropertyValidators, CustomCtx extends Record<string, any>, CustomMadeArgs extends Record<string, any>, InputCtx, Visibility extends FunctionVisibility, ExtraArgs extends Record<string, any>> = <ArgsValidator extends ZodFields | zCore.$ZodObject<any> | void, ReturnsZodValidator extends zCore.$ZodType | ZodFields | void = void, SkipZodReturnsValidation extends boolean = false, ReturnValue extends ReturnValueForHandler<ReturnsZodValidator, SkipZodReturnsValidation> = any>(func: ({
   /**
    * Specify the arguments to the function as a Zod validator.
    */
   args?: ArgsValidator;
   handler: (ctx: Overwrite<InputCtx, CustomCtx>, ...args: ArgsForHandlerType<ArgsOutput<ArgsValidator>, CustomMadeArgs>) => ReturnValue;
   /**
-   * Validates the value returned by the function.
+   * Validates the value returned by the function, and declares the
+   * Convex `returns` validator from the schema's output type. The Zod
+   * parse runs first, so the handler returns the schema's *input* type
+   * and the client receives its *output* type.
    * Note: you can't pass an object directly without wrapping it
    * in `z.object()`.
    */
@@ -514,12 +517,23 @@ type CustomBuilder<FuncType extends 'query' | 'mutation' | 'action', CustomArgsV
    * in case you're seeing performance issues with validating twice.
    */
   skipConvexValidation?: boolean;
-} & { [key in keyof ExtraArgs as key extends 'args' | 'handler' | 'skipConvexValidation' | 'returns' ? never : key]: ExtraArgs[key] }) | ((ctx: Overwrite<InputCtx, CustomCtx>, ...args: ArgsForHandlerType<ArgsOutput<ArgsValidator>, CustomMadeArgs>) => ReturnValue)) => Registration<FuncType, Visibility, ArgsArrayToObject<CustomArgsValidator extends Record<string, never> ? ArgsInput<ArgsValidator> : ArgsInput<ArgsValidator> extends [infer A] ? [Expand<A & ObjectType<CustomArgsValidator>>] : [ObjectType<CustomArgsValidator>]>, ReturnsZodValidator extends void ? ReturnValue : ReturnValueOutput<ReturnsZodValidator>>;
+  /**
+   * If true, `returns` only declares the Convex validator and the return
+   * type - the Zod parse is skipped. The handler's value reaches Convex
+   * unchanged, so it must already be the schema's *output* type, which
+   * is what the handler is then typed as.
+   *
+   * For callers that already parse the response themselves. Combined
+   * with `skipConvexValidation`, nothing validates the return value.
+   */
+  skipZodReturnsValidation?: SkipZodReturnsValidation;
+} & { [key in keyof ExtraArgs as key extends 'args' | 'handler' | 'skipConvexValidation' | 'skipZodReturnsValidation' | 'returns' ? never : key]: ExtraArgs[key] }) | ((ctx: Overwrite<InputCtx, CustomCtx>, ...args: ArgsForHandlerType<ArgsOutput<ArgsValidator>, CustomMadeArgs>) => ReturnValue)) => Registration<FuncType, Visibility, ArgsArrayToObject<CustomArgsValidator extends Record<string, never> ? ArgsInput<ArgsValidator> : ArgsInput<ArgsValidator> extends [infer A] ? [Expand<A & ObjectType<CustomArgsValidator>>] : [ObjectType<CustomArgsValidator>]>, ReturnsZodValidator extends void ? ReturnValue : ReturnValueOutput<ReturnsZodValidator>>;
 type ArgsForHandlerType<OneOrZeroArgs extends [] | [Record<string, any>], CustomMadeArgs extends Record<string, any>> = CustomMadeArgs extends Record<string, never> ? OneOrZeroArgs : OneOrZeroArgs extends [infer A] ? [Expand<A & CustomMadeArgs>] : [CustomMadeArgs];
 type NullToUndefinedOrNull<T> = T extends null ? T | undefined | void : T;
 type Returns<T> = Promise<NullToUndefinedOrNull<T>> | NullToUndefinedOrNull<T>;
 type ReturnValueInput<ReturnsValidator extends zCore.$ZodType | ZodFields | void> = [ReturnsValidator] extends [zCore.$ZodType] ? Returns<zCore.input<ReturnsValidator>> : [ReturnsValidator] extends [ZodFields] ? Returns<zCore.input<zCore.$ZodObject<ReturnsValidator>>> : any;
 type ReturnValueOutput<ReturnsValidator extends zCore.$ZodType | ZodFields | void> = [ReturnsValidator] extends [zCore.$ZodType] ? Returns<zCore.output<ReturnsValidator>> : [ReturnsValidator] extends [ZodFields] ? Returns<zCore.output<zCore.$ZodObject<ReturnsValidator, zCore.$strict>>> : any;
+type ReturnValueForHandler<ReturnsValidator extends zCore.$ZodType | ZodFields | void, SkipZodReturnsValidation extends boolean> = SkipZodReturnsValidation extends true ? ReturnValueOutput<ReturnsValidator> : ReturnValueInput<ReturnsValidator>;
 type ArgsInput<ArgsValidator extends ZodFields | zCore.$ZodObject<any> | void> = [ArgsValidator] extends [zCore.$ZodObject<any>] ? [zCore.input<ArgsValidator>] : ArgsValidator extends Record<string, never> ? [{}] : [ArgsValidator] extends [Record<string, z$1.ZodTypeAny>] ? [zCore.input<zCore.$ZodObject<ArgsValidator, zCore.$strict>>] : OneArgArray;
 type ArgsOutput<ArgsValidator extends ZodFields | zCore.$ZodObject<any> | void> = [ArgsValidator] extends [zCore.$ZodObject<any>] ? [zCore.output<ArgsValidator>] : [ArgsValidator] extends [ZodFields] ? [zCore.output<zCore.$ZodObject<ArgsValidator, zCore.$strict>>] : OneArgArray;
 type Overwrite<T, U> = Omit<T, keyof U> & U;
@@ -814,7 +828,7 @@ declare class QueryProcedureBuilder<TBaseCtx, TContext, TContextOverrides extend
   query<TResult>(handler: (opts: {
     ctx: Overwrite$1<TContext, TContextOverrides>;
     input: InferInput<TInput>;
-  }) => Promise<TOutput extends z.ZodTypeAny ? z.infer<TOutput> : TResult>): Record<string, unknown> & CRPCFunctionTypeHint<InferClientInput<TClientInput>, TOutput extends z.ZodTypeAny ? z.infer<TOutput> : TResult>;
+  }) => Promise<TOutput extends z.ZodTypeAny ? z.input<TOutput> : TResult>): Record<string, unknown> & CRPCFunctionTypeHint<InferClientInput<TClientInput>, TOutput extends z.ZodTypeAny ? z.output<TOutput> : TResult>;
   /** Mark as internal - returns chainable builder using internal function */
   internal(): QueryProcedureBuilder<TBaseCtx, TContext, TContextOverrides, TInput, TClientInput, TOutput, TMeta>;
 }
@@ -842,7 +856,7 @@ declare class MutationProcedureBuilder<TBaseCtx, TContext, TContextOverrides ext
   mutation<TResult>(handler: (opts: {
     ctx: Overwrite$1<TContext, TContextOverrides>;
     input: InferInput<TInput>;
-  }) => Promise<TOutput extends z.ZodTypeAny ? z.infer<TOutput> : TResult>): Record<string, unknown> & CRPCFunctionTypeHint<InferClientInput<TInput>, TOutput extends z.ZodTypeAny ? z.infer<TOutput> : TResult>;
+  }) => Promise<TOutput extends z.ZodTypeAny ? z.input<TOutput> : TResult>): Record<string, unknown> & CRPCFunctionTypeHint<InferClientInput<TInput>, TOutput extends z.ZodTypeAny ? z.output<TOutput> : TResult>;
   /** Mark as internal - returns chainable builder using internal function */
   internal(): MutationProcedureBuilder<TBaseCtx, TContext, TContextOverrides, TInput, TOutput, TMeta>;
 }
@@ -866,7 +880,7 @@ declare class ActionProcedureBuilder<TBaseCtx, TContext, TContextOverrides exten
   action<TResult>(handler: (opts: {
     ctx: Overwrite$1<TContext, TContextOverrides>;
     input: InferInput<TInput>;
-  }) => Promise<TOutput extends z.ZodTypeAny ? z.infer<TOutput> : TResult>): Record<string, unknown> & CRPCFunctionTypeHint<InferClientInput<TInput>, TOutput extends z.ZodTypeAny ? z.infer<TOutput> : TResult>;
+  }) => Promise<TOutput extends z.ZodTypeAny ? z.input<TOutput> : TResult>): Record<string, unknown> & CRPCFunctionTypeHint<InferClientInput<TInput>, TOutput extends z.ZodTypeAny ? z.output<TOutput> : TResult>;
   /** Mark as internal - returns chainable builder using internal function */
   internal(): ActionProcedureBuilder<TBaseCtx, TContext, TContextOverrides, TInput, TOutput, TMeta>;
 }

package/dist/ratelimit/index.js

@@ -1,6 +1,6 @@
 import { u as requireMutationCtx } from "../api-entry-N3nBOlI2.js";
-import { _ as CRPCError } from "../builder-Dwy6D2QA.js";
-import { t as definePlugin } from "../middleware-qzHEHaDy.js";
+import { _ as CRPCError } from "../builder-CsxVc5xC.js";
+import { t as definePlugin } from "../middleware-DUd1Sj39.js";
 import { v } from "convex/values";
 import { mutationGeneric, queryGeneric } from "convex/server";
 

package/dist/react/index.js

@@ -278,6 +278,7 @@ const DATE_CODEC_TAG = "$date";
 */
 const dateWireCodec = {
 	tag: DATE_CODEC_TAG,
+	objectsOnly: true,
 	isType: (value) => value instanceof Date,
 	encode: (value) => value.getTime(),
 	decode: (value) => {
@@ -286,6 +287,40 @@ const dateWireCodec = {
 	}
 };
 /**
+* One value per primitive `typeof` result, plus the values the object fast path
+* would otherwise skip.
+*/
+const PRIMITIVE_PROBES = [
+	void 0,
+	null,
+	"",
+	0,
+	NaN,
+	false,
+	0n,
+	Symbol("kitcn.codec.probe"),
+	() => void 0
+];
+/**
+* Falsify an `objectsOnly` declaration against representative primitives.
+*
+* Sampling cannot prove a predicate object-only, so it never *infers* the
+* capability - it only rejects the misdeclarations it can catch
+* (`typeof value === 'bigint'`, `value === null`, ...) before they silently
+* drop a value's wire encoding. A codec that throws on a probe owns that.
+*/
+const assertObjectsOnly = (codec) => {
+	for (const probe of PRIMITIVE_PROBES) {
+		let claimed = false;
+		try {
+			claimed = codec.isType(probe);
+		} catch {
+			continue;
+		}
+		if (claimed) throw new Error(`Wire codec '${codec.tag}' declares objectsOnly, but isType() claims ${probe === null ? "null" : typeof probe}. Drop objectsOnly so the codec keeps receiving non-object values.`);
+	}
+};
+/**
 * Build a recursive tagged transformer from codecs.
 */
 const createTaggedTransformer = (codecs) => {
@@ -293,9 +328,12 @@ const createTaggedTransformer = (codecs) => {
 	for (const codec of codecs) {
 		if (!codec.tag.startsWith("$")) throw new Error(`Invalid wire codec tag '${codec.tag}'. Tags must start with '$'.`);
 		if (codecByTag.has(codec.tag)) throw new Error(`Duplicate wire codec tag '${codec.tag}'.`);
+		if (codec.objectsOnly) assertObjectsOnly(codec);
 		codecByTag.set(codec.tag, codec);
 	}
+	const skipNonObjects = codecs.every((codec) => codec.objectsOnly === true);
 	const serialize = (value) => {
+		if (skipNonObjects && (value === null || typeof value !== "object")) return value;
 		for (const codec of codecs) if (codec.isType(value)) return {
 			[CODEC_MARKER_KEY]: CODEC_MARKER_VALUE,
 			[CODEC_TAG_KEY]: codec.tag,
@@ -329,6 +367,7 @@ const createTaggedTransformer = (codecs) => {
 		return value;
 	};
 	const deserialize = (value) => {
+		if (value === null || typeof value !== "object") return value;
 		if (Array.isArray(value)) {
 			let result;
 			for (let index = 0; index < value.length; index += 1) {
@@ -394,16 +433,20 @@ const normalizeCustomTransformer = (transformer) => {
 * - deserialize: default(Date) -> user
 */
 const composeWithDefault = (transformer) => {
-	if (!transformer) return defaultCRPCTransformer;
+	if (!transformer || transformer === defaultCRPCTransformer) return defaultCRPCTransformer;
 	return {
 		serialize: (value) => defaultCRPCTransformer.serialize(transformer.serialize(value)),
 		deserialize: (value) => transformer.deserialize(defaultCRPCTransformer.deserialize(value))
 	};
 };
 const transformerCache = /* @__PURE__ */ new WeakMap();
+transformerCache.set(DEFAULT_COMBINED_TRANSFORMER, DEFAULT_COMBINED_TRANSFORMER);
 /**
 * Normalize transformer config to split input/output shape.
 * User transformers are additive and always composed with default Date handling.
+*
+* Idempotent: passing a transformer this function already resolved returns it
+* unchanged.
 */
 const getTransformer = (transformer) => {
 	if (!transformer) return DEFAULT_COMBINED_TRANSFORMER;
@@ -416,6 +459,7 @@ const getTransformer = (transformer) => {
 		output: composeWithDefault(custom?.output)
 	};
 	transformerCache.set(cacheKey, resolved);
+	transformerCache.set(resolved, resolved);
 	return resolved;
 };
 /**

package/dist/rsc/index.d.ts

@@ -1,7 +1,7 @@
 import { n as DeepPartial, o as Simplify, r as DistributiveOmit } from "../types-DF2cg_w0.js";
-import { C as HttpProcedure, d as CRPCHttpRouter, j as DataTransformerOptions, p as HttpRouterRecord } from "../http-types-zsMHb_QN.js";
+import { C as HttpProcedure, d as CRPCHttpRouter, j as DataTransformerOptions, p as HttpRouterRecord } from "../http-types-BoSDAh4Y.js";
 import { g as UnsetMarker } from "../types-CnTpHR1F.js";
-import { A as HttpInputArgs, C as ReservedMutationOptions$1, S as ReservedInfiniteQueryOptions, T as StaticQueryOptsParam, _ as IsPaginated, b as PaginatedFnMeta, c as ConvexMutationKey, d as ConvexQueryMeta, f as EmptyObject, g as InfiniteQueryInput, l as ConvexQueryHookOptions, m as FUNC_REF_SYMBOL, o as ConvexActionKey, p as ExtractPaginatedItem, s as ConvexInfiniteQueryMeta, u as ConvexQueryKey, w as ReservedQueryOptions$1, y as MutationVariables } from "../types-jNTcza_a.js";
+import { A as HttpInputArgs, C as ReservedMutationOptions$1, S as ReservedInfiniteQueryOptions, T as StaticQueryOptsParam, _ as IsPaginated, b as PaginatedFnMeta, c as ConvexMutationKey, d as ConvexQueryMeta, f as EmptyObject, g as InfiniteQueryInput, l as ConvexQueryHookOptions, m as FUNC_REF_SYMBOL, o as ConvexActionKey, p as ExtractPaginatedItem, s as ConvexInfiniteQueryMeta, u as ConvexQueryKey, w as ReservedQueryOptions$1, y as MutationVariables } from "../types-C0Xl7P8K.js";
 import { FunctionArgs, FunctionReference, FunctionReturnType } from "convex/server";
 import { z } from "zod";
 import { DefaultError, QueryFilters, SkipToken, UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";

package/dist/rsc/index.js

@@ -1,6 +1,6 @@
 import { n as defaultIsUnauthorized } from "../error-Bvo7YEhk.js";
 import { n as getFuncRef, r as getFunctionMeta, t as buildMetaIndex } from "../meta-utils-D9K4fICl.js";
-import { o as encodeWire, s as getTransformer } from "../transformer-C6pGVHqx.js";
+import { o as encodeWire, s as getTransformer } from "../transformer-yZuBWo8v.js";
 import { n as convexInfiniteQueryOptions, o as executeHttpRequest, r as convexQuery } from "../query-options-C_eBSIXG.js";
 import { convexToJson } from "convex/values";
 import { getFunctionName } from "convex/server";

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-import { $ as ActionProcedureBuilder, A as CRPCError, B as RuntimeEnv, C as createProcedureHandlerFactory, Ct as zCustomQuery, D as WithHttpRouter, Dt as zodToConvex, E as typedProcedureResolver, Et as zodOutputToConvexFields, F as getCRPCErrorFromUnknown, G as createLazyCaller, H as ConvexContext, I as getHTTPStatusCodeFromError, J as ServerCaller, K as CallerMeta, L as isCRPCError, M as CRPCErrorData, N as CRPC_ERROR_CODES_BY_KEY, O as inferApiInputs, Ot as zodToConvexFields, P as CRPC_ERROR_CODE_TO_HTTP, Q as getGeneratedValue, R as toCRPCError, S as createProcedureCallerFactory, St as zCustomMutation, T as getGeneratedFunctionReference, Tt as zodOutputToConvex, U as createCallerFactory, V as createEnv, W as LazyCaller, X as createApiLeaf, Y as createServerCaller, Z as createGeneratedFunctionReference, _ as ProcedureSchedulableCallerFromRegistry, _t as ZodValidatorFromConvex, a as CreateProcedureCallerFactoryOptions, at as initCRPC, b as createGenericCallerFactory, bt as withSystemFields, c as GeneratedRegistryCallerFactory, ct as extractPathParams, d as GeneratedRegistryHandlerForContext, dt as ConvexValidatorFromZod, et as CRPCFunctionTypeHint, f as ProcedureActionCallerFromRegistry, ft as ConvexValidatorFromZodOutput, g as ProcedureFromFunctionReference, gt as ZodFromValidatorBase, h as ProcedureDefinition, ht as Zid, i as registerProcedureNameLookup, it as createMiddlewareFactory, j as CRPCErrorCode, k as inferApiOutputs, l as GeneratedRegistryCallerForContext, lt as handleHttpError, m as ProcedureCallerFromRegistry, mt as ZCustomCtx, n as ProcedureNameLookup, nt as ProcedureBuilder, o as GeneratedProcedureRegistry, ot as HttpProcedureBuilder, p as ProcedureCaller, pt as CustomBuilder, q as CallerOpts, r as inferProcedureNameFromCallsite, rt as QueryProcedureBuilder, s as GeneratedProcedureRegistryEntry, st as createHttpProcedureBuilder, t as ProcedureNameEntry, tt as MutationProcedureBuilder, u as GeneratedRegistryHandlerFactory, ut as matchPathParams, v as ProcedureScheduleCallerFromRegistry, vt as convexToZod, w as defineProcedure, wt as zid, x as createGenericHandlerFactory, xt as zCustomAction, y as createGeneratedRegistryRuntime, yt as convexToZodFields, z as CreateEnvOptions } from "../procedure-name-exVcmr_p.js";
-import { C as HttpProcedure, D as ProcedureMeta, E as InferHttpInput, S as HttpMethod, T as HttpRouteDefinition, _ as extractRouteMap, b as HttpActionHandler, d as CRPCHttpRouter, f as HttpRouterDef, g as createHttpRouterFactory, h as createHttpRouter, m as HttpRouterWithHono, p as HttpRouterRecord, v as CRPCHonoHandler, w as HttpProcedureBuilderDef, x as HttpHandlerOpts, y as HttpActionConstructor } from "../http-types-zsMHb_QN.js";
+import { $ as ActionProcedureBuilder, A as CRPCError, B as RuntimeEnv, C as createProcedureHandlerFactory, Ct as zCustomQuery, D as WithHttpRouter, Dt as zodToConvex, E as typedProcedureResolver, Et as zodOutputToConvexFields, F as getCRPCErrorFromUnknown, G as createLazyCaller, H as ConvexContext, I as getHTTPStatusCodeFromError, J as ServerCaller, K as CallerMeta, L as isCRPCError, M as CRPCErrorData, N as CRPC_ERROR_CODES_BY_KEY, O as inferApiInputs, Ot as zodToConvexFields, P as CRPC_ERROR_CODE_TO_HTTP, Q as getGeneratedValue, R as toCRPCError, S as createProcedureCallerFactory, St as zCustomMutation, T as getGeneratedFunctionReference, Tt as zodOutputToConvex, U as createCallerFactory, V as createEnv, W as LazyCaller, X as createApiLeaf, Y as createServerCaller, Z as createGeneratedFunctionReference, _ as ProcedureSchedulableCallerFromRegistry, _t as ZodValidatorFromConvex, a as CreateProcedureCallerFactoryOptions, at as initCRPC, b as createGenericCallerFactory, bt as withSystemFields, c as GeneratedRegistryCallerFactory, ct as extractPathParams, d as GeneratedRegistryHandlerForContext, dt as ConvexValidatorFromZod, et as CRPCFunctionTypeHint, f as ProcedureActionCallerFromRegistry, ft as ConvexValidatorFromZodOutput, g as ProcedureFromFunctionReference, gt as ZodFromValidatorBase, h as ProcedureDefinition, ht as Zid, i as registerProcedureNameLookup, it as createMiddlewareFactory, j as CRPCErrorCode, k as inferApiOutputs, l as GeneratedRegistryCallerForContext, lt as handleHttpError, m as ProcedureCallerFromRegistry, mt as ZCustomCtx, n as ProcedureNameLookup, nt as ProcedureBuilder, o as GeneratedProcedureRegistry, ot as HttpProcedureBuilder, p as ProcedureCaller, pt as CustomBuilder, q as CallerOpts, r as inferProcedureNameFromCallsite, rt as QueryProcedureBuilder, s as GeneratedProcedureRegistryEntry, st as createHttpProcedureBuilder, t as ProcedureNameEntry, tt as MutationProcedureBuilder, u as GeneratedRegistryHandlerFactory, ut as matchPathParams, v as ProcedureScheduleCallerFromRegistry, vt as convexToZod, w as defineProcedure, wt as zid, x as createGenericHandlerFactory, xt as zCustomAction, y as createGeneratedRegistryRuntime, yt as convexToZodFields, z as CreateEnvOptions } from "../procedure-name-C55TynK3.js";
+import { C as HttpProcedure, D as ProcedureMeta, E as InferHttpInput, S as HttpMethod, T as HttpRouteDefinition, _ as extractRouteMap, b as HttpActionHandler, d as CRPCHttpRouter, f as HttpRouterDef, g as createHttpRouterFactory, h as createHttpRouter, m as HttpRouterWithHono, p as HttpRouterRecord, v as CRPCHonoHandler, w as HttpProcedureBuilderDef, x as HttpHandlerOpts, y as HttpActionConstructor } from "../http-types-BoSDAh4Y.js";
 import { a as MergeZodObjects, c as MiddlewareMarker, d as MiddlewareProcedureType, f as MiddlewareResult, g as UnsetMarker, h as Simplify, i as IntersectIfDefined, l as MiddlewareNext, m as ResolveIfSet, n as AnyMiddlewareBuilder, o as MiddlewareBuilder, p as Overwrite, r as GetRawInputFn, s as MiddlewareFunction, t as AnyMiddleware, u as MiddlewareProcedureInfo } from "../types-CnTpHR1F.js";
 import { a as isMutationCtx, c as isSchedulerCtx, d as requireQueryCtx, f as requireRunMutationCtx, i as isActionCtx, l as requireActionCtx, n as RunMutationCtx, o as isQueryCtx, p as requireSchedulerCtx, r as SchedulerCtx, s as isRunMutationCtx, t as GenericCtx, u as requireMutationCtx } from "../context-utils-BBUtBqjN.js";
 export { ActionProcedureBuilder, AnyMiddleware, AnyMiddlewareBuilder, CRPCError, CRPCErrorCode, CRPCErrorData, CRPCFunctionTypeHint, CRPCHonoHandler, CRPCHttpRouter, CRPC_ERROR_CODES_BY_KEY, CRPC_ERROR_CODE_TO_HTTP, CallerMeta, CallerOpts, ConvexContext, ConvexValidatorFromZod, ConvexValidatorFromZodOutput, CreateEnvOptions, CreateProcedureCallerFactoryOptions, CustomBuilder, GeneratedProcedureRegistry, GeneratedProcedureRegistryEntry, GeneratedRegistryCallerFactory, GeneratedRegistryCallerForContext, GeneratedRegistryHandlerFactory, GeneratedRegistryHandlerForContext, GenericCtx, GetRawInputFn, HttpActionConstructor, HttpActionHandler, HttpHandlerOpts, HttpMethod, HttpProcedure, HttpProcedureBuilder, HttpProcedureBuilderDef, HttpRouteDefinition, HttpRouterDef, HttpRouterRecord, HttpRouterWithHono, InferHttpInput, IntersectIfDefined, LazyCaller, MergeZodObjects, MiddlewareBuilder, MiddlewareFunction, MiddlewareMarker, MiddlewareNext, MiddlewareProcedureInfo, MiddlewareProcedureType, MiddlewareResult, MutationProcedureBuilder, Overwrite, ProcedureActionCallerFromRegistry, ProcedureBuilder, ProcedureCaller, ProcedureCallerFromRegistry, ProcedureDefinition, ProcedureFromFunctionReference, ProcedureMeta, ProcedureNameEntry, ProcedureNameLookup, ProcedureSchedulableCallerFromRegistry, ProcedureScheduleCallerFromRegistry, QueryProcedureBuilder, ResolveIfSet, RunMutationCtx, RuntimeEnv, SchedulerCtx, ServerCaller, Simplify, UnsetMarker, WithHttpRouter, ZCustomCtx, Zid, ZodFromValidatorBase, ZodValidatorFromConvex, convexToZod, convexToZodFields, createApiLeaf, createCallerFactory, createEnv, createGeneratedFunctionReference, createGeneratedRegistryRuntime, createGenericCallerFactory, createGenericHandlerFactory, createHttpProcedureBuilder, createHttpRouter, createHttpRouterFactory, createLazyCaller, createMiddlewareFactory, createProcedureCallerFactory, createProcedureHandlerFactory, createServerCaller, defineProcedure, extractPathParams, extractRouteMap, getCRPCErrorFromUnknown, getGeneratedFunctionReference, getGeneratedValue, getHTTPStatusCodeFromError, handleHttpError, inferApiInputs, inferApiOutputs, inferProcedureNameFromCallsite, initCRPC, isActionCtx, isCRPCError, isMutationCtx, isQueryCtx, isRunMutationCtx, isSchedulerCtx, matchPathParams, registerProcedureNameLookup, requireActionCtx, requireMutationCtx, requireQueryCtx, requireRunMutationCtx, requireSchedulerCtx, toCRPCError, typedProcedureResolver, withSystemFields, zCustomAction, zCustomMutation, zCustomQuery, zid, zodOutputToConvex, zodOutputToConvexFields, zodToConvex, zodToConvexFields };

package/dist/server/index.js

@@ -1,6 +1,6 @@
 import { a as isMutationCtx, c as isSchedulerCtx, d as requireQueryCtx, f as requireRunMutationCtx, i as isActionCtx, l as requireActionCtx, n as createGeneratedFunctionReference, o as isQueryCtx, p as requireSchedulerCtx, r as getGeneratedValue, s as isRunMutationCtx, t as createApiLeaf, u as requireMutationCtx } from "../api-entry-N3nBOlI2.js";
-import { n as createLazyCaller, r as createServerCaller, t as createCallerFactory } from "../caller-factory-DHywSoGZ.js";
-import { A as zid, C as toCRPCError, D as zCustomAction, E as withSystemFields, M as zodOutputToConvexFields, N as zodToConvex, O as zCustomMutation, P as zodToConvexFields, S as isCRPCError, T as convexToZodFields, _ as CRPCError, a as createMiddlewareFactory, b as getCRPCErrorFromUnknown, c as registerProcedureNameLookup, d as createHttpRouterFactory, f as extractRouteMap, g as matchPathParams, h as handleHttpError, i as QueryProcedureBuilder, j as zodOutputToConvex, k as zCustomQuery, l as HttpRouterWithHono, m as extractPathParams, n as MutationProcedureBuilder, o as initCRPC, p as createHttpProcedureBuilder, r as ProcedureBuilder, s as inferProcedureNameFromCallsite, t as ActionProcedureBuilder, u as createHttpRouter, v as CRPC_ERROR_CODES_BY_KEY, w as convexToZod, x as getHTTPStatusCodeFromError, y as CRPC_ERROR_CODE_TO_HTTP } from "../builder-Dwy6D2QA.js";
-import { a as createProcedureHandlerFactory, c as typedProcedureResolver, i as createProcedureCallerFactory, l as createEnv, n as createGenericCallerFactory, o as defineProcedure, r as createGenericHandlerFactory, s as getGeneratedFunctionReference, t as createGeneratedRegistryRuntime } from "../procedure-caller-JB9kjYsy.js";
+import { n as createLazyCaller, r as createServerCaller, t as createCallerFactory } from "../caller-factory-CWa0ELLD.js";
+import { A as zid, C as toCRPCError, D as zCustomAction, E as withSystemFields, M as zodOutputToConvexFields, N as zodToConvex, O as zCustomMutation, P as zodToConvexFields, S as isCRPCError, T as convexToZodFields, _ as CRPCError, a as createMiddlewareFactory, b as getCRPCErrorFromUnknown, c as registerProcedureNameLookup, d as createHttpRouterFactory, f as extractRouteMap, g as matchPathParams, h as handleHttpError, i as QueryProcedureBuilder, j as zodOutputToConvex, k as zCustomQuery, l as HttpRouterWithHono, m as extractPathParams, n as MutationProcedureBuilder, o as initCRPC, p as createHttpProcedureBuilder, r as ProcedureBuilder, s as inferProcedureNameFromCallsite, t as ActionProcedureBuilder, u as createHttpRouter, v as CRPC_ERROR_CODES_BY_KEY, w as convexToZod, x as getHTTPStatusCodeFromError, y as CRPC_ERROR_CODE_TO_HTTP } from "../builder-CsxVc5xC.js";
+import { a as createProcedureHandlerFactory, c as typedProcedureResolver, i as createProcedureCallerFactory, l as createEnv, n as createGenericCallerFactory, o as defineProcedure, r as createGenericHandlerFactory, s as getGeneratedFunctionReference, t as createGeneratedRegistryRuntime } from "../procedure-caller-DQxnLBS_.js";
 
 export { ActionProcedureBuilder, CRPCError, CRPC_ERROR_CODES_BY_KEY, CRPC_ERROR_CODE_TO_HTTP, HttpRouterWithHono, MutationProcedureBuilder, ProcedureBuilder, QueryProcedureBuilder, convexToZod, convexToZodFields, createApiLeaf, createCallerFactory, createEnv, createGeneratedFunctionReference, createGeneratedRegistryRuntime, createGenericCallerFactory, createGenericHandlerFactory, createHttpProcedureBuilder, createHttpRouter, createHttpRouterFactory, createLazyCaller, createMiddlewareFactory, createProcedureCallerFactory, createProcedureHandlerFactory, createServerCaller, defineProcedure, extractPathParams, extractRouteMap, getCRPCErrorFromUnknown, getGeneratedFunctionReference, getGeneratedValue, getHTTPStatusCodeFromError, handleHttpError, inferProcedureNameFromCallsite, initCRPC, isActionCtx, isCRPCError, isMutationCtx, isQueryCtx, isRunMutationCtx, isSchedulerCtx, matchPathParams, registerProcedureNameLookup, requireActionCtx, requireMutationCtx, requireQueryCtx, requireRunMutationCtx, requireSchedulerCtx, toCRPCError, typedProcedureResolver, withSystemFields, zCustomAction, zCustomMutation, zCustomQuery, zid, zodOutputToConvex, zodOutputToConvexFields, zodToConvex, zodToConvexFields };

package/dist/solid/index.js

@@ -579,6 +579,7 @@ const DATE_CODEC_TAG = "$date";
 */
 const dateWireCodec = {
 	tag: DATE_CODEC_TAG,
+	objectsOnly: true,
 	isType: (value) => value instanceof Date,
 	encode: (value) => value.getTime(),
 	decode: (value) => {
@@ -587,6 +588,40 @@ const dateWireCodec = {
 	}
 };
 /**
+* One value per primitive `typeof` result, plus the values the object fast path
+* would otherwise skip.
+*/
+const PRIMITIVE_PROBES = [
+	void 0,
+	null,
+	"",
+	0,
+	NaN,
+	false,
+	0n,
+	Symbol("kitcn.codec.probe"),
+	() => void 0
+];
+/**
+* Falsify an `objectsOnly` declaration against representative primitives.
+*
+* Sampling cannot prove a predicate object-only, so it never *infers* the
+* capability - it only rejects the misdeclarations it can catch
+* (`typeof value === 'bigint'`, `value === null`, ...) before they silently
+* drop a value's wire encoding. A codec that throws on a probe owns that.
+*/
+const assertObjectsOnly = (codec) => {
+	for (const probe of PRIMITIVE_PROBES) {
+		let claimed = false;
+		try {
+			claimed = codec.isType(probe);
+		} catch {
+			continue;
+		}
+		if (claimed) throw new Error(`Wire codec '${codec.tag}' declares objectsOnly, but isType() claims ${probe === null ? "null" : typeof probe}. Drop objectsOnly so the codec keeps receiving non-object values.`);
+	}
+};
+/**
 * Build a recursive tagged transformer from codecs.
 */
 const createTaggedTransformer = (codecs) => {
@@ -594,9 +629,12 @@ const createTaggedTransformer = (codecs) => {
 	for (const codec of codecs) {
 		if (!codec.tag.startsWith("$")) throw new Error(`Invalid wire codec tag '${codec.tag}'. Tags must start with '$'.`);
 		if (codecByTag.has(codec.tag)) throw new Error(`Duplicate wire codec tag '${codec.tag}'.`);
+		if (codec.objectsOnly) assertObjectsOnly(codec);
 		codecByTag.set(codec.tag, codec);
 	}
+	const skipNonObjects = codecs.every((codec) => codec.objectsOnly === true);
 	const serialize = (value) => {
+		if (skipNonObjects && (value === null || typeof value !== "object")) return value;
 		for (const codec of codecs) if (codec.isType(value)) return {
 			[CODEC_MARKER_KEY]: CODEC_MARKER_VALUE,
 			[CODEC_TAG_KEY]: codec.tag,
@@ -630,6 +668,7 @@ const createTaggedTransformer = (codecs) => {
 		return value;
 	};
 	const deserialize = (value) => {
+		if (value === null || typeof value !== "object") return value;
 		if (Array.isArray(value)) {
 			let result;
 			for (let index = 0; index < value.length; index += 1) {
@@ -695,16 +734,20 @@ const normalizeCustomTransformer = (transformer) => {
 * - deserialize: default(Date) -> user
 */
 const composeWithDefault = (transformer) => {
-	if (!transformer) return defaultCRPCTransformer;
+	if (!transformer || transformer === defaultCRPCTransformer) return defaultCRPCTransformer;
 	return {
 		serialize: (value) => defaultCRPCTransformer.serialize(transformer.serialize(value)),
 		deserialize: (value) => transformer.deserialize(defaultCRPCTransformer.deserialize(value))
 	};
 };
 const transformerCache = /* @__PURE__ */ new WeakMap();
+transformerCache.set(DEFAULT_COMBINED_TRANSFORMER, DEFAULT_COMBINED_TRANSFORMER);
 /**
 * Normalize transformer config to split input/output shape.
 * User transformers are additive and always composed with default Date handling.
+*
+* Idempotent: passing a transformer this function already resolved returns it
+* unchanged.
 */
 const getTransformer = (transformer) => {
 	if (!transformer) return DEFAULT_COMBINED_TRANSFORMER;
@@ -717,6 +760,7 @@ const getTransformer = (transformer) => {
 		output: composeWithDefault(custom?.output)
 	};
 	transformerCache.set(cacheKey, resolved);
+	transformerCache.set(resolved, resolved);
 	return resolved;
 };
 /**

package/dist/{transformer-C6pGVHqx.js → transformer-yZuBWo8v.js}

@@ -27,6 +27,7 @@ const DATE_CODEC_TAG = "$date";
 */
 const dateWireCodec = {
 	tag: DATE_CODEC_TAG,
+	objectsOnly: true,
 	isType: (value) => value instanceof Date,
 	encode: (value) => value.getTime(),
 	decode: (value) => {
@@ -35,6 +36,40 @@ const dateWireCodec = {
 	}
 };
 /**
+* One value per primitive `typeof` result, plus the values the object fast path
+* would otherwise skip.
+*/
+const PRIMITIVE_PROBES = [
+	void 0,
+	null,
+	"",
+	0,
+	NaN,
+	false,
+	0n,
+	Symbol("kitcn.codec.probe"),
+	() => void 0
+];
+/**
+* Falsify an `objectsOnly` declaration against representative primitives.
+*
+* Sampling cannot prove a predicate object-only, so it never *infers* the
+* capability - it only rejects the misdeclarations it can catch
+* (`typeof value === 'bigint'`, `value === null`, ...) before they silently
+* drop a value's wire encoding. A codec that throws on a probe owns that.
+*/
+const assertObjectsOnly = (codec) => {
+	for (const probe of PRIMITIVE_PROBES) {
+		let claimed = false;
+		try {
+			claimed = codec.isType(probe);
+		} catch {
+			continue;
+		}
+		if (claimed) throw new Error(`Wire codec '${codec.tag}' declares objectsOnly, but isType() claims ${probe === null ? "null" : typeof probe}. Drop objectsOnly so the codec keeps receiving non-object values.`);
+	}
+};
+/**
 * Build a recursive tagged transformer from codecs.
 */
 const createTaggedTransformer = (codecs) => {
@@ -42,9 +77,12 @@ const createTaggedTransformer = (codecs) => {
 	for (const codec of codecs) {
 		if (!codec.tag.startsWith("$")) throw new Error(`Invalid wire codec tag '${codec.tag}'. Tags must start with '$'.`);
 		if (codecByTag.has(codec.tag)) throw new Error(`Duplicate wire codec tag '${codec.tag}'.`);
+		if (codec.objectsOnly) assertObjectsOnly(codec);
 		codecByTag.set(codec.tag, codec);
 	}
+	const skipNonObjects = codecs.every((codec) => codec.objectsOnly === true);
 	const serialize = (value) => {
+		if (skipNonObjects && (value === null || typeof value !== "object")) return value;
 		for (const codec of codecs) if (codec.isType(value)) return {
 			[CODEC_MARKER_KEY]: CODEC_MARKER_VALUE,
 			[CODEC_TAG_KEY]: codec.tag,
@@ -78,6 +116,7 @@ const createTaggedTransformer = (codecs) => {
 		return value;
 	};
 	const deserialize = (value) => {
+		if (value === null || typeof value !== "object") return value;
 		if (Array.isArray(value)) {
 			let result;
 			for (let index = 0; index < value.length; index += 1) {
@@ -153,16 +192,20 @@ const normalizeCustomTransformer = (transformer) => {
 * - deserialize: default(Date) -> user
 */
 const composeWithDefault = (transformer) => {
-	if (!transformer) return defaultCRPCTransformer;
+	if (!transformer || transformer === defaultCRPCTransformer) return defaultCRPCTransformer;
 	return {
 		serialize: (value) => defaultCRPCTransformer.serialize(transformer.serialize(value)),
 		deserialize: (value) => transformer.deserialize(defaultCRPCTransformer.deserialize(value))
 	};
 };
 const transformerCache = /* @__PURE__ */ new WeakMap();
+transformerCache.set(DEFAULT_COMBINED_TRANSFORMER, DEFAULT_COMBINED_TRANSFORMER);
 /**
 * Normalize transformer config to split input/output shape.
 * User transformers are additive and always composed with default Date handling.
+*
+* Idempotent: passing a transformer this function already resolved returns it
+* unchanged.
 */
 const getTransformer = (transformer) => {
 	if (!transformer) return DEFAULT_COMBINED_TRANSFORMER;
@@ -175,6 +218,7 @@ const getTransformer = (transformer) => {
 		output: composeWithDefault(custom?.output)
 	};
 	transformerCache.set(cacheKey, resolved);
+	transformerCache.set(resolved, resolved);
 	return resolved;
 };
 /**

package/dist/{types-jNTcza_a.d.ts → types-C0Xl7P8K.d.ts}

@@ -1,4 +1,4 @@
-import { O as CombinedDataTransformer, n as HttpClientError } from "./http-types-zsMHb_QN.js";
+import { O as CombinedDataTransformer, n as HttpClientError } from "./http-types-BoSDAh4Y.js";
 import { FunctionArgs, FunctionReference, FunctionReturnType } from "convex/server";
 
 //#region src/crpc/http-client.d.ts

package/package.json

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