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

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

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

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

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

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

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

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

@@ -254,6 +254,8 @@ export interface CreativeFormatSelectorContainer {
 /** Canonical package/product selectors accepted by the primary sync API. */
 export interface CanonicalCreativeFormatSelectorContainer {
     package_id?: string;
+    /** Target product, used to recover seller declarations after serializing selectors. */
+    product_id?: string;
     format_options?: ReadonlyArray<CanonicalFormatDeclaration>;
     format_option_refs?: ReadonlyArray<FormatOptionReference>;
     format_kind?: CanonicalFormatKind;

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

@@ -254,6 +254,8 @@ export interface CreativeFormatSelectorContainer {
 /** Canonical package/product selectors accepted by the primary sync API. */
 export interface CanonicalCreativeFormatSelectorContainer {
     package_id?: string;
+    /** Target product, used to recover seller declarations after serializing selectors. */
+    product_id?: string;
     format_options?: ReadonlyArray<CanonicalFormatDeclaration>;
     format_option_refs?: ReadonlyArray<FormatOptionReference>;
     format_kind?: CanonicalFormatKind;

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

@@ -20,6 +20,7 @@ var creative_delivery_exports = {};
 __export(creative_delivery_exports, {
   CreativeFormatCapabilityError: () => CreativeFormatCapabilityError,
   CreativeFormatProjectionError: () => CreativeFormatProjectionError,
+  canUseProductOptionsForCreativeWire: () => canUseProductOptionsForCreativeWire,
   projectCreativeForDelivery: () => projectCreativeForDelivery,
   projectMediaBuyCreativesForDelivery: () => projectMediaBuyCreativesForDelivery,
   projectSyncCreativesForDelivery: () => projectSyncCreativesForDelivery,
@@ -1134,10 +1135,16 @@ function resolveCreativeFormatWireMode(capabilities, negotiatedVersion) {
   if (explicitCanonical === false) return "legacy";
   return "unknown";
 }
+function canUseProductOptionsForCreativeWire(capabilities, requestedVersion) {
+  const caps = record(capabilities);
+  const negotiated = mutuallyServedRelease(caps, record(caps?._raw), requestedVersion);
+  return negotiated?.major === 3 && negotiated.minor === 1;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CreativeFormatCapabilityError,
   CreativeFormatProjectionError,
+  canUseProductOptionsForCreativeWire,
   projectCreativeForDelivery,
   projectMediaBuyCreativesForDelivery,
   projectSyncCreativesForDelivery,

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

@@ -1114,9 +1114,15 @@ function resolveCreativeFormatWireMode(capabilities, negotiatedVersion) {
   if (explicitCanonical === false) return "legacy";
   return "unknown";
 }
+function canUseProductOptionsForCreativeWire(capabilities, requestedVersion) {
+  const caps = record(capabilities);
+  const negotiated = mutuallyServedRelease(caps, record(caps?._raw), requestedVersion);
+  return negotiated?.major === 3 && negotiated.minor === 1;
+}
 export {
   CreativeFormatCapabilityError,
   CreativeFormatProjectionError,
+  canUseProductOptionsForCreativeWire,
   projectCreativeForDelivery,
   projectMediaBuyCreativesForDelivery,
   projectSyncCreativesForDelivery,

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

@@ -12,9 +12,21 @@ type DeclarationWithMetadata = CanonicalFormatDeclaration;
 export type PackageSelectionMetadata = {
     format_option_refs?: readonly unknown[];
 };
+export interface SellerFormatEvidence {
+    scopeKey: string;
+    accountScope: string;
+    productId: string;
+    expiresAt: number;
+}
+/** Positive evidence is client/account-bound and cannot survive a JSON round trip on its own. */
+export declare function rememberSellerFormatEvidence(declaration: object, evidence: SellerFormatEvidence): void;
+export declare function sellerFormatEvidence(declaration: object): SellerFormatEvidence | undefined;
 /** Keep seller-origin evidence private while canonical products pass through the cache. */
 export declare function rememberSellerDeclaredFormatOption(declaration: object, declared: boolean): void;
 export declare function sellerDeclaredFormatOption(declaration: object): boolean | undefined;
+/** A pure legacy projection cannot establish what the original seller advertised. */
+export declare function rememberSynthesizedFormatOption(declaration: object): void;
+export declare function isSynthesizedFormatOption(declaration: object): boolean;
 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[];

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

@@ -12,9 +12,21 @@ type DeclarationWithMetadata = CanonicalFormatDeclaration;
 export type PackageSelectionMetadata = {
     format_option_refs?: readonly unknown[];
 };
+export interface SellerFormatEvidence {
+    scopeKey: string;
+    accountScope: string;
+    productId: string;
+    expiresAt: number;
+}
+/** Positive evidence is client/account-bound and cannot survive a JSON round trip on its own. */
+export declare function rememberSellerFormatEvidence(declaration: object, evidence: SellerFormatEvidence): void;
+export declare function sellerFormatEvidence(declaration: object): SellerFormatEvidence | undefined;
 /** Keep seller-origin evidence private while canonical products pass through the cache. */
 export declare function rememberSellerDeclaredFormatOption(declaration: object, declared: boolean): void;
 export declare function sellerDeclaredFormatOption(declaration: object): boolean | undefined;
+/** A pure legacy projection cannot establish what the original seller advertised. */
+export declare function rememberSynthesizedFormatOption(declaration: object): void;
+export declare function isSynthesizedFormatOption(declaration: object): boolean;
 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[];

package/dist/lib/v2/projection/legacy-metadata.js

@@ -20,22 +20,52 @@ var legacy_metadata_exports = {};
 __export(legacy_metadata_exports, {
   concealLegacyFormatRefs: () => concealLegacyFormatRefs,
   concealSelectedFormatOptions: () => concealSelectedFormatOptions,
+  isSynthesizedFormatOption: () => isSynthesizedFormatOption,
   legacyFormatRefsForDeclaration: () => legacyFormatRefsForDeclaration,
   rememberSellerDeclaredFormatOption: () => rememberSellerDeclaredFormatOption,
+  rememberSellerFormatEvidence: () => rememberSellerFormatEvidence,
+  rememberSynthesizedFormatOption: () => rememberSynthesizedFormatOption,
   selectedFormatOptions: () => selectedFormatOptions,
   sellerDeclaredFormatOption: () => sellerDeclaredFormatOption,
+  sellerFormatEvidence: () => sellerFormatEvidence,
   structuredCloneWithLegacyCreativeMetadata: () => structuredCloneWithLegacyCreativeMetadata,
   transferLegacyCreativeMetadata: () => transferLegacyCreativeMetadata
 });
 module.exports = __toCommonJS(legacy_metadata_exports);
+var import_jcs = require('../../utils/jcs.js');
 const legacyRefsByDeclaration = /* @__PURE__ */ new WeakMap();
 const selectedOptionsByRefs = /* @__PURE__ */ new WeakMap();
 const sellerDeclaredByDeclaration = /* @__PURE__ */ new WeakMap();
+const sellerEvidenceByDeclaration = /* @__PURE__ */ new WeakMap();
+function rememberSellerFormatEvidence(declaration, evidence) {
+  try {
+    sellerEvidenceByDeclaration.set(
+      declaration,
+      Object.freeze({ ...evidence, fingerprint: (0, import_jcs.canonicalize)(declaration) })
+    );
+  } catch {
+  }
+}
+function sellerFormatEvidence(declaration) {
+  const evidence = sellerEvidenceByDeclaration.get(declaration);
+  try {
+    return evidence?.fingerprint === (0, import_jcs.canonicalize)(declaration) ? evidence : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function rememberSellerDeclaredFormatOption(declaration, declared) {
   sellerDeclaredByDeclaration.set(declaration, declared);
 }
 function sellerDeclaredFormatOption(declaration) {
-  return sellerDeclaredByDeclaration.get(declaration);
+  const origin = sellerDeclaredByDeclaration.get(declaration);
+  return typeof origin === "boolean" ? origin : void 0;
+}
+function rememberSynthesizedFormatOption(declaration) {
+  sellerDeclaredByDeclaration.set(declaration, "synthesized");
+}
+function isSynthesizedFormatOption(declaration) {
+  return sellerDeclaredByDeclaration.get(declaration) === "synthesized";
 }
 function concealLegacyFormatRefs(declaration) {
   const { v1_format_ref: refs, ...canonical } = declaration;
@@ -43,6 +73,8 @@ function concealLegacyFormatRefs(declaration) {
   const refsToConceal = Array.isArray(existingHidden) && existingHidden.length > 0 ? existingHidden : refs;
   const declared = sellerDeclaredByDeclaration.get(declaration);
   if (declared !== void 0) sellerDeclaredByDeclaration.set(canonical, declared);
+  const evidence = sellerEvidenceByDeclaration.get(declaration);
+  if (evidence) sellerEvidenceByDeclaration.set(canonical, evidence);
   if (Array.isArray(refsToConceal) && refsToConceal.length > 0) {
     legacyRefsByDeclaration.set(
       canonical,
@@ -75,6 +107,8 @@ function transferLegacyCreativeMetadata(source, target) {
   if (selected) selectedOptionsByRefs.set(target, selected);
   const declared = sellerDeclaredByDeclaration.get(source);
   if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
+  const evidence = sellerEvidenceByDeclaration.get(source);
+  if (evidence) sellerEvidenceByDeclaration.set(target, evidence);
 }
 function structuredCloneWithLegacyCreativeMetadata(value) {
   const clone = structuredClone(value);
@@ -82,6 +116,8 @@ function structuredCloneWithLegacyCreativeMetadata(value) {
   const snapshotMetadata = (source, target) => {
     const declared = sellerDeclaredByDeclaration.get(source);
     if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
+    const evidence = sellerEvidenceByDeclaration.get(source);
+    if (evidence) sellerEvidenceByDeclaration.set(target, evidence);
     const refs = legacyRefsByDeclaration.get(source);
     if (refs) legacyRefsByDeclaration.set(target, structuredClone(refs));
     const selected = selectedOptionsByRefs.get(source);
@@ -119,10 +155,14 @@ function structuredCloneWithLegacyCreativeMetadata(value) {
 0 && (module.exports = {
   concealLegacyFormatRefs,
   concealSelectedFormatOptions,
+  isSynthesizedFormatOption,
   legacyFormatRefsForDeclaration,
   rememberSellerDeclaredFormatOption,
+  rememberSellerFormatEvidence,
+  rememberSynthesizedFormatOption,
   selectedFormatOptions,
   sellerDeclaredFormatOption,
+  sellerFormatEvidence,
   structuredCloneWithLegacyCreativeMetadata,
   transferLegacyCreativeMetadata
 });

package/dist/lib/v2/projection/legacy-metadata.mjs

@@ -1,11 +1,37 @@
+import { canonicalize } from "../../utils/jcs.mjs";
 const legacyRefsByDeclaration = /* @__PURE__ */ new WeakMap();
 const selectedOptionsByRefs = /* @__PURE__ */ new WeakMap();
 const sellerDeclaredByDeclaration = /* @__PURE__ */ new WeakMap();
+const sellerEvidenceByDeclaration = /* @__PURE__ */ new WeakMap();
+function rememberSellerFormatEvidence(declaration, evidence) {
+  try {
+    sellerEvidenceByDeclaration.set(
+      declaration,
+      Object.freeze({ ...evidence, fingerprint: canonicalize(declaration) })
+    );
+  } catch {
+  }
+}
+function sellerFormatEvidence(declaration) {
+  const evidence = sellerEvidenceByDeclaration.get(declaration);
+  try {
+    return evidence?.fingerprint === canonicalize(declaration) ? evidence : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function rememberSellerDeclaredFormatOption(declaration, declared) {
   sellerDeclaredByDeclaration.set(declaration, declared);
 }
 function sellerDeclaredFormatOption(declaration) {
-  return sellerDeclaredByDeclaration.get(declaration);
+  const origin = sellerDeclaredByDeclaration.get(declaration);
+  return typeof origin === "boolean" ? origin : void 0;
+}
+function rememberSynthesizedFormatOption(declaration) {
+  sellerDeclaredByDeclaration.set(declaration, "synthesized");
+}
+function isSynthesizedFormatOption(declaration) {
+  return sellerDeclaredByDeclaration.get(declaration) === "synthesized";
 }
 function concealLegacyFormatRefs(declaration) {
   const { v1_format_ref: refs, ...canonical } = declaration;
@@ -13,6 +39,8 @@ function concealLegacyFormatRefs(declaration) {
   const refsToConceal = Array.isArray(existingHidden) && existingHidden.length > 0 ? existingHidden : refs;
   const declared = sellerDeclaredByDeclaration.get(declaration);
   if (declared !== void 0) sellerDeclaredByDeclaration.set(canonical, declared);
+  const evidence = sellerEvidenceByDeclaration.get(declaration);
+  if (evidence) sellerEvidenceByDeclaration.set(canonical, evidence);
   if (Array.isArray(refsToConceal) && refsToConceal.length > 0) {
     legacyRefsByDeclaration.set(
       canonical,
@@ -45,6 +73,8 @@ function transferLegacyCreativeMetadata(source, target) {
   if (selected) selectedOptionsByRefs.set(target, selected);
   const declared = sellerDeclaredByDeclaration.get(source);
   if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
+  const evidence = sellerEvidenceByDeclaration.get(source);
+  if (evidence) sellerEvidenceByDeclaration.set(target, evidence);
 }
 function structuredCloneWithLegacyCreativeMetadata(value) {
   const clone = structuredClone(value);
@@ -52,6 +82,8 @@ function structuredCloneWithLegacyCreativeMetadata(value) {
   const snapshotMetadata = (source, target) => {
     const declared = sellerDeclaredByDeclaration.get(source);
     if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
+    const evidence = sellerEvidenceByDeclaration.get(source);
+    if (evidence) sellerEvidenceByDeclaration.set(target, evidence);
     const refs = legacyRefsByDeclaration.get(source);
     if (refs) legacyRefsByDeclaration.set(target, structuredClone(refs));
     const selected = selectedOptionsByRefs.get(source);
@@ -88,10 +120,14 @@ function structuredCloneWithLegacyCreativeMetadata(value) {
 export {
   concealLegacyFormatRefs,
   concealSelectedFormatOptions,
+  isSynthesizedFormatOption,
   legacyFormatRefsForDeclaration,
   rememberSellerDeclaredFormatOption,
+  rememberSellerFormatEvidence,
+  rememberSynthesizedFormatOption,
   selectedFormatOptions,
   sellerDeclaredFormatOption,
+  sellerFormatEvidence,
   structuredCloneWithLegacyCreativeMetadata,
   transferLegacyCreativeMetadata
 };

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

@@ -12,7 +12,7 @@ export type NormalizedLegacyProduct<TProduct extends LegacyProductNormalizationI
     forecast?: Record<string, unknown>;
 };
 /**
- * Apply the SDK's complete v2.5 `get_products` compatibility normalization
+ * Apply the SDK's established `get_products` field normalization
  * before projecting a response recovered through a custom `tasks_get` flow.
  */
 export declare function normalizeLegacyGetProductsResponse<TProduct extends LegacyProductNormalizationInput, TResponse extends object & {

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

@@ -12,7 +12,7 @@ export type NormalizedLegacyProduct<TProduct extends LegacyProductNormalizationI
     forecast?: Record<string, unknown>;
 };
 /**
- * Apply the SDK's complete v2.5 `get_products` compatibility normalization
+ * Apply the SDK's established `get_products` field normalization
  * before projecting a response recovered through a custom `tasks_get` flow.
  */
 export declare function normalizeLegacyGetProductsResponse<TProduct extends LegacyProductNormalizationInput, TResponse extends object & {

package/dist/lib/v2/projection/v1-to-v2.js

@@ -339,6 +339,7 @@ function projectV1ProductToV2(v1, options) {
     ...rest,
     format_options
   };
+  for (const declaration of format_options) (0, import_legacy_metadata.rememberSynthesizedFormatOption)(declaration);
   return { v2: v2Product, diagnostics, legacyRoutes: (0, import_legacy_routes.legacyRoutesForProduct)(v1.product_id, format_options) };
 }
 function canonicalDeclarationFromBareId(id, options) {
@@ -400,6 +401,18 @@ function compatible(option, ref) {
   )) {
     return false;
   }
+  for (const dimension of ["width", "height"]) {
+    const actual = constraints[dimension];
+    const min = params[`min_${dimension}`];
+    const max = params[`max_${dimension}`];
+    if (typeof actual === "number" && (typeof min === "number" && actual < min || typeof max === "number" && actual > max))
+      return false;
+  }
+  const duration = constraints.duration_ms_exact;
+  if (typeof duration === "number" && typeof params.duration_ms_exact !== "number" && Array.isArray(params.duration_ms_range)) {
+    const [min, max] = params.duration_ms_range;
+    if (typeof min === "number" && duration < min || typeof max === "number" && duration > max) return false;
+  }
   if (Array.isArray(params.sizes) && params.sizes.length > 0) {
     return params.sizes.some((value) => {
       const size = record(value);

package/dist/lib/v2/projection/v1-to-v2.mjs

@@ -15,6 +15,7 @@ import { legacyRoutesForProduct } from "./legacy-routes.mjs";
 import {
   concealLegacyFormatRefs,
   legacyFormatRefsForDeclaration,
+  rememberSynthesizedFormatOption,
   transferLegacyCreativeMetadata
 } from "./legacy-metadata.mjs";
 const SDK_ID = `@adcp/sdk@${LIBRARY_VERSION}`;
@@ -321,6 +322,7 @@ function projectV1ProductToV2(v1, options) {
     ...rest,
     format_options
   };
+  for (const declaration of format_options) rememberSynthesizedFormatOption(declaration);
   return { v2: v2Product, diagnostics, legacyRoutes: legacyRoutesForProduct(v1.product_id, format_options) };
 }
 function canonicalDeclarationFromBareId(id, options) {
@@ -382,6 +384,18 @@ function compatible(option, ref) {
   )) {
     return false;
   }
+  for (const dimension of ["width", "height"]) {
+    const actual = constraints[dimension];
+    const min = params[`min_${dimension}`];
+    const max = params[`max_${dimension}`];
+    if (typeof actual === "number" && (typeof min === "number" && actual < min || typeof max === "number" && actual > max))
+      return false;
+  }
+  const duration = constraints.duration_ms_exact;
+  if (typeof duration === "number" && typeof params.duration_ms_exact !== "number" && Array.isArray(params.duration_ms_range)) {
+    const [min, max] = params.duration_ms_range;
+    if (typeof min === "number" && duration < min || typeof max === "number" && duration > max) return false;
+  }
   if (Array.isArray(params.sizes) && params.sizes.length > 0) {
     return params.sizes.some((value) => {
       const size = record(value);

package/dist/lib/validation/client-hooks.d.mts

@@ -16,10 +16,7 @@ export interface ValidationHookConfig {
  *
  * Both default to `warn` everywhere — buyers get drift surfaced through
  * `result.debug_logs` without losing the response payload to a strict
- * rejection. v2.5 sellers in particular ship enough legacy drift
- * (envelope nulls, optional-required fields, enum mismatches) that
- * strict-by-default leaves callers staring at "0 products" with no
- * useful signal. Buyers and harnesses that want hard-stop behavior
+ * rejection. Buyers and harnesses that want hard-stop behavior
  * (conformance suites, third-party validators) opt into strict via
  * `validation: { responses: 'strict' }` — explicit config always wins.
  *

package/dist/lib/validation/client-hooks.d.ts

@@ -16,10 +16,7 @@ export interface ValidationHookConfig {
  *
  * Both default to `warn` everywhere — buyers get drift surfaced through
  * `result.debug_logs` without losing the response payload to a strict
- * rejection. v2.5 sellers in particular ship enough legacy drift
- * (envelope nulls, optional-required fields, enum mismatches) that
- * strict-by-default leaves callers staring at "0 products" with no
- * useful signal. Buyers and harnesses that want hard-stop behavior
+ * rejection. Buyers and harnesses that want hard-stop behavior
  * (conformance suites, third-party validators) opt into strict via
  * `validation: { responses: 'strict' }` — explicit config always wins.
  *

package/dist/lib/validation/get-products-request.d.mts

@@ -107,7 +107,7 @@ export declare const LegacyGetProductsRequestSchema: z.ZodObject<{
     required_overlay_support: z.ZodOptional<z.ZodType<import("../types/core.generated.mjs").TargetingOverlayRequirements, import("../types/core.generated.mjs").TargetingOverlayRequirements, z.core.$ZodTypeInternals<import("../types/core.generated.mjs").TargetingOverlayRequirements, import("../types/core.generated.mjs").TargetingOverlayRequirements>>>;
     required_media_buy_support: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").ProductMediaBuySupportRequirements, import("../types/tools.generated.mjs").ProductMediaBuySupportRequirements, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").ProductMediaBuySupportRequirements, import("../types/tools.generated.mjs").ProductMediaBuySupportRequirements>>>;
     property_list: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").PropertyListReference, import("../types/tools.generated.mjs").PropertyListReference, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").PropertyListReference, import("../types/tools.generated.mjs").PropertyListReference>>>;
-    fields: z.ZodOptional<z.ZodType<("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], z.core.$ZodTypeInternals<("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[]>>>;
+    fields: z.ZodOptional<z.ZodType<("name" | "audience_evidence" | "identity" | "forecast" | "description" | "publisher_properties" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "audience_evidence" | "identity" | "forecast" | "description" | "publisher_properties" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], z.core.$ZodTypeInternals<("name" | "audience_evidence" | "identity" | "forecast" | "description" | "publisher_properties" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "audience_evidence" | "identity" | "forecast" | "description" | "publisher_properties" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[]>>>;
     time_budget: z.ZodOptional<z.ZodType<import("../index.mjs").Duration, import("../index.mjs").Duration, z.core.$ZodTypeInternals<import("../index.mjs").Duration, import("../index.mjs").Duration>>>;
     push_notification_config: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").PushNotificationConfig, import("../types/tools.generated.mjs").PushNotificationConfig, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").PushNotificationConfig, import("../types/tools.generated.mjs").PushNotificationConfig>>>;
     pagination: z.ZodOptional<z.ZodType<import("../index.mjs").PaginationRequest, import("../index.mjs").PaginationRequest, z.core.$ZodTypeInternals<import("../index.mjs").PaginationRequest, import("../index.mjs").PaginationRequest>>>;

package/dist/lib/validation/get-products-request.d.ts

@@ -107,7 +107,7 @@ export declare const LegacyGetProductsRequestSchema: z.ZodObject<{
     required_overlay_support: z.ZodOptional<z.ZodType<import("../types/core.generated").TargetingOverlayRequirements, import("../types/core.generated").TargetingOverlayRequirements, z.core.$ZodTypeInternals<import("../types/core.generated").TargetingOverlayRequirements, import("../types/core.generated").TargetingOverlayRequirements>>>;
     required_media_buy_support: z.ZodOptional<z.ZodType<import("../types/tools.generated").ProductMediaBuySupportRequirements, import("../types/tools.generated").ProductMediaBuySupportRequirements, z.core.$ZodTypeInternals<import("../types/tools.generated").ProductMediaBuySupportRequirements, import("../types/tools.generated").ProductMediaBuySupportRequirements>>>;
     property_list: z.ZodOptional<z.ZodType<import("../types/tools.generated").PropertyListReference, import("../types/tools.generated").PropertyListReference, z.core.$ZodTypeInternals<import("../types/tools.generated").PropertyListReference, import("../types/tools.generated").PropertyListReference>>>;
-    fields: z.ZodOptional<z.ZodType<("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], z.core.$ZodTypeInternals<("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[]>>>;
+    fields: z.ZodOptional<z.ZodType<("name" | "audience_evidence" | "identity" | "forecast" | "description" | "publisher_properties" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "audience_evidence" | "identity" | "forecast" | "description" | "publisher_properties" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], z.core.$ZodTypeInternals<("name" | "audience_evidence" | "identity" | "forecast" | "description" | "publisher_properties" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "audience_evidence" | "identity" | "forecast" | "description" | "publisher_properties" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[]>>>;
     time_budget: z.ZodOptional<z.ZodType<import("..").Duration, import("..").Duration, z.core.$ZodTypeInternals<import("..").Duration, import("..").Duration>>>;
     push_notification_config: z.ZodOptional<z.ZodType<import("../types/tools.generated").PushNotificationConfig, import("../types/tools.generated").PushNotificationConfig, z.core.$ZodTypeInternals<import("../types/tools.generated").PushNotificationConfig, import("../types/tools.generated").PushNotificationConfig>>>;
     pagination: z.ZodOptional<z.ZodType<import("..").PaginationRequest, import("..").PaginationRequest, z.core.$ZodTypeInternals<import("..").PaginationRequest, import("..").PaginationRequest>>>;