@adcp/sdk 15.4.0 → 15.6.0

package/dist/lib/testing/pending-web-flow-store.js

@@ -0,0 +1,132 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var pending_web_flow_store_exports = {};
+__export(pending_web_flow_store_exports, {
+  assertPendingWebFlowStoreRoundTrip: () => assertPendingWebFlowStoreRoundTrip
+});
+module.exports = __toCommonJS(pending_web_flow_store_exports);
+var import_strict = __toESM(require("node:assert/strict"));
+var import_node_crypto = require("node:crypto");
+function createPendingWebFlowFixture(state, options) {
+  const createdAt = /* @__PURE__ */ new Date();
+  return {
+    state,
+    agentId: options.agentId ?? "pending-flow-store-conformance",
+    agentUrl: "https://agent.example/mcp",
+    codeVerifier: "conformance-only-pkce-verifier",
+    redirectUri: "https://buyer.example/oauth/callback",
+    resource: "https://resource.example/mcp",
+    resourceOverride: "https://resource.example/mcp",
+    resourceOverrideAction: "set",
+    resourceOverrideSnapshot: "https://previous-resource.example/mcp",
+    scope: "mcp.read mcp.write",
+    authorizationServerUrl: "https://auth.example/tenant",
+    authorizationServerIssuer: "https://auth.example/tenant",
+    clientInformation: {
+      client_id: "conformance-client",
+      client_secret: "conformance-only-client-secret",
+      client_id_issued_at: 17e8,
+      client_secret_expires_at: 0,
+      issuer: "https://auth.example/tenant",
+      redirect_uris: ["https://buyer.example/oauth/callback"],
+      token_endpoint_auth_method: "client_secret_post",
+      conformanceExtension: { retained: "client metadata" }
+    },
+    createdAt,
+    expiresAt: new Date(createdAt.getTime() + 10 * 60 * 1e3),
+    carry: options.carry !== void 0 ? structuredClone(options.carry) : {
+      user_id: "conformance-user",
+      return_to: "/dashboard",
+      nested: { values: ["one", 2, true, null, { retained: "yes" }] }
+    },
+    conformanceExtension: { retained: "future flow fields" }
+  };
+}
+async function assertPendingWebFlowStoreRoundTrip(store, options = {}) {
+  const newState = () => (0, import_node_crypto.randomBytes)(32).toString("base64url");
+  const flow = createPendingWebFlowFixture(newState(), options);
+  const expected = structuredClone(flow);
+  await store.put(flow);
+  import_strict.default.equal(await store.consume(newState()), null, "Unknown state must return null");
+  import_strict.default.deepStrictEqual(
+    await store.consume(flow.state),
+    expected,
+    "Pending flow must round-trip every field and Date"
+  );
+  import_strict.default.equal(await store.consume(flow.state), null, "Pending flow must only be consumed once");
+  const clear = {
+    ...createPendingWebFlowFixture(newState(), options),
+    resourceOverrideAction: "clear",
+    resourceOverrideSnapshot: null,
+    clientInformation: { client_id: "public-conformance-client", issuer: "https://auth.example/tenant" }
+  };
+  delete clear.resourceOverride;
+  const expectedClear = structuredClone(clear);
+  await store.put(clear);
+  import_strict.default.deepStrictEqual(
+    await store.consume(clear.state),
+    expectedClear,
+    "Clear flow must preserve null and absent fields"
+  );
+  import_strict.default.equal(await store.consume(clear.state), null, "Clear flow must only be consumed once");
+  const preserve = { ...createPendingWebFlowFixture(newState(), options) };
+  delete preserve.resourceOverride;
+  delete preserve.resourceOverrideAction;
+  delete preserve.resourceOverrideSnapshot;
+  const expectedPreserve = structuredClone(preserve);
+  await store.put(preserve);
+  import_strict.default.deepStrictEqual(
+    await store.consume(preserve.state),
+    expectedPreserve,
+    "Preserve-only flow must keep override fields absent"
+  );
+  import_strict.default.equal(await store.consume(preserve.state), null, "Preserve-only flow must only be consumed once");
+  const expired = createPendingWebFlowFixture(newState(), options);
+  expired.createdAt = new Date(Date.now() - 2 * 60 * 60 * 1e3);
+  expired.expiresAt = new Date(Date.now() - 60 * 60 * 1e3);
+  try {
+    await store.put(expired);
+  } catch {
+  }
+  import_strict.default.equal(await store.consume(expired.state), null, "Expired flow must return null");
+  const concurrent = createPendingWebFlowFixture(newState(), options);
+  const expectedConcurrent = structuredClone(concurrent);
+  await store.put(concurrent);
+  const duplicate = { ...structuredClone(expectedConcurrent), codeVerifier: "different-conformance-verifier" };
+  await import_strict.default.rejects(async () => store.put(duplicate), "Duplicate state must be rejected");
+  const results = await Promise.all([store.consume(concurrent.state), store.consume(concurrent.state)]);
+  const winners = results.filter((result) => result !== null);
+  import_strict.default.equal(winners.length, 1, "Concurrent consumes must return the flow exactly once");
+  import_strict.default.deepStrictEqual(winners[0], expectedConcurrent, "Concurrent consume must preserve the original flow");
+  import_strict.default.equal(await store.consume(concurrent.state), null, "Concurrent consume must delete the flow");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assertPendingWebFlowStoreRoundTrip
+});

