@adcp/sdk 15.9.1 → 16.0.0-beta.2

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/catalog-snapshot.js

@@ -25,6 +25,7 @@ __export(catalog_snapshot_exports, {
 module.exports = __toCommonJS(catalog_snapshot_exports);
 var import_resolve_agent_properties = require('../../discovery/resolve-agent-properties.js');
 var import_canonical_properties = require('./canonical-properties.js');
+var import_legacy_routes = require('./legacy-routes.js');
 const compiledSnapshotCache = /* @__PURE__ */ new WeakMap();
 function normalizedAgentUrl(value) {
   return (0, import_resolve_agent_properties.canonicalizeAgentUrl)(value) ?? value;
@@ -202,7 +203,7 @@ function legacyFormatConverterFromCatalogSnapshots(snapshots, fallback) {
 function canonicalFormatLegacyResolverFromCatalogSnapshots(snapshots, fallback) {
   if (!snapshots || snapshots.length === 0) return fallback;
   const compiled = compileProjectionCatalogSnapshots(snapshots);
-  return (context) => {
+  const resolver = (context) => {
     const refs = resolutionContextFormatOptionRefs(context);
     if (refs.length === 0) return fallback?.(context);
     const resolved = [];
@@ -225,6 +226,7 @@ function canonicalFormatLegacyResolverFromCatalogSnapshots(snapshots, fallback)
     }
     return [...new Map(resolved.map((ref) => [legacyRefKey(ref), ref])).values()];
   };
+  return (0, import_legacy_routes.carryFormatOptionOrigins)(resolver, fallback);
 }
 function assertBidirectionalProjectionCatalogs(snapshots) {
   const routeByCanonicalOption = /* @__PURE__ */ new Map();

package/dist/lib/v2/projection/catalog-snapshot.mjs

@@ -1,5 +1,6 @@
 import { canonicalizeAgentUrl } from "../../discovery/resolve-agent-properties.mjs";
 import { isCanonicalV1Translatable } from "./canonical-properties.mjs";
+import { carryFormatOptionOrigins } from "./legacy-routes.mjs";
 const compiledSnapshotCache = /* @__PURE__ */ new WeakMap();
 function normalizedAgentUrl(value) {
   return canonicalizeAgentUrl(value) ?? value;
@@ -177,7 +178,7 @@ function legacyFormatConverterFromCatalogSnapshots(snapshots, fallback) {
 function canonicalFormatLegacyResolverFromCatalogSnapshots(snapshots, fallback) {
   if (!snapshots || snapshots.length === 0) return fallback;
   const compiled = compileProjectionCatalogSnapshots(snapshots);
-  return (context) => {
+  const resolver = (context) => {
     const refs = resolutionContextFormatOptionRefs(context);
     if (refs.length === 0) return fallback?.(context);
     const resolved = [];
@@ -200,6 +201,7 @@ function canonicalFormatLegacyResolverFromCatalogSnapshots(snapshots, fallback)
     }
     return [...new Map(resolved.map((ref) => [legacyRefKey(ref), ref])).values()];
   };
+  return carryFormatOptionOrigins(resolver, fallback);
 }
 function assertBidirectionalProjectionCatalogs(snapshots) {
   const routeByCanonicalOption = /* @__PURE__ */ new Map();

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

@@ -78,23 +78,47 @@ export type CanonicalCreateMediaBuyRequest = Omit<CanonicalCreativeResponse<Crea
     packages?: CanonicalPackageRequest[];
 };
 type CanonicalReportingWebhook = NonNullable<CanonicalCreateMediaBuyRequest['reporting_webhook']>;
-type ReportingWebhookPreferences = Omit<CanonicalReportingWebhook, 'url' | 'authentication' | 'reporting_frequency'> & {
-    reporting_frequency?: CanonicalReportingWebhook['reporting_frequency'];
+/**
+ * Client-facing form of a wire reporting webhook `W`. Every field is optional:
+ * the SDK can supply the callback `url`, `reporting_frequency` and the
+ * `authentication` block from client configuration.
+ *
+ * `authentication` is optional even with a caller-supplied `url`. AdCP 3.3
+ * makes it optional on the wire when the seller signs webhooks under its
+ * profile (`webhook_signing.supported`), and the experimental 3.3 client sends
+ * the registration without it once it has negotiated that. Below 3.3 the wire
+ * still requires it: with `webhookUrlTemplate` configured the client throws
+ * rather than send a caller URL without credentials (it never pairs its own
+ * `webhookSecret` with a caller-controlled host), and request validation
+ * reports the missing field otherwise.
+ *
+ * Derived from `W` rather than restating its fields, so it accepts every
+ * reporting webhook the pinned schemas generate, whether they declare
+ * `authentication` required (3.2) or optional (3.3).
+ *
+ * Exported for the type tests only; not re-exported from the package root.
+ */
+export type ClientReportingWebhookInputFor<W extends {
+    url: string;
+    reporting_frequency: unknown;
+}> = Omit<W, 'url' | 'authentication' | 'reporting_frequency'> & {
+    url?: W['url'];
+    reporting_frequency?: W['reporting_frequency'];
+    /** Atomic: `schemes` and `credentials` always come from the same source. */
+    authentication?: W extends {
+        authentication?: infer A;
+    } ? (unknown extends A ? never : A) : never;
 };
-type ClientReportingWebhookInput = (ReportingWebhookPreferences & {
-    url?: never;
-    authentication?: CanonicalReportingWebhook['authentication'];
-}) | (ReportingWebhookPreferences & {
-    url: CanonicalReportingWebhook['url'];
-    authentication: CanonicalReportingWebhook['authentication'];
-});
+type ClientReportingWebhookInput = ClientReportingWebhookInputFor<CanonicalReportingWebhook>;
 /**
  * Client-facing create request. The SDK may supply the reporting callback URL
  * and its complete authentication block from client configuration; the wire
  * 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

@@ -78,23 +78,47 @@ export type CanonicalCreateMediaBuyRequest = Omit<CanonicalCreativeResponse<Crea
     packages?: CanonicalPackageRequest[];
 };
 type CanonicalReportingWebhook = NonNullable<CanonicalCreateMediaBuyRequest['reporting_webhook']>;
-type ReportingWebhookPreferences = Omit<CanonicalReportingWebhook, 'url' | 'authentication' | 'reporting_frequency'> & {
-    reporting_frequency?: CanonicalReportingWebhook['reporting_frequency'];
+/**
+ * Client-facing form of a wire reporting webhook `W`. Every field is optional:
+ * the SDK can supply the callback `url`, `reporting_frequency` and the
+ * `authentication` block from client configuration.
+ *
+ * `authentication` is optional even with a caller-supplied `url`. AdCP 3.3
+ * makes it optional on the wire when the seller signs webhooks under its
+ * profile (`webhook_signing.supported`), and the experimental 3.3 client sends
+ * the registration without it once it has negotiated that. Below 3.3 the wire
+ * still requires it: with `webhookUrlTemplate` configured the client throws
+ * rather than send a caller URL without credentials (it never pairs its own
+ * `webhookSecret` with a caller-controlled host), and request validation
+ * reports the missing field otherwise.
+ *
+ * Derived from `W` rather than restating its fields, so it accepts every
+ * reporting webhook the pinned schemas generate, whether they declare
+ * `authentication` required (3.2) or optional (3.3).
+ *
+ * Exported for the type tests only; not re-exported from the package root.
+ */
+export type ClientReportingWebhookInputFor<W extends {
+    url: string;
+    reporting_frequency: unknown;
+}> = Omit<W, 'url' | 'authentication' | 'reporting_frequency'> & {
+    url?: W['url'];
+    reporting_frequency?: W['reporting_frequency'];
+    /** Atomic: `schemes` and `credentials` always come from the same source. */
+    authentication?: W extends {
+        authentication?: infer A;
+    } ? (unknown extends A ? never : A) : never;
 };
-type ClientReportingWebhookInput = (ReportingWebhookPreferences & {
-    url?: never;
-    authentication?: CanonicalReportingWebhook['authentication'];
-}) | (ReportingWebhookPreferences & {
-    url: CanonicalReportingWebhook['url'];
-    authentication: CanonicalReportingWebhook['authentication'];
-});
+type ClientReportingWebhookInput = ClientReportingWebhookInputFor<CanonicalReportingWebhook>;
 /**
  * Client-facing create request. The SDK may supply the reporting callback URL
  * and its complete authentication block from client configuration; the wire
  * 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, carryFormatOptionOrigins, 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, carryFormatOptionOrigins, 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/index.js

@@ -33,6 +33,7 @@ __export(projection_exports, {
   canonicalFormatDeclaration: () => import_builders.canonicalFormatDeclaration,
   canonicalFormatLegacyResolverFromCatalogSnapshots: () => import_catalog_snapshot.canonicalFormatLegacyResolverFromCatalogSnapshots,
   canonicalFormatLegacyResolverFromRoutes: () => import_legacy_routes.canonicalFormatLegacyResolverFromRoutes,
+  carryFormatOptionOrigins: () => import_legacy_routes.carryFormatOptionOrigins,
   coordinatedPlacementsFormatDeclaration: () => import_builders.coordinatedPlacementsFormatDeclaration,
   customFormatDeclaration: () => import_builders.customFormatDeclaration,
   displayTagFormatDeclaration: () => import_builders.displayTagFormatDeclaration,
@@ -111,6 +112,7 @@ var import_creative_delivery = require('./creative-delivery.js');
   canonicalFormatDeclaration,
   canonicalFormatLegacyResolverFromCatalogSnapshots,
   canonicalFormatLegacyResolverFromRoutes,
+  carryFormatOptionOrigins,
   coordinatedPlacementsFormatDeclaration,
   customFormatDeclaration,
   displayTagFormatDeclaration,

package/dist/lib/v2/projection/index.mjs

@@ -2,6 +2,7 @@ import { projectV1ProductToV2, canonicalDeclarationFromBareId, resolveCanonicalF
 import { projectV2ProductToV1 } from "./v2-to-v1.mjs";
 import {
   canonicalFormatLegacyResolverFromRoutes,
+  carryFormatOptionOrigins,
   legacyRoutesForProduct
 } from "./legacy-routes.mjs";
 import {
@@ -88,6 +89,7 @@ export {
   canonicalFormatDeclaration,
   canonicalFormatLegacyResolverFromCatalogSnapshots,
   canonicalFormatLegacyResolverFromRoutes,
+  carryFormatOptionOrigins,
   coordinatedPlacementsFormatDeclaration,
   customFormatDeclaration,
   displayTagFormatDeclaration,

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

@@ -51,12 +51,44 @@ 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
  * must agree that the seller did not declare it.
  */
 export declare function formatOptionOriginFromRoutes(resolver: CanonicalFormatLegacyResolver | undefined, ref: FormatOptionReference, productId: string | undefined): FormatOptionOrigin | undefined;
+/**
+ * Make `resolver` report the format-option origins recorded by `sources`.
+ *
+ * A resolver built by {@link canonicalFormatLegacyResolverFromRoutes} carries
+ * each route's `seller_declared` origin, which `AgentClient` reads to rewrite
+ * options the seller never declared on the canonical wire. A resolver that
+ * wraps or composes it is a new function and would otherwise carry none.
+ * Returns `resolver` itself, so the call can wrap a composition inline.
+ */
+export declare function carryFormatOptionOrigins(resolver: CanonicalFormatLegacyResolver, ...sources: ReadonlyArray<CanonicalFormatLegacyResolver | undefined>): CanonicalFormatLegacyResolver;
 export declare function canonicalFormatLegacyResolverFromRoutes(routes: readonly CanonicalFormatLegacyRoute[]): CanonicalFormatLegacyResolver;

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

@@ -51,12 +51,44 @@ 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
  * must agree that the seller did not declare it.
  */
 export declare function formatOptionOriginFromRoutes(resolver: CanonicalFormatLegacyResolver | undefined, ref: FormatOptionReference, productId: string | undefined): FormatOptionOrigin | undefined;
+/**
+ * Make `resolver` report the format-option origins recorded by `sources`.
+ *
+ * A resolver built by {@link canonicalFormatLegacyResolverFromRoutes} carries
+ * each route's `seller_declared` origin, which `AgentClient` reads to rewrite
+ * options the seller never declared on the canonical wire. A resolver that
+ * wraps or composes it is a new function and would otherwise carry none.
+ * Returns `resolver` itself, so the call can wrap a composition inline.
+ */
+export declare function carryFormatOptionOrigins(resolver: CanonicalFormatLegacyResolver, ...sources: ReadonlyArray<CanonicalFormatLegacyResolver | undefined>): CanonicalFormatLegacyResolver;
 export declare function canonicalFormatLegacyResolverFromRoutes(routes: readonly CanonicalFormatLegacyRoute[]): CanonicalFormatLegacyResolver;

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

@@ -19,8 +19,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var legacy_routes_exports = {};
 __export(legacy_routes_exports, {
   canonicalFormatLegacyResolverFromRoutes: () => canonicalFormatLegacyResolverFromRoutes,
+  carryFormatOptionOrigins: () => carryFormatOptionOrigins,
   formatOptionOriginFromRoutes: () => formatOptionOriginFromRoutes,
   legacyRoutesForProduct: () => legacyRoutesForProduct,
+  sameFormatOptionRef: () => sameFormatOptionRef,
+  sellerDeclaredFormatOptionRefs: () => sellerDeclaredFormatOptionRefs,
   undeclaredFormatOptionSelector: () => undeclaredFormatOptionSelector
 });
 module.exports = __toCommonJS(legacy_routes_exports);
@@ -62,6 +65,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 +113,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 [
       {
@@ -180,6 +205,11 @@ function formatOptionOriginFromRoutes(resolver, ref, productId) {
   if (matching.some((entry) => entry.origin === void 0)) return void 0;
   return matching[0].origin;
 }
+function carryFormatOptionOrigins(resolver, ...sources) {
+  const carried = [resolver, ...sources].flatMap((source) => source ? originsByResolver.get(source) ?? [] : []);
+  if (carried.length > 0) originsByResolver.set(resolver, Object.freeze(carried));
+  return resolver;
+}
 function canonicalFormatLegacyResolverFromRoutes(routes) {
   const index = /* @__PURE__ */ new Map();
   const origins = [];
@@ -213,7 +243,10 @@ function canonicalFormatLegacyResolverFromRoutes(routes) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   canonicalFormatLegacyResolverFromRoutes,
+  carryFormatOptionOrigins,
   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 [
       {
@@ -154,6 +176,11 @@ function formatOptionOriginFromRoutes(resolver, ref, productId) {
   if (matching.some((entry) => entry.origin === void 0)) return void 0;
   return matching[0].origin;
 }
+function carryFormatOptionOrigins(resolver, ...sources) {
+  const carried = [resolver, ...sources].flatMap((source) => source ? originsByResolver.get(source) ?? [] : []);
+  if (carried.length > 0) originsByResolver.set(resolver, Object.freeze(carried));
+  return resolver;
+}
 function canonicalFormatLegacyResolverFromRoutes(routes) {
   const index = /* @__PURE__ */ new Map();
   const origins = [];
@@ -186,7 +213,10 @@ function canonicalFormatLegacyResolverFromRoutes(routes) {
 }
 export {
   canonicalFormatLegacyResolverFromRoutes,
+  carryFormatOptionOrigins,
   formatOptionOriginFromRoutes,
   legacyRoutesForProduct,
+  sameFormatOptionRef,
+  sellerDeclaredFormatOptionRefs,
   undeclaredFormatOptionSelector
 };