chore: custom deserialisation

src/main/java/com/twilio/converter/ISO8601Deserializer.java

@@ -0,0 +1,17 @@
+package com.twilio.converter;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+
+import java.io.IOException;
+import java.time.ZonedDateTime;
+
+// open-api spec "format: date-time"
+public class ISO8601Deserializer extends JsonDeserializer<ZonedDateTime> {
+    @Override
+    public ZonedDateTime deserialize(JsonParser parser, DeserializationContext context) throws IOException {
+        String dateString = parser.getText();
+        return DateConverter.iso8601DateTimeFromString(dateString);
+    }
+}

src/main/java/com/twilio/converter/LocalDateDeserializer.java

@@ -0,0 +1,17 @@
+package com.twilio.converter;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+
+import java.io.IOException;
+import java.time.LocalDate;
+
+// open-api spec "format: date"
+public class LocalDateDeserializer extends JsonDeserializer<LocalDate> {
+    @Override
+    public LocalDate deserialize(JsonParser parser, DeserializationContext context) throws IOException {
+        String dateString = parser.getText();
+        return DateConverter.localDateFromString(dateString);
+    }
+}

src/main/java/com/twilio/converter/RFC2822Deserializer.java

@@ -0,0 +1,17 @@
+package com.twilio.converter;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+
+import java.io.IOException;
+import java.time.ZonedDateTime;
+
+// open-api spec "format: date-time-rfc-2822"
+public class RFC2822Deserializer extends JsonDeserializer<ZonedDateTime> {
+    @Override
+    public ZonedDateTime deserialize(JsonParser parser, DeserializationContext context) throws IOException {
+        String dateString = parser.getText();
+        return DateConverter.rfc2822DateTimeFromString(dateString);
+    }
+}

src/main/java/com/twilio/converter/ZonedDateTimeListDeserializer.java

@@ -0,0 +1,28 @@
+package com.twilio.converter;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.type.TypeReference;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+
+import java.io.IOException;
+import java.time.ZonedDateTime;
+import java.util.ArrayList;
+import java.util.List;
+
+public class ZonedDateTimeListDeserializer extends JsonDeserializer<List<ZonedDateTime>> {
+
+    @Override
+    public List<ZonedDateTime> deserialize(JsonParser parser, DeserializationContext context) throws IOException {
+        List<String> dateStrings = parser.readValueAs(new TypeReference<List<String>>() {
+        });
+        List<ZonedDateTime> dates = new ArrayList<>();
+        for (String dateString : dateStrings) {
+            ZonedDateTime date = DateConverter.rfc2822DateTimeFromString(dateString);
+            if (date != null) {
+                dates.add(date);
+            }
+        }
+        return dates;
+    }
+}

src/test/java/com/twilio/converter/ISO8601DeserializerTest.java

@@ -0,0 +1,65 @@
+package com.twilio.converter;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import org.junit.Assert;
+import org.junit.Test;
+import org.mockito.Mockito;
+
+import java.io.IOException;
+import java.time.ZonedDateTime;
+
+public class ISO8601DeserializerTest {
+
+    @Test
+    public void testDeserializeValidDateTime() throws IOException {
+        // Arrange
+        String validDateTime = "2023-10-01T12:34:56Z";
+        ZonedDateTime expectedDateTime = ZonedDateTime.parse(validDateTime);
+
+        JsonParser mockParser = Mockito.mock(JsonParser.class);
+        DeserializationContext mockContext = Mockito.mock(DeserializationContext.class);
+
+        Mockito.when(mockParser.getText()).thenReturn(validDateTime);
+
+        ISO8601Deserializer deserializer = new ISO8601Deserializer();
+
+        // Act
+        ZonedDateTime result = deserializer.deserialize(mockParser, mockContext);
+
+        // Assert
+        Assert.assertEquals(expectedDateTime, result);
+    }
+
+    @Test
+    public void testDeserializeInvalidDateTime() throws IOException {
+        // Arrange
+        String invalidDateTime = "invalid-date-time";
+        JsonParser mockParser = Mockito.mock(JsonParser.class);
+        DeserializationContext mockContext = Mockito.mock(DeserializationContext.class);
+        Mockito.when(mockParser.getText()).thenReturn(invalidDateTime);
+        ISO8601Deserializer deserializer = new ISO8601Deserializer();
+
+        // Act
+        ZonedDateTime result = deserializer.deserialize(mockParser, mockContext);
+
+        // Assert
+        Assert.assertNull(result);
+    }
+
+    @Test
+    public void testDeserializeNullDateTime() throws IOException {
+        // Arrange
+        String invalidDateTime = null;
+        JsonParser mockParser = Mockito.mock(JsonParser.class);
+        DeserializationContext mockContext = Mockito.mock(DeserializationContext.class);
+        Mockito.when(mockParser.getText()).thenReturn(invalidDateTime);
+        ISO8601Deserializer deserializer = new ISO8601Deserializer();
+
+        // Act
+        ZonedDateTime result = deserializer.deserialize(mockParser, mockContext);
+
+        // Assert
+        Assert.assertNull(result);
+    }
+}

