added better errors thrown + examples/
bumped package, added examples to README