Refactor and enhance config file handling logic

[mitsuki31]

Overview

This pull request refactors the logic around configuration file handling and updates the related documentation to improve code maintainability and clarity.

Changes Made

Refactors

• Improved the resolveConfig function:
  • Now sets the file parameter to 'unknown' only if it is null or not a string.
  • Fixed an issue where the file was being resolved to 'unknown' even when it was a valid string.
• Simplified audioConverterOptions assignment:
  • Removed unnecessary default initialization to empty objects.
• Refined the parseConfig function:
  • Uses require() exclusively for .cjs and .json files.
  • Uses import() for other extensions, streamlining the logic.
  • Removed redundant error handling specific to ESM module imports.
• Exported configChecker function to ensure consistency across the module.

Documentation Updates

• Added precise JSDoc comments for improved clarity on types and functionality.
• Updated visibility tags to @package for better encapsulation.
• Improved parameter types and return types in the documentation for consistency.
• Enhanced cross-references in JSDoc to improve navigation and clarity.

Impact

• Enhances the maintainability and readability of the configuration file handling code.
• Improves encapsulation and clarity through better documentation.

[codecov]

Codecov Report

Attention: Patch coverage is 71.42857% with 2 lines in your changes missing coverage. Please review.

Project coverage is 42.75%. Comparing base (238b15b) to head (07b2290).
Report is 4 commits behind head on master.

Files	Patch %	Lines
lib/config.js	71.42%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master      #39      +/-   ##
==========================================
+ Coverage   42.54%   42.75%   +0.20%     
==========================================
  Files           7        7              
  Lines         409      407       -2     
==========================================
  Hits          174      174              
+ Misses        235      233       -2     

Flag	Coverage Δ
Ubuntu	42.75% <71.42%> (+0.20%)	⬆️
Windows	42.75% <71.42%> (+0.20%)	⬆️
macOS	42.75% <71.42%> (+0.20%)	⬆️
unittests	42.75% <71.42%> (+0.20%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.