foobara 0.0.1

data/projects/command_connectors/src/serializers/json_serializer.rb

@@ -0,0 +1,20 @@
+module Foobara
+  module CommandConnectors
+    module Serializers
+      # TODO: move this to its own project
+      class JsonSerializer < Serializer
+        def serialize(object)
+          JSON.fast_generate(object)
+        end
+
+        def deserialize(string)
+          JSON.parse(string)
+        end
+
+        def priority
+          Priority::LOW
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors/src/serializers/noop_serializer.rb

@@ -0,0 +1,20 @@
+module Foobara
+  module CommandConnectors
+    module Serializers
+      # TODO: move this to its own project
+      class NoopSerializer < Serializer
+        def serialize(object)
+          object
+        end
+
+        def deserialize(object)
+          object
+        end
+
+        def priority
+          Priority::LOW
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors/src/serializers/record_store_serializer.rb

@@ -0,0 +1,31 @@
+require_relative "success_serializer"
+
+module Foobara
+  module CommandConnectors
+    module Serializers
+      class RecordStoreSerializer < SuccessSerializer
+        def atomic_serializer
+          @atomic_serializer ||= AtomicSerializer.new(declaration_data)
+        end
+
+        def serialize(_object)
+          store = {}
+
+          declaration_data.command.transactions.each do |tx|
+            tx.each_table do |table|
+              key = table.entity_class.full_entity_name
+
+              map = store[key] ||= {}
+
+              table.tracked_records.each do |record|
+                map[record.primary_key] = atomic_serializer.transform(record)
+              end
+            end
+          end
+
+          store
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors/src/serializers/success_serializer.rb

@@ -0,0 +1,14 @@
+module Foobara
+  require_project_file("command_connectors", "serializer")
+
+  module CommandConnectors
+    module Serializers
+      class SuccessSerializer < Serializer
+        # TODO: always_applicable? instead?
+        def always_applicable?
+          request.outcome.success?
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors/src/serializers/yaml_serializer.rb

@@ -0,0 +1,20 @@
+module Foobara
+  module CommandConnectors
+    module Serializers
+      # TODO: move this to its own project
+      class YamlSerializer < Serializer
+        def serialize(object)
+          YAML.dump(object)
+        end
+
+        def deserialize(string)
+          YAML.load(string)
+        end
+
+        def priority
+          Priority::LOW
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors/src/transformers/auth_errors_transformer.rb

@@ -0,0 +1,35 @@
+module Foobara
+  module CommandConnectors
+    module Transformers
+      # This behavior is hard-coded but this is here to update the error classes in the manifest
+      class AuthErrorsTransformer < Value::Transformer
+        class << self
+          # Feels awkward to have to do this for a few reasons. Passing self and also not
+          # adhering to processor interface. Not sure how best to address this.
+          def transform_error_context_type_map(transformed_command, map)
+            if transformed_command.requires_authentication
+              possible_error = PossibleError.new(CommandConnector::UnauthenticatedError)
+              map = map.merge(possible_error.key.to_s => possible_error)
+            end
+
+            if transformed_command.allowed_rule
+              possible_error = PossibleError.new(CommandConnector::NotAllowedError)
+              map = map.merge(possible_error.key.to_s => possible_error)
+            end
+
+            map
+          end
+        end
+        def applicable?(_request)
+          false
+        end
+
+        def transform(_request)
+          # :nocov:
+          raise "Not expected to be called"
+          # :nocov:
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors/src/transformers/load_aggregates_pre_commit_transformer.rb

@@ -0,0 +1,36 @@
+module Foobara
+  module CommandConnectors
+    module Transformers
+      class LoadAggregatesPreCommitTransformer < Value::Transformer
+        def applicable?(request)
+          request.command.outcome.success?
+        end
+
+        def transform(request)
+          load_aggregates(request.command.outcome.result)
+
+          request
+        end
+
+        def load_aggregates(object)
+          case object
+          when Entity
+            object.class.load_aggregate(object)
+          when Array
+            object.each do |element|
+              load_aggregates(element)
+            end
+          when Hash
+            object.each_key do |key|
+              load_aggregates(key)
+            end
+
+            object.each_value do |value|
+              load_aggregates(value)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/lib/foobara/command_connectors_http.rb

