Kako graditi GraphQL API s NestJS-om?

Question

Accepted Answer

NestJS ima potporu za **GraphQL** na prvoj razini putem `@nestjs/graphql` (izgrađeno na Apollo Serveru). Nudi **code-first** pristup (definirajte vašu shemu TypeScript klasama i dekoratorima, shema se automatski genira) — idiomatski NestJS način — prilagođen model frame-a s dekoratorima/DI.

## Postavljanje GraphQL-a (code-first)

```ts
@Module({
  imports: [
    GraphQLModule.forRoot<ApolloDriverConfig>({
      driver: ApolloDriver,
      autoSchemaFile: "schema.gql",   // code-first: auto-generate the schema from classes
      playground: true,                // interactive query explorer in dev
    }),
  ],
})
export class AppModule {}
```

## Objektni tipovi (shema, definirana s dekoratorima)

```ts
@ObjectType()                        // a GraphQL type
export class User {
  @Field(() => ID) id: string;
  @Field() name: string;
  @Field() email: string;
  @Field(() => [Post]) posts: Post[];   // related type
}
```

U code-first pristupu, dekoriranim klasama (`@ObjectType`, `@Field`) definirajte shemu — TypeScript tipovi generiraju GraphQL shemu automatski, čuvajući ih usklađenima.

## Rezolveri (upiti i mutacije)

```ts
@Resolver(() => User)
export class UsersResolver {
  constructor(private usersService: UsersService) {}   // DI works as usual

@Query(() => [User])               // a query: returns a list of users
  users() {
    return this.usersService.findAll();
  }

@Query(() => User)
  user(@Args("id") id: string) {     // query with an argument
    return this.usersService.findOne(id);
  }

@Mutation(() => User)              // a mutation: creates a user
  createUser(@Args("input") input: CreateUserInput) {
    return this.usersService.create(input);
  }
}
```

Rezolveri (poput kontrolera, ali za GraphQL) definiraju `@Query` i `@Mutation` rukovalce, delegirajući servisima putem DI-ja — isti obrasci kao REST kontroleri.

## Rješavanje povezanih polja (izbjegavanje problema N+1)

```ts
@ResolveField(() => [Post])         // resolve User.posts on demand
posts(@Parent() user: User) {
  return this.postsService.findByUser(user.id);
}
// ⚠️ for lists, this can cause N+1 queries → use DataLoader to BATCH them
```

`@ResolveField` rješava povezana/ugniježđena polja lenjo — ali za liste, to rizikuje **problem N+1 upita**, riješen DataLoader групирањем.

## GraphQL u odnosu na REST kompromise

```text
GraphQL: clients request EXACTLY the fields they need (no over/under-fetching),
         one endpoint, strongly typed, great for complex/nested data & varied clients
REST:    simpler, better HTTP caching, well-understood — fine for straightforward APIs
→ Choose based on needs, not hype. NestJS supports both equally well.
```

## Zašto je važno

Prvostepena GraphQL podrška NestJS-a je vrijedna jer donosi GraphQL prednosti — klijenti preuzimaju točno podatke koje trebaju (eliminirajući over- i under-fetching), jednu jaku tipiziranu krajnju točku, i odličko rukovanje složenim/ugniježđenim podacima — u poznati, strukturirani NestJS model.

Razumijevanje je važno za gradnju modernih API-ja, posebno idiomatskog **code-first pristupa** (definiranje sheme TypeScript klasama i `@ObjectType`/`@Field`/`@Resolver` dekoratorima, s shemom koja se automatski genira i drži usklađenom) što prirodno odgovara NestJS arhitekturi s dekoratorima/DI — rezolveri raduju kao kontroleri, delegirajući injektiranim servisima.

Znanje kako definirati tipove, upite, mutacije, i razriješena polja, i svjesnost **problema N+1 upita** (i DataLoader-a kao rješenja) za ugniježđene podatke, ključno je znanje za seniore.

Jednako važno je razumijevanje **GraphQL u odnosu na REST kompromise** za odabir pravog pristupa za dati projekt (GraphQL za fleksibilne, složene, multi-klijentske potrebe podataka; REST za jednostavnije API-je s jakim HTTP cachingom).

GraphQL je major API paradigma, i čista integracija NestJS-a čini je bitnom, često relevantnom mogućnosti za gradnju fleksibilnih, efikasnih back-enda.