@adcp/sdk 15.9.0 → 16.0.0-beta.1

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

@@ -53,6 +53,7 @@ export interface MediaBuyFeatures {
  * Account management capabilities declared by the seller
  */
 export interface AccountCapabilities {
+    agentOnboarding?: import('../identity-3.3/types').AgentOnboarding;
     /** Seller-issued IDs are stable and accepted wherever an account reference is used. */
     stableAccountId?: boolean;
     /** Optional account change feed; absence does not imply support. */

package/dist/lib/utils/capabilities.js

@@ -316,6 +316,11 @@ function parseCapabilitiesResponse(response) {
       authorizationEndpoint: response.account.authorization_endpoint,
       supportedBilling: response.account.supported_billing ?? [],
       defaultBilling: response.account.default_billing,
+      ...response.account.agent_onboarding && {
+        agentOnboarding: structuredClone(
+          response.account.agent_onboarding
+        )
+      },
       supportedAccountCurrencyModes: response.account.supported_account_currency_modes,
       ...response.account.timezone && {
         timezone: {

package/dist/lib/utils/capabilities.mjs

@@ -260,6 +260,11 @@ function parseCapabilitiesResponse(response) {
       authorizationEndpoint: response.account.authorization_endpoint,
       supportedBilling: response.account.supported_billing ?? [],
       defaultBilling: response.account.default_billing,
+      ...response.account.agent_onboarding && {
+        agentOnboarding: structuredClone(
+          response.account.agent_onboarding
+        )
+      },
       supportedAccountCurrencyModes: response.account.supported_account_currency_modes,
       ...response.account.timezone && {
         timezone: {

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

@@ -94,7 +94,9 @@ type ClientReportingWebhookInput = (ReportingWebhookPreferences & {
  * request remains a strict {@link CanonicalCreateMediaBuyRequest}.
  */
 export type CanonicalCreateMediaBuyInput = Omit<CanonicalCreateMediaBuyRequest, 'reporting_webhook'> & {
-    reporting_webhook?: ClientReportingWebhookInput;
+    reporting_webhook?: ClientReportingWebhookInput & {
+        signing_profile?: 'adcp/webhook-signing/v1' | 'web-bot-auth';
+    };
 };
 export type CanonicalUpdateMediaBuyRequest = Omit<CanonicalCreativeResponse<UpdateMediaBuyRequest>, 'packages' | 'new_packages'> & {
     packages?: CanonicalPackageUpdate[];

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

@@ -94,7 +94,9 @@ type ClientReportingWebhookInput = (ReportingWebhookPreferences & {
  * request remains a strict {@link CanonicalCreateMediaBuyRequest}.
  */
 export type CanonicalCreateMediaBuyInput = Omit<CanonicalCreateMediaBuyRequest, 'reporting_webhook'> & {
-    reporting_webhook?: ClientReportingWebhookInput;
+    reporting_webhook?: ClientReportingWebhookInput & {
+        signing_profile?: 'adcp/webhook-signing/v1' | 'web-bot-auth';
+    };
 };
 export type CanonicalUpdateMediaBuyRequest = Omit<CanonicalCreativeResponse<UpdateMediaBuyRequest>, 'packages' | 'new_packages'> & {
     packages?: CanonicalPackageUpdate[];

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

@@ -487,20 +487,32 @@ function creativeFormatParameterConstraints(creative) {
   if (width === void 0 && height === void 0 && durationMs === void 0) return void 0;
   return { width, height, durationMs };
 }
+function legacyRefParameterConstraints(ref) {
+  const params = typeof ref.width !== "number" || typeof ref.height !== "number" ? record((0, import_v1_to_v2.canonicalDeclarationFromBareId)(ref.id, { agentUrl: ref.agent_url })?.params) : void 0;
+  return {
+    width: typeof ref.width === "number" ? ref.width : typeof params?.width === "number" ? params.width : void 0,
+    height: typeof ref.height === "number" ? ref.height : typeof params?.height === "number" ? params.height : void 0,
+    durationMs: ref.duration_ms
+  };
+}
 function refContradictsConstraints(ref, constraints) {
-  if (constraints.width !== void 0 && typeof ref.width === "number" && ref.width !== constraints.width) return true;
-  if (constraints.height !== void 0 && typeof ref.height === "number" && ref.height !== constraints.height) {
+  const refConstraints = legacyRefParameterConstraints(ref);
+  if (constraints.width !== void 0 && refConstraints.width !== void 0 && refConstraints.width !== constraints.width) {
+    return true;
+  }
+  if (constraints.height !== void 0 && refConstraints.height !== void 0 && refConstraints.height !== constraints.height) {
     return true;
   }
-  if (constraints.durationMs !== void 0 && typeof ref.duration_ms === "number" && ref.duration_ms !== constraints.durationMs) {
+  if (constraints.durationMs !== void 0 && typeof refConstraints.durationMs === "number" && refConstraints.durationMs !== constraints.durationMs) {
     return true;
   }
   return false;
 }
 function refPinsConstraints(ref, constraints) {
-  if (constraints.width !== void 0 && typeof ref.width !== "number") return false;
-  if (constraints.height !== void 0 && typeof ref.height !== "number") return false;
-  if (constraints.durationMs !== void 0 && typeof ref.duration_ms !== "number") return false;
+  const refConstraints = legacyRefParameterConstraints(ref);
+  if (constraints.width !== void 0 && refConstraints.width === void 0) return false;
+  if (constraints.height !== void 0 && refConstraints.height === void 0) return false;
+  if (constraints.durationMs !== void 0 && typeof refConstraints.durationMs !== "number") return false;
   return true;
 }
 function legacyIdPinsDimensions(ref) {
@@ -510,15 +522,19 @@ function legacyIdPinsDimensions(ref) {
   return typeof params.width === "number" || typeof params.height === "number" || typeof params.duration_ms_exact === "number" || Array.isArray(params.sizes);
 }
 function refConstraintKey(ref) {
-  return [agentIdentity(ref.agent_url), ref.width ?? "", ref.height ?? "", ref.duration_ms ?? ""].join("|");
+  const constraints = legacyRefParameterConstraints(ref);
+  return [
+    agentIdentity(ref.agent_url),
+    constraints.width ?? "",
+    constraints.height ?? "",
+    constraints.durationMs ?? ""
+  ].join("|");
 }
 function preferMostConstrainedLegacyCandidates(candidates, creative) {
-  if (candidates.length <= 1) return candidates;
   let remaining = candidates;
   const constraints = creativeFormatParameterConstraints(creative);
   if (constraints) {
-    const compatible = remaining.filter((candidate) => !refContradictsConstraints(candidate.ref, constraints));
-    if (compatible.length > 0) remaining = compatible;
+    remaining = remaining.filter((candidate) => !refContradictsConstraints(candidate.ref, constraints));
     const pinned = remaining.filter((candidate) => refPinsConstraints(candidate.ref, constraints));
     if (pinned.length > 0) remaining = pinned;
   }

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

@@ -466,20 +466,32 @@ function creativeFormatParameterConstraints(creative) {
   if (width === void 0 && height === void 0 && durationMs === void 0) return void 0;
   return { width, height, durationMs };
 }
+function legacyRefParameterConstraints(ref) {
+  const params = typeof ref.width !== "number" || typeof ref.height !== "number" ? record(canonicalDeclarationFromBareId(ref.id, { agentUrl: ref.agent_url })?.params) : void 0;
+  return {
+    width: typeof ref.width === "number" ? ref.width : typeof params?.width === "number" ? params.width : void 0,
+    height: typeof ref.height === "number" ? ref.height : typeof params?.height === "number" ? params.height : void 0,
+    durationMs: ref.duration_ms
+  };
+}
 function refContradictsConstraints(ref, constraints) {
-  if (constraints.width !== void 0 && typeof ref.width === "number" && ref.width !== constraints.width) return true;
-  if (constraints.height !== void 0 && typeof ref.height === "number" && ref.height !== constraints.height) {
+  const refConstraints = legacyRefParameterConstraints(ref);
+  if (constraints.width !== void 0 && refConstraints.width !== void 0 && refConstraints.width !== constraints.width) {
+    return true;
+  }
+  if (constraints.height !== void 0 && refConstraints.height !== void 0 && refConstraints.height !== constraints.height) {
     return true;
   }
-  if (constraints.durationMs !== void 0 && typeof ref.duration_ms === "number" && ref.duration_ms !== constraints.durationMs) {
+  if (constraints.durationMs !== void 0 && typeof refConstraints.durationMs === "number" && refConstraints.durationMs !== constraints.durationMs) {
     return true;
   }
   return false;
 }
 function refPinsConstraints(ref, constraints) {
-  if (constraints.width !== void 0 && typeof ref.width !== "number") return false;
-  if (constraints.height !== void 0 && typeof ref.height !== "number") return false;
-  if (constraints.durationMs !== void 0 && typeof ref.duration_ms !== "number") return false;
+  const refConstraints = legacyRefParameterConstraints(ref);
+  if (constraints.width !== void 0 && refConstraints.width === void 0) return false;
+  if (constraints.height !== void 0 && refConstraints.height === void 0) return false;
+  if (constraints.durationMs !== void 0 && typeof refConstraints.durationMs !== "number") return false;
   return true;
 }
 function legacyIdPinsDimensions(ref) {
@@ -489,15 +501,19 @@ function legacyIdPinsDimensions(ref) {
   return typeof params.width === "number" || typeof params.height === "number" || typeof params.duration_ms_exact === "number" || Array.isArray(params.sizes);
 }
 function refConstraintKey(ref) {
-  return [agentIdentity(ref.agent_url), ref.width ?? "", ref.height ?? "", ref.duration_ms ?? ""].join("|");
+  const constraints = legacyRefParameterConstraints(ref);
+  return [
+    agentIdentity(ref.agent_url),
+    constraints.width ?? "",
+    constraints.height ?? "",
+    constraints.durationMs ?? ""
+  ].join("|");
 }
 function preferMostConstrainedLegacyCandidates(candidates, creative) {
-  if (candidates.length <= 1) return candidates;
   let remaining = candidates;
   const constraints = creativeFormatParameterConstraints(creative);
   if (constraints) {
-    const compatible = remaining.filter((candidate) => !refContradictsConstraints(candidate.ref, constraints));
-    if (compatible.length > 0) remaining = compatible;
+    remaining = remaining.filter((candidate) => !refContradictsConstraints(candidate.ref, constraints));
     const pinned = remaining.filter((candidate) => refPinsConstraints(candidate.ref, constraints));
     if (pinned.length > 0) remaining = pinned;
   }

package/dist/lib/v2/projection/index.d.mts

@@ -43,7 +43,7 @@ export { projectV1ProductToV2, canonicalDeclarationFromBareId, resolveCanonicalF
 export type { V1ToV2Result, V1ToV2ProjectionOptions, BareFormatIdResolveOptions, LegacyFormatConversionContext, LegacyFormatConverter, LegacyFormatResolutionContext, LegacyFormatResolver, } from './v1-to-v2.mjs';
 export { projectV2ProductToV1 } from './v2-to-v1.mjs';
 export type { V2ToV1Result, V2ToV1ProjectionOptions, CanonicalFormatLegacyResolver, CanonicalFormatLegacyResolutionContext, CanonicalProductFormatLegacyResolutionContext, CanonicalCreativeFormatLegacyResolutionContext, CanonicalSelectorFormatLegacyResolutionContext, } from './v2-to-v1.mjs';
-export { canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, type CanonicalFormatLegacyRoute, } from './legacy-routes.mjs';
+export { canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, type CanonicalFormatLegacyRoute, type LegacyRoutesForProductOptions, } from './legacy-routes.mjs';
 export { augmentProductWithFormatOptions, withFormatOptions, toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, type V2AugmentedProduct, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, } from './augment-response.mjs';
 export { CanonicalFormat, audioDaastFormatDeclaration, audioHostedFormatDeclaration, audioVastFormatDeclaration, agentPlacementFormatDeclaration, canonicalFormatDeclaration, customFormatDeclaration, displayTagFormatDeclaration, legacyFormatRef, legacyFormatRefs, html5FormatDeclaration, imageCarouselFormatDeclaration, imageFormatDeclaration, nativeInFeedFormatDeclaration, productCard, productCardDetailed, responsiveCreativeFormatDeclaration, sellerRenderedStatefulDisplayFormatDeclaration, sponsoredPlacementFormatDeclaration, coordinatedPlacementsFormatDeclaration, videoHostedFormatDeclaration, videoVastFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type FormatReferenceInput, type ProductCardDetailedFields, type ProductCardFields, } from './builders.mjs';
 export { packageRefsForFormatOptions, packageRefsForCapabilities, legacyFormatIdsFromOptions, tryLegacyFormatIdsFromOptions, legacyFormatIdsForFormatOption, legacyFormatIdsForCapability, lintPackageFormatSelectorDimensions, FormatOptionRefsLookupError, CapabilityIdsLookupError, type PackageFormatRefs, type PackageCapabilityRefs, type FormatOptionRef, type FormatOptionSelector, type FormatOptionRefsLookupErrorCode, type CapabilityIdsLookupErrorCode, type PackageFormatSelectorInput, type PackageFormatSelectorDimensionOptions, type FixedSizeDimensions, type PackageFormatSelectorDimensionDiagnosticCode, type PackageFormatSelectorDimensionDiagnostic, } from './write-side.mjs';

package/dist/lib/v2/projection/index.d.ts

@@ -43,7 +43,7 @@ export { projectV1ProductToV2, canonicalDeclarationFromBareId, resolveCanonicalF
 export type { V1ToV2Result, V1ToV2ProjectionOptions, BareFormatIdResolveOptions, LegacyFormatConversionContext, LegacyFormatConverter, LegacyFormatResolutionContext, LegacyFormatResolver, } from './v1-to-v2';
 export { projectV2ProductToV1 } from './v2-to-v1';
 export type { V2ToV1Result, V2ToV1ProjectionOptions, CanonicalFormatLegacyResolver, CanonicalFormatLegacyResolutionContext, CanonicalProductFormatLegacyResolutionContext, CanonicalCreativeFormatLegacyResolutionContext, CanonicalSelectorFormatLegacyResolutionContext, } from './v2-to-v1';
-export { canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, type CanonicalFormatLegacyRoute, } from './legacy-routes';
+export { canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, type CanonicalFormatLegacyRoute, type LegacyRoutesForProductOptions, } from './legacy-routes';
 export { augmentProductWithFormatOptions, withFormatOptions, toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, type V2AugmentedProduct, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, } from './augment-response';
 export { CanonicalFormat, audioDaastFormatDeclaration, audioHostedFormatDeclaration, audioVastFormatDeclaration, agentPlacementFormatDeclaration, canonicalFormatDeclaration, customFormatDeclaration, displayTagFormatDeclaration, legacyFormatRef, legacyFormatRefs, html5FormatDeclaration, imageCarouselFormatDeclaration, imageFormatDeclaration, nativeInFeedFormatDeclaration, productCard, productCardDetailed, responsiveCreativeFormatDeclaration, sellerRenderedStatefulDisplayFormatDeclaration, sponsoredPlacementFormatDeclaration, coordinatedPlacementsFormatDeclaration, videoHostedFormatDeclaration, videoVastFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type FormatReferenceInput, type ProductCardDetailedFields, type ProductCardFields, } from './builders';
 export { packageRefsForFormatOptions, packageRefsForCapabilities, legacyFormatIdsFromOptions, tryLegacyFormatIdsFromOptions, legacyFormatIdsForFormatOption, legacyFormatIdsForCapability, lintPackageFormatSelectorDimensions, FormatOptionRefsLookupError, CapabilityIdsLookupError, type PackageFormatRefs, type PackageCapabilityRefs, type FormatOptionRef, type FormatOptionSelector, type FormatOptionRefsLookupErrorCode, type CapabilityIdsLookupErrorCode, type PackageFormatSelectorInput, type PackageFormatSelectorDimensionOptions, type FixedSizeDimensions, type PackageFormatSelectorDimensionDiagnosticCode, type PackageFormatSelectorDimensionDiagnostic, } from './write-side';

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

@@ -51,8 +51,30 @@ export type FormatOptionOrigin = {
     seller_declared: false;
     selector: UndeclaredFormatOptionSelector;
 };
-/** Extract persistable routes from canonical declarations, including concealed migration metadata. */
-export declare function legacyRoutesForProduct(productId: string, declarations: readonly V2ProductFormatDeclaration[]): CanonicalFormatLegacyRoute[];
+/** Whether two option refs name the same format option. Publisher domains compare case-insensitively. */
+export declare function sameFormatOptionRef(left: FormatOptionReference, right: FormatOptionReference): boolean;
+/**
+ * Option refs a product declares in its own `format_options[]`, read from the
+ * product exactly as the seller returned it. Options the SDK derives from the
+ * seller's legacy `format_ids` never appear here.
+ */
+export declare function sellerDeclaredFormatOptionRefs(sellerProduct: unknown): FormatOptionReference[];
+export interface LegacyRoutesForProductOptions {
+    /**
+     * The product exactly as the seller returned it from `get_products`. When
+     * given, an option is seller-declared exactly when this product's own
+     * `format_options[]` names it. Use it when the declarations were projected
+     * from a stored seller response in a process that never ran discovery, so
+     * the SDK holds no origin metadata for them.
+     */
+    sellerProduct?: unknown;
+}
+/**
+ * Extract persistable routes from canonical declarations, including concealed
+ * migration metadata. Pass `sellerProduct` to record each option's origin from
+ * the seller's own response instead of that metadata.
+ */
+export declare function legacyRoutesForProduct(productId: string, declarations: readonly V2ProductFormatDeclaration[], options?: LegacyRoutesForProductOptions): CanonicalFormatLegacyRoute[];
 /**
  * The origin a resolver built by {@link canonicalFormatLegacyResolverFromRoutes}
  * recorded for one option. Without a product id, every route for the option

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

@@ -51,8 +51,30 @@ export type FormatOptionOrigin = {
     seller_declared: false;
     selector: UndeclaredFormatOptionSelector;
 };
-/** Extract persistable routes from canonical declarations, including concealed migration metadata. */
-export declare function legacyRoutesForProduct(productId: string, declarations: readonly V2ProductFormatDeclaration[]): CanonicalFormatLegacyRoute[];
+/** Whether two option refs name the same format option. Publisher domains compare case-insensitively. */
+export declare function sameFormatOptionRef(left: FormatOptionReference, right: FormatOptionReference): boolean;
+/**
+ * Option refs a product declares in its own `format_options[]`, read from the
+ * product exactly as the seller returned it. Options the SDK derives from the
+ * seller's legacy `format_ids` never appear here.
+ */
+export declare function sellerDeclaredFormatOptionRefs(sellerProduct: unknown): FormatOptionReference[];
+export interface LegacyRoutesForProductOptions {
+    /**
+     * The product exactly as the seller returned it from `get_products`. When
+     * given, an option is seller-declared exactly when this product's own
+     * `format_options[]` names it. Use it when the declarations were projected
+     * from a stored seller response in a process that never ran discovery, so
+     * the SDK holds no origin metadata for them.
+     */
+    sellerProduct?: unknown;
+}
+/**
+ * Extract persistable routes from canonical declarations, including concealed
+ * migration metadata. Pass `sellerProduct` to record each option's origin from
+ * the seller's own response instead of that metadata.
+ */
+export declare function legacyRoutesForProduct(productId: string, declarations: readonly V2ProductFormatDeclaration[], options?: LegacyRoutesForProductOptions): CanonicalFormatLegacyRoute[];
 /**
  * The origin a resolver built by {@link canonicalFormatLegacyResolverFromRoutes}
  * recorded for one option. Without a product id, every route for the option

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

@@ -21,6 +21,8 @@ __export(legacy_routes_exports, {
   canonicalFormatLegacyResolverFromRoutes: () => canonicalFormatLegacyResolverFromRoutes,
   formatOptionOriginFromRoutes: () => formatOptionOriginFromRoutes,
   legacyRoutesForProduct: () => legacyRoutesForProduct,
+  sameFormatOptionRef: () => sameFormatOptionRef,
+  sellerDeclaredFormatOptionRefs: () => sellerDeclaredFormatOptionRefs,
   undeclaredFormatOptionSelector: () => undeclaredFormatOptionSelector
 });
 module.exports = __toCommonJS(legacy_routes_exports);
@@ -62,6 +64,27 @@ function routeRef(value) {
   if (record.scope !== void 0 && record.scope !== "product") return void 0;
   return { scope: "product", format_option_id: record.format_option_id };
 }
+function sameFormatOptionRef(left, right) {
+  return left.scope === right.scope && left.format_option_id === right.format_option_id && (left.scope !== "publisher" || right.scope === "publisher" && left.publisher_domain.toLowerCase() === right.publisher_domain.toLowerCase());
+}
+function sellerDeclaredFormatOptionRefs(sellerProduct) {
+  if (!sellerProduct || typeof sellerProduct !== "object" || Array.isArray(sellerProduct)) return [];
+  const options = sellerProduct.format_options;
+  const refs = [];
+  for (const optionValue of Array.isArray(options) ? options : []) {
+    if (!optionValue || typeof optionValue !== "object" || Array.isArray(optionValue)) continue;
+    const option = optionValue;
+    if (typeof option.format_option_id !== "string") continue;
+    refs.push(
+      typeof option.publisher_domain === "string" ? {
+        scope: "publisher",
+        publisher_domain: option.publisher_domain,
+        format_option_id: option.format_option_id
+      } : { scope: "product", format_option_id: option.format_option_id }
+    );
+  }
+  return refs;
+}
 function routeKey(productId, ref) {
   return JSON.stringify([
     productId,
@@ -89,12 +112,13 @@ function uniqueFormatIds(refs) {
     ).values()
   ];
 }
-function legacyRoutesForProduct(productId, declarations) {
+function legacyRoutesForProduct(productId, declarations, options = {}) {
+  const declaredRefs = options.sellerProduct === void 0 ? void 0 : sellerDeclaredFormatOptionRefs(options.sellerProduct);
   return declarations.flatMap((declaration) => {
     const formatOptionRef = routeRef(declaration);
     const formatIds = uniqueFormatIds((0, import_legacy_metadata.legacyFormatRefsForDeclaration)(declaration));
     if (!formatOptionRef || formatIds.length === 0) return [];
-    const declared = (0, import_legacy_metadata.sellerDeclaredFormatOption)(declaration);
+    const declared = declaredRefs ? declaredRefs.some((ref) => sameFormatOptionRef(ref, formatOptionRef)) : (0, import_legacy_metadata.sellerDeclaredFormatOption)(declaration);
     const selector = declared === false ? undeclaredFormatOptionSelector(declaration) : void 0;
     return [
       {
@@ -215,5 +239,7 @@ function canonicalFormatLegacyResolverFromRoutes(routes) {
   canonicalFormatLegacyResolverFromRoutes,
   formatOptionOriginFromRoutes,
   legacyRoutesForProduct,
+  sameFormatOptionRef,
+  sellerDeclaredFormatOptionRefs,
   undeclaredFormatOptionSelector
 });

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

@@ -36,6 +36,27 @@ function routeRef(value) {
   if (record.scope !== void 0 && record.scope !== "product") return void 0;
   return { scope: "product", format_option_id: record.format_option_id };
 }
+function sameFormatOptionRef(left, right) {
+  return left.scope === right.scope && left.format_option_id === right.format_option_id && (left.scope !== "publisher" || right.scope === "publisher" && left.publisher_domain.toLowerCase() === right.publisher_domain.toLowerCase());
+}
+function sellerDeclaredFormatOptionRefs(sellerProduct) {
+  if (!sellerProduct || typeof sellerProduct !== "object" || Array.isArray(sellerProduct)) return [];
+  const options = sellerProduct.format_options;
+  const refs = [];
+  for (const optionValue of Array.isArray(options) ? options : []) {
+    if (!optionValue || typeof optionValue !== "object" || Array.isArray(optionValue)) continue;
+    const option = optionValue;
+    if (typeof option.format_option_id !== "string") continue;
+    refs.push(
+      typeof option.publisher_domain === "string" ? {
+        scope: "publisher",
+        publisher_domain: option.publisher_domain,
+        format_option_id: option.format_option_id
+      } : { scope: "product", format_option_id: option.format_option_id }
+    );
+  }
+  return refs;
+}
 function routeKey(productId, ref) {
   return JSON.stringify([
     productId,
@@ -63,12 +84,13 @@ function uniqueFormatIds(refs) {
     ).values()
   ];
 }
-function legacyRoutesForProduct(productId, declarations) {
+function legacyRoutesForProduct(productId, declarations, options = {}) {
+  const declaredRefs = options.sellerProduct === void 0 ? void 0 : sellerDeclaredFormatOptionRefs(options.sellerProduct);
   return declarations.flatMap((declaration) => {
     const formatOptionRef = routeRef(declaration);
     const formatIds = uniqueFormatIds(legacyFormatRefsForDeclaration(declaration));
     if (!formatOptionRef || formatIds.length === 0) return [];
-    const declared = sellerDeclaredFormatOption(declaration);
+    const declared = declaredRefs ? declaredRefs.some((ref) => sameFormatOptionRef(ref, formatOptionRef)) : sellerDeclaredFormatOption(declaration);
     const selector = declared === false ? undeclaredFormatOptionSelector(declaration) : void 0;
     return [
       {
@@ -188,5 +210,7 @@ export {
   canonicalFormatLegacyResolverFromRoutes,
   formatOptionOriginFromRoutes,
   legacyRoutesForProduct,
+  sameFormatOptionRef,
+  sellerDeclaredFormatOptionRefs,
   undeclaredFormatOptionSelector
 };

package/dist/lib/validation/schema-loader.d.mts

@@ -68,6 +68,8 @@ export declare function resolveBundleKey(version: string): string;
  */
 export declare function validateAdcpVersionWire(value: unknown): asserts value is string;
 export declare function toReleasePrecisionWire(bundleKeyOrVersion: string): string;
+export declare function withIdentity33SchemaScope<T>(fn: () => T, enabled?: boolean): T;
+export declare function bindIdentity33SchemaScope<T extends object>(instance: T): T;
 /**
  * Register a schema bundle supplied outside the installed SDK package.
  *

package/dist/lib/validation/schema-loader.d.ts

@@ -68,6 +68,8 @@ export declare function resolveBundleKey(version: string): string;
  */
 export declare function validateAdcpVersionWire(value: unknown): asserts value is string;
 export declare function toReleasePrecisionWire(bundleKeyOrVersion: string): string;
+export declare function withIdentity33SchemaScope<T>(fn: () => T, enabled?: boolean): T;
+export declare function bindIdentity33SchemaScope<T extends object>(instance: T): T;
 /**
  * Register a schema bundle supplied outside the installed SDK package.
  *

package/dist/lib/validation/schema-loader.js

@@ -30,6 +30,7 @@ var schema_loader_exports = {};
 __export(schema_loader_exports, {
   SCHEMA_FILENAME_SUFFIX: () => SCHEMA_FILENAME_SUFFIX,
   _resetValidationLoader: () => _resetValidationLoader,
+  bindIdentity33SchemaScope: () => bindIdentity33SchemaScope,
   getCanonicalToolValidatorForVersion: () => getCanonicalToolValidatorForVersion,
   getMcpProfileInputSchema: () => getMcpProfileInputSchema,
   getMcpToolSchema: () => getMcpToolSchema,
@@ -43,6 +44,7 @@ __export(schema_loader_exports, {
   getValidator: () => getValidator,
   hasSchemaBundle: () => hasSchemaBundle,
   isExternalSchemaRootActive: () => isExternalSchemaRootActive,
+  isIdentity33SchemaScope: () => isIdentity33SchemaScope,
   listValidatorKeys: () => listValidatorKeys,
   registerExternalSchemaRoot: () => registerExternalSchemaRoot,
   resolveBundleKey: () => resolveBundleKey,
@@ -50,7 +52,8 @@ __export(schema_loader_exports, {
   toReleasePrecisionWire: () => toReleasePrecisionWire,
   unregisterExternalSchemaRoot: () => unregisterExternalSchemaRoot,
   validateAdcpVersionWire: () => validateAdcpVersionWire,
-  withExternalSchemaRoot: () => withExternalSchemaRoot
+  withExternalSchemaRoot: () => withExternalSchemaRoot,
+  withIdentity33SchemaScope: () => withIdentity33SchemaScope
 });
 module.exports = __toCommonJS(schema_loader_exports);
 var import_ajv = __toESM(require("ajv"));
@@ -123,12 +126,30 @@ function toReleasePrecisionWire(bundleKeyOrVersion) {
     "adcpVersion"
   );
 }
+const identity33Scope = new import_async_hooks.AsyncLocalStorage();
+function isIdentity33SchemaScope() {
+  return identity33Scope.getStore() === true;
+}
+function withIdentity33SchemaScope(fn, enabled = true) {
+  return identity33Scope.run(enabled, fn);
+}
+function bindIdentity33SchemaScope(instance) {
+  return new Proxy(instance, {
+    get(target, property, receiver) {
+      const value = withIdentity33SchemaScope(() => Reflect.get(target, property, receiver));
+      const descriptor = Reflect.getOwnPropertyDescriptor(target, property);
+      if (descriptor && !descriptor.configurable && "value" in descriptor && !descriptor.writable) return value;
+      return typeof value === "function" ? (...args) => withIdentity33SchemaScope(() => value.apply(target, args)) : value;
+    }
+  });
+}
 function resolveSchemaRoot(version) {
   const key = resolveBundleKey(version);
   const scopedRoot = scopedExternalSchemaRoots.getStore()?.get(key);
   if (scopedRoot && (0, import_fs.existsSync)(scopedRoot)) return scopedRoot;
   const externalRoot = externalSchemaRoots.get(key);
   if (externalRoot && (0, import_fs.existsSync)(externalRoot)) return externalRoot;
+  if (isIdentity33SchemaScope() && key === "3.3") return resolveSchemaRoot(import_version.ADCP_VERSION);
   const distCandidate = import_path.default.join(__dirname, "..", "schemas-data", key);
   if ((0, import_fs.existsSync)(distCandidate)) return distCandidate;
   const releasePrecisionMatch = /^\d+\.\d+-/.test(key);
@@ -334,6 +355,7 @@ function withExternalSchemaRoot(version, root, fn) {
 }
 function isExternalSchemaRootActive(version) {
   const key = resolveBundleKey(version);
+  if (isIdentity33SchemaScope() && key === "3.3") return true;
   const scopedRoot = scopedExternalSchemaRoots.getStore()?.get(key);
   if (scopedRoot && (0, import_fs.existsSync)(scopedRoot)) return true;
   const registeredRoot = externalSchemaRoots.get(key);
@@ -601,7 +623,7 @@ function getSchemaValidatorByRef(schemaRef, version = import_version.ADCP_VERSIO
   });
   (0, import_ajv_formats.default)(ajv);
   for (const keyword of keywords ?? []) ajv.addKeyword(keyword);
-  const rawSchema = loadJson(file);
+  const rawSchema = identity33ReferenceSchema(loadJson(file), version);
   const dependencySchemas = [];
   const registeredIds = /* @__PURE__ */ new Map();
   for (const schemaFile of walkJsonFiles(root)) {
@@ -610,7 +632,7 @@ function getSchemaValidatorByRef(schemaRef, version = import_version.ADCP_VERSIO
       continue;
     }
     if (schemaFile === file) continue;
-    const schema = loadJson(schemaFile);
+    const schema = identity33ReferenceSchema(loadJson(schemaFile), version);
     if ((keywords || allErrors) && typeof schema.$id === "string") {
       const previous = schema.$id === rawSchema.$id ? rawSchema : registeredIds.get(schema.$id);
       if (previous && !(0, import_node_util.isDeepStrictEqual)(previous, schema)) {
@@ -710,6 +732,20 @@ function getRegisteredSchemaIds(version = import_version.ADCP_VERSION) {
   const bundledRegistry = s.bundledAjv.schemas;
   return [.../* @__PURE__ */ new Set([...Object.keys(registry ?? {}), ...Object.keys(bundledRegistry ?? {})])];
 }
+function identity33ReferenceSchema(schema, version) {
+  if (!isIdentity33SchemaScope() || resolveBundleKey(version) !== "3.3") return schema;
+  const clone = structuredClone(schema);
+  const pending = [clone];
+  while (pending.length) {
+    const node = pending.pop();
+    if (!node || typeof node !== "object") continue;
+    const object = node;
+    if (Array.isArray(object.enum) && object.enum.includes("destination_state_changed"))
+      object.enum = [...object.enum, "relationship_changed", "relationship_expiring"];
+    for (const value of Object.values(object)) if (typeof value === "object") pending.push(value);
+  }
+  return clone;
+}
 function hasSchemaBundle(version) {
   try {
     resolveSchemaRoot(version);
@@ -965,6 +1001,7 @@ function cloneJsonValue(value) {
 0 && (module.exports = {
   SCHEMA_FILENAME_SUFFIX,
   _resetValidationLoader,
+  bindIdentity33SchemaScope,
   getCanonicalToolValidatorForVersion,
   getMcpProfileInputSchema,
   getMcpToolSchema,
@@ -978,6 +1015,7 @@ function cloneJsonValue(value) {
   getValidator,
   hasSchemaBundle,
   isExternalSchemaRootActive,
+  isIdentity33SchemaScope,
   listValidatorKeys,
   registerExternalSchemaRoot,
   resolveBundleKey,
@@ -985,5 +1023,6 @@ function cloneJsonValue(value) {
   toReleasePrecisionWire,
   unregisterExternalSchemaRoot,
   validateAdcpVersionWire,
-  withExternalSchemaRoot
+  withExternalSchemaRoot,
+  withIdentity33SchemaScope
 });

package/dist/lib/validation/schema-loader.mjs

@@ -73,12 +73,30 @@ function toReleasePrecisionWire(bundleKeyOrVersion) {
     "adcpVersion"
   );
 }
+const identity33Scope = new AsyncLocalStorage();
+function isIdentity33SchemaScope() {
+  return identity33Scope.getStore() === true;
+}
+function withIdentity33SchemaScope(fn, enabled = true) {
+  return identity33Scope.run(enabled, fn);
+}
+function bindIdentity33SchemaScope(instance) {
+  return new Proxy(instance, {
+    get(target, property, receiver) {
+      const value = withIdentity33SchemaScope(() => Reflect.get(target, property, receiver));
+      const descriptor = Reflect.getOwnPropertyDescriptor(target, property);
+      if (descriptor && !descriptor.configurable && "value" in descriptor && !descriptor.writable) return value;
+      return typeof value === "function" ? (...args) => withIdentity33SchemaScope(() => value.apply(target, args)) : value;
+    }
+  });
+}
 function resolveSchemaRoot(version) {
   const key = resolveBundleKey(version);
   const scopedRoot = scopedExternalSchemaRoots.getStore()?.get(key);
   if (scopedRoot && existsSync(scopedRoot)) return scopedRoot;
   const externalRoot = externalSchemaRoots.get(key);
   if (externalRoot && existsSync(externalRoot)) return externalRoot;
+  if (isIdentity33SchemaScope() && key === "3.3") return resolveSchemaRoot(ADCP_VERSION);
   const distCandidate = path.join(__dirname, "..", "schemas-data", key);
   if (existsSync(distCandidate)) return distCandidate;
   const releasePrecisionMatch = /^\d+\.\d+-/.test(key);
@@ -284,6 +302,7 @@ function withExternalSchemaRoot(version, root, fn) {
 }
 function isExternalSchemaRootActive(version) {
   const key = resolveBundleKey(version);
+  if (isIdentity33SchemaScope() && key === "3.3") return true;
   const scopedRoot = scopedExternalSchemaRoots.getStore()?.get(key);
   if (scopedRoot && existsSync(scopedRoot)) return true;
   const registeredRoot = externalSchemaRoots.get(key);
@@ -551,7 +570,7 @@ function getSchemaValidatorByRef(schemaRef, version = ADCP_VERSION, keywords, op
   });
   addFormats(ajv);
   for (const keyword of keywords ?? []) ajv.addKeyword(keyword);
-  const rawSchema = loadJson(file);
+  const rawSchema = identity33ReferenceSchema(loadJson(file), version);
   const dependencySchemas = [];
   const registeredIds = /* @__PURE__ */ new Map();
   for (const schemaFile of walkJsonFiles(root)) {
@@ -560,7 +579,7 @@ function getSchemaValidatorByRef(schemaRef, version = ADCP_VERSION, keywords, op
       continue;
     }
     if (schemaFile === file) continue;
-    const schema = loadJson(schemaFile);
+    const schema = identity33ReferenceSchema(loadJson(schemaFile), version);
     if ((keywords || allErrors) && typeof schema.$id === "string") {
       const previous = schema.$id === rawSchema.$id ? rawSchema : registeredIds.get(schema.$id);
       if (previous && !isDeepStrictEqual(previous, schema)) {
@@ -660,6 +679,20 @@ function getRegisteredSchemaIds(version = ADCP_VERSION) {
   const bundledRegistry = s.bundledAjv.schemas;
   return [.../* @__PURE__ */ new Set([...Object.keys(registry ?? {}), ...Object.keys(bundledRegistry ?? {})])];
 }
+function identity33ReferenceSchema(schema, version) {
+  if (!isIdentity33SchemaScope() || resolveBundleKey(version) !== "3.3") return schema;
+  const clone = structuredClone(schema);
+  const pending = [clone];
+  while (pending.length) {
+    const node = pending.pop();
+    if (!node || typeof node !== "object") continue;
+    const object = node;
+    if (Array.isArray(object.enum) && object.enum.includes("destination_state_changed"))
+      object.enum = [...object.enum, "relationship_changed", "relationship_expiring"];
+    for (const value of Object.values(object)) if (typeof value === "object") pending.push(value);
+  }
+  return clone;
+}
 function hasSchemaBundle(version) {
   try {
     resolveSchemaRoot(version);
@@ -914,6 +947,7 @@ function cloneJsonValue(value) {
 export {
   SCHEMA_FILENAME_SUFFIX,
   _resetValidationLoader,
+  bindIdentity33SchemaScope,
   getCanonicalToolValidatorForVersion,
   getMcpProfileInputSchema,
   getMcpToolSchema,
@@ -927,6 +961,7 @@ export {
   getValidator,
   hasSchemaBundle,
   isExternalSchemaRootActive,
+  isIdentity33SchemaScope,
   listValidatorKeys,
   registerExternalSchemaRoot,
   resolveBundleKey,
@@ -934,5 +969,6 @@ export {
   toReleasePrecisionWire,
   unregisterExternalSchemaRoot,
   validateAdcpVersionWire,
-  withExternalSchemaRoot
+  withExternalSchemaRoot,
+  withIdentity33SchemaScope
 };