Convex

O que é Convex?

Convex é uma plataforma de backend reativo que combina banco de dados, funções de servidor e bibliotecas cliente. Suas consultas são código TypeScript executado junto ao banco de dados, e os resultados assinados reagem às alterações nos dados armazenados.

O banco de dados em tempo real da Convex usa um modelo de dados relacional enquanto armazena documentos semelhantes a JSON. Esquemas são opcionais, documentos podem referenciar documentos de outras tabelas e o código do aplicativo lê e grava por uma API JavaScript, em vez de SQL.

A Convex também oferece acesso gerenciado a modelos de IA pelo AI Gateway. Esse serviço é chamado por ações do backend; a Convex guarda as credenciais dos provedores e os tokens de acesso de curta duração ficam restritos a uma implantação.

Principais funcionalidades

Consultas, mutações e ações

Os tipos de função definem diferentes limites de execução:

• Consultas leem dados, são armazenadas em cache e aceitam assinaturas reativas.
• Mutações gravam dados e são executadas como transações de banco de dados.
• Ações chamam APIs externas. Não são transacionais nem armazenadas em cache.
• Ações HTTP expõem endpoints para webhooks ou clientes personalizados.

Acesso gerenciado a modelos

O AI Gateway oferece rotas para geração de texto, embeddings, decisões, imagens, vídeos, geração de voz e transcrição. Decisions, Voice e a geração de imagens e vídeos estão em alfa; os formatos de solicitação e resposta podem mudar.

Guia

Conectar uma interface React

Um backend Convex existente conecta-se a uma interface React por estes elementos:

1. Crie um ConvexReactClient para a implantação e passe-o a um ConvexProvider que envolva a árvore de componentes.
2. Leia dados do backend com useQuery e o objeto api gerado. O comando de desenvolvimento gera o objeto em convex/_generated/api.js, com preenchimento automático de JavaScript e tipos TypeScript de ponta a ponta.
3. Altere dados com useMutation. O hook retorna uma função assíncrona; chamá-la com seus argumentos executa a mutação.

Casos de uso da Convex

• Interfaces de chat ao vivo: a Convex oferece um tutorial de aplicativo de chat em tempo real com mensagens persistentes e atualizadas ao vivo.
• Busca semântica e recomendações: a busca vetorial encontra documentos semelhantes a um vetor fornecido. Os usos documentados incluem contexto para aplicativos de LLM e recomendações de conteúdo relacionado.
• Agentes persistentes: o componente Agent preserva o histórico de conversas entre sessões e separa trabalhos longos de IA da interface reativa. Ele aceita busca híbrida vetorial e textual no histórico e enriquecimento de prompts baseado em RAG com outras fontes pelo componente RAG ou por implementação personalizada.
• Trabalhos adiados e recorrentes: funções agendadas executam uma vez mais tarde, enquanto tarefas cron se repetem. Exemplos incluem e-mails de boas-vindas e conciliação de contas; os componentes Workpool e Workflow adicionam filas ou fluxos duráveis com tentativas e atrasos.

Para Quem É

• Desenvolvedores de aplicativos JavaScript e TypeScript: o backend TypeScript também aceita JavaScript; funções são expostas pelas APIs das bibliotecas cliente, adequadas a equipes responsáveis pelo código de interface e servidor.
• Equipes que buscam operação hospedada: a Convex posiciona seu produto hospedado como menos trabalhoso de operar; a auto-hospedagem executa o código atual do backend nos servidores da própria equipe.

Plataformas

• Clientes React: ConvexReactClient usa WebSocket para enviar resultados sem polling e se reconecta após perda de conexão.
• Hospedagem do frontend: o frontend pode usar Vercel, Netlify ou hospedagem personalizada, separadamente da implantação do backend.
• Autenticação: conexões e chamadas usam JWTs OpenID Connect. Convex Auth oferece fluxos de cadastro e login no cliente React e React Native, mas segue em beta e tem menos funções que integrações de terceiros.
• Regiões de dados: implantações podem usar Virgínia do Norte, Irlanda, Sydney ou Canadá Central. O uso fora dos EUA tem acréscimo de 30% (1,3 vez as tarifas padrão).

Toda a infraestrutura que sustenta uma implantação fica na região escolhida. Mudar de região exige novo projeto ou implantação e exportação/importação dos dados; uma implantação existente não pode ser movida no lugar.

Preços

Preços coletados em 2 de novembro de 2026 em USD, pela referência exibida do leste dos EUA. Os recursos incluídos são compartilhados entre regiões.

Planos e acesso de desenvolvedores

Business informa mínimo mensal de $2,500; tarifas unitárias de classe de implantação e infraestrutura são publicadas separadamente. Enterprise informa descontos por compromisso anual sem percentual ou total anual numérico.

