moeru-ai/eventa

Eventa is a toolkit that helps different parts of an application talk to each other through events. In web development, different pieces of a program, like a background worker and the main screen, often need to send messages back and forth. This project provides a single, consistent way to define those messages and handle them, regardless of whether the pieces are running in a browser tab, a desktop app, or on a server. At its core, you define an event once, including the exact shape of the data it carries. Then you create a "context," which acts as a bridge connecting to wherever the message needs to go, like a WebSocket or a Web Worker. You can use these events for simple fire-and-forget notifications, or you can string them together to create request-and-response flows, similar to calling a function and waiting for it to return a result. A key feature is the ability to "pipe" or "link" contexts together, so an event triggered in one place, like an iframe, can automatically be forwarded to another, like a server, with optional rules to filter or modify the data along the way. This is designed for developers building applications where the user interface needs to communicate with background tasks or remote servers. For example, if you are building a desktop app with Electron and need the interface to request data from the computer's file system, this lets you set up that request safely. It is also useful for apps that use WebSockets to stream real-time data, or that run heavy computations in background workers to keep the interface responsive. What stands out is how it abstracts away the specific communication method. The project includes ready-made adapters for common platforms, meaning you can switch the underlying transport, like moving from a browser BroadcastChannel to a WebSocket, without rewriting your event logic. It is worth noting that the project focuses on delivering messages reliably but leaves data validation to the developer, reminding users to validate any incoming data if it comes from untrusted sources.