@adcp/client 3.7.1 → 3.8.0

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

@@ -0,0 +1,87 @@
+/**
+ * Creative Assignment Adapter
+ *
+ * Handles conversion between v2 creative_ids and v3 creative_assignments.
+ * The library exposes only v3 API (creative_assignments) to clients,
+ * and internally adapts requests for v2 servers.
+ */
+/**
+ * v3 creative assignment with optional weight and placement targeting
+ */
+export interface CreativeAssignment {
+    /** Unique identifier for the creative */
+    creative_id: string;
+    /** Delivery weight (0-100) for rotation */
+    weight?: number;
+    /** Optional placement IDs to restrict where this creative runs */
+    placement_ids?: string[];
+}
+/**
+ * Package request with creative assignments (v3 style)
+ */
+export interface PackageRequestV3 {
+    creative_assignments?: CreativeAssignment[];
+    creatives?: any[];
+    [key: string]: unknown;
+}
+/**
+ * Package request with creative_ids (v2 style)
+ */
+export interface PackageRequestV2 {
+    creative_ids?: string[];
+    creatives?: any[];
+    [key: string]: unknown;
+}
+/**
+ * Package response with creative assignments (v3 style)
+ */
+export interface PackageResponseV3 {
+    creative_assignments?: CreativeAssignment[];
+    [key: string]: unknown;
+}
+/**
+ * Package response with creative_ids (v2 style)
+ */
+export interface PackageResponseV2 {
+    creative_ids?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Adapt a v3-style package request for a v2 server.
+ * Converts creative_assignments to creative_ids (dropping weight and placement_ids).
+ */
+export declare function adaptPackageRequestForV2(pkg: PackageRequestV3): PackageRequestV2;
+/**
+ * Adapt a create_media_buy request for a v2 server.
+ */
+export declare function adaptCreateMediaBuyRequestForV2(request: any): any;
+/**
+ * Adapt an update_media_buy request for a v2 server.
+ */
+export declare function adaptUpdateMediaBuyRequestForV2(request: any): any;
+/**
+ * Normalize a v2-style package response to v3.
+ * Converts creative_ids to creative_assignments.
+ */
+export declare function normalizePackageResponse(pkg: PackageResponseV2 | PackageResponseV3): PackageResponseV3;
+/**
+ * Normalize a media buy response (converts all packages).
+ */
+export declare function normalizeMediaBuyResponse(response: any): any;
+/**
+ * Check if a package uses v2 creative_ids format
+ */
+export declare function usesV2CreativeIds(pkg: any): boolean;
+/**
+ * Check if a package uses v3 creative_assignments format
+ */
+export declare function usesV3CreativeAssignments(pkg: any): boolean;
+/**
+ * Get all creative IDs from a package (works with both v2 and v3 format)
+ */
+export declare function getCreativeIds(pkg: PackageResponseV2 | PackageResponseV3): string[];
+/**
+ * Get creative assignments from a package (normalizes v2 to v3 format)
+ */
+export declare function getCreativeAssignments(pkg: PackageResponseV2 | PackageResponseV3): CreativeAssignment[];
+//# sourceMappingURL=creative-adapter.d.ts.map

package/dist/lib/utils/creative-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-adapter.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/creative-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,gBAAgB,GAAG,gBAAgB,CAWhF;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,CASjE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,CASjE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,CAiBtG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,CAS5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,MAAM,EAAE,CAQnF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,kBAAkB,EAAE,CAQvG"}

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

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * Creative Assignment Adapter
+ *
+ * Handles conversion between v2 creative_ids and v3 creative_assignments.
+ * The library exposes only v3 API (creative_assignments) to clients,
+ * and internally adapts requests for v2 servers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.adaptPackageRequestForV2 = adaptPackageRequestForV2;
+exports.adaptCreateMediaBuyRequestForV2 = adaptCreateMediaBuyRequestForV2;
+exports.adaptUpdateMediaBuyRequestForV2 = adaptUpdateMediaBuyRequestForV2;
+exports.normalizePackageResponse = normalizePackageResponse;
+exports.normalizeMediaBuyResponse = normalizeMediaBuyResponse;
+exports.usesV2CreativeIds = usesV2CreativeIds;
+exports.usesV3CreativeAssignments = usesV3CreativeAssignments;
+exports.getCreativeIds = getCreativeIds;
+exports.getCreativeAssignments = getCreativeAssignments;
+/**
+ * Adapt a v3-style package request for a v2 server.
+ * Converts creative_assignments to creative_ids (dropping weight and placement_ids).
+ */
+function adaptPackageRequestForV2(pkg) {
+    if (!pkg.creative_assignments) {
+        return pkg;
+    }
+    const { creative_assignments, ...rest } = pkg;
+    return {
+        ...rest,
+        creative_ids: creative_assignments.map(a => a.creative_id),
+    };
+}
+/**
+ * Adapt a create_media_buy request for a v2 server.
+ */
+function adaptCreateMediaBuyRequestForV2(request) {
+    if (!request.packages) {
+        return request;
+    }
+    return {
+        ...request,
+        packages: request.packages.map(adaptPackageRequestForV2),
+    };
+}
+/**
+ * Adapt an update_media_buy request for a v2 server.
+ */
+function adaptUpdateMediaBuyRequestForV2(request) {
+    if (!request.packages) {
+        return request;
+    }
+    return {
+        ...request,
+        packages: request.packages.map(adaptPackageRequestForV2),
+    };
+}
+/**
+ * Normalize a v2-style package response to v3.
+ * Converts creative_ids to creative_assignments.
+ */
+function normalizePackageResponse(pkg) {
+    // Already v3 format
+    if (pkg.creative_assignments) {
+        return pkg;
+    }
+    // v2 format - convert creative_ids to creative_assignments
+    if (pkg.creative_ids) {
+        const { creative_ids, ...rest } = pkg;
+        return {
+            ...rest,
+            creative_assignments: creative_ids.map(id => ({ creative_id: id })),
+        };
+    }
+    // No creatives
+    return pkg;
+}
+/**
+ * Normalize a media buy response (converts all packages).
+ */
+function normalizeMediaBuyResponse(response) {
+    if (!response.packages) {
+        return response;
+    }
+    return {
+        ...response,
+        packages: response.packages.map(normalizePackageResponse),
+    };
+}
+/**
+ * Check if a package uses v2 creative_ids format
+ */
+function usesV2CreativeIds(pkg) {
+    return Array.isArray(pkg.creative_ids) && !pkg.creative_assignments;
+}
+/**
+ * Check if a package uses v3 creative_assignments format
+ */
+function usesV3CreativeAssignments(pkg) {
+    return Array.isArray(pkg.creative_assignments);
+}
+/**
+ * Get all creative IDs from a package (works with both v2 and v3 format)
+ */
+function getCreativeIds(pkg) {
+    if (pkg.creative_assignments) {
+        return pkg.creative_assignments.map(a => a.creative_id);
+    }
+    if (pkg.creative_ids) {
+        return pkg.creative_ids;
+    }
+    return [];
+}
+/**
+ * Get creative assignments from a package (normalizes v2 to v3 format)
+ */
+function getCreativeAssignments(pkg) {
+    if (pkg.creative_assignments) {
+        return pkg.creative_assignments;
+    }
+    if (pkg.creative_ids) {
+        return pkg.creative_ids.map(id => ({ creative_id: id }));
+    }
+    return [];
+}
+//# sourceMappingURL=creative-adapter.js.map

package/dist/lib/utils/creative-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-adapter.js","sourceRoot":"","sources":["../../../src/lib/utils/creative-adapter.ts"],"names":[],"mappings":"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"}

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

@@ -7,15 +7,13 @@ type RepeatableAssetGroup = Extract<FormatAsset, {
     item_type: 'repeatable_group';
 }>;
 /**
- * Get assets from a Format, preferring new `assets` field, falling back to `assets_required`
+ * Get assets from a Format
  *
- * This provides backward compatibility during the migration from `assets_required` to `assets`.
- * - If `assets` exists and has items, returns it directly
- * - If only `assets_required` exists, normalizes it to the new format (sets required: true)
- * - Returns empty array if neither field exists (flexible format)
+ * Returns the assets from the v3 `assets` field. For backward compatibility with v2 servers,
+ * this function also handles the deprecated `assets_required` field if present.
  *
  * @param format - The Format object from list_creative_formats response
- * @returns Array of assets in the new format structure
+ * @returns Array of assets
  *
  * @example
  * ```typescript
@@ -27,16 +25,6 @@ type RepeatableAssetGroup = Extract<FormatAsset, {
  * ```
  */
 export declare function getFormatAssets(format: Format): FormatAsset[];
-/**
- * Convert deprecated assets_required to new assets format
- *
- * All assets in assets_required are required by definition (that's why they were in that array).
- * The new `assets` field has an explicit `required: boolean` to allow both required AND optional assets.
- *
- * @param assetsRequired - The deprecated assets_required array
- * @returns Normalized assets array with explicit required: true
- */
-export declare function normalizeAssetsRequired(assetsRequired: NonNullable<Format['assets_required']>): FormatAsset[];
 /**
  * Get only required assets from a Format
  *

package/dist/lib/utils/format-assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-assets.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/format-assets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAGvD,KAAK,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,KAAK,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC;AACzE,KAAK,oBAAoB,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,SAAS,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAY7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,GAAG,WAAW,EAAE,CAK7G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAE/D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAI1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjD"}
+{"version":3,"file":"format-assets.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/format-assets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAGvD,KAAK,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,KAAK,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC;AACzE,KAAK,oBAAoB,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,SAAS,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAAC;AAQpF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAiB7D;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAE/D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAI1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjD"}

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

@@ -1,9 +1,8 @@
 "use strict";
 // Format Asset Utilities
-// Provides backward-compatible access to format assets (v2.6 `assets` field replaces deprecated `assets_required`)
+// Provides access to format assets from the v3 `assets` field
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getFormatAssets = getFormatAssets;
-exports.normalizeAssetsRequired = normalizeAssetsRequired;
 exports.getRequiredAssets = getRequiredAssets;
 exports.getOptionalAssets = getOptionalAssets;
 exports.getIndividualAssets = getIndividualAssets;
@@ -12,15 +11,13 @@ exports.usesDeprecatedAssetsField = usesDeprecatedAssetsField;
 exports.getAssetCount = getAssetCount;
 exports.hasAssets = hasAssets;
 /**
- * Get assets from a Format, preferring new `assets` field, falling back to `assets_required`
+ * Get assets from a Format
  *
- * This provides backward compatibility during the migration from `assets_required` to `assets`.
- * - If `assets` exists and has items, returns it directly
- * - If only `assets_required` exists, normalizes it to the new format (sets required: true)
- * - Returns empty array if neither field exists (flexible format)
+ * Returns the assets from the v3 `assets` field. For backward compatibility with v2 servers,
+ * this function also handles the deprecated `assets_required` field if present.
  *
  * @param format - The Format object from list_creative_formats response
- * @returns Array of assets in the new format structure
+ * @returns Array of assets
  *
  * @example
  * ```typescript
@@ -32,24 +29,28 @@ exports.hasAssets = hasAssets;
  * ```
  */
 function getFormatAssets(format) {
-    // Prefer new `assets` field (v2.6+)
+    // Use v3 `assets` field
     if (format.assets && format.assets.length > 0) {
         return format.assets;
     }
-    // Fall back to deprecated `assets_required` and normalize
-    if (format.assets_required && format.assets_required.length > 0) {
-        return normalizeAssetsRequired(format.assets_required);
+    // Runtime backward compatibility: handle v2 responses with deprecated assets_required
+    const legacyFormat = format;
+    if (legacyFormat.assets_required &&
+        Array.isArray(legacyFormat.assets_required) &&
+        legacyFormat.assets_required.length > 0) {
+        return normalizeAssetsRequired(legacyFormat.assets_required);
     }
     return [];
 }
 /**
- * Convert deprecated assets_required to new assets format
+ * Convert deprecated assets_required to new assets format (internal use)
  *
  * All assets in assets_required are required by definition (that's why they were in that array).
  * The new `assets` field has an explicit `required: boolean` to allow both required AND optional assets.
  *
  * @param assetsRequired - The deprecated assets_required array
  * @returns Normalized assets array with explicit required: true
+ * @internal
  */
 function normalizeAssetsRequired(assetsRequired) {
     return assetsRequired.map(asset => ({
@@ -122,7 +123,8 @@ function getRepeatableGroups(format) {
  * ```
  */
 function usesDeprecatedAssetsField(format) {
-    return !format.assets && !!format.assets_required;
+    const legacyFormat = format;
+    return !format.assets && !!(legacyFormat.assets_required && Array.isArray(legacyFormat.assets_required));
 }
 /**
  * Get the count of assets in a format (for display purposes)

package/dist/lib/utils/format-assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"format-assets.js","sourceRoot":"","sources":["../../../src/lib/utils/format-assets.ts"],"names":[],"mappings":";AAAA,yBAAyB;AACzB,mHAAmH;;AA6BnH,0CAYC;AAWD,0DAKC;AAcD,8CAEC;AAiBD,8CAEC;AAQD,kDAEC;AAQD,kDAIC;AAeD,8DAEC;AAQD,sCAEC;AAQD,8BAEC;AA9ID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,eAAe,CAAC,MAAc;IAC5C,oCAAoC;IACpC,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,0DAA0D;IAC1D,IAAI,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,OAAO,uBAAuB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,uBAAuB,CAAC,cAAsD;IAC5F,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClC,GAAG,KAAK;QACR,QAAQ,EAAE,IAAI,EAAE,iDAAiD;KAClE,CAAC,CAAkB,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,iBAAiB,CAAC,MAAc;IAC9C,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,iBAAiB,CAAC,MAAc;IAC9C,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,MAAc;IAChD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAA4B,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC;AAC/G,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,MAAc;IAChD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CACnC,CAAC,KAAK,EAAiC,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,kBAAkB,CACjF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,yBAAyB,CAAC,MAAc;IACtD,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,MAAc;IAC1C,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,MAAc;IACtC,OAAO,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"format-assets.js","sourceRoot":"","sources":["../../../src/lib/utils/format-assets.ts"],"names":[],"mappings":";AAAA,yBAAyB;AACzB,8DAA8D;;AAiC9D,0CAiBC;AA+BD,8CAEC;AAiBD,8CAEC;AAQD,kDAEC;AAQD,kDAIC;AAeD,8DAGC;AAQD,sCAEC;AAQD,8BAEC;AAnJD;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,eAAe,CAAC,MAAc;IAC5C,wBAAwB;IACxB,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,sFAAsF;IACtF,MAAM,YAAY,GAAG,MAAsB,CAAC;IAC5C,IACE,YAAY,CAAC,eAAe;QAC5B,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC;QAC3C,YAAY,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EACvC,CAAC;QACD,OAAO,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,uBAAuB,CAAC,cAAyB;IACxD,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClC,GAAI,KAAiC;QACrC,QAAQ,EAAE,IAAI,EAAE,iDAAiD;KAClE,CAAC,CAAkB,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,iBAAiB,CAAC,MAAc;IAC9C,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,iBAAiB,CAAC,MAAc;IAC9C,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,MAAc;IAChD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAA4B,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC;AAC/G,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,MAAc;IAChD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CACnC,CAAC,KAAK,EAAiC,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,kBAAkB,CACjF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,yBAAyB,CAAC,MAAc;IACtD,MAAM,YAAY,GAAG,MAAsB,CAAC;IAC5C,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,eAAe,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,MAAc;IAC1C,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,MAAc;IACtC,OAAO,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * 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
+ */
+export interface RenderDimensions {
+    width: number;
+    height: number;
+}
+/**
+ * v3 render specification
+ */
+export interface FormatRender {
+    /** 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;
+}
+/**
+ * v2 format with top-level dimensions
+ */
+export interface FormatV2 {
+    width?: number;
+    height?: number;
+    dimensions?: RenderDimensions;
+    [key: string]: unknown;
+}
+/**
+ * v3 format with renders array
+ */
+export interface FormatV3 {
+    renders?: FormatRender[];
+    [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): FormatRender[];
+/**
+ * Get primary render from a format
+ */
+export declare function getPrimaryRender(format: FormatV2 | FormatV3): FormatRender | undefined;
+/**
+ * Get companion renders from a format
+ */
+export declare function getCompanionRenders(format: FormatV2 | FormatV3): FormatRender[];
+/**
+ * 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;
+//# sourceMappingURL=format-renders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format-renders.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/format-renders.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,wDAAwD;IACxD,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CA4C5E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,CAS3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,EAAE,CAG5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAGtF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,EAAE,CAG/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAGxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAIrD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAoB7F"}

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

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeFormatRenders = normalizeFormatRenders;
+exports.normalizeFormatsResponse = normalizeFormatsResponse;
+exports.getFormatRenders = getFormatRenders;
+exports.getPrimaryRender = getPrimaryRender;
+exports.getCompanionRenders = getCompanionRenders;
+exports.isMultiRenderFormat = isMultiRenderFormat;
+exports.usesV2Dimensions = usesV2Dimensions;
+exports.usesV3Renders = usesV3Renders;
+exports.getFormatDimensions = getFormatDimensions;
+/**
+ * Normalize a format from v2 (top-level dimensions) to v3 (renders array).
+ * If the format already has renders, returns as-is.
+ */
+function normalizeFormatRenders(format) {
+    // Already has renders array - return as-is
+    if (format.renders && Array.isArray(format.renders)) {
+        return format;
+    }
+    const v2Format = format;
+    // Check for v2 dimensions
+    const hasWidth = v2Format.width !== undefined;
+    const hasHeight = v2Format.height !== undefined;
+    const hasDimensions = v2Format.dimensions !== undefined;
+    if (!hasWidth && !hasHeight && !hasDimensions) {
+        // No dimension info - could be a template format
+        // Return without renders (caller can check accepts_parameters)
+        return format;
+    }
+    // Build dimensions object
+    let dimensions;
+    if (hasDimensions) {
+        dimensions = v2Format.dimensions;
+    }
+    else if (hasWidth || hasHeight) {
+        dimensions = {
+            width: v2Format.width ?? 0,
+            height: v2Format.height ?? 0,
+        };
+    }
+    // Remove v2 fields and add v3 renders
+    const { width, height, dimensions: _, ...rest } = v2Format;
+    return {
+        ...rest,
+        renders: [
+            {
+                render_id: 'primary',
+                role: 'primary',
+                dimensions,
+            },
+        ],
+    };
+}
+/**
+ * Normalize all formats in a list_creative_formats response
+ */
+function normalizeFormatsResponse(response) {
+    if (!response.formats || !Array.isArray(response.formats)) {
+        return response;
+    }
+    return {
+        ...response,
+        formats: response.formats.map(normalizeFormatRenders),
+    };
+}
+/**
+ * Get renders from a format (normalizes v2 to v3 format)
+ */
+function getFormatRenders(format) {
+    const normalized = normalizeFormatRenders(format);
+    return normalized.renders ?? [];
+}
+/**
+ * Get primary render from a format
+ */
+function getPrimaryRender(format) {
+    const renders = getFormatRenders(format);
+    return renders.find(r => r.role === 'primary') ?? renders[0];
+}
+/**
+ * Get companion renders from a format
+ */
+function getCompanionRenders(format) {
+    const renders = getFormatRenders(format);
+    return renders.filter(r => r.role === 'companion');
+}
+/**
+ * Check if format has multiple renders (companion ads, adaptive)
+ */
+function isMultiRenderFormat(format) {
+    const renders = getFormatRenders(format);
+    return renders.length > 1;
+}
+/**
+ * Check if format uses v2 top-level dimensions
+ */
+function usesV2Dimensions(format) {
+    return ((format.width !== undefined || format.height !== undefined || format.dimensions !== undefined) && !format.renders);
+}
+/**
+ * Check if format uses v3 renders array
+ */
+function usesV3Renders(format) {
+    return Array.isArray(format.renders);
+}
+/**
+ * Get format dimensions (works with both v2 and v3)
+ * For multi-render formats, returns primary render dimensions
+ */
+function getFormatDimensions(format) {
+    // v3 format - get from primary render
+    if (format.renders) {
+        const primary = getPrimaryRender(format);
+        return primary?.dimensions;
+    }
+    // v2 format - get from top-level
+    const v2Format = format;
+    if (v2Format.dimensions) {
+        return v2Format.dimensions;
+    }
+    if (v2Format.width !== undefined || v2Format.height !== undefined) {
+        return {
+            width: v2Format.width ?? 0,
+            height: v2Format.height ?? 0,
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=format-renders.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format-renders.js","sourceRoot":"","sources":["../../../src/lib/utils/format-renders.ts"],"names":[],"mappings":"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"}

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

@@ -27,5 +27,6 @@ export declare function getStandardFormats(): CreativeFormat[];
 export { unwrapProtocolResponse, isAdcpError, isAdcpSuccess } from './response-unwrapper';
 export type { AdCPResponse } from './response-unwrapper';
 export { detectProtocol, detectProtocolWithTimeout } from './protocol-detection';
-export { getFormatAssets, normalizeAssetsRequired, getRequiredAssets, getOptionalAssets, getIndividualAssets, getRepeatableGroups, usesDeprecatedAssetsField, getAssetCount, hasAssets, } from './format-assets';
+export { getFormatAssets, getRequiredAssets, getOptionalAssets, getIndividualAssets, getRepeatableGroups, usesDeprecatedAssetsField, getAssetCount, hasAssets, } from './format-assets';
+export { adaptPricingOptionForV2, normalizePricingOption, normalizeProductPricing, normalizeGetProductsResponse, usesV2PricingFields, usesV3PricingFields, isFixedPricing, getPrice, getFloorPrice, type PricingOptionV2, type PricingOptionV3, type PriceGuidanceV2, type PriceGuidanceV3, } from './pricing-adapter';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAIlF,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,eAAO,MAAM,eAAe,QAAmD,CAAC;AAChF,eAAO,MAAM,cAAc,QAA8C,CAAC;AAG1E,eAAO,MAAM,gBAAgB,EAAE,cAAc,EA8C5C,CAAC;AAEF;;GAEG;AACH,qBAAa,cAAc;IAOb,OAAO,CAAC,OAAO;IAN3B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAK;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAElB,OAAO,EAAE,MAAM;IAE7B,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoB/C,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,SAAS;CASlB;AAKD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAKjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAErD;AAGD,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGjF,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,aAAa,EACb,SAAS,GACV,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAIlF,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,eAAO,MAAM,eAAe,QAAmD,CAAC;AAChF,eAAO,MAAM,cAAc,QAA8C,CAAC;AAG1E,eAAO,MAAM,gBAAgB,EAAE,cAAc,EA8C5C,CAAC;AAEF;;GAEG;AACH,qBAAa,cAAc;IAOb,OAAO,CAAC,OAAO;IAN3B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAK;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAElB,OAAO,EAAE,MAAM;IAE7B,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoB/C,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,SAAS;CASlB;AAKD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAKjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAErD;AAGD,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGjF,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,aAAa,EACb,SAAS,GACV,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,QAAQ,EACR,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/lib/utils/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasAssets = exports.getAssetCount = exports.usesDeprecatedAssetsField = exports.getRepeatableGroups = exports.getIndividualAssets = exports.getOptionalAssets = exports.getRequiredAssets = exports.normalizeAssetsRequired = exports.getFormatAssets = exports.detectProtocolWithTimeout = exports.detectProtocol = exports.isAdcpSuccess = exports.isAdcpError = exports.unwrapProtocolResponse = exports.CircuitBreaker = exports.STANDARD_FORMATS = exports.MAX_CONCURRENT = exports.REQUEST_TIMEOUT = exports.clearPreviewCache = exports.batchPreviewFormats = exports.batchPreviewProducts = exports.createLogger = exports.logger = void 0;
+exports.getFloorPrice = exports.getPrice = exports.isFixedPricing = exports.usesV3PricingFields = exports.usesV2PricingFields = exports.normalizeGetProductsResponse = exports.normalizeProductPricing = exports.normalizePricingOption = exports.adaptPricingOptionForV2 = exports.hasAssets = exports.getAssetCount = exports.usesDeprecatedAssetsField = exports.getRepeatableGroups = exports.getIndividualAssets = exports.getOptionalAssets = exports.getRequiredAssets = exports.getFormatAssets = exports.detectProtocolWithTimeout = exports.detectProtocol = exports.isAdcpSuccess = exports.isAdcpError = exports.unwrapProtocolResponse = exports.CircuitBreaker = exports.STANDARD_FORMATS = exports.MAX_CONCURRENT = exports.REQUEST_TIMEOUT = exports.clearPreviewCache = exports.batchPreviewFormats = exports.batchPreviewProducts = exports.createLogger = exports.logger = void 0;
 exports.getCircuitBreaker = getCircuitBreaker;
 exports.getStandardFormats = getStandardFormats;
 // Re-export logger utilities
@@ -137,10 +137,9 @@ Object.defineProperty(exports, "isAdcpSuccess", { enumerable: true, get: functio
 var protocol_detection_1 = require("./protocol-detection");
 Object.defineProperty(exports, "detectProtocol", { enumerable: true, get: function () { return protocol_detection_1.detectProtocol; } });
 Object.defineProperty(exports, "detectProtocolWithTimeout", { enumerable: true, get: function () { return protocol_detection_1.detectProtocolWithTimeout; } });
-// Re-export format asset utilities (v2.6 backward compatibility)
+// Re-export format asset utilities
 var format_assets_1 = require("./format-assets");
 Object.defineProperty(exports, "getFormatAssets", { enumerable: true, get: function () { return format_assets_1.getFormatAssets; } });
-Object.defineProperty(exports, "normalizeAssetsRequired", { enumerable: true, get: function () { return format_assets_1.normalizeAssetsRequired; } });
 Object.defineProperty(exports, "getRequiredAssets", { enumerable: true, get: function () { return format_assets_1.getRequiredAssets; } });
 Object.defineProperty(exports, "getOptionalAssets", { enumerable: true, get: function () { return format_assets_1.getOptionalAssets; } });
 Object.defineProperty(exports, "getIndividualAssets", { enumerable: true, get: function () { return format_assets_1.getIndividualAssets; } });
@@ -148,4 +147,15 @@ Object.defineProperty(exports, "getRepeatableGroups", { enumerable: true, get: f
 Object.defineProperty(exports, "usesDeprecatedAssetsField", { enumerable: true, get: function () { return format_assets_1.usesDeprecatedAssetsField; } });
 Object.defineProperty(exports, "getAssetCount", { enumerable: true, get: function () { return format_assets_1.getAssetCount; } });
 Object.defineProperty(exports, "hasAssets", { enumerable: true, get: function () { return format_assets_1.hasAssets; } });
+// Re-export pricing adapter utilities (v3 pricing field compatibility)
+var pricing_adapter_1 = require("./pricing-adapter");
+Object.defineProperty(exports, "adaptPricingOptionForV2", { enumerable: true, get: function () { return pricing_adapter_1.adaptPricingOptionForV2; } });
+Object.defineProperty(exports, "normalizePricingOption", { enumerable: true, get: function () { return pricing_adapter_1.normalizePricingOption; } });
+Object.defineProperty(exports, "normalizeProductPricing", { enumerable: true, get: function () { return pricing_adapter_1.normalizeProductPricing; } });
+Object.defineProperty(exports, "normalizeGetProductsResponse", { enumerable: true, get: function () { return pricing_adapter_1.normalizeGetProductsResponse; } });
+Object.defineProperty(exports, "usesV2PricingFields", { enumerable: true, get: function () { return pricing_adapter_1.usesV2PricingFields; } });
+Object.defineProperty(exports, "usesV3PricingFields", { enumerable: true, get: function () { return pricing_adapter_1.usesV3PricingFields; } });
+Object.defineProperty(exports, "isFixedPricing", { enumerable: true, get: function () { return pricing_adapter_1.isFixedPricing; } });
+Object.defineProperty(exports, "getPrice", { enumerable: true, get: function () { return pricing_adapter_1.getPrice; } });
+Object.defineProperty(exports, "getFloorPrice", { enumerable: true, get: function () { return pricing_adapter_1.getFloorPrice; } });
 //# sourceMappingURL=index.js.map