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

package/dist/lib/index.d.mts

@@ -226,16 +226,16 @@ export type { BuildActivateSignalRequestOptions, DiscoveredSignal, NormalizedDis
 export { buildCreativeReturn, singleBuildCreativeReturn, multiBuildCreativeReturn, singleEnvelopedBuildCreativeReturn, multiEnvelopedBuildCreativeReturn, variantEnvelopedBuildCreativeReturn, } from './utils/build-creative-return-builders.mjs';
 export { previewCreative, singlePreviewCreativeResponse, batchPreviewCreativeResponse, variantPreviewCreativeResponse, } from './utils/preview-creative-builders.mjs';
 export { mediaBuyDeliveryNotification, scheduledMediaBuyDeliveryNotification, finalMediaBuyDeliveryNotification, delayedMediaBuyDeliveryNotification, adjustedMediaBuyDeliveryNotification, windowUpdateMediaBuyDeliveryNotification, } from './utils/media-buy-delivery-notification-builders.mjs';
-export { buildSyntheticCapabilities, buildSyntheticV3Capabilities, parseCapabilitiesResponse, supportsV3, supportsProtocol, supportsPropertyListFiltering, supportsContentStandards, supportsSyncCreatives, supportsBuyingMode, requiresOperatorAuth, requiresAccountForProducts, supportsSandbox, supportsExperimentalFeature, resolveFeature, listDeclaredFeatures, MEDIA_BUY_TOOLS, SIGNALS_TOOLS, GOVERNANCE_TOOLS, CREATIVE_TOOLS, EVENT_TRACKING_TOOLS, ACCOUNT_TOOLS, PROTOCOL_TOOLS, BRAND_RIGHTS_TOOLS, TASK_FEATURE_MAP, } from './utils/capabilities.mjs';
+export { buildSyntheticV3Capabilities, parseCapabilitiesResponse, supportsV3, supportsProtocol, supportsPropertyListFiltering, supportsContentStandards, supportsSyncCreatives, supportsBuyingMode, requiresOperatorAuth, requiresAccountForProducts, supportsSandbox, supportsExperimentalFeature, resolveFeature, listDeclaredFeatures, MEDIA_BUY_TOOLS, SIGNALS_TOOLS, GOVERNANCE_TOOLS, CREATIVE_TOOLS, EVENT_TRACKING_TOOLS, ACCOUNT_TOOLS, PROTOCOL_TOOLS, BRAND_RIGHTS_TOOLS, TASK_FEATURE_MAP, } from './utils/capabilities.mjs';
 export type { AdcpCapabilities, AdcpMajorVersion, AdcpProtocol, AccountCapabilities, BuyingMode, MediaBuyFeatures, ToolInfo, FeatureName, } from './utils/capabilities.mjs';
 export type { ResolveAccountOptions, ResolveAccountResult, ListedAccount } from './core/account-resolution.mjs';
 export { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from './utils/creative-delivery.mjs';
 export type { InlineCreativeAssignment, InlineCreativePackage, InlineCreativePackagePatch, InlineCreativesForPackagesOptions, InlineCreativesForPackagesLegacyOptions, LegacyInlineCreativePackage, } from './utils/creative-delivery.mjs';
-export { adaptPackageRequestForV2, adaptCreateMediaBuyRequestForV2, adaptUpdateMediaBuyRequestForV2, normalizePackageResponse, normalizeMediaBuyResponse, usesV2CreativeIds, usesV3CreativeAssignments, getCreativeIds, getCreativeAssignments, } from './utils/creative-adapter.mjs';
+export { normalizePackageResponse, normalizeMediaBuyResponse, usesV3CreativeAssignments, getCreativeIds, getCreativeAssignments, } from './utils/creative-adapter.mjs';
 export type { CreativeAssignment } from './utils/creative-adapter.mjs';
-export { normalizeFormatRenders, normalizeFormatsResponse, getFormatRenders, getPrimaryRender, getCompanionRenders, isMultiRenderFormat, usesV2Dimensions, usesV3Renders, getFormatDimensions, } from './utils/format-renders.mjs';
+export { normalizeFormatRenders, normalizeFormatsResponse, getFormatRenders, getPrimaryRender, getCompanionRenders, isMultiRenderFormat, usesV3Renders, getFormatDimensions, } from './utils/format-renders.mjs';
 export type { FormatRenderEntry, RenderDimensions } from './utils/format-renders.mjs';
-export { normalizePreviewRender, normalizePreview, normalizePreviewCreativeResponse, usesV2RenderFields, usesV3RenderFields, getRenderId, getRenderRole, getPrimaryPreviewRender, getPreviewUrl, getPreviewHtml, } from './utils/preview-normalizer.mjs';
+export { normalizePreviewRender, normalizePreview, normalizePreviewCreativeResponse, usesV3RenderFields, getRenderId, getRenderRole, getPrimaryPreviewRender, getPreviewUrl, getPreviewHtml, } from './utils/preview-normalizer.mjs';
 export type { PreviewRendererMetadata, PreviewRenderV3 } from './utils/preview-normalizer.mjs';
 export { resolvePreviewAuthority, type PlacementPreviewCandidate, type PreviewAuthorityInput, type PreviewAuthorityResolution, type PreviewFidelity, type SelectedPreviewAuthority, type SellerPreviewCandidate, } from './utils/preview-authority.mjs';
 export { isStatusCompleted, isStatusWorking, isStatusInputRequired, isStatusSubmitted, isStatusFailed, isStatusRejected, isGetProductsCompleted, isGetProductsWorking, isGetProductsInputRequired, isGetProductsSubmitted, isGetProductsFailed, isCreateMediaBuyCompleted, isCreateMediaBuyWorking, isCreateMediaBuyInputRequired, isCreateMediaBuySubmitted, isCreateMediaBuyFailed, isUpdateMediaBuyCompleted, isUpdateMediaBuyWorking, isUpdateMediaBuyInputRequired, isUpdateMediaBuySubmitted, isUpdateMediaBuyFailed, isSyncCreativesCompleted, isSyncCreativesWorking, isSyncCreativesInputRequired, isSyncCreativesSubmitted, isSyncCreativesFailed, } from './utils/typeGuards.mjs';

package/dist/lib/index.d.ts

@@ -226,16 +226,16 @@ export type { BuildActivateSignalRequestOptions, DiscoveredSignal, NormalizedDis
 export { buildCreativeReturn, singleBuildCreativeReturn, multiBuildCreativeReturn, singleEnvelopedBuildCreativeReturn, multiEnvelopedBuildCreativeReturn, variantEnvelopedBuildCreativeReturn, } from './utils/build-creative-return-builders';
 export { previewCreative, singlePreviewCreativeResponse, batchPreviewCreativeResponse, variantPreviewCreativeResponse, } from './utils/preview-creative-builders';
 export { mediaBuyDeliveryNotification, scheduledMediaBuyDeliveryNotification, finalMediaBuyDeliveryNotification, delayedMediaBuyDeliveryNotification, adjustedMediaBuyDeliveryNotification, windowUpdateMediaBuyDeliveryNotification, } from './utils/media-buy-delivery-notification-builders';
-export { buildSyntheticCapabilities, buildSyntheticV3Capabilities, parseCapabilitiesResponse, supportsV3, supportsProtocol, supportsPropertyListFiltering, supportsContentStandards, supportsSyncCreatives, supportsBuyingMode, requiresOperatorAuth, requiresAccountForProducts, supportsSandbox, supportsExperimentalFeature, resolveFeature, listDeclaredFeatures, MEDIA_BUY_TOOLS, SIGNALS_TOOLS, GOVERNANCE_TOOLS, CREATIVE_TOOLS, EVENT_TRACKING_TOOLS, ACCOUNT_TOOLS, PROTOCOL_TOOLS, BRAND_RIGHTS_TOOLS, TASK_FEATURE_MAP, } from './utils/capabilities';
+export { buildSyntheticV3Capabilities, parseCapabilitiesResponse, supportsV3, supportsProtocol, supportsPropertyListFiltering, supportsContentStandards, supportsSyncCreatives, supportsBuyingMode, requiresOperatorAuth, requiresAccountForProducts, supportsSandbox, supportsExperimentalFeature, resolveFeature, listDeclaredFeatures, MEDIA_BUY_TOOLS, SIGNALS_TOOLS, GOVERNANCE_TOOLS, CREATIVE_TOOLS, EVENT_TRACKING_TOOLS, ACCOUNT_TOOLS, PROTOCOL_TOOLS, BRAND_RIGHTS_TOOLS, TASK_FEATURE_MAP, } from './utils/capabilities';
 export type { AdcpCapabilities, AdcpMajorVersion, AdcpProtocol, AccountCapabilities, BuyingMode, MediaBuyFeatures, ToolInfo, FeatureName, } from './utils/capabilities';
 export type { ResolveAccountOptions, ResolveAccountResult, ListedAccount } from './core/account-resolution';
 export { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from './utils/creative-delivery';
 export type { InlineCreativeAssignment, InlineCreativePackage, InlineCreativePackagePatch, InlineCreativesForPackagesOptions, InlineCreativesForPackagesLegacyOptions, LegacyInlineCreativePackage, } from './utils/creative-delivery';
-export { adaptPackageRequestForV2, adaptCreateMediaBuyRequestForV2, adaptUpdateMediaBuyRequestForV2, normalizePackageResponse, normalizeMediaBuyResponse, usesV2CreativeIds, usesV3CreativeAssignments, getCreativeIds, getCreativeAssignments, } from './utils/creative-adapter';
+export { normalizePackageResponse, normalizeMediaBuyResponse, usesV3CreativeAssignments, getCreativeIds, getCreativeAssignments, } from './utils/creative-adapter';
 export type { CreativeAssignment } from './utils/creative-adapter';
-export { normalizeFormatRenders, normalizeFormatsResponse, getFormatRenders, getPrimaryRender, getCompanionRenders, isMultiRenderFormat, usesV2Dimensions, usesV3Renders, getFormatDimensions, } from './utils/format-renders';
+export { normalizeFormatRenders, normalizeFormatsResponse, getFormatRenders, getPrimaryRender, getCompanionRenders, isMultiRenderFormat, usesV3Renders, getFormatDimensions, } from './utils/format-renders';
 export type { FormatRenderEntry, RenderDimensions } from './utils/format-renders';
-export { normalizePreviewRender, normalizePreview, normalizePreviewCreativeResponse, usesV2RenderFields, usesV3RenderFields, getRenderId, getRenderRole, getPrimaryPreviewRender, getPreviewUrl, getPreviewHtml, } from './utils/preview-normalizer';
+export { normalizePreviewRender, normalizePreview, normalizePreviewCreativeResponse, usesV3RenderFields, getRenderId, getRenderRole, getPrimaryPreviewRender, getPreviewUrl, getPreviewHtml, } from './utils/preview-normalizer';
 export type { PreviewRendererMetadata, PreviewRenderV3 } from './utils/preview-normalizer';
 export { resolvePreviewAuthority, type PlacementPreviewCandidate, type PreviewAuthorityInput, type PreviewAuthorityResolution, type PreviewFidelity, type SelectedPreviewAuthority, type SellerPreviewCandidate, } from './utils/preview-authority';
 export { isStatusCompleted, isStatusWorking, isStatusInputRequired, isStatusSubmitted, isStatusFailed, isStatusRejected, isGetProductsCompleted, isGetProductsWorking, isGetProductsInputRequired, isGetProductsSubmitted, isGetProductsFailed, isCreateMediaBuyCompleted, isCreateMediaBuyWorking, isCreateMediaBuyInputRequired, isCreateMediaBuySubmitted, isCreateMediaBuyFailed, isUpdateMediaBuyCompleted, isUpdateMediaBuyWorking, isUpdateMediaBuyInputRequired, isUpdateMediaBuySubmitted, isUpdateMediaBuyFailed, isSyncCreativesCompleted, isSyncCreativesWorking, isSyncCreativesInputRequired, isSyncCreativesSubmitted, isSyncCreativesFailed, } from './utils/typeGuards';

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,
@@ -1072,9 +1065,6 @@ function createAdCPClientFromEnv() {
   WebhookDispatchError,
   WholesaleFeedWebhookNotificationError,
   activationKey,
-  adaptCreateMediaBuyRequestForV2,
-  adaptPackageRequestForV2,
-  adaptUpdateMediaBuyRequestForV2,
   adcpError,
   adcpErrorToTypedError,
   addSpanAttributes,
@@ -1112,7 +1102,6 @@ function createAdCPClientFromEnv() {
   buildGovernanceProposedCommitment,
   buildHumanOverride,
   buildHumanReviewPlan,
-  buildSyntheticCapabilities,
   buildSyntheticV3Capabilities,
   bundleSupportsAdcpVersionField,
   callA2ATool,
@@ -1549,9 +1538,6 @@ function createAdCPClientFromEnv() {
   urlRender,
   useIdempotencyKey,
   usesDeprecatedAssetsField,
-  usesV2CreativeIds,
-  usesV2Dimensions,
-  usesV2RenderFields,
   usesV3CreativeAssignments,
   usesV3RenderFields,
   usesV3Renders,

package/dist/lib/index.mjs

@@ -618,7 +618,6 @@ import {
   windowUpdateMediaBuyDeliveryNotification
 } from "./utils/media-buy-delivery-notification-builders.mjs";
 import {
-  buildSyntheticCapabilities,
   buildSyntheticV3Capabilities,
   parseCapabilitiesResponse,
   supportsV3,
@@ -645,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
@@ -662,7 +657,6 @@ import {
   getPrimaryRender,
   getCompanionRenders,
   isMultiRenderFormat,
-  usesV2Dimensions,
   usesV3Renders,
   getFormatDimensions
 } from "./utils/format-renders.mjs";
@@ -670,7 +664,6 @@ import {
   normalizePreviewRender,
   normalizePreview,
   normalizePreviewCreativeResponse,
-  usesV2RenderFields,
   usesV3RenderFields,
   getRenderId,
   getRenderRole,
@@ -1034,9 +1027,6 @@ export {
   WebhookDispatchError,
   WholesaleFeedWebhookNotificationError,
   activationKey,
-  adaptCreateMediaBuyRequestForV2,
-  adaptPackageRequestForV2,
-  adaptUpdateMediaBuyRequestForV2,
   adcpError,
   adcpErrorToTypedError,
   addSpanAttributes,
@@ -1074,7 +1064,6 @@ export {
   buildGovernanceProposedCommitment,
   buildHumanOverride,
   buildHumanReviewPlan,
-  buildSyntheticCapabilities,
   buildSyntheticV3Capabilities,
   bundleSupportsAdcpVersionField,
   callA2ATool,
@@ -1511,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/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;