@authorizedretailers/spec 0.1.0 → 0.2.0

package/dist/schemas.js

@@ -1,11 +1,11 @@
 // Generated from schemas/*.json by scripts/embed-schemas.mjs. Do not edit by hand.
 export const common = {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://authorizedretailers.ai/schemas/0.1/common.json",
-    "title": "Authorized Retailers v0.1 shared definitions",
+    "$id": "https://authorizedretailers.ai/schemas/0.2/common.json",
+    "title": "Authorized Retailers v0.2 shared definitions",
     "$defs": {
         "specVersion": {
-            "const": "authorized-retailers/0.1"
+            "const": "authorized-retailers/0.2"
         },
         "timestamp": {
             "description": "RFC 3339 timestamp in UTC with a Z suffix.",
@@ -13,16 +13,271 @@ export const common = {
             "format": "date-time",
             "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{1,9})?Z$"
         },
+        "date": {
+            "description": "ISO 8601 calendar date.",
+            "type": "string",
+            "format": "date",
+            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+        },
         "domain": {
-            "description": "A bare hostname: no scheme, port, path or trailing dot. Compared case-insensitively.",
+            "description": "A bare hostname, lowercase: no scheme, port, path, trailing dot or leading www. (section 6).",
             "type": "string",
             "maxLength": 253,
-            "pattern": "^(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+(?:[A-Za-z]{2,63}|xn--[A-Za-z0-9-]{1,59})$"
+            "pattern": "^(?!www\\.)(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+(?:[a-z]{2,63}|xn--[a-z0-9-]{1,59})$"
         },
         "countryCode": {
-            "description": "ISO 3166-1 alpha-2, uppercase.",
-            "type": "string",
-            "pattern": "^[A-Z]{2}$"
+            "description": "ISO 3166-1 alpha-2, uppercase. The United Kingdom is GB.",
+            "enum": [
+                "AD",
+                "AE",
+                "AF",
+                "AG",
+                "AI",
+                "AL",
+                "AM",
+                "AO",
+                "AQ",
+                "AR",
+                "AS",
+                "AT",
+                "AU",
+                "AW",
+                "AX",
+                "AZ",
+                "BA",
+                "BB",
+                "BD",
+                "BE",
+                "BF",
+                "BG",
+                "BH",
+                "BI",
+                "BJ",
+                "BL",
+                "BM",
+                "BN",
+                "BO",
+                "BQ",
+                "BR",
+                "BS",
+                "BT",
+                "BV",
+                "BW",
+                "BY",
+                "BZ",
+                "CA",
+                "CC",
+                "CD",
+                "CF",
+                "CG",
+                "CH",
+                "CI",
+                "CK",
+                "CL",
+                "CM",
+                "CN",
+                "CO",
+                "CR",
+                "CU",
+                "CV",
+                "CW",
+                "CX",
+                "CY",
+                "CZ",
+                "DE",
+                "DJ",
+                "DK",
+                "DM",
+                "DO",
+                "DZ",
+                "EC",
+                "EE",
+                "EG",
+                "EH",
+                "ER",
+                "ES",
+                "ET",
+                "FI",
+                "FJ",
+                "FK",
+                "FM",
+                "FO",
+                "FR",
+                "GA",
+                "GB",
+                "GD",
+                "GE",
+                "GF",
+                "GG",
+                "GH",
+                "GI",
+                "GL",
+                "GM",
+                "GN",
+                "GP",
+                "GQ",
+                "GR",
+                "GS",
+                "GT",
+                "GU",
+                "GW",
+                "GY",
+                "HK",
+                "HM",
+                "HN",
+                "HR",
+                "HT",
+                "HU",
+                "ID",
+                "IE",
+                "IL",
+                "IM",
+                "IN",
+                "IO",
+                "IQ",
+                "IR",
+                "IS",
+                "IT",
+                "JE",
+                "JM",
+                "JO",
+                "JP",
+                "KE",
+                "KG",
+                "KH",
+                "KI",
+                "KM",
+                "KN",
+                "KP",
+                "KR",
+                "KW",
+                "KY",
+                "KZ",
+                "LA",
+                "LB",
+                "LC",
+                "LI",
+                "LK",
+                "LR",
+                "LS",
+                "LT",
+                "LU",
+                "LV",
+                "LY",
+                "MA",
+                "MC",
+                "MD",
+                "ME",
+                "MF",
+                "MG",
+                "MH",
+                "MK",
+                "ML",
+                "MM",
+                "MN",
+                "MO",
+                "MP",
+                "MQ",
+                "MR",
+                "MS",
+                "MT",
+                "MU",
+                "MV",
+                "MW",
+                "MX",
+                "MY",
+                "MZ",
+                "NA",
+                "NC",
+                "NE",
+                "NF",
+                "NG",
+                "NI",
+                "NL",
+                "NO",
+                "NP",
+                "NR",
+                "NU",
+                "NZ",
+                "OM",
+                "PA",
+                "PE",
+                "PF",
+                "PG",
+                "PH",
+                "PK",
+                "PL",
+                "PM",
+                "PN",
+                "PR",
+                "PS",
+                "PT",
+                "PW",
+                "PY",
+                "QA",
+                "RE",
+                "RO",
+                "RS",
+                "RU",
+                "RW",
+                "SA",
+                "SB",
+                "SC",
+                "SD",
+                "SE",
+                "SG",
+                "SH",
+                "SI",
+                "SJ",
+                "SK",
+                "SL",
+                "SM",
+                "SN",
+                "SO",
+                "SR",
+                "SS",
+                "ST",
+                "SV",
+                "SX",
+                "SY",
+                "SZ",
+                "TC",
+                "TD",
+                "TF",
+                "TG",
+                "TH",
+                "TJ",
+                "TK",
+                "TL",
+                "TM",
+                "TN",
+                "TO",
+                "TR",
+                "TT",
+                "TV",
+                "TW",
+                "TZ",
+                "UA",
+                "UG",
+                "UM",
+                "US",
+                "UY",
+                "UZ",
+                "VA",
+                "VC",
+                "VE",
+                "VG",
+                "VI",
+                "VN",
+                "VU",
+                "WF",
+                "WS",
+                "YE",
+                "YT",
+                "ZA",
+                "ZM",
+                "ZW"
+            ]
         },
         "httpsUrl": {
             "type": "string",
@@ -30,118 +285,164 @@ export const common = {
             "pattern": "^https://",
             "maxLength": 2048
         },
+        "registryUrl": {
+            "description": "Section 5.1: a list URL MUST be on authorizedretailers.ai.",
+            "type": "string",
+            "format": "uri",
+            "pattern": "^https://authorizedretailers\\.ai/",
+            "maxLength": 2048
+        },
         "id": {
             "type": "string",
             "pattern": "^[A-Za-z0-9_-]{1,64}$"
         },
+        "revocationId": {
+            "description": "Section 10.3: a random value, rv_ followed by at least 16 base64url characters.",
+            "type": "string",
+            "pattern": "^rv_[A-Za-z0-9_-]{16,64}$"
+        },
         "nonEmptyString": {
             "type": "string",
             "minLength": 1,
             "maxLength": 256
         },
-        "brand": {
+        "sellerId": {
+            "type": "string",
+            "pattern": "^\\S{1,128}$"
+        },
+        "amazonChannel": {
             "type": "object",
             "required": [
-                "name",
-                "domain"
+                "type",
+                "domain",
+                "seller_id"
             ],
             "additionalProperties": false,
             "properties": {
-                "name": {
-                    "$ref": "#/$defs/nonEmptyString"
+                "type": {
+                    "const": "amazon"
                 },
                 "domain": {
-                    "$ref": "#/$defs/domain"
+                    "enum": [
+                        "amazon.com",
+                        "amazon.ca",
+                        "amazon.co.uk",
+                        "amazon.de",
+                        "amazon.fr",
+                        "amazon.it",
+                        "amazon.es",
+                        "amazon.com.au"
+                    ]
+                },
+                "seller_id": {
+                    "$ref": "#/$defs/sellerId"
                 }
             }
         },
-        "sellerId": {
-            "type": "string",
-            "pattern": "^\\S{1,128}$"
-        },
-        "marketplaceChannel": {
+        "walmartChannel": {
             "type": "object",
             "required": [
                 "type",
-                "marketplace",
+                "domain",
                 "seller_id"
             ],
             "additionalProperties": false,
             "properties": {
                 "type": {
+                    "const": "walmart"
+                },
+                "domain": {
                     "enum": [
-                        "amazon",
-                        "walmart",
-                        "ebay"
+                        "walmart.com",
+                        "walmart.ca"
                     ]
                 },
-                "marketplace": {
-                    "$ref": "#/$defs/countryCode"
-                },
                 "seller_id": {
                     "$ref": "#/$defs/sellerId"
                 }
             }
         },
-        "webChannel": {
+        "ebayChannel": {
             "type": "object",
             "required": [
                 "type",
-                "domain"
+                "domain",
+                "seller_id"
             ],
             "additionalProperties": false,
             "properties": {
                 "type": {
-                    "const": "web"
+                    "const": "ebay"
                 },
                 "domain": {
-                    "$ref": "#/$defs/domain"
+                    "enum": [
+                        "ebay.com",
+                        "ebay.co.uk",
+                        "ebay.ca",
+                        "ebay.de",
+                        "ebay.com.au"
+                    ]
+                },
+                "seller_id": {
+                    "$ref": "#/$defs/sellerId"
                 }
             }
         },
-        "physicalChannel": {
+        "webChannel": {
             "type": "object",
             "required": [
                 "type",
-                "address",
-                "country"
+                "domain"
             ],
             "additionalProperties": false,
             "properties": {
                 "type": {
-                    "const": "physical"
-                },
-                "address": {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 512
+                    "const": "web"
                 },
-                "country": {
-                    "$ref": "#/$defs/countryCode"
+                "domain": {
+                    "allOf": [
+                        {
+                            "$ref": "#/$defs/domain"
+                        },
+                        {
+                            "not": {
+                                "enum": [
+                                    "amazon.com",
+                                    "amazon.ca",
+                                    "amazon.co.uk",
+                                    "amazon.de",
+                                    "amazon.fr",
+                                    "amazon.it",
+                                    "amazon.es",
+                                    "amazon.com.au",
+                                    "walmart.com",
+                                    "walmart.ca",
+                                    "ebay.com",
+                                    "ebay.co.uk",
+                                    "ebay.ca",
+                                    "ebay.de",
+                                    "ebay.com.au"
+                                ]
+                            }
+                        }
+                    ]
                 }
             }
         },
-        "verifiableChannel": {
-            "description": "A channel an agent can see and match on (section 6). Excludes physical.",
+        "channel": {
+            "description": "Section 6. Every channel is identified by a domain.",
             "oneOf": [
                 {
-                    "$ref": "#/$defs/marketplaceChannel"
+                    "$ref": "#/$defs/amazonChannel"
                 },
                 {
-                    "$ref": "#/$defs/webChannel"
-                }
-            ]
-        },
-        "channel": {
-            "oneOf": [
-                {
-                    "$ref": "#/$defs/marketplaceChannel"
+                    "$ref": "#/$defs/walmartChannel"
                 },
                 {
-                    "$ref": "#/$defs/webChannel"
+                    "$ref": "#/$defs/ebayChannel"
                 },
                 {
-                    "$ref": "#/$defs/physicalChannel"
+                    "$ref": "#/$defs/webChannel"
                 }
             ]
         },
@@ -211,19 +512,144 @@ export const common = {
                 }
             ]
         },
-        "scope": {
+        "namedProductLines": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+                "allOf": [
+                    {
+                        "$ref": "#/$defs/productLine"
+                    },
+                    {
+                        "not": {
+                            "const": "all"
+                        }
+                    }
+                ]
+            }
+        },
+        "productIds": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+                "$ref": "#/$defs/id"
+            }
+        },
+        "gtin": {
+            "description": "8, 12, 13 or 14 digits with a valid GS1 check digit (checked by the validator).",
+            "type": "string",
+            "pattern": "^([0-9]{8}|[0-9]{12,14})$"
+        },
+        "asin": {
+            "description": "10 uppercase letters or digits.",
+            "type": "string",
+            "pattern": "^[A-Z0-9]{10}$"
+        },
+        "product": {
+            "description": "Section 3.1. At least one of gtin or asins.",
             "type": "object",
             "required": [
-                "territories",
-                "product_lines"
+                "id",
+                "name"
             ],
             "additionalProperties": false,
+            "properties": {
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "name": {
+                    "$ref": "#/$defs/nonEmptyString"
+                },
+                "product_line": {
+                    "$ref": "#/$defs/productLine"
+                },
+                "attributes": {
+                    "type": "object",
+                    "maxProperties": 32,
+                    "propertyNames": {
+                        "minLength": 1,
+                        "maxLength": 64
+                    },
+                    "additionalProperties": {
+                        "type": "string",
+                        "maxLength": 256
+                    }
+                },
+                "gtin": {
+                    "$ref": "#/$defs/gtin"
+                },
+                "asins": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": {
+                        "$ref": "#/$defs/asin"
+                    }
+                }
+            },
+            "anyOf": [
+                {
+                    "required": [
+                        "gtin"
+                    ]
+                },
+                {
+                    "required": [
+                        "asins"
+                    ]
+                }
+            ]
+        },
+        "scope": {
+            "description": "Section 3. product_lines, products or both; territories optional (section 6.2).",
+            "type": "object",
+            "additionalProperties": false,
             "properties": {
                 "territories": {
                     "$ref": "#/$defs/territories"
                 },
                 "product_lines": {
                     "$ref": "#/$defs/productLines"
+                },
+                "products": {
+                    "allOf": [
+                        {
+                            "$ref": "#/$defs/productIds"
+                        },
+                        {
+                            "minItems": 1
+                        }
+                    ]
+                },
+                "exclude_product_lines": {
+                    "$ref": "#/$defs/namedProductLines"
+                },
+                "exclude_products": {
+                    "$ref": "#/$defs/productIds"
+                }
+            },
+            "anyOf": [
+                {
+                    "required": [
+                        "product_lines"
+                    ]
+                },
+                {
+                    "required": [
+                        "products"
+                    ]
+                }
+            ]
+        },
+        "exclusions": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "product_lines": {
+                    "$ref": "#/$defs/namedProductLines"
+                },
+                "products": {
+                    "$ref": "#/$defs/productIds"
                 }
             }
         },
@@ -231,21 +657,23 @@ export const common = {
             "type": "object",
             "required": [
                 "id",
+                "revocation_id",
                 "retailer",
                 "channels",
-                "scope",
-                "expires"
+                "scope"
             ],
             "additionalProperties": false,
             "properties": {
                 "id": {
                     "$ref": "#/$defs/id"
                 },
+                "revocation_id": {
+                    "$ref": "#/$defs/revocationId"
+                },
                 "retailer": {
                     "$ref": "#/$defs/party"
                 },
                 "channels": {
-                    "description": "Section 6: every authorization MUST name at least one channel identifier.",
                     "type": "array",
                     "minItems": 1,
                     "items": {
@@ -267,10 +695,50 @@ export const common = {
                     ]
                 },
                 "expires": {
+                    "description": "Optional end date set by the brand (section 10).",
                     "$ref": "#/$defs/timestamp"
                 }
             }
         },
+        "brand": {
+            "description": "Pointer form: one domain.",
+            "type": "object",
+            "required": [
+                "name",
+                "domain"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "name": {
+                    "$ref": "#/$defs/nonEmptyString"
+                },
+                "domain": {
+                    "$ref": "#/$defs/domain"
+                }
+            }
+        },
+        "listBrand": {
+            "description": "Every domain the list applies to (section 5.2).",
+            "type": "object",
+            "required": [
+                "name",
+                "domains"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "name": {
+                    "$ref": "#/$defs/nonEmptyString"
+                },
+                "domains": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": {
+                        "$ref": "#/$defs/domain"
+                    }
+                }
+            }
+        },
         "signature": {
             "type": "object",
             "required": [
@@ -292,36 +760,49 @@ export const common = {
         }
     }
 };
-export const fileFull = {
+export const list = {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://authorizedretailers.ai/schemas/0.1/file-full.json",
-    "title": "authorized-retailers.json, full form",
+    "$id": "https://authorizedretailers.ai/schemas/0.2/list.json",
+    "title": "Signed list (section 5.2)",
     "type": "object",
     "required": [
         "spec",
-        "form",
         "brand",
+        "public",
         "issued",
-        "expires",
-        "authorizations"
+        "valid_until",
+        "stale_until",
+        "signature"
     ],
     "additionalProperties": false,
     "properties": {
         "spec": {
             "$ref": "common.json#/$defs/specVersion"
         },
-        "form": {
-            "const": "full"
-        },
         "brand": {
-            "$ref": "common.json#/$defs/brand"
+            "$ref": "common.json#/$defs/listBrand"
+        },
+        "public": {
+            "type": "boolean"
         },
         "issued": {
             "$ref": "common.json#/$defs/timestamp"
         },
-        "expires": {
+        "valid_until": {
             "$ref": "common.json#/$defs/timestamp"
         },
+        "stale_until": {
+            "$ref": "common.json#/$defs/timestamp"
+        },
+        "catalog": {
+            "type": "array",
+            "items": {
+                "$ref": "common.json#/$defs/product"
+            }
+        },
+        "exclusions": {
+            "$ref": "common.json#/$defs/exclusions"
+        },
         "authorizations": {
             "type": "array",
             "items": {
@@ -329,20 +810,53 @@ export const fileFull = {
             }
         },
         "signature": {
-            "description": "Optional in the schema: an unsigned file is well-formed but does not count (section 5).",
             "$ref": "common.json#/$defs/signature"
         }
+    },
+    "if": {
+        "properties": {
+            "public": {
+                "const": true
+            }
+        }
+    },
+    "then": {
+        "required": [
+            "authorizations"
+        ]
+    },
+    "else": {
+        "not": {
+            "anyOf": [
+                {
+                    "required": [
+                        "authorizations"
+                    ]
+                },
+                {
+                    "required": [
+                        "catalog"
+                    ]
+                },
+                {
+                    "required": [
+                        "exclusions"
+                    ]
+                }
+            ]
+        }
     }
 };
-export const filePointer = {
+export const pointer = {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://authorizedretailers.ai/schemas/0.1/file-pointer.json",
-    "title": "authorized-retailers.json, pointer form",
+    "$id": "https://authorizedretailers.ai/schemas/0.2/pointer.json",
+    "title": "authorized-retailers.json pointer (section 5.1)",
     "type": "object",
     "required": [
         "spec",
         "form",
         "brand",
+        "verify_token",
         "list"
     ],
     "additionalProperties": false,
@@ -356,104 +870,80 @@ export const filePointer = {
         "brand": {
             "$ref": "common.json#/$defs/brand"
         },
+        "verify_token": {
+            "description": "The domain's public verification token (section 4).",
+            "type": "string",
+            "pattern": "^[A-Za-z0-9_-]{16,128}$"
+        },
         "list": {
-            "$ref": "common.json#/$defs/httpsUrl"
+            "$ref": "common.json#/$defs/registryUrl"
         }
     }
 };
-export const filePrivate = {
+export const revocationFeed = {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://authorizedretailers.ai/schemas/0.1/file-private.json",
-    "title": "authorized-retailers.json, private form",
+    "$id": "https://authorizedretailers.ai/schemas/0.2/revocation-feed.json",
+    "title": "Revocation feed (section 10.3)",
     "type": "object",
     "required": [
         "spec",
-        "form",
-        "brand",
-        "verify"
+        "feed",
+        "issued",
+        "valid_until",
+        "stale_until",
+        "entries",
+        "signature"
     ],
     "additionalProperties": false,
     "properties": {
         "spec": {
             "$ref": "common.json#/$defs/specVersion"
         },
-        "form": {
-            "const": "private"
+        "feed": {
+            "const": "revocations"
         },
-        "brand": {
-            "$ref": "common.json#/$defs/brand"
+        "issued": {
+            "$ref": "common.json#/$defs/timestamp"
         },
-        "verify": {
-            "$ref": "common.json#/$defs/httpsUrl"
-        }
-    }
-};
-export const file = {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://authorizedretailers.ai/schemas/0.1/file.json",
-    "title": "authorized-retailers.json, any form",
-    "type": "object",
-    "required": [
-        "form"
-    ],
-    "properties": {
-        "form": {
-            "enum": [
-                "full",
-                "pointer",
-                "private"
-            ]
-        }
-    },
-    "allOf": [
-        {
-            "if": {
-                "properties": {
-                    "form": {
-                        "const": "full"
-                    }
-                }
-            },
-            "then": {
-                "$ref": "file-full.json"
-            }
+        "valid_until": {
+            "$ref": "common.json#/$defs/timestamp"
         },
-        {
-            "if": {
-                "properties": {
-                    "form": {
-                        "const": "pointer"
-                    }
-                }
-            },
-            "then": {
-                "$ref": "file-pointer.json"
-            }
+        "stale_until": {
+            "$ref": "common.json#/$defs/timestamp"
         },
-        {
-            "if": {
+        "entries": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": [
+                    "revocation_id",
+                    "revoked"
+                ],
+                "additionalProperties": false,
                 "properties": {
-                    "form": {
-                        "const": "private"
+                    "revocation_id": {
+                        "$ref": "common.json#/$defs/revocationId"
+                    },
+                    "revoked": {
+                        "$ref": "common.json#/$defs/timestamp"
                     }
                 }
-            },
-            "then": {
-                "$ref": "file-private.json"
             }
+        },
+        "signature": {
+            "$ref": "common.json#/$defs/signature"
         }
-    ]
+    }
 };
 export const verifyRequest = {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://authorizedretailers.ai/schemas/0.1/verify-request.json",
+    "$id": "https://authorizedretailers.ai/schemas/0.2/verify-request.json",
     "title": "POST /v0/verify request (section 9)",
-    "description": "Canonical form. Registries normalize case and whitespace before validating (see normalizeVerifyRequest).",
+    "description": "Canonical form. Call normalizeVerifyRequest on raw input first.",
     "type": "object",
     "required": [
         "brand_domain",
-        "channel",
-        "territory"
+        "channel"
     ],
     "additionalProperties": false,
     "properties": {
@@ -461,26 +951,65 @@ export const verifyRequest = {
             "$ref": "common.json#/$defs/domain"
         },
         "channel": {
-            "$ref": "common.json#/$defs/verifiableChannel"
+            "$ref": "common.json#/$defs/channel"
         },
         "territory": {
             "$ref": "common.json#/$defs/countryCode"
         },
         "product_line": {
-            "description": "Defaults to \"all\" when omitted.",
             "$ref": "common.json#/$defs/productLine"
+        },
+        "product": {
+            "description": "Exactly one of gtin or asin.",
+            "oneOf": [
+                {
+                    "type": "object",
+                    "required": [
+                        "gtin"
+                    ],
+                    "additionalProperties": false,
+                    "properties": {
+                        "gtin": {
+                            "$ref": "common.json#/$defs/gtin"
+                        }
+                    }
+                },
+                {
+                    "type": "object",
+                    "required": [
+                        "asin"
+                    ],
+                    "additionalProperties": false,
+                    "properties": {
+                        "asin": {
+                            "$ref": "common.json#/$defs/asin"
+                        }
+                    }
+                }
+            ]
+        },
+        "as_of": {
+            "anyOf": [
+                {
+                    "$ref": "common.json#/$defs/date"
+                },
+                {
+                    "$ref": "common.json#/$defs/timestamp"
+                }
+            ]
         }
     }
 };
 export const verifyResponse = {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://authorizedretailers.ai/schemas/0.1/verify-response.json",
+    "$id": "https://authorizedretailers.ai/schemas/0.2/verify-response.json",
     "title": "POST /v0/verify response (section 9)",
     "type": "object",
     "required": [
         "status",
         "checked",
         "valid_until",
+        "stale_until",
         "observed",
         "signals",
         "signature"
@@ -492,7 +1021,7 @@ export const verifyResponse = {
                 "authorized",
                 "unlisted",
                 "expired",
-                "brand_unverified",
+                "brand_not_registered",
                 "disputed"
             ]
         },
@@ -500,21 +1029,75 @@ export const verifyResponse = {
             "enum": [
                 "not_registered",
                 "domain_unlinked",
-                "verification_lapsed"
+                "verification_lapsed",
+                "territory_mismatch",
+                "product_excluded",
+                "product_not_in_scope",
+                "product_not_in_catalog"
             ]
         },
         "authorization_id": {
             "$ref": "common.json#/$defs/id"
         },
+        "revocation_id": {
+            "$ref": "common.json#/$defs/revocationId"
+        },
         "expires": {
             "$ref": "common.json#/$defs/timestamp"
         },
         "checked": {
             "$ref": "common.json#/$defs/timestamp"
         },
+        "as_of": {
+            "$ref": "common.json#/$defs/timestamp"
+        },
         "valid_until": {
             "$ref": "common.json#/$defs/timestamp"
         },
+        "stale_until": {
+            "$ref": "common.json#/$defs/timestamp"
+        },
+        "product": {
+            "type": "object",
+            "required": [
+                "in_catalog"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "in_catalog": {
+                    "type": "boolean"
+                },
+                "id": {
+                    "$ref": "common.json#/$defs/id"
+                },
+                "product_line": {
+                    "$ref": "common.json#/$defs/productLine"
+                }
+            },
+            "if": {
+                "properties": {
+                    "in_catalog": {
+                        "const": false
+                    }
+                }
+            },
+            "then": {
+                "not": {
+                    "anyOf": [
+                        {
+                            "required": [
+                                "id"
+                            ]
+                        },
+                        {
+                            "required": [
+                                "product_line"
+                            ]
+                        }
+                    ]
+                }
+            }
+        },
         "observed": {
             "description": "Section 7: when the registry last saw this seller selling on the channel, within 30 days; otherwise null",
             "oneOf": [
@@ -568,11 +1151,20 @@ export const verifyResponse = {
             "if": {
                 "properties": {
                     "status": {
-                        "const": "brand_unverified"
+                        "enum": [
+                            "authorized",
+                            "expired",
+                            "disputed"
+                        ]
                     }
                 }
             },
             "then": {
+                "required": [
+                    "authorization_id"
+                ]
+            },
+            "else": {
                 "not": {
                     "anyOf": [
                         {
@@ -587,29 +1179,64 @@ export const verifyResponse = {
                         }
                     ]
                 }
+            }
+        },
+        {
+            "if": {
+                "properties": {
+                    "status": {
+                        "const": "expired"
+                    }
+                }
+            },
+            "then": {
+                "required": [
+                    "expires"
+                ]
+            }
+        },
+        {
+            "if": {
+                "properties": {
+                    "status": {
+                        "const": "authorized"
+                    }
+                }
+            },
+            "then": {
+                "required": [
+                    "revocation_id"
+                ]
             },
             "else": {
+                "properties": {
+                    "observed": {
+                        "const": null
+                    }
+                },
                 "not": {
                     "required": [
-                        "reason"
+                        "revocation_id"
                     ]
                 }
             }
         },
         {
             "if": {
-                "not": {
-                    "properties": {
-                        "status": {
-                            "const": "authorized"
-                        }
+                "properties": {
+                    "status": {
+                        "const": "brand_not_registered"
                     }
                 }
             },
             "then": {
                 "properties": {
-                    "observed": {
-                        "const": null
+                    "reason": {
+                        "enum": [
+                            "not_registered",
+                            "domain_unlinked",
+                            "verification_lapsed"
+                        ]
                     }
                 }
             }
@@ -618,42 +1245,39 @@ export const verifyResponse = {
             "if": {
                 "properties": {
                     "status": {
-                        "enum": [
-                            "authorized",
-                            "expired",
-                            "disputed"
-                        ]
+                        "const": "unlisted"
                     }
                 }
             },
             "then": {
-                "required": [
-                    "authorization_id",
-                    "expires"
-                ]
+                "properties": {
+                    "reason": {
+                        "enum": [
+                            "territory_mismatch",
+                            "product_excluded",
+                            "product_not_in_scope",
+                            "product_not_in_catalog"
+                        ]
+                    }
+                }
             }
         },
         {
             "if": {
                 "properties": {
                     "status": {
-                        "const": "unlisted"
+                        "enum": [
+                            "authorized",
+                            "expired",
+                            "disputed"
+                        ]
                     }
                 }
             },
             "then": {
                 "not": {
-                    "anyOf": [
-                        {
-                            "required": [
-                                "authorization_id"
-                            ]
-                        },
-                        {
-                            "required": [
-                                "expires"
-                            ]
-                        }
+                    "required": [
+                        "reason"
                     ]
                 }
             }