Supa Moonbase (smoonb)

Ferramenta completa de backup e migração do Supabase

Backup e restauração: completo e simples, como deveria ser

Nota sobre acesso comercial: o Supa Moonbase passará a exigir validação de conta antes de executar operações (login + verificação de assinatura) em fase futura. Nesta versão, não há autenticação implementada — este README apenas apresenta a base legal/comercial. O uso operacional será regido pelos Termos de Serviço e pela Política de Privacidade.

Leia em outro idioma: English

Desenvolvido por: Goalmoon Tecnologia LTDA
Website: https://smoonb.com
GitHub: https://github.com/almmello/smoonb

🎯 Objetivo

O smoonb resolve o problema das ferramentas existentes que fazem backup apenas da database PostgreSQL, ignorando componentes críticos do Supabase.

📦 Componentes de Backup

O smoonb faz backup completo de todos os componentes do seu projeto Supabase:

• ✅ Database PostgreSQL (backup completo via pg_dumpall + SQL separados, idêntico ao Dashboard)
• ✅ Database Extensions and Settings (extensões PostgreSQL e configurações)
• ✅ Custom Roles (roles personalizados do PostgreSQL)
• ✅ Edge Functions (download automático do servidor)
• ✅ Auth Settings (configurações de autenticação via Management API)
• ✅ Storage Buckets (backup completo: metadados, configurações e todos os arquivos via Management API + Supabase Client, cria ZIP no padrão do Dashboard)
• ✅ Realtime Settings (7 parâmetros capturados interativamente)
• ✅ Supabase .temp (arquivos temporários do Supabase CLI)
• ✅ Migrations (todas as migrations do projeto via supabase migration fetch)

⚠️ Universal Disclaimer / Aviso Legal Universal

Ao continuar, você reconhece e concorda que o Supa Moonbase (smoonb) é fornecido "NO ESTADO EM QUE SE ENCONTRA" ("AS IS") e "CONFORME DISPONIBILIDADE" ("AS AVAILABLE"), sem garantias de qualquer natureza—expressas, implícitas ou legais—incluindo, sem limitação, garantias de comercialização, adequação a um fim específico e não violação, na máxima extensão permitida pela lei aplicável. Operações de backup e restauração envolvem riscos inerentes, os ambientes variam amplamente e não podemos prever ou validar todas as configurações dos usuários. Você é o único responsável por validar seu próprio ambiente, manter cópias independentes e verificar os resultados antes de utilizá-los em produção. Construímos o Supa Moonbase (smoonb) com repositórios públicos, auditáveis e de código aberto para ajudar pessoas a simplificar seus fluxos de trabalho, mas isso não cria qualquer garantia, promessa de suporte ou compromisso de nível de serviço.

Limitação de responsabilidade — Na máxima extensão permitida por lei, a Goalmoon Tecnologia LTDA, seus contribuidores e licenciadores não serão responsáveis por quaisquer danos indiretos, incidentais, especiais, consequentes, exemplares ou punitivos (incluindo perda de dados, interrupção de negócios ou lucros cessantes) decorrentes ou relacionados ao uso, incapacidade de uso, operações de backup/restauração realizadas por, ou resultados produzidos pelo Supa Moonbase (smoonb). Em qualquer caso, nossa responsabilidade agregada por todas as reivindicações relacionadas ao Supa Moonbase (smoonb) não excederá o valor pago por você pelo Supa Moonbase (smoonb) nos 12 meses anteriores ao evento. Nada neste aviso exclui ou limita responsabilidades onde tais limites sejam proibidos por lei, incluindo (conforme aplicável) dolo ou culpa grave.

🚀 Instalação

⚠️ IMPORTANTE: Instale APENAS localmente no projeto!

# ✅ CORRETO - Instalar localmente no projeto
npm install smoonb

# ✅ CORRETO - Usar com npx
npx smoonb --help

# ❌ ERRADO - NÃO instalar globalmente
npm install -g smoonb  # ← Isso será bloqueado!

🔄 Atualizar para a Última Versão

Para atualizar o smoonb para a versão mais recente disponível:

# Atualizar no projeto atual
npm install smoonb@latest

⚠️ IMPORTANTE: O smoonb deve ser instalado localmente no projeto. Não é permitido usar sem instalar (ex.: npx smoonb@latest).

