feat: add rate limit tracking and public API

[banter240]

Essential improvements for production use:

Rate Limit Support (NEW):

• Add: Store response headers from API calls
• Add: Parse RateLimit headers per IETF draft spec
• Add: rate_limit property returning (limit, remaining) tuple
• Add: last_headers property for debugging
• Change: Use context manager to access headers before consuming body

Public API (NEW - enables extensions):

• Add: session property (get aiohttp ClientSession)
• Add: home_id property (get home ID)
• Add: access_token property (get OAuth token)
• Add: refresh_auth() public method (refresh token)

Model Fixes:

• Fix: ZoneState null nextTimeBlock handling (API sometimes returns null)

Breaking Changes: None (only additions and one critical bug fix)

All changes are backward compatible. Existing code works unchanged.

Enables Home Assistant integrations to:

• Track API quota usage (rate_limit property)
• Build extensions without private attribute access (public API)
• Handle edge cases in API responses (ZoneState fix)

[erwindouna]

Thanks for contributing, here an initial review. :)

[erwindouna]

Making solid progress. tadoasync is heavily tested. Would you mind including/updating tests, that way we can ensure we're releasing a solid package. :)

[erwindouna]

So I think, the only thing left are updating the tests. :)

[wmalgadey]

@erwindouna and @banter240 besides the tests, doesn't it make sense to add some kind of example or documentation because why exactly this is usefull or how it can be used?

[erwindouna]

@erwindouna and @banter240 besides the tests, doesn't it make sense to add some kind of example or documentation because why exactly this is usefull or how it can be used?

It sure does! :)

[github-actions]

There hasn't been any activity on this pull request recently. This pull request has been automatically marked as stale because of that and will be closed if no further activity occurs within 7 days. Thank you for your contributions.

[erwindouna]

Some unresolved conflicts, @banter240. Can you check? :)