npm - @adcp/sdk - Versions diffs - 9.6.1 → 9.7.0 - Mend

@adcp/sdk 9.6.1 → 9.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1403) hide show

package/dist/lib/schemas-data/3.1/bundled/media-buy/package-request.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.0/bundled/media-buy/package-request.json",
+  "$id": "/schemas/3.1.1/bundled/media-buy/package-request.json",
   "title": "Package Request",
   "description": "Package configuration for media buy creation",
   "type": "object",
@@ -28,7 +28,7 @@
           "maximum": 99
         }
       },
-      "$id": "/schemas/3.1.0/core/version-envelope.json"
+      "$id": "/schemas/3.1.1/core/version-envelope.json"
     }
   ],
   "not": {
@@ -90,7 +90,7 @@
             "width"
           ]
         },
-        "$id": "/schemas/3.1.0/core/format-id.json"
+        "$id": "/schemas/3.1.1/core/format-id.json"
       },
       "minItems": 1
     },
@@ -156,7 +156,7 @@
           }
         ],
         "additionalProperties": true,
-        "$id": "/schemas/3.1.0/core/format-option-ref.json"
+        "$id": "/schemas/3.1.1/core/format-option-ref.json"
       },
       "minItems": 1
     },
@@ -187,7 +187,7 @@
         "asap": "Spend remaining budget as quickly as possible",
         "front_loaded": "Allocate more remaining budget earlier in the remaining campaign period"
       },
-      "$id": "/schemas/3.1.0/enums/pacing.json"
+      "$id": "/schemas/3.1.1/enums/pacing.json"
     },
     "pricing_option_id": {
       "type": "string",
@@ -365,7 +365,7 @@
                   "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
                   "type": "object",
                   "additionalProperties": true,
-                  "$id": "/schemas/3.1.0/core/ext.json"
+                  "$id": "/schemas/3.1.1/core/ext.json"
                 }
               },
               "allOf": [
@@ -454,7 +454,7 @@
                   }
                 }
               ],
-              "$id": "/schemas/3.1.0/core/catalog-field-mapping.json"
+              "$id": "/schemas/3.1.1/core/catalog-field-mapping.json"
             },
             "minItems": 1
           }
@@ -672,7 +672,7 @@
                           "unit"
                         ],
                         "additionalProperties": false,
-                        "$id": "/schemas/3.1.0/core/duration.json"
+                        "$id": "/schemas/3.1.1/core/duration.json"
                       }
                     ],
                     "description": "Time window over which frequency is measured (e.g. {\"interval\": 7, \"unit\": \"days\"} or {\"interval\": 1, \"unit\": \"campaign\"} for the full flight). Weekly windows are typical for brand campaigns; daily windows suit high-cadence direct response."
@@ -950,11 +950,11 @@
                           "time_decay",
                           "data_driven"
                         ],
-                        "$id": "/schemas/3.1.0/enums/attribution-model.json"
+                        "$id": "/schemas/3.1.1/enums/attribution-model.json"
                       }
                     },
                     "additionalProperties": true,
-                    "$id": "/schemas/3.1.0/core/attribution-window.json"
+                    "$id": "/schemas/3.1.1/core/attribution-window.json"
                   }
                 ],
                 "description": "Attribution window for this optimization goal — references the canonical `attribution-window` shape (post_click, post_view, model). Values must match an option declared in the seller's `conversion_tracking.attribution_windows` capability. Sellers MUST reject windows not in their declared capabilities. When the entire field is omitted, the seller uses their default window."
@@ -1002,7 +1002,7 @@
                       "nike",
                       "pampers"
                     ],
-                    "$id": "/schemas/3.1.0/core/brand-id.json"
+                    "$id": "/schemas/3.1.1/core/brand-id.json"
                   },
                   "industries": {
                     "type": "array",
@@ -1493,7 +1493,7 @@
                   "co_view_index",
                   "incremental_lift_percent"
                 ],
-                "$id": "/schemas/3.1.0/core/vendor-metric-id.json"
+                "$id": "/schemas/3.1.1/core/vendor-metric-id.json"
               },
               "target": {
                 "description": "Target for this vendor metric. When omitted, the seller optimizes for maximum metric volume / score within budget. `cost_per` and `threshold_rate` semantics mirror the same target kinds on the `metric` kind — units are vendor-defined and depend on the vendor's `measurement.metrics[]` declaration for this `metric_id`.",
@@ -2107,7 +2107,7 @@
                     "saturday",
                     "sunday"
                   ],