@@ -0,0 +1,6 @@
+module Foobara
+  module CommandConnectorsHttp
+  end
+
+  Monorepo.project :command_connectors_http
+end

data/projects/command_connectors_http/src/http/commands/get_options.rb

@@ -0,0 +1,16 @@
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        # TODO: this is a bit of a hack, just a total no-op... shouldn't really need this command at all ideally
+        class GetOptions < Foobara::Command
+          result :string
+
+          def execute
+            ""
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/src/http/commands/help/presenter/command.rb

@@ -0,0 +1,14 @@
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        class Help < Command
+          class Presenter
+            class Command < Presenter
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/src/http/commands/help/presenter/domain.rb

@@ -0,0 +1,14 @@
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        class Help < Command
+          class Presenter
+            class Domain < Presenter
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/src/http/commands/help/presenter/entity.rb

@@ -0,0 +1,14 @@
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        class Help < Command
+          class Presenter
+            class Entity < Presenter
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/src/http/commands/help/presenter/error.rb

@@ -0,0 +1,14 @@
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        class Help < Command
+          class Presenter
+            class Error < Presenter
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/src/http/commands/help/presenter/model.rb

@@ -0,0 +1,14 @@
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        class Help < Command
+          class Presenter
+            class Model < Presenter
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/src/http/commands/help/presenter/organization.rb

@@ -0,0 +1,14 @@
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        class Help < Command
+          class Presenter
+            class Organization < Presenter
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/src/http/commands/help/presenter/processor.rb

@@ -0,0 +1,14 @@
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        class Help < Command
+          class Presenter
+            class Processor < Presenter
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/src/http/commands/help/presenter/processor_class.rb

@@ -0,0 +1,14 @@
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        class Help < Command
+          class Presenter
+            class ProcessorClass < Presenter
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/src/http/commands/help/presenter/root.rb

@@ -0,0 +1,14 @@
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        class Help < Command
+          class Presenter
+            class Root < Presenter
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/src/http/commands/help/presenter/type.rb

@@ -0,0 +1,14 @@
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        class Help < Command
+          class Presenter
+            class Type < Presenter
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/src/http/commands/help/presenter.rb

