event_engine 0.2.2 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 147bcd5804bc40820fdbe36f46bd6e5ca76a7b7d09b39bf1955ccbda2925e1cd
-  data.tar.gz: bdb36c1bf535f603b58950749ef12d1ea19bbbbd1c59e4f3831525c4d336342b
+  metadata.gz: d41f3bf5979d9b7bf564192af007e2345acb7cb5a8557af84a56a9a140ba7b49
+  data.tar.gz: c295ec1cc5a9ad2f1d3f2dec987067e7fbfe33dbf2a6037914989acc5caad9fc
 SHA512:
-  metadata.gz: 90690f42ed2498c5516a52230b750273777d115fa136af306e84c0c3a2dd4615f79d63570aa14ba0d34087a2c582e036f9a3acad6175a757305783225404c93c
-  data.tar.gz: 507ce9e63e9a161436a88eabcb7d6114f06bdd77e7fa88a23296c3655910994b7e9696f3f0a5cd4420876e39f02da963c748773c8551096f39cec22d0076c4a4
+  metadata.gz: 0ac2e2d99a33c2a69dd1300d00c53f283504eecba38f79d4ca7b87f4ae8098a689abc9a3588f45e992c31f2141e0c3bf454c21eda0a5bb101bbdbcaa8c813df2
+  data.tar.gz: 0bb6f4f3f401336adfd11076a3df889ea11ddbc5d913125a69af65b40dd04a95c9163f11fe6d20356c01594bccbce7ae943a4d0607c2978aacd7a0770fda62c9

data/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.4] - 2026-11-07
+
+### Added
+
+- A rule of `recorded` runs no processor and still passes the event to the handlers registered for every process type in the same call, so an event that is only kept, such as a history a store records, needs no processor or subscriber. It passes `validate_rules!` with no processor registered under that name.
+
+## [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,8 @@ packs:
 events:
   invoice_voided: audit   # this one event
   lead_converted:         # catalogued but undecided
+  lead_scored: unrouted   # defined, not routed yet
+  lead_viewed: recorded   # kept by every-type handlers, processed by nothing
 ```
 
 A rule names a **registered processor**. Resolution is **event → pack → default**,
@@ -251,6 +253,22 @@ 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.
+
+### Keeping an event without processing it
+
+Give an event the rule `recorded` when nothing should process it but it should still
+reach the handlers registered for every process type, such as a store that keeps
+each event. No processor runs and none needs to be registered under that name, and
+emitting it passes the event to those handlers in the same call, so an error a
+handler raises reaches the code that emitted it. The event's `process_type` is
+`recorded`.
+
 ### When a rule is wrong
 
 Both misconfigurations fail loudly and name the fix:

data/lib/event_engine/processing_rules.rb

@@ -2,6 +2,9 @@ require "yaml"
 
 module EventEngine
   class ProcessingRules
+    UNROUTED = :unrouted
+    RECORDED = :recorded
+
     def self.load(path)
       return new unless File.exist?(path.to_s)
 
@@ -33,7 +36,7 @@ module EventEngine
     end
 
     def processor_names
-      ([ @default ] + @packs.values + @events.values).compact.uniq
+      ([ @default ] + @packs.values + @events.values).compact.uniq - [ UNROUTED, RECORDED ]
     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.4"
 end

data/lib/event_engine.rb

@@ -145,6 +145,8 @@ module EventEngine
       return event unless resolver.routes?
 
       name = resolver.resolve(event)
+      return event if name == ProcessingRules::RECORDED
+
       processor = processor_registry.fetch(name) || raise(UnregisteredProcessorError.new(name, event))
 
       processor.call(event)

data/the_local/agents/event_engine-develop.md

@@ -145,6 +145,12 @@ 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 rule of `recorded` runs no processor and still passes the event to every
+  handler registered for all process types, such as a store that keeps each event,
+  in the same call. It needs no processor registered under that name and passes
+  the rules check. Use it for an event that is only kept as a history.
 - 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.4
 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: []