-                  "$id": "/schemas/3.1.0/enums/day-of-week.json"
+                  "$id": "/schemas/3.1.1/enums/day-of-week.json"
                 },
                 "minItems": 1
               },
@@ -2134,7 +2134,7 @@
               "end_hour"
             ],
             "additionalProperties": false,
-            "$id": "/schemas/3.1.0/core/daypart-target.json"
+            "$id": "/schemas/3.1.1/core/daypart-target.json"
           },
           "minItems": 1
         },
@@ -2372,7 +2372,7 @@
                                       "additionalProperties": true
                                     }
                                   ],
-                                  "$id": "/schemas/3.1.0/core/signal-ref.json"
+                                  "$id": "/schemas/3.1.1/core/signal-ref.json"
                                 },
                                 "value_type": {
                                   "type": "string",
@@ -2778,7 +2778,7 @@
                               "additionalProperties": true
                             }
                           ],
-                          "$id": "/schemas/3.1.0/core/signal-targeting-expression.json"
+                          "$id": "/schemas/3.1.1/core/signal-targeting-expression.json"
                         }
                       ],
                       "properties": {
@@ -2842,11 +2842,11 @@
                               "additionalProperties": true
                             }
                           ],
-                          "$id": "/schemas/3.1.0/core/activation-key.json"
+                          "$id": "/schemas/3.1.1/core/activation-key.json"
                         }
                       },
                       "additionalProperties": true,
-                      "$id": "/schemas/3.1.0/core/package-signal-targeting.json"
+                      "$id": "/schemas/3.1.1/core/package-signal-targeting.json"
                     },
                     "minItems": 1
                   }
@@ -2856,7 +2856,7 @@
                   "signals"
                 ],
                 "additionalProperties": true,
-                "$id": "/schemas/3.1.0/core/package-signal-targeting-group.json"
+                "$id": "/schemas/3.1.1/core/package-signal-targeting-group.json"
               },
               "minItems": 1
             }
@@ -2866,7 +2866,7 @@
             "groups"
           ],
           "additionalProperties": true,
-          "$id": "/schemas/3.1.0/core/package-signal-targeting-groups.json"
+          "$id": "/schemas/3.1.1/core/package-signal-targeting-groups.json"
         },
         "signal_targeting": {
           "type": "array",
@@ -3109,7 +3109,7 @@
                         "additionalProperties": true
                       }
                     ],
-                    "$id": "/schemas/3.1.0/core/signal-id.json"
+                    "$id": "/schemas/3.1.1/core/signal-id.json"
                   },
                   "value_type": {
                     "type": "string",
@@ -3665,7 +3665,7 @@
                 "additionalProperties": true
               }
             ],
-            "$id": "/schemas/3.1.0/core/signal-targeting.json"
+            "$id": "/schemas/3.1.1/core/signal-targeting.json"
           },
           "minItems": 1
         },
@@ -3816,7 +3816,7 @@
             "list_id"
           ],
           "additionalProperties": false,
-          "$id": "/schemas/3.1.0/core/property-list-ref.json"
+          "$id": "/schemas/3.1.1/core/property-list-ref.json"
         },
         "collection_list": {
           "title": "Collection List Reference",
@@ -3844,7 +3844,7 @@
             "list_id"
           ],
           "additionalProperties": false,
-          "$id": "/schemas/3.1.0/core/collection-list-ref.json"
+          "$id": "/schemas/3.1.1/core/collection-list-ref.json"
         },
         "collection_list_exclude": {
           "title": "Collection List Reference",
@@ -3902,7 +3902,7 @@
                   "credit_card",
                   "world_id"
                 ],
-                "$id": "/schemas/3.1.0/enums/age-verification-method.json"
+                "$id": "/schemas/3.1.1/enums/age-verification-method.json"
               },
               "minItems": 1
             }
@@ -3933,7 +3933,7 @@
               "roku_os",
               "unknown"
             ],
-            "$id": "/schemas/3.1.0/enums/device-platform.json"
+            "$id": "/schemas/3.1.1/enums/device-platform.json"
           },
           "minItems": 1
         },
@@ -4030,7 +4030,7 @@
                       "min": "Minutes",
                       "hr": "Hours"
                     },