package/dist/lib/testing/pending-web-flow-store.mjs

@@ -0,0 +1,98 @@
+import assert from "node:assert/strict";
+import { randomBytes } from "node:crypto";
+function createPendingWebFlowFixture(state, options) {
+  const createdAt = /* @__PURE__ */ new Date();
+  return {
+    state,
+    agentId: options.agentId ?? "pending-flow-store-conformance",
+    agentUrl: "https://agent.example/mcp",
+    codeVerifier: "conformance-only-pkce-verifier",
+    redirectUri: "https://buyer.example/oauth/callback",
+    resource: "https://resource.example/mcp",
+    resourceOverride: "https://resource.example/mcp",
+    resourceOverrideAction: "set",
+    resourceOverrideSnapshot: "https://previous-resource.example/mcp",
+    scope: "mcp.read mcp.write",
+    authorizationServerUrl: "https://auth.example/tenant",
+    authorizationServerIssuer: "https://auth.example/tenant",
+    clientInformation: {
+      client_id: "conformance-client",
+      client_secret: "conformance-only-client-secret",
+      client_id_issued_at: 17e8,
+      client_secret_expires_at: 0,
+      issuer: "https://auth.example/tenant",
+      redirect_uris: ["https://buyer.example/oauth/callback"],
+      token_endpoint_auth_method: "client_secret_post",
+      conformanceExtension: { retained: "client metadata" }
+    },
+    createdAt,
+    expiresAt: new Date(createdAt.getTime() + 10 * 60 * 1e3),
+    carry: options.carry !== void 0 ? structuredClone(options.carry) : {
+      user_id: "conformance-user",
+      return_to: "/dashboard",
+      nested: { values: ["one", 2, true, null, { retained: "yes" }] }
+    },
+    conformanceExtension: { retained: "future flow fields" }
+  };
+}
+async function assertPendingWebFlowStoreRoundTrip(store, options = {}) {
+  const newState = () => randomBytes(32).toString("base64url");
+  const flow = createPendingWebFlowFixture(newState(), options);
+  const expected = structuredClone(flow);
+  await store.put(flow);
+  assert.equal(await store.consume(newState()), null, "Unknown state must return null");
+  assert.deepStrictEqual(
+    await store.consume(flow.state),
+    expected,
+    "Pending flow must round-trip every field and Date"
+  );
+  assert.equal(await store.consume(flow.state), null, "Pending flow must only be consumed once");
+  const clear = {
+    ...createPendingWebFlowFixture(newState(), options),
+    resourceOverrideAction: "clear",
+    resourceOverrideSnapshot: null,
+    clientInformation: { client_id: "public-conformance-client", issuer: "https://auth.example/tenant" }
+  };
+  delete clear.resourceOverride;
+  const expectedClear = structuredClone(clear);
+  await store.put(clear);
+  assert.deepStrictEqual(
+    await store.consume(clear.state),
+    expectedClear,
+    "Clear flow must preserve null and absent fields"
+  );
+  assert.equal(await store.consume(clear.state), null, "Clear flow must only be consumed once");
+  const preserve = { ...createPendingWebFlowFixture(newState(), options) };
+  delete preserve.resourceOverride;
+  delete preserve.resourceOverrideAction;
+  delete preserve.resourceOverrideSnapshot;
+  const expectedPreserve = structuredClone(preserve);
+  await store.put(preserve);
+  assert.deepStrictEqual(
+    await store.consume(preserve.state),
+    expectedPreserve,
+    "Preserve-only flow must keep override fields absent"
+  );
+  assert.equal(await store.consume(preserve.state), null, "Preserve-only flow must only be consumed once");
+  const expired = createPendingWebFlowFixture(newState(), options);
+  expired.createdAt = new Date(Date.now() - 2 * 60 * 60 * 1e3);
+  expired.expiresAt = new Date(Date.now() - 60 * 60 * 1e3);
+  try {
+    await store.put(expired);
+  } catch {
+  }
+  assert.equal(await store.consume(expired.state), null, "Expired flow must return null");
+  const concurrent = createPendingWebFlowFixture(newState(), options);
+  const expectedConcurrent = structuredClone(concurrent);
+  await store.put(concurrent);
+  const duplicate = { ...structuredClone(expectedConcurrent), codeVerifier: "different-conformance-verifier" };
+  await assert.rejects(async () => store.put(duplicate), "Duplicate state must be rejected");
+  const results = await Promise.all([store.consume(concurrent.state), store.consume(concurrent.state)]);
+  const winners = results.filter((result) => result !== null);
+  assert.equal(winners.length, 1, "Concurrent consumes must return the flow exactly once");
+  assert.deepStrictEqual(winners[0], expectedConcurrent, "Concurrent consume must preserve the original flow");
+  assert.equal(await store.consume(concurrent.state), null, "Concurrent consume must delete the flow");
+}
+export {
+  assertPendingWebFlowStoreRoundTrip
+};

