matomo-tracker-for-react 1.0.0

package/es/MatomoProvider.js

@@ -0,0 +1,94 @@
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+import React, { useEffect, useMemo, useRef } from 'react';
+import { useLocation } from 'react-router-dom'; // For automatic page view tracking
+import MatomoContext from './MatomoContext';
+import MatomoTracker from './MatomoTracker';
+import { TRACK_TYPES } from './constants';
+var MatomoProvider = function (_a) {
+    var children = _a.children, urlBase = _a.urlBase, siteId = _a.siteId, _b = _a.disabled, disabled = _b === void 0 ? false : _b, _c = _a.trackCookies, trackCookies = _c === void 0 ? true : _c;
+    var matomoInstanceRef = useRef(null);
+    var location = useLocation(); // From react-router-dom
+    // Initialize MatomoTracker instance
+    if (!matomoInstanceRef.current && typeof window !== 'undefined' && !disabled) {
+        var matomoSiteId = typeof siteId === 'string' ? parseInt(siteId, 10) : siteId;
+        if (isNaN(matomoSiteId)) {
+            console.error("Matomo siteId must be a number or a string parseable to a number.");
+        }
+        else {
+            var effectiveConfigurations = {};
+            if (!trackCookies) {
+                effectiveConfigurations.disableCookies = true;
+            }
+            var trackerOptions = {
+                urlBase: urlBase,
+                siteId: matomoSiteId,
+                disabled: disabled,
+                configurations: effectiveConfigurations, // Pass only relevant configurations
+            };
+            matomoInstanceRef.current = new MatomoTracker(trackerOptions);
+        }
+    }
+    var matomoActions = useMemo(function () {
+        var currentInstance = matomoInstanceRef.current; // Use a variable for the dependency array
+        if (!currentInstance || disabled) {
+            var noOp = function () { };
+            var noOpInstance = {
+                trackEvent: noOp,
+                trackPageView: noOp,
+                trackGoal: noOp,
+                setUserId: noOp,
+                trackLink: noOp,
+                pushInstruction: function () {
+                    var _args = [];
+                    for (var _i = 0; _i < arguments.length; _i++) {
+                        _args[_i] = arguments[_i];
+                    }
+                },
+            };
+            return noOpInstance;
+        }
+        return {
+            trackEvent: function (category, action, name, value) {
+                return currentInstance.trackEvent({ category: category, action: action, name: name, value: value });
+            },
+            trackPageView: function (customTitle) {
+                return currentInstance.trackPageView(customTitle ? { documentTitle: customTitle } : undefined);
+            },
+            trackGoal: function (goalId, revenue) {
+                return currentInstance.pushInstruction(TRACK_TYPES.TRACK_GOAL, goalId, revenue);
+            },
+            setUserId: function (uid) { return currentInstance.pushInstruction(TRACK_TYPES.SET_USER_ID, uid); },
+            trackLink: function (url, linkType) {
+                return currentInstance.trackLink({ href: url, linkType: linkType });
+            },
+            pushInstruction: function (instruction) {
+                if (Array.isArray(instruction) && instruction.length > 0) {
+                    var name_1 = instruction[0], args = instruction.slice(1);
+                    currentInstance.pushInstruction.apply(currentInstance, __spreadArray([name_1], args, false));
+                }
+                else {
+                    console.warn('pushInstruction expects a non-empty array.');
+                }
+            },
+        };
+    }, [disabled, matomoInstanceRef.current]); // Use matomoInstanceRef.current here
+    // Effect for automatic page view tracking on route change
+    useEffect(function () {
+        if (matomoActions && matomoActions.trackPageView && !disabled) {
+            var currentPath = location.pathname + location.search + location.hash;
+            matomoActions.pushInstruction(['setCustomUrl', window.location.origin + currentPath]);
+            matomoActions.trackPageView(); // Track with potentially new document.title or default
+        }
+    }, [location, matomoActions, disabled]);
+    return (React.createElement(MatomoContext.Provider, { value: matomoActions }, children));
+};
+export default MatomoProvider;
+//# sourceMappingURL=MatomoProvider.js.map

package/es/MatomoProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatomoProvider.js","sourceRoot":"","sources":["../src/MatomoProvider.tsx"],"names":[],"mappings":"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"}

package/es/MatomoTracker.d.ts