-                    "$id": "/schemas/3.1.0/enums/travel-time-unit.json"
+                    "$id": "/schemas/3.1.1/enums/travel-time-unit.json"
                   }
                 },
                 "required": [
@@ -4055,7 +4055,7 @@
                   "driving": "Motor vehicle travel on road networks",
                   "public_transport": "Public transit including bus, rail, metro, and ferry"
                 },
-                "$id": "/schemas/3.1.0/enums/transport-mode.json"
+                "$id": "/schemas/3.1.1/enums/transport-mode.json"
               },
               "radius": {
                 "type": "object",
@@ -4080,7 +4080,7 @@
                       "mi": "Miles",
                       "m": "Meters"
                     },
-                    "$id": "/schemas/3.1.0/enums/distance-unit.json"
+                    "$id": "/schemas/3.1.1/enums/distance-unit.json"
                   }
                 },
                 "required": [
@@ -4809,7 +4809,7 @@
                   "credit": "Seller issues a credit toward future media buys on the same account.",
                   "invoice_adjustment": "Seller reduces the invoice for the current media buy to reflect actual delivered value."
                 },
-                "$id": "/schemas/3.1.0/enums/makegood-remedy.json"
+                "$id": "/schemas/3.1.1/enums/makegood-remedy.json"
               },
               "minItems": 1,
               "uniqueItems": true
@@ -4849,7 +4849,7 @@
               "brand_safety": "Brand-safe impression rate (floor — must exceed threshold). Denominator: total_impressions.",
               "attention_score": "Attention score rate (floor — must exceed threshold). Denominator: measurable_impressions."
             },
-            "$id": "/schemas/3.1.0/enums/performance-standard-metric.json"
+            "$id": "/schemas/3.1.1/enums/performance-standard-metric.json"
           },
           "threshold": {
             "type": "number",
@@ -5426,7 +5426,7 @@
                   "conversion_lift",
                   "brand_search_lift"
                 ],
-                "$id": "/schemas/3.1.0/enums/available-metric.json"
+                "$id": "/schemas/3.1.1/enums/available-metric.json"
               },
               "qualifier": {
                 "type": "object",
@@ -5447,7 +5447,7 @@
                       "seller_attested": "The party serving the ad witnessed and counted the completion event. Includes ad-server / player completion beacons, walled-garden first-party measurement, and IAB-certified first-party podcast measurement on the platform's own inventory. Source of truth is the seller's delivery infrastructure.",
                       "vendor_attested": "An independent third-party measurement vendor (Nielsen, DV, IAS, Moat, HUMAN, Podtrac on third-party inventory, Edison Research panel, etc.) attested to the completion via SDK callbacks, server-beacon validation, or panel methodology. Source of truth is the vendor; vendor identity SHOULD be anchored on a matching `performance_standard.vendor` BrandRef in the buy contract — if a buyer wants vendor-attested completion for transparency without an accountability gate, they MAY commit a vendor metric via `vendor_metrics` on the product rather than `committed_metrics` with this qualifier."
                     },
-                    "$id": "/schemas/3.1.0/enums/completion-source.json"
+                    "$id": "/schemas/3.1.1/enums/completion-source.json"
                   },
                   "attribution_methodology": {
                     "title": "Attribution Methodology",
@@ -5465,7 +5465,7 @@
                       "panel_based": "Panel methodology — outcomes measured against a recruited respondent panel and projected to the population. Standard for Nielsen, comScore, Edison Research, and similar panel providers.",
                       "modeled": "Modeled output — Media Mix Modeling (MMM), Multi-Touch Attribution (MTA), incrementality testing, or other statistical inference that produces an estimated outcome rather than a directly-observed match. Includes most clean-room outputs."
                     },
-                    "$id": "/schemas/3.1.0/enums/attribution-methodology.json"
+                    "$id": "/schemas/3.1.1/enums/attribution-methodology.json"
                   },
                   "attribution_window": {
                     "title": "Duration",
@@ -5513,7 +5513,7 @@
                       "purchase_intent": "Lift in stated purchase intent — 'are you likely to buy [brand] in the next [N] days'.",
                       "ad_recall": "Lift in unaided or aided ad recall — 'do you remember seeing an ad for [brand]'."
                     },
-                    "$id": "/schemas/3.1.0/enums/lift-dimension.json"
+                    "$id": "/schemas/3.1.1/enums/lift-dimension.json"
                   }
                 },
                 "additionalProperties": false
@@ -6100,7 +6100,7 @@
                 "placement_id"
               ],
               "additionalProperties": true,
