Cursor rule

1---
2description: oRPC and React Query for Rust ↔ TypeScript IPC in the native app
3globs: apps/native/**/*.ts,apps/native/**/*.tsx,apps/native/src-tauri/**/*.rs
4alwaysApply: false
5---
6 
7# Rust ↔ TypeScript IPC — use oRPC
8 
9All new Rust ↔ TypeScript communication must go through **oRPC** (fully typed end-to-end).
10 
11## Codegen (required after router changes)
12 
13```bash
14cd apps/native && bun run gen:orpc
15```
16 
17- Rust procedures: `apps/native/src-tauri/src/orpc/`
18- Generated TS bindings: `apps/native/src/ipc/orpc-bindings.ts` (do not edit)
19- Client + TanStack Query helpers: `apps/native/src/lib/orpc.ts`
20 
21## Prefer React Query over `invoke()`
22 
23oRPC integrates with **TanStack Query** via `orpc` helpers. This is the default for data that is fetched, cached, polled, or invalidated.
24 
25```tsx
26// ✅ GOOD — cached, deduplicated, lifecycle-aware
27import { useQuery } from "@tanstack/react-query";
28import { orpc } from "@/lib/orpc";
29 
30const { data } = useQuery(orpc.github.listRepos.queryOptions({ input: undefined }));
31```
32 
33```ts
34// ❌ BAD — new feature wired through legacy invoke()
35import { invoke } from "@tauri-apps/api/core";
36await invoke("some_new_command");
37```
38 
39- **`client`** — direct async calls for one-off/imperative flows (no cache needed).
40- **`orpc` + hooks** — anything that should behave like server state in React.
41 
42Do **not** add new Zustand stores for global fetchable data — React Query is the cache. Even global async state belongs in query cache, not a hand-rolled store.
43 
44Legacy `invoke()` in `apps/native/src/ipc/api.ts` is deprecated; migrate callers to oRPC when touching them.
45