Deprecate incoming package

src/main/java/com/vonage/client/incoming/CallDirection.java

@@ -17,6 +17,10 @@
 
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * @deprecated Use {@link com.vonage.client.voice.CallDirection}.
+ */
+@Deprecated
 public enum CallDirection {
     OUTBOUND, INBOUND, UNKNOWN;
 

src/main/java/com/vonage/client/incoming/CallEvent.java

@@ -21,6 +21,10 @@
 import com.vonage.client.Jsonable;
 import java.util.Date;
 
+/**
+ * @deprecated Use {@link com.vonage.client.voice.EventWebhook}.
+ */
+@Deprecated
 @JsonIgnoreProperties(ignoreUnknown = true)
 public class CallEvent implements Jsonable {
     private String conversationUuid, callUuid, from, to, uuid, detail;

src/main/java/com/vonage/client/incoming/CallStatus.java

@@ -17,6 +17,10 @@
 
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * @deprecated Use {@link com.vonage.client.voice.CallStatus}.
+ */
+@Deprecated
 public enum CallStatus {
     STARTED,
     RINGING,

src/main/java/com/vonage/client/incoming/CallStatusDetail.java

@@ -17,6 +17,10 @@
 
 import com.fasterxml.jackson.annotation.JsonCreator;
 
+/**
+ * @deprecated Use {@link com.vonage.client.voice.CallStatusDetail}.
+ */
+@Deprecated
 public enum CallStatusDetail {
 
     /**

src/main/java/com/vonage/client/incoming/DtmfResult.java

@@ -17,11 +17,11 @@
 
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonProperty;
-import com.vonage.client.voice.EventWebhook;
 
 /**
- * Represents the DTMF event results in {@link EventWebhook#getDtmf()}.
+ * @deprecated Use {@link com.vonage.client.voice.DtmfResult}.
  */
+@Deprecated
 @JsonIgnoreProperties(ignoreUnknown = true)
 public class DtmfResult {
     private String digits;

src/main/java/com/vonage/client/incoming/InputEvent.java

@@ -20,6 +20,10 @@
 import com.vonage.client.Jsonable;
 import java.util.Date;
 
+/**
+ * @deprecated Use {@link com.vonage.client.voice.EventWebhook}.
+ */
+@Deprecated
 @JsonIgnoreProperties(ignoreUnknown = true)
 public class InputEvent implements Jsonable {
     private String uuid, conversationUuid, to, from;

src/main/java/com/vonage/client/incoming/RecordEvent.java

@@ -20,6 +20,10 @@
 import com.vonage.client.Jsonable;
 import java.util.Date;
 
+/**
+ * @deprecated Use {@link com.vonage.client.voice.EventWebhook}.
+ */
+@Deprecated
 @JsonIgnoreProperties(ignoreUnknown = true)
 public class RecordEvent implements Jsonable {
     private Date startTime, endTime, timestamp;

src/main/java/com/vonage/client/incoming/Result.java

@@ -19,6 +19,10 @@
 import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.annotation.JsonProperty;
 
+/**
+ * @deprecated Use {@link com.vonage.client.voice.SpeechTranscript}.
+ */
+@Deprecated
 @JsonIgnoreProperties(ignoreUnknown = true)
 @JsonInclude(value = JsonInclude.Include.NON_NULL)
 public class Result {

src/main/java/com/vonage/client/incoming/SpeechResults.java

@@ -22,6 +22,10 @@
 import java.net.URI;
 import java.util.Collection;
 
+/**
+ * @deprecated Use {@link com.vonage.client.voice.SpeechResults}.
+ */
+@Deprecated
 @JsonInclude(value = JsonInclude.Include.NON_NULL)
 @JsonIgnoreProperties(ignoreUnknown = true)
 public class SpeechResults {

src/main/java/com/vonage/client/incoming/package-info.java

@@ -0,0 +1,19 @@
+/*
+ *   Copyright 2024 Vonage
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+/**
+ * @deprecated This package will be removed in a future release.
+ */
+package com.vonage.client.incoming;

src/main/java/com/vonage/client/video/TokenOptions.java

@@ -135,44 +135,52 @@ public static class Builder {
          *     <a href="https://tokbox.com/developer/guides/moderation/">Moderation developer guide</a>.
          *     </li>
          * </ul>
+         *
+         * @return This builder.
          */
         public Builder role(Role role) {
             this.role = role;
             return this;
         }
 
          /**
-         * Sets the expiration time for the token.
-         *
-         * @param ttl The expiration length (time-to-live) The maximum duration is 30 days. Default is 24 hours.
+          * Sets the expiration time for the token.
+          *
+          * @param ttl The expiration length (time-to-live) The maximum duration is 30 days. Default is 24 hours.
+          *
+          * @return This builder.
          */
-        public Builder expiryLength(Duration ttl) {
+         public Builder expiryLength(Duration ttl) {
             this.ttl = ttl;
             return this;
         }
 
          /**
-         * A string containing connection metadata describing the end-user. For example, you
-         * can pass the user ID, name, or other data describing the end-user. The length of the
-         * string is limited to 1000 characters. This data cannot be updated once it is set.
-         *
-         * @param data The connection metadata.
+          * A string containing connection metadata describing the end-user. For example, you
+          * can pass the user ID, name, or other data describing the end-user. The length of the
+          * string is limited to 1000 characters. This data cannot be updated once it is set.
+          *
+          * @param data The connection metadata.
+          *
+          * @return This builder.
          */
         public Builder data(String data) throws IllegalArgumentException {
             this.data = data;
             return this;
         }
 
         /**
-        * A List of class names (strings) to be used as the initial layout classes
-        * for streams published by the client. Layout classes are used in customizing the layout
-        * of videos in
-        * <a href="https://tokbox.com/developer/guides/broadcast/live-streaming/">live streaming
-        * broadcasts</a> and
-        * <a href="https://tokbox.com/developer/guides/archiving/layout-control.html">composed
-        * archives</a>. 
-        *
-        * @param initialLayoutClassList The initial layout class list.
+         * A List of class names (strings) to be used as the initial layout classes
+         * for streams published by the client. Layout classes are used in customizing the layout
+         * of videos in
+         * <a href="https://tokbox.com/developer/guides/broadcast/live-streaming/">live streaming
+         * broadcasts</a> and
+         * <a href="https://tokbox.com/developer/guides/archiving/layout-control.html">composed
+         * archives</a>.
+         *
+         * @param initialLayoutClassList The initial layout class list.
+         *
+         * @return This builder.
         */
         public Builder initialLayoutClassList (List<String> initialLayoutClassList) {
             this.initialLayoutClassList = initialLayoutClassList;