clay-ci-integration

Skill do konfiguracji pipelinów CI/CD dla aplikacji opartych na Clay. Pozwala ci ustawić automatyczne testy dla webhook'ów Clay, walidować jakość danych transformacji oraz sprawdzać zgodność schematu danych wzbogaconych. Obsługuje testowanie jednostkowe z mockami oraz opcjonalne testy integracyjne z API Clay. Integruje się z GitHub Actions i wspiera projekty Node.js oraz Python z dowolnym frameworkiem testowym.

1. Przygotuj repozytorium GitHub z włączonymi Actions. Dodaj do sekretu GitHub zmienną CLAY_WEBHOOK_URL zawierającą adres webhook'a Clay oraz CLAY_API_KEY dla testów integracyjnych.

2. Utwórz plik workflow w katalogu .github/workflows/clay-integration.yml. Workflow powinien uruchamiać się na push do gałęzi main oraz na pull requestach. Skonfiguruj zmienne środowiskowe CLAY_WEBHOOK_URL i CLAY_API_KEY z GitHub secrets.

3. W sekcji unit-tests workflow'u checkout'uj kod, zainstaluj Node.js w wersji 20 (lub wymaganą przez projekt), uruchom npm ci do zainstalowania zależności, a następnie npm test z flagą --coverage. Dla testów jednostkowych użyj mock'ów zamiast rzeczywistych poświadczeń Clay.

4. Dodaj sekcję data-validation do workflow'u, która będzie walidować schemat danych transformacji i sprawdzać zgodność wzbogaconych danych z oczekiwanym formatem.

5. Opcjonalnie skonfiguruj testy integracyjne, które będą wysyłać żądania do API Clay. Te testy powinny uruchamiać się tylko na żądanie lub w określonych gałęziach, aby uniknąć zbędnych kosztów.

6. Zacommituj plik workflow'u do repozytorium. GitHub Actions automatycznie uruchomi testy na każdy push i pull request do gałęzi main. Monitoruj wyniki w zakładce Actions na GitHub.