@adcp/sdk 15.7.0 → 15.8.0

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

@@ -258,5 +258,27 @@ export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireM
 export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'canonical', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'>;
 export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'legacy' | 'unknown', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'legacy'>;
 export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: CreativeFormatWireMode, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'> | ProjectedSyncCreativeRequest<T, 'legacy'>;
+/** The direct canonical selector for a format option the seller did not declare. */
+export interface UndeclaredFormatOptionSelector {
+    format_kind: string;
+    params?: unknown;
+    /** Custom/schema-backed formats cannot retain identity in a direct selector. */
+    unrepresentable?: true;
+}
+/**
+ * Looks up a format option the SDK derived from a seller's legacy `format_ids`.
+ * Returns undefined for options the seller declared in its own `format_options[]`.
+ */
+export type UndeclaredFormatOptionLookup = (ref: FormatOptionReference, productId: string | undefined) => UndeclaredFormatOptionSelector | undefined;
+/**
+ * Canonical-wire counterpart to legacy downgrade for format options the seller
+ * never declared. AdCP 3.x products may carry only legacy `format_ids`; the SDK
+ * upgrades them for the buyer and mints the option ids itself. A seller only
+ * resolves `format_option_refs` against its own `format_options[]`, so a
+ * package selecting such options is sent as the equivalent `format_kind` +
+ * `params` selector, and creative pins to them are dropped. A selection that
+ * one direct selector cannot express fails closed before dispatch.
+ */
+export declare function projectUndeclaredFormatOptionSelectors<T>(request: T, operation: 'create_media_buy' | 'update_media_buy' | 'sync_creatives', lookup: UndeclaredFormatOptionLookup): T;
 export declare function resolveCreativeFormatWireMode(capabilities: unknown, negotiatedVersion?: string): CreativeFormatWireMode;
 export {};

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

@@ -258,5 +258,27 @@ export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireM
 export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'canonical', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'>;
 export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'legacy' | 'unknown', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'legacy'>;
 export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: CreativeFormatWireMode, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'> | ProjectedSyncCreativeRequest<T, 'legacy'>;
+/** The direct canonical selector for a format option the seller did not declare. */
+export interface UndeclaredFormatOptionSelector {
+    format_kind: string;
+    params?: unknown;
+    /** Custom/schema-backed formats cannot retain identity in a direct selector. */
+    unrepresentable?: true;
+}
+/**
+ * Looks up a format option the SDK derived from a seller's legacy `format_ids`.
+ * Returns undefined for options the seller declared in its own `format_options[]`.
+ */
+export type UndeclaredFormatOptionLookup = (ref: FormatOptionReference, productId: string | undefined) => UndeclaredFormatOptionSelector | undefined;
+/**
+ * Canonical-wire counterpart to legacy downgrade for format options the seller
+ * never declared. AdCP 3.x products may carry only legacy `format_ids`; the SDK
+ * upgrades them for the buyer and mints the option ids itself. A seller only
+ * resolves `format_option_refs` against its own `format_options[]`, so a
+ * package selecting such options is sent as the equivalent `format_kind` +
+ * `params` selector, and creative pins to them are dropped. A selection that
+ * one direct selector cannot express fails closed before dispatch.
+ */
+export declare function projectUndeclaredFormatOptionSelectors<T>(request: T, operation: 'create_media_buy' | 'update_media_buy' | 'sync_creatives', lookup: UndeclaredFormatOptionLookup): T;
 export declare function resolveCreativeFormatWireMode(capabilities: unknown, negotiatedVersion?: string): CreativeFormatWireMode;
 export {};

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

@@ -23,6 +23,7 @@ __export(creative_delivery_exports, {
   projectCreativeForDelivery: () => projectCreativeForDelivery,
   projectMediaBuyCreativesForDelivery: () => projectMediaBuyCreativesForDelivery,
   projectSyncCreativesForDelivery: () => projectSyncCreativesForDelivery,
+  projectUndeclaredFormatOptionSelectors: () => projectUndeclaredFormatOptionSelectors,
   resolveCreativeFormatWireMode: () => resolveCreativeFormatWireMode,
   stripLegacyCreativeIdentity: () => stripLegacyCreativeIdentity
 });
