lib: fix and improve os JSDoc typings
We add JSDoc comments in lib files to help core developers. I feel it would be important for core developers to know whether a param is optional and what it's default value is.
This PR makes the following changes in lib/os.js:
- marked optional params as such
- assigned default values using JSDoc conventions.