@adcp/sdk 12.1.1 → 13.0.0-rc.0

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/v2/projection/creative-delivery.ts"],"sourcesContent":["import type {\n  CreativeAsset,\n  CreateMediaBuyRequest,\n  CreateMediaBuyResponse,\n  FormatOptionReference,\n  GetProductsRequest,\n  GetProductsResponse,\n  GetCreativeDeliveryResponse,\n  GetMediaBuyDeliveryResponse,\n  GetMediaBuysResponse,\n  CreativeFilters,\n  ListCreativesResponse,\n  ListCreativesRequest,\n  PackageRequest,\n  PackageUpdate,\n  Package,\n  Placement,\n  Product,\n  SyncCreativesRequest,\n  SyncCreativesResponse,\n  UpdateMediaBuyRequest,\n  UpdateMediaBuyResponse,\n} from '../../types/tools.generated';\nimport { projectV1ProductToV2, resolveCanonicalFormatKind } from './v1-to-v2';\nimport type { LegacyFormatConverter } from './v1-to-v2';\nimport { CanonicalFormatLegacyResolutionError, resolveCanonicalFormatLegacyRefs } from './v2-to-v1';\nimport type { CanonicalFormatLegacyResolver } from './v2-to-v1';\nimport type { CanonicalFormatKind, ProjectionDiagnostic, V1FormatId } from './types';\nimport {\n  legacyFormatRefsForDeclaration,\n  selectedFormatOptions,\n  transferLegacyCreativeMetadata,\n} from './legacy-metadata';\nimport type { CanonicalFormatDeclaration } from './legacy-metadata';\n\ntype DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, Extract<keyof T, K>> : never;\n\n/** Primary SDK creative shape. Legacy creative identity is a wire-adapter concern. */\nexport type CanonicalCreativeAsset = Omit<CanonicalCreativeResponse<CreativeAsset>, 'format_kind'> & {\n  format_kind: CanonicalFormatKind;\n  format_id?: never;\n};\n\n/** Explicit compatibility-only creative shape used at a legacy wire boundary. */\nexport type LegacyCreativeAsset = Omit<CreativeAsset, 'format_id' | 'format_kind' | 'format_option_ref'> & {\n  format_id: V1FormatId;\n  format_kind?: never;\n  format_option_ref?: never;\n};\n\nexport type CanonicalPackageRequest = DistributiveOmit<\n  CanonicalCreativeResponse<PackageRequest>,\n  'creatives' | 'format_ids'\n> & {\n  creatives?: CanonicalCreativeAsset[];\n  format_ids?: never;\n};\nexport type NonEmptyCanonicalFormatDeclarations = [CanonicalFormatDeclaration, ...CanonicalFormatDeclaration[]];\nexport type CanonicalPlacement = Omit<CanonicalCreativeResponse<Placement>, 'format_ids' | 'format_options'> & {\n  format_ids?: never;\n  format_options?: NonEmptyCanonicalFormatDeclarations;\n};\nexport type CanonicalProduct = Omit<\n  CanonicalCreativeResponse<Product>,\n  'format_ids' | 'format_options' | 'placements'\n> & {\n  product_id: string;\n  format_ids?: never;\n  format_options: NonEmptyCanonicalFormatDeclarations;\n  placements?: CanonicalPlacement[];\n};\ntype CanonicalGetProductsField = Exclude<NonNullable<GetProductsRequest['fields']>[number], 'format_ids'>;\n/** Primary product discovery request cannot ask the SDK to expose legacy format IDs. */\nexport type CanonicalGetProductsRequest = Omit<GetProductsRequest, 'fields'> & {\n  fields?: CanonicalGetProductsField[];\n};\nexport type CanonicalGetProductsResponse = Omit<CanonicalCreativeResponse<GetProductsResponse>, 'products'> & {\n  products: CanonicalProduct[];\n  projection: { diagnostics: ProjectionDiagnostic[] };\n};\nexport type CanonicalPackageUpdate = Omit<CanonicalCreativeResponse<PackageUpdate>, 'creatives'> & {\n  creatives?: CanonicalCreativeAsset[];\n};\nexport type CanonicalPackage = CanonicalCreativeResponse<Package>;\nexport type CanonicalCreateMediaBuyRequest = Omit<CanonicalCreativeResponse<CreateMediaBuyRequest>, 'packages'> & {\n  packages?: CanonicalPackageRequest[];\n};\nexport type CanonicalUpdateMediaBuyRequest = Omit<\n  CanonicalCreativeResponse<UpdateMediaBuyRequest>,\n  'packages' | 'new_packages'\n> & {\n  packages?: CanonicalPackageUpdate[];\n  new_packages?: CanonicalPackageRequest[];\n};\nexport type CanonicalSyncCreativesRequest = Omit<CanonicalCreativeResponse<SyncCreativesRequest>, 'creatives'> & {\n  creatives: CanonicalCreativeAsset[];\n};\nexport type CanonicalListedCreative = Omit<\n  CanonicalCreativeResponse<ListCreativesResponse['creatives'][number]>,\n  'format_id' | 'format_kind' | 'format_option_ref'\n> & {\n  format_kind: CanonicalFormatKind;\n  format_option_ref?: FormatOptionReference;\n  format_id?: never;\n};\nexport type CanonicalListCreativesResponse = Omit<CanonicalCreativeResponse<ListCreativesResponse>, 'creatives'> & {\n  creatives: CanonicalListedCreative[];\n};\nexport type CanonicalCreateMediaBuyResponse = CanonicalCreativeResponse<CreateMediaBuyResponse>;\nexport type CanonicalUpdateMediaBuyResponse = CanonicalCreativeResponse<UpdateMediaBuyResponse>;\nexport type CanonicalSyncCreativesResponse = CanonicalCreativeResponse<SyncCreativesResponse>;\nexport type CanonicalGetMediaBuysResponse = CanonicalCreativeResponse<GetMediaBuysResponse>;\nexport type CanonicalGetMediaBuyDeliveryResponse = CanonicalCreativeResponse<GetMediaBuyDeliveryResponse>;\nexport type CanonicalGetCreativeDeliveryResponse = CanonicalCreativeResponse<GetCreativeDeliveryResponse>;\n\nexport type CanonicalCreativeFilters = Omit<CanonicalCreativeResponse<CreativeFilters>, 'format_ids'> & {\n  format_ids?: never;\n};\n\ntype CanonicalListCreativeField = Exclude<NonNullable<ListCreativesRequest['fields']>[number], 'format_id'>;\n\n/** Primary list request: legacy named-format filters and response fields are migration-only. */\nexport type CanonicalListCreativesRequest = Omit<\n  CanonicalCreativeResponse<ListCreativesRequest>,\n  'filters' | 'fields'\n> & {\n  filters?: CanonicalCreativeFilters;\n  fields?: CanonicalListCreativeField[];\n};\n\ntype IsLegacyCreativeIdentityKey<K extends PropertyKey> = K extends string\n  ? K extends '_message' | `${string}format_id${string}` | `${string}v1_format_ref${string}`\n    ? true\n    : false\n  : false;\n\n/** Recursively removes legacy creative routing identity from primary response types. */\nexport type CanonicalCreativeResponse<T> = T extends (...args: never[]) => unknown\n  ? T\n  : T extends readonly (infer TItem)[]\n    ? CanonicalCreativeResponse<TItem>[]\n    : T extends object\n      ? {\n          [K in keyof T as IsLegacyCreativeIdentityKey<K> extends true ? never : K]: CanonicalCreativeResponse<T[K]>;\n        }\n      : T;\n\n/** Runtime counterpart to {@link CanonicalCreativeResponse}. */\nexport function stripLegacyCreativeIdentity<T>(value: T): CanonicalCreativeResponse<T> {\n  const legacyTokens = new Set<string>();\n  const legacyUrlTokens = new Set<string>();\n  const canonicalKinds = new Set<string>([\n    'image',\n    'html5',\n    'display_tag',\n    'image_carousel',\n    'video_hosted',\n    'video_vast',\n    'audio_hosted',\n    'audio_daast',\n    'sponsored_placement',\n    'native_in_feed',\n    'responsive_creative',\n    'agent_placement',\n    'custom',\n  ]);\n  const creativeIdentityKey = (key: string): boolean =>\n    key === '_message' || /(^|_)(?:format_ids?|v1_format_ref)($|_)/.test(key);\n  const ownDataValue = (owner: Record<string, unknown>, key: string): unknown => {\n    const descriptor = Object.getOwnPropertyDescriptor(owner, key);\n    return descriptor && 'value' in descriptor ? descriptor.value : undefined;\n  };\n  const nonCreativeAgentContext = (key: string | undefined): boolean =>\n    typeof key === 'string' &&\n    !/(^|_)(?:creative|format|legacy)($|_)/.test(key) &&\n    /(^|_)(?:agents?|agent_details|agent_info)($|_)/.test(key);\n  const nonCreativeSignalContext = (owner: Record<string, unknown>, key: string | undefined): boolean =>\n    ownDataValue(owner, 'source') === 'agent' && typeof key === 'string' && /(^|_)signal_ids?($|_)/.test(key);\n  const nonCreativeListContext = (owner: Record<string, unknown>, key: string | undefined): boolean =>\n    typeof ownDataValue(owner, 'list_id') === 'string' &&\n    typeof key === 'string' &&\n    /(^|_)(?:property_list|collection_list|list_ref)($|_)/.test(key);\n  const explicitNonCreativeContextKey = (key: string | undefined): boolean =>\n    nonCreativeAgentContext(key) ||\n    (typeof key === 'string' && /(^|_)(?:signal_ids?|property_list|collection_list|list_ref)($|_)/.test(key));\n  const standaloneLegacyTuple = (owner: Record<string, unknown>, ownerKey?: string): boolean => {\n    if (\n      nonCreativeAgentContext(ownerKey) ||\n      nonCreativeSignalContext(owner, ownerKey) ||\n      nonCreativeListContext(owner, ownerKey)\n    ) {\n      return false;\n    }\n    if (typeof ownDataValue(owner, 'agent_url') !== 'string' || typeof ownDataValue(owner, 'id') !== 'string') {\n      return false;\n    }\n    return true;\n  };\n  const preservesNonCreativeAgentUrl = (key: string, owner: Record<string, unknown>, ownerKey?: string): boolean => {\n    if (!/(^|_)agent_url($|_)/.test(key)) return false;\n    if (key === 'agent_url') {\n      return (\n        nonCreativeAgentContext(ownerKey) ||\n        nonCreativeSignalContext(owner, ownerKey) ||\n        nonCreativeListContext(owner, ownerKey) ||\n        (typeof ownDataValue(owner, 'id') === 'string' && !standaloneLegacyTuple(owner, ownerKey))\n      );\n    }\n    return !/(^|_)(?:creative|format|legacy|offending|target|input|output)($|_)/.test(key);\n  };\n  const legacyKey = (key: string, owner: Record<string, unknown>, ownerKey?: string): boolean => {\n    if (creativeIdentityKey(key)) return true;\n    if (!/(^|_)agent_url($|_)/.test(key)) return false;\n    if (preservesNonCreativeAgentUrl(key, owner, ownerKey)) return false;\n    const value = ownDataValue(owner, key);\n    // Composite agent URL fields are used by several non-creative protocol\n    // domains. Remove them only when their value is known to belong to a\n    // legacy creative identity collected elsewhere in this payload.\n    return typeof value === 'string' && legacyTokens.has(value);\n  };\n  const collectStrings = (current: unknown, seen = new WeakSet<object>(), ownerKey?: string): void => {\n    if (typeof current === 'string') {\n      if (current.length > 1) {\n        legacyTokens.add(current);\n        if (ownerKey === 'agent_url' || /^https?:\\/\\//i.test(current)) legacyUrlTokens.add(current);\n      }\n      return;\n    }\n    if (current === null || typeof current !== 'object' || seen.has(current)) return;\n    seen.add(current);\n    if (Array.isArray(current)) {\n      for (const child of current) collectStrings(child, seen, ownerKey);\n      return;\n    }\n    for (const key of Reflect.ownKeys(current)) {\n      const descriptor = Object.getOwnPropertyDescriptor(current, key);\n      if (!descriptor || !('value' in descriptor)) continue;\n      collectStrings(descriptor.value, seen, typeof key === 'string' ? key : ownerKey);\n    }\n  };\n  const tokenSeenByContext = {\n    default: new WeakSet<object>(),\n    nonCreativeAgent: new WeakSet<object>(),\n  };\n  const collectLegacyTokens = (current: unknown, ownerKey?: string): void => {\n    const seen = explicitNonCreativeContextKey(ownerKey)\n      ? tokenSeenByContext.nonCreativeAgent\n      : tokenSeenByContext.default;\n    if (current === null || typeof current !== 'object' || seen.has(current)) return;\n    seen.add(current);\n    if (Array.isArray(current)) {\n      for (const child of current) collectLegacyTokens(child, ownerKey);\n      return;\n    }\n    const owner = current as Record<string, unknown>;\n    if (standaloneLegacyTuple(owner, ownerKey)) collectStrings(owner, new WeakSet<object>(), ownerKey);\n    for (const key of Object.getOwnPropertyNames(owner)) {\n      const descriptor = Object.getOwnPropertyDescriptor(owner, key);\n      if (!descriptor || !('value' in descriptor)) continue;\n      const child = descriptor.value;\n      if (creativeIdentityKey(key)) collectStrings(child);\n      else collectLegacyTokens(child, key);\n    }\n  };\n  collectLegacyTokens(value);\n\n  const sanitizeText = (text: string, ownerKey?: string): string => {\n    const mentionsLegacyIdentity =\n      /\\b(?:format_id|format_ids|target_format_ids|input_format_ids|output_format_ids|v1_format_ref|agent_url)\\b/.test(\n        text\n      );\n    let safe = text;\n    if (mentionsLegacyIdentity) {\n      // Diagnostics sometimes repeat only the flattened identity and omit the\n      // structured field that supplied it. Fail closed for those orphan\n      // values while leaving unrelated URLs in ordinary messages untouched.\n      safe = safe.replace(/\\bhttps?:\\/\\/[^\\s\"'`<>]+/g, '[legacy creative identity]');\n      safe = safe.replace(\n        /(\\b(?:format_ids?|v1_format_ref|agent_url)\\b(?:\\s+(?:was|is|from))?\\s*[:=]?\\s*[\"'`]?)\\b[a-zA-Z0-9][a-zA-Z0-9_.-]{1,}/g,\n        '$1[legacy creative identity]'\n      );\n    }\n    safe = safe.replace(\n      /\\b(?:format_id|format_ids|target_format_ids|input_format_ids|output_format_ids|v1_format_ref|agent_url)\\b/g,\n      'legacy creative identity'\n    );\n    for (const token of [...legacyUrlTokens].sort((left, right) => right.length - left.length)) {\n      safe = safe.split(token).join('[legacy creative identity]');\n    }\n    const diagnosticContext =\n      mentionsLegacyIdentity ||\n      (typeof ownerKey === 'string' &&\n        /(^|_)(?:message|question|prompt|error|reason|summary|context|stack|diagnostic)($|_)/.test(ownerKey));\n    if (diagnosticContext) {\n      for (const token of [...legacyTokens].sort((left, right) => right.length - left.length)) {\n        if (legacyUrlTokens.has(token) || canonicalKinds.has(token)) continue;\n        if (token.length < 8 && !/[_:/. -]/.test(token)) continue;\n        safe = safe.split(token).join('[legacy creative identity]');\n      }\n    }\n    return safe;\n  };\n\n  // The same object can appear once under an explicit agent field and once\n  // under an ambiguous extension field. Cache by policy context so an allowed\n  // agent occurrence cannot make a later ambiguous tuple fail open (or vice\n  // versa based on property order).\n  const seenByContext = {\n    default: new WeakMap<object, unknown>(),\n    nonCreativeAgent: new WeakMap<object, unknown>(),\n  };\n  const hasCustomToJSON = (candidate: object): boolean => {\n    let cursor: object | null = candidate;\n    while (cursor) {\n      const descriptor = Object.getOwnPropertyDescriptor(cursor, 'toJSON');\n      if (descriptor) return !('value' in descriptor) || typeof descriptor.value === 'function';\n      cursor = Object.getPrototypeOf(cursor) as object | null;\n    }\n    return false;\n  };\n  const strip = (current: unknown, ownerKey?: string): unknown => {\n    if (typeof current === 'string') return sanitizeText(current, ownerKey);\n    if (current === null || typeof current !== 'object') return current;\n    const seen = explicitNonCreativeContextKey(ownerKey) ? seenByContext.nonCreativeAgent : seenByContext.default;\n    const cached = seen.get(current);\n    if (cached !== undefined) return cached;\n    if (Array.isArray(current)) {\n      const result: unknown[] = [];\n      seen.set(current, result);\n      const needsSafeToJSON = hasCustomToJSON(current);\n      let changed = needsSafeToJSON || Object.getPrototypeOf(current) !== Array.prototype;\n      for (const key of Reflect.ownKeys(current)) {\n        if (key === 'length') continue;\n        const descriptor = Object.getOwnPropertyDescriptor(current, key);\n        if (!descriptor) continue;\n        if (!('value' in descriptor)) {\n          changed = true;\n          continue;\n        }\n        if (key === 'toJSON' && typeof descriptor.value === 'function') {\n          changed = true;\n          continue;\n        }\n        if (typeof key === 'string' && legacyKey(key, current as unknown as Record<string, unknown>, ownerKey)) {\n          changed = true;\n          continue;\n        }\n        const safe = strip(descriptor.value, typeof key === 'string' && !/^\\d+$/.test(key) ? key : ownerKey);\n        if (safe !== descriptor.value) changed = true;\n        Object.defineProperty(result, key, { ...descriptor, value: safe });\n      }\n      result.length = current.length;\n      if (!changed) {\n        seen.set(current, current);\n        return current;\n      }\n      if (needsSafeToJSON) {\n        Object.defineProperty(result, 'toJSON', {\n          configurable: true,\n          enumerable: false,\n          value: () => Array.from(result),\n        });\n      }\n      transferLegacyCreativeMetadata(current, result);\n      return result;\n    }\n    const prototype = Object.getPrototypeOf(current);\n    const plain = prototype === Object.prototype || prototype === null;\n    const safePrototype =\n      prototype === null ? null : Error.prototype.isPrototypeOf(current) ? Error.prototype : Object.prototype;\n    // Never retain an adopter-controlled prototype. Inherited getters and\n    // methods are behavior, not inspected data, and can reveal legacy identity\n    // after this boundary has supposedly been sanitized.\n    const result: Record<string | symbol, unknown> = Object.create(safePrototype);\n    seen.set(current, result);\n    const owner = current as Record<string, unknown>;\n    if (standaloneLegacyTuple(owner, ownerKey)) {\n      const empty = {};\n      seen.set(current, empty);\n      return empty;\n    }\n    const needsSafeToJSON = hasCustomToJSON(current);\n    let changed = !plain || needsSafeToJSON;\n    const keys: Array<string | symbol> = Reflect.ownKeys(current);\n    for (const key of keys) {\n      const descriptor = Object.getOwnPropertyDescriptor(current, key);\n      if (!descriptor) continue;\n      if (!('value' in descriptor)) {\n        // Never reflect accessors across the canonical boundary. Evaluating a\n        // retained getter later could reveal a legacy identity that was not\n        // present while this object was inspected (and may run adopter code).\n        changed = true;\n        continue;\n      }\n      const child = descriptor.value;\n      if (typeof key === 'symbol') {\n        const safe = strip(child);\n        if (safe !== child) changed = true;\n        if (!plain) Object.defineProperty(result, key, { ...descriptor, value: safe });\n        continue;\n      }\n      if (key === 'toJSON' && typeof child === 'function') {\n        changed = true;\n        continue;\n      }\n      if (legacyKey(key, owner, ownerKey)) {\n        changed = true;\n        continue;\n      }\n      const safe = preservesNonCreativeAgentUrl(key, owner, ownerKey) ? child : strip(child, key);\n      if (safe !== child) changed = true;\n      if (plain && typeof key === 'string' && descriptor.enumerable) result[key] = safe;\n      else Object.defineProperty(result, key, { ...descriptor, value: safe });\n    }\n    if (!changed) {\n      seen.set(current, current);\n      return current;\n    }\n    if (needsSafeToJSON) {\n      Object.defineProperty(result, 'toJSON', {\n        configurable: true,\n        enumerable: false,\n        value: () => {\n          const serialized: Record<string, unknown> = {};\n          for (const key of Object.keys(result)) serialized[key] = result[key];\n          return serialized;\n        },\n      });\n    }\n    transferLegacyCreativeMetadata(current, result);\n    return result;\n  };\n  return strip(value) as CanonicalCreativeResponse<T>;\n}\n\nexport type CanonicalProjectedCreative<T> = Omit<T, 'format_id' | 'format_kind'> & {\n  format_kind: CanonicalFormatKind;\n  format_id?: never;\n};\nexport type LegacyProjectedCreative<T> = Omit<T, 'format_id' | 'format_kind' | 'format_option_ref'> & {\n  format_id: V1FormatId;\n  format_kind?: never;\n  format_option_ref?: never;\n};\n\ntype ProjectedCreativeArray<T, TMode extends 'canonical' | 'legacy'> =\n  T extends ReadonlyArray<infer TCreative>\n    ? Array<TMode extends 'canonical' ? CanonicalProjectedCreative<TCreative> : LegacyProjectedCreative<TCreative>>\n    : T;\ntype ReplaceCreatives<T, TMode extends 'canonical' | 'legacy'> = T extends object\n  ? 'creatives' extends keyof T\n    ? Omit<T, 'creatives'> &\n        (Record<never, never> extends Pick<T, 'creatives'>\n          ? { creatives?: ProjectedCreativeArray<T['creatives'], TMode> }\n          : { creatives: ProjectedCreativeArray<T['creatives'], TMode> })\n    : T\n  : T;\ntype ProjectedContainerArray<T, TMode extends 'canonical' | 'legacy'> =\n  T extends ReadonlyArray<infer TContainer> ? Array<ReplaceCreatives<TContainer, TMode>> : T;\ntype ReplaceContainerKey<\n  T,\n  TKey extends 'packages' | 'new_packages',\n  TMode extends 'canonical' | 'legacy',\n> = TKey extends keyof T\n  ? Record<never, never> extends Pick<T, TKey>\n    ? { [K in TKey]?: ProjectedContainerArray<T[TKey], TMode> }\n    : { [K in TKey]: ProjectedContainerArray<T[TKey], TMode> }\n  : Record<never, never>;\n\nexport type ProjectedMediaBuyCreativeRequest<T, TMode extends 'canonical' | 'legacy'> = Omit<\n  T,\n  'packages' | 'new_packages'\n> &\n  ReplaceContainerKey<T, 'packages', TMode> &\n  ReplaceContainerKey<T, 'new_packages', TMode>;\nexport type ProjectedSyncCreativeRequest<T, TMode extends 'canonical' | 'legacy'> = ReplaceCreatives<T, TMode>;\n\nexport type CreativeFormatWireMode = 'canonical' | 'legacy' | 'unknown';\n\nexport interface CreativeFormatSelectorContainer {\n  package_id?: string;\n  format_ids?: unknown[];\n  formats?: unknown[];\n  format_options?: unknown[];\n  format_option_refs?: unknown[];\n  format_kind?: unknown;\n  params?: unknown;\n  /** Internal composition seam used to preserve per-package selector constraints. */\n  selector_containers?: ReadonlyArray<CreativeFormatSelectorContainer>;\n  [key: string]: unknown;\n}\n\n/** Canonical package/product selectors accepted by the primary sync API. */\nexport interface CanonicalCreativeFormatSelectorContainer {\n  package_id?: string;\n  format_options?: ReadonlyArray<CanonicalFormatDeclaration>;\n  format_option_refs?: ReadonlyArray<FormatOptionReference>;\n  format_kind?: CanonicalFormatKind;\n  params?: CanonicalFormatDeclaration['params'];\n  selector_containers?: ReadonlyArray<CanonicalCreativeFormatSelectorContainer>;\n}\n\nexport interface SyncCreativeFormatProjection {\n  selectorContainers: ReadonlyArray<CanonicalCreativeFormatSelectorContainer>;\n  legacyFormatConverter?: LegacyFormatConverter;\n}\n\nexport class CreativeFormatProjectionError extends Error {\n  readonly code = 'ADCP_CREATIVE_FORMAT_PROJECTION_FAILED';\n\n  constructor(\n    readonly operation: string,\n    readonly creativeId: string,\n    reason: string\n  ) {\n    super(`${operation}: cannot select a valid creative wire shape for ${creativeId}: ${reason}`);\n    this.name = 'CreativeFormatProjectionError';\n  }\n}\n\nexport class CreativeFormatCapabilityError extends Error {\n  readonly code = 'ADCP_CREATIVE_FORMAT_CAPABILITY_CONTRADICTION';\n\n  constructor(message: string) {\n    super(message);\n    this.name = 'CreativeFormatCapabilityError';\n  }\n}\n\nconst CANONICAL_FORMAT_KINDS = new Set<CanonicalFormatKind>([\n  'image',\n  'html5',\n  'display_tag',\n  'image_carousel',\n  'video_hosted',\n  'video_vast',\n  'audio_hosted',\n  'audio_daast',\n  'sponsored_placement',\n  'native_in_feed',\n  'responsive_creative',\n  'agent_placement',\n  'custom',\n]);\n\ntype LegacyCandidate = {\n  ref: V1FormatId;\n  formatKind?: string;\n  formatOptionRef?: FormatOptionReference;\n  selectorParams?: unknown;\n};\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n  return value !== null && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction legacyRef(value: unknown): V1FormatId | undefined {\n  const candidate = record(value);\n  if (!candidate || typeof candidate.agent_url !== 'string' || typeof candidate.id !== 'string') return undefined;\n  if (candidate.agent_url.length === 0 || candidate.id.length === 0) return undefined;\n  return {\n    agent_url: candidate.agent_url,\n    id: candidate.id,\n    ...(typeof candidate.width === 'number' ? { width: candidate.width } : {}),\n    ...(typeof candidate.height === 'number' ? { height: candidate.height } : {}),\n    ...(typeof candidate.duration_ms === 'number' ? { duration_ms: candidate.duration_ms } : {}),\n  };\n}\n\nfunction refsFromValue(value: unknown): V1FormatId[] {\n  if (Array.isArray(value)) return value.flatMap(item => refsFromValue(item));\n  const ref = legacyRef(value);\n  return ref ? [ref] : [];\n}\n\ntype CanonicalFormatOptionReference = FormatOptionReference & { canonical_formats_only?: true };\n\nfunction optionReference(value: unknown): CanonicalFormatOptionReference | undefined {\n  const option = record(value);\n  if (!option || typeof option.format_option_id !== 'string' || option.format_option_id.length === 0) return undefined;\n  const canonicalOnly = option.canonical_formats_only === true ? { canonical_formats_only: true as const } : {};\n  if (typeof option.publisher_domain === 'string') {\n    return {\n      scope: 'publisher',\n      publisher_domain: option.publisher_domain,\n      format_option_id: option.format_option_id,\n      ...canonicalOnly,\n    };\n  }\n  return { scope: 'product', format_option_id: option.format_option_id, ...canonicalOnly };\n}\n\nfunction sameOptionReference(left: FormatOptionReference, right: FormatOptionReference): boolean {\n  return (\n    left.scope === right.scope &&\n    left.format_option_id === right.format_option_id &&\n    (left.scope !== 'publisher' || (right.scope === 'publisher' && left.publisher_domain === right.publisher_domain))\n  );\n}\n\nfunction selectedOptionReferences(container: CreativeFormatSelectorContainer): CanonicalFormatOptionReference[] {\n  const direct = Array.isArray(container.format_option_refs)\n    ? container.format_option_refs.flatMap(value => {\n        const ref = optionReference(value);\n        return ref ? [ref] : [];\n      })\n    : [];\n  const nested = Array.isArray(container.selector_containers)\n    ? container.selector_containers.flatMap(selectedOptionReferences)\n    : [];\n  return [...direct, ...nested];\n}\n\nfunction agentIdentity(value: string): string {\n  try {\n    // URL parsing normalizes the scheme/host (the case-insensitive pieces)\n    // while preserving case-sensitive paths, queries, and fragments.\n    return new URL(value).href;\n  } catch {\n    return value;\n  }\n}\n\nfunction sameLegacyIdentity(left: V1FormatId, right: V1FormatId): boolean {\n  return agentIdentity(left.agent_url) === agentIdentity(right.agent_url) && left.id === right.id;\n}\n\nfunction candidatesFromContainer(\n  container: CreativeFormatSelectorContainer,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver,\n  operation = 'creative_delivery'\n): LegacyCandidate[] {\n  if (Array.isArray(container.selector_containers)) {\n    return uniqueCandidates(\n      container.selector_containers.flatMap(candidate =>\n        candidatesFromContainer(candidate, canonicalFormatLegacyResolver, operation)\n      )\n    );\n  }\n  const candidates: LegacyCandidate[] = [];\n  const containerKind = typeof container.format_kind === 'string' ? container.format_kind : undefined;\n  for (const key of ['format_ids', 'formats'] as const) {\n    for (const ref of refsFromValue(container[key])) {\n      candidates.push({\n        ref,\n        formatKind: resolveCanonicalFormatKind(ref.id) ?? containerKind,\n        selectorParams: container.params,\n      });\n    }\n  }\n  const formatOptions = [\n    ...(Array.isArray(container.format_options) ? container.format_options : []),\n    ...selectedFormatOptions(container),\n  ];\n  for (const optionValue of formatOptions) {\n    const option = record(optionValue);\n    if (!option) continue;\n    const formatKind = typeof option.format_kind === 'string' ? option.format_kind : undefined;\n    const formatOptionRef = optionReference(option);\n    let refs = [...legacyFormatRefsForDeclaration(option)];\n    if (refs.length === 0 && option.canonical_formats_only !== true && formatKind) {\n      try {\n        refs =\n          resolveCanonicalFormatLegacyRefs(canonicalFormatLegacyResolver, {\n            source: 'product',\n            declaration: option as unknown as import('./types').V2ProductFormatDeclaration,\n            productId: typeof container.product_id === 'string' ? container.product_id : '<selector>',\n            field: formatOptionRef?.format_option_id ?? '(format option)',\n          }) ?? [];\n      } catch (error) {\n        if (!(error instanceof CanonicalFormatLegacyResolutionError)) throw error;\n        throw new CreativeFormatProjectionError(\n          operation,\n          '(format option)',\n          'canonical format legacy resolver returned an invalid product mapping'\n        );\n      }\n    }\n    for (const ref of refs) {\n      candidates.push({ ref, formatKind, formatOptionRef, selectorParams: option.params ?? container.params });\n    }\n  }\n  return uniqueCandidates(candidates);\n}\n\nfunction containerOptsOutOfLegacy(\n  container: CreativeFormatSelectorContainer,\n  formatKind?: string,\n  formatOptionRef?: FormatOptionReference\n): boolean {\n  if ((formatOptionRef as CanonicalFormatOptionReference | undefined)?.canonical_formats_only === true) return true;\n  if (\n    Array.isArray(container.selector_containers) &&\n    container.selector_containers.some(candidate => containerOptsOutOfLegacy(candidate, formatKind, formatOptionRef))\n  ) {\n    return true;\n  }\n  const selectedRefs = selectedOptionReferences(container);\n  if (\n    selectedRefs.some(ref => {\n      if (ref.canonical_formats_only !== true) return false;\n      return formatOptionRef === undefined || sameOptionReference(ref, formatOptionRef);\n    })\n  ) {\n    return true;\n  }\n  const formatOptions = [\n    ...(Array.isArray(container.format_options) ? container.format_options : []),\n    ...selectedFormatOptions(container),\n  ];\n  return formatOptions.some(value => {\n    const option = record(value);\n    if (!option || option.canonical_formats_only !== true) return false;\n    if (formatKind && option.format_kind !== formatKind) return false;\n    if (formatOptionRef) {\n      const optionRef = optionReference(option);\n      if (!optionRef || !sameOptionReference(optionRef, formatOptionRef)) return false;\n    }\n    return true;\n  });\n}\n\nfunction candidateKey(candidate: LegacyCandidate): string {\n  const ref = candidate.ref;\n  return [\n    agentIdentity(ref.agent_url),\n    ref.id,\n    ref.width ?? '',\n    ref.height ?? '',\n    ref.duration_ms ?? '',\n    candidate.formatOptionRef?.scope ?? '',\n    candidate.formatOptionRef?.format_option_id ?? '',\n    candidate.formatOptionRef?.scope === 'publisher' ? candidate.formatOptionRef.publisher_domain : '',\n  ].join('|');\n}\n\nfunction uniqueCandidates(candidates: LegacyCandidate[]): LegacyCandidate[] {\n  return [...new Map(candidates.map(candidate => [candidateKey(candidate), candidate])).values()];\n}\n\nfunction refMatchesParams(ref: V1FormatId, paramsValue: unknown): boolean {\n  const params = record(paramsValue);\n  if (!params) return true;\n  const sizes = Array.isArray(params.sizes) ? params.sizes.flatMap(size => (record(size) ? [record(size)!] : [])) : [];\n  if (sizes.length === 1) {\n    const size = sizes[0]!;\n    if (typeof size.width === 'number' && ref.width !== size.width) return false;\n    if (typeof size.height === 'number' && ref.height !== size.height) return false;\n  }\n  if (typeof params.width === 'number' && ref.width !== params.width) return false;\n  if (typeof params.height === 'number' && ref.height !== params.height) return false;\n  if (typeof params.duration_ms_exact === 'number' && ref.duration_ms !== params.duration_ms_exact) return false;\n  return true;\n}\n\nfunction selectLegacyRef(\n  creative: Record<string, unknown>,\n  container: CreativeFormatSelectorContainer,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver,\n  operation = 'creative_delivery'\n): V1FormatId | undefined {\n  let candidates = candidatesFromContainer(container, canonicalFormatLegacyResolver, operation);\n  const creativeOptionRef = optionReference(creative.format_option_ref);\n  const selectedOptionRefs = Array.isArray(container.format_option_refs)\n    ? container.format_option_refs.flatMap(value => {\n        const ref = optionReference(value);\n        return ref ? [ref] : [];\n      })\n    : [];\n  if (creativeOptionRef) {\n    if (selectedOptionRefs.length > 0 && !selectedOptionRefs.some(ref => sameOptionReference(ref, creativeOptionRef))) {\n      return undefined;\n    }\n    candidates = candidates.filter(\n      candidate => candidate.formatOptionRef && sameOptionReference(candidate.formatOptionRef, creativeOptionRef)\n    );\n  } else if (selectedOptionRefs.length > 0) {\n    candidates = candidates.filter(\n      candidate =>\n        candidate.formatOptionRef &&\n        selectedOptionRefs.some(ref => sameOptionReference(ref, candidate.formatOptionRef!))\n    );\n  }\n  const existing = legacyRef(creative.format_id);\n  if (existing) {\n    const exact = candidates.filter(\n      candidate =>\n        sameLegacyIdentity(candidate.ref, existing) &&\n        (existing.width === undefined || candidate.ref.width === existing.width) &&\n        (existing.height === undefined || candidate.ref.height === existing.height) &&\n        (existing.duration_ms === undefined || candidate.ref.duration_ms === existing.duration_ms)\n    );\n    if (exact.length === 1) return exact[0]!.ref;\n    return candidates.length === 0 ? existing : undefined;\n  }\n\n  if (typeof creative.format_kind !== 'string') return undefined;\n  let matching = candidates.filter(candidate => candidate.formatKind === creative.format_kind);\n  const constrained = matching.filter(candidate => refMatchesParams(candidate.ref, candidate.selectorParams));\n  if (constrained.length > 0) matching = constrained;\n  return matching.length === 1 ? matching[0]!.ref : undefined;\n}\n\nfunction projectCreative<T extends Record<string, unknown>>(creative: T, formatId: V1FormatId): T {\n  const next: Record<string, unknown> = { ...creative };\n  delete next.format_kind;\n  delete next.format_option_ref;\n  next.format_id = { ...formatId };\n  return next as T;\n}\n\nfunction dedupeLegacyRefs(refs: readonly V1FormatId[]): V1FormatId[] {\n  return [...new Map(refs.map(ref => [candidateKey({ ref }), { ...ref }])).values()];\n}\n\nfunction projectPackageSelectors(\n  pkg: Record<string | symbol, unknown>,\n  wireMode: CreativeFormatWireMode,\n  operation: string,\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): Record<string | symbol, unknown> {\n  const next = { ...pkg };\n  const optionRefs = Array.isArray(pkg.format_option_refs)\n    ? pkg.format_option_refs.flatMap(value => {\n        const ref = optionReference(value);\n        return ref ? [ref] : [];\n      })\n    : [];\n  const legacyRefs = refsFromValue(pkg.format_ids);\n  const candidates = candidatesFromContainer(\n    pkg as CreativeFormatSelectorContainer,\n    wireMode === 'canonical' ? undefined : canonicalFormatLegacyResolver,\n    operation\n  );\n  const canonicalKind = typeof pkg.format_kind === 'string' ? pkg.format_kind : undefined;\n\n  if (wireMode === 'canonical') {\n    if (optionRefs.length > 0) {\n      // Rebuild the array before transport so SDK-private downgrade metadata\n      // never crosses the canonical wire boundary.\n      next.format_option_refs = optionRefs.map(ref => ({ ...ref }));\n    }\n    if (legacyRefs.length > 0) {\n      let mappedRefs = legacyRefs.flatMap(legacy => {\n        const matches = candidates.filter(candidate => sameLegacyIdentity(candidate.ref, legacy));\n        if (matches.length !== 1 || !matches[0]!.formatOptionRef) return [];\n        return [matches[0]!.formatOptionRef];\n      });\n      if (optionRefs.length === 0 && mappedRefs.length !== legacyRefs.length) {\n        const productId = typeof pkg.product_id === 'string' ? pkg.product_id : '<package-selector>';\n        const projected = projectV1ProductToV2(\n          {\n            product_id: productId,\n            name: productId,\n            description: 'legacy package selector normalization',\n            format_ids: legacyRefs,\n          },\n          { legacyFormatConverter }\n        );\n        const projectedRefs = projected.v2.format_options.flatMap(option => {\n          const ref = optionReference(option);\n          return ref ? [ref] : [];\n        });\n        if (projected.diagnostics.length > 0 || projectedRefs.length !== legacyRefs.length) {\n          throw new CreativeFormatProjectionError(\n            operation,\n            '(package selector)',\n            'legacy package format_ids cannot be converted to stable canonical format_option_refs'\n          );\n        }\n        mappedRefs = projectedRefs;\n      }\n      if (optionRefs.length === 0) next.format_option_refs = mappedRefs;\n    }\n    delete next.format_ids;\n  } else {\n    if (optionRefs.length > 0) {\n      const selectedCandidates = candidates.filter(\n        candidate =>\n          candidate.formatOptionRef &&\n          optionRefs.some(selected => sameOptionReference(selected, candidate.formatOptionRef!))\n      );\n      const everyOptionMapped = optionRefs.every(selected =>\n        selectedCandidates.some(candidate =>\n          candidate.formatOptionRef ? sameOptionReference(selected, candidate.formatOptionRef) : false\n        )\n      );\n      if (!everyOptionMapped || selectedCandidates.length === 0) {\n        let resolved: V1FormatId[] | undefined;\n        try {\n          if (!containerOptsOutOfLegacy(pkg as CreativeFormatSelectorContainer)) {\n            resolved = resolveCanonicalFormatLegacyRefs(canonicalFormatLegacyResolver, {\n              source: 'selector',\n              selector: pkg as Record<string, unknown>,\n              operation,\n              field: '(package selector)',\n            });\n          }\n        } catch (error) {\n          if (!(error instanceof CanonicalFormatLegacyResolutionError)) throw error;\n          throw new CreativeFormatProjectionError(\n            operation,\n            '(package selector)',\n            'canonical format legacy resolver returned an invalid or ambiguous package mapping'\n          );\n        }\n        if (!resolved) {\n          throw new CreativeFormatProjectionError(\n            operation,\n            '(package selector)',\n            'canonical format_option_refs have no complete legacy representation; re-run getProducts() or configure canonicalFormatLegacyResolver for persisted selections'\n          );\n        }\n        next.format_ids = resolved;\n        delete next.format_option_refs;\n        delete next.format_kind;\n        return next;\n      }\n      next.format_ids = dedupeLegacyRefs(selectedCandidates.map(candidate => candidate.ref));\n      delete next.format_option_refs;\n    } else if (canonicalKind) {\n      const selectedCandidates = candidates.filter(candidate => candidate.formatKind === canonicalKind);\n      if (selectedCandidates.length === 1) {\n        next.format_ids = [{ ...selectedCandidates[0]!.ref }];\n      } else {\n        let resolved: V1FormatId[] | undefined;\n        try {\n          if (!containerOptsOutOfLegacy(pkg as CreativeFormatSelectorContainer, canonicalKind)) {\n            resolved = resolveCanonicalFormatLegacyRefs(\n              canonicalFormatLegacyResolver,\n              {\n                source: 'selector',\n                selector: pkg as Record<string, unknown>,\n                operation,\n                field: '(package selector)',\n              },\n              true\n            );\n          }\n        } catch (error) {\n          if (!(error instanceof CanonicalFormatLegacyResolutionError)) throw error;\n          throw new CreativeFormatProjectionError(\n            operation,\n            '(package selector)',\n            'canonical format legacy resolver returned an invalid or ambiguous package mapping'\n          );\n        }\n        if (resolved) {\n          next.format_ids = resolved;\n        } else {\n          throw new CreativeFormatProjectionError(\n            operation,\n            '(package selector)',\n            'canonical package format_kind has no unambiguous legacy representation; select a format_option_ref from the product before delivery'\n          );\n        }\n      }\n    }\n    delete next.format_kind;\n  }\n\n  return next;\n}\n\nfunction canonicalizeCreative<T extends Record<string, unknown>>(\n  creative: T,\n  selectorContainer: CreativeFormatSelectorContainer,\n  operation: string,\n  legacyFormatConverter?: LegacyFormatConverter\n): T {\n  const creativeId = typeof creative.creative_id === 'string' ? creative.creative_id : '(unknown)';\n  const hasCanonicalKind = typeof creative.format_kind === 'string';\n  if (hasCanonicalKind && creative.format_id !== undefined) {\n    throw new CreativeFormatProjectionError(\n      operation,\n      creativeId,\n      'creative must not declare both canonical format_kind and legacy format_id'\n    );\n  }\n  if (hasCanonicalKind && creative.format_id === undefined) {\n    if (!CANONICAL_FORMAT_KINDS.has(creative.format_kind as CanonicalFormatKind)) {\n      throw new CreativeFormatProjectionError(\n        operation,\n        creativeId,\n        `unknown canonical format_kind ${creative.format_kind}`\n      );\n    }\n    const creativeOptionRef = optionReference(creative.format_option_ref);\n    const selectedRefs = selectedOptionReferences(selectorContainer);\n    if (\n      creativeOptionRef &&\n      selectedRefs.length > 0 &&\n      !selectedRefs.some(ref => sameOptionReference(ref, creativeOptionRef))\n    ) {\n      throw new CreativeFormatProjectionError(\n        operation,\n        creativeId,\n        'creative format_option_ref conflicts with the package selected format_option_refs'\n      );\n    }\n    return creative;\n  }\n  const existing = legacyRef(creative.format_id);\n  if (!existing) {\n    throw new CreativeFormatProjectionError(\n      operation,\n      creativeId,\n      'creative must identify its format canonically with format_kind'\n    );\n  }\n\n  const matchingCandidates = candidatesFromContainer(selectorContainer).filter(\n    candidate =>\n      sameLegacyIdentity(candidate.ref, existing) &&\n      (existing.width === undefined || candidate.ref.width === existing.width) &&\n      (existing.height === undefined || candidate.ref.height === existing.height) &&\n      (existing.duration_ms === undefined || candidate.ref.duration_ms === existing.duration_ms)\n  );\n  if (matchingCandidates.length === 1 && matchingCandidates[0]!.formatKind) {\n    const candidate = matchingCandidates[0]!;\n    const next: Record<string, unknown> = { ...creative, format_kind: candidate.formatKind };\n    delete next.format_id;\n    if (candidate.formatOptionRef) next.format_option_ref = candidate.formatOptionRef;\n    if (candidate.formatKind === 'custom' && !candidate.formatOptionRef) {\n      throw new CreativeFormatProjectionError(\n        operation,\n        creativeId,\n        'custom product format must provide format_option_id so the canonical creative retains a concrete identity'\n      );\n    }\n    return next as T;\n  }\n  const selectorCandidates = candidatesFromContainer(selectorContainer);\n  if (selectorCandidates.length > 0 && matchingCandidates.length !== 1) {\n    throw new CreativeFormatProjectionError(\n      operation,\n      creativeId,\n      matchingCandidates.length === 0\n        ? 'legacy format reference conflicts with the selected seller format identity or constraints'\n        : 'legacy format reference is ambiguous within the selected seller format options'\n    );\n  }\n\n  const { v2, diagnostics } = projectV1ProductToV2(\n    {\n      product_id: `<creative:${creativeId}>`,\n      name: creativeId,\n      description: 'legacy creative normalization',\n      format_ids: [existing],\n    },\n    { legacyFormatConverter }\n  );\n  const declaration = v2.format_options[0];\n  if (!declaration) {\n    const diagnostic = diagnostics[0];\n    const failure =\n      diagnostic?.code === 'FORMAT_PROJECTION_FAILED' ? diagnostic.error.details.resolution_failure : undefined;\n    throw new CreativeFormatProjectionError(\n      operation,\n      creativeId,\n      `legacy creative format has no canonical conversion${failure ? ` (${failure})` : ''}`\n    );\n  }\n  const next: Record<string, unknown> = { ...creative, format_kind: declaration.format_kind };\n  delete next.format_id;\n  const candidateOptionRef =\n    matchingCandidates.length === 1 && matchingCandidates[0]!.formatKind === declaration.format_kind\n      ? matchingCandidates[0]!.formatOptionRef\n      : undefined;\n  const convertedOptionRef = optionReference(declaration) ?? candidateOptionRef;\n  if (convertedOptionRef) next.format_option_ref = convertedOptionRef;\n  if (declaration.format_kind === 'custom' && !convertedOptionRef) {\n    throw new CreativeFormatProjectionError(\n      operation,\n      creativeId,\n      'custom legacy conversion must provide format_option_id so the canonical creative retains a concrete identity'\n    );\n  }\n  return next as T;\n}\n\nexport function projectCreativeForDelivery<T extends CreativeAsset>(\n  creative: T,\n  selectorContainer: CreativeFormatSelectorContainer,\n  wireMode?: 'canonical',\n  operation?: string,\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): CanonicalProjectedCreative<T>;\nexport function projectCreativeForDelivery<T extends CreativeAsset>(\n  creative: T,\n  selectorContainer: CreativeFormatSelectorContainer,\n  wireMode: 'legacy' | 'unknown',\n  operation?: string,\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): LegacyProjectedCreative<T>;\nexport function projectCreativeForDelivery<T extends CreativeAsset>(\n  creative: T,\n  selectorContainer: CreativeFormatSelectorContainer,\n  wireMode: CreativeFormatWireMode,\n  operation?: string,\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): CanonicalProjectedCreative<T> | LegacyProjectedCreative<T>;\nexport function projectCreativeForDelivery<T extends CreativeAsset>(\n  creative: T,\n  selectorContainer: CreativeFormatSelectorContainer,\n  wireMode: CreativeFormatWireMode = 'canonical',\n  operation = 'creative_delivery',\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): CanonicalProjectedCreative<T> | LegacyProjectedCreative<T> {\n  const inputRecord = creative as unknown as Record<string, unknown>;\n  const originalLegacyRef = legacyRef(inputRecord.format_id);\n  const creativeRecord = canonicalizeCreative(inputRecord, selectorContainer, operation, legacyFormatConverter);\n  if (wireMode === 'canonical') return creativeRecord as unknown as CanonicalProjectedCreative<T>;\n  if (originalLegacyRef) {\n    const selectedOriginal = selectLegacyRef(inputRecord, selectorContainer, canonicalFormatLegacyResolver, operation);\n    if (selectedOriginal) {\n      return projectCreative(creativeRecord, selectedOriginal) as unknown as LegacyProjectedCreative<T>;\n    }\n    throw new CreativeFormatProjectionError(\n      operation,\n      typeof inputRecord.creative_id === 'string' ? inputRecord.creative_id : '(unknown)',\n      'the original legacy format reference conflicts with the selected seller format identity or constraints'\n    );\n  }\n  const formatId = selectLegacyRef(creativeRecord, selectorContainer, canonicalFormatLegacyResolver, operation);\n  if (formatId) return projectCreative(creativeRecord, formatId) as unknown as LegacyProjectedCreative<T>;\n\n  if (typeof creativeRecord.format_kind === 'string') {\n    const creativeId = typeof creativeRecord.creative_id === 'string' ? creativeRecord.creative_id : '(unknown)';\n    const allCandidates = candidatesFromContainer(selectorContainer, canonicalFormatLegacyResolver, operation);\n    let candidates = allCandidates.filter(candidate => candidate.formatKind === creativeRecord.format_kind);\n    const constrained = candidates.filter(candidate => refMatchesParams(candidate.ref, selectorContainer.params));\n    if (constrained.length > 0) candidates = constrained;\n    let resolved: V1FormatId[] | undefined;\n    try {\n      if (\n        !containerOptsOutOfLegacy(\n          selectorContainer,\n          creativeRecord.format_kind,\n          optionReference(creativeRecord.format_option_ref)\n        )\n      ) {\n        resolved = resolveCanonicalFormatLegacyRefs(\n          canonicalFormatLegacyResolver,\n          {\n            source: 'creative',\n            creative: creativeRecord,\n            selector: selectorContainer as Record<string, unknown>,\n            operation,\n            field: creativeId,\n          },\n          true\n        );\n      }\n    } catch (error) {\n      if (!(error instanceof CanonicalFormatLegacyResolutionError)) throw error;\n      throw new CreativeFormatProjectionError(\n        operation,\n        creativeId,\n        'canonical format legacy resolver returned an invalid or ambiguous creative mapping'\n      );\n    }\n    if (resolved) return projectCreative(creativeRecord, resolved[0]!) as unknown as LegacyProjectedCreative<T>;\n    if (candidates.length > 1) {\n      throw new CreativeFormatProjectionError(\n        operation,\n        creativeId,\n        `the seller advertised ${candidates.length} legacy refs for canonical kind ${creativeRecord.format_kind}`\n      );\n    }\n    const reason = 'the selected seller product did not provide one unambiguous legacy format reference';\n    throw new CreativeFormatProjectionError(operation, creativeId, reason);\n  }\n  return creative as unknown as LegacyProjectedCreative<T>;\n}\n\nexport function projectMediaBuyCreativesForDelivery<T>(\n  request: T,\n  wireMode: 'canonical',\n  operation?: 'create_media_buy' | 'update_media_buy',\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): ProjectedMediaBuyCreativeRequest<T, 'canonical'>;\nexport function projectMediaBuyCreativesForDelivery<T>(\n  request: T,\n  wireMode: 'legacy' | 'unknown',\n  operation?: 'create_media_buy' | 'update_media_buy',\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): ProjectedMediaBuyCreativeRequest<T, 'legacy'>;\nexport function projectMediaBuyCreativesForDelivery<T>(\n  request: T,\n  wireMode: CreativeFormatWireMode,\n  operation?: 'create_media_buy' | 'update_media_buy',\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): ProjectedMediaBuyCreativeRequest<T, 'canonical'> | ProjectedMediaBuyCreativeRequest<T, 'legacy'>;\nexport function projectMediaBuyCreativesForDelivery<T>(\n  request: T,\n  wireMode: CreativeFormatWireMode = 'canonical',\n  operation: 'create_media_buy' | 'update_media_buy' = 'create_media_buy',\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): ProjectedMediaBuyCreativeRequest<T, 'canonical'> | ProjectedMediaBuyCreativeRequest<T, 'legacy'> {\n  const requestRecord = record(request);\n  if (!requestRecord) return request as ProjectedMediaBuyCreativeRequest<T, 'canonical'>;\n  let changed = false;\n  const next = { ...requestRecord };\n  for (const key of ['packages', 'new_packages'] as const) {\n    const packages = requestRecord[key];\n    if (!Array.isArray(packages)) continue;\n    next[key] = packages.map(packageValue => {\n      const pkg = record(packageValue);\n      if (!pkg) return packageValue;\n      const creatives = Array.isArray(pkg.creatives)\n        ? pkg.creatives.map(creativeValue => {\n            const creative = record(creativeValue);\n            if (!creative) return creativeValue;\n            const projected = projectCreativeForDelivery(\n              creative as unknown as CreativeAsset,\n              pkg as CreativeFormatSelectorContainer,\n              wireMode,\n              operation,\n              legacyFormatConverter,\n              canonicalFormatLegacyResolver\n            );\n            if (projected !== creativeValue) changed = true;\n            return projected;\n          })\n        : undefined;\n      const projectedPackage = projectPackageSelectors(\n        pkg,\n        wireMode,\n        operation,\n        legacyFormatConverter,\n        canonicalFormatLegacyResolver\n      );\n      if (projectedPackage !== packageValue) changed = true;\n      return creatives ? { ...projectedPackage, creatives } : projectedPackage;\n    });\n  }\n  return (changed ? next : request) as\n    | ProjectedMediaBuyCreativeRequest<T, 'canonical'>\n    | ProjectedMediaBuyCreativeRequest<T, 'legacy'>;\n}\n\nexport function projectSyncCreativesForDelivery<T>(\n  request: T,\n  selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>,\n  wireMode: 'canonical',\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): ProjectedSyncCreativeRequest<T, 'canonical'>;\nexport function projectSyncCreativesForDelivery<T>(\n  request: T,\n  selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>,\n  wireMode: 'legacy' | 'unknown',\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): ProjectedSyncCreativeRequest<T, 'legacy'>;\nexport function projectSyncCreativesForDelivery<T>(\n  request: T,\n  selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>,\n  wireMode: CreativeFormatWireMode,\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): ProjectedSyncCreativeRequest<T, 'canonical'> | ProjectedSyncCreativeRequest<T, 'legacy'>;\nexport function projectSyncCreativesForDelivery<T>(\n  request: T,\n  selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>,\n  wireMode: CreativeFormatWireMode = 'canonical',\n  legacyFormatConverter?: LegacyFormatConverter,\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver\n): ProjectedSyncCreativeRequest<T, 'canonical'> | ProjectedSyncCreativeRequest<T, 'legacy'> {\n  const requestRecord = record(request);\n  if (!requestRecord || !Array.isArray(requestRecord.creatives)) {\n    return request as ProjectedSyncCreativeRequest<T, 'canonical'>;\n  }\n  const assignments = Array.isArray(requestRecord.assignments) ? requestRecord.assignments : [];\n  let changed = false;\n  const creatives = requestRecord.creatives.map(creativeValue => {\n    const creative = record(creativeValue);\n    if (!creative) return creativeValue;\n    const assignedPackageIds = new Set(\n      assignments.flatMap(assignmentValue => {\n        const assignment = record(assignmentValue);\n        if (!assignment || assignment.creative_id !== creative.creative_id) return [];\n        return typeof assignment.package_id === 'string' ? [assignment.package_id] : [];\n      })\n    );\n    const relevant =\n      assignedPackageIds.size === 0\n        ? selectorContainers\n        : selectorContainers.filter(\n            container => typeof container.package_id === 'string' && assignedPackageIds.has(container.package_id)\n          );\n    const combined: CreativeFormatSelectorContainer = {\n      selector_containers: relevant,\n    };\n    const projected = projectCreativeForDelivery(\n      creative as unknown as CreativeAsset,\n      combined,\n      wireMode,\n      'sync_creatives',\n      legacyFormatConverter,\n      canonicalFormatLegacyResolver\n    );\n    if (projected !== creativeValue) changed = true;\n    return projected;\n  });\n  return (changed ? { ...requestRecord, creatives } : request) as\n    | ProjectedSyncCreativeRequest<T, 'canonical'>\n    | ProjectedSyncCreativeRequest<T, 'legacy'>;\n}\n\ntype CreativeProtocolRelease = { major: number; minor: number; label: string };\n\nfunction release(value: unknown): CreativeProtocolRelease | undefined {\n  if (typeof value !== 'string') return undefined;\n  const match = /^v?(\\d+)\\.(\\d+)(?:\\.|-|$)/.exec(value.trim());\n  return match ? { major: Number(match[1]), minor: Number(match[2]), label: value } : undefined;\n}\n\nfunction mutuallyServedRelease(\n  caps: Record<string, unknown> | undefined,\n  raw: Record<string, unknown> | undefined,\n  requestedVersion: string | undefined\n): CreativeProtocolRelease | undefined {\n  const requested = release(requestedVersion);\n  if (!requested) return undefined;\n  const normalizedSupported = Array.isArray(caps?.supportedVersions) ? caps.supportedVersions : [];\n  const directSupported = record(caps?.adcp)?.supported_versions;\n  const rawSupported = record(raw?.adcp)?.supported_versions;\n  const advertisedValues = [\n    ...normalizedSupported,\n    ...(Array.isArray(directSupported) ? directSupported : []),\n    ...(Array.isArray(rawSupported) ? rawSupported : []),\n  ];\n  const advertised = advertisedValues.flatMap(value => {\n    const parsed = release(value);\n    return parsed ? [parsed] : [];\n  });\n  if (advertisedValues.length > 0 && advertised.length === 0) {\n    throw new CreativeFormatCapabilityError(\n      'Seller advertised supported AdCP versions, but none were valid release identifiers'\n    );\n  }\n  if (advertised.length === 0) {\n    // A buyer pin is an upper bound, not evidence that the seller serves the\n    // same release. Legacy 3.0 sellers commonly omit supported_versions; that\n    // omission must not turn a 3.2 buyer pin into a false canonical guarantee.\n    return requested.major < 3 || (requested.major === 3 && requested.minor === 0) ? requested : undefined;\n  }\n  const mutuallyServed = advertised\n    .filter(\n      candidate =>\n        candidate.major === requested.major &&\n        (candidate.minor < requested.minor || candidate.minor === requested.minor)\n    )\n    .sort((left, right) => right.minor - left.minor)[0];\n  if (!mutuallyServed) {\n    const supported = [...new Set(advertised.map(candidate => candidate.label))].join(', ');\n    throw new CreativeFormatCapabilityError(\n      `No mutually supported AdCP release: client requested ${requestedVersion}, seller advertised ${supported}`\n    );\n  }\n  return mutuallyServed;\n}\n\nexport function resolveCreativeFormatWireMode(\n  capabilities: unknown,\n  negotiatedVersion?: string\n): CreativeFormatWireMode {\n  const caps = record(capabilities);\n  const raw = record(caps?._raw);\n  const features = record(caps?.features);\n  const mediaBuyFeatures = record(record(caps?.media_buy)?.features);\n  const rawMediaBuyFeatures = record(record(raw?.media_buy)?.features);\n  const declarations = [\n    features?.canonicalCreatives,\n    mediaBuyFeatures?.canonical_creatives,\n    rawMediaBuyFeatures?.canonical_creatives,\n  ].filter((value): value is boolean => typeof value === 'boolean');\n  if (declarations.includes(true) && declarations.includes(false)) {\n    throw new CreativeFormatCapabilityError(\n      'Seller capability response contains conflicting canonical_creatives declarations'\n    );\n  }\n  const explicitCanonical = declarations[0];\n  // `supported_versions` is the seller's wire-release contract. A newer\n  // buyer can be downshifted within the same major, so a 3.2 client talking\n  // to a 3.1-only seller must apply the 3.1 feature semantics rather than\n  // assuming the 3.2 canonical guarantee. `build_version` is intentionally\n  // absent here: the capability schema marks it advisory-only.\n  const negotiated = mutuallyServedRelease(caps, raw, negotiatedVersion);\n  if (caps?.version === 'v2') return 'legacy';\n  if (negotiated && (negotiated.major > 3 || (negotiated.major === 3 && negotiated.minor >= 2))) {\n    if (explicitCanonical === false) {\n      throw new CreativeFormatCapabilityError(\n        `AdCP ${negotiated.label} guarantees canonical creatives, but the seller advertised canonical_creatives: false`\n      );\n    }\n    return 'canonical';\n  }\n  if (negotiated && (negotiated.major < 3 || (negotiated.major === 3 && negotiated.minor === 0))) {\n    return 'legacy';\n  }\n  if (!caps) return 'unknown';\n  if (explicitCanonical === true) return 'canonical';\n  if (explicitCanonical === false) return 'legacy';\n  return 'unknown';\n}\n"],"mappings":"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","names":["value","result","needsSafeToJSON","changed","safe","next"]}

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

@@ -28,17 +28,19 @@
  *     `findCatalogEntryByCanonicalAndSize`, registry exports) for
  *     callers wiring projection into their own code paths.
  *
- * Exposed from both `@adcp/sdk/v2/projection` and the package root for
- * adopters migrating from local format metadata and `product_card.format_id`
- * conventions to canonical creative formats.
+ * Legacy-preserving and raw wire projection helpers are exposed only from
+ * `@adcp/sdk/v2/projection`. The package root exports the canonical authoring
+ * surface so ordinary buyers do not accidentally retain legacy identities.
  */
 export { projectV1ProductToV2, canonicalDeclarationFromBareId, resolveCanonicalFormatKind } from './v1-to-v2.mjs';
-export type { V1ToV2Result, BareFormatIdResolveOptions } from './v1-to-v2.mjs';
+export type { V1ToV2Result, V1ToV2ProjectionOptions, BareFormatIdResolveOptions, LegacyFormatConversionContext, LegacyFormatConverter, } from './v1-to-v2.mjs';
 export { projectV2ProductToV1 } from './v2-to-v1.mjs';
-export type { V2ToV1Result } from './v2-to-v1.mjs';
+export type { V2ToV1Result, V2ToV1ProjectionOptions, CanonicalFormatLegacyResolver, CanonicalFormatLegacyResolutionContext, CanonicalProductFormatLegacyResolutionContext, CanonicalCreativeFormatLegacyResolutionContext, CanonicalSelectorFormatLegacyResolutionContext, } from './v2-to-v1.mjs';
 export { augmentProductWithFormatOptions, withFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, type V2AugmentedProduct, type CanonicalOnlyProduct, } from './augment-response.mjs';
-export { CanonicalFormat, audioDaastFormatDeclaration, audioHostedFormatDeclaration, agentPlacementFormatDeclaration, canonicalFormatDeclaration, customFormatDeclaration, displayTagFormatDeclaration, formatRef, formatRefs, html5FormatDeclaration, imageCarouselFormatDeclaration, imageFormatDeclaration, nativeInFeedFormatDeclaration, productCard, productCardDetailed, responsiveCreativeFormatDeclaration, sponsoredPlacementFormatDeclaration, videoHostedFormatDeclaration, videoVastFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type FormatReferenceInput, type ProductCardDetailedFields, type ProductCardFields, } from './builders.mjs';
+export { CanonicalFormat, audioDaastFormatDeclaration, audioHostedFormatDeclaration, agentPlacementFormatDeclaration, canonicalFormatDeclaration, customFormatDeclaration, displayTagFormatDeclaration, legacyFormatRef, legacyFormatRefs, html5FormatDeclaration, imageCarouselFormatDeclaration, imageFormatDeclaration, nativeInFeedFormatDeclaration, productCard, productCardDetailed, responsiveCreativeFormatDeclaration, sponsoredPlacementFormatDeclaration, videoHostedFormatDeclaration, videoVastFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type FormatReferenceInput, type ProductCardDetailedFields, type ProductCardFields, } from './builders.mjs';
 export { packageRefsForFormatOptions, packageRefsForCapabilities, legacyFormatIdsFromOptions, tryLegacyFormatIdsFromOptions, legacyFormatIdsForFormatOption, legacyFormatIdsForCapability, FormatOptionRefsLookupError, CapabilityIdsLookupError, type PackageFormatRefs, type PackageCapabilityRefs, type FormatOptionRef, type FormatOptionSelector, type FormatOptionRefsLookupErrorCode, type CapabilityIdsLookupErrorCode, } from './write-side.mjs';
 export type { V1FormatId, V2ProductFormatDeclaration, V2Product, V1Product, ProjectionDiagnostic } from './types.mjs';
+export { legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, } from './catalog-snapshot.mjs';
 export { loadCatalog, lookupV1Format, findCatalogEntryByCanonicalAndSize, parseSizedIdTemplate, _resetCatalogCache, type V1FormatDefinition, type CanonicalProjectionRef, } from './catalog.mjs';
 export { isCanonicalV1Translatable } from './canonical-properties.mjs';
+export { CreativeFormatProjectionError, CreativeFormatCapabilityError, projectCreativeForDelivery, projectMediaBuyCreativesForDelivery, projectSyncCreativesForDelivery, stripLegacyCreativeIdentity, resolveCreativeFormatWireMode, type CreativeFormatSelectorContainer, type CanonicalCreativeFormatSelectorContainer, type CreativeFormatWireMode, type CanonicalCreativeAsset, type CanonicalCreativeResponse, type CanonicalGetProductsResponse, type CanonicalGetProductsRequest, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreativeFilters, type CanonicalListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageUpdate, type CanonicalPackage, type CanonicalPlacement, type CanonicalProduct, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type LegacyCreativeAsset, type LegacyProjectedCreative, type ProjectedMediaBuyCreativeRequest, type ProjectedSyncCreativeRequest, type SyncCreativeFormatProjection, } from './creative-delivery.mjs';

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

@@ -28,18 +28,20 @@
  *     `findCatalogEntryByCanonicalAndSize`, registry exports) for
  *     callers wiring projection into their own code paths.
  *
