lara-sdk 1.5.2 → 1.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 16d7ebfcc581f7cf377274d58579d0d306eb98c83907c28de3de277fefe0c40f
-  data.tar.gz: 5ae057fa1538580898d922d41f387fcd6d583726eb98fde453811f0fc0d6a3de
+  metadata.gz: 6a3b69ad7aedd5fba6abf61cd338174f91c6784780afb48ed888f2d6781c225f
+  data.tar.gz: 8f736b1507a97c1da997e8136bf6407de5e3a687c704573397284ea093c4fa2b
 SHA512:
-  metadata.gz: 61f703c0ac1fa6059d3f58181ba65d1252a687085e7106b808377da35c13aa7b8f1380d612e451e0e1d2d1dbf734e21cce9cae409fc522d8dca113890a19161b
-  data.tar.gz: be6e69b110dbeefe2093f47aa8e741dd6d4c8fe014b4b3c0b3e66cc4929d313a8832cf5f93c4d7c0af50e18ba11d6d592f8f0bb5a059d7d71437de5fbd64d7be
+  metadata.gz: ed938c0f7ddd966f7307cb13c33500931d2e5f87d10cdd4590b999b37b660148b95a7d5e73a73b0d69eafc464eb98a1c8a03e3b533cfd362f8e434aca995db96
+  data.tar.gz: c3b778924d5b7e09ddf9efff21aed919579cf86df566ada5f96a044c043f6bf3e3fc529ee81c2c7f34c84d576f7f628b07a08719fcf1eadbef3dc7becf34e9c5

data/lib/lara/audio.rb

@@ -25,7 +25,7 @@ module Lara
     # Uploads an audio file to S3 and creates a translation job.
     # @return [Lara::Models::Audio]
     def upload(file_path:, filename:, target:, source: nil, adapt_to: nil, glossaries: nil,
-               no_trace: false, style: nil, voice_gender: nil)
+               no_trace: false, style: nil, voice_gender: nil, voice_cloning: nil)
       response_data = @client.get("/v2/audio/upload-url", params: { filename: filename })
       url = response_data["url"]
       fields = response_data["fields"]
@@ -39,6 +39,7 @@ module Lara
         adapt_to: adapt_to,
         glossaries: glossaries,
         style: style,
+        voice_cloning: voice_cloning,
         voice_gender: voice_gender
       }.compact
 
@@ -68,10 +69,10 @@ module Lara
     # Translates an audio file end-to-end
     # @return [String] translated audio bytes
     def translate(file_path:, filename:, target:, source: nil, adapt_to: nil, glossaries: nil,
-                  no_trace: false, style: nil, voice_gender: nil)
+                  no_trace: false, style: nil, voice_gender: nil, voice_cloning: nil)
       audio = upload(file_path: file_path, filename: filename, target: target, source: source,
                      adapt_to: adapt_to, glossaries: glossaries, no_trace: no_trace, style: style,
-                     voice_gender: voice_gender)
+                     voice_gender: voice_gender, voice_cloning: voice_cloning)
 
       max_wait_time = 60 * 15 # 15 minutes
       start = Time.now
@@ -93,6 +94,76 @@ module Lara
       end
     end
 
+    # Uploads an audio file to S3 and creates a transcript translation job.
+    # @return [Lara::Models::Audio]
+    def upload_for_transcription(file_path:, filename:, target:, source: nil, adapt_to: nil, glossaries: nil,
+                                 no_trace: false, style: nil)
+      response_data = @client.get("/v2/audio/upload-url", params: { filename: filename })
+      url = response_data["url"]
+      fields = response_data["fields"]
+
+      @s3.upload(url: url, fields: fields, io: file_path)
+
+      body = {
+        s3key: fields["key"],
+        target: target,
+        source: source,
+        adapt_to: adapt_to,
+        glossaries: glossaries,
+        style: style
+      }.compact
+
+      headers = {}
+      headers["X-No-Trace"] = "true" if no_trace
+
+      response = @client.post("/v2/audio/translate-transcript", body: body, headers: headers)
+      response_params = response.transform_keys(&:to_sym)
+      Lara::Models::Audio.new(**filter_audio_params(response_params))
+    end
+
+    # Retrieves the translated transcript JSON.
+    # @return [Lara::Models::AudioTextResult]
+    def get_translated_transcript(id)
+      response = @client.get("/v2/audio/#{id}/translated-transcript")
+      Lara::Models::AudioTextResult.new(
+        id: response["id"],
+        source: response["source"],
+        target: response["target"],
+        filename: response["filename"],
+        duration: response["duration"],
+        text: response["text"],
+        translation: response["translation"],
+        segments: response["segments"]
+      )
+    end
+
+    # Translates an audio transcript end-to-end
+    # @return [Lara::Models::AudioTextResult]
+    def translate_transcript(file_path:, filename:, target:, source: nil, adapt_to: nil, glossaries: nil,
+                             no_trace: false, style: nil)
+      audio = upload_for_transcription(file_path: file_path, filename: filename, target: target, source: source,
+                                       adapt_to: adapt_to, glossaries: glossaries, no_trace: no_trace, style: style)
+
+      max_wait_time = 60 * 15 # 15 minutes
+      start = Time.now
+
+      loop do |_|
+        current = status(audio.id)
+
+        case current.status
+        when Lara::Models::AudioStatus::TRANSLATED
+          return get_translated_transcript(current.id)
+        when Lara::Models::AudioStatus::ERROR
+          raise Lara::LaraApiError.new(500, "AudioError",
+                                       current.error_reason || "Unknown error")
+        end
+
+        raise Timeout::Error if Time.now - start > max_wait_time
+
+        sleep @polling_interval
+      end
+    end
+
     private
 
     def filter_audio_params(params)

