TypeScript Academy · Lekcja

Bezpieczeństwo typów od końca do końca: schemat jako źródło

Utrzymuj jedno źródło prawdy od schematu po klienta.

Bezpieczeństwo typów od końca do końca: schemat jako źródło to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej TypeScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs TypeScript Academy zawiera 4 lekcji w sumie.

Czym jest podejście schema-first

Podejście schema-first oznacza, że schemat GraphQL jest jednym źródłem prawdy. Typy frontendu, resolvery backendu i kontrakty API są z niego wyprowadzane, co zapobiega rozjechaniu się poszczególnych warstw.

# The workflow:
# 1. Define schema (.graphql or SDL)
# 2. Generate server resolver types
# 3. Generate client operation types
# 4. Both sides automatically stay in sync

Definiowanie schematu

Zapisz schemat GraphQL w SDL (plikach .graphql) i zatwierdź go w repozytorium jako kontrakt między klientem a serwerem.

# schema.graphql
type User {
  id: ID!
  name: String!
  email: String!
}

type Query {
  user(id: ID!): User
}

Serwer: generowanie typów resolverów

Uruchom codegen z wtyczką typescript-resolvers, aby wygenerować typowane sygnatury resolverów na podstawie schematu.

# Server codegen step
npx graphql-codegen --config codegen.server.yml

Klient: generowanie typów operacji

Uruchom codegen z wtyczkami typescript-operations oraz Apollo/urql, aby wygenerować typowane hooki na podstawie plików operacji .graphql.

# Client codegen step
npx graphql-codegen --config codegen.client.yml

Wykrywanie zmian łamiących zgodność

Użyj graphql-inspector, aby wykrywać łamiące zmiany schematu (usuwanie pól, zmiany typów), zanim trafią one na produkcję.

npx graphql-inspector diff ./api/schema.graphql ./api/schema.new.graphql
# Reports: BREAKING: Field 'User.email' was removed

Rejestr schematu

Rejestr schematu (Apollo Studio, Hive) przechowuje wersje schematu, śledzi zmiany w czasie i zgłasza łamiące zmiany w CI.

# Push schema to Apollo Studio:
npx apollo schema:push --endpoint https://api.example.com/graphql

Tworzenie mocków na podstawie schematu

Użyj schematu do wygenerowania danych mockowych na potrzeby pracy nad klientem bez prawdziwego serwera, zachowując zgodność mocków ze schematem.

import { buildClientSchema, introspectionFromSchema } from "graphql";
import { addMocksToSchema } from "@graphql-tools/mock";
const schema = buildClientSchema(introspectionResult);
const mockedSchema = addMocksToSchema({ schema });

tRPC jako alternatywa

W projektach korzystających wyłącznie z TypeScript tRPC zapewnia bezpieczeństwo typów od końca do końca bez języka schematu — typ routera serwera JEST kontraktem klienta.

// Server: router infers types
const router = t.router({ getUser: t.procedure.query(() => fetchUser()) });
// Client: types flow automatically via inference
const { data } = trpc.getUser.useQuery();

Zod + tRPC do walidacji

Połącz schematy Zod z walidatorami danych wejściowych tRPC, aby uzyskać walidację w czasie wykonywania i typy w czasie kompilacji na podstawie jednej definicji.

const createUser = t.procedure
  .input(z.object({ name: z.string(), email: z.string().email() }))
  .mutation(({ input }) => saveUser(input));
// input: { name: string; email: string } — from Zod schema

CI: pełny potok bezpieczeństwa schematu

Kompletny potok CI dla bezpieczeństwa podejścia schema-first: sprawdź schemat → wykryj łamiące zmiany → uruchom codegen → sprawdź typy → uruchom testy.

# .github/workflows/schema.yml
- run: npx graphql-inspector validate ...
- run: npx graphql-codegen --check
- run: npx tsc --noEmit
- run: npm test

Podsumowanie: przepływ schema-first

TypeScript w podejściu schema-first: zdefiniuj SDL → wygeneruj typy resolverów serwera → wygeneruj typy operacji klienta → wykrywaj łamiące zmiany w CI. Schemat jest jednym źródłem prawdy dla wszystkich warstw bezpieczeństwa typów.

Szybkie sprawdzenie

Jaką rolę pełni schemat GraphQL w przepływie schema-first?

Czego się Państwo nauczyli

Przepływy TypeScript w podejściu schema-first wyprowadzają wszystkie typy ze schematu GraphQL. Należy generować typy resolverów dla serwera i typy operacji dla klienta, wykrywać łamiące zmiany w CI oraz utrzymywać schemat jako kontrakt między wszystkimi warstwami.

Często zadawane pytania

Czy lekcja „Bezpieczeństwo typów od końca do końca: schemat jako źródło” jest bezpłatna?

Tak — pełny tekst „Bezpieczeństwo typów od końca do końca: schemat jako źródło” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu TypeScript Academy, przejdź na CoddyKit PRO. Kurs TypeScript Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Bezpieczeństwo typów od końca do końca: schemat jako źródło”?

Utrzymuj jedno źródło prawdy od schematu po klienta. Ćwiczysz TypeScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć TypeScript Academy?

Nie wymagamy żadnego doświadczenia. TypeScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Bezpieczeństwo typów od końca do końca: schemat jako źródło”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji TypeScript Academy?

Tak. Każda lekcja TypeScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

Schemat GraphQL na typy TypeScript
Typowane resolvery z GraphQL Code Generator
Typowany klient GraphQL z Apollo i urql
Bezpieczeństwo typów od końca do końca: schemat jako źródło

← Powrót do TypeScript Academy