package/dist/lib/testing/storyboard/validations.d.mts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "15.4.0";
+export declare const RUNNER_CAPABILITY_VERSION = "15.6.0";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/testing/storyboard/validations.d.ts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "15.4.0";
+export declare const RUNNER_CAPABILITY_VERSION = "15.6.0";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/validation/get-products-request.d.mts

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+import type { CanonicalGetProductsRequest } from '../v2/projection/creative-delivery.mjs';
+type LooseObjectShapeFor<T extends object> = {
+    [K in keyof T]-?: undefined extends T[K] ? z.ZodOptional<z.ZodType<Exclude<T[K], undefined>, Exclude<T[K], undefined>>> : z.ZodType<T[K], T[K]>;
+};
+type ZodShapeOutput<U extends z.core.$ZodShape> = {
+    [K in keyof U as undefined extends z.output<U[K]> ? never : K]: z.output<U[K]>;
+} & {
+    [K in keyof U as undefined extends z.output<U[K]> ? K : never]?: z.output<U[K]>;
+};
+/** Portable loose-object facade retained across adopter declaration emit. */
+export type LooseObjectSchemaFor<T extends object> = {
+    extend<U extends z.core.$ZodShape>(shape: U): LooseObjectSchemaFor<Omit<T, keyof U> & ZodShapeOutput<U>>;
+} & z.ZodObject<LooseObjectShapeFor<T>, z.core.$loose> & z.ZodType<T & Record<string, unknown>, T & Record<string, unknown>>;
+/** Wire-compatible request schema, including the legacy `format_ids` selector. */
+export declare const LegacyGetProductsRequestSchema: z.ZodObject<{
+    adcp_version: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    adcp_major_version: z.ZodOptional<z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>>;
+    idempotency_key: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    buying_mode: z.ZodType<"brief" | "wholesale" | "refine", "brief" | "wholesale" | "refine", z.core.$ZodTypeInternals<"brief" | "wholesale" | "refine", "brief" | "wholesale" | "refine">>;
+    brief: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    refine: z.ZodOptional<z.ZodType<({
+        scope: "request";
+        ask: string;
+    } | {
+        scope: "product";
+        product_id: string;
+        action?: "include" | "omit" | "more_like_this";
+        ask?: string;
+    } | {
+        scope: "proposal";
+        proposal_id: string;
+        action?: "include" | "omit" | "finalize";
+        ask?: string;
+    })[], ({
+        scope: "request";
+        ask: string;
+    } | {
+        scope: "product";
+        product_id: string;
+        action?: "include" | "omit" | "more_like_this";
+        ask?: string;
+    } | {
+        scope: "proposal";
+        proposal_id: string;
+        action?: "include" | "omit" | "finalize";
+        ask?: string;
+    })[], z.core.$ZodTypeInternals<({
+        scope: "request";
+        ask: string;
+    } | {
+        scope: "product";
+        product_id: string;
+        action?: "include" | "omit" | "more_like_this";
+        ask?: string;
+    } | {
+        scope: "proposal";
+        proposal_id: string;
+        action?: "include" | "omit" | "finalize";
+        ask?: string;
+    })[], ({
+        scope: "request";
+        ask: string;
+    } | {
+        scope: "product";
+        product_id: string;
+        action?: "include" | "omit" | "more_like_this";
+        ask?: string;
+    } | {
+        scope: "proposal";
+        proposal_id: string;
+        action?: "include" | "omit" | "finalize";
+        ask?: string;
+    })[]>>>;
+    brand: z.ZodOptional<z.ZodType<import("../index.mjs").BrandReference, import("../index.mjs").BrandReference, z.core.$ZodTypeInternals<import("../index.mjs").BrandReference, import("../index.mjs").BrandReference>>>;
+    acceptance_context: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").AcceptanceContext, import("../types/tools.generated.mjs").AcceptanceContext, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").AcceptanceContext, import("../types/tools.generated.mjs").AcceptanceContext>>>;
+    catalog: z.ZodOptional<z.ZodType<import("../index.mjs").Catalog, import("../index.mjs").Catalog, z.core.$ZodTypeInternals<import("../index.mjs").Catalog, import("../index.mjs").Catalog>>>;
+    account: z.ZodOptional<z.ZodType<import("../index.mjs").AccountReference, import("../index.mjs").AccountReference, z.core.$ZodTypeInternals<import("../index.mjs").AccountReference, import("../index.mjs").AccountReference>>>;
+    preferred_delivery_types: z.ZodOptional<z.ZodType<import("../types/core.generated.mjs").DeliveryType[], import("../types/core.generated.mjs").DeliveryType[], z.core.$ZodTypeInternals<import("../types/core.generated.mjs").DeliveryType[], import("../types/core.generated.mjs").DeliveryType[]>>>;
+    filters: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").ProductFilters, import("../types/tools.generated.mjs").ProductFilters, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").ProductFilters, import("../types/tools.generated.mjs").ProductFilters>>>;
+    targeting_overlay: z.ZodOptional<z.ZodType<import("../index.mjs").TargetingOverlay, import("../index.mjs").TargetingOverlay, z.core.$ZodTypeInternals<import("../index.mjs").TargetingOverlay, import("../index.mjs").TargetingOverlay>>>;
+    media_buy_frequency_cap: z.ZodOptional<z.ZodType<{
+        suppress?: import("../index.mjs").Duration;
+        suppress_minutes?: number;
+        max_impressions?: number;
+        per?: import("../index.mjs").ReachUnit;
+        window?: import("../index.mjs").Duration;
+    }, {
+        suppress?: import("../index.mjs").Duration;
+        suppress_minutes?: number;
+        max_impressions?: number;
+        per?: import("../index.mjs").ReachUnit;
+        window?: import("../index.mjs").Duration;
+    }, z.core.$ZodTypeInternals<{
+        suppress?: import("../index.mjs").Duration;
+        suppress_minutes?: number;
+        max_impressions?: number;
+        per?: import("../index.mjs").ReachUnit;
+        window?: import("../index.mjs").Duration;
+    }, {
+        suppress?: import("../index.mjs").Duration;
+        suppress_minutes?: number;
+        max_impressions?: number;
+        per?: import("../index.mjs").ReachUnit;
+        window?: import("../index.mjs").Duration;
+    }>>>;
+    required_overlay_support: z.ZodOptional<z.ZodType<import("../types/core.generated.mjs").TargetingOverlayRequirements, import("../types/core.generated.mjs").TargetingOverlayRequirements, z.core.$ZodTypeInternals<import("../types/core.generated.mjs").TargetingOverlayRequirements, import("../types/core.generated.mjs").TargetingOverlayRequirements>>>;
+    required_media_buy_support: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").ProductMediaBuySupportRequirements, import("../types/tools.generated.mjs").ProductMediaBuySupportRequirements, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").ProductMediaBuySupportRequirements, import("../types/tools.generated.mjs").ProductMediaBuySupportRequirements>>>;
+    property_list: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").PropertyListReference, import("../types/tools.generated.mjs").PropertyListReference, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").PropertyListReference, import("../types/tools.generated.mjs").PropertyListReference>>>;
+    fields: z.ZodOptional<z.ZodType<("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], z.core.$ZodTypeInternals<("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[]>>>;
+    time_budget: z.ZodOptional<z.ZodType<import("../index.mjs").Duration, import("../index.mjs").Duration, z.core.$ZodTypeInternals<import("../index.mjs").Duration, import("../index.mjs").Duration>>>;
+    push_notification_config: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").PushNotificationConfig, import("../types/tools.generated.mjs").PushNotificationConfig, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").PushNotificationConfig, import("../types/tools.generated.mjs").PushNotificationConfig>>>;
+    pagination: z.ZodOptional<z.ZodType<import("../index.mjs").PaginationRequest, import("../index.mjs").PaginationRequest, z.core.$ZodTypeInternals<import("../index.mjs").PaginationRequest, import("../index.mjs").PaginationRequest>>>;
+    if_wholesale_feed_version: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    if_pricing_version: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    context: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").ContextObject, import("../types/tools.generated.mjs").ContextObject, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").ContextObject, import("../types/tools.generated.mjs").ContextObject>>>;
+    required_policies: z.ZodOptional<z.ZodType<string[], string[], z.core.$ZodTypeInternals<string[], string[]>>>;
+    ext: z.ZodOptional<z.ZodType<import("../index.mjs").ExtensionObject, import("../index.mjs").ExtensionObject, z.core.$ZodTypeInternals<import("../index.mjs").ExtensionObject, import("../index.mjs").ExtensionObject>>>;
+}, z.core.$loose> & z.ZodType<import("../index.mjs").LegacyGetProductsRequest & Record<string, unknown>, import("../index.mjs").LegacyGetProductsRequest & Record<string, unknown>, z.core.$ZodTypeInternals<import("../index.mjs").LegacyGetProductsRequest & Record<string, unknown>, import("../index.mjs").LegacyGetProductsRequest & Record<string, unknown>>>;
+/** Primary request schema; legacy `format_ids` selection is rejected. */
+export declare const GetProductsRequestSchema: LooseObjectSchemaFor<CanonicalGetProductsRequest>;
+export {};

