Resumo
O Cloudflare CLI 1.0.0-beta.28 valida o limite de itens de corpos em array em vez de dividir a requisição em lotes. A versão imprime metadados de paginação no stderr, aceita vários arquivos em campos binários de multipart e faz a validação do --body antes da autenticação. Também corrige a leitura de validade de token com escopos restritos no cf auth whoami.
Novidades
- Cloudflare CLI 1.0.0-beta.28 — Limite de corpo em array: corpos JSON em array que ultrapassam o
maxItemsdo esquema da API são recusados, inclusive em entrada inline, arquivo e simulação. O envio automático em lotes sai de todos os métodos HTTP, e o limite interrompe a chamada em vez de alterar o sentido do comando ou perder resultados. - Cloudflare CLI 1.0.0-beta.28 — Superfície de comandos: a superfície de comandos gerada acompanha a publicação do Forge OpenAPI.
Melhorias
- Cloudflare CLI 1.0.0-beta.28 — Paginação no stderr: o
result_infoda API, com cursores e totais de página, é impresso no stderr, e a listagem pode ser percorrida com--cursorou com as flags de página do endpoint. O stdout continua igual para scripts, e--quietsuprime o aviso. - Cloudflare CLI 1.0.0-beta.28 — Multipart binário:
cf ai to-markdown --file caminhoenvia o arquivo no campofilesda API. A flag--files @primeiro.html @segundo.pdfaceita vários arquivos, e flags repetidas preservam bytes e nomes. - Cloudflare CLI 1.0.0-beta.28 — Metadados de confirmação: as flags
--forcee o alias-faparecem nas completions de shell e nos demais consumidores de metadados para comandos DELETE gerados e para operações que exigem confirmação. - Cloudflare CLI 1.0.0-beta.28 — Rótulos de ação: operações PUT e PATCH confirmadas mostram Updating e Updated, e ações POST confirmadas usam Processing e Done. Os avisos de cada operação e o comportamento de
--forcecontinuam iguais. - Cloudflare CLI 1.0.0-beta.28 — Descrição de
--body: comandos que enviam--bodycomotext/plainapresentam nos metadados a mesma descrição de--help, inclusive em tipos com parâmetros comotext/plain;charset=UTF-8. Sem descrição informada, os metadados e o--helpusam o texto de corpo simples. - Cloudflare CLI 1.0.0-beta.28 — Nomes de opção nos metadados: os metadados de opção passam pela normalização kebab-case do construtor de comandos, e as completions e o
cf toolsanunciam as flags aceitas pelos comandos existentes. - Cloudflare CLI 1.0.0-beta.28 — Dependências: são atualizadas as dependências publicadas pelo repositório Workers SDK em três levas, entre elas
@cloudflare/config0.30.2,@cloudflare/deploy-helpers0.26.0 eminiflare5.20261104.0-beta.
Correções
- Cloudflare CLI 1.0.0-beta.28 — Erros de uso: nomes de comando desconhecidos no primeiro e no segundo nível seguidos de
--helpou-hencerram com erro, com mensagem curta e indicação do--helpcorrespondente. Flags globais desconhecidas também listam as globais disponíveis. - Cloudflare CLI 1.0.0-beta.28 — Validade de token com escopo: o
cf auth whoamiconsulta a verificação do token para que endpoints restritos de detalhe de usuário e de account não façam um token ativo parecer inválido. Quando nenhuma verificação disponível resolve o estado, a saída informa validade desconhecida. - Cloudflare CLI 1.0.0-beta.28 —
--bodyantes da autenticação: os comandos analisam--bodye conferem o limite de itens antes de autenticar ou de mostrar confirmação. Corpo malformado ou arquivo@fileilegível falha de imediato, e--body ""em endpoint JSON é recusado como JSON inválido. - Cloudflare CLI 1.0.0-beta.28 — Corpo de texto obrigatório: comandos com corpo
text/plainobrigatório recusam a chamada sem--bodyou--fileantes da autenticação e da requisição. A mensagem de validação cita as duas opções de entrada.
Ponto de Atenção
A remoção do envio em lotes muda o comportamento de chamadas que dependiam da divisão automática em várias requisições, e a validação de --body antes do login faz o comando falhar mais cedo. Teste sugerido: envie um corpo em array acima do maxItems e confirme a recusa. Depois rode uma listagem longa com --quiet e sem a flag para comparar a saída de erro.
Notas da versão
As mudanças estão nas notas oficiais do Cloudflare CLI 1.0.0-beta.28, publicadas em 05/11/2026. A publicação é uma pré-release da linha 1.0.0.