ما هي Middleware في NestJS وكيف تختلف عن Guards و Interceptors؟

Question

Accepted Answer

**Middleware** هي دالة تعمل **قبل معالج المسار**، مع وصول إلى كائنات الطلب والاستجابة — نفس المفهوم مثل Express middleware. يحتوي NestJS أيضًا على guards و interceptors و pipes و filters، كل واحد يعمل في نقطة معينة من دورة حياة الطلب بغرض مختلف. معرفة أيهما تستخدم أمر حاسم.

## Middleware — يعمل أولاً، له وصول إلى 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 يعمل في وقت مبكر جدًا، قبل guards/interceptors/pipes، ويعمل مع `req`/`res` الخام — مناسب للتسجيل وتعديل الطلب و CORS والاهتمامات المتوافقة مع Express.

## ترتيب دورة حياة الطلب الكاملة

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

## ما يناسب كل واحد (اختيار الأداة الصحيحة)

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

الفروقات الرئيسية: middleware هي معالجة مسبقة عامة بأسلوب Express؛ **guards** تتعامل بشكل محدد مع التفويض (مكان نظيف مخصص للمصادقة، بخلاف حشره في middleware)؛ **interceptors** تغلف معالج لتحويل الاستجابات أو إضافة سلوك متقاطع؛ **pipes** تتحقق من صحة الإدخال؛ **filters** تتعامل مع الأخطاء.

## متى تستخدم middleware مقابل guards مقابل 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
```

## لماذا هذا مهم

فهم middleware وكيف يختلف عن guards و interceptors و pipes و filters أمر ضروري لهيكلة تطبيقات NestJS بشكل صحيح — لكل واحد دور محدد ويعمل في نقطة محددة من دورة حياة الطلب، واستخدام الأداة الصحيحة يؤدي إلى كود نظيف وفصيح.

Middleware يتعامل مع معالجة مسبقة عامة بأسلوب Express مع req/res الخام.

الفروقات الحاسمة هي أن **guards** هي المكان المخصص والصحيح للمصادقة (auth/roles) — أنظف بكثير من middleware لهذا الغرض — و **interceptors** تغلف معالج لتحويل الاستجابات وإضافة اهتمامات متقاطعة (تسجيل، تخزين مؤقت، توقيت) لا يمكن لـ middleware أن تقوم بها بسهولة (لأنها تعمل قبل معالج ولا ترى الاستجابة بشكل طبيعي).

معرفة ترتيب دورة الحياة الكاملة (middleware → guards → interceptors → pipes → handler → interceptors → filters) وأي أداة تناسب كل اهتمام (المصادقة → guard، تحويل الاستجابة → interceptor، التحقق من الصحة → pipe، الأخطاء → filter) هي علامة على كفاءة NestJS وتمنع الخطأ الشائع المتمثل في إساءة استخدام middleware لكل شيء.

هذا موضوع تُختبر بشكل متكرر وله أهمية معمارية في الإطار.