💡 Por que apenas local?

• 🔒 Segurança: Evita conflitos de versão
• 📦 Isolamento: Cada projeto usa sua versão
• 🔄 Atualizações: Controle granular por projeto
• 🛡️ Estabilidade: Evita quebras em outros projetos

📋 Pré-requisitos

1. Docker Desktop (OBRIGATÓRIO)

# Instalar Docker Desktop
# Windows/macOS: https://docs.docker.com/desktop/install/
# Linux: https://docs.docker.com/engine/install/

# Verificar se está rodando
docker --version
docker ps

⚠️ IMPORTANTE: O Docker é necessário para:

• Backup da database via pg_dumpall (compatível com Dashboard do Supabase)
• Compressão de arquivos .backup.gz
• Restauração de backups .backup e .backup.gz

2. Supabase CLI

npm install -g supabase

3. Personal Access Token do Supabase

É necessário obter um token de acesso pessoal do Supabase para usar a Management API:

1. Acesse: https://supabase.com/dashboard/account/tokens
2. Clique em "Generate new token"
3. Copie o token (formato: sbp_...)
4. Adicione ao .env.local como SUPABASE_ACCESS_TOKEN

⚙️ Configuração

Método Moderno: .env.local (RECOMENDADO)

O smoonb agora usa .env.local para configuração, seguindo o padrão da indústria. Isso torna o processo mais simples e integrado ao seu fluxo de trabalho.

1. Criar ou editar .env.local na raiz do projeto

# Criar arquivo .env.local
touch .env.local

2. Adicionar as variáveis de ambiente necessárias

# URLs e Chaves do Supabase
NEXT_PUBLIC_SUPABASE_URL=[sua-supabase-url]
NEXT_PUBLIC_SUPABASE_ANON_KEY=[sua-anon-key]
SUPABASE_SERVICE_ROLE_KEY=[sua-service-role]

# Conexão com Database
SUPABASE_DB_URL=postgresql://postgres:[sua-database-password]@db.[seu-project-id].supabase.co:5432/postgres

# Identificação do Projeto
SUPABASE_PROJECT_ID=[seu-project-id]

# Personal Access Token (OBRIGATÓRIO para Management API)
SUPABASE_ACCESS_TOKEN=[seu-access-token]

# Diretório de Backups (opcional, padrão: ./backups)
SMOONB_OUTPUT_DIR=./backups

3. Mapeamento Interativo

Ao executar backup ou restore pela primeira vez, o smoonb irá:

1. Ler seu .env.local atual
2. Identificar as chaves que você já tem
3. Perguntar interativamente quais chaves correspondem às esperadas (se os nomes forem diferentes)
4. Adicionar chaves faltantes se necessário
5. Criar backup automático do .env.local antes de qualquer alteração
6. Salvar mapeamento para futuras execuções

Exemplo de mapeamento:

🔧 Mapeando variável: NEXT_PUBLIC_SUPABASE_URL
Valor atual: https://abc123.supabase.co
Este é o valor correto do projeto alvo? (S/n): S

🌐 Internacionalização (i18n)

O smoonb suporta múltiplos idiomas automaticamente. Atualmente, os idiomas suportados são:

• Inglês (en) - Idioma padrão
• Português do Brasil (pt-BR) - Suporte completo

Detecção Automática de Idioma

O idioma é detectado automaticamente na seguinte ordem de precedência:

1. Flag CLI --lang (maior prioridade)

   npx smoonb --lang pt-BR backup
   npx smoonb --lang en restore

2. Variável de ambiente SMOONB_LANG

   # Windows PowerShell
   $env:SMOONB_LANG="pt-BR"
   npx smoonb backup
      
   # Linux/macOS
   export SMOONB_LANG=pt-BR
   npx smoonb backup

3. Locale do sistema (LANG, LC_ALL, LC_MESSAGES)

   # O smoonb detecta automaticamente o locale do sistema
   # Exemplo: LANG=pt_BR.UTF-8 → pt-BR
   # Exemplo: LANG=en_US.UTF-8 → en

4. Fallback para inglês (en) se nenhum dos anteriores for detectado

Idiomas Suportados e Aliases

