kitcn 0.33.0 → 0.33.1

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-Buvjl9hn.js";
 import { n as createLazyCaller, r as createServerCaller, t as createCallerFactory } from "../caller-factory-C-N540BC.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-Cyd5nCxZ.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-DgMiD0-a.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-DDYTlmTB.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-DgGF_hA8.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.d.ts

@@ -60,8 +60,8 @@ type ConvexQueryHookOptions = {
   /** Skip query silently when unauthenticated (default: false, calls onQueryUnauthorized) */skipUnauth?: boolean; /** Set to false to fetch once without subscribing (default: true) */
   subscribe?: boolean;
 };
-/** Extract input args without cursor/limit (user's filter args only) */
-type InfiniteQueryInput<TInput> = Omit<TInput, 'cursor' | 'limit'>;
+/** Extract user args without hook-owned pagination transport fields */
+type InfiniteQueryInput<TInput> = Omit<TInput, 'cursor' | 'endCursor' | 'limit'>;
 /** Extract item type from PaginationResult<T> */
 type ExtractPaginatedItem<TOutput> = TOutput extends {
   page: (infer T)[];
@@ -1429,7 +1429,7 @@ declare const getConvexQueryClientSingleton: ({
  * Pagination state persisted in queryClient.
  * Enables scroll restoration when navigating back to a paginated list.
  *
- * Uses flat { cursor, limit } structure like tRPC.
+ * Uses flat { cursor, endCursor, limit } structure like tRPC.
  */
 type PaginationState = {
   id: number;
@@ -1438,13 +1438,12 @@ type PaginationState = {
   queries: Record<number, {
     /** Flat pagination args - tRPC style */args: Record<string, unknown> & {
       cursor: string | null;
+      endCursor?: string | null;
       limit?: number; /** Internal pagination ID for subscription management */
       __paginationId?: number;
     };
-    endCursor?: string | null;
   }>;
-  version: number; /** Recovery key to prevent infinite recovery loops */
-  autoRecoveryAttempted?: string;
+  version: number;
 };
 type PaginationStatus = 'CanLoadMore' | 'Exhausted' | 'LoadingFirstPage' | 'LoadingMore';
 /** Return type for infinite query hooks */

package/dist/solid/index.js

@@ -2935,6 +2935,12 @@ const getConvexQueryClientSingleton = ({ authStore, convex, queryClient, symbolK
 //#endregion
 //#region src/internal/pagination.ts
 const shouldSplitPaginationPage = (page, initialNumItems) => Boolean(page.splitCursor) && (page.pageStatus === "SplitRecommended" || page.pageStatus === "SplitRequired" || initialNumItems !== void 0 && page.page.length > initialNumItems * 2);
+const isInvalidPaginationCursor = (error) => {
+	if (error instanceof Error && error.message.includes("InvalidCursor")) return true;
+	if (!error || typeof error !== "object" || !("data" in error)) return false;
+	const data = error.data;
+	return Boolean(data && typeof data === "object" && "isConvexSystemError" in data && data.isConvexSystemError === true && "paginationError" in data && data.paginationError === "InvalidCursor");
+};
 
 //#endregion
 //#region src/solid/create-queries-results.ts
@@ -3020,7 +3026,7 @@ const aggregatePages = (results, hasPlaceholderData) => {
 		error,
 		failureReason: error,
 		isError: results.some((r) => r.isError),
-		isFetchNextPageError: results.length > 1 && (results.at(-1)?.isError ?? false),
+		isFetchNextPageError: results.slice(1).some((result) => result.isError),
 		isFetching,
 		isLoading: status === "LoadingFirstPage",
 		isPlaceholderData,
@@ -3030,72 +3036,18 @@ const aggregatePages = (results, hasPlaceholderData) => {
 		status
 	};
 };
-/** Build a unique key for recovery attempt detection */
-const buildRecoveryKey = (pageKeys, page0Cursor, page0UpdatedAt) => JSON.stringify({
-	pageKeys,
-	page0Cursor,
-	page0UpdatedAt
-});
 /**
 * Hook for auto-recovering from stale cursors after WebSocket reconnection.
 *
 * When Convex WebSocket reconnects, page 0 (cursor: null) resubscribes and
 * gets fresh data. However, pages 1+ may have stale cursors that fail.
 *
-* This hook detects this pattern and creates a recovery page that fetches
-* enough items to cover the lost pages, preserving the user's scroll position.
+* This hook discards the invalid cursor chain and restarts from page one.
 */
-const useStaleCursorRecovery = ({ argsObject, combined, limit, pageResults, setState, state }) => {
-	createEffect(on([
-		() => combined.isFetchNextPageError,
-		pageResults,
-		() => state().pageKeys,
-		() => state().queries,
-		() => state().autoRecoveryAttempted,
-		argsObject
-	], () => {
+const useStaleCursorRecovery = ({ combined, pageResults, resetPagination }) => {
+	createEffect(on([() => combined.isFetchNextPageError, pageResults], () => {
 		if (!combined.isFetchNextPageError) return;
-		const results = pageResults();
-		const page0Result = results[0];
-		const page0Data = page0Result?.data;
-		const page0UpdatedAt = page0Result?.dataUpdatedAt ?? 0;
-		const hasPage0Data = page0Data !== void 0 && !page0Result?.isError;
-		const hasSubsequentErrors = results.slice(1).some((q) => q?.isError && !q?.isFetching);
-		if (!hasPage0Data || !hasSubsequentErrors || !page0Data?.continueCursor) return;
-		const currentState = state();
-		const recoveryKey = buildRecoveryKey(currentState.pageKeys, page0Data.continueCursor, page0UpdatedAt);
-		if (currentState.autoRecoveryAttempted === recoveryKey) return;
-		const erroredPageKeys = currentState.pageKeys.filter((_, i) => i > 0 && results[i]?.isError);
-		const itemsToRecover = erroredPageKeys.reduce((sum, key) => {
-			return sum + (currentState.queries[key]?.args?.limit ?? limit ?? 20);
-		}, 0);
-		console.warn("[Pagination] Auto-recovering from stale cursors", {
-			erroredPages: erroredPageKeys.length,
-			itemsToRecover
-		});
-		setState((prev) => ({
-			...prev,
-			id: prev.id,
-			nextPageKey: 2,
-			pageKeys: [prev.pageKeys[0], 1],
-			queries: {
-				[prev.pageKeys[0]]: prev.queries[prev.pageKeys[0]],
-				1: { args: {
-					...argsObject(),
-					cursor: page0Data.continueCursor,
-					limit: Math.min(itemsToRecover + (limit ?? 20), 500),
-					__paginationId: prev.id
-				} }
-			},
-			version: prev.version + 1,
-			autoRecoveryAttempted: recoveryKey
-		}));
-	}));
-	createEffect(on([() => combined.status, () => state().autoRecoveryAttempted], () => {
-		if ((combined.status === "CanLoadMore" || combined.status === "Exhausted") && state().autoRecoveryAttempted) setState((prev) => ({
-			...prev,
-			autoRecoveryAttempted: void 0
-		}));
+		if (pageResults().slice(1).some((result) => result?.isError && !result.isFetching && isInvalidPaginationCursor(result.error))) resetPagination();
 	}));
 };
 /**
@@ -3232,12 +3184,9 @@ const useInfiniteQueryInternal = (query, args, options) => {
 	const [combined, setCombined] = createStore(derive());
 	createRenderEffect(() => setCombined(derive()));
 	useStaleCursorRecovery({
-		argsObject,
 		combined,
-		limit,
 		pageResults,
-		setState,
-		state
+		resetPagination: () => setState(createInitialState())
 	});
 	createEffect(on([
 		pageResults,
@@ -3252,15 +3201,17 @@ const useInfiniteQueryInternal = (query, args, options) => {
 				const page = pageQuery.data;
 				const pageKey = state().pageKeys[i];
 				const pageState = state().queries[pageKey];
-				if (shouldSplitPaginationPage(page, limit) && pageState && !pageState.endCursor) {
+				if (shouldSplitPaginationPage(page, limit) && pageState && pageState.args.endCursor !== page.splitCursor) {
 					setState((prev) => {
 						const currentPageState = prev.queries[pageKey];
-						if (!currentPageState || currentPageState.endCursor) return prev;
+						if (!currentPageState || currentPageState.args.endCursor === page.splitCursor) return prev;
 						const newKey = prev.nextPageKey;
 						const splitCursor = page.splitCursor;
+						const endCursor = currentPageState.args.endCursor ?? page.continueCursor;
 						const splitPageArgs = {
 							...argsObject(),
 							cursor: splitCursor,
+							endCursor,
 							limit: currentPageState.args.limit,
 							__paginationId: prev.id
 						};
@@ -3275,7 +3226,10 @@ const useInfiniteQueryInternal = (query, args, options) => {
 								...prev.queries,
 								[pageKey]: {
 									...currentPageState,
-									endCursor: splitCursor
+									args: {
+										...currentPageState.args,
+										endCursor: splitCursor
+									}
 								},
 								[newKey]: { args: splitPageArgs }
 							}

package/dist/transformer-BEkxlnss.d.ts

@@ -0,0 +1,78 @@
+//#region src/crpc/transformer.d.ts
+/**
+ * Generic transformer contract (mirrors tRPC shape).
+ */
+interface DataTransformer {
+  deserialize(object: any): any;
+  serialize(object: any): any;
+}
+/**
+ * Separate input/output transformers.
+ */
+interface CombinedDataTransformer {
+  input: DataTransformer;
+  output: DataTransformer;
+}
+/**
+ * Transformer config accepted by cRPC.
+ */
+type DataTransformerOptions = CombinedDataTransformer | DataTransformer;
+/**
+ * Extensible tagged wire codec.
+ */
+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}`;
+}
+/**
+ * Date wire tag (Convex-style reserved key).
+ */
+declare const DATE_CODEC_TAG = "$date";
+/**
+ * Built-in Date codec.
+ */
+declare const dateWireCodec: WireCodec;
+/**
+ * Build a recursive tagged transformer from codecs.
+ */
+declare const createTaggedTransformer: (codecs: readonly WireCodec[]) => DataTransformer;
+/**
+ * Default cRPC transformer (Date-enabled).
+ */
+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;
+/**
+ * Encode request payloads (input direction).
+ */
+declare const encodeWire: (value: unknown, transformer?: DataTransformerOptions) => unknown;
+/**
+ * Decode response payloads (output direction).
+ */
+declare const decodeWire: (value: unknown, transformer?: DataTransformerOptions) => unknown;
+/**
+ * Exposed identity transformer for advanced composition.
+ */
+declare const identityTransformer: CombinedDataTransformer;
+//#endregion
+export { WireCodec as a, decodeWire as c, getTransformer as d, identityTransformer as f, DataTransformerOptions as i, defaultCRPCTransformer as l, DATE_CODEC_TAG as n, createTaggedTransformer as o, DataTransformer as r, dateWireCodec as s, CombinedDataTransformer as t, encodeWire as u };

package/dist/{types-BXpu7xIU.d.ts → types-Cl0utsTL.d.ts}

@@ -1,4 +1,5 @@
-import { P as CombinedDataTransformer, r as HttpClientError } from "./http-types-BhhPZtwa.js";
+import { t as CombinedDataTransformer } from "./transformer-BEkxlnss.js";
+import { r as HttpClientError } from "./http-types-8FBr10yl.js";
 import { FunctionArgs, FunctionReference, FunctionReturnType } from "convex/server";
 
 //#region src/crpc/http-client.d.ts
@@ -148,8 +149,8 @@ type PaginationOpts = {
   maximumRowsRead?: number;
   maximumBytesRead?: number;
 };
-/** Extract input args without cursor/limit (user's filter args only) */
-type InfiniteQueryInput<TInput> = Omit<TInput, 'cursor' | 'limit'>;
+/** Extract user args without hook-owned pagination transport fields */
+type InfiniteQueryInput<TInput> = Omit<TInput, 'cursor' | 'endCursor' | 'limit'>;
 /** Extract item type from PaginationResult<T> */
 type ExtractPaginatedItem<TOutput> = TOutput extends {
   page: (infer T)[];