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

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

@@ -1,22 +1,9 @@
-/**
- * Preview Response Normalizer
- *
- * Handles conversion between v2 output_id/output_role and v3 render_id/role.
- * The library exposes only v3 API to clients.
- */
-/**
- * v3 preview render
- */
+/** Helpers for reading AdCP 3 creative previews. */
 export interface PreviewRendererMetadata {
-    /** Stable identifier for the renderer implementation. */
     renderer_id: string;
-    /** Exact semantic version of the renderer implementation. */
     version: string;
-    /** Named package export or implementation entry point used. */
     export: string;
-    /** Whether this renderer represents serving-platform output or an approximation. */
     fidelity: 'authoritative' | 'representative';
-    /** True when delivery and measurement side effects were suppressed. */
     tracking_suppressed: boolean;
     [key: string]: unknown;
 }
@@ -35,36 +22,12 @@ export interface PreviewRenderV3 {
         requires_https?: boolean;
         supports_fullscreen?: boolean;
         csp_policy?: string;
+        [key: string]: unknown;
     };
     /** Renderer provenance and safety metadata; it does not independently grant authority. */
     renderer?: PreviewRendererMetadata;
+    [key: string]: unknown;
 }
-/**
- * v2 preview render (with old field names)
- */
-export interface PreviewRenderV2 {
-    output_id?: string;
-    output_role?: string;
-    render_id?: string;
-    role?: string;
-    output_format: 'url' | 'html' | 'both';
-    preview_url?: string;
-    preview_html?: string;
-    dimensions?: {
-        width: number;
-        height: number;
-    };
-    embedding?: {
-        recommended_sandbox?: string;
-        requires_https?: boolean;
-        supports_fullscreen?: boolean;
-        csp_policy?: string;
-    };
-    renderer?: PreviewRendererMetadata;
-}
-/**
- * v3 preview object
- */
 export interface PreviewV3 {
     preview_id: string;
     renders: PreviewRenderV3[];
@@ -72,53 +35,41 @@ export interface PreviewV3 {
         name: string;
         macros?: Record<string, unknown>;
         context_description?: string;
+        [key: string]: unknown;
     };
     interactive_url?: string;
     expires_at: string;
+    [key: string]: unknown;
 }
