README Update, Package.json Fixes, and TypeScript Types Addition

[fabiorigam]

I hope you're doing well! I've just pushed some updates to the repository that I believe will enhance the project's clarity, reliability, and maintainability. This PR encompasses the following changes:

• Added clarity to the README.md.
• Fixed commands in package.json.
• Integrated TypeScript types for better maintainability.

I've thoroughly tested these changes in my local environment to ensure they don't introduce any unintended side effects. However, I encourage you to review the PR at your convenience to ensure that everything aligns with the project's goals and standards.

Please feel free to provide feedback, suggestions, or ask any questions you might have. I'm looking forward to your thoughts on these improvements.