- * Exposed from both `@adcp/sdk/v2/projection` and the package root for
- * adopters migrating from local format metadata and `product_card.format_id`
- * conventions to canonical creative formats.
+ * Legacy-preserving and raw wire projection helpers are exposed only from
+ * `@adcp/sdk/v2/projection`. The package root exports the canonical authoring
+ * surface so ordinary buyers do not accidentally retain legacy identities.
  */
 export { projectV1ProductToV2, canonicalDeclarationFromBareId, resolveCanonicalFormatKind } from './v1-to-v2';
-export type { V1ToV2Result, BareFormatIdResolveOptions } from './v1-to-v2';
+export type { V1ToV2Result, V1ToV2ProjectionOptions, BareFormatIdResolveOptions, LegacyFormatConversionContext, LegacyFormatConverter, } from './v1-to-v2';
 export { projectV2ProductToV1 } from './v2-to-v1';
-export type { V2ToV1Result } from './v2-to-v1';
+export type { V2ToV1Result, V2ToV1ProjectionOptions, CanonicalFormatLegacyResolver, CanonicalFormatLegacyResolutionContext, CanonicalProductFormatLegacyResolutionContext, CanonicalCreativeFormatLegacyResolutionContext, CanonicalSelectorFormatLegacyResolutionContext, } from './v2-to-v1';
 export { augmentProductWithFormatOptions, withFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, type V2AugmentedProduct, type CanonicalOnlyProduct, } from './augment-response';
