lara-sdk 1.6.1 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a3b69ad7aedd5fba6abf61cd338174f91c6784780afb48ed888f2d6781c225f
-  data.tar.gz: 8f736b1507a97c1da997e8136bf6407de5e3a687c704573397284ea093c4fa2b
+  metadata.gz: 40c690defef56e7663867a644181be99f0a6cc6576abc9b4d7f79e57193c3853
+  data.tar.gz: 6d847c2b8b5caeaef7a45ec6624906a9b26ba29ff3105ea76e2eab7eb4d84adf
 SHA512:
-  metadata.gz: ed938c0f7ddd966f7307cb13c33500931d2e5f87d10cdd4590b999b37b660148b95a7d5e73a73b0d69eafc464eb98a1c8a03e3b533cfd362f8e434aca995db96
-  data.tar.gz: c3b778924d5b7e09ddf9efff21aed919579cf86df566ada5f96a044c043f6bf3e3fc529ee81c2c7f34c84d576f7f628b07a08719fcf1eadbef3dc7becf34e9c5
+  metadata.gz: ec70756013dfda0e007d16fcc2c165836b737017c1a8ad198cfe9d4763694c2a251d069ed9a177d3683b636fdae997a40559a1d6743c8c632387cfa5c628e3bf
+  data.tar.gz: e8672051a95c85a847d66560c5ccbbb16dcbaf2b2d1060f5468d4b609b30cb007b8e1c823c96df2f01259b16da4cd50e5c6272823dec68ba0f90ef00669e608e

data/lib/lara/client.rb

@@ -218,7 +218,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
@@ -57,38 +58,62 @@ module Lara
                                                body: { name: name }).transform_keys(&:to_sym))
     end
 
+    # @return [Lara::Models::GlossaryShares]
+    def get_shares(id)
+      Lara::Models::GlossaryShares.new(**@client.get("/v2/glossaries/#{id}/shares").transform_keys(&:to_sym))
+    end
+
+    def add_account_share(id, name: nil)
+      glossary_from(@client.post("/v2/glossaries/#{id}/shares", body: { name: name }.compact))
+    end
+
+    def rename_account_share(id, name:)
+      glossary_from(@client.put("/v2/glossaries/#{id}/shares", body: { name: name }))
+    end
+
+    def revoke_account_share(id)
+      glossary_from(@client.delete("/v2/glossaries/#{id}/shares"))
+    end
+
+    def add_group_share(id, group_id, name: nil)
+      glossary_from(@client.post("/v2/glossaries/#{id}/shares/groups/#{group_id}", body: { name: name }.compact))
+    end
+
+    def rename_group_share(id, group_id, name:)
+      glossary_from(@client.put("/v2/glossaries/#{id}/shares/groups/#{group_id}", body: { name: name }))
+    end
+
+    def revoke_group_share(id, group_id)
+      glossary_from(@client.delete("/v2/glossaries/#{id}/shares/groups/#{group_id}"))
+    end
+
     # @return [Lara::Models::GlossaryCounts]
     def counts(id)
       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
@@ -96,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))
@@ -117,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(', ')}"
@@ -131,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)
@@ -169,5 +204,11 @@ module Lara
       Lara::Models::GlossaryImport.new(**@client.delete("/v2/glossaries/#{glossary_id}/content",
                                                         body: body).transform_keys(&:to_sym))
     end
+
+    private
+
+    def glossary_from(response)
+      Lara::Models::Glossary.new(**response.transform_keys(&:to_sym))
+    end
   end
 end

data/lib/lara/memories.rb

@@ -69,6 +69,35 @@ module Lara
       models.first
     end
 
