realm-core 0.7.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0f61dae355ea08d78da40bc227540ce47635d09ac0f8645d3f70e1e53201ff54
+  data.tar.gz: 57bfe266b33d2f7744b87af84b14a2bd0d7a3c25c0bfc6b452457488067ad181
+SHA512:
+  metadata.gz: 3568eca1b26cd974a6d860e233cb50d4911e49bd7f61f4d6c43d865e78cbded0d48dd40e6331fa8d46ce3eb8906a7093c797ce340e16e33c4fad441085199c72
+  data.tar.gz: cca39336c0d199d46254e15293439b9e81f401b8e4a586f68eb90658a5e027888f4bce1911dad21dbbd6fb2a6c4c68e4380d47935d1492c962e84a092496f8de

data/lib/realm-core.rb

@@ -0,0 +1,6 @@
+# rubocop:disable Naming/FileName
+# frozen_string_literal: true
+
+require 'realm'
+
+# rubocop:enable Naming/FileName

data/lib/realm.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+Dir[File.join(File.dirname(__FILE__), 'realm', '**', '*.rb')].sort.each do |f|
+  require f
+end
+
+module Realm
+  class << self
+    # Setup realm in test/console
+    def setup(root_module, **options)
+      config = Realm::Config.new(root_module: root_module, **options)
+      Realm::Builder.setup(config)
+    end
+
+    # Bind realm in service/engine
+    def bind(root_module, **options)
+      setup(root_module, **options).tap do |builder|
+        root_module.define_singleton_method(:realm) { builder.runtime }
+      end
+    end
+  end
+end

data/lib/realm/action_handler.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require 'dry-validation'
+require 'active_support/core_ext/module/delegation'
+require 'realm/error'
+require 'realm/mixins/context_injection'
+require 'realm/mixins/repository_helper'
+require 'realm/mixins/aggregate_member'
+require_relative 'action_handler/result'
+
+module Realm
+  class ActionHandler
+    extend Mixins::ContextInjection::ClassMethods
+    include Mixins::AggregateMember
+    include Mixins::RepositoryHelper
+
+    class << self
+      attr_reader :contracts
+
+      def call(action: :handle, params: {}, runtime: nil)
+        new(runtime: runtime).(action: action, params: params)
+      end
+
+      protected
+
+      def require_permission(*names)
+        # TODO: implement
+      end
+
+      def contract(&block)
+        @method_contract = Class.new(Dry::Validation::Contract, &block).new
+      end
+
+      def contract_schema(&block)
+        contract { schema(&block) }
+      end
+
+      def contract_params(&block)
+        contract { params(&block) }
+      end
+
+      def contract_json(&block)
+        contract { json(&block) }
+      end
+
+      def method_added(method_name)
+        super
+        return unless defined?(@method_contract)
+
+        @contracts ||= {}
+        @contracts[method_name] = @method_contract
+        remove_instance_variable(:@method_contract)
+      end
+    end
+
+    def initialize(runtime: nil)
+      @runtime = runtime
+    end
+
+    def call(action: :handle, params: {})
+      # TODO: check permissions
+      raise CannotHandleAction.new(self, action) unless respond_to?(action)
+
+      safe_params = validate(action, params.to_h)
+      send(action, **safe_params)
+    end
+
+    protected
+
+    delegate :context, to: :@runtime
+
+    private
+
+    def validate(action, params)
+      contract = self.class.contracts && self.class.contracts[action]
+      return params unless contract
+
+      result = contract.(params)
+      raise Realm::InvalidParams, result if result.failure?
+
+      result.to_h
+    end
+  end
+end

data/lib/realm/action_handler/result.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Realm
+  class ActionHandler
+    # Tuple of label and value
+    class Result < Array
+      def self.[](first, second = nil)
+        return new(first, second).freeze if first.is_a?(Symbol) || first.is_a?(Realm::Event)
+
+        new(second || :ok, first).freeze
+      end
+
+      def label
+        self[0]
+      end
+
+      def event
+        label if label.is_a?(Realm::Event)
+      end
+
+      def value
+        self[1]
+      end
+
+      private
+
+      def initialize(label, value)
+        super([label, value])
+      end
+    end
+  end
+end

