@classmethod
def authenticate_via_browser(
    cls,
    login_email: str,
    login_password: str,
    headless: bool = False,
    save_credentials_path: Optional[str] = None,
    server_idx: Optional[int] = None,
    server_url: Optional[str] = None,
    url_params: Optional[Dict[str, str]] = None,
    client: Optional[HttpClient] = None,
    async_client: Optional[AsyncHttpClient] = None,
    retry_config: OptionalNullable[RetryConfig] = UNSET,
    timeout_ms: Optional[int] = None,
    debug_logger: Optional[Logger] = None,
) -> "GriddyNFL":
    """Create a GriddyNFL instance by authenticating via browser.

    Uses Playwright to log into NFL.com and capture auth tokens.

    Args:
        login_email: Email address for NFL.com account.
        login_password: Password for NFL.com account.
        headless: If True, run browser in headless mode. Defaults to False.
        save_credentials_path: If provided, save credentials to this file path.
        server_idx: Index of the server to use from the server list.
        server_url: Override the default server URL.
        url_params: Parameters to template into the server URL.
        client: Custom synchronous HTTP client (must implement HttpClient).
        async_client: Custom async HTTP client (must implement AsyncHttpClient).
        retry_config: Configuration for automatic request retries.
        timeout_ms: Request timeout in milliseconds.
        debug_logger: Custom logger for debug output.

    Returns:
        A fully-initialized GriddyNFL instance.

    Example:
        >>> nfl = GriddyNFL.authenticate_via_browser(
        ...     login_email="[email protected]",
        ...     login_password="password",
        ...     headless=True,
        ...     save_credentials_path="creds.json",
        ... )
    """
    from .utils.security import do_browser_auth

    if debug_logger is None:
        debug_logger = get_default_logger()

    nfl_auth = do_browser_auth(
        email=login_email,
        password=login_password,
        headless=headless,
        logger=debug_logger,
    )

    if save_credentials_path is not None:
        with open(save_credentials_path, "w") as outfile:
            json.dump(nfl_auth, outfile, indent=4)

    return cls(
        nfl_auth=nfl_auth,
        server_idx=server_idx,
        server_url=server_url,
        url_params=url_params,
        client=client,
        async_client=async_client,
        retry_config=retry_config,
        timeout_ms=timeout_ms,
        debug_logger=debug_logger,
    )