-export { CanonicalFormat, audioDaastFormatDeclaration, audioHostedFormatDeclaration, agentPlacementFormatDeclaration, canonicalFormatDeclaration, customFormatDeclaration, displayTagFormatDeclaration, formatRef, formatRefs, html5FormatDeclaration, imageCarouselFormatDeclaration, imageFormatDeclaration, nativeInFeedFormatDeclaration, productCard, productCardDetailed, responsiveCreativeFormatDeclaration, sponsoredPlacementFormatDeclaration, videoHostedFormatDeclaration, videoVastFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type FormatReferenceInput, type ProductCardDetailedFields, type ProductCardFields, } from './builders';
+export { CanonicalFormat, audioDaastFormatDeclaration, audioHostedFormatDeclaration, agentPlacementFormatDeclaration, canonicalFormatDeclaration, customFormatDeclaration, displayTagFormatDeclaration, legacyFormatRef, legacyFormatRefs, html5FormatDeclaration, imageCarouselFormatDeclaration, imageFormatDeclaration, nativeInFeedFormatDeclaration, productCard, productCardDetailed, responsiveCreativeFormatDeclaration, sponsoredPlacementFormatDeclaration, videoHostedFormatDeclaration, videoVastFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type FormatReferenceInput, type ProductCardDetailedFields, type ProductCardFields, } from './builders';
 export { packageRefsForFormatOptions, packageRefsForCapabilities, legacyFormatIdsFromOptions, tryLegacyFormatIdsFromOptions, legacyFormatIdsForFormatOption, legacyFormatIdsForCapability, FormatOptionRefsLookupError, CapabilityIdsLookupError, type PackageFormatRefs, type PackageCapabilityRefs, type FormatOptionRef, type FormatOptionSelector, type FormatOptionRefsLookupErrorCode, type CapabilityIdsLookupErrorCode, } from './write-side';
 export type { V1FormatId, V2ProductFormatDeclaration, V2Product, V1Product, ProjectionDiagnostic } from './types';
