Em Aurabase, nos demos uma forte restrição desde o estágio de design: a superfície do SDK e as convenções RLS tinham que ser compatíveis com com Supabase. As mesmas políticas createClient(), mesmas .from().select().eq(), mesmas SQL Postgres . A ideia: se você quiser ir embora, vá embora – nós tornamos isso trivial. Aqui está o manual completo.
O que se move, o que fica
Antes de começar, liste o que mudará e o que permanecerá. Spoiler: a maioria permanece.
| Esquema Postgres | MESMO | pg_dump → pg_restore. Extensões, gatilhos, funções, índices – vale tudo. |
|---|---|---|
| RLS Políticas | MESMO | Mesma sintaxe. auth.uid(), auth.role(), auth.jwt() funcionam como estão. |
| SDK JavaScript | 95% IDÊNTICO | Substitua @supabase/supabase-js por @aurabase/aurabase-js. A mesma API encadeada. |
| Fluxos de autenticação | MESMO | signUp, signInWithPassword, signInWithOAuth, mfa — mesmos nomes, mesmas assinaturas. |
| API de armazenamento | MESMO | aura.storage.from(bucket).upload(...) · compatibilidade S3 · políticas RLS transferíveis. |
| Tempo real | MESMO | channel().on("postgres_changes", ...) inalterado. Presença + transmissão igual. |
| Edge Functions | MESMO | Deno.serve() colado como está no editor do Studio. A CLI terá funções implantadas voltadas para um caminho separado (Rust compilado para WASM). |
| Painel | DIFERENTE | Studio Aurabase · ajudamos você a se orientar. |
Crie o projeto Aurabase de destino
Crie um novo projeto Aurabase com a CLI oficial e vincule esta pasta ao projeto para que os comandos a seguir sejam aplicados a ele automaticamente.
# Aurabase conta + CLI
npm i -g @aurabase/cli
aura login
# Crie o projeto (mecanismo Postgres)
aura projects create my-app --engine postgres
# Vincule esta pasta ao projeto criado
aura link --project-id <uuid-du-projet>
# Recuperar as chaves de API do projeto vinculado
aura projects api-keys
Despejar Supabase, restaurar Aurabase
Um pg_dump / pg_restore padrão: Aurabase expõe uma string de conexão direta Postgres para cada projeto (Studio → Configurações → Conexão), sem necessidade de transformação intermediária.
# Recuperar a string de conexão Supabase do painel
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"
# Despejo de esquema público (sem esquemas de sistema Supabase)
pg_dump "$SUPABASE_DB_URL" \
--schema=public \
--no-owner --no-acl \
--format=custom \
-f supabase-dump.pgdump
# Recuperar string de conexão Aurabase (Studio → Configurações → Conexão)
# O parâmetro ?search_path= é OBRIGATÓRIO: ele direciona para o esquema do seu projeto
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"
# Restaurar com pg_restore padrão
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump
# Regenerar tipos TypeScript
aura db generate > src/aurabase.types.ts
Migrar usuários
Um ponto a ser corrigido em comparação com o que afirmamos aqui anteriormente: Aurabase faz hash de senhas com Argon2id, mas Supabase (GoTrue) faz hash por padrão com bcrypt — os dois formatos não são intercambiáveis. Portanto, seus usuários terão que redefinir a senha uma vez, como acontece com a maioria das migrações.
Aurabase atualmente não oferece uma ferramenta de importação em massa de Supabase. Duas opções: permitir que seus usuários se registrem novamente (signUp com o mesmo endereço de e-mail) ou recriá-los um por um no lado do administrador com aura auth users create --email <email> antes de acionar uma redefinição de senha.
As sessões ativas no lado Supabase não são portadas (tecnicamente impossível — cada plataforma assina seus JWTs com sua própria chave). Os usuários precisarão fazer login novamente, com sua nova senha.
Adapte o código do cliente
Uma pesquisa/substituição é suficiente para 95% dos casos.
// ANTES (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)
// DEPOIS (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)
// O resto do código não muda:
await aura.from('posts').select('*').eq('author_id', userId)
Implantar Edge Functions
Aurabase oferece dois caminhos para Edge Functions: o editor de código Studio (tempo de execução Deno, igual a Supabase - cole sua função como está) e a CLI aura functions deploy, que visa um caminho separado para funções escritas em Rust e compiladas em WASM. Para migrar o código Deno existente sem reescrever, use o Studio.
// Funciona da mesma forma, colado como está no editor do Studio
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(JSON.stringify({ hello: name }))
})
Mudança de DNS e lançamento de produção
Duas estratégias possíveis. O primeiro é recomendado para 99% dos casos.
- Transferência direta - altere
NEXT_PUBLIC_AURABASE_URLeNEXT_PUBLIC_AURABASE_ANON_KEYem seus env vars, reimplante. Os usuários se reconectam, tudo funciona. Recomendado para a maioria dos projetos. - Gravação dupla temporária - escreva Supabase + Aurabase simultaneamente por 48 horas, verifique a consistência das tabelas críticas manualmente (contagem de linhas, somas de verificação) e, em seguida, desligue Supabase. Preferido para aplicativos críticos.
Estamos aqui se as coisas ficarem presas
Para projetos grandes ou com restrições rígidas de conformidade, nossa equipe pode apoiá-lo na migração. Contacte-nos para uma oferta à medida do seu projeto.