En Aurabase, nos impusimos una fuerte restricción desde la etapa de diseño: la superficie del SDK y las convenciones RLS tenían que ser compatibles directamente con con Supabase. Mismas createClient(), mismas .from().select().eq(), mismas políticas SQL Postgres. La idea: si quieres irte, vete; lo hacemos trivial. Aquí está el libro de jugadas completo.
Lo que se mueve, lo que se queda
Antes de comenzar, enumere lo que cambiará y lo que permanecerá. Spoiler: la mayoría permanece.
| Postgres Esquema | MISMO | pg_dump → pg_restore. Extensiones, activadores, funciones, índices: todo vale. |
|---|---|---|
| RLS Políticas | MISMO | Misma sintaxis. auth.uid(), auth.role(), auth.jwt() funcionan como están. |
| SDK de JavaScript | 95% IDÉNTICO | Reemplace @supabase/supabase-js con @aurabase/aurabase-js. Misma API encadenable. |
| Flujos de autenticación | MISMO | signUp, signInWithPassword, signInWithOAuth, mfa: mismos nombres, mismas firmas. |
| API de almacenamiento | MISMO | aura.storage.from(bucket).upload(...) · compatible S3 · políticas transferibles RLS. |
| En tiempo real | MISMO | canal().on("postgres_changes", ...) sin cambios. Presencia + retransmisión igual. |
| Edge Functions | MISMO | Deno.serve() pegado tal cual en el editor de Studio. La CLI tendrá funciones implementadas dirigidas a una ruta separada (Rust compilada en WASM). |
| Panel de control | DIFERENTE | Estudio Aurabase · te ayudamos a orientarte. |
Cree el proyecto de destino Aurabase
Cree un nuevo proyecto Aurabase con la CLI oficial, luego vincule esta carpeta al proyecto para que los siguientes comandos se apliquen automáticamente.
# Cuenta Aurabase + CLI
npm i -g @aurabase/cli
aura login
# Crear el proyecto (motor Postgres)
aura projects create my-app --engine postgres
# Vincular esta carpeta al proyecto creado
aura link --project-id <uuid-du-projet>
# Recuperar las claves API del proyecto vinculado
aura projects api-keys
Volcar Supabase, restaurar Aurabase
Un pg_dump / pg_restore: Aurabase estándar expone una cadena de conexión Postgres directa para cada proyecto (Estudio → Configuración → Conexión), sin necesidad de transformación intermedia.
# Recupere la cadena de conexión Supabase de su panel
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"
# Volcado de esquema público (sin esquemas del sistema Supabase)
pg_dump "$SUPABASE_DB_URL" \
--schema=public \
--no-owner --no-acl \
--format=custom \
-f supabase-dump.pgdump
# Recuperar la cadena de conexión Aurabase (Estudio → Configuración → Conexión)
# El parámetro ?search_path= es OBLIGATORIO: dirige al esquema de su proyecto
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"
# Restaurar con pg_restore estándar
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump
# Regenerar tipos TypeScript
aura db generate > src/aurabase.types.ts
Migrar usuarios
Un punto a corregir en comparación con lo que indicamos aquí anteriormente: Aurabase codifica contraseñas con Argon2id, pero Supabase (GoTrue) codifica las suyas de forma predeterminada con bcrypt: los dos formatos no son intercambiables. Por lo tanto, sus usuarios tendrán que restablecer su contraseña una vez, como ocurre con la mayoría de las migraciones.
Aurabase actualmente no ofrece una herramienta de importación masiva desde Supabase. Dos opciones: permitir que sus usuarios se vuelvan a registrar (signUp con la misma dirección de correo electrónico) o volver a crearlos uno por uno en el lado del administrador con aura auth users create --email <email> antes de activar un restablecimiento de contraseña.
Las sesiones activas en el lado Supabase no se transfieren (técnicamente imposible: cada plataforma firma sus JWT con su propia clave). Los usuarios deberán iniciar sesión nuevamente con su nueva contraseña.
Adaptar el código del cliente
Una búsqueda/reemplazo es suficiente en el 95% de los casos.
// ANTES (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)
// DESPUÉS (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)
// El resto del código no cambia:
await aura.from('posts').select('*').eq('author_id', userId)
Implementar Edge Functions
Aurabase ofrece dos rutas para Edge Functions: el editor de código Studio (tiempo de ejecución Deno, igual que Supabase: pegue su función tal como está) y la CLI aura functions deploy, que apunta a una ruta separada para funciones escritas en Rust y compiladas en WASM. Para migrar el código Deno existente sin reescribirlo, utilice Studio.
// Funciona igual, pegado tal cual en el editor de Studio.
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(JSON.stringify({ hello: name }))
})
Cambio de DNS y lanzamiento de producción
Dos posibles estrategias. La primera se recomienda para el 99% de los casos.
- Transferencia directa: cambie
NEXT_PUBLIC_AURABASE_URLyNEXT_PUBLIC_AURABASE_ANON_KEYen sus variables de entorno, vuelva a implementar. Los usuarios se vuelven a conectar, todo funciona. Recomendado para la mayoría de proyectos. - Escritura dual temporal: escriba Supabase + Aurabase simultáneamente durante 48 horas, verifique la coherencia de las tablas críticas manualmente (recuento de filas, sumas de verificación) y luego apague Supabase. Preferido para aplicaciones críticas.
Estamos aquí si las cosas se atascan
Para proyectos grandes o con estrictas restricciones de cumplimiento, nuestro equipo puede ayudarlo con la migración. Contáctenos para una oferta adaptada a su proyecto.