cognite-toolkit 0.7.46__py3-none-any.whl → 0.7.48__py3-none-any.whl

cognite_toolkit/_cdf_tk/client/resource_classes/data_modeling/__init__.py

@@ -46,6 +46,8 @@ from ._instance import (
     EdgeRequest,
     EdgeResponse,
     InstanceDefinition,
+    InstanceRequest,
+    InstanceResponse,
     InstanceResponseDefinition,
     InstanceSource,
     NodeRequest,
@@ -120,6 +122,8 @@ __all__ = [
     "IndexAdapter",
     "IndexDefinition",
     "InstanceDefinition",
+    "InstanceRequest",
+    "InstanceResponse",
     "InstanceResponseDefinition",
     "InstanceSource",
     "Int32Property",

cognite_toolkit/_cdf_tk/client/resource_classes/data_modeling/_instance.py

@@ -1,7 +1,7 @@
 from abc import ABC
-from typing import Any, Generic, Literal
+from typing import Annotated, Any, Generic, Literal, TypeAlias
 
-from pydantic import JsonValue, field_serializer, field_validator
+from pydantic import Field, JsonValue, field_serializer, field_validator
 
 from cognite_toolkit._cdf_tk.client.resource_classes.base import (
     BaseModelObject,
@@ -9,8 +9,9 @@ from cognite_toolkit._cdf_tk.client.resource_classes.base import (
     ResponseResource,
     T_RequestResource,
 )
+from cognite_toolkit._cdf_tk.client.resource_classes.instance_api import TypedEdgeIdentifier, TypedNodeIdentifier
 
-from ._references import ContainerReference, EdgeReference, NodeReference, ViewReference
+from ._references import ContainerReference, NodeReference, ViewReference
 
 
 class InstanceDefinition(BaseModelObject, ABC):
@@ -87,8 +88,8 @@ class NodeRequest(InstanceRequestDefinition):
     instance_type: Literal["node"] = "node"
     type: NodeReference | None = None
 
-    def as_id(self) -> NodeReference:
-        return NodeReference(space=self.space, external_id=self.external_id)
+    def as_id(self) -> TypedNodeIdentifier:
+        return TypedNodeIdentifier(space=self.space, external_id=self.external_id)
 
 
 class EdgeRequest(InstanceRequestDefinition):
@@ -99,8 +100,8 @@ class EdgeRequest(InstanceRequestDefinition):
     start_node: NodeReference
     end_node: NodeReference
 
-    def as_id(self) -> EdgeReference:
-        return EdgeReference(space=self.space, external_id=self.external_id)
+    def as_id(self) -> TypedEdgeIdentifier:
+        return TypedEdgeIdentifier(space=self.space, external_id=self.external_id)
 
 
 class NodeResponse(InstanceResponseDefinition[NodeRequest]):
@@ -109,8 +110,8 @@ class NodeResponse(InstanceResponseDefinition[NodeRequest]):
     instance_type: Literal["node"] = "node"
     type: NodeReference | None = None
 
-    def as_id(self) -> NodeReference:
-        return NodeReference(space=self.space, external_id=self.external_id)
+    def as_id(self) -> TypedNodeIdentifier:
+        return TypedNodeIdentifier(space=self.space, external_id=self.external_id)
 
     def as_request_resource(self) -> NodeRequest:
         dumped = self.dump()
@@ -130,8 +131,8 @@ class EdgeResponse(InstanceResponseDefinition[EdgeRequest]):
     start_node: NodeReference
     end_node: NodeReference
 
-    def as_id(self) -> EdgeReference:
-        return EdgeReference(space=self.space, external_id=self.external_id)
+    def as_id(self) -> TypedEdgeIdentifier:
+        return TypedEdgeIdentifier(space=self.space, external_id=self.external_id)
 
     def as_request_resource(self) -> EdgeRequest:
         dumped = self.dump()
@@ -141,3 +142,13 @@ class EdgeResponse(InstanceResponseDefinition[EdgeRequest]):
             ]
         dumped["existingVersion"] = dumped.pop("version", None)
         return EdgeRequest.model_validate(dumped, extra="ignore")
+
+
+InstanceRequest: TypeAlias = Annotated[
+    NodeRequest | EdgeRequest,
+    Field(discriminator="instance_type"),
+]
+InstanceResponse: TypeAlias = Annotated[
+    NodeResponse | EdgeResponse,
+    Field(discriminator="instance_type"),
+]

cognite_toolkit/_cdf_tk/client/resource_classes/function_schedule.py

@@ -6,6 +6,7 @@ from cognite_toolkit._cdf_tk.client.resource_classes.base import (
     RequestResource,
     ResponseResource,
 )
+from cognite_toolkit._cdf_tk.client.resource_classes.identifiers import InternalId
 
 
 class FunctionScheduleId(Identifier):
@@ -37,14 +38,17 @@ class FunctionSchedule(BaseModelObject):
 class FunctionScheduleRequest(FunctionSchedule, RequestResource):
     """Request resource for creating/updating function schedules."""
 
+    # The 'id' field is not part of the request when creating a new resource,
+    # but is needed when deleting an existing resource.
+    id: int | None = Field(default=None, exclude=True)
     function_id: int
     function_external_id: str | None = Field(None, exclude=True)
     nonce: str
 
-    def as_id(self) -> FunctionScheduleId:
-        if self.function_external_id is None:
-            raise ValueError("function_external_id must be set to create FunctionScheduleId")
-        return FunctionScheduleId(function_external_id=self.function_external_id, name=self.name)
+    def as_id(self) -> InternalId:
+        if self.id is None:
+            raise ValueError("Cannot convert FunctionScheduleRequest to InternalId when id is None")
+        return InternalId(id=self.id)
 
 
 class FunctionScheduleResponse(FunctionSchedule, ResponseResource[FunctionScheduleRequest]):

cognite_toolkit/_cdf_tk/client/resource_classes/group/group.py

@@ -6,12 +6,14 @@ https://api-docs.cognite.com/20230101/tag/Groups/operation/createGroups
 
 from typing import Literal
 
+from pydantic import Field
+
 from cognite_toolkit._cdf_tk.client.resource_classes.base import (
     BaseModelObject,
     RequestResource,
     ResponseResource,
 )
-from cognite_toolkit._cdf_tk.client.resource_classes.identifiers import NameId
+from cognite_toolkit._cdf_tk.client.resource_classes.identifiers import InternalId
 
 from .capability import GroupCapability
 
@@ -38,14 +40,16 @@ class Group(BaseModelObject):
     source_id: str | None = None
     members: list[str] | Literal["allUserAccounts"] | None = None
 
-    def as_id(self) -> NameId:
-        return NameId(name=self.name)
-
 
 class GroupRequest(Group, RequestResource):
     """Group request resource for creating/updating groups."""
 
-    ...
+    id: int | None = Field(default=None, exclude=True)
+
+    def as_id(self) -> InternalId:
+        if self.id is None:
+            raise ValueError("Cannot convert GroupRequest to InternalId when id is None")
+        return InternalId(id=self.id)
 
 
 class GroupResponse(Group, ResponseResource[GroupRequest]):

cognite_toolkit/_cdf_tk/client/resource_classes/identifiers.py

@@ -50,3 +50,10 @@ class WorkflowVersionId(Identifier):
 
     def __str__(self) -> str:
         return f"workflowExternalId='{self.workflow_external_id}', version='{self.version}'"
+
+
+class DataSetId(Identifier):
+    data_set_id: int
+
+    def __str__(self) -> str:
+        return f"dataSetId={self.data_set_id}"

cognite_toolkit/_cdf_tk/client/resource_classes/location_filter.py

@@ -1,5 +1,7 @@
 from typing import Literal
 
+from pydantic import Field
+
 from cognite_toolkit._cdf_tk.client.resource_classes.base import BaseModelObject, RequestResource, ResponseResource
 
 from .data_modeling import DataModelReference
@@ -61,8 +63,13 @@ class LocationFilter(BaseModelObject):
 class LocationFilterRequest(LocationFilter, RequestResource):
     """Request resource for creating/updating location filters."""
 
-    def as_id(self) -> ExternalId:
-        return ExternalId(external_id=self.external_id)
+    # This is not part of the request payload, but we need it to identify existing resources for updates.
+    id: int | None = Field(default=None, exclude=True)
+
+    def as_id(self) -> InternalId:
+        if self.id is None:
+            raise ValueError("Cannot get ID for LocationFilterRequest without 'id' set.")
+        return InternalId(id=self.id)
 
 
 class LocationFilterResponse(LocationFilter, ResponseResource[LocationFilterRequest]):

cognite_toolkit/_cdf_tk/client/resource_classes/relationship.py

@@ -1,6 +1,10 @@
-from typing import Literal
+from typing import ClassVar, Literal
 
-from cognite_toolkit._cdf_tk.client.resource_classes.base import BaseModelObject, RequestResource, ResponseResource
+from cognite_toolkit._cdf_tk.client.resource_classes.base import (
+    BaseModelObject,
+    RequestUpdateable,
+    ResponseResource,
+)
 
 from .identifiers import ExternalId
 
@@ -26,9 +30,11 @@ class Relationship(BaseModelObject):
     labels: list[LabelRef] | None = None
 
 
-class RelationshipRequest(Relationship, RequestResource):
+class RelationshipRequest(Relationship, RequestUpdateable):
     """Request resource for creating/updating relationships."""
 
+    container_fields: ClassVar[frozenset[str]] = frozenset({"labels"})
+
     def as_id(self) -> ExternalId:
         return ExternalId(external_id=self.external_id)
 

cognite_toolkit/_cdf_tk/client/resource_classes/resource_view_mapping.py

@@ -0,0 +1,38 @@
+from typing import ClassVar, Literal
+
+from cognite_toolkit._cdf_tk.client.resource_classes.base import (
+    BaseModelObject,
+    RequestResource,
+    ResponseResource,
+)
+
+from .data_modeling import ViewReference
+from .identifiers import ExternalId
+
+
+class ResourceViewMapping(BaseModelObject):
+    space: ClassVar[str] = "cognite_migration"
+    view_ref: ClassVar[ViewReference] = ViewReference(
+        space="cognite_migration", external_id="ResourceViewMapping", version="v1"
+    )
+    instance_type: Literal["node"] = "node"
+    external_id: str
+    resource_type: str
+    view_id: ViewReference
+    property_mapping: dict[str, str]
+
+    def as_id(self) -> ExternalId:
+        return ExternalId(external_id=self.external_id)
+
+
+class ResourceViewMappingRequest(ResourceViewMapping, RequestResource):
+    existing_version: int | None = None
+
+
+class ResourceViewMappingResponse(ResourceViewMapping, ResponseResource[ResourceViewMappingRequest]):
+    version: int
+    created_time: int
+    last_updated_time: int
+
+    def as_request_resource(self) -> ResourceViewMappingRequest:
+        return ResourceViewMappingRequest.model_validate(self.dump(), extra="ignore")

cognite_toolkit/_cdf_tk/client/resource_classes/robotics/_map.py

@@ -1,4 +1,4 @@
-from typing import ClassVar
+from typing import ClassVar, Literal
 
 from pydantic import JsonValue
 
@@ -49,6 +49,11 @@ class RobotMapRequest(RobotMap, RequestUpdateable):
         {"description", "data", "frame_external_id", "location_external_id", "scale"}
     )
 
+    def as_update(self, mode: Literal["patch", "replace"]) -> dict[str, JsonValue]:
+        update = super().as_update(mode)
+        update["update"].pop("mapType", None)
+        return update
+
 
 class RobotMapResponse(RobotMap, ResponseResource[RobotMapRequest]):
     """Response resource for a RobotMap."""

cognite_toolkit/_cdf_tk/client/resource_classes/robotics/_robot.py

@@ -1,11 +1,11 @@
-from typing import ClassVar
+from typing import Any, ClassVar, Literal
 
 from cognite_toolkit._cdf_tk.client.resource_classes.base import (
     BaseModelObject,
     RequestUpdateable,
     ResponseResource,
 )
-from cognite_toolkit._cdf_tk.client.resource_classes.identifiers import NameId
+from cognite_toolkit._cdf_tk.client.resource_classes.identifiers import DataSetId
 
 from ._common import RobotType
 
@@ -32,15 +32,20 @@ class Robot(BaseModelObject):
     metadata: dict[str, str] | None = None
     location_external_id: str | None = None
 
-    def as_id(self) -> NameId:
-        return NameId(name=self.name)
+    def as_id(self) -> DataSetId:
+        return DataSetId(data_set_id=self.data_set_id)
 
 
 class RobotRequest(Robot, RequestUpdateable):
     """Request resource for creating or updating a Robot."""
 
     container_fields: ClassVar[frozenset[str]] = frozenset({"metadata"})
-    non_nullable_fields: ClassVar[frozenset[str]] = frozenset({"location_external_id"})
+    non_nullable_fields: ClassVar[frozenset[str]] = frozenset({"location_external_id", "description"})
+
+    def as_update(self, mode: Literal["patch", "replace"]) -> dict[str, Any]:
+        update = super().as_update(mode)
+        update["update"].pop("capabilities", None)
+        return update
 
 
 class RobotResponse(Robot, ResponseResource[RobotRequest]):

cognite_toolkit/_cdf_tk/client/resource_classes/streams.py

@@ -1,12 +1,8 @@
 from typing import Literal
 
 from cognite_toolkit._cdf_tk.constants import StreamTemplateName
-from cognite_toolkit._cdf_tk.protocols import (
-    ResourceRequestListProtocol,
-    ResourceResponseListProtocol,
-)
 
-from .base import BaseModelObject, BaseResourceList, RequestResource, ResponseResource
+from .base import BaseModelObject, RequestResource, ResponseResource
 from .identifiers import ExternalId
 
 
@@ -23,12 +19,6 @@ class StreamRequest(Stream, RequestResource):
         return ExternalId(external_id=self.external_id)
 
 
-class StreamRequestList(BaseResourceList[StreamRequest], ResourceRequestListProtocol):
-    """List of Stream request resources."""
-
-    _RESOURCE = StreamRequest
-
-
 class LifecycleObject(BaseModelObject):
     """Lifecycle object."""
 
@@ -81,12 +71,3 @@ class StreamResponse(Stream, ResponseResource[StreamRequest]):
                 "settings": {"template": {"name": self.created_from_template}},
             }
         )
