kitcn 0.15.2 → 0.15.5

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

@@ -113,37 +113,32 @@ function QueryProvider({ children }) {
 **With auth** — swap `ConvexProvider` for `ConvexAuthProvider`:
 ```tsx
 import { ConvexAuthProvider } from 'kitcn/auth/client';
-import { ConvexReactClient, getConvexQueryClientSingleton, getQueryClientSingleton, useAuthStore } from 'kitcn/react';
+import { ConvexReactClient, getConvexQueryClientSingleton, getQueryClientSingleton } from 'kitcn/react';
 
 const convex = new ConvexReactClient(process.env.NEXT_PUBLIC_CONVEX_URL!);
 
 export function AppConvexProvider({ children, token }: { children: ReactNode; token?: string }) {
   const router = useRouter();
+  const queryClient = getQueryClientSingleton(createQueryClient);
+  const convexQueryClient = getConvexQueryClientSingleton({ convex, queryClient });
+
   return (
     <ConvexAuthProvider
       authClient={authClient}
       client={convex}
+      convexQueryClient={convexQueryClient}
       initialToken={token}
       onMutationUnauthorized={() => router.push('/login')}
       onQueryUnauthorized={() => router.push('/login')}
     >
-      <QueryProvider>{children}</QueryProvider>
+      <QueryClientProvider client={queryClient}>
+        <CRPCProvider convexClient={convex} convexQueryClient={convexQueryClient}>
+          {children}
+        </CRPCProvider>
+      </QueryClientProvider>
     </ConvexAuthProvider>
   );
 }
-
-function QueryProvider({ children }) {
-  const authStore = useAuthStore(); // pass to singleton
-  const queryClient = getQueryClientSingleton(createQueryClient);
-  const convexQueryClient = getConvexQueryClientSingleton({ authStore, convex, queryClient });
-  return (
-    <QueryClientProvider client={queryClient}>
-      <CRPCProvider convexClient={convex} convexQueryClient={convexQueryClient}>
-        {children}
-      </CRPCProvider>
-    </QueryClientProvider>
-  );
-}
 ```
 
 ### Singleton Helpers
@@ -156,7 +151,7 @@ function QueryProvider({ children }) {
 `getConvexQueryClientSingleton` options:
 - `convex` — ConvexReactClient
 - `queryClient` — TanStack QueryClient
-- `authStore` — from `useAuthStore()` (auth apps only)
+- `authStore` — optional manual auth-store bridge
 - `unsubscribeDelay` — ms before unsubscribing after unmount (default 3000). Covers StrictMode + quick back-nav.
 
 ### ConvexQueryClient (Bridge)

package/skills/kitcn/references/setup/index.md

@@ -799,7 +799,7 @@ This runbook + references map to the canonical template shape as follows:
 | `Property 'insert'/'update' does not exist on type 'OrmReader'`                       | Using query context for mutations                                                               | Ensure mutation handlers use `publicMutation` / `protectedMutation` builders                                                                                                                |
 | `useCRPC must be used within CRPCProvider`                                            | Provider chain not mounted around route tree                                                    | Wrap app with `AppConvexProvider` and verify `CRPCProvider` is inside QueryClientProvider (Section 7.4 / 8.A.4)                                                                          |
 | Route auth cookies not set                                                            | Missing CORS auth headers                                                                       | Add `Better-Auth-Cookie` allow/expose headers + credentials                                                                                                                                 |
-| TanStack Start auth helper import errors                                              | Using `kitcn/auth/nextjs` in Start app                                                  | Use the TanStack Start helper from `kitcn/auth/start`                                                                                                                                        |
+| TanStack Start auth helper import errors                                              | Using `kitcn/auth/nextjs` in Start app                                                  | Use the shared Start loader helper from `kitcn/auth/start` and the server adapter from `kitcn/auth/start/server`                                                                             |
 | `Returned promise will never resolve` from internal function                          | Trigger path is recursively querying/updating related rows or stale component wiring still runs | Isolate failing write with logs, disable/move trigger-side sync into explicit mutation helper, rerun `bunx kitcn verify`, then retry the runtime proof                            |
 | Better Auth secret mismatch/warnings in setup flows                                   | `BETTER_AUTH_SECRET` manually set inconsistently or low entropy                                 | Let `bunx kitcn dev` manage local bootstrap, or regenerate/push via `bunx kitcn env push` for active non-local targets                                                   |
 | `Invalid orderBy value. Use a column or asc()/desc()`                                 | Wrong `orderBy` shape (`[{ field, direction }]`)                                                | Use object form only, e.g. `orderBy: { updatedAt: "desc" }`                                                                                                                                 |

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

@@ -119,7 +119,6 @@ import {
   ConvexReactClient,
   getConvexQueryClientSingleton,
   getQueryClientSingleton,
-  useAuthStore,
 } from "kitcn/react";
 import type { ReactNode } from "react";
 
@@ -136,33 +135,25 @@ export function AppConvexProvider({
   children: ReactNode;
   token?: string;
 }) {
-  return (
-    <ConvexAuthProvider
-      authClient={authClient}
-      client={convex}
-      initialToken={token}
-    >
-      <QueryProvider>{children}</QueryProvider>
-    </ConvexAuthProvider>
-  );
-}
-
-function QueryProvider({ children }: { children: ReactNode }) {
-  const authStore = useAuthStore();
-
   const queryClient = getQueryClientSingleton(createQueryClient);
   const convexQueryClient = getConvexQueryClientSingleton({
-    authStore,
     convex,
     queryClient,
   });
 
   return (
-    <TanstackQueryClientProvider client={queryClient}>
-      <CRPCProvider convexClient={convex} convexQueryClient={convexQueryClient}>
-        {children}
-      </CRPCProvider>
-    </TanstackQueryClientProvider>
+    <ConvexAuthProvider
+      authClient={authClient}
+      client={convex}
+      convexQueryClient={convexQueryClient}
+      initialToken={token}
+    >
+      <TanstackQueryClientProvider client={queryClient}>
+        <CRPCProvider convexClient={convex} convexQueryClient={convexQueryClient}>
+          {children}
+        </CRPCProvider>
+      </TanstackQueryClientProvider>
+    </ConvexAuthProvider>
   );
 }
 ```

package/skills/kitcn/references/setup/start.md

@@ -34,7 +34,7 @@ export const {
 **Create:** `src/lib/convex/auth-server.ts`
 
 ```ts
-import { convexBetterAuthReactStart } from "kitcn/auth/start";
+import { convexBetterAuthReactStart } from "kitcn/auth/start/server";
 
 export const {
   handler,