supabase-webhooks-events
Webhooks i zdarzenia bazy danych Supabase — weryfikacja podpisów i obsługa zdarzeń w czasie rzeczywistym
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do implementacji webhooków bazy danych Supabase z pełną obsługą zdarzeń INSERT, UPDATE i DELETE. Obsługuje cztery mechanizmy: Database Webhooks via pg_net, Edge Functions, Postgres LISTEN/NOTIFY oraz Realtime postgres_changes. Zawiera gotowy kod do weryfikacji podpisów, obsługi idempotencji i retry'ów. Użyj gdy konfigurujesz endpointy webhooków, wdrażasz walidację podpisów lub budujesz architekturę opartą na zdarzeniach.
Jak używać
Upewnij się, że masz zainstalowany Supabase CLI i dostęp do projektu Supabase (lokalnego lub hostowanego). Zainstaluj również @supabase/supabase-js w wersji 2 lub wyższej dla wzorców po stronie klienta.
Włącz rozszerzenie pg_net w panelu Supabase: przejdź do Dashboard > Database > Extensions, wyszukaj "pg_net" i kliknij Enable.
Utwórz funkcję trigger w bazie danych, która będzie wysyłać żądania HTTP przy zmianach w tabelach. Skill zawiera gotowe szablony dla webhooków opartych na pg_net — dostosuj je do swoich tabel i zdarzeń (INSERT, UPDATE, DELETE).
Wdróż Edge Function, która będzie odbierać webhook'i. Skill zawiera przykłady z weryfikacją podpisu — upewnij się, że funkcja waliduje nagłówek X-Signature-256 przed przetworzeniem zdarzenia.
Dla wzorców Realtime postgres_changes: użyj klienta Supabase do subskrybowania zmian w wybranej tabeli. Skill pokazuje, jak nasłuchiwać zdarzeń INSERT, UPDATE i DELETE bezpośrednio z aplikacji klienckiej.
Przetestuj przepływ: wyzwól zmianę w bazie (np. INSERT), sprawdź logi Edge Function i zweryfikuj, że webhook dotarł z prawidłowym podpisem i idempotencją.