@adcp/sdk 12.1.0 → 13.0.0-rc.0

package/dist/lib/server/decisioning/assembly-helpers.d.mts

@@ -1,11 +1,11 @@
 /**
- * Wire-shape assembly helpers.
+ * Canonical decisioning assembly helpers.
  *
- * AdCP wire shapes carry many required fields (Product needs 8 required
+ * AdCP products carry many required fields (Product needs 8 required
  * properties; PricingOption needs at least 3 plus model-specific extras).
- * Building them by hand is the largest single source of validation
- * cascades in LLM-generated platforms (Emma matrix v18: a single missed
- * `format_ids[0].id` shape error swallowed 30+ storyboard steps).
+ * Building them by hand is a common source of validation cascades in
+ * generated platforms. The primary product helper accepts only canonical
+ * `format_options`; named-format assembly is explicitly `buildProductLegacy`.
  *
  * These helpers emit correct wire shapes from a flatter, intent-shaped
  * input. Adopters opt in — anything you don't pass in gets a sensible
@@ -14,7 +14,10 @@
  * @public
  */
 import type { Product, PricingOption, ReportingCapabilities } from '../../types/tools.generated.mjs';
-export interface BuildProductInput {
+import type { CanonicalProduct } from '../../v2/projection/creative-delivery.mjs';
+import type { CanonicalFormatDeclaration } from '../../v2/projection/legacy-metadata.mjs';
+/** @deprecated Compatibility input for {@link buildProductLegacy}. */
+export interface BuildProductLegacyInput {
     /** Unique product id. */
     id: string;
     /** Human-readable name surfaced to buyers. */
@@ -104,20 +107,27 @@ export interface BuildProductInput {
     channels?: ReadonlyArray<string>;
     /** Adapter-internal opaque blob round-tripped by the SDK. */
     ctx_metadata?: unknown;
-    /** Anything else on the wire shape (escape hatch). */
+    /** Additional non-identity product fields. Canonical fields and legacy creative identity are rejected. */
     extra?: Record<string, unknown>;
 }
+/** Canonical product input used by the primary server SDK. */
+export interface BuildProductInput extends Omit<BuildProductLegacyInput, 'formats' | 'agentUrl'> {
+    /** Canonical creative declarations accepted by this product. */
+    format_options: ReadonlyArray<CanonicalFormatDeclaration>;
+}
 /**
- * Build a wire-correct `Product` from intent-shaped input. Required fields
- * (per AdCP 3.0.1 product.json) are filled in with sensible defaults when
- * omitted; the caller can override any of them.
+ * Build a canonical `Product` from intent-shaped input. Required common
+ * product fields are filled in with sensible defaults when omitted.
  *
  * @example Catalog product (minimal)
  * ```ts
  * const product = buildProduct({
  *   id: 'sports_display_auction',
  *   name: 'Sports Display Auction',
- *   formats: ['display_300x250', 'display_728x90'],
+ *   format_options: [
+ *     { format_option_id: 'medium-rectangle', format_kind: 'image', params: { width: 300, height: 250 } },
+ *     { format_option_id: 'leaderboard', format_kind: 'image', params: { width: 728, height: 90 } },
+ *   ],
  *   delivery_type: 'non_guaranteed',
  *   pricing: { model: 'cpm', floor: 5.0, currency: 'USD' },
  *   ctx_metadata: { gam: { ad_unit_ids: ['au_123'] } },
@@ -129,7 +139,9 @@ export interface BuildProductInput {
  * const product = buildProduct({
  *   id: 'premium_homepage',
  *   name: 'Premium Homepage Takeover',
- *   formats: [{ id: 'display_970x250' }],
+ *   format_options: [
+ *     { format_option_id: 'billboard', format_kind: 'image', params: { width: 970, height: 250 } },
+ *   ],
  *   delivery_type: 'guaranteed',
  *   pricing: [
  *     buildPricingOption({ id: 'po_cpm', model: 'cpm', fixed: 25.0, currency: 'USD' }),
@@ -138,7 +150,9 @@ export interface BuildProductInput {
  * });
  * ```
  */
-export declare function buildProduct(input: BuildProductInput): Product;
+export declare function buildProduct(input: BuildProductInput): CanonicalProduct;
+/** @deprecated Explicit compatibility helper for legacy `format_ids` products. */
+export declare function buildProductLegacy(input: BuildProductLegacyInput): Product;
 export interface BuildPricingOptionInput {
     /** Pricing option id, unique within the product. Defaults to `${model}_${floor||fixed||'default'}`. */
     id?: string;

package/dist/lib/server/decisioning/assembly-helpers.d.ts

@@ -1,11 +1,11 @@
 /**
- * Wire-shape assembly helpers.
+ * Canonical decisioning assembly helpers.
  *
- * AdCP wire shapes carry many required fields (Product needs 8 required
+ * AdCP products carry many required fields (Product needs 8 required
  * properties; PricingOption needs at least 3 plus model-specific extras).
- * Building them by hand is the largest single source of validation
- * cascades in LLM-generated platforms (Emma matrix v18: a single missed
- * `format_ids[0].id` shape error swallowed 30+ storyboard steps).
+ * Building them by hand is a common source of validation cascades in
+ * generated platforms. The primary product helper accepts only canonical
+ * `format_options`; named-format assembly is explicitly `buildProductLegacy`.
  *
  * These helpers emit correct wire shapes from a flatter, intent-shaped
  * input. Adopters opt in — anything you don't pass in gets a sensible
@@ -14,7 +14,10 @@
  * @public
  */
 import type { Product, PricingOption, ReportingCapabilities } from '../../types/tools.generated';
-export interface BuildProductInput {
+import type { CanonicalProduct } from '../../v2/projection/creative-delivery';
+import type { CanonicalFormatDeclaration } from '../../v2/projection/legacy-metadata';
+/** @deprecated Compatibility input for {@link buildProductLegacy}. */
+export interface BuildProductLegacyInput {
     /** Unique product id. */
     id: string;
     /** Human-readable name surfaced to buyers. */
@@ -104,20 +107,27 @@ export interface BuildProductInput {
     channels?: ReadonlyArray<string>;
     /** Adapter-internal opaque blob round-tripped by the SDK. */
     ctx_metadata?: unknown;
-    /** Anything else on the wire shape (escape hatch). */
+    /** Additional non-identity product fields. Canonical fields and legacy creative identity are rejected. */
     extra?: Record<string, unknown>;
 }
+/** Canonical product input used by the primary server SDK. */
+export interface BuildProductInput extends Omit<BuildProductLegacyInput, 'formats' | 'agentUrl'> {
+    /** Canonical creative declarations accepted by this product. */
+    format_options: ReadonlyArray<CanonicalFormatDeclaration>;
+}
 /**
- * Build a wire-correct `Product` from intent-shaped input. Required fields
- * (per AdCP 3.0.1 product.json) are filled in with sensible defaults when
- * omitted; the caller can override any of them.
+ * Build a canonical `Product` from intent-shaped input. Required common
+ * product fields are filled in with sensible defaults when omitted.
  *
  * @example Catalog product (minimal)
  * ```ts
  * const product = buildProduct({
  *   id: 'sports_display_auction',
  *   name: 'Sports Display Auction',
- *   formats: ['display_300x250', 'display_728x90'],
+ *   format_options: [
+ *     { format_option_id: 'medium-rectangle', format_kind: 'image', params: { width: 300, height: 250 } },
+ *     { format_option_id: 'leaderboard', format_kind: 'image', params: { width: 728, height: 90 } },
+ *   ],
  *   delivery_type: 'non_guaranteed',
  *   pricing: { model: 'cpm', floor: 5.0, currency: 'USD' },
  *   ctx_metadata: { gam: { ad_unit_ids: ['au_123'] } },
@@ -129,7 +139,9 @@ export interface BuildProductInput {
  * const product = buildProduct({
  *   id: 'premium_homepage',
  *   name: 'Premium Homepage Takeover',
- *   formats: [{ id: 'display_970x250' }],
+ *   format_options: [
+ *     { format_option_id: 'billboard', format_kind: 'image', params: { width: 970, height: 250 } },
+ *   ],
  *   delivery_type: 'guaranteed',
  *   pricing: [
  *     buildPricingOption({ id: 'po_cpm', model: 'cpm', fixed: 25.0, currency: 'USD' }),
@@ -138,7 +150,9 @@ export interface BuildProductInput {
  * });
  * ```
  */
-export declare function buildProduct(input: BuildProductInput): Product;
+export declare function buildProduct(input: BuildProductInput): CanonicalProduct;
+/** @deprecated Explicit compatibility helper for legacy `format_ids` products. */
+export declare function buildProductLegacy(input: BuildProductLegacyInput): Product;
 export interface BuildPricingOptionInput {
     /** Pricing option id, unique within the product. Defaults to `${model}_${floor||fixed||'default'}`. */
     id?: string;

package/dist/lib/server/decisioning/assembly-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assembly-helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/assembly-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"assembly-helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/assembly-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACjG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAMtF,sEAAsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IAEX,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;OASG;IACH,OAAO,EAAE,aAAa,CAAC,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEpE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qFAAqF;IACrF,aAAa,EAAE,YAAY,GAAG,gBAAgB,CAAC;IAE/C;;;;;;OAMG;IACH,OAAO,CAAC,EACJ;QACE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;QACtF,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GACD,aAAa,CAAC,aAAa,CAAC,CAAC;IAEjC;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;;;;;OASG;IACH,oBAAoB,CAAC,EAAE,aAAa,CAChC;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,KAAK,CAAA;KAAE,GACnD;QACE,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,YAAY,EAAE,aAAa,CAAC;YAAE,aAAa,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAC;KAClG,GACD;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,QAAQ,CAAC;QAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;KAAE,CAC/F,CAAC;IAEF,iFAAiF;IACjF,sBAAsB,CAAC,EAAE,qBAAqB,CAAC;IAE/C,oEAAoE;IACpE,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAEjC,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,0GAA0G;IAC1G,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,8DAA8D;AAC9D,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,UAAU,CAAC;IAC9F,gEAAgE;IAChE,cAAc,EAAE,aAAa,CAAC,0BAA0B,CAAC,CAAC;CAC3D;AAsHD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,CA+BvE;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAkC1E;AAkBD,MAAM,WAAW,uBAAuB;IACtC,uGAAuG;IACvG,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,qBAAqB;IACrB,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;IAEtF,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,uEAAuE;IACvE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,aAAa,CAkBhF;AAMD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,MAAM,CAAC,EACH,OAAO,GACP,mBAAmB,GACnB,eAAe,GACf,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,UAAU,GACV,UAAU,CAAC;IACf,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU9E"}

package/dist/lib/server/decisioning/assembly-helpers.js

@@ -20,7 +20,8 @@ var assembly_helpers_exports = {};
 __export(assembly_helpers_exports, {
   buildPackage: () => buildPackage,
   buildPricingOption: () => buildPricingOption,
-  buildProduct: () => buildProduct
+  buildProduct: () => buildProduct,
+  buildProductLegacy: () => buildProductLegacy
 });
 module.exports = __toCommonJS(assembly_helpers_exports);
 const DEFAULT_REPORTING_CAPABILITIES = {
@@ -31,6 +32,95 @@ const DEFAULT_REPORTING_CAPABILITIES = {
   available_metrics: ["impressions", "spend", "clicks"],
   date_range_support: "date_range"
 };
+const CANONICAL_PRODUCT_RESERVED_EXTRA_KEYS = /* @__PURE__ */ new Set([
+  "product_id",
+  "name",
+  "description",
+  "publisher_properties",
+  "format_options",
+  "format_ids",
+  "delivery_type",
+  "pricing_options",
+  "reporting_capabilities",
+  "channels",
+  "ctx_metadata"
+]);
+function assertCanonicalProductExtra(extra) {
+  if (!extra) return;
+  const seen = /* @__PURE__ */ new WeakSet();
+  const visit = (value, path, root) => {
+    if (value === null || typeof value !== "object" || seen.has(value)) return;
+    seen.add(value);
+    for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(value))) {
+      if (key === "toJSON") {
+        throw new Error(`buildProduct: extra.${path}${key} is not allowed on canonical product data`);
+      }
+      if (!descriptor.enumerable) continue;
+      if (!("value" in descriptor)) {
+        throw new Error(`buildProduct: extra.${path}${key} must be a data property, not an accessor`);
+      }
+      if (typeof descriptor.value === "function") {
+        throw new Error(`buildProduct: extra.${path}${key} must not be callable`);
+      }
+      if (root && CANONICAL_PRODUCT_RESERVED_EXTRA_KEYS.has(key)) {
+        throw new Error(`buildProduct: extra.${key} cannot override a canonical product field`);
+      }
+      if (key === "agent_url" || /(^|_)(?:format_ids?|v1_format_ref)($|_)/.test(key)) {
+        throw new Error(`buildProduct: extra.${path}${key} contains legacy creative identity`);
+      }
+      visit(descriptor.value, `${path}${key}.`, false);
+    }
+  };
+  visit(extra, "", true);
+}
+function cloneCanonicalProductData(value, path, active = /* @__PURE__ */ new WeakSet()) {
+  if (typeof value === "function") throw new Error(`buildProduct: ${path} must not be callable`);
+  if (value === null || typeof value !== "object") return value;
+  if (active.has(value)) throw new Error(`buildProduct: ${path} must not contain cycles`);
+  active.add(value);
+  try {
+    const descriptors = Object.getOwnPropertyDescriptors(value);
+    if (Array.isArray(value)) {
+      const clone2 = [];
+      for (const [key, descriptor] of Object.entries(descriptors)) {
+        if (key === "toJSON") {
+          throw new Error(`buildProduct: ${path}.${key} is not allowed on canonical product data`);
+        }
+        if (!descriptor.enumerable) continue;
+        if (!("value" in descriptor)) {
+          throw new Error(`buildProduct: ${path}[${key}] must be a data property, not an accessor`);
+        }
+        if (!/^(0|[1-9]\d*)$/.test(key)) {
+          throw new Error(`buildProduct: ${path} has unsupported enumerable array property ${key}`);
+        }
+        clone2[Number(key)] = cloneCanonicalProductData(descriptor.value, `${path}[${key}]`, active);
+      }
+      return clone2;
+    }
+    const clone = {};
+    for (const [key, descriptor] of Object.entries(descriptors)) {
+      if (key === "toJSON") {
+        throw new Error(`buildProduct: ${path}.${key} is not allowed on canonical product data`);
+      }
+      if (!descriptor.enumerable) continue;
+      if (!("value" in descriptor)) {
+        throw new Error(`buildProduct: ${path}.${key} must be a data property, not an accessor`);
+      }
+      if (key === "agent_url" || /(^|_)(?:format_ids?|v1_format_ref)($|_)/.test(key)) {
+        throw new Error(`buildProduct: ${path}.${key} contains legacy creative identity`);
+      }
+      Object.defineProperty(clone, key, {
+        configurable: true,
+        enumerable: true,
+        writable: true,
+        value: cloneCanonicalProductData(descriptor.value, `${path}.${key}`, active)
+      });
+    }
+    return clone;
+  } finally {
+    active.delete(value);
+  }
+}
 function resolvePublisherProperties(input) {
   if (input.publisher_properties && input.publisher_properties.length > 0) {
     return input.publisher_properties;
@@ -43,11 +133,42 @@ function resolvePublisherProperties(input) {
   );
 }
 function buildProduct(input) {
+  const extraDescriptor = Object.getOwnPropertyDescriptor(input, "extra");
+  if (extraDescriptor && !("value" in extraDescriptor)) {
+    throw new Error("buildProduct: extra must be an own data property, not an accessor");
+  }
+  const rawExtra = extraDescriptor?.value;
+  assertCanonicalProductExtra(rawExtra);
+  const extra = rawExtra === void 0 ? void 0 : cloneCanonicalProductData(rawExtra, "extra");
+  const formatOptionsDescriptor = Object.getOwnPropertyDescriptor(input, "format_options");
+  if (!formatOptionsDescriptor || !("value" in formatOptionsDescriptor)) {
+    throw new Error("buildProduct: format_options must be an own data property");
+  }
+  const format_options = cloneCanonicalProductData(
+    formatOptionsDescriptor.value,
+    "format_options"
+  );
+  const pricing_options = resolvePricingOptions(input);
+  return {
+    ...extra ?? {},
+    product_id: input.id,
+    name: input.name,
+    description: input.description ?? input.name,
+    publisher_properties: resolvePublisherProperties(input),
+    format_options,
+    delivery_type: input.delivery_type,
+    pricing_options,
+    reporting_capabilities: input.reporting_capabilities ?? DEFAULT_REPORTING_CAPABILITIES,
+    ...input.channels && input.channels.length > 0 && { channels: [...input.channels] },
+    ...input.ctx_metadata !== void 0 && { ctx_metadata: input.ctx_metadata }
+  };
+}
+function buildProductLegacy(input) {
   const formats = input.formats.map((f) => {
     if (typeof f === "string") {
       if (!input.agentUrl) {
         throw new Error(
-          `buildProduct: ${input.id} declares format '${f}' as a bare string, but \`agentUrl\` is required to build the wire \`{ id, agent_url }\` shape. Pass \`agentUrl\` on the input, OR pass each format as \`{ id, agent_url }\` directly.`
+          `buildProductLegacy: ${input.id} declares format '${f}' as a bare string, but \`agentUrl\` is required to build the wire \`{ id, agent_url }\` shape. Pass \`agentUrl\` on the input, OR pass each format as \`{ id, agent_url }\` directly.`
         );
       }
       return { id: f, agent_url: input.agentUrl };
@@ -55,18 +176,11 @@ function buildProduct(input) {
     if (f.agent_url) return f;
     if (input.agentUrl) return { ...f, agent_url: input.agentUrl };
     throw new Error(
-      `buildProduct: ${input.id} format '${f.id}' has no agent_url and no \`agentUrl\` was passed on the input.`
+      `buildProductLegacy: ${input.id} format '${f.id}' has no agent_url and no \`agentUrl\` was passed on the input.`
     );
   });
-  let pricing_options;
-  if (Array.isArray(input.pricing)) {
-    pricing_options = [...input.pricing];
-  } else if (input.pricing) {
-    pricing_options = [buildPricingOption(input.pricing)];
-  } else {
-    pricing_options = [buildPricingOption({ model: "cpm", floor: 0.01, currency: "USD" })];
-  }
-  const product = {
+  const pricing_options = resolvePricingOptions(input);
+  return {
     product_id: input.id,
     name: input.name,
     description: input.description ?? input.name,
@@ -79,7 +193,14 @@ function buildProduct(input) {
     ...input.ctx_metadata !== void 0 && { ctx_metadata: input.ctx_metadata },
     ...input.extra ?? {}
   };
-  return product;
+}
+function resolvePricingOptions(input) {
+  if (Array.isArray(input.pricing)) {
+    return [...input.pricing];
+  } else if (input.pricing) {
+    return [buildPricingOption(input.pricing)];
+  }
+  return [buildPricingOption({ model: "cpm", floor: 0.01, currency: "USD" })];
 }
 function buildPricingOption(input) {
   if (input.fixed !== void 0 && input.floor !== void 0) {
@@ -114,6 +235,7 @@ function buildPackage(input) {
 0 && (module.exports = {
   buildPackage,
   buildPricingOption,
-  buildProduct
+  buildProduct,
+  buildProductLegacy
 });
 //# sourceMappingURL=assembly-helpers.js.map

package/dist/lib/server/decisioning/assembly-helpers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/server/decisioning/assembly-helpers.ts"],"sourcesContent":["/**\n * Wire-shape assembly helpers.\n *\n * AdCP wire shapes carry many required fields (Product needs 8 required\n * properties; PricingOption needs at least 3 plus model-specific extras).\n * Building them by hand is the largest single source of validation\n * cascades in LLM-generated platforms (Emma matrix v18: a single missed\n * `format_ids[0].id` shape error swallowed 30+ storyboard steps).\n *\n * These helpers emit correct wire shapes from a flatter, intent-shaped\n * input. Adopters opt in — anything you don't pass in gets a sensible\n * default; anything required gets a clear TS error if you omit it.\n *\n * @public\n */\n\nimport type { Product, PricingOption, ReportingCapabilities } from '../../types/tools.generated';\n\n// ---------------------------------------------------------------------------\n// buildProduct\n// ---------------------------------------------------------------------------\n\nexport interface BuildProductInput {\n  /** Unique product id. */\n  id: string;\n\n  /** Human-readable name surfaced to buyers. */\n  name: string;\n\n  /** Description surfaced to buyers. Defaults to `name`. */\n  description?: string;\n\n  /**\n   * Format ids accepted on creatives bound to this product.\n   *\n   * Pass either:\n   *   - Array of strings → SDK wraps each as `{ id, agent_url }` using the\n   *     `agentUrl` you pass alongside (required for string-form formats —\n   *     wire schema requires `agent_url` per AdCP 3.0.1)\n   *   - Array of `{ id, agent_url }` for cross-agent format references\n   *     (each entry carries its own agent_url)\n   */\n  formats: ReadonlyArray<string | { id: string; agent_url?: string }>;\n\n  /**\n   * Your agent's URL (e.g., `'http://127.0.0.1:4200/mcp'` in tests, your\n   * production MCP endpoint live). Required when any entry in `formats` is\n   * a bare string (so the helper can build `{ id, agent_url }`). Ignored\n   * when every entry is `{ id, agent_url }`.\n   *\n   * Per AdCP 3.0.1, `format_ids[i].agent_url` is required on the wire shape\n   * — every format reference must point at the agent that defines that\n   * format. Pass once per `buildProduct` call and the helper threads it\n   * into each format ref.\n   */\n  agentUrl?: string;\n\n  /** `'guaranteed'` (reserved inventory) or `'non_guaranteed'` (auction / remnant). */\n  delivery_type: 'guaranteed' | 'non_guaranteed';\n\n  /**\n   * One or more pricing options. Pass strings for \"default CPM with floor\"\n   * convenience, or full `PricingOption` objects for fine-grained control.\n   *\n   * Convenience shortcut: `pricing: { model: 'cpm', floor: 5, currency: 'USD' }`\n   * builds a single CPM auction pricing option with the given floor.\n   */\n  pricing?:\n    | {\n        model: 'cpm' | 'vcpm' | 'cpc' | 'cpcv' | 'cpv' | 'cpp' | 'cpa' | 'flat_rate' | 'time';\n        floor?: number;\n        fixed?: number;\n        currency?: string;\n        pricing_option_id?: string;\n      }\n    | ReadonlyArray<PricingOption>;\n\n  /**\n   * Shortcut for the common single-publisher case: pass the domain (e.g.,\n   * `'sports.example'`) and the helper builds `publisher_properties: [{\n   * publisher_domain: '<domain>', selection_type: 'all' }]`.\n   *\n   * Use `publisher_properties` directly for multi-domain or by-id / by-tag\n   * selection.\n   */\n  publisher_domain?: string;\n\n  /**\n   * Publisher properties this product covers. Required (per AdCP 3.0.1\n   * product schema) — pass `publisher_domain` for the common single-domain\n   * shortcut, OR pass this directly for fine-grained selection.\n   *\n   * Each entry is a discriminated union by `selection_type`:\n   *   - `'all'` — select all properties at the publisher_domain\n   *   - `'by_id'` — select specific property_ids[]\n   *   - `'by_tag'` — select by property_tags[]\n   */\n  publisher_properties?: ReadonlyArray<\n    | { publisher_domain: string; selection_type: 'all' }\n    | {\n        publisher_domain: string;\n        selection_type: 'by_id';\n        property_ids: ReadonlyArray<{ property_type: string; identifier: string; [k: string]: unknown }>;\n      }\n    | { publisher_domain: string; selection_type: 'by_tag'; property_tags: ReadonlyArray<string> }\n  >;\n\n  /** Reporting capabilities. Defaults to hourly+daily impressions/spend/clicks. */\n  reporting_capabilities?: ReportingCapabilities;\n\n  /** Channels this product targets (`'display'`, `'video'`, etc.). */\n  channels?: ReadonlyArray<string>;\n\n  /** Adapter-internal opaque blob round-tripped by the SDK. */\n  ctx_metadata?: unknown;\n\n  /** Anything else on the wire shape (escape hatch). */\n  extra?: Record<string, unknown>;\n}\n\nconst DEFAULT_REPORTING_CAPABILITIES: ReportingCapabilities = {\n  available_reporting_frequencies: ['hourly', 'daily'],\n  expected_delay_minutes: 60,\n  timezone: 'UTC',\n  supports_webhooks: false,\n  available_metrics: ['impressions', 'spend', 'clicks'],\n  date_range_support: 'date_range',\n} as ReportingCapabilities;\n\nfunction resolvePublisherProperties(input: BuildProductInput): ReadonlyArray<unknown> {\n  if (input.publisher_properties && input.publisher_properties.length > 0) {\n    return input.publisher_properties;\n  }\n  if (input.publisher_domain) {\n    return [{ publisher_domain: input.publisher_domain, selection_type: 'all' }];\n  }\n  throw new Error(\n    `buildProduct: ${input.id} requires either \\`publisher_domain\\` (single-publisher shortcut) ` +\n      `or \\`publisher_properties\\` (multi-domain / by-id / by-tag selection). The wire schema requires ` +\n      `at least one publisher_property entry per product.`\n  );\n}\n\n/**\n * Build a wire-correct `Product` from intent-shaped input. Required fields\n * (per AdCP 3.0.1 product.json) are filled in with sensible defaults when\n * omitted; the caller can override any of them.\n *\n * @example Catalog product (minimal)\n * ```ts\n * const product = buildProduct({\n *   id: 'sports_display_auction',\n *   name: 'Sports Display Auction',\n *   formats: ['display_300x250', 'display_728x90'],\n *   delivery_type: 'non_guaranteed',\n *   pricing: { model: 'cpm', floor: 5.0, currency: 'USD' },\n *   ctx_metadata: { gam: { ad_unit_ids: ['au_123'] } },\n * });\n * ```\n *\n * @example Multi-pricing-option product\n * ```ts\n * const product = buildProduct({\n *   id: 'premium_homepage',\n *   name: 'Premium Homepage Takeover',\n *   formats: [{ id: 'display_970x250' }],\n *   delivery_type: 'guaranteed',\n *   pricing: [\n *     buildPricingOption({ id: 'po_cpm', model: 'cpm', fixed: 25.0, currency: 'USD' }),\n *     buildPricingOption({ id: 'po_flat', model: 'flat_rate', fixed: 50000, currency: 'USD' }),\n *   ],\n * });\n * ```\n */\nexport function buildProduct(input: BuildProductInput): Product {\n  const formats = input.formats.map(f => {\n    if (typeof f === 'string') {\n      if (!input.agentUrl) {\n        throw new Error(\n          `buildProduct: ${input.id} declares format '${f}' as a bare string, but \\`agentUrl\\` is required ` +\n            `to build the wire \\`{ id, agent_url }\\` shape. Pass \\`agentUrl\\` on the input, OR pass each format ` +\n            `as \\`{ id, agent_url }\\` directly.`\n        );\n      }\n      return { id: f, agent_url: input.agentUrl };\n    }\n    if (f.agent_url) return f;\n    if (input.agentUrl) return { ...f, agent_url: input.agentUrl };\n    throw new Error(\n      `buildProduct: ${input.id} format '${f.id}' has no agent_url and no \\`agentUrl\\` was passed on the input.`\n    );\n  });\n\n  let pricing_options: PricingOption[];\n  if (Array.isArray(input.pricing)) {\n    pricing_options = [...input.pricing];\n  } else if (input.pricing) {\n    // Narrow: not an array, so it's the BuildPricingOptionInput shorthand object.\n    pricing_options = [buildPricingOption(input.pricing as BuildPricingOptionInput)];\n  } else {\n    // No pricing supplied — emit a single CPM placeholder so the wire shape\n    // validates. Adopters who skip pricing usually don't realize it's required.\n    pricing_options = [buildPricingOption({ model: 'cpm', floor: 0.01, currency: 'USD' })];\n  }\n\n  const product = {\n    product_id: input.id,\n    name: input.name,\n    description: input.description ?? input.name,\n    publisher_properties: resolvePublisherProperties(input),\n    format_ids: formats,\n    delivery_type: input.delivery_type,\n    pricing_options,\n    reporting_capabilities: input.reporting_capabilities ?? DEFAULT_REPORTING_CAPABILITIES,\n    ...(input.channels && input.channels.length > 0 && { channels: [...input.channels] }),\n    ...(input.ctx_metadata !== undefined && { ctx_metadata: input.ctx_metadata }),\n    ...(input.extra ?? {}),\n  } as unknown as Product;\n\n  return product;\n}\n\n// ---------------------------------------------------------------------------\n// buildPricingOption\n// ---------------------------------------------------------------------------\n\nexport interface BuildPricingOptionInput {\n  /** Pricing option id, unique within the product. Defaults to `${model}_${floor||fixed||'default'}`. */\n  id?: string;\n\n  /** Pricing model. */\n  model: 'cpm' | 'vcpm' | 'cpc' | 'cpcv' | 'cpv' | 'cpp' | 'cpa' | 'flat_rate' | 'time';\n\n  /** Fixed price per unit. Mutually exclusive with `floor`. */\n  fixed?: number;\n\n  /** Auction floor price. Mutually exclusive with `fixed`. */\n  floor?: number;\n\n  /** ISO 4217 currency code (e.g., `'USD'`, `'EUR'`). Defaults to `'USD'`. */\n  currency?: string;\n\n  /** Minimum spend requirement per package using this pricing option. */\n  min_spend_per_package?: number;\n}\n\n/**\n * Build a wire-correct `PricingOption` from intent-shaped input. Use the\n * shortcut on `buildProduct({ pricing })` for the common case; call\n * `buildPricingOption` directly when you need multiple options on a product.\n *\n * @example\n * ```ts\n * const cpm = buildPricingOption({ model: 'cpm', floor: 5.0, currency: 'USD' });\n * const flat = buildPricingOption({ id: 'po_flat', model: 'flat_rate', fixed: 50000, currency: 'USD' });\n * ```\n */\nexport function buildPricingOption(input: BuildPricingOptionInput): PricingOption {\n  if (input.fixed !== undefined && input.floor !== undefined) {\n    throw new Error(\n      'buildPricingOption: `fixed` and `floor` are mutually exclusive (CPM/etc. is either fixed-price or auction).'\n    );\n  }\n  const currency = input.currency ?? 'USD';\n  const idHint =\n    input.fixed != null ? `fixed_${input.fixed}` : input.floor != null ? `floor_${input.floor}` : 'default';\n  const opt = {\n    pricing_option_id: input.id ?? `${input.model}_${idHint}`,\n    pricing_model: input.model,\n    currency,\n    ...(input.fixed !== undefined && { fixed_price: input.fixed }),\n    ...(input.floor !== undefined && { floor_price: input.floor }),\n    ...(input.min_spend_per_package !== undefined && { min_spend_per_package: input.min_spend_per_package }),\n  } as unknown as PricingOption;\n  return opt;\n}\n\n// ---------------------------------------------------------------------------\n// buildPackage (createMediaBuy / getMediaBuys response packages)\n// ---------------------------------------------------------------------------\n\nexport interface BuildPackageInput {\n  id: string;\n  /** Buyer-supplied client-side reference (echoed from the request). */\n  buyer_ref?: string;\n  /** AdCP package status. Defaults to `'pending_creatives'` (just-created buys). */\n  status?:\n    | 'draft'\n    | 'pending_creatives'\n    | 'pending_start'\n    | 'active'\n    | 'paused'\n    | 'completed'\n    | 'canceled'\n    | 'rejected';\n  /** product_id this package was bound to. */\n  product_id?: string;\n  /** pricing_option_id selected for this package. */\n  pricing_option_id?: string;\n  /** Adapter-internal opaque blob round-tripped by the SDK. */\n  ctx_metadata?: unknown;\n  /** Anything else on the wire shape. */\n  extra?: Record<string, unknown>;\n}\n\n/**\n * Build a wire-correct package shape for a media buy response.\n *\n * @example\n * ```ts\n * createMediaBuy: async (req, ctx) => {\n *   const order = await this.gam.createOrder(req);\n *   return {\n *     media_buy_id: order.id,\n *     status: 'pending_creatives',\n *     packages: order.lineItems.map(li => buildPackage({\n *       id: li.id,\n *       buyer_ref: li.buyerRef,\n *       status: 'pending_creatives',\n *       ctx_metadata: { gam_line_item_id: li.gamLineItemId },\n *     })),\n *   };\n * }\n * ```\n */\nexport function buildPackage(input: BuildPackageInput): Record<string, unknown> {\n  return {\n    package_id: input.id,\n    status: input.status ?? 'pending_creatives',\n    ...(input.buyer_ref !== undefined && { buyer_ref: input.buyer_ref }),\n    ...(input.product_id !== undefined && { product_id: input.product_id }),\n    ...(input.pricing_option_id !== undefined && { pricing_option_id: input.pricing_option_id }),\n    ...(input.ctx_metadata !== undefined && { ctx_metadata: input.ctx_metadata }),\n    ...(input.extra ?? {}),\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/server/decisioning/assembly-helpers.ts"],"sourcesContent":["/**\n * Canonical decisioning assembly helpers.\n *\n * AdCP products carry many required fields (Product needs 8 required\n * properties; PricingOption needs at least 3 plus model-specific extras).\n * Building them by hand is a common source of validation cascades in\n * generated platforms. The primary product helper accepts only canonical\n * `format_options`; named-format assembly is explicitly `buildProductLegacy`.\n *\n * These helpers emit correct wire shapes from a flatter, intent-shaped\n * input. Adopters opt in — anything you don't pass in gets a sensible\n * default; anything required gets a clear TS error if you omit it.\n *\n * @public\n */\n\nimport type { Product, PricingOption, ReportingCapabilities } from '../../types/tools.generated';\nimport type { CanonicalProduct } from '../../v2/projection/creative-delivery';\nimport type { CanonicalFormatDeclaration } from '../../v2/projection/legacy-metadata';\n\n// ---------------------------------------------------------------------------\n// buildProduct\n// ---------------------------------------------------------------------------\n\n/** @deprecated Compatibility input for {@link buildProductLegacy}. */\nexport interface BuildProductLegacyInput {\n  /** Unique product id. */\n  id: string;\n\n  /** Human-readable name surfaced to buyers. */\n  name: string;\n\n  /** Description surfaced to buyers. Defaults to `name`. */\n  description?: string;\n\n  /**\n   * Format ids accepted on creatives bound to this product.\n   *\n   * Pass either:\n   *   - Array of strings → SDK wraps each as `{ id, agent_url }` using the\n   *     `agentUrl` you pass alongside (required for string-form formats —\n   *     wire schema requires `agent_url` per AdCP 3.0.1)\n   *   - Array of `{ id, agent_url }` for cross-agent format references\n   *     (each entry carries its own agent_url)\n   */\n  formats: ReadonlyArray<string | { id: string; agent_url?: string }>;\n\n  /**\n   * Your agent's URL (e.g., `'http://127.0.0.1:4200/mcp'` in tests, your\n   * production MCP endpoint live). Required when any entry in `formats` is\n   * a bare string (so the helper can build `{ id, agent_url }`). Ignored\n   * when every entry is `{ id, agent_url }`.\n   *\n   * Per AdCP 3.0.1, `format_ids[i].agent_url` is required on the wire shape\n   * — every format reference must point at the agent that defines that\n   * format. Pass once per `buildProduct` call and the helper threads it\n   * into each format ref.\n   */\n  agentUrl?: string;\n\n  /** `'guaranteed'` (reserved inventory) or `'non_guaranteed'` (auction / remnant). */\n  delivery_type: 'guaranteed' | 'non_guaranteed';\n\n  /**\n   * One or more pricing options. Pass strings for \"default CPM with floor\"\n   * convenience, or full `PricingOption` objects for fine-grained control.\n   *\n   * Convenience shortcut: `pricing: { model: 'cpm', floor: 5, currency: 'USD' }`\n   * builds a single CPM auction pricing option with the given floor.\n   */\n  pricing?:\n    | {\n        model: 'cpm' | 'vcpm' | 'cpc' | 'cpcv' | 'cpv' | 'cpp' | 'cpa' | 'flat_rate' | 'time';\n        floor?: number;\n        fixed?: number;\n        currency?: string;\n        pricing_option_id?: string;\n      }\n    | ReadonlyArray<PricingOption>;\n\n  /**\n   * Shortcut for the common single-publisher case: pass the domain (e.g.,\n   * `'sports.example'`) and the helper builds `publisher_properties: [{\n   * publisher_domain: '<domain>', selection_type: 'all' }]`.\n   *\n   * Use `publisher_properties` directly for multi-domain or by-id / by-tag\n   * selection.\n   */\n  publisher_domain?: string;\n\n  /**\n   * Publisher properties this product covers. Required (per AdCP 3.0.1\n   * product schema) — pass `publisher_domain` for the common single-domain\n   * shortcut, OR pass this directly for fine-grained selection.\n   *\n   * Each entry is a discriminated union by `selection_type`:\n   *   - `'all'` — select all properties at the publisher_domain\n   *   - `'by_id'` — select specific property_ids[]\n   *   - `'by_tag'` — select by property_tags[]\n   */\n  publisher_properties?: ReadonlyArray<\n    | { publisher_domain: string; selection_type: 'all' }\n    | {\n        publisher_domain: string;\n        selection_type: 'by_id';\n        property_ids: ReadonlyArray<{ property_type: string; identifier: string; [k: string]: unknown }>;\n      }\n    | { publisher_domain: string; selection_type: 'by_tag'; property_tags: ReadonlyArray<string> }\n  >;\n\n  /** Reporting capabilities. Defaults to hourly+daily impressions/spend/clicks. */\n  reporting_capabilities?: ReportingCapabilities;\n\n  /** Channels this product targets (`'display'`, `'video'`, etc.). */\n  channels?: ReadonlyArray<string>;\n\n  /** Adapter-internal opaque blob round-tripped by the SDK. */\n  ctx_metadata?: unknown;\n\n  /** Additional non-identity product fields. Canonical fields and legacy creative identity are rejected. */\n  extra?: Record<string, unknown>;\n}\n\n/** Canonical product input used by the primary server SDK. */\nexport interface BuildProductInput extends Omit<BuildProductLegacyInput, 'formats' | 'agentUrl'> {\n  /** Canonical creative declarations accepted by this product. */\n  format_options: ReadonlyArray<CanonicalFormatDeclaration>;\n}\n\nconst DEFAULT_REPORTING_CAPABILITIES: ReportingCapabilities = {\n  available_reporting_frequencies: ['hourly', 'daily'],\n  expected_delay_minutes: 60,\n  timezone: 'UTC',\n  supports_webhooks: false,\n  available_metrics: ['impressions', 'spend', 'clicks'],\n  date_range_support: 'date_range',\n} as ReportingCapabilities;\n\nconst CANONICAL_PRODUCT_RESERVED_EXTRA_KEYS = new Set([\n  'product_id',\n  'name',\n  'description',\n  'publisher_properties',\n  'format_options',\n  'format_ids',\n  'delivery_type',\n  'pricing_options',\n  'reporting_capabilities',\n  'channels',\n  'ctx_metadata',\n]);\n\nfunction assertCanonicalProductExtra(extra: Record<string, unknown> | undefined): void {\n  if (!extra) return;\n  const seen = new WeakSet<object>();\n  const visit = (value: unknown, path: string, root: boolean): void => {\n    if (value === null || typeof value !== 'object' || seen.has(value)) return;\n    seen.add(value);\n    for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(value))) {\n      if (key === 'toJSON') {\n        throw new Error(`buildProduct: extra.${path}${key} is not allowed on canonical product data`);\n      }\n      if (!descriptor.enumerable) continue;\n      if (!('value' in descriptor)) {\n        throw new Error(`buildProduct: extra.${path}${key} must be a data property, not an accessor`);\n      }\n      if (typeof descriptor.value === 'function') {\n        throw new Error(`buildProduct: extra.${path}${key} must not be callable`);\n      }\n      if (root && CANONICAL_PRODUCT_RESERVED_EXTRA_KEYS.has(key)) {\n        throw new Error(`buildProduct: extra.${key} cannot override a canonical product field`);\n      }\n      if (key === 'agent_url' || /(^|_)(?:format_ids?|v1_format_ref)($|_)/.test(key)) {\n        throw new Error(`buildProduct: extra.${path}${key} contains legacy creative identity`);\n      }\n      visit(descriptor.value, `${path}${key}.`, false);\n    }\n  };\n  visit(extra, '', true);\n}\n\nfunction cloneCanonicalProductData<T>(value: T, path: string, active = new WeakSet<object>()): T {\n  if (typeof value === 'function') throw new Error(`buildProduct: ${path} must not be callable`);\n  if (value === null || typeof value !== 'object') return value;\n  if (active.has(value)) throw new Error(`buildProduct: ${path} must not contain cycles`);\n  active.add(value);\n  try {\n    const descriptors = Object.getOwnPropertyDescriptors(value);\n    if (Array.isArray(value)) {\n      const clone: unknown[] = [];\n      for (const [key, descriptor] of Object.entries(descriptors)) {\n        if (key === 'toJSON') {\n          throw new Error(`buildProduct: ${path}.${key} is not allowed on canonical product data`);\n        }\n        if (!descriptor.enumerable) continue;\n        if (!('value' in descriptor)) {\n          throw new Error(`buildProduct: ${path}[${key}] must be a data property, not an accessor`);\n        }\n        if (!/^(0|[1-9]\\d*)$/.test(key)) {\n          throw new Error(`buildProduct: ${path} has unsupported enumerable array property ${key}`);\n        }\n        clone[Number(key)] = cloneCanonicalProductData(descriptor.value, `${path}[${key}]`, active);\n      }\n      return clone as T;\n    }\n\n    const clone: Record<string, unknown> = {};\n    for (const [key, descriptor] of Object.entries(descriptors)) {\n      if (key === 'toJSON') {\n        throw new Error(`buildProduct: ${path}.${key} is not allowed on canonical product data`);\n      }\n      if (!descriptor.enumerable) continue;\n      if (!('value' in descriptor)) {\n        throw new Error(`buildProduct: ${path}.${key} must be a data property, not an accessor`);\n      }\n      if (key === 'agent_url' || /(^|_)(?:format_ids?|v1_format_ref)($|_)/.test(key)) {\n        throw new Error(`buildProduct: ${path}.${key} contains legacy creative identity`);\n      }\n      Object.defineProperty(clone, key, {\n        configurable: true,\n        enumerable: true,\n        writable: true,\n        value: cloneCanonicalProductData(descriptor.value, `${path}.${key}`, active),\n      });\n    }\n    return clone as T;\n  } finally {\n    active.delete(value);\n  }\n}\n\nfunction resolvePublisherProperties(input: BuildProductInput | BuildProductLegacyInput): ReadonlyArray<unknown> {\n  if (input.publisher_properties && input.publisher_properties.length > 0) {\n    return input.publisher_properties;\n  }\n  if (input.publisher_domain) {\n    return [{ publisher_domain: input.publisher_domain, selection_type: 'all' }];\n  }\n  throw new Error(\n    `buildProduct: ${input.id} requires either \\`publisher_domain\\` (single-publisher shortcut) ` +\n      `or \\`publisher_properties\\` (multi-domain / by-id / by-tag selection). The wire schema requires ` +\n      `at least one publisher_property entry per product.`\n  );\n}\n\n/**\n * Build a canonical `Product` from intent-shaped input. Required common\n * product fields are filled in with sensible defaults when omitted.\n *\n * @example Catalog product (minimal)\n * ```ts\n * const product = buildProduct({\n *   id: 'sports_display_auction',\n *   name: 'Sports Display Auction',\n *   format_options: [\n *     { format_option_id: 'medium-rectangle', format_kind: 'image', params: { width: 300, height: 250 } },\n *     { format_option_id: 'leaderboard', format_kind: 'image', params: { width: 728, height: 90 } },\n *   ],\n *   delivery_type: 'non_guaranteed',\n *   pricing: { model: 'cpm', floor: 5.0, currency: 'USD' },\n *   ctx_metadata: { gam: { ad_unit_ids: ['au_123'] } },\n * });\n * ```\n *\n * @example Multi-pricing-option product\n * ```ts\n * const product = buildProduct({\n *   id: 'premium_homepage',\n *   name: 'Premium Homepage Takeover',\n *   format_options: [\n *     { format_option_id: 'billboard', format_kind: 'image', params: { width: 970, height: 250 } },\n *   ],\n *   delivery_type: 'guaranteed',\n *   pricing: [\n *     buildPricingOption({ id: 'po_cpm', model: 'cpm', fixed: 25.0, currency: 'USD' }),\n *     buildPricingOption({ id: 'po_flat', model: 'flat_rate', fixed: 50000, currency: 'USD' }),\n *   ],\n * });\n * ```\n */\nexport function buildProduct(input: BuildProductInput): CanonicalProduct {\n  const extraDescriptor = Object.getOwnPropertyDescriptor(input, 'extra');\n  if (extraDescriptor && !('value' in extraDescriptor)) {\n    throw new Error('buildProduct: extra must be an own data property, not an accessor');\n  }\n  const rawExtra = extraDescriptor?.value as Record<string, unknown> | undefined;\n  assertCanonicalProductExtra(rawExtra);\n  const extra = rawExtra === undefined ? undefined : cloneCanonicalProductData(rawExtra, 'extra');\n  const formatOptionsDescriptor = Object.getOwnPropertyDescriptor(input, 'format_options');\n  if (!formatOptionsDescriptor || !('value' in formatOptionsDescriptor)) {\n    throw new Error('buildProduct: format_options must be an own data property');\n  }\n  const format_options = cloneCanonicalProductData(\n    formatOptionsDescriptor.value as ReadonlyArray<CanonicalFormatDeclaration>,\n    'format_options'\n  );\n  const pricing_options = resolvePricingOptions(input);\n\n  return {\n    ...(extra ?? {}),\n    product_id: input.id,\n    name: input.name,\n    description: input.description ?? input.name,\n    publisher_properties: resolvePublisherProperties(input),\n    format_options,\n    delivery_type: input.delivery_type,\n    pricing_options,\n    reporting_capabilities: input.reporting_capabilities ?? DEFAULT_REPORTING_CAPABILITIES,\n    ...(input.channels && input.channels.length > 0 && { channels: [...input.channels] }),\n    ...(input.ctx_metadata !== undefined && { ctx_metadata: input.ctx_metadata }),\n  } as unknown as CanonicalProduct;\n}\n\n/** @deprecated Explicit compatibility helper for legacy `format_ids` products. */\nexport function buildProductLegacy(input: BuildProductLegacyInput): Product {\n  const formats = input.formats.map(f => {\n    if (typeof f === 'string') {\n      if (!input.agentUrl) {\n        throw new Error(\n          `buildProductLegacy: ${input.id} declares format '${f}' as a bare string, but \\`agentUrl\\` is required ` +\n            `to build the wire \\`{ id, agent_url }\\` shape. Pass \\`agentUrl\\` on the input, OR pass each format ` +\n            `as \\`{ id, agent_url }\\` directly.`\n        );\n      }\n      return { id: f, agent_url: input.agentUrl };\n    }\n    if (f.agent_url) return f;\n    if (input.agentUrl) return { ...f, agent_url: input.agentUrl };\n    throw new Error(\n      `buildProductLegacy: ${input.id} format '${f.id}' has no agent_url and no \\`agentUrl\\` was passed on the input.`\n    );\n  });\n\n  const pricing_options = resolvePricingOptions(input);\n\n  return {\n    product_id: input.id,\n    name: input.name,\n    description: input.description ?? input.name,\n    publisher_properties: resolvePublisherProperties(input),\n    format_ids: formats,\n    delivery_type: input.delivery_type,\n    pricing_options,\n    reporting_capabilities: input.reporting_capabilities ?? DEFAULT_REPORTING_CAPABILITIES,\n    ...(input.channels && input.channels.length > 0 && { channels: [...input.channels] }),\n    ...(input.ctx_metadata !== undefined && { ctx_metadata: input.ctx_metadata }),\n    ...(input.extra ?? {}),\n  } as unknown as Product;\n}\n\nfunction resolvePricingOptions(input: BuildProductInput | BuildProductLegacyInput): PricingOption[] {\n  if (Array.isArray(input.pricing)) {\n    return [...input.pricing];\n  } else if (input.pricing) {\n    // Narrow: not an array, so it's the BuildPricingOptionInput shorthand object.\n    return [buildPricingOption(input.pricing as BuildPricingOptionInput)];\n  }\n  // No pricing supplied — emit a single CPM placeholder so the wire shape\n  // validates. Adopters who skip pricing usually don't realize it's required.\n  return [buildPricingOption({ model: 'cpm', floor: 0.01, currency: 'USD' })];\n}\n\n// ---------------------------------------------------------------------------\n// buildPricingOption\n// ---------------------------------------------------------------------------\n\nexport interface BuildPricingOptionInput {\n  /** Pricing option id, unique within the product. Defaults to `${model}_${floor||fixed||'default'}`. */\n  id?: string;\n\n  /** Pricing model. */\n  model: 'cpm' | 'vcpm' | 'cpc' | 'cpcv' | 'cpv' | 'cpp' | 'cpa' | 'flat_rate' | 'time';\n\n  /** Fixed price per unit. Mutually exclusive with `floor`. */\n  fixed?: number;\n\n  /** Auction floor price. Mutually exclusive with `fixed`. */\n  floor?: number;\n\n  /** ISO 4217 currency code (e.g., `'USD'`, `'EUR'`). Defaults to `'USD'`. */\n  currency?: string;\n\n  /** Minimum spend requirement per package using this pricing option. */\n  min_spend_per_package?: number;\n}\n\n/**\n * Build a wire-correct `PricingOption` from intent-shaped input. Use the\n * shortcut on `buildProduct({ pricing })` for the common case; call\n * `buildPricingOption` directly when you need multiple options on a product.\n *\n * @example\n * ```ts\n * const cpm = buildPricingOption({ model: 'cpm', floor: 5.0, currency: 'USD' });\n * const flat = buildPricingOption({ id: 'po_flat', model: 'flat_rate', fixed: 50000, currency: 'USD' });\n * ```\n */\nexport function buildPricingOption(input: BuildPricingOptionInput): PricingOption {\n  if (input.fixed !== undefined && input.floor !== undefined) {\n    throw new Error(\n      'buildPricingOption: `fixed` and `floor` are mutually exclusive (CPM/etc. is either fixed-price or auction).'\n    );\n  }\n  const currency = input.currency ?? 'USD';\n  const idHint =\n    input.fixed != null ? `fixed_${input.fixed}` : input.floor != null ? `floor_${input.floor}` : 'default';\n  const opt = {\n    pricing_option_id: input.id ?? `${input.model}_${idHint}`,\n    pricing_model: input.model,\n    currency,\n    ...(input.fixed !== undefined && { fixed_price: input.fixed }),\n    ...(input.floor !== undefined && { floor_price: input.floor }),\n    ...(input.min_spend_per_package !== undefined && { min_spend_per_package: input.min_spend_per_package }),\n  } as unknown as PricingOption;\n  return opt;\n}\n\n// ---------------------------------------------------------------------------\n// buildPackage (createMediaBuy / getMediaBuys response packages)\n// ---------------------------------------------------------------------------\n\nexport interface BuildPackageInput {\n  id: string;\n  /** Buyer-supplied client-side reference (echoed from the request). */\n  buyer_ref?: string;\n  /** AdCP package status. Defaults to `'pending_creatives'` (just-created buys). */\n  status?:\n    | 'draft'\n    | 'pending_creatives'\n    | 'pending_start'\n    | 'active'\n    | 'paused'\n    | 'completed'\n    | 'canceled'\n    | 'rejected';\n  /** product_id this package was bound to. */\n  product_id?: string;\n  /** pricing_option_id selected for this package. */\n  pricing_option_id?: string;\n  /** Adapter-internal opaque blob round-tripped by the SDK. */\n  ctx_metadata?: unknown;\n  /** Anything else on the wire shape. */\n  extra?: Record<string, unknown>;\n}\n\n/**\n * Build a wire-correct package shape for a media buy response.\n *\n * @example\n * ```ts\n * createMediaBuy: async (req, ctx) => {\n *   const order = await this.gam.createOrder(req);\n *   return {\n *     media_buy_id: order.id,\n *     status: 'pending_creatives',\n *     packages: order.lineItems.map(li => buildPackage({\n *       id: li.id,\n *       buyer_ref: li.buyerRef,\n *       status: 'pending_creatives',\n *       ctx_metadata: { gam_line_item_id: li.gamLineItemId },\n *     })),\n *   };\n * }\n * ```\n */\nexport function buildPackage(input: BuildPackageInput): Record<string, unknown> {\n  return {\n    package_id: input.id,\n    status: input.status ?? 'pending_creatives',\n    ...(input.buyer_ref !== undefined && { buyer_ref: input.buyer_ref }),\n    ...(input.product_id !== undefined && { product_id: input.product_id }),\n    ...(input.pricing_option_id !== undefined && { pricing_option_id: input.pricing_option_id }),\n    ...(input.ctx_metadata !== undefined && { ctx_metadata: input.ctx_metadata }),\n    ...(input.extra ?? {}),\n  };\n}\n"],"mappings":"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","names":["clone"]}