kitcn 0.32.2 → 0.33.1

package/CHANGELOG.md

@@ -1,5 +1,114 @@
 # kitcn
 
+## 0.33.1
+
+### Patch Changes
+
+- [#462](https://github.com/udecode/kitcn/pull/462) [`41eb956`](https://github.com/udecode/kitcn/commit/41eb9567ebea2ae0b6340624897815f54c51e0aa) Thanks [@zbeyens](https://github.com/zbeyens)! - Fix cRPC live pagination so reactive page splits preserve adjacent page
+  boundaries and invalid loaded cursors reset cleanly.
+
+## 0.33.0
+
+### Minor Changes
+
+- [#456](https://github.com/udecode/kitcn/pull/456) [`5b0bd5a`](https://github.com/udecode/kitcn/commit/5b0bd5a1debb4a0e0bb87f79ef1a18f357b614c1) Thanks [@MikeyZhang75](https://github.com/MikeyZhang75)! - ## Breaking changes
+
+  - Support index-ordered pagination for indexed filters with more than 64 values. Pages follow index order, grouped by the filtered value, rather than creation order. Add `orderBy` and `maxScan` to preserve newest-first paging.
+
+  ```ts
+  // Before
+  const page = await db.query.users.withIndex("by_status").findMany({
+    where: { status: { in: manyStatuses } },
+    cursor: null,
+    limit: 20,
+    maxScan: 500,
+  });
+
+  // After
+  const page = await db.query.users.withIndex("by_status").findMany({
+    where: { status: { in: manyStatuses } },
+    orderBy: { createdAt: "desc" },
+    cursor: null,
+    limit: 20,
+    maxScan: 500,
+  });
+  ```
+
+  ## Patches
+
+  - Fix authenticated cRPC query results disappearing when a server-rendered page
+    hydrates.
+  - Fix unnecessary full-table reads for `select()` filters containing more than 64 values.
+  - Fix unnecessary full-table reads for long `in` lists combined with another condition, such as `name: { contains: 'x' }`.
+  - Improve limited reads with additional conditions so they stop after enough matching rows are found when index order satisfies the requested sort.
+  - Support index-bounded reads for indexed `in`, `notIn`, `ne`, and same-field equality `OR` filters regardless of list length.
+  - Support pagination without `maxScan` for wide filters whose requested order follows their indexed values; cross-value sorting, such as `orderBy: { createdAt: 'desc' }`, still requires `maxScan` past 64 values.
+
+- [#449](https://github.com/udecode/kitcn/pull/449) [`b8df2da`](https://github.com/udecode/kitcn/commit/b8df2da49a8733b545f02b84bb538b1cbef275b0) Thanks [@MikeyZhang75](https://github.com/MikeyZhang75)! - ## Breaking changes
+
+  - Read a `select().flatMap(relation, { where })` stage through an index that extends the relation's foreign key when the schema declares one. Children arrive in that index's order, so a lowered range field now orders them ahead of creation time, and outstanding page cursors for those queries do not carry over.
+
+  ```ts
+  // Before: every post by the author is read, then filtered, in creation order.
+  // After: only the by_author_likes range is read, in numLikes order.
+  index("by_author_likes").on(t.authorId, t.numLikes);
+
+  await ctx.orm.query.users
+    .select()
+    .flatMap("posts", { includeParent: false, where: { numLikes: { gt: 10 } } })
+    .paginate({ cursor: null, limit: 20 });
+  ```
+
+  ## Patches
+
+  - Compile a `select().union([{ where }])` source `where` against the table's indexes instead of filtering every scanned row, so an object `where` on an indexed field bounds the read. A source keeps its unanchored read when the lowered one could not supply `interleaveBy`, and a `where` never displaces an index the source or the chain pinned with a range.
+  - Report what a caller can actually do when a `predicate(...)` `where` runs over an unbounded pipeline read: a union source names its own `index` option, and a `flatMap` stage names the relation index it needs.
+  - Resolve a `select()` union source or `flatMap` stage `where` once per read. A callback `where` runs a single time instead of twice, and an object `where` compiles once instead of once per row.
+
+### Patch Changes
+
+- [#455](https://github.com/udecode/kitcn/pull/455) [`a73de28`](https://github.com/udecode/kitcn/commit/a73de28bacf3e518a38762442270d2c54f6989e8) Thanks [@MikeyZhang75](https://github.com/MikeyZhang75)! - ## Patches
+
+  - Fix `findMany` losing its read bound when a `limit` is combined with `in`, `ne`,
+    `notIn` or a same-field `OR` on a table that has RLS enabled, or alongside a
+    filter Convex cannot evaluate such as `contains`. Either one used to make the
+    query read every row it matched against, so
+    `findMany({ where: { ownerId: { in: [a, b] } }, limit: 3 })` read 500 documents
+    on a 500-row table and 200 on a 200-row table. It now reads 6 at either size,
+    and the count no longer grows with the table.
+  - Improve how that `limit` is counted, so it bounds rows the caller can actually
+    see: with 80 rows an RLS policy hides sitting in front of the matches,
+    `limit: 3` still returns three rows and reads 86 documents instead of 200.
+  - Support that bound for an `in` list of any length.
+
+  Rows and their order are unchanged. A `where` that filters through a relation
+  keeps its previous read cost, as does `ne`, `notIn` or `isNotNull` ordered by a
+  field no index can serve.
+
+- [#450](https://github.com/udecode/kitcn/pull/450) [`781af65`](https://github.com/udecode/kitcn/commit/781af65c6e2f9128362378f0cf358d2c8e509b7d) Thanks [@MikeyZhang75](https://github.com/MikeyZhang75)! - ## Patches
+
+  - Improve update read costs on `aggregateIndex` and `rankIndex` tables: read
+    each row once unless a user `update.before` hook requires a fresh read.
+  - Fix CLEARING checks for deletes of already-deleted rows: report the
+    transient aggregate-index state instead of `Delete on non-existent doc`.
+
+- [#451](https://github.com/udecode/kitcn/pull/451) [`80f7609`](https://github.com/udecode/kitcn/commit/80f7609cb107d23e4688b6877f35787107dd0a39) Thanks [@MikeyZhang75](https://github.com/MikeyZhang75)! - ## Patches
+
+  - Improve `aggregateIndex` bulk-write read costs by reusing bucket and member
+    reads within uninterrupted ORM statements. User hooks and policy callbacks
+    end reuse so nested mutation writes remain visible to later maintenance.
+
+- [#454](https://github.com/udecode/kitcn/pull/454) [`f399843`](https://github.com/udecode/kitcn/commit/f399843c6bfb46e080558bc22d2cc4a77842cd16) Thanks [@MikeyZhang75](https://github.com/MikeyZhang75)! - ## Patches
+
+  - Improve bulk aggregate writes by folding shared bucket and extrema updates
+    within uninterrupted statements. A 40-row key migration writes two shared
+    buckets and two extrema entries, plus forty membership rows.
+  - Preserve read-your-own-writes through aggregate reads and nested functions
+    called by lifecycle hooks or RLS policies. Reads and callbacks flush pending
+    writes; callbacks suspend batching until they settle.
+  - Fix mid-statement aggregate reads through `withoutTriggers()` and an ORM
+    rebuilt from a hook context to observe the same rows as `ctx.orm`.
+
 ## 0.32.2
 
 ### Patch Changes

package/dist/aggregate/index.d.ts

@@ -1,5 +1,5 @@
-import { Vn as ConvexTextBuilderInitial, Zt as ConvexTableWithColumns } from "../capabilities-BJm_VSDT.js";
-import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial } from "../where-clause-compiler-Dgf4lrO-.js";
+import { Vn as ConvexTextBuilderInitial, Zt as ConvexTableWithColumns } from "../capabilities-Bxzoofl4.js";
+import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial } from "../where-clause-compiler-CoPVAVDO.js";
 import * as convex_values0 from "convex/values";
 import { GenericId, Infer, Value } from "convex/values";
 import { DocumentByName, GenericDataModel, GenericDatabaseReader, GenericDatabaseWriter, TableNamesInDataModel } from "convex/server";

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

@@ -1,2 +1,2 @@
-import { C as GenericAuthTriggerHandlers, S as GenericAuthTriggerChange, T as defineAuth, b as GenericAuthBeforeResult, i as getGeneratedAuthDisabledReason, n as GeneratedAuthDisabledReasonKind, r as createDisabledAuthRuntime, t as AuthRuntime, w as GenericAuthTriggers, x as GenericAuthDefinition, y as BetterAuthOptionsWithoutDatabase } from "../../generated-contract-disabled-BRm1dNQE.js";
+import { C as GenericAuthTriggerHandlers, S as GenericAuthTriggerChange, T as defineAuth, b as GenericAuthBeforeResult, i as getGeneratedAuthDisabledReason, n as GeneratedAuthDisabledReasonKind, r as createDisabledAuthRuntime, t as AuthRuntime, w as GenericAuthTriggers, x as GenericAuthDefinition, y as BetterAuthOptionsWithoutDatabase } from "../../generated-contract-disabled-B_EaHGCP.js";
 export { type AuthRuntime, BetterAuthOptionsWithoutDatabase, type GeneratedAuthDisabledReasonKind, GenericAuthBeforeResult, GenericAuthDefinition, GenericAuthTriggerChange, GenericAuthTriggerHandlers, GenericAuthTriggers, createDisabledAuthRuntime, defineAuth, getGeneratedAuthDisabledReason };

package/dist/auth/index.d.ts

@@ -1,7 +1,7 @@
 import { a as QueryCtxWithPreferredOrmQueryTable, n as LookupByIdResultByCtx, t as DocByCtx } from "../query-context-BkNjkDCk.js";
 import { t as GetAuth } from "../types-ex0-J-SC.js";
-import { t as GenericCtx } from "../context-utils-Cbv4r0AA.js";
-import { C as GenericAuthTriggerHandlers, S as GenericAuthTriggerChange, T as defineAuth, _ as updateManyHandler, a as AuthFunctions, b as GenericAuthBeforeResult, c as consumeOneHandler, d as createHandler, f as deleteManyHandler, g as incrementOneHandler, h as findOneHandler, i as getGeneratedAuthDisabledReason, l as countHandler, m as findManyHandler, n as GeneratedAuthDisabledReasonKind, o as Triggers, p as deleteOneHandler, r as createDisabledAuthRuntime, s as createClient, t as AuthRuntime, u as createApi, v as updateOneHandler, w as GenericAuthTriggers, x as GenericAuthDefinition, y as BetterAuthOptionsWithoutDatabase } from "../generated-contract-disabled-BRm1dNQE.js";
+import { t as GenericCtx } from "../context-utils-ax351iFc.js";
+import { C as GenericAuthTriggerHandlers, S as GenericAuthTriggerChange, T as defineAuth, _ as updateManyHandler, a as AuthFunctions, b as GenericAuthBeforeResult, c as consumeOneHandler, d as createHandler, f as deleteManyHandler, g as incrementOneHandler, h as findOneHandler, i as getGeneratedAuthDisabledReason, l as countHandler, m as findManyHandler, n as GeneratedAuthDisabledReasonKind, o as Triggers, p as deleteOneHandler, r as createDisabledAuthRuntime, s as createClient, t as AuthRuntime, u as createApi, v as updateOneHandler, w as GenericAuthTriggers, x as GenericAuthDefinition, y as BetterAuthOptionsWithoutDatabase } from "../generated-contract-disabled-B_EaHGCP.js";
 import * as convex_values0 from "convex/values";
 import { Infer } from "convex/values";
 import { AuthConfig, DocumentByName, GenericDataModel, GenericMutationCtx, GenericQueryCtx, GenericSchema, PaginationOptions, PaginationResult, SchemaDefinition, TableNamesInDataModel } from "convex/server";
@@ -109,31 +109,31 @@ type AdapterPaginationOptions = PaginationOptions & {
 };
 declare const adapterWhereValidator: convex_values0.VObject<{
   mode?: "sensitive" | "insensitive" | undefined;
+  operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
   connector?: "AND" | "OR" | undefined;
-  operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
   value: string | number | boolean | string[] | number[] | null;
   field: string;
 }, {
   connector: convex_values0.VUnion<"AND" | "OR" | undefined, [convex_values0.VLiteral<"AND", "required">, convex_values0.VLiteral<"OR", "required">], "optional", never>;
   field: convex_values0.VString<string, "required">;
   mode: convex_values0.VUnion<"sensitive" | "insensitive" | undefined, [convex_values0.VLiteral<"sensitive", "required">, convex_values0.VLiteral<"insensitive", "required">], "optional", never>;
-  operator: convex_values0.VUnion<"lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined, [convex_values0.VLiteral<"lt", "required">, convex_values0.VLiteral<"lte", "required">, convex_values0.VLiteral<"gt", "required">, convex_values0.VLiteral<"gte", "required">, convex_values0.VLiteral<"eq", "required">, convex_values0.VLiteral<"in", "required">, convex_values0.VLiteral<"not_in", "required">, convex_values0.VLiteral<"ne", "required">, convex_values0.VLiteral<"contains", "required">, convex_values0.VLiteral<"starts_with", "required">, convex_values0.VLiteral<"ends_with", "required">], "optional", never>;
+  operator: convex_values0.VUnion<"eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined, [convex_values0.VLiteral<"lt", "required">, convex_values0.VLiteral<"lte", "required">, convex_values0.VLiteral<"gt", "required">, convex_values0.VLiteral<"gte", "required">, convex_values0.VLiteral<"eq", "required">, convex_values0.VLiteral<"in", "required">, convex_values0.VLiteral<"not_in", "required">, convex_values0.VLiteral<"ne", "required">, convex_values0.VLiteral<"contains", "required">, convex_values0.VLiteral<"starts_with", "required">, convex_values0.VLiteral<"ends_with", "required">], "optional", never>;
   value: convex_values0.VUnion<string | number | boolean | string[] | number[] | null, [convex_values0.VString<string, "required">, convex_values0.VFloat64<number, "required">, convex_values0.VBoolean<boolean, "required">, convex_values0.VArray<string[], convex_values0.VString<string, "required">, "required">, convex_values0.VArray<number[], convex_values0.VFloat64<number, "required">, "required">, convex_values0.VNull<null, "required">], "required", never>;
-}, "required", "mode" | "value" | "connector" | "field" | "operator">;
+}, "required", "mode" | "value" | "operator" | "field" | "connector">;
 declare const adapterArgsValidator: convex_values0.VObject<{
+  limit?: number | undefined;
   where?: {
     mode?: "sensitive" | "insensitive" | undefined;
+    operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
     connector?: "AND" | "OR" | undefined;
-    operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
     value: string | number | boolean | string[] | number[] | null;
     field: string;
   }[] | undefined;
-  limit?: number | undefined;
-  offset?: number | undefined;
   select?: string[] | undefined;
+  offset?: number | undefined;
   sortBy?: {
-    field: string;
     direction: "asc" | "desc";
+    field: string;
   } | undefined;
   model: string;
 }, {
@@ -142,32 +142,32 @@ declare const adapterArgsValidator: convex_values0.VObject<{
   offset: convex_values0.VFloat64<number | undefined, "optional">;
   select: convex_values0.VArray<string[] | undefined, convex_values0.VString<string, "required">, "optional">;
   sortBy: convex_values0.VObject<{
-    field: string;
     direction: "asc" | "desc";
+    field: string;
   } | undefined, {
     direction: convex_values0.VUnion<"asc" | "desc", [convex_values0.VLiteral<"asc", "required">, convex_values0.VLiteral<"desc", "required">], "required", never>;
     field: convex_values0.VString<string, "required">;
-  }, "optional", "field" | "direction">;
+  }, "optional", "direction" | "field">;
   where: convex_values0.VArray<{
     mode?: "sensitive" | "insensitive" | undefined;
+    operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
     connector?: "AND" | "OR" | undefined;
-    operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
     value: string | number | boolean | string[] | number[] | null;
     field: string;
   }[] | undefined, convex_values0.VObject<{
     mode?: "sensitive" | "insensitive" | undefined;
+    operator?: "eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined;
     connector?: "AND" | "OR" | undefined;
-    operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
     value: string | number | boolean | string[] | number[] | null;
     field: string;
   }, {
     connector: convex_values0.VUnion<"AND" | "OR" | undefined, [convex_values0.VLiteral<"AND", "required">, convex_values0.VLiteral<"OR", "required">], "optional", never>;
     field: convex_values0.VString<string, "required">;
     mode: convex_values0.VUnion<"sensitive" | "insensitive" | undefined, [convex_values0.VLiteral<"sensitive", "required">, convex_values0.VLiteral<"insensitive", "required">], "optional", never>;
-    operator: convex_values0.VUnion<"lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined, [convex_values0.VLiteral<"lt", "required">, convex_values0.VLiteral<"lte", "required">, convex_values0.VLiteral<"gt", "required">, convex_values0.VLiteral<"gte", "required">, convex_values0.VLiteral<"eq", "required">, convex_values0.VLiteral<"in", "required">, convex_values0.VLiteral<"not_in", "required">, convex_values0.VLiteral<"ne", "required">, convex_values0.VLiteral<"contains", "required">, convex_values0.VLiteral<"starts_with", "required">, convex_values0.VLiteral<"ends_with", "required">], "optional", never>;
+    operator: convex_values0.VUnion<"eq" | "ne" | "lt" | "lte" | "gt" | "gte" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | undefined, [convex_values0.VLiteral<"lt", "required">, convex_values0.VLiteral<"lte", "required">, convex_values0.VLiteral<"gt", "required">, convex_values0.VLiteral<"gte", "required">, convex_values0.VLiteral<"eq", "required">, convex_values0.VLiteral<"in", "required">, convex_values0.VLiteral<"not_in", "required">, convex_values0.VLiteral<"ne", "required">, convex_values0.VLiteral<"contains", "required">, convex_values0.VLiteral<"starts_with", "required">, convex_values0.VLiteral<"ends_with", "required">], "optional", never>;
     value: convex_values0.VUnion<string | number | boolean | string[] | number[] | null, [convex_values0.VString<string, "required">, convex_values0.VFloat64<number, "required">, convex_values0.VBoolean<boolean, "required">, convex_values0.VArray<string[], convex_values0.VString<string, "required">, "required">, convex_values0.VArray<number[], convex_values0.VFloat64<number, "required">, "required">, convex_values0.VNull<null, "required">], "required", never>;
-  }, "required", "mode" | "value" | "connector" | "field" | "operator">, "optional">;
-}, "required", "model" | "where" | "limit" | "offset" | "select" | "sortBy" | "sortBy.field" | "sortBy.direction">;
+  }, "required", "mode" | "value" | "operator" | "field" | "connector">, "optional">;
+}, "required", "limit" | "where" | "model" | "select" | "offset" | "sortBy" | "sortBy.direction" | "sortBy.field">;
 declare const hasUniqueFields: (betterAuthSchema: BetterAuthDBSchema, model: string, input: Record<string, any>) => boolean;
 declare const checkUniqueFields: <Schema extends SchemaDefinition<any, any>>(ctx: GenericQueryCtx<GenericDataModel>, schema: Schema, betterAuthSchema: BetterAuthDBSchema, table: string, input: Record<string, any>, doc?: Record<string, any>) => Promise<void>;
 declare const selectFields: <T extends TableNamesInDataModel<GenericDataModel>, D extends DocumentByName<GenericDataModel, T>>(doc: D | null, select?: string[]) => D | null;

package/dist/auth/index.js

@@ -4,7 +4,7 @@ import { i as defineAuth, n as createDisabledAuthRuntime, r as getGeneratedAuthD
 import { n as createGeneratedFunctionReference, o as isQueryCtx, s as isRunMutationCtx } from "../api-entry-Buvjl9hn.js";
 import { i as customQuery, n as customCtx, r as customMutation } from "../customFunctions-X_B4kET8.js";
 import { C as eq, o as getAggregateIndexes } from "../index-utils-DvK7P6Q1.js";
-import { o as mergedStream, s as stream, t as getByIdWithOrmQueryFallback, u as unsetToken } from "../query-context-D4z1CnDH.js";
+import { c as stream, f as unsetToken, s as mergedStream, t as getByIdWithOrmQueryFallback } from "../query-context-DQLv58LH.js";
 import { n as convex } from "../convex-plugin-AbNQl1Sg.js";
 import { v } from "convex/values";
 import { internalActionGeneric, internalMutationGeneric, internalQueryGeneric, paginationOptsValidator } from "convex/server";

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

@@ -1,5 +1,5 @@
-import { H as ConvexContext, W as LazyCaller } from "../../procedure-name-DPYyLiVS.js";
-import { t as GetTokenOptions } from "../../token-tlbNKQS0.js";
+import { r as LazyCaller, t as ConvexContext } from "../../caller-factory-C3pcbzo0.js";
+import { t as GetTokenOptions } from "../../token-CZpDQUHd.js";
 
 //#region src/auth-nextjs/index.d.ts
 /** Auth options for server-side calls. */

package/dist/auth/start/server/index.d.ts

@@ -1,5 +1,5 @@
-import { H as ConvexContext, W as LazyCaller } from "../../../procedure-name-DPYyLiVS.js";
-import { t as GetTokenOptions } from "../../../token-tlbNKQS0.js";
+import { r as LazyCaller, t as ConvexContext } from "../../../caller-factory-C3pcbzo0.js";
+import { t as GetTokenOptions } from "../../../token-CZpDQUHd.js";
 import { FunctionReference, FunctionReturnType, OptionalRestArgs } from "convex/server";
 
 //#region src/auth-start/server.d.ts

package/dist/{builder-Cyd5nCxZ.js → builder-DDYTlmTB.js}

@@ -1716,10 +1716,12 @@ function inferProcedureNameFromCallsite() {
 */
 z$1.object({
 	cursor: z$1.union([z$1.string(), z$1.null()]),
+	endCursor: z$1.union([z$1.string(), z$1.null()]).optional(),
 	limit: z$1.number()
 });
 z$1.object({
 	cursor: z$1.union([z$1.string(), z$1.null()]).optional(),
+	endCursor: z$1.union([z$1.string(), z$1.null()]).optional(),
 	limit: z$1.number().optional()
 });
 /**
@@ -2120,8 +2122,8 @@ var QueryProcedureBuilder = class QueryProcedureBuilder extends ProcedureBuilder
 	/**
 	* 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
@@ -2129,12 +2131,19 @@ var QueryProcedureBuilder = class QueryProcedureBuilder extends ProcedureBuilder
 	paginated(opts) {
 		const paginationSchemaWithDefault = z$1.object({
 			cursor: z$1.union([z$1.string(), z$1.null()]).default(null),
+			endCursor: z$1.union([z$1.string(), z$1.null()]).optional(),
 			limit: z$1.number().default(opts.limit).transform((n) => Math.min(n, opts.limit))
 		});
 		const outputSchema = z$1.object({
 			continueCursor: z$1.union([z$1.string(), z$1.null()]),
 			isDone: z$1.boolean(),
-			page: z$1.array(opts.item)
+			page: z$1.array(opts.item),
+			pageStatus: z$1.union([
+				z$1.literal("SplitRecommended"),
+				z$1.literal("SplitRequired"),
+				z$1.null()
+			]).optional(),
+			splitCursor: z$1.union([z$1.string(), z$1.null()]).optional()
 		});
 		return new QueryProcedureBuilder({
 			...this._def,

package/dist/caller-factory-C3pcbzo0.d.ts

@@ -0,0 +1,140 @@
+import { i as DataTransformerOptions } from "./transformer-BEkxlnss.js";
+import { FunctionReference, FunctionReturnType } from "convex/server";
+
+//#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/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
+export { CallerMeta as a, createServerCaller as c, createLazyCaller as i, EmptyObject as l, createCallerFactory as n, CallerOpts as o, LazyCaller as r, ServerCaller as s, ConvexContext as t, Expand as u };