Looks good, would be good to split this commit so that changes are more visible in the history

@cliffclick I split the commits, it would be good to add test cases to cover the new code

@nitsanw ? what's the status of this? @cliffclick 🙏

i'm sorry, I don;'t understand the question.
I've used this code is various projects; it's in production in at least one active company I co-founded.
As far as I am concerned, its rock-solid... given the copious caveats mentioned in the api.