fix: parsing rules based on customer setup/feedback

Author: devraj

docs/docs/design.md

@@ -55,6 +55,7 @@ There are three types of schema definitions, each one of them suffixed with thei
 - **Summary** is what is returned by the Gallagher API in operations such as [searches](https://gallaghersecurity.github.io/cc-rest-docs/ref/cardholders.html), these are generally a subset of the full object
 - **Detail** are the full object found at a particular `href`, they compound on the `Summary` schema and add additional attributes
 - **Responses** are resposnes sent back from the server, these will typically contain a set of `Summary` or `Detail` objects. When fetching _detailed_ responses for an object the server will often respond with a `Detail` object without a wrapper `Response` object.
+- **Payloads** are objects that are sent to the server as part of a `POST` or `PUT` operation, these are suffixed with **Payload**, some of these also offer `Builder` classes to assist with construction of the payload.
 
 I additional we have classes that defined responses which are suffixed with **Response**, these wrap structures which returns `hrefs` for `next` and `previous` responses and usually have a collection to hold the response.
 

gallagher/dto/detail/cardholder.py

@@ -53,7 +53,7 @@ class CardholderPersonalDataField(
     value, which also is accessible using the key at the dictionary level.
     """
     definition: PdfSummary
-    value: str | HrefMixin
+    value: str | HrefMixin | int | float | bool | None
     notifications: Optional[bool] = False  # Local to the @Email field
 
 

gallagher/dto/payload/cardholder.py

@@ -0,0 +1,17 @@
+""" Cardholder Update Builder exploration
+
+"""
+from ..ref.card import CardTypeRef
+
+from pydantic import BaseModel, URL
+
+class CardholderUpdateBuilder:
+
+    def __init__(self):
+        self.cards = []
+
+    def add_card(self, card: CardTypeRef):
+        self.cards.append(card)
+
+    def remove_card(self, href: URL):
+        pass

gallagher/dto/ref/card_type.py

@@ -3,14 +3,12 @@
 
 from ..utils import (
     AppBaseModel,
-    IdentityMixin,
-    HrefMixin,
     OptionalHrefMixin,
 )
 
 class CardTypeRef(
     AppBaseModel,
-    HrefMixin,
+    OptionalHrefMixin,
 ):
     """ Reference for a card type """
     name: str