Belajar ElysiaJS - Pre-Requisites Skill & Setup Environment

#Pendahuluan

Selamat datang di series Belajar ElysiaJS! Series ini akan membawa kalian menguasai ElysiaJS — framework backend TypeScript-first yang berjalan di atas runtime Bun — mulai dari fondasi konsep sampai production readiness. Total ada 21 episode yang tersusun dalam enam fase.

Sebelum menulis kode pertama, ada skill dasar dan perangkat lunak yang wajib kalian siapkan. Mengapa prasyarat ini penting? Karena ElysiaJS dibangun sepenuhnya dalam TypeScript dan mengandalkan type inference kuat dari TypeBox. Tanpa memahami tipe data, interface, dan generics dasar, kalian akan kesulitan memanfaatkan fitur paling powerful dari framework ini.

Episode 0 ini adalah peta jalan kalian: kita akan memastikan skill dasar terpenuhi, menyiapkan runtime Bun, editor, dan memverifikasi seluruh setup sebelum menulis kode pertama.

#Skill Dasar yang Wajib Dimiliki

#TypeScript: Tipe Data, Interface, dan Generics

ElysiaJS membangun seluruh sistem validasi dan routing di atas TypeBox — library yang menghasilkan JSON Schema dari definisi tipe TypeScript. Kalian wajib memahami interface, type alias, dan generics dasar karena ini adalah bahasa komunikasi utama antara route definition dan client.

interface User {
  id: number
  name: string
  email: string
}
 
function greet(user: User): string {
  return `Halo, ${user.name}`
}

Di ElysiaJS, setiap route akan otomatis menghasilkan tipe TypeScript untuk params, body, dan response — jadi kalian harus nyaman membaca dan memanfaatkan type inference.

#Konsep HTTP: Method, Status Code, dan Headers

ElysiaJS adalah framework HTTP, jadi kalian wajib memahami metode HTTP utama — GET, POST, PUT, DELETE, PATCH — serta status code seperti 200, 201, 400, 404, 422. Tanpa ini, kalian tidak akan mengerti mengapa ElysiaJS merespons dengan status tertentu atau bagaimana cara mengatur response headers.

#Dasar REST API: Endpoint, Routing, dan Middleware

REST API mengorganisir resource lewat URL dan HTTP method. Kalian perlu memahami konsep endpoint, path parameter, query string, request body, dan bagaimana middleware bekerja sebagai lapisan sebelum handler utama.

#Async/Await dan Promise di TypeScript

Semua handler di ElysiaJS mendukung async/await. Kalian harus nyaman menulis kode asynchronous — terutama untuk operasi database, file system, dan HTTP calls di dalam route handler.

#Perangkat Software yang Perlu Disiapkan

#Bun Runtime

ElysiaJS dibangun khusus untuk Bun — runtime JavaScript modern yang jauh lebih cepat dari Node.js. Install Bun:

curl -fsSL https://bun.sh/install | bash

Verifikasi instalasi dengan bun --version. Pastikan versi ≥ 1.3 — versi ini penting untuk kompatibilitas penuh dengan ElysiaJS. Jika sudah terinstall, jalankan bun upgrade untuk memastikan versi terbaru.

#VS Code dengan Ekstensi

Editor paling populer untuk ElysiaJS adalah VS Code. Pasang ekstensi berikut agar nyaman bekerja:

• Bun — runtime integration untuk menjalankan script
• Error Lens — menampilkan error inline di editor
• ESLint — linting otomatis untuk menjaga kualitas kode

#API Testing Tool

Untuk menguji endpoint, kalian bisa menggunakan salah satu dari:

• Bruno — API client open-source, ringan dan cepat
• Insomnia — alternatif populer dengan UI bersih
• Thunder Client — ekstensi VS Code untuk testing langsung di editor

Series ini akan menggunakan curl dan Bruno sebagai工具 utama testing.

#Setup Environment

#Menginstall Bun

Jika Bun belum terinstall atau versinya kurang dari 1.3:

curl -fsSL https://bun.sh/install | bash
bun --version

bun --version harus menampilkan versi 1.3 atau lebih baru. Jika kalian menggunakan Linux, pastikan juga build-essential atau gcc terinstall untuk keperluan kompilasi native modules.

#Konfigurasi VS Code

Buka VS Code dan pastikan ekstensi berikut aktif:

code --install-extension oven.bun-vscode
code --install-extension usernamehw.errorlens
code --install-extension dbaeumer.vscode-eslint

Atau install manual melalui panel Extensions di VS Code.

#Verifikasi Environment

Sebelum lanjut ke episode 1, jalankan verifikasi menyeluruh:

bun --version
bun --revision
which bun

bun --version harus mencetak versi ≥ 1.3. Jika semua perintah mengembalikan versi masing-masing, environment kalian sudah siap. Checklist lengkapnya:

• Bun ≥ 1.3 terinstall dan berfungsi.
• VS Code dengan ekstensi Bun, Error Lens, dan ESLint.
• API testing tool siap dipakai (Bruno, Insomnia, atau Thunder Client).
• Pemahaman dasar TypeScript, HTTP, dan async/await.

#Penutup

Episode 0 menyiapkan seluruh fondasi teknis sebelum menulis kode ElysiaJS: skill TypeScript, pemahaman HTTP/REST, async/await, runtime Bun, dan API testing tool. Semua elemen ini akan dipakai terus di seluruh series.

Inti yang harus dibawa pulang:

• ElysiaJS adalah framework TypeScript-first yang berjalan di atas runtime Bun.
• TypeScript dasar (interface, type alias, generics) adalah prasyarat wajib.
• Install Bun ≥ 1.3 dan pastikan berfungsi.
• Siapkan VS Code dengan ekstensi yang sesuai.
• Verifikasi environment sebelum melanjutkan.

Di episode 1 selanjutnya kita akan membahas sejarah, latar belakang, dan mengapa ElysiaJS — dari evolusi backend JavaScript/TypeScript, lahirnya ElysiaJS sebagai solusi type-safe end-to-end, hingga perbandingannya dengan Express, Fastify, dan NestJS. Pastikan environment kalian sudah siap, karena perjalanan Belajar ElysiaJS baru saja dimulai!