gedcom-x 0.5.8__py3-none-any.whl → 0.5.9__py3-none-any.whl

gedcomx/serialization.py

@@ -1,11 +1,14 @@
 from __future__ import annotations
-from collections.abc import Sized
 from functools import lru_cache
-from typing import Any, Callable, Dict, ForwardRef, List, Set, Tuple, Union, get_args, get_origin
 
 import enum
 import logging
 import types
+from collections.abc import Sized
+from typing import Any, Dict, List, Set, Tuple, Union, Annotated, ForwardRef, get_args, get_origin
+from typing import Any, Callable, Mapping, List, Dict, Tuple, Set
+from typing import List, Optional
+from time import perf_counter
 
 """
 ======================================================================
@@ -17,7 +20,6 @@ import types
  Created: 2025-08-25
  Updated:
    - 2025-08-31: cleaned up imports and documentation
-   - 2025-09-01: filename PEP8 standard, imports changed accordingly
    
 ======================================================================
 """
@@ -35,7 +37,7 @@ from .date import Date
 from .document import Document, DocumentType, TextType
 from .evidence_reference import EvidenceReference
 from .event import Event, EventType, EventRole, EventRoleType
-from .Extensions.rs10.rsLink import _rsLinkList
+from .Extensions.rs10.rsLink import _rsLinks, rsLink
 from .fact import Fact, FactType, FactQualifier
 from .gender import Gender, GenderType
 from .identifier import IdentifierList, Identifier
@@ -58,14 +60,8 @@ from .uri import URI
 log = logging.getLogger("gedcomx")
 deserialization = "gedcomx.deserialization"
 
-hub.start_channel(
-    ChannelConfig(
-        name=deserialization,
-        path=f"logs/{deserialization}.log",
-        level=logging.DEBUG,
-        rotation="size:10MB:3",   # rotate by size, keep 3 backups
-    )
-)
+serial_log = "gedcomx.serialization"
+deserial_log = "gedcomx.deserialization"
 
 _PRIMITIVES = (str, int, float, bool, type(None))
 
@@ -75,7 +71,58 @@ def _has_parent_class(obj) -> bool:
 class Serialization:
  
     @staticmethod
