eluvia-base 3.37.1

data/lib/eluvia/utils/hash_and_array.rb

@@ -0,0 +1,98 @@
+class Object
+
+  # Deep integerize keys
+  def deep_integerize_keys
+    if self.is_a?(::Hash)
+      self.each_with_object({}) { |(k, v), memo|
+        memo[k.to_i] = v.deep_integerize_keys
+      }
+    elsif self.is_a?(::Array)
+      self.each_with_object([]) { |v, memo|
+        memo << v.deep_integerize_keys
+      }
+    else
+      self
+    end
+  end
+
+  # Deep snake case keys
+  def deep_snake_keys
+    if self.is_a?(::Hash)
+      self.each_with_object({}) { |(k, v), memo|
+        memo[k.to_s.underscore] = v.deep_snake_keys
+      }
+    elsif self.is_a?(::Array)
+      self.each_with_object([]) { |v, memo|
+        memo << v.deep_snake_keys
+      }
+    else
+      self
+    end
+  end
+
+  # Deep camel case keys
+  def deep_camel_keys
+    if self.is_a?(::Hash)
+      self.each_with_object({}) { |(k, v), memo|
+        memo[k.to_s.camelize] = v.deep_camel_keys
+      }
+    elsif self.is_a?(::Array)
+      self.each_with_object([]) { |v, memo|
+        memo << v.deep_camel_keys
+      }
+    else
+      self
+    end
+  end
+
+  COMPACTABLE = [nil, [], {}].freeze
+
+  def deep_compact(compactable: COMPACTABLE)
+    if self.is_a?(::Array)
+      self.each_with_object([]) do |v, a|
+        v = v.deep_compact(compactable: compactable)
+        a << v unless compactable.include?(v)
+      end
+    elsif self.is_a?(::Hash)
+      self.each_with_object({}) do |(k, v), h|
+        v = v.deep_compact(compactable: compactable)
+        h[k] = v unless compactable.include?(v)
+      end
+    else
+      self
+    end
+  end
+
+end
+
+class Hash
+
+  # Convert all keys in hash into integers
+  def integerize_keys
+    self.each_with_object({}) { |(k, v), memo|
+      memo[k.to_i] = v
+    }
+  end
+
+  # Convert all keys in hash into snake case
+  def snake_keys
+    self.each_with_object({}) { |(k, v), memo|
+      memo[k.to_s.underscore] = v
+    }
+  end
+
+  # Convert all keys in hash into camel case
+  def camel_keys
+    self.each_with_object({}) { |(k, v), memo|
+      memo[k.to_s.camelize] = v
+    }
+  end
+
+  # Deep merging of hashes
+  # By Stefan Rusterholz, see http://www.ruby-forum.com/topic/142809
+  def deep_merge!(other_hash)
+    merger = proc { |_k, v1, v2| v1.is_a?(::Hash) && v2.is_a?(::Hash) ? v1.merge(v2, &merger) : v2 }
+    self.merge!(other_hash, &merger)
+  end
+
+end

data/lib/eluvia/utils/jwt.rb

@@ -0,0 +1,36 @@
+require 'jwt'
+require 'json'
+
+module Eluvia
+  module Jwt
+
+    def self.encode_private_jwt_token(exp = 1.hours.from_now)
+      payload = { token_type: 'private_token' }
+      encode_jwt_token(payload, exp)
+    end
+
+    def self.encode_public_jwt_token(user, exp = 1.hours.from_now)
+      payload = { token_type: 'access', user: JSON.parse(user.to_json) }
+      encode_jwt_token(payload, exp)
+    end
+
+    def self.encode_jwt_token(payload, exp = 1.hours.from_now)
+      payload[:exp] = exp.to_i
+      if Eluvia::Base::Config.secure_jwt
+        payload[:iat] = Time.now.to_i
+        payload[:jti] = SecureRandom.uuid
+      end
+      JWT.encode(payload, get_secret_key)
+    end
+
+    def self.decode_jwt_token(token)
+      decoded = JWT.decode(token, get_secret_key)[0]
+      HashWithIndifferentAccess.new(decoded)
+    end
+
+    def self.get_secret_key
+      Eluvia::Base::Config.private_api_key.to_s
+    end
+
+  end
+end

data/lib/eluvia/utils/string.rb

