ev_lib 0.3.5

EV-invest shared Rust libraries, one per feature
Documentation 
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

//! Browser cookie bucketing (wasm only): read/write the sticky `ab_<key>` cookie
//! and assign a variant via `js_sys::Math::random`. Mirrors the TS
//! `cycle-variant`/`get-variant` cookie handling. The whole module is
//! `target_arch = "wasm32"`-gated by [`super`]; the pure assignment logic lives in
//! [`config`](crate::experiments::config) and is tested there.

use wasm_bindgen::JsCast;

use crate::experiments::config::{Experiment, cookie_name, pick_variant, resolve_variant};

/// Sticky cookie lifetime: 30 days, matching the TS proxy's `max-age`.
const COOKIE_MAX_AGE_SECS: u32 = 60 * 60 * 24 * 30;

/// Reads a cookie value by name from `document.cookie`, or `None` when absent.
pub fn read_cookie(name: &str) -> Option<String> {
	let cookie = html_document()?.cookie().ok()?;
	cookie.split(';').find_map(|pair| {
		let (key, value) = pair.trim().split_once('=')?;
		(key == name).then(|| value.to_string())
	})
}
/// Writes the sticky `ab_<key>` cookie (`path=/`, 30-day `max-age`, `samesite=lax`).
pub fn write_variant(key: &str, value: &str) {
	if let Some(doc) = html_document() {
		let cookie = format!("{}={value}; path=/; max-age={COOKIE_MAX_AGE_SECS}; samesite=lax", cookie_name(key));
		let _ = doc.set_cookie(&cookie);
	}
}
/// Resolves the current variant from the `ab_<key>` cookie, falling back to the
/// control. Does not assign — use [`assign_variant`] for first-visit bucketing.
pub fn current_variant(exp: &Experiment, key: &str) -> String {
	resolve_variant(exp, read_cookie(&cookie_name(key)).as_deref())
}
/// Returns the sticky variant for `key`, assigning (weighted random) and writing
/// the cookie on first visit. Mirrors the TS proxy's per-device bucketing.
pub fn assign_variant(exp: &Experiment, key: &str) -> String {
	if let Some(existing) = read_cookie(&cookie_name(key))
		&& exp.variants.iter().any(|v| *v == existing)
	{
		return existing;
	}
	let variant = pick_variant(exp, js_sys::Math::random);
	write_variant(key, &variant);
	variant
}
fn html_document() -> Option<web_sys::HtmlDocument> {
	web_sys::window()?.document()?.dyn_into::<web_sys::HtmlDocument>().ok()
}