Geração de código com IA em TypeScript: do prompt à produção

Por que a geração de código com IA não é moda, mas a nova realidade do desenvolvedor TypeScript

Vamos ser sinceros: há alguns anos, a frase "a IA escreveu meu código de produção" soava como ficção científica. Hoje, é rotina. O TypeScript, com sua tipagem forte e ecossistema rico, tornou-se o terreno ideal para a geração de código com IA. A IA não apenas insere esqueletos de código — ela gera tipos, interfaces, requisições a APIs e até middlewares completos.

Neste artigo, não vamos discutir se "a IA vai substituir programadores". Vamos arregaçar as mangas e ver como integrar a geração de código com IA em TypeScript no seu fluxo de trabalho real. Sem enrolação, com exemplos, prompts e as armadilhas que já enfrentamos.

Como a IA ajuda a gerar código TypeScript: três cenários

Antes de mergulharmos no código, vamos entender onde a geração de código TypeScript por IA oferece o maior ganho de produtividade. Identifico três cenários principais que cobrem 90% das tarefas no desenvolvimento comercial.

1. Autocomplete e refatoração "em tempo real"

IDEs modernas com plugins como GitHub Copilot ou Tabnine já conseguem prever seu próximo passo. Mas a mágica acontece quando você escreve a assinatura de uma função — e a IA gera o corpo do método, levando em conta os tipos dos argumentos. Isso é especialmente poderoso no TypeScript, onde o contexto dos tipos permite que o modelo produza código seguro de primeira.

// Exemplo: escrevendo um prompt no Copilot\n// "Crie uma função de paginação com parâmetros tipados"\n\ninterface PaginationParams<T> {\n  page: number;\n  limit: number;\n  sortBy?: keyof T;\n  order?: 'asc' | 'desc';\n}\n\nasync function fetchPaginated<T>(\n  url: string,\n  params: PaginationParams<T>\n): Promise<{ data: T[]; total: number }> {\n  // O Copilot gerará:\n  const query = new URLSearchParams({\n    page: String(params.page),\n    limit: String(params.limit),\n    ...(params.sortBy && { sortBy: String(params.sortBy) }),\n    ...(params.order && { order: params.order }),\n  });\n  const response = await fetch(`${url}?${query}`);\n  if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);\n  return response.json();\n}

Observe: a IA inseriu automaticamente keyof T e tratou corretamente os campos opcionais. Isso economiza minutos que você gastaria pensando no tipo.

2. Geração de código boilerplate a partir de especificações

O segundo cenário é quando você tem uma descrição da tarefa em linguagem natural e quer um módulo pronto. Aqui usamos a API da OpenAI para gerar código TypeScript. A melhor abordagem é fornecer contexto à modelo: tipos existentes, estilo de código e nomenclatura.

// Exemplo de prompt para GPT-4:\n// "Escreva uma função TypeScript que receba um array de usuários\n// e retorne estatísticas de idade. Use readonly e satisfies."\n\ntype User = {\n  name: string;\n  age: number;\n  isActive: boolean;\n};\n\ntype AgeStats = {\n  min: number;\n  max: number;\n  average: number;\n  median: number;\n};\n\nfunction getAgeStats(users: readonly User[]): AgeStats satisfies Record<string, number> {\n  const ages = users.map(u => u.age).sort((a, b) => a - b);\n  const sum = ages.reduce((acc, val) => acc + val, 0);\n  const mid = Math.floor(ages.length / 2);\n\n  return {\n    min: ages[0],\n    max: ages[ages.length - 1],\n    average: sum / ages.length,\n    median: ages.length % 2 === 0\n      ? (ages[mid - 1] + ages[mid]) / 2\n      : ages[mid],\n  };\n}

Ponto-chave: pedimos explicitamente readonly e satisfies — recursos modernos do TypeScript. A IA os conhece e os utiliza quando solicitado. Sem essa instrução explícita, o modelo pode retornar um código JS "genérico".

3. Integração da geração por IA no pipeline CI/CD

O nível mais avançado é quando a geração de código acontece automaticamente