1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
//! Named browser fingerprint profiles.
//!
//! [`crate::guise::apply_stealth`] hardens the *generic* signals
//! that betray a headless browser - `navigator.webdriver`, empty
//! plugins, missing `window.chrome`, etc. But once those obvious
//! tells are gone, the next layer of WAF fingerprinting reads
//! *coherent* values: the `User-Agent` header, `navigator.platform`,
//! `navigator.userAgentData.brands`, screen size, hardware
//! concurrency, GPU vendor/renderer, accept-language. A "Chrome on
//! Windows" UA paired with a `MacIntel` platform and a "Mesa Intel
//! Iris" GPU is *more* suspicious than vanilla headless, because
//! real browsers don't produce that combination.
//!
//! [`StealthProfile`] bundles a coherent set of those values per
//! (browser, OS, GPU class) tuple. Apply it with
//! [`super::browser::apply_stealth_profile`] (requires the `browser`
//! feature) in addition to generic CDP stealth passes.
//!
//! Only browsers/OSes that ship enough public fingerprint detail
//! to construct a coherent set are listed. Adding a new variant
//! here is cheap (one literal) but **NEVER** copy a UA string from
//! one variant into another - the WAF cross-checks UA against
//! `userAgentData.brands` and `platform`.
//!
//! This module is the canonical root: it owns the [`StealthProfile`]
//! and [`ProfileFacts`] catalogue re-exports, and splits its accessors
//! by responsibility into sibling modules - [`facts`] (identity facts
//! and header accessors), [`hints`] (User-Agent Client Hint
//! materialisation), and [`overrides`] (materialised overrides and the
//! CDP override JavaScript). Everything is re-exported here so existing
//! paths (`fingerprint::profiles::profile_facts`, etc.) keep resolving.
//!
//! # Example
//!
//! ```
//! use guise::fingerprint::{StealthProfile, profile_to_overrides};
//!
//! let p = StealthProfile::ChromeWindowsStable;
//! let ov = profile_to_overrides(&p);
//! assert!(ov.user_agent.contains("Windows NT"));
//! assert_eq!(ov.platform, "Win32");
//! assert!(ov.languages.contains(&"en-US".to_string()));
//! ```
use guise_profiles as profile_catalog;
pub use ;
pub use *;
pub use *;
pub use ;
pub use *;
// `json_array` is a private serde helper that lives with the Client Hint
// types but is also used by `overrides::profile_js`. Re-export it within
// the crate so the sibling module sees it through the parent.
pub use json_array;