lara-sdk 1.2.1 → 1.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20907c5322ca25cec94d4475f543ba03a04f611c8707711ca5b188b1aac5d708
-  data.tar.gz: 41f47a2c9a56145711d5275a9f8db3b1dc9a66e3b514d4d4106cbf2fa69bcb8e
+  metadata.gz: 99781bcccbdde09ccc8c153f32683bf08e57be3aee65d82a0037f2d3e7daaf3a
+  data.tar.gz: 21041bbad4d3d3b2d269d40daded257d3b1879fdf9eea347314cec81b8618dd0
 SHA512:
-  metadata.gz: 323a5b9dbe032b6cc66ca30f42cf599ebd451f29b87c9a7fa7ed0f98769b91a952c57ece507d4bf9a9a120159364c6c224059a4b7a4a09b76ec65c3a0e50f078
-  data.tar.gz: 6123b7826259215d940b6e06e75b912756f9351cf750837e793059488472dac3ff3fc47906a4e6922b966873ea9803e240e588d9e9cf80f8c67509e3798136a0
+  metadata.gz: '01785a1e0afe2ce5de1e6f49a617ccd7d43749109e818957c984bca81598e170da652830fbf8662366a6217cf328ded0eafd76cd266d26ab90e31492add28dbf'
+  data.tar.gz: 65de8ac4120d2ef3af4e5e584da1bc337b70d6abd8848dc41c3dd21dafe9e511b0519a2a4bc60c7a91b744eb39a0739340c8c18bbe9f20b59b033618d806c616

data/lib/lara/client.rb

@@ -228,12 +228,7 @@ module Lara
     def parse_json(body)
       return {} if body.nil? || body.empty?
 
-      parsed = JSON.parse(body)
-      if parsed.is_a?(Hash) && parsed.key?("content")
-        inner = parsed["content"]
-        return inner if inner.is_a?(Hash) || inner.is_a?(Array)
-      end
-      parsed
+      JSON.parse(body)
     end
 
     def parse_stream_response(body, &block)
@@ -252,8 +247,7 @@ module Lara
         next if trimmed_line.empty?
 
         begin
-          parsed = JSON.parse(trimmed_line)
-          result = parsed["content"] || parsed
+          result = JSON.parse(trimmed_line)
           block.call(result) if block
           last_result = result
         rescue JSON::ParserError
@@ -263,8 +257,7 @@ module Lara
 
       if !buffer.empty? && buffer.strip != ""
         begin
-          parsed = JSON.parse(buffer.strip)
-          result = parsed["content"] || parsed
+          result = JSON.parse(buffer.strip)
           block.call(result) if block
           last_result = result
         rescue JSON::ParserError

data/lib/lara/errors.rb

@@ -17,19 +17,14 @@ module Lara
   class LaraApiError < LaraError
     attr_reader :type
 
-    # Builds an error from an HTTP response with JSON body.
-    # Supports both { "error": { "type": "...", "message": "..." } }
-    # and { "type": "...", "message": "..." } response formats.
+    # Builds an error from an HTTP response with JSON body { "type": "...", "message": "..." }.
     def self.from_response(response)
       data = begin
         JSON.parse(response.body)
       rescue StandardError
         {}
       end
-      error = data["error"] || data
-      error_type = error["type"] || "UnknownError"
-      error_message = error["message"] || "An unknown error occurred"
-      new(response.status, error_type, error_message)
+      new(response.status, data["type"] || "UnknownError", data["message"] || "An unknown error occurred")
     end
 
     # @param status_code [Integer]

data/lib/lara/memories.rb

@@ -2,6 +2,23 @@
 
 module Lara
   class Memories
+    # Supported memory export formats
+    module ExportFormat
+      TMX = "tmx"
+      JTM = "jtm"
+
+      # @return [Array<String>] All supported formats
+      def self.all
+        [TMX, JTM]
+      end
+
+      # @param format [String] The format to validate
+      # @return [Boolean] True if the format is supported
+      def self.valid?(format)
+        all.include?(format)
+      end
+    end
+
     def initialize(client)
       @client = client
       @polling_interval = 2
