@adcp/sdk 12.1.1 → 13.0.0-rc.0

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

@@ -18,14 +18,116 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var v2_to_v1_exports = {};
 __export(v2_to_v1_exports, {
-  projectV2ProductToV1: () => projectV2ProductToV1
+  CanonicalFormatLegacyResolutionError: () => CanonicalFormatLegacyResolutionError,
+  projectV2ProductToV1: () => projectV2ProductToV1,
+  resolveCanonicalFormatLegacyRefs: () => resolveCanonicalFormatLegacyRefs
 });
 module.exports = __toCommonJS(v2_to_v1_exports);
 var import_registry = require('./registry.js');
 var import_canonical_properties = require('./canonical-properties.js');
 var import_catalog = require('./catalog.js');
 var import_version = require('../../version.js');
+var import_legacy_metadata = require('./legacy-metadata.js');
 const SDK_ID = `@adcp/sdk@${import_version.LIBRARY_VERSION}`;
+class CanonicalFormatLegacyResolutionError extends Error {
+  name = "CanonicalFormatLegacyResolutionError";
+}
+function resolverRef(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new CanonicalFormatLegacyResolutionError("resolver output must be a format-id object");
+  }
+  const descriptors = Object.getOwnPropertyDescriptors(value);
+  for (const descriptor of Object.values(descriptors)) {
+    if (descriptor.enumerable && !("value" in descriptor)) {
+      throw new CanonicalFormatLegacyResolutionError("resolver output must not contain enumerable accessors");
+    }
+  }
+  const read = (key) => {
+    const descriptor = descriptors[key];
+    return descriptor && "value" in descriptor ? descriptor.value : void 0;
+  };
+  const agentUrl = read("agent_url");
+  const id = read("id");
+  if (typeof agentUrl !== "string" || agentUrl.length === 0 || typeof id !== "string" || !/^[a-zA-Z0-9_-]+$/.test(id)) {
+    throw new CanonicalFormatLegacyResolutionError("resolver output has an invalid agent_url or id");
+  }
+  try {
+    new URL(agentUrl);
+  } catch {
+    throw new CanonicalFormatLegacyResolutionError("resolver output agent_url must be an absolute URI");
+  }
+  const width = read("width");
+  const height = read("height");
+  const durationMs = read("duration_ms");
+  if (width === void 0 !== (height === void 0)) {
+    throw new CanonicalFormatLegacyResolutionError("resolver output width and height must be provided together");
+  }
+  if (width !== void 0 && (!Number.isInteger(width) || width < 1)) {
+    throw new CanonicalFormatLegacyResolutionError("resolver output width must be a positive integer");
+  }
+  if (height !== void 0 && (!Number.isInteger(height) || height < 1)) {
+    throw new CanonicalFormatLegacyResolutionError("resolver output height must be a positive integer");
+  }
+  if (durationMs !== void 0 && (typeof durationMs !== "number" || !Number.isFinite(durationMs) || durationMs < 1)) {
+    throw new CanonicalFormatLegacyResolutionError("resolver output duration_ms must be a positive number");
+  }
+  return {
+    agent_url: agentUrl,
+    id,
+    ...width !== void 0 ? { width, height } : {},
+    ...durationMs !== void 0 ? { duration_ms: durationMs } : {}
+  };
+}
+function resolveCanonicalFormatLegacyRefs(resolver, context, requireSingle = false) {
+  if (!resolver) return void 0;
+  let output;
+  try {
+    output = resolver(context);
+  } catch {
+    throw new CanonicalFormatLegacyResolutionError("canonical format legacy resolver threw");
+  }
+  if (output == null) return void 0;
+  try {
+    let values;
+    if (Array.isArray(output)) {
+      const descriptors = Object.getOwnPropertyDescriptors(output);
+      const lengthDescriptor = descriptors["length"];
+      const length = lengthDescriptor && "value" in lengthDescriptor ? lengthDescriptor.value : void 0;
+      if (typeof length !== "number" || !Number.isSafeInteger(length) || length < 0) {
+        throw new CanonicalFormatLegacyResolutionError("resolver returned an invalid format-id array");
+      }
+      values = [];
+      for (let index = 0; index < length; index++) {
+        const descriptor = descriptors[String(index)];
+        if (!descriptor || !("value" in descriptor)) {
+          throw new CanonicalFormatLegacyResolutionError(
+            "resolver output arrays must be dense data-only format-id arrays"
+          );
+        }
+        values.push(descriptor.value);
+      }
+    } else {
+      values = [output];
+    }
+    if (values.length === 0 || requireSingle && values.length !== 1) {
+      throw new CanonicalFormatLegacyResolutionError(
+        requireSingle ? "resolver must return exactly one format-id for a creative" : "resolver returned no format ids"
+      );
+    }
+    const refs = values.map(resolverRef);
+    return [
+      ...new Map(
+        refs.map((ref) => [
+          `${ref.agent_url}|${ref.id}|${ref.width ?? ""}|${ref.height ?? ""}|${ref.duration_ms ?? ""}`,
+          ref
+        ])
+      ).values()
+    ];
+  } catch (error) {
+    if (error instanceof CanonicalFormatLegacyResolutionError) throw error;
+    throw new CanonicalFormatLegacyResolutionError("canonical format legacy resolver returned unreadable output");
+  }
+}
 function detectLossyMultiSize(decl) {
   if (decl.format_kind !== "image" && decl.format_kind !== "html5" && decl.format_kind !== "display_tag") {
     return null;
@@ -63,7 +165,7 @@ function tryFanOutMultiSize(decl, v1Refs) {
   }
   return found.length >= 2 ? found : null;
 }
-function projectDeclaration(decl, productId, field) {
+function projectDeclaration(decl, productId, field, options) {
   if (decl.canonical_formats_only === true) {
     return {
       diagnostic: {
@@ -99,8 +201,9 @@ function projectDeclaration(decl, productId, field) {
       }
     };
   }
-  if (decl.v1_format_ref && decl.v1_format_ref.length > 0) {
-    const refs = decl.v1_format_ref;
+  const declaredLegacyRefs = (0, import_legacy_metadata.legacyFormatRefsForDeclaration)(decl);
+  if (declaredLegacyRefs.length > 0) {
+    const refs = [...declaredLegacyRefs];
     const lossy = detectLossyMultiSize(decl);
     if (lossy) {
       const declaredCount = lossy.count ?? 0;
@@ -137,6 +240,32 @@ function projectDeclaration(decl, productId, field) {
   if (result.kind === "match") {
     return { v1: result.v1 };
   }
+  try {
+    const resolved = resolveCanonicalFormatLegacyRefs(options?.canonicalFormatLegacyResolver, {
+      source: "product",
+      declaration: decl,
+      productId,
+      field
+    });
+    if (resolved) return { v1: resolved };
+  } catch {
+    return {
+      diagnostic: {
+        source: "sdk",
+        sdk_id: SDK_ID,
+        field,
+        code: "FORMAT_PROJECTION_FAILED",
+        error: {
+          details: {
+            format_kind: decl.format_kind,
+            product_id: productId,
+            format_option_id: decl.format_option_id,
+            resolution_failure: "custom_converter_failed"
+          }
+        }
+      }
+    };
+  }
   if (result.kind === "ambiguous") {
     return {
       diagnostic: {
@@ -172,13 +301,13 @@ function projectDeclaration(decl, productId, field) {
     }
   };
 }
-function projectV2ProductToV1(v2) {
+function projectV2ProductToV1(v2, options) {
   const format_ids = [];
   const diagnostics = [];
   for (let i = 0; i < v2.format_options.length; i++) {
     const decl = v2.format_options[i];
     const field = `products[${v2.product_id}].format_options[${i}]`;
-    const { v1, diagnostic } = projectDeclaration(decl, v2.product_id, field);
+    const { v1, diagnostic } = projectDeclaration(decl, v2.product_id, field, options);
     if (v1) {
       if (Array.isArray(v1)) {
         for (const id of v1) format_ids.push(id);
@@ -198,6 +327,8 @@ function projectV2ProductToV1(v2) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  projectV2ProductToV1
+  CanonicalFormatLegacyResolutionError,
+  projectV2ProductToV1,
+  resolveCanonicalFormatLegacyRefs
 });
 //# sourceMappingURL=v2-to-v1.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/v2/projection/v2-to-v1.ts"],"sourcesContent":["/**\n * v2 → v1 Product projection (the downgrade direction).\n *\n * Used when the SDK negotiated to a v1 seller for a buyer that wrote V2\n * code. The 8.0 design at `docs/development/v3.1-sdk-design.md` makes V2\n * the public mental model — adopters never see v1 vocabulary on\n * `Product` — so this is the symmetric counterpart to v1→v2 projection\n * on the read side.\n *\n * Resolution order per declaration (aligns with the normative rules in\n * `core/registries/v1-canonical-mapping.json` and the canonical schemas'\n * `v1_translatable` field):\n *\n *   1. `format_kind: \"custom\"` + `canonical_formats_only: true` → no v1\n *      emit. Seller has explicitly opted out. SDK-local diagnostic\n *      `FORMAT_DECLARATION_V1_NOT_APPLICABLE` surfaces the opt-out so\n *      v1-only buyers see why a product disappeared.\n *   2. Canonical declares `v1_translatable: false` (the 4 inherently-v2\n *      canonicals at 3.1 GA: image_carousel, sponsored_placement,\n *      responsive_creative, agent_placement) → no v1 emit. SDK-local\n *      `CANONICAL_NOT_V1_TRANSLATABLE` diagnostic. **Spec is explicit:\n *      MUST NOT emit FORMAT_PROJECTION_FAILED** — these aren't\n *      registry-coverage gaps, they're structural unreachability.\n *   3. `v1_format_ref` present → use verbatim. Seller-asserted v1↔v2\n *      pairing is the only normative path to a specific v1 `format_id`.\n *   4. Registry has invertible literal match (`format_id_glob` with no\n *      `*`, params narrow compatibly) → MAY synthesize a v1 `format_id`,\n *      but the projection is **non-normative** per the registry's\n *      direction-of-truth statement. Downstream consumers MUST NOT\n *      depend on this — and the spec explicitly notes that a synthesized\n *      `agent_url` is implementation-defined inter-SDK divergence. We\n *      do synthesize (best-effort, surfaces the registry's invertible\n *      entries) but flag the result as non-normative via the registry\n *      lookup return type.\n *   5. Registry has family-level matches (structural or wildcarded\n *      globs) but none invertible → `FORMAT_DECLARATION_V1_AMBIGUOUS`.\n *      Spec code. Seller's path: add `v1_format_ref` to disambiguate.\n *   6. Registry has no entries for this canonical (and v1_translatable\n *      is true) → `FORMAT_PROJECTION_FAILED`. Spec code. Registry-\n *      coverage gap; correctable by filing a registry PR.\n *\n * SDK identity for `sdk_id` is read from package.json at module-load\n * time so multi-hop deduplication can pin diagnostics to the SDK that\n * emitted them.\n */\n\nimport type { V2Product, V2ProductFormatDeclaration, V1Product, V1FormatId, ProjectionDiagnostic } from './types';\nimport { reverseLookup } from './registry';\nimport { isCanonicalV1Translatable } from './canonical-properties';\nimport { findCatalogEntryByCanonicalAndSize, parseSizedIdTemplate } from './catalog';\nimport { LIBRARY_VERSION } from '../../version';\n\nconst SDK_ID = `@adcp/sdk@${LIBRARY_VERSION}`;\n\nexport interface V2ToV1Result {\n  v1: V1Product;\n  diagnostics: ProjectionDiagnostic[];\n}\n\n/**\n * Inspect a v2 declaration's params for multi-size or responsive-range\n * shapes that a single v1 `format_id` can't represent. Returns the\n * detected mode + count so the caller emits the diagnostic with full\n * context. Returns null when params declare a single fixed (width,\n * height) — the case that round-trips through v1 cleanly.\n */\nfunction detectLossyMultiSize(\n  decl: V2ProductFormatDeclaration\n): { mode: 'sizes' | 'responsive_range'; count?: number } | null {\n  // Only image/html5/display_tag canonicals carry these new size modes\n  // at 3.1 GA. Other canonicals (video_*, audio_*) use their own param\n  // shapes that the v1 format_id can carry inline.\n  if (decl.format_kind !== 'image' && decl.format_kind !== 'html5' && decl.format_kind !== 'display_tag') {\n    return null;\n  }\n  const params = decl.params ?? {};\n  if (Array.isArray(params.sizes) && params.sizes.length > 1) {\n    return { mode: 'sizes', count: params.sizes.length };\n  }\n  // Responsive range mode: any of min_*/max_* present means the v1\n  // format_id (which carries exactly one width+height pair) is lossy.\n  if (\n    typeof params.min_width === 'number' ||\n    typeof params.max_width === 'number' ||\n    typeof params.min_height === 'number' ||\n    typeof params.max_height === 'number'\n  ) {\n    return { mode: 'responsive_range' };\n  }\n  return null;\n}\n\n/**\n * Try to fan out a multi-size v2 declaration to N v1 format_ids by\n * looking up each declared size in the AAO catalog. When successful,\n * v1 buyers see ALL the sizes the v2 declaration covers — not just\n * the seller-asserted rep. The spec doesn't require this (the rep +\n * lossy advisory is the minimum-bar projection) but the catalog\n * already publishes the per-size entries, so the SDK can use them\n * without inter-SDK divergence.\n *\n * Returns the fanned-out v1 ids when at least 2 sizes resolved\n * (otherwise the rep alone is fine; no value in fan-out). The lossy\n * advisory is still emitted — its details now reflect how many\n * sizes were actually covered vs declared.\n */\nfunction tryFanOutMultiSize(decl: V2ProductFormatDeclaration, v1Refs: V1FormatId[]): V1FormatId[] | null {\n  const sizes = decl.params?.sizes;\n  if (!Array.isArray(sizes) || sizes.length <= 1) return null;\n  // Parse the first seller-asserted ref's id to extract its\n  // `<prefix>_<W>x<H>_<suffix>` template, then constrain the fan-out\n  // to siblings sharing the same prefix + suffix. Otherwise multiple\n  // entries with the same `canonical:` annotation but different\n  // families (e.g., image's `display_*_image` and `display_*_generative`\n  // both annotated `canonical: image`) would collide and the SDK could\n  // emit ids from the wrong family.\n  const rep = v1Refs[0];\n  if (!rep?.id) return null;\n  const template = parseSizedIdTemplate(rep.id);\n  const lookupOpts = template ? { prefix: template.prefix, suffix: template.suffix } : undefined;\n\n  const found: V1FormatId[] = [];\n  for (const size of sizes) {\n    if (!size || typeof size !== 'object') continue;\n    const sz = size as { width?: unknown; height?: unknown };\n    if (typeof sz.width !== 'number' || typeof sz.height !== 'number') continue;\n    const entry = findCatalogEntryByCanonicalAndSize(decl.format_kind, sz.width, sz.height, rep.agent_url, lookupOpts);\n    if (entry) {\n      found.push({\n        agent_url: entry.format_id.agent_url,\n        id: entry.format_id.id,\n        width: sz.width,\n        height: sz.height,\n      });\n    }\n  }\n  return found.length >= 2 ? found : null;\n}\n\n/**\n * Project a single V2 declaration. Returns one v1 format_id (the\n * common case) OR a fanned-out list of v1 format_ids (multi-size\n * fan-out) OR a diagnostic, plus an optional advisory diagnostic\n * (multi-size loses some sizes). The structural invariant: every\n * declaration produces AT LEAST ONE of (v1 emit, diagnostic) — may\n * produce both.\n */\nfunction projectDeclaration(\n  decl: V2ProductFormatDeclaration,\n  productId: string,\n  field: string\n): { v1?: V1FormatId | V1FormatId[]; diagnostic?: ProjectionDiagnostic } {\n  // Step 1: seller-asserted product-level opt-out. canonical_formats_only\n  // is REQUIRED on `custom` declarations without v1_format_ref, but it's\n  // ALSO valid on any non-custom canonical when the seller wants to opt\n  // out of v1 emission for this product (e.g. the catalog has no v1 entry\n  // for the format yet — `audio_daast` is the 3.1 example).\n  if (decl.canonical_formats_only === true) {\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'FORMAT_DECLARATION_V1_NOT_APPLICABLE',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n            reason: 'canonical_formats_only',\n          },\n        },\n      },\n    };\n  }\n\n  // Step 2: canonical-level structural unreachability.\n  if (!isCanonicalV1Translatable(decl.format_kind)) {\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'CANONICAL_NOT_V1_TRANSLATABLE',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n          },\n        },\n      },\n    };\n  }\n\n  // Step 3: seller-asserted v1 link — the only normative path to a\n  // specific v1 format_id. The spec normatively requires `v1_format_ref`\n  // to be an array (single-ref is `[{...}]`); multi-size SHOULD carry\n  // one entry per size.\n  //\n  // When the seller-asserted refs cover every declared size, emit all\n  // refs verbatim — no advisory needed. When refs < sizes, emit what\n  // the seller asserted (+ catalog-driven fan-out for missing sizes when\n  // available) and surface the lossy advisory so the buyer knows the\n  // v1 wire is partial-coverage. Responsive ranges (min_*/max_*) are\n  // always advisory — the v1 wire can't carry a range.\n  if (decl.v1_format_ref && decl.v1_format_ref.length > 0) {\n    const refs = decl.v1_format_ref;\n    const lossy = detectLossyMultiSize(decl);\n    if (lossy) {\n      // Sizes mode: seller asserted ≥1 ref; try to widen via catalog\n      // lookup when refs < sizes; otherwise emit seller's refs verbatim.\n      // Responsive range: refs are the seller's representative anchors;\n      // can't be widened.\n      const declaredCount = lossy.count ?? 0;\n      const sellerCoversAllSizes = lossy.mode === 'sizes' && refs.length >= declaredCount;\n      if (sellerCoversAllSizes) {\n        return { v1: refs };\n      }\n      const fanned = lossy.mode === 'sizes' && refs.length < declaredCount ? tryFanOutMultiSize(decl, refs) : null;\n      // Merge: prefer the fanned-out catalog entries when they cover more sizes\n      // than the seller's refs; otherwise emit seller's refs.\n      const emit = fanned && fanned.length > refs.length ? fanned : refs;\n      return {\n        v1: emit,\n        diagnostic: {\n          source: 'sdk',\n          sdk_id: SDK_ID,\n          field,\n          code: 'FORMAT_DECLARATION_V1_LOSSY_MULTI_SIZE',\n          error: {\n            details: {\n              format_kind: decl.format_kind,\n              product_id: productId,\n              format_option_id: decl.format_option_id,\n              size_mode: lossy.mode,\n              declared_sizes_count: lossy.count,\n              emitted_sizes_count: emit.length,\n              v1_emit_represents_size: refs[0] ? { width: refs[0].width, height: refs[0].height } : undefined,\n            },\n          },\n        },\n      };\n    }\n    return { v1: refs };\n  }\n\n  // Steps 4-6: registry lookup.\n  const result = reverseLookup(decl.format_kind, decl.params);\n  if (result.kind === 'match') {\n    // Step 4: non-normative best-effort. Documented limitation: the\n    // synthesized agent_url is implementation-defined; downstream\n    // consumers MUST NOT depend on this projection.\n    return { v1: result.v1 };\n  }\n  if (result.kind === 'ambiguous') {\n    // Step 5: family known, specific format not pickable.\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'FORMAT_DECLARATION_V1_AMBIGUOUS',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n            registry_matches: result.matchedEntries,\n          },\n        },\n      },\n    };\n  }\n  // Step 6: registry-coverage gap.\n  return {\n    diagnostic: {\n      source: 'sdk',\n      sdk_id: SDK_ID,\n      field,\n      code: 'FORMAT_PROJECTION_FAILED',\n      error: {\n        details: {\n          format_kind: decl.format_kind,\n          product_id: productId,\n          format_option_id: decl.format_option_id,\n          resolution_failure: 'no_registry_match',\n        },\n      },\n    },\n  };\n}\n\n/**\n * Project a V2 Product to a v1 Product. Drops format_options from the\n * output and rebuilds format_ids per the resolution order.\n *\n * The function always returns a Product shape so adopters can inspect\n * what got dropped via diagnostics without parallel happy/sad-path\n * branches. Caller filters out v1 Products with empty format_ids before\n * sending to a v1-only seller (the spec requires `format_ids` to have\n * minItems: 1).\n */\nexport function projectV2ProductToV1(v2: V2Product): V2ToV1Result {\n  const format_ids: V1FormatId[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n\n  for (let i = 0; i < v2.format_options.length; i++) {\n    const decl = v2.format_options[i]!;\n    const field = `products[${v2.product_id}].format_options[${i}]`;\n    const { v1, diagnostic } = projectDeclaration(decl, v2.product_id, field);\n    if (v1) {\n      if (Array.isArray(v1)) {\n        for (const id of v1) format_ids.push(id);\n      } else {\n        format_ids.push(v1);\n      }\n    }\n    if (diagnostic) diagnostics.push(diagnostic);\n  }\n\n  const { format_options: _drop, ...rest } = v2;\n  void _drop;\n  const v1Product: V1Product = {\n    ...(rest as Omit<V2Product, 'format_options'>),\n    format_ids,\n  } as V1Product;\n\n  return { v1: v1Product, diagnostics };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/v2/projection/v2-to-v1.ts"],"sourcesContent":["/**\n * v2 → v1 Product projection (the downgrade direction).\n *\n * Used when the SDK negotiated to a v1 seller for a buyer that wrote V2\n * code. The 8.0 design at `docs/development/v3.1-sdk-design.md` makes V2\n * the public mental model — adopters never see v1 vocabulary on\n * `Product` — so this is the symmetric counterpart to v1→v2 projection\n * on the read side.\n *\n * Resolution order per declaration (aligns with the normative rules in\n * `core/registries/v1-canonical-mapping.json` and the canonical schemas'\n * `v1_translatable` field):\n *\n *   1. `format_kind: \"custom\"` + `canonical_formats_only: true` → no v1\n *      emit. Seller has explicitly opted out. SDK-local diagnostic\n *      `FORMAT_DECLARATION_V1_NOT_APPLICABLE` surfaces the opt-out so\n *      v1-only buyers see why a product disappeared.\n *   2. Canonical declares `v1_translatable: false` (the 4 inherently-v2\n *      canonicals at 3.1 GA: image_carousel, sponsored_placement,\n *      responsive_creative, agent_placement) → no v1 emit. SDK-local\n *      `CANONICAL_NOT_V1_TRANSLATABLE` diagnostic. **Spec is explicit:\n *      MUST NOT emit FORMAT_PROJECTION_FAILED** — these aren't\n *      registry-coverage gaps, they're structural unreachability.\n *   3. `v1_format_ref` present → use verbatim. Seller-asserted v1↔v2\n *      pairing is the only normative path to a specific v1 `format_id`.\n *   4. Registry has invertible literal match (`format_id_glob` with no\n *      `*`, params narrow compatibly) → MAY synthesize a v1 `format_id`,\n *      but the projection is **non-normative** per the registry's\n *      direction-of-truth statement. Downstream consumers MUST NOT\n *      depend on this — and the spec explicitly notes that a synthesized\n *      `agent_url` is implementation-defined inter-SDK divergence. We\n *      do synthesize (best-effort, surfaces the registry's invertible\n *      entries) but flag the result as non-normative via the registry\n *      lookup return type.\n *   5. Registry has family-level matches (structural or wildcarded\n *      globs) but none invertible → `FORMAT_DECLARATION_V1_AMBIGUOUS`.\n *      Spec code. Seller's path: add `v1_format_ref` to disambiguate.\n *   6. Registry has no entries for this canonical (and v1_translatable\n *      is true) → `FORMAT_PROJECTION_FAILED`. Spec code. Registry-\n *      coverage gap; correctable by filing a registry PR.\n *\n * SDK identity for `sdk_id` is read from package.json at module-load\n * time so multi-hop deduplication can pin diagnostics to the SDK that\n * emitted them.\n */\n\nimport type { V2Product, V2ProductFormatDeclaration, V1Product, V1FormatId, ProjectionDiagnostic } from './types';\nimport { reverseLookup } from './registry';\nimport { isCanonicalV1Translatable } from './canonical-properties';\nimport { findCatalogEntryByCanonicalAndSize, parseSizedIdTemplate } from './catalog';\nimport { LIBRARY_VERSION } from '../../version';\nimport { legacyFormatRefsForDeclaration } from './legacy-metadata';\n\nconst SDK_ID = `@adcp/sdk@${LIBRARY_VERSION}`;\n\nexport interface CanonicalProductFormatLegacyResolutionContext {\n  source: 'product';\n  declaration: Readonly<V2ProductFormatDeclaration>;\n  productId: string;\n  field: string;\n}\n\nexport interface CanonicalCreativeFormatLegacyResolutionContext {\n  source: 'creative';\n  creative: Readonly<Record<string, unknown>>;\n  selector: Readonly<Record<string, unknown>>;\n  operation: string;\n  field: string;\n}\n\nexport interface CanonicalSelectorFormatLegacyResolutionContext {\n  source: 'selector';\n  selector: Readonly<Record<string, unknown>>;\n  operation: string;\n  field: string;\n}\n\nexport type CanonicalFormatLegacyResolutionContext =\n  | CanonicalProductFormatLegacyResolutionContext\n  | CanonicalCreativeFormatLegacyResolutionContext\n  | CanonicalSelectorFormatLegacyResolutionContext;\n\n/** Explicit canonical → legacy resolver for persisted routes the SDK cannot safely infer. */\nexport type CanonicalFormatLegacyResolver = (\n  context: CanonicalFormatLegacyResolutionContext\n) => V1FormatId | readonly V1FormatId[] | null | undefined;\n\nexport interface V2ToV1ProjectionOptions {\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver;\n}\n\nexport class CanonicalFormatLegacyResolutionError extends Error {\n  readonly name = 'CanonicalFormatLegacyResolutionError' as const;\n}\n\nfunction resolverRef(value: unknown): V1FormatId {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n    throw new CanonicalFormatLegacyResolutionError('resolver output must be a format-id object');\n  }\n  const descriptors = Object.getOwnPropertyDescriptors(value);\n  for (const descriptor of Object.values(descriptors)) {\n    if (descriptor.enumerable && !('value' in descriptor)) {\n      throw new CanonicalFormatLegacyResolutionError('resolver output must not contain enumerable accessors');\n    }\n  }\n  const read = (key: string): unknown => {\n    const descriptor = descriptors[key];\n    return descriptor && 'value' in descriptor ? descriptor.value : undefined;\n  };\n  const agentUrl = read('agent_url');\n  const id = read('id');\n  if (typeof agentUrl !== 'string' || agentUrl.length === 0 || typeof id !== 'string' || !/^[a-zA-Z0-9_-]+$/.test(id)) {\n    throw new CanonicalFormatLegacyResolutionError('resolver output has an invalid agent_url or id');\n  }\n  try {\n    new URL(agentUrl);\n  } catch {\n    throw new CanonicalFormatLegacyResolutionError('resolver output agent_url must be an absolute URI');\n  }\n  const width = read('width');\n  const height = read('height');\n  const durationMs = read('duration_ms');\n  if ((width === undefined) !== (height === undefined)) {\n    throw new CanonicalFormatLegacyResolutionError('resolver output width and height must be provided together');\n  }\n  if (width !== undefined && (!Number.isInteger(width) || (width as number) < 1)) {\n    throw new CanonicalFormatLegacyResolutionError('resolver output width must be a positive integer');\n  }\n  if (height !== undefined && (!Number.isInteger(height) || (height as number) < 1)) {\n    throw new CanonicalFormatLegacyResolutionError('resolver output height must be a positive integer');\n  }\n  if (durationMs !== undefined && (typeof durationMs !== 'number' || !Number.isFinite(durationMs) || durationMs < 1)) {\n    throw new CanonicalFormatLegacyResolutionError('resolver output duration_ms must be a positive number');\n  }\n  return {\n    agent_url: agentUrl,\n    id,\n    ...(width !== undefined ? { width: width as number, height: height as number } : {}),\n    ...(durationMs !== undefined ? { duration_ms: durationMs } : {}),\n  };\n}\n\nexport function resolveCanonicalFormatLegacyRefs(\n  resolver: CanonicalFormatLegacyResolver | undefined,\n  context: CanonicalFormatLegacyResolutionContext,\n  requireSingle = false\n): V1FormatId[] | undefined {\n  if (!resolver) return undefined;\n  let output: V1FormatId | readonly V1FormatId[] | null | undefined;\n  try {\n    output = resolver(context);\n  } catch {\n    throw new CanonicalFormatLegacyResolutionError('canonical format legacy resolver threw');\n  }\n  if (output == null) return undefined;\n  try {\n    let values: unknown[];\n    if (Array.isArray(output)) {\n      const descriptors = Object.getOwnPropertyDescriptors(output) as Record<string, PropertyDescriptor>;\n      const lengthDescriptor = descriptors['length'];\n      const length = lengthDescriptor && 'value' in lengthDescriptor ? lengthDescriptor.value : undefined;\n      if (typeof length !== 'number' || !Number.isSafeInteger(length) || length < 0) {\n        throw new CanonicalFormatLegacyResolutionError('resolver returned an invalid format-id array');\n      }\n      values = [];\n      for (let index = 0; index < length; index++) {\n        const descriptor = descriptors[String(index)];\n        if (!descriptor || !('value' in descriptor)) {\n          throw new CanonicalFormatLegacyResolutionError(\n            'resolver output arrays must be dense data-only format-id arrays'\n          );\n        }\n        values.push(descriptor.value);\n      }\n    } else {\n      values = [output];\n    }\n    if (values.length === 0 || (requireSingle && values.length !== 1)) {\n      throw new CanonicalFormatLegacyResolutionError(\n        requireSingle ? 'resolver must return exactly one format-id for a creative' : 'resolver returned no format ids'\n      );\n    }\n    const refs = values.map(resolverRef);\n    return [\n      ...new Map(\n        refs.map(ref => [\n          `${ref.agent_url}|${ref.id}|${ref.width ?? ''}|${ref.height ?? ''}|${ref.duration_ms ?? ''}`,\n          ref,\n        ])\n      ).values(),\n    ];\n  } catch (error) {\n    if (error instanceof CanonicalFormatLegacyResolutionError) throw error;\n    throw new CanonicalFormatLegacyResolutionError('canonical format legacy resolver returned unreadable output');\n  }\n}\n\nexport interface V2ToV1Result {\n  v1: V1Product;\n  diagnostics: ProjectionDiagnostic[];\n}\n\n/**\n * Inspect a v2 declaration's params for multi-size or responsive-range\n * shapes that a single v1 `format_id` can't represent. Returns the\n * detected mode + count so the caller emits the diagnostic with full\n * context. Returns null when params declare a single fixed (width,\n * height) — the case that round-trips through v1 cleanly.\n */\nfunction detectLossyMultiSize(\n  decl: V2ProductFormatDeclaration\n): { mode: 'sizes' | 'responsive_range'; count?: number } | null {\n  // Only image/html5/display_tag canonicals carry these new size modes\n  // at 3.1 GA. Other canonicals (video_*, audio_*) use their own param\n  // shapes that the v1 format_id can carry inline.\n  if (decl.format_kind !== 'image' && decl.format_kind !== 'html5' && decl.format_kind !== 'display_tag') {\n    return null;\n  }\n  const params = decl.params ?? {};\n  if (Array.isArray(params.sizes) && params.sizes.length > 1) {\n    return { mode: 'sizes', count: params.sizes.length };\n  }\n  // Responsive range mode: any of min_*/max_* present means the v1\n  // format_id (which carries exactly one width+height pair) is lossy.\n  if (\n    typeof params.min_width === 'number' ||\n    typeof params.max_width === 'number' ||\n    typeof params.min_height === 'number' ||\n    typeof params.max_height === 'number'\n  ) {\n    return { mode: 'responsive_range' };\n  }\n  return null;\n}\n\n/**\n * Try to fan out a multi-size v2 declaration to N v1 format_ids by\n * looking up each declared size in the AAO catalog. When successful,\n * v1 buyers see ALL the sizes the v2 declaration covers — not just\n * the seller-asserted rep. The spec doesn't require this (the rep +\n * lossy advisory is the minimum-bar projection) but the catalog\n * already publishes the per-size entries, so the SDK can use them\n * without inter-SDK divergence.\n *\n * Returns the fanned-out v1 ids when at least 2 sizes resolved\n * (otherwise the rep alone is fine; no value in fan-out). The lossy\n * advisory is still emitted — its details now reflect how many\n * sizes were actually covered vs declared.\n */\nfunction tryFanOutMultiSize(decl: V2ProductFormatDeclaration, v1Refs: V1FormatId[]): V1FormatId[] | null {\n  const sizes = decl.params?.sizes;\n  if (!Array.isArray(sizes) || sizes.length <= 1) return null;\n  // Parse the first seller-asserted ref's id to extract its\n  // `<prefix>_<W>x<H>_<suffix>` template, then constrain the fan-out\n  // to siblings sharing the same prefix + suffix. Otherwise multiple\n  // entries with the same `canonical:` annotation but different\n  // families (e.g., image's `display_*_image` and `display_*_generative`\n  // both annotated `canonical: image`) would collide and the SDK could\n  // emit ids from the wrong family.\n  const rep = v1Refs[0];\n  if (!rep?.id) return null;\n  const template = parseSizedIdTemplate(rep.id);\n  const lookupOpts = template ? { prefix: template.prefix, suffix: template.suffix } : undefined;\n\n  const found: V1FormatId[] = [];\n  for (const size of sizes) {\n    if (!size || typeof size !== 'object') continue;\n    const sz = size as { width?: unknown; height?: unknown };\n    if (typeof sz.width !== 'number' || typeof sz.height !== 'number') continue;\n    const entry = findCatalogEntryByCanonicalAndSize(decl.format_kind, sz.width, sz.height, rep.agent_url, lookupOpts);\n    if (entry) {\n      found.push({\n        agent_url: entry.format_id.agent_url,\n        id: entry.format_id.id,\n        width: sz.width,\n        height: sz.height,\n      });\n    }\n  }\n  return found.length >= 2 ? found : null;\n}\n\n/**\n * Project a single V2 declaration. Returns one v1 format_id (the\n * common case) OR a fanned-out list of v1 format_ids (multi-size\n * fan-out) OR a diagnostic, plus an optional advisory diagnostic\n * (multi-size loses some sizes). The structural invariant: every\n * declaration produces AT LEAST ONE of (v1 emit, diagnostic) — may\n * produce both.\n */\nfunction projectDeclaration(\n  decl: V2ProductFormatDeclaration,\n  productId: string,\n  field: string,\n  options?: V2ToV1ProjectionOptions\n): { v1?: V1FormatId | V1FormatId[]; diagnostic?: ProjectionDiagnostic } {\n  // Step 1: seller-asserted product-level opt-out. canonical_formats_only\n  // is REQUIRED on `custom` declarations without v1_format_ref, but it's\n  // ALSO valid on any non-custom canonical when the seller wants to opt\n  // out of v1 emission for this product (e.g. the catalog has no v1 entry\n  // for the format yet — `audio_daast` is the 3.1 example).\n  if (decl.canonical_formats_only === true) {\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'FORMAT_DECLARATION_V1_NOT_APPLICABLE',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n            reason: 'canonical_formats_only',\n          },\n        },\n      },\n    };\n  }\n\n  // Step 2: canonical-level structural unreachability.\n  if (!isCanonicalV1Translatable(decl.format_kind)) {\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'CANONICAL_NOT_V1_TRANSLATABLE',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n          },\n        },\n      },\n    };\n  }\n\n  // Step 3: seller-asserted v1 link — the only normative path to a\n  // specific v1 format_id. The spec normatively requires `v1_format_ref`\n  // to be an array (single-ref is `[{...}]`); multi-size SHOULD carry\n  // one entry per size.\n  //\n  // When the seller-asserted refs cover every declared size, emit all\n  // refs verbatim — no advisory needed. When refs < sizes, emit what\n  // the seller asserted (+ catalog-driven fan-out for missing sizes when\n  // available) and surface the lossy advisory so the buyer knows the\n  // v1 wire is partial-coverage. Responsive ranges (min_*/max_*) are\n  // always advisory — the v1 wire can't carry a range.\n  const declaredLegacyRefs = legacyFormatRefsForDeclaration(decl);\n  if (declaredLegacyRefs.length > 0) {\n    const refs = [...declaredLegacyRefs];\n    const lossy = detectLossyMultiSize(decl);\n    if (lossy) {\n      // Sizes mode: seller asserted ≥1 ref; try to widen via catalog\n      // lookup when refs < sizes; otherwise emit seller's refs verbatim.\n      // Responsive range: refs are the seller's representative anchors;\n      // can't be widened.\n      const declaredCount = lossy.count ?? 0;\n      const sellerCoversAllSizes = lossy.mode === 'sizes' && refs.length >= declaredCount;\n      if (sellerCoversAllSizes) {\n        return { v1: refs };\n      }\n      const fanned = lossy.mode === 'sizes' && refs.length < declaredCount ? tryFanOutMultiSize(decl, refs) : null;\n      // Merge: prefer the fanned-out catalog entries when they cover more sizes\n      // than the seller's refs; otherwise emit seller's refs.\n      const emit = fanned && fanned.length > refs.length ? fanned : refs;\n      return {\n        v1: emit,\n        diagnostic: {\n          source: 'sdk',\n          sdk_id: SDK_ID,\n          field,\n          code: 'FORMAT_DECLARATION_V1_LOSSY_MULTI_SIZE',\n          error: {\n            details: {\n              format_kind: decl.format_kind,\n              product_id: productId,\n              format_option_id: decl.format_option_id,\n              size_mode: lossy.mode,\n              declared_sizes_count: lossy.count,\n              emitted_sizes_count: emit.length,\n              v1_emit_represents_size: refs[0] ? { width: refs[0].width, height: refs[0].height } : undefined,\n            },\n          },\n        },\n      };\n    }\n    return { v1: refs };\n  }\n\n  // Steps 4-6: registry lookup.\n  const result = reverseLookup(decl.format_kind, decl.params);\n  if (result.kind === 'match') {\n    // Step 4: non-normative best-effort. Documented limitation: the\n    // synthesized agent_url is implementation-defined; downstream\n    // consumers MUST NOT depend on this projection.\n    return { v1: result.v1 };\n  }\n  try {\n    const resolved = resolveCanonicalFormatLegacyRefs(options?.canonicalFormatLegacyResolver, {\n      source: 'product',\n      declaration: decl,\n      productId,\n      field,\n    });\n    if (resolved) return { v1: resolved };\n  } catch {\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'FORMAT_PROJECTION_FAILED',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n            resolution_failure: 'custom_converter_failed',\n          },\n        },\n      },\n    };\n  }\n  if (result.kind === 'ambiguous') {\n    // Step 5: family known, specific format not pickable.\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'FORMAT_DECLARATION_V1_AMBIGUOUS',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n            registry_matches: result.matchedEntries,\n          },\n        },\n      },\n    };\n  }\n  // Step 6: registry-coverage gap.\n  return {\n    diagnostic: {\n      source: 'sdk',\n      sdk_id: SDK_ID,\n      field,\n      code: 'FORMAT_PROJECTION_FAILED',\n      error: {\n        details: {\n          format_kind: decl.format_kind,\n          product_id: productId,\n          format_option_id: decl.format_option_id,\n          resolution_failure: 'no_registry_match',\n        },\n      },\n    },\n  };\n}\n\n/**\n * Project a V2 Product to a v1 Product. Drops format_options from the\n * output and rebuilds format_ids per the resolution order.\n *\n * The function always returns a Product shape so adopters can inspect\n * what got dropped via diagnostics without parallel happy/sad-path\n * branches. Caller filters out v1 Products with empty format_ids before\n * sending to a v1-only seller (the spec requires `format_ids` to have\n * minItems: 1).\n */\nexport function projectV2ProductToV1(v2: V2Product, options?: V2ToV1ProjectionOptions): V2ToV1Result {\n  const format_ids: V1FormatId[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n\n  for (let i = 0; i < v2.format_options.length; i++) {\n    const decl = v2.format_options[i]!;\n    const field = `products[${v2.product_id}].format_options[${i}]`;\n    const { v1, diagnostic } = projectDeclaration(decl, v2.product_id, field, options);\n    if (v1) {\n      if (Array.isArray(v1)) {\n        for (const id of v1) format_ids.push(id);\n      } else {\n        format_ids.push(v1);\n      }\n    }\n    if (diagnostic) diagnostics.push(diagnostic);\n  }\n\n  const { format_options: _drop, ...rest } = v2;\n  void _drop;\n  const v1Product: V1Product = {\n    ...(rest as Omit<V2Product, 'format_options'>),\n    format_ids,\n  } as V1Product;\n\n  return { v1: v1Product, diagnostics };\n}\n"],"mappings":"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","names":[]}

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

@@ -2,7 +2,107 @@ import { reverseLookup } from "./registry.mjs";
 import { isCanonicalV1Translatable } from "./canonical-properties.mjs";
 import { findCatalogEntryByCanonicalAndSize, parseSizedIdTemplate } from "./catalog.mjs";
 import { LIBRARY_VERSION } from "../../version.mjs";
+import { legacyFormatRefsForDeclaration } from "./legacy-metadata.mjs";
 const SDK_ID = `@adcp/sdk@${LIBRARY_VERSION}`;
+class CanonicalFormatLegacyResolutionError extends Error {
+  name = "CanonicalFormatLegacyResolutionError";
+}
+function resolverRef(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new CanonicalFormatLegacyResolutionError("resolver output must be a format-id object");
+  }
+  const descriptors = Object.getOwnPropertyDescriptors(value);
+  for (const descriptor of Object.values(descriptors)) {
+    if (descriptor.enumerable && !("value" in descriptor)) {
+      throw new CanonicalFormatLegacyResolutionError("resolver output must not contain enumerable accessors");
+    }
+  }
+  const read = (key) => {
+    const descriptor = descriptors[key];
+    return descriptor && "value" in descriptor ? descriptor.value : void 0;
+  };
+  const agentUrl = read("agent_url");
+  const id = read("id");
+  if (typeof agentUrl !== "string" || agentUrl.length === 0 || typeof id !== "string" || !/^[a-zA-Z0-9_-]+$/.test(id)) {
+    throw new CanonicalFormatLegacyResolutionError("resolver output has an invalid agent_url or id");
+  }
+  try {
+    new URL(agentUrl);
+  } catch {
+    throw new CanonicalFormatLegacyResolutionError("resolver output agent_url must be an absolute URI");
+  }
+  const width = read("width");
+  const height = read("height");
+  const durationMs = read("duration_ms");
+  if (width === void 0 !== (height === void 0)) {
+    throw new CanonicalFormatLegacyResolutionError("resolver output width and height must be provided together");
+  }
+  if (width !== void 0 && (!Number.isInteger(width) || width < 1)) {
+    throw new CanonicalFormatLegacyResolutionError("resolver output width must be a positive integer");
+  }
+  if (height !== void 0 && (!Number.isInteger(height) || height < 1)) {
+    throw new CanonicalFormatLegacyResolutionError("resolver output height must be a positive integer");
+  }
+  if (durationMs !== void 0 && (typeof durationMs !== "number" || !Number.isFinite(durationMs) || durationMs < 1)) {
+    throw new CanonicalFormatLegacyResolutionError("resolver output duration_ms must be a positive number");
+  }
+  return {
+    agent_url: agentUrl,
+    id,
+    ...width !== void 0 ? { width, height } : {},
+    ...durationMs !== void 0 ? { duration_ms: durationMs } : {}
+  };
+}
+function resolveCanonicalFormatLegacyRefs(resolver, context, requireSingle = false) {
+  if (!resolver) return void 0;
+  let output;
+  try {
+    output = resolver(context);
+  } catch {
+    throw new CanonicalFormatLegacyResolutionError("canonical format legacy resolver threw");
+  }
+  if (output == null) return void 0;
+  try {
+    let values;
+    if (Array.isArray(output)) {
+      const descriptors = Object.getOwnPropertyDescriptors(output);
+      const lengthDescriptor = descriptors["length"];
+      const length = lengthDescriptor && "value" in lengthDescriptor ? lengthDescriptor.value : void 0;
+      if (typeof length !== "number" || !Number.isSafeInteger(length) || length < 0) {
+        throw new CanonicalFormatLegacyResolutionError("resolver returned an invalid format-id array");
+      }
+      values = [];
+      for (let index = 0; index < length; index++) {
+        const descriptor = descriptors[String(index)];
+        if (!descriptor || !("value" in descriptor)) {
+          throw new CanonicalFormatLegacyResolutionError(
+            "resolver output arrays must be dense data-only format-id arrays"
+          );
+        }
+        values.push(descriptor.value);
+      }
+    } else {
+      values = [output];
+    }
+    if (values.length === 0 || requireSingle && values.length !== 1) {
+      throw new CanonicalFormatLegacyResolutionError(
+        requireSingle ? "resolver must return exactly one format-id for a creative" : "resolver returned no format ids"
+      );
+    }
+    const refs = values.map(resolverRef);
+    return [
+      ...new Map(
+        refs.map((ref) => [
+          `${ref.agent_url}|${ref.id}|${ref.width ?? ""}|${ref.height ?? ""}|${ref.duration_ms ?? ""}`,
+          ref
+        ])
+      ).values()
+    ];
+  } catch (error) {
+    if (error instanceof CanonicalFormatLegacyResolutionError) throw error;
+    throw new CanonicalFormatLegacyResolutionError("canonical format legacy resolver returned unreadable output");
+  }
+}
 function detectLossyMultiSize(decl) {
   if (decl.format_kind !== "image" && decl.format_kind !== "html5" && decl.format_kind !== "display_tag") {
     return null;
@@ -40,7 +140,7 @@ function tryFanOutMultiSize(decl, v1Refs) {
   }
   return found.length >= 2 ? found : null;
 }
-function projectDeclaration(decl, productId, field) {
+function projectDeclaration(decl, productId, field, options) {
   if (decl.canonical_formats_only === true) {
     return {
       diagnostic: {
@@ -76,8 +176,9 @@ function projectDeclaration(decl, productId, field) {
       }
     };
   }
-  if (decl.v1_format_ref && decl.v1_format_ref.length > 0) {
-    const refs = decl.v1_format_ref;
+  const declaredLegacyRefs = legacyFormatRefsForDeclaration(decl);
+  if (declaredLegacyRefs.length > 0) {
+    const refs = [...declaredLegacyRefs];
     const lossy = detectLossyMultiSize(decl);
     if (lossy) {
       const declaredCount = lossy.count ?? 0;
@@ -114,6 +215,32 @@ function projectDeclaration(decl, productId, field) {
   if (result.kind === "match") {
     return { v1: result.v1 };
   }
+  try {
+    const resolved = resolveCanonicalFormatLegacyRefs(options?.canonicalFormatLegacyResolver, {
+      source: "product",
+      declaration: decl,
+      productId,
+      field
+    });
+    if (resolved) return { v1: resolved };
+  } catch {
+    return {
+      diagnostic: {
+        source: "sdk",
+        sdk_id: SDK_ID,
+        field,
+        code: "FORMAT_PROJECTION_FAILED",
+        error: {
+          details: {
+            format_kind: decl.format_kind,
+            product_id: productId,
+            format_option_id: decl.format_option_id,
+            resolution_failure: "custom_converter_failed"
+          }
+        }
+      }
+    };
+  }
   if (result.kind === "ambiguous") {
     return {
       diagnostic: {
@@ -149,13 +276,13 @@ function projectDeclaration(decl, productId, field) {
     }
   };
 }
-function projectV2ProductToV1(v2) {
+function projectV2ProductToV1(v2, options) {
   const format_ids = [];
   const diagnostics = [];
   for (let i = 0; i < v2.format_options.length; i++) {
     const decl = v2.format_options[i];
     const field = `products[${v2.product_id}].format_options[${i}]`;
-    const { v1, diagnostic } = projectDeclaration(decl, v2.product_id, field);
+    const { v1, diagnostic } = projectDeclaration(decl, v2.product_id, field, options);
     if (v1) {
       if (Array.isArray(v1)) {
         for (const id of v1) format_ids.push(id);
@@ -174,6 +301,8 @@ function projectV2ProductToV1(v2) {
   return { v1: v1Product, diagnostics };
 }
 export {
-  projectV2ProductToV1
+  CanonicalFormatLegacyResolutionError,
+  projectV2ProductToV1,
+  resolveCanonicalFormatLegacyRefs
 };
 //# sourceMappingURL=v2-to-v1.mjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/v2/projection/v2-to-v1.ts"],"sourcesContent":["/**\n * v2 → v1 Product projection (the downgrade direction).\n *\n * Used when the SDK negotiated to a v1 seller for a buyer that wrote V2\n * code. The 8.0 design at `docs/development/v3.1-sdk-design.md` makes V2\n * the public mental model — adopters never see v1 vocabulary on\n * `Product` — so this is the symmetric counterpart to v1→v2 projection\n * on the read side.\n *\n * Resolution order per declaration (aligns with the normative rules in\n * `core/registries/v1-canonical-mapping.json` and the canonical schemas'\n * `v1_translatable` field):\n *\n *   1. `format_kind: \"custom\"` + `canonical_formats_only: true` → no v1\n *      emit. Seller has explicitly opted out. SDK-local diagnostic\n *      `FORMAT_DECLARATION_V1_NOT_APPLICABLE` surfaces the opt-out so\n *      v1-only buyers see why a product disappeared.\n *   2. Canonical declares `v1_translatable: false` (the 4 inherently-v2\n *      canonicals at 3.1 GA: image_carousel, sponsored_placement,\n *      responsive_creative, agent_placement) → no v1 emit. SDK-local\n *      `CANONICAL_NOT_V1_TRANSLATABLE` diagnostic. **Spec is explicit:\n *      MUST NOT emit FORMAT_PROJECTION_FAILED** — these aren't\n *      registry-coverage gaps, they're structural unreachability.\n *   3. `v1_format_ref` present → use verbatim. Seller-asserted v1↔v2\n *      pairing is the only normative path to a specific v1 `format_id`.\n *   4. Registry has invertible literal match (`format_id_glob` with no\n *      `*`, params narrow compatibly) → MAY synthesize a v1 `format_id`,\n *      but the projection is **non-normative** per the registry's\n *      direction-of-truth statement. Downstream consumers MUST NOT\n *      depend on this — and the spec explicitly notes that a synthesized\n *      `agent_url` is implementation-defined inter-SDK divergence. We\n *      do synthesize (best-effort, surfaces the registry's invertible\n *      entries) but flag the result as non-normative via the registry\n *      lookup return type.\n *   5. Registry has family-level matches (structural or wildcarded\n *      globs) but none invertible → `FORMAT_DECLARATION_V1_AMBIGUOUS`.\n *      Spec code. Seller's path: add `v1_format_ref` to disambiguate.\n *   6. Registry has no entries for this canonical (and v1_translatable\n *      is true) → `FORMAT_PROJECTION_FAILED`. Spec code. Registry-\n *      coverage gap; correctable by filing a registry PR.\n *\n * SDK identity for `sdk_id` is read from package.json at module-load\n * time so multi-hop deduplication can pin diagnostics to the SDK that\n * emitted them.\n */\n\nimport type { V2Product, V2ProductFormatDeclaration, V1Product, V1FormatId, ProjectionDiagnostic } from './types';\nimport { reverseLookup } from './registry';\nimport { isCanonicalV1Translatable } from './canonical-properties';\nimport { findCatalogEntryByCanonicalAndSize, parseSizedIdTemplate } from './catalog';\nimport { LIBRARY_VERSION } from '../../version';\n\nconst SDK_ID = `@adcp/sdk@${LIBRARY_VERSION}`;\n\nexport interface V2ToV1Result {\n  v1: V1Product;\n  diagnostics: ProjectionDiagnostic[];\n}\n\n/**\n * Inspect a v2 declaration's params for multi-size or responsive-range\n * shapes that a single v1 `format_id` can't represent. Returns the\n * detected mode + count so the caller emits the diagnostic with full\n * context. Returns null when params declare a single fixed (width,\n * height) — the case that round-trips through v1 cleanly.\n */\nfunction detectLossyMultiSize(\n  decl: V2ProductFormatDeclaration\n): { mode: 'sizes' | 'responsive_range'; count?: number } | null {\n  // Only image/html5/display_tag canonicals carry these new size modes\n  // at 3.1 GA. Other canonicals (video_*, audio_*) use their own param\n  // shapes that the v1 format_id can carry inline.\n  if (decl.format_kind !== 'image' && decl.format_kind !== 'html5' && decl.format_kind !== 'display_tag') {\n    return null;\n  }\n  const params = decl.params ?? {};\n  if (Array.isArray(params.sizes) && params.sizes.length > 1) {\n    return { mode: 'sizes', count: params.sizes.length };\n  }\n  // Responsive range mode: any of min_*/max_* present means the v1\n  // format_id (which carries exactly one width+height pair) is lossy.\n  if (\n    typeof params.min_width === 'number' ||\n    typeof params.max_width === 'number' ||\n    typeof params.min_height === 'number' ||\n    typeof params.max_height === 'number'\n  ) {\n    return { mode: 'responsive_range' };\n  }\n  return null;\n}\n\n/**\n * Try to fan out a multi-size v2 declaration to N v1 format_ids by\n * looking up each declared size in the AAO catalog. When successful,\n * v1 buyers see ALL the sizes the v2 declaration covers — not just\n * the seller-asserted rep. The spec doesn't require this (the rep +\n * lossy advisory is the minimum-bar projection) but the catalog\n * already publishes the per-size entries, so the SDK can use them\n * without inter-SDK divergence.\n *\n * Returns the fanned-out v1 ids when at least 2 sizes resolved\n * (otherwise the rep alone is fine; no value in fan-out). The lossy\n * advisory is still emitted — its details now reflect how many\n * sizes were actually covered vs declared.\n */\nfunction tryFanOutMultiSize(decl: V2ProductFormatDeclaration, v1Refs: V1FormatId[]): V1FormatId[] | null {\n  const sizes = decl.params?.sizes;\n  if (!Array.isArray(sizes) || sizes.length <= 1) return null;\n  // Parse the first seller-asserted ref's id to extract its\n  // `<prefix>_<W>x<H>_<suffix>` template, then constrain the fan-out\n  // to siblings sharing the same prefix + suffix. Otherwise multiple\n  // entries with the same `canonical:` annotation but different\n  // families (e.g., image's `display_*_image` and `display_*_generative`\n  // both annotated `canonical: image`) would collide and the SDK could\n  // emit ids from the wrong family.\n  const rep = v1Refs[0];\n  if (!rep?.id) return null;\n  const template = parseSizedIdTemplate(rep.id);\n  const lookupOpts = template ? { prefix: template.prefix, suffix: template.suffix } : undefined;\n\n  const found: V1FormatId[] = [];\n  for (const size of sizes) {\n    if (!size || typeof size !== 'object') continue;\n    const sz = size as { width?: unknown; height?: unknown };\n    if (typeof sz.width !== 'number' || typeof sz.height !== 'number') continue;\n    const entry = findCatalogEntryByCanonicalAndSize(decl.format_kind, sz.width, sz.height, rep.agent_url, lookupOpts);\n    if (entry) {\n      found.push({\n        agent_url: entry.format_id.agent_url,\n        id: entry.format_id.id,\n        width: sz.width,\n        height: sz.height,\n      });\n    }\n  }\n  return found.length >= 2 ? found : null;\n}\n\n/**\n * Project a single V2 declaration. Returns one v1 format_id (the\n * common case) OR a fanned-out list of v1 format_ids (multi-size\n * fan-out) OR a diagnostic, plus an optional advisory diagnostic\n * (multi-size loses some sizes). The structural invariant: every\n * declaration produces AT LEAST ONE of (v1 emit, diagnostic) — may\n * produce both.\n */\nfunction projectDeclaration(\n  decl: V2ProductFormatDeclaration,\n  productId: string,\n  field: string\n): { v1?: V1FormatId | V1FormatId[]; diagnostic?: ProjectionDiagnostic } {\n  // Step 1: seller-asserted product-level opt-out. canonical_formats_only\n  // is REQUIRED on `custom` declarations without v1_format_ref, but it's\n  // ALSO valid on any non-custom canonical when the seller wants to opt\n  // out of v1 emission for this product (e.g. the catalog has no v1 entry\n  // for the format yet — `audio_daast` is the 3.1 example).\n  if (decl.canonical_formats_only === true) {\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'FORMAT_DECLARATION_V1_NOT_APPLICABLE',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n            reason: 'canonical_formats_only',\n          },\n        },\n      },\n    };\n  }\n\n  // Step 2: canonical-level structural unreachability.\n  if (!isCanonicalV1Translatable(decl.format_kind)) {\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'CANONICAL_NOT_V1_TRANSLATABLE',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n          },\n        },\n      },\n    };\n  }\n\n  // Step 3: seller-asserted v1 link — the only normative path to a\n  // specific v1 format_id. The spec normatively requires `v1_format_ref`\n  // to be an array (single-ref is `[{...}]`); multi-size SHOULD carry\n  // one entry per size.\n  //\n  // When the seller-asserted refs cover every declared size, emit all\n  // refs verbatim — no advisory needed. When refs < sizes, emit what\n  // the seller asserted (+ catalog-driven fan-out for missing sizes when\n  // available) and surface the lossy advisory so the buyer knows the\n  // v1 wire is partial-coverage. Responsive ranges (min_*/max_*) are\n  // always advisory — the v1 wire can't carry a range.\n  if (decl.v1_format_ref && decl.v1_format_ref.length > 0) {\n    const refs = decl.v1_format_ref;\n    const lossy = detectLossyMultiSize(decl);\n    if (lossy) {\n      // Sizes mode: seller asserted ≥1 ref; try to widen via catalog\n      // lookup when refs < sizes; otherwise emit seller's refs verbatim.\n      // Responsive range: refs are the seller's representative anchors;\n      // can't be widened.\n      const declaredCount = lossy.count ?? 0;\n      const sellerCoversAllSizes = lossy.mode === 'sizes' && refs.length >= declaredCount;\n      if (sellerCoversAllSizes) {\n        return { v1: refs };\n      }\n      const fanned = lossy.mode === 'sizes' && refs.length < declaredCount ? tryFanOutMultiSize(decl, refs) : null;\n      // Merge: prefer the fanned-out catalog entries when they cover more sizes\n      // than the seller's refs; otherwise emit seller's refs.\n      const emit = fanned && fanned.length > refs.length ? fanned : refs;\n      return {\n        v1: emit,\n        diagnostic: {\n          source: 'sdk',\n          sdk_id: SDK_ID,\n          field,\n          code: 'FORMAT_DECLARATION_V1_LOSSY_MULTI_SIZE',\n          error: {\n            details: {\n              format_kind: decl.format_kind,\n              product_id: productId,\n              format_option_id: decl.format_option_id,\n              size_mode: lossy.mode,\n              declared_sizes_count: lossy.count,\n              emitted_sizes_count: emit.length,\n              v1_emit_represents_size: refs[0] ? { width: refs[0].width, height: refs[0].height } : undefined,\n            },\n          },\n        },\n      };\n    }\n    return { v1: refs };\n  }\n\n  // Steps 4-6: registry lookup.\n  const result = reverseLookup(decl.format_kind, decl.params);\n  if (result.kind === 'match') {\n    // Step 4: non-normative best-effort. Documented limitation: the\n    // synthesized agent_url is implementation-defined; downstream\n    // consumers MUST NOT depend on this projection.\n    return { v1: result.v1 };\n  }\n  if (result.kind === 'ambiguous') {\n    // Step 5: family known, specific format not pickable.\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'FORMAT_DECLARATION_V1_AMBIGUOUS',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n            registry_matches: result.matchedEntries,\n          },\n        },\n      },\n    };\n  }\n  // Step 6: registry-coverage gap.\n  return {\n    diagnostic: {\n      source: 'sdk',\n      sdk_id: SDK_ID,\n      field,\n      code: 'FORMAT_PROJECTION_FAILED',\n      error: {\n        details: {\n          format_kind: decl.format_kind,\n          product_id: productId,\n          format_option_id: decl.format_option_id,\n          resolution_failure: 'no_registry_match',\n        },\n      },\n    },\n  };\n}\n\n/**\n * Project a V2 Product to a v1 Product. Drops format_options from the\n * output and rebuilds format_ids per the resolution order.\n *\n * The function always returns a Product shape so adopters can inspect\n * what got dropped via diagnostics without parallel happy/sad-path\n * branches. Caller filters out v1 Products with empty format_ids before\n * sending to a v1-only seller (the spec requires `format_ids` to have\n * minItems: 1).\n */\nexport function projectV2ProductToV1(v2: V2Product): V2ToV1Result {\n  const format_ids: V1FormatId[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n\n  for (let i = 0; i < v2.format_options.length; i++) {\n    const decl = v2.format_options[i]!;\n    const field = `products[${v2.product_id}].format_options[${i}]`;\n    const { v1, diagnostic } = projectDeclaration(decl, v2.product_id, field);\n    if (v1) {\n      if (Array.isArray(v1)) {\n        for (const id of v1) format_ids.push(id);\n      } else {\n        format_ids.push(v1);\n      }\n    }\n    if (diagnostic) diagnostics.push(diagnostic);\n  }\n\n  const { format_options: _drop, ...rest } = v2;\n  void _drop;\n  const v1Product: V1Product = {\n    ...(rest as Omit<V2Product, 'format_options'>),\n    format_ids,\n  } as V1Product;\n\n  return { v1: v1Product, diagnostics };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/v2/projection/v2-to-v1.ts"],"sourcesContent":["/**\n * v2 → v1 Product projection (the downgrade direction).\n *\n * Used when the SDK negotiated to a v1 seller for a buyer that wrote V2\n * code. The 8.0 design at `docs/development/v3.1-sdk-design.md` makes V2\n * the public mental model — adopters never see v1 vocabulary on\n * `Product` — so this is the symmetric counterpart to v1→v2 projection\n * on the read side.\n *\n * Resolution order per declaration (aligns with the normative rules in\n * `core/registries/v1-canonical-mapping.json` and the canonical schemas'\n * `v1_translatable` field):\n *\n *   1. `format_kind: \"custom\"` + `canonical_formats_only: true` → no v1\n *      emit. Seller has explicitly opted out. SDK-local diagnostic\n *      `FORMAT_DECLARATION_V1_NOT_APPLICABLE` surfaces the opt-out so\n *      v1-only buyers see why a product disappeared.\n *   2. Canonical declares `v1_translatable: false` (the 4 inherently-v2\n *      canonicals at 3.1 GA: image_carousel, sponsored_placement,\n *      responsive_creative, agent_placement) → no v1 emit. SDK-local\n *      `CANONICAL_NOT_V1_TRANSLATABLE` diagnostic. **Spec is explicit:\n *      MUST NOT emit FORMAT_PROJECTION_FAILED** — these aren't\n *      registry-coverage gaps, they're structural unreachability.\n *   3. `v1_format_ref` present → use verbatim. Seller-asserted v1↔v2\n *      pairing is the only normative path to a specific v1 `format_id`.\n *   4. Registry has invertible literal match (`format_id_glob` with no\n *      `*`, params narrow compatibly) → MAY synthesize a v1 `format_id`,\n *      but the projection is **non-normative** per the registry's\n *      direction-of-truth statement. Downstream consumers MUST NOT\n *      depend on this — and the spec explicitly notes that a synthesized\n *      `agent_url` is implementation-defined inter-SDK divergence. We\n *      do synthesize (best-effort, surfaces the registry's invertible\n *      entries) but flag the result as non-normative via the registry\n *      lookup return type.\n *   5. Registry has family-level matches (structural or wildcarded\n *      globs) but none invertible → `FORMAT_DECLARATION_V1_AMBIGUOUS`.\n *      Spec code. Seller's path: add `v1_format_ref` to disambiguate.\n *   6. Registry has no entries for this canonical (and v1_translatable\n *      is true) → `FORMAT_PROJECTION_FAILED`. Spec code. Registry-\n *      coverage gap; correctable by filing a registry PR.\n *\n * SDK identity for `sdk_id` is read from package.json at module-load\n * time so multi-hop deduplication can pin diagnostics to the SDK that\n * emitted them.\n */\n\nimport type { V2Product, V2ProductFormatDeclaration, V1Product, V1FormatId, ProjectionDiagnostic } from './types';\nimport { reverseLookup } from './registry';\nimport { isCanonicalV1Translatable } from './canonical-properties';\nimport { findCatalogEntryByCanonicalAndSize, parseSizedIdTemplate } from './catalog';\nimport { LIBRARY_VERSION } from '../../version';\nimport { legacyFormatRefsForDeclaration } from './legacy-metadata';\n\nconst SDK_ID = `@adcp/sdk@${LIBRARY_VERSION}`;\n\nexport interface CanonicalProductFormatLegacyResolutionContext {\n  source: 'product';\n  declaration: Readonly<V2ProductFormatDeclaration>;\n  productId: string;\n  field: string;\n}\n\nexport interface CanonicalCreativeFormatLegacyResolutionContext {\n  source: 'creative';\n  creative: Readonly<Record<string, unknown>>;\n  selector: Readonly<Record<string, unknown>>;\n  operation: string;\n  field: string;\n}\n\nexport interface CanonicalSelectorFormatLegacyResolutionContext {\n  source: 'selector';\n  selector: Readonly<Record<string, unknown>>;\n  operation: string;\n  field: string;\n}\n\nexport type CanonicalFormatLegacyResolutionContext =\n  | CanonicalProductFormatLegacyResolutionContext\n  | CanonicalCreativeFormatLegacyResolutionContext\n  | CanonicalSelectorFormatLegacyResolutionContext;\n\n/** Explicit canonical → legacy resolver for persisted routes the SDK cannot safely infer. */\nexport type CanonicalFormatLegacyResolver = (\n  context: CanonicalFormatLegacyResolutionContext\n) => V1FormatId | readonly V1FormatId[] | null | undefined;\n\nexport interface V2ToV1ProjectionOptions {\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver;\n}\n\nexport class CanonicalFormatLegacyResolutionError extends Error {\n  readonly name = 'CanonicalFormatLegacyResolutionError' as const;\n}\n\nfunction resolverRef(value: unknown): V1FormatId {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n    throw new CanonicalFormatLegacyResolutionError('resolver output must be a format-id object');\n  }\n  const descriptors = Object.getOwnPropertyDescriptors(value);\n  for (const descriptor of Object.values(descriptors)) {\n    if (descriptor.enumerable && !('value' in descriptor)) {\n      throw new CanonicalFormatLegacyResolutionError('resolver output must not contain enumerable accessors');\n    }\n  }\n  const read = (key: string): unknown => {\n    const descriptor = descriptors[key];\n    return descriptor && 'value' in descriptor ? descriptor.value : undefined;\n  };\n  const agentUrl = read('agent_url');\n  const id = read('id');\n  if (typeof agentUrl !== 'string' || agentUrl.length === 0 || typeof id !== 'string' || !/^[a-zA-Z0-9_-]+$/.test(id)) {\n    throw new CanonicalFormatLegacyResolutionError('resolver output has an invalid agent_url or id');\n  }\n  try {\n    new URL(agentUrl);\n  } catch {\n    throw new CanonicalFormatLegacyResolutionError('resolver output agent_url must be an absolute URI');\n  }\n  const width = read('width');\n  const height = read('height');\n  const durationMs = read('duration_ms');\n  if ((width === undefined) !== (height === undefined)) {\n    throw new CanonicalFormatLegacyResolutionError('resolver output width and height must be provided together');\n  }\n  if (width !== undefined && (!Number.isInteger(width) || (width as number) < 1)) {\n    throw new CanonicalFormatLegacyResolutionError('resolver output width must be a positive integer');\n  }\n  if (height !== undefined && (!Number.isInteger(height) || (height as number) < 1)) {\n    throw new CanonicalFormatLegacyResolutionError('resolver output height must be a positive integer');\n  }\n  if (durationMs !== undefined && (typeof durationMs !== 'number' || !Number.isFinite(durationMs) || durationMs < 1)) {\n    throw new CanonicalFormatLegacyResolutionError('resolver output duration_ms must be a positive number');\n  }\n  return {\n    agent_url: agentUrl,\n    id,\n    ...(width !== undefined ? { width: width as number, height: height as number } : {}),\n    ...(durationMs !== undefined ? { duration_ms: durationMs } : {}),\n  };\n}\n\nexport function resolveCanonicalFormatLegacyRefs(\n  resolver: CanonicalFormatLegacyResolver | undefined,\n  context: CanonicalFormatLegacyResolutionContext,\n  requireSingle = false\n): V1FormatId[] | undefined {\n  if (!resolver) return undefined;\n  let output: V1FormatId | readonly V1FormatId[] | null | undefined;\n  try {\n    output = resolver(context);\n  } catch {\n    throw new CanonicalFormatLegacyResolutionError('canonical format legacy resolver threw');\n  }\n  if (output == null) return undefined;\n  try {\n    let values: unknown[];\n    if (Array.isArray(output)) {\n      const descriptors = Object.getOwnPropertyDescriptors(output) as Record<string, PropertyDescriptor>;\n      const lengthDescriptor = descriptors['length'];\n      const length = lengthDescriptor && 'value' in lengthDescriptor ? lengthDescriptor.value : undefined;\n      if (typeof length !== 'number' || !Number.isSafeInteger(length) || length < 0) {\n        throw new CanonicalFormatLegacyResolutionError('resolver returned an invalid format-id array');\n      }\n      values = [];\n      for (let index = 0; index < length; index++) {\n        const descriptor = descriptors[String(index)];\n        if (!descriptor || !('value' in descriptor)) {\n          throw new CanonicalFormatLegacyResolutionError(\n            'resolver output arrays must be dense data-only format-id arrays'\n          );\n        }\n        values.push(descriptor.value);\n      }\n    } else {\n      values = [output];\n    }\n    if (values.length === 0 || (requireSingle && values.length !== 1)) {\n      throw new CanonicalFormatLegacyResolutionError(\n        requireSingle ? 'resolver must return exactly one format-id for a creative' : 'resolver returned no format ids'\n      );\n    }\n    const refs = values.map(resolverRef);\n    return [\n      ...new Map(\n        refs.map(ref => [\n          `${ref.agent_url}|${ref.id}|${ref.width ?? ''}|${ref.height ?? ''}|${ref.duration_ms ?? ''}`,\n          ref,\n        ])\n      ).values(),\n    ];\n  } catch (error) {\n    if (error instanceof CanonicalFormatLegacyResolutionError) throw error;\n    throw new CanonicalFormatLegacyResolutionError('canonical format legacy resolver returned unreadable output');\n  }\n}\n\nexport interface V2ToV1Result {\n  v1: V1Product;\n  diagnostics: ProjectionDiagnostic[];\n}\n\n/**\n * Inspect a v2 declaration's params for multi-size or responsive-range\n * shapes that a single v1 `format_id` can't represent. Returns the\n * detected mode + count so the caller emits the diagnostic with full\n * context. Returns null when params declare a single fixed (width,\n * height) — the case that round-trips through v1 cleanly.\n */\nfunction detectLossyMultiSize(\n  decl: V2ProductFormatDeclaration\n): { mode: 'sizes' | 'responsive_range'; count?: number } | null {\n  // Only image/html5/display_tag canonicals carry these new size modes\n  // at 3.1 GA. Other canonicals (video_*, audio_*) use their own param\n  // shapes that the v1 format_id can carry inline.\n  if (decl.format_kind !== 'image' && decl.format_kind !== 'html5' && decl.format_kind !== 'display_tag') {\n    return null;\n  }\n  const params = decl.params ?? {};\n  if (Array.isArray(params.sizes) && params.sizes.length > 1) {\n    return { mode: 'sizes', count: params.sizes.length };\n  }\n  // Responsive range mode: any of min_*/max_* present means the v1\n  // format_id (which carries exactly one width+height pair) is lossy.\n  if (\n    typeof params.min_width === 'number' ||\n    typeof params.max_width === 'number' ||\n    typeof params.min_height === 'number' ||\n    typeof params.max_height === 'number'\n  ) {\n    return { mode: 'responsive_range' };\n  }\n  return null;\n}\n\n/**\n * Try to fan out a multi-size v2 declaration to N v1 format_ids by\n * looking up each declared size in the AAO catalog. When successful,\n * v1 buyers see ALL the sizes the v2 declaration covers — not just\n * the seller-asserted rep. The spec doesn't require this (the rep +\n * lossy advisory is the minimum-bar projection) but the catalog\n * already publishes the per-size entries, so the SDK can use them\n * without inter-SDK divergence.\n *\n * Returns the fanned-out v1 ids when at least 2 sizes resolved\n * (otherwise the rep alone is fine; no value in fan-out). The lossy\n * advisory is still emitted — its details now reflect how many\n * sizes were actually covered vs declared.\n */\nfunction tryFanOutMultiSize(decl: V2ProductFormatDeclaration, v1Refs: V1FormatId[]): V1FormatId[] | null {\n  const sizes = decl.params?.sizes;\n  if (!Array.isArray(sizes) || sizes.length <= 1) return null;\n  // Parse the first seller-asserted ref's id to extract its\n  // `<prefix>_<W>x<H>_<suffix>` template, then constrain the fan-out\n  // to siblings sharing the same prefix + suffix. Otherwise multiple\n  // entries with the same `canonical:` annotation but different\n  // families (e.g., image's `display_*_image` and `display_*_generative`\n  // both annotated `canonical: image`) would collide and the SDK could\n  // emit ids from the wrong family.\n  const rep = v1Refs[0];\n  if (!rep?.id) return null;\n  const template = parseSizedIdTemplate(rep.id);\n  const lookupOpts = template ? { prefix: template.prefix, suffix: template.suffix } : undefined;\n\n  const found: V1FormatId[] = [];\n  for (const size of sizes) {\n    if (!size || typeof size !== 'object') continue;\n    const sz = size as { width?: unknown; height?: unknown };\n    if (typeof sz.width !== 'number' || typeof sz.height !== 'number') continue;\n    const entry = findCatalogEntryByCanonicalAndSize(decl.format_kind, sz.width, sz.height, rep.agent_url, lookupOpts);\n    if (entry) {\n      found.push({\n        agent_url: entry.format_id.agent_url,\n        id: entry.format_id.id,\n        width: sz.width,\n        height: sz.height,\n      });\n    }\n  }\n  return found.length >= 2 ? found : null;\n}\n\n/**\n * Project a single V2 declaration. Returns one v1 format_id (the\n * common case) OR a fanned-out list of v1 format_ids (multi-size\n * fan-out) OR a diagnostic, plus an optional advisory diagnostic\n * (multi-size loses some sizes). The structural invariant: every\n * declaration produces AT LEAST ONE of (v1 emit, diagnostic) — may\n * produce both.\n */\nfunction projectDeclaration(\n  decl: V2ProductFormatDeclaration,\n  productId: string,\n  field: string,\n  options?: V2ToV1ProjectionOptions\n): { v1?: V1FormatId | V1FormatId[]; diagnostic?: ProjectionDiagnostic } {\n  // Step 1: seller-asserted product-level opt-out. canonical_formats_only\n  // is REQUIRED on `custom` declarations without v1_format_ref, but it's\n  // ALSO valid on any non-custom canonical when the seller wants to opt\n  // out of v1 emission for this product (e.g. the catalog has no v1 entry\n  // for the format yet — `audio_daast` is the 3.1 example).\n  if (decl.canonical_formats_only === true) {\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'FORMAT_DECLARATION_V1_NOT_APPLICABLE',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n            reason: 'canonical_formats_only',\n          },\n        },\n      },\n    };\n  }\n\n  // Step 2: canonical-level structural unreachability.\n  if (!isCanonicalV1Translatable(decl.format_kind)) {\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'CANONICAL_NOT_V1_TRANSLATABLE',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n          },\n        },\n      },\n    };\n  }\n\n  // Step 3: seller-asserted v1 link — the only normative path to a\n  // specific v1 format_id. The spec normatively requires `v1_format_ref`\n  // to be an array (single-ref is `[{...}]`); multi-size SHOULD carry\n  // one entry per size.\n  //\n  // When the seller-asserted refs cover every declared size, emit all\n  // refs verbatim — no advisory needed. When refs < sizes, emit what\n  // the seller asserted (+ catalog-driven fan-out for missing sizes when\n  // available) and surface the lossy advisory so the buyer knows the\n  // v1 wire is partial-coverage. Responsive ranges (min_*/max_*) are\n  // always advisory — the v1 wire can't carry a range.\n  const declaredLegacyRefs = legacyFormatRefsForDeclaration(decl);\n  if (declaredLegacyRefs.length > 0) {\n    const refs = [...declaredLegacyRefs];\n    const lossy = detectLossyMultiSize(decl);\n    if (lossy) {\n      // Sizes mode: seller asserted ≥1 ref; try to widen via catalog\n      // lookup when refs < sizes; otherwise emit seller's refs verbatim.\n      // Responsive range: refs are the seller's representative anchors;\n      // can't be widened.\n      const declaredCount = lossy.count ?? 0;\n      const sellerCoversAllSizes = lossy.mode === 'sizes' && refs.length >= declaredCount;\n      if (sellerCoversAllSizes) {\n        return { v1: refs };\n      }\n      const fanned = lossy.mode === 'sizes' && refs.length < declaredCount ? tryFanOutMultiSize(decl, refs) : null;\n      // Merge: prefer the fanned-out catalog entries when they cover more sizes\n      // than the seller's refs; otherwise emit seller's refs.\n      const emit = fanned && fanned.length > refs.length ? fanned : refs;\n      return {\n        v1: emit,\n        diagnostic: {\n          source: 'sdk',\n          sdk_id: SDK_ID,\n          field,\n          code: 'FORMAT_DECLARATION_V1_LOSSY_MULTI_SIZE',\n          error: {\n            details: {\n              format_kind: decl.format_kind,\n              product_id: productId,\n              format_option_id: decl.format_option_id,\n              size_mode: lossy.mode,\n              declared_sizes_count: lossy.count,\n              emitted_sizes_count: emit.length,\n              v1_emit_represents_size: refs[0] ? { width: refs[0].width, height: refs[0].height } : undefined,\n            },\n          },\n        },\n      };\n    }\n    return { v1: refs };\n  }\n\n  // Steps 4-6: registry lookup.\n  const result = reverseLookup(decl.format_kind, decl.params);\n  if (result.kind === 'match') {\n    // Step 4: non-normative best-effort. Documented limitation: the\n    // synthesized agent_url is implementation-defined; downstream\n    // consumers MUST NOT depend on this projection.\n    return { v1: result.v1 };\n  }\n  try {\n    const resolved = resolveCanonicalFormatLegacyRefs(options?.canonicalFormatLegacyResolver, {\n      source: 'product',\n      declaration: decl,\n      productId,\n      field,\n    });\n    if (resolved) return { v1: resolved };\n  } catch {\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'FORMAT_PROJECTION_FAILED',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n            resolution_failure: 'custom_converter_failed',\n          },\n        },\n      },\n    };\n  }\n  if (result.kind === 'ambiguous') {\n    // Step 5: family known, specific format not pickable.\n    return {\n      diagnostic: {\n        source: 'sdk',\n        sdk_id: SDK_ID,\n        field,\n        code: 'FORMAT_DECLARATION_V1_AMBIGUOUS',\n        error: {\n          details: {\n            format_kind: decl.format_kind,\n            product_id: productId,\n            format_option_id: decl.format_option_id,\n            registry_matches: result.matchedEntries,\n          },\n        },\n      },\n    };\n  }\n  // Step 6: registry-coverage gap.\n  return {\n    diagnostic: {\n      source: 'sdk',\n      sdk_id: SDK_ID,\n      field,\n      code: 'FORMAT_PROJECTION_FAILED',\n      error: {\n        details: {\n          format_kind: decl.format_kind,\n          product_id: productId,\n          format_option_id: decl.format_option_id,\n          resolution_failure: 'no_registry_match',\n        },\n      },\n    },\n  };\n}\n\n/**\n * Project a V2 Product to a v1 Product. Drops format_options from the\n * output and rebuilds format_ids per the resolution order.\n *\n * The function always returns a Product shape so adopters can inspect\n * what got dropped via diagnostics without parallel happy/sad-path\n * branches. Caller filters out v1 Products with empty format_ids before\n * sending to a v1-only seller (the spec requires `format_ids` to have\n * minItems: 1).\n */\nexport function projectV2ProductToV1(v2: V2Product, options?: V2ToV1ProjectionOptions): V2ToV1Result {\n  const format_ids: V1FormatId[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n\n  for (let i = 0; i < v2.format_options.length; i++) {\n    const decl = v2.format_options[i]!;\n    const field = `products[${v2.product_id}].format_options[${i}]`;\n    const { v1, diagnostic } = projectDeclaration(decl, v2.product_id, field, options);\n    if (v1) {\n      if (Array.isArray(v1)) {\n        for (const id of v1) format_ids.push(id);\n      } else {\n        format_ids.push(v1);\n      }\n    }\n    if (diagnostic) diagnostics.push(diagnostic);\n  }\n\n  const { format_options: _drop, ...rest } = v2;\n  void _drop;\n  const v1Product: V1Product = {\n    ...(rest as Omit<V2Product, 'format_options'>),\n    format_ids,\n  } as V1Product;\n\n  return { v1: v1Product, diagnostics };\n}\n"],"mappings":"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","names":[]}