+export { legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, } from './catalog-snapshot';
 export { loadCatalog, lookupV1Format, findCatalogEntryByCanonicalAndSize, parseSizedIdTemplate, _resetCatalogCache, type V1FormatDefinition, type CanonicalProjectionRef, } from './catalog';
 export { isCanonicalV1Translatable } from './canonical-properties';
+export { CreativeFormatProjectionError, CreativeFormatCapabilityError, projectCreativeForDelivery, projectMediaBuyCreativesForDelivery, projectSyncCreativesForDelivery, stripLegacyCreativeIdentity, resolveCreativeFormatWireMode, type CreativeFormatSelectorContainer, type CanonicalCreativeFormatSelectorContainer, type CreativeFormatWireMode, type CanonicalCreativeAsset, type CanonicalCreativeResponse, type CanonicalGetProductsResponse, type CanonicalGetProductsRequest, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreativeFilters, type CanonicalListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageUpdate, type CanonicalPackage, type CanonicalPlacement, type CanonicalProduct, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type LegacyCreativeAsset, type LegacyProjectedCreative, type ProjectedMediaBuyCreativeRequest, type ProjectedSyncCreativeRequest, type SyncCreativeFormatProjection, } from './creative-delivery';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/v2/projection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC9G,YAAY,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EACL,+BAA+B,EAC/B,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,4BAA4B,EAC5B,+BAA+B,EAC/B,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,SAAS,EACT,UAAU,EACV,sBAAsB,EACtB,8BAA8B,EAC9B,sBAAsB,EACtB,6BAA6B,EAC7B,WAAW,EACX,mBAAmB,EACnB,mCAAmC,EACnC,mCAAmC,EACnC,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACrC,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,4BAA4B,GAClC,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,UAAU,EAAE,0BAA0B,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAElH,OAAO,EACL,WAAW,EACX,cAAc,EACd,kCAAkC,EAClC,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC9G,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,6BAA6B,EAC7B,sCAAsC,EACtC,6CAA6C,EAC7C,8CAA8C,EAC9C,8CAA8C,GAC/C,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,+BAA+B,EAC/B,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,4BAA4B,EAC5B,+BAA+B,EAC/B,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,8BAA8B,EAC9B,sBAAsB,EACtB,6BAA6B,EAC7B,WAAW,EACX,mBAAmB,EACnB,mCAAmC,EACnC,mCAAmC,EACnC,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACrC,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,4BAA4B,GAClC,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,UAAU,EAAE,0BAA0B,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAClH,OAAO,EACL,yCAAyC,EACzC,iDAAiD,EACjD,sCAAsC,EACtC,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,WAAW,EACX,cAAc,EACd,kCAAkC,EAClC,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAC1B,mCAAmC,EACnC,+BAA+B,EAC/B,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,+BAA+B,EACpC,KAAK,wCAAwC,EAC7C,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACnC,KAAK,oCAAoC,EACzC,KAAK,oCAAoC,EACzC,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,GAClC,MAAM,qBAAqB,CAAC"}