@@ -30,6 +31,7 @@ module.exports = __toCommonJS(creative_delivery_exports);
 var import_v1_to_v2 = require('./v1-to-v2.js');
 var import_v2_to_v1 = require('./v2-to-v1.js');
 var import_legacy_metadata = require('./legacy-metadata.js');
+var import_jcs = require('../../utils/jcs.js');
 function stripLegacyCreativeIdentity(value) {
   const legacyTokens = /* @__PURE__ */ new Set();
   const legacyUrlTokens = /* @__PURE__ */ new Set();
@@ -941,6 +943,95 @@ function projectSyncCreativesForDelivery(request, selectorContainers, wireMode =
   });
   return changed ? { ...requestRecord, creatives } : request;
 }
+function stripUndeclaredCreativeOptionRef(creativeValue, productId, operation, lookup) {
+  const creative = record(creativeValue);
+  const ref = creative ? optionReference(creative.format_option_ref) : void 0;
+  if (!creative || !ref) return creativeValue;
+  const selector = lookup(ref, productId);
+  if (!selector) return creativeValue;
+  if (selector.unrepresentable || creative.format_kind === "custom") {
+    throw new CreativeFormatProjectionError(
+      operation,
+      typeof creative.creative_id === "string" ? creative.creative_id : "(unknown)",
+      "the seller did not declare this format option and its schema identity cannot be expressed without a seller-declared format_option_ref"
+    );
+  }
+  const next = { ...creative };
+  delete next.format_option_ref;
+  return next;
+}
+function directSelectorForUndeclaredOptions(pkg, operation, lookup) {
+  const refs = Array.isArray(pkg.format_option_refs) ? pkg.format_option_refs.flatMap((value) => {
+    const ref = optionReference(value);
+    return ref ? [ref] : [];
+  }) : [];
+  const productId = typeof pkg.product_id === "string" ? pkg.product_id : void 0;
+  const selectors = refs.map((ref) => lookup(ref, productId));
+  if (!selectors.some((selector2) => selector2 !== void 0)) return pkg;
+  if (refs.length !== pkg.format_option_refs.length || selectors.some((selector2) => selector2?.unrepresentable)) {
+    throw new CreativeFormatProjectionError(
+      operation,
+      "(package selector)",
+      "the selected undeclared format options cannot be expressed as a direct selector; custom formats require a seller-declared format option"
+    );
+  }
+  const distinct = [
+    ...new Map(
+      selectors.map((selector2) => [
+        selector2 ? (0, import_jcs.canonicalize)({ format_kind: selector2.format_kind, params: selector2.params ?? null }) : "",
+        selector2
+      ])
+    ).values()
+  ];
+  const selector = distinct.length === 1 ? distinct[0] : void 0;
+  if (!selector || pkg.format_kind !== void 0 || pkg.params !== void 0) {
+    throw new CreativeFormatProjectionError(
+      operation,
+      "(package selector)",
+      "the seller did not declare the selected format options in its product format_options; select options that one format_kind + params selector can express"
+    );
+  }
+  const next = { ...pkg, format_kind: selector.format_kind };
+  delete next.format_option_refs;
+  if (selector.params !== void 0) next.params = structuredClone(selector.params);
+  return next;
+}
+function projectUndeclaredFormatOptionSelectors(request, operation, lookup) {
+  const requestRecord = record(request);
+  if (!requestRecord) return request;
+  let changed = false;
+  const next = { ...requestRecord };
+  for (const key of ["packages", "new_packages"]) {
+    const packages = requestRecord[key];
+    if (!Array.isArray(packages)) continue;
+    next[key] = packages.map((packageValue) => {
+      const pkg = record(packageValue);
+      if (!pkg) return packageValue;
+      const productId = typeof pkg.product_id === "string" ? pkg.product_id : void 0;
+      let projected = directSelectorForUndeclaredOptions(pkg, operation, lookup);
+      if (Array.isArray(pkg.creatives)) {
+        const creatives = pkg.creatives.map(
+          (creative) => stripUndeclaredCreativeOptionRef(creative, productId, operation, lookup)
+        );
+        if (creatives.some((creative, index) => creative !== pkg.creatives[index])) {
+          projected = { ...projected, creatives };
+        }
+      }
+      if (projected !== pkg) changed = true;
+      return projected;
+    });
+  }
+  if (Array.isArray(requestRecord.creatives)) {
+    const creatives = requestRecord.creatives.map(
+      (creative) => stripUndeclaredCreativeOptionRef(creative, void 0, operation, lookup)
+    );
+    if (creatives.some((creative, index) => creative !== requestRecord.creatives[index])) {
+      next.creatives = creatives;
+      changed = true;
+    }
+  }
+  return changed ? next : request;
+}
 function release(value) {
   if (typeof value !== "string") return void 0;
   const match = /^v?(\d+)\.(\d+)(?:\.|-|$)/.exec(value.trim());
@@ -1022,6 +1113,7 @@ function resolveCreativeFormatWireMode(capabilities, negotiatedVersion) {
   projectCreativeForDelivery,
   projectMediaBuyCreativesForDelivery,
   projectSyncCreativesForDelivery,
+  projectUndeclaredFormatOptionSelectors,
   resolveCreativeFormatWireMode,
   stripLegacyCreativeIdentity
 });

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