data/lib/realm/builder.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/string'
+require 'realm/container'
+require 'realm/runtime'
+require 'realm/domain_resolver'
+require 'realm/persistence'
+require 'realm/dispatcher'
+require 'realm/event_router'
+require 'realm/plugin'
+
+module Realm
+  class Builder
+    def self.setup(config)
+      new(config).setup
+    end
+
+    def initialize(config)
+      @config = config
+    end
+
+    def setup
+      logger.info("Setting up #{cfg.root_module} realm")
+      register_domain_resolver
+      register_event_router
+      register_runtime
+      register_logger
+      register_dependencies
+      setup_plugins
+      config_persistence
+      self
+    end
+
+    def runtime
+      @container.resolve(Runtime)
+    end
+
+    private
+
+    def register_domain_resolver
+      container.register_factory(DomainResolver, constantize(cfg.domain_module))
+    end
+
+    def register_event_router
+      return if cfg.event_gateways.empty?
+
+      container.register_factory(EventRouter, cfg.event_gateways, prefix: cfg.prefix)
+    end
+
+    def register_runtime
+      container.register_factory(Runtime, container)
+    end
+
+    def register_logger
+      container.register(:logger, logger)
+    end
+
+    def register_dependencies
+      container.register_all(**cfg.dependencies)
+    end
+
+    def setup_plugins
+      Plugin.descendants.each do |plugin|
+        plugin.setup(cfg, container) if cfg.plugins.include?(plugin.plugin_name)
+      end
+    end
+
+    def config_persistence
+      return unless cfg.persistence_gateway.present?
+
+      Persistence.setup(container, cfg.persistence_gateway[:repositories])
+    end
+
+    def constantize(*parts)
+      return parts[0] unless parts[0].is_a?(String)
+
+      parts.join('::').safe_constantize
+    end
+
+    def cfg
+      @config
+    end
+
+    def container
+      @container ||= Container.new
+    end
+
+    def logger
+      @logger ||= cfg.logger || (defined?(Rails) && Rails.logger) ||
+                  Logger.new($stdout, level: ENV.fetch('LOG_LEVEL', :info).to_sym)
+    end
+  end
+end

data/lib/realm/command_handler.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/module/delegation'
+require 'active_support/core_ext/string'
+require 'realm/action_handler'
+require 'realm/mixins/reactive'
+
+module Realm
+  class CommandHandler < Realm::ActionHandler
+    include Mixins::Reactive
+
+    def call(*)
+      gateway = context[:rom]&.gateways&.dig(:default)
+      gateway ? gateway.transaction { super } : super
+    end
+
+    protected
+
+    def result(first, second = nil)
+      Result[first, second]
+    end
+  end
+end

