इंटरसेप्टरहरू के हुन्?

Question

Accepted Answer

**इंटरसेप्टरहरू** एक रूट ह्यान्डलरको निष्पादनलाई र्‍यापमा गर्छन्, जसले तपाईंलाई यो **अगाडि र पछाडि** लजिक चलाउन दिन्छ — र अनुरोध वा प्रतिक्रिया रूपान्तरण गर्छन्। तिनीहरू aspect-oriented programming बाट प्रेरित छन्, लजिङ्ग, प्रतिक्रिया रूपान्तरण, क्यासिङ्ग, र समय जस्ता cross-cutting concerns को लागि आदर्श छन्।

## संरचना: 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
```

## इंटरसेप्टरहरू बनाम 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
```

परिभाषित सुविधा: इंटरसेप्टरहरूले ह्यान्डलर **पछाडि** लजिक चलाउन सक्छन् र **प्रतिक्रिया रूपान्तरण** गर्न सक्छन् — जो middleware र guards सफाईसँग गर्न सक्दैनन्।

## यो किन महत्त्वपूर्ण छ

इंटरसेप्टरहरू **cross-cutting concerns** सुन्दरतासँग ह्यान्डल गर्नको लागि एक शक्तिशाली NestJS सुविधा हुन्, र तिनीहरूको विशिष्ट क्षमता — ह्यान्डलर अगाडि र *पछाडि* दुबै लजिक चलाउने, र प्रतिक्रिया रूपान्तरण गर्ने — तिनहरूलाई middleware र guards ले सम्बोधन गर्न नसक्ने आवश्यकताहरूको लागि सही उपकरण बनाउँछ।

अनेक सामान्य आवश्यकताहरू प्राकृतिक रूपमा इंटरसेप्टरहरूमा नक्सा गर्छन्: सुसंगत प्रतिक्रिया ढाँचा (सबै प्रतिक्रियाहरूलाई मानक `{ success, data }` खाममा र्‍यापमा गर्दै), लजिङ्ग/समय (ह्यान्डलर अवधि मापन गर्दै), क्यासिङ्ग (क्यास गरिएको प्रतिक्रियाहरू फर्काउँदै), समय सीमा, त्रुटि रूपान्तरण, र क्रमबद्धकरण (संवेदनशील क्षेत्रहरू बहिष्कार गर्दै)।

संरचना (the `next.handle()` Observable, `tap`/`map`/`catchError` सँग अगाडि/पछाडि कार्य गर्न), सामान्य उपयोग गरिने केसहरू, र विशेष गरेर **इंटरसेप्टरहरू middleware र guards बाट कसरी भिन्न हुन्छन्** (प्रतिक्रिया र्‍यापमा र रूपान्तरण गर्ने क्षमता) जान्नु NestJS आर्किटेक्चरल योग्यताको मुख्य भाग हो।

इंटरसेप्टरहरूले cross-cutting लजिकलाई DRY र केन्द्रीकृत राख्छन् हस्तकलाहरू पार दोहोरिएको सट्टा, तिनहरूलाई सफा, राखरखाव योग्य NestJS अनुप्रयोगहरू बनाउनको लागि बारम्बार-प्रयोग गरिएको, महत्त्वपूर्ण उपकरण बनाउँछ।