Async support for managers (SyncManager, HighlightManager, etc.)

[EvanOman]

Summary

The manager classes (SyncManager, HighlightManager, BookManager, DocumentManager) are synchronous only. For async applications, async versions would be valuable.

Current Managers

• HighlightManager - high-level highlight operations
• BookManager - high-level book operations
• DocumentManager - high-level document operations
• SyncManager - incremental sync with state tracking

Proposed Async Managers

from readwise_sdk.managers import AsyncHighlightManager, AsyncSyncManager

async with AsyncReadwiseClient() as client:
    manager = AsyncHighlightManager(client)
    highlights = await manager.get_highlights_since(days=7)
    
    sync_mgr = AsyncSyncManager(client, state_file='sync.json')
    result = await sync_mgr.sync_highlights(on_item=callback)

Priority

This is lower priority than #16 and #17. Applications can work with the raw async client methods. Managers are a convenience layer.

Related

• Depends on AsyncReadwiseClient missing v2/v3 API properties #16 (AsyncReadwiseClient v2/v3 properties)