lara-sdk 1.7.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 07f0f176e933b058cb2389a2f42b9eca44f340697f90f7249071ca7db164da86
-  data.tar.gz: f44fd4c0ec64c2051a77273eab0d4fdff5f1f47f4188c8fe6b21f6f3dfd492a6
+  metadata.gz: 6441d4e8ad5cc6064ed3367644ed969d3c91e2dc5d5bcf2645680b2389d491b6
+  data.tar.gz: 1bbdb83ca6fb7f330ebb3adf69b8126facb9c1045875f083196580a2915d8b67
 SHA512:
-  metadata.gz: f70a02eabf9588e9b6348efcffed1e4e051cfa11fea586c804ffc47e36c8a65fc9da2c1cfa466539a09b8dea0547727ce9d26dde0259056c1ed993409289380d
-  data.tar.gz: 96d6199390210e3b8c8628c9f048668981870671d78e08ee59f9bc1b08b8f856d8cd90070cf9150a2964fcfa3f8ce5198edda88f437e6609a718f5782cd5054d
+  metadata.gz: c8b12451198b5a52a076766e310e4622cab58c1a1ce6173d6f3852291c183835b3111fcded6aee2ce60b0631727066d9b3dd443644ea03d12856f2db01314f07
+  data.tar.gz: b7dd274d9cdf562a91d0fcb496c9ce2f4053d9be3a99bb4fe5bfdb9d09d93d271ef46e82e2f8538b9b4fb24da8489401ef40bf79f6eeb29c1bc68bbbce3add2f

data/lib/lara/client.rb

@@ -92,6 +92,15 @@ module Lara
 
     def request(method, path, body: nil, files: nil, headers: nil, params: nil,
                 raw_response: false, &callback)
+      file_positions = (files || {}).each_with_object({}) do |(name, file), positions|
+        next unless file.respond_to?(:pos) && file.respond_to?(:seek)
+
+        begin
+          positions[name] = file.pos
+        rescue IOError, SystemCallError
+          # Non-seekable uploads can still be sent once.
+        end
+      end
       ensure_valid_token
 
       make_request(method, path, body: body, files: files, headers: headers, params: params,
@@ -100,6 +109,8 @@ module Lara
       raise unless e.status_code == 401
 
       @auth_mutex.synchronize { refresh_or_reauthenticate }
+      # Multipart encoding consumed the files; replay their original bytes.
+      file_positions.each { |name, position| files[name].seek(position) }
       make_request(method, path, body: body, files: files, headers: headers, params: params,
                                  raw_response: raw_response, &callback)
     end
@@ -218,7 +229,7 @@ module Lara
       return response.body if raw_response
 
       content_type = response.headers["content-type"] || response.headers["Content-Type"]
-      return response.body if content_type&.include?("text/csv")
+      return response.body if content_type&.include?("text/csv") || content_type&.include?("application/xml")
 
       if callback || (body && body[:reasoning])
         parse_stream_response(response.body, &callback)

data/lib/lara/glossaries.rb

@@ -6,10 +6,11 @@ module Lara
     module FileFormat
       UNIDIRECTIONAL = "csv/table-uni"
       MULTIDIRECTIONAL = "csv/table-multi"
+      TBX = "tbx"
 
       # @return [Array<String>] All supported formats
       def self.all
-        [UNIDIRECTIONAL, MULTIDIRECTIONAL]
+        [UNIDIRECTIONAL, MULTIDIRECTIONAL, TBX]
       end
 
       # @param format [String] The format to validate
@@ -91,33 +92,28 @@ module Lara
       Lara::Models::GlossaryCounts.new(**@client.get("/v2/glossaries/#{id}/counts").transform_keys(&:to_sym))
     end
 
-    # @param content_type [String] Either FileFormat::UNIDIRECTIONAL or FileFormat::MULTIDIRECTIONAL
-    # @param gzip [Boolean] When true, compress the CSV before upload and set compression=gzip
+    # Import options are independent keyword arguments; omitted options use their defaults.
+    # @param content_type [String] One of FileFormat.all; defaults to UNIDIRECTIONAL
+    # @param gzip [Boolean] Whether the supplied file is already gzip-compressed; defaults to false
     # @param callback_url [String,nil] Optional URL notified when the import completes
     # @return [Lara::Models::GlossaryImport]
-    def import_csv(id, csv_path, content_type: FileFormat::UNIDIRECTIONAL, gzip: false,
-                   callback_url: nil)
+    def import_file(id, file_path, content_type: FileFormat::UNIDIRECTIONAL, gzip: false,
+                    callback_url: nil)
       unless FileFormat.valid?(content_type)
         raise ArgumentError, "Invalid content_type. Supported formats: #{FileFormat.all.join(', ')}"
       end
 
-      basename = File.basename(csv_path)
-      if gzip
-        require "stringio"
-        require "zlib"
-
-        buffer = StringIO.new
-        gz = Zlib::GzipWriter.new(buffer, 7, Zlib::DEFAULT_STRATEGY)
-        File.open(csv_path, "rb") { |_f| IO.copy_stream(_f, gz) }
-        gz.finish
-        buffer.rewind
-
-        body = { "compression" => "gzip" }
-        files = { "csv" => Faraday::UploadIO.new(buffer, "application/gzip", "#{basename}.gz") }
-      else
-        body = {}
-        files = { "csv" => Faraday::UploadIO.new(csv_path, "text/csv", basename) }
-      end
+      basename = File.basename(file_path)
+      mime_type = if gzip
+                    "application/gzip"
+                  elsif content_type == FileFormat::TBX
+                    "application/xml"
+                  else
+                    "text/csv"
+                  end
+      files = { "csv" => Faraday::UploadIO.new(file_path, mime_type, basename) }
+      body = {}
+      body["compression"] = "gzip" if gzip
 
       body["content_type"] = content_type unless content_type == FileFormat::UNIDIRECTIONAL
       body["callback_url"] = callback_url if callback_url
@@ -125,6 +121,16 @@ module Lara
                                                       body: body, files: files).transform_keys(&:to_sym))
     end
 
