Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Narzędzie automatycznie konwertuje trasy REST API na kompletny schemat GraphQL z typami, zapytaniami i mutacjami. Analizuje Twoje endpointy, mapuje operacje CRUD na odpowiedniki GraphQL i generuje typy TypeScript. Idealne do migracji istniejących API, budowania warstwy BFF nad mikroserwisami lub dodania GraphQL bez porzucania REST. Działa bez konfiguracji — wystarczy wskazać katalog z rutami.
Jak używać
Zainstaluj narzędzie uruchamiając polecenie npx ai-rest-to-graphql wskazując ścieżkę do katalogu z trasami API, np. npx ai-rest-to-graphql ./src/routes. Narzędzie przeskanuje Twoje pliki i wygeneruje schemat GraphQL.
Przejrzyj wygenerowany schemat i typy TypeScript. Chociaż AI automatycznie mapuje pola i relacje, warto sprawdzić czy struktura odpowiada Twojemu modelowi danych i czy wszystkie powiązania między typami są prawidłowe.
Jeśli chcesz wygenerować gotowe implementacje resolverów, które będą wywoływać Twoje istniejące handlery REST, dodaj flagę --with-resolvers do polecenia.
Aby zapisać schemat do konkretnego pliku zamiast wyświetlać go na ekranie, użyj flagi -o z ścieżką docelową, np. npx ai-rest-to-graphql ./src/routes -o ./schema.graphql.
Jeśli wolisz owinąć REST API warstwą GraphQL zamiast go zastępować, użyj flagi --wrap-rest. To podejście pozwala na stopniową migrację bez porzucania istniejącego kodu.
Zamiast konwertować całe API naraz, zacznij od kluczowych zasobów. Możesz również wskazać konkretny plik, np. npx ai-rest-to-graphql ./src/routes/users.ts, aby przetestować proces na mniejszym zbiorze danych.