valentina-python-client 3.2.0__py3-none-any.whl → 3.4.0__py3-none-any.whl

{valentina_python_client-3.2.0.dist-info → valentina_python_client-3.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: valentina-python-client
-Version: 3.2.0
+Version: 3.4.0
 Summary: Async Python client library for the Valentina Noir API
 Author: Nate Landau
 Author-email: Nate Landau <github@natenate.org>
@@ -15,11 +15,12 @@ License: MIT License
          THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Dist: anyio>=4.14.1,<5.0.0
-Requires-Dist: httpx2>=2.5.0
+Classifier: Programming Language :: Python :: 3.15
+Requires-Dist: anyio>=4.15.1,<5.0.0
+Requires-Dist: httpx2>=2.13.1
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: polyfactory>=3.3.0,<4.0.0
-Requires-Dist: pydantic[email]>=2.13.4,<3.0.0
+Requires-Dist: pydantic[email]>=2.14.1,<3.0.0
 Requires-Dist: polyfactory>=3.3.0 ; extra == 'testing'
 Requires-Python: >=3.13
 Project-URL: Homepage, https://docs.valentina-noir.com/python-api-client/

{valentina_python_client-3.2.0.dist-info → valentina_python_client-3.4.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-vclient/__init__.py,sha256=hydi_5yJBNxfLX9_jWescrBQ8jjbSKt9qQyxPfXpvNI,3325
+vclient/__init__.py,sha256=aAvo9n1_iOStq-E0rETj69xA_DkZarCuyhDtPImAr3A,3361
 vclient/_codegen.py,sha256=iTw09vcpmpP9Uh7byQY2T9xHQ5Je9kSf9eaGCgm_EMA,15763
 vclient/_sync/__init__.py,sha256=Ewgxs5-wl73I3nieKaaPmoXwlE76gh65G6OMrx6UUkY,1408
 vclient/_sync/client.py,sha256=HTkYwLJizmAxpaJ5MOvQ0tTtlXLRbuP1UT19uqFa6ck,24031
@@ -8,18 +8,18 @@ vclient/_sync/services/_audit_params.py,sha256=qWAC7ZBmdXsiDPqAGnY56RoAvMHbHoZpI
 vclient/_sync/services/base.py,sha256=WMXOih9-PS1sus8nWVH2hxqbjXJ2mdGdGgGGiOdUOL8,27582
 vclient/_sync/services/campaign_book_chapters.py,sha256=_h_g5HFnbtdHZAmEsBQWcPCewVyQIu-os5atmRbkJuk,17931
 vclient/_sync/services/campaign_books.py,sha256=BAXYhStX8OvYewTjSBrFN0X0ivecd1BYOEfqQ0qMc-c,20094
-vclient/_sync/services/campaigns.py,sha256=IQaN5HLcRkRno8-X3SFIZAdT2eAKn8EsMt2isveJFBA,19833
+vclient/_sync/services/campaigns.py,sha256=OIO5n3DlSuPESRctrvFvZPfy0yJijGado0J7Y_58iaA,20148
 vclient/_sync/services/character_autogen.py,sha256=D2-jdCwJQznh38s_8nwNty0Rm32YS_lvrfRr-gy9C-0,5522
 vclient/_sync/services/character_blueprint.py,sha256=yb3biCtFq_kEKJqnNvT47VNAAzush8kgzsVz3il-rr0,18129
-vclient/_sync/services/character_traits.py,sha256=RtzGO9ZnpoYPZZjRFFw-8R7XtkuDa4RvBX5r4WzvFoI,10804
-vclient/_sync/services/characters.py,sha256=w6avY5Zby0ozpCbqxmOSQ0tkHq83g0n7aPxbRtqaf-w,34403
+vclient/_sync/services/character_traits.py,sha256=H2yrvyGffbZsGMRXp_QKtVj2uAEWguBzrSRgR_q30jk,20827
+vclient/_sync/services/characters.py,sha256=CU5ncQ4rayEderauWBCafwbvRFteQUtS3C8QIgvGiXc,38647
 vclient/_sync/services/companies.py,sha256=z5OQ9dz8Xyt7ak85SCPYb8ipThyH9fvV_ArV_Y9sVc8,16796
 vclient/_sync/services/developers.py,sha256=PGYiXiMIwgFdhcMlHYnR2hbm8bAGu-uJbD3jagUFAzw,3152
 vclient/_sync/services/dicerolls.py,sha256=ONCxGjjxqtq_vri2azX3xdEL4w1A2wn5CKj0odSe1Ds,6658
 vclient/_sync/services/dictionary.py,sha256=hJZ4r_JbYh22uWdzYCgdD-9EWAdWy5KbLIltAI9IclA,4710
 vclient/_sync/services/global_admin.py,sha256=ZUzJirPCumQ-1DEjzyvtFkJ5AGupV238HA8Tnlm8fp8,25506
 vclient/_sync/services/identity.py,sha256=sG7VhuwciCLBY6C3dpCtOHjlw1ejx8dy5vYlAJD31l8,3640
-vclient/_sync/services/options.py,sha256=UWNiUlDCweKuiOEioAaBbvwC6KJuIdZREl7_HsPTAmc,1526
+vclient/_sync/services/options.py,sha256=tUbyfJWp32gUWx7S9UhI1ykYNHw500C67_d2DEoYMmw,1848
 vclient/_sync/services/system.py,sha256=PWeXYGHu8CP8Q-mru20vtUWwadwi5d-cVC-d-o5QHyk,1426
 vclient/_sync/services/user_lookup.py,sha256=M9IE2l9HmksaCJu5a2rZ6LP96tDuIkFWyIAQ9oWCVNw,3114
 vclient/_sync/services/users.py,sha256=Axr6FINzVBYwJ88e5u2V6Elcwd7ydEQECM-SGI3UrLA,42877
@@ -27,26 +27,26 @@ vclient/_sync/testing/__init__.py,sha256=86UI6uFy62uUfpnBz7uEDsUHCXXhRqaOrkELeoH
 vclient/_sync/testing/_client.py,sha256=aV59HR9J4vmih4wgIRujaGGx9puXC6wtpqasDtch4kE,7817
 vclient/client.py,sha256=Tqb2lJI8BUvu_H9LwIFsLUF4GAsDnx4ousq-MXfUbvY,23715
 vclient/config.py,sha256=T9XcF6cYRVkAvSSgX2XxJ05zK1774WZ6C1vAYo96oZ4,1601
-vclient/constants.py,sha256=OIbTJKkstpXfqoyrnit6jLyLx2KeC6lxLUPShjp0lsU,3890
-vclient/endpoints.py,sha256=wVTtnTb_ne1IN7ROt632vfaztyBIvAzIljeJiGBMdTE,6736
-vclient/exceptions.py,sha256=XYY2njp3nNX7wqrUcRuODcgVtI5D44FbF2fOmlQbqFI,9516
-vclient/models/__init__.py,sha256=hKwFfPK4YnHFn1XbOsaJZcRZTbjeQw7OCvQUxKani0w,5804
+vclient/constants.py,sha256=jX4BV2mburh-uc7CfUzAo8yS_IflQvAUgKULa7V3RZ4,4168
+vclient/endpoints.py,sha256=xVa6Q_CRD-RJKwoPKEaL99LKulL1ronDVPinf-vUxZY,7125
+vclient/exceptions.py,sha256=XZ7UtwwyGXePDeTRQegA5We9pITwBdo-cs-941-Jj6A,9632
+vclient/models/__init__.py,sha256=Py83i-3iab4Au6XS4EGwDl2EarMyfyYX47B6GziEZpA,6420
 vclient/models/audit_logs.py,sha256=97kQdH2r8yzRnQotBtk43dDyEROVdwfZktBWGA7tdRE,1437
 vclient/models/books.py,sha256=9Iz1sRuvHkWxoR4Ac9C4ZIbVKwF6oBLJtpvIovWqGZo,3412
-vclient/models/campaigns.py,sha256=m8e9BPNncw6Pulg9tfMH68esq58lYs1Wq9mmufCphQ8,2080
+vclient/models/campaigns.py,sha256=dbc3itxCm14b4NENG4oF27ccU3Bo3zNNRiWsfDwXA_k,2197
 vclient/models/chapters.py,sha256=vCOZ_LSsNhBCairWRQ5Q3jVd70C-RXlQs5uWzPqZMgI,3137
 vclient/models/character_autogen.py,sha256=Zt1e3qZ33w5vt3FofjrXlhoXbno9WlwoVDA0iOYQcAM,1051
 vclient/models/character_blueprint.py,sha256=ijrpQj2505pfJUnI-kIjkzEBIZQf1Ep52rv-O07hJIk,3655
-vclient/models/character_trait.py,sha256=4ntW-6a3M1X_o6yEeOii3QBcknX_-kEREdcj2DYvvSQ,2854
-vclient/models/characters.py,sha256=BdfmB4qOqwc2syZislyiVewz5IEvJJYKW6WDzELqzPg,14839
-vclient/models/companies.py,sha256=Y4Ao2-aM8hh0808evLdQ5RPMj9bng3w17_w_ISWpTtM,4631
+vclient/models/character_trait.py,sha256=dOj7h97FOVZ-_BtiXNLHPtvrxsjGLjTLQH6X780QDQg,8412
+vclient/models/characters.py,sha256=Qwf38c4Zo5aZgkRVgX3yC3AiC6NHOgmZDaEH6btyn0I,15471
+vclient/models/companies.py,sha256=NQy8-_3wMx22PEVr-W9fzqd9B3okfBZN769nvkdptnE,4775
 vclient/models/developers.py,sha256=epmOZ6Lhds_VHGHPr3YJ1LXySTqANTfojHYw5y7VD9A,1743
 vclient/models/diceroll.py,sha256=hpKb-kE5rb9SE3mU7UHxZBrNBbiZyE4Qjw_vfvCCdpI,1962
-vclient/models/dictionary.py,sha256=eC8S_bXJMHUnZKUyogc89WdR3oB0pNMPseuKSB2C-yE,1064
+vclient/models/dictionary.py,sha256=E8MHZ4CIibtc51E3KnXqNZQJxi8mXAB-x5XCIy46tSQ,1248
 vclient/models/full_sheet.py,sha256=PcPsQLxZxU-8bLZATzfNSt0Ab1qu5ILRbhYgo-NnHrs,1705
 vclient/models/global_admin.py,sha256=JtLklUvbG9OsSmEGaQSCSBDIs6dv2Ka85i0WA8kmZ-A,2920
 vclient/models/pagination.py,sha256=WNfAhu56psLItpza-vM9dMHsZNoSQ4LqbgVb7Ve1BKQ,1682
-vclient/models/shared.py,sha256=1QW9UPcr2BrSUXAvXUgEB2vZnnLNg1a-TFtV-6VWoAE,5417
+vclient/models/shared.py,sha256=fAqPcBaTCOIb-vX5I7mJIi3d-Nhw04YrF0aE1TOsDjI,6416
 vclient/models/system.py,sha256=khQCz3ehEVvZGDuMUp5Oel3hl8fWd_643ugB6A9e7rc,476
 vclient/models/user_lookup.py,sha256=lyT78qy8Dg8gibqTQhw9lzpUPha58-oaN86jZPy-lC4,430
 vclient/models/users.py,sha256=Zg-1YKqp9PfFS4WjytO-dySD-3-jycp2vGvztNonHlU,10054
@@ -57,27 +57,27 @@ vclient/services/_audit_params.py,sha256=I91LYf6qIdXHtd5XqwsrRyIF4JUDq8z5UmDNgSZ
 vclient/services/base.py,sha256=9Jvmc5RUo28dDXc0VCHcLxl8waJkvc6Y-J4qLcyaC9c,29476
 vclient/services/campaign_book_chapters.py,sha256=JP0wKY2z9AQGx6CQB7WZNA4jQFqDvaZrSO_XR4PJmq0,19232
 vclient/services/campaign_books.py,sha256=ysx18zp0GRoeHA_ItDj13nt6vC73QLmnWpjzy7Mc-VY,21504
-vclient/services/campaigns.py,sha256=bicqHG6yo9xQlUD24iUD1GbBc_taRQooMv7wS13Byo4,21275
+vclient/services/campaigns.py,sha256=whSiQm2O8mnZpPGNCTSVymLWGccCf9PxHr3vHuXXBGg,21801
 vclient/services/character_autogen.py,sha256=S0nbVXQx18df0sz23Hu0nUHaVSH0G0qsQL780pDjWPU,5727
 vclient/services/character_blueprint.py,sha256=GbWIvdPHndsLdRj7pYTMtHdvX1S8rEWXDNqwn0eK8Ps,19571
-vclient/services/character_traits.py,sha256=V1GfNOIC08Zg0KHMY0loiVxUkbjogAC5WNd6Cdqq6hM,11241
-vclient/services/characters.py,sha256=FoWZ0l8WydJZ7RHTbObJUPnVO2ESopgMHY4QGI6_0uU,35681
+vclient/services/character_traits.py,sha256=u8Jt9inMbhc0h1qLqS-pVm8-p0-3nrt9LjKFEE1IFW4,21508
+vclient/services/characters.py,sha256=6rUMxkwOZJqG5OzPzW1nG6AWOT9yKgQ8Qhy8j4WTu7s,40380
 vclient/services/companies.py,sha256=rSgNP52pFSNvTzjvrUnBQnoYRCK7OrNCLT-Kve0kM2Q,17125
 vclient/services/developers.py,sha256=74RZ61TfY-HffJw643OvtzolyNtpjVo8_j9JNLQ1fsk,3133
 vclient/services/dicerolls.py,sha256=bp1r8FHc3vyrMjR2JM7TsXRVTG6EfVTa5j-EQPgWpFg,6886
 vclient/services/dictionary.py,sha256=4S9M8iISccrVZpQ1Di_4eS58q6Brl_bZT1eFPj3L2x8,4980
 vclient/services/global_admin.py,sha256=CVTtvGf0zvJea6hcSpoDk2F_1mJG9QESprc5dRd5HFE,26080
 vclient/services/identity.py,sha256=nrBT2-55yCgs8O5xnQfI-7IyZRSBfliFsgmQux0H_64,3562
-vclient/services/options.py,sha256=MIodZC4MlLNJ1ocWPIuBbK7fjsLshNg6rx6UyB2t5jc,1607
+vclient/services/options.py,sha256=Zdq_HQVTNL8_P3F6sGaBIMZ1KHrem0rMh9ZD5vW7JRg,1929
 vclient/services/system.py,sha256=2tgOwrKGVyzbBDHHDUWDWGrA1s2jSO20E6L9YjY8yIc,1335
 vclient/services/user_lookup.py,sha256=KQL3kFTQ192rs_Jags-LilQKWbAw5Qq5m2FqmB9Ci34,3071
 vclient/services/users.py,sha256=NYyInIyNZcwbZZbXRQA3CGS22fxSIH5AhNmOgHtoCmI,45075
-vclient/testing/__init__.py,sha256=9TvE1vuPijiA7UVoYm6mVL3KlBsoBxi508CJ2xevMrQ,3607
+vclient/testing/__init__.py,sha256=LJAld9JHT6ujPST_1s8S0Xp7Ix7Jva1iI8dauMCtwY8,3861
 vclient/testing/_client.py,sha256=8LaIH7D1pOlLwxzRgFCONln7VfGxI46W05g3_3EnAm4,7710
-vclient/testing/_factories.py,sha256=MRtxqzjkAwJH_3-OsEQ1jnOqAvq017BDNRM7g2xYTCg,9248
-vclient/testing/_router.py,sha256=RSoZ0wxn675NjQ-AHB-c-NwmelFaZdh5uGl5eJZy8gk,12221
-vclient/testing/_routes.py,sha256=cviYiArdl1DpcoO_WUyIQq2d_5QXQgLQyOlKJ1JT7RI,19145
-vclient/validate_constants.py,sha256=ntSEfjGkhrRBnXNhvavxgLoRFXQz4tAhc0XkhERE1t8,10464
-valentina_python_client-3.2.0.dist-info/WHEEL,sha256=CoDSoyhtC_eO_tlxRYzsTraPv1fPJRXFx91k6ISeAvA,81
-valentina_python_client-3.2.0.dist-info/METADATA,sha256=w4hnE3z2wfrSxZzMckhjDJTZC1RS7r6BsUeKWtUnOZk,4239
-valentina_python_client-3.2.0.dist-info/RECORD,,
+vclient/testing/_factories.py,sha256=4z7e1_vF5yW6hecbXzuWDklH8vgzP6H88g4gCs8olo4,14253
+vclient/testing/_router.py,sha256=TfQ8oUKrUjK4ysMuakrwDzJTODEkdMwIY8_T2uUyKf8,12619
+vclient/testing/_routes.py,sha256=piUShA0w-Fl0YoPk6FRNLS1kMXIQbQxCVQH7y-zOhIg,20348
+vclient/validate_constants.py,sha256=V1E23tagOrxzxdJwljOx5IQh-tj-yHYjdaJmq7kt4-o,10661
+valentina_python_client-3.4.0.dist-info/WHEEL,sha256=si2p8vW03RnhyBnhWl4tj-ObJa78SpE-c9HsEtblGR0,80
+valentina_python_client-3.4.0.dist-info/METADATA,sha256=UmlyzpsvRTElN2L1nFIPyFTxCjSaG5OcQFanO6PGsOI,4291
+valentina_python_client-3.4.0.dist-info/RECORD,,

{valentina_python_client-3.2.0.dist-info → valentina_python_client-3.4.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.11.28
+Generator: uv 0.13.5
 Root-Is-Purelib: true
 Tag: py3-none-any

vclient/__init__.py

@@ -31,7 +31,7 @@ _logger.add(
     # Forward TRACE too (e.g. the "Send request" line) and let the consumer's
     # stdlib logging level decide what to show; the sink must not pre-filter it.
     level="TRACE",
-    filter=lambda record: record["name"].startswith("vclient"),
+    filter=lambda record: record["name"].startswith("vclient"),  # ty: ignore[unresolved-attribute]
 )
 
 _logger.disable("vclient")
@@ -116,4 +116,4 @@ __all__ = (
     "users_service",
 )
 
-__version__ = "3.2.0"
+__version__ = "3.4.0"

vclient/_sync/services/campaigns.py

@@ -127,6 +127,7 @@ class SyncCampaignsService(SyncBaseService):
             request: A CampaignCreate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CampaignCreate if request is not provided.
                 Accepts: name (str, required), description (str | None),
+                in_game_date (datetime.date | None, ISO 8601 calendar date),
                 desperation (int, default 0), danger (int, default 0).
 
         Returns:
@@ -154,7 +155,8 @@ class SyncCampaignsService(SyncBaseService):
             request: A CampaignUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CampaignUpdate if request is not provided.
                 Accepts: name (str | None), description (str | None),
-                desperation (int | None), danger (int | None).
+                in_game_date (datetime.date | None, ISO 8601 calendar date;
+                pass None to clear it), desperation (int | None), danger (int | None).
 
         Returns:
             The updated Campaign object.
@@ -166,9 +168,11 @@ class SyncCampaignsService(SyncBaseService):
             ValidationError: If the request data is invalid.
         """
         body = request if request is not None else self._validate_request(CampaignUpdate, **kwargs)
+        payload = body.model_dump(exclude_none=True, exclude_unset=True, mode="json")
+        if "in_game_date" in body.model_fields_set and body.in_game_date is None:
+            payload["in_game_date"] = None
         response = self._patch(
-            self._format_endpoint(Endpoints.CAMPAIGN, campaign_id=campaign_id),
-            json=body.model_dump(exclude_none=True, exclude_unset=True, mode="json"),
+            self._format_endpoint(Endpoints.CAMPAIGN, campaign_id=campaign_id), json=payload
         )
         return Campaign.model_validate(response.json())
 

vclient/_sync/services/character_traits.py

@@ -5,15 +5,21 @@ from collections.abc import Iterator
 from typing import TYPE_CHECKING
 
 from vclient._sync.services.base import SyncBaseService
-from vclient.constants import DEFAULT_PAGE_LIMIT, TraitModifyCurrency
+from vclient.constants import DEFAULT_PAGE_LIMIT, DamageType, TrackerAction, TraitModifyCurrency
 from vclient.endpoints import Endpoints
 from vclient.models import (
+    _TRACKER_ADAPTER,
     BulkAssignTraitResponse,
     CharacterTrait,
     CharacterTraitAdd,
+    CharacterTraitSpecialtyCreate,
+    CharacterTraitSpecialtyUpdate,
     CharacterTraitValueOptionsResponse,
     PaginatedResponse,
+    Tracker,
+    TrackerStateSet,
     TraitCreate,
+    _TrackerAction,
     _TraitModify,
 )
 
@@ -140,6 +146,8 @@ class SyncCharacterTraitsService(SyncBaseService):
     def delete(self, character_trait_id: str, currency: TraitModifyCurrency | None = None) -> None:
         """Delete a character trait.
 
+        Any specialties on the trait are removed with it and the cost of each is refunded.
+
         Args:
             character_trait_id: The ID of the trait to delete.
             currency: The currency to use to recoup the cost of the trait.
@@ -152,6 +160,8 @@ class SyncCharacterTraitsService(SyncBaseService):
             AuthorizationError: If you don't have access to the character.
             RequestValidationError: If the input parameters fail client-side validation.
             ValidationError: If the request data is invalid.
+            ConflictError: If recouping ``XP`` or ``STARTING_POINTS`` and another request
+                changed the trait's value first. Refetch the trait and retry.
         """
         params: dict[str, str | int] = {}
         if currency is not None:
@@ -177,6 +187,8 @@ class SyncCharacterTraitsService(SyncBaseService):
             AuthorizationError: If you don't have access to the character.
             RequestValidationError: If the input parameters fail client-side validation.
             ValidationError: If the request data is invalid.
+            ConflictError: If paying with ``XP`` or ``STARTING_POINTS`` and another request
+                changed the trait's value first. Refetch the trait and retry.
         """
         body = self._validate_request(
             CharacterTraitAdd, trait_id=trait_id, value=value, currency=currency
@@ -222,8 +234,16 @@ class SyncCharacterTraitsService(SyncBaseService):
             **kwargs: Fields for TraitCreate if request is not provided.
                 Required: name (str), category_id (str), currency (TraitModifyCurrency).
                 Optional: description (str | None), max_value (int), min_value (int),
-                show_when_zero (bool), initial_cost (int | None),
-                upgrade_cost (int | None).
+                show_when_zero (bool), is_rollable (bool, default True),
+                initial_cost (int | None), upgrade_cost (int | None),
+                count_based_cost_multiplier (int | None).
+
+        Returns:
+            The newly created CharacterTrait object.
+
+        Raises:
+            ConflictError: If paying with ``XP`` or ``STARTING_POINTS`` and another request
+                changed the trait's value first. Refetch the trait and retry.
         """
         body = request if request is not None else self._validate_request(TraitCreate, **kwargs)
         response = self._post(
@@ -259,10 +279,20 @@ class SyncCharacterTraitsService(SyncBaseService):
     ) -> CharacterTrait:
         """Change the value of a character trait.
 
+        Lowering an ability to ``0`` also removes its specialties and refunds the cost of
+        each. The value change and the refunds are applied together or not at all.
+
         Args:
             character_trait_id: The ID of the trait to change the value of.
             new_value: The new value of the trait.
             currency: The currency to use for the modification.
+
+        Returns:
+            The updated CharacterTrait object.
+
+        Raises:
+            ConflictError: If another request changed the trait's value after this request
+                read it. Nothing is spent or refunded. Refetch the trait and retry.
         """
         body = self._validate_request(_TraitModify, target_value=new_value, currency=currency)
         response = self._put(
@@ -272,3 +302,197 @@ class SyncCharacterTraitsService(SyncBaseService):
             json=body.model_dump(exclude_none=True, exclude_unset=True, mode="json"),
         )
         return CharacterTrait.model_validate(response.json())
+
+    def add_specialty(
+        self, character_trait_id: str, name: str, currency: TraitModifyCurrency = "NO_COST"
+    ) -> CharacterTrait:
+        """Add a specialty to an ability trait.
+
+        Specialties are only available on abilities with a value of 1 or higher. When the
+        company's ``specialty_xp_cost_enabled`` setting is on, a specialty paid with ``XP``
+        or ``STARTING_POINTS`` costs 3 points, and ``NO_COST`` follows the company's
+        ``permission_free_trait_changes`` setting. When the setting is off, specialties are free.
+
+        Args:
+            character_trait_id: The ID of the ability trait.
+            name: The specialty name (3-50 characters), unique on the trait ignoring case.
+            currency: The currency to use to pay for the specialty.
+
+        Returns:
+            The updated CharacterTrait object, including its specialties.
+
+        Raises:
+            NotFoundError: If the trait does not exist.
+            AuthorizationError: If you don't have access to the character.
+            RequestValidationError: If the input parameters fail client-side validation.
+            ValidationError: If the trait is not an ability, has a value of 0, already has a
+                specialty with this name, the character cannot afford the cost, or an
+                ``NPC`` or ``STORYTELLER`` character pays with anything but ``NO_COST``.
+        """
+        body = self._validate_request(CharacterTraitSpecialtyCreate, name=name, currency=currency)
+        response = self._post(
+            self._format_endpoint(
+                Endpoints.CHARACTER_TRAIT_SPECIALTIES, character_trait_id=character_trait_id
+            ),
+            json=body.model_dump(exclude_none=True, mode="json"),
+        )
+        return CharacterTrait.model_validate(response.json())
+
+    def update_specialty(
+        self, character_trait_id: str, specialty_id: str, name: str
+    ) -> CharacterTrait:
+        """Rename a specialty on an ability trait.
+
+        Renaming never changes the cost paid or the currency used.
+
+        Args:
+            character_trait_id: The ID of the ability trait.
+            specialty_id: The ID of the specialty to rename.
+            name: The new specialty name (3-50 characters), unique on the trait ignoring case.
+
+        Returns:
+            The updated CharacterTrait object, including its specialties.
+
+        Raises:
+            NotFoundError: If the trait or specialty does not exist, or the specialty
+                belongs to a different trait.
+            AuthorizationError: If you don't have access to the character.
+            RequestValidationError: If the input parameters fail client-side validation.
+            ValidationError: If the trait already has a specialty with this name.
+        """
+        body = self._validate_request(CharacterTraitSpecialtyUpdate, name=name)
+        response = self._patch(
+            self._format_endpoint(
+                Endpoints.CHARACTER_TRAIT_SPECIALTY,
+                character_trait_id=character_trait_id,
+                specialty_id=specialty_id,
+            ),
+            json=body.model_dump(exclude_none=True, mode="json"),
+        )
+        return CharacterTrait.model_validate(response.json())
+
+    def delete_specialty(self, character_trait_id: str, specialty_id: str) -> None:
+        """Remove a specialty from an ability trait.
+
+        The cost paid is refunded in the currency used to buy it. An ``XP`` refund follows
+        the company's ``permission_recoup_xp`` setting; starting points are always refunded.
+
+        Args:
+            character_trait_id: The ID of the ability trait.
+            specialty_id: The ID of the specialty to remove.
+
+        Returns:
+            None
+
+        Raises:
+            NotFoundError: If the trait or specialty does not exist, or the specialty
+                belongs to a different trait.
+            AuthorizationError: If you don't have access to the character.
+        """
+        self._delete(
+            self._format_endpoint(
+                Endpoints.CHARACTER_TRAIT_SPECIALTY,
+                character_trait_id=character_trait_id,
+                specialty_id=specialty_id,
+            )
+        )
+
+    def get_tracker(self, character_trait_id: str) -> Tracker:
+        """Get the in-play tracker state of a character trait.
+
+        The same object appears as ``CharacterTrait.tracker``. Use this to refresh one
+        tracker without fetching the whole trait.
+
+        Args:
+            character_trait_id: The ID of the character trait.
+
+        Returns:
+            A CounterTracker, DamageTracker, or StainsTracker. Switch on ``type``.
+
+        Raises:
+            NotFoundError: If the trait has no tracker for the character's game version.
+            AuthorizationError: If you don't have access to the character.
+        """
+        response = self._get(
+            self._format_endpoint(
+                Endpoints.CHARACTER_TRAIT_TRACKER, character_trait_id=character_trait_id
+            )
+        )
+        return _TRACKER_ADAPTER.validate_python(response.json())
+
+    def set_tracker(
+        self, character_trait_id: str, request: TrackerStateSet | None = None, **kwargs
+    ) -> Tracker:
+        """Replace the full state of a trait tracker, such as to correct a mistake.
+
+        Send only the fields for the tracker's type: ``current`` for counters (required),
+        ``superficial`` and ``aggravated`` for damage tracks, ``stains`` for stains. Omitted
+        fields reset to 0, so an empty request clears a damage or stains tracker. Use
+        ``apply_tracker_action`` for in-play changes instead.
+
+        Args:
+            character_trait_id: The ID of the character trait.
+            request: A TrackerStateSet model, OR pass fields as keyword arguments.
+            **kwargs: Fields for TrackerStateSet if request is not provided.
+                Accepts: current, superficial, aggravated, stains (int >= 0).
+
+        Returns:
+            The updated tracker.
+
+        Raises:
+            NotFoundError: If the trait has no tracker for the character's game version.
+            AuthorizationError: If you are not the character's player or a storyteller.
+            RequestValidationError: If a value is negative.
+            ValidationError: If a field does not fit the tracker type, a counter has no
+                ``current``, or a value exceeds the tracker size.
+        """
+        body = request if request is not None else self._validate_request(TrackerStateSet, **kwargs)
+        response = self._put(
+            self._format_endpoint(
+                Endpoints.CHARACTER_TRAIT_TRACKER, character_trait_id=character_trait_id
+            ),
+            json=body.model_dump(exclude_none=True, mode="json"),
+        )
+        return _TRACKER_ADAPTER.validate_python(response.json())
+
+    def apply_tracker_action(
+        self,
+        character_trait_id: str,
+        action: TrackerAction,
+        *,
+        amount: int = 1,
+        damage_type: DamageType | None = None,
+    ) -> Tracker:
+        """Apply one in-play action to a trait tracker, such as spending Willpower.
+
+        The server applies the game rules for the character's game version. Which actions
+        and damage types fit each tracker is listed in ``characters.TrackerRules`` from
+        ``options.get_options()``. A STAINS response reports overflow into Willpower in
+        ``willpower_damage_applied``.
+
+        Args:
+            character_trait_id: The ID of the character trait.
+            action: The action to apply.
+            amount: How many points to apply. Must be at least 1.
+            damage_type: The damage type for ``damage`` and ``heal`` on damage tracks.
+
+        Returns:
+            The updated tracker.
+
+        Raises:
+            NotFoundError: If the trait has no tracker for the character's game version.
+            AuthorizationError: If you are not the character's player or a storyteller.
+            RequestValidationError: If ``amount`` is less than 1.
+            ValidationError: If the action or damage type does not fit the tracker, a
+                damage type is missing or not allowed, or a spend exceeds the current value.
+        """
+        body = self._validate_request(
+            _TrackerAction, action=action, amount=amount, damage_type=damage_type
+        )
+        response = self._post(
+            self._format_endpoint(
+                Endpoints.CHARACTER_TRAIT_TRACKER_ACTIONS, character_trait_id=character_trait_id
+            ),
+            json=body.model_dump(exclude_none=True, mode="json"),
+        )
+        return _TRACKER_ADAPTER.validate_python(response.json())

vclient/_sync/services/characters.py

@@ -12,6 +12,8 @@ from vclient.constants import (
     CharacterInclude,
     CharacterStatus,
     CharacterType,
+    DamageType,
+    TrackerAction,
 )
 from vclient.endpoints import Endpoints
 from vclient.models import (
@@ -22,6 +24,8 @@ from vclient.models import (
     CharacterFullSheet,
     CharacterUpdate,
     FullSheetTraitCategory,
+    Health,
+    HealthStateSet,
     InventoryItem,
     InventoryItemCreate,
     InventoryItemUpdate,
@@ -30,6 +34,7 @@ from vclient.models import (
     NoteUpdate,
     PaginatedResponse,
     RollStatistics,
+    _TrackerAction,
 )
 
 if TYPE_CHECKING:
@@ -241,6 +246,7 @@ class SyncCharactersService(SyncBaseService):
                 Required: campaign_id (str), character_class (CharacterClass),
                 game_version (GameVersion), name_first (str), name_last (str).
                 Optional: type (CharacterType), name_nick (str), age (int),
+                date_of_birth (datetime.date | None, ISO 8601 calendar date),
                 biography (str), demeanor (str), nature (str), concept_id (str),
                 user_player_id (str), traits (list), vampire_attributes, etc.
 
@@ -274,7 +280,8 @@ class SyncCharactersService(SyncBaseService):
             request: A CharacterUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for CharacterUpdate if request is not provided.
                 All fields are optional: character_class, type, game_version, status,
-                name_first, name_last, name_nick, age, biography, demeanor, nature,
+                name_first, name_last, name_nick, age, date_of_birth (datetime.date | None,
+                ISO 8601 calendar date; pass None to clear it), biography, demeanor, nature,
                 concept_id, user_player_id, vampire_attributes, werewolf_attributes, etc.
 
         Returns:
@@ -287,9 +294,11 @@ class SyncCharactersService(SyncBaseService):
             ValidationError: If the request data is invalid.
         """
         body = request if request is not None else self._validate_request(CharacterUpdate, **kwargs)
+        payload = body.model_dump(exclude_none=True, exclude_unset=True, mode="json")
+        if "date_of_birth" in body.model_fields_set and body.date_of_birth is None:
+            payload["date_of_birth"] = None
         response = self._patch(
-            self._format_endpoint(Endpoints.CHARACTER, character_id=character_id),
-            json=body.model_dump(exclude_none=True, exclude_unset=True, mode="json"),
+            self._format_endpoint(Endpoints.CHARACTER, character_id=character_id), json=payload
         )
         return Character.model_validate(response.json())
 
@@ -869,3 +878,94 @@ class SyncCharactersService(SyncBaseService):
                 Endpoints.CHARACTER_INVENTORY_ITEM, character_id=character_id, item_id=item_id
             )
         )
+
+    def get_health(self, character_id: str) -> Health:
+        """Get a character's health track.
+
+        The same object appears as ``Character.health``. Re-fetch it after changing V5
+        Stamina, which sets the track size.
+
+        Args:
+            character_id: The ID of the character.
+
+        Returns:
+            The character's Health.
+
+        Raises:
+            NotFoundError: If the character does not exist or has no health track.
+            AuthorizationError: If you don't have access to the character.
+        """
+        response = self._get(
+            self._format_endpoint(Endpoints.CHARACTER_HEALTH, character_id=character_id)
+        )
+        return Health.model_validate(response.json())
+
+    def set_health(
+        self, character_id: str, request: HealthStateSet | None = None, **kwargs
+    ) -> Health:
+        """Replace a character's full health state, such as to correct a mistake.
+
+        Every field is sent, so omitted fields reset to 0. V4 uses ``bashing``,
+        ``lethal``, and ``aggravated``; V5 uses ``superficial`` and ``aggravated``.
+        ``extra_levels`` applies to both. Use ``apply_health_action`` for in-play changes.
+
+        Args:
+            character_id: The ID of the character.
+            request: A HealthStateSet model, OR pass fields as keyword arguments.
+            **kwargs: Fields for HealthStateSet if request is not provided.
+                Accepts: extra_levels, superficial, aggravated, bashing, lethal (int >= 0).
+
+        Returns:
+            The updated Health.
+
+        Raises:
+            NotFoundError: If the character does not exist or has no health track.
+            AuthorizationError: If you are not the character's player or a storyteller.
+            RequestValidationError: If a value is negative.
+            ValidationError: If a nonzero field is not used by the game version, or the
+                marks exceed the track size.
+        """
+        body = request if request is not None else self._validate_request(HealthStateSet, **kwargs)
+        response = self._put(
+            self._format_endpoint(Endpoints.CHARACTER_HEALTH, character_id=character_id),
+            json=body.model_dump(mode="json"),
+        )
+        return Health.model_validate(response.json())
+
+    def apply_health_action(
+        self,
+        character_id: str,
+        action: TrackerAction,
+        *,
+        amount: int = 1,
+        damage_type: DamageType | None = None,
+    ) -> Health:
+        """Apply one in-play action to a character's health, such as taking damage.
+
+        Health accepts ``damage``, ``heal``, and ``reset``. V4 damage types are
+        ``BASHING``, ``LETHAL``, and ``AGGRAVATED``; V5 damage types are ``SUPERFICIAL``
+        and ``AGGRAVATED``. The server applies overflow and upgrade rules.
+
+        Args:
+            character_id: The ID of the character.
+            action: The action to apply.
+            amount: How many points to apply. Must be at least 1.
+            damage_type: The damage type for ``damage`` and ``heal``.
+
+        Returns:
+            The updated Health.
+
+        Raises:
+            NotFoundError: If the character does not exist or has no health track.
+            AuthorizationError: If you are not the character's player or a storyteller.
+            RequestValidationError: If ``amount`` is less than 1.
+            ValidationError: If the action or damage type does not fit the game version.
+        """
+        body = self._validate_request(
+            _TrackerAction, action=action, amount=amount, damage_type=damage_type
+        )
+        response = self._post(
+            self._format_endpoint(Endpoints.CHARACTER_HEALTH_ACTIONS, character_id=character_id),
+            json=body.model_dump(exclude_none=True, mode="json"),
+        )
+        return Health.model_validate(response.json())

vclient/_sync/services/options.py

@@ -2,7 +2,7 @@
 """Options and enumerations service."""
 
 import json
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any
 
 from vclient._sync.services.base import SyncBaseService
 from vclient.endpoints import Endpoints
@@ -32,9 +32,14 @@ class SyncOptionsService(SyncBaseService):
         """Format an endpoint with the scoped company_id plus any extra params."""
         return endpoint.format(company_id=self._company_id, **kwargs)
 
-    def get_options(self) -> dict[str, dict[str, list[str] | dict[str, str]]]:
+    def get_options(self) -> dict[str, dict[str, Any]]:
         """Retrieve all options and enumerations for the api.
 
+        Most values are lists of enum values. ``characters.TrackerRules`` is a nested map
+        ``{game_version: {tracker_key: {"actions": [...], "damage_types": [...]}}}`` where
+        ``tracker_key`` is a tracker type or ``HEALTH``. Use it to choose which tracker
+        actions and damage types to offer instead of hardcoding them.
+
         Returns:
             A dictionary of options and enumerations for the api.
         """