@adcp/sdk 16.0.0-beta.7 → 16.0.0-beta.9

package/dist/lib/media-buy/property-policy.js

@@ -19,10 +19,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var property_policy_exports = {};
 __export(property_policy_exports, {
   ProductPropertyPolicyError: () => ProductPropertyPolicyError,
+  isSupportedPropertyIdentifierType: () => isSupportedPropertyIdentifierType,
   normalizeDomainForPropertyPolicy: () => normalizeDomainForPropertyPolicy,
   validateProductsAgainstPropertyPolicy: () => validateProductsAgainstPropertyPolicy
 });
 module.exports = __toCommonJS(property_policy_exports);
+var import_enums = require('../types/enums.generated.js');
+function isSupportedPropertyIdentifierType(type) {
+  return import_enums.PropertyIdentifierTypesValues.includes(type);
+}
 class ProductPropertyPolicyError extends Error {
   constructor(result) {
     super(
@@ -82,6 +87,8 @@ function compilePolicy(policy) {
   }
   return {
     allowedDomains,
+    publisherCatalogsConfigured: policy.publisherProperties !== void 0,
+    publisherProperties: policy.publisherProperties ?? {},
     allowedPropertyIdentifiers: [...policy.allowedPropertyIdentifiers ?? []],
     requireAllowedPropertyMatch: policy.requireAllowedPropertyMatch ?? Boolean(policy.allowedDomains?.length || policy.allowedPropertyIdentifiers?.length),
     excludedDomainsByComparable,
@@ -116,6 +123,18 @@ function diagnosticsForProduct(product, productIndex, policy) {
       hasEligibleSubsetSelector = true;
     }
   });
+  if (requiresSubsetMatch) {
+    const scopes = publisherProperties.flatMap(
+      (selector) => selector && typeof selector === "object" && !Array.isArray(selector) ? [identifierScopeForSelector(selector, policy)] : []
+    );
+    if (scopes.some((scope) => scope?.hasNonMatch) && !scopes.some((scope) => scope?.hasMatch))
+      hasEligibleSubsetSelector = false;
+  }
+  if (requiresSubsetMatch && hasEligibleSubsetSelector) {
+    for (const diagnostic of diagnostics) {
+      if (diagnostic.code === "unresolved_property_identifiers") diagnostic.severity = "flagged";
+    }
+  }
   if (requiresSubsetMatch && !hasEligibleSubsetSelector) {
     diagnostics.push({
       code: "outside_property_list",
@@ -141,6 +160,7 @@ function diagnosticsForSelector(rawSelector, productIndex, selectorIndex, produc
     });
   }
   const selector = rawSelector;
+  const identifierScope = identifierScopeForSelector(selector, policy);
   const selectionType = typeof selector.selection_type === "string" ? selector.selection_type : void 0;
   const domainCandidates = publisherDomainCandidates(selector, path);
   const normalizedDomains = domainCandidates.map((candidate) => ({ candidate, normalized: normalizeDomainForPropertyPolicy(candidate.raw) })).filter(
@@ -192,7 +212,27 @@ function diagnosticsForSelector(rawSelector, productIndex, selectorIndex, produc
   }
   for (const { candidate, normalized: normalizedDomain } of normalizedDomains) {
     const matchedAllowedDomain = matchedAllowedDomainForCandidate(normalizedDomain, policy);
-    if (options.enforceEveryDomainInAllowedScope && hasAllowedPropertyScope(policy) && !matchedAllowedDomain) {
+    const needsCatalogForExclusions = policy.publisherCatalogsConfigured && (policy.excludedDomainsByComparable.size > 0 || selectionType !== "by_id" && policy.excludedPropertyIds.size > 0);
+    if ((hasAllowedPropertyScope(policy) || selectionType === "by_tag" || needsCatalogForExclusions) && identifierScope?.unknown) {
+      diagnostics.push(
+        ...diagnosticForBehavior(policy.unknownSelectorBehavior, {
+          code: "unresolved_property_identifiers",
+          identifier_types: [
+            ...new Set(
+              policy.allowedPropertyIdentifiers.filter((identifier) => identifier.type !== "domain" && identifier.type !== "subdomain").map((identifier) => identifier.type)
+            )
+          ],
+          message: "Publisher property identifiers could not be resolved; property-list membership is unknown.",
+          product_index: productIndex,
+          product_id: productId,
+          path,
+          publisher_property_index: selectorIndex,
+          selection_type: selectionType,
+          publisher_domain: candidate.raw
+        })
+      );
+    }
+    if (options.enforceEveryDomainInAllowedScope && hasAllowedPropertyScope(policy) && (identifierScope ? identifierScope.hasNonMatch : !matchedAllowedDomain)) {
       diagnostics.push({
         code: "outside_property_list",
         severity: "rejected",
@@ -227,6 +267,19 @@ function diagnosticsForSelector(rawSelector, productIndex, selectorIndex, produc
       });
     }
   }
+  if (options.enforceExclusions && identifierScope?.hasExcludedProperty) {
+    diagnostics.push({
+      code: "excluded_resolved_property",
+      severity: "rejected",
+      message: "Resolved publisher properties include a buyer-excluded property.",
+      product_index: productIndex,
+      product_id: productId,
+      path,
+      publisher_property_index: selectorIndex,
+      selection_type: selectionType,
+      publisher_domain: domainCandidates[0]?.raw
+    });
+  }
   if (selectionType === "by_id") {
     const propertyIds = stringArray(selector.property_ids);
     const matchedPropertyIds = propertyIds.filter((id) => policy.excludedPropertyIds.has(id));
@@ -248,7 +301,7 @@ function diagnosticsForSelector(rawSelector, productIndex, selectorIndex, produc
         matched_property_ids: matchedPropertyIds
       });
     }
-  } else if (selectionType === "by_tag") {
+  } else if (selectionType === "by_tag" && !identifierScope) {
     diagnostics.push(
       ...diagnosticForBehavior(policy.unknownSelectorBehavior, {
         code: "unresolved_tag_selector",
@@ -264,7 +317,7 @@ function diagnosticsForSelector(rawSelector, productIndex, selectorIndex, produc
         normalized_domains: normalizedDomains.map((entry) => entry.normalized.host)
       })
     );
-  } else if (selectionType !== "all") {
+  } else if (selectionType !== "all" && selectionType !== "by_tag") {
     diagnostics.push(
       ...diagnosticForBehavior(policy.unknownSelectorBehavior, {
         code: "unknown_selector",
@@ -291,6 +344,14 @@ function selectorIsEligibleForSubsetTargeting(rawSelector, productIndex, selecto
   if (!rawSelector || typeof rawSelector !== "object" || Array.isArray(rawSelector)) return false;
   const selector = rawSelector;
   if (selector.publisher_domains !== void 0) return false;
+  const identifierScope = identifierScopeForSelector(selector, policy);
+  if (identifierScope) {
+    const domain = typeof selector.publisher_domain === "string" ? normalizeDomainForPropertyPolicy(selector.publisher_domain) : void 0;
+    if (!domain || policy.excludedDomainsByComparable.has(domain.comparable)) return false;
+    if (selector.selection_type !== "all" && selector.selection_type !== "by_id" && selector.selection_type !== "by_tag")
+      return false;
+    return identifierScope.hasMatch || identifierScope.unknown && !identifierScope.hasNonMatch && policy.unknownSelectorBehavior !== "reject";
+  }
   if (selector.selection_type === "by_tag") return false;
   if (selector.selection_type !== "all" && selector.selection_type !== "by_id") return false;
   const hasEligibleDomain = publisherDomainCandidates(selector, path).some((candidate) => {
@@ -317,6 +378,76 @@ function matchedAllowedDomainForCandidate(candidate, policy) {
   }
   return void 0;
 }
+function identifierScopeForSelector(selector, policy) {
+  if (!policy.allowedPropertyIdentifiers.some((id) => id.type !== "domain" && id.type !== "subdomain") && !policy.publisherCatalogsConfigured)
+    return void 0;
+  const propertyIds = selector.selection_type === "by_id" ? stringArray(selector.property_ids) : [];
+  const hasExcludedId = propertyIds.some((id) => policy.excludedPropertyIds.has(id));
+  const allIdsExcluded = propertyIds.length > 0 && propertyIds.every((id) => policy.excludedPropertyIds.has(id));
+  if (allIdsExcluded) return { allMatch: false, hasMatch: false, hasNonMatch: true, unknown: false };
+  const domain = typeof selector.publisher_domain === "string" ? normalizeDomainForPropertyPolicy(selector.publisher_domain) : void 0;
+  if (!domain) return { allMatch: false, hasMatch: false, hasNonMatch: hasExcludedId, unknown: true };
+  if (policy.excludedDomainsByComparable.has(domain.comparable))
+    return { allMatch: false, hasMatch: false, hasNonMatch: true, unknown: false };
+  const properties = Object.hasOwn(policy.publisherProperties, domain.host) ? policy.publisherProperties[domain.host] : void 0;
+  if (!properties && policy.publisherCatalogsConfigured)
+    return { allMatch: false, hasMatch: false, hasNonMatch: hasExcludedId, unknown: true };
+  if (!properties) {
+    const matchedDomain = !allIdsExcluded && Boolean(matchedAllowedDomainForCandidate(domain, policy));
+    const unknown2 = !matchedDomain && !allIdsExcluded || selector.selection_type === "by_tag";
+    return {
+      allMatch: matchedDomain && !unknown2 && !hasExcludedId,
+      hasMatch: matchedDomain && !unknown2,
+      hasNonMatch: hasExcludedId,
+      unknown: unknown2
+    };
+  }
+  if (!Array.isArray(properties) || properties.some(
+    (property) => !property || typeof property !== "object" || !Array.isArray(property.identifiers) || property.identifiers.some(
+      (identifier) => !identifier || typeof identifier.type !== "string" || typeof identifier.value !== "string"
+    ) || property.tags !== void 0 && (!Array.isArray(property.tags) || property.tags.some((tag) => typeof tag !== "string"))
+  )) {
+    return { allMatch: false, hasMatch: false, hasNonMatch: hasExcludedId, unknown: true };
+  }
+  let selected = [...properties];
+  let missingIds = false;
+  if (selector.selection_type === "by_id") {
+    const ids = stringArray(selector.property_ids);
+    missingIds = !ids.length || ids.some((id) => !properties.some((property) => property.property_id === id));
+    selected = selected.filter((property) => property.property_id && ids.includes(property.property_id));
+  } else if (selector.selection_type === "by_tag") {
+    const tags = stringArray(selector.property_tags);
+    if (!tags.length) return { allMatch: false, hasMatch: false, hasNonMatch: false, unknown: true };
+    selected = selected.filter((property) => property.tags?.some((tag) => tags.includes(tag)));
+  } else if (selector.selection_type !== "all") {
+    return { allMatch: false, hasMatch: false, hasNonMatch: false, unknown: true };
+  }
+  const excluded = selected.map(
+    (property) => policy.excludedPropertyIds.has(property.property_id ?? "") || property.identifiers.some(
+      (identifier) => (identifier.type === "domain" || identifier.type === "subdomain") && policy.excludedDomainsByComparable.has(normalizeDomainForPropertyPolicy(identifier.value)?.comparable ?? "")
+    )
+  );
+  const matches = selected.map(
+    (property, index) => !excluded[index] && (!hasAllowedPropertyScope(policy) || property.identifiers.some(
+      (candidate) => policy.allowedPropertyIdentifiers.some(
+        (allowed) => allowed.type === "domain" || allowed.type === "subdomain" ? (candidate.type === "domain" || candidate.type === "subdomain") && propertyListDomainMatches(candidate.value, allowed.value, allowed.type) : isSupportedPropertyIdentifierType(allowed.type) && candidate.type === allowed.type && candidate.value === allowed.value
+      ) || (candidate.type === "domain" || candidate.type === "subdomain") && policy.allowedDomains.some((allowed) => propertyListDomainMatches(candidate.value, allowed.input))
+    ))
+  );
+  const undecidable = selected.map(
+    (property, index) => !excluded[index] && (property.identifiers.length === 0 || property.identifiers.some(
+      (candidate) => !isSupportedPropertyIdentifierType(candidate.type) && policy.allowedPropertyIdentifiers.some((allowed) => allowed.type === candidate.type)
+    ))
+  );
+  const unknown = matches.some((match, index) => !match && undecidable[index]);
+  return {
+    allMatch: matches.length > 0 && matches.every(Boolean) && !unknown,
+    hasMatch: matches.some(Boolean),
+    hasNonMatch: missingIds || !selected.length || matches.some((match, index) => !match && !undecidable[index]),
+    hasExcludedProperty: excluded.some(Boolean),
+    unknown
+  };
+}
 function publisherDomainCandidates(selector, path) {
   const candidates = [];
   if (typeof selector.publisher_domain === "string") {
@@ -382,6 +513,7 @@ function isUsableHostname(host) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ProductPropertyPolicyError,
+  isSupportedPropertyIdentifierType,
   normalizeDomainForPropertyPolicy,
   validateProductsAgainstPropertyPolicy
 });

package/dist/lib/media-buy/property-policy.mjs

@@ -1,3 +1,7 @@
+import { PropertyIdentifierTypesValues } from "../types/enums.generated.mjs";
+function isSupportedPropertyIdentifierType(type) {
+  return PropertyIdentifierTypesValues.includes(type);
+}
 class ProductPropertyPolicyError extends Error {
   constructor(result) {
     super(
@@ -57,6 +61,8 @@ function compilePolicy(policy) {
   }
   return {
     allowedDomains,
+    publisherCatalogsConfigured: policy.publisherProperties !== void 0,
+    publisherProperties: policy.publisherProperties ?? {},
     allowedPropertyIdentifiers: [...policy.allowedPropertyIdentifiers ?? []],
     requireAllowedPropertyMatch: policy.requireAllowedPropertyMatch ?? Boolean(policy.allowedDomains?.length || policy.allowedPropertyIdentifiers?.length),
     excludedDomainsByComparable,
@@ -91,6 +97,18 @@ function diagnosticsForProduct(product, productIndex, policy) {
       hasEligibleSubsetSelector = true;
     }
   });
+  if (requiresSubsetMatch) {
+    const scopes = publisherProperties.flatMap(
+      (selector) => selector && typeof selector === "object" && !Array.isArray(selector) ? [identifierScopeForSelector(selector, policy)] : []
+    );
+    if (scopes.some((scope) => scope?.hasNonMatch) && !scopes.some((scope) => scope?.hasMatch))
+      hasEligibleSubsetSelector = false;
+  }
+  if (requiresSubsetMatch && hasEligibleSubsetSelector) {
+    for (const diagnostic of diagnostics) {
+      if (diagnostic.code === "unresolved_property_identifiers") diagnostic.severity = "flagged";
+    }
+  }
   if (requiresSubsetMatch && !hasEligibleSubsetSelector) {
     diagnostics.push({
       code: "outside_property_list",
@@ -116,6 +134,7 @@ function diagnosticsForSelector(rawSelector, productIndex, selectorIndex, produc
     });
   }
   const selector = rawSelector;
+  const identifierScope = identifierScopeForSelector(selector, policy);
   const selectionType = typeof selector.selection_type === "string" ? selector.selection_type : void 0;
   const domainCandidates = publisherDomainCandidates(selector, path);
   const normalizedDomains = domainCandidates.map((candidate) => ({ candidate, normalized: normalizeDomainForPropertyPolicy(candidate.raw) })).filter(
@@ -167,7 +186,27 @@ function diagnosticsForSelector(rawSelector, productIndex, selectorIndex, produc
   }
   for (const { candidate, normalized: normalizedDomain } of normalizedDomains) {
     const matchedAllowedDomain = matchedAllowedDomainForCandidate(normalizedDomain, policy);
-    if (options.enforceEveryDomainInAllowedScope && hasAllowedPropertyScope(policy) && !matchedAllowedDomain) {
+    const needsCatalogForExclusions = policy.publisherCatalogsConfigured && (policy.excludedDomainsByComparable.size > 0 || selectionType !== "by_id" && policy.excludedPropertyIds.size > 0);
+    if ((hasAllowedPropertyScope(policy) || selectionType === "by_tag" || needsCatalogForExclusions) && identifierScope?.unknown) {
+      diagnostics.push(
+        ...diagnosticForBehavior(policy.unknownSelectorBehavior, {
+          code: "unresolved_property_identifiers",
+          identifier_types: [
+            ...new Set(
+              policy.allowedPropertyIdentifiers.filter((identifier) => identifier.type !== "domain" && identifier.type !== "subdomain").map((identifier) => identifier.type)
+            )
+          ],
+          message: "Publisher property identifiers could not be resolved; property-list membership is unknown.",
+          product_index: productIndex,
+          product_id: productId,
+          path,
+          publisher_property_index: selectorIndex,
+          selection_type: selectionType,
+          publisher_domain: candidate.raw
+        })
+      );
+    }
+    if (options.enforceEveryDomainInAllowedScope && hasAllowedPropertyScope(policy) && (identifierScope ? identifierScope.hasNonMatch : !matchedAllowedDomain)) {
       diagnostics.push({
         code: "outside_property_list",
         severity: "rejected",
@@ -202,6 +241,19 @@ function diagnosticsForSelector(rawSelector, productIndex, selectorIndex, produc
       });
     }
   }
+  if (options.enforceExclusions && identifierScope?.hasExcludedProperty) {
+    diagnostics.push({
+      code: "excluded_resolved_property",
+      severity: "rejected",
+      message: "Resolved publisher properties include a buyer-excluded property.",
+      product_index: productIndex,
+      product_id: productId,
+      path,
+      publisher_property_index: selectorIndex,
+      selection_type: selectionType,
+      publisher_domain: domainCandidates[0]?.raw
+    });
+  }
   if (selectionType === "by_id") {
     const propertyIds = stringArray(selector.property_ids);
     const matchedPropertyIds = propertyIds.filter((id) => policy.excludedPropertyIds.has(id));
@@ -223,7 +275,7 @@ function diagnosticsForSelector(rawSelector, productIndex, selectorIndex, produc
         matched_property_ids: matchedPropertyIds
       });
     }
-  } else if (selectionType === "by_tag") {
+  } else if (selectionType === "by_tag" && !identifierScope) {
     diagnostics.push(
       ...diagnosticForBehavior(policy.unknownSelectorBehavior, {
         code: "unresolved_tag_selector",
@@ -239,7 +291,7 @@ function diagnosticsForSelector(rawSelector, productIndex, selectorIndex, produc
         normalized_domains: normalizedDomains.map((entry) => entry.normalized.host)
       })
     );
-  } else if (selectionType !== "all") {
+  } else if (selectionType !== "all" && selectionType !== "by_tag") {
     diagnostics.push(
       ...diagnosticForBehavior(policy.unknownSelectorBehavior, {
         code: "unknown_selector",
@@ -266,6 +318,14 @@ function selectorIsEligibleForSubsetTargeting(rawSelector, productIndex, selecto
   if (!rawSelector || typeof rawSelector !== "object" || Array.isArray(rawSelector)) return false;
   const selector = rawSelector;
   if (selector.publisher_domains !== void 0) return false;
+  const identifierScope = identifierScopeForSelector(selector, policy);
+  if (identifierScope) {
+    const domain = typeof selector.publisher_domain === "string" ? normalizeDomainForPropertyPolicy(selector.publisher_domain) : void 0;
+    if (!domain || policy.excludedDomainsByComparable.has(domain.comparable)) return false;
+    if (selector.selection_type !== "all" && selector.selection_type !== "by_id" && selector.selection_type !== "by_tag")
+      return false;
+    return identifierScope.hasMatch || identifierScope.unknown && !identifierScope.hasNonMatch && policy.unknownSelectorBehavior !== "reject";
+  }
   if (selector.selection_type === "by_tag") return false;
   if (selector.selection_type !== "all" && selector.selection_type !== "by_id") return false;
   const hasEligibleDomain = publisherDomainCandidates(selector, path).some((candidate) => {
@@ -292,6 +352,76 @@ function matchedAllowedDomainForCandidate(candidate, policy) {
   }
   return void 0;
 }
+function identifierScopeForSelector(selector, policy) {
+  if (!policy.allowedPropertyIdentifiers.some((id) => id.type !== "domain" && id.type !== "subdomain") && !policy.publisherCatalogsConfigured)
+    return void 0;
+  const propertyIds = selector.selection_type === "by_id" ? stringArray(selector.property_ids) : [];
+  const hasExcludedId = propertyIds.some((id) => policy.excludedPropertyIds.has(id));
+  const allIdsExcluded = propertyIds.length > 0 && propertyIds.every((id) => policy.excludedPropertyIds.has(id));
+  if (allIdsExcluded) return { allMatch: false, hasMatch: false, hasNonMatch: true, unknown: false };
+  const domain = typeof selector.publisher_domain === "string" ? normalizeDomainForPropertyPolicy(selector.publisher_domain) : void 0;
+  if (!domain) return { allMatch: false, hasMatch: false, hasNonMatch: hasExcludedId, unknown: true };
+  if (policy.excludedDomainsByComparable.has(domain.comparable))
+    return { allMatch: false, hasMatch: false, hasNonMatch: true, unknown: false };
+  const properties = Object.hasOwn(policy.publisherProperties, domain.host) ? policy.publisherProperties[domain.host] : void 0;
+  if (!properties && policy.publisherCatalogsConfigured)
+    return { allMatch: false, hasMatch: false, hasNonMatch: hasExcludedId, unknown: true };
+  if (!properties) {
+    const matchedDomain = !allIdsExcluded && Boolean(matchedAllowedDomainForCandidate(domain, policy));
+    const unknown2 = !matchedDomain && !allIdsExcluded || selector.selection_type === "by_tag";
+    return {
+      allMatch: matchedDomain && !unknown2 && !hasExcludedId,
+      hasMatch: matchedDomain && !unknown2,
+      hasNonMatch: hasExcludedId,
+      unknown: unknown2
+    };
+  }
+  if (!Array.isArray(properties) || properties.some(
+    (property) => !property || typeof property !== "object" || !Array.isArray(property.identifiers) || property.identifiers.some(
+      (identifier) => !identifier || typeof identifier.type !== "string" || typeof identifier.value !== "string"
+    ) || property.tags !== void 0 && (!Array.isArray(property.tags) || property.tags.some((tag) => typeof tag !== "string"))
+  )) {
+    return { allMatch: false, hasMatch: false, hasNonMatch: hasExcludedId, unknown: true };
+  }
+  let selected = [...properties];
+  let missingIds = false;
+  if (selector.selection_type === "by_id") {
+    const ids = stringArray(selector.property_ids);
+    missingIds = !ids.length || ids.some((id) => !properties.some((property) => property.property_id === id));
+    selected = selected.filter((property) => property.property_id && ids.includes(property.property_id));
+  } else if (selector.selection_type === "by_tag") {
+    const tags = stringArray(selector.property_tags);
+    if (!tags.length) return { allMatch: false, hasMatch: false, hasNonMatch: false, unknown: true };
+    selected = selected.filter((property) => property.tags?.some((tag) => tags.includes(tag)));
+  } else if (selector.selection_type !== "all") {
+    return { allMatch: false, hasMatch: false, hasNonMatch: false, unknown: true };
+  }
+  const excluded = selected.map(
+    (property) => policy.excludedPropertyIds.has(property.property_id ?? "") || property.identifiers.some(
+      (identifier) => (identifier.type === "domain" || identifier.type === "subdomain") && policy.excludedDomainsByComparable.has(normalizeDomainForPropertyPolicy(identifier.value)?.comparable ?? "")
+    )
+  );
+  const matches = selected.map(
+    (property, index) => !excluded[index] && (!hasAllowedPropertyScope(policy) || property.identifiers.some(
+      (candidate) => policy.allowedPropertyIdentifiers.some(
+        (allowed) => allowed.type === "domain" || allowed.type === "subdomain" ? (candidate.type === "domain" || candidate.type === "subdomain") && propertyListDomainMatches(candidate.value, allowed.value, allowed.type) : isSupportedPropertyIdentifierType(allowed.type) && candidate.type === allowed.type && candidate.value === allowed.value
+      ) || (candidate.type === "domain" || candidate.type === "subdomain") && policy.allowedDomains.some((allowed) => propertyListDomainMatches(candidate.value, allowed.input))
+    ))
+  );
+  const undecidable = selected.map(
+    (property, index) => !excluded[index] && (property.identifiers.length === 0 || property.identifiers.some(
+      (candidate) => !isSupportedPropertyIdentifierType(candidate.type) && policy.allowedPropertyIdentifiers.some((allowed) => allowed.type === candidate.type)
+    ))
+  );
+  const unknown = matches.some((match, index) => !match && undecidable[index]);
+  return {
+    allMatch: matches.length > 0 && matches.every(Boolean) && !unknown,
+    hasMatch: matches.some(Boolean),
+    hasNonMatch: missingIds || !selected.length || matches.some((match, index) => !match && !undecidable[index]),
+    hasExcludedProperty: excluded.some(Boolean),
+    unknown
+  };
+}
 function publisherDomainCandidates(selector, path) {
   const candidates = [];
   if (typeof selector.publisher_domain === "string") {
@@ -356,6 +486,7 @@ function isUsableHostname(host) {
 }
 export {
   ProductPropertyPolicyError,
+  isSupportedPropertyIdentifierType,
   normalizeDomainForPropertyPolicy,
   validateProductsAgainstPropertyPolicy
 };

package/dist/lib/protocols/index.js

@@ -54,6 +54,7 @@ __export(protocols_exports, {
   wrapFetchWithTransportDiagnostics: () => import_transportDiagnostics2.wrapFetchWithTransportDiagnostics
 });
 module.exports = __toCommonJS(protocols_exports);
+var import_errors = require('../errors/index.js');
 var import_mcp = require('./mcp.js');
 var import_mcp2 = require('./mcp.js');
 var import_mcp_scope = require('./mcp-scope.js');
@@ -70,13 +71,13 @@ var import_auth = require('../auth/index.js');
 var import_oauth = require('../auth/oauth/index.js');
 var import_authorization_required = require('../auth/oauth/authorization-required.js');
 var import_provider_cache = require('../auth/oauth/provider-cache.js');
-var import_errors = require('../errors/index.js');
+var import_errors2 = require('../errors/index.js');
 var import_signedRequestRejection = require('./signedRequestRejection.js');
 var import_net = require('../net/index.js');
 var import_validation = require('../validation/index.js');
 var import_tracing = require('../observability/tracing.js');
 var import_version = require('../version.js');
-var import_errors2 = require('../errors/index.js');
+var import_errors3 = require('../errors/index.js');
 var import_schema_loader = require('../validation/schema-loader.js');
 var import_client = require('../signing/client.js');
 var import_responseSizeLimit2 = require('./responseSizeLimit.js');
@@ -109,7 +110,7 @@ function resolveWireMajor(adcpVersion) {
   if (adcpVersion === void 0) return import_version.ADCP_MAJOR_VERSION;
   const parsed = (0, import_version.parseAdcpMajorVersion)(adcpVersion);
   if (!Number.isFinite(parsed)) {
-    throw new import_errors2.ConfigurationError(
+    throw new import_errors3.ConfigurationError(
       `adcpVersion ${JSON.stringify(adcpVersion)} is not a valid AdCP version. Expected a semver string (e.g. '3.0.1', '3.1.0-beta.1') or a legacy alias (e.g. 'v3').`,
       "adcpVersion"
     );
@@ -126,7 +127,7 @@ function bundleSupportsAdcpVersionField(bundleKey) {
   return parseInt(minorMatch[1], 10) >= 1;
 }
 function buildVersionEnvelope(adcpVersion, serverVersion) {
-  if (serverVersion === "v2") return {};
+  if (serverVersion === "v2") throw new import_errors.VersionUnsupportedError("request", "version", "v2");
   const wireMajor = resolveWireMajor(adcpVersion);
   const bundleKey = (0, import_schema_loader.resolveBundleKey)(adcpVersion ?? import_version.ADCP_VERSION);
   if (!bundleSupportsAdcpVersionField(bundleKey)) {
@@ -136,16 +137,9 @@ function buildVersionEnvelope(adcpVersion, serverVersion) {
   (0, import_schema_loader.validateAdcpVersionWire)(wireValue);
   return { adcp_major_version: wireMajor, adcp_version: wireValue };
 }
-let hasWarnedAboutV2PushNotificationSecret = false;
-function warnV2PushNotificationNeedsSecret() {
-  if (hasWarnedAboutV2PushNotificationSecret) return;
-  hasWarnedAboutV2PushNotificationSecret = true;
-  console.warn(
-    "[adcp] Suppressing push_notification_config for a v2 seller: AdCP 2.5 requires an `authentication` block and no `webhookSecret` is configured. Set `webhookSecret` to register async task-status webhooks with this agent, or move the agent to an AdCP 3.x pin, where the RFC 9421 webhook profile needs no shared secret."
-  );
-}
 function buildVersionEnvelopeForMode(mode, adcpVersion, serverVersion) {
-  if (mode === "none" || serverVersion === "v2") return {};
+  if (serverVersion === "v2") throw new import_errors.VersionUnsupportedError("request", "version", "v2");
+  if (mode === "none") return {};
   if (mode === "major-only") return { adcp_major_version: resolveWireMajor(adcpVersion) };
   return buildVersionEnvelope(adcpVersion, serverVersion);
 }
@@ -182,7 +176,7 @@ function prepareProtocolToolCall(agent, args, options = {}) {
   const argsWithVersion = applyVersionEnvelope(args, envelope);
   applyPublishedSchemaCompatibility(options.toolName, argsWithVersion, args);
   const effectiveBundle = typeof argsWithVersion.adcp_version === "string" ? (0, import_schema_loader.resolveBundleKey)(argsWithVersion.adcp_version) : void 0;
-  const usesApplicationRegistration = options.serverVersion !== "v2" && (0, import_adcp_version_config.isAdcpVersionAtLeast)(effectiveBundle, "3.1.0");
+  const usesApplicationRegistration = (0, import_adcp_version_config.isAdcpVersionAtLeast)(effectiveBundle, "3.1.0");
   let pushNotificationConfig;
   let applicationPushNotificationConfig;
   let operationId;
@@ -196,8 +190,6 @@ function prepareProtocolToolCall(agent, args, options = {}) {
           credentials: options.webhookSecret
         }
       };
-    } else if (options.serverVersion === "v2") {
-      warnV2PushNotificationNeedsSecret();
     } else {
       pushNotificationConfig = {
         url: options.webhookUrl,
@@ -373,7 +365,7 @@ class ProtocolClient {
                   }
                 );
               } catch (err) {
-                if (agent.oauth_client_credentials && (0, import_errors.is401Error)(err) && (0, import_signedRequestRejection.getSignedRequestRejection)(err)?.challenge?.scheme !== "signature") {
+                if (agent.oauth_client_credentials && (0, import_errors2.is401Error)(err) && (0, import_signedRequestRejection.getSignedRequestRejection)(err)?.challenge?.scheme !== "signature") {
                   const ccStorage = (0, import_oauth.getAgentStorage)(agent);
                   const allowPrivateIp = transport?.allowPrivateIp ?? (0, import_net.isLikelyPrivateUrl)(agent.agent_uri);
                   await (0, import_oauth.ensureClientCredentialsTokens)(agent, {
@@ -405,7 +397,7 @@ class ProtocolClient {
                       }
                     );
                   } catch (retryErr) {
-                    const rejection = (0, import_signedRequestRejection.getSignedRequestRejection)(retryErr) ?? ((0, import_errors.is401Error)(retryErr) ? (0, import_signedRequestRejection.getSignedRequestRejection)(err) : void 0);
+                    const rejection = (0, import_signedRequestRejection.getSignedRequestRejection)(retryErr) ?? ((0, import_errors2.is401Error)(retryErr) ? (0, import_signedRequestRejection.getSignedRequestRejection)(err) : void 0);
                     if (rejection) throw rejection;
                     await rethrowAsNeedsAuthorization(
                       retryErr,
@@ -447,7 +439,7 @@ class ProtocolClient {
                   transport?.legacyCompat
                 );
               } catch (err) {
-                if (agent.oauth_client_credentials && (0, import_errors.is401Error)(err) && (0, import_signedRequestRejection.getSignedRequestRejection)(err)?.challenge?.scheme !== "signature") {
+                if (agent.oauth_client_credentials && (0, import_errors2.is401Error)(err) && (0, import_signedRequestRejection.getSignedRequestRejection)(err)?.challenge?.scheme !== "signature") {
                   const ccStorage = (0, import_oauth.getAgentStorage)(agent);
                   const allowPrivateIp = transport?.allowPrivateIp ?? (0, import_net.isLikelyPrivateUrl)(agent.agent_uri);
                   await (0, import_oauth.ensureClientCredentialsTokens)(agent, {
@@ -476,7 +468,7 @@ class ProtocolClient {
                       transport?.legacyCompat
                     );
                   } catch (retryErr) {
-                    const rejection = (0, import_signedRequestRejection.getSignedRequestRejection)(retryErr) ?? ((0, import_errors.is401Error)(retryErr) ? (0, import_signedRequestRejection.getSignedRequestRejection)(err) : void 0);
+                    const rejection = (0, import_signedRequestRejection.getSignedRequestRejection)(retryErr) ?? ((0, import_errors2.is401Error)(retryErr) ? (0, import_signedRequestRejection.getSignedRequestRejection)(err) : void 0);
                     if (rejection) throw rejection;
                     await rethrowAsNeedsAuthorization(
                       retryErr,
@@ -512,9 +504,9 @@ async function rethrowAsNeedsAuthorization(err, agentUrl, fetchFn, signal, confi
   const signedRejection = (0, import_signedRequestRejection.getSignedRequestRejection)(err);
   if (signedRejection) throw signedRejection;
   if (err instanceof import_oauth.NeedsAuthorizationError) throw err;
-  if (!(0, import_errors.is401Error)(err)) return;
+  if (!(0, import_errors2.is401Error)(err)) return;
   if (recoveryMode === "static") {
-    throw new import_errors.AuthenticationCredentialsRejectedError(agentUrl, err);
+    throw new import_errors2.AuthenticationCredentialsRejectedError(agentUrl, err);
   }
   const allowPrivateIp = configuredAllowPrivateIp ?? (0, import_net.isLikelyPrivateUrl)(agentUrl);
   const requirements = await (0, import_oauth.discoverAuthorizationRequirements)(agentUrl, { allowPrivateIp, fetchFn, signal });

package/dist/lib/protocols/index.mjs

@@ -3,6 +3,7 @@ import { dirname as __adcpDirname } from "node:path";
 import { createRequire as __adcpCreateRequire } from "node:module";
 const __dirname = __adcpDirname(__adcpFileURLToPath(import.meta.url));
 const require2 = __adcpCreateRequire(import.meta.url);
+import { VersionUnsupportedError } from "../errors/index.mjs";
 import {
   callMCPTool,
   callMCPToolWithOAuth,
@@ -104,7 +105,7 @@ function bundleSupportsAdcpVersionField(bundleKey) {
   return parseInt(minorMatch[1], 10) >= 1;
 }
 function buildVersionEnvelope(adcpVersion, serverVersion) {
-  if (serverVersion === "v2") return {};
+  if (serverVersion === "v2") throw new VersionUnsupportedError("request", "version", "v2");
   const wireMajor = resolveWireMajor(adcpVersion);
   const bundleKey = resolveBundleKey(adcpVersion ?? ADCP_VERSION);
   if (!bundleSupportsAdcpVersionField(bundleKey)) {
@@ -114,16 +115,9 @@ function buildVersionEnvelope(adcpVersion, serverVersion) {
   validateAdcpVersionWire(wireValue);
   return { adcp_major_version: wireMajor, adcp_version: wireValue };
 }
-let hasWarnedAboutV2PushNotificationSecret = false;
-function warnV2PushNotificationNeedsSecret() {
-  if (hasWarnedAboutV2PushNotificationSecret) return;
-  hasWarnedAboutV2PushNotificationSecret = true;
-  console.warn(
-    "[adcp] Suppressing push_notification_config for a v2 seller: AdCP 2.5 requires an `authentication` block and no `webhookSecret` is configured. Set `webhookSecret` to register async task-status webhooks with this agent, or move the agent to an AdCP 3.x pin, where the RFC 9421 webhook profile needs no shared secret."
-  );
-}
 function buildVersionEnvelopeForMode(mode, adcpVersion, serverVersion) {
-  if (mode === "none" || serverVersion === "v2") return {};
+  if (serverVersion === "v2") throw new VersionUnsupportedError("request", "version", "v2");
+  if (mode === "none") return {};
   if (mode === "major-only") return { adcp_major_version: resolveWireMajor(adcpVersion) };
   return buildVersionEnvelope(adcpVersion, serverVersion);
 }
@@ -160,7 +154,7 @@ function prepareProtocolToolCall(agent, args, options = {}) {
   const argsWithVersion = applyVersionEnvelope(args, envelope);
   applyPublishedSchemaCompatibility(options.toolName, argsWithVersion, args);
   const effectiveBundle = typeof argsWithVersion.adcp_version === "string" ? resolveBundleKey(argsWithVersion.adcp_version) : void 0;
-  const usesApplicationRegistration = options.serverVersion !== "v2" && isAdcpVersionAtLeast(effectiveBundle, "3.1.0");
+  const usesApplicationRegistration = isAdcpVersionAtLeast(effectiveBundle, "3.1.0");
   let pushNotificationConfig;
   let applicationPushNotificationConfig;
   let operationId;
@@ -174,8 +168,6 @@ function prepareProtocolToolCall(agent, args, options = {}) {
           credentials: options.webhookSecret
         }
       };
-    } else if (options.serverVersion === "v2") {
-      warnV2PushNotificationNeedsSecret();
     } else {
       pushNotificationConfig = {
         url: options.webhookUrl,

package/dist/lib/registry/index.d.mts

@@ -1,4 +1,7 @@
 import type { SupplyPathRequest, RegistrySupplyPathResult } from '../supply-path/types.mjs';
+export * from '../identifiers.mjs';
+export type { ResolveIdentifiersAllOptions, ResolveIdentifierOutcome } from './types.mjs';
+import type { ResolveIdentifiersAllOptions, ResolveIdentifierOutcome } from './types.mjs';
 import type { ResolvedBrand, LookupBrandOptions, ResolvedProperty, RegistryClientConfig, SaveBrandRequest, SaveBrandResponse, ListBrandLogosOptions, ListBrandLogosResponse, SaveBrandLogoInput, SaveBrandLogoResponse, UploadBrandLogoInput, UploadBrandLogoResponse, SavePropertyRequest, SavePropertyResponse, ResolveIdentifiersRequest, ResolveIdentifiersResponse, FileCatalogDisputeRequest, FileCatalogDisputeResponse, GetCatalogDisputeResponse, ClaimHostedPropertyDomainResponse, VerifyHostedPropertyOriginResponse, PropertyRegistryItem, ValidationResult, DomainLookupResult, ListBrandsOptions, ListBrandsResponse, GetBrandJsonResponse, ListOptions, ListAgentsOptions, ListAgentsResponse, ListPublishersResponse, ValidateAdagentsResponse, CreateAdagentsRequest, CreateAdagentsResponse, CommunityMirrorAdagentsConfig, CreateCommunityMirrorAdagentsConfig, CommunityMirrorAdagentsCatalog, PublishCommunityMirrorAdagentsResponse, ListCommunityMirrorAdagentsResponse, DeleteCommunityMirrorAdagentsResponse, PublisherPropertySelector, FindCompanyResult, FeedQuery, FeedResponse, AgentSearchQuery, AgentSearchResponse, CrawlRequestResponse, ManagerRevalidationResponse, ListPoliciesQuery, ListPoliciesResponse, ResolvePolicyQuery, ResolvePolicyResponse, ResolvePoliciesBulkRequest, ResolvePoliciesBulkResponse, GetPolicyHistoryQuery, GetPolicyHistoryResponse, SavePolicyRequest, SavePolicyResponse, GetBrandHistoryQuery, GetBrandHistoryResponse, GetPropertyHistoryQuery, GetPropertyHistoryResponse, AgentComplianceDetail, OperatorLookupResult, PublisherLookupResult, GetAgentStoryboardStatusResponse, GetAgentStoryboardStatusBulkResponse } from './types.mjs';
 import type { FeedStreamQuery, FeedStreamMessage } from './feed-stream.mjs';
 export type { ResolvedBrand, LookupBrandOptions, ResolvedProperty, PropertyInfo, RegistryClientConfig, SaveBrandRequest, SaveBrandResponse, BrandLogoReviewStatus, ApprovedBrandLogoAsset, PendingBrandLogoAsset, ReviewedBrandLogoAsset, BrandLogoAsset, ListBrandLogosOptions, ListBrandLogosResponse, SaveBrandLogoInput, SaveBrandLogoResponse, UploadBrandLogoInput, UploadBrandLogoResponse, SavePropertyIdentity, RegistryPropertyIdentity, SavePropertyRequest, SavePropertyResponse, ResolveIdentifiersRequest, ResolveIdentifiersResponse, FileCatalogDisputeRequest, FileCatalogDisputeResponse, GetCatalogDisputeResponse, ClaimHostedPropertyDomainResponse, VerifyHostedPropertyOriginResponse, BrandRegistryItem, PropertyRegistryItem, ValidationResult, FederatedAgentWithDetails, FederatedPublisher, DomainLookupResult, ListBrandsOptions, ListBrandsResponse, GetBrandJsonResponse, ListOptions, ListAgentsOptions, ListAgentsResponse, ListPublishersResponse, ValidateAdagentsRequest, ValidateAdagentsResponse, CreateAdagentsRequest, CreateAdagentsResponse, AdagentsAuthorizedAgent, AdagentsCatalogFormat, AdagentsPlacementDefinition, AdagentsPlacementFormatReference, AdagentsPlacementFormatOption, AdagentsPlacementTag, CreatedAdagentsJson, CommunityMirrorAdagentsConfig, CreateCommunityMirrorAdagentsConfig, CommunityMirrorAdagentsCatalog, PublishCommunityMirrorAdagentsResponse, CommunityMirrorAdagentsSummary, ListCommunityMirrorAdagentsResponse, GetCommunityMirrorAdagentsResponse, PublishCommunityMirrorAdagentsRequest, PublishCommunityMirrorAdagentsError, DeleteCommunityMirrorAdagentsResponse, ValidateProductAuthorizationRequest, ExpandProductIdentifiersRequest, PublisherPropertySelector, CompanySearchResult, FindCompanyResult, FeedQuery, AgentSearchQuery, CrawlRequest, ManagerRevalidationRequest, ManagerRevalidationResponse, ListPoliciesQuery, ListPoliciesResponse, ResolvePolicyQuery, ResolvePolicyResponse, ResolvePoliciesBulkRequest, ResolvePoliciesBulkResponse, GetPolicyHistoryQuery, GetPolicyHistoryResponse, SavePolicyRequest, SavePolicyResponse, GetBrandHistoryQuery, GetBrandHistoryResponse, GetPropertyHistoryQuery, GetPropertyHistoryResponse, AgentComplianceDetail, StoryboardStatus, OperatorLookupResult, PublisherLookupResult, ComplianceChangedPayload, GetAgentStoryboardStatusResponse, GetAgentStoryboardStatusBulkResponse, } from './types.mjs';
@@ -151,6 +154,7 @@ export declare class RegistryClient {
         concurrency?: number;
     }): Promise<Record<string, SavePropertyResponse | {
         error: string;
+        cause?: Error;
     }>>;
     /**
      * Resolve catalog identifiers to stable property_rids.
@@ -158,6 +162,14 @@ export declare class RegistryClient {
      * contribution; `lookup` mode is read-only.
      */
     resolveIdentifiers(request: ResolveIdentifiersRequest): Promise<ResolveIdentifiersResponse>;
+    /**
+     * Bulk catalog registration (`resolve`, the default) or read-only `lookup`.
+     * Splits by identifier count and UTF-8 request bytes, bounds concurrency,
+     * and honors Retry-After on 429. Results retain input order and duplicates.
+     * Network/5xx failures are not retried: resolve contributions have additive
+     * activity logs even though identifier-to-RID mapping is idempotent.
+     */
+    resolveIdentifiersAll(request: ResolveIdentifiersRequest, options?: ResolveIdentifiersAllOptions): Promise<ResolveIdentifierOutcome[]>;
     /** File a catalog fact dispute. Requires authentication. */
     fileCatalogDispute(request: FileCatalogDisputeRequest): Promise<FileCatalogDisputeResponse>;
     /** Fetch a catalog dispute by id. */