TODO: this is a public module that graph component implementers will interact with, so it should be documented