rest-to-graphql
Convert REST API routes to a GraphQL schema. Use when migrating APIs or adding a GraphQL layer.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Convert REST API routes to a GraphQL schema. Use when migrating APIs or adding a GraphQL layer.
How to use
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.