Recursos Free, Starter e Professional

Cada célula informa quantidade incluída e tarifa adicional. Na primeira coluna, excedentes pagos aplicam-se ao Starter; Free tem cotas fixas. Armazenamento é cobrado por GB/mês; outros recursos, pelas unidades indicadas.

A computação serverless de consultas e mutações é gratuita. Chamadas incluem chamadas de clientes, agendamentos, atualizações de assinaturas e acessos a arquivos. O armazenamento de arquivos inclui backups; a saída inclui acesso a arquivos de funções e geração/restauração de backups. Índices e consultas de texto e vetores compartilham seus respectivos medidores de busca.

O uso é somado entre os projetos da equipe, sem alocação separada por projeto ou desenvolvedor. Excesso prolongado no Free pode causar erros HTTP, mas a Convex afirma que registros de mutação gravados com sucesso nunca são excluídos por exceder recursos. A FAQ cita Starter e também usa “Starter Plus” para tráfego contínuo. Não se infere dessas designações um nível com preço separado.

Tarifas de implantação Business e Enterprise

A matriz mensal do leste dos EUA lista quatro classes; implantações ativas são rateadas diariamente. Outras unidades aparecem em cada linha.

Estes medidores de infraestrutura aplicam-se junto à classe de implantação:

O travessão preserva o valor publicado sem implicar preço zero ou direito incluído.

Cobranças de IA e controles de gastos

O AI Gateway exige equipe paga e aceita implantações de produção/desenvolvimento na nuvem ou locais vinculadas a projeto. Implantações Free e auto-hospedadas não podem usá-lo; ações auto-hospedadas podem chamar provedores com chaves próprias.

Custos do Gateway dependem do modelo, momento, tokens em cache, resolução e duração de imagem/vídeo ou caracteres, segundos e tokens de voz. Aparecem na fatura da Convex; cancelar solicitação de vídeo já enviada ainda pode gerar custo de geração.

Implantações na nuvem aceitam limites diários e mensais de desativação do AI Gateway que desativam toda a implantação, não apenas solicitações de modelos; implantações que não são de desenvolvimento também aceitam limites de aviso. Solicitações locais ligadas a projeto compartilham o limite de gastos da equipe; solicitações em andamento ou que usam credenciais de curta duração já emitidas podem terminar após o limite ser atingido.

Renovação e reembolsos

Taxas não podem ser canceladas nem reembolsadas, salvo exceções contratuais expressas. Order Forms definem ciclos mensais/anuais; excedentes de autosserviço são automáticos e pode haver cobrança intermediária ao atingir um limite de fatura.

Assinaturas de Order Form renovam automaticamente por igual período, salvo aviso de não renovação de qualquer das partes com pelo menos 60 dias antes do vencimento. Se o cliente optar por não renovar automaticamente, a assinatura passa a mensal nas condições e preços atuais; qualquer parte pode encerrá-la com aviso prévio por escrito de 30 dias.

Se a Convex não sanar uma violação material em até 30 dias após receber aviso escrito da violação, o cliente, se for a parte não infratora, pode encerrar o acordo ou os Order Forms afetados por aviso escrito. Se o cliente encerrar o acordo sob essa disposição, a Convex reembolsa a parcela proporcional das taxas pré-pagas não usadas pelo período restante dos Order Forms encerrados na data efetiva do encerramento. É uma exceção contratual, não uma janela geral de reembolso de teste.

Alternativas à Convex

Supabase oferece Postgres por projeto, autenticação, armazenamento com Row Level Security, serviços em tempo real e Edge Functions. Sua base Postgres a torna alternativa relevante para equipes orientadas a SQL.

Firebase Cloud Firestore oferece banco NoSQL para dispositivos móveis, web e servidores, com ouvintes em tempo real e suporte offline para dispositivos móveis e web. Esse comportamento offline documentado trata do acesso desconectado; não estabelece comportamento equivalente na Convex.

Limitações

Limites de transação e execução

• Efeitos externos: ações não são repetidas automaticamente em erros: uma solicitação externa pode já ter produzido efeito. Quem chama cuida das tentativas; promises não concluídas podem ou não terminar após o retorno.
• Transações separadas: ações acessam o banco indiretamente por consultas e mutações. Chamadas separadas a runQuery/runMutation não precisam compartilhar estado consistente; uma consulta/mutação combinada tem limite transacional consistente.
• Tamanho do documento: cada documento tem limite de 1 MiB e profundidade de aninhamento de 16.
• Tamanho da transação: uma consulta ou mutação pode ler no máximo 16 MiB e gravar no máximo 16 MiB. Dados examinados e depois excluídos por filtro ainda contam como leitura.