O smoonb aceita os seguintes códigos de idioma:

• en ou en-US → Inglês
• pt-BR, pt_BR ou pt → Português do Brasil

Exemplos de Uso

Forçar português:

npx smoonb --lang pt-BR backup

Forçar inglês:

npx smoonb --lang en restore

Usar variável de ambiente:

# Windows PowerShell
$env:SMOONB_LANG="pt-BR"
npx smoonb check

# Linux/macOS
export SMOONB_LANG=en
npx smoonb check

Detecção automática pelo sistema:

# Se o sistema estiver configurado com LANG=pt_BR.UTF-8
# O smoonb automaticamente usará português
npx smoonb backup

Notas Importantes

• Saídas "máquina" (ex.: --json se implementado) não são traduzidas; campos e chaves permanecem em inglês
• Se uma chave de tradução estiver ausente em um idioma, o sistema faz fallback automático para inglês
• O idioma é detectado uma vez no início da execução e aplicado a todas as mensagens do CLI

🎯 Uso

Backup Completo

npx smoonb backup

Fluxo interativo do backup:

1. Validação Docker - Verifica se o Docker está rodando
2. Consentimento - Pede permissão para ler/escrever .env.local
3. Mapeamento de Variáveis - Mapeia suas variáveis de ambiente (primeira vez)
4. Backup do .env.local - Cria backup automático antes de alterações
5. Seleção de Componentes - Pergunta quais componentes incluir:
   • ⚡ Edge Functions (explicação sobre reset de link e download)
   • 📦 Storage (explicação sobre backup completo: download de arquivos + ZIP no padrão do Dashboard)
   • 🔐 Auth Settings (explicação sobre configurações)
   • 🔄 Realtime Settings (explicação sobre captura interativa de 7 parâmetros)
   • 🗑️ Opções de limpeza (functions, .temp, migrations após backup)
6. Resumo de Configurações - Mostra tudo que será feito
7. Confirmação Final - Confirma antes de iniciar
8. Execução das Etapas:
   • 📊 1/10 - Backup Database via pg_dumpall (Docker)
   • 📊 2/10 - Backup Database SQL separado (schema, dados, roles)
   • 🔧 3/10 - Backup Database Extensions and Settings
   • 🔐 4/10 - Backup Auth Settings (se selecionado)
   • 🔄 5/10 - Backup Realtime Settings (se selecionado) - 7 parâmetros capturados interativamente
   • 📦 6/10 - Backup Storage (se selecionado) - Download completo de arquivos + ZIP no padrão do Dashboard
   • 👥 7/10 - Backup Custom Roles
   • ⚡ 8/10 - Backup Edge Functions (se selecionado)
   • 📁 9/10 - Backup Supabase .temp (se selecionado)
   • 📋 10/10 - Backup Migrations (se selecionado)

Resultado:

backups/backup-2025-10-31-09-37-54/
├── backup-manifest.json           # Manifesto com metadados
├── [email protected]  # Backup completo (compatível com Dashboard)
├── schema.sql                     # Schema do banco
├── data.sql                       # Dados
├── roles.sql                      # Roles do PostgreSQL
├── database-settings-*.json       # Extensões e configurações
├── auth-settings.json             # Configurações de Auth
├── realtime-settings.json         # Configurações de Realtime
├── storage/                       # Metadados de Storage
│   └── [bucket-name].json         # Metadados de cada bucket
├── [project-id].storage.zip       # Backup completo de Storage (padrão Dashboard)
├── storage_temp/                  # Estrutura temporária (opcional, pode ser removida)
│   └── [project-id]/              # Estrutura de arquivos baixados
│       └── [bucket-name]/        # Arquivos de cada bucket
├── edge-functions/                # Edge Functions baixadas
│   └── [nome-da-function]/
├── supabase-temp/                 # Arquivos .temp do Supabase CLI
├── migrations/                    # Todas as migrations
└── env/
    ├── .env.local                 # Backup do .env.local
    └── env-map.json               # Mapeamento de variáveis

Restauração Interativa

Restaurar backup existente:

npx smoonb restore

Importar e restaurar diretamente do Dashboard:

# Apenas database
npx smoonb restore --file "C:\Downloads\[email protected]"

