feat: improve error handling in pdodb dump command

- Add typo detection for 'restore' command (suggests correct command)
- Add table existence check before dumping (prevents fatal errors)
- Improve exception handling with try/catch for QueryException and
  general Exception (replaces fatal errors with user-friendly messages)
- Add tests for error handling:
  - testDumpCommandTypoInRestore() - verifies typo detection
  - testDumpCommandNonExistentTable() - verifies table existence check
- All errors now display clear messages instead of fatal exceptions

Author: tommyknocker

src/cli/commands/DumpCommand.php

@@ -6,6 +6,7 @@
 
 use tommyknocker\pdodb\cli\Command;
 use tommyknocker\pdodb\cli\DumpManager;
+use tommyknocker\pdodb\exceptions\QueryException;
 use tommyknocker\pdodb\exceptions\ResourceException;
 
 /**
@@ -45,6 +46,11 @@ public function execute(): int
             return $this->restore();
         }
 
+        // Check for common typos in 'restore' command
+        if ($firstArg !== null && (str_starts_with($firstArg, 'restor') || str_starts_with($firstArg, 'retor'))) {
+            return $this->showError("Unknown command: '{$firstArg}'. Did you mean 'restore'?");
+        }
+
         // If no arguments, check if dump-specific options are provided
         // If yes, dump entire database; if no, show help
         if ($firstArg === null) {
@@ -80,6 +86,15 @@ protected function dump(): int
 
         try {
             $db = $this->getDb();
+
+            // Check if table exists when table name is provided
+            if (is_string($table) && $table !== '') {
+                $schema = $db->schema();
+                if (!$schema->tableExists($table)) {
+                    return $this->showError("Table '{$table}' does not exist");
+                }
+            }
+
             $sql = DumpManager::dump($db, is_string($table) ? $table : null, $schemaOnly, $dataOnly, $dropTables);
 
             if (is_string($output) && $output !== '') {
@@ -95,6 +110,15 @@ protected function dump(): int
             return 0;
         } catch (ResourceException $e) {
             return $this->showError($e->getMessage());
+        } catch (QueryException $e) {
+            // Check if error is about table not found
+            $message = $e->getMessage();
+            if (is_string($table) && $table !== '' && (str_contains($message, "doesn't exist") || str_contains($message, 'not found'))) {
+                return $this->showError("Table '{$table}' does not exist");
+            }
+            return $this->showError($message);
+        } catch (\Exception $e) {
+            return $this->showError($e->getMessage());
         }
     }
 

tests/shared/DumpCommandCliTests.php

@@ -212,4 +212,27 @@ public function testDumpCommandNoDropTablesOption(): void
 
         unlink($dumpFile);
     }
+
+    public function testDumpCommandTypoInRestore(): void
+    {
+        // Run in a subprocess to avoid exit() killing PHPUnit
+        $bin = realpath(__DIR__ . '/../../bin/pdodb');
+        $env = 'PDODB_DRIVER=sqlite PDODB_PATH=' . escapeshellarg(self::$dbPath) . ' PDODB_NON_INTERACTIVE=1';
+        $cmd = $env . ' ' . escapeshellcmd(PHP_BINARY) . ' ' . escapeshellarg((string)$bin) . ' dump retore 2>&1';
+        $out = (string)shell_exec($cmd);
+        $this->assertStringContainsString('Error:', $out);
+        $this->assertStringContainsString("Unknown command: 'retore'", $out);
+        $this->assertStringContainsString("Did you mean 'restore'?", $out);
+    }
+
+    public function testDumpCommandNonExistentTable(): void
+    {
+        // Run in a subprocess to avoid exit() killing PHPUnit
+        $bin = realpath(__DIR__ . '/../../bin/pdodb');
+        $env = 'PDODB_DRIVER=sqlite PDODB_PATH=' . escapeshellarg(self::$dbPath) . ' PDODB_NON_INTERACTIVE=1';
+        $cmd = $env . ' ' . escapeshellcmd(PHP_BINARY) . ' ' . escapeshellarg((string)$bin) . ' dump nonexistent_table 2>&1';
+        $out = (string)shell_exec($cmd);
+        $this->assertStringContainsString('Error:', $out);
+        $this->assertStringContainsString("Table 'nonexistent_table' does not exist", $out);
+    }
 }