আপনি কীভাবে NestJS দিয়ে একটি GraphQL API তৈরি করেন?

Question

Accepted Answer

NestJS এর `@nestjs/graphql` এর মাধ্যমে প্রথম-শ্রেণীর **GraphQL** সাপোর্ট রয়েছে (Apollo Server এর উপর নির্মিত)। এটি একটি **code-first** অ্যাপ্রোচ অফার করে (TypeScript ক্লাস এবং ডেকোরেটর দিয়ে স্কিমা সংজ্ঞায়িত করুন, স্কিমা স্বয়ংক্রিয়ভাবে তৈরি হয়) — এটি NestJS এর স্বাভাবিক উপায় — ফ্রেমওয়ার্কের ডেকোরেটর/DI মডেলের সাথে মানানসই।

## GraphQL সেটআপ (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 {}
```

## Object types (স্কিমা, ডেকোরেটর দিয়ে সংজ্ঞায়িত)

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

Code-first এ, সজ্জিত ক্লাস (`@ObjectType`, `@Field`) স্কিমা সংজ্ঞায়িত করে — TypeScript টাইপ স্বয়ংক্রিয়ভাবে GraphQL স্কিমা তৈরি করে, সেগুলিকে সিঙ্ক রাখে।

## Resolvers (queries এবং mutations)

```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);
  }
}
```

Resolvers (REST কন্ট্রোলারের মতো, কিন্তু GraphQL এর জন্য) `@Query` এবং `@Mutation` হ্যান্ডলার সংজ্ঞায়িত করে, DI এর মাধ্যমে সেবায় ডেলিগেট করে — REST কন্ট্রোলারের মতো একই প্যাটার্ন।

## সম্পর্কিত ক্ষেত্র সমাধান করা (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` সম্পর্কিত/নেস্টেড ফিল্ড অলসভাবে সমাধান করে — কিন্তু তালিকার জন্য, এটি **N+1 কোয়েরি সমস্যা** এর ঝুঁকি রয়েছে, DataLoader ব্যাচিং দ্বারা সমাধান করা হয়।

## GraphQL বনাম REST ট্রেড-অফ

```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.
```

## এটি কেন গুরুত্বপূর্ণ

NestJS এর প্রথম-শ্রেণীর GraphQL সাপোর্ট মূল্যবান কারণ এটি GraphQL এর সুবিধা নিয়ে আসে — ক্লায়েন্টরা যে ডেটা প্রয়োজন তা সঠিকভাবে নিয়ে যায় (over- এবং under-fetching দূর করে), একটি একক strongly-typed এন্ডপয়েন্ট, এবং জটিল/নেস্টেড ডেটার চমৎকার হ্যান্ডলিং — NestJS এর পরিচিত, কাঠামোগত মডেলে।
\'এটি বোঝা আধুনিক APIs তৈরির জন্য গুরুত্বপূর্ণ, বিশেষত স্বাভাবিক **code-first অ্যাপ্রোচ** (TypeScript ক্লাস এবং `@ObjectType`/`@Field`/`@Resolver` ডেকোরেটর দিয়ে স্কিমা সংজ্ঞায়িত করা, স্কিমা স্বয়ংক্রিয়ভাবে তৈরি এবং সিঙ্ক রাখা হয়) যা NestJS এর ডেকোরেটর/DI আর্কিটেকচারের সাথে স্বাভাবিকভাবে ফিট করে — resolvers কন্ট্রোলারের মতো কাজ করে, ইনজেক্টেড সেবায় ডেলিগেট করে।

টাইপ, queries, mutations, এবং resolved ফিল্ড কীভাবে সংজ্ঞায়িত করতে হয় জেনে, এবং **N+1 কোয়েরি সমস্যা** (এবং সমাধান হিসেবে DataLoader) সম্পর্কে সচেতন থাকা নেস্টেড ডেটার জন্য সিনিয়র-লেভেল জ্ঞান।

সমানভাবে গুরুত্বপূর্ণ হল **GraphQL বনাম REST ট্রেড-অফ** বোঝা একটি প্রদত্ত প্রকল্পের জন্য সঠিক অ্যাপ্রোচ নির্বাচন করতে (flexible, জটিল, multi-client ডেটা চাহিদার জন্য GraphQL; সহজ APIs এর জন্য strong HTTP caching সহ REST)।

GraphQL একটি প্রধান API প্যারাডাইম, এবং NestJS এর পরিষ্কার ইন্টিগ্রেশন এটি একটি উল্লেখযোগ্য, ঘন ঘন-প্রাসঙ্গিক ক্ষমতা করে তোলে flexible, efficient back-ends তৈরির জন্য।