adcp 2.18.0__py3-none-any.whl → 3.0.0__py3-none-any.whl

adcp/types/generated_poc/core/reporting_webhook.py

@@ -0,0 +1,70 @@
+# generated by datamodel-codegen:
+#   filename:  core/reporting_webhook.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, ConfigDict, Field
+
+from ..enums import auth_scheme, available_metric
+
+
+class Authentication(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    credentials: Annotated[
+        str,
+        Field(
+            description='Credentials for authentication. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.',
+            min_length=32,
+        ),
+    ]
+    schemes: Annotated[
+        list[auth_scheme.AuthenticationScheme],
+        Field(
+            description="Array of authentication schemes. Supported: ['Bearer'] for simple token auth, ['HMAC-SHA256'] for signature verification (recommended for production)",
+            max_length=1,
+            min_length=1,
+        ),
+    ]
+
+
+class ReportingFrequency(Enum):
+    hourly = 'hourly'
+    daily = 'daily'
+    monthly = 'monthly'
+
+
+class ReportingWebhook(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    authentication: Annotated[
+        Authentication,
+        Field(description='Authentication configuration for webhook delivery (A2A-compatible)'),
+    ]
+    reporting_frequency: Annotated[
+        ReportingFrequency,
+        Field(
+            description='Frequency for automated reporting delivery. Must be supported by all products in the media buy.'
+        ),
+    ]
+    requested_metrics: Annotated[
+        list[available_metric.AvailableMetric] | None,
+        Field(
+            description="Optional list of metrics to include in webhook notifications. If omitted, all available metrics are included. Must be subset of product's available_metrics."
+        ),
+    ] = None
+    token: Annotated[
+        str | None,
+        Field(
+            description='Optional client-provided token for webhook validation. Echoed back in webhook payload to validate request authenticity.',
+            min_length=16,
+        ),
+    ] = None
+    url: Annotated[AnyUrl, Field(description='Webhook endpoint URL for reporting notifications')]

adcp/types/generated_poc/core/response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/response.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/signal_filters.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/signal_filters.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/start_timing.py

@@ -1,17 +1,17 @@
 # generated by datamodel-codegen:
 #   filename:  core/start_timing.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
-from typing import Annotated
+from typing import Annotated, Literal
 
 from pydantic import AwareDatetime, Field, RootModel
 
 
-class StartTiming(RootModel[str | AwareDatetime]):
+class StartTiming(RootModel[Literal['asap'] | AwareDatetime]):
     root: Annotated[
-        str | AwareDatetime,
+        Literal['asap'] | AwareDatetime,
         Field(
             description="Campaign start timing: 'asap' or ISO 8601 date-time", title='Start Timing'
         ),

adcp/types/generated_poc/core/sub_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/sub_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/targeting.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/targeting.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -9,13 +9,54 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field, RootModel
 
+from ..enums import metro_system, postal_system
 from . import frequency_cap as frequency_cap_1
 
 
-class GeoCountryAnyOfItem(RootModel[str]):
+class GeoCountry(RootModel[str]):
     root: Annotated[str, Field(pattern='^[A-Z]{2}$')]
 
 
+class GeoMetro(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    system: Annotated[
+        metro_system.MetroAreaSystem,
+        Field(description="Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')"),
+    ]
+    values: Annotated[
+        list[str],
+        Field(
+            description="Metro codes within the system (e.g., ['501', '602'] for Nielsen DMAs)",
+            min_length=1,
+        ),
+    ]
+
+
+class GeoPostalArea(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    system: Annotated[
+        postal_system.PostalCodeSystem,
+        Field(
+            description="Postal code system (e.g., 'us_zip', 'gb_outward'). System name encodes country and precision."
+        ),
+    ]
+    values: Annotated[
+        list[str],
+        Field(
+            description="Postal codes within the system (e.g., ['10001', '10002'] for us_zip)",
+            min_length=1,
+        ),
+    ]
+
+
+class GeoRegion(RootModel[str]):
+    root: Annotated[str, Field(pattern='^[A-Z]{2}-[A-Z0-9]{1,3}$')]
+
+
 class TargetingOverlay(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
@@ -27,27 +68,27 @@ class TargetingOverlay(AdCPBaseModel):
         str | None, Field(description='AXE segment ID to include for targeting')
     ] = None
     frequency_cap: frequency_cap_1.FrequencyCap | None = None
-    geo_country_any_of: Annotated[
-        list[GeoCountryAnyOfItem] | None,
+    geo_countries: Annotated[
+        list[GeoCountry] | None,
         Field(
-            description='Restrict delivery to specific countries (ISO codes). Use for regulatory compliance or RCT testing.'
+            description="Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE')."
         ),
     ] = None
-    geo_metro_any_of: Annotated[
-        list[str] | None,
+    geo_metros: Annotated[
+        list[GeoMetro] | None,
         Field(
-            description='Restrict delivery to specific metro areas (DMA codes). Use for regulatory compliance or RCT testing.'
+            description='Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.'
         ),
     ] = None
-    geo_postal_code_any_of: Annotated[
-        list[str] | None,
+    geo_postal_areas: Annotated[
+        list[GeoPostalArea] | None,
         Field(
-            description='Restrict delivery to specific postal/ZIP codes. Use for regulatory compliance or RCT testing.'
+            description='Restrict delivery to specific postal areas. Each entry specifies the postal system and target values. Seller must declare supported systems in get_adcp_capabilities.'
         ),
     ] = None
-    geo_region_any_of: Annotated[
-        list[str] | None,
+    geo_regions: Annotated[
+        list[GeoRegion] | None,
         Field(
-            description='Restrict delivery to specific regions/states. Use for regulatory compliance or RCT testing.'
+            description="Restrict delivery to specific regions/states. ISO 3166-2 subdivision codes (e.g., 'US-CA', 'GB-SCT')."
         ),
     ] = None

adcp/types/generated_poc/creative/list_creative_formats_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  creative/list_creative_formats_request.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/creative/list_creative_formats_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  creative/list_creative_formats_response.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/creative/preview_creative_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  creative/preview_creative_request.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/creative/preview_creative_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  creative/preview_creative_response.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -109,7 +109,8 @@ class Results(AdCPBaseModel):
     success: Annotated[Literal[True], Field(description='Whether this preview request succeeded')]
 
 
-Preview2 = Preview1
+class Preview2(Preview1):
+    pass
 
 
 class Response1(AdCPBaseModel):

adcp/types/generated_poc/creative/preview_render.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  creative/preview_render.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-26T11:59:53+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/adcp_domain.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/adcp_domain.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -10,3 +10,5 @@ from enum import Enum
 class AdcpDomain(Enum):
     media_buy = 'media-buy'
     signals = 'signals'
+    governance = 'governance'
+    creative = 'creative'

adcp/types/generated_poc/enums/asset_content_type.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/asset_content_type.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/auth_scheme.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/auth_scheme.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/available_metric.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/available_metric.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/channels.py

@@ -1,19 +1,29 @@
 # generated by datamodel-codegen:
 #   filename:  enums/channels.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
 from enum import Enum
 
 
-class AdvertisingChannels(Enum):
+class MediaChannel(Enum):
     display = 'display'
-    video = 'video'
-    audio = 'audio'
-    native = 'native'
-    dooh = 'dooh'
+    olv = 'olv'
+    social = 'social'
+    search = 'search'
     ctv = 'ctv'
+    linear_tv = 'linear_tv'
+    radio = 'radio'
+    streaming_audio = 'streaming_audio'
     podcast = 'podcast'
-    retail = 'retail'
-    social = 'social'
+    dooh = 'dooh'
+    ooh = 'ooh'
+    print = 'print'
+    cinema = 'cinema'
+    email = 'email'
+    gaming = 'gaming'
+    retail_media = 'retail_media'
+    influencer = 'influencer'
+    affiliate = 'affiliate'
+    product_placement = 'product_placement'

adcp/types/generated_poc/enums/co_branding_requirement.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/co_branding_requirement.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/creative_action.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/creative_action.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/creative_agent_capability.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/creative_agent_capability.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/creative_sort_field.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/creative_sort_field.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/creative_status.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/creative_status.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -12,3 +12,4 @@ class CreativeStatus(Enum):
     approved = 'approved'
     rejected = 'rejected'
     pending_review = 'pending_review'
+    archived = 'archived'

adcp/types/generated_poc/enums/daast_tracking_event.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/daast_tracking_event.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/daast_version.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/daast_version.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/delivery_type.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/delivery_type.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/dimension_unit.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/dimension_unit.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/feed_format.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/feed_format.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/feedback_source.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/feedback_source.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/format_category.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/format_category.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/format_id_parameter.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/format_id_parameter.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/frequency_cap_scope.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/frequency_cap_scope.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/geo_level.py

@@ -0,0 +1,14 @@
+# generated by datamodel-codegen:
+#   filename:  enums/geo_level.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+
+
+class GeographicTargetingLevel(Enum):
+    country = 'country'
+    region = 'region'
+    metro = 'metro'
+    postal_area = 'postal_area'

adcp/types/generated_poc/enums/history_entry_type.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/history_entry_type.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/http_method.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/http_method.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/identifier_types.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/identifier_types.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/javascript_module_type.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/javascript_module_type.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/landing_page_requirement.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/landing_page_requirement.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/markdown_flavor.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/markdown_flavor.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/media_buy_status.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/media_buy_status.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/metric_type.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/metric_type.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/metro_system.py

@@ -0,0 +1,15 @@
+# generated by datamodel-codegen:
+#   filename:  enums/metro_system.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+
+
+class MetroAreaSystem(Enum):
+    nielsen_dma = 'nielsen_dma'
+    uk_itl1 = 'uk_itl1'
+    uk_itl2 = 'uk_itl2'
+    eurostat_nuts2 = 'eurostat_nuts2'
+    custom = 'custom'

adcp/types/generated_poc/enums/notification_type.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/notification_type.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/pacing.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/pacing.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/enums/postal_system.py

@@ -0,0 +1,19 @@
+# generated by datamodel-codegen:
+#   filename:  enums/postal_system.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+
+
+class PostalCodeSystem(Enum):
+    us_zip = 'us_zip'
+    us_zip_plus_four = 'us_zip_plus_four'
+    gb_outward = 'gb_outward'
+    gb_full = 'gb_full'
+    ca_fsa = 'ca_fsa'
+    ca_full = 'ca_full'
+    de_plz = 'de_plz'
+    fr_code_postal = 'fr_code_postal'
+    au_postcode = 'au_postcode'

adcp/types/generated_poc/enums/preview_output_format.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/preview_output_format.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations