@beignet/react-query 0.0.20 → 0.0.22

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @beignet/react-query
 
+## 0.0.22
+
+## 0.0.21
+
+### Patch Changes
+
+- Ship TanStack Intent agent skills with Beignet packages and scaffold generated apps with Intent skill-loading guidance.
+
 ## 0.0.20
 
 ## 0.0.19

package/README.md

@@ -19,6 +19,13 @@ npm install @beignet/react-query @beignet/core @tanstack/react-query react
 
 This package requires TypeScript 5.0 or higher for proper type inference.
 
+## Agent skills
+
+This package ships a TanStack Intent skill for coding agents:
+`@beignet/react-query#client`. Load it when adding typed client setup, React
+Query options, feature client helpers, hooks, cache invalidation, server
+prefetching, or client/server boundary fixes in a Beignet app.
+
 ## Setup
 
 ### 1. Create your app client helpers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beignet/react-query",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "type": "module",
   "description": "TanStack Query integration for Beignet",
   "main": "./dist/index.js",
@@ -17,6 +17,7 @@
     "!src/**/*.test.ts",
     "!src/**/*.test.tsx",
     "!src/**/*.test-d.ts",
+    "skills",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -34,7 +35,8 @@
     "api",
     "typescript",
     "react-query",
-    "tanstack"
+    "tanstack",
+    "tanstack-intent"
   ],
   "license": "MIT",
   "repository": {

package/skills/client/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: client
+description: "Build Beignet browser client and TanStack Query integration with @beignet/react-query: createClient, createReactQuery, queryOptions, mutationOptions, cache keys, feature client helpers, hooks, QueryClientProvider, server prefetching, and client/server boundary fixes. Use when adding or debugging React Query usage in a Beignet app."
+---
+
+# Beignet React Query Client
+
+Use this skill when working in a Beignet app that depends on
+`@beignet/react-query`. Read the app's root `client/` helpers and nearest
+feature client module before adding new helpers.
+
+## Shared Client Setup
+
+Root `client/` owns shared frontend adapter factories. In `src/` apps this is
+usually `src/client/`.
+
+```ts
+import { createClient } from "@beignet/core/client";
+import { createReactQuery } from "@beignet/react-query";
+import { QueryClient } from "@tanstack/react-query";
+
+export const apiClient = createClient({
+  baseUrl: "",
+  validateInput: true,
+});
+
+export const rq = createReactQuery(apiClient);
+
+export function makeQueryClient() {
+  return new QueryClient();
+}
+```
+
+Reuse the app's existing helper names and client options. Do not introduce a
+parallel Beignet client unless the app already has a multi-client convention.
+
+## Feature Client Helpers
+
+Feature-specific query options, mutations, and hooks may live under the
+feature. Prefer the canonical directory form for new apps:
+
+```txt
+features/todos/client/queries.ts
+```
+
+Existing apps may use:
+
+```txt
+features/todos/client.ts
+```
+
+Follow the existing style unless intentionally migrating. Do not mix both
+within one feature.
+
+```ts
+import { rq } from "@/client";
+import { createTodo, listTodos } from "@/features/todos/contracts";
+
+export const listTodosQuery = () =>
+  rq(listTodos).queryOptions({ query: { limit: 20 } });
+
+export const createTodoMutation = () =>
+  rq(createTodo).mutationOptions();
+```
+
+## Components
+
+Components and anything reachable from `"use client"` may import:
+
+- contracts
+- schemas
+- feature client helpers
+- root `client/` helpers
+- TanStack Query primitives
+- React Hook Form and UI helpers
+
+They must not import:
+
+- use cases
+- feature route groups
+- concrete infra adapters
+- provider packages
+- `server/`
+- `app-context.ts`
+- Node runtime modules
+
+Call server behavior through Beignet contracts and typed clients.
+
+## Query And Mutation Patterns
+
+- Use `queryOptions(...)` so options work with `useQuery`, `prefetchQuery`,
+  `fetchQuery`, and server prefetching.
+- Use `mutationOptions(...)` with `useMutation`.
+- Use `rq(contract).invalidate(queryClient)` or the app's existing key helper
+  after successful mutations.
+- If the app configures `createReactQuery(apiClient, { keyHeaders })`, preserve
+  that when adding helpers so tenant or header-scoped caches stay distinct.
+- Keep business validation in use cases. Client validation is for UX and early
+  feedback.
+
+## Common Fix
+
+If `beignet lint` says a client component reaches a use-case module:
+
+1. Move shared DTOs and validation to `features/<feature>/schemas.ts`.
+2. Remove imports from use cases, routes, infra, providers, or `server/`.
+3. Add a feature client helper that imports only contracts and root client
+   helpers.
+4. Update components to call the helper through TanStack Query.
+
+Then run:
+
+```bash
+beignet lint
+beignet doctor --strict
+bun run typecheck
+```