frontend-query-mutation
/frontend-query-mutation
Prowadzi wdrażanie wzorców zapytań i mutacji we froncie Langflow z Axios i TanStack React Query v5: hooki API, useQuery kontra useMutation, zapytania warunkowe, unieważnianie cache i obsługa błędów.
- Autor
- langflow-ai ↗
- Repozytorium
- langflow ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 22.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 3
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 22.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Prowadzi wdrażanie wzorców zapytań i mutacji we froncie Langflow z Axios i TanStack React Query v5: hooki API, useQuery kontra useMutation, zapytania warunkowe, unieważnianie cache i obsługa błędów.
Oryginalny opis (EN)
Guide for implementing Langflow frontend query and mutation patterns with Axios and TanStack React Query v5. Trigger when creating or updating API hooks in controllers/API/queries, consuming UseRequestProcessor in components, deciding whether to use useQuery or useMutation, handling conditional queries, cache invalidation, mutation error handling, or migrating legacy API calls to the query hook pattern.
Jak działa
- Intent
- Architecture Overview
- Workflow
- Files Commonly Touched
- References
Podgląd SKILL.md
---
name: frontend-query-mutation
description: Guide for implementing Langflow frontend query and mutation patterns with Axios and TanStack React Query v5. Trigger when creating or updating API hooks in controllers/API/queries, consuming UseRequestProcessor in components, deciding whether to use useQuery or useMutation, handling conditional queries, cache invalidation, mutation error handling, or migrating legacy API calls to the query hook pattern.
---
# Frontend Query & Mutation
## Intent
- Keep API hooks in `controllers/API/queries/{domain}/` as the organized source of truth.
- Use `UseRequestProcessor` for consistent retry, invalidation, and error handling.
- Use Axios `api` instance for all HTTP calls (never raw `fetch` for REST).
- Use `performStreamingRequest()` for streaming operations (build, chat).
- Keep cache invalidation in mutation `onSettled` callbacks.
## Architecture Overview
Langflow uses **Axios + TanStack React Query v5** for data fetching. There is no oRPC or contract layer. The architecture is:
```
Component
-> API hook (controllers/API/queries/{domain}/use-{verb}-{resource}.ts)
-> UseRequestProcessor (controllers/API/services/request-processor.ts)
-> useQuery / useMutation (TanStack React Query)
-> queryFn / mutationFn
-> api.get/post/patch/delete (Axios instance from controllers/API/api.tsx)
```
### Key Files
| File | Purpose |
|------|---------|
| `controllers/API/api.tsx` | Axios instance, `ApiInterceptor` component, `performStreamingRequest()` |
| `controllers/API/services/request-processor.ts` | `UseRequestProcessor` hook wrapping `useQuery`/`useMutation` with retry defaults |
| `controllers/API/helpers/constants.ts` | URL constants (`URLs`) and `getURL()` helper |
| `controllers/API/queries/{domain}/` | Domain-organized query and mutation hooks |
| `types/api/index.ts` | `useQueryFunctionType`, `useMutationFunctionType` type helpers |
| `stores/` | Zustand stores for client-side state |
## Workflow
1. Identify the change surface.
- Read `references/query-patterns.md` for hook structure, naming, URL patterns, and query/mutation call-site shape.
- Read `references/runtime-rules.md` for conditional queries, invalidation, error handling, and streaming.
- Read both references when a task spans hook creation and runtime behavior.
2. Implement the hook following existing patterns.
- Use `UseRequestProcessor` for `query()` and `mutate()` wrappers.
- Use the `api` Axios instance for all HTTP calls.
- Use `getURL()` for constructing API paths.
- Type the hook with `useQueryFunctionType` or `useMutationFunctionType`.
3. Preserve Langflow conventions.
- Query keys are arrays with the hook name: `["useGetFlows"]`.
- Mutations invalidate related queries in `onSettled`.
- Zustand store updates happen in the query/mutation function, not in components.
- `UseRequestProcessor` provides default retry (5 for queries, 3 for mutations) with exponential backoff.
## Files Commonly Touched
- `controllers/API/queries/{domain}/use-get-*.ts` (query hooks)
- `controllers/API/queries/{domain}/use-post-*.ts` (create mutations)
- `controllers/API/queries/{domain}/use-patch-*.ts` (update mutations)
- `controllers/API/queries/{domain}/use-delete-*.ts` (delete mutations)
- `controllers/API/helpers/constants.ts` (URL constants)
- `types/api/index.ts` (API type definitions)
- `stores/` (Zustand store updates triggered by queries)
## References
- Use `references/query-patterns.md` for hook structure, naming conventions, directory layout, and anti-patterns.
- Use `references/runtime-rules.md` for conditional queries, invalidation, `mutate` versus `mutateAsync`, error handling, and streaming requests.
Treat this skill as the single query and mutation entry point for Langflow frontend work. Keep detailed rules in the reference files instead of duplicating them in project docs.
Pliki w paczce (3)
- SKILL.md 4 KB
- references/query-patterns.md 13 KB
- references/runtime-rules.md 12 KB
Wersje
W bazie nie ma innych skilli o nazwie frontend-query-mutation.
Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki f22771175063 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100frontend-data-fetching
Opisuje pobieranie danych w frontendzie Sentry przez TanStack Query i apiOptions, w tym useQuery, useMutation, paginację z nagłówków i warunkowe zapytania. - 100react-query-best-practices
Podpowiada, jak używać React Query v4 (TanStack Query): zapytania, mutacje, unieważnianie cache, WebSocket i rozwiązywanie problemów. - 100tanstack-query
Optymalizuje wydajność TanStack Query v5 dla pobierania danych, cache, mutacji i wzorców zapytań: useQuery, useMutation, queryClient i prefetch. - 90TanStack Errors
Doradza w obsłudze błędów w TanStack Query: error boundaries z useQuery, throwOnError, globalne callbacki onError, stan błędu zapytań i obsługę błędów mutacji. - 100tanstack-query-zustand
Wskazuje wzorce dla stanu serwera w TanStack Query i Axios oraz stanu interfejsu w Zustand w aplikacji React SPA. - 100pinia-colada
Obsługuje pobieranie danych w Vue i Nuxt przez Pinia Colada: useQuery, useMutation, stan asynchroniczny, cache zapytań, SSR, unieważnianie i migracja z TanStack Vue Query.