kitcn 0.32.2 → 0.33.1

package/dist/orm/migrations/index.d.ts

@@ -1,3 +1,3 @@
-import { C as MigrationStep, D as defineMigration, E as buildMigrationPlan, O as defineMigrationSet, S as MigrationStateMap, T as MigrationWriteMode, _ as MigrationManifestEntry, a as MAX_STATUS_RUN_LIMIT, b as MigrationRunStatus, c as MigrationRunChunkArgs, d as MigrationAppliedState, f as MigrationDefinition, g as MigrationDriftIssue, h as MigrationDocContext, k as detectMigrationDrift, l as MigrationStatusArgs, m as MigrationDoc, o as MigrationCancelArgs, p as MigrationDirection, s as MigrationRunArgs, u as createMigrationHandlers, v as MigrationMigrateOne, w as MigrationTableName, x as MigrationSet, y as MigrationPlan } from "../../capabilities-BJm_VSDT.js";
-import { Ct as migrationCapability, dt as MIGRATION_STORAGE_TABLE_NAMES, ft as injectMigrationStorageTables, lt as MIGRATION_RUN_TABLE, mt as migrationStorageTables, pt as migrationExtension, ut as MIGRATION_STATE_TABLE } from "../../where-clause-compiler-Dgf4lrO-.js";
+import { C as MigrationStep, D as defineMigration, E as buildMigrationPlan, O as defineMigrationSet, S as MigrationStateMap, T as MigrationWriteMode, _ as MigrationManifestEntry, a as MAX_STATUS_RUN_LIMIT, b as MigrationRunStatus, c as MigrationRunChunkArgs, d as MigrationAppliedState, f as MigrationDefinition, g as MigrationDriftIssue, h as MigrationDocContext, k as detectMigrationDrift, l as MigrationStatusArgs, m as MigrationDoc, o as MigrationCancelArgs, p as MigrationDirection, s as MigrationRunArgs, u as createMigrationHandlers, v as MigrationMigrateOne, w as MigrationTableName, x as MigrationSet, y as MigrationPlan } from "../../capabilities-Bxzoofl4.js";
+import { Ct as migrationCapability, dt as MIGRATION_STORAGE_TABLE_NAMES, ft as injectMigrationStorageTables, lt as MIGRATION_RUN_TABLE, mt as migrationStorageTables, pt as migrationExtension, ut as MIGRATION_STATE_TABLE } from "../../where-clause-compiler-CoPVAVDO.js";
 export { MAX_STATUS_RUN_LIMIT, MIGRATION_RUN_TABLE, MIGRATION_STATE_TABLE, MIGRATION_STORAGE_TABLE_NAMES, type MigrationAppliedState, type MigrationCancelArgs, type MigrationDefinition, type MigrationDirection, type MigrationDoc, type MigrationDocContext, type MigrationDriftIssue, type MigrationManifestEntry, type MigrationMigrateOne, type MigrationPlan, type MigrationRunArgs, type MigrationRunChunkArgs, type MigrationRunStatus, type MigrationSet, type MigrationStateMap, type MigrationStatusArgs, type MigrationStep, type MigrationTableName, type MigrationWriteMode, buildMigrationPlan, createMigrationHandlers, defineMigration, defineMigrationSet, detectMigrationDrift, injectMigrationStorageTables, migrationCapability, migrationExtension, migrationStorageTables };

package/dist/plugins/index.d.ts

@@ -1,2 +1,2 @@
-import { a as PluginConfigureResolver, i as PluginConfigureInput, n as PluginApiScope, o as definePlugin, r as PluginConfigureContext, s as resolvePluginOptions, t as Plugin } from "../middleware-BBS7oLtT.js";
+import { a as PluginConfigureResolver, i as PluginConfigureInput, n as PluginApiScope, o as definePlugin, r as PluginConfigureContext, s as resolvePluginOptions, t as Plugin } from "../middleware-D2hKJuSZ.js";
 export { type Plugin, type PluginApiScope, type PluginConfigureContext, type PluginConfigureInput, type PluginConfigureResolver, definePlugin, resolvePluginOptions };

