Make sunset warning handling configurable

[Michel Edkrantz (MichelEdkrantz)]

Summary

• Add SunsetHandler = Callable[[datetime, str, str], None] type alias
• Add default_sunset_handler(threshold_days=14) factory that returns the standard logging behaviour with a configurable escalation threshold
• handle_sunset, create_session, BaseApiClient, and BaseAsyncApiClient all accept an optional sunset_handler parameter — pass None to disable, a factory call to adjust the threshold, or any callable for fully custom behaviour
• SunsetHandler and default_sunset_handler re-exported from the top-level kognic.auth package

Usage

from kognic.auth import default_sunset_handler
from kognic.auth.requests import BaseApiClient

# Adjust threshold
client = BaseApiClient(sunset_handler=default_sunset_handler(threshold_days=30))

# Disable entirely
client = BaseApiClient(sunset_handler=None)

# Custom handler (e.g. raise instead of log)
def strict(sunset_date, method, url):
    raise DeprecationWarning(f"Deprecated endpoint: {method} {url}")

client = BaseApiClient(sunset_handler=strict)

Test plan

• All 212 existing tests pass (uv run pytest)
• Ruff check and format pass with no changes

🤖 Generated with Claude Code