event_engine 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f780a13e96d7a1fd1534d39aeda5cca32379d283e886839538f969d2cdcfa53
-  data.tar.gz: 1dad812c37e3d4b44178d8d2a9b42b1623a94fef984c6e32d66f84a0b4a3d76a
+  metadata.gz: e487942b070a87cfa23e72a27d34e9247704caadfa887be26c1cd63eb3d4506d
+  data.tar.gz: 4f87ddcd5d44b28009ad2e45bc46296ab52d9f047037ec7023067238554f6a4e
 SHA512:
-  metadata.gz: 685bad2445b1b6022625790855b51c4614be06e7cfafc81556d959a1a2d3254663a5a701bccfdc805c3260ec19919e939f22a5733d64481bdf894a60daeae896
-  data.tar.gz: bd15af2c996f15d0422b624947c78fa2d2607e13a611b028ed6f03a3d5a470ee3d8963c15c038976c5bb2c164f3eebe41a90fe372d4c3c28b39abb0e4fa8d955
+  metadata.gz: 6f63838b3a3c2835e9c1511172413f6991cb0831afdf3b21247e5ef5ba03f0d40a92fb21ba1282ef6ce100a5081837821999de9b51f3cc920a2a5b30a94ec9fa
+  data.tar.gz: 688da6973e692d3b57b6d468191c37e9f701fa767888c030aec9318a0193685388ba6441b88be08d5fb54ff85ee6f8f019eee4a91791259ee4cce2af4a3baef2

data/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.3] - 2026-10-23
+
+### Added
+
+- **Unrouted events.** A rule of `unrouted` defines an event before anything
+  handles it. It passes `validate_rules!`, and emitting it raises
+  `EventEngine::UnroutableEventError`.
+
+## [0.2.2] - 2026-09-06
+
+### Fixed
+
+- Versioned lookup after boot. `EventSchemaJsonLoader.load` returned a
+  `SchemaRegistry` where `SchemaRegistry#load_from_schema!` stores an
+  `EventSchema`, so `emit(..., event_version: 2)` — documented in the README —
+  called `schema_for` on a registry and raised `NoMethodError`. The loader now
+  returns the `EventSchema` its callers assign.
+- `SchemaRegistry#reset!` left `@event_schema` as a plain `Hash`, so registering
+  into a reset registry raised `NoMethodError`.
+
 ## [0.2.1] - 2026-07-29
 
 ### Fixed

data/README.md

@@ -234,6 +234,7 @@ packs:
 events:
   invoice_voided: audit   # this one event
   lead_converted:         # catalogued but undecided
+  lead_scored: unrouted   # defined, not routed yet
 ```
 
 A rule names a **registered processor**. Resolution is **event → pack → default**,
@@ -251,6 +252,13 @@ and the resolved name is both the processor invoked and the value stamped on
 A newly catalogued event appears with no value. It falls through to its pack rule or
 the default; if neither exists, emitting it raises rather than being dropped.
 
+### Defining an event before it is routed
+
+Give an event the rule `unrouted` to define it before anything handles it. It
+passes `validate_rules!` and `event_engine:rules:check`, and emitting it raises
+`EventEngine::UnroutableEventError`. Replace `unrouted` with a processor name once
+the event has one.
+
 ### When a rule is wrong
 
 Both misconfigurations fail loudly and name the fix:

data/lib/event_engine/event_schema_json_loader.rb

@@ -3,17 +3,17 @@ require "json"
 module EventEngine
   class EventSchemaJsonLoader
     def self.load(path)
-      registry = SchemaRegistry.new
-      return registry unless File.exist?(path)
+      schema = EventSchema.new
+      return schema unless File.exist?(path)
 
       contents = File.read(path.to_s)
-      return registry if contents.strip.empty?
+      return schema if contents.strip.empty?
 
       JSON.parse(contents).each do |attributes|
-        registry.register(CatalogEntry.from_h(attributes))
+        schema.register(CatalogEntry.from_h(attributes))
       end
 
-      registry
+      schema
     end
   end
 end

data/lib/event_engine/processing_rules.rb

@@ -2,6 +2,8 @@ require "yaml"
 
 module EventEngine
   class ProcessingRules
+    UNROUTED = :unrouted
+
     def self.load(path)
       return new unless File.exist?(path.to_s)
 
@@ -33,7 +35,7 @@ module EventEngine
     end
 
     def processor_names
-      ([ @default ] + @packs.values + @events.values).compact.uniq
+      ([ @default ] + @packs.values + @events.values).compact.uniq - [ UNROUTED ]
     end
   end
 end

data/lib/event_engine/processor_resolver.rb

@@ -9,8 +9,10 @@ module EventEngine
     end
 
     def resolve(event)
-      @rules.for(event_name: event.event_name, pack: event.domain) ||
-        raise(UnroutableEventError.new(event))
+      name = @rules.for(event_name: event.event_name, pack: event.domain)
+      raise UnroutableEventError.new(event) if name.nil? || name == ProcessingRules::UNROUTED
+
+      name
     end
   end
 end

data/lib/event_engine/schema_registry.rb

@@ -30,7 +30,7 @@ module EventEngine
     end
 
     def reset!
-      @event_schema = {}
+      @event_schema = EventSchema.new
       @loaded = false
     end
 

data/lib/event_engine/version.rb

@@ -1,3 +1,3 @@
 module EventEngine
-  VERSION = "0.2.1"
+  VERSION = "0.2.3"
 end

data/lib/event_engine.rb

@@ -174,7 +174,7 @@ module EventEngine
       slice = EventSchemaJsonLoader.load(schema_path)
 
       schema_registry.load_from_schema!(EventSchema.new) unless schema_registry.loaded?
-      slice.event_schema.schemas_by_event.each_value do |versions|
+      slice.schemas_by_event.each_value do |versions|
         versions.each_value { |schema| schema_registry.register(schema) }
       end
 

data/the_local/agents/event_engine-develop.md

@@ -145,6 +145,8 @@ off to that local first and come back.
   domain; pair narrow rules with a `default_processor`.
 - Routing at a name with no registered processor fails at emit time, not at boot.
   Keep steps 3 and 4 in the same initializer so they cannot drift.
+- A rule of `unrouted` defines an event before anything handles it. It passes the
+  rules check, and emitting it raises `EventEngine::UnroutableEventError`.
 - A pack helper firing an event that is not in the committed catalog raises
   `EventEngine::DefinitionPublisher::EventNotInCatalogError`. That means the
   catalog is stale — rebuild it in step 2, do not work around it in app code.

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: event_engine
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.3
 platform: ruby
 authors:
 - tylercschneider
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-06 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -102,7 +101,6 @@ metadata:
   changelog_uri: https://github.com/DYB-Development/event_engine/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/DYB-Development/event_engine/issues
   documentation_uri: https://github.com/DYB-Development/event_engine#readme
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -117,8 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
-signing_key:
+rubygems_version: 4.0.20
 specification_version: 4
 summary: The Rails host runtime for the schema-first EventEngine pipeline
 test_files: []