@@ -0,0 +1,31 @@
+class String
+
+  def to_filename
+    result = self
+    result = I18n.transliterate(result)
+    result
+      .downcase
+      .gsub(/[^a-z0-9.\s,\-_]/, "")
+      .gsub(/[.\s,\-_]+/, "-")
+      .sub(/^-*/, "")
+      .sub(/-*$/, "")
+  end
+
+  # Remove characters from string on the left and right side
+  def trim(chars = "\s")
+    self
+      .sub(/^[#{Regexp.escape(chars)}]*/, "")
+      .sub(/[#{Regexp.escape(chars)}]*$/, "")
+  end
+
+  # Remove characters from string on the left side
+  def ltrim(chars = "\s")
+    self.sub(/^[#{Regexp.escape(chars)}]*/, "")
+  end
+
+  # Remove characters from string on the right side
+  def rtrim(chars = "\s")
+    self.sub(/[#{Regexp.escape(chars)}]*$/, "")
+  end
+
+end

data/lib/eluvia/utils/uuid.rb

@@ -0,0 +1,21 @@
+require 'consistent_hash'
+require 'uuidtools'
+
+module Eluvia
+  module Uuid
+
+    NAMESPACE = UUIDTools::UUID.parse(Eluvia::Base::Config.uuid_seed)
+
+    def self.str_to_uuid(str)
+      UUIDTools::UUID.sha1_create(NAMESPACE, str.to_s).to_s
+    end
+
+    def self.str_to_uuid_v2(str)
+      generator = Random.new(str.consistent_hash.abs)
+      ary = generator.bytes(16)
+      ary.setbyte(6, (ary.getbyte(6) & 0x0f) | 0x40)
+      ary.setbyte(8, (ary.getbyte(8) & 0x3f) | 0x80)
+      ary.unpack("H8H4H4H4H12").join('-')
+    end
+  end
+end

data/lib/eluvia-base.rb

@@ -0,0 +1,79 @@
+# Config
+require 'eluvia/base/config'
+
+# Version
+require 'eluvia/base/version'
+
+# Uploads
+require 'eluvia/uploads'
+
+# Active model
+require 'eluvia/active_model/attributes'
+require 'eluvia/active_model/amount_attribute'
+require 'eluvia/active_model/array_attribute'
+require 'eluvia/active_model/enum_attribute'
+require 'eluvia/active_model/enum_array_attribute' # depends on enum_attribute and array_attribute
+require 'eluvia/active_model/object_attribute'
+require 'eluvia/active_model/range_attribute' # depends on object_attribute
+
+# Active record
+require 'eluvia/active_record/file_array_attribute'
+require 'eluvia/active_record/file_attribute'
+require 'eluvia/active_record/filtering'
+require 'eluvia/active_record/filters_model'
+require 'eluvia/active_record/ordering'
+
+# Errors
+require 'eluvia/errors/standard_error'
+require 'eluvia/errors/bad_request'
+require 'eluvia/errors/forbidden'
+require 'eluvia/errors/not_found'
+require 'eluvia/errors/service_unavailable'
+require 'eluvia/errors/unauthorized'
+require 'eluvia/errors/unprocessable_entity'
+
+# Fieldset
+require 'eluvia/fieldset'
+
+# Helpers
+require 'eluvia/helpers/attachment_helper'
+
+# Handlers
+require 'eluvia/handlers/error_handler'
+require 'eluvia/handlers/pagination_handler'
+require 'eluvia/handlers/params_handler'
+
+# Integrations
+require 'eluvia/integrations/eluvia_integration'
+
+# Models
+require 'eluvia/models/file'
+require 'eluvia/models/file_wrapper'
+require 'eluvia/models/image_wrapper'
+
+# Services
+require 'eluvia/services/health_service'
+
+# Serializers
+require 'eluvia/serializers/error_serializer'
+require 'eluvia/serializers/fieldset_serializer'
+
+# Utils
+require 'eluvia/utils/hash_and_array'
+require 'eluvia/utils/jwt'
+require 'eluvia/utils/string'
+require 'eluvia/utils/uuid'
+
+module Eluvia
+  module Base
+
+    # ***************************************************************************
+    # Configuration
+    # ***************************************************************************
+
+    def self.setup
+      yield Eluvia::Base::Config
+    end
+
+  end
+end

metadata

@@ -0,0 +1,186 @@
+--- !ruby/object:Gem::Specification
+name: eluvia-base
+version: !ruby/object:Gem::Version
+  version: 3.37.1
+platform: ruby
+authors:
+- Matěj Outlý
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-08-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.10'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.19'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: consistent_hash
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+- !ruby/object:Gem::Dependency
+  name: uuidtools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: This library provides a set of Ruby on Rails customizations and other
+  helpers in order to meet common Eluvia standards for API communication and Eluvia
+  requirements for backend application behavior.
+email:
+- matej.outly@eluvia.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/eluvia-base.rb
+- lib/eluvia/active_model/amount_attribute.rb
+- lib/eluvia/active_model/array_attribute.rb
+- lib/eluvia/active_model/attributes.rb
+- lib/eluvia/active_model/enum_array_attribute.rb
+- lib/eluvia/active_model/enum_attribute.rb
+- lib/eluvia/active_model/object_attribute.rb
+- lib/eluvia/active_model/range_attribute.rb
+- lib/eluvia/active_record/file_array_attribute.rb
+- lib/eluvia/active_record/file_attribute.rb
+- lib/eluvia/active_record/filtering.rb
+- lib/eluvia/active_record/filters_model.rb
+- lib/eluvia/active_record/ordering.rb
+- lib/eluvia/base/config.rb
+- lib/eluvia/base/version.rb
+- lib/eluvia/errors/bad_request.rb
+- lib/eluvia/errors/forbidden.rb
+- lib/eluvia/errors/not_found.rb
+- lib/eluvia/errors/service_unavailable.rb
+- lib/eluvia/errors/standard_error.rb
+- lib/eluvia/errors/unauthorized.rb
+- lib/eluvia/errors/unprocessable_entity.rb
+- lib/eluvia/fieldset.rb
+- lib/eluvia/fieldset/rest_field.rb
+- lib/eluvia/fieldset/rest_fieldset.rb
+- lib/eluvia/handlers/error_handler.rb
+- lib/eluvia/handlers/pagination_handler.rb
+- lib/eluvia/handlers/params_handler.rb
+- lib/eluvia/helpers/attachment_helper.rb
+- lib/eluvia/integrations/eluvia_integration.rb
+- lib/eluvia/models/file.rb
+- lib/eluvia/models/file_wrapper.rb
+- lib/eluvia/models/image_wrapper.rb
+- lib/eluvia/serializers/error_serializer.rb
+- lib/eluvia/serializers/fieldset_serializer.rb
+- lib/eluvia/services/health_service.rb
+- lib/eluvia/uploads.rb
+- lib/eluvia/utils/hash_and_array.rb
+- lib/eluvia/utils/jwt.rb
+- lib/eluvia/utils/string.rb
+- lib/eluvia/utils/uuid.rb
+homepage: https://gitlab.eluvia.dev/libraries/ruby/eluvia-base
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.33
+signing_key: 
+specification_version: 4
+summary: Base library for Eluvia applications
+test_files: []