[lib] an optional function for complete failure scenarios
[doc] update readme
[dist] version bump