valentina-python-client 1.4.0__tar.gz → 1.5.0__tar.gz

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: valentina-python-client
-Version: 1.4.0
+Version: 1.5.0
 Summary: Async Python client library for the Valentina Noir API
 Author: Nate Landau
 Author-email: Nate Landau <github@natenate.org>
@@ -38,11 +38,11 @@ Async Python client library for accessing the Valentina Noir API.
 - **Idempotency support** - Optional automatic idempotency keys for safe retries
 - **Rate limit handling** - Built-in support for automatic rate limit retries
 
-This client is a supported and up-to-date reference implementation for the Valentina Noir API. The full documentation for is available at https://docs.valentina-noir.com/python-api-client/.
+This client is a supported and up-to-date reference implementation for the [Valentina Noir API](https://docs.valentina-noir.com).
 
 ## Documentation
 
-For complete documentation including configuration options, all available services, response models, and error handling, see the **[Full Documentation](https://docs.valentina-noir.com/python-api-client/)**.
+The full documentation is available at https://natelandau.github.io/valentina-python-client/.
 
 ## Development Tools
 
@@ -65,9 +65,3 @@ The script reads configuration from (highest precedence first):
 3. A `.env.secret` file in the project root
 
 Exit codes: `0` = all constants match, `1` = mismatches found, `2` = missing configuration.
-
-## Resources
-
-- [Full Client Documentation](https://docs.valentina-noir.com/python-api-client/)
-- [API Concepts](https://docs.valentina-noir.com/concepts/)
-- [API Reference](https://api.valentina-noir.com/docs)

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/README.md

@@ -12,11 +12,11 @@ Async Python client library for accessing the Valentina Noir API.
 - **Idempotency support** - Optional automatic idempotency keys for safe retries
 - **Rate limit handling** - Built-in support for automatic rate limit retries
 
-This client is a supported and up-to-date reference implementation for the Valentina Noir API. The full documentation for is available at https://docs.valentina-noir.com/python-api-client/.
+This client is a supported and up-to-date reference implementation for the [Valentina Noir API](https://docs.valentina-noir.com).
 
 ## Documentation
 
-For complete documentation including configuration options, all available services, response models, and error handling, see the **[Full Documentation](https://docs.valentina-noir.com/python-api-client/)**.
+The full documentation is available at https://natelandau.github.io/valentina-python-client/.
 
 ## Development Tools
 
@@ -39,9 +39,3 @@ The script reads configuration from (highest precedence first):
 3. A `.env.secret` file in the project root
 
 Exit codes: `0` = all constants match, `1` = mismatches found, `2` = missing configuration.
-
-## Resources
-
-- [Full Client Documentation](https://docs.valentina-noir.com/python-api-client/)
-- [API Concepts](https://docs.valentina-noir.com/concepts/)
-- [API Reference](https://api.valentina-noir.com/docs)

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/pyproject.toml

@@ -10,7 +10,7 @@
     name = "valentina-python-client"
     readme = "README.md"
     requires-python = ">=3.13"
-    version = "1.4.0"
+    version = "1.5.0"
 
     [project.urls]
         Homepage   = "https://docs.valentina-noir.com/python-api-client/"
@@ -46,6 +46,7 @@
         "vulture>=2.14",
         "yamllint>=1.38.0",
     ]
+    docs = ["zensical>=0.0.23"]
 
 [tool.commitizen]
     bump_message               = "bump(release): v$current_version → v$new_version"

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/src/vclient/__init__.py

@@ -71,4 +71,4 @@ __all__ = (
     "users_service",
 )
 
-__version__ = "1.4.0"
+__version__ = "1.5.0"

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/src/vclient/constants.py

@@ -55,10 +55,10 @@ HunterEdgeType = Literal["ASSETS", "APTITUDES", "ENDOWMENTS"]
 ManageCampaignPermission = Literal["UNRESTRICTED", "STORYTELLER"]
 PermissionLevel = Literal["USER", "ADMIN", "OWNER", "REVOKE"]
 RollResultType = Literal["SUCCESS", "FAILURE", "BOTCH", "CRITICAL", "OTHER"]
-S3AssetParentType = Literal[
+AssetParentType = Literal[
     "character", "campaign", "campaignbook", "campaignchapter", "user", "company", "unknown"
 ]
-S3AssetType = Literal["image", "text", "audio", "video", "document", "archive", "other"]
+AssetType = Literal["image", "text", "audio", "video", "document", "archive", "other"]
 SpecialtyType = Literal["ACTION", "OTHER", "PASSIVE", "RITUAL", "SPELL"]
 UserRole = Literal["ADMIN", "STORYTELLER", "PLAYER"]
 WerewolfRenown = Literal["HONOR", "GLORY", "WISDOM"]

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/src/vclient/models/__init__.py

@@ -95,13 +95,13 @@ from .global_admin import (
 )
 from .pagination import PaginatedResponse
 from .shared import (
+    Asset,
     CharacterSpecialty,
     NameDescriptionSubDocument,
     Note,
     NoteCreate,
     NoteUpdate,
     RollStatistics,
-    S3Asset,
     Trait,
     WerewolfGift,
     WerewolfRite,
@@ -120,6 +120,7 @@ from .users import (
 )
 
 __all__ = [
+    "Asset",
     "BookCreate",
     "BookUpdate",
     "Campaign",
@@ -183,7 +184,6 @@ __all__ = [
     "QuickrollCreate",
     "QuickrollUpdate",
     "RollStatistics",
-    "S3Asset",
     "SheetSection",
     "SystemHealth",
     "Trait",

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/src/vclient/models/shared.py

@@ -6,10 +6,10 @@ from typing import Annotated, Any
 from pydantic import BaseModel, Field
 
 from vclient.constants import (
+    AssetParentType,
+    AssetType,
     CharacterClass,
     GameVersion,
-    S3AssetParentType,
-    S3AssetType,
     SpecialtyType,
     WerewolfRenown,
 )
@@ -31,22 +31,22 @@ class NameDescriptionSubDocument(BaseModel):
 # -----------------------------------------------------------------------------
 
 
-class S3Asset(BaseModel):
-    """Response model for an S3 asset.
+class Asset(BaseModel):
+    """Response model for an asset.
 
-    Represents a file asset stored in S3, including its URL and metadata.
+    Represents a file asset, including its URL and metadata.
     """
 
     id: str
     date_created: datetime
     date_modified: datetime
-    asset_type: S3AssetType
+    asset_type: AssetType
     mime_type: str
     original_filename: str
     public_url: str
     uploaded_by: str
     company_id: str
-    parent_type: S3AssetParentType | None = None
+    parent_type: AssetParentType | None = None
     parent_id: str | None = None
 
 
@@ -197,13 +197,13 @@ class CharacterSpecialty(BaseModel):
 
 
 __all__ = [
+    "Asset",
     "CharacterSpecialty",
     "NameDescriptionSubDocument",
     "Note",
     "NoteCreate",
     "NoteUpdate",
     "RollStatistics",
-    "S3Asset",
     "Trait",
     "WerewolfGift",
     "WerewolfRite",

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/src/vclient/services/campaign_book_chapters.py

@@ -7,6 +7,7 @@ from typing import TYPE_CHECKING
 from vclient.constants import DEFAULT_PAGE_LIMIT
 from vclient.endpoints import Endpoints
 from vclient.models import (
+    Asset,
     CampaignChapter,
     ChapterCreate,
     ChapterUpdate,
@@ -14,7 +15,6 @@ from vclient.models import (
     NoteCreate,
     NoteUpdate,
     PaginatedResponse,
-    S3Asset,
     _ChapterRenumber,
 )
 from vclient.services.base import BaseService
@@ -342,14 +342,14 @@ class ChaptersService(BaseService):
     # Asset Methods
     # -------------------------------------------------------------------------
 
-    async def list_assets(
+    async def get_assets_page(
         self,
         chapter_id: str,
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
-    ) -> PaginatedResponse[S3Asset]:
-        """Retrieve a paginated list of assets for a chapter.
+    ) -> PaginatedResponse[Asset]:
+        """Retrieve a paginated page of assets for a chapter.
 
         Args:
             chapter_id: The ID of the chapter whose assets to list.
@@ -357,7 +357,7 @@ class ChaptersService(BaseService):
             offset: Number of items to skip from the beginning (default 0).
 
         Returns:
-            A PaginatedResponse containing S3Asset objects and pagination metadata.
+            A PaginatedResponse containing Asset objects and pagination metadata.
 
         Raises:
             NotFoundError: If the chapter does not exist.
@@ -365,16 +365,65 @@ class ChaptersService(BaseService):
         """
         return await self._get_paginated_as(
             self._format_endpoint(Endpoints.BOOK_CHAPTER_ASSETS, chapter_id=chapter_id),
-            S3Asset,
+            Asset,
             limit=limit,
             offset=offset,
         )
 
+    async def list_all_assets(
+        self,
+        chapter_id: str,
+    ) -> list[Asset]:
+        """Retrieve all assets for a chapter.
+
+        Automatically paginates through all results. Use `get_assets_page()` for paginated
+        access or `iter_all_assets()` for memory-efficient streaming of large datasets.
+
+        Args:
+            chapter_id: The ID of the chapter whose assets to list.
+
+        Returns:
+            A list of all Asset objects.
+
+        Raises:
+            NotFoundError: If the chapter does not exist.
+            AuthorizationError: If you don't have access.
+        """
+        return [asset async for asset in self.iter_all_assets(chapter_id)]
+
+    async def iter_all_assets(
+        self,
+        chapter_id: str,
+        *,
+        limit: int = 100,
+    ) -> AsyncIterator[Asset]:
+        """Iterate through all assets for a chapter.
+
+        Yields individual assets, automatically fetching subsequent pages until
+        all items have been retrieved.
+
+        Args:
+            chapter_id: The ID of the chapter whose assets to iterate.
+            limit: Items per page (default 100 for efficiency).
+
+        Yields:
+            Individual Asset objects.
+
+        Example:
+            >>> async for asset in chapters.iter_all_assets("chapter_id"):
+            ...     print(asset.original_filename)
+        """
+        async for item in self._iter_all_pages(
+            self._format_endpoint(Endpoints.BOOK_CHAPTER_ASSETS, chapter_id=chapter_id),
+            limit=limit,
+        ):
+            yield Asset.model_validate(item)
+
     async def get_asset(
         self,
         chapter_id: str,
         asset_id: str,
-    ) -> S3Asset:
+    ) -> Asset:
         """Retrieve details of a specific asset including its URL and metadata.
 
         Args:
@@ -382,7 +431,7 @@ class ChaptersService(BaseService):
             asset_id: The ID of the asset to retrieve.
 
         Returns:
-            The S3Asset object with full details.
+            The Asset object with full details.
 
         Raises:
             NotFoundError: If the asset does not exist.
@@ -393,7 +442,7 @@ class ChaptersService(BaseService):
                 Endpoints.BOOK_CHAPTER_ASSET, chapter_id=chapter_id, asset_id=asset_id
             )
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def upload_asset(
         self,
@@ -401,7 +450,7 @@ class ChaptersService(BaseService):
         filename: str,
         content: bytes,
         content_type: str | None = None,
-    ) -> S3Asset:
+    ) -> Asset:
         """Upload a new asset for a chapter.
 
         Uploads a file to S3 storage and associates it with the chapter.
@@ -413,7 +462,7 @@ class ChaptersService(BaseService):
             content_type: The MIME type of the file. If not provided, inferred from filename.
 
         Returns:
-            The created S3Asset object with the public URL and metadata.
+            The created Asset object with the public URL and metadata.
 
         Raises:
             NotFoundError: If the chapter does not exist.
@@ -427,7 +476,7 @@ class ChaptersService(BaseService):
             self._format_endpoint(Endpoints.BOOK_CHAPTER_ASSET_UPLOAD, chapter_id=chapter_id),
             file=(filename, content, content_type),
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def delete_asset(
         self,

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/src/vclient/services/campaign_books.py

@@ -7,6 +7,7 @@ from typing import TYPE_CHECKING
 from vclient.constants import DEFAULT_PAGE_LIMIT
 from vclient.endpoints import Endpoints
 from vclient.models import (
+    Asset,
     BookCreate,
     BookUpdate,
     CampaignBook,
@@ -14,7 +15,6 @@ from vclient.models import (
     NoteCreate,
     NoteUpdate,
     PaginatedResponse,
-    S3Asset,
     _BookRenumber,
 )
 from vclient.services.base import BaseService
@@ -438,14 +438,14 @@ class BooksService(BaseService):
     # Asset Methods
     # -------------------------------------------------------------------------
 
-    async def list_assets(
+    async def get_assets_page(
         self,
         book_id: str,
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
-    ) -> PaginatedResponse[S3Asset]:
-        """Retrieve a paginated list of assets for a book.
+    ) -> PaginatedResponse[Asset]:
+        """Retrieve a paginated page of assets for a book.
 
         Args:
             book_id: The ID of the book whose assets to list.
@@ -453,7 +453,7 @@ class BooksService(BaseService):
             offset: Number of items to skip from the beginning (default 0).
 
         Returns:
-            A PaginatedResponse containing S3Asset objects and pagination metadata.
+            A PaginatedResponse containing Asset objects and pagination metadata.
 
         Raises:
             NotFoundError: If the book does not exist.
@@ -461,16 +461,65 @@ class BooksService(BaseService):
         """
         return await self._get_paginated_as(
             self._format_endpoint(Endpoints.BOOK_ASSETS, book_id=book_id),
-            S3Asset,
+            Asset,
             limit=limit,
             offset=offset,
         )
 
+    async def list_all_assets(
+        self,
+        book_id: str,
+    ) -> list[Asset]:
+        """Retrieve all assets for a book.
+
+        Automatically paginates through all results. Use `get_assets_page()` for paginated
+        access or `iter_all_assets()` for memory-efficient streaming of large datasets.
+
+        Args:
+            book_id: The ID of the book whose assets to list.
+
+        Returns:
+            A list of all Asset objects.
+
+        Raises:
+            NotFoundError: If the book does not exist.
+            AuthorizationError: If you don't have access.
+        """
+        return [asset async for asset in self.iter_all_assets(book_id)]
+
+    async def iter_all_assets(
+        self,
+        book_id: str,
+        *,
+        limit: int = 100,
+    ) -> AsyncIterator[Asset]:
+        """Iterate through all assets for a book.
+
+        Yields individual assets, automatically fetching subsequent pages until
+        all items have been retrieved.
+
+        Args:
+            book_id: The ID of the book whose assets to iterate.
+            limit: Items per page (default 100 for efficiency).
+
+        Yields:
+            Individual Asset objects.
+
+        Example:
+            >>> async for asset in books.iter_all_assets("book_id"):
+            ...     print(asset.original_filename)
+        """
+        async for item in self._iter_all_pages(
+            self._format_endpoint(Endpoints.BOOK_ASSETS, book_id=book_id),
+            limit=limit,
+        ):
+            yield Asset.model_validate(item)
+
     async def get_asset(
         self,
         book_id: str,
         asset_id: str,
-    ) -> S3Asset:
+    ) -> Asset:
         """Retrieve details of a specific asset including its URL and metadata.
 
         Args:
@@ -478,7 +527,7 @@ class BooksService(BaseService):
             asset_id: The ID of the asset to retrieve.
 
         Returns:
-            The S3Asset object with full details.
+            The Asset object with full details.
 
         Raises:
             NotFoundError: If the asset does not exist.
@@ -487,7 +536,7 @@ class BooksService(BaseService):
         response = await self._get(
             self._format_endpoint(Endpoints.BOOK_ASSET, book_id=book_id, asset_id=asset_id)
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def upload_asset(
         self,
@@ -495,7 +544,7 @@ class BooksService(BaseService):
         filename: str,
         content: bytes,
         content_type: str | None = None,
-    ) -> S3Asset:
+    ) -> Asset:
         """Upload a new asset for a book.
 
         Uploads a file to S3 storage and associates it with the book.
@@ -507,7 +556,7 @@ class BooksService(BaseService):
             content_type: The MIME type of the file. If not provided, inferred from filename.
 
         Returns:
-            The created S3Asset object with the public URL and metadata.
+            The created Asset object with the public URL and metadata.
 
         Raises:
             NotFoundError: If the book does not exist.
@@ -521,7 +570,7 @@ class BooksService(BaseService):
             self._format_endpoint(Endpoints.BOOK_ASSET_UPLOAD, book_id=book_id),
             file=(filename, content, content_type),
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def delete_asset(
         self,

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/src/vclient/services/campaigns.py

@@ -7,6 +7,7 @@ from typing import TYPE_CHECKING
 from vclient.constants import DEFAULT_PAGE_LIMIT
 from vclient.endpoints import Endpoints
 from vclient.models import (
+    Asset,
     Campaign,
     CampaignCreate,
     CampaignUpdate,
@@ -15,7 +16,6 @@ from vclient.models import (
     NoteUpdate,
     PaginatedResponse,
     RollStatistics,
-    S3Asset,
 )
 from vclient.services.base import BaseService
 
@@ -249,14 +249,14 @@ class CampaignsService(BaseService):
     # Asset Methods
     # -------------------------------------------------------------------------
 
-    async def list_assets(
+    async def get_assets_page(
         self,
         campaign_id: str,
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
-    ) -> PaginatedResponse[S3Asset]:
-        """Retrieve a paginated list of assets for a campaign.
+    ) -> PaginatedResponse[Asset]:
+        """Retrieve a paginated page of assets for a campaign.
 
         Args:
             campaign_id: The ID of the campaign whose assets to list.
@@ -264,7 +264,7 @@ class CampaignsService(BaseService):
             offset: Number of items to skip from the beginning (default 0).
 
         Returns:
-            A PaginatedResponse containing S3Asset objects and pagination metadata.
+            A PaginatedResponse containing Asset objects and pagination metadata.
 
         Raises:
             NotFoundError: If the campaign does not exist.
@@ -272,16 +272,65 @@ class CampaignsService(BaseService):
         """
         return await self._get_paginated_as(
             self._format_endpoint(Endpoints.CAMPAIGN_ASSETS, campaign_id=campaign_id),
-            S3Asset,
+            Asset,
             limit=limit,
             offset=offset,
         )
 
+    async def list_all_assets(
+        self,
+        campaign_id: str,
+    ) -> list[Asset]:
+        """Retrieve all assets for a campaign.
+
+        Automatically paginates through all results. Use `get_assets_page()` for paginated
+        access or `iter_all_assets()` for memory-efficient streaming of large datasets.
+
+        Args:
+            campaign_id: The ID of the campaign whose assets to list.
+
+        Returns:
+            A list of all Asset objects.
+
+        Raises:
+            NotFoundError: If the campaign does not exist.
+            AuthorizationError: If you don't have access.
+        """
+        return [asset async for asset in self.iter_all_assets(campaign_id)]
+
+    async def iter_all_assets(
+        self,
+        campaign_id: str,
+        *,
+        limit: int = 100,
+    ) -> AsyncIterator[Asset]:
+        """Iterate through all assets for a campaign.
+
+        Yields individual assets, automatically fetching subsequent pages until
+        all items have been retrieved.
+
+        Args:
+            campaign_id: The ID of the campaign whose assets to iterate.
+            limit: Items per page (default 100 for efficiency).
+
+        Yields:
+            Individual Asset objects.
+
+        Example:
+            >>> async for asset in campaigns.iter_all_assets("campaign_id"):
+            ...     print(asset.original_filename)
+        """
+        async for item in self._iter_all_pages(
+            self._format_endpoint(Endpoints.CAMPAIGN_ASSETS, campaign_id=campaign_id),
+            limit=limit,
+        ):
+            yield Asset.model_validate(item)
+
     async def get_asset(
         self,
         campaign_id: str,
         asset_id: str,
-    ) -> S3Asset:
+    ) -> Asset:
         """Retrieve details of a specific asset including its URL and metadata.
 
         Args:
@@ -289,7 +338,7 @@ class CampaignsService(BaseService):
             asset_id: The ID of the asset to retrieve.
 
         Returns:
-            The S3Asset object with full details.
+            The Asset object with full details.
 
         Raises:
             NotFoundError: If the asset does not exist.
@@ -300,7 +349,7 @@ class CampaignsService(BaseService):
                 Endpoints.CAMPAIGN_ASSET, campaign_id=campaign_id, asset_id=asset_id
             )
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def delete_asset(
         self,
@@ -331,7 +380,7 @@ class CampaignsService(BaseService):
         filename: str,
         content: bytes,
         content_type: str | None = None,
-    ) -> S3Asset:
+    ) -> Asset:
         """Upload a new asset for a campaign.
 
         Uploads a file to S3 storage and associates it with the campaign.
@@ -343,7 +392,7 @@ class CampaignsService(BaseService):
             content_type: The MIME type of the file. If not provided, inferred from filename.
 
         Returns:
-            The created S3Asset object with the public URL and metadata.
+            The created Asset object with the public URL and metadata.
 
         Raises:
             NotFoundError: If the campaign does not exist.
@@ -357,7 +406,7 @@ class CampaignsService(BaseService):
             self._format_endpoint(Endpoints.CAMPAIGN_ASSET_UPLOAD, campaign_id=campaign_id),
             file=(filename, content, content_type),
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     # -------------------------------------------------------------------------
     # Notes Methods

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/src/vclient/services/characters.py

@@ -12,6 +12,7 @@ from vclient.constants import (
 )
 from vclient.endpoints import Endpoints
 from vclient.models import (
+    Asset,
     Character,
     CharacterCreate,
     CharacterUpdate,
@@ -25,7 +26,6 @@ from vclient.models import (
     PaginatedResponse,
     Perk,
     RollStatistics,
-    S3Asset,
     WerewolfGift,
     WerewolfRite,
 )
@@ -333,14 +333,14 @@ class CharactersService(BaseService):
     # Asset Methods
     # -------------------------------------------------------------------------
 
-    async def list_assets(
+    async def get_assets_page(
         self,
         character_id: str,
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
-    ) -> PaginatedResponse[S3Asset]:
-        """Retrieve a paginated list of assets for a campaign.
+    ) -> PaginatedResponse[Asset]:
+        """Retrieve a paginated page of assets for a character.
 
         Args:
             character_id: The ID of the character whose assets to list.
@@ -348,24 +348,73 @@ class CharactersService(BaseService):
             offset: Number of items to skip from the beginning (default 0).
 
         Returns:
-            A PaginatedResponse containing S3Asset objects and pagination metadata.
+            A PaginatedResponse containing Asset objects and pagination metadata.
 
         Raises:
-            NotFoundError: If the campaign does not exist.
+            NotFoundError: If the character does not exist.
             AuthorizationError: If you don't have access.
         """
         return await self._get_paginated_as(
             self._format_endpoint(Endpoints.CHARACTER_ASSETS, character_id=character_id),
-            S3Asset,
+            Asset,
             limit=limit,
             offset=offset,
         )
 
+    async def list_all_assets(
+        self,
+        character_id: str,
+    ) -> list[Asset]:
+        """Retrieve all assets for a character.
+
+        Automatically paginates through all results. Use `get_assets_page()` for paginated
+        access or `iter_all_assets()` for memory-efficient streaming of large datasets.
+
+        Args:
+            character_id: The ID of the character whose assets to list.
+
+        Returns:
+            A list of all Asset objects.
+
+        Raises:
+            NotFoundError: If the character does not exist.
+            AuthorizationError: If you don't have access.
+        """
+        return [asset async for asset in self.iter_all_assets(character_id)]
+
+    async def iter_all_assets(
+        self,
+        character_id: str,
+        *,
+        limit: int = 100,
+    ) -> AsyncIterator[Asset]:
+        """Iterate through all assets for a character.
+
+        Yields individual assets, automatically fetching subsequent pages until
+        all items have been retrieved.
+
+        Args:
+            character_id: The ID of the character whose assets to iterate.
+            limit: Items per page (default 100 for efficiency).
+
+        Yields:
+            Individual Asset objects.
+
+        Example:
+            >>> async for asset in characters.iter_all_assets("character_id"):
+            ...     print(asset.original_filename)
+        """
+        async for item in self._iter_all_pages(
+            self._format_endpoint(Endpoints.CHARACTER_ASSETS, character_id=character_id),
+            limit=limit,
+        ):
+            yield Asset.model_validate(item)
+
     async def get_asset(
         self,
         character_id: str,
         asset_id: str,
-    ) -> S3Asset:
+    ) -> Asset:
         """Retrieve details of a specific asset including its URL and metadata.
 
         Args:
@@ -373,7 +422,7 @@ class CharactersService(BaseService):
             asset_id: The ID of the asset to retrieve.
 
         Returns:
-            The S3Asset object with full details.
+            The Asset object with full details.
 
         Raises:
             NotFoundError: If the asset does not exist.
@@ -384,7 +433,7 @@ class CharactersService(BaseService):
                 Endpoints.CHARACTER_ASSET, character_id=character_id, asset_id=asset_id
             )
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def delete_asset(
         self,
@@ -415,7 +464,7 @@ class CharactersService(BaseService):
         filename: str,
         content: bytes,
         content_type: str | None = None,
-    ) -> S3Asset:
+    ) -> Asset:
         """Upload a new asset for a campaign.
 
         Uploads a file to S3 storage and associates it with the campaign.
@@ -427,7 +476,7 @@ class CharactersService(BaseService):
             content_type: The MIME type of the file. If not provided, inferred from filename.
 
         Returns:
-            The created S3Asset object with the public URL and metadata.
+            The created Asset object with the public URL and metadata.
 
         Raises:
             NotFoundError: If the character does not exist.
@@ -441,7 +490,7 @@ class CharactersService(BaseService):
             self._format_endpoint(Endpoints.CHARACTER_ASSET_UPLOAD, character_id=character_id),
             file=(filename, content, content_type),
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     # -------------------------------------------------------------------------
     # Notes Methods

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/src/vclient/services/users.py

@@ -7,6 +7,7 @@ from typing import TYPE_CHECKING
 from vclient.constants import DEFAULT_PAGE_LIMIT, UserRole
 from vclient.endpoints import Endpoints
 from vclient.models import (
+    Asset,
     CampaignExperience,
     Note,
     NoteCreate,
@@ -16,7 +17,6 @@ from vclient.models import (
     QuickrollCreate,
     QuickrollUpdate,
     RollStatistics,
-    S3Asset,
     User,
     UserCreate,
     UserUpdate,
@@ -275,14 +275,14 @@ class UsersService(BaseService):
     # Asset Methods
     # -------------------------------------------------------------------------
 
-    async def list_assets(
+    async def get_assets_page(
         self,
         user_id: str,
         *,
         limit: int = DEFAULT_PAGE_LIMIT,
         offset: int = 0,
-    ) -> PaginatedResponse[S3Asset]:
-        """Retrieve a paginated list of assets for a user.
+    ) -> PaginatedResponse[Asset]:
+        """Retrieve a paginated page of assets for a user.
 
         Args:
             user_id: The ID of the user whose assets to list.
@@ -290,7 +290,7 @@ class UsersService(BaseService):
             offset: Number of items to skip from the beginning (default 0).
 
         Returns:
-            A PaginatedResponse containing S3Asset objects and pagination metadata.
+            A PaginatedResponse containing Asset objects and pagination metadata.
 
         Raises:
             NotFoundError: If the user does not exist.
@@ -298,16 +298,65 @@ class UsersService(BaseService):
         """
         return await self._get_paginated_as(
             self._format_endpoint(Endpoints.USER_ASSETS, user_id=user_id),
-            S3Asset,
+            Asset,
             limit=limit,
             offset=offset,
         )
 
+    async def list_all_assets(
+        self,
+        user_id: str,
+    ) -> list[Asset]:
+        """Retrieve all assets for a user.
+
+        Automatically paginates through all results. Use `get_assets_page()` for paginated
+        access or `iter_all_assets()` for memory-efficient streaming of large datasets.
+
+        Args:
+            user_id: The ID of the user whose assets to list.
+
+        Returns:
+            A list of all Asset objects.
+
+        Raises:
+            NotFoundError: If the user does not exist.
+            AuthorizationError: If you don't have access to the company.
+        """
+        return [asset async for asset in self.iter_all_assets(user_id)]
+
+    async def iter_all_assets(
+        self,
+        user_id: str,
+        *,
+        limit: int = 100,
+    ) -> AsyncIterator[Asset]:
+        """Iterate through all assets for a user.
+
+        Yields individual assets, automatically fetching subsequent pages until
+        all items have been retrieved.
+
+        Args:
+            user_id: The ID of the user whose assets to iterate.
+            limit: Items per page (default 100 for efficiency).
+
+        Yields:
+            Individual Asset objects.
+
+        Example:
+            >>> async for asset in users.iter_all_assets("user_id"):
+            ...     print(asset.original_filename)
+        """
+        async for item in self._iter_all_pages(
+            self._format_endpoint(Endpoints.USER_ASSETS, user_id=user_id),
+            limit=limit,
+        ):
+            yield Asset.model_validate(item)
+
     async def get_asset(
         self,
         user_id: str,
         asset_id: str,
-    ) -> S3Asset:
+    ) -> Asset:
         """Retrieve details of a specific asset including its URL and metadata.
 
         Args:
@@ -315,7 +364,7 @@ class UsersService(BaseService):
             asset_id: The ID of the asset to retrieve.
 
         Returns:
-            The S3Asset object with full details.
+            The Asset object with full details.
 
         Raises:
             NotFoundError: If the asset does not exist.
@@ -324,7 +373,7 @@ class UsersService(BaseService):
         response = await self._get(
             self._format_endpoint(Endpoints.USER_ASSET, user_id=user_id, asset_id=asset_id)
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     async def delete_asset(
         self,
@@ -353,7 +402,7 @@ class UsersService(BaseService):
         filename: str,
         content: bytes,
         content_type: str | None = None,
-    ) -> S3Asset:
+    ) -> Asset:
         """Upload a new asset for a user.
 
         Uploads a file to S3 storage and associates it with the user.
@@ -365,7 +414,7 @@ class UsersService(BaseService):
             content_type: The MIME type of the file. If not provided, inferred from filename.
 
         Returns:
-            The created S3Asset object with the public URL and metadata.
+            The created Asset object with the public URL and metadata.
 
         Raises:
             NotFoundError: If the user does not exist.
@@ -379,7 +428,7 @@ class UsersService(BaseService):
             self._format_endpoint(Endpoints.USER_ASSET_UPLOAD, user_id=user_id),
             file=(filename, content, content_type),
         )
-        return S3Asset.model_validate(response.json())
+        return Asset.model_validate(response.json())
 
     # -------------------------------------------------------------------------
     # Experience Methods

{valentina_python_client-1.4.0 → valentina_python_client-1.5.0}/src/vclient/validate_constants.py

@@ -77,8 +77,8 @@ CONSTANT_MAP: dict[str, ConstantMapping] = {
     "ManageCampaignPermission": ConstantMapping("companies", "PermissionManageCampaign"),
     "PermissionLevel": ConstantMapping("companies", "CompanyPermission"),
     "RollResultType": ConstantMapping("gameplay", "RollResultType"),
-    "S3AssetParentType": ConstantMapping("assets", "AssetParentType"),
-    "S3AssetType": ConstantMapping("assets", "AssetType"),
+    "AssetParentType": ConstantMapping("assets", "AssetParentType"),
+    "AssetType": ConstantMapping("assets", "AssetType"),
     "SpecialtyType": ConstantMapping("characters", "SpecialtyType"),
     "TraitModifyCurrency": ConstantMapping("characters", "TraitModifyCurrency"),
     "UserRole": ConstantMapping("users", "UserRole"),