-
-
-class StreamResponseList(BaseResourceList[StreamResponse], ResourceResponseListProtocol):
-    """List of Stream response resources."""
-
-    _RESOURCE = StreamResponse
-
-    def as_write(self) -> StreamRequestList:
-        return StreamRequestList([item.as_write() for item in self.data])

cognite_toolkit/_cdf_tk/client/resource_classes/three_d.py

@@ -1,10 +1,10 @@
 import sys
-from typing import Literal
+from typing import ClassVar, Literal
 
 from pydantic import Field
 
-from .base import BaseModelObject, Identifier, RequestResource, ResponseResource
-from .identifiers import NameId
+from .base import BaseModelObject, Identifier, RequestResource, RequestUpdateable, ResponseResource
+from .identifiers import InternalId
 from .instance_api import NodeReference
 
 if sys.version_info >= (3, 11):
@@ -23,12 +23,18 @@ class RevisionStatus(BaseModelObject):
 
 class ThreeDModelRequest(RequestResource):
     name: str
+    # This field is part of the path request and not the body schema.
+    # but is needed for identifier conversion.
+    id: int | None = Field(None, exclude=True)
 
-    def as_id(self) -> NameId:
-        return NameId(name=self.name)
+    def as_id(self) -> InternalId:
+        if self.id is None:
+            raise ValueError("Cannot convert to InternalId when id is None.")
+        return InternalId(id=self.id)
 
 
-class ThreeDModelClassicRequest(ThreeDModelRequest):
+class ThreeDModelClassicRequest(ThreeDModelRequest, RequestUpdateable):
+    container_fields: ClassVar[frozenset[str]] = frozenset({"metadata"})
     data_set_id: int | None = None
     metadata: dict[str, str] | None = None
 
