@adcp/sdk 16.0.0-beta.8 → 16.0.0

package/dist/lib/utils/pricing-adapter.mjs

@@ -33,28 +33,6 @@ function getFloorPrice(option) {
   }
   return option.price_guidance?.floor;
 }
-function adaptPricingOptionForV2(option) {
-  if (!usesV3PricingFields(option)) {
-    return option;
-  }
-  const { fixed_price, floor_price, price_guidance, ...rest } = option;
-  const result = { ...rest };
-  if (fixed_price !== void 0) {
-    result.rate = fixed_price;
-    result.is_fixed = true;
-  } else {
-    result.is_fixed = false;
-    if (floor_price !== void 0 || price_guidance) {
-      result.price_guidance = {
-        ...price_guidance || {}
-      };
-      if (floor_price !== void 0) {
-        result.price_guidance.floor = floor_price;
-      }
-    }
-  }
-  return result;
-}
 function normalizePricingOption(option) {
   if (usesV3PricingFields(option) && !usesV2PricingFields(option)) {
     return option;
@@ -76,15 +54,6 @@ function normalizePricingOption(option) {
   }
   return result;
 }
-function adaptProductPricingForV2(product) {
-  if (!product?.pricing_options || !Array.isArray(product.pricing_options)) {
-    return product;
-  }
-  return {
-    ...product,
-    pricing_options: product.pricing_options.map(adaptPricingOptionForV2)
-  };
-}
 function normalizeProductPricing(product) {
   if (!product?.pricing_options || !Array.isArray(product.pricing_options)) {
     return product;
@@ -94,64 +63,6 @@ function normalizeProductPricing(product) {
     pricing_options: product.pricing_options.map(normalizePricingOption)
   };
 }
-function adaptGetProductsRequestForV2(request) {
-  const adapted = { ...request };
-  if (adapted.brand?.domain) {
-    adapted.brand_manifest = `https://${adapted.brand.domain}`;
-    delete adapted.brand;
-  }
-  if (adapted.catalog) {
-    const catalog = adapted.catalog;
-    if (catalog.type === "product") {
-      adapted.promoted_offerings = {
-        product_selectors: {
-          ...catalog.gtins?.length && { manifest_gtins: catalog.gtins },
-          ...catalog.ids?.length && { manifest_skus: catalog.ids },
-          ...catalog.tags?.length && { manifest_tags: catalog.tags },
-          ...catalog.category && { manifest_category: catalog.category },
-          ...catalog.query && { manifest_query: catalog.query }
-        }
-      };
-    } else if (catalog.type === "offering") {
-      adapted.promoted_offerings = {
-        ...catalog.items?.length && { offerings: catalog.items }
-      };
-    }
-    delete adapted.catalog;
-  }
-  if (adapted.filters?.channels) {
-    const v2ChannelMap = {
-      olv: "video",
-      ctv: "video",
-      streaming_audio: "audio",
-      retail_media: "retail"
-    };
-    const mapped = adapted.filters.channels.map((ch) => v2ChannelMap[ch] ?? ch);
-    adapted.filters = {
-      ...adapted.filters,
-      channels: [...new Set(mapped)]
-    };
-  }
-  if (adapted.filters) {
-    const {
-      required_features,
-      required_axe_integrations,
-      required_geo_targeting,
-      signal_targeting,
-      regions,
-      metros,
-      ...v2Filters
-    } = adapted.filters;
-    adapted.filters = v2Filters;
-  }
-  delete adapted.buying_mode;
-  delete adapted.buyer_campaign_ref;
-  delete adapted.property_list;
-  delete adapted.account;
-  delete adapted.pagination;
-  delete adapted.adcp_major_version;
-  return adapted;
-}
 function normalizeProductChannels(product) {
   if (!product?.channels || !Array.isArray(product.channels)) {
     return product;
@@ -249,12 +160,6 @@ function normalizeGetProductsResponse(response) {
     )
   };
 }
-function adaptPackagePricingForV2(pkg) {
-  return pkg;
-}
-function adaptMediaBuyPricingForV2(request) {
-  return request;
-}
 function normalizeMediaBuyPricingResponse(response) {
   if (response?.products && Array.isArray(response.products)) {
     return {
@@ -265,11 +170,6 @@ function normalizeMediaBuyPricingResponse(response) {
   return response;
 }
 export {
-  adaptGetProductsRequestForV2,
-  adaptMediaBuyPricingForV2,
-  adaptPackagePricingForV2,
-  adaptPricingOptionForV2,
-  adaptProductPricingForV2,
   getFloorPrice,
   getPrice,
   isCPAPricing,

package/dist/lib/utils/request-normalizer.d.mts

@@ -14,8 +14,7 @@
  *
  * Does NOT copy `context.buyer_ref` up to a top-level `buyer_ref`. The top-level
  * field was removed from the package schema in AdCP 3.0 and strict v3 receivers
- * reject it. When a request routes to a v2.5 seller, the v2 adapter in
- * `creative-adapter.ts` derives `buyer_ref` (from a caller-supplied value,
+ * reject it. Historical SDK releases derived `buyer_ref` (from a caller-supplied value,
  * `context.buyer_ref`, `idempotency_key`, or parent/index) — that adapter is
  * gated on `serverVersion !== 'v3'`, so the field only lands on the wire for
  * sellers that still expect it.

package/dist/lib/utils/request-normalizer.d.ts

@@ -14,8 +14,7 @@
  *
  * Does NOT copy `context.buyer_ref` up to a top-level `buyer_ref`. The top-level
  * field was removed from the package schema in AdCP 3.0 and strict v3 receivers
- * reject it. When a request routes to a v2.5 seller, the v2 adapter in
- * `creative-adapter.ts` derives `buyer_ref` (from a caller-supplied value,
+ * reject it. Historical SDK releases derived `buyer_ref` (from a caller-supplied value,
  * `context.buyer_ref`, `idempotency_key`, or parent/index) — that adapter is
  * gated on `serverVersion !== 'v3'`, so the field only lands on the wire for
  * sellers that still expect it.

package/dist/lib/v2/projection/catalog.d.mts

@@ -70,6 +70,10 @@ export interface V1FormatDefinition {
         required?: boolean;
         asset_type?: string;
         requirements?: Record<string, unknown>;
+        /** Reference-catalog extension used to match pixel-tracker slots. */
+        event?: string;
+        /** Caller-defined tracker extension; required to match a custom event. */
+        custom_event_name?: string;
     }>;
     /**
      * v2 canonical projection. Always object-shaped per

package/dist/lib/v2/projection/catalog.d.ts

@@ -70,6 +70,10 @@ export interface V1FormatDefinition {
         required?: boolean;
         asset_type?: string;
         requirements?: Record<string, unknown>;
+        /** Reference-catalog extension used to match pixel-tracker slots. */
+        event?: string;
+        /** Caller-defined tracker extension; required to match a custom event. */
+        custom_event_name?: string;
     }>;
     /**
      * v2 canonical projection. Always object-shaped per

package/dist/lib/v2/projection/creative-delivery.d.mts

@@ -4,6 +4,7 @@ import type { CanonicalFormatLegacyResolver } from './v2-to-v1.mjs';
 import type { CanonicalFormatKind, ProjectionDiagnostic, V1FormatId } from './types.mjs';
 import type { CanonicalFormatDeclaration } from './legacy-metadata.mjs';
 import type { UndeclaredFormatOptionSelector } from './legacy-routes.mjs';
+import { type V1FormatDefinition } from './catalog.mjs';
 type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, Extract<keyof T, K>> : never;
 /**
  * Primary SDK creative shape. Spell out the named fields rather than using
@@ -254,6 +255,8 @@ export interface CreativeFormatSelectorContainer {
 /** Canonical package/product selectors accepted by the primary sync API. */
 export interface CanonicalCreativeFormatSelectorContainer {
     package_id?: string;
+    /** Target product, used to recover seller declarations after serializing selectors. */
+    product_id?: string;
     format_options?: ReadonlyArray<CanonicalFormatDeclaration>;
     format_option_refs?: ReadonlyArray<FormatOptionReference>;
     format_kind?: CanonicalFormatKind;
@@ -274,15 +277,20 @@ export declare class CreativeFormatCapabilityError extends Error {
     readonly code = "ADCP_CREATIVE_FORMAT_CAPABILITY_CONTRADICTION";
     constructor(message: string);
 }
-export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode?: 'canonical', operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): CanonicalProjectedCreative<T>;
-export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode: 'legacy' | 'unknown', operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): LegacyProjectedCreative<T>;
-export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode: CreativeFormatWireMode, operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): CanonicalProjectedCreative<T> | LegacyProjectedCreative<T>;
-export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: 'canonical', operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedMediaBuyCreativeRequest<T, 'canonical'>;
-export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: 'legacy' | 'unknown', operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedMediaBuyCreativeRequest<T, 'legacy'>;
-export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: CreativeFormatWireMode, operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedMediaBuyCreativeRequest<T, 'canonical'> | ProjectedMediaBuyCreativeRequest<T, 'legacy'>;
-export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'canonical', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'>;
-export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'legacy' | 'unknown', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'legacy'>;
-export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: CreativeFormatWireMode, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'> | ProjectedSyncCreativeRequest<T, 'legacy'>;
+/**
+ * Project identity and asset keys for the selected wire mode. Optional
+ * `legacyFormatDefinitions` override bundled definitions by exact format owner
+ * and ID; ambiguous definitions leave asset keys unchanged.
+ */
+export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode?: 'canonical', operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): CanonicalProjectedCreative<T>;
+export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode: 'legacy' | 'unknown', operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): LegacyProjectedCreative<T>;
+export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode: CreativeFormatWireMode, operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): CanonicalProjectedCreative<T> | LegacyProjectedCreative<T>;
+export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: 'canonical', operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): ProjectedMediaBuyCreativeRequest<T, 'canonical'>;
+export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: 'legacy' | 'unknown', operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): ProjectedMediaBuyCreativeRequest<T, 'legacy'>;
+export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: CreativeFormatWireMode, operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): ProjectedMediaBuyCreativeRequest<T, 'canonical'> | ProjectedMediaBuyCreativeRequest<T, 'legacy'>;
+export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'canonical', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): ProjectedSyncCreativeRequest<T, 'canonical'>;
+export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'legacy' | 'unknown', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): ProjectedSyncCreativeRequest<T, 'legacy'>;
+export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: CreativeFormatWireMode, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): ProjectedSyncCreativeRequest<T, 'canonical'> | ProjectedSyncCreativeRequest<T, 'legacy'>;
 export type { UndeclaredFormatOptionSelector } from './legacy-routes.mjs';
 /**
  * Looks up a format option the SDK derived from a seller's legacy `format_ids`.

package/dist/lib/v2/projection/creative-delivery.d.ts

@@ -4,6 +4,7 @@ import type { CanonicalFormatLegacyResolver } from './v2-to-v1';
 import type { CanonicalFormatKind, ProjectionDiagnostic, V1FormatId } from './types';
 import type { CanonicalFormatDeclaration } from './legacy-metadata';
 import type { UndeclaredFormatOptionSelector } from './legacy-routes';
+import { type V1FormatDefinition } from './catalog';
 type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, Extract<keyof T, K>> : never;
 /**
  * Primary SDK creative shape. Spell out the named fields rather than using
@@ -254,6 +255,8 @@ export interface CreativeFormatSelectorContainer {
 /** Canonical package/product selectors accepted by the primary sync API. */
 export interface CanonicalCreativeFormatSelectorContainer {
     package_id?: string;
+    /** Target product, used to recover seller declarations after serializing selectors. */
+    product_id?: string;
     format_options?: ReadonlyArray<CanonicalFormatDeclaration>;
     format_option_refs?: ReadonlyArray<FormatOptionReference>;
     format_kind?: CanonicalFormatKind;
@@ -274,15 +277,20 @@ export declare class CreativeFormatCapabilityError extends Error {
     readonly code = "ADCP_CREATIVE_FORMAT_CAPABILITY_CONTRADICTION";
     constructor(message: string);
 }
-export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode?: 'canonical', operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): CanonicalProjectedCreative<T>;
-export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode: 'legacy' | 'unknown', operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): LegacyProjectedCreative<T>;
-export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode: CreativeFormatWireMode, operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): CanonicalProjectedCreative<T> | LegacyProjectedCreative<T>;
-export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: 'canonical', operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedMediaBuyCreativeRequest<T, 'canonical'>;
-export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: 'legacy' | 'unknown', operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedMediaBuyCreativeRequest<T, 'legacy'>;
-export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: CreativeFormatWireMode, operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedMediaBuyCreativeRequest<T, 'canonical'> | ProjectedMediaBuyCreativeRequest<T, 'legacy'>;
-export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'canonical', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'>;
-export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'legacy' | 'unknown', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'legacy'>;
-export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: CreativeFormatWireMode, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'> | ProjectedSyncCreativeRequest<T, 'legacy'>;
+/**
+ * Project identity and asset keys for the selected wire mode. Optional
+ * `legacyFormatDefinitions` override bundled definitions by exact format owner
+ * and ID; ambiguous definitions leave asset keys unchanged.
+ */
+export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode?: 'canonical', operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): CanonicalProjectedCreative<T>;
+export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode: 'legacy' | 'unknown', operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): LegacyProjectedCreative<T>;
+export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode: CreativeFormatWireMode, operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): CanonicalProjectedCreative<T> | LegacyProjectedCreative<T>;
+export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: 'canonical', operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): ProjectedMediaBuyCreativeRequest<T, 'canonical'>;
+export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: 'legacy' | 'unknown', operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): ProjectedMediaBuyCreativeRequest<T, 'legacy'>;
+export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: CreativeFormatWireMode, operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): ProjectedMediaBuyCreativeRequest<T, 'canonical'> | ProjectedMediaBuyCreativeRequest<T, 'legacy'>;
+export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'canonical', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): ProjectedSyncCreativeRequest<T, 'canonical'>;
+export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'legacy' | 'unknown', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): ProjectedSyncCreativeRequest<T, 'legacy'>;
+export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: CreativeFormatWireMode, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver, legacyFormatDefinitions?: readonly V1FormatDefinition[]): ProjectedSyncCreativeRequest<T, 'canonical'> | ProjectedSyncCreativeRequest<T, 'legacy'>;
 export type { UndeclaredFormatOptionSelector } from './legacy-routes';
 /**
  * Looks up a format option the SDK derived from a seller's legacy `format_ids`.

package/dist/lib/v2/projection/creative-delivery.js

@@ -20,6 +20,7 @@ var creative_delivery_exports = {};
 __export(creative_delivery_exports, {
   CreativeFormatCapabilityError: () => CreativeFormatCapabilityError,
   CreativeFormatProjectionError: () => CreativeFormatProjectionError,
+  canUseProductOptionsForCreativeWire: () => canUseProductOptionsForCreativeWire,
   projectCreativeForDelivery: () => projectCreativeForDelivery,
   projectMediaBuyCreativesForDelivery: () => projectMediaBuyCreativesForDelivery,
   projectSyncCreativesForDelivery: () => projectSyncCreativesForDelivery,
@@ -32,6 +33,7 @@ var import_v1_to_v2 = require('./v1-to-v2.js');
 var import_v2_to_v1 = require('./v2-to-v1.js');
 var import_legacy_metadata = require('./legacy-metadata.js');
 var import_jcs = require('../../utils/jcs.js');
+var import_catalog = require('./catalog.js');
 function stripLegacyCreativeIdentity(value) {
   const legacyTokens = /* @__PURE__ */ new Set();
   const legacyUrlTokens = /* @__PURE__ */ new Set();