package/dist/plugins/index.js

@@ -1,3 +1,3 @@
-import { n as resolvePluginOptions, t as definePlugin } from "../middleware-D61Nm-iB.js";
+import { n as resolvePluginOptions, t as definePlugin } from "../middleware-LvZov-hA.js";
 
 export { definePlugin, resolvePluginOptions };

package/dist/{procedure-caller-DgMiD0-a.js → procedure-caller-DgGF_hA8.js}

@@ -1,5 +1,5 @@
 import { i as decodeWire, o as encodeWire } from "./transformer-C8lVwHNT.js";
-import { _ as CRPCError } from "./builder-Cyd5nCxZ.js";
+import { _ as CRPCError } from "./builder-DDYTlmTB.js";
 import * as z$1 from "zod";
 
 //#region src/server/env.ts

package/dist/{procedure-name-DPYyLiVS.d.ts → procedure-name-kn-awLk1.d.ts}

@@ -1,22 +1,14 @@
 import { t as VRequired } from "./validators-0I-Ik1EN.js";
-import { A as HttpProcedureBuilderDef, D as HttpHandlerOpts, L as DataTransformerOptions, N as ProcedureMeta, O as HttpMethod, W as getTransformer, _ as CRPCHttpRouter, f as InferHttpInput, k as HttpProcedure, p as InferHttpOutput, y as HttpRouterRecord } from "./http-types-BhhPZtwa.js";
-import { g as UnsetMarker, i as IntersectIfDefined, o as MiddlewareBuilder, p as Overwrite$1, s as MiddlewareFunction, t as AnyMiddleware } from "./types-Bkeicpo6.js";
+import { l as EmptyObject, u as Expand } from "./caller-factory-C3pcbzo0.js";
+import { d as getTransformer, i as DataTransformerOptions } from "./transformer-BEkxlnss.js";
+import { g as UnsetMarker, i as IntersectIfDefined, o as MiddlewareBuilder, p as Overwrite$1, s as MiddlewareFunction, t as AnyMiddleware } from "./types-CzGsrLrY.js";
+import { A as HttpProcedureBuilderDef, D as HttpHandlerOpts, N as ProcedureMeta, O as HttpMethod, _ as CRPCHttpRouter, f as InferHttpInput, k as HttpProcedure, p as InferHttpOutput, y as HttpRouterRecord } from "./http-types-8FBr10yl.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";
 import * as z$1 from "zod";
 import * as z$2 from "zod/v4";
 import * as zCore from "zod/v4/core";
 
-//#region src/internal/upstream/index.d.ts
-type EmptyObject = Record<string, never>;
-/**
- * Hack! This type causes TypeScript to simplify how it renders object types.
- *
- * It is functionally the identity for object types, but in practice it can
- * simplify expressions like `A & B`.
- */
-type Expand<ObjectType extends Record<any, any>> = ObjectType extends Record<any, any> ? { [Key in keyof ObjectType]: ObjectType[Key] } : never;
-//#endregion
 //#region src/internal/upstream/server/customFunctions.d.ts
 /**
  * A customization of a query, mutation, or action.
@@ -653,13 +645,15 @@ declare function createHttpProcedureBuilder<TCtx, TMeta extends ProcedureMeta>(c
  */
 declare const paginatedSchemaForTypes: z$1.ZodObject<{
   cursor: z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodNull]>;
+  endCursor: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodNull]>>;
   limit: z$1.ZodNumber;
 }, z$1.core.$strip>;
 /** Paginated schema type - both cursor and limit are required after .paginated() */
 type PaginatedInputSchema = typeof paginatedSchemaForTypes;
-/** Paginated schema type for external callers - both fields are optional due defaults. */
+/** Paginated schema type for external callers before defaults are applied. */
 declare const paginatedSchemaForClientTypes: z$1.ZodObject<{
   cursor: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodNull]>>;
+  endCursor: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodNull]>>;
   limit: z$1.ZodOptional<z$1.ZodNumber>;
 }, z$1.core.$strip>;
 type PaginatedClientInputSchema = typeof paginatedSchemaForClientTypes;