src/test/java/com/twilio/converter/LocalDateDeserializerTest.java

@@ -0,0 +1,71 @@
+package com.twilio.converter;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import org.junit.Assert;
+import org.junit.Test;
+import org.mockito.Mockito;
+
+import java.io.IOException;
+import java.time.LocalDate;
+
+public class LocalDateDeserializerTest {
+
+    @Test
+    public void testDeserializeValidDate() throws IOException {
+        // Arrange
+        String validDate = "2023-10-01";
+        LocalDate expectedDate = LocalDate.parse(validDate);
+
+        JsonParser mockParser = Mockito.mock(JsonParser.class);
+        DeserializationContext mockContext = Mockito.mock(DeserializationContext.class);
+
+        Mockito.when(mockParser.getText()).thenReturn(validDate);
+
+        LocalDateDeserializer deserializer = new LocalDateDeserializer();
+
+        // Act
+        LocalDate result = deserializer.deserialize(mockParser, mockContext);
+
+        // Assert
+        Assert.assertEquals(expectedDate, result);
+    }
+
+    @Test
+    public void testDeserializeInvalidDate() throws IOException {
+        // Arrange
+        String invalidDate = "invalid-date";
+
+        JsonParser mockParser = Mockito.mock(JsonParser.class);
+        DeserializationContext mockContext = Mockito.mock(DeserializationContext.class);
+
+        Mockito.when(mockParser.getText()).thenReturn(invalidDate);
+
+        LocalDateDeserializer deserializer = new LocalDateDeserializer();
+
+        // Act
+        LocalDate result = deserializer.deserialize(mockParser, mockContext);
+
+        // Assert
+        Assert.assertNull(result);
+    }
+
+    @Test
+    public void testDeserializeEmptyDate() throws IOException {
+        // Arrange
+        String emptyDate = "";
+
+        JsonParser mockParser = Mockito.mock(JsonParser.class);
+        DeserializationContext mockContext = Mockito.mock(DeserializationContext.class);
+
+        Mockito.when(mockParser.getText()).thenReturn(emptyDate);
+
+        LocalDateDeserializer deserializer = new LocalDateDeserializer();
+
+        // Act
+        LocalDate result = deserializer.deserialize(mockParser, mockContext);
+
+        // Assert
+        Assert.assertNull(result);
+    }
+}

src/test/java/com/twilio/converter/RFC2822DeserializerTest.java

@@ -0,0 +1,71 @@
+package com.twilio.converter;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import org.junit.Assert;
+import org.junit.Test;
+import org.mockito.Mockito;
+
+import java.io.IOException;
+import java.time.ZonedDateTime;
+
+public class RFC2822DeserializerTest {
+
+    @Test
+    public void testDeserializeValidDateTime() throws IOException {
+        // Arrange
+        String validDateTime = "Wed, 23 Jul 2025 06:18:51 +0000";
+        ZonedDateTime expectedDateTime = DateConverter.rfc2822DateTimeFromString(validDateTime);
+
+        JsonParser mockParser = Mockito.mock(JsonParser.class);
+        DeserializationContext mockContext = Mockito.mock(DeserializationContext.class);
+
+        Mockito.when(mockParser.getText()).thenReturn(validDateTime);
+
+        RFC2822Deserializer deserializer = new RFC2822Deserializer();
+
+        // Act
+        ZonedDateTime result = deserializer.deserialize(mockParser, mockContext);
+
+        // Assert
+        Assert.assertEquals(expectedDateTime, result);
+    }
+
+    @Test
+    public void testDeserializeInvalidDateTime() throws IOException {
+        // Arrange
+        String invalidDateTime = "invalid-date-time";
+
+        JsonParser mockParser = Mockito.mock(JsonParser.class);
+        DeserializationContext mockContext = Mockito.mock(DeserializationContext.class);
+
+        Mockito.when(mockParser.getText()).thenReturn(invalidDateTime);
+
+        RFC2822Deserializer deserializer = new RFC2822Deserializer();
+
+        // Act
+        ZonedDateTime result = deserializer.deserialize(mockParser, mockContext);
+
+        // Assert
+        Assert.assertNull(result);
+    }
+
+    @Test
+    public void testDeserializeEmptyDateTime() throws IOException {
+        // Arrange
+        String emptyDateTime = "";
+
+        JsonParser mockParser = Mockito.mock(JsonParser.class);
+        DeserializationContext mockContext = Mockito.mock(DeserializationContext.class);
+
+        Mockito.when(mockParser.getText()).thenReturn(emptyDateTime);
+
+        RFC2822Deserializer deserializer = new RFC2822Deserializer();
+
+        // Act
+        ZonedDateTime result = deserializer.deserialize(mockParser, mockContext);
+
+        // Assert
+        Assert.assertNull(result);
+    }
+}