@@ -99,7 +116,7 @@ module Lara
     end
 
     # @return [Lara::Models::MemoryImport]
-    def import_tmx(id, tmx_path)
+    def import_tmx(id, tmx_path, callback_url: nil)
       require "stringio"
       require "zlib"
       basename = File.basename(tmx_path)
@@ -111,8 +128,22 @@ module Lara
       buffer.rewind
 
       files = { "tmx" => Faraday::UploadIO.new(buffer, "application/gzip", "#{basename}.gz") }
+      body = { "compression" => "gzip" }
+      body["callback_url"] = callback_url if callback_url
       Lara::Models::MemoryImport.new(**@client.post("/v2/memories/#{id}/import",
-                                                    body: { "compression" => "gzip" }, files: files).transform_keys(&:to_sym))
+                                                    body: body, files: files).transform_keys(&:to_sym))
+    end
+
+    # @param format [String,nil] One of Lara::Memories::ExportFormat constants
+    # @return [Lara::Models::MemoryExport]
+    def export_async(id, format: nil, callback_url:)
+      if format && !ExportFormat.valid?(format)
+        raise ArgumentError, "Invalid format '#{format}'. Must be one of: #{ExportFormat.all.join(', ')}"
+      end
+
+      params = { callback_url: callback_url }
+      params[:format] = format if format
+      Lara::Models::MemoryExport.new(**@client.get("/v2/memories/#{id}/export/async", params: params).transform_keys(&:to_sym))
     end
 
     # @return [Lara::Models::MemoryImport]

data/lib/lara/models/glossaries.rb

@@ -16,7 +16,7 @@ module Lara
         @created_at = Base.parse_time(created_at)
         @updated_at = Base.parse_time(updated_at)
         @shared_at = Base.parse_time(shared_at)
-        @is_personal = is_personal.nil? ? _kwargs[:isPersonal] : is_personal
+        @is_personal = is_personal
       end
     end
 

data/lib/lara/models/memories.rb

@@ -21,7 +21,7 @@ module Lara
         @secret = secret
         @collaborators_count = collaborators_count
         @shared_at = Base.parse_time(shared_at)
-        @is_personal = is_personal.nil? ? _kwargs[:isPersonal] : is_personal
+        @is_personal = is_personal
       end
     end
 
@@ -38,5 +38,14 @@ module Lara
         @progress = progress
       end
     end
+
+    class MemoryExport < Base
+      attr_reader :job_id
+
+      def initialize(job_id:, **_kwargs)
+        super()
+        @job_id = job_id
+      end
+    end
   end
 end

data/lib/lara/models/text.rb

@@ -52,9 +52,9 @@ module Lara
     end
 
     class ProfanityDetectResult < Base
-      attr_reader :masked_text, :profanities
+      attr_reader :masked_text, :profanities, :error
 
-      def initialize(masked_text:, profanities: [])
+      def initialize(masked_text:, profanities: [], error: nil)
         super()
         @masked_text = masked_text
         @profanities = profanities.map do |p|
@@ -65,6 +65,22 @@ module Lara
             score: p["score"] || p[:score]
           )
         end
+        @error = error
+      end
+    end
+
+    # Wraps profanity detection results for both target and (optionally) source text.
+    # Returned in TextResult#profanities when profanities_detect is set.
+    class ProfanitiesResult < Base
+      # @return [ProfanityDetectResult, Array<ProfanityDetectResult, nil>, nil]
+      attr_reader :target
+      # @return [ProfanityDetectResult, Array<ProfanityDetectResult, nil>, nil]
+      attr_reader :source
+
+      def initialize(target: nil, source: nil)
+        super()
+        @target = target
+        @source = source
       end
     end
 
@@ -99,9 +115,10 @@ module Lara
     end
 
     class Styleguide < Base
-      attr_reader :id, :name, :content, :owner_id, :created_at, :updated_at
+      attr_reader :id, :name, :content, :owner_id, :created_at, :updated_at, :is_personal
 
