@adcp/sdk 13.0.0-rc.0 → 13.0.0-rc.2

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

@@ -28,7 +28,11 @@ export interface paths {
         };
         /**
          * Resolve brand
-         * @description Resolve a domain to its canonical brand identity. Follows brand.json redirects and returns the resolved brand with its house, architecture type, and optional manifest.
+         * @description Resolve a domain to its canonical brand identity. Follows brand.json redirects and returns the resolved brand with its house, architecture type, and optional manifest. The domain must be a bare DNS hostname.
+         *
+         *     A domain is authoritative for its own identity, so `source` tells you who published the record and `relationship_trust` tells you whether a brand-to-house relationship was confirmed by both sides. Only `mutual` and `inline` are reciprocated; treat everything else as a claim.
+         *
+         *     **Rate limit:** 60 requests per minute per IP address.
          */
         get: operations["resolveBrand"];
         put?: never;
@@ -50,9 +54,9 @@ export interface paths {
         put?: never;
         /**
          * Bulk resolve brands
-         * @description Resolve up to 100 domains to their canonical brand identities in a single request.
+         * @description Resolve up to 25 domains to their canonical brand identities in a single request. Unresolvable domains map to `null`.
          *
-         *     **Rate limit:** 20 requests per minute per IP address.
+         *     **Rate limits:** 20 requests and 100 unique domain resolutions per minute per IP address. Request bodies are capped at 16 KB.
          */
         post: operations["resolveBrandsBulk"];
         delete?: never;
@@ -70,7 +74,9 @@ export interface paths {
         };
         /**
          * Get brand.json
-         * @description Fetch the raw brand.json file for a domain.
+         * @description Fetch the raw brand.json file for a bare DNS hostname.
+         *
+         *     **Rate limit:** 60 requests per minute per IP address.
          */
         get: operations["getBrandJson"];
         put?: never;
@@ -2104,13 +2110,52 @@ export interface components {
             keller_type?: "master" | "sub_brand" | "endorsed" | "independent";
             parent_brand?: string;
             house_domain?: string;
+            /** @description House the requested domain claims. One-sided until the named house names it back, so it never extends relationship trust on its own. */
+            claimed_house_domain?: string;
             house_name?: string;
+            /**
+             * @description How the brand-to-house relationship was established. `inline`: the house's own document defines the brand. `mutual`: both sides publish the relationship — the trust-extending edge. `leaf_only`: the brand claims a house that has not reciprocated. `house_only`: a house claims the brand, which has not reciprocated. `standalone`: the brand claims no house. `unverifiable`: a claimed house could not be checked.
+             * @enum {string}
+             */
+            relationship_trust?: "inline" | "mutual" | "leaf_only" | "house_only" | "standalone" | "unverifiable";
+            /**
+             * @description When both sides of a mutual relationship were last seen agreeing. Present only for `mutual`, and it does not advance while the house side is unreachable, so callers can apply their own edge-aging policy.
+             * @example 2026-07-28T12:00:00Z
+             */
+            relationship_verified_at?: string;
+            /** @description Set when a pre-v3 document was promoted to a canonical v3 document for this response. Identity only — legacy relationship data is preserved opaquely, never promoted to a trust claim. */
+            promoted_from_schema?: string;
+            migration_warnings?: {
+                field: string;
+                message: string;
+                suggestion?: string;
+            }[];
             brand_agent_url?: string;
             brand_manifest?: {
                 [key: string]: unknown;
             };
-            /** @enum {string} */
-            source: "brand_json" | "community" | "enriched";
+            /**
+             * @description Where the record came from. `brand_json`: the domain's own /.well-known/brand.json. `hosted`: registered by an owner whose control of the domain was verified. `community`: contributed by a member. `enriched`: third-party enrichment.
+             * @enum {string}
+             */
+            source: "hosted" | "brand_json" | "community" | "enriched";
+            /** @description Live origin-validation diagnostics when fresh=true falls back to a stored registry record. */
+            live_brand_json?: {
+                valid: boolean;
+                url: string;
+                status_code?: number;
+                errors: {
+                    field: string;
+                    message: string;
+                    /** @enum {string} */
+                    severity: "error";
+                }[];
+                warnings: {
+                    field: string;
+                    message: string;
+                    suggestion?: string;
+                }[];
+            };
         };
         LocalizedName: {
             [key: string]: string;
@@ -4093,6 +4138,7 @@ export interface operations {
         parameters: {
             query: {
                 domain: string;
+                /** @description Bypass the resolution cache and refetch from the origin. When a fresh fetch fails and a stored record is returned instead, `live_brand_json` carries that fetch's diagnostics. */
                 fresh?: "true" | "false";
             };
             header?: never;
@@ -4110,6 +4156,15 @@ export interface operations {
                     "application/json": components["schemas"]["ResolvedBrand"];
                 };
             };
+            /** @description Invalid or missing domain */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Brand not found */
             404: {
                 headers: {
@@ -4124,6 +4179,15 @@ export interface operations {
                     };
                 };
             };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     resolveBrandsBulk: {
@@ -4154,6 +4218,24 @@ export interface operations {
                     };
                 };
             };
+            /** @description Invalid domain list */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Request body over 16 KB */
+            413: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Rate limit exceeded */
             429: {
                 headers: {
@@ -4163,6 +4245,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Too much resolution work is already queued */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     getBrandJson: {
@@ -4190,10 +4281,40 @@ export interface operations {
                         data: {
                             [key: string]: unknown;
                         };
-                        warnings?: string[];
+                        warnings?: {
+                            field: string;
+                            message: string;
+                            suggestion?: string;
+                        }[];
+                        promoted_from_schema?: string;
+                        live_brand_json?: {
+                            valid: boolean;
+                            url: string;
+                            status_code?: number;
+                            errors: {
+                                field: string;
+                                message: string;
+                                /** @enum {string} */
+                                severity: "error";
+                            }[];
+                            warnings: {
+                                field: string;
+                                message: string;
+                                suggestion?: string;
+                            }[];
+                        };
                     };
                 };
             };
+            /** @description Invalid or missing domain */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Brand not found */
             404: {
                 headers: {
@@ -4203,6 +4324,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     saveBrand: {

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

@@ -28,7 +28,11 @@ export interface paths {
         };
         /**
          * Resolve brand
-         * @description Resolve a domain to its canonical brand identity. Follows brand.json redirects and returns the resolved brand with its house, architecture type, and optional manifest.
+         * @description Resolve a domain to its canonical brand identity. Follows brand.json redirects and returns the resolved brand with its house, architecture type, and optional manifest. The domain must be a bare DNS hostname.
+         *
+         *     A domain is authoritative for its own identity, so `source` tells you who published the record and `relationship_trust` tells you whether a brand-to-house relationship was confirmed by both sides. Only `mutual` and `inline` are reciprocated; treat everything else as a claim.
+         *
+         *     **Rate limit:** 60 requests per minute per IP address.
          */
         get: operations["resolveBrand"];
         put?: never;
@@ -50,9 +54,9 @@ export interface paths {
         put?: never;
         /**
          * Bulk resolve brands
-         * @description Resolve up to 100 domains to their canonical brand identities in a single request.
+         * @description Resolve up to 25 domains to their canonical brand identities in a single request. Unresolvable domains map to `null`.
          *
-         *     **Rate limit:** 20 requests per minute per IP address.
+         *     **Rate limits:** 20 requests and 100 unique domain resolutions per minute per IP address. Request bodies are capped at 16 KB.
          */
         post: operations["resolveBrandsBulk"];
         delete?: never;
@@ -70,7 +74,9 @@ export interface paths {
         };
         /**
          * Get brand.json
-         * @description Fetch the raw brand.json file for a domain.
+         * @description Fetch the raw brand.json file for a bare DNS hostname.
+         *
+         *     **Rate limit:** 60 requests per minute per IP address.
          */
         get: operations["getBrandJson"];
         put?: never;
@@ -2104,13 +2110,52 @@ export interface components {
             keller_type?: "master" | "sub_brand" | "endorsed" | "independent";
             parent_brand?: string;
             house_domain?: string;
+            /** @description House the requested domain claims. One-sided until the named house names it back, so it never extends relationship trust on its own. */
+            claimed_house_domain?: string;
             house_name?: string;
+            /**
+             * @description How the brand-to-house relationship was established. `inline`: the house's own document defines the brand. `mutual`: both sides publish the relationship — the trust-extending edge. `leaf_only`: the brand claims a house that has not reciprocated. `house_only`: a house claims the brand, which has not reciprocated. `standalone`: the brand claims no house. `unverifiable`: a claimed house could not be checked.
+             * @enum {string}
+             */
+            relationship_trust?: "inline" | "mutual" | "leaf_only" | "house_only" | "standalone" | "unverifiable";
+            /**
+             * @description When both sides of a mutual relationship were last seen agreeing. Present only for `mutual`, and it does not advance while the house side is unreachable, so callers can apply their own edge-aging policy.
+             * @example 2026-07-28T12:00:00Z
+             */
+            relationship_verified_at?: string;
+            /** @description Set when a pre-v3 document was promoted to a canonical v3 document for this response. Identity only — legacy relationship data is preserved opaquely, never promoted to a trust claim. */
+            promoted_from_schema?: string;
+            migration_warnings?: {
+                field: string;
+                message: string;
+                suggestion?: string;
+            }[];
             brand_agent_url?: string;
             brand_manifest?: {
                 [key: string]: unknown;
             };
-            /** @enum {string} */
-            source: "brand_json" | "community" | "enriched";
+            /**
+             * @description Where the record came from. `brand_json`: the domain's own /.well-known/brand.json. `hosted`: registered by an owner whose control of the domain was verified. `community`: contributed by a member. `enriched`: third-party enrichment.
+             * @enum {string}
+             */
+            source: "hosted" | "brand_json" | "community" | "enriched";
+            /** @description Live origin-validation diagnostics when fresh=true falls back to a stored registry record. */
+            live_brand_json?: {
+                valid: boolean;
+                url: string;
+                status_code?: number;
+                errors: {
+                    field: string;
+                    message: string;
+                    /** @enum {string} */
+                    severity: "error";
+                }[];
+                warnings: {
+                    field: string;
+                    message: string;
+                    suggestion?: string;
+                }[];
+            };
         };
         LocalizedName: {
             [key: string]: string;
@@ -4093,6 +4138,7 @@ export interface operations {
         parameters: {
             query: {
                 domain: string;
+                /** @description Bypass the resolution cache and refetch from the origin. When a fresh fetch fails and a stored record is returned instead, `live_brand_json` carries that fetch's diagnostics. */
                 fresh?: "true" | "false";
             };
             header?: never;
@@ -4110,6 +4156,15 @@ export interface operations {
                     "application/json": components["schemas"]["ResolvedBrand"];
                 };
             };
+            /** @description Invalid or missing domain */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Brand not found */
             404: {
                 headers: {
@@ -4124,6 +4179,15 @@ export interface operations {
                     };
                 };
             };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     resolveBrandsBulk: {
@@ -4154,6 +4218,24 @@ export interface operations {
                     };
                 };
             };
+            /** @description Invalid domain list */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Request body over 16 KB */
+            413: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Rate limit exceeded */
             429: {
                 headers: {
@@ -4163,6 +4245,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Too much resolution work is already queued */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     getBrandJson: {
@@ -4190,10 +4281,40 @@ export interface operations {
                         data: {
                             [key: string]: unknown;
                         };
-                        warnings?: string[];
+                        warnings?: {
+                            field: string;
+                            message: string;
+                            suggestion?: string;
+                        }[];
+                        promoted_from_schema?: string;
+                        live_brand_json?: {
+                            valid: boolean;
+                            url: string;
+                            status_code?: number;
+                            errors: {
+                                field: string;
+                                message: string;
+                                /** @enum {string} */
+                                severity: "error";
+                            }[];
+                            warnings: {
+                                field: string;
+                                message: string;
+                                suggestion?: string;
+                            }[];
+                        };
                     };
                 };
             };
+            /** @description Invalid or missing domain */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Brand not found */
             404: {
                 headers: {
@@ -4203,6 +4324,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     saveBrand: {