event_engine 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 147bcd5804bc40820fdbe36f46bd6e5ca76a7b7d09b39bf1955ccbda2925e1cd
-  data.tar.gz: bdb36c1bf535f603b58950749ef12d1ea19bbbbd1c59e4f3831525c4d336342b
+  metadata.gz: e487942b070a87cfa23e72a27d34e9247704caadfa887be26c1cd63eb3d4506d
+  data.tar.gz: 4f87ddcd5d44b28009ad2e45bc46296ab52d9f047037ec7023067238554f6a4e
 SHA512:
-  metadata.gz: 90690f42ed2498c5516a52230b750273777d115fa136af306e84c0c3a2dd4615f79d63570aa14ba0d34087a2c582e036f9a3acad6175a757305783225404c93c
-  data.tar.gz: 507ce9e63e9a161436a88eabcb7d6114f06bdd77e7fa88a23296c3655910994b7e9696f3f0a5cd4420876e39f02da963c748773c8551096f39cec22d0076c4a4
+  metadata.gz: 6f63838b3a3c2835e9c1511172413f6991cb0831afdf3b21247e5ef5ba03f0d40a92fb21ba1282ef6ce100a5081837821999de9b51f3cc920a2a5b30a94ec9fa
+  data.tar.gz: 688da6973e692d3b57b6d468191c37e9f701fa767888c030aec9318a0193685388ba6441b88be08d5fb54ff85ee6f8f019eee4a91791259ee4cce2af4a3baef2

data/CHANGELOG.md

@@ -7,6 +7,14 @@ 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

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/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/version.rb

@@ -1,3 +1,3 @@
 module EventEngine
-  VERSION = "0.2.2"
+  VERSION = "0.2.3"
 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.2
+  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: []