@@ -0,0 +1,49 @@
+import { AddEcommerceItemParams, RemoveEcommerceItemParams, SetEcommerceViewParams, TrackEcommerceOrderParams, TrackEventParams, TrackLinkParams, TrackPageViewParams, TrackSiteSearchParams, UserOptions } from "./tracker-types";
+declare global {
+    interface Window {
+        _paq?: Array<any[]>;
+    }
+}
+declare class MatomoTracker {
+    private mutationObserver?;
+    private isInitialized;
+    constructor(userOptions: UserOptions);
+    private initialize;
+    enableHeartBeatTimer(seconds: number): void;
+    enableLinkTracking(active: boolean): void;
+    private trackEventsForElements;
+    trackEvents(): void;
+    stopObserving(): void;
+    trackEvent({ category, action, name, value, ...otherParams }: TrackEventParams): void;
+    trackSiteSearch({ keyword, category, count, ...otherParams }: TrackSiteSearchParams): void;
+    trackLink({ href, linkType, customDimensions, }: TrackLinkParams): void;
+    trackPageView(params?: TrackPageViewParams): void;
+    addEcommerceItem({ sku, productName, productCategory, productPrice, productQuantity, }: AddEcommerceItemParams): void;
+    removeEcommerceItem({ sku }: RemoveEcommerceItemParams): void;
+    clearEcommerceCart(): void;
+    trackEcommerceOrder({ orderId, orderRevenue, orderSubTotal, taxAmount, shippingAmount, discountOffered, }: TrackEcommerceOrderParams): void;
+    trackEcommerceCartUpdate(amount: number): void;
+    setEcommerceView({ sku, productName, productCategory, productPrice, }: SetEcommerceViewParams): void;
+    setEcommerceCategoryView(productCategory: string): void;
+    private track;
+    /**
+     * Pushes an instruction to Matomo for execution, this is equivalent to pushing entries into the `_paq` array.
+     *
+     * For example:
+     *
+     * ```ts
+     * pushInstruction('setDocumentTitle', document.title)
+     * ```
+     * Is the equivalent of:
+     *
+     * ```ts
+     * _paq.push(['setDocumentTitle', document.title]);
+     * ```
+     *
+     * @param name The name of the instruction to be executed.
+     * @param args The arguments to pass along with the instruction.
+     */
+    pushInstruction(name: string, ...args: any[]): MatomoTracker;
+}
+export default MatomoTracker;
+//# sourceMappingURL=MatomoTracker.d.ts.map

package/es/MatomoTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatomoTracker.d.ts","sourceRoot":"","sources":["../src/MatomoTracker.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EAEzB,sBAAsB,EACtB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EAEnB,qBAAqB,EACrB,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,IAAI,CAAC,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;KACrB;CACF;AAED,cAAM,aAAa;IACjB,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,aAAa,CAAS;gBAElB,WAAW,EAAE,WAAW;IAepC,OAAO,CAAC,UAAU;IAmFlB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3C,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIzC,OAAO,CAAC,sBAAsB;IAwB9B,WAAW,IAAI,IAAI;IAqCnB,aAAa,IAAI,IAAI;IAQrB,UAAU,CAAC,EACT,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,KAAK,EACL,GAAG,WAAW,EACf,EAAE,gBAAgB,GAAG,IAAI;IAa1B,eAAe,CAAC,EACd,OAAO,EACP,QAAQ,EACR,KAAK,EACL,GAAG,WAAW,EACf,EAAE,qBAAqB,GAAG,IAAI;IAa/B,SAAS,CAAC,EACR,IAAI,EACJ,QAAiB,EACjB,gBAAgB,GACjB,EAAE,eAAe,GAAG,IAAI;IAmBzB,aAAa,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAOjD,gBAAgB,CAAC,EACf,GAAG,EACH,WAAW,EACX,eAAe,EACf,YAAkB,EAClB,eAAmB,GACpB,EAAE,sBAAsB,GAAG,IAAI;IAahC,mBAAmB,CAAC,EAAE,GAAG,EAAE,EAAE,yBAAyB,GAAG,IAAI;IAM7D,kBAAkB,IAAI,IAAI;IAM1B,mBAAmB,CAAC,EAClB,OAAO,EACP,YAAY,EACZ,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAuB,GACxB,EAAE,yBAAyB,GAAG,IAAI;IAiBnC,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM9C,gBAAgB,CAAC,EACf,GAAG,EACH,WAAW,EACX,eAAe,EACf,YAAY,GACb,EAAE,sBAAsB,GAAG,IAAI;IAYhC,wBAAwB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAKvD,OAAO,CAAC,KAAK;IAoCb;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,aAAa;CAS7D;AAED,eAAe,aAAa,CAAC"}

