@adcp/sdk 14.1.0 → 14.3.0

package/dist/lib/types/get-products.d.ts

@@ -519,6 +519,11 @@ export interface AdInventoryConfiguration {
  */
 export type AdvertiserIndustry = 'automotive' | 'automotive.electric_vehicles' | 'automotive.parts_accessories' | 'automotive.luxury' | 'beauty_cosmetics' | 'beauty_cosmetics.skincare' | 'beauty_cosmetics.fragrance' | 'beauty_cosmetics.haircare' | 'cannabis' | 'cpg' | 'cpg.personal_care' | 'cpg.household' | 'dating' | 'education' | 'education.higher_education' | 'education.online_learning' | 'education.k12' | 'energy_utilities' | 'energy_utilities.renewable' | 'fashion_apparel' | 'fashion_apparel.luxury' | 'fashion_apparel.sportswear' | 'finance' | 'finance.banking' | 'finance.insurance' | 'finance.investment' | 'finance.cryptocurrency' | 'food_beverage' | 'food_beverage.alcohol' | 'food_beverage.restaurants' | 'food_beverage.packaged_goods' | 'gambling_betting' | 'gambling_betting.sports_betting' | 'gambling_betting.casino' | 'gaming' | 'gaming.mobile' | 'gaming.console_pc' | 'gaming.esports' | 'government_nonprofit' | 'government_nonprofit.political' | 'government_nonprofit.charity' | 'healthcare' | 'healthcare.pharmaceutical' | 'healthcare.medical_devices' | 'healthcare.wellness' | 'home_garden' | 'home_garden.furniture' | 'home_garden.home_improvement' | 'media_entertainment' | 'media_entertainment.podcasts' | 'media_entertainment.music' | 'media_entertainment.film_tv' | 'media_entertainment.publishing' | 'media_entertainment.live_events' | 'pets' | 'professional_services' | 'professional_services.legal' | 'professional_services.consulting' | 'real_estate' | 'real_estate.residential' | 'real_estate.commercial' | 'recruitment_hr' | 'retail' | 'retail.ecommerce' | 'retail.department_stores' | 'sports_fitness' | 'sports_fitness.equipment' | 'sports_fitness.teams_leagues' | 'technology' | 'technology.software' | 'technology.hardware' | 'technology.ai_ml' | 'telecom' | 'telecom.mobile_carriers' | 'telecom.internet_providers' | 'transportation_logistics' | 'travel_hospitality' | 'travel_hospitality.airlines' | 'travel_hospitality.hotels' | 'travel_hospitality.cruise' | 'travel_hospitality.tourism';
 
+/**
+ * User-level bases that may resolve age for demographic targeting execution. Population estimates are deliberately absent because aggregate composition cannot establish an individual impression's age.
+ */
+export type AgeDeterminationBasis = 'verified' | 'declared' | 'inferred';
+
 /**
  * Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.
  */
@@ -5662,7 +5667,20 @@ export interface DemographicTargetingCapability {
  * Canonical demographic audience targeting intent with optional constraints on how age may be determined. This is distinct from age_restriction: demographics selects an audience, while age_restriction expresses a legal eligibility or verification floor. Fresh create/update targeting MUST compile exactly or be rejected. During get_products, a seller may offer a different configured predicate only through sparse targeting_resolution modifications on a distinguishable product_id; selecting that product accepts the alternative. Sellers never silently broaden, narrow, default, drop, or substitute the basis.
  */
 export interface DemographicTargetingIntent {
-    age: DemographicAgeRange & {};
+    age: DemographicAgeRange & {
+        /**
+         * User-level age determination bases the buyer permits for this predicate. Sellers MUST use only these bases or reject the request; they MUST NOT silently fall back to another basis. When omitted, the buyer imposes no determination-basis constraint beyond product capability and any age_restriction. population_estimate is structurally unavailable because aggregate evidence cannot identify an eligible user.
+         *
+         * @minItems 1
+         */
+        accepted_bases?: [AgeDeterminationBasis, ...AgeDeterminationBasis[]];
+        /**
+         * Verification methods acceptable when verified is an accepted basis. This field narrows verified demographic execution; age_restriction.accepted_methods independently governs legal eligibility and the two sets are intersected when both are present.
+         *
+         * @minItems 1
+         */
+        accepted_verification_methods?: [AgeVerificationMethod, ...AgeVerificationMethod[]];
+    };
 }
 
 /**

package/dist/lib/types/list-products.d.ts

@@ -258,6 +258,11 @@ export type ActivationKey = {
  */
 export type AdvertiserIndustry = 'automotive' | 'automotive.electric_vehicles' | 'automotive.parts_accessories' | 'automotive.luxury' | 'beauty_cosmetics' | 'beauty_cosmetics.skincare' | 'beauty_cosmetics.fragrance' | 'beauty_cosmetics.haircare' | 'cannabis' | 'cpg' | 'cpg.personal_care' | 'cpg.household' | 'dating' | 'education' | 'education.higher_education' | 'education.online_learning' | 'education.k12' | 'energy_utilities' | 'energy_utilities.renewable' | 'fashion_apparel' | 'fashion_apparel.luxury' | 'fashion_apparel.sportswear' | 'finance' | 'finance.banking' | 'finance.insurance' | 'finance.investment' | 'finance.cryptocurrency' | 'food_beverage' | 'food_beverage.alcohol' | 'food_beverage.restaurants' | 'food_beverage.packaged_goods' | 'gambling_betting' | 'gambling_betting.sports_betting' | 'gambling_betting.casino' | 'gaming' | 'gaming.mobile' | 'gaming.console_pc' | 'gaming.esports' | 'government_nonprofit' | 'government_nonprofit.political' | 'government_nonprofit.charity' | 'healthcare' | 'healthcare.pharmaceutical' | 'healthcare.medical_devices' | 'healthcare.wellness' | 'home_garden' | 'home_garden.furniture' | 'home_garden.home_improvement' | 'media_entertainment' | 'media_entertainment.podcasts' | 'media_entertainment.music' | 'media_entertainment.film_tv' | 'media_entertainment.publishing' | 'media_entertainment.live_events' | 'pets' | 'professional_services' | 'professional_services.legal' | 'professional_services.consulting' | 'real_estate' | 'real_estate.residential' | 'real_estate.commercial' | 'recruitment_hr' | 'retail' | 'retail.ecommerce' | 'retail.department_stores' | 'sports_fitness' | 'sports_fitness.equipment' | 'sports_fitness.teams_leagues' | 'technology' | 'technology.software' | 'technology.hardware' | 'technology.ai_ml' | 'telecom' | 'telecom.mobile_carriers' | 'telecom.internet_providers' | 'transportation_logistics' | 'travel_hospitality' | 'travel_hospitality.airlines' | 'travel_hospitality.hotels' | 'travel_hospitality.cruise' | 'travel_hospitality.tourism';
 
+/**
+ * User-level bases that may resolve age for demographic targeting execution. Population estimates are deliberately absent because aggregate composition cannot establish an individual impression's age.
+ */
+export type AgeDeterminationBasis = 'verified' | 'declared' | 'inferred';
+
 /**
  * Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.
  */
@@ -1379,7 +1384,20 @@ export interface DemographicTargetingCapability {
  * Canonical demographic audience targeting intent with optional constraints on how age may be determined. This is distinct from age_restriction: demographics selects an audience, while age_restriction expresses a legal eligibility or verification floor. Fresh create/update targeting MUST compile exactly or be rejected. During get_products, a seller may offer a different configured predicate only through sparse targeting_resolution modifications on a distinguishable product_id; selecting that product accepts the alternative. Sellers never silently broaden, narrow, default, drop, or substitute the basis.
  */
 export interface DemographicTargetingIntent {
-    age: DemographicAgeRange & {};
+    age: DemographicAgeRange & {
+        /**
+         * User-level age determination bases the buyer permits for this predicate. Sellers MUST use only these bases or reject the request; they MUST NOT silently fall back to another basis. When omitted, the buyer imposes no determination-basis constraint beyond product capability and any age_restriction. population_estimate is structurally unavailable because aggregate evidence cannot identify an eligible user.
+         *
+         * @minItems 1
+         */
+        accepted_bases?: [AgeDeterminationBasis, ...AgeDeterminationBasis[]];
+        /**
+         * Verification methods acceptable when verified is an accepted basis. This field narrows verified demographic execution; age_restriction.accepted_methods independently governs legal eligibility and the two sets are intersected when both are present.
+         *
+         * @minItems 1
+         */
+        accepted_verification_methods?: [AgeVerificationMethod, ...AgeVerificationMethod[]];
+    };
 }
 
 /**

package/dist/lib/types/refine-proposals.d.ts

@@ -408,6 +408,11 @@ export type ActivationKey = {
  */
 export type AdvertiserIndustry = 'automotive' | 'automotive.electric_vehicles' | 'automotive.parts_accessories' | 'automotive.luxury' | 'beauty_cosmetics' | 'beauty_cosmetics.skincare' | 'beauty_cosmetics.fragrance' | 'beauty_cosmetics.haircare' | 'cannabis' | 'cpg' | 'cpg.personal_care' | 'cpg.household' | 'dating' | 'education' | 'education.higher_education' | 'education.online_learning' | 'education.k12' | 'energy_utilities' | 'energy_utilities.renewable' | 'fashion_apparel' | 'fashion_apparel.luxury' | 'fashion_apparel.sportswear' | 'finance' | 'finance.banking' | 'finance.insurance' | 'finance.investment' | 'finance.cryptocurrency' | 'food_beverage' | 'food_beverage.alcohol' | 'food_beverage.restaurants' | 'food_beverage.packaged_goods' | 'gambling_betting' | 'gambling_betting.sports_betting' | 'gambling_betting.casino' | 'gaming' | 'gaming.mobile' | 'gaming.console_pc' | 'gaming.esports' | 'government_nonprofit' | 'government_nonprofit.political' | 'government_nonprofit.charity' | 'healthcare' | 'healthcare.pharmaceutical' | 'healthcare.medical_devices' | 'healthcare.wellness' | 'home_garden' | 'home_garden.furniture' | 'home_garden.home_improvement' | 'media_entertainment' | 'media_entertainment.podcasts' | 'media_entertainment.music' | 'media_entertainment.film_tv' | 'media_entertainment.publishing' | 'media_entertainment.live_events' | 'pets' | 'professional_services' | 'professional_services.legal' | 'professional_services.consulting' | 'real_estate' | 'real_estate.residential' | 'real_estate.commercial' | 'recruitment_hr' | 'retail' | 'retail.ecommerce' | 'retail.department_stores' | 'sports_fitness' | 'sports_fitness.equipment' | 'sports_fitness.teams_leagues' | 'technology' | 'technology.software' | 'technology.hardware' | 'technology.ai_ml' | 'telecom' | 'telecom.mobile_carriers' | 'telecom.internet_providers' | 'transportation_logistics' | 'travel_hospitality' | 'travel_hospitality.airlines' | 'travel_hospitality.hotels' | 'travel_hospitality.cruise' | 'travel_hospitality.tourism';
 
+/**
+ * User-level bases that may resolve age for demographic targeting execution. Population estimates are deliberately absent because aggregate composition cannot establish an individual impression's age.
+ */
+export type AgeDeterminationBasis = 'verified' | 'declared' | 'inferred';
+
 /**
  * Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.
  */
@@ -1987,7 +1992,20 @@ export interface DemographicTargetingCapability {
  * Canonical demographic audience targeting intent with optional constraints on how age may be determined. This is distinct from age_restriction: demographics selects an audience, while age_restriction expresses a legal eligibility or verification floor. Fresh create/update targeting MUST compile exactly or be rejected. During get_products, a seller may offer a different configured predicate only through sparse targeting_resolution modifications on a distinguishable product_id; selecting that product accepts the alternative. Sellers never silently broaden, narrow, default, drop, or substitute the basis.
  */
 export interface DemographicTargetingIntent {
-    age: DemographicAgeRange & {};
+    age: DemographicAgeRange & {
+        /**
+         * User-level age determination bases the buyer permits for this predicate. Sellers MUST use only these bases or reject the request; they MUST NOT silently fall back to another basis. When omitted, the buyer imposes no determination-basis constraint beyond product capability and any age_restriction. population_estimate is structurally unavailable because aggregate evidence cannot identify an eligible user.
+         *
+         * @minItems 1
+         */
+        accepted_bases?: [AgeDeterminationBasis, ...AgeDeterminationBasis[]];
+        /**
+         * Verification methods acceptable when verified is an accepted basis. This field narrows verified demographic execution; age_restriction.accepted_methods independently governs legal eligibility and the two sets are intersected when both are present.
+         *
+         * @minItems 1
+         */
+        accepted_verification_methods?: [AgeVerificationMethod, ...AgeVerificationMethod[]];
+    };
 }
 
 /**

package/dist/lib/types/request-proposals.d.ts

@@ -476,6 +476,11 @@ export type ActivationKey = {
  */
 export type AdvertiserIndustry = 'automotive' | 'automotive.electric_vehicles' | 'automotive.parts_accessories' | 'automotive.luxury' | 'beauty_cosmetics' | 'beauty_cosmetics.skincare' | 'beauty_cosmetics.fragrance' | 'beauty_cosmetics.haircare' | 'cannabis' | 'cpg' | 'cpg.personal_care' | 'cpg.household' | 'dating' | 'education' | 'education.higher_education' | 'education.online_learning' | 'education.k12' | 'energy_utilities' | 'energy_utilities.renewable' | 'fashion_apparel' | 'fashion_apparel.luxury' | 'fashion_apparel.sportswear' | 'finance' | 'finance.banking' | 'finance.insurance' | 'finance.investment' | 'finance.cryptocurrency' | 'food_beverage' | 'food_beverage.alcohol' | 'food_beverage.restaurants' | 'food_beverage.packaged_goods' | 'gambling_betting' | 'gambling_betting.sports_betting' | 'gambling_betting.casino' | 'gaming' | 'gaming.mobile' | 'gaming.console_pc' | 'gaming.esports' | 'government_nonprofit' | 'government_nonprofit.political' | 'government_nonprofit.charity' | 'healthcare' | 'healthcare.pharmaceutical' | 'healthcare.medical_devices' | 'healthcare.wellness' | 'home_garden' | 'home_garden.furniture' | 'home_garden.home_improvement' | 'media_entertainment' | 'media_entertainment.podcasts' | 'media_entertainment.music' | 'media_entertainment.film_tv' | 'media_entertainment.publishing' | 'media_entertainment.live_events' | 'pets' | 'professional_services' | 'professional_services.legal' | 'professional_services.consulting' | 'real_estate' | 'real_estate.residential' | 'real_estate.commercial' | 'recruitment_hr' | 'retail' | 'retail.ecommerce' | 'retail.department_stores' | 'sports_fitness' | 'sports_fitness.equipment' | 'sports_fitness.teams_leagues' | 'technology' | 'technology.software' | 'technology.hardware' | 'technology.ai_ml' | 'telecom' | 'telecom.mobile_carriers' | 'telecom.internet_providers' | 'transportation_logistics' | 'travel_hospitality' | 'travel_hospitality.airlines' | 'travel_hospitality.hotels' | 'travel_hospitality.cruise' | 'travel_hospitality.tourism';
 
+/**
+ * User-level bases that may resolve age for demographic targeting execution. Population estimates are deliberately absent because aggregate composition cannot establish an individual impression's age.
+ */
+export type AgeDeterminationBasis = 'verified' | 'declared' | 'inferred';
+
 /**
  * Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.
  */
@@ -2075,7 +2080,20 @@ export interface DemographicTargetingCapability {
  * Canonical demographic audience targeting intent with optional constraints on how age may be determined. This is distinct from age_restriction: demographics selects an audience, while age_restriction expresses a legal eligibility or verification floor. Fresh create/update targeting MUST compile exactly or be rejected. During get_products, a seller may offer a different configured predicate only through sparse targeting_resolution modifications on a distinguishable product_id; selecting that product accepts the alternative. Sellers never silently broaden, narrow, default, drop, or substitute the basis.
  */
 export interface DemographicTargetingIntent {
-    age: DemographicAgeRange & {};
+    age: DemographicAgeRange & {
+        /**
+         * User-level age determination bases the buyer permits for this predicate. Sellers MUST use only these bases or reject the request; they MUST NOT silently fall back to another basis. When omitted, the buyer imposes no determination-basis constraint beyond product capability and any age_restriction. population_estimate is structurally unavailable because aggregate evidence cannot identify an eligible user.
+         *
+         * @minItems 1
+         */
+        accepted_bases?: [AgeDeterminationBasis, ...AgeDeterminationBasis[]];
+        /**
+         * Verification methods acceptable when verified is an accepted basis. This field narrows verified demographic execution; age_restriction.accepted_methods independently governs legal eligibility and the two sets are intersected when both are present.
+         *
+         * @minItems 1
+         */
+        accepted_verification_methods?: [AgeVerificationMethod, ...AgeVerificationMethod[]];
+    };
 }
 
 /**

package/dist/lib/types/schemas.generated.d.ts

@@ -1825,7 +1825,10 @@ export declare const DemographicTargetingIntentSchema: z.ZodObject<{
         min: z.ZodOptional<z.ZodNumber>;
         max: z.ZodOptional<z.ZodNumber>;
         include_unknown: z.ZodBoolean;
-    }, z.core.$loose>, z.ZodObject<{}, z.core.$loose>>;
+    }, z.core.$loose>, z.ZodObject<{
+        accepted_bases: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"verified">, z.ZodLiteral<"declared">, z.ZodLiteral<"inferred">]>>>;
+        accepted_verification_methods: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"facial_age_estimation">, z.ZodLiteral<"id_document">, z.ZodLiteral<"digital_id">, z.ZodLiteral<"credit_card">, z.ZodLiteral<"world_id">]>>>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 export declare const SellerAgentReferenceSchema: z.ZodObject<{
     agent_url: z.ZodString;
@@ -5126,7 +5129,10 @@ export declare const DemographicTargetingResolutionSchema: z.ZodObject<{
             min: z.ZodOptional<z.ZodNumber>;
             max: z.ZodOptional<z.ZodNumber>;
             include_unknown: z.ZodBoolean;
-        }, z.core.$loose>, z.ZodObject<{}, z.core.$loose>>;
+        }, z.core.$loose>, z.ZodObject<{
+            accepted_bases: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"verified">, z.ZodLiteral<"declared">, z.ZodLiteral<"inferred">]>>>;
+            accepted_verification_methods: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"facial_age_estimation">, z.ZodLiteral<"id_document">, z.ZodLiteral<"digital_id">, z.ZodLiteral<"credit_card">, z.ZodLiteral<"world_id">]>>>;
+        }, z.core.$loose>>;
     }, z.core.$loose>;
     applied: z.ZodObject<{
         age: z.ZodObject<{
@@ -22439,7 +22445,10 @@ export declare const PackageTargetingResolutionSchema: z.ZodObject<{
                 min: z.ZodOptional<z.ZodNumber>;
                 max: z.ZodOptional<z.ZodNumber>;
                 include_unknown: z.ZodBoolean;
-            }, z.core.$loose>, z.ZodObject<{}, z.core.$loose>>;
+            }, z.core.$loose>, z.ZodObject<{
+                accepted_bases: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"verified">, z.ZodLiteral<"declared">, z.ZodLiteral<"inferred">]>>>;
+                accepted_verification_methods: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"facial_age_estimation">, z.ZodLiteral<"id_document">, z.ZodLiteral<"digital_id">, z.ZodLiteral<"credit_card">, z.ZodLiteral<"world_id">]>>>;
+            }, z.core.$loose>>;
         }, z.core.$loose>;
         applied: z.ZodObject<{
             age: z.ZodObject<{

package/dist/lib/types/schemas.generated.js

@@ -2933,7 +2933,10 @@ const PackageSignalTargetingSchema = SignalTargetingExpressionSchema.and(import_
   activation_key: ActivationKeySchema.optional()
 }).passthrough());
 const DemographicTargetingIntentSchema = import_zod.z.object({
-  age: DemographicAgeRangeSchema.and(import_zod.z.object({}).passthrough())
+  age: DemographicAgeRangeSchema.and(import_zod.z.object({
+    accepted_bases: import_zod.z.array(AgeDeterminationBasisSchema).optional(),
+    accepted_verification_methods: import_zod.z.array(AgeVerificationMethodSchema).optional()
+  }).passthrough())
 }).passthrough();
 const SellerAgentReferenceSchema = import_zod.z.object({
   agent_url: import_zod.z.string().refine(adcpJsonSchemaUri, "Invalid URI"),

package/dist/lib/types/schemas.generated.mjs

@@ -1416,7 +1416,10 @@ const PackageSignalTargetingSchema = SignalTargetingExpressionSchema.and(z.objec
   activation_key: ActivationKeySchema.optional()
 }).passthrough());
 const DemographicTargetingIntentSchema = z.object({
-  age: DemographicAgeRangeSchema.and(z.object({}).passthrough())
+  age: DemographicAgeRangeSchema.and(z.object({
+    accepted_bases: z.array(AgeDeterminationBasisSchema).optional(),
+    accepted_verification_methods: z.array(AgeVerificationMethodSchema).optional()
+  }).passthrough())
 }).passthrough();
 const SellerAgentReferenceSchema = z.object({
   agent_url: z.string().refine(adcpJsonSchemaUri, "Invalid URI"),

package/dist/lib/types/tools.generated.d.mts

@@ -1617,7 +1617,20 @@ export interface PackageSignalTargetingGroup {
  * Canonical demographic audience targeting intent with optional constraints on how age may be determined. This is distinct from age_restriction: demographics selects an audience, while age_restriction expresses a legal eligibility or verification floor. Fresh create/update targeting MUST compile exactly or be rejected. During get_products, a seller may offer a different configured predicate only through sparse targeting_resolution modifications on a distinguishable product_id; selecting that product accepts the alternative. Sellers never silently broaden, narrow, default, drop, or substitute the basis.
  */
 export interface DemographicTargetingIntent {
-    age: DemographicAgeRange & {};
+    age: DemographicAgeRange & {
+        /**
+         * User-level age determination bases the buyer permits for this predicate. Sellers MUST use only these bases or reject the request; they MUST NOT silently fall back to another basis. When omitted, the buyer imposes no determination-basis constraint beyond product capability and any age_restriction. population_estimate is structurally unavailable because aggregate evidence cannot identify an eligible user.
+         *
+         * @minItems 1
+         */
+        accepted_bases?: [AgeDeterminationBasis, ...AgeDeterminationBasis[]];
+        /**
+         * Verification methods acceptable when verified is an accepted basis. This field narrows verified demographic execution; age_restriction.accepted_methods independently governs legal eligibility and the two sets are intersected when both are present.
+         *
+         * @minItems 1
+         */
+        accepted_verification_methods?: [AgeVerificationMethod, ...AgeVerificationMethod[]];
+    };
 }
 /**
  * Reference to a property list for targeting specific properties within this product. The package runs on the intersection of the product's publisher_properties and this list. Sellers SHOULD return a validation error if the product has property_targeting_allowed: false.

package/dist/lib/types/tools.generated.d.ts

@@ -1617,7 +1617,20 @@ export interface PackageSignalTargetingGroup {
  * Canonical demographic audience targeting intent with optional constraints on how age may be determined. This is distinct from age_restriction: demographics selects an audience, while age_restriction expresses a legal eligibility or verification floor. Fresh create/update targeting MUST compile exactly or be rejected. During get_products, a seller may offer a different configured predicate only through sparse targeting_resolution modifications on a distinguishable product_id; selecting that product accepts the alternative. Sellers never silently broaden, narrow, default, drop, or substitute the basis.
  */
 export interface DemographicTargetingIntent {
-    age: DemographicAgeRange & {};
+    age: DemographicAgeRange & {
+        /**
+         * User-level age determination bases the buyer permits for this predicate. Sellers MUST use only these bases or reject the request; they MUST NOT silently fall back to another basis. When omitted, the buyer imposes no determination-basis constraint beyond product capability and any age_restriction. population_estimate is structurally unavailable because aggregate evidence cannot identify an eligible user.
+         *
+         * @minItems 1
+         */
+        accepted_bases?: [AgeDeterminationBasis, ...AgeDeterminationBasis[]];
+        /**
+         * Verification methods acceptable when verified is an accepted basis. This field narrows verified demographic execution; age_restriction.accepted_methods independently governs legal eligibility and the two sets are intersected when both are present.
+         *
+         * @minItems 1
+         */
+        accepted_verification_methods?: [AgeVerificationMethod, ...AgeVerificationMethod[]];
+    };
 }
 /**
  * Reference to a property list for targeting specific properties within this product. The package runs on the intersection of the product's publisher_properties and this list. Sellers SHOULD return a validation error if the product has property_targeting_allowed: false.

package/dist/lib/types/update-media-buy.d.ts

@@ -5449,7 +5449,20 @@ export interface DemographicPredicate {
  * Canonical demographic audience targeting intent with optional constraints on how age may be determined. This is distinct from age_restriction: demographics selects an audience, while age_restriction expresses a legal eligibility or verification floor. Fresh create/update targeting MUST compile exactly or be rejected. During get_products, a seller may offer a different configured predicate only through sparse targeting_resolution modifications on a distinguishable product_id; selecting that product accepts the alternative. Sellers never silently broaden, narrow, default, drop, or substitute the basis.
  */
 export interface DemographicTargetingIntent {
-    age: DemographicAgeRange & {};
+    age: DemographicAgeRange & {
+        /**
+         * User-level age determination bases the buyer permits for this predicate. Sellers MUST use only these bases or reject the request; they MUST NOT silently fall back to another basis. When omitted, the buyer imposes no determination-basis constraint beyond product capability and any age_restriction. population_estimate is structurally unavailable because aggregate evidence cannot identify an eligible user.
+         *
+         * @minItems 1
+         */
+        accepted_bases?: [AgeDeterminationBasis, ...AgeDeterminationBasis[]];
+        /**
+         * Verification methods acceptable when verified is an accepted basis. This field narrows verified demographic execution; age_restriction.accepted_methods independently governs legal eligibility and the two sets are intersected when both are present.
+         *
+         * @minItems 1
+         */
+        accepted_verification_methods?: [AgeVerificationMethod, ...AgeVerificationMethod[]];
+    };
 }
 
 /**

package/dist/lib/utils/pointer-utils.d.mts

@@ -0,0 +1,2 @@
+/** Translate SDK JSON Pointers to the AdCP error.field JSONPath-lite notation. */
+export declare function jsonPointerToJsonPathLite(pointer: string): string | undefined;

package/dist/lib/utils/pointer-utils.d.ts

@@ -0,0 +1,2 @@
+/** Translate SDK JSON Pointers to the AdCP error.field JSONPath-lite notation. */
+export declare function jsonPointerToJsonPathLite(pointer: string): string | undefined;

package/dist/lib/utils/pointer-utils.js

@@ -0,0 +1,43 @@
+"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 pointer_utils_exports = {};
+__export(pointer_utils_exports, {
+  jsonPointerToJsonPathLite: () => jsonPointerToJsonPathLite
+});
+module.exports = __toCommonJS(pointer_utils_exports);
+function jsonPointerToJsonPathLite(pointer) {
+  if (pointer === "" || pointer === "/") return "$";
+  if (!pointer.startsWith("/")) return void 0;
+  let field = "";
+  for (const encoded of pointer.slice(1).split("/")) {
+    const segment = encoded.replace(/~1/g, "/").replace(/~0/g, "~");
+    if (/^(0|[1-9][0-9]*)$/.test(segment)) {
+      field += `${field ? "" : "$"}[${segment}]`;
+    } else if (/^[A-Za-z_][A-Za-z0-9_-]*$/.test(segment)) {
+      field += field ? `.${segment}` : segment;
+    } else {
+      field += `${field ? "" : "$"}[${JSON.stringify(segment)}]`;
+    }
+  }
+  return field;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  jsonPointerToJsonPathLite
+});

package/dist/lib/utils/pointer-utils.mjs

@@ -0,0 +1,19 @@
+function jsonPointerToJsonPathLite(pointer) {
+  if (pointer === "" || pointer === "/") return "$";
+  if (!pointer.startsWith("/")) return void 0;
+  let field = "";
+  for (const encoded of pointer.slice(1).split("/")) {
+    const segment = encoded.replace(/~1/g, "/").replace(/~0/g, "~");
+    if (/^(0|[1-9][0-9]*)$/.test(segment)) {
+      field += `${field ? "" : "$"}[${segment}]`;
+    } else if (/^[A-Za-z_][A-Za-z0-9_-]*$/.test(segment)) {
+      field += field ? `.${segment}` : segment;
+    } else {
+      field += `${field ? "" : "$"}[${JSON.stringify(segment)}]`;
+    }
+  }
+  return field;
+}
+export {
+  jsonPointerToJsonPathLite
+};

package/dist/lib/validation/diagnostic-limits.d.mts

@@ -0,0 +1,4 @@
+import type { ValidationIssue } from './schema-validator.mjs';
+export declare function validationDiagnosticsTruncated(issues: readonly ValidationIssue[]): boolean;
+/** Retain actionable diagnostics with a visible marker when count/bytes overflow. */
+export declare function boundValidationIssues(issues: Iterable<ValidationIssue>): ValidationIssue[];

package/dist/lib/validation/diagnostic-limits.d.ts

@@ -0,0 +1,4 @@
+import type { ValidationIssue } from './schema-validator';
+export declare function validationDiagnosticsTruncated(issues: readonly ValidationIssue[]): boolean;
+/** Retain actionable diagnostics with a visible marker when count/bytes overflow. */
+export declare function boundValidationIssues(issues: Iterable<ValidationIssue>): ValidationIssue[];

package/dist/lib/validation/diagnostic-limits.js

@@ -0,0 +1,57 @@
+"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 diagnostic_limits_exports = {};
+__export(diagnostic_limits_exports, {
+  boundValidationIssues: () => boundValidationIssues,
+  validationDiagnosticsTruncated: () => validationDiagnosticsTruncated
+});
+module.exports = __toCommonJS(diagnostic_limits_exports);
+const MAX_ISSUES = 100;
+const MAX_ISSUE_BYTES = 64 * 1024;
+const MAX_SINGLE_ISSUE_BYTES = 8 * 1024;
+const OMITTED_MESSAGE = "Validation failed; additional diagnostics omitted because the diagnostic limit was reached.";
+const OMITTED_BYTES = 8 * 1024;
+function validationDiagnosticsTruncated(issues) {
+  return issues.some((issue) => issue.message === OMITTED_MESSAGE);
+}
+function boundValidationIssues(issues) {
+  const bounded = [];
+  let bytes = 2;
+  for (const issue of issues) {
+    const issueBytes = Buffer.byteLength(JSON.stringify(issue), "utf8") + 1;
+    if (bounded.length >= MAX_ISSUES || issueBytes > MAX_SINGLE_ISSUE_BYTES || bytes + issueBytes + OMITTED_BYTES > MAX_ISSUE_BYTES) {
+      const omitted = bounded.length === MAX_ISSUES ? bounded.pop() : issue;
+      bounded.push({
+        pointer: Buffer.byteLength(omitted.pointer, "utf8") <= 1024 ? omitted.pointer : "/",
+        keyword: Buffer.byteLength(omitted.keyword, "utf8") <= 128 ? omitted.keyword : "type",
+        message: OMITTED_MESSAGE,
+        schemaPath: ""
+      });
+      break;
+    }
+    bounded.push(issue);
+    bytes += issueBytes;
+  }
+  return bounded;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  boundValidationIssues,
+  validationDiagnosticsTruncated
+});

package/dist/lib/validation/diagnostic-limits.mjs

@@ -0,0 +1,32 @@
+const MAX_ISSUES = 100;
+const MAX_ISSUE_BYTES = 64 * 1024;
+const MAX_SINGLE_ISSUE_BYTES = 8 * 1024;
+const OMITTED_MESSAGE = "Validation failed; additional diagnostics omitted because the diagnostic limit was reached.";
+const OMITTED_BYTES = 8 * 1024;
+function validationDiagnosticsTruncated(issues) {
+  return issues.some((issue) => issue.message === OMITTED_MESSAGE);
+}
+function boundValidationIssues(issues) {
+  const bounded = [];
+  let bytes = 2;
+  for (const issue of issues) {
+    const issueBytes = Buffer.byteLength(JSON.stringify(issue), "utf8") + 1;
+    if (bounded.length >= MAX_ISSUES || issueBytes > MAX_SINGLE_ISSUE_BYTES || bytes + issueBytes + OMITTED_BYTES > MAX_ISSUE_BYTES) {
+      const omitted = bounded.length === MAX_ISSUES ? bounded.pop() : issue;
+      bounded.push({
+        pointer: Buffer.byteLength(omitted.pointer, "utf8") <= 1024 ? omitted.pointer : "/",
+        keyword: Buffer.byteLength(omitted.keyword, "utf8") <= 128 ? omitted.keyword : "type",
+        message: OMITTED_MESSAGE,
+        schemaPath: ""
+      });
+      break;
+    }
+    bounded.push(issue);
+    bytes += issueBytes;
+  }
+  return bounded;
+}
+export {
+  boundValidationIssues,
+  validationDiagnosticsTruncated
+};

package/dist/lib/validation/schema-errors.d.mts

@@ -9,8 +9,9 @@ export interface ValidationErrorDetails {
     tool: string;
     /** Which side of the exchange — request (outgoing) or response (incoming). */
     side: 'request' | 'response';
-    /** All failures, each with a JSON Pointer to the bad field. */
+    /** Bounded failures, each with a JSON Pointer to the bad field. */
     issues: ValidationIssue[];
+    issues_truncated?: boolean;
 }
 /**
  * Build a `ValidationError` thrown by strict-mode client hooks. Keeps the
@@ -34,6 +35,7 @@ export interface AdcpValidationErrorDetails {
     issues: Array<Omit<ValidationIssue, 'schemaPath'> & {
         schemaPath?: string;
     }>;
+    issues_truncated?: boolean;
 }
 /**
  * Serialize issues for the server-side `adcpError('VALIDATION_ERROR', ...)` call.

package/dist/lib/validation/schema-errors.d.ts

@@ -9,8 +9,9 @@ export interface ValidationErrorDetails {
     tool: string;
     /** Which side of the exchange — request (outgoing) or response (incoming). */
     side: 'request' | 'response';
-    /** All failures, each with a JSON Pointer to the bad field. */
+    /** Bounded failures, each with a JSON Pointer to the bad field. */
     issues: ValidationIssue[];
+    issues_truncated?: boolean;
 }
 /**
  * Build a `ValidationError` thrown by strict-mode client hooks. Keeps the
@@ -34,6 +35,7 @@ export interface AdcpValidationErrorDetails {
     issues: Array<Omit<ValidationIssue, 'schemaPath'> & {
         schemaPath?: string;
     }>;
+    issues_truncated?: boolean;
 }
 /**
  * Serialize issues for the server-side `adcpError('VALIDATION_ERROR', ...)` call.

package/dist/lib/validation/schema-errors.js

@@ -24,6 +24,8 @@ __export(schema_errors_exports, {
 module.exports = __toCommonJS(schema_errors_exports);
 var import_errors = require('../errors/index.js');
 var import_schema_validator = require('./schema-validator.js');
+var import_pointer_utils = require('../utils/pointer-utils.js');
+var import_diagnostic_limits = require('./diagnostic-limits.js');
 function buildIssueProseSuffix(issue, rootSchemaId) {
   const parts = [];
   if (issue.schemaId && issue.schemaId !== rootSchemaId) parts.push(`schema: ${issue.schemaId}`);
@@ -33,14 +35,21 @@ function buildIssueProseSuffix(issue, rootSchemaId) {
   return parts.length > 0 ? ` (${parts.join("; ")})` : "";
 }
 function buildValidationError(tool, side, issues) {
+  issues = (0, import_diagnostic_limits.boundValidationIssues)(issues);
   const first = issues[0];
   const field = first?.pointer ?? "/";
   const constraint = first ? `${first.keyword}: ${first.message}${buildIssueProseSuffix(first, void 0)}` : "schema validation failed";
   const err = new import_errors.ValidationError(field, void 0, `${tool} ${side}: ${constraint}`);
-  err.details = { tool, side, issues };
+  err.details = {
+    tool,
+    side,
+    issues,
+    ...(0, import_diagnostic_limits.validationDiagnosticsTruncated)(issues) && { issues_truncated: true }
+  };
   return err;
 }
 function buildAdcpValidationErrorPayload(tool, side, issues, options = {}) {
+  issues = (0, import_diagnostic_limits.boundValidationIssues)(issues);
   const first = issues[0];
   let message;
   if (first != null) {
@@ -52,9 +61,15 @@ function buildAdcpValidationErrorPayload(tool, side, issues, options = {}) {
   const payload = {
     message,
     issues: emittedIssues,
-    details: { tool, side, issues: emittedIssues }
+    details: {
+      tool,
+      side,
+      issues: emittedIssues,
+      ...(0, import_diagnostic_limits.validationDiagnosticsTruncated)(issues) && { issues_truncated: true }
+    }
   };
-  if (first?.pointer) payload.field = first.pointer;
+  const field = first && (0, import_pointer_utils.jsonPointerToJsonPathLite)(first.pointer);
+  if (field !== void 0) payload.field = field;
   return payload;
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/lib/validation/schema-errors.mjs

@@ -1,5 +1,7 @@
 import { ValidationError } from "../errors/index.mjs";
 import { formatDiscriminator } from "./schema-validator.mjs";
+import { jsonPointerToJsonPathLite } from "../utils/pointer-utils.mjs";
+import { boundValidationIssues, validationDiagnosticsTruncated } from "./diagnostic-limits.mjs";
 function buildIssueProseSuffix(issue, rootSchemaId) {
   const parts = [];
   if (issue.schemaId && issue.schemaId !== rootSchemaId) parts.push(`schema: ${issue.schemaId}`);
@@ -9,14 +11,21 @@ function buildIssueProseSuffix(issue, rootSchemaId) {
   return parts.length > 0 ? ` (${parts.join("; ")})` : "";
 }
 function buildValidationError(tool, side, issues) {
+  issues = boundValidationIssues(issues);
   const first = issues[0];
   const field = first?.pointer ?? "/";
   const constraint = first ? `${first.keyword}: ${first.message}${buildIssueProseSuffix(first, void 0)}` : "schema validation failed";
   const err = new ValidationError(field, void 0, `${tool} ${side}: ${constraint}`);
-  err.details = { tool, side, issues };
+  err.details = {
+    tool,
+    side,
+    issues,
+    ...validationDiagnosticsTruncated(issues) && { issues_truncated: true }
+  };
   return err;
 }
 function buildAdcpValidationErrorPayload(tool, side, issues, options = {}) {
+  issues = boundValidationIssues(issues);
   const first = issues[0];
   let message;
   if (first != null) {
@@ -28,9 +37,15 @@ function buildAdcpValidationErrorPayload(tool, side, issues, options = {}) {
   const payload = {
     message,
     issues: emittedIssues,
-    details: { tool, side, issues: emittedIssues }
+    details: {
+      tool,
+      side,
+      issues: emittedIssues,
+      ...validationDiagnosticsTruncated(issues) && { issues_truncated: true }
+    }
   };
-  if (first?.pointer) payload.field = first.pointer;
+  const field = first && jsonPointerToJsonPathLite(first.pointer);
+  if (field !== void 0) payload.field = field;
   return payload;
 }
 export {