@ziming submitted pr #44 which includes several improvements we should consider for future releases:
At the time of our most recent update we did not want to merge this as it could break support for legacy apps, but I have created this issue for reference as these are good ideas which we may wish to include in the next major version.