Q
query-layer
Query layer patterns for consuming services with TanStack Query, error transformation, and runtime dependency injection. Use when implementing queries/mutations, transforming service errors for UI, or adding reactive data management.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Query layer patterns for consuming services with TanStack Query, error transformation, and runtime dependency injection. Use when implementing queries/mutations, transforming service errors for UI, or adding reactive data management.
How to use
- Zainstaluj umiejętność query-layer w swoim projekcie, upewniając się, że masz dostęp do TanStack Query i warstwy serwisów (services-layer).
- Utwórz funkcję zapytania, która opakowuje czystą funkcję serwisu — funkcja powinna przyjmować konfigurację i ustawienia użytkownika jako parametry wstrzykiwane w runtime.
- Zdefiniuj transformację błędów, mapując wyjątki z serwisu na typy błędów przyjazne dla interfejsu użytkownika; błędy powinny być gotowe do wyświetlenia w komponentach.
- Skonfiguruj TanStack Query do zarządzania cache'em zapytania — ustaw klucze cache'a, strategie odświeżania i czasy wygaśnięcia danych.
- Implementuj dual interface: reaktywny interfejs (
.options) dla komponentów obserwujących zmiany stanu oraz imperatywny interfejs (.execute()) dla ręcznego wyzwolenia zapytania. - Dodaj optymistyczne aktualizacje cache'a dla mutacji, aby UI natychmiast odzwierciedlało zmiany przed potwierdzeniem serwera.