-              "$id": "/schemas/3.1.0/core/placement-ref.json"
+              "$id": "/schemas/3.1.1/core/placement-ref.json"
             },
             "minItems": 1
           },
@@ -6117,7 +6117,7 @@
           "creative_id"
         ],
         "additionalProperties": true,
-        "$id": "/schemas/3.1.0/core/creative-assignment.json"
+        "$id": "/schemas/3.1.1/core/creative-assignment.json"
       },
       "minItems": 1
     },
@@ -6640,7 +6640,8 @@
                       },
                       {
                         "title": "Video Asset",
-                        "description": "Video asset with URL and technical specifications including audio track properties",
+                        "description": "A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.",
+                        "$comment": "Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.",
                         "type": "object",
                         "properties": {
                           "asset_type": {
@@ -6656,12 +6657,12 @@
                           "width": {
                             "type": "integer",
                             "minimum": 1,
-                            "description": "Width in pixels"
+                            "description": "Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"
                           },
                           "height": {
                             "type": "integer",
                             "minimum": 1,
-                            "description": "Height in pixels"
+                            "description": "Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"
                           },
                           "duration_ms": {
                             "type": "integer",
@@ -7561,7 +7562,7 @@
                       },
                       {
                         "title": "VAST Asset",
-                        "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving",
+                        "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving. Unlike the hosted `video` asset, a VAST tag carries no `width`/`height`: a VAST response can return multiple renditions of differing dimensions, and the player selects one per device at serve time, so there is no single width/height for the ad. Dimensional, duration, and codec *constraints* for a placement live on the format/requirements layer, not on this asset.",
                         "type": "object",
                         "properties": {
                           "asset_type": {
@@ -11257,7 +11258,7 @@
                                     "role"
                                   ],
                                   "additionalProperties": true,
-                                  "$id": "/schemas/3.1.0/core/reference-asset.json"
+                                  "$id": "/schemas/3.1.1/core/reference-asset.json"
                                 }
                               },
                               "compliance": {
@@ -12548,7 +12549,8 @@
                               },
                               {
                                 "title": "Video Asset",
-                                "description": "Video asset with URL and technical specifications including audio track properties",
+                                "description": "A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.",
+                                "$comment": "Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.",
                                 "type": "object",
                                 "properties": {
                                   "asset_type": {
@@ -12564,12 +12566,12 @@
                                   "width": {
                                     "type": "integer",
                                     "minimum": 1,
-                                    "description": "Width in pixels"
+                                    "description": "Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"
                                   },
                                   "height": {
                                     "type": "integer",
                                     "minimum": 1,
-                                    "description": "Height in pixels"
+                                    "description": "Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"
                                   },
                                   "duration_ms": {
                                     "type": "integer",
@@ -13470,7 +13472,7 @@
                                   "digest": "sha256:a3f5b7c9d8e2f1a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2"
                                 }
                               ],
-                              "$id": "/schemas/3.1.0/core/platform-extension-ref.json"
+                              "$id": "/schemas/3.1.1/core/platform-extension-ref.json"
                             }
                           },
                           "provenance": {
@@ -15491,7 +15493,8 @@
                         },
                         {
                           "title": "Video Asset",
-                          "description": "Video asset with URL and technical specifications including audio track properties",
+                          "description": "A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.",
+                          "$comment": "Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.",
                           "type": "object",
                           "properties": {
                             "asset_type": {
@@ -15507,12 +15510,12 @@
                             "width": {
                               "type": "integer",
                               "minimum": 1,
-                              "description": "Width in pixels"
+                              "description": "Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"
                             },
                             "height": {
                               "type": "integer",
                               "minimum": 1,
-                              "description": "Height in pixels"
+                              "description": "Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"
                             },
                             "duration_ms": {
                               "type": "integer",
@@ -16412,7 +16415,7 @@
                         },
                         {
                           "title": "VAST Asset",
-                          "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving",
+                          "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving. Unlike the hosted `video` asset, a VAST tag carries no `width`/`height`: a VAST response can return multiple renditions of differing dimensions, and the player selects one per device at serve time, so there is no single width/height for the ad. Dimensional, duration, and codec *constraints* for a placement live on the format/requirements layer, not on this asset.",
                           "type": "object",
                           "properties": {
                             "asset_type": {
@@ -21398,7 +21401,8 @@
                                 },
                                 {
                                   "title": "Video Asset",
-                                  "description": "Video asset with URL and technical specifications including audio track properties",
+                                  "description": "A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.",
+                                  "$comment": "Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.",
                                   "type": "object",
                                   "properties": {
                                     "asset_type": {
@@ -21414,12 +21418,12 @@
                                     "width": {
                                       "type": "integer",
                                       "minimum": 1,
-                                      "description": "Width in pixels"
+                                      "description": "Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"
                                     },
                                     "height": {
                                       "type": "integer",
                                       "minimum": 1,
-                                      "description": "Height in pixels"
+                                      "description": "Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"
                                     },
                                     "duration_ms": {
                                       "type": "integer",
@@ -24013,7 +24017,7 @@
               "rejected": "Creative was rejected due to content policy, technical issues, or terminal dependency/authorization loss. Reached from 'pending_review' (initial review failure), from 'approved' (post-approval revocation by the seller — policy change, takedown request, content drift), or from 'suspended' when a previously recoverable dependency is determined unrecoverable for this creative. Not terminal — the buyer may fix the issue and resubmit via sync_creatives, which returns the creative to processing.",
               "archived": "Creative has been archived and is excluded from default queries. Archive MAY be buyer-initiated (explicit cleanup) or seller-initiated (inactivity, post-flight expiry, storage policy, account suspension) — seller-initiated archive is only valid when no active package assignments reference the creative. Archived creatives retain their data and may be unarchived back to approved by the buyer. Buyer-initiated archive is acknowledged on the `sync_creatives` response path. Seller-initiated archive (`approved → archived`) fires `creative.status_changed` against the account's `notification_configs[]` subscribers (see `notification-type.json` and `sync_accounts`); buyers MUST observe the new status on the next `list_creatives` read regardless of whether the webhook was delivered. Destruction is a distinct event (`creative.purged`); purged creatives do not appear in default `list_creatives` results and MAY surface as tombstones when `include_purged: true` is supplied — see `list_creatives` for the tombstone shape."
             },
-            "$id": "/schemas/3.1.0/enums/creative-status.json"
+            "$id": "/schemas/3.1.1/enums/creative-status.json"
           },
           "weight": {
             "type": "number",
@@ -24085,7 +24089,7 @@
                     "clearcast_clock",
                     "idcrea"
                   ],
-                  "$id": "/schemas/3.1.0/enums/creative-identifier-type.json"
+                  "$id": "/schemas/3.1.1/enums/creative-identifier-type.json"
                 },
                 "value": {
                   "type": "string",
@@ -24098,7 +24102,7 @@
                 "value"
               ],
               "additionalProperties": true,
-              "$id": "/schemas/3.1.0/core/industry-identifier.json"
+              "$id": "/schemas/3.1.1/core/industry-identifier.json"
             },
             "uniqueItems": true
           },
@@ -24500,7 +24504,7 @@
       "description": "Opaque package-level correlation data echoed unchanged in the package response, webhooks, and read surfaces. Buyers targeting mixed seller populations SHOULD include a per-package correlation value here, commonly context.buyer_ref, so responses from legacy sellers that do not echo product_id can still be mapped back to the requested product or line item. Do not use deprecated top-level buyer_ref for v3 correlation.",
       "type": "object",
       "additionalProperties": true,
-      "$id": "/schemas/3.1.0/core/context.json"
+      "$id": "/schemas/3.1.1/core/context.json"
     },
     "ext": {
       "title": "Extension Object",
@@ -24540,7 +24544,7 @@
         "agent_placement",
         "custom"
       ],
-      "$id": "/schemas/3.1.0/core/canonical-format-kind.json"
+      "$id": "/schemas/3.1.1/core/canonical-format-kind.json"
     },
     "CatalogType": {
       "title": "Catalog Type",
@@ -24561,7 +24565,7 @@
         "destination",
         "app"
       ],
-      "$id": "/schemas/3.1.0/enums/catalog-type.json"
+      "$id": "/schemas/3.1.1/enums/catalog-type.json"
     },
     "FeedFormat": {
       "title": "Feed Format",
@@ -24587,7 +24591,7 @@
         "openai_product_feed": "OpenAI Commerce product feed for ChatGPT shopping — a GMC-derived dialect adding ChatGPT-specific eligibility flags (is_eligible_search / is_eligible_checkout / is_eligible_ads). Spec: https://developers.openai.com/commerce/specs/file-upload/products",
         "custom": "A feed whose shape is not one of the named formats above. The buyer MUST supply feed_field_mappings to normalize it to the AdCP catalog item schema."
       },
-      "$id": "/schemas/3.1.0/enums/feed-format.json"
+      "$id": "/schemas/3.1.1/enums/feed-format.json"
     },
     "UpdateFrequency": {
       "title": "Update Frequency",
@@ -24599,7 +24603,7 @@
         "daily",
         "weekly"
       ],
-      "$id": "/schemas/3.1.0/enums/update-frequency.json"
+      "$id": "/schemas/3.1.1/enums/update-frequency.json"
     },
     "EventType": {
       "title": "Event Type",
@@ -24671,7 +24675,7 @@
         "submit_application": "User submitted an application (loan, job, etc.)",
         "custom": "Custom event type (specify in custom_event_name)"
       },
-      "$id": "/schemas/3.1.0/enums/event-type.json"
+      "$id": "/schemas/3.1.1/enums/event-type.json"
     },
     "ContentIDType": {
       "title": "Content ID Type",
@@ -24691,7 +24695,7 @@
         "destination_id",
         "app_id"
       ],
-      "$id": "/schemas/3.1.0/enums/content-id-type.json"
+      "$id": "/schemas/3.1.1/enums/content-id-type.json"
     },
     "ReachUnit": {
       "title": "Reach Unit",
@@ -24713,7 +24717,7 @@
         "cookies": "Unique browser cookies.",
         "custom": "Publisher-defined reach unit. Describe in ext."
       },
