feat: add dedicated conferencing provider enums for create and update operations

- Add CreateEventAutoConferencingProvider enum for autocreate conferencing in event creation
- Add CreateEventManualConferencingProvider enum for manual conferencing in event creation
- Add UpdateEventAutoConferencingProvider enum for autocreate conferencing in event updates
- Add UpdateEventManualConferencingProvider enum for manual conferencing in event updates
- Separate enums for create vs update operations to enable independent evolution of supported providers
- Add backward compatibility methods to maintain compatibility with original ConferencingProvider enum
- Add comprehensive test coverage for all new enums, API operations, and backward compatibility
- Maintain full compatibility with existing Event model using original ConferencingProvider

This architecture allows create and update operations to support different conferencing providers
in the future without breaking changes, as each operation now has its own dedicated enum set.

Author: AaronDDM

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Nylas Java SDK Changelog
 
+## [Unreleased]
+
+### Added
+* `CreateEventAutoConferencingProvider` enum for autocreate conferencing providers in event creation
+* `CreateEventManualConferencingProvider` enum for manual conferencing providers in event creation and updates
+* Comprehensive test coverage for new conferencing provider enums
+
+### Changed
+* Updated `CreateEventRequest.Conferencing` to use specific provider enums for autocreate and manual conferencing
+* Updated `UpdateEventRequest.Conferencing` to use specific provider enums for autocreate and manual conferencing
+
 ## [2.12.0]
 
 ### Added

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

@@ -6,23 +6,20 @@ import com.squareup.moshi.Json
  * Enum for the different conferencing providers.
  */
 enum class ConferencingProvider {
-  @Json(name = "Zoom Meeting")
-  ZOOM_MEETING,
-
   @Json(name = "Google Meet")
   GOOGLE_MEET,
 
+  @Json(name = "GoToMeeting")
+  GOTOMEETING,
+
   @Json(name = "Microsoft Teams")
   MICROSOFT_TEAMS,
 
   @Json(name = "WebEx")
   WEBEX,
 
-  @Json(name = "GoToMeeting")
-  GOTOMEETING,
-
-  @Json(name = "skypeForConsumer")
-  SKYPE_FOR_CONSUMER,
+  @Json(name = "Zoom Meeting")
+  ZOOM_MEETING,
 
   @Json(name = "unknown")
   UNKNOWN,

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

@@ -0,0 +1,17 @@
+package com.nylas.models
+
+import com.squareup.moshi.Json
+
+/**
+ * Enum for the different conferencing providers that can be used to auto-create a meeting.
+ */
+enum class CreateEventAutoConferencingProvider {
+  @Json(name = "Google Meet")
+  GOOGLE_MEET,
+
+  @Json(name = "Zoom Meeting")
+  ZOOM_MEETING,
+
+  @Json(name = "Microsoft Teams")
+  MICROSOFT_TEAMS,
+}

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

@@ -0,0 +1,26 @@
+package com.nylas.models
+
+import com.squareup.moshi.Json
+
+/**
+ * Enum for the different conferencing providers that can be used to manually create a meeting.
+ */
+enum class CreateEventManualConferencingProvider {
+  @Json(name = "Google Meet")
+  GOOGLE_MEET,
+
+  @Json(name = "Zoom Meeting")
+  ZOOM_MEETING,
+
+  @Json(name = "Microsoft Teams")
+  MICROSOFT_TEAMS,
+
+  @Json(name = "Teams for Business")
+  TEAMS_FOR_BUSINESS,
+
+  @Json(name = "Skype for Business")
+  SKYPE_FOR_BUSINESS,
+
+  @Json(name = "Skype for Consumer")
+  SKYPE_FOR_CONSUMER,
+}

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

@@ -321,14 +321,41 @@ data class CreateEventRequest(
        * The conferencing provider.
        */
       @Json(name = "provider")
-      val provider: ConferencingProvider,
+      val provider: CreateEventAutoConferencingProvider,
       /**
        * Empty dict to indicate an intention to autocreate a video link.
        * Additional provider settings may be included in autocreate.settings, but Nylas does not validate these.
        */
       @Json(name = "autocreate")
       val autocreate: Map<String, Any> = emptyMap(),
-    ) : Conferencing()
+    ) : Conferencing() {
+      companion object {
+        /**
+         * Create an Autocreate conferencing object using the original ConferencingProvider enum.
+         * @param provider The conferencing provider from the original enum
+         * @param autocreate Empty dict to indicate an intention to autocreate a video link
+         * @return Autocreate object with converted provider
+         * @deprecated Use CreateEventAutoConferencingProvider instead. This method will be removed in a future version.
+         */
+        @Deprecated(
+          message = "Use CreateEventAutoConferencingProvider instead of ConferencingProvider",
+          replaceWith = ReplaceWith("Autocreate(CreateEventAutoConferencingProvider.fromConferencingProvider(provider), autocreate)"),
+        )
+        @JvmStatic
+        fun fromConferencingProvider(
+          provider: ConferencingProvider,
+          autocreate: Map<String, Any> = emptyMap(),
+        ): Autocreate {
+          val newProvider = when (provider) {
+            ConferencingProvider.GOOGLE_MEET -> CreateEventAutoConferencingProvider.GOOGLE_MEET
+            ConferencingProvider.ZOOM_MEETING -> CreateEventAutoConferencingProvider.ZOOM_MEETING
+            ConferencingProvider.MICROSOFT_TEAMS -> CreateEventAutoConferencingProvider.MICROSOFT_TEAMS
+            else -> throw IllegalArgumentException("Provider $provider is not supported for autocreate conferencing. Use CreateEventAutoConferencingProvider instead.")
+          }
+          return Autocreate(newProvider, autocreate)
+        }
+      }
+    }
 
     /**
      * Class representation of a conferencing details object
@@ -338,13 +365,42 @@ data class CreateEventRequest(
        * The conferencing provider.
        */
       @Json(name = "provider")
