AdonisJS v7 chính thức ra mắt: An toàn kiểu dữ liệu toàn diện, bộ khởi tạo mới và hỗ trợ OpenTelemetry

AdonisJS v7 chính thức ra mắt: An toàn kiểu dữ liệu toàn diện, bộ khởi tạo mới và hỗ trợ OpenTelemetry

AdonisJS, framework Node.js nổi tiếng với triết lý "batteries-included" (đầy đủ tính năng tích hợp sẵn), đã phát hành phiên bản 7 với nhiều cải tiến đáng kể. Bản cập nhật này lấy tính năng an toàn kiểu dữ liệu (type safety) đầu cuối làm điểm nhấn chính, đi kèm với các bộ khởi động (starter kits) được thiết kế lại, khả năng quan sát (observability) không cần cấu hình và một trang tài liệu hoàn toàn mới.

Phiên bản v7 bao gồm hơn 45 gói (package) đã được cập nhật và giới thiệu ba gói mới: @adonisjs/otel để tích hợp OpenTelemetry, @adonisjs/content cho các bộ sưu tập nội dung có kiểu (typed content), và edge-markdown để hiển thị Markdown với cú pháp component trong các mẫu Edge.

An toàn kiểu dữ liệu đầu cuối

Trọng tâm của phiên bản v7 là hệ thống kiểu dữ liệu bao phủ toàn bộ stack ứng dụng thông qua cơ chế tạo mã tự động (codegen). Các định nghĩa tuyến đường (route definitions) giờ đây sẽ tự động tạo ra các kiểu TypeScript được sử dụng bởi helper urlFor mới, thay thế cho phương thức router.makeUrl không có kiểu dữ liệu của phiên bản v6.

Các bộ chuyển đổi (Transformers) cung cấp một lớp tuần tự hóa chuyên biệt, tạo ra các tệp .d.ts tại thời điểm biên dịch. Điều này cho phép mã frontend truy cập vào cấu trúc phản hồi API một cách an toàn về mặt kiểu dữ liệu mà không cần sao chép thủ công. Đối với các ứng dụng sử dụng Inertia, framework sẽ quét các thành phần trang và đảm bảo rằng inertia.render truyền đúng các props tại thời điểm biên dịch. Một client API an toàn về kiểu dữ liệu được hỗ trợ bởi Tuyau cũng mở rộng các bảo đảm này cho các dự án frontend riêng biệt sử dụng TanStack Query hoặc fetch thuần túy.

Yêu cầu Node.js 24 và Hiệu suất

AdonisJS v7 yêu cầu Node.js 24 trở lên làm phiên bản tối thiểu. Điều này cho phép nhóm phát triển thay thế các phụ thuộc bên thứ ba bằng các API nền tảng gốc (native platform APIs). Gói dotenv đã bị thay thế bằng util.parseEnv tích hợp sẵn của Node.js. Ngoài ra, một trình biên dịch TypeScript JIT mới mang tên ts-exec được xây dựng dựa trên trình biên dịch SWC (dựa trên Rust) với kích thước khoảng 15 KB, đã thay thế ts-node trong môi trường phát triển, giúp tăng tốc độ xử lý.

Trải nghiệm phát triển và Starter Kits mới

Các bộ khởi động (starter kits) đã được thiết kế lại hoàn toàn. Thay vì hỏi nhà phát triển một loạt câu hỏi cấu hình, v7 cung cấp bốn bộ kit có quan điểm rõ ràng: Hypermedia, API, React và Vue. Các bộ này bao gồm sẵn quy trình xác thực (authentication), quản lý phiên (session management) và công cụ frontend ngay lập tức.

Framework cũng giới thiệu tính năng tạo "barrel file" cho controllers, events và policies. Điều này giúp loại bỏ tình trạng "bức tường" các lệnh nhập lười (lazy imports) thường xuyên tích tụ ở đầu các tệp định nghĩa tuyến đường trước đây.

Phản hồi cộng đồng và Nâng cấp

Phản hồi từ cộng đồng đối với v7 là cực kỳ tích cực. Một nhà phát triển trên LinkedIn mô tả v7 là "điểm ngọt ngào (sweet spot) hiện tại cho công việc backend ưu tiên TypeScript". Nếu bạn đến từ Laravel hoặc mệt mỏi vì phải kết nối hơn 20 gói lại với nhau trong Express/NestJS, AdonisJS mang lại sự ma thuật "đầy đủ tính năng" mà bạn cần.

Về việc nâng cấp, Harminder Virk - tác giả thư viện - cho biết việc chuyển đổi từ v6 lên v7 sẽ diễn ra rất mượt mà vì hầu như không có sự thay đổi nào làm vỡ cấu trúc (breaking changes) lớn. AdonisJS kỳ vọng hầu hết các ứng dụng sẽ hoàn tất việc di chuyển trong vòng 30 phút đến một giờ, với hướng dẫn nâng cấp chi tiết và một luồng thảo luận riêng trên GitHub để báo cáo vấn đề.

AdonisJS là một framework web Node.js mã nguồn mở, được tạo và duy trì bởi Harminder Virk. Kế thừa nhiều truyền thống từ Laravel, nó cung cấp một bộ công cụ liền mạch theo triết lý "ưu tiên quy ước hơn cấu hình" (convention-over-configuration), bao gồm định tuyến, ORM (Lucid), xác thực, xác thực dữ liệu, gửi email và tạo mẫu, tất cả đều được hỗ trợ TypeScript hạng nhất.