Menambahkan TypeScript ke dalam proyek Express memberikan keuntungan besar berupa pengecekan tipe statis dan autocompletion yang lebih baik. Langkah pertama adalah menginstal dependensi yang dibutuhkan.

Kamu perlu menginstal Express, lalu menambahkan TypeScript dan tipe deklarasinya sebagai dependensi pengembangan (devDependencies). Paket tsx sangat berguna untuk menjalankan TypeScript langsung tanpa proses kompilasi manual saat masa pengembangan.

npm i express
npm i -D typescript tsx @types/node @types/express
npx tsc --init

Setelah itu, kamu perlu mengatur tsconfig.json. Pastikan kamu menggunakan target ECMAScript yang modern seperti ES2023 dan mengatur modul ke NodeNext. Ini sangat penting agar TypeScript memahami modul ES yang digunakan di Node.js terbaru.

Skrip package.json

Untuk memudahkan pengembangan, tambahkan skrip berikut di package.json:

"scripts": {
  "dev": "tsx watch src/server.ts",
  "build": "tsc",
  "start": "node dist/server.js"
}

TypeScript bersinar ketika kamu mulai mendefinisikan bentuk data yang masuk ke dalam API. Express menyediakan antarmuka generik Request yang menerima empat parameter tipe: Params, ResBody, ReqBody, dan Query.

Sebagai contoh, bila kamu ingin membuat endpoint untuk menambahkan buku, kamu bisa mendefinisikan bentuk body request terlebih dahulu:

import express, { type Request, type Response } from 'express';

interface CreateBookBody {
  title: string;
  author: string;
  year?: number;
}

const app = express();
app.use(express.json());

app.post('/api/books', (req: Request<{}, {}, CreateBookBody>, res: Response) => {
  const { title, author } = req.body; // Properti ini kini ter-type dengan aman
  res.status(201).json({ title, author });
});

Menambahkan Tipe Kustom pada Request

Seringkali, middleware menambahkan properti baru ke objek request, misalnya req.user setelah proses autentikasi berhasil. Agar TypeScript tidak mengeluh bahwa properti tersebut tidak ada, kamu harus memperluas tipe global dari Express.

Buat file deklarasi seperti src/types/express.d.ts:

declare global {
  namespace Express {
    interface Request {
      user?: { sub: number; role: string };
    }
  }
}
export {};

Dengan deklarasi ini, TypeScript akan mengenali properti user di seluruh aplikasi.

Setelah kodemu siap, saatnya membungkusnya agar bisa berjalan konsisten di server mana pun. Docker adalah standar industri untuk hal ini.

Dockerfile Multi-stage

Untuk mendapatkan ukuran image yang kecil dan efisien, gunakan metode multi-stage build. Tahap pertama digunakan untuk mengunduh seluruh dependensi, sedangkan tahap kedua hanya mengambil dependensi produksi dan kode aplikasi.

# Tahap 1: dependensi produksi
FROM node:24-alpine AS deps
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev

# Tahap 2: image akhir
FROM node:24-alpine
WORKDIR /app
ENV NODE_ENV=production
COPY --from=deps /app/node_modules ./node_modules
COPY . .
USER node
EXPOSE 3000
CMD ["node", "dist/server.js"]

Pastikan kamu menggunakan USER node alih-alih root untuk alasan keamanan. Jangan lupa menyiapkan file .dockerignore berisi node_modules, .env, .git, dan folder uploads agar file tidak penting tidak masuk ke dalam image.

Dalam dunia nyata, API Express biasanya tidak berjalan sendirian. Ia butuh layanan lain seperti database. Docker Compose memudahkan kita menjalankan banyak container sekaligus.

Buat file compose.yaml:

services:
  api:
    build: .
    ports: ["3000:3000"]
    env_file: .env
    depends_on: [db]
  db:
    image: postgres:17
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: secret
      POSTGRES_DB: appdb
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:

Satu hal yang perlu diingat, di dalam jaringan Docker Compose, host dari database adalah nama servisnya itu sendiri. Jadi, URL koneksimu akan menjadi postgresql://app:secret@db:5432/appdb.

Jalankan perintah docker compose up -d --build di terminal untuk membangun image dan menjalankan semua layanan di latar belakang.