@@ -10,6 +10,7 @@ import {
   selectedFormatOptions,
   transferLegacyCreativeMetadata
 } from "./legacy-metadata.mjs";
+import { canonicalize as canonicalizeJson } from "../../utils/jcs.mjs";
 function stripLegacyCreativeIdentity(value) {
   const legacyTokens = /* @__PURE__ */ new Set();
   const legacyUrlTokens = /* @__PURE__ */ new Set();
@@ -921,6 +922,95 @@ function projectSyncCreativesForDelivery(request, selectorContainers, wireMode =
   });
   return changed ? { ...requestRecord, creatives } : request;
 }
+function stripUndeclaredCreativeOptionRef(creativeValue, productId, operation, lookup) {
+  const creative = record(creativeValue);
+  const ref = creative ? optionReference(creative.format_option_ref) : void 0;
+  if (!creative || !ref) return creativeValue;
+  const selector = lookup(ref, productId);
+  if (!selector) return creativeValue;
+  if (selector.unrepresentable || creative.format_kind === "custom") {
+    throw new CreativeFormatProjectionError(
+      operation,
+      typeof creative.creative_id === "string" ? creative.creative_id : "(unknown)",
+      "the seller did not declare this format option and its schema identity cannot be expressed without a seller-declared format_option_ref"
+    );
+  }
+  const next = { ...creative };
+  delete next.format_option_ref;
+  return next;
+}
+function directSelectorForUndeclaredOptions(pkg, operation, lookup) {
+  const refs = Array.isArray(pkg.format_option_refs) ? pkg.format_option_refs.flatMap((value) => {
+    const ref = optionReference(value);
+    return ref ? [ref] : [];
+  }) : [];
+  const productId = typeof pkg.product_id === "string" ? pkg.product_id : void 0;
+  const selectors = refs.map((ref) => lookup(ref, productId));
+  if (!selectors.some((selector2) => selector2 !== void 0)) return pkg;
+  if (refs.length !== pkg.format_option_refs.length || selectors.some((selector2) => selector2?.unrepresentable)) {
+    throw new CreativeFormatProjectionError(
+      operation,
+      "(package selector)",
+      "the selected undeclared format options cannot be expressed as a direct selector; custom formats require a seller-declared format option"
+    );
+  }
+  const distinct = [
+    ...new Map(
+      selectors.map((selector2) => [
+        selector2 ? canonicalizeJson({ format_kind: selector2.format_kind, params: selector2.params ?? null }) : "",
+        selector2
+      ])
+    ).values()
+  ];
+  const selector = distinct.length === 1 ? distinct[0] : void 0;
+  if (!selector || pkg.format_kind !== void 0 || pkg.params !== void 0) {
+    throw new CreativeFormatProjectionError(
+      operation,
+      "(package selector)",
+      "the seller did not declare the selected format options in its product format_options; select options that one format_kind + params selector can express"
+    );
+  }
+  const next = { ...pkg, format_kind: selector.format_kind };
+  delete next.format_option_refs;
+  if (selector.params !== void 0) next.params = structuredClone(selector.params);
+  return next;
+}
+function projectUndeclaredFormatOptionSelectors(request, operation, lookup) {
+  const requestRecord = record(request);
+  if (!requestRecord) return request;
+  let changed = false;
+  const next = { ...requestRecord };
+  for (const key of ["packages", "new_packages"]) {
+    const packages = requestRecord[key];
+    if (!Array.isArray(packages)) continue;
+    next[key] = packages.map((packageValue) => {
+      const pkg = record(packageValue);
+      if (!pkg) return packageValue;
+      const productId = typeof pkg.product_id === "string" ? pkg.product_id : void 0;
+      let projected = directSelectorForUndeclaredOptions(pkg, operation, lookup);
+      if (Array.isArray(pkg.creatives)) {
+        const creatives = pkg.creatives.map(
+          (creative) => stripUndeclaredCreativeOptionRef(creative, productId, operation, lookup)
+        );
+        if (creatives.some((creative, index) => creative !== pkg.creatives[index])) {
+          projected = { ...projected, creatives };
+        }
+      }
+      if (projected !== pkg) changed = true;
+      return projected;
+    });
+  }
+  if (Array.isArray(requestRecord.creatives)) {
+    const creatives = requestRecord.creatives.map(
+      (creative) => stripUndeclaredCreativeOptionRef(creative, void 0, operation, lookup)
+    );
+    if (creatives.some((creative, index) => creative !== requestRecord.creatives[index])) {
+      next.creatives = creatives;
+      changed = true;
+    }
+  }
+  return changed ? next : request;
+}
 function release(value) {
   if (typeof value !== "string") return void 0;
   const match = /^v?(\d+)\.(\d+)(?:\.|-|$)/.exec(value.trim());
@@ -1001,6 +1091,7 @@ export {
   projectCreativeForDelivery,
   projectMediaBuyCreativesForDelivery,
   projectSyncCreativesForDelivery,
+  projectUndeclaredFormatOptionSelectors,
   resolveCreativeFormatWireMode,
   stripLegacyCreativeIdentity
 };

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

@@ -1,9 +1,9 @@
 import type { ProductFormatDeclaration } from '../../types/tools.generated.mjs';
 import type { V1FormatId, V2ProductFormatDeclaration } from './types.mjs';
 /**
- * SDK-private downgrade metadata held out-of-band. WeakMaps keep legacy
- * routing identifiers absent from canonical objects even under reflective
- * inspection while still allowing object-spread package authoring.
+ * SDK-private projection metadata held out-of-band. WeakMaps keep seller
+ * origin evidence and legacy routing identifiers absent from canonical objects
+ * even under reflective inspection while still allowing object-spread package authoring.
  */
 export type CanonicalFormatDeclaration = Omit<V2ProductFormatDeclaration, 'v1_format_ref'> & {
     v1_format_ref?: never;
@@ -12,6 +12,9 @@ type DeclarationWithMetadata = CanonicalFormatDeclaration;
 export type PackageSelectionMetadata = {
     format_option_refs?: readonly unknown[];
 };
+/** 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;
 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

@@ -1,9 +1,9 @@
 import type { ProductFormatDeclaration } from '../../types/tools.generated';
 import type { V1FormatId, V2ProductFormatDeclaration } from './types';
 /**
- * SDK-private downgrade metadata held out-of-band. WeakMaps keep legacy
- * routing identifiers absent from canonical objects even under reflective
- * inspection while still allowing object-spread package authoring.
+ * SDK-private projection metadata held out-of-band. WeakMaps keep seller
+ * origin evidence and legacy routing identifiers absent from canonical objects
+ * even under reflective inspection while still allowing object-spread package authoring.
  */
 export type CanonicalFormatDeclaration = Omit<V2ProductFormatDeclaration, 'v1_format_ref'> & {
     v1_format_ref?: never;
@@ -12,6 +12,9 @@ type DeclarationWithMetadata = CanonicalFormatDeclaration;
 export type PackageSelectionMetadata = {
     format_option_refs?: readonly unknown[];
 };
+/** 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;
 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

@@ -21,17 +21,28 @@ __export(legacy_metadata_exports, {
   concealLegacyFormatRefs: () => concealLegacyFormatRefs,
   concealSelectedFormatOptions: () => concealSelectedFormatOptions,
   legacyFormatRefsForDeclaration: () => legacyFormatRefsForDeclaration,
+  rememberSellerDeclaredFormatOption: () => rememberSellerDeclaredFormatOption,
   selectedFormatOptions: () => selectedFormatOptions,
+  sellerDeclaredFormatOption: () => sellerDeclaredFormatOption,
   structuredCloneWithLegacyCreativeMetadata: () => structuredCloneWithLegacyCreativeMetadata,
   transferLegacyCreativeMetadata: () => transferLegacyCreativeMetadata
 });
 module.exports = __toCommonJS(legacy_metadata_exports);
 const legacyRefsByDeclaration = /* @__PURE__ */ new WeakMap();
 const selectedOptionsByRefs = /* @__PURE__ */ new WeakMap();
+const sellerDeclaredByDeclaration = /* @__PURE__ */ new WeakMap();
+function rememberSellerDeclaredFormatOption(declaration, declared) {
+  sellerDeclaredByDeclaration.set(declaration, declared);
+}
+function sellerDeclaredFormatOption(declaration) {
+  return sellerDeclaredByDeclaration.get(declaration);
+}
 function concealLegacyFormatRefs(declaration) {
   const { v1_format_ref: refs, ...canonical } = declaration;
   const existingHidden = legacyRefsByDeclaration.get(declaration);
   const refsToConceal = Array.isArray(existingHidden) && existingHidden.length > 0 ? existingHidden : refs;
+  const declared = sellerDeclaredByDeclaration.get(declaration);
+  if (declared !== void 0) sellerDeclaredByDeclaration.set(canonical, declared);
   if (Array.isArray(refsToConceal) && refsToConceal.length > 0) {
     legacyRefsByDeclaration.set(
       canonical,
@@ -62,11 +73,15 @@ function transferLegacyCreativeMetadata(source, target) {
   if (refs) legacyRefsByDeclaration.set(target, refs);
   const selected = selectedOptionsByRefs.get(source);
   if (selected) selectedOptionsByRefs.set(target, selected);
+  const declared = sellerDeclaredByDeclaration.get(source);
+  if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
 }
 function structuredCloneWithLegacyCreativeMetadata(value) {
   const clone = structuredClone(value);
   const visited = /* @__PURE__ */ new WeakMap();
   const snapshotMetadata = (source, target) => {
+    const declared = sellerDeclaredByDeclaration.get(source);
+    if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
     const refs = legacyRefsByDeclaration.get(source);
     if (refs) legacyRefsByDeclaration.set(target, structuredClone(refs));
     const selected = selectedOptionsByRefs.get(source);
@@ -105,7 +120,9 @@ function structuredCloneWithLegacyCreativeMetadata(value) {
   concealLegacyFormatRefs,
   concealSelectedFormatOptions,
   legacyFormatRefsForDeclaration,
+  rememberSellerDeclaredFormatOption,
   selectedFormatOptions,
+  sellerDeclaredFormatOption,
   structuredCloneWithLegacyCreativeMetadata,
   transferLegacyCreativeMetadata
 });

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

@@ -1,9 +1,18 @@
 const legacyRefsByDeclaration = /* @__PURE__ */ new WeakMap();
 const selectedOptionsByRefs = /* @__PURE__ */ new WeakMap();
+const sellerDeclaredByDeclaration = /* @__PURE__ */ new WeakMap();
+function rememberSellerDeclaredFormatOption(declaration, declared) {
+  sellerDeclaredByDeclaration.set(declaration, declared);
+}
+function sellerDeclaredFormatOption(declaration) {
+  return sellerDeclaredByDeclaration.get(declaration);
+}
 function concealLegacyFormatRefs(declaration) {
   const { v1_format_ref: refs, ...canonical } = declaration;
   const existingHidden = legacyRefsByDeclaration.get(declaration);
   const refsToConceal = Array.isArray(existingHidden) && existingHidden.length > 0 ? existingHidden : refs;
+  const declared = sellerDeclaredByDeclaration.get(declaration);
+  if (declared !== void 0) sellerDeclaredByDeclaration.set(canonical, declared);
   if (Array.isArray(refsToConceal) && refsToConceal.length > 0) {
     legacyRefsByDeclaration.set(
       canonical,
@@ -34,11 +43,15 @@ function transferLegacyCreativeMetadata(source, target) {
   if (refs) legacyRefsByDeclaration.set(target, refs);
   const selected = selectedOptionsByRefs.get(source);
   if (selected) selectedOptionsByRefs.set(target, selected);
+  const declared = sellerDeclaredByDeclaration.get(source);
+  if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
 }
 function structuredCloneWithLegacyCreativeMetadata(value) {
   const clone = structuredClone(value);
   const visited = /* @__PURE__ */ new WeakMap();
   const snapshotMetadata = (source, target) => {
+    const declared = sellerDeclaredByDeclaration.get(source);
+    if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
     const refs = legacyRefsByDeclaration.get(source);
     if (refs) legacyRefsByDeclaration.set(target, structuredClone(refs));
     const selected = selectedOptionsByRefs.get(source);
@@ -76,7 +89,9 @@ export {
   concealLegacyFormatRefs,
   concealSelectedFormatOptions,
   legacyFormatRefsForDeclaration,
+  rememberSellerDeclaredFormatOption,
   selectedFormatOptions,
+  sellerDeclaredFormatOption,
   structuredCloneWithLegacyCreativeMetadata,
   transferLegacyCreativeMetadata
 };

package/dist/lib/validation/bidding-policy.js

@@ -24,7 +24,7 @@ module.exports = __toCommonJS(bidding_policy_exports);
 var import_zod = require("zod");
 var import_schemas = require('../types/schemas.generated.js');
 const BIDDING_CONTROL_KEYS = ["automatic", "bid_amount", "max_bid", "cost_per", "roas"];
-const BiddingPolicySchema = import_schemas.BiddingPolicySchema.superRefine((policy, ctx) => {
+const BiddingPolicySchema = /* @__PURE__ */ import_schemas.BiddingPolicySchema.superRefine((policy, ctx) => {
   const presentControls = BIDDING_CONTROL_KEYS.filter((key) => policy[key] !== void 0);
   if (presentControls.length === 0) {
     ctx.addIssue({

package/dist/lib/validation/bidding-policy.mjs

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { BiddingPolicySchema as GeneratedBiddingPolicySchema } from "../types/schemas.generated.mjs";
 const BIDDING_CONTROL_KEYS = ["automatic", "bid_amount", "max_bid", "cost_per", "roas"];
-const BiddingPolicySchema = GeneratedBiddingPolicySchema.superRefine((policy, ctx) => {
+const BiddingPolicySchema = /* @__PURE__ */ GeneratedBiddingPolicySchema.superRefine((policy, ctx) => {
   const presentControls = BIDDING_CONTROL_KEYS.filter((key) => policy[key] !== void 0);
   if (presentControls.length === 0) {
     ctx.addIssue({

package/dist/lib/validation/budget-allocation.js

@@ -23,7 +23,7 @@ __export(budget_allocation_exports, {
 module.exports = __toCommonJS(budget_allocation_exports);
 var import_zod = require("zod");
 var import_schemas = require('../types/schemas.generated.js');
-const CanonicalBudgetAllocationSchema = import_schemas.CanonicalBudgetAllocationSchema.superRefine(
+const CanonicalBudgetAllocationSchema = /* @__PURE__ */ import_schemas.CanonicalBudgetAllocationSchema.superRefine(
   (allocation, ctx) => {
     if (allocation.mode === "seller_optimized" && allocation.optimization_goals.length === 0) {
       ctx.addIssue({

package/dist/lib/validation/budget-allocation.mjs

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { CanonicalBudgetAllocationSchema as GeneratedCanonicalBudgetAllocationSchema } from "../types/schemas.generated.mjs";
-const CanonicalBudgetAllocationSchema = GeneratedCanonicalBudgetAllocationSchema.superRefine(
+const CanonicalBudgetAllocationSchema = /* @__PURE__ */ GeneratedCanonicalBudgetAllocationSchema.superRefine(
   (allocation, ctx) => {
     if (allocation.mode === "seller_optimized" && allocation.optimization_goals.length === 0) {
       ctx.addIssue({

package/dist/lib/validation/get-products-request.js

@@ -26,12 +26,12 @@ var import_zod = require("zod");
 var import_schemas = require('../types/schemas.generated.js');
 var import_inline_enums = require('../types/inline-enums.generated.js');
 const LegacyGetProductsRequestSchema = import_schemas.GetProductsRequestSchema;
-const canonicalGetProductsFields = import_inline_enums.GetProductsRequest_FieldsValues.filter(
+const canonicalGetProductsFields = /* @__PURE__ */ import_inline_enums.GetProductsRequest_FieldsValues.filter(
   (field) => field !== "format_ids"
 );
-const GetProductsRequestSchema = import_schemas.GetProductsRequestSchema.safeExtend({
+const GetProductsRequestSchema = /* @__PURE__ */ (() => import_schemas.GetProductsRequestSchema.safeExtend({
   fields: import_zod.z.array(import_zod.z.enum(canonicalGetProductsFields)).optional()
-});
+}))();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   GetProductsRequestSchema,

package/dist/lib/validation/get-products-request.mjs

@@ -2,12 +2,12 @@ import { z } from "zod";
 import { GetProductsRequestSchema as GeneratedGetProductsRequestSchema } from "../types/schemas.generated.mjs";
 import { GetProductsRequest_FieldsValues } from "../types/inline-enums.generated.mjs";
 const LegacyGetProductsRequestSchema = GeneratedGetProductsRequestSchema;
-const canonicalGetProductsFields = GetProductsRequest_FieldsValues.filter(
+const canonicalGetProductsFields = /* @__PURE__ */ GetProductsRequest_FieldsValues.filter(
   (field) => field !== "format_ids"
 );
-const GetProductsRequestSchema = GeneratedGetProductsRequestSchema.safeExtend({
+const GetProductsRequestSchema = /* @__PURE__ */ (() => GeneratedGetProductsRequestSchema.safeExtend({
   fields: z.array(z.enum(canonicalGetProductsFields)).optional()
-});
+}))();
 export {
   GetProductsRequestSchema,
   LegacyGetProductsRequestSchema

package/dist/lib/validation/sync-creatives.js

@@ -26,18 +26,18 @@ __export(sync_creatives_exports, {
 module.exports = __toCommonJS(sync_creatives_exports);
 var import_zod = require("zod");
 var import_schemas = require('../types/schemas.generated.js');
-const SyncCreativesActionSchema = import_zod.z.union([
+const SyncCreativesActionSchema = /* @__PURE__ */ (() => import_zod.z.union([
   import_zod.z.literal("created"),
   import_zod.z.literal("updated"),
   import_zod.z.literal("unchanged"),
   import_zod.z.literal("failed"),
   import_zod.z.literal("deleted")
-]);
+]))();
 const ASSIGNMENT_ERROR_KEY = /^[a-zA-Z0-9_-]+$/;
-const HttpUrlSchema = import_zod.z.string().url().refine((v) => /^https?:\/\//i.test(v), {
+const HttpUrlSchema = /* @__PURE__ */ (() => import_zod.z.string().url().refine((v) => /^https?:\/\//i.test(v), {
   message: "URL must use http(s) scheme"
-});
-const SyncCreativesItemSchema = import_zod.z.object({
+}))();
+const SyncCreativesItemSchema = /* @__PURE__ */ (() => import_zod.z.object({
   creative_id: import_zod.z.string(),
   revision_id: import_schemas.CreativeRevisionIDSchema.optional(),
   action: SyncCreativesActionSchema,
@@ -72,19 +72,15 @@ const SyncCreativesItemSchema = import_zod.z.object({
       message: "status is required when localization is present"
     });
   }
-});
-const SyncCreativesSuccessStrictSchema = import_zod.z.object({
+}))();
+const SyncCreativesSuccessStrictSchema = /* @__PURE__ */ (() => import_zod.z.object({
   dry_run: import_zod.z.boolean().optional(),
   creatives: import_zod.z.array(SyncCreativesItemSchema),
   sandbox: import_zod.z.boolean().optional(),
   context: import_schemas.ContextObjectSchema.optional(),
   ext: import_schemas.ExtensionObjectSchema.optional()
-}).passthrough();
-const SyncCreativesResponseStrictSchema = import_zod.z.union([
-  SyncCreativesSuccessStrictSchema,
-  import_schemas.SyncCreativesErrorSchema,
-  import_schemas.SyncCreativesSubmittedSchema
-]);
+}).passthrough())();
+const SyncCreativesResponseStrictSchema = /* @__PURE__ */ (() => import_zod.z.union([SyncCreativesSuccessStrictSchema, import_schemas.SyncCreativesErrorSchema, import_schemas.SyncCreativesSubmittedSchema]))();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SyncCreativesActionSchema,

package/dist/lib/validation/sync-creatives.mjs

@@ -11,18 +11,18 @@ import {
   SyncCreativesErrorSchema,
   SyncCreativesSubmittedSchema
 } from "../types/schemas.generated.mjs";
-const SyncCreativesActionSchema = z.union([
+const SyncCreativesActionSchema = /* @__PURE__ */ (() => z.union([
   z.literal("created"),
   z.literal("updated"),
   z.literal("unchanged"),
   z.literal("failed"),
   z.literal("deleted")
-]);
+]))();
 const ASSIGNMENT_ERROR_KEY = /^[a-zA-Z0-9_-]+$/;
-const HttpUrlSchema = z.string().url().refine((v) => /^https?:\/\//i.test(v), {
+const HttpUrlSchema = /* @__PURE__ */ (() => z.string().url().refine((v) => /^https?:\/\//i.test(v), {
   message: "URL must use http(s) scheme"
-});
-const SyncCreativesItemSchema = z.object({
+}))();
+const SyncCreativesItemSchema = /* @__PURE__ */ (() => z.object({
   creative_id: z.string(),
   revision_id: CreativeRevisionIDSchema.optional(),
   action: SyncCreativesActionSchema,
@@ -57,19 +57,15 @@ const SyncCreativesItemSchema = z.object({
       message: "status is required when localization is present"
     });
   }
-});
-const SyncCreativesSuccessStrictSchema = z.object({
+}))();
+const SyncCreativesSuccessStrictSchema = /* @__PURE__ */ (() => z.object({
   dry_run: z.boolean().optional(),
   creatives: z.array(SyncCreativesItemSchema),
   sandbox: z.boolean().optional(),
   context: ContextObjectSchema.optional(),
   ext: ExtensionObjectSchema.optional()
-}).passthrough();
-const SyncCreativesResponseStrictSchema = z.union([
-  SyncCreativesSuccessStrictSchema,
-  SyncCreativesErrorSchema,
-  SyncCreativesSubmittedSchema
-]);
+}).passthrough())();
+const SyncCreativesResponseStrictSchema = /* @__PURE__ */ (() => z.union([SyncCreativesSuccessStrictSchema, SyncCreativesErrorSchema, SyncCreativesSubmittedSchema]))();
 export {
   SyncCreativesActionSchema,
   SyncCreativesItemSchema,

package/dist/lib/version.d.mts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "15.7.0";
+export declare const LIBRARY_VERSION = "15.8.0";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "15.7.0";
+    readonly library: "15.8.0";
     readonly adcp: "3.2.3";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.2.1", "3.2", "3.2.2", "3.2.3"];
-    readonly generatedAt: "2026-10-09T19:01:02.354Z";
+    readonly generatedAt: "2026-10-11T12:51:13.665Z";
 };
 /**
  * Get the AdCP specification version this library is built for