cURL a TypeScript

Daniel Stenberg lançou o cURL em 1998, começando como um projeto pessoal chamado `httpget` para baixar cotações de moeda. O nome foi evoluindo — primeiro `urlget`, depois `curl` — uma abreviação de Client URL que ficou para sempre. Hoje o curl está instalado em praticamente todo servidor Linux, Mac, Android e Windows moderno, com estimativas que apontam para mais de 20 bilhões de instalações ativas. Isso o torna provavelmente o software de linha de comando mais ubíquo do mundo. A sintaxe de flags que usamos hoje — `-H` para headers, `-d` para o corpo da requisição, `-X` para o método HTTP, `-u` para autenticação básica — foi estabelecida nas primeiras versões e sobreviveu mais de 25 anos sem grandes mudanças. Quando uma interface funciona assim bem, ela simplesmente fica.

O TypeScript foi anunciado por Anders Hejlsberg na Microsoft em outubro de 2012, como resposta a um problema real: desenvolver aplicações JavaScript de grande escala era doloroso sem tipagem estática. Hejlsberg não era nenhum novato nesse território — havia criado o Turbo Pascal aos 20 anos, depois o Delphi, depois o C#, e então o TypeScript. A API `fetch`, que substituiu o `XMLHttpRequest` como a forma moderna de fazer requisições HTTP no browser e no Node.js, retorna Promises e aceita um objeto com `method`, `headers` e `body`. Em TypeScript, você pode tipar a resposta esperada: `const data = await response.json() as MeuTipo`, o que torna o código autocompletável e mais seguro durante o desenvolvimento — o compilador avisa quando você tenta acessar uma propriedade que não existe no tipo declarado.

Na prática diária de quem consome APIs, a documentação quase sempre vem com um exemplo em curl — é o formato universal que todos os provedores usam, do Stripe ao GitHub. Mas quando você está desenvolvendo em TypeScript, precisa traduzir esse curl manualmente para código compatível. Isso envolve converter os headers de `-H 'Content-Type: application/json'` para um objeto JavaScript, o corpo de `--data` para o campo `body` da requisição, e o método de `-X POST` para `method: 'POST'`. Este conversor automatiza esse trabalho e gera um snippet pronto para colar em qualquer projeto TypeScript, React, Next.js ou Deno. O resultado usa `fetch` nativo, mas é simples adaptá-lo para Axios ou ky se você preferir uma biblioteca com retry automático e interceptors.

Daniel Stenberg launched cURL in 1998, starting as a personal project called `httpget` to download currency exchange rates. The name evolved — first `urlget`, then `curl` — short for Client URL, and it stuck. Today curl is installed on virtually every Linux server, Mac, Android device, and modern Windows system, with estimates suggesting over 20 billion active installations. That makes it arguably the most ubiquitous command-line software in the world. The flag syntax we use today — `-H` for headers, `-d` for the request body, `-X` for the HTTP method, `-u` for basic auth — was established in the early versions and has survived more than 25 years without major changes. When an interface works that well, it just stays.

TypeScript was announced by Anders Hejlsberg at Microsoft in October 2012, as a response to a real problem: developing large-scale JavaScript applications was painful without static typing. Hejlsberg was no newcomer to that territory — he had created Turbo Pascal at age 20, then Delphi, then C#, and then TypeScript. The `fetch` API, which replaced `XMLHttpRequest` as the modern way to make HTTP requests in browsers and Node.js, returns Promises and accepts an object with `method`, `headers`, and `body`. In TypeScript, you can type the expected response: `const data = await response.json() as MyType`, which makes the code autocomplete-friendly and safer during development — the compiler warns you when you try to access a property that does not exist in the declared type.

In the daily work of consuming APIs, documentation almost always comes with a curl example — it is the universal format every provider uses, from Stripe to GitHub. But when you are developing in TypeScript, you need to manually translate that curl into compatible code. This involves converting headers from `-H 'Content-Type: application/json'` into a JavaScript object, the body from `--data` into the request's `body` field, and the method from `-X POST` into `method: 'POST'`. This converter automates that work and generates a snippet ready to paste into any TypeScript, React, Next.js, or Deno project. The output uses native `fetch`, but adapting it to Axios or ky is straightforward if you prefer a library with built-in retry and interceptors.

Daniel Stenberg lanzó cURL en 1998, empezando como un proyecto personal llamado `httpget` para descargar tipos de cambio. El nombre fue evolucionando — primero `urlget`, luego `curl` — una abreviatura de Client URL que se quedó para siempre. Hoy curl está instalado en prácticamente todos los servidores Linux, Mac, dispositivos Android y sistemas Windows modernos, con estimaciones que apuntan a más de 20.000 millones de instalaciones activas. Eso lo convierte posiblemente en el software de línea de comandos más ubicuo del mundo. La sintaxis de flags que usamos hoy — `-H` para headers, `-d` para el cuerpo de la petición, `-X` para el método HTTP, `-u` para autenticación básica — se estableció en las primeras versiones y ha sobrevivido más de 25 años sin grandes cambios. Cuando una interfaz funciona así de bien, simplemente se queda.

TypeScript fue anunciado por Anders Hejlsberg en Microsoft en octubre de 2012, como respuesta a un problema real: desarrollar aplicaciones JavaScript a gran escala era doloroso sin tipado estático. Hejlsberg no era ningún novato en ese terreno — había creado Turbo Pascal a los 20 años, luego Delphi, luego C# y después TypeScript. La API `fetch`, que sustituyó a `XMLHttpRequest` como la forma moderna de hacer peticiones HTTP en el navegador y en Node.js, devuelve Promises y acepta un objeto con `method`, `headers` y `body`. En TypeScript, puedes tipar la respuesta esperada: `const data = await response.json() as MiTipo`, lo que hace el código más amigable con el autocompletado y más seguro durante el desarrollo — el compilador te avisa cuando intentas acceder a una propiedad que no existe en el tipo declarado.

En el trabajo diario de consumir APIs, la documentación casi siempre viene con un ejemplo en curl — es el formato universal que todos los proveedores usan, desde Stripe hasta GitHub. Pero cuando estás desarrollando en TypeScript, necesitas traducir ese curl manualmente a código compatible. Esto implica convertir los headers de `-H 'Content-Type: application/json'` a un objeto JavaScript, el cuerpo de `--data` al campo `body` de la petición, y el método de `-X POST` a `method: 'POST'`. Este conversor automatiza ese trabajo y genera un snippet listo para pegar en cualquier proyecto TypeScript, React, Next.js o Deno. El resultado usa `fetch` nativo, pero adaptarlo a Axios o ky es sencillo si prefieres una librería con retry automático e interceptores integrados.