package/dist/lib/v2/projection/index.js

@@ -20,6 +20,8 @@ var projection_exports = {};
 __export(projection_exports, {
   CanonicalFormat: () => import_builders.CanonicalFormat,
   CapabilityIdsLookupError: () => import_write_side.CapabilityIdsLookupError,
+  CreativeFormatCapabilityError: () => import_creative_delivery.CreativeFormatCapabilityError,
+  CreativeFormatProjectionError: () => import_creative_delivery.CreativeFormatProjectionError,
   FormatOptionRefsLookupError: () => import_write_side.FormatOptionRefsLookupError,
   _resetCatalogCache: () => import_catalog._resetCatalogCache,
   agentPlacementFormatDeclaration: () => import_builders.agentPlacementFormatDeclaration,
@@ -28,18 +30,20 @@ __export(projection_exports, {
   augmentProductWithFormatOptions: () => import_augment_response.augmentProductWithFormatOptions,
   canonicalDeclarationFromBareId: () => import_v1_to_v2.canonicalDeclarationFromBareId,
   canonicalFormatDeclaration: () => import_builders.canonicalFormatDeclaration,
+  canonicalFormatLegacyResolverFromCatalogSnapshots: () => import_catalog_snapshot.canonicalFormatLegacyResolverFromCatalogSnapshots,
   customFormatDeclaration: () => import_builders.customFormatDeclaration,
   displayTagFormatDeclaration: () => import_builders.displayTagFormatDeclaration,
   findCatalogEntryByCanonicalAndSize: () => import_catalog.findCatalogEntryByCanonicalAndSize,
-  formatRef: () => import_builders.formatRef,
-  formatRefs: () => import_builders.formatRefs,
   html5FormatDeclaration: () => import_builders.html5FormatDeclaration,
   imageCarouselFormatDeclaration: () => import_builders.imageCarouselFormatDeclaration,
   imageFormatDeclaration: () => import_builders.imageFormatDeclaration,
   isCanonicalV1Translatable: () => import_canonical_properties.isCanonicalV1Translatable,
+  legacyFormatConverterFromCatalogSnapshots: () => import_catalog_snapshot.legacyFormatConverterFromCatalogSnapshots,
   legacyFormatIdsForCapability: () => import_write_side.legacyFormatIdsForCapability,
   legacyFormatIdsForFormatOption: () => import_write_side.legacyFormatIdsForFormatOption,
   legacyFormatIdsFromOptions: () => import_write_side.legacyFormatIdsFromOptions,
+  legacyFormatRef: () => import_builders.legacyFormatRef,
+  legacyFormatRefs: () => import_builders.legacyFormatRefs,
   loadCatalog: () => import_catalog.loadCatalog,
   lookupV1Format: () => import_catalog.lookupV1Format,
   nativeInFeedFormatDeclaration: () => import_builders.nativeInFeedFormatDeclaration,
@@ -48,11 +52,17 @@ __export(projection_exports, {
   parseSizedIdTemplate: () => import_catalog.parseSizedIdTemplate,
   productCard: () => import_builders.productCard,
   productCardDetailed: () => import_builders.productCardDetailed,
+  projectCreativeForDelivery: () => import_creative_delivery.projectCreativeForDelivery,
+  projectMediaBuyCreativesForDelivery: () => import_creative_delivery.projectMediaBuyCreativesForDelivery,
+  projectSyncCreativesForDelivery: () => import_creative_delivery.projectSyncCreativesForDelivery,
   projectV1ProductToV2: () => import_v1_to_v2.projectV1ProductToV2,
   projectV2ProductToV1: () => import_v2_to_v1.projectV2ProductToV1,
+  projectionAdaptersFromCatalogSnapshots: () => import_catalog_snapshot.projectionAdaptersFromCatalogSnapshots,
   resolveCanonicalFormatKind: () => import_v1_to_v2.resolveCanonicalFormatKind,
+  resolveCreativeFormatWireMode: () => import_creative_delivery.resolveCreativeFormatWireMode,
   responsiveCreativeFormatDeclaration: () => import_builders.responsiveCreativeFormatDeclaration,
   sponsoredPlacementFormatDeclaration: () => import_builders.sponsoredPlacementFormatDeclaration,
+  stripLegacyCreativeIdentity: () => import_creative_delivery.stripLegacyCreativeIdentity,
   toCanonicalOnlyProduct: () => import_augment_response.toCanonicalOnlyProduct,
   toCanonicalOnlyResponse: () => import_augment_response.toCanonicalOnlyResponse,
   tryLegacyFormatIdsFromOptions: () => import_write_side.tryLegacyFormatIdsFromOptions,
@@ -66,12 +76,16 @@ var import_v2_to_v1 = require('./v2-to-v1.js');
 var import_augment_response = require('./augment-response.js');
 var import_builders = require('./builders.js');
 var import_write_side = require('./write-side.js');
+var import_catalog_snapshot = require('./catalog-snapshot.js');
 var import_catalog = require('./catalog.js');
 var import_canonical_properties = require('./canonical-properties.js');
+var import_creative_delivery = require('./creative-delivery.js');
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CanonicalFormat,
   CapabilityIdsLookupError,
+  CreativeFormatCapabilityError,
+  CreativeFormatProjectionError,
   FormatOptionRefsLookupError,
   _resetCatalogCache,
   agentPlacementFormatDeclaration,
@@ -80,18 +94,20 @@ var import_canonical_properties = require('./canonical-properties.js');
   augmentProductWithFormatOptions,
   canonicalDeclarationFromBareId,
   canonicalFormatDeclaration,
+  canonicalFormatLegacyResolverFromCatalogSnapshots,
   customFormatDeclaration,
   displayTagFormatDeclaration,
   findCatalogEntryByCanonicalAndSize,
-  formatRef,
-  formatRefs,
   html5FormatDeclaration,
   imageCarouselFormatDeclaration,
   imageFormatDeclaration,
   isCanonicalV1Translatable,
+  legacyFormatConverterFromCatalogSnapshots,
   legacyFormatIdsForCapability,
   legacyFormatIdsForFormatOption,
   legacyFormatIdsFromOptions,
+  legacyFormatRef,
+  legacyFormatRefs,
   loadCatalog,
   lookupV1Format,
   nativeInFeedFormatDeclaration,
@@ -100,11 +116,17 @@ var import_canonical_properties = require('./canonical-properties.js');
   parseSizedIdTemplate,
   productCard,
   productCardDetailed,
+  projectCreativeForDelivery,
+  projectMediaBuyCreativesForDelivery,
+  projectSyncCreativesForDelivery,
   projectV1ProductToV2,
   projectV2ProductToV1,
+  projectionAdaptersFromCatalogSnapshots,
   resolveCanonicalFormatKind,
+  resolveCreativeFormatWireMode,
   responsiveCreativeFormatDeclaration,
   sponsoredPlacementFormatDeclaration,
+  stripLegacyCreativeIdentity,
   toCanonicalOnlyProduct,
   toCanonicalOnlyResponse,
   tryLegacyFormatIdsFromOptions,

package/dist/lib/v2/projection/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/v2/projection/index.ts"],"sourcesContent":["/**\n * v1 ↔ v2 Product projection layer (AdCP 3.1).\n *\n * Public surfaces:\n *\n *   - `projectV1ProductToV2` / `projectV2ProductToV1` — the symmetric\n *     core projections. Read a Product on one side, return a Product\n *     on the other plus structured diagnostics (`source: 'sdk'`,\n *     normative spec codes + SDK-local codes).\n *\n *   - `resolveCanonicalFormatKind` / `canonicalDeclarationFromBareId` —\n *     resolve a single bare format-id string (no surrounding Product,\n *     no `agent_url`) to its canonical `format_kind` or full declaration.\n *     Registry- and catalog-backed; fails closed to `null`.\n *\n *   - `withFormatOptions` / `augmentProductWithFormatOptions` —\n *     buyer-side response augmentation. Adds `format_options[]` to a\n *     v1-shaped get_products response so canonical-format-aware buyers\n *     can read the canonical model regardless of the seller's wire\n *     version. Additive — `format_ids[]` is preserved.\n *\n *   - `toCanonicalOnlyProduct` / `toCanonicalOnlyResponse` — the\n *     read-side narrowing for a fully-migrated consumer. Returns\n *     `format_options[]` with `format_ids[]` dropped, surfacing a\n *     diagnostic for any ref that couldn't be carried over.\n *\n *   - Catalog + registry primitives (`lookupV1Format`,\n *     `findCatalogEntryByCanonicalAndSize`, registry exports) for\n *     callers wiring projection into their own code paths.\n *\n * Exposed from both `@adcp/sdk/v2/projection` and the package root for\n * adopters migrating from local format metadata and `product_card.format_id`\n * conventions to canonical creative formats.\n */\n\nexport { projectV1ProductToV2, canonicalDeclarationFromBareId, resolveCanonicalFormatKind } from './v1-to-v2';\nexport type { V1ToV2Result, BareFormatIdResolveOptions } from './v1-to-v2';\n\nexport { projectV2ProductToV1 } from './v2-to-v1';\nexport type { V2ToV1Result } from './v2-to-v1';\n\nexport {\n  augmentProductWithFormatOptions,\n  withFormatOptions,\n  toCanonicalOnlyProduct,\n  toCanonicalOnlyResponse,\n  type V2AugmentedProduct,\n  type CanonicalOnlyProduct,\n} from './augment-response';\n\nexport {\n  CanonicalFormat,\n  audioDaastFormatDeclaration,\n  audioHostedFormatDeclaration,\n  agentPlacementFormatDeclaration,\n  canonicalFormatDeclaration,\n  customFormatDeclaration,\n  displayTagFormatDeclaration,\n  formatRef,\n  formatRefs,\n  html5FormatDeclaration,\n  imageCarouselFormatDeclaration,\n  imageFormatDeclaration,\n  nativeInFeedFormatDeclaration,\n  productCard,\n  productCardDetailed,\n  responsiveCreativeFormatDeclaration,\n  sponsoredPlacementFormatDeclaration,\n  videoHostedFormatDeclaration,\n  videoVastFormatDeclaration,\n  type CanonicalFormatDeclaration,\n  type CanonicalFormatDeclarationFields,\n  type CanonicalFormatKind,\n  type CanonicalFormatParams,\n  type FormatReferenceInput,\n  type ProductCardDetailedFields,\n  type ProductCardFields,\n} from './builders';\n\nexport {\n  packageRefsForFormatOptions,\n  packageRefsForCapabilities,\n  legacyFormatIdsFromOptions,\n  tryLegacyFormatIdsFromOptions,\n  legacyFormatIdsForFormatOption,\n  legacyFormatIdsForCapability,\n  FormatOptionRefsLookupError,\n  CapabilityIdsLookupError,\n  type PackageFormatRefs,\n  type PackageCapabilityRefs,\n  type FormatOptionRef,\n  type FormatOptionSelector,\n  type FormatOptionRefsLookupErrorCode,\n  type CapabilityIdsLookupErrorCode,\n} from './write-side';\n\nexport type { V1FormatId, V2ProductFormatDeclaration, V2Product, V1Product, ProjectionDiagnostic } from './types';\n\nexport {\n  loadCatalog,\n  lookupV1Format,\n  findCatalogEntryByCanonicalAndSize,\n  parseSizedIdTemplate,\n  _resetCatalogCache,\n  type V1FormatDefinition,\n  type CanonicalProjectionRef,\n} from './catalog';\n\nexport { isCanonicalV1Translatable } from './canonical-properties';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmCA,sBAAiG;AAGjG,sBAAqC;AAGrC,8BAOO;AAEP,sBA2BO;AAEP,wBAeO;AAIP,qBAQO;AAEP,kCAA0C;","names":[]}
+{"version":3,"sources":["../../../../src/lib/v2/projection/index.ts"],"sourcesContent":["/**\n * v1 ↔ v2 Product projection layer (AdCP 3.1).\n *\n * Public surfaces:\n *\n *   - `projectV1ProductToV2` / `projectV2ProductToV1` — the symmetric\n *     core projections. Read a Product on one side, return a Product\n *     on the other plus structured diagnostics (`source: 'sdk'`,\n *     normative spec codes + SDK-local codes).\n *\n *   - `resolveCanonicalFormatKind` / `canonicalDeclarationFromBareId` —\n *     resolve a single bare format-id string (no surrounding Product,\n *     no `agent_url`) to its canonical `format_kind` or full declaration.\n *     Registry- and catalog-backed; fails closed to `null`.\n *\n *   - `withFormatOptions` / `augmentProductWithFormatOptions` —\n *     buyer-side response augmentation. Adds `format_options[]` to a\n *     v1-shaped get_products response so canonical-format-aware buyers\n *     can read the canonical model regardless of the seller's wire\n *     version. Additive — `format_ids[]` is preserved.\n *\n *   - `toCanonicalOnlyProduct` / `toCanonicalOnlyResponse` — the\n *     read-side narrowing for a fully-migrated consumer. Returns\n *     `format_options[]` with `format_ids[]` dropped, surfacing a\n *     diagnostic for any ref that couldn't be carried over.\n *\n *   - Catalog + registry primitives (`lookupV1Format`,\n *     `findCatalogEntryByCanonicalAndSize`, registry exports) for\n *     callers wiring projection into their own code paths.\n *\n * Legacy-preserving and raw wire projection helpers are exposed only from\n * `@adcp/sdk/v2/projection`. The package root exports the canonical authoring\n * surface so ordinary buyers do not accidentally retain legacy identities.\n */\n\nexport { projectV1ProductToV2, canonicalDeclarationFromBareId, resolveCanonicalFormatKind } from './v1-to-v2';\nexport type {\n  V1ToV2Result,\n  V1ToV2ProjectionOptions,\n  BareFormatIdResolveOptions,\n  LegacyFormatConversionContext,\n  LegacyFormatConverter,\n} from './v1-to-v2';\n\nexport { projectV2ProductToV1 } from './v2-to-v1';\nexport type {\n  V2ToV1Result,\n  V2ToV1ProjectionOptions,\n  CanonicalFormatLegacyResolver,\n  CanonicalFormatLegacyResolutionContext,\n  CanonicalProductFormatLegacyResolutionContext,\n  CanonicalCreativeFormatLegacyResolutionContext,\n  CanonicalSelectorFormatLegacyResolutionContext,\n} from './v2-to-v1';\n\nexport {\n  augmentProductWithFormatOptions,\n  withFormatOptions,\n  toCanonicalOnlyProduct,\n  toCanonicalOnlyResponse,\n  type V2AugmentedProduct,\n  type CanonicalOnlyProduct,\n} from './augment-response';\n\nexport {\n  CanonicalFormat,\n  audioDaastFormatDeclaration,\n  audioHostedFormatDeclaration,\n  agentPlacementFormatDeclaration,\n  canonicalFormatDeclaration,\n  customFormatDeclaration,\n  displayTagFormatDeclaration,\n  legacyFormatRef,\n  legacyFormatRefs,\n  html5FormatDeclaration,\n  imageCarouselFormatDeclaration,\n  imageFormatDeclaration,\n  nativeInFeedFormatDeclaration,\n  productCard,\n  productCardDetailed,\n  responsiveCreativeFormatDeclaration,\n  sponsoredPlacementFormatDeclaration,\n  videoHostedFormatDeclaration,\n  videoVastFormatDeclaration,\n  type CanonicalFormatDeclaration,\n  type CanonicalFormatDeclarationFields,\n  type CanonicalFormatKind,\n  type CanonicalFormatParams,\n  type FormatReferenceInput,\n  type ProductCardDetailedFields,\n  type ProductCardFields,\n} from './builders';\n\nexport {\n  packageRefsForFormatOptions,\n  packageRefsForCapabilities,\n  legacyFormatIdsFromOptions,\n  tryLegacyFormatIdsFromOptions,\n  legacyFormatIdsForFormatOption,\n  legacyFormatIdsForCapability,\n  FormatOptionRefsLookupError,\n  CapabilityIdsLookupError,\n  type PackageFormatRefs,\n  type PackageCapabilityRefs,\n  type FormatOptionRef,\n  type FormatOptionSelector,\n  type FormatOptionRefsLookupErrorCode,\n  type CapabilityIdsLookupErrorCode,\n} from './write-side';\n\nexport type { V1FormatId, V2ProductFormatDeclaration, V2Product, V1Product, ProjectionDiagnostic } from './types';\nexport {\n  legacyFormatConverterFromCatalogSnapshots,\n  canonicalFormatLegacyResolverFromCatalogSnapshots,\n  projectionAdaptersFromCatalogSnapshots,\n  type ProjectionCatalogAdapters,\n  type ProjectionCatalogSnapshot,\n  type ProjectionCatalogSource,\n} from './catalog-snapshot';\n\nexport {\n  loadCatalog,\n  lookupV1Format,\n  findCatalogEntryByCanonicalAndSize,\n  parseSizedIdTemplate,\n  _resetCatalogCache,\n  type V1FormatDefinition,\n  type CanonicalProjectionRef,\n} from './catalog';\n\nexport { isCanonicalV1Translatable } from './canonical-properties';\n\nexport {\n  CreativeFormatProjectionError,\n  CreativeFormatCapabilityError,\n  projectCreativeForDelivery,\n  projectMediaBuyCreativesForDelivery,\n  projectSyncCreativesForDelivery,\n  stripLegacyCreativeIdentity,\n  resolveCreativeFormatWireMode,\n  type CreativeFormatSelectorContainer,\n  type CanonicalCreativeFormatSelectorContainer,\n  type CreativeFormatWireMode,\n  type CanonicalCreativeAsset,\n  type CanonicalCreativeResponse,\n  type CanonicalGetProductsResponse,\n  type CanonicalGetProductsRequest,\n  type CanonicalCreateMediaBuyRequest,\n  type CanonicalCreateMediaBuyResponse,\n  type CanonicalCreativeFilters,\n  type CanonicalListCreativesRequest,\n  type CanonicalListCreativesResponse,\n  type CanonicalGetCreativeDeliveryResponse,\n  type CanonicalGetMediaBuyDeliveryResponse,\n  type CanonicalGetMediaBuysResponse,\n  type CanonicalListedCreative,\n  type CanonicalPackageRequest,\n  type CanonicalPackageUpdate,\n  type CanonicalPackage,\n  type CanonicalPlacement,\n  type CanonicalProduct,\n  type CanonicalProjectedCreative,\n  type CanonicalSyncCreativesRequest,\n  type CanonicalSyncCreativesResponse,\n  type CanonicalUpdateMediaBuyRequest,\n  type CanonicalUpdateMediaBuyResponse,\n  type LegacyCreativeAsset,\n  type LegacyProjectedCreative,\n  type ProjectedMediaBuyCreativeRequest,\n  type ProjectedSyncCreativeRequest,\n  type SyncCreativeFormatProjection,\n} from './creative-delivery';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmCA,sBAAiG;AASjG,sBAAqC;AAWrC,8BAOO;AAEP,sBA2BO;AAEP,wBAeO;AAGP,8BAOO;AAEP,qBAQO;AAEP,kCAA0C;AAE1C,+BAuCO;","names":[]}

package/dist/lib/v2/projection/index.mjs

@@ -14,8 +14,8 @@ import {
   canonicalFormatDeclaration,
   customFormatDeclaration,
   displayTagFormatDeclaration,
-  formatRef,
-  formatRefs,
+  legacyFormatRef,
+  legacyFormatRefs,
   html5FormatDeclaration,
   imageCarouselFormatDeclaration,
   imageFormatDeclaration,
@@ -37,6 +37,11 @@ import {
   FormatOptionRefsLookupError,
   CapabilityIdsLookupError
 } from "./write-side.mjs";
+import {
+  legacyFormatConverterFromCatalogSnapshots,
+  canonicalFormatLegacyResolverFromCatalogSnapshots,
+  projectionAdaptersFromCatalogSnapshots
+} from "./catalog-snapshot.mjs";
 import {
   loadCatalog,
   lookupV1Format,
@@ -45,9 +50,20 @@ import {
   _resetCatalogCache
 } from "./catalog.mjs";
 import { isCanonicalV1Translatable } from "./canonical-properties.mjs";
+import {
+  CreativeFormatProjectionError,
+  CreativeFormatCapabilityError,
+  projectCreativeForDelivery,
+  projectMediaBuyCreativesForDelivery,
+  projectSyncCreativesForDelivery,
+  stripLegacyCreativeIdentity,
+  resolveCreativeFormatWireMode
+} from "./creative-delivery.mjs";
 export {
   CanonicalFormat,
   CapabilityIdsLookupError,
+  CreativeFormatCapabilityError,
+  CreativeFormatProjectionError,
   FormatOptionRefsLookupError,
   _resetCatalogCache,
   agentPlacementFormatDeclaration,
@@ -56,18 +72,20 @@ export {
   augmentProductWithFormatOptions,
   canonicalDeclarationFromBareId,
   canonicalFormatDeclaration,
+  canonicalFormatLegacyResolverFromCatalogSnapshots,
   customFormatDeclaration,
   displayTagFormatDeclaration,
   findCatalogEntryByCanonicalAndSize,
-  formatRef,
-  formatRefs,
   html5FormatDeclaration,
   imageCarouselFormatDeclaration,
   imageFormatDeclaration,
   isCanonicalV1Translatable,
+  legacyFormatConverterFromCatalogSnapshots,
   legacyFormatIdsForCapability,
   legacyFormatIdsForFormatOption,
   legacyFormatIdsFromOptions,
+  legacyFormatRef,
+  legacyFormatRefs,
   loadCatalog,
   lookupV1Format,
   nativeInFeedFormatDeclaration,
@@ -76,11 +94,17 @@ export {
   parseSizedIdTemplate,
   productCard,
   productCardDetailed,
+  projectCreativeForDelivery,
+  projectMediaBuyCreativesForDelivery,
+  projectSyncCreativesForDelivery,
   projectV1ProductToV2,
   projectV2ProductToV1,
+  projectionAdaptersFromCatalogSnapshots,
   resolveCanonicalFormatKind,
+  resolveCreativeFormatWireMode,
   responsiveCreativeFormatDeclaration,
   sponsoredPlacementFormatDeclaration,
+  stripLegacyCreativeIdentity,
   toCanonicalOnlyProduct,
   toCanonicalOnlyResponse,
   tryLegacyFormatIdsFromOptions,

package/dist/lib/v2/projection/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/v2/projection/index.ts"],"sourcesContent":["/**\n * v1 ↔ v2 Product projection layer (AdCP 3.1).\n *\n * Public surfaces:\n *\n *   - `projectV1ProductToV2` / `projectV2ProductToV1` — the symmetric\n *     core projections. Read a Product on one side, return a Product\n *     on the other plus structured diagnostics (`source: 'sdk'`,\n *     normative spec codes + SDK-local codes).\n *\n *   - `resolveCanonicalFormatKind` / `canonicalDeclarationFromBareId` —\n *     resolve a single bare format-id string (no surrounding Product,\n *     no `agent_url`) to its canonical `format_kind` or full declaration.\n *     Registry- and catalog-backed; fails closed to `null`.\n *\n *   - `withFormatOptions` / `augmentProductWithFormatOptions` —\n *     buyer-side response augmentation. Adds `format_options[]` to a\n *     v1-shaped get_products response so canonical-format-aware buyers\n *     can read the canonical model regardless of the seller's wire\n *     version. Additive — `format_ids[]` is preserved.\n *\n *   - `toCanonicalOnlyProduct` / `toCanonicalOnlyResponse` — the\n *     read-side narrowing for a fully-migrated consumer. Returns\n *     `format_options[]` with `format_ids[]` dropped, surfacing a\n *     diagnostic for any ref that couldn't be carried over.\n *\n *   - Catalog + registry primitives (`lookupV1Format`,\n *     `findCatalogEntryByCanonicalAndSize`, registry exports) for\n *     callers wiring projection into their own code paths.\n *\n * Exposed from both `@adcp/sdk/v2/projection` and the package root for\n * adopters migrating from local format metadata and `product_card.format_id`\n * conventions to canonical creative formats.\n */\n\nexport { projectV1ProductToV2, canonicalDeclarationFromBareId, resolveCanonicalFormatKind } from './v1-to-v2';\nexport type { V1ToV2Result, BareFormatIdResolveOptions } from './v1-to-v2';\n\nexport { projectV2ProductToV1 } from './v2-to-v1';\nexport type { V2ToV1Result } from './v2-to-v1';\n\nexport {\n  augmentProductWithFormatOptions,\n  withFormatOptions,\n  toCanonicalOnlyProduct,\n  toCanonicalOnlyResponse,\n  type V2AugmentedProduct,\n  type CanonicalOnlyProduct,\n} from './augment-response';\n\nexport {\n  CanonicalFormat,\n  audioDaastFormatDeclaration,\n  audioHostedFormatDeclaration,\n  agentPlacementFormatDeclaration,\n  canonicalFormatDeclaration,\n  customFormatDeclaration,\n  displayTagFormatDeclaration,\n  formatRef,\n  formatRefs,\n  html5FormatDeclaration,\n  imageCarouselFormatDeclaration,\n  imageFormatDeclaration,\n  nativeInFeedFormatDeclaration,\n  productCard,\n  productCardDetailed,\n  responsiveCreativeFormatDeclaration,\n  sponsoredPlacementFormatDeclaration,\n  videoHostedFormatDeclaration,\n  videoVastFormatDeclaration,\n  type CanonicalFormatDeclaration,\n  type CanonicalFormatDeclarationFields,\n  type CanonicalFormatKind,\n  type CanonicalFormatParams,\n  type FormatReferenceInput,\n  type ProductCardDetailedFields,\n  type ProductCardFields,\n} from './builders';\n\nexport {\n  packageRefsForFormatOptions,\n  packageRefsForCapabilities,\n  legacyFormatIdsFromOptions,\n  tryLegacyFormatIdsFromOptions,\n  legacyFormatIdsForFormatOption,\n  legacyFormatIdsForCapability,\n  FormatOptionRefsLookupError,\n  CapabilityIdsLookupError,\n  type PackageFormatRefs,\n  type PackageCapabilityRefs,\n  type FormatOptionRef,\n  type FormatOptionSelector,\n  type FormatOptionRefsLookupErrorCode,\n  type CapabilityIdsLookupErrorCode,\n} from './write-side';\n\nexport type { V1FormatId, V2ProductFormatDeclaration, V2Product, V1Product, ProjectionDiagnostic } from './types';\n\nexport {\n  loadCatalog,\n  lookupV1Format,\n  findCatalogEntryByCanonicalAndSize,\n  parseSizedIdTemplate,\n  _resetCatalogCache,\n  type V1FormatDefinition,\n  type CanonicalProjectionRef,\n} from './catalog';\n\nexport { isCanonicalV1Translatable } from './canonical-properties';\n"],"mappings":"AAmCA,SAAS,sBAAsB,gCAAgC,kCAAkC;AAGjG,SAAS,4BAA4B;AAGrC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAQK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAOK;AAIP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP,SAAS,iCAAiC;","names":[]}
+{"version":3,"sources":["../../../../src/lib/v2/projection/index.ts"],"sourcesContent":["/**\n * v1 ↔ v2 Product projection layer (AdCP 3.1).\n *\n * Public surfaces:\n *\n *   - `projectV1ProductToV2` / `projectV2ProductToV1` — the symmetric\n *     core projections. Read a Product on one side, return a Product\n *     on the other plus structured diagnostics (`source: 'sdk'`,\n *     normative spec codes + SDK-local codes).\n *\n *   - `resolveCanonicalFormatKind` / `canonicalDeclarationFromBareId` —\n *     resolve a single bare format-id string (no surrounding Product,\n *     no `agent_url`) to its canonical `format_kind` or full declaration.\n *     Registry- and catalog-backed; fails closed to `null`.\n *\n *   - `withFormatOptions` / `augmentProductWithFormatOptions` —\n *     buyer-side response augmentation. Adds `format_options[]` to a\n *     v1-shaped get_products response so canonical-format-aware buyers\n *     can read the canonical model regardless of the seller's wire\n *     version. Additive — `format_ids[]` is preserved.\n *\n *   - `toCanonicalOnlyProduct` / `toCanonicalOnlyResponse` — the\n *     read-side narrowing for a fully-migrated consumer. Returns\n *     `format_options[]` with `format_ids[]` dropped, surfacing a\n *     diagnostic for any ref that couldn't be carried over.\n *\n *   - Catalog + registry primitives (`lookupV1Format`,\n *     `findCatalogEntryByCanonicalAndSize`, registry exports) for\n *     callers wiring projection into their own code paths.\n *\n * Legacy-preserving and raw wire projection helpers are exposed only from\n * `@adcp/sdk/v2/projection`. The package root exports the canonical authoring\n * surface so ordinary buyers do not accidentally retain legacy identities.\n */\n\nexport { projectV1ProductToV2, canonicalDeclarationFromBareId, resolveCanonicalFormatKind } from './v1-to-v2';\nexport type {\n  V1ToV2Result,\n  V1ToV2ProjectionOptions,\n  BareFormatIdResolveOptions,\n  LegacyFormatConversionContext,\n  LegacyFormatConverter,\n} from './v1-to-v2';\n\nexport { projectV2ProductToV1 } from './v2-to-v1';\nexport type {\n  V2ToV1Result,\n  V2ToV1ProjectionOptions,\n  CanonicalFormatLegacyResolver,\n  CanonicalFormatLegacyResolutionContext,\n  CanonicalProductFormatLegacyResolutionContext,\n  CanonicalCreativeFormatLegacyResolutionContext,\n  CanonicalSelectorFormatLegacyResolutionContext,\n} from './v2-to-v1';\n\nexport {\n  augmentProductWithFormatOptions,\n  withFormatOptions,\n  toCanonicalOnlyProduct,\n  toCanonicalOnlyResponse,\n  type V2AugmentedProduct,\n  type CanonicalOnlyProduct,\n} from './augment-response';\n\nexport {\n  CanonicalFormat,\n  audioDaastFormatDeclaration,\n  audioHostedFormatDeclaration,\n  agentPlacementFormatDeclaration,\n  canonicalFormatDeclaration,\n  customFormatDeclaration,\n  displayTagFormatDeclaration,\n  legacyFormatRef,\n  legacyFormatRefs,\n  html5FormatDeclaration,\n  imageCarouselFormatDeclaration,\n  imageFormatDeclaration,\n  nativeInFeedFormatDeclaration,\n  productCard,\n  productCardDetailed,\n  responsiveCreativeFormatDeclaration,\n  sponsoredPlacementFormatDeclaration,\n  videoHostedFormatDeclaration,\n  videoVastFormatDeclaration,\n  type CanonicalFormatDeclaration,\n  type CanonicalFormatDeclarationFields,\n  type CanonicalFormatKind,\n  type CanonicalFormatParams,\n  type FormatReferenceInput,\n  type ProductCardDetailedFields,\n  type ProductCardFields,\n} from './builders';\n\nexport {\n  packageRefsForFormatOptions,\n  packageRefsForCapabilities,\n  legacyFormatIdsFromOptions,\n  tryLegacyFormatIdsFromOptions,\n  legacyFormatIdsForFormatOption,\n  legacyFormatIdsForCapability,\n  FormatOptionRefsLookupError,\n  CapabilityIdsLookupError,\n  type PackageFormatRefs,\n  type PackageCapabilityRefs,\n  type FormatOptionRef,\n  type FormatOptionSelector,\n  type FormatOptionRefsLookupErrorCode,\n  type CapabilityIdsLookupErrorCode,\n} from './write-side';\n\nexport type { V1FormatId, V2ProductFormatDeclaration, V2Product, V1Product, ProjectionDiagnostic } from './types';\nexport {\n  legacyFormatConverterFromCatalogSnapshots,\n  canonicalFormatLegacyResolverFromCatalogSnapshots,\n  projectionAdaptersFromCatalogSnapshots,\n  type ProjectionCatalogAdapters,\n  type ProjectionCatalogSnapshot,\n  type ProjectionCatalogSource,\n} from './catalog-snapshot';\n\nexport {\n  loadCatalog,\n  lookupV1Format,\n  findCatalogEntryByCanonicalAndSize,\n  parseSizedIdTemplate,\n  _resetCatalogCache,\n  type V1FormatDefinition,\n  type CanonicalProjectionRef,\n} from './catalog';\n\nexport { isCanonicalV1Translatable } from './canonical-properties';\n\nexport {\n  CreativeFormatProjectionError,\n  CreativeFormatCapabilityError,\n  projectCreativeForDelivery,\n  projectMediaBuyCreativesForDelivery,\n  projectSyncCreativesForDelivery,\n  stripLegacyCreativeIdentity,\n  resolveCreativeFormatWireMode,\n  type CreativeFormatSelectorContainer,\n  type CanonicalCreativeFormatSelectorContainer,\n  type CreativeFormatWireMode,\n  type CanonicalCreativeAsset,\n  type CanonicalCreativeResponse,\n  type CanonicalGetProductsResponse,\n  type CanonicalGetProductsRequest,\n  type CanonicalCreateMediaBuyRequest,\n  type CanonicalCreateMediaBuyResponse,\n  type CanonicalCreativeFilters,\n  type CanonicalListCreativesRequest,\n  type CanonicalListCreativesResponse,\n  type CanonicalGetCreativeDeliveryResponse,\n  type CanonicalGetMediaBuyDeliveryResponse,\n  type CanonicalGetMediaBuysResponse,\n  type CanonicalListedCreative,\n  type CanonicalPackageRequest,\n  type CanonicalPackageUpdate,\n  type CanonicalPackage,\n  type CanonicalPlacement,\n  type CanonicalProduct,\n  type CanonicalProjectedCreative,\n  type CanonicalSyncCreativesRequest,\n  type CanonicalSyncCreativesResponse,\n  type CanonicalUpdateMediaBuyRequest,\n  type CanonicalUpdateMediaBuyResponse,\n  type LegacyCreativeAsset,\n  type LegacyProjectedCreative,\n  type ProjectedMediaBuyCreativeRequest,\n  type ProjectedSyncCreativeRequest,\n  type SyncCreativeFormatProjection,\n} from './creative-delivery';\n"],"mappings":"AAmCA,SAAS,sBAAsB,gCAAgC,kCAAkC;AASjG,SAAS,4BAA4B;AAWrC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAQK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAOK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP,SAAS,iCAAiC;AAE1C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAgCK;","names":[]}

package/dist/lib/v2/projection/legacy-metadata.d.mts

@@ -0,0 +1,21 @@
+import type { ProductFormatDeclaration } from '../../types/tools.generated.mjs';
+import type { V1FormatId, V2ProductFormatDeclaration } from './types.mjs';
+/**
+ * SDK-private downgrade metadata held out-of-band. WeakMaps keep legacy
+ * routing identifiers absent from canonical objects even under reflective
+ * inspection while still allowing object-spread package authoring.
+ */
+export type CanonicalFormatDeclaration = Omit<V2ProductFormatDeclaration, 'v1_format_ref'> & {
+    v1_format_ref?: never;
+};
+type DeclarationWithMetadata = CanonicalFormatDeclaration;
+export type PackageSelectionMetadata = {
+    format_option_refs?: readonly unknown[];
+};
+export declare function concealLegacyFormatRefs(declaration: ProductFormatDeclaration | V2ProductFormatDeclaration | CanonicalFormatDeclaration): DeclarationWithMetadata;
+export declare function legacyFormatRefsForDeclaration(value: unknown): readonly V1FormatId[];
+export declare function selectedFormatOptions(value: unknown): readonly DeclarationWithMetadata[];
+export declare function concealSelectedFormatOptions(refs: readonly unknown[], declarations: readonly DeclarationWithMetadata[]): void;
+/** Preserve out-of-band downgrade metadata when a canonical sanitizer clones a value. */
+export declare function transferLegacyCreativeMetadata(source: object, target: object): void;
+export {};

package/dist/lib/v2/projection/legacy-metadata.d.ts

@@ -0,0 +1,22 @@
+import type { ProductFormatDeclaration } from '../../types/tools.generated';
+import type { V1FormatId, V2ProductFormatDeclaration } from './types';
+/**
+ * SDK-private downgrade metadata held out-of-band. WeakMaps keep legacy
+ * routing identifiers absent from canonical objects even under reflective
+ * inspection while still allowing object-spread package authoring.
+ */
+export type CanonicalFormatDeclaration = Omit<V2ProductFormatDeclaration, 'v1_format_ref'> & {
+    v1_format_ref?: never;
+};
+type DeclarationWithMetadata = CanonicalFormatDeclaration;
+export type PackageSelectionMetadata = {
+    format_option_refs?: readonly unknown[];
+};
+export declare function concealLegacyFormatRefs(declaration: ProductFormatDeclaration | V2ProductFormatDeclaration | CanonicalFormatDeclaration): DeclarationWithMetadata;
+export declare function legacyFormatRefsForDeclaration(value: unknown): readonly V1FormatId[];
+export declare function selectedFormatOptions(value: unknown): readonly DeclarationWithMetadata[];
+export declare function concealSelectedFormatOptions(refs: readonly unknown[], declarations: readonly DeclarationWithMetadata[]): void;
+/** Preserve out-of-band downgrade metadata when a canonical sanitizer clones a value. */
+export declare function transferLegacyCreativeMetadata(source: object, target: object): void;
+export {};
+//# sourceMappingURL=legacy-metadata.d.ts.map

package/dist/lib/v2/projection/legacy-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-metadata.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/legacy-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAEtE;;;;GAIG;AAEH,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,0BAA0B,EAAE,eAAe,CAAC,GAAG;IAC3F,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB,CAAC;AAEF,KAAK,uBAAuB,GAAG,0BAA0B,CAAC;AAE1D,MAAM,MAAM,wBAAwB,GAAG;IACrC,kBAAkB,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACzC,CAAC;AAKF,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,wBAAwB,GAAG,0BAA0B,GAAG,0BAA0B,GAC9F,uBAAuB,CAWzB;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,UAAU,EAAE,CAMpF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,uBAAuB,EAAE,CAMxF;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,YAAY,EAAE,SAAS,uBAAuB,EAAE,GAC/C,IAAI,CAEN;AAED,yFAAyF;AACzF,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAKnF"}