data/lib/realm/config.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/string'
+require 'dry-initializer'
+
+module Realm
+  class Config
+    extend Dry::Initializer
+
+    option :root_module
+    option :database_url,         default: proc {}
+    option :prefix,               default: proc {}
+    option :namespace,            default: proc { root_module.to_s.underscore }
+    option :domain_module,        default: proc { "#{root_module}::Domain" }
+    option :engine_class,         default: proc { "#{root_module}::Engine" }
+    option :engine_path,          default: proc { engine_class&.to_s&.safe_constantize&.root }
+    option :logger,               default: proc {}
+    option :plugins,              default: proc { [] }, reader: false
+    option :dependencies,         default: proc { {} }
+    option :persistence_gateway,  default: proc { database_url && { type: :rom, url: database_url } }, reader: false
+    option :event_gateway,        default: proc {}, reader: false
+    option :event_gateways,       default: proc {
+      @event_gateway ? { default: { **@event_gateway, default: true } } : {}
+    }
+
+    def plugins
+      Array(@plugins)
+    end
+
+    def persistence_gateway
+      return {} unless @persistence_gateway
+
+      class_path = engine_path && "#{engine_path}/app/persistence/#{namespace}"
+      repos_path = class_path && "#{class_path}/repositories"
+      repos_module = "#{root_module}::Repositories"
+      {
+        root_module: root_module,
+        class_path: class_path,
+        repos_path: repos_path,
+        repos_module: repos_module,
+        migration_path: engine_path && "#{engine_path}/db/migrate",
+        repositories: repositories(repos_path, repos_module),
+      }.merge(@persistence_gateway)
+    end
+
+    private
+
+    def repositories(repos_path, repos_module)
+      return [] unless repos_path
+
+      Dir[File.join(repos_path, '**', '*.rb')].each_with_object([]) do |filename, all|
+        matches = %r{^#{repos_path}/(.+)\.rb$}.match(filename)
+        all << "#{repos_module}::#{matches[1].camelize}".constantize if matches
+      end
+    end
+  end
+end

data/lib/realm/container.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require 'dry-container'
+require 'active_support/core_ext/string'
+require 'active_support/core_ext/object/try'
+require 'realm/error'
+
+module Realm
+  class Container
+    include Dry::Container::Mixin
+    include Enumerable
+
+    def self.[](object)
+      object.is_a?(Container) ? object : Container.new(object)
+    end
+
+    def initialize(hash = {})
+      register_all(hash)
+    end
+
+    def register(key, contents = nil, options = {}, &block)
+      options[:klass] ||= contents.class if contents && !contents.is_a?(::Hash)
+      super(key, contents, options, &block)
+    end
+
+    def register_all(hash)
+      hash.each_pair do |key, value|
+        register(key, value)
+      end
+    end
+
+    def register_factory(klass, *args, as: nil, memoize: true, **kwargs) # rubocop:disable Naming/MethodParameterName
+      register(as || klass, klass: klass, memoize: memoize) do
+        create(klass, *args, **kwargs)
+      end
+    end
+
+    def create(klass, *args, **kwargs)
+      (klass.try(:dependencies) || []).each do |d|
+        fn = -> { resolve_dependable(sanitize_dependable(d.dependable), d.optional?) }
+        kwargs[d.name] = d.lazy? ? fn : fn.call
+      end
+      klass.new(*args, **kwargs)
+    end
+
+    def [](key)
+      resolve(key) if key?(key)
+    end
+
+    def resolve_all(klass)
+      _container.each_with_object([]) do |(_, item), all|
+        all << item.call if item.options[:klass] <= klass
+      end
+    end
+
+    private
+
+    def sanitize_dependable(dependable)
+      dependable.is_a?(String) && dependable.match(/^[A-Z]/) ? dependable.constantize : dependable
+    end
+
+    def resolve_dependable(dependable, optional)
+      raise DependencyMissing, dependable unless optional || key?(dependable)
+
+      self[dependable]
+    end
+  end
+end

data/lib/realm/context.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'realm/container'
+
+module Realm
+  class Context
+    include Enumerable
+
+    def initialize(*containers)
+      @containers = containers.map { |c| Container[c] }
+    end
+
+    def [](name)
+      @containers.each do |container|
+        return container[name] if container.key?(name)
+      end
+      nil
+    end
+
+    def key?(name)
+      @containers.any? { |container| container.key?(name) }
+    end
+
+    def merge(container_like)
+      container_like.blank? ? self : self.class.new(container_like, *@containers)
+    end
+
+    def each(&block)
+      @containers.each { |container| container.each(&block) }
+    end
+
+    # Just for testing
+    def override!(container)
+      @containers.prepend(container)
+    end
+  end
+end

data/lib/realm/dependency.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/string'
+
+module Realm
+  class Dependency
+    attr_reader :dependable, :name
+
+    def initialize(dependable, as: nil, optional: false, lazy: false) # rubocop:disable Naming/MethodParameterName
+      @dependable = dependable
+      @name = as || dependable.to_s.demodulize.underscore.to_sym
+      @optional = optional
+      @lazy = lazy
+    end
+
+    def optional?
+      @optional
+    end
+
+    def lazy?
+      @lazy
+    end
+  end
+end