# Database e storage juntos
npx smoonb restore --file "backup.backup.gz" --storage "meu-projeto.storage.zip"

Fluxo interativo do restore:

1. Validação Docker - Verifica se o Docker está rodando
2. Termo de Uso - Exibe e solicita aceitação dos termos
3. Consentimento - Pede permissão para ler/escrever .env.local
4. Mapeamento de Variáveis - Mapeia variáveis para o projeto de destino
5. Backup do .env.local - Cria backup automático
6. Seleção de Backup - Lista e permite escolher qual backup restaurar (pula se --file fornecido)
   • Se --file for fornecido: importa automaticamente e auto-seleciona o backup
   • Se --storage for fornecido junto com --file: importa também o arquivo de storage
7. Seleção de Componentes - Pergunta quais componentes restaurar:
   • 📊 Database (sempre disponível)
   • ⚡ Edge Functions (se disponível no backup)
   • 🔐 Auth Settings (se disponível no backup)
   • 📦 Storage (se disponível no backup)
   • 🔧 Database Extensions and Settings (se disponível no backup)
   • 🔄 Realtime Settings (se disponível no backup)
8. Resumo Detalhado - Mostra backup selecionado, projeto destino e componentes
9. Confirmação Final - Confirma antes de iniciar
10. Execução da Restauração:
    • 📊 Database - Restaura via psql (suporta .backup.gz e .backup)
    • ⚡ Edge Functions - Copia e faz deploy no projeto destino
    • 🔐 Auth Settings - Exibe configurações para aplicação manual
    • 📦 Storage - Restaura buckets e arquivos do ZIP (se disponível) ou exibe informações para migração manual
    • 🔧 Database Settings - Restaura extensões e configurações via SQL
    • 🔄 Realtime Settings - Exibe configurações para aplicação manual

Formato de arquivos suportados:

• ✅ .backup.gz (compactado) - Descompacta automaticamente antes de restaurar
• ✅ .backup (descompactado) - Restaura diretamente

Quando usar --file:

• Importa automaticamente o arquivo de backup antes de restaurar
• Elimina a etapa de seleção de backup
• Se --storage fornecido, importa também o arquivo de storage
• Útil para restaurar backups baixados diretamente do Dashboard do Supabase

Importar Backup do Dashboard do Supabase

Se você baixou um backup diretamente do Dashboard do Supabase (formato .backup.gz), você pode importá-lo para o formato esperado pelo smoonb. O comando também suporta importar arquivos de storage (.storage.zip) opcionalmente.

Importar apenas database:

npx smoonb import --file "caminho/completo/para/[email protected]"

Importar database e storage juntos:

npx smoonb import --file "backup.backup.gz" --storage "meu-projeto.storage.zip"

O que o comando faz:

1. Lê o arquivo .backup.gz do Dashboard (obrigatório)
2. Se fornecido, lê o arquivo .storage.zip do Dashboard (opcional)
3. Extrai informações do nome do arquivo de backup (data e hora)
4. Cria uma pasta de backup no formato esperado (backup-YYYY-MM-DD-HH-MM-SS)
5. Copia o arquivo de backup para a pasta criada
6. Se fornecido, copia o arquivo de storage para a mesma pasta
7. Deixa o backup pronto para ser encontrado pelo comando restore

Exemplo completo - Apenas database (usando import + restore):

# 1. Baixar backup do Dashboard do Supabase
#    Arquivo: [email protected]

# 2. Importar o arquivo
npx smoonb import --file "C:\Downloads\[email protected]"

# 3. Restaurar o backup importado
npx smoonb restore
# O backup importado aparecerá na lista de backups disponíveis

Exemplo completo - Apenas database (usando restore diretamente):

# 1. Baixar backup do Dashboard do Supabase
#    Arquivo: [email protected]

# 2. Importar e restaurar diretamente (pula seleção de backup)
npx smoonb restore --file "C:\Downloads\[email protected]"

Exemplo completo - Database e Storage (usando import + restore):

# 1. Baixar backup e storage do Dashboard do Supabase
#    Arquivos: 
#    - [email protected]
#    - meu-projeto.storage.zip

# 2. Importar ambos os arquivos
npx smoonb import --file "C:\Downloads\[email protected]" --storage "C:\Downloads\meu-projeto.storage.zip"

