@adcp/sdk 14.0.0-rc.33 → 14.0.0-rc.34

package/dist/lib/brand/domain.d.mts

@@ -0,0 +1,30 @@
+export type BrandDomainValidationCode = 'invalid_syntax' | 'not_registrable' | 'special_use_not_allowed';
+export declare class BrandDomainValidationError extends Error {
+    readonly code: BrandDomainValidationCode;
+    readonly domain: string;
+    constructor(code: BrandDomainValidationCode, domain: string);
+}
+export interface ValidateBrandDomainOptions {
+    /**
+     * Admit the protocol's narrow development-name set: subdomains of
+     * `.localhost`, `.test`, `.example`, or `.invalid`, plus the reserved
+     * `example.com`, `example.net`, and `example.org` names. Default false.
+     *
+     * This option is deliberately explicit and is never inferred from
+     * `NODE_ENV`. Bare `localhost` remains invalid because BrandRef wire syntax
+     * always requires a dotted domain. `.local` remains forbidden because it
+     * participates in multicast DNS.
+     */
+    allowDevelopmentDomains?: boolean;
+}
+/**
+ * Validate and canonicalize a BrandRef/BrandKey domain.
+ *
+ * The JSON Schema enforces portable dotted wire syntax. This helper adds the
+ * runtime policy needed before brand discovery: a production name must have a
+ * registrable domain in the pinned ICANN+PRIVATE Public Suffix List and must
+ * not be an IANA special-use name.
+ */
+export declare function validateBrandDomain(domain: string, options?: ValidateBrandDomainOptions): string;
+export declare function isDevelopmentBrandDomain(domain: string): boolean;
+export declare function isSpecialUseBrandDomain(domain: string): boolean;

package/dist/lib/brand/domain.d.ts

@@ -0,0 +1,30 @@
+export type BrandDomainValidationCode = 'invalid_syntax' | 'not_registrable' | 'special_use_not_allowed';
+export declare class BrandDomainValidationError extends Error {
+    readonly code: BrandDomainValidationCode;
+    readonly domain: string;
+    constructor(code: BrandDomainValidationCode, domain: string);
+}
+export interface ValidateBrandDomainOptions {
+    /**
+     * Admit the protocol's narrow development-name set: subdomains of
+     * `.localhost`, `.test`, `.example`, or `.invalid`, plus the reserved
+     * `example.com`, `example.net`, and `example.org` names. Default false.
+     *
+     * This option is deliberately explicit and is never inferred from
+     * `NODE_ENV`. Bare `localhost` remains invalid because BrandRef wire syntax
+     * always requires a dotted domain. `.local` remains forbidden because it
+     * participates in multicast DNS.
+     */
+    allowDevelopmentDomains?: boolean;
+}
+/**
+ * Validate and canonicalize a BrandRef/BrandKey domain.
+ *
+ * The JSON Schema enforces portable dotted wire syntax. This helper adds the
+ * runtime policy needed before brand discovery: a production name must have a
+ * registrable domain in the pinned ICANN+PRIVATE Public Suffix List and must
+ * not be an IANA special-use name.
+ */
+export declare function validateBrandDomain(domain: string, options?: ValidateBrandDomainOptions): string;
+export declare function isDevelopmentBrandDomain(domain: string): boolean;
+export declare function isSpecialUseBrandDomain(domain: string): boolean;

package/dist/lib/brand/domain.js

