Middleware ni nini katika NestJS na inatofautianaje na guards/interceptors?

Question

Accepted Answer

**Middleware** ni function inayoendeshwa **kabla ya route handler**, ikiwa na ufikiaji wa request na response objects — dhana ile ile kama Express middleware. NestJS pia ina guards, interceptors, pipes, na filters, kila moja ikiendeshwa katika hatua mahususi ya request lifecycle ikiwa na kusudi tofauti. Kujua ipi ya kutumia ni jambo muhimu.

## Middleware — huendeshwa kwanza, ina req/res

```ts
@Injectable()
export class LoggerMiddleware implements NestMiddleware {
  use(req: Request, res: Response, next: NextFunction) {
    console.log(`${req.method} ${req.url}`);   // logging, modifying req
    next();                                      // MUST call next() to continue
  }
}

// register in a module
export class AppModule implements NestModule {
  configure(consumer: MiddlewareConsumer) {
    consumer.apply(LoggerMiddleware).forRoutes("*");   // apply to routes
  }
}
```

Middleware huendeshwa mapema zaidi, kabla ya guards/interceptors/pipes, na hufanya kazi na raw `req`/`res` — nzuri kwa logging, urekebishaji wa request, CORS, na mambo yanayoendana na Express.

## Mpangilio kamili wa request lifecycle

```text
Request →
  1. Middleware     (req/res; runs first, Express-style)
  2. Guards         (return true/false → AUTHORIZE or block the request)
  3. Interceptors   (BEFORE the handler)
  4. Pipes          (validate/transform the handler's arguments)
  5. → Route Handler ←
  6. Interceptors   (AFTER the handler — transform the response)
  7. Exception Filters (if an error was thrown anywhere)
→ Response
```

## Kila kimoja ni KWA AJILI YA nini (kuchagua chombo sahihi)

```text
Middleware  → general pre-processing with req/res (logging, CORS, raw request work)
Guards      → AUTHORIZATION — decide if a request may proceed (auth, roles)
              (return true = allow, false/throw = block)
Interceptors→ wrap the handler — transform request/response, add logging/caching/timing
              (can run logic BEFORE and AFTER the handler)
Pipes       → VALIDATE/TRANSFORM the handler's input arguments (DTO validation)
Filters     → catch and format EXCEPTIONS into responses
```

Tofauti muhimu: middleware ni pre-processing ya jumla ya mtindo wa Express; **guards** hushughulikia hasa authorization (mahali safi, maalum kwa auth, tofauti na kubana auth ndani ya middleware); **interceptors** huzungushia handler kubadilisha responses au kuongeza tabia za kupita pande mbalimbali; **pipes** huthibitisha input; **filters** hushughulikia makosa.

## Lini kutumia middleware dhidi ya guards dhidi ya interceptors

```text
Auth check?           → Guard (dedicated, has execution context, returns boolean)
Logging requests?     → Middleware OR an interceptor (interceptor sees the response too)
Transform responses?  → Interceptor (runs after the handler)
Validate a DTO?       → Pipe
Modify raw req early?  → Middleware
```

## Kwa nini ni muhimu

Kuelewa middleware na jinsi inavyotofautiana na guards, interceptors, pipes, na filters ni muhimu kwa kupanga programu za NestJS ipasavyo — kila moja ina jukumu mahususi na huendeshwa katika hatua mahususi ya request lifecycle, na kutumia ile sahihi huleta code safi na ya kawaida.

Middleware hushughulikia pre-processing ya jumla ya mtindo wa Express ikiwa na raw req/res.

Tofauti muhimu ni kuwa **guards** ndizo mahali maalum, panapostahili kwa authorization (auth/roles) — safi zaidi kuliko middleware kwa kusudi hilo — na **interceptors** huzungushia handler kubadilisha responses na kuongeza mambo ya kupita pande mbalimbali (logging, caching, timing) ambayo middleware haiwezi kufanya kwa urahisi (kwa kuwa huendeshwa kabla ya handler na haioni response kwa kawaida).

Kujua mpangilio kamili wa lifecycle (middleware → guards → interceptors → pipes → handler → interceptors → filters) na chombo gani kinafaa kwa kila jambo (auth → guard, ubadilishaji wa response → interceptor, validation → pipe, makosa → filter) ni alama ya umahiri wa NestJS na huzuia kosa la kawaida la kutumia vibaya middleware kwa kila kitu.

Hili ni eneo linalopimwa mara kwa mara, lenye umuhimu wa kiusanifu katika framework hii.