react-marketing-tools 1.0.0-alpha.1 → 1.0.0-alpha.2

package/dist/chunks/core.js

@@ -0,0 +1,154 @@
+//#region lib/destinations/gtm.ts
+var e = /^GTM-[A-Z0-9]+$/, t = () => window.dataLayer ??= [], n = (e) => Array.from(document.scripts).some((t) => t.src === e), r = ({ src: e, nonce: t }) => {
+	let n = document.createElement("script");
+	n.async = !0, n.src = e, t && n.setAttribute("nonce", t), document.head.append(n);
+}, i = ({ containerId: i, loadScript: a = !0, nonce: o }) => {
+	if (!e.test(i)) throw Error(`[react-marketing-tools] gtm.containerId must look like "GTM-XXXXXXX" (received ${JSON.stringify(i)}).`);
+	let s = `https://www.googletagmanager.com/gtm.js?id=${i}`;
+	return {
+		name: "gtm",
+		start() {
+			let e = t();
+			a && !n(s) && (e.push({
+				"gtm.start": Date.now(),
+				event: "gtm.js"
+			}), r({
+				src: s,
+				nonce: o
+			}));
+		},
+		track({ name: e, params: n, eventId: r }) {
+			t().push({
+				...n,
+				event: e,
+				event_id: r
+			});
+		},
+		identify({ userId: e }) {
+			t().push({
+				event: "identify",
+				user_id: e
+			});
+		},
+		reset() {
+			t().push({
+				event: "reset",
+				user_id: void 0
+			});
+		}
+	};
+}, a = class extends Error {
+	code;
+	constructor(e, t, n) {
+		super(`[react-marketing-tools] ${t}`, n), this.name = "AnalyticsError", this.code = e;
+	}
+}, o = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, s = [
+	"google_",
+	"ga_",
+	"firebase_"
+], c = 25, l = 100, u = {
+	page_location: 1e3,
+	page_referrer: 420,
+	page_title: 300
+}, d = [
+	"email",
+	"phone",
+	"first_name",
+	"last_name",
+	"address",
+	"password"
+], f = String.raw`[\w.+-]+(?:@|%40)[\w-]+(?:\.[\w-]+)+`, p = "[redacted]", m = (e) => {
+	if (!o.test(e)) return "must start with a letter, contain only letters, digits and underscores, and be at most 40 characters";
+	let t = s.find((t) => e.toLowerCase().startsWith(t));
+	return t && `must not start with the reserved prefix "${t}"`;
+}, h = (e) => {
+	let t = m(e);
+	return t && `event name "${e}" ${t}`;
+}, g = (e) => {
+	let t = Object.keys(e), n = t.flatMap((t) => {
+		let n = m(t);
+		if (n) return [`param "${t}" ${n}`];
+		let r = e[t], i = u[t] ?? l;
+		return typeof r == "string" && r.length > i ? [`param "${t}" is longer than ${i} characters`] : [];
+	});
+	return t.length > c ? [`has ${t.length} params; the limit is ${c}`, ...n] : n;
+}, _ = (e) => new RegExp(f, "i").test(e), v = (e, t) => (typeof t == "string" || typeof t == "number") && d.some((t) => e.toLowerCase().includes(t)) ? p : typeof t == "string" ? t.replace(new RegExp(f, "gi"), p) : t, y = (e) => {
+	let t = Object.entries(e).map(([e, t]) => [
+		e,
+		t,
+		v(e, t)
+	]);
+	return {
+		params: Object.fromEntries(t.map(([e, , t]) => [e, t])),
+		redactedKeys: t.filter(([, e, t]) => t !== e).map(([e]) => e)
+	};
+}, b = () => typeof window < "u", x = () => 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)), S = (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)}).`);
+}, C = (e) => {
+	S(e);
+	let { debug: t = !1, onError: n = console.error } = e, r = [...e.gtm ? [i({
+		...e.gtm,
+		nonce: e.nonce
+	})] : [], ...e.destinations ?? []], o = [], s = !1, c = (e) => {
+		if (t) throw e;
+		n(e);
+	}, l = (e) => {
+		for (let t of r) try {
+			e(t);
+		} catch (e) {
+			n(new a("destination_failed", `destination "${t.name}" failed`, { cause: e }));
+		}
+	}, u = (e) => {
+		s ? l(e) : o.push(e);
+	}, d = (e, t) => {
+		let n = h(e);
+		if (n) {
+			c(new a("invalid_event", n));
+			return;
+		}
+		for (let n of g(t)) c(new a("invalid_param", `event "${e}" ${n}`));
+		let { params: r, redactedKeys: i } = y(t);
+		return i.length > 0 && c(new a("pii_redacted", `event "${e}": personal data redacted from ${i.join(", ")}`)), {
+			name: e,
+			params: r,
+			eventId: x(),
+			timestamp: Date.now()
+		};
+	};
+	return {
+		start() {
+			!s && b() && (s = !0, l((e) => e.start()), o.splice(0).forEach(l));
+		},
+		track(e, t = {}) {
+			if (!b()) return;
+			let n = d(e, t);
+			n && u((e) => e.track(n));
+		},
+		page(e = {}) {
+			if (!b()) return;
+			let t = d("page_view", {
+				page_location: location.href,
+				page_title: document.title,
+				...e
+			});
+			t && u((e) => e.page ? e.page(t) : e.track(t));
+		},
+		identify(e, t = {}) {
+			if (b()) {
+				if (!e || _(e)) {
+					c(new a("invalid_user_id", "identify() needs a non-empty user id that is not personal data such as an email address"));
+					return;
+				}
+				u((n) => n.identify?.({
+					userId: e,
+					traits: t
+				}));
+			}
+		},
+		reset() {
+			b() && u((e) => e.reset?.());
+		}
+	};
+};
+//#endregion
+export { a as n, C as t };

package/dist/core.js

@@ -1,154 +1,2 @@
-//#region lib/destinations/gtm.ts
-var e = /^GTM-[A-Z0-9]+$/, t = () => window.dataLayer ??= [], n = (e) => Array.from(document.scripts).some((t) => t.src === e), r = ({ src: e, nonce: t }) => {
-	let n = document.createElement("script");
-	n.async = !0, n.src = e, t && n.setAttribute("nonce", t), document.head.append(n);
-}, i = ({ containerId: i, loadScript: a = !0, nonce: o }) => {
-	if (!e.test(i)) throw Error(`[react-marketing-tools] gtm.containerId must look like "GTM-XXXXXXX" (received ${JSON.stringify(i)}).`);
-	let s = `https://www.googletagmanager.com/gtm.js?id=${i}`;
-	return {
-		name: "gtm",
-		start() {
-			let e = t();
-			a && !n(s) && (e.push({
-				"gtm.start": Date.now(),
-				event: "gtm.js"
-			}), r({
-				src: s,
-				nonce: o
-			}));
-		},
-		track({ name: e, params: n, eventId: r }) {
-			t().push({
-				...n,
-				event: e,
-				event_id: r
-			});
-		},
-		identify({ userId: e }) {
-			t().push({
-				event: "identify",
-				user_id: e
-			});
-		},
-		reset() {
-			t().push({
-				event: "reset",
-				user_id: void 0
-			});
-		}
-	};
-}, a = class extends Error {
-	code;
-	constructor(e, t, n) {
-		super(`[react-marketing-tools] ${t}`, n), this.name = "AnalyticsError", this.code = e;
-	}
-}, o = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, s = [
-	"google_",
-	"ga_",
-	"firebase_"
-], c = 25, l = 100, u = {
-	page_location: 1e3,
-	page_referrer: 420,
-	page_title: 300
-}, d = [
-	"email",
-	"phone",
-	"first_name",
-	"last_name",
-	"address",
-	"password"
-], f = String.raw`[\w.+-]+(?:@|%40)[\w-]+(?:\.[\w-]+)+`, p = "[redacted]", m = (e) => {
-	if (!o.test(e)) return "must start with a letter, contain only letters, digits and underscores, and be at most 40 characters";
-	let t = s.find((t) => e.toLowerCase().startsWith(t));
-	return t && `must not start with the reserved prefix "${t}"`;
-}, h = (e) => {
-	let t = m(e);
-	return t && `event name "${e}" ${t}`;
-}, g = (e) => {
-	let t = Object.keys(e), n = t.flatMap((t) => {
-		let n = m(t);
-		if (n) return [`param "${t}" ${n}`];
-		let r = e[t], i = u[t] ?? l;
-		return typeof r == "string" && r.length > i ? [`param "${t}" is longer than ${i} characters`] : [];
-	});
-	return t.length > c ? [`has ${t.length} params; the limit is ${c}`, ...n] : n;
-}, _ = (e) => new RegExp(f, "i").test(e), v = (e, t) => (typeof t == "string" || typeof t == "number") && d.some((t) => e.toLowerCase().includes(t)) ? p : typeof t == "string" ? t.replace(new RegExp(f, "gi"), p) : t, y = (e) => {
-	let t = Object.entries(e).map(([e, t]) => [
-		e,
-		t,
-		v(e, t)
-	]);
-	return {
-		params: Object.fromEntries(t.map(([e, , t]) => [e, t])),
-		redactedKeys: t.filter(([, e, t]) => t !== e).map(([e]) => e)
-	};
-}, b = () => typeof window < "u", x = () => 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)), S = (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)}).`);
-}, C = (e) => {
-	S(e);
-	let { debug: t = !1, onError: n = console.error } = e, r = [...e.gtm ? [i({
-		...e.gtm,
-		nonce: e.nonce
-	})] : [], ...e.destinations ?? []], o = [], s = !1, c = (e) => {
-		if (t) throw e;
-		n(e);
-	}, l = (e) => {
-		for (let t of r) try {
-			e(t);
-		} catch (e) {
-			n(new a("destination_failed", `destination "${t.name}" failed`, { cause: e }));
-		}
-	}, u = (e) => {
-		s ? l(e) : o.push(e);
-	}, d = (e, t) => {
-		let n = h(e);
-		if (n) {
-			c(new a("invalid_event", n));
-			return;
-		}
-		for (let n of g(t)) c(new a("invalid_param", `event "${e}" ${n}`));
-		let { params: r, redactedKeys: i } = y(t);
-		return i.length > 0 && c(new a("pii_redacted", `event "${e}": personal data redacted from ${i.join(", ")}`)), {
-			name: e,
-			params: r,
-			eventId: x(),
-			timestamp: Date.now()
-		};
-	};
-	return {
-		start() {
-			!s && b() && (s = !0, l((e) => e.start()), o.splice(0).forEach(l));
-		},
-		track(e, t = {}) {
-			if (!b()) return;
-			let n = d(e, t);
-			n && u((e) => e.track(n));
-		},
-		page(e = {}) {
-			if (!b()) return;
-			let t = d("page_view", {
-				page_location: location.href,
-				page_title: document.title,
-				...e
-			});
-			t && u((e) => e.page ? e.page(t) : e.track(t));
-		},
-		identify(e, t = {}) {
-			if (b()) {
-				if (!e || _(e)) {
-					c(new a("invalid_user_id", "identify() needs a non-empty user id that is not personal data such as an email address"));
-					return;
-				}
-				u((n) => n.identify?.({
-					userId: e,
-					traits: t
-				}));
-			}
-		},
-		reset() {
-			b() && u((e) => e.reset?.());
-		}
-	};
-};
-//#endregion
-export { a as AnalyticsError, C as createAnalytics };
+import { n as e, t } from "./chunks/core.js";
+export { e as AnalyticsError, t as createAnalytics };

package/dist/index.d.ts

@@ -1,26 +1,2 @@
-import { ReactElement, ReactNode, Context } from 'react';
-import type { ProviderStateProps, ProviderApiProps } from './types/index.js';
-export type { Event, GooglePayload, EventNameInfo, AllowedTypes, TrackAnalyticsEventOptions, GlobalVars, DataLayer, ConsoleLogData, AnalyticsTrackerDataOptions, HandleDataLayerPushOptions, ServerLocationData, IpInfo, Ga4GoogleAnalyticsEventTracking, Platform, AnalyticsPlatform, Tokens, Config, BuildConfigOptions, ProviderStateProps, ProviderApiProps, AnalyticsEventActionPrefix, AnalyticsGlobalEventAction, } from './types/index.js';
-export { config, analyticsPlatform, buildConfig, showMeBuildInAnalyticsPlatform, showMeBuildInGlobalEventActionList, showMeBuildInEventActionPrefixList, } from './buildConfig/index.js';
-export { trackAnalyticsEvent } from './analytics/analyticsEventService.js';
-export declare const ContextState: Context<ProviderStateProps>;
-export declare const ContextApi: Context<ProviderApiProps>;
-type ReactMarketingProviderProps = {
-    children: ReactNode;
-};
-export declare const ReactMarketingProvider: ({ children, }: ReactMarketingProviderProps) => ReactElement;
-/**
- * @property {string} appName
- * @property {string} appSessionCookieName
- * @property {AnalyticsPlatform} analyticsPlatform
- * @property {AnalyticsEventActionPrefix} eventActionPrefixList
- * @property {AnalyticsGlobalEventAction} analyticsGlobalEventActionList
- */
-export declare const useMarketingState: () => ProviderStateProps;
-/**
- * @property {function} trackAnalyticsEvent(options)
- * @property {function} showMeBuildInAnalyticsPlatform
- * @property {function} showMeBuildInEventActionPrefixList
- * @property {function} showMeBuildInGlobalEventActionList
- */
-export declare const useMarketingApi: () => ProviderApiProps;
+export * from './core.js';
+export { AnalyticsProvider, useAnalytics } from './react/AnalyticsProvider.js';