Migrate to TypeScript

[RafaelAlves9]

This pull request introduces a full migration of the project from JavaScript to TypeScript. The primary goal is to improve the library's robustness, maintainability, and developer experience for consumers by providing type safety and better autocompletion.

This addresses the common issue where developers using this library in a TypeScript environment would get linter errors due to the lack of type definitions.

Key Changes:

• TypeScript Migration:

  • The entire codebase has been converted to TypeScript (src/index.ts) with strict mode enabled for maximum type safety.
  • The old prototype-based Query constructor has been refactored into a modern class structure.

• Type Definitions for Consumers:

  • The build process now automatically generates type declaration files (.d.ts).
  • Exported interfaces like IQueryOptions and IJob allow consumers to strongly type their interactions with the library.

• Modernized Build Process:

  • Added typescript and the necessary @types/* packages as devDependencies.
  • A tsconfig.json file has been configured to handle the compilation.
  • The package.json has been updated with:
    • A build script to transpile TypeScript to JavaScript.
    • A prepublishOnly script to ensure the code is always compiled before publishing.
    • A "files" property to guarantee the compiled dist/ directory is included in the final NPM package.

• Enhanced Testing:

  • The existing test file was migrated to TypeScript.
  • A new test suite (type-check.test.ts) was added to perform runtime validation on the structure and types of the data returned by the API, ensuring the contract is met.
  • The npm test command now builds the project and runs the complete test suite.

• Improved Project Structure:

  • The source code now resides in a src/ directory, cleanly separating it from the compiled output in dist/.

This set of changes makes the library more robust and easier to contribute to and consume, without introducing any breaking changes for existing JavaScript users.