-      "$id": "/schemas/3.1.0/enums/reach-unit.json"
+      "$id": "/schemas/3.1.1/enums/reach-unit.json"
     },
     "DigitalSourceType": {
       "title": "Digital Source Type",
@@ -24741,7 +24745,7 @@
         "human_edits": "Content augmented, corrected, or enhanced by humans using non-generative tools",
         "data_driven_media": "Assembled from structured data feeds (DCO templates, product catalogs, weather-triggered variants)"
       },
-      "$id": "/schemas/3.1.0/enums/digital-source-type.json"
+      "$id": "/schemas/3.1.1/enums/digital-source-type.json"
     },
     "EmbeddedProvenanceMethod": {
       "title": "Embedded Provenance Method",
@@ -24755,7 +24759,7 @@
         "manifest_wrapper": "A provenance manifest embedded in the file container per format-specific rules (e.g., JUMBF box in JPEG, C2PATextManifestWrapper in plaintext per C2PA Section A.7). The manifest travels with the file but is tied to the file's byte structure.",
         "provenance_markers": "Invisible markers embedded within the content stream that encode or reference a provenance record. Designed to survive reformatting, copy-paste, CMS ingestion, and ad-server transcoding that breaks file-level bindings."
       },
-      "$id": "/schemas/3.1.0/enums/embedded-provenance-method.json"
+      "$id": "/schemas/3.1.1/enums/embedded-provenance-method.json"
     },
     "WatermarkMediaType": {
       "title": "Watermark Media Type",
@@ -24773,7 +24777,7 @@
         "video": "Watermark applied to video content (e.g., per-frame image watermarking, temporal watermarking)",
         "text": "Watermark applied to text content (e.g., synonym substitution, structural modification)"
       },
