Add getExpiresAt(), getRegisteredAt(), getUpdatedAt(), and getExpiresInDays() to Dates

Author: boutetnico

src/main/java/io/rdapapi/client/responses/Dates.java

@@ -1,6 +1,8 @@
 package io.rdapapi.client.responses;
 
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import java.time.Instant;
+import java.time.temporal.ChronoUnit;
 
 @JsonIgnoreProperties(ignoreUnknown = true)
 public final class Dates {
@@ -28,4 +30,43 @@ public String getExpires() {
   public String getUpdated() {
     return updated;
   }
+
+  /** Parse the registered date into an Instant, or null if absent or unparseable. */
+  public Instant getRegisteredAt() {
+    return parseInstant(registered);
+  }
+
+  /** Parse the expiry date into an Instant, or null if absent or unparseable. */
+  public Instant getExpiresAt() {
+    return parseInstant(expires);
+  }
+
+  /** Parse the updated date into an Instant, or null if absent or unparseable. */
+  public Instant getUpdatedAt() {
+    return parseInstant(updated);
+  }
+
+  /**
+   * Days until expiration, or null if no expiry date is available.
+   *
+   * <p>Returns a negative number if the domain has already expired.
+   */
+  public Long getExpiresInDays() {
+    Instant exp = getExpiresAt();
+    if (exp == null) {
+      return null;
+    }
+    return ChronoUnit.DAYS.between(Instant.now(), exp);
+  }
+
+  private static Instant parseInstant(String value) {
+    if (value == null) {
+      return null;
+    }
+    try {
+      return Instant.parse(value);
+    } catch (Exception e) {
+      return null;
+    }
+  }
 }

src/test/java/io/rdapapi/client/ResponsesTest.java

@@ -117,6 +117,27 @@ void parseBulkDomainResponse() throws Exception {
     assertThat(failure.getData()).isNull();
   }
 
+  @Test
+  void datesConvenienceMethods() throws Exception {
+    DomainResponse r = RdapClient.MAPPER.readValue(Fixtures.domainResponse(), DomainResponse.class);
+    assertThat(r.getDates().getRegisteredAt()).isNotNull();
+    assertThat(r.getDates().getRegisteredAt().toString()).isEqualTo("1997-09-15T04:00:00Z");
+    assertThat(r.getDates().getExpiresAt()).isNotNull();
+    assertThat(r.getDates().getExpiresInDays()).isGreaterThan(0);
+    assertThat(r.getDates().getUpdatedAt()).isNull();
+  }
+
+  @Test
+  void datesNullFieldsReturnNull() throws Exception {
+    String json =
+        "{\"domain\":\"test.com\",\"registrar\":{},\"dates\":{},\"entities\":{},\"meta\":{"
+            + "\"rdap_server\":\"x\",\"raw_rdap_url\":\"x\",\"cached\":false,\"cache_expires\":\"x\"}}";
+    DomainResponse r = RdapClient.MAPPER.readValue(json, DomainResponse.class);
+    assertThat(r.getDates().getRegisteredAt()).isNull();
+    assertThat(r.getDates().getExpiresAt()).isNull();
+    assertThat(r.getDates().getExpiresInDays()).isNull();
+  }
+
   @Test
   void unknownFieldsIgnored() throws Exception {
     String json =