# 3. Restaurar o backup importado
npx smoonb restore
# O backup importado aparecerá na lista de backups disponíveis

Exemplo completo - Database e Storage (usando restore diretamente):

# 1. Baixar backup e storage do Dashboard do Supabase
#    Arquivos: 
#    - [email protected]
#    - meu-projeto.storage.zip

# 2. Importar e restaurar diretamente (pula seleção de backup)
npx smoonb restore --file "C:\Downloads\[email protected]" --storage "C:\Downloads\meu-projeto.storage.zip"

Importante:

• O arquivo de backup é obrigatório e deve estar no formato do Dashboard: [email protected]
• O arquivo de storage é opcional e deve estar no formato: *.storage.zip
• O storage depende de um backup, mas o backup não depende do storage
• Ambos os arquivos serão copiados para a mesma pasta de backup
• O caminho pode ser absoluto ou relativo
• O comando criará a estrutura de pastas necessária automaticamente

Diferença entre import e restore --file:

• import: Apenas importa o arquivo e cria a estrutura de backup. Você precisa executar restore depois.
• restore --file: Importa o arquivo automaticamente e já inicia o processo de restauração, pulando a etapa de seleção de backup.

Verificação Pós-Restore

npx smoonb check

Verifica:

• ✅ Conexão com database
• ✅ Extensões instaladas
• ✅ Tabelas criadas
• ✅ Políticas RLS
• ✅ Publicações Realtime
• ✅ Buckets de Storage

🔧 Comandos Disponíveis

| Comando | Descrição | |---------|-----------| | npx smoonb backup | Backup completo interativo usando Docker | | npx smoonb restore | Restauração interativa usando psql (Docker) | | npx smoonb restore --file <path> [--storage <path>] | Importar e restaurar diretamente arquivo .backup.gz e opcionalmente .storage.zip do Dashboard | | npx smoonb import --file <path> [--storage <path>] | Importar arquivo .backup.gz e opcionalmente .storage.zip do Dashboard do Supabase | | npx smoonb check | Verificação de integridade pós-restore |

🏗️ Arquitetura Técnica

Estrutura Modular

O código foi refatorado para uma arquitetura modular com etapas independentes:

Backup (src/commands/backup/)

backup/
├── index.js                    # Orquestrador principal
├── utils.js                    # Utilitários específicos
└── steps/
    ├── 00-docker-validation.js # Validação Docker
    ├── 01-database.js          # Backup via pg_dumpall
    ├── 02-database-separated.js # SQL separado
    ├── 03-database-settings.js # Extensões e settings
    ├── 04-auth-settings.js     # Auth via API
    ├── 05-realtime-settings.js # Realtime interativo
    ├── 06-storage.js           # Storage via API
    ├── 07-custom-roles.js      # Custom roles
    ├── 08-edge-functions.js    # Edge Functions
    ├── 09-supabase-temp.js     # Supabase .temp
    └── 10-migrations.js        # Migrations

Restore (src/commands/restore/)

restore/
├── index.js                    # Orquestrador principal
├── utils.js                    # Utilitários específicos
└── steps/
    ├── 00-backup-selection.js  # Seleção de backup
    ├── 01-components-selection.js # Seleção de componentes
    ├── 02-confirmation.js      # Confirmação (legacy)
    ├── 03-database.js          # Restauração database
    ├── 04-edge-functions.js    # Deploy Edge Functions
    ├── 05-auth-settings.js     # Exibe Auth settings
    ├── 06-storage.js           # Exibe Storage info
    ├── 07-database-settings.js # Restaura settings
    └── 08-realtime-settings.js # Exibe Realtime settings

Estratégia de Backup

Database

• Backup Principal: pg_dumpall via Docker (idêntico ao Dashboard)
  • Arquivo: [email protected]
  • Compatível com restauração via Dashboard do Supabase
• Backup Separado: SQL em arquivos distintos via Supabase CLI
  • schema.sql - Estrutura das tabelas
  • data.sql - Dados (comandos COPY)
  • roles.sql - Roles e permissões

Edge Functions

• Download Automático: Via Supabase CLI supabase functions download
• Reset de Link: Garante link limpo com o projeto antes do download
• Backup Completo: Código completo de cada function

