hyperbrowser 0.90.4__tar.gz → 0.90.5__tar.gz

{hyperbrowser-0.90.4 → hyperbrowser-0.90.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperbrowser
-Version: 0.90.4
+Version: 0.90.5
 Summary: Python SDK for hyperbrowser
 License: MIT
 License-File: LICENSE

{hyperbrowser-0.90.4 → hyperbrowser-0.90.5}/hyperbrowser/models/__init__.py

@@ -33,8 +33,32 @@ from .web.common import (
     FetchOutputHtml,
     FetchOutputLinks,
     FetchOutputScreenshot,
+    FetchOutputBranding,
     FetchOutputFormat,
 )
+from .web.branding import (
+    BrandingProfile,
+    BrandingColors,
+    BrandingFont,
+    BrandingFontRole,
+    BrandingTypography,
+    BrandingFontFamilies,
+    BrandingFontStacks,
+    BrandingFontSizes,
+    BrandingSpacing,
+    BrandingComponents,
+    BrandingButtonStyle,
+    BrandingInputStyle,
+    BrandingBorderRadiusCorners,
+    BrandingImages,
+    BrandingPersonality,
+    BrandingPersonalityTone,
+    BrandingPersonalityEnergy,
+    BrandingDesignSystem,
+    BrandingDesignFramework,
+    BrandingConfidence,
+    BrandingColorScheme,
+)
 from .web.search import (
     WebSearchFilters,
     WebSearchFiletype,
@@ -624,7 +648,30 @@ __all__ = [
     "FetchOutputHtml",
     "FetchOutputLinks",
     "FetchOutputScreenshot",
+    "FetchOutputBranding",
     "FetchOutputFormat",
+    # web branding response shape
+    "BrandingProfile",
+    "BrandingColors",
+    "BrandingFont",
+    "BrandingFontRole",
+    "BrandingTypography",
+    "BrandingFontFamilies",
+    "BrandingFontStacks",
+    "BrandingFontSizes",
+    "BrandingSpacing",
+    "BrandingComponents",
+    "BrandingButtonStyle",
+    "BrandingInputStyle",
+    "BrandingBorderRadiusCorners",
+    "BrandingImages",
+    "BrandingPersonality",
+    "BrandingPersonalityTone",
+    "BrandingPersonalityEnergy",
+    "BrandingDesignSystem",
+    "BrandingDesignFramework",
+    "BrandingConfidence",
+    "BrandingColorScheme",
     "FetchStorageStateOptions",
     "FetchOutputJsonOptions",
     "FetchOutputScreenshotOptions",

hyperbrowser-0.90.5/hyperbrowser/models/web/branding.py

@@ -0,0 +1,270 @@
+from __future__ import annotations
+from typing import Literal, Optional, List, Union
+from pydantic import BaseModel, ConfigDict, Field
+
+
+BrandingColorScheme = Union[Literal["light", "dark"], str]
+
+BrandingPersonalityTone = Union[
+    Literal[
+        "professional",
+        "playful",
+        "modern",
+        "traditional",
+        "minimalist",
+        "bold",
+    ],
+    str,
+]
+
+BrandingPersonalityEnergy = Union[Literal["low", "medium", "high"], str]
+
+BrandingFontRole = Union[
+    Literal["heading", "body", "monospace", "display", "unknown"],
+    str,
+]
+
+BrandingDesignFramework = Union[
+    Literal[
+        "tailwind",
+        "bootstrap",
+        "material",
+        "chakra",
+        "custom",
+        "unknown",
+    ],
+    str,
+]
+
+
+class BrandingColors(BaseModel):
+    model_config = ConfigDict(populate_by_alias=True, extra="allow")
+
+    primary: Optional[str] = None
+    secondary: Optional[str] = None
+    accent: Optional[str] = None
+    background: Optional[str] = None
+    text_primary: Optional[str] = Field(
+        default=None, alias="textPrimary", serialization_alias="textPrimary"
+    )
+    text_secondary: Optional[str] = Field(
+        default=None, alias="textSecondary", serialization_alias="textSecondary"
+    )
+    link: Optional[str] = None
+    success: Optional[str] = None
+    warning: Optional[str] = None
+    error: Optional[str] = None
+
+
+class BrandingFont(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    family: Optional[str] = None
+    role: Optional[BrandingFontRole] = None
+
+
+class BrandingBorderRadiusCorners(BaseModel):
+    model_config = ConfigDict(populate_by_alias=True, extra="allow")
+
+    top_left: Optional[str] = Field(
+        default=None, alias="topLeft", serialization_alias="topLeft"
+    )
+    top_right: Optional[str] = Field(
+        default=None, alias="topRight", serialization_alias="topRight"
+    )
+    bottom_right: Optional[str] = Field(
+        default=None, alias="bottomRight", serialization_alias="bottomRight"
+    )
+    bottom_left: Optional[str] = Field(
+        default=None, alias="bottomLeft", serialization_alias="bottomLeft"
+    )
+
+
+class BrandingButtonStyle(BaseModel):
+    model_config = ConfigDict(populate_by_alias=True, extra="allow")
+
+    background: Optional[str] = None
+    text_color: Optional[str] = Field(
+        default=None, alias="textColor", serialization_alias="textColor"
+    )
+    border_color: Optional[str] = Field(
+        default=None, alias="borderColor", serialization_alias="borderColor"
+    )
+    border_radius: Optional[str] = Field(
+        default=None, alias="borderRadius", serialization_alias="borderRadius"
+    )
+    border_radius_corners: Optional[BrandingBorderRadiusCorners] = Field(
+        default=None,
+        alias="borderRadiusCorners",
+        serialization_alias="borderRadiusCorners",
+    )
+    shadow: Optional[str] = None
+
+
+class BrandingInputStyle(BaseModel):
+    model_config = ConfigDict(populate_by_alias=True, extra="allow")
+
+    background: Optional[str] = None
+    text_color: Optional[str] = Field(
+        default=None, alias="textColor", serialization_alias="textColor"
+    )
+    border_color: Optional[str] = Field(
+        default=None, alias="borderColor", serialization_alias="borderColor"
+    )
+    focus_border_color: Optional[str] = Field(
+        default=None,
+        alias="focusBorderColor",
+        serialization_alias="focusBorderColor",
+    )
+    border_radius: Optional[str] = Field(
+        default=None, alias="borderRadius", serialization_alias="borderRadius"
+    )
+    border_radius_corners: Optional[BrandingBorderRadiusCorners] = Field(
+        default=None,
+        alias="borderRadiusCorners",
+        serialization_alias="borderRadiusCorners",
+    )
+    shadow: Optional[str] = None
+
+
+class BrandingComponents(BaseModel):
+    model_config = ConfigDict(populate_by_alias=True, extra="allow")
+
+    button_primary: Optional[BrandingButtonStyle] = Field(
+        default=None, alias="buttonPrimary", serialization_alias="buttonPrimary"
+    )
+    button_secondary: Optional[BrandingButtonStyle] = Field(
+        default=None,
+        alias="buttonSecondary",
+        serialization_alias="buttonSecondary",
+    )
+    input: Optional[BrandingInputStyle] = None
+
+
+class BrandingFontFamilies(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    primary: Optional[str] = None
+    heading: Optional[str] = None
+    code: Optional[str] = None
+
+
+class BrandingFontStacks(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    primary: Optional[List[Optional[str]]] = None
+    heading: Optional[List[Optional[str]]] = None
+    body: Optional[List[Optional[str]]] = None
+    paragraph: Optional[List[Optional[str]]] = None
+
+
+class BrandingFontSizes(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    h1: Optional[str] = None
+    h2: Optional[str] = None
+    h3: Optional[str] = None
+    body: Optional[str] = None
+    small: Optional[str] = None
+
+
+class BrandingTypography(BaseModel):
+    model_config = ConfigDict(populate_by_alias=True, extra="allow")
+
+    font_families: Optional[BrandingFontFamilies] = Field(
+        default=None, alias="fontFamilies", serialization_alias="fontFamilies"
+    )
+    font_stacks: Optional[BrandingFontStacks] = Field(
+        default=None, alias="fontStacks", serialization_alias="fontStacks"
+    )
+    font_sizes: Optional[BrandingFontSizes] = Field(
+        default=None, alias="fontSizes", serialization_alias="fontSizes"
+    )
+    line_heights: Optional[dict[str, Optional[float]]] = Field(
+        default=None, alias="lineHeights", serialization_alias="lineHeights"
+    )
+    font_weights: Optional[dict[str, Optional[float]]] = Field(
+        default=None, alias="fontWeights", serialization_alias="fontWeights"
+    )
+
+
+class BrandingSpacing(BaseModel):
+    model_config = ConfigDict(populate_by_alias=True, extra="allow")
+
+    base_unit: Optional[float] = Field(
+        default=None, alias="baseUnit", serialization_alias="baseUnit"
+    )
+    border_radius: Optional[str] = Field(
+        default=None, alias="borderRadius", serialization_alias="borderRadius"
+    )
+    padding: Optional[dict[str, Optional[float]]] = None
+    margins: Optional[dict[str, Optional[float]]] = None
+    grid_gutter: Optional[float] = Field(
+        default=None, alias="gridGutter", serialization_alias="gridGutter"
+    )
+
+
+class BrandingImages(BaseModel):
+    model_config = ConfigDict(populate_by_alias=True, extra="allow")
+
+    logo: Optional[str] = None
+    logo_href: Optional[str] = Field(
+        default=None, alias="logoHref", serialization_alias="logoHref"
+    )
+    logo_alt: Optional[str] = Field(
+        default=None, alias="logoAlt", serialization_alias="logoAlt"
+    )
+    favicon: Optional[str] = None
+    og_image: Optional[str] = Field(
+        default=None, alias="ogImage", serialization_alias="ogImage"
+    )
+
+
+class BrandingPersonality(BaseModel):
+    model_config = ConfigDict(populate_by_alias=True, extra="allow")
+
+    tone: Optional[BrandingPersonalityTone] = None
+    energy: Optional[BrandingPersonalityEnergy] = None
+    target_audience: Optional[str] = Field(
+        default=None,
+        alias="targetAudience",
+        serialization_alias="targetAudience",
+    )
+
+
+class BrandingDesignSystem(BaseModel):
+    model_config = ConfigDict(populate_by_alias=True, extra="allow")
+
+    framework: Optional[BrandingDesignFramework] = None
+    component_library: Optional[str] = Field(
+        default=None,
+        alias="componentLibrary",
+        serialization_alias="componentLibrary",
+    )
+
+
+class BrandingConfidence(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    buttons: Optional[float] = None
+    colors: Optional[float] = None
+    overall: Optional[float] = None
+
+
+class BrandingProfile(BaseModel):
+    model_config = ConfigDict(populate_by_alias=True, extra="allow")
+
+    color_scheme: Optional[BrandingColorScheme] = Field(
+        default=None, alias="colorScheme", serialization_alias="colorScheme"
+    )
+    colors: Optional[BrandingColors] = None
+    fonts: Optional[List[BrandingFont]] = None
+    typography: Optional[BrandingTypography] = None
+    spacing: Optional[BrandingSpacing] = None
+    components: Optional[BrandingComponents] = None
+    images: Optional[BrandingImages] = None
+    personality: Optional[BrandingPersonality] = None
+    design_system: Optional[BrandingDesignSystem] = Field(
+        default=None, alias="designSystem", serialization_alias="designSystem"
+    )
+    confidence: Optional[BrandingConfidence] = None

{hyperbrowser-0.90.4 → hyperbrowser-0.90.5}/hyperbrowser/models/web/common.py

@@ -10,6 +10,7 @@ from hyperbrowser.models.consts import (
     FetchSanitizeMode,
 )
 from hyperbrowser.models.session import ScreenConfig
+from hyperbrowser.models.web.branding import BrandingProfile
 
 
 class FetchOutputScreenshotOptions(BaseModel):
@@ -79,6 +80,7 @@ class PageData(BaseModel):
     json_: Optional[dict[str, Any]] = Field(
         default=None, alias="json", serialization_alias="json"
     )
+    branding: Optional[BrandingProfile] = None
 
 
 class FetchOutputMarkdown(BaseModel):
@@ -112,13 +114,18 @@ class FetchOutputJson(FetchOutputJsonOptions):
     type: Literal["json"]
 
 
+class FetchOutputBranding(BaseModel):
+    type: Literal["branding"]
+
+
 FetchOutputFormat = Union[
     FetchOutputMarkdown,
     FetchOutputHtml,
     FetchOutputLinks,
     FetchOutputScreenshot,
     FetchOutputJson,
-    Literal["markdown", "html", "links", "screenshot"],
+    FetchOutputBranding,
+    Literal["markdown", "html", "links", "screenshot", "branding"],
 ]
 
 

{hyperbrowser-0.90.4 → hyperbrowser-0.90.5}/hyperbrowser/models/web/fetch.py

@@ -7,6 +7,7 @@ from .common import (
     FetchNavigationOptions,
     FetchCacheOptions,
 )
+from .branding import BrandingProfile
 from hyperbrowser.models.consts import FetchStatus, FetchStealthMode
 
 
@@ -46,6 +47,7 @@ class FetchResponseData(BaseModel):
     json_: Optional[dict] = Field(
         default=None, alias="json", serialization_alias="json"
     )
+    branding: Optional[BrandingProfile] = None
 
 
 class FetchResponse(BaseModel):

{hyperbrowser-0.90.4 → hyperbrowser-0.90.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "hyperbrowser"
-version = "0.90.4"
+version = "0.90.5"
 description = "Python SDK for hyperbrowser"
 authors = ["Nikhil Shahi <nshahi1998@gmail.com>"]
 license = "MIT"