+    # @deprecated Use #import_file instead.
+    def import_csv(id, csv_path, content_type: FileFormat::UNIDIRECTIONAL, gzip: false,
+                   callback_url: nil)
+      warn "[DEPRECATION] import_csv is deprecated; use import_file instead.", uplevel: 1
+      unless [FileFormat::UNIDIRECTIONAL, FileFormat::MULTIDIRECTIONAL].include?(content_type)
+        raise ArgumentError, "import_csv only supports CSV formats; use import_file for TBX files."
+      end
+      import_file(id, csv_path, content_type: content_type, gzip: gzip, callback_url: callback_url)
+    end
+
     # @return [Lara::Models::GlossaryImport]
     def get_import_status(import_id)
       Lara::Models::GlossaryImport.new(**@client.get("/v2/glossaries/imports/#{import_id}").transform_keys(&:to_sym))
@@ -146,10 +152,10 @@ module Lara
       current
     end
 
-    # Exports a csv file with the glossary content.
-    # @param content_type [String] Either FileFormat::UNIDIRECTIONAL or FileFormat::MULTIDIRECTIONAL
-    # @param source [String, nil] Optional source language
-    # @return [String] bytes
+    # Exports the glossary in the requested format.
+    # @param content_type [String] One of the formats returned by FileFormat.all
+    # @param source [String, nil] Required for unidirectional CSV; omit for multidirectional CSV and TBX
+    # @return [String] Raw CSV or TBX content
     def export(id, content_type: FileFormat::UNIDIRECTIONAL, source: nil)
       unless FileFormat.valid?(content_type)
         raise ArgumentError, "Invalid content_type. Supported formats: #{FileFormat.all.join(', ')}"
@@ -160,8 +166,8 @@ module Lara
     end
 
     # @param callback_url [String] URL notified when the export is ready
-    # @param content_type [String] Either FileFormat::UNIDIRECTIONAL or FileFormat::MULTIDIRECTIONAL
-    # @param source [String, nil] Optional source language (unidirectional exports only)
+    # @param content_type [String] One of the formats returned by FileFormat.all
+    # @param source [String, nil] Required for unidirectional CSV; omit for multidirectional CSV and TBX
     # @return [Lara::Models::GlossaryExport]
     def export_async(id, callback_url:, content_type: FileFormat::UNIDIRECTIONAL, source: nil)
       unless FileFormat.valid?(content_type)

data/lib/lara/images.rb

@@ -46,10 +46,12 @@ module Lara
     # @param glossaries [Array<String>, nil] Glossary IDs to apply.
     # @param style [String, nil] Translation style ("faithful", "fluid", "creative").
     # @param verbose [Boolean] If true, includes match details in the response.
