use crate::engine::Engine;
use crate::error::ApiError;
use crate::types::ScrapeOptions;
pub fn check_url(raw: &str) -> Result<(), ApiError> {
match url::Url::parse(raw) {
Ok(u) if matches!(u.scheme(), "http" | "https") && u.host().is_some() => Ok(()),
Ok(_) => Err(ApiError::invalid(format!(
"only http(s) URLs are supported: {raw}"
))),
Err(e) => Err(ApiError::invalid(format!("invalid URL {raw:?}: {e}"))),
}
}
pub fn check_scrape_options(opts: &ScrapeOptions, engine: &dyn Engine) -> Result<(), ApiError> {
if opts.discover_scripts
&& (opts.engine.as_deref() != Some("http")
|| !opts.wants("links")
|| opts.egress.is_some()
|| !opts.headers.is_empty()
|| opts.if_none_match.is_some()
|| opts.if_modified_since.is_some())
{
return Err(ApiError::unsupported(
"discoverScripts requires HTTP engine, links, and no custom headers/egress/conditional request",
));
}
if let Some(p) = opts.proxy.as_deref() {
if !matches!(p, "basic" | "auto") {
let valid_url = url::Url::parse(p)
.ok()
.is_some_and(|u| matches!(u.scheme(), "http" | "https" | "socks5" | "socks5h"));
if !valid_url {
return Err(ApiError::unsupported(format!(
"proxy {p:?} is not supported: use \"basic\", \"auto\", or a valid http/https/socks5 URL"
)));
}
}
}
if let Some(e) = opts.engine.as_deref()
&& !matches!(e, "http" | "browser" | "auto")
{
return Err(ApiError::invalid(format!(
"engine must be http, browser or auto, got {e:?}"
)));
}
if let Some(c) = &opts.chunking {
const KINDS: [&str; 8] = [
"recursive",
"headings",
"paragraphs",
"sentences",
"fixed_tokens",
"sliding_window",
"overlapping",
"regex",
];
let kind = c.get("type").and_then(|t| t.as_str());
if !kind.is_some_and(|k| KINDS.contains(&k)) {
return Err(ApiError::invalid(format!(
"chunking.type must be one of {}",
KINDS.join(", ")
)));
}
}
let supported = engine.supported_formats();
if let Some(f) = opts
.formats
.iter()
.find(|f| !supported.contains(&f.kind.as_str()))
{
return Err(ApiError::unsupported(format!(
"format {:?} is not supported by this build (supported: {})",
f.kind,
supported.join(", ")
)));
}
if !opts.actions.is_empty() && !engine.supports_actions() {
return Err(ApiError::unsupported(
"actions need browser rendering, which is not available in this build",
));
}
if let Some(t) = opts.timeout {
if t < 1000 {
return Err(ApiError::invalid("timeout must be at least 1000 ms"));
}
if opts.wait_for > t / 2 {
return Err(ApiError::invalid("waitFor must not exceed half of timeout"));
}
}
if opts.wait_for > 60_000 {
return Err(ApiError::invalid("waitFor must not exceed 60000 ms"));
}
Ok(())
}