Cleanup client api's

Complete all TODO:'s, answer all '?' comments, and make changes for readability, performance, and stability. Changes should be limited to the 'shared' folder. Changes can be made elsewhere if they relate to the usage/functionality of the aforementioned files (example: minor changes to server code in order to support a change in functionality/protocol). Documentation should also be completed, and accurately reflect the functionality of the underlying code.