CUST-5203: add "maybe" to Event Status, and gracefully handle unknown status

Author: googsvg

src/main/kotlin/com/nylas/models/Event.kt

@@ -110,7 +110,7 @@ data class Event(
   @Json(name = "reminders")
   val reminders: Reminders? = null,
   /**
-   * Status of the event.
+   * Status of the event. Possible values: "confirmed", "tentative", "cancelled", "maybe".
    */
   @Json(name = "status")
   val status: EventStatus? = null,

src/main/kotlin/com/nylas/models/EventStatus.kt

@@ -9,6 +9,9 @@ enum class EventStatus {
   @Json(name = "confirmed")
   CONFIRMED,
 
+  @Json(name = "maybe")
+  MAYBE,
+
   @Json(name = "tentative")
   TENTATIVE,
 

src/main/kotlin/com/nylas/util/EventStatusJsonAdapter.kt

@@ -0,0 +1,23 @@
+package com.nylas.util
+
+import com.nylas.models.EventStatus
+import com.squareup.moshi.FromJson
+import com.squareup.moshi.JsonReader
+import com.squareup.moshi.JsonWriter
+import com.squareup.moshi.ToJson
+import com.squareup.moshi.adapters.EnumJsonAdapter
+
+/**
+ * Handles EventStatus values without failing deserialization when the API returns a new status.
+ */
+class EventStatusJsonAdapter {
+  private val delegate = EnumJsonAdapter.create(EventStatus::class.java).withUnknownFallback(null)
+
+  @FromJson
+  fun fromJson(reader: JsonReader): EventStatus? = delegate.fromJson(reader)
+
+  @ToJson
+  fun toJson(writer: JsonWriter, value: EventStatus?) {
+    delegate.toJson(writer, value)
+  }
+}

src/main/kotlin/com/nylas/util/JsonHelper.kt

@@ -36,6 +36,7 @@ class JsonHelper {
       .add(IMessageAdapter())
       .add(UpdateConnectorAdapter())
       .add(CredentialDataAdapter())
+      .add(EventStatusJsonAdapter())
       .add(CreateAttachmentRequestAdapter())
       .add(MicrosoftAdminConsentCredentialDataAdapter())
       .add(GoogleServiceAccountCredentialDataAdapter())

src/test/kotlin/com/nylas/resources/EventsTests.kt

@@ -223,6 +223,56 @@ class EventsTests {
       assertEquals("2024-06-18", whenDate.date)
     }
 
+    @Test
+    fun `Event deserializes maybe status properly`() {
+      val adapter = JsonHelper.moshi().adapter(Event::class.java)
+      val jsonBuffer =
+        Buffer().writeUtf8(
+          """
+          {
+            "id": "5d3qmne77v32r8l4phyuksl2x",
+            "grant_id": "41009df5-bf11-4c97-aa18-b285b5f2e386",
+            "calendar_id": "7d93zl2palhxqdy6e5qinsakt",
+            "object": "event",
+            "status": "maybe",
+            "when": {
+              "date": "2024-06-18",
+              "object": "date"
+            }
+          }
+          """.trimIndent(),
+        )
+
+      val event = adapter.fromJson(jsonBuffer)!!
+
+      assertEquals(EventStatus.MAYBE, event.status)
+    }
+
+    @Test
+    fun `Event deserializes unknown status as null`() {
+      val adapter = JsonHelper.moshi().adapter(Event::class.java)
+      val jsonBuffer =
+        Buffer().writeUtf8(
+          """
+          {
+            "id": "5d3qmne77v32r8l4phyuksl2x",
+            "grant_id": "41009df5-bf11-4c97-aa18-b285b5f2e386",
+            "calendar_id": "7d93zl2palhxqdy6e5qinsakt",
+            "object": "event",
+            "status": "unexpected_status",
+            "when": {
+              "date": "2024-06-18",
+              "object": "date"
+            }
+          }
+          """.trimIndent(),
+        )
+
+      val event = adapter.fromJson(jsonBuffer)!!
+
+      assertEquals(null, event.status)
+    }
+
     @Test
     fun `CreateEventAutoConferencingProvider serializes properly`() {
       val adapter = JsonHelper.moshi().adapter(CreateEventAutoConferencingProvider::class.java)