@technoapple/ga4 1.0.3 → 1.1.0

package/build/main/ga4/ga4.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ga4 = void 0;
 class ga4 {
     static instance;
+    _plugins = [];
     constructor() {
     }
     init(option) {
@@ -23,9 +24,31 @@ class ga4 {
         window.gtag('event', eventName, eventParameters);
         return true;
     }
+    /**
+     * Register a plugin with the GA4 instance.
+     * @param PluginClass The plugin class constructor
+     * @param options Plugin-specific configuration options
+     * @returns The plugin instance (call `.remove()` to unregister)
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    use(PluginClass, options) {
+        const send = (eventName, params) => {
+            window.gtag('event', eventName, params);
+        };
+        const plugin = new PluginClass(send, options);
+        this._plugins.push(plugin);
+        return plugin;
+    }
+    /**
+     * Remove all registered plugins and clean up their listeners.
+     */
+    removeAll() {
+        this._plugins.forEach(p => p.remove());
+        this._plugins = [];
+    }
     get gtag() {
         return window.gtag;
     }
 }
 exports.ga4 = ga4;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2E0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2dhNC9nYTQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBS0EsTUFBTSxHQUFHO0lBRUcsTUFBTSxDQUFDLFFBQVEsQ0FBTTtJQUU3QjtJQUNBLENBQUM7SUFFTSxJQUFJLENBQUMsTUFBZ0I7UUFDeEIsTUFBTSxDQUFDLFNBQVMsR0FBRyxNQUFNLENBQUMsU0FBUyxLQUFJLEtBQXNCLENBQUEsQ0FBQztRQUM5RCxNQUFNLENBQUMsSUFBSSxHQUFHLE1BQU0sQ0FBQyxJQUFJLElBQUk7WUFDekIsTUFBTSxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUM7UUFDckMsQ0FBQyxDQUFBO1FBQ0QsTUFBTSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsSUFBSSxJQUFJLEVBQUUsQ0FBQyxDQUFDO1FBQzlCLE1BQU0sQ0FBQyxJQUFJLENBQUMsUUFBUSxFQUFFLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUMzQyxDQUFDO0lBRU0sTUFBTSxDQUFDLFdBQVc7UUFDckIsSUFBSSxDQUFDLEdBQUcsQ0FBQyxRQUFRLEVBQUU7WUFDZixHQUFHLENBQUMsUUFBUSxHQUFHLElBQUksR0FBRyxFQUFFLENBQUM7U0FDNUI7UUFDRCxPQUFPLEdBQUcsQ0FBQyxRQUFRLENBQUM7SUFDeEIsQ0FBQztJQUVNLElBQUksQ0FBQyxTQUFnQixFQUFFLGVBQStCO1FBRXpELE1BQU0sQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLFNBQVMsRUFBRSxlQUFlLENBQUMsQ0FBQztRQUVqRCxPQUFPLElBQUksQ0FBQztJQUNoQixDQUFDO0lBRUQsSUFBSSxJQUFJO1FBQ0osT0FBTyxNQUFNLENBQUMsSUFBSSxDQUFDO0lBQ3ZCLENBQUM7Q0FDSjtBQUVPLGtCQUFHIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2E0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2dhNC9nYTQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBTUEsTUFBTSxHQUFHO0lBRUcsTUFBTSxDQUFDLFFBQVEsQ0FBTTtJQUNyQixRQUFRLEdBQWdCLEVBQUUsQ0FBQztJQUVuQztJQUNBLENBQUM7SUFFTSxJQUFJLENBQUMsTUFBZ0I7UUFDeEIsTUFBTSxDQUFDLFNBQVMsR0FBRyxNQUFNLENBQUMsU0FBUyxLQUFJLEtBQXNCLENBQUEsQ0FBQztRQUM5RCxNQUFNLENBQUMsSUFBSSxHQUFHLE1BQU0sQ0FBQyxJQUFJLElBQUk7WUFDekIsTUFBTSxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUM7UUFDckMsQ0FBQyxDQUFBO1FBQ0QsTUFBTSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsSUFBSSxJQUFJLEVBQUUsQ0FBQyxDQUFDO1FBQzlCLE1BQU0sQ0FBQyxJQUFJLENBQUMsUUFBUSxFQUFFLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUMzQyxDQUFDO0lBRU0sTUFBTSxDQUFDLFdBQVc7UUFDckIsSUFBSSxDQUFDLEdBQUcsQ0FBQyxRQUFRLEVBQUU7WUFDZixHQUFHLENBQUMsUUFBUSxHQUFHLElBQUksR0FBRyxFQUFFLENBQUM7U0FDNUI7UUFDRCxPQUFPLEdBQUcsQ0FBQyxRQUFRLENBQUM7SUFDeEIsQ0FBQztJQUVNLElBQUksQ0FBQyxTQUFnQixFQUFFLGVBQStCO1FBRXpELE1BQU0sQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLFNBQVMsRUFBRSxlQUFlLENBQUMsQ0FBQztRQUVqRCxPQUFPLElBQUksQ0FBQztJQUNoQixDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCw4REFBOEQ7SUFDdkQsR0FBRyxDQUNOLFdBQXlELEVBQ3pELE9BQWE7UUFFYixNQUFNLElBQUksR0FBaUIsQ0FBQyxTQUFpQixFQUFFLE1BQStCLEVBQUUsRUFBRTtZQUM5RSxNQUFNLENBQUMsSUFBSSxDQUFDLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBd0IsQ0FBQyxDQUFDO1FBQzlELENBQUMsQ0FBQztRQUNGLE1BQU0sTUFBTSxHQUFHLElBQUksV0FBVyxDQUFDLElBQUksRUFBRSxPQUFPLENBQUMsQ0FBQztRQUM5QyxJQUFJLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQztRQUMzQixPQUFPLE1BQU0sQ0FBQztJQUNsQixDQUFDO0lBRUQ7O09BRUc7SUFDSSxTQUFTO1FBQ1osSUFBSSxDQUFDLFFBQVEsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQztRQUN2QyxJQUFJLENBQUMsUUFBUSxHQUFHLEVBQUUsQ0FBQztJQUN2QixDQUFDO0lBRUQsSUFBSSxJQUFJO1FBQ0osT0FBTyxNQUFNLENBQUMsSUFBSSxDQUFDO0lBQ3ZCLENBQUM7Q0FDSjtBQUVPLGtCQUFHIn0=

package/build/main/helpers/debounce.d.ts

@@ -0,0 +1,5 @@
+export interface DebouncedFunction<T extends (...args: never[]) => void> {
+    (...args: Parameters<T>): void;
+    cancel(): void;
+}
+export declare function debounce<T extends (...args: never[]) => void>(fn: T, delay: number): DebouncedFunction<T>;

package/build/main/helpers/debounce.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debounce = void 0;
+function debounce(fn, delay) {
+    let timer = null;
+    const debounced = function (...args) {
+        if (timer !== null)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = null;
+            fn.apply(this, args);
+        }, delay);
+    };
+    debounced.cancel = () => {
+        if (timer !== null) {
+            clearTimeout(timer);
+            timer = null;
+        }
+    };
+    return debounced;
+}
+exports.debounce = debounce;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVib3VuY2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvaGVscGVycy9kZWJvdW5jZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFLQSxTQUFnQixRQUFRLENBQ3BCLEVBQUssRUFDTCxLQUFhO0lBRWIsSUFBSSxLQUFLLEdBQXlDLElBQUksQ0FBQztJQUV2RCxNQUFNLFNBQVMsR0FBRyxVQUF5QixHQUFHLElBQW1CO1FBQzdELElBQUksS0FBSyxLQUFLLElBQUk7WUFBRSxZQUFZLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDeEMsS0FBSyxHQUFHLFVBQVUsQ0FBQyxHQUFHLEVBQUU7WUFDcEIsS0FBSyxHQUFHLElBQUksQ0FBQztZQUNiLEVBQUUsQ0FBQyxLQUFLLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQ3pCLENBQUMsRUFBRSxLQUFLLENBQUMsQ0FBQztJQUNkLENBQXlCLENBQUM7SUFFMUIsU0FBUyxDQUFDLE1BQU0sR0FBRyxHQUFHLEVBQUU7UUFDcEIsSUFBSSxLQUFLLEtBQUssSUFBSSxFQUFFO1lBQ2hCLFlBQVksQ0FBQyxLQUFLLENBQUMsQ0FBQztZQUNwQixLQUFLLEdBQUcsSUFBSSxDQUFDO1NBQ2hCO0lBQ0wsQ0FBQyxDQUFDO0lBRUYsT0FBTyxTQUFTLENBQUM7QUFDckIsQ0FBQztBQXRCRCw0QkFzQkMifQ==

package/build/main/helpers/delegate.d.ts

@@ -0,0 +1,8 @@
+export interface DelegateHandle {
+    destroy(): void;
+}
+export interface DelegateOptions {
+    composed?: boolean;
+    useCapture?: boolean;
+}
+export declare function delegate(target: EventTarget, eventType: string, selector: string, handler: (event: Event, element: Element) => void, options?: DelegateOptions): DelegateHandle;

package/build/main/helpers/delegate.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delegate = void 0;
+function delegate(target, eventType, selector, handler, options) {
+    const useCapture = options?.useCapture ?? false;
+    const listener = (event) => {
+        let element = event.target;
+        // Handle composed events (shadow DOM)
+        if (options?.composed && typeof event.composedPath === 'function') {
+            const path = event.composedPath();
+            for (const node of path) {
+                if (node === target)
+                    break;
+                if (node instanceof Element && node.matches(selector)) {
+                    handler(event, node);
+                    return;
+                }
+            }
+            return;
+        }
+        while (element && element !== target) {
+            if (element.matches(selector)) {
+                handler(event, element);
+                return;
+            }
+            element = element.parentElement;
+        }
+    };
+    target.addEventListener(eventType, listener, useCapture);
+    return {
+        destroy() {
+            target.removeEventListener(eventType, listener, useCapture);
+        },
+    };
+}
+exports.delegate = delegate;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVsZWdhdGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvaGVscGVycy9kZWxlZ2F0ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFTQSxTQUFnQixRQUFRLENBQ3BCLE1BQW1CLEVBQ25CLFNBQWlCLEVBQ2pCLFFBQWdCLEVBQ2hCLE9BQWlELEVBQ2pELE9BQXlCO0lBRXpCLE1BQU0sVUFBVSxHQUFHLE9BQU8sRUFBRSxVQUFVLElBQUksS0FBSyxDQUFDO0lBRWhELE1BQU0sUUFBUSxHQUFHLENBQUMsS0FBWSxFQUFFLEVBQUU7UUFDOUIsSUFBSSxPQUFPLEdBQW1CLEtBQUssQ0FBQyxNQUF3QixDQUFDO1FBRTdELHNDQUFzQztRQUN0QyxJQUFJLE9BQU8sRUFBRSxRQUFRLElBQUksT0FBTyxLQUFLLENBQUMsWUFBWSxLQUFLLFVBQVUsRUFBRTtZQUMvRCxNQUFNLElBQUksR0FBRyxLQUFLLENBQUMsWUFBWSxFQUFFLENBQUM7WUFDbEMsS0FBSyxNQUFNLElBQUksSUFBSSxJQUFJLEVBQUU7Z0JBQ3JCLElBQUksSUFBSSxLQUFLLE1BQU07b0JBQUUsTUFBTTtnQkFDM0IsSUFBSSxJQUFJLFlBQVksT0FBTyxJQUFJLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLEVBQUU7b0JBQ25ELE9BQU8sQ0FBQyxLQUFLLEVBQUUsSUFBSSxDQUFDLENBQUM7b0JBQ3JCLE9BQU87aUJBQ1Y7YUFDSjtZQUNELE9BQU87U0FDVjtRQUVELE9BQU8sT0FBTyxJQUFJLE9BQU8sS0FBSyxNQUFNLEVBQUU7WUFDbEMsSUFBSSxPQUFPLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxFQUFFO2dCQUMzQixPQUFPLENBQUMsS0FBSyxFQUFFLE9BQU8sQ0FBQyxDQUFDO2dCQUN4QixPQUFPO2FBQ1Y7WUFDRCxPQUFPLEdBQUcsT0FBTyxDQUFDLGFBQWEsQ0FBQztTQUNuQztJQUNMLENBQUMsQ0FBQztJQUVGLE1BQU0sQ0FBQyxnQkFBZ0IsQ0FBQyxTQUFTLEVBQUUsUUFBUSxFQUFFLFVBQVUsQ0FBQyxDQUFDO0lBRXpELE9BQU87UUFDSCxPQUFPO1lBQ0gsTUFBTSxDQUFDLG1CQUFtQixDQUFDLFNBQVMsRUFBRSxRQUFRLEVBQUUsVUFBVSxDQUFDLENBQUM7UUFDaEUsQ0FBQztLQUNKLENBQUM7QUFDTixDQUFDO0FBekNELDRCQXlDQyJ9

package/build/main/helpers/dom-ready.d.ts

@@ -0,0 +1 @@
+export declare function domReady(callback: () => void): void;

package/build/main/helpers/dom-ready.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.domReady = void 0;
+function domReady(callback) {
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', callback, { once: true });
+    }
+    else {
+        callback();
+    }
+}
+exports.domReady = domReady;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG9tLXJlYWR5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2hlbHBlcnMvZG9tLXJlYWR5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLFNBQWdCLFFBQVEsQ0FBQyxRQUFvQjtJQUN6QyxJQUFJLFFBQVEsQ0FBQyxVQUFVLEtBQUssU0FBUyxFQUFFO1FBQ25DLFFBQVEsQ0FBQyxnQkFBZ0IsQ0FBQyxrQkFBa0IsRUFBRSxRQUFRLEVBQUUsRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQztLQUMzRTtTQUFNO1FBQ0gsUUFBUSxFQUFFLENBQUM7S0FDZDtBQUNMLENBQUM7QUFORCw0QkFNQyJ9

package/build/main/helpers/parse-url.d.ts

@@ -0,0 +1,11 @@
+export interface ParsedUrl {
+    href: string;
+    protocol: string;
+    hostname: string;
+    port: string;
+    pathname: string;
+    search: string;
+    hash: string;
+    origin: string;
+}
+export declare function parseUrl(url: string): ParsedUrl;

package/build/main/helpers/parse-url.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUrl = void 0;
+function parseUrl(url) {
+    try {
+        const parsed = new URL(url, location.href);
+        return {
+            href: parsed.href,
+            protocol: parsed.protocol,
+            hostname: parsed.hostname,
+            port: parsed.port,
+            pathname: parsed.pathname,
+            search: parsed.search,
+            hash: parsed.hash,
+            origin: parsed.origin,
+        };
+    }
+    catch {
+        return {
+            href: url,
+            protocol: '',
+            hostname: '',
+            port: '',
+            pathname: url,
+            search: '',
+            hash: '',
+            origin: '',
+        };
+    }
+}
+exports.parseUrl = parseUrl;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGFyc2UtdXJsLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2hlbHBlcnMvcGFyc2UtdXJsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQVdBLFNBQWdCLFFBQVEsQ0FBQyxHQUFXO0lBQ2hDLElBQUk7UUFDQSxNQUFNLE1BQU0sR0FBRyxJQUFJLEdBQUcsQ0FBQyxHQUFHLEVBQUUsUUFBUSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQzNDLE9BQU87WUFDSCxJQUFJLEVBQUUsTUFBTSxDQUFDLElBQUk7WUFDakIsUUFBUSxFQUFFLE1BQU0sQ0FBQyxRQUFRO1lBQ3pCLFFBQVEsRUFBRSxNQUFNLENBQUMsUUFBUTtZQUN6QixJQUFJLEVBQUUsTUFBTSxDQUFDLElBQUk7WUFDakIsUUFBUSxFQUFFLE1BQU0sQ0FBQyxRQUFRO1lBQ3pCLE1BQU0sRUFBRSxNQUFNLENBQUMsTUFBTTtZQUNyQixJQUFJLEVBQUUsTUFBTSxDQUFDLElBQUk7WUFDakIsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNO1NBQ3hCLENBQUM7S0FDTDtJQUFDLE1BQU07UUFDSixPQUFPO1lBQ0gsSUFBSSxFQUFFLEdBQUc7WUFDVCxRQUFRLEVBQUUsRUFBRTtZQUNaLFFBQVEsRUFBRSxFQUFFO1lBQ1osSUFBSSxFQUFFLEVBQUU7WUFDUixRQUFRLEVBQUUsR0FBRztZQUNiLE1BQU0sRUFBRSxFQUFFO1lBQ1YsSUFBSSxFQUFFLEVBQUU7WUFDUixNQUFNLEVBQUUsRUFBRTtTQUNiLENBQUM7S0FDTDtBQUNMLENBQUM7QUF6QkQsNEJBeUJDIn0=

package/build/main/helpers/session.d.ts

@@ -0,0 +1,4 @@
+export declare function isSessionExpired(key: string, timeoutMinutes: number): boolean;
+export declare function updateSessionTimestamp(key: string): void;
+export declare function getSessionValue<T>(key: string): T | null;
+export declare function setSessionValue(key: string, value: unknown): void;

package/build/main/helpers/session.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setSessionValue = exports.getSessionValue = exports.updateSessionTimestamp = exports.isSessionExpired = void 0;
+const SESSION_KEY_PREFIX = 'ga4_session_';
+function isSessionExpired(key, timeoutMinutes) {
+    try {
+        const stored = sessionStorage.getItem(SESSION_KEY_PREFIX + key);
+        if (!stored)
+            return true;
+        const timestamp = parseInt(stored, 10);
+        if (isNaN(timestamp))
+            return true;
+        return (Date.now() - timestamp) > timeoutMinutes * 60 * 1000;
+    }
+    catch {
+        return true;
+    }
+}
+exports.isSessionExpired = isSessionExpired;
+function updateSessionTimestamp(key) {
+    try {
+        sessionStorage.setItem(SESSION_KEY_PREFIX + key, String(Date.now()));
+    }
+    catch {
+        // sessionStorage may be unavailable or full
+    }
+}
+exports.updateSessionTimestamp = updateSessionTimestamp;
+function getSessionValue(key) {
+    try {
+        const stored = sessionStorage.getItem(SESSION_KEY_PREFIX + key);
+        if (stored === null)
+            return null;
+        return JSON.parse(stored);
+    }
+    catch {
+        return null;
+    }
+}
+exports.getSessionValue = getSessionValue;
+function setSessionValue(key, value) {
+    try {
+        sessionStorage.setItem(SESSION_KEY_PREFIX + key, JSON.stringify(value));
+    }
+    catch {
+        // sessionStorage may be unavailable or full
+    }
+}
+exports.setSessionValue = setSessionValue;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2Vzc2lvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9oZWxwZXJzL3Nlc3Npb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsTUFBTSxrQkFBa0IsR0FBRyxjQUFjLENBQUM7QUFFMUMsU0FBZ0IsZ0JBQWdCLENBQUMsR0FBVyxFQUFFLGNBQXNCO0lBQ2hFLElBQUk7UUFDQSxNQUFNLE1BQU0sR0FBRyxjQUFjLENBQUMsT0FBTyxDQUFDLGtCQUFrQixHQUFHLEdBQUcsQ0FBQyxDQUFDO1FBQ2hFLElBQUksQ0FBQyxNQUFNO1lBQUUsT0FBTyxJQUFJLENBQUM7UUFDekIsTUFBTSxTQUFTLEdBQUcsUUFBUSxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsQ0FBQztRQUN2QyxJQUFJLEtBQUssQ0FBQyxTQUFTLENBQUM7WUFBRSxPQUFPLElBQUksQ0FBQztRQUNsQyxPQUFPLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxHQUFHLFNBQVMsQ0FBQyxHQUFHLGNBQWMsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDO0tBQ2hFO0lBQUMsTUFBTTtRQUNKLE9BQU8sSUFBSSxDQUFDO0tBQ2Y7QUFDTCxDQUFDO0FBVkQsNENBVUM7QUFFRCxTQUFnQixzQkFBc0IsQ0FBQyxHQUFXO0lBQzlDLElBQUk7UUFDQSxjQUFjLENBQUMsT0FBTyxDQUFDLGtCQUFrQixHQUFHLEdBQUcsRUFBRSxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDLENBQUMsQ0FBQztLQUN4RTtJQUFDLE1BQU07UUFDSiw0Q0FBNEM7S0FDL0M7QUFDTCxDQUFDO0FBTkQsd0RBTUM7QUFFRCxTQUFnQixlQUFlLENBQUksR0FBVztJQUMxQyxJQUFJO1FBQ0EsTUFBTSxNQUFNLEdBQUcsY0FBYyxDQUFDLE9BQU8sQ0FBQyxrQkFBa0IsR0FBRyxHQUFHLENBQUMsQ0FBQztRQUNoRSxJQUFJLE1BQU0sS0FBSyxJQUFJO1lBQUUsT0FBTyxJQUFJLENBQUM7UUFDakMsT0FBTyxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBTSxDQUFDO0tBQ2xDO0lBQUMsTUFBTTtRQUNKLE9BQU8sSUFBSSxDQUFDO0tBQ2Y7QUFDTCxDQUFDO0FBUkQsMENBUUM7QUFFRCxTQUFnQixlQUFlLENBQUMsR0FBVyxFQUFFLEtBQWM7SUFDdkQsSUFBSTtRQUNBLGNBQWMsQ0FBQyxPQUFPLENBQUMsa0JBQWtCLEdBQUcsR0FBRyxFQUFFLElBQUksQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQztLQUMzRTtJQUFDLE1BQU07UUFDSiw0Q0FBNEM7S0FDL0M7QUFDTCxDQUFDO0FBTkQsMENBTUMifQ==

package/build/main/index.d.ts

@@ -4,3 +4,12 @@ declare const dataLayerHelper: {
 };
 declare const ga4: import("./ga4/ga4").ga4;
 export { ga4, dataLayerHelper };
+export { EventTracker } from './plugins/event-tracker';
+export { OutboundLinkTracker } from './plugins/outbound-link-tracker';
+export { OutboundFormTracker } from './plugins/outbound-form-tracker';
+export { PageVisibilityTracker } from './plugins/page-visibility-tracker';
+export { UrlChangeTracker } from './plugins/url-change-tracker';
+export { ImpressionTracker } from './plugins/impression-tracker';
+export { CleanUrlTracker } from './plugins/clean-url-tracker';
+export { MediaQueryTracker } from './plugins/media-query-tracker';
+export type { GA4Plugin, SendFunction, EventTrackerOptions, OutboundLinkTrackerOptions, OutboundFormTrackerOptions, PageVisibilityTrackerOptions, UrlChangeTrackerOptions, ImpressionTrackerOptions, ImpressionElementConfig, CleanUrlTrackerOptions, MediaQueryTrackerOptions, MediaQueryDefinition, MediaQueryDefinitionItem, } from './types/plugins';

package/build/main/index.js

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

package/build/main/plugins/clean-url-tracker.d.ts

@@ -0,0 +1,17 @@
+import { GA4Plugin, SendFunction, CleanUrlTrackerOptions } from '../types/plugins';
+/**
+ * Normalizes URLs before they are sent with `page_view` events.
+ *
+ * Intercepts `gtag()` calls for `config` and `page_view` events
+ * and cleans the `page_location` and `page_path` parameters
+ * (strip query params, normalize trailing slashes, apply custom filters).
+ */
+export declare class CleanUrlTracker implements GA4Plugin {
+    private opts;
+    private originalGtag;
+    constructor(_send: SendFunction, options?: CleanUrlTrackerOptions);
+    private cleanParams;
+    cleanUrl(url: string): string;
+    cleanPath(path: string): string;
+    remove(): void;
+}

