feat: add support to CommonJS

[guilhermewerner]

This PR adds

Support for CommonJS modules using esbuild.

Closes #517

Explanation

To support projects that use ESModules and CommonJS at the same time, it is possible to use a bundler to transpile the code.

In this PR, esbuild was used, available in the file tools/esbuild.js, when executing this file a lib bundle converted to CommonJS is generated, which can then be used by projects that use require.

So that the npm package knows which file should be used according to the project type, the main directive of package.json was replaced by exports, which determines the two files that will be exported according to the type.

"exports": {
    "import": "./lib/index.js",
    "require": "./dist/index.cjs"
},

The bundler settings can be changed in the script, in this PR the transpiled file is created in the dist/index.cjs folder, however it is up to the lib maintainers to decide where this file should be, just remember that this file was generated by the bundler and It has relatively low readability and should be ignored from the repository.

To facilitate the package publishing process on NPM, scripts were created to run the build automatically when the package is installed (prepare).

The examples were also changed to demonstrate use with require and import.

Detail about the got dependency

The http client library that is used only supports ESModules (sindresorhus/got#1789).

To fix this, it is included in the bundle so that esbuild can convert its source code. The downside of this is that the bundle file becomes much larger.

[CosminPerRam]

LGTM, thanks bunch.

Edit: forgot to mention to add a line in the changelog file.

[CosminPerRam]

Thanks bunch, just a note to have them for future references:

Detail about the got dependency

This is unfortunate, but we'll have to go with this for now.

I too think that the abrupt move to ESM wasn't exactly the best choice for v5, but I think it'll be fair to completely remove support for it for v6 (as by then we would already be passing 3 years since stable esm support).

[CosminPerRam]

Forgot to mention to add a line in the changelog file

[guilhermewerner]

Forgot to mention to add a line in the changelog file

I always forget the changelog 🫠

[podrivo]

@guilhermewerner Sorry, a last minute conflict... :(