Auto-translated ·
If you've ever coded PHP with Laravel, you must have experienced the thrill when everything from Routing, ORM, Queue, to Authentication is already integrated (Batteries-Included). You just need to fire up your machine, type php artisan make:model and dive straight into coding the business logic right away.
But when the project requires asynchronous processing or needs extremely high traffic, we often have to switch to Node.js.
And that's when the "nightmare" known as "Blank Canvas Fatigue" begins.
The common pain of Node.js developers
When using Express, Koa, or Fastify, you get a completely empty framework. You'll spend weeks just to:
- Argue over which directory structure to use.
- Struggle to choose an ORM (Prisma? TypeORM? Sequelize?).
- Wrestle with setting up Dependency Injection, Middleware, and the Queue system.
- Patch together dozens of different libraries and hope they don't "fight" each other in Production.
I'm so tired of that. I want the blazing processing speed of Node.js (specifically Fastify), but I crave the elegant and cohesive development experience (DX) of Laravel.
Since I couldn't find what I needed, I decided to create it myself.
Video tutorial series: https://www.youtube.com/playlist?list=PLfU7tl7Veh7M
Latest updates
1.0.11
LatestFix bugs Model Instance, bổ sung tính năng các Built-in Middleware1 weeks ago1. Hỗ trợ Constructor Arguments & Fluent Helpers cho Middleware Phân quyền
CanMiddleware:- Cho phép truyền gate/ability trực tiếp qua constructor:
new CanMiddleware("edit-post"). - Hỗ trợ factory method:
CanMiddleware.ability("edit-post"). - Hỗ trợ helper ngắn gọn xuất sẵn từ
struxjs:can("edit-post").
- Cho phép truyền gate/ability trực tiếp qua constructor:
RoleMiddleware:- Cho phép truyền role(s) qua constructor:
new RoleMiddleware("admin", "editor"). - Hỗ trợ helper:
role("admin", "editor").
- Cho phép truyền role(s) qua constructor:
PermissionMiddleware:- Cho phép truyền permission(s) qua constructor:
new PermissionMiddleware("publish-post"). - Hỗ trợ helper:
permission("publish-post").
- Cho phép truyền permission(s) qua constructor:
Khả năng tương thích 100%:
- Đã cài đặt method
toString()cho tất cả các class middleware trên trả về alias tương ứng (ví dụ:"can:edit-post"), giúp hoạt động hoàn hảo vớiRoute.group(),withoutMiddleware(), logging và telemetry.
- Đã cài đặt method
2. Hỗ trợ Constructor Params & Alias Arguments cho Middleware Xác thực
AuthMiddleware:- Nhận tham số tùy chỉnh URL redirect và guard qua constructor:
new AuthMiddleware("/custom-login", "web"). - Nhận tham số qua chuỗi alias:
.middleware("auth:/custom-login,web").
- Nhận tham số tùy chỉnh URL redirect và guard qua constructor:
ApiAuthMiddleware:- Nhận default guard qua constructor:
new ApiAuthMiddleware("api"). - Nhận guard qua chuỗi alias:
.middleware("api.auth:custom_guard"). - Tự động gắn user vào Request Context: Khi xác thực JWT thành công, tự động gọi
request.setUser(user)giúp controller và downstream handler truy cập ngayrequest.usermà không cần resolve lại.
- Nhận default guard qua constructor:
3. Khắc phục lỗi id bị undefined trên Model Instance
- Nguyên nhân: Do cơ chế field initialization của chuẩn ES2022 trên TypeScript, trường
public id?: number | stringở class cha BaseModel được khởi tạo với giá trịundefinedkhi chạy constructor của instance, ghi đè lên Proxy getter và prototype getter trỏ vàothis.attributes["id"].
Giải pháp khắc phục:
- Chuyển khai báo runtime property thành ambient type declaration:
declare id: any. - Tối ưu Proxy Handler (
get,has,ownKeys,getOwnPropertyDescriptor) ưu tiên truy xuất trực tiếpthis.attributesđối với các khóa định danh chính (id,_id,this.primaryKey). - Đảm bảo tính toàn vẹn khi destructuring
{ id, name } = user, gọi.toJSON(),.toObject(), hoặc truy cậpuser.id.
- Chuyển khai báo runtime property thành ambient type declaration:
Maintained byHHoàng An Unicode
Reviews & comments