HA-399 deprecate cookies

CHANGELOG.md

@@ -16,6 +16,9 @@ The types of changes are:
 
 ## [Unreleased](https://github.com/ethyca/fideslang/compare/3.0.9...main)
 
+### Deprecated
+- Deprecated `Cookies` model and `.cookies` property on `System` and `PrivacyDeclaration` [#199](https://github.com/IABTechLab/fideslang/pull/199)
+
 ## [3.0.9](https://github.com/ethyca/fideslang/compare/3.0.8...3.0.9)
 
 ### Added

src/fideslang/models.py

@@ -8,6 +8,7 @@
 from datetime import datetime
 from enum import Enum
 from typing import Annotated, Dict, List, Optional, Union, Any
+from warnings import warn
 
 from packaging.version import InvalidVersion, Version
 from pydantic import (
@@ -284,13 +285,24 @@ class DataCategory(FidesModel, DefaultModel):
 
 
 class Cookies(BaseModel):
-    """The Cookies resource model"""
+    """
+    DEPRECATED.
+    The Cookies resource model
+    """
 
     name: str
     path: Optional[str] = None
     domain: Optional[str] = None
     model_config = ConfigDict(from_attributes=True)
 
+    @model_validator(mode="after")
+    def validate_cookies(self, _: ValidationInfo) -> Cookies:
+        """
+        Validate that the `cookies` field is deprecated and warn that it should not be used.
+        """
+        warn("The 'cookies' field is deprecated and should not be used.")
+        return self
+
 
 class DataSubjectRights(BaseModel):
     """
@@ -881,10 +893,22 @@ class PrivacyDeclaration(BaseModel):
     )
     cookies: Optional[List[Cookies]] = Field(
         default=None,
-        description="Cookies associated with this data use to deliver services and functionality",
+        description="DEPRECATED. Cookies associated with this data use to deliver services and functionality",
     )
     model_config = ConfigDict(from_attributes=True)
 
+    @field_validator("cookies")
+    @classmethod
+    def validate_cookies(
+        cls, value: Optional[List[Cookies]]
+    ) -> Optional[List[Cookies]]:
+        """
+        Validate that the `cookies` field is deprecated and warn that it should not be used.
+        """
+        if value is not None:
+            warn("The 'cookies' field is deprecated and should not be used.")
+        return value
+
 
 class SystemMetadata(BaseModel):
     """
@@ -1134,6 +1158,18 @@ def privacy_declarations_reference_data_flows(
 
         return self
 
+    @field_validator("cookies")
+    @classmethod
+    def validate_cookies(
+        cls, value: Optional[List[Cookies]]
+    ) -> Optional[List[Cookies]]:
+        """
+        Validate that the `cookies` field is deprecated and warn that it should not be used.
+        """
+        if value is not None:
+            warn("The 'cookies' field is deprecated and should not be used.")
+        return value
+
     model_config = ConfigDict(use_enum_values=True)