@@ -0,0 +1,109 @@
+"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 domain_exports = {};
+__export(domain_exports, {
+  BrandDomainValidationError: () => BrandDomainValidationError,
+  isDevelopmentBrandDomain: () => isDevelopmentBrandDomain,
+  isSpecialUseBrandDomain: () => isSpecialUseBrandDomain,
+  validateBrandDomain: () => validateBrandDomain
+});
+module.exports = __toCommonJS(domain_exports);
+var import_tldts = require("tldts");
+var import_canonicalize = require('../signing/agent-resolver/canonicalize.js');
+const DOTTED_WIRE_DOMAIN = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$/;
+const DEVELOPMENT_SUFFIXES = ["localhost", "test", "example", "invalid"];
+const DEVELOPMENT_EXACT_NAMES = /* @__PURE__ */ new Set(["example.com", "example.net", "example.org"]);
+const SPECIAL_USE_SUFFIXES = [
+  "alt",
+  "6tisch.arpa",
+  "eap.arpa",
+  "eap-noob.arpa",
+  "home.arpa",
+  "in-addr.arpa",
+  "ip6.arpa",
+  "ipv4only.arpa",
+  "resolver.arpa",
+  "service.arpa",
+  "example",
+  "example.com",
+  "example.net",
+  "example.org",
+  "invalid",
+  "local",
+  "localhost",
+  "onion",
+  "test"
+];
+class BrandDomainValidationError extends Error {
+  constructor(code, domain) {
+    const messages = {
+      invalid_syntax: "Brand domain must be a bare, lowercase-compatible dotted hostname",
+      not_registrable: "Brand domain must have a registrable public or private-suffix domain",
+      special_use_not_allowed: "IANA special-use brand domain is not allowed in production"
+    };
+    super(messages[code]);
+    this.code = code;
+    this.domain = domain;
+    this.name = "BrandDomainValidationError";
+  }
+  code;
+  domain;
+}
+function validateBrandDomain(domain, options = {}) {
+  if (typeof domain !== "string" || domain.length === 0 || /[\s/:@?#]/.test(domain)) {
+    throw new BrandDomainValidationError("invalid_syntax", domain);
+  }
+  let canonical;
+  try {
+    canonical = (0, import_canonicalize.canonicalizeHost)(domain);
+  } catch {
+    throw new BrandDomainValidationError("invalid_syntax", domain);
+  }
+  if (!DOTTED_WIRE_DOMAIN.test(canonical)) {
+    throw new BrandDomainValidationError("invalid_syntax", domain);
+  }
+  const developmentName = isDevelopmentBrandDomain(canonical);
+  if (developmentName && options.allowDevelopmentDomains === true) return canonical;
+  const parsed = (0, import_tldts.parse)(canonical, {
+    allowPrivateDomains: true,
+    detectSpecialUse: true,
+    extractHostname: false
+  });
+  if (parsed.isSpecialUse || developmentName || isSpecialUseBrandDomain(canonical)) {
+    throw new BrandDomainValidationError("special_use_not_allowed", domain);
+  }
+  if (parsed.isIp || !parsed.domain || !parsed.isIcann && !parsed.isPrivate) {
+    throw new BrandDomainValidationError("not_registrable", domain);
+  }
+  return canonical;
+}
+function isDevelopmentBrandDomain(domain) {
+  if (DEVELOPMENT_EXACT_NAMES.has(domain)) return true;
+  return DEVELOPMENT_SUFFIXES.some((suffix) => domain.endsWith(`.${suffix}`));
+}
+function isSpecialUseBrandDomain(domain) {
+  return SPECIAL_USE_SUFFIXES.some((suffix) => domain === suffix || domain.endsWith(`.${suffix}`));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BrandDomainValidationError,
+  isDevelopmentBrandDomain,
+  isSpecialUseBrandDomain,
+  validateBrandDomain
+});

package/dist/lib/brand/domain.mjs

