Tools

StateLens

StateLens is a browser tool for reading an event sourced store: the events appended to it, the aggregates and projections snapshotted from them, and the types both were written through. Point it at a store, upload a zip of your own domain assemblies with a statelens.json at its root, and it folds an aggregate from its events so you can see the state a snapshot stands at and how far behind its history it is. It creates nothing and deletes nothing.

It began in this repository, as Memoria Web, a reader of Memoria stores. It reads any framework’s store now: a service’s manifest tells the tool which of the uploaded types are the streams, events, aggregates and projections, how they are named and folded, and where in the store the events and snapshots are. Memoria’s own stores are described the same way as anyone else’s; the tool knows no framework by name.

It lives in its own private repository, and everything about it is on its site:

The framework packages are Apache 2.0 regardless: nothing in them depends on the tool, and nothing in the tool changes their licence.

  • Licence — Apache 2.0 for the framework, and where the tool’s terms are
  • Release notes — the versions of the framework the tool was developed alongside