query-layer

Umożliwia budowanie warstwy zapytań między komponentami UI a serwisami. Zarządzaj pobieraniem danych, cachowaniem i stanem reaktywnym za pomocą TanStack Query. Transformuj błędy z serwisu na komunikaty dla użytkownika, wdrażaj optymistyczne aktualizacje cache'a i obsługuj dynamiczny wybór serwisu w runtime. Idealne do tworzenia zapytań i mutacji z pełną kontrolą nad stanem asynchronicznym.

1. Zainstaluj umiejętność query-layer w swoim projekcie, upewniając się, że masz dostęp do TanStack Query i warstwy serwisów (services-layer).
2. Utwórz funkcję zapytania, która opakowuje czystą funkcję serwisu — funkcja powinna przyjmować konfigurację i ustawienia użytkownika jako parametry wstrzykiwane w runtime.
3. 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.
4. Skonfiguruj TanStack Query do zarządzania cache'em zapytania — ustaw klucze cache'a, strategie odświeżania i czasy wygaśnięcia danych.
5. Implementuj dual interface: reaktywny interfejs (.options) dla komponentów obserwujących zmiany stanu oraz imperatywny interfejs (.execute()) dla ręcznego wyzwolenia zapytania.
6. Dodaj optymistyczne aktualizacje cache'a dla mutacji, aby UI natychmiast odzwierciedlało zmiany przed potwierdzeniem serwera.