smoonb 1.0.12 → 1.0.13

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [1.0.13] - 2026-11-05
+
+### Fixed
+- Query migration history in read-only mode before export. Missing or empty history is a successful zero-file backup, not an export error. Connection/permission failures remain failures.
+- Keep a component-by-component summary for incomplete backups, including successful components and actionable migration failure reasons.
+- Suppress only the bundled CLI's generic upgrade advertisement; retain database diagnostics.
+- Verify exported migration file count against the recorded history count.
+
 ## [1.0.12] - 2026-11-05
 
 ### Fixed

package/README.md

@@ -690,4 +690,6 @@ Additional restore-path test: `npm run test:restore:docker`. Uses disposable Pos
 
 Use Node.js LTS 22, 24 or 26 and a running Docker engine. Supabase CLI 2.122.1 is an exact package dependency, with npm-shrinkwrap.json locking distribution dependencies. The global CLI and npm latest do not determine backup compatibility. The v2 channel receives maintenance; no fixed LTS term is assumed. The first export may need to download the PostgreSQL image used by the CLI.
 
-SQL, roles, Functions and migrations run in temporary workspaces. Project files are preserved. Failed requested components yield exit code 1 and incomplete status; successful files remain available. Environment mappings apply to the current run without rewriting the project file. Upgrade legacy installations explicitly after publication: `npm install --save-exact smoonb@1.0.12`.
+SQL, roles, Functions and migrations run in temporary workspaces. Project files are preserved. Failed requested components yield exit code 1 and incomplete status; successful files remain available. Environment mappings apply to the current run without rewriting the project file. Upgrade legacy installations explicitly after publication: `npm install --save-exact smoonb@1.0.13`.
+
+In 1.0.13, databases without migration history complete that component with zero files. Connection/permission failures still produce an incomplete backup, with a summary of every component.

package/README.pt-BR.md

@@ -692,4 +692,6 @@ Use Node.js LTS 22, 24 ou 26 e Docker ativo. O pacote inclui Supabase CLI 2.122.
 
 O backup usa diretórios temporários para SQL, roles, Functions e migrations, preserva os arquivos do projeto e retorna código 1/status incomplete quando um componente solicitado falha. Os arquivos concluídos ficam disponíveis, mas o conjunto não deve ser tratado como completo. O mapeamento de ambiente vale para a execução, sem regravar o arquivo do projeto.
 
-Após publicação, no Sicoop execute `npm install --save-exact smoonb@1.0.12`, confira `npx smoonb --version` e execute um novo backup. A versão 0.0.60 não consulta o validador e não pode ser bloqueada remotamente. Não reutilize um backup incompleto como se fosse completo.
+Após publicação, no Sicoop execute `npm install --save-exact smoonb@1.0.13`, confira `npx smoonb --version` e execute um novo backup. A versão 0.0.60 não consulta o validador e não pode ser bloqueada remotamente. Não reutilize um backup incompleto como se fosse completo.
+
+Na 1.0.13, bancos sem histórico de migrations concluem essa etapa com zero arquivos. Falhas reais de conexão/permissão continuam produzindo backup incompleto, sempre com resumo de todas as etapas.

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "smoonb",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "smoonb",
-      "version": "1.0.12",
+      "version": "1.0.13",
       "hasInstallScript": true,
       "license": "SEE LICENSE IN LICENSE.md",
       "dependencies": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smoonb",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "description": "Complete Supabase backup and migration tool. https://www.smoonb.com/#price",
   "preferGlobal": false,
   "preventGlobalInstall": true,
@@ -11,8 +11,8 @@
   "scripts": {
     "test": "node --test tests/*.test.js",
     "start": "node bin/smoonb.js",
-    "preinstall": "node -e \"if(process.env.npm_config_global) { console.error('\\n\u274c SMOONB N\u00c3O DEVE SER INSTALADO GLOBALMENTE!\\n\\n\ud83d\udccb Para usar o smoonb, instale localmente no seu projeto:\\n   npm install smoonb\\n\\n\ud83d\udca1 Depois execute com:\\n   npx smoonb backup\\n\\n\ud83d\udeab Instala\u00e7\u00e3o global cancelada!\\n'); process.exit(1); }\"",
-    "postinstall": "echo '\\n\u2705 smoonb instalado com sucesso!\\n\ud83d\udca1 Execute: npx smoonb backup\\n\ud83d\udcd6 Documenta\u00e7\u00e3o: https://github.com/almmello/smoonb\\n'",
+    "preinstall": "node -e \"if(process.env.npm_config_global) { console.error('\\n❌ SMOONB NÃO DEVE SER INSTALADO GLOBALMENTE!\\n\\n📋 Para usar o smoonb, instale localmente no seu projeto:\\n   npm install smoonb\\n\\n💡 Depois execute com:\\n   npx smoonb backup\\n\\n🚫 Instalação global cancelada!\\n'); process.exit(1); }\"",
+    "postinstall": "echo '\\n✅ smoonb instalado com sucesso!\\n💡 Execute: npx smoonb backup\\n📖 Documentação: https://github.com/almmello/smoonb\\n'",
     "lint": "eslint . --ext .js",
     "lint:fix": "eslint . --ext .js --fix",
     "build": "node scripts/build.js",

package/src/commands/backup/index.js

@@ -403,6 +403,8 @@ module.exports = async (options) => {
     } else {
       console.error('BACKUP INCOMPLETO: ' + outcome.failed_components.join(', '));
       console.log('Arquivos preservados em: ' + finalBackupDir);
+      for (const line of require('./outcome').componentSummary(manifest.components)) console.log(line);
+      console.log('Consulte backup-manifest.json para os detalhes e refaça o backup após resolver as etapas com falha.');
     }
 
     // report.json

package/src/commands/backup/outcome.js

@@ -5,4 +5,12 @@ function backupOutcome(components) {
 function storageComplete(buckets, expected) {
   return buckets.length === expected && buckets.every(b => !b.listingFailed && b.filesSkipped === 0 && b.filesDownloaded === b.totalFiles && b.objectCount === b.totalFiles);
 }
-module.exports = { backupOutcome, storageComplete };
+function componentSummary(components) {
+  const labels = { database: 'Banco de dados', database_separated: 'SQL separados', database_settings: 'Configurações do banco', auth_settings: 'Auth', realtime: 'Realtime', storage: 'Storage', custom_roles: 'Roles', edge_functions: 'Edge Functions', supabase_temp: 'Arquivos locais Supabase', migrations: 'Migrations' };
+  const reasons = { migration_history_check_failed: 'não foi possível consultar o histórico; confira conexão e permissões', migration_export_failed: 'não foi possível exportar o histórico', history_absent: 'nenhum histórico registrado', history_empty: 'histórico vazio' };
+  return Object.entries(components).map(([name, result]) => {
+    const count = result?.file_count ?? result?.functions_count ?? result?.totalFiles;
+    return `${result?.success === true ? 'OK' : 'FALHA'} - ${labels[name] || name}${count === undefined ? '' : ': ' + count}${result?.reason && result.reason !== 'success' ? ' (' + (reasons[result.reason] || result.reason) + ')' : ''}`;
+  });
+}
+module.exports = { backupOutcome, storageComplete, componentSummary };

package/src/commands/backup/steps/03-database-separated.js

@@ -2,12 +2,12 @@ const chalk = require('chalk');
 const path = require('path');
 const fs = require('fs').promises;
 const { t } = require('../../../i18n');
-const { createPgDumpDiagnostics, hasReplicaRolePrologue } = require('../../../utils/pg-dump-diagnostics');
+const { createPgDumpDiagnostics, hasReplicaRolePrologue, withoutCliUpgradeNotice } = require('../../../utils/pg-dump-diagnostics');
 
 const { isolatedSupabase } = require('../../../utils/supabaseCli');
 async function runWithElapsedTicker(_command, args, env) {
   const result = await isolatedSupabase(args, env, { capture: true });
-  let stderr = String(result.stderr || '');
+  let stderr = withoutCliUpgradeNotice(result.stderr || '');
   const secrets = Object.values(env || {}).filter(Boolean);
   const databaseUrl = args[args.indexOf('--db-url') + 1];
   if (databaseUrl) {

package/src/commands/backup/steps/11-migrations.js

@@ -2,16 +2,34 @@ const path = require('path');
 const fs = require('fs').promises;
 const os = require('os');
 const { runSupabase } = require('../../../utils/supabaseCli');
+const { runSql } = require('../../restore/pg');
 const { copyDirectoryRecursive } = require('../../restore/utils');
-module.exports = async ({ databaseUrl, accessToken, backupDir }) => {
+module.exports = async ({ databaseUrl, accessToken, backupDir, postgresMajor = 17 }, { query = runSql, run = runSupabase } = {}) => {
   const root = await fs.mkdtemp(path.join(os.tmpdir(), 'smoonb-migrations-'));
+  let phase = 'migration_history_check_failed';
   try {
+    const history = await query(databaseUrl, "BEGIN READ ONLY; SET LOCAL statement_timeout = '20s'; SELECT to_regclass('supabase_migrations.schema_migrations') IS NOT NULL; COMMIT;", { postgresMajor });
+    if (!['t', 'f'].includes(history.trim())) throw new Error('Unexpected history response');
+    let count = 0;
+    if (history.trim() === 't') {
+      const value = await query(databaseUrl, "BEGIN READ ONLY; SET LOCAL statement_timeout = '20s'; SELECT count(*) FROM supabase_migrations.schema_migrations; COMMIT;", { postgresMajor });
+      if (!/^\d+$/.test(value.trim())) throw new Error('Unexpected migration count');
+      count = Number(value.trim());
+    }
+    if (count === 0) {
+      await fs.mkdir(path.join(backupDir, 'migrations'), { recursive: true });
+      console.log('Migrations: nenhum histórico registrado no banco; nada a exportar.');
+      return { success: true, file_count: 0, reason: history.trim() === 'f' ? 'history_absent' : 'history_empty' };
+    }
+    phase = 'migration_export_failed';
     await fs.mkdir(path.join(root, 'supabase', 'migrations'), { recursive: true });
     await fs.writeFile(path.join(root, 'supabase', 'config.toml'), 'project_id = "smoonb-backup"\n');
-    runSupabase('supabase', ['migration', 'fetch', '--db-url', databaseUrl, '--workdir', root, '--yes'], { cwd: root, env: { ...process.env, SUPABASE_ACCESS_TOKEN: accessToken }, stdio: 'pipe' });
+    run('supabase', ['migration', 'fetch', '--db-url', databaseUrl, '--workdir', root, '--yes'], { cwd: root, env: { ...process.env, SUPABASE_ACCESS_TOKEN: accessToken }, stdio: 'pipe' });
     const source = path.join(root, 'supabase', 'migrations');
     await copyDirectoryRecursive(source, path.join(backupDir, 'migrations'));
-    return { success: true, file_count: (await fs.readdir(source)).length };
-  } catch { return { success: false, reason: 'migration_export_failed' }; }
+    const fileCount = (await fs.readdir(source)).filter(name => name.endsWith('.sql')).length;
+    if (fileCount !== count) throw new Error('Migration export count mismatch');
+    return { success: true, file_count: fileCount };
+  } catch { return { success: false, reason: phase, action: 'Check database connectivity and access to supabase_migrations.schema_migrations; retry the backup.' }; }
   finally { await fs.rm(root, { recursive: true, force: true }); }
 };

package/src/utils/pg-dump-diagnostics.js

@@ -1,64 +1,68 @@
-const { StringDecoder } = require('string_decoder');
-const fs = require('fs').promises;
-
-// Only the exact, known pg_dump circular-FK block is consolidated. All other
-// stderr (including errors and unfamiliar/localized warnings) remains visible.
-function createPgDumpDiagnostics(writeStderr) {
-  const decoder = new StringDecoder('utf8');
-  let pending = '';
-  let inCircularWarning = false;
-  const warnings = [];
-  const tables = new Set();
-  const hints = new Set([
-    'pg_dump: hint: You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.',
-    'pg_dump: hint: Consider using a full dump instead of a --data-only dump to avoid this problem.'
-  ]);
-  function line(raw) {
-    const text = raw.replace(/\r?\n$/, '');
-    if (/^pg_dump: warning: there are circular foreign-key constraints (?:among these tables|on this table):$/.test(text)) {
-      inCircularWarning = true;
-      warnings.push(text);
-    } else if (inCircularWarning && text.startsWith('pg_dump: detail: ')) {
-      tables.add(text.slice('pg_dump: detail: '.length));
-      warnings.push(text);
-    } else if (inCircularWarning && hints.has(text)) {
-      warnings.push(text);
-    } else {
-      inCircularWarning = false;
-      writeStderr(raw);
-    }
-  }
-  function consume(text) {
-    pending += text;
-    let end;
-    while ((end = pending.indexOf('\n')) !== -1) {
-      line(pending.slice(0, end + 1));
-      pending = pending.slice(end + 1);
-    }
-  }
-  return {
-    write(chunk) { consume(decoder.write(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk))); },
-    end() {
-      consume(decoder.end());
-      if (pending) line(pending);
-      pending = '';
-      return { circularForeignKeys: warnings.length > 0, tables: [...tables], messages: warnings };
-    }
-  };
-}
-
-// Supabase prepends this command before pg_dump output. Check the first line,
-// not arbitrary table contents: a data row containing SQL is not protection.
-async function hasReplicaRolePrologue(file) {
-  const handle = await fs.open(file, 'r');
-  try {
-    const buffer = Buffer.alloc(256);
-    const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
-    const firstLine = buffer.toString('utf8', 0, bytesRead).split('\n')[0].replace(/^\uFEFF/, '').trim();
-    return /^SET\s+session_replication_role\s*=\s*(?:replica|'replica');$/i.test(firstLine);
-  } finally {
-    await handle.close();
-  }
-}
-
-module.exports = { createPgDumpDiagnostics, hasReplicaRolePrologue };
+const { StringDecoder } = require('string_decoder');
+const fs = require('fs').promises;
+
+// Only the exact, known pg_dump circular-FK block is consolidated. All other
+// stderr (including errors and unfamiliar/localized warnings) remains visible.
+function createPgDumpDiagnostics(writeStderr) {
+  const decoder = new StringDecoder('utf8');
+  let pending = '';
+  let inCircularWarning = false;
+  const warnings = [];
+  const tables = new Set();
+  const hints = new Set([
+    'pg_dump: hint: You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.',
+    'pg_dump: hint: Consider using a full dump instead of a --data-only dump to avoid this problem.'
+  ]);
+  function line(raw) {
+    const text = raw.replace(/\r?\n$/, '');
+    if (/^pg_dump: warning: there are circular foreign-key constraints (?:among these tables|on this table):$/.test(text)) {
+      inCircularWarning = true;
+      warnings.push(text);
+    } else if (inCircularWarning && text.startsWith('pg_dump: detail: ')) {
+      tables.add(text.slice('pg_dump: detail: '.length));
+      warnings.push(text);
+    } else if (inCircularWarning && hints.has(text)) {
+      warnings.push(text);
+    } else {
+      inCircularWarning = false;
+      writeStderr(raw);
+    }
+  }
+  function consume(text) {
+    pending += text;
+    let end;
+    while ((end = pending.indexOf('\n')) !== -1) {
+      line(pending.slice(0, end + 1));
+      pending = pending.slice(end + 1);
+    }
+  }
+  return {
+    write(chunk) { consume(decoder.write(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk))); },
+    end() {
+      consume(decoder.end());
+      if (pending) line(pending);
+      pending = '';
+      return { circularForeignKeys: warnings.length > 0, tables: [...tables], messages: warnings };
+    }
+  };
+}
+
+// Supabase prepends this command before pg_dump output. Check the first line,
+// not arbitrary table contents: a data row containing SQL is not protection.
+async function hasReplicaRolePrologue(file) {
+  const handle = await fs.open(file, 'r');
+  try {
+    const buffer = Buffer.alloc(256);
+    const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+    const firstLine = buffer.toString('utf8', 0, bytesRead).split('\n')[0].replace(/^\uFEFF/, '').trim();
+    return /^SET\s+session_replication_role\s*=\s*(?:replica|'replica');$/i.test(firstLine);
+  } finally {
+    await handle.close();
+  }
+}
+
+// The bundled CLI is deliberately pinned. Suppress only its generic upgrade advert.
+function withoutCliUpgradeNotice(text) {
+  return String(text).split(/(?<=\n)/).filter(line => !/^A new version of Supabase CLI is available: v[0-9.]+ \(currently installed v[0-9.]+\)\r?\n?$/.test(line) && !/^We recommend updating regularly for new features and bug fixes: https:\/\/supabase\.com\/docs\/guides\/cli\/getting-started#updating-the-supabase-cli\r?\n?$/.test(line)).join('');
+}
+module.exports = { createPgDumpDiagnostics, hasReplicaRolePrologue, withoutCliUpgradeNotice };