@@ -0,0 +1,162 @@
+require_relative "presenter/command"
+require_relative "presenter/entity"
+require_relative "presenter/error"
+require_relative "presenter/model"
+require_relative "presenter/organization"
+require_relative "presenter/domain"
+require_relative "presenter/processor"
+require_relative "presenter/processor_class"
+require_relative "presenter/root"
+require_relative "presenter/type"
+
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        class Help < Command
+          class Presenter
+            class << self
+              def for(manifest)
+                case manifest
+                when Manifest::RootManifest
+                  Presenter::Root
+                when Manifest::Command
+                  Presenter::Command
+                when Manifest::Entity
+                  Presenter::Entity
+                when Manifest::Model
+                  Presenter::Model
+                when Manifest::Type
+                  Presenter::Type
+                when Manifest::Error
+                  Presenter::Error
+                when Manifest::Domain
+                  Presenter::Domain
+                when Manifest::Organization
+                  Presenter::Organization
+                when Manifest::Processor
+                  Presenter::Processor
+                when Manifest::ProcessorClass
+                  Presenter::ProcessorClass
+                else
+                  # :nocov:
+                  raise "No presenter found for #{manifest.path}"
+                  # :nocov:
+                end.new(manifest)
+              end
+
+              def template_symbol
+                Util.underscore(Util.non_full_name(self))
+              end
+
+              def template_path
+                template_path = File.join(
+                  __dir__,
+                  "templates",
+                  "#{template_symbol}.html.erb"
+                )
+                Pathname.new(template_path).cleanpath.to_s
+              end
+            end
+
+            attr_accessor :manifest
+
+            def initialize(manifest)
+              self.manifest = manifest
+            end
+
+            def render_html_list(data, skip_wrapper: false)
+              html = ""
+
+              case data
+              when ::Hash
+                html << "<ul>" unless skip_wrapper
+                data.each do |key, value|
+                  html << "<li>#{key}"
+                  html << "<ul>"
+                  html << render_html_list(value, skip_wrapper: true)
+                  html << "</ul>"
+                  html << "</li>"
+                end
+                html << "</ul>" unless skip_wrapper
+              when ::Array
+                html << "<ul>" unless skip_wrapper
+                data.each do |item|
+                  html << render_html_list(item)
+                end
+                html << "</ul>" unless skip_wrapper
+              when Manifest::Attributes
+                html << "<ul>" unless skip_wrapper
+                data.relevant_manifest.each_pair do |key, value|
+                  if key.to_s == "type"
+                    next
+                  end
+
+                  if key.to_s == "element_type_declarations"
+                    key = :attributes
+                    value = data.attribute_declarations
+                  end
+                  html << "<li>#{key}"
+                  html << "<ul>"
+                  html << render_html_list(value, skip_wrapper: true)
+                  html << "</ul>"
+                  html << "</li>"
+                end
+                html << "</ul>" unless skip_wrapper
+              when Manifest::TypeDeclaration
+                html << "<ul>" unless skip_wrapper
+                data.relevant_manifest.each_pair do |key, value|
+                  if key.to_s == "type"
+                    value = root_manifest.lookup_path(key, value)
+                  end
+                  html << "<li>#{key}"
+                  html << "<ul>"
+                  html << render_html_list(value, skip_wrapper: true)
+                  html << "</ul>"
+                  html << "</li>"
+                end
+                html << "</ul>" unless skip_wrapper
+              when Manifest::Type, Manifest::Command, Manifest::Error
+                html << foobara_reference_link(data)
+              when Manifest::PossibleError
+                html << render_html_list(data.error)
+              else
+                html << "<li>#{data}</li>"
+              end
+
+              html
+            end
+
+            def foobara_reference_link(manifest)
+              path = "/help/#{manifest.reference}"
+
+              "<a href=\"#{path}\">#{manifest.reference.split("::").last}</a>"
+            end
+
+            def root_manifest
+              @root_manifest ||= Manifest::RootManifest.new(manifest.root_manifest)
+            end
+
+            def template_path
+              self.class.template_path
+            end
+
+            def method_missing(method_name, *, &)
+              if manifest.respond_to?(method_name)
+                manifest.send(method_name, *, &)
+              else
+                # :nocov:
+                super
+                # :nocov:
+              end
+            end
+
+            def respond_to_missing?(method_name, include_private = false)
+              manifest.respond_to?(method_name, include_private)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/projects/command_connectors_http/src/http/commands/help/templates/command.html.erb

@@ -0,0 +1,11 @@
+<h1><%= full_command_name %></h1>
+<p><%= description %></p>
+
+<h2>Inputs</h2>
+<%= render_html_list(inputs_type) %>
+
+<h2>Result</h2>
+<%= render_html_list(result_type) %>
+
+<h2>Possible Errors</h2>
+<%= render_html_list(possible_errors) %>

data/projects/command_connectors_http/src/http/commands/help/templates/domain.html.erb

@@ -0,0 +1 @@
+<%= full_domain_name %>

data/projects/command_connectors_http/src/http/commands/help/templates/entity.html.erb

@@ -0,0 +1 @@
+<%= full_type_name %>

data/projects/command_connectors_http/src/http/commands/help/templates/error.html.erb

@@ -0,0 +1 @@
+<%= full_error_name %>

