lara-sdk 1.5.0 → 1.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 260e413029ef25a896fb6eb641e9ca827fca770534b9510abf7ce95f6f7f9692
-  data.tar.gz: 27c8ffbed846d88f167a67ba5ba2c178528fcf47246f3288c25bd2e0e2cb773d
+  metadata.gz: 16d7ebfcc581f7cf377274d58579d0d306eb98c83907c28de3de277fefe0c40f
+  data.tar.gz: 5ae057fa1538580898d922d41f387fcd6d583726eb98fde453811f0fc0d6a3de
 SHA512:
-  metadata.gz: '0874bcc119ba9fb65b3deb2604fc5581b48022b3a4849a5faeeb61c48357baedb77d41d1523b31d5bbdf28e700f21fb2dd63c3e903aae9ed5dd9f47215c52974'
-  data.tar.gz: 88a93cf1701ba776261cec4dca86ff8468e46aec29e5328babb6912103b392c25c66935bea20c53e3a5ae804e398a5581125d50c5a70b460301fd4f3847d2ae7
+  metadata.gz: 61f703c0ac1fa6059d3f58181ba65d1252a687085e7106b808377da35c13aa7b8f1380d612e451e0e1d2d1dbf734e21cce9cae409fc522d8dca113890a19161b
+  data.tar.gz: be6e69b110dbeefe2093f47aa8e741dd6d4c8fe014b4b3c0b3e66cc4929d313a8832cf5f93c4d7c0af50e18ba11d6d592f8f0bb5a059d7d71437de5fbd64d7be

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

@@ -64,7 +64,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 +89,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 +112,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
@@ -160,8 +162,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 +186,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 +247,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 +257,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/glossaries.rb

@@ -18,6 +18,7 @@ module Lara
         all.include?(format)
       end
     end
+
     def initialize(client)
       @client = client
       @polling_interval = 2
@@ -62,26 +63,35 @@ module Lara
     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
+    # @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: true)
+    def import_csv(id, csv_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
 
-      require "stringio"
-      require "zlib"
       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
 
-      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" }
       body["content_type"] = content_type unless content_type == FileFormat::UNIDIRECTIONAL
-
-      files = { "csv" => Faraday::UploadIO.new(buffer, "application/gzip", "#{basename}.gz") }
+      body["callback_url"] = callback_url if callback_url
       Lara::Models::GlossaryImport.new(**@client.post("/v2/glossaries/#{id}/import",
                                                       body: body, files: files).transform_keys(&:to_sym))
     end
@@ -120,6 +130,21 @@ module Lara
                   params: { content_type: content_type, source: source }.compact)
     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)
+    # @return [Lara::Models::GlossaryExport]
+    def export_async(id, callback_url:, content_type: FileFormat::UNIDIRECTIONAL, source: nil)
+      unless FileFormat.valid?(content_type)
+        raise ArgumentError, "Invalid content_type. Supported formats: #{FileFormat.all.join(', ')}"
+      end
+
+      params = { callback_url: callback_url, content_type: content_type }
+      params[:source] = source if source
+      Lara::Models::GlossaryExport.new(**@client.get("/v2/glossaries/#{id}/export/async",
+                                                     params: params).transform_keys(&:to_sym))
+    end
+
     # @param glossary_id [String] The glossary ID
     # @param terms [Array<Hash>] Array of term hashes with :language and :value keys
     # @param guid [String, nil] Optional unique identifier for multidirectional glossary units
@@ -128,7 +153,8 @@ module Lara
       body = { terms: terms }
       body[:guid] = guid if guid
 
-      Lara::Models::GlossaryImport.new(**@client.put("/v2/glossaries/#{glossary_id}/content", body: body).transform_keys(&:to_sym))
+      Lara::Models::GlossaryImport.new(**@client.put("/v2/glossaries/#{glossary_id}/content",
+                                                     body: body).transform_keys(&:to_sym))
     end
 
     # @param glossary_id [String] The glossary ID
@@ -140,7 +166,8 @@ module Lara
       body[:guid] = guid if guid
       body[:term] = term if term
 
-      Lara::Models::GlossaryImport.new(**@client.delete("/v2/glossaries/#{glossary_id}/content", body: body).transform_keys(&:to_sym))
+      Lara::Models::GlossaryImport.new(**@client.delete("/v2/glossaries/#{glossary_id}/content",
+                                                        body: body).transform_keys(&:to_sym))
     end
   end
 end

data/lib/lara/models/glossaries.rb

@@ -43,5 +43,14 @@ module Lara
         @multidirectional = multidirectional
       end
     end
+
+    class GlossaryExport < Base
+      attr_reader :job_id
+
+      def initialize(job_id:, **_kwargs)
+        super()
+        @job_id = job_id
+      end
+    end
   end
 end

data/lib/lara/version.rb

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

metadata

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