-      "$id": "/schemas/3.1.0/enums/watermark-media-type.json"
+      "$id": "/schemas/3.1.1/enums/watermark-media-type.json"
     },
     "C2PAWatermarkAction": {
       "title": "C2PA Watermark Action",
@@ -24787,7 +24791,7 @@
         "c2pa.watermarked.bound": "Watermark linked to a C2PA manifest for this asset. The watermark and manifest are mutually reinforcing: the manifest references the watermark, and the watermark can be used to locate the manifest.",
         "c2pa.watermarked.unbound": "Watermark independent of any C2PA manifest. Applied before any provenance signing event (e.g., by the AI generator at creation time) or in pipelines where no manifest is present."
       },
-      "$id": "/schemas/3.1.0/enums/c2pa-watermark-action.json"
+      "$id": "/schemas/3.1.1/enums/c2pa-watermark-action.json"
     },
     "DisclosurePersistence": {
       "title": "Disclosure Persistence",
@@ -24803,7 +24807,7 @@
         "initial": "Disclosure must appear at the start of content for a minimum duration before it may be removed. Pair with min_duration_ms in render_guidance or creative brief to specify the required duration.",
         "flexible": "Disclosure presence is sufficient; placement timing and duration are at the publisher's discretion"
       },
-      "$id": "/schemas/3.1.0/enums/disclosure-persistence.json"
+      "$id": "/schemas/3.1.1/enums/disclosure-persistence.json"
     },
     "DisclosurePosition": {
       "title": "Disclosure Position",
@@ -24819,7 +24823,7 @@
         "pre_roll",
         "companion"
       ],