+    # @param include_layout [Boolean] When true, includes complete geometry and styling on every
+    #   paragraph independently of verbose.
     # @param no_trace [Boolean] If true, disables request tracing.
     # @return [Lara::Models::ImageTextResult]
     def translate_text(file_path:, target:, source: nil, adapt_to: nil, glossaries: nil,
-                       style: nil, verbose: false, no_trace: false)
+                       style: nil, verbose: false, no_trace: false, include_layout: false)
       image_upload = Faraday::Multipart::FilePart.new(file_path, mime_type_for(file_path))
 
       body = {
@@ -58,7 +60,8 @@ module Lara
         adapt_to: adapt_to&.to_json,
         glossaries: glossaries&.to_json,
         style: style,
-        verbose: verbose.to_s
+        verbose: verbose.to_s,
+        include_layout: include_layout.to_s
       }.compact
 
       headers = {}
@@ -69,6 +72,27 @@ module Lara
       Lara::Models::ImageTextResult.from_hash(result)
     end
 
+    # Renders supplied translations onto the original image without translating again.
+    # Overlay and inpainting require ImageLayoutParagraph instances. Generative models
+    # accept either ImageParagraph or ImageLayoutParagraph. An omitted model defaults
+    # to generative_fast.
+    # @param paragraphs [Array<Lara::Models::ImageParagraph>] Text and translations to render.
+    # @return [String] Binary image data.
+    def render_translated(file_path:, target:, paragraphs:, source: nil, model: nil, no_trace: false)
+      image_upload = Faraday::Multipart::FilePart.new(file_path, mime_type_for(file_path))
+      body = {
+        source: source,
+        target: target,
+        paragraphs: paragraphs.map(&:to_render_hash).to_json,
+        model: model
+      }.compact
+      headers = {}
+      headers["X-No-Trace"] = "true" if no_trace
+
+      @client.post("/v2/images/render-translated", body: body, files: { image: image_upload },
+                                               headers: headers, raw_response: true)
+    end
+
     private
 
     def mime_type_for(file_path)

data/lib/lara/memories.rb

@@ -144,20 +144,14 @@ module Lara
       end
     end
 
+    # @param gzip [Boolean] Whether the supplied file is already gzip-compressed; defaults to false
     # @return [Lara::Models::MemoryImport]
-    def import_tmx(id, tmx_path, callback_url: nil)
-      require "stringio"
-      require "zlib"
+    def import_tmx(id, tmx_path, gzip: false, callback_url: nil)
       basename = File.basename(tmx_path)
-
-      buffer = StringIO.new
-      gz = Zlib::GzipWriter.new(buffer, 7, Zlib::DEFAULT_STRATEGY)
-      File.open(tmx_path, "rb") { |_f| IO.copy_stream(_f, gz) }
-      gz.finish
-      buffer.rewind
-
-      files = { "tmx" => Faraday::UploadIO.new(buffer, "application/gzip", "#{basename}.gz") }
-      body = { "compression" => "gzip" }
+      mime_type = gzip ? "application/gzip" : "application/xml"
+      files = { "tmx" => Faraday::UploadIO.new(tmx_path, mime_type, basename) }
+      body = {}
+      body["compression"] = "gzip" if gzip
       body["callback_url"] = callback_url if callback_url
       Lara::Models::MemoryImport.new(**@client.post("/v2/memories/#{id}/import",
                                                     body: body, files: files).transform_keys(&:to_sym))

data/lib/lara/models/images.rb

@@ -18,6 +18,51 @@ module Lara
       end
     end
 
+    # Four corners, each an [x, y] pair of pixel coordinates.
+    class ImageBBox < Base
+      attr_reader :top_left, :top_right, :bottom_right, :bottom_left
+
+      def initialize(top_left:, top_right:, bottom_right:, bottom_left:)
+        super()
+        @top_left = top_left
+        @top_right = top_right
+        @bottom_right = bottom_right
+        @bottom_left = bottom_left
+      end
+
+      def self.from_hash(hash)
+        new(top_left: hash["top_left"] || hash["topLeft"],
+            top_right: hash["top_right"] || hash["topRight"],
+            bottom_right: hash["bottom_right"] || hash["bottomRight"],
+            bottom_left: hash["bottom_left"] || hash["bottomLeft"])
+      end
+
+      def to_render_hash
+        { top_left: top_left, top_right: top_right, bottom_right: bottom_right, bottom_left: bottom_left }
+      end
+    end
+
+    # Original text direction (ltr, rtl, or ttb) and colors.
+    class ImageTextInfo < Base
+      attr_reader :direction, :text_color, :background_color
+
+      def initialize(direction:, text_color:, background_color:)
+        super()
+        @direction = direction
+        @text_color = text_color
+        @background_color = background_color
+      end
+
+      def self.from_hash(hash)
+        new(direction: hash["direction"], text_color: hash["text_color"] || hash["textColor"],
+            background_color: hash["background_color"] || hash["backgroundColor"])
+      end
+
+      def to_render_hash
+        { direction: direction, text_color: text_color, background_color: background_color }
+      end
+    end
+
     class ImageParagraph < Base
       attr_reader :text, :translation, :adapted_to_matches, :glossaries_matches
 
@@ -28,6 +73,29 @@ module Lara
         @adapted_to_matches = adapted_to_matches
         @glossaries_matches = glossaries_matches
       end
+
+      def to_render_hash
+        { text: text, translation: translation }
+      end
+    end
+
+    class ImageLayoutParagraph < ImageParagraph
+      attr_reader :bbox, :lines_bboxes, :text_info, :alignment
+
+      def initialize(text:, translation:, bbox:, lines_bboxes:, text_info:, alignment:,
+                     adapted_to_matches: nil, glossaries_matches: nil)
+        super(text: text, translation: translation, adapted_to_matches: adapted_to_matches,
+              glossaries_matches: glossaries_matches)
+        @bbox = bbox
+        @lines_bboxes = lines_bboxes
+        @text_info = text_info
+        @alignment = alignment
+      end
+
+      def to_render_hash
+        super.merge(bbox: bbox.to_render_hash, lines_bboxes: lines_bboxes.map(&:to_render_hash),
+                    text_info: text_info.to_render_hash, alignment: alignment)
+      end
     end
 
     class ImageTextResult < Base
@@ -39,8 +107,8 @@ module Lara
         paragraphs = (hash["paragraphs"] || []).map { |p| build_paragraph(p) }
 
         new(
-          source_language: hash["sourceLanguage"],
-          adapted_to: hash["adaptedTo"],
+          source_language: hash["source_language"] || hash["sourceLanguage"],
+          adapted_to: hash["adapted_to"] || hash["adaptedTo"],
           glossaries: hash["glossaries"],
           paragraphs: paragraphs
         )
@@ -50,15 +118,30 @@ module Lara
         private
 
         def build_paragraph(paragraph_hash)
-          adapted_to_matches = convert_matches(paragraph_hash["adaptedToMatches"], NGMemoryMatch)
-          glossaries_matches = convert_matches(paragraph_hash["glossariesMatches"], NGGlossaryMatch)
+          adapted_to_matches = convert_matches(
+            paragraph_hash["adapted_to_matches"] || paragraph_hash["adaptedToMatches"], NGMemoryMatch
+          )
+          glossaries_matches = convert_matches(
+            paragraph_hash["glossaries_matches"] || paragraph_hash["glossariesMatches"], NGGlossaryMatch
+          )
 
-          ImageParagraph.new(
+          attributes = {
             text: paragraph_hash["text"],
             translation: paragraph_hash["translation"],
             adapted_to_matches: adapted_to_matches,
             glossaries_matches: glossaries_matches
-          )
+          }
+          bbox = paragraph_hash["bbox"]
+          lines_bboxes = paragraph_hash["lines_bboxes"] || paragraph_hash["linesBboxes"]
+          text_info = paragraph_hash["text_info"] || paragraph_hash["textInfo"]
+          alignment = paragraph_hash["alignment"]
+          if bbox && lines_bboxes && text_info && alignment
+            ImageLayoutParagraph.new(**attributes, bbox: ImageBBox.from_hash(bbox),
+                                     lines_bboxes: lines_bboxes.map { |box| ImageBBox.from_hash(box) },
+                                     text_info: ImageTextInfo.from_hash(text_info), alignment: alignment)
+          else
+            ImageParagraph.new(**attributes)
+          end
         end
 
         def convert_matches(value, klass)

data/lib/lara/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lara-sdk
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Translated
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-31 00:00:00.000000000 Z
+date: 2026-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday