@technoapple/ga4 1.0.4 → 1.1.0

package/build/main/plugins/impression-tracker.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImpressionTracker = void 0;
+const dom_ready_1 = require("../helpers/dom-ready");
+/**
+ * Tracks when specific DOM elements become visible in the viewport
+ * using `IntersectionObserver`.
+ *
+ * Useful for tracking ad impressions, CTA visibility, or any
+ * element that enters the user's viewport.
+ */
+class ImpressionTracker {
+    send;
+    rootMargin;
+    attributePrefix;
+    eventName;
+    hitFilter;
+    items = [];
+    elementMap = {};
+    thresholdMap = {};
+    mutationObserver = null;
+    impressedIds = new Set();
+    supported;
+    constructor(send, options) {
+        this.supported =
+            typeof IntersectionObserver !== 'undefined' &&
+                typeof MutationObserver !== 'undefined';
+        this.send = send;
+        this.rootMargin = options?.rootMargin ?? '0px';
+        this.attributePrefix = options?.attributePrefix ?? 'data-ga4-';
+        this.eventName = options?.eventName ?? 'element_impression';
+        this.hitFilter = options?.hitFilter;
+        if (!this.supported)
+            return;
+        this.handleIntersectionChanges = this.handleIntersectionChanges.bind(this);
+        this.handleDomMutations = this.handleDomMutations.bind(this);
+        const elements = options?.elements;
+        (0, dom_ready_1.domReady)(() => {
+            if (elements && elements.length > 0) {
+                this.observeElements(elements);
+            }
+        });
+    }
+    observeElements(elements) {
+        if (!this.supported)
+            return;
+        const newItems = this.normalizeElements(elements);
+        this.items = this.items.concat(newItems);
+        newItems.forEach((item) => {
+            const observer = this.getObserverForThreshold(item.threshold);
+            const element = document.getElementById(item.id);
+            this.elementMap[item.id] = element;
+            if (element) {
+                observer.observe(element);
+            }
+        });
+        if (!this.mutationObserver && document.body) {
+            this.mutationObserver = new MutationObserver(this.handleDomMutations);
+            this.mutationObserver.observe(document.body, {
+                childList: true,
+                subtree: true,
+            });
+        }
+    }
+    unobserveElements(elements) {
+        if (!this.supported)
+            return;
+        const idsToRemove = new Set(elements.map((el) => (typeof el === 'string' ? el : el.id)));
+        this.items = this.items.filter((item) => {
+            if (idsToRemove.has(item.id)) {
+                const element = this.elementMap[item.id];
+                if (element && this.thresholdMap[item.threshold]) {
+                    this.thresholdMap[item.threshold].unobserve(element);
+                }
+                delete this.elementMap[item.id];
+                return false;
+            }
+            return true;
+        });
+        if (this.items.length === 0) {
+            this.disconnectAll();
+        }
+    }
+    unobserveAllElements() {
+        this.disconnectAll();
+        this.items = [];
+        this.elementMap = {};
+    }
+    normalizeElements(elements) {
+        return elements.map((el) => {
+            if (typeof el === 'string') {
+                return { id: el, threshold: 0, trackFirstImpressionOnly: true };
+            }
+            return {
+                id: el.id,
+                threshold: el.threshold ?? 0,
+                trackFirstImpressionOnly: el.trackFirstImpressionOnly ?? true,
+            };
+        });
+    }
+    getObserverForThreshold(threshold) {
+        if (!this.thresholdMap[threshold]) {
+            this.thresholdMap[threshold] = new IntersectionObserver(this.handleIntersectionChanges, {
+                rootMargin: this.rootMargin,
+                threshold: [threshold],
+            });
+        }
+        return this.thresholdMap[threshold];
+    }
+    handleIntersectionChanges(entries) {
+        entries.forEach((entry) => {
+            if (!entry.isIntersecting)
+                return;
+            const id = entry.target.id;
+            if (!id)
+                return;
+            const item = this.items.find((i) => i.id === id);
+            if (!item)
+                return;
+            if (item.trackFirstImpressionOnly && this.impressedIds.has(id))
+                return;
+            this.impressedIds.add(id);
+            const prefix = this.attributePrefix;
+            const attrParams = {};
+            for (let i = 0; i < entry.target.attributes.length; i++) {
+                const attr = entry.target.attributes[i];
+                if (attr.name.startsWith(prefix)) {
+                    const key = attr.name.slice(prefix.length).replace(/-/g, '_');
+                    attrParams[key] = attr.value;
+                }
+            }
+            let params = {
+                element_id: id,
+                ...attrParams,
+            };
+            if (this.hitFilter) {
+                const filtered = this.hitFilter(params, entry.target);
+                if (filtered === null)
+                    return;
+                params = filtered;
+            }
+            this.send(this.eventName, params);
+            if (item.trackFirstImpressionOnly && this.thresholdMap[item.threshold]) {
+                this.thresholdMap[item.threshold].unobserve(entry.target);
+            }
+        });
+    }
+    handleDomMutations(mutations) {
+        mutations.forEach((mutation) => {
+            mutation.addedNodes.forEach((node) => {
+                if (node.nodeType !== Node.ELEMENT_NODE)
+                    return;
+                this.walkNodeTree(node, (id) => {
+                    const element = document.getElementById(id);
+                    if (element) {
+                        this.elementMap[id] = element;
+                        const item = this.items.find((i) => i.id === id);
+                        if (item && this.thresholdMap[item.threshold]) {
+                            this.thresholdMap[item.threshold].observe(element);
+                        }
+                    }
+                });
+            });
+            mutation.removedNodes.forEach((node) => {
+                if (node.nodeType !== Node.ELEMENT_NODE)
+                    return;
+                this.walkNodeTree(node, (id) => {
+                    const element = this.elementMap[id];
+                    if (element) {
+                        const item = this.items.find((i) => i.id === id);
+                        if (item && this.thresholdMap[item.threshold]) {
+                            this.thresholdMap[item.threshold].unobserve(element);
+                        }
+                    }
+                    this.elementMap[id] = null;
+                });
+            });
+        });
+    }
+    walkNodeTree(node, callback) {
+        if (node.id && node.id in this.elementMap) {
+            callback(node.id);
+        }
+        for (let i = 0; i < node.children.length; i++) {
+            this.walkNodeTree(node.children[i], callback);
+        }
+    }
+    disconnectAll() {
+        Object.values(this.thresholdMap).forEach((observer) => observer.disconnect());
+        this.thresholdMap = {};
+        if (this.mutationObserver) {
+            this.mutationObserver.disconnect();
+            this.mutationObserver = null;
+        }
+    }
+    remove() {
+        this.unobserveAllElements();
+        this.impressedIds.clear();
+    }
+}
+exports.ImpressionTracker = ImpressionTracker;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW1wcmVzc2lvbi10cmFja2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3BsdWdpbnMvaW1wcmVzc2lvbi10cmFja2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLG9EQUFnRDtBQVFoRDs7Ozs7O0dBTUc7QUFDSCxNQUFhLGlCQUFpQjtJQUNsQixJQUFJLENBQWU7SUFDbkIsVUFBVSxDQUFTO0lBQ25CLGVBQWUsQ0FBUztJQUN4QixTQUFTLENBQVM7SUFDbEIsU0FBUyxDQUF5QztJQUNsRCxLQUFLLEdBQXFCLEVBQUUsQ0FBQztJQUM3QixVQUFVLEdBQW1DLEVBQUUsQ0FBQztJQUNoRCxZQUFZLEdBQXlDLEVBQUUsQ0FBQztJQUN4RCxnQkFBZ0IsR0FBNEIsSUFBSSxDQUFDO0lBQ2pELFlBQVksR0FBZ0IsSUFBSSxHQUFHLEVBQUUsQ0FBQztJQUN0QyxTQUFTLENBQVU7SUFFM0IsWUFBWSxJQUFrQixFQUFFLE9BQWtDO1FBQzlELElBQUksQ0FBQyxTQUFTO1lBQ1YsT0FBTyxvQkFBb0IsS0FBSyxXQUFXO2dCQUMzQyxPQUFPLGdCQUFnQixLQUFLLFdBQVcsQ0FBQztRQUU1QyxJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQztRQUNqQixJQUFJLENBQUMsVUFBVSxHQUFHLE9BQU8sRUFBRSxVQUFVLElBQUksS0FBSyxDQUFDO1FBQy9DLElBQUksQ0FBQyxlQUFlLEdBQUcsT0FBTyxFQUFFLGVBQWUsSUFBSSxXQUFXLENBQUM7UUFDL0QsSUFBSSxDQUFDLFNBQVMsR0FBRyxPQUFPLEVBQUUsU0FBUyxJQUFJLG9CQUFvQixDQUFDO1FBQzVELElBQUksQ0FBQyxTQUFTLEdBQUcsT0FBTyxFQUFFLFNBQVMsQ0FBQztRQUVwQyxJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVM7WUFBRSxPQUFPO1FBRTVCLElBQUksQ0FBQyx5QkFBeUIsR0FBRyxJQUFJLENBQUMseUJBQXlCLENBQUMsSUFBSSxDQUFDLElBQUks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

package/build/main/plugins/index.d.ts

@@ -0,0 +1,8 @@
+export { EventTracker } from './event-tracker';
+export { OutboundLinkTracker } from './outbound-link-tracker';
+export { OutboundFormTracker } from './outbound-form-tracker';
+export { PageVisibilityTracker } from './page-visibility-tracker';
+export { UrlChangeTracker } from './url-change-tracker';
+export { ImpressionTracker } from './impression-tracker';
+export { CleanUrlTracker } from './clean-url-tracker';
+export { MediaQueryTracker } from './media-query-tracker';

package/build/main/plugins/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MediaQueryTracker = exports.CleanUrlTracker = exports.ImpressionTracker = exports.UrlChangeTracker = exports.PageVisibilityTracker = exports.OutboundFormTracker = exports.OutboundLinkTracker = exports.EventTracker = void 0;
+var event_tracker_1 = require("./event-tracker");
+Object.defineProperty(exports, "EventTracker", { enumerable: true, get: function () { return event_tracker_1.EventTracker; } });
+var outbound_link_tracker_1 = require("./outbound-link-tracker");
+Object.defineProperty(exports, "OutboundLinkTracker", { enumerable: true, get: function () { return outbound_link_tracker_1.OutboundLinkTracker; } });
+var outbound_form_tracker_1 = require("./outbound-form-tracker");
+Object.defineProperty(exports, "OutboundFormTracker", { enumerable: true, get: function () { return outbound_form_tracker_1.OutboundFormTracker; } });
+var page_visibility_tracker_1 = require("./page-visibility-tracker");
+Object.defineProperty(exports, "PageVisibilityTracker", { enumerable: true, get: function () { return page_visibility_tracker_1.PageVisibilityTracker; } });
+var url_change_tracker_1 = require("./url-change-tracker");
+Object.defineProperty(exports, "UrlChangeTracker", { enumerable: true, get: function () { return url_change_tracker_1.UrlChangeTracker; } });
+var impression_tracker_1 = require("./impression-tracker");
+Object.defineProperty(exports, "ImpressionTracker", { enumerable: true, get: function () { return impression_tracker_1.ImpressionTracker; } });
+var clean_url_tracker_1 = require("./clean-url-tracker");
+Object.defineProperty(exports, "CleanUrlTracker", { enumerable: true, get: function () { return clean_url_tracker_1.CleanUrlTracker; } });
+var media_query_tracker_1 = require("./media-query-tracker");
+Object.defineProperty(exports, "MediaQueryTracker", { enumerable: true, get: function () { return media_query_tracker_1.MediaQueryTracker; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvcGx1Z2lucy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxpREFBK0M7QUFBdEMsNkdBQUEsWUFBWSxPQUFBO0FBQ3JCLGlFQUE4RDtBQUFyRCw0SEFBQSxtQkFBbUIsT0FBQTtBQUM1QixpRUFBOEQ7QUFBckQsNEhBQUEsbUJBQW1CLE9BQUE7QUFDNUIscUVBQWtFO0FBQXpELGdJQUFBLHFCQUFxQixPQUFBO0FBQzlCLDJEQUF3RDtBQUEvQyxzSEFBQSxnQkFBZ0IsT0FBQTtBQUN6QiwyREFBeUQ7QUFBaEQsdUhBQUEsaUJBQWlCLE9BQUE7QUFDMUIseURBQXNEO0FBQTdDLG9IQUFBLGVBQWUsT0FBQTtBQUN4Qiw2REFBMEQ7QUFBakQsd0hBQUEsaUJBQWlCLE9BQUEifQ==

package/build/main/plugins/media-query-tracker.d.ts

@@ -0,0 +1,20 @@
+import { GA4Plugin, SendFunction, MediaQueryTrackerOptions } from '../types/plugins';
+/**
+ * Tracks CSS media query breakpoint matching and changes.
+ *
+ * Fires an event whenever the active breakpoint changes
+ * (e.g. from "mobile" to "desktop"), debounced to avoid
+ * rapid-fire events during window resizing.
+ */
+export declare class MediaQueryTracker implements GA4Plugin {
+    private send;
+    private changeTimeout;
+    private eventName;
+    private changeTemplate?;
+    private hitFilter?;
+    private trackedQueries;
+    private debouncedHandlers;
+    constructor(send: SendFunction, options?: MediaQueryTrackerOptions);
+    private trackDefinition;
+    remove(): void;
+}

package/build/main/plugins/media-query-tracker.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MediaQueryTracker = void 0;
+const debounce_1 = require("../helpers/debounce");
+function getMatchingValue(definition) {
+    for (const item of definition.items) {
+        if (window.matchMedia(item.media).matches) {
+            return item.name;
+        }
+    }
+    return '(not set)';
+}
+/**
+ * Tracks CSS media query breakpoint matching and changes.
+ *
+ * Fires an event whenever the active breakpoint changes
+ * (e.g. from "mobile" to "desktop"), debounced to avoid
+ * rapid-fire events during window resizing.
+ */
+class MediaQueryTracker {
+    send;
+    changeTimeout;
+    eventName;
+    changeTemplate;
+    hitFilter;
+    trackedQueries = [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    debouncedHandlers = [];
+    constructor(send, options) {
+        this.send = send;
+        this.changeTimeout = options?.changeTimeout ?? 1000;
+        this.eventName = options?.eventName ?? 'media_query_change';
+        this.changeTemplate = options?.changeTemplate;
+        this.hitFilter = options?.hitFilter;
+        if (typeof window.matchMedia !== 'function')
+            return;
+        const definitions = options?.definitions ?? [];
+        definitions.forEach((definition) => {
+            this.trackDefinition(definition);
+        });
+    }
+    trackDefinition(definition) {
+        const initialValue = getMatchingValue(definition);
+        definition.items.forEach((item) => {
+            const mql = window.matchMedia(item.media);
+            const debouncedHandler = (0, debounce_1.debounce)(() => {
+                const newValue = getMatchingValue(definition);
+                const tracked = this.trackedQueries.find((tq) => tq.definition === definition);
+                if (!tracked || newValue === tracked.currentValue)
+                    return;
+                const oldValue = tracked.currentValue;
+                tracked.currentValue = newValue;
+                const changeLabel = this.changeTemplate
+                    ? this.changeTemplate(oldValue, newValue)
+                    : `${oldValue} => ${newValue}`;
+                let params = {
+                    media_query_name: definition.name,
+                    media_query_value: newValue,
+                    media_query_change: changeLabel,
+                };
+                if (this.hitFilter) {
+                    const filtered = this.hitFilter(params);
+                    if (filtered === null)
+                        return;
+                    params = filtered;
+                }
+                this.send(this.eventName, params);
+            }, this.changeTimeout);
+            this.debouncedHandlers.push(debouncedHandler);
+            const listener = () => {
+                debouncedHandler();
+            };
+            if (typeof mql.addEventListener === 'function') {
+                mql.addEventListener('change', listener);
+            }
+            this.trackedQueries.push({
+                definition,
+                mql,
+                currentValue: initialValue,
+                listener,
+            });
+        });
+    }
+    remove() {
+        this.trackedQueries.forEach(({ mql, listener }) => {
+            if (typeof mql.removeEventListener === 'function') {
+                mql.removeEventListener('change', listener);
+            }
+        });
+        this.debouncedHandlers.forEach((d) => d.cancel());
+        this.trackedQueries = [];
+        this.debouncedHandlers = [];
+    }
+}
+exports.MediaQueryTracker = MediaQueryTracker;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVkaWEtcXVlcnktdHJhY2tlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9wbHVnaW5zL21lZGlhLXF1ZXJ5LXRyYWNrZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQ0Esa0RBQWtFO0FBU2xFLFNBQVMsZ0JBQWdCLENBQUMsVUFBZ0M7SUFDdEQsS0FBSyxNQUFNLElBQUksSUFBSSxVQUFVLENBQUMsS0FBSyxFQUFFO1FBQ2pDLElBQUksTUFBTSxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUMsT0FBTyxFQUFFO1lBQ3ZDLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQztTQUNwQjtLQUNKO0lBQ0QsT0FBTyxXQUFXLENBQUM7QUFDdkIsQ0FBQztBQUVEOzs7Ozs7R0FNRztBQUNILE1BQWEsaUJBQWlCO0lBQ2xCLElBQUksQ0FBZTtJQUNuQixhQUFhLENBQVM7SUFDdEIsU0FBUyxDQUFTO0lBQ2xCLGNBQWMsQ0FBOEM7SUFDNUQsU0FBUyxDQUF5QztJQUNsRCxjQUFjLEdBQW1CLEVBQUUsQ0FBQztJQUM1Qyw4REFBOEQ7SUFDdEQsaUJBQWlCLEdBQTZCLEVBQUUsQ0FBQztJQUV6RCxZQUFZLElBQWtCLEVBQUUsT0FBa0M7UUFDOUQsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUM7UUFDakIsSUFBSSxDQUFDLGFBQWEsR0FBRyxPQUFPLEVBQUUsYUFBYSxJQUFJLElBQUksQ0FBQztRQUNwRCxJQUFJLENBQUMsU0FBUyxHQUFHLE9BQU8sRUFBRSxTQUFTLElBQUksb0JBQW9CLENBQUM7UUFDNUQsSUFBSSxDQUFDLGNBQWMsR0FBRyxPQUFPLEVBQUUsY0FBYyxDQUFDO1FBQzlDLElBQUksQ0FBQyxTQUFTLEdBQUcsT0FBTyxFQUFFLFNBQVMsQ0FBQztRQUVwQyxJQUFJLE9BQU8sTUFBTSxDQUFDLFVBQVUsS0FBSyxVQUFVO1lBQUUsT0FBTztRQUVwRCxNQUFNLFdBQVcsR0FBRyxPQUFP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

package/build/main/plugins/outbound-form-tracker.d.ts

@@ -0,0 +1,17 @@
+import { GA4Plugin, SendFunction, OutboundFormTrackerOptions } from '../types/plugins';
+/**
+ * Automatically tracks form submissions to external domains.
+ *
+ * Sends an event when a form's `action` attribute points to a
+ * different hostname than the current page.
+ */
+export declare class OutboundFormTracker implements GA4Plugin {
+    private delegateHandle;
+    private send;
+    private eventName;
+    private shouldTrackOutboundForm;
+    private hitFilter?;
+    constructor(send: SendFunction, options?: OutboundFormTrackerOptions);
+    private handleFormSubmit;
+    remove(): void;
+}

package/build/main/plugins/outbound-form-tracker.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutboundFormTracker = void 0;
+const delegate_1 = require("../helpers/delegate");
+const parse_url_1 = require("../helpers/parse-url");
+function defaultShouldTrack(form, parseUrlFn) {
+    const action = form.action;
+    if (!action)
+        return false;
+    const url = parseUrlFn(action);
+    return url.hostname !== location.hostname && url.protocol.startsWith('http');
+}
+/**
+ * Automatically tracks form submissions to external domains.
+ *
+ * Sends an event when a form's `action` attribute points to a
+ * different hostname than the current page.
+ */
+class OutboundFormTracker {
+    delegateHandle;
+    send;
+    eventName;
+    shouldTrackOutboundForm;
+    hitFilter;
+    constructor(send, options) {
+        this.send = send;
+        this.eventName = options?.eventName ?? 'outbound_form_submit';
+        this.shouldTrackOutboundForm = options?.shouldTrackOutboundForm ?? defaultShouldTrack;
+        this.hitFilter = options?.hitFilter;
+        const formSelector = options?.formSelector ?? 'form';
+        this.delegateHandle = (0, delegate_1.delegate)(document, 'submit', formSelector, (event, element) => this.handleFormSubmit(event, element), { composed: true, useCapture: true });
+    }
+    handleFormSubmit(event, form) {
+        if (!this.shouldTrackOutboundForm(form, parse_url_1.parseUrl))
+            return;
+        const url = (0, parse_url_1.parseUrl)(form.action);
+        let params = {
+            form_action: url.href,
+            form_domain: url.hostname,
+            outbound: true,
+        };
+        if (this.hitFilter) {
+            const filtered = this.hitFilter(params, form, event);
+            if (filtered === null)
+                return;
+            params = filtered;
+        }
+        this.send(this.eventName, params);
+    }
+    remove() {
+        this.delegateHandle.destroy();
+    }
+}
+exports.OutboundFormTracker = OutboundFormTracker;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3V0Ym91bmQtZm9ybS10cmFja2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3BsdWdpbnMvb3V0Ym91bmQtZm9ybS10cmFja2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLGtEQUErRDtBQUMvRCxvREFBZ0Q7QUFFaEQsU0FBUyxrQkFBa0IsQ0FBQyxJQUFxQixFQUFFLFVBQWlGO0lBQ2hJLE1BQU0sTUFBTSxHQUFHLElBQUksQ0FBQyxNQUFNLENBQUM7SUFDM0IsSUFBSSxDQUFDLE1BQU07UUFBRSxPQUFPLEtBQUssQ0FBQztJQUMxQixNQUFNLEdBQUcsR0FBRyxVQUFVLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDL0IsT0FBTyxHQUFHLENBQUMsUUFBUSxLQUFLLFFBQVEsQ0FBQyxRQUFRLElBQUksR0FBRyxDQUFDLFFBQVEsQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLENBQUM7QUFDakYsQ0FBQztBQUVEOzs7OztHQUtHO0FBQ0gsTUFBYSxtQkFBbUI7SUFDcEIsY0FBYyxDQUFpQjtJQUMvQixJQUFJLENBQWU7SUFDbkIsU0FBUyxDQUFTO0lBQ2xCLHVCQUF1QixDQUFxRTtJQUM1RixTQUFTLENBQTJDO0lBRTVELFlBQVksSUFBa0IsRUFBRSxPQUFvQztRQUNoRSxJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQztRQUNqQixJQUFJLENBQUMsU0FBUyxHQUFHLE9BQU8sRUFBRSxTQUFTLElBQUksc0JBQXNCLENBQUM7UUFDOUQsSUFBSSxDQUFDLHVCQUF1QixHQUFHLE9BQU8sRUFBRSx1QkFBdUIsSUFBSSxrQkFBa0IsQ0FBQztRQUN0RixJQUFJLENBQUMsU0FBUyxHQUFHLE9BQU8sRUFBRSxTQUFTLENBQUM7UUFFcEMsTUFBTSxZQUFZLEdBQUcsT0FBTyxFQUFFLFlBQVksSUFBSSxNQUFNLENBQUM7UUFFckQsSUFBSSxDQUFDLGNBQWMsR0FBRyxJQUFBLG1CQUFRLEVBQzFCLFFBQVEsRUFDUixRQUFRLEVBQ1IsWUFBWSxFQUNaLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSxFQUFFLENBQUMsSUFBSSxDQUFDLGdCQUFnQixDQUFDLEtBQUssRUFBRSxPQUEwQixDQUFDLEVBQzVFLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxVQUFVLEVBQUUsSUFBSSxFQUFFLENBQ3ZDLENBQUM7SUFDTixDQUFDO0lBRU8sZ0JBQWdCLENBQUMsS0FBWSxFQUFFLElBQXFCO1FBQ3hELElBQUksQ0FBQyxJQUFJLENBQUMsdUJBQXVCLENBQUMsSUFBSSxFQUFFLG9CQUFRLENBQUM7WUFBRSxPQUFPO1FBRTFELE1BQU0sR0FBRyxHQUFHLElBQUEsb0JBQVEsRUFBQyxJQUFJLENBQUMsTUFBTSxDQUFDLENBQUM7UUFFbEMsSUFBSSxNQUFNLEdBQTRCO1lBQ2xDLFdBQVcsRUFBRSxHQUFHLENBQUMsSUFBSTtZQUNyQixXQUFXLEVBQUUsR0FBRyxDQUFDLFFBQVE7WUFDekIsUUFBUSxFQUFFLElBQUk7U0FDakIsQ0FBQztRQUVGLElBQUksSUFBSSxDQUFDLFNBQVMsRUFBRTtZQUNoQixNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsS0FBSyxDQUFDLENBQUM7WUFDckQsSUFBSSxRQUFRLEtBQUssSUFBSTtnQkFBRSxPQUFPO1lBQzlCLE1BQU0sR0FBRyxRQUFRLENBQUM7U0FDckI7UUFFRCxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsTUFBTSxDQUFDLENBQUM7SUFDdEMsQ0FBQztJQUVELE1BQU07UUFDRixJQUFJLENBQUMsY0FBYyxDQUFDLE9BQU8sRUFBRSxDQUFDO0lBQ2xDLENBQUM7Q0FDSjtBQS9DRCxrREErQ0MifQ==

package/build/main/plugins/outbound-link-tracker.d.ts

@@ -0,0 +1,19 @@
+import { GA4Plugin, SendFunction, OutboundLinkTrackerOptions } from '../types/plugins';
+/**
+ * Automatically tracks clicks on outbound links (links to external domains).
+ *
+ * Sends an event when a user clicks a link whose hostname differs
+ * from the current page's hostname.
+ */
+export declare class OutboundLinkTracker implements GA4Plugin {
+    private delegates;
+    private send;
+    private events;
+    private linkSelector;
+    private eventName;
+    private shouldTrackOutboundLink;
+    private hitFilter?;
+    constructor(send: SendFunction, options?: OutboundLinkTrackerOptions);
+    private handleLinkInteraction;
+    remove(): void;
+}

package/build/main/plugins/outbound-link-tracker.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutboundLinkTracker = void 0;
+const delegate_1 = require("../helpers/delegate");
+const parse_url_1 = require("../helpers/parse-url");
+function defaultShouldTrack(link, parseUrlFn) {
+    const href = link.getAttribute('href') || link.getAttribute('xlink:href');
+    if (!href)
+        return false;
+    const url = parseUrlFn(href);
+    return url.hostname !== location.hostname && url.protocol.startsWith('http');
+}
+/**
+ * Automatically tracks clicks on outbound links (links to external domains).
+ *
+ * Sends an event when a user clicks a link whose hostname differs
+ * from the current page's hostname.
+ */
+class OutboundLinkTracker {
+    delegates = [];
+    send;
+    events;
+    linkSelector;
+    eventName;
+    shouldTrackOutboundLink;
+    hitFilter;
+    constructor(send, options) {
+        this.send = send;
+        this.events = options?.events ?? ['click'];
+        this.linkSelector = options?.linkSelector ?? 'a, area';
+        this.eventName = options?.eventName ?? 'outbound_link_click';
+        this.shouldTrackOutboundLink = options?.shouldTrackOutboundLink ?? defaultShouldTrack;
+        this.hitFilter = options?.hitFilter;
+        this.events.forEach((eventType) => {
+            const handle = (0, delegate_1.delegate)(document, eventType, this.linkSelector, (event, element) => this.handleLinkInteraction(event, element), { composed: true, useCapture: true });
+            this.delegates.push(handle);
+        });
+    }
+    handleLinkInteraction(event, element) {
+        if (!this.shouldTrackOutboundLink(element, parse_url_1.parseUrl))
+            return;
+        const href = element.getAttribute('href') || element.getAttribute('xlink:href') || '';
+        const url = (0, parse_url_1.parseUrl)(href);
+        let params = {
+            link_url: url.href,
+            link_domain: url.hostname,
+            outbound: true,
+        };
+        if (this.hitFilter) {
+            const filtered = this.hitFilter(params, element, event);
+            if (filtered === null)
+                return;
+            params = filtered;
+        }
+        this.send(this.eventName, params);
+    }
+    remove() {
+        this.delegates.forEach((d) => d.destroy());
+        this.delegates = [];
+    }
+}
+exports.OutboundLinkTracker = OutboundLinkTracker;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3V0Ym91bmQtbGluay10cmFja2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3BsdWdpbnMvb3V0Ym91bmQtbGluay10cmFja2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLGtEQUErRDtBQUMvRCxvREFBZ0Q7QUFFaEQsU0FBUyxrQkFBa0IsQ0FBQyxJQUFhLEVBQUUsVUFBaUY7SUFDeEgsTUFBTSxJQUFJLEdBQUcsSUFBSSxDQUFDLFlBQVksQ0FBQyxNQUFNLENBQUMsSUFBSSxJQUFJLENBQUMsWUFBWSxDQUFDLFlBQVksQ0FBQyxDQUFDO0lBQzFFLElBQUksQ0FBQyxJQUFJO1FBQUUsT0FBTyxLQUFLLENBQUM7SUFDeEIsTUFBTSxHQUFHLEdBQUcsVUFBVSxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQzdCLE9BQU8sR0FBRyxDQUFDLFFBQVEsS0FBSyxRQUFRLENBQUMsUUFBUSxJQUFJLEdBQUcsQ0FBQyxRQUFRLENBQUMsVUFBVSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0FBQ2pGLENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILE1BQWEsbUJBQW1CO0lBQ3BCLFNBQVMsR0FBcUIsRUFBRSxDQUFDO0lBQ2pDLElBQUksQ0FBZTtJQUNuQixNQUFNLENBQVc7SUFDakIsWUFBWSxDQUFTO0lBQ3JCLFNBQVMsQ0FBUztJQUNsQix1QkFBdUIsQ0FBcUU7SUFDNUYsU0FBUyxDQUEyQztJQUU1RCxZQUFZLElBQWtCLEVBQUUsT0FBb0M7UUFDaEUsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUM7UUFDakIsSUFBSSxDQUFDLE1BQU0sR0FBRyxPQUFPLEVBQUUsTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDM0MsSUFBSSxDQUFDLFlBQVksR0FBRyxPQUFPLEVBQUUsWUFBWSxJQUFJLFNBQVMsQ0FBQztRQUN2RCxJQUFJLENBQUMsU0FBUyxHQUFHLE9BQU8sRUFBRSxTQUFTLElBQUkscUJBQXFCLENBQUM7UUFDN0QsSUFBSSxDQUFDLHVCQUF1QixHQUFHLE9BQU8sRUFBRSx1QkFBdUIsSUFBSSxrQkFBa0IsQ0FBQztRQUN0RixJQUFJLENBQUMsU0FBUyxHQUFHLE9BQU8sRUFBRSxTQUFTLENBQUM7UUFFcEMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxPQUFPLENBQUMsQ0FBQyxTQUFTLEVBQUUsRUFBRTtZQUM5QixNQUFNLE1BQU0sR0FBRyxJQUFBLG1CQUFRLEVBQ25CLFFBQVEsRUFDUixTQUFTLEVBQ1QsSUFBSSxDQUFDLFlBQVksRUFDakIsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLEVBQUUsQ0FBQyxJQUFJLENBQUMscUJBQXFCLENBQUMsS0FBSyxFQUFFLE9BQU8sQ0FBQyxFQUM5RCxFQUFFLFFBQVEsRUFBRSxJQUFJLEVBQUUsVUFBVSxFQUFFLElBQUksRUFBRSxDQUN2QyxDQUFDO1lBQ0YsSUFBSSxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDaEMsQ0FBQyxDQUFDLENBQUM7SUFDUCxDQUFDO0lBRU8scUJBQXFCLENBQUMsS0FBWSxFQUFFLE9BQWdCO1FBQ3hELElBQUksQ0FBQyxJQUFJLENBQUMsdUJBQXVCLENBQUMsT0FBTyxFQUFFLG9CQUFRLENBQUM7WUFBRSxPQUFPO1FBRTdELE1BQU0sSUFBSSxHQUFHLE9BQU8sQ0FBQyxZQUFZLENBQUMsTUFBTSxDQUFDLElBQUksT0FBTyxDQUFDLFlBQVksQ0FBQyxZQUFZLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDdEYsTUFBTSxHQUFHLEdBQUcsSUFBQSxvQkFBUSxFQUFDLElBQUksQ0FBQyxDQUFDO1FBRTNCLElBQUksTUFBTSxHQUE0QjtZQUNsQyxRQUFRLEVBQUUsR0FBRyxDQUFDLElBQUk7WUFDbEIsV0FBVyxFQUFFLEdBQUcsQ0FBQyxRQUFRO1lBQ3pCLFFBQVEsRUFBRSxJQUFJO1NBQ2pCLENBQUM7UUFFRixJQUFJLElBQUksQ0FBQyxTQUFTLEVBQUU7WUFDaEIsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxNQUFNLEVBQUUsT0FBTyxFQUFFLEtBQUssQ0FBQyxDQUFDO1lBQ3hELElBQUksUUFBUSxLQUFLLElBQUk7Z0JBQUUsT0FBTztZQUM5QixNQUFNLEdBQUcsUUFBUSxDQUFDO1NBQ3JCO1FBRUQsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ3RDLENBQUM7SUFFRCxNQUFNO1FBQ0YsSUFBSSxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQUFDO1FBQzNDLElBQUksQ0FBQyxTQUFTLEdBQUcsRUFBRSxDQUFDO0lBQ3hCLENBQUM7Q0FDSjtBQXRERCxrREFzREMifQ==

package/build/main/plugins/page-visibility-tracker.d.ts

@@ -0,0 +1,24 @@
+import { GA4Plugin, SendFunction, PageVisibilityTrackerOptions } from '../types/plugins';
+/**
+ * Tracks how long a page is in the visible state vs. hidden (background tab).
+ *
+ * Sends a `page_visibility` event each time the visibility state changes,
+ * reporting how long the page was in the previous state.
+ * Optionally sends a new `page_view` when the page becomes visible
+ * again after the session timeout has elapsed.
+ */
+export declare class PageVisibilityTracker implements GA4Plugin {
+    private send;
+    private sendInitialPageview;
+    private sessionTimeout;
+    private eventName;
+    private hitFilter?;
+    private lastChangeTime;
+    private isVisible;
+    private boundVisibilityChange;
+    private boundBeforeUnload;
+    constructor(send: SendFunction, options?: PageVisibilityTrackerOptions);
+    private onVisibilityChange;
+    private onBeforeUnload;
+    remove(): void;
+}