-      "$id": "/schemas/3.1.0/enums/disclosure-position.json"
+      "$id": "/schemas/3.1.1/enums/disclosure-position.json"
     },
     "MetroAreaSystem": {
       "title": "Metro Area System",
@@ -24832,7 +24836,7 @@
         "eurostat_nuts2",
         "custom"
       ],
-      "$id": "/schemas/3.1.0/enums/metro-system.json"
+      "$id": "/schemas/3.1.1/enums/metro-system.json"
     },
     "PostalCodeSystem": {
       "title": "Postal Code System",
@@ -24863,7 +24867,7 @@
         "ch_plz",
         "at_plz"
       ],
-      "$id": "/schemas/3.1.0/enums/postal-system.json"
+      "$id": "/schemas/3.1.1/enums/postal-system.json"
     },
     "LegacyPostalCodeSystem": {
       "title": "Legacy Postal Code System",
@@ -24883,7 +24887,7 @@
         "ch_plz",
         "at_plz"
       ],
-      "$id": "/schemas/3.1.0/enums/legacy-postal-system.json"
+      "$id": "/schemas/3.1.1/enums/legacy-postal-system.json"
     },
     "DeviceType": {
       "title": "Device Type",
@@ -24897,7 +24901,7 @@
         "dooh",
         "unknown"
       ],
-      "$id": "/schemas/3.1.0/enums/device-type.json"
+      "$id": "/schemas/3.1.1/enums/device-type.json"
     },
     "MatchType": {
       "title": "Match Type",
@@ -24913,7 +24917,7 @@
         "phrase": "Ads serve when the query contains the keyword phrase in order",
         "exact": "Ads serve only when the query matches the keyword exactly"
       },
-      "$id": "/schemas/3.1.0/enums/match-type.json"
+      "$id": "/schemas/3.1.1/enums/match-type.json"
     },
     "ViewabilityStandard": {
       "title": "Viewability Standard",
@@ -24927,7 +24931,7 @@
         "mrc": "MRC/IAB standard: 50% of pixels in view for 1 continuous second (display) or 2 continuous seconds (video).",
         "groupm": "GroupM standard: 100% of pixels in view for 1 continuous second (display) or 50% of video duration."
       },
-      "$id": "/schemas/3.1.0/enums/viewability-standard.json"
+      "$id": "/schemas/3.1.1/enums/viewability-standard.json"
     },
     "FrameRateType": {
       "title": "Frame Rate Type",
@@ -24941,7 +24945,7 @@
         "constant": "Constant frame rate (CFR) — each frame occupies an identical time interval",
         "variable": "Variable frame rate (VFR) — frame intervals may differ"
       },
-      "$id": "/schemas/3.1.0/enums/frame-rate-type.json"
+      "$id": "/schemas/3.1.1/enums/frame-rate-type.json"
     },
     "ScanType": {
       "title": "Scan Type",
@@ -24955,7 +24959,7 @@
         "progressive": "All lines of each frame are drawn in sequence",
         "interlaced": "Alternating lines drawn in two passes per frame (legacy broadcast)"
       },
-      "$id": "/schemas/3.1.0/enums/scan-type.json"
+      "$id": "/schemas/3.1.1/enums/scan-type.json"
     },
     "GOPType": {
       "title": "GOP Type",
@@ -24969,7 +24973,7 @@
         "closed": "Each GOP is independently decodable — required for SSAI and broadcast splicing",
         "open": "GOPs may reference frames from adjacent GOPs — not suitable for splicing"
       },
-      "$id": "/schemas/3.1.0/enums/gop-type.json"
+      "$id": "/schemas/3.1.1/enums/gop-type.json"
     },
     "MoovAtomPosition": {
       "title": "Moov Atom Position",
@@ -24983,7 +24987,7 @@
         "start": "moov atom at beginning of file — enables progressive download and streaming delivery",
         "end": "moov atom at end of file — requires full download before playback can begin"
       },
-      "$id": "/schemas/3.1.0/enums/moov-atom-position.json"
+      "$id": "/schemas/3.1.1/enums/moov-atom-position.json"
     },
     "AudioChannelLayout": {
       "title": "Audio Channel Layout",
@@ -24995,7 +24999,7 @@
         "5.1",
         "7.1"
       ],
