smoonb 0.0.61 → 0.0.63

package/README.md

@@ -210,38 +210,57 @@ backups/backup-2025-10-31-09-37-54/
 
 ### Restauração Interativa
 
+**Restaurar backup existente:**
 ```bash
 npx smoonb restore
 ```
 
+**Importar e restaurar diretamente do Dashboard:**
+```bash
+# Apenas database
+npx smoonb restore --file "C:\Downloads\db_cluster-04-03-2024@14-16-59.backup.gz"
+
+# 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. **Consentimento** - Pede permissão para ler/escrever `.env.local`
-3. **Mapeamento de Variáveis** - Mapeia variáveis para o projeto de destino
-4. **Backup do .env.local** - Cria backup automático
-5. **Seleção de Backup** - Lista e permite escolher qual backup restaurar
-6. **Seleção de Componentes** - Pergunta quais componentes restaurar:
+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)
-7. **Resumo Detalhado** - Mostra backup selecionado, projeto destino e componentes
-8. **Confirmação Final** - Confirma antes de iniciar
-9. **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 - 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
+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 - 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.
@@ -265,7 +284,7 @@ npx smoonb import --file "backup.backup.gz" --storage "meu-projeto.storage.zip"
 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:**
+**Exemplo completo - Apenas database (usando import + restore):**
 ```bash
 # 1. Baixar backup do Dashboard do Supabase
 #    Arquivo: db_cluster-04-03-2024@14-16-59.backup.gz
@@ -278,7 +297,16 @@ npx smoonb restore
 # O backup importado aparecerá na lista de backups disponíveis
 ```
 
-**Exemplo completo - Database e Storage:**
+**Exemplo completo - Apenas database (usando restore diretamente):**
+```bash
+# 1. Baixar backup do Dashboard do Supabase
+#    Arquivo: db_cluster-04-03-2024@14-16-59.backup.gz
+
+# 2. Importar e restaurar diretamente (pula seleção de backup)
+npx smoonb restore --file "C:\Downloads\db_cluster-04-03-2024@14-16-59.backup.gz"
+```
+
+**Exemplo completo - Database e Storage (usando import + restore):**
 ```bash
 # 1. Baixar backup e storage do Dashboard do Supabase
 #    Arquivos: 
@@ -293,6 +321,17 @@ npx smoonb restore
 # O backup importado aparecerá na lista de backups disponíveis
 ```
 
+**Exemplo completo - Database e Storage (usando restore diretamente):**
+```bash
+# 1. Baixar backup e storage do Dashboard do Supabase
+#    Arquivos: 
+#    - db_cluster-04-03-2024@14-16-59.backup.gz
+#    - meu-projeto.storage.zip
+
+# 2. Importar e restaurar diretamente (pula seleção de backup)
+npx smoonb restore --file "C:\Downloads\db_cluster-04-03-2024@14-16-59.backup.gz" --storage "C:\Downloads\meu-projeto.storage.zip"
+```
+
 **Importante:**
 - O arquivo de backup é **obrigatório** e deve estar no formato do Dashboard: `db_cluster-DD-MM-YYYY@HH-MM-SS.backup.gz`
 - O arquivo de storage é **opcional** e deve estar no formato: `*.storage.zip`
@@ -301,6 +340,10 @@ npx smoonb restore
 - 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
 
 ```bash
@@ -322,6 +365,7 @@ npx smoonb check
 |---------|-----------|
 | `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 |
 

package/bin/smoonb.js

@@ -53,6 +53,12 @@ ${chalk.yellow.bold('1. BACKUP - Fazer backup completo do projeto:')}
 ${chalk.yellow.bold('2. RESTORE - Restaurar backup em um projeto:')}
    ${chalk.white('npx smoonb restore')}
    ${chalk.gray('# Processo interativo que lista backups disponíveis e permite escolher')}
+   
+   ${chalk.white('npx smoonb restore --file "C:\\Downloads\\db_cluster-04-03-2024@14-16-59.backup.gz"')}
+   ${chalk.gray('# Importa e restaura diretamente o arquivo de backup (pula seleção)')}
+   
+   ${chalk.white('npx smoonb restore --file "backup.backup.gz" --storage "meu-projeto.storage.zip"')}
+   ${chalk.gray('# Importa e restaura backup e storage juntos')}
 
 ${chalk.yellow.bold('3. IMPORT - Importar backup do Dashboard do Supabase:')}
    ${chalk.white('npx smoonb import --file "C:\\Downloads\\db_cluster-04-03-2024@14-16-59.backup.gz"')}
@@ -103,25 +109,41 @@ ${chalk.yellow.bold('O que é capturado:')}
 program
   .command('restore')
   .description('Restaurar backup completo usando psql (modo interativo)')
+  .option('--file <path>', 'Caminho completo do arquivo .backup.gz a importar e restaurar (opcional)')
+  .option('--storage <path>', 'Caminho completo do arquivo .storage.zip a importar junto com o backup (opcional)')
   .addHelpText('after', `
 ${chalk.yellow.bold('Exemplos:')}
   ${chalk.white('npx smoonb restore')}
   ${chalk.gray('# Processo interativo que lista backups disponíveis')}
