blocks-sdk 0.1.0

data/lib/blocks/sdk.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require_relative "sdk/version"
+require_relative "sdk/configuration"
+require_relative "sdk/base_client"
+require_relative "sdk/service_manager"
+require_relative "sdk/rails" if defined?(Rails)
+require_relative "sdk/rails/railtie" if defined?(Rails)
+
+module Blocks
+  module Sdk
+    class Error < StandardError; end
+
+    class << self
+      attr_writer :configuration, :service_manager
+
+      def configuration
+        @configuration ||= Configuration.new
+      end
+
+      # Alias for configuration for convenience
+      def config
+        configuration
+      end
+
+      def configure
+        yield(configuration) if block_given?
+        configuration
+      end
+
+      def service_manager
+        @service_manager ||= ServiceManager.new
+      end
+
+      # Load translations into cache on Rails boot
+      # This method should be called after Rails initialization
+      # It fetches translations for all configured modules and languages
+      def load_translations_on_boot
+        return unless defined?(Rails)
+        return unless configuration.cache_enabled
+
+        # Get modules and languages from configuration or environment
+        modules   = translation_modules
+        languages = translation_languages
+
+        modules.each do |module_name|
+          languages.each do |language|
+            begin
+              service_manager.fetch(
+                service_name: "translations",
+                params: { module_name: module_name, language: language },
+                config: {
+                  base_url: configuration.uilm_base_url,
+                  project_key: configuration.uilm_project_key
+                }
+              )
+            rescue StandardError => e
+              log_error("Failed to load translations for #{module_name} (#{language}): #{e.message}")
+            end
+          end
+        end
+      end
+
+      private
+
+      def translation_modules
+        explicit = Array(configuration.translation_modules).map(&:to_s).reject(&:empty?)
+        return explicit if explicit.any?
+
+        modules_env = ENV.fetch("BLOCKS_TRANSLATION_MODULES", "")
+        return [] if modules_env.nil? || modules_env.strip.empty?
+
+        modules_env.split(",").map(&:strip).reject(&:empty?)
+      end
+
+      def translation_languages
+        explicit = Array(configuration.translation_languages).map(&:to_s).reject(&:empty?)
+        return explicit if explicit.any?
+
+        languages_env = ENV.fetch("BLOCKS_TRANSLATION_LANGUAGES", "")
+        if languages_env.nil? || languages_env.strip.empty?
+          return default_translation_languages
+        end
+
+        languages_env.split(",").map(&:strip).reject(&:empty?)
+      end
+
+      # Defaults to every locale I18n knows about plus the current/default
+      # locale, so boot-time fetching covers the whole app — not just :en.
+      def default_translation_languages
+        return ["en"] unless defined?(::I18n)
+
+        available = Array(::I18n.available_locales).map(&:to_s)
+        current   = ::I18n.respond_to?(:locale) ? ::I18n.locale.to_s : nil
+        default   = ::I18n.respond_to?(:default_locale) ? ::I18n.default_locale.to_s : nil
+
+        ([current, default] + available).compact.reject(&:empty?).uniq
+      end
+
+      def log_error(message)
+        if configuration.logger
+          configuration.logger.error(message)
+        elsif defined?(Rails) && Rails.logger
+          Rails.logger.error(message)
+        else
+          warn(message)
+        end
+      end
+    end
+  end
+end

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "3.4.8"

data/sig/blocks/sdk.rbs

@@ -0,0 +1,6 @@
+module Blocks
+  module Sdk
+    VERSION: String
+    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  end
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: blocks-sdk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- bugloper
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: SDK for working with Blocks
+email:
+- bugloper@hey.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- docs/ARCHITECTURE.md
+- lib/blocks/sdk.rb
+- lib/blocks/sdk/base_client.rb
+- lib/blocks/sdk/cache/memory_cache.rb
+- lib/blocks/sdk/clients/translations_client.rb
+- lib/blocks/sdk/configuration.rb
+- lib/blocks/sdk/rails.rb
+- lib/blocks/sdk/rails/controllers/api/translations_controller.rb
+- lib/blocks/sdk/rails/controllers/translations_webhooks_controller.rb
+- lib/blocks/sdk/rails/i18n_backend.rb
+- lib/blocks/sdk/rails/initializer.rb
+- lib/blocks/sdk/rails/railtie.rb
+- lib/blocks/sdk/rails/routes.rb
+- lib/blocks/sdk/rails/translations_route_mapper.rb
+- lib/blocks/sdk/service_manager.rb
+- lib/blocks/sdk/version.rb
+- mise.toml
+- sig/blocks/sdk.rbs
+homepage: https://github.com/selise/l0-ruby-blocks-sdk
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/selise/l0-ruby-blocks-sdk
+  changelog_uri: https://github.com/selise/l0-ruby-blocks-sdk/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Blocks SDK for Ruby
+test_files: []