Merge pull request #95 from AssemblyAI/fern-bot/04-01-2024-0352PM

🌿 Fern Regeneration -- April 1, 2024

Author: Swimburger

build.gradle

@@ -47,7 +47,7 @@ publishing {
         maven(MavenPublication) {
             groupId = 'com.assemblyai'
             artifactId = 'assemblyai-java'
-            version = '1.0.9'
+            version = '1.0.10'
             from components.java
         }
     }

src/main/java/com/assemblyai/api/resources/realtime/RealtimeClient.java

@@ -26,14 +26,14 @@ public RealtimeClient(ClientOptions clientOptions) {
     }
 
     /**
-     * Create a temporary authentication token for real-time transcription
+     * Create a temporary authentication token for Streaming Speech-to-Text
      */
     public RealtimeTemporaryTokenResponse createTemporaryToken(CreateRealtimeTemporaryTokenParams request) {
         return createTemporaryToken(request, null);
     }
 
     /**
-     * Create a temporary authentication token for real-time transcription
+     * Create a temporary authentication token for Streaming Speech-to-Text
      */
     public RealtimeTemporaryTokenResponse createTemporaryToken(
             CreateRealtimeTemporaryTokenParams request, RequestOptions requestOptions) {

src/main/java/com/assemblyai/api/resources/realtime/types/RealtimeTemporaryTokenResponse.java

@@ -28,7 +28,7 @@ private RealtimeTemporaryTokenResponse(String token, Map<String, Object> additio
     }
 
     /**
-     * @return The temporary authentication token for real-time transcription
+     * @return The temporary authentication token for Streaming Speech-to-Text
      */
     @JsonProperty("token")
     public String getToken() {
@@ -90,7 +90,7 @@ public Builder from(RealtimeTemporaryTokenResponse other) {
         }
 
         /**
-         * <p>The temporary authentication token for real-time transcription</p>
+         * <p>The temporary authentication token for Streaming Speech-to-Text</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @java.lang.Override

src/main/java/com/assemblyai/api/resources/realtime/types/TerminateSession.java

@@ -28,7 +28,7 @@ private TerminateSession(boolean terminateSession, Map<String, Object> additiona
     }
 
     /**
-     * @return Set to true to end your real-time session forever
+     * @return Set to true to end your streaming session forever
      */
     @JsonProperty("terminate_session")
     public boolean getTerminateSession() {
@@ -90,7 +90,7 @@ public Builder from(TerminateSession other) {
         }
 
         /**
-         * <p>Set to true to end your real-time session forever</p>
+         * <p>Set to true to end your streaming session forever</p>
          * @return Reference to {@code this} so that method calls can be chained together.
          */
         @java.lang.Override

src/main/java/com/assemblyai/api/resources/transcripts/TranscriptsClient.java

@@ -35,21 +35,24 @@ public TranscriptsClient(ClientOptions clientOptions) {
     }
 
     /**
-     * Retrieve a list of transcripts you created
+     * Retrieve a list of transcripts you created.
+     * Transcripts are sorted from newest to oldest. The previous URL always points to a page with older transcripts.
      */
     public TranscriptList list() {
         return list(ListTranscriptParams.builder().build());
     }
 
     /**
-     * Retrieve a list of transcripts you created
+     * Retrieve a list of transcripts you created.
+     * Transcripts are sorted from newest to oldest. The previous URL always points to a page with older transcripts.
      */
     public TranscriptList list(ListTranscriptParams request) {
         return list(request, null);
     }
 
     /**
-     * Retrieve a list of transcripts you created
+     * Retrieve a list of transcripts you created.
+     * Transcripts are sorted from newest to oldest. The previous URL always points to a page with older transcripts.
      */
     public TranscriptList list(ListTranscriptParams request, RequestOptions requestOptions) {
         HttpUrl.Builder httpUrl = HttpUrl.parse(this.clientOptions.environment().getUrl())

src/main/java/com/assemblyai/api/resources/transcripts/types/PageDetails.java

@@ -26,7 +26,7 @@ public final class PageDetails {
 
     private final String currentUrl;
 
-    private final String prevUrl;
+    private final Optional<String> prevUrl;
 
     private final Optional<String> nextUrl;
 
@@ -36,7 +36,7 @@ private PageDetails(
             int limit,
             int resultCount,
             String currentUrl,
-            String prevUrl,
+            Optional<String> prevUrl,
             Optional<String> nextUrl,
             Map<String, Object> additionalProperties) {
         this.limit = limit;
@@ -62,11 +62,17 @@ public String getCurrentUrl() {
         return currentUrl;
     }
 
+    /**
+     * @return The URL to the next page of transcripts. The previous URL always points to a page with older transcripts.
+     */
     @JsonProperty("prev_url")
-    public String getPrevUrl() {
+    public Optional<String> getPrevUrl() {
         return prevUrl;
     }
 
+    /**
+     * @return The URL to the next page of transcripts. The next URL always points to a page with newer transcripts.
+     */
     @JsonProperty("next_url")
     public Optional<String> getNextUrl() {
         return nextUrl;
@@ -116,34 +122,33 @@ public interface ResultCountStage {
     }
 
     public interface CurrentUrlStage {
-        PrevUrlStage currentUrl(String currentUrl);
-    }
-
-    public interface PrevUrlStage {
-        _FinalStage prevUrl(String prevUrl);
+        _FinalStage currentUrl(String currentUrl);
     }
 
     public interface _FinalStage {
         PageDetails build();
 
+        _FinalStage prevUrl(Optional<String> prevUrl);
+
+        _FinalStage prevUrl(String prevUrl);
+
         _FinalStage nextUrl(Optional<String> nextUrl);
 
         _FinalStage nextUrl(String nextUrl);
     }
 
     @JsonIgnoreProperties(ignoreUnknown = true)
-    public static final class Builder
-            implements LimitStage, ResultCountStage, CurrentUrlStage, PrevUrlStage, _FinalStage {
+    public static final class Builder implements LimitStage, ResultCountStage, CurrentUrlStage, _FinalStage {
         private int limit;
 
         private int resultCount;
 
         private String currentUrl;
 
-        private String prevUrl;
-
         private Optional<String> nextUrl = Optional.empty();
 
+        private Optional<String> prevUrl = Optional.empty();
+
         @JsonAnySetter
         private Map<String, Object> additionalProperties = new HashMap<>();
 
@@ -175,18 +180,15 @@ public CurrentUrlStage resultCount(int resultCount) {
 
         @java.lang.Override
         @JsonSetter("current_url")
-        public PrevUrlStage currentUrl(String currentUrl) {
+        public _FinalStage currentUrl(String currentUrl) {
             this.currentUrl = currentUrl;
             return this;
         }
 
-        @java.lang.Override
-        @JsonSetter("prev_url")
-        public _FinalStage prevUrl(String prevUrl) {
-            this.prevUrl = prevUrl;
-            return this;
-        }
-
+        /**
+         * <p>The URL to the next page of transcripts. The next URL always points to a page with newer transcripts.</p>
+         * @return Reference to {@code this} so that method calls can be chained together.
+         */
         @java.lang.Override
         public _FinalStage nextUrl(String nextUrl) {
             this.nextUrl = Optional.of(nextUrl);
@@ -200,6 +202,23 @@ public _FinalStage nextUrl(Optional<String> nextUrl) {
             return this;
         }
 
+        /**
+         * <p>The URL to the next page of transcripts. The previous URL always points to a page with older transcripts.</p>
+         * @return Reference to {@code this} so that method calls can be chained together.
+         */
+        @java.lang.Override
+        public _FinalStage prevUrl(String prevUrl) {
+            this.prevUrl = Optional.of(prevUrl);
+            return this;
+        }
+
+        @java.lang.Override
+        @JsonSetter(value = "prev_url", nulls = Nulls.SKIP)
+        public _FinalStage prevUrl(Optional<String> prevUrl) {
+            this.prevUrl = prevUrl;
+            return this;
+        }
+
         @java.lang.Override
         public PageDetails build() {
             return new PageDetails(limit, resultCount, currentUrl, prevUrl, nextUrl, additionalProperties);

src/main/java/com/assemblyai/api/resources/transcripts/types/SpeechModel.java

@@ -7,10 +7,12 @@
 import com.fasterxml.jackson.annotation.JsonValue;
 
 public final class SpeechModel {
-    public static final SpeechModel CONFORMER2 = new SpeechModel(Value.CONFORMER2, "conformer-2");
-
     public static final SpeechModel NANO = new SpeechModel(Value.NANO, "nano");
 
+    public static final SpeechModel BEST = new SpeechModel(Value.BEST, "best");
+
+    public static final SpeechModel CONFORMER2 = new SpeechModel(Value.CONFORMER2, "conformer-2");
+
     private final Value value;
 
     private final String string;
@@ -42,10 +44,12 @@ public int hashCode() {
 
     public <T> T visit(Visitor<T> visitor) {
         switch (value) {
-            case CONFORMER2:
-                return visitor.visitConformer2();
             case NANO:
                 return visitor.visitNano();
+            case BEST:
+                return visitor.visitBest();
+            case CONFORMER2:
+                return visitor.visitConformer2();
             case UNKNOWN:
             default:
                 return visitor.visitUnknown(string);
@@ -55,16 +59,20 @@ public <T> T visit(Visitor<T> visitor) {
     @JsonCreator(mode = JsonCreator.Mode.DELEGATING)
     public static SpeechModel valueOf(String value) {
         switch (value) {
-            case "conformer-2":
-                return CONFORMER2;
             case "nano":
                 return NANO;
+            case "best":
+                return BEST;
+            case "conformer-2":
+                return CONFORMER2;
             default:
                 return new SpeechModel(Value.UNKNOWN, value);
         }
     }
 
     public enum Value {
+        BEST,
+
         NANO,
 
         CONFORMER2,
@@ -73,6 +81,8 @@ public enum Value {
     }
 
     public interface Visitor<T> {
+        T visitBest();
+
         T visitNano();
 
         T visitConformer2();

src/main/java/com/assemblyai/api/resources/transcripts/types/SubstitutionPolicy.java

@@ -7,7 +7,7 @@
 import com.fasterxml.jackson.annotation.JsonValue;
 
 public final class SubstitutionPolicy {
-    public static final SubstitutionPolicy ENTITY_TYPE = new SubstitutionPolicy(Value.ENTITY_TYPE, "entity_type");
+    public static final SubstitutionPolicy ENTITY_NAME = new SubstitutionPolicy(Value.ENTITY_NAME, "entity_name");
 
     public static final SubstitutionPolicy HASH = new SubstitutionPolicy(Value.HASH, "hash");
 
@@ -43,8 +43,8 @@ public int hashCode() {
 
     public <T> T visit(Visitor<T> visitor) {
         switch (value) {
-            case ENTITY_TYPE:
-                return visitor.visitEntityType();
+            case ENTITY_NAME:
+                return visitor.visitEntityName();
             case HASH:
                 return visitor.visitHash();
             case UNKNOWN:
@@ -56,8 +56,8 @@ public <T> T visit(Visitor<T> visitor) {
     @JsonCreator(mode = JsonCreator.Mode.DELEGATING)
     public static SubstitutionPolicy valueOf(String value) {
         switch (value) {
-            case "entity_type":
-                return ENTITY_TYPE;
+            case "entity_name":
+                return ENTITY_NAME;
             case "hash":
                 return HASH;
             default:
@@ -66,15 +66,15 @@ public static SubstitutionPolicy valueOf(String value) {
     }
 
     public enum Value {
-        ENTITY_TYPE,
+        ENTITY_NAME,
 
         HASH,
 
         UNKNOWN
     }
 
     public interface Visitor<T> {
-        T visitEntityType();
+        T visitEntityName();
 
         T visitHash();