Bun com Claude Code

Acelerando o Uso do Runtime Bun com Claude Code

O Bun é um runtime all-in-one para JavaScript/TypeScript. Possui gerenciador de pacotes, bundler e test runner integrados, e funciona várias vezes mais rápido que o Node.js. Use o Claude Code para introduzir eficientemente os recursos poderosos do Bun.

Iniciando o Projeto

> Crie um novo projeto de web app com Bun.
> Com TypeScript, framework Hono e configuração de testes.

bun init my-app
cd my-app
bun add hono

// src/index.ts
import { Hono } from 'hono';
import { cors } from 'hono/cors';
import { logger } from 'hono/logger';

const app = new Hono();

app.use('*', logger());
app.use('/api/*', cors());

app.get('/api/health', (c) => {
  return c.json({ status: 'ok', runtime: 'bun' });
});

app.get('/api/users/:id', async (c) => {
  const id = c.req.param('id');
  const user = await getUser(id);
  return c.json(user);
});

export default {
  port: 3000,
  fetch: app.fetch,
};

Aproveitando as APIs Integradas do Bun

> Implemente um data store simples usando a API de arquivos do Bun e SQLite.

// src/db.ts
import { Database } from 'bun:sqlite';

const db = new Database('app.db', { create: true });

db.run(`
  CREATE TABLE IF NOT EXISTS users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    email TEXT UNIQUE NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
  )
`);

export const createUser = db.prepare(
  'INSERT INTO users (name, email) VALUES ($name, $email)'
);

export const getUser = db.prepare(
  'SELECT * FROM users WHERE id = $id'
);

// Operações de arquivo do Bun
export async function saveUpload(file: File) {
  const path = `./uploads/${file.name}`;
  await Bun.write(path, file);
  return path;
}

export async function readConfig() {
  const file = Bun.file('./config.json');
  return await file.json();
}

Executando Testes

O Bun tem um test runner rápido integrado.

> Escreva testes para os endpoints da API.
> Use o test runner do Bun.

// src/index.test.ts
import { describe, expect, it, beforeAll, afterAll } from 'bun:test';

describe('API endpoints', () => {
  it('GET /api/health retorna ok', async () => {
    const res = await fetch('http://localhost:3000/api/health');
    const data = await res.json();
    expect(res.status).toBe(200);
    expect(data.status).toBe('ok');
  });

  it('GET /api/users/:id retorna usuário', async () => {
    const res = await fetch('http://localhost:3000/api/users/1');
    expect(res.status).toBe(200);
    const user = await res.json();
    expect(user).toHaveProperty('name');
  });
});

# Executar testes
bun test

# Modo watch
bun test --watch

# Coverage
bun test --coverage

Bundling e Build

> Faça o bundle do código frontend com Bun.
> Com tree-shaking e minificação habilitados.

// build.ts
await Bun.build({
  entrypoints: ['./src/client/index.tsx'],
  outdir: './dist',
  target: 'browser',
  minify: true,
  splitting: true,
  sourcemap: 'external',
  define: {
    'process.env.NODE_ENV': '"production"',
  },
});

console.log('Build concluído!');

Resumo

O Bun melhora significativamente a experiência de desenvolvimento com sua velocidade superior e toolchain integrada. Combinado com o Claude Code, você pode aprender rapidamente APIs e patterns específicos do Bun. Consulte também o guia de desenvolvimento de API e estratégias de teste.

Para detalhes sobre o Bun, consulte a documentação oficial do Bun.