package/es/MatomoTracker.js

@@ -0,0 +1,330 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+import { TRACK_TYPES } from "./constants";
+var MatomoTracker = /** @class */ (function () {
+    function MatomoTracker(userOptions) {
+        this.isInitialized = false;
+        if (typeof window === "undefined") {
+            // Don't run in SSR or non-browser environments
+            return;
+        }
+        if (!userOptions.urlBase) {
+            throw new Error("Matomo urlBase is required.");
+        }
+        if (userOptions.siteId === undefined || userOptions.siteId === null) {
+            throw new Error("Matomo siteId is required.");
+        }
+        this.initialize(userOptions);
+    }
+    MatomoTracker.prototype.initialize = function (_a) {
+        var _this = this;
+        var _b;
+        var urlBase = _a.urlBase, siteId = _a.siteId, userId = _a.userId, trackerUrl = _a.trackerUrl, srcUrl = _a.srcUrl, _c = _a.disabled, disabled = _c === void 0 ? false : _c, heartBeat = _a.heartBeat, _d = _a.linkTracking, linkTracking = _d === void 0 ? true : _d, _e = _a.configurations, configurations = _e === void 0 ? {} : _e;
+        if (disabled) {
+            // If disabled, make all tracking calls no-ops by not initializing _paq or the script
+            this.pushInstruction = function () {
+                var _args = [];
+                for (var _i = 0; _i < arguments.length; _i++) {
+                    _args[_i] = arguments[_i];
+                }
+                return _this;
+            }; // No-op
+            // Make other methods no-op as well
+            var noOp = function () { };
+            this.trackEvent = noOp;
+            this.trackPageView = noOp;
+            this.trackSiteSearch = noOp;
+            this.trackLink = noOp;
+            // ... and so on for all public methods
+            return;
+        }
+        var normalizedUrlBase = urlBase.endsWith("/") ? urlBase : "".concat(urlBase, "/");
+        window._paq = window._paq || [];
+        // Prevent re-initialization if _paq already has Matomo commands beyond simple presence
+        if (this.isInitialized ||
+            (window._paq.length > 0 &&
+                window._paq.some(function (cmd) { return cmd[0] === "setTrackerUrl"; }))) {
+            // If siteId or userId needs to be updated on an existing instance:
+            if (siteId)
+                this.pushInstruction("setSiteId", siteId);
+            if (userId)
+                this.pushInstruction("setUserId", userId);
+            // Potentially re-apply other configurations if needed, or assume they are sticky
+            this.isInitialized = true;
+            return;
+        }
+        this.pushInstruction("setTrackerUrl", trackerUrl !== null && trackerUrl !== void 0 ? trackerUrl : "".concat(normalizedUrlBase, "matomo.php"));
+        this.pushInstruction("setSiteId", siteId);
+        if (userId) {
+            this.pushInstruction("setUserId", userId);
+        }
+        Object.entries(configurations).forEach(function (_a) {
+            var name = _a[0], instructions = _a[1];
+            if (name === "disableCookies" && typeof instructions === "boolean") {
+                _this.pushInstruction("disableCookies"); // Matomo's disableCookies takes no arguments if called this way
+            }
+            else if (instructions instanceof Array) {
+                _this.pushInstruction.apply(_this, __spreadArray([name], instructions, false));
+            }
+            else {
+                _this.pushInstruction(name, instructions);
+            }
+        });
+        if (!heartBeat || (heartBeat && heartBeat.active)) {
+            this.enableHeartBeatTimer((_b = (heartBeat && heartBeat.seconds)) !== null && _b !== void 0 ? _b : 15);
+        }
+        this.enableLinkTracking(linkTracking);
+        var doc = document;
+        var scriptElement = doc.createElement("script");
+        var scripts = doc.getElementsByTagName("script")[0];
+        scriptElement.type = "text/javascript";
+        scriptElement.async = true;
+        scriptElement.defer = true;
+        scriptElement.src = srcUrl || "".concat(normalizedUrlBase, "matomo.js");
+        if (scripts && scripts.parentNode) {
+            scripts.parentNode.insertBefore(scriptElement, scripts);
+        }
+        this.isInitialized = true;
+    };
+    MatomoTracker.prototype.enableHeartBeatTimer = function (seconds) {
+        this.pushInstruction("enableHeartBeatTimer", seconds);
+    };
+    MatomoTracker.prototype.enableLinkTracking = function (active) {
+        this.pushInstruction("enableLinkTracking", active);
+    };
+    MatomoTracker.prototype.trackEventsForElements = function (elements) {
+        var _this = this;
+        if (elements.length) {
+            elements.forEach(function (element) {
+                element.addEventListener("click", function () {
+                    var _a = element.dataset, matomoCategory = _a.matomoCategory, matomoAction = _a.matomoAction, matomoName = _a.matomoName, matomoValue = _a.matomoValue;
+                    if (matomoCategory && matomoAction) {
+                        _this.trackEvent({
+                            category: matomoCategory,
+                            action: matomoAction,
+                            name: matomoName,
+                            value: matomoValue ? Number(matomoValue) : undefined,
+                        });
+                    }
+                    else {
+                        throw new Error("Error: data-matomo-category and data-matomo-action are required.");
+                    }
+                });
+            });
+        }
+    };
+    // Tracks events based on data attributes
+    MatomoTracker.prototype.trackEvents = function () {
+        var _this = this;
+        if (typeof window === "undefined" || !document)
+            return;
+        var matchString = '[data-matomo-event="click"]';
+        var firstTime = false;
+        if (!this.mutationObserver) {
+            firstTime = true;
+            this.mutationObserver = new MutationObserver(function (mutations) {
+                mutations.forEach(function (mutation) {
+                    mutation.addedNodes.forEach(function (node) {
+                        // only track HTML elements
+                        if (!(node instanceof HTMLElement))
+                            return;
+                        // check the inserted element for being a code snippet
+                        if (node.matches(matchString)) {
+                            _this.trackEventsForElements([node]);
+                        }
+                        var elements = Array.from(node.querySelectorAll(matchString));
+                        _this.trackEventsForElements(elements);
+                    });
+                });
+            });
+        }
+        this.mutationObserver.observe(document, { childList: true, subtree: true });
+        // Now track all already existing elements
+        if (firstTime) {
+            var elements = Array.from(document.querySelectorAll(matchString));
+            this.trackEventsForElements(elements);
+        }
+    };
+    MatomoTracker.prototype.stopObserving = function () {
+        if (this.mutationObserver) {
+            this.mutationObserver.disconnect();
+        }
+    };
+    // Tracks events
+    // https://matomo.org/docs/event-tracking/#tracking-events
+    MatomoTracker.prototype.trackEvent = function (_a) {
+        var category = _a.category, action = _a.action, name = _a.name, value = _a.value, otherParams = __rest(_a, ["category", "action", "name", "value"]);
+        if (category && action) {
+            this.track(__assign({ data: [TRACK_TYPES.TRACK_EVENT, category, action, name, value] }, otherParams));
+        }
+        else {
+            throw new Error("Error: category and action are required.");
+        }
+    };
+    // Tracks site search
+    // https://developer.matomo.org/guides/tracking-javascript-guide#internal-search-tracking
+    MatomoTracker.prototype.trackSiteSearch = function (_a) {
+        var keyword = _a.keyword, category = _a.category, count = _a.count, otherParams = __rest(_a, ["keyword", "category", "count"]);
+        if (keyword) {
+            this.track(__assign({ data: [TRACK_TYPES.TRACK_SEARCH, keyword, category, count] }, otherParams));
+        }
+        else {
+            throw new Error("Error: keyword is required.");
+        }
+    };
+    // Tracks outgoing links to other sites and downloads
+    // https://developer.matomo.org/guides/tracking-javascript-guide#enabling-download-outlink-tracking
+    MatomoTracker.prototype.trackLink = function (_a) {
+        var _this = this;
+        var href = _a.href, _b = _a.linkType, linkType = _b === void 0 ? "link" : _b, customDimensions = _a.customDimensions;
+        if (customDimensions &&
+            Array.isArray(customDimensions) &&
+            customDimensions.length) {
+            customDimensions.forEach(function (customDimension) {
+                return _this.pushInstruction("setCustomDimension", customDimension.id, customDimension.value);
+            });
+        }
+        this.pushInstruction(TRACK_TYPES.TRACK_LINK, href, linkType);
+    };
+    // Tracks page views
+    // https://developer.matomo.org/guides/spa-tracking#tracking-a-new-page-view
+    MatomoTracker.prototype.trackPageView = function (params) {
+        this.track(__assign({ data: [TRACK_TYPES.TRACK_VIEW] }, params));
+    };
+    // Adds a product to an Ecommerce order to be tracked via trackEcommerceOrder.
+    // https://matomo.org/docs/ecommerce-analytics
+    // https://matomo.org/docs/ecommerce-analytics/#1-addecommerceitemproductsku-productname-productcategory-price-quantity
+    MatomoTracker.prototype.addEcommerceItem = function (_a) {
+        var sku = _a.sku, productName = _a.productName, productCategory = _a.productCategory, _b = _a.productPrice, productPrice = _b === void 0 ? 0.0 : _b, _c = _a.productQuantity, productQuantity = _c === void 0 ? 1 : _c;
+        this.pushInstruction("addEcommerceItem", sku, productName, productCategory, productPrice, productQuantity);
+    };
+    // Removes a product from an Ecommerce order to be tracked via trackEcommerceOrder.
+    // https://matomo.org/docs/ecommerce-analytics
+    MatomoTracker.prototype.removeEcommerceItem = function (_a) {
+        var sku = _a.sku;
+        this.pushInstruction("removeEcommerceItem", sku);
+    };
+    // Removes all products from an Ecommerce order to be tracked via trackEcommerceOrder.
+    // https://matomo.org/docs/ecommerce-analytics
+    MatomoTracker.prototype.clearEcommerceCart = function () {
+        this.pushInstruction("clearEcommerceCart");
+    };
+    // Tracks an Ecommerce order containing items added via addEcommerceItem.
+    // https://matomo.org/docs/ecommerce-analytics/#2-trackecommerceorderorderid-revenue-subtotal-tax-shipping-discount
+    MatomoTracker.prototype.trackEcommerceOrder = function (_a) {
+        var orderId = _a.orderId, orderRevenue = _a.orderRevenue, orderSubTotal = _a.orderSubTotal, taxAmount = _a.taxAmount, shippingAmount = _a.shippingAmount, _b = _a.discountOffered, discountOffered = _b === void 0 ? false : _b;
+        this.track({
+            data: [
+                TRACK_TYPES.TRACK_ECOMMERCE_ORDER,
+                orderId,
+                orderRevenue,
+                orderSubTotal,
+                taxAmount,
+                shippingAmount,
+                discountOffered,
+            ],
+        });
+    };
+    // Tracks updates to an Ecommerce Cart before an actual purchase.
+    // This will replace currently tracked information of the cart. Always include all items of the updated cart!
+    // https://matomo.org/docs/ecommerce-analytics/#example-tracking-an-ecommerce-cart-update-containing-two-products
+    MatomoTracker.prototype.trackEcommerceCartUpdate = function (amount) {
+        this.pushInstruction(TRACK_TYPES.TRACK_ECOMMERCE_CART_UPDATE, amount);
+    };
+    // Marks the next page view as an Ecommerce product page.
+    // https://matomo.org/docs/ecommerce-analytics/#example-tracking-a-product-page-view
+    MatomoTracker.prototype.setEcommerceView = function (_a) {
+        var sku = _a.sku, productName = _a.productName, productCategory = _a.productCategory, productPrice = _a.productPrice;
+        this.pushInstruction("setEcommerceView", sku, productName, productCategory, productPrice);
+    };
+    // Marks the next tracked page view as an Ecommerce category page.
+    // https://matomo.org/docs/ecommerce-analytics/#example-tracking-a-category-page-view
+    MatomoTracker.prototype.setEcommerceCategoryView = function (productCategory) {
+        this.setEcommerceView({ productCategory: productCategory, productName: false, sku: false });
+    };
+    // Sends the tracked page/view/search to Matomo
+    MatomoTracker.prototype.track = function (_a) {
+        var _this = this;
+        var _b = _a.data, data = _b === void 0 ? [] : _b, documentTitle = _a.documentTitle, // Changed: use passed documentTitle or fallback to window.document.title later
+        href = _a.href, _c = _a.customDimensions, customDimensions = _c === void 0 ? false : _c;
+        if (typeof window === "undefined")
+            return;
+        if (data.length) {
+            if (customDimensions &&
+                Array.isArray(customDimensions) &&
+                customDimensions.length) {
+                customDimensions.forEach(function (customDimension // Corrected type
+                ) {
+                    return _this.pushInstruction("setCustomDimension", customDimension.id, customDimension.value);
+                });
+            }
+            this.pushInstruction("setCustomUrl", href !== null && href !== void 0 ? href : window.location.href);
+            // Use provided documentTitle, fallback to actual document.title only if not provided
+            this.pushInstruction("setDocumentTitle", documentTitle !== null && documentTitle !== void 0 ? documentTitle : window.document.title);
+            this.pushInstruction.apply(this, data);
+        }
+    };
+    /**
+     * Pushes an instruction to Matomo for execution, this is equivalent to pushing entries into the `_paq` array.
+     *
+     * For example:
+     *
+     * ```ts
+     * pushInstruction('setDocumentTitle', document.title)
+     * ```
+     * Is the equivalent of:
+     *
+     * ```ts
+     * _paq.push(['setDocumentTitle', document.title]);
+     * ```
+     *
+     * @param name The name of the instruction to be executed.
+     * @param args The arguments to pass along with the instruction.
+     */
+    MatomoTracker.prototype.pushInstruction = function (name) {
+        var args = [];
+        for (var _i = 1; _i < arguments.length; _i++) {
+            args[_i - 1] = arguments[_i];
+        }
+        if (typeof window !== "undefined" && window._paq) {
+            window._paq.push(__spreadArray([name], args, true));
+        }
+        else if (typeof window !== "undefined" && name === "setTrackerUrl") {
+            // Allow setting up _paq if it's the first instruction (like setTrackerUrl)
+            window._paq = [__spreadArray([name], args, true)];
+        }
+        return this;
+    };
+    return MatomoTracker;
+}());
+export default MatomoTracker;
+//# sourceMappingURL=MatomoTracker.js.map

