انٹرسیپٹرز کیا ہیں؟

Question

انٹرسیپٹرز کیا ہیں؟

Accepted Answer

**انٹرسیپٹرز** ایک روٹ ہینڈلر کی execution کو wrap کرتے ہیں، جو آپ کو اس سے **پہلے اور بعد میں** logic چلانے کی اجازت دیتے ہیں — اور request یا response کو تبدیل کرتے ہیں۔ یہ aspect-oriented programming سے متاثر ہیں، اور logging، response transformation، caching، اور timing جیسے cross-cutting concerns کے لیے موزوں ہیں۔

## ساخت: RxJS کے ذریعے before + after

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

ایک interceptor `intercept()` کو implement کرتا ہے۔ `next.handle()` سے پہلے کا code handler سے **پہلے** چلتا ہے؛ `next.handle()` response کا ایک RxJS `Observable` واپس کرتا ہے، اور `tap`/`map` جیسے operators آپ کو handler مکمل ہونے کے **بعد** response پر عمل کرنے دیتے ہیں۔

## Response کو تبدیل کرنا (ایک عام استعمال)

```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` کا استعمال کرتے ہوئے، ایک interceptor ہر response کو reshape کر سکتا ہے — مثال کے طور پر تمام responses کو ایک معیاری envelope میں wrap کرنا، جو consistent API responses کے لیے ایک بہت عام pattern ہے۔

## دوسرے طاقتور استعمالات

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

## انٹرسیپٹرز بمقابلہ middleware بمقابلہ guards

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

تعریفی خصوصیت: انٹرسیپٹرز handler سے **بعد میں** logic چلا سکتے ہیں اور **response کو تبدیل** کر سکتے ہیں — جو middleware اور guards صاف طریقے سے نہیں کر سکتے۔

## یہ کیوں اہم ہے

انٹرسیپٹرز NestJS کی ایک طاقتور خصوصیت ہیں جو **cross-cutting concerns** کو سنجیدگی سے handle کرنے کے لیے ہیں، اور ان کی امتیازی صلاحیت — handler سے پہلے *اور بعد میں* logic چلانا، اور response کو تبدیل کرنا — انہیں ان ضروریات کے لیے صحیح tool بناتا ہے جو middleware اور guards پورا نہیں کر سکتے۔

us کو سمجھنا اہم ہے کیونکہ بہت سی عام requirements قدرتی طور پر انٹرسیپٹرز سے map ہوتی ہیں: consistent response formatting (تمام responses کو معیاری `{ success, data }` envelope میں wrap کرنا)، logging/timing (handler کی duration کو ماپنا)، caching (cached responses کو واپس کرنا)، timeouts، error transformation، اور serialization (حساس fields کو exclude کرنا)۔

ساخت کو جاننا (the `next.handle()` Observable، `tap`/`map`/`catchError` کے ساتھ پہلے/بعد میں عمل کرنے کے لیے)، عام use cases، اور خاص طور پر **انٹرسیپٹرز middleware اور guards سے کیسے مختلف ہیں** (response کو wrap اور تبدیل کرنے کی صلاحیت) NestJS architectural competence کا ایک اہم حصہ ہے۔

انٹرسیپٹرز cross-cutting logic کو DRY اور centralized رکھتے ہیں بجائے handlers میں duplicate ہونے کے، انہیں clean اور maintainable NestJS applications بنانے کے لیے ایک frequently-used، اہم tool بناتے ہیں۔