-    def serialize_dict(dict_to_serialize: dict) -> dict:
+    def serialize(obj: object):
+        if obj is not None:
+            with hub.use(serial_log):
+                
+                if isinstance(obj, (str, int, float, bool, type(None))):
+                    return obj
+                if isinstance(obj, dict):
+                    return {k: Serialization.serialize(v) for k, v in obj.items()}
+                if isinstance(obj, URI):
+                    return obj.value
+                if isinstance(obj, (list, tuple, set)):
+                    l = [Serialization.serialize(v) for v in obj]
+                    if len(l) == 0: return None
+                    return l
+                if type(obj).__name__ == 'Collection':
+                    l= [Serialization.serialize(v) for v in obj]
+                    if len(l) == 0: return None
+                    return l
+                if isinstance(obj, enum.Enum): 
+                    return Serialization.serialize(obj.value)
+                
+                log.debug(f"Serializing a '{type(obj).__name__}'")
+                type_as_dict = {}
+                fields = Serialization.get_class_fields(type(obj).__name__)
+                if fields:
+                    for field_name, type_ in fields.items():
+                        if hasattr(obj,field_name):
+                            if (v := getattr(obj,field_name)) is not None:
+                                if type_ == Resource:
+                                    log.error(f"Refering to a {type(obj).__name__} with a '{type_}'")
+                                    res = Resource(target=v)
+                                    sv = Serialization.serialize(res)
+                                    type_as_dict[field_name] = sv
+                                elif type_ == URI:
+                                    log.error(f"Refering to a {type(obj).__name__} with a '{type_}'")
+                                    uri = URI(target=v)
+                                    sv = Serialization.serialize(uri)
+                                    type_as_dict[field_name] = sv
+                                elif (sv := Serialization.serialize(v)) is not None:
+                                    type_as_dict[field_name] = sv
+                        else:
+                            log.error(f"{type(obj).__name__} did not have field '{field_name}'")
+                    if type_as_dict == {}: log.error(f"Serialized a '{type(obj).__name__}' with empty fields: '{fields}'")
+                    else: log.debug(f"Serialized a '{type(obj).__name__}' with fields '{type_as_dict})'")
+                    #return Serialization._serialize_dict(type_as_dict)
+                    return type_as_dict if type_as_dict != {} else None
+                else:
+                    log.error(f"Could not find fields for {type(obj).__name__}")
+        return None
+
+    @staticmethod
+    def _serialize_dict(dict_to_serialize: dict) -> dict:
         """
         Walk a dict and serialize nested GedcomX objects to JSON-compatible values.
         - Uses `_as_dict_` on your objects when present
@@ -85,9 +132,9 @@ class Serialization:
         def _serialize(value):
             if isinstance(value, (str, int, float, bool, type(None))):
                 return value
-            if hasattr(value, "_as_dict_"):
+            if (fields := Serialization.get_class_fields(type(value).__name__)) is not None:
                 # Expect your objects expose a snapshot via _as_dict_
-                return value._as_dict_
+                return Serialization.serialize(value)
             if isinstance(value, dict):
                 return {k: _serialize(v) for k, v in value.items()}
             if isinstance(value, (list, tuple, set)):
@@ -155,302 +202,356 @@ class Serialization:
         inst._resource_setters = []
 
     # --- your deserialize with setters --------------------------------------
+    
     @classmethod
     def deserialize(
         cls,
-        data: Dict[str, Any],
+        data: dict[str, Any],
         class_type: type,
         *,
-        resolver: Callable[[Any], Any] | None = None,  # pass a function to resolve Resources now
-        queue_setters: bool = True                     # also stash setters on instance for later
+        resolver: Callable[[Any], Any] | None = None,
+        queue_setters: bool = True,
     ) -> Any:
-        class_fields = cls.get_class_fields(class_type.__name__)
-        result: Dict[str, Any] = {}
-        # collect setters that know how to assign back to attributes
-        pending_setters: List[Callable[[Any, Callable[[Any], Any]], None]] = []
-
-        for name, typ in class_fields.items():
-            if name not in data:
-                continue
-            coerced = cls._coerce_value(data[name], typ)
-            result[name] = coerced
-
-            # if this attribute (or inside it) has Resource(s), prepare a setter
-            if cls._has_resource_value(coerced):
-                def make_setter(attr_name: str, raw_value: Any):
-                    # capture references to the *exact* object we just built for this attribute
-                    def _setter(instance: Any, _resolver: Callable[[Any], Any]) -> None:
-                        resolved = cls._resolve_structure(raw_value, _resolver)
-                        setattr(instance, attr_name, resolved)
-                    return _setter
-                pending_setters.append(make_setter(name, coerced))
-
-        # build the instance
-        inst = class_type(**result)
-
-        # apply now, if resolver provided
-        if resolver is not None and pending_setters:
-            for set_fn in pending_setters:
-                set_fn(inst, resolver)
-
-        # optionally store for later (gives you a real attribute assignment later)
-        if queue_setters:
-            # merge if already present
-            existing = getattr(inst, "_resource_setters", [])
-            inst._resource_setters = [*existing, *pending_setters]
+        
+        with hub.use(deserial_log):
+            t0 = perf_counter()
+            class_fields = cls.get_class_fields(class_type.__name__)
+
+            result: dict[str, Any] = {}
+            pending: list[tuple[str, Any]] = []
+
+            # bind hot callables
+            _coerce = cls._coerce_value
+            _hasres = cls._has_resource_value
+
+            log.debug("deserialize[%s]: keys=%s", class_type.__name__, list(data.keys()))
 
+            for name, typ in class_fields.items():
+                raw = data.get(name, None)
+                if raw is None:
+                    continue
+                try:
+                    val = _coerce(raw, typ)
+                except Exception:
+                    log.exception("deserialize[%s]: coercion failed for field '%s' raw=%r",
+                                class_type.__name__, name, raw)
+                    raise
+                result[name] = val
+                if _hasres(val):
+                    pending.append((name, val))
+
+            # instantiate
+            try:
+                inst = class_type(**result)
+            except TypeError:
+                log.exception("deserialize[%s]: __init__ failed with kwargs=%s",
+                            class_type.__name__, list(result.keys()))
+                raise
+
+            # resolve now (optional)
+            if resolver and pending:
+                for attr, raw in pending:
+                    try:
+                        resolved = cls._resolve_structure(raw, resolver)
+                        setattr(inst, attr, resolved)
+                    except Exception:
+                        log.exception("deserialize[%s]: resolver failed for '%s'", class_type.__name__, attr)
+                        raise
+
+            # queue setters (store (attr, raw) tuples) — preserves your later-resolution behavior
+            if queue_setters and pending:
+                existing = getattr(inst, "_resource_setters", [])
+                inst._resource_setters = [*existing, *pending]
+
+            
+            log.debug("deserialize[%s]: done in %.3f ms (resolved=%d, queued=%d)",
+                    class_type.__name__, (perf_counter() - t0) * 1000,
+                    int(bool(resolver)) * len(pending), len(pending))
         return inst
 
     @staticmethod
+    @lru_cache(maxsize=None)
     def get_class_fields(cls_name) -> Dict:
         # NOTE: keep imports local to avoid circulars
         
 
         fields = {
-            "GedcomX": {"persons": List[Person]},
-            "Conclusion": {
-                "id": str,
-                "lang": str,
-                "sources": List["SourceReference"],
-                "analysis": Document | Resource,
-                "notes": List[Note],
-                "confidence": ConfidenceLevel,
-                "attribution": Attribution,
-                "uri": "Resource",
-                "max_note_count": int,
-                "links": _rsLinkList,
-            },
-            "Subject": {
-                "id": str,
-                "lang": str,
-                "sources": List["SourceReference"],
-                "analysis": Resource,
-                "notes": List["Note"],
-                "confidence": ConfidenceLevel,
-                "attribution": Attribution,
-                "extracted": bool,
-                "evidence": List[EvidenceReference],
-                "media": List[SourceReference],
-                "identifiers": IdentifierList,
-                "uri": Resource,
-                "links": _rsLinkList,
-            },
-            "Person": {
-                "id": str,
-                "lang": str,
-                "sources": List[SourceReference],
-                "analysis": Resource,
-                "notes": List[Note],
-                "confidence": ConfidenceLevel,
-                "attribution": Attribution,
-                "extracted": bool,
-                "evidence": List[EvidenceReference],
-                "media": List[SourceReference],
-                "identifiers": IdentifierList,
-                "private": bool,
-                "gender": Gender,
-                "names": List[Name],
-                "facts": List[Fact],
-                "living": bool,
-                "links": _rsLinkList,
-                #"uri": URI,
-            },
-            "SourceReference": {
-                "description": Resource,
-                "descriptionId": str,
-                "attribution": Attribution,
-                "qualifiers": List[Qualifier],
-            },
-            "Attribution": {
-                "contributor": Resource,
-                "modified": str,
-                "changeMessage": str,
-                "creator": Resource,
-                "created": str,
-            },
-            "SourceDescription": {
-                "id": str,
-                "resourceType": ResourceType,
-                "citations": List[SourceCitation],
-                "mediaType": str,
-                "about": URI,
-                "mediator": Resource,
-                "publisher": Resource,          # forward-ref to avoid circular import
-                "authors": List[Resource],
-                "sources": List[SourceReference],         # SourceReference
-                "analysis": Resource,          # analysis is typically a Document (kept union to avoid cycle)
-                "componentOf": SourceReference,           # SourceReference
-                "titles": List[TextValue],
-                "notes": List[Note],
-                "attribution": Attribution,
-                "rights": List[Resource],
-                "coverage": List[Coverage],               # Coverage
-                "descriptions": List[TextValue],
-                "identifiers": IdentifierList,
-                "created": Date,
-                "modified": Date,
-                "published": Date,
-                "repository": Agent,                    # forward-ref
-                "max_note_count": int,
-            },
-            "Gender": {
-                "id": str,
-                "lang": str,
-                "sources": List[SourceReference],
-                "analysis": Resource,
-                "notes": List[Note],
-                "confidence": ConfidenceLevel,
-                "attribution": Attribution,
-                "type": GenderType,
-            },
-            "PlaceReference": {
-                "original": str,
-                "description": URI,
-            },
-            "Relationship": {
-                "id": str,
-                "lang": str,
-                "sources": List[SourceReference],
-                "analysis": Resource,
-                "notes": List[Note],
-                "confidence": ConfidenceLevel,
-                "attribution": Attribution,
-                "extracted": bool,
-                "evidence": List[EvidenceReference],
-                "media": List[SourceReference],
-                "identifiers": IdentifierList,
-                "type": RelationshipType,
-                "person1": Resource,
-                "person2": Resource,
-                "facts": List[Fact],
-            },
-            "Document": {
-                "id": str,
-                "lang": str,
-                "sources": List[SourceReference],
-                "analysis": Resource,
-                "notes": List[Note],
-                "confidence": ConfidenceLevel,
-                "attribution": Attribution,
-                "type": DocumentType,
-                "extracted": bool,
-                "textType": TextType,
-                "text": str,
-            },
-            "PlaceDescription": {
-                "id": str,
-                "lang": str,
-                "sources": List[SourceReference],
-                "analysis": Resource,
-                "notes": List[Note],
-                "confidence": ConfidenceLevel,
-                "attribution": Attribution,
-                "extracted": bool,
-                "evidence": List[EvidenceReference],
-                "media": List[SourceReference],
-                "identifiers": List[IdentifierList],
-                "names": List[TextValue],
-                "type": str,
-                "place": URI,
-                "jurisdiction": Resource,
-                "latitude": float,
-                "longitude": float,
-                "temporalDescription": Date,
-                "spatialDescription": Resource,
-            },
-            "Agent": {
-                "id": str,
-                "identifiers": IdentifierList,
-                "names": List[TextValue],
-                "homepage": URI,
-                "openid": URI,
-                "accounts": List[OnlineAccount],
-                "emails": List[URI],
-                "phones": List[URI],
-                "addresses": List[Address],
-                "person": object | Resource,  # intended Person | Resource
-                "attribution": object,         # GEDCOM5/7 compatibility
-                "uri": URI | Resource,
-            },
-            "Event": {
-                "id": str,
-                "lang": str,
-                "sources": List[SourceReference],
-                "analysis": Resource,
-                "notes": List[Note],
-                "confidence": ConfidenceLevel,
-                "attribution": Attribution,
-                "extracted": bool,
-                "evidence": List[EvidenceReference],
-                "media": List[SourceReference],
-                "identifiers": List[Identifier],
-                "type": EventType,
-                "date": Date,
-                "place": PlaceReference,
-                "roles": List[EventRole],
-            },
-            "EventRole": {
-                "id:": str,
-                "lang": str,
-                "sources": List[SourceReference],
-                "analysis": Resource,
-                "notes": List[Note],
-                "confidence": ConfidenceLevel,
-                "attribution": Attribution,
-                "person": Resource,
-                "type": EventRoleType,
-                "details": str,
-            },
-            "Resource":{
-                "resource":URI,
-                "id":str
-            },
-            "Qualifier":{
-                "name":str,
-                "value":str
-            },
-            "KnownSourceReference":{
-                "name":str,
-                "value":str
-            },
-            "Name": {
-                "id": str,
-                "lang": str,
-                "sources": List[SourceReference],
-                "analysis": Resource,
-                "notes": List[Note],
-                "confidence": ConfidenceLevel,
-                "attribution": Attribution,
-                "type": NameType,
-                "nameForms": List[NameForm],  # use string to avoid circulars if needed
-                "date": Date,
-            },
-            "NameForm": {
-                "lang": str,
-                "fullText": str,
-                "parts": List[NamePart],  # use "NamePart" as a forward-ref to avoid circulars
-            },
-            "NamePart": {
-                "type": NamePartType,
-                "value": str,
-                "qualifiers": List["NamePartQualifier"],  # quote if you want to avoid circulars
-            },
-            "Fact":{
-                "id": str,
-                "lang": str,
-                "sources": List[SourceReference],
-                "analysis": Resource | Document,
-                "notes": List[Note],
-                "confidence": ConfidenceLevel,
-                "attribution": Attribution,
-                "type": FactType,
-                "date": Date,
-                "place": PlaceReference,
-                "value": str,
-                "qualifiers": List[FactQualifier],
-                "links": _rsLinkList,
-            }
-        }
+    "Agent": {
+        "id": str,
+        "identifiers": IdentifierList,
+        "names": List[TextValue],
+        "homepage": URI,
+        "openid": URI,
+        "accounts": List[OnlineAccount],
+        "emails": List[URI],
+        "phones": List[URI],
+        "addresses": List[Address],
+        "person": object | Resource,  # intended Person | Resource
+        "attribution": object,        # GEDCOM5/7 compatibility
+        "uri": URI | Resource,
+    },
+    "Attribution": {
+        "contributor": Resource,
+        "modified": str,
+        "changeMessage": str,
+        "creator": Resource,
+        "created": str,
+    },
+    "Conclusion": {
+        "id": str,
+        "lang": str,
+        "sources": List["SourceReference"],
+        "analysis": Document | Resource,
+        "notes": List[Note],
+        "confidence": ConfidenceLevel,
+        "attribution": Attribution,
+        "uri": "Resource",
+        "max_note_count": int,
+        "links": _rsLinks,
+    },
+    "Date": {
+        "original": str,
+        "formal": str,
+        "normalized": str,
+    },
+    "Document": {
+        "id": str,
+        "lang": str,
+        "sources": List[SourceReference],
+        "analysis": Resource,
+        "notes": List[Note],
+        "confidence": ConfidenceLevel,
+        "attribution": Attribution,
+        "type": DocumentType,
+        "extracted": bool,
+        "textType": TextType,
+        "text": str,
+    },
+    "Event": {
+        "id": str,
+        "lang": str,
+        "sources": List[SourceReference],
+        "analysis": Resource,
+        "notes": List[Note],
+        "confidence": ConfidenceLevel,
+        "attribution": Attribution,
+        "extracted": bool,
+        "evidence": List[EvidenceReference],
+        "media": List[SourceReference],
+        "identifiers": List[Identifier],
+        "type": EventType,
+        "date": Date,
+        "place": PlaceReference,
+        "roles": List[EventRole],
+    },
+    "EventRole": {
+        "id:": str,
+        "lang": str,
+        "sources": List[SourceReference],
+        "analysis": Resource,
+        "notes": List[Note],
+        "confidence": ConfidenceLevel,
+        "attribution": Attribution,
+        "person": Resource,
+        "type": EventRoleType,
+        "details": str,
+    },
+    "Fact": {
+        "id": str,
+        "lang": str,
+        "sources": List[SourceReference],
+        "analysis": Resource | Document,
+        "notes": List[Note],
+        "confidence": ConfidenceLevel,
+        "attribution": Attribution,
+        "type": FactType,
+        "date": Date,
+        "place": PlaceReference,
+        "value": str,
+        "qualifiers": List[FactQualifier],
+        "links": _rsLinks,
+    },
+    "GedcomX": {
+        "persons": List[Person],
+        "relationships": List[Relationship],
+        "sourceDescriptions": List[SourceDescription],
+        "agents": List[Agent],
+        "places": List[PlaceDescription]
+    },
+    "Gender": {
+        "id": str,
+        "lang": str,
+        "sources": List[SourceReference],
+        "analysis": Resource,
+        "notes": List[Note],
+        "confidence": ConfidenceLevel,
+        "attribution": Attribution,
+        "type": GenderType,
+    },
+    "KnownSourceReference": {
+        "name": str,
+        "value": str,
+    },
+    "Name": {
+        "id": str,
+        "lang": str,
+        "sources": List[SourceReference],
+        "analysis": Resource,
+        "notes": List[Note],
+        "confidence": ConfidenceLevel,
+        "attribution": Attribution,
+        "type": NameType,
+        "nameForms": List[NameForm],  # use string to avoid circulars if needed
+        "date": Date,
+    },
+    "NameForm": {
+        "lang": str,
+        "fullText": str,
+        "parts": List[NamePart],  # use "NamePart" as a forward-ref to avoid circulars
+    },
+    "NamePart": {
+        "type": NamePartType,
+        "value": str,
+        "qualifiers": List["NamePartQualifier"],  # quote if you want to avoid circulars
+    },
+    "Note":{"lang":str,
+            "subject":str,
+            "text":str,
+            "attribution": Attribution},
+    "Person": {
+        "id": str,
+        "lang": str,
+        "sources": List[SourceReference],
+        "analysis": Resource,
+        "notes": List[Note],
+        "confidence": ConfidenceLevel,
+        "attribution": Attribution,
+        "extracted": bool,
+        "evidence": List[EvidenceReference],
+        "media": List[SourceReference],
+        "identifiers": IdentifierList,
+        "private": bool,
+        "gender": Gender,
+        "names": List[Name],
+        "facts": List[Fact],
+        "living": bool,
+        "links": _rsLinks,
+    },
+    "PlaceDescription": {
+        "id": str,
+        "lang": str,
+        "sources": List[SourceReference],
+        "analysis": Resource,
+        "notes": List[Note],
+        "confidence": ConfidenceLevel,
+        "attribution": Attribution,
+        "extracted": bool,
+        "evidence": List[EvidenceReference],
+        "media": List[SourceReference],
+        "identifiers": List[IdentifierList],
+        "names": List[TextValue],
+        "type": str,
+        "place": URI,
+        "jurisdiction": Resource,
+        "latitude": float,
+        "longitude": float,
+        "temporalDescription": Date,
+        "spatialDescription": Resource,
+    },
+    "PlaceReference": {
+        "original": str,
+        "description": URI,
+    },
+    "Qualifier": {
+        "name": str,
+        "value": str,
+    },
+    "_rsLinks": {
+        "person":rsLink,
+        "portrait":rsLink},
+    "rsLink": {
+        "href": URI,
+        "template": str,
+        "type": str,
+        "accept": str,
+        "allow": str,
+        "hreflang": str,
+        "title": str,
+    },
+    "Relationship": {
+        "id": str,
+        "lang": str,
+        "sources": List[SourceReference],
+        "analysis": Resource,
+        "notes": List[Note],
+        "confidence": ConfidenceLevel,
+        "attribution": Attribution,
+        "extracted": bool,
+        "evidence": List[EvidenceReference],
+        "media": List[SourceReference],
+        "identifiers": IdentifierList,
+        "type": RelationshipType,
+        "person1": Resource,
+        "person2": Resource,
+        "facts": List[Fact],
+    },
+    "Resource": {
+        "resource": str,
+        "resourceId": str,
+    },  
+    "SourceDescription": {
+        "id": str,
+        "resourceType": ResourceType,
+        "citations": List[SourceCitation],
+        "mediaType": str,
+        "about": URI,
+        "mediator": Resource,
+        "publisher": Resource,          # forward-ref to avoid circular import
+        "authors": List[Resource],
+        "sources": List[SourceReference],         # SourceReference
+        "analysis": Resource,          # analysis is typically a Document (kept union to avoid cycle)
+        "componentOf": SourceReference,           # SourceReference
+        "titles": List[TextValue],
+        "notes": List[Note],
+        "attribution": Attribution,
+        "rights": List[Resource],
+        "coverage": List[Coverage],               # Coverage
+        "descriptions": List[TextValue],
+        "identifiers": IdentifierList,
+        "created": Date,
+        "modified": Date,
+        "published": Date,
+        "repository": Agent,                    # forward-ref
+        "max_note_count": int,
+    },
+    "SourceReference": {
+        "description": Resource,
+        "descriptionId": str,
+        "attribution": Attribution,
+        "qualifiers": List[Qualifier],
+    },
+    "Subject": {
+        "id": str,
+        "lang": str,
+        "sources": List["SourceReference"],
+        "analysis": Resource,
+        "notes": List["Note"],
+        "confidence": ConfidenceLevel,
+        "attribution": Attribution,
+        "extracted": bool,
+        "evidence": List[EvidenceReference],
+        "media": List[SourceReference],
+        "identifiers": IdentifierList,
+        "uri": Resource,
+        "links": _rsLinks,
+    },
+    "TextValue":{"lang":str,"value":str},  
+    "URI": {
+        "value": str,
+    },
+
+}
+
         return fields.get(cls_name, {})
 
 
@@ -495,7 +596,7 @@ class Serialization:
             if T is Resource:
                 log.debug("COERCE str->Resource: %r", value)
                 try:
-                    ret = Resource(uri=value)
+                    ret = Resource(resourceId=value)
                     log.debug("COERCE str->Resource: built %r", ret)
                     return ret
                 except Exception:
@@ -517,7 +618,7 @@ class Serialization:
         if T is Resource and isinstance(value, dict):
             log.debug("COERCE dict->Resource: %r", value)
             try:
-                ret = Resource(uri=value.get("resource"), id=value.get("resourceId"))
+                ret = Resource(resource=value.get("resource"), resourceId=value.get("resourceId"))
                 log.debug("COERCE dict->Resource: built %r", ret)
                 return ret
             except Exception:
@@ -637,129 +738,7 @@ class Serialization:
         return value
 
 
-        # Dict to Resource
-        if T is Resource and isinstance(value, dict):
-            log.debug("COERCE dict->Resource: %r", value)
-            try:
-                ret = Resource(uri=value.get("resource"), id=value.get("resourceId"))
-                log.debug("COERCE dict->Resource: built %r", ret)
-                return ret
-            except Exception:
-                log.exception("COERCE dict->Resource: failed for %r", value)
-                return value
-
-        # IdentifierList special
-        if T is IdentifierList:
-            log.debug("COERCE IdentifierList: %r", value)
-            try:
-                ret = IdentifierList._from_json_(value)
-                log.debug("COERCE IdentifierList: built %r", ret)
-                return ret
-            except Exception:
-                log.exception("COERCE IdentifierList: _from_json_ failed for %r", value)
-                return value
-
-        # Containers
-        if self._is_list_like(T):
-            elem_t = args[0] if args else Any
-            log.debug("COERCE list-like: len=%s, elem_t=%r", len(value or []), elem_t)
-            try:
-                ret = [self._coerce_value(v, elem_t) for v in (value or [])]
-                log.debug("COERCE list-like: result sample=%r", ret[:3] if isinstance(ret, list) else ret)
-                return ret
-            except Exception:
-                log.exception("COERCE list-like: failed for value=%r elem_t=%r", value, elem_t)
-                return value
-
-        if self._is_set_like(T):
-            elem_t = args[0] if args else Any
-            log.debug("COERCE set-like: len=%s, elem_t=%r", len(value or []), elem_t)
-            try:
-                ret = {self._coerce_value(v, elem_t) for v in (value or [])}
-                log.debug("COERCE set-like: result size=%d", len(ret))
-                return ret
-            except Exception:
-                log.exception("COERCE set-like: failed for value=%r elem_t=%r", value, elem_t)
-                return value
-
-        if self._is_tuple_like(T):
-            log.debug("COERCE tuple-like: value=%r, args=%r", value, args)
-            try:
-                if not value:
-                    log.debug("COERCE tuple-like: empty/None -> ()")
-                    return tuple(value or ())
-                if len(args) == 2 and args[1] is Ellipsis:
-                    elem_t = args[0]
-                    ret = tuple(self._coerce_value(v, elem_t) for v in (value or ()))
-                    log.debug("COERCE tuple-like variadic: size=%d", len(ret))
-                    return ret
-                ret = tuple(self._coerce_value(v, t) for v, t in zip(value, args))
-                log.debug("COERCE tuple-like fixed: size=%d", len(ret))
-                return ret
-            except Exception:
-                log.exception("COERCE tuple-like: failed for value=%r args=%r", value, args)
-                return value
-
-        if self._is_dict_like(T):
-            k_t = args[0] if len(args) >= 1 else Any
-            v_t = args[1] if len(args) >= 2 else Any
-            log.debug("COERCE dict-like: keys=%s, k_t=%r, v_t=%r", len((value or {}).keys()), k_t, v_t)
-            try:
-                ret = {
-                    self._coerce_value(k, k_t): self._coerce_value(v, v_t)
-                    for k, v in (value or {}).items()
-                }
-                log.debug("COERCE dict-like: result size=%d", len(ret))
-                return ret
-            except Exception:
-                log.exception("COERCE dict-like: failed for value=%r k_t=%r v_t=%r", value, k_t, v_t)
-                return value
-
-        # Objects via registry
-        if isinstance(T, type) and isinstance(value, dict):
-            fields = self.get_class_fields(T.__name__) or {}
-            log.debug(
-                "COERCE object: class=%s, input_keys=%s, registered_fields=%s",
-                T.__name__, list(value.keys()), list(fields.keys())
-            )
-            if fields:
-                kwargs = {}
-                present = []
-                for fname, ftype in fields.items():
-                    if fname in value:
-                        resolved = self._resolve_forward(self._unwrap(ftype))
-                        log.debug("COERCE object.field: %s.%s -> %r, raw=%r", T.__name__, fname, resolved, value[fname])
-                        try:
-                            coerced = self._coerce_value(value[fname], resolved)
-                            kwargs[fname] = coerced
-                            present.append(fname)
-                            log.debug("COERCE object.field: %s.%s coerced -> %r", T.__name__, fname, coerced)
-                        except Exception:
-                            log.exception("COERCE object.field: %s.%s failed", T.__name__, fname)
-                unknown = [k for k in value.keys() if k not in fields]
-                if unknown:
-                    log.debug("COERCE object: %s unknown keys ignored: %s", T.__name__, unknown)
-                try:
-                    log.debug("COERCE object: instantiate %s(**%s)", T.__name__, present)
-                    ret = T(**kwargs)
-                    log.debug("COERCE object: success -> %r", ret)
-                    return ret
-                except TypeError as e:
-                    log.warning("COERCE object: instantiate %s failed with kwargs=%s: %s", T.__name__, list(kwargs.keys()), e)
-                    log.debug("COERCE object: returning partially coerced dict")
-                    return kwargs
-
-        # Already correct type?
-        try:
-            if isinstance(value, T):
-                log.debug("COERCE passthrough: value already instance of %r", T)
-                return value
-        except TypeError:
-            log.debug("COERCE isinstance not applicable: T=%r", T)
-
-        log.debug("COERCE fallback: returning original value=%r (type=%s)", value, type(value).__name__)
-        return value
-
+        
     # -------------------------- TYPE HELPERS --------------------------
 
     @staticmethod