package/es/MatomoTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatomoTracker.js","sourceRoot":"","sources":["../src/MatomoTracker.ts"],"names":[],"mappings":"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"}

package/es/constants.d.ts

@@ -0,0 +1,11 @@
+export declare const TRACK_TYPES: {
+    TRACK_EVENT: string;
+    TRACK_LINK: string;
+    TRACK_SEARCH: string;
+    TRACK_VIEW: string;
+    TRACK_ECOMMERCE_ORDER: string;
+    TRACK_ECOMMERCE_CART_UPDATE: string;
+    TRACK_GOAL: string;
+    SET_USER_ID: string;
+};
+//# sourceMappingURL=constants.d.ts.map

package/es/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW;;;;;;;;;CAUvB,CAAC"}

package/es/constants.js

@@ -0,0 +1,13 @@
+// eslint-disable-next-line import/prefer-default-export
+export var TRACK_TYPES = {
+    TRACK_EVENT: "trackEvent",
+    TRACK_LINK: "trackLink",
+    TRACK_SEARCH: "trackSiteSearch",
+    TRACK_VIEW: "trackPageView",
+    TRACK_ECOMMERCE_ORDER: "trackEcommerceOrder",
+    TRACK_ECOMMERCE_CART_UPDATE: "trackEcommerceCartUpdate",
+    // Add other Matomo instructions if needed, e.g., for goals
+    TRACK_GOAL: "trackGoal",
+    SET_USER_ID: "setUserId",
+};
+//# sourceMappingURL=constants.js.map