Migrations

• Download Automático: Via supabase migration fetch
• Reset de Link: Garante link limpo com o projeto
• Backup Completo: Todas as migrations do servidor

Storage

• Backup Completo: Download de todos os arquivos de todos os buckets
• Estrutura Temporária: Cria storage_temp/project-id/bucket-name/arquivos... dentro do backupDir
• ZIP no Padrão Dashboard: Cria {project-id}.storage.zip com estrutura project-id/bucket-name/arquivos...
• Compatível com Restore: O ZIP criado é compatível com o processo de restore (mesmo formato do Dashboard)
• Pergunta Interativa: Após criar o ZIP, pergunta se deseja limpar a estrutura temporária
• Fallback: Se não houver credenciais do Supabase, faz backup apenas de metadados
• Management API: Usa Personal Access Token para listar buckets e objetos
• Supabase Client: Usa Service Role Key para download de arquivos

Auth, Realtime

• Management API: Usa Personal Access Token
• JSON Export: Configurações exportadas como JSON
• Realtime Settings: Captura interativa de 7 parâmetros:
  1. Habilitar serviço Realtime
  2. Permitir acesso público
  3. Tamanho do pool de conexões do database
  4. Máximo de clientes simultâneos
  5. Máximo de eventos por segundo
  6. Máximo de eventos de presença por segundo
  7. Tamanho máximo do payload em KB
• Manual para alguns: Alguns settings precisam ser aplicados manualmente por segurança

Estratégia de Restauração

Database

• Suporte a Formatos:
  • .backup.gz - Descompacta automaticamente via Docker
  • .backup - Restaura diretamente via psql (Docker)
• Restauração Limpa: Pode sobrescrever dados existentes (com confirmação)

Edge Functions

• Deploy Limpo: Limpa supabase/functions antes do deploy
• Reset de Link: Garante link correto com projeto destino
• Deploy Automático: Usa supabase functions deploy

Outros Componentes

• Database Settings: Restaura via SQL
• Storage: Restaura buckets e arquivos do ZIP (se disponível) ou exibe informações para configuração manual
• Auth/Realtime: Exibe informações para configuração manual no Dashboard

Multiplataforma

• Windows/macOS/Linux: Detecção automática de binários
• Multiplataforma: Usa fs.promises.cp, path.join, Docker
• Docker para Tudo: Backup, restore e compressão via Docker (garante consistência)

📊 Fluxo Recomendado

# 1. Configurar .env.local (primeira vez)
# Edite .env.local com suas credenciais do projeto origem

# 2. Backup do projeto origem
npx smoonb backup
# - Mapeia variáveis interativamente (primeira vez)
# - Seleciona componentes para backup
# - Executa backup completo

# 3. Criar novo projeto Supabase
# (via Dashboard ou Supabase CLI)

# 4. Editar .env.local com credenciais do novo projeto
# Atualize as variáveis para apontar ao projeto destino

# 5. Restaurar backup (modo interativo)
npx smoonb restore
# - Seleciona backup desejado
# - Seleciona componentes para restaurar
# - Executa restauração

# 6. Verificar integridade
npx smoonb check

# 7. Aplicar configurações manuais (se necessário)
# - Auth Settings: Dashboard → Authentication → Settings
# - Realtime: Dashboard → Database → Replication
# Nota: Storage é restaurado automaticamente do ZIP se disponível

🎨 Experiência do Usuário

Interface em Português

Todas as interações são em Português do Brasil:

• Perguntas claras e diretas
• Explicações antes de cada processo
• Resumos detalhados antes de confirmar
• Confirmações com (S/n) ou (s/N) em português

Mapeamento Inteligente de Variáveis

• Detecção Automática: Se a chave já existe com o nome esperado, pula a seleção
• Opção de Adicionar: Permite adicionar novas chaves se não existirem
• Validação de Valores: Confirma valores antes de salvar
• Backup Automático: Sempre cria backup do .env.local antes de alterações

Processo Guiado

• Validação Prévia: Verifica Docker antes de começar
• Explicações Contextuais: Explica cada processo antes de perguntar
• Resumo Final: Mostra tudo que será feito antes de executar
• Feedback Visual: Cores e ícones para melhor experiência