src/test/java/com/twilio/converter/ZonedDateTimeListDeserializerTest.java

@@ -0,0 +1,90 @@
+package com.twilio.converter;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.type.TypeReference;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import org.junit.Assert;
+import org.junit.Test;
+import org.mockito.Mockito;
+
+import java.io.IOException;
+import java.time.ZonedDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+public class ZonedDateTimeListDeserializerTest {
+
+    @Test
+    public void testDeserializeValidDateTimeList() throws IOException {
+        // Arrange
+        List<String> validDateTimes = Arrays.asList(
+                "Tue, 03 Oct 2023 14:28:00 +0000",
+                "Wed, 04 Oct 2023 10:15:30 +0000"
+        );
+        List<ZonedDateTime> expectedDates = Arrays.asList(
+                DateConverter.rfc2822DateTimeFromString(validDateTimes.get(0)),
+                DateConverter.rfc2822DateTimeFromString(validDateTimes.get(1))
+        );
+
+        JsonParser mockParser = Mockito.mock(JsonParser.class);
+        DeserializationContext mockContext = Mockito.mock(DeserializationContext.class);
+
+        Mockito.when(mockParser.readValueAs(Mockito.<TypeReference<List<String>>>any()))
+                .thenReturn(validDateTimes);
+
+        ZonedDateTimeListDeserializer deserializer = new ZonedDateTimeListDeserializer();
+
+        // Act
+        List<ZonedDateTime> result = deserializer.deserialize(mockParser, mockContext);
+
+        // Assert
+        Assert.assertEquals(expectedDates, result);
+    }
+
+    @Test
+    public void testDeserializeInvalidDateTimeList() throws IOException {
+        // Arrange
+        List<String> mixedDateTimes = Arrays.asList(
+                "Tue, 03 Oct 2023 14:28:00 +0000",
+                "invalid-date-time"
+        );
+        List<ZonedDateTime> expectedDates = Collections.singletonList(
+                DateConverter.rfc2822DateTimeFromString(mixedDateTimes.get(0))
+        );
+
+        JsonParser mockParser = Mockito.mock(JsonParser.class);
+        DeserializationContext mockContext = Mockito.mock(DeserializationContext.class);
+
+        Mockito.when(mockParser.readValueAs(Mockito.<TypeReference<List<String>>>any()))
+                .thenReturn(mixedDateTimes);
+
+        ZonedDateTimeListDeserializer deserializer = new ZonedDateTimeListDeserializer();
+
+        // Act
+        List<ZonedDateTime> result = deserializer.deserialize(mockParser, mockContext);
+
+        // Assert
+        Assert.assertEquals(expectedDates, result);
+    }
+
+    @Test
+    public void testDeserializeEmptyDateTimeList() throws IOException {
+        // Arrange
+        List<String> emptyDateTimes = Collections.emptyList();
+
+        JsonParser mockParser = Mockito.mock(JsonParser.class);
+        DeserializationContext mockContext = Mockito.mock(DeserializationContext.class);
+
+        Mockito.when(mockParser.readValueAs(Mockito.<TypeReference<List<String>>>any()))
+                .thenReturn(emptyDateTimes);
+
+        ZonedDateTimeListDeserializer deserializer = new ZonedDateTimeListDeserializer();
+
+        // Act
+        List<ZonedDateTime> result = deserializer.deserialize(mockParser, mockContext);
+
+        // Assert
+        Assert.assertTrue(result.isEmpty());
+    }
+}