@@ -91,17 +97,32 @@ class AssetMappingClassicRequest(RequestResource, Identifier):
         return f"{self.model_id}_{self.revision_id}_{self.node_id}_{asset_part}"
 
 
-class AssetMappingResponse(ResponseResource[AssetMappingClassicRequest]):
+class AssetMappingClassicResponse(ResponseResource[AssetMappingClassicRequest]):
     node_id: int
     asset_id: int | None = None
     asset_instance_id: NodeReference | None = None
     tree_index: int | None = None
     subtree_size: int | None = None
     # These fields are part of the path request and response, but they are included here for convenience.
-    model_id: int = Field(exclude=True)
-    revision_id: int = Field(exclude=True)
+    model_id: int = Field(-1, exclude=True)
+    revision_id: int = Field(-1, exclude=True)
 
     def as_request_resource(self) -> AssetMappingClassicRequest:
         return AssetMappingClassicRequest.model_validate(
             {**self.dump(), "modelId": self.model_id, "revisionId": self.revision_id}
         )
+
+
+class AssetMappingDMResponse(ResponseResource[AssetMappingDMRequest]):
+    node_id: int
+    asset_instance_id: NodeReference
+    tree_index: int | None = None
+    subtree_size: int | None = None
+    # These fields are part of the path request and response, but they are included here for convenience.
+    model_id: int = Field(-1, exclude=True)
+    revision_id: int = Field(-1, exclude=True)
+
+    def as_request_resource(self) -> AssetMappingDMRequest:
+        return AssetMappingDMRequest.model_validate(
+            {**self.dump(), "modelId": self.model_id, "revisionId": self.revision_id}
+        )