🐛 Solução de Problemas

Docker não encontrado ou não está rodando

# Verificar se Docker está instalado
docker --version

# Verificar se Docker Desktop está rodando
docker ps

# Se não estiver, iniciar Docker Desktop
# Windows/macOS: Abrir aplicativo Docker Desktop
# Linux: sudo systemctl start docker

Supabase CLI não encontrado

npm install -g supabase

Personal Access Token inválido ou ausente

1. Verificar se SUPABASE_ACCESS_TOKEN está no .env.local
2. Gerar novo token: https://supabase.com/dashboard/account/tokens
3. Atualizar .env.local com o novo token

Database URL incorreta

• Verificar senha na URL de conexão
• Usar string de conexão do Dashboard Supabase (Settings → Database)
• Testar conexão: psql "sua-database-url" -c "SELECT 1"

Arquivo .backup.gz não pode ser restaurado

O smoonb suporta automaticamente:

• ✅ .backup.gz - Descompacta via Docker antes de restaurar
• ✅ .backup - Restaura diretamente

Se houver problemas:

1. Verificar se Docker está rodando
2. Verificar permissões do arquivo
3. Verificar espaço em disco

Erro ao baixar Edge Functions

1. Verificar se SUPABASE_ACCESS_TOKEN está configurado
2. Verificar se o projeto está linkado: supabase link
3. Verificar se as functions existem no servidor

Erro ao baixar Migrations

1. Verificar se SUPABASE_ACCESS_TOKEN está configurado
2. Verificar se o projeto está linkado: supabase link
3. Verificar se há migrations no servidor

🔒 Segurança

• Backup Automático: Sempre cria backup do .env.local antes de alterações
• Mapeamento Local: Mapeamento de variáveis salvo apenas localmente
• Sem Dados Sensíveis: Nenhum dado sensível é enviado para fora do seu ambiente
• Docker Isolado: Operações de database via Docker (isolamento)

💼 Modelo de Acesso e Assinatura

O código do Supa Moonbase é disponibilizado sob licença MIT (ver LICENSE). Em fase futura, a execução do CLI será vinculada a uma assinatura por conta, permitindo uso associado a uma conta válida. A validação de conta ocorrerá antes de qualquer operação sensível (ex.: backup e restore).

Até que a validação esteja ativa, a ferramenta pode ser utilizada sem login.

Saiba mais em Pricing e FAQ Comercial.

🎁 Grandfathering (conceito)

Contas criadas durante o período inicial de disponibilização comercial poderão manter condições de acesso diferenciadas enquanto permanecerem ativas. O objetivo é reconhecer os primeiros usuários. Detalhes específicos constarão nos Termos de Serviço e no Pricing.

🔒 Privacidade e LGPD (resumo)

O Supa Moonbase adota o princípio de minimização de dados. Quando a validação de conta estiver ativa, trataremos apenas informações estritamente necessárias para controle de acesso e faturamento (por exemplo, identificador de conta e contato). Os propósitos, bases legais e direitos do titular serão descritos na Política de Privacidade.

📋 Termos de Serviço e Uso de Marca

A licença de código (MIT) não substitui os Termos de Serviço que regerão o acesso operacional por conta e a validação de assinatura.

"Supa Moonbase" e elementos de identidade visual são marcas da Goalmoon Tecnologia Ltda.; o uso de marca e assets de branding é restrito, conforme os Termos de Serviço.

❓ FAQ Comercial

Por que assinatura se o código é MIT?

O código permanece aberto para auditoria e contribuições. O acesso operacional será condicionado à validação de conta, conforme Termos de Serviço.

O que significa grandfathering?

Contas do período inicial poderão manter condições diferenciadas enquanto ativas; detalhes estarão nos Termos.

📝 Licença

O código do Supa Moonbase é disponibilizado sob licença MIT. Veja LICENSE para o texto completo da licença. Uma tradução em português está disponível em LICENSE.pt-BR.md apenas para conveniência.

🤝 Contribuição

Contribuições são bem-vindas! Este é um projeto experimental e precisamos de feedback da comunidade.

Desenvolvido por: Goalmoon Tecnologia LTDA
Website: https://smoonb.com
GitHub: https://github.com/almmello/smoonb