package/build/main/plugins/clean-url-tracker.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CleanUrlTracker = void 0;
+/**
+ * Normalizes URLs before they are sent with `page_view` events.
+ *
+ * Intercepts `gtag()` calls for `config` and `page_view` events
+ * and cleans the `page_location` and `page_path` parameters
+ * (strip query params, normalize trailing slashes, apply custom filters).
+ */
+class CleanUrlTracker {
+    opts;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+    originalGtag = null;
+    constructor(_send, options) {
+        this.opts = {
+            stripQuery: options?.stripQuery ?? false,
+            queryParamsAllowlist: options?.queryParamsAllowlist,
+            queryParamsDenylist: options?.queryParamsDenylist,
+            trailingSlash: options?.trailingSlash,
+            urlFilter: options?.urlFilter,
+        };
+        if (typeof window !== 'undefined' && window.gtag) {
+            this.originalGtag = window.gtag;
+            const self = this;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            window.gtag = function () {
+                // eslint-disable-next-line prefer-rest-params
+                const args = Array.prototype.slice.call(arguments);
+                if (args.length >= 3 && typeof args[2] === 'object' && args[2] !== null) {
+                    const isPageView = args[0] === 'event' && args[1] === 'page_view';
+                    const isConfig = args[0] === 'config';
+                    if (isPageView || isConfig) {
+                        args[2] = self.cleanParams({ ...args[2] });
+                    }
+                }
+                return self.originalGtag.apply(window, args);
+            };
+        }
+    }
+    cleanParams(params) {
+        if (typeof params.page_location === 'string') {
+            params.page_location = this.cleanUrl(params.page_location);
+        }
+        if (typeof params.page_path === 'string') {
+            params.page_path = this.cleanPath(params.page_path);
+        }
+        return params;
+    }
+    cleanUrl(url) {
+        try {
+            const u = new URL(url);
+            u.pathname = this.cleanPath(u.pathname);
+            if (this.opts.stripQuery) {
+                if (this.opts.queryParamsAllowlist && this.opts.queryParamsAllowlist.length > 0) {
+                    const allowed = new URLSearchParams();
+                    this.opts.queryParamsAllowlist.forEach((param) => {
+                        if (u.searchParams.has(param)) {
+                            allowed.set(param, u.searchParams.get(param));
+                        }
+                    });
+                    u.search = allowed.toString() ? '?' + allowed.toString() : '';
+                }
+                else {
+                    u.search = '';
+                }
+            }
+            else if (this.opts.queryParamsDenylist && this.opts.queryParamsDenylist.length > 0) {
+                this.opts.queryParamsDenylist.forEach((param) => {
+                    u.searchParams.delete(param);
+                });
+                u.search = u.searchParams.toString() ? '?' + u.searchParams.toString() : '';
+            }
+            let result = u.toString();
+            if (this.opts.urlFilter) {
+                result = this.opts.urlFilter(result);
+            }
+            return result;
+        }
+        catch {
+            return url;
+        }
+    }
+    cleanPath(path) {
+        let result = path;
+        if (this.opts.trailingSlash === 'remove') {
+            result = result.length > 1 ? result.replace(/\/+$/, '') : result;
+        }
+        else if (this.opts.trailingSlash === 'add') {
+            if (!result.endsWith('/') && !result.split('/').pop()?.includes('.')) {
+                result += '/';
+            }
+        }
+        return result;
+    }
+    remove() {
+        if (this.originalGtag) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            window.gtag = this.originalGtag;
+            this.originalGtag = null;
+        }
+    }
+}
+exports.CleanUrlTracker = CleanUrlTracker;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xlYW4tdXJsLXRyYWNrZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvcGx1Z2lucy9jbGVhbi11cmwtdHJhY2tlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFFQTs7Ozs7O0dBTUc7QUFDSCxNQUFhLGVBQWU7SUFDaEIsSUFBSSxDQUF5QjtJQUNyQyxzRUFBc0U7SUFDOUQsWUFBWSxHQUFvQixJQUFJLENBQUM7SUFFN0MsWUFBWSxLQUFtQixFQUFFLE9BQWdDO1FBQzdELElBQUksQ0FBQyxJQUFJLEdBQUc7WUFDUixVQUFVLEVBQUUsT0FBTyxFQUFFLFVBQVUsSUFBSSxLQUFLO1lBQ3hDLG9CQUFvQixFQUFFLE9BQU8sRUFBRSxvQkFBb0I7WUFDbkQsbUJBQW1CLEVBQUUsT0FBTyxFQUFFLG1CQUFtQjtZQUNqRCxhQUFhLEVBQUUsT0FBTyxFQUFFLGFBQWE7WUFDckMsU0FBUyxFQUFFLE9BQU8sRUFBRSxTQUFTO1NBQ2hDLENBQUM7UUFFRixJQUFJLE9BQU8sTUFBTSxLQUFLLFdBQVcsSUFBSSxNQUFNLENBQUMsSUFBSSxFQUFFO1lBQzlDLElBQUksQ0FBQyxZQUFZLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQztZQUNoQyxNQUFNLElBQUksR0FBRyxJQUFJLENBQUM7WUFFbEIsOERBQThEO1lBQzdELE1BQWMsQ0FBQyxJQUFJLEdBQUc7Z0JBQ25CLDhDQUE4QztnQkFDOUMsTUFBTSxJQUFJLEdBQUcsS0FBSyxDQUFDLFNBQVMsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDO2dCQUVuRCxJQUFJLElBQUksQ0FBQyxNQUFNLElBQUksQ0FBQyxJQUFJLE9BQU8sSUFBSSxDQUFDLENBQUMsQ0FBQyxLQUFLLFFBQVEsSUFBSSxJQUFJLENBQUMsQ0FBQyxDQUFDLEtBQUssSUFBSSxFQUFFO29CQUNyRSxNQUFNLFVBQVUsR0FBRyxJQUFJLENBQUMsQ0FBQyxDQUFDLEtBQUssT0FBTyxJQUFJ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