package/dist/lib/validation/get-products-request.d.ts

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+import type { CanonicalGetProductsRequest } from '../v2/projection/creative-delivery';
+type LooseObjectShapeFor<T extends object> = {
+    [K in keyof T]-?: undefined extends T[K] ? z.ZodOptional<z.ZodType<Exclude<T[K], undefined>, Exclude<T[K], undefined>>> : z.ZodType<T[K], T[K]>;
+};
+type ZodShapeOutput<U extends z.core.$ZodShape> = {
+    [K in keyof U as undefined extends z.output<U[K]> ? never : K]: z.output<U[K]>;
+} & {
+    [K in keyof U as undefined extends z.output<U[K]> ? K : never]?: z.output<U[K]>;
+};
+/** Portable loose-object facade retained across adopter declaration emit. */
+export type LooseObjectSchemaFor<T extends object> = {
+    extend<U extends z.core.$ZodShape>(shape: U): LooseObjectSchemaFor<Omit<T, keyof U> & ZodShapeOutput<U>>;
+} & z.ZodObject<LooseObjectShapeFor<T>, z.core.$loose> & z.ZodType<T & Record<string, unknown>, T & Record<string, unknown>>;
+/** Wire-compatible request schema, including the legacy `format_ids` selector. */
+export declare const LegacyGetProductsRequestSchema: z.ZodObject<{
+    adcp_version: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    adcp_major_version: z.ZodOptional<z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>>;
+    idempotency_key: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    buying_mode: z.ZodType<"brief" | "wholesale" | "refine", "brief" | "wholesale" | "refine", z.core.$ZodTypeInternals<"brief" | "wholesale" | "refine", "brief" | "wholesale" | "refine">>;
+    brief: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    refine: z.ZodOptional<z.ZodType<({
+        scope: "request";
+        ask: string;
+    } | {
+        scope: "product";
+        product_id: string;
+        action?: "include" | "omit" | "more_like_this";
+        ask?: string;
+    } | {
+        scope: "proposal";
+        proposal_id: string;
+        action?: "include" | "omit" | "finalize";
+        ask?: string;
+    })[], ({
+        scope: "request";
+        ask: string;
+    } | {
+        scope: "product";
+        product_id: string;
+        action?: "include" | "omit" | "more_like_this";
+        ask?: string;
+    } | {
+        scope: "proposal";
+        proposal_id: string;
+        action?: "include" | "omit" | "finalize";
+        ask?: string;
+    })[], z.core.$ZodTypeInternals<({
+        scope: "request";
+        ask: string;
+    } | {
+        scope: "product";
+        product_id: string;
+        action?: "include" | "omit" | "more_like_this";
+        ask?: string;
+    } | {
+        scope: "proposal";
+        proposal_id: string;
+        action?: "include" | "omit" | "finalize";
+        ask?: string;
+    })[], ({
+        scope: "request";
+        ask: string;
+    } | {
+        scope: "product";
+        product_id: string;
+        action?: "include" | "omit" | "more_like_this";
+        ask?: string;
+    } | {
+        scope: "proposal";
+        proposal_id: string;
+        action?: "include" | "omit" | "finalize";
+        ask?: string;
+    })[]>>>;
+    brand: z.ZodOptional<z.ZodType<import("..").BrandReference, import("..").BrandReference, z.core.$ZodTypeInternals<import("..").BrandReference, import("..").BrandReference>>>;
+    acceptance_context: z.ZodOptional<z.ZodType<import("../types/tools.generated").AcceptanceContext, import("../types/tools.generated").AcceptanceContext, z.core.$ZodTypeInternals<import("../types/tools.generated").AcceptanceContext, import("../types/tools.generated").AcceptanceContext>>>;
+    catalog: z.ZodOptional<z.ZodType<import("..").Catalog, import("..").Catalog, z.core.$ZodTypeInternals<import("..").Catalog, import("..").Catalog>>>;
+    account: z.ZodOptional<z.ZodType<import("..").AccountReference, import("..").AccountReference, z.core.$ZodTypeInternals<import("..").AccountReference, import("..").AccountReference>>>;
+    preferred_delivery_types: z.ZodOptional<z.ZodType<import("../types/core.generated").DeliveryType[], import("../types/core.generated").DeliveryType[], z.core.$ZodTypeInternals<import("../types/core.generated").DeliveryType[], import("../types/core.generated").DeliveryType[]>>>;
+    filters: z.ZodOptional<z.ZodType<import("../types/tools.generated").ProductFilters, import("../types/tools.generated").ProductFilters, z.core.$ZodTypeInternals<import("../types/tools.generated").ProductFilters, import("../types/tools.generated").ProductFilters>>>;
+    targeting_overlay: z.ZodOptional<z.ZodType<import("..").TargetingOverlay, import("..").TargetingOverlay, z.core.$ZodTypeInternals<import("..").TargetingOverlay, import("..").TargetingOverlay>>>;
+    media_buy_frequency_cap: z.ZodOptional<z.ZodType<{
+        suppress?: import("..").Duration;
+        suppress_minutes?: number;
+        max_impressions?: number;
+        per?: import("..").ReachUnit;
+        window?: import("..").Duration;
+    }, {
+        suppress?: import("..").Duration;
+        suppress_minutes?: number;
+        max_impressions?: number;
+        per?: import("..").ReachUnit;
+        window?: import("..").Duration;
+    }, z.core.$ZodTypeInternals<{
+        suppress?: import("..").Duration;
+        suppress_minutes?: number;
+        max_impressions?: number;
+        per?: import("..").ReachUnit;
+        window?: import("..").Duration;
+    }, {
+        suppress?: import("..").Duration;
+        suppress_minutes?: number;
+        max_impressions?: number;
+        per?: import("..").ReachUnit;
+        window?: import("..").Duration;
+    }>>>;
+    required_overlay_support: z.ZodOptional<z.ZodType<import("../types/core.generated").TargetingOverlayRequirements, import("../types/core.generated").TargetingOverlayRequirements, z.core.$ZodTypeInternals<import("../types/core.generated").TargetingOverlayRequirements, import("../types/core.generated").TargetingOverlayRequirements>>>;
+    required_media_buy_support: z.ZodOptional<z.ZodType<import("../types/tools.generated").ProductMediaBuySupportRequirements, import("../types/tools.generated").ProductMediaBuySupportRequirements, z.core.$ZodTypeInternals<import("../types/tools.generated").ProductMediaBuySupportRequirements, import("../types/tools.generated").ProductMediaBuySupportRequirements>>>;
+    property_list: z.ZodOptional<z.ZodType<import("../types/tools.generated").PropertyListReference, import("../types/tools.generated").PropertyListReference, z.core.$ZodTypeInternals<import("../types/tools.generated").PropertyListReference, import("../types/tools.generated").PropertyListReference>>>;
+    fields: z.ZodOptional<z.ZodType<("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], z.core.$ZodTypeInternals<("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "identity" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "measurement_terms" | "performance_standards" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "overlay_support" | "collections" | "collection_targeting_allowed" | "media_buy_support" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "list_applications" | "brief_relevance" | "targeting_resolution" | "acceptance_policy_profile_ids" | "execution_requirements" | "expires_at" | "allowed_actions" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[]>>>;
+    time_budget: z.ZodOptional<z.ZodType<import("..").Duration, import("..").Duration, z.core.$ZodTypeInternals<import("..").Duration, import("..").Duration>>>;
+    push_notification_config: z.ZodOptional<z.ZodType<import("../types/tools.generated").PushNotificationConfig, import("../types/tools.generated").PushNotificationConfig, z.core.$ZodTypeInternals<import("../types/tools.generated").PushNotificationConfig, import("../types/tools.generated").PushNotificationConfig>>>;
+    pagination: z.ZodOptional<z.ZodType<import("..").PaginationRequest, import("..").PaginationRequest, z.core.$ZodTypeInternals<import("..").PaginationRequest, import("..").PaginationRequest>>>;
+    if_wholesale_feed_version: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    if_pricing_version: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    context: z.ZodOptional<z.ZodType<import("../types/tools.generated").ContextObject, import("../types/tools.generated").ContextObject, z.core.$ZodTypeInternals<import("../types/tools.generated").ContextObject, import("../types/tools.generated").ContextObject>>>;
+    required_policies: z.ZodOptional<z.ZodType<string[], string[], z.core.$ZodTypeInternals<string[], string[]>>>;
+    ext: z.ZodOptional<z.ZodType<import("..").ExtensionObject, import("..").ExtensionObject, z.core.$ZodTypeInternals<import("..").ExtensionObject, import("..").ExtensionObject>>>;
+}, z.core.$loose> & z.ZodType<import("..").LegacyGetProductsRequest & Record<string, unknown>, import("..").LegacyGetProductsRequest & Record<string, unknown>, z.core.$ZodTypeInternals<import("..").LegacyGetProductsRequest & Record<string, unknown>, import("..").LegacyGetProductsRequest & Record<string, unknown>>>;
+/** Primary request schema; legacy `format_ids` selection is rejected. */
+export declare const GetProductsRequestSchema: LooseObjectSchemaFor<CanonicalGetProductsRequest>;
+export {};

package/dist/lib/validation/get-products-request.js

@@ -0,0 +1,39 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var get_products_request_exports = {};
+__export(get_products_request_exports, {
+  GetProductsRequestSchema: () => GetProductsRequestSchema,
+  LegacyGetProductsRequestSchema: () => LegacyGetProductsRequestSchema
+});
+module.exports = __toCommonJS(get_products_request_exports);
+var import_zod = require("zod");
+var import_schemas = require('../types/schemas.generated.js');
+var import_inline_enums = require('../types/inline-enums.generated.js');
+const LegacyGetProductsRequestSchema = import_schemas.GetProductsRequestSchema;
+const canonicalGetProductsFields = import_inline_enums.GetProductsRequest_FieldsValues.filter(
+  (field) => field !== "format_ids"
+);
+const GetProductsRequestSchema = import_schemas.GetProductsRequestSchema.safeExtend({
+  fields: import_zod.z.array(import_zod.z.enum(canonicalGetProductsFields)).optional()
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GetProductsRequestSchema,
+  LegacyGetProductsRequestSchema
+});

package/dist/lib/validation/get-products-request.mjs

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import { GetProductsRequestSchema as GeneratedGetProductsRequestSchema } from "../types/schemas.generated.mjs";
+import { GetProductsRequest_FieldsValues } from "../types/inline-enums.generated.mjs";
+const LegacyGetProductsRequestSchema = GeneratedGetProductsRequestSchema;
+const canonicalGetProductsFields = GetProductsRequest_FieldsValues.filter(
+  (field) => field !== "format_ids"
+);
+const GetProductsRequestSchema = GeneratedGetProductsRequestSchema.safeExtend({
+  fields: z.array(z.enum(canonicalGetProductsFields)).optional()
+});
+export {
+  GetProductsRequestSchema,
+  LegacyGetProductsRequestSchema
+};

package/dist/lib/version.d.mts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "15.4.0";
+export declare const LIBRARY_VERSION = "15.6.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: "15.4.0";
+    readonly library: "15.6.0";
     readonly adcp: "3.2.3";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "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.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.2.1", "3.2", "3.2.2", "3.2.3"];
-    readonly generatedAt: "2026-10-08T17:53:59.048Z";
+    readonly generatedAt: "2026-10-09T11:44:03.363Z";
 };
 /**
  * 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 = "15.4.0";
+export declare const LIBRARY_VERSION = "15.6.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: "15.4.0";
+    readonly library: "15.6.0";
     readonly adcp: "3.2.3";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "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.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.2.1", "3.2", "3.2.2", "3.2.3"];
-    readonly generatedAt: "2026-10-08T17:53:59.048Z";
+    readonly generatedAt: "2026-10-09T11:44:03.363Z";
 };
 /**
  * Get the AdCP specification version this library is built for