Add support for trustee transfers (#246)

Author: lokst

src/main/java/com/dnsimple/data/DomainTransfer.java

@@ -7,17 +7,19 @@ public class DomainTransfer {
     private final String state;
     private final boolean autoRenew;
     private final boolean whoisPrivacy;
+    private final boolean trusteeService;
     private final String statusDescription;
     private final String createdAt;
     private final String updatedAt;
 
-    public DomainTransfer(Integer id, Integer domainId, Integer registrantId, String state, boolean autoRenew, boolean whoisPrivacy, String statusDescription, String createdAt, String updatedAt) {
+    public DomainTransfer(Integer id, Integer domainId, Integer registrantId, String state, boolean autoRenew, boolean whoisPrivacy, boolean trusteeService, String statusDescription, String createdAt, String updatedAt) {
         this.id = id;
         this.domainId = domainId;
         this.registrantId = registrantId;
         this.state = state;
         this.autoRenew = autoRenew;
         this.whoisPrivacy = whoisPrivacy;
+        this.trusteeService = trusteeService;
         this.statusDescription = statusDescription;
         this.createdAt = createdAt;
         this.updatedAt = updatedAt;
@@ -47,6 +49,10 @@ public boolean hasWhoisPrivacy() {
         return whoisPrivacy;
     }
 
+    public boolean hasTrusteeService() {
+        return trusteeService;
+    }
+
     public String getStatusDescription() {
         return statusDescription;
     }

src/main/java/com/dnsimple/request/TransferOptions.java

@@ -12,42 +12,44 @@ public class TransferOptions {
     private final Boolean autoRenew;
     private final Map<String, String> extendedAttributes;
     private final String premiumPrice;
+    private final Boolean trusteeService;
 
-    private TransferOptions(Long registrantId, String authCode, Boolean whoisPrivacy, Boolean autoRenew, Map<String, String> extendedAttributes, String premiumPrice) {
+    private TransferOptions(Long registrantId, String authCode, Boolean whoisPrivacy, Boolean autoRenew, Map<String, String> extendedAttributes, String premiumPrice, Boolean trusteeService) {
         this.registrantId = registrantId;
         this.authCode = authCode;
         this.whoisPrivacy = whoisPrivacy;
         this.autoRenew = autoRenew;
         this.extendedAttributes = extendedAttributes;
         this.premiumPrice = premiumPrice;
+        this.trusteeService = trusteeService;
     }
 
     /**
      * @param registrantId The ID of an existing contact in your account.
      */
     public static TransferOptions of(Number registrantId) {
-        return new TransferOptions(registrantId.longValue(), null, false, true, emptyMap(), null);
+        return new TransferOptions(registrantId.longValue(), null, false, true, emptyMap(), null, null);
     }
 
     /**
      * Set the authCode required for TLDS that require authorization-based transfer (the vast majority of TLDs).
      */
     public TransferOptions authCode(String authCode) {
-        return new TransferOptions(registrantId, authCode, whoisPrivacy, autoRenew, extendedAttributes, premiumPrice);
+        return new TransferOptions(registrantId, authCode, whoisPrivacy, autoRenew, extendedAttributes, premiumPrice, trusteeService);
     }
 
     /**
      * Enable the whois privacy as part of the transfer. An extra cost may apply.
      */
     public TransferOptions whoisPrivacy() {
-        return new TransferOptions(registrantId, authCode, true, autoRenew, extendedAttributes, premiumPrice);
+        return new TransferOptions(registrantId, authCode, true, autoRenew, extendedAttributes, premiumPrice, trusteeService);
     }
 
     /**
      * Disable the auto-renewal of the domain.
      */
     public TransferOptions noAutoRenew() {
-        return new TransferOptions(registrantId, authCode, whoisPrivacy, false, extendedAttributes, premiumPrice);
+        return new TransferOptions(registrantId, authCode, whoisPrivacy, false, extendedAttributes, premiumPrice, trusteeService);
     }
 
     /**
@@ -57,13 +59,23 @@ public TransferOptions noAutoRenew() {
     public TransferOptions extendedAttribute(String name, String value) {
         Map<String, String> newExtendedAttributes = new HashMap<>(extendedAttributes);
         newExtendedAttributes.put(name, value);
-        return new TransferOptions(registrantId, authCode, whoisPrivacy, autoRenew, newExtendedAttributes, premiumPrice);
+        return new TransferOptions(registrantId, authCode, whoisPrivacy, autoRenew, newExtendedAttributes, premiumPrice, trusteeService);
     }
 
     /**
      * Required as confirmation of the price, only if the domain is premium.
      */
     public TransferOptions premiumPrice(String premiumPrice) {
-        return new TransferOptions(registrantId, authCode, whoisPrivacy, autoRenew, extendedAttributes, premiumPrice);
+        return new TransferOptions(registrantId, authCode, whoisPrivacy, autoRenew, extendedAttributes, premiumPrice, trusteeService);
+    }
+
+    /**
+     * Enable trustee service as part of the domain transfer.
+     *
+     * <p>This parameter is optional; if you never call this method, the SDK will omit
+     * {@code trustee_service} from the JSON request payload.</p>
+     */
+    public TransferOptions trusteeService() {
+        return new TransferOptions(registrantId, authCode, whoisPrivacy, autoRenew, extendedAttributes, premiumPrice, true);
     }
 }

src/test/java/com/dnsimple/endpoints/RegistrarTest.java

@@ -165,6 +165,7 @@ public void testGetDomainTransfer() {
         assertThat(transfer.getState(), is("cancelled"));
         assertThat(transfer.hasAutoRenew(), is(false));
         assertThat(transfer.hasWhoisPrivacy(), is(false));
+        assertThat(transfer.hasTrusteeService(), is(false));
         assertThat(transfer.getStatusDescription(), is("Canceled by customer"));
         assertThat(transfer.getCreatedAt(), is("2020-06-05T18:08:00Z"));
         assertThat(transfer.getUpdatedAt(), is("2020-06-05T18:10:01Z"));
@@ -183,6 +184,7 @@ public void testCancelDomainTransfer() {
         assertThat(transfer.getState(), is("transferring"));
         assertThat(transfer.hasAutoRenew(), is(false));
         assertThat(transfer.hasWhoisPrivacy(), is(false));
+        assertThat(transfer.hasTrusteeService(), is(false));
         assertThat(transfer.getStatusDescription(), isEmptyOrNullString());
         assertThat(transfer.getCreatedAt(), is("2020-06-05T18:08:00Z"));
         assertThat(transfer.getUpdatedAt(), is("2020-06-05T18:08:04Z"));