-/**
- * Normalize a preview render from v2 to v3 format
- */
-export declare function normalizePreviewRender(render: PreviewRenderV2): PreviewRenderV3;
-/**
- * Normalize a preview object (normalizes all renders)
- */
-export declare function normalizePreview(preview: any): PreviewV3;
-/**
- * Normalize a preview_creative response (single or batch)
- */
-export declare function normalizePreviewCreativeResponse(response: any): any;
-/**
- * Check if a render uses v2 field names
- */
-export declare function usesV2RenderFields(render: any): boolean;
-/**
- * Check if a render uses v3 field names
- */
-export declare function usesV3RenderFields(render: any): boolean;
-/**
- * Get render ID from a render (works with both v2 and v3)
- */
-export declare function getRenderId(render: PreviewRenderV2 | PreviewRenderV3): string;
-/**
- * Get render role from a render (works with both v2 and v3)
- */
-export declare function getRenderRole(render: PreviewRenderV2 | PreviewRenderV3): string;
-/**
- * Get primary render from a preview
- */
+interface PreviewCreativeResponseV3 {
+    previews?: PreviewV3[];
+    results?: {
+        success?: boolean;
+        response?: {
+            previews?: PreviewV3[];
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    }[];
+    [key: string]: unknown;
+}
+/** Preserve the supplied render, including provenance and extension fields. */
+export declare function normalizePreviewRender<T extends PreviewRenderV3>(render: T): T;
+/** Preserve an AdCP 3 preview and all of its supplied renders. */
+export declare function normalizePreview<T extends PreviewV3>(preview: T): T;
+/** Preserve an AdCP 3 single or batch preview response. */
+export declare function normalizePreviewCreativeResponse<T extends PreviewCreativeResponseV3>(response: T): T;
+export declare function usesV3RenderFields(render: PreviewRenderV3): boolean;
+export declare function getRenderId(render: PreviewRenderV3): string;
+export declare function getRenderRole(render: PreviewRenderV3): string;
+/** Select the primary render, or the first supplied render when no primary is declared. */
 export declare function getPrimaryPreviewRender(preview: {
-    renders: (PreviewRenderV2 | PreviewRenderV3)[];
+    renders: PreviewRenderV3[];
 }): PreviewRenderV3 | undefined;
-/**
- * Get preview URL from primary render
- */
 export declare function getPreviewUrl(preview: {
-    renders: (PreviewRenderV2 | PreviewRenderV3)[];
+    renders: PreviewRenderV3[];
 }): string | undefined;
-/**
- * Get preview HTML from primary render
- */
 export declare function getPreviewHtml(preview: {
-    renders: (PreviewRenderV2 | PreviewRenderV3)[];
+    renders: PreviewRenderV3[];
 }): string | undefined;
+export {};

package/dist/lib/utils/preview-normalizer.js

@@ -26,73 +26,29 @@ __export(preview_normalizer_exports, {
   normalizePreview: () => normalizePreview,
   normalizePreviewCreativeResponse: () => normalizePreviewCreativeResponse,
   normalizePreviewRender: () => normalizePreviewRender,
-  usesV2RenderFields: () => usesV2RenderFields,
   usesV3RenderFields: () => usesV3RenderFields
 });
 module.exports = __toCommonJS(preview_normalizer_exports);
 function normalizePreviewRender(render) {
-  return {
-    // Prefer v3 field names, fall back to v2
-    render_id: render.render_id ?? render.output_id ?? "primary",
-    role: render.role ?? render.output_role ?? "primary",
-    output_format: render.output_format,
-    preview_url: render.preview_url,
-    preview_html: render.preview_html,
-    dimensions: render.dimensions,
-    embedding: render.embedding,
-    renderer: render.renderer
-  };
+  return render;
 }
 function normalizePreview(preview) {
-  if (!preview.renders || !Array.isArray(preview.renders)) {
-    return preview;
-  }
-  return {
-    ...preview,
-    renders: preview.renders.map(normalizePreviewRender)
-  };
+  return preview;
 }
 function normalizePreviewCreativeResponse(response) {
-  if (response.previews && Array.isArray(response.previews)) {
-    return {
-      ...response,
-      previews: response.previews.map(normalizePreview)
-    };
-  }
-  if (response.results && Array.isArray(response.results)) {
-    return {
-      ...response,
-      results: response.results.map((result) => {
-        if (result.success && result.response?.previews) {
-          return {
-            ...result,
-            response: {
-              ...result.response,
-              previews: result.response.previews.map(normalizePreview)
-            }
-          };
-        }
-        return result;
-      })
-    };
-  }
   return response;
 }
-function usesV2RenderFields(render) {
-  return (render.output_id !== void 0 || render.output_role !== void 0) && render.render_id === void 0 && render.role === void 0;
-}
 function usesV3RenderFields(render) {
   return render.render_id !== void 0 || render.role !== void 0;
 }
 function getRenderId(render) {
-  return render.render_id ?? render.output_id ?? "primary";
+  return render.render_id;
 }
 function getRenderRole(render) {
-  return render.role ?? render.output_role ?? "primary";
+  return render.role;
 }
 function getPrimaryPreviewRender(preview) {
-  const renders = preview.renders.map(normalizePreviewRender);
-  return renders.find((r) => r.role === "primary") ?? renders[0];
+  return preview.renders.find((render) => render.role === "primary") ?? preview.renders[0];
 }
 function getPreviewUrl(preview) {
   return getPrimaryPreviewRender(preview)?.preview_url;
@@ -110,6 +66,5 @@ function getPreviewHtml(preview) {
   normalizePreview,
   normalizePreviewCreativeResponse,
   normalizePreviewRender,
-  usesV2RenderFields,
   usesV3RenderFields
 });

package/dist/lib/utils/preview-normalizer.mjs

@@ -1,66 +1,23 @@
 function normalizePreviewRender(render) {
-  return {
-    // Prefer v3 field names, fall back to v2
-    render_id: render.render_id ?? render.output_id ?? "primary",
-    role: render.role ?? render.output_role ?? "primary",
-    output_format: render.output_format,
-    preview_url: render.preview_url,
-    preview_html: render.preview_html,
-    dimensions: render.dimensions,
-    embedding: render.embedding,
-    renderer: render.renderer
-  };
+  return render;
 }
 function normalizePreview(preview) {
-  if (!preview.renders || !Array.isArray(preview.renders)) {
-    return preview;
-  }
-  return {
-    ...preview,
-    renders: preview.renders.map(normalizePreviewRender)
-  };
+  return preview;
 }
 function normalizePreviewCreativeResponse(response) {
-  if (response.previews && Array.isArray(response.previews)) {
-    return {
-      ...response,
-      previews: response.previews.map(normalizePreview)
-    };
-  }
-  if (response.results && Array.isArray(response.results)) {
-    return {
-      ...response,
-      results: response.results.map((result) => {
-        if (result.success && result.response?.previews) {
-          return {
-            ...result,
-            response: {
-              ...result.response,
-              previews: result.response.previews.map(normalizePreview)
-            }
-          };
-        }
-        return result;
-      })
-    };
-  }
   return response;
 }
-function usesV2RenderFields(render) {
-  return (render.output_id !== void 0 || render.output_role !== void 0) && render.render_id === void 0 && render.role === void 0;
-}
 function usesV3RenderFields(render) {
   return render.render_id !== void 0 || render.role !== void 0;
 }
 function getRenderId(render) {
-  return render.render_id ?? render.output_id ?? "primary";
+  return render.render_id;
 }
 function getRenderRole(render) {
-  return render.role ?? render.output_role ?? "primary";
+  return render.role;
 }
 function getPrimaryPreviewRender(preview) {
-  const renders = preview.renders.map(normalizePreviewRender);
-  return renders.find((r) => r.role === "primary") ?? renders[0];
+  return preview.renders.find((render) => render.role === "primary") ?? preview.renders[0];
 }
 function getPreviewUrl(preview) {
   return getPrimaryPreviewRender(preview)?.preview_url;
@@ -77,6 +34,5 @@ export {
   normalizePreview,
   normalizePreviewCreativeResponse,
   normalizePreviewRender,
-  usesV2RenderFields,
   usesV3RenderFields
 };

package/dist/lib/utils/pricing-adapter.d.mts

@@ -1,9 +1,7 @@
 /**
  * Pricing Option Adapter
  *
- * Handles conversion between v2.x and v3 pricing option field names.
- * The library exposes only v3 API (fixed_price, floor_price) to clients,
- * and internally adapts requests for v2.x servers.
+ * Normalizes historical pricing fields for established AdCP 3 catalogs.
  *
  * Field mappings:
  * - v3 fixed_price ↔ v2 rate (for fixed pricing)
@@ -87,58 +85,26 @@ export declare function getPrice(option: PricingOptionV2 | PricingOptionV3): num
  * Get the floor price from a pricing option (works with v2 or v3)
  */
 export declare function getFloorPrice(option: PricingOptionV2 | PricingOptionV3): number | undefined;
-/**
- * Adapt a v3-style pricing option for a v2 server.
- * Converts fixed_price → rate, floor_price → price_guidance.floor
- */
-export declare function adaptPricingOptionForV2(option: PricingOptionV3): PricingOptionV2;
 /**
  * Normalize a v2-style pricing option to v3.
  * Converts rate → fixed_price, price_guidance.floor → floor_price
  */
 export declare function normalizePricingOption(option: PricingOptionV2 | PricingOptionV3): PricingOptionV3;
-/**
- * Adapt all pricing options in a product for v2 server
- */
-export declare function adaptProductPricingForV2(product: any): any;
 /**
  * Normalize all pricing options in a product to v3
  */
 export declare function normalizeProductPricing(product: any): any;
-/**
- * Adapt a get_products request for a v2 server.
- *
- * Converts v3 fields to their v2 equivalents:
- * - brand (BrandReference) → brand_manifest (base domain URL string)
- * - catalog → promoted_offerings (type='offering') or promoted_offerings.product_selectors (type='product')
- * - channels in filters → v2 channel names
- *
- * Strips v3-only fields v2 agents don't understand:
- * - buying_mode, buyer_campaign_ref, property_list, account_id, pagination (top-level)
- * - filters: required_features, required_axe_integrations, required_geo_targeting,
- *            signal_targeting, regions, metros
- */
-export declare function adaptGetProductsRequestForV2(request: any): any;
 /**
  * Normalize v2 channel names on a product to v3.
  * v2 used coarser buckets; some map one-to-many (e.g. 'video' → ['olv', 'ctv']).
  */
 export declare function normalizeProductChannels(product: any): any;
-/** Normalize optional forecast timestamps at the v2.5 compatibility boundary. */
+/** Normalize optional forecast timestamps in established product responses. */
 export declare function normalizeLegacyProductForecast(product: any): any;
 /**
  * Normalize all products in a get_products response to v3
  */
 export declare function normalizeGetProductsResponse(response: any): any;
-/**
- * Adapt a package request's pricing option selection for v2 server.
- * This handles bid_price which references pricing option floor semantics.
- */
-export declare function adaptPackagePricingForV2(pkg: any): any;
-/**
- * Adapt a create_media_buy request for v2 server (pricing fields)
- */
-export declare function adaptMediaBuyPricingForV2(request: any): any;
 /**
  * Normalize a media buy response's package pricing to v3
  */

package/dist/lib/utils/pricing-adapter.d.ts

@@ -1,9 +1,7 @@
 /**
  * Pricing Option Adapter
  *
- * Handles conversion between v2.x and v3 pricing option field names.
- * The library exposes only v3 API (fixed_price, floor_price) to clients,
- * and internally adapts requests for v2.x servers.
+ * Normalizes historical pricing fields for established AdCP 3 catalogs.
  *
  * Field mappings:
  * - v3 fixed_price ↔ v2 rate (for fixed pricing)
@@ -87,58 +85,26 @@ export declare function getPrice(option: PricingOptionV2 | PricingOptionV3): num
  * Get the floor price from a pricing option (works with v2 or v3)
  */
 export declare function getFloorPrice(option: PricingOptionV2 | PricingOptionV3): number | undefined;
-/**
- * Adapt a v3-style pricing option for a v2 server.
- * Converts fixed_price → rate, floor_price → price_guidance.floor
- */
-export declare function adaptPricingOptionForV2(option: PricingOptionV3): PricingOptionV2;
 /**
  * Normalize a v2-style pricing option to v3.
  * Converts rate → fixed_price, price_guidance.floor → floor_price
  */
 export declare function normalizePricingOption(option: PricingOptionV2 | PricingOptionV3): PricingOptionV3;
-/**
- * Adapt all pricing options in a product for v2 server
- */
-export declare function adaptProductPricingForV2(product: any): any;
 /**
  * Normalize all pricing options in a product to v3
  */
 export declare function normalizeProductPricing(product: any): any;
-/**
- * Adapt a get_products request for a v2 server.
- *
- * Converts v3 fields to their v2 equivalents:
- * - brand (BrandReference) → brand_manifest (base domain URL string)
- * - catalog → promoted_offerings (type='offering') or promoted_offerings.product_selectors (type='product')
- * - channels in filters → v2 channel names
- *
- * Strips v3-only fields v2 agents don't understand:
- * - buying_mode, buyer_campaign_ref, property_list, account_id, pagination (top-level)
- * - filters: required_features, required_axe_integrations, required_geo_targeting,
- *            signal_targeting, regions, metros
- */
-export declare function adaptGetProductsRequestForV2(request: any): any;
 /**
  * Normalize v2 channel names on a product to v3.
  * v2 used coarser buckets; some map one-to-many (e.g. 'video' → ['olv', 'ctv']).
  */
 export declare function normalizeProductChannels(product: any): any;
-/** Normalize optional forecast timestamps at the v2.5 compatibility boundary. */
+/** Normalize optional forecast timestamps in established product responses. */
 export declare function normalizeLegacyProductForecast(product: any): any;
 /**
  * Normalize all products in a get_products response to v3
  */
 export declare function normalizeGetProductsResponse(response: any): any;
-/**
- * Adapt a package request's pricing option selection for v2 server.
- * This handles bid_price which references pricing option floor semantics.
- */
-export declare function adaptPackagePricingForV2(pkg: any): any;
-/**
- * Adapt a create_media_buy request for v2 server (pricing fields)
- */
-export declare function adaptMediaBuyPricingForV2(request: any): any;
 /**
  * Normalize a media buy response's package pricing to v3
  */

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

@@ -18,11 +18,6 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var pricing_adapter_exports = {};
 __export(pricing_adapter_exports, {
-  adaptGetProductsRequestForV2: () => adaptGetProductsRequestForV2,
-  adaptMediaBuyPricingForV2: () => adaptMediaBuyPricingForV2,
-  adaptPackagePricingForV2: () => adaptPackagePricingForV2,
-  adaptPricingOptionForV2: () => adaptPricingOptionForV2,
-  adaptProductPricingForV2: () => adaptProductPricingForV2,
   getFloorPrice: () => getFloorPrice,
   getPrice: () => getPrice,
   isCPAPricing: () => isCPAPricing,
@@ -72,28 +67,6 @@ function getFloorPrice(option) {
   }
   return option.price_guidance?.floor;
 }
-function adaptPricingOptionForV2(option) {
-  if (!usesV3PricingFields(option)) {
-    return option;
-  }
-  const { fixed_price, floor_price, price_guidance, ...rest } = option;
-  const result = { ...rest };
-  if (fixed_price !== void 0) {
-    result.rate = fixed_price;
-    result.is_fixed = true;
-  } else {
-    result.is_fixed = false;
-    if (floor_price !== void 0 || price_guidance) {
-      result.price_guidance = {
-        ...price_guidance || {}
-      };
-      if (floor_price !== void 0) {
-        result.price_guidance.floor = floor_price;
-      }
-    }
-  }
-  return result;
-}
 function normalizePricingOption(option) {
   if (usesV3PricingFields(option) && !usesV2PricingFields(option)) {
     return option;
@@ -115,15 +88,6 @@ function normalizePricingOption(option) {
   }
   return result;
 }
-function adaptProductPricingForV2(product) {
-  if (!product?.pricing_options || !Array.isArray(product.pricing_options)) {
-    return product;
-  }
-  return {
-    ...product,
-    pricing_options: product.pricing_options.map(adaptPricingOptionForV2)
-  };
-}
 function normalizeProductPricing(product) {
   if (!product?.pricing_options || !Array.isArray(product.pricing_options)) {
     return product;
@@ -133,64 +97,6 @@ function normalizeProductPricing(product) {
     pricing_options: product.pricing_options.map(normalizePricingOption)
   };
 }
-function adaptGetProductsRequestForV2(request) {
-  const adapted = { ...request };
-  if (adapted.brand?.domain) {
-    adapted.brand_manifest = `https://${adapted.brand.domain}`;
-    delete adapted.brand;
-  }
-  if (adapted.catalog) {
-    const catalog = adapted.catalog;
-    if (catalog.type === "product") {
-      adapted.promoted_offerings = {
-        product_selectors: {
-          ...catalog.gtins?.length && { manifest_gtins: catalog.gtins },
-          ...catalog.ids?.length && { manifest_skus: catalog.ids },
-          ...catalog.tags?.length && { manifest_tags: catalog.tags },
-          ...catalog.category && { manifest_category: catalog.category },
-          ...catalog.query && { manifest_query: catalog.query }
-        }
-      };
-    } else if (catalog.type === "offering") {
-      adapted.promoted_offerings = {
-        ...catalog.items?.length && { offerings: catalog.items }
-      };
-    }
-    delete adapted.catalog;
-  }
-  if (adapted.filters?.channels) {
-    const v2ChannelMap = {
-      olv: "video",
-      ctv: "video",
-      streaming_audio: "audio",
-      retail_media: "retail"
-    };
-    const mapped = adapted.filters.channels.map((ch) => v2ChannelMap[ch] ?? ch);
-    adapted.filters = {
-      ...adapted.filters,
-      channels: [...new Set(mapped)]
-    };
-  }
-  if (adapted.filters) {
-    const {
-      required_features,
-      required_axe_integrations,
-      required_geo_targeting,
-      signal_targeting,
-      regions,
-      metros,
-      ...v2Filters
-    } = adapted.filters;
-    adapted.filters = v2Filters;
-  }
-  delete adapted.buying_mode;
-  delete adapted.buyer_campaign_ref;
-  delete adapted.property_list;
-  delete adapted.account;
-  delete adapted.pagination;
-  delete adapted.adcp_major_version;
-  return adapted;
-}
 function normalizeProductChannels(product) {
   if (!product?.channels || !Array.isArray(product.channels)) {
     return product;
@@ -288,12 +194,6 @@ function normalizeGetProductsResponse(response) {
     )
   };
 }
-function adaptPackagePricingForV2(pkg) {
-  return pkg;
-}
-function adaptMediaBuyPricingForV2(request) {
-  return request;
-}
 function normalizeMediaBuyPricingResponse(response) {
   if (response?.products && Array.isArray(response.products)) {
     return {
@@ -305,11 +205,6 @@ function normalizeMediaBuyPricingResponse(response) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  adaptGetProductsRequestForV2,
-  adaptMediaBuyPricingForV2,
-  adaptPackagePricingForV2,
-  adaptPricingOptionForV2,
-  adaptProductPricingForV2,
   getFloorPrice,
   getPrice,
   isCPAPricing,