convex-functions

Skill nauczy Cię pisać zapytania, mutacje, akcje i endpointy HTTP w Convex z prawidłową walidacją argumentów, obsługą błędów i uwzględnieniem ograniczeń runtime. Dowiesz się, kiedy użyć każdego typu funkcji — zapytania do odczytu danych z cachingiem reaktywnym, mutacje do modyfikacji, akcje do integracji z zewnętrznymi API oraz HTTP actions do webhooków. Wszystkie przykłady kodu zgodne z regułami eslint-plugin Convex.

1. Zainstaluj skill convex-functions w swoim projekcie Convex. Upewnij się, że masz dostęp do dokumentacji na https://docs.convex.dev/functions oraz zapoznaj się z sekcją Code Quality dotyczącą konfiguracji lintingu. 2. Zapoznaj się z tabelą typów funkcji — wybierz odpowiedni typ na podstawie Twoich potrzeb: Query dla odczytu danych z cachingiem, Mutation dla modyfikacji danych, Action dla integracji z zewnętrznymi API, HTTP Action dla webhooków i API. 3. Napisz swoją pierwszą funkcję Query, stosując składnię z właściwością handler, dodając validator dla argumentów oraz jawnie określając nazwy tabel w operacjach bazodanowych. 4. Przejdź do funkcji Mutation, jeśli potrzebujesz modyfikować dane — pamiętaj, że mutacje nie są cachowane i wymagają pełnego dostępu do bazy danych. 5. Dla integracji z zewnętrznymi serwisami użyj Actions, które mogą wywoływać runQuery i runMutation oraz mają dostęp do API. 6. Sprawdź dokumentację specificzną dla każdego typu funkcji na docs.convex.dev, aby zrozumieć ograniczenia runtime i best practices dotyczące obsługi błędów.