@adcp/sdk 16.0.0-beta.7 → 16.0.0-beta.9

package/dist/lib/index.js

@@ -221,9 +221,6 @@ __export(index_exports, {
   WebhookDispatchError: () => import_SingleAgentClient.WebhookDispatchError,
   WholesaleFeedWebhookNotificationError: () => import_webhook_notification.WholesaleFeedWebhookNotificationError,
   activationKey: () => import_activation_key_builders.activationKey,
-  adaptCreateMediaBuyRequestForV2: () => import_creative_adapter.adaptCreateMediaBuyRequestForV2,
-  adaptPackageRequestForV2: () => import_creative_adapter.adaptPackageRequestForV2,
-  adaptUpdateMediaBuyRequestForV2: () => import_creative_adapter.adaptUpdateMediaBuyRequestForV2,
   adcpError: () => import_server.adcpError,
   adcpErrorToTypedError: () => import_errors.adcpErrorToTypedError,
   addSpanAttributes: () => import_observability.addSpanAttributes,
@@ -261,7 +258,6 @@ __export(index_exports, {
   buildGovernanceProposedCommitment: () => import_governance.buildGovernanceProposedCommitment,
   buildHumanOverride: () => import_governance.buildHumanOverride,
   buildHumanReviewPlan: () => import_governance.buildHumanReviewPlan,
-  buildSyntheticCapabilities: () => import_capabilities.buildSyntheticCapabilities,
   buildSyntheticV3Capabilities: () => import_capabilities.buildSyntheticV3Capabilities,
   bundleSupportsAdcpVersionField: () => import_protocols.bundleSupportsAdcpVersionField,
   callA2ATool: () => import_protocols.callA2ATool,
@@ -698,9 +694,6 @@ __export(index_exports, {
   urlRender: () => import_render_builders.urlRender,
   useIdempotencyKey: () => import_idempotency.useIdempotencyKey,
   usesDeprecatedAssetsField: () => import_format_assets.usesDeprecatedAssetsField,
-  usesV2CreativeIds: () => import_creative_adapter.usesV2CreativeIds,
-  usesV2Dimensions: () => import_format_renders.usesV2Dimensions,
-  usesV2RenderFields: () => import_preview_normalizer.usesV2RenderFields,
   usesV3CreativeAssignments: () => import_creative_adapter.usesV3CreativeAssignments,
   usesV3RenderFields: () => import_preview_normalizer.usesV3RenderFields,
   usesV3Renders: () => import_format_renders.usesV3Renders,
@@ -735,6 +728,7 @@ __export(index_exports, {
   withSpan: () => import_observability.withSpan
 });
 module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, require('./identifiers.js'), module.exports);
 var import_registry = require('./registry/index.js');
 var import_registry2 = require('./registry/index.js');
 var import_brand = require('./brand/index.js');
@@ -1071,9 +1065,6 @@ function createAdCPClientFromEnv() {
   WebhookDispatchError,
   WholesaleFeedWebhookNotificationError,
   activationKey,
-  adaptCreateMediaBuyRequestForV2,
-  adaptPackageRequestForV2,
-  adaptUpdateMediaBuyRequestForV2,
   adcpError,
   adcpErrorToTypedError,
   addSpanAttributes,
@@ -1111,7 +1102,6 @@ function createAdCPClientFromEnv() {
   buildGovernanceProposedCommitment,
   buildHumanOverride,
   buildHumanReviewPlan,
-  buildSyntheticCapabilities,
   buildSyntheticV3Capabilities,
   bundleSupportsAdcpVersionField,
   callA2ATool,
@@ -1548,9 +1538,6 @@ function createAdCPClientFromEnv() {
   urlRender,
   useIdempotencyKey,
   usesDeprecatedAssetsField,
-  usesV2CreativeIds,
-  usesV2Dimensions,
-  usesV2RenderFields,
   usesV3CreativeAssignments,
   usesV3RenderFields,
   usesV3Renders,
@@ -1583,6 +1570,7 @@ function createAdCPClientFromEnv() {
   withAdditiveCanonicalFormatOptions,
   withMCPConnectionScope,
   withSpan,
+  ...require('./identifiers.js'),
   ...require('./principal/index.js'),
   ...require('./handlers/types.js'),
   ...require('./negotiation/index.js'),

package/dist/lib/index.mjs

@@ -1,3 +1,4 @@
+export * from "./identifiers.mjs";
 import {
   RegistryClient,
   RegistryRequestError,
@@ -617,7 +618,6 @@ import {
   windowUpdateMediaBuyDeliveryNotification
 } from "./utils/media-buy-delivery-notification-builders.mjs";
 import {
-  buildSyntheticCapabilities,
   buildSyntheticV3Capabilities,
   parseCapabilitiesResponse,
   supportsV3,
@@ -644,12 +644,8 @@ import {
 } from "./utils/capabilities.mjs";
 import { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from "./utils/creative-delivery.mjs";
 import {
-  adaptPackageRequestForV2,
-  adaptCreateMediaBuyRequestForV2,
-  adaptUpdateMediaBuyRequestForV2,
   normalizePackageResponse,
   normalizeMediaBuyResponse,
-  usesV2CreativeIds,
   usesV3CreativeAssignments,
   getCreativeIds,
   getCreativeAssignments
@@ -661,7 +657,6 @@ import {
   getPrimaryRender,
   getCompanionRenders,
   isMultiRenderFormat,
-  usesV2Dimensions,
   usesV3Renders,
   getFormatDimensions
 } from "./utils/format-renders.mjs";
@@ -669,7 +664,6 @@ import {
   normalizePreviewRender,
   normalizePreview,
   normalizePreviewCreativeResponse,
-  usesV2RenderFields,
   usesV3RenderFields,
   getRenderId,
   getRenderRole,
@@ -1033,9 +1027,6 @@ export {
   WebhookDispatchError,
   WholesaleFeedWebhookNotificationError,
   activationKey,
-  adaptCreateMediaBuyRequestForV2,
-  adaptPackageRequestForV2,
-  adaptUpdateMediaBuyRequestForV2,
   adcpError,
   adcpErrorToTypedError,
   addSpanAttributes,
@@ -1073,7 +1064,6 @@ export {
   buildGovernanceProposedCommitment,
   buildHumanOverride,
   buildHumanReviewPlan,
-  buildSyntheticCapabilities,
   buildSyntheticV3Capabilities,
   bundleSupportsAdcpVersionField,
   callA2ATool,
@@ -1510,9 +1500,6 @@ export {
   urlRender,
   useIdempotencyKey,
   usesDeprecatedAssetsField,
-  usesV2CreativeIds,
-  usesV2Dimensions,
-  usesV2RenderFields,
   usesV3CreativeAssignments,
   usesV3RenderFields,
   usesV3Renders,

package/dist/lib/media-buy/compatibility.d.mts

@@ -209,7 +209,7 @@ export interface MediaBuyLifecycleCoordinatorOptions {
      * Stable, non-secret identity for the authenticated seller/account session.
      * Persist and reuse it when a coordinator is rehydrated. It is required
      * whenever `establishedProposalStore` is configured, and for established
-     * 2.5, 3.0, or 3.1 sellers that provide no server context ID.
+     * 3.0 or 3.1 sellers that provide no server context ID.
      */
     legacyPurchaseSellerSessionScope?: string;
     /** Durable storage for tokenless-catalog and products-only legacy purchase continuations. */

package/dist/lib/media-buy/compatibility.d.ts

@@ -209,7 +209,7 @@ export interface MediaBuyLifecycleCoordinatorOptions {
      * Stable, non-secret identity for the authenticated seller/account session.
      * Persist and reuse it when a coordinator is rehydrated. It is required
      * whenever `establishedProposalStore` is configured, and for established
-     * 2.5, 3.0, or 3.1 sellers that provide no server context ID.
+     * 3.0 or 3.1 sellers that provide no server context ID.
      */
     legacyPurchaseSellerSessionScope?: string;
     /** Durable storage for tokenless-catalog and products-only legacy purchase continuations. */

package/dist/lib/media-buy/compatibility.js

@@ -167,7 +167,7 @@ const CONTROL_MEDIA_BUY_FIELDS = /* @__PURE__ */ new Set([
   "revision",
   "total_budget"
 ]);
-const V25_OFFER_FILTER_FIELDS = /* @__PURE__ */ new Set([
+const V30_OFFER_FILTER_FIELDS = /* @__PURE__ */ new Set([
   "budget_range",
   "channels",
   "countries",
@@ -176,10 +176,7 @@ const V25_OFFER_FILTER_FIELDS = /* @__PURE__ */ new Set([
   "is_fixed_price",
   "min_exposures",
   "standard_formats_only",
-  "start_date"
-]);
-const V30_OFFER_FILTER_FIELDS = /* @__PURE__ */ new Set([
-  ...V25_OFFER_FILTER_FIELDS,
+  "start_date",
   "exclusivity",
   "required_performance_standards",
   "trusted_match"
@@ -207,15 +204,6 @@ const V30_PURCHASE_FIELDS = /* @__PURE__ */ new Set([
   "start_time",
   "targeting_overlay"
 ]);
-const V25_PURCHASE_FIELDS = /* @__PURE__ */ new Set([
-  "budget",
-  "ext",
-  "impressions",
-  "pacing",
-  "pricing_option_id",
-  "product_id",
-  "targeting_overlay"
-]);
 const V31_PURCHASE_FIELDS = /* @__PURE__ */ new Set([...V30_PURCHASE_FIELDS, "format_option_refs"]);
 const V32_PURCHASE_FIELDS = /* @__PURE__ */ new Set([
   ...V31_PURCHASE_FIELDS,
@@ -293,17 +281,6 @@ const V30_AVAILABLE_METRICS = /* @__PURE__ */ new Set([
   "dooh_metrics",
   "cost_per_click"
 ]);
-const V25_AVAILABLE_METRICS = /* @__PURE__ */ new Set([
-  "impressions",
-  "spend",
-  "clicks",
-  "ctr",
-  "video_completions",
-  "completion_rate",
-  "conversions",
-  "viewability",
-  "engagement_rate"
-]);
 const V31_AVAILABLE_METRICS = /* @__PURE__ */ new Set([
   "impressions",
   "spend",
@@ -576,8 +553,17 @@ function isCompactRelease(value) {
   return release !== void 0 && (release.major > 3 || release.major === 3 && release.minor >= 2);
 }
 function negotiatedVersion(capabilities, clientVersion) {
-  if (capabilities.version === "v2") return "2.5";
+  if (capabilities.version === "v2" || !capabilities.majorVersions.includes(3)) {
+    throw new import_errors.ConfigurationError(
+      "AdCP 2 reached end of life on 2026-08-01. Media-buy lifecycle negotiation requires AdCP 3."
+    );
+  }
   if (capabilities.servedVersion && parseRelease(capabilities.servedVersion)) {
+    if (parseRelease(capabilities.servedVersion).major < 3) {
+      throw new import_errors.ConfigurationError(
+        "The seller served an unsupported AdCP version. Media-buy lifecycle negotiation requires AdCP 3."
+      );
+    }
     if (compareRelease(capabilities.servedVersion, clientVersion) > 0) {
       const displayedServedVersion = capabilities.servedVersion.slice(0, 64);
       throw new import_errors.ConfigurationError(
@@ -586,7 +572,10 @@ function negotiatedVersion(capabilities, clientVersion) {
     }
     return capabilities.servedVersion;
   }
-  const advertisedVersions = capabilities.supportedVersions?.filter((version) => parseRelease(version) !== void 0);
+  const advertisedVersions = capabilities.supportedVersions?.filter((version) => {
+    const release = parseRelease(version);
+    return release !== void 0 && release.major >= 3;
+  });
   const candidates = advertisedVersions?.filter(
     (version) => parseRelease(version) !== void 0 && compareRelease(version, clientVersion) <= 0
   );
@@ -1863,7 +1852,7 @@ class MediaBuyLifecycleCoordinator {
   }
   assertLegacyMetrics(operation, value, path) {
     if (value === void 0 || isCompactRelease(this.negotiated_version)) return;
-    const supported = compareRelease(this.negotiated_version, "3.1") >= 0 ? V31_AVAILABLE_METRICS : compareRelease(this.negotiated_version, "3.0") >= 0 ? V30_AVAILABLE_METRICS : V25_AVAILABLE_METRICS;
+    const supported = compareRelease(this.negotiated_version, "3.1") >= 0 ? V31_AVAILABLE_METRICS : V30_AVAILABLE_METRICS;
     const unsupported = array(value).filter((metric) => typeof metric !== "string" || !supported.has(metric));
     if (unsupported.length === 0) return;
     throw this.unsupported(
@@ -1876,7 +1865,7 @@ class MediaBuyLifecycleCoordinator {
     const offerFilters = record(value);
     this.assertLegacyOfferFilterShapes(operation, offerFilters);
     this.assertLegacyMetrics(operation, offerFilters.required_metrics, "criteria.offer_filters.required_metrics");
-    const legacyOfferFilterFields = compareRelease(this.negotiated_version, "3.1") >= 0 ? V31_OFFER_FILTER_FIELDS : compareRelease(this.negotiated_version, "3.0") >= 0 ? V30_OFFER_FILTER_FIELDS : V25_OFFER_FILTER_FIELDS;
+    const legacyOfferFilterFields = compareRelease(this.negotiated_version, "3.1") >= 0 ? V31_OFFER_FILTER_FIELDS : V30_OFFER_FILTER_FIELDS;
     const unsupportedFields = Object.keys(offerFilters).filter((field) => !legacyOfferFilterFields.has(field));
     if (unsupportedFields.length > 0) {
       const paths = unsupportedFields.map((field) => `criteria.offer_filters.${field}`);
@@ -1924,13 +1913,13 @@ class MediaBuyLifecycleCoordinator {
   legacyPurchaseSourceVersion() {
     if (compareRelease(this.negotiated_version, "3.1") >= 0) return "3.1";
     if (compareRelease(this.negotiated_version, "3.0") >= 0) return "3.0";
-    return "2.5";
+    throw new import_errors.ConfigurationError("Legacy purchase continuations require AdCP 3.0 or 3.1.");
   }
   legacyPurchaseLosses(sourceVersion) {
     return [
       "feed_version_not_atomic",
       "pricing_version_not_atomic",
-      ...sourceVersion === "2.5" || this.idempotencyReplayTtlMs === void 0 ? ["mutation_idempotency_not_guaranteed"] : []
+      ...this.idempotencyReplayTtlMs === void 0 ? ["mutation_idempotency_not_guaranteed"] : []
     ];
   }
   legacyWireTaskOptions(sourceVersion = this.negotiated_version) {
@@ -4202,17 +4191,13 @@ class MediaBuyLifecycleCoordinator {
         "Every legacy_create_request package pricing_option_id must match an option observed for its selected product."
       );
     }
-    if (continuation.sourceAdcpVersion !== "2.5" && this.accountScope(legacyRequest.account) !== accountScope) {
+    if (this.accountScope(legacyRequest.account) !== accountScope) {
       throw new LegacyPurchaseContinuationError(
         "binding_mismatch",
         "legacy_create_request.account must match the continuation account."
       );
     }
-    const validation = (0, import_schema_validator2.validateRequest)(
-      "create_media_buy",
-      legacyRequest,
-      continuation.sourceAdcpVersion === "2.5" ? "v2.5" : continuation.sourceAdcpVersion
-    );
+    const validation = (0, import_schema_validator2.validateRequest)("create_media_buy", legacyRequest, continuation.sourceAdcpVersion);
     if (!validation.valid) {
       throw new LegacyPurchaseContinuationError(
         "request_invalid",
@@ -4266,7 +4251,7 @@ class MediaBuyLifecycleCoordinator {
           "The final seller payload pricing options must match the observed product snapshot."
         );
       }
-      if (continuation.sourceAdcpVersion !== "2.5" && this.accountScope(finalRequest.account) !== accountScope) {
+      if (this.accountScope(finalRequest.account) !== accountScope) {
         throw new LegacyPurchaseContinuationError(
           "binding_mismatch",
           "The final seller payload account must match the continuation account."
@@ -5035,11 +5020,7 @@ class MediaBuyLifecycleCoordinator {
       if (result.data === void 0) {
         throw this.legacyPurchaseAmbiguousError("The seller reported completion without a create_media_buy result.");
       }
-      const validation = (0, import_schema_validator.validateResponse)(
-        "create_media_buy",
-        result.data,
-        sourceVersion === "2.5" ? "v2.5" : sourceVersion
-      );
+      const validation = (0, import_schema_validator.validateResponse)("create_media_buy", result.data, sourceVersion);
       if (!validation.valid) {
         throw this.legacyPurchaseAmbiguousError(
           `The seller returned an invalid terminal create_media_buy result: ${(0, import_schema_validator.formatIssues)(validation.issues)}`
@@ -7018,7 +6999,7 @@ class MediaBuyLifecycleCoordinator {
     if (purchases.length === 0) {
       throw this.unsupported("buyProducts", "purchases", "Legacy create_media_buy requires at least one purchase.");
     }
-    const packageFields = isCompactRelease(this.negotiated_version) ? V32_PURCHASE_FIELDS : compareRelease(this.negotiated_version, "3.1") >= 0 ? V31_PURCHASE_FIELDS : compareRelease(this.negotiated_version, "3.0") >= 0 ? V30_PURCHASE_FIELDS : V25_PURCHASE_FIELDS;
+    const packageFields = isCompactRelease(this.negotiated_version) ? V32_PURCHASE_FIELDS : compareRelease(this.negotiated_version, "3.1") >= 0 ? V31_PURCHASE_FIELDS : V30_PURCHASE_FIELDS;
     const packages = purchases.map((value, index) => {
       const purchase = record(value);
       const unsupportedFields = Object.keys(purchase).filter((key) => !packageFields.has(key));
@@ -7865,7 +7846,7 @@ class MediaBuyLifecycleCoordinator {
         lifecycle,
         ["update_media_buy"],
         losses,
-        losses.length ? ["The v2.5 update cannot atomically enforce the compact revision token."] : []
+        losses.length ? ["The established update cannot atomically enforce the compact revision token."] : []
       ),
       (data) => data
     );

package/dist/lib/media-buy/compatibility.mjs

@@ -160,7 +160,7 @@ const CONTROL_MEDIA_BUY_FIELDS = /* @__PURE__ */ new Set([
   "revision",
   "total_budget"
 ]);
-const V25_OFFER_FILTER_FIELDS = /* @__PURE__ */ new Set([
+const V30_OFFER_FILTER_FIELDS = /* @__PURE__ */ new Set([
   "budget_range",
   "channels",
   "countries",
@@ -169,10 +169,7 @@ const V25_OFFER_FILTER_FIELDS = /* @__PURE__ */ new Set([
   "is_fixed_price",
   "min_exposures",
   "standard_formats_only",
-  "start_date"
-]);
-const V30_OFFER_FILTER_FIELDS = /* @__PURE__ */ new Set([
-  ...V25_OFFER_FILTER_FIELDS,
+  "start_date",
   "exclusivity",
   "required_performance_standards",
   "trusted_match"
@@ -200,15 +197,6 @@ const V30_PURCHASE_FIELDS = /* @__PURE__ */ new Set([
   "start_time",
   "targeting_overlay"
 ]);
-const V25_PURCHASE_FIELDS = /* @__PURE__ */ new Set([
-  "budget",
-  "ext",
-  "impressions",
-  "pacing",
-  "pricing_option_id",
-  "product_id",
-  "targeting_overlay"
-]);
 const V31_PURCHASE_FIELDS = /* @__PURE__ */ new Set([...V30_PURCHASE_FIELDS, "format_option_refs"]);
 const V32_PURCHASE_FIELDS = /* @__PURE__ */ new Set([
   ...V31_PURCHASE_FIELDS,
@@ -286,17 +274,6 @@ const V30_AVAILABLE_METRICS = /* @__PURE__ */ new Set([
   "dooh_metrics",
   "cost_per_click"
 ]);
-const V25_AVAILABLE_METRICS = /* @__PURE__ */ new Set([
-  "impressions",
-  "spend",
-  "clicks",
-  "ctr",
-  "video_completions",
-  "completion_rate",
-  "conversions",
-  "viewability",
-  "engagement_rate"
-]);
 const V31_AVAILABLE_METRICS = /* @__PURE__ */ new Set([
   "impressions",
   "spend",
@@ -569,8 +546,17 @@ function isCompactRelease(value) {
   return release !== void 0 && (release.major > 3 || release.major === 3 && release.minor >= 2);
 }
 function negotiatedVersion(capabilities, clientVersion) {
-  if (capabilities.version === "v2") return "2.5";
+  if (capabilities.version === "v2" || !capabilities.majorVersions.includes(3)) {
+    throw new ConfigurationError(
+      "AdCP 2 reached end of life on 2026-08-01. Media-buy lifecycle negotiation requires AdCP 3."
+    );
+  }
   if (capabilities.servedVersion && parseRelease(capabilities.servedVersion)) {
+    if (parseRelease(capabilities.servedVersion).major < 3) {
+      throw new ConfigurationError(
+        "The seller served an unsupported AdCP version. Media-buy lifecycle negotiation requires AdCP 3."
+      );
+    }
     if (compareRelease(capabilities.servedVersion, clientVersion) > 0) {
       const displayedServedVersion = capabilities.servedVersion.slice(0, 64);
       throw new ConfigurationError(
@@ -579,7 +565,10 @@ function negotiatedVersion(capabilities, clientVersion) {
     }
     return capabilities.servedVersion;
   }
-  const advertisedVersions = capabilities.supportedVersions?.filter((version) => parseRelease(version) !== void 0);
+  const advertisedVersions = capabilities.supportedVersions?.filter((version) => {
+    const release = parseRelease(version);
+    return release !== void 0 && release.major >= 3;
+  });
   const candidates = advertisedVersions?.filter(
     (version) => parseRelease(version) !== void 0 && compareRelease(version, clientVersion) <= 0
   );
@@ -1856,7 +1845,7 @@ class MediaBuyLifecycleCoordinator {
   }
   assertLegacyMetrics(operation, value, path) {
     if (value === void 0 || isCompactRelease(this.negotiated_version)) return;
-    const supported = compareRelease(this.negotiated_version, "3.1") >= 0 ? V31_AVAILABLE_METRICS : compareRelease(this.negotiated_version, "3.0") >= 0 ? V30_AVAILABLE_METRICS : V25_AVAILABLE_METRICS;
+    const supported = compareRelease(this.negotiated_version, "3.1") >= 0 ? V31_AVAILABLE_METRICS : V30_AVAILABLE_METRICS;
     const unsupported = array(value).filter((metric) => typeof metric !== "string" || !supported.has(metric));
     if (unsupported.length === 0) return;
     throw this.unsupported(
@@ -1869,7 +1858,7 @@ class MediaBuyLifecycleCoordinator {
     const offerFilters = record(value);
     this.assertLegacyOfferFilterShapes(operation, offerFilters);
     this.assertLegacyMetrics(operation, offerFilters.required_metrics, "criteria.offer_filters.required_metrics");
-    const legacyOfferFilterFields = compareRelease(this.negotiated_version, "3.1") >= 0 ? V31_OFFER_FILTER_FIELDS : compareRelease(this.negotiated_version, "3.0") >= 0 ? V30_OFFER_FILTER_FIELDS : V25_OFFER_FILTER_FIELDS;
+    const legacyOfferFilterFields = compareRelease(this.negotiated_version, "3.1") >= 0 ? V31_OFFER_FILTER_FIELDS : V30_OFFER_FILTER_FIELDS;
     const unsupportedFields = Object.keys(offerFilters).filter((field) => !legacyOfferFilterFields.has(field));
     if (unsupportedFields.length > 0) {
       const paths = unsupportedFields.map((field) => `criteria.offer_filters.${field}`);
@@ -1917,13 +1906,13 @@ class MediaBuyLifecycleCoordinator {
   legacyPurchaseSourceVersion() {
     if (compareRelease(this.negotiated_version, "3.1") >= 0) return "3.1";
     if (compareRelease(this.negotiated_version, "3.0") >= 0) return "3.0";
-    return "2.5";
+    throw new ConfigurationError("Legacy purchase continuations require AdCP 3.0 or 3.1.");
   }
   legacyPurchaseLosses(sourceVersion) {
     return [
       "feed_version_not_atomic",
       "pricing_version_not_atomic",
-      ...sourceVersion === "2.5" || this.idempotencyReplayTtlMs === void 0 ? ["mutation_idempotency_not_guaranteed"] : []
+      ...this.idempotencyReplayTtlMs === void 0 ? ["mutation_idempotency_not_guaranteed"] : []
     ];
   }
   legacyWireTaskOptions(sourceVersion = this.negotiated_version) {
@@ -4195,17 +4184,13 @@ class MediaBuyLifecycleCoordinator {
         "Every legacy_create_request package pricing_option_id must match an option observed for its selected product."
       );
     }
-    if (continuation.sourceAdcpVersion !== "2.5" && this.accountScope(legacyRequest.account) !== accountScope) {
+    if (this.accountScope(legacyRequest.account) !== accountScope) {
       throw new LegacyPurchaseContinuationError(
         "binding_mismatch",
         "legacy_create_request.account must match the continuation account."
       );
     }
-    const validation = validateRequest(
-      "create_media_buy",
-      legacyRequest,
-      continuation.sourceAdcpVersion === "2.5" ? "v2.5" : continuation.sourceAdcpVersion
-    );
+    const validation = validateRequest("create_media_buy", legacyRequest, continuation.sourceAdcpVersion);
     if (!validation.valid) {
       throw new LegacyPurchaseContinuationError(
         "request_invalid",
@@ -4259,7 +4244,7 @@ class MediaBuyLifecycleCoordinator {
           "The final seller payload pricing options must match the observed product snapshot."
         );
       }
-      if (continuation.sourceAdcpVersion !== "2.5" && this.accountScope(finalRequest.account) !== accountScope) {
+      if (this.accountScope(finalRequest.account) !== accountScope) {
         throw new LegacyPurchaseContinuationError(
           "binding_mismatch",
           "The final seller payload account must match the continuation account."
@@ -5028,11 +5013,7 @@ class MediaBuyLifecycleCoordinator {
       if (result.data === void 0) {
         throw this.legacyPurchaseAmbiguousError("The seller reported completion without a create_media_buy result.");
       }
-      const validation = validateResponse(
-        "create_media_buy",
-        result.data,
-        sourceVersion === "2.5" ? "v2.5" : sourceVersion
-      );
+      const validation = validateResponse("create_media_buy", result.data, sourceVersion);
       if (!validation.valid) {
         throw this.legacyPurchaseAmbiguousError(
           `The seller returned an invalid terminal create_media_buy result: ${formatIssues(validation.issues)}`
@@ -7011,7 +6992,7 @@ class MediaBuyLifecycleCoordinator {
     if (purchases.length === 0) {
       throw this.unsupported("buyProducts", "purchases", "Legacy create_media_buy requires at least one purchase.");
     }
-    const packageFields = isCompactRelease(this.negotiated_version) ? V32_PURCHASE_FIELDS : compareRelease(this.negotiated_version, "3.1") >= 0 ? V31_PURCHASE_FIELDS : compareRelease(this.negotiated_version, "3.0") >= 0 ? V30_PURCHASE_FIELDS : V25_PURCHASE_FIELDS;
+    const packageFields = isCompactRelease(this.negotiated_version) ? V32_PURCHASE_FIELDS : compareRelease(this.negotiated_version, "3.1") >= 0 ? V31_PURCHASE_FIELDS : V30_PURCHASE_FIELDS;
     const packages = purchases.map((value, index) => {
       const purchase = record(value);
       const unsupportedFields = Object.keys(purchase).filter((key) => !packageFields.has(key));
@@ -7858,7 +7839,7 @@ class MediaBuyLifecycleCoordinator {
         lifecycle,
         ["update_media_buy"],
         losses,
-        losses.length ? ["The v2.5 update cannot atomically enforce the compact revision token."] : []
+        losses.length ? ["The established update cannot atomically enforce the compact revision token."] : []
       ),
       (data) => data
     );

package/dist/lib/media-buy/index.d.mts

@@ -4,7 +4,7 @@ export { LEGACY_COARSE_ACTIONS } from './types.mjs';
 export type { LiveMediaBuyAction } from './action-types.mjs';
 export type { AvailableActionsResult, AvailableActionsSource } from './available-actions.mjs';
 export { findAvailableAction, getAvailableActions, getRollupParent, __resetValidActionsWarningForTests, } from './available-actions.mjs';
-export type { BuyerPropertyPolicy, NormalizedPolicyDomain, ProductPolicyProductLike, ProductPropertyPolicyDiagnostic, ProductPropertyPolicyDiagnosticCode, ProductPropertyPolicyDiagnosticSeverity, ProductPropertyPolicyMode, ProductPropertyPolicySelectorBehavior, ProductPropertyPolicyValidationResult, ValidateProductsAgainstPropertyPolicyOptions, } from './property-policy.mjs';
+export type { BuyerPropertyPolicy, NormalizedPolicyDomain, ProductPolicyProductLike, ProductPolicyResolvedProperty, ProductPropertyPolicyIdentifier, ProductPropertyPolicyDiagnostic, ProductPropertyPolicyDiagnosticCode, ProductPropertyPolicyDiagnosticSeverity, ProductPropertyPolicyMode, ProductPropertyPolicySelectorBehavior, ProductPropertyPolicyValidationResult, ValidateProductsAgainstPropertyPolicyOptions, } from './property-policy.mjs';
 export { ProductPropertyPolicyError, normalizeDomainForPropertyPolicy, validateProductsAgainstPropertyPolicy, } from './property-policy.mjs';
 export type { DecomposedUpdateMediaBuy, DecomposedUpdateMediaBuyMutation, MediaBuyMutationDirection, MediaBuyMutationScope, ModeMismatchRecovery, PreflightAllowed, PreflightDenial, PreflightDenied, PreflightResult, ResolvedAction, } from './preflight.mjs';
 export { canAddPackages, canCancel, canDecreaseBudget, canExtendFlight, canIncreaseBudget, canPause, canReallocateBudget, canRemoveCreative, canRemovePackages, canReplaceCreative, canResume, canShortenFlight, canUpdateCreativeAssignments, canUpdateFlightDates, canUpdateFrequencyCaps, canUpdatePacing, canUpdateTargeting, decomposeUpdateMediaBuy, getActionForMutation, preflightUpdateMediaBuy, recoveryForModeMismatch, } from './preflight.mjs';

package/dist/lib/media-buy/index.d.ts

@@ -4,7 +4,7 @@ export { LEGACY_COARSE_ACTIONS } from './types';
 export type { LiveMediaBuyAction } from './action-types';
 export type { AvailableActionsResult, AvailableActionsSource } from './available-actions';
 export { findAvailableAction, getAvailableActions, getRollupParent, __resetValidActionsWarningForTests, } from './available-actions';
-export type { BuyerPropertyPolicy, NormalizedPolicyDomain, ProductPolicyProductLike, ProductPropertyPolicyDiagnostic, ProductPropertyPolicyDiagnosticCode, ProductPropertyPolicyDiagnosticSeverity, ProductPropertyPolicyMode, ProductPropertyPolicySelectorBehavior, ProductPropertyPolicyValidationResult, ValidateProductsAgainstPropertyPolicyOptions, } from './property-policy';
+export type { BuyerPropertyPolicy, NormalizedPolicyDomain, ProductPolicyProductLike, ProductPolicyResolvedProperty, ProductPropertyPolicyIdentifier, ProductPropertyPolicyDiagnostic, ProductPropertyPolicyDiagnosticCode, ProductPropertyPolicyDiagnosticSeverity, ProductPropertyPolicyMode, ProductPropertyPolicySelectorBehavior, ProductPropertyPolicyValidationResult, ValidateProductsAgainstPropertyPolicyOptions, } from './property-policy';
 export { ProductPropertyPolicyError, normalizeDomainForPropertyPolicy, validateProductsAgainstPropertyPolicy, } from './property-policy';
 export type { DecomposedUpdateMediaBuy, DecomposedUpdateMediaBuyMutation, MediaBuyMutationDirection, MediaBuyMutationScope, ModeMismatchRecovery, PreflightAllowed, PreflightDenial, PreflightDenied, PreflightResult, ResolvedAction, } from './preflight';
 export { canAddPackages, canCancel, canDecreaseBudget, canExtendFlight, canIncreaseBudget, canPause, canReallocateBudget, canRemoveCreative, canRemovePackages, canReplaceCreative, canResume, canShortenFlight, canUpdateCreativeAssignments, canUpdateFlightDates, canUpdateFrequencyCaps, canUpdatePacing, canUpdateTargeting, decomposeUpdateMediaBuy, getActionForMutation, preflightUpdateMediaBuy, recoveryForModeMismatch, } from './preflight';

package/dist/lib/media-buy/legacy-purchase-continuation.d.mts

@@ -3,7 +3,7 @@ import type { CompatibilityPurchaseCoordinatorInput } from '../types/core.genera
 import type { CreateMediaBuyResponse } from '../types/tools.generated.mjs';
 /** Minimum crash-recovery horizon after an SDK-owned publication is acknowledged. */
 export declare const LEGACY_PURCHASE_PUBLICATION_PROOF_RETENTION_MS: number;
-export type LegacyPurchaseSourceVersion = '2.5' | '3.0' | '3.1';
+export type LegacyPurchaseSourceVersion = '3.0' | '3.1';
 export type LegacyPurchaseLoss = 'feed_version_not_atomic' | 'pricing_version_not_atomic' | 'mutation_idempotency_not_guaranteed';
 export type LegacyPurchaseTerminalResult = TaskResultCompleted<CreateMediaBuyResponse> | TaskResultFailure<CreateMediaBuyResponse>;
 export interface LegacyPurchasePendingSettlement {
@@ -39,7 +39,7 @@ export interface LegacyPurchaseClaim {
     claimedAt: string;
     replayExpiresAt: string;
     selectedProductIds: string[];
-    /** Source-version mutation key (`idempotency_key`, or v2.5 `buyer_ref`). */
+    /** Source-version mutation idempotency key. */
     sourceMutationKey?: string;
     /** Seller task handle retained after a submitted response. */
     sellerTaskId?: string;

package/dist/lib/media-buy/legacy-purchase-continuation.d.ts

@@ -3,7 +3,7 @@ import type { CompatibilityPurchaseCoordinatorInput } from '../types/core.genera
 import type { CreateMediaBuyResponse } from '../types/tools.generated';
 /** Minimum crash-recovery horizon after an SDK-owned publication is acknowledged. */
 export declare const LEGACY_PURCHASE_PUBLICATION_PROOF_RETENTION_MS: number;
-export type LegacyPurchaseSourceVersion = '2.5' | '3.0' | '3.1';
+export type LegacyPurchaseSourceVersion = '3.0' | '3.1';
 export type LegacyPurchaseLoss = 'feed_version_not_atomic' | 'pricing_version_not_atomic' | 'mutation_idempotency_not_guaranteed';
 export type LegacyPurchaseTerminalResult = TaskResultCompleted<CreateMediaBuyResponse> | TaskResultFailure<CreateMediaBuyResponse>;
 export interface LegacyPurchasePendingSettlement {
@@ -39,7 +39,7 @@ export interface LegacyPurchaseClaim {
     claimedAt: string;
     replayExpiresAt: string;
     selectedProductIds: string[];
-    /** Source-version mutation key (`idempotency_key`, or v2.5 `buyer_ref`). */
+    /** Source-version mutation idempotency key. */
     sourceMutationKey?: string;
     /** Seller task handle retained after a submitted response. */
     sellerTaskId?: string;

package/dist/lib/media-buy/property-policy.d.mts

@@ -1,3 +1,4 @@
+export declare function isSupportedPropertyIdentifierType(type: string): boolean;
 export type ProductPropertyPolicyMode = 'audit' | 'filter' | 'reject_response';
 export type ProductPropertyPolicySelectorBehavior = 'allow' | 'flag' | 'reject';
 export interface BuyerPropertyPolicy {
@@ -10,6 +11,13 @@ export interface BuyerPropertyPolicy {
      * `*.example.com` matches subdomains only).
      */
     allowedPropertyIdentifiers?: readonly ProductPropertyPolicyIdentifier[];
+    /**
+     * Complete publisher catalogs, keyed by canonical publisher domain. Enables
+     * app/CTV identifier matching for all/by_id/by_tag selectors. Omitted keys
+     * mean unresolved metadata; an empty array means a known empty catalog.
+     * Property IDs remain publisher-scoped and are never treated as app IDs.
+     */
+    publisherProperties?: Readonly<Record<string, readonly ProductPolicyResolvedProperty[] | undefined>>;
     /**
      * Require products to match the allowed domain/identifier set even when that
      * set is empty. Used when a request property_list resolves successfully to
@@ -56,7 +64,12 @@ export interface ProductPropertyPolicyIdentifier {
     type: string;
     value: string;
 }
-export type ProductPropertyPolicyDiagnosticCode = 'outside_property_list' | 'excluded_domain' | 'excluded_property_id' | 'missing_publisher_properties' | 'unresolved_tag_selector' | 'unknown_selector' | 'malformed_publisher_domain';
+export interface ProductPolicyResolvedProperty {
+    property_id?: string;
+    identifiers: readonly ProductPropertyPolicyIdentifier[];
+    tags?: readonly string[];
+}
+export type ProductPropertyPolicyDiagnosticCode = 'outside_property_list' | 'excluded_domain' | 'excluded_property_id' | 'missing_publisher_properties' | 'unresolved_tag_selector' | 'unknown_selector' | 'malformed_publisher_domain' | 'unresolved_property_identifiers' | 'excluded_resolved_property';
 export type ProductPropertyPolicyDiagnosticSeverity = 'rejected' | 'flagged';
 export interface ProductPropertyPolicyDiagnostic {
     code: ProductPropertyPolicyDiagnosticCode;
@@ -75,6 +88,7 @@ export interface ProductPropertyPolicyDiagnostic {
     matched_excluded_domain?: string;
     property_ids?: string[];
     matched_property_ids?: string[];
+    identifier_types?: string[];
 }
 export interface ProductPropertyPolicyValidationResult<TProduct extends ProductPolicyProductLike> {
     mode: ProductPropertyPolicyMode;

package/dist/lib/media-buy/property-policy.d.ts

@@ -1,3 +1,4 @@
+export declare function isSupportedPropertyIdentifierType(type: string): boolean;
 export type ProductPropertyPolicyMode = 'audit' | 'filter' | 'reject_response';
 export type ProductPropertyPolicySelectorBehavior = 'allow' | 'flag' | 'reject';
 export interface BuyerPropertyPolicy {
@@ -10,6 +11,13 @@ export interface BuyerPropertyPolicy {
      * `*.example.com` matches subdomains only).
      */
     allowedPropertyIdentifiers?: readonly ProductPropertyPolicyIdentifier[];
+    /**
+     * Complete publisher catalogs, keyed by canonical publisher domain. Enables
+     * app/CTV identifier matching for all/by_id/by_tag selectors. Omitted keys
+     * mean unresolved metadata; an empty array means a known empty catalog.
+     * Property IDs remain publisher-scoped and are never treated as app IDs.
+     */
+    publisherProperties?: Readonly<Record<string, readonly ProductPolicyResolvedProperty[] | undefined>>;
     /**
      * Require products to match the allowed domain/identifier set even when that
      * set is empty. Used when a request property_list resolves successfully to
@@ -56,7 +64,12 @@ export interface ProductPropertyPolicyIdentifier {
     type: string;
     value: string;
 }
-export type ProductPropertyPolicyDiagnosticCode = 'outside_property_list' | 'excluded_domain' | 'excluded_property_id' | 'missing_publisher_properties' | 'unresolved_tag_selector' | 'unknown_selector' | 'malformed_publisher_domain';
+export interface ProductPolicyResolvedProperty {
+    property_id?: string;
+    identifiers: readonly ProductPropertyPolicyIdentifier[];
+    tags?: readonly string[];
+}
+export type ProductPropertyPolicyDiagnosticCode = 'outside_property_list' | 'excluded_domain' | 'excluded_property_id' | 'missing_publisher_properties' | 'unresolved_tag_selector' | 'unknown_selector' | 'malformed_publisher_domain' | 'unresolved_property_identifiers' | 'excluded_resolved_property';
 export type ProductPropertyPolicyDiagnosticSeverity = 'rejected' | 'flagged';
 export interface ProductPropertyPolicyDiagnostic {
     code: ProductPropertyPolicyDiagnosticCode;
@@ -75,6 +88,7 @@ export interface ProductPropertyPolicyDiagnostic {
     matched_excluded_domain?: string;
     property_ids?: string[];
     matched_property_ids?: string[];
+    identifier_types?: string[];
 }
 export interface ProductPropertyPolicyValidationResult<TProduct extends ProductPolicyProductLike> {
     mode: ProductPropertyPolicyMode;