@@ -590,11 +592,55 @@ function selectLegacyRef(creative, container, canonicalFormatLegacyResolver, ope
   matching = preferMostConstrainedLegacyCandidates(matching, creative);
   return matching.length === 1 ? matching[0].ref : void 0;
 }
-function projectCreative(creative, formatId) {
+function projectLegacyAssetKeys(assetsValue, definition) {
+  const assets = record(assetsValue);
+  if (!assets || !Array.isArray(definition?.assets)) return assetsValue;
+  const slots = definition.assets.filter((slot) => record(slot) !== void 0);
+  if (slots.some((slot) => slot.item_type !== void 0 && slot.item_type !== "individual")) return assetsValue;
+  const declaredIds = new Set(slots.map((slot) => slot.asset_id));
+  const availableSlots = slots.filter(
+    (slot) => (slot.item_type === void 0 || slot.item_type === "individual") && typeof slot.asset_id === "string" && slot.asset_id.length > 0 && !Object.hasOwn(assets, slot.asset_id)
+  );
+  const targetBySource = /* @__PURE__ */ new Map();
+  const sourcesByTarget = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(assets)) {
+    if (declaredIds.has(key)) continue;
+    const asset = record(value);
+    if (!asset || typeof asset.asset_type !== "string") continue;
+    const matches = availableSlots.filter((slot) => {
+      if (slot.asset_type !== asset.asset_type) return false;
+      if (asset.asset_type === "url") {
+        return typeof asset.url_type === "string" && asset.url_type === slot.requirements?.url_type;
+      }
+      if (asset.asset_type === "pixel_tracker") {
+        return typeof asset.event === "string" && asset.event === slot.event && (asset.event !== "custom" || typeof asset.custom_event_name === "string" && asset.custom_event_name === slot.custom_event_name);
+      }
+      return true;
+    });
+    if (matches.length !== 1) continue;
+    const target = matches[0].asset_id;
+    targetBySource.set(key, target);
+    const sources = sourcesByTarget.get(target) ?? [];
+    sources.push(key);
+    sourcesByTarget.set(target, sources);
+  }
+  for (const sources of sourcesByTarget.values()) {
+    if (sources.length > 1) for (const source of sources) targetBySource.delete(source);
+  }
+  if (targetBySource.size === 0) return assetsValue;
+  return Object.fromEntries(Object.entries(assets).map(([key, value]) => [targetBySource.get(key) ?? key, value]));
+}
+function projectCreative(creative, formatId, legacyFormatDefinitions) {
   const next = { ...creative };
   delete next.format_kind;
   delete next.format_option_ref;
   next.format_id = { ...formatId };
+  const supplied = legacyFormatDefinitions?.filter((definition2) => {
+    const ref = legacyRef(record(definition2)?.format_id);
+    return ref !== void 0 && sameLegacyIdentity(ref, formatId);
+  });
+  const definition = supplied?.length ? supplied.length === 1 ? supplied[0] : void 0 : (0, import_catalog.lookupV1Format)(formatId);
+  if (Object.hasOwn(creative, "assets")) next.assets = projectLegacyAssetKeys(creative.assets, definition);
   return next;
 }
 function dedupeLegacyRefs(refs) {
@@ -828,7 +874,7 @@ function canonicalizeCreative(creative, selectorContainer, operation, legacyForm
   }
   return next;
 }
