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

package/dist/chunks/core.js

@@ -0,0 +1,258 @@
+//#region lib/core/consent.ts
+var e = [
+	"analytics",
+	"ads",
+	"adUserData",
+	"adPersonalization"
+], t = (e) => e === "granted" || e === "denied", n = ({ consent: e, gpc: t }) => {
+	let n = t ? "denied" : e;
+	return {
+		analytics: e,
+		ads: n,
+		adUserData: n,
+		adPersonalization: n
+	};
+}, r = (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
+}), i = (e) => ({
+	analytics_storage: e.analytics,
+	ad_storage: e.ads,
+	ad_user_data: e.adUserData,
+	ad_personalization: e.adPersonalization
+}), a = (e) => Object.values(e).includes("denied"), o = () => typeof navigator < "u" && navigator.globalPrivacyControl === !0, s = () => window.dataLayer ??= [], c = () => Array.from(document.scripts).some((e) => URL.canParse(e.src) && new URL(e.src).pathname.endsWith("/gtag/js")), l = () => window.gtag ??= function() {
+	s().push(arguments);
+}, u = ({ consent: e, waitForUpdate: t }) => {
+	l()("consent", "default", {
+		...i(e),
+		...a(e) ? { wait_for_update: t } : {}
+	});
+}, d = (e) => {
+	l()("consent", "update", i(e));
+}, f = (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;
+}, p = (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);
+}, h = /^G-[A-Z0-9]+$/, g = ({ measurementId: e, pageViews: t = "auto", loadScript: n = !0, serverContainerUrl: r, waitForUpdate: i = 500, nonce: a }) => {
+	if (!h.test(e)) throw Error(`[react-marketing-tools] ga4.measurementId must look like "G-XXXXXXX" (received ${JSON.stringify(e)}).`);
+	r !== void 0 && f(r, "ga4.serverContainerUrl");
+	let o = `https://www.googletagmanager.com/gtag/js?id=${e}`, s = (e, t) => r ? {
+		...e,
+		event_id: t
+	} : e;
+	return {
+		name: "ga4",
+		start({ consent: s }) {
+			u({
+				consent: s,
+				waitForUpdate: i
+			}), c() || (l()("js", /* @__PURE__ */ new Date()), n && m({
+				src: o,
+				nonce: a
+			})), l()("config", e, {
+				...t === "manual" ? { send_page_view: !1 } : {},
+				...r ? { server_container_url: r } : {}
+			});
+		},
+		track({ name: e, params: t, eventId: n }) {
+			l()("event", e, s(t, n));
+		},
+		consent(e) {
+			d(e);
+		},
+		page({ params: e, eventId: n }) {
+			t === "manual" && l()("event", "page_view", s(e, n));
+		},
+		identify({ userId: e }) {
+			l()("set", { user_id: e });
+		},
+		reset() {
+			l()("set", { user_id: null });
+		}
+	};
+}, _ = /^GTM-[A-Z0-9]+$/, v = (e, t) => {
+	let n = f(t ?? "https://www.googletagmanager.com/gtm.js", "gtm.scriptUrl");
+	return n.searchParams.set("id", e), n.href;
+}, y = ({ containerId: e, loadScript: t = !0, scriptUrl: n, waitForUpdate: r = 500, nonce: i }) => {
+	if (!_.test(e)) throw Error(`[react-marketing-tools] gtm.containerId must look like "GTM-XXXXXXX" (received ${JSON.stringify(e)}).`);
+	let a = v(e, n);
+	return {
+		name: "gtm",
+		start({ consent: e }) {
+			u({
+				consent: e,
+				waitForUpdate: r
+			}), t && !p(a) && (s().push({
+				"gtm.start": Date.now(),
+				event: "gtm.js"
+			}), m({
+				src: a,
+				nonce: i
+			}));
+		},
+		track({ name: e, params: t, eventId: n }) {
+			s().push({
+				...t,
+				event: e,
+				event_id: n
+			});
+		},
+		consent(e) {
+			d(e);
+		},
+		identify({ userId: e }) {
+			s().push({
+				event: "identify",
+				user_id: e
+			});
+		},
+		reset() {
+			s().push({
+				event: "reset",
+				user_id: void 0
+			});
+		}
+	};
+}, b = class extends Error {
+	code;
+	constructor(e, t, n) {
+		super(`[react-marketing-tools] ${t}`, n), this.name = "AnalyticsError", this.code = e;
+	}
+}, x = /^[A-Za-z][A-Za-z0-9_]{0,39}$/, S = [
+	"google_",
+	"ga_",
+	"firebase_"
+], C = 25, w = 100, T = {
+	page_location: 1e3,
+	page_referrer: 420,
+	page_title: 300
+}, E = [
+	"email",
+	"phone",
+	"first_name",
+	"last_name",
+	"address",
+	"password"
+], D = String.raw`[\w.+-]+(?:@|%40)[\w-]+(?:\.[\w-]+)+`, O = "[redacted]", k = (e) => {
+	if (!x.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}"`;
+}, A = (e) => {
+	let t = k(e);
+	return t && `event name "${e}" ${t}`;
+}, j = (e) => {
+	let t = Object.keys(e), n = t.flatMap((t) => {
+		let n = k(t);
+		if (n) return [`param "${t}" ${n}`];
+		let r = e[t], i = T[t] ?? w;
+		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;
+}, M = (e) => new RegExp(D, "i").test(e), N = (e, t) => (typeof t == "string" || typeof t == "number") && E.some((t) => e.toLowerCase().includes(t)) ? O : typeof t == "string" ? t.replace(new RegExp(D, "gi"), O) : t, P = (e) => {
+	let t = Object.entries(e).map(([e, t]) => [
+		e,
+		t,
+		N(e, t)
+	]);
+	return {
+		params: Object.fromEntries(t.map(([e, , t]) => [e, t])),
+		redactedKeys: t.filter(([, e, t]) => t !== e).map(([e]) => e)
+	};
+}, F = () => typeof window < "u", I = () => 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)), L = (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)}).`);
+}, R = (i) => {
+	L(i);
+	let { debug: a = !1, onError: s = console.error, respectGpc: c = !0 } = i, l = n({
+		consent: i.consent,
+		gpc: c && o()
+	}), u = l, d = [
+		...i.gtm ? [y({
+			...i.gtm,
+			nonce: i.nonce
+		})] : [],
+		...i.ga4 ? [g({
+			...i.ga4,
+			nonce: i.nonce
+		})] : [],
+		...i.destinations ?? []
+	], f = [], p = !1, m = (e) => {
+		if (a) throw e;
+		s(e);
+	}, h = (e) => {
+		for (let t of d) try {
+			e(t);
+		} catch (e) {
+			s(new b("destination_failed", `destination "${t.name}" failed`, { cause: e }));
+		}
+	}, _ = (e) => {
+		p ? h(e) : f.push(e);
+	}, v = (e, t) => {
+		let n = A(e);
+		if (n) {
+			m(new b("invalid_event", n));
+			return;
+		}
+		for (let n of j(t)) m(new b("invalid_param", `event "${e}" ${n}`));
+		let { params: r, redactedKeys: i } = P(t);
+		return i.length > 0 && m(new b("pii_redacted", `event "${e}": personal data redacted from ${i.join(", ")}`)), {
+			name: e,
+			params: r,
+			eventId: I(),
+			timestamp: Date.now()
+		};
+	};
+	return {
+		start() {
+			!p && F() && (p = !0, h((e) => e.start({ consent: l })), f.splice(0).forEach(h));
+		},
+		track(e, t = {}) {
+			if (!F()) return;
+			let n = v(e, t);
+			n && _((e) => e.track(n));
+		},
+		page(e = {}) {
+			if (!F()) return;
+			let t = v("page_view", {
+				page_location: location.href,
+				page_title: document.title,
+				...e
+			});
+			t && _((e) => e.page ? e.page(t) : e.track(t));
+		},
+		identify(e, t = {}) {
+			if (F()) {
+				if (!e || M(e)) {
+					m(new b("invalid_user_id", "identify() needs a non-empty user id that is not personal data such as an email address"));
+					return;
+				}
+				_((n) => n.identify?.({
+					userId: e,
+					traits: t
+				}));
+			}
+		},
+		reset() {
+			F() && _((e) => e.reset?.());
+		},
+		consent: {
+			update(n) {
+				if (!F()) return;
+				let i = Object.entries(n).filter(([n, r]) => r !== void 0 && !(e.includes(n) && t(r)));
+				if (i.length > 0) {
+					m(new b("invalid_consent", `consent.update() ignored: ${i.map(([e, t]) => `${e}=${JSON.stringify(t)}`).join(", ")}. Use analytics, ads, adUserData or adPersonalization with 'granted' or 'denied'.`));
+					return;
+				}
+				let a = r(u, n);
+				u = a, _((e) => e.consent?.(a));
+			},
+			get: () => u
+		}
+	};
+};
+//#endregion
+export { b as n, R as t };

package/dist/core/consent.d.ts

@@ -0,0 +1,20 @@
+import type { ConsentState, ConsentStatus, ConsentUpdate } from './types.js';
+export declare const CONSENT_KEYS: readonly (keyof ConsentState)[];
+export declare const isConsentStatus: (value: unknown) => value is ConsentStatus;
+/** Every signal follows `consent`, except that Global Privacy Control (an ad opt-out) denies the advertising signals. */
+export declare const initialConsentState: ({ consent, gpc, }: {
+    consent: ConsentStatus;
+    gpc: boolean;
+}) => ConsentState;
+/** `ads` also sets `adUserData` and `adPersonalization`, unless the update gives them explicitly (e.g. TCF-style CMPs). */
+export declare const applyConsentUpdate: (state: ConsentState, update: ConsentUpdate) => ConsentState;
+/** Google Consent Mode v2 signals. */
+export declare const toGoogleConsent: (state: ConsentState) => {
+    analytics_storage: ConsentStatus;
+    ad_storage: ConsentStatus;
+    ad_user_data: ConsentStatus;
+    ad_personalization: ConsentStatus;
+};
+export declare const hasDeniedSignal: (state: ConsentState) => boolean;
+/** Global Privacy Control: a browser-level "do not sell or share" signal. Absent in browsers that don't support it. */
+export declare const readGlobalPrivacyControl: () => boolean;

package/dist/core/errors.d.ts

@@ -1,4 +1,4 @@
-export type AnalyticsErrorCode = 'invalid_event' | 'invalid_param' | 'invalid_user_id' | 'pii_redacted' | 'destination_failed';
+export type AnalyticsErrorCode = 'invalid_event' | 'invalid_param' | 'invalid_user_id' | 'invalid_consent' | 'pii_redacted' | 'destination_failed';
 /** Every problem the library reports to `onError`, or throws when `debug` is on. */
 export declare class AnalyticsError extends Error {
     readonly code: AnalyticsErrorCode;

package/dist/core/types.d.ts

@@ -1,5 +1,16 @@
 import type { AnalyticsError } from './errors.js';
 export type ConsentStatus = 'granted' | 'denied';
+/**
+ * The visitor's consent, per purpose. `ads` covers advertising storage; `adUserData` (sending user data to ad platforms)
+ * and `adPersonalization` follow `ads` unless set explicitly.
+ */
+export type ConsentState = {
+    analytics: ConsentStatus;
+    ads: ConsentStatus;
+    adUserData: ConsentStatus;
+    adPersonalization: ConsentStatus;
+};
+export type ConsentUpdate = Partial<ConsentState>;
 /** Event parameters, passed to every destination as-is. */
 export type EventParams = Record<string, unknown>;
 export type AnalyticsEvent = {
@@ -27,9 +38,13 @@ export type Identity = {
 /** Somewhere events are sent. Built-in destinations are configured by key; custom ones go in `destinations`. */
 export type Destination = {
     name: string;
-    /** Called once, in the browser, by `analytics.start()`. */
-    start(): void;
+    /** Called once, in the browser, by `analytics.start()`, with the consent state the page started with. */
+    start(context: {
+        consent: ConsentState;
+    }): void;
     track(event: AnalyticsEvent): void;
+    /** Receives every consent change, in order with events. */
+    consent?(state: ConsentState): void;
     /** Receives `page_view` events. Destinations without it get them through `track`. */
     page?(event: AnalyticsEvent): void;
     identify?(identity: Identity): void;
@@ -41,11 +56,36 @@ export type GtmConfig = {
     containerId: string;
     /** Set to `false` when the page already includes the GTM snippet. Defaults to `true`. */
     loadScript?: boolean;
+    /** Load `gtm.js` from this https URL instead of googletagmanager.com, e.g. your server-side GTM domain. */
+    scriptUrl?: string;
+    /** Milliseconds tags wait for a consent update when a Consent Mode signal starts denied. Defaults to 500. */
+    waitForUpdate?: number;
+};
+export type Ga4Config = {
+    /** Google Analytics 4 measurement ID, e.g. `G-XXXXXXX`. */
+    measurementId: string;
+    /**
+     * `'auto'` (default): GA4 records page views itself, including history changes when Enhanced Measurement is on.
+     * `'manual'`: only `analytics.page()` sends page views.
+     */
+    pageViews?: 'auto' | 'manual';
+    /** Set to `false` when the page already loads gtag.js. Defaults to `true`. */
+    loadScript?: boolean;
+    /** Your server-side GTM URL (https). Hits go there instead of Google, and events carry `event_id`. */
+    serverContainerUrl?: string;
+    /** Milliseconds tags wait for a consent update when a Consent Mode signal starts denied. Defaults to 500. */
+    waitForUpdate?: number;
 };
 export type AnalyticsConfig = {
-    /** Initial consent state. Required, so every site makes an explicit choice. */
+    /** Initial consent for every purpose. Required, so every site makes an explicit choice. */
     consent: ConsentStatus;
+    /**
+     * Honour the browser's Global Privacy Control signal by starting the advertising signals denied. Defaults to `true`.
+     * An explicit `analytics.consent.update()` still wins.
+     */
+    respectGpc?: boolean;
     gtm?: GtmConfig;
+    ga4?: Ga4Config;
     /** Custom destinations, in addition to the built-in ones. */
     destinations?: Destination[];
     /** Content-Security-Policy nonce added to every script the library injects. */
@@ -66,4 +106,9 @@ export type Analytics = {
     identify(userId: string, traits?: IdentityTraits): void;
     /** Forgets the identified user, e.g. on logout. */
     reset(): void;
+    consent: {
+        /** Records the visitor's choice, e.g. from your consent banner. Omitted purposes keep their current state. */
+        update(update: ConsentUpdate): void;
+        get(): ConsentState;
+    };
 };

package/dist/core.d.ts

@@ -1,4 +1,4 @@
 export { createAnalytics } from './core/createAnalytics.js';
 export { AnalyticsError } from './core/errors.js';
 export type { AnalyticsErrorCode } from './core/errors.js';
-export type { Analytics, AnalyticsConfig, AnalyticsEvent, ConsentStatus, Destination, EventParams, GtmConfig, Identity, IdentityTraits, } from './core/types.js';
+export type { Analytics, AnalyticsConfig, AnalyticsEvent, ConsentState, ConsentStatus, ConsentUpdate, Destination, EventParams, Ga4Config, GtmConfig, Identity, IdentityTraits, } from './core/types.js';

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/destinations/ga4.d.ts

@@ -0,0 +1,6 @@
+import type { Destination, Ga4Config } from '../core/types.js';
+type Ga4DestinationOptions = Ga4Config & {
+    nonce?: string;
+};
+export declare const createGa4Destination: ({ measurementId, pageViews, loadScript, serverContainerUrl, waitForUpdate, nonce, }: Ga4DestinationOptions) => Destination;
+export {};

package/dist/destinations/googleTag.d.ts

@@ -0,0 +1,22 @@
+import type { ConsentState } from '../core/types.js';
+type Gtag = (...args: unknown[]) => void;
+export declare const dataLayer: () => unknown[];
+/**
+ * Whether the page already loads the gtag.js library (any stream, Google- or first-party-hosted). Checked by script rather
+ * than by `window.gtag`, because the Consent Mode default defines the gtag stub before any library loads.
+ */
+export declare const isGtagLibraryOnPage: () => boolean;
+/** The page's `gtag()`, defining Google's official command-queue stub when the page doesn't have one yet. */
+export declare const gtag: () => Gtag;
+/**
+ * Consent Mode v2 default. It must be queued before any config or container load. When a signal starts denied, tags
+ * wait `waitForUpdate` ms for the visitor's choice before firing.
+ */
+export declare const setDefaultConsent: ({ consent, waitForUpdate, }: {
+    consent: ConsentState;
+    waitForUpdate: number;
+}) => void;
+export declare const updateConsent: (consent: ConsentState) => void;
+/** Parses an option that must be an https:// URL, failing fast with the option's name. */
+export declare const toHttpsUrl: (value: string, option: string) => URL;
+export {};

package/dist/destinations/gtm.d.ts

@@ -2,5 +2,5 @@ import type { Destination, GtmConfig } from '../core/types.js';
 type GtmDestinationOptions = GtmConfig & {
     nonce?: string;
 };
-export declare const createGtmDestination: ({ containerId, loadScript, nonce, }: GtmDestinationOptions) => Destination;
+export declare const createGtmDestination: ({ containerId, loadScript, scriptUrl, waitForUpdate, nonce, }: GtmDestinationOptions) => Destination;
 export {};

package/dist/destinations/loadScript.d.ts

@@ -0,0 +1,6 @@
+export declare const isScriptOnPage: (src: string) => boolean;
+/** Appends an async vendor script, carrying the page's CSP nonce when there is one. */
+export declare const injectScript: ({ src, nonce, }: {
+    src: string;
+    nonce?: string;
+}) => void;

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';