kitcn 0.33.0 → 0.33.1

package/package.json

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

package/skills/kitcn/SKILL.md

@@ -34,7 +34,7 @@ Only remember these non-parity deltas:
 2. No `z.void()` outputs; omit `.output(...)` for no-value mutations.
 3. `.output(...)` parses the handler's value as-is and substitutes nothing: a handler must return the schema's *input* type, so `z.string().nullable()` needs an explicit `null` (`?? null`), not `undefined`. Model absent values as `.nullable()`, never a top-level `.optional()` — Convex wires `undefined` as `null` and cannot express top-level optionality, so `.output(z.string().optional())` publishes `v.string()` and the deployment rejects the `null` whenever the handler returns `undefined`. `.optional()` inside an object is fine. The low-level `returns:` option on `zCustomQuery`/`zCustomMutation`/`zCustomAction` differs — it substitutes `null` for `undefined` before parsing.
 4. Stacked `.input(...)` calls merge input shapes.
-5. `.paginated({ limit, item })` must be before `.query()` and auto-adds `input.cursor` + `input.limit`, output `{ page, continueCursor, isDone }`.
+5. `.paginated({ limit, item })` must be before `.query()` and adds `input.cursor`, `input.endCursor`, and `input.limit`; pass all three to ORM cursor queries so live splits stay bounded.
 6. Metadata is codegen’d onto `@convex/api` leaves (`api.namespace.fn.meta`) so never put secrets in `.meta(...)`; chaining `.meta(...)` is shallow merge and supports `defaultMeta`.
 7. Auth metadata drives client behavior: `auth: "optional"` waits for auth load then runs, `auth: "required"` waits then skips when logged out.
 8. `ctx.orm` enforces constraints + RLS; `ctx.db` bypasses them.
@@ -245,6 +245,7 @@ export const listProjects = authQuery
       where: { ownerId: ctx.userId },
       orderBy: { updatedAt: "desc" },
       cursor: input.cursor,
+      endCursor: input.endCursor,
       limit: input.limit,
     })
   );

package/skills/kitcn/references/features/auth-admin.md

@@ -265,6 +265,7 @@ export const getAllUsers = authQuery
   .query(async ({ ctx, input }) => {
     const result = await ctx.orm.query.user.findMany({
       cursor: input.cursor,
+      endCursor: input.endCursor,
       limit: input.limit,
     });
 

package/skills/kitcn/references/features/react.md

@@ -374,20 +374,19 @@ export const list = publicQuery
   .input(z.object({ userId: z.string().optional() }))
   .paginated({ limit: 20, item: SessionSchema })
   .query(async ({ ctx, input }) => {
-    // input.cursor and input.limit auto-added
     return ctx.orm.query.session.findMany({
       where: input.userId ? { userId: input.userId } : undefined,
       orderBy: { createdAt: 'desc' },
       cursor: input.cursor,
+      endCursor: input.endCursor,
       limit: input.limit,
     });
-    // output auto-wrapped as { continueCursor, isDone, page }
   });
 ```
 
 `.paginated({ limit, item })`:
-- Adds `cursor` (string|null) and `limit` (number) to input
-- Auto-sets output schema: `{ continueCursor: string, isDone: boolean, page: T[] }`
+- Adds `cursor`, optional `endCursor`, and `limit` to input
+- Accepts the full Convex page result, including `pageStatus` and `splitCursor`
 - Must be called before `.query()`
 
 ### Return Value
@@ -414,7 +413,7 @@ const { data, isPlaceholderData } = useInfiniteQuery(
 
 ### Real-time & Error Recovery
 
-Each page maintains its own WebSocket subscription. Auto-recovers on `InvalidCursor` (resets to page 0) and `splitCursor` (auto-splits page). Pagination state persists in `queryClient` for scroll restoration.
+Each page maintains its own WebSocket subscription. Split pages use `endCursor` to keep adjacent subscriptions bounded. An `InvalidCursor` on a loaded page resets the list cleanly to page 0. Pagination state persists in `queryClient` for scroll restoration.
 
 ---