gandi_v5 0.6.0 → 0.10.0

data/lib/gandi_v5/domain/transfer_in/availability.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+class GandiV5
+  class Domain
+    class TransferIn
+      # Information about the availabillity of a domain to be transfered into Gandi.
+      # @!attribute [r] fqdn
+      #   @return [String] the fully qualified domain name.
+      # @!attribute [r] fqdn_unicode
+      #   @return [String] the fully qualified domain name in unicode.
+      # @!attribute [r] available
+      #   @return [Boolean] whether the domain can be transfered.
+      # @!attribute [r] corporate
+      #   @return [Boolean] Optional
+      # @!attribute [r] internal
+      #   @return [Boolean] Optional
+      # @!attribute [r] minimum_duration
+      #   @return [Integer] Optional the minimum duration you can reregister the domain for.
+      # @!attribute [r] maximum_duration
+      #   @return [Integer] Optional the maximum duration you can reregister the domain for.
+      # @!attribute [r] durations
+      #   @return [Array<Integer>] Optional the durations you can reregister the domain for.
+      # @!attribute [r] message
+      #   @return [String, nil] Optional message explaining why the domain can't be transfered.
+      class Availability
+        include GandiV5::Data
+
+        members :fqdn, :available, :corporate, :internal,
+                :minimum_duration, :maximum_duration
+        member :durations, array: true
+        member :message, gandi_key: 'msg'
+        member :fqdn_unicode, gandi_key: 'fqdn_ulabel'
+
+        # Find out if a domain can be transfered to Gandi.
+        # @see https://api.gandi.net/docs/domains/#post-v5-domain-transferin-domain-available
+        # @param fqdn [String, #to_s] the fully qualified domain name to query.
+        # @param auth_code [String, #to_s] authorization code (if required).
+        # @return [GandiV5::Domain::TransferIn::Availabillity]
+        # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+        def self.fetch(fqdn, auth_code = nil)
+          url = "#{BASE}domain/transferin/#{fqdn}/available"
+          body = {}
+          body['authinfo'] = auth_code if auth_code
+
+          _response, data = GandiV5.post url, body
+          from_gandi data
+        end
+      end
+    end
+  end
+end

data/lib/gandi_v5/domain/web_forwarding.rb

@@ -0,0 +1,182 @@
+# frozen_string_literal: true
+
+class GandiV5
+  class Domain
+    # Manage web forwarding.
+    # @!attribute [r] created_at
+    #   @return [Time, nil]
+    # @!attribute [r] updated_at
+    #   @return [Time, nil]
+    # @!attribute [r] type
+    #   @return [:cloak, :http301, :http302]
+    # @!attribute [r] fqdn
+    #   @return [String]
+    # @!attribute [r] protocol
+    #   @return [:http, :https, :https_only, nil]
+    # @!attribute [r] target
+    #   @return [String]
+    # @!attribute [r] cert_status
+    #   @return [String, nil]
+    # @!attribute [r] cert_uuid
+    #   @return [String, nil]
+    class WebForwarding
+      include GandiV5::Data
+
+      members :cert_uuid, :cert_status
+      member :target, gandi_key: 'url'
+      member :fqdn, gandi_key: 'host'
+      member :type, converter: GandiV5::Data::Converter::Symbol
+      member :created_at, converter: GandiV5::Data::Converter::Time
+      member :updated_at, converter: GandiV5::Data::Converter::Time
+      member(
+        :protocol,
+        converter: GandiV5::Data::Converter.new(
+          from_gandi: lambda { |value|
+            {
+              'http' => :http,
+              'https' => :https,
+              'httpsonly' => :https_only
+            }.fetch(value)
+          }
+        )
+      )
+
+      # Update the redirection in Gandi.
+      # @see https://api.gandi.net/docs/domains/#patch-v5-domain-domains-domain-webredirs-host
+      # @param target [String, #to_s] the url to redirect to (e.g. www.example.com/path).
+      # @param protocol [:http, :https, :https_only]
+      # @param type [:cloak, :http301, :http302]
+      # @param override [Boolean] If true, a DNS record will be created.
+      #   When the value is false and no matching DNS record exists, it will trigger an error.
+      # @return [GandiV5::Domain::WebRedirection]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error
+      def update(target: nil, protocol: nil, type: nil, override: nil)
+        body = {}
+        body['url'] = target.to_s unless target.nil?
+        body['protocol'] = protocol.to_s.delete('_') unless protocol.nil?
+        body['type'] = type.to_s unless type.nil?
+        body['override'] = override unless override.nil?
+
+        GandiV5.patch url, body.to_json
+        refresh
+      end
+
+      # Delete this web redirection from Gandi.
+      # @see https://api.gandi.net/docs/domains/#delete-v5-domain-domains-domain-webredirs-host
+      # @return [String] The confirmation message from Gandi.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def delete
+        _response, data = GandiV5.delete url
+        data['message']
+      end
+
+      # Check if this is an HTTP 301 (permanent) redirection.
+      def http301?
+        type == :http301
+      end
+
+      # Check if this is an HTTP 302 (found) redirection.
+      def http302?
+        type == :http302
+      end
+
+      # Check if this is an HTTP 301 (permanent) redirection.
+      def permanent?
+        type == :http301
+      end
+
+      # Check if this is an HTTP 302 (found) redirection.
+      def found?
+        type == :http302
+      end
+
+      # Check if this is a temporary redirection.
+      def temporary?
+        type == :http302
+      end
+
+      # Check if it's an http end point
+      def http?
+        protocol == :http || protocol == :https
+      end
+
+      # Check if it's an https end point
+      def https?
+        protocol == :https || protocol == :https_only
+      end
+
+      # Check if it's an https only
+      def https_only?
+        protocol == :https_only
+      end
+
+      # Create a new web redirection.
+      # @see https://api.gandi.net/docs/domains/#post-v5-domain-domains-domain-webredirs
+      # @param domain [String, #to_s] the domain name to create the redirection in.
+      # @param host [String, #to_s] the host name to redirect from.
+      # @param target [String, #to_s] the url to redirect to (e.g. www.example.com/path).
+      # @param protocol [:http, :https, :https_only]
+      # @param type [:cloak, :http301, :http302]
+      # @param override [Boolean] When you create a redirection on a domain, a DNS record is created
+      #   if it does not exist. When the record already exists and this parameter is set to true it
+      #   will overwrite the record. Otherwise it will trigger an error.
+      # @return [GandiV5::Domain::WebRedirection] the created redirection
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error
+      def self.create(domain:, host:, target:, protocol:, type:, override: false)
+        body = {
+          'host' => host.to_s,
+          'protocol' => protocol.to_s.delete('_'),
+          'type' => type.to_s,
+          'url' => target.to_s,
+          'override' => override
+        }.to_json
+
+        GandiV5.post url(domain), body
+        fetch domain, host
+      end
+
+      # Get web redirect for a host in a domain.
+      # @see https://api.gandi.net/docs/domains/#get-v5-domain-domains-domain-webredirs-host
+      # @param domain [String, #to_s] the domain to get the web redirection for.
+      # @param host [String, #to_s] the host name to get the web redirection for.
+      # @return [GandiV5::Domain::WebRedirect]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def self.fetch(domain, host)
+        _response, data = GandiV5.get url(domain, host)
+        redirect = from_gandi data
+        redirect.instance_exec { @domain = domain }
+        redirect
+      end
+
+      # List web redirects for a domain.
+      # @see https://api.gandi.net/docs/domains/#get-v5-domain-domains-domain-webredirs-host
+      # @param domain [String, #to_s] the domain to get the web redirections for.
+      # @param page [#each<Integer, #to_s>] the page(s) of results to retrieve.
+      #   If page is not provided keep querying until an empty list is returned.
+      #   If page responds to .each then iterate until an empty list is returned.
+      # @param per_page [Integer, #to_s] (optional default 100) how many results to get per page.
+      # @return [Array<GandiV5::Domain::WebRedirect>]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def self.list(domain, page: (1..), per_page: 100)
+        redirects = []
+        GandiV5.paginated_get(url(domain), page, per_page) do |data|
+          redirects += data.map { |redirect| from_gandi redirect }
+        end
+        redirects.each { |redirect| redirect.instance_exec { @domain = domain } }
+        redirects
+      end
+
+      private
+
+      def url
+        "#{BASE}domain/domains/#{CGI.escape @domain}/webredirs/#{fqdn}"
+      end
+
+      def self.url(domain, host = nil)
+        "#{BASE}domain/domains/#{CGI.escape domain}/webredirs" +
+          (host ? "/#{CGI.escape host}.#{CGI.escape domain}" : '')
+      end
+      private_class_method :url
+    end
+  end
+end

