lokalise-sdk-patterns

Skill Claude'a z produkcyjnymi wzorcami integracji Lokalise dla TypeScript i Node.js. Zawiera singleton klienta, paginację kursorową, obsługę błędów z typami, operacje wsadowe, monitorowanie przesyłania i retry z ograniczeniem częstotliwości. Użyj go podczas implementacji integracji Lokalise, refaktoryzacji kodu SDK lub ustalania standardów kodowania w zespole. Wyzwól frazami: "lokalise SDK patterns", "lokalise best practices" lub "idiomatic lokalise".

1. Upewnij się, że masz zainstalowany pakiet @lokalise/node-api w wersji 12 lub wyższej oraz TypeScript 5+ z włączonym trybem strict. Skill wymaga tych zależności do działania.

2. Utwórz singleton klienta Lokalise w pliku src/lib/lokalise-client.ts. Funkcja getClient() centralizuje konfigurację, obsługuje zmienną środowiskową LOKALISE_API_TOKEN i wspiera gałęzie projektów poprzez składnię "projectId:branchName". Możesz przekazać klucz API jako argument lub polegać na zmiennej środowiskowej.

3. Zbuduj helper paginacji kursorowej w pliku src/lib/paginate.ts. Wzorzec obsługuje dowolny endpoint z paginacją, umożliwiając iterację po dużych zbiorach danych bez ładowania wszystkiego do pamięci naraz.

4. Wdrożyć obsługę błędów z typami TypeScript. Skill zawiera wzorce do bezpiecznego przechwytywania i obsługi wyjątków specyficznych dla Lokalise API, zapewniając, że Twoja aplikacja nie ulegnie awarii na nieoczekiwanych odpowiedziach.

5. Użyj wzorców operacji wsadowych do przesyłania wielu zasobów jednocześnie. Skill dokumentuje, jak monitorować postęp przesyłania i implementować retry z ograniczeniem częstotliwości, aby uniknąć przekroczenia limitów API.

6. Wyzwól skill w Claude'a, wpisując jedną z sugerowanych fraz: "lokalise SDK patterns", "lokalise best practices", "lokalise code patterns" lub "idiomatic lokalise". Claude dostarczy konkretne przykłady kodu dopasowane do Twojego przypadku użycia.