package/build/main/plugins/event-tracker.d.ts

@@ -0,0 +1,27 @@
+import { GA4Plugin, SendFunction, EventTrackerOptions } from '../types/plugins';
+/**
+ * Declarative event tracking via HTML `data-ga4-*` attributes.
+ *
+ * Listens for DOM events on elements with `data-ga4-on` attributes
+ * and sends GA4 events based on attribute values.
+ *
+ * @example
+ * ```html
+ * <button
+ *   data-ga4-on="click"
+ *   data-ga4-event-name="video_play"
+ *   data-ga4-video-title="My Video">
+ *   Play
+ * </button>
+ * ```
+ */
+export declare class EventTracker implements GA4Plugin {
+    private delegates;
+    private send;
+    private events;
+    private attributePrefix;
+    private hitFilter?;
+    constructor(send: SendFunction, options?: EventTrackerOptions);
+    private handleEvent;
+    remove(): void;
+}

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

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventTracker = void 0;
+const delegate_1 = require("../helpers/delegate");
+function kebabToSnake(str) {
+    return str.replace(/-/g, '_');
+}
+function getAttributeParams(element, prefix) {
+    const params = {};
+    const reservedSuffixes = ['on', 'event-name'];
+    for (let i = 0; i < element.attributes.length; i++) {
+        const attr = element.attributes[i];
+        if (!attr.name.startsWith(prefix))
+            continue;
+        const suffix = attr.name.slice(prefix.length);
+        if (reservedSuffixes.includes(suffix))
+            continue;
+        params[kebabToSnake(suffix)] = attr.value;
+    }
+    return params;
+}
+/**
+ * Declarative event tracking via HTML `data-ga4-*` attributes.
+ *
+ * Listens for DOM events on elements with `data-ga4-on` attributes
+ * and sends GA4 events based on attribute values.
+ *
+ * @example
+ * ```html
+ * <button
+ *   data-ga4-on="click"
+ *   data-ga4-event-name="video_play"
+ *   data-ga4-video-title="My Video">
+ *   Play
+ * </button>
+ * ```
+ */
+class EventTracker {
+    delegates = [];
+    send;
+    events;
+    attributePrefix;
+    hitFilter;
+    constructor(send, options) {
+        this.send = send;
+        this.events = options?.events ?? ['click'];
+        this.attributePrefix = options?.attributePrefix ?? 'data-ga4-';
+        this.hitFilter = options?.hitFilter;
+        const selector = `[${this.attributePrefix}on]`;
+        this.events.forEach((eventType) => {
+            const handle = (0, delegate_1.delegate)(document, eventType, selector, (event, element) => this.handleEvent(event, element), { composed: true, useCapture: true });
+            this.delegates.push(handle);
+        });
+    }
+    handleEvent(event, element) {
+        const prefix = this.attributePrefix;
+        const onAttr = element.getAttribute(`${prefix}on`);
+        if (onAttr !== event.type)
+            return;
+        const eventName = element.getAttribute(`${prefix}event-name`) || event.type;
+        let params = getAttributeParams(element, prefix);
+        if (this.hitFilter) {
+            const filtered = this.hitFilter(params, element, event);
+            if (filtered === null)
+                return;
+            params = filtered;
+        }
+        this.send(eventName, params);
+    }
+    remove() {
+        this.delegates.forEach((d) => d.destroy());
+        this.delegates = [];
+    }
+}
+exports.EventTracker = EventTracker;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXZlbnQtdHJhY2tlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9wbHVnaW5zL2V2ZW50LXRyYWNrZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQ0Esa0RBQStEO0FBRS9ELFNBQVMsWUFBWSxDQUFDLEdBQVc7SUFDN0IsT0FBTyxHQUFHLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxHQUFHLENBQUMsQ0FBQztBQUNsQyxDQUFDO0FBRUQsU0FBUyxrQkFBa0IsQ0FBQyxPQUFnQixFQUFFLE1BQWM7SUFDeEQsTUFBTSxNQUFNLEdBQTRCLEVBQUUsQ0FBQztJQUMzQyxNQUFNLGdCQUFnQixHQUFHLENBQUMsSUFBSSxFQUFFLFlBQVksQ0FBQyxDQUFDO0lBRTlDLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxPQUFPLENBQUMsVUFBVSxDQUFDLE1BQU0sRUFBRSxDQUFDLEVBQUUsRUFBRTtRQUNoRCxNQUFNLElBQUksR0FBRyxPQUFPLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQyxDQUFDO1FBQ25DLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxNQUFNLENBQUM7WUFBRSxTQUFTO1FBRTVDLE1BQU0sTUFBTSxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQztRQUM5QyxJQUFJLGdCQUFnQixDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUM7WUFBRSxTQUFTO1FBRWhELE1BQU0sQ0FBQyxZQUFZLENBQUMsTUFBTSxDQUFDLENBQUMsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDO0tBQzdDO0lBRUQsT0FBTyxNQUFNLENBQUM7QUFDbEIsQ0FBQztBQUVEOzs7Ozs7Ozs7Ozs7Ozs7R0FlRztBQUNILE1BQWEsWUFBWTtJQUNiLFNBQVMsR0FBcUIsRUFBRSxDQUFDO0lBQ2pDLElBQUksQ0FBZTtJQUNuQixNQUFNLENBQVc7SUFDakIsZUFBZSxDQUFTO0lBQ3hCLFNBQVMsQ0FBb0M7SUFFckQsWUFBWSxJQUFrQixFQUFFLE9BQTZCO1FBQ3pELElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFDO1FBQ2pCLElBQUksQ0FBQyxNQUFNLEdBQUcsT0FBTyxFQUFFLE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQzNDLElBQUksQ0FBQyxlQUFlLEdBQUcsT0FBTyxFQUFFLGVBQWUsSUFBSSxXQUFXLENBQUM7UUFDL0QsSUFBSSxDQUFDLFNBQVMsR0FBRyxPQUFPLEVBQUUsU0FBUyxDQUFDO1FBRXBDLE1BQU0sUUFBUSxHQUFHLElBQUksSUFBSSxDQUFDLGVBQWUsS0FBSyxDQUFDO1FBRS9DLElBQUksQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDLENBQUMsU0FBUyxFQUFFLEVBQUU7WUFDOUIsTUFBTSxNQUFNLEdBQUcsSUFBQSxtQkFBUSxFQUNuQixRQUFRLEVBQ1IsU0FBUyxFQUNULFFBQVEsRUFDUixDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsRUFBRSxDQUFDLElBQUksQ0FBQyxXQUFXLENBQUMsS0FBSyxFQUFFLE9BQU8sQ0FBQyxFQUNwRCxFQUFFLFFBQVEsRUFBRSxJQUFJLEVBQUUsVUFBVSxFQUFFLElBQUksRUFBRSxDQUN2QyxDQUFDO1lBQ0YsSUFBSSxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDaEMsQ0FBQyxDQUFDLENBQUM7SUFDUCxDQUFDO0lBRU8sV0FBVyxDQUFDLEtBQVksRUFBRSxPQUFnQjtRQUM5QyxNQUFNLE1BQU0sR0FBRyxJQUFJLENBQUMsZUFBZSxDQUFDO1FBQ3BDLE1BQU0sTUFBTSxHQUFHLE9BQU8sQ0FBQyxZQUFZLENBQUMsR0FBRyxNQUFNLElBQUksQ0FBQyxDQUFDO1FBRW5ELElBQUksTUFBTSxLQUFLLEtBQUssQ0FBQyxJQUFJO1lBQUUsT0FBTztRQUVsQyxNQUFNLFNBQVMsR0FBRyxPQUFPLENBQUMsWUFBWSxDQUFDLEdBQUcsTUFBTSxZQUFZLENBQUMsSUFBSSxLQUFLLENBQUMsSUFBSSxDQUFDO1FBQzVFLElBQUksTUFBTSxHQUFHLGtCQUFrQixDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQztRQUVqRCxJQUFJLElBQUksQ0FBQyxTQUFTLEVBQUU7WUFDaEIsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxNQUFNLEVBQUUsT0FBTyxFQUFFLEtBQUssQ0FBQyxDQUFDO1lBQ3hELElBQUksUUFBUSxLQUFLLElBQUk7Z0JBQUUsT0FBTztZQUM5QixNQUFNLEdBQUcsUUFBUSxDQUFDO1NBQ3JCO1FBRUQsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsTUFBTSxDQUFDLENBQUM7SUFDakMsQ0FBQztJQUVELE1BQU07UUFDRixJQUFJLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLE9BQU8sRUFBRSxDQUFDLENBQUM7UUFDM0MsSUFBSSxDQUFDLFNBQVMsR0FBRyxFQUFFLENBQUM7SUFDeEIsQ0FBQztDQUNKO0FBakRELG9DQWlEQyJ9

package/build/main/plugins/impression-tracker.d.ts

@@ -0,0 +1,32 @@
+import { GA4Plugin, SendFunction, ImpressionTrackerOptions, ImpressionElementConfig } from '../types/plugins';
+/**
+ * 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.
+ */
+export declare class ImpressionTracker implements GA4Plugin {
+    private send;
+    private rootMargin;
+    private attributePrefix;
+    private eventName;
+    private hitFilter?;
+    private items;
+    private elementMap;
+    private thresholdMap;
+    private mutationObserver;
+    private impressedIds;
+    private supported;
+    constructor(send: SendFunction, options?: ImpressionTrackerOptions);
+    observeElements(elements: Array<string | ImpressionElementConfig>): void;
+    unobserveElements(elements: Array<string | ImpressionElementConfig>): void;
+    unobserveAllElements(): void;
+    private normalizeElements;
+    private getObserverForThreshold;
+    private handleIntersectionChanges;
+    private handleDomMutations;
+    private walkNodeTree;
+    private disconnectAll;
+    remove(): void;
+}