interfacets 0.9.9 → 0.9.99

data/lib/interfacets/test/validation_engine.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+require "json_schemer"
+require "set"
+require "yaml"
+
+module Interfacets
+  module Test
+    class ValidationEngine
+      attr_reader :registry, :validation_mode
+
+      @warned_components = Set.new
+
+      def self.warned_components
+        @warned_components
+      end
+
+      def self.reset_warnings!
+        @warned_components.clear
+      end
+
+      def initialize(registry = ComponentRegistry.load, validation_mode: :strict)
+        @registry = registry
+        @validation_mode = validation_mode
+      end
+
+      def active?
+        registry.contracts.any?
+      end
+
+      def validate_props(component_name, props)
+        return unless active?
+
+        contract = registry.find_component(component_name)
+        is_standard = standard_element?(component_name)
+
+        props_config = contract&.dig("props")
+
+        if is_standard
+          return unless props_config
+        else
+          return unless contract_exists?(component_name)
+
+          raise ValidationError, "Missing props schema for custom component: #{component_name}" unless props_config
+        end
+
+        schema = { "type" => "object", "properties" => props_config }
+        validate!(schema, props, "properties for #{component_name}")
+      end
+
+      def validate_event(component_name, event_name, payload)
+        return unless active?
+
+        contract = registry.find_component(component_name)
+        is_standard = standard_element?(component_name)
+
+        event_config = contract&.dig("props", event_name.to_s)
+
+        if is_standard
+          return unless event_config
+        else
+          return unless contract_exists?(component_name)
+
+          raise ValidationError, "Missing events schema for custom component: #{component_name}" unless contract.key?("props")
+          raise ValidationError, "Missing event schema for '#{event_name}' in custom component: #{component_name}" unless event_config
+        end
+
+        schema = event_config.is_a?(Hash) ? (event_config["payload"] || {}) : {}
+
+        validate!(schema, payload, "event '#{event_name}' for #{component_name}")
+      end
+
+      private
+
+      def standard_element?(component_name)
+        @standard_elements ||= begin
+          yaml_path = File.expand_path("standard_elements.yml", __dir__)
+          Set.new(YAML.load_file(yaml_path).map(&:to_s))
+        end
+        @standard_elements.include?(component_name.to_s)
+      end
+
+      def contract_exists?(component_name)
+        contract = registry.find_component(component_name)
+        return true if contract
+
+        case validation_mode
+        when :strict
+          raise MissingComponentContractError, "Missing component contract for: #{component_name}"
+        when :warn
+          unless self.class.warned_components.include?(component_name)
+            warn "Warning: Missing component contract for: #{component_name}"
+            self.class.warned_components << component_name
+          end
+          false
+        when :permissive
+          false
+        else
+          raise ArgumentError, "Unknown validation_mode: #{validation_mode}"
+        end
+      end
+
+      def find_contract!(name)
+        contract = registry.find_component(name)
+        return contract if contract
+
+        raise MissingComponentContractError, "Missing component contract for: #{name}"
+      end
+
+      def validate!(schema, data, context)
+        full_schema = schema.dup
+        if full_schema["type"] == "object" && !full_schema.key?("additionalProperties")
+          full_schema["additionalProperties"] = false
+        end
+        full_schema["definitions"] = registry.definitions if registry.definitions.any?
+
+        schemer = JSONSchemer.schema(full_schema, keywords: {
+          "is_event" => lambda do |instance, keyword_value, pointer|
+            return true unless keyword_value
+            unless instance.is_a?(Hash) && instance.key?("type") && instance.key?("payload")
+              return [false, "missing 'type' or 'payload'"]
+            end
+
+            prop_name = pointer.split("/").last
+            prop_schema = full_schema.dig("properties", prop_name)
+            if prop_schema && (nested_schema = prop_schema["schema"])
+              nested_schemer = JSONSchemer.schema(nested_schema)
+              nested_errors = nested_schemer.validate(instance["payload"]).to_a
+              if nested_errors.any?
+                return [false, "event payload validation failed: #{nested_errors.map { |e| "#{e['data_pointer']}: #{e['type']} #{e['details']}" }.join(', ')}"]
+              end
+            end
+
+            true
+          end
+        })
+
+        errors = schemer.validate(data).to_a
+
+        return if errors.empty?
+
+        message = "Validation failed for #{context}:\n"
+        errors.each do |error|
+          message += "  - #{error['data_pointer']}: #{error['type']} #{error['details']}\n"
+        end
+
+        raise ValidationError, message
+      end
+    end
+  end
+end

data/lib/interfacets/test.rb

@@ -1,9 +1,5 @@
 # frozen_string_literal: true
 
-# require_relative "./test/session"
-# require_relative "./test/js"
-# require_relative "./test/js/channels"
-
 module Interfacets
   module Test
     module H

data/lib/interfacets/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Interfacets
-  VERSION = "0.9.9"
+  VERSION = "0.9.99"
 end

data/lib/interfacets.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "zeitwerk"
+require "active_support/concern"
 
 module Interfacets
   class << self
@@ -25,6 +26,8 @@ module Interfacets
   end
 
   class Error < StandardError; end
+  class ValidationError < Error; end
+  class MissingComponentContractError < Error; end
 end
 
 unless Interfacets.enable_reloading?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: interfacets
 version: !ruby/object:Gem::Version
-  version: 0.9.9
+  version: 0.9.99
 platform: ruby
 authors:
 - Pete Kinnecom
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-24 00:00:00.000000000 Z
+date: 2026-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: json_schemer
+  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'
 description:
 email:
 - git@k7u7.com
@@ -46,6 +60,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".rubocop.yml"
+- ".tmp"
 - LICENSE
 - LICENSE.txt
 - Rakefile
@@ -67,24 +82,14 @@ files:
 - lib/interfacets/client/channels/url.rb
 - lib/interfacets/client/config.rb
 - lib/interfacets/client/delegator.rb
-- lib/interfacets/client/facet.rb
-- lib/interfacets/client/facet2.rb
-- lib/interfacets/client/facets/attributes/accessor.rb
-- lib/interfacets/client/facets/attributes/association.rb
-- lib/interfacets/client/facets/attributes/bind.rb
-- lib/interfacets/client/facets/attributes/collection.rb
-- lib/interfacets/client/facets/attributes/readonly.rb
-- lib/interfacets/client/facets/deserializer.rb
-- lib/interfacets/client/facets/schema.rb
-- lib/interfacets/client/facets/schema/deserializer.rb
-- lib/interfacets/client/facets/serializer.rb
 - lib/interfacets/client/registry.rb
 - lib/interfacets/client/system.rb
 - lib/interfacets/client/utils/active_support_concern.rb
 - lib/interfacets/client/utils/mruby_patches.rb
 - lib/interfacets/client/utils/open_struct.rb
 - lib/interfacets/client/utils/securerandom.rb
-- lib/interfacets/client/view.rb
+- lib/interfacets/component_registry.rb
+- lib/interfacets/component_schema_parser.rb
 - lib/interfacets/mruby/build.dockerfile
 - lib/interfacets/mruby/build_config.rb
 - lib/interfacets/mruby/entrypoint.rb
@@ -92,32 +97,38 @@ files:
 - lib/interfacets/server/api.rb
 - lib/interfacets/server/assets.rb
 - lib/interfacets/server/assets/facet.rb
-- lib/interfacets/server/basic_routable.rb
 - lib/interfacets/server/basic_router.rb
 - lib/interfacets/server/bus.rb
 - lib/interfacets/server/config.rb
-- lib/interfacets/server/facet.rb
 - lib/interfacets/server/facets/deserializer.rb
 - lib/interfacets/server/facets/schema/serializer.rb
 - lib/interfacets/server/facets/serializer.rb
 - lib/interfacets/server/registry.rb
+- lib/interfacets/shared/basic_routable.rb
 - lib/interfacets/shared/entities/bus.rb
 - lib/interfacets/shared/entities/collection_proxy.rb
 - lib/interfacets/shared/entities/specs.rb
 - lib/interfacets/shared/entities/specs/handlers.rb
 - lib/interfacets/shared/entity.rb
-- lib/interfacets/shared/entity_collection.rb
+- lib/interfacets/shared/entity_dsl.rb
+- lib/interfacets/shared/facet.rb
 - lib/interfacets/shared/generated_store.rb
 - lib/interfacets/shared/utils.rb
 - lib/interfacets/shared/validations.rb
+- lib/interfacets/shared/view.rb
 - lib/interfacets/test.rb
-- lib/interfacets/test/browser.rb
+- lib/interfacets/test/component_registry.rb
 - lib/interfacets/test/js/inline_bus.rb
 - lib/interfacets/test/js/nodo_bus.rb
 - lib/interfacets/test/js/receivers/api.rb
 - lib/interfacets/test/js/receivers/react.rb
 - lib/interfacets/test/js/receivers/react/node.rb
+- lib/interfacets/test/js/receivers/react/node/xml_parser.rb
+- lib/interfacets/test/js/receivers/timer.rb
 - lib/interfacets/test/js/receivers/url.rb
+- lib/interfacets/test/standard_elements.yml
+- lib/interfacets/test/ui_simulator.rb
+- lib/interfacets/test/validation_engine.rb
 - lib/interfacets/version.rb
 homepage: https://github.com/petekinnecom/interfacets
 licenses:

data/lib/interfacets/client/facet.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-module Interfacets
-  module Client
-    class Facet
-      class << self
-        attr_accessor(
-          :shared,
-          :entity,
-          :view,
-          :store,
-        )
-      end
-
-      attr_reader :entity, :view
-      def initialize(entity)
-        @entity = entity
-        @view = self.class.view.new
-      end
-
-      def render(channels)
-        view.render(entity:, channels:)
-      end
-    end
-  end
-end

data/lib/interfacets/client/facet2.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Interfacets
-  module Client
-    class Facet2
-      class << self
-        attr_accessor(
-          :shared_entity,
-          :entity,
-          :view
-        )
-      end
-    end
-  end
-end

data/lib/interfacets/client/facets/attributes/accessor.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-module Interfacets
-  module Client
-    module Facets
-      module Attributes
-        class Accessor
-          attr_reader :send_if
-          def initialize(send_if:)
-            @send_if = send_if
-          end
-
-          def coerce(val, **)
-            val
-          end
-
-          def serialize(val)
-            val
-          end
-
-          def should_send?(facet)
-            facet.instance_exec(&send_if)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/interfacets/client/facets/attributes/association.rb

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-module Interfacets
-  module Client
-    module Facets
-      module Attributes
-        class Association
-          attr_reader :nested, :anonymous, :config, :bind_map
-
-          def initialize(nested:, anonymous:, config:, bind_map:)
-            @nested = nested
-            @anonymous = anonymous
-            @config = config
-            @bind_map = bind_map
-          end
-
-          def coerce(val, parent:)
-            return if val.nil?
-
-            facet.build(
-              attrs: val,
-              binds: bind_map.transform_values { |v| Bind.new(name: v, facet: parent) },
-            )
-          end
-
-          def build(attrs:, parent:)
-            facet.build(
-              attrs:,
-              binds: bind_map.transform_values { |v| Bind.new(name: v, facet: parent) },
-            )
-          end
-
-          def serialize(val)
-            val&.serialize
-          end
-
-          def facet
-            @facet ||= (
-              if anonymous
-                @nested
-              else
-                config.schema(@nested.fetch("name"))
-              end
-            )
-          end
-        end
-      end
-    end
-  end
-end

data/lib/interfacets/client/facets/attributes/bind.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-module Interfacets
-  module Client
-    module Facets
-      module Attributes
-        class Bind
-          attr_reader :name, :facet
-          def initialize(name:, facet:)
-            @name = name
-            @facet = facet
-          end
-
-          def get
-            facet.public_send(name)
-          end
-
-          def set(v)
-            facet.public_send("#{name}=", v)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/interfacets/client/facets/attributes/collection.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-module Interfacets
-  module Client
-    module Facets
-      module Attributes
-        class Collection
-          attr_reader :nested, :anonymous, :config, :bind_map
-
-          def initialize(nested:, anonymous:, config:, bind_map:)
-            @nested = nested
-            @anonymous = anonymous
-            @config = config
-            @bind_map = bind_map
-          end
-
-          def coerce(val, parent:)
-            return [] if val.nil?
-
-            val.map { build(attrs: _1, parent:) }
-          end
-
-          def build(attrs:, parent:)
-            facet.build(
-              attrs:,
-              binds: bind_map.transform_values { |v| Bind.new(name: v, facet: parent) },
-            )
-          end
-
-          def serialize(val)
-            val.map(&:serialize)
-          end
-
-          def facet
-            @facet ||= (
-              if anonymous
-                @nested
-              else
-                config.schema(@nested.fetch("name"))
-              end
-            )
-          end
-        end
-      end
-    end
-  end
-end

data/lib/interfacets/client/facets/attributes/readonly.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module Interfacets
-  module Client
-    module Facets
-      module Attributes
-        class Readonly
-          def coerce(val, **)
-            val
-          end
-
-          def serialize(val)
-            val
-          end
-        end
-      end
-    end
-  end
-end

data/lib/interfacets/client/facets/deserializer.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module Interfacets
-  module Client
-    module Facets
-      class Deserializer
-        def self.call(data:, config: Client.system.config)
-          Logger.main.debug("deserializing facet: #{data.fetch("facet_class")}")
-
-          klass = Object.const_get(data.fetch("facet_class"))
-
-          Logger.main.debug("constructing: #{klass.client.name}")
-
-          facet = klass.new
-
-          entity = (
-            klass
-              .client
-              .build(data.fetch("attributes"), parent: nil, facet:)
-          )
-
-          Logger.main.debug("entity constructed")
-
-          facet.entity = entity
-          facet
-        end
-      end
-    end
-  end
-end

data/lib/interfacets/client/facets/schema/deserializer.rb

@@ -1,63 +0,0 @@
-# frozen_string_literal: true
-
-module Interfacets
-  module Client
-    module Facets
-      module Schema
-        class Deserializer
-          def self.call(...)
-            new(...).call
-          end
-
-          attr_reader :schema, :results
-          def initialize(schema:)
-            @schema = schema
-            @results = { views: {}, entities: {}, apis: {} }
-          end
-
-          def call
-            schema.fetch("views").each do |view_type, view_json|
-              block = view_json.fetch("body")
-
-              results[:views][view_type] = View.new(
-                block: eval(block),
-                name: view_type,
-              )
-            end
-
-            schema.fetch("apis").each do |api_type, entity_json|
-              block = entity_json.fetch("body")
-
-              results[:apis][api_type] =
-                Module.new do
-                  extend ActiveSupport::Concern
-                  define_singleton_method(:name) { api_type }
-
-                  included do
-                    class_exec(&eval(block))
-                  end
-                end
-            end
-
-            schema.fetch("entities").each do |entity_type, client_json|
-              block = client_json.fetch("body")
-              api_type = client_json.fetch("api_type")
-
-              api_mod = results[:apis].fetch(api_type)
-
-              results[:entities][entity_type] =
-                Class.new(Entity) do
-                  define_singleton_method(:name) { entity_type }
-                  include api_mod
-
-                  class_exec(&eval(block))
-                end
-            end
-
-            results
-          end
-        end
-      end
-    end
-  end
-end

data/lib/interfacets/client/facets/schema.rb

@@ -1,63 +0,0 @@
-# frozen_string_literal: true
-
-module Interfacets
-  module Client
-    module Facets
-      module Schema
-        extend ActiveSupport::Concern
-        class_methods do
-          def view_spec(&block)
-            @view_spec = block
-          end
-
-          def view
-            # TODO: change this to just inherit from view
-            @view ||= View.new(
-              block: @view_spec,
-              name: "#{self.name}::View",
-            )
-          end
-
-          def client_spec(&block)
-            @client_spec = block
-          end
-
-          def client
-            # scoping
-            client_name = "#{self.name}::Client"
-            client_spec = @client_spec
-            entity = self.entity
-
-            @client ||=
-              Class.new(Entity) do
-                define_singleton_method(:name) { client_name }
-                extend_entity { include entity }
-
-                class_exec(&client_spec)
-              end
-          end
-
-          def entity_spec(&block)
-            @entity_spec = block
-          end
-
-          def entity
-            # scoping
-            entity_name = "#{self.name}::Entity"
-            entity_spec = @entity_spec
-
-            @entity ||=
-              Module.new do
-                extend ActiveSupport::Concern
-                define_singleton_method(:name) { entity_name }
-
-                included do
-                  class_exec(&entity_spec)
-                end
-              end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/interfacets/client/facets/serializer.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-module Interfacets
-  module Client
-    module Facets
-      class Serializer
-        class << self
-          def call(facet)
-            {
-              facet_class: facet.class.name,
-              attributes: facet.entity.serialize,
-            }
-          end
-        end
-      end
-    end
-  end
-end