kitcn 0.33.0 → 0.33.2

package/dist/{where-clause-compiler-DrV6lQg0.d.ts → where-clause-compiler-B0kyVGzW.d.ts}

@@ -133,7 +133,7 @@ declare const migrationStorageTables: {
           fieldName: "updatedAt";
         };
       };
-      processed: ConvexNumberBuilderInitial<""> & {
+      migrationId: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -143,37 +143,45 @@ declare const migrationStorageTables: {
         };
       } & {
         _: {
-          fieldName: "processed";
+          fieldName: "migrationId";
         };
       };
-      startedAt: ConvexNumberBuilderInitial<""> & {
+      checksum: ConvexTextBuilderInitial<""> & {
+        _: {
+          notNull: true;
+        };
+      } & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "startedAt";
+          fieldName: "checksum";
         };
       };
-      completedAt: ConvexNumberBuilderInitial<""> & {
+      applied: ConvexBooleanBuilderInitial<""> & {
+        _: {
+          notNull: true;
+        };
+      } & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "completedAt";
+          fieldName: "applied";
         };
       };
-      lastError: ConvexTextBuilderInitial<""> & {
+      runId: ConvexTextBuilderInitial<""> & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "lastError";
+          fieldName: "runId";
         };
       };
-      migrationId: ConvexTextBuilderInitial<""> & {
+      processed: ConvexNumberBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -183,42 +191,34 @@ declare const migrationStorageTables: {
         };
       } & {
         _: {
-          fieldName: "migrationId";
+          fieldName: "processed";
         };
       };
-      checksum: ConvexTextBuilderInitial<""> & {
-        _: {
-          notNull: true;
-        };
-      } & {
+      startedAt: ConvexNumberBuilderInitial<""> & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "checksum";
+          fieldName: "startedAt";
         };
       };
-      applied: ConvexBooleanBuilderInitial<""> & {
-        _: {
-          notNull: true;
-        };
-      } & {
+      completedAt: ConvexNumberBuilderInitial<""> & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "applied";
+          fieldName: "completedAt";
         };
       };
-      runId: ConvexTextBuilderInitial<""> & {
+      lastError: ConvexTextBuilderInitial<""> & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "runId";
+          fieldName: "lastError";
         };
       };
       writeMode: ConvexTextBuilderInitial<""> & {
@@ -282,7 +282,7 @@ declare const migrationStorageTables: {
           fieldName: "updatedAt";
         };
       };
-      startedAt: ConvexNumberBuilderInitial<""> & {
+      runId: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -292,38 +292,38 @@ declare const migrationStorageTables: {
         };
       } & {
         _: {
-          fieldName: "startedAt";
+          fieldName: "runId";
         };
       };
-      completedAt: ConvexNumberBuilderInitial<""> & {
+      startedAt: ConvexNumberBuilderInitial<""> & {
+        _: {
+          notNull: true;
+        };
+      } & {
         _: {
           tableName: "migration_run";
         };
       } & {
         _: {
-          fieldName: "completedAt";
+          fieldName: "startedAt";
         };
       };
-      lastError: ConvexTextBuilderInitial<""> & {
+      completedAt: ConvexNumberBuilderInitial<""> & {
         _: {
           tableName: "migration_run";
         };
       } & {
         _: {
-          fieldName: "lastError";
+          fieldName: "completedAt";
         };
       };
-      runId: ConvexTextBuilderInitial<""> & {
-        _: {
-          notNull: true;
-        };
-      } & {
+      lastError: ConvexTextBuilderInitial<""> & {
         _: {
           tableName: "migration_run";
         };
       } & {
         _: {
-          fieldName: "runId";
+          fieldName: "lastError";
         };
       };
       dryRun: ConvexBooleanBuilderInitial<""> & {
@@ -1326,11 +1326,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
   readonly aggregate_extrema: ConvexTableWithColumns<{
     name: "aggregate_extrema";
     columns: {
-      value: ConvexCustomBuilderInitial<"", convex_values0.VAny<any, "required", string>> & {
-        _: {
-          $type: convex_values0.Value;
-        };
-      } & {
+      count: ConvexNumberBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1340,10 +1336,14 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "value";
+          fieldName: "count";
         };
       };
-      count: ConvexNumberBuilderInitial<""> & {
+      value: ConvexCustomBuilderInitial<"", convex_values0.VAny<any, "required", string>> & {
+        _: {
+          $type: convex_values0.Value;
+        };
+      } & {
         _: {
           notNull: true;
         };
@@ -1353,7 +1353,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "count";
+          fieldName: "value";
         };
       };
       updatedAt: ConvexNumberBuilderInitial<""> & {
@@ -1631,7 +1631,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
           fieldName: "updatedAt";
         };
       };
-      indexName: ConvexTextBuilderInitial<""> & {
+      processed: ConvexNumberBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1641,10 +1641,10 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "indexName";
+          fieldName: "processed";
         };
       };
-      keyDefinitionHash: ConvexTextBuilderInitial<""> & {
+      startedAt: ConvexNumberBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1654,23 +1654,28 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "keyDefinitionHash";
+          fieldName: "startedAt";
         };
       };
-      metricDefinitionHash: ConvexTextBuilderInitial<""> & {
+      completedAt: ConvexNumberBuilderInitial<""> & {
         _: {
-          notNull: true;
+          tableName: "aggregate_state";
         };
       } & {
+        _: {
+          fieldName: "completedAt";
+        };
+      };
+      lastError: ConvexTextBuilderInitial<""> & {
         _: {
           tableName: "aggregate_state";
         };
       } & {
         _: {
-          fieldName: "metricDefinitionHash";
+          fieldName: "lastError";
         };
       };
-      processed: ConvexNumberBuilderInitial<""> & {
+      indexName: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1680,10 +1685,10 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "processed";
+          fieldName: "indexName";
         };
       };
-      startedAt: ConvexNumberBuilderInitial<""> & {
+      keyDefinitionHash: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1693,25 +1698,20 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "startedAt";
+          fieldName: "keyDefinitionHash";
         };
       };
-      completedAt: ConvexNumberBuilderInitial<""> & {
+      metricDefinitionHash: ConvexTextBuilderInitial<""> & {
         _: {
-          tableName: "aggregate_state";
+          notNull: true;
         };
       } & {
-        _: {
-          fieldName: "completedAt";
-        };
-      };
-      lastError: ConvexTextBuilderInitial<""> & {
         _: {
           tableName: "aggregate_state";
         };
       } & {
         _: {
-          fieldName: "lastError";
+          fieldName: "metricDefinitionHash";
         };
       };
       tableKey: ConvexTextBuilderInitial<""> & {
@@ -1782,7 +1782,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
           fieldName: "updatedAt";
         };
       };
-      processed: ConvexNumberBuilderInitial<""> & {
+      migrationId: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1792,37 +1792,45 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "processed";
+          fieldName: "migrationId";
         };
       };
-      startedAt: ConvexNumberBuilderInitial<""> & {
+      checksum: ConvexTextBuilderInitial<""> & {
+        _: {
+          notNull: true;
+        };
+      } & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "startedAt";
+          fieldName: "checksum";
         };
       };
-      completedAt: ConvexNumberBuilderInitial<""> & {
+      applied: ConvexBooleanBuilderInitial<""> & {
+        _: {
+          notNull: true;
+        };
+      } & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "completedAt";
+          fieldName: "applied";
         };
       };
-      lastError: ConvexTextBuilderInitial<""> & {
+      runId: ConvexTextBuilderInitial<""> & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "lastError";
+          fieldName: "runId";
         };
       };
-      migrationId: ConvexTextBuilderInitial<""> & {
+      processed: ConvexNumberBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1832,42 +1840,34 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "migrationId";
+          fieldName: "processed";
         };
       };
-      checksum: ConvexTextBuilderInitial<""> & {
-        _: {
-          notNull: true;
-        };
-      } & {
+      startedAt: ConvexNumberBuilderInitial<""> & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "checksum";
+          fieldName: "startedAt";
         };
       };
-      applied: ConvexBooleanBuilderInitial<""> & {
-        _: {
-          notNull: true;
-        };
-      } & {
+      completedAt: ConvexNumberBuilderInitial<""> & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "applied";
+          fieldName: "completedAt";
         };
       };
-      runId: ConvexTextBuilderInitial<""> & {
+      lastError: ConvexTextBuilderInitial<""> & {
         _: {
           tableName: "migration_state";
         };
       } & {
         _: {
-          fieldName: "runId";
+          fieldName: "lastError";
         };
       };
       writeMode: ConvexTextBuilderInitial<""> & {
@@ -1931,7 +1931,7 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
           fieldName: "updatedAt";
         };
       };
-      startedAt: ConvexNumberBuilderInitial<""> & {
+      runId: ConvexTextBuilderInitial<""> & {
         _: {
           notNull: true;
         };
@@ -1941,38 +1941,38 @@ declare const BUILTIN_SCHEMA_EXTENSIONS: readonly [SchemaExtension<{
         };
       } & {
         _: {
-          fieldName: "startedAt";
+          fieldName: "runId";
         };
       };
-      completedAt: ConvexNumberBuilderInitial<""> & {
+      startedAt: ConvexNumberBuilderInitial<""> & {
+        _: {
+          notNull: true;
+        };
+      } & {
         _: {
           tableName: "migration_run";
         };
       } & {
         _: {
-          fieldName: "completedAt";
+          fieldName: "startedAt";
         };
       };
-      lastError: ConvexTextBuilderInitial<""> & {
+      completedAt: ConvexNumberBuilderInitial<""> & {
         _: {
           tableName: "migration_run";
         };
       } & {
         _: {
-          fieldName: "lastError";
+          fieldName: "completedAt";
         };
       };
-      runId: ConvexTextBuilderInitial<""> & {
-        _: {
-          notNull: true;
-        };
-      } & {
+      lastError: ConvexTextBuilderInitial<""> & {
         _: {
           tableName: "migration_run";
         };
       } & {
         _: {
-          fieldName: "runId";
+          fieldName: "lastError";
         };
       };
       dryRun: ConvexBooleanBuilderInitial<""> & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitcn",
-  "version": "0.33.0",
+  "version": "0.33.2",
   "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.
 
 ---