cognite_toolkit/_cdf_tk/client/testing.py

@@ -65,7 +65,7 @@ from .api.search import SearchAPI
 from .api.security_categories import SecurityCategoriesAPI
 from .api.sequences import SequencesAPI
 from .api.streams import StreamsAPI
-from .api.three_d import ThreeDAPI, ThreeDModelAPI
+from .api.three_d import ThreeDAPI, ThreeDClassicModelsAPI
 from .api.timeseries import TimeSeriesAPI
 from .api.token import TokenAPI
 from .api.transformations import TransformationsAPI
@@ -151,7 +151,7 @@ class ToolkitClientMock(CogniteClientMock):
 
         self.tool = MagicMock(spec=ToolAPI)
         self.tool.three_d = MagicMock(spec=ThreeDAPI)
-        self.tool.three_d.models = MagicMock(spec_set=ThreeDModelAPI)
+        self.tool.three_d.models_classic = MagicMock(spec_set=ThreeDClassicModelsAPI)
         self.tool.assets = MagicMock(spec_set=AssetsAPI)
         self.tool.timeseries = MagicMock(spec_set=TimeSeriesAPI)
         self.tool.filemetadata = MagicMock(spec_set=FileMetadataAPI)

cognite_toolkit/_cdf_tk/commands/_migrate/data_mapper.py