@@ -0,0 +1,82 @@
+import { parse as parseTld } from "tldts";
+import { canonicalizeHost } from "../signing/agent-resolver/canonicalize.mjs";
+const DOTTED_WIRE_DOMAIN = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$/;
+const DEVELOPMENT_SUFFIXES = ["localhost", "test", "example", "invalid"];
+const DEVELOPMENT_EXACT_NAMES = /* @__PURE__ */ new Set(["example.com", "example.net", "example.org"]);
+const SPECIAL_USE_SUFFIXES = [
+  "alt",
+  "6tisch.arpa",
+  "eap.arpa",
+  "eap-noob.arpa",
+  "home.arpa",
+  "in-addr.arpa",
+  "ip6.arpa",
+  "ipv4only.arpa",
+  "resolver.arpa",
+  "service.arpa",
+  "example",
+  "example.com",
+  "example.net",
+  "example.org",
+  "invalid",
+  "local",
+  "localhost",
+  "onion",
+  "test"
+];
+class BrandDomainValidationError extends Error {
+  constructor(code, domain) {
+    const messages = {
+      invalid_syntax: "Brand domain must be a bare, lowercase-compatible dotted hostname",
+      not_registrable: "Brand domain must have a registrable public or private-suffix domain",
+      special_use_not_allowed: "IANA special-use brand domain is not allowed in production"
+    };
+    super(messages[code]);
+    this.code = code;
+    this.domain = domain;
+    this.name = "BrandDomainValidationError";
+  }
+  code;
+  domain;
+}
+function validateBrandDomain(domain, options = {}) {
+  if (typeof domain !== "string" || domain.length === 0 || /[\s/:@?#]/.test(domain)) {
+    throw new BrandDomainValidationError("invalid_syntax", domain);
+  }
+  let canonical;
+  try {
+    canonical = canonicalizeHost(domain);
+  } catch {
+    throw new BrandDomainValidationError("invalid_syntax", domain);
+  }
+  if (!DOTTED_WIRE_DOMAIN.test(canonical)) {
+    throw new BrandDomainValidationError("invalid_syntax", domain);
+  }
+  const developmentName = isDevelopmentBrandDomain(canonical);
+  if (developmentName && options.allowDevelopmentDomains === true) return canonical;
+  const parsed = parseTld(canonical, {
+    allowPrivateDomains: true,
+    detectSpecialUse: true,
+    extractHostname: false
+  });
+  if (parsed.isSpecialUse || developmentName || isSpecialUseBrandDomain(canonical)) {
+    throw new BrandDomainValidationError("special_use_not_allowed", domain);
+  }
+  if (parsed.isIp || !parsed.domain || !parsed.isIcann && !parsed.isPrivate) {
+    throw new BrandDomainValidationError("not_registrable", domain);
+  }
+  return canonical;
+}
+function isDevelopmentBrandDomain(domain) {
+  if (DEVELOPMENT_EXACT_NAMES.has(domain)) return true;
+  return DEVELOPMENT_SUFFIXES.some((suffix) => domain.endsWith(`.${suffix}`));
+}
+function isSpecialUseBrandDomain(domain) {
+  return SPECIAL_USE_SUFFIXES.some((suffix) => domain === suffix || domain.endsWith(`.${suffix}`));
+}
+export {
+  BrandDomainValidationError,
+  isDevelopmentBrandDomain,
+  isSpecialUseBrandDomain,
+  validateBrandDomain
+};

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

@@ -1,5 +1,7 @@
 import type { RegistryClient, SaveBrandResponse } from '../registry/index.mjs';
 import type { GetBrandIdentitySuccess } from '../types/core.generated.mjs';
+export { BrandDomainValidationError, isDevelopmentBrandDomain, validateBrandDomain } from './domain.mjs';
+export type { BrandDomainValidationCode, ValidateBrandDomainOptions } from './domain.mjs';
 export type BrandJsonRecord = Record<string, unknown>;
 type ProtocolBrandLogo = NonNullable<GetBrandIdentitySuccess['logos']>[number];
 export type BrandWebsiteAliasRelationship = 'owned';
@@ -148,4 +150,3 @@ export declare function checkLogoSlotCoverage(brandJsonOrBrand: BrandJsonRecord,
 export declare function updateBrandJsonFromMappings(options: UpdateBrandJsonFromMappingsOptions): Promise<UpdateBrandJsonFromMappingsResult>;
 export declare function extractBrandWebsiteAliases(brandJsonOrBrand: BrandJsonRecord, options?: ExtractBrandWebsiteAliasesOptions): BrandWebsiteAlias[];
 export declare function extractBrandWebsiteAliasDomains(brandJsonOrBrand: BrandJsonRecord, options?: ExtractBrandWebsiteAliasesOptions): string[];
-export {};

package/dist/lib/brand/index.d.ts

@@ -1,5 +1,7 @@
 import type { RegistryClient, SaveBrandResponse } from '../registry';
 import type { GetBrandIdentitySuccess } from '../types/core.generated';
+export { BrandDomainValidationError, isDevelopmentBrandDomain, validateBrandDomain } from './domain';
+export type { BrandDomainValidationCode, ValidateBrandDomainOptions } from './domain';
 export type BrandJsonRecord = Record<string, unknown>;
 type ProtocolBrandLogo = NonNullable<GetBrandIdentitySuccess['logos']>[number];
 export type BrandWebsiteAliasRelationship = 'owned';
@@ -148,4 +150,3 @@ export declare function checkLogoSlotCoverage(brandJsonOrBrand: BrandJsonRecord,
 export declare function updateBrandJsonFromMappings(options: UpdateBrandJsonFromMappingsOptions): Promise<UpdateBrandJsonFromMappingsResult>;
 export declare function extractBrandWebsiteAliases(brandJsonOrBrand: BrandJsonRecord, options?: ExtractBrandWebsiteAliasesOptions): BrandWebsiteAlias[];
 export declare function extractBrandWebsiteAliasDomains(brandJsonOrBrand: BrandJsonRecord, options?: ExtractBrandWebsiteAliasesOptions): string[];
-export {};

package/dist/lib/brand/index.js

@@ -18,16 +18,20 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var brand_exports = {};
 __export(brand_exports, {
+  BrandDomainValidationError: () => import_domain.BrandDomainValidationError,
   COMMON_LOGO_SLOTS: () => COMMON_LOGO_SLOTS,
   applyBrandAssetMappings: () => applyBrandAssetMappings,
   checkLogoSlotCoverage: () => checkLogoSlotCoverage,
   extractBrandWebsiteAliasDomains: () => extractBrandWebsiteAliasDomains,
   extractBrandWebsiteAliases: () => extractBrandWebsiteAliases,
+  isDevelopmentBrandDomain: () => import_domain.isDevelopmentBrandDomain,
   selectLogoForSlot: () => selectLogoForSlot,
   updateBrandJsonFromMappings: () => updateBrandJsonFromMappings,
-  validateBrandAssetMappings: () => validateBrandAssetMappings
+  validateBrandAssetMappings: () => validateBrandAssetMappings,
+  validateBrandDomain: () => import_domain.validateBrandDomain
 });
 module.exports = __toCommonJS(brand_exports);
+var import_domain = require('./domain.js');
 const COMMON_LOGO_SLOTS = [
   "logo_card_light",
   "logo_card_dark",
@@ -464,12 +468,15 @@ function readLocalizedName(value) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BrandDomainValidationError,
   COMMON_LOGO_SLOTS,
   applyBrandAssetMappings,
   checkLogoSlotCoverage,
   extractBrandWebsiteAliasDomains,
   extractBrandWebsiteAliases,
+  isDevelopmentBrandDomain,
   selectLogoForSlot,
   updateBrandJsonFromMappings,
-  validateBrandAssetMappings
+  validateBrandAssetMappings,
+  validateBrandDomain
 });

package/dist/lib/brand/index.mjs

@@ -1,3 +1,4 @@
+import { BrandDomainValidationError, isDevelopmentBrandDomain, validateBrandDomain } from "./domain.mjs";
 const COMMON_LOGO_SLOTS = [
   "logo_card_light",
   "logo_card_dark",
@@ -433,12 +434,15 @@ function readLocalizedName(value) {
   return void 0;
 }
 export {
+  BrandDomainValidationError,
   COMMON_LOGO_SLOTS,
   applyBrandAssetMappings,
   checkLogoSlotCoverage,
   extractBrandWebsiteAliasDomains,
   extractBrandWebsiteAliases,
+  isDevelopmentBrandDomain,
   selectLogoForSlot,
   updateBrandJsonFromMappings,
-  validateBrandAssetMappings
+  validateBrandAssetMappings,
+  validateBrandDomain
 };

package/dist/lib/core/ConversationTypes.d.mts

@@ -345,6 +345,20 @@ export interface AdcpErrorInfo {
      * the field, `'enum'` → pick a valid value, `'type'` → fix the value type.
      */
     issues?: AdcpValidationIssue[];
+    /**
+     * Buyer-actionable classification of the failure. Present when the enclosing
+     * `code`/`message` is too coarse or carries producer-internal context that
+     * must not cross the buyer trust boundary. `code` reuses the standard error
+     * vocabulary; `message` is buyer-safe by spec — no vendor identifiers,
+     * ad-server type names, internal object names, internal IDs, or stack traces
+     * — so it may be rendered directly to a buyer UI. When present, the
+     * enclosing `recovery` classifies the buyer-actionable reason. See
+     * `core/error.json`'s `buyer_reason` field for the normative contract.
+     */
+    buyer_reason?: {
+        code: string;
+        message: string;
+    };
     /** True when the SDK inferred this error from unstructured text (L1 compliance) */
     synthetic?: boolean;
 }

package/dist/lib/core/ConversationTypes.d.ts

@@ -345,6 +345,20 @@ export interface AdcpErrorInfo {
      * the field, `'enum'` → pick a valid value, `'type'` → fix the value type.
      */
     issues?: AdcpValidationIssue[];
+    /**
+     * Buyer-actionable classification of the failure. Present when the enclosing
+     * `code`/`message` is too coarse or carries producer-internal context that
+     * must not cross the buyer trust boundary. `code` reuses the standard error
+     * vocabulary; `message` is buyer-safe by spec — no vendor identifiers,
+     * ad-server type names, internal object names, internal IDs, or stack traces
+     * — so it may be rendered directly to a buyer UI. When present, the
+     * enclosing `recovery` classifies the buyer-actionable reason. See
+     * `core/error.json`'s `buyer_reason` field for the normative contract.
+     */
+    buyer_reason?: {
+        code: string;
+        message: string;
+    };
     /** True when the SDK inferred this error from unstructured text (L1 compliance) */
     synthetic?: boolean;
 }

package/dist/lib/index.d.mts

@@ -2,8 +2,8 @@ export { RegistryClient, RegistryRequestError, isRegistryRequestError, RegistryS
 export type { RegistrySyncConfig, RegistrySyncState, RegistrySyncTransport, RegistrySyncEvents, AgentFilter, RegistrySyncProperty, CursorStore, PropertyRegistryConfig, FeedStreamQuery, FeedStreamMessage, FeedHeartbeat, FeedStreamErrorData, OpenFeedStreamOptions, FeedFreshness, } from './registry/index.mjs';
 export { openFeedStream, parseSseStream, sanitizeStreamText, DEFAULT_MAX_SSE_FRAME_BYTES, FeedStreamError, FeedStreamUnsupportedError, FeedStreamCursorExpiredError, FeedStreamHttpError, FeedStreamParseError, } from './registry/index.mjs';
 export type { ResolvedBrand, LookupBrandOptions, ResolvedProperty as ResolvedRegistryProperty, PropertyInfo, RegistryClientConfig, SaveBrandRequest, SaveBrandResponse, BrandLogoReviewStatus, ApprovedBrandLogoAsset, PendingBrandLogoAsset, ReviewedBrandLogoAsset, BrandLogoAsset, ListBrandLogosOptions, ListBrandLogosResponse, SaveBrandLogoInput, SaveBrandLogoResponse, UploadBrandLogoInput, UploadBrandLogoResponse, SavePropertyIdentity, RegistryPropertyIdentity, SavePropertyRequest, SavePropertyResponse, ResolveIdentifiersRequest, ResolveIdentifiersResponse, FileCatalogDisputeRequest, FileCatalogDisputeResponse, GetCatalogDisputeResponse, BrandRegistryItem, PropertyRegistryItem, ValidationResult as RegistryValidationResult, 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, PublisherPropertySelector, CompanySearchResult, FindCompanyResult, ManagerRevalidationRequest, ManagerRevalidationResponse, ListPoliciesQuery, ListPoliciesResponse, ResolvePolicyQuery, ResolvePolicyResponse, ResolvePoliciesBulkRequest, ResolvePoliciesBulkResponse, GetPolicyHistoryQuery, GetPolicyHistoryResponse, SavePolicyRequest, SavePolicyResponse, GetBrandHistoryQuery, GetBrandHistoryResponse, GetPropertyHistoryQuery, GetPropertyHistoryResponse, RegistryFeedEvent, AgentEventPayload, PropertyEventPayload, CollectionEventPayload, AuthorizationEventPayload, PublisherEventPayload, BrandEventPayload, CatalogBrowseResponse, CatalogBrowseEntry, CatalogSyncResponse, CatalogSyncEntry, AgentCompliance, AgentComplianceDetail, StoryboardStatus, OperatorLookupResult, PublisherLookupResult, ComplianceChangedPayload, GetAgentStoryboardStatusResponse, GetAgentStoryboardStatusBulkResponse, } from './registry/index.mjs';
-export { COMMON_LOGO_SLOTS, applyBrandAssetMappings, checkLogoSlotCoverage, extractBrandWebsiteAliasDomains, extractBrandWebsiteAliases, selectLogoForSlot, updateBrandJsonFromMappings, validateBrandAssetMappings, } from './brand/index.mjs';
-export type { AppliedBrandAssetMapping, ApplyBrandAssetMappingsOptions, ApplyBrandAssetMappingsResult, BrandAssetCandidate, BrandAssetCropBox, BrandAssetExtractionMethod, BrandAssetMapping, BrandAssetMappingIssue, BrandAssetMappingTarget, BrandAssetMappingValidationResult, BrandAssetReviewStatus, BrandWebsiteAlias, BrandWebsiteAliasRelationship, BrandWebsiteAliasSource, BrandJsonRecord, BrandLogoBackground, BrandLogoOrientation, BrandLogoProposal, BrandLogoVariant, ExtractBrandWebsiteAliasesOptions, LogoSelectionOptions, LogoSlotCoverage, LogoSlotCoverageOptions, ResolveBrandAssetUrl, SkippedBrandAssetMapping, UpdateBrandJsonFromMappingsOptions, UpdateBrandJsonFromMappingsResult, } from './brand/index.mjs';
+export { COMMON_LOGO_SLOTS, BrandDomainValidationError, applyBrandAssetMappings, checkLogoSlotCoverage, extractBrandWebsiteAliasDomains, extractBrandWebsiteAliases, isDevelopmentBrandDomain, selectLogoForSlot, updateBrandJsonFromMappings, validateBrandAssetMappings, validateBrandDomain, } from './brand/index.mjs';
+export type { AppliedBrandAssetMapping, ApplyBrandAssetMappingsOptions, ApplyBrandAssetMappingsResult, BrandAssetCandidate, BrandAssetCropBox, BrandAssetExtractionMethod, BrandAssetMapping, BrandAssetMappingIssue, BrandAssetMappingTarget, BrandAssetMappingValidationResult, BrandAssetReviewStatus, BrandWebsiteAlias, BrandWebsiteAliasRelationship, BrandWebsiteAliasSource, BrandJsonRecord, BrandDomainValidationCode, BrandLogoBackground, BrandLogoOrientation, BrandLogoProposal, BrandLogoVariant, ExtractBrandWebsiteAliasesOptions, LogoSelectionOptions, LogoSlotCoverage, LogoSlotCoverageOptions, ResolveBrandAssetUrl, SkippedBrandAssetMapping, UpdateBrandJsonFromMappingsOptions, UpdateBrandJsonFromMappingsResult, ValidateBrandDomainOptions, } from './brand/index.mjs';
 export { PropertyIndex, getPropertyIndex, resetPropertyIndex, type PropertyMatch, type AgentAuthorization, } from './discovery/property-index.mjs';
 export { PropertyCrawler, type AgentInfo, type CrawlResult, type PropertyCrawlerConfig, } from './discovery/property-crawler.mjs';
 export { NetworkConsistencyChecker, type NetworkConsistencyCheckerConfig, type NetworkCheckReport, type CheckSummary, type CheckProgress, type OrphanedPointer, type StalePointer, type MissingPointer, type SchemaError, type AgentHealthResult, type DomainDetail, type DomainStatus, } from './discovery/network-consistency-checker.mjs';

package/dist/lib/index.d.ts

@@ -2,8 +2,8 @@ export { RegistryClient, RegistryRequestError, isRegistryRequestError, RegistryS
 export type { RegistrySyncConfig, RegistrySyncState, RegistrySyncTransport, RegistrySyncEvents, AgentFilter, RegistrySyncProperty, CursorStore, PropertyRegistryConfig, FeedStreamQuery, FeedStreamMessage, FeedHeartbeat, FeedStreamErrorData, OpenFeedStreamOptions, FeedFreshness, } from './registry';
 export { openFeedStream, parseSseStream, sanitizeStreamText, DEFAULT_MAX_SSE_FRAME_BYTES, FeedStreamError, FeedStreamUnsupportedError, FeedStreamCursorExpiredError, FeedStreamHttpError, FeedStreamParseError, } from './registry';
 export type { ResolvedBrand, LookupBrandOptions, ResolvedProperty as ResolvedRegistryProperty, PropertyInfo, RegistryClientConfig, SaveBrandRequest, SaveBrandResponse, BrandLogoReviewStatus, ApprovedBrandLogoAsset, PendingBrandLogoAsset, ReviewedBrandLogoAsset, BrandLogoAsset, ListBrandLogosOptions, ListBrandLogosResponse, SaveBrandLogoInput, SaveBrandLogoResponse, UploadBrandLogoInput, UploadBrandLogoResponse, SavePropertyIdentity, RegistryPropertyIdentity, SavePropertyRequest, SavePropertyResponse, ResolveIdentifiersRequest, ResolveIdentifiersResponse, FileCatalogDisputeRequest, FileCatalogDisputeResponse, GetCatalogDisputeResponse, BrandRegistryItem, PropertyRegistryItem, ValidationResult as RegistryValidationResult, 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, PublisherPropertySelector, CompanySearchResult, FindCompanyResult, ManagerRevalidationRequest, ManagerRevalidationResponse, ListPoliciesQuery, ListPoliciesResponse, ResolvePolicyQuery, ResolvePolicyResponse, ResolvePoliciesBulkRequest, ResolvePoliciesBulkResponse, GetPolicyHistoryQuery, GetPolicyHistoryResponse, SavePolicyRequest, SavePolicyResponse, GetBrandHistoryQuery, GetBrandHistoryResponse, GetPropertyHistoryQuery, GetPropertyHistoryResponse, RegistryFeedEvent, AgentEventPayload, PropertyEventPayload, CollectionEventPayload, AuthorizationEventPayload, PublisherEventPayload, BrandEventPayload, CatalogBrowseResponse, CatalogBrowseEntry, CatalogSyncResponse, CatalogSyncEntry, AgentCompliance, AgentComplianceDetail, StoryboardStatus, OperatorLookupResult, PublisherLookupResult, ComplianceChangedPayload, GetAgentStoryboardStatusResponse, GetAgentStoryboardStatusBulkResponse, } from './registry';
-export { COMMON_LOGO_SLOTS, applyBrandAssetMappings, checkLogoSlotCoverage, extractBrandWebsiteAliasDomains, extractBrandWebsiteAliases, selectLogoForSlot, updateBrandJsonFromMappings, validateBrandAssetMappings, } from './brand';
-export type { AppliedBrandAssetMapping, ApplyBrandAssetMappingsOptions, ApplyBrandAssetMappingsResult, BrandAssetCandidate, BrandAssetCropBox, BrandAssetExtractionMethod, BrandAssetMapping, BrandAssetMappingIssue, BrandAssetMappingTarget, BrandAssetMappingValidationResult, BrandAssetReviewStatus, BrandWebsiteAlias, BrandWebsiteAliasRelationship, BrandWebsiteAliasSource, BrandJsonRecord, BrandLogoBackground, BrandLogoOrientation, BrandLogoProposal, BrandLogoVariant, ExtractBrandWebsiteAliasesOptions, LogoSelectionOptions, LogoSlotCoverage, LogoSlotCoverageOptions, ResolveBrandAssetUrl, SkippedBrandAssetMapping, UpdateBrandJsonFromMappingsOptions, UpdateBrandJsonFromMappingsResult, } from './brand';
+export { COMMON_LOGO_SLOTS, BrandDomainValidationError, applyBrandAssetMappings, checkLogoSlotCoverage, extractBrandWebsiteAliasDomains, extractBrandWebsiteAliases, isDevelopmentBrandDomain, selectLogoForSlot, updateBrandJsonFromMappings, validateBrandAssetMappings, validateBrandDomain, } from './brand';
+export type { AppliedBrandAssetMapping, ApplyBrandAssetMappingsOptions, ApplyBrandAssetMappingsResult, BrandAssetCandidate, BrandAssetCropBox, BrandAssetExtractionMethod, BrandAssetMapping, BrandAssetMappingIssue, BrandAssetMappingTarget, BrandAssetMappingValidationResult, BrandAssetReviewStatus, BrandWebsiteAlias, BrandWebsiteAliasRelationship, BrandWebsiteAliasSource, BrandJsonRecord, BrandDomainValidationCode, BrandLogoBackground, BrandLogoOrientation, BrandLogoProposal, BrandLogoVariant, ExtractBrandWebsiteAliasesOptions, LogoSelectionOptions, LogoSlotCoverage, LogoSlotCoverageOptions, ResolveBrandAssetUrl, SkippedBrandAssetMapping, UpdateBrandJsonFromMappingsOptions, UpdateBrandJsonFromMappingsResult, ValidateBrandDomainOptions, } from './brand';
 export { PropertyIndex, getPropertyIndex, resetPropertyIndex, type PropertyMatch, type AgentAuthorization, } from './discovery/property-index';
 export { PropertyCrawler, type AgentInfo, type CrawlResult, type PropertyCrawlerConfig, } from './discovery/property-crawler';
 export { NetworkConsistencyChecker, type NetworkConsistencyCheckerConfig, type NetworkCheckReport, type CheckSummary, type CheckProgress, type OrphanedPointer, type StalePointer, type MissingPointer, type SchemaError, type AgentHealthResult, type DomainDetail, type DomainStatus, } from './discovery/network-consistency-checker';

package/dist/lib/index.js

@@ -46,6 +46,7 @@ __export(index_exports, {
   AuthenticationCredentialsRejectedError: () => import_errors.AuthenticationCredentialsRejectedError,
   AuthenticationRequiredError: () => import_errors.AuthenticationRequiredError,
   BRAND_RIGHTS_TOOLS: () => import_capabilities.BRAND_RIGHTS_TOOLS,
+  BrandDomainValidationError: () => import_brand.BrandDomainValidationError,
   BrandJsonSchema: () => import_wellknown_schemas.BrandJsonSchema,
   BuyerRetryPolicy: () => import_buyer_retry_policy.BuyerRetryPolicy,
   CATALOG_MACRO_VECTORS: () => import_substitution.CATALOG_MACRO_VECTORS,
@@ -438,6 +439,7 @@ __export(index_exports, {
   isCreateMediaBuyInputRequired: () => import_typeGuards.isCreateMediaBuyInputRequired,
   isCreateMediaBuySubmitted: () => import_typeGuards.isCreateMediaBuySubmitted,
   isCreateMediaBuyWorking: () => import_typeGuards.isCreateMediaBuyWorking,
+  isDevelopmentBrandDomain: () => import_brand.isDevelopmentBrandDomain,
   isEnvSecretReference: () => import_oauth4.isEnvSecretReference,
   isErrorOfType: () => import_errors.isErrorOfType,
   isGetProductsCompleted: () => import_typeGuards.isGetProductsCompleted,
@@ -666,6 +668,7 @@ __export(index_exports, {
   validateAdcpVersionWire: () => import_schema_loader.validateAdcpVersionWire,
   validateAgentUrl: () => import_validation.validateAgentUrl,
   validateBrandAssetMappings: () => import_brand.validateBrandAssetMappings,
+  validateBrandDomain: () => import_brand.validateBrandDomain,
   validateGetProductsCacheScope: () => import_get_products_cache_scope.validateGetProductsCacheScope,
   validateGovernancePlan: () => import_governance.validateGovernancePlan,
   validateProductsAgainstPropertyPolicy: () => import_media_buy.validateProductsAgainstPropertyPolicy,
@@ -837,6 +840,7 @@ function createAdCPClientFromEnv() {
   AuthenticationCredentialsRejectedError,
   AuthenticationRequiredError,
   BRAND_RIGHTS_TOOLS,
+  BrandDomainValidationError,
   BrandJsonSchema,
   BuyerRetryPolicy,
   CATALOG_MACRO_VECTORS,
@@ -1229,6 +1233,7 @@ function createAdCPClientFromEnv() {
   isCreateMediaBuyInputRequired,
   isCreateMediaBuySubmitted,
   isCreateMediaBuyWorking,
+  isDevelopmentBrandDomain,
   isEnvSecretReference,
   isErrorOfType,
   isGetProductsCompleted,
@@ -1457,6 +1462,7 @@ function createAdCPClientFromEnv() {
   validateAdcpVersionWire,
   validateAgentUrl,
   validateBrandAssetMappings,
+  validateBrandDomain,
   validateGetProductsCacheScope,
   validateGovernancePlan,
   validateProductsAgainstPropertyPolicy,

package/dist/lib/index.mjs

@@ -21,13 +21,16 @@ import {
 } from "./registry/index.mjs";
 import {
   COMMON_LOGO_SLOTS,
+  BrandDomainValidationError,
   applyBrandAssetMappings,
   checkLogoSlotCoverage,
   extractBrandWebsiteAliasDomains,
   extractBrandWebsiteAliases,
+  isDevelopmentBrandDomain,
   selectLogoForSlot,
   updateBrandJsonFromMappings,
-  validateBrandAssetMappings
+  validateBrandAssetMappings,
+  validateBrandDomain
 } from "./brand/index.mjs";
 import {
   PropertyIndex,
@@ -793,6 +796,7 @@ export {
   AuthenticationCredentialsRejectedError,
   AuthenticationRequiredError,
   BRAND_RIGHTS_TOOLS,
+  BrandDomainValidationError,
   BrandJsonSchema,
   BuyerRetryPolicy,
   CATALOG_MACRO_VECTORS,
@@ -1185,6 +1189,7 @@ export {
   isCreateMediaBuyInputRequired,
   isCreateMediaBuySubmitted,
   isCreateMediaBuyWorking,
+  isDevelopmentBrandDomain,
   isEnvSecretReference,
   isErrorOfType,
   isGetProductsCompleted,
@@ -1413,6 +1418,7 @@ export {
   validateAdcpVersionWire,
   validateAgentUrl,
   validateBrandAssetMappings,
+  validateBrandDomain,
   validateGetProductsCacheScope,
   validateGovernancePlan,
   validateProductsAgainstPropertyPolicy,

package/dist/lib/schemas-data/v2.5/_provenance.json

@@ -4,5 +4,5 @@
   "source_sha": "4e553ad955f83b49c7d221ab5c3ff78237ad02e3",
   "source_tarball_sha256": "580656d6466ef9f0d1119985e6726c2efea718dc671e2ad30957fcb2fd54af0f",
   "upstream_adcp_version": "2.5.3",
-  "synced_at": "2026-09-07T02:22:39.478Z"
+  "synced_at": "2026-09-08T23:08:47.294Z"
 }

package/dist/lib/server/create-adcp-server.js

@@ -25,6 +25,7 @@ __export(create_adcp_server_exports, {
   ADCP_SIGNED_REQUESTS_STATE: () => ADCP_SIGNED_REQUESTS_STATE,
   COMPACT_MEDIA_BUY_MUTATION_TOOLS: () => COMPACT_MEDIA_BUY_MUTATION_TOOLS,
   MEDIA_BUY_MCP_TOOL_PROFILE: () => MEDIA_BUY_MCP_TOOL_PROFILE,
+  __unstable__projectThrownAdcpError: () => __unstable__projectThrownAdcpError,
   createAdcpServer: () => createAdcpServer,
   requireSessionKey: () => requireSessionKey
 });
@@ -261,6 +262,9 @@ function hasUncacheableSyncAccountRejection(response) {
 function shouldCacheIdempotencyResponse(response) {
   return !isErrorResponse(response) && !hasUncacheableSyncAccountRejection(response);
 }
+function __unstable__projectThrownAdcpError(err) {
+  return projectThrownAdcpError(err);
+}
 function projectThrownAdcpError(err) {
   return (0, import_errors2.adcpError)(err.code, {
     recovery: err.recovery,
@@ -268,7 +272,8 @@ function projectThrownAdcpError(err) {
     ...err.field !== void 0 && { field: err.field },
     ...err.suggestion !== void 0 && { suggestion: err.suggestion },
     ...err.retry_after !== void 0 && { retry_after: err.retry_after },
-    ...err.details !== void 0 && { details: err.details }
+    ...err.details !== void 0 && { details: err.details },
+    ...err.buyer_reason !== void 0 && { buyer_reason: err.buyer_reason }
   });
 }
 function isThrownAdcpError(value) {
@@ -1057,7 +1062,7 @@ function sanitizePayloadError(value) {
     message: typeof safe.message === "string" ? safe.message : "operation failed",
     recovery: import_error_codes.STANDARD_ERROR_CODES[code].recovery
   };
-  for (const key of ["field", "suggestion", "retry_after", "issues"]) {
+  for (const key of ["field", "suggestion", "retry_after", "issues", "buyer_reason"]) {
     if (safe[key] !== void 0) projected[key] = safe[key];
   }
   if (safe.details !== void 0) {
@@ -1120,7 +1125,8 @@ const PAYLOAD_ERROR_FIELDS = /* @__PURE__ */ new Set([
   "suggestion",
   "retry_after",
   "issues",
-  "details"
+  "details",
+  "buyer_reason"
 ]);
 function projectEnvelopeToPayloadError(envelope) {
   const out = {};
@@ -4456,6 +4462,7 @@ function createAdcpServer(config) {
   ADCP_SIGNED_REQUESTS_STATE,
   COMPACT_MEDIA_BUY_MUTATION_TOOLS,
   MEDIA_BUY_MCP_TOOL_PROFILE,
+  __unstable__projectThrownAdcpError,
   createAdcpServer,
   requireSessionKey
 });

package/dist/lib/server/create-adcp-server.mjs

@@ -331,6 +331,9 @@ function hasUncacheableSyncAccountRejection(response) {
 function shouldCacheIdempotencyResponse(response) {
   return !isErrorResponse(response) && !hasUncacheableSyncAccountRejection(response);
 }
+function __unstable__projectThrownAdcpError(err) {
+  return projectThrownAdcpError(err);
+}
 function projectThrownAdcpError(err) {
   return adcpError(err.code, {
     recovery: err.recovery,
@@ -338,7 +341,8 @@ function projectThrownAdcpError(err) {
     ...err.field !== void 0 && { field: err.field },
     ...err.suggestion !== void 0 && { suggestion: err.suggestion },
     ...err.retry_after !== void 0 && { retry_after: err.retry_after },
-    ...err.details !== void 0 && { details: err.details }
+    ...err.details !== void 0 && { details: err.details },
+    ...err.buyer_reason !== void 0 && { buyer_reason: err.buyer_reason }
   });
 }
 function isThrownAdcpError(value) {
@@ -1127,7 +1131,7 @@ function sanitizePayloadError(value) {
     message: typeof safe.message === "string" ? safe.message : "operation failed",
     recovery: STANDARD_ERROR_CODES[code].recovery
   };
-  for (const key of ["field", "suggestion", "retry_after", "issues"]) {
+  for (const key of ["field", "suggestion", "retry_after", "issues", "buyer_reason"]) {
     if (safe[key] !== void 0) projected[key] = safe[key];
   }
   if (safe.details !== void 0) {
@@ -1190,7 +1194,8 @@ const PAYLOAD_ERROR_FIELDS = /* @__PURE__ */ new Set([
   "suggestion",
   "retry_after",
   "issues",
-  "details"
+  "details",
+  "buyer_reason"
 ]);
 function projectEnvelopeToPayloadError(envelope) {
   const out = {};
@@ -4525,6 +4530,7 @@ export {
   ADCP_SIGNED_REQUESTS_STATE,
   COMPACT_MEDIA_BUY_MUTATION_TOOLS,
   MEDIA_BUY_MCP_TOOL_PROFILE,
+  __unstable__projectThrownAdcpError,
   createAdcpServer,
   requireSessionKey
 };