@@ -811,8 +805,8 @@ declare class QueryProcedureBuilder<TBaseCtx, TContext, TContextOverrides extend
   /**
    * Add pagination input (chainable before .query())
    *
-   * Creates flat { cursor, limit } input like tRPC and auto-wraps output.
-   * User accesses args.cursor and args.limit directly.
+   * Creates flat { cursor, endCursor, limit } input like tRPC and auto-wraps
+   * output. User accesses the pagination fields directly from args.
    *
    * @param opts.limit - Default/max items per page
    * @param opts.item - Zod schema for each item in the page array
@@ -824,6 +818,8 @@ declare class QueryProcedureBuilder<TBaseCtx, TContext, TContextOverrides extend
     continueCursor: z$1.ZodUnion<[z$1.ZodString, z$1.ZodNull]>;
     isDone: z$1.ZodBoolean;
     page: z$1.ZodArray<TItem>;
+    pageStatus: z$1.ZodOptional<z$1.ZodUnion<[z$1.ZodLiteral<'SplitRecommended'>, z$1.ZodLiteral<'SplitRequired'>, z$1.ZodNull]>>;
+    splitCursor: z$1.ZodOptional<z$1.ZodUnion<[z$1.ZodString, z$1.ZodNull]>>;
   }>, TMeta>;
   /** Define output schema */
   output<TNewOutput extends z$1.ZodTypeAny>(schema: TNewOutput): QueryProcedureBuilder<TBaseCtx, TContext, TContextOverrides, TInput, TClientInput, TNewOutput, TMeta>;
@@ -1005,132 +1001,6 @@ declare function createApiLeaf<TType extends ApiFunctionType, TExport, TMeta ext
 };
 declare function createGeneratedFunctionReference<TType extends ApiFunctionType, TVisibility extends GeneratedFunctionVisibility, TExport>(name: string): GeneratedFunctionRefFromExport<TType, TVisibility, TExport>;
 //#endregion
