Documentation

Author: derave-agb

docs/core-concepts/event-bus.md

@@ -86,14 +86,19 @@ Streak provides several `EventStore` implementations out of the box:
 
 3.  **`Streak\Infrastructure\Domain\EventStore\PublishingEventStore`**
     *   This is a **Decorator**. It wraps another `EventStore` implementation.
-    *   After successfully adding events to the wrapped store using `add()`, it publishes those events to an `EventBus`.
-    *   **Use Cases:** Ensures that events are published to listeners *only after* they have been successfully persisted. This is crucial for system consistency.
-    *   **Configuration:** Takes the underlying `EventStore` and an `EventBus` as constructor arguments.
+    *   Ensures events are delivered to listeners after being stored.
+    *   Publishes events to an in-memory event bus used by Streak's infrastructure (e.g., for starting [subscriptions](./listeners.md#running-listeners)).
+    *   Guarantees that events are only published after successful persistence.
+    *   **Use Cases:** 
+        * Reliable event delivery to listeners
+        * Maintaining consistency between event store and listeners
+        * Ensuring events are processed in the order they were stored
+    *   **Configuration:** Takes the underlying `EventStore` and event publishing mechanism as constructor arguments.
 
 ## Choosing an Implementation
 
 *   Use `InMemoryEventStore` for your tests.
 *   Use `DbalPostgresEventStore` (or potentially other DBAL-based stores if created) for development and production if using PostgreSQL.
-*   **Always** wrap your primary persistent event store (like `DbalPostgresEventStore`) with `PublishingEventStore` in production/development setups to ensure reliable event publication for read models, process managers, etc.
+*   **Always** wrap your primary persistent event store with `PublishingEventStore` to ensure reliable event delivery to listeners.
 
 Configuration, especially for the DBAL store and serialization, is typically handled via dependency injection, often simplified by the `StreakBundle` if using Symfony.