package/es/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,CAAC,IAAM,WAAW,GAAG;IACzB,WAAW,EAAE,YAAY;IACzB,UAAU,EAAE,WAAW;IACvB,YAAY,EAAE,iBAAiB;IAC/B,UAAU,EAAE,eAAe;IAC3B,qBAAqB,EAAE,qBAAqB;IAC5C,2BAA2B,EAAE,0BAA0B;IACvD,2DAA2D;IAC3D,UAAU,EAAE,WAAW;IACvB,WAAW,EAAE,WAAW;CACzB,CAAC"}

package/es/index.d.ts

@@ -0,0 +1,15 @@
+export { default as MatomoProvider } from "./MatomoProvider";
+export { default as useMatomo } from "./useMatomo";
+export { default as MatomoContext } from "./MatomoContext";
+export * from "./types";
+export type { CustomDimension, UserOptions, // This is the core UserOptions, MatomoProviderProps is different
+TrackPageViewParams, // Core type
+TrackEventParams, // Core type
+TrackLinkParams, // Core type
+TrackSiteSearchParams, // Core type, though not directly used by simplified hook
+TrackEcommerceOrderParams, // Core type
+AddEcommerceItemParams, // Core type
+RemoveEcommerceItemParams, // Core type
+SetEcommerceViewParams, // Core type
+TrackGoalParams, } from "./tracker-types";
+//# sourceMappingURL=index.d.ts.map