+    # @return [Lara::Models::MemoryShares]
+    def get_shares(id)
+      Lara::Models::MemoryShares.new(**@client.get("/v2/memories/#{id}/shares").transform_keys(&:to_sym))
+    end
+
+    def add_account_share(id, name: nil)
+      memory_from(@client.post("/v2/memories/#{id}/shares", body: { name: name }.compact))
+    end
+
+    def rename_account_share(id, name:)
+      memory_from(@client.put("/v2/memories/#{id}/shares", body: { name: name }))
+    end
+
+    def revoke_account_share(id)
+      memory_from(@client.delete("/v2/memories/#{id}/shares"))
+    end
+
+    def add_group_share(id, group_id, name: nil)
+      memory_from(@client.post("/v2/memories/#{id}/shares/groups/#{group_id}", body: { name: name }.compact))
+    end
+
+    def rename_group_share(id, group_id, name:)
+      memory_from(@client.put("/v2/memories/#{id}/shares/groups/#{group_id}", body: { name: name }))
+    end
+
+    def revoke_group_share(id, group_id)
+      memory_from(@client.delete("/v2/memories/#{id}/shares/groups/#{group_id}"))
+    end
+
     # @return [Lara::Models::MemoryImport]
     def add_translation(id_or_ids, source:, target:, sentence:, translation:, tuid: nil,
                         sentence_before: nil, sentence_after: nil, headers: nil)
@@ -115,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))
@@ -166,5 +189,11 @@ module Lara
       end
       current
     end
+
+    private
+
+    def memory_from(response)
+      Lara::Models::Memory.new(**response.transform_keys(&:to_sym))
+    end
   end
 end

data/lib/lara/models/glossaries.rb

@@ -16,7 +16,8 @@ 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
+        # The API sends is_personal: true and omits the key otherwise; it never sends false or null.
+        @is_personal = is_personal || false
       end
     end
 

data/lib/lara/models/memories.rb

@@ -21,7 +21,8 @@ module Lara
         @secret = secret
         @collaborators_count = collaborators_count
         @shared_at = Base.parse_time(shared_at)
-        @is_personal = is_personal
+        # The API sends is_personal: true and omits the key otherwise; it never sends false or null.
+        @is_personal = is_personal || false
       end
     end
 

data/lib/lara/models/shares.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Lara
+  module Models
+    class ResourceShareEntry < Base
+      attr_reader :id, :name, :share_name, :shared_at, :permissions
+
+      def initialize(id:, name:, share_name:, shared_at:, permissions:, **_kwargs)
+        super()
+        @id = id
+        @name = name
+        @share_name = share_name
+        @shared_at = Base.parse_time(shared_at)
+        @permissions = permissions
+      end
+    end
+
+    class MemoryShares < Base
+      attr_reader :memory, :account, :groups, :users
+
+      def initialize(memory:, account: nil, groups: [], users: [], **_kwargs)
+        super()
+        @memory = Memory.new(**memory.transform_keys(&:to_sym))
+        @account = ResourceShareEntry.new(**account.transform_keys(&:to_sym)) if account
+        @groups = groups.map { |entry| ResourceShareEntry.new(**entry.transform_keys(&:to_sym)) }
+        @users = users.map { |entry| ResourceShareEntry.new(**entry.transform_keys(&:to_sym)) }
+      end
+    end
+
+    class GlossaryShares < Base
+      attr_reader :glossary, :account, :groups, :users
+
+      def initialize(glossary:, account: nil, groups: [], users: [], **_kwargs)
+        super()
+        @glossary = Glossary.new(**glossary.transform_keys(&:to_sym))
+        @account = ResourceShareEntry.new(**account.transform_keys(&:to_sym)) if account
+        @groups = groups.map { |entry| ResourceShareEntry.new(**entry.transform_keys(&:to_sym)) }
+        @users = users.map { |entry| ResourceShareEntry.new(**entry.transform_keys(&:to_sym)) }
+      end
+    end
+
+    class StyleguideShares < Base
+      attr_reader :styleguide, :account, :groups, :users
+
+      def initialize(styleguide:, account: nil, groups: [], users: [], **_kwargs)
+        super()
+        @styleguide = Styleguide.new(**styleguide.transform_keys(&:to_sym))
+        @account = ResourceShareEntry.new(**account.transform_keys(&:to_sym)) if account
+        @groups = groups.map { |entry| ResourceShareEntry.new(**entry.transform_keys(&:to_sym)) }
+        @users = users.map { |entry| ResourceShareEntry.new(**entry.transform_keys(&:to_sym)) }
+      end
+    end
+  end
+end

