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

package/dist/lib/utils/format-renders.d.mts

@@ -1,95 +1,35 @@
-/**
- * Format Renders Normalizer
- *
- * Handles conversion between v2 top-level dimensions and v3 renders array.
- * The library exposes only v3 API (renders array) to clients,
- * and internally normalizes responses from v2 servers.
- */
-/**
- * Dimensions for a render
- */
+/** Helpers for reading AdCP 3 format renders. */
 export interface RenderDimensions {
     width: number;
     height: number;
 }
-/**
- * v3 render specification — one entry in `Format.renders[]`.
- *
- * Renamed from `FormatRender` (see deprecated alias below) to free the
- * `FormatRender` name for the factory namespace in `format-render-builders`,
- * which is the more common autocomplete target. TypeScript keeps type and
- * value namespaces separate, but the re-export barrel in `src/lib/index.ts`
- * can't disambiguate between a type re-export and a const re-export at the
- * same name — hence the rename.
- */
+/** One entry in an AdCP 3 format's renders array. */
 export interface FormatRenderEntry {
-    /** Unique identifier for this render */
     render_id: string;
-    /** Semantic role (e.g., 'primary', 'companion', 'mobile_variant') */
     role: string;
-    /** Dimensions of this render */
     dimensions?: RenderDimensions;
-    /** Whether dimensions come from format_id parameters */
     parameters_from_format_id?: boolean;
-}
-/**
- * @deprecated Renamed to `FormatRenderEntry`. This alias keeps existing
- * imports compiling but is not re-exported from the package barrel
- * (`@adcp/sdk`) — the barrel's `FormatRender` identifier now refers to
- * the factory namespace. Migrate to `FormatRenderEntry` next release.
- */
-export type FormatRender = FormatRenderEntry;
-/**
- * v2 format with top-level dimensions
- */
-export interface FormatV2 {
-    width?: number;
-    height?: number;
-    dimensions?: RenderDimensions;
     [key: string]: unknown;
 }
-/**
- * v3 format with renders array
- */
+/** @deprecated Use FormatRenderEntry; the package's FormatRender export is a factory namespace. */
+export type FormatRender = FormatRenderEntry;
 export interface FormatV3 {
     renders?: FormatRenderEntry[];
     [key: string]: unknown;
 }
-/**
- * Normalize a format from v2 (top-level dimensions) to v3 (renders array).
- * If the format already has renders, returns as-is.
- */
-export declare function normalizeFormatRenders(format: FormatV2 | FormatV3): FormatV3;
-/**
- * Normalize all formats in a list_creative_formats response
- */
-export declare function normalizeFormatsResponse(response: any): any;
-/**
- * Get renders from a format (normalizes v2 to v3 format)
- */
-export declare function getFormatRenders(format: FormatV2 | FormatV3): FormatRenderEntry[];
-/**
- * Get primary render from a format
- */
-export declare function getPrimaryRender(format: FormatV2 | FormatV3): FormatRenderEntry | undefined;
-/**
- * Get companion renders from a format
- */
-export declare function getCompanionRenders(format: FormatV2 | FormatV3): FormatRenderEntry[];
-/**
- * Check if format has multiple renders (companion ads, adaptive)
- */
-export declare function isMultiRenderFormat(format: FormatV2 | FormatV3): boolean;
-/**
- * Check if format uses v2 top-level dimensions
- */
-export declare function usesV2Dimensions(format: any): boolean;
-/**
- * Check if format uses v3 renders array
- */
-export declare function usesV3Renders(format: any): boolean;
-/**
- * Get format dimensions (works with both v2 and v3)
- * For multi-render formats, returns primary render dimensions
- */
-export declare function getFormatDimensions(format: FormatV2 | FormatV3): RenderDimensions | undefined;
+/** Preserve a format's supplied AdCP 3 renders and extension fields. */
+export declare function normalizeFormatRenders<T extends FormatV3>(format: T): T;
+export declare function normalizeFormatsResponse(formats: FormatV3[]): {
+    formats: FormatV3[];
+};
+export declare function normalizeFormatsResponse<T extends {
+    formats?: FormatV3[];
+}>(response: T): T;
+export declare function getFormatRenders(format: FormatV3): FormatRenderEntry[];
+/** Select the primary render, or the first supplied render when no primary is declared. */
+export declare function getPrimaryRender(format: FormatV3): FormatRenderEntry | undefined;
+export declare function getCompanionRenders(format: FormatV3): FormatRenderEntry[];
+export declare function isMultiRenderFormat(format: FormatV3): boolean;
+export declare function usesV3Renders(format: FormatV3): boolean;
+/** Return the selected render's dimensions, when provided. */
+export declare function getFormatDimensions(format: FormatV3): RenderDimensions | undefined;

