{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/hermai/main/json-schema/hermai-brand-demo-response-schema.json",
  "title": "BrandDemoResponse",
  "x-generated": "2026-10-18",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/hermai-api-openapi.json#/components/schemas/BrandDemoResponse",
  "properties": {
    "brand": {
      "properties": {
        "colors": {
          "items": {
            "$ref": "#/$defs/BrandColorEntry"
          },
          "type": "array"
        },
        "description": {
          "$ref": "#/$defs/BrandNullableStringField"
        },
        "logos": {
          "items": {
            "$ref": "#/$defs/BrandLogoAsset"
          },
          "type": "array"
        },
        "name": {
          "$ref": "#/$defs/BrandNullableStringField"
        }
      },
      "type": "object"
    },
    "domain": {
      "type": "string"
    },
    "status": {
      "enum": [
        "ok",
        "partial",
        "not_found",
        "fetch_failed"
      ],
      "type": "string"
    }
  },
  "type": "object",
  "$defs": {
    "BrandColorEntry": {
      "properties": {
        "brightness": {
          "description": "WCAG relative luminance, 0 to 1.",
          "type": "number"
        },
        "derivation": {
          "description": "declared: found explicitly on the page (theme-color, manifest). derived: computed from an asset (for example quantized from a logo).",
          "enum": [
            "declared",
            "derived"
          ],
          "type": "string"
        },
        "hex": {
          "type": "string"
        },
        "observed_at": {
          "format": "date-time",
          "type": "string"
        },
        "origin": {
          "enum": [
            "observed",
            "inferred",
            "synthesized",
            "corrected"
          ],
          "type": "string"
        },
        "role": {
          "enum": [
            "accent",
            "background",
            "text",
            "neutral"
          ],
          "type": "string"
        },
        "source": {
          "properties": {
            "signal": {
              "description": "The extraction signal that produced this value.",
              "enum": [
                "bimi",
                "json_ld",
                "manifest",
                "apple_touch_icon",
                "link_icon",
                "header_dom",
                "meta_og",
                "meta_theme_color",
                "css_var",
                "render_computed",
                "llm_classified",
                "manual_correction",
                "page_title",
                "registrable_domain",
                "logo_derived",
                "meta_description"
              ],
              "type": "string"
            },
            "url": {
              "description": "The page or record this value was observed on.",
              "type": "string"
            }
          },
          "type": "object"
        }
      },
      "type": "object"
    },
    "BrandLogoAsset": {
      "properties": {
        "asset_version": {
          "type": "string"
        },
        "format": {
          "enum": [
            "svg",
            "png",
            "webp",
            "jpeg"
          ],
          "type": "string"
        },
        "height": {
          "type": "integer"
        },
        "kind": {
          "enum": [
            "icon",
            "wordmark",
            "symbol",
            "unknown"
          ],
          "type": "string"
        },
        "observed_at": {
          "format": "date-time",
          "type": "string"
        },
        "origin": {
          "enum": [
            "observed",
            "inferred",
            "synthesized",
            "corrected"
          ],
          "type": "string"
        },
        "source": {
          "properties": {
            "signal": {
              "description": "The extraction signal that produced this value.",
              "enum": [
                "bimi",
                "json_ld",
                "manifest",
                "apple_touch_icon",
                "link_icon",
                "header_dom",
                "meta_og",
                "meta_theme_color",
                "css_var",
                "render_computed",
                "llm_classified",
                "manual_correction",
                "page_title",
                "registrable_domain",
                "logo_derived",
                "meta_description"
              ],
              "type": "string"
            },
            "url": {
              "description": "The page or record this value was observed on.",
              "type": "string"
            }
          },
          "type": "object"
        },
        "theme": {
          "anyOf": [
            {
              "enum": [
                "light",
                "dark",
                "universal"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "null when theme classification is uncertain, never a guess."
        },
        "url": {
          "type": "string"
        },
        "width": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "BrandNullableStringField": {
      "anyOf": [
        {
          "properties": {
            "observed_at": {
              "format": "date-time",
              "type": "string"
            },
            "origin": {
              "enum": [
                "observed",
                "inferred",
                "synthesized",
                "corrected"
              ],
              "type": "string"
            },
            "source": {
              "properties": {
                "signal": {
                  "description": "The extraction signal that produced this value.",
                  "enum": [
                    "bimi",
                    "json_ld",
                    "manifest",
                    "apple_touch_icon",
                    "link_icon",
                    "header_dom",
                    "meta_og",
                    "meta_theme_color",
                    "css_var",
                    "render_computed",
                    "llm_classified",
                    "manual_correction",
                    "page_title",
                    "registrable_domain",
                    "logo_derived",
                    "meta_description"
                  ],
                  "type": "string"
                },
                "url": {
                  "description": "The page or record this value was observed on.",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "value": {
              "type": "string"
            }
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    }
  }
}