-      val provider: ConferencingProvider,
+      val provider: CreateEventManualConferencingProvider,
       /**
        * The conferencing details
        */
       @Json(name = "details")
       val details: Config,
     ) : Conferencing() {
+      companion object {
+        /**
+         * Create a Details conferencing object using the original ConferencingProvider enum.
+         * @param provider The conferencing provider from the original enum
+         * @param details The conferencing details config
+         * @return Details object with converted provider
+         * @deprecated Use CreateEventManualConferencingProvider instead. This method will be removed in a future version.
+         */
+        @Deprecated(
+          message = "Use CreateEventManualConferencingProvider instead of ConferencingProvider",
+          replaceWith = ReplaceWith("Details(CreateEventManualConferencingProvider.fromConferencingProvider(provider), details)"),
+        )
+        @JvmStatic
+        fun fromConferencingProvider(
+          provider: ConferencingProvider,
+          details: Config,
+        ): Details {
+          val newProvider = when (provider) {
+            ConferencingProvider.GOOGLE_MEET -> CreateEventManualConferencingProvider.GOOGLE_MEET
+            ConferencingProvider.ZOOM_MEETING -> CreateEventManualConferencingProvider.ZOOM_MEETING
+            ConferencingProvider.MICROSOFT_TEAMS -> CreateEventManualConferencingProvider.MICROSOFT_TEAMS
+            ConferencingProvider.GOTOMEETING -> throw IllegalArgumentException("GoToMeeting is not supported in CreateEventManualConferencingProvider. Use the new enum directly.")
+            ConferencingProvider.WEBEX -> throw IllegalArgumentException("WebEx is not supported in CreateEventManualConferencingProvider. Use the new enum directly.")
+            ConferencingProvider.UNKNOWN -> throw IllegalArgumentException("Unknown provider is not supported for event creation. Use CreateEventManualConferencingProvider instead.")
+          }
+          return Details(newProvider, details)
+        }
+      }
+
       /**
        * Class representation of a conferencing details config object
        * @property meetingCode The conferencing meeting code. Used for Zoom.

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

@@ -0,0 +1,17 @@
+package com.nylas.models
+
+import com.squareup.moshi.Json
+
+/**
+ * Enum for the different conferencing providers that can be used to auto-create a meeting when updating events.
+ */
+enum class UpdateEventAutoConferencingProvider {
+  @Json(name = "Google Meet")
+  GOOGLE_MEET,
+
+  @Json(name = "Zoom Meeting")
+  ZOOM_MEETING,
+
+  @Json(name = "Microsoft Teams")
+  MICROSOFT_TEAMS,
+}

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

@@ -0,0 +1,26 @@
+package com.nylas.models
+
+import com.squareup.moshi.Json
+
+/**
+ * Enum for the different conferencing providers that can be used to manually create a meeting when updating events.
+ */
+enum class UpdateEventManualConferencingProvider {
+  @Json(name = "Google Meet")
+  GOOGLE_MEET,
+
+  @Json(name = "Zoom Meeting")
+  ZOOM_MEETING,
+
+  @Json(name = "Microsoft Teams")
+  MICROSOFT_TEAMS,
+
+  @Json(name = "Teams for Business")
+  TEAMS_FOR_BUSINESS,
+
+  @Json(name = "Skype for Business")
+  SKYPE_FOR_BUSINESS,
+
+  @Json(name = "Skype for Consumer")
+  SKYPE_FOR_CONSUMER,
+}

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

@@ -354,27 +354,54 @@ data class UpdateEventRequest(
        * The conferencing provider.
        */
       @Json(name = "provider")
-      val provider: ConferencingProvider? = null,
+      val provider: UpdateEventAutoConferencingProvider? = null,
       /**
        * Empty dict to indicate an intention to autocreate a video link.
        * Additional provider settings may be included in autocreate.settings, but Nylas does not validate these.
        */
       @Json(name = "autocreate")
       val autocreate: Map<String, Any>? = null,
     ) : Conferencing() {
+      companion object {
+        /**
+         * Create an Autocreate conferencing object using the original ConferencingProvider enum.
+         * @param provider The conferencing provider from the original enum
+         * @param autocreate Empty dict to indicate an intention to autocreate a video link
+         * @return Autocreate object with converted provider
+         * @deprecated Use UpdateEventAutoConferencingProvider instead. This method will be removed in a future version.
+         */
+        @Deprecated(
+          message = "Use UpdateEventAutoConferencingProvider instead of ConferencingProvider",
+          replaceWith = ReplaceWith("Autocreate(UpdateEventAutoConferencingProvider.fromConferencingProvider(provider), autocreate)"),
+        )
+        @JvmStatic
+        fun fromConferencingProvider(
+          provider: ConferencingProvider,
+          autocreate: Map<String, Any>? = null,
+        ): Autocreate {
+          val newProvider = when (provider) {
+            ConferencingProvider.GOOGLE_MEET -> UpdateEventAutoConferencingProvider.GOOGLE_MEET
+            ConferencingProvider.ZOOM_MEETING -> UpdateEventAutoConferencingProvider.ZOOM_MEETING
+            ConferencingProvider.MICROSOFT_TEAMS -> UpdateEventAutoConferencingProvider.MICROSOFT_TEAMS
+            else -> throw IllegalArgumentException("Provider $provider is not supported for autocreate conferencing. Use UpdateEventAutoConferencingProvider instead.")
+          }
+          return Autocreate(newProvider, autocreate)
+        }
+      }
+
       /**
        * Builder for [Autocreate].
        */
       class Builder {
-        private var provider: ConferencingProvider? = null
+        private var provider: UpdateEventAutoConferencingProvider? = null
         private var autocreate: Map<String, Any>? = null
 
         /**
          * Set the conferencing provider.
          * @param provider The conferencing provider.
          * @return The builder.
          */
-        fun provider(provider: ConferencingProvider) = apply { this.provider = provider }
+        fun provider(provider: UpdateEventAutoConferencingProvider) = apply { this.provider = provider }
 
         /**
          * Set the autocreate settings.
@@ -400,13 +427,42 @@ data class UpdateEventRequest(
        * The conferencing provider.
        */
       @Json(name = "provider")
-      val provider: ConferencingProvider? = null,
+      val provider: UpdateEventManualConferencingProvider? = null,
       /**
        * The conferencing details
        */
       @Json(name = "details")
       val details: Config? = null,
     ) : Conferencing() {
+      companion object {
+        /**
+         * Create a Details conferencing object using the original ConferencingProvider enum.
+         * @param provider The conferencing provider from the original enum
+         * @param details The conferencing details config
+         * @return Details object with converted provider
+         * @deprecated Use UpdateEventManualConferencingProvider instead. This method will be removed in a future version.
+         */
+        @Deprecated(
+          message = "Use UpdateEventManualConferencingProvider instead of ConferencingProvider",
+          replaceWith = ReplaceWith("Details(UpdateEventManualConferencingProvider.fromConferencingProvider(provider), details)"),
+        )
+        @JvmStatic
+        fun fromConferencingProvider(
+          provider: ConferencingProvider,
+          details: Config? = null,
+        ): Details {
+          val newProvider = when (provider) {
+            ConferencingProvider.GOOGLE_MEET -> UpdateEventManualConferencingProvider.GOOGLE_MEET
+            ConferencingProvider.ZOOM_MEETING -> UpdateEventManualConferencingProvider.ZOOM_MEETING
+            ConferencingProvider.MICROSOFT_TEAMS -> UpdateEventManualConferencingProvider.MICROSOFT_TEAMS
+            ConferencingProvider.GOTOMEETING -> throw IllegalArgumentException("GoToMeeting is not supported in UpdateEventManualConferencingProvider. Use the new enum directly.")
+            ConferencingProvider.WEBEX -> throw IllegalArgumentException("WebEx is not supported in UpdateEventManualConferencingProvider. Use the new enum directly.")
+            ConferencingProvider.UNKNOWN -> throw IllegalArgumentException("Unknown provider is not supported for event updates. Use UpdateEventManualConferencingProvider instead.")
+          }
+          return Details(newProvider, details)
+        }
+      }
+
       /**
        * Class representation of a conferencing details config object
        * @property meetingCode The conferencing meeting code. Used for Zoom.
@@ -474,15 +530,15 @@ data class UpdateEventRequest(
        * Builder for [Details].
        */
       class Builder {
-        private var provider: ConferencingProvider? = null
+        private var provider: UpdateEventManualConferencingProvider? = null
         private var details: Config? = null
 
         /**
          * Set the conferencing provider.
          * @param provider The conferencing provider.
          * @return The builder.
          */
-        fun provider(provider: ConferencingProvider) = apply { this.provider = provider }
+        fun provider(provider: UpdateEventManualConferencingProvider) = apply { this.provider = provider }
 
         /**
          * Set the conferencing details.