Merge pull request #7251 from keboola/zajca/table-swap

feat(storage): add table swap operation

Author: zajca

src/Keboola/StorageApi/Client.php

@@ -1430,6 +1430,27 @@ public function dropTable($tableId, $options = ['async' => true])
         return $result;
     }
 
+    /**
+     * Swap two tables. Aliases are not transferred — they keep pointing at
+     * the same physical position, so after the swap they expose the data of
+     * the other table.
+     *
+     * @return array<string, mixed>
+     */
+    public function swapTables(string $tableId, string $targetTableId): array
+    {
+        if (!$this instanceof BranchAwareClient) {
+            throw new ClientException('Swapping tables is supported only in dev branch. Use BranchAwareClient instance.');
+        }
+
+        /** @var array<string, mixed> $result */
+        $result = $this->apiPostJson("tables/{$tableId}/swap", [
+            'targetTableId' => $targetTableId,
+        ]);
+        $this->log("Table {$tableId} swapped with {$targetTableId}");
+        return $result;
+    }
+
     /**
      *
      * Add column to table