smoonb 0.0.62 → 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.62",
+  "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/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 {
@@ -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);