always assign the new token	

even if we need to call back with an error
more tests, docs
rebuild dist/ and tweak workflow
workflow fix