- SaltyAom vừa công bố Elysia đổi scope plugin trên npm: bun install @elysia/eden thay vì @elysiajs/eden.
- Patch cho scope cũ vẫn chạy tới khi Elysia 2 ra mắt, nhưng dev được khuyến nghị migrate sớm.
- Cùng xem thay đổi, lý do, và cách update dự án.
TL;DR
Elysia — framework TypeScript-first chạy trên Bun — vừa đổi npm scope cho toàn bộ plugin từ @elysiajs sang @elysia. Lệnh install mới: bun install @elysia/eden. Scope cũ vẫn được publish patch tới khi Elysia 2 phát hành, nhưng maintainer SaltyAom khuyến nghị migrate sang scope mới khi có thể.
What's new
Ngày 23/04/2026, package @elysia/eden@1.4.10 xuất hiện trên npm registry — mốc chính thức của npm scope mới. Một ngày sau, SaltyAom (aomkirby123) — tác giả Elysia — tweet thông báo migration:
From @elysiajs → @elysia on npm.
bun install @elysia/eden. Elysia plugins are now under @elysia instead of @elysiajs. We will continue to publish patches under @elysiajs until Elysia 2 arrives.
Như vậy toàn bộ plugin official (eden, cors, swagger, jwt, html, static, trpc, stream, graphql...) sẽ chuyển dần sang scope ngắn @elysia/*. Elysia core vẫn giữ tên package unscoped là elysia, không đổi.
Why it matters
Đây không đơn thuần là đổi tên. Với một framework đang chạy ~2.45 triệu request/s trên benchmark TechEmpower — nhanh hơn Express ~21 lần và Fastify ~6 lần — việc dọn dẹp naming trước khi bước vào major version kế tiếp là tín hiệu team đang chuẩn bị nền móng cho Elysia 2.
Scope mới @elysia ngắn hơn, khớp với tên core package elysia, giảm nhầm lẫn (elysiajs vs elysia — nhiều dev đã quen gõ sai). Về mặt thương hiệu, ecosystem giờ chia sẻ đúng một từ khoá duy nhất: tìm trên npm, tìm trên GitHub, đọc trong package.json đều thấy "elysia".
Một điểm đáng chú ý khác: Elysia là dự án community-driven, không có corporate backing. Việc reclaim được npm scope @elysia (không bị squat) là thành tựu nho nhỏ cho community open source — và cho thấy npm organization policy đang khá thoáng với các dự án có reputation.
Technical facts
| Property | @elysiajs (cũ) | @elysia (mới) |
|---|---|---|
| Ví dụ package | @elysiajs/eden | @elysia/eden |
| Version mới nhất | 1.4.9 | 1.4.10 |
| Ngày publish đầu (eden) | Đã tồn tại từ lâu | 2026-04-23 |
| Status | Legacy, vẫn nhận patch | Primary, active development |
| Peer dep (eden) | elysia | elysia >=1.4.19 |
| End-of-life | Khi Elysia 2 ra mắt | — |
Elysia core hiện tại là v1.4.28 (release 16/03/2026), chạy trên Bun nhưng cũng hỗ trợ Node.js, Deno và Cloudflare Workers qua adapter. Validator support đa dạng: TypeBox, Zod, Valibot, ArkType, Effect thông qua Standard Schema.
Cách migrate dự án
Với dự án đang dùng scope cũ, bước migrate đơn giản:
- Mở
package.json, tìm mọi dependency bắt đầu bằng@elysiajs/. - Đổi prefix sang
@elysia/và bump lên version mới nhất tương ứng. - Xoá
bun.lock(hoặcpackage-lock.json) và chạy lạibun install. - Update import nếu có path cụ thể — phần lớn plugin chỉ
import { cors } from '@elysia/cors'style nên chỉ cần find-replace.
Ví dụ trước và sau:
// Trước
import { Elysia } from 'elysia'
import { cors } from '@elysiajs/cors'
import { swagger } from '@elysiajs/swagger'
// Sau
import { Elysia } from 'elysia'
import { cors } from '@elysia/cors'
import { swagger } from '@elysia/swagger'Lưu ý: không mix hai scope cho cùng một plugin trong cùng một dự án — có thể gây conflict type hoặc duplicate instance. Chọn một bên và unify toàn bộ.
Limitations & pricing
Elysia là open source, MIT license — không có pricing. Một vài caveat cần lưu ý:
- Chưa có ngày Elysia 2. SaltyAom chỉ nói "until Elysia 2 arrives", chưa ghim roadmap cụ thể. Dev không cần vội migrate đêm nay, nhưng cũng không nên trì hoãn vô thời hạn.
- Dependabot / Renovate chưa tự hiểu. Các bot update dependency sẽ không tự chuyển scope — cần config rule riêng hoặc migrate thủ công.
- Plugin third-party chưa chắc đã có bản
@elysia. Chỉ plugin official trong tổ chứcelysiajstrên GitHub mới được re-publish. Plugin cộng đồng giữ nguyên tên cũ của tác giả. - Tương thích version.
@elysia/eden@1.4.10yêu cầuelysia >=1.4.19— nếu bạn đang pin core version cũ hơn thì cần bump trước khi switch scope.
What's next
Ngắn hạn: các plugin còn lại trong ecosystem sẽ được re-publish dưới @elysia/*, giữ version đồng bộ với bản @elysiajs tương ứng. Trung hạn: khi Elysia 2 release, scope @elysiajs sẽ ngừng nhận patch mới và nên xem như deprecated.
Còn Elysia 2 sẽ mang gì? SaltyAom chưa công bố feature list chính thức, nhưng từ roadmap repo và các thread Discord gần đây, có thể đoán: API cleanup (breaking changes tồn đọng từ v1.x), universal runtime tốt hơn (Node/Deno/Cloudflare parity với Bun), và plugin API chuẩn hoá. Việc đặt nền móng scope npm trước là logical — không ai muốn debut major version với tên package nửa cũ nửa mới.
Với indie hacker và team nhỏ đang build API trên Bun, đây là thời điểm tốt để chạy một PR migration nhanh — ít hơn 30 phút cho dự án cỡ vừa, và giữ cho codebase "future-proof" khi Elysia 2 đổ bộ. Nếu bạn đang start dự án mới, dùng @elysia/* từ đầu là lựa chọn đúng.
Nguồn: SaltyAom on X, npm registry, elysiajs.com.