-//#region src/server/caller.d.ts
-/** Metadata for a single function */
-type FnMeta = {
-  type?: 'query' | 'mutation' | 'action';
-  [key: string]: unknown;
-};
-/** Metadata for all functions in a module */
-type ModuleMeta = Record<string, FnMeta>;
-/** Metadata for all modules - from generated `@convex/api` */
-type CallerMeta = Record<string, ModuleMeta>;
-/** Options for individual caller function calls */
-type CallerOpts = {
-  /** Skip query silently when unauthenticated (returns null instead of throwing) */skipUnauth?: boolean;
-};
-type CallerReturn<T, Opts extends CallerOpts | undefined> = Opts extends {
-  skipUnauth: true;
-} ? T | null : T;
-type FetchFn<T extends 'query' | 'mutation' | 'action'> = <Fn extends FunctionReference<T>>(fn: Fn, args: Fn['_args'], opts?: CallerOpts) => Promise<FunctionReturnType<Fn> | null>;
-type CreateCallerOptions = {
-  fetchQuery: FetchFn<'query'>;
-  fetchMutation: FetchFn<'mutation'>;
-  fetchAction: FetchFn<'action'>;
-  meta: CallerMeta;
-  transformer?: DataTransformerOptions;
-};
-type ServerCallerFn<TApi, K extends keyof TApi> = TApi[K] extends FunctionReference<infer T, 'public'> ? T extends 'query' | 'mutation' | 'action' ? keyof TApi[K]['_args'] extends never ? <Opts extends CallerOpts | undefined = undefined>(args?: EmptyObject, opts?: Opts) => Promise<CallerReturn<FunctionReturnType<TApi[K]>, Opts>> : EmptyObject extends TApi[K]['_args'] ? <Opts extends CallerOpts | undefined = undefined>(args?: TApi[K]['_args'], opts?: Opts) => Promise<CallerReturn<FunctionReturnType<TApi[K]>, Opts>> : <Opts extends CallerOpts | undefined = undefined>(args: TApi[K]['_args'], opts?: Opts) => Promise<CallerReturn<FunctionReturnType<TApi[K]>, Opts>> : never : ServerCaller<TApi[K]>;
-type ServerCaller<TApi> = { [K in keyof TApi as K extends string ? K extends `_${string}` ? never : K extends 'http' ? never : K : K]: ServerCallerFn<TApi, K> };
-/**
- * Create a server caller for direct data fetching without React Query.
- *
- * This is detached from React Query cache - data is NOT available in client components.
- * Use for server-only data that doesn't need to be shared with the client.
- *
- * @example
- * ```tsx
- * // src/lib/convex/rsc.tsx
- * export const caller = createServerCaller(api, {
- *   fetchQuery: fetchAuthQuery,
- *   fetchMutation: fetchAuthMutation,
- * });
- *
- * // app/page.tsx (RSC)
- * const posts = await caller.posts.list();
- * return <div>{posts?.length} posts</div>;
- * ```
- */
-declare function createServerCaller<TApi extends Record<string, unknown>>(api: TApi, opts: CreateCallerOptions): ServerCaller<TApi>;
-//#endregion
-//#region src/server/lazy-caller.d.ts
-type CallerContext<TApi> = {
-  caller: ServerCaller<TApi>;
-  token: string | undefined;
-  isAuthenticated: boolean;
-};
-/**
- * Lazy caller with auth helper methods.
- * Context is created on first procedure invocation, not at definition time.
- */
-type LazyCaller<TApi> = ServerCaller<TApi> & {
-  /** Check if user is authenticated */isAuth: () => Promise<boolean>; /** Check if user is unauthenticated */
-  isUnauth: () => Promise<boolean>; /** Get the auth token (for RSC prefetching) */
-  getToken: () => Promise<string | undefined>;
-};
-/**
- * Create a lazy caller that creates context on each procedure invocation.
- * Matches tRPC's `appRouter.createCaller(createTRPCContext)` pattern.
- *
- * @example
- * ```ts
- * // server.ts
- * const { createContext, createCaller } = createCallerFactory({...});
- *
- * // rsc.tsx
- * const createRSCContext = cache(async () => {
- *   const heads = await headers();
- *   return createContext({ headers: heads });
- * });
- * export const caller = createCaller(createRSCContext);
- *
- * // app/page.tsx - single call! Context created lazily
- * const posts = await caller.posts.list();
- * ```
- */
-declare function createLazyCaller<TApi extends Record<string, unknown>>(api: TApi, createContext: () => Promise<CallerContext<TApi>>): LazyCaller<TApi>;
-//#endregion
-//#region src/server/caller-factory.d.ts
-type TokenResult = {
-  token?: string;
-  isFresh?: boolean;
-};
-type GetTokenFn = (siteUrl: string, headers: Headers, opts?: unknown) => Promise<TokenResult>;
-/** Auth options for server-side calls. */
-type AuthOptions = {
-  /** Function to extract auth token from request headers. */getToken: GetTokenFn;
-  /**
-   * Custom function to detect UNAUTHORIZED errors.
-   * Set this to resolve those errors to `null` instead of throwing.
-   *
-   * Refreshing an expired cached token and retrying does not require this:
-   * that always falls back to `defaultIsUnauthorized`.
-   */
-  isUnauthorized?: (error: unknown) => boolean;
-};
-type CreateCallerFactoryOptions<TApi> = {
-  /** Your Convex API object. */api: TApi; /** Convex site URL (must end in `.convex.site`). */
-  convexSiteUrl: string;
-  /**
-   * Convex deployment URL (must end in `.convex.cloud`).
-   * Defaults to `convexSiteUrl` with the domain swapped.
-   */
-  convexUrl?: string; /** Auth options. Pass to enable authenticated calls with JWT caching. */
-  auth?: AuthOptions; /** Optional wire transformer for request/response payloads (always composed with Date). */
-  transformer?: DataTransformerOptions;
-};
-type ConvexContext<TApi> = {
-  token: string | undefined;
-  isAuthenticated: boolean;
-  caller: ServerCaller<TApi>;
-};
-declare function createCallerFactory<TApi extends Record<string, unknown>>(opts: CreateCallerFactoryOptions<TApi>): {
-  createCaller: (ctxFn: () => Promise<ConvexContext<TApi>>) => LazyCaller<TApi>;
-  createContext: (reqOpts: {
-    headers: Headers;
-  }) => Promise<ConvexContext<TApi>>;
-};
-//#endregion
 //#region src/server/env.d.ts
 type RuntimeEnv = Record<string, string | undefined>;
 type CreateEnvOptions<TSchema extends z$1.ZodObject<z$1.ZodRawShape>> = {
@@ -1409,4 +1279,4 @@ type ProcedureNameLookup = Record<string, ProcedureNameEntry[]>;
 declare function registerProcedureNameLookup(lookup: ProcedureNameLookup, functionsDirHint: string): void;
 declare function inferProcedureNameFromCallsite(): string | undefined;
 //#endregion
-export { ActionProcedureBuilder as $, CRPCError as A, RuntimeEnv as B, createProcedureHandlerFactory as C, zCustomQuery as Ct, WithHttpRouter as D, zodToConvex as Dt, typedProcedureResolver as E, zodOutputToConvexFields as Et, getCRPCErrorFromUnknown as F, createLazyCaller as G, ConvexContext as H, getHTTPStatusCodeFromError as I, ServerCaller as J, CallerMeta as K, isCRPCError as L, CRPCErrorData as M, CRPC_ERROR_CODES_BY_KEY as N, inferApiInputs as O, zodToConvexFields as Ot, CRPC_ERROR_CODE_TO_HTTP as P, getGeneratedValue as Q, toCRPCError as R, createProcedureCallerFactory as S, zCustomMutation as St, getGeneratedFunctionReference as T, zodOutputToConvex as Tt, createCallerFactory as U, createEnv as V, LazyCaller as W, createApiLeaf as X, createServerCaller as Y, createGeneratedFunctionReference as Z, ProcedureSchedulableCallerFromRegistry as _, ZodValidatorFromConvex as _t, CreateProcedureCallerFactoryOptions as a, initCRPC as at, createGenericCallerFactory as b, withSystemFields as bt, GeneratedRegistryCallerFactory as c, extractPathParams as ct, GeneratedRegistryHandlerForContext as d, ConvexValidatorFromZod as dt, CRPCFunctionTypeHint as et, ProcedureActionCallerFromRegistry as f, ConvexValidatorFromZodOutput as ft, ProcedureFromFunctionReference as g, ZodFromValidatorBase as gt, ProcedureDefinition as h, Zid as ht, registerProcedureNameLookup as i, createMiddlewareFactory as it, CRPCErrorCode as j, inferApiOutputs as k, GeneratedRegistryCallerForContext as l, handleHttpError as lt, ProcedureCallerFromRegistry as m, ZCustomCtx as mt, ProcedureNameLookup as n, ProcedureBuilder as nt, GeneratedProcedureRegistry as o, HttpProcedureBuilder as ot, ProcedureCaller as p, CustomBuilder as pt, CallerOpts as q, inferProcedureNameFromCallsite as r, QueryProcedureBuilder as rt, GeneratedProcedureRegistryEntry as s, createHttpProcedureBuilder as st, ProcedureNameEntry as t, MutationProcedureBuilder as tt, GeneratedRegistryHandlerFactory as u, matchPathParams as ut, ProcedureScheduleCallerFromRegistry as v, convexToZod as vt, defineProcedure as w, zid as wt, createGenericHandlerFactory as x, zCustomAction as xt, createGeneratedRegistryRuntime as y, convexToZodFields as yt, CreateEnvOptions as z };
+export { createHttpProcedureBuilder as $, CRPCError as A, RuntimeEnv as B, createProcedureHandlerFactory as C, WithHttpRouter as D, typedProcedureResolver as E, getCRPCErrorFromUnknown as F, ActionProcedureBuilder as G, createApiLeaf as H, getHTTPStatusCodeFromError as I, ProcedureBuilder as J, CRPCFunctionTypeHint as K, isCRPCError as L, CRPCErrorData as M, CRPC_ERROR_CODES_BY_KEY as N, inferApiInputs as O, CRPC_ERROR_CODE_TO_HTTP as P, HttpProcedureBuilder as Q, toCRPCError as R, createProcedureCallerFactory as S, getGeneratedFunctionReference as T, createGeneratedFunctionReference as U, createEnv as V, getGeneratedValue as W, createMiddlewareFactory as X, QueryProcedureBuilder as Y, initCRPC as Z, ProcedureSchedulableCallerFromRegistry as _, zodOutputToConvex as _t, CreateProcedureCallerFactoryOptions as a, CustomBuilder as at, createGenericCallerFactory as b, zodToConvexFields as bt, GeneratedRegistryCallerFactory as c, ZodFromValidatorBase as ct, GeneratedRegistryHandlerForContext as d, convexToZodFields as dt, extractPathParams as et, ProcedureActionCallerFromRegistry as f, withSystemFields as ft, ProcedureFromFunctionReference as g, zid as gt, ProcedureDefinition as h, zCustomQuery as ht, registerProcedureNameLookup as i, ConvexValidatorFromZodOutput as it, CRPCErrorCode as j, inferApiOutputs as k, GeneratedRegistryCallerForContext as l, ZodValidatorFromConvex as lt, ProcedureCallerFromRegistry as m, zCustomMutation as mt, ProcedureNameLookup as n, matchPathParams as nt, GeneratedProcedureRegistry as o, ZCustomCtx as ot, ProcedureCaller as p, zCustomAction as pt, MutationProcedureBuilder as q, inferProcedureNameFromCallsite as r, ConvexValidatorFromZod as rt, GeneratedProcedureRegistryEntry as s, Zid as st, ProcedureNameEntry as t, handleHttpError as tt, GeneratedRegistryHandlerFactory as u, convexToZod as ut, ProcedureScheduleCallerFromRegistry as v, zodOutputToConvexFields as vt, defineProcedure as w, createGenericHandlerFactory as x, createGeneratedRegistryRuntime as y, zodToConvex as yt, CreateEnvOptions as z };

package/dist/{query-context-D4z1CnDH.js → query-context-DQLv58LH.js}

@@ -671,6 +671,21 @@ function mergedStream(streams, orderByIndexFields) {
 	return new MergedStream(streams, orderByIndexFields);
 }
 /**
+* Read streams over disjoint index ranges one after another, as one stream.
+*
+* Produces the same sequence a `mergedStream` over the whole index key would,
+* for sources that cannot interleave — but a source is only opened once the one
+* before it runs dry, so the fan-out a merge pays up front, one live query per
+* source, never happens. That is what makes a very wide union affordable.
+*
+* The caller owes disjointness and index order. Both are checked as rows come
+* out: a key that goes backwards throws rather than silently returning an
+* unordered stream.
+*/
+function concatStreams(streams) {
+	return new ConcatStreams(...streams);
+}
+/**
 * Marks sources that are already `OrderByStream`s, so `narrow` reuses them
 * instead of adding a redundant delegation layer per call.
 *
@@ -1134,6 +1149,24 @@ function* getOrderingIndexFields(stream) {
 	const streamIndexFields = stream.getIndexFields();
 	for (let i = 0; i <= streamEqualityIndexLength; i++) yield streamIndexFields.slice(i);
 }
+/**
+* Whether `mergedStream(..., orderByIndexFields)` would accept this stream.
+*
+* `MergedStream` wraps every source in an `OrderByStream`, which throws unless
+* the ordering fields are a suffix of the source's index fields past its
+* equality-pinned prefix. A caller that is *choosing* which index a source
+* walks has to know that before it commits to one, so it can fall back instead
+* of turning a working merge into a runtime error.
+*
+* Asks the stream itself rather than re-deriving the rule from an index name,
+* so the answer cannot drift from what `OrderByStream` actually enforces.
+*/
+function streamCanOrderBy(stream, orderByIndexFields) {
+	const normalized = orderByIndexFields.slice();
+	normalizeIndexFields(normalized);
+	for (const orderingIndexFields of getOrderingIndexFields(stream)) if (equalIndexFields(orderingIndexFields, normalized)) return true;
+	return false;
+}
 var OrderByStream = class OrderByStream extends QueryStream {
 	#staticFilter;
 	#stream;
@@ -1351,4 +1384,4 @@ async function getByIdWithOrmQueryFallback(ctx, tableName, id) {
 }
 
 //#endregion
-export { indexKeyWithinBounds as a, streamIndexRange as c, getIndexFields as i, isUnsetToken as l, EmptyStream as n, mergedStream as o, QueryStream as r, stream as s, getByIdWithOrmQueryFallback as t, unsetToken as u };
+export { getIndexFields as a, stream as c, isUnsetToken as d, unsetToken as f, concatStreams as i, streamCanOrderBy as l, EmptyStream as n, indexKeyWithinBounds as o, QueryStream as r, mergedStream as s, getByIdWithOrmQueryFallback as t, streamIndexRange as u };

package/dist/ratelimit/index.d.ts

@@ -1,5 +1,5 @@
-import { o as MiddlewareBuilder } from "../types-Bkeicpo6.js";
-import { t as Plugin } from "../middleware-BBS7oLtT.js";
+import { o as MiddlewareBuilder } from "../types-CzGsrLrY.js";
+import { t as Plugin } from "../middleware-D2hKJuSZ.js";
 import * as convex_server0 from "convex/server";
 
 //#region src/ratelimit/duration.d.ts

package/dist/ratelimit/index.js

@@ -1,6 +1,6 @@
 import { u as requireMutationCtx } from "../api-entry-Buvjl9hn.js";
-import { _ as CRPCError } from "../builder-Cyd5nCxZ.js";
-import { t as definePlugin } from "../middleware-D61Nm-iB.js";
+import { _ as CRPCError } from "../builder-DDYTlmTB.js";
+import { t as definePlugin } from "../middleware-LvZov-hA.js";
 import { v } from "convex/values";
 import { mutationGeneric, queryGeneric } from "convex/server";
 

package/dist/react/index.d.ts

@@ -487,8 +487,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)[];
@@ -946,7 +946,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;
@@ -955,13 +955,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';
 /** Fields we override or omit from TanStack Query's UseQueryResult */

package/dist/react/index.js

@@ -1479,11 +1479,12 @@ function createCRPCContext(options) {
 			const tokenReady = token === null || decodeJwtExp(token) !== null;
 			const identity = resolveAuthIdentity(token);
 			previousAuthRef.current = {
-				isAuthenticated,
-				identity
+				identity,
+				isAuthenticated
 			};
 			if (!previous) return;
-			if (tokenReady && (previous.identity !== identity || previous.isAuthenticated !== isAuthenticated)) convexQueryClient.resetAuthQueries();
+			const tokenRejected = previous.isAuthenticated && !isAuthenticated;
+			if (tokenReady && previous.identity !== identity || tokenRejected) convexQueryClient.resetAuthQueries();
 		}, [
 			convexQueryClient,
 			isAuthenticated,
@@ -2431,6 +2432,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/react/use-infinite-query.ts
@@ -2438,76 +2445,22 @@ const shouldSplitPaginationPage = (page, initialNumItems) => Boolean(page.splitC
 const PAGINATION_KEY_PREFIX = "__pagination__";
 let paginationIdCounter = 0;
 const createPaginationId = () => ++paginationIdCounter;
-/** 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, setState, state }) => {
+const useStaleCursorRecovery = ({ combined, resetPagination }) => {
 	useEffect(() => {
 		if (!combined.isFetchNextPageError) return;
-		const page0Result = combined._rawResults[0];
-		const page0Data = page0Result?.data;
-		const page0UpdatedAt = page0Result?.dataUpdatedAt ?? 0;
-		const hasPage0Data = page0Data !== void 0 && !page0Result?.isError;
-		const hasSubsequentErrors = combined._rawResults.slice(1).some((q) => q?.isError && !q?.isFetching);
-		if (!hasPage0Data || !hasSubsequentErrors || !page0Data?.continueCursor) return;
-		const recoveryKey = buildRecoveryKey(state.pageKeys, page0Data.continueCursor, page0UpdatedAt);
-		if (state.autoRecoveryAttempted === recoveryKey) return;
-		const erroredPageKeys = state.pageKeys.filter((_, i) => i > 0 && combined._rawResults[i]?.isError);
-		const itemsToRecover = erroredPageKeys.reduce((sum, key) => {
-			return sum + (state.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
-		}));
+		if (combined._rawResults.slice(1).some((result) => result?.isError && !result.isFetching && isInvalidPaginationCursor(result.error))) resetPagination();
 	}, [
 		combined.isFetchNextPageError,
 		combined._rawResults,
-		state.pageKeys,
-		state.queries,
-		state.autoRecoveryAttempted,
-		argsObject,
-		limit,
-		setState
-	]);
-	useEffect(() => {
-		if ((combined.status === "CanLoadMore" || combined.status === "Exhausted") && state.autoRecoveryAttempted) setState((prev) => ({
-			...prev,
-			autoRecoveryAttempted: void 0
-		}));
-	}, [
-		combined.status,
-		state.autoRecoveryAttempted,
-		setState
+		resetPagination
 	]);
 };
 /**
@@ -2705,7 +2658,7 @@ const useInfiniteQueryInternal = (query, args, options) => {
 				error: results.find((r) => r.isError)?.error ?? null,
 				isError: results.some((r) => r.isError),
 				isFetching,
-				isFetchNextPageError: results.length > 1 && (results.at(-1)?.isError ?? false),
+				isFetchNextPageError: results.slice(1).some((result) => result.isError),
 				isPlaceholderData,
 				isRefetching: isFetching && allItems.length > 0 && !isPlaceholderData,
 				_rawResults: results
@@ -2713,11 +2666,8 @@ const useInfiniteQueryInternal = (query, args, options) => {
 		}, [placeholderData])
 	});
 	useStaleCursorRecovery({
-		argsObject,
 		combined,
-		limit,
-		setState,
-		state
+		resetPagination: useCallback(() => setState(createInitialState()), [createInitialState, setState])
 	});
 	useEffect(() => {
 		for (let i = 0; i < combined._rawResults.length; i++) {
@@ -2726,15 +2676,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
 						};
@@ -2749,7 +2701,10 @@ const useInfiniteQueryInternal = (query, args, options) => {
 								...prev.queries,
 								[pageKey]: {
 									...currentPageState,
-									endCursor: splitCursor
+									args: {
+										...currentPageState.args,
+										endCursor: splitCursor
+									}
 								},
 								[newKey]: { args: splitPageArgs }
 							}

package/dist/rsc/index.d.ts

@@ -1,7 +1,8 @@
 import { n as DeepPartial, o as Simplify, r as DistributiveOmit } from "../types-Bqi_ivSd.js";
-import { L as DataTransformerOptions, _ as CRPCHttpRouter, c as HttpQueryKey, k as HttpProcedure, o as HttpMutationKey, y as HttpRouterRecord } from "../http-types-BhhPZtwa.js";
-import { g as UnsetMarker } from "../types-Bkeicpo6.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-BXpu7xIU.js";
+import { i as DataTransformerOptions } from "../transformer-BEkxlnss.js";
+import { g as UnsetMarker } from "../types-CzGsrLrY.js";
+import { _ as CRPCHttpRouter, c as HttpQueryKey, k as HttpProcedure, o as HttpMutationKey, y as HttpRouterRecord } from "../http-types-8FBr10yl.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-Cl0utsTL.js";
 import { FunctionArgs, FunctionReference, FunctionReturnType } from "convex/server";
 import { z } from "zod";
 import { DefaultError, QueryFilters, SkipToken, UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";