fix(tests): fixes async tests using promises

also adds a bit of documentation