Docs for token and tokenPayload are incorrect

[nightpool]

The docs for token and tokenPayload say

If the user is loggedIn(), the token will be returned immediate, else it will open a popup and wait until the user is loggedIn() (i.e. a new token has been added)."

However, this is incorrect. token() and tokenPayload() do not open a popup on their own, they have to be used in combination .

IMO, this is pretty inconvenient for an implementor. It would be better if token() and tokenPayload() matched the documented behavior, and just "did the right thing" automatically depending on whether the user was logged in or not.