lara-sdk 1.5.2 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 16d7ebfcc581f7cf377274d58579d0d306eb98c83907c28de3de277fefe0c40f
-  data.tar.gz: 5ae057fa1538580898d922d41f387fcd6d583726eb98fde453811f0fc0d6a3de
+  metadata.gz: cc633e73a404baacc47d8235d9c1e6df124f738b2395444dd63f67a150d518f8
+  data.tar.gz: 8030176d5341129e0b9a4b827d29bf5f8380acfedd1cf967dc91d0b31558bcb5
 SHA512:
-  metadata.gz: 61f703c0ac1fa6059d3f58181ba65d1252a687085e7106b808377da35c13aa7b8f1380d612e451e0e1d2d1dbf734e21cce9cae409fc522d8dca113890a19161b
-  data.tar.gz: be6e69b110dbeefe2093f47aa8e741dd6d4c8fe014b4b3c0b3e66cc4929d313a8832cf5f93c4d7c0af50e18ba11d6d592f8f0bb5a059d7d71437de5fbd64d7be
+  metadata.gz: b18a99373f8706f6cdc4177d85527f50d6c8696bf322fe4242151e48a119a533a8f0d573d709dcd384e1645e65c151b03e52f5119b210ead410ad9b760b79d44
+  data.tar.gz: 34fe09cf554d21b9d5b3a31d8e8707dbfb001879f8eed9a6c50e82d167c643b000e8ef0ed183ad85bc4503eb985223ecd583f33972aab22668f8361e4a93a1bf

data/lib/lara/audio.rb

@@ -93,6 +93,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.0"
 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.0
 platform: ruby
 authors:
 - Translated
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-13 00:00:00.000000000 Z
+date: 2026-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday