feat: support the new DNS API (#568)

Add support for the new [DNS
API](https://docs.hetzner.cloud/reference/cloud#dns).

The DNS API is currently in **beta**.

See the [DNS API beta
changelog](https://docs.hetzner.cloud/changelog#2025-10-07-dns-beta) for
more details.

Author: jooola

docs/api.clients.zones.rst

@@ -0,0 +1,30 @@
+ZonesClient
+==================
+
+
+.. autoclass:: hcloud.zones.client.ZonesClient
+    :members:
+
+.. autoclass:: hcloud.zones.client.BoundZone
+    :members:
+
+.. autoclass:: hcloud.zones.client.BoundZoneRRSet
+    :members:
+
+.. autoclass:: hcloud.zones.domain.Zone
+    :members:
+
+.. autoclass:: hcloud.zones.domain.ZoneAuthoritativeNameservers
+    :members:
+
+.. autoclass:: hcloud.zones.domain.ZonePrimaryNameserver
+    :members:
+
+.. autoclass:: hcloud.zones.domain.ZoneRecord
+    :members:
+
+.. autoclass:: hcloud.zones.domain.ZoneRRSet
+    :members:
+
+.. autoclass:: hcloud.zones.domain.CreateZoneResponse
+    :members:

hcloud/_client.py

@@ -26,6 +26,7 @@
 from .servers import ServersClient
 from .ssh_keys import SSHKeysClient
 from .volumes import VolumesClient
+from .zones import ZonesClient
 
 
 class BackoffFunction(Protocol):
@@ -254,6 +255,12 @@ def __init__(
         :type: :class:`PlacementGroupsClient <hcloud.placement_groups.client.PlacementGroupsClient>`
         """
 
+        self.zones = ZonesClient(self)
+        """ZonesClient Instance
+
+        :type: :class:`ZonesClient <hcloud.zones.client.ZonesClient>`
+        """
+
     def request(  # type: ignore[no-untyped-def]
         self,
         method: str,

hcloud/zones/__init__.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from .client import (
+    BoundZone,
+    BoundZoneRRSet,
+    ZonesClient,
+    ZonesPageResult,
+)
+from .domain import (
+    CreateZoneResponse,
+    Zone,
+    ZoneAuthoritativeNameservers,
+    ZonePrimaryNameserver,
+    ZoneRecord,
+    ZoneRRSet,
+)
+
+__all__ = [
+    "BoundZone",
+    "BoundZoneRRSet",
+    "CreateZoneResponse",
+    "Zone",
+    "ZoneAuthoritativeNameservers",
+    "ZonePrimaryNameserver",
+    "ZoneRecord",
+    "ZoneRRSet",
+    "ZonesClient",
+    "ZonesPageResult",
+]