data/projects/command_connectors_http/src/http/commands/help/templates/model.html.erb

@@ -0,0 +1 @@
+<%= full_type_name %>

data/projects/command_connectors_http/src/http/commands/help/templates/organization.html.erb

@@ -0,0 +1 @@
+<%= full_organization_name %>

data/projects/command_connectors_http/src/http/commands/help/templates/processor.html.erb

@@ -0,0 +1 @@
+<%= full_processor_name %>

data/projects/command_connectors_http/src/http/commands/help/templates/processor_class.html.erb

@@ -0,0 +1 @@
+<%= full_processor_class_name %>

data/projects/command_connectors_http/src/http/commands/help/templates/root.html.erb

@@ -0,0 +1,3 @@
+<h1>Commands</h1>
+
+<%= render_html_list(commands) %>

data/projects/command_connectors_http/src/http/commands/help/templates/type.html.erb

@@ -0,0 +1 @@
+<%= full_type_name %>

data/projects/command_connectors_http/src/http/commands/help.rb

@@ -0,0 +1,98 @@
+module Foobara
+  module CommandConnectors
+    class Http < CommandConnector
+      module Commands
+        class Help < Command
+          description "Will extract items from the request to help with. Assumes the help is desired in HTML format"
+          inputs request: Request
+          result :string
+          possible_error CommandConnector::NotFoundError
+
+          def execute
+            load_manifest
+            determine_object_to_help_with
+            build_presenter
+            load_template
+            generate_html_from_template
+            set_header_to_html
+
+            html
+          end
+
+          attr_accessor :raw_manifest, :root_manifest, :object_to_help_with, :template, :html, :presenter
+
+          def load_manifest
+            self.raw_manifest = command_connector.foobara_manifest
+            self.root_manifest = Manifest::RootManifest.new(raw_manifest)
+          end
+
+          def determine_object_to_help_with(mode: Namespace::LookupMode::ABSOLUTE)
+            arg = request.argument
+
+            if arg
+              result = command_connector.command_registry.foobara_lookup(arg, mode:)
+
+              if result
+                self.object_to_help_with = result
+              else
+                result = GlobalOrganization.foobara_lookup(arg, mode:)
+
+                if result && root_manifest.contains?(result.foobara_manifest_reference,
+                                                     result.scoped_category)
+                  self.object_to_help_with = result
+                elsif mode == Namespace::LookupMode::ABSOLUTE
+                  determine_object_to_help_with(mode: Namespace::LookupMode::GENERAL)
+                elsif mode == Namespace::LookupMode::GENERAL
+                  determine_object_to_help_with(mode: Namespace::LookupMode::RELAXED)
+                else
+                  # TODO: add an input error instead for missing record to trigger 404
+                  add_runtime_error(CommandConnector::NotFoundError.new(arg))
+                end
+              end
+            else
+              self.object_to_help_with = root_manifest
+            end
+          end
+
+          def build_presenter
+            self.presenter = Help::Presenter.for(manifest_to_help_with)
+          end
+
+          def template_path
+            presenter.template_path
+          end
+
+          def load_template
+            template_body = File.read(template_path)
+
+            erb = ERB.new(template_body)
+            erb.filename = template_path
+
+            self.template = erb
+          end
+
+          def generate_html_from_template
+            self.html = template.result(presenter.instance_eval { binding })
+          end
+
+          def set_header_to_html
+            request.response_headers ||= {}
+            request.response_headers = request.response_headers.merge("content-type" => "text/html")
+          end
+
+          def manifest_to_help_with
+            @manifest_to_help_with ||= if object_to_help_with.is_a?(Manifest::BaseManifest)
+                                         object_to_help_with
+                                       else
+                                         root_manifest.lookup(object_to_help_with.foobara_manifest_reference)
+                                       end
+          end
+
+          def command_connector
+            request.command_connector
+          end
+        end
+      end
+    end
+  end
+end