apollo-local-dev-loop

Skill do szybkiego uruchomienia lokalnego workflow'u dla integracji Apollo.io. Zawiera obsługę sandbox API key'a do testowania bez zużywania kredytów, mock server do pracy offline, logowanie requestów oraz gotowe npm skrypty. Idealne do konfiguracji środowiska deweloperskiego, testowania API lokalnie i ustalania praktyk zespołowych. Wymaga wcześniejszego ukończenia setup'u autoryzacji Apollo.

1. Upewnij się, że masz ukończony setup autoryzacji Apollo (apollo-install-auth) oraz Node.js 18 lub nowszy. Zainicjuj repozytorium Git, jeśli jeszcze tego nie zrobiłeś.

2. Wygeneruj sandbox token w panelu Apollo: przejdź do Settings > Integrations > API Keys > Sandbox i skopiuj klucz testowy, który zwraca fikcyjne dane bez zużywania kredytów.

3. Utwórz plik .env.example w głównym katalogu projektu z trzema zmiennymi: APOLLO_API_KEY (Twój produkcyjny klucz), APOLLO_SANDBOX_KEY (klucz sandbox) i APOLLO_USE_SANDBOX (ustaw na false dla produkcji, true dla testów). Skopiuj ten plik jako .env i dodaj .env oraz .env.local do .gitignore, aby chronić wrażliwe dane.

4. Utwórz plik src/apollo/dev-client.ts, który inicjalizuje klienta Axios z automatycznym wyborem klucza na podstawie zmiennej APOLLO_USE_SANDBOX. Dodaj nagłówki Content-Type i x-api-key oraz timeout 30 sekund. Skonfiguruj logowanie wszystkich requestów, aby śledzić API calls podczas debugowania.

5. Trigger skill'a frazami takimi jak "apollo local dev", "apollo development setup", "apollo dev environment" lub "apollo testing locally", aby uruchomić automatyczną konfigurację.

6. Uruchom npm skrypty przygotowane przez skill do codziennego development'u i testowania API lokalnie, korzystając z mock server'a do pracy offline.