data/lib/gandi_v5/email.rb

@@ -2,6 +2,9 @@
 
 class GandiV5
   # Gandi Email Mailbox Management API.
+  # @see https://api.gandi.net/docs/email/
+  # rubocop:disable Lint/EmptyClass
   class Email
   end
+  # rubocop:enable Lint/EmptyClass
 end

data/lib/gandi_v5/email/forward.rb

@@ -76,18 +76,12 @@ class GandiV5
       #   e.g. ("alice" "*lice", "alic*").
       # @return [Array<GandiV5::Email::Forward>]
       # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def self.list(fqdn, page: (1..), **params)
-        page = [page.to_i] unless page.respond_to?(:each)
-
-        params.reject! { |_k, v| v.nil? }
+      def self.list(fqdn, page: (1..), per_page: 100, **params)
+        params.compact! { |_k, v| v.nil? }
 
         mailboxes = []
-        page.each do |page_number|
-          _response, data = GandiV5.get url(fqdn), params: params.merge(page: page_number)
-          break if data.empty?
-
+        GandiV5.paginated_get(url(fqdn), page, per_page, params: params) do |data|
           mailboxes += data.map { |mailbox| from_gandi mailbox.merge(fqdn: fqdn) }
-          break if data.count < params.fetch(:per_page, 100)
         end
         mailboxes
       end

data/lib/gandi_v5/email/mailbox.rb

@@ -43,7 +43,7 @@ class GandiV5
       alias mailbox_uuid uuid
 
       # Create a new GandiV5::Email::Mailbox
-      # @param members [Hash<Symbol => Object>]
+      # @param members [Hash{Symbol => Object}]
       # @return [GandiV5::Email::Slot]
       def initialize(**members)
         super(**members)
@@ -197,19 +197,13 @@ class GandiV5
       #   e.g. ("alice" "*lice", "alic*").
       # @return [Array<GandiV5::Email::Mailbox>]
       # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def self.list(fqdn, page: (1..), **params)
-        page = [page.to_i] unless page.respond_to?(:each)
-
+      def self.list(fqdn, page: (1..), per_page: 100, **params)
         params['~login'] = params.delete(:login)
-        params.reject! { |_k, v| v.nil? }
+        params.compact! { |_k, v| v.nil? }
 
         mailboxes = []
-        page.each do |page_number|
-          _response, data = GandiV5.get url(fqdn), params: params.merge(page: page_number)
-          break if data.empty?
-
+        GandiV5.paginated_get(url(fqdn), page, per_page, params: params) do |data|
           mailboxes += data.map { |mailbox| from_gandi mailbox }
-          break if data.count < params.fetch(:per_page, 100)
         end
         mailboxes
       end
@@ -271,7 +265,7 @@ class GandiV5
       def self.crypt_password(password)
         # You can also send a hashed password in sha512-crypt ie: {SHA512-CRYPT}$6$xxxx$yyyy
         salt = SecureRandom.random_number(36**8).to_s(36)
-        password.crypt('$6$' + salt)
+        password.crypt("$6$#{salt}")
       end
       private_class_method :crypt_password
 

data/lib/gandi_v5/error/gandi_error.rb