package/es/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG3D,cAAc,SAAS,CAAC;AAExB,YAAY,EACV,eAAe,EACf,WAAW,EAAE,iEAAiE;AAC9E,mBAAmB,EAAE,YAAY;AACjC,gBAAgB,EAAE,YAAY;AAC9B,eAAe,EAAE,YAAY;AAC7B,qBAAqB,EAAE,yDAAyD;AAChF,yBAAyB,EAAE,YAAY;AACvC,sBAAsB,EAAE,YAAY;AACpC,yBAAyB,EAAE,YAAY;AACvC,sBAAsB,EAAE,YAAY;AACpC,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/es/index.js

@@ -0,0 +1,6 @@
+export { default as MatomoProvider } from "./MatomoProvider";
+export { default as useMatomo } from "./useMatomo";
+export { default as MatomoContext } from "./MatomoContext"; // Optional: if users need direct context access
+// Export types for consumers
+export * from "./types"; // Exports React-specific types and re-exports tracker-types
+//# sourceMappingURL=index.js.map

package/es/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC,CAAC,gDAAgD;AAE5G,6BAA6B;AAC7B,cAAc,SAAS,CAAC,CAAC,4DAA4D"}

package/es/tracker-types.d.ts

@@ -0,0 +1,76 @@
+export interface CustomDimension {
+    id: number;
+    value: string;
+}
+export interface UserOptions {
+    urlBase: string;
+    siteId: number;
+    userId?: string;
+    trackerUrl?: string;
+    srcUrl?: string;
+    disabled?: boolean;
+    heartBeat?: {
+        active: boolean;
+        seconds?: number;
+    };
+    linkTracking?: boolean;
+    configurations?: {
+        [key: string]: any;
+    };
+}
+export interface TrackPageViewParams {
+    documentTitle?: string;
+    href?: string | Location;
+    customDimensions?: boolean | CustomDimension[];
+}
+export interface TrackParams extends TrackPageViewParams {
+    data: any[];
+}
+export interface TrackEventParams {
+    category: string;
+    action: string;
+    name?: string;
+    value?: number;
+    documentTitle?: string;
+    href?: string | Location;
+    customDimensions?: boolean | CustomDimension[];
+}
+export interface TrackLinkParams {
+    href: string;
+    linkType?: "download" | "link";
+    customDimensions?: boolean | CustomDimension[];
+}
+export interface TrackSiteSearchParams extends TrackPageViewParams {
+    keyword: string;
+    category?: string;
+    count?: number;
+}
+export interface TrackEcommerceOrderParams {
+    orderId: string;
+    orderRevenue: number;
+    orderSubTotal?: number;
+    taxAmount?: number;
+    shippingAmount?: number;
+    discountOffered?: boolean;
+}
+export interface AddEcommerceItemParams {
+    sku: string;
+    productName?: string;
+    productCategory?: string;
+    productPrice?: number;
+    productQuantity?: number;
+}
+export interface RemoveEcommerceItemParams {
+    sku: string;
+}
+export interface SetEcommerceViewParams {
+    sku: string | boolean;
+    productName?: string | boolean;
+    productCategory?: string;
+    productPrice?: number;
+}
+export interface TrackGoalParams {
+    goalId: number | string;
+    revenue?: number;
+}
+//# sourceMappingURL=tracker-types.d.ts.map

package/es/tracker-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker-types.d.ts","sourceRoot":"","sources":["../src/tracker-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE;QACV,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE;QACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,GAAG,eAAe,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,WAAY,SAAQ,mBAAmB;IACtD,IAAI,EAAE,GAAG,EAAE,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,GAAG,eAAe,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAE/B,gBAAgB,CAAC,EAAE,OAAO,GAAG,eAAe,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}