> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Changelog
> Descubra as últimas novidades e melhorias na Square Cloud. Acompanhe os lançamentos de produtos, otimizações de performance e muito mais.
## 🔗 Webhooks git
* **Tags e branches excluídas não bloqueiam mais um deploy:** o push de uma tag (ou de qualquer ref que não seja uma branch) e o push que exclui uma branch são respondidos com `202` e nunca publicados, e não gastam mais o limite de 1 push a cada 15 segundos do webhook. Um release enviado com `git push --follow-tags`, ou um pull request mergeado com a branch excluída automaticamente, não segura mais o deploy do push da branch que chega junto.
* **A resposta diz o motivo:** ela começa com `GIT_REF_NOT_SUPPORTED` ou `GIT_BRANCH_DELETED`, visível no GitHub em **Settings > Webhooks > Recent Deliveries**. Veja [Entregas do webhook](/pt-br/api-reference/endpoint/apps/deploy/webhooks#entregas-do-webhook).
## ⚙️ Aplicações
* **Iniciar, parar e reiniciar durante uma restauração:** enquanto uma restauração de snapshot roda em uma aplicação (até cerca de 2 minutos), essas ações agora respondem `403 RESTORE_IN_PROGRESS` na hora, em vez de esperar e depois falhar. Aguarde a restauração terminar e tente de novo.
## 🔌 AI Gateway: quando tentar de novo
* **`Retry-After` nos limites:** `429 rate_limit_exceeded` traz o intervalo do plano, então os SDKs da OpenAI esperam e tentam de novo sozinhos, e `503 server_overloaded` pede 2 segundos. Os limites diário e semanal, e `503 daily_capacity_reached`, trazem o tempo até o reset e `x-should-retry: false`, então os SDKs param de repetir requisições que só falhariam de novo. Veja [Novas tentativas](/pt-br/api-reference/ai-gateway#novas-tentativas).
## 🤖 Cubic: limites maiores
* **Limites diários maiores em todos os planos:** Hobby 5M de tokens (eram 2M), Standard 10M a 20M (eram 5M a 10M), Pro 30M a 40M (eram 15M) e Enterprise 50M a 100M (eram 25M a 50M).
* **Novo limite semanal** de 4x o diário, renovado na segunda-feira às 00:00 UTC. Um dia de uso pesado não é problema: só o uso perto do máximo em quase todos os dias da semana chega nele. Quando isso acontece, o Cubic responde `AI_WEEKLY_LIMIT_REACHED` até a renovação.
## 🔌 AI Gateway: limites próprios
* **Separado do Cubic:** as requisições ao gateway agora contam só nos limites de tokens do próprio gateway, então uma chave de API nunca consome o seu limite do Cubic, e vice-versa.
* **Limites de tokens por plano:** Standard 2,5M de tokens por dia, Pro 5M e Enterprise 10M a 20M conforme o tamanho do plano, cada um com um limite semanal de 4x, renovado na segunda-feira às 00:00 UTC. O novo `429 weekly_limit_reached` diferencia o limite semanal do diário `daily_limit_reached`. Veja [Planos e limites](/pt-br/api-reference/ai-gateway#planos-e-limites).
* **Cota de uso justo recalibrada:** o Pro agora tem 2x a cota base e o Enterprise, 5x.
## 💻 Square Cloud CLI
* **Login pelo navegador:** `squarecloud auth login` mostra um código e abre a página de autorização. Aprove e a CLI recebe a própria chave de API, limitada às permissões que ela usa e válida por 90 dias. Para scripts e CI, use `--token`, `--with-token` ou a variável de ambiente `SQUARECLOUD_API_KEY`. Veja [Autenticação](/pt-br/cli-reference/authentication).
* **`squarecloud.ignore` com regras reais do gitignore**, o mesmo arquivo que a extensão do VS Code lê: `!` para incluir de volta, `**` e padrões só de pasta ou só da raiz. Veja o [guia do squarecloud.ignore](/pt-br/getting-started/squarecloud-ignore).
* **Oito idiomas:** alemão, francês, italiano e japonês se juntam ao inglês, português, espanhol e chinês. A ajuda e as descrições das flags também são traduzidas, e o idioma segue o do sistema a cada execução.
* **Transferências mais confiáveis:** uploads e commits grandes não são mais cortados depois de 30 segundos, o `app realtime` continua conectado, e `app file write`, `app file read` e `app file delete` funcionam com qualquer arquivo, inclusive binário.
* **Novidades:** `app env remove --all`, `--json` em `app logs`, `upload` e `auth whoami`, confirmação antes de `app file read -o` sobrescrever um arquivo local, e dicas claras quando a chave expirou ou um rate limit foi atingido.
* **Instalação:** o script de instalação confere os checksums da release e suporta x86 de 32 bits e ARMv7, e o pacote npm instala em arm64 e ARMv7. Atualize com `npm install -g @squarecloud/cli@latest`.
**Leia antes de atualizar jobs de CI.** A seção [Scripts e CI](/pt-br/cli-reference/global-flags-and-ci#scripts-e-ci) tem os detalhes.
* Comandos que pedem confirmação saem com código 1 quando não há terminal nem `-y`, em vez de não fazer nada. Passe `-y`.
* `auth login` não pede mais a chave. Em scripts, defina `SQUARECLOUD_API_KEY` ou use `auth login --with-token` ou `--token `.
* Mais falhas saem com código 1, e a instalação via npm agora repassa o código de saída real. Confira o código de saída, não o texto da mensagem.
* Comandos sem saída JSON recusam `--json`, e `app logs --json` imprime `{"logs": "..."}`.
* Erros, perguntas e o aviso de atualização vão para o stderr, e o `app realtime` imprime as linhas de log como vieram, com `[status] ` só quando o status muda.
* Os cabeçalhos das tabelas são traduzidos em sistemas que não estão em inglês: leia o `--json`, ou rode com `LC_ALL=en_US.UTF-8`.
* `package-lock.json`, `pnpm-lock.yaml` e `yarn.lock` não são mais enviados por padrão: adicione `!package-lock.json` (ou o seu lockfile) ao `squarecloud.ignore` para mantê-lo. Os padrões seguem as regras do gitignore, então revise regras que dependiam de casar pelo final do nome.
* `app env replace` precisa de pelo menos uma variável (use `app env remove --all -y` para apagar todas), e com `--from-file` um valor sem aspas termina em ` #`.
* `locale` no arquivo de configuração é ignorado: o idioma segue o do sistema, ou `LC_ALL`/`LANG`.
## 🧩 Extensão do VS Code
A extensão agora tem [documentação própria](/pt-br/vscode-extension/installation): instalação, recursos, comandos e solução de problemas.
* **Guia de primeiros passos:** `Square Cloud: Primeiros passos` abre um guia de dez passos (conectar, arquivo de configuração, upload e commit, logs e métricas, snapshots, bancos de dados, workspaces, deploys pelo GitHub e analytics da edge) com botões que rodam os comandos de verdade.
* **Login e dashboard redesenhados** com a cara da Square Cloud: um login passo a passo que explica cada permissão, skeletons durante o carregamento, estados vazios e de erro ilustrados, paginação e filtro para listas longas de aplicações, e suporte completo a teclado e alto contraste.
* **Oito idiomas**, como o site da Square Cloud.
* **Pela paleta de comandos:** as ações de aplicações e bancos de dados perguntam qual usar, e os seletores mostram só o que faz sentido (Iniciar lista as aplicações que não estão rodando).
* **SDK oficial de JavaScript v6** por baixo: a extensão mostra os códigos e mensagens reais de erro da API, tem timeout nas chamadas e só repete o que é seguro repetir.
* **Mesmo arquivo de ignore da CLI:** `squarecloud.ignore` com sintaxe do gitignore e os mesmos padrões. O `.gitignore` não é mais lido no lugar dele, e uma `\` torna o próximo caractere literal.
* **Correções:** uma autorização expirada pede para conectar de novo, o restore de snapshot usa os identificadores da própria listagem, snapshots são gravados direto no disco, excluir mantém a aplicação quando o snapshot de recuperação ainda está sendo gerado, e as métricas de 24h mostram a RAM corretamente.
## 🧰 SDKs reescritos do zero
Os SDKs de JavaScript, Python e Go ganharam novas versões major, reescritas para a API atual. Os três cobrem as mesmas **67 operações**, mais o download de snapshots, têm a mesma estrutura e os mesmos exemplos, e **não têm dependências**. A [documentação dos SDKs](/pt-br/sdks/introduction) foi reescrita para eles.
| SDK | Versão | Guia de migração |
| - | - | - |
| `@squarecloud/api` | 6.0.0 (Node.js 22+, Deno, Bun, edge) | [v5 → v6](/pt-br/sdks/js/migrating_to_v6) |
| `squarecloud-api` | 5.0.0 (Python 3.11+) | [v4 → v5](/pt-br/sdks/py/migrating_to_v5) |
| `github.com/squarecloudofc/sdk-api-go/v3` | 3.0.0 (Go 1.22+) | [v2 → v3](/pt-br/sdks/go/migrating_to_v3) |
| `@squarecloud/blob` | 4.0.0 (Node.js 20+ e navegadores) | [v3 → v4](/pt-br/sdks/blob/migrating_to_v4) |
**Estas versões quebram compatibilidade.** Os métodos agora recebem o id primeiro e devolvem os dados da própria API (sem classes, sem cache, sem eventos), e toda falha é um único tipo de erro com o `status` HTTP, o `code` da API e a `message` do servidor. Leia o guia de migração antes de atualizar.
* **Um tipo de erro por SDK:** `SquareCloudAPIError` (JavaScript e Python) e `*APIError` (Go). Os códigos que o SDK inventava foram removidos: chave expirada é `401 ACCESS_DENIED`, e uma resposta sem código é `UNKNOWN_ERROR` com o status real.
* **Timeouts:** 30 segundos por padrão, e pelo menos 120 segundos nas chamadas que o servidor segura (start, stop, restart, snapshots, criação de banco e IA).
* **Retries só quando é seguro:** erros de rede em `GET` e `503 UPLOAD_BUSY`/`ANALYTICS_BUSY`, com backoff. Um `429` nunca é repetido.
* **Novidades nos três:** chat do [AI Gateway](/pt-br/api-reference/ai-gateway), analytics de rede, logs e status em tempo real com reconexão automática, deploys pelo GitHub App com chave de API, uploads e downloads de snapshot em streaming, e apps compartilhados por workspace (`-`).
* **Python:** um cliente síncrono `SquareCloud` e um assíncrono `AsyncSquareCloud`, usando só a biblioteca padrão. O cache de apps e os listeners foram removidos.
* **Go:** `context` em toda chamada, e a licença agora é MIT.
## 🗂️ SDK do Blob v4
* A nova [documentação do SDK do Blob](/pt-br/sdks/blob/client) cobre uploads, objetos, links, compartilhamentos, regras, estatísticas e o gateway S3.
* Um `429` nunca é repetido, e escritas têm uma tentativa só. Leituras e partes de upload em partes são repetidas em erros de rede e em qualquer `5xx`.
* `maxRetries` agora tem padrão `2` (era `5`) e o backoff tem teto de 8 segundos. Passe `{ maxRetries: 5 }` para manter o orçamento de leitura antigo.
## 🛡️ API e Blob Storage
**Se o seu código verifica `RATE_LIMIT` ou `RATE_LIMIT_EXCEEDED`, troque para `RATE_LIMITED`.** O limite de requisições da conta ou da chave de API e o bloqueio temporário por chaves inválidas na [API](/pt-br/api-reference/authentication), as rotas de [rede](/pt-br/api-reference/endpoint/apps/network/analytics), o [`GET /v2/users/snapshots`](/pt-br/api-reference/endpoint/users/snapshots) e o limite da conta e o bloqueio por credenciais inválidas no [Blob Storage](/pt-br/blob-reference/errors) agora respondem `429 RATE_LIMITED`. `KEEP_CALM` e os outros códigos `429` não mudam.
* **Start e stop de banco de dados:** quando o cluster recusa a ação, [start](/pt-br/api-reference/endpoint/databases/start) e [stop](/pt-br/api-reference/endpoint/databases/stop) agora respondem `409` com o código do erro (`CONTAINER_ALREADY_STARTED`, `CONTAINER_ALREADY_STOPPED`, `CONTAINER_TEMPORARILY_SUSPENDED` ou `ACTION_FAILED`), em vez de `200` com `status: "error"`.
* **Start, stop e restart de aplicação:** o corpo do `409` traz só `status` e `code`, e uma falha de comunicação com o cluster responde `ACTION_FAILED`.
* **Criação de banco de dados:** `memory` precisa ser um número inteiro de MB. Decimal ou string responde `400 INSUFFICIENT_MEMORY`.
* **AI Gateway:** uma requisição que passa de **90 segundos** no total responde `503 server_overloaded` e pode ser repetida. Veja a [tabela de erros](/pt-br/api-reference/ai-gateway).
* **GitHub App:** [vincular um repositório](/pt-br/api-reference/endpoint/apps/deploy/github-app-link) exige permissão de escrita (push) ou admin nele (`403 REPOSITORY_PERMISSION_REQUIRED`), e um repositório e branch só pode estar vinculado a uma aplicação em toda a plataforma.
## 📁 Gerenciador de arquivos em base64
**[Ler arquivo](/pt-br/api-reference/endpoint/apps/filemanager/content) sem `encoding` está deprecated.** A resposta `{ "type": "Buffer", "data": [...] }` será removida em **27 de março de 2027**, quando base64 vira o padrão. Envie `?encoding=base64` desde já para receber `{ "encoding": "base64", "data": "" }`. Até lá, a resposta antiga traz os headers `Deprecation` e `Sunset`.
* **Escrita em base64:** [Criar/modificar arquivo](/pt-br/api-reference/endpoint/apps/filemanager/put) aceita `encoding: "base64"`, o formato recomendado para arquivos binários. Um `content` vazio (`""` ou `[]`) grava um arquivo vazio.
* [Listar arquivos](/pt-br/api-reference/endpoint/apps/filemanager/list) responde `404 FILE_NOT_FOUND` para um diretório que não existe, em vez de uma lista vazia.
## 🔧 Outras mudanças na API
* **Respostas do webhook git:** a [URL do webhook](/pt-br/api-reference/endpoint/apps/deploy/webhooks) responde em texto se um deploy entrou na fila, então o **Recent Deliveries** do GitHub mostra o que aconteceu com cada push. O `200` só é enviado depois que o deploy foi gravado na fila. Um `503` significa que nenhum deploy foi feito: reenvie a entrega ou faça um novo push.
* **AI Gateway:** todos os erros, inclusive os de autenticação, escopo, rate limit e corpo inválido, agora vêm no formato OpenAI com o `code` em minúsculas (`access_denied`, `missing_scope`, `rate_limited` e outros). Veja a [tabela de erros](/pt-br/api-reference/ai-gateway).
* **Chaves de API expiradas** respondem `401 ACCESS_DENIED`, exatamente como uma chave inválida. O código `APIKEY_EXPIRED` não existe mais.
* **Criação de banco de dados:** uma criação que falha não deixa nada criado, então é seguro [tentar de novo](/pt-br/api-reference/endpoint/databases/create).
## 🗂️ A maior atualização do Blob Storage
O Blob Storage ganhou a maior atualização desde o lançamento e **saiu do beta**. Agora dá para guardar arquivos **privados**, entregar arquivos por **links temporários** ou **links de compartilhamento**, usar **ferramentas S3** (aws-cli, boto3, rclone, SDKs da AWS), deixar o **navegador enviar direto** sem expor a chave de API, definir **regras por prefixo** e mandar arquivos de até **10 GiB**. A [documentação do Blob](/pt-br/services/blob) foi reescrita do zero, com uma página para cada rota.
**O que muda para quem já integra com o Blob:**
* **Arquivos novos têm id com `pub/` ou `prv/` na frente** (`pub//imagens/logo.png`). Arquivos antigos mantêm o id que já tinham, e todas as rotas aceitam os dois formatos. Guarde o `id` como ele vem e trate-o como opaco: ele muda quando o arquivo troca de visibilidade ou de expiração.
* **Arquivos públicos novos são servidos em `https://blob.squarecloud.dev/pub/...`.** As URLs antigas em `public-blob.squarecloud.dev` continuam funcionando por **30 dias, até 25 de outubro de 2026**: mova esses arquivos com [`POST /v1/objects/copy`](/pt-br/blob-reference/endpoint/copy) (`move: true`) para ganhar a URL nova.
* **A expiração de um arquivo é lida em `expires_at`**, presente nas respostas de upload, listagem e detalhes. Não extraia a data do nome do arquivo.
* **Opções que dependem do plano respondem `403 UPGRADE_REQUIRED`**, com uma `message` que diz qual plano libera o recurso.
## 🔒 Arquivos privados e links
* **`private=true` no upload** guarda o arquivo sem URL pública. Ele é lido pela API, pelo gateway S3 ou por um link.
* **Troque a visibilidade quando quiser** com o novo [`PATCH /v1/objects`](/pt-br/blob-reference/endpoint/update). Tornar privado remove a cópia pública antes de responder, e a CDN deixa de servir o arquivo em cerca de 60 segundos. Tornar privado funciona até em conta sem plano ativo.
* **Links temporários** com o novo [`GET /v1/objects/download`](/pt-br/blob-reference/endpoint/download): valem de 60 segundos a 24 horas, não precisam de credencial, suportam `Range` (download retomável e vídeo) e permitem escolher o nome com que o arquivo é salvo.
* **Links de compartilhamento** com o novo [`POST /v1/shares`](/pt-br/blob-reference/endpoint/shares-create): duram até 30 dias, podem ser **revogados** a qualquer momento, limitam o **número de downloads** e, no Pro e no Enterprise, pedem **senha**. A página do link segue o idioma do visitante nos 8 idiomas da plataforma.
* Um link de compartilhamento cujo arquivo foi apagado, movido ou mudou de visibilidade responde `404` na hora, antes de qualquer página de senha e sem gastar download, e sai da lista de links.
* Um link de compartilhamento de arquivo **público** termina num redirecionamento para a URL permanente do arquivo, então senha, limite de downloads e prazo só protegem de verdade arquivos **privados**. Compartilhe arquivos privados quando a proteção importa.
* A página [Links e compartilhamento](/pt-br/blob-reference/links-and-sharing) compara os três tipos de link e explica quando usar cada um.
## 🪣 Compatível com S3
* Um **gateway S3** em `https://s3-blob.squarecloud.app` funciona com aws-cli, boto3, rclone, Cyberduck e os SDKs da AWS.
* O par de chaves vem do novo [`GET /v1/s3/credentials`](/pt-br/blob-reference/endpoint/s3-credentials) e é **derivado da sua chave de API**: revogar ou regenerar a chave faz o mesmo com o par, e uma chave só com `blob:read` gera um par só de leitura.
* Três buckets fixos por conta: `public`, `private` e `legacy` (arquivos legados, enviados antes desta atualização, com leitura, listagem e exclusão).
* Limites de taxa por plano, a cada 10 segundos: Hobby 100, Standard 200, Pro 400 e Enterprise 600 requisições. As requisições S3 não contam para o limite de requisições de API do seu plano.
* Suporta listagem com pastas, `Range`, upload multipart de até 10 GiB, cópia no servidor, exclusão em lote de até 1000 chaves, URLs pré-assinadas de até 7 dias e verificação de checksum. Detalhes em [Compatibilidade com S3](/pt-br/blob-reference/s3-compatibility).
* O `Content-MD5` é sempre verificado, mesmo junto de um cabeçalho `x-amz-checksum-*`, e uma divergência responde `BadDigest`.
* As respostas do gateway nunca ficam em cache na borda: uma URL pré-assinada para de funcionar exatamente quando expira, quando a chave de API é revogada ou quando o arquivo é apagado.
* As chaves podem ter até cerca de 1000 bytes. Acima disso, o `KeyTooLongError` informa o limite exato da sua conta.
## 🌐 Upload direto do navegador
* O novo [`POST /v1/upload-tokens`](/pt-br/blob-reference/endpoint/upload-tokens) gera, no seu servidor, um **token de upload** de curta duração (`squp_...`) que o navegador usa no lugar da chave de API.
* O token fixa nome, prefixo, visibilidade, expiração, tamanho máximo, extensões aceitas e metadados. Vale de 1 a 60 minutos e de 1 a 100 usos, e só funciona nas rotas de upload.
* Sem nome fixo, o navegador escolhe o nome e ele sempre recebe o hash de segurança, então um token vazado nunca substitui arquivos existentes.
## ⚙️ Regras por prefixo
* O novo [`PUT /v1/account/settings`](/pt-br/blob-reference/endpoint/settings-put) salva suas regras (5 no Hobby e no Standard, 10 no Pro, 20 no Enterprise), cada uma valendo para os arquivos de um prefixo.
* **Padrões:** visibilidade, expiração e cache.
* **Limites:** tamanho máximo e extensões aceitas.
* **Exclusão automática** depois de N dias, aplicada também aos arquivos que já existiam e aos enviados pelo S3. Ela só começa a agir **24 horas depois** de a regra ser salva, para dar tempo de ajustar um prefixo amplo demais.
## 🧰 Operações no servidor
* **Atualização em lote** com [`PATCH /v1/objects`](/pt-br/blob-reference/endpoint/update): visibilidade, expiração, cache, `Content-Disposition` e metadados de até 50 arquivos por requisição, com um resultado por arquivo.
* **Copiar, mover e renomear** sem baixar o arquivo com [`POST /v1/objects/copy`](/pt-br/blob-reference/endpoint/copy).
* **Detalhes de um arquivo** com [`GET /v1/objects/info`](/pt-br/blob-reference/endpoint/info): tipo, ETag, expiração, cache, nome original e metadados.
* **Exclusão em lote:** o [`DELETE /v1/objects`](/pt-br/blob-reference/endpoint/delete) aceita até 100 arquivos por requisição e responde o que foi excluído, o que não existia e o que falhou. Com um só id, o comportamento continua o mesmo.
## 📤 Uploads
* **Uploads em partes de até 10 GiB**, com até 2048 partes de 5 a 32 MB e até 32 uploads abertos por conta.
* **Retomada:** o novo [`GET /v1/objects/chunked`](/pt-br/blob-reference/endpoint/chunked-status) mostra quais partes já chegaram, e o [`GET /v1/objects/chunked/open`](/pt-br/blob-reference/endpoint/chunked-open) lista os uploads abertos da conta com o token de cada um. Uploads parados há 24 horas são cancelados automaticamente.
* **Novos parâmetros no upload:** `private`, `overwrite`, `disposition`, `cache_control`, `metadata` e `checksum_sha256` (se o arquivo não bater com o checksum, o upload é recusado com `CHECKSUM_MISMATCH` e nada é gravado).
* **Nomes mais flexíveis:** de 1 a 128 caracteres, aceitando `.` e `-`, e prefixos com até 8 níveis de pastas.
* **Expiração em horas ou dias:** `6h`, `30` ou `30d`.
* A resposta do upload traz o `sha256` do arquivo e indica se ele substituiu outro (`replaced`).
## 📋 Listagem e métricas
* O [`GET /v1/objects`](/pt-br/blob-reference/endpoint/list) ganhou filtro por visibilidade (`private`), pastas (`delimiter=/`), `limit` e o parâmetro `cursor`. Cada item traz `private`, `url` e `etag`, e o limite passou para 30 requisições a cada 30 segundos.
* Um `cursor` malformado ou desatualizado responde `400 INVALID_CONTINUATION_TOKEN`: recomece sem ele.
* O [`GET /v1/account/stats`](/pt-br/blob-reference/endpoint/stats) mostra a **média de uso do mês** (`month.average_storage`).
* Um health check público em `https://blob.squarecloud.dev/pub/status` responde `OK` e nunca fica em cache, pronto para o seu monitoramento.
## 💎 Recursos por plano
Todos os planos têm a API completa. Algumas opções dependem do plano:
| Recurso | Planos |
| - | - |
| Regras por prefixo | 5 no Hobby e no Standard, 10 no Pro, 20 no Enterprise |
| Metadados personalizados (até 5 chaves, 512 bytes) | Pro e Enterprise |
| Links de compartilhamento com senha | Pro e Enterprise |
| Uploads sem o limite de 1 por segundo | Pro e Enterprise |
| Expiração e exclusão automática abaixo de 7 dias (a partir de 1 hora) | Enterprise |
| Arquivos servidos sem cache na borda (`no-cache`) | Enterprise |
O armazenamento incluído no Enterprise é de **250 GB**. Regras salvas antes de um downgrade continuam valendo, e a próxima alteração precisa caber no novo plano.
## 🖥️ Blob no dashboard
A [página do Blob](https://squarecloud.app/pt-br/dashboard/blob) no dashboard foi reconstruída sobre a nova API, nos 8 idiomas.
* **Explorador de arquivos** com visualização em grade e em lista, pastas, filtro de visibilidade, ordenação e seleção múltipla. Exclusão, visibilidade, expiração e movimentação em lote mostram o progresso e só repetem os arquivos que falharam.
* **Fila de upload** com progresso, cancelamento e retomada, arquivos de até 10 GiB e escolha de pasta, visibilidade e expiração. Sair da página com uploads em andamento pede confirmação.
* **Detalhes do arquivo:** renomear, mover, copiar, visibilidade, expiração, cabeçalhos e metadados. Prévias de arquivos privados só carregam quando você pede.
* **Links de compartilhamento e links temporários**, cada janela explicando a diferença. Compartilhar um arquivo público mostra um aviso com o botão **Tornar privado**, e apagar, mover ou renomear um arquivo compartilhado avisa que os links dele vão parar de funcionar.
* **Regras de pasta**, com um contador de quantas o seu plano permite.
* Aba **Acesso S3**, que cria uma chave de API para o Blob e mostra o par de chaves S3 dela.
* Opções que dependem do plano dizem qual plano as libera. Contas sem plano ativo ainda podem ver, apagar e tornar arquivos privados.
* A [página pública do Blob Storage](https://squarecloud.app/pt-br/blob) foi reconstruída em torno dos novos recursos, com a comparação de preços atualizada. A importação por URL saiu da janela de upload.
## 🧾 Feed de atividades
* O [feed de atividades](https://squarecloud.app/pt-br/dashboard/activity) foi redesenhado: dias agrupados em cartões, horário à direita e o IP em cada linha.
* A primeira página cobre as **últimas 24 horas**, e a atividade mais antiga carrega conforme você rola ou clica, até a janela de histórico do seu plano (2 dias no Standard, 7 no Pro e 30 no Enterprise).
* As ações do Blob Storage ganharam nomes próprios no feed: atualização de arquivos, cópias, links de compartilhamento criados e revogados, tokens de upload e alterações de regras.
## 🩺 Correção de crashes em 1 clique
Quando uma aplicação cai com um erro conhecido, o console agora mostra **exatamente o que mudar** e aplica a correção para você: edita o arquivo, a variável de ambiente ou a configuração, reinicia a aplicação e acompanha o resultado. Ele avisa quando a correção funcionou, quando o erro voltou ou quando a aplicação não subiu.
* Cobre os crashes mais comuns: scripts de instalação do npm bloqueados pelo `allowScripts` (com o trecho de `package.json` pronto), dependências instaladas via Git, conflitos de peer dependencies, binários nativos compilados para outro sistema, arquivo `MAIN` inexistente, pacotes npm ou pip faltando, ES modules e versões do Node.js, entre outros.
* Só corrige o que consegue provar: um módulo que é arquivo do seu próprio projeto nunca é oferecido como pacote para instalar, e edições feitas com a janela aberta são mantidas.
* Toda correção respeita as permissões do workspace, e "Pedir ajuda" passa o diagnóstico para o Cubic ou para o suporte.
* Trocar de domínio personalizado com muita frequência agora explica que é preciso esperar cerca de 30 minutos.
## ✨ Site e dashboard
* A página Produto virou **[Recursos](https://squarecloud.app/pt-br/features)**, e todas as páginas de serviço foram redesenhadas com fatos revisados e textos mais claros. O endereço antigo redireciona.
* A página do **[AI Gateway](https://squarecloud.app/pt-br/dashboard/ai-gateway)** ganhou um diagrama animado, um início rápido em 3 passos, exemplos reais em JavaScript, Python e cURL, uma tabela de limites por plano e uma tabela de códigos de erro.
* A página de **[Domínios](https://squarecloud.app/pt-br/dashboard/domains)** lista cada domínio com o runtime e atalhos para métricas e configurações de rede, com busca e um guia ilustrado para conectar um domínio personalizado.
* A página de **[Load Balancers](https://squarecloud.app/pt-br/dashboard/loadbalancers)** foi reconstruída com uma simulação de tráfego ao vivo, mostrando round-robin e failover entre réplicas.
* **Preços:** o plano escolhido antes do login é mantido depois de entrar, as páginas só oferecem os planos que incluem o recurso que descrevem, contas Hobby veem um cartão de upgrade em bancos de dados em vez de um paywall, e a renovação some quando um cartão salvo já renova o plano.
* **Mais rápido:** o botão de login não espera mais o CAPTCHA, o Cubic transmite respostas com uma fração do trabalho e a visão geral da aplicação gasta bem menos tempo com métricas ao vivo.
* Layout corrigido até 320 px de largura em todos os idiomas.
## 🛡️ API
* **Análise de rede:** os cache misses das rotas de [análise](/pt-br/api-reference/endpoint/apps/network/analytics), erros, logs e performance compartilham um limite único de **20 requisições por minuto** por proprietário, e respostas em cache não contam. Quando as análises de borda estão ocupadas, as rotas respondem `503 ANALYTICS_BUSY` ou retornam os dados em cache mais recentes da janela.
* **Upload e commit:** o corpo da requisição é limitado a **101 MB** (um arquivo de até 100 MB mais o formulário), e uma requisição maior é recusada ainda durante o envio.
* **Proteção contra chaves inválidas:** um IP que insiste em chaves de API que não pertencem a nenhuma conta fica bloqueado por alguns minutos. Chaves válidas em uso normal não são afetadas. Detalhes em [Autenticação](/pt-br/api-reference/authentication).
* **AI Gateway:** o novo `503 daily_capacity_reached` indica que a capacidade diária compartilhada da plataforma se esgotou até 00:00 UTC, diferente do `429 daily_spend_limit_reached` da sua própria chave. Veja a [tabela de erros](/pt-br/api-reference/ai-gateway).
* O [documento OpenAPI](/pt-br/api-reference/openapi) não lista mais as rotas que só funcionam com uma sessão do dashboard, já que elas nunca aceitaram chave de API.
* **GitHub App com chave de API:** [vincular](/pt-br/api-reference/endpoint/apps/deploy/github-app-link) e [desvincular](/pt-br/api-reference/endpoint/apps/deploy/github-app-unlink) um repositório pelo GitHub App da Square Cloud agora funcionam com uma chave de API que tenha o escopo `apps:deploy`, então os métodos dos SDKs para isso não precisam mais de token de sessão. Vincular um repositório que não está coberto por uma instalação da sua própria conta do GitHub responde `403 REPOSITORY_NOT_AVAILABLE`.
## 📚 Documentação
* A documentação ganhou uma nova página inicial e um visual renovado, com ícones e diagramas novos.
* Páginas novas: [Erros](/pt-br/blob-reference/errors), [Compatibilidade com S3](/pt-br/blob-reference/s3-compatibility), [Links e compartilhamento](/pt-br/blob-reference/links-and-sharing) e uma página para cada rota nova.
* [Autenticação](/pt-br/blob-reference/authentication) mostra qual escopo (`blob:read` ou `blob:write`) cada rota exige.
* Tudo disponível nos 8 idiomas da documentação.
## 🎨 Dashboard redesenhado, runtimes atualizados e mais capacidade
Esta entrada reúne tudo o que foi publicado desde o fim de agosto e ainda não estava neste changelog. O dashboard foi revisado de ponta a ponta, com navegação configurável e uma passada completa para o celular. Restaurar um snapshot virou uma janela só. Todos os runtimes e bancos de dados subiram de versão, a cobrança ficou mais clara e dois clusters públicos novos entraram em operação.
**Quem cria bancos de dados pela API fixando uma versão completa precisa ajustar o campo `version`.** O [`POST /v2/databases`](/pt-br/api-reference/endpoint/databases/create) aceita a versão exata atual ou um prefixo dela. Com as imagens novas, uma versão completa que não seja a atual passa a responder `400 INVALID_DATABASE_VERSION`. Envie só o major (`"8"`, `"17"`, `"9"`), que sempre resolve para a versão mais recente daquele major. No Redis, o major agora é `8`.
## 🖥️ Dashboard
### Navegação configurável
* **Posição da navegação:** à esquerda (padrão), à direita, no topo ou embaixo. Nas posições laterais existe também uma **barra compacta só de ícones**, com o nome de cada item ao passar o mouse.
* **Cor de destaque por plano** (Standard, Pro e Enterprise) na navegação e nos detalhes do dashboard. Vem ligada e pode ser desativada.
* Configure em **Conta → Interface** ou pelo menu da conta na barra lateral. A escolha fica salva no dispositivo e é aplicada antes da primeira pintura da página, junto com o tema, então nada muda de lugar depois do carregamento.
* No celular, a barra superior e a navegação inferior continuam iguais em qualquer posição.
* A troca entre tema claro e escuro ficou instantânea, e o CAPTCHA acompanha o tema.
### Passada completa para o celular
* Um gesto a partir da borda esquerda abre o menu lateral.
* Dentro de uma aplicação, a barra superior ganhou atalhos para visão geral, logs, arquivos e configurações.
* Alvos de toque maiores em menus, seletores, ações do gerenciador de arquivos, variáveis de ambiente, DNS, logs, notificações, Blob e paginadores.
* Diálogos abrem como folha inferior, o teclado virtual redimensiona o conteúdo em vez de cobri-lo, o botão de salvar fica fixo no rodapé e as áreas seguras do iOS são respeitadas no dashboard e no site.
* A barra de memória do plano e os botões de renovar e fazer upgrade cabem na tela, e os selos dos snapshots quebram linha em vez de se espremer.
* No desktop, o layout não mudou.
### Estados de carregamento, erro e vazio
* Todos os skeletons do site e do dashboard foram auditados, e cada bloco que depende de dados ganhou um estado de erro próprio.
* A árvore de arquivos, a lista de logs da aplicação e os logs de rede foram redesenhados, com estados de vazio e de erro que dizem o motivo.
* Uma aplicação recém-criada mostra um aviso enquanto as primeiras métricas são coletadas.
* Erros de cartão do Stripe vêm com a orientação do próximo passo, e as mensagens de capacidade de upload ficaram mais claras.
* Quando o download do repositório falha porque a conexão com o GitHub expirou, o próprio aviso de erro oferece a **reconexão em um clique**. No celular, um upload interrompido sugere verificar a conexão.
### Console e tempo real
* Um console que tinha expirado por inatividade volta a se conectar sozinho ao dar start, stop ou restart, complementando a reconexão automática do stream anunciada em 5 de setembro.
* Em aplicações que escrevem muito log, uma aba que não acompanha o fluxo não acumula mais mensagens sem limite, sem afetar o status nem as outras abas.
* Horários relativos, como "há 2 min", se atualizam sozinhos.
* Se uma versão nova do dashboard for publicada com a sua aba aberta, a página se recupera sozinha em vez de falhar ao carregar partes do código.
### Desempenho
O código passou a ser carregado por rota, as janelas e o paywall só no clique, as traduções do dashboard por seção, e as requisições de cobrança deixaram de bloquear o carregamento inicial.
### Outros ajustes
* As ações rápidas do workspace voltaram a abrir a aplicação correta.
* Faturas de renovação aparecem no sino de notificações, e os botões de upgrade não pré-selecionam mais o ciclo anual.
* No feed de atividade, uma limpeza de cache em lote feita pelo Cubic aparece como uma linha só, com o detalhe de cada aplicação.
* A recomendação de PostgreSQL ao criar um banco MySQL ficou mais concreta, com a criação a um clique.
* O botão de reenviar o código de acesso por e-mail voltou a funcionar.
* A conexão com o GitHub ficou mais estável.
* A sincronização de cargos do Discord aguarda o limite de requisições do Discord em vez de falhar.
## 🗂️ Snapshots
* **Restore em uma única janela**, a mesma na página de snapshots da conta e nas páginas de cada aplicação e banco: resumo do snapshot, escolha do destino (com a origem pré-selecionada) e um botão de confirmação que nomeia o destino. Nas páginas de uma aplicação ou banco, o destino já é fixo e a escolha não aparece. Se a origem não existe mais, nada vem pré-selecionado.
* **Criar um banco novo durante o restore:** o dashboard cria o banco, acompanha até ele estar em execução, restaura e mostra a URL de conexão uma vez, no fim. Se a criação falhar, o formulário volta preenchido. Se o restore falhar depois da criação, a nova tentativa vai direto para o banco recém-criado.
* **Origem e runtime** aparecem em cada linha (veja a mudança de API de 17 de setembro), e o nome do arquivo baixado carrega os mesmos sufixos. Os snapshots diários automáticos e os gerados no vencimento do plano também passaram a ser marcados.
* Restaurações de snapshots grandes ganharam até 5 minutos para a extração dos arquivos.
* A página [Snapshots](https://squarecloud.app/pt-br/resources/snapshots) agora descreve a retenção: cada snapshot diário fica disponível por 7 dias, e o mais recente é mantido por até 30 dias.
## 🌐 Domínios
* Ao configurar um domínio personalizado, o dashboard mostra o valor exato a cadastrar no provedor de DNS, pronto para copiar.
* **Domínios com acento (IDN):** um hostname como `gestão.site.com` é normalizado no navegador (sem esquema, caminho, porta e ponto final) e convertido para Punycode, e só a forma ASCII (`xn--gesto-dra.site.com`) chega à API. O dashboard mostra como o domínio foi salvo e exibe a forma legível no cabeçalho da aplicação, em Domínios e em Load Balancers. Links e registros DNS continuam em ASCII.
* Pela API, o [`POST /v2/apps/{app_id}/network/custom`](/pt-br/api-reference/endpoint/apps/network/custom) continua esperando o hostname em ASCII: converta domínios com acento para Punycode antes de enviar.
## 💳 Planos e cobrança
### Downgrade
* O fluxo começa pelo motivo (custo, pouco uso, pausa ou outro) e mostra a comparação entre os planos com preços, o que muda, o que continua igual, até quando você já pagou e quanto custaria o ciclo anual do plano atual.
* O downgrade troca o plano **mantendo a data de vencimento atual, sem crédito proporcional da diferença**. O FAQ de [preços](https://squarecloud.app/pt-br/pricing) descreve a regra nos 8 idiomas e aponta para **Conta → Cobrança**, onde o downgrade é feito.
* O botão fica bloqueado quando a conta usa mais do que o plano menor comporta: RAM alocada acima do limite, domínios personalizados ou workspaces que o plano menor não inclui, ou bancos de dados sem permissão. Blob acima da cota do plano menor gera apenas um aviso.
### Renovação
* **PIX de renovação pronto para pagar:** contas sem cartão salvo recebem, ao entrar na janela de renovação (3 dias antes do vencimento) e de novo nas últimas 6 horas, um e-mail com o **QR code na própria mensagem** e o código copia e cola. É a mesma cobrança nos dois envios e na página da fatura, válida até o fim do plano.
* **Lembretes de vencimento** aos 14 e 7 dias para todas as contas com plano ativo. Para quem renova mensalmente, o lembrete de 14 dias mostra a comparação com o ciclo anual.
* **Depois do vencimento**, lembretes aos 3 e 21 dias.
* **Recibo de renovação após o vencimento:** um pagamento que reativa uma conta vencida gera um recibo próprio, que explica como restaurar as aplicações a partir dos snapshots gerados no vencimento.
### E-mails
* **Boas-vindas ao plano**, enviado alguns minutos depois da primeira compra ou de uma subida de plano (Hobby → Standard → Pro → Enterprise), apresentando o que o novo plano libera.
* **Aviso de plano cheio:** quando aplicações e bancos já alocam 95% ou mais da RAM do plano, a conta recebe uma sugestão do próximo plano, no máximo uma vez a cada 30 dias.
* **Fatura em aberto:** um lembrete pouco depois da criação e um reforço em 24 horas, se o pagamento ainda não aconteceu.
* Todos os e-mails da plataforma, inclusive os de acesso à conta, foram reescritos nos 8 idiomas sobre um layout novo, com o motivo do envio no rodapé. Os e-mails de código de acesso informam a validade do código e trazem os atalhos "Foi você?" e "Não foi você?" para a segurança da conta.
## 🤖 Cubic
* **Modo orientação para contas sem plano ativo:** o Cubic responde dúvidas sobre a plataforma, hospedagem e desenvolvimento consultando a base de conhecimento da plataforma, o status dos serviços e a web. Cada mensagem aceita até 2.000 caracteres, sem anexos de imagem, com orçamento de 500 mil tokens por dia (reset às 00:00 UTC). Ações sobre aplicações continuam exigindo um plano ativo.
* **Limpeza de cache em lote:** o Cubic limpa o cache de até 50 aplicações de uma vez e informa, por aplicação, o que não foi encontrado ou não tem domínio.
* **Mais confiável em tarefas longas com arquivos**, com menos interrupções no meio de uma edição.
* **Base de conhecimento revisada** contra a documentação: domínio personalizado é sempre um domínio seu, apontado com os três registros DNS, e o Cubic cita mais páginas desta documentação.
* O Cubic ganhou um mascote em pixel art, que aparece nos paginadores, nas listas vazias e nas telas de erro.
## 📡 Capacidade
Dois clusters públicos novos, **Iara** e **Rigel**, entraram na distribuição de novos deploys.
## ⚙️ Containers
* **Limite de memória sem swap:** containers criados a partir de agora usam só a RAM contratada. Ao atingir o limite, o processo é encerrado (OOM) em vez de continuar lento com a memória presa no teto. Containers existentes passam a seguir a regra na próxima alteração de RAM.
* **Manutenção sem interromper operações:** deploys, commits, restores, criação de bancos e snapshots em andamento terminam antes de uma manutenção começar.
## 📦 Runtimes e bancos de dados
As versões novas valem para deploys feitos a partir de agora. O campo `VERSION` do [arquivo de configuração](/pt-br/getting-started/config-file) continua escolhendo entre `recommended` e `latest`.
| Runtime | Antes | Agora |
| - | - | - |
| Node.js \[JS & TS] (`recommended`) | `24.15.0` | `24.21.0` |
| Node.js \[JS & TS] (`latest`) | `26.1.0` | `26.9.0` |
| Python (`recommended`) | `3.13.13` | `3.14.7` |
| Python (`latest`) | `3.14.5` | `3.14.7` |
| Go | `1.26.3` | `1.27.1` |
| Rust | `1.95.0` | `1.98.1` |
| PHP | `8.5.6` | `8.5.10` |
| Ruby | `4.0.4` | `4.0.7` |
| .NET/C# | `10.0.8` | `10.0.12` |
| Elixir | `1.19.5` | `1.20.4` |
| Java | JDK `25` | JDK `25.0.4` |
A versão `recommended` do Python passou de 3.13 para 3.14. Se alguma dependência do seu projeto ainda não publica pacotes para o Python 3.14, confira a compatibilidade antes do próximo deploy.
As imagens seguem trazendo ffmpeg, Chromium e as bibliotecas de compilação usadas por pacotes nativos.
| Banco de dados | Versão |
| - | - |
| MongoDB | `8.3.11` |
| PostgreSQL | `17.11` |
| MySQL | `9.7.2` |
| Redis | `8.8.3` |
As versões novas valem para bancos criados a partir de agora; bancos existentes continuam na versão em que foram criados. Todos seguem com conexão TLS, e o Redis 8.8.3 inclui os módulos JSON, Search (`FT.*`), TimeSeries (`TS.*`), estruturas probabilísticas (`BF.*`, `CF.*`, `TDIGEST.*`) e Vector Sets.
## ✨ Site
* **Nova página [Recursos](https://squarecloud.app/pt-br/features):** visão geral da plataforma em sete categorias (deploy, rede, escala, observabilidade, armazenamento, automação e confiança). O menu "Serviços" do cabeçalho virou "Recursos".
* **Novas páginas:** [APIs e backends](https://squarecloud.app/pt-br/apis), [SaaS](https://squarecloud.app/pt-br/saas) e [Domínios](https://squarecloud.app/pt-br/resources/domains).
* Todas as páginas de `/resources` foram redesenhadas e ganharam ilustrações próprias.
* A [central de suporte](https://squarecloud.app/pt-br/support) foi redesenhada com o Cubic como primeiro atendimento, e o botão de status leva usuários logados direto para o status no dashboard.
* A página [Enterprise](https://squarecloud.app/pt-br/enterprise) ganhou uma nova seção de contato, e o checkout Enterprise ficou empilhado no celular.
## 📦 Snapshots com runtime e origem
Toda listagem de snapshots (`GET /v2/apps/{app_id}/snapshots`, `GET /v2/databases/{database_id}/snapshots` e `GET /v2/users/snapshots`) passa a trazer dois campos a mais por item:
| Campo | Valores | Significado |
| - | - | - |
| `runtime` | a linguagem da aplicação (`javascript`, `python`, ...) ou o motor do banco de dados (`mongo`, `mysql`, `postgres`, `redis`) | De onde o snapshot foi tirado. |
| `origin` | `manual` ou `automatic` | Se foi pedido (API, dashboard, CLI) ou tirado pelo agendamento diário. |
Os dois vêm `null` em snapshots tirados antes desta mudança. O `name` de um snapshot novo carrega a mesma informação como sufixos (`__`), então o formato da URL de download não muda. Os endpoints de restauração (`POST .../snapshots/restore`) aceitam o `name` exatamente como a listagem retorna: repasse-o sem alterações como `snapshotId`.
## 🧭 Códigos de erro mais claros
Alguns endpoints respondiam certas falhas com um `{ "status": "error" }` sem código, ou com `400` para algo que na prática era "não encontrado". Esses casos agora trazem um código e o status HTTP correto. Nada foi renomeado: todos os códigos abaixo já existiam no vocabulário da API e nos tipos do SDK.
### Workspaces
| Endpoint | Antes | Agora |
| - | - | - |
| `DELETE /v2/workspaces` | `400` sem código quando o workspace já não existia | `404 WORKSPACE_NOT_FOUND` |
| `POST` / `DELETE /v2/workspaces/applications` | `400` sem código quando o workspace sumiu no meio da requisição | `404 WORKSPACE_NOT_FOUND` |
| `POST /v2/workspaces/members` | `400` sem código quando o workspace sumiu no meio da requisição | `404 WORKSPACE_NOT_FOUND` |
| `PATCH` / `DELETE /v2/workspaces/members` | `400` sem código quando o membro já tinha saído | `404 MEMBER_NOT_FOUND` |
`INVALID_ID` (`400`) não mudou, mas agora é respondido antes de qualquer outra coisa, então um `workspaceId` malformado deixa de contar no limite de requisições do endpoint.
### Arquivos, logs, cache e deploys
| Endpoint | Mudança |
| - | - |
| `PUT /v2/apps/{app_id}/files` | `content` aceita oficialmente três formatos: uma string UTF-8, um array simples de bytes (`[]` grava um arquivo vazio) ou um objeto `{ type: "Buffer", data }`. Conteúdo acima de **10 MB** é recusado com `413 FILE_TOO_LARGE`; as gravações têm limite de **10 a cada 5 segundos** por usuário (`429 KEEP_CALM`). |
| `GET /v2/apps/{app_id}/logs` | O `404` agora traz `LOGS_UNAVAILABLE` (ou o motivo informado pela própria aplicação) em vez de vir sem código. |
| `POST /v2/apps/{app_id}/network/purge_cache` | Uma limpeza que falha responde `500 PURGE_CACHE_FAILED` em vez de vir sem código. |
| `POST /v2/apps` e `POST /v2/apps/{app_id}/commit` | Quando há envios demais sendo processados ao mesmo tempo, a API responde `503 UPLOAD_BUSY` em vez de falhar o envio. Basta tentar de novo em instantes. |
### Dois códigos que qualquer endpoint pode retornar
| Código | HTTP | Significado |
| - | - | - |
| `KEEP_CALM` | 429 | O limite de requisições do endpoint foi excedido; aguarde e tente novamente. |
| `DATABASE_UNAVAILABLE` | 503 | O serviço está brevemente indisponível; tente novamente em alguns segundos. Aplicações e bancos de dados existentes **nunca** são reportados como não encontrados nesse estado. |
### Dashboard
* O console da aplicação agora reconecta sozinho sempre que o stream ao vivo cai, em vez de ficar desconectado até você clicar em reconectar.
* Remover um membro ou uma aplicação que já tinha sido removida em outro lugar apenas atualiza a lista.
## 🗞️ Outras atualizações
### 🤝 Novo programa de parcerias
Apresentamos um novo programa totalmente público de parceria. Conheça e se cadastre em [squarecloud.app/pt-br/partners](https://squarecloud.app/pt-br/partners).
### 🤖 Cubic e AI Gateway em uma nova infraestrutura de IA
No fim de agosto migramos toda a camada de IA da Square Cloud para uma nova infraestrutura, com foco em resposta mais rápida, mais estabilidade e limites mais generosos. Mantemos ZDR, política de privacidade total e zero logs.
**Cubic (assistente do dashboard)**
* **Respostas mais rápidas.** O primeiro token chega em cerca de 2 segundos mesmo em conversas longas; a espera de dezenas de segundos antes de a resposta começar ficou para trás.
* **Sem fila.** A capacidade escala por requisição: a mensagem de "IA em capacidade máxima" não existe mais. Se um provedor de modelo falhar, o Cubic troca para outro automaticamente.
* **Imagens com mais formatos e mais memória.** Além de JPEG e PNG, o Cubic aceita WebP. As imagens anexadas passam por uma análise dedicada que transcreve textos, erros e detalhes visíveis, e essa descrição fica na conversa para as mensagens seguintes.
* **Busca na web mais rápida**, com resultados em cerca de 1 segundo. **Transcrição de voz** continua em todos os planos, na mesma janela de 5 segundos a 2 minutos.
* **Novos limites diários de tokens por plano** (reset às 00:00 UTC): Hobby 2M; Standard 5M (4 GB), 7M (6 GB) e 10M (8 GB); Pro 15M; Enterprise sem alteração. O período de uso ilimitado terminou; o uso conta no orçamento diário do plano, visível na barra de uso do chat.
**AI Gateway (API compatível com OpenAI)**
* Roteamento pelo mesmo motor do Cubic, com a mesma queda de latência.
* Novos limites por plano:
* **Standard:** 1.000 requisições por dia, franquia de uso justo base, contexto de 16.384 tokens, saída de até 4.096 tokens, 1 requisição simultânea, intervalo mínimo de 5s (antes 4s).
* **Pro:** 5.000 requisições por dia, franquia base, contexto de 24.576 tokens, saída de até 6.144 tokens, 1 requisição simultânea, intervalo de 2s.
* **Enterprise:** requisições ilimitadas, franquia 5x a base, contexto de 32.768 tokens, saída de até 8.192 tokens, 2 requisições simultâneas, sem intervalo.
* Novos códigos 429 no formato OpenAI: `daily_request_limit_reached` (teto diário de requisições) e `daily_spend_limit_reached` (franquia diária de uso justo). Ambos resetam às 00:00 UTC.
* Continua sem streaming e sem imagens; o `web_search` embutido segue funcionando.
**Sobre o uso permitido do AI Gateway.** O AI Gateway é um produto em beta e hoje **totalmente gratuito**, oferecido como cortesia aos planos Standard, Pro e Enterprise para você integrar IA aos seus próprios projetos hospedados na Square Cloud. **Não é permitido revender, repassar ou expor o AI Gateway para uso massivo de terceiros** (oferecer a API a outros usuários, alimentar serviços de IA de terceiros ou distribuir acesso por meio de um único plano). Identificamos esse tipo de atividade consumindo a maior parte da capacidade; os novos limites e a franquia de uso justo existem para barrar exatamente isso, e um projeto com uso normal dificilmente chegará perto deles. Contas que mantiverem esse padrão poderão ter o acesso ao AI Gateway suspenso. Detalhes completos na [documentação do AI Gateway](/pt-br/api-reference/ai-gateway).
## 🔑 Até 10 chaves de API com escopo por conta
Sua conta tinha **uma** chave de API, com acesso a tudo: deploys, arquivos, variáveis de ambiente, bancos de dados e armazenamento de objetos. Se um pipeline de CI, um script de terceiro ou qualquer ferramenta precisava de acesso, era essa chave que ia.
Agora você cria **até 10 chaves nomeadas** nas configurações da sua conta, e cada uma carrega duas dimensões independentes: **o que** ela pode fazer e **onde** ela pode agir.
**Sua chave atual continua funcionando e não exige nenhuma ação sua.** O formato do token não mudou, então nada do que você já tem integrado quebrou. Ela agora aparece na sua lista de chaves como qualquer outra, com o horário do último uso e um botão de revogar.
O segredo de uma chave nova é mostrado **uma única vez** e nunca mais pode ser lido. As chaves são guardadas como hash irreversível.
### As 18 permissões
| Escopo | Concede |
| - | - |
| `account:read` | Ler os dados da sua conta |
| `apps:read` | Listar aplicações, ver status, logs e métricas |
| `apps:control` | Iniciar, parar e reiniciar |
| `apps:write` | Editar a configuração da aplicação |
| `apps:deploy` | Enviar código novo |
| `files:read` | Navegar e ler a árvore de arquivos |
| `files:write` | Criar, editar e apagar arquivos |
| `envs:read` | Ler variáveis de ambiente |
| `envs:write` | Criar e alterar variáveis de ambiente |
| `snapshots:read` | Listar e baixar backups |
| `snapshots:write` | Gerar e restaurar backups |
| `databases:read` | Listar bancos e ver status |
| `databases:write` | Criar, alterar e apagar bancos |
| `databases:credentials` | Ver e rotacionar credenciais do banco |
| `workspaces:manage` | Gerenciar workspaces e membros |
| `ai:chat` | Usar o AI Gateway |
| `blob:read` | Listar e baixar objetos |
| `blob:write` | Enviar e apagar objetos |
Passe exatamente `["*"]` para acesso total, que também cobre escopos criados no futuro.
Alguns escopos são mais amplos do que o nome sugere. `files:write` e `apps:deploy` equivalem a execução de código arbitrário no seu container, `snapshots:read` devolve a aplicação inteira **com as variáveis de ambiente dentro**, `databases:credentials` é a senha do seu banco, e `workspaces:manage` concede acesso a **outras contas** de um jeito que sobrevive à revogação da chave. Peça o mínimo.
### Restringindo uma chave a recursos específicos
`resources` recebe ids de aplicações e bancos de dados. Uma chave de CI que só enxerga o projeto daquele pipeline existe, funciona, e simplesmente não alcança o resto da sua conta. Omita para acesso à conta inteira.
`resources` **não pode ser combinado com `blob:read`/`blob:write`** (nem com `["*"]`, que os inclui), e a requisição responde `CONFLICTING_RESOURCES`. O armazenamento de objetos pertence à conta e nenhum objeto carrega id de aplicação, então a restrição não teria no que ser aplicada ali. Crie uma chave para as aplicações e outra para o armazenamento.
### Códigos de erro novos
| Código | HTTP | Significado |
| - | - | - |
| `MISSING_SCOPE` | 403 | A chave não tem o escopo exigido por essa rota |
| `RESOURCE_NOT_ALLOWED` | 403 | A chave está restrita a recursos que não cobrem essa requisição |
| `CONFLICTING_RESOURCES` | 400 | `resources` foi combinado com escopo de blob ou com `["*"]` |
| `APIKEY_LIMIT_REACHED` | 400 | A conta está com 10 chaves vivas |
## 💻 Conecte a extensão do VS Code sem colar sua chave
A extensão do VS Code agora pede autorização **como um aplicativo**, em vez de pedir que você cole a chave da sua conta num campo de texto.
A extensão abre uma solicitação, mostra um código de 8 caracteres na tela, e você digita esse código no dashboard para aprovar. O que ela recebe é uma **chave própria dela**: escopo mínimo, válida por 90 dias, e listada junto das suas outras chaves para você revogar quando quiser.
O código de 8 caracteres existe apenas na tela da extensão: ele não viaja no link e nenhuma rota o devolve. Um link de autorização que chegou até você por qualquer outro caminho não funciona sem ele. Depois de conectar, a extensão mostra em qual conta ela foi vinculada — confira.
A autorização fica vinculada à extensão que a iniciou, então uma solicitação interceptada no caminho não pode ser concluída por mais nada.
## 👥 Mais workspaces
O teto subiu: **5 workspaces** no Standard e **10** no Pro e Enterprise.
## 🤖 AI Gateway (Beta): use a IA da Square Cloud nas suas próprias aplicações
Agora você pode usar o modelo de IA hospedado da Square Cloud dentro dos **seus próprios** produtos — chatbots, assistentes, automações — através do novo **AI Gateway**, uma API de chat completions **compatível com OpenAI**. Se o seu código já fala a API da OpenAI, não precisa reescrever nada: aponte o SDK para a nossa base URL, use a API key da sua conta e defina o modelo como `cubic`.
```javascript theme={"system"}
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.squarecloud.app/v2/ai",
apiKey: process.env.SQUARECLOUD_API_KEY,
});
const completion = await client.chat.completions.create({
model: "cubic",
messages: [{ role: "user", content: "Olá!" }],
});
```
* **Funciona com qualquer SDK da OpenAI** (JavaScript, Python ou HTTPS puro) em `POST /v2/ai/chat/completions`.
* **Busca na web integrada**: o modelo pesquisa na web sozinho quando a conversa precisa de informações atuais, citando as URLs dos resultados na resposta.
* **Function calling** no formato padrão da OpenAI, com até 32 definições de tools por requisição.
* **Limites por plano**: o Standard tem contexto de 16.384 tokens e saída de 4.096; o Pro sobe para 24.576/6.144; o Enterprise para 32.768/8.192 com 2 requisições simultâneas. Cada requisição cobra os tokens reais do **orçamento diário de tokens de IA** do plano — o mesmo usado pelo assistente de IA do dashboard (reset às 00:00 UTC).
* **Beta com acesso antecipado gratuito**: durante o beta não há cobrança extra além do orçamento diário de tokens de IA do seu plano. Disponível nos planos Standard e superiores.
Veja a [referência completa do AI Gateway](/pt-br/api-reference/ai-gateway) para o contrato da requisição, códigos de erro e exemplos.
## 📋 Ações do Blob Storage no feed de atividade da conta
O feed de atividade da conta (disponível nos planos Standard e superiores) agora lista as **ações do Blob Storage** junto com as ações das suas aplicações: uploads, exclusões e uploads em partes sendo iniciados, concluídos ou cancelados — cada um com IP de origem, user agent e tipo de autenticação. As partes individuais dos uploads em partes ficam deliberadamente de fora, então um upload grande aparece como eventos limpos de início/conclusão em vez de centenas de linhas.
## 📦 Uploads de 1 GiB pelo dashboard
Complementando o fluxo de upload em partes lançado em 31 de julho, a página do Blob no dashboard agora o utiliza automaticamente: arquivos acima de 100 MB (até **1 GiB**) sobem em partes, com progresso real por bytes e um botão de cancelar para uploads em andamento.
## 📦 Blob Storage: uploads de 1 GiB, qualquer tipo de arquivo e limites mais amigáveis
A API do Blob Storage ganhou um fluxo de upload em partes que eleva o tamanho máximo de objeto de 100 MB para **1 GiB**, abandonou a allowlist de MIME types passando a aceitar praticamente qualquer tipo de arquivo, e teve os rate limits reajustados para que rajadas de uso normal não causem mais bloqueios longos.
### ⬆️ Uploads em partes de até 1 GiB
O `POST /v1/objects` continua igual, com teto de 100 MB por requisição (o maior corpo que a borda da Cloudflare aceita). Arquivos acima disso agora passam por um fluxo de quatro passos em `/v1/objects/chunked`:
1. [Abra o upload](/pt-br/blob-reference/endpoint/chunked-init) (`POST`) e receba um token `upload` opaco junto com os limites de chunk.
2. [Envie cada chunk](/pt-br/blob-reference/endpoint/chunked-part) (`PUT`) como corpo bruto de 5 a 32 MB, em qualquer ordem, com até 6 em paralelo; uma parte que falhar pode simplesmente ser reenviada.
3. [Conclua](/pt-br/blob-reference/endpoint/chunked-complete) (`PATCH`) enviando só o token: a lista de partes é lida de volta do storage, então o cliente nunca precisa rastrear ETags.
4. [Cancele](/pt-br/blob-reference/endpoint/chunked-abort) (`DELETE`) para desistir e liberar os chunks já armazenados (idempotente, e recomendado sempre que o usuário abandonar o upload).
Não existe sessão no servidor: o token é todo o estado do upload, então uploads sobrevivem a recarregamentos de página, e cada conta pode manter até 8 uploads abertos ao mesmo tempo. Se a cota da conta encher enquanto as partes sobem, a conclusão falha com `STORAGE_QUOTA_EXCEEDED`, mas o upload fica aberto: você pode liberar espaço e tentar de novo em vez de reenviar o arquivo inteiro.
### 📁 Qualquer tipo de arquivo aceito
A allowlist de MIME types acabou. A extensão armazenada agora vem do **nome de arquivo que você envia**, então formatos sem MIME type registrado (`.bam`, `.vcf`, `.fasta`, `.fastq`, `.parquet`, `.h5`, `.npy` e outros) sobem normalmente, e sufixos compostos de compressão são preservados (`reads.fastq.gz` permanece `.fastq.gz`). Formatos desconhecidos são servidos como `application/octet-stream`, formatos renderizáveis pelo navegador (`.html`, `.svg`, `.xml`) continuam sendo forçados a download, e apenas executáveis/instaladores são recusados, com o novo código `BLOCKED_FILE_TYPE`.
### ⚙️ Limites reajustados
* **O intervalo de expiração agora é de 7 a 1825 dias** (5 anos). Valores abaixo de 7 dias são rejeitados com `INVALID_OBJECT_EXPIRE`; atualize qualquer preset menor que uma semana.
* **O tamanho mínimo de arquivo caiu de 1 KB para 512 bytes.**
* \*\*O excedente de armazenamento agora custa R$ 0,20 por GiB iniciado** (antes R$ 0,25).
* **Os bloqueios de rate limit agora expiram junto com a janela** em vez de punir rajadas: exclusões de objeto foram de 1 por segundo para 10 a cada 10 segundos, exceder o limite de listagem bloqueia por 30 segundos em vez de 5 minutos, o de estatísticas por 60 segundos em vez de 5 minutos, e as rotas do fluxo em partes permitem aberturas, conclusões e cancelamentos em paralelo.
* O envio de chunks é isento do orçamento de API da conta, então um upload longo não consome sua cota de API no resto da plataforma.
Veja a [Referência do Blob](/pt-br/blob-reference/authentication) atualizada para o contrato completo, incluindo os novos códigos de erro (`TOO_MANY_OPEN_UPLOADS`, `TOO_MANY_CONCURRENT_CHUNKS`, `INVALID_UPLOAD_TOKEN`, `INVALID_CHUNK_PART`, `CHUNK_TOO_LARGE`, `CHUNK_TOO_SMALL`, `EMPTY_CHUNK`, `NO_CHUNKS_UPLOADED`, `UPLOAD_NOT_FOUND`).
## 🚀 Load Balancers, CLI v3 e uma nova geração de SDKs
Esta é uma das maiores levas de ferramentas que já lançamos de uma vez: o novo recurso de **Load Balancer** para domínios personalizados, a CLI oficial na **v3** com paridade total com a plataforma e novos releases em **todos os SDKs oficiais**: JavaScript v5, Go v2, Blob v2, Python v4.1 e API Types v3. A API pública e a API do Blob Storage também ganharam novos endpoints e respostas mais ricas, e a documentação que você está lendo agora está completa em 8 idiomas.
### ⚖️ Load Balancers: um domínio, várias aplicações
Agora você pode apontar o **mesmo domínio personalizado para mais de uma aplicação**. O tráfego é balanceado entre as aplicações na borda, com **failover automático**: se uma aplicação ficar offline, as requisições continuam fluindo para as que estão saudáveis.
* Capacidade por plano para aplicações compartilhando um domínio: **2 no Standard, 5 no Pro e 10 no Enterprise** (ultrapassar retorna `LOAD_BALANCER_LIMIT_REACHED`).
* Inspecione seus balanceadores pela API (`GET /v2/apps/load-balancers`), pelos SDKs ou pela CLI (`squarecloud app load-balancers`).
* O novo endpoint `GET /v2/apps/domains` complementa o recurso listando todos os domínios configurados nas suas aplicações em uma única chamada.
### ⌨️ Square Cloud CLI v3
A CLI deixou de expor só uma pequena parte da plataforma e alcançou **paridade total** com ela. Tudo que você faz no dashboard agora dá para fazer pelo terminal. Veja a [referência da CLI](/pt-br/cli-reference/installation) atualizada com todos os comandos.
* **Saúde da plataforma:** `squarecloud status` mostra a saúde dos serviços da Square Cloud.
* **Ferramentas profundas de aplicação:** `app info`, `app metrics` (últimas 24 horas de CPU, RAM e rede), `app realtime` (stream de eventos ao vivo, Ctrl+C para sair), `app domains`, `app load-balancers`, `app status --all` e `commit --path` para commitar um subdiretório.
* **Variáveis de ambiente:** `app env list/set/remove/replace`, incluindo importação em massa com `--from-file .env`.
* **Gerenciador de arquivos remoto:** `app file list/read/write/move/delete` direto do terminal.
* **Deploys e Git:** `app deploy list/current/webhook`, além de `link`/`unlink` do GitHub App.
* **Suíte de rede:** `app network dns/domain/analytics/errors/logs/performance/purge-cache`, com filtros de analytics e intervalos de tempo personalizados.
* **Restauração de snapshots:** tanto `app snapshot restore` quanto `db snapshot restore`.
* **Árvore `db` completa:** list, create, info, update, delete, start/stop, status, metrics, credentials (certificado e rotação) e snapshots.
* **Árvore `workspace` completa:** crie workspaces, gerencie membros e cargos, compartilhe aplicações e gere códigos de convite.
* **UX melhor em tudo:** flag global `--json` para scripts, IDs de app/banco opcionais (resolvidos pelo arquivo de configuração `squarecloud.app` ou por um seletor interativo), confirmação y/N em toda ação destrutiva com `-y` para pular, Ctrl+C cancela requisições em andamento e `SQUARECLOUD_DEBUG=1` para depuração das requisições.
* **Correções que importam:** falhas de autenticação agora saem com código 1, o seletor de aplicações não esconde mais erros da API e editar o arquivo `squarecloud.app` preserva as suas chaves existentes.
### 📦 Uma nova geração de SDKs
Todos os SDKs oficiais ganharam um novo release nesta leva, todos alinhados ao mesmo contrato atual da API.
**SDK JavaScript v5 (`@squarecloud/api`)** — veja a [referência do SDK](/pt-br/sdks/js/client) atualizada e o [guia de migração v4 → v5](/pt-br/sdks/js/migrating_to_v5):
* A transição de snapshots foi concluída: as antigas classes e métodos de backup foram removidos em favor de `Snapshot`/`DatabaseSnapshot`.
* Novos módulos de conta `domains()` e `loadBalancers()`, resultados de `create()`/upload mais ricos (nome e versão da linguagem, CPU, descrição, subdomínio) e `dns()` retornando a lista real de registros com status por registro.
* Analytics com **11 filtros de drill-down** e **4 novos breakdowns** (IPs, códigos de status, bots e content types).
* O export `APIErrorCode` segue os códigos de erro padronizados, mantendo os nomes antigos como aliases deprecated para as comparações existentes continuarem funcionando.
**SDK Go v2 (`sdk-api-go`)** — reescrito do zero, agora cobrindo a **API inteira da Square Cloud** sem nenhuma dependência externa:
* Aplicações (métricas, stream SSE em tempo real, snapshots com restauração, gerenciador de arquivos, variáveis de ambiente, deploys com integração do GitHub App, DNS, analytics e a suíte de rede), interface completa de bancos de dados, interface completa de workspaces e status da plataforma.
* Erros legíveis por máquina: falhas retornam `*rest.APIError` com o status HTTP e o código público do erro (por exemplo `APP_NOT_FOUND`), além dos helpers `rest.ErrorCode(err)` e `rest.IsRateLimit(err)`.
* Suporte real a contexts (`rest.WithContext(ctx)` propaga cancelamento e deadlines) e o novo module path `github.com/squarecloudofc/sdk-api-go/v2`.
**SDK Python v4.1 (`squarecloud-api`)** — uma grande sincronização de recursos:
* **Métricas** de aplicações e bancos de dados (últimas 24 horas), streaming de status em tempo real via SSE, `link`/`unlink` de deploys do GitHub App e list/create de snapshots de bancos de dados.
* Suíte de rede de borda para websites: erros, logs, performance e limpeza de cache, além de analytics de domínio com o conjunto completo de filtros de drill-down e janelas de tempo personalizadas.
* Chamadas de conta: status da plataforma, snapshots do usuário, domínios e load balancers.
**SDK Blob v2 (`@squarecloud/blob`)** — sincronizado com o contrato atual do Blob Storage:
* Listagem paginada via `continuationToken`, e `objects.delete` agora aceita diretamente a URL pública do objeto.
* Uploads são validados no cliente (nome, tamanho, expiração e tipo MIME) e enfileirados para respeitar o limite de concorrência, com retry automático quando o serviço está ocupado.
* Os erros agora expõem o `error.code` legível por máquina, seguindo os códigos de erro padronizados.
**API Types v3 (`@squarecloud/api-types`)** — o contrato TypeScript canônico, totalmente sincronizado:
* Tipos para os novos endpoints de domínios e load balancers, os filtros e breakdowns de analytics, variantes raw de status e a union `APIErrorCode` com os nomes pré-padronização mantidos como aliases deprecated.
### 🔌 Melhorias na API pública e no Blob Storage
* **Novos endpoints:** `GET /v2/apps/domains` (todos os domínios das suas aplicações) e `GET /v2/apps/load-balancers`.
* **Analytics mais profundo:** o endpoint de analytics de domínio agora aceita 11 filtros de drill-down (`country`, `ip`, `path`, `status`, `os`, `browser`, `protocol`, `referer`, `provider`, `content_type`, `bot`) aplicados a todos os breakdowns de uma vez, e retorna 4 novos breakdowns: IPs, códigos de status, bots e content types.
* **Os SDKs alcançaram o contrato completo:** recursos que a API já oferecia agora são de primeira classe em todos os SDKs oficiais e nas tipagens, como criar um banco só com a versão major do engine (por exemplo `"8"`), commit em subdiretório via o parâmetro de query `path`, variantes raw de status com `rawData=true` e o runtime ruby.
* **Blob Storage:** a listagem paginada via continuation token e os códigos de erro padronizados legíveis por máquina agora estão expostos de ponta a ponta pelo SDK Blob v2.
### 🛡️ Melhorias na plataforma e na conta
* **Conectado com segurança:** as sessões agora se renovam automaticamente enquanto você usa a plataforma, então usuários ativos não precisam logar de novo; sessões ociosas expiram mais cedo, o que aperta a segurança sem atrapalhar o uso.
* **Segurança de cartão reforçada:** estendemos a autenticação 3DS do banco a mais cobranças no cartão para proteção extra contra fraude, e quando o banco exige uma ação você recebe um e-mail claro para concluir o pagamento.
* **Notas fiscais (NFSe):** as notas dos serviços agora são emitidas com dados fiscais completos (razão social, CPF/CNPJ e endereço), e você pode configurar o seu CNPJ direto pelo dashboard. Quando a sua NFSe fica disponível, você recebe automaticamente um e-mail personalizado com um detalhamento explicando o que é a nota e para que ela serve.
* **Alertas proativos de RAM:** se uma aplicação ficar perto do limite de memória alocada, o dono recebe um aviso por e-mail antes que vire um problema.
* **Conexões longas mais estáveis na borda:** streams em tempo real (SSE) e WebSockets não caem mais em sessões longas, e as páginas de erro da borda foram redesenhadas com localização adequada.
* **Lembretes de renovação mais inteligentes:** os avisos de expiração agora entendem quando a renovação automática está cuidando do seu ciclo, e os e-mails transacionais foram revisados nos 8 idiomas.
### 📚 Documentação, agora em 8 idiomas
* A documentação agora está completa em **inglês, português, espanhol, francês, alemão, italiano, japonês e chinês simplificado**.
* A **referência da API** foi enriquecida endpoint por endpoint com explicações únicas, exemplos e tabelas de erro por rota.
* A **referência da CLI** foi reconstruída para a v3 (todos os comandos documentados), a seção do **SDK JavaScript** foi atualizada para a v5 com um guia de migração dedicado e a **referência do Blob Storage** foi auditada contra o serviço em produção.
### 📊 Resumo rápido de versões
| Produto | Versão | Principal destaque |
| - | - | - |
| Load Balancers | novo | Um domínio personalizado servido por várias aplicações, com failover automático |
| Square Cloud CLI | **v3** | Paridade total com a plataforma: bancos de dados, workspaces, gerenciador de arquivos, variáveis de ambiente, deploys, suíte de rede e `--json` em tudo |
| SDK JavaScript | **v5** | Nomenclatura de snapshots concluída, domínios e load balancers, analytics mais profundo, códigos de erro padronizados |
| SDK Go | **v2** | Reescrita completa com cobertura total da API, erros tipados e zero dependências |
| SDK Python | **v4.1** | Métricas, SSE em tempo real, deploys via GitHub App, suíte de rede de borda, snapshots de bancos |
| SDK Blob | **v2** | Paginação, códigos de erro tipados, validação no cliente, uploads mais inteligentes |
| API Types | **v3** | Sincronização total com o contrato atual da API, `APIErrorCode` com aliases deprecated |
## 🧹 Códigos de erro padronizados na API e no Blob Storage
Renomeamos um conjunto de códigos de erro da API da Square Cloud e da API do Blob Storage para seguir uma convenção única e previsível: `INVALID_X`, `X_NOT_FOUND`, `X_FAILED` e `X_LIMIT_REACHED`. Se a sua integração faz match pelos códigos de erro, atualize-a para os novos nomes abaixo.
### API — códigos renomeados
| Código antigo | Código novo |
| - | - |
| `ID_INVALID` | `INVALID_ID` |
| `CODE_INVALID` | `INVALID_CODE` |
| `NAME_INVALID` | `INVALID_NAME` |
| `MEMORY_INVALID` | `INVALID_MEMORY` |
| `DATABASE_TYPE_INVALID` | `INVALID_DATABASE_TYPE` |
| `DATABASE_VERSION_INVALID` | `INVALID_DATABASE_VERSION` |
| `UNKNOWN_WORKSPACE` | `WORKSPACE_NOT_FOUND` |
| `UNKNOWN_MEMBER` | `MEMBER_NOT_FOUND` |
| `MAX_APPLICATIONS_REACHED` | `APPLICATIONS_LIMIT_REACHED` |
| `MAX_MEMBERS_REACHED` | `MEMBERS_LIMIT_REACHED` |
| `FAILED_WORKSPACE_CREATION` | `WORKSPACE_CREATION_FAILED` |
| `FAILED_DATABASE_CREATION` | `DATABASE_CREATION_FAILED` |
| `FAILED_CLUSTER_SELECTION` | `CLUSTER_SELECTION_FAILED` |
| `FEW_MEMORY` | `INSUFFICIENT_MEMORY` |
| `FAILED_READ` | `READ_FAILED` |
| `FAILED_DELETE` | `DELETE_FAILED` |
| `FAILED_RENAME` | `RENAME_FAILED` |
| `FAILED_TO_SAVE` | `SAVE_FAILED` |
| `FAILED_RESET` | `RESET_FAILED` |
| `FAILED_UPLOAD` | `UPLOAD_FAILED` |
| `FAILED_UPLOAD_DATA` | `STORAGE_UPLOAD_FAILED` |
| `DELETE_ERROR` | `DELETE_FAILED` |
| `COMMIT_ERROR` | `COMMIT_FAILED` |
| `INTERNAL_ERROR` | `INTERNAL_SERVER_ERROR` |
| `REGEX_VALIDATION` | `INVALID_DOMAIN` |
| `CAN_NOT_SET_SUBDOMAIN` | `CANNOT_SET_SUBDOMAIN` |
| `INVALID_APP` | `METRICS_NOT_SUPPORTED` |
| `SUBSCRIPTION_REQUIRED` | `UPGRADE_REQUIRED` |
Observações: `INVALID_APP` foi renomeado apenas em `GET /v2/apps/{app_id}/metrics` (indica que aplicações com menos de 512 MB de RAM não coletam métricas). `KEEP_CALM`, o código de rate limit curto da API principal, mantém o nome.
### Blob Storage — códigos renomeados
| Código antigo | Código novo |
| - | - |
| `RATELIMIT` | `RATE_LIMITED` |
| `ACCESS_DENIED` | `PERMISSION_DENIED` |
| `FAILED_DELETE` | `DELETE_FAILED` |
| `FAILED_LIST` | `LIST_FAILED` |
| `INVALID_FILETYPE` | `INVALID_FILE_TYPE` |
| `PAYLOAD_TOO_LARGE` | `FILE_TOO_LARGE` |
Observações: o `ACCESS_DENIED` de autenticação (401 por chave de API ausente ou inválida) não muda; apenas o gate de plano ativo no upload de objetos agora retorna `PERMISSION_DENIED`. `FILE_TOO_LARGE` substitui `PAYLOAD_TOO_LARGE` no 413 do upload de objetos (limite de 100 MB).
## 🌍 8 idiomas, dashboard mais rápido, renovação inteligente e melhorias em toda a plataforma!
Desde o último changelog, dedicamos esta janela a dois objetivos: tornar a Square Cloud verdadeiramente sua em qualquer lugar do mundo e deixar o uso do dia a dia mais rápido e fluido. O grande destaque é a chegada de **quatro novos idiomas** (agora são **oito**), cobrindo o site, o dashboard, os e-mails da sua conta e o fluxo de login. Junto disso, vem uma rodada extensa de melhorias de performance, billing, integrações e experiência.
### 🌍 A Square Cloud agora fala 8 idiomas
A plataforma ganhou **quatro novos idiomas**: **Japonês (日本語), Francês (Français), Alemão (Deutsch) e Italiano (Italiano)**, que se juntam a Português, Inglês, Espanhol e Chinês — totalizando **oito idiomas**.
* **Cobertura completa:** a tradução abrange o **site inteiro, o dashboard, os e-mails da sua conta e todo o fluxo de login**, para uma experiência consistente de ponta a ponta.
* **Idioma que te acompanha:** sua preferência de idioma agora **persiste entre sessões** e permanece sincronizada ao alternar de língua.
### ⚡ Mais rápido, do cluster ao dashboard
Investimos em performance de ponta a ponta — do núcleo da plataforma ao seu navegador — para que tudo responda mais rápido, em qualquer conexão.
* **Cluster \~2x mais rápido:** otimizações profundas no núcleo da plataforma deixaram a comunicação com seus apps e containers cerca de **2x mais ágil**.
* **Modernização para o React 19** com carregamento adiado de partes pesadas (gráficos, pagamentos, animações), acelerando a abertura das páginas.
* **Imagens e assets \~59% menores** após uma recompressão geral de todo o site.
* **Páginas de marketing mais rápidas** com prerendering, preconnect e payloads de tradução enxutos.
* **Rolagem mais suave**, com header menos "travado" e menos re-renderizações nas animações de fundo.
* **PWA aprimorado:** cor de tema correta, ícone maskable, suporte a modo standalone no iOS e um login mais fluido no app instalado.
### 🎨 Novidades no dashboard
* **Upload em massa** no gerenciador de arquivos, com compressão e validação automáticas.
* **Histórico de resgates:** uma nova seção de **gift codes resgatados** na sua conta, e uma página de resgate repaginada com seções de FAQ e "como funciona".
* **Renovação automática repensada:** ativar leva segundos: salve um cartão e seu plano passa a se renovar sozinho, com o status da próxima cobrança sempre claro e visível no dashboard. Menos fricção para configurar, mais tranquilidade para não se preocupar com o vencimento.
* **Sugestão inteligente de PostgreSQL** ao criar um banco MySQL, ajudando você a escolher a melhor ferramenta para o seu caso.
* **Experiência de snapshots:** modais de feedback de cooldown e processamento e pré-visualização de arquivos em tema claro/escuro.
* **Conexão com a Google** sugerida diretamente nas notificações.
* **Modal de conteúdo de arquivo** mais claro, com opção de salvar.
### 🤝 Discord mais integrado
* **Cargos sempre em dia:** ao entrar com o Discord, sua conta **reentra automaticamente no servidor da Square Cloud e ressincroniza seus cargos**, mantendo seu acesso correto mesmo que algo tenha saído do lugar.
* **Login mais confiável:** o vínculo e o login via Discord ficaram mais robustos, com melhor tratamento de erros e novas tentativas automáticas.
### 🌐 Sites hospedados
* **Tempo real mais rápido:** melhoramos o suporte a conexões **WebSocket e Server-Sent Events** nos seus apps hospedados — mais velocidade e fluidez para dashboards ao vivo, chats e streams de longa duração.
* **Análise de DNS até 6x mais rápida:** a verificação de domínios e subdomínios recém-adicionados ficou cerca de **6x mais rápida**, deixando-os acessíveis muito mais cedo.
### 💳 Billing e renovação
* **Renovação automática mais inteligente:** adicionou um cartão pouco antes do vencimento? A renovação ainda acontece na hora certa — com proteções para garantir que **você nunca seja cobrado duas vezes** pelo mesmo ciclo, inclusive quando há um pagamento manual em andamento.
* **Histórico mais completo:** seus **gift codes resgatados nos últimos 12 meses** agora aparecem junto às suas faturas.
* **Pagamentos mais robustos** no processamento de cobranças.
### 📦 API e armazenamento
* **Snapshots de apps grandes em segundo plano:** snapshots pesados passam a ser gerados em background e aparecem automaticamente na sua lista assim que ficam prontos — você dispara e segue trabalhando.
* **Snapshots diários mais confiáveis:** os snapshots automáticos diários agora conseguem retomar de onde pararam caso uma execução seja interrompida.
* **Carregamento mais rápido** de workspaces e do dashboard, graças a melhorias de performance no backend.
* **Erros e documentação mais claros:** leituras de arquivos muito grandes agora retornam uma resposta apropriada de "arquivo grande demais", e várias descrições de endpoints ficaram mais precisas.
* **Rotação de API key mais flexível** e uma experiência mais suave para contas sem plano ativo ao acessar recursos que exigem um plano ativo.
* **Storage (Blob):** **listagem de objetos mais rápida** e **uploads mais estáveis** mesmo quando você envia vários ao mesmo tempo.
### 📧 E-mails da sua conta, repensados
Aprimoramos toda a experiência de e-mails da sua conta neste ciclo:
* **Localizados nos 8 idiomas**, acompanhando a nova cobertura de tradução da plataforma.
* **Onboarding renovado:** as mensagens de boas-vindas agora mostram como tirar o máximo da plataforma — a **extensão do VS Code** (deploy direto do editor), a **CLI** e o **app mobile** para monitorar e reiniciar seus apps de onde estiver.
* **E-mails de acompanhamento** (boas-vindas, dicas e lembretes) mais claros, melhor organizados e com formatação consistente.
### 📈 Web, privacidade e descoberta
* **llms.txt** para que assistentes de busca com IA descrevam com precisão os planos, runtimes e recursos da Square Cloud.
* **Controles de privacidade** de analytics (GA4) com preferências granulares na página de Privacidade.
* **Revisão 2026** dos Termos de Serviço, Política de Uso e Política de Privacidade.
### 🔐 Segurança e confiabilidade
Seguimos com **melhorias contínuas de segurança e de confiabilidade de sessão** nos bastidores, para manter sua conta protegida sem atrito no seu dia a dia.
### 📊 Resumo rápido
| Área | Destaque |
| - | - |
| Idiomas | **+4 idiomas** (Japonês, Francês, Alemão, Italiano) → **8 no total**, cobrindo site, dashboard, e-mails e login |
| Performance | **Cluster \~2x mais rápido**, React 19, assets **\~59% menores**, páginas mais rápidas |
| Dashboard | Upload em massa, renovação automática repensada, resgates e experiência de snapshots |
| Discord | Reentrada no servidor + ressincronização de cargos no login |
| Sites hospedados | Tempo real (WebSocket/SSE) mais rápido, **análise de DNS \~6x mais rápida** |
| Billing | Renovação automática mais inteligente e sem cobrança dupla, histórico com gift codes |
Obrigado por construir com a Square Cloud. Cada uma dessas novidades nasceu do feedback de quem usa a plataforma todos os dias — continue mandando suas ideias e sugestões. Tem muito mais por vir. ❤️
## 🚀 Nova extensão para VS Code, SDK Node.js v4, tipagens estáveis e dashboard completamente repensado!
Foram dez dias de trabalho intenso em praticamente todos os produtos da Square Cloud, e o resultado é uma das maiores levas de novidades que já lançamos em uma única janela. Reescrevemos do zero a extensão para VS Code, publicamos uma nova versão major do SDK oficial em Node.js, estabilizamos as tipagens da API, atualizamos e ampliamos a documentação OpenAPI e ainda repaginamos boa parte da experiência do dashboard, da central de notificações ao novo sistema de upgrade de plano.
### 🧩 Extensão para VS Code v5
A extensão da Square Cloud para o Visual Studio Code recebeu sua **maior atualização desde o lançamento**. Não foi um simples conjunto de melhorias incrementais: a extensão foi **completamente reescrita** sobre a nova geração do nosso SDK, abrindo espaço para recursos pedidos há tempos pela comunidade e deixando a base de código muito mais sólida para o que ainda está por vir.
* **Workspaces direto do editor:** toda a organização das suas aplicações por workspace, antes disponível apenas no dashboard web, agora acessível na própria barra lateral do VS Code.
* **Bancos de dados na ponta dos dedos:** suporte a MongoDB, Redis, PostgreSQL e MySQL dentro do editor — visualize suas instâncias e o panorama da sua infraestrutura de dados sem abrir o navegador.
* **Variáveis de ambiente:** confira e ajuste as variáveis das suas aplicações sem sair do VS Code. Perfeito para depurar problemas de configuração em segundos.
* **Status na barra do editor:** o estado das suas aplicações aparece em tempo real na status bar do VS Code, sem precisar abrir nenhuma aba ou painel.
* **Mais estável, mais consistente:** a reescrita sobre o SDK v4 deixou a extensão previsível e com experiência redonda em todos os idiomas suportados.
### 📦 SDK oficial para Node.js v4
O SDK oficial da Square Cloud em JavaScript/TypeScript chegou à sua **nova versão major: a v4**, e esta é, de longe, a maior evolução da biblioteca em toda a sua história. A v4 abre o acesso programático a praticamente toda a plataforma, com módulos inteiramente novos e melhorias profundas nos existentes.
* **Bancos de dados (módulo totalmente novo):** liste, crie e consulte o status das suas instâncias. A nova classe `Database` te dá controle completo: iniciar, parar, atualizar, excluir, métricas, leitura de certificado TLS, rotação de senha/certificado e **snapshots de banco de dados** com listar, criar e **restaurar**.
* **Workspaces:** gerencie inteiramente por código — `listar`, `buscar`, `criar`, `sair` e `excluir` workspaces, gerar códigos de convite, gerenciar membros (adicionar, atualizar, remover, roles) e compartilhar/descompartilhar aplicações.
* **Variáveis de ambiente:** módulo dedicado para aplicações com `list`, `set`, `replace` e `delete` — perfeito para automações de deploy e sincronização de ambientes.
* **Métricas e tempo real:** `getMetrics()` devolve a série temporal de **CPU, RAM e rede das últimas 24 horas**. `realtime()` abre um fluxo de **Server-Sent Events** com atualizações ao vivo da sua aplicação.
* **Deploy integrado ao GitHub:** `linkGithubApp()`, `unlinkGithubApp()` e `current()` para automatizar o pipeline de deploy direto pelo SDK.
* **Snapshots de aplicação e restauração:** o antigo conceito de "backups" virou **snapshots** em toda a biblioteca, com nomenclatura mais clara e **restauração de snapshot** (`snapshots.restore`) — uma novidade muito pedida. Também é possível listar snapshots no escopo do usuário.
* **Suíte de analytics de edge e Network:** observabilidade completa com **erros**, **logs**, **performance** e **purga de cache**, além dos dados de **DNS**. A `purgeCache()` foi simplificada e agora limpa o cache da aplicação inteira.
* **Saúde da plataforma e novos dados:** `service.status()` em uma única chamada, novos campos em bancos de dados (idioma, data de criação), aplicações (domínio, domínio personalizado, data de criação) e usuários, além de **códigos de erro públicos** acessíveis via `err.code` (ex.: `err.code === "FAILED_READ"`).
* **Tipagens de nova geração e qualidade:** consumo da nova linha **API Types** (agora estável), autocomplete mais preciso, vários bugs corrigidos e **exemplos executáveis** prontos para copiar e rodar.
> **Quebras de compatibilidade (3.x → v4):** `client.users.*` virou `client.user.*`; `app.backup` / `app.backups` viraram `app.snapshots`; `app.deploys.list()` retorna `Deployment[][]` (use `.flat()` para o comportamento antigo); `app.network.dns()` retorna `{ ownership, ssl }`; `app.network.analytics()` exige `{ start, end }`; nos workspaces, `members` / `applications` viraram `memberList` / `applicationList`; **Node mínimo agora é 20+**.
### 🔌 API pública e tipagens oficiais
A API pública da Square Cloud, a porta de entrada para qualquer integração com a plataforma, recebeu uma rodada significativa de melhorias.
* **Documentação OpenAPI revisada e ampliada:** ampliamos a cobertura para mais endpoints e enriquecemos os esquemas de aplicações, bancos de dados, estatísticas de runtime, uploads de arquivos e mais. Revisamos descrições, mensagens de resposta e códigos de status — você passa menos tempo adivinhando o formato de uma resposta e mais tempo construindo a sua integração.
* **Novos endpoints de Network:** focados em performance e erros, expondo dados que antes não eram facilmente acessíveis. São esses mesmos endpoints que alimentam o novo módulo de Network do SDK Node.js.
* **Respostas mais ricas:** workspaces e usuários trazem o momento de entrada (`joinedAt`), estatísticas de runtime ganharam mais detalhe, leitura de arquivos passou a lidar melhor com conteúdo em UTF-8 e descrições foram revisadas em diversos pontos.
* **API Types v1.0: tipagens estáveis.** As tipagens oficiais da API alcançaram sua primeira versão estável, com versionamento semântico de verdade, previsibilidade total para quem depende delas e evolução coordenada com a simplificação do recurso de purga de cache.
### 🎨 Dashboard
O dashboard web, o lugar onde a maioria das pessoas vive a Square Cloud no dia a dia, foi onde concentramos o maior volume de melhorias do período. Foram dezenas de refinamentos, do recurso totalmente novo ao polimento cuidadoso de usabilidade.
* **Nova central de notificações com renovação em 1 clique:** sino e sistema de avisos repensado do zero. Quando seu plano está próximo do vencimento, a própria notificação oferece a renovação imediata, sem você precisar navegar por várias telas. Avisos de uso e expiração migraram para esse novo sistema.
* **Novo sistema de upgrade de plano:**
* **Upgrade a qualquer momento, inclusive no meio do ciclo** — os recursos maiores passam a valer imediatamente, sem esperar a renovação.
* **Cobrança proporcional (pro-rata) com prévia antes de confirmar** — você vê exatamente quanto vai pagar, calculado pelo tempo restante do ciclo atual.
* **Transição de plano sem sobreposição de cobrança** — a cobrança do plano substituído é cancelada automaticamente, com cálculo unificado da migração.
* **Faturas claramente identificadas** no histórico e **FAQ atualizado** explicando como tudo funciona.
* **Nova experiência de cartão de crédito:** fluxo reformulado, otimizado para celular e com **autenticação 3DS** dos bancos quando necessário. Carregamento mais leve e preenchimento mais direto.
* **Página de cobrança reformulada:** a antiga "invoices" deu lugar à nova seção de **Cobrança (Billing)**, com histórico e detalhes muito mais claros, identificação de cobranças relacionadas a upgrades e uma aba própria para detalhes de cobrança.
* **Nova página de preços e FAQ atualizado:** apresentação dos planos mais clara e direta, andando lado a lado com o novo sistema de upgrade.
* **Gerenciador de arquivos repaginado:** melhorias de performance na abertura de arquivos e pastas, navegação mais fluida e mensagens mais claras em ações como exclusão de pastas.
* **Analytics e logs evoluídos:** cópia rápida de conteúdo diretamente da tabela, tornando a investigação de problemas bem mais ágil.
* **Nova seção na página de Bots**, com mais informação relevante para quem hospeda bots.
* **Status de DNS traduzido** em todos os idiomas.
* **Tema claro/escuro** com diversos ajustes finos de contraste, ícones e logos.
* **Melhorias amplas para celular**, com telas de status online/offline, snapshots e deploys repensadas para o toque.
* **Reconexão automática mais robusta** nas telas em tempo real e correções de estabilidade que deixam a navegação mais sólida no geral.
### 📊 Resumo rápido das versões
| Produto | Versão | Destaque principal |
| - | - | - |
| Extensão para VS Code | **v5** | Workspaces, bancos de dados, variáveis de ambiente e status em tempo real, em uma reescrita completa |
| SDK oficial para Node.js | **v4** | Novos módulos de bancos de dados, workspaces, variáveis de ambiente, métricas, realtime (SSE), deploy via GitHub e analytics de edge |
| API Types | **v1.0** | Primeira versão estável das tipagens oficiais |
| Dashboard | n/a | Novo sistema de upgrade de plano (pro-rata com prévia), central de notificações com renovação em 1 clique, nova experiência de cartão, cobrança e preços repaginados |
Obrigado por construir com a Square Cloud. Cada uma dessas novidades nasceu de feedback de quem usa a plataforma todos os dias. Continue mandando suas ideias e sugestões — tem muito mais por vir.
## 🚀 App Mobile, Hub de Runtimes, ambientes atualizados e melhorias amplas em toda a plataforma!
Este ciclo concentra entregas em todas as frentes da Square Cloud: lançamos um hub dedicado a runtimes com uma página específica para cada linguagem suportada, integramos oficialmente o nosso app Android à plataforma, atualizamos a matriz completa de ambientes, finalizamos o tema branco no site inteiro e fechamos uma rodada extensa de melhorias de UX, performance e segurança.
### 📱 App Mobile Oficial
* **App nativo para Android** oficialmente integrado à plataforma. Links da Square Cloud agora abrem direto no app quando você tem ele instalado, sem passar pelo navegador.
* **Nova página dedicada em `/resources/app`** apresentando o app, suas funcionalidades e o link de download.
* **Spotlight de recursos no website** convidando para experimentar o app a partir de pontos estratégicos da navegação.
* **Tamanho de instalação otimizado** para caber confortavelmente em qualquer celular, com descrições precisas em todos os idiomas suportados.
* Disponível em **Português, Inglês, Espanhol e Chinês**, com paridade total de conteúdo entre os idiomas.
### 🧭 Novo Hub de Runtimes
Lançamos uma vertical inteira de páginas dedicadas às linguagens suportadas pela plataforma:
* **Página índice em `/runtimes`** com grid visual e tabela comparativa entre todas as linguagens — versões disponíveis, características principais e link direto para cada página específica.
* **Página dinâmica `/runtimes/[linguagem]`** com hero personalizado, especificações técnicas, casos de uso reais, listagem de versões disponíveis e exemplo de configuração pronto para copiar e colar no seu `squarecloud.app`.
* **Header e dropdown mobile do website** atualizados com navegação direta por runtime — agora é um clique para chegar na documentação da sua linguagem.
* **FAQ compartilhada entre todas as páginas** com as dúvidas mais frequentes sobre cada ambiente.
* **Sitemap, metadados e banners localizados** para SEO em todos os idiomas suportados.
* Tudo disponível em **PT-BR, EN, ES e ZH**.
### 🆕 Atualização de Ambientes
Mantemos nossa matriz de runtimes nas últimas versões estáveis da indústria. Confira as versões disponíveis a partir deste ciclo:
* **JavaScript \[Node.js]** → Recomendado: `24.15.0` | Última: `26.1.0`
* **Python** → Recomendado: `3.13.13` | Última: `3.14.5`
* **DOTNET** → Recomendado/Última: `10.0.8`
* **Rust** → Recomendado/Última: `1.95.0`
* **Ruby** → Recomendado/Última: `4.0.4`
* **PHP** → Recomendado/Última: `8.5.6`
* **Go** → Recomendado/Última: `1.26.3`
Cold start de aplicações Node ficou um pouquinho mais rápido em testes preliminares com a nova matriz (varia bastante por workload — ainda estamos validando os números reais em produção).
### ⚡ API mais rápida e robusta
* **Respostas mais rápidas** em rotas que dependem de múltiplas checagens, sem nenhuma mudança necessária do seu lado.
* **Menor uso de memória sob carga**, garantindo estabilidade em momentos de pico de tráfego.
* **Encerramento ordenado** durante manutenções e deploys — requisições em andamento são finalizadas corretamente antes da manutenção prosseguir.
* **Melhor tratamento de desconexões abruptas**, evitando conexões fantasmas em ferramentas de monitoramento e dashboards.
* **Cleanup de workspaces** mais resiliente, com tratamento de erros mais claro em operações de manutenção.
### 🛡️ Segurança e Privacidade
* **Nova página de exclusão de conta**, totalmente alinhada com a **LGPD**. Você sempre teve esse direito — agora o caminho está documentado, traduzido e a um clique.
* **Validação de uploads reforçada:** nomes de arquivo, tipos de conteúdo e limites de payload agora são verificados de forma mais consistente por escopo.
* **Verificações de permissões de workspace** aprimoradas em ações administrativas.
* **Headers de segurança refinados:** CSP e Referrer-Policy ajustados em todo o site para melhor proteção contra XSS e vazamento de referrer.
* **Rotinas de comparação de tokens e chaves de API reforçadas.**
* **Validação de links de retorno e redirecionamentos aprimorada.**
* Links externos com `rel="noopener noreferrer"` em todo o website.
### 🎨 Website Renovado
Boa parte do website foi tocada neste ciclo:
* **Nova landing page** com identidade visual reformulada e correções no header.
* **Tema branco/claro completo:** todos os componentes, modais, gráficos e páginas agora respeitam a preferência do seu sistema (claro/escuro).
* **Bundle reduzido em aproximadamente 43%.** Site carrega mais rápido em qualquer conexão.
* **Nova página `/about`** contando nossa história. A antiga foi movida para a documentação.
* **Nova página `/support`** com chat, e-mail e canais de contato bem organizados.
* **Novo Help Center** nos developer resources, agrupando documentação, guias e links úteis.
* **Novo dashboard de Blob** com visualização em grid e lista, preview de imagens, busca com debounce e gestão muito mais ágil de objetos.
* **Nova página de criação de Workspaces** com fluxo simplificado e mensagens mais claras.
* **Nova navegação mobile do header** muito mais fluida.
* **Footer com links agrupados por categoria** — bem mais fácil achar o que você procura.
* **Refator completo das páginas `/services` e `/resources`** para uma experiência mais consistente entre verticais.
### 📦 Upload e File Manager
* **Bulk delete com progresso ao vivo** e ação "selecionar todos" no File Manager — gerenciar muitos arquivos finalmente ficou rápido.
* **Validações de upload mais rigorosas** com mensagens de erro claras para arquivos inválidos, vazios ou corrompidos.
* **Novo editor de código** com autocomplete, fechamento automático de brackets e atalhos melhores — pensado para sessões longas de edição.
* **Detecção automática de variáveis de ambiente** no contexto de upload mantida e refinada.
### 🗄️ Blob e Armazenamento
* **Limpeza automática de objetos órfãos** no armazenamento — espaço economizado, custos otimizados.
* **Reconciliação de contas inativas** mais rápida e confiável, com melhor reporte de erros em cada etapa.
### 💳 Billing e Checkout
* **Duração escolhida lembrada** entre as telas do checkout — chega de selecionar mensal ou anual duas vezes.
* **Slider do plano Enterprise** reformulado com label dedicada e melhor legibilidade.
* **Lógica de billing adaptada** ao tema branco em todos os componentes (cartões de pagamento, duração de plano, etc.).
* **Tier reorganizado** no seletor de planos para um caminho mais intuitivo entre opções.
* **Avisos de plano** refatorados para melhor estrutura visual e textos mais claros.
### ♿ Acessibilidade
* **Comportamento de elementos ocultos** corrigido para se comportar adequadamente com leitores de tela e foco de teclado.
* **Suporte completo a `prefers-reduced-motion`** em todo o site — animações e transições são desabilitadas automaticamente para quem prefere menos movimento.
* **Imagens otimizadas** para melhor performance percebida e menor uso de dados.
### 🌍 Internacionalização
* **Refator total das traduções** em **PT-BR, EN, ES e ZH** com revisão de qualidade pareada entre os 4 idiomas.
* **FAQs sobre serviços, bots e bancos** agora 100% cobertas em chinês.
* **Disclaimer de idioma** adicionado em páginas legais nos 4 idiomas, deixando claro qual versão prevalece em caso de divergência.
* **Padronização do termo `workspace`** em espanhol como `espacio de trabajo` em todos os textos.
* **Padronização de naming de databases** (`MongoDB Hosting`, `Redis Hosting`, etc.) em todo o site, copy e metadados.
* Correção de diversos erros de digitação e gramática nas traduções existentes.
### 🆘 Suporte e Comunicação
* **Nova página de Suporte** com chat ao vivo, e-mail e canais alternativos claramente organizados.
* **WhatsApp** adicionado como canal oficial de contato.
* **Chat ao vivo** com detecção automática de status online em tempo real.
* **Chat sincronizado** com o tema do site (claro/escuro) e com a sessão do usuário.
### 🤖 PWA e Android App Links
* **Integração nativa com app Android** publicada — links da plataforma podem ser abertos diretamente no app sem o prompt do navegador.
* **Manifest e ícones revisados** para melhor experiência em qualquer dispositivo.
* **Metadados aprimorados** para suporte de aplicações móveis em todas as páginas relevantes.
### 🧩 Modais e CTAs
* **Sistema de modais unificado** em todas as páginas, com performance e usabilidade consistentes.
* **Novos modais úteis:** redenção de gift code, memória insuficiente e confirmação de código de verificação.
* **CTA compartilhado** substituindo CTAs duplicados em todas as páginas de produto — agora a comunicação é consistente em todo o site.
### 🔧 Hotfixes e Qualidade de Vida
* Correção de redirecionamentos pendentes do antigo `/sac` para `/support` em links, sitemap e redirects.
* Headers, modais, alerts e tooltips com correções de visibilidade no tema claro.
* Truncamento correto de IDs longos em mobile nas listagens de aplicações e databases. (obrigado a todos que reportaram!)
* Estrutura de SEO com dados estruturados localizados por idioma e suporte a breadcrumbs em todas as páginas principais.
* Várias correções de spelling e gramática em traduções existentes.
## 🚀 API mais rápida, infraestrutura mais sólida e dashboard completamente renovado!
Este é o maior ciclo de atualizações da Square Cloud desde o lançamento da plataforma. Reescrevemos o core da API, expandimos o Realtime, reformulamos os Snapshots do zero e entregamos um dashboard mais rápido e mais bonito — tudo ao mesmo tempo.
### 🧭 Nova Base da API
Reescrevemos a forma como nossas rotas processam requisições internamente. O resultado é visível sem nenhuma mudança do seu lado:
* **Respostas mais rápidas** em todas as rotas que dependem de múltiplas checagens.
* **Quota mais justa:** requisições inválidas agora são rejeitadas antes de consumir o seu limite.
* **Rate limits corretos em workspaces:** membros de uma mesma workspace compartilham o limite de forma precisa — sem brechas.
* **Códigos HTTP alinhados ao padrão:** 401, 403 e 404 onde devem estar. Chega de erros genéricos que não explicam o que aconteceu.
* **Compatibilidade aprimorada** com clientes que enviam cabeçalhos fora do padrão.
* **Gerenciador de arquivos mais seguro:** validação reforçada dos caminhos manipulados pelo File Manager para evitar operações humanas erradas e velocidade melhorada ao lidar com diretórios grandes.
### 🔌 Realtime com mais fôlego
* **Até 10 conexões simultâneas por aplicação** (antes eram 5). Dashboards, logs ao vivo e ferramentas de observabilidade agora funcionam sem competir por slot.
* Desconexões abruptas são tratadas de forma muito mais robusta — conexões encerradas são completamente liberadas, sem acúmulo ao longo do tempo.
* Mensagens de erro mais claras quando o limite de conexões é atingido.
### 🗄️ Snapshots e Backups
O sistema de snapshots foi completamente reescrito do zero ao longo deste ciclo:
* **Engine mais eficiente:** menor uso de recursos durante a geração de backups, com compressão adaptativa de acordo com o tipo de snapshot.
* **Restore com integridade garantida:** as restaurações mantêm a janela de estabilização de **60 segundos** introduzida na atualização de fevereiro, assegurando que todos os dados estejam completamente estáveis antes de sua aplicação voltar online.
* **Listagens e detalhes em cache** por mais tempo, reduzindo a espera ao navegar entre snapshots.
* Erros durante a geração de backups agora são reportados corretamente — sem falhas silenciosas. (obrigado a todos que relataram isso!)
### 🤖 Nova Engine de IA
* A geração de respostas por IA migrou para um novo provedor e agora **seleciona automaticamente o melhor modelo disponível** a cada requisição. Resultado direto: respostas mais rápidas e mais consistentes.
* Nova **tela de AI Analytics** disponível no dashboard, com insights da sua aplicação. Disponível em Português, Inglês, Espanhol e Chinês.
### 🔁 Deploy via Git
* Bloqueamos a criação de dois deploys apontando para o **mesmo repositório + branch** na mesma conta, evitando deploys duplicados por engano e confusão na hora de gerenciar múltiplos ambientes.
* Deploy e commit de código agora se completam corretamente mesmo em condições adversas de rede — sem erros silenciosos ou timeouts sem resposta.
### 🎨 Dashboard Renovado
* **Console em tempo real muito mais rápido** — os logs aparecem praticamente na hora, sem a sensação de travamento.
* **Dashboard mais leve**, com páginas que abrem mais rápido especialmente no celular.
* **Navegação mobile dos filtros melhorada** — filtros ocupam menos espaço na tela, deixando mais área para o conteúdo.
* **Nova página de preços (`/pricing`):** comparações mais claras, seleção de duração que lembra da sua escolha e layout reorganizado.
* **Novo paywall** nas páginas de aplicações e databases — mais visual, com depoimento rotativo e botão direto para escolher um plano.
* **Novo header e novo footer** com links reorganizados e botão de idioma mais acessível.
* **Heroes redesenhados** em `/bots`, `/sites`, `/blob` e `/databases`.
* **Nova página `/resources/infrastructure`**.
* **Banners revisados** em toda a plataforma, com visual mais consistente.
* **Novo editor de código** com atalhos melhores (incluindo indentação com `Tab`), syntax highlighting mais legível e nova fonte otimizada para leitura longa.
### 📦 Upload de Aplicações
* Aceitamos **`.zip` de até 1GB no envio** para identificar e informar exatamente o que precisa ser removido (`node_modules`, caches, `.git`) — em vez de simplesmente recusar o arquivo.
* O **limite real da plataforma continua em 100MB**, mas a experiência de chegar nesse limite ficou muito mais clara e amigável.
* Se o seu `.zip` já contiver um arquivo `squarecloud.app` ou `.env`, perguntamos se você quer **importar a configuração automaticamente**.
* Mensagens de erro muito mais claras para arquivos corrompidos, vazios ou em formato não suportado.
* Arquivos comprimidos enviados para a plataforma passam agora por validações extras e arquivos indevidos são **bloqueados automaticamente**.
### 🤝 Workspaces e Membros
* **Membros do workspace** agora podem adicionar e remover subdomínios sem precisar do dono da conta.
* **Paywalls específicos por recurso** informam claramente, de forma amigável, o que cada plano libera — sem surpresas.
### 💳 Billing e Checkout
* Checkout, renovação e upgrade **preservam a duração escolhida** entre telas — sem confusão.
* **Downgrade blindado:** antes de reduzir o plano, verificamos se há workspaces ou domínios customizados incompatíveis com o plano de destino.
* (era uma função intencional, mas notamos que podia levar a inconsistências mesmo que domínios fossem desativados tempos depois do downgrade).
* Invoices canceladas levam direto para o checkout — sem precisar procurar o botão certo.
* Modal de downgrade com explicações passo a passo e mensagens mais humanas.
### 🔐 Conta e Segurança
* **Cadastro via Discord** agora disponível, com todos os avisos legais no lugar. (voltamos a aceitar novos cadastros via Discord depois de termos desativado).
* Fluxo de login simplificado — menos telas intermediárias, menos confusão.
* Sessão e logout mais confiáveis em casos de troca de conta.
### 🧱 Estabilidade Geral
* Infraestrutura de rede interna reforçada, evitando problemas de conectividade em ambientes corporativos.
* Redução de picos de processamento em horários de alto volume de deploy.
* Quando uma workspace não existe, a resposta agora é um **404 claro** — sem ambiguidade.
* Limite de commits por minuto ajustado para reduzir abusos de deploy em rajada.
### 🌍 Traduções
* **Português, Inglês, Espanhol e Chinês** revisados de ponta a ponta.
* Correção de diversos erros de digitação e padronização de termos técnicos em todos os idiomas.
* Avisos regulatórios (PayPal, Pix) com texto próprio em cada idioma. (obrigado a todos que apontaram isso!)
### 📈 Observabilidade
* O pipeline de logs foi migrado para um método de autenticação mais seguro e moderno, tornando a integração mais simples de operar.
* O buffer de logs foi reforçado para não perder eventos nos primeiros segundos após um boot de aplicação.
* Ampliamos a capacidade de conexões simultâneas feitas pela plataforma para serviços externos. Menos filas em momentos de pico, menos timeouts esporádicos para suas aplicações.
## 🚀 Performance Brutal, Inteligência de Dados e Nova Era de Infraestrutura!
Damos hoje o maior salto técnico da história da Square Cloud. Não estamos apenas escalando hardware; estamos reescrevendo o core da nossa plataforma com algoritmos de baixo nível para garantir uma experiência de desenvolvimento sem precedentes.
> **Nota do CEO:** "Esta atualização define o novo padrão de eficiência na Square Cloud. Ao otimizar o processamento em $O(1)$ e refinar a orquestração de snapshots, entregamos uma infraestrutura que não apenas hospeda, mas potencializa o crescimento de cada projeto."
### ⚡ Engenharia de Performance: O Core Engine $O(1)$
Mergulhamos fundo na nossa camada de rede e telemetria para eliminar cada milissegundo de overhead:
* **Rate Limiting 2.0 (Ganho de 200x):** Migramos para um modelo de fluxo mais eficiente. A validação de tráfego agora é instantânea, independentemente da carga.
* **Realtime-Console Acelerado:** Reduzimos round-trips e simplificamos o tratamento de conexões ativas. O console agora responde em tempo real.
* **Runtime Lean:** Realizamos o stripping de dependências obsoletas e validações redundantes no ambiente de execução, garantindo mais CPU e RAM real para sua aplicação.
* **Smart Analysis System:** Sistema inteligente que traqueia deploys automaticamente e realiza re-análises aleatórias horas depois para garantir a integridade do runtime.
### 🗄️ Databases: Integridade, Criptografia e Snapshots
Resolvemos desafios complexos de orquestração para garantir que seus dados estejam sempre acessíveis:
* **Fix de Consistência de Credenciais (MongoDB/MySQL):** Corrigimos uma inconsistência de credenciais após a restauração de snapshots de banco de dados. As restaurações agora mantêm os fluxos de acesso consistentes.
* **Gestão de Snapshots:** Cooldown de restore aumentado de **30s para 60s** para garantir a estabilização física dos dados e propagação de índices.
* **Páginas Dedicadas:** Lançamento de dashboards otimizados para `Redis`, `MySQL`, `PostgreSQL` e `MongoDB`.
### 📦 Atualização de Runtimes (Stack 2026)
Mantendo o compromisso com o estado da arte, atualizamos nossos ambientes oficiais:
* **DOTNET:** Atualizado para **10.0.2**.
* **ELIXIR:** Atualizado para **1.19.5**.
* **GOLANG:** Atualizado para **1.25.7**.
* **RUST:** Atualizado para **1.93.0**.
### 🛠️ Developer Experience (DX) e UX
Otimizamos o fluxo de trabalho para tornar a gestão de arquivos e deploys mais fluida:
* **File Manager Pro:** Adicionado suporte para **seleção em massa (até 50 arquivos)**, confirmação de exclusão via modal e atalho `ESC` para desseleção rápida.
* **Upload Inteligente:** Suporte a **Drag & Drop de arquivos .zip** com visualização de conteúdo e detecção automática de frameworks (**Next.js, Vite e Vue**).
* **Git App (Case-Sensitivity):** Corrigido bug que forçava branchs para minúsculo. Agora, o sistema respeita o casing original (ex: `Dev` permanece `Dev`).
* **Network Intelligence:** Botões rápidos para copiar URLs e nova rota `/network/logs` (exclusiva PRO/Enterprise) com filtros de data (`?start` e `?end`).
### ⚖️ Sustentabilidade e Infraestrutura Pro
Redefinimos nossos limites para garantir estabilidade global em todos os níveis:
* **Novo Tier PRO (24GB):** 12 vCPUs de alta performance e 250GB de Blob Storage.
* **Enterprise Scale-Out:** Agora iniciando em **16 vCPUs base** e suporte para o **Enterprise-1024** (até 1024 vCPUs distribuídas).
* **Burst Logic 2.0:** Novo algoritmo de alocação de CPU contextual que permite picos de performance baseados na necessidade real do projeto.
* **Foco no Plano Hobby:** Para preservar a performance global, o plano Hobby agora foca exclusivamente em aplicações, removendo instâncias dedicadas de databases e snapshots globais massivos para garantir a disponibilidade de 100% da rede.
Continuamos construindo o futuro da hospedagem, um commit por vez. 🚀
## 🚀 Reformulação Visual, LGPD e Otimizações de Core!
Lançamos hoje uma atualização focada na reformulação visual de nossas principais páginas, melhorias críticas na experiência de desenvolvimento (DX) e uma grande limpeza de dados para conformidade e performance.
> **Nota sobre a Black Friday:** Agradecemos a participação massiva! Nossa infraestrutura operou com estabilidade total durante o período. O foco agora volta 100% para a evolução do produto.
### 🎨 Novo Design e Experiência de Usuário (UX)
Redesenhamos pontos chave da plataforma para torná-la mais moderna e acessível:
* **Nova Home e Autenticação:** Uma experiência de entrada (Login/Signup) totalmente nova e fluida.
* **Melhorias na Documentação:** Revisão e aperfeiçoamento geral para maior clareza técnica.
* **Workspace Experience:** Admins agora têm feedbacks visuais melhores sobre permissões, e Owners recebem orientações mais claras sobre alocação de recursos.
### 🔐 Reformulação da Aba de Variáveis (Secrets)
Atendendo a pedidos, reconstruímos a UI/UX do gerenciamento de variáveis de ambiente para ser mais produtiva:
* **SQUARECLOUD\_APP\_ID:** Adicionada injeção automática desta ENV com o ID da aplicação.
* **Ações Rápidas:** Botão para limpar todas as ENVs e nova validação no export.
* **Interação Avançada (Shift):** Ao segurar `SHIFT`, o botão de menu se transforma em uma lixeira para exclusão rápida.
* **Edição Direta:** Clique no input para editar o valor imediatamente, sem precisar abrir menus.
* **Design Compacto:** Redução de padding geral para uma visualização mais densa e eficiente das informações.
### 🛠️ Funcionalidades de Deploy e Arquivos
Expandimos o controle que você tem sobre seus arquivos e bancos de dados:
* **Manipulação de Diretórios:** Agora é possível **renomear e mover diretórios** diretamente pela dashboard.
* **API de Commit (`?path=`):** Adicionamos suporte a alocação de commits em subdiretórios específicos via API.
* **Ambientes estáticos:** Ao enviar via runtime, o sistema detecta automaticamente projetos HTML/CSS, oculta comandos desnecessários e facilita a publicação.
* **Postgres:** Bancos PostgreSQL agora iniciam com a database `squarecloud` criada por padrão, evitando erros de conexão para iniciantes.
### 🔒 Segurança, LGPD e Infraestrutura
Focamos em privacidade e estabilidade do core da plataforma:
* **Limpeza de Dados (LGPD):** Em conformidade com normas de privacidade, deletamos permanentemente **+50.000 chats de suporte** e **+40.000 contatos** inativos há mais de 365 dias.
* **Escopo squareweb.app:** Agora aceita e gerencia conexões vindas da rede Tor (com desafio de segurança).
* **Smart Cache Reset:** Novo sistema de limpeza de cache global inteligente.
* **Extensão VS Code:** Correções aplicadas para resolver desconexões (logout) involuntárias.
* **Padronização Hobby T1:** Ajuste de multithreading neste tier para padronização com o restante dos planos existentes.
### 📉 Otimização do Ciclo de Vida de Dados
Refinamos a retenção de backups para melhorar a eficiência do storage e eliminar dados obsoletos:
* **Snapshots de Aplicação:** Versões antigas agora duram até **44 dias** (30 dias primária + 14 dias retenção).
* **Backups de Banco de Dados:** Versões antigas agora duram até **21 dias** (14 dias + 7 dias retenção).
Continuamos trabalhando para tornar a Square Cloud cada vez mais eficiente.
## 🚀 Black Friday, MySQL, Artigos e Globalização!
Lançamos hoje uma atualização focada em melhoria de ferramentas, globalização de alguns setores e aprimoramento na usabilidade geral da plataforma. E tem mais: a **única promoção do ano** está no ar!
### 🎉 Black Friday — A ÚNICA PROMOÇÃO DE 2025
**Desconto anual DOBRADO: 30% OFF** em qualquer renovação, upgrade ou primeira compra na modalidade anual.
Exemplos de preços com desconto: (valores em BRL)
* **Standard T1:** de **34,90/mês** por **24,43/mês**
* **Pro T1:** de **100/mês** por **70/mês**
Aproveite esta oportunidade exclusiva para economizar e escalar seus projetos na Square Cloud!
### ✨ Mudança geral de estilização da dashboard e correção de bugs
Reformulamos completamente a navegação da plataforma, tornando diversos setores mais acessíveis e modernos:
* Navegação redesenhada para facilitar o acesso a recursos importantes.
* Otimizações para melhorar a experiência de desenvolvedores que dependem de leitores de tela.
* Nova lógica de renderização em grande parte do website, tornando tudo mais dinâmico e rápido.
* Visualização melhorada do que é removido ao realizar um downgrade de plano.
* Opção semestral removida — agora oferecemos apenas duas opções mais claras e fáceis de compreender (mensal e anual).
* Correção de diversos bugs que impactavam a navegação.
* Compatibilidade aprimorada com navegadores legados.
### 🛠️ Melhoria na experiência de deploy + novo Banco de Dados
Expandimos o suporte a bancos de dados e otimizamos o processo de deploy:
* **MySQL v9:** Agora disponível e otimizado para produção.
* **Elixir:** Correção de problemas de runtime + atualização para a versão **1.19.2**.
* Implementamos limitações mais agressivas na visualização de arquivos via API do File Manager (nada de tentar visualizar um arquivo de 1GB agora 😊).
* Corrigimos um problema na integração Git que causava latência superior ao esperado:
* Listagem reduzida para os últimos 5 deploys.
* Notificações de erro melhoradas nas respostas.
* Redução de **\~14ms globalmente** nos deploys com a nova arquitetura.
* Correção de erro que impedia a visualização da aba de Snapshots em algumas workspaces.
* Correção de bug que importava variável de ambiente vazia ao fazer deploy com arquivo parcialmente inválido.
### 📚 Novos artigos e tutoriais
Adicionamos guias completos para facilitar o deploy de diferentes frameworks e tecnologias:
* **Angular:** [Como fazer deploy de um projeto Angular](https://docs.squarecloud.app/pt-br/tutorials/website/angular)
* **AstroJS:** [Como fazer deploy de um projeto AstroJS](https://docs.squarecloud.app/pt-br/tutorials/website/astrojs)
* **Nuxt:** [Como fazer deploy de um projeto Nuxt](https://docs.squarecloud.app/pt-br/tutorials/website/nuxt)
* **Gatsby:** [Como fazer deploy de um projeto Gatsby](https://docs.squarecloud.app/pt-br/tutorials/website/gatsby)
* **Laravel:** [Como fazer deploy de uma API Laravel](https://docs.squarecloud.app/pt-br/tutorials/api/laravel)
* **Spring Boot:** [Como fazer deploy de uma API Spring Boot](https://docs.squarecloud.app/pt-br/tutorials/api/spring-boot)
Esses tutoriais cobrem desde a configuração inicial até o deploy completo, ajudando você a colocar seus projetos no ar rapidamente.
### 🌍 Globalização e melhorias gerais
Continuamos expandindo e melhorando a experiência internacional da plataforma, com foco em acessibilidade, performance e clareza de comunicação.
Essas são apenas algumas das novidades! Continuamos ouvindo a comunidade e trabalhando diariamente para tornar a Square Cloud ainda melhor.
## Novidades e melhorias (06/11/2025)
Lançamos uma rodada importante de melhorias focadas em usabilidade, visualização de mídia, e infraestrutura de runtimes — tudo pensado para acelerar seus fluxos de trabalho e tornar a plataforma mais amigável, desde quem está testando gratuitamente até empresas com alto volume de tráfego.
## Dashboard aprimorada para usuários sem plano ativo
Agora a dashboard oferece uma experiência muito mais acolhedora para quem ainda não possui um plano ativo. A interface passa a destacar ações recomendadas (como iniciar um deploy, conectar um repositório ou resgatar códigos de ativação), com navegação mais clara e telas focadas nas tarefas mais importantes para novos usuários.
### Visualização de blobs aprimorada
A página de Blob foi atualizada para permitir visualização direta de imagens e vídeos sem necessidade de download. Isso facilita a inspeção rápida de conteúdos, acelera validações e reduz o tempo para depuração de assets multimídia.
### Visualização dinâmica de aplicações
A listagem de aplicações agora se adapta automaticamente à altura do monitor do usuário, melhorando o aproveitamento do espaço em telas grandes e oferecendo uma experiência consistente em dispositivos menores.
### Melhoria nas telas vazias
Seções como "Aplicações" e "Bancos de Dados" ganharam layouts repaginados para estados sem conteúdo: mensagens explicativas, sugestões de próximos passos e CTAs úteis tornam a primeira experiência com a plataforma mais simples e orientada.
### Downgrade de plano agora disponível
Você pode realizar o downgrade do seu plano sem precisar de suporte manual — tudo direto pela aba **Minha Conta**. O processo é automatizado, seguro e transparente, com confirmação e histórico das alterações.
### Exportação de variáveis de ambiente
Adicionamos um botão de exportação na aba **Variáveis de Ambiente**. Em um clique você baixa todas as variáveis em formatos úteis (dotenv / JSON), perfeito para backups ou migração entre projetos.
### Upload via GitHub com configuração automática
Ao importar via GitHub, a plataforma agora tenta detectar e configurar automaticamente o repositório (package manager, comando de start, build scripts), reduzindo erros de configuração e acelerando o primeiro deploy.
### Botão de busca no editor de arquivos
Implementamos um botão de pesquisa nativo no editor de arquivos, otimizado para dispositivos móveis — agora é mais fácil procurar trechos de código diretamente do celular.
### Rate limit global corrigido
> Corrigimos um problema que, em alguns cenários, causava uma Client Side Exception ao exibir o rate limit global. A exibição está agora estável e resiliente, sem impactar a navegação.
### Website agora utiliza o React Compiler
Atualizamos a base do website para usar o React Compiler. O resultado: renderização mais rápida, menor TTFB e navegação mais fluida em páginas com conteúdo dinâmico.
### Formato aprimorado de snapshots
Padronizamos o nome dos arquivos de snapshot para facilitar organização e rastreabilidade. Novo padrão:
```
_2025-12-31_12-59-59_.zip
```
O arquivo inclui nome da aplicação, data/hora da geração e o ID do app.
### Comparativo detalhado entre planos
A página de **Pricing** foi totalmente reformulada com um comparativo visual entre tiers. Agora fica bem mais simples entender limites, benefícios e escolher o plano ideal.
## Atualização de ambientes
Atualizamos e ampliamos o suporte a runtimes e linguagens:
* **Ruby \[Novo runtime]**
Disponível como runtime na Square Cloud para produção total.
`recommended`/`latest`: **3.4.7**.
* **Java \[Suporte a Gradle/Maven]**
`recommended`/`latest`: **JDK 25 (LTS)**.
* **Node.js**
`recommended`: **v24.11.0** (LTS) — adotada como padrão.
`latest`: **v25.1.0** — suportado; em testes observamos até \~**40% de ganho de performance** em aplicações web ao usar a versão latest em cenários específicos.
* *Nota: Node 25 é indicado para quem busca performance, mantenha testes antes da migração em produção.*
* **Python**
`recommended`: **3.13.9**.
`latest`: **3.14.0**.
* C# (ASP.NET) — `recommended`/`latest`: **9.0.10**.
* **Elixir**
`recommended`/`latest`: **1.91.1**.
* **Rust**
`recommended`/`latest`: **1.91.0**.
* **PHP**
`recommended` & `latest`: **8.4.14**.
* **Go**
`recommended` & `latest`: **1.25.4**.
Observações: O suporte ao **Ruby foi implementado nesta versão**; o Java passa a oferecer suporte oficial a projetos construídos com Gradle e Maven. Node 24 LTS é a versão padrão; Node 25 fica disponível como opção para quem precisa de maior desempenho.
## Correções e ajustes menores
* Ajustes de UX em telas e modais (vários pontos de fricção reduzidos).
* Normalização de nomes de snapshots e melhorias no processo de download.
* Pequenas correções no fluxo de upload via GitHub e validações automáticas de repositórios.
* Agora o Blob valida com maior velocidade a capacidade disponível de armazenamento ao fazer uploads grandes.
Essas atualizações já estão sendo liberadas gradualmente. Continuamos ouvindo a comunidade e priorizando melhorias que impactam diretamente sua produtividade.
## Redesign de Upload e Integração GitHub
Focamos nossos esforços em revolucionar a experiência de deploy e integração com o GitHub, trazendo melhorias significativas que tornam o fluxo de trabalho mais simples, moderno e eficiente. Confira as principais novidades que já estão disponíveis:
### Nova experiência de upload
Criamos uma experiência de upload completamente repensada para desenvolvedores modernos.
* **Nova página de upload:** Agora contamos com uma página dedicada exclusivamente para uploads, totalmente redesenhada para oferecer uma experiência mais simples, moderna e intuitiva.
* A página de upload agora está disponível em `/upload` em vez de `/dashboard/upload`. Além da praticidade, essa mudança contribui para o SEO do site, tornando a página de upload pública e melhorando sua indexação nos mecanismos de busca.
### Integração GitHub revolucionada
Simplificamos drasticamente o processo de integração com repositórios GitHub.
* **Upload via GitHub (sem access token):** Facilitamos ainda mais o processo de integração com repositórios. Agora você pode realizar uploads diretamente do GitHub sem a necessidade de inserir manualmente um access token.
* **Integração completa com repositórios GitHub:** É possível conectar seu repositório do GitHub diretamente à sua aplicação, simplificando o fluxo de deploy e tornando a automação ainda mais prática e segura.
* **Conexão direta com sua conta GitHub:** Conectar-se ao GitHub ficou ainda mais fácil: basta autenticar com sua conta para aproveitar todos os recursos de integração de maneira centralizada e transparente.
* **Login via GitHub:** Além da conexão para integrações, agora você pode usar sua própria conta do GitHub para realizar login ou criar uma conta em nossa plataforma, deixando o processo de autenticação rápido, seguro e sem complicações.
### Melhorias na interface e SEO
Aprimoramos a experiência visual e a presença online da plataforma.
* **Redesign completo da aba "Minha Conta":** A seção de perfil e configurações passou por um redesign completo, trazendo uma interface mais limpa, moderna e organizada, permitindo que você gerencie suas informações de forma mais simples.
* **Melhoria no SEO do website:** Além da nova rota, o site passou por ajustes técnicos e de conteúdo voltados à otimização para mecanismos de busca, garantindo melhor desempenho em indexação e maior visibilidade no Google.
### Extensão do VS Code aprimorada
Melhoramos a experiência de desenvolvimento direto do seu editor favorito.
* **Loading aprimorado da extensão:** Otimizamos o processo de carregamento da extensão do VS Code, tornando a inicialização mais rápida e eficiente para uma experiência de desenvolvimento mais fluida.
### Sistema de snapshots modernizado
Substituímos completamente o sistema anterior por uma solução mais avançada.
* **Migração completa de backups para snapshots:** Os antigos backups foram substituídos pelo sistema de snapshots, oferecendo maior eficiência, velocidade de restauração e melhor gestão do histórico de versões das suas aplicações.
### Sistema de notas fiscais modernizado
Atualizamos nossa infraestrutura fiscal para maior compatibilidade e eficiência.
* **Migração para o novo ISSNet da Prefeitura de Goiânia:** Nosso sistema de NFSe foi completamente migrado para utilizar o novo ISSNet da Prefeitura de Goiânia, garantindo maior estabilidade, conformidade e agilidade na emissão de notas fiscais de serviços.
### PHP + Swoole
Suporte a Swoole aprimorado e lançado em conjunto com a versão 8.4.12 do PHP.
### Correções críticas
Solucionamos problemas importantes que afetavam a integridade dos arquivos.
* **Correção no processo de upload e compactação de arquivos:** Identificamos e corrigimos um bug que afetava a recompactação dos arquivos enviados pela plataforma. Em alguns casos específicos, essa falha resultava na geração de arquivos binários corrompidos após o upload. Agora, o processo foi totalmente ajustado e validado para garantir que todos os arquivos sejam armazenados e distribuídos de forma íntegra e confiável, eliminando o risco de inconsistências.
Essas melhorias representam um marco importante na evolução da Square Cloud, consolidando nossa posição como **a plataforma mais moderna e intuitiva para desenvolvedores da nova geração.**
## Plano AINDA MAIS acessível e + DESCONTOS!
Continuamos na nossa missão de ouvir vocês e otimizar cada detalhe da plataforma. Reunimos uma série de **melhorias de performance, novas funcionalidades e ajustes de qualidade de vida** que já estão disponíveis e vão turbinar sua experiência de desenvolvimento. Se liga no que preparamos:
## Novo plano Hobby e descontos = Square Cloud ouvindo você.
Seguindo a filosofia de ir **na contramão do mercado**, trouxemos mais vantagens para o seu bolso.
* **Downgrade em Tempo Real:** Lançamos o novo sistema de **downgrade instantâneo**. Sem espera, sem burocracia, você no controle total do seu plano.
* **Novo Plano Hobby Acessível:** Introduzimos o plano Hobby com dois tiers, com preços a partir de **R\$ 9,99/mês** no ciclo anual.
* **MAIS DESCONTOS, PORQUE VOCÊS MERECEM:** Aumentamos os descontos! Agora são **10% para o plano semestral** e **15% para o anual**.
### Otimizações de performance e velocidade
Deixamos tudo ainda mais rápido para você focar no que importa: seu código.
* **Sincronia instantânea:** Ao atualizar a memória RAM, a CPU agora é ajustada em tempo real, sem qualquer atraso.
* **Realtime ultrarrápido:** Reduzimos a latência em carregamentos primários, com uma melhoria média de 45ms.
- Aprimoramos a velocidade de carregamento ao interagir com bots e sites hospedados na plataforma.
### Mais controle e flexibilidade para Sua Conta
Demos um upgrade nas ferramentas de customização para você ter total autonomia.
* **Subdomínio e runtime editáveis:** Agora você pode editar seu subdomínio (`.squarecloud.app` e `.config`) e definir o `RUNTIME` (javascript, typescript, etc.) diretamente na aplicação. (a documentação para o campo `RUNTIME` sairá em breve).
* **Nova pagina "Minha Conta" e idioma:** Gerencie suas informações em uma página redesenhada e altere a região/idioma para receber e-mails padronizados.
- Aumentamos o limite para até 3 trocas do nome de usuário de sua conta da Square Cloud por dia.
### Melhorias na experiência e interface
Refinamos a interface para um fluxo de trabalho mais limpo e produtivo.
* **Aba de Logs totalmente reescrita:** A aba foi reformulada, incluindo o realtime, e agora permite **deletar todos os registros antigos com um único clique**.
* **Dashboard mais intuitiva:** Adicionamos ícones para cada linguagem na dashboard, facilitando a identificação das suas aplicações.
- Solucionamos um erro que redirecionava cookies permanentemente para a página de login em alguns casos.
### Ajustes Gerais da Plataforma
* A API agora retorna o status `CONTAINER_TEMPORARILY_SUSPENDED` em casos de abuso de requisições para garantir a estabilidade.
* Workspaces inativas de usuários sem planos ativos agora são removidas em até 24 horas.
Essas são apenas **algumas** das novidades que implementamos pensando em vocês. Nosso compromisso é continuar ouvindo a comunidade e evoluindo para ser **a melhor e mais completa plataforma para os desenvolvedores da nova geração.**
## Nova Documentação em PT-BR e Suporte a PostgreSQL!
Ouvimos novamente a comunidade e trouxemos algumas novidades bem maneiras, focando em melhorar a experiência dos desenvolvedores na nossa plataforma. Chegou a hora de apresentar uma série de melhorias — algumas já estão disponíveis há alguns dias, mas podem ter passado despercebidas. Confira abaixo:
### Documentação Totalmente Renovada em Português
Criamos uma documentação de primeira linha, pensada para o desenvolvedor brasileiro.
* 100% em Português (BR): Não é uma tradução, mas um conteúdo totalmente localizado, incluindo imagens e tutoriais.
* Conteúdo Abrangente: Novos guias, tutoriais para cenários específicos e informações detalhadas sobre a plataforma.
Confira: **[https://docs.squarecloud.app/pt-br/getting-started/overview](https://docs.squarecloud.app/pt-br/getting-started/overview)**
### Suporte a PostgreSQL em Escala Empresarial
Crie seu banco de dados PostgreSQL com performance e segurança de nível profissional.
* Sem limite de transferência de rede de saída e entrada.
* IOPS generosos com NVME Enterprise.
* Certificado peer-to-peer exclusivo por database (mTLS).
* Memória e CPU dedicadas conforme plano.
* Snapshots diários inteligentes.
* MySQL será disponibilizado nos próximos dias.
* A Square Cloud não lança serviços que não estejam prontos para produção.
### Snapshots mais rápidas
Otimizamos a performance e a estabilidade do nosso sistema de backups.
* Desempenho: Dobramos a largura de banda interna, processando até 1.000 snapshots por minuto.
* Restauração instantânea e gratuita de qualquer snapshot dos últimos 30 dias.
## Atualização de Ambientes
Estamos sempre aprimorando nossos serviços para garantir que você tenha acesso às versões mais recentes e estáveis das principais linguagens de programação. Confira as novidades desta atualização!
### Novas versões disponíveis:
* **JavaScript \[Node.js]** → Recomendado: 22.18.0 | Última: 24.5.0
* **Python** → Recomendado: 3.13.6 | Última: 3.13.6
* **Elixir** → Recomendado: 1.18.4 | Última: 1.18.4
* **Rust** → Recomendado: 1.89.0 | Última: 1.89.0
* **Go** → Recomendado: 1.24.6 | Última: 1.24.6
* **PHP** → Recomendado: 8.4.11 | Última: 8.4.11
\-- Suporte aprimorado para Redis & MongoDB, com suporte nativo a biblioteca escrita em C para Redis.
O que isso significa para você?
* Mais estabilidade e compatibilidade com aplicações modernas.
As atualizações já estão disponíveis. 😄
## Melhoria Geral na Plataforma (MUITAS NOVIDADES INCRÍVEIS!)
Recentemente, concentramos nossos esforços em **revolucionar** a experiência dos desenvolvedores na nossa plataforma. Chegou a hora de apresentar uma série de **novidades poderosas** — algumas já estão disponíveis há alguns dias, mas podem ter passado despercebidas. Confira abaixo as melhorias que já estão no ar:
### Variáveis de Ambiente 100% Integradas
* Agora você pode definir variáveis de ambiente diretamente pelo deploy ou via API.
* As variáveis são injetadas automaticamente com um simples **restart** da aplicação. Sem necessidade de usar `.env` ou pacotes extras!
* Rotas públicas disponíveis para **POST, PUT, DELETE e GET** das variáveis.
### Novo Sistema de Snapshots (adeus, backups manuais)
* Limites extremamente generosos: cada plano pode gerar `(RAM / 256) * 2` snapshots por dia. Ex: plano Hobby com 2048MB = **16 snapshots diários** ou até **480/mês**!
* **Restauração instantânea e GRATUITA** — recupere qualquer snapshot dos últimos 30 dias em segundos. (liberação gradual para todos nos próximos dias)
* A Square está indo **na contramão do mercado**: sem cobranças, sem enrolação.
### Start Configurável em Tempo Real
* Esqueça o redeploy só pra mudar o start script. (campo START de seu arquivo de configuração).
* Agora você pode **editar a linha de START diretamente**, reiniciar o app e pronto. Tudo em tempo real e sem complicações.
### Bancos de Dados Avançados (Redis & Mongo disponíveis!)
* Crie seu banco de dados de verdade com apenas 1 clique.
* Certificado **peer-to-peer exclusivo** por database (nada de certificados genéricos). (mTLS)
* Memória ram e processamento de seu plano, com total performance dedicada ao banco de dados.
* 10GB de armazenamento empresarial incluso com planos futuros de expansão.
* Snapshots **diários e automáticos**.
* Sistema de snapshots **inteligente e pró-ativo**: detecta deleções suspeitas e cria backup emergencial (beta).
* Sem limitação de banda e até **512 conexões simultâneas** por banco.
* Reset de certificado e senha em **um clique**.
* Bancos já disponíveis: **Redis** e **MongoDB** — novos bancos em breve!
### Dashboard + rápida e fluída.
* Nova guia de "Configurações" dentro de uma aplicação.
* Aba de Deploys movida para Configurações → Deploys.
* Aba dedicada de Variáveis de Ambiente (Configurações → Variáveis de Ambiente).
* Página de Configurações agora segmentada em **5 sessões** para facilitar a navegação: Geral, Deploys, Variáveis de Ambiente, Network e Zona de Risco.
* Nova página de Preços e nova página sobre a infraestrutura Square Cloud Enterprise e seus planos exclusivos (/enterprise).
* Nova guia Analytics (visualização de novos dados e gráficos interativos), com insights extremamente precisos e aprimorados para websites hospedados na Square Cloud.
* Novo envio de aplicações, mais fluído e bonito, com detecção automática de variáveis de ambiente por meio do arquivo .env ou do contexto interno (importação automática). Ah, você também pode colar variáveis usando Ctrl+C e Ctrl+V.
* A API agora retorna registros de realtime com precisão cirúrgica desde o start da aplicação.
Essas são apenas **algumas** das melhorias que estamos liberamos para vocês. Continuamos ouvindo a comunidade e trabalhando diariamente para tornar a Square Cloud **a melhor plataforma para desenvolvedores da nova geração.**
Obs.: reduzimos bastante e compactamos bastante as notas de atualização, mudamos muita coisa nas últimas semanas e focamos em melhorar a sua experiência, agradecemos a todos que participaram ou participam de nossos programas de acesso antecipado ou beta tests. @everyone
## Atualização Geral de Segurança e Performance
Recentemente, focamos esforços em aprimorar a performance de alguns serviços críticos da Square Cloud.
### Segurança e Criptografia
* **TLS Mínimo:** Agora exigimos TLS 1.2 como padrão para toda a Square Cloud, incluindo domínios personalizados.
* **Domínios personalizados:** Todos os domínios personalizados foram configurados para um mínimo de TLS 1.2.
* **Domínios proprietários da Square Cloud:** Para domínios de combate a phishing e escopos empresariais, o TLS mínimo é 1.3.
### Gerenciamento de Logs
* **Limitação de Logs em Aplicações:** O número máximo de logs por categoria (logs/crash) em arquivos `.squarecloud` foi reduzido de 10 para 5.
* **Mudança de Infraestrutura de Logs:** Migramos nossa infraestrutura de logs para uma stack de observabilidade nova, mais moderna e escalável.
* **Cobertura e retenção de Logs:** Agora registramos 100% das requisições para nossa infraestrutura principal (API, Website, Blob, etc.), com uma retenção de dados 7 vezes maior.
### Otimização de Performance
* **Pré-processamento de Ativos:** Melhoramos o pré-processamento de ativos em nossa infraestrutura, resultando em maior capacidade de processamento (throughput).
* **Otimização IAM:** Otimizamos a codificação (encoding) de cada camada de validação do IAM (Identity and Access Management).
* **Desempenho do Blob:** As ações diretas no Blob estão 20-35% mais rápidas, e o registro de logs completo foi implementado.
### Melhorias na API e Ambientes
* **Nova Query para Status de Aplicações:** A rota `/v2/apps/status` agora aceita a query `"workspaceId"` para facilitar a coleta de dados de estado.
* **Mensagens de Erro Mais Claras:** Os ambientes agora retornam mensagens de erro específicas como `"CONTAINER_ALREADY_STARTED"` ou `"CONTAINER_ALREADY_STOPPED"`, em vez do genérico `"ACTION_FAILED"`, para cenários diretos.
Curiosidades sobre a Square Cloud:
Mesmo esse sendo um servidor da comunidade da Square Cloud, somos, atualmente, o **segundo maior servidor de programação do Discord brasileiro**, atrás apenas da Rocketseat.
### Atualização de API – Suporte Estendido para Workspaces
Estamos empolgados em anunciar a adição de novas rotas na API para facilitar a gestão completa de **workspaces**, **aplicações** e **membros**. Esta atualização proporciona maior controle e flexibilidade para desenvolvedores e administradores de equipe.
### Workspaces
* `GET /v2/workspaces`: Lista todas as workspaces do usuário autenticado.
* `GET /v2/workspaces/:workspaceId`: Recupera os detalhes de uma workspace específica.
* `POST /v2/workspaces`: Cria uma nova workspace.
**Body:** `{ name: string }`
**Validação:** Nome deve seguir o regex `/^[\w ]{1,32}$/`.
* `DELETE /v2/workspaces`: Remove uma workspace existente.
**Body:** `{ workspaceId: string }`
* `DELETE /v2/workspaces/leave`: Permite que um usuário saia de uma workspace.
**Body:** `{ workspaceId: string }`
### Workspaces – Aplicações
* `POST /v2/workspaces/applications`: Associa uma aplicação a uma workspace.
**Body:** `{ workspaceId: string, appId: string }`
* `DELETE /v2/workspaces/applications`: Remove uma aplicação de uma workspace.
**Body:** `{ workspaceId: string, appId: string }`
### Workspaces – Membros
* `GET /v2/workspaces/members/code`: Gera o código de convite para novos membros entrarem em uma workspace.
* `POST /v2/workspaces/members`: Adiciona um novo membro à workspace usando um código de convite.
**Body:** `{ workspaceId: string, code: string, group: string }`
* `PATCH /v2/workspaces/members`: Atualiza o grupo de um membro dentro da workspace.
**Body:** `{ workspaceId: string, memberId: string, group: string }`
* `DELETE /v2/workspaces/members`: Remove um membro da workspace.
**Body:** `{ workspaceId: string, memberId: string }`
As workspaces agora adotam o modelo de ID único da Square (40 caracteres).
Agora a Square não deleta a workspace quando o plano do criador da mesma expira.
Por padrão **redefinimos todas as equipes da plataforma**, ou seja: **equipes criadas antes desse marco de atualização foram excluídas**.
Essas mudanças visam tornar a gestão de workspaces mais robusta, colaborativa e eficiente. 🚀
Alterações gerais:
* Nova rota para listagem GLOBAL de cópias de segurança: `/v2/users/backups` (GET).
* A rota de listagem do status global de aplicações agora por padrão só lista o status de suas aplicações, aplicações de workspaces necessitam da query: workspaceId.
Para mais detalhes técnicos, consulte a documentação oficial da API.
> Uma nova atualização na documentação deverá ser publicada em até 24 horas.
## Atualização de Ambientes
Estamos sempre aprimorando nossos serviços para garantir que você tenha acesso às versões mais recentes e estáveis das principais linguagens de programação. Confira as novidades desta atualização!
### Novas versões disponíveis:
* **JavaScript \[Node.js]** → Recomendado: 22.15.1 | Última: 24.0.2
* **Python** → Recomendado: 3.13.3 | Última: 3.13.3
* **Elixir** → Recomendado: 1.18.3 | Última: 1.18.3
* **Rust** → Recomendado: 1.87.0 | Última: 1.87.0
* **PHP** → Recomendado: 8.4.7 | Última: 8.4.7
* **Go** → Recomendado: 1.24.3 | Última: 1.24.3
### Novidade para ambientes PHP:
Node.js v22 atualizado & npm atualizado por padrão. COMPOSER\_HOME definido como application (base de seu projeto), também melhoramos a interoperabilidade geral de ambientes PHP.
1. * Extensões ativas por padrão:
`pdo`, `pdo_mysql`, `pdo_pgsql`, `pdo_sqlite`, `pgsql`, `mysqli`, `mbstring`, `exif`, `pcntl`, `bcmath`, `gd`, `zip`, `opcache`, `sockets`, `intl`, `ldap`, `xml`, `tidy`, `xsl`, `gmp`, `sodium`, `curl`, `ctype`, `fileinfo`, `posix`, `simplexml`, `xmlreader`, `xmlwriter`, `dom`.
2. Bibliotecas e dependências foram aprimoradas, garantindo melhor integração com frameworks para PHP. Lista:
`build-essential`, `git`, `curl`, `wget`, `unzip`, `sqlite3`, `libonig-dev`, `libsqlite3-dev`, `libpq-dev`, `libzip-dev`, `libpng-dev`, `libjpeg-dev`, `libfreetype6-dev`, `zlib1g-dev`, `libssl-dev`, `libcurl4-openssl-dev`, `libldap2-dev`, `unixodbc-dev`, `libicu-dev`, `libxslt-dev`, `libtidy-dev`, `libmemcached-dev`, `libxml2-dev`, `libevent-dev`, `libgmp-dev`, `libreadline-dev`, `libargon2-dev`, `libsodium-dev`, `ca-certificates`, `gnupg`, `nodejs`.
💡 **O que isso significa para você?**
* Maior estabilidade e segurança em todos os ambientes.
* Mais compatibilidade para aplicações modernas e com foco em produção.
As atualizações já estão disponíveis. 😄
Obs.: O suporte ao Redis será lançado em breve na versão 7.4.0, inicialmente em modo de testes abertos com os usuários.
## Mudanças técnicas e de balanceamento geral.
Durante a última semana, realizamos uma série de ajustes visando melhorar a performance e estabilidade da nossa API. A seguir, os principais destaques:
`/v2/apps/status`
* Agora retorna os status em **tempo real**, sem uso de cache.
* Novo limite de **15 requisições por 60 segundos** (rate class: `KEEP CALM`).
`/v2/apps/:appId/logs`
* Redução no cooldown entre solicitações: de **10s para 5s**.
`/v2/apps/:appId/metrics`
* **Aumento de taxa e throughput**.
* Saída agora com **compactação habilitada**.
* Novo limite: **10 requisições a cada 5 segundos**.
`/v2/apps/:appId/commit`
* Redução do cooldown: de **5s para 3 segundos**.
POST `/v2/apps`
* Redução do cooldown: de 10s → 5s → **agora: 3 segundos**.
DELETE `/v2/apps/:appId`
* Novo limite de execução: **1 requisição por segundo**.
* Isso evita falhas humanas que possam gerar impactos graves a integridade das aplicações do usuário.
Também atualizamos globalmente alguns tópicos importantes na Square Cloud.
**1. Domínios personalizados:** O sistema agora **remove automaticamente** domínios com DNS pendente, inativos, deletados ou movidos há mais de **24h**.
**2. Integração com Github:** Cooldown global reduzido entre deploys de mesmo ID: 90s → 60s → **agora: 30 segundos**.
**3. Deploys (globalmente) e commits gerais:** Corrigido um problema em que requisições mal formatadas (ex: `Content-Type` incorreto) resultavam em **timeouts pela proxy**.
Agora retornamos um erro claro e amigável para o desenvolvedor, com código de erro para correção.
\*\*4. Notas fiscais:\*\*A descrição do serviço agora exibe o **ID da conta**, substituindo o e-mail.
Essa mudança visa evitar erros de validação causados por limitações da Prefeitura de Goiânia com certos caracteres.
\*\*5. Compactação global:\*\*Obs.: isso foi **incluso gratuitamente em todos os planos**, sem qualquer custo e sem limites.
* Ativamos uma camada extra de compactação em respostas de nossa API, websites em nossa infraestrutura e ativos na Web.
* Você deve detectar respostas de suas aplicações na web de forma aprimorada (em específico respostas de APIs que retornam muitos dados para download).
* Compactação aplicada somente se possível, na ordem: **ZSTD → Brotli → Gzip → \[sem compactação]**. (é exatamente nessa ordem).
Curiosidades sobre a Square Cloud:
Você sabia que a Square Cloud é a maior plataforma de hospedagem de bots do Discord da América Latina? 🥰
Obs.: Nunca realmente imaginaríamos que cresceríamos tanto. Também nunca investimos pesado em marketing, isso é bem visível se formos analisar alguns números e trabalhar em cima de dados triangulados, podemos afirmar com uma precisão boa de que: cerca de **70% dos nossos clientes vêm de recomendações**.
Essas melhorias reforçam nosso compromisso com a performance, clareza e segurança da sua experiência com a Square Cloud.
## Melhoria na experiência do usuário.
Aproveitamos os últimos dias do feriadão para focar em aprimorar a experiência geral do nosso site, trazendo melhorias importantes que tornam a navegação mais fluida, rápida e intuitiva.
1. Nova página de Resgate. `/account/redeem`
Removemos completamente aquele botão e modal chatinho da página inicial do dashboard e criamos uma página exclusiva para resgate de códigos.
2. Novo layout na Dashboard.
Melhoramos consideravelmente a experiência em dispositivos móveis, agora a página inicial do dashboard ocupa menos espaço inicial, melhorando a experiência de navegação. Corrigimos também diversos problemas que causavam estranheza no carregamento de algumas funções.
3. Ações no context menu.
Agora é possível realizar ações rápidas como: iniciar, reiniciar e parar uma aplicação diretamente pelos 3 pontinhos de uma aplicação lá no dashboard.
4. Melhoria na visualização de logs
A aba de 'Logs' da aplicação foi significativamente aprimorada, proporcionando uma visualização mais clara dos registros e um carregamento muito mais rápido.
4. Calculadora do Blob.
A página do serviço Blob agora conta com um novo layout e uma calculadora bem legal, possibilitando ter uma noção de um custo futuro que poderá ter utilizando nosso serviço de Blob, vale ressaltar que o preço do GB e Objetos não foi totalmente definido ainda. (Não há faturamento ativo no Blob).
Também aprimoramos a experiência de renovação de planos e corrigimos diversos bugs no front-end que impactavam essa ação em nosso site. Além disso, realizamos otimizações que melhoraram a performance geral da plataforma.
Outras atualizações diversas:
1. Melhoramos a experiência de faturas, agora uma fatura é cancelada automaticamente após 24h de sua data de criação (em caso de não pagamento).
2. Aprimoramos a estabilidade geral de nossa API e reduzimos o custo de infraestrutura em 27% utilizando novos algoritmos de tratamento com streams e reduzindo o custo com ações repetitivas.
3. Corrigimos um bug que ocasionava em uma troca inferior a uma margem segura dos IPs nos clusters, o que causava um efeito 'rebote' e a mesma aplicação recebia o mesmo ip em alguns cenários específicos. Em termos mais simples: aprimoramos a estabilidade de toda a rede. 😌
Curiosidade sobre a Square Cloud:
Nos últimos 7 dias processamos 532 milhões e 59 mil solicitações em nossa infraestrutura. Um número bem expressivo né? 🤪
> O que acham de toda changelog eu trazer uma curiosidade aleatória? Acho que é um jeito legal de aproximarmos a comunidade.
## Reformulação das páginas de erro.
Alteramos o funcionamento e melhoramos a experiência de todas as páginas de erro do escopo web de nossa plataforma.
1. "Esse site pode ser seu."
Ao acessar um subdomínio (squareweb.app) que ainda não existe, os visitantes visualizarão uma página elegante e explicativa informando que aquele endereço está disponível, ou seja: que pode ser facilmente ativado por meio de um deploy. Uma forma simples e intuitiva de mostrar o potencial da Square Cloud. (e obviamente facilitar a sua vida como desenvolvedor)
2. "O site demorou demais para responder..."
Se o seu website estiver mal configurado (por exemplo, escutando na porta ou host incorreto) ou passar por instabilidades momentâneas, seus visitantes não verão mais uma tela fria de erro. Em vez disso, mostramos automaticamente uma página traduzida para diversos idiomas, explicando de forma clara o que ocorreu, e melhor: com uma tentativa automática de reconexão após alguns segundos. Isso reduz a perda de tráfego e melhora a percepção do seu site mesmo durante falhas pontuais.
Tudo isso faz parte do nosso compromisso em entregar uma plataforma cada vez mais inteligente, prática e focada em você. 💙
3. Tráfego otimizado e roteamento exclusivo.
Otimizamos significativamente o tráfego de rede entre nossos clusters e proxies, reduzindo a latência e tornando a entrega de conteúdo ainda mais eficiente e rápida para todos os sites hospedados na Square Cloud. Agora, seus visitantes acessam seu site com mais agilidade, independente da localização ou volume de acessos.
E pra quem gosta de curiosidades técnicas: nos últimos 30 dias, a Square Cloud processou mais de **5,41 bilhões de solicitações**. Isso equivale a cerca de **67% da população mundial**, considerando os atuais 8 bilhões de habitantes da Terra. 😎
ps.: é como se uma a cada 2 pessoas no planeta terra, 1 pessoinha e meia (não divida uma pessoa ok) tivesse enviado uma solicitação para nossos serviços, é bastante coisa 😌
## Atualização na Dashboard
Estamos sempre aprimorando nossa dashboard para garantir que você tenha acesso a melhor experiência possível. Confira as novidades desta atualização!
1. **Agora é possível favoritar aplicações:**
Favorite aplicações por navegador/dispositivo diretamente na dashboard. Basta clicar nos 3 pontinhos (`···`) e selecionar a opção `Favoritar`.
> No futuro sincronizaremos isso para todos os dispositivos.
2. **Agora é possível importar seu projeto diretamente via GitHub:**
Você pode importar projetos do GitHub clicando em "Importar via GitHub" na página de upload ou acessando diretamente o link: [Importar via GitHub](https://squarecloud.app/pt-br/dashboard/new?type=github).
3. **Melhoria na função de desconexão de sessões:**
Por questões de segurança, agora você pode desconectar todas as suas sessões simultaneamente e imediatamente, caso suspeite de alguma atividade anormal em sua conta, opção disponível
4. **Nova aba de Minha Conta:**
A página de conta da Square Cloud foi completamente reformulada para tornar sua navegação mais simples e organizada. Agora, ela é dividida em seções específicas, com rotas dedicadas para cada funcionalidade:
* **Informações da conta** — `/account`
Visualize e edite seus dados pessoais e preferências da conta.
* **Armazenamento Blob** — `/account/blob`
Gerencie seus arquivos e dados armazenados de forma prática.
* **Minhas faturas** — `/account/invoices`
Acompanhe seu histórico de pagamentos, planos e baixe comprovantes.
* **Conexões da conta** — `/account/connections`
Visualize e controle todas as integrações conectadas à sua conta.
* **Segurança e Autenticação** — `/account/security`
Gerencie seu código de conta, chave de API e sessões ativas com segurança.
5. **Histórico de faturamento disponibilizado:**
Agora você pode visualizar todas as suas faturas diretamente na página [Faturas](https://squarecloud.app/pt-br/account/invoices).
6. **Novo design para pagamentos via PIX:**
A página de pagamento via PIX foi reformulada, adotando um design mais moderno e intuitivo.
7. **Melhoria no file manager do Blob:**
Agora ao realizar um envio de um arquivo no armazenamento blob por meio de nossa dashboard, se o campo de nome do arquivo estiver vazio, o sistema preencherá automaticamente o campo com o nome de origem do arquivo anexado. Também melhoramos o feedback ao excluir múltiplos arquivos do armazenamento blob, oferecendo mais clareza e agilidade na ação.
## Atualização de Latência Geral
Otimizamos a infraestrutura de backups, deploys e armazenamento de blobs, melhorando o posicionamento da distribuição e gerando ganhos importantes de desempenho.
Outras melhorias gerais importantes:
1. **Monitoramento e notificações via e-mails.**:
> Obs.: incluso GRATUITAMENTE em TODOS os planos, não cobramos por isso. 😉😆
Resumidamente: agora, enviamos e-mails informativos caso sua aplicação enfrente problemas de memória RAM, CPU ou rede, garantindo respostas mais rápidas e eficientes para qualquer incidente.
2. **Reescrita completa do Blob Storage**:
Atualização de status de uso: Agora, os status de uso, que anteriormente eram atualizados a cada 12 horas, são atualizados a cada 1 minuto, proporcionando informações mais em tempo real.
Delete de objetos: A rota de exclusão de objetos agora não permite mais exclusões em bulk de até 100 itens. A exclusão de cada objeto é feita individualmente, evitando abusos e otimizando a carga na nossa infraestrutura.
Novo padrão de segurança: Implementamos um novo método de geração de hashes de segurança, que agora gera um hash 16 vezes maior que o anterior, tornando nossos ativos privados mais seguros.
3. **Desempenho e Latência**:
Envio de ativos: A latência de envio de ativos foi reduzida em média em 23%, proporcionando uma experiência mais rápida para o upload e acesso aos seus dados.
Retorno de ativos: O tempo de resposta ao acessar URLs de ativos foi acelerado em até 30% em diversos cenários, devido a melhorias de roteamento de infraestrutura e testes regionais de entrega.
Métricas de aplicações: As **métricas de aplicações** foram reescritas e agora **são retornadas**, **em média, em 200ms, comparado aos 800ms anteriores**, proporcionando uma visão mais rápida e eficiente do desempenho das suas aplicações.
4. **Futuro em Expansão**:
Estamos planejando expandir ainda mais nossa infraestrutura global, o que nos permitirá eliminar a dependência de caches externos como o da Cloudflare, garantindo que seus ativos, mesmo com um tamanho superior a 100MB, possam ser entregues sem custos adicionais de rede.
Também corrigimos um erro que gerava o retorno "Access Denied" na API, quando, na verdade, o correto seria um "RateLimit" (429) em alguns casos. Agora, o comportamento da API está adequado para esses cenários.
## Atualização nas Seções de Restrições
Com a finalidade de aumentar a transparência e a conformidade com as normas internacionais, comunicamos uma revisão em nossas diretrizes de restrições comerciais. De agora em diante, forneceremos mais detalhes sobre as proibições ditadas por legislações como o FCPA, IEEPA, EAR e outras diretrizes pertinentes, que influenciam o comércio e o uso de nossos serviços por empresas de tecnologia da informação.
Adicionalmente, estamos ampliando as restrições existentes, fundamentando-nos em práticas já estabelecidas por empresas dos Estados Unidos, para assegurar que nossas operações atendam aos critérios do mercado global. Essas alterações têm como objetivo reforçar a segurança, a conformidade legal e a transparência nas transações internacionais, especialmente em relação a países que estão sob sanções.
Com uma infraestrutura de data centers resiliente e um compromisso rigoroso com as normas, a Square Cloud permanece dedicada a proporcionar um ambiente seguro e conforme para todos os nossos usuários.
Importante destacar que, por mais que sejamos uma empresa 100% brasileira, nossas operações seguem as legislações locais e internacionais aplicáveis aos nossos serviços.
## Atualização de estabilidade geral
Aumentamos o limite base de logs (via api) para `1000 linhas`. (anteriormente: `100 linhas`).
Removemos globalmente de nossa api o parâmetro `requests` (enviado na rota de status) (deprecated há \~6 meses).
Reduzimos o ratelimit de integrações via github (por meio de webhook) para `60 segundos`. (anteriormente: `90 segundos`).
A Square Cloud não envia mais sinais de `SIGTERM` com prazo de `5 segundos`, a partir de hoje (22/03/2025) enviamos o sinal `SIGINT` com tempo limite de `3 segundos`. Isso foi feito para garantir uma melhor compatilidade com diversos frameworks e para uma maior estabilidade geral.
A Square Cloud força permissões em todos os commits e inicializações de forma completa agora (não mais só sobre o escopo fora de execução) ou seja: forçamos permissões mesmo que sua aplicação esteja completamente em execução/parada de forma igualitária, reduzindo a probabilidade de erros de EACCESS ou similares. Também aplicamos uma nova lógica de inicialização, reduzindo a carga geral.
⚠️ **Adendo para quem usa Next.js: [https://nextjs.org/blog/cve-2025-29927](https://nextjs.org/blog/cve-2025-29927)**
## Atualização nos limites
Temos uma grande novidade: **aumentamos os limites de requisições da API** em todos os planos, e o melhor de tudo... **sem custo adicional!** 🎉
Agora você pode fazer muito mais requisições por dia! Confira os novos números baseado no aumento diário de limites:
* **Standard:** 144.000 req/dia (+14.400 requisições/dia adicionadas)
* **Advanced:** 216.000 req/dia (novo plano)
* **Pro:** 432.000 req/dia (+216.000 requisições/dia adicionadas)
* **Enterprise-24:** 864.000 req/dia (novo plano)
* **Enterprise-32:** 1.152.000 req/dia (+864.000 requisições/dia adicionadas)
Categoria **Enterprise passará a suportar proporcionalmente** até ****36.864.000 requisições por dia****, antigamente o maior limite era de: 2,448,000 milhões.
Outras mudanças:
* Plano Hobby deixará de suportar o sistema de áreas de trabalho (antigas equipes) e não terá acesso ao [Blob](https://squarecloud.app/blob) de forma faturável (ainda terá acesso a quota gratuita), por ser alterado para um plano de foco de uso pessoal, em contrapartida, aumentamos os limites de membros por área de trabalho para todos os planos:
* **Advanced:** suportará 5 membros/área.
* **Pro:** suportará 7 membros/área.
* **Enterprise-24:** suportará 10 membros/área.
Enterprise 32, 48, 64, 160 em diante suportarão: 15, 20, 30 e infinito/membros por área de trabalho.
Essa atualização garante maior escalabilidade para seus projetos, permitindo que você foque exatamente em sua máxima eficiência. 😎
## Proxies
Reescrevemos completamente todas as proxies da Square Cloud **do zero**, trazendo uma infraestrutura mais eficiente, estável e escalável. Essa mudança abrange todas as proxies da plataforma, incluindo:
* 🌐 **squareweb.app (subdomínios)** – Melhor desempenho e menor latência para aplicações web.
* 🔗 **Domínios personalizados** – Novo roteamento otimizado, garantindo tempos de resposta mais rápidos.
* 🏗 **Clusters individuais** – Cada cluster agora conta com uma proxy dedicada exclusiva distribuindo melhor a carga.
Além das melhorias estruturais, **expandimos nossa capacidade para suportar mais de 100 bilhões de solicitações mensais sem qualquer problema esperado**, um avanço significativo em relação ao limite teórico anterior de aproximadamente **23 bilhões**.
Essa atualização garante maior estabilidade, segurança e escalabilidade, permitindo que nossos usuários operem com máxima eficiência. 😎
## Conformidade
Em conformidade com a LGPD, GDPR e demais legislações aplicáveis, informamos que realizamos a remoção de 40.667 contas inativas há mais de 730 dias (2 anos) de nossa plataforma. Essa ação reforça nosso compromisso com a privacidade, segurança dos dados e conformidade regulatória.
## Infraestrutura
Atualizamos toda a nossa infraestrutura para garantir maior eficiência e desempenho. Com essa atualização, aprimoramos a latência base entre clusters, reduzindo em aproximadamente 2 a 5 ms o tempo de resposta em interações internas, o que otimiza diversas operações, especialmente para usuários mais avançados.
Além disso, realizamos melhorias estratégicas no fluxo de nossas proxies, preparando a Square Cloud para lidar com volumes de tráfego superiores a 5 bilhões de solicitações mensais. Atualmente, nossa infraestrutura processa cerca de 1,3 bilhão de requisições por mês, e essas otimizações garantirão escalabilidade, resiliência e desempenho aprimorado para nossos usuários.
## Dashboard
Nossa dashboard passou por diversas melhorias para oferecer uma experiência mais ágil, intuitiva e eficiente. Confira as principais novidades:
🔹 **Nova interface aprimorada**
* Pequenos refinamentos visuais para tornar a navegação mais fluida e acessível.
* Melhor organização das informações para facilitar a gestão dos seus projetos.
* Nova sessão exclusiva para gerenciamento de conta ("Minha Conta").
**Desempenho otimizado**
* Reduzimos o tempo de carregamento de páginas, garantindo maior rapidez na exibição dos seus dados.
* Melhoramos a sincronização em tempo real, proporcionando atualizações mais rápidas e precisas.
🛠️ **Novos recursos e ajustes**
* Aperfeiçoamos o sistema de registros, permitindo um monitoramento mais detalhado e eficiente.
* Pequenos bugs foram corrigidos para garantir mais estabilidade e confiabilidade.
**Conexão com o Discord**
Receba o seu carguinho maravilhoso conectando a sua conta do Discord a sua conta da Square Cloud 🙂
Acesse: [https://squarecloud.app/pt-br/account](https://squarecloud.app/pt-br/account), desça a página e realize a conexão.
\*por se tratar de uma conexão em testes, a Square pode redefinir a conexão em caso de falha durante esse período de autorizações 😄
## Atualização de Ambientes
Estamos sempre aprimorando nossos serviços para garantir que você tenha acesso às versões mais recentes e estáveis das principais linguagens de programação. Confira as novidades desta atualização!
### Novas versões disponíveis:
* **JavaScript \[Node.js]** → Recomendado: 22.13.1 | Última: 23.7.0
* **Python** → Recomendado: 3.13.1 | Última: 3.13.1
* **Java** → Recomendado: JDK 23 | Última: JDK 25
* **Elixir** → Recomendado: 1.18.1 | Última: 1.18.1
* **Rust** → Recomendado: 1.84.1 | Última: 1.84.1
* **PHP** → Recomendado: 8.4.3 | Última: 8.4.3
* **Go** → Recomendado: 1.23.6 | Última: 1.23.6
* **C#** → Recomendado: 9.0.1 | Última: 9.0.1
* **HTML/CSS** → Build 10-02-2025
### Novidade para sites estáticos:
Agora, o ambiente oferece suporte ao arquivo `vite.html`, facilitando a hospedagem de sites exportados pelo **Vite**. Além disso, um `404.html` será criado por padrão para melhorar a experiência de navegação.
💡 **O que isso significa para você?**
* Maior estabilidade e segurança em todos os ambientes.
* Mais compatibilidade para aplicações modernas e com foco em produção.
As atualizações já estão disponíveis. 😄
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.