customerio-local-dev-loop

Umożliwia bezpieczne testowanie integracji Customer.io na lokalnej maszynie. Skill automatyzuje konfigurację oddzielonych środowisk (development, test, production), ustawia zmienne środowiskowe, tworzy klienta w trybie dry-run oraz dodaje prefiksy do zdarzeń testowych. Dzięki temu Twoje eksperymenty nigdy nie wpłyną na rzeczywiste dane użytkowników. Idealne dla zespołów pracujących z Customer.io SDK dla Node.js.

1. Zainstaluj skill w swoim projekcie Claude Code lub Codex. Upewnij się, że masz zainstalowany pakiet customerio-node oraz dotenv do zarządzania zmiennymi środowiskowymi.

2. Utwórz plik .env.development w głównym katalogu projektu i dodaj zmienne dla środowiska deweloperskiego: CUSTOMERIO_SITE_ID, CUSTOMERIO_TRACK_API_KEY, CUSTOMERIO_APP_API_KEY, CUSTOMERIO_REGION (us lub eu), CUSTOMERIO_DRY_RUN=false oraz CUSTOMERIO_EVENT_PREFIX=dev_. Wartości site_id i kluczy API pobierz z oddzielnego workspace'u Customer.io przeznaczonego do testowania.

3. Stwórz analogiczny plik .env.test dla testów jednostkowych, gdzie CUSTOMERIO_DRY_RUN=true (aby żadne żądania nie trafiały do API) i CUSTOMERIO_EVENT_PREFIX=test_. Pozostałe zmienne mogą zawierać wartości placeholder.

4. Wygeneruj plik lib/customerio-dev.ts (lub równoważny) zawierający funkcję loadConfig(), która odczytuje zmienne środowiskowe i zwraca obiekt konfiguracyjny. Funkcja powinna obsługiwać oba regiony (US i EU) oraz tryb dry-run.

5. W swoim kodzie aplikacji importuj klienta Customer.io z pliku konfiguracyjnego zamiast tworzyć go na sztywno. Dzięki temu automatycznie będzie używać właściwych ustawień w zależności od aktualnego środowiska.

6. Uruchom testy lub lokalny serwer deweloperski — wszystkie zdarzenia będą prefixowane (np. dev_ lub test_) i nie będą mieszać się z danymi produkcyjnymi.