package/dist/lib/utils/format-renders.d.ts

@@ -1,95 +1,35 @@
-/**
- * Format Renders Normalizer
- *
- * Handles conversion between v2 top-level dimensions and v3 renders array.
- * The library exposes only v3 API (renders array) to clients,
- * and internally normalizes responses from v2 servers.
- */
-/**
- * Dimensions for a render
- */
+/** Helpers for reading AdCP 3 format renders. */
 export interface RenderDimensions {
     width: number;
     height: number;
 }
-/**
- * v3 render specification — one entry in `Format.renders[]`.
- *
- * Renamed from `FormatRender` (see deprecated alias below) to free the
- * `FormatRender` name for the factory namespace in `format-render-builders`,
- * which is the more common autocomplete target. TypeScript keeps type and
- * value namespaces separate, but the re-export barrel in `src/lib/index.ts`
- * can't disambiguate between a type re-export and a const re-export at the
- * same name — hence the rename.
- */
+/** One entry in an AdCP 3 format's renders array. */
 export interface FormatRenderEntry {
-    /** Unique identifier for this render */
     render_id: string;
-    /** Semantic role (e.g., 'primary', 'companion', 'mobile_variant') */
     role: string;
-    /** Dimensions of this render */
     dimensions?: RenderDimensions;
-    /** Whether dimensions come from format_id parameters */
     parameters_from_format_id?: boolean;
-}
-/**
- * @deprecated Renamed to `FormatRenderEntry`. This alias keeps existing
- * imports compiling but is not re-exported from the package barrel
- * (`@adcp/sdk`) — the barrel's `FormatRender` identifier now refers to
- * the factory namespace. Migrate to `FormatRenderEntry` next release.
- */
-export type FormatRender = FormatRenderEntry;
-/**
- * v2 format with top-level dimensions
- */
-export interface FormatV2 {
-    width?: number;
-    height?: number;
-    dimensions?: RenderDimensions;
     [key: string]: unknown;
 }
-/**
- * v3 format with renders array
- */
+/** @deprecated Use FormatRenderEntry; the package's FormatRender export is a factory namespace. */
+export type FormatRender = FormatRenderEntry;
 export interface FormatV3 {
     renders?: FormatRenderEntry[];
     [key: string]: unknown;
 }
-/**
- * Normalize a format from v2 (top-level dimensions) to v3 (renders array).
- * If the format already has renders, returns as-is.
- */
-export declare function normalizeFormatRenders(format: FormatV2 | FormatV3): FormatV3;
-/**
- * Normalize all formats in a list_creative_formats response
- */
-export declare function normalizeFormatsResponse(response: any): any;
-/**
- * Get renders from a format (normalizes v2 to v3 format)
- */
-export declare function getFormatRenders(format: FormatV2 | FormatV3): FormatRenderEntry[];
-/**
- * Get primary render from a format
- */
-export declare function getPrimaryRender(format: FormatV2 | FormatV3): FormatRenderEntry | undefined;
-/**
- * Get companion renders from a format
- */
-export declare function getCompanionRenders(format: FormatV2 | FormatV3): FormatRenderEntry[];
-/**
- * Check if format has multiple renders (companion ads, adaptive)
- */
-export declare function isMultiRenderFormat(format: FormatV2 | FormatV3): boolean;
-/**
- * Check if format uses v2 top-level dimensions
- */
-export declare function usesV2Dimensions(format: any): boolean;
-/**
- * Check if format uses v3 renders array
- */
-export declare function usesV3Renders(format: any): boolean;
-/**
- * Get format dimensions (works with both v2 and v3)
- * For multi-render formats, returns primary render dimensions
- */
-export declare function getFormatDimensions(format: FormatV2 | FormatV3): RenderDimensions | undefined;
+/** Preserve a format's supplied AdCP 3 renders and extension fields. */
+export declare function normalizeFormatRenders<T extends FormatV3>(format: T): T;
+export declare function normalizeFormatsResponse(formats: FormatV3[]): {
+    formats: FormatV3[];
+};
+export declare function normalizeFormatsResponse<T extends {
+    formats?: FormatV3[];
+}>(response: T): T;
+export declare function getFormatRenders(format: FormatV3): FormatRenderEntry[];
+/** Select the primary render, or the first supplied render when no primary is declared. */
+export declare function getPrimaryRender(format: FormatV3): FormatRenderEntry | undefined;
+export declare function getCompanionRenders(format: FormatV3): FormatRenderEntry[];
+export declare function isMultiRenderFormat(format: FormatV3): boolean;
+export declare function usesV3Renders(format: FormatV3): boolean;
+/** Return the selected render's dimensions, when provided. */
+export declare function getFormatDimensions(format: FormatV3): RenderDimensions | undefined;

package/dist/lib/utils/format-renders.js

@@ -25,92 +25,33 @@ __export(format_renders_exports, {
   isMultiRenderFormat: () => isMultiRenderFormat,
   normalizeFormatRenders: () => normalizeFormatRenders,
   normalizeFormatsResponse: () => normalizeFormatsResponse,
-  usesV2Dimensions: () => usesV2Dimensions,
   usesV3Renders: () => usesV3Renders
 });
 module.exports = __toCommonJS(format_renders_exports);
 function normalizeFormatRenders(format) {
-  if (format.renders && Array.isArray(format.renders)) {
-    return format;
-  }
-  const v2Format = format;
-  const hasWidth = v2Format.width !== void 0;
-  const hasHeight = v2Format.height !== void 0;
-  const hasDimensions = v2Format.dimensions !== void 0;
-  if (!hasWidth && !hasHeight && !hasDimensions) {
-    return format;
-  }
-  let dimensions;
-  if (hasDimensions) {
-    dimensions = v2Format.dimensions;
-  } else if (hasWidth || hasHeight) {
-    dimensions = {
-      width: v2Format.width ?? 0,
-      height: v2Format.height ?? 0
-    };
-  }
-  const { width, height, dimensions: _, ...rest } = v2Format;
-  return {
-    ...rest,
-    renders: [
-      {
-        render_id: "primary",
-        role: "primary",
-        dimensions
-      }
-    ]
-  };
+  return format;
 }
 function normalizeFormatsResponse(response) {
-  if (Array.isArray(response)) {
-    return { formats: response.map(normalizeFormatRenders) };
-  }
-  if (!response.formats || !Array.isArray(response.formats)) {
-    return response;
-  }
-  return {
-    ...response,
-    formats: response.formats.map(normalizeFormatRenders)
-  };
+  return Array.isArray(response) ? { formats: response } : response;
 }
 function getFormatRenders(format) {
-  const normalized = normalizeFormatRenders(format);
-  return normalized.renders ?? [];
+  return format.renders ?? [];
 }
 function getPrimaryRender(format) {
   const renders = getFormatRenders(format);
-  return renders.find((r) => r.role === "primary") ?? renders[0];
+  return renders.find((render) => render.role === "primary") ?? renders[0];
 }
 function getCompanionRenders(format) {
-  const renders = getFormatRenders(format);
-  return renders.filter((r) => r.role === "companion");
+  return getFormatRenders(format).filter((render) => render.role === "companion");
 }
 function isMultiRenderFormat(format) {
-  const renders = getFormatRenders(format);
-  return renders.length > 1;
-}
-function usesV2Dimensions(format) {
-  return (format.width !== void 0 || format.height !== void 0 || format.dimensions !== void 0) && !format.renders;
+  return getFormatRenders(format).length > 1;
 }
 function usesV3Renders(format) {
   return Array.isArray(format.renders);
 }
 function getFormatDimensions(format) {
-  if (format.renders) {
-    const primary = getPrimaryRender(format);
-    return primary?.dimensions;
-  }
-  const v2Format = format;
-  if (v2Format.dimensions) {
-    return v2Format.dimensions;
-  }
-  if (v2Format.width !== void 0 || v2Format.height !== void 0) {
-    return {
-      width: v2Format.width ?? 0,
-      height: v2Format.height ?? 0
-    };
-  }
-  return void 0;
+  return getPrimaryRender(format)?.dimensions;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -121,6 +62,5 @@ function getFormatDimensions(format) {
   isMultiRenderFormat,
   normalizeFormatRenders,
   normalizeFormatsResponse,
-  usesV2Dimensions,
   usesV3Renders
 });

