@adcp/client 0.4.2 → 2.0.2

package/dist/lib/types/core.generated.d.ts

@@ -65,15 +65,23 @@ export interface Package {
      */
     product_id?: string;
     /**
-     * Array of product IDs to include in this package
+     * Budget allocation for this package in the currency specified by the pricing option
      */
-    products?: string[];
-    budget?: Budget;
+    budget?: number;
+    pacing?: Pacing;
+    /**
+     * ID of the selected pricing option from the product's pricing_options array
+     */
+    pricing_option_id?: string;
+    /**
+     * Bid price for auction-based CPM pricing (present if using cpm-auction-option)
+     */
+    bid_price?: number;
     /**
      * Impression goal for this package
      */
     impressions?: number;
-    targeting_overlay?: Targeting;
+    targeting_overlay?: TargetingOverlay;
     /**
      * Creative assets assigned to this package
      */
@@ -81,71 +89,29 @@ export interface Package {
     /**
      * Format IDs that creative assets will be provided for this package
      */
-    formats_to_provide?: string[];
+    format_ids_to_provide?: FormatID[];
     status: PackageStatus;
 }
 /**
- * Budget configuration for a media buy or package
+ * Optional geographic refinements for media buys. Most targeting should be expressed in the brief and handled by the publisher. These fields are primarily for geographic restrictions (RCT testing, regulatory compliance).
  */
-export interface Budget {
+export interface TargetingOverlay {
     /**
-     * Total budget amount
-     */
-    total: number;
-    /**
-     * ISO 4217 currency code
-     */
-    currency: string;
-    pacing?: Pacing;
-}
-/**
- * Audience targeting criteria
- */
-export interface Targeting {
-    /**
-     * Target specific countries (ISO codes)
+     * Restrict delivery to specific countries (ISO codes). Use for regulatory compliance or RCT testing.
      */
     geo_country_any_of?: string[];
     /**
-     * Target specific regions/states
+     * Restrict delivery to specific regions/states. Use for regulatory compliance or RCT testing.
      */
     geo_region_any_of?: string[];
     /**
-     * Target specific metro areas (DMA codes)
+     * Restrict delivery to specific metro areas (DMA codes). Use for regulatory compliance or RCT testing.
      */
     geo_metro_any_of?: string[];
     /**
-     * Target specific postal/ZIP codes
+     * Restrict delivery to specific postal/ZIP codes. Use for regulatory compliance or RCT testing.
      */
     geo_postal_code_any_of?: string[];
-    /**
-     * Audience segment IDs to target
-     */
-    audience_segment_any_of?: string[];
-    /**
-     * AXE segment ID to include for targeting
-     */
-    axe_include_segment?: string;
-    /**
-     * AXE segment ID to exclude from targeting
-     */
-    axe_exclude_segment?: string;
-    /**
-     * Signal IDs from get_signals
-     */
-    signals?: string[];
-    /**
-     * Target specific device types
-     */
-    device_type_any_of?: ('desktop' | 'mobile' | 'tablet' | 'connected_tv' | 'smart_speaker')[];
-    /**
-     * Target specific operating systems
-     */
-    os_any_of?: ('windows' | 'macos' | 'ios' | 'android' | 'linux' | 'roku' | 'tvos' | 'other')[];
-    /**
-     * Target specific browsers
-     */
-    browser_any_of?: ('chrome' | 'firefox' | 'safari' | 'edge' | 'other')[];
     frequency_cap?: FrequencyCap;
 }
 /**
@@ -171,26 +137,36 @@ export interface CreativeAssignment {
     weight?: number;
 }
 /**
- * Creative asset for upload to library - supports both hosted assets and third-party snippets
- */
-export type CreativeAsset = CreativeAsset1 & CreativeAsset2;
-/**
- * Type of snippet content
+ * Structured format identifier with agent URL and format name
  */
-export type SnippetType = 'vast_xml' | 'vast_url' | 'html' | 'javascript' | 'iframe' | 'daast_url';
+export interface FormatID {
+    /**
+     * URL of the agent that defines this format (e.g., 'https://creatives.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats)
+     */
+    agent_url: string;
+    /**
+     * Format identifier within the agent's namespace (e.g., 'display_300x250', 'video_standard_30s')
+     */
+    id: string;
+}
 /**
- * Sub-asset for multi-asset creative formats, including carousel images and native ad template variables
+ * VAST (Video Ad Serving Template) tag for third-party video ad serving
  */
-export type SubAsset = SubAsset1 & SubAsset2;
-export type SubAsset2 = {
-    [k: string]: unknown;
-} | {
+export type VASTAsset = VASTAsset1 & VASTAsset2;
+export type VASTAsset2 = {
     [k: string]: unknown;
 };
-export type CreativeAsset2 = {
+/**
+ * DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving
+ */
+export type DAASTAsset = DAASTAsset1 & DAASTAsset2;
+export type DAASTAsset2 = {
     [k: string]: unknown;
 };
-export interface CreativeAsset1 {
+/**
+ * Creative asset for upload to library - supports static assets, generative formats, and third-party snippets
+ */
+export interface CreativeAsset {
     /**
      * Unique identifier for the creative
      */
@@ -199,61 +175,293 @@ export interface CreativeAsset1 {
      * Human-readable creative name
      */
     name: string;
+    format_id: FormatID;
+    /**
+     * Assets required by the format, keyed by asset_role
+     */
+    assets: {
+        /**
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[a-zA-Z0-9_-]+$".
+         */
+        [k: string]: ImageAsset | VideoAsset | AudioAsset | TextAsset | HTMLAsset | CSSAsset | JavaScriptAsset | VASTAsset | DAASTAsset | PromotedOfferingsAsset | URLAsset;
+    };
+    /**
+     * Preview contexts for generative formats - defines what scenarios to generate previews for
+     */
+    inputs?: {
+        /**
+         * Human-readable name for this preview variant
+         */
+        name: string;
+        /**
+         * Macro values to apply for this preview
+         */
+        macros?: {
+            [k: string]: string;
+        };
+        /**
+         * Natural language description of the context for AI-generated content
+         */
+        context_description?: string;
+    }[];
     /**
-     * Creative format type (e.g., video, audio, display)
+     * User-defined tags for organization and searchability
      */
-    format: string;
+    tags?: string[];
     /**
-     * URL of the creative file (for hosted assets)
+     * For generative creatives: set to true to approve and finalize, false to request regeneration with updated assets/message. Omit for non-generative creatives.
      */
-    media_url?: string;
+    approved?: boolean;
+}
+/**
+ * Format identifier specifying which format this creative conforms to
+ */
+export interface FormatID {
     /**
-     * Third-party tag, VAST XML, or code snippet (for third-party served assets)
+     * URL of the agent that defines this format (e.g., 'https://creatives.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats)
      */
-    snippet?: string;
-    snippet_type?: SnippetType;
+    agent_url: string;
     /**
-     * Landing page URL for the creative
+     * Format identifier within the agent's namespace (e.g., 'display_300x250', 'video_standard_30s')
      */
-    click_url?: string;
+    id: string;
+}
+/**
+ * Image asset with URL and dimensions
+ */
+export interface ImageAsset {
+    asset_type: 'image';
     /**
-     * Duration in milliseconds (for video/audio)
+     * URL to the image asset
      */
-    duration?: number;
+    url: string;
     /**
-     * Width in pixels (for video/display)
+     * Image width in pixels
      */
     width?: number;
     /**
-     * Height in pixels (for video/display)
+     * Image height in pixels
      */
     height?: number;
     /**
-     * User-defined tags for organization and searchability
+     * Image file format (jpg, png, gif, webp, etc.)
      */
-    tags?: string[];
+    format?: string;
+    /**
+     * Alternative text for accessibility
+     */
+    alt_text?: string;
+}
+/**
+ * Video asset with URL and specifications
+ */
+export interface VideoAsset {
+    asset_type: 'video';
+    /**
+     * URL to the video asset
+     */
+    url: string;
+    /**
+     * Video width in pixels
+     */
+    width?: number;
+    /**
+     * Video height in pixels
+     */
+    height?: number;
+    /**
+     * Video duration in milliseconds
+     */
+    duration_ms?: number;
+    /**
+     * Video file format (mp4, webm, mov, etc.)
+     */
+    format?: string;
+    /**
+     * Video bitrate in kilobits per second
+     */
+    bitrate_kbps?: number;
+}
+/**
+ * Audio asset with URL and specifications
+ */
+export interface AudioAsset {
+    asset_type: 'audio';
+    /**
+     * URL to the audio asset
+     */
+    url: string;
+    /**
+     * Audio duration in milliseconds
+     */
+    duration_ms?: number;
+    /**
+     * Audio file format (mp3, wav, aac, etc.)
+     */
+    format?: string;
+    /**
+     * Audio bitrate in kilobits per second
+     */
+    bitrate_kbps?: number;
+}
+/**
+ * Text content asset
+ */
+export interface TextAsset {
+    asset_type: 'text';
+    /**
+     * Text content
+     */
+    content: string;
     /**
-     * Sub-assets for multi-asset formats like carousels
+     * Maximum character length constraint
      */
-    assets?: SubAsset[];
+    max_length?: number;
+    /**
+     * Language code (e.g., 'en', 'es', 'fr')
+     */
+    language?: string;
 }
-export interface SubAsset1 {
+/**
+ * HTML content asset
+ */
+export interface HTMLAsset {
+    asset_type: 'html';
     /**
-     * Type of asset. Common types: headline, body_text, thumbnail_image, product_image, featured_image, logo, cta_text, price_text, sponsor_name, author_name, click_url
+     * HTML content
      */
-    asset_type?: string;
+    content: string;
     /**
-     * Unique identifier for the asset within the creative
+     * HTML version (e.g., 'HTML5')
      */
-    asset_id?: string;
+    version?: string;
+}
+/**
+ * CSS stylesheet asset
+ */
+export interface CSSAsset {
+    asset_type: 'css';
     /**
-     * URL for media assets (images, videos, etc.)
+     * CSS content
      */
-    content_uri?: string;
+    content: string;
     /**
-     * Text content for text-based assets like headlines, body text, CTA text, etc.
+     * CSS media query context (e.g., 'screen', 'print')
      */
-    content?: string | string[];
+    media?: string;
+}
+/**
+ * JavaScript code asset
+ */
+export interface JavaScriptAsset {
+    asset_type: 'javascript';
+    /**
+     * JavaScript content
+     */
+    content: string;
+    /**
+     * JavaScript module type
+     */
+    module_type?: 'esm' | 'commonjs' | 'script';
+}
+export interface VASTAsset1 {
+    asset_type?: 'vast';
+    /**
+     * URL endpoint that returns VAST XML
+     */
+    url?: string;
+    /**
+     * Inline VAST XML content
+     */
+    content?: string;
+    /**
+     * VAST specification version
+     */
+    vast_version?: '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
+    /**
+     * Whether VPAID (Video Player-Ad Interface Definition) is supported
+     */
+    vpaid_enabled?: boolean;
+    /**
+     * Maximum allowed wrapper/redirect depth
+     */
+    max_wrapper_depth?: number;
+    /**
+     * Expected video duration in milliseconds (if known)
+     */
+    duration_ms?: number;
+    /**
+     * Tracking events supported by this VAST tag
+     */
+    tracking_events?: ('start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'click' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute' | 'fullscreen' | 'exitFullscreen' | 'playerExpand' | 'playerCollapse')[];
+}
+export interface DAASTAsset1 {
+    asset_type?: 'daast';
+    /**
+     * URL endpoint that returns DAAST XML
+     */
+    url?: string;
+    /**
+     * Inline DAAST XML content
+     */
+    content?: string;
+    /**
+     * DAAST specification version
+     */
+    daast_version?: '1.0' | '1.1';
+    /**
+     * Expected audio duration in milliseconds (if known)
+     */
+    duration_ms?: number;
+    /**
+     * Tracking events supported by this DAAST tag
+     */
+    tracking_events?: ('start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute')[];
+    /**
+     * Whether companion display ads are included
+     */
+    companion_ads?: boolean;
+}
+/**
+ * Reference to promoted offerings specification
+ */
+export interface PromotedOfferingsAsset {
+    asset_type: 'promoted_offerings';
+    /**
+     * URL of the advertiser's brand or offering (e.g., https://retailer.com)
+     */
+    url?: string;
+    /**
+     * Brand colors
+     */
+    colors?: {
+        primary?: string;
+        secondary?: string;
+        accent?: string;
+    };
+    /**
+     * Brand fonts
+     */
+    fonts?: string[];
+    /**
+     * Brand tone/voice
+     */
+    tone?: string;
+}
+/**
+ * URL reference asset
+ */
+export interface URLAsset {
+    asset_type: 'url';
+    /**
+     * URL reference
+     */
+    url: string;
+    /**
+     * Description of what this URL points to
+     */
+    description?: string;
 }
 /**
  * Represents available advertising inventory
@@ -267,6 +475,10 @@ export type PropertyIdentifierTypes = 'domain' | 'subdomain' | 'network_id' | 'i
  * Type of inventory delivery
  */
 export type DeliveryType = 'guaranteed' | 'non_guaranteed';
+/**
+ * A pricing model option offered by a publisher for a product. Each pricing model has its own schema with model-specific requirements.
+ */
+export type PricingOption = CPMFixedRatePricingOption | CPMAuctionPricingOption | VCPMFixedRatePricingOption | VCPMAuctionPricingOption | CPCPricingOption | CPCVPricingOption | CPVPricingOption | CPPPricingOption | FlatRatePricingOption;
 export type Product2 = {
     [k: string]: unknown;
 };
@@ -296,23 +508,35 @@ export interface Product1 {
      */
     property_tags?: [string, ...string[]];
     /**
-     * Array of supported creative format IDs - use list_creative_formats to get full format details
+     * Array of supported creative format IDs - structured format_id objects with agent_url and id
      */
-    format_ids: string[];
+    format_ids: FormatID[];
     delivery_type: DeliveryType;
     /**
-     * Whether this product has fixed pricing (true) or uses auction (false)
-     */
-    is_fixed_price: boolean;
-    /**
-     * Cost per thousand impressions in USD
+     * Available pricing models for this product
+     *
+     * @minItems 1
      */
-    cpm?: number;
+    pricing_options: [PricingOption, ...PricingOption[]];
     /**
-     * Minimum budget requirement in USD
+     * Estimated exposures/impressions for guaranteed products
      */
-    min_spend?: number;
+    estimated_exposures?: number;
     measurement?: Measurement;
+    /**
+     * Measurement provider and methodology for delivery metrics. The buyer accepts the declared provider as the source of truth for the buy. REQUIRED for all products.
+     */
+    delivery_measurement: {
+        /**
+         * Measurement provider(s) used for this product (e.g., 'Google Ad Manager with IAS viewability', 'Nielsen DAR', 'Geopath for DOOH impressions')
+         */
+        provider: string;
+        /**
+         * Additional details about measurement methodology in plain language (e.g., 'MRC-accredited viewability. 50% in-view for 1s display / 2s video', 'Panel-based demographic measurement updated monthly')
+         */
+        notes?: string;
+    };
+    reporting_capabilities?: ReportingCapabilities;
     creative_policy?: CreativePolicy;
     /**
      * Whether this is a custom product
@@ -369,6 +593,347 @@ export interface Property {
      */
     publisher_domain: string;
 }
+/**
+ * Structured format identifier with agent URL and format name
+ */
+export interface FormatID {
+    /**
+     * URL of the agent that defines this format (e.g., 'https://creatives.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats)
+     */
+    agent_url: string;
+    /**
+     * Format identifier within the agent's namespace (e.g., 'display_300x250', 'video_standard_30s')
+     */
+    id: string;
+}
+/**
+ * Cost Per Mille (cost per 1,000 impressions) with guaranteed fixed rate - common for direct/guaranteed deals
+ */
+export interface CPMFixedRatePricingOption {
+    /**
+     * Unique identifier for this pricing option within the product (e.g., 'cpm_usd_guaranteed')
+     */
+    pricing_option_id: string;
+    /**
+     * Cost per 1,000 impressions
+     */
+    pricing_model: 'cpm';
+    /**
+     * Fixed CPM rate (cost per 1,000 impressions)
+     */
+    rate: number;
+    /**
+     * ISO 4217 currency code
+     */
+    currency: string;
+    /**
+     * Minimum spend requirement per package using this pricing option, in the specified currency
+     */
+    min_spend_per_package?: number;
+}
+/**
+ * Cost Per Mille (cost per 1,000 impressions) with auction-based pricing - common for programmatic/non-guaranteed inventory
+ */
+export interface CPMAuctionPricingOption {
+    /**
+     * Unique identifier for this pricing option within the product (e.g., 'cpm_usd_auction')
+     */
+    pricing_option_id: string;
+    /**
+     * Cost per 1,000 impressions
+     */
+    pricing_model: 'cpm';
+    /**
+     * ISO 4217 currency code
+     */
+    currency: string;
+    /**
+     * Pricing guidance for auction-based CPM bidding
+     */
+    price_guidance: {
+        /**
+         * Minimum bid price - publisher will reject bids under this value
+         */
+        floor: number;
+        /**
+         * 25th percentile winning price
+         */
+        p25?: number;
+        /**
+         * Median winning price
+         */
+        p50?: number;
+        /**
+         * 75th percentile winning price
+         */
+        p75?: number;
+        /**
+         * 90th percentile winning price
+         */
+        p90?: number;
+    };
+    /**
+     * Minimum spend requirement per package using this pricing option, in the specified currency
+     */
+    min_spend_per_package?: number;
+}
+/**
+ * Viewable Cost Per Mille (cost per 1,000 viewable impressions) with guaranteed fixed rate - impressions meeting MRC viewability standard (50% pixels in-view for 1 second for display, 2 seconds for video)
+ */
+export interface VCPMFixedRatePricingOption {
+    /**
+     * Unique identifier for this pricing option within the product (e.g., 'vcpm_usd_guaranteed')
+     */
+    pricing_option_id: string;
+    /**
+     * Cost per 1,000 viewable impressions (MRC standard)
+     */
+    pricing_model: 'vcpm';
+    /**
+     * Fixed vCPM rate (cost per 1,000 viewable impressions)
+     */
+    rate: number;
+    /**
+     * ISO 4217 currency code
+     */
+    currency: string;
+    /**
+     * Minimum spend requirement per package using this pricing option, in the specified currency
+     */
+    min_spend_per_package?: number;
+}
+/**
+ * Viewable Cost Per Mille (cost per 1,000 viewable impressions) with auction-based pricing - impressions meeting MRC viewability standard (50% pixels in-view for 1 second for display, 2 seconds for video)
+ */
+export interface VCPMAuctionPricingOption {
+    /**
+     * Unique identifier for this pricing option within the product (e.g., 'vcpm_usd_auction')
+     */
+    pricing_option_id: string;
+    /**
+     * Cost per 1,000 viewable impressions (MRC standard)
+     */
+    pricing_model: 'vcpm';
+    /**
+     * ISO 4217 currency code
+     */
+    currency: string;
+    /**
+     * Statistical guidance for auction pricing
+     */
+    price_guidance: {
+        /**
+         * Minimum acceptable bid price
+         */
+        floor: number;
+        /**
+         * 25th percentile of recent winning bids
+         */
+        p25?: number;
+        /**
+         * Median of recent winning bids
+         */
+        p50?: number;
+        /**
+         * 75th percentile of recent winning bids
+         */
+        p75?: number;
+        /**
+         * 90th percentile of recent winning bids
+         */
+        p90?: number;
+    };
+    /**
+     * Minimum spend requirement per package using this pricing option, in the specified currency
+     */
+    min_spend_per_package?: number;
+}
+/**
+ * Cost Per Click fixed-rate pricing for performance-driven advertising campaigns
+ */
+export interface CPCPricingOption {
+    /**
+     * Unique identifier for this pricing option within the product (e.g., 'cpc_usd_fixed')
+     */
+    pricing_option_id: string;
+    /**
+     * Cost per click
+     */
+    pricing_model: 'cpc';
+    /**
+     * Fixed CPC rate (cost per click)
+     */
+    rate: number;
+    /**
+     * ISO 4217 currency code
+     */
+    currency: string;
+    /**
+     * Minimum spend requirement per package using this pricing option, in the specified currency
+     */
+    min_spend_per_package?: number;
+}
+/**
+ * Cost Per Completed View (100% video/audio completion) fixed-rate pricing
+ */
+export interface CPCVPricingOption {
+    /**
+     * Unique identifier for this pricing option within the product (e.g., 'cpcv_usd_guaranteed')
+     */
+    pricing_option_id: string;
+    /**
+     * Cost per completed view (100% completion)
+     */
+    pricing_model: 'cpcv';
+    /**
+     * Fixed CPCV rate (cost per 100% completion)
+     */
+    rate: number;
+    /**
+     * ISO 4217 currency code
+     */
+    currency: string;
+    /**
+     * Minimum spend requirement per package using this pricing option, in the specified currency
+     */
+    min_spend_per_package?: number;
+}
+/**
+ * Cost Per View (at publisher-defined threshold) fixed-rate pricing for video/audio
+ */
+export interface CPVPricingOption {
+    /**
+     * Unique identifier for this pricing option within the product (e.g., 'cpv_usd_50pct')
+     */
+    pricing_option_id: string;
+    /**
+     * Cost per view at threshold
+     */
+    pricing_model: 'cpv';
+    /**
+     * Fixed CPV rate (cost per view)
+     */
+    rate: number;
+    /**
+     * ISO 4217 currency code
+     */
+    currency: string;
+    /**
+     * CPV-specific parameters defining the view threshold
+     */
+    parameters: {
+        view_threshold: number | {
+            /**
+             * Seconds of viewing required (e.g., 30 for YouTube-style '30 seconds = view')
+             */
+            duration_seconds: number;
+        };
+    };
+    /**
+     * Minimum spend requirement per package using this pricing option, in the specified currency
+     */
+    min_spend_per_package?: number;
+}
+/**
+ * Cost Per Point (Gross Rating Point) fixed-rate pricing for TV and audio campaigns requiring demographic measurement
+ */
+export interface CPPPricingOption {
+    /**
+     * Unique identifier for this pricing option within the product (e.g., 'cpp_usd_p18-49')
+     */
+    pricing_option_id: string;
+    /**
+     * Cost per Gross Rating Point
+     */
+    pricing_model: 'cpp';
+    /**
+     * Fixed CPP rate (cost per rating point)
+     */
+    rate: number;
+    /**
+     * ISO 4217 currency code
+     */
+    currency: string;
+    /**
+     * CPP-specific parameters for demographic targeting and GRP requirements
+     */
+    parameters: {
+        /**
+         * Target demographic in Nielsen format: P/M/W/A/C + age range. Examples: P18-49 (Persons 18-49), M25-54 (Men 25-54), W35+ (Women 35+), A18-34 (Adults 18-34), C2-11 (Children 2-11)
+         */
+        demographic: string;
+        /**
+         * Minimum GRPs/TRPs required for this pricing option
+         */
+        min_points?: number;
+    };
+    /**
+     * Minimum spend requirement per package using this pricing option, in the specified currency
+     */
+    min_spend_per_package?: number;
+}
+/**
+ * Flat rate pricing for DOOH, sponsorships, and time-based campaigns - fixed cost regardless of delivery volume
+ */
+export interface FlatRatePricingOption {
+    /**
+     * Unique identifier for this pricing option within the product (e.g., 'flat_rate_usd_24h_takeover')
+     */
+    pricing_option_id: string;
+    /**
+     * Fixed cost regardless of delivery volume
+     */
+    pricing_model: 'flat_rate';
+    /**
+     * Flat rate cost
+     */
+    rate: number;
+    /**
+     * ISO 4217 currency code
+     */
+    currency: string;
+    /**
+     * Whether this is a fixed rate (true) or auction-based (false)
+     */
+    is_fixed: true;
+    /**
+     * Flat rate parameters for DOOH and time-based campaigns
+     */
+    parameters?: {
+        /**
+         * Duration in hours for time-based flat rate pricing (DOOH)
+         */
+        duration_hours?: number;
+        /**
+         * Guaranteed share of voice as percentage (DOOH, 0-100)
+         */
+        sov_percentage?: number;
+        /**
+         * Duration of ad loop rotation in seconds (DOOH)
+         */
+        loop_duration_seconds?: number;
+        /**
+         * Minimum number of times ad plays per hour (DOOH frequency guarantee)
+         */
+        min_plays_per_hour?: number;
+        /**
+         * Named venue package identifier for DOOH (e.g., 'times_square_network', 'airport_terminals')
+         */
+        venue_package?: string;
+        /**
+         * Estimated impressions for this flat rate option (informational, commonly used with SOV or time-based DOOH)
+         */
+        estimated_impressions?: number;
+        /**
+         * Specific daypart for time-based pricing (e.g., 'morning_commute', 'evening_prime', 'overnight')
+         */
+        daypart?: string;
+    };
+    /**
+     * Minimum spend requirement per package using this pricing option, in the specified currency
+     */
+    min_spend_per_package?: number;
+}
 /**
  * Measurement capabilities included with a product
  */
@@ -390,6 +955,33 @@ export interface Measurement {
      */
     reporting: string;
 }
+/**
+ * Reporting capabilities available for a product
+ */
+export interface ReportingCapabilities {
+    /**
+     * Supported reporting frequency options
+     *
+     * @minItems 1
+     */
+    available_reporting_frequencies: ['hourly' | 'daily' | 'monthly', ...('hourly' | 'daily' | 'monthly')[]];
+    /**
+     * Expected delay in minutes before reporting data becomes available (e.g., 240 for 4-hour delay)
+     */
+    expected_delay_minutes: number;
+    /**
+     * Timezone for reporting periods. Use 'UTC' or IANA timezone (e.g., 'America/New_York'). Critical for daily/monthly frequency alignment.
+     */
+    timezone: string;
+    /**
+     * Whether this product supports webhook-based reporting notifications
+     */
+    supports_webhooks: boolean;
+    /**
+     * Metrics available in reporting. Impressions and spend are always implicitly included.
+     */
+    available_metrics: ('impressions' | 'spend' | 'clicks' | 'ctr' | 'video_completions' | 'completion_rate' | 'conversions' | 'viewability' | 'engagement_rate')[];
+}
 /**
  * Creative requirements and restrictions for a product
  */
@@ -408,53 +1000,25 @@ export interface CreativePolicy {
     templates_available: boolean;
 }
 /**
- * Audience targeting criteria
+ * Optional geographic refinements for media buys. Most targeting should be expressed in the brief and handled by the publisher. These fields are primarily for geographic restrictions (RCT testing, regulatory compliance).
  */
-export interface Targeting {
+export interface TargetingOverlay {
     /**
-     * Target specific countries (ISO codes)
+     * Restrict delivery to specific countries (ISO codes). Use for regulatory compliance or RCT testing.
      */
     geo_country_any_of?: string[];
     /**
-     * Target specific regions/states
+     * Restrict delivery to specific regions/states. Use for regulatory compliance or RCT testing.
      */
     geo_region_any_of?: string[];
     /**
-     * Target specific metro areas (DMA codes)
+     * Restrict delivery to specific metro areas (DMA codes). Use for regulatory compliance or RCT testing.
      */
     geo_metro_any_of?: string[];
     /**
-     * Target specific postal/ZIP codes
+     * Restrict delivery to specific postal/ZIP codes. Use for regulatory compliance or RCT testing.
      */
     geo_postal_code_any_of?: string[];
-    /**
-     * Audience segment IDs to target
-     */
-    audience_segment_any_of?: string[];
-    /**
-     * AXE segment ID to include for targeting
-     */
-    axe_include_segment?: string;
-    /**
-     * AXE segment ID to exclude from targeting
-     */
-    axe_exclude_segment?: string;
-    /**
-     * Signal IDs from get_signals
-     */
-    signals?: string[];
-    /**
-     * Target specific device types
-     */
-    device_type_any_of?: ('desktop' | 'mobile' | 'tablet' | 'connected_tv' | 'smart_speaker')[];
-    /**
-     * Target specific operating systems
-     */
-    os_any_of?: ('windows' | 'macos' | 'ios' | 'android' | 'linux' | 'roku' | 'tvos' | 'other')[];
-    /**
-     * Target specific browsers
-     */
-    browser_any_of?: ('chrome' | 'firefox' | 'safari' | 'edge' | 'other')[];
     frequency_cap?: FrequencyCap;
 }
 /**