A Cloudflare anunciou o Forge, um pipeline de código aberto e extensível para gerar pacotes SDK, ferramentas de linha de comando, documentação e bibliotecas diretamente de definições de APIs. O Forge funciona em ambientes de integração contínua, ou CI, e pode ser executado gratuitamente e de forma autônoma, em vez de depender de um serviço SaaS hospedado.
O projeto surge em resposta à necessidade da Cloudflare de gerenciar uma API que inclui mais de 3.500 operações e é apoiada por centenas de serviços escritos em linguagens que incluem Rust, Go, TypeScript e Python. A empresa afirma que o Forge atualmente gera as saídas necessárias para a ferramenta cf CLI, e que seu uso deverá se estender nos próximos meses à documentação da Cloudflare, aos pacotes SDK e a outros recursos.
Pré-visualizações para cada alteração
O Forge funciona dentro dos repositórios das equipes de produto, onde examina cada alteração e depois cria versões de pré-visualização da ferramenta CLI, da documentação e dos pacotes SDK, destacando as modificações resultantes. As equipes podem instalar essas versões e testá-las antes de integrar uma alteração da API ou disponibilizá-la aos clientes.
Esse mecanismo tem como alvo um problema prático em ambientes nos quais a API está distribuída por centenas de serviços e repositórios: uma única alteração pode interromper o processo de geração, e a equipe afetada só descobre o problema no momento do lançamento. Já executar a geração antecipadamente dentro do CI transfere a validação para uma etapa mais próxima da origem da alteração e reduz a coordenação necessária entre as equipes.
Geração de saídas interligadas
O Forge não se limita aos destinos tradicionais de linguagens. O projeto pode receber uma definição OpenAPI e gerar saídas como Cap’n Web, um sistema RPC da Cloudflare que permite chamar APIs remotas de TypeScript de maneira semelhante à chamada de funções locais. A empresa também aponta a possibilidade de usar a mesma abordagem para criar integrações com TanStack Query, esquemas Zod ou Valibot e servidores MCP.
O Forge baseia-se em transformadores encadeáveis, de modo que uma saída pode ser usada para produzir outra saída. Atualmente, ele oferece suporte a OpenAPI como tipo de entrada, com um design que permite adicionar AsyncAPI, GraphQL, Cap’n Proto e Protobuf futuramente. O usuário também pode definir a cadeia de geração, em vez de ser obrigado a seguir um caminho fixo, algo importante quando uma ferramenta CLI é construída em uma linguagem diferente da usada no pacote SDK ou quando a ferramenta contém comandos escritos manualmente.
O que muda na prática?
O Forge apresenta um modelo que torna as ferramentas de consumo de APIs parte do próprio ciclo de desenvolvimento da interface, e não produtos separados que são atualizados posteriormente. Isso beneficia as equipes que precisam manter SDK, documentação e CLI sincronizados, mas não elimina a necessidade de revisar as saídas geradas, especialmente quando a ferramenta combina código gerado com comandos ou comportamentos escritos manualmente.
A Cloudflare também relaciona o projeto aos seus planos para gerenciar versões de APIs. Após uma década usando a versão principal v4, a empresa afirma que está trabalhando em uma abordagem que permita lançar novas versões principais sem quebrar clientes ou pacotes SDK antigos. O material não informou detalhes dessa abordagem nem um cronograma para sua implementação.
Licença aberta e limites da fase atual
O Forge está disponível sob a licença Apache 2.0 e pode ser executado, modificado e usado internamente ou de forma privada sem custos. A Cloudflare descreve o projeto como ainda estando em uma fase inicial, apesar de já ser usado para gerar saídas do cf CLI, e prometeu fornecer posteriormente detalhes sobre os SDKs de TypeScript, Rust, Python, Go, PHP e Terraform, com uma menção especial aos requisitos de migração no provedor do Terraform.