data/lib/lara/models/text.rb

@@ -115,10 +115,10 @@ module Lara
     end
 
     class Styleguide < Base
-      attr_reader :id, :name, :content, :owner_id, :created_at, :updated_at, :is_personal
+      attr_reader :id, :name, :content, :owner_id, :created_at, :updated_at, :shared_at, :is_personal
 
       def initialize(id:, name:, content: nil, owner_id: nil, created_at: nil, updated_at: nil,
-                     is_personal: nil, **_kwargs)
+                     shared_at: nil, is_personal: nil, **_kwargs)
         super()
         @id = id
         @name = name
@@ -126,7 +126,9 @@ module Lara
         @owner_id = owner_id
         @created_at = Base.parse_time(created_at)
         @updated_at = Base.parse_time(updated_at)
-        @is_personal = is_personal
+        @shared_at = Base.parse_time(shared_at)
+        # The API sends is_personal: true and omits the key otherwise; it never sends false or null.
+        @is_personal = is_personal || false
       end
 
       def to_s

data/lib/lara/styleguides.rb

@@ -40,5 +40,40 @@ module Lara
     def delete(id)
       Lara::Models::Styleguide.new(**@client.delete("/v2/styleguides/#{id}").transform_keys(&:to_sym))
     end
+
+    # @return [Lara::Models::StyleguideShares]
+    def get_shares(id)
+      Lara::Models::StyleguideShares.new(**@client.get("/v2/styleguides/#{id}/shares").transform_keys(&:to_sym))
+    end
+
+    def add_account_share(id, name: nil)
+      styleguide_from(@client.post("/v2/styleguides/#{id}/shares", body: { name: name }.compact))
+    end
+
+    def rename_account_share(id, name:)
+      styleguide_from(@client.put("/v2/styleguides/#{id}/shares", body: { name: name }))
+    end
+
+    def revoke_account_share(id)
+      styleguide_from(@client.delete("/v2/styleguides/#{id}/shares"))
+    end
+
+    def add_group_share(id, group_id, name: nil)
+      styleguide_from(@client.post("/v2/styleguides/#{id}/shares/groups/#{group_id}", body: { name: name }.compact))
+    end
+
+    def rename_group_share(id, group_id, name:)
+      styleguide_from(@client.put("/v2/styleguides/#{id}/shares/groups/#{group_id}", body: { name: name }))
+    end
+
+    def revoke_group_share(id, group_id)
+      styleguide_from(@client.delete("/v2/styleguides/#{id}/shares/groups/#{group_id}"))
+    end
+
+    private
+
+    def styleguide_from(response)
+      Lara::Models::Styleguide.new(**response.transform_keys(&:to_sym))
+    end
   end
 end

data/lib/lara/version.rb

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

data/lib/lara.rb

@@ -19,6 +19,7 @@ require_relative "lara/models/base"
 require_relative "lara/models/text"
 require_relative "lara/models/memories"
 require_relative "lara/models/glossaries"
+require_relative "lara/models/shares"
 require_relative "lara/models/documents"
 require_relative "lara/models/images"
 require_relative "lara/models/audio"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lara-sdk
 version: !ruby/object:Gem::Version
-  version: 1.6.1
+  version: 1.8.0
 platform: ruby
 authors:
 - Translated
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-25 00:00:00.000000000 Z
+date: 2026-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -165,6 +165,7 @@ files:
 - lib/lara/models/glossaries.rb
 - lib/lara/models/images.rb
 - lib/lara/models/memories.rb
+- lib/lara/models/shares.rb
 - lib/lara/models/text.rb
 - lib/lara/s3_client.rb
 - lib/lara/styleguides.rb