Add Comprehensive Type Hints & Models for Enhanced IDE Support

[LifeJiggy]

📝 Add Comprehensive Type Hints & Models for Enhanced IDE Support

This PR exposes thorough type definitions for all DigitalOcean resources, greatly improving IDE support, autocomplete, and type checking for all pydo users.

---

🛠️ Problem Solved

Previously, users worked with generic Dict[str, Any] types, which meant:

• No IDE autocomplete for DigitalOcean resource properties
• Runtime type errors instead of development-time detection
• Poor developer experience when exploring the API

---

🚀 Solution

• Exposed Types: All TypedDict classes now available via from pydo import types
• Type Hints: Added precise type annotations to Client methods
• IDE Support: Full autocomplete and type checking in modern IDEs
• Documentation: Updated README with clear type usage examples

---

🌟 Key Features

• Complete Coverage: TypedDict classes for Droplet, SSHKey, Region, Size, Image, Volume, and more
• Response Types: API responses have proper typing (e.g., DropletsResponse, SSHKeysResponse, etc.)
• Type Safety: Catch type errors during development
• Easy Import: Access all type definitions with from pydo import types

---

🧑‍💻 Usage Examples

from pydo import Client, types

client = Client(token="...")

# Type hints for responses
droplets: types.DropletsResponse = client.droplets.list()

# Type hints for individual resources
def process_droplet(droplet: types.Droplet) -> None:
    print(f"Name: {droplet['name']}, Status: {droplet['status']}")

# Available types include: Droplet, SSHKey, Region, Size, Image, Volume, etc.

---

📄 Files Changed

• src/pydo/_patch.py — Exposed types module and added type hints
• README.md — Added documentation and examples for type hints

---

💥 Impact

• Developer Experience: Major improvement with IDE autocomplete and type checking
• Type Safety: Catch errors at development time instead of runtime
• API Discoverability: Easier to explore and understand DigitalOcean resources
• Zero Breaking Changes: Fully backward compatible

---

🧪 Testing

• Import test passed: from pydo import types works correctly
• All existing functionality preserved
• Type hints validated for correctness

---

Feedback and suggestions are welcome!

[LifeJiggy]

Thank you for considering this PR!
By exposing comprehensive type definitions and adding type hints throughout the codebase, this change greatly improves the developer experience for everyone using pydo. IDE autocomplete, type checking, and resource discoverability are all significantly enhanced, making it easier and safer to build on top of the DigitalOcean API.
Feedback and suggestions for further improvement are welcome!