feat: implement actions waiter

[jooola]

Implement a simpler and more versatile waiting functions for actions.

Most use cases when waiting for actions is to return early if an action fails. If all actions must be waited until completion, the users should use the WaitForFunc function.

If the final actions objects are needed, the users should use the WaitForFunc function to store the final actions using the handleUpdate callback.

This deprecates the ActionClient.WatchOverallProgress and ActionClient.WatchProgress methods.

[codecov]

Codecov Report

Attention: Patch coverage is 92.10526% with 6 lines in your changes are missing coverage. Please review.

Project coverage is 80.69%. Comparing base (172d137) to head (7bb1a7b).

Files	Patch %	Lines
hcloud/action_waiter.go	87.50%	3 Missing and 3 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #407      +/-   ##
==========================================
+ Coverage   80.43%   80.69%   +0.25%     
==========================================
  Files          33       34       +1     
  Lines        5756     5770      +14     
==========================================
+ Hits         4630     4656      +26     
+ Misses        718      708      -10     
+ Partials      408      406       -2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[apricote]

Looking mostly good, I really like the new Interface. This matches what we need in most integrations very well.

Did you already test this code in CLI or some other tool? Would be nice if we had some real life (or e2e) test usage before releasing.

[jooola]

I fixed the few comments.

I didn't use this branch in another project, I'll try it out.

[apricote]

API was tested by @jooola in some of our projects:

• refactor: use new client.Action.WaitFor csi-driver#600
• refactor: use new client.Action.WaitFor hcloud-cloud-controller-manager#636
• refactor: use new client.Action.WaitFor packer-plugin-hcloud#171
• hetznercloud/cli@main...4e73687

[apricote]

Great work @jooola! Looking forward to replace all of our home-grown implementations with this one!

[github-actions]

The backport to release-1.x failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-release-1.x release-1.x
# Navigate to the new working tree
cd .worktrees/backport-release-1.x
# Create a new branch
git switch --create backport-407-to-release-1.x
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 1e3fa7033d8a1cea1c0a9007a6255798979f0771
# Push it to GitHub
git push --set-upstream origin backport-407-to-release-1.x
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-release-1.x

Then, create a pull request where the base branch is release-1.x and the compare/head branch is backport-407-to-release-1.x.