Adding/changing comments on the hapi/node side

Some comments and interface definitions for the server side
do we have to specify params in jsdoc?