-      "$id": "/schemas/3.1.0/enums/audio-channel-layout.json"
+      "$id": "/schemas/3.1.1/enums/audio-channel-layout.json"
     },
     "VASTVersion": {
       "title": "VAST Version",
@@ -25008,7 +25012,7 @@
         "4.1",
         "4.2"
       ],
-      "$id": "/schemas/3.1.0/enums/vast-version.json"
+      "$id": "/schemas/3.1.1/enums/vast-version.json"
     },
     "VASTTrackingEvent": {
       "title": "VAST Tracking Event",
@@ -25052,7 +25056,7 @@
         "measurableImpression",
         "viewableImpression"
       ],
-      "$id": "/schemas/3.1.0/enums/vast-tracking-event.json"
+      "$id": "/schemas/3.1.1/enums/vast-tracking-event.json"
     },
     "URLAssetType": {
       "title": "URL Asset Type",
@@ -25063,7 +25067,7 @@
         "tracker_pixel",
         "tracker_script"
       ],
-      "$id": "/schemas/3.1.0/enums/url-asset-type.json"
+      "$id": "/schemas/3.1.1/enums/url-asset-type.json"
     },
     "JavaScriptModuleType": {
       "title": "JavaScript Module Type",
@@ -25074,7 +25078,7 @@
         "commonjs",
         "script"
       ],
-      "$id": "/schemas/3.1.0/enums/javascript-module-type.json"
+      "$id": "/schemas/3.1.1/enums/javascript-module-type.json"
     },
     "HTTPMethod": {
       "title": "HTTP Method",
@@ -25084,7 +25088,7 @@
         "GET",
         "POST"
       ],
-      "$id": "/schemas/3.1.0/enums/http-method.json",
+      "$id": "/schemas/3.1.1/enums/http-method.json",
       "default": "POST"
     },
     "UniversalMacro": {
@@ -25245,7 +25249,7 @@
         "ITEM_PRICE": "Price amount of the catalog item being rendered (catalog_field: price.amount). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules.",
         "ITEM_PRICE_CURRENCY": "ISO 4217 currency code of the catalog item being rendered (catalog_field: price.currency). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules."
       },
-      "$id": "/schemas/3.1.0/enums/universal-macro.json"
+      "$id": "/schemas/3.1.1/enums/universal-macro.json"
     },
     "WebhookResponseType": {
       "title": "Webhook Response Type",
@@ -25257,7 +25261,7 @@
         "xml",
         "javascript"
       ],
-      "$id": "/schemas/3.1.0/enums/webhook-response-type.json"
+      "$id": "/schemas/3.1.1/enums/webhook-response-type.json"
     },
     "WebhookSecurityMethod": {
       "title": "Webhook Security Method",
@@ -25268,7 +25272,7 @@
         "api_key",
         "none"
       ],
-      "$id": "/schemas/3.1.0/enums/webhook-security-method.json"
+      "$id": "/schemas/3.1.1/enums/webhook-security-method.json"
     },
     "DAASTVersion": {
       "title": "DAAST Version",
@@ -25278,7 +25282,7 @@
         "1.0",
         "1.1"
       ],
-      "$id": "/schemas/3.1.0/enums/daast-version.json"
+      "$id": "/schemas/3.1.1/enums/daast-version.json"
     },
     "DAASTTrackingEvent": {
       "title": "DAAST Tracking Event",
@@ -25309,7 +25313,7 @@
         "measurableImpression",
         "viewableImpression"
       ],
-      "$id": "/schemas/3.1.0/enums/daast-tracking-event.json"
+      "$id": "/schemas/3.1.1/enums/daast-tracking-event.json"
     },
     "MarkdownFlavor": {
       "title": "Markdown Flavor",
@@ -25319,12 +25323,12 @@
         "commonmark",
         "gfm"
       ],
-      "$id": "/schemas/3.1.0/enums/markdown-flavor.json",
+      "$id": "/schemas/3.1.1/enums/markdown-flavor.json",
       "default": "commonmark"
     }
   },
   "_bundled": {
-    "generatedAt": "2026-06-18T08:17:00.944Z",
+    "generatedAt": "2026-06-30T19:14:40.292Z",
     "note": "This is a bundled schema with all $ref resolved inline. For the modular version with references, use the parent directory."
   }
 }