-      def initialize(id:, name:, content: nil, owner_id: nil, created_at: nil, updated_at: nil, **_kwargs)
+      def initialize(id:, name:, content: nil, owner_id: nil, created_at: nil, updated_at: nil,
+                     is_personal: nil, **_kwargs)
         super()
         @id = id
         @name = name
@@ -109,6 +126,7 @@ module Lara
         @owner_id = owner_id
         @created_at = Base.parse_time(created_at)
         @updated_at = Base.parse_time(updated_at)
+        @is_personal = is_personal
       end
 
       def to_s
@@ -215,11 +233,23 @@ module Lara
 
         def convert_profanities(value)
           return nil if value.nil?
+          return nil unless value.is_a?(Hash)
+          return nil unless value.key?("target") || value.key?("source")
+
+          ProfanitiesResult.new(
+            target: parse_profanity_value(value["target"]),
+            source: parse_profanity_value(value["source"])
+          )
+        end
+
+        def parse_profanity_value(value)
+          return nil if value.nil?
 
           if value.is_a?(Hash)
             ProfanityDetectResult.new(
               masked_text: value["masked_text"],
-              profanities: value["profanities"] || []
+              profanities: value["profanities"] || [],
+              error: value["error"]
             )
           elsif value.is_a?(Array)
             value.map do |v|
@@ -227,7 +257,8 @@ module Lara
 
               ProfanityDetectResult.new(
                 masked_text: v["masked_text"],
-                profanities: v["profanities"] || []
+                profanities: v["profanities"] || [],
+                error: v["error"]
               )
             end
           end

data/lib/lara/translator.rb

@@ -56,14 +56,15 @@ module Lara
     # @param reasoning [Boolean] When true with a block, yields partial results during reasoning
     # @param headers [Hash,nil]
     # @param metadata [String, Hash, nil]
-    # @param profanity_filter [String,nil] One of "detect", "avoid", "hide"
+    # @param profanities_detect [String,nil] One of "target", "source_target"
+    # @param profanities_handling [String,nil] One of "detect", "avoid", "hide" (default: "hide" when profanities_detect is set)
     # @yield [Lara::Models::TextResult] Partial translation result (only when reasoning is true)
     # @return [Lara::Models::TextResult] Final translation result
     def translate(text, target:, source: nil, source_hint: nil, adapt_to: nil, glossaries: nil,
                   instructions: nil, content_type: nil, multiline: true, timeout_ms: nil,
                   priority: nil, use_cache: nil, cache_ttl_s: nil, no_trace: false, verbose: false,
                   style: nil, reasoning: false, headers: nil, metadata: nil,
-                  profanity_filter: nil,
+                  profanities_detect: nil, profanities_handling: nil,
                   styleguide_id: nil, styleguide_reasoning: nil,
                   styleguide_explanation_language: nil, &callback)
       q = normalize_text_input(text)
@@ -92,7 +93,8 @@ module Lara
         style: style,
         reasoning: reasoning,
         metadata: metadata,
-        profanity_filter: profanity_filter,
+        profanities_detect: profanities_detect,
+        profanities_handling: profanities_handling,
         styleguide_id: styleguide_id,
         styleguide_reasoning: styleguide_reasoning,
         styleguide_explanation_language: styleguide_explanation_language
@@ -106,7 +108,7 @@ module Lara
                           ->(partial) { callback.call(Lara::Models::TextResult.from_hash(partial)) }
                         end
 
-      result = @client.post("/translate", body: body, headers: request_headers, &stream_callback)
+      result = @client.post("/v2/translate", body: body, headers: request_headers, &stream_callback)
       Lara::Models::TextResult.from_hash(result) if result
     end
 
@@ -145,7 +147,8 @@ module Lara
       result = @client.post("/v2/detect/profanities", body: body)
       Lara::Models::ProfanityDetectResult.new(
         masked_text: result["masked_text"],
-        profanities: result["profanities"] || []
+        profanities: result["profanities"] || [],
+        error: result["error"]
       )
     end
 

data/lib/lara/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lara-sdk
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.4.3
 platform: ruby
 authors:
 - Translated
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-21 00:00:00.000000000 Z
+date: 2026-05-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday