Export utilities APIs to public and minor fixes

[mitsuki31]

Overview

This pull request introduces several enhancements, including the addition of new utility APIs, improvements to the YouTube URL regex, and minor fixes to existing modules. The changes aim to provide developers with more robust tools for working with YouTube URLs and handling errors effectively.

Key Changes

New Features

• Added and exported the following standalone API functions:
  • extractVideoId: Extracts the video ID from a YouTube URL.

    function extractVideoId(url: string | URL): string;

  • validateUrl: Validates whether a given URL is a valid YouTube URL.

    function validateUrl(url: string | URL): boolean;

  • validateId: Validates whether a given string is a valid YouTube video ID.

    function validateId(id: string): boolean;

• Exported all custom error classes from the error module, providing more robust error handling capabilities. This includes:
  • IDExtractorError

    class IDExtractorError extends Error {}

  • UnknownOptionError

    class UnknownOptionError extends Error {}

• Exported the YTURLUtils class (aliased from URLUtils), which offers static methods for developers working with YouTube URLs.

Refactors

• Improved the regular expression used for YouTube URL validation to make it more accurate and reliable.

Fixes

• Corrected the exports statement in the error module to ensure all custom error classes are exported properly.
  Previously, when attempt to import the error module, the returned object is an empty object ({}).

Test Environments

• Updated test cases to use the IDExtractorError class, replacing the previous string representation of the class name with the actual class.

Summary

These updates enhance the flexibility and reliability of the ytmp3 module by introducing new utility APIs and refining existing components. The improved YouTube URL validation regex and corrected export statements ensure a smoother experience for developers integrating YouTube functionalities into their projects. The added utilities and error handling enhancements will help prevent common issues and streamline the development process.