+  
+  ${chalk.white('npx smoonb restore --file "C:\\Downloads\\db_cluster-04-03-2024@14-16-59.backup.gz"')}
+  ${chalk.gray('# Importa e restaura diretamente o arquivo de backup')}
+  
+  ${chalk.white('npx smoonb restore --file "backup.backup.gz" --storage "meu-projeto.storage.zip"')}
+  ${chalk.gray('# Importa e restaura backup e storage juntos')}
 
 ${chalk.yellow.bold('Fluxo do restore:')}
   1. Validação Docker
   2. Consentimento para ler/escrever .env.local
   3. Mapeamento de variáveis de ambiente
-  4. Seleção de backup disponível
+  4. Seleção de backup disponível (pula se --file fornecido)
   5. Seleção de componentes para restaurar
   6. Resumo detalhado e confirmação
   7. Execução da restauração
 
+${chalk.yellow.bold('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
+
 ${chalk.yellow.bold('Formatos suportados:')}
   • .backup.gz (compactado) - Descompacta automaticamente
   • .backup (descompactado) - Restaura diretamente
 `)
-  .action(commands.restore);
+  .action(async (options) => {
+    await commands.restore({ file: options.file, storage: options.storage });
+  });
 
 program
   .command('check')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smoonb",
-  "version": "0.0.61",
+  "version": "0.0.63",
   "description": "Complete Supabase backup and migration tool - EXPERIMENTAL VERSION - USE AT YOUR OWN RISK",
   "preferGlobal": false,
   "preventGlobalInstall": true,

package/src/commands/backup/index.js

@@ -77,11 +77,11 @@ module.exports = async (options) => {
     console.log(chalk.blue(`📁 Backup do .env.local: ${path.relative(process.cwd(), envBackupPath)}`));
 
     const expectedKeys = [
+      'SUPABASE_PROJECT_ID',
       'NEXT_PUBLIC_SUPABASE_URL',
       'NEXT_PUBLIC_SUPABASE_ANON_KEY',
       'SUPABASE_SERVICE_ROLE_KEY',
       'SUPABASE_DB_URL',
-      'SUPABASE_PROJECT_ID',
       'SUPABASE_ACCESS_TOKEN',
       'SMOONB_OUTPUT_DIR'
     ];

package/src/commands/import.js

@@ -4,6 +4,7 @@ const fs = require('fs').promises;
 const { ensureDir } = require('../utils/fsx');
 const { readEnvFile } = require('../utils/env');
 const { showBetaBanner } = require('../utils/banner');
+const { confirm } = require('../utils/prompt');
 
 /**
  * Comando para importar arquivo .backup.gz e opcionalmente .storage.zip do Dashboard do Supabase
@@ -12,6 +13,18 @@ module.exports = async (options) => {
   showBetaBanner();
   
   try {
+    // Termo de uso e aviso de risco
+    console.log(chalk.yellow.bold('\n⚠️  TERMO DE USO E AVISO DE RISCO\n'));
+    console.log(chalk.white('Ao prosseguir, você reconhece e concorda que o Supa Moonbase (smoonb) é fornecido "NO ESTADO EM QUE SE ENCONTRA" ("AS IS") e "CONFORME DISPONIBILIDADE", 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, os ambientes variam amplamente e não é possível prever ou validar todas as configurações dos usuários. Você é o único responsável por validar seu ambiente, manter cópias independentes e verificar os resultados antes de utilizá-los em produção. O Supa Moonbase (smoonb) é construído com repositórios públicos, auditáveis e software livre, para auxiliar pessoas a simplificar seus fluxos, sem com isso criar qualquer garantia, promessa de suporte ou compromisso de nível de serviço.\n'));
+    console.log(chalk.white('Limitação de responsabilidade (PT-BR) — Na máxima extensão permitida por lei, a Goalmoon, seus contribuidores e licenciadores não serão responsáveis por danos indiretos, incidentais, especiais, consequentes, exemplares ou punitivos (incluindo perda de dados, interrupção de negócios ou lucros cessantes) decorrentes do uso, incapacidade de uso, das operações de backup/restauração realizadas com, ou dos resultados gerados pelo Supa Moonbase (smoonb). Em qualquer hipótese, a responsabilidade total 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.\n'));
+    console.log(chalk.white('Observação para consumidores no Brasil (PT-BR) — Para consumidores brasileiros, este aviso não afasta direitos irrenunciáveis previstos no Código de Defesa do Consumidor (CDC); qualquer limitação aqui prevista só se aplica nos limites da lei e não impede a indenização obrigatória quando cabível.\n'));
+    
+    const termsAccepted = await confirm('Você aceita os Termos de Uso e o Aviso de Risco de Importação?', true);
+    if (!termsAccepted) {
+      console.log(chalk.red('🚫 Operação cancelada pelo usuário.'));
+      process.exit(1);
+    }
+
     // Validar que o arquivo de backup foi fornecido
     if (!options.file) {
       console.error(chalk.red('❌ Arquivo de backup não fornecido'));

package/src/commands/restore/index.js

@@ -1,12 +1,14 @@
 const chalk = require('chalk');
 const path = require('path');
 const fs = require('fs');
+const fsPromises = require('fs').promises;
 const { readEnvFile, writeEnvFile, backupEnvFile } = require('../../utils/env');
 const { saveEnvMap } = require('../../utils/envMap');
 const { mapEnvVariablesInteractively } = require('../../interactive/envMapper');
 const { showBetaBanner } = require('../../utils/banner');
 const { listValidBackups, showRestoreSummary } = require('./utils');
 const { confirm } = require('../../utils/prompt');
+const { ensureDir } = require('../../utils/fsx');
 const step00DockerValidation = require('../backup/steps/00-docker-validation');
 
 // Importar todas as etapas
@@ -19,7 +21,81 @@ const step06Storage = require('./steps/06-storage');
 const step07DatabaseSettings = require('./steps/07-database-settings');
 const step08RealtimeSettings = require('./steps/08-realtime-settings');
 
-module.exports = async (_options) => {
+/**
+ * Função auxiliar para importar arquivo de backup e storage (reutiliza lógica do comando import)
+ */
+async function importBackupFile(sourceFile, sourceStorageFile, outputDir) {
+  // Validar arquivo de backup
+  try {
+    await fsPromises.access(sourceFile);
+  } catch {
+    throw new Error(`Arquivo de backup não encontrado: ${sourceFile}`);
+  }
+
+  // Verificar se é um arquivo .backup.gz ou .backup
+  if (!sourceFile.endsWith('.backup.gz') && !sourceFile.endsWith('.backup')) {
+    throw new Error('Arquivo de backup deve ser .backup.gz ou .backup');
+  }
+
+  // Validar arquivo de storage se fornecido
+  if (sourceStorageFile) {
+    try {
+      await fsPromises.access(sourceStorageFile);
+    } catch {
+      throw new Error(`Arquivo de storage não encontrado: ${sourceStorageFile}`);
+    }
+
+    // Verificar se é um arquivo .storage.zip
+    if (!sourceStorageFile.endsWith('.storage.zip')) {
+      throw new Error('Arquivo de storage deve ser .storage.zip');
+    }
+  }
+
+  // Extrair informações do nome do arquivo de backup
+  // Formato esperado: db_cluster-DD-MM-YYYY@HH-MM-SS.backup.gz
+  const fileName = path.basename(sourceFile);
+  const match = fileName.match(/db_cluster-(\d{2})-(\d{2})-(\d{4})@(\d{2})-(\d{2})-(\d{2})\.backup(\.gz)?/);
+  
+  if (!match) {
+    throw new Error('Nome do arquivo de backup não está no formato esperado do Dashboard. Formato esperado: db_cluster-DD-MM-YYYY@HH-MM-SS.backup.gz');
+  }
+
+  const [, day, month, year, hour, minute, second] = match;
+  
+  // Criar nome da pasta no formato backup-YYYY-MM-DD-HH-MM-SS
+  const backupDirName = `backup-${year}-${month}-${day}-${hour}-${minute}-${second}`;
+  const backupDir = path.join(outputDir, backupDirName);
+  
+  // Criar diretório de backup
+  await ensureDir(backupDir);
+  console.log(chalk.blue(`📁 Importando backup para: ${backupDirName}`));
+  
+  // Copiar arquivo de backup para o diretório de backup
+  const destFile = path.join(backupDir, fileName);
+  await fsPromises.copyFile(sourceFile, destFile);
+  
+  // Obter tamanho do arquivo de backup
+  const stats = await fsPromises.stat(destFile);
+  const sizeMB = (stats.size / (1024 * 1024)).toFixed(2);
+  
+  console.log(chalk.green(`✅ Arquivo de backup importado: ${fileName} (${sizeMB} MB)`));
+  
+  // Copiar arquivo de storage se fornecido
+  if (sourceStorageFile) {
+    const storageFileName = path.basename(sourceStorageFile);
+    const destStorageFile = path.join(backupDir, storageFileName);
+    await fsPromises.copyFile(sourceStorageFile, destStorageFile);
+    
+    const storageStats = await fsPromises.stat(destStorageFile);
+    const storageSizeMB = (storageStats.size / (1024 * 1024)).toFixed(2);
+    
+    console.log(chalk.green(`✅ Arquivo de storage importado: ${storageFileName} (${storageSizeMB} MB)`));
+  }
+  
+  return backupDir;
+}
+
+module.exports = async (options) => {
   showBetaBanner();
   
   try {
@@ -65,11 +141,11 @@ module.exports = async (_options) => {
     // Leitura e mapeamento interativo
     const currentEnv = await readEnvFile(envPath);
     const expectedKeys = [
+      'SUPABASE_PROJECT_ID',
       'NEXT_PUBLIC_SUPABASE_URL',
       'NEXT_PUBLIC_SUPABASE_ANON_KEY',
       'SUPABASE_SERVICE_ROLE_KEY',
       'SUPABASE_DB_URL',
-      'SUPABASE_PROJECT_ID',
       'SUPABASE_ACCESS_TOKEN',
       'SMOONB_OUTPUT_DIR'
     ];
@@ -94,20 +170,43 @@ module.exports = async (_options) => {
       targetAccessToken: getValue('SUPABASE_ACCESS_TOKEN')
     };
     
-    console.log(chalk.blue(`📁 Buscando backups em: ${getValue('SMOONB_OUTPUT_DIR') || './backups'}`));
+    const outputDir = getValue('SMOONB_OUTPUT_DIR') || './backups';
+    let selectedBackup = null;
     
-    // 1. Listar backups válidos (.backup.gz)
-    const validBackups = await listValidBackups(getValue('SMOONB_OUTPUT_DIR') || './backups');
-    
-    if (validBackups.length === 0) {
-      console.error(chalk.red('❌ Nenhum backup válido encontrado'));
-      console.log(chalk.yellow('💡 Execute primeiro: npx smoonb backup'));
-      process.exit(1);
+    // Se --file foi fornecido, importar o arquivo e auto-selecionar
+    if (options.file) {
+      const sourceFile = path.resolve(options.file);
+      const sourceStorageFile = options.storage ? path.resolve(options.storage) : null;
+      
+      console.log(chalk.blue(`📁 Importando arquivo de backup...`));
+      const importedBackupDir = await importBackupFile(sourceFile, sourceStorageFile, outputDir);
+      
+      // Listar backups válidos para encontrar o backup importado
+      const validBackups = await listValidBackups(outputDir);
+      selectedBackup = validBackups.find(b => b.path === importedBackupDir);
+      
+      if (!selectedBackup) {
+        throw new Error('Não foi possível encontrar o backup importado');
+      }
+      
+      console.log(chalk.green(`✅ Backup importado e selecionado automaticamente: ${path.basename(selectedBackup.path)}`));
+    } else {
+      // Fluxo normal: listar e selecionar backup interativamente
+      console.log(chalk.blue(`📁 Buscando backups em: ${outputDir}`));
+      
+      // 1. Listar backups válidos (.backup.gz)
+      const validBackups = await listValidBackups(outputDir);
+      
+      if (validBackups.length === 0) {
+        console.error(chalk.red('❌ Nenhum backup válido encontrado'));
+        console.log(chalk.yellow('💡 Execute primeiro: npx smoonb backup'));
+        process.exit(1);
+      }
+      
+      // 2. Selecionar backup interativamente
+      selectedBackup = await step00BackupSelection(validBackups);
     }
     
-    // 2. Selecionar backup interativamente
-    const selectedBackup = await step00BackupSelection(validBackups);
-    
     // 3. Perguntar quais componentes restaurar
     const components = await step01ComponentsSelection(selectedBackup.path);
     

package/src/interactive/envMapper.js

@@ -7,18 +7,92 @@ async function mapEnvVariablesInteractively(env, expectedKeys) {
   const dePara = {};
 
   const allKeys = Object.keys(env);
+  let projectId = null;
+
+  // Função auxiliar para obter Project ID já mapeado
+  function getProjectId() {
+    if (projectId) return projectId;
+    // Tentar encontrar Project ID já mapeado
+    const projectIdKey = Object.keys(dePara).find(k => dePara[k] === 'SUPABASE_PROJECT_ID');
+    if (projectIdKey && finalEnv[projectIdKey]) {
+      projectId = finalEnv[projectIdKey];
+      return projectId;
+    }
+    // Tentar encontrar no env original
+    const originalKey = Object.keys(env).find(k => k === 'SUPABASE_PROJECT_ID' || env[k]?.match(/^[a-z]{20}$/));
+    if (originalKey && env[originalKey]) {
+      projectId = env[originalKey];
+      return projectId;
+    }
+    return null;
+  }
+
+  // Função para obter instruções e links específicos para cada variável
+  function getVariableInstructions(expected, currentProjectId) {
+    const instructions = {
+      'SUPABASE_PROJECT_ID': {
+        notFound: 'Não foi encontrada uma entrada para a variável SUPABASE_PROJECT_ID.',
+        help: 'Encontre em: Dashboard -> Project Settings -> General -> General Settings -> Project ID',
+        link: null
+      },
+      'NEXT_PUBLIC_SUPABASE_URL': {
+        notFound: 'Não foi encontrada uma entrada para a variável NEXT_PUBLIC_SUPABASE_URL.',
+        help: currentProjectId 
+          ? `Acesse: https://supabase.com/dashboard/project/${currentProjectId}/settings/api`
+          : 'Acesse: Dashboard -> Project Settings -> API -> Project URL',
+        link: currentProjectId ? `https://supabase.com/dashboard/project/${currentProjectId}/settings/api` : null
+      },
+      'NEXT_PUBLIC_SUPABASE_ANON_KEY': {
+        notFound: 'Não foi encontrada uma entrada para a variável NEXT_PUBLIC_SUPABASE_ANON_KEY.',
+        help: currentProjectId
+          ? `Acesse: https://supabase.com/dashboard/project/${currentProjectId}/settings/api-keys`
+          : 'Acesse: Dashboard -> Project Settings -> API -> API Keys -> anon public',
+        link: currentProjectId ? `https://supabase.com/dashboard/project/${currentProjectId}/settings/api-keys` : null
+      },
+      'SUPABASE_SERVICE_ROLE_KEY': {
+        notFound: 'Não foi encontrada uma entrada para a variável SUPABASE_SERVICE_ROLE_KEY.',
+        help: currentProjectId
+          ? `Acesse: https://supabase.com/dashboard/project/${currentProjectId}/settings/api-keys`
+          : 'Acesse: Dashboard -> Project Settings -> API -> API Keys -> service_role secret',
+        link: currentProjectId ? `https://supabase.com/dashboard/project/${currentProjectId}/settings/api-keys` : null
+      },
+      'SUPABASE_DB_URL': {
+        notFound: 'Não foi encontrada uma entrada para a variável SUPABASE_DB_URL.',
+        help: currentProjectId
+          ? `Formato: postgresql://postgres:[DATABASE_PASSWORD]@db.${currentProjectId}.supabase.co:5432/postgres\nPara resetar senha: https://supabase.com/dashboard/project/${currentProjectId}/database/settings`
+          : 'Formato: postgresql://postgres:[DATABASE_PASSWORD]@db.[PROJECT_ID].supabase.co:5432/postgres\nPara resetar senha: Dashboard -> Project Settings -> Database -> Database Settings',
+        link: currentProjectId ? `https://supabase.com/dashboard/project/${currentProjectId}/database/settings` : null
+      },
+      'SUPABASE_ACCESS_TOKEN': {
+        notFound: 'Não foi encontrada uma entrada para a variável SUPABASE_ACCESS_TOKEN.',
+        help: 'Acesse: https://supabase.com/dashboard/account/tokens',
+        link: 'https://supabase.com/dashboard/account/tokens'
+      },
+      'SMOONB_OUTPUT_DIR': {
+        notFound: 'Não foi encontrada uma entrada para a variável SMOONB_OUTPUT_DIR.',
+        help: 'Diretório padrão para armazenar backups',
+        link: null,
+        default: './backups'
+      }
+    };
+
+    return instructions[expected] || {
+      notFound: `Não foi encontrada uma entrada para a variável ${expected}.`,
+      help: '',
+      link: null
+    };
+  }
 
   for (const expected of expectedKeys) {
     console.log(chalk.blue(`\n🔧 Mapeando variável: ${expected}`));
 
     let clientKey = undefined;
 
-    // 3) Se existir chave exatamente igual, pular seleção e ir direto para confirmação
+    // Se existir chave exatamente igual, pular seleção e ir direto para confirmação
     if (Object.prototype.hasOwnProperty.call(finalEnv, expected)) {
       clientKey = expected;
     } else {
-      // 2) Remover o caractere '?' do início da pergunta definindo prefix: ''
-      // 4) Opção explícita para adicionar nova chave
+      // Opção explícita para adicionar nova chave
       const choices = [
         ...allKeys.map((k, idx) => ({ name: `${idx + 1}. ${k}`, value: k })),
         new inquirer.Separator(),
@@ -48,30 +122,71 @@ async function mapEnvVariablesInteractively(env, expectedKeys) {
     }
 
     const currentValue = finalEnv[clientKey] ?? '';
-    const isCorrect = await confirm(`Valor atual: ${currentValue || '(vazio)'}\nEste é o valor correto do projeto alvo?`, true);
+    const currentProjectId = getProjectId();
+    const instructions = getVariableInstructions(expected, currentProjectId);
 
-    let valueToWrite = currentValue;
-    if (!isCorrect) {
+    // Se não tem valor, mostrar mensagem específica
+    if (!currentValue) {
+      console.log(chalk.yellow(instructions.notFound));
+      if (instructions.help) {
+        console.log(chalk.white(instructions.help));
+      }
+      if (instructions.link) {
+        console.log(chalk.cyan(`🔗 ${instructions.link}`));
+      }
+    } else {
+      // Se tem valor, perguntar se está correto
+      const isCorrect = await confirm(`Valor atual: ${currentValue}\nEste é o valor correto do projeto alvo?`, true);
+      if (isCorrect) {
+        finalEnv[clientKey] = currentValue;
+        if (expected === 'SUPABASE_PROJECT_ID') {
+          projectId = currentValue;
+        }
+        if (dePara[clientKey] && dePara[clientKey] !== expected) {
+          throw new Error(`Duplicidade de mapeamento detectada para ${clientKey}`);
+        }
+        dePara[clientKey] = expected;
+        continue;
+      }
+    }
+
+    // Solicitar novo valor
+    let valueToWrite = '';
+    if (expected === 'SMOONB_OUTPUT_DIR') {
+      // Para SMOONB_OUTPUT_DIR, pré-preencher com ./backups
       const { newValue } = await inquirer.prompt([{
         type: 'input',
         name: 'newValue',
-        message: `Cole o novo valor para ${clientKey}:`,
+        message: `Confirme o novo valor para ${expected}:`,
+        default: instructions.default || './backups',
+        prefix: ''
+      }]);
+      valueToWrite = newValue || instructions.default || './backups';
+    } else {
+      const { newValue } = await inquirer.prompt([{
+        type: 'input',
+        name: 'newValue',
+        message: `Cole o novo valor para ${expected}:`,
         prefix: ''
       }]);
       valueToWrite = newValue || '';
     }
 
-    if (!valueToWrite) {
+    // Validar valor obrigatório (exceto SMOONB_OUTPUT_DIR que tem default)
+    if (!valueToWrite && expected !== 'SMOONB_OUTPUT_DIR') {
       const { newValueRequired } = await inquirer.prompt([{
         type: 'input',
         name: 'newValueRequired',
-        message: `Valor obrigatório. Informe valor para ${clientKey}:`,
+        message: `Valor obrigatório. Informe valor para ${expected}:`,
         prefix: ''
       }]);
       valueToWrite = newValueRequired || '';
     }
 
-    finalEnv[clientKey] = valueToWrite;
+    finalEnv[clientKey] = valueToWrite || (expected === 'SMOONB_OUTPUT_DIR' ? './backups' : '');
+    if (expected === 'SUPABASE_PROJECT_ID') {
+      projectId = valueToWrite;
+    }
     if (dePara[clientKey] && dePara[clientKey] !== expected) {
       throw new Error(`Duplicidade de mapeamento detectada para ${clientKey}`);
     }