@@ -30,8 +30,8 @@ from cognite_toolkit._cdf_tk.client.resource_classes.legacy.canvas import (
 from cognite_toolkit._cdf_tk.client.resource_classes.legacy.charts import Chart, ChartWrite
 from cognite_toolkit._cdf_tk.client.resource_classes.legacy.migration import ResourceViewMappingApply
 from cognite_toolkit._cdf_tk.client.resource_classes.three_d import (
+    AssetMappingClassicResponse,
     AssetMappingDMRequest,
-    AssetMappingResponse,
     RevisionStatus,
     ThreeDModelResponse,
 )
@@ -477,12 +477,12 @@ class ThreeDMapper(DataMapper[ThreeDSelector, ThreeDModelResponse, ThreeDMigrati
             return None
 
 
-class ThreeDAssetMapper(DataMapper[ThreeDSelector, AssetMappingResponse, AssetMappingDMRequest]):
+class ThreeDAssetMapper(DataMapper[ThreeDSelector, AssetMappingClassicResponse, AssetMappingDMRequest]):
     def __init__(self, client: ToolkitClient) -> None:
         self.client = client
 
     def map(
-        self, source: Sequence[AssetMappingResponse]
+        self, source: Sequence[AssetMappingClassicResponse]
     ) -> Sequence[tuple[AssetMappingDMRequest | None, MigrationIssue]]:
         output: list[tuple[AssetMappingDMRequest | None, MigrationIssue]] = []
         self._populate_cache(source)
@@ -491,7 +491,7 @@ class ThreeDAssetMapper(DataMapper[ThreeDSelector, AssetMappingResponse, AssetMa
             output.append((mapped_item, issue))
         return output
 
-    def _populate_cache(self, source: Sequence[AssetMappingResponse]) -> None:
+    def _populate_cache(self, source: Sequence[AssetMappingClassicResponse]) -> None:
         asset_ids: set[int] = set()
         for mapping in source:
             if mapping.asset_id is not None:
@@ -499,7 +499,7 @@ class ThreeDAssetMapper(DataMapper[ThreeDSelector, AssetMappingResponse, AssetMa
         self.client.migration.lookup.assets(list(asset_ids))
 
     def _map_single_item(
-        self, item: AssetMappingResponse
+        self, item: AssetMappingClassicResponse
     ) -> tuple[AssetMappingDMRequest | None, ThreeDModelMigrationIssue]:
         issue = ThreeDModelMigrationIssue(model_name=f"AssetMapping_{item.model_id}", model_id=item.model_id)
         asset_instance_id = item.asset_instance_id

cognite_toolkit/_cdf_tk/commands/_migrate/migration_io.py

@@ -16,8 +16,8 @@ from cognite_toolkit._cdf_tk.client.http_client import (
 )
 from cognite_toolkit._cdf_tk.client.resource_classes.legacy.pending_instances_ids import PendingInstanceId
 from cognite_toolkit._cdf_tk.client.resource_classes.three_d import (
+    AssetMappingClassicResponse,
     AssetMappingDMRequest,
-    AssetMappingResponse,
     ThreeDModelResponse,
 )
 from cognite_toolkit._cdf_tk.commands._migrate.data_classes import ThreeDMigrationRequest
@@ -415,7 +415,7 @@ class ThreeDMigrationIO(UploadableStorageIO[ThreeDSelector, ThreeDModelResponse,
         total = 0
         while True:
             request_limit = min(self.DOWNLOAD_LIMIT, limit - total) if limit is not None else self.DOWNLOAD_LIMIT
-            response = self.client.tool.three_d.models.paginate(
+            response = self.client.tool.three_d.models_classic.paginate(
                 published=published, include_revision_info=True, limit=request_limit, cursor=cursor
             )
             items = [item for item in response.items if self._is_selected(item, included_models)]
@@ -477,7 +477,9 @@ class ThreeDMigrationIO(UploadableStorageIO[ThreeDSelector, ThreeDModelResponse,
         return results
 
 
-class ThreeDAssetMappingMigrationIO(UploadableStorageIO[ThreeDSelector, AssetMappingResponse, AssetMappingDMRequest]):
+class ThreeDAssetMappingMigrationIO(
+    UploadableStorageIO[ThreeDSelector, AssetMappingClassicResponse, AssetMappingDMRequest]
+):
     KIND = "3DMigrationAssetMapping"
     SUPPORTED_DOWNLOAD_FORMATS = frozenset({".ndjson"})
     SUPPORTED_COMPRESSIONS = frozenset({".gz"})
@@ -493,10 +495,12 @@ class ThreeDAssetMappingMigrationIO(UploadableStorageIO[ThreeDSelector, AssetMap
         # We can only migrate asset mappings for 3D models that are already migrated to data modeling.
         self._3D_io = ThreeDMigrationIO(client, data_model_type="data modeling")
 
-    def as_id(self, item: AssetMappingResponse) -> str:
+    def as_id(self, item: AssetMappingClassicResponse) -> str:
         return f"AssetMapping_{item.model_id!s}_{item.revision_id!s}_{item.asset_id!s}"
 
-    def stream_data(self, selector: ThreeDSelector, limit: int | None = None) -> Iterable[Page[AssetMappingResponse]]:
+    def stream_data(
+        self, selector: ThreeDSelector, limit: int | None = None
+    ) -> Iterable[Page[AssetMappingClassicResponse]]:
         total = 0
         for three_d_page in self._3D_io.stream_data(selector, None):
             for model in three_d_page.items:
@@ -510,7 +514,7 @@ class ThreeDAssetMappingMigrationIO(UploadableStorageIO[ThreeDSelector, AssetMap
                     )
                     if limit is not None and total >= limit:
                         return
-                    response = self.client.tool.three_d.asset_mappings.paginate(
+                    response = self.client.tool.three_d.asset_mappings_classic.paginate(
                         model_id=model.id,
                         revision_id=model.last_revision_info.revision_id,
                         cursor=cursor,
@@ -562,6 +566,6 @@ class ThreeDAssetMappingMigrationIO(UploadableStorageIO[ThreeDSelector, AssetMap
         raise NotImplementedError("Deserializing 3D Asset Mappings from JSON is not supported.")
 
     def data_to_json_chunk(
-        self, data_chunk: Sequence[AssetMappingResponse], selector: ThreeDSelector | None = None
+        self, data_chunk: Sequence[AssetMappingClassicResponse], selector: ThreeDSelector | None = None
     ) -> list[dict[str, JsonVal]]:
         raise NotImplementedError("Serializing 3D Asset Mappings to JSON is not supported.")