-function projectCreativeForDelivery(creative, selectorContainer, wireMode = "canonical", operation = "creative_delivery", legacyFormatConverter, canonicalFormatLegacyResolver) {
+function projectCreativeForDelivery(creative, selectorContainer, wireMode = "canonical", operation = "creative_delivery", legacyFormatConverter, canonicalFormatLegacyResolver, legacyFormatDefinitions) {
   const inputRecord = creative;
   const originalLegacyRef = legacyRef(inputRecord.format_id);
   const creativeRecord = canonicalizeCreative(inputRecord, selectorContainer, operation, legacyFormatConverter);
@@ -836,7 +882,11 @@ function projectCreativeForDelivery(creative, selectorContainer, wireMode = "can
   if (originalLegacyRef) {
     const selectedOriginal = selectLegacyRef(inputRecord, selectorContainer, canonicalFormatLegacyResolver, operation);
     if (selectedOriginal) {
-      return projectCreative(creativeRecord, selectedOriginal);
+      return projectCreative(
+        creativeRecord,
+        selectedOriginal,
+        legacyFormatDefinitions
+      );
     }
     throw new CreativeFormatProjectionError(
       operation,
@@ -845,7 +895,8 @@ function projectCreativeForDelivery(creative, selectorContainer, wireMode = "can
     );
   }
   const formatId = selectLegacyRef(creativeRecord, selectorContainer, canonicalFormatLegacyResolver, operation);
-  if (formatId) return projectCreative(creativeRecord, formatId);
+  if (formatId)
+    return projectCreative(creativeRecord, formatId, legacyFormatDefinitions);
   if (typeof creativeRecord.format_kind === "string") {
     const creativeId = typeof creativeRecord.creative_id === "string" ? creativeRecord.creative_id : "(unknown)";
     const allCandidates = candidatesFromContainer(selectorContainer, canonicalFormatLegacyResolver, operation);
@@ -880,10 +931,19 @@ function projectCreativeForDelivery(creative, selectorContainer, wireMode = "can
         "canonical format legacy resolver returned an invalid or ambiguous creative mapping"
       );
     }
-    if (resolved) return projectCreative(creativeRecord, resolved[0]);
+    if (resolved)
+      return projectCreative(
+        creativeRecord,
+        resolved[0],
+        legacyFormatDefinitions
+      );
     const pinned = optionReference(creativeRecord.format_option_ref) !== void 0;
     if (candidates.length === 1 && !pinned) {
-      return projectCreative(creativeRecord, candidates[0].ref);
+      return projectCreative(
+        creativeRecord,
+        candidates[0].ref,
+        legacyFormatDefinitions
+      );
     }
     if (candidates.length > 1) {
       throw new CreativeFormatProjectionError(
@@ -897,7 +957,7 @@ function projectCreativeForDelivery(creative, selectorContainer, wireMode = "can
   }
   return creative;
 }
-function projectMediaBuyCreativesForDelivery(request, wireMode = "canonical", operation = "create_media_buy", legacyFormatConverter, canonicalFormatLegacyResolver) {
+function projectMediaBuyCreativesForDelivery(request, wireMode = "canonical", operation = "create_media_buy", legacyFormatConverter, canonicalFormatLegacyResolver, legacyFormatDefinitions) {
   const requestRecord = record(request);
   if (!requestRecord) return request;
   let changed = false;
@@ -917,7 +977,8 @@ function projectMediaBuyCreativesForDelivery(request, wireMode = "canonical", op
           wireMode,
           operation,
           legacyFormatConverter,
-          canonicalFormatLegacyResolver
+          canonicalFormatLegacyResolver,
+          legacyFormatDefinitions
         );
         if (projected !== creativeValue) changed = true;
         return projected;
@@ -935,7 +996,7 @@ function projectMediaBuyCreativesForDelivery(request, wireMode = "canonical", op
   }
   return changed ? next : request;
 }
-function projectSyncCreativesForDelivery(request, selectorContainers, wireMode = "canonical", legacyFormatConverter, canonicalFormatLegacyResolver) {
+function projectSyncCreativesForDelivery(request, selectorContainers, wireMode = "canonical", legacyFormatConverter, canonicalFormatLegacyResolver, legacyFormatDefinitions) {
   const requestRecord = record(request);
   if (!requestRecord || !Array.isArray(requestRecord.creatives)) {
     return request;
@@ -964,7 +1025,8 @@ function projectSyncCreativesForDelivery(request, selectorContainers, wireMode =
       wireMode,
       "sync_creatives",
       legacyFormatConverter,
-      canonicalFormatLegacyResolver
+      canonicalFormatLegacyResolver,
+      legacyFormatDefinitions
     );
     if (projected !== creativeValue) changed = true;
     return projected;
@@ -1134,10 +1196,16 @@ function resolveCreativeFormatWireMode(capabilities, negotiatedVersion) {
   if (explicitCanonical === false) return "legacy";
   return "unknown";
 }
+function canUseProductOptionsForCreativeWire(capabilities, requestedVersion) {
+  const caps = record(capabilities);
+  const negotiated = mutuallyServedRelease(caps, record(caps?._raw), requestedVersion);
+  return negotiated?.major === 3 && negotiated.minor === 1;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CreativeFormatCapabilityError,
   CreativeFormatProjectionError,
+  canUseProductOptionsForCreativeWire,
   projectCreativeForDelivery,
   projectMediaBuyCreativesForDelivery,
   projectSyncCreativesForDelivery,

package/dist/lib/v2/projection/creative-delivery.mjs

@@ -12,6 +12,7 @@ import {
   transferLegacyCreativeMetadata
 } from "./legacy-metadata.mjs";
 import { canonicalize as canonicalizeJson } from "../../utils/jcs.mjs";
+import { lookupV1Format } from "./catalog.mjs";
 function stripLegacyCreativeIdentity(value) {
   const legacyTokens = /* @__PURE__ */ new Set();
   const legacyUrlTokens = /* @__PURE__ */ new Set();
@@ -570,11 +571,55 @@ function selectLegacyRef(creative, container, canonicalFormatLegacyResolver, ope
   matching = preferMostConstrainedLegacyCandidates(matching, creative);
   return matching.length === 1 ? matching[0].ref : void 0;
 }
-function projectCreative(creative, formatId) {
+function projectLegacyAssetKeys(assetsValue, definition) {
+  const assets = record(assetsValue);
+  if (!assets || !Array.isArray(definition?.assets)) return assetsValue;
+  const slots = definition.assets.filter((slot) => record(slot) !== void 0);
+  if (slots.some((slot) => slot.item_type !== void 0 && slot.item_type !== "individual")) return assetsValue;
+  const declaredIds = new Set(slots.map((slot) => slot.asset_id));
+  const availableSlots = slots.filter(
+    (slot) => (slot.item_type === void 0 || slot.item_type === "individual") && typeof slot.asset_id === "string" && slot.asset_id.length > 0 && !Object.hasOwn(assets, slot.asset_id)
+  );
+  const targetBySource = /* @__PURE__ */ new Map();
+  const sourcesByTarget = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(assets)) {
+    if (declaredIds.has(key)) continue;
+    const asset = record(value);
+    if (!asset || typeof asset.asset_type !== "string") continue;
+    const matches = availableSlots.filter((slot) => {
+      if (slot.asset_type !== asset.asset_type) return false;
+      if (asset.asset_type === "url") {
+        return typeof asset.url_type === "string" && asset.url_type === slot.requirements?.url_type;
+      }
+      if (asset.asset_type === "pixel_tracker") {
+        return typeof asset.event === "string" && asset.event === slot.event && (asset.event !== "custom" || typeof asset.custom_event_name === "string" && asset.custom_event_name === slot.custom_event_name);
+      }
+      return true;
+    });
+    if (matches.length !== 1) continue;
+    const target = matches[0].asset_id;
+    targetBySource.set(key, target);
+    const sources = sourcesByTarget.get(target) ?? [];
+    sources.push(key);
+    sourcesByTarget.set(target, sources);
+  }
+  for (const sources of sourcesByTarget.values()) {
+    if (sources.length > 1) for (const source of sources) targetBySource.delete(source);
+  }
+  if (targetBySource.size === 0) return assetsValue;
+  return Object.fromEntries(Object.entries(assets).map(([key, value]) => [targetBySource.get(key) ?? key, value]));
+}
+function projectCreative(creative, formatId, legacyFormatDefinitions) {
   const next = { ...creative };
   delete next.format_kind;
   delete next.format_option_ref;
   next.format_id = { ...formatId };
+  const supplied = legacyFormatDefinitions?.filter((definition2) => {
+    const ref = legacyRef(record(definition2)?.format_id);
+    return ref !== void 0 && sameLegacyIdentity(ref, formatId);
+  });
+  const definition = supplied?.length ? supplied.length === 1 ? supplied[0] : void 0 : lookupV1Format(formatId);
+  if (Object.hasOwn(creative, "assets")) next.assets = projectLegacyAssetKeys(creative.assets, definition);
   return next;
 }
 function dedupeLegacyRefs(refs) {
@@ -808,7 +853,7 @@ function canonicalizeCreative(creative, selectorContainer, operation, legacyForm
   }
   return next;
 }
-function projectCreativeForDelivery(creative, selectorContainer, wireMode = "canonical", operation = "creative_delivery", legacyFormatConverter, canonicalFormatLegacyResolver) {
+function projectCreativeForDelivery(creative, selectorContainer, wireMode = "canonical", operation = "creative_delivery", legacyFormatConverter, canonicalFormatLegacyResolver, legacyFormatDefinitions) {
   const inputRecord = creative;
   const originalLegacyRef = legacyRef(inputRecord.format_id);
   const creativeRecord = canonicalizeCreative(inputRecord, selectorContainer, operation, legacyFormatConverter);
@@ -816,7 +861,11 @@ function projectCreativeForDelivery(creative, selectorContainer, wireMode = "can
   if (originalLegacyRef) {
     const selectedOriginal = selectLegacyRef(inputRecord, selectorContainer, canonicalFormatLegacyResolver, operation);
     if (selectedOriginal) {
-      return projectCreative(creativeRecord, selectedOriginal);
+      return projectCreative(
+        creativeRecord,
+        selectedOriginal,
+        legacyFormatDefinitions
+      );
     }
     throw new CreativeFormatProjectionError(
       operation,
@@ -825,7 +874,8 @@ function projectCreativeForDelivery(creative, selectorContainer, wireMode = "can
     );
   }
   const formatId = selectLegacyRef(creativeRecord, selectorContainer, canonicalFormatLegacyResolver, operation);
-  if (formatId) return projectCreative(creativeRecord, formatId);
+  if (formatId)
+    return projectCreative(creativeRecord, formatId, legacyFormatDefinitions);
   if (typeof creativeRecord.format_kind === "string") {
     const creativeId = typeof creativeRecord.creative_id === "string" ? creativeRecord.creative_id : "(unknown)";
     const allCandidates = candidatesFromContainer(selectorContainer, canonicalFormatLegacyResolver, operation);
@@ -860,10 +910,19 @@ function projectCreativeForDelivery(creative, selectorContainer, wireMode = "can
         "canonical format legacy resolver returned an invalid or ambiguous creative mapping"
       );
     }
-    if (resolved) return projectCreative(creativeRecord, resolved[0]);
+    if (resolved)
+      return projectCreative(
+        creativeRecord,
+        resolved[0],
+        legacyFormatDefinitions
+      );
     const pinned = optionReference(creativeRecord.format_option_ref) !== void 0;
     if (candidates.length === 1 && !pinned) {
-      return projectCreative(creativeRecord, candidates[0].ref);
+      return projectCreative(
+        creativeRecord,
+        candidates[0].ref,
+        legacyFormatDefinitions
+      );
     }
     if (candidates.length > 1) {
       throw new CreativeFormatProjectionError(
@@ -877,7 +936,7 @@ function projectCreativeForDelivery(creative, selectorContainer, wireMode = "can
   }
   return creative;
 }
-function projectMediaBuyCreativesForDelivery(request, wireMode = "canonical", operation = "create_media_buy", legacyFormatConverter, canonicalFormatLegacyResolver) {
+function projectMediaBuyCreativesForDelivery(request, wireMode = "canonical", operation = "create_media_buy", legacyFormatConverter, canonicalFormatLegacyResolver, legacyFormatDefinitions) {
   const requestRecord = record(request);
   if (!requestRecord) return request;
   let changed = false;
@@ -897,7 +956,8 @@ function projectMediaBuyCreativesForDelivery(request, wireMode = "canonical", op
           wireMode,
           operation,
           legacyFormatConverter,
-          canonicalFormatLegacyResolver
+          canonicalFormatLegacyResolver,
+          legacyFormatDefinitions
         );
         if (projected !== creativeValue) changed = true;
         return projected;
@@ -915,7 +975,7 @@ function projectMediaBuyCreativesForDelivery(request, wireMode = "canonical", op
   }
   return changed ? next : request;
 }
-function projectSyncCreativesForDelivery(request, selectorContainers, wireMode = "canonical", legacyFormatConverter, canonicalFormatLegacyResolver) {
+function projectSyncCreativesForDelivery(request, selectorContainers, wireMode = "canonical", legacyFormatConverter, canonicalFormatLegacyResolver, legacyFormatDefinitions) {
   const requestRecord = record(request);
   if (!requestRecord || !Array.isArray(requestRecord.creatives)) {
     return request;
@@ -944,7 +1004,8 @@ function projectSyncCreativesForDelivery(request, selectorContainers, wireMode =
       wireMode,
       "sync_creatives",
       legacyFormatConverter,
-      canonicalFormatLegacyResolver
+      canonicalFormatLegacyResolver,
+      legacyFormatDefinitions
     );
     if (projected !== creativeValue) changed = true;
     return projected;
@@ -1114,9 +1175,15 @@ function resolveCreativeFormatWireMode(capabilities, negotiatedVersion) {
   if (explicitCanonical === false) return "legacy";
   return "unknown";
 }
+function canUseProductOptionsForCreativeWire(capabilities, requestedVersion) {
+  const caps = record(capabilities);
+  const negotiated = mutuallyServedRelease(caps, record(caps?._raw), requestedVersion);
+  return negotiated?.major === 3 && negotiated.minor === 1;
+}
 export {
   CreativeFormatCapabilityError,
   CreativeFormatProjectionError,
+  canUseProductOptionsForCreativeWire,
   projectCreativeForDelivery,
   projectMediaBuyCreativesForDelivery,
   projectSyncCreativesForDelivery,