chore: update Python SDK to 16.0.0

Author: ChiragAgg5k

CHANGELOG.md

@@ -3,13 +3,12 @@
 ## 16.0.0
 
 * Breaking change: All service methods now return typed Pydantic models instead of `Dict[str, Any]`
+* Breaking change: Models with dynamic fields (e.g., `Row`, `Document`) now store user-defined data in a typed `.data` property instead of direct attribute access
 * Breaking change: Added `pydantic>=2,<3` as a required dependency
 * Breaking change: Minimum Python version raised from 3.5 to 3.9
 * Added `AppwriteModel` base class (Pydantic `BaseModel`) for all response models with `from_dict()` and `to_dict()` helpers
 * Added 130+ typed model classes under `appwrite/models/` (e.g., `Database`, `Collection`, `Document`, `User`, `Session`, `File`, `Bucket`, etc.)
-* Added `ActivityEvent` and `ActivityEventList` models and `Activities` service
-* Added `ValueClassEncoder` support for serializing `AppwriteModel` instances
-* Added `pyproject.toml` for modern Python packaging
+* Added Generic[T] support for models with dynamic fields (e.g., `Row`, `Document`) - pass `model_type=YourModel` to methods like `get_row()` or `list_rows()` for type-safe access to user-defined data via `result.data.field_name`
 * Updated README with `uv add appwrite` installation example
 * Updated all doc examples to use typed response models (e.g., `result: TemplateFunctionList = functions.list_templates(...)`)
 

README.md

@@ -84,6 +84,56 @@ print(user.name)       # Access fields as attributes
 print(user.to_dict())  # Convert to dictionary if needed
 ```
 
+### Type Safety with Models
+
+The Appwrite Python SDK provides type safety when working with database rows through generic methods. Methods like `get_row`, `list_rows`, and others accept a `model_type` parameter that allows you to specify your custom Pydantic model for full type safety.
+
+```python
+from pydantic import BaseModel
+from datetime import datetime
+from typing import Optional
+from appwrite.client import Client
+from appwrite.services.tables_db import TablesDB
+
+# Define your custom model matching your table schema
+class Post(BaseModel):
+    postId: int
+    authorId: int
+    title: str
+    content: str
+    createdAt: datetime
+    updatedAt: datetime
+    isPublished: bool
+    excerpt: Optional[str] = None
+
+client = Client()
+# ... configure your client ...
+
+tables_db = TablesDB(client)
+
+# Fetch a single row with type safety
+row = tables_db.get_row(
+    database_id="your-database-id",
+    table_id="your-table-id",
+    row_id="your-row-id",
+    model_type=Post  # Pass your custom model type
+)
+
+print(row.data.title)     # Fully typed - IDE autocomplete works
+print(row.data.postId)    # int type, not Any
+print(row.data.createdAt) # datetime type
+
+# Fetch multiple rows with type safety
+result = tables_db.list_rows(
+    database_id="your-database-id",
+    table_id="your-table-id",
+    model_type=Post
+)
+
+for row in result.rows:
+    print(f"{row.data.title} by {row.data.authorId}")
+```
+
 ### Error Handling
 The Appwrite Python SDK raises `AppwriteException` object with `message`, `code` and `response` properties. You can handle any errors by catching `AppwriteException` and present the `message` to the user or handle it yourself based on the provided error information. Below is an example.
 

appwrite/models/activity_event.py

@@ -1,6 +1,5 @@
-from typing import Any, Dict, List, Optional, Union
-
-from pydantic import Field
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
 
 from .base_model import AppwriteModel
 

appwrite/models/activity_event_list.py

@@ -1,6 +1,5 @@
-from typing import Any, Dict, List, Optional, Union
-
-from pydantic import Field
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
 
 from .base_model import AppwriteModel
 from .activity_event import ActivityEvent

appwrite/models/algo_argon2.py

@@ -1,6 +1,5 @@
-from typing import Any, Dict, List, Optional, Union
-
-from pydantic import Field
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
 
 from .base_model import AppwriteModel
 

appwrite/models/algo_bcrypt.py

@@ -1,6 +1,5 @@
-from typing import Any, Dict, List, Optional, Union
-
-from pydantic import Field
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
 
 from .base_model import AppwriteModel
 

appwrite/models/algo_md5.py

@@ -1,6 +1,5 @@
-from typing import Any, Dict, List, Optional, Union
-
-from pydantic import Field
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
 
 from .base_model import AppwriteModel
 

appwrite/models/algo_phpass.py

@@ -1,6 +1,5 @@
-from typing import Any, Dict, List, Optional, Union
-
-from pydantic import Field
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
 
 from .base_model import AppwriteModel
 

appwrite/models/algo_scrypt.py

@@ -1,6 +1,5 @@
-from typing import Any, Dict, List, Optional, Union
-
-from pydantic import Field
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
 
 from .base_model import AppwriteModel
 

appwrite/models/algo_scrypt_modified.py

@@ -1,6 +1,5 @@
-from typing import Any, Dict, List, Optional, Union
-
-from pydantic import Field
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
 
 from .base_model import AppwriteModel