lara-sdk 1.5.1 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62e105c3ffc01c98306c18210a43776511f1bde4564b8b74adf6a6b1386b0db5
-  data.tar.gz: 94bf072420119b0a757e7f7ea06fc8323d7a2c6b0b36c5c4f0293fd05007945e
+  metadata.gz: cc633e73a404baacc47d8235d9c1e6df124f738b2395444dd63f67a150d518f8
+  data.tar.gz: 8030176d5341129e0b9a4b827d29bf5f8380acfedd1cf967dc91d0b31558bcb5
 SHA512:
-  metadata.gz: 11eccbd54efe8c818365d53355f5ff48da6069d2ee6bd1d4f609f340ac6b9ff3ef6579b8623b25fdaf5f62442f3e1f3cf38397d2a56970791f6e207eaf3d0076
-  data.tar.gz: 951b8a2d41a38b019192e35b451186f07924b85c845167a096a96ee6b46437c2af4411282cc85b5222e70f1daa52452a76f9492507c08ec1dcf0067040fd1962
+  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/auth_token.rb

@@ -10,7 +10,7 @@ module Lara
 
     def initialize(token, refresh_token)
       @token = token
-      @refresh_token = refresh_token
+      @refresh_token = refresh_token.nil? || refresh_token.empty? ? nil : refresh_token
       @expires_at_ms = parse_expires_at_ms(token)
     end
 

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
 
@@ -64,7 +65,8 @@ module Lara
     # @yield [Hash] Each partial JSON result from the stream (if streaming)
     # @return [Hash, Array, String, nil] The JSON 'content' from the API, CSV body, or raw bytes.
     def post(path, body: nil, files: nil, headers: nil, raw_response: false, &callback)
-      request(:post, path, body: body, files: files, headers: headers, raw_response: raw_response, &callback)
+      request(:post, path, body: body, files: files, headers: headers, raw_response: raw_response,
+              &callback)
     end
 
     # Sends a PUT request to the Lara API.
@@ -88,17 +90,18 @@ module Lara
 
     private
 
-    def request(method, path, body: nil, files: nil, headers: nil, params: nil, raw_response: false, &callback)
+    def request(method, path, body: nil, files: nil, headers: nil, params: nil,
+                raw_response: false, &callback)
       ensure_valid_token
 
       make_request(method, path, body: body, files: files, headers: headers, params: params,
-                   raw_response: raw_response, &callback)
+                                 raw_response: raw_response, &callback)
     rescue LaraApiError => e
       raise unless e.status_code == 401
 
       @auth_mutex.synchronize { refresh_or_reauthenticate }
       make_request(method, path, body: body, files: files, headers: headers, params: params,
-                   raw_response: raw_response, &callback)
+                                 raw_response: raw_response, &callback)
     end
 
     def ensure_valid_token
@@ -110,7 +113,7 @@ module Lara
     end
 
     def refresh_or_reauthenticate
-      if @auth_token&.refresh_token && !@auth_token.refresh_token.empty?
+      if @auth_token&.refresh_token
         begin
           do_refresh
           return
@@ -146,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
@@ -160,8 +165,6 @@ module Lara
       data = JSON.parse(response.body)
       refresh_token_value = response.headers["x-lara-refresh-token"]
 
-      raise LaraError, "Missing refresh token in authentication response" unless refresh_token_value
-
       AuthToken.new(data["token"], refresh_token_value)
     end
 
@@ -186,12 +189,11 @@ module Lara
       data = JSON.parse(response.body)
       refresh_token_value = response.headers["x-lara-refresh-token"]
 
-      raise LaraError, "Missing refresh token in refresh response" unless refresh_token_value
-
       @auth_token = AuthToken.new(data["token"], refresh_token_value)
     end
 
-    def make_request(method, path, body: nil, files: nil, headers: nil, params: nil, raw_response: false, &callback)
+    def make_request(method, path, body: nil, files: nil, headers: nil, params: nil,
+                     raw_response: false, &callback)
       path = "/#{path}" unless path.start_with?("/")
       request_headers = build_request_headers(body, files, headers)
 
@@ -248,7 +250,7 @@ module Lara
 
         begin
           result = JSON.parse(trimmed_line)
-          block.call(result) if block
+          block&.call(result)
           last_result = result
         rescue JSON::ParserError
           next
@@ -258,7 +260,7 @@ module Lara
       if !buffer.empty? && buffer.strip != ""
         begin
           result = JSON.parse(buffer.strip)
-          block.call(result) if block
+          block&.call(result)
           last_result = result
         rescue JSON::ParserError
         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.1"
+  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.1
+  version: 1.6.0
 platform: ruby
 authors:
 - Translated
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-10 00:00:00.000000000 Z
+date: 2026-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday