react-marketing-tools 1.0.0-alpha.5 → 1.0.0

package/dist/chunks/core.js

@@ -1,45 +1,6 @@
-//#region lib/core/validate.ts
-var e = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, t = [
-	"google_",
-	"ga_",
-	"firebase_"
-], n = 25, r = 100, i = {
-	page_location: 1e3,
-	page_referrer: 420,
-	page_title: 300
-}, a = [
-	"email",
-	"phone",
-	"first_name",
-	"last_name",
-	"address",
-	"password"
-], o = String.raw`[\w.+-]+(?:@|%40)[\w-]+(?:\.[\w-]+)+`, s = "[redacted]", c = (n) => {
-	if (!e.test(n)) return "must start with a letter, contain only letters, digits and underscores, and be at most 40 characters";
-	let r = t.find((e) => n.toLowerCase().startsWith(e));
-	return r && `must not start with the reserved prefix "${r}"`;
-}, ee = (e) => {
-	let t = c(e);
-	return t && `event name "${e}" ${t}`;
-}, l = (e) => {
-	let t = Object.keys(e), a = t.flatMap((t) => {
-		let n = c(t);
-		if (n) return [`param "${t}" ${n}`];
-		let a = e[t], o = i[t] ?? r;
-		return typeof a == "string" && a.length > o ? [`param "${t}" is longer than ${o} characters`] : [];
-	});
-	return t.length > n ? [`has ${t.length} params; the limit is ${n}`, ...a] : a;
-}, u = (e) => new RegExp(o, "i").test(e), d = (e, t) => (typeof t == "string" || typeof t == "number") && a.some((t) => e.toLowerCase().includes(t)) ? s : typeof t == "string" ? t.replace(new RegExp(o, "gi"), s) : t, f = (e) => {
-	let t = Object.entries(e).map(([e, t]) => [
-		e,
-		t,
-		d(e, t)
-	]);
-	return {
-		params: Object.fromEntries(t.map(([e, , t]) => [e, t])),
-		redactedKeys: t.filter(([, e, t]) => t !== e).map(([e]) => e)
-	};
-}, p = [
+import { a as e, i as t, n, r, t as i } from "./cookies.js";
+//#region lib/attribution/attribution.ts
+var a = [
 	"utm_source",
 	"utm_medium",
 	"utm_campaign",
@@ -58,67 +19,91 @@ var e = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, t = [
 	"ttclid",
 	"li_fat_id",
 	"twclid"
-], m = 100, h = (e) => {
+], o = 100, s = (e) => {
 	if (!URL.canParse(e)) return;
 	let { origin: t, pathname: n } = new URL(e);
 	return t + n;
-}, g = ({ url: e, referrer: t, capturedAt: n }) => {
-	if (!URL.canParse(e)) return;
-	let { searchParams: r } = new URL(e), i = p.flatMap((e) => {
-		let t = r.get(e)?.trim();
+}, c = ({ referrer: e, aiSources: t }) => {
+	if (!e || !t || !URL.canParse(e)) return;
+	let n = new URL(e).hostname.toLowerCase();
+	return Object.entries(t).find(([, e]) => e.some((e) => {
+		let t = e.toLowerCase();
+		return n === t || n.endsWith(`.${t}`);
+	}))?.[0];
+}, l = ({ url: t, referrer: n, capturedAt: r, aiSources: i }) => {
+	if (!URL.canParse(t)) return;
+	let { searchParams: l } = new URL(t), u = a.flatMap((e) => {
+		let t = l.get(e)?.trim();
 		return t ? [[e, t]] : [];
+	}), d = c({
+		referrer: n,
+		aiSources: i
 	});
-	if (i.length === 0) return;
-	let { params: a } = f(Object.fromEntries(i)), o = Object.fromEntries(Object.entries(a).map(([e, t]) => [e, String(t).slice(0, m)])), s = t ? h(t) : void 0;
+	if (u.length === 0 && !d) return;
+	let { params: f } = e(Object.fromEntries(u)), p = Object.fromEntries(Object.entries(f).map(([e, t]) => [e, String(t).slice(0, o)])), m = n ? s(n) : void 0;
 	return {
-		...o,
-		landing_page: h(e) ?? e,
-		...s ? { referrer: s } : {},
-		captured_at: n
+		...p,
+		landing_page: s(t) ?? t,
+		...m ? { referrer: m } : {},
+		...d ? { ai_source: d } : {},
+		captured_at: r
 	};
-}, _ = (e) => typeof e == "object" && !!e, v = (e) => {
-	if (_(e) && typeof e.captured_at == "number" && typeof e.landing_page == "string") return {
-		...Object.fromEntries(p.flatMap((t) => typeof e[t] == "string" ? [[t, e[t]]] : [])),
+}, u = (e) => typeof e == "object" && !!e, d = (e) => {
+	if (u(e) && typeof e.captured_at == "number" && typeof e.landing_page == "string") return {
+		...Object.fromEntries(a.flatMap((t) => typeof e[t] == "string" ? [[t, e[t]]] : [])),
 		landing_page: e.landing_page,
 		...typeof e.referrer == "string" ? { referrer: e.referrer } : {},
+		...typeof e.ai_source == "string" ? { ai_source: e.ai_source } : {},
 		captured_at: e.captured_at
 	};
-}, te = ({ fbcCookie: e, touch: t }) => e ?? (t?.fbclid ? `fb.1.${t.captured_at}.${t.fbclid}` : void 0), y = "rmt:attribution:first", b = "rmt:attribution:last", x = 864e5, S = (e, t) => {
+}, f = ({ fbcCookie: e, touch: t }) => e ?? (t?.fbclid ? `fb.1.${t.captured_at}.${t.fbclid}` : void 0), p = "rmt:attribution:first", m = "rmt:attribution:last", h = 864e5, g = (e, t) => {
 	try {
 		return t(window[e]);
 	} catch {
 		return;
 	}
-}, C = (e, t) => S(e, (e) => {
+}, _ = (e, t) => g(e, (e) => {
 	let n = e.getItem(t);
-	return n === null ? void 0 : v(JSON.parse(n));
-}), ne = ({ ttlDays: e }) => {
-	let t, n, r = (t) => Date.now() - t.captured_at < e * x;
+	return n === null ? void 0 : d(JSON.parse(n));
+}), ee = ({ ttlDays: e }) => {
+	let t, n, r = (t) => Date.now() - t.captured_at < e * h;
 	return {
 		observe(e) {
 			e && (t ??= e, n = e);
 		},
 		restore() {
-			let e = C("localStorage", y);
-			e && r(e) && (!t || e.captured_at <= t.captured_at) && (t = e), n ??= C("sessionStorage", b);
+			let e = _("localStorage", p);
+			e && r(e) && (!t || e.captured_at <= t.captured_at) && (t = e), n ??= _("sessionStorage", m);
 		},
 		persist() {
-			S("localStorage", (e) => t && r(t) ? e.setItem(y, JSON.stringify(t)) : e.removeItem(y)), n && S("sessionStorage", (e) => e.setItem(b, JSON.stringify(n)));
+			g("localStorage", (e) => t && r(t) ? e.setItem(p, JSON.stringify(t)) : e.removeItem(p)), n && g("sessionStorage", (e) => e.setItem(m, JSON.stringify(n)));
 		},
 		erase() {
-			S("localStorage", (e) => e.removeItem(y)), S("sessionStorage", (e) => e.removeItem(b));
+			g("localStorage", (e) => e.removeItem(p)), g("sessionStorage", (e) => e.removeItem(m));
 		},
 		get: () => ({
 			firstTouch: t,
 			lastTouch: n
 		})
 	};
-}, w = [
+}, v = "data-analytics-event", y = "data-analytics-param-", b = (e) => {
+	if (!(e instanceof Element)) return;
+	let t = e.closest(`[${v}]`), n = t?.getAttribute(v);
+	if (t && n) return {
+		name: n,
+		params: Object.fromEntries(Array.from(t.attributes).filter((e) => e.name.startsWith(y)).map((e) => [e.name.slice(21).replaceAll("-", "_"), e.value]))
+	};
+}, te = (e) => {
+	document.addEventListener("click", (t) => {
+		let n = b(t.target);
+		n && e(n.name, n.params);
+	}, { capture: !0 });
+}, ne = [
 	"analytics",
 	"ads",
 	"adUserData",
 	"adPersonalization"
-], T = (e) => e === "granted" || e === "denied", E = ({ consent: e, gpc: t }) => {
+], x = (e) => e === "granted" || e === "denied", S = ({ consent: e, gpc: t }) => {
 	let n = t ? "denied" : e;
 	return {
 		analytics: e,
@@ -126,35 +111,35 @@ var e = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, t = [
 		adUserData: n,
 		adPersonalization: n
 	};
-}, D = (e, t) => ({
+}, re = (e, t) => ({
 	analytics: t.analytics ?? e.analytics,
 	ads: t.ads ?? e.ads,
 	adUserData: t.adUserData ?? t.ads ?? e.adUserData,
 	adPersonalization: t.adPersonalization ?? t.ads ?? e.adPersonalization
-}), O = (e) => ({
+}), C = (e) => ({
 	analytics_storage: e.analytics,
 	ad_storage: e.ads,
 	ad_user_data: e.adUserData,
 	ad_personalization: e.adPersonalization
-}), k = (e) => Object.values(e).includes("denied"), re = () => typeof navigator < "u" && navigator.globalPrivacyControl === !0, A = () => window.dataLayer ??= [], ie = () => Array.from(document.scripts).some((e) => URL.canParse(e.src) && new URL(e.src).pathname.endsWith("/gtag/js")), j = () => window.gtag ??= function() {
-	A().push(arguments);
-}, M = ({ consent: e, waitForUpdate: t }) => {
-	j()("consent", "default", {
-		...O(e),
-		...k(e) ? { wait_for_update: t } : {}
+}), w = (e) => Object.values(e).includes("denied"), ie = () => typeof navigator < "u" && navigator.globalPrivacyControl === !0, T = () => window.dataLayer ??= [], E = () => Array.from(document.scripts).some((e) => URL.canParse(e.src) && new URL(e.src).pathname.endsWith("/gtag/js")), D = () => window.gtag ??= function() {
+	T().push(arguments);
+}, O = ({ consent: e, waitForUpdate: t }) => {
+	D()("consent", "default", {
+		...C(e),
+		...w(e) ? { wait_for_update: t } : {}
 	});
-}, N = (e) => {
-	j()("consent", "update", O(e));
-}, P = (e, t) => {
+}, k = (e) => {
+	D()("consent", "update", C(e));
+}, A = (e, t) => {
 	let n = URL.canParse(e) ? new URL(e) : void 0;
 	if (n?.protocol !== "https:") throw Error(`[react-marketing-tools] ${t} must be an https:// URL (received ${JSON.stringify(e)}).`);
 	return n;
-}, F = (e) => Array.from(document.scripts).some((t) => t.src === e), I = ({ src: e, nonce: t }) => {
+}, j = (e) => Array.from(document.scripts).some((t) => t.src === e), M = ({ src: e, nonce: t }) => {
 	let n = document.createElement("script");
 	n.async = !0, n.src = e, t && n.setAttribute("nonce", t), document.head.append(n);
-}, L = /^G-[A-Z0-9]+$/, R = ({ measurementId: e, pageViews: t = "auto", loadScript: n = !0, serverContainerUrl: r, waitForUpdate: i = 500, nonce: a }) => {
-	if (!L.test(e)) throw Error(`[react-marketing-tools] ga4.measurementId must look like "G-XXXXXXX" (received ${JSON.stringify(e)}).`);
-	r !== void 0 && P(r, "ga4.serverContainerUrl");
+}, ae = /^G-[A-Z0-9]+$/, oe = ({ measurementId: e, pageViews: t = "auto", loadScript: n = !0, serverContainerUrl: r, waitForUpdate: i = 500, nonce: a }) => {
+	if (!ae.test(e)) throw Error(`[react-marketing-tools] ga4.measurementId must look like "G-XXXXXXX" (received ${JSON.stringify(e)}).`);
+	r !== void 0 && A(r, "ga4.serverContainerUrl");
 	let o = `https://www.googletagmanager.com/gtag/js?id=${e}`, s = (e, t) => r ? {
 		...e,
 		event_id: t
@@ -162,55 +147,55 @@ var e = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, t = [
 	return {
 		name: "ga4",
 		start({ consent: s }) {
-			M({
+			O({
 				consent: s,
 				waitForUpdate: i
-			}), ie() || (j()("js", /* @__PURE__ */ new Date()), n && I({
+			}), E() || (D()("js", /* @__PURE__ */ new Date()), n && M({
 				src: o,
 				nonce: a
-			})), j()("config", e, {
+			})), D()("config", e, {
 				...t === "manual" ? { send_page_view: !1 } : {},
 				...r ? { server_container_url: r } : {}
 			});
 		},
 		track({ name: e, params: t, eventId: n }) {
-			j()("event", e, s(t, n));
+			D()("event", e, s(t, n));
 		},
 		consent(e) {
-			N(e);
+			k(e);
 		},
 		page({ params: e, eventId: n }) {
-			t === "manual" && j()("event", "page_view", s(e, n));
+			t === "manual" && D()("event", "page_view", s(e, n));
 		},
 		identify({ userId: e }) {
-			j()("set", { user_id: e });
+			D()("set", { user_id: e });
 		},
 		reset() {
-			j()("set", { user_id: null });
+			D()("set", { user_id: null });
 		}
 	};
-}, z = /^GTM-[A-Z0-9]+$/, B = (e, t) => {
-	let n = P(t ?? "https://www.googletagmanager.com/gtm.js", "gtm.scriptUrl");
+}, N = /^GTM-[A-Z0-9]+$/, P = (e, t) => {
+	let n = A(t ?? "https://www.googletagmanager.com/gtm.js", "gtm.scriptUrl");
 	return n.searchParams.set("id", e), n.href;
-}, V = ({ containerId: e, loadScript: t = !0, scriptUrl: n, waitForUpdate: r = 500, nonce: i }) => {
-	if (!z.test(e)) throw Error(`[react-marketing-tools] gtm.containerId must look like "GTM-XXXXXXX" (received ${JSON.stringify(e)}).`);
-	let a = B(e, n);
+}, F = ({ containerId: e, loadScript: t = !0, scriptUrl: n, waitForUpdate: r = 500, nonce: i }) => {
+	if (!N.test(e)) throw Error(`[react-marketing-tools] gtm.containerId must look like "GTM-XXXXXXX" (received ${JSON.stringify(e)}).`);
+	let a = P(e, n);
 	return {
 		name: "gtm",
 		start({ consent: e }) {
-			M({
+			O({
 				consent: e,
 				waitForUpdate: r
-			}), t && !F(a) && (A().push({
+			}), t && !j(a) && (T().push({
 				"gtm.start": Date.now(),
 				event: "gtm.js"
-			}), I({
+			}), M({
 				src: a,
 				nonce: i
 			}));
 		},
 		track({ name: e, params: t, eventId: n, attribution: r }) {
-			A().push({
+			T().push({
 				...t,
 				...r && { attribution: r },
 				event: e,
@@ -218,22 +203,22 @@ var e = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, t = [
 			});
 		},
 		consent(e) {
-			N(e);
+			k(e);
 		},
 		identify({ userId: e }) {
-			A().push({
+			T().push({
 				event: "identify",
 				user_id: e
 			});
 		},
 		reset() {
-			A().push({
+			T().push({
 				event: "reset",
 				user_id: void 0
 			});
 		}
 	};
-}, H = /* @__PURE__ */ new Set([
+}, I = /* @__PURE__ */ new Set([
 	"AddPaymentInfo",
 	"AddToCart",
 	"AddToWishlist",
@@ -252,7 +237,7 @@ var e = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, t = [
 	"SubmitApplication",
 	"Subscribe",
 	"ViewContent"
-]), U = {
+]), L = {
 	purchase: "Purchase",
 	sign_up: "CompleteRegistration",
 	generate_lead: "Lead",
@@ -262,8 +247,8 @@ var e = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, t = [
 	search: "Search",
 	add_payment_info: "AddPaymentInfo",
 	add_to_wishlist: "AddToWishlist"
-}, W = (e) => typeof e == "object" && !!e, G = (e) => {
-	let t = e.filter(W).filter((e) => e.item_id !== void 0).map((e) => ({
+}, R = (e) => typeof e == "object" && !!e, z = (e) => {
+	let t = e.filter(R).filter((e) => e.item_id !== void 0).map((e) => ({
 		id: String(e.item_id),
 		quantity: typeof e.quantity == "number" ? e.quantity : 1
 	}));
@@ -273,21 +258,21 @@ var e = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, t = [
 		num_items: t.reduce((e, t) => e + t.quantity, 0),
 		content_type: "product"
 	};
-}, K = ({ items: e, search_term: t, ...n }) => ({
+}, B = ({ items: e, search_term: t, ...n }) => ({
 	...n,
 	...typeof t == "string" ? { search_string: t } : {},
-	...Array.isArray(e) ? G(e) : {}
-}), q = ({ name: e, params: t, options: n }) => {
-	let r = n?.meta, i = r?.event ?? U[e] ?? e;
+	...Array.isArray(e) ? z(e) : {}
+}), V = ({ name: e, params: t, options: n }) => {
+	let r = n?.meta || void 0, i = r?.event ?? L[e] ?? e;
 	return {
-		command: H.has(i) ? "track" : "trackCustom",
+		command: I.has(i) ? "track" : "trackCustom",
 		name: i,
 		params: {
-			...K(t),
+			...B(t),
 			...r?.params
 		}
 	};
-}, J = /^\d+$/, ae = "https://connect.facebook.net/en_US/fbevents.js", Y = () => {
+}, H = /^\d+$/, U = "https://connect.facebook.net/en_US/fbevents.js", W = () => {
 	let e = window;
 	if (!e.fbq) {
 		let t = function() {
@@ -297,130 +282,288 @@ var e = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, t = [
 		t.push = t, t.loaded = !0, t.version = "2.0", t.queue = [], e.fbq = t, e._fbq ??= t;
 	}
 	return e.fbq;
-}, oe = () => Array.from(document.scripts).some((e) => URL.canParse(e.src) && new URL(e.src).pathname.endsWith("/fbevents.js")), se = ({ userId: e, traits: t }) => Object.fromEntries(Object.entries({
+}, G = () => Array.from(document.scripts).some((e) => URL.canParse(e.src) && new URL(e.src).pathname.endsWith("/fbevents.js")), K = ({ userId: e, traits: t }) => Object.fromEntries(Object.entries({
 	external_id: e,
 	em: t.email,
 	ph: t.phone,
 	fn: t.firstName,
 	ln: t.lastName
-}).filter(([, e]) => e !== void 0)), X = (e) => e.adUserData === "granted" ? "grant" : "revoke", ce = ({ pixelId: e, pageViews: t = "auto", loadScript: n = !0, nonce: r }) => {
-	if (!J.test(e)) throw Error(`[react-marketing-tools] metaPixel.pixelId must be the numeric pixel ID (received ${JSON.stringify(e)}).`);
+}).filter(([, e]) => e !== void 0)), q = (e) => e.adUserData === "granted" ? "grant" : "revoke", se = ({ pixelId: e, pageViews: t = "auto", loadScript: n = !0, nonce: r }) => {
+	if (!H.test(e)) throw Error(`[react-marketing-tools] metaPixel.pixelId must be the numeric pixel ID (received ${JSON.stringify(e)}).`);
 	return {
 		name: "metaPixel",
 		start({ consent: i, identity: a }) {
-			let o = Y();
-			t === "manual" && (o.disablePushState = !0), X(i) === "revoke" && o("consent", "revoke"), a ? o("init", e, se(a)) : o("init", e), t === "auto" && o("track", "PageView"), n && !oe() && I({
-				src: ae,
+			let o = W();
+			t === "manual" && (o.disablePushState = !0), q(i) === "revoke" && o("consent", "revoke"), a ? o("init", e, K(a)) : o("init", e), t === "auto" && o("track", "PageView"), n && !G() && M({
+				src: U,
 				nonce: r
 			});
 		},
 		track(e) {
-			let { command: t, name: n, params: r } = q(e);
-			Y()(t, n, r, { eventID: e.eventId });
+			if (e.options?.meta === !1) return;
+			let { command: t, name: n, params: r } = V(e);
+			W()(t, n, r, { eventID: e.eventId });
 		},
 		page({ eventId: e }) {
-			t === "manual" && Y()("track", "PageView", {}, { eventID: e });
+			t === "manual" && W()("track", "PageView", {}, { eventID: e });
 		},
 		consent(e) {
-			Y()("consent", X(e));
+			W()("consent", q(e));
 		}
 	};
-}, Z = class extends Error {
+}, J = class extends Error {
 	code;
 	constructor(e, t, n) {
 		super(`[react-marketing-tools] ${t}`, n), this.name = "AnalyticsError", this.code = e;
 	}
-}, Q = (e, t) => {
-	for (let n of e.split(";")) {
-		let e = n.indexOf("=");
-		if (e !== -1 && n.slice(0, e).trim() === t) return n.slice(e + 1).trim();
+}, ce = (e) => e.startsWith("/") && !e.startsWith("//") || URL.canParse(e) && new URL(e).protocol === "https:", le = ({ endpoint: e, relayPageViews: t, visitorId: n, onError: r }) => {
+	if (!ce(e)) throw Error(`[react-marketing-tools] server.endpoint must be a path on your site, such as '/api/track', or an https:// URL (received ${JSON.stringify(e)}).`);
+	let a = "denied", o, s = (e) => {
+		let t = i(document.cookie, "_fbp"), r = f({
+			fbcCookie: i(document.cookie, "_fbc"),
+			touch: e.attribution
+		}), a = o?.userId ?? n();
+		return {
+			...a && { externalId: a },
+			...o?.traits,
+			...r && { fbc: r },
+			...t && { fbp: t }
+		};
+	}, c = ({ event: t, eventName: n, customData: i }) => {
+		let o = {
+			v: 1,
+			eventName: n,
+			eventId: t.eventId,
+			customData: i,
+			eventSourceUrl: location.href,
+			consent: { adUserData: a },
+			userData: s(t)
+		}, c = JSON.stringify(o);
+		typeof navigator.sendBeacon == "function" && navigator.sendBeacon(e, c) || fetch(e, {
+			method: "POST",
+			body: c,
+			keepalive: !0,
+			mode: "no-cors"
+		}).catch((t) => {
+			r(new J("destination_failed", `destination "server" could not reach ${e}`, { cause: t }));
+		});
+	};
+	return {
+		name: "server",
+		start(e) {
+			a = e.consent.adUserData, o = e.identity;
+		},
+		track(e) {
+			if (a !== "granted" || e.options?.meta === !1) return;
+			let { name: t, params: n } = V(e);
+			c({
+				event: e,
+				eventName: t,
+				customData: n
+			});
+		},
+		page(e) {
+			a === "granted" && t && c({
+				event: e,
+				eventName: "PageView",
+				customData: {}
+			});
+		},
+		consent(e) {
+			a = e.adUserData;
+		},
+		identify(e) {
+			o = e;
+		},
+		reset() {
+			o = void 0;
+		}
+	};
+}, Y = () => typeof crypto.randomUUID == "function" ? crypto.randomUUID() : "10000000-1000-4000-8000-100000000000".replace(/[018]/g, (e) => (Number(e) ^ crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(1))[0] & 15 >> Number(e) / 4).toString(16)), X = "rmt:vid", ue = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/, de = () => {
+	try {
+		let e = localStorage.getItem(X);
+		return e !== null && ue.test(e) ? e : void 0;
+	} catch {
+		return;
+	}
+}, Z = (e) => {
+	try {
+		e ? localStorage.setItem(X, e) : localStorage.removeItem(X);
+	} catch {}
+}, fe = () => {
+	let e, t = (t) => {
+		if (t.analytics !== "granted") return;
+		let n = de();
+		return n ? e = n : (e ??= Y(), Z(e), e);
+	};
+	return {
+		peek: t,
+		get: (e) => Promise.resolve(t(e)),
+		erase() {
+			e = void 0, Z(void 0);
+		}
+	};
+}, pe = ({ fingerprint: e, onError: t }) => {
+	let n, r, i = (e) => e.analytics === "granted" && e.ads === "granted";
+	return {
+		peek: (e) => i(e) ? r : void 0,
+		get(a) {
+			return i(a) ? (n ??= Promise.resolve().then(e).then((e) => {
+				if (typeof e != "string" || e === "") throw TypeError(`expected a non-empty string, received ${JSON.stringify(e)}`);
+				return r = e;
+			}).catch((e) => {
+				t(new J("visitor_id_failed", "visitorId.fingerprint failed, so this page has no visitor ID", { cause: e }));
+			}), n) : Promise.resolve(void 0);
+		},
+		erase() {
+			n = void 0, r = void 0;
+		}
+	};
+}, me = ({ config: e, onError: t }) => {
+	if (e !== !1) {
+		if (e === "random") return fe();
+		if (typeof e?.fingerprint == "function") return pe({
+			fingerprint: e.fingerprint,
+			onError: t
+		});
+		throw Error(`[react-marketing-tools] visitorId must be 'random', false or { fingerprint: () => Promise<string> } (received ${JSON.stringify(e)}).`);
 	}
-}, $ = () => typeof window < "u", le = 90, ue = () => typeof crypto.randomUUID == "function" ? crypto.randomUUID() : "10000000-1000-4000-8000-100000000000".replace(/[018]/g, (e) => (Number(e) ^ crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(1))[0] & 15 >> Number(e) / 4).toString(16)), de = (e) => {
+}, he = ({ name: e, track: t, fail: n }) => {
+	let r = {
+		journey_id: Y(),
+		journey_name: e
+	}, i = !1, a, o = 0, s, c = (o) => a ? (n(new J("journey_ended", `journey "${e}" is already ${a}, so ${o} was ignored`)), !1) : (i || (i = !0, t("journey_start", r)), !0);
+	return {
+		step(e, n = {}) {
+			c(`step("${e}")`) && (o += 1, s = e, t("journey_step", {
+				...n,
+				...r,
+				step_name: e,
+				step_index: o
+			}));
+		},
+		complete(e = {}) {
+			c("complete()") && (a = "completed", t("journey_complete", {
+				...e,
+				...r,
+				step_count: o
+			}));
+		},
+		abandon(e) {
+			c("abandon()") && (a = "abandoned", t("journey_abandon", {
+				...r,
+				step_count: o,
+				...s && { step_name: s },
+				...e && { reason: e }
+			}));
+		}
+	};
+}, Q = () => typeof window < "u", ge = 90, $ = (e) => {
 	if (e.consent !== "granted" && e.consent !== "denied") throw Error(`[react-marketing-tools] createAnalytics: "consent" must be 'granted' or 'denied' (received ${JSON.stringify(e.consent)}).`);
-}, fe = (e) => {
-	de(e);
-	let { debug: t = !1, onError: n = console.error, respectGpc: r = !0 } = e, i = E({
-		consent: e.consent,
-		gpc: r && re()
-	}), a = i, o, s = [
-		...e.gtm ? [V({
-			...e.gtm,
-			nonce: e.nonce
+}, _e = (a) => {
+	$(a);
+	let { debug: o = !1, onError: s = console.error, respectGpc: c = !0 } = a, u = S({
+		consent: a.consent,
+		gpc: c && ie()
+	}), d = u, p, m = me({
+		config: a.visitorId ?? "random",
+		onError: s
+	}), h = () => {}, g = new Promise((e) => {
+		h = e;
+	}), _ = [
+		...a.gtm ? [F({
+			...a.gtm,
+			nonce: a.nonce
+		})] : [],
+		...a.ga4 ? [oe({
+			...a.ga4,
+			nonce: a.nonce
 		})] : [],
-		...e.ga4 ? [R({
-			...e.ga4,
-			nonce: e.nonce
+		...a.metaPixel ? [se({
+			...a.metaPixel,
+			nonce: a.nonce
 		})] : [],
-		...e.metaPixel ? [ce({
-			...e.metaPixel,
-			nonce: e.nonce
+		...a.server ? [le({
+			...a.server,
+			relayPageViews: !a.metaPixel || a.metaPixel.pageViews === "manual",
+			visitorId: () => m?.peek(d),
+			onError: s
 		})] : [],
-		...e.destinations ?? []
-	], c = [], d = !1, p = e.attribution === !1 ? void 0 : ne({ ttlDays: typeof e.attribution == "object" && e.attribution.ttlDays || le }), m = !1, h = () => {
-		m || (m = !0, p?.observe(g({
+		...a.destinations ?? []
+	], v = [], y = !1, b = a.attribution === !1 ? void 0 : ee({ ttlDays: typeof a.attribution == "object" && a.attribution.ttlDays || ge }), C = typeof a.attribution == "object" ? a.attribution.aiSources : void 0, w = !1, T = () => {
+		w || (w = !0, b?.observe(l({
 			url: location.href,
 			referrer: document.referrer,
-			capturedAt: Date.now()
+			capturedAt: Date.now(),
+			aiSources: C
 		})));
-	}, _ = () => d && a.analytics === "granted", v = (e) => {
-		if (t) throw e;
-		n(e);
-	}, y = (e) => {
-		for (let t of s) try {
+	}, E = () => y && d.analytics === "granted", D = () => {
+		y && a.server && m?.get(d);
+	}, O = (e) => {
+		if (o) throw e;
+		s(e);
+	}, k = (e) => {
+		for (let t of _) try {
 			e(t);
 		} catch (e) {
-			n(new Z("destination_failed", `destination "${t.name}" failed`, { cause: e }));
+			s(new J("destination_failed", `destination "${t.name}" failed`, { cause: e }));
 		}
-	}, b = (e) => {
-		d ? y(e) : c.push(e);
-	}, x = ({ name: e, params: t, options: n }) => {
-		let r = ee(e);
-		if (r) {
-			v(new Z("invalid_event", r));
+	}, A = (e) => {
+		y ? k(e) : v.push(e);
+	}, j = ({ name: n, params: i, options: a }) => {
+		let o = r(n);
+		if (o) {
+			O(new J("invalid_event", o));
 			return;
 		}
-		for (let n of l(t)) v(new Z("invalid_param", `event "${e}" ${n}`));
-		let i = f(t), a = n?.meta?.params && f(n.meta.params), o = [...i.redactedKeys, ...a?.redactedKeys.map((e) => `meta.${e}`) ?? []];
-		o.length > 0 && v(new Z("pii_redacted", `event "${e}": personal data redacted from ${o.join(", ")}`)), h();
-		let s = p?.get().lastTouch;
+		for (let e of t(i)) O(new J("invalid_param", `event "${n}" ${e}`));
+		let s = e(i), c = a?.meta || void 0, l = c?.params && e(c.params), u = [...s.redactedKeys, ...l?.redactedKeys.map((e) => `meta.${e}`) ?? []];
+		u.length > 0 && O(new J("pii_redacted", `event "${n}": personal data redacted from ${u.join(", ")}`)), T();
+		let d = b?.get().lastTouch;
 		return {
-			name: e,
-			params: i.params,
-			...s && { attribution: s },
-			...n && { options: a ? {
-				...n,
+			name: n,
+			params: s.params,
+			...d && { attribution: d },
+			...a && { options: l ? {
+				...a,
 				meta: {
-					...n.meta,
-					params: a.params
+					...c,
+					params: l.params
 				}
-			} : n },
-			eventId: ue(),
+			} : a },
+			eventId: Y(),
 			timestamp: Date.now()
 		};
+	}, M = (e, t = {}, n) => {
+		if (!Q()) return;
+		let r = j({
+			name: e,
+			params: t,
+			options: n
+		});
+		r && A((e) => e.track(r));
 	};
 	return {
 		start() {
-			!d && $() && (d = !0, h(), _() && (p?.restore(), p?.persist()), y((e) => e.start({
-				consent: i,
-				identity: o
-			})), c.splice(0).forEach(y));
-		},
-		track(e, t = {}, n) {
-			if (!$()) return;
-			let r = x({
-				name: e,
-				params: t,
-				options: n
-			});
-			r && b((e) => e.track(r));
+			!y && Q() && (y = !0, T(), E() && (b?.restore(), b?.persist()), D(), k((e) => e.start({
+				consent: u,
+				identity: p
+			})), v.splice(0).forEach(k), a.autocapture?.clicks && te(M), h());
 		},
+		track: M,
+		journey: (e) => he({
+			name: e,
+			track: M,
+			fail: O
+		}),
 		page(e = {}) {
-			if (!$()) return;
-			h(), p?.observe(g({
+			if (!Q()) return;
+			T(), b?.observe(l({
 				url: location.href,
-				capturedAt: Date.now()
-			})), _() && p?.persist();
-			let t = x({
+				capturedAt: Date.now(),
+				aiSources: C
+			})), E() && b?.persist();
+			let t = j({
 				name: "page_view",
 				params: {
 					page_location: location.href,
@@ -428,43 +571,43 @@ var e = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, t = [
 					...e
 				}
 			});
-			t && b((e) => e.page ? e.page(t) : e.track(t));
+			t && A((e) => e.page ? e.page(t) : e.track(t));
 		},
 		identify(e, t = {}) {
-			if (!$()) return;
-			if (!e || u(e)) {
-				v(new Z("invalid_user_id", "identify() needs a non-empty user id that is not personal data such as an email address"));
+			if (!Q()) return;
+			if (!e || n(e)) {
+				O(new J("invalid_user_id", "identify() needs a non-empty user id that is not personal data such as an email address"));
 				return;
 			}
-			let n = {
+			let r = {
 				userId: e,
 				traits: t
 			};
-			o = n, b((e) => e.identify?.(n));
+			p = r, A((e) => e.identify?.(r));
 		},
 		reset() {
-			$() && (o = void 0, b((e) => e.reset?.()));
+			Q() && (p = void 0, A((e) => e.reset?.()));
 		},
 		consent: {
 			update(e) {
-				if (!$()) return;
-				let t = Object.entries(e).filter(([e, t]) => t !== void 0 && !(w.includes(e) && T(t)));
+				if (!Q()) return;
+				let t = Object.entries(e).filter(([e, t]) => t !== void 0 && !(ne.includes(e) && x(t)));
 				if (t.length > 0) {
-					v(new Z("invalid_consent", `consent.update() ignored: ${t.map(([e, t]) => `${e}=${JSON.stringify(t)}`).join(", ")}. Use analytics, ads, adUserData or adPersonalization with 'granted' or 'denied'.`));
+					O(new J("invalid_consent", `consent.update() ignored: ${t.map(([e, t]) => `${e}=${JSON.stringify(t)}`).join(", ")}. Use analytics, ads, adUserData or adPersonalization with 'granted' or 'denied'.`));
 					return;
 				}
-				let n = a, r = D(a, e);
-				a = r, n.analytics === "granted" && r.analytics === "denied" ? p?.erase() : _() && (p?.restore(), p?.persist()), b((e) => e.consent?.(r));
+				let n = d, r = re(d, e);
+				d = r, n.analytics === "granted" && r.analytics === "denied" ? (b?.erase(), m?.erase()) : E() && (b?.restore(), b?.persist()), D(), A((e) => e.consent?.(r));
 			},
-			get: () => a
+			get: () => d
 		},
 		getAttribution() {
-			if (!$()) return {};
-			h();
-			let e = p?.get() ?? {};
-			if (a.adUserData !== "granted") return e;
-			let t = Q(document.cookie, "_fbp"), n = te({
-				fbcCookie: Q(document.cookie, "_fbc"),
+			if (!Q()) return {};
+			T();
+			let e = b?.get() ?? {};
+			if (d.adUserData !== "granted") return e;
+			let t = i(document.cookie, "_fbp"), n = f({
+				fbcCookie: i(document.cookie, "_fbc"),
 				touch: e.lastTouch
 			});
 			return {
@@ -472,8 +615,11 @@ var e = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, t = [
 				...n && { fbc: n },
 				...t && { fbp: t }
 			};
+		},
+		getVisitorId() {
+			return !Q() || !m ? Promise.resolve(void 0) : g.then(() => m.get(d));
 		}
 	};
 };
 //#endregion
-export { Z as n, fe as t };
+export { J as n, _e as t };