add comment
update documentation with new property names
fix realtime module + cleaner metadata abstraction

- better metadata abstractions
- more db->metadata renaming