fix: update release workflow to only trigger on published releases and improve optional fields in data classes

Author: Sub0X

.github/workflows/release.yml

@@ -4,7 +4,7 @@ on:
   push:
     branches: [main]          # bump version & create Release
   release:
-    types: [published, created]        # build & upload to PyPI
+    types: [published]        # build & upload to PyPI
   workflow_dispatch:          # allow manual trigger
 
 permissions:
@@ -52,7 +52,7 @@ jobs:
           git config user.name  "github-actions"
           git config user.email "github-actions@github.com"
           git add src/veedb/VERSION
-          git commit -m "chore: bump version to v$NEW_VERSION [skip ci]" || true
+          git commit -m "chore: bump version to v$NEW_VERSION" || true
           git tag -a "v$NEW_VERSION" -m "Release v$NEW_VERSION"
           git push origin HEAD
           git push origin "v$NEW_VERSION"
@@ -103,7 +103,8 @@ jobs:
 
       - name: Set up Python
         uses: actions/setup-python@v5.6.0
-        with: { python-version: '3.x' }
+        with:
+            python-version: '3.x'
 
       - name: Install build deps
         run: |

src/veedb/apitypes/common.py

@@ -139,12 +139,12 @@
 
 @dataclass
 class ImageCommon:
-    id: VNDBID
-    url: str
-    dims: List[int]  # [width, height]
-    sexual: float  # 0.0-2.0 (average flagging vote)
-    violence: float  # 0.0-2.0 (average flagging vote)
-    votecount: int
+    id: Optional[VNDBID]
+    url: Optional[str]
+    dims: Optional[List[int]]  # [width, height]
+    sexual: Optional[float]  # 0.0-2.0 (average flagging vote)
+    violence: Optional[float]  # 0.0-2.0 (average flagging vote)
+    votecount: Optional[int]
 
 
 @dataclass

src/veedb/apitypes/entities/vn.py

@@ -34,9 +34,7 @@ class VNTitle:
 @dataclass
 class VNImageInfo(ImageCommon):  # For vn.image and vn.screenshots
     thumbnail: Optional[str] = None
-    thumbnail_dims: Optional[Tuple[int, int]] = None
-    # For screenshots, 'release' can be a nested object.
-    # Using Dict[str, Any] for simplicity, or define a VNScreenshotReleaseInfo
+
     release: Optional[Dict[str, Any]] = (
         None  # e.g. {'id': 'r123', 'title': 'Release Title'}
     )
@@ -47,8 +45,7 @@ class VNRelation:  # vn.relations
     id: VNDBID  # The related VN's ID
     relation: str  # e.g., "preq", "seq", "alt", "side", "par", "ser", "fan", "orig"
     relation_official: bool
-    # Other VN fields can be selected here via dot notation in the 'fields' query param
-    # Example: title of the related VN
+
     title: Optional[str] = None
     original_language: Optional[LanguageEnum] = None  # Example: olang of related VN