feat: add checker for pin by id

[musale]

This pull request introduces major improvements to the GavaConnect SDK, focusing on modular authentication, resource client structure, and developer experience. It adds a new async facade for easier usage, introduces a flexible authentication provider system (including Basic and Bearer flows), and reorganizes the codebase to make resource clients and their dependencies more explicit. The documentation and usage examples are also significantly expanded and clarified.

The most important changes are:

Authentication System Enhancements

• Added BasicPair credential type and BasicTokenEndpointProvider for supporting HTTP Basic authentication against token endpoints, enabling flexible per-resource authentication flows. [1] [2] [3] [4]
• Improved ClientCredentialsProvider to support configurable timeouts and minimum token TTL, and refactored token refresh logic for concurrency safety and reliability. [1] [2] [3] [4]

Async Facade and Resource Client Structure

• Introduced AsyncGavaConnect as an async facade with per-resource credentials, simplifying client setup and context management for users.
• Added explicit resource client modules, including CheckersClient and PinCheckResult for KRA PIN validation, with clear dependency documentation and explicit imports. [1] [2] [3]

Developer Experience and Documentation

• Expanded and clarified the README.md with basic, PIN validation, and advanced usage examples, and updated the authentication documentation to explain the pluggable policy system and per-resource credential isolation. [1] [2]
• Updated pyproject.toml to include pydantic as a core dependency and added an optional OpenTelemetry dependency group. [1] [2]

Validation and Utility Improvements

• Improved KRA PIN validation logic in KRAPINChecker to provide more robust format and content checks, with clear error messages.
• Made OpenTelemetry tracing optional and fail-safe, so the SDK degrades gracefully if tracing libraries are not installed. [1] [2] [3]

[Copilot]

Pull Request Overview

This pull request introduces a comprehensive PIN validation feature for the GavaConnect SDK with enhanced authentication and modular architecture. The main focus is adding KRA PIN validation capabilities through a new async facade pattern and improved authentication flow using Basic-to-Bearer token conversion.

• Adds CheckersClient with PIN validation endpoints supporting both POST and GET variants
• Implements BasicTokenEndpointProvider for flexible HTTP Basic authentication against token endpoints
• Introduces AsyncGavaConnect facade for simplified client setup with per-resource credentials
• Enhances OpenTelemetry integration with graceful degradation when libraries are unavailable

Reviewed Changes

Copilot reviewed 22 out of 25 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
tests/unit/test_checkers_*.py	Comprehensive test coverage for PIN validation success, GET variant, 401 retry, and error scenarios
tests/test_telemetry_degradation.py	Tests for graceful OpenTelemetry degradation without required dependencies
tests/test_pin.py	Enhanced PIN format validation tests with improved edge case coverage
gavaconnect/resources/checkers/	New modular PIN validation client with Pydantic models and alias support
gavaconnect/facade_async.py	Async facade providing simplified SDK usage with automatic credential management
gavaconnect/auth/	Enhanced authentication with Basic credential types and token endpoint providers
gavaconnect/http/telemetry.py	Optional OpenTelemetry support with fail-safe behavior
Configuration files	Updated dependencies and documentation for new features

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!