kitcn 0.13.5 → 0.13.6

package/dist/react/index.js

@@ -5,9 +5,9 @@ import { createContext, useCallback, useContext, useEffect, useMemo, useRef, use
 import { jsx } from "react/jsx-runtime";
 import { getFunctionName } from "convex/server";
 import { notifyManager, skipToken, useQueries, useQueryClient } from "@tanstack/react-query";
-import { ConvexHttpClient } from "convex/browser";
 import { hashKey } from "@tanstack/query-core";
 import { convexToJson } from "convex/values";
+import { ConvexHttpClient } from "convex/browser";
 
 //#region src/shared/meta-utils.ts
 const metaCache = /* @__PURE__ */ new WeakMap();
@@ -723,6 +723,57 @@ function useAuthSkip(funcRef, opts) {
 	};
 }
 
+//#endregion
+//#region src/internal/query-key.ts
+/**
+* Shared query key utilities for Convex + TanStack Query.
+* This file has NO React dependencies so it can be imported in both
+* server (RSC) and client contexts.
+*/
+/**
+* Check if query key is for a Convex query function.
+* Format: ['convexQuery', 'namespace:functionName', { args }]
+*/
+function isConvexQuery(queryKey) {
+	return queryKey.length >= 2 && queryKey[0] === "convexQuery";
+}
+/**
+* Check if query key is for a Convex action function.
+* Format: ['convexAction', 'namespace:functionName', { args }]
+*/
+function isConvexAction$1(queryKey) {
+	return queryKey.length >= 2 && queryKey[0] === "convexAction";
+}
+/**
+* Create stable hash for Convex query keys.
+* Uses Convex's JSON serialization for consistent argument hashing.
+*/
+function hashConvexQuery(queryKey) {
+	const [, funcName, args] = queryKey;
+	return `convexQuery|${funcName}|${JSON.stringify(convexToJson(args))}`;
+}
+/**
+* Create stable hash for Convex action keys.
+* Uses Convex's JSON serialization for consistent argument hashing.
+*/
+function hashConvexAction(queryKey) {
+	const [, funcName, args] = queryKey;
+	return `convexAction|${funcName}|${JSON.stringify(convexToJson(args))}`;
+}
+
+//#endregion
+//#region src/internal/hash.ts
+/**
+* Create a hash function for TanStack Query that handles Convex keys.
+*/
+function createHashFn(fallback = hashKey) {
+	return (queryKey) => {
+		if (isConvexQuery(queryKey)) return hashConvexQuery(queryKey);
+		if (isConvexAction$1(queryKey)) return hashConvexAction(queryKey);
+		return fallback(queryKey);
+	};
+}
+
 //#endregion
 //#region src/react/use-query-options.ts
 /** biome-ignore-all lint/suspicious/noExplicitAny: Convex type compatibility */
@@ -730,6 +781,37 @@ function useAuthSkip(funcRef, opts) {
 * Query options factories for Convex functions.
 * Forked from @convex-dev/react-query to support auth-aware error handling.
 */
+const EMPTY_ARGS = {};
+const hashConvexOptionsKey = createHashFn();
+const MAX_STABLE_ARGS = 500;
+const stableArgsByHash = /* @__PURE__ */ new Map();
+function getStableArgsByHash(hash, args) {
+	if (stableArgsByHash.has(hash)) {
+		const stableArgs = stableArgsByHash.get(hash);
+		stableArgsByHash.delete(hash);
+		stableArgsByHash.set(hash, stableArgs);
+		return stableArgs;
+	}
+	stableArgsByHash.set(hash, args);
+	if (stableArgsByHash.size > MAX_STABLE_ARGS) {
+		const oldestHash = stableArgsByHash.keys().next().value;
+		if (oldestHash !== void 0) stableArgsByHash.delete(oldestHash);
+	}
+	return args;
+}
+function useStableQueryArgs(prefix, funcRef, args) {
+	const resolvedArgs = args === skipToken || args == null ? EMPTY_ARGS : args;
+	const argsHash = hashConvexOptionsKey([
+		prefix,
+		getFunctionName(funcRef),
+		resolvedArgs
+	]);
+	const value = useMemo(() => getStableArgsByHash(argsHash, resolvedArgs), [argsHash, resolvedArgs]);
+	return useMemo(() => ({
+		hash: argsHash,
+		value
+	}), [argsHash, value]);
+}
 /**
 * Hook that returns query options for use with useQuery.
 * Handles skipUnauth by setting enabled: false when unauthorized.
@@ -761,18 +843,27 @@ function useConvexQueryOptions(funcRef, args, options) {
 		enabled: isSkipped ? false : enabled,
 		skipUnauth: options?.skipUnauth
 	});
-	const baseOptions = convexQuery(funcRef, isSkipped ? {} : args);
-	const { skipUnauth: _, subscribe, ...queryOptions } = options ?? {};
-	return {
-		...baseOptions,
-		...queryOptions,
-		enabled: isSkipped ? false : !shouldSkip,
-		meta: {
-			...baseOptions.meta,
-			authType,
-			subscribe: subscribe !== false
-		}
-	};
+	const stableArgs = useStableQueryArgs("convexQuery", funcRef, isSkipped ? EMPTY_ARGS : args);
+	const baseOptions = useMemo(() => convexQuery(funcRef, stableArgs.value), [funcRef, stableArgs]);
+	return useMemo(() => {
+		const { skipUnauth: _, subscribe, ...queryOptions } = options ?? {};
+		return {
+			...baseOptions,
+			...queryOptions,
+			enabled: isSkipped ? false : !shouldSkip,
+			meta: {
+				...baseOptions.meta,
+				authType,
+				subscribe: subscribe !== false
+			}
+		};
+	}, [
+		authType,
+		baseOptions,
+		isSkipped,
+		options,
+		shouldSkip
+	]);
 }
 /**
 * Hook that returns infinite query options for use with useInfiniteQuery.
@@ -846,13 +937,21 @@ function useConvexActionQueryOptions(action, args, options) {
 		enabled: isSkipped ? false : enabled,
 		skipUnauth: options?.skipUnauth
 	});
-	const baseOptions = convexAction(action, isSkipped ? {} : args);
-	const { skipUnauth: _, ...queryOptions } = options ?? {};
-	return {
-		...baseOptions,
-		...queryOptions,
-		enabled: isSkipped ? false : !shouldSkip
-	};
+	const stableArgs = useStableQueryArgs("convexAction", action, isSkipped ? EMPTY_ARGS : args);
+	const baseOptions = useMemo(() => convexAction(action, stableArgs.value), [action, stableArgs]);
+	return useMemo(() => {
+		const { skipUnauth: _, ...queryOptions } = options ?? {};
+		return {
+			...baseOptions,
+			...queryOptions,
+			enabled: isSkipped ? false : !shouldSkip
+		};
+	}, [
+		baseOptions,
+		isSkipped,
+		options,
+		shouldSkip
+	]);
 }
 /**
 * Hook that returns mutation options for use with useMutation.
@@ -1511,57 +1610,6 @@ function createAuthMutations(authClient) {
 	};
 }
 
-//#endregion
-//#region src/internal/query-key.ts
-/**
-* Shared query key utilities for Convex + TanStack Query.
-* This file has NO React dependencies so it can be imported in both
-* server (RSC) and client contexts.
-*/
-/**
-* Check if query key is for a Convex query function.
-* Format: ['convexQuery', 'namespace:functionName', { args }]
-*/
-function isConvexQuery(queryKey) {
-	return queryKey.length >= 2 && queryKey[0] === "convexQuery";
-}
-/**
-* Check if query key is for a Convex action function.
-* Format: ['convexAction', 'namespace:functionName', { args }]
-*/
-function isConvexAction$1(queryKey) {
-	return queryKey.length >= 2 && queryKey[0] === "convexAction";
-}
-/**
-* Create stable hash for Convex query keys.
-* Uses Convex's JSON serialization for consistent argument hashing.
-*/
-function hashConvexQuery(queryKey) {
-	const [, funcName, args] = queryKey;
-	return `convexQuery|${funcName}|${JSON.stringify(convexToJson(args))}`;
-}
-/**
-* Create stable hash for Convex action keys.
-* Uses Convex's JSON serialization for consistent argument hashing.
-*/
-function hashConvexAction(queryKey) {
-	const [, funcName, args] = queryKey;
-	return `convexAction|${funcName}|${JSON.stringify(convexToJson(args))}`;
-}
-
-//#endregion
-//#region src/internal/hash.ts
-/**
-* Create a hash function for TanStack Query that handles Convex keys.
-*/
-function createHashFn(fallback = hashKey) {
-	return (queryKey) => {
-		if (isConvexQuery(queryKey)) return hashConvexQuery(queryKey);
-		if (isConvexAction$1(queryKey)) return hashConvexAction(queryKey);
-		return fallback(queryKey);
-	};
-}
-
 //#endregion
 //#region src/react/client.ts
 /**

package/package.json

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