Dibangun untuk Tim

Deserve menjaga struktur aplikasi tetap jelas, jadi sebuah tim membaca pohon folder dan langsung tahu API-nya. Tidak ada tabel rute pusat untuk dipelajari dan tidak ada konfigurasi khusus framework untuk dikuasai lebih dulu. Ini mengikuti filosofi bahwa struktur file adalah struktur API, yang menjaga basis kode mudah dirawat oleh tim.

Folder Adalah Peta

Kontributor baru membuka folder routes dan membaca endpoint langsung dari path-nya:

routes/
├── index.ts            # GET  /
├── health.ts           # GET  /health
├── users/
│   ├── index.ts        # GET  /users
│   ├── [id].ts         # GET  /users/:id
│   └── [id]/
│       └── posts.ts    # GET  /users/:id/posts
└── orders/
    └── index.ts        # POST /orders

Tidak ada registry untuk dicek silang, tidak ada decorator untuk dilacak. Path di disk adalah path di jaringan, dibahas di File-based Routing.

Junior Merilis di Hari Pertama

Menambah endpoint berarti menambah berkas. Developer junior yang butuh rute GET /products membuat routes/products/index.ts dan mengekspor sebuah handler:

// routes/products/index.ts
import type { Context } from '@neabyte/deserve'

// Endpoint baru, tanpa registrasi
export function GET(ctx: Context): Response {
  return ctx.send.json({
    products: []
  })
}

Rute langsung aktif pada simpan berikutnya lewat Hot Reload, tanpa restart dan tanpa mengedit berkas config bersama yang bisa memicu konflik merge.

Handler yang Dapat Ditebak

Setiap berkas rute mengikuti bentuk yang sama, jadi mereview kode rekan tim tidak perlu menebak. Nama fungsi yang diekspor adalah metode HTTP, dan Context memberi request serta helper response:

// routes/orders/index.ts
import type { Context } from '@neabyte/deserve'

// Nama metode adalah verb HTTP
export async function POST(ctx: Context): Promise<Response> {
  // Baca body JSON yang sudah diparsing
  const order = await ctx.get.body()
  return ctx.send.json(
    {
      created: true,
      order
    },
    { status: 201 }
  )
}

Reviewer membaca POST dan tahu verb-nya, membaca ctx.get.body() dan tahu input-nya, membaca ctx.send.json() dan tahu output-nya. Pola yang sama berlaku di setiap berkas, yang merupakan pengalaman pengembang yang dituju framework. Detail ada di Request Handling dan Objek Context.

Aturan Bersama di Satu Tempat

Urusan yang berlaku lintas rute tinggal di satu titik alih-alih tersebar di seluruh handler. Satu developer bisa memegang auth, yang lain memegang logging, dan tidak ada yang perlu menyentuh berkas rute orang lain:

// main.ts
import { Mware, Router } from '@neabyte/deserve'

const router = new Router()

// Security headers untuk setiap rute
router.use(Mware.securityHeaders())

// Auth hanya untuk area admin
router.use(
  '/admin',
  Mware.basicAuth({
    users: [
      {
        username: 'admin',
        password: Deno.env.get('ADMIN_PASSWORD') ?? 'change-me'
      }
    ]
  })
)

await router.serve(8000)

Handler tetap fokus pada tugasnya sendiri, sementara perilaku bersama diterapkan sekali. Set lengkap blok penyusunnya ada di Global Middleware, dan error mengalir ke satu tempat lewat penanganan error. Aturan input juga ada di sini, tempat kontrak validasi memeriksa request sebelum handler sehingga tiap rute hanya membaca data yang sudah lolos.

Banyak Tangan, Satu Proses

Tim yang lebih besar sering memecah aplikasi menjadi beberapa service. Deserve menjalankan beberapa router dalam satu proses, jadi satu orang bisa mengerjakan API sementara yang lain mengerjakan auth tanpa deployment terpisah atau lapisan jaringan di antara keduanya:

// main.ts
import { Router } from '@neabyte/deserve'

const api = new Router({
  routes: { directory: './services/api/routes' }
})
const auth = new Router({
  routes: { directory: './services/auth/routes' }
})

// Tiap service punya folder dan port
await Promise.all([
  api.serve(3001),
  auth.serve(3002)
])

Tiap service punya folder, port, dan file watcher sendiri, jadi tim bergerak paralel tanpa saling mengganggu. Pola lengkapnya, termasuk kode bersama dan error handler bersama, ada di Multi-Service.

Langkah Berikutnya

• File-based Routing - cara folder memetakan ke URL
• Hot Reload - perubahan aktif tanpa restart
• Multi-Service - banyak service dalam satu proses
• Filosofi - pemikiran di balik desain