data/lib/lara/client.rb

@@ -16,7 +16,7 @@ module Lara
     DEFAULT_BASE_URL = "https://api.laratranslate.com"
 
     def initialize(auth_method, base_url: DEFAULT_BASE_URL, connection_timeout: nil,
-                   read_timeout: nil)
+                   read_timeout: nil, session_id: nil)
       case auth_method
       when Credentials
         @credentials = auth_method
@@ -31,6 +31,7 @@ module Lara
       @base_url = base_url.to_s.sub(%r{/+$}, "")
       @connection_timeout = connection_timeout
       @read_timeout = read_timeout
+      @session_id = session_id
       @extra_headers = {}
       @auth_mutex = Monitor.new
 
@@ -148,6 +149,8 @@ module Lara
                                                            'application/json', timestamp)}"
       }
 
+      headers["X-Lara-Auth-Session-Id"] = @session_id if @session_id && !@session_id.empty?
+
       conn = Faraday.new(url: @base_url) do |c|
         c.adapter Faraday.default_adapter
       end

data/lib/lara/models/audio.rb

@@ -52,5 +52,52 @@ module Lara
         @error_reason = error_reason
       end
     end
+
+    # Audio text segment for transcript results
+    class AudioTextSegment < Base
+      attr_reader :id, :start, :text, :translation
+
+      # JSON field is "end"; expose as #end to match the wire contract / other SDKs.
+      attr_reader :end
+
+      def initialize(id: nil, start: nil, end_time: nil, text: nil, translation: nil, **kwargs)
+        super()
+        @id = id
+        @start = start
+        @end = end_time.nil? ? (kwargs[:end] || kwargs["end"]) : end_time
+        @text = text
+        @translation = translation
+      end
+    end
+
+    # Audio text result for transcript translation
+    class AudioTextResult < Base
+      attr_reader :id, :source, :target, :filename, :duration, :text, :translation, :segments
+
+      def initialize(id: nil, source: nil, target: nil, filename: nil, duration: nil, text: nil,
+                     translation: nil, segments: nil, **_kwargs)
+        super()
+        @id = id
+        @source = source
+        @target = target
+        @filename = filename
+        @duration = duration
+        @text = text
+        @translation = translation
+        @segments = Array(segments).map do |seg|
+          if seg.is_a?(Hash)
+            AudioTextSegment.new(
+              id: seg["id"] || seg[:id],
+              start: seg["start"] || seg[:start],
+              end_time: seg["end"] || seg[:end],
+              text: seg["text"] || seg[:text],
+              translation: seg["translation"] || seg[:translation]
+            )
+          else
+            seg
+          end
+        end
+      end
+    end
   end
 end

data/lib/lara/translator.rb

@@ -11,8 +11,9 @@ module Lara
     # @param base_url [String,nil]
     # @param connection_timeout [Integer,nil]
     # @param read_timeout [Integer,nil]
+    # @param session_id [String,nil]
     def initialize(credentials: nil, auth_token: nil, access_key_id: nil, access_key_secret: nil,
-                   base_url: nil, connection_timeout: nil, read_timeout: nil)
+                   base_url: nil, connection_timeout: nil, read_timeout: nil, session_id: nil)
       auth_method = if auth_token
                       auth_token
                     elsif credentials
@@ -25,7 +26,8 @@ module Lara
                     end
 
       @client = Client.new(auth_method, base_url: base_url,
-                                        connection_timeout: connection_timeout, read_timeout: read_timeout)
+                                        connection_timeout: connection_timeout, read_timeout: read_timeout,
+                                        session_id: session_id)
       @memories = Memories.new(@client)
       @glossaries = Glossaries.new(@client)
       @styleguides = Styleguides.new(@client)
@@ -140,7 +142,8 @@ module Lara
     # @return [Lara::Models::ProfanityDetectResult]
     def detect_profanities(text, language:, content_type: "text/plain")
       unless VALID_CONTENT_TYPES.include?(content_type)
-        raise ArgumentError, "Invalid content_type '#{content_type}'. Must be one of: #{VALID_CONTENT_TYPES.join(', ')}"
+        raise ArgumentError,
+              "Invalid content_type '#{content_type}'. Must be one of: #{VALID_CONTENT_TYPES.join(', ')}"
       end
 
       body = { text: text, language: language, content_type: content_type }

data/lib/lara/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lara
-  VERSION = "1.5.2"
+  VERSION = "1.6.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lara-sdk
 version: !ruby/object:Gem::Version
-  version: 1.5.2
+  version: 1.6.1
 platform: ruby
 authors:
 - Translated
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-13 00:00:00.000000000 Z
+date: 2026-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday