@adcp/client 4.8.0 → 4.9.0

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

@@ -121,6 +121,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/brands/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Brand activity history
+         * @description Returns the edit history for a brand in the registry, newest first. Only brands with community or enriched edits have history; brand.json-sourced brands are authoritative and do not generate revisions.
+         */
+        get: operations["getBrandHistory"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/brands/enrich": {
         parameters: {
             query?: never;
@@ -141,6 +161,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/properties/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Property activity history
+         * @description Returns the edit history for a property in the registry, newest first.
+         */
+        get: operations["getPropertyHistory"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/properties/resolve": {
         parameters: {
             query?: never;
@@ -631,6 +671,108 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/policies/registry": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List policies
+         * @description Browse and search the governance policy registry. Returns approved policies with optional filtering by category, enforcement level, jurisdiction, vertical, and governance domain.
+         */
+        get: operations["listPolicies"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/policies/resolve": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Resolve policy
+         * @description Resolve a single policy by ID. Optionally pin to a specific version — returns null if the version does not match.
+         */
+        get: operations["resolvePolicy"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/policies/resolve/bulk": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Bulk resolve policies
+         * @description Resolve up to 100 policies by ID in a single request. Returns a map of policy_id to Policy (or null if not found).
+         *
+         *     **Rate limit:** 20 requests per minute per IP address.
+         */
+        post: operations["resolvePoliciesBulk"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/policies/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Policy revision history
+         * @description Retrieve the edit history for a policy. Each revision records who made the change, a summary, and whether it was a rollback.
+         */
+        get: operations["getPolicyHistory"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/policies/save": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Save policy
+         * @description Create or update a community-contributed policy. Requires authentication. Registry-sourced and pending-review policies cannot be edited (returns 409). Updates automatically create a revision record.
+         */
+        post: operations["savePolicy"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -674,6 +816,48 @@ export interface components {
             /** @enum {string} */
             keller_type?: "master" | "sub_brand" | "endorsed" | "independent";
         };
+        BrandActivity: {
+            /** @example acmecorp.com */
+            domain: string;
+            /** @example 3 */
+            total: number;
+            revisions: {
+                /** @example 3 */
+                revision_number: number;
+                /** @example Pinnacle Media */
+                editor_name: string;
+                /** @example Updated logo and brand colors */
+                edit_summary: string;
+                /** @description Source type of the record at the time of this revision (brand_json, enriched, community) */
+                source?: string;
+                is_rollback: boolean;
+                /** @description Revision number that was restored; only present when is_rollback is true */
+                rolled_back_to?: number;
+                /** @example 2026-03-01T12:34:56Z */
+                created_at: string;
+            }[];
+        };
+        PropertyActivity: {
+            /** @example examplepub.com */
+            domain: string;
+            /** @example 3 */
+            total: number;
+            revisions: {
+                /** @example 3 */
+                revision_number: number;
+                /** @example Pinnacle Media */
+                editor_name: string;
+                /** @example Updated logo and brand colors */
+                edit_summary: string;
+                /** @description Source type of the record at the time of this revision (brand_json, enriched, community) */
+                source?: string;
+                is_rollback: boolean;
+                /** @description Revision number that was restored; only present when is_rollback is true */
+                rolled_back_to?: number;
+                /** @example 2026-03-01T12:34:56Z */
+                created_at: string;
+            }[];
+        };
         ResolvedProperty: {
             /** @example examplepub.com */
             publisher_domain: string;
@@ -842,6 +1026,183 @@ export interface components {
             property_ids?: string[];
             tags?: string[];
         };
+        PolicySummary: {
+            /** @example gdpr_consent */
+            policy_id: string;
+            /** @example 1.0.0 */
+            version: string;
+            /** @example GDPR Consent Requirements */
+            name: string;
+            /** @example Requirements for valid consent under GDPR */
+            description: string | null;
+            /** @enum {string} */
+            category: "regulation" | "standard";
+            /** @enum {string} */
+            enforcement: "must" | "should" | "may";
+            /**
+             * @example [
+             *       "EU",
+             *       "EEA"
+             *     ]
+             */
+            jurisdictions: string[];
+            /**
+             * @example {
+             *       "EU": [
+             *         "DE",
+             *         "FR",
+             *         "IT"
+             *       ]
+             *     }
+             */
+            region_aliases: {
+                [key: string]: string[];
+            };
+            /**
+             * @example [
+             *       "finance",
+             *       "healthcare"
+             *     ]
+             */
+            verticals: string[];
+            /**
+             * @example [
+             *       "display",
+             *       "video"
+             *     ]
+             */
+            channels: string[] | null;
+            /**
+             * @example [
+             *       "campaign",
+             *       "creative"
+             *     ]
+             */
+            governance_domains: string[];
+            /** @example 2025-05-25 */
+            effective_date: string | null;
+            sunset_date: string | null;
+            /** @example https://eur-lex.europa.eu/eli/reg/2016/679/oj */
+            source_url: string | null;
+            /** @example EUR-Lex */
+            source_name: string | null;
+            /** @enum {string} */
+            source_type: "registry" | "community";
+            /** @enum {string} */
+            review_status: "pending" | "approved";
+            /** @example 2026-03-01T12:00:00.000Z */
+            created_at: string;
+            /** @example 2026-03-01T12:00:00.000Z */
+            updated_at: string;
+        };
+        Policy: {
+            /** @example gdpr_consent */
+            policy_id: string;
+            /** @example 1.0.0 */
+            version: string;
+            /** @example GDPR Consent Requirements */
+            name: string;
+            /** @example Requirements for valid consent under GDPR */
+            description: string | null;
+            /** @enum {string} */
+            category: "regulation" | "standard";
+            /** @enum {string} */
+            enforcement: "must" | "should" | "may";
+            /**
+             * @example [
+             *       "EU",
+             *       "EEA"
+             *     ]
+             */
+            jurisdictions: string[];
+            /**
+             * @example {
+             *       "EU": [
+             *         "DE",
+             *         "FR",
+             *         "IT"
+             *       ]
+             *     }
+             */
+            region_aliases: {
+                [key: string]: string[];
+            };
+            /**
+             * @example [
+             *       "finance",
+             *       "healthcare"
+             *     ]
+             */
+            verticals: string[];
+            /**
+             * @example [
+             *       "display",
+             *       "video"
+             *     ]
+             */
+            channels: string[] | null;
+            /**
+             * @example [
+             *       "campaign",
+             *       "creative"
+             *     ]
+             */
+            governance_domains: string[];
+            /** @example 2025-05-25 */
+            effective_date: string | null;
+            sunset_date: string | null;
+            /** @example https://eur-lex.europa.eu/eli/reg/2016/679/oj */
+            source_url: string | null;
+            /** @example EUR-Lex */
+            source_name: string | null;
+            /** @example Data subjects must provide freely given, specific, informed and unambiguous consent... */
+            policy: string;
+            guidance: string | null;
+            exemplars: {
+                pass?: {
+                    /** @example Ad for alcohol shown during children's programming */
+                    scenario: string;
+                    /** @example Violates watershed timing rules for alcohol advertising */
+                    explanation: string;
+                }[];
+                fail?: {
+                    /** @example Ad for alcohol shown during children's programming */
+                    scenario: string;
+                    /** @example Violates watershed timing rules for alcohol advertising */
+                    explanation: string;
+                }[];
+            } | null;
+            ext: {
+                [key: string]: unknown;
+            } | null;
+            /** @enum {string} */
+            source_type: "registry" | "community";
+            /** @enum {string} */
+            review_status: "pending" | "approved";
+            /** @example 2026-03-01T12:00:00.000Z */
+            created_at: string;
+            /** @example 2026-03-01T12:00:00.000Z */
+            updated_at: string;
+        };
+        PolicyHistory: {
+            /** @example gdpr_consent */
+            policy_id: string;
+            /** @example 3 */
+            total: number;
+            revisions: {
+                /** @example 2 */
+                revision_number: number;
+                /** @example Pinnacle Media */
+                editor_name: string;
+                /** @example Clarified consent requirements for minors */
+                edit_summary: string;
+                is_rollback: boolean;
+                /** @description Revision number that was restored; only present when is_rollback is true */
+                rolled_back_to?: number;
+                /** @example 2026-03-01T12:34:56Z */
+                created_at: string;
+            }[];
+        };
     };
     responses: never;
     parameters: never;
@@ -1094,7 +1455,6 @@ export interface operations {
                         stats: {
                             total: number;
                             brand_json: number;
-                            hosted: number;
                             community: number;
                             enriched: number;
                         };
@@ -1103,6 +1463,51 @@ export interface operations {
             };
         };
     };
+    getBrandHistory: {
+        parameters: {
+            query: {
+                domain: string;
+                limit?: string;
+                offset?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Brand activity history */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BrandActivity"];
+                };
+            };
+            /** @description domain parameter required */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Brand not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                        domain: string;
+                    };
+                };
+            };
+        };
+    };
     enrichBrand: {
         parameters: {
             query: {
@@ -1136,6 +1541,51 @@ export interface operations {
             };
         };
     };
+    getPropertyHistory: {
+        parameters: {
+            query: {
+                domain: string;
+                limit?: string;
+                offset?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Property activity history */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PropertyActivity"];
+                };
+            };
+            /** @description domain parameter required */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Property not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                        domain: string;
+                    };
+                };
+            };
+        };
+    };
     resolveProperty: {
         parameters: {
             query: {
@@ -1999,6 +2449,305 @@ export interface operations {
             };
         };
     };
+    listPolicies: {
+        parameters: {
+            query?: {
+                /** @description Full-text search on policy name and description */
+                search?: string;
+                category?: "regulation" | "standard";
+                enforcement?: "must" | "should" | "may";
+                /** @description Filter by jurisdiction (includes region alias matching) */
+                jurisdiction?: string;
+                vertical?: string;
+                /** @description Filter by governance domain */
+                domain?: string;
+                /** @description Results per page (default 20, max 1000) */
+                limit?: string;
+                /** @description Pagination offset (default 0) */
+                offset?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Policy listing with facet stats */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        policies: components["schemas"]["PolicySummary"][];
+                        stats: {
+                            total: number;
+                            regulation: number;
+                            standard: number;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    resolvePolicy: {
+        parameters: {
+            query: {
+                policy_id: string;
+                /** @description Return null if the current version does not match */
+                version?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Policy resolved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Policy"];
+                };
+            };
+            /** @description Missing policy_id */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Policy not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                        policy_id: string;
+                    };
+                };
+            };
+        };
+    };
+    resolvePoliciesBulk: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /**
+                     * @example [
+                     *       "gdpr_consent",
+                     *       "coppa_children"
+                     *     ]
+                     */
+                    policy_ids: string[];
+                };
+            };
+        };
+        responses: {
+            /** @description Bulk resolution results */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        results: {
+                            [key: string]: components["schemas"]["Policy"] & (Record<string, never> | null);
+                        };
+                    };
+                };
+            };
+            /** @description Invalid request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    getPolicyHistory: {
+        parameters: {
+            query: {
+                policy_id: string;
+                /** @description Results per page (max 100, default 20) */
+                limit?: string;
+                /** @description Pagination offset (default 0) */
+                offset?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Revision history */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PolicyHistory"];
+                };
+            };
+            /** @description Missing policy_id */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Policy not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                        policy_id: string;
+                    };
+                };
+            };
+        };
+    };
+    savePolicy: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Lowercase alphanumeric with underscores
+                     * @example my_brand_safety
+                     */
+                    policy_id: string;
+                    /** @example 1.0.0 */
+                    version: string;
+                    /** @example Acme Corp Brand Safety */
+                    name: string;
+                    /** @enum {string} */
+                    category: "regulation" | "standard";
+                    /** @enum {string} */
+                    enforcement: "must" | "should" | "may";
+                    /** @example Ads must not appear adjacent to content depicting violence... */
+                    policy: string;
+                    description?: string;
+                    jurisdictions?: string[];
+                    region_aliases?: {
+                        [key: string]: string[];
+                    };
+                    verticals?: string[];
+                    channels?: string[];
+                    effective_date?: string;
+                    sunset_date?: string;
+                    governance_domains?: string[];
+                    /** @description Must use http:// or https:// */
+                    source_url?: string;
+                    source_name?: string;
+                    guidance?: string;
+                    exemplars?: {
+                        pass?: {
+                            scenario: string;
+                            explanation: string;
+                        }[];
+                        fail?: {
+                            scenario: string;
+                            explanation: string;
+                        }[];
+                    };
+                    ext?: {
+                        [key: string]: unknown;
+                    };
+                };
+            };
+        };
+        responses: {
+            /** @description Policy saved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @enum {boolean} */
+                        success: true;
+                        message: string;
+                        policy_id: string;
+                        revision_number: number | null;
+                    };
+                };
+            };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Cannot edit registry-sourced or pending policy */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                        policy_id: string;
+                    };
+                };
+            };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
 }
 export type ResolvedBrand = components['schemas']['ResolvedBrand'];
 export type LocalizedName = components['schemas']['LocalizedName'];