adcp 2.19.0__py3-none-any.whl → 3.1.0__py3-none-any.whl

adcp/types/aliases.py

@@ -35,9 +35,6 @@ from adcp.types._generated import (
     # Activation responses
     ActivateSignalResponse1,
     ActivateSignalResponse2,
-    # Activation keys
-    ActivationKey1,
-    ActivationKey2,
     # Authorized agents
     AuthorizedAgents,
     AuthorizedAgents1,
@@ -46,6 +43,11 @@ from adcp.types._generated import (
     # Build creative responses
     BuildCreativeResponse1,
     BuildCreativeResponse2,
+    CpcPricingOption,
+    CpcvPricingOption,
+    CpmPricingOption,
+    CppPricingOption,
+    CpvPricingOption,
     # Create media buy responses
     CreateMediaBuyResponse1,
     CreateMediaBuyResponse2,
@@ -58,16 +60,17 @@ from adcp.types._generated import (
     # Destination types
     Destination1,
     Destination2,
+    FlatRatePricingOption,
     # Preview creative requests
     PreviewCreativeRequest1,
     PreviewCreativeRequest2,
     # Preview creative responses
     PreviewCreativeResponse1,
     PreviewCreativeResponse2,
-    # Preview renders
-    PreviewRender1,
-    PreviewRender2,
-    PreviewRender3,
+    # Preview renders (discriminated union by output_format)
+    PreviewRender1,  # output_format='url'
+    PreviewRender2,  # output_format='html'
+    PreviewRender3,  # output_format='both'
     # Publisher properties types
     PropertyId,
     PropertyTag,
@@ -89,6 +92,7 @@ from adcp.types._generated import (
     # VAST assets
     VastAsset1,
     VastAsset2,
+    VcpmPricingOption,
 )
 from adcp.types._generated import (
     PublisherPropertySelector1 as PublisherPropertiesInternal,
@@ -198,12 +202,11 @@ UpdateMediaBuyPropertiesRequest = UpdateMediaBuyRequest2
 # ============================================================================
 # ACTIVATION KEY ALIASES
 # ============================================================================
-
-PropertyIdActivationKey = ActivationKey1
-"""Activation key using property_id for identification."""
-
-PropertyTagActivationKey = ActivationKey2
-"""Activation key using property_tags for identification."""
+# Note: Activation key schema changed from property_id/property_tag variants
+# to segment_id/key_value variants. Import directly from _generated:
+#   from adcp.types._generated import ActivationKey1 as SegmentIdActivationKey
+#   from adcp.types._generated import ActivationKey2 as KeyValueActivationKey
+# These will be added once the types are regenerated with proper schema.
 
 # ============================================================================
 # PREVIEW/RENDER TYPE ALIASES
@@ -216,15 +219,15 @@ PreviewCreativeStaticResponse = PreviewCreativeResponse1
 PreviewCreativeInteractiveResponse = PreviewCreativeResponse2
 """Preview response with interactive renders (iframe embedding)."""
 
-# Preview Render Variants (discriminated by output_format)
+# Preview Render Aliases (discriminated union by output_format)
 UrlPreviewRender = PreviewRender1
-"""Preview render with output_format='url' - provides preview_url for iframe embedding."""
+"""Preview render with output_format='url' and preview_url for iframe embedding."""
 
 HtmlPreviewRender = PreviewRender2
-"""Preview render with output_format='html' - provides preview_html for direct embedding."""
+"""Preview render with output_format='html' and preview_html for direct embedding."""
 
 BothPreviewRender = PreviewRender3
-"""Preview render with output_format='both' - provides both preview_url and preview_html."""
+"""Preview render with output_format='both' and both preview_url and preview_html."""
 
 # ============================================================================
 # ASSET TYPE ALIASES - Delivery & Kind Discriminated Unions
@@ -692,6 +695,52 @@ Example:
     ```
 """
 
+# ============================================================================
+# PRICING OPTION UNION TYPE - For Type Hints Without RootModel Wrapper
+# ============================================================================
+# The generated PricingOption is a RootModel wrapper that mypy doesn't recognize
+# as compatible with the individual variant types. This union alias provides a
+# way to type-hint pricing options without the wrapper, fixing mypy list-item errors.
+
+PricingOption = (
+    CpmPricingOption
+    | VcpmPricingOption
+    | CpcPricingOption
+    | CpcvPricingOption
+    | CpvPricingOption
+    | CppPricingOption
+    | FlatRatePricingOption
+)
+"""Union type for all pricing option variants.
+
+Use this for type hints when constructing Product.pricing_options or any field
+that accepts pricing options. This fixes mypy list-item errors that occur when
+using the individual variant types.
+
+Example:
+    ```python
+    from adcp.types import Product, CpmPricingOption, PricingOption
+
+    # Type hint for a list of pricing options
+    def get_pricing(options: list[PricingOption]) -> None:
+        for opt in options:
+            print(f"Model: {opt.pricing_model}")
+
+    # Use in Product construction (no more mypy errors!)
+    product = Product(
+        product_id="test",
+        name="Test Product",
+        pricing_options=[
+            CpmPricingOption(
+                pricing_model="cpm",
+                floor_price=1.50,
+                currency="USD"
+            )
+        ]
+    )
+    ```
+"""
+
 # ============================================================================
 # EXPORTS
 # ============================================================================
@@ -700,9 +749,6 @@ __all__ = [
     # Activation responses
     "ActivateSignalSuccessResponse",
     "ActivateSignalErrorResponse",
-    # Activation keys
-    "PropertyIdActivationKey",
-    "PropertyTagActivationKey",
     # Asset type aliases
     "BothPreviewRender",
     "HtmlPreviewRender",
@@ -766,4 +812,6 @@ __all__ = [
     "AgentDestination",
     # Destination union
     "Destination",
+    # Pricing option union
+    "PricingOption",
 ]

adcp/types/base.py

@@ -204,7 +204,7 @@ class AdCPBaseModel(BaseModel):
             kwargs["exclude_none"] = True
         return super().model_dump_json(**kwargs)
 
-    def summary(self) -> str:
+    def model_summary(self) -> str:
         """Human-readable summary for protocol responses.
 
         Returns a standardized human-readable message suitable for MCP tool