pass entity to newId()
new docs, bug note