test,feat: add mypy type support

[Unique-Divine]

Mypy is a static type checker for Python. This ticket is requesting the addition of type annotations to the codebase to support mypy static type checking. This will improve code quality by making refactors safer and prevent type-related bugs.