ইন্টারসেপ্টর কি?

Question

ইন্টারসেপ্টর কি?

Accepted Answer

**ইন্টারসেপ্টর** একটি রুট হ্যান্ডলারের এক্সিকিউশনকে মোড়ে ফেলে, আপনাকে এটি চালানোর **আগে এবং পরে** লজিক চালাতে দেয় — এবং রিকোয়েস্ট বা রেসপন্সকে ট্রান্সফর্ম করে। এটি অ্যাসপেক্ট-ওরিয়েন্টেড প্রোগ্রামিং দ্বারা অনুপ্রাণিত, লগিং, রেসপন্স ট্রান্সফরমেশন, ক্যাশিং এবং টাইমিংয়ের মতো ক্রস-কাটিং কনসার্নের জন্য আদর্শ।

## কাঠামো: RxJS এর মাধ্যমে আগে + পরে

```ts
@Injectable()
export class LoggingInterceptor implements NestInterceptor {
  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
    console.log("Before handler");          // runs BEFORE the route handler
    const now = Date.now();

return next.handle().pipe(               // next.handle() = invoke the handler
      tap(() => console.log(`After: ${Date.now() - now}ms`)),   // runs AFTER
    );
  }
}
```

একটি ইন্টারসেপ্টর `intercept()` বাস্তবায়ন করে। `next.handle()` এর আগে কোড হ্যান্ডলারের **আগে** চলে; `next.handle()` রেসপন্সের একটি RxJS `Observable` রিটার্ন করে, এবং `tap`/`map` এর মতো অপারেটর আপনাকে হ্যান্ডলার সম্পন্ন হওয়ার **পরে** রেসপন্সে অ্যাক্ট করতে দেয়।

## রেসপন্স ট্রান্সফর্ম করা (একটি সাধারণ ব্যবহার)

```ts
@Injectable()
export class TransformInterceptor implements NestInterceptor {
  intercept(context: ExecutionContext, next: CallHandler) {
    return next.handle().pipe(
      map(data => ({ success: true, data, timestamp: new Date().toISOString() })),
      // wraps EVERY response in a consistent envelope: { success, data, timestamp }
    );
  }
}
```

`map` ব্যবহার করে, একটি ইন্টারসেপ্টর প্রতিটি রেসপন্সকে পুনর্গঠন করতে পারে — যেমন সমস্ত রেসপন্সকে একটি স্ট্যান্ডার্ড এনভেলপে মোড়ানো, সামঞ্জস্যপূর্ণ API রেসপন্সের জন্য একটি অত্যন্ত সাধারণ প্যাটার্ন।

## অন্যান্য শক্তিশালী ব্যবহার

```ts
// caching — return a cached response, skipping the handler entirely
// timeout — fail requests taking too long
return next.handle().pipe(timeout(5000));

// error mapping — transform exceptions
return next.handle().pipe(catchError(err => throwError(() => new BadGatewayException())));

// excluding fields (serialization) — ClassSerializerInterceptor strips @Exclude() fields
```

```text
Common interceptor uses:
  ✓ Logging / timing requests (before + after)
  ✓ Transforming responses (consistent envelopes, field exclusion)
  ✓ Caching responses
  ✓ Adding timeouts
  ✓ Mapping/handling errors
```

## ইন্টারসেপ্টর প্রয়োগ করা

```ts
@UseInterceptors(LoggingInterceptor)   // method or controller level
app.useGlobalInterceptors(new TransformInterceptor());   // global
```

## ইন্টারসেপ্টর বনাম মিডলওয়্যার বনাম গার্ড

```text
Middleware  → runs BEFORE everything, with raw req/res (can't easily touch the response)
Guard       → AUTHORIZATION decision (allow/block) before the handler
Interceptor → wraps the handler — runs BEFORE and AFTER, can TRANSFORM the response
```

সংজ্ঞায়িত করা বৈশিষ্ট্য: ইন্টারসেপ্টর হ্যান্ডলারের **পরে** লজিক চালাতে এবং **রেসপন্স ট্রান্সফর্ম** করতে পারে — যা মিডলওয়্যার এবং গার্ড পরিষ্কারভাবে করতে পারে না।

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

ইন্টারসেপ্টর **ক্রস-কাটিং কনসার্ন** সামলানোর জন্য NestJS এর একটি শক্তিশালী বৈশিষ্ট্য, এবং তাদের স্বতন্ত্র ক্ষমতা — হ্যান্ডলারের আগে এবং পরে উভয় সময়ে লজিক চালানো এবং রেসপন্স ট্রান্সফর্ম করা — তাদের সেই প্রয়োজনের জন্য সঠিক টুল করে তোলে যা মিডলওয়্যার এবং গার্ড সমাধান করতে পারে না।

এটি বোঝা গুরুত্বপূর্ণ কারণ অনেক সাধারণ প্রয়োজন স্বাভাবিকভাবে ইন্টারসেপ্টরে ম্যাপ করে: সামঞ্জস্যপূর্ণ রেসপন্স ফরম্যাটিং (সমস্ত রেসপন্সকে একটি স্ট্যান্ডার্ড `{ success, data }` এনভেলপে মোড়ানো), লগিং/টাইমিং (হ্যান্ডলার ডিউরেশন পরিমাপ), ক্যাশিং (ক্যাশ করা রেসপন্স রিটার্ন করা), টাইমআউট, এরর ট্রান্সফরমেশন এবং সিরিয়ালাইজেশন (সংবেদনশীল ফিল্ড বাদ দেওয়া)।

কাঠামো (the `next.handle()` Observable, `tap`/`map`/`catchError` সহ আগে/পরে অ্যাক্ট করতে), সাধারণ ব্যবহারের ক্ষেত্র এবং বিশেষত **ইন্টারসেপ্টর কিভাবে মিডলওয়্যার এবং গার্ড থেকে আলাদা** (রেসপন্স মোড়ানো এবং ট্রান্সফর্ম করার ক্ষমতা) জেনে রাখা NestJS স্থাপত্যগত দক্ষতার একটি মূল অংশ।

ইন্টারসেপ্টর ক্রস-কাটিং লজিক DRY এবং কেন্দ্রীয় রাখে বরং হ্যান্ডলার জুড়ে ডুপ্লিকেট করা হয় না, সেগুলিকে পরিষ্কার, রক্ষণাবেক্ষণযোগ্য NestJS অ্যাপ্লিকেশন তৈরির জন্য একটি ঘন ঘন ব্যবহৃত, গুরুত্বপূর্ণ টুল করে তোলে।