feat: add pagination support with sync and async iterable paginators

[hamzamahmood]

What

This PR adds support for

1. CursorPagination
2. LinkPagination
3. NumberPagination
4. OffsetPagination

And provides Paginator and AsyncPaginator with the ability to iterate over the pages and items of the paginated response.

Why

Previously, handling paginated responses required manual parsing and iteration, leading to verbose and error-prone code.

Type of change

Select multiple if applicable.

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause a breaking change)
• Tests (adds or updates tests)
• Documentation (adds or updates documentation)
• Refactor (style improvements, performance improvements, code refactoring)
• Revert (reverts a commit)
• CI/Build (adds or updates a script, change in external dependencies)

Checklist

• My code follows the coding conventions
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have added new unit tests

[sonarqubecloud]

Quality Gate passed

Issues
2 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud