Toolverse
All skills

query-layer

by EpicenterHQ

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

Quick info

Category
Security
Views
1

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

  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.

Related skills