O guia de ações diz que elas expiram após 10 minutos. A referência de limites, porém, lista 30 minutos para ações no runtime Convex e 10 minutos no runtime Node, além de um segundo de código de usuário de consulta/mutação excluindo operações de banco. As descrições públicas são inconsistentes.

Limites de busca e geração

Busca vetorial é busca aproximada de vizinhos mais próximos, exclusiva de ações, por similaridade de cosseno. A composição dos resultados não é reativa, embora consulta separada possa manter reativos os dados de cada resultado; registros podem mudar ou desaparecer antes da recuperação. Tabelas permitem quatro índices vetoriais com dimensões de 2 a 4.096.

Geração de imagens/vídeos está em alfa, com formatos de solicitação/resposta sujeitos a mudança. Imagens usam prompts de texto, sem edição por imagem de entrada ou máscara. Vídeo síncrono falha após cerca de cinco minutos e permite downloads de 64 MiB; cancelamento, tempo esgotado ou respostas perdidas ainda podem gerar custo. Operações assíncronas expiram após sete dias; provedores podem reter vídeos por menos tempo.

Licença de auto-hospedagem

A licença fair-source FSL Apache 2.0 do backend exclui criar produto projetado para competir com o Convex Cloud hospedado. O código passa a Apache 2.0 dois anos após criado; versões atuais não são Apache 2.0 irrestrito desde o primeiro dia.

Beta Features designadas são apenas para avaliação, fora da Platform contratual, e não têm compromissos de serviço, suporte, garantia ou responsabilidade pelo uso; a Convex pode descontinuá-las.

Direitos de dados e tratamento por modelos

Clientes/licenciantes mantêm direitos sobre Customer Data e concedem à Convex licença limitada de tratamento para entrega, manutenção/suporte/melhoria da plataforma, integrações iniciadas pelo cliente e obrigações legais. É uma licença do cliente à plataforma, não transferência da propriedade dos dados.

A Convex possui Aggregated Data e pode usá-los para fins comerciais legítimos, incluindo análise, desenvolvimento de produtos e benchmarking. Eles não devem identificar clientes/usuários, conter suas informações em forma identificável nem permitir razoavelmente sua reidentificação.

Os termos de IA proíbem treinar/melhorar modelos fundacionais da Convex ou de terceiros com Customer Data sem consentimento prévio escrito do cliente. Entradas semelhantes podem produzir saídas semelhantes, sem garantia de precisão, completude, ausência de erros ou adequação à finalidade.

Um marcador ZDR registra correspondência com catálogo de retenção zero na última atualização. O roteamento deve ser ativado por solicitação e falha sem endpoint elegível; o marcador sozinho não garante nada. Rotas de imagem/vídeo/áudio não aceitam essa opção.

Privacidade, exclusão e locais de tratamento

A política de privacidade da Convex exclui Customer Data de aplicativos, regidos por acordos do cliente e políticas dos aplicativos. Para informações cobertas pela política, a Convex pode coletar identificadores de IP/dispositivo, localização aproximada e dados de atividade, usando cookies e ferramentas de análise.

Informações cobertas podem ser tratadas/armazenadas no mundo todo, incluindo EUA, e retidas durante o uso do serviço ou para finalidades de coleta, prestação, disputas, auditorias, defesa jurídica, negócios, execução e obrigações legais; não há prazo fixo universal declarado.

Pelo DPA, a Convex deve excluir Customer Personal Data ao vencer ou terminar o acordo. Cópias de backup/arquivo são excluídas segundo seu cronograma de retenção; cópias que a lei exige reter devem ser isoladas e protegidas de tratamento posterior, exceto o exigido por lei aplicável. A lista de subprocessadores vincula infraestrutura/banco de dados à região escolhida e lista suporte, análise, cobrança e roteamento de IA nos EUA, além de gestão de comunidade na Alemanha.

A Convex declara criptografia AES-256 em repouso para código de clientes, bancos de dados, arquivos e índices de busca, criptografia em trânsito, acesso restrito à produção e conformidade SOC 2 Type 2. A Convex afirma que empresas sujeitas à HIPAA podem tratar PHI na plataforma desde que assinem seu Business Associate Agreement; essas declarações do fornecedor não comprovam a conformidade do aplicativo de cada cliente.

FAQ

Q1. Toda função Convex tem garantias de tempo real e transação?

Não. Consultas são armazenadas em cache e aceitam assinaturas, e mutações são transacionais; ações externas não herdam as mesmas garantias.

Q2. O AI Gateway está incluído no plano Free?

Não. Exige equipe paga e uso de modelos medido separadamente. Implantações auto-hospedadas usam suas próprias credenciais de provedor.

Q3. Escolher região europeia significa manter todo tipo de dado lá?

Não. Infraestrutura de implantação, informações pessoais cobertas pela política, subprocessadores e retenção do roteamento de modelos têm escopos distintos.