مدة القراءة: 4 د
NestJS 12 ونهاية شيفرة الربط
أرسى NestJS 12 الأساسات، وجاءت الأسابيع التالية بالجزء الممتع: وحدة Drizzle رسمية، وعميل HTTP مبني على fetch، ومحوِّل يعمل مباشرة فوق `node:http` أُعلن عنه للإصدار الفرعي التالي، وتُظهر القياسات أنه أسرع من Express بنحو ٥٠٪.
وصل NestJS 12 في أواخر أغسطس، والإصدار نفسه في معظمه أساسات: كل الحزم الأساسية صارت تُشحن
بصيغة ESM، ومُزخرِفات المسارات تقبل مُدقِّقات Standard Schema مثل Zod وValibot، وأُعيد بناء
واجهة سطر الأوامر حول أمر جديد هو nest upgrade، وهناك حزمة رسمية للمراقبة. كل هذا جيد. لكنّ
الجزء الذي أعود إليه مرارًا وصل بعد الإصدار: وحدتان رسميتان جديدتان ومحوِّل أُعلن عنه،
تحلّ معًا محلّ شيفرة الربط التي كان يحملها كل مشروع Nest.
DrizzleModule: Drizzle بأسلوب Nest
يُبقي Drizzle المخطط في TypeScript والاستعلامات قريبة من SQL. وحتى الآن، كان ربطه بـ Nest
يعني كتابة مزوِّد يدويًا أو اختيار واحد من عدة أغلفة يطوّرها المجتمع. و@nestjs/drizzle هو
النسخة الرسمية، ونشرها فريق Nest في سبتمبر.
import { drizzle } from 'drizzle-orm/node-postgres';
import { DrizzleModule } from '@nestjs/drizzle';
@Module({
imports: [
DrizzleModule.forRoot({
drizzle,
connection: process.env.DATABASE_URL!,
}),
],
})
export class AppModule {}خيار drizzle هو دالة drizzle() الخاصة بأي مُشغِّل تريده: node-postgres هنا، لكنّ MySQL
وSQLite وNeon وTurso وD1 تمرّ كلها عبر الخيار نفسه. قاعدة البيانات عامة، فلا حاجة إلى خطوة
forFeature(). يكفي أن تطلبها الخدمة:
@Injectable()
export class UsersService {
constructor(@InjectDrizzle() private readonly db: NodePgDatabase) {}
findOne(id: number) {
return this.db.select().from(users).where(eq(users.id, id));
}
}بعض التفاصيل تدلّ على أنه صُمّم على يد من اكتووا بهذه المشكلات من قبل:
-
forRootAsync()يعمل معConfigService، وهذا مهم لأن خياراتforRoot()تُقيَّم وقت الاستيراد، وربما قبل تحميل ملف متغيرات البيئة. - قواعد البيانات المتعددة مجرد استيرادات مسمّاة، تُحقن بـ
@InjectDrizzle('analytics'). - الاختبار لا يحتاج إلا مزوِّدًا مخصصًا على
getDrizzleToken(). - التوثيق يقولها صراحة: لا تشغّل عمليات الترحيل عند الإقلاع حين تبدأ عدة نسخ معًا، بل شغّل
drizzle-kit migrateكخطوة مستقلة ضمن الإصدار.
يستهدف النسخة المرشّحة للإصدار v1 من Drizzle، ويدعم أيضًا v0.35 وما بعدها. نسخته على npm هي 0.0.2، فتوقّع أن يتغيّر.
HttpClientModule: fetch، ومعه كل ما ينتهي بك الأمر إلى كتابته
يغلّف @nestjs/axios مكتبة Axios ويعيد Observables من RxJS، ما يعني firstValueFrom() حول
كل استدعاء تقريبًا. أما @nestjs/http-client فمبني على fetch الأصلية في Node، بلا أي
اعتماديات خارجية، ويعيد Promises.
@Module({
imports: [
HttpClientModule.register({
name: 'github',
baseUrl: 'https://api.github.com',
timeout: '5s',
retry: 3,
}),
],
})
export class ReposModule {}
@Injectable()
export class ReposService {
constructor(@InjectHttpClient('github') private readonly github: HttpClient) {}
async find(owner: string, repo: string) {
const { data } = await this.github.get<Repo>('/repos/:owner/:repo', {
params: { owner, repo },
});
return data;
}
}ما يعجبني أن الأشياء التي يعيد كل مشروع كتابتها صارت خيارات: مهل زمنية لكل محاولة تُكتب
كنصوص مدة، وإعادة المحاولة مع تراجع تدريجي، ومعاملات المسار :name، وعميل مسمّى لكل واجهة
خارجية، ومعترِضات تُكتب كدوال عادية أو كأصناف. والأخطاء مُنمَّطة (HttpResponseError
وHttpTimeoutError وHttpNetworkError وHttpParseError، وكلها ترث HttpClientError)،
وtoHttpException() يحوّلها إلى استثناءات Nest: فشل الخدمة الخارجية يصبح 502، وانتهاء المهلة
يصبح 504. هذا بالضبط التحويل الذي كنت سأكتبه يدويًا في كل خدمة بوابة.
و@nestjs/axios باقٍ؛ فالتوثيق يقدّم جدول ترحيل، لا إشعار إيقاف.
platform-node: قادم في الإصدار الفرعي التالي، وهو أكثر ما يحمّسني
لدى Nest محوِّلا HTTP. فـ Express هو الافتراضي والأبطأ، وFastify سريع، لكن الانتقال إليه يعني
إعادة كتابة الوسائط بأسلوب Express وشيفرة @Res() وفق واجهة Fastify الخاصة. في ٩ أكتوبر فتح
Kamil Myśliwiec طلب دمج لمحوِّل ثالث: @nestjs/platform-node، الذي يعمل مباشرة فوق
node:http. وبعد ثلاثة أيام أعلن الحساب الرسمي لـ NestJS عنه للإصدار الفرعي التالي، متسائلًا
عمّا سيكون عليه Nest لو كان «مجرد Nest».
const app = await NestFactory.create(AppModule, new NodeAdapter());الطلبات والاستجابات أصناف فرعية من IncomingMessage وServerResponse الخاصّين بـ Node نفسه،
وتحمل أدوات Express المساعدة التي تستدعيها الوسائط فعلًا. ويذكر طلب الدمج أن helmet
وcompression وexpress-session وpassport وغيرها (٢١ حزمة وسائط شائعة في المجمل) تصرّفت كما
تتصرّف على محوِّل Express. وتحليل جسم الطلب مدمج، ويرفض تسميم النموذج الأولي (prototype
poisoning) كما يفعل Fastify.
القياس الوارد في طلب الدمج هو العنوان الأبرز. جولة واحدة من wrk على M1 Pro مع Node 24،
بعدد الطلبات في الثانية:
GET / |
GET /users/:id |
POST JSON | |
|---|---|---|---|
| Nest + Express | 37.1k | 34.5k | 28.2k |
| Nest + Fastify | 52.4k | 48.4k | 40.2k |
| Nest + Node | 55.1k | 51.0k | 42.4k |
أسرع بنحو ٥٠٪ من Express ومتقدّم قليلًا على Fastify، دون مغادرة نموذج البرمجة الخاص بـ
Express. لكنه يختلف عن Express في بضعة مواضع تستحق المعرفة قبل الانتقال: المسارات تُطابَق
حسب الخصوصية لا حسب ترتيب التصريح، والمسارات حسّاسة لحالة الأحرف، والنصوص التي تعيدها
المعالِجات تُرسل بنوع text/plain.
حتى كتابة هذه السطور لم يصل إلى npm بعد، ولا يزال طلب الدمج مفتوحًا. وحين يصدر الإصدار الفرعي التالي، يكون التبديل هو السطر الواحد أعلاه.
أين يترك هذا NestJS
مجتمعةً، يستطيع تطبيق Nest جديد أن يتولّى التخزين الدائم وطلبات HTTP الصادرة، وقريبًا خادم HTTP الخاص به، بحزم رسمية فقط، على ESM، مع التحقق بأي مكتبة مخططات تستخدمها أصلًا. الإطار يستوعب شيفرة الربط التي كنت أنسخها من مشروع إلى آخر، وهذا أفضل أنواع الإصدارات.