@@ -5,6 +5,7 @@ class GandiV5
     # Generic error class for errors returned by Gandi.
     class GandiError < GandiV5::Error
       # Generate a new GandiV5::Error::GandiError from the hash returned by Gandi.
+      # @api private
       # @param hash [Hash] the hash returned by Gandi.
       # @return [GandiV5::Error::GandiError]
       def self.from_hash(hash)

data/lib/gandi_v5/live_dns.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 # Namespace for classes which access LiveDNS details.
+# @see https://api.gandi.net/docs/livedns/
 class GandiV5
   # Gandi LiveDNS Management API.
   class LiveDNS
-    BASE = 'https://dns.api.gandi.net/api/v5/'
-
+    # Permitted record types.
     RECORD_TYPES = %w[
       A AAAA CNAME MX NS TXT ALIAS
       WKS SRV LOC SPF CAA DS SSHFP PTR KEY DNAME TLSA OPENPGPKEY CDS
@@ -21,16 +21,6 @@ class GandiV5
       GandiV5::LiveDNS::Domain.list
     end
 
-    # @see GandiV5::LiveDNS::Zone.fetch
-    def self.zone(uuid)
-      GandiV5::LiveDNS::Zone.fetch(uuid)
-    end
-
-    # @see GandiV5::LiveDNS::Zone.list
-    def self.zones
-      GandiV5::LiveDNS::Zone.list
-    end
-
     # Raise an error if passed type is invalid.
     # @param type [String] the record type to check.
     # @return [nil]

data/lib/gandi_v5/live_dns/domain.rb

@@ -5,19 +5,12 @@ class GandiV5
     # A domain name within the LiveDNS system.
     # @!attribute [r] fqdn
     #   @return [String]
-    # @!attribute [r] zone_uuid
-    #   @return [String]
+    # @!attribute [r] automatic_snapshots
+    #   @return [Boolean]
     class Domain
       include GandiV5::Data
-      include GandiV5::LiveDNS::HasZoneRecords
-
-      members :fqdn
 
-      member(
-        :zone_uuid,
-        gandi_key: 'zone',
-        converter: GandiV5::Data::Converter.new(from_gandi: ->(zone) { zone&.split('/')&.last })
-      )
+      members :fqdn, :automatic_snapshots
 
       # Refetch the information for this domain from Gandi.
       # @return [GandiV5::LiveDNS::Domain]
@@ -27,38 +20,310 @@ class GandiV5
         from_gandi data
       end
 
-      # Change the zone used by this domain.
-      # @param uuid [String, #uuid, #to_s] the UUID of the zone this domain should now use.
+      # Update this domain's settings.
+      # @see https://api.gandi.net/docs/livedns/#patch-v5-livedns-domains-fqdn
+      # @param automatic_snapshots [String, #to_s]
+      #   Enable or disable the automatic creation of new snapshots when records are changed.
       # @return [String] The confirmation message from Gandi.
       # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def change_zone(uuid)
-        uuid = uuid.uuid if uuid.respond_to?(:uuid)
-        _response, data = GandiV5.patch url, { zone_uuid: uuid }.to_json
-        self.zone_uuid = uuid
+      def update(automatic_snapshots:)
+        _response, data = GandiV5.patch url, { automatic_snapshots: automatic_snapshots }.to_json
+        self.automatic_snapshots = automatic_snapshots
         data['message']
       end
 
-      # @see GandiV5::LiveDNS::Zone.fetch
-      def fetch_zone
-        GandiV5::LiveDNS::Zone.fetch zone_uuid
+      # @overload fetch_records()
+      #   Fetch all records for this domain.
+      #   @see https://api.gandi.net/docs/livedns/#get-v5-livedns-domains-fqdn-records
+      #   @param page [Integer, #each<Integer>] which page(s) of results to get.
+      #     If page is not provided keep querying until an empty list is returned.
+      #     If page responds to .each then iterate until an empty list is returned.
+      #   @param per_page [Integer, #to_s] (optional default 100) how many results ot get per page.
+      # @overload fetch_records(name)
+      #   Fetch records for a name.
+      #   @see https://api.gandi.net/docs/livedns/#get-v5-livedns-domains-fqdn-records-rrset_name
+      #   @param name [String] the name to fetch records for.
+      #   @param page [Integer, #each<Integer>] which page(s) of results to get.
+      #     If page is not provided keep querying until an empty list is returned.
+      #     If page responds to .each then iterate until an empty list is returned.
+      #   @param per_page [Integer, #to_s] (optional default 100) how many results ot get per page.
+      # @overload fetch_records(name, type)
+      #   Fetch records of a type for a name.
+      #   @see https://api.gandi.net/docs/livedns/#get-v5-livedns-domains-fqdn-records-rrset_name-rrset_type
+      #   @param name [String] the name to fetch records for.
+      #   @param type [String] the record type to fetch.
+      #   @param page [Integer, #each<Integer>] which page(s) of results to get.
+      #     If page is not provided keep querying until an empty list is returned.
+      #     If page responds to .each then iterate until an empty list is returned.
+      #   @param per_page [Integer, #to_s] (optional default 100) how many results ot get per page.
+      # @return [Array<GandiV5::LiveDNS::Domain::Record>]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def fetch_records(name = nil, type = nil, page: (1..), per_page: 100)
+        GandiV5::LiveDNS.require_valid_record_type type if type
+
+        url_ = "#{url}/records"
+        url_ += "/#{CGI.escape name}" if name
+        url_ += "/#{CGI.escape type}" if type
+
+        all = []
+        GandiV5.paginated_get(url_, page, per_page) do |data|
+          all += [*data].map { |item| GandiV5::LiveDNS::Domain::Record.from_gandi item }
+        end
+        all
       end
 
-      # The domain's zone (fetching from Gandi if required).
-      # @return [GandiV5::LiveDNS::Zone]
+      # @overload fetch_zone_lines()
+      #   Fetch all records for this domain.
+      #   @see https://api.gandi.net/docs/livedns/#get-v5-livedns-domains-fqdn-records
+      # @overload fetch_zone_lines(name)
+      #   Fetch records for a name.
+      #   @see https://api.gandi.net/docs/livedns/#get-v5-livedns-domains-fqdn-records-rrset_name
+      #   @param name [String] the name to fetch records for.
+      # @overload fetch_zone_lines(name, type)
+      #   Fetch records of a type for a name.
+      #   @see https://api.gandi.net/docs/livedns/#get-v5-livedns-domains-fqdn-records-rrset_name-rrset_type
+      #   @param name [String] the name to fetch records for.
+      #   @param type [String] the record type to fetch.
+      # @return [String]
       # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def zone
-        @zone ||= fetch_zone
+      def fetch_zone_lines(name = nil, type = nil)
+        GandiV5::LiveDNS.require_valid_record_type type if type
+
+        url_ = "#{url}/records"
+        url_ += "/#{CGI.escape name}" if name
+        url_ += "/#{CGI.escape type}" if type
+
+        GandiV5.get(url_, accept: 'text/plain').last
+      end
+
+      # Add record to this domain.
+      # @see https://api.gandi.net/docs/livedns/#post-v5-livedns-domains-fqdn-records
+      # @param name [String]
+      # @param type [String]
+      # @param ttl [Integer]
+      # @param values [Array<String>]
+      # @return [String] The confirmation message from Gandi.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def add_record(name, type, ttl, *values)
+        GandiV5::LiveDNS.require_valid_record_type type
+        fail ArgumentError, 'ttl must be positive and non-zero' unless ttl.positive?
+        fail ArgumentError, 'there must be at least one value' if values.none?
+
+        body = {
+          rrset_name: name,
+          rrset_type: type,
+          rrset_ttl: ttl,
+          rrset_values: values
+        }.to_json
+        _response, data = GandiV5.post "#{url}/records", body
+        data['message']
+      end
+
+      # @overload delete_records()
+      #   Delete all records for this domain.
+      #   @see https://api.gandi.net/docs/livedns/#delete-v5-livedns-domains-fqdn-records
+      # @overload delete_records(name)
+      #   Delete records for a name.
+      #   @see https://api.gandi.net/docs/livedns/#delete-v5-livedns-domains-fqdn-records-rrset_name
+      #   @param name [String] the name to delete records for.
+      # @overload delete_records(name, type)
+      #   Delete records of a type for a name.
+      #   @see https://api.gandi.net/docs/livedns/#delete-v5-livedns-domains-fqdn-records-rrset_name-rrset_type
+      #   @param name [String] the name to delete records for.
+      #   @param type [String] the record type to delete.
+      # @return [nil]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def delete_records(name = nil, type = nil)
+        GandiV5::LiveDNS.require_valid_record_type(type) if type
+
+        url_ = "#{url}/records"
+        url_ += "/#{CGI.escape name}" if name
+        url_ += "/#{CGI.escape type}" if type
+        GandiV5.delete(url_).last
+      end
+
+      # Replace records for the domain.
+      #   @param name [String, nil] only replaces records for this name.
+      #   @param type [String, nil] only replaces record of this type (requires name).
+      #   @param values [Array<String>] the values to set for the record.
+      #   @raise [ArgumentError] if ttl is present and type is absent.
+      # @see https://api.gandi.net/docs/livedns/#put-v5-livedns-domains-fqdn-records
+      # @see https://api.gandi.net/docs/livedns/#put-v5-livedns-domains-fqdn-records-rrset_name
+      # @see https://api.gandi.net/docs/livedns/#put-v5-livedns-domains-fqdn-records-rrset_name-rrset_type
+      # @return [String] The confirmation message from Gandi.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      # rubocop:disable Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
+      def replace_records(records, name: nil, type: nil)
+        if type
+          GandiV5::LiveDNS.require_valid_record_type(type) if type
+          fail ArgumentError, 'missing keyword: name' if name.nil?
+        end
+
+        url_ = "#{url}/records"
+        url_ += "/#{CGI.escape name}" if name
+        url_ += "/#{CGI.escape type}" if type
+
+        body = if type && name
+                 { rrset_values: records }
+               else
+                 { items: records.map { |r| r.transform_keys { |k| "rrset_#{k}" } } }
+               end
+
+        _response, data = GandiV5.put url_, body.to_json
+        data['message']
+      end
+      # rubocop:enable Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
+
+      # Replace all records for this domain.
+      # @see https://api.gandi.net/docs/livedns/#put-v5-livedns-domains-fqdn-records
+      # @param text [String] zone file lines to replace the records with.
+      # @return [String] The confirmation message from Gandi.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def replace_zone_lines(text)
+        _response, data = GandiV5.put "#{url}/records", text, 'content-type': 'text/plain'
+        data['message']
+      end
+
+      # The list of nameservers that this domain is using according to LiveDNS' systems.
+      #  * Either there are no NS records on @ and the 3 hashed nameservers are returned
+      #    (ns-{123}-{abc}.gandi.net)
+      #  * Or some NS records exist on @ and it will return those
+      # @see https://api.gandi.net/docs/domains#get-v5-domain-domains-domain-name$
+      # @return [Array<String>]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def name_servers
+        @name_servers ||= fetch_name_servers
+      end
+
+      # Requery Gandi for the domain's name servers.
+      # @see https://api.gandi.net/docs/domains#get-v5-domain-domains-domain-name$
+      # @return [Array<String>]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def fetch_name_servers
+        _response, data = GandiV5.get "#{url}/nameservers"
+        @name_servers = data
+      end
+
+      # The list of DNSSEC keys for the domain.
+      # If you need the fingerprint, public_key or tag attributes you'll need
+      # use GandiV5::LiveDNS::Domain::DnssecKey.fetch on each item.
+      # @return [Array<GandiV5::LiveDNS::Domain::DnssecKey>]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def dnssec_keys
+        @dnssec_keys ||= fetch_dnssec_keys
+      end
+
+      # Requery Gandi for the domain's DNSSEC keys.
+      # @see https://api.gandi.net/docs/livedns/#get-v5-livedns-domains-fqdn-keys
+      # @return [Array<GandiV5::LiveDNS::Domain::DnssecKey>]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def fetch_dnssec_keys
+        @dnssec_keys = GandiV5::LiveDNS::Domain::DnssecKey.list(fqdn)
+      end
+
+      # The list of TSIG keys for the domain.
+      # If you need the secret, fingerprint, public_key or tag attributes you'll need
+      # to use GandiV5::LiveDNS::Domain::DnssecKey.fetch on each item.
+      # @return [Array<GandiV5::LiveDNS::Domain::TsigKey>]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def tsig_keys
+        @tsig_keys ||= fetch_tsig_keys
+      end
+
+      # Requery Gandi for the domain's TSIG keys.
+      # @see https://api.gandi.net/docs/livedns/#get-v5-livedns-domains-fqdn-axfr-tsig
+      # @return [Array<GandiV5::LiveDNS::Domain::TsigKey>]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def fetch_tsig_keys
+        _response, data = GandiV5.get "#{url}/axfr/tsig"
+        data.map { |item| GandiV5::LiveDNS::Domain::TsigKey.from_gandi item }
+      end
+
+      # Add a Tsig key to this domain.
+      # @see https://api.gandi.net/docs/livedns/#put-v5-livedns-domains-fqdn-axfr-tsig-id
+      # @param key [GandiV5::LiveDNS::Domain::TsigKey, #uuid, String, #to_s]
+      #   the key to add.
+      # @param sharing_id [nil, String, #to_s]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def add_tsig_key(key, sharing_id: nil)
+        key = key.uuid if key.respond_to?(:uuid)
+        url_ = "#{url}/axfr/tsig/#{key}"
+        url_ += "?sharing_id=#{CGI.escape sharing_id}" if sharing_id
+        _response, _data = GandiV5.put url_
+      end
+
+      # Remove a Tsig key from this domain.
+      # @see https://api.gandi.net/docs/livedns/#delete-v5-livedns-domains-fqdn-axfr-tsig-id
+      # @param key [GandiV5::LiveDNS::Domain::TsigKey, #uuid, String, #to_s]
+      #   the key to remove.
+      # @param sharing_id [nil, String, #to_s]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def remove_tsig_key(key, sharing_id: nil)
+        key = key.uuid if key.respond_to?(:uuid)
+        url_ = "#{url}/axfr/tsig/#{key}"
+        url_ += "?sharing_id=#{CGI.escape sharing_id}" if sharing_id
+        _response, _data = GandiV5.delete url_
+      end
+
+      # The list of AXFR clients for the domain.
+      # @return [Array<String>] list of IP addresses.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def axfr_clients
+        @axfr_clients ||= fetch_axfr_clients
+      end
+
+      # Requery Gandi for the domain's AXFR clients.
+      # @see https://api.gandi.net/docs/livedns/#get-v5-livedns-domains-fqdn-axfr-slaves
+      # @return [Array<String>] list of IP addresses.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def fetch_axfr_clients
+        _response, data = GandiV5.get "#{url}/axfr/slaves"
+        data
+      end
+
+      # Add an AXFR client to this domain.
+      # @see https://api.gandi.net/docs/livedns/#put-v5-livedns-domains-fqdn-axfr-slaves-ip
+      # @param ip [String, #to_s] the IP address to add.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def add_axfr_client(ip)
+        _response, _data = GandiV5.put "#{url}/axfr/slaves/#{ip}"
+      end
+
+      # Remove and AXFR client from this domain.
+      # @see https://api.gandi.net/docs/livedns/#delete-v5-livedns-domains-fqdn-axfr-slaves-ip
+      # @param ip [String, #to_s] the IP address to remove.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def remove_axfr_client(ip)
+        _response, _data = GandiV5.delete "#{url}/axfr/slaves/#{ip}"
       end
 
       # List the domains.
-      # @return [Array<GandiV5::LiveDNS::Domain>]
+      # @see https://api.gandi.net/docs/livedns/#get-v5-livedns-domains
+      # @param page [#each<Integer, #to_s>] the page(s) of results to retrieve.
+      #   If page is not provided keep querying until an empty list is returned.
+      #   If page responds to .each then iterate until an empty list is returned.
+      # @param per_page [Integer, #to_s] (optional default 100) how many results to get per page.
+      # @param sharing_id [String, #to_s] (optional) filter by domains assigned to a given user.
+      # @return [Array<String>]
       # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def self.list
-        _response, data = GandiV5.get url
-        data.map { |item| from_gandi item }
+      def self.list(page: (1..), per_page: 100, sharing_id: nil)
+        page = [page.to_i] unless page.respond_to?(:each)
+        params = { per_page: per_page }
+        params[:sharing_id] = sharing_id unless sharing_id.nil?
+
+        domains = []
+        page.each do |page_number|
+          _resp, data = GandiV5.get url, params: params.merge(page: page_number)
+          break if data.empty?
+
+          domains += data.map { |item| item['fqdn'] }
+          break if data.count < per_page
+        end
+        domains
       end
 
       # Get a domain.
+      # @see https://api.gandi.net/docs/livedns/#get-v5-livedns-domains-fqdn
       # @param fqdn [String, #to_s] the fully qualified domain name to fetch.
       # @return [GandiV5::LiveDNS::Domain]
       # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
@@ -67,14 +332,60 @@ class GandiV5
         from_gandi data
       end
 
+      # Create a new domain in the LiveDNS system.
+      # You must have sufficent permission to manage the domain to do this.
+      # @see https://api.gandi.net/docs/livedns/#post-v5-livedns-domains
+      # @param fqdn [String, #to_s] the fully qualified domain to add to LiveDNS.
+      # @param records [Array<Hash, GandiV5::LiveDNS::Domain::Record, #to_h, nil>]
+      # @param ttl [Integer, #to_s, nil] the TTL of the SOA record.
+      #   Note that this is not a default TTL that will be used for the records in the zone.
+      #   the records (if any) to add to the created zone.
+      # @param sharing_id [nil, String, #to_s]
+      # @return [GandiV5::LiveDNS::Domain]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def self.create(fqdn, records = nil, soa_ttl: nil, sharing_id: nil)
+        body = { fqdn: fqdn, zone: {} }
+        body[:zone][:ttl] = soa_ttl if soa_ttl
+        if records
+          body[:zone][:items] = records.map do |r|
+            r.to_h.transform_keys { |k| "rrset_#{k}" }
+          end
+        end
+
+        url_ = url
+        url_ += "?sharing_id=#{CGI.escape sharing_id}" if sharing_id
+
+        GandiV5.post url_, body.to_json
+        fetch(fqdn)
+      end
+
+      # Fetch the list of known record types (A, CNAME, etc.)
+      # @see https://api.gandi.net/docs/livedns/#get-v5-livedns-dns-rrtypes
+      # @return [Array<String>]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def self.record_types
+        GandiV5.get("#{BASE}livedns/dns/rrtypes").last
+      end
+
+      # Get the LiveDNS servers to use for a domain.
+      # @note Does not take into account any NS records that exist in the zone.
+      # @see https://api.gandi.net/docs/livedns/#get-v5-livedns-nameservers-fqdn
+      # @param fqdn [String, #to_s] the fully qualified domain to hash in
+      #   in order to get the LiveDNS servers to use.
+      # @return [Array<String>]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def self.generic_name_servers(fqdn)
+        GandiV5.get("#{BASE}livedns/nameservers/#{CGI.escape fqdn}").last
+      end
+
       private
 
       def url
-        "#{BASE}domains/#{CGI.escape(fqdn)}"
+        "#{BASE}livedns/domains/#{CGI.escape fqdn}"
       end
 
       def self.url(fqdn = nil)
-        "#{BASE}domains" + (fqdn ? "/#{CGI.escape(fqdn)}" : '')
+        "#{BASE}livedns/domains" + (fqdn ? "/#{CGI.escape fqdn}" : '')
       end
       private_class_method :url
     end