Adds jsDoc comments and cleans up JS logic

[tif-calin]

Summary

• adds jsDoc comments. If you've used TypeScript before it's essentially that but as simple JS comments. IDEs pick up on it and use it to provide type information and additional comments (see screenshots)
• cleans up JS logic. This is a bit subjective but I found parts of it hard to parse and tried to update it to make more sense and be in line with professional js style guides like airbnb's JS linter
• updates the package-lock.json. The old one was generated with an older version of npm and it was recommended to update it

Screenshots

IDE picks up comments and parameter types

IDE provides autocomplete for available config properties

IDE provides typehints for available config properties