docs: document token return value type

closes #41