@adcp/sdk 12.1.0 → 13.0.0-rc.0

package/dist/lib/v2/projection/write-side.d.mts

@@ -1,21 +1,24 @@
 /**
  * Write-side ergonomics for V2-mental-model buyers.
  *
- * New beta.5+ code should use `packageRefsForFormatOptions`. It emits
- * `format_option_refs` for beta.5+ sellers plus optional legacy
- * `format_ids` for heterogeneous paths. The old capability-named exports
+ * New beta.5+ code should use `packageRefsForFormatOptions`. It emits only
+ * canonical `format_option_refs`; module-private weak storage lets the SDK
+ * downgrade at the wire boundary without exposing legacy identifiers. The old capability-named exports
  * keep the beta.3 `capability_ids` surface for callers pinned to that
  * protocol version.
  */
 import type { V1FormatId, V2ProductFormatDeclaration } from './types.mjs';
+import type { CanonicalFormatDeclaration } from './legacy-metadata.mjs';
 export type FormatOptionRef = {
     scope: 'publisher';
     publisher_domain: string;
     format_option_id: string;
+    canonical_formats_only?: true;
 } | {
     scope: 'product';
     format_option_id: string;
     publisher_domain?: never;
+    canonical_formats_only?: true;
 };
 export type FormatOptionSelector = string | {
     format_option_id: string;
@@ -23,8 +26,8 @@ export type FormatOptionSelector = string | {
 };
 /**
  * Result shape for {@link packageRefsForFormatOptions} - spread into a
- * `PackageRequest` to author a 3.1+ format-option package while keeping
- * legacy sellers working via dual emission.
+ * `PackageRequest` to author a canonical format-option package. The helper
+ * retains downgrade metadata in module-private weak storage.
  */
 export interface PackageFormatRefs {
     /**
@@ -34,12 +37,8 @@ export interface PackageFormatRefs {
      * `{ scope: 'publisher', publisher_domain, format_option_id }`.
      */
     format_option_refs: FormatOptionRef[];
-    /**
-     * Legacy named-format path. Omitted entirely when no chosen declaration
-     * has a v1 form; emitting `[]` would violate the wire schema's
-     * `minItems: 1` constraint.
-     */
-    format_ids?: V1FormatId[];
+    /** Legacy identifiers are deliberately unavailable on the canonical SDK surface. */
+    format_ids?: never;
 }
 /**
  * Beta.3 compatibility shape emitted by {@link packageRefsForCapabilities}.
@@ -88,14 +87,14 @@ export declare class CapabilityIdsLookupError extends Error {
 }
 /**
  * Resolve format option selectors against a product's `format_options[]`
- * and produce `{ format_option_refs, format_ids? }` for `PackageRequest`.
+ * and produce canonical `{ format_option_refs }` for `PackageRequest`.
  *
  * Selectors may be plain product-local IDs (`'nytimes_mrec'`) or
  * structured `{ format_option_id, publisher_domain }` selectors. Returned
  * refs are always structured per the beta.5 schema.
  */
 export declare function packageRefsForFormatOptions(product: {
-    format_options?: V2ProductFormatDeclaration[];
+    format_options?: CanonicalFormatDeclaration[];
 }, formatOptions: FormatOptionSelector[]): PackageFormatRefs;
 /**
  * Resolve beta.3 `capability_id` selectors and emit beta.3

package/dist/lib/v2/projection/write-side.d.ts

@@ -1,21 +1,24 @@
 /**
  * Write-side ergonomics for V2-mental-model buyers.
  *
- * New beta.5+ code should use `packageRefsForFormatOptions`. It emits
- * `format_option_refs` for beta.5+ sellers plus optional legacy
- * `format_ids` for heterogeneous paths. The old capability-named exports
+ * New beta.5+ code should use `packageRefsForFormatOptions`. It emits only
+ * canonical `format_option_refs`; module-private weak storage lets the SDK
+ * downgrade at the wire boundary without exposing legacy identifiers. The old capability-named exports
  * keep the beta.3 `capability_ids` surface for callers pinned to that
  * protocol version.
  */
 import type { V1FormatId, V2ProductFormatDeclaration } from './types';
+import type { CanonicalFormatDeclaration } from './legacy-metadata';
 export type FormatOptionRef = {
     scope: 'publisher';
     publisher_domain: string;
     format_option_id: string;
+    canonical_formats_only?: true;
 } | {
     scope: 'product';
     format_option_id: string;
     publisher_domain?: never;
+    canonical_formats_only?: true;
 };
 export type FormatOptionSelector = string | {
     format_option_id: string;
@@ -23,8 +26,8 @@ export type FormatOptionSelector = string | {
 };
 /**
  * Result shape for {@link packageRefsForFormatOptions} - spread into a
- * `PackageRequest` to author a 3.1+ format-option package while keeping
- * legacy sellers working via dual emission.
+ * `PackageRequest` to author a canonical format-option package. The helper
+ * retains downgrade metadata in module-private weak storage.
  */
 export interface PackageFormatRefs {
     /**
@@ -34,12 +37,8 @@ export interface PackageFormatRefs {
      * `{ scope: 'publisher', publisher_domain, format_option_id }`.
      */
     format_option_refs: FormatOptionRef[];
-    /**
-     * Legacy named-format path. Omitted entirely when no chosen declaration
-     * has a v1 form; emitting `[]` would violate the wire schema's
-     * `minItems: 1` constraint.
-     */
-    format_ids?: V1FormatId[];
+    /** Legacy identifiers are deliberately unavailable on the canonical SDK surface. */
+    format_ids?: never;
 }
 /**
  * Beta.3 compatibility shape emitted by {@link packageRefsForCapabilities}.
@@ -88,14 +87,14 @@ export declare class CapabilityIdsLookupError extends Error {
 }
 /**
  * Resolve format option selectors against a product's `format_options[]`
- * and produce `{ format_option_refs, format_ids? }` for `PackageRequest`.
+ * and produce canonical `{ format_option_refs }` for `PackageRequest`.
  *
  * Selectors may be plain product-local IDs (`'nytimes_mrec'`) or
  * structured `{ format_option_id, publisher_domain }` selectors. Returned
  * refs are always structured per the beta.5 schema.
  */
 export declare function packageRefsForFormatOptions(product: {
-    format_options?: V2ProductFormatDeclaration[];
+    format_options?: CanonicalFormatDeclaration[];
 }, formatOptions: FormatOptionSelector[]): PackageFormatRefs;
 /**
  * Resolve beta.3 `capability_id` selectors and emit beta.3

package/dist/lib/v2/projection/write-side.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-side.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/write-side.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"write-side.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/write-side.ts"],"names":[],"mappings":"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"}

package/dist/lib/v2/projection/write-side.js

@@ -29,6 +29,7 @@ __export(write_side_exports, {
 });
 module.exports = __toCommonJS(write_side_exports);
 var import_deprecation = require('../../utils/deprecation.js');
+var import_legacy_metadata = require('./legacy-metadata.js');
 class FormatOptionRefsLookupError extends Error {
   code;
   /** Format option IDs or refs the caller requested. */
@@ -75,7 +76,16 @@ function declarationToRef(decl) {
   if (!decl.format_option_id) {
     throw new Error("declarationToRef requires a declaration with format_option_id");
   }
-  return decl.publisher_domain ? { scope: "publisher", publisher_domain: decl.publisher_domain, format_option_id: decl.format_option_id } : { scope: "product", format_option_id: decl.format_option_id };
+  return decl.publisher_domain ? {
+    scope: "publisher",
+    publisher_domain: decl.publisher_domain,
+    format_option_id: decl.format_option_id,
+    ...decl.canonical_formats_only === true && { canonical_formats_only: true }
+  } : {
+    scope: "product",
+    format_option_id: decl.format_option_id,
+    ...decl.canonical_formats_only === true && { canonical_formats_only: true }
+  };
 }
 function findDeclaration(opts, selector) {
   if (typeof selector === "string") {
@@ -140,17 +150,11 @@ function packageRefsForFormatOptions(product, formatOptions) {
     seenRefs.add(key);
     format_option_refs.push(ref);
   }
-  const seen = /* @__PURE__ */ new Set();
-  const format_ids = [];
-  for (const decl of selected) {
-    for (const ref of decl.v1_format_ref ?? []) {
-      const key = `${ref.agent_url}::${ref.id}::${ref.width ?? ""}x${ref.height ?? ""}::${ref.duration_ms ?? ""}`;
-      if (seen.has(key)) continue;
-      seen.add(key);
-      format_ids.push({ ...ref });
-    }
-  }
-  return format_ids.length > 0 ? { format_option_refs, format_ids } : { format_option_refs };
+  (0, import_legacy_metadata.concealSelectedFormatOptions)(
+    format_option_refs,
+    selected.map((declaration) => (0, import_legacy_metadata.concealLegacyFormatRefs)(declaration))
+  );
+  return { format_option_refs };
 }
 function packageRefsForCapabilities(product, capabilityIds) {
   (0, import_deprecation.warnOnce)(

package/dist/lib/v2/projection/write-side.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/v2/projection/write-side.ts"],"sourcesContent":["/**\n * Write-side ergonomics for V2-mental-model buyers.\n *\n * New beta.5+ code should use `packageRefsForFormatOptions`. It emits\n * `format_option_refs` for beta.5+ sellers plus optional legacy\n * `format_ids` for heterogeneous paths. The old capability-named exports\n * keep the beta.3 `capability_ids` surface for callers pinned to that\n * protocol version.\n */\n\nimport type { V1FormatId, V2ProductFormatDeclaration } from './types';\nimport { warnOnce } from '../../utils/deprecation';\n\nexport type FormatOptionRef =\n  | { scope: 'publisher'; publisher_domain: string; format_option_id: string }\n  | { scope: 'product'; format_option_id: string; publisher_domain?: never };\n\nexport type FormatOptionSelector = string | { format_option_id: string; publisher_domain?: string };\n\n/**\n * Result shape for {@link packageRefsForFormatOptions} - spread into a\n * `PackageRequest` to author a 3.1+ format-option package while keeping\n * legacy sellers working via dual emission.\n */\nexport interface PackageFormatRefs {\n  /**\n   * 3.1+ path. Structured references to product `format_options[]`\n   * entries. Product-local options use `{ scope: 'product',\n   * format_option_id }`; publisher-catalog-backed options use\n   * `{ scope: 'publisher', publisher_domain, format_option_id }`.\n   */\n  format_option_refs: FormatOptionRef[];\n  /**\n   * Legacy named-format path. Omitted entirely when no chosen declaration\n   * has a v1 form; emitting `[]` would violate the wire schema's\n   * `minItems: 1` constraint.\n   */\n  format_ids?: V1FormatId[];\n}\n\n/**\n * Beta.3 compatibility shape emitted by {@link packageRefsForCapabilities}.\n * New beta.5 code should use {@link packageRefsForFormatOptions}; this keeps\n * callers pinned to the beta.3 capability_id/capability_ids protocol surface\n * working. Beta.5+ sellers reject `capability_ids` on PackageRequest.\n */\nexport interface PackageCapabilityRefs {\n  capability_ids: string[];\n  format_ids?: V1FormatId[];\n}\n\nexport type FormatOptionRefsLookupErrorCode =\n  | 'unknown_format_option_id'\n  | 'format_option_refs_not_published'\n  | 'empty_input'\n  | 'invalid_product';\n\nexport type CapabilityIdsLookupErrorCode =\n  | 'unknown_capability_id'\n  | 'capability_ids_not_published'\n  | 'empty_input'\n  | 'invalid_product';\n\n/**\n * Structured error from {@link packageRefsForFormatOptions}. Carries a\n * normalized `code` so adopters can branch fallback logic without\n * regex-matching the message.\n */\nexport class FormatOptionRefsLookupError extends Error {\n  readonly code: FormatOptionRefsLookupErrorCode;\n  /** Format option IDs or refs the caller requested. */\n  readonly requested: readonly string[];\n  /** Format option IDs/refs the product actually publishes (sorted). */\n  readonly available: readonly string[];\n  /** Requested entries that were not matched. */\n  readonly missing: readonly string[];\n\n  constructor(\n    code: FormatOptionRefsLookupErrorCode,\n    message: string,\n    meta: { requested: readonly string[]; available: readonly string[]; missing: readonly string[] }\n  ) {\n    super(message);\n    this.name = 'FormatOptionRefsLookupError';\n    this.code = code;\n    this.requested = meta.requested;\n    this.available = meta.available;\n    this.missing = meta.missing;\n  }\n}\n\nexport class CapabilityIdsLookupError extends Error {\n  readonly code: CapabilityIdsLookupErrorCode;\n  /** Capability IDs the caller requested. */\n  readonly requested: readonly string[];\n  /** Capability IDs the product actually publishes (sorted). */\n  readonly available: readonly string[];\n  /** Requested entries that were not matched. */\n  readonly missing: readonly string[];\n\n  constructor(\n    code: CapabilityIdsLookupErrorCode,\n    message: string,\n    meta: { requested: readonly string[]; available: readonly string[]; missing: readonly string[] }\n  ) {\n    super(message);\n    this.name = 'CapabilityIdsLookupError';\n    this.code = code;\n    this.requested = meta.requested;\n    this.available = meta.available;\n    this.missing = meta.missing;\n  }\n}\n\nfunction selectorLabel(selector: FormatOptionSelector): string {\n  if (typeof selector === 'string') return selector;\n  return selector.publisher_domain\n    ? `${selector.publisher_domain}/${selector.format_option_id}`\n    : selector.format_option_id;\n}\n\nfunction declarationLabel(decl: V2ProductFormatDeclaration): string | undefined {\n  if (!decl.format_option_id) return undefined;\n  return decl.publisher_domain ? `${decl.publisher_domain}/${decl.format_option_id}` : decl.format_option_id;\n}\n\nfunction declarationToRef(decl: V2ProductFormatDeclaration): FormatOptionRef {\n  if (!decl.format_option_id) {\n    throw new Error('declarationToRef requires a declaration with format_option_id');\n  }\n  return decl.publisher_domain\n    ? { scope: 'publisher', publisher_domain: decl.publisher_domain, format_option_id: decl.format_option_id }\n    : { scope: 'product', format_option_id: decl.format_option_id };\n}\n\nfunction findDeclaration(\n  opts: V2ProductFormatDeclaration[],\n  selector: FormatOptionSelector\n): V2ProductFormatDeclaration | undefined {\n  if (typeof selector === 'string') {\n    return opts.find(o => o.format_option_id === selector && !o.publisher_domain);\n  }\n  return opts.find(\n    o =>\n      o.format_option_id === selector.format_option_id &&\n      (selector.publisher_domain ?? '') === (o.publisher_domain ?? '')\n  );\n}\n\nfunction dedupeRefKey(ref: FormatOptionRef): string {\n  return ref.scope === 'publisher'\n    ? `publisher:${ref.publisher_domain}:${ref.format_option_id}`\n    : `product:${ref.format_option_id}`;\n}\n\n/**\n * Resolve format option selectors against a product's `format_options[]`\n * and produce `{ format_option_refs, format_ids? }` for `PackageRequest`.\n *\n * Selectors may be plain product-local IDs (`'nytimes_mrec'`) or\n * structured `{ format_option_id, publisher_domain }` selectors. Returned\n * refs are always structured per the beta.5 schema.\n */\nexport function packageRefsForFormatOptions(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  formatOptions: FormatOptionSelector[]\n): PackageFormatRefs {\n  const requested = formatOptions.map(selectorLabel);\n\n  // Guard against the common mistake of passing the products[] array.\n  if (product === null || typeof product !== 'object' || Array.isArray(product)) {\n    throw new FormatOptionRefsLookupError(\n      'invalid_product',\n      `packageRefsForFormatOptions: expected a Product object with a format_options[] field, got ${Array.isArray(product) ? 'an array (did you pass `products` instead of `products[0]`?)' : typeof product}.`,\n      { requested, available: [], missing: requested }\n    );\n  }\n  if (formatOptions.length === 0) {\n    throw new FormatOptionRefsLookupError(\n      'empty_input',\n      `packageRefsForFormatOptions requires at least one format_option_id. ` +\n        `To accept seller defaults, omit format_option_refs from the package entirely.`,\n      { requested, available: [], missing: [] }\n    );\n  }\n\n  const opts = product.format_options ?? [];\n  const addressable = opts.filter(o => Boolean(o.format_option_id));\n  const available = addressable\n    .map(declarationLabel)\n    .filter((s): s is string => Boolean(s))\n    .sort();\n  const entriesWithoutFormatOptionId = opts.length - addressable.length;\n\n  if (addressable.length === 0) {\n    const detail =\n      opts.length === 0\n        ? `product has no format_options[] (legacy-format-only product shape, or product wasn't passed through getProducts auto-augmentation)`\n        : `${opts.length} declarations on the product, ${entriesWithoutFormatOptionId} unaddressable via format_option_id (no entry publishes one)`;\n    throw new FormatOptionRefsLookupError(\n      'format_option_refs_not_published',\n      `packageRefsForFormatOptions: product publishes no format_option_id values - ${detail}. ` +\n        `The 3.1+ path is not authorable against this product. Fall back to legacyFormatIdsFromOptions ` +\n        `or skip the product for format-option sellers.`,\n      { requested, available: [], missing: requested.slice() }\n    );\n  }\n\n  const selected: V2ProductFormatDeclaration[] = [];\n  const missing: string[] = [];\n  for (const selector of formatOptions) {\n    const match = findDeclaration(addressable, selector);\n    if (match) selected.push(match);\n    else missing.push(selectorLabel(selector));\n  }\n\n  if (missing.length > 0) {\n    const trailingNote =\n      entriesWithoutFormatOptionId > 0\n        ? ` (${entriesWithoutFormatOptionId} format_options[] entries publish no format_option_id and aren't addressable via this helper - use legacyFormatIdsFromOptions for those.)`\n        : '';\n    throw new FormatOptionRefsLookupError(\n      'unknown_format_option_id',\n      `packageRefsForFormatOptions: format option selectors ${JSON.stringify(missing)} ` +\n        `not found in product.format_options[]. Available format options: ${JSON.stringify(available)}.${trailingNote}`,\n      { requested, available, missing }\n    );\n  }\n\n  const seenRefs = new Set<string>();\n  const format_option_refs: FormatOptionRef[] = [];\n  for (const decl of selected) {\n    const ref = declarationToRef(decl);\n    const key = dedupeRefKey(ref);\n    if (seenRefs.has(key)) continue;\n    seenRefs.add(key);\n    format_option_refs.push(ref);\n  }\n\n  // De-dupe v1 refs across multiple chosen declarations. Include\n  // dimensional discriminators in the key so multi-size declarations with\n  // the same `{ agent_url, id }` but different sizes survive.\n  const seen = new Set<string>();\n  const format_ids: V1FormatId[] = [];\n  for (const decl of selected) {\n    for (const ref of decl.v1_format_ref ?? []) {\n      const key = `${ref.agent_url}::${ref.id}::${ref.width ?? ''}x${ref.height ?? ''}::${ref.duration_ms ?? ''}`;\n      if (seen.has(key)) continue;\n      seen.add(key);\n      format_ids.push({ ...ref });\n    }\n  }\n\n  return format_ids.length > 0 ? { format_option_refs, format_ids } : { format_option_refs };\n}\n\n/**\n * Resolve beta.3 `capability_id` selectors and emit beta.3\n * `{ capability_ids, format_ids? }` PackageRequest fields.\n *\n * @deprecated Beta.5+ sellers reject `capability_ids` on PackageRequest. Use\n * {@link packageRefsForFormatOptions} for beta.5+ sellers.\n */\nexport function packageRefsForCapabilities(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  capabilityIds: string[]\n): PackageCapabilityRefs {\n  warnOnce(\n    'packageRefsForCapabilities.beta3-only',\n    'packageRefsForCapabilities() emits beta.3-only capability_ids. Beta.5+ sellers reject capability_ids; use packageRefsForFormatOptions() for beta.5+ package requests.'\n  );\n\n  if (product === null || typeof product !== 'object' || Array.isArray(product)) {\n    throw new CapabilityIdsLookupError(\n      'invalid_product',\n      `packageRefsForCapabilities: expected a Product object with a format_options[] field, got ${Array.isArray(product) ? 'an array (did you pass `products` instead of `products[0]`?)' : typeof product}.`,\n      { requested: capabilityIds, available: [], missing: capabilityIds }\n    );\n  }\n  if (capabilityIds.length === 0) {\n    throw new CapabilityIdsLookupError(\n      'empty_input',\n      `packageRefsForCapabilities requires at least one capability_id. ` +\n        `To accept seller defaults, omit capability_ids from the package entirely.`,\n      { requested: capabilityIds, available: [], missing: [] }\n    );\n  }\n\n  const opts = product.format_options ?? [];\n  const known = new Map<string, V2ProductFormatDeclaration>();\n  let entriesWithoutCapabilityId = 0;\n  for (const opt of opts) {\n    const id = capabilityIdForLookup(opt);\n    if (id) {\n      known.set(id, opt);\n    } else {\n      entriesWithoutCapabilityId += 1;\n    }\n  }\n  const available = [...known.keys()].sort();\n  if (known.size === 0) {\n    const detail =\n      opts.length === 0\n        ? `product has no format_options[] (legacy-format-only product shape, or product wasn't passed through getProducts auto-augmentation)`\n        : `${opts.length} declarations on the product, ${entriesWithoutCapabilityId} unaddressable via capability_id (no entry publishes one)`;\n    throw new CapabilityIdsLookupError(\n      'capability_ids_not_published',\n      `packageRefsForCapabilities: product publishes no capability_ids - ${detail}. ` +\n        `The beta.3 path is not authorable against this product. Fall back to legacyFormatIdsFromOptions ` +\n        `or skip the product for capability_id sellers.`,\n      { requested: capabilityIds, available: [], missing: capabilityIds.slice() }\n    );\n  }\n\n  const missing = capabilityIds.filter(id => !known.has(id));\n  if (missing.length > 0) {\n    const trailingNote =\n      entriesWithoutCapabilityId > 0\n        ? ` (${entriesWithoutCapabilityId} format_options[] entries publish no capability_id and aren't addressable via this helper - use legacyFormatIdsFromOptions for those.)`\n        : '';\n    throw new CapabilityIdsLookupError(\n      'unknown_capability_id',\n      `packageRefsForCapabilities: capability_ids ${JSON.stringify(missing)} ` +\n        `not found in product.format_options[]. Available capability_ids: ${JSON.stringify(available)}.${trailingNote}`,\n      { requested: capabilityIds, available, missing }\n    );\n  }\n\n  const seenCapabilities = new Set<string>();\n  const dedupedCapabilityIds: string[] = [];\n  for (const id of capabilityIds) {\n    if (seenCapabilities.has(id)) continue;\n    seenCapabilities.add(id);\n    dedupedCapabilityIds.push(id);\n  }\n\n  const seen = new Set<string>();\n  const format_ids: V1FormatId[] = [];\n  for (const id of dedupedCapabilityIds) {\n    const decl = known.get(id)!;\n    for (const ref of decl.v1_format_ref ?? []) {\n      const key = `${ref.agent_url}::${ref.id}::${ref.width ?? ''}x${ref.height ?? ''}::${ref.duration_ms ?? ''}`;\n      if (seen.has(key)) continue;\n      seen.add(key);\n      format_ids.push({ ...ref });\n    }\n  }\n\n  return format_ids.length > 0\n    ? { capability_ids: dedupedCapabilityIds, format_ids }\n    : { capability_ids: dedupedCapabilityIds };\n}\n\n/**\n * Extract the legacy `format_ids[]` for a chosen V2 declaration.\n * Throws when the declaration has no v1 form.\n */\nexport function legacyFormatIdsFromOptions(decl: V2ProductFormatDeclaration): V1FormatId[] {\n  const ids = tryLegacyFormatIdsFromOptions(decl);\n  if (ids.length === 0) {\n    const label = decl.format_option_id ?? decl.capability_id ?? decl.format_kind ?? '<unnamed>';\n    const reason = decl.canonical_formats_only\n      ? 'declaration is canonical_formats_only (seller opted out of v1 emission)'\n      : `declaration carries no v1_format_ref[] (likely an inherently-v2 canonical like sponsored_placement / agent_placement / image_carousel / responsive_creative, or a custom shape without v1)`;\n    throw new Error(\n      `legacyFormatIdsFromOptions: '${label}' has no v1 representation - ${reason}. ` +\n        `Pick a different format_options[] entry or skip this product for v1 sellers. ` +\n        `Use tryLegacyFormatIdsFromOptions() if you want a non-throwing variant.`\n    );\n  }\n  return ids;\n}\n\n/**\n * Non-throwing variant of {@link legacyFormatIdsFromOptions}. Returns\n * `[]` when the declaration has no v1 form.\n */\nexport function tryLegacyFormatIdsFromOptions(decl: V2ProductFormatDeclaration): V1FormatId[] {\n  if (decl.v1_format_ref && decl.v1_format_ref.length > 0) {\n    return decl.v1_format_ref.map(ref => ({ ...ref }));\n  }\n  return [];\n}\n\n/**\n * Resolve a `format_option_id` to its legacy `format_ids[]` against a\n * product's `format_options[]`.\n */\nexport function legacyFormatIdsForFormatOption(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  formatOption: FormatOptionSelector\n): V1FormatId[] {\n  const opts = product.format_options ?? [];\n  const match = findDeclaration(opts, formatOption);\n  if (!match) {\n    const declared = opts.map(declarationLabel).filter((s): s is string => Boolean(s));\n    throw new Error(\n      `format option selector ${JSON.stringify(selectorLabel(formatOption))} not found in product.format_options[] ` +\n        `(declared format options: ${declared.length > 0 ? JSON.stringify(declared) : '<none>'})`\n    );\n  }\n  return legacyFormatIdsFromOptions(match);\n}\n\n/**\n * Compatibility alias for callers using the beta.3 helper name.\n *\n * @deprecated Emits beta.3-only `capability_ids`. Beta.5+ sellers reject that\n * field. Use {@link packageRefsForFormatOptions} for beta.5+ package requests.\n */\nexport function legacyFormatIdsForCapability(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  capabilityId: string\n): V1FormatId[] {\n  const opts = product.format_options ?? [];\n  const match = opts.find(o => capabilityId === capabilityIdForLookup(o));\n  if (!match) {\n    const declared = opts.map(capabilityIdForLookup).filter((s): s is string => Boolean(s));\n    throw new Error(\n      `capability_id ${JSON.stringify(capabilityId)} not found in product.format_options[] ` +\n        `(declared capability_ids: ${declared.length > 0 ? JSON.stringify(declared) : '<none>'})`\n    );\n  }\n  return legacyFormatIdsFromOptions(match);\n}\n\nfunction capabilityIdForLookup(decl: V2ProductFormatDeclaration): string | undefined {\n  // Migration alias: beta.3 catalogs used capability_id, beta.5 catalogs use\n  // format_option_id. This beta.3 read path accepts either field so pinned\n  // callers can bridge mixed catalog fixtures while they migrate.\n  return decl.capability_id ?? decl.format_option_id;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/v2/projection/write-side.ts"],"sourcesContent":["/**\n * Write-side ergonomics for V2-mental-model buyers.\n *\n * New beta.5+ code should use `packageRefsForFormatOptions`. It emits only\n * canonical `format_option_refs`; module-private weak storage lets the SDK\n * downgrade at the wire boundary without exposing legacy identifiers. The old capability-named exports\n * keep the beta.3 `capability_ids` surface for callers pinned to that\n * protocol version.\n */\n\nimport type { V1FormatId, V2ProductFormatDeclaration } from './types';\nimport { warnOnce } from '../../utils/deprecation';\nimport { concealLegacyFormatRefs, concealSelectedFormatOptions } from './legacy-metadata';\nimport type { CanonicalFormatDeclaration } from './legacy-metadata';\n\nexport type FormatOptionRef =\n  | {\n      scope: 'publisher';\n      publisher_domain: string;\n      format_option_id: string;\n      canonical_formats_only?: true;\n    }\n  | { scope: 'product'; format_option_id: string; publisher_domain?: never; canonical_formats_only?: true };\n\nexport type FormatOptionSelector = string | { format_option_id: string; publisher_domain?: string };\n\n/**\n * Result shape for {@link packageRefsForFormatOptions} - spread into a\n * `PackageRequest` to author a canonical format-option package. The helper\n * retains downgrade metadata in module-private weak storage.\n */\nexport interface PackageFormatRefs {\n  /**\n   * 3.1+ path. Structured references to product `format_options[]`\n   * entries. Product-local options use `{ scope: 'product',\n   * format_option_id }`; publisher-catalog-backed options use\n   * `{ scope: 'publisher', publisher_domain, format_option_id }`.\n   */\n  format_option_refs: FormatOptionRef[];\n  /** Legacy identifiers are deliberately unavailable on the canonical SDK surface. */\n  format_ids?: never;\n}\n\n/**\n * Beta.3 compatibility shape emitted by {@link packageRefsForCapabilities}.\n * New beta.5 code should use {@link packageRefsForFormatOptions}; this keeps\n * callers pinned to the beta.3 capability_id/capability_ids protocol surface\n * working. Beta.5+ sellers reject `capability_ids` on PackageRequest.\n */\nexport interface PackageCapabilityRefs {\n  capability_ids: string[];\n  format_ids?: V1FormatId[];\n}\n\nexport type FormatOptionRefsLookupErrorCode =\n  | 'unknown_format_option_id'\n  | 'format_option_refs_not_published'\n  | 'empty_input'\n  | 'invalid_product';\n\nexport type CapabilityIdsLookupErrorCode =\n  | 'unknown_capability_id'\n  | 'capability_ids_not_published'\n  | 'empty_input'\n  | 'invalid_product';\n\n/**\n * Structured error from {@link packageRefsForFormatOptions}. Carries a\n * normalized `code` so adopters can branch fallback logic without\n * regex-matching the message.\n */\nexport class FormatOptionRefsLookupError extends Error {\n  readonly code: FormatOptionRefsLookupErrorCode;\n  /** Format option IDs or refs the caller requested. */\n  readonly requested: readonly string[];\n  /** Format option IDs/refs the product actually publishes (sorted). */\n  readonly available: readonly string[];\n  /** Requested entries that were not matched. */\n  readonly missing: readonly string[];\n\n  constructor(\n    code: FormatOptionRefsLookupErrorCode,\n    message: string,\n    meta: { requested: readonly string[]; available: readonly string[]; missing: readonly string[] }\n  ) {\n    super(message);\n    this.name = 'FormatOptionRefsLookupError';\n    this.code = code;\n    this.requested = meta.requested;\n    this.available = meta.available;\n    this.missing = meta.missing;\n  }\n}\n\nexport class CapabilityIdsLookupError extends Error {\n  readonly code: CapabilityIdsLookupErrorCode;\n  /** Capability IDs the caller requested. */\n  readonly requested: readonly string[];\n  /** Capability IDs the product actually publishes (sorted). */\n  readonly available: readonly string[];\n  /** Requested entries that were not matched. */\n  readonly missing: readonly string[];\n\n  constructor(\n    code: CapabilityIdsLookupErrorCode,\n    message: string,\n    meta: { requested: readonly string[]; available: readonly string[]; missing: readonly string[] }\n  ) {\n    super(message);\n    this.name = 'CapabilityIdsLookupError';\n    this.code = code;\n    this.requested = meta.requested;\n    this.available = meta.available;\n    this.missing = meta.missing;\n  }\n}\n\nfunction selectorLabel(selector: FormatOptionSelector): string {\n  if (typeof selector === 'string') return selector;\n  return selector.publisher_domain\n    ? `${selector.publisher_domain}/${selector.format_option_id}`\n    : selector.format_option_id;\n}\n\ntype SelectableFormatDeclaration = {\n  format_option_id?: string;\n  publisher_domain?: string;\n};\n\nfunction declarationLabel(decl: SelectableFormatDeclaration): string | undefined {\n  if (!decl.format_option_id) return undefined;\n  return decl.publisher_domain ? `${decl.publisher_domain}/${decl.format_option_id}` : decl.format_option_id;\n}\n\nfunction declarationToRef(decl: SelectableFormatDeclaration & { canonical_formats_only?: boolean }): FormatOptionRef {\n  if (!decl.format_option_id) {\n    throw new Error('declarationToRef requires a declaration with format_option_id');\n  }\n  return decl.publisher_domain\n    ? {\n        scope: 'publisher',\n        publisher_domain: decl.publisher_domain,\n        format_option_id: decl.format_option_id,\n        ...(decl.canonical_formats_only === true && { canonical_formats_only: true as const }),\n      }\n    : {\n        scope: 'product',\n        format_option_id: decl.format_option_id,\n        ...(decl.canonical_formats_only === true && { canonical_formats_only: true as const }),\n      };\n}\n\nfunction findDeclaration<T extends SelectableFormatDeclaration>(\n  opts: T[],\n  selector: FormatOptionSelector\n): T | undefined {\n  if (typeof selector === 'string') {\n    return opts.find(o => o.format_option_id === selector && !o.publisher_domain);\n  }\n  return opts.find(\n    o =>\n      o.format_option_id === selector.format_option_id &&\n      (selector.publisher_domain ?? '') === (o.publisher_domain ?? '')\n  );\n}\n\nfunction dedupeRefKey(ref: FormatOptionRef): string {\n  return ref.scope === 'publisher'\n    ? `publisher:${ref.publisher_domain}:${ref.format_option_id}`\n    : `product:${ref.format_option_id}`;\n}\n\n/**\n * Resolve format option selectors against a product's `format_options[]`\n * and produce canonical `{ format_option_refs }` for `PackageRequest`.\n *\n * Selectors may be plain product-local IDs (`'nytimes_mrec'`) or\n * structured `{ format_option_id, publisher_domain }` selectors. Returned\n * refs are always structured per the beta.5 schema.\n */\nexport function packageRefsForFormatOptions(\n  product: { format_options?: CanonicalFormatDeclaration[] },\n  formatOptions: FormatOptionSelector[]\n): PackageFormatRefs {\n  const requested = formatOptions.map(selectorLabel);\n\n  // Guard against the common mistake of passing the products[] array.\n  if (product === null || typeof product !== 'object' || Array.isArray(product)) {\n    throw new FormatOptionRefsLookupError(\n      'invalid_product',\n      `packageRefsForFormatOptions: expected a Product object with a format_options[] field, got ${Array.isArray(product) ? 'an array (did you pass `products` instead of `products[0]`?)' : typeof product}.`,\n      { requested, available: [], missing: requested }\n    );\n  }\n  if (formatOptions.length === 0) {\n    throw new FormatOptionRefsLookupError(\n      'empty_input',\n      `packageRefsForFormatOptions requires at least one format_option_id. ` +\n        `To accept seller defaults, omit format_option_refs from the package entirely.`,\n      { requested, available: [], missing: [] }\n    );\n  }\n\n  const opts = product.format_options ?? [];\n  const addressable = opts.filter(o => Boolean(o.format_option_id));\n  const available = addressable\n    .map(declarationLabel)\n    .filter((s): s is string => Boolean(s))\n    .sort();\n  const entriesWithoutFormatOptionId = opts.length - addressable.length;\n\n  if (addressable.length === 0) {\n    const detail =\n      opts.length === 0\n        ? `product has no format_options[] (legacy-format-only product shape, or product wasn't passed through getProducts auto-augmentation)`\n        : `${opts.length} declarations on the product, ${entriesWithoutFormatOptionId} unaddressable via format_option_id (no entry publishes one)`;\n    throw new FormatOptionRefsLookupError(\n      'format_option_refs_not_published',\n      `packageRefsForFormatOptions: product publishes no format_option_id values - ${detail}. ` +\n        `The 3.1+ path is not authorable against this product. Fall back to legacyFormatIdsFromOptions ` +\n        `or skip the product for format-option sellers.`,\n      { requested, available: [], missing: requested.slice() }\n    );\n  }\n\n  const selected: CanonicalFormatDeclaration[] = [];\n  const missing: string[] = [];\n  for (const selector of formatOptions) {\n    const match = findDeclaration(addressable, selector);\n    if (match) selected.push(match);\n    else missing.push(selectorLabel(selector));\n  }\n\n  if (missing.length > 0) {\n    const trailingNote =\n      entriesWithoutFormatOptionId > 0\n        ? ` (${entriesWithoutFormatOptionId} format_options[] entries publish no format_option_id and aren't addressable via this helper - use legacyFormatIdsFromOptions for those.)`\n        : '';\n    throw new FormatOptionRefsLookupError(\n      'unknown_format_option_id',\n      `packageRefsForFormatOptions: format option selectors ${JSON.stringify(missing)} ` +\n        `not found in product.format_options[]. Available format options: ${JSON.stringify(available)}.${trailingNote}`,\n      { requested, available, missing }\n    );\n  }\n\n  const seenRefs = new Set<string>();\n  const format_option_refs: FormatOptionRef[] = [];\n  for (const decl of selected) {\n    const ref = declarationToRef(decl);\n    const key = dedupeRefKey(ref);\n    if (seenRefs.has(key)) continue;\n    seenRefs.add(key);\n    format_option_refs.push(ref);\n  }\n\n  concealSelectedFormatOptions(\n    format_option_refs,\n    selected.map(declaration => concealLegacyFormatRefs(declaration))\n  );\n  return { format_option_refs };\n}\n\n/**\n * Resolve beta.3 `capability_id` selectors and emit beta.3\n * `{ capability_ids, format_ids? }` PackageRequest fields.\n *\n * @deprecated Beta.5+ sellers reject `capability_ids` on PackageRequest. Use\n * {@link packageRefsForFormatOptions} for beta.5+ sellers.\n */\nexport function packageRefsForCapabilities(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  capabilityIds: string[]\n): PackageCapabilityRefs {\n  warnOnce(\n    'packageRefsForCapabilities.beta3-only',\n    'packageRefsForCapabilities() emits beta.3-only capability_ids. Beta.5+ sellers reject capability_ids; use packageRefsForFormatOptions() for beta.5+ package requests.'\n  );\n\n  if (product === null || typeof product !== 'object' || Array.isArray(product)) {\n    throw new CapabilityIdsLookupError(\n      'invalid_product',\n      `packageRefsForCapabilities: expected a Product object with a format_options[] field, got ${Array.isArray(product) ? 'an array (did you pass `products` instead of `products[0]`?)' : typeof product}.`,\n      { requested: capabilityIds, available: [], missing: capabilityIds }\n    );\n  }\n  if (capabilityIds.length === 0) {\n    throw new CapabilityIdsLookupError(\n      'empty_input',\n      `packageRefsForCapabilities requires at least one capability_id. ` +\n        `To accept seller defaults, omit capability_ids from the package entirely.`,\n      { requested: capabilityIds, available: [], missing: [] }\n    );\n  }\n\n  const opts = product.format_options ?? [];\n  const known = new Map<string, V2ProductFormatDeclaration>();\n  let entriesWithoutCapabilityId = 0;\n  for (const opt of opts) {\n    const id = capabilityIdForLookup(opt);\n    if (id) {\n      known.set(id, opt);\n    } else {\n      entriesWithoutCapabilityId += 1;\n    }\n  }\n  const available = [...known.keys()].sort();\n  if (known.size === 0) {\n    const detail =\n      opts.length === 0\n        ? `product has no format_options[] (legacy-format-only product shape, or product wasn't passed through getProducts auto-augmentation)`\n        : `${opts.length} declarations on the product, ${entriesWithoutCapabilityId} unaddressable via capability_id (no entry publishes one)`;\n    throw new CapabilityIdsLookupError(\n      'capability_ids_not_published',\n      `packageRefsForCapabilities: product publishes no capability_ids - ${detail}. ` +\n        `The beta.3 path is not authorable against this product. Fall back to legacyFormatIdsFromOptions ` +\n        `or skip the product for capability_id sellers.`,\n      { requested: capabilityIds, available: [], missing: capabilityIds.slice() }\n    );\n  }\n\n  const missing = capabilityIds.filter(id => !known.has(id));\n  if (missing.length > 0) {\n    const trailingNote =\n      entriesWithoutCapabilityId > 0\n        ? ` (${entriesWithoutCapabilityId} format_options[] entries publish no capability_id and aren't addressable via this helper - use legacyFormatIdsFromOptions for those.)`\n        : '';\n    throw new CapabilityIdsLookupError(\n      'unknown_capability_id',\n      `packageRefsForCapabilities: capability_ids ${JSON.stringify(missing)} ` +\n        `not found in product.format_options[]. Available capability_ids: ${JSON.stringify(available)}.${trailingNote}`,\n      { requested: capabilityIds, available, missing }\n    );\n  }\n\n  const seenCapabilities = new Set<string>();\n  const dedupedCapabilityIds: string[] = [];\n  for (const id of capabilityIds) {\n    if (seenCapabilities.has(id)) continue;\n    seenCapabilities.add(id);\n    dedupedCapabilityIds.push(id);\n  }\n\n  const seen = new Set<string>();\n  const format_ids: V1FormatId[] = [];\n  for (const id of dedupedCapabilityIds) {\n    const decl = known.get(id)!;\n    for (const ref of decl.v1_format_ref ?? []) {\n      const key = `${ref.agent_url}::${ref.id}::${ref.width ?? ''}x${ref.height ?? ''}::${ref.duration_ms ?? ''}`;\n      if (seen.has(key)) continue;\n      seen.add(key);\n      format_ids.push({ ...ref });\n    }\n  }\n\n  return format_ids.length > 0\n    ? { capability_ids: dedupedCapabilityIds, format_ids }\n    : { capability_ids: dedupedCapabilityIds };\n}\n\n/**\n * Extract the legacy `format_ids[]` for a chosen V2 declaration.\n * Throws when the declaration has no v1 form.\n */\nexport function legacyFormatIdsFromOptions(decl: V2ProductFormatDeclaration): V1FormatId[] {\n  const ids = tryLegacyFormatIdsFromOptions(decl);\n  if (ids.length === 0) {\n    const label = decl.format_option_id ?? decl.capability_id ?? decl.format_kind ?? '<unnamed>';\n    const reason = decl.canonical_formats_only\n      ? 'declaration is canonical_formats_only (seller opted out of v1 emission)'\n      : `declaration carries no v1_format_ref[] (likely an inherently-v2 canonical like sponsored_placement / agent_placement / image_carousel / responsive_creative, or a custom shape without v1)`;\n    throw new Error(\n      `legacyFormatIdsFromOptions: '${label}' has no v1 representation - ${reason}. ` +\n        `Pick a different format_options[] entry or skip this product for v1 sellers. ` +\n        `Use tryLegacyFormatIdsFromOptions() if you want a non-throwing variant.`\n    );\n  }\n  return ids;\n}\n\n/**\n * Non-throwing variant of {@link legacyFormatIdsFromOptions}. Returns\n * `[]` when the declaration has no v1 form.\n */\nexport function tryLegacyFormatIdsFromOptions(decl: V2ProductFormatDeclaration): V1FormatId[] {\n  if (decl.v1_format_ref && decl.v1_format_ref.length > 0) {\n    return decl.v1_format_ref.map(ref => ({ ...ref }));\n  }\n  return [];\n}\n\n/**\n * Resolve a `format_option_id` to its legacy `format_ids[]` against a\n * product's `format_options[]`.\n */\nexport function legacyFormatIdsForFormatOption(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  formatOption: FormatOptionSelector\n): V1FormatId[] {\n  const opts = product.format_options ?? [];\n  const match = findDeclaration(opts, formatOption);\n  if (!match) {\n    const declared = opts.map(declarationLabel).filter((s): s is string => Boolean(s));\n    throw new Error(\n      `format option selector ${JSON.stringify(selectorLabel(formatOption))} not found in product.format_options[] ` +\n        `(declared format options: ${declared.length > 0 ? JSON.stringify(declared) : '<none>'})`\n    );\n  }\n  return legacyFormatIdsFromOptions(match);\n}\n\n/**\n * Compatibility alias for callers using the beta.3 helper name.\n *\n * @deprecated Emits beta.3-only `capability_ids`. Beta.5+ sellers reject that\n * field. Use {@link packageRefsForFormatOptions} for beta.5+ package requests.\n */\nexport function legacyFormatIdsForCapability(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  capabilityId: string\n): V1FormatId[] {\n  const opts = product.format_options ?? [];\n  const match = opts.find(o => capabilityId === capabilityIdForLookup(o));\n  if (!match) {\n    const declared = opts.map(capabilityIdForLookup).filter((s): s is string => Boolean(s));\n    throw new Error(\n      `capability_id ${JSON.stringify(capabilityId)} not found in product.format_options[] ` +\n        `(declared capability_ids: ${declared.length > 0 ? JSON.stringify(declared) : '<none>'})`\n    );\n  }\n  return legacyFormatIdsFromOptions(match);\n}\n\nfunction capabilityIdForLookup(decl: V2ProductFormatDeclaration): string | undefined {\n  // Migration alias: beta.3 catalogs used capability_id, beta.5 catalogs use\n  // format_option_id. This beta.3 read path accepts either field so pinned\n  // callers can bridge mixed catalog fixtures while they migrate.\n  return decl.capability_id ?? decl.format_option_id;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/v2/projection/write-side.mjs

@@ -1,4 +1,5 @@
 import { warnOnce } from "../../utils/deprecation.mjs";
+import { concealLegacyFormatRefs, concealSelectedFormatOptions } from "./legacy-metadata.mjs";
 class FormatOptionRefsLookupError extends Error {
   code;
   /** Format option IDs or refs the caller requested. */
@@ -45,7 +46,16 @@ function declarationToRef(decl) {
   if (!decl.format_option_id) {
     throw new Error("declarationToRef requires a declaration with format_option_id");
   }
-  return decl.publisher_domain ? { scope: "publisher", publisher_domain: decl.publisher_domain, format_option_id: decl.format_option_id } : { scope: "product", format_option_id: decl.format_option_id };
+  return decl.publisher_domain ? {
+    scope: "publisher",
+    publisher_domain: decl.publisher_domain,
+    format_option_id: decl.format_option_id,
+    ...decl.canonical_formats_only === true && { canonical_formats_only: true }
+  } : {
+    scope: "product",
+    format_option_id: decl.format_option_id,
+    ...decl.canonical_formats_only === true && { canonical_formats_only: true }
+  };
 }
 function findDeclaration(opts, selector) {
   if (typeof selector === "string") {
@@ -110,17 +120,11 @@ function packageRefsForFormatOptions(product, formatOptions) {
     seenRefs.add(key);
     format_option_refs.push(ref);
   }
-  const seen = /* @__PURE__ */ new Set();
-  const format_ids = [];
-  for (const decl of selected) {
-    for (const ref of decl.v1_format_ref ?? []) {
-      const key = `${ref.agent_url}::${ref.id}::${ref.width ?? ""}x${ref.height ?? ""}::${ref.duration_ms ?? ""}`;
-      if (seen.has(key)) continue;
-      seen.add(key);
-      format_ids.push({ ...ref });
-    }
-  }
-  return format_ids.length > 0 ? { format_option_refs, format_ids } : { format_option_refs };
+  concealSelectedFormatOptions(
+    format_option_refs,
+    selected.map((declaration) => concealLegacyFormatRefs(declaration))
+  );
+  return { format_option_refs };
 }
 function packageRefsForCapabilities(product, capabilityIds) {
   warnOnce(

package/dist/lib/v2/projection/write-side.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/v2/projection/write-side.ts"],"sourcesContent":["/**\n * Write-side ergonomics for V2-mental-model buyers.\n *\n * New beta.5+ code should use `packageRefsForFormatOptions`. It emits\n * `format_option_refs` for beta.5+ sellers plus optional legacy\n * `format_ids` for heterogeneous paths. The old capability-named exports\n * keep the beta.3 `capability_ids` surface for callers pinned to that\n * protocol version.\n */\n\nimport type { V1FormatId, V2ProductFormatDeclaration } from './types';\nimport { warnOnce } from '../../utils/deprecation';\n\nexport type FormatOptionRef =\n  | { scope: 'publisher'; publisher_domain: string; format_option_id: string }\n  | { scope: 'product'; format_option_id: string; publisher_domain?: never };\n\nexport type FormatOptionSelector = string | { format_option_id: string; publisher_domain?: string };\n\n/**\n * Result shape for {@link packageRefsForFormatOptions} - spread into a\n * `PackageRequest` to author a 3.1+ format-option package while keeping\n * legacy sellers working via dual emission.\n */\nexport interface PackageFormatRefs {\n  /**\n   * 3.1+ path. Structured references to product `format_options[]`\n   * entries. Product-local options use `{ scope: 'product',\n   * format_option_id }`; publisher-catalog-backed options use\n   * `{ scope: 'publisher', publisher_domain, format_option_id }`.\n   */\n  format_option_refs: FormatOptionRef[];\n  /**\n   * Legacy named-format path. Omitted entirely when no chosen declaration\n   * has a v1 form; emitting `[]` would violate the wire schema's\n   * `minItems: 1` constraint.\n   */\n  format_ids?: V1FormatId[];\n}\n\n/**\n * Beta.3 compatibility shape emitted by {@link packageRefsForCapabilities}.\n * New beta.5 code should use {@link packageRefsForFormatOptions}; this keeps\n * callers pinned to the beta.3 capability_id/capability_ids protocol surface\n * working. Beta.5+ sellers reject `capability_ids` on PackageRequest.\n */\nexport interface PackageCapabilityRefs {\n  capability_ids: string[];\n  format_ids?: V1FormatId[];\n}\n\nexport type FormatOptionRefsLookupErrorCode =\n  | 'unknown_format_option_id'\n  | 'format_option_refs_not_published'\n  | 'empty_input'\n  | 'invalid_product';\n\nexport type CapabilityIdsLookupErrorCode =\n  | 'unknown_capability_id'\n  | 'capability_ids_not_published'\n  | 'empty_input'\n  | 'invalid_product';\n\n/**\n * Structured error from {@link packageRefsForFormatOptions}. Carries a\n * normalized `code` so adopters can branch fallback logic without\n * regex-matching the message.\n */\nexport class FormatOptionRefsLookupError extends Error {\n  readonly code: FormatOptionRefsLookupErrorCode;\n  /** Format option IDs or refs the caller requested. */\n  readonly requested: readonly string[];\n  /** Format option IDs/refs the product actually publishes (sorted). */\n  readonly available: readonly string[];\n  /** Requested entries that were not matched. */\n  readonly missing: readonly string[];\n\n  constructor(\n    code: FormatOptionRefsLookupErrorCode,\n    message: string,\n    meta: { requested: readonly string[]; available: readonly string[]; missing: readonly string[] }\n  ) {\n    super(message);\n    this.name = 'FormatOptionRefsLookupError';\n    this.code = code;\n    this.requested = meta.requested;\n    this.available = meta.available;\n    this.missing = meta.missing;\n  }\n}\n\nexport class CapabilityIdsLookupError extends Error {\n  readonly code: CapabilityIdsLookupErrorCode;\n  /** Capability IDs the caller requested. */\n  readonly requested: readonly string[];\n  /** Capability IDs the product actually publishes (sorted). */\n  readonly available: readonly string[];\n  /** Requested entries that were not matched. */\n  readonly missing: readonly string[];\n\n  constructor(\n    code: CapabilityIdsLookupErrorCode,\n    message: string,\n    meta: { requested: readonly string[]; available: readonly string[]; missing: readonly string[] }\n  ) {\n    super(message);\n    this.name = 'CapabilityIdsLookupError';\n    this.code = code;\n    this.requested = meta.requested;\n    this.available = meta.available;\n    this.missing = meta.missing;\n  }\n}\n\nfunction selectorLabel(selector: FormatOptionSelector): string {\n  if (typeof selector === 'string') return selector;\n  return selector.publisher_domain\n    ? `${selector.publisher_domain}/${selector.format_option_id}`\n    : selector.format_option_id;\n}\n\nfunction declarationLabel(decl: V2ProductFormatDeclaration): string | undefined {\n  if (!decl.format_option_id) return undefined;\n  return decl.publisher_domain ? `${decl.publisher_domain}/${decl.format_option_id}` : decl.format_option_id;\n}\n\nfunction declarationToRef(decl: V2ProductFormatDeclaration): FormatOptionRef {\n  if (!decl.format_option_id) {\n    throw new Error('declarationToRef requires a declaration with format_option_id');\n  }\n  return decl.publisher_domain\n    ? { scope: 'publisher', publisher_domain: decl.publisher_domain, format_option_id: decl.format_option_id }\n    : { scope: 'product', format_option_id: decl.format_option_id };\n}\n\nfunction findDeclaration(\n  opts: V2ProductFormatDeclaration[],\n  selector: FormatOptionSelector\n): V2ProductFormatDeclaration | undefined {\n  if (typeof selector === 'string') {\n    return opts.find(o => o.format_option_id === selector && !o.publisher_domain);\n  }\n  return opts.find(\n    o =>\n      o.format_option_id === selector.format_option_id &&\n      (selector.publisher_domain ?? '') === (o.publisher_domain ?? '')\n  );\n}\n\nfunction dedupeRefKey(ref: FormatOptionRef): string {\n  return ref.scope === 'publisher'\n    ? `publisher:${ref.publisher_domain}:${ref.format_option_id}`\n    : `product:${ref.format_option_id}`;\n}\n\n/**\n * Resolve format option selectors against a product's `format_options[]`\n * and produce `{ format_option_refs, format_ids? }` for `PackageRequest`.\n *\n * Selectors may be plain product-local IDs (`'nytimes_mrec'`) or\n * structured `{ format_option_id, publisher_domain }` selectors. Returned\n * refs are always structured per the beta.5 schema.\n */\nexport function packageRefsForFormatOptions(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  formatOptions: FormatOptionSelector[]\n): PackageFormatRefs {\n  const requested = formatOptions.map(selectorLabel);\n\n  // Guard against the common mistake of passing the products[] array.\n  if (product === null || typeof product !== 'object' || Array.isArray(product)) {\n    throw new FormatOptionRefsLookupError(\n      'invalid_product',\n      `packageRefsForFormatOptions: expected a Product object with a format_options[] field, got ${Array.isArray(product) ? 'an array (did you pass `products` instead of `products[0]`?)' : typeof product}.`,\n      { requested, available: [], missing: requested }\n    );\n  }\n  if (formatOptions.length === 0) {\n    throw new FormatOptionRefsLookupError(\n      'empty_input',\n      `packageRefsForFormatOptions requires at least one format_option_id. ` +\n        `To accept seller defaults, omit format_option_refs from the package entirely.`,\n      { requested, available: [], missing: [] }\n    );\n  }\n\n  const opts = product.format_options ?? [];\n  const addressable = opts.filter(o => Boolean(o.format_option_id));\n  const available = addressable\n    .map(declarationLabel)\n    .filter((s): s is string => Boolean(s))\n    .sort();\n  const entriesWithoutFormatOptionId = opts.length - addressable.length;\n\n  if (addressable.length === 0) {\n    const detail =\n      opts.length === 0\n        ? `product has no format_options[] (legacy-format-only product shape, or product wasn't passed through getProducts auto-augmentation)`\n        : `${opts.length} declarations on the product, ${entriesWithoutFormatOptionId} unaddressable via format_option_id (no entry publishes one)`;\n    throw new FormatOptionRefsLookupError(\n      'format_option_refs_not_published',\n      `packageRefsForFormatOptions: product publishes no format_option_id values - ${detail}. ` +\n        `The 3.1+ path is not authorable against this product. Fall back to legacyFormatIdsFromOptions ` +\n        `or skip the product for format-option sellers.`,\n      { requested, available: [], missing: requested.slice() }\n    );\n  }\n\n  const selected: V2ProductFormatDeclaration[] = [];\n  const missing: string[] = [];\n  for (const selector of formatOptions) {\n    const match = findDeclaration(addressable, selector);\n    if (match) selected.push(match);\n    else missing.push(selectorLabel(selector));\n  }\n\n  if (missing.length > 0) {\n    const trailingNote =\n      entriesWithoutFormatOptionId > 0\n        ? ` (${entriesWithoutFormatOptionId} format_options[] entries publish no format_option_id and aren't addressable via this helper - use legacyFormatIdsFromOptions for those.)`\n        : '';\n    throw new FormatOptionRefsLookupError(\n      'unknown_format_option_id',\n      `packageRefsForFormatOptions: format option selectors ${JSON.stringify(missing)} ` +\n        `not found in product.format_options[]. Available format options: ${JSON.stringify(available)}.${trailingNote}`,\n      { requested, available, missing }\n    );\n  }\n\n  const seenRefs = new Set<string>();\n  const format_option_refs: FormatOptionRef[] = [];\n  for (const decl of selected) {\n    const ref = declarationToRef(decl);\n    const key = dedupeRefKey(ref);\n    if (seenRefs.has(key)) continue;\n    seenRefs.add(key);\n    format_option_refs.push(ref);\n  }\n\n  // De-dupe v1 refs across multiple chosen declarations. Include\n  // dimensional discriminators in the key so multi-size declarations with\n  // the same `{ agent_url, id }` but different sizes survive.\n  const seen = new Set<string>();\n  const format_ids: V1FormatId[] = [];\n  for (const decl of selected) {\n    for (const ref of decl.v1_format_ref ?? []) {\n      const key = `${ref.agent_url}::${ref.id}::${ref.width ?? ''}x${ref.height ?? ''}::${ref.duration_ms ?? ''}`;\n      if (seen.has(key)) continue;\n      seen.add(key);\n      format_ids.push({ ...ref });\n    }\n  }\n\n  return format_ids.length > 0 ? { format_option_refs, format_ids } : { format_option_refs };\n}\n\n/**\n * Resolve beta.3 `capability_id` selectors and emit beta.3\n * `{ capability_ids, format_ids? }` PackageRequest fields.\n *\n * @deprecated Beta.5+ sellers reject `capability_ids` on PackageRequest. Use\n * {@link packageRefsForFormatOptions} for beta.5+ sellers.\n */\nexport function packageRefsForCapabilities(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  capabilityIds: string[]\n): PackageCapabilityRefs {\n  warnOnce(\n    'packageRefsForCapabilities.beta3-only',\n    'packageRefsForCapabilities() emits beta.3-only capability_ids. Beta.5+ sellers reject capability_ids; use packageRefsForFormatOptions() for beta.5+ package requests.'\n  );\n\n  if (product === null || typeof product !== 'object' || Array.isArray(product)) {\n    throw new CapabilityIdsLookupError(\n      'invalid_product',\n      `packageRefsForCapabilities: expected a Product object with a format_options[] field, got ${Array.isArray(product) ? 'an array (did you pass `products` instead of `products[0]`?)' : typeof product}.`,\n      { requested: capabilityIds, available: [], missing: capabilityIds }\n    );\n  }\n  if (capabilityIds.length === 0) {\n    throw new CapabilityIdsLookupError(\n      'empty_input',\n      `packageRefsForCapabilities requires at least one capability_id. ` +\n        `To accept seller defaults, omit capability_ids from the package entirely.`,\n      { requested: capabilityIds, available: [], missing: [] }\n    );\n  }\n\n  const opts = product.format_options ?? [];\n  const known = new Map<string, V2ProductFormatDeclaration>();\n  let entriesWithoutCapabilityId = 0;\n  for (const opt of opts) {\n    const id = capabilityIdForLookup(opt);\n    if (id) {\n      known.set(id, opt);\n    } else {\n      entriesWithoutCapabilityId += 1;\n    }\n  }\n  const available = [...known.keys()].sort();\n  if (known.size === 0) {\n    const detail =\n      opts.length === 0\n        ? `product has no format_options[] (legacy-format-only product shape, or product wasn't passed through getProducts auto-augmentation)`\n        : `${opts.length} declarations on the product, ${entriesWithoutCapabilityId} unaddressable via capability_id (no entry publishes one)`;\n    throw new CapabilityIdsLookupError(\n      'capability_ids_not_published',\n      `packageRefsForCapabilities: product publishes no capability_ids - ${detail}. ` +\n        `The beta.3 path is not authorable against this product. Fall back to legacyFormatIdsFromOptions ` +\n        `or skip the product for capability_id sellers.`,\n      { requested: capabilityIds, available: [], missing: capabilityIds.slice() }\n    );\n  }\n\n  const missing = capabilityIds.filter(id => !known.has(id));\n  if (missing.length > 0) {\n    const trailingNote =\n      entriesWithoutCapabilityId > 0\n        ? ` (${entriesWithoutCapabilityId} format_options[] entries publish no capability_id and aren't addressable via this helper - use legacyFormatIdsFromOptions for those.)`\n        : '';\n    throw new CapabilityIdsLookupError(\n      'unknown_capability_id',\n      `packageRefsForCapabilities: capability_ids ${JSON.stringify(missing)} ` +\n        `not found in product.format_options[]. Available capability_ids: ${JSON.stringify(available)}.${trailingNote}`,\n      { requested: capabilityIds, available, missing }\n    );\n  }\n\n  const seenCapabilities = new Set<string>();\n  const dedupedCapabilityIds: string[] = [];\n  for (const id of capabilityIds) {\n    if (seenCapabilities.has(id)) continue;\n    seenCapabilities.add(id);\n    dedupedCapabilityIds.push(id);\n  }\n\n  const seen = new Set<string>();\n  const format_ids: V1FormatId[] = [];\n  for (const id of dedupedCapabilityIds) {\n    const decl = known.get(id)!;\n    for (const ref of decl.v1_format_ref ?? []) {\n      const key = `${ref.agent_url}::${ref.id}::${ref.width ?? ''}x${ref.height ?? ''}::${ref.duration_ms ?? ''}`;\n      if (seen.has(key)) continue;\n      seen.add(key);\n      format_ids.push({ ...ref });\n    }\n  }\n\n  return format_ids.length > 0\n    ? { capability_ids: dedupedCapabilityIds, format_ids }\n    : { capability_ids: dedupedCapabilityIds };\n}\n\n/**\n * Extract the legacy `format_ids[]` for a chosen V2 declaration.\n * Throws when the declaration has no v1 form.\n */\nexport function legacyFormatIdsFromOptions(decl: V2ProductFormatDeclaration): V1FormatId[] {\n  const ids = tryLegacyFormatIdsFromOptions(decl);\n  if (ids.length === 0) {\n    const label = decl.format_option_id ?? decl.capability_id ?? decl.format_kind ?? '<unnamed>';\n    const reason = decl.canonical_formats_only\n      ? 'declaration is canonical_formats_only (seller opted out of v1 emission)'\n      : `declaration carries no v1_format_ref[] (likely an inherently-v2 canonical like sponsored_placement / agent_placement / image_carousel / responsive_creative, or a custom shape without v1)`;\n    throw new Error(\n      `legacyFormatIdsFromOptions: '${label}' has no v1 representation - ${reason}. ` +\n        `Pick a different format_options[] entry or skip this product for v1 sellers. ` +\n        `Use tryLegacyFormatIdsFromOptions() if you want a non-throwing variant.`\n    );\n  }\n  return ids;\n}\n\n/**\n * Non-throwing variant of {@link legacyFormatIdsFromOptions}. Returns\n * `[]` when the declaration has no v1 form.\n */\nexport function tryLegacyFormatIdsFromOptions(decl: V2ProductFormatDeclaration): V1FormatId[] {\n  if (decl.v1_format_ref && decl.v1_format_ref.length > 0) {\n    return decl.v1_format_ref.map(ref => ({ ...ref }));\n  }\n  return [];\n}\n\n/**\n * Resolve a `format_option_id` to its legacy `format_ids[]` against a\n * product's `format_options[]`.\n */\nexport function legacyFormatIdsForFormatOption(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  formatOption: FormatOptionSelector\n): V1FormatId[] {\n  const opts = product.format_options ?? [];\n  const match = findDeclaration(opts, formatOption);\n  if (!match) {\n    const declared = opts.map(declarationLabel).filter((s): s is string => Boolean(s));\n    throw new Error(\n      `format option selector ${JSON.stringify(selectorLabel(formatOption))} not found in product.format_options[] ` +\n        `(declared format options: ${declared.length > 0 ? JSON.stringify(declared) : '<none>'})`\n    );\n  }\n  return legacyFormatIdsFromOptions(match);\n}\n\n/**\n * Compatibility alias for callers using the beta.3 helper name.\n *\n * @deprecated Emits beta.3-only `capability_ids`. Beta.5+ sellers reject that\n * field. Use {@link packageRefsForFormatOptions} for beta.5+ package requests.\n */\nexport function legacyFormatIdsForCapability(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  capabilityId: string\n): V1FormatId[] {\n  const opts = product.format_options ?? [];\n  const match = opts.find(o => capabilityId === capabilityIdForLookup(o));\n  if (!match) {\n    const declared = opts.map(capabilityIdForLookup).filter((s): s is string => Boolean(s));\n    throw new Error(\n      `capability_id ${JSON.stringify(capabilityId)} not found in product.format_options[] ` +\n        `(declared capability_ids: ${declared.length > 0 ? JSON.stringify(declared) : '<none>'})`\n    );\n  }\n  return legacyFormatIdsFromOptions(match);\n}\n\nfunction capabilityIdForLookup(decl: V2ProductFormatDeclaration): string | undefined {\n  // Migration alias: beta.3 catalogs used capability_id, beta.5 catalogs use\n  // format_option_id. This beta.3 read path accepts either field so pinned\n  // callers can bridge mixed catalog fixtures while they migrate.\n  return decl.capability_id ?? decl.format_option_id;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/v2/projection/write-side.ts"],"sourcesContent":["/**\n * Write-side ergonomics for V2-mental-model buyers.\n *\n * New beta.5+ code should use `packageRefsForFormatOptions`. It emits only\n * canonical `format_option_refs`; module-private weak storage lets the SDK\n * downgrade at the wire boundary without exposing legacy identifiers. The old capability-named exports\n * keep the beta.3 `capability_ids` surface for callers pinned to that\n * protocol version.\n */\n\nimport type { V1FormatId, V2ProductFormatDeclaration } from './types';\nimport { warnOnce } from '../../utils/deprecation';\nimport { concealLegacyFormatRefs, concealSelectedFormatOptions } from './legacy-metadata';\nimport type { CanonicalFormatDeclaration } from './legacy-metadata';\n\nexport type FormatOptionRef =\n  | {\n      scope: 'publisher';\n      publisher_domain: string;\n      format_option_id: string;\n      canonical_formats_only?: true;\n    }\n  | { scope: 'product'; format_option_id: string; publisher_domain?: never; canonical_formats_only?: true };\n\nexport type FormatOptionSelector = string | { format_option_id: string; publisher_domain?: string };\n\n/**\n * Result shape for {@link packageRefsForFormatOptions} - spread into a\n * `PackageRequest` to author a canonical format-option package. The helper\n * retains downgrade metadata in module-private weak storage.\n */\nexport interface PackageFormatRefs {\n  /**\n   * 3.1+ path. Structured references to product `format_options[]`\n   * entries. Product-local options use `{ scope: 'product',\n   * format_option_id }`; publisher-catalog-backed options use\n   * `{ scope: 'publisher', publisher_domain, format_option_id }`.\n   */\n  format_option_refs: FormatOptionRef[];\n  /** Legacy identifiers are deliberately unavailable on the canonical SDK surface. */\n  format_ids?: never;\n}\n\n/**\n * Beta.3 compatibility shape emitted by {@link packageRefsForCapabilities}.\n * New beta.5 code should use {@link packageRefsForFormatOptions}; this keeps\n * callers pinned to the beta.3 capability_id/capability_ids protocol surface\n * working. Beta.5+ sellers reject `capability_ids` on PackageRequest.\n */\nexport interface PackageCapabilityRefs {\n  capability_ids: string[];\n  format_ids?: V1FormatId[];\n}\n\nexport type FormatOptionRefsLookupErrorCode =\n  | 'unknown_format_option_id'\n  | 'format_option_refs_not_published'\n  | 'empty_input'\n  | 'invalid_product';\n\nexport type CapabilityIdsLookupErrorCode =\n  | 'unknown_capability_id'\n  | 'capability_ids_not_published'\n  | 'empty_input'\n  | 'invalid_product';\n\n/**\n * Structured error from {@link packageRefsForFormatOptions}. Carries a\n * normalized `code` so adopters can branch fallback logic without\n * regex-matching the message.\n */\nexport class FormatOptionRefsLookupError extends Error {\n  readonly code: FormatOptionRefsLookupErrorCode;\n  /** Format option IDs or refs the caller requested. */\n  readonly requested: readonly string[];\n  /** Format option IDs/refs the product actually publishes (sorted). */\n  readonly available: readonly string[];\n  /** Requested entries that were not matched. */\n  readonly missing: readonly string[];\n\n  constructor(\n    code: FormatOptionRefsLookupErrorCode,\n    message: string,\n    meta: { requested: readonly string[]; available: readonly string[]; missing: readonly string[] }\n  ) {\n    super(message);\n    this.name = 'FormatOptionRefsLookupError';\n    this.code = code;\n    this.requested = meta.requested;\n    this.available = meta.available;\n    this.missing = meta.missing;\n  }\n}\n\nexport class CapabilityIdsLookupError extends Error {\n  readonly code: CapabilityIdsLookupErrorCode;\n  /** Capability IDs the caller requested. */\n  readonly requested: readonly string[];\n  /** Capability IDs the product actually publishes (sorted). */\n  readonly available: readonly string[];\n  /** Requested entries that were not matched. */\n  readonly missing: readonly string[];\n\n  constructor(\n    code: CapabilityIdsLookupErrorCode,\n    message: string,\n    meta: { requested: readonly string[]; available: readonly string[]; missing: readonly string[] }\n  ) {\n    super(message);\n    this.name = 'CapabilityIdsLookupError';\n    this.code = code;\n    this.requested = meta.requested;\n    this.available = meta.available;\n    this.missing = meta.missing;\n  }\n}\n\nfunction selectorLabel(selector: FormatOptionSelector): string {\n  if (typeof selector === 'string') return selector;\n  return selector.publisher_domain\n    ? `${selector.publisher_domain}/${selector.format_option_id}`\n    : selector.format_option_id;\n}\n\ntype SelectableFormatDeclaration = {\n  format_option_id?: string;\n  publisher_domain?: string;\n};\n\nfunction declarationLabel(decl: SelectableFormatDeclaration): string | undefined {\n  if (!decl.format_option_id) return undefined;\n  return decl.publisher_domain ? `${decl.publisher_domain}/${decl.format_option_id}` : decl.format_option_id;\n}\n\nfunction declarationToRef(decl: SelectableFormatDeclaration & { canonical_formats_only?: boolean }): FormatOptionRef {\n  if (!decl.format_option_id) {\n    throw new Error('declarationToRef requires a declaration with format_option_id');\n  }\n  return decl.publisher_domain\n    ? {\n        scope: 'publisher',\n        publisher_domain: decl.publisher_domain,\n        format_option_id: decl.format_option_id,\n        ...(decl.canonical_formats_only === true && { canonical_formats_only: true as const }),\n      }\n    : {\n        scope: 'product',\n        format_option_id: decl.format_option_id,\n        ...(decl.canonical_formats_only === true && { canonical_formats_only: true as const }),\n      };\n}\n\nfunction findDeclaration<T extends SelectableFormatDeclaration>(\n  opts: T[],\n  selector: FormatOptionSelector\n): T | undefined {\n  if (typeof selector === 'string') {\n    return opts.find(o => o.format_option_id === selector && !o.publisher_domain);\n  }\n  return opts.find(\n    o =>\n      o.format_option_id === selector.format_option_id &&\n      (selector.publisher_domain ?? '') === (o.publisher_domain ?? '')\n  );\n}\n\nfunction dedupeRefKey(ref: FormatOptionRef): string {\n  return ref.scope === 'publisher'\n    ? `publisher:${ref.publisher_domain}:${ref.format_option_id}`\n    : `product:${ref.format_option_id}`;\n}\n\n/**\n * Resolve format option selectors against a product's `format_options[]`\n * and produce canonical `{ format_option_refs }` for `PackageRequest`.\n *\n * Selectors may be plain product-local IDs (`'nytimes_mrec'`) or\n * structured `{ format_option_id, publisher_domain }` selectors. Returned\n * refs are always structured per the beta.5 schema.\n */\nexport function packageRefsForFormatOptions(\n  product: { format_options?: CanonicalFormatDeclaration[] },\n  formatOptions: FormatOptionSelector[]\n): PackageFormatRefs {\n  const requested = formatOptions.map(selectorLabel);\n\n  // Guard against the common mistake of passing the products[] array.\n  if (product === null || typeof product !== 'object' || Array.isArray(product)) {\n    throw new FormatOptionRefsLookupError(\n      'invalid_product',\n      `packageRefsForFormatOptions: expected a Product object with a format_options[] field, got ${Array.isArray(product) ? 'an array (did you pass `products` instead of `products[0]`?)' : typeof product}.`,\n      { requested, available: [], missing: requested }\n    );\n  }\n  if (formatOptions.length === 0) {\n    throw new FormatOptionRefsLookupError(\n      'empty_input',\n      `packageRefsForFormatOptions requires at least one format_option_id. ` +\n        `To accept seller defaults, omit format_option_refs from the package entirely.`,\n      { requested, available: [], missing: [] }\n    );\n  }\n\n  const opts = product.format_options ?? [];\n  const addressable = opts.filter(o => Boolean(o.format_option_id));\n  const available = addressable\n    .map(declarationLabel)\n    .filter((s): s is string => Boolean(s))\n    .sort();\n  const entriesWithoutFormatOptionId = opts.length - addressable.length;\n\n  if (addressable.length === 0) {\n    const detail =\n      opts.length === 0\n        ? `product has no format_options[] (legacy-format-only product shape, or product wasn't passed through getProducts auto-augmentation)`\n        : `${opts.length} declarations on the product, ${entriesWithoutFormatOptionId} unaddressable via format_option_id (no entry publishes one)`;\n    throw new FormatOptionRefsLookupError(\n      'format_option_refs_not_published',\n      `packageRefsForFormatOptions: product publishes no format_option_id values - ${detail}. ` +\n        `The 3.1+ path is not authorable against this product. Fall back to legacyFormatIdsFromOptions ` +\n        `or skip the product for format-option sellers.`,\n      { requested, available: [], missing: requested.slice() }\n    );\n  }\n\n  const selected: CanonicalFormatDeclaration[] = [];\n  const missing: string[] = [];\n  for (const selector of formatOptions) {\n    const match = findDeclaration(addressable, selector);\n    if (match) selected.push(match);\n    else missing.push(selectorLabel(selector));\n  }\n\n  if (missing.length > 0) {\n    const trailingNote =\n      entriesWithoutFormatOptionId > 0\n        ? ` (${entriesWithoutFormatOptionId} format_options[] entries publish no format_option_id and aren't addressable via this helper - use legacyFormatIdsFromOptions for those.)`\n        : '';\n    throw new FormatOptionRefsLookupError(\n      'unknown_format_option_id',\n      `packageRefsForFormatOptions: format option selectors ${JSON.stringify(missing)} ` +\n        `not found in product.format_options[]. Available format options: ${JSON.stringify(available)}.${trailingNote}`,\n      { requested, available, missing }\n    );\n  }\n\n  const seenRefs = new Set<string>();\n  const format_option_refs: FormatOptionRef[] = [];\n  for (const decl of selected) {\n    const ref = declarationToRef(decl);\n    const key = dedupeRefKey(ref);\n    if (seenRefs.has(key)) continue;\n    seenRefs.add(key);\n    format_option_refs.push(ref);\n  }\n\n  concealSelectedFormatOptions(\n    format_option_refs,\n    selected.map(declaration => concealLegacyFormatRefs(declaration))\n  );\n  return { format_option_refs };\n}\n\n/**\n * Resolve beta.3 `capability_id` selectors and emit beta.3\n * `{ capability_ids, format_ids? }` PackageRequest fields.\n *\n * @deprecated Beta.5+ sellers reject `capability_ids` on PackageRequest. Use\n * {@link packageRefsForFormatOptions} for beta.5+ sellers.\n */\nexport function packageRefsForCapabilities(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  capabilityIds: string[]\n): PackageCapabilityRefs {\n  warnOnce(\n    'packageRefsForCapabilities.beta3-only',\n    'packageRefsForCapabilities() emits beta.3-only capability_ids. Beta.5+ sellers reject capability_ids; use packageRefsForFormatOptions() for beta.5+ package requests.'\n  );\n\n  if (product === null || typeof product !== 'object' || Array.isArray(product)) {\n    throw new CapabilityIdsLookupError(\n      'invalid_product',\n      `packageRefsForCapabilities: expected a Product object with a format_options[] field, got ${Array.isArray(product) ? 'an array (did you pass `products` instead of `products[0]`?)' : typeof product}.`,\n      { requested: capabilityIds, available: [], missing: capabilityIds }\n    );\n  }\n  if (capabilityIds.length === 0) {\n    throw new CapabilityIdsLookupError(\n      'empty_input',\n      `packageRefsForCapabilities requires at least one capability_id. ` +\n        `To accept seller defaults, omit capability_ids from the package entirely.`,\n      { requested: capabilityIds, available: [], missing: [] }\n    );\n  }\n\n  const opts = product.format_options ?? [];\n  const known = new Map<string, V2ProductFormatDeclaration>();\n  let entriesWithoutCapabilityId = 0;\n  for (const opt of opts) {\n    const id = capabilityIdForLookup(opt);\n    if (id) {\n      known.set(id, opt);\n    } else {\n      entriesWithoutCapabilityId += 1;\n    }\n  }\n  const available = [...known.keys()].sort();\n  if (known.size === 0) {\n    const detail =\n      opts.length === 0\n        ? `product has no format_options[] (legacy-format-only product shape, or product wasn't passed through getProducts auto-augmentation)`\n        : `${opts.length} declarations on the product, ${entriesWithoutCapabilityId} unaddressable via capability_id (no entry publishes one)`;\n    throw new CapabilityIdsLookupError(\n      'capability_ids_not_published',\n      `packageRefsForCapabilities: product publishes no capability_ids - ${detail}. ` +\n        `The beta.3 path is not authorable against this product. Fall back to legacyFormatIdsFromOptions ` +\n        `or skip the product for capability_id sellers.`,\n      { requested: capabilityIds, available: [], missing: capabilityIds.slice() }\n    );\n  }\n\n  const missing = capabilityIds.filter(id => !known.has(id));\n  if (missing.length > 0) {\n    const trailingNote =\n      entriesWithoutCapabilityId > 0\n        ? ` (${entriesWithoutCapabilityId} format_options[] entries publish no capability_id and aren't addressable via this helper - use legacyFormatIdsFromOptions for those.)`\n        : '';\n    throw new CapabilityIdsLookupError(\n      'unknown_capability_id',\n      `packageRefsForCapabilities: capability_ids ${JSON.stringify(missing)} ` +\n        `not found in product.format_options[]. Available capability_ids: ${JSON.stringify(available)}.${trailingNote}`,\n      { requested: capabilityIds, available, missing }\n    );\n  }\n\n  const seenCapabilities = new Set<string>();\n  const dedupedCapabilityIds: string[] = [];\n  for (const id of capabilityIds) {\n    if (seenCapabilities.has(id)) continue;\n    seenCapabilities.add(id);\n    dedupedCapabilityIds.push(id);\n  }\n\n  const seen = new Set<string>();\n  const format_ids: V1FormatId[] = [];\n  for (const id of dedupedCapabilityIds) {\n    const decl = known.get(id)!;\n    for (const ref of decl.v1_format_ref ?? []) {\n      const key = `${ref.agent_url}::${ref.id}::${ref.width ?? ''}x${ref.height ?? ''}::${ref.duration_ms ?? ''}`;\n      if (seen.has(key)) continue;\n      seen.add(key);\n      format_ids.push({ ...ref });\n    }\n  }\n\n  return format_ids.length > 0\n    ? { capability_ids: dedupedCapabilityIds, format_ids }\n    : { capability_ids: dedupedCapabilityIds };\n}\n\n/**\n * Extract the legacy `format_ids[]` for a chosen V2 declaration.\n * Throws when the declaration has no v1 form.\n */\nexport function legacyFormatIdsFromOptions(decl: V2ProductFormatDeclaration): V1FormatId[] {\n  const ids = tryLegacyFormatIdsFromOptions(decl);\n  if (ids.length === 0) {\n    const label = decl.format_option_id ?? decl.capability_id ?? decl.format_kind ?? '<unnamed>';\n    const reason = decl.canonical_formats_only\n      ? 'declaration is canonical_formats_only (seller opted out of v1 emission)'\n      : `declaration carries no v1_format_ref[] (likely an inherently-v2 canonical like sponsored_placement / agent_placement / image_carousel / responsive_creative, or a custom shape without v1)`;\n    throw new Error(\n      `legacyFormatIdsFromOptions: '${label}' has no v1 representation - ${reason}. ` +\n        `Pick a different format_options[] entry or skip this product for v1 sellers. ` +\n        `Use tryLegacyFormatIdsFromOptions() if you want a non-throwing variant.`\n    );\n  }\n  return ids;\n}\n\n/**\n * Non-throwing variant of {@link legacyFormatIdsFromOptions}. Returns\n * `[]` when the declaration has no v1 form.\n */\nexport function tryLegacyFormatIdsFromOptions(decl: V2ProductFormatDeclaration): V1FormatId[] {\n  if (decl.v1_format_ref && decl.v1_format_ref.length > 0) {\n    return decl.v1_format_ref.map(ref => ({ ...ref }));\n  }\n  return [];\n}\n\n/**\n * Resolve a `format_option_id` to its legacy `format_ids[]` against a\n * product's `format_options[]`.\n */\nexport function legacyFormatIdsForFormatOption(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  formatOption: FormatOptionSelector\n): V1FormatId[] {\n  const opts = product.format_options ?? [];\n  const match = findDeclaration(opts, formatOption);\n  if (!match) {\n    const declared = opts.map(declarationLabel).filter((s): s is string => Boolean(s));\n    throw new Error(\n      `format option selector ${JSON.stringify(selectorLabel(formatOption))} not found in product.format_options[] ` +\n        `(declared format options: ${declared.length > 0 ? JSON.stringify(declared) : '<none>'})`\n    );\n  }\n  return legacyFormatIdsFromOptions(match);\n}\n\n/**\n * Compatibility alias for callers using the beta.3 helper name.\n *\n * @deprecated Emits beta.3-only `capability_ids`. Beta.5+ sellers reject that\n * field. Use {@link packageRefsForFormatOptions} for beta.5+ package requests.\n */\nexport function legacyFormatIdsForCapability(\n  product: { format_options?: V2ProductFormatDeclaration[] },\n  capabilityId: string\n): V1FormatId[] {\n  const opts = product.format_options ?? [];\n  const match = opts.find(o => capabilityId === capabilityIdForLookup(o));\n  if (!match) {\n    const declared = opts.map(capabilityIdForLookup).filter((s): s is string => Boolean(s));\n    throw new Error(\n      `capability_id ${JSON.stringify(capabilityId)} not found in product.format_options[] ` +\n        `(declared capability_ids: ${declared.length > 0 ? JSON.stringify(declared) : '<none>'})`\n    );\n  }\n  return legacyFormatIdsFromOptions(match);\n}\n\nfunction capabilityIdForLookup(decl: V2ProductFormatDeclaration): string | undefined {\n  // Migration alias: beta.3 catalogs used capability_id, beta.5 catalogs use\n  // format_option_id. This beta.3 read path accepts either field so pinned\n  // callers can bridge mixed catalog fixtures while they migrate.\n  return decl.capability_id ?? decl.format_option_id;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/version.d.mts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "12.1.0";
+export declare const LIBRARY_VERSION = "13.0.0-rc.0";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "12.1.0";
+    readonly library: "13.0.0-rc.0";
     readonly adcp: "3.1.5";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0-beta.1", "3.0-beta", "3.0.0-beta.3", "3.0-beta.3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5"];
-    readonly generatedAt: "2026-07-25T23:35:53.939Z";
+    readonly generatedAt: "2026-07-27T16:31:55.282Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "12.1.0";
+export declare const LIBRARY_VERSION = "13.0.0-rc.0";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "12.1.0";
+    readonly library: "13.0.0-rc.0";
     readonly adcp: "3.1.5";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0-beta.1", "3.0-beta", "3.0.0-beta.3", "3.0-beta.3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5"];
-    readonly generatedAt: "2026-07-25T23:35:53.939Z";
+    readonly generatedAt: "2026-07-27T16:31:55.282Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,qSA8B3B,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,MAAM,EAAE,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAajE"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,qSA8B3B,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,MAAM,EAAE,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAajE"}

package/dist/lib/version.js

@@ -31,7 +31,7 @@ __export(version_exports, {
   toReleasePrecisionVersion: () => toReleasePrecisionVersion
 });
 module.exports = __toCommonJS(version_exports);
-const LIBRARY_VERSION = "12.1.0";
+const LIBRARY_VERSION = "13.0.0-rc.0";
 const ADCP_VERSION = "3.1.5";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -66,10 +66,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.1.5"
 ];
 const VERSION_INFO = {
-  library: "12.1.0",
+  library: "13.0.0-rc.0",
   adcp: "3.1.5",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-07-25T23:35:53.939Z"
+  generatedAt: "2026-07-27T16:31:55.282Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/dist/lib/version.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/version.ts"],"sourcesContent":["// Generated version information\n// This file is auto-generated by sync-version.ts\n\n/**\n * AdCP SDK library version\n */\nexport const LIBRARY_VERSION = '12.1.0';\n\n/**\n * AdCP specification version this library is built for\n */\nexport const ADCP_VERSION = '3.1.5';\n\n/**\n * AdCP major version sent with every request (adcp_major_version field).\n * Sellers validate this against their supported versions and return\n * VERSION_UNSUPPORTED if the version is not in range.\n */\nexport const ADCP_MAJOR_VERSION = 3;\n\n/**\n * AdCP versions this library maintains backward compatibility with.\n *\n * Auto-derived from `ADCP_VERSION` by scripts/sync-version.ts. Do not edit\n * this list by hand; bumping the AdCP pin via `npm run sync-version`\n * extends it.\n */\nexport const COMPATIBLE_ADCP_VERSIONS = [\n  'v2.5',\n  'v2.6',\n  'v3',\n  '3.0.0-beta.1',\n  '3.0-beta.1',\n  '3.0-beta',\n  '3.0.0-beta.3',\n  '3.0-beta.3',\n  '3.0.0',\n  '3.0',\n  '3.0.1',\n  '3.0.2',\n  '3.0.3',\n  '3.0.4',\n  '3.0.5',\n  '3.0.6',\n  '3.0.7',\n  '3.0.8',\n  '3.0.9',\n  '3.0.10',\n  '3.0.11',\n  '3.0.12',\n  '3.1.0',\n  '3.1',\n  '3.1.1',\n  '3.1.2',\n  '3.1.3',\n  '3.1.4',\n  '3.1.5',\n] as const;\n\n/**\n * String literal union of every AdCP version the SDK formally supports.\n *\n * Used by the per-instance `adcpVersion` constructor option to give callers\n * autocomplete in editors. The intersection with `(string & {})` in the\n * config type preserves the escape hatch — any string is still accepted at\n * the type level — while the literal union surfaces canonical values first.\n */\nexport type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];\n\n/**\n * Full version information\n */\nexport const VERSION_INFO = {\n  library: '12.1.0',\n  adcp: '3.1.5',\n  compatibleVersions: COMPATIBLE_ADCP_VERSIONS,\n  generatedAt: '2026-07-25T23:35:53.939Z',\n} as const;\n\n/**\n * Get the AdCP specification version this library is built for\n */\nexport function getAdcpVersion(): string {\n  return ADCP_VERSION;\n}\n\n/**\n * Get the library version\n */\nexport function getLibraryVersion(): string {\n  return LIBRARY_VERSION;\n}\n\n/**\n * Check if this library version is compatible with a given AdCP version\n */\nexport function isCompatibleWith(adcpVersion: string): boolean {\n  return (COMPATIBLE_ADCP_VERSIONS as readonly string[]).includes(adcpVersion);\n}\n\n/**\n * Get all AdCP versions this library is compatible with\n */\nexport function getCompatibleVersions(): readonly string[] {\n  return COMPATIBLE_ADCP_VERSIONS;\n}\n\n/**\n * Extract the major version number from an AdCP version string.\n *\n * Accepts:\n *   - Semver: '3.0.0', '3.0.1', '3.1.0-beta.1' → 3\n *   - Legacy aliases: 'v3' → 3, 'v2.5' / 'v2.6' → 2\n *\n * Returns NaN for unrecognized strings — callers should validate before passing.\n */\nexport function parseAdcpMajorVersion(version: string): number {\n  const trimmed = version.trim();\n  const semverLike = trimmed.startsWith('v') ? trimmed.slice(1) : trimmed;\n  const major = parseInt(semverLike.split('.')[0] ?? '', 10);\n  return Number.isFinite(major) ? major : NaN;\n}\n\n/**\n * Normalize a full-semver AdCP version (`MAJOR.MINOR.PATCH[-prerelease]`) to\n * the release-precision form that AdCP 3.1+ requires on the wire:\n * `MAJOR.MINOR[-prerelease]` — the patch digit is dropped.\n *\n * Per the spec note on `adcp_version`: \"SDKs that read full-semver values\n * from bundle metadata (e.g. `ComplianceIndex.published_version =\n * \"3.1.0-beta.1\"`) MUST normalize to release-precision (`\"3.1-beta.1\"`)\n * before emitting on the wire — meta-field values are NOT valid wire\n * values.\" The wire regex (`^\\d+\\.\\d+(-[a-zA-Z0-9.-]+)?$`) rejects strings\n * with a patch digit.\n *\n * Behavior:\n *   - `\"3.1.0-beta.7\"` → `\"3.1-beta.7\"`\n *   - `\"3.1.0\"`        → `\"3.1\"`\n *   - `\"3.0.12\"`       → `\"3.0\"`\n *   - Already-release-precision input (`\"3.1\"`, `\"3.1-beta.7\"`) passes through\n *   - Legacy aliases (`\"v2.5\"`, `\"v3\"`) pass through unchanged — the wire\n *     regex doesn't accept them anyway; the v2.5 path uses\n *     `adcp_major_version` instead of `adcp_version` for transport.\n *   - Unrecognized strings pass through unchanged so callers can detect drift\n *     via the wire validator rather than have it masked by this helper.\n */\nexport function toReleasePrecisionVersion(version: string): string {\n  const trimmed = version.trim();\n  // Pre-release form `MAJOR.MINOR.PATCH-prerelease` → `MAJOR.MINOR-prerelease`\n  const semverMatch = trimmed.match(/^(\\d+)\\.(\\d+)\\.\\d+(-[A-Za-z0-9.-]+)?$/);\n  if (semverMatch) {\n    const [, major, minor, pre = ''] = semverMatch;\n    return `${major}.${minor}${pre}`;\n  }\n  // Already release-precision (no patch digit). Includes `3.1`, `3.1-beta.7`.\n  if (/^\\d+\\.\\d+(-[A-Za-z0-9.-]+)?$/.test(trimmed)) return trimmed;\n  // Legacy aliases (`v3`, `v2.5`, `v2.6`) and anything we don't recognize —\n  // pass through so the wire validator can flag genuine drift.\n  return version;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMO,MAAM,kBAAkB;AAKxB,MAAM,eAAe;AAOrB,MAAM,qBAAqB;AAS3B,MAAM,2BAA2B;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAeO,MAAM,eAAe;AAAA,EAC1B,SAAS;AAAA,EACT,MAAM;AAAA,EACN,oBAAoB;AAAA,EACpB,aAAa;AACf;AAKO,SAAS,iBAAyB;AACvC,SAAO;AACT;AAKO,SAAS,oBAA4B;AAC1C,SAAO;AACT;AAKO,SAAS,iBAAiB,aAA8B;AAC7D,SAAQ,yBAA+C,SAAS,WAAW;AAC7E;AAKO,SAAS,wBAA2C;AACzD,SAAO;AACT;AAWO,SAAS,sBAAsB,SAAyB;AAC7D,QAAM,UAAU,QAAQ,KAAK;AAC7B,QAAM,aAAa,QAAQ,WAAW,GAAG,IAAI,QAAQ,MAAM,CAAC,IAAI;AAChE,QAAM,QAAQ,SAAS,WAAW,MAAM,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE;AACzD,SAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;AAC1C;AAyBO,SAAS,0BAA0B,SAAyB;AACjE,QAAM,UAAU,QAAQ,KAAK;AAE7B,QAAM,cAAc,QAAQ,MAAM,uCAAuC;AACzE,MAAI,aAAa;AACf,UAAM,CAAC,EAAE,OAAO,OAAO,MAAM,EAAE,IAAI;AACnC,WAAO,GAAG,KAAK,IAAI,KAAK,GAAG,GAAG;AAAA,EAChC;AAEA,MAAI,+BAA+B,KAAK,OAAO,EAAG,QAAO;AAGzD,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/lib/version.ts"],"sourcesContent":["// Generated version information\n// This file is auto-generated by sync-version.ts\n\n/**\n * AdCP SDK library version\n */\nexport const LIBRARY_VERSION = '13.0.0-rc.0';\n\n/**\n * AdCP specification version this library is built for\n */\nexport const ADCP_VERSION = '3.1.5';\n\n/**\n * AdCP major version sent with every request (adcp_major_version field).\n * Sellers validate this against their supported versions and return\n * VERSION_UNSUPPORTED if the version is not in range.\n */\nexport const ADCP_MAJOR_VERSION = 3;\n\n/**\n * AdCP versions this library maintains backward compatibility with.\n *\n * Auto-derived from `ADCP_VERSION` by scripts/sync-version.ts. Do not edit\n * this list by hand; bumping the AdCP pin via `npm run sync-version`\n * extends it.\n */\nexport const COMPATIBLE_ADCP_VERSIONS = [\n  'v2.5',\n  'v2.6',\n  'v3',\n  '3.0.0-beta.1',\n  '3.0-beta.1',\n  '3.0-beta',\n  '3.0.0-beta.3',\n  '3.0-beta.3',\n  '3.0.0',\n  '3.0',\n  '3.0.1',\n  '3.0.2',\n  '3.0.3',\n  '3.0.4',\n  '3.0.5',\n  '3.0.6',\n  '3.0.7',\n  '3.0.8',\n  '3.0.9',\n  '3.0.10',\n  '3.0.11',\n  '3.0.12',\n  '3.1.0',\n  '3.1',\n  '3.1.1',\n  '3.1.2',\n  '3.1.3',\n  '3.1.4',\n  '3.1.5',\n] as const;\n\n/**\n * String literal union of every AdCP version the SDK formally supports.\n *\n * Used by the per-instance `adcpVersion` constructor option to give callers\n * autocomplete in editors. The intersection with `(string & {})` in the\n * config type preserves the escape hatch — any string is still accepted at\n * the type level — while the literal union surfaces canonical values first.\n */\nexport type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];\n\n/**\n * Full version information\n */\nexport const VERSION_INFO = {\n  library: '13.0.0-rc.0',\n  adcp: '3.1.5',\n  compatibleVersions: COMPATIBLE_ADCP_VERSIONS,\n  generatedAt: '2026-07-27T16:31:55.282Z',\n} as const;\n\n/**\n * Get the AdCP specification version this library is built for\n */\nexport function getAdcpVersion(): string {\n  return ADCP_VERSION;\n}\n\n/**\n * Get the library version\n */\nexport function getLibraryVersion(): string {\n  return LIBRARY_VERSION;\n}\n\n/**\n * Check if this library version is compatible with a given AdCP version\n */\nexport function isCompatibleWith(adcpVersion: string): boolean {\n  return (COMPATIBLE_ADCP_VERSIONS as readonly string[]).includes(adcpVersion);\n}\n\n/**\n * Get all AdCP versions this library is compatible with\n */\nexport function getCompatibleVersions(): readonly string[] {\n  return COMPATIBLE_ADCP_VERSIONS;\n}\n\n/**\n * Extract the major version number from an AdCP version string.\n *\n * Accepts:\n *   - Semver: '3.0.0', '3.0.1', '3.1.0-beta.1' → 3\n *   - Legacy aliases: 'v3' → 3, 'v2.5' / 'v2.6' → 2\n *\n * Returns NaN for unrecognized strings — callers should validate before passing.\n */\nexport function parseAdcpMajorVersion(version: string): number {\n  const trimmed = version.trim();\n  const semverLike = trimmed.startsWith('v') ? trimmed.slice(1) : trimmed;\n  const major = parseInt(semverLike.split('.')[0] ?? '', 10);\n  return Number.isFinite(major) ? major : NaN;\n}\n\n/**\n * Normalize a full-semver AdCP version (`MAJOR.MINOR.PATCH[-prerelease]`) to\n * the release-precision form that AdCP 3.1+ requires on the wire:\n * `MAJOR.MINOR[-prerelease]` — the patch digit is dropped.\n *\n * Per the spec note on `adcp_version`: \"SDKs that read full-semver values\n * from bundle metadata (e.g. `ComplianceIndex.published_version =\n * \"3.1.0-beta.1\"`) MUST normalize to release-precision (`\"3.1-beta.1\"`)\n * before emitting on the wire — meta-field values are NOT valid wire\n * values.\" The wire regex (`^\\d+\\.\\d+(-[a-zA-Z0-9.-]+)?$`) rejects strings\n * with a patch digit.\n *\n * Behavior:\n *   - `\"3.1.0-beta.7\"` → `\"3.1-beta.7\"`\n *   - `\"3.1.0\"`        → `\"3.1\"`\n *   - `\"3.0.12\"`       → `\"3.0\"`\n *   - Already-release-precision input (`\"3.1\"`, `\"3.1-beta.7\"`) passes through\n *   - Legacy aliases (`\"v2.5\"`, `\"v3\"`) pass through unchanged — the wire\n *     regex doesn't accept them anyway; the v2.5 path uses\n *     `adcp_major_version` instead of `adcp_version` for transport.\n *   - Unrecognized strings pass through unchanged so callers can detect drift\n *     via the wire validator rather than have it masked by this helper.\n */\nexport function toReleasePrecisionVersion(version: string): string {\n  const trimmed = version.trim();\n  // Pre-release form `MAJOR.MINOR.PATCH-prerelease` → `MAJOR.MINOR-prerelease`\n  const semverMatch = trimmed.match(/^(\\d+)\\.(\\d+)\\.\\d+(-[A-Za-z0-9.-]+)?$/);\n  if (semverMatch) {\n    const [, major, minor, pre = ''] = semverMatch;\n    return `${major}.${minor}${pre}`;\n  }\n  // Already release-precision (no patch digit). Includes `3.1`, `3.1-beta.7`.\n  if (/^\\d+\\.\\d+(-[A-Za-z0-9.-]+)?$/.test(trimmed)) return trimmed;\n  // Legacy aliases (`v3`, `v2.5`, `v2.6`) and anything we don't recognize —\n  // pass through so the wire validator can flag genuine drift.\n  return version;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMO,MAAM,kBAAkB;AAKxB,MAAM,eAAe;AAOrB,MAAM,qBAAqB;AAS3B,MAAM,2BAA2B;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAeO,MAAM,eAAe;AAAA,EAC1B,SAAS;AAAA,EACT,MAAM;AAAA,EACN,oBAAoB;AAAA,EACpB,aAAa;AACf;AAKO,SAAS,iBAAyB;AACvC,SAAO;AACT;AAKO,SAAS,oBAA4B;AAC1C,SAAO;AACT;AAKO,SAAS,iBAAiB,aAA8B;AAC7D,SAAQ,yBAA+C,SAAS,WAAW;AAC7E;AAKO,SAAS,wBAA2C;AACzD,SAAO;AACT;AAWO,SAAS,sBAAsB,SAAyB;AAC7D,QAAM,UAAU,QAAQ,KAAK;AAC7B,QAAM,aAAa,QAAQ,WAAW,GAAG,IAAI,QAAQ,MAAM,CAAC,IAAI;AAChE,QAAM,QAAQ,SAAS,WAAW,MAAM,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE;AACzD,SAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;AAC1C;AAyBO,SAAS,0BAA0B,SAAyB;AACjE,QAAM,UAAU,QAAQ,KAAK;AAE7B,QAAM,cAAc,QAAQ,MAAM,uCAAuC;AACzE,MAAI,aAAa;AACf,UAAM,CAAC,EAAE,OAAO,OAAO,MAAM,EAAE,IAAI;AACnC,WAAO,GAAG,KAAK,IAAI,KAAK,GAAG,GAAG;AAAA,EAChC;AAEA,MAAI,+BAA+B,KAAK,OAAO,EAAG,QAAO;AAGzD,SAAO;AACT;","names":[]}

package/dist/lib/version.mjs

@@ -1,4 +1,4 @@
-const LIBRARY_VERSION = "12.1.0";
+const LIBRARY_VERSION = "13.0.0-rc.0";
 const ADCP_VERSION = "3.1.5";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -33,10 +33,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.1.5"
 ];
 const VERSION_INFO = {
-  library: "12.1.0",
+  library: "13.0.0-rc.0",
   adcp: "3.1.5",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-07-25T23:35:53.939Z"
+  generatedAt: "2026-07-27T16:31:55.282Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;