package/dist/lib/utils/format-renders.mjs

@@ -1,85 +1,27 @@
 function normalizeFormatRenders(format) {
-  if (format.renders && Array.isArray(format.renders)) {
-    return format;
-  }
-  const v2Format = format;
-  const hasWidth = v2Format.width !== void 0;
-  const hasHeight = v2Format.height !== void 0;
-  const hasDimensions = v2Format.dimensions !== void 0;
-  if (!hasWidth && !hasHeight && !hasDimensions) {
-    return format;
-  }
-  let dimensions;
-  if (hasDimensions) {
-    dimensions = v2Format.dimensions;
-  } else if (hasWidth || hasHeight) {
-    dimensions = {
-      width: v2Format.width ?? 0,
-      height: v2Format.height ?? 0
-    };
-  }
-  const { width, height, dimensions: _, ...rest } = v2Format;
-  return {
-    ...rest,
-    renders: [
-      {
-        render_id: "primary",
-        role: "primary",
-        dimensions
-      }
-    ]
-  };
+  return format;
 }
 function normalizeFormatsResponse(response) {
-  if (Array.isArray(response)) {
-    return { formats: response.map(normalizeFormatRenders) };
-  }
-  if (!response.formats || !Array.isArray(response.formats)) {
-    return response;
-  }
-  return {
-    ...response,
-    formats: response.formats.map(normalizeFormatRenders)
-  };
+  return Array.isArray(response) ? { formats: response } : response;
 }
 function getFormatRenders(format) {
-  const normalized = normalizeFormatRenders(format);
-  return normalized.renders ?? [];
+  return format.renders ?? [];
 }
 function getPrimaryRender(format) {
   const renders = getFormatRenders(format);
-  return renders.find((r) => r.role === "primary") ?? renders[0];
+  return renders.find((render) => render.role === "primary") ?? renders[0];
 }
 function getCompanionRenders(format) {
-  const renders = getFormatRenders(format);
-  return renders.filter((r) => r.role === "companion");
+  return getFormatRenders(format).filter((render) => render.role === "companion");
 }
 function isMultiRenderFormat(format) {
-  const renders = getFormatRenders(format);
-  return renders.length > 1;
-}
-function usesV2Dimensions(format) {
-  return (format.width !== void 0 || format.height !== void 0 || format.dimensions !== void 0) && !format.renders;
+  return getFormatRenders(format).length > 1;
 }
 function usesV3Renders(format) {
   return Array.isArray(format.renders);
 }
 function getFormatDimensions(format) {
-  if (format.renders) {
-    const primary = getPrimaryRender(format);
-    return primary?.dimensions;
-  }
-  const v2Format = format;
-  if (v2Format.dimensions) {
-    return v2Format.dimensions;
-  }
-  if (v2Format.width !== void 0 || v2Format.height !== void 0) {
-    return {
-      width: v2Format.width ?? 0,
-      height: v2Format.height ?? 0
-    };
-  }
-  return void 0;
+  return getPrimaryRender(format)?.dimensions;
 }
 export {
   getCompanionRenders,
@@ -89,6 +31,5 @@ export {
   isMultiRenderFormat,
   normalizeFormatRenders,
   normalizeFormatsResponse,
-  usesV2Dimensions,
   usesV3Renders
 };

package/dist/lib/utils/index.d.mts

@@ -37,8 +37,7 @@ export type { ExtractedAdcpError } from './error-extraction.mjs';
 export { detectProtocol, detectProtocolWithTimeout } from './protocol-detection.mjs';
 export { A2A_CARD_PATHS, TRANSPORT_SUFFIX_REGEX, isAgentCardPath, isWellKnownAgentCardUrl, buildCardUrls, stripAgentCardPath, stripTransportSuffix, } from './a2a-discovery.mjs';
 export { getFormatAssets, getRequiredAssets, getOptionalAssets, getIndividualAssets, getRepeatableGroups, usesDeprecatedAssetsField, getAssetCount, hasAssets, type CanonicalFormatAssetSlot, type FormatAssetsInput, type IndividualFormatAssetSlot, type RepeatableFormatAssetGroup, } from './format-assets.mjs';
-export { adaptGetProductsRequestForV2, normalizeProductChannels, adaptPricingOptionForV2, normalizePricingOption, normalizeProductPricing, normalizeGetProductsResponse, usesV2PricingFields, usesV3PricingFields, isFixedPricing, isCPAPricing, getPrice, getFloorPrice, type PricingOptionV2, type PricingOptionV3, type PriceGuidanceV2, type PriceGuidanceV3, } from './pricing-adapter.mjs';
-export { adaptSyncCreativesRequestForV2 } from './sync-creatives-adapter.mjs';
+export { normalizeProductChannels, normalizePricingOption, normalizeProductPricing, normalizeGetProductsResponse, usesV2PricingFields, usesV3PricingFields, isFixedPricing, isCPAPricing, getPrice, getFloorPrice, type PricingOptionV2, type PricingOptionV3, type PriceGuidanceV2, type PriceGuidanceV3, } from './pricing-adapter.mjs';
 export { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from './creative-delivery.mjs';
 export type { InlineCreativeAssignment, InlineCreativePackage, InlineCreativePackagePatch, InlineCreativesForPackagesOptions, InlineCreativesForPackagesLegacyOptions, LegacyInlineCreativePackage, } from './creative-delivery.mjs';
 export { paginate, paginatePages, type PaginateOptions } from './pagination.mjs';

package/dist/lib/utils/index.d.ts

@@ -37,8 +37,7 @@ export type { ExtractedAdcpError } from './error-extraction';
 export { detectProtocol, detectProtocolWithTimeout } from './protocol-detection';
 export { A2A_CARD_PATHS, TRANSPORT_SUFFIX_REGEX, isAgentCardPath, isWellKnownAgentCardUrl, buildCardUrls, stripAgentCardPath, stripTransportSuffix, } from './a2a-discovery';
 export { getFormatAssets, getRequiredAssets, getOptionalAssets, getIndividualAssets, getRepeatableGroups, usesDeprecatedAssetsField, getAssetCount, hasAssets, type CanonicalFormatAssetSlot, type FormatAssetsInput, type IndividualFormatAssetSlot, type RepeatableFormatAssetGroup, } from './format-assets';
-export { adaptGetProductsRequestForV2, normalizeProductChannels, adaptPricingOptionForV2, normalizePricingOption, normalizeProductPricing, normalizeGetProductsResponse, usesV2PricingFields, usesV3PricingFields, isFixedPricing, isCPAPricing, getPrice, getFloorPrice, type PricingOptionV2, type PricingOptionV3, type PriceGuidanceV2, type PriceGuidanceV3, } from './pricing-adapter';
-export { adaptSyncCreativesRequestForV2 } from './sync-creatives-adapter';
+export { normalizeProductChannels, normalizePricingOption, normalizeProductPricing, normalizeGetProductsResponse, usesV2PricingFields, usesV3PricingFields, isFixedPricing, isCPAPricing, getPrice, getFloorPrice, type PricingOptionV2, type PricingOptionV3, type PriceGuidanceV2, type PriceGuidanceV3, } from './pricing-adapter';
 export { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from './creative-delivery';
 export type { InlineCreativeAssignment, InlineCreativePackage, InlineCreativePackagePatch, InlineCreativesForPackagesOptions, InlineCreativesForPackagesLegacyOptions, LegacyInlineCreativePackage, } from './creative-delivery';
 export { paginate, paginatePages, type PaginateOptions } from './pagination';

package/dist/lib/utils/index.js

@@ -24,9 +24,6 @@ __export(utils_exports, {
   MAX_CONCURRENT: () => MAX_CONCURRENT,
   REQUEST_TIMEOUT: () => REQUEST_TIMEOUT,
   TRANSPORT_SUFFIX_REGEX: () => import_a2a_discovery.TRANSPORT_SUFFIX_REGEX,
-  adaptGetProductsRequestForV2: () => import_pricing_adapter.adaptGetProductsRequestForV2,
-  adaptPricingOptionForV2: () => import_pricing_adapter.adaptPricingOptionForV2,
-  adaptSyncCreativesRequestForV2: () => import_sync_creatives_adapter.adaptSyncCreativesRequestForV2,
   batchPreviewFormatsLegacy: () => import_preview_utils.batchPreviewFormatsLegacy,
   batchPreviewProducts: () => import_preview_utils.batchPreviewProducts,
   buildCardUrls: () => import_a2a_discovery.buildCardUrls,
@@ -100,7 +97,6 @@ var import_protocol_detection = require('./protocol-detection.js');
 var import_a2a_discovery = require('./a2a-discovery.js');
 var import_format_assets = require('./format-assets.js');
 var import_pricing_adapter = require('./pricing-adapter.js');
-var import_sync_creatives_adapter = require('./sync-creatives-adapter.js');
 var import_creative_delivery = require('./creative-delivery.js');
 var import_pagination = require('./pagination.js');
 const REQUEST_TIMEOUT = parseInt(process.env.REQUEST_TIMEOUT || "30000");
@@ -215,9 +211,6 @@ function getStandardFormatsLegacy() {
   MAX_CONCURRENT,
   REQUEST_TIMEOUT,
   TRANSPORT_SUFFIX_REGEX,
-  adaptGetProductsRequestForV2,
-  adaptPricingOptionForV2,
-  adaptSyncCreativesRequestForV2,
   batchPreviewFormatsLegacy,
   batchPreviewProducts,
   buildCardUrls,

package/dist/lib/utils/index.mjs

@@ -158,9 +158,7 @@ import {
   hasAssets
 } from "./format-assets.mjs";
 import {
-  adaptGetProductsRequestForV2,
   normalizeProductChannels,
-  adaptPricingOptionForV2,
   normalizePricingOption,
   normalizeProductPricing,
   normalizeGetProductsResponse,
@@ -171,7 +169,6 @@ import {
   getPrice,
   getFloorPrice
 } from "./pricing-adapter.mjs";
-import { adaptSyncCreativesRequestForV2 } from "./sync-creatives-adapter.mjs";
 import { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from "./creative-delivery.mjs";
 import { paginate, paginatePages } from "./pagination.mjs";
 export {
@@ -181,9 +178,6 @@ export {
   MAX_CONCURRENT,
   REQUEST_TIMEOUT,
   TRANSPORT_SUFFIX_REGEX,
-  adaptGetProductsRequestForV2,
-  adaptPricingOptionForV2,
-  adaptSyncCreativesRequestForV2,
   batchPreviewFormatsLegacy,
   batchPreviewProducts,
   buildCardUrls,

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

@@ -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 {};